contrib/sqlite3/sqlite3.c

7299 ** used as a proxy for the total work done by the prepared statement.
29158 **   *  Various locking primitive implementations (all except proxy locking):
29169 **   *  Locking primitives for the proxy uber-locking-method. (MacOSX only)
29186 **   7. proxy locking. (OSX only)
29281 ** Default permissions when creating auto proxy dir
32997 ** Handler for proxy-locking file-control verbs.  Defined below in the
34387 ** The proxy locking method is a "super-method" in the sense that it
34389 ** it uses proxy, dot-file, AFP, and flock() locking methods on those
34391 ** proxy locking is located much further down in the file.  But we need
34393 ** for proxy locking here.  So we forward declare the I/O methods.
34558   ** exception is when opening the proxy "conch" file in builds that
34601     ** proxyLock activation is possible (remote proxy is based on db name)
34792 ** Routine to transform a unixFile into a proxy-locking unixFile.
34793 ** Implementation in the proxy-lock division, but used by unixOpen()
35175     /* SQLITE_FORCE_PROXY_LOCKING==1 means force always use proxy, 0 means
35176     ** never use proxy, NULL means use proxy for non-local files only.  */
35625 ** this reason, the division that implements of proxy locking is deferred
35628 ** as services to help with the implementation of proxy locking.
35658 ** To address the performance and cache coherency issues, proxy file locking
35661 ** and onto a proxy file on the local file system.
35664 ** Using proxy locks
35681 ** host ID in it, the proxy path in the conch file will be used, otherwise
35682 ** a proxy path based on the user's temp dir
35684 ** actual proxy file name is generated from the name and path of the
35690 ** Once a lock proxy is configured for a database connection, it can not
35691 ** be removed, however it may be switched to a different proxy path via
35696 ** How proxy locking works
35704 **   *  proxy file to act as a proxy for the advisory locks normally
35707 ** The conch file - to use a proxy file, sqlite must first "hold the conch"
35710 ** proxy path against the values stored in the conch.  The conch file is
35714 ** host ID and/or proxy path, then the lock is escalated to an exclusive
35715 ** lock and the conch file contents is updated with the host ID and proxy
35720 ** The proxy file - a single-byte file used for all advisory file locks
35725 ** Requesting the lock proxy does not immediately take the conch, it is
35732 ** The proxy file and the lock file are never deleted so they only need
35741 **       automatically configured for proxy locking, lock files are
35752 **       Overrides the default directory used for lock proxy files that
35758 **       lock proxy files, only used when LOCKPROXYDIR is not set.
35763 ** force proxy locking to be used for every database file opened, and 0
35764 ** will force automatic proxy locking to be disabled for all database
35776 ** and local proxy files in it
35782   unixFile *lockProxy;         /* Open proxy lock file */
35783   char *lockProxyPath;         /* Name of the proxy lock file */
35792 ** The proxy lock file path for the database at dbPath is written into lPath,
35830   OSTRACE(("GETLOCKPATH  proxy lock path=%s pid=%d\n", lPath, osGetpid(0)));
35856                      "'%s' proxy lock path=%s pid=%d\n",
35866   OSTRACE(("CREATELOCKPATH  proxy lock path=%s pid=%d\n",lockPath,osGetpid(0)));
36333           /* we couldn't create the proxy lock file with the old lock file path
36376   proxyLockingContext *pCtx;  /* The locking context for the proxy lock */
36438 /* Takes a fully configured proxy locking-style unix file and switches
36502 ** will be performed on the local proxy lock file.  The following fields
36593 ** to proxy locking.
36618           /* turn off proxy locking - not supported.  If support is added for
36619           ** switching proxy locking mode off then it will need to fail if
36624           /* turn off proxy locking - already off - NOOP */
36641           /* turn on proxy file locking */
36658 ** proxy-locking sqlite3_io_method object follow.
36674       unixFile *proxy = pCtx->lockProxy;
36675       return proxy->pMethod->xCheckReservedLock((sqlite3_file*)proxy, pResOut);
36713       unixFile *proxy = pCtx->lockProxy;
36714       rc = proxy->pMethod->xLock((sqlite3_file*)proxy, eFileLock);
36715       pFile->eFileLock = proxy->eFileLock;
36737       unixFile *proxy = pCtx->lockProxy;
36738       rc = proxy->pMethod->xUnlock((sqlite3_file*)proxy, eFileLock);
36739       pFile->eFileLock = proxy->eFileLock;
36748 ** Close a file that uses proxy locks.
36791 ** The proxy locking style is intended for use with AFP filesystems.
36792 ** And since AFP is only supported on MacOSX, the proxy locking is also
36796 ******************* End of the proxy lock implementation **********************
36888     UNIXVFS("unix-proxy",    proxyIoFinder ),
111604         sqlite3ErrorMsg(pParse, "failed to set lock proxy file");