Artifact 5834a404b7c8318dc1928c9fc0137a65c9c0416c:
- File src/os.h — part of check-in [8972c004] at 2004-10-01 02:00:31 on branch trunk — Use type i64 instead of off_t for file offsets since off_t is giving portability problems. Ticket #924. (CVS 1992) (user: drh size: 7681)
0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe 0010: 6d 62 65 72 20 31 36 0a 2a 2a 0a 2a 2a 20 54 68 mber 16.**.** Th 0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai 0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to 0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code 0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.* 0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice 0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles 0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M 0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a 00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..** 00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find 00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for 00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for 00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..** 00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share 0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t 0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than 0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.*** 0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************** 0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************** 0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************** 0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************** 0170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a ***********.**.* 0180: 2a 20 54 68 69 73 20 68 65 61 64 65 72 20 66 69 * This header fi 0190: 6c 65 20 28 74 6f 67 65 74 68 65 72 20 77 69 74 le (together wit 01a0: 68 20 69 73 20 63 6f 6d 70 61 6e 69 6f 6e 20 43 h is companion C 01b0: 20 73 6f 75 72 63 65 2d 63 6f 64 65 20 66 69 6c source-code fil 01c0: 65 0a 2a 2a 20 22 6f 73 2e 63 22 29 20 61 74 74 e.** "os.c") att 01d0: 65 6d 70 74 20 74 6f 20 61 62 73 74 72 61 63 74 empt to abstract 01e0: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 the underlying 01f0: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d operating system 0200: 20 73 6f 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 so that.** the 0210: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 77 SQLite library w 0220: 69 6c 6c 20 77 6f 72 6b 20 6f 6e 20 62 6f 74 68 ill work on both 0230: 20 50 4f 53 49 58 20 61 6e 64 20 77 69 6e 64 6f POSIX and windo 0240: 77 73 20 73 79 73 74 65 6d 73 2e 0a 2a 2f 0a 23 ws systems..*/.# 0250: 69 66 6e 64 65 66 20 5f 53 51 4c 49 54 45 5f 4f ifndef _SQLITE_O 0260: 53 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f 53 51 S_H_.#define _SQ 0270: 4c 49 54 45 5f 4f 53 5f 48 5f 0a 0a 2f 2a 0a 2a LITE_OS_H_../*.* 0280: 2a 20 46 69 67 75 72 65 20 6f 75 74 20 69 66 20 * Figure out if 0290: 77 65 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77 we are dealing w 02a0: 69 74 68 20 55 6e 69 78 2c 20 57 69 6e 64 6f 77 ith Unix, Window 02b0: 73 20 6f 72 20 4d 61 63 4f 53 2e 0a 2a 2a 0a 2a s or MacOS..**.* 02c0: 2a 20 4e 2e 42 2e 20 4d 61 63 4f 53 20 6d 65 61 * N.B. MacOS mea 02d0: 6e 73 20 4d 61 63 20 43 6c 61 73 73 69 63 20 28 ns Mac Classic ( 02e0: 6f 72 20 43 61 72 62 6f 6e 29 2e 20 54 72 65 61 or Carbon). Trea 02f0: 74 20 44 61 72 77 69 6e 20 28 4f 53 20 58 29 20 t Darwin (OS X) 0300: 61 73 20 55 6e 69 78 2e 0a 2a 2a 20 20 20 20 20 as Unix..** 0310: 20 54 68 65 20 4d 61 63 4f 53 20 62 75 69 6c 64 The MacOS build 0320: 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 is designed to 0330: 75 73 65 20 43 6f 64 65 57 61 72 72 69 6f 72 20 use CodeWarrior 0340: 28 74 65 73 74 65 64 20 77 69 74 68 20 76 38 29 (tested with v8) 0350: 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .*/.#if !defined 0360: 28 4f 53 5f 55 4e 49 58 29 20 26 26 20 21 64 65 (OS_UNIX) && !de 0370: 66 69 6e 65 64 28 4f 53 5f 54 45 53 54 29 0a 23 fined(OS_TEST).# 0380: 20 69 66 6e 64 65 66 20 4f 53 5f 57 49 4e 0a 23 ifndef OS_WIN.# 0390: 20 20 69 66 6e 64 65 66 20 4f 53 5f 4d 41 43 0a ifndef OS_MAC. 03a0: 23 20 20 20 20 69 66 20 64 65 66 69 6e 65 64 28 # if defined( 03b0: 5f 5f 4d 41 43 4f 53 5f 5f 29 0a 23 20 20 20 20 __MACOS__).# 03c0: 20 20 64 65 66 69 6e 65 20 4f 53 5f 4d 41 43 20 define OS_MAC 03d0: 31 0a 23 20 20 20 20 20 20 64 65 66 69 6e 65 20 1.# define 03e0: 4f 53 5f 57 49 4e 20 30 0a 23 20 20 20 20 20 20 OS_WIN 0.# 03f0: 64 65 66 69 6e 65 20 4f 53 5f 55 4e 49 58 20 30 define OS_UNIX 0 0400: 0a 23 20 20 20 20 65 6c 69 66 20 64 65 66 69 6e .# elif defin 0410: 65 64 28 5f 57 49 4e 33 32 29 20 7c 7c 20 64 65 ed(_WIN32) || de 0420: 66 69 6e 65 64 28 57 49 4e 33 32 29 20 7c 7c 20 fined(WIN32) || 0430: 64 65 66 69 6e 65 64 28 5f 5f 43 59 47 57 49 4e defined(__CYGWIN 0440: 5f 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f __) || defined(_ 0450: 5f 4d 49 4e 47 57 33 32 5f 5f 29 20 7c 7c 20 64 _MINGW32__) || d 0460: 65 66 69 6e 65 64 28 5f 5f 42 4f 52 4c 41 4e 44 efined(__BORLAND 0470: 43 5f 5f 29 0a 23 20 20 20 20 20 20 64 65 66 69 C__).# defi 0480: 6e 65 20 4f 53 5f 4d 41 43 20 30 0a 23 20 20 20 ne OS_MAC 0.# 0490: 20 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e define OS_WIN 04a0: 20 31 0a 23 20 20 20 20 20 20 64 65 66 69 6e 65 1.# define 04b0: 20 4f 53 5f 55 4e 49 58 20 30 0a 23 20 20 20 20 OS_UNIX 0.# 04c0: 65 6c 73 65 0a 23 20 20 20 20 20 20 64 65 66 69 else.# defi 04d0: 6e 65 20 4f 53 5f 4d 41 43 20 30 0a 23 20 20 20 ne OS_MAC 0.# 04e0: 20 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e define OS_WIN 04f0: 20 30 0a 23 20 20 20 20 20 20 64 65 66 69 6e 65 0.# define 0500: 20 4f 53 5f 55 4e 49 58 20 31 0a 23 20 20 20 20 OS_UNIX 1.# 0510: 65 6e 64 69 66 0a 23 20 20 65 6c 73 65 0a 23 20 endif.# else.# 0520: 20 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e define OS_WIN 0530: 20 30 0a 23 20 20 20 20 64 65 66 69 6e 65 20 4f 0.# define O 0540: 53 5f 55 4e 49 58 20 30 0a 23 20 20 65 6e 64 69 S_UNIX 0.# endi 0550: 66 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 f.# else.# defi 0560: 6e 65 20 4f 53 5f 4d 41 43 20 30 0a 23 20 20 64 ne OS_MAC 0.# d 0570: 65 66 69 6e 65 20 4f 53 5f 55 4e 49 58 20 30 0a efine OS_UNIX 0. 0580: 23 20 65 6e 64 69 66 0a 23 65 6c 73 65 0a 23 20 # endif.#else.# 0590: 64 65 66 69 6e 65 20 4f 53 5f 4d 41 43 20 30 0a define OS_MAC 0. 05a0: 23 20 69 66 6e 64 65 66 20 4f 53 5f 57 49 4e 0a # ifndef OS_WIN. 05b0: 23 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e # define OS_WIN 05c0: 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 0.# endif.#endi 05d0: 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 20 f../*.** Invoke 05e0: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 the appropriate 05f0: 6f 70 65 72 61 74 69 6e 67 2d 73 79 73 74 65 6d operating-system 0600: 20 73 70 65 63 69 66 69 63 20 68 65 61 64 65 72 specific header 0610: 20 66 69 6c 65 2e 0a 2a 2f 0a 23 69 66 20 4f 53 file..*/.#if OS 0620: 5f 54 45 53 54 0a 23 20 69 6e 63 6c 75 64 65 20 _TEST.# include 0630: 22 6f 73 5f 74 65 73 74 2e 68 22 0a 23 65 6e 64 "os_test.h".#end 0640: 69 66 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 23 if.#if OS_UNIX.# 0650: 20 69 6e 63 6c 75 64 65 20 22 6f 73 5f 75 6e 69 include "os_uni 0660: 78 2e 68 22 0a 23 65 6e 64 69 66 0a 23 69 66 20 x.h".#endif.#if 0670: 4f 53 5f 57 49 4e 0a 23 20 69 6e 63 6c 75 64 65 OS_WIN.# include 0680: 20 22 6f 73 5f 77 69 6e 2e 68 22 0a 23 65 6e 64 "os_win.h".#end 0690: 69 66 0a 23 69 66 20 4f 53 5f 4d 41 43 0a 23 20 if.#if OS_MAC.# 06a0: 69 6e 63 6c 75 64 65 20 22 6f 73 5f 6d 61 63 2e include "os_mac. 06b0: 68 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a h".#endif../*.** 06c0: 20 54 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 Temporary files 06d0: 20 61 72 65 20 6e 61 6d 65 64 20 73 74 61 72 74 are named start 06e0: 69 6e 67 20 77 69 74 68 20 74 68 69 73 20 70 72 ing with this pr 06f0: 65 66 69 78 20 66 6f 6c 6c 6f 77 65 64 20 62 79 efix followed by 0700: 20 31 36 20 72 61 6e 64 6f 6d 0a 2a 2a 20 61 6c 16 random.** al 0710: 70 68 61 6e 75 6d 65 72 69 63 20 63 68 61 72 61 phanumeric chara 0720: 63 74 65 72 73 2c 20 61 6e 64 20 6e 6f 20 66 69 cters, and no fi 0730: 6c 65 20 65 78 74 65 6e 73 69 6f 6e 2e 20 54 68 le extension. Th 0740: 65 79 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e ey are stored in 0750: 20 74 68 65 0a 2a 2a 20 4f 53 27 73 20 73 74 61 the.** OS's sta 0760: 6e 64 61 72 64 20 74 65 6d 70 6f 72 61 72 79 20 ndard temporary 0770: 66 69 6c 65 20 64 69 72 65 63 74 6f 72 79 2c 20 file directory, 0780: 61 6e 64 20 61 72 65 20 64 65 6c 65 74 65 64 20 and are deleted 0790: 70 72 69 6f 72 20 74 6f 20 65 78 69 74 2e 0a 2a prior to exit..* 07a0: 2a 20 49 66 20 73 71 6c 69 74 65 20 69 73 20 62 * If sqlite is b 07b0: 65 69 6e 67 20 65 6d 62 65 64 64 65 64 20 69 6e eing embedded in 07c0: 20 61 6e 6f 74 68 65 72 20 70 72 6f 67 72 61 6d another program 07d0: 2c 20 79 6f 75 20 6d 61 79 20 77 69 73 68 20 74 , you may wish t 07e0: 6f 20 63 68 61 6e 67 65 20 74 68 65 0a 2a 2a 20 o change the.** 07f0: 70 72 65 66 69 78 20 74 6f 20 72 65 66 6c 65 63 prefix to reflec 0800: 74 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 27 73 t your program's 0810: 20 6e 61 6d 65 2c 20 73 6f 20 74 68 61 74 20 69 name, so that i 0820: 66 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 20 65 f your program e 0830: 78 69 74 73 0a 2a 2a 20 70 72 65 6d 61 74 75 72 xits.** prematur 0840: 65 6c 79 2c 20 6f 6c 64 20 74 65 6d 70 6f 72 61 ely, old tempora 0850: 72 79 20 66 69 6c 65 73 20 63 61 6e 20 62 65 20 ry files can be 0860: 65 61 73 69 6c 79 20 69 64 65 6e 74 69 66 69 65 easily identifie 0870: 64 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 64 d. This can be d 0880: 6f 6e 65 0a 2a 2a 20 75 73 69 6e 67 20 2d 44 54 one.** using -DT 0890: 45 4d 50 5f 46 49 4c 45 5f 50 52 45 46 49 58 3d EMP_FILE_PREFIX= 08a0: 6d 79 70 72 65 66 69 78 5f 20 6f 6e 20 74 68 65 myprefix_ on the 08b0: 20 63 6f 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 6e compiler comman 08c0: 64 20 6c 69 6e 65 2e 0a 2a 2f 0a 23 69 66 6e 64 d line..*/.#ifnd 08d0: 65 66 20 54 45 4d 50 5f 46 49 4c 45 5f 50 52 45 ef TEMP_FILE_PRE 08e0: 46 49 58 0a 23 20 64 65 66 69 6e 65 20 54 45 4d FIX.# define TEM 08f0: 50 5f 46 49 4c 45 5f 50 52 45 46 49 58 20 22 73 P_FILE_PREFIX "s 0900: 71 6c 69 74 65 5f 22 0a 23 65 6e 64 69 66 0a 0a qlite_".#endif.. 0910: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow 0920: 69 6e 67 20 76 61 6c 75 65 73 20 6d 61 79 20 62 ing values may b 0930: 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 e passed as the 0940: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 second argument 0950: 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 4f 73 4c to.** sqlite3OsL 0960: 6f 63 6b 28 29 2e 20 54 68 65 20 76 61 72 69 6f ock(). The vario 0970: 75 73 20 6c 6f 63 6b 73 20 65 78 68 69 62 69 74 us locks exhibit 0980: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s 0990: 65 6d 61 6e 74 69 63 73 3a 0a 2a 2a 0a 2a 2a 20 emantics:.**.** 09a0: 53 48 41 52 45 44 3a 20 20 20 20 41 6e 79 20 6e SHARED: Any n 09b0: 75 6d 62 65 72 20 6f 66 20 70 72 6f 63 65 73 73 umber of process 09c0: 65 73 20 6d 61 79 20 68 6f 6c 64 20 61 20 53 48 es may hold a SH 09d0: 41 52 45 44 20 6c 6f 63 6b 20 73 69 6d 75 6c 74 ARED lock simult 09e0: 61 6e 65 6f 75 73 6c 79 2e 0a 2a 2a 20 52 45 53 aneously..** RES 09f0: 45 52 56 45 44 3a 20 20 41 20 73 69 6e 67 6c 65 ERVED: A single 0a00: 20 70 72 6f 63 65 73 73 20 6d 61 79 20 68 6f 6c process may hol 0a10: 64 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 d a RESERVED loc 0a20: 6b 20 6f 6e 20 61 20 66 69 6c 65 20 61 74 0a 2a k on a file at.* 0a30: 2a 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 79 * any 0a40: 20 74 69 6d 65 2e 20 4f 74 68 65 72 20 70 72 6f time. Other pro 0a50: 63 65 73 73 65 73 20 6d 61 79 20 68 6f 6c 64 20 cesses may hold 0a60: 61 6e 64 20 6f 62 74 61 69 6e 20 6e 65 77 20 53 and obtain new S 0a70: 48 41 52 45 44 20 6c 6f 63 6b 73 2e 0a 2a 2a 20 HARED locks..** 0a80: 50 45 4e 44 49 4e 47 3a 20 20 20 41 20 73 69 6e PENDING: A sin 0a90: 67 6c 65 20 70 72 6f 63 65 73 73 20 6d 61 79 20 gle process may 0aa0: 68 6f 6c 64 20 61 20 50 45 4e 44 49 4e 47 20 6c hold a PENDING l 0ab0: 6f 63 6b 20 6f 6e 20 61 20 66 69 6c 65 20 61 74 ock on a file at 0ac0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 61 .** a 0ad0: 6e 79 20 6f 6e 65 20 74 69 6d 65 2e 20 45 78 69 ny one time. Exi 0ae0: 73 74 69 6e 67 20 53 48 41 52 45 44 20 6c 6f 63 sting SHARED loc 0af0: 6b 73 20 6d 61 79 20 70 65 72 73 69 73 74 2c 20 ks may persist, 0b00: 62 75 74 20 6e 6f 20 6e 65 77 0a 2a 2a 20 20 20 but no new.** 0b10: 20 20 20 20 20 20 20 20 20 53 48 41 52 45 44 20 SHARED 0b20: 6c 6f 63 6b 73 20 6d 61 79 20 62 65 20 6f 62 74 locks may be obt 0b30: 61 69 6e 65 64 20 62 79 20 6f 74 68 65 72 20 70 ained by other p 0b40: 72 6f 63 65 73 73 65 73 2e 0a 2a 2a 20 45 58 43 rocesses..** EXC 0b50: 4c 55 53 49 56 45 3a 20 41 6e 20 45 58 43 4c 55 LUSIVE: An EXCLU 0b60: 53 49 56 45 20 6c 6f 63 6b 20 70 72 65 63 6c 75 SIVE lock preclu 0b70: 64 65 73 20 61 6c 6c 20 6f 74 68 65 72 20 6c 6f des all other lo 0b80: 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 50 45 4e 44 49 cks..**.** PENDI 0b90: 4e 47 5f 4c 4f 43 4b 20 6d 61 79 20 6e 6f 74 20 NG_LOCK may not 0ba0: 62 65 20 70 61 73 73 65 64 20 64 69 72 65 63 74 be passed direct 0bb0: 6c 79 20 74 6f 20 73 71 6c 69 74 65 33 4f 73 4c ly to sqlite3OsL 0bc0: 6f 63 6b 28 29 2e 20 49 6e 73 74 65 61 64 2c 20 ock(). Instead, 0bd0: 61 0a 2a 2a 20 70 72 6f 63 65 73 73 20 74 68 61 a.** process tha 0be0: 74 20 72 65 71 75 65 73 74 73 20 61 6e 20 45 58 t requests an EX 0bf0: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6d 61 79 CLUSIVE lock may 0c00: 20 61 63 74 75 61 6c 6c 79 20 6f 62 74 61 69 6e actually obtain 0c10: 20 61 20 50 45 4e 44 49 4e 47 0a 2a 2a 20 6c 6f a PENDING.** lo 0c20: 63 6b 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 ck. This can be 0c30: 75 70 67 72 61 64 65 64 20 74 6f 20 61 6e 20 45 upgraded to an E 0c40: 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 62 79 XCLUSIVE lock by 0c50: 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 63 61 a subsequent ca 0c60: 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 ll to.** sqlite3 0c70: 4f 73 4c 6f 63 6b 28 29 2e 0a 2a 2f 0a 23 64 65 OsLock()..*/.#de 0c80: 66 69 6e 65 20 4e 4f 5f 4c 4f 43 4b 20 20 20 20 fine NO_LOCK 0c90: 20 20 20 20 20 30 0a 23 64 65 66 69 6e 65 20 53 0.#define S 0ca0: 48 41 52 45 44 5f 4c 4f 43 4b 20 20 20 20 20 31 HARED_LOCK 1 0cb0: 0a 23 64 65 66 69 6e 65 20 52 45 53 45 52 56 45 .#define RESERVE 0cc0: 44 5f 4c 4f 43 4b 20 20 20 32 0a 23 64 65 66 69 D_LOCK 2.#defi 0cd0: 6e 65 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 ne PENDING_LOCK 0ce0: 20 20 20 33 0a 23 64 65 66 69 6e 65 20 45 58 43 3.#define EXC 0cf0: 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 20 34 0a 0a LUSIVE_LOCK 4.. 0d00: 2f 2a 0a 2a 2a 20 46 69 6c 65 20 4c 6f 63 6b 69 /*.** File Locki 0d10: 6e 67 20 4e 6f 74 65 73 3a 20 20 28 4d 6f 73 74 ng Notes: (Most 0d20: 6c 79 20 61 62 6f 75 74 20 77 69 6e 64 6f 77 73 ly about windows 0d30: 20 62 75 74 20 61 6c 73 6f 20 73 6f 6d 65 20 69 but also some i 0d40: 6e 66 6f 20 66 6f 72 20 55 6e 69 78 29 0a 2a 2a nfo for Unix).** 0d50: 0a 2a 2a 20 57 65 20 63 61 6e 6e 6f 74 20 75 73 .** We cannot us 0d60: 65 20 4c 6f 63 6b 46 69 6c 65 45 78 28 29 20 6f e LockFileEx() o 0d70: 72 20 55 6e 6c 6f 63 6b 46 69 6c 65 45 78 28 29 r UnlockFileEx() 0d80: 20 6f 6e 20 57 69 6e 39 35 2f 39 38 2f 4d 45 20 on Win95/98/ME 0d90: 62 65 63 61 75 73 65 0a 2a 2a 20 74 68 6f 73 65 because.** those 0da0: 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e functions are n 0db0: 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 53 ot available. S 0dc0: 6f 20 77 65 20 75 73 65 20 6f 6e 6c 79 20 4c 6f o we use only Lo 0dd0: 63 6b 46 69 6c 65 28 29 20 61 6e 64 0a 2a 2a 20 ckFile() and.** 0de0: 55 6e 6c 6f 63 6b 46 69 6c 65 28 29 2e 0a 2a 2a UnlockFile()..** 0df0: 0a 2a 2a 20 4c 6f 63 6b 46 69 6c 65 28 29 20 70 .** LockFile() p 0e00: 72 65 76 65 6e 74 73 20 6e 6f 74 20 6a 75 73 74 revents not just 0e10: 20 77 72 69 74 69 6e 67 20 62 75 74 20 61 6c 73 writing but als 0e20: 6f 20 72 65 61 64 69 6e 67 20 62 79 20 6f 74 68 o reading by oth 0e30: 65 72 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a 2a er processes..** 0e40: 20 41 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 69 A SHARED_LOCK i 0e50: 73 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f s obtained by lo 0e60: 63 6b 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 72 cking a single r 0e70: 61 6e 64 6f 6d 6c 79 2d 63 68 6f 73 65 6e 20 0a andomly-chosen . 0e80: 2a 2a 20 62 79 74 65 20 6f 75 74 20 6f 66 20 61 ** byte out of a 0e90: 20 73 70 65 63 69 66 69 63 20 72 61 6e 67 65 20 specific range 0ea0: 6f 66 20 62 79 74 65 73 2e 20 54 68 65 20 6c 6f of bytes. The lo 0eb0: 63 6b 20 62 79 74 65 20 69 73 20 6f 62 74 61 69 ck byte is obtai 0ec0: 6e 65 64 20 61 74 20 0a 2a 2a 20 72 61 6e 64 6f ned at .** rando 0ed0: 6d 20 73 6f 20 74 77 6f 20 73 65 70 61 72 61 74 m so two separat 0ee0: 65 20 72 65 61 64 65 72 73 20 63 61 6e 20 70 72 e readers can pr 0ef0: 6f 62 61 62 6c 79 20 61 63 63 65 73 73 20 74 68 obably access th 0f00: 65 20 66 69 6c 65 20 61 74 20 74 68 65 20 0a 2a e file at the .* 0f10: 2a 20 73 61 6d 65 20 74 69 6d 65 2c 20 75 6e 6c * same time, unl 0f20: 65 73 73 20 74 68 65 79 20 61 72 65 20 75 6e 6c ess they are unl 0f30: 75 63 6b 79 20 61 6e 64 20 63 68 6f 6f 73 65 20 ucky and choose 0f40: 74 68 65 20 73 61 6d 65 20 6c 6f 63 6b 20 62 79 the same lock by 0f50: 74 65 2e 0a 2a 2a 20 41 6e 20 45 58 43 4c 55 53 te..** An EXCLUS 0f60: 49 56 45 5f 4c 4f 43 4b 20 69 73 20 6f 62 74 61 IVE_LOCK is obta 0f70: 69 6e 65 64 20 62 79 20 6c 6f 63 6b 69 6e 67 20 ined by locking 0f80: 61 6c 6c 20 62 79 74 65 73 20 69 6e 20 74 68 65 all bytes in the 0f90: 20 72 61 6e 67 65 2e 0a 2a 2a 20 54 68 65 72 65 range..** There 0fa0: 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 6f 6e 65 can only be one 0fb0: 20 77 72 69 74 65 72 2e 20 20 41 20 52 45 53 45 writer. A RESE 0fc0: 52 56 45 44 5f 4c 4f 43 4b 20 69 73 20 6f 62 74 RVED_LOCK is obt 0fd0: 61 69 6e 65 64 20 62 79 20 6c 6f 63 6b 69 6e 67 ained by locking 0fe0: 0a 2a 2a 20 61 20 73 69 6e 67 6c 65 20 62 79 74 .** a single byt 0ff0: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 68 e of the file th 1000: 61 74 20 69 73 20 64 65 73 69 67 6e 61 74 65 64 at is designated 1010: 20 61 73 20 74 68 65 20 72 65 73 65 72 76 65 64 as the reserved 1020: 20 6c 6f 63 6b 20 62 79 74 65 2e 0a 2a 2a 20 41 lock byte..** A 1030: 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 69 73 PENDING_LOCK is 1040: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63 obtained by loc 1050: 6b 69 6e 67 20 61 20 64 65 73 69 67 6e 61 74 65 king a designate 1060: 64 20 62 79 74 65 20 64 69 66 66 65 72 65 6e 74 d byte different 1070: 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 52 45 53 from.** the RES 1080: 45 52 56 45 44 5f 4c 4f 43 4b 20 62 79 74 65 2e ERVED_LOCK byte. 1090: 0a 2a 2a 0a 2a 2a 20 4f 6e 20 57 69 6e 4e 54 2f .**.** On WinNT/ 10a0: 32 4b 2f 58 50 20 73 79 73 74 65 6d 73 2c 20 4c 2K/XP systems, L 10b0: 6f 63 6b 46 69 6c 65 45 78 28 29 20 61 6e 64 20 ockFileEx() and 10c0: 55 6e 6c 6f 63 6b 46 69 6c 65 45 78 28 29 20 61 UnlockFileEx() a 10d0: 72 65 20 61 76 61 69 6c 61 62 6c 65 2c 0a 2a 2a re available,.** 10e0: 20 77 68 69 63 68 20 6d 65 61 6e 73 20 77 65 20 which means we 10f0: 63 61 6e 20 75 73 65 20 72 65 61 64 65 72 2f 77 can use reader/w 1100: 72 69 74 65 72 20 6c 6f 63 6b 73 2e 20 20 57 68 riter locks. Wh 1110: 65 6e 20 72 65 61 64 65 72 2f 77 72 69 74 65 72 en reader/writer 1120: 20 6c 6f 63 6b 73 0a 2a 2a 20 61 72 65 20 75 73 locks.** are us 1130: 65 64 2c 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 ed, the lock is 1140: 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 20 73 61 placed on the sa 1150: 6d 65 20 72 61 6e 67 65 20 6f 66 20 62 79 74 65 me range of byte 1160: 73 20 74 68 61 74 20 69 73 20 75 73 65 64 0a 2a s that is used.* 1170: 2a 20 66 6f 72 20 70 72 6f 62 61 62 69 6c 69 73 * for probabilis 1180: 74 69 63 20 6c 6f 63 6b 69 6e 67 20 69 6e 20 57 tic locking in W 1190: 69 6e 39 35 2f 39 38 2f 4d 45 2e 20 20 48 65 6e in95/98/ME. Hen 11a0: 63 65 2c 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 ce, the locking 11b0: 73 63 68 65 6d 65 0a 2a 2a 20 77 69 6c 6c 20 73 scheme.** will s 11c0: 75 70 70 6f 72 74 20 74 77 6f 20 6f 72 20 6d 6f upport two or mo 11d0: 72 65 20 57 69 6e 39 35 20 72 65 61 64 65 72 73 re Win95 readers 11e0: 20 6f 72 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 or two or more 11f0: 57 69 6e 4e 54 20 72 65 61 64 65 72 73 2e 0a 2a WinNT readers..* 1200: 2a 20 42 75 74 20 61 20 73 69 6e 67 6c 65 20 57 * But a single W 1210: 69 6e 39 35 20 72 65 61 64 65 72 20 77 69 6c 6c in95 reader will 1220: 20 6c 6f 63 6b 20 6f 75 74 20 61 6c 6c 20 57 69 lock out all Wi 1230: 6e 4e 54 20 72 65 61 64 65 72 73 20 61 6e 64 20 nNT readers and 1240: 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 57 69 6e 4e a single.** WinN 1250: 54 20 72 65 61 64 65 72 20 77 69 6c 6c 20 6c 6f T reader will lo 1260: 63 6b 20 6f 75 74 20 61 6c 6c 20 6f 74 68 65 72 ck out all other 1270: 20 57 69 6e 39 35 20 72 65 61 64 65 72 73 2e 0a Win95 readers.. 1280: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 **.** The follow 1290: 69 6e 67 20 23 64 65 66 69 6e 65 73 20 73 70 65 ing #defines spe 12a0: 63 69 66 79 20 74 68 65 20 72 61 6e 67 65 20 6f cify the range o 12b0: 66 20 62 79 74 65 73 20 75 73 65 64 20 66 6f 72 f bytes used for 12c0: 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2a 20 53 48 41 locking..** SHA 12d0: 52 45 44 5f 53 49 5a 45 20 69 73 20 74 68 65 20 RED_SIZE is the 12e0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes 12f0: 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 available in the 1300: 20 70 6f 6f 6c 20 66 72 6f 6d 20 77 68 69 63 68 pool from which 1310: 0a 2a 2a 20 61 20 72 61 6e 64 6f 6d 20 62 79 74 .** a random byt 1320: 65 20 69 73 20 73 65 6c 65 63 74 65 64 20 66 6f e is selected fo 1330: 72 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e r a shared lock. 1340: 20 20 54 68 65 20 70 6f 6f 6c 20 6f 66 20 62 79 The pool of by 1350: 74 65 73 20 66 6f 72 0a 2a 2a 20 73 68 61 72 65 tes for.** share 1360: 64 20 6c 6f 63 6b 73 20 62 65 67 69 6e 73 20 61 d locks begins a 1370: 74 20 53 48 41 52 45 44 5f 46 49 52 53 54 2e 20 t SHARED_FIRST. 1380: 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 23 64 65 .**.** These #de 1390: 66 69 6e 65 73 20 61 72 65 20 61 76 61 69 6c 61 fines are availa 13a0: 62 6c 65 20 69 6e 20 6f 73 2e 68 20 73 6f 20 74 ble in os.h so t 13b0: 68 61 74 20 55 6e 69 78 20 63 61 6e 20 75 73 65 hat Unix can use 13c0: 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 62 79 74 the same.** byt 13d0: 65 20 72 61 6e 67 65 73 20 66 6f 72 20 6c 6f 63 e ranges for loc 13e0: 6b 69 6e 67 2e 20 20 54 68 69 73 20 6c 65 61 76 king. This leav 13f0: 65 73 20 6f 70 65 6e 20 74 68 65 20 70 6f 73 73 es open the poss 1400: 69 62 6c 69 74 79 20 6f 66 20 68 61 76 69 6e 67 iblity of having 1410: 0a 2a 2a 20 63 6c 69 65 6e 74 73 20 6f 6e 20 77 .** clients on w 1420: 69 6e 39 35 2c 20 77 69 6e 4e 54 2c 20 61 6e 64 in95, winNT, and 1430: 20 75 6e 69 78 20 61 6c 6c 20 74 61 6c 6b 69 6e unix all talkin 1440: 67 20 74 6f 20 74 68 65 20 73 61 6d 65 20 73 68 g to the same sh 1450: 61 72 65 64 20 66 69 6c 65 0a 2a 2a 20 61 6e 64 ared file.** and 1460: 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 63 6f 72 all locking cor 1470: 72 65 63 74 6c 79 2e 20 20 54 6f 20 64 6f 20 73 rectly. To do s 1480: 6f 20 77 6f 75 6c 64 20 72 65 71 75 69 72 65 20 o would require 1490: 74 68 61 74 20 73 61 6d 62 61 20 28 6f 72 20 77 that samba (or w 14a0: 68 61 74 65 76 65 72 0a 2a 2a 20 74 6f 6f 6c 20 hatever.** tool 14b0: 69 73 20 62 65 69 6e 67 20 75 73 65 64 20 66 6f is being used fo 14c0: 72 20 66 69 6c 65 20 73 68 61 72 69 6e 67 29 20 r file sharing) 14d0: 69 6d 70 6c 65 6d 65 6e 74 73 20 6c 6f 63 6b 73 implements locks 14e0: 20 63 6f 72 72 65 63 74 6c 79 20 62 65 74 77 65 correctly betwe 14f0: 65 6e 0a 2a 2a 20 77 69 6e 64 6f 77 73 20 61 6e en.** windows an 1500: 64 20 75 6e 69 78 2e 20 20 49 27 6d 20 67 75 65 d unix. I'm gue 1510: 73 73 69 6e 67 20 74 68 61 74 20 69 73 6e 27 74 ssing that isn't 1520: 20 6c 69 6b 65 6c 79 20 74 6f 20 68 61 70 70 65 likely to happe 1530: 6e 2c 20 62 75 74 20 62 79 0a 2a 2a 20 75 73 69 n, but by.** usi 1540: 6e 67 20 74 68 65 20 73 61 6d 65 20 6c 6f 63 6b ng the same lock 1550: 69 6e 67 20 72 61 6e 67 65 20 77 65 20 61 72 65 ing range we are 1560: 20 61 74 20 6c 65 61 73 74 20 6f 70 65 6e 20 74 at least open t 1570: 6f 20 74 68 65 20 70 6f 73 73 69 62 69 6c 69 74 o the possibilit 1580: 79 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63 6b 69 6e 67 y..**.** Locking 1590: 20 69 6e 20 77 69 6e 64 6f 77 73 20 69 73 20 6d in windows is m 15a0: 61 6e 64 69 74 6f 72 79 2e 20 20 46 6f 72 20 74 anditory. For t 15b0: 68 69 73 20 72 65 61 73 6f 6e 2c 20 77 65 20 63 his reason, we c 15c0: 61 6e 6e 6f 74 20 73 74 6f 72 65 0a 2a 2a 20 61 annot store.** a 15d0: 63 74 75 61 6c 20 64 61 74 61 20 69 6e 20 74 68 ctual data in th 15e0: 65 20 62 79 74 65 73 20 75 73 65 64 20 66 6f 72 e bytes used for 15f0: 20 6c 6f 63 6b 69 6e 67 2e 20 20 54 68 65 20 70 locking. The p 1600: 61 67 65 72 20 6e 65 76 65 72 20 61 6c 6c 6f 63 ager never alloc 1610: 61 74 65 73 0a 2a 2a 20 74 68 65 20 70 61 67 65 ates.** the page 1620: 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 6c 6f s involved in lo 1630: 63 6b 69 6e 67 20 74 68 65 72 65 66 6f 72 65 2e cking therefore. 1640: 20 20 53 48 41 52 45 44 5f 53 49 5a 45 20 69 73 SHARED_SIZE is 1650: 20 73 65 6c 65 63 74 65 64 20 73 6f 0a 2a 2a 20 selected so.** 1660: 74 68 61 74 20 61 6c 6c 20 6c 6f 63 6b 73 20 77 that all locks w 1670: 69 6c 6c 20 66 69 74 20 6f 6e 20 61 20 73 69 6e ill fit on a sin 1680: 67 6c 65 20 70 61 67 65 20 65 76 65 6e 20 61 74 gle page even at 1690: 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 70 61 67 the minimum pag 16a0: 65 20 73 69 7a 65 2e 0a 2a 2a 20 50 45 4e 44 49 e size..** PENDI 16b0: 4e 47 5f 42 59 54 45 20 64 65 66 69 6e 65 73 20 NG_BYTE defines 16c0: 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 the beginning of 16d0: 20 74 68 65 20 6c 6f 63 6b 73 2e 20 20 42 79 20 the locks. By 16e0: 64 65 66 61 75 6c 74 20 50 45 4e 44 49 4e 47 5f default PENDING_ 16f0: 42 59 54 45 0a 2a 2a 20 69 73 20 73 65 74 20 68 BYTE.** is set h 1700: 69 67 68 20 73 6f 20 74 68 61 74 20 77 65 20 64 igh so that we d 1710: 6f 6e 27 74 20 68 61 76 65 20 74 6f 20 61 6c 6c on't have to all 1720: 6f 63 61 74 65 20 61 6e 20 75 6e 75 73 65 64 20 ocate an unused 1730: 70 61 67 65 20 65 78 63 65 70 74 0a 2a 2a 20 66 page except.** f 1740: 6f 72 20 76 65 72 79 20 6c 61 72 67 65 20 64 61 or very large da 1750: 74 61 62 61 73 65 73 2e 20 20 42 75 74 20 6f 6e tabases. But on 1760: 65 20 73 68 6f 75 6c 64 20 74 65 73 74 20 74 68 e should test th 1770: 65 20 70 61 67 65 20 73 6b 69 70 70 69 6e 67 20 e page skipping 1780: 6c 6f 67 69 63 20 0a 2a 2a 20 62 79 20 73 65 74 logic .** by set 1790: 74 69 6e 67 20 50 45 4e 44 49 4e 47 5f 42 59 54 ting PENDING_BYT 17a0: 45 20 6c 6f 77 20 61 6e 64 20 72 75 6e 6e 69 6e E low and runnin 17b0: 67 20 74 68 65 20 65 6e 74 69 72 65 20 72 65 67 g the entire reg 17c0: 72 65 73 73 69 6f 6e 20 73 75 69 74 65 2e 0a 2a ression suite..* 17d0: 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e 67 20 74 68 *.** Changing th 17e0: 65 20 76 61 6c 75 65 20 6f 66 20 50 45 4e 44 49 e value of PENDI 17f0: 4e 47 5f 42 59 54 45 20 72 65 73 75 6c 74 73 20 NG_BYTE results 1800: 69 6e 20 61 20 73 75 62 74 6c 79 20 69 6e 63 6f in a subtly inco 1810: 6d 70 61 74 69 62 6c 65 0a 2a 2a 20 66 69 6c 65 mpatible.** file 1820: 20 66 6f 72 6d 61 74 2e 20 20 44 65 70 65 6e 64 format. Depend 1830: 69 6e 67 20 6f 6e 20 68 6f 77 20 69 74 20 69 73 ing on how it is 1840: 20 63 68 61 6e 67 65 64 2c 20 79 6f 75 20 6d 69 changed, you mi 1850: 67 68 74 20 6e 6f 74 20 6e 6f 74 69 63 65 0a 2a ght not notice.* 1860: 2a 20 74 68 65 20 69 6e 63 6f 6d 70 61 74 69 62 * the incompatib 1870: 69 6c 69 74 79 20 72 69 67 68 74 20 61 77 61 79 ility right away 1880: 2c 20 65 76 65 6e 20 72 75 6e 6e 69 6e 67 20 61 , even running a 1890: 20 66 75 6c 6c 20 72 65 67 72 65 73 73 69 6f 6e full regression 18a0: 20 74 65 73 74 2e 0a 2a 2a 20 54 68 65 20 64 65 test..** The de 18b0: 66 61 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 20 6f fault location o 18c0: 66 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 69 f PENDING_BYTE i 18d0: 73 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 s the first byte 18e0: 20 70 61 73 74 20 74 68 65 0a 2a 2a 20 31 47 42 past the.** 1GB 18f0: 20 62 6f 75 6e 64 61 72 79 2e 0a 2a 2a 0a 2a 2f boundary..**.*/ 1900: 0a 23 64 65 66 69 6e 65 20 50 45 4e 44 49 4e 47 .#define PENDING 1910: 5f 42 59 54 45 20 20 20 20 20 20 30 78 34 30 30 _BYTE 0x400 1920: 30 30 30 30 30 20 20 2f 2a 20 46 69 72 73 74 20 00000 /* First 1930: 62 79 74 65 20 70 61 73 74 20 74 68 65 20 31 47 byte past the 1G 1940: 42 20 62 6f 75 6e 64 61 72 79 20 2a 2f 0a 2f 2a B boundary */./* 1950: 20 23 64 65 66 69 6e 65 20 50 45 4e 44 49 4e 47 #define PENDING 1960: 5f 42 59 54 45 20 20 20 20 20 30 78 35 34 30 30 _BYTE 0x5400 1970: 20 20 20 2f 2f 20 50 61 67 65 20 32 30 20 2d 20 // Page 20 - 1980: 66 6f 72 20 74 65 73 74 69 6e 67 20 2a 2f 0a 23 for testing */.# 1990: 64 65 66 69 6e 65 20 52 45 53 45 52 56 45 44 5f define RESERVED_ 19a0: 42 59 54 45 20 20 20 20 20 28 50 45 4e 44 49 4e BYTE (PENDIN 19b0: 47 5f 42 59 54 45 2b 31 29 0a 23 64 65 66 69 6e G_BYTE+1).#defin 19c0: 65 20 53 48 41 52 45 44 5f 46 49 52 53 54 20 20 e SHARED_FIRST 19d0: 20 20 20 20 28 50 45 4e 44 49 4e 47 5f 42 59 54 (PENDING_BYT 19e0: 45 2b 32 29 0a 23 64 65 66 69 6e 65 20 53 48 41 E+2).#define SHA 19f0: 52 45 44 5f 53 49 5a 45 20 20 20 20 20 20 20 35 RED_SIZE 5 1a00: 31 30 0a 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 10...int sqlite3 1a10: 4f 73 44 65 6c 65 74 65 28 63 6f 6e 73 74 20 63 OsDelete(const c 1a20: 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 har*);.int sqlit 1a30: 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 28 63 e3OsFileExists(c 1a40: 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 onst char*);.int 1a50: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 sqlite3OsOpenRe 1a60: 61 64 57 72 69 74 65 28 63 6f 6e 73 74 20 63 68 adWrite(const ch 1a70: 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2c 20 69 6e ar*, OsFile*, in 1a80: 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3 1a90: 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 OsOpenExclusive( 1aa0: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73 46 const char*, OsF 1ab0: 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 ile*, int);.int 1ac0: 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 sqlite3OsOpenRea 1ad0: 64 4f 6e 6c 79 28 63 6f 6e 73 74 20 63 68 61 72 dOnly(const char 1ae0: 2a 2c 20 4f 73 46 69 6c 65 2a 29 3b 0a 69 6e 74 *, OsFile*);.int 1af0: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44 69 sqlite3OsOpenDi 1b00: 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 63 68 rectory(const ch 1b10: 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 29 3b 0a 69 ar*, OsFile*);.i 1b20: 6e 74 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 nt sqlite3OsSync 1b30: 44 69 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 Directory(const 1b40: 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 char*);.int sqli 1b50: 74 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d te3OsTempFileNam 1b60: 65 28 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 e(char*);.int sq 1b70: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 4f 73 46 lite3OsClose(OsF 1b80: 69 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ile*);.int sqlit 1b90: 65 33 4f 73 52 65 61 64 28 4f 73 46 69 6c 65 2a e3OsRead(OsFile* 1ba0: 2c 20 76 6f 69 64 2a 2c 20 69 6e 74 20 61 6d 74 , void*, int amt 1bb0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 );.int sqlite3Os 1bc0: 57 72 69 74 65 28 4f 73 46 69 6c 65 2a 2c 20 63 Write(OsFile*, c 1bd0: 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 20 onst void*, int 1be0: 61 6d 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 amt);.int sqlite 1bf0: 33 4f 73 53 65 65 6b 28 4f 73 46 69 6c 65 2a 2c 3OsSeek(OsFile*, 1c00: 20 69 36 34 20 6f 66 66 73 65 74 29 3b 0a 69 6e i64 offset);.in 1c10: 74 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 t sqlite3OsSync( 1c20: 4f 73 46 69 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 OsFile*);.int sq 1c30: 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 lite3OsTruncate( 1c40: 4f 73 46 69 6c 65 2a 2c 20 69 36 34 20 73 69 7a OsFile*, i64 siz 1c50: 65 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f e);.int sqlite3O 1c60: 73 46 69 6c 65 53 69 7a 65 28 4f 73 46 69 6c 65 sFileSize(OsFile 1c70: 2a 2c 20 69 36 34 20 2a 70 53 69 7a 65 29 3b 0a *, i64 *pSize);. 1c80: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 52 61 6e int sqlite3OsRan 1c90: 64 6f 6d 53 65 65 64 28 63 68 61 72 2a 29 3b 0a domSeed(char*);. 1ca0: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 int sqlite3OsSle 1cb0: 65 70 28 69 6e 74 20 6d 73 29 3b 0a 69 6e 74 20 ep(int ms);.int 1cc0: 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65 6e 74 sqlite3OsCurrent 1cd0: 54 69 6d 65 28 64 6f 75 62 6c 65 2a 29 3b 0a 69 Time(double*);.i 1ce0: 6e 74 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 nt sqlite3OsFile 1cf0: 4d 6f 64 54 69 6d 65 28 4f 73 46 69 6c 65 2a 2c ModTime(OsFile*, 1d00: 20 64 6f 75 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 double*);.void 1d10: 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 sqlite3OsEnterMu 1d20: 74 65 78 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 tex(void);.void 1d30: 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 sqlite3OsLeaveMu 1d40: 74 65 78 28 76 6f 69 64 29 3b 0a 63 68 61 72 20 tex(void);.char 1d50: 2a 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 *sqlite3OsFullPa 1d60: 74 68 6e 61 6d 65 28 63 6f 6e 73 74 20 63 68 61 thname(const cha 1d70: 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3 1d80: 4f 73 4c 6f 63 6b 28 4f 73 46 69 6c 65 2a 2c 20 OsLock(OsFile*, 1d90: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite 1da0: 33 4f 73 55 6e 6c 6f 63 6b 28 4f 73 46 69 6c 65 3OsUnlock(OsFile 1db0: 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c *, int);.int sql 1dc0: 69 74 65 33 4f 73 43 68 65 63 6b 52 65 73 65 72 ite3OsCheckReser 1dd0: 76 65 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a vedLock(OsFile * 1de0: 69 64 29 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 id);..#endif /* 1df0: 5f 53 51 4c 49 54 45 5f 4f 53 5f 48 5f 20 2a 2f _SQLITE_OS_H_ */ 1e00: 0a .