lib/sqlite/sqlite3.c

24404 **   *  Various locking primitive implementations (all except proxy locking):
24415 **   *  Locking primitives for the proxy uber-locking-method. (MacOSX only)
24431 **   7. proxy locking. (OSX only)
24539  ** Default permissions when creating auto proxy dir
28015 ** Handler for proxy-locking file-control verbs.  Defined below in the
28943 ** The proxy locking method is a "super-method" in the sense that it
28945 ** it uses proxy, dot-file, AFP, and flock() locking methods on those
28947 ** proxy locking is located much further down in the file.  But we need
28949 ** for proxy locking here.  So we forward declare the I/O methods.
29122   ** exception is when opening the proxy "conch" file in builds that
29161     ** proxyLock activation is possible (remote proxy is based on db name)
29358 ** Routine to transform a unixFile into a proxy-locking unixFile.
29359 ** Implementation in the proxy-lock division, but used by unixOpen()
29684     /* SQLITE_FORCE_PROXY_LOCKING==1 means force always use proxy, 0 means
29685     ** never use proxy, NULL means use proxy for non-local files only.  */
30069 ** this reason, the division that implements of proxy locking is deferred
30072 ** as services to help with the implementation of proxy locking.
30102 ** To address the performance and cache coherency issues, proxy file locking
30105 ** and onto a proxy file on the local file system.
30108 ** Using proxy locks
30124 ** host ID in it, the proxy path in the conch file will be used, otherwise
30125 ** a proxy path based on the user's temp dir
30127 ** actual proxy file name is generated from the name and path of the
30133 ** Once a lock proxy is configured for a database connection, it can not
30134 ** be removed, however it may be switched to a different proxy path via
30139 ** How proxy locking works
30147 **   *  proxy file to act as a proxy for the advisory locks normally
30150 ** The conch file - to use a proxy file, sqlite must first "hold the conch"
30153 ** proxy path against the values stored in the conch.  The conch file is
30157 ** host ID and/or proxy path, then the lock is escalated to an exclusive
30158 ** lock and the conch file contents is updated with the host ID and proxy
30163 ** The proxy file - a single-byte file used for all advisory file locks
30168 ** Requesting the lock proxy does not immediately take the conch, it is
30175 ** The proxy file and the lock file are never deleted so they only need
30184 **       automatically configured for proxy locking, lock files are
30195 **       Overrides the default directory used for lock proxy files that
30201 **       lock proxy files, only used when LOCKPROXYDIR is not set.
30206 ** force proxy locking to be used for every database file opened, and 0
30207 ** will force automatic proxy locking to be disabled for all database
30219 ** and local proxy files in it
30225   unixFile *lockProxy;         /* Open proxy lock file */
30226   char *lockProxyPath;         /* Name of the proxy lock file */
30234 ** The proxy lock file path for the database at dbPath is written into lPath,
30272   OSTRACE(("GETLOCKPATH  proxy lock path=%s pid=%d\n", lPath, getpid()));
30298                      "'%s' proxy lock path=%s pid=%d\n",
30308   OSTRACE(("CREATELOCKPATH  proxy lock path=%s pid=%d\n", lockPath, getpid()));
30774           /* we couldn't create the proxy lock file with the old lock file path
30817   proxyLockingContext *pCtx;  /* The locking context for the proxy lock */
30879 /* Takes a fully configured proxy locking-style unix file and switches
30942 ** will be performed on the local proxy lock file.  The following fields
31033 ** to proxy locking.
31058           /* turn off proxy locking - not supported */
31061           /* turn off proxy locking - already off - NOOP */
31078           /* turn on proxy file locking */
31095 ** proxy-locking sqlite3_io_method object follow.
31111       unixFile *proxy = pCtx->lockProxy;
31112       return proxy->pMethod->xCheckReservedLock((sqlite3_file*)proxy, pResOut);
31150       unixFile *proxy = pCtx->lockProxy;
31151       rc = proxy->pMethod->xLock((sqlite3_file*)proxy, eFileLock);
31152       pFile->eFileLock = proxy->eFileLock;
31174       unixFile *proxy = pCtx->lockProxy;
31175       rc = proxy->pMethod->xUnlock((sqlite3_file*)proxy, eFileLock);
31176       pFile->eFileLock = proxy->eFileLock;
31185 ** Close a file that uses proxy locks.
31228 ** The proxy locking style is intended for use with AFP filesystems.
31229 ** And since AFP is only supported on MacOSX, the proxy locking is also
31233 ******************* End of the proxy lock implementation **********************
31323     UNIXVFS("unix-proxy",    proxyIoFinder ),
90773         sqlite3ErrorMsg(pParse, "failed to set lock proxy file");