contrib/sqlite3/sqlite3.c

6929 ** used as a proxy for the total work done by the prepared statement.
25792 **   *  Various locking primitive implementations (all except proxy locking):
25803 **   *  Locking primitives for the proxy uber-locking-method. (MacOSX only)
25820 **   7. proxy locking. (OSX only)
25902 ** Default permissions when creating auto proxy dir
29651 ** Handler for proxy-locking file-control verbs.  Defined below in the
31052 ** The proxy locking method is a "super-method" in the sense that it
31054 ** it uses proxy, dot-file, AFP, and flock() locking methods on those
31056 ** proxy locking is located much further down in the file.  But we need
31058 ** for proxy locking here.  So we forward declare the I/O methods.
31223   ** exception is when opening the proxy "conch" file in builds that
31266     ** proxyLock activation is possible (remote proxy is based on db name)
31467 ** Routine to transform a unixFile into a proxy-locking unixFile.
31468 ** Implementation in the proxy-lock division, but used by unixOpen()
31848     /* SQLITE_FORCE_PROXY_LOCKING==1 means force always use proxy, 0 means
31849     ** never use proxy, NULL means use proxy for non-local files only.  */
32234 ** this reason, the division that implements of proxy locking is deferred
32237 ** as services to help with the implementation of proxy locking.
32267 ** To address the performance and cache coherency issues, proxy file locking
32270 ** and onto a proxy file on the local file system.
32273 ** Using proxy locks
32290 ** host ID in it, the proxy path in the conch file will be used, otherwise
32291 ** a proxy path based on the user's temp dir
32293 ** actual proxy file name is generated from the name and path of the
32299 ** Once a lock proxy is configured for a database connection, it can not
32300 ** be removed, however it may be switched to a different proxy path via
32305 ** How proxy locking works
32313 **   *  proxy file to act as a proxy for the advisory locks normally
32316 ** The conch file - to use a proxy file, sqlite must first "hold the conch"
32319 ** proxy path against the values stored in the conch.  The conch file is
32323 ** host ID and/or proxy path, then the lock is escalated to an exclusive
32324 ** lock and the conch file contents is updated with the host ID and proxy
32329 ** The proxy file - a single-byte file used for all advisory file locks
32334 ** Requesting the lock proxy does not immediately take the conch, it is
32341 ** The proxy file and the lock file are never deleted so they only need
32350 **       automatically configured for proxy locking, lock files are
32361 **       Overrides the default directory used for lock proxy files that
32367 **       lock proxy files, only used when LOCKPROXYDIR is not set.
32372 ** force proxy locking to be used for every database file opened, and 0
32373 ** will force automatic proxy locking to be disabled for all database
32385 ** and local proxy files in it
32391   unixFile *lockProxy;         /* Open proxy lock file */
32392   char *lockProxyPath;         /* Name of the proxy lock file */
32401 ** The proxy lock file path for the database at dbPath is written into lPath,
32439   OSTRACE(("GETLOCKPATH  proxy lock path=%s pid=%d\n", lPath, osGetpid(0)));
32465                      "'%s' proxy lock path=%s pid=%d\n",
32475   OSTRACE(("CREATELOCKPATH  proxy lock path=%s pid=%d\n", lockPath, osGetpid(0)));
32942           /* we couldn't create the proxy lock file with the old lock file path
32985   proxyLockingContext *pCtx;  /* The locking context for the proxy lock */
33047 /* Takes a fully configured proxy locking-style unix file and switches
33111 ** will be performed on the local proxy lock file.  The following fields
33202 ** to proxy locking.
33227           /* turn off proxy locking - not supported.  If support is added for
33228           ** switching proxy locking mode off then it will need to fail if
33233           /* turn off proxy locking - already off - NOOP */
33250           /* turn on proxy file locking */
33267 ** proxy-locking sqlite3_io_method object follow.
33283       unixFile *proxy = pCtx->lockProxy;
33284       return proxy->pMethod->xCheckReservedLock((sqlite3_file*)proxy, pResOut);
33322       unixFile *proxy = pCtx->lockProxy;
33323       rc = proxy->pMethod->xLock((sqlite3_file*)proxy, eFileLock);
33324       pFile->eFileLock = proxy->eFileLock;
33346       unixFile *proxy = pCtx->lockProxy;
33347       rc = proxy->pMethod->xUnlock((sqlite3_file*)proxy, eFileLock);
33348       pFile->eFileLock = proxy->eFileLock;
33357 ** Close a file that uses proxy locks.
33400 ** The proxy locking style is intended for use with AFP filesystems.
33401 ** And since AFP is only supported on MacOSX, the proxy locking is also
33405 ******************* End of the proxy lock implementation **********************
33497     UNIXVFS("unix-proxy",    proxyIoFinder ),
105668         sqlite3ErrorMsg(pParse, "failed to set lock proxy file");