contrib/sqlite3/sqlite3.c

22917 **   *  Various locking primitive implementations (all except proxy locking):
22928 **   *  Locking primitives for the proxy uber-locking-method. (MacOSX only)
22951 **   7. proxy locking. (OSX only)
23060 ** Default permissions when creating auto proxy dir
26734 ** Handler for proxy-locking file-control verbs.  Defined below in the
28060 ** The proxy locking method is a "super-method" in the sense that it
28062 ** it uses proxy, dot-file, AFP, and flock() locking methods on those
28064 ** proxy locking is located much further down in the file.  But we need
28066 ** for proxy locking here.  So we forward declare the I/O methods.
28231   ** exception is when opening the proxy "conch" file in builds that
28272     ** proxyLock activation is possible (remote proxy is based on db name)
28471 ** Routine to transform a unixFile into a proxy-locking unixFile.
28472 ** Implementation in the proxy-lock division, but used by unixOpen()
28833     /* SQLITE_FORCE_PROXY_LOCKING==1 means force always use proxy, 0 means
28834     ** never use proxy, NULL means use proxy for non-local files only.  */
29228 ** this reason, the division that implements of proxy locking is deferred
29231 ** as services to help with the implementation of proxy locking.
29261 ** To address the performance and cache coherency issues, proxy file locking
29264 ** and onto a proxy file on the local file system.
29267 ** Using proxy locks
29283 ** host ID in it, the proxy path in the conch file will be used, otherwise
29284 ** a proxy path based on the user's temp dir
29286 ** actual proxy file name is generated from the name and path of the
29292 ** Once a lock proxy is configured for a database connection, it can not
29293 ** be removed, however it may be switched to a different proxy path via
29298 ** How proxy locking works
29306 **   *  proxy file to act as a proxy for the advisory locks normally
29309 ** The conch file - to use a proxy file, sqlite must first "hold the conch"
29312 ** proxy path against the values stored in the conch.  The conch file is
29316 ** host ID and/or proxy path, then the lock is escalated to an exclusive
29317 ** lock and the conch file contents is updated with the host ID and proxy
29322 ** The proxy file - a single-byte file used for all advisory file locks
29327 ** Requesting the lock proxy does not immediately take the conch, it is
29334 ** The proxy file and the lock file are never deleted so they only need
29343 **       automatically configured for proxy locking, lock files are
29354 **       Overrides the default directory used for lock proxy files that
29360 **       lock proxy files, only used when LOCKPROXYDIR is not set.
29365 ** force proxy locking to be used for every database file opened, and 0
29366 ** will force automatic proxy locking to be disabled for all database
29378 ** and local proxy files in it
29384   unixFile *lockProxy;         /* Open proxy lock file */
29385   char *lockProxyPath;         /* Name of the proxy lock file */
29393 ** The proxy lock file path for the database at dbPath is written into lPath,
29431   OSTRACE(("GETLOCKPATH  proxy lock path=%s pid=%d\n", lPath, getpid()));
29457                      "'%s' proxy lock path=%s pid=%d\n",
29467   OSTRACE(("CREATELOCKPATH  proxy lock path=%s pid=%d\n", lockPath, getpid()));
29931           /* we couldn't create the proxy lock file with the old lock file path
29974   proxyLockingContext *pCtx;  /* The locking context for the proxy lock */
30036 /* Takes a fully configured proxy locking-style unix file and switches
30099 ** will be performed on the local proxy lock file.  The following fields
30190 ** to proxy locking.
30215           /* turn off proxy locking - not supported */
30218           /* turn off proxy locking - already off - NOOP */
30235           /* turn on proxy file locking */
30252 ** proxy-locking sqlite3_io_method object follow.
30268       unixFile *proxy = pCtx->lockProxy;
30269       return proxy->pMethod->xCheckReservedLock((sqlite3_file*)proxy, pResOut);
30307       unixFile *proxy = pCtx->lockProxy;
30308       rc = proxy->pMethod->xLock((sqlite3_file*)proxy, eFileLock);
30309       pFile->eFileLock = proxy->eFileLock;
30331       unixFile *proxy = pCtx->lockProxy;
30332       rc = proxy->pMethod->xUnlock((sqlite3_file*)proxy, eFileLock);
30333       pFile->eFileLock = proxy->eFileLock;
30342 ** Close a file that uses proxy locks.
30385 ** The proxy locking style is intended for use with AFP filesystems.
30386 ** And since AFP is only supported on MacOSX, the proxy locking is also
30390 ******************* End of the proxy lock implementation **********************
30480     UNIXVFS("unix-proxy",    proxyIoFinder ),
94311         sqlite3ErrorMsg(pParse, "failed to set lock proxy file");