0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32 /*.** 2004 May 2
0010: 32 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 2.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 ource code. In
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 **.** May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 evil..** May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 thers..** May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 y, never taking
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ve..**.*********
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 0a 2a 2a 0a 2a 2a 20 54 68 69 73 *****.**.** This
0180: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 74 file contains t
0190: 68 65 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74 he VFS implement
01a0: 61 74 69 6f 6e 20 66 6f 72 20 75 6e 69 78 2d 6c ation for unix-l
01b0: 69 6b 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 ike operating sy
01c0: 73 74 65 6d 73 0a 2a 2a 20 69 6e 63 6c 75 64 65 stems.** include
01d0: 20 4c 69 6e 75 78 2c 20 4d 61 63 4f 53 58 2c 20 Linux, MacOSX,
01e0: 2a 42 53 44 2c 20 51 4e 58 2c 20 56 78 57 6f 72 *BSD, QNX, VxWor
01f0: 6b 73 2c 20 41 49 58 2c 20 48 50 55 58 2c 20 61 ks, AIX, HPUX, a
0200: 6e 64 20 6f 74 68 65 72 73 2e 0a 2a 2a 0a 2a 2a nd others..**.**
0210: 20 54 68 65 72 65 20 61 72 65 20 61 63 74 75 61 There are actua
0220: 6c 6c 79 20 73 65 76 65 72 61 6c 20 64 69 66 66 lly several diff
0230: 65 72 65 6e 74 20 56 46 53 20 69 6d 70 6c 65 6d erent VFS implem
0240: 65 6e 74 61 74 69 6f 6e 73 20 69 6e 20 74 68 69 entations in thi
0250: 73 20 66 69 6c 65 2e 0a 2a 2a 20 54 68 65 20 64 s file..** The d
0260: 69 66 66 65 72 65 6e 63 65 73 20 61 72 65 20 69 ifferences are i
0270: 6e 20 74 68 65 20 77 61 79 20 74 68 61 74 20 66 n the way that f
0280: 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 64 ile locking is d
0290: 6f 6e 65 2e 20 20 54 68 65 20 64 65 66 61 75 6c one. The defaul
02a0: 74 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 t.** implementat
02b0: 69 6f 6e 20 75 73 65 73 20 50 6f 73 69 78 20 41 ion uses Posix A
02c0: 64 76 69 73 6f 72 79 20 4c 6f 63 6b 73 2e 20 20 dvisory Locks.
02d0: 41 6c 74 65 72 6e 61 74 69 76 65 20 69 6d 70 6c Alternative impl
02e0: 65 6d 65 6e 74 61 74 69 6f 6e 73 0a 2a 2a 20 75 ementations.** u
02f0: 73 65 20 66 6c 6f 63 6b 28 29 2c 20 64 6f 74 2d se flock(), dot-
0300: 66 69 6c 65 73 2c 20 76 61 72 69 6f 75 73 20 70 files, various p
0310: 72 6f 70 72 69 65 74 61 72 79 20 6c 6f 63 6b 69 roprietary locki
0320: 6e 67 20 73 63 68 65 6d 61 73 2c 20 6f 72 20 73 ng schemas, or s
0330: 69 6d 70 6c 79 0a 2a 2a 20 73 6b 69 70 20 6c 6f imply.** skip lo
0340: 63 6b 69 6e 67 20 61 6c 6c 20 74 6f 67 65 74 68 cking all togeth
0350: 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 er..**.** This s
0360: 6f 75 72 63 65 20 66 69 6c 65 20 69 73 20 6f 72 ource file is or
0370: 67 61 6e 69 7a 65 64 20 69 6e 74 6f 20 64 69 76 ganized into div
0380: 69 73 69 6f 6e 73 20 77 68 65 72 65 20 74 68 65 isions where the
0390: 20 6c 6f 67 69 63 20 66 6f 72 20 76 61 72 69 6f logic for vario
03a0: 75 73 0a 2a 2a 20 73 75 62 66 75 6e 63 74 69 6f us.** subfunctio
03b0: 6e 73 20 69 73 20 63 6f 6e 74 61 69 6e 65 64 20 ns is contained
03c0: 77 69 74 68 69 6e 20 74 68 65 20 61 70 70 72 6f within the appro
03d0: 70 72 69 61 74 65 20 64 69 76 69 73 69 6f 6e 2e priate division.
03e0: 20 20 50 4c 45 41 53 45 0a 2a 2a 20 4b 45 45 50 PLEASE.** KEEP
03f0: 20 54 48 45 20 53 54 52 55 43 54 55 52 45 20 4f THE STRUCTURE O
0400: 46 20 54 48 49 53 20 46 49 4c 45 20 49 4e 54 41 F THIS FILE INTA
0410: 43 54 2e 20 20 4e 65 77 20 63 6f 64 65 20 73 68 CT. New code sh
0420: 6f 75 6c 64 20 62 65 20 70 6c 61 63 65 64 0a 2a ould be placed.*
0430: 2a 20 69 6e 20 74 68 65 20 63 6f 72 72 65 63 74 * in the correct
0440: 20 64 69 76 69 73 69 6f 6e 20 61 6e 64 20 73 68 division and sh
0450: 6f 75 6c 64 20 62 65 20 63 6c 65 61 72 6c 79 20 ould be clearly
0460: 6c 61 62 65 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 labeled..**.** T
0470: 68 65 20 6c 61 79 6f 75 74 20 6f 66 20 64 69 76 he layout of div
0480: 69 73 69 6f 6e 73 20 69 73 20 61 73 20 66 6f 6c isions is as fol
0490: 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 lows:.**.** *
04a0: 20 47 65 6e 65 72 61 6c 2d 70 75 72 70 6f 73 65 General-purpose
04b0: 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 61 6e declarations an
04c0: 64 20 75 74 69 6c 69 74 79 20 66 75 6e 63 74 69 d utility functi
04d0: 6f 6e 73 2e 0a 2a 2a 20 20 20 2a 20 20 55 6e 69 ons..** * Uni
04e0: 71 75 65 20 66 69 6c 65 20 49 44 20 6c 6f 67 69 que file ID logi
04f0: 63 20 75 73 65 64 20 62 79 20 56 78 57 6f 72 6b c used by VxWork
0500: 73 2e 0a 2a 2a 20 20 20 2a 20 20 56 61 72 69 6f s..** * Vario
0510: 75 73 20 6c 6f 63 6b 69 6e 67 20 70 72 69 6d 69 us locking primi
0520: 74 69 76 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 tive implementat
0530: 69 6f 6e 73 20 28 61 6c 6c 20 65 78 63 65 70 74 ions (all except
0540: 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 29 3a proxy locking):
0550: 0a 2a 2a 20 20 20 20 20 20 2b 20 66 6f 72 20 50 .** + for P
0560: 6f 73 69 78 20 41 64 76 69 73 6f 72 79 20 4c 6f osix Advisory Lo
0570: 63 6b 73 0a 2a 2a 20 20 20 20 20 20 2b 20 66 6f cks.** + fo
0580: 72 20 6e 6f 2d 6f 70 20 6c 6f 63 6b 73 0a 2a 2a r no-op locks.**
0590: 20 20 20 20 20 20 2b 20 66 6f 72 20 64 6f 74 2d + for dot-
05a0: 66 69 6c 65 20 6c 6f 63 6b 73 0a 2a 2a 20 20 20 file locks.**
05b0: 20 20 20 2b 20 66 6f 72 20 66 6c 6f 63 6b 28 29 + for flock()
05c0: 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 20 locking.**
05d0: 20 2b 20 66 6f 72 20 6e 61 6d 65 64 20 73 65 6d + for named sem
05e0: 61 70 68 6f 72 65 20 6c 6f 63 6b 73 20 28 56 78 aphore locks (Vx
05f0: 57 6f 72 6b 73 20 6f 6e 6c 79 29 0a 2a 2a 20 20 Works only).**
0600: 20 20 20 20 2b 20 66 6f 72 20 41 46 50 20 66 69 + for AFP fi
0610: 6c 65 73 79 73 74 65 6d 20 6c 6f 63 6b 73 20 28 lesystem locks (
0620: 4d 61 63 4f 53 58 20 6f 6e 6c 79 29 0a 2a 2a 20 MacOSX only).**
0630: 20 20 2a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c * sqlite3_fil
0640: 65 20 6d 65 74 68 6f 64 73 20 6e 6f 74 20 61 73 e methods not as
0650: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 6c 6f sociated with lo
0660: 63 6b 69 6e 67 2e 0a 2a 2a 20 20 20 2a 20 20 44 cking..** * D
0670: 65 66 69 6e 69 74 69 6f 6e 73 20 6f 66 20 73 71 efinitions of sq
0680: 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 lite3_io_methods
0690: 20 6f 62 6a 65 63 74 73 20 66 6f 72 20 61 6c 6c objects for all
06a0: 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 20 locking.**
06b0: 20 6d 65 74 68 6f 64 73 20 70 6c 75 73 20 22 66 methods plus "f
06c0: 69 6e 64 65 72 22 20 66 75 6e 63 74 69 6f 6e 73 inder" functions
06d0: 20 66 6f 72 20 65 61 63 68 20 6c 6f 63 6b 69 6e for each lockin
06e0: 67 20 6d 65 74 68 6f 64 2e 0a 2a 2a 20 20 20 2a g method..** *
06f0: 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 6d 65 sqlite3_vfs me
0700: 74 68 6f 64 20 69 6d 70 6c 65 6d 65 6e 74 61 74 thod implementat
0710: 69 6f 6e 73 2e 0a 2a 2a 20 20 20 2a 20 20 4c 6f ions..** * Lo
0720: 63 6b 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 cking primitives
0730: 20 66 6f 72 20 74 68 65 20 70 72 6f 78 79 20 75 for the proxy u
0740: 62 65 72 2d 6c 6f 63 6b 69 6e 67 2d 6d 65 74 68 ber-locking-meth
0750: 6f 64 2e 20 28 4d 61 63 4f 53 58 20 6f 6e 6c 79 od. (MacOSX only
0760: 29 0a 2a 2a 20 20 20 2a 20 20 44 65 66 69 6e 69 ).** * Defini
0770: 74 69 6f 6e 73 20 6f 66 20 73 71 6c 69 74 65 33 tions of sqlite3
0780: 5f 76 66 73 20 6f 62 6a 65 63 74 73 20 66 6f 72 _vfs objects for
0790: 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 all locking met
07a0: 68 6f 64 73 0a 2a 2a 20 20 20 20 20 20 70 6c 75 hods.** plu
07b0: 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e s implementation
07c0: 73 20 6f 66 20 73 71 6c 69 74 65 33 5f 6f 73 5f s of sqlite3_os_
07d0: 69 6e 69 74 28 29 20 61 6e 64 20 73 71 6c 69 74 init() and sqlit
07e0: 65 33 5f 6f 73 5f 65 6e 64 28 29 2e 0a 2a 2f 0a e3_os_end()..*/.
07f0: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite
0800: 49 6e 74 2e 68 22 0a 23 69 66 20 53 51 4c 49 54 Int.h".#if SQLIT
0810: 45 5f 4f 53 5f 55 4e 49 58 20 20 20 20 20 20 20 E_OS_UNIX
0820: 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 66 /* This f
0830: 69 6c 65 20 69 73 20 75 73 65 64 20 6f 6e 20 75 ile is used on u
0840: 6e 69 78 20 6f 6e 6c 79 20 2a 2f 0a 0a 2f 2a 0a nix only */../*.
0850: 2a 2a 20 54 68 65 72 65 20 61 72 65 20 76 61 72 ** There are var
0860: 69 6f 75 73 20 6d 65 74 68 6f 64 73 20 66 6f 72 ious methods for
0870: 20 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 75 73 file locking us
0880: 65 64 20 66 6f 72 20 63 6f 6e 63 75 72 72 65 6e ed for concurren
0890: 63 79 0a 2a 2a 20 63 6f 6e 74 72 6f 6c 3a 0a 2a cy.** control:.*
08a0: 2a 0a 2a 2a 20 20 20 31 2e 20 50 4f 53 49 58 20 *.** 1. POSIX
08b0: 6c 6f 63 6b 69 6e 67 20 28 74 68 65 20 64 65 66 locking (the def
08c0: 61 75 6c 74 29 2c 0a 2a 2a 20 20 20 32 2e 20 4e ault),.** 2. N
08d0: 6f 20 6c 6f 63 6b 69 6e 67 2c 0a 2a 2a 20 20 20 o locking,.**
08e0: 33 2e 20 44 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 3. Dot-file lock
08f0: 69 6e 67 2c 0a 2a 2a 20 20 20 34 2e 20 66 6c 6f ing,.** 4. flo
0900: 63 6b 28 29 20 6c 6f 63 6b 69 6e 67 2c 0a 2a 2a ck() locking,.**
0910: 20 20 20 35 2e 20 41 46 50 20 6c 6f 63 6b 69 6e 5. AFP lockin
0920: 67 20 28 4f 53 58 20 6f 6e 6c 79 29 2c 0a 2a 2a g (OSX only),.**
0930: 20 20 20 36 2e 20 4e 61 6d 65 64 20 50 4f 53 49 6. Named POSI
0940: 58 20 73 65 6d 61 70 68 6f 72 65 73 20 28 56 58 X semaphores (VX
0950: 57 6f 72 6b 73 20 6f 6e 6c 79 29 2c 0a 2a 2a 20 Works only),.**
0960: 20 20 37 2e 20 70 72 6f 78 79 20 6c 6f 63 6b 69 7. proxy locki
0970: 6e 67 2e 20 28 4f 53 58 20 6f 6e 6c 79 29 0a 2a ng. (OSX only).*
0980: 2a 0a 2a 2a 20 53 74 79 6c 65 73 20 34 2c 20 35 *.** Styles 4, 5
0990: 2c 20 61 6e 64 20 37 20 61 72 65 20 6f 6e 6c 79 , and 7 are only
09a0: 20 61 76 61 69 6c 61 62 6c 65 20 6f 66 20 53 51 available of SQ
09b0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b LITE_ENABLE_LOCK
09c0: 49 4e 47 5f 53 54 59 4c 45 0a 2a 2a 20 69 73 20 ING_STYLE.** is
09d0: 64 65 66 69 6e 65 64 20 74 6f 20 31 2e 20 20 54 defined to 1. T
09e0: 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 he SQLITE_ENABLE
09f0: 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 61 _LOCKING_STYLE a
0a00: 6c 73 6f 20 65 6e 61 62 6c 65 73 20 61 75 74 6f lso enables auto
0a10: 6d 61 74 69 63 0a 2a 2a 20 73 65 6c 65 63 74 69 matic.** selecti
0a20: 6f 6e 20 6f 66 20 74 68 65 20 61 70 70 72 6f 70 on of the approp
0a30: 72 69 61 74 65 20 6c 6f 63 6b 69 6e 67 20 73 74 riate locking st
0a40: 79 6c 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 yle based on the
0a50: 20 66 69 6c 65 73 79 73 74 65 6d 0a 2a 2a 20 77 filesystem.** w
0a60: 68 65 72 65 20 74 68 65 20 64 61 74 61 62 61 73 here the databas
0a70: 65 20 69 73 20 6c 6f 63 61 74 65 64 2e 20 20 0a e is located. .
0a80: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
0a90: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f SQLITE_ENABLE_LO
0aa0: 43 4b 49 4e 47 5f 53 54 59 4c 45 29 0a 23 20 20 CKING_STYLE).#
0ab0: 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 if defined(__APP
0ac0: 4c 45 5f 5f 29 0a 23 20 20 20 20 64 65 66 69 6e LE__).# defin
0ad0: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f e SQLITE_ENABLE_
0ae0: 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 31 0a LOCKING_STYLE 1.
0af0: 23 20 20 65 6c 73 65 0a 23 20 20 20 20 64 65 66 # else.# def
0b00: 69 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c ine SQLITE_ENABL
0b10: 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 E_LOCKING_STYLE
0b20: 30 0a 23 20 20 65 6e 64 69 66 0a 23 65 6e 64 69 0.# endif.#endi
0b30: 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 69 6e 65 20 f../*.** Define
0b40: 74 68 65 20 4f 53 5f 56 58 57 4f 52 4b 53 20 70 the OS_VXWORKS p
0b50: 72 65 2d 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 re-processor mac
0b60: 72 6f 20 74 6f 20 31 20 69 66 20 62 75 69 6c 64 ro to 1 if build
0b70: 69 6e 67 20 6f 6e 20 0a 2a 2a 20 76 78 77 6f 72 ing on .** vxwor
0b80: 6b 73 2c 20 6f 72 20 30 20 6f 74 68 65 72 77 69 ks, or 0 otherwi
0b90: 73 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4f se..*/.#ifndef O
0ba0: 53 5f 56 58 57 4f 52 4b 53 0a 23 20 20 69 66 20 S_VXWORKS.# if
0bb0: 64 65 66 69 6e 65 64 28 5f 5f 52 54 50 5f 5f 29 defined(__RTP__)
0bc0: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 57 52 53 || defined(_WRS
0bd0: 5f 4b 45 52 4e 45 4c 29 0a 23 20 20 20 20 64 65 _KERNEL).# de
0be0: 66 69 6e 65 20 4f 53 5f 56 58 57 4f 52 4b 53 20 fine OS_VXWORKS
0bf0: 31 0a 23 20 20 65 6c 73 65 0a 23 20 20 20 20 64 1.# else.# d
0c00: 65 66 69 6e 65 20 4f 53 5f 56 58 57 4f 52 4b 53 efine OS_VXWORKS
0c10: 20 30 0a 23 20 20 65 6e 64 69 66 0a 23 65 6e 64 0.# endif.#end
0c20: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 if../*.** These
0c30: 23 64 65 66 69 6e 65 73 20 73 68 6f 75 6c 64 20 #defines should
0c40: 65 6e 61 62 6c 65 20 3e 32 47 42 20 66 69 6c 65 enable >2GB file
0c50: 20 73 75 70 70 6f 72 74 20 6f 6e 20 50 6f 73 69 support on Posi
0c60: 78 20 69 66 20 74 68 65 0a 2a 2a 20 75 6e 64 65 x if the.** unde
0c70: 72 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67 rlying operating
0c80: 20 73 79 73 74 65 6d 20 73 75 70 70 6f 72 74 73 system supports
0c90: 20 69 74 2e 20 20 49 66 20 74 68 65 20 4f 53 20 it. If the OS
0ca0: 6c 61 63 6b 73 0a 2a 2a 20 6c 61 72 67 65 20 66 lacks.** large f
0cb0: 69 6c 65 20 73 75 70 70 6f 72 74 2c 20 74 68 65 ile support, the
0cc0: 73 65 20 73 68 6f 75 6c 64 20 62 65 20 6e 6f 2d se should be no-
0cd0: 6f 70 73 2e 0a 2a 2a 0a 2a 2a 20 4c 61 72 67 65 ops..**.** Large
0ce0: 20 66 69 6c 65 20 73 75 70 70 6f 72 74 20 63 61 file support ca
0cf0: 6e 20 62 65 20 64 69 73 61 62 6c 65 64 20 75 73 n be disabled us
0d00: 69 6e 67 20 74 68 65 20 2d 44 53 51 4c 49 54 45 ing the -DSQLITE
0d10: 5f 44 49 53 41 42 4c 45 5f 4c 46 53 20 73 77 69 _DISABLE_LFS swi
0d20: 74 63 68 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 6f tch.** on the co
0d30: 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 6e 64 20 6c mpiler command l
0d40: 69 6e 65 2e 20 20 54 68 69 73 20 69 73 20 6e 65 ine. This is ne
0d50: 63 65 73 73 61 72 79 20 69 66 20 79 6f 75 20 61 cessary if you a
0d60: 72 65 20 63 6f 6d 70 69 6c 69 6e 67 0a 2a 2a 20 re compiling.**
0d70: 6f 6e 20 61 20 72 65 63 65 6e 74 20 6d 61 63 68 on a recent mach
0d80: 69 6e 65 20 28 65 78 3a 20 52 65 64 48 61 74 20 ine (ex: RedHat
0d90: 37 2e 32 29 20 62 75 74 20 79 6f 75 20 77 61 6e 7.2) but you wan
0da0: 74 20 79 6f 75 72 20 63 6f 64 65 20 74 6f 20 77 t your code to w
0db0: 6f 72 6b 0a 2a 2a 20 6f 6e 20 61 6e 20 6f 6c 64 ork.** on an old
0dc0: 65 72 20 6d 61 63 68 69 6e 65 20 28 65 78 3a 20 er machine (ex:
0dd0: 52 65 64 48 61 74 20 36 2e 30 29 2e 20 20 49 66 RedHat 6.0). If
0de0: 20 79 6f 75 20 63 6f 6d 70 69 6c 65 20 6f 6e 20 you compile on
0df0: 52 65 64 48 61 74 20 37 2e 32 0a 2a 2a 20 77 69 RedHat 7.2.** wi
0e00: 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6f thout this optio
0e10: 6e 2c 20 4c 46 53 20 69 73 20 65 6e 61 62 6c 65 n, LFS is enable
0e20: 2e 20 20 42 75 74 20 4c 46 53 20 64 6f 65 73 20 . But LFS does
0e30: 6e 6f 74 20 65 78 69 73 74 20 69 6e 20 74 68 65 not exist in the
0e40: 20 6b 65 72 6e 65 6c 0a 2a 2a 20 69 6e 20 52 65 kernel.** in Re
0e50: 64 48 61 74 20 36 2e 30 2c 20 73 6f 20 74 68 65 dHat 6.0, so the
0e60: 20 63 6f 64 65 20 77 6f 6e 27 74 20 77 6f 72 6b code won't work
0e70: 2e 20 20 48 65 6e 63 65 2c 20 66 6f 72 20 6d 61 . Hence, for ma
0e80: 78 69 6d 75 6d 20 62 69 6e 61 72 79 0a 2a 2a 20 ximum binary.**
0e90: 70 6f 72 74 61 62 69 6c 69 74 79 20 79 6f 75 20 portability you
0ea0: 73 68 6f 75 6c 64 20 6f 6d 69 74 20 4c 46 53 2e should omit LFS.
0eb0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 72 65 76 69 .**.** The previ
0ec0: 6f 75 73 20 70 61 72 61 67 72 61 70 68 20 77 61 ous paragraph wa
0ed0: 73 20 77 72 69 74 74 65 6e 20 69 6e 20 32 30 30 s written in 200
0ee0: 35 2e 20 20 28 54 68 69 73 20 70 61 72 61 67 72 5. (This paragr
0ef0: 61 70 68 20 69 73 20 77 72 69 74 74 65 6e 0a 2a aph is written.*
0f00: 2a 20 6f 6e 20 32 30 30 38 2d 31 31 2d 32 38 2e * on 2008-11-28.
0f10: 29 20 54 68 65 73 65 20 64 61 79 73 2c 20 61 6c ) These days, al
0f20: 6c 20 4c 69 6e 75 78 20 6b 65 72 6e 65 6c 73 20 l Linux kernels
0f30: 73 75 70 70 6f 72 74 20 6c 61 72 67 65 20 66 69 support large fi
0f40: 6c 65 73 2c 20 73 6f 0a 2a 2a 20 79 6f 75 20 73 les, so.** you s
0f50: 68 6f 75 6c 64 20 70 72 6f 62 61 62 6c 79 20 6c hould probably l
0f60: 65 61 76 65 20 4c 46 53 20 65 6e 61 62 6c 65 64 eave LFS enabled
0f70: 2e 20 20 42 75 74 20 73 6f 6d 65 20 65 6d 62 65 . But some embe
0f80: 64 64 65 64 20 70 6c 61 74 66 6f 72 6d 73 20 6d dded platforms m
0f90: 69 67 68 74 0a 2a 2a 20 6c 61 63 6b 20 4c 46 53 ight.** lack LFS
0fa0: 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 in which case t
0fb0: 68 65 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c he SQLITE_DISABL
0fc0: 45 5f 4c 46 53 20 6d 61 63 72 6f 20 6d 69 67 68 E_LFS macro migh
0fd0: 74 20 73 74 69 6c 6c 20 62 65 20 75 73 65 66 75 t still be usefu
0fe0: 6c 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 l..*/.#ifndef SQ
0ff0: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 LITE_DISABLE_LFS
1000: 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45 .# define _LARGE
1010: 5f 46 49 4c 45 20 20 20 20 20 20 20 31 0a 23 20 _FILE 1.#
1020: 69 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f 46 46 ifndef _FILE_OFF
1030: 53 45 54 5f 42 49 54 53 0a 23 20 20 20 64 65 66 SET_BITS.# def
1040: 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54 ine _FILE_OFFSET
1050: 5f 42 49 54 53 20 36 34 0a 23 20 65 6e 64 69 66 _BITS 64.# endif
1060: 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45 .# define _LARGE
1070: 46 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a 23 65 FILE_SOURCE 1.#e
1080: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 73 74 61 6e ndif../*.** stan
1090: 64 61 72 64 20 69 6e 63 6c 75 64 65 20 66 69 6c dard include fil
10a0: 65 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 es..*/.#include
10b0: 3c 73 79 73 2f 74 79 70 65 73 2e 68 3e 0a 23 69 <sys/types.h>.#i
10c0: 6e 63 6c 75 64 65 20 3c 73 79 73 2f 73 74 61 74 nclude <sys/stat
10d0: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 66 63 .h>.#include <fc
10e0: 6e 74 6c 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 ntl.h>.#include
10f0: 3c 75 6e 69 73 74 64 2e 68 3e 0a 23 69 6e 63 6c <unistd.h>.#incl
1100: 75 64 65 20 3c 74 69 6d 65 2e 68 3e 0a 23 69 6e ude <time.h>.#in
1110: 63 6c 75 64 65 20 3c 73 79 73 2f 74 69 6d 65 2e clude <sys/time.
1120: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 65 72 72 h>.#include <err
1130: 6e 6f 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c no.h>.#include <
1140: 73 79 73 2f 6d 6d 61 6e 2e 68 3e 0a 0a 23 69 66 sys/mman.h>..#if
1150: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
1160: 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 23 20 69 OCKING_STYLE.# i
1170: 6e 63 6c 75 64 65 20 3c 73 79 73 2f 69 6f 63 74 nclude <sys/ioct
1180: 6c 2e 68 3e 0a 23 20 69 66 20 4f 53 5f 56 58 57 l.h>.# if OS_VXW
1190: 4f 52 4b 53 0a 23 20 20 69 6e 63 6c 75 64 65 20 ORKS.# include
11a0: 3c 73 65 6d 61 70 68 6f 72 65 2e 68 3e 0a 23 20 <semaphore.h>.#
11b0: 20 69 6e 63 6c 75 64 65 20 3c 6c 69 6d 69 74 73 include <limits
11c0: 2e 68 3e 0a 23 20 65 6c 73 65 0a 23 20 20 69 6e .h>.# else.# in
11d0: 63 6c 75 64 65 20 3c 73 79 73 2f 66 69 6c 65 2e clude <sys/file.
11e0: 68 3e 0a 23 20 20 69 6e 63 6c 75 64 65 20 3c 73 h>.# include <s
11f0: 79 73 2f 70 61 72 61 6d 2e 68 3e 0a 23 20 65 6e ys/param.h>.# en
1200: 64 69 66 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 dif.#endif /* SQ
1210: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b LITE_ENABLE_LOCK
1220: 49 4e 47 5f 53 54 59 4c 45 20 2a 2f 0a 0a 23 69 ING_STYLE */..#i
1230: 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c f defined(__APPL
1240: 45 5f 5f 29 20 7c 7c 20 28 53 51 4c 49 54 45 5f E__) || (SQLITE_
1250: 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
1260: 54 59 4c 45 20 26 26 20 21 4f 53 5f 56 58 57 4f TYLE && !OS_VXWO
1270: 52 4b 53 29 0a 23 20 69 6e 63 6c 75 64 65 20 3c RKS).# include <
1280: 73 79 73 2f 6d 6f 75 6e 74 2e 68 3e 0a 23 65 6e sys/mount.h>.#en
1290: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 dif../*.** Allow
12a0: 65 64 20 76 61 6c 75 65 73 20 6f 66 20 75 6e 69 ed values of uni
12b0: 78 46 69 6c 65 2e 66 73 46 6c 61 67 73 0a 2a 2f xFile.fsFlags.*/
12c0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
12d0: 46 53 46 4c 41 47 53 5f 49 53 5f 4d 53 44 4f 53 FSFLAGS_IS_MSDOS
12e0: 20 20 20 20 20 30 78 31 0a 0a 2f 2a 0a 2a 2a 20 0x1../*.**
12f0: 49 66 20 77 65 20 61 72 65 20 74 6f 20 62 65 20 If we are to be
1300: 74 68 72 65 61 64 2d 73 61 66 65 2c 20 69 6e 63 thread-safe, inc
1310: 6c 75 64 65 20 74 68 65 20 70 74 68 72 65 61 64 lude the pthread
1320: 73 20 68 65 61 64 65 72 20 61 6e 64 20 64 65 66 s header and def
1330: 69 6e 65 0a 2a 2a 20 74 68 65 20 53 51 4c 49 54 ine.** the SQLIT
1340: 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 20 6d E_UNIX_THREADS m
1350: 61 63 72 6f 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c acro..*/.#if SQL
1360: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 23 ITE_THREADSAFE.#
1370: 20 69 6e 63 6c 75 64 65 20 3c 70 74 68 72 65 61 include <pthrea
1380: 64 2e 68 3e 0a 23 20 64 65 66 69 6e 65 20 53 51 d.h>.# define SQ
1390: 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 LITE_UNIX_THREAD
13a0: 53 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a S 1.#endif../*.*
13b0: 2a 20 44 65 66 61 75 6c 74 20 70 65 72 6d 69 73 * Default permis
13c0: 73 69 6f 6e 73 20 77 68 65 6e 20 63 72 65 61 74 sions when creat
13d0: 69 6e 67 20 61 20 6e 65 77 20 66 69 6c 65 0a 2a ing a new file.*
13e0: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
13f0: 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 _DEFAULT_FILE_PE
1400: 52 4d 49 53 53 49 4f 4e 53 0a 23 20 64 65 66 69 RMISSIONS.# defi
1410: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
1420: 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f T_FILE_PERMISSIO
1430: 4e 53 20 30 36 34 34 0a 23 65 6e 64 69 66 0a 0a NS 0644.#endif..
1440: 2f 2a 0a 20 2a 2a 20 44 65 66 61 75 6c 74 20 70 /*. ** Default p
1450: 65 72 6d 69 73 73 69 6f 6e 73 20 77 68 65 6e 20 ermissions when
1460: 63 72 65 61 74 69 6e 67 20 61 75 74 6f 20 70 72 creating auto pr
1470: 6f 78 79 20 64 69 72 0a 20 2a 2f 0a 23 69 66 6e oxy dir. */.#ifn
1480: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 def SQLITE_DEFAU
1490: 4c 54 5f 50 52 4f 58 59 44 49 52 5f 50 45 52 4d LT_PROXYDIR_PERM
14a0: 49 53 53 49 4f 4e 53 0a 23 20 64 65 66 69 6e 65 ISSIONS.# define
14b0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
14c0: 50 52 4f 58 59 44 49 52 5f 50 45 52 4d 49 53 53 PROXYDIR_PERMISS
14d0: 49 4f 4e 53 20 30 37 35 35 0a 23 65 6e 64 69 66 IONS 0755.#endif
14e0: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 78 69 6d 75 6d 20 ../*.** Maximum
14f0: 73 75 70 70 6f 72 74 65 64 20 70 61 74 68 2d 6c supported path-l
1500: 65 6e 67 74 68 2e 0a 2a 2f 0a 23 64 65 66 69 6e ength..*/.#defin
1510: 65 20 4d 41 58 5f 50 41 54 48 4e 41 4d 45 20 35 e MAX_PATHNAME 5
1520: 31 32 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 6c 79 20 73 12../*.** Only s
1530: 65 74 20 74 68 65 20 6c 61 73 74 45 72 72 6e 6f et the lastErrno
1540: 20 69 66 20 74 68 65 20 65 72 72 6f 72 20 63 6f if the error co
1550: 64 65 20 69 73 20 61 20 72 65 61 6c 20 65 72 72 de is a real err
1560: 6f 72 20 61 6e 64 20 6e 6f 74 20 0a 2a 2a 20 61 or and not .** a
1570: 20 6e 6f 72 6d 61 6c 20 65 78 70 65 63 74 65 64 normal expected
1580: 20 72 65 74 75 72 6e 20 63 6f 64 65 20 6f 66 20 return code of
1590: 53 51 4c 49 54 45 5f 42 55 53 59 20 6f 72 20 53 SQLITE_BUSY or S
15a0: 51 4c 49 54 45 5f 4f 4b 0a 2a 2f 0a 23 64 65 66 QLITE_OK.*/.#def
15b0: 69 6e 65 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f ine IS_LOCK_ERRO
15c0: 52 28 78 29 20 20 28 28 78 20 21 3d 20 53 51 4c R(x) ((x != SQL
15d0: 49 54 45 5f 4f 4b 29 20 26 26 20 28 78 20 21 3d ITE_OK) && (x !=
15e0: 20 53 51 4c 49 54 45 5f 42 55 53 59 29 29 0a 0a SQLITE_BUSY))..
15f0: 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 /* Forward refer
1600: 65 6e 63 65 73 20 2a 2f 0a 74 79 70 65 64 65 66 ences */.typedef
1610: 20 73 74 72 75 63 74 20 75 6e 69 78 53 68 6d 20 struct unixShm
1620: 75 6e 69 78 53 68 6d 3b 20 20 20 20 20 20 20 20 unixShm;
1630: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 /* Connec
1640: 74 69 6f 6e 20 73 68 61 72 65 64 20 6d 65 6d 6f tion shared memo
1650: 72 79 20 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 ry */.typedef st
1660: 72 75 63 74 20 75 6e 69 78 53 68 6d 4e 6f 64 65 ruct unixShmNode
1670: 20 75 6e 69 78 53 68 6d 4e 6f 64 65 3b 20 20 20 unixShmNode;
1680: 20 20 20 20 2f 2a 20 53 68 61 72 65 64 20 6d 65 /* Shared me
1690: 6d 6f 72 79 20 69 6e 73 74 61 6e 63 65 20 2a 2f mory instance */
16a0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
16b0: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 75 6e unixInodeInfo un
16c0: 69 78 49 6e 6f 64 65 49 6e 66 6f 3b 20 20 20 2f ixInodeInfo; /
16d0: 2a 20 41 6e 20 69 2d 6e 6f 64 65 20 2a 2f 0a 74 * An i-node */.t
16e0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 55 6e ypedef struct Un
16f0: 69 78 55 6e 75 73 65 64 46 64 20 55 6e 69 78 55 ixUnusedFd UnixU
1700: 6e 75 73 65 64 46 64 3b 20 20 20 20 20 2f 2a 20 nusedFd; /*
1710: 41 6e 20 75 6e 75 73 65 64 20 66 69 6c 65 20 64 An unused file d
1720: 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a 0a 2f 2a escriptor */../*
1730: 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 2c 20 61 .** Sometimes, a
1740: 66 74 65 72 20 61 20 66 69 6c 65 20 68 61 6e 64 fter a file hand
1750: 6c 65 20 69 73 20 63 6c 6f 73 65 64 20 62 79 20 le is closed by
1760: 53 51 4c 69 74 65 2c 20 74 68 65 20 66 69 6c 65 SQLite, the file
1770: 20 64 65 73 63 72 69 70 74 6f 72 0a 2a 2a 20 63 descriptor.** c
1780: 61 6e 6e 6f 74 20 62 65 20 63 6c 6f 73 65 64 20 annot be closed
1790: 69 6d 6d 65 64 69 61 74 65 6c 79 2e 20 49 6e 20 immediately. In
17a0: 74 68 65 73 65 20 63 61 73 65 73 2c 20 69 6e 73 these cases, ins
17b0: 74 61 6e 63 65 73 20 6f 66 20 74 68 65 20 66 6f tances of the fo
17c0: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 72 75 63 llowing.** struc
17d0: 74 75 72 65 20 61 72 65 20 75 73 65 64 20 74 6f ture are used to
17e0: 20 73 74 6f 72 65 20 74 68 65 20 66 69 6c 65 20 store the file
17f0: 64 65 73 63 72 69 70 74 6f 72 20 77 68 69 6c 65 descriptor while
1800: 20 77 61 69 74 69 6e 67 20 66 6f 72 20 61 6e 0a waiting for an.
1810: 2a 2a 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 ** opportunity t
1820: 6f 20 65 69 74 68 65 72 20 63 6c 6f 73 65 20 6f o either close o
1830: 72 20 72 65 75 73 65 20 69 74 2e 0a 2a 2f 0a 73 r reuse it..*/.s
1840: 74 72 75 63 74 20 55 6e 69 78 55 6e 75 73 65 64 truct UnixUnused
1850: 46 64 20 7b 0a 20 20 69 6e 74 20 66 64 3b 20 20 Fd {. int fd;
1860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1870: 20 2f 2a 20 46 69 6c 65 20 64 65 73 63 72 69 70 /* File descrip
1880: 74 6f 72 20 74 6f 20 63 6c 6f 73 65 20 2a 2f 0a tor to close */.
1890: 20 20 69 6e 74 20 66 6c 61 67 73 3b 20 20 20 20 int flags;
18a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
18b0: 6c 61 67 73 20 74 68 69 73 20 66 69 6c 65 20 64 lags this file d
18c0: 65 73 63 72 69 70 74 6f 72 20 77 61 73 20 6f 70 escriptor was op
18d0: 65 6e 65 64 20 77 69 74 68 20 2a 2f 0a 20 20 55 ened with */. U
18e0: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 4e 65 nixUnusedFd *pNe
18f0: 78 74 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 xt; /* Next
1900: 20 75 6e 75 73 65 64 20 66 69 6c 65 20 64 65 73 unused file des
1910: 63 72 69 70 74 6f 72 20 6f 6e 20 73 61 6d 65 20 criptor on same
1920: 66 69 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a file */.};../*.*
1930: 2a 20 54 68 65 20 75 6e 69 78 46 69 6c 65 20 73 * The unixFile s
1940: 74 72 75 63 74 75 72 65 20 69 73 20 73 75 62 63 tructure is subc
1950: 6c 61 73 73 20 6f 66 20 73 71 6c 69 74 65 33 5f lass of sqlite3_
1960: 66 69 6c 65 20 73 70 65 63 69 66 69 63 20 74 6f file specific to
1970: 20 74 68 65 20 75 6e 69 78 0a 2a 2a 20 56 46 53 the unix.** VFS
1980: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
1990: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 ..*/.typedef str
19a0: 75 63 74 20 75 6e 69 78 46 69 6c 65 20 75 6e 69 uct unixFile uni
19b0: 78 46 69 6c 65 3b 0a 73 74 72 75 63 74 20 75 6e xFile;.struct un
19c0: 69 78 46 69 6c 65 20 7b 0a 20 20 73 71 6c 69 74 ixFile {. sqlit
19d0: 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 63 6f e3_io_methods co
19e0: 6e 73 74 20 2a 70 4d 65 74 68 6f 64 3b 20 20 2f nst *pMethod; /
19f0: 2a 20 41 6c 77 61 79 73 20 74 68 65 20 66 69 72 * Always the fir
1a00: 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 75 6e st entry */. un
1a10: 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e ixInodeInfo *pIn
1a20: 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ode;
1a30: 20 20 2f 2a 20 49 6e 66 6f 20 61 62 6f 75 74 20 /* Info about
1a40: 6c 6f 63 6b 73 20 6f 6e 20 74 68 69 73 20 69 6e locks on this in
1a50: 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68 3b 20 ode */. int h;
1a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1a80: 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 The file descrip
1a90: 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 64 69 72 tor */. int dir
1aa0: 66 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 fd;
1ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ac0: 46 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 File descriptor
1ad0: 66 6f 72 20 74 68 65 20 64 69 72 65 63 74 6f 72 for the director
1ae0: 79 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 y */. unsigned
1af0: 63 68 61 72 20 65 46 69 6c 65 4c 6f 63 6b 3b 20 char eFileLock;
1b00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
1b10: 65 20 74 79 70 65 20 6f 66 20 6c 6f 63 6b 20 68 e type of lock h
1b20: 65 6c 64 20 6f 6e 20 74 68 69 73 20 66 64 20 2a eld on this fd *
1b30: 2f 0a 20 20 69 6e 74 20 6c 61 73 74 45 72 72 6e /. int lastErrn
1b40: 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o;
1b50: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 75 /* The u
1b60: 6e 69 78 20 65 72 72 6e 6f 20 66 72 6f 6d 20 6c nix errno from l
1b70: 61 73 74 20 49 2f 4f 20 65 72 72 6f 72 20 2a 2f ast I/O error */
1b80: 0a 20 20 76 6f 69 64 20 2a 6c 6f 63 6b 69 6e 67 . void *locking
1b90: 43 6f 6e 74 65 78 74 3b 20 20 20 20 20 20 20 20 Context;
1ba0: 20 20 20 20 20 20 20 2f 2a 20 4c 6f 63 6b 69 6e /* Lockin
1bb0: 67 20 73 74 79 6c 65 20 73 70 65 63 69 66 69 63 g style specific
1bc0: 20 73 74 61 74 65 20 2a 2f 0a 20 20 55 6e 69 78 state */. Unix
1bd0: 55 6e 75 73 65 64 46 64 20 2a 70 55 6e 75 73 65 UnusedFd *pUnuse
1be0: 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d;
1bf0: 2f 2a 20 50 72 65 2d 61 6c 6c 6f 63 61 74 65 64 /* Pre-allocated
1c00: 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 2f UnixUnusedFd */
1c10: 0a 20 20 69 6e 74 20 66 69 6c 65 46 6c 61 67 73 . int fileFlags
1c20: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1c30: 20 20 20 20 20 20 20 2f 2a 20 4d 69 73 63 65 6c /* Miscel
1c40: 6c 61 6e 6f 75 73 20 66 6c 61 67 73 20 2a 2f 0a lanous flags */.
1c50: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 const char *zP
1c60: 61 74 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 ath;
1c70: 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
1c80: 20 74 68 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 the file */. u
1c90: 6e 69 78 53 68 6d 20 2a 70 53 68 6d 3b 20 20 20 nixShm *pShm;
1ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cb0: 20 20 20 2f 2a 20 53 68 61 72 65 64 20 6d 65 6d /* Shared mem
1cc0: 6f 72 79 20 73 65 67 6d 65 6e 74 20 69 6e 66 6f ory segment info
1cd0: 72 6d 61 74 69 6f 6e 20 2a 2f 0a 23 69 66 20 53 rmation */.#if S
1ce0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 QLITE_ENABLE_LOC
1cf0: 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 69 6e 74 KING_STYLE. int
1d00: 20 6f 70 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 openFlags;
1d10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d20: 20 2f 2a 20 54 68 65 20 66 6c 61 67 73 20 73 70 /* The flags sp
1d30: 65 63 69 66 69 65 64 20 61 74 20 6f 70 65 6e 28 ecified at open(
1d40: 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 20 ) */.#endif.#if
1d50: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f SQLITE_ENABLE_LO
1d60: 43 4b 49 4e 47 5f 53 54 59 4c 45 20 7c 7c 20 64 CKING_STYLE || d
1d70: 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
1d80: 29 0a 20 20 75 6e 73 69 67 6e 65 64 20 66 73 46 ). unsigned fsF
1d90: 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 lags;
1da0: 20 20 20 20 20 20 20 20 2f 2a 20 63 61 63 68 65 /* cache
1db0: 64 20 64 65 74 61 69 6c 73 20 66 72 6f 6d 20 73 d details from s
1dc0: 74 61 74 66 73 28 29 20 2a 2f 0a 23 65 6e 64 69 tatfs() */.#endi
1dd0: 66 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 f.#if OS_VXWORKS
1de0: 0a 20 20 69 6e 74 20 69 73 44 65 6c 65 74 65 3b . int isDelete;
1df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e00: 20 20 20 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 /* Delete
1e10: 20 6f 6e 20 63 6c 6f 73 65 20 69 66 20 74 72 75 on close if tru
1e20: 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 76 78 e */. struct vx
1e30: 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70 49 64 worksFileId *pId
1e40: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 6e ; /* Un
1e50: 69 71 75 65 20 66 69 6c 65 20 49 44 20 2a 2f 0a ique file ID */.
1e60: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 4e #endif.#ifndef N
1e70: 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 6e DEBUG. /* The n
1e80: 65 78 74 20 67 72 6f 75 70 20 6f 66 20 76 61 72 ext group of var
1e90: 69 61 62 6c 65 73 20 61 72 65 20 75 73 65 64 20 iables are used
1ea0: 74 6f 20 74 72 61 63 6b 20 77 68 65 74 68 65 72 to track whether
1eb0: 20 6f 72 20 6e 6f 74 20 74 68 65 0a 20 20 2a 2a or not the. **
1ec0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 transaction cou
1ed0: 6e 74 65 72 20 69 6e 20 62 79 74 65 73 20 32 34 nter in bytes 24
1ee0: 2d 32 37 20 6f 66 20 64 61 74 61 62 61 73 65 20 -27 of database
1ef0: 66 69 6c 65 73 20 61 72 65 20 75 70 64 61 74 65 files are update
1f00: 64 0a 20 20 2a 2a 20 77 68 65 6e 65 76 65 72 20 d. ** whenever
1f10: 61 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 any part of the
1f20: 64 61 74 61 62 61 73 65 20 63 68 61 6e 67 65 73 database changes
1f30: 2e 20 20 41 6e 20 61 73 73 65 72 74 69 6f 6e 20 . An assertion
1f40: 66 61 75 6c 74 20 77 69 6c 6c 0a 20 20 2a 2a 20 fault will. **
1f50: 6f 63 63 75 72 20 69 66 20 61 20 66 69 6c 65 20 occur if a file
1f60: 69 73 20 75 70 64 61 74 65 64 20 77 69 74 68 6f is updated witho
1f70: 75 74 20 61 6c 73 6f 20 75 70 64 61 74 69 6e 67 ut also updating
1f80: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
1f90: 0a 20 20 2a 2a 20 63 6f 75 6e 74 65 72 2e 20 20 . ** counter.
1fa0: 54 68 69 73 20 74 65 73 74 20 69 73 20 6d 61 64 This test is mad
1fb0: 65 20 74 6f 20 61 76 6f 69 64 20 6e 65 77 20 70 e to avoid new p
1fc0: 72 6f 62 6c 65 6d 73 20 73 69 6d 69 6c 61 72 20 roblems similar
1fd0: 74 6f 20 74 68 65 0a 20 20 2a 2a 20 6f 6e 65 20 to the. ** one
1fe0: 64 65 73 63 72 69 62 65 64 20 62 79 20 74 69 63 described by tic
1ff0: 6b 65 74 20 23 33 35 38 34 2e 20 0a 20 20 2a 2f ket #3584. . */
2000: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
2010: 20 74 72 61 6e 73 43 6e 74 72 43 68 6e 67 3b 20 transCntrChng;
2020: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 /* True if the
2030: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 transaction cou
2040: 6e 74 65 72 20 63 68 61 6e 67 65 64 20 2a 2f 0a nter changed */.
2050: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
2060: 64 62 55 70 64 61 74 65 3b 20 20 20 20 20 20 20 dbUpdate;
2070: 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6e 79 20 /* True if any
2080: 70 61 72 74 20 6f 66 20 64 61 74 61 62 61 73 65 part of database
2090: 20 66 69 6c 65 20 63 68 61 6e 67 65 64 20 2a 2f file changed */
20a0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
20b0: 20 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 65 3b 20 inNormalWrite;
20c0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 6e 20 /* True if in
20d0: 61 20 6e 6f 72 6d 61 6c 20 77 72 69 74 65 20 6f a normal write o
20e0: 70 65 72 61 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 peration */.#end
20f0: 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 if.#ifdef SQLITE
2100: 5f 54 45 53 54 0a 20 20 2f 2a 20 49 6e 20 74 65 _TEST. /* In te
2110: 73 74 20 6d 6f 64 65 2c 20 69 6e 63 72 65 61 73 st mode, increas
2120: 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 e the size of th
2130: 69 73 20 73 74 72 75 63 74 75 72 65 20 61 20 62 is structure a b
2140: 69 74 20 73 6f 20 74 68 61 74 20 0a 20 20 2a 2a it so that . **
2150: 20 69 74 20 69 73 20 6c 61 72 67 65 72 20 74 68 it is larger th
2160: 61 6e 20 74 68 65 20 73 74 72 75 63 74 20 43 72 an the struct Cr
2170: 61 73 68 46 69 6c 65 20 64 65 66 69 6e 65 64 20 ashFile defined
2180: 69 6e 20 74 65 73 74 36 2e 63 2e 0a 20 20 2a 2f in test6.c.. */
2190: 0a 20 20 63 68 61 72 20 61 50 61 64 64 69 6e 67 . char aPadding
21a0: 5b 33 32 5d 3b 0a 23 65 6e 64 69 66 0a 7d 3b 0a [32];.#endif.};.
21b0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
21c0: 77 69 6e 67 20 6d 61 63 72 6f 73 20 64 65 66 69 wing macros defi
21d0: 6e 65 20 62 69 74 73 20 69 6e 20 75 6e 69 78 46 ne bits in unixF
21e0: 69 6c 65 2e 66 69 6c 65 46 6c 61 67 73 0a 2a 2f ile.fileFlags.*/
21f0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
2200: 57 48 4f 4c 45 5f 46 49 4c 45 5f 4c 4f 43 4b 49 WHOLE_FILE_LOCKI
2210: 4e 47 20 20 30 78 30 30 30 31 20 20 20 2f 2a 20 NG 0x0001 /*
2220: 55 73 65 20 77 68 6f 6c 65 2d 66 69 6c 65 20 6c Use whole-file l
2230: 6f 63 6b 69 6e 67 20 2a 2f 0a 0a 2f 2a 0a 2a 2a ocking */../*.**
2240: 20 49 6e 63 6c 75 64 65 20 63 6f 64 65 20 74 68 Include code th
2250: 61 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 at is common to
2260: 61 6c 6c 20 6f 73 5f 2a 2e 63 20 66 69 6c 65 73 all os_*.c files
2270: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 .*/.#include "os
2280: 5f 63 6f 6d 6d 6f 6e 2e 68 22 0a 0a 2f 2a 0a 2a _common.h"../*.*
2290: 2a 20 44 65 66 69 6e 65 20 76 61 72 69 6f 75 73 * Define various
22a0: 20 6d 61 63 72 6f 73 20 74 68 61 74 20 61 72 65 macros that are
22b0: 20 6d 69 73 73 69 6e 67 20 66 72 6f 6d 20 73 6f missing from so
22c0: 6d 65 20 73 79 73 74 65 6d 73 2e 0a 2a 2f 0a 23 me systems..*/.#
22d0: 69 66 6e 64 65 66 20 4f 5f 4c 41 52 47 45 46 49 ifndef O_LARGEFI
22e0: 4c 45 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4c 41 LE.# define O_LA
22f0: 52 47 45 46 49 4c 45 20 30 0a 23 65 6e 64 69 66 RGEFILE 0.#endif
2300: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
2310: 49 53 41 42 4c 45 5f 4c 46 53 0a 23 20 75 6e 64 ISABLE_LFS.# und
2320: 65 66 20 4f 5f 4c 41 52 47 45 46 49 4c 45 0a 23 ef O_LARGEFILE.#
2330: 20 64 65 66 69 6e 65 20 4f 5f 4c 41 52 47 45 46 define O_LARGEF
2340: 49 4c 45 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 ILE 0.#endif.#if
2350: 6e 64 65 66 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 0a ndef O_NOFOLLOW.
2360: 23 20 64 65 66 69 6e 65 20 4f 5f 4e 4f 46 4f 4c # define O_NOFOL
2370: 4c 4f 57 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 LOW 0.#endif.#if
2380: 6e 64 65 66 20 4f 5f 42 49 4e 41 52 59 0a 23 20 ndef O_BINARY.#
2390: 64 65 66 69 6e 65 20 4f 5f 42 49 4e 41 52 59 20 define O_BINARY
23a0: 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 0.#endif../*.**
23b0: 54 68 65 20 44 4a 47 50 50 20 63 6f 6d 70 69 6c The DJGPP compil
23c0: 65 72 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 6c er environment l
23d0: 6f 6f 6b 73 20 6d 6f 73 74 6c 79 20 6c 69 6b 65 ooks mostly like
23e0: 20 55 6e 69 78 2c 20 62 75 74 20 69 74 0a 2a 2a Unix, but it.**
23f0: 20 6c 61 63 6b 73 20 74 68 65 20 66 63 6e 74 6c lacks the fcntl
2400: 28 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 20 () system call.
2410: 20 53 6f 20 72 65 64 65 66 69 6e 65 20 66 63 6e So redefine fcn
2420: 74 6c 28 29 20 74 6f 20 62 65 20 73 6f 6d 65 74 tl() to be somet
2430: 68 69 6e 67 0a 2a 2a 20 74 68 61 74 20 61 6c 77 hing.** that alw
2440: 61 79 73 20 73 75 63 63 65 65 64 73 2e 20 20 54 ays succeeds. T
2450: 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 6c his means that l
2460: 6f 63 6b 69 6e 67 20 64 6f 65 73 20 6e 6f 74 20 ocking does not
2470: 6f 63 63 75 72 20 75 6e 64 65 72 0a 2a 2a 20 44 occur under.** D
2480: 4a 47 50 50 2e 20 20 42 75 74 20 69 74 20 69 73 JGPP. But it is
2490: 20 44 4f 53 20 2d 20 77 68 61 74 20 64 69 64 20 DOS - what did
24a0: 79 6f 75 20 65 78 70 65 63 74 3f 0a 2a 2f 0a 23 you expect?.*/.#
24b0: 69 66 64 65 66 20 5f 5f 44 4a 47 50 50 5f 5f 0a ifdef __DJGPP__.
24c0: 23 20 64 65 66 69 6e 65 20 66 63 6e 74 6c 28 41 # define fcntl(A
24d0: 2c 42 2c 43 29 20 30 0a 23 65 6e 64 69 66 0a 0a ,B,C) 0.#endif..
24e0: 2f 2a 0a 2a 2a 20 54 68 65 20 74 68 72 65 61 64 /*.** The thread
24f0: 69 64 20 6d 61 63 72 6f 20 72 65 73 6f 6c 76 65 id macro resolve
2500: 73 20 74 6f 20 74 68 65 20 74 68 72 65 61 64 2d s to the thread-
2510: 69 64 20 6f 72 20 74 6f 20 30 2e 20 20 55 73 65 id or to 0. Use
2520: 64 20 66 6f 72 0a 2a 2a 20 74 65 73 74 69 6e 67 d for.** testing
2530: 20 61 6e 64 20 64 65 62 75 67 67 69 6e 67 20 6f and debugging o
2540: 6e 6c 79 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 nly..*/.#if SQLI
2550: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 23 64 TE_THREADSAFE.#d
2560: 65 66 69 6e 65 20 74 68 72 65 61 64 69 64 20 70 efine threadid p
2570: 74 68 72 65 61 64 5f 73 65 6c 66 28 29 0a 23 65 thread_self().#e
2580: 6c 73 65 0a 23 64 65 66 69 6e 65 20 74 68 72 65 lse.#define thre
2590: 61 64 69 64 20 30 0a 23 65 6e 64 69 66 0a 0a 0a adid 0.#endif...
25a0: 2f 2a 0a 2a 2a 20 48 65 6c 70 65 72 20 66 75 6e /*.** Helper fun
25b0: 63 74 69 6f 6e 73 20 74 6f 20 6f 62 74 61 69 6e ctions to obtain
25c0: 20 61 6e 64 20 72 65 6c 69 6e 71 75 69 73 68 20 and relinquish
25d0: 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 74 65 78 the global mutex
25e0: 2e 20 54 68 65 0a 2a 2a 20 67 6c 6f 62 61 6c 20 . The.** global
25f0: 6d 75 74 65 78 20 69 73 20 75 73 65 64 20 74 6f mutex is used to
2600: 20 70 72 6f 74 65 63 74 20 74 68 65 20 75 6e 69 protect the uni
2610: 78 49 6e 6f 64 65 49 6e 66 6f 20 61 6e 64 0a 2a xInodeInfo and.*
2620: 2a 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 * vxworksFileId
2630: 6f 62 6a 65 63 74 73 20 75 73 65 64 20 62 79 20 objects used by
2640: 74 68 69 73 20 66 69 6c 65 2c 20 61 6c 6c 20 6f this file, all o
2650: 66 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 0a f which may be .
2660: 2a 2a 20 73 68 61 72 65 64 20 62 79 20 6d 75 6c ** shared by mul
2670: 74 69 70 6c 65 20 74 68 72 65 61 64 73 2e 0a 2a tiple threads..*
2680: 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 75 6e *.** Function un
2690: 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 69 73 ixMutexHeld() is
26a0: 20 75 73 65 64 20 74 6f 20 61 73 73 65 72 74 28 used to assert(
26b0: 29 20 74 68 61 74 20 74 68 65 20 67 6c 6f 62 61 ) that the globa
26c0: 6c 20 6d 75 74 65 78 20 0a 2a 2a 20 69 73 20 68 l mutex .** is h
26d0: 65 6c 64 20 77 68 65 6e 20 72 65 71 75 69 72 65 eld when require
26e0: 64 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e d. This function
26f0: 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 61 73 is only used as
2700: 20 70 61 72 74 20 6f 66 20 61 73 73 65 72 74 28 part of assert(
2710: 29 20 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 ) .** statements
2720: 2e 20 65 2e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 75 . e.g..**.** u
2730: 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 0a nixEnterMutex().
2740: 2a 2a 20 20 20 20 20 61 73 73 65 72 74 28 20 75 ** assert( u
2750: 6e 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 29 nixMutexHeld() )
2760: 3b 0a 2a 2a 20 20 20 75 6e 69 78 45 6e 74 65 72 ;.** unixEnter
2770: 4c 65 61 76 65 28 29 0a 2a 2f 0a 73 74 61 74 69 Leave().*/.stati
2780: 63 20 76 6f 69 64 20 75 6e 69 78 45 6e 74 65 72 c void unixEnter
2790: 4d 75 74 65 78 28 76 6f 69 64 29 7b 0a 20 20 73 Mutex(void){. s
27a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 qlite3_mutex_ent
27b0: 65 72 28 73 71 6c 69 74 65 33 4d 75 74 65 78 41 er(sqlite3MutexA
27c0: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
27d0: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 X_STATIC_MASTER)
27e0: 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 );.}.static void
27f0: 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
2800: 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 74 65 33 void){. sqlite3
2810: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c _mutex_leave(sql
2820: 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 ite3MutexAlloc(S
2830: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
2840: 49 43 5f 4d 41 53 54 45 52 29 29 3b 0a 7d 0a 23 IC_MASTER));.}.#
2850: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
2860: 55 47 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e UG.static int un
2870: 69 78 4d 75 74 65 78 48 65 6c 64 28 76 6f 69 64 ixMutexHeld(void
2880: 29 20 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c ) {. return sql
2890: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
28a0: 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
28b0: 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
28c0: 54 41 54 49 43 5f 4d 41 53 54 45 52 29 29 3b 0a TATIC_MASTER));.
28d0: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 64 65 }.#endif...#ifde
28e0: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f f SQLITE_DEBUG./
28f0: 2a 0a 2a 2a 20 48 65 6c 70 65 72 20 66 75 6e 63 *.** Helper func
2900: 74 69 6f 6e 20 66 6f 72 20 70 72 69 6e 74 69 6e tion for printin
2910: 67 20 6f 75 74 20 74 72 61 63 65 20 69 6e 66 6f g out trace info
2920: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 64 65 62 rmation from deb
2930: 75 67 67 69 6e 67 0a 2a 2a 20 62 69 6e 61 72 69 ugging.** binari
2940: 65 73 2e 20 54 68 69 73 20 72 65 74 75 72 6e 73 es. This returns
2950: 20 74 68 65 20 73 74 72 69 6e 67 20 72 65 70 72 the string repr
2960: 65 73 65 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 esetation of the
2970: 20 73 75 70 70 6c 69 65 64 0a 2a 2a 20 69 6e 74 supplied.** int
2980: 65 67 65 72 20 6c 6f 63 6b 2d 74 79 70 65 2e 0a eger lock-type..
2990: 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 */.static const
29a0: 63 68 61 72 20 2a 61 7a 46 69 6c 65 4c 6f 63 6b char *azFileLock
29b0: 28 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 7b (int eFileLock){
29c0: 0a 20 20 73 77 69 74 63 68 28 20 65 46 69 6c 65 . switch( eFile
29d0: 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 63 61 73 65 Lock ){. case
29e0: 20 4e 4f 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e NO_LOCK: return
29f0: 20 22 4e 4f 4e 45 22 3b 0a 20 20 20 20 63 61 73 "NONE";. cas
2a00: 65 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3a 20 72 e SHARED_LOCK: r
2a10: 65 74 75 72 6e 20 22 53 48 41 52 45 44 22 3b 0a eturn "SHARED";.
2a20: 20 20 20 20 63 61 73 65 20 52 45 53 45 52 56 45 case RESERVE
2a30: 44 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 D_LOCK: return "
2a40: 52 45 53 45 52 56 45 44 22 3b 0a 20 20 20 20 63 RESERVED";. c
2a50: 61 73 65 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b ase PENDING_LOCK
2a60: 3a 20 72 65 74 75 72 6e 20 22 50 45 4e 44 49 4e : return "PENDIN
2a70: 47 22 3b 0a 20 20 20 20 63 61 73 65 20 45 58 43 G";. case EXC
2a80: 4c 55 53 49 56 45 5f 4c 4f 43 4b 3a 20 72 65 74 LUSIVE_LOCK: ret
2a90: 75 72 6e 20 22 45 58 43 4c 55 53 49 56 45 22 3b urn "EXCLUSIVE";
2aa0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 22 45 . }. return "E
2ab0: 52 52 4f 52 22 3b 0a 7d 0a 23 65 6e 64 69 66 0a RROR";.}.#endif.
2ac0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4c .#ifdef SQLITE_L
2ad0: 4f 43 4b 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 OCK_TRACE./*.**
2ae0: 50 72 69 6e 74 20 6f 75 74 20 69 6e 66 6f 72 6d Print out inform
2af0: 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 6c 6c 20 ation about all
2b00: 6c 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69 6f locking operatio
2b10: 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ns..**.** This r
2b20: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 66 outine is used f
2b30: 6f 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f 74 69 or troubleshooti
2b40: 6e 67 20 6c 6f 63 6b 73 20 6f 6e 20 6d 75 6c 74 ng locks on mult
2b50: 69 74 68 72 65 61 64 65 64 0a 2a 2a 20 70 6c 61 ithreaded.** pla
2b60: 74 66 6f 72 6d 73 2e 20 20 45 6e 61 62 6c 65 20 tforms. Enable
2b70: 62 79 20 63 6f 6d 70 69 6c 69 6e 67 20 77 69 74 by compiling wit
2b80: 68 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f 4c h the -DSQLITE_L
2b90: 4f 43 4b 5f 54 52 41 43 45 0a 2a 2a 20 63 6f 6d OCK_TRACE.** com
2ba0: 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e mand-line option
2bb0: 20 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 on the compiler
2bc0: 2e 20 20 54 68 69 73 20 63 6f 64 65 20 69 73 20 . This code is
2bd0: 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 74 75 72 6e normally.** turn
2be0: 65 64 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74 69 ed off..*/.stati
2bf0: 63 20 69 6e 74 20 6c 6f 63 6b 54 72 61 63 65 28 c int lockTrace(
2c00: 69 6e 74 20 66 64 2c 20 69 6e 74 20 6f 70 2c 20 int fd, int op,
2c10: 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 2a 70 29 struct flock *p)
2c20: 7b 0a 20 20 63 68 61 72 20 2a 7a 4f 70 4e 61 6d {. char *zOpNam
2c30: 65 2c 20 2a 7a 54 79 70 65 3b 0a 20 20 69 6e 74 e, *zType;. int
2c40: 20 73 3b 0a 20 20 69 6e 74 20 73 61 76 65 64 45 s;. int savedE
2c50: 72 72 6e 6f 3b 0a 20 20 69 66 28 20 6f 70 3d 3d rrno;. if( op==
2c60: 46 5f 47 45 54 4c 4b 20 29 7b 0a 20 20 20 20 7a F_GETLK ){. z
2c70: 4f 70 4e 61 6d 65 20 3d 20 22 47 45 54 4c 4b 22 OpName = "GETLK"
2c80: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 70 ;. }else if( op
2c90: 3d 3d 46 5f 53 45 54 4c 4b 20 29 7b 0a 20 20 20 ==F_SETLK ){.
2ca0: 20 7a 4f 70 4e 61 6d 65 20 3d 20 22 53 45 54 4c zOpName = "SETL
2cb0: 4b 22 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 K";. }else{.
2cc0: 20 73 20 3d 20 66 63 6e 74 6c 28 66 64 2c 20 6f s = fcntl(fd, o
2cd0: 70 2c 20 70 29 3b 0a 20 20 20 20 73 71 6c 69 74 p, p);. sqlit
2ce0: 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 66 e3DebugPrintf("f
2cf0: 63 6e 74 6c 20 75 6e 6b 6e 6f 77 6e 20 25 64 20 cntl unknown %d
2d00: 25 64 20 25 64 5c 6e 22 2c 20 66 64 2c 20 6f 70 %d %d\n", fd, op
2d10: 2c 20 73 29 3b 0a 20 20 20 20 72 65 74 75 72 6e , s);. return
2d20: 20 73 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d s;. }. if( p-
2d30: 3e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43 4b >l_type==F_RDLCK
2d40: 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d 20 ){. zType =
2d50: 22 52 44 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73 65 "RDLCK";. }else
2d60: 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70 65 3d 3d if( p->l_type==
2d70: 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 20 20 20 7a F_WRLCK ){. z
2d80: 54 79 70 65 20 3d 20 22 57 52 4c 43 4b 22 3b 0a Type = "WRLCK";.
2d90: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6c }else if( p->l
2da0: 5f 74 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29 _type==F_UNLCK )
2db0: 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d 20 22 55 {. zType = "U
2dc0: 4e 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73 65 7b 0a NLCK";. }else{.
2dd0: 20 20 20 20 61 73 73 65 72 74 28 20 30 20 29 3b assert( 0 );
2de0: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
2df0: 2d 3e 6c 5f 77 68 65 6e 63 65 3d 3d 53 45 45 4b ->l_whence==SEEK
2e00: 5f 53 45 54 20 29 3b 0a 20 20 73 20 3d 20 66 63 _SET );. s = fc
2e10: 6e 74 6c 28 66 64 2c 20 6f 70 2c 20 70 29 3b 0a ntl(fd, op, p);.
2e20: 20 20 73 61 76 65 64 45 72 72 6e 6f 20 3d 20 65 savedErrno = e
2e30: 72 72 6e 6f 3b 0a 20 20 73 71 6c 69 74 65 33 44 rrno;. sqlite3D
2e40: 65 62 75 67 50 72 69 6e 74 66 28 22 66 63 6e 74 ebugPrintf("fcnt
2e50: 6c 20 25 64 20 25 64 20 25 73 20 25 73 20 25 64 l %d %d %s %s %d
2e60: 20 25 64 20 25 64 20 25 64 5c 6e 22 2c 0a 20 20 %d %d %d\n",.
2e70: 20 20 20 74 68 72 65 61 64 69 64 2c 20 66 64 2c threadid, fd,
2e80: 20 7a 4f 70 4e 61 6d 65 2c 20 7a 54 79 70 65 2c zOpName, zType,
2e90: 20 28 69 6e 74 29 70 2d 3e 6c 5f 73 74 61 72 74 (int)p->l_start
2ea0: 2c 20 28 69 6e 74 29 70 2d 3e 6c 5f 6c 65 6e 2c , (int)p->l_len,
2eb0: 0a 20 20 20 20 20 28 69 6e 74 29 70 2d 3e 6c 5f . (int)p->l_
2ec0: 70 69 64 2c 20 73 29 3b 0a 20 20 69 66 28 20 73 pid, s);. if( s
2ed0: 3d 3d 28 2d 31 29 20 26 26 20 6f 70 3d 3d 46 5f ==(-1) && op==F_
2ee0: 53 45 54 4c 4b 20 26 26 20 28 70 2d 3e 6c 5f 74 SETLK && (p->l_t
2ef0: 79 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 7c 7c 20 ype==F_RDLCK ||
2f00: 70 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 57 52 4c p->l_type==F_WRL
2f10: 43 4b 29 20 29 7b 0a 20 20 20 20 73 74 72 75 63 CK) ){. struc
2f20: 74 20 66 6c 6f 63 6b 20 6c 32 3b 0a 20 20 20 20 t flock l2;.
2f30: 6c 32 20 3d 20 2a 70 3b 0a 20 20 20 20 66 63 6e l2 = *p;. fcn
2f40: 74 6c 28 66 64 2c 20 46 5f 47 45 54 4c 4b 2c 20 tl(fd, F_GETLK,
2f50: 26 6c 32 29 3b 0a 20 20 20 20 69 66 28 20 6c 32 &l2);. if( l2
2f60: 2e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43 4b .l_type==F_RDLCK
2f70: 20 29 7b 0a 20 20 20 20 20 20 7a 54 79 70 65 20 ){. zType
2f80: 3d 20 22 52 44 4c 43 4b 22 3b 0a 20 20 20 20 7d = "RDLCK";. }
2f90: 65 6c 73 65 20 69 66 28 20 6c 32 2e 6c 5f 74 79 else if( l2.l_ty
2fa0: 70 65 3d 3d 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 pe==F_WRLCK ){.
2fb0: 20 20 20 20 20 7a 54 79 70 65 20 3d 20 22 57 52 zType = "WR
2fc0: 4c 43 4b 22 3b 0a 20 20 20 20 7d 65 6c 73 65 20 LCK";. }else
2fd0: 69 66 28 20 6c 32 2e 6c 5f 74 79 70 65 3d 3d 46 if( l2.l_type==F
2fe0: 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20 20 20 _UNLCK ){.
2ff0: 7a 54 79 70 65 20 3d 20 22 55 4e 4c 43 4b 22 3b zType = "UNLCK";
3000: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
3010: 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a 20 assert( 0 );.
3020: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
3030: 44 65 62 75 67 50 72 69 6e 74 66 28 22 66 63 6e DebugPrintf("fcn
3040: 74 6c 2d 66 61 69 6c 75 72 65 2d 72 65 61 73 6f tl-failure-reaso
3050: 6e 3a 20 25 73 20 25 64 20 25 64 20 25 64 5c 6e n: %s %d %d %d\n
3060: 22 2c 0a 20 20 20 20 20 20 20 7a 54 79 70 65 2c ",. zType,
3070: 20 28 69 6e 74 29 6c 32 2e 6c 5f 73 74 61 72 74 (int)l2.l_start
3080: 2c 20 28 69 6e 74 29 6c 32 2e 6c 5f 6c 65 6e 2c , (int)l2.l_len,
3090: 20 28 69 6e 74 29 6c 32 2e 6c 5f 70 69 64 29 3b (int)l2.l_pid);
30a0: 0a 20 20 7d 0a 20 20 65 72 72 6e 6f 20 3d 20 73 . }. errno = s
30b0: 61 76 65 64 45 72 72 6e 6f 3b 0a 20 20 72 65 74 avedErrno;. ret
30c0: 75 72 6e 20 73 3b 0a 7d 0a 23 64 65 66 69 6e 65 urn s;.}.#define
30d0: 20 66 63 6e 74 6c 20 6c 6f 63 6b 54 72 61 63 65 fcntl lockTrace
30e0: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
30f0: 45 5f 4c 4f 43 4b 5f 54 52 41 43 45 20 2a 2f 0a E_LOCK_TRACE */.
3100: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f .../*.** This ro
3110: 75 74 69 6e 65 20 74 72 61 6e 73 6c 61 74 65 73 utine translates
3120: 20 61 20 73 74 61 6e 64 61 72 64 20 50 4f 53 49 a standard POSI
3130: 58 20 65 72 72 6e 6f 20 63 6f 64 65 20 69 6e 74 X errno code int
3140: 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 75 o something.** u
3150: 73 65 66 75 6c 20 74 6f 20 74 68 65 20 63 6c 69 seful to the cli
3160: 65 6e 74 73 20 6f 66 20 74 68 65 20 73 71 6c 69 ents of the sqli
3170: 74 65 33 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 te3 functions.
3180: 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 69 74 Specifically, it
3190: 20 69 73 0a 2a 2a 20 69 6e 74 65 6e 64 65 64 20 is.** intended
31a0: 74 6f 20 74 72 61 6e 73 6c 61 74 65 20 61 20 76 to translate a v
31b0: 61 72 69 65 74 79 20 6f 66 20 22 74 72 79 20 61 ariety of "try a
31c0: 67 61 69 6e 22 20 65 72 72 6f 72 73 20 69 6e 74 gain" errors int
31d0: 6f 20 53 51 4c 49 54 45 5f 42 55 53 59 0a 2a 2a o SQLITE_BUSY.**
31e0: 20 61 6e 64 20 61 20 76 61 72 69 65 74 79 20 6f and a variety o
31f0: 66 20 22 70 6c 65 61 73 65 20 63 6c 6f 73 65 20 f "please close
3200: 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 the file descrip
3210: 74 6f 72 20 4e 4f 57 22 20 65 72 72 6f 72 73 20 tor NOW" errors
3220: 69 6e 74 6f 20 0a 2a 2a 20 53 51 4c 49 54 45 5f into .** SQLITE_
3230: 49 4f 45 52 52 0a 2a 2a 20 0a 2a 2a 20 45 72 72 IOERR.** .** Err
3240: 6f 72 73 20 64 75 72 69 6e 67 20 69 6e 69 74 69 ors during initi
3250: 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 6c 6f 63 alization of loc
3260: 6b 73 2c 20 6f 72 20 66 69 6c 65 20 73 79 73 74 ks, or file syst
3270: 65 6d 20 73 75 70 70 6f 72 74 20 66 6f 72 20 6c em support for l
3280: 6f 63 6b 73 2c 0a 2a 2a 20 73 68 6f 75 6c 64 20 ocks,.** should
3290: 68 61 6e 64 6c 65 20 45 4e 4f 4c 43 4b 2c 20 45 handle ENOLCK, E
32a0: 4e 4f 54 53 55 50 2c 20 45 4f 50 4e 4f 54 53 55 NOTSUP, EOPNOTSU
32b0: 50 50 20 73 65 70 61 72 61 74 65 6c 79 2e 0a 2a PP separately..*
32c0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c /.static int sql
32d0: 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 iteErrorFromPosi
32e0: 78 45 72 72 6f 72 28 69 6e 74 20 70 6f 73 69 78 xError(int posix
32f0: 45 72 72 6f 72 2c 20 69 6e 74 20 73 71 6c 69 74 Error, int sqlit
3300: 65 49 4f 45 72 72 29 20 7b 0a 20 20 73 77 69 74 eIOErr) {. swit
3310: 63 68 20 28 70 6f 73 69 78 45 72 72 6f 72 29 20 ch (posixError)
3320: 7b 0a 20 20 63 61 73 65 20 30 3a 20 0a 20 20 20 {. case 0: .
3330: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
3340: 4b 3b 0a 20 20 20 20 0a 20 20 63 61 73 65 20 45 K;. . case E
3350: 41 47 41 49 4e 3a 0a 20 20 63 61 73 65 20 45 54 AGAIN:. case ET
3360: 49 4d 45 44 4f 55 54 3a 0a 20 20 63 61 73 65 20 IMEDOUT:. case
3370: 45 42 55 53 59 3a 0a 20 20 63 61 73 65 20 45 49 EBUSY:. case EI
3380: 4e 54 52 3a 0a 20 20 63 61 73 65 20 45 4e 4f 4c NTR:. case ENOL
3390: 43 4b 3a 20 20 0a 20 20 20 20 2f 2a 20 72 61 6e CK: . /* ran
33a0: 64 6f 6d 20 4e 46 53 20 72 65 74 72 79 20 65 72 dom NFS retry er
33b0: 72 6f 72 2c 20 75 6e 6c 65 73 73 20 64 75 72 69 ror, unless duri
33c0: 6e 67 20 66 69 6c 65 20 73 79 73 74 65 6d 20 73 ng file system s
33d0: 75 70 70 6f 72 74 20 0a 20 20 20 20 20 2a 20 69 upport . * i
33e0: 6e 74 72 6f 73 70 65 63 74 69 6f 6e 2c 20 69 6e ntrospection, in
33f0: 20 77 68 69 63 68 20 69 74 20 61 63 74 75 61 6c which it actual
3400: 6c 79 20 6d 65 61 6e 73 20 77 68 61 74 20 69 74 ly means what it
3410: 20 73 61 79 73 20 2a 2f 0a 20 20 20 20 72 65 74 says */. ret
3420: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b urn SQLITE_BUSY;
3430: 0a 20 20 20 20 0a 20 20 63 61 73 65 20 45 41 43 . . case EAC
3440: 43 45 53 3a 20 0a 20 20 20 20 2f 2a 20 45 41 43 CES: . /* EAC
3450: 43 45 53 20 69 73 20 6c 69 6b 65 20 45 41 47 41 CES is like EAGA
3460: 49 4e 20 64 75 72 69 6e 67 20 6c 6f 63 6b 69 6e IN during lockin
3470: 67 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 62 75 g operations, bu
3480: 74 20 6e 6f 74 20 61 6e 79 20 6f 74 68 65 72 20 t not any other
3490: 74 69 6d 65 2a 2f 0a 20 20 20 20 69 66 28 20 28 time*/. if( (
34a0: 73 71 6c 69 74 65 49 4f 45 72 72 20 3d 3d 20 53 sqliteIOErr == S
34b0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b QLITE_IOERR_LOCK
34c0: 29 20 7c 7c 20 0a 09 28 73 71 6c 69 74 65 49 4f ) || ..(sqliteIO
34d0: 45 72 72 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f Err == SQLITE_IO
34e0: 45 52 52 5f 55 4e 4c 4f 43 4b 29 20 7c 7c 20 0a ERR_UNLOCK) || .
34f0: 09 28 73 71 6c 69 74 65 49 4f 45 72 72 20 3d 3d .(sqliteIOErr ==
3500: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 SQLITE_IOERR_RD
3510: 4c 4f 43 4b 29 20 7c 7c 0a 09 28 73 71 6c 69 74 LOCK) ||..(sqlit
3520: 65 49 4f 45 72 72 20 3d 3d 20 53 51 4c 49 54 45 eIOErr == SQLITE
3530: 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 _IOERR_CHECKRESE
3540: 52 56 45 44 4c 4f 43 4b 29 20 29 7b 0a 20 20 20 RVEDLOCK) ){.
3550: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
3560: 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 _BUSY;. }.
3570: 20 2f 2a 20 65 6c 73 65 20 66 61 6c 6c 20 74 68 /* else fall th
3580: 72 6f 75 67 68 20 2a 2f 0a 20 20 63 61 73 65 20 rough */. case
3590: 45 50 45 52 4d 3a 20 0a 20 20 20 20 72 65 74 75 EPERM: . retu
35a0: 72 6e 20 53 51 4c 49 54 45 5f 50 45 52 4d 3b 0a rn SQLITE_PERM;.
35b0: 20 20 20 20 0a 20 20 63 61 73 65 20 45 44 45 41 . case EDEA
35c0: 44 4c 4b 3a 0a 20 20 20 20 72 65 74 75 72 6e 20 DLK:. return
35d0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 42 4c 4f SQLITE_IOERR_BLO
35e0: 43 4b 45 44 3b 0a 20 20 20 20 0a 23 69 66 20 45 CKED;. .#if E
35f0: 4f 50 4e 4f 54 53 55 50 50 21 3d 45 4e 4f 54 53 OPNOTSUPP!=ENOTS
3600: 55 50 0a 20 20 63 61 73 65 20 45 4f 50 4e 4f 54 UP. case EOPNOT
3610: 53 55 50 50 3a 20 0a 20 20 20 20 2f 2a 20 73 6f SUPP: . /* so
3620: 6d 65 74 68 69 6e 67 20 77 65 6e 74 20 74 65 72 mething went ter
3630: 72 69 62 6c 79 20 61 77 72 79 2c 20 75 6e 6c 65 ribly awry, unle
3640: 73 73 20 64 75 72 69 6e 67 20 66 69 6c 65 20 73 ss during file s
3650: 79 73 74 65 6d 20 73 75 70 70 6f 72 74 20 0a 20 ystem support .
3660: 20 20 20 20 2a 20 69 6e 74 72 6f 73 70 65 63 74 * introspect
3670: 69 6f 6e 2c 20 69 6e 20 77 68 69 63 68 20 69 74 ion, in which it
3680: 20 61 63 74 75 61 6c 6c 79 20 6d 65 61 6e 73 20 actually means
3690: 77 68 61 74 20 69 74 20 73 61 79 73 20 2a 2f 0a what it says */.
36a0: 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 45 4e #endif.#ifdef EN
36b0: 4f 54 53 55 50 0a 20 20 63 61 73 65 20 45 4e 4f OTSUP. case ENO
36c0: 54 53 55 50 3a 20 0a 20 20 20 20 2f 2a 20 69 6e TSUP: . /* in
36d0: 76 61 6c 69 64 20 66 64 2c 20 75 6e 6c 65 73 73 valid fd, unless
36e0: 20 64 75 72 69 6e 67 20 66 69 6c 65 20 73 79 73 during file sys
36f0: 74 65 6d 20 73 75 70 70 6f 72 74 20 69 6e 74 72 tem support intr
3700: 6f 73 70 65 63 74 69 6f 6e 2c 20 69 6e 20 77 68 ospection, in wh
3710: 69 63 68 20 0a 20 20 20 20 20 2a 20 69 74 20 61 ich . * it a
3720: 63 74 75 61 6c 6c 79 20 6d 65 61 6e 73 20 77 68 ctually means wh
3730: 61 74 20 69 74 20 73 61 79 73 20 2a 2f 0a 23 65 at it says */.#e
3740: 6e 64 69 66 0a 20 20 63 61 73 65 20 45 49 4f 3a ndif. case EIO:
3750: 0a 20 20 63 61 73 65 20 45 42 41 44 46 3a 0a 20 . case EBADF:.
3760: 20 63 61 73 65 20 45 49 4e 56 41 4c 3a 0a 20 20 case EINVAL:.
3770: 63 61 73 65 20 45 4e 4f 54 43 4f 4e 4e 3a 0a 20 case ENOTCONN:.
3780: 20 63 61 73 65 20 45 4e 4f 44 45 56 3a 0a 20 20 case ENODEV:.
3790: 63 61 73 65 20 45 4e 58 49 4f 3a 0a 20 20 63 61 case ENXIO:. ca
37a0: 73 65 20 45 4e 4f 45 4e 54 3a 0a 20 20 63 61 73 se ENOENT:. cas
37b0: 65 20 45 53 54 41 4c 45 3a 0a 20 20 63 61 73 65 e ESTALE:. case
37c0: 20 45 4e 4f 53 59 53 3a 0a 20 20 20 20 2f 2a 20 ENOSYS:. /*
37d0: 74 68 65 73 65 20 73 68 6f 75 6c 64 20 66 6f 72 these should for
37e0: 63 65 20 74 68 65 20 63 6c 69 65 6e 74 20 74 6f ce the client to
37f0: 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 close the file
3800: 61 6e 64 20 72 65 63 6f 6e 6e 65 63 74 20 2a 2f and reconnect */
3810: 0a 20 20 20 20 0a 20 20 64 65 66 61 75 6c 74 3a . . default:
3820: 20 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c . return sql
3830: 69 74 65 49 4f 45 72 72 3b 0a 20 20 7d 0a 7d 0a iteIOErr;. }.}.
3840: 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .../************
3850: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3860: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3870: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3880: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
3890: 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
38a0: 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 55 6e 69 71 ***** Begin Uniq
38b0: 75 65 20 46 69 6c 65 20 49 44 20 55 74 69 6c 69 ue File ID Utili
38c0: 74 79 20 55 73 65 64 20 42 79 20 56 78 57 6f 72 ty Used By VxWor
38d0: 6b 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ks *************
38e0: 2a 2a 0a 2a 2a 0a 2a 2a 20 4f 6e 20 6d 6f 73 74 **.**.** On most
38f0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 75 6e 69 versions of uni
3900: 78 2c 20 77 65 20 63 61 6e 20 67 65 74 20 61 20 x, we can get a
3910: 75 6e 69 71 75 65 20 49 44 20 66 6f 72 20 61 20 unique ID for a
3920: 66 69 6c 65 20 62 79 20 63 6f 6e 63 61 74 65 6e file by concaten
3930: 61 74 69 6e 67 0a 2a 2a 20 74 68 65 20 64 65 76 ating.** the dev
3940: 69 63 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 74 ice number and t
3950: 68 65 20 69 6e 6f 64 65 20 6e 75 6d 62 65 72 2e he inode number.
3960: 20 20 42 75 74 20 74 68 69 73 20 64 6f 65 73 20 But this does
3970: 6e 6f 74 20 77 6f 72 6b 20 6f 6e 20 56 78 57 6f not work on VxWo
3980: 72 6b 73 2e 0a 2a 2a 20 4f 6e 20 56 78 57 6f 72 rks..** On VxWor
3990: 6b 73 2c 20 61 20 75 6e 69 71 75 65 20 66 69 6c ks, a unique fil
39a0: 65 20 69 64 20 6d 75 73 74 20 62 65 20 62 61 73 e id must be bas
39b0: 65 64 20 6f 6e 20 74 68 65 20 63 61 6e 6f 6e 69 ed on the canoni
39c0: 63 61 6c 20 66 69 6c 65 6e 61 6d 65 2e 0a 2a 2a cal filename..**
39d0: 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f .** A pointer to
39e0: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 an instance of
39f0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
3a00: 72 75 63 74 75 72 65 20 63 61 6e 20 62 65 20 75 ructure can be u
3a10: 73 65 64 20 61 73 20 61 0a 2a 2a 20 75 6e 69 71 sed as a.** uniq
3a20: 75 65 20 66 69 6c 65 20 49 44 20 69 6e 20 56 78 ue file ID in Vx
3a30: 57 6f 72 6b 73 2e 20 20 45 61 63 68 20 69 6e 73 Works. Each ins
3a40: 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 tance of this st
3a50: 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 ructure contains
3a60: 0a 2a 2a 20 61 20 63 6f 70 79 20 6f 66 20 74 68 .** a copy of th
3a70: 65 20 63 61 6e 6f 6e 69 63 61 6c 20 66 69 6c 65 e canonical file
3a80: 6e 61 6d 65 2e 20 20 54 68 65 72 65 20 69 73 20 name. There is
3a90: 61 6c 73 6f 20 61 20 72 65 66 65 72 65 6e 63 65 also a reference
3aa0: 20 63 6f 75 6e 74 2e 20 20 0a 2a 2a 20 54 68 65 count. .** The
3ab0: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 72 65 structure is re
3ac0: 63 6c 61 69 6d 65 64 20 77 68 65 6e 20 74 68 65 claimed when the
3ad0: 20 6e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 number of point
3ae0: 65 72 73 20 74 6f 20 69 74 20 64 72 6f 70 73 20 ers to it drops
3af0: 74 6f 0a 2a 2a 20 7a 65 72 6f 2e 0a 2a 2a 0a 2a to.** zero..**.*
3b00: 2a 20 54 68 65 72 65 20 61 72 65 20 6e 65 76 65 * There are neve
3b10: 72 20 76 65 72 79 20 6d 61 6e 79 20 66 69 6c 65 r very many file
3b20: 73 20 6f 70 65 6e 20 61 74 20 6f 6e 65 20 74 69 s open at one ti
3b30: 6d 65 20 61 6e 64 20 6c 6f 6f 6b 75 70 73 20 61 me and lookups a
3b40: 72 65 20 6e 6f 74 0a 2a 2a 20 61 20 70 65 72 66 re not.** a perf
3b50: 6f 72 6d 61 6e 63 65 2d 63 72 69 74 69 63 61 6c ormance-critical
3b60: 20 70 61 74 68 2c 20 73 6f 20 69 74 20 69 73 20 path, so it is
3b70: 73 75 66 66 69 63 69 65 6e 74 20 74 6f 20 70 75 sufficient to pu
3b80: 74 20 74 68 65 73 65 0a 2a 2a 20 73 74 72 75 63 t these.** struc
3b90: 74 75 72 65 73 20 6f 6e 20 61 20 6c 69 6e 6b 65 tures on a linke
3ba0: 64 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 72 75 63 d list..*/.struc
3bb0: 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 t vxworksFileId
3bc0: 7b 0a 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 {. struct vxwor
3bd0: 6b 73 46 69 6c 65 49 64 20 2a 70 4e 65 78 74 3b ksFileId *pNext;
3be0: 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 61 20 6c /* Next in a l
3bf0: 69 73 74 20 6f 66 20 74 68 65 6d 20 61 6c 6c 20 ist of them all
3c00: 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 */. int nRef;
3c10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3c20: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
3c30: 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 references to th
3c40: 69 73 20 6f 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 is one */. int
3c50: 6e 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 nName;
3c60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e /* Len
3c70: 67 74 68 20 6f 66 20 74 68 65 20 7a 43 61 6e 6f gth of the zCano
3c80: 6e 69 63 61 6c 4e 61 6d 65 5b 5d 20 73 74 72 69 nicalName[] stri
3c90: 6e 67 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 ng */. char *zC
3ca0: 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 3b 20 20 20 anonicalName;
3cb0: 20 20 20 20 20 20 2f 2a 20 43 61 6e 6f 6e 69 63 /* Canonic
3cc0: 61 6c 20 66 69 6c 65 6e 61 6d 65 20 2a 2f 0a 7d al filename */.}
3cd0: 3b 0a 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b ;..#if OS_VXWORK
3ce0: 53 0a 2f 2a 20 0a 2a 2a 20 41 6c 6c 20 75 6e 69 S./* .** All uni
3cf0: 71 75 65 20 66 69 6c 65 6e 61 6d 65 73 20 61 72 que filenames ar
3d00: 65 20 68 65 6c 64 20 6f 6e 20 61 20 6c 69 6e 6b e held on a link
3d10: 65 64 20 6c 69 73 74 20 68 65 61 64 65 64 20 62 ed list headed b
3d20: 79 20 74 68 69 73 0a 2a 2a 20 76 61 72 69 61 62 y this.** variab
3d30: 6c 65 3a 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74 le:.*/.static st
3d40: 72 75 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 ruct vxworksFile
3d50: 49 64 20 2a 76 78 77 6f 72 6b 73 46 69 6c 65 4c Id *vxworksFileL
3d60: 69 73 74 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 ist = 0;../*.**
3d70: 53 69 6d 70 6c 69 66 79 20 61 20 66 69 6c 65 6e Simplify a filen
3d80: 61 6d 65 20 69 6e 74 6f 20 69 74 73 20 63 61 6e ame into its can
3d90: 6f 6e 69 63 61 6c 20 66 6f 72 6d 0a 2a 2a 20 62 onical form.** b
3da0: 79 20 6d 61 6b 69 6e 67 20 74 68 65 20 66 6f 6c y making the fol
3db0: 6c 6f 77 69 6e 67 20 63 68 61 6e 67 65 73 3a 0a lowing changes:.
3dc0: 2a 2a 0a 2a 2a 20 20 2a 20 72 65 6d 6f 76 69 6e **.** * removin
3dd0: 67 20 61 6e 79 20 74 72 61 69 6c 69 6e 67 20 61 g any trailing a
3de0: 6e 64 20 64 75 70 6c 69 63 61 74 65 20 2f 0a 2a nd duplicate /.*
3df0: 2a 20 20 2a 20 63 6f 6e 76 65 72 74 20 2f 2e 2f * * convert /./
3e00: 20 69 6e 74 6f 20 6a 75 73 74 20 2f 0a 2a 2a 20 into just /.**
3e10: 20 2a 20 63 6f 6e 76 65 72 74 20 2f 41 2f 2e 2e * convert /A/..
3e20: 2f 20 77 68 65 72 65 20 41 20 69 73 20 61 6e 79 / where A is any
3e30: 20 73 69 6d 70 6c 65 20 6e 61 6d 65 20 69 6e 74 simple name int
3e40: 6f 20 6a 75 73 74 20 2f 0a 2a 2a 0a 2a 2a 20 43 o just /.**.** C
3e50: 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 hanges are made
3e60: 69 6e 2d 70 6c 61 63 65 2e 20 20 52 65 74 75 72 in-place. Retur
3e70: 6e 20 74 68 65 20 6e 65 77 20 6e 61 6d 65 20 6c n the new name l
3e80: 65 6e 67 74 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ength..**.** The
3e90: 20 6f 72 69 67 69 6e 61 6c 20 66 69 6c 65 6e 61 original filena
3ea0: 6d 65 20 69 73 20 69 6e 20 7a 5b 30 2e 2e 6e 2d me is in z[0..n-
3eb0: 31 5d 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 1]. Return the
3ec0: 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 68 61 number of.** cha
3ed0: 72 61 63 74 65 72 73 20 69 6e 20 74 68 65 20 73 racters in the s
3ee0: 69 6d 70 6c 69 66 69 65 64 20 6e 61 6d 65 2e 0a implified name..
3ef0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 78 */.static int vx
3f00: 77 6f 72 6b 73 53 69 6d 70 6c 69 66 79 4e 61 6d worksSimplifyNam
3f10: 65 28 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e e(char *z, int n
3f20: 29 7b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 ){. int i, j;.
3f30: 20 77 68 69 6c 65 28 20 6e 3e 31 20 26 26 20 7a while( n>1 && z
3f40: 5b 6e 2d 31 5d 3d 3d 27 2f 27 20 29 7b 20 6e 2d [n-1]=='/' ){ n-
3f50: 2d 3b 20 7d 0a 20 20 66 6f 72 28 69 3d 6a 3d 30 -; }. for(i=j=0
3f60: 3b 20 69 3c 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 ; i<n; i++){.
3f70: 20 69 66 28 20 7a 5b 69 5d 3d 3d 27 2f 27 20 29 if( z[i]=='/' )
3f80: 7b 0a 20 20 20 20 20 20 69 66 28 20 7a 5b 69 2b {. if( z[i+
3f90: 31 5d 3d 3d 27 2f 27 20 29 20 63 6f 6e 74 69 6e 1]=='/' ) contin
3fa0: 75 65 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 5b ue;. if( z[
3fb0: 69 2b 31 5d 3d 3d 27 2e 27 20 26 26 20 69 2b 32 i+1]=='.' && i+2
3fc0: 3c 6e 20 26 26 20 7a 5b 69 2b 32 5d 3d 3d 27 2f <n && z[i+2]=='/
3fd0: 27 20 29 7b 0a 20 20 20 20 20 20 20 20 69 20 2b ' ){. i +
3fe0: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e = 1;. con
3ff0: 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 tinue;. }.
4000: 20 20 20 20 20 69 66 28 20 7a 5b 69 2b 31 5d 3d if( z[i+1]=
4010: 3d 27 2e 27 20 26 26 20 69 2b 33 3c 6e 20 26 26 ='.' && i+3<n &&
4020: 20 7a 5b 69 2b 32 5d 3d 3d 27 2e 27 20 26 26 20 z[i+2]=='.' &&
4030: 7a 5b 69 2b 33 5d 3d 3d 27 2f 27 20 29 7b 0a 20 z[i+3]=='/' ){.
4040: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 6a 3e while( j>
4050: 30 20 26 26 20 7a 5b 6a 2d 31 5d 21 3d 27 2f 27 0 && z[j-1]!='/'
4060: 20 29 7b 20 6a 2d 2d 3b 20 7d 0a 20 20 20 20 20 ){ j--; }.
4070: 20 20 20 69 66 28 20 6a 3e 30 20 29 7b 20 6a 2d if( j>0 ){ j-
4080: 2d 3b 20 7d 0a 20 20 20 20 20 20 20 20 69 20 2b -; }. i +
4090: 3d 20 32 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e = 2;. con
40a0: 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 tinue;. }.
40b0: 20 20 20 7d 0a 20 20 20 20 7a 5b 6a 2b 2b 5d 20 }. z[j++]
40c0: 3d 20 7a 5b 69 5d 3b 0a 20 20 7d 0a 20 20 7a 5b = z[i];. }. z[
40d0: 6a 5d 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e j] = 0;. return
40e0: 20 6a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e j;.}../*.** Fin
40f0: 64 20 61 20 75 6e 69 71 75 65 20 66 69 6c 65 20 d a unique file
4100: 49 44 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e ID for the given
4110: 20 61 62 73 6f 6c 75 74 65 20 70 61 74 68 6e 61 absolute pathna
4120: 6d 65 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 61 me. Return.** a
4130: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
4140: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 6f 62 vxworksFileId ob
4150: 6a 65 63 74 2e 20 20 54 68 69 73 20 70 6f 69 6e ject. This poin
4160: 74 65 72 20 69 73 20 74 68 65 20 75 6e 69 71 75 ter is the uniqu
4170: 65 0a 2a 2a 20 66 69 6c 65 20 49 44 2e 0a 2a 2a e.** file ID..**
4180: 0a 2a 2a 20 54 68 65 20 6e 52 65 66 20 66 69 65 .** The nRef fie
4190: 6c 64 20 6f 66 20 74 68 65 20 76 78 77 6f 72 6b ld of the vxwork
41a0: 73 46 69 6c 65 49 64 20 6f 62 6a 65 63 74 20 69 sFileId object i
41b0: 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 20 62 65 s incremented be
41c0: 66 6f 72 65 0a 2a 2a 20 74 68 65 20 6f 62 6a 65 fore.** the obje
41d0: 63 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 ct is returned.
41e0: 20 41 20 6e 65 77 20 76 78 77 6f 72 6b 73 46 69 A new vxworksFi
41f0: 6c 65 49 64 20 6f 62 6a 65 63 74 20 69 73 20 63 leId object is c
4200: 72 65 61 74 65 64 0a 2a 2a 20 61 6e 64 20 61 64 reated.** and ad
4210: 64 65 64 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 ded to the globa
4220: 6c 20 6c 69 73 74 20 69 66 20 6e 65 63 65 73 73 l list if necess
4230: 61 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 ary..**.** If a
4240: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
4250: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 n error occurs,
4260: 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a return NULL..*/.
4270: 73 74 61 74 69 63 20 73 74 72 75 63 74 20 76 78 static struct vx
4280: 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 76 78 77 worksFileId *vxw
4290: 6f 72 6b 73 46 69 6e 64 46 69 6c 65 49 64 28 63 orksFindFileId(c
42a0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 62 73 6f onst char *zAbso
42b0: 6c 75 74 65 4e 61 6d 65 29 7b 0a 20 20 73 74 72 luteName){. str
42c0: 75 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 uct vxworksFileI
42d0: 64 20 2a 70 4e 65 77 3b 20 20 20 20 20 20 20 20 d *pNew;
42e0: 20 2f 2a 20 73 65 61 72 63 68 20 6b 65 79 20 61 /* search key a
42f0: 6e 64 20 6e 65 77 20 66 69 6c 65 20 49 44 20 2a nd new file ID *
4300: 2f 0a 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 /. struct vxwor
4310: 6b 73 46 69 6c 65 49 64 20 2a 70 43 61 6e 64 69 ksFileId *pCandi
4320: 64 61 74 65 3b 20 20 20 2f 2a 20 46 6f 72 20 6c date; /* For l
4330: 6f 6f 70 69 6e 67 20 6f 76 65 72 20 65 78 69 73 ooping over exis
4340: 74 69 6e 67 20 66 69 6c 65 20 49 44 73 20 2a 2f ting file IDs */
4350: 0a 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 . int n;
4360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4370: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
4380: 20 6f 66 20 7a 41 62 73 6f 6c 75 74 65 4e 61 6d of zAbsoluteNam
4390: 65 20 73 74 72 69 6e 67 20 2a 2f 0a 0a 20 20 61 e string */.. a
43a0: 73 73 65 72 74 28 20 7a 41 62 73 6f 6c 75 74 65 ssert( zAbsolute
43b0: 4e 61 6d 65 5b 30 5d 3d 3d 27 2f 27 20 29 3b 0a Name[0]=='/' );.
43c0: 20 20 6e 20 3d 20 28 69 6e 74 29 73 74 72 6c 65 n = (int)strle
43d0: 6e 28 7a 41 62 73 6f 6c 75 74 65 4e 61 6d 65 29 n(zAbsoluteName)
43e0: 3b 0a 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 ;. pNew = sqlit
43f0: 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f e3_malloc( sizeo
4400: 66 28 2a 70 4e 65 77 29 20 2b 20 28 6e 2b 31 29 f(*pNew) + (n+1)
4410: 20 29 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d );. if( pNew==
4420: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
4430: 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c pNew->zCanonical
4440: 4e 61 6d 65 20 3d 20 28 63 68 61 72 2a 29 26 70 Name = (char*)&p
4450: 4e 65 77 5b 31 5d 3b 0a 20 20 6d 65 6d 63 70 79 New[1];. memcpy
4460: 28 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e 69 63 61 (pNew->zCanonica
4470: 6c 4e 61 6d 65 2c 20 7a 41 62 73 6f 6c 75 74 65 lName, zAbsolute
4480: 4e 61 6d 65 2c 20 6e 2b 31 29 3b 0a 20 20 6e 20 Name, n+1);. n
4490: 3d 20 76 78 77 6f 72 6b 73 53 69 6d 70 6c 69 66 = vxworksSimplif
44a0: 79 4e 61 6d 65 28 70 4e 65 77 2d 3e 7a 43 61 6e yName(pNew->zCan
44b0: 6f 6e 69 63 61 6c 4e 61 6d 65 2c 20 6e 29 3b 0a onicalName, n);.
44c0: 0a 20 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 . /* Search for
44d0: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 an existing ent
44e0: 72 79 20 74 68 61 74 20 6d 61 74 63 68 69 6e 67 ry that matching
44f0: 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20 6e the canonical n
4500: 61 6d 65 2e 0a 20 20 2a 2a 20 49 66 20 66 6f 75 ame.. ** If fou
4510: 6e 64 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 nd, increment th
4520: 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e e reference coun
4530: 74 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70 t and return a p
4540: 6f 69 6e 74 65 72 20 74 6f 0a 20 20 2a 2a 20 74 ointer to. ** t
4550: 68 65 20 65 78 69 73 74 69 6e 67 20 66 69 6c 65 he existing file
4560: 20 49 44 2e 0a 20 20 2a 2f 0a 20 20 75 6e 69 78 ID.. */. unix
4570: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 EnterMutex();.
4580: 66 6f 72 28 70 43 61 6e 64 69 64 61 74 65 3d 76 for(pCandidate=v
4590: 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 74 3b 20 xworksFileList;
45a0: 70 43 61 6e 64 69 64 61 74 65 3b 20 70 43 61 6e pCandidate; pCan
45b0: 64 69 64 61 74 65 3d 70 43 61 6e 64 69 64 61 74 didate=pCandidat
45c0: 65 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 e->pNext){. i
45d0: 66 28 20 70 43 61 6e 64 69 64 61 74 65 2d 3e 6e f( pCandidate->n
45e0: 4e 61 6d 65 3d 3d 6e 20 0a 20 20 20 20 20 26 26 Name==n . &&
45f0: 20 6d 65 6d 63 6d 70 28 70 43 61 6e 64 69 64 61 memcmp(pCandida
4600: 74 65 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 te->zCanonicalNa
4610: 6d 65 2c 20 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e me, pNew->zCanon
4620: 69 63 61 6c 4e 61 6d 65 2c 20 6e 29 3d 3d 30 0a icalName, n)==0.
4630: 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 73 71 ){. sq
4640: 6c 69 74 65 33 5f 66 72 65 65 28 70 4e 65 77 29 lite3_free(pNew)
4650: 3b 0a 20 20 20 20 20 20 20 70 43 61 6e 64 69 64 ;. pCandid
4660: 61 74 65 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 ate->nRef++;.
4670: 20 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 unixLeaveMut
4680: 65 78 28 29 3b 0a 20 20 20 20 20 20 20 72 65 74 ex();. ret
4690: 75 72 6e 20 70 43 61 6e 64 69 64 61 74 65 3b 0a urn pCandidate;.
46a0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
46b0: 4e 6f 20 6d 61 74 63 68 20 77 61 73 20 66 6f 75 No match was fou
46c0: 6e 64 2e 20 20 57 65 20 77 69 6c 6c 20 6d 61 6b nd. We will mak
46d0: 65 20 61 20 6e 65 77 20 66 69 6c 65 20 49 44 20 e a new file ID
46e0: 2a 2f 0a 20 20 70 4e 65 77 2d 3e 6e 52 65 66 20 */. pNew->nRef
46f0: 3d 20 31 3b 0a 20 20 70 4e 65 77 2d 3e 6e 4e 61 = 1;. pNew->nNa
4700: 6d 65 20 3d 20 6e 3b 0a 20 20 70 4e 65 77 2d 3e me = n;. pNew->
4710: 70 4e 65 78 74 20 3d 20 76 78 77 6f 72 6b 73 46 pNext = vxworksF
4720: 69 6c 65 4c 69 73 74 3b 0a 20 20 76 78 77 6f 72 ileList;. vxwor
4730: 6b 73 46 69 6c 65 4c 69 73 74 20 3d 20 70 4e 65 ksFileList = pNe
4740: 77 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 w;. unixLeaveMu
4750: 74 65 78 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 tex();. return
4760: 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 pNew;.}../*.** D
4770: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 72 65 66 ecrement the ref
4780: 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 6f 6e 20 erence count on
4790: 61 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 a vxworksFileId
47a0: 6f 62 6a 65 63 74 2e 20 20 46 72 65 65 0a 2a 2a object. Free.**
47b0: 20 74 68 65 20 6f 62 6a 65 63 74 20 77 68 65 6e the object when
47c0: 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 the reference c
47d0: 6f 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65 72 ount reaches zer
47e0: 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 o..*/.static voi
47f0: 64 20 76 78 77 6f 72 6b 73 52 65 6c 65 61 73 65 d vxworksRelease
4800: 46 69 6c 65 49 64 28 73 74 72 75 63 74 20 76 78 FileId(struct vx
4810: 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70 49 64 worksFileId *pId
4820: 29 7b 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 ){. unixEnterMu
4830: 74 65 78 28 29 3b 0a 20 20 61 73 73 65 72 74 28 tex();. assert(
4840: 20 70 49 64 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a pId->nRef>0 );.
4850: 20 20 70 49 64 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 pId->nRef--;.
4860: 20 69 66 28 20 70 49 64 2d 3e 6e 52 65 66 3d 3d if( pId->nRef==
4870: 30 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 0 ){. struct
4880: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 2a vxworksFileId **
4890: 70 70 3b 0a 20 20 20 20 66 6f 72 28 70 70 3d 26 pp;. for(pp=&
48a0: 76 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 74 3b vxworksFileList;
48b0: 20 2a 70 70 20 26 26 20 2a 70 70 21 3d 70 49 64 *pp && *pp!=pId
48c0: 3b 20 70 70 20 3d 20 26 28 28 2a 70 70 29 2d 3e ; pp = &((*pp)->
48d0: 70 4e 65 78 74 29 29 7b 7d 0a 20 20 20 20 61 73 pNext)){}. as
48e0: 73 65 72 74 28 20 2a 70 70 3d 3d 70 49 64 20 29 sert( *pp==pId )
48f0: 3b 0a 20 20 20 20 2a 70 70 20 3d 20 70 49 64 2d ;. *pp = pId-
4900: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 >pNext;. sqli
4910: 74 65 33 5f 66 72 65 65 28 70 49 64 29 3b 0a 20 te3_free(pId);.
4920: 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 }. unixLeaveMu
4930: 74 65 78 28 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 tex();.}.#endif
4940: 2f 2a 20 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f /* OS_VXWORKS */
4950: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ./**************
4960: 2a 20 45 6e 64 20 6f 66 20 55 6e 69 71 75 65 20 * End of Unique
4970: 46 69 6c 65 20 49 44 20 55 74 69 6c 69 74 79 20 File ID Utility
4980: 55 73 65 64 20 42 79 20 56 78 57 6f 72 6b 73 20 Used By VxWorks
4990: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
49a0: 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .***************
49b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
49c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
49d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
49e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
49f0: 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .../************
4a00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4a10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4a20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4a40: 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
4a50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 50 ************** P
4a60: 6f 73 69 78 20 41 64 76 69 73 6f 72 79 20 4c 6f osix Advisory Lo
4a70: 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a cking **********
4a80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
4a90: 2a 2a 0a 2a 2a 0a 2a 2a 20 50 4f 53 49 58 20 61 **.**.** POSIX a
4aa0: 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 20 61 72 dvisory locks ar
4ab0: 65 20 62 72 6f 6b 65 6e 20 62 79 20 64 65 73 69 e broken by desi
4ac0: 67 6e 2e 20 20 41 4e 53 49 20 53 54 44 20 31 30 gn. ANSI STD 10
4ad0: 30 33 2e 31 20 28 31 39 39 36 29 0a 2a 2a 20 73 03.1 (1996).** s
4ae0: 65 63 74 69 6f 6e 20 36 2e 35 2e 32 2e 32 20 6c ection 6.5.2.2 l
4af0: 69 6e 65 73 20 34 38 33 20 74 68 72 6f 75 67 68 ines 483 through
4b00: 20 34 39 30 20 73 70 65 63 69 66 79 20 74 68 61 490 specify tha
4b10: 74 20 77 68 65 6e 20 61 20 70 72 6f 63 65 73 73 t when a process
4b20: 0a 2a 2a 20 73 65 74 73 20 6f 72 20 63 6c 65 61 .** sets or clea
4b30: 72 73 20 61 20 6c 6f 63 6b 2c 20 74 68 61 74 20 rs a lock, that
4b40: 6f 70 65 72 61 74 69 6f 6e 20 6f 76 65 72 72 69 operation overri
4b50: 64 65 73 20 61 6e 79 20 70 72 69 6f 72 20 6c 6f des any prior lo
4b60: 63 6b 73 20 73 65 74 0a 2a 2a 20 62 79 20 74 68 cks set.** by th
4b70: 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 e same process.
4b80: 20 49 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 70 It does not exp
4b90: 6c 69 63 69 74 6c 79 20 73 61 79 20 73 6f 2c 20 licitly say so,
4ba0: 62 75 74 20 74 68 69 73 20 69 6d 70 6c 69 65 73 but this implies
4bb0: 0a 2a 2a 20 74 68 61 74 20 69 74 20 6f 76 65 72 .** that it over
4bc0: 72 69 64 65 73 20 6c 6f 63 6b 73 20 73 65 74 20 rides locks set
4bd0: 62 79 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63 by the same proc
4be0: 65 73 73 20 75 73 69 6e 67 20 61 20 64 69 66 66 ess using a diff
4bf0: 65 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20 64 65 erent.** file de
4c00: 73 63 72 69 70 74 6f 72 2e 20 20 43 6f 6e 73 69 scriptor. Consi
4c10: 64 65 72 20 74 68 69 73 20 74 65 73 74 20 63 61 der this test ca
4c20: 73 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 se:.**.**
4c30: 69 6e 74 20 66 64 31 20 3d 20 6f 70 65 6e 28 22 int fd1 = open("
4c40: 2e 2f 66 69 6c 65 31 22 2c 20 4f 5f 52 44 57 52 ./file1", O_RDWR
4c50: 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b |O_CREAT, 0644);
4c60: 0a 2a 2a 20 20 20 20 20 20 20 69 6e 74 20 66 64 .** int fd
4c70: 32 20 3d 20 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 2 = open("./file
4c80: 32 22 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 2", O_RDWR|O_CRE
4c90: 41 54 2c 20 30 36 34 34 29 3b 0a 2a 2a 0a 2a 2a AT, 0644);.**.**
4ca0: 20 53 75 70 70 6f 73 65 20 2e 2f 66 69 6c 65 31 Suppose ./file1
4cb0: 20 61 6e 64 20 2e 2f 66 69 6c 65 32 20 61 72 65 and ./file2 are
4cc0: 20 72 65 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 really the same
4cd0: 20 66 69 6c 65 20 28 62 65 63 61 75 73 65 0a 2a file (because.*
4ce0: 2a 20 6f 6e 65 20 69 73 20 61 20 68 61 72 64 20 * one is a hard
4cf0: 6f 72 20 73 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b or symbolic link
4d00: 20 74 6f 20 74 68 65 20 6f 74 68 65 72 29 20 74 to the other) t
4d10: 68 65 6e 20 69 66 20 79 6f 75 20 73 65 74 0a 2a hen if you set.*
4d20: 2a 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c * an exclusive l
4d30: 6f 63 6b 20 6f 6e 20 66 64 31 2c 20 74 68 65 6e ock on fd1, then
4d40: 20 74 72 79 20 74 6f 20 67 65 74 20 61 6e 20 65 try to get an e
4d50: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 0a 2a 2a xclusive lock.**
4d60: 20 6f 6e 20 66 64 32 2c 20 69 74 20 77 6f 72 6b on fd2, it work
4d70: 73 2e 20 20 49 20 77 6f 75 6c 64 20 68 61 76 65 s. I would have
4d80: 20 65 78 70 65 63 74 65 64 20 74 68 65 20 73 65 expected the se
4d90: 63 6f 6e 64 20 6c 6f 63 6b 20 74 6f 0a 2a 2a 20 cond lock to.**
4da0: 66 61 69 6c 20 73 69 6e 63 65 20 74 68 65 72 65 fail since there
4db0: 20 77 61 73 20 61 6c 72 65 61 64 79 20 61 20 6c was already a l
4dc0: 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 ock on the file
4dd0: 64 75 65 20 74 6f 20 66 64 31 2e 0a 2a 2a 20 42 due to fd1..** B
4de0: 75 74 20 6e 6f 74 20 73 6f 2e 20 20 53 69 6e 63 ut not so. Sinc
4df0: 65 20 62 6f 74 68 20 6c 6f 63 6b 73 20 63 61 6d e both locks cam
4e00: 65 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65 20 e from the same
4e10: 70 72 6f 63 65 73 73 2c 20 74 68 65 0a 2a 2a 20 process, the.**
4e20: 73 65 63 6f 6e 64 20 6f 76 65 72 72 69 64 65 73 second overrides
4e30: 20 74 68 65 20 66 69 72 73 74 2c 20 65 76 65 6e the first, even
4e40: 20 74 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 though they wer
4e50: 65 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 0a 2a e on different.*
4e60: 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f * file descripto
4e70: 72 73 20 6f 70 65 6e 65 64 20 6f 6e 20 64 69 66 rs opened on dif
4e80: 66 65 72 65 6e 74 20 66 69 6c 65 20 6e 61 6d 65 ferent file name
4e90: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d 65 s..**.** This me
4ea0: 61 6e 73 20 74 68 61 74 20 77 65 20 63 61 6e 6e ans that we cann
4eb0: 6f 74 20 75 73 65 20 50 4f 53 49 58 20 6c 6f 63 ot use POSIX loc
4ec0: 6b 73 20 74 6f 20 73 79 6e 63 68 72 6f 6e 69 7a ks to synchroniz
4ed0: 65 20 66 69 6c 65 20 61 63 63 65 73 73 0a 2a 2a e file access.**
4ee0: 20 61 6d 6f 6e 67 20 63 6f 6d 70 65 74 69 6e 67 among competing
4ef0: 20 74 68 72 65 61 64 73 20 6f 66 20 74 68 65 20 threads of the
4f00: 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 20 50 same process. P
4f10: 4f 53 49 58 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 OSIX locks will
4f20: 77 6f 72 6b 20 66 69 6e 65 0a 2a 2a 20 74 6f 20 work fine.** to
4f30: 73 79 6e 63 68 72 6f 6e 69 7a 65 20 61 63 63 65 synchronize acce
4f40: 73 73 20 66 6f 72 20 74 68 72 65 61 64 73 20 69 ss for threads i
4f50: 6e 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 n separate proce
4f60: 73 73 65 73 2c 20 62 75 74 20 6e 6f 74 0a 2a 2a sses, but not.**
4f70: 20 74 68 72 65 61 64 73 20 77 69 74 68 69 6e 20 threads within
4f80: 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 the same process
4f90: 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b 20 ..**.** To work
4fa0: 61 72 6f 75 6e 64 20 74 68 65 20 70 72 6f 62 6c around the probl
4fb0: 65 6d 2c 20 53 51 4c 69 74 65 20 68 61 73 20 74 em, SQLite has t
4fc0: 6f 20 6d 61 6e 61 67 65 20 66 69 6c 65 20 6c 6f o manage file lo
4fd0: 63 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a cks internally.*
4fe0: 2a 20 6f 6e 20 69 74 73 20 6f 77 6e 2e 20 20 57 * on its own. W
4ff0: 68 65 6e 65 76 65 72 20 61 20 6e 65 77 20 64 61 henever a new da
5000: 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e 65 64 tabase is opened
5010: 2c 20 77 65 20 68 61 76 65 20 74 6f 20 66 69 6e , we have to fin
5020: 64 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 d the.** specifi
5030: 63 20 69 6e 6f 64 65 20 6f 66 20 74 68 65 20 64 c inode of the d
5040: 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 74 68 atabase file (th
5050: 65 20 69 6e 6f 64 65 20 69 73 20 64 65 74 65 72 e inode is deter
5060: 6d 69 6e 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 mined by the.**
5070: 73 74 5f 64 65 76 20 61 6e 64 20 73 74 5f 69 6e st_dev and st_in
5080: 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 o fields of the
5090: 73 74 61 74 20 73 74 72 75 63 74 75 72 65 20 74 stat structure t
50a0: 68 61 74 20 66 73 74 61 74 28 29 20 66 69 6c 6c hat fstat() fill
50b0: 73 20 69 6e 29 0a 2a 2a 20 61 6e 64 20 63 68 65 s in).** and che
50c0: 63 6b 20 66 6f 72 20 6c 6f 63 6b 73 20 61 6c 72 ck for locks alr
50d0: 65 61 64 79 20 65 78 69 73 74 69 6e 67 20 6f 6e eady existing on
50e0: 20 74 68 61 74 20 69 6e 6f 64 65 2e 20 20 57 68 that inode. Wh
50f0: 65 6e 20 6c 6f 63 6b 73 20 61 72 65 0a 2a 2a 20 en locks are.**
5100: 63 72 65 61 74 65 64 20 6f 72 20 72 65 6d 6f 76 created or remov
5110: 65 64 2c 20 77 65 20 68 61 76 65 20 74 6f 20 6c ed, we have to l
5120: 6f 6f 6b 20 61 74 20 6f 75 72 20 6f 77 6e 20 69 ook at our own i
5130: 6e 74 65 72 6e 61 6c 20 72 65 63 6f 72 64 20 6f nternal record o
5140: 66 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 73 20 74 f the.** locks t
5150: 6f 20 73 65 65 20 69 66 20 61 6e 6f 74 68 65 72 o see if another
5160: 20 74 68 72 65 61 64 20 68 61 73 20 70 72 65 76 thread has prev
5170: 69 6f 75 73 6c 79 20 73 65 74 20 61 20 6c 6f 63 iously set a loc
5180: 6b 20 6f 6e 20 74 68 61 74 20 73 61 6d 65 0a 2a k on that same.*
5190: 2a 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 28 * inode..**.** (
51a0: 41 73 69 64 65 3a 20 54 68 65 20 75 73 65 20 6f Aside: The use o
51b0: 66 20 69 6e 6f 64 65 20 6e 75 6d 62 65 72 73 20 f inode numbers
51c0: 61 73 20 75 6e 69 71 75 65 20 49 44 73 20 64 6f as unique IDs do
51d0: 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e 20 56 es not work on V
51e0: 78 57 6f 72 6b 73 2e 0a 2a 2a 20 46 6f 72 20 56 xWorks..** For V
51f0: 78 57 6f 72 6b 73 2c 20 77 65 20 68 61 76 65 20 xWorks, we have
5200: 74 6f 20 75 73 65 20 74 68 65 20 61 6c 74 65 72 to use the alter
5210: 6e 61 74 69 76 65 20 75 6e 69 71 75 65 20 49 44 native unique ID
5220: 20 73 79 73 74 65 6d 20 62 61 73 65 64 20 6f 6e system based on
5230: 0a 2a 2a 20 63 61 6e 6f 6e 69 63 61 6c 20 66 69 .** canonical fi
5240: 6c 65 6e 61 6d 65 20 61 6e 64 20 69 6d 70 6c 65 lename and imple
5250: 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 70 72 mented in the pr
5260: 65 76 69 6f 75 73 20 64 69 76 69 73 69 6f 6e 2e evious division.
5270: 29 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 ).**.** The sqli
5280: 74 65 33 5f 66 69 6c 65 20 73 74 72 75 63 74 75 te3_file structu
5290: 72 65 20 66 6f 72 20 50 4f 53 49 58 20 69 73 20 re for POSIX is
52a0: 6e 6f 20 6c 6f 6e 67 65 72 20 6a 75 73 74 20 61 no longer just a
52b0: 6e 20 69 6e 74 65 67 65 72 20 66 69 6c 65 0a 2a n integer file.*
52c0: 2a 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 49 * descriptor. I
52d0: 74 20 69 73 20 6e 6f 77 20 61 20 73 74 72 75 63 t is now a struc
52e0: 74 75 72 65 20 74 68 61 74 20 68 6f 6c 64 73 20 ture that holds
52f0: 74 68 65 20 69 6e 74 65 67 65 72 20 66 69 6c 65 the integer file
5300: 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 61 .** descriptor a
5310: 6e 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 nd a pointer to
5320: 61 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74 a structure that
5330: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 69 describes the i
5340: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 6c 6f 63 6b 73 nternal.** locks
5350: 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f on the correspo
5360: 6e 64 69 6e 67 20 69 6e 6f 64 65 2e 20 20 54 68 nding inode. Th
5370: 65 72 65 20 69 73 20 6f 6e 65 20 6c 6f 63 6b 69 ere is one locki
5380: 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 ng structure.**
5390: 70 65 72 20 69 6e 6f 64 65 2c 20 73 6f 20 69 66 per inode, so if
53a0: 20 74 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20 the same inode
53b0: 69 73 20 6f 70 65 6e 65 64 20 74 77 69 63 65 2c is opened twice,
53c0: 20 62 6f 74 68 20 75 6e 69 78 46 69 6c 65 20 73 both unixFile s
53d0: 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 70 6f 69 tructures.** poi
53e0: 6e 74 20 74 6f 20 74 68 65 20 73 61 6d 65 20 6c nt to the same l
53f0: 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 ocking structure
5400: 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 73 . The locking s
5410: 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 0a 2a tructure keeps.*
5420: 2a 20 61 20 72 65 66 65 72 65 6e 63 65 20 63 6f * a reference co
5430: 75 6e 74 20 28 73 6f 20 77 65 20 77 69 6c 6c 20 unt (so we will
5440: 6b 6e 6f 77 20 77 68 65 6e 20 74 6f 20 64 65 6c know when to del
5450: 65 74 65 20 69 74 29 20 61 6e 64 20 61 20 22 63 ete it) and a "c
5460: 6e 74 22 0a 2a 2a 20 66 69 65 6c 64 20 74 68 61 nt".** field tha
5470: 74 20 74 65 6c 6c 73 20 75 73 20 69 74 73 20 69 t tells us its i
5480: 6e 74 65 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 nternal lock sta
5490: 74 75 73 2e 20 20 63 6e 74 3d 3d 30 20 6d 65 61 tus. cnt==0 mea
54a0: 6e 73 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 69 ns the.** file i
54b0: 73 20 75 6e 6c 6f 63 6b 65 64 2e 20 20 63 6e 74 s unlocked. cnt
54c0: 3d 3d 2d 31 20 6d 65 61 6e 73 20 74 68 65 20 66 ==-1 means the f
54d0: 69 6c 65 20 68 61 73 20 61 6e 20 65 78 63 6c 75 ile has an exclu
54e0: 73 69 76 65 20 6c 6f 63 6b 2e 0a 2a 2a 20 63 6e sive lock..** cn
54f0: 74 3e 30 20 6d 65 61 6e 73 20 74 68 65 72 65 20 t>0 means there
5500: 61 72 65 20 63 6e 74 20 73 68 61 72 65 64 20 6c are cnt shared l
5510: 6f 63 6b 73 20 6f 6e 20 74 68 65 20 66 69 6c 65 ocks on the file
5520: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 79 20 61 74 74 65 ..**.** Any atte
5530: 6d 70 74 20 74 6f 20 6c 6f 63 6b 20 6f 72 20 75 mpt to lock or u
5540: 6e 6c 6f 63 6b 20 61 20 66 69 6c 65 20 66 69 72 nlock a file fir
5550: 73 74 20 63 68 65 63 6b 73 20 74 68 65 20 6c 6f st checks the lo
5560: 63 6b 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 cking.** structu
5570: 72 65 2e 20 20 54 68 65 20 66 63 6e 74 6c 28 29 re. The fcntl()
5580: 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 69 73 20 system call is
5590: 6f 6e 6c 79 20 69 6e 76 6f 6b 65 64 20 74 6f 20 only invoked to
55a0: 73 65 74 20 61 20 0a 2a 2a 20 50 4f 53 49 58 20 set a .** POSIX
55b0: 6c 6f 63 6b 20 69 66 20 74 68 65 20 69 6e 74 65 lock if the inte
55c0: 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 72 75 63 74 rnal lock struct
55d0: 75 72 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 ure transitions
55e0: 62 65 74 77 65 65 6e 0a 2a 2a 20 61 20 6c 6f 63 between.** a loc
55f0: 6b 65 64 20 61 6e 64 20 61 6e 20 75 6e 6c 6f 63 ked and an unloc
5600: 6b 65 64 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a ked state..**.**
5610: 20 42 75 74 20 77 61 69 74 3a 20 20 74 68 65 72 But wait: ther
5620: 65 20 61 72 65 20 79 65 74 20 6d 6f 72 65 20 70 e are yet more p
5630: 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 50 4f 53 roblems with POS
5640: 49 58 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 6b IX advisory lock
5650: 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 79 6f 75 20 s..**.** If you
5660: 63 6c 6f 73 65 20 61 20 66 69 6c 65 20 64 65 73 close a file des
5670: 63 72 69 70 74 6f 72 20 74 68 61 74 20 70 6f 69 criptor that poi
5680: 6e 74 73 20 74 6f 20 61 20 66 69 6c 65 20 74 68 nts to a file th
5690: 61 74 20 68 61 73 20 6c 6f 63 6b 73 2c 0a 2a 2a at has locks,.**
56a0: 20 61 6c 6c 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 all locks on th
56b0: 61 74 20 66 69 6c 65 20 74 68 61 74 20 61 72 65 at file that are
56c0: 20 6f 77 6e 65 64 20 62 79 20 74 68 65 20 63 75 owned by the cu
56d0: 72 72 65 6e 74 20 70 72 6f 63 65 73 73 20 61 72 rrent process ar
56e0: 65 0a 2a 2a 20 72 65 6c 65 61 73 65 64 2e 20 20 e.** released.
56f0: 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 74 To work around t
5700: 68 69 73 20 70 72 6f 62 6c 65 6d 2c 20 65 61 63 his problem, eac
5710: 68 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 h unixInodeInfo
5720: 6f 62 6a 65 63 74 0a 2a 2a 20 6d 61 69 6e 74 61 object.** mainta
5730: 69 6e 73 20 61 20 63 6f 75 6e 74 20 6f 66 20 74 ins a count of t
5740: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 65 6e he number of pen
5750: 64 69 6e 67 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 ding locks on th
5760: 61 20 69 6e 6f 64 65 2e 0a 2a 2a 20 57 68 65 6e a inode..** When
5770: 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d an attempt is m
5780: 61 64 65 20 74 6f 20 63 6c 6f 73 65 20 61 6e 20 ade to close an
5790: 75 6e 69 78 46 69 6c 65 2c 20 69 66 20 74 68 65 unixFile, if the
57a0: 72 65 20 61 72 65 0a 2a 2a 20 6f 74 68 65 72 20 re are.** other
57b0: 75 6e 69 78 46 69 6c 65 20 6f 70 65 6e 20 6f 6e unixFile open on
57c0: 20 74 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20 the same inode
57d0: 74 68 61 74 20 61 72 65 20 68 6f 6c 64 69 6e 67 that are holding
57e0: 20 6c 6f 63 6b 73 2c 20 74 68 65 20 63 61 6c 6c locks, the call
57f0: 0a 2a 2a 20 74 6f 20 63 6c 6f 73 65 28 29 20 74 .** to close() t
5800: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
5810: 6f 72 20 69 73 20 64 65 66 65 72 72 65 64 20 75 or is deferred u
5820: 6e 74 69 6c 20 61 6c 6c 20 6f 66 20 74 68 65 20 ntil all of the
5830: 6c 6f 63 6b 73 20 63 6c 65 61 72 2e 0a 2a 2a 20 locks clear..**
5840: 54 68 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 The unixInodeInf
5850: 6f 20 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 o structure keep
5860: 73 20 61 20 6c 69 73 74 20 6f 66 20 66 69 6c 65 s a list of file
5870: 20 64 65 73 63 72 69 70 74 6f 72 73 20 74 68 61 descriptors tha
5880: 74 20 6e 65 65 64 20 74 6f 0a 2a 2a 20 62 65 20 t need to.** be
5890: 63 6c 6f 73 65 64 20 61 6e 64 20 74 68 61 74 20 closed and that
58a0: 6c 69 73 74 20 69 73 20 77 61 6c 6b 65 64 20 28 list is walked (
58b0: 61 6e 64 20 63 6c 65 61 72 65 64 29 20 77 68 65 and cleared) whe
58c0: 6e 20 74 68 65 20 6c 61 73 74 20 6c 6f 63 6b 0a n the last lock.
58d0: 2a 2a 20 63 6c 65 61 72 73 2e 0a 2a 2a 0a 2a 2a ** clears..**.**
58e0: 20 59 65 74 20 61 6e 6f 74 68 65 72 20 70 72 6f Yet another pro
58f0: 62 6c 65 6d 3a 20 20 4c 69 6e 75 78 54 68 72 65 blem: LinuxThre
5900: 61 64 73 20 64 6f 20 6e 6f 74 20 70 6c 61 79 20 ads do not play
5910: 77 65 6c 6c 20 77 69 74 68 20 70 6f 73 69 78 20 well with posix
5920: 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4d 61 6e locks..**.** Man
5930: 79 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 y older versions
5940: 20 6f 66 20 6c 69 6e 75 78 20 75 73 65 20 74 68 of linux use th
5950: 65 20 4c 69 6e 75 78 54 68 72 65 61 64 73 20 6c e LinuxThreads l
5960: 69 62 72 61 72 79 20 77 68 69 63 68 20 69 73 0a ibrary which is.
5970: 2a 2a 20 6e 6f 74 20 70 6f 73 69 78 20 63 6f 6d ** not posix com
5980: 70 6c 69 61 6e 74 2e 20 20 55 6e 64 65 72 20 4c pliant. Under L
5990: 69 6e 75 78 54 68 72 65 61 64 73 2c 20 61 20 6c inuxThreads, a l
59a0: 6f 63 6b 20 63 72 65 61 74 65 64 20 62 79 20 74 ock created by t
59b0: 68 72 65 61 64 0a 2a 2a 20 41 20 63 61 6e 6e 6f hread.** A canno
59c0: 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 6f 72 t be modified or
59d0: 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 61 overridden by a
59e0: 20 64 69 66 66 65 72 65 6e 74 20 74 68 72 65 61 different threa
59f0: 64 20 42 2e 0a 2a 2a 20 4f 6e 6c 79 20 74 68 72 d B..** Only thr
5a00: 65 61 64 20 41 20 63 61 6e 20 6d 6f 64 69 66 79 ead A can modify
5a10: 20 74 68 65 20 6c 6f 63 6b 2e 20 20 4c 6f 63 6b the lock. Lock
5a20: 69 6e 67 20 62 65 68 61 76 69 6f 72 20 69 73 20 ing behavior is
5a30: 63 6f 72 72 65 63 74 0a 2a 2a 20 69 66 20 74 68 correct.** if th
5a40: 65 20 61 70 70 6c 69 61 74 69 6f 6e 20 75 73 65 e appliation use
5a50: 73 20 74 68 65 20 6e 65 77 65 72 20 4e 61 74 69 s the newer Nati
5a60: 76 65 20 50 6f 73 69 78 20 54 68 72 65 61 64 20 ve Posix Thread
5a70: 4c 69 62 72 61 72 79 20 28 4e 50 54 4c 29 0a 2a Library (NPTL).*
5a80: 2a 20 6f 6e 20 6c 69 6e 75 78 20 2d 20 77 69 74 * on linux - wit
5a90: 68 20 4e 50 54 4c 20 61 20 6c 6f 63 6b 20 63 72 h NPTL a lock cr
5aa0: 65 61 74 65 64 20 62 79 20 74 68 72 65 61 64 20 eated by thread
5ab0: 41 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 6c A can override l
5ac0: 6f 63 6b 73 0a 2a 2a 20 69 6e 20 74 68 72 65 61 ocks.** in threa
5ad0: 64 20 42 2e 20 20 42 75 74 20 74 68 65 72 65 20 d B. But there
5ae0: 69 73 20 6e 6f 20 77 61 79 20 74 6f 20 6b 6e 6f is no way to kno
5af0: 77 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d w at compile-tim
5b00: 65 20 77 68 69 63 68 0a 2a 2a 20 74 68 72 65 61 e which.** threa
5b10: 64 69 6e 67 20 6c 69 62 72 61 72 79 20 69 73 20 ding library is
5b20: 62 65 69 6e 67 20 75 73 65 64 2e 20 20 53 6f 20 being used. So
5b30: 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 there is no way
5b40: 74 6f 20 6b 6e 6f 77 20 61 74 0a 2a 2a 20 63 6f to know at.** co
5b50: 6d 70 69 6c 65 2d 74 69 6d 65 20 77 68 65 74 68 mpile-time wheth
5b60: 65 72 20 6f 72 20 6e 6f 74 20 74 68 72 65 61 64 er or not thread
5b70: 20 41 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 A can override
5b80: 6c 6f 63 6b 73 20 6f 6e 20 74 68 72 65 61 64 20 locks on thread
5b90: 42 2e 0a 2a 2a 20 4f 6e 65 20 68 61 73 20 74 6f B..** One has to
5ba0: 20 64 6f 20 61 20 72 75 6e 2d 74 69 6d 65 20 63 do a run-time c
5bb0: 68 65 63 6b 20 74 6f 20 64 69 73 63 6f 76 65 72 heck to discover
5bc0: 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 the behavior of
5bd0: 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 the.** current
5be0: 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 53 process..**.** S
5bf0: 51 4c 69 74 65 20 75 73 65 64 20 74 6f 20 73 75 QLite used to su
5c00: 70 70 6f 72 74 20 4c 69 6e 75 78 54 68 72 65 61 pport LinuxThrea
5c10: 64 73 2e 20 20 42 75 74 20 73 75 70 70 6f 72 74 ds. But support
5c20: 20 66 6f 72 20 4c 69 6e 75 78 54 68 72 65 61 64 for LinuxThread
5c30: 73 0a 2a 2a 20 77 61 73 20 64 72 6f 70 70 65 64 s.** was dropped
5c40: 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 beginning with
5c50: 76 65 72 73 69 6f 6e 20 33 2e 37 2e 30 2e 20 20 version 3.7.0.
5c60: 53 51 4c 69 74 65 20 77 69 6c 6c 20 73 74 69 6c SQLite will stil
5c70: 6c 20 77 6f 72 6b 20 77 69 74 68 0a 2a 2a 20 4c l work with.** L
5c80: 69 6e 75 78 54 68 72 65 61 64 73 20 70 72 6f 76 inuxThreads prov
5c90: 69 64 65 64 20 74 68 61 74 20 28 31 29 20 74 68 ided that (1) th
5ca0: 65 72 65 20 69 73 20 6e 6f 20 6d 6f 72 65 20 74 ere is no more t
5cb0: 68 61 6e 20 6f 6e 65 20 63 6f 6e 6e 65 63 74 69 han one connecti
5cc0: 6f 6e 20 0a 2a 2a 20 70 65 72 20 64 61 74 61 62 on .** per datab
5cd0: 61 73 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 ase file in the
5ce0: 73 61 6d 65 20 70 72 6f 63 65 73 73 20 61 6e 64 same process and
5cf0: 20 28 32 29 20 64 61 74 61 62 61 73 65 20 63 6f (2) database co
5d00: 6e 6e 65 63 74 69 6f 6e 73 0a 2a 2a 20 64 6f 20 nnections.** do
5d10: 6e 6f 74 20 6d 6f 76 65 20 61 63 72 6f 73 73 20 not move across
5d20: 74 68 72 65 61 64 73 2e 0a 2a 2f 0a 0a 2f 2a 0a threads..*/../*.
5d30: 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ** An instance o
5d40: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
5d50: 73 74 72 75 63 74 75 72 65 20 73 65 72 76 65 73 structure serves
5d60: 20 61 73 20 74 68 65 20 6b 65 79 20 75 73 65 64 as the key used
5d70: 0a 2a 2a 20 74 6f 20 6c 6f 63 61 74 65 20 61 20 .** to locate a
5d80: 70 61 72 74 69 63 75 6c 61 72 20 75 6e 69 78 49 particular unixI
5d90: 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 2e nodeInfo object.
5da0: 0a 2a 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 46 .*/.struct unixF
5db0: 69 6c 65 49 64 20 7b 0a 20 20 64 65 76 5f 74 20 ileId {. dev_t
5dc0: 64 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 dev;
5dd0: 20 20 20 20 20 20 2f 2a 20 44 65 76 69 63 65 20 /* Device
5de0: 6e 75 6d 62 65 72 20 2a 2f 0a 23 69 66 20 4f 53 number */.#if OS
5df0: 5f 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 75 63 _VXWORKS. struc
5e00: 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 t vxworksFileId
5e10: 2a 70 49 64 3b 20 20 2f 2a 20 55 6e 69 71 75 65 *pId; /* Unique
5e20: 20 66 69 6c 65 20 49 44 20 66 6f 72 20 76 78 77 file ID for vxw
5e30: 6f 72 6b 73 2e 20 2a 2f 0a 23 65 6c 73 65 0a 20 orks. */.#else.
5e40: 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20 20 20 20 ino_t ino;
5e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
5e60: 49 6e 6f 64 65 20 6e 75 6d 62 65 72 20 2a 2f 0a Inode number */.
5e70: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
5e80: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
5e90: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
5ea0: 72 75 63 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 ructure is alloc
5eb0: 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 6f 70 ated for each op
5ec0: 65 6e 0a 2a 2a 20 69 6e 6f 64 65 2e 20 20 4f 72 en.** inode. Or
5ed0: 2c 20 6f 6e 20 4c 69 6e 75 78 54 68 72 65 61 64 , on LinuxThread
5ee0: 73 2c 20 74 68 65 72 65 20 69 73 20 6f 6e 65 20 s, there is one
5ef0: 6f 66 20 74 68 65 73 65 20 73 74 72 75 63 74 75 of these structu
5f00: 72 65 73 20 66 6f 72 0a 2a 2a 20 65 61 63 68 20 res for.** each
5f10: 69 6e 6f 64 65 20 6f 70 65 6e 65 64 20 62 79 20 inode opened by
5f20: 65 61 63 68 20 74 68 72 65 61 64 2e 0a 2a 2a 0a each thread..**.
5f30: 2a 2a 20 41 20 73 69 6e 67 6c 65 20 69 6e 6f 64 ** A single inod
5f40: 65 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 e can have multi
5f50: 70 6c 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 ple file descrip
5f60: 74 6f 72 73 2c 20 73 6f 20 65 61 63 68 20 75 6e tors, so each un
5f70: 69 78 46 69 6c 65 0a 2a 2a 20 73 74 72 75 63 74 ixFile.** struct
5f80: 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 ure contains a p
5f90: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 73 ointer to an ins
5fa0: 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 tance of this ob
5fb0: 6a 65 63 74 20 61 6e 64 20 74 68 69 73 0a 2a 2a ject and this.**
5fc0: 20 6f 62 6a 65 63 74 20 6b 65 65 70 73 20 61 20 object keeps a
5fd0: 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d count of the num
5fe0: 62 65 72 20 6f 66 20 75 6e 69 78 46 69 6c 65 20 ber of unixFile
5ff0: 70 6f 69 6e 74 69 6e 67 20 74 6f 20 69 74 2e 0a pointing to it..
6000: 2a 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 49 6e */.struct unixIn
6010: 6f 64 65 49 6e 66 6f 20 7b 0a 20 20 73 74 72 75 odeInfo {. stru
6020: 63 74 20 75 6e 69 78 46 69 6c 65 49 64 20 66 69 ct unixFileId fi
6030: 6c 65 49 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 leId; /* T
6040: 68 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f he lookup key */
6050: 0a 20 20 69 6e 74 20 6e 53 68 61 72 65 64 3b 20 . int nShared;
6060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6070: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
6080: 53 48 41 52 45 44 20 6c 6f 63 6b 73 20 68 65 6c SHARED locks hel
6090: 64 20 2a 2f 0a 20 20 69 6e 74 20 65 46 69 6c 65 d */. int eFile
60a0: 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 Lock;
60b0: 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 /* One of
60c0: 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c 20 52 45 SHARED_LOCK, RE
60d0: 53 45 52 56 45 44 5f 4c 4f 43 4b 20 65 74 63 2e SERVED_LOCK etc.
60e0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 */. int nRef;
60f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6100: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
6110: 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 of pointers to t
6120: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f his structure */
6130: 0a 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a . unixShmNode *
6140: 70 53 68 6d 4e 6f 64 65 3b 20 20 20 20 20 20 20 pShmNode;
6150: 20 20 20 2f 2a 20 53 68 61 72 65 64 20 6d 65 6d /* Shared mem
6160: 6f 72 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 ory associated w
6170: 69 74 68 20 74 68 69 73 20 69 6e 6f 64 65 20 2a ith this inode *
6180: 2f 0a 20 20 69 6e 74 20 6e 4c 6f 63 6b 3b 20 20 /. int nLock;
6190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
61a0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
61b0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 66 69 6c outstanding fil
61c0: 65 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 55 6e 69 e locks */. Uni
61d0: 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e 75 73 xUnusedFd *pUnus
61e0: 65 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ed; /*
61f0: 55 6e 75 73 65 64 20 66 69 6c 65 20 64 65 73 63 Unused file desc
6200: 72 69 70 74 6f 72 73 20 74 6f 20 63 6c 6f 73 65 riptors to close
6210: 20 2a 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 */. unixInodeI
6220: 6e 66 6f 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 nfo *pNext;
6230: 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
6240: 20 61 6c 6c 20 75 6e 69 78 49 6e 6f 64 65 49 6e all unixInodeIn
6250: 66 6f 20 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 20 fo objects */.
6260: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 unixInodeInfo *p
6270: 50 72 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 Prev;
6280: 2f 2a 20 20 20 20 2e 2e 2e 2e 20 64 6f 75 62 6c /* .... doubl
6290: 79 20 6c 69 6e 6b 65 64 20 2a 2f 0a 23 69 66 20 y linked */.#if
62a0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
62b0: 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
62c0: 59 4c 45 29 0a 20 20 75 6e 73 69 67 6e 65 64 20 YLE). unsigned
62d0: 6c 6f 6e 67 20 6c 6f 6e 67 20 73 68 61 72 65 64 long long shared
62e0: 42 79 74 65 3b 20 20 2f 2a 20 66 6f 72 20 41 46 Byte; /* for AF
62f0: 50 20 73 69 6d 75 6c 61 74 65 64 20 73 68 61 72 P simulated shar
6300: 65 64 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 69 ed lock */.#endi
6310: 66 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 f.#if OS_VXWORKS
6320: 0a 20 20 73 65 6d 5f 74 20 2a 70 53 65 6d 3b 20 . sem_t *pSem;
6330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6340: 20 20 20 2f 2a 20 4e 61 6d 65 64 20 50 4f 53 49 /* Named POSI
6350: 58 20 73 65 6d 61 70 68 6f 72 65 20 2a 2f 0a 20 X semaphore */.
6360: 20 63 68 61 72 20 61 53 65 6d 4e 61 6d 65 5b 4d char aSemName[M
6370: 41 58 5f 50 41 54 48 4e 41 4d 45 2b 32 5d 3b 20 AX_PATHNAME+2];
6380: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 61 74 /* Name of that
6390: 20 73 65 6d 61 70 68 6f 72 65 20 2a 2f 0a 23 65 semaphore */.#e
63a0: 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 ndif.};../*.** A
63b0: 20 6c 69 73 74 73 20 6f 66 20 61 6c 6c 20 75 6e lists of all un
63c0: 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 ixInodeInfo obje
63d0: 63 74 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 cts..*/.static u
63e0: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 69 6e nixInodeInfo *in
63f0: 6f 64 65 4c 69 73 74 20 3d 20 30 3b 0a 0a 2f 2a odeList = 0;../*
6400: 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 75 6e .** Release a un
6410: 69 78 49 6e 6f 64 65 49 6e 66 6f 20 73 74 72 75 ixInodeInfo stru
6420: 63 74 75 72 65 20 70 72 65 76 69 6f 75 73 6c 79 cture previously
6430: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 66 69 allocated by fi
6440: 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 29 2e 0a 2a ndInodeInfo()..*
6450: 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 65 *.** The mutex e
6460: 6e 74 65 72 65 64 20 75 73 69 6e 67 20 74 68 65 ntered using the
6470: 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 unixEnterMutex(
6480: 29 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 ) function must
6490: 62 65 20 68 65 6c 64 0a 2a 2a 20 77 68 65 6e 20 be held.** when
64a0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
64b0: 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 called..*/.stat
64c0: 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 49 ic void releaseI
64d0: 6e 6f 64 65 49 6e 66 6f 28 75 6e 69 78 49 6e 6f nodeInfo(unixIno
64e0: 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 29 7b deInfo *pInode){
64f0: 0a 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d . assert( unixM
6500: 75 74 65 78 48 65 6c 64 28 29 20 29 3b 0a 20 20 utexHeld() );.
6510: 69 66 28 20 70 49 6e 6f 64 65 20 29 7b 0a 20 20 if( pInode ){.
6520: 20 20 70 49 6e 6f 64 65 2d 3e 6e 52 65 66 2d 2d pInode->nRef--
6530: 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f 64 65 ;. if( pInode
6540: 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 ->nRef==0 ){.
6550: 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
6560: 65 2d 3e 70 53 68 6d 4e 6f 64 65 3d 3d 30 20 29 e->pShmNode==0 )
6570: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 49 6e 6f ;. if( pIno
6580: 64 65 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 de->pPrev ){.
6590: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e assert( pIn
65a0: 6f 64 65 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 ode->pPrev->pNex
65b0: 74 3d 3d 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 t==pInode );.
65c0: 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 70 50 72 pInode->pPr
65d0: 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 49 6e 6f ev->pNext = pIno
65e0: 64 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 de->pNext;.
65f0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
6600: 61 73 73 65 72 74 28 20 69 6e 6f 64 65 4c 69 73 assert( inodeLis
6610: 74 3d 3d 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 t==pInode );.
6620: 20 20 20 20 20 69 6e 6f 64 65 4c 69 73 74 20 3d inodeList =
6630: 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b 0a pInode->pNext;.
6640: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
6650: 28 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 20 ( pInode->pNext
6660: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
6670: 74 28 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 t( pInode->pNext
6680: 2d 3e 70 50 72 65 76 3d 3d 70 49 6e 6f 64 65 20 ->pPrev==pInode
6690: 29 3b 0a 20 20 20 20 20 20 20 20 70 49 6e 6f 64 );. pInod
66a0: 65 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 e->pNext->pPrev
66b0: 3d 20 70 49 6e 6f 64 65 2d 3e 70 50 72 65 76 3b = pInode->pPrev;
66c0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 . }. s
66d0: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 49 6e 6f qlite3_free(pIno
66e0: 64 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d de);. }. }.}
66f0: 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20 ../*.** Given a
6700: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2c file descriptor,
6710: 20 6c 6f 63 61 74 65 20 74 68 65 20 75 6e 69 78 locate the unix
6720: 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 InodeInfo object
6730: 20 74 68 61 74 0a 2a 2a 20 64 65 73 63 72 69 62 that.** describ
6740: 65 73 20 74 68 61 74 20 66 69 6c 65 20 64 65 73 es that file des
6750: 63 72 69 70 74 6f 72 2e 20 20 43 72 65 61 74 65 criptor. Create
6760: 20 61 20 6e 65 77 20 6f 6e 65 20 69 66 20 6e 65 a new one if ne
6770: 63 65 73 73 61 72 79 2e 20 20 54 68 65 0a 2a 2a cessary. The.**
6780: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6d 69 return value mi
6790: 67 68 74 20 62 65 20 75 6e 69 6e 69 74 69 61 6c ght be uninitial
67a0: 69 7a 65 64 20 69 66 20 61 6e 20 65 72 72 6f 72 ized if an error
67b0: 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 occurs..**.** T
67c0: 68 65 20 6d 75 74 65 78 20 65 6e 74 65 72 65 64 he mutex entered
67d0: 20 75 73 69 6e 67 20 74 68 65 20 75 6e 69 78 45 using the unixE
67e0: 6e 74 65 72 4d 75 74 65 78 28 29 20 66 75 6e 63 nterMutex() func
67f0: 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 68 65 6c tion must be hel
6800: 64 0a 2a 2a 20 77 68 65 6e 20 74 68 69 73 20 66 d.** when this f
6810: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
6820: 64 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 d..**.** Return
6830: 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 an appropriate e
6840: 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 rror code..*/.st
6850: 61 74 69 63 20 69 6e 74 20 66 69 6e 64 49 6e 6f atic int findIno
6860: 64 65 49 6e 66 6f 28 0a 20 20 75 6e 69 78 46 69 deInfo(. unixFi
6870: 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20 20 20 20 le *pFile,
6880: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 6e 69 78 /* Unix
6890: 20 66 69 6c 65 20 77 69 74 68 20 66 69 6c 65 20 file with file
68a0: 64 65 73 63 20 75 73 65 64 20 69 6e 20 74 68 65 desc used in the
68b0: 20 6b 65 79 20 2a 2f 0a 20 20 75 6e 69 78 49 6e key */. unixIn
68c0: 6f 64 65 49 6e 66 6f 20 2a 2a 70 70 49 6e 6f 64 odeInfo **ppInod
68d0: 65 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 e /* Retu
68e0: 72 6e 20 74 68 65 20 75 6e 69 78 49 6e 6f 64 65 rn the unixInode
68f0: 49 6e 66 6f 20 6f 62 6a 65 63 74 20 68 65 72 65 Info object here
6900: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b */.){. int rc;
6910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6920: 20 20 20 20 20 20 20 20 2f 2a 20 53 79 73 74 65 /* Syste
6930: 6d 20 63 61 6c 6c 20 72 65 74 75 72 6e 20 63 6f m call return co
6940: 64 65 20 2a 2f 0a 20 20 69 6e 74 20 66 64 3b 20 de */. int fd;
6950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6960: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 66 69 /* The fi
6970: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 6f le descriptor fo
6980: 72 20 70 46 69 6c 65 20 2a 2f 0a 20 20 73 74 72 r pFile */. str
6990: 75 63 74 20 75 6e 69 78 46 69 6c 65 49 64 20 66 uct unixFileId f
69a0: 69 6c 65 49 64 3b 20 20 20 20 20 20 2f 2a 20 4c ileId; /* L
69b0: 6f 6f 6b 75 70 20 6b 65 79 20 66 6f 72 20 74 68 ookup key for th
69c0: 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 e unixInodeInfo
69d0: 2a 2f 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 */. struct stat
69e0: 20 73 74 61 74 62 75 66 3b 20 20 20 20 20 20 20 statbuf;
69f0: 20 20 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c /* Low-level
6a00: 20 66 69 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f file informatio
6a10: 6e 20 2a 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65 n */. unixInode
6a20: 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 30 Info *pInode = 0
6a30: 3b 20 20 20 20 20 2f 2a 20 43 61 6e 64 69 64 61 ; /* Candida
6a40: 74 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f te unixInodeInfo
6a50: 20 6f 62 6a 65 63 74 20 2a 2f 0a 0a 20 20 61 73 object */.. as
6a60: 73 65 72 74 28 20 75 6e 69 78 4d 75 74 65 78 48 sert( unixMutexH
6a70: 65 6c 64 28 29 20 29 3b 0a 0a 20 20 2f 2a 20 47 eld() );.. /* G
6a80: 65 74 20 6c 6f 77 2d 6c 65 76 65 6c 20 69 6e 66 et low-level inf
6a90: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 ormation about t
6aa0: 68 65 20 66 69 6c 65 20 74 68 61 74 20 77 65 20 he file that we
6ab0: 63 61 6e 20 75 73 65 64 20 74 6f 0a 20 20 2a 2a can used to. **
6ac0: 20 63 72 65 61 74 65 20 61 20 75 6e 69 71 75 65 create a unique
6ad0: 20 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 66 69 name for the fi
6ae0: 6c 65 2e 0a 20 20 2a 2f 0a 20 20 66 64 20 3d 20 le.. */. fd =
6af0: 70 46 69 6c 65 2d 3e 68 3b 0a 20 20 72 63 20 3d pFile->h;. rc =
6b00: 20 66 73 74 61 74 28 66 64 2c 20 26 73 74 61 74 fstat(fd, &stat
6b10: 62 75 66 29 3b 0a 20 20 69 66 28 20 72 63 21 3d buf);. if( rc!=
6b20: 30 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 0 ){. pFile->
6b30: 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e lastErrno = errn
6b40: 6f 3b 0a 23 69 66 64 65 66 20 45 4f 56 45 52 46 o;.#ifdef EOVERF
6b50: 4c 4f 57 0a 20 20 20 20 69 66 28 20 70 46 69 6c LOW. if( pFil
6b60: 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 3d 3d 45 4f e->lastErrno==EO
6b70: 56 45 52 46 4c 4f 57 20 29 20 72 65 74 75 72 6e VERFLOW ) return
6b80: 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 3b 0a 23 SQLITE_NOLFS;.#
6b90: 65 6e 64 69 66 0a 20 20 20 20 72 65 74 75 72 6e endif. return
6ba0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20 SQLITE_IOERR;.
6bb0: 20 7d 0a 0a 23 69 66 64 65 66 20 5f 5f 41 50 50 }..#ifdef __APP
6bc0: 4c 45 5f 5f 0a 20 20 2f 2a 20 4f 6e 20 4f 53 20 LE__. /* On OS
6bd0: 58 20 6f 6e 20 61 6e 20 6d 73 64 6f 73 20 66 69 X on an msdos fi
6be0: 6c 65 73 79 73 74 65 6d 2c 20 74 68 65 20 69 6e lesystem, the in
6bf0: 6f 64 65 20 6e 75 6d 62 65 72 20 69 73 20 72 65 ode number is re
6c00: 70 6f 72 74 65 64 0a 20 20 2a 2a 20 69 6e 63 6f ported. ** inco
6c10: 72 72 65 63 74 6c 79 20 66 6f 72 20 7a 65 72 6f rrectly for zero
6c20: 2d 73 69 7a 65 20 66 69 6c 65 73 2e 20 20 53 65 -size files. Se
6c30: 65 20 74 69 63 6b 65 74 20 23 33 32 36 30 2e 20 e ticket #3260.
6c40: 20 54 6f 20 77 6f 72 6b 0a 20 20 2a 2a 20 61 72 To work. ** ar
6c50: 6f 75 6e 64 20 74 68 69 73 20 70 72 6f 62 6c 65 ound this proble
6c60: 6d 20 28 77 65 20 63 6f 6e 73 69 64 65 72 20 69 m (we consider i
6c70: 74 20 61 20 62 75 67 20 69 6e 20 4f 53 20 58 2c t a bug in OS X,
6c80: 20 6e 6f 74 20 53 51 4c 69 74 65 29 0a 20 20 2a not SQLite). *
6c90: 2a 20 77 65 20 61 6c 77 61 79 73 20 69 6e 63 72 * we always incr
6ca0: 65 61 73 65 20 74 68 65 20 66 69 6c 65 20 73 69 ease the file si
6cb0: 7a 65 20 74 6f 20 31 20 62 79 20 77 72 69 74 69 ze to 1 by writi
6cc0: 6e 67 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65 ng a single byte
6cd0: 0a 20 20 2a 2a 20 70 72 69 6f 72 20 74 6f 20 61 . ** prior to a
6ce0: 63 63 65 73 73 69 6e 67 20 74 68 65 20 69 6e 6f ccessing the ino
6cf0: 64 65 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 20 de number. The
6d00: 6f 6e 65 20 62 79 74 65 20 77 72 69 74 74 65 6e one byte written
6d10: 20 69 73 0a 20 20 2a 2a 20 61 6e 20 41 53 43 49 is. ** an ASCI
6d20: 49 20 27 53 27 20 63 68 61 72 61 63 74 65 72 20 I 'S' character
6d30: 77 68 69 63 68 20 61 6c 73 6f 20 68 61 70 70 65 which also happe
6d40: 6e 73 20 74 6f 20 62 65 20 74 68 65 20 66 69 72 ns to be the fir
6d50: 73 74 20 62 79 74 65 0a 20 20 2a 2a 20 69 6e 20 st byte. ** in
6d60: 74 68 65 20 68 65 61 64 65 72 20 6f 66 20 65 76 the header of ev
6d70: 65 72 79 20 53 51 4c 69 74 65 20 64 61 74 61 62 ery SQLite datab
6d80: 61 73 65 2e 20 20 49 6e 20 74 68 69 73 20 77 61 ase. In this wa
6d90: 79 2c 20 69 66 20 74 68 65 72 65 0a 20 20 2a 2a y, if there. **
6da0: 20 69 73 20 61 20 72 61 63 65 20 63 6f 6e 64 69 is a race condi
6db0: 74 69 6f 6e 20 73 75 63 68 20 74 68 61 74 20 61 tion such that a
6dc0: 6e 6f 74 68 65 72 20 74 68 72 65 61 64 20 68 61 nother thread ha
6dd0: 73 20 61 6c 72 65 61 64 79 20 70 6f 70 75 6c 61 s already popula
6de0: 74 65 64 0a 20 20 2a 2a 20 74 68 65 20 66 69 72 ted. ** the fir
6df0: 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 st page of the d
6e00: 61 74 61 62 61 73 65 2c 20 6e 6f 20 64 61 6d 61 atabase, no dama
6e10: 67 65 20 69 73 20 64 6f 6e 65 2e 0a 20 20 2a 2f ge is done.. */
6e20: 0a 20 20 69 66 28 20 73 74 61 74 62 75 66 2e 73 . if( statbuf.s
6e30: 74 5f 73 69 7a 65 3d 3d 30 20 26 26 20 28 70 46 t_size==0 && (pF
6e40: 69 6c 65 2d 3e 66 73 46 6c 61 67 73 20 26 20 53 ile->fsFlags & S
6e50: 51 4c 49 54 45 5f 46 53 46 4c 41 47 53 5f 49 53 QLITE_FSFLAGS_IS
6e60: 5f 4d 53 44 4f 53 29 21 3d 30 20 29 7b 0a 20 20 _MSDOS)!=0 ){.
6e70: 20 20 72 63 20 3d 20 77 72 69 74 65 28 66 64 2c rc = write(fd,
6e80: 20 22 53 22 2c 20 31 29 3b 0a 20 20 20 20 69 66 "S", 1);. if
6e90: 28 20 72 63 21 3d 31 20 29 7b 0a 20 20 20 20 20 ( rc!=1 ){.
6ea0: 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e pFile->lastErrn
6eb0: 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 o = errno;.
6ec0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
6ed0: 4f 45 52 52 3b 0a 20 20 20 20 7d 0a 20 20 20 20 OERR;. }.
6ee0: 72 63 20 3d 20 66 73 74 61 74 28 66 64 2c 20 26 rc = fstat(fd, &
6ef0: 73 74 61 74 62 75 66 29 3b 0a 20 20 20 20 69 66 statbuf);. if
6f00: 28 20 72 63 21 3d 30 20 29 7b 0a 20 20 20 20 20 ( rc!=0 ){.
6f10: 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e pFile->lastErrn
6f20: 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 o = errno;.
6f30: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
6f40: 4f 45 52 52 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a OERR;. }. }.
6f50: 23 65 6e 64 69 66 0a 0a 20 20 6d 65 6d 73 65 74 #endif.. memset
6f60: 28 26 66 69 6c 65 49 64 2c 20 30 2c 20 73 69 7a (&fileId, 0, siz
6f70: 65 6f 66 28 66 69 6c 65 49 64 29 29 3b 0a 20 20 eof(fileId));.
6f80: 66 69 6c 65 49 64 2e 64 65 76 20 3d 20 73 74 61 fileId.dev = sta
6f90: 74 62 75 66 2e 73 74 5f 64 65 76 3b 0a 23 69 66 tbuf.st_dev;.#if
6fa0: 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 66 69 OS_VXWORKS. fi
6fb0: 6c 65 49 64 2e 70 49 64 20 3d 20 70 46 69 6c 65 leId.pId = pFile
6fc0: 2d 3e 70 49 64 3b 0a 23 65 6c 73 65 0a 20 20 66 ->pId;.#else. f
6fd0: 69 6c 65 49 64 2e 69 6e 6f 20 3d 20 73 74 61 74 ileId.ino = stat
6fe0: 62 75 66 2e 73 74 5f 69 6e 6f 3b 0a 23 65 6e 64 buf.st_ino;.#end
6ff0: 69 66 0a 20 20 70 49 6e 6f 64 65 20 3d 20 69 6e if. pInode = in
7000: 6f 64 65 4c 69 73 74 3b 0a 20 20 77 68 69 6c 65 odeList;. while
7010: 28 20 70 49 6e 6f 64 65 20 26 26 20 6d 65 6d 63 ( pInode && memc
7020: 6d 70 28 26 66 69 6c 65 49 64 2c 20 26 70 49 6e mp(&fileId, &pIn
7030: 6f 64 65 2d 3e 66 69 6c 65 49 64 2c 20 73 69 7a ode->fileId, siz
7040: 65 6f 66 28 66 69 6c 65 49 64 29 29 20 29 7b 0a eof(fileId)) ){.
7050: 20 20 20 20 70 49 6e 6f 64 65 20 3d 20 70 49 6e pInode = pIn
7060: 6f 64 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a ode->pNext;. }.
7070: 20 20 69 66 28 20 70 49 6e 6f 64 65 3d 3d 30 20 if( pInode==0
7080: 29 7b 0a 20 20 20 20 70 49 6e 6f 64 65 20 3d 20 ){. pInode =
7090: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 sqlite3_malloc(
70a0: 73 69 7a 65 6f 66 28 2a 70 49 6e 6f 64 65 29 20 sizeof(*pInode)
70b0: 29 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f 64 );. if( pInod
70c0: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65 e==0 ){. re
70d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
70e0: 4d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d M;. }. mem
70f0: 73 65 74 28 70 49 6e 6f 64 65 2c 20 30 2c 20 73 set(pInode, 0, s
7100: 69 7a 65 6f 66 28 2a 70 49 6e 6f 64 65 29 29 3b izeof(*pInode));
7110: 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 70 49 6e . memcpy(&pIn
7120: 6f 64 65 2d 3e 66 69 6c 65 49 64 2c 20 26 66 69 ode->fileId, &fi
7130: 6c 65 49 64 2c 20 73 69 7a 65 6f 66 28 66 69 6c leId, sizeof(fil
7140: 65 49 64 29 29 3b 0a 20 20 20 20 70 49 6e 6f 64 eId));. pInod
7150: 65 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 e->nRef = 1;.
7160: 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 20 3d pInode->pNext =
7170: 20 69 6e 6f 64 65 4c 69 73 74 3b 0a 20 20 20 20 inodeList;.
7180: 70 49 6e 6f 64 65 2d 3e 70 50 72 65 76 20 3d 20 pInode->pPrev =
7190: 30 3b 0a 20 20 20 20 69 66 28 20 69 6e 6f 64 65 0;. if( inode
71a0: 4c 69 73 74 20 29 20 69 6e 6f 64 65 4c 69 73 74 List ) inodeList
71b0: 2d 3e 70 50 72 65 76 20 3d 20 70 49 6e 6f 64 65 ->pPrev = pInode
71c0: 3b 0a 20 20 20 20 69 6e 6f 64 65 4c 69 73 74 20 ;. inodeList
71d0: 3d 20 70 49 6e 6f 64 65 3b 0a 20 20 7d 65 6c 73 = pInode;. }els
71e0: 65 7b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e e{. pInode->n
71f0: 52 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 70 Ref++;. }. *pp
7200: 49 6e 6f 64 65 20 3d 20 70 49 6e 6f 64 65 3b 0a Inode = pInode;.
7210: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
7220: 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 OK;.}.../*.** Th
7230: 69 73 20 72 6f 75 74 69 6e 65 20 63 68 65 63 6b is routine check
7240: 73 20 69 66 20 74 68 65 72 65 20 69 73 20 61 20 s if there is a
7250: 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 68 65 RESERVED lock he
7260: 6c 64 20 6f 6e 20 74 68 65 20 73 70 65 63 69 66 ld on the specif
7270: 69 65 64 0a 2a 2a 20 66 69 6c 65 20 62 79 20 74 ied.** file by t
7280: 68 69 73 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 his or any other
7290: 20 70 72 6f 63 65 73 73 2e 20 49 66 20 73 75 63 process. If suc
72a0: 68 20 61 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 h a lock is held
72b0: 2c 20 73 65 74 20 2a 70 52 65 73 4f 75 74 0a 2a , set *pResOut.*
72c0: 2a 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 * to a non-zero
72d0: 76 61 6c 75 65 20 6f 74 68 65 72 77 69 73 65 20 value otherwise
72e0: 2a 70 52 65 73 4f 75 74 20 69 73 20 73 65 74 20 *pResOut is set
72f0: 74 6f 20 7a 65 72 6f 2e 20 20 54 68 65 20 72 65 to zero. The re
7300: 74 75 72 6e 20 76 61 6c 75 65 0a 2a 2a 20 69 73 turn value.** is
7310: 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f set to SQLITE_O
7320: 4b 20 75 6e 6c 65 73 73 20 61 6e 20 49 2f 4f 20 K unless an I/O
7330: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 error occurs dur
7340: 69 6e 67 20 6c 6f 63 6b 20 63 68 65 63 6b 69 6e ing lock checkin
7350: 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 g..*/.static int
7360: 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72 76 unixCheckReserv
7370: 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 edLock(sqlite3_f
7380: 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 ile *id, int *pR
7390: 65 73 4f 75 74 29 7b 0a 20 20 69 6e 74 20 72 63 esOut){. int rc
73a0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
73b0: 69 6e 74 20 72 65 73 65 72 76 65 64 20 3d 20 30 int reserved = 0
73c0: 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 ;. unixFile *pF
73d0: 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a ile = (unixFile*
73e0: 29 69 64 3b 0a 0a 20 20 53 69 6d 75 6c 61 74 65 )id;.. Simulate
73f0: 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 IOError( return
7400: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 SQLITE_IOERR_CHE
7410: 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 CKRESERVEDLOCK;
7420: 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 );.. assert( pF
7430: 69 6c 65 20 29 3b 0a 20 20 75 6e 69 78 45 6e 74 ile );. unixEnt
7440: 65 72 4d 75 74 65 78 28 29 3b 20 2f 2a 20 42 65 erMutex(); /* Be
7450: 63 61 75 73 65 20 70 46 69 6c 65 2d 3e 70 49 6e cause pFile->pIn
7460: 6f 64 65 20 69 73 20 73 68 61 72 65 64 20 61 63 ode is shared ac
7470: 72 6f 73 73 20 74 68 72 65 61 64 73 20 2a 2f 0a ross threads */.
7480: 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 . /* Check if a
7490: 20 74 68 72 65 61 64 20 69 6e 20 74 68 69 73 20 thread in this
74a0: 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 73 75 process holds su
74b0: 63 68 20 61 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 ch a lock */. i
74c0: 66 28 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 f( pFile->pInode
74d0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 ->eFileLock>SHAR
74e0: 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 ED_LOCK ){. r
74f0: 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 7d eserved = 1;. }
7500: 0a 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 73 65 .. /* Otherwise
7510: 20 73 65 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 see if some oth
7520: 65 72 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 er process holds
7530: 20 69 74 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 it.. */.#ifnde
7540: 66 20 5f 5f 44 4a 47 50 50 5f 5f 0a 20 20 69 66 f __DJGPP__. if
7550: 28 20 21 72 65 73 65 72 76 65 64 20 29 7b 0a 20 ( !reserved ){.
7560: 20 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 struct flock
7570: 6c 6f 63 6b 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c lock;. lock.l
7580: 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 _whence = SEEK_S
7590: 45 54 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 ET;. lock.l_s
75a0: 74 61 72 74 20 3d 20 52 45 53 45 52 56 45 44 5f tart = RESERVED_
75b0: 42 59 54 45 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c BYTE;. lock.l
75c0: 5f 6c 65 6e 20 3d 20 31 3b 0a 20 20 20 20 6c 6f _len = 1;. lo
75d0: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 57 52 ck.l_type = F_WR
75e0: 4c 43 4b 3b 0a 20 20 20 20 69 66 20 28 2d 31 20 LCK;. if (-1
75f0: 3d 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e == fcntl(pFile->
7600: 68 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63 h, F_GETLK, &loc
7610: 6b 29 29 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 k)) {. int
7620: 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a tErrno = errno;.
7630: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
7640: 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 eErrorFromPosixE
7650: 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c rror(tErrno, SQL
7660: 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 ITE_IOERR_CHECKR
7670: 45 53 45 52 56 45 44 4c 4f 43 4b 29 3b 0a 20 20 ESERVEDLOCK);.
7680: 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 pFile->lastE
7690: 72 72 6e 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 rrno = tErrno;.
76a0: 20 20 20 7d 20 65 6c 73 65 20 69 66 28 20 6c 6f } else if( lo
76b0: 63 6b 2e 6c 5f 74 79 70 65 21 3d 46 5f 55 4e 4c ck.l_type!=F_UNL
76c0: 43 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 73 65 CK ){. rese
76d0: 72 76 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a rved = 1;. }.
76e0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 }.#endif. .
76f0: 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 unixLeaveMutex()
7700: 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 54 45 ;. OSTRACE(("TE
7710: 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64 20 25 64 ST WR-LOCK %d %d
7720: 20 25 64 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 %d (unix)\n", p
7730: 46 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72 65 73 File->h, rc, res
7740: 65 72 76 65 64 29 29 3b 0a 0a 20 20 2a 70 52 65 erved));.. *pRe
7750: 73 4f 75 74 20 3d 20 72 65 73 65 72 76 65 64 3b sOut = reserved;
7760: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
7770: 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 20 ./*.** Lock the
7780: 66 69 6c 65 20 77 69 74 68 20 74 68 65 20 6c 6f file with the lo
7790: 63 6b 20 73 70 65 63 69 66 69 65 64 20 62 79 20 ck specified by
77a0: 70 61 72 61 6d 65 74 65 72 20 65 46 69 6c 65 4c parameter eFileL
77b0: 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 ock - one.** of
77c0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a the following:.*
77d0: 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 53 48 41 *.** (1) SHA
77e0: 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 RED_LOCK.**
77f0: 28 32 29 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 (2) RESERVED_LOC
7800: 4b 0a 2a 2a 20 20 20 20 20 28 33 29 20 50 45 4e K.** (3) PEN
7810: 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 DING_LOCK.**
7820: 20 28 34 29 20 45 58 43 4c 55 53 49 56 45 5f 4c (4) EXCLUSIVE_L
7830: 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 OCK.**.** Someti
7840: 6d 65 73 20 77 68 65 6e 20 72 65 71 75 65 73 74 mes when request
7850: 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 ing one lock sta
7860: 74 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c te, additional l
7870: 6f 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20 61 72 ock states.** ar
7880: 65 20 69 6e 73 65 72 74 65 64 20 69 6e 20 62 65 e inserted in be
7890: 74 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f 63 6b tween. The lock
78a0: 69 6e 67 20 6d 69 67 68 74 20 66 61 69 6c 20 6f ing might fail o
78b0: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 61 74 n one of the lat
78c0: 65 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e er.** transition
78d0: 73 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 6f s leaving the lo
78e0: 63 6b 20 73 74 61 74 65 20 64 69 66 66 65 72 65 ck state differe
78f0: 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 69 74 20 nt from what it
7900: 73 74 61 72 74 65 64 20 62 75 74 0a 2a 2a 20 73 started but.** s
7910: 74 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20 69 74 till short of it
7920: 73 20 67 6f 61 6c 2e 20 20 54 68 65 20 66 6f 6c s goal. The fol
7930: 6c 6f 77 69 6e 67 20 63 68 61 72 74 20 73 68 6f lowing chart sho
7940: 77 73 20 74 68 65 20 61 6c 6c 6f 77 65 64 0a 2a ws the allowed.*
7950: 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 61 6e * transitions an
7960: 64 20 74 68 65 20 69 6e 73 65 72 74 65 64 20 69 d the inserted i
7970: 6e 74 65 72 6d 65 64 69 61 74 65 20 73 74 61 74 ntermediate stat
7980: 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c es:.**.** UNL
7990: 4f 43 4b 45 44 20 2d 3e 20 53 48 41 52 45 44 0a OCKED -> SHARED.
79a0: 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 ** SHARED ->
79b0: 52 45 53 45 52 56 45 44 0a 2a 2a 20 20 20 20 53 RESERVED.** S
79c0: 48 41 52 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e HARED -> (PENDIN
79d0: 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a G) -> EXCLUSIVE.
79e0: 2a 2a 20 20 20 20 52 45 53 45 52 56 45 44 20 2d ** RESERVED -
79f0: 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 > (PENDING) -> E
7a00: 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 50 XCLUSIVE.** P
7a10: 45 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c 55 53 ENDING -> EXCLUS
7a20: 49 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 IVE.**.** This r
7a30: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 outine will only
7a40: 20 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 6b increase a lock
7a50: 2e 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 74 . Use the sqlit
7a60: 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 e3OsUnlock().**
7a70: 72 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 routine to lower
7a80: 20 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c a locking level
7a90: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
7aa0: 75 6e 69 78 4c 6f 63 6b 28 73 71 6c 69 74 65 33 unixLock(sqlite3
7ab0: 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65 _file *id, int e
7ac0: 46 69 6c 65 4c 6f 63 6b 29 7b 0a 20 20 2f 2a 20 FileLock){. /*
7ad0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 64 65 The following de
7ae0: 73 63 72 69 62 65 73 20 74 68 65 20 69 6d 70 6c scribes the impl
7af0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 ementation of th
7b00: 65 20 76 61 72 69 6f 75 73 20 6c 6f 63 6b 73 20 e various locks
7b10: 61 6e 64 0a 20 20 2a 2a 20 6c 6f 63 6b 20 74 72 and. ** lock tr
7b20: 61 6e 73 69 74 69 6f 6e 73 20 69 6e 20 74 65 72 ansitions in ter
7b30: 6d 73 20 6f 66 20 74 68 65 20 50 4f 53 49 58 20 ms of the POSIX
7b40: 61 64 76 69 73 6f 72 79 20 73 68 61 72 65 64 20 advisory shared
7b50: 61 6e 64 20 65 78 63 6c 75 73 69 76 65 0a 20 20 and exclusive.
7b60: 2a 2a 20 6c 6f 63 6b 20 70 72 69 6d 69 74 69 76 ** lock primitiv
7b70: 65 73 20 28 63 61 6c 6c 65 64 20 72 65 61 64 2d es (called read-
7b80: 6c 6f 63 6b 73 20 61 6e 64 20 77 72 69 74 65 2d locks and write-
7b90: 6c 6f 63 6b 73 20 62 65 6c 6f 77 2c 20 74 6f 20 locks below, to
7ba0: 61 76 6f 69 64 0a 20 20 2a 2a 20 63 6f 6e 66 75 avoid. ** confu
7bb0: 73 69 6f 6e 20 77 69 74 68 20 53 51 4c 69 74 65 sion with SQLite
7bc0: 20 6c 6f 63 6b 20 6e 61 6d 65 73 29 2e 20 54 68 lock names). Th
7bd0: 65 20 61 6c 67 6f 72 69 74 68 6d 73 20 61 72 65 e algorithms are
7be0: 20 63 6f 6d 70 6c 69 63 61 74 65 64 0a 20 20 2a complicated. *
7bf0: 2a 20 73 6c 69 67 68 74 6c 79 20 69 6e 20 6f 72 * slightly in or
7c00: 64 65 72 20 74 6f 20 62 65 20 63 6f 6d 70 61 74 der to be compat
7c10: 69 62 6c 65 20 77 69 74 68 20 77 69 6e 64 6f 77 ible with window
7c20: 73 20 73 79 73 74 65 6d 73 20 73 69 6d 75 6c 74 s systems simult
7c30: 61 6e 65 6f 75 73 6c 79 0a 20 20 2a 2a 20 61 63 aneously. ** ac
7c40: 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d 65 cessing the same
7c50: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
7c60: 69 6e 20 63 61 73 65 20 74 68 61 74 20 69 73 20 in case that is
7c70: 65 76 65 72 20 72 65 71 75 69 72 65 64 2e 0a 20 ever required..
7c80: 20 2a 2a 0a 20 20 2a 2a 20 53 79 6d 62 6f 6c 73 **. ** Symbols
7c90: 20 64 65 66 69 6e 65 64 20 69 6e 20 6f 73 2e 68 defined in os.h
7ca0: 20 69 6e 64 65 6e 74 69 66 79 20 74 68 65 20 27 indentify the '
7cb0: 70 65 6e 64 69 6e 67 20 62 79 74 65 27 20 61 6e pending byte' an
7cc0: 64 20 74 68 65 20 27 72 65 73 65 72 76 65 64 0a d the 'reserved.
7cd0: 20 20 2a 2a 20 62 79 74 65 27 2c 20 65 61 63 68 ** byte', each
7ce0: 20 73 69 6e 67 6c 65 20 62 79 74 65 73 20 61 74 single bytes at
7cf0: 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66 73 well known offs
7d00: 65 74 73 2c 20 61 6e 64 20 74 68 65 20 27 73 68 ets, and the 'sh
7d10: 61 72 65 64 20 62 79 74 65 0a 20 20 2a 2a 20 72 ared byte. ** r
7d20: 61 6e 67 65 27 2c 20 61 20 72 61 6e 67 65 20 6f ange', a range o
7d30: 66 20 35 31 30 20 62 79 74 65 73 20 61 74 20 61 f 510 bytes at a
7d40: 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66 73 well known offs
7d50: 65 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 6f et.. **. ** To
7d60: 20 6f 62 74 61 69 6e 20 61 20 53 48 41 52 45 44 obtain a SHARED
7d70: 20 6c 6f 63 6b 2c 20 61 20 72 65 61 64 2d 6c 6f lock, a read-lo
7d80: 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 6f ck is obtained o
7d90: 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 0a 20 n the 'pending.
7da0: 20 2a 2a 20 62 79 74 65 27 2e 20 20 49 66 20 74 ** byte'. If t
7db0: 68 69 73 20 69 73 20 73 75 63 63 65 73 73 66 75 his is successfu
7dc0: 6c 2c 20 61 20 72 61 6e 64 6f 6d 20 62 79 74 65 l, a random byte
7dd0: 20 66 72 6f 6d 20 74 68 65 20 27 73 68 61 72 65 from the 'share
7de0: 64 20 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e 67 d byte. ** rang
7df0: 65 27 20 69 73 20 72 65 61 64 2d 6c 6f 63 6b 65 e' is read-locke
7e00: 64 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 6f d and the lock o
7e10: 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 20 62 n the 'pending b
7e20: 79 74 65 27 20 72 65 6c 65 61 73 65 64 2e 0a 20 yte' released..
7e30: 20 2a 2a 0a 20 20 2a 2a 20 41 20 70 72 6f 63 65 **. ** A proce
7e40: 73 73 20 6d 61 79 20 6f 6e 6c 79 20 6f 62 74 61 ss may only obta
7e50: 69 6e 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f in a RESERVED lo
7e60: 63 6b 20 61 66 74 65 72 20 69 74 20 68 61 73 20 ck after it has
7e70: 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2e 0a 20 a SHARED lock..
7e80: 20 2a 2a 20 41 20 52 45 53 45 52 56 45 44 20 6c ** A RESERVED l
7e90: 6f 63 6b 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 ock is implement
7ea0: 65 64 20 62 79 20 67 72 61 62 62 69 6e 67 20 61 ed by grabbing a
7eb0: 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 write-lock on t
7ec0: 68 65 0a 20 20 2a 2a 20 27 72 65 73 65 72 76 65 he. ** 'reserve
7ed0: 64 20 62 79 74 65 27 2e 20 0a 20 20 2a 2a 0a 20 d byte'. . **.
7ee0: 20 2a 2a 20 41 20 70 72 6f 63 65 73 73 20 6d 61 ** A process ma
7ef0: 79 20 6f 6e 6c 79 20 6f 62 74 61 69 6e 20 61 20 y only obtain a
7f00: 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 61 66 74 PENDING lock aft
7f10: 65 72 20 69 74 20 68 61 73 20 6f 62 74 61 69 6e er it has obtain
7f20: 65 64 20 61 0a 20 20 2a 2a 20 53 48 41 52 45 44 ed a. ** SHARED
7f30: 20 6c 6f 63 6b 2e 20 41 20 50 45 4e 44 49 4e 47 lock. A PENDING
7f40: 20 6c 6f 63 6b 20 69 73 20 69 6d 70 6c 65 6d 65 lock is impleme
7f50: 6e 74 65 64 20 62 79 20 6f 62 74 61 69 6e 69 6e nted by obtainin
7f60: 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 0a 20 g a write-lock.
7f70: 20 2a 2a 20 6f 6e 20 74 68 65 20 27 70 65 6e 64 ** on the 'pend
7f80: 69 6e 67 20 62 79 74 65 27 2e 20 54 68 69 73 20 ing byte'. This
7f90: 65 6e 73 75 72 65 73 20 74 68 61 74 20 6e 6f 20 ensures that no
7fa0: 6e 65 77 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 new SHARED locks
7fb0: 20 63 61 6e 20 62 65 0a 20 20 2a 2a 20 6f 62 74 can be. ** obt
7fc0: 61 69 6e 65 64 2c 20 62 75 74 20 65 78 69 73 74 ained, but exist
7fd0: 69 6e 67 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 ing SHARED locks
7fe0: 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 74 6f 20 are allowed to
7ff0: 70 65 72 73 69 73 74 2e 20 41 20 70 72 6f 63 65 persist. A proce
8000: 73 73 0a 20 20 2a 2a 20 64 6f 65 73 20 6e 6f 74 ss. ** does not
8010: 20 68 61 76 65 20 74 6f 20 6f 62 74 61 69 6e 20 have to obtain
8020: 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 a RESERVED lock
8030: 6f 6e 20 74 68 65 20 77 61 79 20 74 6f 20 61 20 on the way to a
8040: 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 2e 0a 20 20 PENDING lock..
8050: 2a 2a 20 54 68 69 73 20 70 72 6f 70 65 72 74 79 ** This property
8060: 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 is used by the
8070: 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 72 6f algorithm for ro
8080: 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 6a 6f 75 lling back a jou
8090: 72 6e 61 6c 20 66 69 6c 65 0a 20 20 2a 2a 20 61 rnal file. ** a
80a0: 66 74 65 72 20 61 20 63 72 61 73 68 2e 0a 20 20 fter a crash..
80b0: 2a 2a 0a 20 20 2a 2a 20 41 6e 20 45 58 43 4c 55 **. ** An EXCLU
80c0: 53 49 56 45 20 6c 6f 63 6b 2c 20 6f 62 74 61 69 SIVE lock, obtai
80d0: 6e 65 64 20 61 66 74 65 72 20 61 20 50 45 4e 44 ned after a PEND
80e0: 49 4e 47 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 ING lock is held
80f0: 2c 20 69 73 0a 20 20 2a 2a 20 69 6d 70 6c 65 6d , is. ** implem
8100: 65 6e 74 65 64 20 62 79 20 6f 62 74 61 69 6e 69 ented by obtaini
8110: 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 ng a write-lock
8120: 6f 6e 20 74 68 65 20 65 6e 74 69 72 65 20 27 73 on the entire 's
8130: 68 61 72 65 64 20 62 79 74 65 0a 20 20 2a 2a 20 hared byte. **
8140: 72 61 6e 67 65 27 2e 20 53 69 6e 63 65 20 61 6c range'. Since al
8150: 6c 20 6f 74 68 65 72 20 6c 6f 63 6b 73 20 72 65 l other locks re
8160: 71 75 69 72 65 20 61 20 72 65 61 64 2d 6c 6f 63 quire a read-loc
8170: 6b 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 k on one of the
8180: 62 79 74 65 73 0a 20 20 2a 2a 20 77 69 74 68 69 bytes. ** withi
8190: 6e 20 74 68 69 73 20 72 61 6e 67 65 2c 20 74 68 n this range, th
81a0: 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 is ensures that
81b0: 6e 6f 20 6f 74 68 65 72 20 6c 6f 63 6b 73 20 61 no other locks a
81c0: 72 65 20 68 65 6c 64 20 6f 6e 20 74 68 65 0a 20 re held on the.
81d0: 20 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 0a 20 ** database. .
81e0: 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 72 65 61 **. ** The rea
81f0: 73 6f 6e 20 61 20 73 69 6e 67 6c 65 20 62 79 74 son a single byt
8200: 65 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 e cannot be used
8210: 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 instead of the
8220: 27 73 68 61 72 65 64 20 62 79 74 65 0a 20 20 2a 'shared byte. *
8230: 2a 20 72 61 6e 67 65 27 20 69 73 20 74 68 61 74 * range' is that
8240: 20 73 6f 6d 65 20 76 65 72 73 69 6f 6e 73 20 6f some versions o
8250: 66 20 77 69 6e 64 6f 77 73 20 64 6f 20 6e 6f 74 f windows do not
8260: 20 73 75 70 70 6f 72 74 20 72 65 61 64 2d 6c 6f support read-lo
8270: 63 6b 73 2e 20 42 79 0a 20 20 2a 2a 20 6c 6f 63 cks. By. ** loc
8280: 6b 69 6e 67 20 61 20 72 61 6e 64 6f 6d 20 62 79 king a random by
8290: 74 65 20 66 72 6f 6d 20 61 20 72 61 6e 67 65 2c te from a range,
82a0: 20 63 6f 6e 63 75 72 72 65 6e 74 20 53 48 41 52 concurrent SHAR
82b0: 45 44 20 6c 6f 63 6b 73 20 6d 61 79 20 65 78 69 ED locks may exi
82c0: 73 74 0a 20 20 2a 2a 20 65 76 65 6e 20 69 66 20 st. ** even if
82d0: 74 68 65 20 6c 6f 63 6b 69 6e 67 20 70 72 69 6d the locking prim
82e0: 69 74 69 76 65 20 75 73 65 64 20 69 73 20 61 6c itive used is al
82f0: 77 61 79 73 20 61 20 77 72 69 74 65 2d 6c 6f 63 ways a write-loc
8300: 6b 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74 20 72 63 k.. */. int rc
8310: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
8320: 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 unixFile *pFile
8330: 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b = (unixFile*)id;
8340: 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f . unixInodeInfo
8350: 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 *pInode = pFile
8360: 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 73 74 72 75 ->pInode;. stru
8370: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 ct flock lock;.
8380: 20 69 6e 74 20 73 20 3d 20 30 3b 0a 20 20 69 6e int s = 0;. in
8390: 74 20 74 45 72 72 6e 6f 20 3d 20 30 3b 0a 0a 20 t tErrno = 0;..
83a0: 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 assert( pFile )
83b0: 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c 4f ;. OSTRACE(("LO
83c0: 43 4b 20 20 20 20 25 64 20 25 73 20 77 61 73 20 CK %d %s was
83d0: 25 73 28 25 73 2c 25 64 29 20 70 69 64 3d 25 64 %s(%s,%d) pid=%d
83e0: 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 6c (unix)\n", pFil
83f0: 65 2d 3e 68 2c 0a 20 20 20 20 20 20 61 7a 46 69 e->h,. azFi
8400: 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b leLock(eFileLock
8410: 29 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 70 46 ), azFileLock(pF
8420: 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29 2c ile->eFileLock),
8430: 0a 20 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f 63 . azFileLoc
8440: 6b 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c k(pInode->eFileL
8450: 6f 63 6b 29 2c 20 70 49 6e 6f 64 65 2d 3e 6e 53 ock), pInode->nS
8460: 68 61 72 65 64 20 2c 20 67 65 74 70 69 64 28 29 hared , getpid()
8470: 29 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 ));.. /* If the
8480: 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 61 20 re is already a
8490: 6c 6f 63 6b 20 6f 66 20 74 68 69 73 20 74 79 70 lock of this typ
84a0: 65 20 6f 72 20 6d 6f 72 65 20 72 65 73 74 72 69 e or more restri
84b0: 63 74 69 76 65 20 6f 6e 20 74 68 65 0a 20 20 2a ctive on the. *
84c0: 2a 20 75 6e 69 78 46 69 6c 65 2c 20 64 6f 20 6e * unixFile, do n
84d0: 6f 74 68 69 6e 67 2e 20 44 6f 6e 27 74 20 75 73 othing. Don't us
84e0: 65 20 74 68 65 20 65 6e 64 5f 6c 6f 63 6b 3a 20 e the end_lock:
84f0: 65 78 69 74 20 70 61 74 68 2c 20 61 73 0a 20 20 exit path, as.
8500: 2a 2a 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 ** unixEnterMute
8510: 78 28 29 20 68 61 73 6e 27 74 20 62 65 65 6e 20 x() hasn't been
8520: 63 61 6c 6c 65 64 20 79 65 74 2e 0a 20 20 2a 2f called yet.. */
8530: 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 . if( pFile->eF
8540: 69 6c 65 4c 6f 63 6b 3e 3d 65 46 69 6c 65 4c 6f ileLock>=eFileLo
8550: 63 6b 20 29 7b 0a 20 20 20 20 4f 53 54 52 41 43 ck ){. OSTRAC
8560: 45 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 E(("LOCK %d %
8570: 73 20 6f 6b 20 28 61 6c 72 65 61 64 79 20 68 65 s ok (already he
8580: 6c 64 29 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 ld) (unix)\n", p
8590: 46 69 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20 20 File->h,.
85a0: 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 azFileLock(
85b0: 65 46 69 6c 65 4c 6f 63 6b 29 29 29 3b 0a 20 20 eFileLock)));.
85c0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
85d0: 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 OK;. }.. /* Ma
85e0: 6b 65 20 73 75 72 65 20 74 68 65 20 6c 6f 63 6b ke sure the lock
85f0: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 ing sequence is
8600: 63 6f 72 72 65 63 74 2e 0a 20 20 2a 2a 20 20 28 correct.. ** (
8610: 31 29 20 57 65 20 6e 65 76 65 72 20 6d 6f 76 65 1) We never move
8620: 20 66 72 6f 6d 20 75 6e 6c 6f 63 6b 65 64 20 74 from unlocked t
8630: 6f 20 61 6e 79 74 68 69 6e 67 20 68 69 67 68 65 o anything highe
8640: 72 20 74 68 61 6e 20 73 68 61 72 65 64 20 6c 6f r than shared lo
8650: 63 6b 2e 0a 20 20 2a 2a 20 20 28 32 29 20 53 51 ck.. ** (2) SQ
8660: 4c 69 74 65 20 6e 65 76 65 72 20 65 78 70 6c 69 Lite never expli
8670: 63 69 74 6c 79 20 72 65 71 75 65 73 74 73 20 61 citly requests a
8680: 20 70 65 6e 64 69 67 20 6c 6f 63 6b 2e 0a 20 20 pendig lock..
8690: 2a 2a 20 20 28 33 29 20 41 20 73 68 61 72 65 64 ** (3) A shared
86a0: 20 6c 6f 63 6b 20 69 73 20 61 6c 77 61 79 73 20 lock is always
86b0: 68 65 6c 64 20 77 68 65 6e 20 61 20 72 65 73 65 held when a rese
86c0: 72 76 65 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 rve lock is requ
86d0: 65 73 74 65 64 2e 0a 20 20 2a 2f 0a 20 20 61 73 ested.. */. as
86e0: 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 65 46 69 sert( pFile->eFi
86f0: 6c 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f 43 4b 20 leLock!=NO_LOCK
8700: 7c 7c 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 || eFileLock==SH
8710: 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 ARED_LOCK );. a
8720: 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b ssert( eFileLock
8730: 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 29 !=PENDING_LOCK )
8740: 3b 0a 20 20 61 73 73 65 72 74 28 20 65 46 69 6c ;. assert( eFil
8750: 65 4c 6f 63 6b 21 3d 52 45 53 45 52 56 45 44 5f eLock!=RESERVED_
8760: 4c 4f 43 4b 20 7c 7c 20 70 46 69 6c 65 2d 3e 65 LOCK || pFile->e
8770: 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 FileLock==SHARED
8780: 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f 2a 20 54 _LOCK );.. /* T
8790: 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e 65 65 his mutex is nee
87a0: 64 65 64 20 62 65 63 61 75 73 65 20 70 46 69 6c ded because pFil
87b0: 65 2d 3e 70 49 6e 6f 64 65 20 69 73 20 73 68 61 e->pInode is sha
87c0: 72 65 64 20 61 63 72 6f 73 73 20 74 68 72 65 61 red across threa
87d0: 64 73 0a 20 20 2a 2f 0a 20 20 75 6e 69 78 45 6e ds. */. unixEn
87e0: 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 49 terMutex();. pI
87f0: 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 node = pFile->pI
8800: 6e 6f 64 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 73 node;.. /* If s
8810: 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69 6e 67 ome thread using
8820: 20 74 68 69 73 20 50 49 44 20 68 61 73 20 61 20 this PID has a
8830: 6c 6f 63 6b 20 76 69 61 20 61 20 64 69 66 66 65 lock via a diffe
8840: 72 65 6e 74 20 75 6e 69 78 46 69 6c 65 2a 0a 20 rent unixFile*.
8850: 20 2a 2a 20 68 61 6e 64 6c 65 20 74 68 61 74 20 ** handle that
8860: 70 72 65 63 6c 75 64 65 73 20 74 68 65 20 72 65 precludes the re
8870: 71 75 65 73 74 65 64 20 6c 6f 63 6b 2c 20 72 65 quested lock, re
8880: 74 75 72 6e 20 42 55 53 59 2e 0a 20 20 2a 2f 0a turn BUSY.. */.
8890: 20 20 69 66 28 20 28 70 46 69 6c 65 2d 3e 65 46 if( (pFile->eF
88a0: 69 6c 65 4c 6f 63 6b 21 3d 70 49 6e 6f 64 65 2d ileLock!=pInode-
88b0: 3e 65 46 69 6c 65 4c 6f 63 6b 20 26 26 20 0a 20 >eFileLock && .
88c0: 20 20 20 20 20 20 20 20 20 28 70 49 6e 6f 64 65 (pInode
88d0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 50 45 4e ->eFileLock>=PEN
88e0: 44 49 4e 47 5f 4c 4f 43 4b 20 7c 7c 20 65 46 69 DING_LOCK || eFi
88f0: 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f leLock>SHARED_LO
8900: 43 4b 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 63 CK)). ){. rc
8910: 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a = SQLITE_BUSY;.
8920: 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 goto end_loc
8930: 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 k;. }.. /* If
8940: 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69 73 a SHARED lock is
8950: 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e 64 20 requested, and
8960: 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69 6e some thread usin
8970: 67 20 74 68 69 73 20 50 49 44 20 61 6c 72 65 61 g this PID alrea
8980: 64 79 0a 20 20 2a 2a 20 68 61 73 20 61 20 53 48 dy. ** has a SH
8990: 41 52 45 44 20 6f 72 20 52 45 53 45 52 56 45 44 ARED or RESERVED
89a0: 20 6c 6f 63 6b 2c 20 74 68 65 6e 20 69 6e 63 72 lock, then incr
89b0: 65 6d 65 6e 74 20 72 65 66 65 72 65 6e 63 65 20 ement reference
89c0: 63 6f 75 6e 74 73 20 61 6e 64 0a 20 20 2a 2a 20 counts and. **
89d0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
89e0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 46 69 .. */. if( eFi
89f0: 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c leLock==SHARED_L
8a00: 4f 43 4b 20 26 26 20 0a 20 20 20 20 20 20 28 70 OCK && . (p
8a10: 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b Inode->eFileLock
8a20: 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c ==SHARED_LOCK ||
8a30: 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f pInode->eFileLo
8a40: 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 ck==RESERVED_LOC
8a50: 4b 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 K) ){. assert
8a60: 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 ( eFileLock==SHA
8a70: 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 RED_LOCK );.
8a80: 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 65 assert( pFile->e
8a90: 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20 FileLock==0 );.
8aa0: 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
8ab0: 65 2d 3e 6e 53 68 61 72 65 64 3e 30 20 29 3b 0a e->nShared>0 );.
8ac0: 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 pFile->eFile
8ad0: 4c 6f 63 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f Lock = SHARED_LO
8ae0: 43 4b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e CK;. pInode->
8af0: 6e 53 68 61 72 65 64 2b 2b 3b 0a 20 20 20 20 70 nShared++;. p
8b00: 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a Inode->nLock++;.
8b10: 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 goto end_loc
8b20: 6b 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 41 20 k;. }... /* A
8b30: 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69 73 20 PENDING lock is
8b40: 6e 65 65 64 65 64 20 62 65 66 6f 72 65 20 61 63 needed before ac
8b50: 71 75 69 72 69 6e 67 20 61 20 53 48 41 52 45 44 quiring a SHARED
8b60: 20 6c 6f 63 6b 20 61 6e 64 20 62 65 66 6f 72 65 lock and before
8b70: 0a 20 20 2a 2a 20 61 63 71 75 69 72 69 6e 67 20 . ** acquiring
8b80: 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 an EXCLUSIVE loc
8b90: 6b 2e 20 20 46 6f 72 20 74 68 65 20 53 48 41 52 k. For the SHAR
8ba0: 45 44 20 6c 6f 63 6b 2c 20 74 68 65 20 50 45 4e ED lock, the PEN
8bb0: 44 49 4e 47 20 77 69 6c 6c 0a 20 20 2a 2a 20 62 DING will. ** b
8bc0: 65 20 72 65 6c 65 61 73 65 64 2e 0a 20 20 2a 2f e released.. */
8bd0: 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 . lock.l_len =
8be0: 31 4c 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 1L;. lock.l_whe
8bf0: 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a nce = SEEK_SET;.
8c00: 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d if( eFileLock=
8c10: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 0a 20 20 =SHARED_LOCK .
8c20: 20 20 20 20 7c 7c 20 28 65 46 69 6c 65 4c 6f 63 || (eFileLoc
8c30: 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 k==EXCLUSIVE_LOC
8c40: 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 46 69 6c K && pFile->eFil
8c50: 65 4c 6f 63 6b 3c 50 45 4e 44 49 4e 47 5f 4c 4f eLock<PENDING_LO
8c60: 43 4b 29 0a 20 20 29 7b 0a 20 20 20 20 6c 6f 63 CK). ){. loc
8c70: 6b 2e 6c 5f 74 79 70 65 20 3d 20 28 65 46 69 6c k.l_type = (eFil
8c80: 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
8c90: 43 4b 3f 46 5f 52 44 4c 43 4b 3a 46 5f 57 52 4c CK?F_RDLCK:F_WRL
8ca0: 43 4b 29 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f CK);. lock.l_
8cb0: 73 74 61 72 74 20 3d 20 50 45 4e 44 49 4e 47 5f start = PENDING_
8cc0: 42 59 54 45 3b 0a 20 20 20 20 73 20 3d 20 66 63 BYTE;. s = fc
8cd0: 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 46 5f ntl(pFile->h, F_
8ce0: 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b 0a 20 SETLK, &lock);.
8cf0: 20 20 20 69 66 28 20 73 3d 3d 28 2d 31 29 20 29 if( s==(-1) )
8d00: 7b 0a 20 20 20 20 20 20 74 45 72 72 6e 6f 20 3d {. tErrno =
8d10: 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 63 errno;. rc
8d20: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 = sqliteErrorFr
8d30: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 omPosixError(tEr
8d40: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 rno, SQLITE_IOER
8d50: 52 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69 R_LOCK);. i
8d60: 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 f( IS_LOCK_ERROR
8d70: 28 72 63 29 20 29 7b 0a 20 20 20 20 20 20 20 20 (rc) ){.
8d80: 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f pFile->lastErrno
8d90: 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 20 20 20 20 = tErrno;.
8da0: 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e }. goto en
8db0: 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 d_lock;. }.
8dc0: 7d 0a 0a 0a 20 20 2f 2a 20 49 66 20 63 6f 6e 74 }... /* If cont
8dd0: 72 6f 6c 20 67 65 74 73 20 74 6f 20 74 68 69 73 rol gets to this
8de0: 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 61 63 74 point, then act
8df0: 75 61 6c 6c 79 20 67 6f 20 61 68 65 61 64 20 61 ually go ahead a
8e00: 6e 64 20 6d 61 6b 65 0a 20 20 2a 2a 20 6f 70 65 nd make. ** ope
8e10: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 63 61 rating system ca
8e20: 6c 6c 73 20 66 6f 72 20 74 68 65 20 73 70 65 63 lls for the spec
8e30: 69 66 69 65 64 20 6c 6f 63 6b 2e 0a 20 20 2a 2f ified lock.. */
8e40: 0a 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b . if( eFileLock
8e50: 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b ==SHARED_LOCK ){
8e60: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e . assert( pIn
8e70: 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3d 3d 30 20 ode->nShared==0
8e80: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
8e90: 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b Inode->eFileLock
8ea0: 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4e ==0 );.. /* N
8eb0: 6f 77 20 67 65 74 20 74 68 65 20 72 65 61 64 2d ow get the read-
8ec0: 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b lock */. lock
8ed0: 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 45 .l_start = SHARE
8ee0: 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 6c 6f 63 D_FIRST;. loc
8ef0: 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 k.l_len = SHARED
8f00: 5f 53 49 5a 45 3b 0a 20 20 20 20 69 66 28 20 28 _SIZE;. if( (
8f10: 73 20 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d s = fcntl(pFile-
8f20: 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f >h, F_SETLK, &lo
8f30: 63 6b 29 29 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 ck))==(-1) ){.
8f40: 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 tErrno = err
8f50: 6e 6f 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a no;. }. /*
8f60: 20 44 72 6f 70 20 74 68 65 20 74 65 6d 70 6f 72 Drop the tempor
8f70: 61 72 79 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b ary PENDING lock
8f80: 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 */. lock.l_s
8f90: 74 61 72 74 20 3d 20 50 45 4e 44 49 4e 47 5f 42 tart = PENDING_B
8fa0: 59 54 45 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f YTE;. lock.l_
8fb0: 6c 65 6e 20 3d 20 31 4c 3b 0a 20 20 20 20 6c 6f len = 1L;. lo
8fc0: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e ck.l_type = F_UN
8fd0: 4c 43 4b 3b 0a 20 20 20 20 69 66 28 20 66 63 6e LCK;. if( fcn
8fe0: 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 46 5f 53 tl(pFile->h, F_S
8ff0: 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 21 3d 30 20 ETLK, &lock)!=0
9000: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 20 21 ){. if( s !
9010: 3d 20 2d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 = -1 ){.
9020: 2f 2a 20 54 68 69 73 20 63 6f 75 6c 64 20 68 61 /* This could ha
9030: 70 70 65 6e 20 77 69 74 68 20 61 20 6e 65 74 77 ppen with a netw
9040: 6f 72 6b 20 6d 6f 75 6e 74 20 2a 2f 0a 20 20 20 ork mount */.
9050: 20 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 tErrno = er
9060: 72 6e 6f 3b 20 0a 20 20 20 20 20 20 20 20 72 63 rno; . rc
9070: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 = sqliteErrorFr
9080: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 omPosixError(tEr
9090: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 rno, SQLITE_IOER
90a0: 52 5f 55 4e 4c 4f 43 4b 29 3b 20 0a 20 20 20 20 R_UNLOCK); .
90b0: 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f if( IS_LOCK_
90c0: 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 ERROR(rc) ){.
90d0: 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 pFile->la
90e0: 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 72 6e 6f stErrno = tErrno
90f0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
9100: 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 goto end_loc
9110: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
9120: 0a 20 20 20 20 69 66 28 20 73 3d 3d 28 2d 31 29 . if( s==(-1)
9130: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
9140: 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f qliteErrorFromPo
9150: 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c sixError(tErrno,
9160: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f SQLITE_IOERR_LO
9170: 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 49 CK);. if( I
9180: 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 72 63 29 S_LOCK_ERROR(rc)
9190: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46 69 6c ){. pFil
91a0: 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 e->lastErrno = t
91b0: 45 72 72 6e 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 Errno;. }.
91c0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
91d0: 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
91e0: 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a = SHARED_LOCK;.
91f0: 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c pInode->nL
9200: 6f 63 6b 2b 2b 3b 0a 20 20 20 20 20 20 70 49 6e ock++;. pIn
9210: 6f 64 65 2d 3e 6e 53 68 61 72 65 64 20 3d 20 31 ode->nShared = 1
9220: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 ;. }. }else
9230: 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 if( eFileLock==E
9240: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 XCLUSIVE_LOCK &&
9250: 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 pInode->nShared
9260: 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65 20 >1 ){. /* We
9270: 61 72 65 20 74 72 79 69 6e 67 20 66 6f 72 20 61 are trying for a
9280: 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b n exclusive lock
9290: 20 62 75 74 20 61 6e 6f 74 68 65 72 20 74 68 72 but another thr
92a0: 65 61 64 20 69 6e 20 74 68 69 73 0a 20 20 20 20 ead in this.
92b0: 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65 73 73 20 ** same process
92c0: 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 is still holding
92d0: 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20 a shared lock.
92e0: 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 */. rc = SQLI
92f0: 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65 6c 73 65 TE_BUSY;. }else
9300: 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 {. /* The req
9310: 75 65 73 74 20 77 61 73 20 66 6f 72 20 61 20 52 uest was for a R
9320: 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55 ESERVED or EXCLU
9330: 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49 74 20 69 SIVE lock. It i
9340: 73 0a 20 20 20 20 2a 2a 20 61 73 73 75 6d 65 64 s. ** assumed
9350: 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 61 that there is a
9360: 20 53 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 SHARED or great
9370: 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 er lock on the f
9380: 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c 72 65 61 ile. ** alrea
9390: 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 dy.. */. a
93a0: 73 73 65 72 74 28 20 30 21 3d 70 46 69 6c 65 2d ssert( 0!=pFile-
93b0: 3e 65 46 69 6c 65 4c 6f 63 6b 20 29 3b 0a 20 20 >eFileLock );.
93c0: 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 lock.l_type =
93d0: 46 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 73 77 69 F_WRLCK;. swi
93e0: 74 63 68 28 20 65 46 69 6c 65 4c 6f 63 6b 20 29 tch( eFileLock )
93f0: 7b 0a 20 20 20 20 20 20 63 61 73 65 20 52 45 53 {. case RES
9400: 45 52 56 45 44 5f 4c 4f 43 4b 3a 0a 20 20 20 20 ERVED_LOCK:.
9410: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 lock.l_start
9420: 20 3d 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 = RESERVED_BYTE
9430: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b ;. break;
9440: 0a 20 20 20 20 20 20 63 61 73 65 20 45 58 43 4c . case EXCL
9450: 55 53 49 56 45 5f 4c 4f 43 4b 3a 0a 20 20 20 20 USIVE_LOCK:.
9460: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 lock.l_start
9470: 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53 54 3b = SHARED_FIRST;
9480: 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f . lock.l_
9490: 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a len = SHARED_SIZ
94a0: 45 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b E;. break
94b0: 3b 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a ;. default:
94c0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
94d0: 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 20 0);. }. s
94e0: 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 = fcntl(pFile->h
94f0: 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b , F_SETLK, &lock
9500: 29 3b 0a 20 20 20 20 69 66 28 20 73 3d 3d 28 2d );. if( s==(-
9510: 31 29 20 29 7b 0a 20 20 20 20 20 20 74 45 72 72 1) ){. tErr
9520: 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 no = errno;.
9530: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45 72 72 rc = sqliteErr
9540: 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 orFromPosixError
9550: 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f (tErrno, SQLITE_
9560: 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 0a 20 20 20 IOERR_LOCK);.
9570: 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 if( IS_LOCK_E
9580: 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 20 RROR(rc) ){.
9590: 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 pFile->lastE
95a0: 72 72 6e 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 rrno = tErrno;.
95b0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
95c0: 0a 20 20 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 . ..#ifndef NDE
95d0: 42 55 47 0a 20 20 2f 2a 20 53 65 74 20 75 70 20 BUG. /* Set up
95e0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2d the transaction-
95f0: 63 6f 75 6e 74 65 72 20 63 68 61 6e 67 65 20 63 counter change c
9600: 68 65 63 6b 69 6e 67 20 66 6c 61 67 73 20 77 68 hecking flags wh
9610: 65 6e 0a 20 20 2a 2a 20 74 72 61 6e 73 69 74 69 en. ** transiti
9620: 6f 6e 69 6e 67 20 66 72 6f 6d 20 61 20 53 48 41 oning from a SHA
9630: 52 45 44 20 74 6f 20 61 20 52 45 53 45 52 56 45 RED to a RESERVE
9640: 44 20 6c 6f 63 6b 2e 20 20 54 68 65 20 63 68 61 D lock. The cha
9650: 6e 67 65 0a 20 20 2a 2a 20 66 72 6f 6d 20 53 48 nge. ** from SH
9660: 41 52 45 44 20 74 6f 20 52 45 53 45 52 56 45 44 ARED to RESERVED
9670: 20 6d 61 72 6b 73 20 74 68 65 20 62 65 67 69 6e marks the begin
9680: 6e 69 6e 67 20 6f 66 20 61 20 6e 6f 72 6d 61 6c ning of a normal
9690: 0a 20 20 2a 2a 20 77 72 69 74 65 20 6f 70 65 72 . ** write oper
96a0: 61 74 69 6f 6e 20 28 6e 6f 74 20 61 20 68 6f 74 ation (not a hot
96b0: 20 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 journal rollbac
96c0: 6b 29 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 k).. */. if( r
96d0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 20 c==SQLITE_OK.
96e0: 26 26 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c && pFile->eFileL
96f0: 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock<=SHARED_LOCK
9700: 0a 20 20 20 26 26 20 65 46 69 6c 65 4c 6f 63 6b . && eFileLock
9710: 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 0a ==RESERVED_LOCK.
9720: 20 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e ){. pFile->
9730: 74 72 61 6e 73 43 6e 74 72 43 68 6e 67 20 3d 20 transCntrChng =
9740: 30 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 64 62 0;. pFile->db
9750: 55 70 64 61 74 65 20 3d 20 30 3b 0a 20 20 20 20 Update = 0;.
9760: 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 pFile->inNormalW
9770: 72 69 74 65 20 3d 20 31 3b 0a 20 20 7d 0a 23 65 rite = 1;. }.#e
9780: 6e 64 69 66 0a 0a 0a 20 20 69 66 28 20 72 63 3d ndif... if( rc=
9790: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
97a0: 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f pFile->eFileLo
97b0: 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a ck = eFileLock;.
97c0: 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c pInode->eFil
97d0: 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 eLock = eFileLoc
97e0: 6b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 65 k;. }else if( e
97f0: 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 FileLock==EXCLUS
9800: 49 56 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 IVE_LOCK ){.
9810: 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
9820: 20 3d 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b = PENDING_LOCK;
9830: 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 69 . pInode->eFi
9840: 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44 49 4e 47 leLock = PENDING
9850: 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 0a 65 6e 64 5f _LOCK;. }..end_
9860: 6c 6f 63 6b 3a 0a 20 20 75 6e 69 78 4c 65 61 76 lock:. unixLeav
9870: 65 4d 75 74 65 78 28 29 3b 0a 20 20 4f 53 54 52 eMutex();. OSTR
9880: 41 43 45 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 ACE(("LOCK %d
9890: 20 25 73 20 25 73 20 28 75 6e 69 78 29 5c 6e 22 %s %s (unix)\n"
98a0: 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 61 7a 46 69 , pFile->h, azFi
98b0: 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b leLock(eFileLock
98c0: 29 2c 20 0a 20 20 20 20 20 20 72 63 3d 3d 53 51 ), . rc==SQ
98d0: 4c 49 54 45 5f 4f 4b 20 3f 20 22 6f 6b 22 20 3a LITE_OK ? "ok" :
98e0: 20 22 66 61 69 6c 65 64 22 29 29 3b 0a 20 20 72 "failed"));. r
98f0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
9900: 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 66 69 6c ** Close all fil
9910: 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 61 63 e descriptors ac
9920: 63 75 6d 75 61 74 65 64 20 69 6e 20 74 68 65 20 cumuated in the
9930: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 2d 3e 70 unixInodeInfo->p
9940: 55 6e 75 73 65 64 20 6c 69 73 74 2e 0a 2a 2a 20 Unused list..**
9950: 49 66 20 61 6c 6c 20 73 75 63 68 20 66 69 6c 65 If all such file
9960: 20 64 65 73 63 72 69 70 74 6f 72 73 20 61 72 65 descriptors are
9970: 20 63 6c 6f 73 65 64 20 77 69 74 68 6f 75 74 20 closed without
9980: 65 72 72 6f 72 2c 20 74 68 65 20 6c 69 73 74 20 error, the list
9990: 69 73 0a 2a 2a 20 63 6c 65 61 72 65 64 20 61 6e is.** cleared an
99a0: 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 d SQLITE_OK retu
99b0: 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 rned..**.** Othe
99c0: 72 77 69 73 65 2c 20 69 66 20 61 6e 20 65 72 72 rwise, if an err
99d0: 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 or occurs, then
99e0: 73 75 63 63 65 73 73 66 75 6c 6c 79 20 63 6c 6f successfully clo
99f0: 73 65 64 20 66 69 6c 65 20 64 65 73 63 72 69 70 sed file descrip
9a00: 74 6f 72 0a 2a 2a 20 65 6e 74 72 69 65 73 20 61 tor.** entries a
9a10: 72 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 re removed from
9a20: 74 68 65 20 6c 69 73 74 2c 20 61 6e 64 20 53 51 the list, and SQ
9a30: 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 LITE_IOERR_CLOSE
9a40: 20 72 65 74 75 72 6e 65 64 2e 20 0a 2a 2a 20 6e returned. .** n
9a50: 6f 74 20 64 65 6c 65 74 65 64 20 61 6e 64 20 53 ot deleted and S
9a60: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 QLITE_IOERR_CLOS
9a70: 45 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 20 0a E returned..*/ .
9a80: 73 74 61 74 69 63 20 69 6e 74 20 63 6c 6f 73 65 static int close
9a90: 50 65 6e 64 69 6e 67 46 64 73 28 75 6e 69 78 46 PendingFds(unixF
9aa0: 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 69 ile *pFile){. i
9ab0: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
9ac0: 4b 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e K;. unixInodeIn
9ad0: 66 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69 fo *pInode = pFi
9ae0: 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55 6e le->pInode;. Un
9af0: 69 78 55 6e 75 73 65 64 46 64 20 2a 70 45 72 72 ixUnusedFd *pErr
9b00: 6f 72 20 3d 20 30 3b 0a 20 20 55 6e 69 78 55 6e or = 0;. UnixUn
9b10: 75 73 65 64 46 64 20 2a 70 3b 0a 20 20 55 6e 69 usedFd *p;. Uni
9b20: 78 55 6e 75 73 65 64 46 64 20 2a 70 4e 65 78 74 xUnusedFd *pNext
9b30: 3b 0a 20 20 66 6f 72 28 70 3d 70 49 6e 6f 64 65 ;. for(p=pInode
9b40: 2d 3e 70 55 6e 75 73 65 64 3b 20 70 3b 20 70 3d ->pUnused; p; p=
9b50: 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e 65 78 pNext){. pNex
9b60: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 t = p->pNext;.
9b70: 20 20 69 66 28 20 63 6c 6f 73 65 28 70 2d 3e 66 if( close(p->f
9b80: 64 29 20 29 7b 0a 20 20 20 20 20 20 70 46 69 6c d) ){. pFil
9b90: 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 e->lastErrno = e
9ba0: 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 63 20 3d rrno;. rc =
9bb0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c SQLITE_IOERR_CL
9bc0: 4f 53 45 3b 0a 20 20 20 20 20 20 70 2d 3e 70 4e OSE;. p->pN
9bd0: 65 78 74 20 3d 20 70 45 72 72 6f 72 3b 0a 20 20 ext = pError;.
9be0: 20 20 20 20 70 45 72 72 6f 72 20 3d 20 70 3b 0a pError = p;.
9bf0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
9c00: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 sqlite3_free(p)
9c10: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70 49 ;. }. }. pI
9c20: 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 20 3d 20 node->pUnused =
9c30: 70 45 72 72 6f 72 3b 0a 20 20 72 65 74 75 72 6e pError;. return
9c40: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 rc;.}../*.** Ad
9c50: 64 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 d the file descr
9c60: 69 70 74 6f 72 20 75 73 65 64 20 62 79 20 66 69 iptor used by fi
9c70: 6c 65 20 68 61 6e 64 6c 65 20 70 46 69 6c 65 20 le handle pFile
9c80: 74 6f 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e to the correspon
9c90: 64 69 6e 67 0a 2a 2a 20 70 55 6e 75 73 65 64 20 ding.** pUnused
9ca0: 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 list..*/.static
9cb0: 76 6f 69 64 20 73 65 74 50 65 6e 64 69 6e 67 46 void setPendingF
9cc0: 64 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c d(unixFile *pFil
9cd0: 65 29 7b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 e){. unixInodeI
9ce0: 6e 66 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 nfo *pInode = pF
9cf0: 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55 ile->pInode;. U
9d00: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 20 3d nixUnusedFd *p =
9d10: 20 70 46 69 6c 65 2d 3e 70 55 6e 75 73 65 64 3b pFile->pUnused;
9d20: 0a 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 49 . p->pNext = pI
9d30: 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 3b 0a 20 node->pUnused;.
9d40: 20 70 49 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 pInode->pUnused
9d50: 20 3d 20 70 3b 0a 20 20 70 46 69 6c 65 2d 3e 68 = p;. pFile->h
9d60: 20 3d 20 2d 31 3b 0a 20 20 70 46 69 6c 65 2d 3e = -1;. pFile->
9d70: 70 55 6e 75 73 65 64 20 3d 20 30 3b 0a 7d 0a 0a pUnused = 0;.}..
9d80: 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 /*.** Lower the
9d90: 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e locking level on
9da0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
9db0: 20 70 46 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c pFile to eFileL
9dc0: 6f 63 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a ock. eFileLock.
9dd0: 2a 2a 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 ** must be eithe
9de0: 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 r NO_LOCK or SHA
9df0: 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 RED_LOCK..**.**
9e00: 49 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c If the locking l
9e10: 65 76 65 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 evel of the file
9e20: 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 61 descriptor is a
9e30: 6c 72 65 61 64 79 20 61 74 20 6f 72 20 62 65 6c lready at or bel
9e40: 6f 77 0a 2a 2a 20 74 68 65 20 72 65 71 75 65 73 ow.** the reques
9e50: 74 65 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 ted locking leve
9e60: 6c 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 l, this routine
9e70: 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 20 0a is a no-op..** .
9e80: 2a 2a 20 49 66 20 68 61 6e 64 6c 65 4e 46 53 55 ** If handleNFSU
9e90: 6e 6c 6f 63 6b 20 69 73 20 74 72 75 65 2c 20 74 nlock is true, t
9ea0: 68 65 6e 20 6f 6e 20 64 6f 77 6e 67 72 61 64 69 hen on downgradi
9eb0: 6e 67 20 61 6e 20 45 58 43 4c 55 53 49 56 45 5f ng an EXCLUSIVE_
9ec0: 4c 4f 43 4b 20 74 6f 20 53 48 41 52 45 44 0a 2a LOCK to SHARED.*
9ed0: 2a 20 74 68 65 20 62 79 74 65 20 72 61 6e 67 65 * the byte range
9ee0: 20 69 73 20 64 69 76 69 64 65 64 20 69 6e 74 6f is divided into
9ef0: 20 32 20 70 61 72 74 73 20 61 6e 64 20 74 68 65 2 parts and the
9f00: 20 66 69 72 73 74 20 70 61 72 74 20 69 73 20 75 first part is u
9f10: 6e 6c 6f 63 6b 65 64 20 74 68 65 6e 0a 2a 2a 20 nlocked then.**
9f20: 73 65 74 20 74 6f 20 61 20 72 65 61 64 20 6c 6f set to a read lo
9f30: 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 6f 74 68 ck, then the oth
9f40: 65 72 20 70 61 72 74 20 69 73 20 73 69 6d 70 6c er part is simpl
9f50: 79 20 75 6e 6c 6f 63 6b 65 64 2e 20 20 54 68 69 y unlocked. Thi
9f60: 73 20 77 6f 72 6b 73 20 0a 2a 2a 20 61 72 6f 75 s works .** arou
9f70: 6e 64 20 61 20 62 75 67 20 69 6e 20 42 53 44 20 nd a bug in BSD
9f80: 4e 46 53 20 6c 6f 63 6b 64 20 28 61 6c 73 6f 20 NFS lockd (also
9f90: 73 65 65 6e 20 6f 6e 20 4d 61 63 4f 53 58 20 31 seen on MacOSX 1
9fa0: 30 2e 33 2b 29 20 74 68 61 74 20 66 61 69 6c 73 0.3+) that fails
9fb0: 20 74 6f 20 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 to .** remove t
9fc0: 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e he write lock on
9fd0: 20 61 20 72 65 67 69 6f 6e 20 77 68 65 6e 20 61 a region when a
9fe0: 20 72 65 61 64 20 6c 6f 63 6b 20 69 73 20 73 65 read lock is se
9ff0: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
a000: 20 5f 70 6f 73 69 78 55 6e 6c 6f 63 6b 28 73 71 _posixUnlock(sq
a010: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
a020: 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 2c 20 69 int eFileLock, i
a030: 6e 74 20 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f nt handleNFSUnlo
a040: 63 6b 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 ck){. unixFile
a050: 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 *pFile = (unixFi
a060: 6c 65 2a 29 69 64 3b 0a 20 20 75 6e 69 78 49 6e le*)id;. unixIn
a070: 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b odeInfo *pInode;
a080: 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 . struct flock
a090: 6c 6f 63 6b 3b 0a 20 20 69 6e 74 20 72 63 20 3d lock;. int rc =
a0a0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e SQLITE_OK;. in
a0b0: 74 20 68 3b 0a 20 20 69 6e 74 20 74 45 72 72 6e t h;. int tErrn
a0c0: 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o;
a0d0: 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 /* Error
a0e0: 20 63 6f 64 65 20 66 72 6f 6d 20 73 79 73 74 65 code from syste
a0f0: 6d 20 63 61 6c 6c 20 65 72 72 6f 72 73 20 2a 2f m call errors */
a100: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c .. assert( pFil
a110: 65 20 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 e );. OSTRACE((
a120: 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25 64 20 77 "UNLOCK %d %d w
a130: 61 73 20 25 64 28 25 64 2c 25 64 29 20 70 69 64 as %d(%d,%d) pid
a140: 3d 25 64 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 =%d (unix)\n", p
a150: 46 69 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f File->h, eFileLo
a160: 63 6b 2c 0a 20 20 20 20 20 20 70 46 69 6c 65 2d ck,. pFile-
a170: 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 69 6c >eFileLock, pFil
a180: 65 2d 3e 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 e->pInode->eFile
a190: 4c 6f 63 6b 2c 20 70 46 69 6c 65 2d 3e 70 49 6e Lock, pFile->pIn
a1a0: 6f 64 65 2d 3e 6e 53 68 61 72 65 64 2c 0a 20 20 ode->nShared,.
a1b0: 20 20 20 20 67 65 74 70 69 64 28 29 29 29 3b 0a getpid()));.
a1c0: 0a 20 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 . assert( eFile
a1d0: 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 Lock<=SHARED_LOC
a1e0: 4b 20 29 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 K );. if( pFile
a1f0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3c 3d 65 46 69 ->eFileLock<=eFi
a200: 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 72 65 leLock ){. re
a210: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
a220: 20 20 7d 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d }. unixEnterM
a230: 75 74 65 78 28 29 3b 0a 20 20 68 20 3d 20 70 46 utex();. h = pF
a240: 69 6c 65 2d 3e 68 3b 0a 20 20 70 49 6e 6f 64 65 ile->h;. pInode
a250: 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 = pFile->pInode
a260: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f ;. assert( pIno
a270: 64 65 2d 3e 6e 53 68 61 72 65 64 21 3d 30 20 29 de->nShared!=0 )
a280: 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 ;. if( pFile->e
a290: 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f FileLock>SHARED_
a2a0: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 LOCK ){. asse
a2b0: 72 74 28 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c rt( pInode->eFil
a2c0: 65 4c 6f 63 6b 3d 3d 70 46 69 6c 65 2d 3e 65 46 eLock==pFile->eF
a2d0: 69 6c 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 53 ileLock );. S
a2e0: 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 imulateIOErrorBe
a2f0: 6e 69 67 6e 28 31 29 3b 0a 20 20 20 20 53 69 6d nign(1);. Sim
a300: 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 68 3d ulateIOError( h=
a310: 28 2d 31 29 20 29 0a 20 20 20 20 53 69 6d 75 6c (-1) ). Simul
a320: 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e ateIOErrorBenign
a330: 28 30 29 3b 0a 0a 23 69 66 6e 64 65 66 20 4e 44 (0);..#ifndef ND
a340: 45 42 55 47 0a 20 20 20 20 2f 2a 20 57 68 65 6e EBUG. /* When
a350: 20 72 65 64 75 63 69 6e 67 20 61 20 6c 6f 63 6b reducing a lock
a360: 20 73 75 63 68 20 74 68 61 74 20 6f 74 68 65 72 such that other
a370: 20 70 72 6f 63 65 73 73 65 73 20 63 61 6e 20 73 processes can s
a380: 74 61 72 74 0a 20 20 20 20 2a 2a 20 72 65 61 64 tart. ** read
a390: 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 ing the database
a3a0: 20 66 69 6c 65 20 61 67 61 69 6e 2c 20 6d 61 6b file again, mak
a3b0: 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 0a e sure that the.
a3c0: 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 ** transacti
a3d0: 6f 6e 20 63 6f 75 6e 74 65 72 20 77 61 73 20 75 on counter was u
a3e0: 70 64 61 74 65 64 20 69 66 20 61 6e 79 20 70 61 pdated if any pa
a3f0: 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 rt of the databa
a400: 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 63 se. ** file c
a410: 68 61 6e 67 65 64 2e 20 20 49 66 20 74 68 65 20 hanged. If the
a420: 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e transaction coun
a430: 74 65 72 20 69 73 20 6e 6f 74 20 75 70 64 61 74 ter is not updat
a440: 65 64 2c 0a 20 20 20 20 2a 2a 20 6f 74 68 65 72 ed,. ** other
a450: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 6f 20 connections to
a460: 74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 6d 69 the same file mi
a470: 67 68 74 20 6e 6f 74 20 72 65 61 6c 69 7a 65 20 ght not realize
a480: 74 68 61 74 0a 20 20 20 20 2a 2a 20 74 68 65 20 that. ** the
a490: 66 69 6c 65 20 68 61 73 20 63 68 61 6e 67 65 64 file has changed
a4a0: 20 61 6e 64 20 68 65 6e 63 65 20 6d 69 67 68 74 and hence might
a4b0: 20 6e 6f 74 20 6b 6e 6f 77 20 74 6f 20 66 6c 75 not know to flu
a4c0: 73 68 20 74 68 65 69 72 0a 20 20 20 20 2a 2a 20 sh their. **
a4d0: 63 61 63 68 65 2e 20 20 54 68 65 20 75 73 65 20 cache. The use
a4e0: 6f 66 20 61 20 73 74 61 6c 65 20 63 61 63 68 65 of a stale cache
a4f0: 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 64 61 74 can lead to dat
a500: 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e abase corruption
a510: 2e 0a 20 20 20 20 2a 2f 0a 23 69 66 20 30 0a 20 .. */.#if 0.
a520: 20 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 assert( pFile
a530: 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 65 3d ->inNormalWrite=
a540: 3d 30 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 =0. || p
a550: 46 69 6c 65 2d 3e 64 62 55 70 64 61 74 65 3d 3d File->dbUpdate==
a560: 30 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 46 0. || pF
a570: 69 6c 65 2d 3e 74 72 61 6e 73 43 6e 74 72 43 68 ile->transCntrCh
a580: 6e 67 3d 3d 31 20 29 3b 0a 23 65 6e 64 69 66 0a ng==1 );.#endif.
a590: 20 20 20 20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 pFile->inNor
a5a0: 6d 61 6c 57 72 69 74 65 20 3d 20 30 3b 0a 23 65 malWrite = 0;.#e
a5b0: 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 64 6f 77 ndif.. /* dow
a5c0: 6e 67 72 61 64 69 6e 67 20 74 6f 20 61 20 73 68 ngrading to a sh
a5d0: 61 72 65 64 20 6c 6f 63 6b 20 6f 6e 20 4e 46 53 ared lock on NFS
a5e0: 20 69 6e 76 6f 6c 76 65 73 20 63 6c 65 61 72 69 involves cleari
a5f0: 6e 67 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 ng the write loc
a600: 6b 0a 20 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 k. ** before
a610: 65 73 74 61 62 6c 69 73 68 69 6e 67 20 74 68 65 establishing the
a620: 20 72 65 61 64 6c 6f 63 6b 20 2d 20 74 6f 20 61 readlock - to a
a630: 76 6f 69 64 20 61 20 72 61 63 65 20 63 6f 6e 64 void a race cond
a640: 69 74 69 6f 6e 20 77 65 20 64 6f 77 6e 67 72 61 ition we downgra
a650: 64 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f de. ** the lo
a660: 63 6b 20 69 6e 20 32 20 62 6c 6f 63 6b 73 2c 20 ck in 2 blocks,
a670: 73 6f 20 74 68 61 74 20 70 61 72 74 20 6f 66 20 so that part of
a680: 74 68 65 20 72 61 6e 67 65 20 77 69 6c 6c 20 62 the range will b
a690: 65 20 63 6f 76 65 72 65 64 20 62 79 20 61 20 0a e covered by a .
a6a0: 20 20 20 20 2a 2a 20 77 72 69 74 65 20 6c 6f 63 ** write loc
a6b0: 6b 20 75 6e 74 69 6c 20 74 68 65 20 72 65 73 74 k until the rest
a6c0: 20 69 73 20 63 6f 76 65 72 65 64 20 62 79 20 61 is covered by a
a6d0: 20 72 65 61 64 20 6c 6f 63 6b 3a 0a 20 20 20 20 read lock:.
a6e0: 2a 2a 20 20 31 3a 20 20 20 5b 57 57 57 57 57 5d ** 1: [WWWWW]
a6f0: 0a 20 20 20 20 2a 2a 20 20 32 3a 20 20 20 5b 2e . ** 2: [.
a700: 2e 2e 2e 57 5d 0a 20 20 20 20 2a 2a 20 20 33 3a ...W]. ** 3:
a710: 20 20 20 5b 52 52 52 52 57 5d 0a 20 20 20 20 2a [RRRRW]. *
a720: 2a 20 20 34 3a 20 20 20 5b 52 52 52 52 2e 5d 0a * 4: [RRRR.].
a730: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 65 */. if( e
a740: 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 FileLock==SHARED
a750: 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 69 _LOCK ){. i
a760: 66 28 20 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f f( handleNFSUnlo
a770: 63 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 6f 66 ck ){. of
a780: 66 5f 74 20 64 69 76 53 69 7a 65 20 3d 20 53 48 f_t divSize = SH
a790: 41 52 45 44 5f 53 49 5a 45 20 2d 20 31 3b 0a 20 ARED_SIZE - 1;.
a7a0: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 .
a7b0: 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f lock.l_type = F_
a7c0: 55 4e 4c 43 4b 3b 0a 20 20 20 20 20 20 20 20 6c UNLCK;. l
a7d0: 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 ock.l_whence = S
a7e0: 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20 20 EEK_SET;.
a7f0: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 lock.l_start =
a800: 53 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20 SHARED_FIRST;.
a810: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e lock.l_len
a820: 20 3d 20 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 = divSize;.
a830: 20 20 20 20 69 66 28 20 66 63 6e 74 6c 28 68 2c if( fcntl(h,
a840: 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 F_SETLK, &lock)
a850: 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 20 ==(-1) ){.
a860: 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 tErrno = err
a870: 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 no;. rc
a880: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 = sqliteErrorFr
a890: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 omPosixError(tEr
a8a0: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 rno, SQLITE_IOER
a8b0: 52 5f 55 4e 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 R_UNLOCK);.
a8c0: 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b if( IS_LOCK
a8d0: 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 _ERROR(rc) ){.
a8e0: 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d pFile-
a8f0: 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 >lastErrno = tEr
a900: 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 7d rno;. }
a910: 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 . goto
a920: 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20 end_unlock;.
a930: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 6c 6f }. lo
a940: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 52 44 ck.l_type = F_RD
a950: 4c 43 4b 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 LCK;. loc
a960: 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 k.l_whence = SEE
a970: 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20 20 20 6c K_SET;. l
a980: 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 ock.l_start = SH
a990: 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 ARED_FIRST;.
a9a0: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d lock.l_len =
a9b0: 20 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 20 20 divSize;.
a9c0: 20 20 69 66 28 20 66 63 6e 74 6c 28 68 2c 20 46 if( fcntl(h, F
a9d0: 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3d 3d _SETLK, &lock)==
a9e0: 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 20 20 20 (-1) ){.
a9f0: 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f tErrno = errno
aa00: 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d ;. rc =
aa10: 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d sqliteErrorFrom
aa20: 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e PosixError(tErrn
aa30: 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f o, SQLITE_IOERR_
aa40: 52 44 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 20 RDLOCK);.
aa50: 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 if( IS_LOCK_E
aa60: 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 20 RROR(rc) ){.
aa70: 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c pFile->l
aa80: 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 72 6e astErrno = tErrn
aa90: 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 o;. }.
aaa0: 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
aab0: 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 d_unlock;.
aac0: 20 20 7d 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b }. lock
aad0: 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 .l_type = F_UNLC
aae0: 4b 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e K;. lock.
aaf0: 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f l_whence = SEEK_
ab00: 53 45 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 SET;. loc
ab10: 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 k.l_start = SHAR
ab20: 45 44 5f 46 49 52 53 54 2b 64 69 76 53 69 7a 65 ED_FIRST+divSize
ab30: 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c ;. lock.l
ab40: 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 _len = SHARED_SI
ab50: 5a 45 2d 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 ZE-divSize;.
ab60: 20 20 20 20 69 66 28 20 66 63 6e 74 6c 28 68 2c if( fcntl(h,
ab70: 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 F_SETLK, &lock)
ab80: 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 20 ==(-1) ){.
ab90: 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 tErrno = err
aba0: 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 no;. rc
abb0: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 = sqliteErrorFr
abc0: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 omPosixError(tEr
abd0: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 rno, SQLITE_IOER
abe0: 52 5f 55 4e 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 R_UNLOCK);.
abf0: 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b if( IS_LOCK
ac00: 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 _ERROR(rc) ){.
ac10: 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d pFile-
ac20: 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 >lastErrno = tEr
ac30: 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 7d rno;. }
ac40: 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 . goto
ac50: 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20 end_unlock;.
ac60: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 }. }els
ac70: 65 7b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e e{. lock.
ac80: 6c 5f 74 79 70 65 20 3d 20 46 5f 52 44 4c 43 4b l_type = F_RDLCK
ac90: 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c ;. lock.l
aca0: 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 _whence = SEEK_S
acb0: 45 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b ET;. lock
acc0: 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 45 .l_start = SHARE
acd0: 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 20 20 20 D_FIRST;.
ace0: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 lock.l_len = SH
acf0: 41 52 45 44 5f 53 49 5a 45 3b 0a 20 20 20 20 20 ARED_SIZE;.
ad00: 20 20 20 69 66 28 20 66 63 6e 74 6c 28 68 2c 20 if( fcntl(h,
ad10: 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3d F_SETLK, &lock)=
ad20: 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 20 20 =(-1) ){.
ad30: 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e tErrno = errn
ad40: 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 o;. rc
ad50: 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f = sqliteErrorFro
ad60: 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 mPosixError(tErr
ad70: 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 no, SQLITE_IOERR
ad80: 5f 52 44 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 _RDLOCK);.
ad90: 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f if( IS_LOCK_
ada0: 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 ERROR(rc) ){.
adb0: 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e pFile->
adc0: 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 72 lastErrno = tErr
add0: 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a no;. }.
ade0: 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
adf0: 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20 20 nd_unlock;.
ae00: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
ae10: 20 7d 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 }. lock.l_ty
ae20: 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 pe = F_UNLCK;.
ae30: 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 lock.l_whence
ae40: 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 = SEEK_SET;.
ae50: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50 lock.l_start = P
ae60: 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20 ENDING_BYTE;.
ae70: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 32 4c lock.l_len = 2L
ae80: 3b 20 20 61 73 73 65 72 74 28 20 50 45 4e 44 49 ; assert( PENDI
ae90: 4e 47 5f 42 59 54 45 2b 31 3d 3d 52 45 53 45 52 NG_BYTE+1==RESER
aea0: 56 45 44 5f 42 59 54 45 20 29 3b 0a 20 20 20 20 VED_BYTE );.
aeb0: 69 66 28 20 66 63 6e 74 6c 28 68 2c 20 46 5f 53 if( fcntl(h, F_S
aec0: 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 21 3d 28 2d ETLK, &lock)!=(-
aed0: 31 29 20 29 7b 0a 20 20 20 20 20 20 70 49 6e 6f 1) ){. pIno
aee0: 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 de->eFileLock =
aef0: 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20 SHARED_LOCK;.
af00: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 74 45 }else{. tE
af10: 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 rrno = errno;.
af20: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45 rc = sqliteE
af30: 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72 rrorFromPosixErr
af40: 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54 or(tErrno, SQLIT
af50: 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 29 3b E_IOERR_UNLOCK);
af60: 0a 20 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f . if( IS_LO
af70: 43 4b 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a CK_ERROR(rc) ){.
af80: 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c pFile->l
af90: 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 72 6e astErrno = tErrn
afa0: 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 o;. }.
afb0: 20 67 6f 74 6f 20 65 6e 64 5f 75 6e 6c 6f 63 6b goto end_unlock
afc0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 ;. }. }. if
afd0: 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 4e 4f 5f ( eFileLock==NO_
afe0: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 2f 2a 20 44 LOCK ){. /* D
aff0: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 73 68 61 ecrement the sha
b000: 72 65 64 20 6c 6f 63 6b 20 63 6f 75 6e 74 65 72 red lock counter
b010: 2e 20 20 52 65 6c 65 61 73 65 20 74 68 65 20 6c . Release the l
b020: 6f 63 6b 20 75 73 69 6e 67 20 61 6e 0a 20 20 20 ock using an.
b030: 20 2a 2a 20 4f 53 20 63 61 6c 6c 20 6f 6e 6c 79 ** OS call only
b040: 20 77 68 65 6e 20 61 6c 6c 20 74 68 72 65 61 64 when all thread
b050: 73 20 69 6e 20 74 68 69 73 20 73 61 6d 65 20 70 s in this same p
b060: 72 6f 63 65 73 73 20 68 61 76 65 20 72 65 6c 65 rocess have rele
b070: 61 73 65 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 ased. ** the
b080: 6c 6f 63 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 lock.. */.
b090: 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 pInode->nShared
b0a0: 2d 2d 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f --;. if( pIno
b0b0: 64 65 2d 3e 6e 53 68 61 72 65 64 3d 3d 30 20 29 de->nShared==0 )
b0c0: 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 {. lock.l_t
b0d0: 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20 ype = F_UNLCK;.
b0e0: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e lock.l_when
b0f0: 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 ce = SEEK_SET;.
b100: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 lock.l_star
b110: 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d t = lock.l_len =
b120: 20 30 4c 3b 0a 20 20 20 20 20 20 53 69 6d 75 6c 0L;. Simul
b130: 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e ateIOErrorBenign
b140: 28 31 29 3b 0a 20 20 20 20 20 20 53 69 6d 75 6c (1);. Simul
b150: 61 74 65 49 4f 45 72 72 6f 72 28 20 68 3d 28 2d ateIOError( h=(-
b160: 31 29 20 29 0a 20 20 20 20 20 20 53 69 6d 75 6c 1) ). Simul
b170: 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e ateIOErrorBenign
b180: 28 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 66 (0);. if( f
b190: 63 6e 74 6c 28 68 2c 20 46 5f 53 45 54 4c 4b 2c cntl(h, F_SETLK,
b1a0: 20 26 6c 6f 63 6b 29 21 3d 28 2d 31 29 20 29 7b &lock)!=(-1) ){
b1b0: 0a 20 20 20 20 20 20 20 20 70 49 6e 6f 64 65 2d . pInode-
b1c0: 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f >eFileLock = NO_
b1d0: 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 LOCK;. }els
b1e0: 65 7b 0a 20 20 20 20 20 20 20 20 74 45 72 72 6e e{. tErrn
b1f0: 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 o = errno;.
b200: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45 72 rc = sqliteEr
b210: 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f rorFromPosixErro
b220: 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 r(tErrno, SQLITE
b230: 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 29 3b 0a _IOERR_UNLOCK);.
b240: 20 20 20 20 20 20 20 20 69 66 28 20 49 53 5f 4c if( IS_L
b250: 4f 43 4b 5f 45 52 52 4f 52 28 72 63 29 20 29 7b OCK_ERROR(rc) ){
b260: 0a 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 . pFile
b270: 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 ->lastErrno = tE
b280: 72 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 7d 0a rrno;. }.
b290: 20 20 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e pInode->
b2a0: 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c eFileLock = NO_L
b2b0: 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 70 46 69 OCK;. pFi
b2c0: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 le->eFileLock =
b2d0: 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d NO_LOCK;. }
b2e0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 . }.. /* D
b2f0: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f 75 ecrement the cou
b300: 6e 74 20 6f 66 20 6c 6f 63 6b 73 20 61 67 61 69 nt of locks agai
b310: 6e 73 74 20 74 68 69 73 20 73 61 6d 65 20 66 69 nst this same fi
b320: 6c 65 2e 20 20 57 68 65 6e 20 74 68 65 0a 20 20 le. When the.
b330: 20 20 2a 2a 20 63 6f 75 6e 74 20 72 65 61 63 68 ** count reach
b340: 65 73 20 7a 65 72 6f 2c 20 63 6c 6f 73 65 20 61 es zero, close a
b350: 6e 79 20 6f 74 68 65 72 20 66 69 6c 65 20 64 65 ny other file de
b360: 73 63 72 69 70 74 6f 72 73 20 77 68 6f 73 65 20 scriptors whose
b370: 63 6c 6f 73 65 0a 20 20 20 20 2a 2a 20 77 61 73 close. ** was
b380: 20 64 65 66 65 72 72 65 64 20 62 65 63 61 75 73 deferred becaus
b390: 65 20 6f 66 20 6f 75 74 73 74 61 6e 64 69 6e 67 e of outstanding
b3a0: 20 6c 6f 63 6b 73 2e 0a 20 20 20 20 2a 2f 0a 20 locks.. */.
b3b0: 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b pInode->nLock
b3c0: 2d 2d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 --;. assert(
b3d0: 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 3e 3d 30 pInode->nLock>=0
b3e0: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f );. if( pIno
b3f0: 64 65 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 29 7b 0a de->nLock==0 ){.
b400: 20 20 20 20 20 20 69 6e 74 20 72 63 32 20 3d 20 int rc2 =
b410: 63 6c 6f 73 65 50 65 6e 64 69 6e 67 46 64 73 28 closePendingFds(
b420: 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 69 66 pFile);. if
b430: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
b440: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
b450: 72 63 32 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 rc2;. }.
b460: 20 7d 0a 20 20 7d 0a 09 0a 65 6e 64 5f 75 6e 6c }. }...end_unl
b470: 6f 63 6b 3a 0a 20 20 75 6e 69 78 4c 65 61 76 65 ock:. unixLeave
b480: 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20 72 Mutex();. if( r
b490: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 70 c==SQLITE_OK ) p
b4a0: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 File->eFileLock
b4b0: 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 72 = eFileLock;. r
b4c0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
b4d0: 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c 6f 63 ** Lower the loc
b4e0: 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 66 69 king level on fi
b4f0: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 70 46 le descriptor pF
b500: 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c 6f 63 6b ile to eFileLock
b510: 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 . eFileLock.**
b520: 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 4e must be either N
b530: 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 44 O_LOCK or SHARED
b540: 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 _LOCK..**.** If
b550: 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 the locking leve
b560: 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64 65 l of the file de
b570: 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72 65 scriptor is alre
b580: 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a ady at or below.
b590: 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65 64 ** the requested
b5a0: 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20 locking level,
b5b0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
b5c0: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 a no-op..*/.stat
b5d0: 69 63 20 69 6e 74 20 75 6e 69 78 55 6e 6c 6f 63 ic int unixUnloc
b5e0: 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a k(sqlite3_file *
b5f0: 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 id, int eFileLoc
b600: 6b 29 7b 0a 20 20 72 65 74 75 72 6e 20 5f 70 6f k){. return _po
b610: 73 69 78 55 6e 6c 6f 63 6b 28 69 64 2c 20 65 46 sixUnlock(id, eF
b620: 69 6c 65 4c 6f 63 6b 2c 20 30 29 3b 0a 7d 0a 0a ileLock, 0);.}..
b630: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
b640: 69 6f 6e 20 70 65 72 66 6f 72 6d 73 20 74 68 65 ion performs the
b650: 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 22 63 parts of the "c
b660: 6c 6f 73 65 20 66 69 6c 65 22 20 6f 70 65 72 61 lose file" opera
b670: 74 69 6f 6e 20 0a 2a 2a 20 63 6f 6d 6d 6f 6e 20 tion .** common
b680: 74 6f 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 73 to all locking s
b690: 63 68 65 6d 65 73 2e 20 49 74 20 63 6c 6f 73 65 chemes. It close
b6a0: 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 s the directory
b6b0: 61 6e 64 20 66 69 6c 65 0a 2a 2a 20 68 61 6e 64 and file.** hand
b6c0: 6c 65 73 2c 20 69 66 20 74 68 65 79 20 61 72 65 les, if they are
b6d0: 20 76 61 6c 69 64 2c 20 61 6e 64 20 73 65 74 73 valid, and sets
b6e0: 20 61 6c 6c 20 66 69 65 6c 64 73 20 6f 66 20 74 all fields of t
b6f0: 68 65 20 75 6e 69 78 46 69 6c 65 0a 2a 2a 20 73 he unixFile.** s
b700: 74 72 75 63 74 75 72 65 20 74 6f 20 30 2e 0a 2a tructure to 0..*
b710: 2a 0a 2a 2a 20 49 74 20 69 73 20 2a 6e 6f 74 2a *.** It is *not*
b720: 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 68 6f necessary to ho
b730: 6c 64 20 74 68 65 20 6d 75 74 65 78 20 77 68 65 ld the mutex whe
b740: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 n this routine i
b750: 73 20 63 61 6c 6c 65 64 2c 0a 2a 2a 20 65 76 65 s called,.** eve
b760: 6e 20 6f 6e 20 56 78 57 6f 72 6b 73 2e 20 20 41 n on VxWorks. A
b770: 20 6d 75 74 65 78 20 77 69 6c 6c 20 62 65 20 61 mutex will be a
b780: 63 71 75 69 72 65 64 20 6f 6e 20 56 78 57 6f 72 cquired on VxWor
b790: 6b 73 20 62 79 20 74 68 65 0a 2a 2a 20 76 78 77 ks by the.** vxw
b7a0: 6f 72 6b 73 52 65 6c 65 61 73 65 46 69 6c 65 49 orksReleaseFileI
b7b0: 64 28 29 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a d() routine..*/.
b7c0: 73 74 61 74 69 63 20 69 6e 74 20 63 6c 6f 73 65 static int close
b7d0: 55 6e 69 78 46 69 6c 65 28 73 71 6c 69 74 65 33 UnixFile(sqlite3
b7e0: 5f 66 69 6c 65 20 2a 69 64 29 7b 0a 20 20 75 6e _file *id){. un
b7f0: 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 ixFile *pFile =
b800: 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 (unixFile*)id;.
b810: 20 69 66 28 20 70 46 69 6c 65 20 29 7b 0a 20 20 if( pFile ){.
b820: 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 64 69 72 if( pFile->dir
b830: 66 64 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 fd>=0 ){. i
b840: 6e 74 20 65 72 72 20 3d 20 63 6c 6f 73 65 28 70 nt err = close(p
b850: 46 69 6c 65 2d 3e 64 69 72 66 64 29 3b 0a 20 20 File->dirfd);.
b860: 20 20 20 20 69 66 28 20 65 72 72 20 29 7b 0a 20 if( err ){.
b870: 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 pFile->la
b880: 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b stErrno = errno;
b890: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
b8a0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 SQLITE_IOERR_DIR
b8b0: 5f 43 4c 4f 53 45 3b 0a 20 20 20 20 20 20 7d 65 _CLOSE;. }e
b8c0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 46 69 lse{. pFi
b8d0: 6c 65 2d 3e 64 69 72 66 64 3d 2d 31 3b 0a 20 20 le->dirfd=-1;.
b8e0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
b8f0: 69 66 28 20 70 46 69 6c 65 2d 3e 68 3e 3d 30 20 if( pFile->h>=0
b900: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 65 72 72 ){. int err
b910: 20 3d 20 63 6c 6f 73 65 28 70 46 69 6c 65 2d 3e = close(pFile->
b920: 68 29 3b 0a 20 20 20 20 20 20 69 66 28 20 65 72 h);. if( er
b930: 72 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46 69 r ){. pFi
b940: 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 le->lastErrno =
b950: 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 72 errno;. r
b960: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 eturn SQLITE_IOE
b970: 52 52 5f 43 4c 4f 53 45 3b 0a 20 20 20 20 20 20 RR_CLOSE;.
b980: 7d 0a 20 20 20 20 7d 0a 23 69 66 20 4f 53 5f 56 }. }.#if OS_V
b990: 58 57 4f 52 4b 53 0a 20 20 20 20 69 66 28 20 70 XWORKS. if( p
b9a0: 46 69 6c 65 2d 3e 70 49 64 20 29 7b 0a 20 20 20 File->pId ){.
b9b0: 20 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 69 73 if( pFile->is
b9c0: 44 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 20 20 Delete ){.
b9d0: 20 20 75 6e 6c 69 6e 6b 28 70 46 69 6c 65 2d 3e unlink(pFile->
b9e0: 70 49 64 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e pId->zCanonicalN
b9f0: 61 6d 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ame);. }.
ba00: 20 20 20 20 76 78 77 6f 72 6b 73 52 65 6c 65 61 vxworksRelea
ba10: 73 65 46 69 6c 65 49 64 28 70 46 69 6c 65 2d 3e seFileId(pFile->
ba20: 70 49 64 29 3b 0a 20 20 20 20 20 20 70 46 69 6c pId);. pFil
ba30: 65 2d 3e 70 49 64 20 3d 20 30 3b 0a 20 20 20 20 e->pId = 0;.
ba40: 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 4f 53 54 }.#endif. OST
ba50: 52 41 43 45 28 28 22 43 4c 4f 53 45 20 20 20 25 RACE(("CLOSE %
ba60: 2d 33 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 -3d\n", pFile->h
ba70: 29 29 3b 0a 20 20 20 20 4f 70 65 6e 43 6f 75 6e ));. OpenCoun
ba80: 74 65 72 28 2d 31 29 3b 0a 20 20 20 20 73 71 6c ter(-1);. sql
ba90: 69 74 65 33 5f 66 72 65 65 28 70 46 69 6c 65 2d ite3_free(pFile-
baa0: 3e 70 55 6e 75 73 65 64 29 3b 0a 20 20 20 20 6d >pUnused);. m
bab0: 65 6d 73 65 74 28 70 46 69 6c 65 2c 20 30 2c 20 emset(pFile, 0,
bac0: 73 69 7a 65 6f 66 28 75 6e 69 78 46 69 6c 65 29 sizeof(unixFile)
bad0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
bae0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
baf0: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 .** Close a file
bb00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
bb10: 75 6e 69 78 43 6c 6f 73 65 28 73 71 6c 69 74 65 unixClose(sqlite
bb20: 33 5f 66 69 6c 65 20 2a 69 64 29 7b 0a 20 20 69 3_file *id){. i
bb30: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
bb40: 4b 3b 0a 20 20 69 66 28 20 69 64 20 29 7b 0a 20 K;. if( id ){.
bb50: 20 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 unixFile *pFi
bb60: 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 20 2a le = (unixFile *
bb70: 29 69 64 3b 0a 20 20 20 20 75 6e 69 78 55 6e 6c )id;. unixUnl
bb80: 6f 63 6b 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 ock(id, NO_LOCK)
bb90: 3b 0a 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d ;. unixEnterM
bba0: 75 74 65 78 28 29 3b 0a 20 20 20 20 69 66 28 20 utex();. if(
bbb0: 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 20 26 26 pFile->pInode &&
bbc0: 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e pFile->pInode->
bbd0: 6e 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 2f nLock ){. /
bbe0: 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f * If there are o
bbf0: 75 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 utstanding locks
bc00: 2c 20 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c , do not actuall
bc10: 79 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 y close the file
bc20: 20 6a 75 73 74 0a 20 20 20 20 20 20 2a 2a 20 79 just. ** y
bc30: 65 74 20 62 65 63 61 75 73 65 20 74 68 61 74 20 et because that
bc40: 77 6f 75 6c 64 20 63 6c 65 61 72 20 74 68 6f 73 would clear thos
bc50: 65 20 6c 6f 63 6b 73 2e 20 20 49 6e 73 74 65 61 e locks. Instea
bc60: 64 2c 20 61 64 64 20 74 68 65 20 66 69 6c 65 0a d, add the file.
bc70: 20 20 20 20 20 20 2a 2a 20 64 65 73 63 72 69 70 ** descrip
bc80: 74 6f 72 20 74 6f 20 70 49 6e 6f 64 65 2d 3e 70 tor to pInode->p
bc90: 55 6e 75 73 65 64 20 6c 69 73 74 2e 20 20 49 74 Unused list. It
bca0: 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 will be automat
bcb0: 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64 20 0a 20 ically closed .
bcc0: 20 20 20 20 20 2a 2a 20 77 68 65 6e 20 74 68 65 ** when the
bcd0: 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73 20 63 6c last lock is cl
bce0: 65 61 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a eared.. */.
bcf0: 20 20 20 20 20 20 73 65 74 50 65 6e 64 69 6e 67 setPending
bd00: 46 64 28 70 46 69 6c 65 29 3b 0a 20 20 20 20 7d Fd(pFile);. }
bd10: 0a 20 20 20 20 72 65 6c 65 61 73 65 49 6e 6f 64 . releaseInod
bd20: 65 49 6e 66 6f 28 70 46 69 6c 65 2d 3e 70 49 6e eInfo(pFile->pIn
bd30: 6f 64 65 29 3b 0a 20 20 20 20 72 63 20 3d 20 63 ode);. rc = c
bd40: 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28 69 64 29 loseUnixFile(id)
bd50: 3b 0a 20 20 20 20 75 6e 69 78 4c 65 61 76 65 4d ;. unixLeaveM
bd60: 75 74 65 78 28 29 3b 0a 20 20 7d 0a 20 20 72 65 utex();. }. re
bd70: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 2a 2a turn rc;.}../***
bd80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 *********** End
bd90: 6f 66 20 74 68 65 20 70 6f 73 69 78 20 61 64 76 of the posix adv
bda0: 69 73 6f 72 79 20 6c 6f 63 6b 20 69 6d 70 6c 65 isory lock imple
bdb0: 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a mentation ******
bdc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a ***********.****
bdd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
bde0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
bdf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a **********/../**
be20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a ************.***
be70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
be80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 4e 6f 2d 6f *********** No-o
be90: 70 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a p Locking ******
bea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
beb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a ************.**.
bec0: 2a 2a 20 4f 66 20 74 68 65 20 76 61 72 69 6f 75 ** Of the variou
bed0: 73 20 6c 6f 63 6b 69 6e 67 20 69 6d 70 6c 65 6d s locking implem
bee0: 65 6e 74 61 74 69 6f 6e 73 20 61 76 61 69 6c 61 entations availa
bef0: 62 6c 65 2c 20 74 68 69 73 20 69 73 20 62 79 20 ble, this is by
bf00: 66 61 72 20 74 68 65 0a 2a 2a 20 73 69 6d 70 6c far the.** simpl
bf10: 65 73 74 3a 20 20 6c 6f 63 6b 69 6e 67 20 69 73 est: locking is
bf20: 20 69 67 6e 6f 72 65 64 2e 20 20 4e 6f 20 61 74 ignored. No at
bf30: 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f tempt is made to
bf40: 20 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 lock the databa
bf50: 73 65 0a 2a 2a 20 66 69 6c 65 20 66 6f 72 20 72 se.** file for r
bf60: 65 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e eading or writin
bf70: 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6c 6f g..**.** This lo
bf80: 63 6b 69 6e 67 20 6d 6f 64 65 20 69 73 20 61 70 cking mode is ap
bf90: 70 72 6f 70 72 69 61 74 65 20 66 6f 72 20 75 73 propriate for us
bfa0: 65 20 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 64 e on read-only d
bfb0: 61 74 61 62 61 73 65 73 0a 2a 2a 20 28 65 78 3a atabases.** (ex:
bfc0: 20 64 61 74 61 62 61 73 65 73 20 74 68 61 74 20 databases that
bfd0: 61 72 65 20 62 75 72 6e 65 64 20 69 6e 74 6f 20 are burned into
bfe0: 43 44 2d 52 4f 4d 2c 20 66 6f 72 20 65 78 61 6d CD-ROM, for exam
bff0: 70 6c 65 2e 29 20 20 49 74 20 63 61 6e 0a 2a 2a ple.) It can.**
c000: 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 69 66 also be used if
c010: 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e the application
c020: 20 65 6d 70 6c 6f 79 73 20 73 6f 6d 65 20 65 78 employs some ex
c030: 74 65 72 6e 61 6c 20 6d 65 63 68 61 6e 69 73 6d ternal mechanism
c040: 20 74 6f 0a 2a 2a 20 70 72 65 76 65 6e 74 20 73 to.** prevent s
c050: 69 6d 75 6c 74 61 6e 65 6f 75 73 20 61 63 63 65 imultaneous acce
c060: 73 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 64 ss of the same d
c070: 61 74 61 62 61 73 65 20 62 79 20 74 77 6f 20 6f atabase by two o
c080: 72 20 6d 6f 72 65 0a 2a 2a 20 64 61 74 61 62 61 r more.** databa
c090: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 se connections.
c0a0: 20 42 75 74 20 74 68 65 72 65 20 69 73 20 61 20 But there is a
c0b0: 73 65 72 69 6f 75 73 20 72 69 73 6b 20 6f 66 20 serious risk of
c0c0: 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 72 72 database.** corr
c0d0: 75 70 74 69 6f 6e 20 69 66 20 74 68 69 73 20 6c uption if this l
c0e0: 6f 63 6b 69 6e 67 20 6d 6f 64 65 20 69 73 20 75 ocking mode is u
c0f0: 73 65 64 20 69 6e 20 73 69 74 75 61 74 69 6f 6e sed in situation
c100: 73 20 77 68 65 72 65 20 6d 75 6c 74 69 70 6c 65 s where multiple
c110: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e .** database con
c120: 6e 65 63 74 69 6f 6e 73 20 61 72 65 20 61 63 63 nections are acc
c130: 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 essing the same
c140: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 74 database file at
c150: 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 74 69 6d the same.** tim
c160: 65 20 61 6e 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 e and one or mor
c170: 65 20 6f 66 20 74 68 6f 73 65 20 63 6f 6e 6e 65 e of those conne
c180: 63 74 69 6f 6e 73 20 61 72 65 20 77 72 69 74 69 ctions are writi
c190: 6e 67 2e 0a 2a 2f 0a 0a 73 74 61 74 69 63 20 69 ng..*/..static i
c1a0: 6e 74 20 6e 6f 6c 6f 63 6b 43 68 65 63 6b 52 65 nt nolockCheckRe
c1b0: 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 servedLock(sqlit
c1c0: 65 33 5f 66 69 6c 65 20 2a 4e 6f 74 55 73 65 64 e3_file *NotUsed
c1d0: 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 7b , int *pResOut){
c1e0: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
c1f0: 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
c200: 2a 70 52 65 73 4f 75 74 20 3d 20 30 3b 0a 20 20 *pResOut = 0;.
c210: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
c220: 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 6e ;.}.static int n
c230: 6f 6c 6f 63 6b 4c 6f 63 6b 28 73 71 6c 69 74 65 olockLock(sqlite
c240: 33 5f 66 69 6c 65 20 2a 4e 6f 74 55 73 65 64 2c 3_file *NotUsed,
c250: 20 69 6e 74 20 4e 6f 74 55 73 65 64 32 29 7b 0a int NotUsed2){.
c260: 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
c270: 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 4e 6f 74 ER2(NotUsed, Not
c280: 55 73 65 64 32 29 3b 0a 20 20 72 65 74 75 72 6e Used2);. return
c290: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 73 74 SQLITE_OK;.}.st
c2a0: 61 74 69 63 20 69 6e 74 20 6e 6f 6c 6f 63 6b 55 atic int nolockU
c2b0: 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 nlock(sqlite3_fi
c2c0: 6c 65 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e 74 le *NotUsed, int
c2d0: 20 4e 6f 74 55 73 65 64 32 29 7b 0a 20 20 55 4e NotUsed2){. UN
c2e0: 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 USED_PARAMETER2(
c2f0: 4e 6f 74 55 73 65 64 2c 20 4e 6f 74 55 73 65 64 NotUsed, NotUsed
c300: 32 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 2);. return SQL
c310: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
c320: 20 43 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 2e Close the file.
c330: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e .*/.static int n
c340: 6f 6c 6f 63 6b 43 6c 6f 73 65 28 73 71 6c 69 74 olockClose(sqlit
c350: 65 33 5f 66 69 6c 65 20 2a 69 64 29 20 7b 0a 20 e3_file *id) {.
c360: 20 72 65 74 75 72 6e 20 63 6c 6f 73 65 55 6e 69 return closeUni
c370: 78 46 69 6c 65 28 69 64 29 3b 0a 7d 0a 0a 2f 2a xFile(id);.}../*
c380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c390: 2a 2a 20 45 6e 64 20 6f 66 20 74 68 65 20 6e 6f ** End of the no
c3a0: 2d 6f 70 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 -op lock impleme
c3b0: 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a ntation ********
c3c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a *************.**
c3d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c3e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c3f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c400: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c410: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f ************/../
c420: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c430: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c440: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c450: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c460: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a **************.*
c470: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c480: 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 64 ******** Begin d
c490: 6f 74 2d 66 69 6c 65 20 4c 6f 63 6b 69 6e 67 20 ot-file Locking
c4a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
c4b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a **************.*
c4c0: 2a 0a 2a 2a 20 54 68 65 20 64 6f 74 66 69 6c 65 *.** The dotfile
c4d0: 20 6c 6f 63 6b 69 6e 67 20 69 6d 70 6c 65 6d 65 locking impleme
c4e0: 6e 74 61 74 69 6f 6e 20 75 73 65 73 20 74 68 65 ntation uses the
c4f0: 20 65 78 69 73 74 61 6e 63 65 20 6f 66 20 73 65 existance of se
c500: 70 61 72 61 74 65 20 6c 6f 63 6b 0a 2a 2a 20 66 parate lock.** f
c510: 69 6c 65 73 20 69 6e 20 6f 72 64 65 72 20 74 6f iles in order to
c520: 20 63 6f 6e 74 72 6f 6c 20 61 63 63 65 73 73 20 control access
c530: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 2e to the database.
c540: 20 20 54 68 69 73 20 77 6f 72 6b 73 20 6f 6e 20 This works on
c550: 6a 75 73 74 0a 2a 2a 20 61 62 6f 75 74 20 65 76 just.** about ev
c560: 65 72 79 20 66 69 6c 65 73 79 73 74 65 6d 20 69 ery filesystem i
c570: 6d 61 67 69 6e 61 62 6c 65 2e 20 20 42 75 74 20 maginable. But
c580: 74 68 65 72 65 20 61 72 65 20 73 65 72 69 6f 75 there are seriou
c590: 73 20 64 6f 77 6e 73 69 64 65 73 3a 0a 2a 2a 0a s downsides:.**.
c5a0: 2a 2a 20 20 20 20 28 31 29 20 20 54 68 65 72 65 ** (1) There
c5b0: 20 69 73 20 7a 65 72 6f 20 63 6f 6e 63 75 72 72 is zero concurr
c5c0: 65 6e 63 79 2e 20 20 41 20 73 69 6e 67 6c 65 20 ency. A single
c5d0: 72 65 61 64 65 72 20 62 6c 6f 63 6b 73 20 61 6c reader blocks al
c5e0: 6c 20 6f 74 68 65 72 0a 2a 2a 20 20 20 20 20 20 l other.**
c5f0: 20 20 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 66 connections f
c600: 72 6f 6d 20 72 65 61 64 69 6e 67 20 6f 72 20 77 rom reading or w
c610: 72 69 74 69 6e 67 20 74 68 65 20 64 61 74 61 62 riting the datab
c620: 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 ase..**.** (2
c630: 29 20 20 41 6e 20 61 70 70 6c 69 63 61 74 69 6f ) An applicatio
c640: 6e 20 63 72 61 73 68 20 6f 72 20 70 6f 77 65 72 n crash or power
c650: 20 6c 6f 73 73 20 63 61 6e 20 6c 65 61 76 65 20 loss can leave
c660: 73 74 61 6c 65 20 6c 6f 63 6b 20 66 69 6c 65 73 stale lock files
c670: 0a 2a 2a 20 20 20 20 20 20 20 20 20 73 69 74 74 .** sitt
c680: 69 6e 67 20 61 72 6f 75 6e 64 20 74 68 61 74 20 ing around that
c690: 6e 65 65 64 20 74 6f 20 62 65 20 63 6c 65 61 72 need to be clear
c6a0: 65 64 20 6d 61 6e 75 61 6c 6c 79 2e 0a 2a 2a 0a ed manually..**.
c6b0: 2a 2a 20 4e 65 76 65 72 74 68 65 6c 65 73 73 2c ** Nevertheless,
c6c0: 20 61 20 64 6f 74 6c 6f 63 6b 20 69 73 20 61 6e a dotlock is an
c6d0: 20 61 70 70 72 6f 70 72 69 61 74 65 20 6c 6f 63 appropriate loc
c6e0: 6b 69 6e 67 20 6d 6f 64 65 20 66 6f 72 20 75 73 king mode for us
c6f0: 65 20 69 66 20 6e 6f 0a 2a 2a 20 6f 74 68 65 72 e if no.** other
c700: 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74 65 67 locking strateg
c710: 79 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2e 0a y is available..
c720: 2a 2a 0a 2a 2a 20 44 6f 74 66 69 6c 65 20 6c 6f **.** Dotfile lo
c730: 63 6b 69 6e 67 20 77 6f 72 6b 73 20 62 79 20 63 cking works by c
c740: 72 65 61 74 69 6e 67 20 61 20 66 69 6c 65 20 69 reating a file i
c750: 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 65 63 n the same direc
c760: 74 6f 72 79 20 61 73 20 74 68 65 0a 2a 2a 20 64 tory as the.** d
c770: 61 74 61 62 61 73 65 20 61 6e 64 20 77 69 74 68 atabase and with
c780: 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 62 the same name b
c790: 75 74 20 77 69 74 68 20 61 20 22 2e 6c 6f 63 6b ut with a ".lock
c7a0: 22 20 65 78 74 65 6e 73 69 6f 6e 20 61 64 64 65 " extension adde
c7b0: 64 2e 0a 2a 2a 20 54 68 65 20 65 78 69 73 74 61 d..** The exista
c7c0: 6e 63 65 20 6f 66 20 61 20 6c 6f 63 6b 20 66 69 nce of a lock fi
c7d0: 6c 65 20 69 6d 70 6c 69 65 73 20 61 6e 20 45 58 le implies an EX
c7e0: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 41 CLUSIVE lock. A
c7f0: 6c 6c 20 6f 74 68 65 72 20 6c 6f 63 6b 0a 2a 2a ll other lock.**
c800: 20 74 79 70 65 73 20 28 53 48 41 52 45 44 2c 20 types (SHARED,
c810: 52 45 53 45 52 56 45 44 2c 20 50 45 4e 44 49 4e RESERVED, PENDIN
c820: 47 29 20 61 72 65 20 6d 61 70 70 65 64 20 69 6e G) are mapped in
c830: 74 6f 20 45 58 43 4c 55 53 49 56 45 2e 0a 2a 2f to EXCLUSIVE..*/
c840: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 69 6c 65 ../*.** The file
c850: 20 73 75 66 66 69 78 20 61 64 64 65 64 20 74 6f suffix added to
c860: 20 74 68 65 20 64 61 74 61 20 62 61 73 65 20 66 the data base f
c870: 69 6c 65 6e 61 6d 65 20 69 6e 20 6f 72 64 65 72 ilename in order
c880: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 0a 2a to create the.*
c890: 2a 20 6c 6f 63 6b 20 66 69 6c 65 2e 0a 2a 2f 0a * lock file..*/.
c8a0: 23 64 65 66 69 6e 65 20 44 4f 54 4c 4f 43 4b 5f #define DOTLOCK_
c8b0: 53 55 46 46 49 58 20 22 2e 6c 6f 63 6b 22 0a 0a SUFFIX ".lock"..
c8c0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 /*.** This routi
c8d0: 6e 65 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 ne checks if the
c8e0: 72 65 20 69 73 20 61 20 52 45 53 45 52 56 45 44 re is a RESERVED
c8f0: 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 lock held on th
c900: 65 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 e specified.** f
c910: 69 6c 65 20 62 79 20 74 68 69 73 20 6f 72 20 61 ile by this or a
c920: 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 ny other process
c930: 2e 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b . If such a lock
c940: 20 69 73 20 68 65 6c 64 2c 20 73 65 74 20 2a 70 is held, set *p
c950: 52 65 73 4f 75 74 0a 2a 2a 20 74 6f 20 61 20 6e ResOut.** to a n
c960: 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 20 6f 74 on-zero value ot
c970: 68 65 72 77 69 73 65 20 2a 70 52 65 73 4f 75 74 herwise *pResOut
c980: 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e is set to zero.
c990: 20 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c The return val
c9a0: 75 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 ue.** is set to
c9b0: 53 51 4c 49 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 SQLITE_OK unless
c9c0: 20 61 6e 20 49 2f 4f 20 65 72 72 6f 72 20 6f 63 an I/O error oc
c9d0: 63 75 72 73 20 64 75 72 69 6e 67 20 6c 6f 63 6b curs during lock
c9e0: 20 63 68 65 63 6b 69 6e 67 2e 0a 2a 2a 0a 2a 2a checking..**.**
c9f0: 20 49 6e 20 64 6f 74 66 69 6c 65 20 6c 6f 63 6b In dotfile lock
ca00: 69 6e 67 2c 20 65 69 74 68 65 72 20 61 20 6c 6f ing, either a lo
ca10: 63 6b 20 65 78 69 73 74 73 20 6f 72 20 69 74 20 ck exists or it
ca20: 64 6f 65 73 20 6e 6f 74 2e 20 20 53 6f 20 69 6e does not. So in
ca30: 20 74 68 69 73 0a 2a 2a 20 76 61 72 69 61 74 69 this.** variati
ca40: 6f 6e 20 6f 66 20 43 68 65 63 6b 52 65 73 65 72 on of CheckReser
ca50: 76 65 64 4c 6f 63 6b 28 29 2c 20 2a 70 52 65 73 vedLock(), *pRes
ca60: 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20 74 72 Out is set to tr
ca70: 75 65 20 69 66 20 61 6e 79 20 6c 6f 63 6b 0a 2a ue if any lock.*
ca80: 2a 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 * is held on the
ca90: 20 66 69 6c 65 20 61 6e 64 20 66 61 6c 73 65 20 file and false
caa0: 69 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 75 if the file is u
cab0: 6e 6c 6f 63 6b 65 64 2e 0a 2a 2f 0a 73 74 61 74 nlocked..*/.stat
cac0: 69 63 20 69 6e 74 20 64 6f 74 6c 6f 63 6b 43 68 ic int dotlockCh
cad0: 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 eckReservedLock(
cae0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 sqlite3_file *id
caf0: 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 20 , int *pResOut)
cb00: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
cb10: 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 72 65 ITE_OK;. int re
cb20: 73 65 72 76 65 64 20 3d 20 30 3b 0a 20 20 75 6e served = 0;. un
cb30: 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 ixFile *pFile =
cb40: 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 0a (unixFile*)id;..
cb50: 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f SimulateIOErro
cb60: 72 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 r( return SQLITE
cb70: 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 _IOERR_CHECKRESE
cb80: 52 56 45 44 4c 4f 43 4b 3b 20 29 3b 0a 20 20 0a RVEDLOCK; );. .
cb90: 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 assert( pFile
cba0: 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 );.. /* Check i
cbb0: 66 20 61 20 74 68 72 65 61 64 20 69 6e 20 74 68 f a thread in th
cbc0: 69 73 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 is process holds
cbd0: 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 2a 2f 0a such a lock */.
cbe0: 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 if( pFile->eFi
cbf0: 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f leLock>SHARED_LO
cc00: 43 4b 20 29 7b 0a 20 20 20 20 2f 2a 20 45 69 74 CK ){. /* Eit
cc10: 68 65 72 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 her this connect
cc20: 69 6f 6e 20 6f 72 20 73 6f 6d 65 20 6f 74 68 65 ion or some othe
cc30: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 6e 20 r connection in
cc40: 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 the same process
cc50: 0a 20 20 20 20 2a 2a 20 68 6f 6c 64 73 20 61 20 . ** holds a
cc60: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 lock on the file
cc70: 2e 20 20 4e 6f 20 6e 65 65 64 20 74 6f 20 63 68 . No need to ch
cc80: 65 63 6b 20 66 75 72 74 68 65 72 2e 20 2a 2f 0a eck further. */.
cc90: 20 20 20 20 72 65 73 65 72 76 65 64 20 3d 20 31 reserved = 1
cca0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f ;. }else{. /
ccb0: 2a 20 54 68 65 20 6c 6f 63 6b 20 69 73 20 68 65 * The lock is he
ccc0: 6c 64 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 69 ld if and only i
ccd0: 66 20 74 68 65 20 6c 6f 63 6b 66 69 6c 65 20 65 f the lockfile e
cce0: 78 69 73 74 73 20 2a 2f 0a 20 20 20 20 63 6f 6e xists */. con
ccf0: 73 74 20 63 68 61 72 20 2a 7a 4c 6f 63 6b 46 69 st char *zLockFi
cd00: 6c 65 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 le = (const char
cd10: 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 *)pFile->locking
cd20: 43 6f 6e 74 65 78 74 3b 0a 20 20 20 20 72 65 73 Context;. res
cd30: 65 72 76 65 64 20 3d 20 61 63 63 65 73 73 28 7a erved = access(z
cd40: 4c 6f 63 6b 46 69 6c 65 2c 20 30 29 3d 3d 30 3b LockFile, 0)==0;
cd50: 0a 20 20 7d 0a 20 20 4f 53 54 52 41 43 45 28 28 . }. OSTRACE((
cd60: 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64 "TEST WR-LOCK %d
cd70: 20 25 64 20 25 64 20 28 64 6f 74 6c 6f 63 6b 29 %d %d (dotlock)
cd80: 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 72 \n", pFile->h, r
cd90: 63 2c 20 72 65 73 65 72 76 65 64 29 29 3b 0a 20 c, reserved));.
cda0: 20 2a 70 52 65 73 4f 75 74 20 3d 20 72 65 73 65 *pResOut = rese
cdb0: 72 76 65 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 rved;. return r
cdc0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b c;.}../*.** Lock
cdd0: 20 74 68 65 20 66 69 6c 65 20 77 69 74 68 20 74 the file with t
cde0: 68 65 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 he lock specifie
cdf0: 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 65 d by parameter e
ce00: 46 69 6c 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a FileLock - one.*
ce10: 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 * of the followi
ce20: 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 ng:.**.** (1
ce30: 29 20 53 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a ) SHARED_LOCK.**
ce40: 20 20 20 20 20 28 32 29 20 52 45 53 45 52 56 45 (2) RESERVE
ce50: 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 D_LOCK.** (3
ce60: 29 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a ) PENDING_LOCK.*
ce70: 2a 20 20 20 20 20 28 34 29 20 45 58 43 4c 55 53 * (4) EXCLUS
ce80: 49 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 IVE_LOCK.**.** S
ce90: 6f 6d 65 74 69 6d 65 73 20 77 68 65 6e 20 72 65 ometimes when re
cea0: 71 75 65 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 questing one loc
ceb0: 6b 20 73 74 61 74 65 2c 20 61 64 64 69 74 69 6f k state, additio
cec0: 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a nal lock states.
ced0: 2a 2a 20 61 72 65 20 69 6e 73 65 72 74 65 64 20 ** are inserted
cee0: 69 6e 20 62 65 74 77 65 65 6e 2e 20 20 54 68 65 in between. The
cef0: 20 6c 6f 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 locking might f
cf00: 61 69 6c 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 ail on one of th
cf10: 65 20 6c 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 e later.** trans
cf20: 69 74 69 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 itions leaving t
cf30: 68 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 he lock state di
cf40: 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 fferent from wha
cf50: 74 20 69 74 20 73 74 61 72 74 65 64 20 62 75 74 t it started but
cf60: 0a 2a 2a 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 .** still short
cf70: 6f 66 20 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 of its goal. Th
cf80: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 e following char
cf90: 74 20 73 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f t shows the allo
cfa0: 77 65 64 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f wed.** transitio
cfb0: 6e 73 20 61 6e 64 20 74 68 65 20 69 6e 73 65 72 ns and the inser
cfc0: 74 65 64 20 69 6e 74 65 72 6d 65 64 69 61 74 65 ted intermediate
cfd0: 20 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 states:.**.**
cfe0: 20 20 55 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 UNLOCKED -> SH
cff0: 41 52 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 ARED.** SHARE
d000: 44 20 2d 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a D -> RESERVED.**
d010: 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 28 50 SHARED -> (P
d020: 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 ENDING) -> EXCLU
d030: 53 49 56 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 SIVE.** RESER
d040: 56 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 VED -> (PENDING)
d050: 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a -> EXCLUSIVE.**
d060: 20 20 20 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 PENDING -> E
d070: 58 43 4c 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 54 XCLUSIVE.**.** T
d080: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c his routine will
d090: 20 6f 6e 6c 79 20 69 6e 63 72 65 61 73 65 20 61 only increase a
d0a0: 20 6c 6f 63 6b 2e 20 20 55 73 65 20 74 68 65 20 lock. Use the
d0b0: 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 sqlite3OsUnlock(
d0c0: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 74 6f 20 ).** routine to
d0d0: 6c 6f 77 65 72 20 61 20 6c 6f 63 6b 69 6e 67 20 lower a locking
d0e0: 6c 65 76 65 6c 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 level..**.** Wit
d0f0: 68 20 64 6f 74 66 69 6c 65 20 6c 6f 63 6b 69 6e h dotfile lockin
d100: 67 2c 20 77 65 20 72 65 61 6c 6c 79 20 6f 6e 6c g, we really onl
d110: 79 20 73 75 70 70 6f 72 74 20 73 74 61 74 65 20 y support state
d120: 28 34 29 3a 20 45 58 43 4c 55 53 49 56 45 2e 0a (4): EXCLUSIVE..
d130: 2a 2a 20 42 75 74 20 77 65 20 74 72 61 63 6b 20 ** But we track
d140: 74 68 65 20 6f 74 68 65 72 20 6c 6f 63 6b 69 6e the other lockin
d150: 67 20 6c 65 76 65 6c 73 20 69 6e 74 65 72 6e 61 g levels interna
d160: 6c 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 lly..*/.static i
d170: 6e 74 20 64 6f 74 6c 6f 63 6b 4c 6f 63 6b 28 73 nt dotlockLock(s
d180: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c qlite3_file *id,
d190: 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 int eFileLock)
d1a0: 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 {. unixFile *pF
d1b0: 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a ile = (unixFile*
d1c0: 29 69 64 3b 0a 20 20 69 6e 74 20 66 64 3b 0a 20 )id;. int fd;.
d1d0: 20 63 68 61 72 20 2a 7a 4c 6f 63 6b 46 69 6c 65 char *zLockFile
d1e0: 20 3d 20 28 63 68 61 72 20 2a 29 70 46 69 6c 65 = (char *)pFile
d1f0: 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 ->lockingContext
d200: 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
d210: 49 54 45 5f 4f 4b 3b 0a 0a 0a 20 20 2f 2a 20 49 ITE_OK;... /* I
d220: 66 20 77 65 20 68 61 76 65 20 61 6e 79 20 6c 6f f we have any lo
d230: 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 6c 6f 63 ck, then the loc
d240: 6b 20 66 69 6c 65 20 61 6c 72 65 61 64 79 20 65 k file already e
d250: 78 69 73 74 73 2e 20 20 41 6c 6c 20 77 65 20 68 xists. All we h
d260: 61 76 65 0a 20 20 2a 2a 20 74 6f 20 64 6f 20 69 ave. ** to do i
d270: 73 20 61 64 6a 75 73 74 20 6f 75 72 20 69 6e 74 s adjust our int
d280: 65 72 6e 61 6c 20 72 65 63 6f 72 64 20 6f 66 20 ernal record of
d290: 74 68 65 20 6c 6f 63 6b 20 6c 65 76 65 6c 2e 0a the lock level..
d2a0: 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 */. if( pFile
d2b0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f ->eFileLock > NO
d2c0: 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 70 46 69 _LOCK ){. pFi
d2d0: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 le->eFileLock =
d2e0: 65 46 69 6c 65 4c 6f 63 6b 3b 0a 23 69 66 20 21 eFileLock;.#if !
d2f0: 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 20 20 2f OS_VXWORKS. /
d300: 2a 20 41 6c 77 61 79 73 20 75 70 64 61 74 65 20 * Always update
d310: 74 68 65 20 74 69 6d 65 73 74 61 6d 70 20 6f 6e the timestamp on
d320: 20 74 68 65 20 6f 6c 64 20 66 69 6c 65 20 2a 2f the old file */
d330: 0a 20 20 20 20 75 74 69 6d 65 73 28 7a 4c 6f 63 . utimes(zLoc
d340: 6b 46 69 6c 65 2c 20 4e 55 4c 4c 29 3b 0a 23 65 kFile, NULL);.#e
d350: 6e 64 69 66 0a 20 20 20 20 72 65 74 75 72 6e 20 ndif. return
d360: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 SQLITE_OK;. }.
d370: 20 0a 20 20 2f 2a 20 67 72 61 62 20 61 6e 20 65 . /* grab an e
d380: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 2a 2f xclusive lock */
d390: 0a 20 20 66 64 20 3d 20 6f 70 65 6e 28 7a 4c 6f . fd = open(zLo
d3a0: 63 6b 46 69 6c 65 2c 4f 5f 52 44 4f 4e 4c 59 7c ckFile,O_RDONLY|
d3b0: 4f 5f 43 52 45 41 54 7c 4f 5f 45 58 43 4c 2c 30 O_CREAT|O_EXCL,0
d3c0: 36 30 30 29 3b 0a 20 20 69 66 28 20 66 64 3c 30 600);. if( fd<0
d3d0: 20 29 7b 0a 20 20 20 20 2f 2a 20 66 61 69 6c 65 ){. /* faile
d3e0: 64 20 74 6f 20 6f 70 65 6e 2f 63 72 65 61 74 65 d to open/create
d3f0: 20 74 68 65 20 66 69 6c 65 2c 20 73 6f 6d 65 6f the file, someo
d400: 6e 65 20 65 6c 73 65 20 6d 61 79 20 68 61 76 65 ne else may have
d410: 20 73 74 6f 6c 65 6e 20 74 68 65 20 6c 6f 63 6b stolen the lock
d420: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 74 45 72 72 */. int tErr
d430: 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 no = errno;.
d440: 69 66 28 20 45 45 58 49 53 54 20 3d 3d 20 74 45 if( EEXIST == tE
d450: 72 72 6e 6f 20 29 7b 0a 20 20 20 20 20 20 72 63 rrno ){. rc
d460: 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a = SQLITE_BUSY;.
d470: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 } else {.
d480: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45 72 rc = sqliteEr
d490: 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f rorFromPosixErro
d4a0: 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 r(tErrno, SQLITE
d4b0: 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 0a 20 20 _IOERR_LOCK);.
d4c0: 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f if( IS_LOCK_
d4d0: 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 ERROR(rc) ){.
d4e0: 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 pFile->last
d4f0: 45 72 72 6e 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a Errno = tErrno;.
d500: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
d510: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
d520: 20 0a 20 20 69 66 28 20 63 6c 6f 73 65 28 66 64 . if( close(fd
d530: 29 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e ) ){. pFile->
d540: 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e lastErrno = errn
d550: 6f 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 o;. rc = SQLI
d560: 54 45 5f 49 4f 45 52 52 5f 43 4c 4f 53 45 3b 0a TE_IOERR_CLOSE;.
d570: 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 67 6f 74 20 }. . /* got
d580: 69 74 2c 20 73 65 74 20 74 68 65 20 74 79 70 65 it, set the type
d590: 20 61 6e 64 20 72 65 74 75 72 6e 20 6f 6b 20 2a and return ok *
d5a0: 2f 0a 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 /. pFile->eFile
d5b0: 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b Lock = eFileLock
d5c0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
d5d0: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 ../*.** Lower th
d5e0: 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 e locking level
d5f0: 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 on file descript
d600: 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46 69 6c or pFile to eFil
d610: 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 eLock. eFileLoc
d620: 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 69 74 k.** must be eit
d630: 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 her NO_LOCK or S
d640: 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a HARED_LOCK..**.*
d650: 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 * If the locking
d660: 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 66 69 level of the fi
d670: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 le descriptor is
d680: 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72 20 62 already at or b
d690: 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65 71 75 elow.** the requ
d6a0: 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 ested locking le
d6b0: 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74 69 6e vel, this routin
d6c0: 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a e is a no-op..**
d6d0: 0a 2a 2a 20 57 68 65 6e 20 74 68 65 20 6c 6f 63 .** When the loc
d6e0: 6b 69 6e 67 20 6c 65 76 65 6c 20 72 65 61 63 68 king level reach
d6f0: 65 73 20 4e 4f 5f 4c 4f 43 4b 2c 20 64 65 6c 65 es NO_LOCK, dele
d700: 74 65 20 74 68 65 20 6c 6f 63 6b 20 66 69 6c 65 te the lock file
d710: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
d720: 64 6f 74 6c 6f 63 6b 55 6e 6c 6f 63 6b 28 73 71 dotlockUnlock(sq
d730: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
d740: 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b int eFileLock) {
d750: 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
d760: 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
d770: 69 64 3b 0a 20 20 63 68 61 72 20 2a 7a 4c 6f 63 id;. char *zLoc
d780: 6b 46 69 6c 65 20 3d 20 28 63 68 61 72 20 2a 29 kFile = (char *)
d790: 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f pFile->lockingCo
d7a0: 6e 74 65 78 74 3b 0a 0a 20 20 61 73 73 65 72 74 ntext;.. assert
d7b0: 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 4f 53 54 ( pFile );. OST
d7c0: 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b 20 20 25 RACE(("UNLOCK %
d7d0: 64 20 25 64 20 77 61 73 20 25 64 20 70 69 64 3d d %d was %d pid=
d7e0: 25 64 20 28 64 6f 74 6c 6f 63 6b 29 5c 6e 22 2c %d (dotlock)\n",
d7f0: 20 70 46 69 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 pFile->h, eFile
d800: 4c 6f 63 6b 2c 0a 09 20 20 20 70 46 69 6c 65 2d Lock,.. pFile-
d810: 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 67 65 74 70 >eFileLock, getp
d820: 69 64 28 29 29 29 3b 0a 20 20 61 73 73 65 72 74 id()));. assert
d830: 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 41 ( eFileLock<=SHA
d840: 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 0a 20 RED_LOCK );. .
d850: 20 2f 2a 20 6e 6f 2d 6f 70 20 69 66 20 70 6f 73 /* no-op if pos
d860: 73 69 62 6c 65 20 2a 2f 0a 20 20 69 66 28 20 70 sible */. if( p
d870: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d File->eFileLock=
d880: 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 =eFileLock ){.
d890: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
d8a0: 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 6f OK;. }.. /* To
d8b0: 20 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 73 68 downgrade to sh
d8c0: 61 72 65 64 2c 20 73 69 6d 70 6c 79 20 75 70 64 ared, simply upd
d8d0: 61 74 65 20 6f 75 72 20 69 6e 74 65 72 6e 61 6c ate our internal
d8e0: 20 6e 6f 74 69 6f 6e 20 6f 66 20 74 68 65 0a 20 notion of the.
d8f0: 20 2a 2a 20 6c 6f 63 6b 20 73 74 61 74 65 2e 20 ** lock state.
d900: 20 4e 6f 20 6e 65 65 64 20 74 6f 20 6d 65 73 73 No need to mess
d910: 20 77 69 74 68 20 74 68 65 20 66 69 6c 65 20 6f with the file o
d920: 6e 20 64 69 73 6b 2e 0a 20 20 2a 2f 0a 20 20 69 n disk.. */. i
d930: 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 f( eFileLock==SH
d940: 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 ARED_LOCK ){.
d950: 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
d960: 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b k = SHARED_LOCK;
d970: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
d980: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a 20 20 TE_OK;. }. .
d990: 2f 2a 20 54 6f 20 66 75 6c 6c 79 20 75 6e 6c 6f /* To fully unlo
d9a0: 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 2c ck the database,
d9b0: 20 64 65 6c 65 74 65 20 74 68 65 20 6c 6f 63 6b delete the lock
d9c0: 20 66 69 6c 65 20 2a 2f 0a 20 20 61 73 73 65 72 file */. asser
d9d0: 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 4e 4f t( eFileLock==NO
d9e0: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 75 _LOCK );. if( u
d9f0: 6e 6c 69 6e 6b 28 7a 4c 6f 63 6b 46 69 6c 65 29 nlink(zLockFile)
da00: 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 20 3d ){. int rc =
da10: 20 30 3b 0a 20 20 20 20 69 6e 74 20 74 45 72 72 0;. int tErr
da20: 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 no = errno;.
da30: 69 66 28 20 45 4e 4f 45 4e 54 20 21 3d 20 74 45 if( ENOENT != tE
da40: 72 72 6e 6f 20 29 7b 0a 20 20 20 20 20 20 72 63 rrno ){. rc
da50: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 = sqliteErrorFr
da60: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 omPosixError(tEr
da70: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 rno, SQLITE_IOER
da80: 52 5f 55 4e 4c 4f 43 4b 29 3b 0a 20 20 20 20 7d R_UNLOCK);. }
da90: 0a 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b . if( IS_LOCK
daa0: 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 _ERROR(rc) ){.
dab0: 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 pFile->lastE
dac0: 72 72 6e 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 rrno = tErrno;.
dad0: 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
dae0: 72 63 3b 20 0a 20 20 7d 0a 20 20 70 46 69 6c 65 rc; . }. pFile
daf0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f ->eFileLock = NO
db00: 5f 4c 4f 43 4b 3b 0a 20 20 72 65 74 75 72 6e 20 _LOCK;. return
db10: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
db20: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 .** Close a file
db30: 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 . Make sure the
db40: 20 6c 6f 63 6b 20 68 61 73 20 62 65 65 6e 20 72 lock has been r
db50: 65 6c 65 61 73 65 64 20 62 65 66 6f 72 65 20 63 eleased before c
db60: 6c 6f 73 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 losing..*/.stati
db70: 63 20 69 6e 74 20 64 6f 74 6c 6f 63 6b 43 6c 6f c int dotlockClo
db80: 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 se(sqlite3_file
db90: 2a 69 64 29 20 7b 0a 20 20 69 6e 74 20 72 63 3b *id) {. int rc;
dba0: 0a 20 20 69 66 28 20 69 64 20 29 7b 0a 20 20 20 . if( id ){.
dbb0: 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 unixFile *pFile
dbc0: 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 = (unixFile*)id
dbd0: 3b 0a 20 20 20 20 64 6f 74 6c 6f 63 6b 55 6e 6c ;. dotlockUnl
dbe0: 6f 63 6b 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 ock(id, NO_LOCK)
dbf0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 ;. sqlite3_fr
dc00: 65 65 28 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e ee(pFile->lockin
dc10: 67 43 6f 6e 74 65 78 74 29 3b 0a 20 20 7d 0a 20 gContext);. }.
dc20: 20 72 63 20 3d 20 63 6c 6f 73 65 55 6e 69 78 46 rc = closeUnixF
dc30: 69 6c 65 28 69 64 29 3b 0a 20 20 72 65 74 75 72 ile(id);. retur
dc40: 6e 20 72 63 3b 0a 7d 0a 2f 2a 2a 2a 2a 2a 2a 2a n rc;.}./*******
dc50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 *********** End
dc60: 6f 66 20 74 68 65 20 64 6f 74 2d 66 69 6c 65 20 of the dot-file
dc70: 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 74 lock implementat
dc80: 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ion ************
dc90: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a *******.********
dca0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dcb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dcc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dcd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dce0: 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a ******/../******
dcf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd30: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a ********.*******
dd40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd50: 2a 2a 2a 20 42 65 67 69 6e 20 66 6c 6f 63 6b 20 *** Begin flock
dd60: 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a Locking ********
dd70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
dd80: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 55 ********.**.** U
dd90: 73 65 20 74 68 65 20 66 6c 6f 63 6b 28 29 20 73 se the flock() s
dda0: 79 73 74 65 6d 20 63 61 6c 6c 20 74 6f 20 64 6f ystem call to do
ddb0: 20 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 2e 0a 2a file locking..*
ddc0: 2a 0a 2a 2a 20 66 6c 6f 63 6b 28 29 20 6c 6f 63 *.** flock() loc
ddd0: 6b 69 6e 67 20 69 73 20 6c 69 6b 65 20 64 6f 74 king is like dot
dde0: 2d 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 69 6e -file locking in
ddf0: 20 74 68 61 74 20 74 68 65 20 76 61 72 69 6f 75 that the variou
de00: 73 0a 2a 2a 20 66 69 6e 65 2d 67 72 61 69 6e 20 s.** fine-grain
de10: 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 73 20 73 locking levels s
de20: 75 70 70 6f 72 74 65 64 20 62 79 20 53 51 4c 69 upported by SQLi
de30: 74 65 20 61 72 65 20 63 6f 6c 6c 61 70 73 65 64 te are collapsed
de40: 20 69 6e 74 6f 0a 2a 2a 20 61 20 73 69 6e 67 6c into.** a singl
de50: 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b e exclusive lock
de60: 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 . In other word
de70: 73 2c 20 53 48 41 52 45 44 2c 20 52 45 53 45 52 s, SHARED, RESER
de80: 56 45 44 2c 20 61 6e 64 0a 2a 2a 20 50 45 4e 44 VED, and.** PEND
de90: 49 4e 47 20 6c 6f 63 6b 73 20 61 72 65 20 74 68 ING locks are th
dea0: 65 20 73 61 6d 65 20 74 68 69 6e 67 20 61 73 20 e same thing as
deb0: 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 an EXCLUSIVE loc
dec0: 6b 2e 20 20 53 51 4c 69 74 65 0a 2a 2a 20 73 74 k. SQLite.** st
ded0: 69 6c 6c 20 77 6f 72 6b 73 20 77 68 65 6e 20 79 ill works when y
dee0: 6f 75 20 64 6f 20 74 68 69 73 2c 20 62 75 74 20 ou do this, but
def0: 63 6f 6e 63 75 72 72 65 6e 63 79 20 69 73 20 72 concurrency is r
df00: 65 64 75 63 65 64 20 73 69 6e 63 65 0a 2a 2a 20 educed since.**
df10: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 70 72 only a single pr
df20: 6f 63 65 73 73 20 63 61 6e 20 62 65 20 72 65 61 ocess can be rea
df30: 64 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 ding the databas
df40: 65 20 61 74 20 61 20 74 69 6d 65 2e 0a 2a 2a 0a e at a time..**.
df50: 2a 2a 20 4f 6d 69 74 20 74 68 69 73 20 73 65 63 ** Omit this sec
df60: 74 69 6f 6e 20 69 66 20 53 51 4c 49 54 45 5f 45 tion if SQLITE_E
df70: 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
df80: 59 4c 45 20 69 73 20 74 75 72 6e 65 64 20 6f 66 YLE is turned of
df90: 66 20 6f 72 20 69 66 0a 2a 2a 20 63 6f 6d 70 69 f or if.** compi
dfa0: 6c 69 6e 67 20 66 6f 72 20 56 58 57 4f 52 4b 53 ling for VXWORKS
dfb0: 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f ..*/.#if SQLITE_
dfc0: 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
dfd0: 54 59 4c 45 20 26 26 20 21 4f 53 5f 56 58 57 4f TYLE && !OS_VXWO
dfe0: 52 4b 53 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 RKS../*.** This
dff0: 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 routine checks i
e000: 66 20 74 68 65 72 65 20 69 73 20 61 20 52 45 53 f there is a RES
e010: 45 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 20 ERVED lock held
e020: 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 on the specified
e030: 0a 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 73 .** file by this
e040: 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 72 or any other pr
e050: 6f 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 61 ocess. If such a
e060: 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 73 lock is held, s
e070: 65 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 74 et *pResOut.** t
e080: 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c o a non-zero val
e090: 75 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 52 ue otherwise *pR
e0a0: 65 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20 esOut is set to
e0b0: 7a 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 72 zero. The retur
e0c0: 6e 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 n value.** is se
e0d0: 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 75 t to SQLITE_OK u
e0e0: 6e 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 72 nless an I/O err
e0f0: 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 or occurs during
e100: 20 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e 0a lock checking..
e110: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 6c */.static int fl
e120: 6f 63 6b 43 68 65 63 6b 52 65 73 65 72 76 65 64 ockCheckReserved
e130: 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c Lock(sqlite3_fil
e140: 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 e *id, int *pRes
e150: 4f 75 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d Out){. int rc =
e160: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e SQLITE_OK;. in
e170: 74 20 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a t reserved = 0;.
e180: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
e190: 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
e1a0: 64 3b 0a 20 20 0a 20 20 53 69 6d 75 6c 61 74 65 d;. . Simulate
e1b0: 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 IOError( return
e1c0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 SQLITE_IOERR_CHE
e1d0: 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 CKRESERVEDLOCK;
e1e0: 29 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 );. . assert(
e1f0: 70 46 69 6c 65 20 29 3b 0a 20 20 0a 20 20 2f 2a pFile );. . /*
e200: 20 43 68 65 63 6b 20 69 66 20 61 20 74 68 72 65 Check if a thre
e210: 61 64 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65 ad in this proce
e220: 73 73 20 68 6f 6c 64 73 20 73 75 63 68 20 61 20 ss holds such a
e230: 6c 6f 63 6b 20 2a 2f 0a 20 20 69 66 28 20 70 46 lock */. if( pF
e240: 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 53 ile->eFileLock>S
e250: 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 HARED_LOCK ){.
e260: 20 20 72 65 73 65 72 76 65 64 20 3d 20 31 3b 0a reserved = 1;.
e270: 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 4f 74 68 65 }. . /* Othe
e280: 72 77 69 73 65 20 73 65 65 20 69 66 20 73 6f 6d rwise see if som
e290: 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 e other process
e2a0: 68 6f 6c 64 73 20 69 74 2e 20 2a 2f 0a 20 20 69 holds it. */. i
e2b0: 66 28 20 21 72 65 73 65 72 76 65 64 20 29 7b 0a f( !reserved ){.
e2c0: 20 20 20 20 2f 2a 20 61 74 74 65 6d 70 74 20 74 /* attempt t
e2d0: 6f 20 67 65 74 20 74 68 65 20 6c 6f 63 6b 20 2a o get the lock *
e2e0: 2f 0a 20 20 20 20 69 6e 74 20 6c 72 63 20 3d 20 /. int lrc =
e2f0: 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e 68 2c 20 flock(pFile->h,
e300: 4c 4f 43 4b 5f 45 58 20 7c 20 4c 4f 43 4b 5f 4e LOCK_EX | LOCK_N
e310: 42 29 3b 0a 20 20 20 20 69 66 28 20 21 6c 72 63 B);. if( !lrc
e320: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 67 6f 74 ){. /* got
e330: 20 74 68 65 20 6c 6f 63 6b 2c 20 75 6e 6c 6f 63 the lock, unloc
e340: 6b 20 69 74 20 2a 2f 0a 20 20 20 20 20 20 6c 72 k it */. lr
e350: 63 20 3d 20 66 6c 6f 63 6b 28 70 46 69 6c 65 2d c = flock(pFile-
e360: 3e 68 2c 20 4c 4f 43 4b 5f 55 4e 29 3b 0a 20 20 >h, LOCK_UN);.
e370: 20 20 20 20 69 66 20 28 20 6c 72 63 20 29 20 7b if ( lrc ) {
e380: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 74 45 72 . int tEr
e390: 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 rno = errno;.
e3a0: 20 20 20 20 20 2f 2a 20 75 6e 6c 6f 63 6b 20 66 /* unlock f
e3b0: 61 69 6c 65 64 20 77 69 74 68 20 61 6e 20 65 72 ailed with an er
e3c0: 72 6f 72 20 2a 2f 0a 20 20 20 20 20 20 20 20 6c ror */. l
e3d0: 72 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 rc = sqliteError
e3e0: 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 FromPosixError(t
e3f0: 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f Errno, SQLITE_IO
e400: 45 52 52 5f 55 4e 4c 4f 43 4b 29 3b 20 0a 20 20 ERR_UNLOCK); .
e410: 20 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 if( IS_LOC
e420: 4b 5f 45 52 52 4f 52 28 6c 72 63 29 20 29 7b 0a K_ERROR(lrc) ){.
e430: 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d pFile-
e440: 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 >lastErrno = tEr
e450: 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 rno;. r
e460: 63 20 3d 20 6c 72 63 3b 0a 20 20 20 20 20 20 20 c = lrc;.
e470: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
e480: 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 69 6e else {. in
e490: 74 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f t tErrno = errno
e4a0: 3b 0a 20 20 20 20 20 20 72 65 73 65 72 76 65 64 ;. reserved
e4b0: 20 3d 20 31 3b 0a 20 20 20 20 20 20 2f 2a 20 73 = 1;. /* s
e4c0: 6f 6d 65 6f 6e 65 20 65 6c 73 65 20 6d 69 67 68 omeone else migh
e4d0: 74 20 68 61 76 65 20 69 74 20 72 65 73 65 72 76 t have it reserv
e4e0: 65 64 20 2a 2f 0a 20 20 20 20 20 20 6c 72 63 20 ed */. lrc
e4f0: 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f = sqliteErrorFro
e500: 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 mPosixError(tErr
e510: 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 no, SQLITE_IOERR
e520: 5f 4c 4f 43 4b 29 3b 20 0a 20 20 20 20 20 20 69 _LOCK); . i
e530: 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 f( IS_LOCK_ERROR
e540: 28 6c 72 63 29 20 29 7b 0a 20 20 20 20 20 20 20 (lrc) ){.
e550: 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e pFile->lastErrn
e560: 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 20 20 20 o = tErrno;.
e570: 20 20 20 20 72 63 20 3d 20 6c 72 63 3b 0a 20 20 rc = lrc;.
e580: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
e590: 20 20 4f 53 54 52 41 43 45 28 28 22 54 45 53 54 OSTRACE(("TEST
e5a0: 20 57 52 2d 4c 4f 43 4b 20 25 64 20 25 64 20 25 WR-LOCK %d %d %
e5b0: 64 20 28 66 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46 d (flock)\n", pF
e5c0: 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72 65 73 65 ile->h, rc, rese
e5d0: 72 76 65 64 29 29 3b 0a 0a 23 69 66 64 65 66 20 rved));..#ifdef
e5e0: 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f 46 4c SQLITE_IGNORE_FL
e5f0: 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52 53 0a OCK_LOCK_ERRORS.
e600: 20 20 69 66 28 20 28 72 63 20 26 20 53 51 4c 49 if( (rc & SQLI
e610: 54 45 5f 49 4f 45 52 52 29 20 3d 3d 20 53 51 4c TE_IOERR) == SQL
e620: 49 54 45 5f 49 4f 45 52 52 20 29 7b 0a 20 20 20 ITE_IOERR ){.
e630: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
e640: 0a 20 20 20 20 72 65 73 65 72 76 65 64 3d 31 3b . reserved=1;
e650: 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 . }.#endif /* S
e660: 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f 46 4c 4f QLITE_IGNORE_FLO
e670: 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52 53 20 2a CK_LOCK_ERRORS *
e680: 2f 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 72 /. *pResOut = r
e690: 65 73 65 72 76 65 64 3b 0a 20 20 72 65 74 75 72 eserved;. retur
e6a0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c n rc;.}../*.** L
e6b0: 6f 63 6b 20 74 68 65 20 66 69 6c 65 20 77 69 74 ock the file wit
e6c0: 68 20 74 68 65 20 6c 6f 63 6b 20 73 70 65 63 69 h the lock speci
e6d0: 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 fied by paramete
e6e0: 72 20 65 46 69 6c 65 4c 6f 63 6b 20 2d 20 6f 6e r eFileLock - on
e6f0: 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c e.** of the foll
e700: 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 owing:.**.**
e710: 20 28 31 29 20 53 48 41 52 45 44 5f 4c 4f 43 4b (1) SHARED_LOCK
e720: 0a 2a 2a 20 20 20 20 20 28 32 29 20 52 45 53 45 .** (2) RESE
e730: 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 RVED_LOCK.**
e740: 20 28 33 29 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 (3) PENDING_LOC
e750: 4b 0a 2a 2a 20 20 20 20 20 28 34 29 20 45 58 43 K.** (4) EXC
e760: 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a 2a LUSIVE_LOCK.**.*
e770: 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 68 65 6e * Sometimes when
e780: 20 72 65 71 75 65 73 74 69 6e 67 20 6f 6e 65 20 requesting one
e790: 6c 6f 63 6b 20 73 74 61 74 65 2c 20 61 64 64 69 lock state, addi
e7a0: 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 74 tional lock stat
e7b0: 65 73 0a 2a 2a 20 61 72 65 20 69 6e 73 65 72 74 es.** are insert
e7c0: 65 64 20 69 6e 20 62 65 74 77 65 65 6e 2e 20 20 ed in between.
e7d0: 54 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 69 67 68 The locking migh
e7e0: 74 20 66 61 69 6c 20 6f 6e 20 6f 6e 65 20 6f 66 t fail on one of
e7f0: 20 74 68 65 20 6c 61 74 65 72 0a 2a 2a 20 74 72 the later.** tr
e800: 61 6e 73 69 74 69 6f 6e 73 20 6c 65 61 76 69 6e ansitions leavin
e810: 67 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74 65 g the lock state
e820: 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 different from
e830: 77 68 61 74 20 69 74 20 73 74 61 72 74 65 64 20 what it started
e840: 62 75 74 0a 2a 2a 20 73 74 69 6c 6c 20 73 68 6f but.** still sho
e850: 72 74 20 6f 66 20 69 74 73 20 67 6f 61 6c 2e 20 rt of its goal.
e860: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 The following c
e870: 68 61 72 74 20 73 68 6f 77 73 20 74 68 65 20 61 hart shows the a
e880: 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 61 6e 73 69 llowed.** transi
e890: 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 69 6e tions and the in
e8a0: 73 65 72 74 65 64 20 69 6e 74 65 72 6d 65 64 69 serted intermedi
e8b0: 61 74 65 20 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a ate states:.**.*
e8c0: 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 44 20 2d 3e * UNLOCKED ->
e8d0: 20 53 48 41 52 45 44 0a 2a 2a 20 20 20 20 53 48 SHARED.** SH
e8e0: 41 52 45 44 20 2d 3e 20 52 45 53 45 52 56 45 44 ARED -> RESERVED
e8f0: 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e .** SHARED ->
e900: 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58 (PENDING) -> EX
e910: 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 52 45 CLUSIVE.** RE
e920: 53 45 52 56 45 44 20 2d 3e 20 28 50 45 4e 44 49 SERVED -> (PENDI
e930: 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 NG) -> EXCLUSIVE
e940: 0a 2a 2a 20 20 20 20 50 45 4e 44 49 4e 47 20 2d .** PENDING -
e950: 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 0a 2a > EXCLUSIVE.**.*
e960: 2a 20 66 6c 6f 63 6b 28 29 20 6f 6e 6c 79 20 72 * flock() only r
e970: 65 61 6c 6c 79 20 73 75 70 70 6f 72 74 20 45 58 eally support EX
e980: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 73 2e 20 20 CLUSIVE locks.
e990: 57 65 20 74 72 61 63 6b 20 69 6e 74 65 72 6d 65 We track interme
e9a0: 64 69 61 74 65 0a 2a 2a 20 6c 6f 63 6b 20 73 74 diate.** lock st
e9b0: 61 74 65 73 20 69 6e 20 74 68 65 20 73 71 6c 69 ates in the sqli
e9c0: 74 65 33 5f 66 69 6c 65 20 73 74 72 75 63 74 75 te3_file structu
e9d0: 72 65 2c 20 62 75 74 20 61 6c 6c 20 6c 6f 63 6b re, but all lock
e9e0: 73 20 53 48 41 52 45 44 20 6f 72 0a 2a 2a 20 61 s SHARED or.** a
e9f0: 62 6f 76 65 20 61 72 65 20 72 65 61 6c 6c 79 20 bove are really
ea00: 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 73 20 EXCLUSIVE locks
ea10: 61 6e 64 20 65 78 63 6c 75 64 65 20 61 6c 6c 20 and exclude all
ea20: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 other processes
ea30: 66 72 6f 6d 0a 2a 2a 20 61 63 63 65 73 73 20 74 from.** access t
ea40: 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 he file..**.** T
ea50: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c his routine will
ea60: 20 6f 6e 6c 79 20 69 6e 63 72 65 61 73 65 20 61 only increase a
ea70: 20 6c 6f 63 6b 2e 20 20 55 73 65 20 74 68 65 20 lock. Use the
ea80: 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 sqlite3OsUnlock(
ea90: 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 74 6f 20 ).** routine to
eaa0: 6c 6f 77 65 72 20 61 20 6c 6f 63 6b 69 6e 67 20 lower a locking
eab0: 6c 65 76 65 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 level..*/.static
eac0: 20 69 6e 74 20 66 6c 6f 63 6b 4c 6f 63 6b 28 73 int flockLock(s
ead0: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c qlite3_file *id,
eae0: 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 int eFileLock)
eaf0: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
eb00: 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 ITE_OK;. unixFi
eb10: 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 le *pFile = (uni
eb20: 78 46 69 6c 65 2a 29 69 64 3b 0a 0a 20 20 61 73 xFile*)id;.. as
eb30: 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 0a sert( pFile );..
eb40: 20 20 2f 2a 20 69 66 20 77 65 20 61 6c 72 65 61 /* if we alrea
eb50: 64 79 20 68 61 76 65 20 61 20 6c 6f 63 6b 2c 20 dy have a lock,
eb60: 69 74 20 69 73 20 65 78 63 6c 75 73 69 76 65 2e it is exclusive.
eb70: 20 20 0a 20 20 2a 2a 20 4a 75 73 74 20 61 64 6a . ** Just adj
eb80: 75 73 74 20 6c 65 76 65 6c 20 61 6e 64 20 70 75 ust level and pu
eb90: 6e 74 20 6f 6e 20 6f 75 74 74 61 20 68 65 72 65 nt on outta here
eba0: 2e 20 2a 2f 0a 20 20 69 66 20 28 70 46 69 6c 65 . */. if (pFile
ebb0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f ->eFileLock > NO
ebc0: 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 70 46 69 _LOCK) {. pFi
ebd0: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 le->eFileLock =
ebe0: 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 eFileLock;. r
ebf0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
ec00: 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 67 72 61 . }. . /* gra
ec10: 62 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c b an exclusive l
ec20: 6f 63 6b 20 2a 2f 0a 20 20 0a 20 20 69 66 20 28 ock */. . if (
ec30: 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e 68 2c 20 flock(pFile->h,
ec40: 4c 4f 43 4b 5f 45 58 20 7c 20 4c 4f 43 4b 5f 4e LOCK_EX | LOCK_N
ec50: 42 29 29 20 7b 0a 20 20 20 20 69 6e 74 20 74 45 B)) {. int tE
ec60: 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 rrno = errno;.
ec70: 20 20 2f 2a 20 64 69 64 6e 27 74 20 67 65 74 2c /* didn't get,
ec80: 20 6d 75 73 74 20 62 65 20 62 75 73 79 20 2a 2f must be busy */
ec90: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
eca0: 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 ErrorFromPosixEr
ecb0: 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 ror(tErrno, SQLI
ecc0: 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 0a TE_IOERR_LOCK);.
ecd0: 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f if( IS_LOCK_
ece0: 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 ERROR(rc) ){.
ecf0: 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 pFile->lastEr
ed00: 72 6e 6f 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 20 rno = tErrno;.
ed10: 20 20 7d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 }. } else {.
ed20: 20 20 20 2f 2a 20 67 6f 74 20 69 74 2c 20 73 65 /* got it, se
ed30: 74 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 72 t the type and r
ed40: 65 74 75 72 6e 20 6f 6b 20 2a 2f 0a 20 20 20 20 eturn ok */.
ed50: 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
ed60: 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 = eFileLock;.
ed70: 7d 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c 4f }. OSTRACE(("LO
ed80: 43 4b 20 20 20 20 25 64 20 25 73 20 25 73 20 28 CK %d %s %s (
ed90: 66 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46 69 6c 65 flock)\n", pFile
eda0: 2d 3e 68 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 ->h, azFileLock(
edb0: 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 0a 20 20 20 eFileLock), .
edc0: 20 20 20 20 20 20 20 20 72 63 3d 3d 53 51 4c 49 rc==SQLI
edd0: 54 45 5f 4f 4b 20 3f 20 22 6f 6b 22 20 3a 20 22 TE_OK ? "ok" : "
ede0: 66 61 69 6c 65 64 22 29 29 3b 0a 23 69 66 64 65 failed"));.#ifde
edf0: 66 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f f SQLITE_IGNORE_
ee00: 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52 FLOCK_LOCK_ERROR
ee10: 53 0a 20 20 69 66 28 20 28 72 63 20 26 20 53 51 S. if( (rc & SQ
ee20: 4c 49 54 45 5f 49 4f 45 52 52 29 20 3d 3d 20 53 LITE_IOERR) == S
ee30: 51 4c 49 54 45 5f 49 4f 45 52 52 20 29 7b 0a 20 QLITE_IOERR ){.
ee40: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 rc = SQLITE_B
ee50: 55 53 59 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 USY;. }.#endif
ee60: 2f 2a 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 /* SQLITE_IGNORE
ee70: 5f 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f _FLOCK_LOCK_ERRO
ee80: 52 53 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 RS */. return r
ee90: 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 c;.}.../*.** Low
eea0: 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c er the locking l
eeb0: 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 evel on file des
eec0: 63 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f criptor pFile to
eed0: 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 eFileLock. eFi
eee0: 6c 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 leLock.** must b
eef0: 65 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b e either NO_LOCK
ef00: 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e or SHARED_LOCK.
ef10: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f .**.** If the lo
ef20: 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 cking level of t
ef30: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
ef40: 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 61 74 or is already at
ef50: 20 6f 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 or below.** the
ef60: 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 requested locki
ef70: 6e 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 ng level, this r
ef80: 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f outine is a no-o
ef90: 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 p..*/.static int
efa0: 20 66 6c 6f 63 6b 55 6e 6c 6f 63 6b 28 73 71 6c flockUnlock(sql
efb0: 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 ite3_file *id, i
efc0: 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a nt eFileLock) {.
efd0: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
efe0: 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
eff0: 64 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 d;. . assert(
f000: 70 46 69 6c 65 20 29 3b 0a 20 20 4f 53 54 52 41 pFile );. OSTRA
f010: 43 45 28 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 CE(("UNLOCK %d
f020: 25 64 20 77 61 73 20 25 64 20 70 69 64 3d 25 64 %d was %d pid=%d
f030: 20 28 66 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46 69 (flock)\n", pFi
f040: 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 6b le->h, eFileLock
f050: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 46 69 ,. pFi
f060: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 67 le->eFileLock, g
f070: 65 74 70 69 64 28 29 29 29 3b 0a 20 20 61 73 73 etpid()));. ass
f080: 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d ert( eFileLock<=
f090: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 SHARED_LOCK );.
f0a0: 20 0a 20 20 2f 2a 20 6e 6f 2d 6f 70 20 69 66 20 . /* no-op if
f0b0: 70 6f 73 73 69 62 6c 65 20 2a 2f 0a 20 20 69 66 possible */. if
f0c0: 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f ( pFile->eFileLo
f0d0: 63 6b 3d 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b ck==eFileLock ){
f0e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
f0f0: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a 20 20 TE_OK;. }. .
f100: 2f 2a 20 73 68 61 72 65 64 20 63 61 6e 20 6a 75 /* shared can ju
f110: 73 74 20 62 65 20 73 65 74 20 62 65 63 61 75 73 st be set becaus
f120: 65 20 77 65 20 61 6c 77 61 79 73 20 68 61 76 65 e we always have
f130: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 2a 2f an exclusive */
f140: 0a 20 20 69 66 20 28 65 46 69 6c 65 4c 6f 63 6b . if (eFileLock
f150: 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 29 20 7b ==SHARED_LOCK) {
f160: 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c . pFile->eFil
f170: 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 eLock = eFileLoc
f180: 6b 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 k;. return SQ
f190: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a LITE_OK;. }. .
f1a0: 20 20 2f 2a 20 6e 6f 2c 20 72 65 61 6c 6c 79 2c /* no, really,
f1b0: 20 75 6e 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 69 6e unlock. */. in
f1c0: 74 20 72 63 20 3d 20 66 6c 6f 63 6b 28 70 46 69 t rc = flock(pFi
f1d0: 6c 65 2d 3e 68 2c 20 4c 4f 43 4b 5f 55 4e 29 3b le->h, LOCK_UN);
f1e0: 0a 20 20 69 66 20 28 72 63 29 20 7b 0a 20 20 20 . if (rc) {.
f1f0: 20 69 6e 74 20 72 2c 20 74 45 72 72 6e 6f 20 3d int r, tErrno =
f200: 20 65 72 72 6e 6f 3b 0a 20 20 20 20 72 20 3d 20 errno;. r =
f210: 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 sqliteErrorFromP
f220: 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f osixError(tErrno
f230: 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 , SQLITE_IOERR_U
f240: 4e 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 66 28 20 NLOCK);. if(
f250: 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 72 29 IS_LOCK_ERROR(r)
f260: 20 29 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d ){. pFile-
f270: 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 >lastErrno = tEr
f280: 72 6e 6f 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 rno;. }.#ifde
f290: 66 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f f SQLITE_IGNORE_
f2a0: 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52 FLOCK_LOCK_ERROR
f2b0: 53 0a 20 20 20 20 69 66 28 20 28 72 20 26 20 53 S. if( (r & S
f2c0: 51 4c 49 54 45 5f 49 4f 45 52 52 29 20 3d 3d 20 QLITE_IOERR) ==
f2d0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 29 7b 0a SQLITE_IOERR ){.
f2e0: 20 20 20 20 20 20 72 20 3d 20 53 51 4c 49 54 45 r = SQLITE
f2f0: 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a 23 65 6e _BUSY;. }.#en
f300: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 49 47 dif /* SQLITE_IG
f310: 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f NORE_FLOCK_LOCK_
f320: 45 52 52 4f 52 53 20 2a 2f 0a 20 20 20 20 0a 20 ERRORS */. .
f330: 20 20 20 72 65 74 75 72 6e 20 72 3b 0a 20 20 7d return r;. }
f340: 20 65 6c 73 65 20 7b 0a 20 20 20 20 70 46 69 6c else {. pFil
f350: 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e e->eFileLock = N
f360: 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 72 65 74 75 O_LOCK;. retu
f370: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
f380: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 }.}../*.** Close
f390: 20 61 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 a file..*/.stat
f3a0: 69 63 20 69 6e 74 20 66 6c 6f 63 6b 43 6c 6f 73 ic int flockClos
f3b0: 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a e(sqlite3_file *
f3c0: 69 64 29 20 7b 0a 20 20 69 66 28 20 69 64 20 29 id) {. if( id )
f3d0: 7b 0a 20 20 20 20 66 6c 6f 63 6b 55 6e 6c 6f 63 {. flockUnloc
f3e0: 6b 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a k(id, NO_LOCK);.
f3f0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 63 6c 6f }. return clo
f400: 73 65 55 6e 69 78 46 69 6c 65 28 69 64 29 3b 0a seUnixFile(id);.
f410: 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c }..#endif /* SQL
f420: 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 ITE_ENABLE_LOCKI
f430: 4e 47 5f 53 54 59 4c 45 20 26 26 20 21 4f 53 5f NG_STYLE && !OS_
f440: 56 58 57 4f 52 4b 20 2a 2f 0a 0a 2f 2a 2a 2a 2a VXWORK */../****
f450: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 ***************
f460: 45 6e 64 20 6f 66 20 74 68 65 20 66 6c 6f 63 6b End of the flock
f470: 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 lock implementa
f480: 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a tion ***********
f490: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a **********.*****
f4a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f4b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f4c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f4d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f4e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a *********/../***
f4f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f500: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f510: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f520: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a ***********.****
f540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
f550: 2a 2a 2a 2a 20 42 65 67 69 6e 20 4e 61 6d 65 64 **** Begin Named
f560: 20 53 65 6d 61 70 68 6f 72 65 20 4c 6f 63 6b 69 Semaphore Locki
f570: 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ng *************
f580: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a ***********.**.*
f590: 2a 20 4e 61 6d 65 64 20 73 65 6d 61 70 68 6f 72 * Named semaphor
f5a0: 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6f 6e 6c e locking is onl
f5b0: 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 56 y supported on V
f5c0: 78 57 6f 72 6b 73 2e 0a 2a 2a 0a 2a 2a 20 53 65 xWorks..**.** Se
f5d0: 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 69 6e 67 20 maphore locking
f5e0: 69 73 20 6c 69 6b 65 20 64 6f 74 2d 6c 6f 63 6b is like dot-lock
f5f0: 20 61 6e 64 20 66 6c 6f 63 6b 20 69 6e 20 74 68 and flock in th
f600: 61 74 20 69 74 20 72 65 61 6c 6c 79 20 6f 6e 6c at it really onl
f610: 79 0a 2a 2a 20 73 75 70 70 6f 72 74 73 20 45 58 y.** supports EX
f620: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 69 6e 67 2e CLUSIVE locking.
f630: 20 20 4f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 Only a single
f640: 70 72 6f 63 65 73 73 20 63 61 6e 20 72 65 61 64 process can read
f650: 20 6f 72 20 77 72 69 74 65 0a 2a 2a 20 74 68 65 or write.** the
f660: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 database file a
f670: 74 20 61 20 74 69 6d 65 2e 20 20 54 68 69 73 20 t a time. This
f680: 72 65 64 75 63 65 73 20 70 6f 74 65 6e 74 69 61 reduces potentia
f690: 6c 20 63 6f 6e 63 75 72 72 65 6e 63 79 2c 20 62 l concurrency, b
f6a0: 75 74 0a 2a 2a 20 6d 61 6b 65 73 20 74 68 65 20 ut.** makes the
f6b0: 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 74 lock implementat
f6c0: 69 6f 6e 20 6d 75 63 68 20 65 61 73 69 65 72 2e ion much easier.
f6d0: 0a 2a 2f 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 .*/.#if OS_VXWOR
f6e0: 4b 53 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 KS../*.** This r
f6f0: 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 66 outine checks if
f700: 20 74 68 65 72 65 20 69 73 20 61 20 52 45 53 45 there is a RESE
f710: 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 20 6f RVED lock held o
f720: 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 0a n the specified.
f730: 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 73 20 ** file by this
f740: 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f or any other pro
f750: 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 61 20 cess. If such a
f760: 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 73 65 lock is held, se
f770: 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 74 6f t *pResOut.** to
f780: 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 a non-zero valu
f790: 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 52 65 e otherwise *pRe
f7a0: 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20 7a sOut is set to z
f7b0: 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 72 6e ero. The return
f7c0: 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 74 value.** is set
f7d0: 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 75 6e to SQLITE_OK un
f7e0: 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 72 6f less an I/O erro
f7f0: 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20 r occurs during
f800: 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e 0a 2a lock checking..*
f810: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 6d /.static int sem
f820: 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 CheckReservedLoc
f830: 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a k(sqlite3_file *
f840: 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 id, int *pResOut
f850: 29 20 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 ) {. int rc = S
f860: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 QLITE_OK;. int
f870: 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a 20 20 reserved = 0;.
f880: 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 unixFile *pFile
f890: 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b = (unixFile*)id;
f8a0: 0a 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 .. SimulateIOEr
f8b0: 72 6f 72 28 20 72 65 74 75 72 6e 20 53 51 4c 49 ror( return SQLI
f8c0: 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 TE_IOERR_CHECKRE
f8d0: 53 45 52 56 45 44 4c 4f 43 4b 3b 20 29 3b 0a 20 SERVEDLOCK; );.
f8e0: 20 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c . assert( pFil
f8f0: 65 20 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b e );.. /* Check
f900: 20 69 66 20 61 20 74 68 72 65 61 64 20 69 6e 20 if a thread in
f910: 74 68 69 73 20 70 72 6f 63 65 73 73 20 68 6f 6c this process hol
f920: 64 73 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 2a ds such a lock *
f930: 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 /. if( pFile->e
f940: 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f FileLock>SHARED_
f950: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 65 73 65 LOCK ){. rese
f960: 72 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 rved = 1;. }.
f970: 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 73 65 20 . /* Otherwise
f980: 73 65 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 see if some othe
f990: 72 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 r process holds
f9a0: 69 74 2e 20 2a 2f 0a 20 20 69 66 28 20 21 72 65 it. */. if( !re
f9b0: 73 65 72 76 65 64 20 29 7b 0a 20 20 20 20 73 65 served ){. se
f9c0: 6d 5f 74 20 2a 70 53 65 6d 20 3d 20 70 46 69 6c m_t *pSem = pFil
f9d0: 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 6d 3b e->pInode->pSem;
f9e0: 0a 20 20 20 20 73 74 72 75 63 74 20 73 74 61 74 . struct stat
f9f0: 20 73 74 61 74 42 75 66 3b 0a 0a 20 20 20 20 69 statBuf;.. i
fa00: 66 28 20 73 65 6d 5f 74 72 79 77 61 69 74 28 70 f( sem_trywait(p
fa10: 53 65 6d 29 3d 3d 2d 31 20 29 7b 0a 20 20 20 20 Sem)==-1 ){.
fa20: 20 20 69 6e 74 20 74 45 72 72 6e 6f 20 3d 20 65 int tErrno = e
fa30: 72 72 6e 6f 3b 0a 20 20 20 20 20 20 69 66 28 20 rrno;. if(
fa40: 45 41 47 41 49 4e 20 21 3d 20 74 45 72 72 6e 6f EAGAIN != tErrno
fa50: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
fa60: 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d sqliteErrorFrom
fa70: 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e PosixError(tErrn
fa80: 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f o, SQLITE_IOERR_
fa90: 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 CHECKRESERVEDLOC
faa0: 4b 29 3b 0a 20 20 20 20 20 20 20 20 70 46 69 6c K);. pFil
fab0: 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 74 e->lastErrno = t
fac0: 45 72 72 6e 6f 3b 0a 20 20 20 20 20 20 7d 20 65 Errno;. } e
fad0: 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 2f 2a lse {. /*
fae0: 20 73 6f 6d 65 6f 6e 65 20 65 6c 73 65 20 68 61 someone else ha
faf0: 73 20 74 68 65 20 6c 6f 63 6b 20 77 68 65 6e 20 s the lock when
fb00: 77 65 20 61 72 65 20 69 6e 20 4e 4f 5f 4c 4f 43 we are in NO_LOC
fb10: 4b 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 65 73 K */. res
fb20: 65 72 76 65 64 20 3d 20 28 70 46 69 6c 65 2d 3e erved = (pFile->
fb30: 65 46 69 6c 65 4c 6f 63 6b 20 3c 20 53 48 41 52 eFileLock < SHAR
fb40: 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 ED_LOCK);.
fb50: 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
fb60: 20 20 20 2f 2a 20 77 65 20 63 6f 75 6c 64 20 68 /* we could h
fb70: 61 76 65 20 69 74 20 69 66 20 77 65 20 77 61 6e ave it if we wan
fb80: 74 20 69 74 20 2a 2f 0a 20 20 20 20 20 20 73 65 t it */. se
fb90: 6d 5f 70 6f 73 74 28 70 53 65 6d 29 3b 0a 20 20 m_post(pSem);.
fba0: 20 20 7d 0a 20 20 7d 0a 20 20 4f 53 54 52 41 43 }. }. OSTRAC
fbb0: 45 28 28 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b E(("TEST WR-LOCK
fbc0: 20 25 64 20 25 64 20 25 64 20 28 73 65 6d 29 5c %d %d %d (sem)\
fbd0: 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 72 63 n", pFile->h, rc
fbe0: 2c 20 72 65 73 65 72 76 65 64 29 29 3b 0a 0a 20 , reserved));..
fbf0: 20 2a 70 52 65 73 4f 75 74 20 3d 20 72 65 73 65 *pResOut = rese
fc00: 72 76 65 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 rved;. return r
fc10: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b c;.}../*.** Lock
fc20: 20 74 68 65 20 66 69 6c 65 20 77 69 74 68 20 74 the file with t
fc30: 68 65 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 he lock specifie
fc40: 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 65 d by parameter e
fc50: 46 69 6c 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a FileLock - one.*
fc60: 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 * of the followi
fc70: 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 ng:.**.** (1
fc80: 29 20 53 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a ) SHARED_LOCK.**
fc90: 20 20 20 20 20 28 32 29 20 52 45 53 45 52 56 45 (2) RESERVE
fca0: 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 D_LOCK.** (3
fcb0: 29 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a ) PENDING_LOCK.*
fcc0: 2a 20 20 20 20 20 28 34 29 20 45 58 43 4c 55 53 * (4) EXCLUS
fcd0: 49 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 IVE_LOCK.**.** S
fce0: 6f 6d 65 74 69 6d 65 73 20 77 68 65 6e 20 72 65 ometimes when re
fcf0: 71 75 65 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 questing one loc
fd00: 6b 20 73 74 61 74 65 2c 20 61 64 64 69 74 69 6f k state, additio
fd10: 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a nal lock states.
fd20: 2a 2a 20 61 72 65 20 69 6e 73 65 72 74 65 64 20 ** are inserted
fd30: 69 6e 20 62 65 74 77 65 65 6e 2e 20 20 54 68 65 in between. The
fd40: 20 6c 6f 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 locking might f
fd50: 61 69 6c 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 ail on one of th
fd60: 65 20 6c 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 e later.** trans
fd70: 69 74 69 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 itions leaving t
fd80: 68 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 he lock state di
fd90: 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 fferent from wha
fda0: 74 20 69 74 20 73 74 61 72 74 65 64 20 62 75 74 t it started but
fdb0: 0a 2a 2a 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 .** still short
fdc0: 6f 66 20 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 of its goal. Th
fdd0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 e following char
fde0: 74 20 73 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f t shows the allo
fdf0: 77 65 64 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f wed.** transitio
fe00: 6e 73 20 61 6e 64 20 74 68 65 20 69 6e 73 65 72 ns and the inser
fe10: 74 65 64 20 69 6e 74 65 72 6d 65 64 69 61 74 65 ted intermediate
fe20: 20 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 states:.**.**
fe30: 20 20 55 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 UNLOCKED -> SH
fe40: 41 52 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 ARED.** SHARE
fe50: 44 20 2d 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a D -> RESERVED.**
fe60: 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 28 50 SHARED -> (P
fe70: 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 ENDING) -> EXCLU
fe80: 53 49 56 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 SIVE.** RESER
fe90: 56 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 VED -> (PENDING)
fea0: 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a -> EXCLUSIVE.**
feb0: 20 20 20 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 PENDING -> E
fec0: 58 43 4c 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 53 XCLUSIVE.**.** S
fed0: 65 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 73 20 6f emaphore locks o
fee0: 6e 6c 79 20 72 65 61 6c 6c 79 20 73 75 70 70 6f nly really suppo
fef0: 72 74 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 rt EXCLUSIVE loc
ff00: 6b 73 2e 20 20 57 65 20 74 72 61 63 6b 20 69 6e ks. We track in
ff10: 74 65 72 6d 65 64 69 61 74 65 0a 2a 2a 20 6c 6f termediate.** lo
ff20: 63 6b 20 73 74 61 74 65 73 20 69 6e 20 74 68 65 ck states in the
ff30: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 73 74 sqlite3_file st
ff40: 72 75 63 74 75 72 65 2c 20 62 75 74 20 61 6c 6c ructure, but all
ff50: 20 6c 6f 63 6b 73 20 53 48 41 52 45 44 20 6f 72 locks SHARED or
ff60: 0a 2a 2a 20 61 62 6f 76 65 20 61 72 65 20 72 65 .** above are re
ff70: 61 6c 6c 79 20 45 58 43 4c 55 53 49 56 45 20 6c ally EXCLUSIVE l
ff80: 6f 63 6b 73 20 61 6e 64 20 65 78 63 6c 75 64 65 ocks and exclude
ff90: 20 61 6c 6c 20 6f 74 68 65 72 20 70 72 6f 63 65 all other proce
ffa0: 73 73 65 73 20 66 72 6f 6d 0a 2a 2a 20 61 63 63 sses from.** acc
ffb0: 65 73 73 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a ess the file..**
ffc0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
ffd0: 20 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 65 will only incre
ffe0: 61 73 65 20 61 20 6c 6f 63 6b 2e 20 20 55 73 65 ase a lock. Use
fff0: 20 74 68 65 20 73 71 6c 69 74 65 33 4f 73 55 6e the sqlite3OsUn
10000 6c 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e lock().** routin
10010 65 20 74 6f 20 6c 6f 77 65 72 20 61 20 6c 6f 63 e to lower a loc
10020 6b 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 73 king level..*/.s
10030 74 61 74 69 63 20 69 6e 74 20 73 65 6d 4c 6f 63 tatic int semLoc
10040 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a k(sqlite3_file *
10050 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 id, int eFileLoc
10060 6b 29 20 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 k) {. unixFile
10070 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 *pFile = (unixFi
10080 6c 65 2a 29 69 64 3b 0a 20 20 69 6e 74 20 66 64 le*)id;. int fd
10090 3b 0a 20 20 73 65 6d 5f 74 20 2a 70 53 65 6d 20 ;. sem_t *pSem
100a0 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d = pFile->pInode-
100b0 3e 70 53 65 6d 3b 0a 20 20 69 6e 74 20 72 63 20 >pSem;. int rc
100c0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
100d0 2f 2a 20 69 66 20 77 65 20 61 6c 72 65 61 64 79 /* if we already
100e0 20 68 61 76 65 20 61 20 6c 6f 63 6b 2c 20 69 74 have a lock, it
100f0 20 69 73 20 65 78 63 6c 75 73 69 76 65 2e 20 20 is exclusive.
10100 0a 20 20 2a 2a 20 4a 75 73 74 20 61 64 6a 75 73 . ** Just adjus
10110 74 20 6c 65 76 65 6c 20 61 6e 64 20 70 75 6e 74 t level and punt
10120 20 6f 6e 20 6f 75 74 74 61 20 68 65 72 65 2e 20 on outta here.
10130 2a 2f 0a 20 20 69 66 20 28 70 46 69 6c 65 2d 3e */. if (pFile->
10140 65 46 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f 5f 4c eFileLock > NO_L
10150 4f 43 4b 29 20 7b 0a 20 20 20 20 70 46 69 6c 65 OCK) {. pFile
10160 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 ->eFileLock = eF
10170 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 63 20 ileLock;. rc
10180 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
10190 20 67 6f 74 6f 20 73 65 6d 5f 65 6e 64 5f 6c 6f goto sem_end_lo
101a0 63 6b 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 ck;. }. . /*
101b0 6c 6f 63 6b 20 73 65 6d 61 70 68 6f 72 65 20 6e lock semaphore n
101c0 6f 77 20 62 75 74 20 62 61 69 6c 20 6f 75 74 20 ow but bail out
101d0 77 68 65 6e 20 61 6c 72 65 61 64 79 20 6c 6f 63 when already loc
101e0 6b 65 64 2e 20 2a 2f 0a 20 20 69 66 28 20 73 65 ked. */. if( se
101f0 6d 5f 74 72 79 77 61 69 74 28 70 53 65 6d 29 3d m_trywait(pSem)=
10200 3d 2d 31 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 =-1 ){. rc =
10210 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
10220 20 67 6f 74 6f 20 73 65 6d 5f 65 6e 64 5f 6c 6f goto sem_end_lo
10230 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 67 6f ck;. }.. /* go
10240 74 20 69 74 2c 20 73 65 74 20 74 68 65 20 74 79 t it, set the ty
10250 70 65 20 61 6e 64 20 72 65 74 75 72 6e 20 6f 6b pe and return ok
10260 20 2a 2f 0a 20 20 70 46 69 6c 65 2d 3e 65 46 69 */. pFile->eFi
10270 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f leLock = eFileLo
10280 63 6b 3b 0a 0a 20 73 65 6d 5f 65 6e 64 5f 6c 6f ck;.. sem_end_lo
10290 63 6b 3a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b ck:. return rc;
102a0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 .}../*.** Lower
102b0 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 the locking leve
102c0 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69 l on file descri
102d0 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46 ptor pFile to eF
102e0 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c ileLock. eFileL
102f0 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 ock.** must be e
10300 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 ither NO_LOCK or
10310 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a SHARED_LOCK..**
10320 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69 .** If the locki
10330 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 ng level of the
10340 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
10350 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72 is already at or
10360 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65 below.** the re
10370 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20 quested locking
10380 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74 level, this rout
10390 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a ine is a no-op..
103a0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 */.static int se
103b0 6d 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f mUnlock(sqlite3_
103c0 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65 46 file *id, int eF
103d0 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 75 6e 69 ileLock) {. uni
103e0 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 xFile *pFile = (
103f0 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 unixFile*)id;.
10400 73 65 6d 5f 74 20 2a 70 53 65 6d 20 3d 20 70 46 sem_t *pSem = pF
10410 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 ile->pInode->pSe
10420 6d 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 m;.. assert( pF
10430 69 6c 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ile );. assert(
10440 20 70 53 65 6d 20 29 3b 0a 20 20 4f 53 54 52 41 pSem );. OSTRA
10450 43 45 28 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 CE(("UNLOCK %d
10460 25 64 20 77 61 73 20 25 64 20 70 69 64 3d 25 64 %d was %d pid=%d
10470 20 28 73 65 6d 29 5c 6e 22 2c 20 70 46 69 6c 65 (sem)\n", pFile
10480 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 0a ->h, eFileLock,.
10490 09 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 . pFile->eFile
104a0 4c 6f 63 6b 2c 20 67 65 74 70 69 64 28 29 29 29 Lock, getpid()))
104b0 3b 0a 20 20 61 73 73 65 72 74 28 20 65 46 69 6c ;. assert( eFil
104c0 65 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f eLock<=SHARED_LO
104d0 43 4b 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 6e 6f CK );. . /* no
104e0 2d 6f 70 20 69 66 20 70 6f 73 73 69 62 6c 65 20 -op if possible
104f0 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e */. if( pFile->
10500 65 46 69 6c 65 4c 6f 63 6b 3d 3d 65 46 69 6c 65 eFileLock==eFile
10510 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 72 65 74 75 Lock ){. retu
10520 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
10530 7d 0a 20 20 0a 20 20 2f 2a 20 73 68 61 72 65 64 }. . /* shared
10540 20 63 61 6e 20 6a 75 73 74 20 62 65 20 73 65 74 can just be set
10550 20 62 65 63 61 75 73 65 20 77 65 20 61 6c 77 61 because we alwa
10560 79 73 20 68 61 76 65 20 61 6e 20 65 78 63 6c 75 ys have an exclu
10570 73 69 76 65 20 2a 2f 0a 20 20 69 66 20 28 65 46 sive */. if (eF
10580 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f ileLock==SHARED_
10590 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 70 46 69 6c LOCK) {. pFil
105a0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 e->eFileLock = e
105b0 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 65 FileLock;. re
105c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
105d0 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 6e 6f 2c 20 }. . /* no,
105e0 72 65 61 6c 6c 79 20 75 6e 6c 6f 63 6b 2e 20 2a really unlock. *
105f0 2f 0a 20 20 69 66 20 28 20 73 65 6d 5f 70 6f 73 /. if ( sem_pos
10600 74 28 70 53 65 6d 29 3d 3d 2d 31 20 29 20 7b 0a t(pSem)==-1 ) {.
10610 20 20 20 20 69 6e 74 20 72 63 2c 20 74 45 72 72 int rc, tErr
10620 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 no = errno;.
10630 72 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 rc = sqliteError
10640 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 FromPosixError(t
10650 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f Errno, SQLITE_IO
10660 45 52 52 5f 55 4e 4c 4f 43 4b 29 3b 0a 20 20 20 ERR_UNLOCK);.
10670 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 if( IS_LOCK_ERR
10680 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 20 20 20 OR(rc) ){.
10690 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f pFile->lastErrno
106a0 20 3d 20 74 45 72 72 6e 6f 3b 0a 20 20 20 20 7d = tErrno;. }
106b0 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 20 . return rc;
106c0 0a 20 20 7d 0a 20 20 70 46 69 6c 65 2d 3e 65 46 . }. pFile->eF
106d0 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 ileLock = NO_LOC
106e0 4b 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 K;. return SQLI
106f0 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 20 2a 2a TE_OK;.}../*. **
10700 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 2e 0a 20 Close a file..
10710 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 */.static int se
10720 6d 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 mClose(sqlite3_f
10730 69 6c 65 20 2a 69 64 29 20 7b 0a 20 20 69 66 28 ile *id) {. if(
10740 20 69 64 20 29 7b 0a 20 20 20 20 75 6e 69 78 46 id ){. unixF
10750 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e ile *pFile = (un
10760 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 20 20 ixFile*)id;.
10770 73 65 6d 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f semUnlock(id, NO
10780 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 61 73 73 65 _LOCK);. asse
10790 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 20 rt( pFile );.
107a0 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 unixEnterMutex(
107b0 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 4c 6f );. releaseLo
107c0 63 6b 49 6e 66 6f 28 70 46 69 6c 65 2d 3e 70 49 ckInfo(pFile->pI
107d0 6e 6f 64 65 29 3b 0a 20 20 20 20 75 6e 69 78 4c node);. unixL
107e0 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 20 eaveMutex();.
107f0 20 63 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28 69 closeUnixFile(i
10800 64 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e d);. }. return
10810 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 SQLITE_OK;.}..#
10820 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 57 4f endif /* OS_VXWO
10830 52 4b 53 20 2a 2f 0a 2f 2a 0a 2a 2a 20 4e 61 6d RKS */./*.** Nam
10840 65 64 20 73 65 6d 61 70 68 6f 72 65 20 6c 6f 63 ed semaphore loc
10850 6b 69 6e 67 20 69 73 20 6f 6e 6c 79 20 61 76 61 king is only ava
10860 69 6c 61 62 6c 65 20 6f 6e 20 56 78 57 6f 72 6b ilable on VxWork
10870 73 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a s..**.**********
10880 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 74 68 65 ***** End of the
10890 20 6e 61 6d 65 64 20 73 65 6d 61 70 68 6f 72 65 named semaphore
108a0 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 lock implementa
108b0 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a tion ***********
108c0 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a *****.**********
108d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
108e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
108f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10900 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10910 2a 2a 2a 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a ****/.../*******
10920 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10930 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10940 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10950 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10960 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a *******.********
10970 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10980 2a 2a 2a 20 42 65 67 69 6e 20 41 46 50 20 4c 6f *** Begin AFP Lo
10990 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a cking **********
109a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
109b0 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 41 46 *******.**.** AF
109c0 50 20 69 73 20 74 68 65 20 41 70 70 6c 65 20 46 P is the Apple F
109d0 69 6c 69 6e 67 20 50 72 6f 74 6f 63 6f 6c 2e 20 iling Protocol.
109e0 20 41 46 50 20 69 73 20 61 20 6e 65 74 77 6f 72 AFP is a networ
109f0 6b 20 66 69 6c 65 73 79 73 74 65 6d 20 66 6f 75 k filesystem fou
10a00 6e 64 0a 2a 2a 20 6f 6e 20 41 70 70 6c 65 20 4d nd.** on Apple M
10a10 61 63 69 6e 74 6f 73 68 20 63 6f 6d 70 75 74 65 acintosh compute
10a20 72 73 20 2d 20 62 6f 74 68 20 4f 53 39 20 61 6e rs - both OS9 an
10a30 64 20 4f 53 58 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 d OSX..**.** Thi
10a40 72 64 2d 70 61 72 74 79 20 69 6d 70 6c 65 6d 65 rd-party impleme
10a50 6e 74 61 74 69 6f 6e 73 20 6f 66 20 41 46 50 20 ntations of AFP
10a60 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 are available.
10a70 42 75 74 20 74 68 69 73 20 63 6f 64 65 20 68 65 But this code he
10a80 72 65 0a 2a 2a 20 6f 6e 6c 79 20 77 6f 72 6b 73 re.** only works
10a90 20 6f 6e 20 4f 53 58 2e 0a 2a 2f 0a 0a 23 69 66 on OSX..*/..#if
10aa0 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 defined(__APPLE
10ab0 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e __) && SQLITE_EN
10ac0 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 ABLE_LOCKING_STY
10ad0 4c 45 0a 2f 2a 0a 2a 2a 20 54 68 65 20 61 66 70 LE./*.** The afp
10ae0 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 73 LockingContext s
10af0 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e tructure contain
10b00 73 20 61 6c 6c 20 61 66 70 20 6c 6f 63 6b 20 73 s all afp lock s
10b10 70 65 63 69 66 69 63 20 73 74 61 74 65 0a 2a 2f pecific state.*/
10b20 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
10b30 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 afpLockingContex
10b40 74 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 t afpLockingCont
10b50 65 78 74 3b 0a 73 74 72 75 63 74 20 61 66 70 4c ext;.struct afpL
10b60 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 7b 0a ockingContext {.
10b70 20 20 69 6e 74 20 72 65 73 65 72 76 65 64 3b 0a int reserved;.
10b80 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 64 62 const char *db
10b90 50 61 74 68 3b 20 20 20 20 20 20 20 20 20 20 20 Path;
10ba0 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
10bb0 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f 0a 7d 3b open file */.};
10bc0 0a 0a 73 74 72 75 63 74 20 42 79 74 65 52 61 6e ..struct ByteRan
10bd0 67 65 4c 6f 63 6b 50 42 32 0a 7b 0a 20 20 75 6e geLockPB2.{. un
10be0 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 signed long long
10bf0 20 6f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 offset;
10c00 2f 2a 20 6f 66 66 73 65 74 20 74 6f 20 66 69 72 /* offset to fir
10c10 73 74 20 62 79 74 65 20 74 6f 20 6c 6f 63 6b 20 st byte to lock
10c20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 6c 6f */. unsigned lo
10c30 6e 67 20 6c 6f 6e 67 20 6c 65 6e 67 74 68 3b 20 ng long length;
10c40 20 20 20 20 20 20 20 2f 2a 20 6e 62 72 20 6f 66 /* nbr of
10c50 20 62 79 74 65 73 20 74 6f 20 6c 6f 63 6b 20 2a bytes to lock *
10c60 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 6c 6f 6e /. unsigned lon
10c70 67 20 6c 6f 6e 67 20 72 65 74 52 61 6e 67 65 53 g long retRangeS
10c80 74 61 72 74 3b 20 2f 2a 20 6e 62 72 20 6f 66 20 tart; /* nbr of
10c90 31 73 74 20 62 79 74 65 20 6c 6f 63 6b 65 64 20 1st byte locked
10ca0 69 66 20 73 75 63 63 65 73 73 66 75 6c 20 2a 2f if successful */
10cb0 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
10cc0 20 75 6e 4c 6f 63 6b 46 6c 61 67 3b 20 20 20 20 unLockFlag;
10cd0 20 20 20 20 20 2f 2a 20 31 20 3d 20 75 6e 6c 6f /* 1 = unlo
10ce0 63 6b 2c 20 30 20 3d 20 6c 6f 63 6b 20 2a 2f 0a ck, 0 = lock */.
10cf0 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
10d00 73 74 61 72 74 45 6e 64 46 6c 61 67 3b 20 20 20 startEndFlag;
10d10 20 20 20 20 2f 2a 20 31 3d 72 65 6c 20 74 6f 20 /* 1=rel to
10d20 65 6e 64 20 6f 66 20 66 6f 72 6b 2c 20 30 3d 72 end of fork, 0=r
10d30 65 6c 20 74 6f 20 73 74 61 72 74 20 2a 2f 0a 20 el to start */.
10d40 20 69 6e 74 20 66 64 3b 20 20 20 20 20 20 20 20 int fd;
10d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10d60 20 20 20 2f 2a 20 66 69 6c 65 20 64 65 73 63 20 /* file desc
10d70 74 6f 20 61 73 73 6f 63 20 74 68 69 73 20 6c 6f to assoc this lo
10d80 63 6b 20 77 69 74 68 20 2a 2f 0a 7d 3b 0a 0a 23 ck with */.};..#
10d90 64 65 66 69 6e 65 20 61 66 70 66 73 42 79 74 65 define afpfsByte
10da0 52 61 6e 67 65 4c 6f 63 6b 32 46 53 43 54 4c 20 RangeLock2FSCTL
10db0 20 20 20 20 20 20 20 5f 49 4f 57 52 28 27 7a 27 _IOWR('z'
10dc0 2c 20 32 33 2c 20 73 74 72 75 63 74 20 42 79 74 , 23, struct Byt
10dd0 65 52 61 6e 67 65 4c 6f 63 6b 50 42 32 29 0a 0a eRangeLockPB2)..
10de0 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 /*.** This is a
10df0 75 74 69 6c 69 74 79 20 66 6f 72 20 73 65 74 74 utility for sett
10e00 69 6e 67 20 6f 72 20 63 6c 65 61 72 69 6e 67 20 ing or clearing
10e10 61 20 62 69 74 2d 72 61 6e 67 65 20 6c 6f 63 6b a bit-range lock
10e20 20 6f 6e 20 61 6e 0a 2a 2a 20 41 46 50 20 66 69 on an.** AFP fi
10e30 6c 65 73 79 73 74 65 6d 2e 0a 2a 2a 20 0a 2a 2a lesystem..** .**
10e40 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
10e50 4b 20 6f 6e 20 73 75 63 63 65 73 73 2c 20 53 51 K on success, SQ
10e60 4c 49 54 45 5f 42 55 53 59 20 6f 6e 20 66 61 69 LITE_BUSY on fai
10e70 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 lure..*/.static
10e80 69 6e 74 20 61 66 70 53 65 74 4c 6f 63 6b 28 0a int afpSetLock(.
10e90 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 61 const char *pa
10ea0 74 68 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 th,
10eb0 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
10ec0 66 69 6c 65 20 74 6f 20 62 65 20 6c 6f 63 6b 65 file to be locke
10ed0 64 20 6f 72 20 75 6e 6c 6f 63 6b 65 64 20 2a 2f d or unlocked */
10ee0 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
10ef0 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 le,
10f00 20 20 2f 2a 20 4f 70 65 6e 20 66 69 6c 65 20 64 /* Open file d
10f10 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 70 61 74 escriptor on pat
10f20 68 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 h */. unsigned
10f30 6c 6f 6e 67 20 6c 6f 6e 67 20 6f 66 66 73 65 74 long long offset
10f40 2c 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 , /* First b
10f50 79 74 65 20 74 6f 20 62 65 20 6c 6f 63 6b 65 64 yte to be locked
10f60 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 6c */. unsigned l
10f70 6f 6e 67 20 6c 6f 6e 67 20 6c 65 6e 67 74 68 2c ong long length,
10f80 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
10f90 66 20 62 79 74 65 73 20 74 6f 20 6c 6f 63 6b 20 f bytes to lock
10fa0 2a 2f 0a 20 20 69 6e 74 20 73 65 74 4c 6f 63 6b */. int setLock
10fb0 46 6c 61 67 20 20 20 20 20 20 20 20 20 20 20 20 Flag
10fc0 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 73 /* True to s
10fd0 65 74 20 6c 6f 63 6b 2e 20 20 46 61 6c 73 65 20 et lock. False
10fe0 74 6f 20 63 6c 65 61 72 20 6c 6f 63 6b 20 2a 2f to clear lock */
10ff0 0a 29 7b 0a 20 20 73 74 72 75 63 74 20 42 79 74 .){. struct Byt
11000 65 52 61 6e 67 65 4c 6f 63 6b 50 42 32 20 70 62 eRangeLockPB2 pb
11010 3b 0a 20 20 69 6e 74 20 65 72 72 3b 0a 20 20 0a ;. int err;. .
11020 20 20 70 62 2e 75 6e 4c 6f 63 6b 46 6c 61 67 20 pb.unLockFlag
11030 3d 20 73 65 74 4c 6f 63 6b 46 6c 61 67 20 3f 20 = setLockFlag ?
11040 30 20 3a 20 31 3b 0a 20 20 70 62 2e 73 74 61 72 0 : 1;. pb.star
11050 74 45 6e 64 46 6c 61 67 20 3d 20 30 3b 0a 20 20 tEndFlag = 0;.
11060 70 62 2e 6f 66 66 73 65 74 20 3d 20 6f 66 66 73 pb.offset = offs
11070 65 74 3b 0a 20 20 70 62 2e 6c 65 6e 67 74 68 20 et;. pb.length
11080 3d 20 6c 65 6e 67 74 68 3b 20 0a 20 20 70 62 2e = length; . pb.
11090 66 64 20 3d 20 70 46 69 6c 65 2d 3e 68 3b 0a 20 fd = pFile->h;.
110a0 20 0a 20 20 4f 53 54 52 41 43 45 28 28 22 41 46 . OSTRACE(("AF
110b0 50 53 45 54 4c 4f 43 4b 20 5b 25 73 5d 20 66 6f PSETLOCK [%s] fo
110c0 72 20 25 64 25 73 20 69 6e 20 72 61 6e 67 65 20 r %d%s in range
110d0 25 6c 6c 78 3a 25 6c 6c 78 5c 6e 22 2c 20 0a 20 %llx:%llx\n", .
110e0 20 20 20 28 73 65 74 4c 6f 63 6b 46 6c 61 67 3f (setLockFlag?
110f0 22 4f 4e 22 3a 22 4f 46 46 22 29 2c 20 70 46 69 "ON":"OFF"), pFi
11100 6c 65 2d 3e 68 2c 20 28 70 62 2e 66 64 3d 3d 2d le->h, (pb.fd==-
11110 31 3f 22 5b 74 65 73 74 76 61 6c 2d 31 5d 22 3a 1?"[testval-1]":
11120 22 22 29 2c 0a 20 20 20 20 6f 66 66 73 65 74 2c ""),. offset,
11130 20 6c 65 6e 67 74 68 29 29 3b 0a 20 20 65 72 72 length));. err
11140 20 3d 20 66 73 63 74 6c 28 70 61 74 68 2c 20 61 = fsctl(path, a
11150 66 70 66 73 42 79 74 65 52 61 6e 67 65 4c 6f 63 fpfsByteRangeLoc
11160 6b 32 46 53 43 54 4c 2c 20 26 70 62 2c 20 30 29 k2FSCTL, &pb, 0)
11170 3b 0a 20 20 69 66 20 28 20 65 72 72 3d 3d 2d 31 ;. if ( err==-1
11180 20 29 20 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b ) {. int rc;
11190 0a 20 20 20 20 69 6e 74 20 74 45 72 72 6e 6f 20 . int tErrno
111a0 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 4f 53 54 = errno;. OST
111b0 52 41 43 45 28 28 22 41 46 50 53 45 54 4c 4f 43 RACE(("AFPSETLOC
111c0 4b 20 66 61 69 6c 65 64 20 74 6f 20 66 73 63 74 K failed to fsct
111d0 6c 28 29 20 27 25 73 27 20 25 64 20 25 73 5c 6e l() '%s' %d %s\n
111e0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
111f0 70 61 74 68 2c 20 74 45 72 72 6e 6f 2c 20 73 74 path, tErrno, st
11200 72 65 72 72 6f 72 28 74 45 72 72 6e 6f 29 29 29 rerror(tErrno)))
11210 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
11220 49 47 4e 4f 52 45 5f 41 46 50 5f 4c 4f 43 4b 5f IGNORE_AFP_LOCK_
11230 45 52 52 4f 52 53 0a 20 20 20 20 72 63 20 3d 20 ERRORS. rc =
11240 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 23 65 6c SQLITE_BUSY;.#el
11250 73 65 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 se. rc = sqli
11260 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 teErrorFromPosix
11270 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c 0a 20 20 Error(tErrno,.
11280 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11290 20 20 73 65 74 4c 6f 63 6b 46 6c 61 67 20 3f 20 setLockFlag ?
112a0 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 SQLITE_IOERR_LOC
112b0 4b 20 3a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 K : SQLITE_IOERR
112c0 5f 55 4e 4c 4f 43 4b 29 3b 0a 23 65 6e 64 69 66 _UNLOCK);.#endif
112d0 20 2f 2a 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 /* SQLITE_IGNOR
112e0 45 5f 41 46 50 5f 4c 4f 43 4b 5f 45 52 52 4f 52 E_AFP_LOCK_ERROR
112f0 53 20 2a 2f 0a 20 20 20 20 69 66 28 20 49 53 5f S */. if( IS_
11300 4c 4f 43 4b 5f 45 52 52 4f 52 28 72 63 29 20 29 LOCK_ERROR(rc) )
11310 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c {. pFile->l
11320 61 73 74 45 72 72 6e 6f 20 3d 20 74 45 72 72 6e astErrno = tErrn
11330 6f 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 o;. }. ret
11340 75 72 6e 20 72 63 3b 0a 20 20 7d 20 65 6c 73 65 urn rc;. } else
11350 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 {. return SQ
11360 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a LITE_OK;. }.}..
11370 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 /*.** This routi
11380 6e 65 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 ne checks if the
11390 72 65 20 69 73 20 61 20 52 45 53 45 52 56 45 44 re is a RESERVED
113a0 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 lock held on th
113b0 65 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 e specified.** f
113c0 69 6c 65 20 62 79 20 74 68 69 73 20 6f 72 20 61 ile by this or a
113d0 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 ny other process
113e0 2e 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b . If such a lock
113f0 20 69 73 20 68 65 6c 64 2c 20 73 65 74 20 2a 70 is held, set *p
11400 52 65 73 4f 75 74 0a 2a 2a 20 74 6f 20 61 20 6e ResOut.** to a n
11410 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 20 6f 74 on-zero value ot
11420 68 65 72 77 69 73 65 20 2a 70 52 65 73 4f 75 74 herwise *pResOut
11430 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e is set to zero.
11440 20 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c The return val
11450 75 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 ue.** is set to
11460 53 51 4c 49 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 SQLITE_OK unless
11470 20 61 6e 20 49 2f 4f 20 65 72 72 6f 72 20 6f 63 an I/O error oc
11480 63 75 72 73 20 64 75 72 69 6e 67 20 6c 6f 63 6b curs during lock
11490 20 63 68 65 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 checking..*/.st
114a0 61 74 69 63 20 69 6e 74 20 61 66 70 43 68 65 63 atic int afpChec
114b0 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 kReservedLock(sq
114c0 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
114d0 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 7b 0a 20 int *pResOut){.
114e0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
114f0 5f 4f 4b 3b 0a 20 20 69 6e 74 20 72 65 73 65 72 _OK;. int reser
11500 76 65 64 20 3d 20 30 3b 0a 20 20 75 6e 69 78 46 ved = 0;. unixF
11510 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e ile *pFile = (un
11520 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 0a 20 ixFile*)id;. .
11530 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 SimulateIOError
11540 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ( return SQLITE_
11550 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 IOERR_CHECKRESER
11560 56 45 44 4c 4f 43 4b 3b 20 29 3b 0a 20 20 0a 20 VEDLOCK; );. .
11570 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 assert( pFile )
11580 3b 0a 20 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f ;. afpLockingCo
11590 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 20 3d ntext *context =
115a0 20 28 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 (afpLockingCont
115b0 65 78 74 20 2a 29 20 70 46 69 6c 65 2d 3e 6c 6f ext *) pFile->lo
115c0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 ckingContext;.
115d0 69 66 28 20 63 6f 6e 74 65 78 74 2d 3e 72 65 73 if( context->res
115e0 65 72 76 65 64 20 29 7b 0a 20 20 20 20 2a 70 52 erved ){. *pR
115f0 65 73 4f 75 74 20 3d 20 31 3b 0a 20 20 20 20 72 esOut = 1;. r
11600 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
11610 0a 20 20 7d 0a 20 20 75 6e 69 78 45 6e 74 65 72 . }. unixEnter
11620 4d 75 74 65 78 28 29 3b 20 2f 2a 20 42 65 63 61 Mutex(); /* Beca
11630 75 73 65 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 use pFile->pInod
11640 65 20 69 73 20 73 68 61 72 65 64 20 61 63 72 6f e is shared acro
11650 73 73 20 74 68 72 65 61 64 73 20 2a 2f 0a 20 20 ss threads */.
11660 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 . /* Check if a
11670 20 74 68 72 65 61 64 20 69 6e 20 74 68 69 73 20 thread in this
11680 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 73 75 process holds su
11690 63 68 20 61 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 ch a lock */. i
116a0 66 28 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 f( pFile->pInode
116b0 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 ->eFileLock>SHAR
116c0 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 ED_LOCK ){. r
116d0 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 7d eserved = 1;. }
116e0 0a 20 20 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 . . /* Otherwi
116f0 73 65 20 73 65 65 20 69 66 20 73 6f 6d 65 20 6f se see if some o
11700 74 68 65 72 20 70 72 6f 63 65 73 73 20 68 6f 6c ther process hol
11710 64 73 20 69 74 2e 0a 20 20 20 2a 2f 0a 20 20 69 ds it.. */. i
11720 66 28 20 21 72 65 73 65 72 76 65 64 20 29 7b 0a f( !reserved ){.
11730 20 20 20 20 2f 2a 20 6c 6f 63 6b 20 74 68 65 20 /* lock the
11740 52 45 53 45 52 56 45 44 20 62 79 74 65 20 2a 2f RESERVED byte */
11750 0a 20 20 20 20 69 6e 74 20 6c 72 63 20 3d 20 61 . int lrc = a
11760 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 fpSetLock(contex
11770 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 t->dbPath, pFile
11780 2c 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 2c , RESERVED_BYTE,
11790 20 31 2c 31 29 3b 20 20 0a 20 20 20 20 69 66 28 1,1); . if(
117a0 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 6c 72 63 20 SQLITE_OK==lrc
117b0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 69 66 20 77 ){. /* if w
117c0 65 20 73 75 63 63 65 65 64 65 64 20 69 6e 20 74 e succeeded in t
117d0 61 6b 69 6e 67 20 74 68 65 20 72 65 73 65 72 76 aking the reserv
117e0 65 64 20 6c 6f 63 6b 2c 20 75 6e 6c 6f 63 6b 20 ed lock, unlock
117f0 69 74 20 74 6f 20 72 65 73 74 6f 72 65 0a 20 20 it to restore.
11800 20 20 20 20 2a 2a 20 74 68 65 20 6f 72 69 67 69 ** the origi
11810 6e 61 6c 20 73 74 61 74 65 20 2a 2f 0a 20 20 20 nal state */.
11820 20 20 20 6c 72 63 20 3d 20 61 66 70 53 65 74 4c lrc = afpSetL
11830 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 ock(context->dbP
11840 61 74 68 2c 20 70 46 69 6c 65 2c 20 52 45 53 45 ath, pFile, RESE
11850 52 56 45 44 5f 42 59 54 45 2c 20 31 2c 20 30 29 RVED_BYTE, 1, 0)
11860 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 ;. } else {.
11870 20 20 20 20 20 2f 2a 20 69 66 20 77 65 20 66 61 /* if we fa
11880 69 6c 65 64 20 74 6f 20 67 65 74 20 74 68 65 20 iled to get the
11890 6c 6f 63 6b 20 74 68 65 6e 20 73 6f 6d 65 6f 6e lock then someon
118a0 65 20 65 6c 73 65 20 6d 75 73 74 20 68 61 76 65 e else must have
118b0 20 69 74 20 2a 2f 0a 20 20 20 20 20 20 72 65 73 it */. res
118c0 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d erved = 1;. }
118d0 0a 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b . if( IS_LOCK
118e0 5f 45 52 52 4f 52 28 6c 72 63 29 20 29 7b 0a 20 _ERROR(lrc) ){.
118f0 20 20 20 20 20 72 63 3d 6c 72 63 3b 0a 20 20 20 rc=lrc;.
11900 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 75 6e 69 78 }. }. . unix
11910 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 LeaveMutex();.
11920 4f 53 54 52 41 43 45 28 28 22 54 45 53 54 20 57 OSTRACE(("TEST W
11930 52 2d 4c 4f 43 4b 20 25 64 20 25 64 20 25 64 20 R-LOCK %d %d %d
11940 28 61 66 70 29 5c 6e 22 2c 20 70 46 69 6c 65 2d (afp)\n", pFile-
11950 3e 68 2c 20 72 63 2c 20 72 65 73 65 72 76 65 64 >h, rc, reserved
11960 29 29 3b 0a 20 20 0a 20 20 2a 70 52 65 73 4f 75 ));. . *pResOu
11970 74 20 3d 20 72 65 73 65 72 76 65 64 3b 0a 20 20 t = reserved;.
11980 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
11990 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 20 66 69 6c .** Lock the fil
119a0 65 20 77 69 74 68 20 74 68 65 20 6c 6f 63 6b 20 e with the lock
119b0 73 70 65 63 69 66 69 65 64 20 62 79 20 70 61 72 specified by par
119c0 61 6d 65 74 65 72 20 65 46 69 6c 65 4c 6f 63 6b ameter eFileLock
119d0 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 - one.** of the
119e0 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a following:.**.*
119f0 2a 20 20 20 20 20 28 31 29 20 53 48 41 52 45 44 * (1) SHARED
11a00 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 32 29 _LOCK.** (2)
11a10 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a RESERVED_LOCK.*
11a20 2a 20 20 20 20 20 28 33 29 20 50 45 4e 44 49 4e * (3) PENDIN
11a30 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 34 G_LOCK.** (4
11a40 29 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b ) EXCLUSIVE_LOCK
11a50 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 .**.** Sometimes
11a60 20 77 68 65 6e 20 72 65 71 75 65 73 74 69 6e 67 when requesting
11a70 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 74 65 2c one lock state,
11a80 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b additional lock
11a90 20 73 74 61 74 65 73 0a 2a 2a 20 61 72 65 20 69 states.** are i
11aa0 6e 73 65 72 74 65 64 20 69 6e 20 62 65 74 77 65 nserted in betwe
11ab0 65 6e 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 en. The locking
11ac0 20 6d 69 67 68 74 20 66 61 69 6c 20 6f 6e 20 6f might fail on o
11ad0 6e 65 20 6f 66 20 74 68 65 20 6c 61 74 65 72 0a ne of the later.
11ae0 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 6c ** transitions l
11af0 65 61 76 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20 eaving the lock
11b00 73 74 61 74 65 20 64 69 66 66 65 72 65 6e 74 20 state different
11b10 66 72 6f 6d 20 77 68 61 74 20 69 74 20 73 74 61 from what it sta
11b20 72 74 65 64 20 62 75 74 0a 2a 2a 20 73 74 69 6c rted but.** stil
11b30 6c 20 73 68 6f 72 74 20 6f 66 20 69 74 73 20 67 l short of its g
11b40 6f 61 6c 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 oal. The follow
11b50 69 6e 67 20 63 68 61 72 74 20 73 68 6f 77 73 20 ing chart shows
11b60 74 68 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 the allowed.** t
11b70 72 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 ransitions and t
11b80 68 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 65 he inserted inte
11b90 72 6d 65 64 69 61 74 65 20 73 74 61 74 65 73 3a rmediate states:
11ba0 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b .**.** UNLOCK
11bb0 45 44 20 2d 3e 20 53 48 41 52 45 44 0a 2a 2a 20 ED -> SHARED.**
11bc0 20 20 20 53 48 41 52 45 44 20 2d 3e 20 52 45 53 SHARED -> RES
11bd0 45 52 56 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 ERVED.** SHAR
11be0 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 ED -> (PENDING)
11bf0 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 -> EXCLUSIVE.**
11c00 20 20 20 52 45 53 45 52 56 45 44 20 2d 3e 20 28 RESERVED -> (
11c10 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c PENDING) -> EXCL
11c20 55 53 49 56 45 0a 2a 2a 20 20 20 20 50 45 4e 44 USIVE.** PEND
11c30 49 4e 47 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 ING -> EXCLUSIVE
11c40 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
11c50 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e ine will only in
11c60 63 72 65 61 73 65 20 61 20 6c 6f 63 6b 2e 20 20 crease a lock.
11c70 55 73 65 20 74 68 65 20 73 71 6c 69 74 65 33 4f Use the sqlite3O
11c80 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 sUnlock().** rou
11c90 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 20 61 20 tine to lower a
11ca0 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a locking level..*
11cb0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66 70 /.static int afp
11cc0 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c Lock(sqlite3_fil
11cd0 65 20 2a 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 e *id, int eFile
11ce0 4c 6f 63 6b 29 7b 0a 20 20 69 6e 74 20 72 63 20 Lock){. int rc
11cf0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 = SQLITE_OK;. u
11d00 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d nixFile *pFile =
11d10 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a (unixFile*)id;.
11d20 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 unixInodeInfo
11d30 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d *pInode = pFile-
11d40 3e 70 49 6e 6f 64 65 3b 0a 20 20 61 66 70 4c 6f >pInode;. afpLo
11d50 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 63 6f ckingContext *co
11d60 6e 74 65 78 74 20 3d 20 28 61 66 70 4c 6f 63 6b ntext = (afpLock
11d70 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 20 70 46 ingContext *) pF
11d80 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
11d90 65 78 74 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 ext;. . assert
11da0 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 4f 53 54 ( pFile );. OST
11db0 52 41 43 45 28 28 22 4c 4f 43 4b 20 20 20 20 25 RACE(("LOCK %
11dc0 64 20 25 73 20 77 61 73 20 25 73 28 25 73 2c 25 d %s was %s(%s,%
11dd0 64 29 20 70 69 64 3d 25 64 20 28 61 66 70 29 5c d) pid=%d (afp)\
11de0 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 n", pFile->h,.
11df0 20 20 20 20 20 20 20 20 20 61 7a 46 69 6c 65 4c azFileL
11e00 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 ock(eFileLock),
11e10 61 7a 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 azFileLock(pFile
11e20 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29 2c 0a 20 20 ->eFileLock),.
11e30 20 20 20 20 20 20 20 20 20 61 7a 46 69 6c 65 4c azFileL
11e40 6f 63 6b 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c ock(pInode->eFil
11e50 65 4c 6f 63 6b 29 2c 20 70 49 6e 6f 64 65 2d 3e eLock), pInode->
11e60 6e 53 68 61 72 65 64 20 2c 20 67 65 74 70 69 64 nShared , getpid
11e70 28 29 29 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 ()));.. /* If t
11e80 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 here is already
11e90 61 20 6c 6f 63 6b 20 6f 66 20 74 68 69 73 20 74 a lock of this t
11ea0 79 70 65 20 6f 72 20 6d 6f 72 65 20 72 65 73 74 ype or more rest
11eb0 72 69 63 74 69 76 65 20 6f 6e 20 74 68 65 0a 20 rictive on the.
11ec0 20 2a 2a 20 75 6e 69 78 46 69 6c 65 2c 20 64 6f ** unixFile, do
11ed0 20 6e 6f 74 68 69 6e 67 2e 20 44 6f 6e 27 74 20 nothing. Don't
11ee0 75 73 65 20 74 68 65 20 61 66 70 5f 65 6e 64 5f use the afp_end_
11ef0 6c 6f 63 6b 3a 20 65 78 69 74 20 70 61 74 68 2c lock: exit path,
11f00 20 61 73 0a 20 20 2a 2a 20 75 6e 69 78 45 6e 74 as. ** unixEnt
11f10 65 72 4d 75 74 65 78 28 29 20 68 61 73 6e 27 74 erMutex() hasn't
11f20 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 79 65 74 been called yet
11f30 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 .. */. if( pFi
11f40 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 65 le->eFileLock>=e
11f50 46 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 FileLock ){.
11f60 4f 53 54 52 41 43 45 28 28 22 4c 4f 43 4b 20 20 OSTRACE(("LOCK
11f70 20 20 25 64 20 25 73 20 6f 6b 20 28 61 6c 72 65 %d %s ok (alre
11f80 61 64 79 20 68 65 6c 64 29 20 28 61 66 70 29 5c ady held) (afp)\
11f90 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 n", pFile->h,.
11fa0 20 20 20 20 20 20 20 20 20 61 7a 46 69 6c 65 4c azFileL
11fb0 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b 29 29 29 ock(eFileLock)))
11fc0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
11fd0 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f ITE_OK;. }.. /
11fe0 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 * Make sure the
11ff0 6c 6f 63 6b 69 6e 67 20 73 65 71 75 65 6e 63 65 locking sequence
12000 20 69 73 20 63 6f 72 72 65 63 74 0a 20 20 2a 2a is correct. **
12010 20 20 28 31 29 20 57 65 20 6e 65 76 65 72 20 6d (1) We never m
12020 6f 76 65 20 66 72 6f 6d 20 75 6e 6c 6f 63 6b 65 ove from unlocke
12030 64 20 74 6f 20 61 6e 79 74 68 69 6e 67 20 68 69 d to anything hi
12040 67 68 65 72 20 74 68 61 6e 20 73 68 61 72 65 64 gher than shared
12050 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 20 28 32 29 lock.. ** (2)
12060 20 53 51 4c 69 74 65 20 6e 65 76 65 72 20 65 78 SQLite never ex
12070 70 6c 69 63 69 74 6c 79 20 72 65 71 75 65 73 74 plicitly request
12080 73 20 61 20 70 65 6e 64 69 67 20 6c 6f 63 6b 2e s a pendig lock.
12090 0a 20 20 2a 2a 20 20 28 33 29 20 41 20 73 68 61 . ** (3) A sha
120a0 72 65 64 20 6c 6f 63 6b 20 69 73 20 61 6c 77 61 red lock is alwa
120b0 79 73 20 68 65 6c 64 20 77 68 65 6e 20 61 20 72 ys held when a r
120c0 65 73 65 72 76 65 20 6c 6f 63 6b 20 69 73 20 72 eserve lock is r
120d0 65 71 75 65 73 74 65 64 2e 0a 20 20 2a 2f 0a 20 equested.. */.
120e0 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e assert( pFile->
120f0 65 46 69 6c 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f eFileLock!=NO_LO
12100 43 4b 20 7c 7c 20 65 46 69 6c 65 4c 6f 63 6b 3d CK || eFileLock=
12110 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a =SHARED_LOCK );.
12120 20 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c assert( eFileL
12130 6f 63 6b 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 ock!=PENDING_LOC
12140 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 K );. assert( e
12150 46 69 6c 65 4c 6f 63 6b 21 3d 52 45 53 45 52 56 FileLock!=RESERV
12160 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70 46 69 6c 65 ED_LOCK || pFile
12170 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 ->eFileLock==SHA
12180 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 0a 20 RED_LOCK );. .
12190 20 2f 2a 20 54 68 69 73 20 6d 75 74 65 78 20 69 /* This mutex i
121a0 73 20 6e 65 65 64 65 64 20 62 65 63 61 75 73 65 s needed because
121b0 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 20 69 pFile->pInode i
121c0 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 73 20 s shared across
121d0 74 68 72 65 61 64 73 0a 20 20 2a 2f 0a 20 20 75 threads. */. u
121e0 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 3b nixEnterMutex();
121f0 0a 20 20 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c . pInode = pFil
12200 65 2d 3e 70 49 6e 6f 64 65 3b 0a 0a 20 20 2f 2a e->pInode;.. /*
12210 20 49 66 20 73 6f 6d 65 20 74 68 72 65 61 64 20 If some thread
12220 75 73 69 6e 67 20 74 68 69 73 20 50 49 44 20 68 using this PID h
12230 61 73 20 61 20 6c 6f 63 6b 20 76 69 61 20 61 20 as a lock via a
12240 64 69 66 66 65 72 65 6e 74 20 75 6e 69 78 46 69 different unixFi
12250 6c 65 2a 0a 20 20 2a 2a 20 68 61 6e 64 6c 65 20 le*. ** handle
12260 74 68 61 74 20 70 72 65 63 6c 75 64 65 73 20 74 that precludes t
12270 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 he requested loc
12280 6b 2c 20 72 65 74 75 72 6e 20 42 55 53 59 2e 0a k, return BUSY..
12290 20 20 2a 2f 0a 20 20 69 66 28 20 28 70 46 69 6c */. if( (pFil
122a0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 21 3d 70 49 e->eFileLock!=pI
122b0 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 node->eFileLock
122c0 26 26 20 0a 20 20 20 20 20 20 20 28 70 49 6e 6f && . (pIno
122d0 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 50 de->eFileLock>=P
122e0 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 7c 7c 20 65 ENDING_LOCK || e
122f0 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f FileLock>SHARED_
12300 4c 4f 43 4b 29 29 0a 20 20 20 20 20 29 7b 0a 20 LOCK)). ){.
12310 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 rc = SQLITE_B
12320 55 53 59 3b 0a 20 20 20 20 67 6f 74 6f 20 61 66 USY;. goto af
12330 70 5f 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a p_end_lock;. }.
12340 20 20 0a 20 20 2f 2a 20 49 66 20 61 20 53 48 41 . /* If a SHA
12350 52 45 44 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 RED lock is requ
12360 65 73 74 65 64 2c 20 61 6e 64 20 73 6f 6d 65 20 ested, and some
12370 74 68 72 65 61 64 20 75 73 69 6e 67 20 74 68 69 thread using thi
12380 73 20 50 49 44 20 61 6c 72 65 61 64 79 0a 20 20 s PID already.
12390 2a 2a 20 68 61 73 20 61 20 53 48 41 52 45 44 20 ** has a SHARED
123a0 6f 72 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b or RESERVED lock
123b0 2c 20 74 68 65 6e 20 69 6e 63 72 65 6d 65 6e 74 , then increment
123c0 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 reference count
123d0 73 20 61 6e 64 0a 20 20 2a 2a 20 72 65 74 75 72 s and. ** retur
123e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 20 20 2a n SQLITE_OK.. *
123f0 2f 0a 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 /. if( eFileLoc
12400 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 26 k==SHARED_LOCK &
12410 26 20 0a 20 20 20 20 20 28 70 49 6e 6f 64 65 2d & . (pInode-
12420 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 >eFileLock==SHAR
12430 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70 49 6e 6f 64 ED_LOCK || pInod
12440 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 52 45 e->eFileLock==RE
12450 53 45 52 56 45 44 5f 4c 4f 43 4b 29 20 29 7b 0a SERVED_LOCK) ){.
12460 20 20 20 20 61 73 73 65 72 74 28 20 65 46 69 6c assert( eFil
12470 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
12480 43 4b 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 CK );. assert
12490 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f ( pFile->eFileLo
124a0 63 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 ck==0 );. ass
124b0 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 ert( pInode->nSh
124c0 61 72 65 64 3e 30 20 29 3b 0a 20 20 20 20 70 46 ared>0 );. pF
124d0 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d ile->eFileLock =
124e0 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 SHARED_LOCK;.
124f0 20 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 pInode->nShare
12500 64 2b 2b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d d++;. pInode-
12510 3e 6e 4c 6f 63 6b 2b 2b 3b 0a 20 20 20 20 67 6f >nLock++;. go
12520 74 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3b to afp_end_lock;
12530 0a 20 20 7d 0a 20 20 20 20 0a 20 20 2f 2a 20 41 . }. . /* A
12540 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69 73 PENDING lock is
12550 20 6e 65 65 64 65 64 20 62 65 66 6f 72 65 20 61 needed before a
12560 63 71 75 69 72 69 6e 67 20 61 20 53 48 41 52 45 cquiring a SHARE
12570 44 20 6c 6f 63 6b 20 61 6e 64 20 62 65 66 6f 72 D lock and befor
12580 65 0a 20 20 2a 2a 20 61 63 71 75 69 72 69 6e 67 e. ** acquiring
12590 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f an EXCLUSIVE lo
125a0 63 6b 2e 20 20 46 6f 72 20 74 68 65 20 53 48 41 ck. For the SHA
125b0 52 45 44 20 6c 6f 63 6b 2c 20 74 68 65 20 50 45 RED lock, the PE
125c0 4e 44 49 4e 47 20 77 69 6c 6c 0a 20 20 2a 2a 20 NDING will. **
125d0 62 65 20 72 65 6c 65 61 73 65 64 2e 0a 20 20 2a be released.. *
125e0 2f 0a 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 /. if( eFileLoc
125f0 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 0a k==SHARED_LOCK .
12600 20 20 20 20 20 20 7c 7c 20 28 65 46 69 6c 65 4c || (eFileL
12610 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock==EXCLUSIVE_L
12620 4f 43 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 46 OCK && pFile->eF
12630 69 6c 65 4c 6f 63 6b 3c 50 45 4e 44 49 4e 47 5f ileLock<PENDING_
12640 4c 4f 43 4b 29 0a 20 20 29 7b 0a 20 20 20 20 69 LOCK). ){. i
12650 6e 74 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 66 nt failed;. f
12660 61 69 6c 65 64 20 3d 20 61 66 70 53 65 74 4c 6f ailed = afpSetLo
12670 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 ck(context->dbPa
12680 74 68 2c 20 70 46 69 6c 65 2c 20 50 45 4e 44 49 th, pFile, PENDI
12690 4e 47 5f 42 59 54 45 2c 20 31 2c 20 31 29 3b 0a NG_BYTE, 1, 1);.
126a0 20 20 20 20 69 66 20 28 66 61 69 6c 65 64 29 20 if (failed)
126b0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 61 69 {. rc = fai
126c0 6c 65 64 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 led;. goto
126d0 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 afp_end_lock;.
126e0 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 }. }. . /*
126f0 49 66 20 63 6f 6e 74 72 6f 6c 20 67 65 74 73 20 If control gets
12700 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 to this point, t
12710 68 65 6e 20 61 63 74 75 61 6c 6c 79 20 67 6f 20 hen actually go
12720 61 68 65 61 64 20 61 6e 64 20 6d 61 6b 65 0a 20 ahead and make.
12730 20 2a 2a 20 6f 70 65 72 61 74 69 6e 67 20 73 79 ** operating sy
12740 73 74 65 6d 20 63 61 6c 6c 73 20 66 6f 72 20 74 stem calls for t
12750 68 65 20 73 70 65 63 69 66 69 65 64 20 6c 6f 63 he specified loc
12760 6b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 46 k.. */. if( eF
12770 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f ileLock==SHARED_
12780 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 69 6e 74 20 LOCK ){. int
12790 6c 72 63 31 2c 20 6c 72 63 32 2c 20 6c 72 63 31 lrc1, lrc2, lrc1
127a0 45 72 72 6e 6f 3b 0a 20 20 20 20 6c 6f 6e 67 20 Errno;. long
127b0 6c 6b 2c 20 6d 61 73 6b 3b 0a 20 20 20 20 0a 20 lk, mask;. .
127c0 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
127d0 65 2d 3e 6e 53 68 61 72 65 64 3d 3d 30 20 29 3b e->nShared==0 );
127e0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e . assert( pIn
127f0 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d ode->eFileLock==
12800 30 20 29 3b 0a 20 20 20 20 20 20 20 20 0a 20 20 0 );. .
12810 20 20 6d 61 73 6b 20 3d 20 28 73 69 7a 65 6f 66 mask = (sizeof
12820 28 6c 6f 6e 67 29 3d 3d 38 29 20 3f 20 4c 41 52 (long)==8) ? LAR
12830 47 45 53 54 5f 49 4e 54 36 34 20 3a 20 30 78 37 GEST_INT64 : 0x7
12840 66 66 66 66 66 66 66 3b 0a 20 20 20 20 2f 2a 20 fffffff;. /*
12850 4e 6f 77 20 67 65 74 20 74 68 65 20 72 65 61 64 Now get the read
12860 2d 6c 6f 63 6b 20 53 48 41 52 45 44 5f 4c 4f 43 -lock SHARED_LOC
12870 4b 20 2a 2f 0a 20 20 20 20 2f 2a 20 6e 6f 74 65 K */. /* note
12880 20 74 68 61 74 20 74 68 65 20 71 75 61 6c 69 74 that the qualit
12890 79 20 6f 66 20 74 68 65 20 72 61 6e 64 6f 6d 6e y of the randomn
128a0 65 73 73 20 64 6f 65 73 6e 27 74 20 6d 61 74 74 ess doesn't matt
128b0 65 72 20 74 68 61 74 20 6d 75 63 68 20 2a 2f 0a er that much */.
128c0 20 20 20 20 6c 6b 20 3d 20 72 61 6e 64 6f 6d 28 lk = random(
128d0 29 3b 20 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e ); . pInode->
128e0 73 68 61 72 65 64 42 79 74 65 20 3d 20 28 6c 6b sharedByte = (lk
128f0 20 26 20 6d 61 73 6b 29 25 28 53 48 41 52 45 44 & mask)%(SHARED
12900 5f 53 49 5a 45 20 2d 20 31 29 3b 0a 20 20 20 20 _SIZE - 1);.
12910 6c 72 63 31 20 3d 20 61 66 70 53 65 74 4c 6f 63 lrc1 = afpSetLoc
12920 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 k(context->dbPat
12930 68 2c 20 70 46 69 6c 65 2c 20 0a 20 20 20 20 20 h, pFile, .
12940 20 20 20 20 20 53 48 41 52 45 44 5f 46 49 52 53 SHARED_FIRS
12950 54 2b 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64 T+pInode->shared
12960 42 79 74 65 2c 20 31 2c 20 31 29 3b 0a 20 20 20 Byte, 1, 1);.
12970 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 if( IS_LOCK_ERR
12980 4f 52 28 6c 72 63 31 29 20 29 7b 0a 20 20 20 20 OR(lrc1) ){.
12990 20 20 6c 72 63 31 45 72 72 6e 6f 20 3d 20 70 46 lrc1Errno = pF
129a0 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 3b 0a ile->lastErrno;.
129b0 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 44 72 6f }. /* Dro
129c0 70 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 p the temporary
129d0 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 2a 2f 0a PENDING lock */.
129e0 20 20 20 20 6c 72 63 32 20 3d 20 61 66 70 53 65 lrc2 = afpSe
129f0 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 tLock(context->d
12a00 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20 50 45 bPath, pFile, PE
12a10 4e 44 49 4e 47 5f 42 59 54 45 2c 20 31 2c 20 30 NDING_BYTE, 1, 0
12a20 29 3b 0a 20 20 20 20 0a 20 20 20 20 69 66 28 20 );. . if(
12a30 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 6c 72 IS_LOCK_ERROR(lr
12a40 63 31 29 20 29 20 7b 0a 20 20 20 20 20 20 70 46 c1) ) {. pF
12a50 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d ile->lastErrno =
12a60 20 6c 72 63 31 45 72 72 6e 6f 3b 0a 20 20 20 20 lrc1Errno;.
12a70 20 20 72 63 20 3d 20 6c 72 63 31 3b 0a 20 20 20 rc = lrc1;.
12a80 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f goto afp_end_
12a90 6c 6f 63 6b 3b 0a 20 20 20 20 7d 20 65 6c 73 65 lock;. } else
12aa0 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 if( IS_LOCK_ERR
12ab0 4f 52 28 6c 72 63 32 29 20 29 7b 0a 20 20 20 20 OR(lrc2) ){.
12ac0 20 20 72 63 20 3d 20 6c 72 63 32 3b 0a 20 20 20 rc = lrc2;.
12ad0 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f goto afp_end_
12ae0 6c 6f 63 6b 3b 0a 20 20 20 20 7d 20 65 6c 73 65 lock;. } else
12af0 20 69 66 28 20 6c 72 63 31 20 21 3d 20 53 51 4c if( lrc1 != SQL
12b00 49 54 45 5f 4f 4b 20 29 20 7b 0a 20 20 20 20 20 ITE_OK ) {.
12b10 20 72 63 20 3d 20 6c 72 63 31 3b 0a 20 20 20 20 rc = lrc1;.
12b20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 70 } else {. p
12b30 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 File->eFileLock
12b40 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 = SHARED_LOCK;.
12b50 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f pInode->nLo
12b60 63 6b 2b 2b 3b 0a 20 20 20 20 20 20 70 49 6e 6f ck++;. pIno
12b70 64 65 2d 3e 6e 53 68 61 72 65 64 20 3d 20 31 3b de->nShared = 1;
12b80 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 . }. }else i
12b90 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 f( eFileLock==EX
12ba0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 CLUSIVE_LOCK &&
12bb0 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e pInode->nShared>
12bc0 31 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65 20 61 1 ){. /* We a
12bd0 72 65 20 74 72 79 69 6e 67 20 66 6f 72 20 61 6e re trying for an
12be0 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 exclusive lock
12bf0 62 75 74 20 61 6e 6f 74 68 65 72 20 74 68 72 65 but another thre
12c00 61 64 20 69 6e 20 74 68 69 73 0a 20 20 20 20 20 ad in this.
12c10 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65 73 73 20 ** same process
12c20 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 is still holding
12c30 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20 a shared lock.
12c40 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 */. rc = SQLI
12c50 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65 6c 73 65 TE_BUSY;. }else
12c60 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 {. /* The req
12c70 75 65 73 74 20 77 61 73 20 66 6f 72 20 61 20 52 uest was for a R
12c80 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55 ESERVED or EXCLU
12c90 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49 74 20 69 SIVE lock. It i
12ca0 73 0a 20 20 20 20 2a 2a 20 61 73 73 75 6d 65 64 s. ** assumed
12cb0 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 61 that there is a
12cc0 20 53 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 SHARED or great
12cd0 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 er lock on the f
12ce0 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c 72 65 61 ile. ** alrea
12cf0 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 dy.. */. i
12d00 6e 74 20 66 61 69 6c 65 64 20 3d 20 30 3b 0a 20 nt failed = 0;.
12d10 20 20 20 61 73 73 65 72 74 28 20 30 21 3d 70 46 assert( 0!=pF
12d20 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 29 ile->eFileLock )
12d30 3b 0a 20 20 20 20 69 66 20 28 65 46 69 6c 65 4c ;. if (eFileL
12d40 6f 63 6b 20 3e 3d 20 52 45 53 45 52 56 45 44 5f ock >= RESERVED_
12d50 4c 4f 43 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 LOCK && pFile->e
12d60 46 69 6c 65 4c 6f 63 6b 20 3c 20 52 45 53 45 52 FileLock < RESER
12d70 56 45 44 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 VED_LOCK) {.
12d80 20 20 20 20 2f 2a 20 41 63 71 75 69 72 65 20 61 /* Acquire a
12d90 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 2a RESERVED lock *
12da0 2f 0a 20 20 20 20 20 20 20 20 66 61 69 6c 65 64 /. failed
12db0 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f = afpSetLock(co
12dc0 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 ntext->dbPath, p
12dd0 46 69 6c 65 2c 20 52 45 53 45 52 56 45 44 5f 42 File, RESERVED_B
12de0 59 54 45 2c 20 31 2c 31 29 3b 0a 20 20 20 20 20 YTE, 1,1);.
12df0 20 69 66 28 20 21 66 61 69 6c 65 64 20 29 7b 0a if( !failed ){.
12e00 20 20 20 20 20 20 20 20 63 6f 6e 74 65 78 74 2d context-
12e10 3e 72 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 >reserved = 1;.
12e20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
12e30 20 69 66 20 28 21 66 61 69 6c 65 64 20 26 26 20 if (!failed &&
12e40 65 46 69 6c 65 4c 6f 63 6b 20 3d 3d 20 45 58 43 eFileLock == EXC
12e50 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 20 7b 0a 20 LUSIVE_LOCK) {.
12e60 20 20 20 20 20 2f 2a 20 41 63 71 75 69 72 65 20 /* Acquire
12e70 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 an EXCLUSIVE loc
12e80 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 0a 20 20 k */. .
12e90 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 /* Remove th
12ea0 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 62 65 e shared lock be
12eb0 66 6f 72 65 20 74 72 79 69 6e 67 20 74 68 65 20 fore trying the
12ec0 72 61 6e 67 65 2e 20 20 77 65 27 6c 6c 20 6e 65 range. we'll ne
12ed0 65 64 20 74 6f 20 0a 20 20 20 20 20 20 2a 2a 20 ed to . **
12ee0 72 65 65 73 74 61 62 6c 69 73 68 20 74 68 65 20 reestablish the
12ef0 73 68 61 72 65 64 20 6c 6f 63 6b 20 69 66 20 77 shared lock if w
12f00 65 20 63 61 6e 27 74 20 67 65 74 20 74 68 65 20 e can't get the
12f10 20 61 66 70 55 6e 6c 6f 63 6b 0a 20 20 20 20 20 afpUnlock.
12f20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 21 28 */. if( !(
12f30 66 61 69 6c 65 64 20 3d 20 61 66 70 53 65 74 4c failed = afpSetL
12f40 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 ock(context->dbP
12f50 61 74 68 2c 20 70 46 69 6c 65 2c 20 53 48 41 52 ath, pFile, SHAR
12f60 45 44 5f 46 49 52 53 54 20 2b 0a 20 20 20 20 20 ED_FIRST +.
12f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12f80 20 20 20 20 70 49 6e 6f 64 65 2d 3e 73 68 61 72 pInode->shar
12f90 65 64 42 79 74 65 2c 20 31 2c 20 30 29 29 20 29 edByte, 1, 0)) )
12fa0 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 66 61 {. int fa
12fb0 69 6c 65 64 32 20 3d 20 53 51 4c 49 54 45 5f 4f iled2 = SQLITE_O
12fc0 4b 3b 0a 20 20 20 20 20 20 20 20 2f 2a 20 6e 6f K;. /* no
12fd0 77 20 61 74 74 65 6d 6d 70 74 20 74 6f 20 67 65 w attemmpt to ge
12fe0 74 20 74 68 65 20 65 78 63 6c 75 73 69 76 65 20 t the exclusive
12ff0 6c 6f 63 6b 20 72 61 6e 67 65 20 2a 2f 0a 20 20 lock range */.
13000 20 20 20 20 20 20 66 61 69 6c 65 64 20 3d 20 61 failed = a
13010 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 fpSetLock(contex
13020 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 t->dbPath, pFile
13030 2c 20 53 48 41 52 45 44 5f 46 49 52 53 54 2c 20 , SHARED_FIRST,
13040 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
13050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13060 53 48 41 52 45 44 5f 53 49 5a 45 2c 20 31 29 3b SHARED_SIZE, 1);
13070 0a 20 20 20 20 20 20 20 20 69 66 28 20 66 61 69 . if( fai
13080 6c 65 64 20 26 26 20 28 66 61 69 6c 65 64 32 20 led && (failed2
13090 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e = afpSetLock(con
130a0 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 text->dbPath, pF
130b0 69 6c 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 ile, .
130c0 20 20 20 20 20 20 20 20 20 20 20 20 20 53 48 41 SHA
130d0 52 45 44 5f 46 49 52 53 54 20 2b 20 70 49 6e 6f RED_FIRST + pIno
130e0 64 65 2d 3e 73 68 61 72 65 64 42 79 74 65 2c 20 de->sharedByte,
130f0 31 2c 20 31 29 29 20 29 7b 0a 20 20 20 20 20 20 1, 1)) ){.
13100 20 20 20 20 2f 2a 20 43 61 6e 27 74 20 72 65 65 /* Can't ree
13110 73 74 61 62 6c 69 73 68 20 74 68 65 20 73 68 61 stablish the sha
13120 72 65 64 20 6c 6f 63 6b 2e 20 20 53 71 6c 69 74 red lock. Sqlit
13130 65 20 63 61 6e 27 74 20 64 65 61 6c 2c 20 74 68 e can't deal, th
13140 69 73 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 is is.
13150 2a 2a 20 61 20 63 72 69 74 69 63 61 6c 20 49 2f ** a critical I/
13160 4f 20 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 O error.
13170 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 72 */. r
13180 63 20 3d 20 28 28 66 61 69 6c 65 64 20 26 20 53 c = ((failed & S
13190 51 4c 49 54 45 5f 49 4f 45 52 52 29 20 3d 3d 20 QLITE_IOERR) ==
131a0 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 20 3f 20 SQLITE_IOERR) ?
131b0 66 61 69 6c 65 64 32 20 3a 20 0a 20 20 20 20 20 failed2 : .
131c0 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 SQLITE
131d0 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3b 0a 20 20 20 _IOERR_LOCK;.
131e0 20 20 20 20 20 20 20 67 6f 74 6f 20 61 66 70 5f goto afp_
131f0 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 end_lock;.
13200 20 20 7d 20 0a 20 20 20 20 20 20 7d 65 6c 73 65 } . }else
13210 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 66 {. rc = f
13220 61 69 6c 65 64 3b 20 0a 20 20 20 20 20 20 7d 0a ailed; . }.
13230 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 66 61 }. if( fa
13240 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 72 63 iled ){. rc
13250 20 3d 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d = failed;. }
13260 0a 20 20 7d 0a 20 20 0a 20 20 69 66 28 20 72 63 . }. . if( rc
13270 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
13280 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c pFile->eFileL
13290 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b ock = eFileLock;
132a0 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 69 . pInode->eFi
132b0 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f leLock = eFileLo
132c0 63 6b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 ck;. }else if(
132d0 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 eFileLock==EXCLU
132e0 53 49 56 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 SIVE_LOCK ){.
132f0 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
13300 6b 20 3d 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b k = PENDING_LOCK
13310 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 ;. pInode->eF
13320 69 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44 49 4e ileLock = PENDIN
13330 47 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 20 0a 61 G_LOCK;. }. .a
13340 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3a 0a 20 20 75 fp_end_lock:. u
13350 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b nixLeaveMutex();
13360 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c 4f 43 . OSTRACE(("LOC
13370 4b 20 20 20 20 25 64 20 25 73 20 25 73 20 28 61 K %d %s %s (a
13380 66 70 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 fp)\n", pFile->h
13390 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 69 , azFileLock(eFi
133a0 6c 65 4c 6f 63 6b 29 2c 20 0a 20 20 20 20 20 20 leLock), .
133b0 20 20 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b rc==SQLITE_OK
133c0 20 3f 20 22 6f 6b 22 20 3a 20 22 66 61 69 6c 65 ? "ok" : "faile
133d0 64 22 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 d"));. return r
133e0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 c;.}../*.** Lowe
133f0 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 r the locking le
13400 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 vel on file desc
13410 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 riptor pFile to
13420 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c eFileLock. eFil
13430 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 eLock.** must be
13440 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 either NO_LOCK
13450 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a or SHARED_LOCK..
13460 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 **.** If the loc
13470 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 king level of th
13480 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f e file descripto
13490 72 20 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 r is already at
134a0 6f 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 or below.** the
134b0 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e requested lockin
134c0 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f g level, this ro
134d0 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
134e0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
134f0 61 66 70 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 afpUnlock(sqlite
13500 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 3_file *id, int
13510 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 69 eFileLock) {. i
13520 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
13530 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 K;. unixFile *p
13540 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 File = (unixFile
13550 2a 29 69 64 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 *)id;. unixInod
13560 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 20 eInfo *pInode;.
13570 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 afpLockingConte
13580 78 74 20 2a 63 6f 6e 74 65 78 74 20 3d 20 28 61 xt *context = (a
13590 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 fpLockingContext
135a0 20 2a 29 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 *) pFile->locki
135b0 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 69 6e 74 ngContext;. int
135c0 20 73 6b 69 70 53 68 61 72 65 64 20 3d 20 30 3b skipShared = 0;
135d0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 .#ifdef SQLITE_T
135e0 45 53 54 0a 20 20 69 6e 74 20 68 20 3d 20 70 46 EST. int h = pF
135f0 69 6c 65 2d 3e 68 3b 0a 23 65 6e 64 69 66 0a 0a ile->h;.#endif..
13600 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 assert( pFile
13610 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 55 );. OSTRACE(("U
13620 4e 4c 4f 43 4b 20 20 25 64 20 25 64 20 77 61 73 NLOCK %d %d was
13630 20 25 64 28 25 64 2c 25 64 29 20 70 69 64 3d 25 %d(%d,%d) pid=%
13640 64 20 28 61 66 70 29 5c 6e 22 2c 20 70 46 69 6c d (afp)\n", pFil
13650 65 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c e->h, eFileLock,
13660 0a 20 20 20 20 20 20 20 20 20 20 20 70 46 69 6c . pFil
13670 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 e->eFileLock, pF
13680 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 65 46 69 ile->pInode->eFi
13690 6c 65 4c 6f 63 6b 2c 20 70 46 69 6c 65 2d 3e 70 leLock, pFile->p
136a0 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 2c 0a Inode->nShared,.
136b0 20 20 20 20 20 20 20 20 20 20 20 67 65 74 70 69 getpi
136c0 64 28 29 29 29 3b 0a 0a 20 20 61 73 73 65 72 74 d()));.. assert
136d0 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 41 ( eFileLock<=SHA
136e0 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 RED_LOCK );. if
136f0 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f ( pFile->eFileLo
13700 63 6b 3c 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b ck<=eFileLock ){
13710 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
13720 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 75 6e 69 TE_OK;. }. uni
13730 78 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 xEnterMutex();.
13740 20 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d pInode = pFile-
13750 3e 70 49 6e 6f 64 65 3b 0a 20 20 61 73 73 65 72 >pInode;. asser
13760 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 t( pInode->nShar
13770 65 64 21 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 ed!=0 );. if( p
13780 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e File->eFileLock>
13790 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 SHARED_LOCK ){.
137a0 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
137b0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 70 46 e->eFileLock==pF
137c0 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 29 ile->eFileLock )
137d0 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49 4f ;. SimulateIO
137e0 45 72 72 6f 72 42 65 6e 69 67 6e 28 31 29 3b 0a ErrorBenign(1);.
137f0 20 20 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 SimulateIOEr
13800 72 6f 72 28 20 68 3d 28 2d 31 29 20 29 0a 20 20 ror( h=(-1) ).
13810 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f SimulateIOErro
13820 72 42 65 6e 69 67 6e 28 30 29 3b 0a 20 20 20 20 rBenign(0);.
13830 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a .#ifndef NDEBUG.
13840 20 20 20 20 2f 2a 20 57 68 65 6e 20 72 65 64 75 /* When redu
13850 63 69 6e 67 20 61 20 6c 6f 63 6b 20 73 75 63 68 cing a lock such
13860 20 74 68 61 74 20 6f 74 68 65 72 20 70 72 6f 63 that other proc
13870 65 73 73 65 73 20 63 61 6e 20 73 74 61 72 74 0a esses can start.
13880 20 20 20 20 2a 2a 20 72 65 61 64 69 6e 67 20 74 ** reading t
13890 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
138a0 20 61 67 61 69 6e 2c 20 6d 61 6b 65 20 73 75 72 again, make sur
138b0 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 2a e that the. *
138c0 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f * transaction co
138d0 75 6e 74 65 72 20 77 61 73 20 75 70 64 61 74 65 unter was update
138e0 64 20 69 66 20 61 6e 79 20 70 61 72 74 20 6f 66 d if any part of
138f0 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
13900 20 20 2a 2a 20 66 69 6c 65 20 63 68 61 6e 67 65 ** file change
13910 64 2e 20 20 49 66 20 74 68 65 20 74 72 61 6e 73 d. If the trans
13920 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 69 action counter i
13930 73 20 6e 6f 74 20 75 70 64 61 74 65 64 2c 0a 20 s not updated,.
13940 20 20 20 2a 2a 20 6f 74 68 65 72 20 63 6f 6e 6e ** other conn
13950 65 63 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 73 ections to the s
13960 61 6d 65 20 66 69 6c 65 20 6d 69 67 68 74 20 6e ame file might n
13970 6f 74 20 72 65 61 6c 69 7a 65 20 74 68 61 74 0a ot realize that.
13980 20 20 20 20 2a 2a 20 74 68 65 20 66 69 6c 65 20 ** the file
13990 68 61 73 20 63 68 61 6e 67 65 64 20 61 6e 64 20 has changed and
139a0 68 65 6e 63 65 20 6d 69 67 68 74 20 6e 6f 74 20 hence might not
139b0 6b 6e 6f 77 20 74 6f 20 66 6c 75 73 68 20 74 68 know to flush th
139c0 65 69 72 0a 20 20 20 20 2a 2a 20 63 61 63 68 65 eir. ** cache
139d0 2e 20 20 54 68 65 20 75 73 65 20 6f 66 20 61 20 . The use of a
139e0 73 74 61 6c 65 20 63 61 63 68 65 20 63 61 6e 20 stale cache can
139f0 6c 65 61 64 20 74 6f 20 64 61 74 61 62 61 73 65 lead to database
13a00 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 20 20 20 corruption..
13a10 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
13a20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 pFile->inNormalW
13a30 72 69 74 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 rite==0.
13a40 20 20 20 7c 7c 20 70 46 69 6c 65 2d 3e 64 62 55 || pFile->dbU
13a50 70 64 61 74 65 3d 3d 30 0a 20 20 20 20 20 20 20 pdate==0.
13a60 20 20 20 20 7c 7c 20 70 46 69 6c 65 2d 3e 74 72 || pFile->tr
13a70 61 6e 73 43 6e 74 72 43 68 6e 67 3d 3d 31 20 29 ansCntrChng==1 )
13a80 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 69 6e 4e ;. pFile->inN
13a90 6f 72 6d 61 6c 57 72 69 74 65 20 3d 20 30 3b 0a ormalWrite = 0;.
13aa0 23 65 6e 64 69 66 0a 20 20 20 20 0a 20 20 20 20 #endif. .
13ab0 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 if( pFile->eFile
13ac0 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f Lock==EXCLUSIVE_
13ad0 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 LOCK ){. rc
13ae0 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f = afpSetLock(co
13af0 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 ntext->dbPath, p
13b00 46 69 6c 65 2c 20 53 48 41 52 45 44 5f 46 49 52 File, SHARED_FIR
13b10 53 54 2c 20 53 48 41 52 45 44 5f 53 49 5a 45 2c ST, SHARED_SIZE,
13b20 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 0);. if( r
13b30 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
13b40 28 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 (eFileLock==SHAR
13b50 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70 49 6e 6f 64 ED_LOCK || pInod
13b60 65 2d 3e 6e 53 68 61 72 65 64 3e 31 29 20 29 7b e->nShared>1) ){
13b70 0a 20 20 20 20 20 20 20 20 2f 2a 20 6f 6e 6c 79 . /* only
13b80 20 72 65 2d 65 73 74 61 62 6c 69 73 68 20 74 68 re-establish th
13b90 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 69 66 e shared lock if
13ba0 20 6e 65 63 65 73 73 61 72 79 20 2a 2f 0a 20 20 necessary */.
13bb0 20 20 20 20 20 20 69 6e 74 20 73 68 61 72 65 64 int shared
13bc0 4c 6f 63 6b 42 79 74 65 20 3d 20 53 48 41 52 45 LockByte = SHARE
13bd0 44 5f 46 49 52 53 54 2b 70 49 6e 6f 64 65 2d 3e D_FIRST+pInode->
13be0 73 68 61 72 65 64 42 79 74 65 3b 0a 20 20 20 20 sharedByte;.
13bf0 20 20 20 20 72 63 20 3d 20 61 66 70 53 65 74 4c rc = afpSetL
13c00 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 ock(context->dbP
13c10 61 74 68 2c 20 70 46 69 6c 65 2c 20 73 68 61 72 ath, pFile, shar
13c20 65 64 4c 6f 63 6b 42 79 74 65 2c 20 31 2c 20 31 edLockByte, 1, 1
13c30 29 3b 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 20 );. } else
13c40 7b 0a 20 20 20 20 20 20 20 20 73 6b 69 70 53 68 {. skipSh
13c50 61 72 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20 ared = 1;.
13c60 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
13c70 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
13c80 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
13c90 6b 3e 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 k>=PENDING_LOCK
13ca0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 66 ){. rc = af
13cb0 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 pSetLock(context
13cc0 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c ->dbPath, pFile,
13cd0 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 31 PENDING_BYTE, 1
13ce0 2c 20 30 29 3b 0a 20 20 20 20 7d 20 0a 20 20 20 , 0);. } .
13cf0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
13d00 4f 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 46 69 OK && pFile->eFi
13d10 6c 65 4c 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 leLock>=RESERVED
13d20 5f 4c 4f 43 4b 20 26 26 20 63 6f 6e 74 65 78 74 _LOCK && context
13d30 2d 3e 72 65 73 65 72 76 65 64 20 29 7b 0a 20 20 ->reserved ){.
13d40 20 20 20 20 72 63 20 3d 20 61 66 70 53 65 74 4c rc = afpSetL
13d50 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 ock(context->dbP
13d60 61 74 68 2c 20 70 46 69 6c 65 2c 20 52 45 53 45 ath, pFile, RESE
13d70 52 56 45 44 5f 42 59 54 45 2c 20 31 2c 20 30 29 RVED_BYTE, 1, 0)
13d80 3b 0a 20 20 20 20 20 20 69 66 28 20 21 72 63 20 ;. if( !rc
13d90 29 7b 20 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 ){ . cont
13da0 65 78 74 2d 3e 72 65 73 65 72 76 65 64 20 3d 20 ext->reserved =
13db0 30 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 0; . }.
13dc0 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
13dd0 4c 49 54 45 5f 4f 4b 20 26 26 20 28 65 46 69 6c LITE_OK && (eFil
13de0 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
13df0 43 4b 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e 6e 53 CK || pInode->nS
13e00 68 61 72 65 64 3e 31 29 29 7b 0a 20 20 20 20 20 hared>1)){.
13e10 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f pInode->eFileLo
13e20 63 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b ck = SHARED_LOCK
13e30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 ;. }. }. if
13e40 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
13e50 26 26 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 4e 4f && eFileLock==NO
13e60 5f 4c 4f 43 4b 20 29 7b 0a 0a 20 20 20 20 2f 2a _LOCK ){.. /*
13e70 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 73 Decrement the s
13e80 68 61 72 65 64 20 6c 6f 63 6b 20 63 6f 75 6e 74 hared lock count
13e90 65 72 2e 20 20 52 65 6c 65 61 73 65 20 74 68 65 er. Release the
13ea0 20 6c 6f 63 6b 20 75 73 69 6e 67 20 61 6e 0a 20 lock using an.
13eb0 20 20 20 2a 2a 20 4f 53 20 63 61 6c 6c 20 6f 6e ** OS call on
13ec0 6c 79 20 77 68 65 6e 20 61 6c 6c 20 74 68 72 65 ly when all thre
13ed0 61 64 73 20 69 6e 20 74 68 69 73 20 73 61 6d 65 ads in this same
13ee0 20 70 72 6f 63 65 73 73 20 68 61 76 65 20 72 65 process have re
13ef0 6c 65 61 73 65 64 0a 20 20 20 20 2a 2a 20 74 68 leased. ** th
13f00 65 20 6c 6f 63 6b 2e 0a 20 20 20 20 2a 2f 0a 20 e lock.. */.
13f10 20 20 20 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 unsigned long
13f20 20 6c 6f 6e 67 20 73 68 61 72 65 64 4c 6f 63 6b long sharedLock
13f30 42 79 74 65 20 3d 20 53 48 41 52 45 44 5f 46 49 Byte = SHARED_FI
13f40 52 53 54 2b 70 49 6e 6f 64 65 2d 3e 73 68 61 72 RST+pInode->shar
13f50 65 64 42 79 74 65 3b 0a 20 20 20 20 70 49 6e 6f edByte;. pIno
13f60 64 65 2d 3e 6e 53 68 61 72 65 64 2d 2d 3b 0a 20 de->nShared--;.
13f70 20 20 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 6e if( pInode->n
13f80 53 68 61 72 65 64 3d 3d 30 20 29 7b 0a 20 20 20 Shared==0 ){.
13f90 20 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 SimulateIOErr
13fa0 6f 72 42 65 6e 69 67 6e 28 31 29 3b 0a 20 20 20 orBenign(1);.
13fb0 20 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 SimulateIOErr
13fc0 6f 72 28 20 68 3d 28 2d 31 29 20 29 0a 20 20 20 or( h=(-1) ).
13fd0 20 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 SimulateIOErr
13fe0 6f 72 42 65 6e 69 67 6e 28 30 29 3b 0a 20 20 20 orBenign(0);.
13ff0 20 20 20 69 66 28 20 21 73 6b 69 70 53 68 61 72 if( !skipShar
14000 65 64 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 ed ){. rc
14010 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f = afpSetLock(co
14020 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 ntext->dbPath, p
14030 46 69 6c 65 2c 20 73 68 61 72 65 64 4c 6f 63 6b File, sharedLock
14040 42 79 74 65 2c 20 31 2c 20 30 29 3b 0a 20 20 20 Byte, 1, 0);.
14050 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 }. if( !
14060 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 70 49 rc ){. pI
14070 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 node->eFileLock
14080 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 = NO_LOCK;.
14090 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c pFile->eFileL
140a0 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 ock = NO_LOCK;.
140b0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
140c0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
140d0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 49 6e 6f OK ){. pIno
140e0 64 65 2d 3e 6e 4c 6f 63 6b 2d 2d 3b 0a 20 20 20 de->nLock--;.
140f0 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
14100 65 2d 3e 6e 4c 6f 63 6b 3e 3d 30 20 29 3b 0a 20 e->nLock>=0 );.
14110 20 20 20 20 20 69 66 28 20 70 49 6e 6f 64 65 2d if( pInode-
14120 3e 6e 4c 6f 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 >nLock==0 ){.
14130 20 20 20 20 20 72 63 20 3d 20 63 6c 6f 73 65 50 rc = closeP
14140 65 6e 64 69 6e 67 46 64 73 28 70 46 69 6c 65 29 endingFds(pFile)
14150 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
14160 20 20 7d 0a 20 20 0a 20 20 75 6e 69 78 4c 65 61 }. . unixLea
14170 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 veMutex();. if(
14180 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
14190 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
141a0 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 k = eFileLock;.
141b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
141c0 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c *.** Close a fil
141d0 65 20 26 20 63 6c 65 61 6e 75 70 20 41 46 50 20 e & cleanup AFP
141e0 73 70 65 63 69 66 69 63 20 6c 6f 63 6b 69 6e 67 specific locking
141f0 20 63 6f 6e 74 65 78 74 20 0a 2a 2f 0a 73 74 61 context .*/.sta
14200 74 69 63 20 69 6e 74 20 61 66 70 43 6c 6f 73 65 tic int afpClose
14210 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 (sqlite3_file *i
14220 64 29 20 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 d) {. int rc =
14230 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 SQLITE_OK;. if(
14240 20 69 64 20 29 7b 0a 20 20 20 20 75 6e 69 78 46 id ){. unixF
14250 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e ile *pFile = (un
14260 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 20 20 ixFile*)id;.
14270 61 66 70 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f afpUnlock(id, NO
14280 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 75 6e 69 78 _LOCK);. unix
14290 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 EnterMutex();.
142a0 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 70 49 6e if( pFile->pIn
142b0 6f 64 65 20 26 26 20 70 46 69 6c 65 2d 3e 70 49 ode && pFile->pI
142c0 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 20 29 7b 0a 20 node->nLock ){.
142d0 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 /* If there
142e0 20 61 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 are outstanding
142f0 20 6c 6f 63 6b 73 2c 20 64 6f 20 6e 6f 74 20 61 locks, do not a
14300 63 74 75 61 6c 6c 79 20 63 6c 6f 73 65 20 74 68 ctually close th
14310 65 20 66 69 6c 65 20 6a 75 73 74 0a 20 20 20 20 e file just.
14320 20 20 2a 2a 20 79 65 74 20 62 65 63 61 75 73 65 ** yet because
14330 20 74 68 61 74 20 77 6f 75 6c 64 20 63 6c 65 61 that would clea
14340 72 20 74 68 6f 73 65 20 6c 6f 63 6b 73 2e 20 20 r those locks.
14350 49 6e 73 74 65 61 64 2c 20 61 64 64 20 74 68 65 Instead, add the
14360 20 66 69 6c 65 0a 20 20 20 20 20 20 2a 2a 20 64 file. ** d
14370 65 73 63 72 69 70 74 6f 72 20 74 6f 20 70 49 6e escriptor to pIn
14380 6f 64 65 2d 3e 61 50 65 6e 64 69 6e 67 2e 20 20 ode->aPending.
14390 49 74 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d It will be autom
143a0 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64 20 atically closed
143b0 77 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 74 68 when. ** th
143c0 65 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73 20 63 e last lock is c
143d0 6c 65 61 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f leared.. */
143e0 0a 20 20 20 20 20 20 73 65 74 50 65 6e 64 69 6e . setPendin
143f0 67 46 64 28 70 46 69 6c 65 29 3b 0a 20 20 20 20 gFd(pFile);.
14400 7d 0a 20 20 20 20 72 65 6c 65 61 73 65 4c 6f 63 }. releaseLoc
14410 6b 49 6e 66 6f 28 70 46 69 6c 65 2d 3e 70 49 6e kInfo(pFile->pIn
14420 6f 64 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 ode);. sqlite
14430 33 5f 66 72 65 65 28 70 46 69 6c 65 2d 3e 6c 6f 3_free(pFile->lo
14440 63 6b 69 6e 67 43 6f 6e 74 65 78 74 29 3b 0a 20 ckingContext);.
14450 20 20 20 72 63 20 3d 20 63 6c 6f 73 65 55 6e 69 rc = closeUni
14460 78 46 69 6c 65 28 69 64 29 3b 0a 20 20 20 20 75 xFile(id);. u
14470 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b nixLeaveMutex();
14480 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
14490 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 64 ;.}..#endif /* d
144a0 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
144b0 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 ) && SQLITE_ENAB
144c0 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
144d0 20 2a 2f 0a 2f 2a 0a 2a 2a 20 54 68 65 20 63 6f */./*.** The co
144e0 64 65 20 61 62 6f 76 65 20 69 73 20 74 68 65 20 de above is the
144f0 41 46 50 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 AFP lock impleme
14500 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 20 63 6f ntation. The co
14510 64 65 20 69 73 20 73 70 65 63 69 66 69 63 0a 2a de is specific.*
14520 2a 20 74 6f 20 4d 61 63 4f 53 58 20 61 6e 64 20 * to MacOSX and
14530 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e does not work on
14540 20 6f 74 68 65 72 20 75 6e 69 78 20 70 6c 61 74 other unix plat
14550 66 6f 72 6d 73 2e 20 20 4e 6f 20 61 6c 74 65 72 forms. No alter
14560 6e 61 74 69 76 65 0a 2a 2a 20 69 73 20 61 76 61 native.** is ava
14570 69 6c 61 62 6c 65 2e 20 20 49 66 20 79 6f 75 20 ilable. If you
14580 64 6f 6e 27 74 20 63 6f 6d 70 69 6c 65 20 66 6f don't compile fo
14590 72 20 61 20 6d 61 63 2c 20 74 68 65 6e 20 74 68 r a mac, then th
145a0 65 20 22 75 6e 69 78 2d 61 66 70 22 0a 2a 2a 20 e "unix-afp".**
145b0 56 46 53 20 69 73 20 6e 6f 74 20 61 76 61 69 6c VFS is not avail
145c0 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a able..**.*******
145d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 ************** E
145e0 6e 64 20 6f 66 20 74 68 65 20 41 46 50 20 6c 6f nd of the AFP lo
145f0 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ck implementatio
14600 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a n **************
14610 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a ********.*******
14620 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14630 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14640 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14650 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14660 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a *******/../*****
14670 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14680 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14690 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
146a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
146b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a *********.******
146c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
146d0 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 4e 46 53 20 ***** Begin NFS
146e0 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a Locking ********
146f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14700 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 23 69 66 20 64 ********/..#if d
14710 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
14720 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 ) && SQLITE_ENAB
14730 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
14740 0a 2f 2a 0a 20 2a 2a 20 4c 6f 77 65 72 20 74 68 ./*. ** Lower th
14750 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 e locking level
14760 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 on file descript
14770 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46 69 6c or pFile to eFil
14780 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 eLock. eFileLoc
14790 6b 0a 20 2a 2a 20 6d 75 73 74 20 62 65 20 65 69 k. ** must be ei
147a0 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 ther NO_LOCK or
147b0 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 20 2a 2a SHARED_LOCK.. **
147c0 0a 20 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b . ** If the lock
147d0 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 ing level of the
147e0 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
147f0 20 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f is already at o
14800 72 20 62 65 6c 6f 77 0a 20 2a 2a 20 74 68 65 20 r below. ** the
14810 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e requested lockin
14820 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f g level, this ro
14830 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
14840 2e 0a 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 .. */.static int
14850 20 6e 66 73 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 nfsUnlock(sqlit
14860 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 e3_file *id, int
14870 20 65 46 69 6c 65 4c 6f 63 6b 29 7b 0a 20 20 72 eFileLock){. r
14880 65 74 75 72 6e 20 5f 70 6f 73 69 78 55 6e 6c 6f eturn _posixUnlo
14890 63 6b 28 69 64 2c 20 65 46 69 6c 65 4c 6f 63 6b ck(id, eFileLock
148a0 2c 20 31 29 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 , 1);.}..#endif
148b0 2f 2a 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 /* defined(__APP
148c0 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f LE__) && SQLITE_
148d0 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
148e0 54 59 4c 45 20 2a 2f 0a 2f 2a 0a 2a 2a 20 54 68 TYLE */./*.** Th
148f0 65 20 63 6f 64 65 20 61 62 6f 76 65 20 69 73 20 e code above is
14900 74 68 65 20 4e 46 53 20 6c 6f 63 6b 20 69 6d 70 the NFS lock imp
14910 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 lementation. Th
14920 65 20 63 6f 64 65 20 69 73 20 73 70 65 63 69 66 e code is specif
14930 69 63 0a 2a 2a 20 74 6f 20 4d 61 63 4f 53 58 20 ic.** to MacOSX
14940 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 and does not wor
14950 6b 20 6f 6e 20 6f 74 68 65 72 20 75 6e 69 78 20 k on other unix
14960 70 6c 61 74 66 6f 72 6d 73 2e 20 20 4e 6f 20 61 platforms. No a
14970 6c 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 69 73 lternative.** is
14980 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 0a 2a 2a available. .**
14990 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .***************
149a0 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 74 68 ****** End of th
149b0 65 20 4e 46 53 20 6c 6f 63 6b 20 69 6d 70 6c 65 e NFS lock imple
149c0 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a mentation ******
149d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
149e0 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .***************
149f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
14a30 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ../*************
14a40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a70 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14a80 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a *.**************
14a90 2a 2a 20 4e 6f 6e 2d 6c 6f 63 6b 69 6e 67 20 73 ** Non-locking s
14aa0 71 6c 69 74 65 33 5f 66 69 6c 65 20 6d 65 74 68 qlite3_file meth
14ab0 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ods ************
14ac0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
14ad0 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 65 78 74 *.**.** The next
14ae0 20 64 69 76 69 73 69 6f 6e 20 63 6f 6e 74 61 69 division contai
14af0 6e 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ns implementatio
14b00 6e 73 20 66 6f 72 20 61 6c 6c 20 6d 65 74 68 6f ns for all metho
14b10 64 73 20 6f 66 20 74 68 65 20 0a 2a 2a 20 73 71 ds of the .** sq
14b20 6c 69 74 65 33 5f 66 69 6c 65 20 6f 62 6a 65 63 lite3_file objec
14b30 74 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 65 t other than the
14b40 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 73 locking methods
14b50 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 0a 2a . The locking.*
14b60 2a 20 6d 65 74 68 6f 64 73 20 77 65 72 65 20 64 * methods were d
14b70 65 66 69 6e 65 64 20 69 6e 20 64 69 76 69 73 69 efined in divisi
14b80 6f 6e 73 20 61 62 6f 76 65 20 28 6f 6e 65 20 6c ons above (one l
14b90 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 20 70 65 ocking method pe
14ba0 72 0a 2a 2a 20 64 69 76 69 73 69 6f 6e 29 2e 20 r.** division).
14bb0 20 54 68 6f 73 65 20 6d 65 74 68 6f 64 73 20 74 Those methods t
14bc0 68 61 74 20 61 72 65 20 63 6f 6d 6d 6f 6e 20 74 hat are common t
14bd0 6f 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 6d 6f o all locking mo
14be0 64 65 73 0a 2a 2a 20 61 72 65 20 67 61 74 68 65 des.** are gathe
14bf0 72 20 74 6f 67 65 74 68 65 72 20 69 6e 74 6f 20 r together into
14c00 74 68 69 73 20 64 69 76 69 73 69 6f 6e 2e 0a 2a this division..*
14c10 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 6f /../*.** Seek to
14c20 20 74 68 65 20 6f 66 66 73 65 74 20 70 61 73 73 the offset pass
14c30 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
14c40 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 6e 20 argument, then
14c50 72 65 61 64 20 63 6e 74 20 0a 2a 2a 20 62 79 74 read cnt .** byt
14c60 65 73 20 69 6e 74 6f 20 70 42 75 66 2e 20 52 65 es into pBuf. Re
14c70 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 turn the number
14c80 6f 66 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c of bytes actuall
14c90 79 20 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 4e 42 y read..**.** NB
14ca0 3a 20 20 49 66 20 79 6f 75 20 64 65 66 69 6e 65 : If you define
14cb0 20 55 53 45 5f 50 52 45 41 44 20 6f 72 20 55 53 USE_PREAD or US
14cc0 45 5f 50 52 45 41 44 36 34 2c 20 74 68 65 6e 20 E_PREAD64, then
14cd0 69 74 20 6d 69 67 68 74 20 61 6c 73 6f 0a 2a 2a it might also.**
14ce0 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f be necessary to
14cf0 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f 53 define _XOPEN_S
14d00 4f 55 52 43 45 20 74 6f 20 62 65 20 35 30 30 2e OURCE to be 500.
14d10 20 20 54 68 69 73 20 76 61 72 69 65 73 20 66 72 This varies fr
14d20 6f 6d 0a 2a 2a 20 6f 6e 65 20 73 79 73 74 65 6d om.** one system
14d30 20 74 6f 20 61 6e 6f 74 68 65 72 2e 20 20 53 69 to another. Si
14d40 6e 63 65 20 53 51 4c 69 74 65 20 64 6f 65 73 20 nce SQLite does
14d50 6e 6f 74 20 64 65 66 69 6e 65 20 55 53 45 5f 50 not define USE_P
14d60 52 45 41 44 0a 2a 2a 20 61 6e 79 20 61 6e 79 20 READ.** any any
14d70 66 6f 72 6d 20 62 79 20 64 65 66 61 75 6c 74 2c form by default,
14d80 20 77 65 20 77 69 6c 6c 20 6e 6f 74 20 61 74 74 we will not att
14d90 65 6d 70 74 20 74 6f 20 64 65 66 69 6e 65 20 5f empt to define _
14da0 58 4f 50 45 4e 5f 53 4f 55 52 43 45 2e 0a 2a 2a XOPEN_SOURCE..**
14db0 20 53 65 65 20 74 69 63 6b 65 74 73 20 23 32 37 See tickets #27
14dc0 34 31 20 61 6e 64 20 23 32 36 38 31 2e 0a 2a 2a 41 and #2681..**
14dd0 0a 2a 2a 20 54 6f 20 61 76 6f 69 64 20 73 74 6f .** To avoid sto
14de0 6d 70 69 6e 67 20 74 68 65 20 65 72 72 6e 6f 20 mping the errno
14df0 76 61 6c 75 65 20 6f 6e 20 61 20 66 61 69 6c 65 value on a faile
14e00 64 20 72 65 61 64 20 74 68 65 20 6c 61 73 74 45 d read the lastE
14e10 72 72 6e 6f 20 76 61 6c 75 65 0a 2a 2a 20 69 73 rrno value.** is
14e20 20 73 65 74 20 62 65 66 6f 72 65 20 72 65 74 75 set before retu
14e30 72 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 rning..*/.static
14e40 20 69 6e 74 20 73 65 65 6b 41 6e 64 52 65 61 64 int seekAndRead
14e50 28 75 6e 69 78 46 69 6c 65 20 2a 69 64 2c 20 73 (unixFile *id, s
14e60 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6f 66 66 qlite3_int64 off
14e70 73 65 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c set, void *pBuf,
14e80 20 69 6e 74 20 63 6e 74 29 7b 0a 20 20 69 6e 74 int cnt){. int
14e90 20 67 6f 74 3b 0a 23 69 66 20 28 21 64 65 66 69 got;.#if (!defi
14ea0 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29 20 26 ned(USE_PREAD) &
14eb0 26 20 21 64 65 66 69 6e 65 64 28 55 53 45 5f 50 & !defined(USE_P
14ec0 52 45 41 44 36 34 29 29 0a 20 20 69 36 34 20 6e READ64)). i64 n
14ed0 65 77 4f 66 66 73 65 74 3b 0a 23 65 6e 64 69 66 ewOffset;.#endif
14ee0 0a 20 20 54 49 4d 45 52 5f 53 54 41 52 54 3b 0a . TIMER_START;.
14ef0 23 69 66 20 64 65 66 69 6e 65 64 28 55 53 45 5f #if defined(USE_
14f00 50 52 45 41 44 29 0a 20 20 67 6f 74 20 3d 20 70 PREAD). got = p
14f10 72 65 61 64 28 69 64 2d 3e 68 2c 20 70 42 75 66 read(id->h, pBuf
14f20 2c 20 63 6e 74 2c 20 6f 66 66 73 65 74 29 3b 0a , cnt, offset);.
14f30 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f SimulateIOErro
14f40 72 28 20 67 6f 74 20 3d 20 2d 31 20 29 3b 0a 23 r( got = -1 );.#
14f50 65 6c 69 66 20 64 65 66 69 6e 65 64 28 55 53 45 elif defined(USE
14f60 5f 50 52 45 41 44 36 34 29 0a 20 20 67 6f 74 20 _PREAD64). got
14f70 3d 20 70 72 65 61 64 36 34 28 69 64 2d 3e 68 2c = pread64(id->h,
14f80 20 70 42 75 66 2c 20 63 6e 74 2c 20 6f 66 66 73 pBuf, cnt, offs
14f90 65 74 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49 et);. SimulateI
14fa0 4f 45 72 72 6f 72 28 20 67 6f 74 20 3d 20 2d 31 OError( got = -1
14fb0 20 29 3b 0a 23 65 6c 73 65 0a 20 20 6e 65 77 4f );.#else. newO
14fc0 66 66 73 65 74 20 3d 20 6c 73 65 65 6b 28 69 64 ffset = lseek(id
14fd0 2d 3e 68 2c 20 6f 66 66 73 65 74 2c 20 53 45 45 ->h, offset, SEE
14fe0 4b 5f 53 45 54 29 3b 0a 20 20 53 69 6d 75 6c 61 K_SET);. Simula
14ff0 74 65 49 4f 45 72 72 6f 72 28 20 6e 65 77 4f 66 teIOError( newOf
15000 66 73 65 74 2d 2d 20 29 3b 0a 20 20 69 66 28 20 fset-- );. if(
15010 6e 65 77 4f 66 66 73 65 74 21 3d 6f 66 66 73 65 newOffset!=offse
15020 74 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 65 77 t ){. if( new
15030 4f 66 66 73 65 74 20 3d 3d 20 2d 31 20 29 7b 0a Offset == -1 ){.
15040 20 20 20 20 20 20 28 28 75 6e 69 78 46 69 6c 65 ((unixFile
15050 2a 29 69 64 29 2d 3e 6c 61 73 74 45 72 72 6e 6f *)id)->lastErrno
15060 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 7d 65 = errno;. }e
15070 6c 73 65 7b 0a 20 20 20 20 20 20 28 28 75 6e 69 lse{. ((uni
15080 78 46 69 6c 65 2a 29 69 64 29 2d 3e 6c 61 73 74 xFile*)id)->last
15090 45 72 72 6e 6f 20 3d 20 30 3b 09 09 09 0a 20 20 Errno = 0;....
150a0 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 2d }. return -
150b0 31 3b 0a 20 20 7d 0a 20 20 67 6f 74 20 3d 20 72 1;. }. got = r
150c0 65 61 64 28 69 64 2d 3e 68 2c 20 70 42 75 66 2c ead(id->h, pBuf,
150d0 20 63 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 20 20 cnt);.#endif.
150e0 54 49 4d 45 52 5f 45 4e 44 3b 0a 20 20 69 66 28 TIMER_END;. if(
150f0 20 67 6f 74 3c 30 20 29 7b 0a 20 20 20 20 28 28 got<0 ){. ((
15100 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e 6c unixFile*)id)->l
15110 61 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f astErrno = errno
15120 3b 0a 20 20 7d 0a 20 20 4f 53 54 52 41 43 45 28 ;. }. OSTRACE(
15130 28 22 52 45 41 44 20 20 20 20 25 2d 33 64 20 25 ("READ %-3d %
15140 35 64 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e 22 5d %7lld %llu\n"
15150 2c 20 69 64 2d 3e 68 2c 20 67 6f 74 2c 20 6f 66 , id->h, got, of
15160 66 73 65 74 2c 20 54 49 4d 45 52 5f 45 4c 41 50 fset, TIMER_ELAP
15170 53 45 44 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 SED));. return
15180 67 6f 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 got;.}../*.** Re
15190 61 64 20 64 61 74 61 20 66 72 6f 6d 20 61 20 66 ad data from a f
151a0 69 6c 65 20 69 6e 74 6f 20 61 20 62 75 66 66 65 ile into a buffe
151b0 72 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 r. Return SQLIT
151c0 45 5f 4f 4b 20 69 66 20 61 6c 6c 0a 2a 2a 20 62 E_OK if all.** b
151d0 79 74 65 73 20 77 65 72 65 20 72 65 61 64 20 73 ytes were read s
151e0 75 63 63 65 73 73 66 75 6c 6c 79 20 61 6e 64 20 uccessfully and
151f0 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 69 66 20 SQLITE_IOERR if
15200 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a anything goes.**
15210 20 77 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 wrong..*/.stati
15220 63 20 69 6e 74 20 75 6e 69 78 52 65 61 64 28 0a c int unixRead(.
15230 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a sqlite3_file *
15240 69 64 2c 20 0a 20 20 76 6f 69 64 20 2a 70 42 75 id, . void *pBu
15250 66 2c 20 0a 20 20 69 6e 74 20 61 6d 74 2c 0a 20 f, . int amt,.
15260 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6f sqlite3_int64 o
15270 66 66 73 65 74 0a 29 7b 0a 20 20 75 6e 69 78 46 ffset.){. unixF
15280 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e ile *pFile = (un
15290 69 78 46 69 6c 65 20 2a 29 69 64 3b 0a 20 20 69 ixFile *)id;. i
152a0 6e 74 20 67 6f 74 3b 0a 20 20 61 73 73 65 72 74 nt got;. assert
152b0 28 20 69 64 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 ( id );.. /* If
152c0 20 74 68 69 73 20 69 73 20 61 20 64 61 74 61 62 this is a datab
152d0 61 73 65 20 66 69 6c 65 20 28 6e 6f 74 20 61 20 ase file (not a
152e0 6a 6f 75 72 6e 61 6c 2c 20 6d 61 73 74 65 72 2d journal, master-
152f0 6a 6f 75 72 6e 61 6c 20 6f 72 20 74 65 6d 70 0a journal or temp.
15300 20 20 2a 2a 20 66 69 6c 65 29 2c 20 74 68 65 20 ** file), the
15310 62 79 74 65 73 20 69 6e 20 74 68 65 20 6c 6f 63 bytes in the loc
15320 6b 69 6e 67 20 72 61 6e 67 65 20 73 68 6f 75 6c king range shoul
15330 64 20 6e 65 76 65 72 20 62 65 20 72 65 61 64 20 d never be read
15340 6f 72 20 77 72 69 74 74 65 6e 2e 20 2a 2f 0a 23 or written. */.#
15350 69 66 20 30 0a 20 20 61 73 73 65 72 74 28 20 70 if 0. assert( p
15360 46 69 6c 65 2d 3e 70 55 6e 75 73 65 64 3d 3d 30 File->pUnused==0
15370 0a 20 20 20 20 20 20 20 7c 7c 20 6f 66 66 73 65 . || offse
15380 74 3e 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 2b t>=PENDING_BYTE+
15390 35 31 32 0a 20 20 20 20 20 20 20 7c 7c 20 6f 66 512. || of
153a0 66 73 65 74 2b 61 6d 74 3c 3d 50 45 4e 44 49 4e fset+amt<=PENDIN
153b0 47 5f 42 59 54 45 20 0a 20 20 29 3b 0a 23 65 6e G_BYTE . );.#en
153c0 64 69 66 0a 0a 20 20 67 6f 74 20 3d 20 73 65 65 dif.. got = see
153d0 6b 41 6e 64 52 65 61 64 28 70 46 69 6c 65 2c 20 kAndRead(pFile,
153e0 6f 66 66 73 65 74 2c 20 70 42 75 66 2c 20 61 6d offset, pBuf, am
153f0 74 29 3b 0a 20 20 69 66 28 20 67 6f 74 3d 3d 61 t);. if( got==a
15400 6d 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e mt ){. return
15410 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
15420 6c 73 65 20 69 66 28 20 67 6f 74 3c 30 20 29 7b lse if( got<0 ){
15430 0a 20 20 20 20 2f 2a 20 6c 61 73 74 45 72 72 6e . /* lastErrn
15440 6f 20 73 65 74 20 62 79 20 73 65 65 6b 41 6e 64 o set by seekAnd
15450 52 65 61 64 20 2a 2f 0a 20 20 20 20 72 65 74 75 Read */. retu
15460 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f rn SQLITE_IOERR_
15470 52 45 41 44 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 READ;. }else{.
15480 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 pFile->lastEr
15490 72 6e 6f 20 3d 20 30 3b 20 2f 2a 20 6e 6f 74 20 rno = 0; /* not
154a0 61 20 73 79 73 74 65 6d 20 65 72 72 6f 72 20 2a a system error *
154b0 2f 0a 20 20 20 20 2f 2a 20 55 6e 72 65 61 64 20 /. /* Unread
154c0 70 61 72 74 73 20 6f 66 20 74 68 65 20 62 75 66 parts of the buf
154d0 66 65 72 20 6d 75 73 74 20 62 65 20 7a 65 72 6f fer must be zero
154e0 2d 66 69 6c 6c 65 64 20 2a 2f 0a 20 20 20 20 6d -filled */. m
154f0 65 6d 73 65 74 28 26 28 28 63 68 61 72 2a 29 70 emset(&((char*)p
15500 42 75 66 29 5b 67 6f 74 5d 2c 20 30 2c 20 61 6d Buf)[got], 0, am
15510 74 2d 67 6f 74 29 3b 0a 20 20 20 20 72 65 74 75 t-got);. retu
15520 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f rn SQLITE_IOERR_
15530 53 48 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 0a SHORT_READ;. }.
15540 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 6f }../*.** Seek to
15550 20 74 68 65 20 6f 66 66 73 65 74 20 69 6e 20 69 the offset in i
15560 64 2d 3e 6f 66 66 73 65 74 20 74 68 65 6e 20 72 d->offset then r
15570 65 61 64 20 63 6e 74 20 62 79 74 65 73 20 69 6e ead cnt bytes in
15580 74 6f 20 70 42 75 66 2e 0a 2a 2a 20 52 65 74 75 to pBuf..** Retu
15590 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
155a0 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79 20 bytes actually
155b0 72 65 61 64 2e 20 20 55 70 64 61 74 65 20 74 68 read. Update th
155c0 65 20 6f 66 66 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 e offset..**.**
155d0 54 6f 20 61 76 6f 69 64 20 73 74 6f 6d 70 69 6e To avoid stompin
155e0 67 20 74 68 65 20 65 72 72 6e 6f 20 76 61 6c 75 g the errno valu
155f0 65 20 6f 6e 20 61 20 66 61 69 6c 65 64 20 77 72 e on a failed wr
15600 69 74 65 20 74 68 65 20 6c 61 73 74 45 72 72 6e ite the lastErrn
15610 6f 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 o value.** is se
15620 74 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 t before returni
15630 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ng..*/.static in
15640 74 20 73 65 65 6b 41 6e 64 57 72 69 74 65 28 75 t seekAndWrite(u
15650 6e 69 78 46 69 6c 65 20 2a 69 64 2c 20 69 36 34 nixFile *id, i64
15660 20 6f 66 66 73 65 74 2c 20 63 6f 6e 73 74 20 76 offset, const v
15670 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 63 oid *pBuf, int c
15680 6e 74 29 7b 0a 20 20 69 6e 74 20 67 6f 74 3b 0a nt){. int got;.
15690 23 69 66 20 28 21 64 65 66 69 6e 65 64 28 55 53 #if (!defined(US
156a0 45 5f 50 52 45 41 44 29 20 26 26 20 21 64 65 66 E_PREAD) && !def
156b0 69 6e 65 64 28 55 53 45 5f 50 52 45 41 44 36 34 ined(USE_PREAD64
156c0 29 29 0a 20 20 69 36 34 20 6e 65 77 4f 66 66 73 )). i64 newOffs
156d0 65 74 3b 0a 23 65 6e 64 69 66 0a 20 20 54 49 4d et;.#endif. TIM
156e0 45 52 5f 53 54 41 52 54 3b 0a 23 69 66 20 64 65 ER_START;.#if de
156f0 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29 fined(USE_PREAD)
15700 0a 20 20 67 6f 74 20 3d 20 70 77 72 69 74 65 28 . got = pwrite(
15710 69 64 2d 3e 68 2c 20 70 42 75 66 2c 20 63 6e 74 id->h, pBuf, cnt
15720 2c 20 6f 66 66 73 65 74 29 3b 0a 23 65 6c 69 66 , offset);.#elif
15730 20 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 defined(USE_PRE
15740 41 44 36 34 29 0a 20 20 67 6f 74 20 3d 20 70 77 AD64). got = pw
15750 72 69 74 65 36 34 28 69 64 2d 3e 68 2c 20 70 42 rite64(id->h, pB
15760 75 66 2c 20 63 6e 74 2c 20 6f 66 66 73 65 74 29 uf, cnt, offset)
15770 3b 0a 23 65 6c 73 65 0a 20 20 6e 65 77 4f 66 66 ;.#else. newOff
15780 73 65 74 20 3d 20 6c 73 65 65 6b 28 69 64 2d 3e set = lseek(id->
15790 68 2c 20 6f 66 66 73 65 74 2c 20 53 45 45 4b 5f h, offset, SEEK_
157a0 53 45 54 29 3b 0a 20 20 69 66 28 20 6e 65 77 4f SET);. if( newO
157b0 66 66 73 65 74 21 3d 6f 66 66 73 65 74 20 29 7b ffset!=offset ){
157c0 0a 20 20 20 20 69 66 28 20 6e 65 77 4f 66 66 73 . if( newOffs
157d0 65 74 20 3d 3d 20 2d 31 20 29 7b 0a 20 20 20 20 et == -1 ){.
157e0 20 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 ((unixFile*)id
157f0 29 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 )->lastErrno = e
15800 72 72 6e 6f 3b 0a 20 20 20 20 7d 65 6c 73 65 7b rrno;. }else{
15810 0a 20 20 20 20 20 20 28 28 75 6e 69 78 46 69 6c . ((unixFil
15820 65 2a 29 69 64 29 2d 3e 6c 61 73 74 45 72 72 6e e*)id)->lastErrn
15830 6f 20 3d 20 30 3b 09 09 09 0a 20 20 20 20 7d 0a o = 0;.... }.
15840 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 return -1;.
15850 20 7d 0a 20 20 67 6f 74 20 3d 20 77 72 69 74 65 }. got = write
15860 28 69 64 2d 3e 68 2c 20 70 42 75 66 2c 20 63 6e (id->h, pBuf, cn
15870 74 29 3b 0a 23 65 6e 64 69 66 0a 20 20 54 49 4d t);.#endif. TIM
15880 45 52 5f 45 4e 44 3b 0a 20 20 69 66 28 20 67 6f ER_END;. if( go
15890 74 3c 30 20 29 7b 0a 20 20 20 20 28 28 75 6e 69 t<0 ){. ((uni
158a0 78 46 69 6c 65 2a 29 69 64 29 2d 3e 6c 61 73 74 xFile*)id)->last
158b0 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 Errno = errno;.
158c0 20 7d 0a 0a 20 20 4f 53 54 52 41 43 45 28 28 22 }.. OSTRACE(("
158d0 57 52 49 54 45 20 20 20 25 2d 33 64 20 25 35 64 WRITE %-3d %5d
158e0 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e 22 2c 20 %7lld %llu\n",
158f0 69 64 2d 3e 68 2c 20 67 6f 74 2c 20 6f 66 66 73 id->h, got, offs
15900 65 74 2c 20 54 49 4d 45 52 5f 45 4c 41 50 53 45 et, TIMER_ELAPSE
15910 44 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 67 6f D));. return go
15920 74 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 t;.}.../*.** Wri
15930 74 65 20 64 61 74 61 20 66 72 6f 6d 20 61 20 62 te data from a b
15940 75 66 66 65 72 20 69 6e 74 6f 20 61 20 66 69 6c uffer into a fil
15950 65 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 e. Return SQLIT
15960 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 0a E_OK on success.
15970 2a 2a 20 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72 ** or some other
15980 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 6e 20 66 error code on f
15990 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 ailure..*/.stati
159a0 63 20 69 6e 74 20 75 6e 69 78 57 72 69 74 65 28 c int unixWrite(
159b0 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 . sqlite3_file
159c0 2a 69 64 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f *id, . const vo
159d0 69 64 20 2a 70 42 75 66 2c 20 0a 20 20 69 6e 74 id *pBuf, . int
159e0 20 61 6d 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f amt,. sqlite3_
159f0 69 6e 74 36 34 20 6f 66 66 73 65 74 20 0a 29 7b int64 offset .){
15a00 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
15a10 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
15a20 69 64 3b 0a 20 20 69 6e 74 20 77 72 6f 74 65 20 id;. int wrote
15a30 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 69 = 0;. assert( i
15a40 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 d );. assert( a
15a50 6d 74 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 mt>0 );.. /* If
15a60 20 74 68 69 73 20 69 73 20 61 20 64 61 74 61 62 this is a datab
15a70 61 73 65 20 66 69 6c 65 20 28 6e 6f 74 20 61 20 ase file (not a
15a80 6a 6f 75 72 6e 61 6c 2c 20 6d 61 73 74 65 72 2d journal, master-
15a90 6a 6f 75 72 6e 61 6c 20 6f 72 20 74 65 6d 70 0a journal or temp.
15aa0 20 20 2a 2a 20 66 69 6c 65 29 2c 20 74 68 65 20 ** file), the
15ab0 62 79 74 65 73 20 69 6e 20 74 68 65 20 6c 6f 63 bytes in the loc
15ac0 6b 69 6e 67 20 72 61 6e 67 65 20 73 68 6f 75 6c king range shoul
15ad0 64 20 6e 65 76 65 72 20 62 65 20 72 65 61 64 20 d never be read
15ae0 6f 72 20 77 72 69 74 74 65 6e 2e 20 2a 2f 0a 23 or written. */.#
15af0 69 66 20 30 0a 20 20 61 73 73 65 72 74 28 20 70 if 0. assert( p
15b00 46 69 6c 65 2d 3e 70 55 6e 75 73 65 64 3d 3d 30 File->pUnused==0
15b10 0a 20 20 20 20 20 20 20 7c 7c 20 6f 66 66 73 65 . || offse
15b20 74 3e 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 2b t>=PENDING_BYTE+
15b30 35 31 32 0a 20 20 20 20 20 20 20 7c 7c 20 6f 66 512. || of
15b40 66 73 65 74 2b 61 6d 74 3c 3d 50 45 4e 44 49 4e fset+amt<=PENDIN
15b50 47 5f 42 59 54 45 20 0a 20 20 29 3b 0a 23 65 6e G_BYTE . );.#en
15b60 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 dif..#ifndef NDE
15b70 42 55 47 0a 20 20 2f 2a 20 49 66 20 77 65 20 61 BUG. /* If we a
15b80 72 65 20 64 6f 69 6e 67 20 61 20 6e 6f 72 6d 61 re doing a norma
15b90 6c 20 77 72 69 74 65 20 74 6f 20 61 20 64 61 74 l write to a dat
15ba0 61 62 61 73 65 20 66 69 6c 65 20 28 61 73 20 6f abase file (as o
15bb0 70 70 6f 73 65 64 20 74 6f 0a 20 20 2a 2a 20 64 pposed to. ** d
15bc0 6f 69 6e 67 20 61 20 68 6f 74 2d 6a 6f 75 72 6e oing a hot-journ
15bd0 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 6f 72 20 61 al rollback or a
15be0 20 77 72 69 74 65 20 74 6f 20 73 6f 6d 65 20 66 write to some f
15bf0 69 6c 65 20 6f 74 68 65 72 20 74 68 61 6e 20 61 ile other than a
15c00 0a 20 20 2a 2a 20 6e 6f 72 6d 61 6c 20 64 61 74 . ** normal dat
15c10 61 62 61 73 65 20 66 69 6c 65 29 20 74 68 65 6e abase file) then
15c20 20 72 65 63 6f 72 64 20 74 68 65 20 66 61 63 74 record the fact
15c30 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 that the databa
15c40 73 65 0a 20 20 2a 2a 20 68 61 73 20 63 68 61 6e se. ** has chan
15c50 67 65 64 2e 20 20 49 66 20 74 68 65 20 74 72 61 ged. If the tra
15c60 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 nsaction counter
15c70 20 69 73 20 6d 6f 64 69 66 69 65 64 2c 20 72 65 is modified, re
15c80 63 6f 72 64 20 74 68 61 74 0a 20 20 2a 2a 20 66 cord that. ** f
15c90 61 63 74 20 74 6f 6f 2e 0a 20 20 2a 2f 0a 20 20 act too.. */.
15ca0 69 66 28 20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 if( pFile->inNor
15cb0 6d 61 6c 57 72 69 74 65 20 29 7b 0a 20 20 20 20 malWrite ){.
15cc0 70 46 69 6c 65 2d 3e 64 62 55 70 64 61 74 65 20 pFile->dbUpdate
15cd0 3d 20 31 3b 20 20 2f 2a 20 54 68 65 20 64 61 74 = 1; /* The dat
15ce0 61 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 6d abase has been m
15cf0 6f 64 69 66 69 65 64 20 2a 2f 0a 20 20 20 20 69 odified */. i
15d00 66 28 20 6f 66 66 73 65 74 3c 3d 32 34 20 26 26 f( offset<=24 &&
15d10 20 6f 66 66 73 65 74 2b 61 6d 74 3e 3d 32 37 20 offset+amt>=27
15d20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 3b ){. int rc;
15d30 0a 20 20 20 20 20 20 63 68 61 72 20 6f 6c 64 43 . char oldC
15d40 6e 74 72 5b 34 5d 3b 0a 20 20 20 20 20 20 53 69 ntr[4];. Si
15d50 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e mulateIOErrorBen
15d60 69 67 6e 28 31 29 3b 0a 20 20 20 20 20 20 72 63 ign(1);. rc
15d70 20 3d 20 73 65 65 6b 41 6e 64 52 65 61 64 28 70 = seekAndRead(p
15d80 46 69 6c 65 2c 20 32 34 2c 20 6f 6c 64 43 6e 74 File, 24, oldCnt
15d90 72 2c 20 34 29 3b 0a 20 20 20 20 20 20 53 69 6d r, 4);. Sim
15da0 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 ulateIOErrorBeni
15db0 67 6e 28 30 29 3b 0a 20 20 20 20 20 20 69 66 28 gn(0);. if(
15dc0 20 72 63 21 3d 34 20 7c 7c 20 6d 65 6d 63 6d 70 rc!=4 || memcmp
15dd0 28 6f 6c 64 43 6e 74 72 2c 20 26 28 28 63 68 61 (oldCntr, &((cha
15de0 72 2a 29 70 42 75 66 29 5b 32 34 2d 6f 66 66 73 r*)pBuf)[24-offs
15df0 65 74 5d 2c 20 34 29 21 3d 30 20 29 7b 0a 20 20 et], 4)!=0 ){.
15e00 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 74 72 61 pFile->tra
15e10 6e 73 43 6e 74 72 43 68 6e 67 20 3d 20 31 3b 20 nsCntrChng = 1;
15e20 20 2f 2a 20 54 68 65 20 74 72 61 6e 73 61 63 74 /* The transact
15e30 69 6f 6e 20 63 6f 75 6e 74 65 72 20 68 61 73 20 ion counter has
15e40 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20 20 20 20 changed */.
15e50 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e }. }. }.#en
15e60 64 69 66 0a 0a 20 20 77 68 69 6c 65 28 20 61 6d dif.. while( am
15e70 74 3e 30 20 26 26 20 28 77 72 6f 74 65 20 3d 20 t>0 && (wrote =
15e80 73 65 65 6b 41 6e 64 57 72 69 74 65 28 70 46 69 seekAndWrite(pFi
15e90 6c 65 2c 20 6f 66 66 73 65 74 2c 20 70 42 75 66 le, offset, pBuf
15ea0 2c 20 61 6d 74 29 29 3e 30 20 29 7b 0a 20 20 20 , amt))>0 ){.
15eb0 20 61 6d 74 20 2d 3d 20 77 72 6f 74 65 3b 0a 20 amt -= wrote;.
15ec0 20 20 20 6f 66 66 73 65 74 20 2b 3d 20 77 72 6f offset += wro
15ed0 74 65 3b 0a 20 20 20 20 70 42 75 66 20 3d 20 26 te;. pBuf = &
15ee0 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 77 72 ((char*)pBuf)[wr
15ef0 6f 74 65 5d 3b 0a 20 20 7d 0a 20 20 53 69 6d 75 ote];. }. Simu
15f00 6c 61 74 65 49 4f 45 72 72 6f 72 28 28 20 77 72 lateIOError(( wr
15f10 6f 74 65 3d 28 2d 31 29 2c 20 61 6d 74 3d 31 20 ote=(-1), amt=1
15f20 29 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 44 69 ));. SimulateDi
15f30 73 6b 66 75 6c 6c 45 72 72 6f 72 28 28 20 77 72 skfullError(( wr
15f40 6f 74 65 3d 30 2c 20 61 6d 74 3d 31 20 29 29 3b ote=0, amt=1 ));
15f50 0a 20 20 69 66 28 20 61 6d 74 3e 30 20 29 7b 0a . if( amt>0 ){.
15f60 20 20 20 20 69 66 28 20 77 72 6f 74 65 3c 30 20 if( wrote<0
15f70 29 7b 0a 20 20 20 20 20 20 2f 2a 20 6c 61 73 74 ){. /* last
15f80 45 72 72 6e 6f 20 73 65 74 20 62 79 20 73 65 65 Errno set by see
15f90 6b 41 6e 64 57 72 69 74 65 20 2a 2f 0a 20 20 20 kAndWrite */.
15fa0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
15fb0 5f 49 4f 45 52 52 5f 57 52 49 54 45 3b 0a 20 20 _IOERR_WRITE;.
15fc0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
15fd0 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 File->lastErrno
15fe0 3d 20 30 3b 20 2f 2a 20 6e 6f 74 20 61 20 73 79 = 0; /* not a sy
15ff0 73 74 65 6d 20 65 72 72 6f 72 20 2a 2f 0a 20 20 stem error */.
16000 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
16010 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 7d 0a 20 20 E_FULL;. }.
16020 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
16030 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 E_OK;.}..#ifdef
16040 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a SQLITE_TEST./*.*
16050 2a 20 43 6f 75 6e 74 20 74 68 65 20 6e 75 6d 62 * Count the numb
16060 65 72 20 6f 66 20 66 75 6c 6c 73 79 6e 63 73 20 er of fullsyncs
16070 61 6e 64 20 6e 6f 72 6d 61 6c 20 73 79 6e 63 73 and normal syncs
16080 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 . This is used
16090 74 6f 20 74 65 73 74 0a 2a 2a 20 74 68 61 74 20 to test.** that
160a0 73 79 6e 63 73 20 61 6e 64 20 66 75 6c 6c 73 79 syncs and fullsy
160b0 6e 63 73 20 61 72 65 20 6f 63 63 75 72 72 69 6e ncs are occurrin
160c0 67 20 61 74 20 74 68 65 20 72 69 67 68 74 20 74 g at the right t
160d0 69 6d 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c imes..*/.int sql
160e0 69 74 65 33 5f 73 79 6e 63 5f 63 6f 75 6e 74 20 ite3_sync_count
160f0 3d 20 30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 = 0;.int sqlite3
16100 5f 66 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e 74 20 _fullsync_count
16110 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a = 0;.#endif../*.
16120 2a 2a 20 57 65 20 64 6f 20 6e 6f 74 20 74 72 75 ** We do not tru
16130 73 74 20 73 79 73 74 65 6d 73 20 74 6f 20 70 72 st systems to pr
16140 6f 76 69 64 65 20 61 20 77 6f 72 6b 69 6e 67 20 ovide a working
16150 66 64 61 74 61 73 79 6e 63 28 29 2e 20 20 53 6f fdatasync(). So
16160 6d 65 20 64 6f 2e 0a 2a 2a 20 4f 74 68 65 72 73 me do..** Others
16170 20 64 6f 20 6e 6f 2e 20 20 54 6f 20 62 65 20 73 do no. To be s
16180 61 66 65 2c 20 77 65 20 77 69 6c 6c 20 73 74 69 afe, we will sti
16190 63 6b 20 77 69 74 68 20 74 68 65 20 28 73 6c 6f ck with the (slo
161a0 77 65 72 29 20 66 73 79 6e 63 28 29 2e 0a 2a 2a wer) fsync()..**
161b0 20 49 66 20 79 6f 75 20 6b 6e 6f 77 20 74 68 61 If you know tha
161c0 74 20 79 6f 75 72 20 73 79 73 74 65 6d 20 64 6f t your system do
161d0 65 73 20 73 75 70 70 6f 72 74 20 66 64 61 74 61 es support fdata
161e0 73 79 6e 63 28 29 20 63 6f 72 72 65 63 74 6c 79 sync() correctly
161f0 2c 0a 2a 2a 20 74 68 65 6e 20 73 69 6d 70 6c 79 ,.** then simply
16200 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 2d 44 compile with -D
16210 66 64 61 74 61 73 79 6e 63 3d 66 64 61 74 61 73 fdatasync=fdatas
16220 79 6e 63 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 ync.*/.#if !defi
16230 6e 65 64 28 66 64 61 74 61 73 79 6e 63 29 20 26 ned(fdatasync) &
16240 26 20 21 64 65 66 69 6e 65 64 28 5f 5f 6c 69 6e & !defined(__lin
16250 75 78 5f 5f 29 0a 23 20 64 65 66 69 6e 65 20 66 ux__).# define f
16260 64 61 74 61 73 79 6e 63 20 66 73 79 6e 63 0a 23 datasync fsync.#
16270 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 endif../*.** Def
16280 69 6e 65 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 ine HAVE_FULLFSY
16290 4e 43 20 74 6f 20 30 20 6f 72 20 31 20 64 65 70 NC to 0 or 1 dep
162a0 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 ending on whethe
162b0 72 20 6f 72 20 6e 6f 74 0a 2a 2a 20 74 68 65 20 r or not.** the
162c0 46 5f 46 55 4c 4c 46 53 59 4e 43 20 6d 61 63 72 F_FULLFSYNC macr
162d0 6f 20 69 73 20 64 65 66 69 6e 65 64 2e 20 20 46 o is defined. F
162e0 5f 46 55 4c 4c 46 53 59 4e 43 20 69 73 20 63 75 _FULLFSYNC is cu
162f0 72 72 65 6e 74 6c 79 0a 2a 2a 20 6f 6e 6c 79 20 rrently.** only
16300 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 4d 61 63 available on Mac
16310 20 4f 53 20 58 2e 20 20 42 75 74 20 74 68 61 74 OS X. But that
16320 20 63 6f 75 6c 64 20 63 68 61 6e 67 65 2e 0a 2a could change..*
16330 2f 0a 23 69 66 64 65 66 20 46 5f 46 55 4c 4c 46 /.#ifdef F_FULLF
16340 53 59 4e 43 0a 23 20 64 65 66 69 6e 65 20 48 41 SYNC.# define HA
16350 56 45 5f 46 55 4c 4c 46 53 59 4e 43 20 31 0a 23 VE_FULLFSYNC 1.#
16360 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 48 41 else.# define HA
16370 56 45 5f 46 55 4c 4c 46 53 59 4e 43 20 30 0a 23 VE_FULLFSYNC 0.#
16380 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 endif.../*.** Th
16390 65 20 66 73 79 6e 63 28 29 20 73 79 73 74 65 6d e fsync() system
163a0 20 63 61 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 77 call does not w
163b0 6f 72 6b 20 61 73 20 61 64 76 65 72 74 69 73 65 ork as advertise
163c0 64 20 6f 6e 20 6d 61 6e 79 0a 2a 2a 20 75 6e 69 d on many.** uni
163d0 78 20 73 79 73 74 65 6d 73 2e 20 20 54 68 65 20 x systems. The
163e0 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 63 65 64 following proced
163f0 75 72 65 20 69 73 20 61 6e 20 61 74 74 65 6d 70 ure is an attemp
16400 74 20 74 6f 20 6d 61 6b 65 0a 2a 2a 20 69 74 20 t to make.** it
16410 77 6f 72 6b 20 62 65 74 74 65 72 2e 0a 2a 2a 0a work better..**.
16420 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4e 4f ** The SQLITE_NO
16430 5f 53 59 4e 43 20 6d 61 63 72 6f 20 64 69 73 61 _SYNC macro disa
16440 62 6c 65 73 20 61 6c 6c 20 66 73 79 6e 63 28 29 bles all fsync()
16450 73 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 66 s. This is usef
16460 75 6c 0a 2a 2a 20 66 6f 72 20 74 65 73 74 69 6e ul.** for testin
16470 67 20 77 68 65 6e 20 77 65 20 77 61 6e 74 20 74 g when we want t
16480 6f 20 72 75 6e 20 74 68 72 6f 75 67 68 20 74 68 o run through th
16490 65 20 74 65 73 74 20 73 75 69 74 65 20 71 75 69 e test suite qui
164a0 63 6b 6c 79 2e 0a 2a 2a 20 59 6f 75 20 61 72 65 ckly..** You are
164b0 20 73 74 72 6f 6e 67 6c 79 20 61 64 76 69 73 65 strongly advise
164c0 64 20 2a 6e 6f 74 2a 20 74 6f 20 64 65 70 6c 6f d *not* to deplo
164d0 79 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e 4f y with SQLITE_NO
164e0 5f 53 59 4e 43 0a 2a 2a 20 65 6e 61 62 6c 65 64 _SYNC.** enabled
164f0 2c 20 68 6f 77 65 76 65 72 2c 20 73 69 6e 63 65 , however, since
16500 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e 4f 5f with SQLITE_NO_
16510 53 59 4e 43 20 65 6e 61 62 6c 65 64 2c 20 61 6e SYNC enabled, an
16520 20 4f 53 20 63 72 61 73 68 0a 2a 2a 20 6f 72 20 OS crash.** or
16530 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 77 69 power failure wi
16540 6c 6c 20 6c 69 6b 65 6c 79 20 63 6f 72 72 75 70 ll likely corrup
16550 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 t the database f
16560 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 ile..**.** SQLit
16570 65 20 73 65 74 73 20 74 68 65 20 64 61 74 61 4f e sets the dataO
16580 6e 6c 79 20 66 6c 61 67 20 69 66 20 74 68 65 20 nly flag if the
16590 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 size of the file
165a0 20 69 73 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a is unchanged..*
165b0 2a 20 54 68 65 20 69 64 65 61 20 62 65 68 69 6e * The idea behin
165c0 64 20 64 61 74 61 4f 6e 6c 79 20 69 73 20 74 68 d dataOnly is th
165d0 61 74 20 69 74 20 73 68 6f 75 6c 64 20 6f 6e 6c at it should onl
165e0 79 20 77 72 69 74 65 20 74 68 65 20 66 69 6c 65 y write the file
165f0 20 63 6f 6e 74 65 6e 74 0a 2a 2a 20 74 6f 20 64 content.** to d
16600 69 73 6b 2c 20 6e 6f 74 20 74 68 65 20 69 6e 6f isk, not the ino
16610 64 65 2e 20 20 57 65 20 6f 6e 6c 79 20 73 65 74 de. We only set
16620 20 64 61 74 61 4f 6e 6c 79 20 69 66 20 74 68 65 dataOnly if the
16630 20 66 69 6c 65 20 73 69 7a 65 20 69 73 20 0a 2a file size is .*
16640 2a 20 75 6e 63 68 61 6e 67 65 64 20 73 69 6e 63 * unchanged sinc
16650 65 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 20 e the file size
16660 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 69 is part of the i
16670 6e 6f 64 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 node. However,
16680 0a 2a 2a 20 54 65 64 20 54 73 27 6f 20 74 65 6c .** Ted Ts'o tel
16690 6c 73 20 75 73 20 74 68 61 74 20 66 64 61 74 61 ls us that fdata
166a0 73 79 6e 63 28 29 20 77 69 6c 6c 20 61 6c 73 6f sync() will also
166b0 20 77 72 69 74 65 20 74 68 65 20 69 6e 6f 64 65 write the inode
166c0 20 69 66 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 if the.** file
166d0 73 69 7a 65 20 68 61 73 20 63 68 61 6e 67 65 64 size has changed
166e0 2e 20 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 6c . The only real
166f0 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 difference betw
16700 65 65 6e 20 66 64 61 74 61 73 79 6e 63 28 29 0a een fdatasync().
16710 2a 2a 20 61 6e 64 20 66 73 79 6e 63 28 29 2c 20 ** and fsync(),
16720 54 65 64 20 74 65 6c 6c 73 20 75 73 2c 20 69 73 Ted tells us, is
16730 20 74 68 61 74 20 66 64 61 74 61 73 79 6e 63 28 that fdatasync(
16740 29 20 77 69 6c 6c 20 6e 6f 74 20 66 6c 75 73 68 ) will not flush
16750 20 74 68 65 0a 2a 2a 20 69 6e 6f 64 65 20 69 66 the.** inode if
16760 20 74 68 65 20 6d 74 69 6d 65 20 6f 72 20 6f 77 the mtime or ow
16770 6e 65 72 20 6f 72 20 6f 74 68 65 72 20 69 6e 6f ner or other ino
16780 64 65 20 61 74 74 72 69 62 75 74 65 73 20 68 61 de attributes ha
16790 76 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2a 20 57 ve changed..** W
167a0 65 20 6f 6e 6c 79 20 63 61 72 65 20 61 62 6f 75 e only care abou
167b0 74 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 2c t the file size,
167c0 20 6e 6f 74 20 74 68 65 20 6f 74 68 65 72 20 66 not the other f
167d0 69 6c 65 20 61 74 74 72 69 62 75 74 65 73 2c 20 ile attributes,
167e0 73 6f 0a 2a 2a 20 61 73 20 66 61 72 20 61 73 20 so.** as far as
167f0 53 51 4c 69 74 65 20 69 73 20 63 6f 6e 63 65 72 SQLite is concer
16800 6e 65 64 2c 20 61 6e 20 66 64 61 74 61 73 79 6e ned, an fdatasyn
16810 63 28 29 20 69 73 20 61 6c 77 61 79 73 20 61 64 c() is always ad
16820 65 71 75 61 74 65 2e 0a 2a 2a 20 53 6f 2c 20 77 equate..** So, w
16830 65 20 61 6c 77 61 79 73 20 75 73 65 20 66 64 61 e always use fda
16840 74 61 73 79 6e 63 28 29 20 69 66 20 69 74 20 69 tasync() if it i
16850 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 72 65 67 s available, reg
16860 61 72 64 6c 65 73 73 20 6f 66 0a 2a 2a 20 74 68 ardless of.** th
16870 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 64 e value of the d
16880 61 74 61 4f 6e 6c 79 20 66 6c 61 67 2e 0a 2a 2f ataOnly flag..*/
16890 0a 73 74 61 74 69 63 20 69 6e 74 20 66 75 6c 6c .static int full
168a0 5f 66 73 79 6e 63 28 69 6e 74 20 66 64 2c 20 69 _fsync(int fd, i
168b0 6e 74 20 66 75 6c 6c 53 79 6e 63 2c 20 69 6e 74 nt fullSync, int
168c0 20 64 61 74 61 4f 6e 6c 79 29 7b 0a 20 20 69 6e dataOnly){. in
168d0 74 20 72 63 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 t rc;.. /* The
168e0 66 6f 6c 6c 6f 77 69 6e 67 20 22 69 66 64 65 66 following "ifdef
168f0 2f 65 6c 69 66 2f 65 6c 73 65 2f 22 20 62 6c 6f /elif/else/" blo
16900 63 6b 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 ck has the same
16910 73 74 72 75 63 74 75 72 65 20 61 73 0a 20 20 2a structure as. *
16920 2a 20 74 68 65 20 6f 6e 65 20 62 65 6c 6f 77 2e * the one below.
16930 20 49 74 20 69 73 20 72 65 70 6c 69 63 61 74 65 It is replicate
16940 64 20 68 65 72 65 20 73 6f 6c 65 6c 79 20 74 6f d here solely to
16950 20 61 76 6f 69 64 20 63 6c 75 74 74 65 72 69 6e avoid clutterin
16960 67 20 0a 20 20 2a 2a 20 75 70 20 74 68 65 20 72 g . ** up the r
16970 65 61 6c 20 63 6f 64 65 20 77 69 74 68 20 74 68 eal code with th
16980 65 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 e UNUSED_PARAMET
16990 45 52 28 29 20 6d 61 63 72 6f 73 2e 0a 20 20 2a ER() macros.. *
169a0 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
169b0 4e 4f 5f 53 59 4e 43 0a 20 20 55 4e 55 53 45 44 NO_SYNC. UNUSED
169c0 5f 50 41 52 41 4d 45 54 45 52 28 66 64 29 3b 0a _PARAMETER(fd);.
169d0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
169e0 45 52 28 66 75 6c 6c 53 79 6e 63 29 3b 0a 20 20 ER(fullSync);.
169f0 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
16a00 28 64 61 74 61 4f 6e 6c 79 29 3b 0a 23 65 6c 69 (dataOnly);.#eli
16a10 66 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e 43 f HAVE_FULLFSYNC
16a20 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
16a30 54 45 52 28 64 61 74 61 4f 6e 6c 79 29 3b 0a 23 TER(dataOnly);.#
16a40 65 6c 73 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 else. UNUSED_PA
16a50 52 41 4d 45 54 45 52 28 66 75 6c 6c 53 79 6e 63 RAMETER(fullSync
16a60 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 );. UNUSED_PARA
16a70 4d 45 54 45 52 28 64 61 74 61 4f 6e 6c 79 29 3b METER(dataOnly);
16a80 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 52 65 .#endif.. /* Re
16a90 63 6f 72 64 20 74 68 65 20 6e 75 6d 62 65 72 20 cord the number
16aa0 6f 66 20 74 69 6d 65 73 20 74 68 61 74 20 77 65 of times that we
16ab0 20 64 6f 20 61 20 6e 6f 72 6d 61 6c 20 66 73 79 do a normal fsy
16ac0 6e 63 28 29 20 61 6e 64 20 0a 20 20 2a 2a 20 46 nc() and . ** F
16ad0 55 4c 4c 53 59 4e 43 2e 20 20 54 68 69 73 20 69 ULLSYNC. This i
16ae0 73 20 75 73 65 64 20 64 75 72 69 6e 67 20 74 65 s used during te
16af0 73 74 69 6e 67 20 74 6f 20 76 65 72 69 66 79 20 sting to verify
16b00 74 68 61 74 20 74 68 69 73 20 70 72 6f 63 65 64 that this proced
16b10 75 72 65 0a 20 20 2a 2a 20 67 65 74 73 20 63 61 ure. ** gets ca
16b20 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 63 6f lled with the co
16b30 72 72 65 63 74 20 61 72 67 75 6d 65 6e 74 73 2e rrect arguments.
16b40 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c . */.#ifdef SQL
16b50 49 54 45 5f 54 45 53 54 0a 20 20 69 66 28 20 66 ITE_TEST. if( f
16b60 75 6c 6c 53 79 6e 63 20 29 20 73 71 6c 69 74 65 ullSync ) sqlite
16b70 33 5f 66 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e 74 3_fullsync_count
16b80 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 79 ++;. sqlite3_sy
16b90 6e 63 5f 63 6f 75 6e 74 2b 2b 3b 0a 23 65 6e 64 nc_count++;.#end
16ba0 69 66 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 63 if.. /* If we c
16bb0 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 ompiled with the
16bc0 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 20 SQLITE_NO_SYNC
16bd0 66 6c 61 67 2c 20 74 68 65 6e 20 73 79 6e 63 69 flag, then synci
16be0 6e 67 20 69 73 20 61 0a 20 20 2a 2a 20 6e 6f 2d ng is a. ** no-
16bf0 6f 70 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 op. */.#ifdef S
16c00 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 0a 20 20 QLITE_NO_SYNC.
16c10 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
16c20 23 65 6c 69 66 20 48 41 56 45 5f 46 55 4c 4c 46 #elif HAVE_FULLF
16c30 53 59 4e 43 0a 20 20 69 66 28 20 66 75 6c 6c 53 SYNC. if( fullS
16c40 79 6e 63 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 ync ){. rc =
16c50 66 63 6e 74 6c 28 66 64 2c 20 46 5f 46 55 4c 4c fcntl(fd, F_FULL
16c60 46 53 59 4e 43 2c 20 30 29 3b 0a 20 20 7d 65 6c FSYNC, 0);. }el
16c70 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 31 3b 0a se{. rc = 1;.
16c80 20 20 7d 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 }. /* If the
16c90 46 55 4c 4c 46 53 59 4e 43 20 66 61 69 6c 65 64 FULLFSYNC failed
16ca0 2c 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 61 , fall back to a
16cb0 74 74 65 6d 70 74 69 6e 67 20 61 6e 20 66 73 79 ttempting an fsy
16cc0 6e 63 28 29 2e 0a 20 20 2a 2a 20 49 74 20 73 68 nc().. ** It sh
16cd0 6f 75 6c 64 6e 27 74 20 62 65 20 70 6f 73 73 69 ouldn't be possi
16ce0 62 6c 65 20 66 6f 72 20 66 75 6c 6c 66 73 79 6e ble for fullfsyn
16cf0 63 20 74 6f 20 66 61 69 6c 20 6f 6e 20 74 68 65 c to fail on the
16d00 20 6c 6f 63 61 6c 20 0a 20 20 2a 2a 20 66 69 6c local . ** fil
16d10 65 20 73 79 73 74 65 6d 20 28 6f 6e 20 4f 53 58 e system (on OSX
16d20 29 2c 20 73 6f 20 66 61 69 6c 75 72 65 20 69 6e ), so failure in
16d30 64 69 63 61 74 65 73 20 74 68 61 74 20 46 55 4c dicates that FUL
16d40 4c 46 53 59 4e 43 0a 20 20 2a 2a 20 69 73 6e 27 LFSYNC. ** isn'
16d50 74 20 73 75 70 70 6f 72 74 65 64 20 66 6f 72 20 t supported for
16d60 74 68 69 73 20 66 69 6c 65 20 73 79 73 74 65 6d this file system
16d70 2e 20 53 6f 2c 20 61 74 74 65 6d 70 74 20 61 6e . So, attempt an
16d80 20 66 73 79 6e 63 20 0a 20 20 2a 2a 20 61 6e 64 fsync . ** and
16d90 20 28 66 6f 72 20 6e 6f 77 29 20 69 67 6e 6f 72 (for now) ignor
16da0 65 20 74 68 65 20 6f 76 65 72 68 65 61 64 20 6f e the overhead o
16db0 66 20 61 20 73 75 70 65 72 66 6c 75 6f 75 73 20 f a superfluous
16dc0 66 63 6e 74 6c 20 63 61 6c 6c 2e 20 20 0a 20 20 fcntl call. .
16dd0 2a 2a 20 49 74 27 64 20 62 65 20 62 65 74 74 65 ** It'd be bette
16de0 72 20 74 6f 20 64 65 74 65 63 74 20 66 75 6c 6c r to detect full
16df0 66 73 79 6e 63 20 73 75 70 70 6f 72 74 20 6f 6e fsync support on
16e00 63 65 20 61 6e 64 20 61 76 6f 69 64 20 0a 20 20 ce and avoid .
16e10 2a 2a 20 74 68 65 20 66 63 6e 74 6c 20 63 61 6c ** the fcntl cal
16e20 6c 20 65 76 65 72 79 20 74 69 6d 65 20 73 79 6e l every time syn
16e30 63 20 69 73 20 63 61 6c 6c 65 64 2e 0a 20 20 2a c is called.. *
16e40 2f 0a 20 20 69 66 28 20 72 63 20 29 20 72 63 20 /. if( rc ) rc
16e50 3d 20 66 73 79 6e 63 28 66 64 29 3b 0a 0a 23 65 = fsync(fd);..#e
16e60 6c 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 lif defined(__AP
16e70 50 4c 45 5f 5f 29 0a 20 20 2f 2a 20 66 64 61 74 PLE__). /* fdat
16e80 61 73 79 6e 63 28 29 20 6f 6e 20 48 46 53 2b 20 async() on HFS+
16e90 64 6f 65 73 6e 27 74 20 79 65 74 20 66 6c 75 73 doesn't yet flus
16ea0 68 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 20 h the file size
16eb0 69 66 20 69 74 20 63 68 61 6e 67 65 64 20 63 6f if it changed co
16ec0 72 72 65 63 74 6c 79 0a 20 20 2a 2a 20 73 6f 20 rrectly. ** so
16ed0 63 75 72 72 65 6e 74 6c 79 20 77 65 20 64 65 66 currently we def
16ee0 61 75 6c 74 20 74 6f 20 74 68 65 20 6d 61 63 72 ault to the macr
16ef0 6f 20 74 68 61 74 20 72 65 64 65 66 69 6e 65 73 o that redefines
16f00 20 66 64 61 74 61 73 79 6e 63 20 74 6f 20 66 73 fdatasync to fs
16f10 79 6e 63 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 ync. */. rc =
16f20 66 73 79 6e 63 28 66 64 29 3b 0a 23 65 6c 73 65 fsync(fd);.#else
16f30 20 0a 20 20 72 63 20 3d 20 66 64 61 74 61 73 79 . rc = fdatasy
16f40 6e 63 28 66 64 29 3b 0a 23 69 66 20 4f 53 5f 56 nc(fd);.#if OS_V
16f50 58 57 4f 52 4b 53 0a 20 20 69 66 28 20 72 63 3d XWORKS. if( rc=
16f60 3d 2d 31 20 26 26 20 65 72 72 6e 6f 3d 3d 45 4e =-1 && errno==EN
16f70 4f 54 53 55 50 20 29 7b 0a 20 20 20 20 72 63 20 OTSUP ){. rc
16f80 3d 20 66 73 79 6e 63 28 66 64 29 3b 0a 20 20 7d = fsync(fd);. }
16f90 0a 23 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 .#endif /* OS_VX
16fa0 57 4f 52 4b 53 20 2a 2f 0a 23 65 6e 64 69 66 20 WORKS */.#endif
16fb0 2f 2a 20 69 66 64 65 66 20 53 51 4c 49 54 45 5f /* ifdef SQLITE_
16fc0 4e 4f 5f 53 59 4e 43 20 65 6c 69 66 20 48 41 56 NO_SYNC elif HAV
16fd0 45 5f 46 55 4c 4c 46 53 59 4e 43 20 2a 2f 0a 0a E_FULLFSYNC */..
16fe0 20 20 69 66 28 20 4f 53 5f 56 58 57 4f 52 4b 53 if( OS_VXWORKS
16ff0 20 26 26 20 72 63 21 3d 20 2d 31 20 29 7b 0a 20 && rc!= -1 ){.
17000 20 20 20 72 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 rc = 0;. }.
17010 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
17020 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 *.** Make sure a
17030 6c 6c 20 77 72 69 74 65 73 20 74 6f 20 61 20 70 ll writes to a p
17040 61 72 74 69 63 75 6c 61 72 20 66 69 6c 65 20 61 articular file a
17050 72 65 20 63 6f 6d 6d 69 74 74 65 64 20 74 6f 20 re committed to
17060 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 disk..**.** If d
17070 61 74 61 4f 6e 6c 79 3d 3d 30 20 74 68 65 6e 20 ataOnly==0 then
17080 62 6f 74 68 20 74 68 65 20 66 69 6c 65 20 69 74 both the file it
17090 73 65 6c 66 20 61 6e 64 20 69 74 73 20 6d 65 74 self and its met
170a0 61 64 61 74 61 20 28 66 69 6c 65 0a 2a 2a 20 73 adata (file.** s
170b0 69 7a 65 2c 20 61 63 63 65 73 73 20 74 69 6d 65 ize, access time
170c0 2c 20 65 74 63 29 20 61 72 65 20 73 79 6e 63 65 , etc) are synce
170d0 64 2e 20 20 49 66 20 64 61 74 61 4f 6e 6c 79 21 d. If dataOnly!
170e0 3d 30 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 =0 then only the
170f0 0a 2a 2a 20 66 69 6c 65 20 64 61 74 61 20 69 73 .** file data is
17100 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 55 synced..**.** U
17110 6e 64 65 72 20 55 6e 69 78 2c 20 61 6c 73 6f 20 nder Unix, also
17120 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 make sure that t
17130 68 65 20 64 69 72 65 63 74 6f 72 79 20 65 6e 74 he directory ent
17140 72 79 20 66 6f 72 20 74 68 65 20 66 69 6c 65 0a ry for the file.
17150 2a 2a 20 68 61 73 20 62 65 65 6e 20 63 72 65 61 ** has been crea
17160 74 65 64 20 62 79 20 66 73 79 6e 63 2d 69 6e 67 ted by fsync-ing
17170 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 the directory t
17180 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 hat contains the
17190 20 66 69 6c 65 2e 0a 2a 2a 20 49 66 20 77 65 20 file..** If we
171a0 64 6f 20 6e 6f 74 20 64 6f 20 74 68 69 73 20 61 do not do this a
171b0 6e 64 20 77 65 20 65 6e 63 6f 75 6e 74 65 72 20 nd we encounter
171c0 61 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 2c a power failure,
171d0 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a 2a the directory.*
171e0 2a 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 * entry for the
171f0 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 74 20 6e 6f journal might no
17200 74 20 65 78 69 73 74 20 61 66 74 65 72 20 77 65 t exist after we
17210 20 72 65 62 6f 6f 74 2e 20 20 54 68 65 20 6e 65 reboot. The ne
17220 78 74 0a 2a 2a 20 53 51 4c 69 74 65 20 74 6f 20 xt.** SQLite to
17230 61 63 63 65 73 73 20 74 68 65 20 66 69 6c 65 20 access the file
17240 77 69 6c 6c 20 6e 6f 74 20 6b 6e 6f 77 20 74 68 will not know th
17250 61 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 65 at the journal e
17260 78 69 73 74 73 20 28 62 65 63 61 75 73 65 0a 2a xists (because.*
17270 2a 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 * the directory
17280 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 6a 6f entry for the jo
17290 75 72 6e 61 6c 20 77 61 73 20 6e 65 76 65 72 20 urnal was never
172a0 63 72 65 61 74 65 64 29 20 61 6e 64 20 74 68 65 created) and the
172b0 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 transaction.**
172c0 77 69 6c 6c 20 6e 6f 74 20 72 6f 6c 6c 20 62 61 will not roll ba
172d0 63 6b 20 2d 20 70 6f 73 73 69 62 6c 79 20 6c 65 ck - possibly le
172e0 61 64 69 6e 67 20 74 6f 20 64 61 74 61 62 61 73 ading to databas
172f0 65 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f e corruption..*/
17300 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 .static int unix
17310 53 79 6e 63 28 73 71 6c 69 74 65 33 5f 66 69 6c Sync(sqlite3_fil
17320 65 20 2a 69 64 2c 20 69 6e 74 20 66 6c 61 67 73 e *id, int flags
17330 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 ){. int rc;. u
17340 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d nixFile *pFile =
17350 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a (unixFile*)id;.
17360 0a 20 20 69 6e 74 20 69 73 44 61 74 61 4f 6e 6c . int isDataOnl
17370 79 20 3d 20 28 66 6c 61 67 73 26 53 51 4c 49 54 y = (flags&SQLIT
17380 45 5f 53 59 4e 43 5f 44 41 54 41 4f 4e 4c 59 29 E_SYNC_DATAONLY)
17390 3b 0a 20 20 69 6e 74 20 69 73 46 75 6c 6c 73 79 ;. int isFullsy
173a0 6e 63 20 3d 20 28 66 6c 61 67 73 26 30 78 30 46 nc = (flags&0x0F
173b0 29 3d 3d 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 )==SQLITE_SYNC_F
173c0 55 4c 4c 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b ULL;.. /* Check
173d0 20 74 68 61 74 20 6f 6e 65 20 6f 66 20 53 51 4c that one of SQL
173e0 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 ITE_SYNC_NORMAL
173f0 6f 72 20 46 55 4c 4c 20 77 61 73 20 70 61 73 73 or FULL was pass
17400 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 28 ed */. assert((
17410 66 6c 61 67 73 26 30 78 30 46 29 3d 3d 53 51 4c flags&0x0F)==SQL
17420 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 0a ITE_SYNC_NORMAL.
17430 20 20 20 20 20 20 7c 7c 20 28 66 6c 61 67 73 26 || (flags&
17440 30 78 30 46 29 3d 3d 53 51 4c 49 54 45 5f 53 59 0x0F)==SQLITE_SY
17450 4e 43 5f 46 55 4c 4c 0a 20 20 29 3b 0a 0a 20 20 NC_FULL. );..
17460 2f 2a 20 55 6e 69 78 20 63 61 6e 6e 6f 74 2c 20 /* Unix cannot,
17470 62 75 74 20 73 6f 6d 65 20 73 79 73 74 65 6d 73 but some systems
17480 20 6d 61 79 20 72 65 74 75 72 6e 20 53 51 4c 49 may return SQLI
17490 54 45 5f 46 55 4c 4c 20 66 72 6f 6d 20 68 65 72 TE_FULL from her
174a0 65 2e 20 54 68 69 73 0a 20 20 2a 2a 20 6c 69 6e e. This. ** lin
174b0 65 20 69 73 20 74 6f 20 74 65 73 74 20 74 68 61 e is to test tha
174c0 74 20 64 6f 69 6e 67 20 73 6f 20 64 6f 65 73 20 t doing so does
174d0 6e 6f 74 20 63 61 75 73 65 20 61 6e 79 20 70 72 not cause any pr
174e0 6f 62 6c 65 6d 73 2e 0a 20 20 2a 2f 0a 20 20 53 oblems.. */. S
174f0 69 6d 75 6c 61 74 65 44 69 73 6b 66 75 6c 6c 45 imulateDiskfullE
17500 72 72 6f 72 28 20 72 65 74 75 72 6e 20 53 51 4c rror( return SQL
17510 49 54 45 5f 46 55 4c 4c 20 29 3b 0a 0a 20 20 61 ITE_FULL );.. a
17520 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a ssert( pFile );.
17530 20 20 4f 53 54 52 41 43 45 28 28 22 53 59 4e 43 OSTRACE(("SYNC
17540 20 20 20 20 25 2d 33 64 5c 6e 22 2c 20 70 46 69 %-3d\n", pFi
17550 6c 65 2d 3e 68 29 29 3b 0a 20 20 72 63 20 3d 20 le->h));. rc =
17560 66 75 6c 6c 5f 66 73 79 6e 63 28 70 46 69 6c 65 full_fsync(pFile
17570 2d 3e 68 2c 20 69 73 46 75 6c 6c 73 79 6e 63 2c ->h, isFullsync,
17580 20 69 73 44 61 74 61 4f 6e 6c 79 29 3b 0a 20 20 isDataOnly);.
17590 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 SimulateIOError(
175a0 20 72 63 3d 31 20 29 3b 0a 20 20 69 66 28 20 72 rc=1 );. if( r
175b0 63 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e c ){. pFile->
175c0 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e lastErrno = errn
175d0 6f 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 o;. return SQ
175e0 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 59 4e 43 LITE_IOERR_FSYNC
175f0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 46 69 6c ;. }. if( pFil
17600 65 2d 3e 64 69 72 66 64 3e 3d 30 20 29 7b 0a 20 e->dirfd>=0 ){.
17610 20 20 20 69 6e 74 20 65 72 72 3b 0a 20 20 20 20 int err;.
17620 4f 53 54 52 41 43 45 28 28 22 44 49 52 53 59 4e OSTRACE(("DIRSYN
17630 43 20 25 2d 33 64 20 28 68 61 76 65 5f 66 75 6c C %-3d (have_ful
17640 6c 66 73 79 6e 63 3d 25 64 20 66 75 6c 6c 73 79 lfsync=%d fullsy
17650 6e 63 3d 25 64 29 5c 6e 22 2c 20 70 46 69 6c 65 nc=%d)\n", pFile
17660 2d 3e 64 69 72 66 64 2c 0a 20 20 20 20 20 20 20 ->dirfd,.
17670 20 20 20 20 20 48 41 56 45 5f 46 55 4c 4c 46 53 HAVE_FULLFS
17680 59 4e 43 2c 20 69 73 46 75 6c 6c 73 79 6e 63 29 YNC, isFullsync)
17690 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
176a0 45 5f 44 49 53 41 42 4c 45 5f 44 49 52 53 59 4e E_DISABLE_DIRSYN
176b0 43 0a 20 20 20 20 2f 2a 20 54 68 65 20 64 69 72 C. /* The dir
176c0 65 63 74 6f 72 79 20 73 79 6e 63 20 69 73 20 6f ectory sync is o
176d0 6e 6c 79 20 61 74 74 65 6d 70 74 65 64 20 69 66 nly attempted if
176e0 20 66 75 6c 6c 5f 66 73 79 6e 63 20 69 73 0a 20 full_fsync is.
176f0 20 20 20 2a 2a 20 74 75 72 6e 65 64 20 6f 66 66 ** turned off
17700 20 6f 72 20 75 6e 61 76 61 69 6c 61 62 6c 65 2e or unavailable.
17710 20 20 49 66 20 61 20 66 75 6c 6c 5f 66 73 79 6e If a full_fsyn
17720 63 20 6f 63 63 75 72 72 65 64 20 61 62 6f 76 65 c occurred above
17730 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20 74 68 ,. ** then th
17740 65 20 64 69 72 65 63 74 6f 72 79 20 73 79 6e 63 e directory sync
17750 20 69 73 20 73 75 70 65 72 66 6c 75 6f 75 73 2e is superfluous.
17760 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
17770 28 21 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e 43 (!HAVE_FULLFSYNC
17780 20 7c 7c 20 21 69 73 46 75 6c 6c 73 79 6e 63 29 || !isFullsync)
17790 20 26 26 20 66 75 6c 6c 5f 66 73 79 6e 63 28 70 && full_fsync(p
177a0 46 69 6c 65 2d 3e 64 69 72 66 64 2c 30 2c 30 29 File->dirfd,0,0)
177b0 20 29 7b 0a 20 20 20 20 20 20 20 2f 2a 0a 20 20 ){. /*.
177c0 20 20 20 20 20 2a 2a 20 57 65 20 68 61 76 65 20 ** We have
177d0 72 65 63 65 69 76 65 64 20 6d 75 6c 74 69 70 6c received multipl
177e0 65 20 72 65 70 6f 72 74 73 20 6f 66 20 66 73 79 e reports of fsy
177f0 6e 63 28 29 20 72 65 74 75 72 6e 69 6e 67 0a 20 nc() returning.
17800 20 20 20 20 20 20 2a 2a 20 65 72 72 6f 72 73 20 ** errors
17810 77 68 65 6e 20 61 70 70 6c 69 65 64 20 74 6f 20 when applied to
17820 64 69 72 65 63 74 6f 72 69 65 73 20 6f 6e 20 63 directories on c
17830 65 72 74 61 69 6e 20 66 69 6c 65 20 73 79 73 74 ertain file syst
17840 65 6d 73 2e 0a 20 20 20 20 20 20 20 2a 2a 20 41 ems.. ** A
17850 20 66 61 69 6c 65 64 20 64 69 72 65 63 74 6f 72 failed director
17860 79 20 73 79 6e 63 20 69 73 20 6e 6f 74 20 61 20 y sync is not a
17870 62 69 67 20 64 65 61 6c 2e 20 20 53 6f 20 69 74 big deal. So it
17880 20 73 65 65 6d 73 0a 20 20 20 20 20 20 20 2a 2a seems. **
17890 20 62 65 74 74 65 72 20 74 6f 20 69 67 6e 6f 72 better to ignor
178a0 65 20 74 68 65 20 65 72 72 6f 72 2e 20 20 54 69 e the error. Ti
178b0 63 6b 65 74 20 23 31 36 35 37 0a 20 20 20 20 20 cket #1657.
178c0 20 20 2a 2f 0a 20 20 20 20 20 20 20 2f 2a 20 70 */. /* p
178d0 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 File->lastErrno
178e0 3d 20 65 72 72 6e 6f 3b 20 2a 2f 0a 20 20 20 20 = errno; */.
178f0 20 20 20 2f 2a 20 72 65 74 75 72 6e 20 53 51 4c /* return SQL
17900 49 54 45 5f 49 4f 45 52 52 3b 20 2a 2f 0a 20 20 ITE_IOERR; */.
17910 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 65 }.#endif. e
17920 72 72 20 3d 20 63 6c 6f 73 65 28 70 46 69 6c 65 rr = close(pFile
17930 2d 3e 64 69 72 66 64 29 3b 20 2f 2a 20 4f 6e 6c ->dirfd); /* Onl
17940 79 20 6e 65 65 64 20 74 6f 20 73 79 6e 63 20 6f y need to sync o
17950 6e 63 65 2c 20 73 6f 20 63 6c 6f 73 65 20 74 68 nce, so close th
17960 65 20 2a 2f 0a 20 20 20 20 69 66 28 20 65 72 72 e */. if( err
17970 3d 3d 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 ==0 ){
17980 20 20 20 20 2f 2a 20 64 69 72 65 63 74 6f 72 79 /* directory
17990 20 77 68 65 6e 20 77 65 20 61 72 65 20 64 6f 6e when we are don
179a0 65 20 2a 2f 0a 20 20 20 20 20 20 70 46 69 6c 65 e */. pFile
179b0 2d 3e 64 69 72 66 64 20 3d 20 2d 31 3b 0a 20 20 ->dirfd = -1;.
179c0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
179d0 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 File->lastErrno
179e0 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 = errno;. r
179f0 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 c = SQLITE_IOERR
17a00 5f 44 49 52 5f 43 4c 4f 53 45 3b 0a 20 20 20 20 _DIR_CLOSE;.
17a10 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
17a20 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e c;.}../*.** Trun
17a30 63 61 74 65 20 61 6e 20 6f 70 65 6e 20 66 69 6c cate an open fil
17a40 65 20 74 6f 20 61 20 73 70 65 63 69 66 69 65 64 e to a specified
17a50 20 73 69 7a 65 0a 2a 2f 0a 73 74 61 74 69 63 20 size.*/.static
17a60 69 6e 74 20 75 6e 69 78 54 72 75 6e 63 61 74 65 int unixTruncate
17a70 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 (sqlite3_file *i
17a80 64 2c 20 69 36 34 20 6e 42 79 74 65 29 7b 0a 20 d, i64 nByte){.
17a90 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 int rc;. asser
17aa0 74 28 20 69 64 20 29 3b 0a 20 20 53 69 6d 75 6c t( id );. Simul
17ab0 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65 74 75 ateIOError( retu
17ac0 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f rn SQLITE_IOERR_
17ad0 54 52 55 4e 43 41 54 45 20 29 3b 0a 20 20 72 63 TRUNCATE );. rc
17ae0 20 3d 20 66 74 72 75 6e 63 61 74 65 28 28 28 75 = ftruncate(((u
17af0 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c nixFile*)id)->h,
17b00 20 28 6f 66 66 5f 74 29 6e 42 79 74 65 29 3b 0a (off_t)nByte);.
17b10 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
17b20 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d ((unixFile*)id)-
17b30 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 >lastErrno = err
17b40 6e 6f 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 no;. return S
17b50 51 4c 49 54 45 5f 49 4f 45 52 52 5f 54 52 55 4e QLITE_IOERR_TRUN
17b60 43 41 54 45 3b 0a 20 20 7d 65 6c 73 65 7b 0a 23 CATE;. }else{.#
17b70 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 ifndef NDEBUG.
17b80 20 20 2f 2a 20 49 66 20 77 65 20 61 72 65 20 64 /* If we are d
17b90 6f 69 6e 67 20 61 20 6e 6f 72 6d 61 6c 20 77 72 oing a normal wr
17ba0 69 74 65 20 74 6f 20 61 20 64 61 74 61 62 61 73 ite to a databas
17bb0 65 20 66 69 6c 65 20 28 61 73 20 6f 70 70 6f 73 e file (as oppos
17bc0 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 64 6f 69 ed to. ** doi
17bd0 6e 67 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c ng a hot-journal
17be0 20 72 6f 6c 6c 62 61 63 6b 20 6f 72 20 61 20 77 rollback or a w
17bf0 72 69 74 65 20 74 6f 20 73 6f 6d 65 20 66 69 6c rite to some fil
17c00 65 20 6f 74 68 65 72 20 74 68 61 6e 20 61 0a 20 e other than a.
17c10 20 20 20 2a 2a 20 6e 6f 72 6d 61 6c 20 64 61 74 ** normal dat
17c20 61 62 61 73 65 20 66 69 6c 65 29 20 61 6e 64 20 abase file) and
17c30 77 65 20 74 72 75 6e 63 61 74 65 20 74 68 65 20 we truncate the
17c40 66 69 6c 65 20 74 6f 20 7a 65 72 6f 20 6c 65 6e file to zero len
17c50 67 74 68 2c 0a 20 20 20 20 2a 2a 20 74 68 61 74 gth,. ** that
17c60 20 65 66 66 65 63 74 69 76 65 6c 79 20 75 70 64 effectively upd
17c70 61 74 65 73 20 74 68 65 20 63 68 61 6e 67 65 20 ates the change
17c80 63 6f 75 6e 74 65 72 2e 20 20 54 68 69 73 20 6d counter. This m
17c90 69 67 68 74 20 68 61 70 70 65 6e 0a 20 20 20 20 ight happen.
17ca0 2a 2a 20 77 68 65 6e 20 72 65 73 74 6f 72 69 6e ** when restorin
17cb0 67 20 61 20 64 61 74 61 62 61 73 65 20 75 73 69 g a database usi
17cc0 6e 67 20 74 68 65 20 62 61 63 6b 75 70 20 41 50 ng the backup AP
17cd0 49 20 66 72 6f 6d 20 61 20 7a 65 72 6f 2d 6c 65 I from a zero-le
17ce0 6e 67 74 68 0a 20 20 20 20 2a 2a 20 73 6f 75 72 ngth. ** sour
17cf0 63 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ce.. */. i
17d00 66 28 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 f( ((unixFile*)i
17d10 64 29 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 d)->inNormalWrit
17d20 65 20 26 26 20 6e 42 79 74 65 3d 3d 30 20 29 7b e && nByte==0 ){
17d30 0a 20 20 20 20 20 20 28 28 75 6e 69 78 46 69 6c . ((unixFil
17d40 65 2a 29 69 64 29 2d 3e 74 72 61 6e 73 43 6e 74 e*)id)->transCnt
17d50 72 43 68 6e 67 20 3d 20 31 3b 0a 20 20 20 20 7d rChng = 1;. }
17d60 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 72 65 74 .#endif.. ret
17d70 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
17d80 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 }.}../*.** Dete
17d90 72 6d 69 6e 65 20 74 68 65 20 63 75 72 72 65 6e rmine the curren
17da0 74 20 73 69 7a 65 20 6f 66 20 61 20 66 69 6c 65 t size of a file
17db0 20 69 6e 20 62 79 74 65 73 0a 2a 2f 0a 73 74 61 in bytes.*/.sta
17dc0 74 69 63 20 69 6e 74 20 75 6e 69 78 46 69 6c 65 tic int unixFile
17dd0 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c Size(sqlite3_fil
17de0 65 20 2a 69 64 2c 20 69 36 34 20 2a 70 53 69 7a e *id, i64 *pSiz
17df0 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 e){. int rc;.
17e00 73 74 72 75 63 74 20 73 74 61 74 20 62 75 66 3b struct stat buf;
17e10 0a 20 20 61 73 73 65 72 74 28 20 69 64 20 29 3b . assert( id );
17e20 0a 20 20 72 63 20 3d 20 66 73 74 61 74 28 28 28 . rc = fstat(((
17e30 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 unixFile*)id)->h
17e40 2c 20 26 62 75 66 29 3b 0a 20 20 53 69 6d 75 6c , &buf);. Simul
17e50 61 74 65 49 4f 45 72 72 6f 72 28 20 72 63 3d 31 ateIOError( rc=1
17e60 20 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 30 20 );. if( rc!=0
17e70 29 7b 0a 20 20 20 20 28 28 75 6e 69 78 46 69 6c ){. ((unixFil
17e80 65 2a 29 69 64 29 2d 3e 6c 61 73 74 45 72 72 6e e*)id)->lastErrn
17e90 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 72 o = errno;. r
17ea0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 eturn SQLITE_IOE
17eb0 52 52 5f 46 53 54 41 54 3b 0a 20 20 7d 0a 20 20 RR_FSTAT;. }.
17ec0 2a 70 53 69 7a 65 20 3d 20 62 75 66 2e 73 74 5f *pSize = buf.st_
17ed0 73 69 7a 65 3b 0a 0a 20 20 2f 2a 20 57 68 65 6e size;.. /* When
17ee0 20 6f 70 65 6e 69 6e 67 20 61 20 7a 65 72 6f 2d opening a zero-
17ef0 73 69 7a 65 20 64 61 74 61 62 61 73 65 2c 20 74 size database, t
17f00 68 65 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f he findInodeInfo
17f10 28 29 20 70 72 6f 63 65 64 75 72 65 0a 20 20 2a () procedure. *
17f20 2a 20 77 72 69 74 65 73 20 61 20 73 69 6e 67 6c * writes a singl
17f30 65 20 62 79 74 65 20 69 6e 74 6f 20 74 68 61 74 e byte into that
17f40 20 66 69 6c 65 20 69 6e 20 6f 72 64 65 72 20 74 file in order t
17f50 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 61 20 o work around a
17f60 62 75 67 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 bug. ** in the
17f70 4f 53 2d 58 20 6d 73 64 6f 73 20 66 69 6c 65 73 OS-X msdos files
17f80 79 73 74 65 6d 2e 20 20 49 6e 20 6f 72 64 65 72 ystem. In order
17f90 20 74 6f 20 61 76 6f 69 64 20 70 72 6f 62 6c 65 to avoid proble
17fa0 6d 73 20 77 69 74 68 20 75 70 70 65 72 0a 20 20 ms with upper.
17fb0 2a 2a 20 6c 61 79 65 72 73 2c 20 77 65 20 6e 65 ** layers, we ne
17fc0 65 64 20 74 6f 20 72 65 70 6f 72 74 20 74 68 69 ed to report thi
17fd0 73 20 66 69 6c 65 20 73 69 7a 65 20 61 73 20 7a s file size as z
17fe0 65 72 6f 20 65 76 65 6e 20 74 68 6f 75 67 68 20 ero even though
17ff0 69 74 20 69 73 0a 20 20 2a 2a 20 72 65 61 6c 6c it is. ** reall
18000 79 20 31 2e 20 20 20 54 69 63 6b 65 74 20 23 33 y 1. Ticket #3
18010 32 36 30 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 260.. */. if(
18020 2a 70 53 69 7a 65 3d 3d 31 20 29 20 2a 70 53 69 *pSize==1 ) *pSi
18030 7a 65 20 3d 20 30 3b 0a 0a 0a 20 20 72 65 74 75 ze = 0;... retu
18040 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
18050 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 .#if SQLITE_ENAB
18060 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
18070 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 && defined(__AP
18080 50 4c 45 5f 5f 29 0a 2f 2a 0a 2a 2a 20 48 61 6e PLE__)./*.** Han
18090 64 6c 65 72 20 66 6f 72 20 70 72 6f 78 79 2d 6c dler for proxy-l
180a0 6f 63 6b 69 6e 67 20 66 69 6c 65 2d 63 6f 6e 74 ocking file-cont
180b0 72 6f 6c 20 76 65 72 62 73 2e 20 20 44 65 66 69 rol verbs. Defi
180c0 6e 65 64 20 62 65 6c 6f 77 20 69 6e 20 74 68 65 ned below in the
180d0 0a 2a 2a 20 70 72 6f 78 79 69 6e 67 20 6c 6f 63 .** proxying loc
180e0 6b 69 6e 67 20 64 69 76 69 73 69 6f 6e 2e 0a 2a king division..*
180f0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f /.static int pro
18100 78 79 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 73 71 xyFileControl(sq
18110 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 69 6e 74 2c lite3_file*,int,
18120 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a void*);.#endif..
18130 0a 2f 2a 0a 2a 2a 20 49 6e 66 6f 72 6d 61 74 69 ./*.** Informati
18140 6f 6e 20 61 6e 64 20 63 6f 6e 74 72 6f 6c 20 6f on and control o
18150 66 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 68 f an open file h
18160 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 andle..*/.static
18170 20 69 6e 74 20 75 6e 69 78 46 69 6c 65 43 6f 6e int unixFileCon
18180 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c trol(sqlite3_fil
18190 65 20 2a 69 64 2c 20 69 6e 74 20 6f 70 2c 20 76 e *id, int op, v
181a0 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 73 77 oid *pArg){. sw
181b0 69 74 63 68 28 20 6f 70 20 29 7b 0a 20 20 20 20 itch( op ){.
181c0 63 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 case SQLITE_FCNT
181d0 4c 5f 4c 4f 43 4b 53 54 41 54 45 3a 20 7b 0a 20 L_LOCKSTATE: {.
181e0 20 20 20 20 20 2a 28 69 6e 74 2a 29 70 41 72 67 *(int*)pArg
181f0 20 3d 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 = ((unixFile*)i
18200 64 29 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 d)->eFileLock;.
18210 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
18220 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 TE_OK;. }.
18230 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4c 41 53 case SQLITE_LAS
18240 54 5f 45 52 52 4e 4f 3a 20 7b 0a 20 20 20 20 20 T_ERRNO: {.
18250 20 2a 28 69 6e 74 2a 29 70 41 72 67 20 3d 20 28 *(int*)pArg = (
18260 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e (unixFile*)id)->
18270 6c 61 73 74 45 72 72 6e 6f 3b 0a 20 20 20 20 20 lastErrno;.
18280 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
18290 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 K;. }. cas
182a0 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 53 e SQLITE_FCNTL_S
182b0 49 5a 45 5f 48 49 4e 54 3a 20 7b 0a 23 69 66 20 IZE_HINT: {.#if
182c0 30 20 2f 2a 20 4e 6f 20 70 65 72 66 6f 72 6d 61 0 /* No performa
182d0 6e 63 65 20 61 64 76 61 6e 74 61 67 65 20 73 65 nce advantage se
182e0 65 6e 20 6f 6e 20 4c 69 6e 75 78 20 2a 2f 0a 20 en on Linux */.
182f0 20 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 sqlite3_int
18300 36 34 20 73 7a 46 69 6c 65 20 3d 20 2a 28 73 71 64 szFile = *(sq
18310 6c 69 74 65 33 5f 69 6e 74 36 34 2a 29 70 41 72 lite3_int64*)pAr
18320 67 3b 0a 20 20 20 20 20 20 75 6e 69 78 46 69 6c g;. unixFil
18330 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 e *pFile = (unix
18340 46 69 6c 65 2a 29 69 64 3b 0a 20 20 20 20 20 20 File*)id;.
18350 66 74 72 75 6e 63 61 74 65 28 70 46 69 6c 65 2d ftruncate(pFile-
18360 3e 68 2c 20 73 7a 46 69 6c 65 29 3b 0a 23 65 6e >h, szFile);.#en
18370 64 69 66 0a 20 20 20 20 20 20 72 65 74 75 72 6e dif. return
18380 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
18390 7d 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 }.#ifndef NDEBUG
183a0 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 . /* The page
183b0 72 20 63 61 6c 6c 73 20 74 68 69 73 20 6d 65 74 r calls this met
183c0 68 6f 64 20 74 6f 20 73 69 67 6e 61 6c 20 74 68 hod to signal th
183d0 61 74 20 69 74 20 68 61 73 20 64 6f 6e 65 0a 20 at it has done.
183e0 20 20 20 2a 2a 20 61 20 72 6f 6c 6c 62 61 63 6b ** a rollback
183f0 20 61 6e 64 20 74 68 61 74 20 74 68 65 20 64 61 and that the da
18400 74 61 62 61 73 65 20 69 73 20 74 68 65 72 65 66 tabase is theref
18410 6f 72 65 20 75 6e 63 68 61 6e 67 65 64 20 61 6e ore unchanged an
18420 64 0a 20 20 20 20 2a 2a 20 69 74 20 68 65 6e 63 d. ** it henc
18430 65 20 69 74 20 69 73 20 4f 4b 20 66 6f 72 20 74 e it is OK for t
18440 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 he transaction c
18450 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 74 6f hange counter to
18460 20 62 65 0a 20 20 20 20 2a 2a 20 75 6e 63 68 61 be. ** uncha
18470 6e 67 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 nged.. */.
18480 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e case SQLITE_FCN
18490 54 4c 5f 44 42 5f 55 4e 43 48 41 4e 47 45 44 3a TL_DB_UNCHANGED:
184a0 20 7b 0a 20 20 20 20 20 20 28 28 75 6e 69 78 46 {. ((unixF
184b0 69 6c 65 2a 29 69 64 29 2d 3e 64 62 55 70 64 61 ile*)id)->dbUpda
184c0 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 te = 0;. re
184d0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
184e0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 }.#endif.#if
184f0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
18500 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 OCKING_STYLE &&
18510 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f defined(__APPLE_
18520 5f 29 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 _). case SQLI
18530 54 45 5f 53 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 TE_SET_LOCKPROXY
18540 46 49 4c 45 3a 0a 20 20 20 20 63 61 73 65 20 53 FILE:. case S
18550 51 4c 49 54 45 5f 47 45 54 5f 4c 4f 43 4b 50 52 QLITE_GET_LOCKPR
18560 4f 58 59 46 49 4c 45 3a 20 7b 0a 20 20 20 20 20 OXYFILE: {.
18570 20 72 65 74 75 72 6e 20 70 72 6f 78 79 46 69 6c return proxyFil
18580 65 43 6f 6e 74 72 6f 6c 28 69 64 2c 6f 70 2c 70 eControl(id,op,p
18590 41 72 67 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 Arg);. }.#end
185a0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 if /* SQLITE_ENA
185b0 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c BLE_LOCKING_STYL
185c0 45 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 E && defined(__A
185d0 50 50 4c 45 5f 5f 29 20 2a 2f 0a 20 20 7d 0a 20 PPLE__) */. }.
185e0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 return SQLITE_E
185f0 52 52 4f 52 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 RROR;.}../*.** R
18600 65 74 75 72 6e 20 74 68 65 20 73 65 63 74 6f 72 eturn the sector
18610 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f size in bytes o
18620 66 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 f the underlying
18630 20 62 6c 6f 63 6b 20 64 65 76 69 63 65 20 66 6f block device fo
18640 72 0a 2a 2a 20 74 68 65 20 73 70 65 63 69 66 69 r.** the specifi
18650 65 64 20 66 69 6c 65 2e 20 54 68 69 73 20 69 73 ed file. This is
18660 20 61 6c 6d 6f 73 74 20 61 6c 77 61 79 73 20 35 almost always 5
18670 31 32 20 62 79 74 65 73 2c 20 62 75 74 20 6d 61 12 bytes, but ma
18680 79 20 62 65 0a 2a 2a 20 6c 61 72 67 65 72 20 66 y be.** larger f
18690 6f 72 20 73 6f 6d 65 20 64 65 76 69 63 65 73 2e or some devices.
186a0 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 63 6f .**.** SQLite co
186b0 64 65 20 61 73 73 75 6d 65 73 20 74 68 69 73 20 de assumes this
186c0 66 75 6e 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 function cannot
186d0 66 61 69 6c 2e 20 49 74 20 61 6c 73 6f 20 61 73 fail. It also as
186e0 73 75 6d 65 73 20 74 68 61 74 0a 2a 2a 20 69 66 sumes that.** if
186f0 20 74 77 6f 20 66 69 6c 65 73 20 61 72 65 20 63 two files are c
18700 72 65 61 74 65 64 20 69 6e 20 74 68 65 20 73 61 reated in the sa
18710 6d 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 64 me file-system d
18720 69 72 65 63 74 6f 72 79 20 28 69 2e 65 2e 0a 2a irectory (i.e..*
18730 2a 20 61 20 64 61 74 61 62 61 73 65 20 61 6e 64 * a database and
18740 20 69 74 73 20 6a 6f 75 72 6e 61 6c 20 66 69 6c its journal fil
18750 65 29 20 74 68 61 74 20 74 68 65 20 73 65 63 74 e) that the sect
18760 6f 72 20 73 69 7a 65 20 77 69 6c 6c 20 62 65 20 or size will be
18770 74 68 65 0a 2a 2a 20 73 61 6d 65 20 66 6f 72 20 the.** same for
18780 62 6f 74 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 both..*/.static
18790 69 6e 74 20 75 6e 69 78 53 65 63 74 6f 72 53 69 int unixSectorSi
187a0 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ze(sqlite3_file
187b0 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 55 4e 55 *NotUsed){. UNU
187c0 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
187d0 74 55 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e tUsed);. return
187e0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
187f0 53 45 43 54 4f 52 5f 53 49 5a 45 3b 0a 7d 0a 0a SECTOR_SIZE;.}..
18800 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
18810 20 64 65 76 69 63 65 20 63 68 61 72 61 63 74 65 device characte
18820 72 69 73 74 69 63 73 20 66 6f 72 20 74 68 65 20 ristics for the
18830 66 69 6c 65 2e 20 54 68 69 73 20 69 73 20 61 6c file. This is al
18840 77 61 79 73 20 30 20 66 6f 72 20 75 6e 69 78 2e ways 0 for unix.
18850 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
18860 6e 69 78 44 65 76 69 63 65 43 68 61 72 61 63 74 nixDeviceCharact
18870 65 72 69 73 74 69 63 73 28 73 71 6c 69 74 65 33 eristics(sqlite3
18880 5f 66 69 6c 65 20 2a 4e 6f 74 55 73 65 64 29 7b _file *NotUsed){
18890 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
188a0 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
188b0 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 23 69 66 return 0;.}..#if
188c0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
188d0 5f 57 41 4c 0a 0a 0a 2f 2a 0a 2a 2a 20 4f 62 6a _WAL.../*.** Obj
188e0 65 63 74 20 75 73 65 64 20 74 6f 20 72 65 70 72 ect used to repr
188f0 65 73 65 6e 74 20 61 6e 20 73 68 61 72 65 64 20 esent an shared
18900 6d 65 6d 6f 72 79 20 62 75 66 66 65 72 2e 20 20 memory buffer.
18910 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 6d 75 6c 74 .**.** When mult
18920 69 70 6c 65 20 74 68 72 65 61 64 73 20 61 6c 6c iple threads all
18930 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 73 reference the s
18940 61 6d 65 20 77 61 6c 2d 69 6e 64 65 78 2c 20 65 ame wal-index, e
18950 61 63 68 20 74 68 72 65 61 64 0a 2a 2a 20 68 61 ach thread.** ha
18960 73 20 69 74 73 20 6f 77 6e 20 75 6e 69 78 53 68 s its own unixSh
18970 6d 20 6f 62 6a 65 63 74 2c 20 62 75 74 20 74 68 m object, but th
18980 65 79 20 61 6c 6c 20 70 6f 69 6e 74 20 74 6f 20 ey all point to
18990 61 20 73 69 6e 67 6c 65 20 69 6e 73 74 61 6e 63 a single instanc
189a0 65 0a 2a 2a 20 6f 66 20 74 68 69 73 20 75 6e 69 e.** of this uni
189b0 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 2e xShmNode object.
189c0 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 In other words
189d0 2c 20 65 61 63 68 20 77 61 6c 2d 69 6e 64 65 78 , each wal-index
189e0 20 69 73 20 6f 70 65 6e 65 64 0a 2a 2a 20 6f 6e is opened.** on
189f0 6c 79 20 6f 6e 63 65 20 70 65 72 20 70 72 6f 63 ly once per proc
18a00 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 ess..**.** Each
18a10 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 unixShmNode obje
18a20 63 74 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20 ct is connected
18a30 74 6f 20 61 20 73 69 6e 67 6c 65 20 75 6e 69 78 to a single unix
18a40 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 InodeInfo object
18a50 2e 0a 2a 2a 20 57 65 20 63 6f 75 6c 64 20 63 6f ..** We could co
18a60 61 6c 65 73 63 65 20 74 68 69 73 20 6f 62 6a 65 alesce this obje
18a70 63 74 20 69 6e 74 6f 20 75 6e 69 78 49 6e 6f 64 ct into unixInod
18a80 65 49 6e 66 6f 2c 20 62 75 74 20 74 68 61 74 20 eInfo, but that
18a90 77 6f 75 6c 64 20 6d 65 61 6e 0a 2a 2a 20 65 76 would mean.** ev
18aa0 65 72 79 20 6f 70 65 6e 20 66 69 6c 65 20 74 68 ery open file th
18ab0 61 74 20 64 6f 65 73 20 6e 6f 74 20 75 73 65 20 at does not use
18ac0 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 28 69 shared memory (i
18ad0 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 6d n other words, m
18ae0 6f 73 74 0a 2a 2a 20 6f 70 65 6e 20 66 69 6c 65 ost.** open file
18af0 73 29 20 77 6f 75 6c 64 20 68 61 76 65 20 74 6f s) would have to
18b00 20 63 61 72 72 79 20 61 72 6f 75 6e 64 20 74 68 carry around th
18b10 69 73 20 65 78 74 72 61 20 69 6e 66 6f 72 6d 61 is extra informa
18b20 74 69 6f 6e 2e 20 20 53 6f 0a 2a 2a 20 74 68 65 tion. So.** the
18b30 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f unixInodeInfo o
18b40 62 6a 65 63 74 20 63 6f 6e 74 61 69 6e 73 20 61 bject contains a
18b50 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 pointer to this
18b60 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a unixShmNode obj
18b70 65 63 74 0a 2a 2a 20 61 6e 64 20 74 68 65 20 75 ect.** and the u
18b80 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 nixShmNode objec
18b90 74 20 69 73 20 63 72 65 61 74 65 64 20 6f 6e 6c t is created onl
18ba0 79 20 77 68 65 6e 20 6e 65 65 64 65 64 2e 0a 2a y when needed..*
18bb0 2a 0a 2a 2a 20 75 6e 69 78 4d 75 74 65 78 48 65 *.** unixMutexHe
18bc0 6c 64 28 29 20 6d 75 73 74 20 62 65 20 74 72 75 ld() must be tru
18bd0 65 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 e when creating
18be0 6f 72 20 64 65 73 74 72 6f 79 69 6e 67 0a 2a 2a or destroying.**
18bf0 20 74 68 69 73 20 6f 62 6a 65 63 74 20 6f 72 20 this object or
18c00 77 68 69 6c 65 20 72 65 61 64 69 6e 67 20 6f 72 while reading or
18c10 20 77 72 69 74 69 6e 67 20 74 68 65 20 66 6f 6c writing the fol
18c20 6c 6f 77 69 6e 67 20 66 69 65 6c 64 73 3a 0a 2a lowing fields:.*
18c30 2a 0a 2a 2a 20 20 20 20 20 20 6e 52 65 66 0a 2a *.** nRef.*
18c40 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
18c50 6e 67 20 66 69 65 6c 64 73 20 61 72 65 20 72 65 ng fields are re
18c60 61 64 2d 6f 6e 6c 79 20 61 66 74 65 72 20 74 68 ad-only after th
18c70 65 20 6f 62 6a 65 63 74 20 69 73 20 63 72 65 61 e object is crea
18c80 74 65 64 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 20 20 ted:.** .**
18c90 20 66 69 64 0a 2a 2a 20 20 20 20 20 20 7a 46 69 fid.** zFi
18ca0 6c 65 6e 61 6d 65 0a 2a 2a 0a 2a 2a 20 45 69 74 lename.**.** Eit
18cb0 68 65 72 20 75 6e 69 78 53 68 6d 4e 6f 64 65 2e her unixShmNode.
18cc0 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 mutex must be he
18cd0 6c 64 20 6f 72 20 75 6e 69 78 53 68 6d 4e 6f 64 ld or unixShmNod
18ce0 65 2e 6e 52 65 66 3d 3d 30 20 61 6e 64 0a 2a 2a e.nRef==0 and.**
18cf0 20 75 6e 69 78 4d 75 74 65 78 48 65 6c 64 28 29 unixMutexHeld()
18d00 20 69 73 20 74 72 75 65 20 77 68 65 6e 20 72 65 is true when re
18d10 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 ading or writing
18d20 20 61 6e 79 20 6f 74 68 65 72 20 66 69 65 6c 64 any other field
18d30 0a 2a 2a 20 69 6e 20 74 68 69 73 20 73 74 72 75 .** in this stru
18d40 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 cture..**.** To
18d50 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 73 2c avoid deadlocks,
18d60 20 6d 75 74 65 78 20 61 6e 64 20 6d 75 74 65 78 mutex and mutex
18d70 42 75 66 20 61 72 65 20 61 6c 77 61 79 73 20 72 Buf are always r
18d80 65 6c 65 61 73 65 64 20 69 6e 20 74 68 65 0a 2a eleased in the.*
18d90 2a 20 72 65 76 65 72 73 65 20 6f 72 64 65 72 20 * reverse order
18da0 74 68 61 74 20 74 68 65 79 20 61 72 65 20 61 63 that they are ac
18db0 71 75 69 72 65 64 2e 20 20 6d 75 74 65 78 42 75 quired. mutexBu
18dc0 66 20 69 73 20 61 6c 77 61 79 73 20 61 63 71 75 f is always acqu
18dd0 69 72 65 64 0a 2a 2a 20 66 69 72 73 74 20 61 6e ired.** first an
18de0 64 20 72 65 6c 65 61 73 65 64 20 6c 61 73 74 2e d released last.
18df0 20 20 54 68 69 73 20 69 6e 76 61 72 69 61 6e 74 This invariant
18e00 20 69 73 20 63 68 65 63 6b 20 62 79 20 61 73 73 is check by ass
18e10 65 72 74 69 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 erting.** sqlite
18e20 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 3_mutex_notheld(
18e30 29 20 6f 6e 20 6d 75 74 65 78 20 77 68 65 6e 65 ) on mutex whene
18e40 76 65 72 20 6d 75 74 65 78 42 75 66 20 69 73 20 ver mutexBuf is
18e50 61 63 71 75 69 72 65 64 20 6f 72 0a 2a 2a 20 72 acquired or.** r
18e60 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 eleased..*/.stru
18e70 63 74 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 7b ct unixShmNode {
18e80 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f . unixInodeInfo
18e90 20 2a 70 49 6e 6f 64 65 3b 20 20 20 20 20 2f 2a *pInode; /*
18ea0 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 74 unixInodeInfo t
18eb0 68 61 74 20 6f 77 6e 73 20 74 68 69 73 20 53 48 hat owns this SH
18ec0 4d 20 6e 6f 64 65 20 2a 2f 0a 20 20 73 71 6c 69 M node */. sqli
18ed0 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
18ee0 3b 20 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 ; /* Mutex
18ef0 74 6f 20 61 63 63 65 73 73 20 74 68 69 73 20 6f to access this o
18f00 62 6a 65 63 74 20 2a 2f 0a 20 20 73 71 6c 69 74 bject */. sqlit
18f10 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 42 e3_mutex *mutexB
18f20 75 66 3b 20 20 20 2f 2a 20 4d 75 74 65 78 20 74 uf; /* Mutex t
18f30 6f 20 61 63 63 65 73 73 20 7a 42 75 66 5b 5d 20 o access zBuf[]
18f40 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c 65 */. char *zFile
18f50 6e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 name;
18f60 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6d /* Name of the m
18f70 6d 61 70 70 65 64 20 66 69 6c 65 20 2a 2f 0a 20 mapped file */.
18f80 20 69 6e 74 20 68 3b 20 20 20 20 20 20 20 20 20 int h;
18f90 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
18fa0 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 pen file descrip
18fb0 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 4d tor */. int szM
18fc0 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ap;
18fd0 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
18fe0 68 65 20 6d 61 70 70 69 6e 67 20 69 6e 74 6f 20 he mapping into
18ff0 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 63 68 61 72 memory */. char
19000 20 2a 70 4d 4d 61 70 42 75 66 3b 20 20 20 20 20 *pMMapBuf;
19010 20 20 20 20 20 20 20 2f 2a 20 57 68 65 72 65 20 /* Where
19020 63 75 72 72 65 6e 74 6c 79 20 6d 6d 61 70 70 65 currently mmappe
19030 64 28 29 2e 20 20 4e 55 4c 4c 20 69 66 20 75 6e d(). NULL if un
19040 6d 61 70 70 65 64 20 2a 2f 0a 20 20 69 6e 74 20 mapped */. int
19050 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 nRef;
19060 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
19070 20 6f 66 20 75 6e 69 78 53 68 6d 20 6f 62 6a 65 of unixShm obje
19080 63 74 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 cts pointing to
19090 74 68 69 73 20 2a 2f 0a 20 20 75 6e 69 78 53 68 this */. unixSh
190a0 6d 20 2a 70 46 69 72 73 74 3b 20 20 20 20 20 20 m *pFirst;
190b0 20 20 20 20 20 2f 2a 20 41 6c 6c 20 75 6e 69 78 /* All unix
190c0 53 68 6d 20 6f 62 6a 65 63 74 73 20 70 6f 69 6e Shm objects poin
190d0 74 69 6e 67 20 74 6f 20 74 68 69 73 20 2a 2f 0a ting to this */.
190e0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
190f0 42 55 47 0a 20 20 75 38 20 65 78 63 6c 4d 61 73 BUG. u8 exclMas
19100 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k;
19110 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 65 78 63 6c /* Mask of excl
19120 75 73 69 76 65 20 6c 6f 63 6b 73 20 68 65 6c 64 usive locks held
19130 20 2a 2f 0a 20 20 75 38 20 73 68 61 72 65 64 4d */. u8 sharedM
19140 61 73 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 ask;
19150 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 73 68 61 72 /* Mask of shar
19160 65 64 20 6c 6f 63 6b 73 20 68 65 6c 64 20 2a 2f ed locks held */
19170 0a 20 20 75 38 20 6e 65 78 74 53 68 6d 49 64 3b . u8 nextShmId;
19180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
19190 20 4e 65 78 74 20 61 76 61 69 6c 61 62 6c 65 20 Next available
191a0 75 6e 69 78 53 68 6d 2e 69 64 20 76 61 6c 75 65 unixShm.id value
191b0 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f */.#endif.};../
191c0 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 20 75 *.** Structure u
191d0 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 62 sed internally b
191e0 79 20 74 68 69 73 20 56 46 53 20 74 6f 20 72 65 y this VFS to re
191f0 63 6f 72 64 20 74 68 65 20 73 74 61 74 65 20 6f cord the state o
19200 66 20 61 6e 0a 2a 2a 20 6f 70 65 6e 20 73 68 61 f an.** open sha
19210 72 65 64 20 6d 65 6d 6f 72 79 20 63 6f 6e 6e 65 red memory conne
19220 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ction..**.** The
19230 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 69 65 6c 64 following field
19240 73 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 s are initialize
19250 64 20 77 68 65 6e 20 74 68 69 73 20 6f 62 6a 65 d when this obje
19260 63 74 20 69 73 20 63 72 65 61 74 65 64 20 61 6e ct is created an
19270 64 0a 2a 2a 20 61 72 65 20 72 65 61 64 2d 6f 6e d.** are read-on
19280 6c 79 20 74 68 65 72 65 61 66 74 65 72 3a 0a 2a ly thereafter:.*
19290 2a 0a 2a 2a 20 20 20 20 75 6e 69 78 53 68 6d 2e *.** unixShm.
192a0 70 46 69 6c 65 0a 2a 2a 20 20 20 20 75 6e 69 78 pFile.** unix
192b0 53 68 6d 2e 69 64 0a 2a 2a 0a 2a 2a 20 41 6c 6c Shm.id.**.** All
192c0 20 6f 74 68 65 72 20 66 69 65 6c 64 73 20 61 72 other fields ar
192d0 65 20 72 65 61 64 2f 77 72 69 74 65 2e 20 20 54 e read/write. T
192e0 68 65 20 75 6e 69 78 53 68 6d 2e 70 46 69 6c 65 he unixShm.pFile
192f0 2d 3e 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20 ->mutex must be
19300 68 65 6c 64 0a 2a 2a 20 77 68 69 6c 65 20 61 63 held.** while ac
19310 63 65 73 73 69 6e 67 20 61 6e 79 20 72 65 61 64 cessing any read
19320 2f 77 72 69 74 65 20 66 69 65 6c 64 73 2e 0a 2a /write fields..*
19330 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 53 68 6d /.struct unixShm
19340 20 7b 0a 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 {. unixShmNode
19350 20 2a 70 53 68 6d 4e 6f 64 65 3b 20 20 20 20 20 *pShmNode;
19360 2f 2a 20 54 68 65 20 75 6e 64 65 72 6c 79 69 6e /* The underlyin
19370 67 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 g unixShmNode ob
19380 6a 65 63 74 20 2a 2f 0a 20 20 75 6e 69 78 53 68 ject */. unixSh
19390 6d 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 m *pNext;
193a0 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 75 6e 69 /* Next uni
193b0 78 53 68 6d 20 77 69 74 68 20 74 68 65 20 73 61 xShm with the sa
193c0 6d 65 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a me unixShmNode *
193d0 2f 0a 20 20 75 38 20 68 61 73 4d 75 74 65 78 3b /. u8 hasMutex;
193e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
193f0 2a 20 54 72 75 65 20 69 66 20 68 6f 6c 64 69 6e * True if holdin
19400 67 20 74 68 65 20 75 6e 69 78 53 68 6d 4e 6f 64 g the unixShmNod
19410 65 20 6d 75 74 65 78 20 2a 2f 0a 20 20 75 38 20 e mutex */. u8
19420 68 61 73 4d 75 74 65 78 42 75 66 3b 20 20 20 20 hasMutexBuf;
19430 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
19440 69 66 20 68 6f 6c 64 69 6e 67 20 70 46 69 6c 65 if holding pFile
19450 2d 3e 6d 75 74 65 78 42 75 66 20 2a 2f 0a 20 20 ->mutexBuf */.
19460 75 31 36 20 73 68 61 72 65 64 4d 61 73 6b 3b 20 u16 sharedMask;
19470 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 /* Ma
19480 73 6b 20 6f 66 20 73 68 61 72 65 64 20 6c 6f 63 sk of shared loc
19490 6b 73 20 68 65 6c 64 20 2a 2f 0a 20 20 75 31 36 ks held */. u16
194a0 20 65 78 63 6c 4d 61 73 6b 3b 20 20 20 20 20 20 exclMask;
194b0 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 /* Mask
194c0 6f 66 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 of exclusive loc
194d0 6b 73 20 68 65 6c 64 20 2a 2f 0a 23 69 66 64 65 ks held */.#ifde
194e0 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
194f0 20 75 38 20 69 64 3b 20 20 20 20 20 20 20 20 20 u8 id;
19500 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
19510 64 20 6f 66 20 74 68 69 73 20 63 6f 6e 6e 65 63 d of this connec
19520 74 69 6f 6e 20 77 69 74 68 69 6e 20 69 74 73 20 tion within its
19530 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 2f 0a 23 unixShmNode */.#
19540 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 endif.};../*.**
19550 43 6f 6e 73 74 61 6e 74 73 20 75 73 65 64 20 66 Constants used f
19560 6f 72 20 6c 6f 63 6b 69 6e 67 0a 2a 2f 0a 23 64 or locking.*/.#d
19570 65 66 69 6e 65 20 55 4e 49 58 5f 53 48 4d 5f 42 efine UNIX_SHM_B
19580 41 53 45 20 20 20 20 20 20 38 31 20 20 20 20 20 ASE 81
19590 20 20 20 2f 2a 20 42 79 74 65 20 6f 66 66 73 65 /* Byte offse
195a0 74 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6c t of the first l
195b0 6f 63 6b 20 62 79 74 65 20 2a 2f 0a 23 64 65 66 ock byte */.#def
195c0 69 6e 65 20 55 4e 49 58 5f 53 48 4d 5f 44 4d 53 ine UNIX_SHM_DMS
195d0 20 20 20 20 20 20 20 38 30 20 20 20 20 20 20 20 80
195e0 20 2f 2a 20 54 68 65 20 64 65 61 64 6d 61 6e 20 /* The deadman
195f0 73 77 69 74 63 68 20 6c 6f 63 6b 20 2a 2f 0a 0a switch lock */..
19600 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
19610 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e BUG./*.** Return
19620 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
19630 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 65 64 20 73 nul-terminated s
19640 74 72 69 6e 67 20 69 6e 20 73 74 61 74 69 63 20 tring in static
19650 6d 65 6d 6f 72 79 20 74 68 61 74 0a 2a 2a 20 64 memory that.** d
19660 65 73 63 72 69 62 65 73 20 61 20 6c 6f 63 6b 69 escribes a locki
19670 6e 67 20 6d 61 73 6b 2e 20 20 54 68 65 20 73 74 ng mask. The st
19680 72 69 6e 67 20 69 73 20 6f 66 20 74 68 65 20 66 ring is of the f
19690 6f 72 6d 20 22 4d 53 41 42 43 44 22 20 77 69 74 orm "MSABCD" wit
196a0 68 0a 2a 2a 20 65 61 63 68 20 63 68 61 72 61 63 h.** each charac
196b0 74 65 72 20 72 65 70 72 65 73 65 6e 74 69 6e 67 ter representing
196c0 20 61 20 6c 6f 63 6b 2e 20 20 22 4d 22 20 66 6f a lock. "M" fo
196d0 72 20 4d 55 54 45 58 2c 20 22 53 22 20 66 6f 72 r MUTEX, "S" for
196e0 20 44 4d 53 2c 20 0a 2a 2a 20 61 6e 64 20 22 41 DMS, .** and "A
196f0 22 20 74 68 72 6f 75 67 68 20 22 44 22 20 66 6f " through "D" fo
19700 72 20 74 68 65 20 72 65 67 69 6f 6e 20 6c 6f 63 r the region loc
19710 6b 73 2e 20 20 49 66 20 61 20 6c 6f 63 6b 20 69 ks. If a lock i
19720 73 20 68 65 6c 64 2c 20 74 68 65 0a 2a 2a 20 6c s held, the.** l
19730 65 74 74 65 72 20 69 73 20 73 68 6f 77 6e 2e 20 etter is shown.
19740 20 49 66 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 If the lock is
19750 6e 6f 74 20 68 65 6c 64 2c 20 74 68 65 20 6c 65 not held, the le
19760 74 74 65 72 20 69 73 20 63 6f 6e 76 65 72 74 65 tter is converte
19770 64 0a 2a 2a 20 74 6f 20 22 2e 22 2e 0a 2a 2a 0a d.** to "."..**.
19780 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
19790 69 73 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 is for debugging
197a0 20 70 75 72 70 6f 73 65 73 20 6f 6e 6c 79 20 61 purposes only a
197b0 6e 64 20 64 6f 65 73 20 6e 6f 74 20 61 70 70 65 nd does not appe
197c0 61 72 0a 2a 2a 20 69 6e 20 61 20 70 72 6f 64 75 ar.** in a produ
197d0 63 74 69 6f 6e 20 62 75 69 6c 64 2e 0a 2a 2f 0a ction build..*/.
197e0 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 static const cha
197f0 72 20 2a 75 6e 69 78 53 68 6d 4c 6f 63 6b 53 74 r *unixShmLockSt
19800 72 69 6e 67 28 75 31 36 20 6d 61 73 6b 53 68 61 ring(u16 maskSha
19810 72 65 64 2c 20 75 31 36 20 6d 61 73 6b 45 78 63 red, u16 maskExc
19820 6c 75 73 69 76 65 29 7b 0a 20 20 73 74 61 74 69 lusive){. stati
19830 63 20 63 68 61 72 20 7a 42 75 66 5b 35 32 5d 3b c char zBuf[52];
19840 0a 20 20 73 74 61 74 69 63 20 69 6e 74 20 69 42 . static int iB
19850 75 66 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 3b uf = 0;. int i;
19860 0a 20 20 75 31 36 20 6d 61 73 6b 3b 0a 20 20 63 . u16 mask;. c
19870 68 61 72 20 2a 7a 3b 0a 0a 20 20 7a 20 3d 20 26 har *z;.. z = &
19880 7a 42 75 66 5b 69 42 75 66 5d 3b 0a 20 20 69 42 zBuf[iBuf];. iB
19890 75 66 20 2b 3d 20 31 36 3b 0a 20 20 69 66 28 20 uf += 16;. if(
198a0 69 42 75 66 3e 3d 73 69 7a 65 6f 66 28 7a 42 75 iBuf>=sizeof(zBu
198b0 66 29 20 29 20 69 42 75 66 20 3d 20 30 3b 0a 20 f) ) iBuf = 0;.
198c0 20 66 6f 72 28 69 3d 30 2c 20 6d 61 73 6b 3d 31 for(i=0, mask=1
198d0 3b 20 69 3c 53 51 4c 49 54 45 5f 53 48 4d 5f 4e ; i<SQLITE_SHM_N
198e0 4c 4f 43 4b 3b 20 69 2b 2b 2c 20 6d 61 73 6b 20 LOCK; i++, mask
198f0 2b 3d 20 6d 61 73 6b 29 7b 0a 20 20 20 20 69 66 += mask){. if
19900 28 20 6d 61 73 6b 20 26 20 6d 61 73 6b 53 68 61 ( mask & maskSha
19910 72 65 64 20 29 7b 0a 20 20 20 20 20 20 7a 5b 69 red ){. z[i
19920 5d 20 3d 20 27 73 27 3b 0a 20 20 20 20 7d 65 6c ] = 's';. }el
19930 73 65 20 69 66 28 20 6d 61 73 6b 20 26 20 6d 61 se if( mask & ma
19940 73 6b 45 78 63 6c 75 73 69 76 65 20 29 7b 0a 20 skExclusive ){.
19950 20 20 20 20 20 7a 5b 69 5d 20 3d 20 27 45 27 3b z[i] = 'E';
19960 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
19970 20 20 7a 5b 69 5d 20 3d 20 27 2e 27 3b 0a 20 20 z[i] = '.';.
19980 20 20 7d 0a 20 20 7d 0a 20 20 7a 5b 69 5d 20 3d }. }. z[i] =
19990 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 7a 3b 0a 0;. return z;.
199a0 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 }.#endif /* SQLI
199b0 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a TE_DEBUG */../*.
199c0 2a 2a 20 41 70 70 6c 79 20 70 6f 73 69 78 20 61 ** Apply posix a
199d0 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 20 66 6f dvisory locks fo
199e0 72 20 61 6c 6c 20 62 79 74 65 73 20 66 72 6f 6d r all bytes from
199f0 20 6f 66 73 74 20 74 68 72 6f 75 67 68 20 6f 66 ofst through of
19a00 73 74 2b 6e 2d 31 2e 0a 2a 2a 0a 2a 2a 20 4c 6f st+n-1..**.** Lo
19a10 63 6b 73 20 62 6c 6f 63 6b 20 69 66 20 74 68 65 cks block if the
19a20 20 6d 61 73 6b 20 69 73 20 65 78 61 63 74 6c 79 mask is exactly
19a30 20 55 4e 49 58 5f 53 48 4d 5f 43 20 61 6e 64 20 UNIX_SHM_C and
19a40 61 72 65 20 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 are non-blocking
19a50 0a 2a 2a 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a .** otherwise..*
19a60 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 /.static int uni
19a70 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 0a xShmSystemLock(.
19a80 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70 unixShmNode *p
19a90 53 68 6d 4e 6f 64 65 2c 20 2f 2a 20 41 70 70 6c ShmNode, /* Appl
19aa0 79 20 6c 6f 63 6b 73 20 74 6f 20 74 68 69 73 20 y locks to this
19ab0 6f 70 65 6e 20 73 68 61 72 65 64 2d 6d 65 6d 6f open shared-memo
19ac0 72 79 20 73 65 67 6d 65 6e 74 20 2a 2f 0a 20 20 ry segment */.
19ad0 69 6e 74 20 6c 6f 63 6b 54 79 70 65 2c 20 20 20 int lockType,
19ae0 20 20 20 20 20 20 20 2f 2a 20 46 5f 55 4e 4c 43 /* F_UNLC
19af0 4b 2c 20 46 5f 52 44 4c 43 4b 2c 20 6f 72 20 46 K, F_RDLCK, or F
19b00 5f 57 52 4c 43 4b 20 2a 2f 0a 20 20 69 6e 74 20 _WRLCK */. int
19b10 6f 66 73 74 2c 20 20 20 20 20 20 20 20 20 20 20 ofst,
19b20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 /* First byte
19b30 20 6f 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 of the locking
19b40 72 61 6e 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e range */. int n
19b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19b60 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 /* Number of b
19b70 79 74 65 73 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a ytes to lock */.
19b80 29 7b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 ){. struct floc
19b90 6b 20 66 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 k f; /* Th
19ba0 65 20 70 6f 73 69 78 20 61 64 76 69 73 6f 72 79 e posix advisory
19bb0 20 6c 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75 locking structu
19bc0 72 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d re */. int rc =
19bd0 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 2f 2a SQLITE_OK; /*
19be0 20 52 65 73 75 6c 74 20 63 6f 64 65 20 66 6f 72 Result code for
19bf0 6d 20 66 63 6e 74 6c 28 29 20 2a 2f 0a 0a 20 20 m fcntl() */..
19c00 2f 2a 20 41 63 63 65 73 73 20 74 6f 20 74 68 65 /* Access to the
19c10 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a unixShmNode obj
19c20 65 63 74 20 69 73 20 73 65 72 69 61 6c 69 7a 65 ect is serialize
19c30 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 20 d by the caller
19c40 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c */. assert( sql
19c50 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
19c60 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 29 pShmNode->mutex)
19c70 20 7c 7c 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 || pShmNode->nR
19c80 65 66 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 53 ef==0 );.. /* S
19c90 68 61 72 65 64 20 6c 6f 63 6b 73 20 6e 65 76 65 hared locks neve
19ca0 72 20 73 70 61 6e 20 6d 6f 72 65 20 74 68 61 6e r span more than
19cb0 20 6f 6e 65 20 62 79 74 65 20 2a 2f 0a 20 20 61 one byte */. a
19cc0 73 73 65 72 74 28 20 6e 3d 3d 31 20 7c 7c 20 6c ssert( n==1 || l
19cd0 6f 63 6b 54 79 70 65 21 3d 46 5f 52 44 4c 43 4b ockType!=F_RDLCK
19ce0 20 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 63 6b 73 20 );.. /* Locks
19cf0 61 72 65 20 77 69 74 68 69 6e 20 72 61 6e 67 65 are within range
19d00 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 6e 3e */. assert( n>
19d10 3d 31 20 26 26 20 6e 3c 53 51 4c 49 54 45 5f 53 =1 && n<SQLITE_S
19d20 48 4d 5f 4e 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f HM_NLOCK );.. /
19d30 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 * Initialize the
19d40 20 6c 6f 63 6b 69 6e 67 20 70 61 72 61 6d 65 74 locking paramet
19d50 65 72 73 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 ers */. memset(
19d60 26 66 2c 20 30 2c 20 73 69 7a 65 6f 66 28 66 29 &f, 0, sizeof(f)
19d70 29 3b 0a 20 20 66 2e 6c 5f 74 79 70 65 20 3d 20 );. f.l_type =
19d80 6c 6f 63 6b 54 79 70 65 3b 0a 20 20 66 2e 6c 5f lockType;. f.l_
19d90 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 whence = SEEK_SE
19da0 54 3b 0a 20 20 66 2e 6c 5f 73 74 61 72 74 20 3d T;. f.l_start =
19db0 20 6f 66 73 74 3b 0a 20 20 66 2e 6c 5f 6c 65 6e ofst;. f.l_len
19dc0 20 3d 20 6e 3b 0a 0a 20 20 72 63 20 3d 20 66 63 = n;.. rc = fc
19dd0 6e 74 6c 28 70 53 68 6d 4e 6f 64 65 2d 3e 68 2c ntl(pShmNode->h,
19de0 20 46 5f 53 45 54 4c 4b 2c 20 26 66 29 3b 0a 20 F_SETLK, &f);.
19df0 20 72 63 20 3d 20 28 72 63 21 3d 28 2d 31 29 29 rc = (rc!=(-1))
19e00 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 ? SQLITE_OK : S
19e10 51 4c 49 54 45 5f 42 55 53 59 3b 0a 0a 20 20 2f QLITE_BUSY;.. /
19e20 2a 20 55 70 64 61 74 65 20 74 68 65 20 67 6c 6f * Update the glo
19e30 62 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 20 61 bal lock state a
19e40 6e 64 20 64 6f 20 64 65 62 75 67 20 74 72 61 63 nd do debug trac
19e50 69 6e 67 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 ing */.#ifdef SQ
19e60 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 7b 20 75 LITE_DEBUG. { u
19e70 31 36 20 6d 61 73 6b 3b 0a 20 20 4f 53 54 52 41 16 mask;. OSTRA
19e80 43 45 28 28 22 53 48 4d 2d 4c 4f 43 4b 20 22 29 CE(("SHM-LOCK ")
19e90 29 3b 0a 20 20 6d 61 73 6b 20 3d 20 28 31 3c 3c );. mask = (1<<
19ea0 28 6f 66 73 74 2b 6e 29 29 20 2d 20 28 31 3c 3c (ofst+n)) - (1<<
19eb0 6f 66 73 74 29 3b 0a 20 20 69 66 28 20 72 63 3d ofst);. if( rc=
19ec0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
19ed0 20 20 69 66 28 20 6c 6f 63 6b 54 79 70 65 3d 3d if( lockType==
19ee0 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20 20 F_UNLCK ){.
19ef0 20 4f 53 54 52 41 43 45 28 28 22 75 6e 6c 6f 63 OSTRACE(("unloc
19f00 6b 20 25 64 20 6f 6b 22 2c 20 6f 66 73 74 29 29 k %d ok", ofst))
19f10 3b 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 ;. pShmNode
19f20 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 3d 20 7e 6d ->exclMask &= ~m
19f30 61 73 6b 3b 0a 20 20 20 20 20 20 70 53 68 6d 4e ask;. pShmN
19f40 6f 64 65 2d 3e 73 68 61 72 65 64 4d 61 73 6b 20 ode->sharedMask
19f50 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 20 20 7d 65 &= ~mask;. }e
19f60 6c 73 65 20 69 66 28 20 6c 6f 63 6b 54 79 70 65 lse if( lockType
19f70 3d 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a 20 20 20 ==F_RDLCK ){.
19f80 20 20 20 4f 53 54 52 41 43 45 28 28 22 72 65 61 OSTRACE(("rea
19f90 64 2d 6c 6f 63 6b 20 25 64 20 6f 6b 22 2c 20 6f d-lock %d ok", o
19fa0 66 73 74 29 29 3b 0a 20 20 20 20 20 20 70 53 68 fst));. pSh
19fb0 6d 4e 6f 64 65 2d 3e 65 78 63 6c 4d 61 73 6b 20 mNode->exclMask
19fc0 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 20 20 20 20 &= ~mask;.
19fd0 70 53 68 6d 4e 6f 64 65 2d 3e 73 68 61 72 65 64 pShmNode->shared
19fe0 4d 61 73 6b 20 7c 3d 20 6d 61 73 6b 3b 0a 20 20 Mask |= mask;.
19ff0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 }else{. a
1a000 73 73 65 72 74 28 20 6c 6f 63 6b 54 79 70 65 3d ssert( lockType=
1a010 3d 46 5f 57 52 4c 43 4b 20 29 3b 0a 20 20 20 20 =F_WRLCK );.
1a020 20 20 4f 53 54 52 41 43 45 28 28 22 77 72 69 74 OSTRACE(("writ
1a030 65 2d 6c 6f 63 6b 20 25 64 20 6f 6b 22 2c 20 6f e-lock %d ok", o
1a040 66 73 74 29 29 3b 0a 20 20 20 20 20 20 70 53 68 fst));. pSh
1a050 6d 4e 6f 64 65 2d 3e 65 78 63 6c 4d 61 73 6b 20 mNode->exclMask
1a060 7c 3d 20 6d 61 73 6b 3b 0a 20 20 20 20 20 20 70 |= mask;. p
1a070 53 68 6d 4e 6f 64 65 2d 3e 73 68 61 72 65 64 4d ShmNode->sharedM
1a080 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 ask &= ~mask;.
1a090 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
1a0a0 20 69 66 28 20 6c 6f 63 6b 54 79 70 65 3d 3d 46 if( lockType==F
1a0b0 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20 20 20 _UNLCK ){.
1a0c0 4f 53 54 52 41 43 45 28 28 22 75 6e 6c 6f 63 6b OSTRACE(("unlock
1a0d0 20 25 64 20 66 61 69 6c 65 64 22 2c 20 6f 66 73 %d failed", ofs
1a0e0 74 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 t));. }else i
1a0f0 66 28 20 6c 6f 63 6b 54 79 70 65 3d 3d 46 5f 52 f( lockType==F_R
1a100 44 4c 43 4b 20 29 7b 0a 20 20 20 20 20 20 4f 53 DLCK ){. OS
1a110 54 52 41 43 45 28 28 22 72 65 61 64 2d 6c 6f 63 TRACE(("read-loc
1a120 6b 20 66 61 69 6c 65 64 22 29 29 3b 0a 20 20 20 k failed"));.
1a130 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 }else{. as
1a140 73 65 72 74 28 20 6c 6f 63 6b 54 79 70 65 3d 3d sert( lockType==
1a150 46 5f 57 52 4c 43 4b 20 29 3b 0a 20 20 20 20 20 F_WRLCK );.
1a160 20 4f 53 54 52 41 43 45 28 28 22 77 72 69 74 65 OSTRACE(("write
1a170 2d 6c 6f 63 6b 20 25 64 20 66 61 69 6c 65 64 22 -lock %d failed"
1a180 2c 20 6f 66 73 74 29 29 3b 0a 20 20 20 20 7d 0a , ofst));. }.
1a190 20 20 7d 0a 20 20 4f 53 54 52 41 43 45 28 28 22 }. OSTRACE(("
1a1a0 20 2d 20 61 66 74 65 72 77 61 72 64 73 20 25 73 - afterwards %s
1a1b0 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
1a1c0 75 6e 69 78 53 68 6d 4c 6f 63 6b 53 74 72 69 6e unixShmLockStrin
1a1d0 67 28 70 53 68 6d 4e 6f 64 65 2d 3e 73 68 61 72 g(pShmNode->shar
1a1e0 65 64 4d 61 73 6b 2c 20 70 53 68 6d 4e 6f 64 65 edMask, pShmNode
1a1f0 2d 3e 65 78 63 6c 4d 61 73 6b 29 29 29 3b 0a 20 ->exclMask)));.
1a200 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 }.#endif.. ret
1a210 75 72 6e 20 72 63 3b 20 20 20 20 20 20 20 20 0a urn rc; .
1a220 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 50 75 72 67 65 20 }.../*.** Purge
1a230 74 68 65 20 75 6e 69 78 53 68 6d 4e 6f 64 65 4c the unixShmNodeL
1a240 69 73 74 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 ist list of all
1a250 65 6e 74 72 69 65 73 20 77 69 74 68 20 75 6e 69 entries with uni
1a260 78 53 68 6d 4e 6f 64 65 2e 6e 52 65 66 3d 3d 30 xShmNode.nRef==0
1a270 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 ..**.** This is
1a280 6e 6f 74 20 61 20 56 46 53 20 73 68 61 72 65 64 not a VFS shared
1a290 2d 6d 65 6d 6f 72 79 20 6d 65 74 68 6f 64 3b 20 -memory method;
1a2a0 69 74 20 69 73 20 61 20 75 74 69 6c 69 74 79 20 it is a utility
1a2b0 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 64 0a function called.
1a2c0 2a 2a 20 62 79 20 56 46 53 20 73 68 61 72 65 64 ** by VFS shared
1a2d0 2d 6d 65 6d 6f 72 79 20 6d 65 74 68 6f 64 73 2e -memory methods.
1a2e0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
1a2f0 75 6e 69 78 53 68 6d 50 75 72 67 65 28 75 6e 69 unixShmPurge(uni
1a300 78 46 69 6c 65 20 2a 70 46 64 29 7b 0a 20 20 75 xFile *pFd){. u
1a310 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70 20 3d 20 nixShmNode *p =
1a320 70 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 pFd->pInode->pSh
1a330 6d 4e 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 28 mNode;. assert(
1a340 20 75 6e 69 78 4d 75 74 65 78 48 65 6c 64 28 29 unixMutexHeld()
1a350 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 70 );. if( p && p
1a360 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 ->nRef==0 ){.
1a370 20 61 73 73 65 72 74 28 20 70 2d 3e 70 49 6e 6f assert( p->pIno
1a380 64 65 3d 3d 70 46 64 2d 3e 70 49 6e 6f 64 65 20 de==pFd->pInode
1a390 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6d 75 );. if( p->mu
1a3a0 74 65 78 20 29 20 73 71 6c 69 74 65 33 5f 6d 75 tex ) sqlite3_mu
1a3b0 74 65 78 5f 66 72 65 65 28 70 2d 3e 6d 75 74 65 tex_free(p->mute
1a3c0 78 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6d x);. if( p->m
1a3d0 75 74 65 78 42 75 66 20 29 20 73 71 6c 69 74 65 utexBuf ) sqlite
1a3e0 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 70 2d 3e 3_mutex_free(p->
1a3f0 6d 75 74 65 78 42 75 66 29 3b 0a 20 20 20 20 69 mutexBuf);. i
1a400 66 28 20 70 2d 3e 68 3e 3d 30 20 29 20 63 6c 6f f( p->h>=0 ) clo
1a410 73 65 28 70 2d 3e 68 29 3b 0a 20 20 20 20 70 2d se(p->h);. p-
1a420 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 >pInode->pShmNod
1a430 65 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 e = 0;. sqlit
1a440 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a e3_free(p);. }.
1a450 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 }../*.** Open a
1a460 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 61 72 shared-memory ar
1a470 65 61 2e 20 20 54 68 69 73 20 70 61 72 74 69 63 ea. This partic
1a480 75 6c 61 72 20 69 6d 70 6c 65 6d 65 6e 74 61 74 ular implementat
1a490 69 6f 6e 20 75 73 65 73 0a 2a 2a 20 6d 6d 61 70 ion uses.** mmap
1a4a0 70 65 64 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a ped files..**.**
1a4b0 20 7a 4e 61 6d 65 20 69 73 20 61 20 66 69 6c 65 zName is a file
1a4c0 6e 61 6d 65 20 75 73 65 64 20 74 6f 20 69 64 65 name used to ide
1a4d0 6e 74 69 66 79 20 74 68 65 20 73 68 61 72 65 64 ntify the shared
1a4e0 2d 6d 65 6d 6f 72 79 20 61 72 65 61 2e 20 20 54 -memory area. T
1a4f0 68 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 he.** implementa
1a500 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 28 61 tion does not (a
1a510 6e 64 20 70 65 72 68 61 70 73 20 73 68 6f 75 6c nd perhaps shoul
1a520 64 20 6e 6f 74 29 20 75 73 65 20 74 68 69 73 20 d not) use this
1a530 6e 61 6d 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79 name.** directly
1a540 2c 20 62 75 74 20 72 61 74 68 65 72 20 75 73 65 , but rather use
1a550 20 69 74 20 61 73 20 61 20 74 65 6d 70 6c 61 74 it as a templat
1a560 65 20 66 6f 72 20 66 69 6e 64 69 6e 67 20 61 6e e for finding an
1a570 20 61 70 70 72 6f 70 72 69 61 74 65 0a 2a 2a 20 appropriate.**
1a580 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 73 68 61 name for the sha
1a590 72 65 64 2d 6d 65 6d 6f 72 79 20 73 74 6f 72 61 red-memory stora
1a5a0 67 65 2e 20 20 49 6e 20 74 68 69 73 20 69 6d 70 ge. In this imp
1a5b0 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 74 68 65 lementation, the
1a5c0 0a 2a 2a 20 73 74 72 69 6e 67 20 22 2d 69 6e 64 .** string "-ind
1a5d0 65 78 22 20 69 73 20 61 70 70 65 6e 64 65 64 20 ex" is appended
1a5e0 74 6f 20 7a 4e 61 6d 65 20 61 6e 64 20 75 73 65 to zName and use
1a5f0 64 20 61 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 d as the name of
1a600 20 74 68 65 0a 2a 2a 20 6d 6d 61 70 70 65 64 20 the.** mmapped
1a610 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e file..**.** When
1a620 20 6f 70 65 6e 69 6e 67 20 61 20 6e 65 77 20 73 opening a new s
1a630 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 66 69 6c hared-memory fil
1a640 65 2c 20 69 66 20 6e 6f 20 6f 74 68 65 72 20 69 e, if no other i
1a650 6e 73 74 61 6e 63 65 73 20 6f 66 20 74 68 61 74 nstances of that
1a660 0a 2a 2a 20 66 69 6c 65 20 61 72 65 20 63 75 72 .** file are cur
1a670 72 65 6e 74 6c 79 20 6f 70 65 6e 2c 20 69 6e 20 rently open, in
1a680 74 68 69 73 20 70 72 6f 63 65 73 73 20 6f 72 20 this process or
1a690 69 6e 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 in other process
1a6a0 65 73 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 es, then.** the
1a6b0 66 69 6c 65 20 6d 75 73 74 20 62 65 20 74 72 75 file must be tru
1a6c0 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 6c ncated to zero l
1a6d0 65 6e 67 74 68 20 6f 72 20 68 61 76 65 20 69 74 ength or have it
1a6e0 73 20 68 65 61 64 65 72 20 63 6c 65 61 72 65 64 s header cleared
1a6f0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1a700 75 6e 69 78 53 68 6d 4f 70 65 6e 28 0a 20 20 73 unixShmOpen(. s
1a710 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 20 qlite3_file *fd
1a720 20 20 20 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 /* The file
1a730 20 64 65 73 63 72 69 70 74 6f 72 20 6f 66 20 74 descriptor of t
1a740 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 64 61 he associated da
1a750 74 61 62 61 73 65 20 2a 2f 0a 29 7b 0a 20 20 73 tabase */.){. s
1a760 74 72 75 63 74 20 75 6e 69 78 53 68 6d 20 2a 70 truct unixShm *p
1a770 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
1a780 20 20 2f 2a 20 54 68 65 20 63 6f 6e 6e 65 63 74 /* The connect
1a790 69 6f 6e 20 74 6f 20 62 65 20 6f 70 65 6e 65 64 ion to be opened
1a7a0 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 75 6e 69 */. struct uni
1a7b0 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f xShmNode *pShmNo
1a7c0 64 65 20 3d 20 30 3b 20 20 2f 2a 20 54 68 65 20 de = 0; /* The
1a7d0 75 6e 64 65 72 6c 79 69 6e 67 20 6d 6d 61 70 70 underlying mmapp
1a7e0 65 64 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 ed file */. int
1a7f0 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
1a800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a810 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a /* Result code *
1a820 2f 0a 20 20 73 74 72 75 63 74 20 75 6e 69 78 46 /. struct unixF
1a830 69 6c 65 20 2a 70 44 62 46 64 3b 20 20 20 20 20 ile *pDbFd;
1a840 20 20 20 20 20 20 20 2f 2a 20 55 6e 64 65 72 6c /* Underl
1a850 79 69 6e 67 20 64 61 74 61 62 61 73 65 20 66 69 ying database fi
1a860 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 74 le */. int nPat
1a870 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
1a880 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
1a890 7a 65 20 6f 66 20 70 44 62 46 64 2d 3e 7a 50 61 ze of pDbFd->zPa
1a8a0 74 68 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 0a th in bytes */..
1a8b0 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 73 70 /* Allocate sp
1a8c0 61 63 65 20 66 6f 72 20 74 68 65 20 6e 65 77 20 ace for the new
1a8d0 73 71 6c 69 74 65 33 5f 73 68 6d 20 6f 62 6a 65 sqlite3_shm obje
1a8e0 63 74 2e 0a 20 20 2a 2f 0a 20 20 70 20 3d 20 73 ct.. */. p = s
1a8f0 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 qlite3_malloc( s
1a900 69 7a 65 6f 66 28 2a 70 29 20 29 3b 0a 20 20 69 izeof(*p) );. i
1a910 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e f( p==0 ) return
1a920 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
1a930 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 73 69 memset(p, 0, si
1a940 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20 70 44 62 zeof(*p));. pDb
1a950 46 64 20 3d 20 28 73 74 72 75 63 74 20 75 6e 69 Fd = (struct uni
1a960 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20 61 73 73 xFile*)fd;. ass
1a970 65 72 74 28 20 70 44 62 46 64 2d 3e 70 53 68 6d ert( pDbFd->pShm
1a980 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 ==0 );.. /* Che
1a990 63 6b 20 74 6f 20 73 65 65 20 69 66 20 61 20 75 ck to see if a u
1a9a0 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 nixShmNode objec
1a9b0 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 t already exists
1a9c0 2e 20 20 52 65 75 73 65 20 61 6e 20 65 78 69 73 . Reuse an exis
1a9d0 74 69 6e 67 0a 20 20 2a 2a 20 6f 6e 65 20 69 66 ting. ** one if
1a9e0 20 70 72 65 73 65 6e 74 2e 20 20 43 72 65 61 74 present. Creat
1a9f0 65 20 61 20 6e 65 77 20 6f 6e 65 20 69 66 20 6e e a new one if n
1aa00 65 63 65 73 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 ecessary.. */.
1aa10 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 unixEnterMutex(
1aa20 29 3b 0a 20 20 70 53 68 6d 4e 6f 64 65 20 3d 20 );. pShmNode =
1aa30 70 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 pDbFd->pInode->p
1aa40 53 68 6d 4e 6f 64 65 3b 0a 20 20 69 66 28 20 70 ShmNode;. if( p
1aa50 53 68 6d 4e 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 ShmNode==0 ){.
1aa60 20 20 6e 50 61 74 68 20 3d 20 73 74 72 6c 65 6e nPath = strlen
1aa70 28 70 44 62 46 64 2d 3e 7a 50 61 74 68 29 3b 0a (pDbFd->zPath);.
1aa80 20 20 20 20 70 53 68 6d 4e 6f 64 65 20 3d 20 73 pShmNode = s
1aa90 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 qlite3_malloc( s
1aaa0 69 7a 65 6f 66 28 2a 70 53 68 6d 4e 6f 64 65 29 izeof(*pShmNode)
1aab0 20 2b 20 6e 50 61 74 68 20 2b 20 31 35 20 29 3b + nPath + 15 );
1aac0 0a 20 20 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 . if( pShmNod
1aad0 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 e==0 ){. rc
1aae0 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b = SQLITE_NOMEM;
1aaf0 0a 20 20 20 20 20 20 67 6f 74 6f 20 73 68 6d 5f . goto shm_
1ab00 6f 70 65 6e 5f 65 72 72 3b 0a 20 20 20 20 7d 0a open_err;. }.
1ab10 20 20 20 20 6d 65 6d 73 65 74 28 70 53 68 6d 4e memset(pShmN
1ab20 6f 64 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a ode, 0, sizeof(*
1ab30 70 53 68 6d 4e 6f 64 65 29 29 3b 0a 20 20 20 20 pShmNode));.
1ab40 70 53 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e pShmNode->zFilen
1ab50 61 6d 65 20 3d 20 28 63 68 61 72 2a 29 26 70 53 ame = (char*)&pS
1ab60 68 6d 4e 6f 64 65 5b 31 5d 3b 0a 20 20 20 20 73 hmNode[1];. s
1ab70 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 qlite3_snprintf(
1ab80 6e 50 61 74 68 2b 31 35 2c 20 70 53 68 6d 4e 6f nPath+15, pShmNo
1ab90 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 de->zFilename,.
1aba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1abb0 20 20 20 20 22 25 73 2d 77 61 6c 2d 69 6e 64 65 "%s-wal-inde
1abc0 78 22 2c 20 70 44 62 46 64 2d 3e 7a 50 61 74 68 x", pDbFd->zPath
1abd0 29 3b 0a 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d );. pShmNode-
1abe0 3e 68 20 3d 20 2d 31 3b 0a 20 20 20 20 70 44 62 >h = -1;. pDb
1abf0 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 6d Fd->pInode->pShm
1ac00 4e 6f 64 65 20 3d 20 70 53 68 6d 4e 6f 64 65 3b Node = pShmNode;
1ac10 0a 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 . pShmNode->p
1ac20 49 6e 6f 64 65 20 3d 20 70 44 62 46 64 2d 3e 70 Inode = pDbFd->p
1ac30 49 6e 6f 64 65 3b 0a 20 20 20 20 70 53 68 6d 4e Inode;. pShmN
1ac40 6f 64 65 2d 3e 6d 75 74 65 78 20 3d 20 73 71 6c ode->mutex = sql
1ac50 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 ite3_mutex_alloc
1ac60 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46 41 (SQLITE_MUTEX_FA
1ac70 53 54 29 3b 0a 20 20 20 20 69 66 28 20 70 53 68 ST);. if( pSh
1ac80 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 3d 3d 30 20 mNode->mutex==0
1ac90 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
1aca0 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
1acb0 20 20 67 6f 74 6f 20 73 68 6d 5f 6f 70 65 6e 5f goto shm_open_
1acc0 65 72 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 err;. }. p
1acd0 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 42 75 ShmNode->mutexBu
1ace0 66 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 f = sqlite3_mute
1acf0 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d x_alloc(SQLITE_M
1ad00 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 UTEX_FAST);.
1ad10 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 if( pShmNode->mu
1ad20 74 65 78 42 75 66 3d 3d 30 20 29 7b 0a 20 20 20 texBuf==0 ){.
1ad30 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
1ad40 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 67 6f 74 6f OMEM;. goto
1ad50 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a 20 shm_open_err;.
1ad60 20 20 20 7d 0a 0a 20 20 20 20 70 53 68 6d 4e 6f }.. pShmNo
1ad70 64 65 2d 3e 68 20 3d 20 6f 70 65 6e 28 70 53 68 de->h = open(pSh
1ad80 6d 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 mNode->zFilename
1ad90 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54 , O_RDWR|O_CREAT
1ada0 2c 20 30 36 36 34 29 3b 0a 20 20 20 20 69 66 28 , 0664);. if(
1adb0 20 70 53 68 6d 4e 6f 64 65 2d 3e 68 3c 30 20 29 pShmNode->h<0 )
1adc0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
1add0 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 ITE_CANTOPEN_BKP
1ade0 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 73 68 T;. goto sh
1adf0 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a 20 20 20 20 m_open_err;.
1ae00 7d 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 }.. /* Check
1ae10 74 6f 20 73 65 65 20 69 66 20 61 6e 6f 74 68 65 to see if anothe
1ae20 72 20 70 72 6f 63 65 73 73 20 69 73 20 68 6f 6c r process is hol
1ae30 64 69 6e 67 20 74 68 65 20 64 65 61 64 2d 6d 61 ding the dead-ma
1ae40 6e 20 73 77 69 74 63 68 2e 0a 20 20 20 20 2a 2a n switch.. **
1ae50 20 49 66 20 6e 6f 74 2c 20 74 72 75 6e 63 61 74 If not, truncat
1ae60 65 20 74 68 65 20 66 69 6c 65 20 74 6f 20 7a 65 e the file to ze
1ae70 72 6f 20 6c 65 6e 67 74 68 2e 20 0a 20 20 20 20 ro length. .
1ae80 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 */. rc = SQLI
1ae90 54 45 5f 4f 4b 3b 0a 20 20 20 20 69 66 28 20 75 TE_OK;. if( u
1aea0 6e 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b nixShmSystemLock
1aeb0 28 70 53 68 6d 4e 6f 64 65 2c 20 46 5f 57 52 4c (pShmNode, F_WRL
1aec0 43 4b 2c 20 55 4e 49 58 5f 53 48 4d 5f 44 4d 53 CK, UNIX_SHM_DMS
1aed0 2c 20 31 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 , 1)==SQLITE_OK
1aee0 29 7b 0a 20 20 20 20 20 20 69 66 28 20 66 74 72 ){. if( ftr
1aef0 75 6e 63 61 74 65 28 70 53 68 6d 4e 6f 64 65 2d uncate(pShmNode-
1af00 3e 68 2c 20 30 29 20 29 7b 0a 20 20 20 20 20 20 >h, 0) ){.
1af10 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f rc = SQLITE_IO
1af20 45 52 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ERR;. }.
1af30 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 }. if( rc==S
1af40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1af50 20 20 72 63 20 3d 20 75 6e 69 78 53 68 6d 53 79 rc = unixShmSy
1af60 73 74 65 6d 4c 6f 63 6b 28 70 53 68 6d 4e 6f 64 stemLock(pShmNod
1af70 65 2c 20 46 5f 52 44 4c 43 4b 2c 20 55 4e 49 58 e, F_RDLCK, UNIX
1af80 5f 53 48 4d 5f 44 4d 53 2c 20 31 29 3b 0a 20 20 _SHM_DMS, 1);.
1af90 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 }. if( rc )
1afa0 20 67 6f 74 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 goto shm_open_e
1afb0 72 72 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 rr;. }.. /* Ma
1afc0 6b 65 20 74 68 65 20 6e 65 77 20 63 6f 6e 6e 65 ke the new conne
1afd0 63 74 69 6f 6e 20 61 20 63 68 69 6c 64 20 6f 66 ction a child of
1afe0 20 74 68 65 20 75 6e 69 78 53 68 6d 4e 6f 64 65 the unixShmNode
1aff0 20 2a 2f 0a 20 20 70 2d 3e 70 53 68 6d 4e 6f 64 */. p->pShmNod
1b000 65 20 3d 20 70 53 68 6d 4e 6f 64 65 3b 0a 20 20 e = pShmNode;.
1b010 70 2d 3e 70 4e 65 78 74 20 3d 20 70 53 68 6d 4e p->pNext = pShmN
1b020 6f 64 65 2d 3e 70 46 69 72 73 74 3b 0a 23 69 66 ode->pFirst;.#if
1b030 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
1b040 0a 20 20 70 2d 3e 69 64 20 3d 20 70 53 68 6d 4e . p->id = pShmN
1b050 6f 64 65 2d 3e 6e 65 78 74 53 68 6d 49 64 2b 2b ode->nextShmId++
1b060 3b 0a 23 65 6e 64 69 66 0a 20 20 70 53 68 6d 4e ;.#endif. pShmN
1b070 6f 64 65 2d 3e 70 46 69 72 73 74 20 3d 20 70 3b ode->pFirst = p;
1b080 0a 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 . pShmNode->nRe
1b090 66 2b 2b 3b 0a 20 20 70 44 62 46 64 2d 3e 70 53 f++;. pDbFd->pS
1b0a0 68 6d 20 3d 20 70 3b 0a 20 20 75 6e 69 78 4c 65 hm = p;. unixLe
1b0b0 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 72 65 aveMutex();. re
1b0c0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
1b0d0 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20 . /* Jump here
1b0e0 6f 6e 20 61 6e 79 20 65 72 72 6f 72 20 2a 2f 0a on any error */.
1b0f0 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3a 0a 20 20 shm_open_err:.
1b100 75 6e 69 78 53 68 6d 50 75 72 67 65 28 70 44 62 unixShmPurge(pDb
1b110 46 64 29 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 Fd); /* Th
1b120 69 73 20 63 61 6c 6c 20 66 72 65 65 73 20 70 53 is call frees pS
1b130 68 6d 4e 6f 64 65 20 69 66 20 72 65 71 75 69 72 hmNode if requir
1b140 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ed */. sqlite3_
1b150 66 72 65 65 28 70 29 3b 0a 20 20 75 6e 69 78 4c free(p);. unixL
1b160 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 72 eaveMutex();. r
1b170 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
1b180 2a 2a 20 43 6c 6f 73 65 20 61 20 63 6f 6e 6e 65 ** Close a conne
1b190 63 74 69 6f 6e 20 74 6f 20 73 68 61 72 65 64 2d ction to shared-
1b1a0 6d 65 6d 6f 72 79 2e 20 20 44 65 6c 65 74 65 20 memory. Delete
1b1b0 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 0a the underlying .
1b1c0 2a 2a 20 73 74 6f 72 61 67 65 20 69 66 20 64 65 ** storage if de
1b1d0 6c 65 74 65 46 6c 61 67 20 69 73 20 74 72 75 65 leteFlag is true
1b1e0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1b1f0 75 6e 69 78 53 68 6d 43 6c 6f 73 65 28 0a 20 20 unixShmClose(.
1b200 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
1b210 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 , /* Th
1b220 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 e underlying dat
1b230 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
1b240 69 6e 74 20 64 65 6c 65 74 65 46 6c 61 67 20 20 int deleteFlag
1b250 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 /* De
1b260 6c 65 74 65 20 73 68 61 72 65 64 2d 6d 65 6d 6f lete shared-memo
1b270 72 79 20 69 66 20 74 72 75 65 20 2a 2f 0a 29 7b ry if true */.){
1b280 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 3b 20 20 . unixShm *p;
1b290 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
1b2a0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 62 connection to b
1b2b0 65 20 63 6c 6f 73 65 64 20 2a 2f 0a 20 20 75 6e e closed */. un
1b2c0 69 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e ixShmNode *pShmN
1b2d0 6f 64 65 3b 20 2f 2a 20 54 68 65 20 75 6e 64 65 ode; /* The unde
1b2e0 72 6c 79 69 6e 67 20 73 68 61 72 65 64 2d 6d 65 rlying shared-me
1b2f0 6d 6f 72 79 20 66 69 6c 65 20 2a 2f 0a 20 20 75 mory file */. u
1b300 6e 69 78 53 68 6d 20 2a 2a 70 70 3b 20 20 20 20 nixShm **pp;
1b310 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 6c 6f 6f /* For loo
1b320 70 69 6e 67 20 6f 76 65 72 20 73 69 62 6c 69 6e ping over siblin
1b330 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f g connections */
1b340 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 44 62 . unixFile *pDb
1b350 46 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 Fd; /* The
1b360 20 75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 underlying data
1b370 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 base file */..
1b380 70 44 62 46 64 20 3d 20 28 75 6e 69 78 46 69 6c pDbFd = (unixFil
1b390 65 2a 29 66 64 3b 0a 20 20 70 20 3d 20 70 44 62 e*)fd;. p = pDb
1b3a0 46 64 2d 3e 70 53 68 6d 3b 0a 20 20 69 66 28 20 Fd->pShm;. if(
1b3b0 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 p==0 ) return SQ
1b3c0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 53 68 6d 4e LITE_OK;. pShmN
1b3d0 6f 64 65 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f 64 ode = p->pShmNod
1b3e0 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 53 e;.. assert( pS
1b3f0 68 6d 4e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 hmNode==pDbFd->p
1b400 49 6e 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 20 Inode->pShmNode
1b410 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 53 68 );. assert( pSh
1b420 6d 4e 6f 64 65 2d 3e 70 49 6e 6f 64 65 3d 3d 70 mNode->pInode==p
1b430 44 62 46 64 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a DbFd->pInode );.
1b440 0a 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 61 . /* Verify tha
1b450 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e t the connection
1b460 20 62 65 69 6e 67 20 63 6c 6f 73 65 64 20 68 6f being closed ho
1b470 6c 64 73 20 6e 6f 20 6c 6f 63 6b 73 20 2a 2f 0a lds no locks */.
1b480 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 78 63 assert( p->exc
1b490 6c 4d 61 73 6b 3d 3d 30 20 29 3b 0a 20 20 61 73 lMask==0 );. as
1b4a0 73 65 72 74 28 20 70 2d 3e 73 68 61 72 65 64 4d sert( p->sharedM
1b4b0 61 73 6b 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 ask==0 );.. /*
1b4c0 52 65 6d 6f 76 65 20 63 6f 6e 6e 65 63 74 69 6f Remove connectio
1b4d0 6e 20 70 20 66 72 6f 6d 20 74 68 65 20 73 65 74 n p from the set
1b4e0 20 6f 66 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 of connections
1b4f0 61 73 73 6f 63 69 61 74 65 64 0a 20 20 2a 2a 20 associated. **
1b500 77 69 74 68 20 70 53 68 6d 4e 6f 64 65 20 2a 2f with pShmNode */
1b510 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1b520 5f 65 6e 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d _enter(pShmNode-
1b530 3e 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 70 >mutex);. for(p
1b540 70 3d 26 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 p=&pShmNode->pFi
1b550 72 73 74 3b 20 28 2a 70 70 29 21 3d 70 3b 20 70 rst; (*pp)!=p; p
1b560 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 p = &(*pp)->pNex
1b570 74 29 7b 7d 0a 20 20 2a 70 70 20 3d 20 70 2d 3e t){}. *pp = p->
1b580 70 4e 65 78 74 3b 0a 0a 20 20 2f 2a 20 46 72 65 pNext;.. /* Fre
1b590 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e e the connection
1b5a0 20 70 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f p */. sqlite3_
1b5b0 66 72 65 65 28 70 29 3b 0a 20 20 70 44 62 46 64 free(p);. pDbFd
1b5c0 2d 3e 70 53 68 6d 20 3d 20 30 3b 0a 20 20 73 71 ->pShm = 0;. sq
1b5d0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
1b5e0 65 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 e(pShmNode->mute
1b5f0 78 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 53 68 x);.. /* If pSh
1b600 6d 4e 6f 64 65 2d 3e 6e 52 65 66 20 68 61 73 20 mNode->nRef has
1b610 72 65 61 63 68 65 64 20 30 2c 20 74 68 65 6e 20 reached 0, then
1b620 63 6c 6f 73 65 20 74 68 65 20 75 6e 64 65 72 6c close the underl
1b630 79 69 6e 67 0a 20 20 2a 2a 20 73 68 61 72 65 64 ying. ** shared
1b640 2d 6d 65 6d 6f 72 79 20 66 69 6c 65 2c 20 74 6f -memory file, to
1b650 6f 20 2a 2f 0a 20 20 75 6e 69 78 45 6e 74 65 72 o */. unixEnter
1b660 4d 75 74 65 78 28 29 3b 0a 20 20 61 73 73 65 72 Mutex();. asser
1b670 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 t( pShmNode->nRe
1b680 66 3e 30 20 29 3b 0a 20 20 70 53 68 6d 4e 6f 64 f>0 );. pShmNod
1b690 65 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 e->nRef--;. if(
1b6a0 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 3d pShmNode->nRef=
1b6b0 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 64 65 =0 ){. if( de
1b6c0 6c 65 74 65 46 6c 61 67 20 29 20 75 6e 6c 69 6e leteFlag ) unlin
1b6d0 6b 28 70 53 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c k(pShmNode->zFil
1b6e0 65 6e 61 6d 65 29 3b 0a 20 20 20 20 75 6e 69 78 ename);. unix
1b6f0 53 68 6d 50 75 72 67 65 28 70 44 62 46 64 29 3b ShmPurge(pDbFd);
1b700 0a 20 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 . }. unixLeave
1b710 4d 75 74 65 78 28 29 3b 0a 0a 20 20 72 65 74 75 Mutex();.. retu
1b720 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
1b730 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 73 20 74 ./*.** Changes t
1b740 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 75 he size of the u
1b750 6e 64 65 72 6c 79 69 6e 67 20 73 74 6f 72 61 67 nderlying storag
1b760 65 20 66 6f 72 20 20 61 20 73 68 61 72 65 64 2d e for a shared-
1b770 6d 65 6d 6f 72 79 20 73 65 67 6d 65 6e 74 2e 0a memory segment..
1b780 2a 2a 0a 2a 2a 20 54 68 65 20 72 65 71 53 69 7a **.** The reqSiz
1b790 65 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 e parameter is t
1b7a0 68 65 20 6e 65 77 20 72 65 71 75 65 73 74 65 64 he new requested
1b7b0 20 73 69 7a 65 20 6f 66 20 74 68 65 20 73 68 61 size of the sha
1b7c0 72 65 64 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 20 54 red memory..** T
1b7d0 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 his implementati
1b7e0 6f 6e 20 69 73 20 66 72 65 65 20 74 6f 20 69 6e on is free to in
1b7f0 63 72 65 61 73 65 20 74 68 65 20 73 68 61 72 65 crease the share
1b800 64 20 6d 65 6d 6f 72 79 20 73 69 7a 65 20 74 6f d memory size to
1b810 0a 2a 2a 20 61 6e 79 20 61 6d 6f 75 6e 74 20 67 .** any amount g
1b820 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 reater than or e
1b830 71 75 61 6c 20 74 6f 20 72 65 71 53 69 7a 65 2e qual to reqSize.
1b840 20 20 49 66 20 74 68 65 20 73 68 61 72 65 64 20 If the shared
1b850 6d 65 6d 6f 72 79 20 69 73 0a 2a 2a 20 61 6c 72 memory is.** alr
1b860 65 61 64 79 20 61 73 20 62 69 67 20 6f 72 20 62 eady as big or b
1b870 69 67 67 65 72 20 61 73 20 72 65 71 53 69 7a 65 igger as reqSize
1b880 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 , this routine i
1b890 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a s a no-op..**.**
1b8a0 20 54 68 65 20 72 65 71 53 69 7a 65 20 70 61 72 The reqSize par
1b8b0 61 6d 65 74 65 72 20 69 73 20 74 68 65 20 6d 69 ameter is the mi
1b8c0 6e 69 6d 75 6d 20 73 69 7a 65 20 72 65 71 75 65 nimum size reque
1b8d0 73 74 65 64 2e 20 20 54 68 65 20 69 6d 70 6c 65 sted. The imple
1b8e0 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a 20 69 73 20 mentation.** is
1b8f0 66 72 65 65 20 74 6f 20 65 78 70 61 6e 64 20 74 free to expand t
1b900 68 65 20 73 74 6f 72 61 67 65 20 74 6f 20 73 6f he storage to so
1b910 6d 65 20 6c 61 72 67 65 72 20 61 6d 6f 75 6e 74 me larger amount
1b920 20 69 66 20 69 74 20 63 68 6f 6f 73 65 73 2e 0a if it chooses..
1b930 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
1b940 69 78 53 68 6d 53 69 7a 65 28 0a 20 20 73 71 6c ixShmSize(. sql
1b950 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 20 ite3_file *fd,
1b960 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 70 /* The op
1b970 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 en database file
1b980 20 68 6f 6c 64 69 6e 67 20 53 48 4d 20 2a 2f 0a holding SHM */.
1b990 20 20 69 6e 74 20 72 65 71 53 69 7a 65 2c 20 20 int reqSize,
1b9a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
1b9b0 65 71 75 65 73 74 65 64 20 73 69 7a 65 2e 20 20 equested size.
1b9c0 2d 31 20 66 6f 72 20 71 75 65 72 79 20 6f 6e 6c -1 for query onl
1b9d0 79 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e 65 77 y */. int *pNew
1b9e0 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 Size
1b9f0 20 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 73 69 /* Write new si
1ba00 7a 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 ze here */.){.
1ba10 75 6e 69 78 46 69 6c 65 20 2a 70 44 62 46 64 20 unixFile *pDbFd
1ba20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 66 64 3b = (unixFile*)fd;
1ba30 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 20 3d 20 . unixShm *p =
1ba40 70 44 62 46 64 2d 3e 70 53 68 6d 3b 0a 20 20 75 pDbFd->pShm;. u
1ba50 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d nixShmNode *pShm
1ba60 4e 6f 64 65 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f Node = p->pShmNo
1ba70 64 65 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 de;. int rc = S
1ba80 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 74 72 75 QLITE_OK;. stru
1ba90 63 74 20 73 74 61 74 20 73 53 74 61 74 3b 0a 0a ct stat sStat;..
1baa0 20 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f assert( pShmNo
1bab0 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e 6f 64 de==pDbFd->pInod
1bac0 65 2d 3e 70 53 68 6d 4e 6f 64 65 20 29 3b 0a 20 e->pShmNode );.
1bad0 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f 64 assert( pShmNod
1bae0 65 2d 3e 70 49 6e 6f 64 65 3d 3d 70 44 62 46 64 e->pInode==pDbFd
1baf0 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a 0a 20 20 77 ->pInode );.. w
1bb00 68 69 6c 65 28 20 31 20 29 7b 0a 20 20 20 20 69 hile( 1 ){. i
1bb10 66 28 20 66 73 74 61 74 28 70 53 68 6d 4e 6f 64 f( fstat(pShmNod
1bb20 65 2d 3e 68 2c 20 26 73 53 74 61 74 29 3d 3d 30 e->h, &sStat)==0
1bb30 20 29 7b 0a 20 20 20 20 20 20 2a 70 4e 65 77 53 ){. *pNewS
1bb40 69 7a 65 20 3d 20 28 69 6e 74 29 73 53 74 61 74 ize = (int)sStat
1bb50 2e 73 74 5f 73 69 7a 65 3b 0a 20 20 20 20 20 20 .st_size;.
1bb60 69 66 28 20 72 65 71 53 69 7a 65 3c 3d 28 69 6e if( reqSize<=(in
1bb70 74 29 73 53 74 61 74 2e 73 74 5f 73 69 7a 65 20 t)sStat.st_size
1bb80 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 65 6c ) break;. }el
1bb90 73 65 7b 0a 20 20 20 20 20 20 2a 70 4e 65 77 53 se{. *pNewS
1bba0 69 7a 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 ize = 0;. r
1bbb0 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 c = SQLITE_IOERR
1bbc0 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
1bbd0 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 66 74 }. rc = ft
1bbe0 72 75 6e 63 61 74 65 28 70 53 68 6d 4e 6f 64 65 runcate(pShmNode
1bbf0 2d 3e 68 2c 20 72 65 71 53 69 7a 65 29 3b 0a 20 ->h, reqSize);.
1bc00 20 20 20 72 65 71 53 69 7a 65 20 3d 20 2d 31 3b reqSize = -1;
1bc10 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
1bc20 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 61 70 20 ;.}.../*.** Map
1bc30 74 68 65 20 73 68 61 72 65 64 20 73 74 6f 72 61 the shared stora
1bc40 67 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 20 ge into memory.
1bc50 0a 2a 2a 0a 2a 2a 20 49 66 20 72 65 71 4d 61 70 .**.** If reqMap
1bc60 53 69 7a 65 20 69 73 20 70 6f 73 69 74 69 76 65 Size is positive
1bc70 2c 20 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 , then an attemp
1bc80 74 20 69 73 20 6d 61 64 65 20 74 6f 20 6d 61 6b t is made to mak
1bc90 65 20 74 68 65 0a 2a 2a 20 6d 61 70 70 69 6e 67 e the.** mapping
1bca0 20 61 74 20 6c 65 61 73 74 20 72 65 71 4d 61 70 at least reqMap
1bcb0 53 69 7a 65 20 62 79 74 65 73 20 69 6e 20 73 69 Size bytes in si
1bcc0 7a 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 74 68 ze. However, th
1bcd0 65 20 6d 61 70 70 69 6e 67 0a 2a 2a 20 77 69 6c e mapping.** wil
1bce0 6c 20 6e 65 76 65 72 20 62 65 20 6c 61 72 67 65 l never be large
1bcf0 72 20 74 68 61 6e 20 74 68 65 20 73 69 7a 65 20 r than the size
1bd00 6f 66 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e of the underlyin
1bd10 67 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 0a g shared memory.
1bd20 2a 2a 20 61 73 20 73 65 74 20 62 79 20 70 72 69 ** as set by pri
1bd30 6f 72 20 63 61 6c 6c 73 20 74 6f 20 78 53 68 6d or calls to xShm
1bd40 53 69 7a 65 28 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 Size(). .**.**
1bd50 2a 70 70 42 75 66 20 69 73 20 6d 61 64 65 20 74 *ppBuf is made t
1bd60 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6d o point to the m
1bd70 65 6d 6f 72 79 20 77 68 69 63 68 20 69 73 20 61 emory which is a
1bd80 20 6d 61 70 70 69 6e 67 20 6f 66 20 74 68 65 0a mapping of the.
1bd90 2a 2a 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 74 ** underlying st
1bda0 6f 72 61 67 65 2e 20 20 41 20 6d 75 74 65 78 20 orage. A mutex
1bdb0 69 73 20 61 63 71 75 69 72 65 64 20 74 6f 20 70 is acquired to p
1bdc0 72 65 76 65 6e 74 20 6f 74 68 65 72 20 74 68 72 revent other thr
1bdd0 65 61 64 73 0a 2a 2a 20 66 72 6f 6d 20 72 75 6e eads.** from run
1bde0 6e 69 6e 67 20 77 68 69 6c 65 20 2a 70 70 42 75 ning while *ppBu
1bdf0 66 20 69 73 20 69 6e 20 75 73 65 20 69 6e 20 6f f is in use in o
1be00 72 64 65 72 20 74 6f 20 70 72 65 76 65 6e 74 20 rder to prevent
1be10 6f 74 68 65 72 20 74 68 72 65 61 64 73 0a 2a 2a other threads.**
1be20 20 72 65 6d 61 70 70 69 6e 67 20 2a 70 70 42 75 remapping *ppBu
1be30 66 20 6f 75 74 20 66 72 6f 6d 20 75 6e 64 65 72 f out from under
1be40 20 74 68 69 73 20 74 68 72 65 61 64 2e 20 20 54 this thread. T
1be50 68 65 20 75 6e 69 78 53 68 6d 52 65 6c 65 61 73 he unixShmReleas
1be60 65 28 29 0a 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c e().** call will
1be70 20 72 65 6c 65 61 73 65 20 74 68 65 20 6d 75 74 release the mut
1be80 65 78 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66 ex. However, if
1be90 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 the lock state
1bea0 69 73 20 43 48 45 43 4b 50 4f 49 4e 54 2c 0a 2a is CHECKPOINT,.*
1beb0 2a 20 74 68 65 20 6d 75 74 65 78 20 69 73 20 6e * the mutex is n
1bec0 6f 74 20 61 63 71 75 69 72 65 64 20 62 65 63 61 ot acquired beca
1bed0 75 73 65 20 43 48 45 43 4b 50 4f 49 4e 54 20 77 use CHECKPOINT w
1bee0 69 6c 6c 20 6e 65 76 65 72 20 72 65 6d 61 70 20 ill never remap
1bef0 74 68 65 0a 2a 2a 20 62 75 66 66 65 72 2e 20 20 the.** buffer.
1bf00 52 45 43 4f 56 45 52 20 6d 69 67 68 74 20 72 65 RECOVER might re
1bf10 6d 61 70 2c 20 74 68 6f 75 67 68 2c 20 73 6f 20 map, though, so
1bf20 43 48 45 43 4b 50 4f 49 4e 54 20 77 69 6c 6c 20 CHECKPOINT will
1bf30 61 63 71 75 69 72 65 0a 2a 2a 20 74 68 65 20 6d acquire.** the m
1bf40 75 74 65 78 20 69 66 20 61 6e 64 20 77 68 65 6e utex if and when
1bf50 20 69 74 20 70 72 6f 6d 6f 74 65 73 20 74 6f 20 it promotes to
1bf60 52 45 43 4f 56 45 52 2e 0a 2a 2a 0a 2a 2a 20 52 RECOVER..**.** R
1bf70 45 43 4f 56 45 52 20 6e 65 65 64 73 20 74 6f 20 ECOVER needs to
1bf80 62 65 20 61 74 6f 6d 69 63 2e 20 20 54 68 65 20 be atomic. The
1bf90 73 61 6d 65 20 6d 75 74 65 78 20 74 68 61 74 20 same mutex that
1bfa0 70 72 65 76 65 6e 74 73 20 2a 70 70 42 75 66 20 prevents *ppBuf
1bfb0 66 72 6f 6d 0a 2a 2a 20 62 65 69 6e 67 20 72 65 from.** being re
1bfc0 6d 61 70 70 65 64 20 61 6c 73 6f 20 70 72 65 76 mapped also prev
1bfd0 65 6e 74 73 20 6d 6f 72 65 20 74 68 61 6e 20 6f ents more than o
1bfe0 6e 65 20 74 68 72 65 61 64 20 66 72 6f 6d 20 62 ne thread from b
1bff0 65 69 6e 67 20 69 6e 0a 2a 2a 20 52 45 43 4f 56 eing in.** RECOV
1c000 45 52 20 61 74 20 61 20 74 69 6d 65 2e 20 20 42 ER at a time. B
1c010 75 74 2c 20 52 45 43 4f 56 45 52 20 73 6f 6d 65 ut, RECOVER some
1c020 74 69 6d 65 73 20 77 61 6e 74 73 20 74 6f 20 72 times wants to r
1c030 65 6d 61 70 20 69 74 73 65 6c 66 2e 0a 2a 2a 20 emap itself..**
1c040 54 6f 20 70 72 65 76 65 6e 74 20 52 45 43 4f 56 To prevent RECOV
1c050 45 52 20 66 72 6f 6d 20 6c 6f 73 69 6e 67 20 69 ER from losing i
1c060 74 73 20 6c 6f 63 6b 20 77 68 69 6c 65 20 72 65 ts lock while re
1c070 6d 61 70 70 69 6e 67 2c 20 74 68 65 0a 2a 2a 20 mapping, the.**
1c080 6d 75 74 65 78 20 69 73 20 6e 6f 74 20 72 65 6c mutex is not rel
1c090 65 61 73 65 64 20 62 79 20 75 6e 69 78 53 68 6d eased by unixShm
1c0a0 52 65 6c 65 61 73 65 28 29 20 77 68 65 6e 20 69 Release() when i
1c0b0 6e 20 52 45 43 4f 56 45 52 2e 0a 2a 2a 0a 2a 2a n RECOVER..**.**
1c0c0 20 2a 70 4e 65 77 4d 61 70 53 69 7a 65 20 69 73 *pNewMapSize is
1c0d0 20 73 65 74 20 74 6f 20 74 68 65 20 73 69 7a 65 set to the size
1c0e0 20 6f 66 20 74 68 65 20 6d 61 70 70 69 6e 67 2e of the mapping.
1c0f0 20 20 55 73 75 61 6c 6c 79 20 2a 70 4e 65 77 4d Usually *pNewM
1c100 61 70 53 69 7a 65 0a 2a 2a 20 77 69 6c 6c 20 62 apSize.** will b
1c110 65 20 72 65 71 4d 61 70 53 69 7a 65 20 6f 72 20 e reqMapSize or
1c120 6c 61 72 67 65 72 2c 20 74 68 6f 75 67 68 20 69 larger, though i
1c130 74 20 63 6f 75 6c 64 20 62 65 20 73 6d 61 6c 6c t could be small
1c140 65 72 20 69 66 20 74 68 65 0a 2a 2a 20 75 6e 64 er if the.** und
1c150 65 72 6c 79 69 6e 67 20 73 68 61 72 65 64 20 6d erlying shared m
1c160 65 6d 6f 72 79 20 68 61 73 20 6e 65 76 65 72 20 emory has never
1c170 62 65 65 6e 20 65 6e 6c 61 72 67 65 64 20 74 6f been enlarged to
1c180 20 72 65 71 4d 61 70 53 69 7a 65 20 62 79 74 65 reqMapSize byte
1c190 73 0a 2a 2a 20 62 79 20 70 72 69 6f 72 20 63 61 s.** by prior ca
1c1a0 6c 6c 73 20 74 6f 20 78 53 68 6d 53 69 7a 65 28 lls to xShmSize(
1c1b0 29 2e 0a 2a 2a 0a 2a 2a 20 2a 70 70 42 75 66 20 )..**.** *ppBuf
1c1c0 6d 69 67 68 74 20 62 65 20 4e 55 4c 4c 20 61 6e might be NULL an
1c1d0 64 20 7a 65 72 6f 20 69 66 20 6e 6f 20 73 70 61 d zero if no spa
1c1e0 63 65 20 68 61 73 0a 2a 2a 20 79 65 74 20 62 65 ce has.** yet be
1c1f0 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20 en allocated to
1c200 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 the underlying s
1c210 74 6f 72 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 torage..*/.stati
1c220 63 20 69 6e 74 20 75 6e 69 78 53 68 6d 47 65 74 c int unixShmGet
1c230 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 (. sqlite3_file
1c240 20 2a 66 64 2c 20 20 20 20 20 20 20 20 2f 2a 20 *fd, /*
1c250 44 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 6f Database file ho
1c260 6c 64 69 6e 67 20 73 68 61 72 65 64 20 6d 65 6d lding shared mem
1c270 6f 72 79 20 2a 2f 0a 20 20 69 6e 74 20 72 65 71 ory */. int req
1c280 4d 61 70 53 69 7a 65 2c 20 20 20 20 20 20 20 20 MapSize,
1c290 20 20 2f 2a 20 52 65 71 75 65 73 74 65 64 20 73 /* Requested s
1c2a0 69 7a 65 20 6f 66 20 6d 61 70 70 69 6e 67 2e 20 ize of mapping.
1c2b0 2d 31 20 6d 65 61 6e 73 20 64 6f 6e 27 74 20 63 -1 means don't c
1c2c0 61 72 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4e are */. int *pN
1c2d0 65 77 4d 61 70 53 69 7a 65 2c 20 20 20 20 20 20 ewMapSize,
1c2e0 20 20 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 73 /* Write new s
1c2f0 69 7a 65 20 6f 66 20 6d 61 70 70 69 6e 67 20 68 ize of mapping h
1c300 65 72 65 20 2a 2f 0a 20 20 76 6f 69 64 20 76 6f ere */. void vo
1c310 6c 61 74 69 6c 65 20 2a 2a 70 70 42 75 66 20 20 latile **ppBuf
1c320 20 20 2f 2a 20 57 72 69 74 65 20 6d 61 70 70 69 /* Write mappi
1c330 6e 67 20 62 75 66 66 65 72 20 6f 72 69 67 69 6e ng buffer origin
1c340 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 6e here */.){. un
1c350 69 78 46 69 6c 65 20 2a 70 44 62 46 64 20 3d 20 ixFile *pDbFd =
1c360 28 75 6e 69 78 46 69 6c 65 2a 29 66 64 3b 0a 20 (unixFile*)fd;.
1c370 20 75 6e 69 78 53 68 6d 20 2a 70 20 3d 20 70 44 unixShm *p = pD
1c380 62 46 64 2d 3e 70 53 68 6d 3b 0a 20 20 75 6e 69 bFd->pShm;. uni
1c390 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f xShmNode *pShmNo
1c3a0 64 65 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f 64 65 de = p->pShmNode
1c3b0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
1c3c0 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
1c3d0 74 28 20 70 53 68 6d 4e 6f 64 65 3d 3d 70 44 62 t( pShmNode==pDb
1c3e0 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 6d Fd->pInode->pShm
1c3f0 4e 6f 64 65 20 29 3b 0a 20 20 61 73 73 65 72 74 Node );. assert
1c400 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 49 6e 6f ( pShmNode->pIno
1c410 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e 6f 64 de==pDbFd->pInod
1c420 65 20 29 3b 0a 0a 20 20 69 66 28 20 70 2d 3e 68 e );.. if( p->h
1c430 61 73 4d 75 74 65 78 42 75 66 3d 3d 30 20 29 7b asMutexBuf==0 ){
1c440 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
1c450 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 ite3_mutex_nothe
1c460 6c 64 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 ld(pShmNode->mut
1c470 65 78 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 ex) );. sqlit
1c480 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
1c490 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 42 75 ShmNode->mutexBu
1c4a0 66 29 3b 0a 20 20 20 20 70 2d 3e 68 61 73 4d 75 f);. p->hasMu
1c4b0 74 65 78 42 75 66 20 3d 20 31 3b 0a 20 20 7d 0a texBuf = 1;. }.
1c4c0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
1c4d0 65 6e 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d 3e enter(pShmNode->
1c4e0 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 70 53 mutex);. if( pS
1c4f0 68 6d 4e 6f 64 65 2d 3e 73 7a 4d 61 70 3d 3d 30 hmNode->szMap==0
1c500 20 7c 7c 20 72 65 71 4d 61 70 53 69 7a 65 3e 70 || reqMapSize>p
1c510 53 68 6d 4e 6f 64 65 2d 3e 73 7a 4d 61 70 20 29 ShmNode->szMap )
1c520 7b 0a 20 20 20 20 69 6e 74 20 61 63 74 75 61 6c {. int actual
1c530 53 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 75 6e Size;. if( un
1c540 69 78 53 68 6d 53 69 7a 65 28 66 64 2c 20 2d 31 ixShmSize(fd, -1
1c550 2c 20 26 61 63 74 75 61 6c 53 69 7a 65 29 21 3d , &actualSize)!=
1c560 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1c570 20 20 20 61 63 74 75 61 6c 53 69 7a 65 20 3d 20 actualSize =
1c580 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 71 0;. }. req
1c590 4d 61 70 53 69 7a 65 20 3d 20 61 63 74 75 61 6c MapSize = actual
1c5a0 53 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 70 53 Size;. if( pS
1c5b0 68 6d 4e 6f 64 65 2d 3e 70 4d 4d 61 70 42 75 66 hmNode->pMMapBuf
1c5c0 20 7c 7c 20 72 65 71 4d 61 70 53 69 7a 65 3c 3d || reqMapSize<=
1c5d0 30 20 29 7b 0a 20 20 20 20 20 20 6d 75 6e 6d 61 0 ){. munma
1c5e0 70 28 70 53 68 6d 4e 6f 64 65 2d 3e 70 4d 4d 61 p(pShmNode->pMMa
1c5f0 70 42 75 66 2c 20 70 53 68 6d 4e 6f 64 65 2d 3e pBuf, pShmNode->
1c600 73 7a 4d 61 70 29 3b 0a 20 20 20 20 7d 0a 20 20 szMap);. }.
1c610 20 20 69 66 28 20 72 65 71 4d 61 70 53 69 7a 65 if( reqMapSize
1c620 3e 30 20 29 7b 0a 20 20 20 20 20 20 70 53 68 6d >0 ){. pShm
1c630 4e 6f 64 65 2d 3e 70 4d 4d 61 70 42 75 66 20 3d Node->pMMapBuf =
1c640 20 6d 6d 61 70 28 30 2c 20 72 65 71 4d 61 70 53 mmap(0, reqMapS
1c650 69 7a 65 2c 20 50 52 4f 54 5f 52 45 41 44 7c 50 ize, PROT_READ|P
1c660 52 4f 54 5f 57 52 49 54 45 2c 20 4d 41 50 5f 53 ROT_WRITE, MAP_S
1c670 48 41 52 45 44 2c 0a 20 20 20 20 20 20 20 20 20 HARED,.
1c680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c690 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 68 2c pShmNode->h,
1c6a0 20 30 29 3b 0a 20 20 20 20 20 20 70 53 68 6d 4e 0);. pShmN
1c6b0 6f 64 65 2d 3e 73 7a 4d 61 70 20 3d 20 70 53 68 ode->szMap = pSh
1c6c0 6d 4e 6f 64 65 2d 3e 70 4d 4d 61 70 42 75 66 20 mNode->pMMapBuf
1c6d0 3f 20 72 65 71 4d 61 70 53 69 7a 65 20 3a 20 30 ? reqMapSize : 0
1c6e0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
1c6f0 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 4d 4d pShmNode->pMM
1c700 61 70 42 75 66 20 3d 20 30 3b 0a 20 20 20 20 20 apBuf = 0;.
1c710 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 7a 4d 61 70 pShmNode->szMap
1c720 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a = 0;. }. }.
1c730 20 20 2a 70 4e 65 77 4d 61 70 53 69 7a 65 20 3d *pNewMapSize =
1c740 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 7a 4d 61 70 pShmNode->szMap
1c750 3b 0a 20 20 2a 70 70 42 75 66 20 3d 20 70 53 68 ;. *ppBuf = pSh
1c760 6d 4e 6f 64 65 2d 3e 70 4d 4d 61 70 42 75 66 3b mNode->pMMapBuf;
1c770 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1c780 5f 6c 65 61 76 65 28 70 53 68 6d 4e 6f 64 65 2d _leave(pShmNode-
1c790 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 >mutex);. retur
1c7a0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
1c7b0 65 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b 20 elease the lock
1c7c0 68 65 6c 64 20 6f 6e 20 74 68 65 20 73 68 61 72 held on the shar
1c7d0 65 64 20 6d 65 6d 6f 72 79 20 73 65 67 6d 65 6e ed memory segmen
1c7e0 74 20 74 6f 20 74 68 61 74 20 6f 74 68 65 72 0a t to that other.
1c7f0 2a 2a 20 74 68 72 65 61 64 73 20 61 72 65 20 66 ** threads are f
1c800 72 65 65 20 74 6f 20 72 65 73 69 7a 65 20 69 74 ree to resize it
1c810 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a if necessary..*
1c820 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b *.** If the lock
1c830 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c is not currentl
1c840 79 20 68 65 6c 64 2c 20 74 68 69 73 20 72 6f 75 y held, this rou
1c850 74 69 6e 65 20 69 73 20 61 20 68 61 72 6d 6c 65 tine is a harmle
1c860 73 73 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 ss no-op..**.**
1c870 49 66 20 74 68 65 20 73 68 61 72 65 64 2d 6d 65 If the shared-me
1c880 6d 6f 72 79 20 6f 62 6a 65 63 74 20 69 73 20 69 mory object is i
1c890 6e 20 6c 6f 63 6b 20 73 74 61 74 65 20 52 45 43 n lock state REC
1c8a0 4f 56 45 52 2c 20 74 68 65 6e 20 77 65 20 64 6f OVER, then we do
1c8b0 20 6e 6f 74 0a 2a 2a 20 72 65 61 6c 6c 79 20 77 not.** really w
1c8c0 61 6e 74 20 74 6f 20 72 65 6c 65 61 73 65 20 74 ant to release t
1c8d0 68 65 20 6c 6f 63 6b 2c 20 73 6f 20 69 6e 20 74 he lock, so in t
1c8e0 68 61 74 20 63 61 73 65 20 74 6f 6f 2c 20 74 68 hat case too, th
1c8f0 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 69 73 is routine.** is
1c900 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 a no-op..*/.sta
1c910 74 69 63 20 69 6e 74 20 75 6e 69 78 53 68 6d 52 tic int unixShmR
1c920 65 6c 65 61 73 65 28 73 71 6c 69 74 65 33 5f 66 elease(sqlite3_f
1c930 69 6c 65 20 2a 66 64 29 7b 0a 20 20 75 6e 69 78 ile *fd){. unix
1c940 46 69 6c 65 20 2a 70 44 62 46 64 20 3d 20 28 75 File *pDbFd = (u
1c950 6e 69 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20 75 nixFile*)fd;. u
1c960 6e 69 78 53 68 6d 20 2a 70 20 3d 20 70 44 62 46 nixShm *p = pDbF
1c970 64 2d 3e 70 53 68 6d 3b 0a 0a 20 20 69 66 28 20 d->pShm;.. if(
1c980 70 2d 3e 68 61 73 4d 75 74 65 78 42 75 66 20 29 p->hasMutexBuf )
1c990 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 {. assert( sq
1c9a0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 lite3_mutex_noth
1c9b0 65 6c 64 28 70 2d 3e 70 53 68 6d 4e 6f 64 65 2d eld(p->pShmNode-
1c9c0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 73 >mutex) );. s
1c9d0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
1c9e0 76 65 28 70 2d 3e 70 53 68 6d 4e 6f 64 65 2d 3e ve(p->pShmNode->
1c9f0 6d 75 74 65 78 42 75 66 29 3b 0a 20 20 20 20 70 mutexBuf);. p
1ca00 2d 3e 68 61 73 4d 75 74 65 78 42 75 66 20 3d 20 ->hasMutexBuf =
1ca10 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 0;. }. return
1ca20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
1ca30 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
1ca40 6c 6f 63 6b 20 73 74 61 74 65 20 66 6f 72 20 61 lock state for a
1ca50 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 73 shared-memory s
1ca60 65 67 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 egment..*/.stati
1ca70 63 20 69 6e 74 20 75 6e 69 78 53 68 6d 4c 6f 63 c int unixShmLoc
1ca80 6b 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c k(. sqlite3_fil
1ca90 65 20 2a 66 64 2c 20 20 20 20 20 20 20 20 20 20 e *fd,
1caa0 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 /* Database file
1cab0 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 73 68 61 holding the sha
1cac0 72 65 64 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 red memory */.
1cad0 69 6e 74 20 6f 66 73 74 2c 20 20 20 20 20 20 20 int ofst,
1cae0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
1caf0 72 73 74 20 6c 6f 63 6b 20 74 6f 20 61 63 71 75 rst lock to acqu
1cb00 69 72 65 20 6f 72 20 72 65 6c 65 61 73 65 20 2a ire or release *
1cb10 2f 0a 20 20 69 6e 74 20 6e 2c 20 20 20 20 20 20 /. int n,
1cb20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1cb30 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 6f 63 6b * Number of lock
1cb40 73 20 74 6f 20 61 63 71 75 69 72 65 20 6f 72 20 s to acquire or
1cb50 72 65 6c 65 61 73 65 20 2a 2f 0a 20 20 69 6e 74 release */. int
1cb60 20 66 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 flags
1cb70 20 20 20 20 20 20 20 20 2f 2a 20 57 68 61 74 20 /* What
1cb80 74 6f 20 64 6f 20 77 69 74 68 20 74 68 65 20 6c to do with the l
1cb90 6f 63 6b 20 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 ock */.){. unix
1cba0 46 69 6c 65 20 2a 70 44 62 46 64 20 3d 20 28 75 File *pDbFd = (u
1cbb0 6e 69 78 46 69 6c 65 2a 29 66 64 3b 20 20 20 20 nixFile*)fd;
1cbc0 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 /* Connection
1cbd0 68 6f 6c 64 69 6e 67 20 73 68 61 72 65 64 20 6d holding shared m
1cbe0 65 6d 6f 72 79 20 2a 2f 0a 20 20 75 6e 69 78 53 emory */. unixS
1cbf0 68 6d 20 2a 70 20 3d 20 70 44 62 46 64 2d 3e 70 hm *p = pDbFd->p
1cc00 53 68 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 Shm;
1cc10 20 2f 2a 20 54 68 65 20 73 68 61 72 65 64 20 6d /* The shared m
1cc20 65 6d 6f 72 79 20 62 65 69 6e 67 20 6c 6f 63 6b emory being lock
1cc30 65 64 20 2a 2f 0a 20 20 75 6e 69 78 53 68 6d 20 ed */. unixShm
1cc40 2a 70 58 3b 20 20 20 20 20 20 20 20 20 20 20 20 *pX;
1cc50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1cc60 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 For looping ove
1cc70 72 20 61 6c 6c 20 73 69 62 6c 69 6e 67 73 20 2a r all siblings *
1cc80 2f 0a 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 /. unixShmNode
1cc90 2a 70 53 68 6d 4e 6f 64 65 20 3d 20 70 2d 3e 70 *pShmNode = p->p
1cca0 53 68 6d 4e 6f 64 65 3b 20 20 2f 2a 20 54 68 65 ShmNode; /* The
1ccb0 20 75 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65 underlying file
1ccc0 20 69 4e 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 iNode */. int
1ccd0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 rc = SQLITE_OK;
1cce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ccf0 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 /* Result code
1cd00 20 2a 2f 0a 20 20 75 31 36 20 6d 61 73 6b 3b 20 */. u16 mask;
1cd10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cd20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
1cd30 61 73 6b 20 6f 66 20 6c 6f 63 6b 73 20 74 6f 20 ask of locks to
1cd40 74 61 6b 65 20 6f 72 20 72 65 6c 65 61 73 65 20 take or release
1cd50 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 53 */.. assert( pS
1cd60 68 6d 4e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 hmNode==pDbFd->p
1cd70 49 6e 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 20 Inode->pShmNode
1cd80 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 53 68 );. assert( pSh
1cd90 6d 4e 6f 64 65 2d 3e 70 49 6e 6f 64 65 3d 3d 70 mNode->pInode==p
1cda0 44 62 46 64 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a DbFd->pInode );.
1cdb0 20 20 61 73 73 65 72 74 28 20 6f 66 73 74 3e 3d assert( ofst>=
1cdc0 30 20 26 26 20 6f 66 73 74 2b 6e 3c 3d 53 51 4c 0 && ofst+n<=SQL
1cdd0 49 54 45 5f 53 48 4d 5f 4e 4c 4f 43 4b 20 29 3b ITE_SHM_NLOCK );
1cde0 0a 20 20 61 73 73 65 72 74 28 20 6e 3e 3d 31 20 . assert( n>=1
1cdf0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 66 6c 61 );. assert( fla
1ce00 67 73 3d 3d 28 53 51 4c 49 54 45 5f 53 48 4d 5f gs==(SQLITE_SHM_
1ce10 4c 4f 43 4b 20 7c 20 53 51 4c 49 54 45 5f 53 48 LOCK | SQLITE_SH
1ce20 4d 5f 53 48 41 52 45 44 29 0a 20 20 20 20 20 20 M_SHARED).
1ce30 20 7c 7c 20 66 6c 61 67 73 3d 3d 28 53 51 4c 49 || flags==(SQLI
1ce40 54 45 5f 53 48 4d 5f 4c 4f 43 4b 20 7c 20 53 51 TE_SHM_LOCK | SQ
1ce50 4c 49 54 45 5f 53 48 4d 5f 45 58 43 4c 55 53 49 LITE_SHM_EXCLUSI
1ce60 56 45 29 0a 20 20 20 20 20 20 20 7c 7c 20 66 6c VE). || fl
1ce70 61 67 73 3d 3d 28 53 51 4c 49 54 45 5f 53 48 4d ags==(SQLITE_SHM
1ce80 5f 55 4e 4c 4f 43 4b 20 7c 20 53 51 4c 49 54 45 _UNLOCK | SQLITE
1ce90 5f 53 48 4d 5f 53 48 41 52 45 44 29 0a 20 20 20 _SHM_SHARED).
1cea0 20 20 20 20 7c 7c 20 66 6c 61 67 73 3d 3d 28 53 || flags==(S
1ceb0 51 4c 49 54 45 5f 53 48 4d 5f 55 4e 4c 4f 43 4b QLITE_SHM_UNLOCK
1cec0 20 7c 20 53 51 4c 49 54 45 5f 53 48 4d 5f 45 58 | SQLITE_SHM_EX
1ced0 43 4c 55 53 49 56 45 29 20 29 3b 0a 20 20 61 73 CLUSIVE) );. as
1cee0 73 65 72 74 28 20 6e 3d 3d 31 20 7c 7c 20 28 66 sert( n==1 || (f
1cef0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 53 48 lags & SQLITE_SH
1cf00 4d 5f 45 58 43 4c 55 53 49 56 45 29 21 3d 30 20 M_EXCLUSIVE)!=0
1cf10 29 3b 0a 0a 20 20 6d 61 73 6b 20 3d 20 28 31 3c );.. mask = (1<
1cf20 3c 28 6f 66 73 74 2b 6e 29 29 20 2d 20 28 31 3c <(ofst+n)) - (1<
1cf30 3c 6f 66 73 74 29 3b 0a 20 20 61 73 73 65 72 74 <ofst);. assert
1cf40 28 20 6e 3e 31 20 7c 7c 20 6d 61 73 6b 3d 3d 28 ( n>1 || mask==(
1cf50 31 3c 3c 6f 66 73 74 29 20 29 3b 0a 20 20 73 71 1<<ofst) );. sq
1cf60 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
1cf70 72 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 r(pShmNode->mute
1cf80 78 29 3b 0a 20 20 69 66 28 20 66 6c 61 67 73 20 x);. if( flags
1cf90 26 20 53 51 4c 49 54 45 5f 53 48 4d 5f 55 4e 4c & SQLITE_SHM_UNL
1cfa0 4f 43 4b 20 29 7b 0a 20 20 20 20 75 31 36 20 61 OCK ){. u16 a
1cfb0 6c 6c 4d 61 73 6b 20 3d 20 30 3b 20 2f 2a 20 4d llMask = 0; /* M
1cfc0 61 73 6b 20 6f 66 20 6c 6f 63 6b 73 20 68 65 6c ask of locks hel
1cfd0 64 20 62 79 20 73 69 62 6c 69 6e 67 73 20 2a 2f d by siblings */
1cfe0 0a 0a 20 20 20 20 2f 2a 20 53 65 65 20 69 66 20 .. /* See if
1cff0 61 6e 79 20 73 69 62 6c 69 6e 67 73 20 68 6f 6c any siblings hol
1d000 64 20 74 68 69 73 20 73 61 6d 65 20 6c 6f 63 6b d this same lock
1d010 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 58 3d 70 */. for(pX=p
1d020 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74 3b ShmNode->pFirst;
1d030 20 70 58 3b 20 70 58 3d 70 58 2d 3e 70 4e 65 78 pX; pX=pX->pNex
1d040 74 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 58 t){. if( pX
1d050 3d 3d 70 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a ==p ) continue;.
1d060 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 70 assert( (p
1d070 58 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 20 28 70 X->exclMask & (p
1d080 2d 3e 65 78 63 6c 4d 61 73 6b 7c 70 2d 3e 73 68 ->exclMask|p->sh
1d090 61 72 65 64 4d 61 73 6b 29 29 3d 3d 30 20 29 3b aredMask))==0 );
1d0a0 0a 20 20 20 20 20 20 61 6c 6c 4d 61 73 6b 20 7c . allMask |
1d0b0 3d 20 70 58 2d 3e 73 68 61 72 65 64 4d 61 73 6b = pX->sharedMask
1d0c0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
1d0d0 55 6e 6c 6f 63 6b 20 74 68 65 20 73 79 73 74 65 Unlock the syste
1d0e0 6d 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 2a 2f m-level locks */
1d0f0 0a 20 20 20 20 69 66 28 20 28 6d 61 73 6b 20 26 . if( (mask &
1d100 20 61 6c 6c 4d 61 73 6b 29 3d 3d 30 20 29 7b 0a allMask)==0 ){.
1d110 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 53 rc = unixS
1d120 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 70 53 68 hmSystemLock(pSh
1d130 6d 4e 6f 64 65 2c 20 46 5f 55 4e 4c 43 4b 2c 20 mNode, F_UNLCK,
1d140 6f 66 73 74 2b 55 4e 49 58 5f 53 48 4d 5f 42 41 ofst+UNIX_SHM_BA
1d150 53 45 2c 20 6e 29 3b 0a 20 20 20 20 7d 65 6c 73 SE, n);. }els
1d160 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 e{. rc = SQ
1d170 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 0a LITE_OK;. }..
1d180 20 20 20 20 2f 2a 20 55 6e 64 6f 20 74 68 65 20 /* Undo the
1d190 6c 6f 63 61 6c 20 6c 6f 63 6b 73 20 2a 2f 0a 20 local locks */.
1d1a0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1d1b0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d E_OK ){. p-
1d1c0 3e 65 78 63 6c 4d 61 73 6b 20 26 3d 20 7e 6d 61 >exclMask &= ~ma
1d1d0 73 6b 3b 0a 20 20 20 20 20 20 70 2d 3e 73 68 61 sk;. p->sha
1d1e0 72 65 64 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b redMask &= ~mask
1d1f0 3b 0a 20 20 20 20 7d 20 0a 20 20 7d 65 6c 73 65 ;. } . }else
1d200 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c if( flags & SQL
1d210 49 54 45 5f 53 48 4d 5f 53 48 41 52 45 44 20 29 ITE_SHM_SHARED )
1d220 7b 0a 20 20 20 20 75 31 36 20 61 6c 6c 53 68 61 {. u16 allSha
1d230 72 65 64 20 3d 20 30 3b 20 20 2f 2a 20 55 6e 69 red = 0; /* Uni
1d240 6f 6e 20 6f 66 20 6c 6f 63 6b 73 20 68 65 6c 64 on of locks held
1d250 20 62 79 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 by connections
1d260 6f 74 68 65 72 20 74 68 61 6e 20 22 70 22 20 2a other than "p" *
1d270 2f 0a 0a 20 20 20 20 2f 2a 20 46 69 6e 64 20 6f /.. /* Find o
1d280 75 74 20 77 68 69 63 68 20 73 68 61 72 65 64 20 ut which shared
1d290 6c 6f 63 6b 73 20 61 72 65 20 61 6c 72 65 61 64 locks are alread
1d2a0 79 20 68 65 6c 64 20 62 79 20 73 69 62 6c 69 6e y held by siblin
1d2b0 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0a 20 g connections..
1d2c0 20 20 20 2a 2a 20 49 66 20 61 6e 79 20 73 69 62 ** If any sib
1d2d0 6c 69 6e 67 20 61 6c 72 65 61 64 79 20 68 6f 6c ling already hol
1d2e0 64 73 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 ds an exclusive
1d2f0 6c 6f 63 6b 2c 20 67 6f 20 61 68 65 61 64 20 61 lock, go ahead a
1d300 6e 64 20 72 65 74 75 72 6e 0a 20 20 20 20 2a 2a nd return. **
1d310 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 0a 20 20 SQLITE_BUSY..
1d320 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 58 3d */. for(pX=
1d330 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74 pShmNode->pFirst
1d340 3b 20 70 58 3b 20 70 58 3d 70 58 2d 3e 70 4e 65 ; pX; pX=pX->pNe
1d350 78 74 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 xt){. if( p
1d360 58 3d 3d 70 20 29 20 63 6f 6e 74 69 6e 75 65 3b X==p ) continue;
1d370 0a 20 20 20 20 20 20 69 66 28 20 28 70 58 2d 3e . if( (pX->
1d380 65 78 63 6c 4d 61 73 6b 20 26 20 6d 61 73 6b 29 exclMask & mask)
1d390 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 !=0 ){. r
1d3a0 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b c = SQLITE_BUSY;
1d3b0 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a . break;.
1d3c0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 6c }. al
1d3d0 6c 53 68 61 72 65 64 20 7c 3d 20 70 58 2d 3e 73 lShared |= pX->s
1d3e0 68 61 72 65 64 4d 61 73 6b 3b 0a 20 20 20 20 7d haredMask;. }
1d3f0 0a 0a 20 20 20 20 2f 2a 20 47 65 74 20 73 68 61 .. /* Get sha
1d400 72 65 64 20 6c 6f 63 6b 73 20 61 74 20 74 68 65 red locks at the
1d410 20 73 79 73 74 65 6d 20 6c 65 76 65 6c 2c 20 69 system level, i
1d420 66 20 6e 65 63 65 73 73 61 72 79 20 2a 2f 0a 20 f necessary */.
1d430 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1d440 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 E_OK ){. if
1d450 28 20 28 61 6c 6c 53 68 61 72 65 64 20 26 20 6d ( (allShared & m
1d460 61 73 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 ask)==0 ){.
1d470 20 20 20 72 63 20 3d 20 75 6e 69 78 53 68 6d 53 rc = unixShmS
1d480 79 73 74 65 6d 4c 6f 63 6b 28 70 53 68 6d 4e 6f ystemLock(pShmNo
1d490 64 65 2c 20 46 5f 52 44 4c 43 4b 2c 20 6f 66 73 de, F_RDLCK, ofs
1d4a0 74 2b 55 4e 49 58 5f 53 48 4d 5f 42 41 53 45 2c t+UNIX_SHM_BASE,
1d4b0 20 6e 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 n);. }else
1d4c0 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 {. rc = S
1d4d0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
1d4e0 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 }. }.. /*
1d4f0 47 65 74 20 74 68 65 20 6c 6f 63 61 6c 20 73 68 Get the local sh
1d500 61 72 65 64 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 ared locks */.
1d510 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1d520 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e _OK ){. p->
1d530 73 68 61 72 65 64 4d 61 73 6b 20 7c 3d 20 6d 61 sharedMask |= ma
1d540 73 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 sk;. }. }els
1d550 65 7b 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 e{. /* Make s
1d560 75 72 65 20 6e 6f 20 73 69 62 6c 69 6e 67 20 63 ure no sibling c
1d570 6f 6e 6e 65 63 74 69 6f 6e 73 20 68 6f 6c 64 20 onnections hold
1d580 6c 6f 63 6b 73 20 74 68 61 74 20 77 69 6c 6c 20 locks that will
1d590 62 6c 6f 63 6b 20 74 68 69 73 0a 20 20 20 20 2a block this. *
1d5a0 2a 20 6c 6f 63 6b 2e 20 20 49 66 20 61 6e 79 20 * lock. If any
1d5b0 64 6f 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 do, return SQLIT
1d5c0 45 5f 42 55 53 59 20 72 69 67 68 74 20 61 77 61 E_BUSY right awa
1d5d0 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f y.. */. fo
1d5e0 72 28 70 58 3d 70 53 68 6d 4e 6f 64 65 2d 3e 70 r(pX=pShmNode->p
1d5f0 46 69 72 73 74 3b 20 70 58 3b 20 70 58 3d 70 58 First; pX; pX=pX
1d600 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 ->pNext){.
1d610 69 66 28 20 70 58 3d 3d 70 20 29 20 63 6f 6e 74 if( pX==p ) cont
1d620 69 6e 75 65 3b 0a 20 20 20 20 20 20 69 66 28 20 inue;. if(
1d630 28 70 58 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 20 (pX->exclMask &
1d640 6d 61 73 6b 29 21 3d 30 20 7c 7c 20 28 70 58 2d mask)!=0 || (pX-
1d650 3e 73 68 61 72 65 64 4d 61 73 6b 20 26 20 6d 61 >sharedMask & ma
1d660 73 6b 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 sk)!=0 ){.
1d670 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 rc = SQLITE_BU
1d680 53 59 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 SY;. brea
1d690 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
1d6a0 0a 20 20 0a 20 20 20 20 2f 2a 20 47 65 74 20 74 . . /* Get t
1d6b0 68 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 he exclusive loc
1d6c0 6b 73 20 61 74 20 74 68 65 20 73 79 73 74 65 6d ks at the system
1d6d0 20 6c 65 76 65 6c 2e 20 20 54 68 65 6e 20 69 66 level. Then if
1d6e0 20 73 75 63 63 65 73 73 66 75 6c 0a 20 20 20 20 successful.
1d6f0 2a 2a 20 61 6c 73 6f 20 6d 61 72 6b 20 74 68 65 ** also mark the
1d700 20 6c 6f 63 61 6c 20 63 6f 6e 6e 65 63 74 69 6f local connectio
1d710 6e 20 61 73 20 62 65 69 6e 67 20 6c 6f 63 6b 65 n as being locke
1d720 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 d.. */. if
1d730 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1d740 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 75 6e ){. rc = un
1d750 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 ixShmSystemLock(
1d760 70 53 68 6d 4e 6f 64 65 2c 20 46 5f 57 52 4c 43 pShmNode, F_WRLC
1d770 4b 2c 20 6f 66 73 74 2b 55 4e 49 58 5f 53 48 4d K, ofst+UNIX_SHM
1d780 5f 42 41 53 45 2c 20 6e 29 3b 0a 20 20 20 20 20 _BASE, n);.
1d790 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1d7a0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d OK ){. p-
1d7b0 3e 73 68 61 72 65 64 4d 61 73 6b 20 26 3d 20 7e >sharedMask &= ~
1d7c0 6d 61 73 6b 3b 0a 20 20 20 20 20 20 20 20 70 2d mask;. p-
1d7d0 3e 65 78 63 6c 4d 61 73 6b 20 7c 3d 20 6d 61 73 >exclMask |= mas
1d7e0 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
1d7f0 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
1d800 75 74 65 78 5f 6c 65 61 76 65 28 70 53 68 6d 4e utex_leave(pShmN
1d810 6f 64 65 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 4f ode->mutex);. O
1d820 53 54 52 41 43 45 28 28 22 53 48 4d 2d 4c 4f 43 STRACE(("SHM-LOC
1d830 4b 20 73 68 6d 69 64 2d 25 64 2c 20 70 69 64 2d K shmid-%d, pid-
1d840 25 64 20 67 6f 74 20 25 73 5c 6e 22 2c 0a 20 20 %d got %s\n",.
1d850 20 20 20 20 20 20 20 20 20 70 2d 3e 69 64 2c 20 p->id,
1d860 67 65 74 70 69 64 28 29 2c 20 75 6e 69 78 53 68 getpid(), unixSh
1d870 6d 4c 6f 63 6b 53 74 72 69 6e 67 28 70 2d 3e 73 mLockString(p->s
1d880 68 61 72 65 64 4d 61 73 6b 2c 20 70 2d 3e 65 78 haredMask, p->ex
1d890 63 6c 4d 61 73 6b 29 29 29 3b 0a 20 20 72 65 74 clMask)));. ret
1d8a0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1d8b0 20 49 6d 70 6c 65 6d 65 6e 74 20 61 20 6d 65 6d Implement a mem
1d8c0 6f 72 79 20 62 61 72 72 69 65 72 20 6f 72 20 6d ory barrier or m
1d8d0 65 6d 6f 72 79 20 66 65 6e 63 65 20 6f 6e 20 73 emory fence on s
1d8e0 68 61 72 65 64 20 6d 65 6d 6f 72 79 2e 20 20 0a hared memory. .
1d8f0 2a 2a 0a 2a 2a 20 41 6c 6c 20 6c 6f 61 64 73 20 **.** All loads
1d900 61 6e 64 20 73 74 6f 72 65 73 20 62 65 67 75 6e and stores begun
1d910 20 62 65 66 6f 72 65 20 74 68 65 20 62 61 72 72 before the barr
1d920 69 65 72 20 6d 75 73 74 20 63 6f 6d 70 6c 65 74 ier must complet
1d930 65 20 62 65 66 6f 72 65 0a 2a 2a 20 61 6e 79 20 e before.** any
1d940 6c 6f 61 64 20 6f 72 20 73 74 6f 72 65 20 62 65 load or store be
1d950 67 75 6e 20 61 66 74 65 72 20 74 68 65 20 62 61 gun after the ba
1d960 72 72 69 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 rrier..*/.static
1d970 20 76 6f 69 64 20 75 6e 69 78 53 68 6d 42 61 72 void unixShmBar
1d980 72 69 65 72 28 0a 20 20 73 71 6c 69 74 65 33 5f rier(. sqlite3_
1d990 66 69 6c 65 20 2a 66 64 20 20 20 20 20 20 20 20 file *fd
1d9a0 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66 /* Database f
1d9b0 69 6c 65 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 ile holding the
1d9c0 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 2a 2f shared memory */
1d9d0 0a 29 7b 0a 23 69 66 64 65 66 20 5f 5f 47 4e 55 .){.#ifdef __GNU
1d9e0 43 5f 5f 0a 20 20 5f 5f 73 79 6e 63 5f 73 79 6e C__. __sync_syn
1d9f0 63 68 72 6f 6e 69 7a 65 28 29 3b 0a 23 65 6c 73 chronize();.#els
1da00 65 0a 20 20 75 6e 69 78 4d 75 74 65 78 45 6e 74 e. unixMutexEnt
1da10 65 72 28 29 3b 0a 20 20 75 6e 69 78 4d 75 74 65 er();. unixMute
1da20 78 4c 65 61 76 65 28 29 3b 0a 23 65 6e 64 69 66 xLeave();.#endif
1da30 0a 7d 0a 0a 0a 23 65 6c 73 65 0a 23 20 64 65 66 .}...#else.# def
1da40 69 6e 65 20 75 6e 69 78 53 68 6d 4f 70 65 6e 20 ine unixShmOpen
1da50 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 75 6e 0.# define un
1da60 69 78 53 68 6d 53 69 7a 65 20 20 20 20 30 0a 23 ixShmSize 0.#
1da70 20 64 65 66 69 6e 65 20 75 6e 69 78 53 68 6d 47 define unixShmG
1da80 65 74 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e et 0.# defin
1da90 65 20 75 6e 69 78 53 68 6d 52 65 6c 65 61 73 65 e unixShmRelease
1daa0 20 30 0a 23 20 64 65 66 69 6e 65 20 75 6e 69 78 0.# define unix
1dab0 53 68 6d 4c 6f 63 6b 20 20 20 20 30 0a 23 20 64 ShmLock 0.# d
1dac0 65 66 69 6e 65 20 75 6e 69 78 53 68 6d 42 61 72 efine unixShmBar
1dad0 72 69 65 72 20 30 0a 23 20 64 65 66 69 6e 65 20 rier 0.# define
1dae0 75 6e 69 78 53 68 6d 43 6c 6f 73 65 20 20 20 30 unixShmClose 0
1daf0 0a 23 65 6e 64 69 66 20 2f 2a 20 23 69 66 6e 64 .#endif /* #ifnd
1db00 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
1db10 41 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 48 65 72 AL */../*.** Her
1db20 65 20 65 6e 64 73 20 74 68 65 20 69 6d 70 6c 65 e ends the imple
1db30 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 6c 6c mentation of all
1db40 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 6d 65 sqlite3_file me
1db50 74 68 6f 64 73 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a thods..**.******
1db60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1db70 20 45 6e 64 20 73 71 6c 69 74 65 33 5f 66 69 6c End sqlite3_fil
1db80 65 20 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a e Methods ******
1db90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dba0 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a *********.******
1dbb0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dbc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dbd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dbe0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dbf0 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a ********/../*.**
1dc00 20 54 68 69 73 20 64 69 76 69 73 69 6f 6e 20 63 This division c
1dc10 6f 6e 74 61 69 6e 73 20 64 65 66 69 6e 69 74 69 ontains definiti
1dc20 6f 6e 73 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 ons of sqlite3_i
1dc30 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 o_methods object
1dc40 73 20 74 68 61 74 0a 2a 2a 20 69 6d 70 6c 65 6d s that.** implem
1dc50 65 6e 74 20 76 61 72 69 6f 75 73 20 66 69 6c 65 ent various file
1dc60 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74 65 67 locking strateg
1dc70 69 65 73 2e 20 20 49 74 20 61 6c 73 6f 20 63 6f ies. It also co
1dc80 6e 74 61 69 6e 73 20 64 65 66 69 6e 69 74 69 6f ntains definitio
1dc90 6e 73 0a 2a 2a 20 6f 66 20 22 66 69 6e 64 65 72 ns.** of "finder
1dca0 22 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 41 20 " functions. A
1dcb0 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 finder-function
1dcc0 69 73 20 75 73 65 64 20 74 6f 20 6c 6f 63 61 74 is used to locat
1dcd0 65 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 e the appropriat
1dce0 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6f 5f e.** sqlite3_io_
1dcf0 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 66 methods object f
1dd00 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 or a particular
1dd10 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
1dd20 54 68 65 20 70 41 70 70 44 61 74 61 0a 2a 2a 20 The pAppData.**
1dd30 66 69 65 6c 64 20 6f 66 20 74 68 65 20 73 71 6c field of the sql
1dd40 69 74 65 33 5f 76 66 73 20 56 46 53 20 6f 62 6a ite3_vfs VFS obj
1dd50 65 63 74 73 20 61 72 65 20 69 6e 69 74 69 61 6c ects are initial
1dd60 69 7a 65 64 20 74 6f 20 62 65 20 70 6f 69 6e 74 ized to be point
1dd70 65 72 73 20 74 6f 0a 2a 2a 20 74 68 65 20 63 6f ers to.** the co
1dd80 72 72 65 63 74 20 66 69 6e 64 65 72 2d 66 75 6e rrect finder-fun
1dd90 63 74 69 6f 6e 20 66 6f 72 20 74 68 61 74 20 56 ction for that V
1dda0 46 53 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 66 FS..**.** Most f
1ddb0 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 73 20 inder functions
1ddc0 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 return a pointer
1ddd0 20 74 6f 20 61 20 66 69 78 65 64 20 73 71 6c 69 to a fixed sqli
1dde0 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a 2a te3_io_methods.*
1ddf0 2a 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 20 6f * object. The o
1de00 6e 6c 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 nly interesting
1de10 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 finder-function
1de20 69 73 20 61 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e is autolockIoFin
1de30 64 65 72 2c 20 77 68 69 63 68 0a 2a 2a 20 6c 6f der, which.** lo
1de40 6f 6b 73 20 61 74 20 74 68 65 20 66 69 6c 65 73 oks at the files
1de50 79 73 74 65 6d 20 74 79 70 65 20 61 6e 64 20 74 ystem type and t
1de60 72 69 65 73 20 74 6f 20 67 75 65 73 73 20 74 68 ries to guess th
1de70 65 20 62 65 73 74 20 6c 6f 63 6b 69 6e 67 0a 2a e best locking.*
1de80 2a 20 73 74 72 61 74 65 67 79 20 66 72 6f 6d 20 * strategy from
1de90 74 68 61 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 that..**.** For
1dea0 66 69 6e 64 65 72 2d 66 75 6e 74 69 6f 6e 20 46 finder-funtion F
1deb0 2c 20 74 77 6f 20 6f 62 6a 65 63 74 73 20 61 72 , two objects ar
1dec0 65 20 63 72 65 61 74 65 64 3a 0a 2a 2a 0a 2a 2a e created:.**.**
1ded0 20 20 20 20 28 31 29 20 54 68 65 20 72 65 61 6c (1) The real
1dee0 20 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e finder-function
1def0 20 6e 61 6d 65 64 20 22 46 49 6d 70 74 28 29 22 named "FImpt()"
1df00 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 29 20 41 ..**.** (2) A
1df10 20 63 6f 6e 73 74 61 6e 74 20 70 6f 69 6e 74 65 constant pointe
1df20 72 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 r to this functi
1df30 6f 6e 20 6e 61 6d 65 64 20 6a 75 73 74 20 22 46 on named just "F
1df40 22 2e 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 41 20 70 6f "..**.**.** A po
1df50 69 6e 74 65 72 20 74 6f 20 74 68 65 20 46 20 70 inter to the F p
1df60 6f 69 6e 74 65 72 20 69 73 20 75 73 65 64 20 61 ointer is used a
1df70 73 20 74 68 65 20 70 41 70 70 44 61 74 61 20 76 s the pAppData v
1df80 61 6c 75 65 20 66 6f 72 20 56 46 53 0a 2a 2a 20 alue for VFS.**
1df90 6f 62 6a 65 63 74 73 2e 20 20 57 65 20 68 61 76 objects. We hav
1dfa0 65 20 74 6f 20 64 6f 20 74 68 69 73 20 69 6e 73 e to do this ins
1dfb0 74 65 61 64 20 6f 66 20 6c 65 74 74 69 6e 67 20 tead of letting
1dfc0 70 41 70 70 44 61 74 61 20 70 6f 69 6e 74 0a 2a pAppData point.*
1dfd0 2a 20 64 69 72 65 63 74 6c 79 20 61 74 20 74 68 * directly at th
1dfe0 65 20 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f e finder-functio
1dff0 6e 20 73 69 6e 63 65 20 43 39 30 20 72 75 6c 65 n since C90 rule
1e000 73 20 70 72 65 76 65 6e 74 20 61 20 76 6f 69 64 s prevent a void
1e010 2a 0a 2a 2a 20 66 72 6f 6d 20 62 65 20 63 61 73 *.** from be cas
1e020 74 20 69 6e 74 6f 20 61 20 66 75 6e 63 74 69 6f t into a functio
1e030 6e 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a n pointer..**.**
1e040 0a 2a 2a 20 45 61 63 68 20 69 6e 73 74 61 6e 63 .** Each instanc
1e050 65 20 6f 66 20 74 68 69 73 20 6d 61 63 72 6f 20 e of this macro
1e060 67 65 6e 65 72 61 74 65 73 20 74 77 6f 20 6f 62 generates two ob
1e070 6a 65 63 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a jects:.**.** *
1e080 20 20 41 20 63 6f 6e 73 74 61 6e 74 20 73 71 6c A constant sql
1e090 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 ite3_io_methods
1e0a0 6f 62 6a 65 63 74 20 63 61 6c 6c 20 4d 45 54 48 object call METH
1e0b0 4f 44 20 74 68 61 74 20 68 61 73 20 6c 6f 63 6b OD that has lock
1e0c0 69 6e 67 0a 2a 2a 20 20 20 20 20 20 6d 65 74 68 ing.** meth
1e0d0 6f 64 73 20 43 4c 4f 53 45 2c 20 4c 4f 43 4b 2c ods CLOSE, LOCK,
1e0e0 20 55 4e 4c 4f 43 4b 2c 20 43 4b 52 45 53 4c 4f UNLOCK, CKRESLO
1e0f0 43 4b 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 41 CK..**.** * A
1e100 6e 20 49 2f 4f 20 6d 65 74 68 6f 64 20 66 69 6e n I/O method fin
1e110 64 65 72 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c der function cal
1e120 6c 65 64 20 46 49 4e 44 45 52 20 74 68 61 74 20 led FINDER that
1e130 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 returns a pointe
1e140 72 0a 2a 2a 20 20 20 20 20 20 74 6f 20 74 68 65 r.** to the
1e150 20 4d 45 54 48 4f 44 20 6f 62 6a 65 63 74 20 69 METHOD object i
1e160 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 62 n the previous b
1e170 75 6c 6c 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e ullet..*/.#defin
1e180 65 20 49 4f 4d 45 54 48 4f 44 53 28 46 49 4e 44 e IOMETHODS(FIND
1e190 45 52 2c 20 4d 45 54 48 4f 44 2c 20 56 45 52 53 ER, METHOD, VERS
1e1a0 49 4f 4e 2c 20 43 4c 4f 53 45 2c 20 4c 4f 43 4b ION, CLOSE, LOCK
1e1b0 2c 20 55 4e 4c 4f 43 4b 2c 20 43 4b 4c 4f 43 4b , UNLOCK, CKLOCK
1e1c0 29 20 20 20 20 20 20 5c 0a 73 74 61 74 69 63 20 ) \.static
1e1d0 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f const sqlite3_io
1e1e0 5f 6d 65 74 68 6f 64 73 20 4d 45 54 48 4f 44 20 _methods METHOD
1e1f0 3d 20 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 = {
1e200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e210 20 20 20 20 20 20 5c 0a 20 20 20 56 45 52 53 49 \. VERSI
1e220 4f 4e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ON,
1e230 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 /* iVersi
1e240 6f 6e 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 on */
1e250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e260 20 20 20 20 20 5c 0a 20 20 20 43 4c 4f 53 45 2c \. CLOSE,
1e270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e280 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 /* xClose
1e290 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
1e2a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e2b0 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 52 65 61 \. unixRea
1e2c0 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d,
1e2d0 20 20 20 20 20 2f 2a 20 78 52 65 61 64 20 2a 2f /* xRead */
1e2e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e2f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e300 20 20 20 5c 0a 20 20 20 75 6e 69 78 57 72 69 74 \. unixWrit
1e310 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
1e320 20 20 20 20 2f 2a 20 78 57 72 69 74 65 20 2a 2f /* xWrite */
1e330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e350 20 20 5c 0a 20 20 20 75 6e 69 78 54 72 75 6e 63 \. unixTrunc
1e360 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ate,
1e370 20 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 /* xTruncate
1e380 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
1e390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e3a0 20 5c 0a 20 20 20 75 6e 69 78 53 79 6e 63 2c 20 \. unixSync,
1e3b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e3c0 20 20 2f 2a 20 78 53 79 6e 63 20 2a 2f 20 20 20 /* xSync */
1e3d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e3f0 5c 0a 20 20 20 75 6e 69 78 46 69 6c 65 53 69 7a \. unixFileSiz
1e400 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
1e410 20 2f 2a 20 78 46 69 6c 65 53 69 7a 65 20 2a 2f /* xFileSize */
1e420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
1e440 0a 20 20 20 4c 4f 43 4b 2c 20 20 20 20 20 20 20 . LOCK,
1e450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e460 2f 2a 20 78 4c 6f 63 6b 20 2a 2f 20 20 20 20 20 /* xLock */
1e470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a \.
1e490 20 20 20 55 4e 4c 4f 43 4b 2c 20 20 20 20 20 20 UNLOCK,
1e4a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1e4b0 2a 20 78 55 6e 6c 6f 63 6b 20 2a 2f 20 20 20 20 * xUnlock */
1e4c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e4d0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
1e4e0 20 20 43 4b 4c 4f 43 4b 2c 20 20 20 20 20 20 20 CKLOCK,
1e4f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1e500 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c xCheckReservedL
1e510 6f 63 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 20 ock */
1e520 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 \.
1e530 20 75 6e 69 78 46 69 6c 65 43 6f 6e 74 72 6f 6c unixFileControl
1e540 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
1e550 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 2a 2f 20 xFileControl */
1e560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e570 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
1e580 75 6e 69 78 53 65 63 74 6f 72 53 69 7a 65 2c 20 unixSectorSize,
1e590 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
1e5a0 53 65 63 74 6f 72 53 69 7a 65 20 2a 2f 20 20 20 SectorSize */
1e5b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e5c0 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 75 \. u
1e5d0 6e 69 78 44 65 76 69 63 65 43 68 61 72 61 63 74 nixDeviceCharact
1e5e0 65 72 69 73 74 69 63 73 2c 20 20 2f 2a 20 78 44 eristics, /* xD
1e5f0 65 76 69 63 65 43 61 70 61 62 69 6c 69 74 69 65 eviceCapabilitie
1e600 73 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 s */
1e610 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e \. un
1e620 69 78 53 68 6d 4f 70 65 6e 2c 20 20 20 20 20 20 ixShmOpen,
1e630 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 /* xSh
1e640 6d 4f 70 65 6e 20 2a 2f 20 20 20 20 20 20 20 20 mOpen */
1e650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e660 20 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 \. uni
1e670 78 53 68 6d 53 69 7a 65 2c 20 20 20 20 20 20 20 xShmSize,
1e680 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d /* xShm
1e690 53 69 7a 65 20 2a 2f 20 20 20 20 20 20 20 20 20 Size */
1e6a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e6b0 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 \. unix
1e6c0 53 68 6d 47 65 74 2c 20 20 20 20 20 20 20 20 20 ShmGet,
1e6d0 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 47 /* xShmG
1e6e0 65 74 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 et */
1e6f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e700 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 \. unixS
1e710 68 6d 52 65 6c 65 61 73 65 2c 20 20 20 20 20 20 hmRelease,
1e720 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 52 65 /* xShmRe
1e730 6c 65 61 73 65 20 2a 2f 20 20 20 20 20 20 20 20 lease */
1e740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e750 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 68 \. unixSh
1e760 6d 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 mLock,
1e770 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4c 6f 63 /* xShmLoc
1e780 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 k */
1e790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e7a0 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 68 6d \. unixShm
1e7b0 42 61 72 72 69 65 72 2c 20 20 20 20 20 20 20 20 Barrier,
1e7c0 20 20 20 20 20 2f 2a 20 78 53 68 6d 42 61 72 72 /* xShmBarr
1e7d0 69 65 72 20 2a 2f 20 20 20 20 20 20 20 20 20 20 ier */
1e7e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e7f0 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 68 6d 43 \. unixShmC
1e800 6c 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 20 lose
1e810 20 20 20 20 2f 2a 20 78 53 68 6d 43 6c 6f 73 65 /* xShmClose
1e820 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 */
1e830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e840 20 20 5c 0a 7d 3b 20 20 20 20 20 20 20 20 20 20 \.};
1e850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e890 20 5c 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 \.static const
1e8a0 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f sqlite3_io_metho
1e8b0 64 73 20 2a 46 49 4e 44 45 52 23 23 49 6d 70 6c ds *FINDER##Impl
1e8c0 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 (const char *z,
1e8d0 75 6e 69 78 46 69 6c 65 20 2a 70 29 7b 20 20 20 unixFile *p){
1e8e0 5c 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d \. UNUSED_PARAM
1e8f0 45 54 45 52 28 7a 29 3b 20 55 4e 55 53 45 44 5f ETER(z); UNUSED_
1e900 50 41 52 41 4d 45 54 45 52 28 70 29 3b 20 20 20 PARAMETER(p);
1e910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
1e930 0a 20 20 72 65 74 75 72 6e 20 26 4d 45 54 48 4f . return &METHO
1e940 44 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 D;
1e950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a \.
1e980 7d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 }
1e990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e9a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e9b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e9c0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 73 \.s
1e9d0 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69 tatic const sqli
1e9e0 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 2a te3_io_methods *
1e9f0 28 2a 63 6f 6e 73 74 20 46 49 4e 44 45 52 29 28 (*const FINDER)(
1ea00 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69 78 const char*,unix
1ea10 46 69 6c 65 20 2a 70 29 20 20 20 20 5c 0a 20 20 File *p) \.
1ea20 20 20 3d 20 46 49 4e 44 45 52 23 23 49 6d 70 6c = FINDER##Impl
1ea30 3b 0a 0a 2f 2a 0a 2a 2a 20 48 65 72 65 20 61 72 ;../*.** Here ar
1ea40 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 73 71 6c e all of the sql
1ea50 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 ite3_io_methods
1ea60 6f 62 6a 65 63 74 73 20 66 6f 72 20 65 61 63 68 objects for each
1ea70 20 6f 66 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 69 of the.** locki
1ea80 6e 67 20 73 74 72 61 74 65 67 69 65 73 2e 20 20 ng strategies.
1ea90 46 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 72 Functions that r
1eaa0 65 74 75 72 6e 20 70 6f 69 6e 74 65 72 73 20 74 eturn pointers t
1eab0 6f 20 74 68 65 73 65 20 6d 65 74 68 6f 64 73 0a o these methods.
1eac0 2a 2a 20 61 72 65 20 61 6c 73 6f 20 63 72 65 61 ** are also crea
1ead0 74 65 64 2e 0a 2a 2f 0a 49 4f 4d 45 54 48 4f 44 ted..*/.IOMETHOD
1eae0 53 28 0a 20 20 70 6f 73 69 78 49 6f 46 69 6e 64 S(. posixIoFind
1eaf0 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f er, /
1eb00 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f * Finder functio
1eb10 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 70 6f 73 69 n name */. posi
1eb20 78 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 xIoMethods,
1eb30 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 /* sqlite3
1eb40 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 _io_methods obje
1eb50 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 32 2c 20 ct name */. 2,
1eb60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb70 20 20 20 20 20 20 20 2f 2a 20 53 68 6d 4f 70 65 /* ShmOpe
1eb80 6e 20 69 73 20 65 6e 61 62 6c 65 64 20 2a 2f 0a n is enabled */.
1eb90 20 20 75 6e 69 78 43 6c 6f 73 65 2c 20 20 20 20 unixClose,
1eba0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
1ebb0 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a Close method */.
1ebc0 20 20 75 6e 69 78 4c 6f 63 6b 2c 20 20 20 20 20 unixLock,
1ebd0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
1ebe0 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 Lock method */.
1ebf0 20 75 6e 69 78 55 6e 6c 6f 63 6b 2c 20 20 20 20 unixUnlock,
1ec00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 /* xU
1ec10 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a nlock method */.
1ec20 20 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72 unixCheckReser
1ec30 76 65 64 4c 6f 63 6b 20 20 20 20 20 2f 2a 20 78 vedLock /* x
1ec40 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 CheckReservedLoc
1ec50 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a 49 4f k method */.).IO
1ec60 4d 45 54 48 4f 44 53 28 0a 20 20 6e 6f 6c 6f 63 METHODS(. noloc
1ec70 6b 49 6f 46 69 6e 64 65 72 2c 20 20 20 20 20 20 kIoFinder,
1ec80 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 /* Finder f
1ec90 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a unction name */.
1eca0 20 20 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 nolockIoMethod
1ecb0 73 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 s, /* s
1ecc0 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 qlite3_io_method
1ecd0 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f s object name */
1ece0 0a 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 . 1,
1ecf0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ed00 53 68 6d 4f 70 65 6e 20 69 73 20 64 69 73 61 62 ShmOpen is disab
1ed10 6c 65 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 43 led */. nolockC
1ed20 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 lose,
1ed30 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 /* xClose met
1ed40 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 4c hod */. nolockL
1ed50 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 ock,
1ed60 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 /* xLock meth
1ed70 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 55 6e od */. nolockUn
1ed80 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 lock,
1ed90 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 /* xUnlock met
1eda0 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 43 hod */. nolockC
1edb0 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b heckReservedLock
1edc0 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 /* xCheckRese
1edd0 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 rvedLock method
1ede0 2a 2f 0a 29 0a 49 4f 4d 45 54 48 4f 44 53 28 0a */.).IOMETHODS(.
1edf0 20 20 64 6f 74 6c 6f 63 6b 49 6f 46 69 6e 64 65 dotlockIoFinde
1ee00 72 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 r, /* F
1ee10 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20 6e inder function n
1ee20 61 6d 65 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b ame */. dotlock
1ee30 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 20 IoMethods,
1ee40 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 69 6f /* sqlite3_io
1ee50 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 _methods object
1ee60 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 20 20 20 name */. 1,
1ee70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ee80 20 20 20 20 2f 2a 20 53 68 6d 4f 70 65 6e 20 69 /* ShmOpen i
1ee90 73 20 64 69 73 61 62 6c 65 64 20 2a 2f 0a 20 20 s disabled */.
1eea0 64 6f 74 6c 6f 63 6b 43 6c 6f 73 65 2c 20 20 20 dotlockClose,
1eeb0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c /* xCl
1eec0 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 ose method */.
1eed0 64 6f 74 6c 6f 63 6b 4c 6f 63 6b 2c 20 20 20 20 dotlockLock,
1eee0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f /* xLo
1eef0 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 64 ck method */. d
1ef00 6f 74 6c 6f 63 6b 55 6e 6c 6f 63 6b 2c 20 20 20 otlockUnlock,
1ef10 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 6c /* xUnl
1ef20 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 ock method */.
1ef30 64 6f 74 6c 6f 63 6b 43 68 65 63 6b 52 65 73 65 dotlockCheckRese
1ef40 72 76 65 64 4c 6f 63 6b 20 20 2f 2a 20 78 43 68 rvedLock /* xCh
1ef50 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 eckReservedLock
1ef60 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a 0a 23 69 66 method */.)..#if
1ef70 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
1ef80 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 OCKING_STYLE &&
1ef90 21 4f 53 5f 56 58 57 4f 52 4b 53 0a 49 4f 4d 45 !OS_VXWORKS.IOME
1efa0 54 48 4f 44 53 28 0a 20 20 66 6c 6f 63 6b 49 6f THODS(. flockIo
1efb0 46 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 20 Finder,
1efc0 20 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e /* Finder fun
1efd0 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 ction name */.
1efe0 66 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 2c 20 flockIoMethods,
1eff0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c /* sql
1f000 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 ite3_io_methods
1f010 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 object name */.
1f020 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 1,
1f030 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
1f040 6d 4f 70 65 6e 20 69 73 20 64 69 73 61 62 6c 65 mOpen is disable
1f050 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 6c 6f 73 d */. flockClos
1f060 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
1f070 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f /* xClose metho
1f080 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 4c 6f 63 6b d */. flockLock
1f090 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1f0a0 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 /* xLock method
1f0b0 20 2a 2f 0a 20 20 66 6c 6f 63 6b 55 6e 6c 6f 63 */. flockUnloc
1f0c0 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k,
1f0d0 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f /* xUnlock metho
1f0e0 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 68 65 63 d */. flockChec
1f0f0 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 20 20 kReservedLock
1f100 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 /* xCheckReserv
1f110 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f edLock method */
1f120 0a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 4f .).#endif..#if O
1f130 53 5f 56 58 57 4f 52 4b 53 0a 49 4f 4d 45 54 48 S_VXWORKS.IOMETH
1f140 4f 44 53 28 0a 20 20 73 65 6d 49 6f 46 69 6e 64 ODS(. semIoFind
1f150 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 er,
1f160 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 /* Finder funct
1f170 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 73 65 ion name */. se
1f180 6d 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 mIoMethods,
1f190 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 /* sqlit
1f1a0 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 e3_io_methods ob
1f1b0 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 ject name */. 1
1f1c0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1f1d0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 6d 4f /* ShmO
1f1e0 70 65 6e 20 69 73 20 64 69 73 61 62 6c 65 64 20 pen is disabled
1f1f0 2a 2f 0a 20 20 73 65 6d 43 6c 6f 73 65 2c 20 20 */. semClose,
1f200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f210 2a 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 * xClose method
1f220 2a 2f 0a 20 20 73 65 6d 4c 6f 63 6b 2c 20 20 20 */. semLock,
1f230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f240 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a * xLock method *
1f250 2f 0a 20 20 73 65 6d 55 6e 6c 6f 63 6b 2c 20 20 /. semUnlock,
1f260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f270 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 xUnlock method
1f280 2a 2f 0a 20 20 73 65 6d 43 68 65 63 6b 52 65 73 */. semCheckRes
1f290 65 72 76 65 64 4c 6f 63 6b 20 20 20 20 20 20 2f ervedLock /
1f2a0 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 * xCheckReserved
1f2b0 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 Lock method */.)
1f2c0 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 65 66 .#endif..#if def
1f2d0 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 ined(__APPLE__)
1f2e0 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 && SQLITE_ENABLE
1f2f0 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 49 _LOCKING_STYLE.I
1f300 4f 4d 45 54 48 4f 44 53 28 0a 20 20 61 66 70 49 OMETHODS(. afpI
1f310 6f 46 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 oFinder,
1f320 20 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20 /* Finder
1f330 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f function name */
1f340 0a 20 20 61 66 70 49 6f 4d 65 74 68 6f 64 73 2c . afpIoMethods,
1f350 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f360 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f sqlite3_io_metho
1f370 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a ds object name *
1f380 2f 0a 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 /. 1,
1f390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f3a0 20 53 68 6d 4f 70 65 6e 20 69 73 20 64 69 73 61 ShmOpen is disa
1f3b0 62 6c 65 64 20 2a 2f 0a 20 20 61 66 70 43 6c 6f bled */. afpClo
1f3c0 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 se,
1f3d0 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 /* xClose me
1f3e0 74 68 6f 64 20 2a 2f 0a 20 20 61 66 70 4c 6f 63 thod */. afpLoc
1f3f0 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k,
1f400 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 /* xLock met
1f410 68 6f 64 20 2a 2f 0a 20 20 61 66 70 55 6e 6c 6f hod */. afpUnlo
1f420 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ck,
1f430 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 /* xUnlock me
1f440 74 68 6f 64 20 2a 2f 0a 20 20 61 66 70 43 68 65 thod */. afpChe
1f450 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 20 ckReservedLock
1f460 20 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 /* xCheckRes
1f470 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 ervedLock method
1f480 20 2a 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a */.).#endif../*
1f490 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 20 6c 6f .** The proxy lo
1f4a0 63 6b 69 6e 67 20 6d 65 74 68 6f 64 20 69 73 20 cking method is
1f4b0 61 20 22 73 75 70 65 72 2d 6d 65 74 68 6f 64 22 a "super-method"
1f4c0 20 69 6e 20 74 68 65 20 73 65 6e 73 65 20 74 68 in the sense th
1f4d0 61 74 20 69 74 0a 2a 2a 20 6f 70 65 6e 73 20 73 at it.** opens s
1f4e0 65 63 6f 6e 64 61 72 79 20 66 69 6c 65 20 64 65 econdary file de
1f4f0 73 63 72 69 70 74 6f 72 73 20 66 6f 72 20 74 68 scriptors for th
1f500 65 20 63 6f 6e 63 68 20 61 6e 64 20 6c 6f 63 6b e conch and lock
1f510 20 66 69 6c 65 73 20 61 6e 64 0a 2a 2a 20 69 74 files and.** it
1f520 20 75 73 65 73 20 70 72 6f 78 79 2c 20 64 6f 74 uses proxy, dot
1f530 2d 66 69 6c 65 2c 20 41 46 50 2c 20 61 6e 64 20 -file, AFP, and
1f540 66 6c 6f 63 6b 28 29 20 6c 6f 63 6b 69 6e 67 20 flock() locking
1f550 6d 65 74 68 6f 64 73 20 6f 6e 20 74 68 6f 73 65 methods on those
1f560 0a 2a 2a 20 73 65 63 6f 6e 64 61 72 79 20 66 69 .** secondary fi
1f570 6c 65 73 2e 20 20 46 6f 72 20 74 68 69 73 20 72 les. For this r
1f580 65 61 73 6f 6e 2c 20 74 68 65 20 64 69 76 69 73 eason, the divis
1f590 69 6f 6e 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 ion that impleme
1f5a0 6e 74 73 0a 2a 2a 20 70 72 6f 78 79 20 6c 6f 63 nts.** proxy loc
1f5b0 6b 69 6e 67 20 69 73 20 6c 6f 63 61 74 65 64 20 king is located
1f5c0 6d 75 63 68 20 66 75 72 74 68 65 72 20 64 6f 77 much further dow
1f5d0 6e 20 69 6e 20 74 68 65 20 66 69 6c 65 2e 20 20 n in the file.
1f5e0 42 75 74 20 77 65 20 6e 65 65 64 0a 2a 2a 20 74 But we need.** t
1f5f0 6f 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20 64 o go ahead and d
1f600 65 66 69 6e 65 20 74 68 65 20 73 71 6c 69 74 65 efine the sqlite
1f610 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 61 6e 64 3_io_methods and
1f620 20 66 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e finder function
1f630 0a 2a 2a 20 66 6f 72 20 70 72 6f 78 79 20 6c 6f .** for proxy lo
1f640 63 6b 69 6e 67 20 68 65 72 65 2e 20 20 53 6f 20 cking here. So
1f650 77 65 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61 we forward decla
1f660 72 65 20 74 68 65 20 49 2f 4f 20 6d 65 74 68 6f re the I/O metho
1f670 64 73 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e ds..*/.#if defin
1f680 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 ed(__APPLE__) &&
1f690 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
1f6a0 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 73 74 61 OCKING_STYLE.sta
1f6b0 74 69 63 20 69 6e 74 20 70 72 6f 78 79 43 6c 6f tic int proxyClo
1f6c0 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a se(sqlite3_file*
1f6d0 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 );.static int pr
1f6e0 6f 78 79 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f oxyLock(sqlite3_
1f6f0 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 73 74 61 file*, int);.sta
1f700 74 69 63 20 69 6e 74 20 70 72 6f 78 79 55 6e 6c tic int proxyUnl
1f710 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 ock(sqlite3_file
1f720 2a 2c 20 69 6e 74 29 3b 0a 73 74 61 74 69 63 20 *, int);.static
1f730 69 6e 74 20 70 72 6f 78 79 43 68 65 63 6b 52 65 int proxyCheckRe
1f740 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 servedLock(sqlit
1f750 65 33 5f 66 69 6c 65 2a 2c 20 69 6e 74 2a 29 3b e3_file*, int*);
1f760 0a 49 4f 4d 45 54 48 4f 44 53 28 0a 20 20 70 72 .IOMETHODS(. pr
1f770 6f 78 79 49 6f 46 69 6e 64 65 72 2c 20 20 20 20 oxyIoFinder,
1f780 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 /* Finde
1f790 72 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 r function name
1f7a0 2a 2f 0a 20 20 70 72 6f 78 79 49 6f 4d 65 74 68 */. proxyIoMeth
1f7b0 6f 64 73 2c 20 20 20 20 20 20 20 20 20 20 20 2f ods, /
1f7c0 2a 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 * sqlite3_io_met
1f7d0 68 6f 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 hods object name
1f7e0 20 2a 2f 0a 20 20 31 2c 20 20 20 20 20 20 20 20 */. 1,
1f7f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f800 2f 2a 20 53 68 6d 4f 70 65 6e 20 69 73 20 64 69 /* ShmOpen is di
1f810 73 61 62 6c 65 64 20 2a 2f 0a 20 20 70 72 6f 78 sabled */. prox
1f820 79 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 yClose,
1f830 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 /* xClose
1f840 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 70 72 6f 78 method */. prox
1f850 79 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 yLock,
1f860 20 20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d /* xLock m
1f870 65 74 68 6f 64 20 2a 2f 0a 20 20 70 72 6f 78 79 ethod */. proxy
1f880 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 Unlock,
1f890 20 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 /* xUnlock
1f8a0 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 70 72 6f 78 method */. prox
1f8b0 79 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f yCheckReservedLo
1f8c0 63 6b 20 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 ck /* xCheckR
1f8d0 65 73 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 eservedLock meth
1f8e0 6f 64 20 2a 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a od */.).#endif..
1f8f0 2f 2a 20 6e 66 73 20 6c 6f 63 6b 64 20 6f 6e 20 /* nfs lockd on
1f900 4f 53 58 20 31 30 2e 33 2b 20 64 6f 65 73 6e 27 OSX 10.3+ doesn'
1f910 74 20 63 6c 65 61 72 20 77 72 69 74 65 20 6c 6f t clear write lo
1f920 63 6b 73 20 77 68 65 6e 20 61 20 72 65 61 64 20 cks when a read
1f930 6c 6f 63 6b 20 69 73 20 73 65 74 20 2a 2f 0a 23 lock is set */.#
1f940 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 if defined(__APP
1f950 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f LE__) && SQLITE_
1f960 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
1f970 54 59 4c 45 0a 49 4f 4d 45 54 48 4f 44 53 28 0a TYLE.IOMETHODS(.
1f980 20 20 6e 66 73 49 6f 46 69 6e 64 65 72 2c 20 20 nfsIoFinder,
1f990 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f9a0 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20 Finder function
1f9b0 6e 61 6d 65 20 2a 2f 0a 20 20 6e 66 73 49 6f 4d name */. nfsIoM
1f9c0 65 74 68 6f 64 73 2c 20 20 20 20 20 20 20 20 20 ethods,
1f9d0 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f /* sqlite3_
1f9e0 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 io_methods objec
1f9f0 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 20 t name */. 1,
1fa00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fa10 20 20 20 20 20 20 20 2f 2a 20 53 68 6d 4f 70 65 /* ShmOpe
1fa20 6e 20 69 73 20 64 69 73 61 62 6c 65 64 20 2a 2f n is disabled */
1fa30 0a 20 20 75 6e 69 78 43 6c 6f 73 65 2c 20 20 20 . unixClose,
1fa40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1fa50 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 2a xClose method *
1fa60 2f 0a 20 20 75 6e 69 78 4c 6f 63 6b 2c 20 20 20 /. unixLock,
1fa70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1fa80 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a * xLock method *
1fa90 2f 0a 20 20 6e 66 73 55 6e 6c 6f 63 6b 2c 20 20 /. nfsUnlock,
1faa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1fab0 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 * xUnlock method
1fac0 20 2a 2f 0a 20 20 75 6e 69 78 43 68 65 63 6b 52 */. unixCheckR
1fad0 65 73 65 72 76 65 64 4c 6f 63 6b 20 20 20 20 20 eservedLock
1fae0 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 /* xCheckReserv
1faf0 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f edLock method */
1fb00 0a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 .).#endif..#if d
1fb10 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
1fb20 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 ) && SQLITE_ENAB
1fb30 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
1fb40 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 22 66 69 ./* .** This "fi
1fb50 6e 64 65 72 22 20 66 75 6e 63 74 69 6f 6e 20 61 nder" function a
1fb60 74 74 65 6d 70 74 73 20 74 6f 20 64 65 74 65 72 ttempts to deter
1fb70 6d 69 6e 65 20 74 68 65 20 62 65 73 74 20 6c 6f mine the best lo
1fb80 63 6b 69 6e 67 20 73 74 72 61 74 65 67 79 20 0a cking strategy .
1fb90 2a 2a 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 ** for the datab
1fba0 61 73 65 20 66 69 6c 65 20 22 66 69 6c 65 50 61 ase file "filePa
1fbb0 74 68 22 2e 20 20 49 74 20 74 68 65 6e 20 72 65 th". It then re
1fbc0 74 75 72 6e 73 20 74 68 65 20 73 71 6c 69 74 65 turns the sqlite
1fbd0 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20 3_io_methods.**
1fbe0 6f 62 6a 65 63 74 20 74 68 61 74 20 69 6d 70 6c object that impl
1fbf0 65 6d 65 6e 74 73 20 74 68 61 74 20 73 74 72 61 ements that stra
1fc00 74 65 67 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 tegy..**.** This
1fc10 20 69 73 20 66 6f 72 20 4d 61 63 4f 53 58 20 6f is for MacOSX o
1fc20 6e 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 nly..*/.static c
1fc30 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f onst sqlite3_io_
1fc40 6d 65 74 68 6f 64 73 20 2a 61 75 74 6f 6c 6f 63 methods *autoloc
1fc50 6b 49 6f 46 69 6e 64 65 72 49 6d 70 6c 28 0a 20 kIoFinderImpl(.
1fc60 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c const char *fil
1fc70 65 50 61 74 68 2c 20 20 20 20 2f 2a 20 6e 61 6d ePath, /* nam
1fc80 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
1fc90 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 e file */. unix
1fca0 46 69 6c 65 20 2a 70 4e 65 77 20 20 20 20 20 20 File *pNew
1fcb0 20 20 20 20 20 2f 2a 20 6f 70 65 6e 20 66 69 6c /* open fil
1fcc0 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 e object for the
1fcd0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
1fce0 2f 0a 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f /.){. static co
1fcf0 6e 73 74 20 73 74 72 75 63 74 20 4d 61 70 70 69 nst struct Mappi
1fd00 6e 67 20 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 ng {. const c
1fd10 68 61 72 20 2a 7a 46 69 6c 65 73 79 73 74 65 6d har *zFilesystem
1fd20 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
1fd30 2a 20 46 69 6c 65 73 79 73 74 65 6d 20 74 79 70 * Filesystem typ
1fd40 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 63 6f e name */. co
1fd50 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d nst sqlite3_io_m
1fd60 65 74 68 6f 64 73 20 2a 70 4d 65 74 68 6f 64 73 ethods *pMethods
1fd70 3b 20 20 20 2f 2a 20 41 70 70 72 6f 70 72 69 61 ; /* Appropria
1fd80 74 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f te locking metho
1fd90 64 20 2a 2f 0a 20 20 7d 20 61 4d 61 70 5b 5d 20 d */. } aMap[]
1fda0 3d 20 7b 0a 20 20 20 20 7b 20 22 68 66 73 22 2c = {. { "hfs",
1fdb0 20 20 20 20 26 70 6f 73 69 78 49 6f 4d 65 74 68 &posixIoMeth
1fdc0 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 22 75 66 ods },. { "uf
1fdd0 73 22 2c 20 20 20 20 26 70 6f 73 69 78 49 6f 4d s", &posixIoM
1fde0 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 ethods },. {
1fdf0 22 61 66 70 66 73 22 2c 20 20 26 61 66 70 49 6f "afpfs", &afpIo
1fe00 4d 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b Methods },. {
1fe10 20 22 73 6d 62 66 73 22 2c 20 20 26 61 66 70 49 "smbfs", &afpI
1fe20 6f 4d 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 oMethods },.
1fe30 7b 20 22 77 65 62 64 61 76 22 2c 20 26 6e 6f 6c { "webdav", &nol
1fe40 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 20 7d 2c 0a ockIoMethods },.
1fe50 20 20 20 20 7b 20 30 2c 20 30 20 7d 0a 20 20 7d { 0, 0 }. }
1fe60 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 73 74 72 ;. int i;. str
1fe70 75 63 74 20 73 74 61 74 66 73 20 66 73 49 6e 66 uct statfs fsInf
1fe80 6f 3b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 o;. struct floc
1fe90 6b 20 6c 6f 63 6b 49 6e 66 6f 3b 0a 0a 20 20 69 k lockInfo;.. i
1fea0 66 28 20 21 66 69 6c 65 50 61 74 68 20 29 7b 0a f( !filePath ){.
1feb0 20 20 20 20 2f 2a 20 49 66 20 66 69 6c 65 50 61 /* If filePa
1fec0 74 68 3d 3d 4e 55 4c 4c 20 74 68 61 74 20 6d 65 th==NULL that me
1fed0 61 6e 73 20 77 65 20 61 72 65 20 64 65 61 6c 69 ans we are deali
1fee0 6e 67 20 77 69 74 68 20 61 20 74 72 61 6e 73 69 ng with a transi
1fef0 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 ent file. **
1ff00 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 that does not ne
1ff10 65 64 20 74 6f 20 62 65 20 6c 6f 63 6b 65 64 2e ed to be locked.
1ff20 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 26 */. return &
1ff30 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b nolockIoMethods;
1ff40 0a 20 20 7d 0a 20 20 69 66 28 20 73 74 61 74 66 . }. if( statf
1ff50 73 28 66 69 6c 65 50 61 74 68 2c 20 26 66 73 49 s(filePath, &fsI
1ff60 6e 66 6f 29 20 21 3d 20 2d 31 20 29 7b 0a 20 20 nfo) != -1 ){.
1ff70 20 20 69 66 28 20 66 73 49 6e 66 6f 2e 66 5f 66 if( fsInfo.f_f
1ff80 6c 61 67 73 20 26 20 4d 4e 54 5f 52 44 4f 4e 4c lags & MNT_RDONL
1ff90 59 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 Y ){. retur
1ffa0 6e 20 26 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f n &nolockIoMetho
1ffb0 64 73 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f ds;. }. fo
1ffc0 72 28 69 3d 30 3b 20 61 4d 61 70 5b 69 5d 2e 7a r(i=0; aMap[i].z
1ffd0 46 69 6c 65 73 79 73 74 65 6d 3b 20 69 2b 2b 29 Filesystem; i++)
1ffe0 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 63 {. if( strc
1fff0 6d 70 28 66 73 49 6e 66 6f 2e 66 5f 66 73 74 79 mp(fsInfo.f_fsty
20000 70 65 6e 61 6d 65 2c 20 61 4d 61 70 5b 69 5d 2e pename, aMap[i].
20010 7a 46 69 6c 65 73 79 73 74 65 6d 29 3d 3d 30 20 zFilesystem)==0
20020 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
20030 6e 20 61 4d 61 70 5b 69 5d 2e 70 4d 65 74 68 6f n aMap[i].pMetho
20040 64 73 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ds;. }.
20050 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 44 65 66 61 }. }.. /* Defa
20060 75 6c 74 20 63 61 73 65 2e 20 48 61 6e 64 6c 65 ult case. Handle
20070 73 2c 20 61 6d 6f 6e 67 73 74 20 6f 74 68 65 72 s, amongst other
20080 73 2c 20 22 6e 66 73 22 2e 0a 20 20 2a 2a 20 54 s, "nfs".. ** T
20090 65 73 74 20 62 79 74 65 2d 72 61 6e 67 65 20 6c est byte-range l
200a0 6f 63 6b 20 75 73 69 6e 67 20 66 63 6e 74 6c 28 ock using fcntl(
200b0 29 2e 20 49 66 20 74 68 65 20 63 61 6c 6c 20 73 ). If the call s
200c0 75 63 63 65 65 64 73 2c 20 0a 20 20 2a 2a 20 61 ucceeds, . ** a
200d0 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 20 66 ssume that the f
200e0 69 6c 65 2d 73 79 73 74 65 6d 20 73 75 70 70 6f ile-system suppo
200f0 72 74 73 20 50 4f 53 49 58 20 73 74 79 6c 65 20 rts POSIX style
20100 6c 6f 63 6b 73 2e 20 0a 20 20 2a 2f 0a 20 20 6c locks. . */. l
20110 6f 63 6b 49 6e 66 6f 2e 6c 5f 6c 65 6e 20 3d 20 ockInfo.l_len =
20120 31 3b 0a 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 1;. lockInfo.l_
20130 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 6c 6f 63 start = 0;. loc
20140 6b 49 6e 66 6f 2e 6c 5f 77 68 65 6e 63 65 20 3d kInfo.l_whence =
20150 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 6c 6f 63 SEEK_SET;. loc
20160 6b 49 6e 66 6f 2e 6c 5f 74 79 70 65 20 3d 20 46 kInfo.l_type = F
20170 5f 52 44 4c 43 4b 3b 0a 20 20 69 66 28 20 66 63 _RDLCK;. if( fc
20180 6e 74 6c 28 70 4e 65 77 2d 3e 68 2c 20 46 5f 47 ntl(pNew->h, F_G
20190 45 54 4c 4b 2c 20 26 6c 6f 63 6b 49 6e 66 6f 29 ETLK, &lockInfo)
201a0 21 3d 2d 31 20 29 20 7b 0a 20 20 20 20 69 66 28 !=-1 ) {. if(
201b0 20 73 74 72 63 6d 70 28 66 73 49 6e 66 6f 2e 66 strcmp(fsInfo.f
201c0 5f 66 73 74 79 70 65 6e 61 6d 65 2c 20 22 6e 66 _fstypename, "nf
201d0 73 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 s")==0 ){.
201e0 72 65 74 75 72 6e 20 26 6e 66 73 49 6f 4d 65 74 return &nfsIoMet
201f0 68 6f 64 73 3b 0a 20 20 20 20 7d 20 65 6c 73 65 hods;. } else
20200 20 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 {. return
20210 26 70 6f 73 69 78 49 6f 4d 65 74 68 6f 64 73 3b &posixIoMethods;
20220 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a . }. }else{.
20230 20 20 20 20 72 65 74 75 72 6e 20 26 64 6f 74 6c return &dotl
20240 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 ockIoMethods;.
20250 7d 0a 7d 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 }.}.static const
20260 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 sqlite3_io_meth
20270 6f 64 73 20 0a 20 20 2a 28 2a 63 6f 6e 73 74 20 ods . *(*const
20280 61 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 autolockIoFinder
20290 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e )(const char*,un
202a0 69 78 46 69 6c 65 2a 29 20 3d 20 61 75 74 6f 6c ixFile*) = autol
202b0 6f 63 6b 49 6f 46 69 6e 64 65 72 49 6d 70 6c 3b ockIoFinderImpl;
202c0 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 64 65 66 69 ..#endif /* defi
202d0 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 ned(__APPLE__) &
202e0 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f & SQLITE_ENABLE_
202f0 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 2a 2f LOCKING_STYLE */
20300 0a 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 ..#if OS_VXWORKS
20310 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c && SQLITE_ENABL
20320 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a E_LOCKING_STYLE.
20330 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 22 66 69 6e /* .** This "fin
20340 64 65 72 22 20 66 75 6e 63 74 69 6f 6e 20 61 74 der" function at
20350 74 65 6d 70 74 73 20 74 6f 20 64 65 74 65 72 6d tempts to determ
20360 69 6e 65 20 74 68 65 20 62 65 73 74 20 6c 6f 63 ine the best loc
20370 6b 69 6e 67 20 73 74 72 61 74 65 67 79 20 0a 2a king strategy .*
20380 2a 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 * for the databa
20390 73 65 20 66 69 6c 65 20 22 66 69 6c 65 50 61 74 se file "filePat
203a0 68 22 2e 20 20 49 74 20 74 68 65 6e 20 72 65 74 h". It then ret
203b0 75 72 6e 73 20 74 68 65 20 73 71 6c 69 74 65 33 urns the sqlite3
203c0 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20 6f _io_methods.** o
203d0 62 6a 65 63 74 20 74 68 61 74 20 69 6d 70 6c 65 bject that imple
203e0 6d 65 6e 74 73 20 74 68 61 74 20 73 74 72 61 74 ments that strat
203f0 65 67 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 egy..**.** This
20400 69 73 20 66 6f 72 20 56 58 57 6f 72 6b 73 20 6f is for VXWorks o
20410 6e 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 nly..*/.static c
20420 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f onst sqlite3_io_
20430 6d 65 74 68 6f 64 73 20 2a 61 75 74 6f 6c 6f 63 methods *autoloc
20440 6b 49 6f 46 69 6e 64 65 72 49 6d 70 6c 28 0a 20 kIoFinderImpl(.
20450 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c const char *fil
20460 65 50 61 74 68 2c 20 20 20 20 2f 2a 20 6e 61 6d ePath, /* nam
20470 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
20480 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 e file */. unix
20490 46 69 6c 65 20 2a 70 4e 65 77 20 20 20 20 20 20 File *pNew
204a0 20 20 20 20 20 2f 2a 20 74 68 65 20 6f 70 65 6e /* the open
204b0 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 2a 2f 0a file object */.
204c0 29 7b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 ){. struct floc
204d0 6b 20 6c 6f 63 6b 49 6e 66 6f 3b 0a 0a 20 20 69 k lockInfo;.. i
204e0 66 28 20 21 66 69 6c 65 50 61 74 68 20 29 7b 0a f( !filePath ){.
204f0 20 20 20 20 2f 2a 20 49 66 20 66 69 6c 65 50 61 /* If filePa
20500 74 68 3d 3d 4e 55 4c 4c 20 74 68 61 74 20 6d 65 th==NULL that me
20510 61 6e 73 20 77 65 20 61 72 65 20 64 65 61 6c 69 ans we are deali
20520 6e 67 20 77 69 74 68 20 61 20 74 72 61 6e 73 69 ng with a transi
20530 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 ent file. **
20540 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 that does not ne
20550 65 64 20 74 6f 20 62 65 20 6c 6f 63 6b 65 64 2e ed to be locked.
20560 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 26 */. return &
20570 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b nolockIoMethods;
20580 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 65 73 74 20 . }.. /* Test
20590 69 66 20 66 63 6e 74 6c 28 29 20 69 73 20 73 75 if fcntl() is su
205a0 70 70 6f 72 74 65 64 20 61 6e 64 20 75 73 65 20 pported and use
205b0 50 4f 53 49 58 20 73 74 79 6c 65 20 6c 6f 63 6b POSIX style lock
205c0 73 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 s.. ** Otherwis
205d0 65 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74 e fall back to t
205e0 68 65 20 6e 61 6d 65 64 20 73 65 6d 61 70 68 6f he named semapho
205f0 72 65 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2f 0a re method.. */.
20600 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 6c 65 6e lockInfo.l_len
20610 20 3d 20 31 3b 0a 20 20 6c 6f 63 6b 49 6e 66 6f = 1;. lockInfo
20620 2e 6c 5f 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 .l_start = 0;.
20630 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 77 68 65 6e 63 lockInfo.l_whenc
20640 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 e = SEEK_SET;.
20650 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 74 79 70 65 20 lockInfo.l_type
20660 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 69 66 28 = F_RDLCK;. if(
20670 20 66 63 6e 74 6c 28 70 4e 65 77 2d 3e 68 2c 20 fcntl(pNew->h,
20680 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63 6b 49 6e F_GETLK, &lockIn
20690 66 6f 29 21 3d 2d 31 20 29 20 7b 0a 20 20 20 20 fo)!=-1 ) {.
206a0 72 65 74 75 72 6e 20 26 70 6f 73 69 78 49 6f 4d return &posixIoM
206b0 65 74 68 6f 64 73 3b 0a 20 20 7d 65 6c 73 65 7b ethods;. }else{
206c0 0a 20 20 20 20 72 65 74 75 72 6e 20 26 73 65 6d . return &sem
206d0 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d 0a 7d IoMethods;. }.}
206e0 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 .static const sq
206f0 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 lite3_io_methods
20700 20 0a 20 20 2a 28 2a 63 6f 6e 73 74 20 61 75 74 . *(*const aut
20710 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 29 28 63 olockIoFinder)(c
20720 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69 78 46 onst char*,unixF
20730 69 6c 65 2a 29 20 3d 20 61 75 74 6f 6c 6f 63 6b ile*) = autolock
20740 49 6f 46 69 6e 64 65 72 49 6d 70 6c 3b 0a 0a 23 IoFinderImpl;..#
20750 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 57 4f endif /* OS_VXWO
20760 52 4b 53 20 26 26 20 53 51 4c 49 54 45 5f 45 4e RKS && SQLITE_EN
20770 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 ABLE_LOCKING_STY
20780 4c 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 LE */../*.** An
20790 61 62 73 74 72 61 63 74 20 74 79 70 65 20 66 6f abstract type fo
207a0 72 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 r a pointer to a
207b0 20 49 4f 20 6d 65 74 68 6f 64 20 66 69 6e 64 65 IO method finde
207c0 72 20 66 75 6e 63 74 69 6f 6e 3a 0a 2a 2f 0a 74 r function:.*/.t
207d0 79 70 65 64 65 66 20 63 6f 6e 73 74 20 73 71 6c ypedef const sql
207e0 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 ite3_io_methods
207f0 2a 28 2a 66 69 6e 64 65 72 5f 74 79 70 65 29 28 *(*finder_type)(
20800 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69 78 const char*,unix
20810 46 69 6c 65 2a 29 3b 0a 0a 0a 2f 2a 2a 2a 2a 2a File*);.../*****
20820 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20830 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20840 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20850 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20860 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a *******.********
20870 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20880 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 76 66 73 **** sqlite3_vfs
20890 20 6d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a methods *******
208a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208b0 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73 *****.**.** This
208c0 20 64 69 76 69 73 69 6f 6e 20 63 6f 6e 74 61 69 division contai
208d0 6e 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 ns the implement
208e0 61 74 69 6f 6e 20 6f 66 20 6d 65 74 68 6f 64 73 ation of methods
208f0 20 6f 6e 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 on the.** sqlit
20900 65 33 5f 76 66 73 20 6f 62 6a 65 63 74 2e 0a 2a e3_vfs object..*
20910 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c /../*.** Initial
20920 69 7a 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 ize the contents
20930 20 6f 66 20 74 68 65 20 75 6e 69 78 46 69 6c 65 of the unixFile
20940 20 73 74 72 75 63 74 75 72 65 20 70 6f 69 6e 74 structure point
20950 65 64 20 74 6f 20 62 79 20 70 49 64 2e 0a 2a 2f ed to by pId..*/
20960 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69 6c 6c .static int fill
20970 49 6e 55 6e 69 78 46 69 6c 65 28 0a 20 20 73 71 InUnixFile(. sq
20980 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c lite3_vfs *pVfs,
20990 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
209a0 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74 20 2a to vfs object *
209b0 2f 0a 20 20 69 6e 74 20 68 2c 20 20 20 20 20 20 /. int h,
209c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
209d0 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 pen file descrip
209e0 74 6f 72 20 6f 66 20 66 69 6c 65 20 62 65 69 6e tor of file bein
209f0 67 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 69 6e g opened */. in
20a00 74 20 64 69 72 66 64 2c 20 20 20 20 20 20 20 20 t dirfd,
20a10 20 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 6f /* Directo
20a20 72 79 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 ry file descript
20a30 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f or */. sqlite3_
20a40 66 69 6c 65 20 2a 70 49 64 2c 20 20 20 20 20 20 file *pId,
20a50 2f 2a 20 57 72 69 74 65 20 74 6f 20 74 68 65 20 /* Write to the
20a60 75 6e 69 78 46 69 6c 65 20 73 74 72 75 63 74 75 unixFile structu
20a70 72 65 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e re here */. con
20a80 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 st char *zFilena
20a90 6d 65 2c 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 me, /* Name of
20aa0 74 68 65 20 66 69 6c 65 20 62 65 69 6e 67 20 6f the file being o
20ab0 70 65 6e 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e pened */. int n
20ac0 6f 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 oLock,
20ad0 20 20 20 2f 2a 20 4f 6d 69 74 20 6c 6f 63 6b 69 /* Omit locki
20ae0 6e 67 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 20 ng if true */.
20af0 69 6e 74 20 69 73 44 65 6c 65 74 65 20 20 20 20 int isDelete
20b00 20 20 20 20 20 20 20 20 2f 2a 20 44 65 6c 65 74 /* Delet
20b10 65 20 6f 6e 20 63 6c 6f 73 65 20 69 66 20 74 72 e on close if tr
20b20 75 65 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 ue */.){. const
20b30 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 sqlite3_io_meth
20b40 6f 64 73 20 2a 70 4c 6f 63 6b 69 6e 67 53 74 79 ods *pLockingSty
20b50 6c 65 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a le;. unixFile *
20b60 70 4e 65 77 20 3d 20 28 75 6e 69 78 46 69 6c 65 pNew = (unixFile
20b70 20 2a 29 70 49 64 3b 0a 20 20 69 6e 74 20 72 63 *)pId;. int rc
20b80 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 = SQLITE_OK;..
20b90 20 61 73 73 65 72 74 28 20 70 4e 65 77 2d 3e 70 assert( pNew->p
20ba0 49 6e 6f 64 65 3d 3d 4e 55 4c 4c 20 29 3b 0a 0a Inode==NULL );..
20bb0 20 20 2f 2a 20 50 61 72 61 6d 65 74 65 72 20 69 /* Parameter i
20bc0 73 44 65 6c 65 74 65 20 69 73 20 6f 6e 6c 79 20 sDelete is only
20bd0 75 73 65 64 20 6f 6e 20 76 78 77 6f 72 6b 73 2e used on vxworks.
20be0 20 45 78 70 72 65 73 73 20 74 68 69 73 20 65 78 Express this ex
20bf0 70 6c 69 63 69 74 6c 79 20 0a 20 20 2a 2a 20 68 plicitly . ** h
20c00 65 72 65 20 74 6f 20 70 72 65 76 65 6e 74 20 63 ere to prevent c
20c10 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e 67 73 ompiler warnings
20c20 20 61 62 6f 75 74 20 75 6e 75 73 65 64 20 70 61 about unused pa
20c30 72 61 6d 65 74 65 72 73 2e 0a 20 20 2a 2f 0a 20 rameters.. */.
20c40 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
20c50 52 28 69 73 44 65 6c 65 74 65 29 3b 0a 0a 20 20 R(isDelete);..
20c60 4f 53 54 52 41 43 45 28 28 22 4f 50 45 4e 20 20 OSTRACE(("OPEN
20c70 20 20 25 2d 33 64 20 25 73 5c 6e 22 2c 20 68 2c %-3d %s\n", h,
20c80 20 7a 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 zFilename));.
20c90 70 4e 65 77 2d 3e 68 20 3d 20 68 3b 0a 20 20 70 pNew->h = h;. p
20ca0 4e 65 77 2d 3e 64 69 72 66 64 20 3d 20 64 69 72 New->dirfd = dir
20cb0 66 64 3b 0a 20 20 70 4e 65 77 2d 3e 66 69 6c 65 fd;. pNew->file
20cc0 46 6c 61 67 73 20 3d 20 30 3b 0a 20 20 61 73 73 Flags = 0;. ass
20cd0 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d ert( zFilename==
20ce0 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 0 || zFilename[0
20cf0 5d 3d 3d 27 2f 27 20 29 3b 20 20 2f 2a 20 4e 65 ]=='/' ); /* Ne
20d00 76 65 72 20 61 20 72 65 6c 61 74 69 76 65 20 70 ver a relative p
20d10 61 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 70 4e 65 athname */. pNe
20d20 77 2d 3e 7a 50 61 74 68 20 3d 20 7a 46 69 6c 65 w->zPath = zFile
20d30 6e 61 6d 65 3b 0a 0a 23 69 66 20 4f 53 5f 56 58 name;..#if OS_VX
20d40 57 4f 52 4b 53 0a 20 20 70 4e 65 77 2d 3e 70 49 WORKS. pNew->pI
20d50 64 20 3d 20 76 78 77 6f 72 6b 73 46 69 6e 64 46 d = vxworksFindF
20d60 69 6c 65 49 64 28 7a 46 69 6c 65 6e 61 6d 65 29 ileId(zFilename)
20d70 3b 0a 20 20 69 66 28 20 70 4e 65 77 2d 3e 70 49 ;. if( pNew->pI
20d80 64 3d 3d 30 20 29 7b 0a 20 20 20 20 6e 6f 4c 6f d==0 ){. noLo
20d90 63 6b 20 3d 20 31 3b 0a 20 20 20 20 72 63 20 3d ck = 1;. rc =
20da0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 SQLITE_NOMEM;.
20db0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 }.#endif.. if(
20dc0 20 6e 6f 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 70 noLock ){. p
20dd0 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d 20 26 LockingStyle = &
20de0 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b nolockIoMethods;
20df0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4c . }else{. pL
20e00 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d 20 28 2a ockingStyle = (*
20e10 2a 28 66 69 6e 64 65 72 5f 74 79 70 65 2a 29 70 *(finder_type*)p
20e20 56 66 73 2d 3e 70 41 70 70 44 61 74 61 29 28 7a Vfs->pAppData)(z
20e30 46 69 6c 65 6e 61 6d 65 2c 20 70 4e 65 77 29 3b Filename, pNew);
20e40 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 .#if SQLITE_ENAB
20e50 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
20e60 0a 20 20 20 20 2f 2a 20 43 61 63 68 65 20 7a 46 . /* Cache zF
20e70 69 6c 65 6e 61 6d 65 20 69 6e 20 74 68 65 20 6c ilename in the l
20e80 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 20 28 ocking context (
20e90 41 46 50 20 61 6e 64 20 64 6f 74 6c 6f 63 6b 20 AFP and dotlock
20ea0 6f 76 65 72 72 69 64 65 29 20 66 6f 72 0a 20 20 override) for.
20eb0 20 20 2a 2a 20 70 72 6f 78 79 4c 6f 63 6b 20 61 ** proxyLock a
20ec0 63 74 69 76 61 74 69 6f 6e 20 69 73 20 70 6f 73 ctivation is pos
20ed0 73 69 62 6c 65 20 28 72 65 6d 6f 74 65 20 70 72 sible (remote pr
20ee0 6f 78 79 20 69 73 20 62 61 73 65 64 20 6f 6e 20 oxy is based on
20ef0 64 62 20 6e 61 6d 65 29 0a 20 20 20 20 2a 2a 20 db name). **
20f00 7a 46 69 6c 65 6e 61 6d 65 20 72 65 6d 61 69 6e zFilename remain
20f10 73 20 76 61 6c 69 64 20 75 6e 74 69 6c 20 66 69 s valid until fi
20f20 6c 65 20 69 73 20 63 6c 6f 73 65 64 2c 20 74 6f le is closed, to
20f30 20 73 75 70 70 6f 72 74 20 2a 2f 0a 20 20 20 20 support */.
20f40 70 4e 65 77 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e pNew->lockingCon
20f50 74 65 78 74 20 3d 20 28 76 6f 69 64 2a 29 7a 46 text = (void*)zF
20f60 69 6c 65 6e 61 6d 65 3b 0a 23 65 6e 64 69 66 0a ilename;.#endif.
20f70 20 20 7d 0a 0a 20 20 69 66 28 20 70 4c 6f 63 6b }.. if( pLock
20f80 69 6e 67 53 74 79 6c 65 20 3d 3d 20 26 70 6f 73 ingStyle == &pos
20f90 69 78 49 6f 4d 65 74 68 6f 64 73 0a 23 69 66 20 ixIoMethods.#if
20fa0 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f defined(__APPLE_
20fb0 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 _) && SQLITE_ENA
20fc0 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c BLE_LOCKING_STYL
20fd0 45 0a 20 20 20 20 7c 7c 20 70 4c 6f 63 6b 69 6e E. || pLockin
20fe0 67 53 74 79 6c 65 20 3d 3d 20 26 6e 66 73 49 6f gStyle == &nfsIo
20ff0 4d 65 74 68 6f 64 73 0a 23 65 6e 64 69 66 0a 20 Methods.#endif.
21000 20 29 7b 0a 20 20 20 20 75 6e 69 78 45 6e 74 65 ){. unixEnte
21010 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 72 63 rMutex();. rc
21020 20 3d 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f = findInodeInfo
21030 28 70 4e 65 77 2c 20 26 70 4e 65 77 2d 3e 70 49 (pNew, &pNew->pI
21040 6e 6f 64 65 29 3b 0a 20 20 20 20 69 66 28 20 72 node);. if( r
21050 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
21060 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6e 20 65 /* If an e
21070 72 72 6f 72 20 6f 63 63 75 72 65 64 20 69 6e 20 rror occured in
21080 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 29 2c findInodeInfo(),
21090 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 close the file
210a0 64 65 73 63 72 69 70 74 6f 72 0a 20 20 20 20 20 descriptor.
210b0 20 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 2c ** immediately,
210c0 20 62 65 66 6f 72 65 20 72 65 6c 65 61 73 69 6e before releasin
210d0 67 20 74 68 65 20 6d 75 74 65 78 2e 20 66 69 6e g the mutex. fin
210e0 64 49 6e 6f 64 65 49 6e 66 6f 28 29 20 6d 61 79 dInodeInfo() may
210f0 20 66 61 69 6c 0a 20 20 20 20 20 20 2a 2a 20 69 fail. ** i
21100 6e 20 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 3a n two scenarios:
21110 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 . **.
21120 2a 2a 20 20 20 28 61 29 20 41 20 63 61 6c 6c 20 ** (a) A call
21130 74 6f 20 66 73 74 61 74 28 29 20 66 61 69 6c 65 to fstat() faile
21140 64 2e 0a 20 20 20 20 20 20 2a 2a 20 20 20 28 62 d.. ** (b
21150 29 20 41 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 65 ) A malloc faile
21160 64 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 d.. **.
21170 20 20 2a 2a 20 53 63 65 6e 61 72 69 6f 20 28 62 ** Scenario (b
21180 29 20 6d 61 79 20 6f 6e 6c 79 20 6f 63 63 75 72 ) may only occur
21190 20 69 66 20 74 68 65 20 70 72 6f 63 65 73 73 20 if the process
211a0 69 73 20 68 6f 6c 64 69 6e 67 20 6e 6f 20 6f 74 is holding no ot
211b0 68 65 72 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c her. ** fil
211c0 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 6f 70 e descriptors op
211d0 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 66 en on the same f
211e0 69 6c 65 2e 20 49 66 20 74 68 65 72 65 20 77 65 ile. If there we
211f0 72 65 20 6f 74 68 65 72 20 66 69 6c 65 0a 20 20 re other file.
21200 20 20 20 20 2a 2a 20 64 65 73 63 72 69 70 74 6f ** descripto
21210 72 73 20 6f 6e 20 74 68 69 73 20 66 69 6c 65 2c rs on this file,
21220 20 74 68 65 6e 20 6e 6f 20 6d 61 6c 6c 6f 63 20 then no malloc
21230 77 6f 75 6c 64 20 62 65 20 72 65 71 75 69 72 65 would be require
21240 64 20 62 79 0a 20 20 20 20 20 20 2a 2a 20 66 69 d by. ** fi
21250 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 29 2e 20 49 ndInodeInfo(). I
21260 66 20 74 68 69 73 20 69 73 20 74 68 65 20 63 61 f this is the ca
21270 73 65 2c 20 69 74 20 69 73 20 71 75 69 74 65 20 se, it is quite
21280 73 61 66 65 20 74 6f 20 63 6c 6f 73 65 0a 20 20 safe to close.
21290 20 20 20 20 2a 2a 20 68 61 6e 64 6c 65 20 68 20 ** handle h
212a0 2d 20 61 73 20 69 74 20 69 73 20 67 75 61 72 61 - as it is guara
212b0 6e 74 65 65 64 20 74 68 61 74 20 6e 6f 20 70 6f nteed that no po
212c0 73 69 78 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 62 six locks will b
212d0 65 20 72 65 6c 65 61 73 65 64 0a 20 20 20 20 20 e released.
212e0 20 2a 2a 20 62 79 20 64 6f 69 6e 67 20 73 6f 2e ** by doing so.
212f0 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 . **.
21300 2a 2a 20 49 66 20 73 63 65 6e 61 72 69 6f 20 28 ** If scenario (
21310 61 29 20 63 61 75 73 65 64 20 74 68 65 20 65 72 a) caused the er
21320 72 6f 72 20 74 68 65 6e 20 74 68 69 6e 67 73 20 ror then things
21330 61 72 65 20 6e 6f 74 20 73 6f 20 73 61 66 65 2e are not so safe.
21340 20 54 68 65 0a 20 20 20 20 20 20 2a 2a 20 69 6d The. ** im
21350 70 6c 69 63 69 74 20 61 73 73 75 6d 70 74 69 6f plicit assumptio
21360 6e 20 68 65 72 65 20 69 73 20 74 68 61 74 20 69 n here is that i
21370 66 20 66 73 74 61 74 28 29 20 66 61 69 6c 73 2c f fstat() fails,
21380 20 74 68 69 6e 67 73 20 61 72 65 20 69 6e 0a 20 things are in.
21390 20 20 20 20 20 2a 2a 20 73 75 63 68 20 62 61 64 ** such bad
213a0 20 73 68 61 70 65 20 74 68 61 74 20 64 72 6f 70 shape that drop
213b0 70 69 6e 67 20 61 20 6c 6f 63 6b 20 6f 72 20 74 ping a lock or t
213c0 77 6f 20 64 6f 65 73 6e 27 74 20 6d 61 74 74 65 wo doesn't matte
213d0 72 20 6d 75 63 68 2e 0a 20 20 20 20 20 20 2a 2f r much.. */
213e0 0a 20 20 20 20 20 20 63 6c 6f 73 65 28 68 29 3b . close(h);
213f0 0a 20 20 20 20 20 20 68 20 3d 20 2d 31 3b 0a 20 . h = -1;.
21400 20 20 20 7d 0a 20 20 20 20 75 6e 69 78 4c 65 61 }. unixLea
21410 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 7d 0a 0a veMutex();. }..
21420 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c #if SQLITE_ENABL
21430 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 E_LOCKING_STYLE
21440 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 && defined(__APP
21450 4c 45 5f 5f 29 0a 20 20 65 6c 73 65 20 69 66 28 LE__). else if(
21460 20 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d pLockingStyle =
21470 3d 20 26 61 66 70 49 6f 4d 65 74 68 6f 64 73 20 = &afpIoMethods
21480 29 7b 0a 20 20 20 20 2f 2a 20 41 46 50 20 6c 6f ){. /* AFP lo
21490 63 6b 69 6e 67 20 75 73 65 73 20 74 68 65 20 66 cking uses the f
214a0 69 6c 65 20 70 61 74 68 20 73 6f 20 69 74 20 6e ile path so it n
214b0 65 65 64 73 20 74 6f 20 62 65 20 69 6e 63 6c 75 eeds to be inclu
214c0 64 65 64 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 ded in. ** th
214d0 65 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 e afpLockingCont
214e0 65 78 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ext.. */.
214f0 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 afpLockingContex
21500 74 20 2a 70 43 74 78 3b 0a 20 20 20 20 70 4e 65 t *pCtx;. pNe
21510 77 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 w->lockingContex
21520 74 20 3d 20 70 43 74 78 20 3d 20 73 71 6c 69 74 t = pCtx = sqlit
21530 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f e3_malloc( sizeo
21540 66 28 2a 70 43 74 78 29 20 29 3b 0a 20 20 20 20 f(*pCtx) );.
21550 69 66 28 20 70 43 74 78 3d 3d 30 20 29 7b 0a 20 if( pCtx==0 ){.
21560 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
21570 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c 73 _NOMEM;. }els
21580 65 7b 0a 20 20 20 20 20 20 2f 2a 20 4e 42 3a 20 e{. /* NB:
21590 7a 46 69 6c 65 6e 61 6d 65 20 65 78 69 73 74 73 zFilename exists
215a0 20 61 6e 64 20 72 65 6d 61 69 6e 73 20 76 61 6c and remains val
215b0 69 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 6c id until the fil
215c0 65 20 69 73 20 63 6c 6f 73 65 64 0a 20 20 20 20 e is closed.
215d0 20 20 2a 2a 20 61 63 63 6f 72 64 69 6e 67 20 74 ** according t
215e0 6f 20 72 65 71 75 69 72 65 6d 65 6e 74 20 46 31 o requirement F1
215f0 31 31 34 31 2e 20 20 53 6f 20 77 65 20 64 6f 20 1141. So we do
21600 6e 6f 74 20 6e 65 65 64 20 74 6f 20 6d 61 6b 65 not need to make
21610 20 61 0a 20 20 20 20 20 20 2a 2a 20 63 6f 70 79 a. ** copy
21620 20 6f 66 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 of the filename
21630 2e 20 2a 2f 0a 20 20 20 20 20 20 70 43 74 78 2d . */. pCtx-
21640 3e 64 62 50 61 74 68 20 3d 20 7a 46 69 6c 65 6e >dbPath = zFilen
21650 61 6d 65 3b 0a 20 20 20 20 20 20 70 43 74 78 2d ame;. pCtx-
21660 3e 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a 20 >reserved = 0;.
21670 20 20 20 20 20 73 72 61 6e 64 6f 6d 64 65 76 28 srandomdev(
21680 29 3b 0a 20 20 20 20 20 20 75 6e 69 78 45 6e 74 );. unixEnt
21690 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 20 erMutex();.
216a0 20 72 63 20 3d 20 66 69 6e 64 49 6e 6f 64 65 49 rc = findInodeI
216b0 6e 66 6f 28 70 4e 65 77 2c 20 26 70 4e 65 77 2d nfo(pNew, &pNew-
216c0 3e 70 49 6e 6f 64 65 29 3b 0a 20 20 20 20 20 20 >pInode);.
216d0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
216e0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c K ){. sql
216f0 69 74 65 33 5f 66 72 65 65 28 70 4e 65 77 2d 3e ite3_free(pNew->
21700 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 29 3b lockingContext);
21710 0a 20 20 20 20 20 20 20 20 63 6c 6f 73 65 28 68 . close(h
21720 29 3b 0a 20 20 20 20 20 20 20 20 68 20 3d 20 2d );. h = -
21730 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 1;. }.
21740 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
21750 29 3b 20 20 20 20 20 20 20 20 0a 20 20 20 20 7d ); . }
21760 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 65 . }.#endif.. e
21770 6c 73 65 20 69 66 28 20 70 4c 6f 63 6b 69 6e 67 lse if( pLocking
21780 53 74 79 6c 65 20 3d 3d 20 26 64 6f 74 6c 6f 63 Style == &dotloc
21790 6b 49 6f 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 kIoMethods ){.
217a0 20 20 2f 2a 20 44 6f 74 66 69 6c 65 20 6c 6f 63 /* Dotfile loc
217b0 6b 69 6e 67 20 75 73 65 73 20 74 68 65 20 66 69 king uses the fi
217c0 6c 65 20 70 61 74 68 20 73 6f 20 69 74 20 6e 65 le path so it ne
217d0 65 64 73 20 74 6f 20 62 65 20 69 6e 63 6c 75 64 eds to be includ
217e0 65 64 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 ed in. ** the
217f0 20 64 6f 74 6c 6f 63 6b 4c 6f 63 6b 69 6e 67 43 dotlockLockingC
21800 6f 6e 74 65 78 74 20 0a 20 20 20 20 2a 2f 0a 20 ontext . */.
21810 20 20 20 63 68 61 72 20 2a 7a 4c 6f 63 6b 46 69 char *zLockFi
21820 6c 65 3b 0a 20 20 20 20 69 6e 74 20 6e 46 69 6c le;. int nFil
21830 65 6e 61 6d 65 3b 0a 20 20 20 20 6e 46 69 6c 65 ename;. nFile
21840 6e 61 6d 65 20 3d 20 28 69 6e 74 29 73 74 72 6c name = (int)strl
21850 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 en(zFilename) +
21860 36 3b 0a 20 20 20 20 7a 4c 6f 63 6b 46 69 6c 65 6;. zLockFile
21870 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74 = (char *)sqlit
21880 65 33 5f 6d 61 6c 6c 6f 63 28 6e 46 69 6c 65 6e e3_malloc(nFilen
21890 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 7a 4c ame);. if( zL
218a0 6f 63 6b 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 ockFile==0 ){.
218b0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
218c0 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c 73 65 NOMEM;. }else
218d0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f {. sqlite3_
218e0 73 6e 70 72 69 6e 74 66 28 6e 46 69 6c 65 6e 61 snprintf(nFilena
218f0 6d 65 2c 20 7a 4c 6f 63 6b 46 69 6c 65 2c 20 22 me, zLockFile, "
21900 25 73 22 20 44 4f 54 4c 4f 43 4b 5f 53 55 46 46 %s" DOTLOCK_SUFF
21910 49 58 2c 20 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a IX, zFilename);.
21920 20 20 20 20 7d 0a 20 20 20 20 70 4e 65 77 2d 3e }. pNew->
21930 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 3d lockingContext =
21940 20 7a 4c 6f 63 6b 46 69 6c 65 3b 0a 20 20 7d 0a zLockFile;. }.
21950 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a .#if OS_VXWORKS.
21960 20 20 65 6c 73 65 20 69 66 28 20 70 4c 6f 63 6b else if( pLock
21970 69 6e 67 53 74 79 6c 65 20 3d 3d 20 26 73 65 6d ingStyle == &sem
21980 49 6f 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 IoMethods ){.
21990 20 2f 2a 20 4e 61 6d 65 64 20 73 65 6d 61 70 68 /* Named semaph
219a0 6f 72 65 20 6c 6f 63 6b 69 6e 67 20 75 73 65 73 ore locking uses
219b0 20 74 68 65 20 66 69 6c 65 20 70 61 74 68 20 73 the file path s
219c0 6f 20 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 o it needs to be
219d0 0a 20 20 20 20 2a 2a 20 69 6e 63 6c 75 64 65 64 . ** included
219e0 20 69 6e 20 74 68 65 20 73 65 6d 4c 6f 63 6b 69 in the semLocki
219f0 6e 67 43 6f 6e 74 65 78 74 0a 20 20 20 20 2a 2f ngContext. */
21a00 0a 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 . unixEnterMu
21a10 74 65 78 28 29 3b 0a 20 20 20 20 72 63 20 3d 20 tex();. rc =
21a20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 70 4e findInodeInfo(pN
21a30 65 77 2c 20 26 70 4e 65 77 2d 3e 70 49 6e 6f 64 ew, &pNew->pInod
21a40 65 29 3b 0a 20 20 20 20 69 66 28 20 28 72 63 3d e);. if( (rc=
21a50 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 26 26 20 28 =SQLITE_OK) && (
21a60 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 pNew->pInode->pS
21a70 65 6d 3d 3d 4e 55 4c 4c 29 20 29 7b 0a 20 20 20 em==NULL) ){.
21a80 20 20 20 63 68 61 72 20 2a 7a 53 65 6d 4e 61 6d char *zSemNam
21a90 65 20 3d 20 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 e = pNew->pInode
21aa0 2d 3e 61 53 65 6d 4e 61 6d 65 3b 0a 20 20 20 20 ->aSemName;.
21ab0 20 20 69 6e 74 20 6e 3b 0a 20 20 20 20 20 20 73 int n;. s
21ac0 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 qlite3_snprintf(
21ad0 4d 41 58 5f 50 41 54 48 4e 41 4d 45 2c 20 7a 53 MAX_PATHNAME, zS
21ae0 65 6d 4e 61 6d 65 2c 20 22 2f 25 73 2e 73 65 6d emName, "/%s.sem
21af0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
21b00 20 20 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e pNew->
21b10 70 49 64 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e pId->zCanonicalN
21b20 61 6d 65 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 ame);. for(
21b30 20 6e 3d 31 3b 20 7a 53 65 6d 4e 61 6d 65 5b 6e n=1; zSemName[n
21b40 5d 3b 20 6e 2b 2b 20 29 0a 20 20 20 20 20 20 20 ]; n++ ).
21b50 20 69 66 28 20 7a 53 65 6d 4e 61 6d 65 5b 6e 5d if( zSemName[n]
21b60 3d 3d 27 2f 27 20 29 20 7a 53 65 6d 4e 61 6d 65 =='/' ) zSemName
21b70 5b 6e 5d 20 3d 20 27 5f 27 3b 0a 20 20 20 20 20 [n] = '_';.
21b80 20 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 2d 3e 70 pNew->pInode->p
21b90 53 65 6d 20 3d 20 73 65 6d 5f 6f 70 65 6e 28 7a Sem = sem_open(z
21ba0 53 65 6d 4e 61 6d 65 2c 20 4f 5f 43 52 45 41 54 SemName, O_CREAT
21bb0 2c 20 30 36 36 36 2c 20 31 29 3b 0a 20 20 20 20 , 0666, 1);.
21bc0 20 20 69 66 28 20 70 4e 65 77 2d 3e 70 49 6e 6f if( pNew->pIno
21bd0 64 65 2d 3e 70 53 65 6d 20 3d 3d 20 53 45 4d 5f de->pSem == SEM_
21be0 46 41 49 4c 45 44 20 29 7b 0a 20 20 20 20 20 20 FAILED ){.
21bf0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
21c00 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 MEM;. pNe
21c10 77 2d 3e 70 49 6e 6f 64 65 2d 3e 61 53 65 6d 4e w->pInode->aSemN
21c20 61 6d 65 5b 30 5d 20 3d 20 27 5c 30 27 3b 0a 20 ame[0] = '\0';.
21c30 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
21c40 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
21c50 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 );. }.#endif.
21c60 0a 20 20 70 4e 65 77 2d 3e 6c 61 73 74 45 72 72 . pNew->lastErr
21c70 6e 6f 20 3d 20 30 3b 0a 23 69 66 20 4f 53 5f 56 no = 0;.#if OS_V
21c80 58 57 4f 52 4b 53 0a 20 20 69 66 28 20 72 63 21 XWORKS. if( rc!
21c90 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
21ca0 20 20 69 66 28 20 68 3e 3d 30 20 29 20 63 6c 6f if( h>=0 ) clo
21cb0 73 65 28 68 29 3b 0a 20 20 20 20 68 20 3d 20 2d se(h);. h = -
21cc0 31 3b 0a 20 20 20 20 75 6e 6c 69 6e 6b 28 7a 46 1;. unlink(zF
21cd0 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 69 73 ilename);. is
21ce0 44 65 6c 65 74 65 20 3d 20 30 3b 0a 20 20 7d 0a Delete = 0;. }.
21cf0 20 20 70 4e 65 77 2d 3e 69 73 44 65 6c 65 74 65 pNew->isDelete
21d00 20 3d 20 69 73 44 65 6c 65 74 65 3b 0a 23 65 6e = isDelete;.#en
21d10 64 69 66 0a 20 20 69 66 28 20 72 63 21 3d 53 51 dif. if( rc!=SQ
21d20 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
21d30 66 28 20 64 69 72 66 64 3e 3d 30 20 29 20 63 6c f( dirfd>=0 ) cl
21d40 6f 73 65 28 64 69 72 66 64 29 3b 20 2f 2a 20 73 ose(dirfd); /* s
21d50 69 6c 65 6e 74 20 6c 65 61 6b 20 69 66 20 66 61 ilent leak if fa
21d60 69 6c 2c 20 61 6c 72 65 61 64 79 20 69 6e 20 65 il, already in e
21d70 72 72 6f 72 20 2a 2f 0a 20 20 20 20 69 66 28 20 rror */. if(
21d80 68 3e 3d 30 20 29 20 63 6c 6f 73 65 28 68 29 3b h>=0 ) close(h);
21d90 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e . }else{. pN
21da0 65 77 2d 3e 70 4d 65 74 68 6f 64 20 3d 20 70 4c ew->pMethod = pL
21db0 6f 63 6b 69 6e 67 53 74 79 6c 65 3b 0a 20 20 20 ockingStyle;.
21dc0 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 2b 31 29 OpenCounter(+1)
21dd0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
21de0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e c;.}../*.** Open
21df0 20 61 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 a file descript
21e00 6f 72 20 74 6f 20 74 68 65 20 64 69 72 65 63 74 or to the direct
21e10 6f 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 66 ory containing f
21e20 69 6c 65 20 7a 46 69 6c 65 6e 61 6d 65 2e 0a 2a ile zFilename..*
21e30 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c * If successful,
21e40 20 2a 70 46 64 20 69 73 20 73 65 74 20 74 6f 20 *pFd is set to
21e50 74 68 65 20 6f 70 65 6e 65 64 20 66 69 6c 65 20 the opened file
21e60 64 65 73 63 72 69 70 74 6f 72 20 61 6e 64 0a 2a descriptor and.*
21e70 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 * SQLITE_OK is r
21e80 65 74 75 72 6e 65 64 2e 20 49 66 20 61 6e 20 65 eturned. If an e
21e90 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 65 69 74 rror occurs, eit
21ea0 68 65 72 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d her SQLITE_NOMEM
21eb0 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 5f 43 41 .** or SQLITE_CA
21ec0 4e 54 4f 50 45 4e 20 69 73 20 72 65 74 75 72 6e NTOPEN is return
21ed0 65 64 20 61 6e 64 20 2a 70 46 64 20 69 73 20 73 ed and *pFd is s
21ee0 65 74 20 74 6f 20 61 6e 20 75 6e 64 65 66 69 6e et to an undefin
21ef0 65 64 0a 2a 2a 20 76 61 6c 75 65 2e 0a 2a 2a 0a ed.** value..**.
21f00 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 4f 4b 20 ** If SQLITE_OK
21f10 69 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 is returned, the
21f20 20 63 61 6c 6c 65 72 20 69 73 20 72 65 73 70 6f caller is respo
21f30 6e 73 69 62 6c 65 20 66 6f 72 20 63 6c 6f 73 69 nsible for closi
21f40 6e 67 0a 2a 2a 20 74 68 65 20 66 69 6c 65 20 64 ng.** the file d
21f50 65 73 63 72 69 70 74 6f 72 20 2a 70 46 64 20 75 escriptor *pFd u
21f60 73 69 6e 67 20 63 6c 6f 73 65 28 29 2e 0a 2a 2f sing close()..*/
21f70 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 65 6e .static int open
21f80 44 69 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 Directory(const
21f90 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c char *zFilename,
21fa0 20 69 6e 74 20 2a 70 46 64 29 7b 0a 20 20 69 6e int *pFd){. in
21fb0 74 20 69 69 3b 0a 20 20 69 6e 74 20 66 64 20 3d t ii;. int fd =
21fc0 20 2d 31 3b 0a 20 20 63 68 61 72 20 7a 44 69 72 -1;. char zDir
21fd0 6e 61 6d 65 5b 4d 41 58 5f 50 41 54 48 4e 41 4d name[MAX_PATHNAM
21fe0 45 2b 31 5d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 E+1];.. sqlite3
21ff0 5f 73 6e 70 72 69 6e 74 66 28 4d 41 58 5f 50 41 _snprintf(MAX_PA
22000 54 48 4e 41 4d 45 2c 20 7a 44 69 72 6e 61 6d 65 THNAME, zDirname
22010 2c 20 22 25 73 22 2c 20 7a 46 69 6c 65 6e 61 6d , "%s", zFilenam
22020 65 29 3b 0a 20 20 66 6f 72 28 69 69 3d 28 69 6e e);. for(ii=(in
22030 74 29 73 74 72 6c 65 6e 28 7a 44 69 72 6e 61 6d t)strlen(zDirnam
22040 65 29 3b 20 69 69 3e 31 20 26 26 20 7a 44 69 72 e); ii>1 && zDir
22050 6e 61 6d 65 5b 69 69 5d 21 3d 27 2f 27 3b 20 69 name[ii]!='/'; i
22060 69 2d 2d 29 3b 0a 20 20 69 66 28 20 69 69 3e 30 i--);. if( ii>0
22070 20 29 7b 0a 20 20 20 20 7a 44 69 72 6e 61 6d 65 ){. zDirname
22080 5b 69 69 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 [ii] = '\0';.
22090 20 66 64 20 3d 20 6f 70 65 6e 28 7a 44 69 72 6e fd = open(zDirn
220a0 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f ame, O_RDONLY|O_
220b0 42 49 4e 41 52 59 2c 20 30 29 3b 0a 20 20 20 20 BINARY, 0);.
220c0 69 66 28 20 66 64 3e 3d 30 20 29 7b 0a 23 69 66 if( fd>=0 ){.#if
220d0 64 65 66 20 46 44 5f 43 4c 4f 45 58 45 43 0a 20 def FD_CLOEXEC.
220e0 20 20 20 20 20 66 63 6e 74 6c 28 66 64 2c 20 46 fcntl(fd, F
220f0 5f 53 45 54 46 44 2c 20 66 63 6e 74 6c 28 66 64 _SETFD, fcntl(fd
22100 2c 20 46 5f 47 45 54 46 44 2c 20 30 29 20 7c 20 , F_GETFD, 0) |
22110 46 44 5f 43 4c 4f 45 58 45 43 29 3b 0a 23 65 6e FD_CLOEXEC);.#en
22120 64 69 66 0a 20 20 20 20 20 20 4f 53 54 52 41 43 dif. OSTRAC
22130 45 28 28 22 4f 50 45 4e 44 49 52 20 25 2d 33 64 E(("OPENDIR %-3d
22140 20 25 73 5c 6e 22 2c 20 66 64 2c 20 7a 44 69 72 %s\n", fd, zDir
22150 6e 61 6d 65 29 29 3b 0a 20 20 20 20 7d 0a 20 20 name));. }.
22160 7d 0a 20 20 2a 70 46 64 20 3d 20 66 64 3b 0a 20 }. *pFd = fd;.
22170 20 72 65 74 75 72 6e 20 28 66 64 3e 3d 30 3f 53 return (fd>=0?S
22180 51 4c 49 54 45 5f 4f 4b 3a 53 51 4c 49 54 45 5f QLITE_OK:SQLITE_
22190 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 29 3b 0a CANTOPEN_BKPT);.
221a0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 }../*.** Create
221b0 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 a temporary file
221c0 20 6e 61 6d 65 20 69 6e 20 7a 42 75 66 2e 20 20 name in zBuf.
221d0 7a 42 75 66 20 6d 75 73 74 20 62 65 20 61 6c 6c zBuf must be all
221e0 6f 63 61 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 ocated.** by the
221f0 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 calling process
22200 20 61 6e 64 20 6d 75 73 74 20 62 65 20 62 69 67 and must be big
22210 20 65 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 enough to hold
22220 61 74 20 6c 65 61 73 74 0a 2a 2a 20 70 56 66 73 at least.** pVfs
22230 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 20 62 79 74 ->mxPathname byt
22240 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e es..*/.static in
22250 74 20 67 65 74 54 65 6d 70 6e 61 6d 65 28 69 6e t getTempname(in
22260 74 20 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a 42 t nBuf, char *zB
22270 75 66 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f uf){. static co
22280 6e 73 74 20 63 68 61 72 20 2a 61 7a 44 69 72 73 nst char *azDirs
22290 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 30 2c 0a 20 [] = {. 0,.
222a0 20 20 20 20 30 2c 0a 20 20 20 20 20 22 2f 76 61 0,. "/va
222b0 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f 75 r/tmp",. "/u
222c0 73 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f sr/tmp",. "/
222d0 74 6d 70 22 2c 0a 20 20 20 20 20 22 2e 22 2c 0a tmp",. ".",.
222e0 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f };. static co
222f0 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 nst unsigned cha
22300 72 20 7a 43 68 61 72 73 5b 5d 20 3d 0a 20 20 20 r zChars[] =.
22310 20 22 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e "abcdefghijklmn
22320 6f 70 71 72 73 74 75 76 77 78 79 7a 22 0a 20 20 opqrstuvwxyz".
22330 20 20 22 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d "ABCDEFGHIJKLM
22340 4e 4f 50 51 52 53 54 55 56 57 58 59 5a 22 0a 20 NOPQRSTUVWXYZ".
22350 20 20 20 22 30 31 32 33 34 35 36 37 38 39 22 3b "0123456789";
22360 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
22370 69 2c 20 6a 3b 0a 20 20 73 74 72 75 63 74 20 73 i, j;. struct s
22380 74 61 74 20 62 75 66 3b 0a 20 20 63 6f 6e 73 74 tat buf;. const
22390 20 63 68 61 72 20 2a 7a 44 69 72 20 3d 20 22 2e char *zDir = ".
223a0 22 3b 0a 0a 20 20 2f 2a 20 49 74 27 73 20 6f 64 ";.. /* It's od
223b0 64 20 74 6f 20 73 69 6d 75 6c 61 74 65 20 61 6e d to simulate an
223c0 20 69 6f 2d 65 72 72 6f 72 20 68 65 72 65 2c 20 io-error here,
223d0 62 75 74 20 72 65 61 6c 6c 79 20 74 68 69 73 20 but really this
223e0 69 73 20 6a 75 73 74 0a 20 20 2a 2a 20 75 73 69 is just. ** usi
223f0 6e 67 20 74 68 65 20 69 6f 2d 65 72 72 6f 72 20 ng the io-error
22400 69 6e 66 72 61 73 74 72 75 63 74 75 72 65 20 74 infrastructure t
22410 6f 20 74 65 73 74 20 74 68 61 74 20 53 51 4c 69 o test that SQLi
22420 74 65 20 68 61 6e 64 6c 65 73 20 74 68 69 73 0a te handles this.
22430 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 66 61 ** function fa
22440 69 6c 69 6e 67 2e 20 0a 20 20 2a 2f 0a 20 20 53 iling. . */. S
22450 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 imulateIOError(
22460 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f return SQLITE_IO
22470 45 52 52 20 29 3b 0a 0a 20 20 61 7a 44 69 72 73 ERR );.. azDirs
22480 5b 30 5d 20 3d 20 73 71 6c 69 74 65 33 5f 74 65 [0] = sqlite3_te
22490 6d 70 5f 64 69 72 65 63 74 6f 72 79 3b 0a 20 20 mp_directory;.
224a0 69 66 20 28 4e 55 4c 4c 20 3d 3d 20 61 7a 44 69 if (NULL == azDi
224b0 72 73 5b 31 5d 29 20 7b 0a 20 20 20 20 61 7a 44 rs[1]) {. azD
224c0 69 72 73 5b 31 5d 20 3d 20 67 65 74 65 6e 76 28 irs[1] = getenv(
224d0 22 54 4d 50 44 49 52 22 29 3b 0a 20 20 7d 0a 20 "TMPDIR");. }.
224e0 20 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 . for(i=0; i<s
224f0 69 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f 73 69 izeof(azDirs)/si
22500 7a 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d 29 3b zeof(azDirs[0]);
22510 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 61 i++){. if( a
22520 7a 44 69 72 73 5b 69 5d 3d 3d 30 20 29 20 63 6f zDirs[i]==0 ) co
22530 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 ntinue;. if(
22540 73 74 61 74 28 61 7a 44 69 72 73 5b 69 5d 2c 20 stat(azDirs[i],
22550 26 62 75 66 29 20 29 20 63 6f 6e 74 69 6e 75 65 &buf) ) continue
22560 3b 0a 20 20 20 20 69 66 28 20 21 53 5f 49 53 44 ;. if( !S_ISD
22570 49 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29 20 IR(buf.st_mode)
22580 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 ) continue;.
22590 69 66 28 20 61 63 63 65 73 73 28 61 7a 44 69 72 if( access(azDir
225a0 73 5b 69 5d 2c 20 30 37 29 20 29 20 63 6f 6e 74 s[i], 07) ) cont
225b0 69 6e 75 65 3b 0a 20 20 20 20 7a 44 69 72 20 3d inue;. zDir =
225c0 20 61 7a 44 69 72 73 5b 69 5d 3b 0a 20 20 20 20 azDirs[i];.
225d0 62 72 65 61 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a break;. }.. /*
225e0 20 43 68 65 63 6b 20 74 68 61 74 20 74 68 65 20 Check that the
225f0 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69 73 output buffer is
22600 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 66 6f large enough fo
22610 72 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 r the temporary
22620 66 69 6c 65 20 0a 20 20 2a 2a 20 6e 61 6d 65 2e file . ** name.
22630 20 49 66 20 69 74 20 69 73 20 6e 6f 74 2c 20 72 If it is not, r
22640 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 eturn SQLITE_ERR
22650 4f 52 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 OR.. */. if( (
22660 73 74 72 6c 65 6e 28 7a 44 69 72 29 20 2b 20 73 strlen(zDir) + s
22670 74 72 6c 65 6e 28 53 51 4c 49 54 45 5f 54 45 4d trlen(SQLITE_TEM
22680 50 5f 46 49 4c 45 5f 50 52 45 46 49 58 29 20 2b P_FILE_PREFIX) +
22690 20 31 37 29 20 3e 3d 20 28 73 69 7a 65 5f 74 29 17) >= (size_t)
226a0 6e 42 75 66 20 29 7b 0a 20 20 20 20 72 65 74 75 nBuf ){. retu
226b0 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b rn SQLITE_ERROR;
226c0 0a 20 20 7d 0a 0a 20 20 64 6f 7b 0a 20 20 20 20 . }.. do{.
226d0 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 sqlite3_snprintf
226e0 28 6e 42 75 66 2d 31 37 2c 20 7a 42 75 66 2c 20 (nBuf-17, zBuf,
226f0 22 25 73 2f 22 53 51 4c 49 54 45 5f 54 45 4d 50 "%s/"SQLITE_TEMP
22700 5f 46 49 4c 45 5f 50 52 45 46 49 58 2c 20 7a 44 _FILE_PREFIX, zD
22710 69 72 29 3b 0a 20 20 20 20 6a 20 3d 20 28 69 6e ir);. j = (in
22720 74 29 73 74 72 6c 65 6e 28 7a 42 75 66 29 3b 0a t)strlen(zBuf);.
22730 20 20 20 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 sqlite3_rand
22740 6f 6d 6e 65 73 73 28 31 35 2c 20 26 7a 42 75 66 omness(15, &zBuf
22750 5b 6a 5d 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d [j]);. for(i=
22760 30 3b 20 69 3c 31 35 3b 20 69 2b 2b 2c 20 6a 2b 0; i<15; i++, j+
22770 2b 29 7b 0a 20 20 20 20 20 20 7a 42 75 66 5b 6a +){. zBuf[j
22780 5d 20 3d 20 28 63 68 61 72 29 7a 43 68 61 72 73 ] = (char)zChars
22790 5b 20 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 [ ((unsigned cha
227a0 72 29 7a 42 75 66 5b 6a 5d 29 25 28 73 69 7a 65 r)zBuf[j])%(size
227b0 6f 66 28 7a 43 68 61 72 73 29 2d 31 29 20 5d 3b of(zChars)-1) ];
227c0 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66 5b . }. zBuf[
227d0 6a 5d 20 3d 20 30 3b 0a 20 20 7d 77 68 69 6c 65 j] = 0;. }while
227e0 28 20 61 63 63 65 73 73 28 7a 42 75 66 2c 30 29 ( access(zBuf,0)
227f0 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 ==0 );. return
22800 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 SQLITE_OK;.}..#i
22810 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
22820 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 26 26 LOCKING_STYLE &&
22830 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 defined(__APPLE
22840 5f 5f 29 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 6e __)./*.** Routin
22850 65 20 74 6f 20 74 72 61 6e 73 66 6f 72 6d 20 61 e to transform a
22860 20 75 6e 69 78 46 69 6c 65 20 69 6e 74 6f 20 61 unixFile into a
22870 20 70 72 6f 78 79 2d 6c 6f 63 6b 69 6e 67 20 75 proxy-locking u
22880 6e 69 78 46 69 6c 65 2e 0a 2a 2a 20 49 6d 70 6c nixFile..** Impl
22890 65 6d 65 6e 74 61 74 69 6f 6e 20 69 6e 20 74 68 ementation in th
228a0 65 20 70 72 6f 78 79 2d 6c 6f 63 6b 20 64 69 76 e proxy-lock div
228b0 69 73 69 6f 6e 2c 20 62 75 74 20 75 73 65 64 20 ision, but used
228c0 62 79 20 75 6e 69 78 4f 70 65 6e 28 29 0a 2a 2a by unixOpen().**
228d0 20 69 66 20 53 51 4c 49 54 45 5f 50 52 45 46 45 if SQLITE_PREFE
228e0 52 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 20 R_PROXY_LOCKING
228f0 69 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 is defined..*/.s
22900 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 54 tatic int proxyT
22910 72 61 6e 73 66 6f 72 6d 55 6e 69 78 46 69 6c 65 ransformUnixFile
22920 28 75 6e 69 78 46 69 6c 65 2a 2c 20 63 6f 6e 73 (unixFile*, cons
22930 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 t char*);.#endif
22940 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 66 ../*.** Search f
22950 6f 72 20 61 6e 20 75 6e 75 73 65 64 20 66 69 6c or an unused fil
22960 65 20 64 65 73 63 72 69 70 74 6f 72 20 74 68 61 e descriptor tha
22970 74 20 77 61 73 20 6f 70 65 6e 65 64 20 6f 6e 20 t was opened on
22980 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a the database .**
22990 20 66 69 6c 65 20 28 6e 6f 74 20 61 20 6a 6f 75 file (not a jou
229a0 72 6e 61 6c 20 6f 72 20 6d 61 73 74 65 72 2d 6a rnal or master-j
229b0 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 69 64 65 ournal file) ide
229c0 6e 74 69 66 69 65 64 20 62 79 20 70 61 74 68 6e ntified by pathn
229d0 61 6d 65 0a 2a 2a 20 7a 50 61 74 68 20 77 69 74 ame.** zPath wit
229e0 68 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 58 58 h SQLITE_OPEN_XX
229f0 58 20 66 6c 61 67 73 20 6d 61 74 63 68 69 6e 67 X flags matching
22a00 20 74 68 6f 73 65 20 70 61 73 73 65 64 20 61 73 those passed as
22a10 20 74 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 the second.** a
22a20 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 rgument to this
22a30 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 function..**.**
22a40 53 75 63 68 20 61 20 66 69 6c 65 20 64 65 73 63 Such a file desc
22a50 72 69 70 74 6f 72 20 6d 61 79 20 65 78 69 73 74 riptor may exist
22a60 20 69 66 20 61 20 64 61 74 61 62 61 73 65 20 63 if a database c
22a70 6f 6e 6e 65 63 74 69 6f 6e 20 77 61 73 20 63 6c onnection was cl
22a80 6f 73 65 64 0a 2a 2a 20 62 75 74 20 74 68 65 20 osed.** but the
22a90 61 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 20 associated file
22aa0 64 65 73 63 72 69 70 74 6f 72 20 63 6f 75 6c 64 descriptor could
22ab0 20 6e 6f 74 20 62 65 20 63 6c 6f 73 65 64 20 62 not be closed b
22ac0 65 63 61 75 73 65 20 73 6f 6d 65 0a 2a 2a 20 6f ecause some.** o
22ad0 74 68 65 72 20 66 69 6c 65 20 64 65 73 63 72 69 ther file descri
22ae0 70 74 6f 72 20 6f 70 65 6e 20 6f 6e 20 74 68 65 ptor open on the
22af0 20 73 61 6d 65 20 66 69 6c 65 20 69 73 20 68 6f same file is ho
22b00 6c 64 69 6e 67 20 61 20 66 69 6c 65 2d 6c 6f 63 lding a file-loc
22b10 6b 2e 0a 2a 2a 20 52 65 66 65 72 20 74 6f 20 63 k..** Refer to c
22b20 6f 6d 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 75 omments in the u
22b30 6e 69 78 43 6c 6f 73 65 28 29 20 66 75 6e 63 74 nixClose() funct
22b40 69 6f 6e 20 61 6e 64 20 74 68 65 20 6c 65 6e 67 ion and the leng
22b50 74 68 79 20 63 6f 6d 6d 65 6e 74 0a 2a 2a 20 64 thy comment.** d
22b60 65 73 63 72 69 62 69 6e 67 20 22 50 6f 73 69 78 escribing "Posix
22b70 20 41 64 76 69 73 6f 72 79 20 4c 6f 63 6b 69 6e Advisory Lockin
22b80 67 22 20 61 74 20 74 68 65 20 73 74 61 72 74 20 g" at the start
22b90 6f 66 20 74 68 69 73 20 66 69 6c 65 20 66 6f 72 of this file for
22ba0 20 0a 2a 2a 20 66 75 72 74 68 65 72 20 64 65 74 .** further det
22bb0 61 69 6c 73 2e 20 41 6c 73 6f 2c 20 74 69 63 6b ails. Also, tick
22bc0 65 74 20 23 34 30 31 38 2e 0a 2a 2a 0a 2a 2a 20 et #4018..**.**
22bd0 49 66 20 61 20 73 75 69 74 61 62 6c 65 20 66 69 If a suitable fi
22be0 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 le descriptor is
22bf0 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 69 74 20 found, then it
22c00 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 is returned. If
22c10 6e 6f 0a 2a 2a 20 73 75 63 68 20 66 69 6c 65 20 no.** such file
22c20 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 6c 6f descriptor is lo
22c30 63 61 74 65 64 2c 20 2d 31 20 69 73 20 72 65 74 cated, -1 is ret
22c40 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
22c50 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 66 UnixUnusedFd *f
22c60 69 6e 64 52 65 75 73 61 62 6c 65 46 64 28 63 6f indReusableFd(co
22c70 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c nst char *zPath,
22c80 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 55 int flags){. U
22c90 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e nixUnusedFd *pUn
22ca0 75 73 65 64 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 used = 0;.. /*
22cb0 44 6f 20 6e 6f 74 20 73 65 61 72 63 68 20 66 6f Do not search fo
22cc0 72 20 61 6e 20 75 6e 75 73 65 64 20 66 69 6c 65 r an unused file
22cd0 20 64 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 76 descriptor on v
22ce0 78 77 6f 72 6b 73 2e 20 4e 6f 74 20 62 65 63 61 xworks. Not beca
22cf0 75 73 65 0a 20 20 2a 2a 20 76 78 77 6f 72 6b 73 use. ** vxworks
22d00 20 77 6f 75 6c 64 20 6e 6f 74 20 62 65 6e 65 66 would not benef
22d10 69 74 20 66 72 6f 6d 20 74 68 65 20 63 68 61 6e it from the chan
22d20 67 65 20 28 69 74 20 6d 69 67 68 74 2c 20 77 65 ge (it might, we
22d30 27 72 65 20 6e 6f 74 20 73 75 72 65 29 2c 0a 20 're not sure),.
22d40 20 2a 2a 20 62 75 74 20 62 65 63 61 75 73 65 20 ** but because
22d50 6e 6f 20 77 61 79 20 74 6f 20 74 65 73 74 20 69 no way to test i
22d60 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 t is currently a
22d70 76 61 69 6c 61 62 6c 65 2e 20 49 74 20 69 73 20 vailable. It is
22d80 62 65 74 74 65 72 20 0a 20 20 2a 2a 20 6e 6f 74 better . ** not
22d90 20 74 6f 20 72 69 73 6b 20 62 72 65 61 6b 69 6e to risk breakin
22da0 67 20 76 78 77 6f 72 6b 73 20 73 75 70 70 6f 72 g vxworks suppor
22db0 74 20 66 6f 72 20 74 68 65 20 73 61 6b 65 20 6f t for the sake o
22dc0 66 20 73 75 63 68 20 61 6e 20 6f 62 73 63 75 72 f such an obscur
22dd0 65 20 0a 20 20 2a 2a 20 66 65 61 74 75 72 65 2e e . ** feature.
22de0 20 20 2a 2f 0a 23 69 66 20 21 4f 53 5f 56 58 57 */.#if !OS_VXW
22df0 4f 52 4b 53 0a 20 20 73 74 72 75 63 74 20 73 74 ORKS. struct st
22e00 61 74 20 73 53 74 61 74 3b 20 20 20 20 20 20 20 at sStat;
22e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
22e20 65 73 75 6c 74 73 20 6f 66 20 73 74 61 74 28 29 esults of stat()
22e30 20 63 61 6c 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 41 call */.. /* A
22e40 20 73 74 61 74 28 29 20 63 61 6c 6c 20 6d 61 79 stat() call may
22e50 20 66 61 69 6c 20 66 6f 72 20 76 61 72 69 6f 75 fail for variou
22e60 73 20 72 65 61 73 6f 6e 73 2e 20 49 66 20 74 68 s reasons. If th
22e70 69 73 20 68 61 70 70 65 6e 73 2c 20 69 74 20 69 is happens, it i
22e80 73 0a 20 20 2a 2a 20 61 6c 6d 6f 73 74 20 63 65 s. ** almost ce
22e90 72 74 61 69 6e 20 74 68 61 74 20 61 6e 20 6f 70 rtain that an op
22ea0 65 6e 28 29 20 63 61 6c 6c 20 6f 6e 20 74 68 65 en() call on the
22eb0 20 73 61 6d 65 20 70 61 74 68 20 77 69 6c 6c 20 same path will
22ec0 61 6c 73 6f 20 66 61 69 6c 2e 0a 20 20 2a 2a 20 also fail.. **
22ed0 46 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c For this reason,
22ee0 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 if an error occ
22ef0 75 72 73 20 69 6e 20 74 68 65 20 73 74 61 74 28 urs in the stat(
22f00 29 20 63 61 6c 6c 20 68 65 72 65 2c 20 69 74 20 ) call here, it
22f10 69 73 0a 20 20 2a 2a 20 69 67 6e 6f 72 65 64 20 is. ** ignored
22f20 61 6e 64 20 2d 31 20 69 73 20 72 65 74 75 72 6e and -1 is return
22f30 65 64 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 ed. The caller w
22f40 69 6c 6c 20 74 72 79 20 74 6f 20 6f 70 65 6e 20 ill try to open
22f50 61 20 6e 65 77 20 66 69 6c 65 0a 20 20 2a 2a 20 a new file. **
22f60 64 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 74 68 descriptor on th
22f70 65 20 73 61 6d 65 20 70 61 74 68 2c 20 66 61 69 e same path, fai
22f80 6c 2c 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e l, and return an
22f90 20 65 72 72 6f 72 20 74 6f 20 53 51 4c 69 74 65 error to SQLite
22fa0 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 76 65 6e .. **. ** Even
22fb0 20 69 66 20 61 20 73 75 62 73 65 71 75 65 6e 74 if a subsequent
22fc0 20 6f 70 65 6e 28 29 20 63 61 6c 6c 20 64 6f 65 open() call doe
22fd0 73 20 73 75 63 63 65 65 64 2c 20 74 68 65 20 63 s succeed, the c
22fe0 6f 6e 73 65 71 75 65 6e 63 65 73 20 6f 66 0a 20 onsequences of.
22ff0 20 2a 2a 20 6e 6f 74 20 73 65 61 72 63 68 69 6e ** not searchin
23000 67 20 66 6f 72 20 61 20 72 65 73 75 73 61 62 6c g for a resusabl
23010 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f e file descripto
23020 72 20 61 72 65 20 6e 6f 74 20 64 69 72 65 2e 20 r are not dire.
23030 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 61 */. if( 0==sta
23040 74 28 7a 50 61 74 68 2c 20 26 73 53 74 61 74 29 t(zPath, &sStat)
23050 20 29 7b 0a 20 20 20 20 75 6e 69 78 49 6e 6f 64 ){. unixInod
23060 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 0a eInfo *pInode;..
23070 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 unixEnterMut
23080 65 78 28 29 3b 0a 20 20 20 20 70 49 6e 6f 64 65 ex();. pInode
23090 20 3d 20 69 6e 6f 64 65 4c 69 73 74 3b 0a 20 20 = inodeList;.
230a0 20 20 77 68 69 6c 65 28 20 70 49 6e 6f 64 65 20 while( pInode
230b0 26 26 20 28 70 49 6e 6f 64 65 2d 3e 66 69 6c 65 && (pInode->file
230c0 49 64 2e 64 65 76 21 3d 73 53 74 61 74 2e 73 74 Id.dev!=sStat.st
230d0 5f 64 65 76 0a 20 20 20 20 20 20 20 20 20 20 20 _dev.
230e0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 49 6e || pIn
230f0 6f 64 65 2d 3e 66 69 6c 65 49 64 2e 69 6e 6f 21 ode->fileId.ino!
23100 3d 73 53 74 61 74 2e 73 74 5f 69 6e 6f 29 20 29 =sStat.st_ino) )
23110 7b 0a 20 20 20 20 20 20 20 70 49 6e 6f 64 65 20 {. pInode
23120 3d 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b = pInode->pNext;
23130 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
23140 49 6e 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 55 Inode ){. U
23150 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 2a 70 70 nixUnusedFd **pp
23160 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 70 3d 26 ;. for(pp=&
23170 70 49 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 3b pInode->pUnused;
23180 20 2a 70 70 20 26 26 20 28 2a 70 70 29 2d 3e 66 *pp && (*pp)->f
23190 6c 61 67 73 21 3d 66 6c 61 67 73 3b 20 70 70 3d lags!=flags; pp=
231a0 26 28 28 2a 70 70 29 2d 3e 70 4e 65 78 74 29 29 &((*pp)->pNext))
231b0 3b 0a 20 20 20 20 20 20 70 55 6e 75 73 65 64 20 ;. pUnused
231c0 3d 20 2a 70 70 3b 0a 20 20 20 20 20 20 69 66 28 = *pp;. if(
231d0 20 70 55 6e 75 73 65 64 20 29 7b 0a 20 20 20 20 pUnused ){.
231e0 20 20 20 20 2a 70 70 20 3d 20 70 55 6e 75 73 65 *pp = pUnuse
231f0 64 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 d->pNext;.
23200 7d 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 69 78 }. }. unix
23210 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 LeaveMutex();.
23220 7d 0a 23 65 6e 64 69 66 20 20 20 20 2f 2a 20 69 }.#endif /* i
23230 66 20 21 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f f !OS_VXWORKS */
23240 0a 20 20 72 65 74 75 72 6e 20 70 55 6e 75 73 65 . return pUnuse
23250 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e d;.}../*.** Open
23260 20 74 68 65 20 66 69 6c 65 20 7a 50 61 74 68 2e the file zPath.
23270 0a 2a 2a 20 0a 2a 2a 20 50 72 65 76 69 6f 75 73 .** .** Previous
23280 6c 79 2c 20 74 68 65 20 53 51 4c 69 74 65 20 4f ly, the SQLite O
23290 53 20 6c 61 79 65 72 20 75 73 65 64 20 74 68 72 S layer used thr
232a0 65 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 20 ee functions in
232b0 70 6c 61 63 65 20 6f 66 20 74 68 69 73 0a 2a 2a place of this.**
232c0 20 6f 6e 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 one:.**.**
232d0 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 sqlite3OsOpenRea
232e0 64 57 72 69 74 65 28 29 3b 0a 2a 2a 20 20 20 20 dWrite();.**
232f0 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 sqlite3OsOpenRe
23300 61 64 4f 6e 6c 79 28 29 3b 0a 2a 2a 20 20 20 20 adOnly();.**
23310 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 sqlite3OsOpenEx
23320 63 6c 75 73 69 76 65 28 29 3b 0a 2a 2a 0a 2a 2a clusive();.**.**
23330 20 54 68 65 73 65 20 63 61 6c 6c 73 20 63 6f 72 These calls cor
23340 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 66 respond to the f
23350 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 62 69 6e 61 ollowing combina
23360 74 69 6f 6e 73 20 6f 66 20 66 6c 61 67 73 3a 0a tions of flags:.
23370 2a 2a 0a 2a 2a 20 20 20 20 20 52 65 61 64 57 72 **.** ReadWr
23380 69 74 65 28 29 20 2d 3e 20 20 20 20 20 28 52 45 ite() -> (RE
23390 41 44 57 52 49 54 45 20 7c 20 43 52 45 41 54 45 ADWRITE | CREATE
233a0 29 0a 2a 2a 20 20 20 20 20 52 65 61 64 4f 6e 6c ).** ReadOnl
233b0 79 28 29 20 20 2d 3e 20 20 20 20 20 28 52 45 41 y() -> (REA
233c0 44 4f 4e 4c 59 29 20 0a 2a 2a 20 20 20 20 20 4f DONLY) .** O
233d0 70 65 6e 45 78 63 6c 75 73 69 76 65 28 29 20 2d penExclusive() -
233e0 3e 20 28 52 45 41 44 57 52 49 54 45 20 7c 20 43 > (READWRITE | C
233f0 52 45 41 54 45 20 7c 20 45 58 43 4c 55 53 49 56 REATE | EXCLUSIV
23400 45 29 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f 6c 64 E).**.** The old
23410 20 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 29 OpenExclusive()
23420 20 61 63 63 65 70 74 65 64 20 61 20 62 6f 6f 6c accepted a bool
23430 65 61 6e 20 61 72 67 75 6d 65 6e 74 20 2d 20 22 ean argument - "
23440 64 65 6c 46 6c 61 67 22 2e 20 49 66 0a 2a 2a 20 delFlag". If.**
23450 74 72 75 65 2c 20 74 68 65 20 66 69 6c 65 20 77 true, the file w
23460 61 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f as configured to
23470 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c be automaticall
23480 79 20 64 65 6c 65 74 65 64 20 77 68 65 6e 20 74 y deleted when t
23490 68 65 0a 2a 2a 20 66 69 6c 65 20 68 61 6e 64 6c he.** file handl
234a0 65 20 63 6c 6f 73 65 64 2e 20 54 6f 20 61 63 68 e closed. To ach
234b0 69 65 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 ieve the same ef
234c0 66 65 63 74 20 75 73 69 6e 67 20 74 68 69 73 20 fect using this
234d0 6e 65 77 20 0a 2a 2a 20 69 6e 74 65 72 66 61 63 new .** interfac
234e0 65 2c 20 61 64 64 20 74 68 65 20 44 45 4c 45 54 e, add the DELET
234f0 45 4f 4e 43 4c 4f 53 45 20 66 6c 61 67 20 74 6f EONCLOSE flag to
23500 20 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 those specified
23510 20 61 62 6f 76 65 20 66 6f 72 20 0a 2a 2a 20 4f above for .** O
23520 70 65 6e 45 78 63 6c 75 73 69 76 65 28 29 2e 0a penExclusive()..
23530 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
23540 69 78 4f 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 ixOpen(. sqlite
23550 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 3_vfs *pVfs,
23560 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 46 /* The VF
23570 53 20 66 6f 72 20 77 68 69 63 68 20 74 68 69 73 S for which this
23580 20 69 73 20 74 68 65 20 78 4f 70 65 6e 20 6d 65 is the xOpen me
23590 74 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 thod */. const
235a0 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 char *zPath,
235b0 20 20 20 20 20 20 20 2f 2a 20 50 61 74 68 6e 61 /* Pathna
235c0 6d 65 20 6f 66 20 66 69 6c 65 20 74 6f 20 62 65 me of file to be
235d0 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 73 71 6c opened */. sql
235e0 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 ite3_file *pFile
235f0 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 , /* The
23600 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
23610 20 74 6f 20 62 65 20 66 69 6c 6c 65 64 20 69 6e to be filled in
23620 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c */. int flags,
23630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23640 20 20 20 2f 2a 20 49 6e 70 75 74 20 66 6c 61 67 /* Input flag
23650 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 65 s to control the
23660 20 6f 70 65 6e 69 6e 67 20 2a 2f 0a 20 20 69 6e opening */. in
23670 74 20 2a 70 4f 75 74 46 6c 61 67 73 20 20 20 20 t *pOutFlags
23680 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75 /* Ou
23690 74 70 75 74 20 66 6c 61 67 73 20 72 65 74 75 72 tput flags retur
236a0 6e 65 64 20 74 6f 20 53 51 4c 69 74 65 20 63 6f ned to SQLite co
236b0 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 46 re */.){. unixF
236c0 69 6c 65 20 2a 70 20 3d 20 28 75 6e 69 78 46 69 ile *p = (unixFi
236d0 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 20 69 6e le *)pFile;. in
236e0 74 20 66 64 20 3d 20 2d 31 3b 20 20 20 20 20 20 t fd = -1;
236f0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23700 46 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 File descriptor
23710 72 65 74 75 72 6e 65 64 20 62 79 20 6f 70 65 6e returned by open
23720 28 29 20 2a 2f 0a 20 20 69 6e 74 20 64 69 72 66 () */. int dirf
23730 64 20 3d 20 2d 31 3b 20 20 20 20 20 20 20 20 20 d = -1;
23740 20 20 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 /* Direct
23750 6f 72 79 20 66 69 6c 65 20 64 65 73 63 72 69 70 ory file descrip
23760 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 6f 70 65 tor */. int ope
23770 6e 46 6c 61 67 73 20 3d 20 30 3b 20 20 20 20 20 nFlags = 0;
23780 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 /* Flags
23790 20 74 6f 20 70 61 73 73 20 74 6f 20 6f 70 65 6e to pass to open
237a0 28 29 20 2a 2f 0a 20 20 69 6e 74 20 65 54 79 70 () */. int eTyp
237b0 65 20 3d 20 66 6c 61 67 73 26 30 78 46 46 46 46 e = flags&0xFFFF
237c0 46 46 30 30 3b 20 20 2f 2a 20 54 79 70 65 20 6f FF00; /* Type o
237d0 66 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e 20 2a f file to open *
237e0 2f 0a 20 20 69 6e 74 20 6e 6f 4c 6f 63 6b 3b 20 /. int noLock;
237f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23800 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 6f 6d /* True to om
23810 69 74 20 6c 6f 63 6b 69 6e 67 20 70 72 69 6d 69 it locking primi
23820 74 69 76 65 73 20 2a 2f 0a 20 20 69 6e 74 20 72 tives */. int r
23830 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
23840 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 75 6e /* Fun
23850 63 74 69 6f 6e 20 52 65 74 75 72 6e 20 43 6f 64 ction Return Cod
23860 65 20 2a 2f 0a 0a 20 20 69 6e 74 20 69 73 45 78 e */.. int isEx
23870 63 6c 75 73 69 76 65 20 20 3d 20 28 66 6c 61 67 clusive = (flag
23880 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
23890 45 58 43 4c 55 53 49 56 45 29 3b 0a 20 20 69 6e EXCLUSIVE);. in
238a0 74 20 69 73 44 65 6c 65 74 65 20 20 20 20 20 3d t isDelete =
238b0 20 28 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 (flags & SQLITE
238c0 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c _OPEN_DELETEONCL
238d0 4f 53 45 29 3b 0a 20 20 69 6e 74 20 69 73 43 72 OSE);. int isCr
238e0 65 61 74 65 20 20 20 20 20 3d 20 28 66 6c 61 67 eate = (flag
238f0 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
23900 43 52 45 41 54 45 29 3b 0a 20 20 69 6e 74 20 69 CREATE);. int i
23910 73 52 65 61 64 6f 6e 6c 79 20 20 20 3d 20 28 66 sReadonly = (f
23920 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
23930 45 4e 5f 52 45 41 44 4f 4e 4c 59 29 3b 0a 20 20 EN_READONLY);.
23940 69 6e 74 20 69 73 52 65 61 64 57 72 69 74 65 20 int isReadWrite
23950 20 3d 20 28 66 6c 61 67 73 20 26 20 53 51 4c 49 = (flags & SQLI
23960 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
23970 45 29 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 E);.#if SQLITE_E
23980 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
23990 59 4c 45 0a 20 20 69 6e 74 20 69 73 41 75 74 6f YLE. int isAuto
239a0 50 72 6f 78 79 20 20 3d 20 28 66 6c 61 67 73 20 Proxy = (flags
239b0 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 41 55 & SQLITE_OPEN_AU
239c0 54 4f 50 52 4f 58 59 29 3b 0a 23 65 6e 64 69 66 TOPROXY);.#endif
239d0 0a 0a 20 20 2f 2a 20 49 66 20 63 72 65 61 74 69 .. /* If creati
239e0 6e 67 20 61 20 6d 61 73 74 65 72 20 6f 72 20 6d ng a master or m
239f0 61 69 6e 2d 66 69 6c 65 20 6a 6f 75 72 6e 61 6c ain-file journal
23a00 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 , this function
23a10 77 69 6c 6c 20 6f 70 65 6e 0a 20 20 2a 2a 20 61 will open. ** a
23a20 20 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 file-descriptor
23a30 20 6f 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 on the director
23a40 79 20 74 6f 6f 2e 20 54 68 65 20 66 69 72 73 74 y too. The first
23a50 20 74 69 6d 65 20 75 6e 69 78 53 79 6e 63 28 29 time unixSync()
23a60 0a 20 20 2a 2a 20 69 73 20 63 61 6c 6c 65 64 20 . ** is called
23a70 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 66 69 the directory fi
23a80 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 77 69 le descriptor wi
23a90 6c 6c 20 62 65 20 66 73 79 6e 63 28 29 65 64 20 ll be fsync()ed
23aa0 61 6e 64 20 63 6c 6f 73 65 28 29 64 2e 0a 20 20 and close()d..
23ab0 2a 2f 0a 20 20 69 6e 74 20 69 73 4f 70 65 6e 44 */. int isOpenD
23ac0 69 72 65 63 74 6f 72 79 20 3d 20 28 69 73 43 72 irectory = (isCr
23ad0 65 61 74 65 20 26 26 20 0a 20 20 20 20 20 20 28 eate && . (
23ae0 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 eType==SQLITE_OP
23af0 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 EN_MASTER_JOURNA
23b00 4c 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 L || eType==SQLI
23b10 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 TE_OPEN_MAIN_JOU
23b20 52 4e 41 4c 29 0a 20 20 29 3b 0a 0a 20 20 2f 2a RNAL). );.. /*
23b30 20 49 66 20 61 72 67 75 6d 65 6e 74 20 7a 50 61 If argument zPa
23b40 74 68 20 69 73 20 61 20 4e 55 4c 4c 20 70 6f 69 th is a NULL poi
23b50 6e 74 65 72 2c 20 74 68 69 73 20 66 75 6e 63 74 nter, this funct
23b60 69 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 20 ion is required
23b70 74 6f 20 6f 70 65 6e 0a 20 20 2a 2a 20 61 20 74 to open. ** a t
23b80 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 55 emporary file. U
23b90 73 65 20 74 68 69 73 20 62 75 66 66 65 72 20 74 se this buffer t
23ba0 6f 20 73 74 6f 72 65 20 74 68 65 20 66 69 6c 65 o store the file
23bb0 20 6e 61 6d 65 20 69 6e 2e 0a 20 20 2a 2f 0a 20 name in.. */.
23bc0 20 63 68 61 72 20 7a 54 6d 70 6e 61 6d 65 5b 4d char zTmpname[M
23bd0 41 58 5f 50 41 54 48 4e 41 4d 45 2b 31 5d 3b 0a AX_PATHNAME+1];.
23be0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e const char *zN
23bf0 61 6d 65 20 3d 20 7a 50 61 74 68 3b 0a 0a 20 20 ame = zPath;..
23c00 2f 2a 20 43 68 65 63 6b 20 74 68 65 20 66 6f 6c /* Check the fol
23c10 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 lowing statement
23c20 73 20 61 72 65 20 74 72 75 65 3a 20 0a 20 20 2a s are true: . *
23c30 2a 0a 20 20 2a 2a 20 20 20 28 61 29 20 45 78 61 *. ** (a) Exa
23c40 63 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 ctly one of the
23c50 52 45 41 44 57 52 49 54 45 20 61 6e 64 20 52 45 READWRITE and RE
23c60 41 44 4f 4e 4c 59 20 66 6c 61 67 73 20 6d 75 73 ADONLY flags mus
23c70 74 20 62 65 20 73 65 74 2c 20 61 6e 64 20 0a 20 t be set, and .
23c80 20 2a 2a 20 20 20 28 62 29 20 69 66 20 43 52 45 ** (b) if CRE
23c90 41 54 45 20 69 73 20 73 65 74 2c 20 74 68 65 6e ATE is set, then
23ca0 20 52 45 41 44 57 52 49 54 45 20 6d 75 73 74 20 READWRITE must
23cb0 61 6c 73 6f 20 62 65 20 73 65 74 2c 20 61 6e 64 also be set, and
23cc0 0a 20 20 2a 2a 20 20 20 28 63 29 20 69 66 20 45 . ** (c) if E
23cd0 58 43 4c 55 53 49 56 45 20 69 73 20 73 65 74 2c XCLUSIVE is set,
23ce0 20 74 68 65 6e 20 43 52 45 41 54 45 20 6d 75 73 then CREATE mus
23cf0 74 20 61 6c 73 6f 20 62 65 20 73 65 74 2e 0a 20 t also be set..
23d00 20 2a 2a 20 20 20 28 64 29 20 69 66 20 44 45 4c ** (d) if DEL
23d10 45 54 45 4f 4e 43 4c 4f 53 45 20 69 73 20 73 65 ETEONCLOSE is se
23d20 74 2c 20 74 68 65 6e 20 43 52 45 41 54 45 20 6d t, then CREATE m
23d30 75 73 74 20 61 6c 73 6f 20 62 65 20 73 65 74 2e ust also be set.
23d40 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 28 . */. assert((
23d50 69 73 52 65 61 64 6f 6e 6c 79 3d 3d 30 20 7c 7c isReadonly==0 ||
23d60 20 69 73 52 65 61 64 57 72 69 74 65 3d 3d 30 29 isReadWrite==0)
23d70 20 26 26 20 28 69 73 52 65 61 64 57 72 69 74 65 && (isReadWrite
23d80 20 7c 7c 20 69 73 52 65 61 64 6f 6e 6c 79 29 29 || isReadonly))
23d90 3b 0a 20 20 61 73 73 65 72 74 28 69 73 43 72 65 ;. assert(isCre
23da0 61 74 65 3d 3d 30 20 7c 7c 20 69 73 52 65 61 64 ate==0 || isRead
23db0 57 72 69 74 65 29 3b 0a 20 20 61 73 73 65 72 74 Write);. assert
23dc0 28 69 73 45 78 63 6c 75 73 69 76 65 3d 3d 30 20 (isExclusive==0
23dd0 7c 7c 20 69 73 43 72 65 61 74 65 29 3b 0a 20 20 || isCreate);.
23de0 61 73 73 65 72 74 28 69 73 44 65 6c 65 74 65 3d assert(isDelete=
23df0 3d 30 20 7c 7c 20 69 73 43 72 65 61 74 65 29 3b =0 || isCreate);
23e00 0a 0a 20 20 2f 2a 20 54 68 65 20 6d 61 69 6e 20 .. /* The main
23e10 44 42 2c 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c DB, main journal
23e20 2c 20 61 6e 64 20 6d 61 73 74 65 72 20 6a 6f 75 , and master jou
23e30 72 6e 61 6c 20 61 72 65 20 6e 65 76 65 72 20 61 rnal are never a
23e40 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20 20 2a utomatically. *
23e50 2a 20 64 65 6c 65 74 65 64 2e 20 4e 6f 72 20 61 * deleted. Nor a
23e60 72 65 20 74 68 65 79 20 65 76 65 72 20 74 65 6d re they ever tem
23e70 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 20 20 2a porary files. *
23e80 2f 0a 20 20 61 73 73 65 72 74 28 20 28 21 69 73 /. assert( (!is
23e90 44 65 6c 65 74 65 20 26 26 20 7a 4e 61 6d 65 29 Delete && zName)
23ea0 20 7c 7c 20 65 54 79 70 65 21 3d 53 51 4c 49 54 || eType!=SQLIT
23eb0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 29 E_OPEN_MAIN_DB )
23ec0 3b 0a 20 20 61 73 73 65 72 74 28 20 28 21 69 73 ;. assert( (!is
23ed0 44 65 6c 65 74 65 20 26 26 20 7a 4e 61 6d 65 29 Delete && zName)
23ee0 20 7c 7c 20 65 54 79 70 65 21 3d 53 51 4c 49 54 || eType!=SQLIT
23ef0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
23f00 4e 41 4c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 NAL );. assert(
23f10 20 28 21 69 73 44 65 6c 65 74 65 20 26 26 20 7a (!isDelete && z
23f20 4e 61 6d 65 29 20 7c 7c 20 65 54 79 70 65 21 3d Name) || eType!=
23f30 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53 54 SQLITE_OPEN_MAST
23f40 45 52 5f 4a 4f 55 52 4e 41 4c 20 29 3b 0a 0a 20 ER_JOURNAL );..
23f50 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 20 /* Assert that
23f60 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 the upper layer
23f70 68 61 73 20 73 65 74 20 6f 6e 65 20 6f 66 20 74 has set one of t
23f80 68 65 20 22 66 69 6c 65 2d 74 79 70 65 22 20 66 he "file-type" f
23f90 6c 61 67 73 2e 20 2a 2f 0a 20 20 61 73 73 65 72 lags. */. asser
23fa0 74 28 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 t( eType==SQLITE
23fb0 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 20 20 _OPEN_MAIN_DB
23fc0 20 20 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c || eType==SQL
23fd0 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 ITE_OPEN_TEMP_DB
23fe0 20 0a 20 20 20 20 20 20 20 7c 7c 20 65 54 79 70 . || eTyp
23ff0 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d e==SQLITE_OPEN_M
24000 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 7c 7c 20 65 AIN_JOURNAL || e
24010 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 Type==SQLITE_OPE
24020 4e 5f 54 45 4d 50 5f 4a 4f 55 52 4e 41 4c 20 0a N_TEMP_JOURNAL .
24030 20 20 20 20 20 20 20 7c 7c 20 65 54 79 70 65 3d || eType=
24040 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 42 =SQLITE_OPEN_SUB
24050 4a 4f 55 52 4e 41 4c 20 20 20 7c 7c 20 65 54 79 JOURNAL || eTy
24060 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f pe==SQLITE_OPEN_
24070 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 0a MASTER_JOURNAL .
24080 20 20 20 20 20 20 20 7c 7c 20 65 54 79 70 65 3d || eType=
24090 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 52 41 =SQLITE_OPEN_TRA
240a0 4e 53 49 45 4e 54 5f 44 42 0a 20 20 29 3b 0a 0a NSIENT_DB. );..
240b0 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 73 memset(p, 0, s
240c0 69 7a 65 6f 66 28 75 6e 69 78 46 69 6c 65 29 29 izeof(unixFile))
240d0 3b 0a 0a 20 20 69 66 28 20 65 54 79 70 65 3d 3d ;.. if( eType==
240e0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
240f0 5f 44 42 20 29 7b 0a 20 20 20 20 55 6e 69 78 55 _DB ){. UnixU
24100 6e 75 73 65 64 46 64 20 2a 70 55 6e 75 73 65 64 nusedFd *pUnused
24110 3b 0a 20 20 20 20 70 55 6e 75 73 65 64 20 3d 20 ;. pUnused =
24120 66 69 6e 64 52 65 75 73 61 62 6c 65 46 64 28 7a findReusableFd(z
24130 4e 61 6d 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Name, flags);.
24140 20 20 69 66 28 20 70 55 6e 75 73 65 64 20 29 7b if( pUnused ){
24150 0a 20 20 20 20 20 20 66 64 20 3d 20 70 55 6e 75 . fd = pUnu
24160 73 65 64 2d 3e 66 64 3b 0a 20 20 20 20 7d 65 6c sed->fd;. }el
24170 73 65 7b 0a 20 20 20 20 20 20 70 55 6e 75 73 65 se{. pUnuse
24180 64 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c d = sqlite3_mall
24190 6f 63 28 73 69 7a 65 6f 66 28 2a 70 55 6e 75 73 oc(sizeof(*pUnus
241a0 65 64 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ed));. if(
241b0 21 70 55 6e 75 73 65 64 20 29 7b 0a 20 20 20 20 !pUnused ){.
241c0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
241d0 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d E_NOMEM;. }
241e0 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 70 55 . }. p->pU
241f0 6e 75 73 65 64 20 3d 20 70 55 6e 75 73 65 64 3b nused = pUnused;
24200 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 7a 4e . }else if( !zN
24210 61 6d 65 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 ame ){. /* If
24220 20 7a 4e 61 6d 65 20 69 73 20 4e 55 4c 4c 2c 20 zName is NULL,
24230 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 the upper layer
24240 69 73 20 72 65 71 75 65 73 74 69 6e 67 20 61 20 is requesting a
24250 74 65 6d 70 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 temp file. */.
24260 20 20 61 73 73 65 72 74 28 69 73 44 65 6c 65 74 assert(isDelet
24270 65 20 26 26 20 21 69 73 4f 70 65 6e 44 69 72 65 e && !isOpenDire
24280 63 74 6f 72 79 29 3b 0a 20 20 20 20 72 63 20 3d ctory);. rc =
24290 20 67 65 74 54 65 6d 70 6e 61 6d 65 28 4d 41 58 getTempname(MAX
242a0 5f 50 41 54 48 4e 41 4d 45 2b 31 2c 20 7a 54 6d _PATHNAME+1, zTm
242b0 70 6e 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 pname);. if(
242c0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
242d0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
242e0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 4e 61 6d ;. }. zNam
242f0 65 20 3d 20 7a 54 6d 70 6e 61 6d 65 3b 0a 20 20 e = zTmpname;.
24300 7d 0a 0a 20 20 2f 2a 20 44 65 74 65 72 6d 69 6e }.. /* Determin
24310 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 e the value of t
24320 68 65 20 66 6c 61 67 73 20 70 61 72 61 6d 65 74 he flags paramet
24330 65 72 20 70 61 73 73 65 64 20 74 6f 20 50 4f 53 er passed to POS
24340 49 58 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a IX function. **
24350 20 6f 70 65 6e 28 29 2e 20 54 68 65 73 65 20 6d open(). These m
24360 75 73 74 20 62 65 20 63 61 6c 63 75 6c 61 74 65 ust be calculate
24370 64 20 65 76 65 6e 20 69 66 20 6f 70 65 6e 28 29 d even if open()
24380 20 69 73 20 6e 6f 74 20 63 61 6c 6c 65 64 2c 20 is not called,
24390 61 73 0a 20 20 2a 2a 20 74 68 65 79 20 6d 61 79 as. ** they may
243a0 20 62 65 20 73 74 6f 72 65 64 20 61 73 20 70 61 be stored as pa
243b0 72 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 68 rt of the file h
243c0 61 6e 64 6c 65 20 61 6e 64 20 75 73 65 64 20 62 andle and used b
243d0 79 20 74 68 65 20 0a 20 20 2a 2a 20 27 63 6f 6e y the . ** 'con
243e0 63 68 20 66 69 6c 65 27 20 6c 6f 63 6b 69 6e 67 ch file' locking
243f0 20 66 75 6e 63 74 69 6f 6e 73 20 6c 61 74 65 72 functions later
24400 20 6f 6e 2e 20 20 2a 2f 0a 20 20 69 66 28 20 69 on. */. if( i
24410 73 52 65 61 64 6f 6e 6c 79 20 29 20 20 6f 70 65 sReadonly ) ope
24420 6e 46 6c 61 67 73 20 7c 3d 20 4f 5f 52 44 4f 4e nFlags |= O_RDON
24430 4c 59 3b 0a 20 20 69 66 28 20 69 73 52 65 61 64 LY;. if( isRead
24440 57 72 69 74 65 20 29 20 6f 70 65 6e 46 6c 61 67 Write ) openFlag
24450 73 20 7c 3d 20 4f 5f 52 44 57 52 3b 0a 20 20 69 s |= O_RDWR;. i
24460 66 28 20 69 73 43 72 65 61 74 65 20 29 20 20 20 f( isCreate )
24470 20 6f 70 65 6e 46 6c 61 67 73 20 7c 3d 20 4f 5f openFlags |= O_
24480 43 52 45 41 54 3b 0a 20 20 69 66 28 20 69 73 45 CREAT;. if( isE
24490 78 63 6c 75 73 69 76 65 20 29 20 6f 70 65 6e 46 xclusive ) openF
244a0 6c 61 67 73 20 7c 3d 20 28 4f 5f 45 58 43 4c 7c lags |= (O_EXCL|
244b0 4f 5f 4e 4f 46 4f 4c 4c 4f 57 29 3b 0a 20 20 6f O_NOFOLLOW);. o
244c0 70 65 6e 46 6c 61 67 73 20 7c 3d 20 28 4f 5f 4c penFlags |= (O_L
244d0 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52 ARGEFILE|O_BINAR
244e0 59 29 3b 0a 0a 20 20 69 66 28 20 66 64 3c 30 20 Y);.. if( fd<0
244f0 29 7b 0a 20 20 20 20 6d 6f 64 65 5f 74 20 6f 70 ){. mode_t op
24500 65 6e 4d 6f 64 65 20 3d 20 28 69 73 44 65 6c 65 enMode = (isDele
24510 74 65 3f 30 36 30 30 3a 53 51 4c 49 54 45 5f 44 te?0600:SQLITE_D
24520 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d EFAULT_FILE_PERM
24530 49 53 53 49 4f 4e 53 29 3b 0a 20 20 20 20 66 64 ISSIONS);. fd
24540 20 3d 20 6f 70 65 6e 28 7a 4e 61 6d 65 2c 20 6f = open(zName, o
24550 70 65 6e 46 6c 61 67 73 2c 20 6f 70 65 6e 4d 6f penFlags, openMo
24560 64 65 29 3b 0a 20 20 20 20 4f 53 54 52 41 43 45 de);. OSTRACE
24570 28 28 22 4f 50 45 4e 58 20 20 20 25 2d 33 64 20 (("OPENX %-3d
24580 25 73 20 30 25 6f 5c 6e 22 2c 20 66 64 2c 20 7a %s 0%o\n", fd, z
24590 4e 61 6d 65 2c 20 6f 70 65 6e 46 6c 61 67 73 29 Name, openFlags)
245a0 29 3b 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 );. if( fd<0
245b0 26 26 20 65 72 72 6e 6f 21 3d 45 49 53 44 49 52 && errno!=EISDIR
245c0 20 26 26 20 69 73 52 65 61 64 57 72 69 74 65 20 && isReadWrite
245d0 26 26 20 21 69 73 45 78 63 6c 75 73 69 76 65 20 && !isExclusive
245e0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 46 61 69 6c ){. /* Fail
245f0 65 64 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 66 ed to open the f
24600 69 6c 65 20 66 6f 72 20 72 65 61 64 2f 77 72 69 ile for read/wri
24610 74 65 20 61 63 63 65 73 73 2e 20 54 72 79 20 72 te access. Try r
24620 65 61 64 2d 6f 6e 6c 79 2e 20 2a 2f 0a 20 20 20 ead-only. */.
24630 20 20 20 66 6c 61 67 73 20 26 3d 20 7e 28 53 51 flags &= ~(SQ
24640 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
24650 49 54 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ITE|SQLITE_OPEN_
24660 43 52 45 41 54 45 29 3b 0a 20 20 20 20 20 20 6f CREATE);. o
24670 70 65 6e 46 6c 61 67 73 20 26 3d 20 7e 28 4f 5f penFlags &= ~(O_
24680 52 44 57 52 7c 4f 5f 43 52 45 41 54 29 3b 0a 20 RDWR|O_CREAT);.
24690 20 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 flags |= SQ
246a0 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e LITE_OPEN_READON
246b0 4c 59 3b 0a 20 20 20 20 20 20 6f 70 65 6e 46 6c LY;. openFl
246c0 61 67 73 20 7c 3d 20 4f 5f 52 44 4f 4e 4c 59 3b ags |= O_RDONLY;
246d0 0a 20 20 20 20 20 20 66 64 20 3d 20 6f 70 65 6e . fd = open
246e0 28 7a 4e 61 6d 65 2c 20 6f 70 65 6e 46 6c 61 67 (zName, openFlag
246f0 73 2c 20 6f 70 65 6e 4d 6f 64 65 29 3b 0a 20 20 s, openMode);.
24700 20 20 7d 0a 20 20 20 20 69 66 28 20 66 64 3c 30 }. if( fd<0
24710 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
24720 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 QLITE_CANTOPEN_B
24730 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 KPT;. goto
24740 6f 70 65 6e 5f 66 69 6e 69 73 68 65 64 3b 0a 20 open_finished;.
24750 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 }. }. asser
24760 74 28 20 66 64 3e 3d 30 20 29 3b 0a 20 20 69 66 t( fd>=0 );. if
24770 28 20 70 4f 75 74 46 6c 61 67 73 20 29 7b 0a 20 ( pOutFlags ){.
24780 20 20 20 2a 70 4f 75 74 46 6c 61 67 73 20 3d 20 *pOutFlags =
24790 66 6c 61 67 73 3b 0a 20 20 7d 0a 0a 20 20 69 66 flags;. }.. if
247a0 28 20 70 2d 3e 70 55 6e 75 73 65 64 20 29 7b 0a ( p->pUnused ){.
247b0 20 20 20 20 70 2d 3e 70 55 6e 75 73 65 64 2d 3e p->pUnused->
247c0 66 64 20 3d 20 66 64 3b 0a 20 20 20 20 70 2d 3e fd = fd;. p->
247d0 70 55 6e 75 73 65 64 2d 3e 66 6c 61 67 73 20 3d pUnused->flags =
247e0 20 66 6c 61 67 73 3b 0a 20 20 7d 0a 0a 20 20 69 flags;. }.. i
247f0 66 28 20 69 73 44 65 6c 65 74 65 20 29 7b 0a 23 f( isDelete ){.#
24800 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 if OS_VXWORKS.
24810 20 20 7a 50 61 74 68 20 3d 20 7a 4e 61 6d 65 3b zPath = zName;
24820 0a 23 65 6c 73 65 0a 20 20 20 20 75 6e 6c 69 6e .#else. unlin
24830 6b 28 7a 4e 61 6d 65 29 3b 0a 23 65 6e 64 69 66 k(zName);.#endif
24840 0a 20 20 7d 0a 23 69 66 20 53 51 4c 49 54 45 5f . }.#if SQLITE_
24850 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
24860 54 59 4c 45 0a 20 20 65 6c 73 65 7b 0a 20 20 20 TYLE. else{.
24870 20 70 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 p->openFlags =
24880 6f 70 65 6e 46 6c 61 67 73 3b 0a 20 20 7d 0a 23 openFlags;. }.#
24890 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 69 73 4f endif.. if( isO
248a0 70 65 6e 44 69 72 65 63 74 6f 72 79 20 29 7b 0a penDirectory ){.
248b0 20 20 20 20 72 63 20 3d 20 6f 70 65 6e 44 69 72 rc = openDir
248c0 65 63 74 6f 72 79 28 7a 50 61 74 68 2c 20 26 64 ectory(zPath, &d
248d0 69 72 66 64 29 3b 0a 20 20 20 20 69 66 28 20 72 irfd);. if( r
248e0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
248f0 20 20 20 20 20 20 2f 2a 20 49 74 20 69 73 20 73 /* It is s
24900 61 66 65 20 74 6f 20 63 6c 6f 73 65 20 66 64 20 afe to close fd
24910 61 74 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 62 at this point, b
24920 65 63 61 75 73 65 20 69 74 20 69 73 20 67 75 61 ecause it is gua
24930 72 61 6e 74 65 65 64 20 6e 6f 74 0a 20 20 20 20 ranteed not.
24940 20 20 2a 2a 20 74 6f 20 62 65 20 6f 70 65 6e 20 ** to be open
24950 6f 6e 20 61 20 64 61 74 61 62 61 73 65 20 66 69 on a database fi
24960 6c 65 2e 20 49 66 20 69 74 20 77 65 72 65 20 6f le. If it were o
24970 70 65 6e 20 6f 6e 20 61 20 64 61 74 61 62 61 73 pen on a databas
24980 65 20 66 69 6c 65 2c 0a 20 20 20 20 20 20 2a 2a e file,. **
24990 20 69 74 20 77 6f 75 6c 64 20 6e 6f 74 20 62 65 it would not be
249a0 20 73 61 66 65 20 74 6f 20 63 6c 6f 73 65 20 61 safe to close a
249b0 73 20 74 68 69 73 20 77 6f 75 6c 64 20 72 65 6c s this would rel
249c0 65 61 73 65 20 61 6e 79 20 6c 6f 63 6b 73 20 68 ease any locks h
249d0 65 6c 64 0a 20 20 20 20 20 20 2a 2a 20 6f 6e 20 eld. ** on
249e0 74 68 65 20 66 69 6c 65 20 62 79 20 74 68 69 73 the file by this
249f0 20 70 72 6f 63 65 73 73 2e 20 20 2a 2f 0a 20 20 process. */.
24a00 20 20 20 20 61 73 73 65 72 74 28 20 65 54 79 70 assert( eTyp
24a10 65 21 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d e!=SQLITE_OPEN_M
24a20 41 49 4e 5f 44 42 20 29 3b 0a 20 20 20 20 20 20 AIN_DB );.
24a30 63 6c 6f 73 65 28 66 64 29 3b 20 20 20 20 20 20 close(fd);
24a40 20 20 20 20 20 20 20 2f 2a 20 73 69 6c 65 6e 74 /* silent
24a50 6c 79 20 6c 65 61 6b 20 69 66 20 66 61 69 6c 2c ly leak if fail,
24a60 20 61 6c 72 65 61 64 79 20 69 6e 20 65 72 72 6f already in erro
24a70 72 20 2a 2f 0a 20 20 20 20 20 20 67 6f 74 6f 20 r */. goto
24a80 6f 70 65 6e 5f 66 69 6e 69 73 68 65 64 3b 0a 20 open_finished;.
24a90 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 66 }. }..#ifdef
24aa0 20 46 44 5f 43 4c 4f 45 58 45 43 0a 20 20 66 63 FD_CLOEXEC. fc
24ab0 6e 74 6c 28 66 64 2c 20 46 5f 53 45 54 46 44 2c ntl(fd, F_SETFD,
24ac0 20 66 63 6e 74 6c 28 66 64 2c 20 46 5f 47 45 54 fcntl(fd, F_GET
24ad0 46 44 2c 20 30 29 20 7c 20 46 44 5f 43 4c 4f 45 FD, 0) | FD_CLOE
24ae0 58 45 43 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 XEC);.#endif..
24af0 6e 6f 4c 6f 63 6b 20 3d 20 65 54 79 70 65 21 3d noLock = eType!=
24b00 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
24b10 5f 44 42 3b 0a 0a 20 20 0a 23 69 66 20 64 65 66 _DB;.. .#if def
24b20 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 ined(__APPLE__)
24b30 7c 7c 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 || SQLITE_ENABLE
24b40 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 _LOCKING_STYLE.
24b50 20 73 74 72 75 63 74 20 73 74 61 74 66 73 20 66 struct statfs f
24b60 73 49 6e 66 6f 3b 0a 20 20 69 66 28 20 66 73 74 sInfo;. if( fst
24b70 61 74 66 73 28 66 64 2c 20 26 66 73 49 6e 66 6f atfs(fd, &fsInfo
24b80 29 20 3d 3d 20 2d 31 20 29 7b 0a 20 20 20 20 28 ) == -1 ){. (
24b90 28 75 6e 69 78 46 69 6c 65 2a 29 70 46 69 6c 65 (unixFile*)pFile
24ba0 29 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d 20 65 )->lastErrno = e
24bb0 72 72 6e 6f 3b 0a 20 20 20 20 69 66 28 20 64 69 rrno;. if( di
24bc0 72 66 64 3e 3d 30 20 29 20 63 6c 6f 73 65 28 64 rfd>=0 ) close(d
24bd0 69 72 66 64 29 3b 20 2f 2a 20 73 69 6c 65 6e 74 irfd); /* silent
24be0 6c 79 20 6c 65 61 6b 20 69 66 20 66 61 69 6c 2c ly leak if fail,
24bf0 20 69 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 20 in error */.
24c00 20 63 6c 6f 73 65 28 66 64 29 3b 20 2f 2a 20 73 close(fd); /* s
24c10 69 6c 65 6e 74 6c 79 20 6c 65 61 6b 20 69 66 20 ilently leak if
24c20 66 61 69 6c 2c 20 69 6e 20 65 72 72 6f 72 20 2a fail, in error *
24c30 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
24c40 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 45 53 53 ITE_IOERR_ACCESS
24c50 3b 0a 20 20 7d 0a 20 20 69 66 20 28 30 20 3d 3d ;. }. if (0 ==
24c60 20 73 74 72 6e 63 6d 70 28 22 6d 73 64 6f 73 22 strncmp("msdos"
24c70 2c 20 66 73 49 6e 66 6f 2e 66 5f 66 73 74 79 70 , fsInfo.f_fstyp
24c80 65 6e 61 6d 65 2c 20 35 29 29 20 7b 0a 20 20 20 ename, 5)) {.
24c90 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 70 46 69 ((unixFile*)pFi
24ca0 6c 65 29 2d 3e 66 73 46 6c 61 67 73 20 7c 3d 20 le)->fsFlags |=
24cb0 53 51 4c 49 54 45 5f 46 53 46 4c 41 47 53 5f 49 SQLITE_FSFLAGS_I
24cc0 53 5f 4d 53 44 4f 53 3b 0a 20 20 7d 0a 23 65 6e S_MSDOS;. }.#en
24cd0 64 69 66 0a 20 20 0a 23 69 66 20 53 51 4c 49 54 dif. .#if SQLIT
24ce0 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
24cf0 5f 53 54 59 4c 45 0a 23 69 66 20 53 51 4c 49 54 _STYLE.#if SQLIT
24d00 45 5f 50 52 45 46 45 52 5f 50 52 4f 58 59 5f 4c E_PREFER_PROXY_L
24d10 4f 43 4b 49 4e 47 0a 20 20 69 73 41 75 74 6f 50 OCKING. isAutoP
24d20 72 6f 78 79 20 3d 20 31 3b 0a 23 65 6e 64 69 66 roxy = 1;.#endif
24d30 0a 20 20 69 66 28 20 69 73 41 75 74 6f 50 72 6f . if( isAutoPro
24d40 78 79 20 26 26 20 28 7a 50 61 74 68 21 3d 4e 55 xy && (zPath!=NU
24d50 4c 4c 29 20 26 26 20 28 21 6e 6f 4c 6f 63 6b 29 LL) && (!noLock)
24d60 20 26 26 20 70 56 66 73 2d 3e 78 4f 70 65 6e 20 && pVfs->xOpen
24d70 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 65 6e 76 ){. char *env
24d80 66 6f 72 63 65 20 3d 20 67 65 74 65 6e 76 28 22 force = getenv("
24d90 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 50 52 4f SQLITE_FORCE_PRO
24da0 58 59 5f 4c 4f 43 4b 49 4e 47 22 29 3b 0a 20 20 XY_LOCKING");.
24db0 20 20 69 6e 74 20 75 73 65 50 72 6f 78 79 20 3d int useProxy =
24dc0 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 53 51 4c 49 0;.. /* SQLI
24dd0 54 45 5f 46 4f 52 43 45 5f 50 52 4f 58 59 5f 4c TE_FORCE_PROXY_L
24de0 4f 43 4b 49 4e 47 3d 3d 31 20 6d 65 61 6e 73 20 OCKING==1 means
24df0 66 6f 72 63 65 20 61 6c 77 61 79 73 20 75 73 65 force always use
24e00 20 70 72 6f 78 79 2c 20 30 20 6d 65 61 6e 73 20 proxy, 0 means
24e10 0a 20 20 20 20 2a 2a 20 6e 65 76 65 72 20 75 73 . ** never us
24e20 65 20 70 72 6f 78 79 2c 20 4e 55 4c 4c 20 6d 65 e proxy, NULL me
24e30 61 6e 73 20 75 73 65 20 70 72 6f 78 79 20 66 6f ans use proxy fo
24e40 72 20 6e 6f 6e 2d 6c 6f 63 61 6c 20 66 69 6c 65 r non-local file
24e50 73 20 6f 6e 6c 79 2e 20 20 2a 2f 0a 20 20 20 20 s only. */.
24e60 69 66 28 20 65 6e 76 66 6f 72 63 65 21 3d 4e 55 if( envforce!=NU
24e70 4c 4c 20 29 7b 0a 20 20 20 20 20 20 75 73 65 50 LL ){. useP
24e80 72 6f 78 79 20 3d 20 61 74 6f 69 28 65 6e 76 66 roxy = atoi(envf
24e90 6f 72 63 65 29 3e 30 3b 0a 20 20 20 20 7d 65 6c orce)>0;. }el
24ea0 73 65 7b 0a 20 20 20 20 20 20 73 74 72 75 63 74 se{. struct
24eb0 20 73 74 61 74 66 73 20 66 73 49 6e 66 6f 3b 0a statfs fsInfo;.
24ec0 20 20 20 20 20 20 69 66 28 20 73 74 61 74 66 73 if( statfs
24ed0 28 7a 50 61 74 68 2c 20 26 66 73 49 6e 66 6f 29 (zPath, &fsInfo)
24ee0 20 3d 3d 20 2d 31 20 29 7b 0a 20 20 20 20 20 20 == -1 ){.
24ef0 20 20 2f 2a 20 49 6e 20 74 68 65 6f 72 79 2c 20 /* In theory,
24f00 74 68 65 20 63 6c 6f 73 65 28 66 64 29 20 63 61 the close(fd) ca
24f10 6c 6c 20 69 73 20 73 75 62 2d 6f 70 74 69 6d 61 ll is sub-optima
24f20 6c 2e 20 49 66 20 74 68 65 20 66 69 6c 65 20 6f l. If the file o
24f30 70 65 6e 65 64 0a 20 20 20 20 20 20 20 20 2a 2a pened. **
24f40 20 77 69 74 68 20 66 64 20 69 73 20 61 20 64 61 with fd is a da
24f50 74 61 62 61 73 65 20 66 69 6c 65 2c 20 61 6e 64 tabase file, and
24f60 20 74 68 65 72 65 20 61 72 65 20 6f 74 68 65 72 there are other
24f70 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 70 65 connections ope
24f80 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 6e 20 n. ** on
24f90 74 68 61 74 20 66 69 6c 65 20 74 68 61 74 20 61 that file that a
24fa0 72 65 20 63 75 72 72 65 6e 74 6c 79 20 68 6f 6c re currently hol
24fb0 64 69 6e 67 20 61 64 76 69 73 6f 72 79 20 6c 6f ding advisory lo
24fc0 63 6b 73 20 6f 6e 20 69 74 2c 0a 20 20 20 20 20 cks on it,.
24fd0 20 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 63 ** then the c
24fe0 61 6c 6c 20 74 6f 20 63 6c 6f 73 65 28 29 20 77 all to close() w
24ff0 69 6c 6c 20 63 61 6e 63 65 6c 20 74 68 6f 73 65 ill cancel those
25000 20 6c 6f 63 6b 73 2e 20 49 6e 20 70 72 61 63 74 locks. In pract
25010 69 63 65 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 ice,. **
25020 77 65 27 72 65 20 61 73 73 75 6d 69 6e 67 20 74 we're assuming t
25030 68 61 74 20 73 74 61 74 66 73 28 29 20 64 6f 65 hat statfs() doe
25040 73 6e 27 74 20 66 61 69 6c 20 76 65 72 79 20 6f sn't fail very o
25050 66 74 65 6e 2e 20 41 74 20 6c 65 61 73 74 0a 20 ften. At least.
25060 20 20 20 20 20 20 20 2a 2a 20 6e 6f 74 20 77 68 ** not wh
25070 69 6c 65 20 6f 74 68 65 72 20 66 69 6c 65 20 64 ile other file d
25080 65 73 63 72 69 70 74 6f 72 73 20 6f 70 65 6e 65 escriptors opene
25090 64 20 62 79 20 74 68 65 20 73 61 6d 65 20 70 72 d by the same pr
250a0 6f 63 65 73 73 20 6f 6e 0a 20 20 20 20 20 20 20 ocess on.
250b0 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 66 69 6c ** the same fil
250c0 65 20 61 72 65 20 77 6f 72 6b 69 6e 67 2e 20 20 e are working.
250d0 2a 2f 0a 20 20 20 20 20 20 20 20 70 2d 3e 6c 61 */. p->la
250e0 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b stErrno = errno;
250f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 64 69 72 . if( dir
25100 66 64 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 fd>=0 ){.
25110 20 20 20 63 6c 6f 73 65 28 64 69 72 66 64 29 3b close(dirfd);
25120 20 2f 2a 20 73 69 6c 65 6e 74 6c 79 20 6c 65 61 /* silently lea
25130 6b 20 69 66 20 66 61 69 6c 2c 20 69 6e 20 65 72 k if fail, in er
25140 72 6f 72 20 2a 2f 0a 20 20 20 20 20 20 20 20 7d ror */. }
25150 0a 20 20 20 20 20 20 20 20 63 6c 6f 73 65 28 66 . close(f
25160 64 29 3b 20 2f 2a 20 73 69 6c 65 6e 74 6c 79 20 d); /* silently
25170 6c 65 61 6b 20 69 66 20 66 61 69 6c 2c 20 69 6e leak if fail, in
25180 20 65 72 72 6f 72 20 2a 2f 0a 20 20 20 20 20 20 error */.
25190 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f rc = SQLITE_IO
251a0 45 52 52 5f 41 43 43 45 53 53 3b 0a 20 20 20 20 ERR_ACCESS;.
251b0 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 66 69 goto open_fi
251c0 6e 69 73 68 65 64 3b 0a 20 20 20 20 20 20 7d 0a nished;. }.
251d0 20 20 20 20 20 20 75 73 65 50 72 6f 78 79 20 3d useProxy =
251e0 20 21 28 66 73 49 6e 66 6f 2e 66 5f 66 6c 61 67 !(fsInfo.f_flag
251f0 73 26 4d 4e 54 5f 4c 4f 43 41 4c 29 3b 0a 20 20 s&MNT_LOCAL);.
25200 20 20 7d 0a 20 20 20 20 69 66 28 20 75 73 65 50 }. if( useP
25210 72 6f 78 79 20 29 7b 0a 20 20 20 20 20 20 72 63 roxy ){. rc
25220 20 3d 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 6c = fillInUnixFil
25230 65 28 70 56 66 73 2c 20 66 64 2c 20 64 69 72 66 e(pVfs, fd, dirf
25240 64 2c 20 70 46 69 6c 65 2c 20 7a 50 61 74 68 2c d, pFile, zPath,
25250 20 6e 6f 4c 6f 63 6b 2c 20 69 73 44 65 6c 65 74 noLock, isDelet
25260 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 e);. if( rc
25270 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
25280 20 20 20 20 20 20 20 72 63 20 3d 20 70 72 6f 78 rc = prox
25290 79 54 72 61 6e 73 66 6f 72 6d 55 6e 69 78 46 69 yTransformUnixFi
252a0 6c 65 28 28 75 6e 69 78 46 69 6c 65 2a 29 70 46 le((unixFile*)pF
252b0 69 6c 65 2c 20 22 3a 61 75 74 6f 3a 22 29 3b 0a ile, ":auto:");.
252c0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
252d0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
252e0 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 75 6e /* Use un
252f0 69 78 43 6c 6f 73 65 20 74 6f 20 63 6c 65 61 6e ixClose to clean
25300 20 75 70 20 74 68 65 20 72 65 73 6f 75 72 63 65 up the resource
25310 73 20 61 64 64 65 64 20 69 6e 20 66 69 6c 6c 49 s added in fillI
25320 6e 55 6e 69 78 46 69 6c 65 20 0a 20 20 20 20 20 nUnixFile .
25330 20 20 20 20 20 2a 2a 20 61 6e 64 20 63 6c 65 61 ** and clea
25340 72 20 61 6c 6c 20 74 68 65 20 73 74 72 75 63 74 r all the struct
25350 75 72 65 27 73 20 72 65 66 65 72 65 6e 63 65 73 ure's references
25360 2e 20 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c . Specifically,
25370 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 . ** p
25380 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 77 File->pMethods w
25390 69 6c 6c 20 62 65 20 4e 55 4c 4c 20 73 6f 20 73 ill be NULL so s
253a0 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 20 77 69 qlite3OsClose wi
253b0 6c 6c 20 62 65 20 61 20 6e 6f 2d 6f 70 20 0a 20 ll be a no-op .
253c0 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 */.
253d0 20 20 20 20 20 20 75 6e 69 78 43 6c 6f 73 65 28 unixClose(
253e0 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 20 20 pFile);.
253f0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
25400 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
25410 20 20 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 66 goto open_f
25420 69 6e 69 73 68 65 64 3b 0a 20 20 20 20 7d 0a 20 inished;. }.
25430 20 7d 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 72 }.#endif. . r
25440 63 20 3d 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 c = fillInUnixFi
25450 6c 65 28 70 56 66 73 2c 20 66 64 2c 20 64 69 72 le(pVfs, fd, dir
25460 66 64 2c 20 70 46 69 6c 65 2c 20 7a 50 61 74 68 fd, pFile, zPath
25470 2c 20 6e 6f 4c 6f 63 6b 2c 20 69 73 44 65 6c 65 , noLock, isDele
25480 74 65 29 3b 0a 6f 70 65 6e 5f 66 69 6e 69 73 68 te);.open_finish
25490 65 64 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 ed:. if( rc!=SQ
254a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 LITE_OK ){. s
254b0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 70 qlite3_free(p->p
254c0 55 6e 75 73 65 64 29 3b 0a 20 20 7d 0a 20 20 72 Unused);. }. r
254d0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
254e0 0a 2a 2a 20 44 65 6c 65 74 65 20 74 68 65 20 66 .** Delete the f
254f0 69 6c 65 20 61 74 20 7a 50 61 74 68 2e 20 49 66 ile at zPath. If
25500 20 74 68 65 20 64 69 72 53 79 6e 63 20 61 72 67 the dirSync arg
25510 75 6d 65 6e 74 20 69 73 20 74 72 75 65 2c 20 66 ument is true, f
25520 73 79 6e 63 28 29 0a 2a 2a 20 74 68 65 20 64 69 sync().** the di
25530 72 65 63 74 6f 72 79 20 61 66 74 65 72 20 64 65 rectory after de
25540 6c 65 74 69 6e 67 20 74 68 65 20 66 69 6c 65 2e leting the file.
25550 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
25560 6e 69 78 44 65 6c 65 74 65 28 0a 20 20 73 71 6c nixDelete(. sql
25570 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 ite3_vfs *NotUse
25580 64 2c 20 20 20 20 20 2f 2a 20 56 46 53 20 63 6f d, /* VFS co
25590 6e 74 61 69 6e 69 6e 67 20 74 68 69 73 20 61 73 ntaining this as
255a0 20 74 68 65 20 78 44 65 6c 65 74 65 20 6d 65 74 the xDelete met
255b0 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 hod */. const c
255c0 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 20 har *zPath,
255d0 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 66 69 /* Name of fi
255e0 6c 65 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 le to be deleted
255f0 20 2a 2f 0a 20 20 69 6e 74 20 64 69 72 53 79 6e */. int dirSyn
25600 63 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c
25610 2f 2a 20 49 66 20 74 72 75 65 2c 20 66 73 79 6e /* If true, fsyn
25620 63 28 29 20 64 69 72 65 63 74 6f 72 79 20 61 66 c() directory af
25630 74 65 72 20 64 65 6c 65 74 69 6e 67 20 66 69 6c ter deleting fil
25640 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 e */.){. int rc
25650 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
25660 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
25670 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 53 69 6d (NotUsed);. Sim
25680 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 72 65 74 ulateIOError(ret
25690 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
256a0 5f 44 45 4c 45 54 45 29 3b 0a 20 20 75 6e 6c 69 _DELETE);. unli
256b0 6e 6b 28 7a 50 61 74 68 29 3b 0a 23 69 66 6e 64 nk(zPath);.#ifnd
256c0 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c ef SQLITE_DISABL
256d0 45 5f 44 49 52 53 59 4e 43 0a 20 20 69 66 28 20 E_DIRSYNC. if(
256e0 64 69 72 53 79 6e 63 20 29 7b 0a 20 20 20 20 69 dirSync ){. i
256f0 6e 74 20 66 64 3b 0a 20 20 20 20 72 63 20 3d 20 nt fd;. rc =
25700 6f 70 65 6e 44 69 72 65 63 74 6f 72 79 28 7a 50 openDirectory(zP
25710 61 74 68 2c 20 26 66 64 29 3b 0a 20 20 20 20 69 ath, &fd);. i
25720 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
25730 20 29 7b 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 ){.#if OS_VXWOR
25740 4b 53 0a 20 20 20 20 20 20 69 66 28 20 66 73 79 KS. if( fsy
25750 6e 63 28 66 64 29 3d 3d 2d 31 20 29 0a 23 65 6c nc(fd)==-1 ).#el
25760 73 65 0a 20 20 20 20 20 20 69 66 28 20 66 73 79 se. if( fsy
25770 6e 63 28 66 64 29 20 29 0a 23 65 6e 64 69 66 0a nc(fd) ).#endif.
25780 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 20 20 {.
25790 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 rc = SQLITE_IOER
257a0 52 5f 44 49 52 5f 46 53 59 4e 43 3b 0a 20 20 20 R_DIR_FSYNC;.
257b0 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 63 }. if( c
257c0 6c 6f 73 65 28 66 64 29 26 26 21 72 63 20 29 7b lose(fd)&&!rc ){
257d0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
257e0 4c 49 54 45 5f 49 4f 45 52 52 5f 44 49 52 5f 43 LITE_IOERR_DIR_C
257f0 4c 4f 53 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 LOSE;. }.
25800 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
25810 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
25820 2a 0a 2a 2a 20 54 65 73 74 20 74 68 65 20 65 78 *.** Test the ex
25830 69 73 74 61 6e 63 65 20 6f 66 20 6f 72 20 61 63 istance of or ac
25840 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 73 cess permissions
25850 20 6f 66 20 66 69 6c 65 20 7a 50 61 74 68 2e 20 of file zPath.
25860 54 68 65 0a 2a 2a 20 74 65 73 74 20 70 65 72 66 The.** test perf
25870 6f 72 6d 65 64 20 64 65 70 65 6e 64 73 20 6f 6e ormed depends on
25880 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 66 6c the value of fl
25890 61 67 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 ags:.**.** S
258a0 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 QLITE_ACCESS_EXI
258b0 53 54 53 3a 20 52 65 74 75 72 6e 20 31 20 69 66 STS: Return 1 if
258c0 20 74 68 65 20 66 69 6c 65 20 65 78 69 73 74 73 the file exists
258d0 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 41 .** SQLITE_A
258e0 43 43 45 53 53 5f 52 45 41 44 57 52 49 54 45 3a CCESS_READWRITE:
258f0 20 52 65 74 75 72 6e 20 31 20 69 66 20 74 68 65 Return 1 if the
25900 20 66 69 6c 65 20 69 73 20 72 65 61 64 20 61 6e file is read an
25910 64 20 77 72 69 74 61 62 6c 65 2e 0a 2a 2a 20 20 d writable..**
25920 20 20 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 SQLITE_ACCESS
25930 5f 52 45 41 44 4f 4e 4c 59 3a 20 52 65 74 75 72 _READONLY: Retur
25940 6e 20 31 20 69 66 20 74 68 65 20 66 69 6c 65 20 n 1 if the file
25950 69 73 20 72 65 61 64 61 62 6c 65 2e 0a 2a 2a 0a is readable..**.
25960 2a 2a 20 4f 74 68 65 72 77 69 73 65 20 72 65 74 ** Otherwise ret
25970 75 72 6e 20 30 2e 0a 2a 2f 0a 73 74 61 74 69 63 urn 0..*/.static
25980 20 69 6e 74 20 75 6e 69 78 41 63 63 65 73 73 28 int unixAccess(
25990 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
259a0 4e 6f 74 55 73 65 64 2c 20 20 20 2f 2a 20 54 68 NotUsed, /* Th
259b0 65 20 56 46 53 20 63 6f 6e 74 61 69 6e 69 6e 67 e VFS containing
259c0 20 74 68 69 73 20 78 41 63 63 65 73 73 20 6d 65 this xAccess me
259d0 74 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 thod */. const
259e0 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 char *zPath,
259f0 20 20 2f 2a 20 50 61 74 68 20 6f 66 20 74 68 65 /* Path of the
25a00 20 66 69 6c 65 20 74 6f 20 65 78 61 6d 69 6e 65 file to examine
25a10 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c */. int flags,
25a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
25a30 20 57 68 61 74 20 64 6f 20 77 65 20 77 61 6e 74 What do we want
25a40 20 74 6f 20 6c 65 61 72 6e 20 61 62 6f 75 74 20 to learn about
25a50 74 68 65 20 7a 50 61 74 68 20 66 69 6c 65 3f 20 the zPath file?
25a60 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 4f 75 */. int *pResOu
25a70 74 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t /*
25a80 57 72 69 74 65 20 72 65 73 75 6c 74 20 62 6f 6f Write result boo
25a90 6c 65 61 6e 20 68 65 72 65 20 2a 2f 0a 29 7b 0a lean here */.){.
25aa0 20 20 69 6e 74 20 61 6d 6f 64 65 20 3d 20 30 3b int amode = 0;
25ab0 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
25ac0 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
25ad0 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 SimulateIOError(
25ae0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
25af0 4f 45 52 52 5f 41 43 43 45 53 53 3b 20 29 3b 0a OERR_ACCESS; );.
25b00 20 20 73 77 69 74 63 68 28 20 66 6c 61 67 73 20 switch( flags
25b10 29 7b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 ){. case SQLI
25b20 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54 53 TE_ACCESS_EXISTS
25b30 3a 0a 20 20 20 20 20 20 61 6d 6f 64 65 20 3d 20 :. amode =
25b40 46 5f 4f 4b 3b 0a 20 20 20 20 20 20 62 72 65 61 F_OK;. brea
25b50 6b 3b 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 k;. case SQLI
25b60 54 45 5f 41 43 43 45 53 53 5f 52 45 41 44 57 52 TE_ACCESS_READWR
25b70 49 54 45 3a 0a 20 20 20 20 20 20 61 6d 6f 64 65 ITE:. amode
25b80 20 3d 20 57 5f 4f 4b 7c 52 5f 4f 4b 3b 0a 20 20 = W_OK|R_OK;.
25b90 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 63 break;. c
25ba0 61 73 65 20 53 51 4c 49 54 45 5f 41 43 43 45 53 ase SQLITE_ACCES
25bb0 53 5f 52 45 41 44 3a 0a 20 20 20 20 20 20 61 6d S_READ:. am
25bc0 6f 64 65 20 3d 20 52 5f 4f 4b 3b 0a 20 20 20 20 ode = R_OK;.
25bd0 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 64 65 break;.. de
25be0 66 61 75 6c 74 3a 0a 20 20 20 20 20 20 61 73 73 fault:. ass
25bf0 65 72 74 28 21 22 49 6e 76 61 6c 69 64 20 66 6c ert(!"Invalid fl
25c00 61 67 73 20 61 72 67 75 6d 65 6e 74 22 29 3b 0a ags argument");.
25c10 20 20 7d 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d }. *pResOut =
25c20 20 28 61 63 63 65 73 73 28 7a 50 61 74 68 2c 20 (access(zPath,
25c30 61 6d 6f 64 65 29 3d 3d 30 29 3b 0a 20 20 72 65 amode)==0);. re
25c40 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
25c50 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 75 72 6e 20 61 }.../*.** Turn a
25c60 20 72 65 6c 61 74 69 76 65 20 70 61 74 68 6e 61 relative pathna
25c70 6d 65 20 69 6e 74 6f 20 61 20 66 75 6c 6c 20 70 me into a full p
25c80 61 74 68 6e 61 6d 65 2e 20 54 68 65 20 72 65 6c athname. The rel
25c90 61 74 69 76 65 20 70 61 74 68 0a 2a 2a 20 69 73 ative path.** is
25ca0 20 73 74 6f 72 65 64 20 61 73 20 61 20 6e 75 6c stored as a nul
25cb0 2d 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 -terminated stri
25cc0 6e 67 20 69 6e 20 74 68 65 20 62 75 66 66 65 72 ng in the buffer
25cd0 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 0a 2a pointed to by.*
25ce0 2a 20 7a 50 61 74 68 2e 20 0a 2a 2a 0a 2a 2a 20 * zPath. .**.**
25cf0 7a 4f 75 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 zOut points to a
25d00 20 62 75 66 66 65 72 20 6f 66 20 61 74 20 6c 65 buffer of at le
25d10 61 73 74 20 73 71 6c 69 74 65 33 5f 76 66 73 2e ast sqlite3_vfs.
25d20 6d 78 50 61 74 68 6e 61 6d 65 20 62 79 74 65 73 mxPathname bytes
25d30 20 0a 2a 2a 20 28 69 6e 20 74 68 69 73 20 63 61 .** (in this ca
25d40 73 65 2c 20 4d 41 58 5f 50 41 54 48 4e 41 4d 45 se, MAX_PATHNAME
25d50 20 62 79 74 65 73 29 2e 20 54 68 65 20 66 75 6c bytes). The ful
25d60 6c 2d 70 61 74 68 20 69 73 20 77 72 69 74 74 65 l-path is writte
25d70 6e 20 74 6f 0a 2a 2a 20 74 68 69 73 20 62 75 66 n to.** this buf
25d80 66 65 72 20 62 65 66 6f 72 65 20 72 65 74 75 72 fer before retur
25d90 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ning..*/.static
25da0 69 6e 74 20 75 6e 69 78 46 75 6c 6c 50 61 74 68 int unixFullPath
25db0 6e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f name(. sqlite3_
25dc0 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 vfs *pVfs,
25dd0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
25de0 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74 20 2a to vfs object *
25df0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
25e00 7a 50 61 74 68 2c 20 20 20 20 20 20 20 20 20 20 zPath,
25e10 20 20 2f 2a 20 50 6f 73 73 69 62 6c 79 20 72 65 /* Possibly re
25e20 6c 61 74 69 76 65 20 69 6e 70 75 74 20 70 61 74 lative input pat
25e30 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74 2c h */. int nOut,
25e40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25e50 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
25e60 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69 6e output buffer in
25e70 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 61 72 bytes */. char
25e80 20 2a 7a 4f 75 74 20 20 20 20 20 20 20 20 20 20 *zOut
25e90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75 74 /* Out
25ea0 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 29 7b put buffer */.){
25eb0 0a 0a 20 20 2f 2a 20 49 74 27 73 20 6f 64 64 20 .. /* It's odd
25ec0 74 6f 20 73 69 6d 75 6c 61 74 65 20 61 6e 20 69 to simulate an i
25ed0 6f 2d 65 72 72 6f 72 20 68 65 72 65 2c 20 62 75 o-error here, bu
25ee0 74 20 72 65 61 6c 6c 79 20 74 68 69 73 20 69 73 t really this is
25ef0 20 6a 75 73 74 0a 20 20 2a 2a 20 75 73 69 6e 67 just. ** using
25f00 20 74 68 65 20 69 6f 2d 65 72 72 6f 72 20 69 6e the io-error in
25f10 66 72 61 73 74 72 75 63 74 75 72 65 20 74 6f 20 frastructure to
25f20 74 65 73 74 20 74 68 61 74 20 53 51 4c 69 74 65 test that SQLite
25f30 20 68 61 6e 64 6c 65 73 20 74 68 69 73 0a 20 20 handles this.
25f40 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 66 61 69 6c ** function fail
25f50 69 6e 67 2e 20 54 68 69 73 20 66 75 6e 63 74 69 ing. This functi
25f60 6f 6e 20 63 6f 75 6c 64 20 66 61 69 6c 20 69 66 on could fail if
25f70 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 , for example, t
25f80 68 65 0a 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 he. ** current
25f90 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 working director
25fa0 79 20 68 61 73 20 62 65 65 6e 20 75 6e 6c 69 6e y has been unlin
25fb0 6b 65 64 2e 0a 20 20 2a 2f 0a 20 20 53 69 6d 75 ked.. */. Simu
25fc0 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65 74 lateIOError( ret
25fd0 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 urn SQLITE_ERROR
25fe0 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 );.. assert( p
25ff0 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 3d Vfs->mxPathname=
26000 3d 4d 41 58 5f 50 41 54 48 4e 41 4d 45 20 29 3b =MAX_PATHNAME );
26010 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
26020 54 45 52 28 70 56 66 73 29 3b 0a 0a 20 20 7a 4f TER(pVfs);.. zO
26030 75 74 5b 6e 4f 75 74 2d 31 5d 20 3d 20 27 5c 30 ut[nOut-1] = '\0
26040 27 3b 0a 20 20 69 66 28 20 7a 50 61 74 68 5b 30 ';. if( zPath[0
26050 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 73 71 ]=='/' ){. sq
26060 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e lite3_snprintf(n
26070 4f 75 74 2c 20 7a 4f 75 74 2c 20 22 25 73 22 2c Out, zOut, "%s",
26080 20 7a 50 61 74 68 29 3b 0a 20 20 7d 65 6c 73 65 zPath);. }else
26090 7b 0a 20 20 20 20 69 6e 74 20 6e 43 77 64 3b 0a {. int nCwd;.
260a0 20 20 20 20 69 66 28 20 67 65 74 63 77 64 28 7a if( getcwd(z
260b0 4f 75 74 2c 20 6e 4f 75 74 2d 31 29 3d 3d 30 20 Out, nOut-1)==0
260c0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
260d0 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
260e0 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 BKPT;. }.
260f0 6e 43 77 64 20 3d 20 28 69 6e 74 29 73 74 72 6c nCwd = (int)strl
26100 65 6e 28 7a 4f 75 74 29 3b 0a 20 20 20 20 73 71 en(zOut);. sq
26110 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e lite3_snprintf(n
26120 4f 75 74 2d 6e 43 77 64 2c 20 26 7a 4f 75 74 5b Out-nCwd, &zOut[
26130 6e 43 77 64 5d 2c 20 22 2f 25 73 22 2c 20 7a 50 nCwd], "/%s", zP
26140 61 74 68 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 ath);. }. retu
26150 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
26160 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
26170 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e _OMIT_LOAD_EXTEN
26180 53 49 4f 4e 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 72 SION./*.** Inter
26190 66 61 63 65 73 20 66 6f 72 20 6f 70 65 6e 69 6e faces for openin
261a0 67 20 61 20 73 68 61 72 65 64 20 6c 69 62 72 61 g a shared libra
261b0 72 79 2c 20 66 69 6e 64 69 6e 67 20 65 6e 74 72 ry, finding entr
261c0 79 20 70 6f 69 6e 74 73 0a 2a 2a 20 77 69 74 68 y points.** with
261d0 69 6e 20 74 68 65 20 73 68 61 72 65 64 20 6c 69 in the shared li
261e0 62 72 61 72 79 2c 20 61 6e 64 20 63 6c 6f 73 69 brary, and closi
261f0 6e 67 20 74 68 65 20 73 68 61 72 65 64 20 6c 69 ng the shared li
26200 62 72 61 72 79 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 brary..*/.#inclu
26210 64 65 20 3c 64 6c 66 63 6e 2e 68 3e 0a 73 74 61 de <dlfcn.h>.sta
26220 74 69 63 20 76 6f 69 64 20 2a 75 6e 69 78 44 6c tic void *unixDl
26230 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66 73 Open(sqlite3_vfs
26240 20 2a 4e 6f 74 55 73 65 64 2c 20 63 6f 6e 73 74 *NotUsed, const
26250 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 char *zFilename
26260 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 ){. UNUSED_PARA
26270 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a METER(NotUsed);.
26280 20 20 72 65 74 75 72 6e 20 64 6c 6f 70 65 6e 28 return dlopen(
26290 7a 46 69 6c 65 6e 61 6d 65 2c 20 52 54 4c 44 5f zFilename, RTLD_
262a0 4e 4f 57 20 7c 20 52 54 4c 44 5f 47 4c 4f 42 41 NOW | RTLD_GLOBA
262b0 4c 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c L);.}../*.** SQL
262c0 69 74 65 20 63 61 6c 6c 73 20 74 68 69 73 20 66 ite calls this f
262d0 75 6e 63 74 69 6f 6e 20 69 6d 6d 65 64 69 61 74 unction immediat
262e0 65 6c 79 20 61 66 74 65 72 20 61 20 63 61 6c 6c ely after a call
262f0 20 74 6f 20 75 6e 69 78 44 6c 53 79 6d 28 29 20 to unixDlSym()
26300 6f 72 0a 2a 2a 20 75 6e 69 78 44 6c 4f 70 65 6e or.** unixDlOpen
26310 28 29 20 66 61 69 6c 73 20 28 72 65 74 75 72 6e () fails (return
26320 73 20 61 20 6e 75 6c 6c 20 70 6f 69 6e 74 65 72 s a null pointer
26330 29 2e 20 49 66 20 61 20 6d 6f 72 65 20 64 65 74 ). If a more det
26340 61 69 6c 65 64 20 65 72 72 6f 72 0a 2a 2a 20 6d ailed error.** m
26350 65 73 73 61 67 65 20 69 73 20 61 76 61 69 6c 61 essage is availa
26360 62 6c 65 2c 20 69 74 20 69 73 20 77 72 69 74 74 ble, it is writt
26370 65 6e 20 74 6f 20 7a 42 75 66 4f 75 74 2e 20 49 en to zBufOut. I
26380 66 20 6e 6f 20 65 72 72 6f 72 20 6d 65 73 73 61 f no error messa
26390 67 65 0a 2a 2a 20 69 73 20 61 76 61 69 6c 61 62 ge.** is availab
263a0 6c 65 2c 20 7a 42 75 66 4f 75 74 20 69 73 20 6c le, zBufOut is l
263b0 65 66 74 20 75 6e 6d 6f 64 69 66 69 65 64 20 61 eft unmodified a
263c0 6e 64 20 53 51 4c 69 74 65 20 75 73 65 73 20 61 nd SQLite uses a
263d0 20 64 65 66 61 75 6c 74 0a 2a 2a 20 65 72 72 6f default.** erro
263e0 72 20 6d 65 73 73 61 67 65 2e 0a 2a 2f 0a 73 74 r message..*/.st
263f0 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78 44 6c atic void unixDl
26400 45 72 72 6f 72 28 73 71 6c 69 74 65 33 5f 76 66 Error(sqlite3_vf
26410 73 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e 74 20 s *NotUsed, int
26420 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a 42 75 66 nBuf, char *zBuf
26430 4f 75 74 29 7b 0a 20 20 63 68 61 72 20 2a 7a 45 Out){. char *zE
26440 72 72 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 rr;. UNUSED_PAR
26450 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b AMETER(NotUsed);
26460 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 . unixEnterMute
26470 78 28 29 3b 0a 20 20 7a 45 72 72 20 3d 20 64 6c x();. zErr = dl
26480 65 72 72 6f 72 28 29 3b 0a 20 20 69 66 28 20 7a error();. if( z
26490 45 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 Err ){. sqlit
264a0 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e 42 75 66 e3_snprintf(nBuf
264b0 2c 20 7a 42 75 66 4f 75 74 2c 20 22 25 73 22 2c , zBufOut, "%s",
264c0 20 7a 45 72 72 29 3b 0a 20 20 7d 0a 20 20 75 6e zErr);. }. un
264d0 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a ixLeaveMutex();.
264e0 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 28 2a }.static void (*
264f0 75 6e 69 78 44 6c 53 79 6d 28 73 71 6c 69 74 65 unixDlSym(sqlite
26500 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 3_vfs *NotUsed,
26510 76 6f 69 64 20 2a 70 2c 20 63 6f 6e 73 74 20 63 void *p, const c
26520 68 61 72 2a 7a 53 79 6d 29 29 28 76 6f 69 64 29 har*zSym))(void)
26530 7b 0a 20 20 2f 2a 20 0a 20 20 2a 2a 20 47 43 43 {. /* . ** GCC
26540 20 77 69 74 68 20 2d 70 65 64 61 6e 74 69 63 2d with -pedantic-
26550 65 72 72 6f 72 73 20 73 61 79 73 20 74 68 61 74 errors says that
26560 20 43 39 30 20 64 6f 65 73 20 6e 6f 74 20 61 6c C90 does not al
26570 6c 6f 77 20 61 20 76 6f 69 64 2a 20 74 6f 20 62 low a void* to b
26580 65 0a 20 20 2a 2a 20 63 61 73 74 20 69 6e 74 6f e. ** cast into
26590 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
265a0 66 75 6e 63 74 69 6f 6e 2e 20 20 41 6e 64 20 79 function. And y
265b0 65 74 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 et the library d
265c0 6c 73 79 6d 28 29 20 72 6f 75 74 69 6e 65 0a 20 lsym() routine.
265d0 20 2a 2a 20 72 65 74 75 72 6e 73 20 61 20 76 6f ** returns a vo
265e0 69 64 2a 20 77 68 69 63 68 20 69 73 20 72 65 61 id* which is rea
265f0 6c 6c 79 20 61 20 70 6f 69 6e 74 65 72 20 74 6f lly a pointer to
26600 20 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 53 6f a function. So
26610 20 68 6f 77 20 64 6f 20 77 65 0a 20 20 2a 2a 20 how do we. **
26620 75 73 65 20 64 6c 73 79 6d 28 29 20 77 69 74 68 use dlsym() with
26630 20 2d 70 65 64 61 6e 74 69 63 2d 65 72 72 6f 72 -pedantic-error
26640 73 3f 0a 20 20 2a 2a 0a 20 20 2a 2a 20 56 61 72 s?. **. ** Var
26650 69 61 62 6c 65 20 78 20 62 65 6c 6f 77 20 69 73 iable x below is
26660 20 64 65 66 69 6e 65 64 20 74 6f 20 62 65 20 61 defined to be a
26670 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 pointer to a fu
26680 6e 63 74 69 6f 6e 20 74 61 6b 69 6e 67 0a 20 20 nction taking.
26690 2a 2a 20 70 61 72 61 6d 65 74 65 72 73 20 76 6f ** parameters vo
266a0 69 64 2a 20 61 6e 64 20 63 6f 6e 73 74 20 63 68 id* and const ch
266b0 61 72 2a 20 61 6e 64 20 72 65 74 75 72 6e 69 6e ar* and returnin
266c0 67 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 g a pointer to a
266d0 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 function.. **
266e0 57 65 20 69 6e 69 74 69 61 6c 69 7a 65 20 78 20 We initialize x
266f0 62 79 20 61 73 73 69 67 6e 69 6e 67 20 69 74 20 by assigning it
26700 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
26710 20 64 6c 73 79 6d 28 29 20 66 75 6e 63 74 69 6f dlsym() functio
26720 6e 2e 0a 20 20 2a 2a 20 28 54 68 61 74 20 61 73 n.. ** (That as
26730 73 69 67 6e 6d 65 6e 74 20 72 65 71 75 69 72 65 signment require
26740 73 20 61 20 63 61 73 74 2e 29 20 20 54 68 65 6e s a cast.) Then
26750 20 77 65 20 63 61 6c 6c 20 74 68 65 20 66 75 6e we call the fun
26760 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 2a 2a 20 ction that. **
26770 78 20 70 6f 69 6e 74 73 20 74 6f 2e 20 20 0a 20 x points to. .
26780 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 20 77 6f **. ** This wo
26790 72 6b 2d 61 72 6f 75 6e 64 20 69 73 20 75 6e 6c rk-around is unl
267a0 69 6b 65 6c 79 20 74 6f 20 77 6f 72 6b 20 63 6f ikely to work co
267b0 72 72 65 63 74 6c 79 20 6f 6e 20 61 6e 79 20 73 rrectly on any s
267c0 79 73 74 65 6d 20 77 68 65 72 65 0a 20 20 2a 2a ystem where. **
267d0 20 79 6f 75 20 72 65 61 6c 6c 79 20 63 61 6e 6e you really cann
267e0 6f 74 20 63 61 73 74 20 61 20 66 75 6e 63 74 69 ot cast a functi
267f0 6f 6e 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f 20 on pointer into
26800 76 6f 69 64 2a 2e 20 20 42 75 74 20 74 68 65 6e void*. But then
26810 2c 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 6f 74 , on the. ** ot
26820 68 65 72 20 68 61 6e 64 2c 20 64 6c 73 79 6d 28 her hand, dlsym(
26830 29 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 ) will not work
26840 6f 6e 20 73 75 63 68 20 61 20 73 79 73 74 65 6d on such a system
26850 20 65 69 74 68 65 72 2c 20 73 6f 20 77 65 20 68 either, so we h
26860 61 76 65 0a 20 20 2a 2a 20 6e 6f 74 20 72 65 61 ave. ** not rea
26870 6c 6c 79 20 6c 6f 73 74 20 61 6e 79 74 68 69 6e lly lost anythin
26880 67 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 g.. */. void (
26890 2a 28 2a 78 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 *(*x)(void*,cons
268a0 74 20 63 68 61 72 2a 29 29 28 76 6f 69 64 29 3b t char*))(void);
268b0 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
268c0 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
268d0 78 20 3d 20 28 76 6f 69 64 28 2a 28 2a 29 28 76 x = (void(*(*)(v
268e0 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
268f0 29 29 28 76 6f 69 64 29 29 64 6c 73 79 6d 3b 0a ))(void))dlsym;.
26900 20 20 72 65 74 75 72 6e 20 28 2a 78 29 28 70 2c return (*x)(p,
26910 20 7a 53 79 6d 29 3b 0a 7d 0a 73 74 61 74 69 63 zSym);.}.static
26920 20 76 6f 69 64 20 75 6e 69 78 44 6c 43 6c 6f 73 void unixDlClos
26930 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e e(sqlite3_vfs *N
26940 6f 74 55 73 65 64 2c 20 76 6f 69 64 20 2a 70 48 otUsed, void *pH
26950 61 6e 64 6c 65 29 7b 0a 20 20 55 4e 55 53 45 44 andle){. UNUSED
26960 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 _PARAMETER(NotUs
26970 65 64 29 3b 0a 20 20 64 6c 63 6c 6f 73 65 28 70 ed);. dlclose(p
26980 48 61 6e 64 6c 65 29 3b 0a 7d 0a 23 65 6c 73 65 Handle);.}.#else
26990 20 2f 2a 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d /* if SQLITE_OM
269a0 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f IT_LOAD_EXTENSIO
269b0 4e 20 69 73 20 64 65 66 69 6e 65 64 3a 20 2a 2f N is defined: */
269c0 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44 . #define unixD
269d0 6c 4f 70 65 6e 20 20 30 0a 20 20 23 64 65 66 69 lOpen 0. #defi
269e0 6e 65 20 75 6e 69 78 44 6c 45 72 72 6f 72 20 30 ne unixDlError 0
269f0 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44 . #define unixD
26a00 6c 53 79 6d 20 20 20 30 0a 20 20 23 64 65 66 69 lSym 0. #defi
26a10 6e 65 20 75 6e 69 78 44 6c 43 6c 6f 73 65 20 30 ne unixDlClose 0
26a20 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 .#endif../*.** W
26a30 72 69 74 65 20 6e 42 75 66 20 62 79 74 65 73 20 rite nBuf bytes
26a40 6f 66 20 72 61 6e 64 6f 6d 20 64 61 74 61 20 74 of random data t
26a50 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 62 o the supplied b
26a60 75 66 66 65 72 20 7a 42 75 66 2e 0a 2a 2f 0a 73 uffer zBuf..*/.s
26a70 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 52 61 tatic int unixRa
26a80 6e 64 6f 6d 6e 65 73 73 28 73 71 6c 69 74 65 33 ndomness(sqlite3
26a90 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 69 _vfs *NotUsed, i
26aa0 6e 74 20 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a nt nBuf, char *z
26ab0 42 75 66 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 Buf){. UNUSED_P
26ac0 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 ARAMETER(NotUsed
26ad0 29 3b 0a 20 20 61 73 73 65 72 74 28 28 73 69 7a );. assert((siz
26ae0 65 5f 74 29 6e 42 75 66 3e 3d 28 73 69 7a 65 6f e_t)nBuf>=(sizeo
26af0 66 28 74 69 6d 65 5f 74 29 2b 73 69 7a 65 6f 66 f(time_t)+sizeof
26b00 28 69 6e 74 29 29 29 3b 0a 0a 20 20 2f 2a 20 57 (int)));.. /* W
26b10 65 20 68 61 76 65 20 74 6f 20 69 6e 69 74 69 61 e have to initia
26b20 6c 69 7a 65 20 7a 42 75 66 20 74 6f 20 70 72 65 lize zBuf to pre
26b30 76 65 6e 74 20 76 61 6c 67 72 69 6e 64 20 66 72 vent valgrind fr
26b40 6f 6d 20 72 65 70 6f 72 74 69 6e 67 0a 20 20 2a om reporting. *
26b50 2a 20 65 72 72 6f 72 73 2e 20 20 54 68 65 20 72 * errors. The r
26b60 65 70 6f 72 74 73 20 69 73 73 75 65 64 20 62 79 eports issued by
26b70 20 76 61 6c 67 72 69 6e 64 20 61 72 65 20 69 6e valgrind are in
26b80 63 6f 72 72 65 63 74 20 2d 20 77 65 20 77 6f 75 correct - we wou
26b90 6c 64 0a 20 20 2a 2a 20 70 72 65 66 65 72 20 74 ld. ** prefer t
26ba0 68 61 74 20 74 68 65 20 72 61 6e 64 6f 6d 6e 65 hat the randomne
26bb0 73 73 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 ss be increased
26bc0 62 79 20 6d 61 6b 69 6e 67 20 75 73 65 20 6f 66 by making use of
26bd0 20 74 68 65 0a 20 20 2a 2a 20 75 6e 69 6e 69 74 the. ** uninit
26be0 69 61 6c 69 7a 65 64 20 73 70 61 63 65 20 69 6e ialized space in
26bf0 20 7a 42 75 66 20 2d 20 62 75 74 20 76 61 6c 67 zBuf - but valg
26c00 72 69 6e 64 20 65 72 72 6f 72 73 20 74 65 6e 64 rind errors tend
26c10 20 74 6f 20 77 6f 72 72 79 0a 20 20 2a 2a 20 73 to worry. ** s
26c20 6f 6d 65 20 75 73 65 72 73 2e 20 20 52 61 74 68 ome users. Rath
26c30 65 72 20 74 68 61 6e 20 61 72 67 75 65 2c 20 69 er than argue, i
26c40 74 20 73 65 65 6d 73 20 65 61 73 69 65 72 20 6a t seems easier j
26c50 75 73 74 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a ust to initializ
26c60 65 0a 20 20 2a 2a 20 74 68 65 20 77 68 6f 6c 65 e. ** the whole
26c70 20 61 72 72 61 79 20 61 6e 64 20 73 69 6c 65 6e array and silen
26c80 63 65 20 76 61 6c 67 72 69 6e 64 2c 20 65 76 65 ce valgrind, eve
26c90 6e 20 69 66 20 74 68 61 74 20 6d 65 61 6e 73 20 n if that means
26ca0 6c 65 73 73 20 72 61 6e 64 6f 6d 6e 65 73 73 0a less randomness.
26cb0 20 20 2a 2a 20 69 6e 20 74 68 65 20 72 61 6e 64 ** in the rand
26cc0 6f 6d 20 73 65 65 64 2e 0a 20 20 2a 2a 0a 20 20 om seed.. **.
26cd0 2a 2a 20 57 68 65 6e 20 74 65 73 74 69 6e 67 2c ** When testing,
26ce0 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 7a 42 initializing zB
26cf0 75 66 5b 5d 20 74 6f 20 7a 65 72 6f 20 69 73 20 uf[] to zero is
26d00 61 6c 6c 20 77 65 20 64 6f 2e 20 20 54 68 61 74 all we do. That
26d10 20 6d 65 61 6e 73 0a 20 20 2a 2a 20 74 68 61 74 means. ** that
26d20 20 77 65 20 61 6c 77 61 79 73 20 75 73 65 20 74 we always use t
26d30 68 65 20 73 61 6d 65 20 72 61 6e 64 6f 6d 20 6e he same random n
26d40 75 6d 62 65 72 20 73 65 71 75 65 6e 63 65 2e 20 umber sequence.
26d50 20 54 68 69 73 20 6d 61 6b 65 73 20 74 68 65 0a This makes the.
26d60 20 20 2a 2a 20 74 65 73 74 73 20 72 65 70 65 61 ** tests repea
26d70 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 6d 65 table.. */. me
26d80 6d 73 65 74 28 7a 42 75 66 2c 20 30 2c 20 6e 42 mset(zBuf, 0, nB
26d90 75 66 29 3b 0a 23 69 66 20 21 64 65 66 69 6e 65 uf);.#if !define
26da0 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a 20 d(SQLITE_TEST).
26db0 20 7b 0a 20 20 20 20 69 6e 74 20 70 69 64 2c 20 {. int pid,
26dc0 66 64 3b 0a 20 20 20 20 66 64 20 3d 20 6f 70 65 fd;. fd = ope
26dd0 6e 28 22 2f 64 65 76 2f 75 72 61 6e 64 6f 6d 22 n("/dev/urandom"
26de0 2c 20 4f 5f 52 44 4f 4e 4c 59 29 3b 0a 20 20 20 , O_RDONLY);.
26df0 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 if( fd<0 ){.
26e00 20 20 20 74 69 6d 65 5f 74 20 74 3b 0a 20 20 20 time_t t;.
26e10 20 20 20 74 69 6d 65 28 26 74 29 3b 0a 20 20 20 time(&t);.
26e20 20 20 20 6d 65 6d 63 70 79 28 7a 42 75 66 2c 20 memcpy(zBuf,
26e30 26 74 2c 20 73 69 7a 65 6f 66 28 74 29 29 3b 0a &t, sizeof(t));.
26e40 20 20 20 20 20 20 70 69 64 20 3d 20 67 65 74 70 pid = getp
26e50 69 64 28 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 id();. memc
26e60 70 79 28 26 7a 42 75 66 5b 73 69 7a 65 6f 66 28 py(&zBuf[sizeof(
26e70 74 29 5d 2c 20 26 70 69 64 2c 20 73 69 7a 65 6f t)], &pid, sizeo
26e80 66 28 70 69 64 29 29 3b 0a 20 20 20 20 20 20 61 f(pid));. a
26e90 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 74 29 ssert( sizeof(t)
26ea0 2b 73 69 7a 65 6f 66 28 70 69 64 29 3c 3d 28 73 +sizeof(pid)<=(s
26eb0 69 7a 65 5f 74 29 6e 42 75 66 20 29 3b 0a 20 20 ize_t)nBuf );.
26ec0 20 20 20 20 6e 42 75 66 20 3d 20 73 69 7a 65 6f nBuf = sizeo
26ed0 66 28 74 29 20 2b 20 73 69 7a 65 6f 66 28 70 69 f(t) + sizeof(pi
26ee0 64 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 d);. }else{.
26ef0 20 20 20 20 20 6e 42 75 66 20 3d 20 72 65 61 64 nBuf = read
26f00 28 66 64 2c 20 7a 42 75 66 2c 20 6e 42 75 66 29 (fd, zBuf, nBuf)
26f10 3b 0a 20 20 20 20 20 20 63 6c 6f 73 65 28 66 64 ;. close(fd
26f20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e );. }. }.#en
26f30 64 69 66 0a 20 20 72 65 74 75 72 6e 20 6e 42 75 dif. return nBu
26f40 66 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 f;.}.../*.** Sle
26f50 65 70 20 66 6f 72 20 61 20 6c 69 74 74 6c 65 20 ep for a little
26f60 77 68 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 74 while. Return t
26f70 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d he amount of tim
26f80 65 20 73 6c 65 70 74 2e 0a 2a 2a 20 54 68 65 20 e slept..** The
26f90 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 argument is the
26fa0 6e 75 6d 62 65 72 20 6f 66 20 6d 69 63 72 6f 73 number of micros
26fb0 65 63 6f 6e 64 73 20 77 65 20 77 61 6e 74 20 74 econds we want t
26fc0 6f 20 73 6c 65 65 70 2e 0a 2a 2a 20 54 68 65 20 o sleep..** The
26fd0 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 return value is
26fe0 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 the number of mi
26ff0 63 72 6f 73 65 63 6f 6e 64 73 20 6f 66 20 73 6c croseconds of sl
27000 65 65 70 20 61 63 74 75 61 6c 6c 79 0a 2a 2a 20 eep actually.**
27010 72 65 71 75 65 73 74 65 64 20 66 72 6f 6d 20 74 requested from t
27020 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 he underlying op
27030 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 2c 20 erating system,
27040 61 20 6e 75 6d 62 65 72 20 77 68 69 63 68 0a 2a a number which.*
27050 2a 20 6d 69 67 68 74 20 62 65 20 67 72 65 61 74 * might be great
27060 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c er than or equal
27070 20 74 6f 20 74 68 65 20 61 72 67 75 6d 65 6e 74 to the argument
27080 2c 20 62 75 74 20 6e 6f 74 20 6c 65 73 73 0a 2a , but not less.*
27090 2a 20 74 68 61 6e 20 74 68 65 20 61 72 67 75 6d * than the argum
270a0 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ent..*/.static i
270b0 6e 74 20 75 6e 69 78 53 6c 65 65 70 28 73 71 6c nt unixSleep(sql
270c0 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 ite3_vfs *NotUse
270d0 64 2c 20 69 6e 74 20 6d 69 63 72 6f 73 65 63 6f d, int microseco
270e0 6e 64 73 29 7b 0a 23 69 66 20 4f 53 5f 56 58 57 nds){.#if OS_VXW
270f0 4f 52 4b 53 0a 20 20 73 74 72 75 63 74 20 74 69 ORKS. struct ti
27100 6d 65 73 70 65 63 20 73 70 3b 0a 0a 20 20 73 70 mespec sp;.. sp
27110 2e 74 76 5f 73 65 63 20 3d 20 6d 69 63 72 6f 73 .tv_sec = micros
27120 65 63 6f 6e 64 73 20 2f 20 31 30 30 30 30 30 30 econds / 1000000
27130 3b 0a 20 20 73 70 2e 74 76 5f 6e 73 65 63 20 3d ;. sp.tv_nsec =
27140 20 28 6d 69 63 72 6f 73 65 63 6f 6e 64 73 20 25 (microseconds %
27150 20 31 30 30 30 30 30 30 29 20 2a 20 31 30 30 30 1000000) * 1000
27160 3b 0a 20 20 6e 61 6e 6f 73 6c 65 65 70 28 26 73 ;. nanosleep(&s
27170 70 2c 20 4e 55 4c 4c 29 3b 0a 20 20 55 4e 55 53 p, NULL);. UNUS
27180 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 ED_PARAMETER(Not
27190 55 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 Used);. return
271a0 6d 69 63 72 6f 73 65 63 6f 6e 64 73 3b 0a 23 65 microseconds;.#e
271b0 6c 69 66 20 64 65 66 69 6e 65 64 28 48 41 56 45 lif defined(HAVE
271c0 5f 55 53 4c 45 45 50 29 20 26 26 20 48 41 56 45 _USLEEP) && HAVE
271d0 5f 55 53 4c 45 45 50 0a 20 20 75 73 6c 65 65 70 _USLEEP. usleep
271e0 28 6d 69 63 72 6f 73 65 63 6f 6e 64 73 29 3b 0a (microseconds);.
271f0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
27200 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 72 ER(NotUsed);. r
27210 65 74 75 72 6e 20 6d 69 63 72 6f 73 65 63 6f 6e eturn microsecon
27220 64 73 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 ds;.#else. int
27230 73 65 63 6f 6e 64 73 20 3d 20 28 6d 69 63 72 6f seconds = (micro
27240 73 65 63 6f 6e 64 73 2b 39 39 39 39 39 39 29 2f seconds+999999)/
27250 31 30 30 30 30 30 30 3b 0a 20 20 73 6c 65 65 70 1000000;. sleep
27260 28 73 65 63 6f 6e 64 73 29 3b 0a 20 20 55 4e 55 (seconds);. UNU
27270 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
27280 74 55 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e tUsed);. return
27290 20 73 65 63 6f 6e 64 73 2a 31 30 30 30 30 30 30 seconds*1000000
272a0 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
272b0 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
272c0 76 61 72 69 61 62 6c 65 2c 20 69 66 20 73 65 74 variable, if set
272d0 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 to a non-zero v
272e0 61 6c 75 65 2c 20 69 73 20 69 6e 74 65 72 70 72 alue, is interpr
272f0 65 74 65 64 20 61 73 0a 2a 2a 20 74 68 65 20 6e eted as.** the n
27300 75 6d 62 65 72 20 6f 66 20 73 65 63 6f 6e 64 73 umber of seconds
27310 20 73 69 6e 63 65 20 31 39 37 30 20 61 6e 64 20 since 1970 and
27320 69 73 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 is used to set t
27330 68 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a 2a 20 he result of.**
27340 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65 6e 74 sqlite3OsCurrent
27350 54 69 6d 65 28 29 20 64 75 72 69 6e 67 20 74 65 Time() during te
27360 73 74 69 6e 67 2e 0a 2a 2f 0a 23 69 66 64 65 66 sting..*/.#ifdef
27370 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 69 6e 74 SQLITE_TEST.int
27380 20 73 71 6c 69 74 65 33 5f 63 75 72 72 65 6e 74 sqlite3_current
27390 5f 74 69 6d 65 20 3d 20 30 3b 20 20 2f 2a 20 46 _time = 0; /* F
273a0 61 6b 65 20 73 79 73 74 65 6d 20 74 69 6d 65 20 ake system time
273b0 69 6e 20 73 65 63 6f 6e 64 73 20 73 69 6e 63 65 in seconds since
273c0 20 31 39 37 30 2e 20 2a 2f 0a 23 65 6e 64 69 66 1970. */.#endif
273d0 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 74 68 65 ../*.** Find the
273e0 20 63 75 72 72 65 6e 74 20 74 69 6d 65 20 28 69 current time (i
273f0 6e 20 55 6e 69 76 65 72 73 61 6c 20 43 6f 6f 72 n Universal Coor
27400 64 69 6e 61 74 65 64 20 54 69 6d 65 29 2e 20 20 dinated Time).
27410 57 72 69 74 65 20 69 6e 74 6f 20 2a 70 69 4e 6f Write into *piNo
27420 77 0a 2a 2a 20 74 68 65 20 63 75 72 72 65 6e 74 w.** the current
27430 20 74 69 6d 65 20 61 6e 64 20 64 61 74 65 20 61 time and date a
27440 73 20 61 20 4a 75 6c 69 61 6e 20 44 61 79 20 6e s a Julian Day n
27450 75 6d 62 65 72 20 74 69 6d 65 73 20 38 36 5f 34 umber times 86_4
27460 30 30 5f 30 30 30 2e 20 20 49 6e 0a 2a 2a 20 6f 00_000. In.** o
27470 74 68 65 72 20 77 6f 72 64 73 2c 20 77 72 69 74 ther words, writ
27480 65 20 69 6e 74 6f 20 2a 70 69 4e 6f 77 20 74 68 e into *piNow th
27490 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c e number of mill
274a0 69 73 65 63 6f 6e 64 73 20 73 69 6e 63 65 20 74 iseconds since t
274b0 68 65 20 4a 75 6c 69 61 6e 0a 2a 2a 20 65 70 6f he Julian.** epo
274c0 63 68 20 6f 66 20 6e 6f 6f 6e 20 69 6e 20 47 72 ch of noon in Gr
274d0 65 65 6e 77 69 63 68 20 6f 6e 20 4e 6f 76 65 6d eenwich on Novem
274e0 62 65 72 20 32 34 2c 20 34 37 31 34 20 42 2e 43 ber 24, 4714 B.C
274f0 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 according to th
27500 65 0a 2a 2a 20 70 72 6f 6c 65 70 74 69 63 20 47 e.** proleptic G
27510 72 65 67 6f 72 69 61 6e 20 63 61 6c 65 6e 64 61 regorian calenda
27520 72 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 r..**.** On succ
27530 65 73 73 2c 20 72 65 74 75 72 6e 20 30 2e 20 20 ess, return 0.
27540 52 65 74 75 72 6e 20 31 20 69 66 20 74 68 65 20 Return 1 if the
27550 74 69 6d 65 20 61 6e 64 20 64 61 74 65 20 63 61 time and date ca
27560 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2e 0a 2a nnot be found..*
27570 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 /.static int uni
27580 78 43 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36 xCurrentTimeInt6
27590 34 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 4(sqlite3_vfs *N
275a0 6f 74 55 73 65 64 2c 20 73 71 6c 69 74 65 33 5f otUsed, sqlite3_
275b0 69 6e 74 36 34 20 2a 70 69 4e 6f 77 29 7b 0a 20 int64 *piNow){.
275c0 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 static const sq
275d0 6c 69 74 65 33 5f 69 6e 74 36 34 20 75 6e 69 78 lite3_int64 unix
275e0 45 70 6f 63 68 20 3d 20 32 34 34 30 35 38 37 35 Epoch = 24405875
275f0 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 *(sqlite3_int64)
27600 38 36 34 30 30 30 30 3b 0a 23 69 66 20 64 65 66 8640000;.#if def
27610 69 6e 65 64 28 4e 4f 5f 47 45 54 54 4f 44 29 0a ined(NO_GETTOD).
27620 20 20 74 69 6d 65 5f 74 20 74 3b 0a 20 20 74 69 time_t t;. ti
27630 6d 65 28 26 74 29 3b 0a 20 20 2a 70 69 4e 6f 77 me(&t);. *piNow
27640 20 3d 20 28 28 73 71 6c 69 74 65 33 5f 69 6e 74 = ((sqlite3_int
27650 36 34 29 69 29 2a 31 30 30 30 20 2b 20 75 6e 69 64)i)*1000 + uni
27660 78 45 70 6f 63 68 3b 0a 23 65 6c 69 66 20 4f 53 xEpoch;.#elif OS
27670 5f 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 75 63 _VXWORKS. struc
27680 74 20 74 69 6d 65 73 70 65 63 20 73 4e 6f 77 3b t timespec sNow;
27690 0a 20 20 63 6c 6f 63 6b 5f 67 65 74 74 69 6d 65 . clock_gettime
276a0 28 43 4c 4f 43 4b 5f 52 45 41 4c 54 49 4d 45 2c (CLOCK_REALTIME,
276b0 20 26 73 4e 6f 77 29 3b 0a 20 20 2a 70 69 4e 6f &sNow);. *piNo
276c0 77 20 3d 20 75 6e 69 78 45 70 6f 63 68 20 2b 20 w = unixEpoch +
276d0 31 30 30 30 2a 28 73 71 6c 69 74 65 33 5f 69 6e 1000*(sqlite3_in
276e0 74 36 34 29 73 4e 6f 77 2e 74 76 5f 73 65 63 20 t64)sNow.tv_sec
276f0 2b 20 73 4e 6f 77 2e 74 76 5f 6e 73 65 63 2f 31 + sNow.tv_nsec/1
27700 30 30 30 30 30 30 3b 0a 23 65 6c 73 65 0a 20 20 000000;.#else.
27710 73 74 72 75 63 74 20 74 69 6d 65 76 61 6c 20 73 struct timeval s
27720 4e 6f 77 3b 0a 20 20 67 65 74 74 69 6d 65 6f 66 Now;. gettimeof
27730 64 61 79 28 26 73 4e 6f 77 2c 20 30 29 3b 0a 20 day(&sNow, 0);.
27740 20 2a 70 69 4e 6f 77 20 3d 20 75 6e 69 78 45 70 *piNow = unixEp
27750 6f 63 68 20 2b 20 31 30 30 30 2a 28 73 71 6c 69 och + 1000*(sqli
27760 74 65 33 5f 69 6e 74 36 34 29 73 4e 6f 77 2e 74 te3_int64)sNow.t
27770 76 5f 73 65 63 20 2b 20 73 4e 6f 77 2e 74 76 5f v_sec + sNow.tv_
27780 75 73 65 63 2f 31 30 30 30 3b 0a 23 65 6e 64 69 usec/1000;.#endi
27790 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
277a0 5f 54 45 53 54 0a 20 20 69 66 28 20 73 71 6c 69 _TEST. if( sqli
277b0 74 65 33 5f 63 75 72 72 65 6e 74 5f 74 69 6d 65 te3_current_time
277c0 20 29 7b 0a 20 20 20 20 2a 70 69 4e 6f 77 20 3d ){. *piNow =
277d0 20 31 30 30 30 2a 28 73 71 6c 69 74 65 33 5f 69 1000*(sqlite3_i
277e0 6e 74 36 34 29 73 71 6c 69 74 65 33 5f 63 75 72 nt64)sqlite3_cur
277f0 72 65 6e 74 5f 74 69 6d 65 20 2b 20 75 6e 69 78 rent_time + unix
27800 45 70 6f 63 68 3b 0a 20 20 7d 0a 23 65 6e 64 69 Epoch;. }.#endi
27810 66 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d f. UNUSED_PARAM
27820 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 ETER(NotUsed);.
27830 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a return 0;.}../*
27840 0a 2a 2a 20 46 69 6e 64 20 74 68 65 20 63 75 72 .** Find the cur
27850 72 65 6e 74 20 74 69 6d 65 20 28 69 6e 20 55 6e rent time (in Un
27860 69 76 65 72 73 61 6c 20 43 6f 6f 72 64 69 6e 61 iversal Coordina
27870 74 65 64 20 54 69 6d 65 29 2e 20 20 57 72 69 74 ted Time). Writ
27880 65 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 e the.** current
27890 20 74 69 6d 65 20 61 6e 64 20 64 61 74 65 20 61 time and date a
278a0 73 20 61 20 4a 75 6c 69 61 6e 20 44 61 79 20 6e s a Julian Day n
278b0 75 6d 62 65 72 20 69 6e 74 6f 20 2a 70 72 4e 6f umber into *prNo
278c0 77 20 61 6e 64 0a 2a 2a 20 72 65 74 75 72 6e 20 w and.** return
278d0 30 2e 20 20 52 65 74 75 72 6e 20 31 20 69 66 20 0. Return 1 if
278e0 74 68 65 20 74 69 6d 65 20 61 6e 64 20 64 61 74 the time and dat
278f0 65 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e e cannot be foun
27900 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
27910 20 75 6e 69 78 43 75 72 72 65 6e 74 54 69 6d 65 unixCurrentTime
27920 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f (sqlite3_vfs *No
27930 74 55 73 65 64 2c 20 64 6f 75 62 6c 65 20 2a 70 tUsed, double *p
27940 72 4e 6f 77 29 7b 0a 20 20 73 71 6c 69 74 65 33 rNow){. sqlite3
27950 5f 69 6e 74 36 34 20 69 3b 0a 20 20 75 6e 69 78 _int64 i;. unix
27960 43 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36 34 CurrentTimeInt64
27970 28 30 2c 20 26 69 29 3b 0a 20 20 2a 70 72 4e 6f (0, &i);. *prNo
27980 77 20 3d 20 69 2f 38 36 34 30 30 30 30 30 2e 30 w = i/86400000.0
27990 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a ;. return 0;.}.
279a0 0a 2f 2a 0a 2a 2a 20 57 65 20 61 64 64 65 64 20 ./*.** We added
279b0 74 68 65 20 78 47 65 74 4c 61 73 74 45 72 72 6f the xGetLastErro
279c0 72 28 29 20 6d 65 74 68 6f 64 20 77 69 74 68 20 r() method with
279d0 74 68 65 20 69 6e 74 65 6e 74 69 6f 6e 20 6f 66 the intention of
279e0 20 70 72 6f 76 69 64 69 6e 67 0a 2a 2a 20 62 65 providing.** be
279f0 74 74 65 72 20 6c 6f 77 2d 6c 65 76 65 6c 20 65 tter low-level e
27a00 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 77 68 rror messages wh
27a10 65 6e 20 6f 70 65 72 61 74 69 6e 67 2d 73 79 73 en operating-sys
27a20 74 65 6d 20 70 72 6f 62 6c 65 6d 73 20 63 6f 6d tem problems com
27a30 65 20 75 70 0a 2a 2a 20 64 75 72 69 6e 67 20 53 e up.** during S
27a40 51 4c 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 2e QLite operation.
27a50 20 20 42 75 74 20 73 6f 20 66 61 72 2c 20 6e 6f But so far, no
27a60 6e 65 20 6f 66 20 74 68 61 74 20 68 61 73 20 62 ne of that has b
27a70 65 65 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 0a een implemented.
27a80 2a 2a 20 69 6e 20 74 68 65 20 63 6f 72 65 2e 20 ** in the core.
27a90 20 53 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 So this routine
27aa0 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 is never called
27ab0 2e 20 20 46 6f 72 20 6e 6f 77 2c 20 69 74 20 69 . For now, it i
27ac0 73 20 6d 65 72 65 6c 79 0a 2a 2a 20 61 20 70 6c s merely.** a pl
27ad0 61 63 65 2d 68 6f 6c 64 65 72 2e 0a 2a 2f 0a 73 ace-holder..*/.s
27ae0 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 47 65 tatic int unixGe
27af0 74 4c 61 73 74 45 72 72 6f 72 28 73 71 6c 69 74 tLastError(sqlit
27b00 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c e3_vfs *NotUsed,
27b10 20 69 6e 74 20 4e 6f 74 55 73 65 64 32 2c 20 63 int NotUsed2, c
27b20 68 61 72 20 2a 4e 6f 74 55 73 65 64 33 29 7b 0a har *NotUsed3){.
27b30 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
27b40 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 55 ER(NotUsed);. U
27b50 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
27b60 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 55 4e 55 NotUsed2);. UNU
27b70 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
27b80 74 55 73 65 64 33 29 3b 0a 20 20 72 65 74 75 72 tUsed3);. retur
27b90 6e 20 30 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 2a 2a n 0;.}.../*.****
27ba0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27bb0 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 73 71 6c 69 **** End of sqli
27bc0 74 65 33 5f 76 66 73 20 6d 65 74 68 6f 64 73 20 te3_vfs methods
27bd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27be0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a ***********.****
27bf0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a **********/../**
27c40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c70 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27c80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a ************.***
27c90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27ca0 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 50 72 ******* Begin Pr
27cb0 6f 78 79 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a oxy Locking ****
27cc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
27cd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a ************.**.
27ce0 2a 2a 20 50 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 ** Proxy locking
27cf0 20 69 73 20 61 20 22 75 62 65 72 2d 6c 6f 63 6b is a "uber-lock
27d00 69 6e 67 2d 6d 65 74 68 6f 64 22 20 69 6e 20 74 ing-method" in t
27d10 68 69 73 20 73 65 6e 73 65 3a 20 20 49 74 20 75 his sense: It u
27d20 73 65 73 20 74 68 65 0a 2a 2a 20 6f 74 68 65 72 ses the.** other
27d30 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 73 locking methods
27d40 20 6f 6e 20 73 65 63 6f 6e 64 61 72 79 20 6c 6f on secondary lo
27d50 63 6b 20 66 69 6c 65 73 2e 20 20 50 72 6f 78 79 ck files. Proxy
27d60 20 6c 6f 63 6b 69 6e 67 20 69 73 20 61 0a 2a 2a locking is a.**
27d70 20 6d 65 74 61 2d 6c 61 79 65 72 20 6f 76 65 72 meta-layer over
27d80 20 74 6f 70 20 6f 66 20 74 68 65 20 70 72 69 6d top of the prim
27d90 69 74 69 76 65 20 6c 6f 63 6b 69 6e 67 20 69 6d itive locking im
27da0 70 6c 65 6d 65 6e 74 65 64 20 61 62 6f 76 65 2e plemented above.
27db0 20 20 46 6f 72 0a 2a 2a 20 74 68 69 73 20 72 65 For.** this re
27dc0 61 73 6f 6e 2c 20 74 68 65 20 64 69 76 69 73 69 ason, the divisi
27dd0 6f 6e 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e on that implemen
27de0 74 73 20 6f 66 20 70 72 6f 78 79 20 6c 6f 63 6b ts of proxy lock
27df0 69 6e 67 20 69 73 20 64 65 66 65 72 72 65 64 0a ing is deferred.
27e00 2a 2a 20 75 6e 74 69 6c 20 6c 61 74 65 20 69 6e ** until late in
27e10 20 74 68 65 20 66 69 6c 65 20 28 68 65 72 65 29 the file (here)
27e20 20 61 66 74 65 72 20 61 6c 6c 20 6f 66 20 74 68 after all of th
27e30 65 20 6f 74 68 65 72 20 49 2f 4f 20 6d 65 74 68 e other I/O meth
27e40 6f 64 73 20 68 61 76 65 0a 2a 2a 20 62 65 65 6e ods have.** been
27e50 20 64 65 66 69 6e 65 64 20 2d 20 73 6f 20 74 68 defined - so th
27e60 61 74 20 74 68 65 20 70 72 69 6d 69 74 69 76 65 at the primitive
27e70 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 73 locking methods
27e80 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 0a 2a are available.*
27e90 2a 20 61 73 20 73 65 72 76 69 63 65 73 20 74 6f * as services to
27ea0 20 68 65 6c 70 20 77 69 74 68 20 74 68 65 20 69 help with the i
27eb0 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 mplementation of
27ec0 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 2e 0a proxy locking..
27ed0 2a 2a 0a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 **.****.**.** Th
27ee0 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e e default lockin
27ef0 67 20 73 63 68 65 6d 65 73 20 69 6e 20 53 51 4c g schemes in SQL
27f00 69 74 65 20 75 73 65 20 62 79 74 65 2d 72 61 6e ite use byte-ran
27f10 67 65 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 0a ge locks on the.
27f20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ** database file
27f30 20 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 73 to coordinate s
27f40 61 66 65 2c 20 63 6f 6e 63 75 72 72 65 6e 74 20 afe, concurrent
27f50 61 63 63 65 73 73 20 62 79 20 6d 75 6c 74 69 70 access by multip
27f60 6c 65 20 72 65 61 64 65 72 73 0a 2a 2a 20 61 6e le readers.** an
27f70 64 20 77 72 69 74 65 72 73 20 5b 68 74 74 70 3a d writers [http:
27f80 2f 2f 73 71 6c 69 74 65 2e 6f 72 67 2f 6c 6f 63 //sqlite.org/loc
27f90 6b 69 6e 67 76 33 2e 68 74 6d 6c 5d 2e 20 20 54 kingv3.html]. T
27fa0 68 65 20 66 69 76 65 20 66 69 6c 65 20 6c 6f 63 he five file loc
27fb0 6b 69 6e 67 0a 2a 2a 20 73 74 61 74 65 73 20 28 king.** states (
27fc0 55 4e 4c 4f 43 4b 45 44 2c 20 50 45 4e 44 49 4e UNLOCKED, PENDIN
27fd0 47 2c 20 53 48 41 52 45 44 2c 20 52 45 53 45 52 G, SHARED, RESER
27fe0 56 45 44 2c 20 45 58 43 4c 55 53 49 56 45 29 20 VED, EXCLUSIVE)
27ff0 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 0a are implemented.
28000 2a 2a 20 61 73 20 50 4f 53 49 58 20 72 65 61 64 ** as POSIX read
28010 20 26 20 77 72 69 74 65 20 6c 6f 63 6b 73 20 6f & write locks o
28020 76 65 72 20 66 69 78 65 64 20 73 65 74 20 6f 66 ver fixed set of
28030 20 6c 6f 63 61 74 69 6f 6e 73 20 28 76 69 61 20 locations (via
28040 66 73 63 74 6c 29 2c 0a 2a 2a 20 6f 6e 20 41 46 fsctl),.** on AF
28050 50 20 61 6e 64 20 53 4d 42 20 6f 6e 6c 79 20 65 P and SMB only e
28060 78 63 6c 75 73 69 76 65 20 62 79 74 65 2d 72 61 xclusive byte-ra
28070 6e 67 65 20 6c 6f 63 6b 73 20 61 72 65 20 61 76 nge locks are av
28080 61 69 6c 61 62 6c 65 20 76 69 61 20 66 73 63 74 ailable via fsct
28090 6c 0a 2a 2a 20 77 69 74 68 20 5f 49 4f 57 52 28 l.** with _IOWR(
280a0 27 7a 27 2c 20 32 33 2c 20 73 74 72 75 63 74 20 'z', 23, struct
280b0 42 79 74 65 52 61 6e 67 65 4c 6f 63 6b 50 42 32 ByteRangeLockPB2
280c0 29 20 74 6f 20 74 72 61 63 6b 20 74 68 65 20 73 ) to track the s
280d0 61 6d 65 20 35 20 73 74 61 74 65 73 2e 0a 2a 2a ame 5 states..**
280e0 20 54 6f 20 73 69 6d 75 6c 61 74 65 20 61 20 46 To simulate a F
280f0 5f 52 44 4c 43 4b 20 6f 6e 20 74 68 65 20 73 68 _RDLCK on the sh
28100 61 72 65 64 20 72 61 6e 67 65 2c 20 6f 6e 20 41 ared range, on A
28110 46 50 20 61 20 72 61 6e 64 6f 6d 6c 79 20 73 65 FP a randomly se
28120 6c 65 63 74 65 64 0a 2a 2a 20 61 64 64 72 65 73 lected.** addres
28130 73 20 69 6e 20 74 68 65 20 73 68 61 72 65 64 20 s in the shared
28140 72 61 6e 67 65 20 69 73 20 74 61 6b 65 6e 20 66 range is taken f
28150 6f 72 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b or a SHARED lock
28160 2c 20 74 68 65 20 65 6e 74 69 72 65 0a 2a 2a 20 , the entire.**
28170 73 68 61 72 65 64 20 72 61 6e 67 65 20 69 73 20 shared range is
28180 74 61 6b 65 6e 20 66 6f 72 20 61 6e 20 45 58 43 taken for an EXC
28190 4c 55 53 49 56 45 20 6c 6f 63 6b 29 3a 0a 2a 2a LUSIVE lock):.**
281a0 0a 2a 2a 20 20 20 20 20 20 50 45 4e 44 49 4e 47 .** PENDING
281b0 5f 42 59 54 45 20 20 20 20 20 20 20 20 30 78 34 _BYTE 0x4
281c0 30 30 30 30 30 30 30 09 09 20 20 20 09 0a 2a 2a 0000000.. ..**
281d0 20 20 20 20 20 20 52 45 53 45 52 56 45 44 5f 42 RESERVED_B
281e0 59 54 45 20 20 20 20 20 20 20 30 78 34 30 30 30 YTE 0x4000
281f0 30 30 30 31 0a 2a 2a 20 20 20 20 20 20 53 48 41 0001.** SHA
28200 52 45 44 5f 52 41 4e 47 45 20 20 20 20 20 20 20 RED_RANGE
28210 20 30 78 34 30 30 30 30 30 30 32 20 2d 3e 20 30 0x40000002 -> 0
28220 78 34 30 30 30 30 32 30 30 0a 2a 2a 0a 2a 2a 20 x40000200.**.**
28230 54 68 69 73 20 77 6f 72 6b 73 20 77 65 6c 6c 20 This works well
28240 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 66 69 6c on the local fil
28250 65 20 73 79 73 74 65 6d 2c 20 62 75 74 20 73 68 e system, but sh
28260 6f 77 73 20 61 20 6e 65 61 72 6c 79 20 31 30 30 ows a nearly 100
28270 78 0a 2a 2a 20 73 6c 6f 77 64 6f 77 6e 20 69 6e x.** slowdown in
28280 20 72 65 61 64 20 70 65 72 66 6f 72 6d 61 6e 63 read performanc
28290 65 20 6f 6e 20 41 46 50 20 62 65 63 61 75 73 65 e on AFP because
282a0 20 74 68 65 20 41 46 50 20 63 6c 69 65 6e 74 20 the AFP client
282b0 64 69 73 61 62 6c 65 73 0a 2a 2a 20 74 68 65 20 disables.** the
282c0 72 65 61 64 20 63 61 63 68 65 20 77 68 65 6e 20 read cache when
282d0 62 79 74 65 2d 72 61 6e 67 65 20 6c 6f 63 6b 73 byte-range locks
282e0 20 61 72 65 20 70 72 65 73 65 6e 74 2e 20 20 45 are present. E
282f0 6e 61 62 6c 69 6e 67 20 74 68 65 20 72 65 61 64 nabling the read
28300 0a 2a 2a 20 63 61 63 68 65 20 65 78 70 6f 73 65 .** cache expose
28310 73 20 61 20 63 61 63 68 65 20 63 6f 68 65 72 65 s a cache cohere
28320 6e 63 79 20 70 72 6f 62 6c 65 6d 20 74 68 61 74 ncy problem that
28330 20 69 73 20 70 72 65 73 65 6e 74 20 6f 6e 20 61 is present on a
28340 6c 6c 20 4f 53 20 58 0a 2a 2a 20 73 75 70 70 6f ll OS X.** suppo
28350 72 74 65 64 20 6e 65 74 77 6f 72 6b 20 66 69 6c rted network fil
28360 65 20 73 79 73 74 65 6d 73 2e 20 20 4e 46 53 20 e systems. NFS
28370 61 6e 64 20 41 46 50 20 62 6f 74 68 20 6f 62 73 and AFP both obs
28380 65 72 76 65 20 74 68 65 0a 2a 2a 20 63 6c 6f 73 erve the.** clos
28390 65 2d 74 6f 2d 6f 70 65 6e 20 73 65 6d 61 6e 74 e-to-open semant
283a0 69 63 73 20 66 6f 72 20 65 6e 73 75 72 69 6e 67 ics for ensuring
283b0 20 63 61 63 68 65 20 63 6f 68 65 72 65 6e 63 79 cache coherency
283c0 0a 2a 2a 20 5b 68 74 74 70 3a 2f 2f 6e 66 73 2e .** [http://nfs.
283d0 73 6f 75 72 63 65 66 6f 72 67 65 2e 6e 65 74 2f sourceforge.net/
283e0 23 66 61 71 5f 61 38 5d 2c 20 77 68 69 63 68 20 #faq_a8], which
283f0 64 6f 65 73 20 6e 6f 74 20 65 66 66 65 63 74 69 does not effecti
28400 76 65 6c 79 0a 2a 2a 20 61 64 64 72 65 73 73 20 vely.** address
28410 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 the requirements
28420 20 66 6f 72 20 63 6f 6e 63 75 72 72 65 6e 74 20 for concurrent
28430 64 61 74 61 62 61 73 65 20 61 63 63 65 73 73 20 database access
28440 62 79 20 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20 72 by multiple.** r
28450 65 61 64 65 72 73 20 61 6e 64 20 77 72 69 74 65 eaders and write
28460 72 73 0a 2a 2a 20 5b 68 74 74 70 3a 2f 2f 77 77 rs.** [http://ww
28470 77 2e 6e 61 62 62 6c 65 2e 63 6f 6d 2f 53 51 4c w.nabble.com/SQL
28480 69 74 65 2d 6f 6e 2d 4e 46 53 2d 63 61 63 68 65 ite-on-NFS-cache
28490 2d 63 6f 68 65 72 65 6e 63 79 2d 74 64 31 35 36 -coherency-td156
284a0 35 35 37 30 31 2e 68 74 6d 6c 5d 2e 0a 2a 2a 0a 55701.html]..**.
284b0 2a 2a 20 54 6f 20 61 64 64 72 65 73 73 20 74 68 ** To address th
284c0 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e e performance an
284d0 64 20 63 61 63 68 65 20 63 6f 68 65 72 65 6e 63 d cache coherenc
284e0 79 20 69 73 73 75 65 73 2c 20 70 72 6f 78 79 20 y issues, proxy
284f0 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 file locking.**
28500 63 68 61 6e 67 65 73 20 74 68 65 20 77 61 79 20 changes the way
28510 64 61 74 61 62 61 73 65 20 61 63 63 65 73 73 20 database access
28520 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 is controlled by
28530 20 6c 69 6d 69 74 69 6e 67 20 61 63 63 65 73 73 limiting access
28540 20 74 6f 20 61 0a 2a 2a 20 73 69 6e 67 6c 65 20 to a.** single
28550 68 6f 73 74 20 61 74 20 61 20 74 69 6d 65 20 61 host at a time a
28560 6e 64 20 6d 6f 76 69 6e 67 20 66 69 6c 65 20 6c nd moving file l
28570 6f 63 6b 73 20 6f 66 66 20 6f 66 20 74 68 65 20 ocks off of the
28580 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 2a 2a database file.**
28590 20 61 6e 64 20 6f 6e 74 6f 20 61 20 70 72 6f 78 and onto a prox
285a0 79 20 66 69 6c 65 20 6f 6e 20 74 68 65 20 6c 6f y file on the lo
285b0 63 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 2e cal file system.
285c0 20 20 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 55 73 69 6e .**.**.** Usin
285d0 67 20 70 72 6f 78 79 20 6c 6f 63 6b 73 0a 2a 2a g proxy locks.**
285e0 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ---------------
285f0 2d 2d 0a 2a 2a 0a 2a 2a 20 43 20 41 50 49 73 0a --.**.** C APIs.
28600 2a 2a 0a 2a 2a 20 20 73 71 6c 69 74 65 33 5f 66 **.** sqlite3_f
28610 69 6c 65 5f 63 6f 6e 74 72 6f 6c 28 64 62 2c 20 ile_control(db,
28620 64 62 6e 61 6d 65 2c 20 53 51 4c 49 54 45 5f 53 dbname, SQLITE_S
28630 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46 49 4c 45 ET_LOCKPROXYFILE
28640 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 ,.**
28650 20 20 20 20 20 20 20 20 20 20 20 3c 70 72 6f 78 <prox
28660 79 5f 70 61 74 68 3e 20 7c 20 22 3a 61 75 74 6f y_path> | ":auto
28670 3a 22 29 3b 0a 2a 2a 20 20 73 71 6c 69 74 65 33 :");.** sqlite3
28680 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c 28 64 62 _file_control(db
28690 2c 20 64 62 6e 61 6d 65 2c 20 53 51 4c 49 54 45 , dbname, SQLITE
286a0 5f 47 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46 49 _GET_LOCKPROXYFI
286b0 4c 45 2c 20 26 3c 70 72 6f 78 79 5f 70 61 74 68 LE, &<proxy_path
286c0 3e 29 3b 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 53 51 4c >);.**.**.** SQL
286d0 20 70 72 61 67 6d 61 73 0a 2a 2a 0a 2a 2a 20 20 pragmas.**.**
286e0 50 52 41 47 4d 41 20 5b 64 61 74 61 62 61 73 65 PRAGMA [database
286f0 2e 5d 6c 6f 63 6b 5f 70 72 6f 78 79 5f 66 69 6c .]lock_proxy_fil
28700 65 3d 3c 70 72 6f 78 79 5f 70 61 74 68 3e 20 7c e=<proxy_path> |
28710 20 3a 61 75 74 6f 3a 0a 2a 2a 20 20 50 52 41 47 :auto:.** PRAG
28720 4d 41 20 5b 64 61 74 61 62 61 73 65 2e 5d 6c 6f MA [database.]lo
28730 63 6b 5f 70 72 6f 78 79 5f 66 69 6c 65 0a 2a 2a ck_proxy_file.**
28740 0a 2a 2a 20 53 70 65 63 69 66 79 69 6e 67 20 22 .** Specifying "
28750 3a 61 75 74 6f 3a 22 20 6d 65 61 6e 73 20 74 68 :auto:" means th
28760 61 74 20 69 66 20 74 68 65 72 65 20 69 73 20 61 at if there is a
28770 20 63 6f 6e 63 68 20 66 69 6c 65 20 77 69 74 68 conch file with
28780 20 61 20 6d 61 74 63 68 69 6e 67 0a 2a 2a 20 68 a matching.** h
28790 6f 73 74 20 49 44 20 69 6e 20 69 74 2c 20 74 68 ost ID in it, th
287a0 65 20 70 72 6f 78 79 20 70 61 74 68 20 69 6e 20 e proxy path in
287b0 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 77 the conch file w
287c0 69 6c 6c 20 62 65 20 75 73 65 64 2c 20 6f 74 68 ill be used, oth
287d0 65 72 77 69 73 65 0a 2a 2a 20 61 20 70 72 6f 78 erwise.** a prox
287e0 79 20 70 61 74 68 20 62 61 73 65 64 20 6f 6e 20 y path based on
287f0 74 68 65 20 75 73 65 72 27 73 20 74 65 6d 70 20 the user's temp
28800 64 69 72 0a 2a 2a 20 28 76 69 61 20 63 6f 6e 66 dir.** (via conf
28810 73 74 72 28 5f 43 53 5f 44 41 52 57 49 4e 5f 55 str(_CS_DARWIN_U
28820 53 45 52 5f 54 45 4d 50 5f 44 49 52 2c 2e 2e 2e SER_TEMP_DIR,...
28830 29 29 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 )) will be used
28840 61 6e 64 20 74 68 65 0a 2a 2a 20 61 63 74 75 61 and the.** actua
28850 6c 20 70 72 6f 78 79 20 66 69 6c 65 20 6e 61 6d l proxy file nam
28860 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 66 e is generated f
28870 72 6f 6d 20 74 68 65 20 6e 61 6d 65 20 61 6e 64 rom the name and
28880 20 70 61 74 68 20 6f 66 20 74 68 65 0a 2a 2a 20 path of the.**
28890 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
288a0 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a For example:.**.
288b0 2a 2a 20 20 20 20 20 20 20 46 6f 72 20 64 61 74 ** For dat
288c0 61 62 61 73 65 20 70 61 74 68 20 22 2f 55 73 65 abase path "/Use
288d0 72 73 2f 6d 65 2f 66 6f 6f 2e 64 62 22 20 0a 2a rs/me/foo.db" .*
288e0 2a 20 20 20 20 20 20 20 54 68 65 20 6c 6f 63 6b * The lock
288f0 20 70 61 74 68 20 77 69 6c 6c 20 62 65 20 22 3c path will be "<
28900 74 6d 70 64 69 72 3e 2f 73 71 6c 69 74 65 70 6c tmpdir>/sqlitepl
28910 6f 63 6b 73 2f 5f 55 73 65 72 73 5f 6d 65 5f 66 ocks/_Users_me_f
28920 6f 6f 2e 64 62 3a 61 75 74 6f 3a 22 29 0a 2a 2a oo.db:auto:").**
28930 0a 2a 2a 20 4f 6e 63 65 20 61 20 6c 6f 63 6b 20 .** Once a lock
28940 70 72 6f 78 79 20 69 73 20 63 6f 6e 66 69 67 75 proxy is configu
28950 72 65 64 20 66 6f 72 20 61 20 64 61 74 61 62 61 red for a databa
28960 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 se connection, i
28970 74 20 63 61 6e 20 6e 6f 74 0a 2a 2a 20 62 65 20 t can not.** be
28980 72 65 6d 6f 76 65 64 2c 20 68 6f 77 65 76 65 72 removed, however
28990 20 69 74 20 6d 61 79 20 62 65 20 73 77 69 74 63 it may be switc
289a0 68 65 64 20 74 6f 20 61 20 64 69 66 66 65 72 65 hed to a differe
289b0 6e 74 20 70 72 6f 78 79 20 70 61 74 68 20 76 69 nt proxy path vi
289c0 61 0a 2a 2a 20 74 68 65 20 61 62 6f 76 65 20 41 a.** the above A
289d0 50 49 73 20 28 61 73 73 75 6d 69 6e 67 20 74 68 PIs (assuming th
289e0 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 69 73 20 e conch file is
289f0 6e 6f 74 20 62 65 69 6e 67 20 68 65 6c 64 20 62 not being held b
28a00 79 20 61 6e 6f 74 68 65 72 0a 2a 2a 20 63 6f 6e y another.** con
28a10 6e 65 63 74 69 6f 6e 20 6f 72 20 70 72 6f 63 65 nection or proce
28a20 73 73 29 2e 20 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 48 ss). .**.**.** H
28a30 6f 77 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 ow proxy locking
28a40 20 77 6f 72 6b 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d works.** ------
28a50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
28a60 2d 0a 2a 2a 0a 2a 2a 20 50 72 6f 78 79 20 66 69 -.**.** Proxy fi
28a70 6c 65 20 6c 6f 63 6b 69 6e 67 20 72 65 6c 69 65 le locking relie
28a80 73 20 70 72 69 6d 61 72 69 6c 79 20 6f 6e 20 74 s primarily on t
28a90 77 6f 20 6e 65 77 20 73 75 70 70 6f 72 74 69 6e wo new supportin
28aa0 67 20 66 69 6c 65 73 3a 20 0a 2a 2a 0a 2a 2a 20 g files: .**.**
28ab0 20 20 2a 20 20 63 6f 6e 63 68 20 66 69 6c 65 20 * conch file
28ac0 74 6f 20 6c 69 6d 69 74 20 61 63 63 65 73 73 20 to limit access
28ad0 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
28ae0 66 69 6c 65 20 74 6f 20 61 20 73 69 6e 67 6c 65 file to a single
28af0 20 68 6f 73 74 0a 2a 2a 20 20 20 20 20 20 61 74 host.** at
28b00 20 61 20 74 69 6d 65 0a 2a 2a 0a 2a 2a 20 20 20 a time.**.**
28b10 2a 20 20 70 72 6f 78 79 20 66 69 6c 65 20 74 6f * proxy file to
28b20 20 61 63 74 20 61 73 20 61 20 70 72 6f 78 79 20 act as a proxy
28b30 66 6f 72 20 74 68 65 20 61 64 76 69 73 6f 72 79 for the advisory
28b40 20 6c 6f 63 6b 73 20 6e 6f 72 6d 61 6c 6c 79 0a locks normally.
28b50 2a 2a 20 20 20 20 20 20 74 61 6b 65 6e 20 6f 6e ** taken on
28b60 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a the database.**
28b70 0a 2a 2a 20 54 68 65 20 63 6f 6e 63 68 20 66 69 .** The conch fi
28b80 6c 65 20 2d 20 74 6f 20 75 73 65 20 61 20 70 72 le - to use a pr
28b90 6f 78 79 20 66 69 6c 65 2c 20 73 71 6c 69 74 65 oxy file, sqlite
28ba0 20 6d 75 73 74 20 66 69 72 73 74 20 22 68 6f 6c must first "hol
28bb0 64 20 74 68 65 20 63 6f 6e 63 68 22 0a 2a 2a 20 d the conch".**
28bc0 62 79 20 74 61 6b 69 6e 67 20 61 6e 20 73 71 6c by taking an sql
28bd0 69 74 65 2d 73 74 79 6c 65 20 73 68 61 72 65 64 ite-style shared
28be0 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 63 6f 6e lock on the con
28bf0 63 68 20 66 69 6c 65 2c 20 72 65 61 64 69 6e 67 ch file, reading
28c00 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 the.** contents
28c10 20 61 6e 64 20 63 6f 6d 70 61 72 69 6e 67 20 74 and comparing t
28c20 68 65 20 68 6f 73 74 27 73 20 75 6e 69 71 75 65 he host's unique
28c30 20 68 6f 73 74 20 49 44 20 28 73 65 65 20 62 65 host ID (see be
28c40 6c 6f 77 29 20 61 6e 64 20 6c 6f 63 6b 0a 2a 2a low) and lock.**
28c50 20 70 72 6f 78 79 20 70 61 74 68 20 61 67 61 69 proxy path agai
28c60 6e 73 74 20 74 68 65 20 76 61 6c 75 65 73 20 73 nst the values s
28c70 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 6f 6e tored in the con
28c80 63 68 2e 20 20 54 68 65 20 63 6f 6e 63 68 20 66 ch. The conch f
28c90 69 6c 65 20 69 73 0a 2a 2a 20 73 74 6f 72 65 64 ile is.** stored
28ca0 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 in the same dir
28cb0 65 63 74 6f 72 79 20 61 73 20 74 68 65 20 64 61 ectory as the da
28cc0 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 tabase file and
28cd0 74 68 65 20 66 69 6c 65 20 6e 61 6d 65 0a 2a 2a the file name.**
28ce0 20 69 73 20 70 61 74 74 65 72 6e 65 64 20 61 66 is patterned af
28cf0 74 65 72 20 74 68 65 20 64 61 74 61 62 61 73 65 ter the database
28d00 20 66 69 6c 65 20 6e 61 6d 65 20 61 73 20 22 2e file name as ".
28d10 3c 64 61 74 61 62 61 73 65 6e 61 6d 65 3e 2d 63 <databasename>-c
28d20 6f 6e 63 68 22 2e 0a 2a 2a 20 49 66 20 74 68 65 onch"..** If the
28d30 20 63 6f 6e 63 68 20 66 69 6c 65 20 64 6f 65 73 conch file does
28d40 20 6e 6f 74 20 65 78 69 73 74 2c 20 6f 72 20 69 not exist, or i
28d50 74 27 73 20 63 6f 6e 74 65 6e 74 73 20 64 6f 20 t's contents do
28d60 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 0a 2a 2a not match the.**
28d70 20 68 6f 73 74 20 49 44 20 61 6e 64 2f 6f 72 20 host ID and/or
28d80 70 72 6f 78 79 20 70 61 74 68 2c 20 74 68 65 6e proxy path, then
28d90 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 65 73 63 the lock is esc
28da0 61 6c 61 74 65 64 20 74 6f 20 61 6e 20 65 78 63 alated to an exc
28db0 6c 75 73 69 76 65 0a 2a 2a 20 6c 6f 63 6b 20 61 lusive.** lock a
28dc0 6e 64 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c nd the conch fil
28dd0 65 20 63 6f 6e 74 65 6e 74 73 20 69 73 20 75 70 e contents is up
28de0 64 61 74 65 64 20 77 69 74 68 20 74 68 65 20 68 dated with the h
28df0 6f 73 74 20 49 44 20 61 6e 64 20 70 72 6f 78 79 ost ID and proxy
28e00 0a 2a 2a 20 70 61 74 68 20 61 6e 64 20 74 68 65 .** path and the
28e10 20 6c 6f 63 6b 20 69 73 20 64 6f 77 6e 67 72 61 lock is downgra
28e20 64 65 64 20 74 6f 20 61 20 73 68 61 72 65 64 20 ded to a shared
28e30 6c 6f 63 6b 20 61 67 61 69 6e 2e 20 20 49 66 20 lock again. If
28e40 74 68 65 20 63 6f 6e 63 68 0a 2a 2a 20 69 73 20 the conch.** is
28e50 68 65 6c 64 20 62 79 20 61 6e 6f 74 68 65 72 20 held by another
28e60 70 72 6f 63 65 73 73 20 28 77 69 74 68 20 61 20 process (with a
28e70 73 68 61 72 65 64 20 6c 6f 63 6b 29 2c 20 74 68 shared lock), th
28e80 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b e exclusive lock
28e90 0a 2a 2a 20 77 69 6c 6c 20 66 61 69 6c 20 61 6e .** will fail an
28ea0 64 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 d SQLITE_BUSY is
28eb0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
28ec0 20 54 68 65 20 70 72 6f 78 79 20 66 69 6c 65 20 The proxy file
28ed0 2d 20 61 20 73 69 6e 67 6c 65 2d 62 79 74 65 20 - a single-byte
28ee0 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20 61 6c file used for al
28ef0 6c 20 61 64 76 69 73 6f 72 79 20 66 69 6c 65 20 l advisory file
28f00 6c 6f 63 6b 73 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c locks.** normall
28f10 79 20 74 61 6b 65 6e 20 6f 6e 20 74 68 65 20 64 y taken on the d
28f20 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 20 atabase file.
28f30 54 68 69 73 20 61 6c 6c 6f 77 73 20 66 6f 72 20 This allows for
28f40 73 61 66 65 20 73 68 61 72 69 6e 67 0a 2a 2a 20 safe sharing.**
28f50 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
28f60 66 69 6c 65 20 66 6f 72 20 6d 75 6c 74 69 70 6c file for multipl
28f70 65 20 72 65 61 64 65 72 73 20 61 6e 64 20 77 72 e readers and wr
28f80 69 74 65 72 73 20 6f 6e 20 74 68 65 20 73 61 6d iters on the sam
28f90 65 0a 2a 2a 20 68 6f 73 74 20 28 74 68 65 20 63 e.** host (the c
28fa0 6f 6e 63 68 20 65 6e 73 75 72 65 73 20 74 68 61 onch ensures tha
28fb0 74 20 74 68 65 79 20 61 6c 6c 20 75 73 65 20 74 t they all use t
28fc0 68 65 20 73 61 6d 65 20 6c 6f 63 61 6c 20 6c 6f he same local lo
28fd0 63 6b 20 66 69 6c 65 29 2e 0a 2a 2a 0a 2a 2a 20 ck file)..**.**
28fe0 52 65 71 75 65 73 74 69 6e 67 20 74 68 65 20 6c Requesting the l
28ff0 6f 63 6b 20 70 72 6f 78 79 20 64 6f 65 73 20 6e ock proxy does n
29000 6f 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 74 ot immediately t
29010 61 6b 65 20 74 68 65 20 63 6f 6e 63 68 2c 20 69 ake the conch, i
29020 74 20 69 73 0a 2a 2a 20 6f 6e 6c 79 20 74 61 6b t is.** only tak
29030 65 6e 20 77 68 65 6e 20 74 68 65 20 66 69 72 73 en when the firs
29040 74 20 72 65 71 75 65 73 74 20 74 6f 20 6c 6f 63 t request to loc
29050 6b 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 k database file
29060 69 73 20 6d 61 64 65 2e 20 20 0a 2a 2a 20 54 68 is made. .** Th
29070 69 73 20 6d 61 74 63 68 65 73 20 74 68 65 20 73 is matches the s
29080 65 6d 61 6e 74 69 63 73 20 6f 66 20 74 68 65 20 emantics of the
29090 74 72 61 64 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b traditional lock
290a0 69 6e 67 20 62 65 68 61 76 69 6f 72 2c 20 77 68 ing behavior, wh
290b0 65 72 65 0a 2a 2a 20 6f 70 65 6e 69 6e 67 20 61 ere.** opening a
290c0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 connection to a
290d0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 64 database file d
290e0 6f 65 73 20 6e 6f 74 20 74 61 6b 65 20 61 20 6c oes not take a l
290f0 6f 63 6b 20 6f 6e 20 69 74 2e 0a 2a 2a 20 54 68 ock on it..** Th
29100 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 61 6e e shared lock an
29110 64 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 64 d an open file d
29120 65 73 63 72 69 70 74 6f 72 20 61 72 65 20 6d 61 escriptor are ma
29130 69 6e 74 61 69 6e 65 64 20 75 6e 74 69 6c 20 0a intained until .
29140 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f ** the connectio
29150 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 n to the databas
29160 65 20 69 73 20 63 6c 6f 73 65 64 2e 20 0a 2a 2a e is closed. .**
29170 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 20 66 69 .** The proxy fi
29180 6c 65 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 le and the lock
29190 66 69 6c 65 20 61 72 65 20 6e 65 76 65 72 20 64 file are never d
291a0 65 6c 65 74 65 64 20 73 6f 20 74 68 65 79 20 6f eleted so they o
291b0 6e 6c 79 20 6e 65 65 64 0a 2a 2a 20 74 6f 20 62 nly need.** to b
291c0 65 20 63 72 65 61 74 65 64 20 74 68 65 20 66 69 e created the fi
291d0 72 73 74 20 74 69 6d 65 20 74 68 65 79 20 61 72 rst time they ar
291e0 65 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 43 6f e used..**.** Co
291f0 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 nfiguration opti
29200 6f 6e 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d ons.** ---------
29210 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 0a ------------.**.
29220 2a 2a 20 20 53 51 4c 49 54 45 5f 50 52 45 46 45 ** SQLITE_PREFE
29230 52 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 0a R_PROXY_LOCKING.
29240 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 44 61 74 61 **.** Data
29250 62 61 73 65 20 66 69 6c 65 73 20 61 63 63 65 73 base files acces
29260 73 65 64 20 6f 6e 20 6e 6f 6e 2d 6c 6f 63 61 6c sed on non-local
29270 20 66 69 6c 65 20 73 79 73 74 65 6d 73 20 61 72 file systems ar
29280 65 0a 2a 2a 20 20 20 20 20 20 20 61 75 74 6f 6d e.** autom
29290 61 74 69 63 61 6c 6c 79 20 63 6f 6e 66 69 67 75 atically configu
292a0 72 65 64 20 66 6f 72 20 70 72 6f 78 79 20 6c 6f red for proxy lo
292b0 63 6b 69 6e 67 2c 20 6c 6f 63 6b 20 66 69 6c 65 cking, lock file
292c0 73 20 61 72 65 0a 2a 2a 20 20 20 20 20 20 20 6e s are.** n
292d0 61 6d 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c amed automatical
292e0 6c 79 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d ly using the sam
292f0 65 20 6c 6f 67 69 63 20 61 73 0a 2a 2a 20 20 20 e logic as.**
29300 20 20 20 20 50 52 41 47 4d 41 20 6c 6f 63 6b 5f PRAGMA lock_
29310 70 72 6f 78 79 5f 66 69 6c 65 3d 22 3a 61 75 74 proxy_file=":aut
29320 6f 3a 22 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20 53 o:".** .** S
29330 51 4c 49 54 45 5f 50 52 4f 58 59 5f 44 45 42 55 QLITE_PROXY_DEBU
29340 47 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 45 6e G.**.** En
29350 61 62 6c 65 73 20 74 68 65 20 6c 6f 67 67 69 6e ables the loggin
29360 67 20 6f 66 20 65 72 72 6f 72 20 6d 65 73 73 61 g of error messa
29370 67 65 73 20 64 75 72 69 6e 67 20 68 6f 73 74 20 ges during host
29380 69 64 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 id file.**
29390 20 72 65 74 72 69 65 76 61 6c 20 61 6e 64 20 63 retrieval and c
293a0 72 65 61 74 69 6f 6e 0a 2a 2a 0a 2a 2a 20 20 4c reation.**.** L
293b0 4f 43 4b 50 52 4f 58 59 44 49 52 0a 2a 2a 0a 2a OCKPROXYDIR.**.*
293c0 2a 20 20 20 20 20 20 20 4f 76 65 72 72 69 64 65 * Override
293d0 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 64 69 s the default di
293e0 72 65 63 74 6f 72 79 20 75 73 65 64 20 66 6f 72 rectory used for
293f0 20 6c 6f 63 6b 20 70 72 6f 78 79 20 66 69 6c 65 lock proxy file
29400 73 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 s that.**
29410 61 72 65 20 6e 61 6d 65 64 20 61 75 74 6f 6d 61 are named automa
29420 74 69 63 61 6c 6c 79 20 76 69 61 20 74 68 65 20 tically via the
29430 22 3a 61 75 74 6f 3a 22 20 73 65 74 74 69 6e 67 ":auto:" setting
29440 0a 2a 2a 0a 2a 2a 20 20 53 51 4c 49 54 45 5f 44 .**.** SQLITE_D
29450 45 46 41 55 4c 54 5f 50 52 4f 58 59 44 49 52 5f EFAULT_PROXYDIR_
29460 50 45 52 4d 49 53 53 49 4f 4e 53 0a 2a 2a 0a 2a PERMISSIONS.**.*
29470 2a 20 20 20 20 20 20 20 50 65 72 6d 69 73 73 69 * Permissi
29480 6f 6e 73 20 74 6f 20 75 73 65 20 77 68 65 6e 20 ons to use when
29490 63 72 65 61 74 69 6e 67 20 61 20 64 69 72 65 63 creating a direc
294a0 74 6f 72 79 20 66 6f 72 20 73 74 6f 72 69 6e 67 tory for storing
294b0 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 6c 6f the.** lo
294c0 63 6b 20 70 72 6f 78 79 20 66 69 6c 65 73 2c 20 ck proxy files,
294d0 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20 4c only used when L
294e0 4f 43 4b 50 52 4f 58 59 44 49 52 20 69 73 20 6e OCKPROXYDIR is n
294f0 6f 74 20 73 65 74 2e 0a 2a 2a 20 20 20 20 0a 2a ot set..** .*
29500 2a 20 20 20 20 0a 2a 2a 20 41 73 20 6d 65 6e 74 * .** As ment
29510 69 6f 6e 65 64 20 61 62 6f 76 65 2c 20 77 68 65 ioned above, whe
29520 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 n compiled with
29530 53 51 4c 49 54 45 5f 50 52 45 46 45 52 5f 50 52 SQLITE_PREFER_PR
29540 4f 58 59 5f 4c 4f 43 4b 49 4e 47 2c 0a 2a 2a 20 OXY_LOCKING,.**
29550 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 setting the envi
29560 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
29570 20 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 50 52 SQLITE_FORCE_PR
29580 4f 58 59 5f 4c 4f 43 4b 49 4e 47 20 74 6f 20 31 OXY_LOCKING to 1
29590 20 77 69 6c 6c 0a 2a 2a 20 66 6f 72 63 65 20 70 will.** force p
295a0 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 74 6f 20 roxy locking to
295b0 62 65 20 75 73 65 64 20 66 6f 72 20 65 76 65 72 be used for ever
295c0 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 y database file
295d0 6f 70 65 6e 65 64 2c 20 61 6e 64 20 30 0a 2a 2a opened, and 0.**
295e0 20 77 69 6c 6c 20 66 6f 72 63 65 20 61 75 74 6f will force auto
295f0 6d 61 74 69 63 20 70 72 6f 78 79 20 6c 6f 63 6b matic proxy lock
29600 69 6e 67 20 74 6f 20 62 65 20 64 69 73 61 62 6c ing to be disabl
29610 65 64 20 66 6f 72 20 61 6c 6c 20 64 61 74 61 62 ed for all datab
29620 61 73 65 0a 2a 2a 20 66 69 6c 65 73 20 28 65 78 ase.** files (ex
29630 70 6c 69 63 69 74 79 20 63 61 6c 6c 69 6e 67 20 plicity calling
29640 74 68 65 20 53 51 4c 49 54 45 5f 53 45 54 5f 4c the SQLITE_SET_L
29650 4f 43 4b 50 52 4f 58 59 46 49 4c 45 20 70 72 61 OCKPROXYFILE pra
29660 67 6d 61 20 6f 72 0a 2a 2a 20 73 71 6c 69 74 65 gma or.** sqlite
29670 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c 20 41 50 _file_control AP
29680 49 20 69 73 20 6e 6f 74 20 61 66 66 65 63 74 65 I is not affecte
29690 64 20 62 79 20 53 51 4c 49 54 45 5f 46 4f 52 43 d by SQLITE_FORC
296a0 45 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 29 E_PROXY_LOCKING)
296b0 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 78 ..*/../*.** Prox
296c0 79 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6f 6e 6c y locking is onl
296d0 79 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 4d y available on M
296e0 61 63 4f 53 58 20 0a 2a 2f 0a 23 69 66 20 64 65 acOSX .*/.#if de
296f0 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
29700 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c && SQLITE_ENABL
29710 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a E_LOCKING_STYLE.
29720 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 ./*.** The proxy
29730 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 68 LockingContext h
29740 61 73 20 74 68 65 20 70 61 74 68 20 61 6e 64 20 as the path and
29750 66 69 6c 65 20 73 74 72 75 63 74 75 72 65 73 20 file structures
29760 66 6f 72 20 74 68 65 20 72 65 6d 6f 74 65 20 0a for the remote .
29770 2a 2a 20 61 6e 64 20 6c 6f 63 61 6c 20 70 72 6f ** and local pro
29780 78 79 20 66 69 6c 65 73 20 69 6e 20 69 74 0a 2a xy files in it.*
29790 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 /.typedef struct
297a0 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e proxyLockingCon
297b0 74 65 78 74 20 70 72 6f 78 79 4c 6f 63 6b 69 6e text proxyLockin
297c0 67 43 6f 6e 74 65 78 74 3b 0a 73 74 72 75 63 74 gContext;.struct
297d0 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e proxyLockingCon
297e0 74 65 78 74 20 7b 0a 20 20 75 6e 69 78 46 69 6c text {. unixFil
297f0 65 20 2a 63 6f 6e 63 68 46 69 6c 65 3b 20 20 20 e *conchFile;
29800 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 63 6f /* Open co
29810 6e 63 68 20 66 69 6c 65 20 2a 2f 0a 20 20 63 68 nch file */. ch
29820 61 72 20 2a 63 6f 6e 63 68 46 69 6c 65 50 61 74 ar *conchFilePat
29830 68 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 h; /* Na
29840 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 63 68 20 me of the conch
29850 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 46 69 file */. unixFi
29860 6c 65 20 2a 6c 6f 63 6b 50 72 6f 78 79 3b 20 20 le *lockProxy;
29870 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 70 /* Open p
29880 72 6f 78 79 20 6c 6f 63 6b 20 66 69 6c 65 20 2a roxy lock file *
29890 2f 0a 20 20 63 68 61 72 20 2a 6c 6f 63 6b 50 72 /. char *lockPr
298a0 6f 78 79 50 61 74 68 3b 20 20 20 20 20 20 20 20 oxyPath;
298b0 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
298c0 70 72 6f 78 79 20 6c 6f 63 6b 20 66 69 6c 65 20 proxy lock file
298d0 2a 2f 0a 20 20 63 68 61 72 20 2a 64 62 50 61 74 */. char *dbPat
298e0 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
298f0 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
29900 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f 0a 20 20 open file */.
29910 69 6e 74 20 63 6f 6e 63 68 48 65 6c 64 3b 20 20 int conchHeld;
29920 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
29930 31 20 69 66 20 74 68 65 20 63 6f 6e 63 68 20 69 1 if the conch i
29940 73 20 68 65 6c 64 2c 20 2d 31 20 69 66 20 6c 6f s held, -1 if lo
29950 63 6b 6c 65 73 73 20 2a 2f 0a 20 20 76 6f 69 64 ckless */. void
29960 20 2a 6f 6c 64 4c 6f 63 6b 69 6e 67 43 6f 6e 74 *oldLockingCont
29970 65 78 74 3b 20 20 20 20 20 2f 2a 20 4f 72 69 67 ext; /* Orig
29980 69 6e 61 6c 20 6c 6f 63 6b 69 6e 67 63 6f 6e 74 inal lockingcont
29990 65 78 74 20 74 6f 20 72 65 73 74 6f 72 65 20 6f ext to restore o
299a0 6e 20 63 6c 6f 73 65 20 2a 2f 0a 20 20 73 71 6c n close */. sql
299b0 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 ite3_io_methods
299c0 63 6f 6e 73 74 20 2a 70 4f 6c 64 4d 65 74 68 6f const *pOldMetho
299d0 64 3b 20 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e d; /* Origin
299e0 61 6c 20 49 2f 4f 20 6d 65 74 68 6f 64 73 20 66 al I/O methods f
299f0 6f 72 20 63 6c 6f 73 65 20 2a 2f 0a 7d 3b 0a 0a or close */.};..
29a00 2f 2a 20 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 /* .** The proxy
29a10 20 6c 6f 63 6b 20 66 69 6c 65 20 70 61 74 68 20 lock file path
29a20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65 for the database
29a30 20 61 74 20 64 62 50 61 74 68 20 69 73 20 77 72 at dbPath is wr
29a40 69 74 74 65 6e 20 69 6e 74 6f 20 6c 50 61 74 68 itten into lPath
29a50 2c 20 0a 2a 2a 20 77 68 69 63 68 20 6d 75 73 74 , .** which must
29a60 20 70 6f 69 6e 74 20 74 6f 20 76 61 6c 69 64 2c point to valid,
29a70 20 77 72 69 74 61 62 6c 65 20 6d 65 6d 6f 72 79 writable memory
29a80 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 66 6f large enough fo
29a90 72 20 61 20 6d 61 78 4c 65 6e 20 6c 65 6e 67 74 r a maxLen lengt
29aa0 68 0a 2a 2a 20 66 69 6c 65 20 70 61 74 68 2e 20 h.** file path.
29ab0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
29ac0 72 6f 78 79 47 65 74 4c 6f 63 6b 50 61 74 68 28 roxyGetLockPath(
29ad0 63 6f 6e 73 74 20 63 68 61 72 20 2a 64 62 50 61 const char *dbPa
29ae0 74 68 2c 20 63 68 61 72 20 2a 6c 50 61 74 68 2c th, char *lPath,
29af0 20 73 69 7a 65 5f 74 20 6d 61 78 4c 65 6e 29 7b size_t maxLen){
29b00 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a 20 20 69 6e . int len;. in
29b10 74 20 64 62 4c 65 6e 3b 0a 20 20 69 6e 74 20 69 t dbLen;. int i
29b20 3b 0a 0a 23 69 66 64 65 66 20 4c 4f 43 4b 50 52 ;..#ifdef LOCKPR
29b30 4f 58 59 44 49 52 0a 20 20 6c 65 6e 20 3d 20 73 OXYDIR. len = s
29b40 74 72 6c 63 70 79 28 6c 50 61 74 68 2c 20 4c 4f trlcpy(lPath, LO
29b50 43 4b 50 52 4f 58 59 44 49 52 2c 20 6d 61 78 4c CKPROXYDIR, maxL
29b60 65 6e 29 3b 0a 23 65 6c 73 65 0a 23 20 69 66 64 en);.#else.# ifd
29b70 65 66 20 5f 43 53 5f 44 41 52 57 49 4e 5f 55 53 ef _CS_DARWIN_US
29b80 45 52 5f 54 45 4d 50 5f 44 49 52 0a 20 20 7b 0a ER_TEMP_DIR. {.
29b90 20 20 20 20 69 66 28 20 21 63 6f 6e 66 73 74 72 if( !confstr
29ba0 28 5f 43 53 5f 44 41 52 57 49 4e 5f 55 53 45 52 (_CS_DARWIN_USER
29bb0 5f 54 45 4d 50 5f 44 49 52 2c 20 6c 50 61 74 68 _TEMP_DIR, lPath
29bc0 2c 20 6d 61 78 4c 65 6e 29 20 29 7b 0a 20 20 20 , maxLen) ){.
29bd0 20 20 20 4f 53 54 52 41 43 45 28 28 22 47 45 54 OSTRACE(("GET
29be0 4c 4f 43 4b 50 41 54 48 20 20 66 61 69 6c 65 64 LOCKPATH failed
29bf0 20 25 73 20 65 72 72 6e 6f 3d 25 64 20 70 69 64 %s errno=%d pid
29c00 3d 25 64 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 =%d\n",.
29c10 20 20 20 20 20 20 20 6c 50 61 74 68 2c 20 65 72 lPath, er
29c20 72 6e 6f 2c 20 67 65 74 70 69 64 28 29 29 29 3b rno, getpid()));
29c30 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
29c40 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3b LITE_IOERR_LOCK;
29c50 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e 20 3d . }. len =
29c60 20 73 74 72 6c 63 61 74 28 6c 50 61 74 68 2c 20 strlcat(lPath,
29c70 22 73 71 6c 69 74 65 70 6c 6f 63 6b 73 22 2c 20 "sqliteplocks",
29c80 6d 61 78 4c 65 6e 29 3b 20 20 20 20 0a 20 20 7d maxLen); . }
29c90 0a 23 20 65 6c 73 65 0a 20 20 6c 65 6e 20 3d 20 .# else. len =
29ca0 73 74 72 6c 63 70 79 28 6c 50 61 74 68 2c 20 22 strlcpy(lPath, "
29cb0 2f 74 6d 70 2f 22 2c 20 6d 61 78 4c 65 6e 29 3b /tmp/", maxLen);
29cc0 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a .# endif.#endif.
29cd0 0a 20 20 69 66 28 20 6c 50 61 74 68 5b 6c 65 6e . if( lPath[len
29ce0 2d 31 5d 21 3d 27 2f 27 20 29 7b 0a 20 20 20 20 -1]!='/' ){.
29cf0 6c 65 6e 20 3d 20 73 74 72 6c 63 61 74 28 6c 50 len = strlcat(lP
29d00 61 74 68 2c 20 22 2f 22 2c 20 6d 61 78 4c 65 6e ath, "/", maxLen
29d10 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 74 );. }. . /* t
29d20 72 61 6e 73 66 6f 72 6d 20 74 68 65 20 64 62 20 ransform the db
29d30 70 61 74 68 20 74 6f 20 61 20 75 6e 69 71 75 65 path to a unique
29d40 20 63 61 63 68 65 20 6e 61 6d 65 20 2a 2f 0a 20 cache name */.
29d50 20 64 62 4c 65 6e 20 3d 20 28 69 6e 74 29 73 74 dbLen = (int)st
29d60 72 6c 65 6e 28 64 62 50 61 74 68 29 3b 0a 20 20 rlen(dbPath);.
29d70 66 6f 72 28 20 69 3d 30 3b 20 69 3c 64 62 4c 65 for( i=0; i<dbLe
29d80 6e 20 26 26 20 28 69 2b 6c 65 6e 2b 37 29 3c 6d n && (i+len+7)<m
29d90 61 78 4c 65 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 axLen; i++){.
29da0 20 63 68 61 72 20 63 20 3d 20 64 62 50 61 74 68 char c = dbPath
29db0 5b 69 5d 3b 0a 20 20 20 20 6c 50 61 74 68 5b 69 [i];. lPath[i
29dc0 2b 6c 65 6e 5d 20 3d 20 28 63 3d 3d 27 2f 27 29 +len] = (c=='/')
29dd0 3f 27 5f 27 3a 63 3b 0a 20 20 7d 0a 20 20 6c 50 ?'_':c;. }. lP
29de0 61 74 68 5b 69 2b 6c 65 6e 5d 3d 27 5c 30 27 3b ath[i+len]='\0';
29df0 0a 20 20 73 74 72 6c 63 61 74 28 6c 50 61 74 68 . strlcat(lPath
29e00 2c 20 22 3a 61 75 74 6f 3a 22 2c 20 6d 61 78 4c , ":auto:", maxL
29e10 65 6e 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 en);. OSTRACE((
29e20 22 47 45 54 4c 4f 43 4b 50 41 54 48 20 20 70 72 "GETLOCKPATH pr
29e30 6f 78 79 20 6c 6f 63 6b 20 70 61 74 68 3d 25 73 oxy lock path=%s
29e40 20 70 69 64 3d 25 64 5c 6e 22 2c 20 6c 50 61 74 pid=%d\n", lPat
29e50 68 2c 20 67 65 74 70 69 64 28 29 29 29 3b 0a 20 h, getpid()));.
29e60 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
29e70 4b 3b 0a 7d 0a 0a 2f 2a 20 0a 20 2a 2a 20 43 72 K;.}../* . ** Cr
29e80 65 61 74 65 73 20 74 68 65 20 6c 6f 63 6b 20 66 eates the lock f
29e90 69 6c 65 20 61 6e 64 20 61 6e 79 20 6d 69 73 73 ile and any miss
29ea0 69 6e 67 20 64 69 72 65 63 74 6f 72 69 65 73 20 ing directories
29eb0 69 6e 20 6c 6f 63 6b 50 61 74 68 0a 20 2a 2f 0a in lockPath. */.
29ec0 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 static int proxy
29ed0 43 72 65 61 74 65 4c 6f 63 6b 50 61 74 68 28 63 CreateLockPath(c
29ee0 6f 6e 73 74 20 63 68 61 72 20 2a 6c 6f 63 6b 50 onst char *lockP
29ef0 61 74 68 29 7b 0a 20 20 69 6e 74 20 69 2c 20 6c ath){. int i, l
29f00 65 6e 3b 0a 20 20 63 68 61 72 20 62 75 66 5b 4d en;. char buf[M
29f10 41 58 50 41 54 48 4c 45 4e 5d 3b 0a 20 20 69 6e AXPATHLEN];. in
29f20 74 20 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 0a t start = 0;. .
29f30 20 20 61 73 73 65 72 74 28 6c 6f 63 6b 50 61 74 assert(lockPat
29f40 68 21 3d 4e 55 4c 4c 29 3b 0a 20 20 2f 2a 20 74 h!=NULL);. /* t
29f50 72 79 20 74 6f 20 63 72 65 61 74 65 20 61 6c 6c ry to create all
29f60 20 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 the intermediat
29f70 65 20 64 69 72 65 63 74 6f 72 69 65 73 20 2a 2f e directories */
29f80 0a 20 20 6c 65 6e 20 3d 20 28 69 6e 74 29 73 74 . len = (int)st
29f90 72 6c 65 6e 28 6c 6f 63 6b 50 61 74 68 29 3b 0a rlen(lockPath);.
29fa0 20 20 62 75 66 5b 30 5d 20 3d 20 6c 6f 63 6b 50 buf[0] = lockP
29fb0 61 74 68 5b 30 5d 3b 0a 20 20 66 6f 72 28 20 69 ath[0];. for( i
29fc0 3d 31 3b 20 69 3c 6c 65 6e 3b 20 69 2b 2b 20 29 =1; i<len; i++ )
29fd0 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 50 61 {. if( lockPa
29fe0 74 68 5b 69 5d 20 3d 3d 20 27 2f 27 20 26 26 20 th[i] == '/' &&
29ff0 28 69 20 2d 20 73 74 61 72 74 20 3e 20 30 29 20 (i - start > 0)
2a000 29 7b 0a 20 20 20 20 20 20 2f 2a 20 6f 6e 6c 79 ){. /* only
2a010 20 6d 6b 64 69 72 20 69 66 20 6c 65 61 66 20 64 mkdir if leaf d
2a020 69 72 20 21 3d 20 22 2e 22 20 6f 72 20 22 2f 22 ir != "." or "/"
2a030 20 6f 72 20 22 2e 2e 22 20 2a 2f 0a 20 20 20 20 or ".." */.
2a040 20 20 69 66 28 20 69 2d 73 74 61 72 74 3e 32 20 if( i-start>2
2a050 7c 7c 20 28 69 2d 73 74 61 72 74 3d 3d 31 20 26 || (i-start==1 &
2a060 26 20 62 75 66 5b 73 74 61 72 74 5d 20 21 3d 20 & buf[start] !=
2a070 27 2e 27 20 26 26 20 62 75 66 5b 73 74 61 72 74 '.' && buf[start
2a080 5d 20 21 3d 20 27 2f 27 29 20 0a 20 20 20 20 20 ] != '/') .
2a090 20 20 20 20 7c 7c 20 28 69 2d 73 74 61 72 74 3d || (i-start=
2a0a0 3d 32 20 26 26 20 62 75 66 5b 73 74 61 72 74 5d =2 && buf[start]
2a0b0 20 21 3d 20 27 2e 27 20 26 26 20 62 75 66 5b 73 != '.' && buf[s
2a0c0 74 61 72 74 2b 31 5d 20 21 3d 20 27 2e 27 29 20 tart+1] != '.')
2a0d0 29 7b 0a 20 20 20 20 20 20 20 20 62 75 66 5b 69 ){. buf[i
2a0e0 5d 3d 27 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 ]='\0';.
2a0f0 69 66 28 20 6d 6b 64 69 72 28 62 75 66 2c 20 53 if( mkdir(buf, S
2a100 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 52 QLITE_DEFAULT_PR
2a110 4f 58 59 44 49 52 5f 50 45 52 4d 49 53 53 49 4f OXYDIR_PERMISSIO
2a120 4e 53 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 NS) ){.
2a130 20 69 6e 74 20 65 72 72 3d 65 72 72 6e 6f 3b 0a int err=errno;.
2a140 20 20 20 20 20 20 20 20 20 20 69 66 28 20 65 72 if( er
2a150 72 21 3d 45 45 58 49 53 54 20 29 20 7b 0a 20 20 r!=EEXIST ) {.
2a160 20 20 20 20 20 20 20 20 20 20 4f 53 54 52 41 43 OSTRAC
2a170 45 28 28 22 43 52 45 41 54 45 4c 4f 43 4b 50 41 E(("CREATELOCKPA
2a180 54 48 20 20 46 41 49 4c 45 44 20 63 72 65 61 74 TH FAILED creat
2a190 69 6e 67 20 25 73 2c 20 22 0a 20 20 20 20 20 20 ing %s, ".
2a1a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 "
2a1b0 27 25 73 27 20 70 72 6f 78 79 20 6c 6f 63 6b 20 '%s' proxy lock
2a1c0 70 61 74 68 3d 25 73 20 70 69 64 3d 25 64 5c 6e path=%s pid=%d\n
2a1d0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
2a1e0 20 20 20 20 20 20 20 20 62 75 66 2c 20 73 74 72 buf, str
2a1f0 65 72 72 6f 72 28 65 72 72 29 2c 20 6c 6f 63 6b error(err), lock
2a200 50 61 74 68 2c 20 67 65 74 70 69 64 28 29 29 29 Path, getpid()))
2a210 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 ;. re
2a220 74 75 72 6e 20 65 72 72 3b 0a 20 20 20 20 20 20 turn err;.
2a230 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
2a240 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 74 }. st
2a250 61 72 74 3d 69 2b 31 3b 0a 20 20 20 20 7d 0a 20 art=i+1;. }.
2a260 20 20 20 62 75 66 5b 69 5d 20 3d 20 6c 6f 63 6b buf[i] = lock
2a270 50 61 74 68 5b 69 5d 3b 0a 20 20 7d 0a 20 20 4f Path[i];. }. O
2a280 53 54 52 41 43 45 28 28 22 43 52 45 41 54 45 4c STRACE(("CREATEL
2a290 4f 43 4b 50 41 54 48 20 20 70 72 6f 78 79 20 6c OCKPATH proxy l
2a2a0 6f 63 6b 20 70 61 74 68 3d 25 73 20 70 69 64 3d ock path=%s pid=
2a2b0 25 64 5c 6e 22 2c 20 6c 6f 63 6b 50 61 74 68 2c %d\n", lockPath,
2a2c0 20 67 65 74 70 69 64 28 29 29 29 3b 0a 20 20 72 getpid()));. r
2a2d0 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a eturn 0;.}../*.*
2a2e0 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 56 * Create a new V
2a2f0 46 53 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 FS file descript
2a300 6f 72 20 28 73 74 6f 72 65 64 20 69 6e 20 6d 65 or (stored in me
2a310 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 mory obtained fr
2a320 6f 6d 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61 om.** sqlite3_ma
2a330 6c 6c 6f 63 29 20 61 6e 64 20 6f 70 65 6e 20 74 lloc) and open t
2a340 68 65 20 66 69 6c 65 20 6e 61 6d 65 64 20 22 70 he file named "p
2a350 61 74 68 22 20 69 6e 20 74 68 65 20 66 69 6c 65 ath" in the file
2a360 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 2a 2a 0a descriptor..**.
2a370 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 69 73 ** The caller is
2a380 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 6e 6f 74 responsible not
2a390 20 6f 6e 6c 79 20 66 6f 72 20 63 6c 6f 73 69 6e only for closin
2a3a0 67 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 g the file descr
2a3b0 69 70 74 6f 72 0a 2a 2a 20 62 75 74 20 61 6c 73 iptor.** but als
2a3c0 6f 20 66 6f 72 20 66 72 65 65 69 6e 67 20 74 68 o for freeing th
2a3d0 65 20 6d 65 6d 6f 72 79 20 61 73 73 6f 63 69 61 e memory associa
2a3e0 74 65 64 20 77 69 74 68 20 74 68 65 20 66 69 6c ted with the fil
2a3f0 65 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 2a 2f e descriptor..*/
2a400 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 .static int prox
2a410 79 43 72 65 61 74 65 55 6e 69 78 46 69 6c 65 28 yCreateUnixFile(
2a420 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 . const char
2a430 2a 70 61 74 68 2c 20 20 20 20 20 20 20 20 2f 2a *path, /*
2a440 20 70 61 74 68 20 66 6f 72 20 74 68 65 20 6e 65 path for the ne
2a450 77 20 75 6e 69 78 46 69 6c 65 20 2a 2f 0a 20 20 w unixFile */.
2a460 20 20 75 6e 69 78 46 69 6c 65 20 2a 2a 70 70 46 unixFile **ppF
2a470 69 6c 65 2c 20 20 20 20 20 20 20 2f 2a 20 75 6e ile, /* un
2a480 69 78 46 69 6c 65 20 63 72 65 61 74 65 64 20 61 ixFile created a
2a490 6e 64 20 72 65 74 75 72 6e 65 64 20 62 79 20 72 nd returned by r
2a4a0 65 66 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 73 ef */. int is
2a4b0 6c 6f 63 6b 66 69 6c 65 20 20 20 20 20 20 20 20 lockfile
2a4c0 20 20 20 2f 2a 20 69 66 20 6e 6f 6e 20 7a 65 72 /* if non zer
2a4d0 6f 20 6d 69 73 73 69 6e 67 20 64 69 72 73 20 77 o missing dirs w
2a4e0 69 6c 6c 20 62 65 20 63 72 65 61 74 65 64 20 2a ill be created *
2a4f0 2f 0a 29 20 7b 0a 20 20 69 6e 74 20 66 64 20 3d /.) {. int fd =
2a500 20 2d 31 3b 0a 20 20 69 6e 74 20 64 69 72 66 64 -1;. int dirfd
2a510 20 3d 20 2d 31 3b 0a 20 20 75 6e 69 78 46 69 6c = -1;. unixFil
2a520 65 20 2a 70 4e 65 77 3b 0a 20 20 69 6e 74 20 72 e *pNew;. int r
2a530 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
2a540 20 69 6e 74 20 6f 70 65 6e 46 6c 61 67 73 20 3d int openFlags =
2a550 20 4f 5f 52 44 57 52 20 7c 20 4f 5f 43 52 45 41 O_RDWR | O_CREA
2a560 54 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 T;. sqlite3_vfs
2a570 20 64 75 6d 6d 79 56 66 73 3b 0a 20 20 69 6e 74 dummyVfs;. int
2a580 20 74 65 72 72 6e 6f 20 3d 20 30 3b 0a 20 20 55 terrno = 0;. U
2a590 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e nixUnusedFd *pUn
2a5a0 75 73 65 64 20 3d 20 4e 55 4c 4c 3b 0a 0a 20 20 used = NULL;..
2a5b0 2f 2a 20 31 2e 20 66 69 72 73 74 20 74 72 79 20 /* 1. first try
2a5c0 74 6f 20 6f 70 65 6e 2f 63 72 65 61 74 65 20 74 to open/create t
2a5d0 68 65 20 66 69 6c 65 0a 20 20 2a 2a 20 32 2e 20 he file. ** 2.
2a5e0 69 66 20 74 68 61 74 20 66 61 69 6c 73 2c 20 61 if that fails, a
2a5f0 6e 64 20 74 68 69 73 20 69 73 20 61 20 6c 6f 63 nd this is a loc
2a600 6b 20 66 69 6c 65 20 28 6e 6f 74 2d 63 6f 6e 63 k file (not-conc
2a610 68 29 2c 20 74 72 79 20 63 72 65 61 74 69 6e 67 h), try creating
2a620 0a 20 20 2a 2a 20 74 68 65 20 70 61 72 65 6e 74 . ** the parent
2a630 20 64 69 72 65 63 74 6f 72 69 65 73 20 61 6e 64 directories and
2a640 20 74 68 65 6e 20 74 72 79 20 61 67 61 69 6e 2e then try again.
2a650 0a 20 20 2a 2a 20 33 2e 20 69 66 20 74 68 61 74 . ** 3. if that
2a660 20 66 61 69 6c 73 2c 20 74 72 79 20 74 6f 20 6f fails, try to o
2a670 70 65 6e 20 74 68 65 20 66 69 6c 65 20 72 65 61 pen the file rea
2a680 64 2d 6f 6e 6c 79 0a 20 20 2a 2a 20 6f 74 68 65 d-only. ** othe
2a690 72 77 69 73 65 20 72 65 74 75 72 6e 20 42 55 53 rwise return BUS
2a6a0 59 20 28 69 66 20 6c 6f 63 6b 20 66 69 6c 65 29 Y (if lock file)
2a6b0 20 6f 72 20 43 41 4e 54 4f 50 45 4e 20 66 6f 72 or CANTOPEN for
2a6c0 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 0a the conch file.
2a6d0 20 20 2a 2f 0a 20 20 70 55 6e 75 73 65 64 20 3d */. pUnused =
2a6e0 20 66 69 6e 64 52 65 75 73 61 62 6c 65 46 64 28 findReusableFd(
2a6f0 70 61 74 68 2c 20 6f 70 65 6e 46 6c 61 67 73 29 path, openFlags)
2a700 3b 0a 20 20 69 66 28 20 70 55 6e 75 73 65 64 20 ;. if( pUnused
2a710 29 7b 0a 20 20 20 20 66 64 20 3d 20 70 55 6e 75 ){. fd = pUnu
2a720 73 65 64 2d 3e 66 64 3b 0a 20 20 7d 65 6c 73 65 sed->fd;. }else
2a730 7b 0a 20 20 20 20 70 55 6e 75 73 65 64 20 3d 20 {. pUnused =
2a740 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73 sqlite3_malloc(s
2a750 69 7a 65 6f 66 28 2a 70 55 6e 75 73 65 64 29 29 izeof(*pUnused))
2a760 3b 0a 20 20 20 20 69 66 28 20 21 70 55 6e 75 73 ;. if( !pUnus
2a770 65 64 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ed ){. retu
2a780 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
2a790 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 . }. }. if(
2a7a0 20 66 64 3c 30 20 29 7b 0a 20 20 20 20 66 64 20 fd<0 ){. fd
2a7b0 3d 20 6f 70 65 6e 28 70 61 74 68 2c 20 6f 70 65 = open(path, ope
2a7c0 6e 46 6c 61 67 73 2c 20 53 51 4c 49 54 45 5f 44 nFlags, SQLITE_D
2a7d0 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d EFAULT_FILE_PERM
2a7e0 49 53 53 49 4f 4e 53 29 3b 0a 20 20 20 20 74 65 ISSIONS);. te
2a7f0 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 rrno = errno;.
2a800 20 20 69 66 28 20 66 64 3c 30 20 26 26 20 65 72 if( fd<0 && er
2a810 72 6e 6f 3d 3d 45 4e 4f 45 4e 54 20 26 26 20 69 rno==ENOENT && i
2a820 73 6c 6f 63 6b 66 69 6c 65 20 29 7b 0a 20 20 20 slockfile ){.
2a830 20 20 20 69 66 28 20 70 72 6f 78 79 43 72 65 61 if( proxyCrea
2a840 74 65 4c 6f 63 6b 50 61 74 68 28 70 61 74 68 29 teLockPath(path)
2a850 20 3d 3d 20 53 51 4c 49 54 45 5f 4f 4b 20 29 7b == SQLITE_OK ){
2a860 0a 20 20 20 20 20 20 20 20 66 64 20 3d 20 6f 70 . fd = op
2a870 65 6e 28 70 61 74 68 2c 20 6f 70 65 6e 46 6c 61 en(path, openFla
2a880 67 73 2c 20 53 51 4c 49 54 45 5f 44 45 46 41 55 gs, SQLITE_DEFAU
2a890 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 LT_FILE_PERMISSI
2a8a0 4f 4e 53 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ONS);. }.
2a8b0 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 66 64 }. }. if( fd
2a8c0 3c 30 20 29 7b 0a 20 20 20 20 6f 70 65 6e 46 6c <0 ){. openFl
2a8d0 61 67 73 20 3d 20 4f 5f 52 44 4f 4e 4c 59 3b 0a ags = O_RDONLY;.
2a8e0 20 20 20 20 66 64 20 3d 20 6f 70 65 6e 28 70 61 fd = open(pa
2a8f0 74 68 2c 20 6f 70 65 6e 46 6c 61 67 73 2c 20 53 th, openFlags, S
2a900 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 QLITE_DEFAULT_FI
2a910 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 29 3b LE_PERMISSIONS);
2a920 0a 20 20 20 20 74 65 72 72 6e 6f 20 3d 20 65 72 . terrno = er
2a930 72 6e 6f 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 rno;. }. if( f
2a940 64 3c 30 20 29 7b 0a 20 20 20 20 69 66 28 20 69 d<0 ){. if( i
2a950 73 6c 6f 63 6b 66 69 6c 65 20 29 7b 0a 20 20 20 slockfile ){.
2a960 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2a970 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 _BUSY;. }.
2a980 20 73 77 69 74 63 68 20 28 74 65 72 72 6e 6f 29 switch (terrno)
2a990 20 7b 0a 20 20 20 20 20 20 63 61 73 65 20 45 41 {. case EA
2a9a0 43 43 45 53 3a 0a 20 20 20 20 20 20 20 20 72 65 CCES:. re
2a9b0 74 75 72 6e 20 53 51 4c 49 54 45 5f 50 45 52 4d turn SQLITE_PERM
2a9c0 3b 0a 20 20 20 20 20 20 63 61 73 65 20 45 49 4f ;. case EIO
2a9d0 3a 20 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 : . retur
2a9e0 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c n SQLITE_IOERR_L
2a9f0 4f 43 4b 3b 20 2f 2a 20 65 76 65 6e 20 74 68 6f OCK; /* even tho
2aa00 75 67 68 20 69 74 20 69 73 20 74 68 65 20 63 6f ugh it is the co
2aa10 6e 63 68 20 2a 2f 0a 20 20 20 20 20 20 64 65 66 nch */. def
2aa20 61 75 6c 74 3a 0a 20 20 20 20 20 20 20 20 72 65 ault:. re
2aa30 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 turn SQLITE_CANT
2aa40 4f 50 45 4e 5f 42 4b 50 54 3b 0a 20 20 20 20 7d OPEN_BKPT;. }
2aa50 0a 20 20 7d 0a 20 20 0a 20 20 70 4e 65 77 20 3d . }. . pNew =
2aa60 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 73 71 6c (unixFile *)sql
2aa70 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73 69 7a 65 ite3_malloc(size
2aa80 6f 66 28 2a 70 4e 65 77 29 29 3b 0a 20 20 69 66 of(*pNew));. if
2aa90 28 20 70 4e 65 77 3d 3d 4e 55 4c 4c 20 29 7b 0a ( pNew==NULL ){.
2aaa0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2aab0 4e 4f 4d 45 4d 3b 0a 20 20 20 20 67 6f 74 6f 20 NOMEM;. goto
2aac0 65 6e 64 5f 63 72 65 61 74 65 5f 70 72 6f 78 79 end_create_proxy
2aad0 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 70 ;. }. memset(p
2aae0 4e 65 77 2c 20 30 2c 20 73 69 7a 65 6f 66 28 75 New, 0, sizeof(u
2aaf0 6e 69 78 46 69 6c 65 29 29 3b 0a 20 20 70 4e 65 nixFile));. pNe
2ab00 77 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 6f w->openFlags = o
2ab10 70 65 6e 46 6c 61 67 73 3b 0a 20 20 64 75 6d 6d penFlags;. dumm
2ab20 79 56 66 73 2e 70 41 70 70 44 61 74 61 20 3d 20 yVfs.pAppData =
2ab30 28 76 6f 69 64 2a 29 26 61 75 74 6f 6c 6f 63 6b (void*)&autolock
2ab40 49 6f 46 69 6e 64 65 72 3b 0a 20 20 70 55 6e 75 IoFinder;. pUnu
2ab50 73 65 64 2d 3e 66 64 20 3d 20 66 64 3b 0a 20 20 sed->fd = fd;.
2ab60 70 55 6e 75 73 65 64 2d 3e 66 6c 61 67 73 20 3d pUnused->flags =
2ab70 20 6f 70 65 6e 46 6c 61 67 73 3b 0a 20 20 70 4e openFlags;. pN
2ab80 65 77 2d 3e 70 55 6e 75 73 65 64 20 3d 20 70 55 ew->pUnused = pU
2ab90 6e 75 73 65 64 3b 0a 20 20 0a 20 20 72 63 20 3d nused;. . rc =
2aba0 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 6c 65 28 fillInUnixFile(
2abb0 26 64 75 6d 6d 79 56 66 73 2c 20 66 64 2c 20 64 &dummyVfs, fd, d
2abc0 69 72 66 64 2c 20 28 73 71 6c 69 74 65 33 5f 66 irfd, (sqlite3_f
2abd0 69 6c 65 2a 29 70 4e 65 77 2c 20 70 61 74 68 2c ile*)pNew, path,
2abe0 20 30 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 0, 0);. if( rc
2abf0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2ac00 20 20 20 2a 70 70 46 69 6c 65 20 3d 20 70 4e 65 *ppFile = pNe
2ac10 77 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 w;. return SQ
2ac20 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 65 6e 64 LITE_OK;. }.end
2ac30 5f 63 72 65 61 74 65 5f 70 72 6f 78 79 3a 20 20 _create_proxy:
2ac40 20 20 0a 20 20 63 6c 6f 73 65 28 66 64 29 3b 20 . close(fd);
2ac50 2f 2a 20 73 69 6c 65 6e 74 6c 79 20 6c 65 61 6b /* silently leak
2ac60 20 66 64 20 69 66 20 65 72 72 6f 72 2c 20 77 65 fd if error, we
2ac70 27 72 65 20 61 6c 72 65 61 64 79 20 69 6e 20 65 're already in e
2ac80 72 72 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 rror */. sqlite
2ac90 33 5f 66 72 65 65 28 70 4e 65 77 29 3b 0a 20 20 3_free(pNew);.
2aca0 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 55 6e sqlite3_free(pUn
2acb0 75 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 used);. return
2acc0 72 63 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 rc;.}..#ifdef SQ
2acd0 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 20 73 69 6d LITE_TEST./* sim
2ace0 75 6c 61 74 65 20 6d 75 6c 74 69 70 6c 65 20 68 ulate multiple h
2acf0 6f 73 74 73 20 62 79 20 63 72 65 61 74 69 6e 67 osts by creating
2ad00 20 75 6e 69 71 75 65 20 68 6f 73 74 69 64 20 66 unique hostid f
2ad10 69 6c 65 20 70 61 74 68 73 20 2a 2f 0a 69 6e 74 ile paths */.int
2ad20 20 73 71 6c 69 74 65 33 5f 68 6f 73 74 69 64 5f sqlite3_hostid_
2ad30 6e 75 6d 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a num = 0;.#endif.
2ad40 0a 23 64 65 66 69 6e 65 20 50 52 4f 58 59 5f 48 .#define PROXY_H
2ad50 4f 53 54 49 44 4c 45 4e 20 20 20 20 31 36 20 20 OSTIDLEN 16
2ad60 2f 2a 20 63 6f 6e 63 68 20 66 69 6c 65 20 68 6f /* conch file ho
2ad70 73 74 20 69 64 20 6c 65 6e 67 74 68 20 2a 2f 0a st id length */.
2ad80 0a 2f 2a 20 67 65 74 20 74 68 65 20 68 6f 73 74 ./* get the host
2ad90 20 49 44 20 76 69 61 20 67 65 74 68 6f 73 74 75 ID via gethostu
2ada0 75 69 64 28 29 2c 20 70 48 6f 73 74 49 44 20 6d uid(), pHostID m
2adb0 75 73 74 20 70 6f 69 6e 74 20 74 6f 20 50 52 4f ust point to PRO
2adc0 58 59 5f 48 4f 53 54 49 44 4c 45 4e 20 0a 2a 2a XY_HOSTIDLEN .**
2add0 20 62 79 74 65 73 20 6f 66 20 77 72 69 74 61 62 bytes of writab
2ade0 6c 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 le memory..*/.st
2adf0 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 47 65 atic int proxyGe
2ae00 74 48 6f 73 74 49 44 28 75 6e 73 69 67 6e 65 64 tHostID(unsigned
2ae10 20 63 68 61 72 20 2a 70 48 6f 73 74 49 44 2c 20 char *pHostID,
2ae20 69 6e 74 20 2a 70 45 72 72 6f 72 29 7b 0a 20 20 int *pError){.
2ae30 73 74 72 75 63 74 20 74 69 6d 65 73 70 65 63 20 struct timespec
2ae40 74 69 6d 65 6f 75 74 20 3d 20 7b 31 2c 20 30 7d timeout = {1, 0}
2ae50 3b 20 2f 2a 20 31 20 73 65 63 20 74 69 6d 65 6f ; /* 1 sec timeo
2ae60 75 74 20 2a 2f 0a 20 20 0a 20 20 61 73 73 65 72 ut */. . asser
2ae70 74 28 50 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 t(PROXY_HOSTIDLE
2ae80 4e 20 3d 3d 20 73 69 7a 65 6f 66 28 75 75 69 64 N == sizeof(uuid
2ae90 5f 74 29 29 3b 0a 20 20 6d 65 6d 73 65 74 28 70 _t));. memset(p
2aea0 48 6f 73 74 49 44 2c 20 30 2c 20 50 52 4f 58 59 HostID, 0, PROXY
2aeb0 5f 48 4f 53 54 49 44 4c 45 4e 29 3b 0a 20 20 69 _HOSTIDLEN);. i
2aec0 66 28 20 67 65 74 68 6f 73 74 75 75 69 64 28 70 f( gethostuuid(p
2aed0 48 6f 73 74 49 44 2c 20 26 74 69 6d 65 6f 75 74 HostID, &timeout
2aee0 29 20 29 7b 0a 20 20 20 20 69 6e 74 20 65 72 72 ) ){. int err
2aef0 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 69 66 = errno;. if
2af00 28 20 70 45 72 72 6f 72 20 29 7b 0a 20 20 20 20 ( pError ){.
2af10 20 20 2a 70 45 72 72 6f 72 20 3d 20 65 72 72 3b *pError = err;
2af20 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 . }. retur
2af30 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a n SQLITE_IOERR;.
2af40 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }.#ifdef SQLIT
2af50 45 5f 54 45 53 54 0a 20 20 2f 2a 20 73 69 6d 75 E_TEST. /* simu
2af60 6c 61 74 65 20 6d 75 6c 74 69 70 6c 65 20 68 6f late multiple ho
2af70 73 74 73 20 62 79 20 63 72 65 61 74 69 6e 67 20 sts by creating
2af80 75 6e 69 71 75 65 20 68 6f 73 74 69 64 20 66 69 unique hostid fi
2af90 6c 65 20 70 61 74 68 73 20 2a 2f 0a 20 20 69 66 le paths */. if
2afa0 28 20 73 71 6c 69 74 65 33 5f 68 6f 73 74 69 64 ( sqlite3_hostid
2afb0 5f 6e 75 6d 20 21 3d 20 30 29 7b 0a 20 20 20 20 _num != 0){.
2afc0 70 48 6f 73 74 49 44 5b 30 5d 20 3d 20 28 63 68 pHostID[0] = (ch
2afd0 61 72 29 28 70 48 6f 73 74 49 44 5b 30 5d 20 2b ar)(pHostID[0] +
2afe0 20 28 63 68 61 72 29 28 73 71 6c 69 74 65 33 5f (char)(sqlite3_
2aff0 68 6f 73 74 69 64 5f 6e 75 6d 20 26 20 30 78 46 hostid_num & 0xF
2b000 46 29 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a F));. }.#endif.
2b010 20 20 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
2b020 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 54 68 65 TE_OK;.}../* The
2b030 20 63 6f 6e 63 68 20 66 69 6c 65 20 63 6f 6e 74 conch file cont
2b040 61 69 6e 73 20 74 68 65 20 68 65 61 64 65 72 2c ains the header,
2b050 20 68 6f 73 74 20 69 64 20 61 6e 64 20 6c 6f 63 host id and loc
2b060 6b 20 66 69 6c 65 20 70 61 74 68 0a 20 2a 2f 0a k file path. */.
2b070 23 64 65 66 69 6e 65 20 50 52 4f 58 59 5f 43 4f #define PROXY_CO
2b080 4e 43 48 56 45 52 53 49 4f 4e 20 32 20 20 20 2f NCHVERSION 2 /
2b090 2a 20 31 2d 62 79 74 65 20 68 65 61 64 65 72 2c * 1-byte header,
2b0a0 20 31 36 2d 62 79 74 65 20 68 6f 73 74 20 69 64 16-byte host id
2b0b0 2c 20 70 61 74 68 20 2a 2f 0a 23 64 65 66 69 6e , path */.#defin
2b0c0 65 20 50 52 4f 58 59 5f 48 45 41 44 45 52 4c 45 e PROXY_HEADERLE
2b0d0 4e 20 20 20 20 31 20 20 20 2f 2a 20 63 6f 6e 63 N 1 /* conc
2b0e0 68 20 66 69 6c 65 20 68 65 61 64 65 72 20 6c 65 h file header le
2b0f0 6e 67 74 68 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ngth */.#define
2b100 50 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 20 PROXY_PATHINDEX
2b110 20 20 20 28 50 52 4f 58 59 5f 48 45 41 44 45 52 (PROXY_HEADER
2b120 4c 45 4e 2b 50 52 4f 58 59 5f 48 4f 53 54 49 44 LEN+PROXY_HOSTID
2b130 4c 45 4e 29 0a 23 64 65 66 69 6e 65 20 50 52 4f LEN).#define PRO
2b140 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e 20 20 XY_MAXCONCHLEN
2b150 28 50 52 4f 58 59 5f 48 45 41 44 45 52 4c 45 4e (PROXY_HEADERLEN
2b160 2b 50 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 4e +PROXY_HOSTIDLEN
2b170 2b 4d 41 58 50 41 54 48 4c 45 4e 29 0a 0a 2f 2a +MAXPATHLEN)../*
2b180 20 0a 2a 2a 20 54 61 6b 65 73 20 61 6e 20 6f 70 .** Takes an op
2b190 65 6e 20 63 6f 6e 63 68 20 66 69 6c 65 2c 20 63 en conch file, c
2b1a0 6f 70 69 65 73 20 74 68 65 20 63 6f 6e 74 65 6e opies the conten
2b1b0 74 73 20 74 6f 20 61 20 6e 65 77 20 70 61 74 68 ts to a new path
2b1c0 20 61 6e 64 20 74 68 65 6e 20 6d 6f 76 65 73 20 and then moves
2b1d0 0a 2a 2a 20 69 74 20 62 61 63 6b 2e 20 20 54 68 .** it back. Th
2b1e0 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 e newly created
2b1f0 66 69 6c 65 27 73 20 66 69 6c 65 20 64 65 73 63 file's file desc
2b200 72 69 70 74 6f 72 20 69 73 20 61 73 73 69 67 6e riptor is assign
2b210 65 64 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e ed to the.** con
2b220 63 68 20 66 69 6c 65 20 73 74 72 75 63 74 75 72 ch file structur
2b230 65 20 61 6e 64 20 66 69 6e 61 6c 6c 79 20 74 68 e and finally th
2b240 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 63 68 e original conch
2b250 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
2b260 20 69 73 20 0a 2a 2a 20 63 6c 6f 73 65 64 2e 20 is .** closed.
2b270 20 52 65 74 75 72 6e 73 20 7a 65 72 6f 20 69 66 Returns zero if
2b280 20 73 75 63 63 65 73 73 66 75 6c 2e 0a 2a 2f 0a successful..*/.
2b290 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 static int proxy
2b2a0 42 72 65 61 6b 43 6f 6e 63 68 4c 6f 63 6b 28 75 BreakConchLock(u
2b2b0 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 nixFile *pFile,
2b2c0 75 75 69 64 5f 74 20 6d 79 48 6f 73 74 49 44 29 uuid_t myHostID)
2b2d0 7b 0a 20 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 {. proxyLocking
2b2e0 43 6f 6e 74 65 78 74 20 2a 70 43 74 78 20 3d 20 Context *pCtx =
2b2f0 28 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e (proxyLockingCon
2b300 74 65 78 74 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f text *)pFile->lo
2b310 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 20 0a 20 ckingContext; .
2b320 20 75 6e 69 78 46 69 6c 65 20 2a 63 6f 6e 63 68 unixFile *conch
2b330 46 69 6c 65 20 3d 20 70 43 74 78 2d 3e 63 6f 6e File = pCtx->con
2b340 63 68 46 69 6c 65 3b 0a 20 20 63 68 61 72 20 74 chFile;. char t
2b350 50 61 74 68 5b 4d 41 58 50 41 54 48 4c 45 4e 5d Path[MAXPATHLEN]
2b360 3b 0a 20 20 63 68 61 72 20 62 75 66 5b 50 52 4f ;. char buf[PRO
2b370 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e 5d 3b XY_MAXCONCHLEN];
2b380 0a 20 20 63 68 61 72 20 2a 63 50 61 74 68 20 3d . char *cPath =
2b390 20 70 43 74 78 2d 3e 63 6f 6e 63 68 46 69 6c 65 pCtx->conchFile
2b3a0 50 61 74 68 3b 0a 20 20 73 69 7a 65 5f 74 20 72 Path;. size_t r
2b3b0 65 61 64 4c 65 6e 20 3d 20 30 3b 0a 20 20 73 69 eadLen = 0;. si
2b3c0 7a 65 5f 74 20 70 61 74 68 4c 65 6e 20 3d 20 30 ze_t pathLen = 0
2b3d0 3b 0a 20 20 63 68 61 72 20 65 72 72 6d 73 67 5b ;. char errmsg[
2b3e0 36 34 5d 20 3d 20 22 22 3b 0a 20 20 69 6e 74 20 64] = "";. int
2b3f0 66 64 20 3d 20 2d 31 3b 0a 20 20 69 6e 74 20 72 fd = -1;. int r
2b400 63 20 3d 20 2d 31 3b 0a 0a 20 20 2f 2a 20 63 72 c = -1;.. /* cr
2b410 65 61 74 65 20 61 20 6e 65 77 20 70 61 74 68 20 eate a new path
2b420 62 79 20 72 65 70 6c 61 63 65 20 74 68 65 20 74 by replace the t
2b430 72 61 69 6c 69 6e 67 20 27 2d 63 6f 6e 63 68 27 railing '-conch'
2b440 20 77 69 74 68 20 27 2d 62 72 65 61 6b 27 20 2a with '-break' *
2b450 2f 0a 20 20 70 61 74 68 4c 65 6e 20 3d 20 73 74 /. pathLen = st
2b460 72 6c 63 70 79 28 74 50 61 74 68 2c 20 63 50 61 rlcpy(tPath, cPa
2b470 74 68 2c 20 4d 41 58 50 41 54 48 4c 45 4e 29 3b th, MAXPATHLEN);
2b480 0a 20 20 69 66 28 20 70 61 74 68 4c 65 6e 3e 4d . if( pathLen>M
2b490 41 58 50 41 54 48 4c 45 4e 20 7c 7c 20 70 61 74 AXPATHLEN || pat
2b4a0 68 4c 65 6e 3c 36 20 7c 7c 20 0a 20 20 20 20 20 hLen<6 || .
2b4b0 28 73 74 72 6c 63 70 79 28 26 74 50 61 74 68 5b (strlcpy(&tPath[
2b4c0 70 61 74 68 4c 65 6e 2d 35 5d 2c 20 22 62 72 65 pathLen-5], "bre
2b4d0 61 6b 22 2c 20 36 29 20 21 3d 20 35 29 20 29 7b ak", 6) != 5) ){
2b4e0 0a 20 20 20 20 73 70 72 69 6e 74 66 28 65 72 72 . sprintf(err
2b4f0 6d 73 67 2c 20 22 70 61 74 68 20 65 72 72 6f 72 msg, "path error
2b500 20 28 6c 65 6e 20 25 64 29 22 2c 20 28 69 6e 74 (len %d)", (int
2b510 29 70 61 74 68 4c 65 6e 29 3b 0a 20 20 20 20 67 )pathLen);. g
2b520 6f 74 6f 20 65 6e 64 5f 62 72 65 61 6b 6c 6f 63 oto end_breakloc
2b530 6b 3b 0a 20 20 7d 0a 20 20 2f 2a 20 72 65 61 64 k;. }. /* read
2b540 20 74 68 65 20 63 6f 6e 63 68 20 63 6f 6e 74 65 the conch conte
2b550 6e 74 20 2a 2f 0a 20 20 72 65 61 64 4c 65 6e 20 nt */. readLen
2b560 3d 20 70 72 65 61 64 28 63 6f 6e 63 68 46 69 6c = pread(conchFil
2b570 65 2d 3e 68 2c 20 62 75 66 2c 20 50 52 4f 58 59 e->h, buf, PROXY
2b580 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e 2c 20 30 29 _MAXCONCHLEN, 0)
2b590 3b 0a 20 20 69 66 28 20 72 65 61 64 4c 65 6e 3c ;. if( readLen<
2b5a0 50 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 20 PROXY_PATHINDEX
2b5b0 29 7b 0a 20 20 20 20 73 70 72 69 6e 74 66 28 65 ){. sprintf(e
2b5c0 72 72 6d 73 67 2c 20 22 72 65 61 64 20 65 72 72 rrmsg, "read err
2b5d0 6f 72 20 28 6c 65 6e 20 25 64 29 22 2c 20 28 69 or (len %d)", (i
2b5e0 6e 74 29 72 65 61 64 4c 65 6e 29 3b 0a 20 20 20 nt)readLen);.
2b5f0 20 67 6f 74 6f 20 65 6e 64 5f 62 72 65 61 6b 6c goto end_breakl
2b600 6f 63 6b 3b 0a 20 20 7d 0a 20 20 2f 2a 20 77 72 ock;. }. /* wr
2b610 69 74 65 20 69 74 20 6f 75 74 20 74 6f 20 74 68 ite it out to th
2b620 65 20 74 65 6d 70 6f 72 61 72 79 20 62 72 65 61 e temporary brea
2b630 6b 20 66 69 6c 65 20 2a 2f 0a 20 20 66 64 20 3d k file */. fd =
2b640 20 6f 70 65 6e 28 74 50 61 74 68 2c 20 28 4f 5f open(tPath, (O_
2b650 52 44 57 52 7c 4f 5f 43 52 45 41 54 7c 4f 5f 45 RDWR|O_CREAT|O_E
2b660 58 43 4c 29 2c 20 53 51 4c 49 54 45 5f 44 45 46 XCL), SQLITE_DEF
2b670 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 AULT_FILE_PERMIS
2b680 53 49 4f 4e 53 29 3b 0a 20 20 69 66 28 20 66 64 SIONS);. if( fd
2b690 3c 30 20 29 7b 0a 20 20 20 20 73 70 72 69 6e 74 <0 ){. sprint
2b6a0 66 28 65 72 72 6d 73 67 2c 20 22 63 72 65 61 74 f(errmsg, "creat
2b6b0 65 20 66 61 69 6c 65 64 20 28 25 64 29 22 2c 20 e failed (%d)",
2b6c0 65 72 72 6e 6f 29 3b 0a 20 20 20 20 67 6f 74 6f errno);. goto
2b6d0 20 65 6e 64 5f 62 72 65 61 6b 6c 6f 63 6b 3b 0a end_breaklock;.
2b6e0 20 20 7d 0a 20 20 69 66 28 20 70 77 72 69 74 65 }. if( pwrite
2b6f0 28 66 64 2c 20 62 75 66 2c 20 72 65 61 64 4c 65 (fd, buf, readLe
2b700 6e 2c 20 30 29 20 21 3d 20 72 65 61 64 4c 65 6e n, 0) != readLen
2b710 20 29 7b 0a 20 20 20 20 73 70 72 69 6e 74 66 28 ){. sprintf(
2b720 65 72 72 6d 73 67 2c 20 22 77 72 69 74 65 20 66 errmsg, "write f
2b730 61 69 6c 65 64 20 28 25 64 29 22 2c 20 65 72 72 ailed (%d)", err
2b740 6e 6f 29 3b 0a 20 20 20 20 67 6f 74 6f 20 65 6e no);. goto en
2b750 64 5f 62 72 65 61 6b 6c 6f 63 6b 3b 0a 20 20 7d d_breaklock;. }
2b760 0a 20 20 69 66 28 20 72 65 6e 61 6d 65 28 74 50 . if( rename(tP
2b770 61 74 68 2c 20 63 50 61 74 68 29 20 29 7b 0a 20 ath, cPath) ){.
2b780 20 20 20 73 70 72 69 6e 74 66 28 65 72 72 6d 73 sprintf(errms
2b790 67 2c 20 22 72 65 6e 61 6d 65 20 66 61 69 6c 65 g, "rename faile
2b7a0 64 20 28 25 64 29 22 2c 20 65 72 72 6e 6f 29 3b d (%d)", errno);
2b7b0 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 62 72 . goto end_br
2b7c0 65 61 6b 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 72 eaklock;. }. r
2b7d0 63 20 3d 20 30 3b 0a 20 20 66 70 72 69 6e 74 66 c = 0;. fprintf
2b7e0 28 73 74 64 65 72 72 2c 20 22 62 72 6f 6b 65 20 (stderr, "broke
2b7f0 73 74 61 6c 65 20 6c 6f 63 6b 20 6f 6e 20 25 73 stale lock on %s
2b800 5c 6e 22 2c 20 63 50 61 74 68 29 3b 0a 20 20 63 \n", cPath);. c
2b810 6c 6f 73 65 28 63 6f 6e 63 68 46 69 6c 65 2d 3e lose(conchFile->
2b820 68 29 3b 0a 20 20 63 6f 6e 63 68 46 69 6c 65 2d h);. conchFile-
2b830 3e 68 20 3d 20 66 64 3b 0a 20 20 63 6f 6e 63 68 >h = fd;. conch
2b840 46 69 6c 65 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 File->openFlags
2b850 3d 20 4f 5f 52 44 57 52 20 7c 20 4f 5f 43 52 45 = O_RDWR | O_CRE
2b860 41 54 3b 0a 0a 65 6e 64 5f 62 72 65 61 6b 6c 6f AT;..end_breaklo
2b870 63 6b 3a 0a 20 20 69 66 28 20 72 63 20 29 7b 0a ck:. if( rc ){.
2b880 20 20 20 20 69 66 28 20 66 64 3e 3d 30 20 29 7b if( fd>=0 ){
2b890 0a 20 20 20 20 20 20 75 6e 6c 69 6e 6b 28 74 50 . unlink(tP
2b8a0 61 74 68 29 3b 0a 20 20 20 20 20 20 63 6c 6f 73 ath);. clos
2b8b0 65 28 66 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 e(fd);. }.
2b8c0 20 66 70 72 69 6e 74 66 28 73 74 64 65 72 72 2c fprintf(stderr,
2b8d0 20 22 66 61 69 6c 65 64 20 74 6f 20 62 72 65 61 "failed to brea
2b8e0 6b 20 73 74 61 6c 65 20 6c 6f 63 6b 20 6f 6e 20 k stale lock on
2b8f0 25 73 2c 20 25 73 5c 6e 22 2c 20 63 50 61 74 68 %s, %s\n", cPath
2b900 2c 20 65 72 72 6d 73 67 29 3b 0a 20 20 7d 0a 20 , errmsg);. }.
2b910 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
2b920 2a 20 54 61 6b 65 20 74 68 65 20 72 65 71 75 65 * Take the reque
2b930 73 74 65 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 sted lock on the
2b940 20 63 6f 6e 63 68 20 66 69 6c 65 20 61 6e 64 20 conch file and
2b950 62 72 65 61 6b 20 61 20 73 74 61 6c 65 20 6c 6f break a stale lo
2b960 63 6b 20 69 66 20 74 68 65 20 0a 2a 2a 20 68 6f ck if the .** ho
2b970 73 74 20 69 64 20 6d 61 74 63 68 65 73 2e 0a 2a st id matches..*
2b980 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f /.static int pro
2b990 78 79 43 6f 6e 63 68 4c 6f 63 6b 28 75 6e 69 78 xyConchLock(unix
2b9a0 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 75 75 69 File *pFile, uui
2b9b0 64 5f 74 20 6d 79 48 6f 73 74 49 44 2c 20 69 6e d_t myHostID, in
2b9c0 74 20 6c 6f 63 6b 54 79 70 65 29 7b 0a 20 20 70 t lockType){. p
2b9d0 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 roxyLockingConte
2b9e0 78 74 20 2a 70 43 74 78 20 3d 20 28 70 72 6f 78 xt *pCtx = (prox
2b9f0 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 yLockingContext
2ba00 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 *)pFile->locking
2ba10 43 6f 6e 74 65 78 74 3b 20 0a 20 20 75 6e 69 78 Context; . unix
2ba20 46 69 6c 65 20 2a 63 6f 6e 63 68 46 69 6c 65 20 File *conchFile
2ba30 3d 20 70 43 74 78 2d 3e 63 6f 6e 63 68 46 69 6c = pCtx->conchFil
2ba40 65 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 e;. int rc = SQ
2ba50 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e LITE_OK;. int n
2ba60 54 72 69 65 73 20 3d 20 30 3b 0a 20 20 73 74 72 Tries = 0;. str
2ba70 75 63 74 20 74 69 6d 65 73 70 65 63 20 63 6f 6e uct timespec con
2ba80 63 68 4d 6f 64 54 69 6d 65 3b 0a 20 20 0a 20 20 chModTime;. .
2ba90 64 6f 20 7b 0a 20 20 20 20 72 63 20 3d 20 63 6f do {. rc = co
2baa0 6e 63 68 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 nchFile->pMethod
2bab0 2d 3e 78 4c 6f 63 6b 28 28 73 71 6c 69 74 65 33 ->xLock((sqlite3
2bac0 5f 66 69 6c 65 2a 29 63 6f 6e 63 68 46 69 6c 65 _file*)conchFile
2bad0 2c 20 6c 6f 63 6b 54 79 70 65 29 3b 0a 20 20 20 , lockType);.
2bae0 20 6e 54 72 69 65 73 20 2b 2b 3b 0a 20 20 20 20 nTries ++;.
2baf0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 if( rc==SQLITE_B
2bb00 55 53 59 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 USY ){. /*
2bb10 49 66 20 74 68 65 20 6c 6f 63 6b 20 66 61 69 6c If the lock fail
2bb20 65 64 20 28 62 75 73 79 29 3a 0a 20 20 20 20 20 ed (busy):.
2bb30 20 20 2a 20 31 73 74 20 74 72 79 3a 20 67 65 74 * 1st try: get
2bb40 20 74 68 65 20 6d 6f 64 20 74 69 6d 65 20 6f 66 the mod time of
2bb50 20 74 68 65 20 63 6f 6e 63 68 2c 20 77 61 69 74 the conch, wait
2bb60 20 30 2e 35 73 20 61 6e 64 20 74 72 79 20 61 67 0.5s and try ag
2bb70 61 69 6e 2e 20 0a 20 20 20 20 20 20 20 2a 20 32 ain. . * 2
2bb80 6e 64 20 74 72 79 3a 20 66 61 69 6c 20 69 66 20 nd try: fail if
2bb90 74 68 65 20 6d 6f 64 20 74 69 6d 65 20 63 68 61 the mod time cha
2bba0 6e 67 65 64 20 6f 72 20 68 6f 73 74 20 69 64 20 nged or host id
2bbb0 69 73 20 64 69 66 66 65 72 65 6e 74 2c 20 77 61 is different, wa
2bbc0 69 74 20 0a 20 20 20 20 20 20 20 2a 20 20 20 20 it . *
2bbd0 20 20 20 20 20 20 20 31 30 20 73 65 63 20 61 6e 10 sec an
2bbe0 64 20 74 72 79 20 61 67 61 69 6e 0a 20 20 20 20 d try again.
2bbf0 20 20 20 2a 20 33 72 64 20 74 72 79 3a 20 62 72 * 3rd try: br
2bc00 65 61 6b 20 74 68 65 20 6c 6f 63 6b 20 75 6e 6c eak the lock unl
2bc10 65 73 73 20 74 68 65 20 6d 6f 64 20 74 69 6d 65 ess the mod time
2bc20 20 68 61 73 20 63 68 61 6e 67 65 64 2e 0a 20 20 has changed..
2bc30 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 74 */. st
2bc40 72 75 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 ruct stat buf;.
2bc50 20 20 20 20 20 69 66 28 20 66 73 74 61 74 28 63 if( fstat(c
2bc60 6f 6e 63 68 46 69 6c 65 2d 3e 68 2c 20 26 62 75 onchFile->h, &bu
2bc70 66 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46 f) ){. pF
2bc80 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 20 3d ile->lastErrno =
2bc90 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 errno;.
2bca0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f return SQLITE_IO
2bcb0 45 52 52 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 ERR_LOCK;.
2bcc0 7d 0a 20 20 20 20 20 20 0a 20 20 20 20 20 20 69 }. . i
2bcd0 66 28 20 6e 54 72 69 65 73 3d 3d 31 20 29 7b 0a f( nTries==1 ){.
2bce0 20 20 20 20 20 20 20 20 63 6f 6e 63 68 4d 6f 64 conchMod
2bcf0 54 69 6d 65 20 3d 20 62 75 66 2e 73 74 5f 6d 74 Time = buf.st_mt
2bd00 69 6d 65 73 70 65 63 3b 0a 20 20 20 20 20 20 20 imespec;.
2bd10 20 75 73 6c 65 65 70 28 35 30 30 30 30 30 29 3b usleep(500000);
2bd20 20 2f 2a 20 77 61 69 74 20 30 2e 35 20 73 65 63 /* wait 0.5 sec
2bd30 20 61 6e 64 20 74 72 79 20 74 68 65 20 6c 6f 63 and try the loc
2bd40 6b 20 61 67 61 69 6e 2a 2f 0a 20 20 20 20 20 20 k again*/.
2bd50 20 20 63 6f 6e 74 69 6e 75 65 3b 20 20 0a 20 20 continue; .
2bd60 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 61 73 73 }.. ass
2bd70 65 72 74 28 20 6e 54 72 69 65 73 3e 31 20 29 3b ert( nTries>1 );
2bd80 0a 20 20 20 20 20 20 69 66 28 20 63 6f 6e 63 68 . if( conch
2bd90 4d 6f 64 54 69 6d 65 2e 74 76 5f 73 65 63 20 21 ModTime.tv_sec !
2bda0 3d 20 62 75 66 2e 73 74 5f 6d 74 69 6d 65 73 70 = buf.st_mtimesp
2bdb0 65 63 2e 74 76 5f 73 65 63 20 7c 7c 20 0a 20 20 ec.tv_sec || .
2bdc0 20 20 20 20 20 20 20 63 6f 6e 63 68 4d 6f 64 54 conchModT
2bdd0 69 6d 65 2e 74 76 5f 6e 73 65 63 20 21 3d 20 62 ime.tv_nsec != b
2bde0 75 66 2e 73 74 5f 6d 74 69 6d 65 73 70 65 63 2e uf.st_mtimespec.
2bdf0 74 76 5f 6e 73 65 63 20 29 7b 0a 20 20 20 20 20 tv_nsec ){.
2be00 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2be10 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 7d 0a 20 _BUSY;. }.
2be20 20 20 20 20 20 0a 20 20 20 20 20 20 69 66 28 20 . if(
2be30 6e 54 72 69 65 73 3d 3d 32 20 29 7b 20 20 0a 20 nTries==2 ){ .
2be40 20 20 20 20 20 20 20 63 68 61 72 20 74 42 75 66 char tBuf
2be50 5b 50 52 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c [PROXY_MAXCONCHL
2be60 45 4e 5d 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 EN];. int
2be70 20 6c 65 6e 20 3d 20 70 72 65 61 64 28 63 6f 6e len = pread(con
2be80 63 68 46 69 6c 65 2d 3e 68 2c 20 74 42 75 66 2c chFile->h, tBuf,
2be90 20 50 52 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c PROXY_MAXCONCHL
2bea0 45 4e 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 EN, 0);.
2beb0 69 66 28 20 6c 65 6e 3c 30 20 29 7b 0a 20 20 20 if( len<0 ){.
2bec0 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 pFile->la
2bed0 73 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b stErrno = errno;
2bee0 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
2bef0 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c n SQLITE_IOERR_L
2bf00 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 OCK;. }.
2bf10 20 20 20 20 20 20 20 69 66 28 20 6c 65 6e 3e 50 if( len>P
2bf20 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 20 26 ROXY_PATHINDEX &
2bf30 26 20 74 42 75 66 5b 30 5d 3d 3d 28 63 68 61 72 & tBuf[0]==(char
2bf40 29 50 52 4f 58 59 5f 43 4f 4e 43 48 56 45 52 53 )PROXY_CONCHVERS
2bf50 49 4f 4e 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ION){.
2bf60 2f 2a 20 64 6f 6e 27 74 20 62 72 65 61 6b 20 74 /* don't break t
2bf70 68 65 20 6c 6f 63 6b 20 69 66 20 74 68 65 20 68 he lock if the h
2bf80 6f 73 74 20 69 64 20 64 6f 65 73 6e 27 74 20 6d ost id doesn't m
2bf90 61 74 63 68 20 2a 2f 0a 20 20 20 20 20 20 20 20 atch */.
2bfa0 20 20 69 66 28 20 30 21 3d 6d 65 6d 63 6d 70 28 if( 0!=memcmp(
2bfb0 26 74 42 75 66 5b 50 52 4f 58 59 5f 48 45 41 44 &tBuf[PROXY_HEAD
2bfc0 45 52 4c 45 4e 5d 2c 20 6d 79 48 6f 73 74 49 44 ERLEN], myHostID
2bfd0 2c 20 50 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 , PROXY_HOSTIDLE
2bfe0 4e 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 N) ){.
2bff0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2c000 42 55 53 59 3b 0a 20 20 20 20 20 20 20 20 20 20 BUSY;.
2c010 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }. }else{
2c020 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 64 6f . /* do
2c030 6e 27 74 20 62 72 65 61 6b 20 74 68 65 20 6c 6f n't break the lo
2c040 63 6b 20 6f 6e 20 73 68 6f 72 74 20 72 65 61 64 ck on short read
2c050 20 6f 72 20 61 20 76 65 72 73 69 6f 6e 20 6d 69 or a version mi
2c060 73 6d 61 74 63 68 20 2a 2f 0a 20 20 20 20 20 20 smatch */.
2c070 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2c080 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 20 20 E_BUSY;.
2c090 7d 0a 20 20 20 20 20 20 20 20 75 73 6c 65 65 70 }. usleep
2c0a0 28 31 30 30 30 30 30 30 30 29 3b 20 2f 2a 20 77 (10000000); /* w
2c0b0 61 69 74 20 31 30 20 73 65 63 20 61 6e 64 20 74 ait 10 sec and t
2c0c0 72 79 20 74 68 65 20 6c 6f 63 6b 20 61 67 61 69 ry the lock agai
2c0d0 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 63 6f 6e n */. con
2c0e0 74 69 6e 75 65 3b 20 0a 20 20 20 20 20 20 7d 0a tinue; . }.
2c0f0 20 20 20 20 20 20 0a 20 20 20 20 20 20 61 73 73 . ass
2c100 65 72 74 28 20 6e 54 72 69 65 73 3d 3d 33 20 29 ert( nTries==3 )
2c110 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 70 ;. if( 0==p
2c120 72 6f 78 79 42 72 65 61 6b 43 6f 6e 63 68 4c 6f roxyBreakConchLo
2c130 63 6b 28 70 46 69 6c 65 2c 20 6d 79 48 6f 73 74 ck(pFile, myHost
2c140 49 44 29 20 29 7b 0a 20 20 20 20 20 20 20 20 72 ID) ){. r
2c150 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
2c160 20 20 20 20 20 20 20 69 66 28 20 6c 6f 63 6b 54 if( lockT
2c170 79 70 65 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ype==EXCLUSIVE_L
2c180 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 OCK ){.
2c190 20 72 63 20 3d 20 63 6f 6e 63 68 46 69 6c 65 2d rc = conchFile-
2c1a0 3e 70 4d 65 74 68 6f 64 2d 3e 78 4c 6f 63 6b 28 >pMethod->xLock(
2c1b0 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 (sqlite3_file*)c
2c1c0 6f 6e 63 68 46 69 6c 65 2c 20 53 48 41 52 45 44 onchFile, SHARED
2c1d0 5f 4c 4f 43 4b 29 3b 20 20 20 20 20 20 20 20 20 _LOCK);
2c1e0 20 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 . }.
2c1f0 20 20 20 20 69 66 28 20 21 72 63 20 29 7b 0a 20 if( !rc ){.
2c200 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 63 6f rc = co
2c210 6e 63 68 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 nchFile->pMethod
2c220 2d 3e 78 4c 6f 63 6b 28 28 73 71 6c 69 74 65 33 ->xLock((sqlite3
2c230 5f 66 69 6c 65 2a 29 63 6f 6e 63 68 46 69 6c 65 _file*)conchFile
2c240 2c 20 6c 6f 63 6b 54 79 70 65 29 3b 0a 20 20 20 , lockType);.
2c250 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
2c260 20 20 20 7d 0a 20 20 7d 20 77 68 69 6c 65 28 20 }. } while(
2c270 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 rc==SQLITE_BUSY
2c280 26 26 20 6e 54 72 69 65 73 3c 33 20 29 3b 0a 20 && nTries<3 );.
2c290 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d . return rc;.}
2c2a0 0a 0a 2f 2a 20 54 61 6b 65 73 20 74 68 65 20 63 ../* Takes the c
2c2b0 6f 6e 63 68 20 62 79 20 74 61 6b 69 6e 67 20 61 onch by taking a
2c2c0 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 61 6e 64 shared lock and
2c2d0 20 72 65 61 64 20 74 68 65 20 63 6f 6e 74 65 6e read the conten
2c2e0 74 73 20 63 6f 6e 63 68 2c 20 69 66 20 0a 2a 2a ts conch, if .**
2c2f0 20 6c 6f 63 6b 50 61 74 68 20 69 73 20 6e 6f 6e lockPath is non
2c300 2d 4e 55 4c 4c 2c 20 74 68 65 20 68 6f 73 74 20 -NULL, the host
2c310 49 44 20 61 6e 64 20 6c 6f 63 6b 20 66 69 6c 65 ID and lock file
2c320 20 70 61 74 68 20 6d 75 73 74 20 6d 61 74 63 68 path must match
2c330 2e 20 20 41 20 4e 55 4c 4c 20 0a 2a 2a 20 6c 6f . A NULL .** lo
2c340 63 6b 50 61 74 68 20 6d 65 61 6e 73 20 74 68 61 ckPath means tha
2c350 74 20 74 68 65 20 6c 6f 63 6b 50 61 74 68 20 69 t the lockPath i
2c360 6e 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 n the conch file
2c370 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 69 66 will be used if
2c380 20 74 68 65 20 0a 2a 2a 20 68 6f 73 74 20 49 44 the .** host ID
2c390 73 20 6d 61 74 63 68 2c 20 6f 72 20 61 20 6e 65 s match, or a ne
2c3a0 77 20 6c 6f 63 6b 20 70 61 74 68 20 77 69 6c 6c w lock path will
2c3b0 20 62 65 20 67 65 6e 65 72 61 74 65 64 20 61 75 be generated au
2c3c0 74 6f 6d 61 74 69 63 61 6c 6c 79 20 0a 2a 2a 20 tomatically .**
2c3d0 61 6e 64 20 77 72 69 74 74 65 6e 20 74 6f 20 74 and written to t
2c3e0 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 2e 0a 2a he conch file..*
2c3f0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f /.static int pro
2c400 78 79 54 61 6b 65 43 6f 6e 63 68 28 75 6e 69 78 xyTakeConch(unix
2c410 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 File *pFile){.
2c420 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 proxyLockingCont
2c430 65 78 74 20 2a 70 43 74 78 20 3d 20 28 70 72 6f ext *pCtx = (pro
2c440 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 xyLockingContext
2c450 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e *)pFile->lockin
2c460 67 43 6f 6e 74 65 78 74 3b 20 0a 20 20 0a 20 20 gContext; . .
2c470 69 66 28 20 70 43 74 78 2d 3e 63 6f 6e 63 68 48 if( pCtx->conchH
2c480 65 6c 64 21 3d 30 20 29 7b 0a 20 20 20 20 72 65 eld!=0 ){. re
2c490 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2c4a0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 75 6e 69 }else{. uni
2c4b0 78 46 69 6c 65 20 2a 63 6f 6e 63 68 46 69 6c 65 xFile *conchFile
2c4c0 20 3d 20 70 43 74 78 2d 3e 63 6f 6e 63 68 46 69 = pCtx->conchFi
2c4d0 6c 65 3b 0a 20 20 20 20 75 75 69 64 5f 74 20 6d le;. uuid_t m
2c4e0 79 48 6f 73 74 49 44 3b 0a 20 20 20 20 69 6e 74 yHostID;. int
2c4f0 20 70 45 72 72 6f 72 20 3d 20 30 3b 0a 20 20 20 pError = 0;.
2c500 20 63 68 61 72 20 72 65 61 64 42 75 66 5b 50 52 char readBuf[PR
2c510 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e 5d OXY_MAXCONCHLEN]
2c520 3b 0a 20 20 20 20 63 68 61 72 20 6c 6f 63 6b 50 ;. char lockP
2c530 61 74 68 5b 4d 41 58 50 41 54 48 4c 45 4e 5d 3b ath[MAXPATHLEN];
2c540 0a 20 20 20 20 63 68 61 72 20 2a 74 65 6d 70 4c . char *tempL
2c550 6f 63 6b 50 61 74 68 20 3d 20 4e 55 4c 4c 3b 0a ockPath = NULL;.
2c560 20 20 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c int rc = SQL
2c570 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 69 6e 74 20 ITE_OK;. int
2c580 63 72 65 61 74 65 43 6f 6e 63 68 20 3d 20 30 3b createConch = 0;
2c590 0a 20 20 20 20 69 6e 74 20 68 6f 73 74 49 64 4d . int hostIdM
2c5a0 61 74 63 68 20 3d 20 30 3b 0a 20 20 20 20 69 6e atch = 0;. in
2c5b0 74 20 72 65 61 64 4c 65 6e 20 3d 20 30 3b 0a 20 t readLen = 0;.
2c5c0 20 20 20 69 6e 74 20 74 72 79 4f 6c 64 4c 6f 63 int tryOldLoc
2c5d0 6b 50 61 74 68 20 3d 20 30 3b 0a 20 20 20 20 69 kPath = 0;. i
2c5e0 6e 74 20 66 6f 72 63 65 4e 65 77 4c 6f 63 6b 50 nt forceNewLockP
2c5f0 61 74 68 20 3d 20 30 3b 0a 20 20 20 20 0a 20 20 ath = 0;. .
2c600 20 20 4f 53 54 52 41 43 45 28 28 22 54 41 4b 45 OSTRACE(("TAKE
2c610 43 4f 4e 43 48 20 20 25 64 20 66 6f 72 20 25 73 CONCH %d for %s
2c620 20 70 69 64 3d 25 64 5c 6e 22 2c 20 63 6f 6e 63 pid=%d\n", conc
2c630 68 46 69 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20 hFile->h,.
2c640 20 20 20 20 20 20 20 28 70 43 74 78 2d 3e 6c 6f (pCtx->lo
2c650 63 6b 50 72 6f 78 79 50 61 74 68 20 3f 20 70 43 ckProxyPath ? pC
2c660 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 74 tx->lockProxyPat
2c670 68 20 3a 20 22 3a 61 75 74 6f 3a 22 29 2c 20 67 h : ":auto:"), g
2c680 65 74 70 69 64 28 29 29 29 3b 0a 0a 20 20 20 20 etpid()));..
2c690 72 63 20 3d 20 70 72 6f 78 79 47 65 74 48 6f 73 rc = proxyGetHos
2c6a0 74 49 44 28 6d 79 48 6f 73 74 49 44 2c 20 26 70 tID(myHostID, &p
2c6b0 45 72 72 6f 72 29 3b 0a 20 20 20 20 69 66 28 20 Error);. if(
2c6c0 28 72 63 26 30 78 66 66 29 3d 3d 53 51 4c 49 54 (rc&0xff)==SQLIT
2c6d0 45 5f 49 4f 45 52 52 20 29 7b 0a 20 20 20 20 20 E_IOERR ){.
2c6e0 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e pFile->lastErrn
2c6f0 6f 20 3d 20 70 45 72 72 6f 72 3b 0a 20 20 20 20 o = pError;.
2c700 20 20 67 6f 74 6f 20 65 6e 64 5f 74 61 6b 65 63 goto end_takec
2c710 6f 6e 63 68 3b 0a 20 20 20 20 7d 0a 20 20 20 20 onch;. }.
2c720 72 63 20 3d 20 70 72 6f 78 79 43 6f 6e 63 68 4c rc = proxyConchL
2c730 6f 63 6b 28 70 46 69 6c 65 2c 20 6d 79 48 6f 73 ock(pFile, myHos
2c740 74 49 44 2c 20 53 48 41 52 45 44 5f 4c 4f 43 4b tID, SHARED_LOCK
2c750 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
2c760 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2c770 20 20 67 6f 74 6f 20 65 6e 64 5f 74 61 6b 65 63 goto end_takec
2c780 6f 6e 63 68 3b 0a 20 20 20 20 7d 0a 20 20 20 20 onch;. }.
2c790 2f 2a 20 72 65 61 64 20 74 68 65 20 65 78 69 73 /* read the exis
2c7a0 74 69 6e 67 20 63 6f 6e 63 68 20 66 69 6c 65 20 ting conch file
2c7b0 2a 2f 0a 20 20 20 20 72 65 61 64 4c 65 6e 20 3d */. readLen =
2c7c0 20 73 65 65 6b 41 6e 64 52 65 61 64 28 28 75 6e seekAndRead((un
2c7d0 69 78 46 69 6c 65 2a 29 63 6f 6e 63 68 46 69 6c ixFile*)conchFil
2c7e0 65 2c 20 30 2c 20 72 65 61 64 42 75 66 2c 20 50 e, 0, readBuf, P
2c7f0 52 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e ROXY_MAXCONCHLEN
2c800 29 3b 0a 20 20 20 20 69 66 28 20 72 65 61 64 4c );. if( readL
2c810 65 6e 3c 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a en<0 ){. /*
2c820 20 49 2f 4f 20 65 72 72 6f 72 3a 20 6c 61 73 74 I/O error: last
2c830 45 72 72 6e 6f 20 73 65 74 20 62 79 20 73 65 65 Errno set by see
2c840 6b 41 6e 64 52 65 61 64 20 2a 2f 0a 20 20 20 20 kAndRead */.
2c850 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 pFile->lastErr
2c860 6e 6f 20 3d 20 63 6f 6e 63 68 46 69 6c 65 2d 3e no = conchFile->
2c870 6c 61 73 74 45 72 72 6e 6f 3b 0a 20 20 20 20 20 lastErrno;.
2c880 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 rc = SQLITE_IOE
2c890 52 52 5f 52 45 41 44 3b 0a 20 20 20 20 20 20 67 RR_READ;. g
2c8a0 6f 74 6f 20 65 6e 64 5f 74 61 6b 65 63 6f 6e 63 oto end_takeconc
2c8b0 68 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 h;. }else if(
2c8c0 20 72 65 61 64 4c 65 6e 3c 3d 28 50 52 4f 58 59 readLen<=(PROXY
2c8d0 5f 48 45 41 44 45 52 4c 45 4e 2b 50 52 4f 58 59 _HEADERLEN+PROXY
2c8e0 5f 48 4f 53 54 49 44 4c 45 4e 29 20 7c 7c 20 0a _HOSTIDLEN) || .
2c8f0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 61 rea
2c900 64 42 75 66 5b 30 5d 21 3d 28 63 68 61 72 29 50 dBuf[0]!=(char)P
2c910 52 4f 58 59 5f 43 4f 4e 43 48 56 45 52 53 49 4f ROXY_CONCHVERSIO
2c920 4e 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 61 20 N ){. /* a
2c930 73 68 6f 72 74 20 72 65 61 64 20 6f 72 20 76 65 short read or ve
2c940 72 73 69 6f 6e 20 66 6f 72 6d 61 74 20 6d 69 73 rsion format mis
2c950 6d 61 74 63 68 20 6d 65 61 6e 73 20 77 65 20 6e match means we n
2c960 65 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 eed to create a
2c970 6e 65 77 20 0a 20 20 20 20 20 20 2a 2a 20 63 6f new . ** co
2c980 6e 63 68 20 66 69 6c 65 2e 20 0a 20 20 20 20 20 nch file. .
2c990 20 2a 2f 0a 20 20 20 20 20 20 63 72 65 61 74 65 */. create
2c9a0 43 6f 6e 63 68 20 3d 20 31 3b 0a 20 20 20 20 7d Conch = 1;. }
2c9b0 0a 20 20 20 20 2f 2a 20 69 66 20 74 68 65 20 68 . /* if the h
2c9c0 6f 73 74 20 69 64 20 6d 61 74 63 68 65 73 20 61 ost id matches a
2c9d0 6e 64 20 74 68 65 20 6c 6f 63 6b 20 70 61 74 68 nd the lock path
2c9e0 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 20 already exists
2c9f0 69 6e 20 74 68 65 20 63 6f 6e 63 68 0a 20 20 20 in the conch.
2ca00 20 2a 2a 20 77 65 27 6c 6c 20 74 72 79 20 74 6f ** we'll try to
2ca10 20 75 73 65 20 74 68 65 20 70 61 74 68 20 74 68 use the path th
2ca20 65 72 65 2c 20 69 66 20 77 65 20 63 61 6e 27 74 ere, if we can't
2ca30 20 6f 70 65 6e 20 74 68 61 74 20 70 61 74 68 2c open that path,
2ca40 20 77 65 27 6c 6c 20 0a 20 20 20 20 2a 2a 20 72 we'll . ** r
2ca50 65 74 72 79 20 77 69 74 68 20 61 20 6e 65 77 20 etry with a new
2ca60 61 75 74 6f 2d 67 65 6e 65 72 61 74 65 64 20 70 auto-generated p
2ca70 61 74 68 20 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ath . */.
2ca80 64 6f 20 7b 20 2f 2a 20 69 6e 20 63 61 73 65 20 do { /* in case
2ca90 77 65 20 6e 65 65 64 20 74 6f 20 74 72 79 20 61 we need to try a
2caa0 67 61 69 6e 20 66 6f 72 20 61 6e 20 3a 61 75 74 gain for an :aut
2cab0 6f 3a 20 6e 61 6d 65 64 20 6c 6f 63 6b 20 66 69 o: named lock fi
2cac0 6c 65 20 2a 2f 0a 0a 20 20 20 20 20 20 69 66 28 le */.. if(
2cad0 20 21 63 72 65 61 74 65 43 6f 6e 63 68 20 26 26 !createConch &&
2cae0 20 21 66 6f 72 63 65 4e 65 77 4c 6f 63 6b 50 61 !forceNewLockPa
2caf0 74 68 20 29 7b 0a 20 20 20 20 20 20 20 20 68 6f th ){. ho
2cb00 73 74 49 64 4d 61 74 63 68 20 3d 20 21 6d 65 6d stIdMatch = !mem
2cb10 63 6d 70 28 26 72 65 61 64 42 75 66 5b 50 52 4f cmp(&readBuf[PRO
2cb20 58 59 5f 48 45 41 44 45 52 4c 45 4e 5d 2c 20 6d XY_HEADERLEN], m
2cb30 79 48 6f 73 74 49 44 2c 20 0a 20 20 20 20 20 20 yHostID, .
2cb40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2cb50 20 20 20 20 20 20 20 20 20 20 20 20 50 52 4f 58 PROX
2cb60 59 5f 48 4f 53 54 49 44 4c 45 4e 29 3b 0a 20 20 Y_HOSTIDLEN);.
2cb70 20 20 20 20 20 20 2f 2a 20 69 66 20 74 68 65 20 /* if the
2cb80 63 6f 6e 63 68 20 68 61 73 20 64 61 74 61 20 63 conch has data c
2cb90 6f 6d 70 61 72 65 20 74 68 65 20 63 6f 6e 74 65 ompare the conte
2cba0 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 nts */. i
2cbb0 66 28 20 21 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 f( !pCtx->lockPr
2cbc0 6f 78 79 50 61 74 68 20 29 7b 0a 20 20 20 20 20 oxyPath ){.
2cbd0 20 20 20 20 20 2f 2a 20 66 6f 72 20 61 75 74 6f /* for auto
2cbe0 2d 6e 61 6d 65 64 20 6c 6f 63 61 6c 20 6c 6f 63 -named local loc
2cbf0 6b 20 66 69 6c 65 2c 20 6a 75 73 74 20 63 68 65 k file, just che
2cc00 63 6b 20 74 68 65 20 68 6f 73 74 20 49 44 20 61 ck the host ID a
2cc10 6e 64 20 77 65 27 6c 6c 0a 20 20 20 20 20 20 20 nd we'll.
2cc20 20 20 20 20 2a 2a 20 75 73 65 20 74 68 65 20 6c ** use the l
2cc30 6f 63 61 6c 20 6c 6f 63 6b 20 66 69 6c 65 20 70 ocal lock file p
2cc40 61 74 68 20 74 68 61 74 27 73 20 61 6c 72 65 61 ath that's alrea
2cc50 64 79 20 69 6e 20 74 68 65 72 65 0a 20 20 20 20 dy in there.
2cc60 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
2cc70 20 20 20 20 69 66 28 20 68 6f 73 74 49 64 4d 61 if( hostIdMa
2cc80 74 63 68 20 29 7b 0a 20 20 20 20 20 20 20 20 20 tch ){.
2cc90 20 20 20 73 69 7a 65 5f 74 20 70 61 74 68 4c 65 size_t pathLe
2cca0 6e 20 3d 20 28 72 65 61 64 4c 65 6e 20 2d 20 50 n = (readLen - P
2ccb0 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 29 3b ROXY_PATHINDEX);
2ccc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 . .
2ccd0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 61 if( pa
2cce0 74 68 4c 65 6e 3e 3d 4d 41 58 50 41 54 48 4c 45 thLen>=MAXPATHLE
2ccf0 4e 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 N ){.
2cd00 20 20 20 70 61 74 68 4c 65 6e 3d 4d 41 58 50 41 pathLen=MAXPA
2cd10 54 48 4c 45 4e 2d 31 3b 0a 20 20 20 20 20 20 20 THLEN-1;.
2cd20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2cd30 20 20 20 6d 65 6d 63 70 79 28 6c 6f 63 6b 50 61 memcpy(lockPa
2cd40 74 68 2c 20 26 72 65 61 64 42 75 66 5b 50 52 4f th, &readBuf[PRO
2cd50 58 59 5f 50 41 54 48 49 4e 44 45 58 5d 2c 20 70 XY_PATHINDEX], p
2cd60 61 74 68 4c 65 6e 29 3b 0a 20 20 20 20 20 20 20 athLen);.
2cd70 20 20 20 20 20 6c 6f 63 6b 50 61 74 68 5b 70 61 lockPath[pa
2cd80 74 68 4c 65 6e 5d 20 3d 20 30 3b 0a 20 20 20 20 thLen] = 0;.
2cd90 20 20 20 20 20 20 20 20 74 65 6d 70 4c 6f 63 6b tempLock
2cda0 50 61 74 68 20 3d 20 6c 6f 63 6b 50 61 74 68 3b Path = lockPath;
2cdb0 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72 79 . try
2cdc0 4f 6c 64 4c 6f 63 6b 50 61 74 68 20 3d 20 31 3b OldLockPath = 1;
2cdd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 . /*
2cde0 63 72 65 61 74 65 20 61 20 63 6f 70 79 20 6f 66 create a copy of
2cdf0 20 74 68 65 20 6c 6f 63 6b 20 70 61 74 68 20 69 the lock path i
2ce00 66 20 74 68 65 20 63 6f 6e 63 68 20 69 73 20 74 f the conch is t
2ce10 61 6b 65 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 aken */.
2ce20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 74 61 6b goto end_tak
2ce30 65 63 6f 6e 63 68 3b 0a 20 20 20 20 20 20 20 20 econch;.
2ce40 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
2ce50 65 20 69 66 28 20 68 6f 73 74 49 64 4d 61 74 63 e if( hostIdMatc
2ce60 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h.
2ce70 20 26 26 20 21 73 74 72 6e 63 6d 70 28 70 43 74 && !strncmp(pCt
2ce80 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 74 68 x->lockProxyPath
2ce90 2c 20 26 72 65 61 64 42 75 66 5b 50 52 4f 58 59 , &readBuf[PROXY
2cea0 5f 50 41 54 48 49 4e 44 45 58 5d 2c 0a 20 20 20 _PATHINDEX],.
2ceb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2cec0 20 20 20 20 20 20 20 20 72 65 61 64 4c 65 6e 2d readLen-
2ced0 50 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 29 PROXY_PATHINDEX)
2cee0 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 . ){.
2cef0 20 20 20 20 20 20 2f 2a 20 63 6f 6e 63 68 20 68 /* conch h
2cf00 6f 73 74 20 61 6e 64 20 6c 6f 63 6b 20 70 61 74 ost and lock pat
2cf10 68 20 6d 61 74 63 68 20 2a 2f 0a 20 20 20 20 20 h match */.
2cf20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 74 61 goto end_ta
2cf30 6b 65 63 6f 6e 63 68 3b 20 0a 20 20 20 20 20 20 keconch; .
2cf40 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
2cf50 20 20 0a 20 20 20 20 20 20 2f 2a 20 69 66 20 74 . /* if t
2cf60 68 65 20 63 6f 6e 63 68 20 69 73 6e 27 74 20 77 he conch isn't w
2cf70 72 69 74 61 62 6c 65 20 61 6e 64 20 64 6f 65 73 ritable and does
2cf80 6e 27 74 20 6d 61 74 63 68 2c 20 77 65 20 63 61 n't match, we ca
2cf90 6e 27 74 20 74 61 6b 65 20 69 74 20 2a 2f 0a 20 n't take it */.
2cfa0 20 20 20 20 20 69 66 28 20 28 63 6f 6e 63 68 46 if( (conchF
2cfb0 69 6c 65 2d 3e 6f 70 65 6e 46 6c 61 67 73 26 4f ile->openFlags&O
2cfc0 5f 52 44 57 52 29 20 3d 3d 20 30 20 29 7b 0a 20 _RDWR) == 0 ){.
2cfd0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
2cfe0 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 20 TE_BUSY;.
2cff0 20 67 6f 74 6f 20 65 6e 64 5f 74 61 6b 65 63 6f goto end_takeco
2d000 6e 63 68 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 nch;. }.
2d010 20 20 20 0a 20 20 20 20 20 20 2f 2a 20 65 69 74 . /* eit
2d020 68 65 72 20 74 68 65 20 63 6f 6e 63 68 20 64 69 her the conch di
2d030 64 6e 27 74 20 6d 61 74 63 68 20 6f 72 20 77 65 dn't match or we
2d040 20 6e 65 65 64 20 74 6f 20 63 72 65 61 74 65 20 need to create
2d050 61 20 6e 65 77 20 6f 6e 65 20 2a 2f 0a 20 20 20 a new one */.
2d060 20 20 20 69 66 28 20 21 70 43 74 78 2d 3e 6c 6f if( !pCtx->lo
2d070 63 6b 50 72 6f 78 79 50 61 74 68 20 29 7b 0a 20 ckProxyPath ){.
2d080 20 20 20 20 20 20 20 70 72 6f 78 79 47 65 74 4c proxyGetL
2d090 6f 63 6b 50 61 74 68 28 70 43 74 78 2d 3e 64 62 ockPath(pCtx->db
2d0a0 50 61 74 68 2c 20 6c 6f 63 6b 50 61 74 68 2c 20 Path, lockPath,
2d0b0 4d 41 58 50 41 54 48 4c 45 4e 29 3b 0a 20 20 20 MAXPATHLEN);.
2d0c0 20 20 20 20 20 74 65 6d 70 4c 6f 63 6b 50 61 74 tempLockPat
2d0d0 68 20 3d 20 6c 6f 63 6b 50 61 74 68 3b 0a 20 20 h = lockPath;.
2d0e0 20 20 20 20 20 20 2f 2a 20 63 72 65 61 74 65 20 /* create
2d0f0 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 6c 6f a copy of the lo
2d100 63 6b 20 70 61 74 68 20 5f 6f 6e 6c 79 5f 20 69 ck path _only_ i
2d110 66 20 74 68 65 20 63 6f 6e 63 68 20 69 73 20 74 f the conch is t
2d120 61 6b 65 6e 20 2a 2f 0a 20 20 20 20 20 20 7d 0a aken */. }.
2d130 20 20 20 20 20 20 0a 20 20 20 20 20 20 2f 2a 20 . /*
2d140 75 70 64 61 74 65 20 63 6f 6e 63 68 20 77 69 74 update conch wit
2d150 68 20 68 6f 73 74 20 61 6e 64 20 70 61 74 68 20 h host and path
2d160 28 74 68 69 73 20 77 69 6c 6c 20 66 61 69 6c 20 (this will fail
2d170 69 66 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 if other process
2d180 0a 20 20 20 20 20 20 2a 2a 20 68 61 73 20 61 20 . ** has a
2d190 73 68 61 72 65 64 20 6c 6f 63 6b 20 61 6c 72 65 shared lock alre
2d1a0 61 64 79 29 2c 20 69 66 20 74 68 65 20 68 6f 73 ady), if the hos
2d1b0 74 20 69 64 20 6d 61 74 63 68 65 73 2c 20 75 73 t id matches, us
2d1c0 65 20 74 68 65 20 62 69 67 0a 20 20 20 20 20 20 e the big.
2d1d0 2a 2a 20 73 74 69 63 6b 2e 0a 20 20 20 20 20 20 ** stick..
2d1e0 2a 2f 0a 20 20 20 20 20 20 66 75 74 69 6d 65 73 */. futimes
2d1f0 28 63 6f 6e 63 68 46 69 6c 65 2d 3e 68 2c 20 4e (conchFile->h, N
2d200 55 4c 4c 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ULL);. if(
2d210 68 6f 73 74 49 64 4d 61 74 63 68 20 26 26 20 21 hostIdMatch && !
2d220 63 72 65 61 74 65 43 6f 6e 63 68 20 29 7b 0a 20 createConch ){.
2d230 20 20 20 20 20 20 20 69 66 28 20 63 6f 6e 63 68 if( conch
2d240 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 20 26 26 20 File->pInode &&
2d250 63 6f 6e 63 68 46 69 6c 65 2d 3e 70 49 6e 6f 64 conchFile->pInod
2d260 65 2d 3e 6e 53 68 61 72 65 64 3e 31 20 29 7b 0a e->nShared>1 ){.
2d270 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 65 20 /* We
2d280 61 72 65 20 74 72 79 69 6e 67 20 66 6f 72 20 61 are trying for a
2d290 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b n exclusive lock
2d2a0 20 62 75 74 20 61 6e 6f 74 68 65 72 20 74 68 72 but another thr
2d2b0 65 61 64 20 69 6e 20 74 68 69 73 0a 20 20 20 20 ead in this.
2d2c0 20 20 20 20 20 20 20 2a 2a 20 73 61 6d 65 20 70 ** same p
2d2d0 72 6f 63 65 73 73 20 69 73 20 73 74 69 6c 6c 20 rocess is still
2d2e0 68 6f 6c 64 69 6e 67 20 61 20 73 68 61 72 65 64 holding a shared
2d2f0 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 20 20 20 20 lock. */.
2d300 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2d310 42 55 53 59 3b 0a 20 20 20 20 20 20 20 20 7d 20 BUSY;. }
2d320 65 6c 73 65 20 7b 20 20 20 20 20 20 20 20 20 20 else {
2d330 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
2d340 70 72 6f 78 79 43 6f 6e 63 68 4c 6f 63 6b 28 70 proxyConchLock(p
2d350 46 69 6c 65 2c 20 6d 79 48 6f 73 74 49 44 2c 20 File, myHostID,
2d360 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b EXCLUSIVE_LOCK);
2d370 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2d380 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
2d390 72 63 20 3d 20 63 6f 6e 63 68 46 69 6c 65 2d 3e rc = conchFile->
2d3a0 70 4d 65 74 68 6f 64 2d 3e 78 4c 6f 63 6b 28 28 pMethod->xLock((
2d3b0 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 6f sqlite3_file*)co
2d3c0 6e 63 68 46 69 6c 65 2c 20 45 58 43 4c 55 53 49 nchFile, EXCLUSI
2d3d0 56 45 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 VE_LOCK);.
2d3e0 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d }. if( rc==
2d3f0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2d400 20 20 20 20 20 63 68 61 72 20 77 72 69 74 65 42 char writeB
2d410 75 66 66 65 72 5b 50 52 4f 58 59 5f 4d 41 58 43 uffer[PROXY_MAXC
2d420 4f 4e 43 48 4c 45 4e 5d 3b 0a 20 20 20 20 20 20 ONCHLEN];.
2d430 20 20 69 6e 74 20 77 72 69 74 65 53 69 7a 65 20 int writeSize
2d440 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 0a 20 20 = 0;. .
2d450 20 20 20 20 20 20 77 72 69 74 65 42 75 66 66 65 writeBuffe
2d460 72 5b 30 5d 20 3d 20 28 63 68 61 72 29 50 52 4f r[0] = (char)PRO
2d470 58 59 5f 43 4f 4e 43 48 56 45 52 53 49 4f 4e 3b XY_CONCHVERSION;
2d480 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
2d490 26 77 72 69 74 65 42 75 66 66 65 72 5b 50 52 4f &writeBuffer[PRO
2d4a0 58 59 5f 48 45 41 44 45 52 4c 45 4e 5d 2c 20 6d XY_HEADERLEN], m
2d4b0 79 48 6f 73 74 49 44 2c 20 50 52 4f 58 59 5f 48 yHostID, PROXY_H
2d4c0 4f 53 54 49 44 4c 45 4e 29 3b 0a 20 20 20 20 20 OSTIDLEN);.
2d4d0 20 20 20 69 66 28 20 70 43 74 78 2d 3e 6c 6f 63 if( pCtx->loc
2d4e0 6b 50 72 6f 78 79 50 61 74 68 21 3d 4e 55 4c 4c kProxyPath!=NULL
2d4f0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 ){. st
2d500 72 6c 63 70 79 28 26 77 72 69 74 65 42 75 66 66 rlcpy(&writeBuff
2d510 65 72 5b 50 52 4f 58 59 5f 50 41 54 48 49 4e 44 er[PROXY_PATHIND
2d520 45 58 5d 2c 20 70 43 74 78 2d 3e 6c 6f 63 6b 50 EX], pCtx->lockP
2d530 72 6f 78 79 50 61 74 68 2c 20 4d 41 58 50 41 54 roxyPath, MAXPAT
2d540 48 4c 45 4e 29 3b 0a 20 20 20 20 20 20 20 20 7d HLEN);. }
2d550 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
2d560 73 74 72 6c 63 70 79 28 26 77 72 69 74 65 42 75 strlcpy(&writeBu
2d570 66 66 65 72 5b 50 52 4f 58 59 5f 50 41 54 48 49 ffer[PROXY_PATHI
2d580 4e 44 45 58 5d 2c 20 74 65 6d 70 4c 6f 63 6b 50 NDEX], tempLockP
2d590 61 74 68 2c 20 4d 41 58 50 41 54 48 4c 45 4e 29 ath, MAXPATHLEN)
2d5a0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
2d5b0 20 20 20 20 77 72 69 74 65 53 69 7a 65 20 3d 20 writeSize =
2d5c0 50 52 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 20 PROXY_PATHINDEX
2d5d0 2b 20 73 74 72 6c 65 6e 28 26 77 72 69 74 65 42 + strlen(&writeB
2d5e0 75 66 66 65 72 5b 50 52 4f 58 59 5f 50 41 54 48 uffer[PROXY_PATH
2d5f0 49 4e 44 45 58 5d 29 3b 0a 20 20 20 20 20 20 20 INDEX]);.
2d600 20 66 74 72 75 6e 63 61 74 65 28 63 6f 6e 63 68 ftruncate(conch
2d610 46 69 6c 65 2d 3e 68 2c 20 77 72 69 74 65 53 69 File->h, writeSi
2d620 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 ze);. rc
2d630 3d 20 75 6e 69 78 57 72 69 74 65 28 28 73 71 6c = unixWrite((sql
2d640 69 74 65 33 5f 66 69 6c 65 20 2a 29 63 6f 6e 63 ite3_file *)conc
2d650 68 46 69 6c 65 2c 20 77 72 69 74 65 42 75 66 66 hFile, writeBuff
2d660 65 72 2c 20 77 72 69 74 65 53 69 7a 65 2c 20 30 er, writeSize, 0
2d670 29 3b 0a 20 20 20 20 20 20 20 20 66 73 79 6e 63 );. fsync
2d680 28 63 6f 6e 63 68 46 69 6c 65 2d 3e 68 29 3b 0a (conchFile->h);.
2d690 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 77 65 /* If we
2d6a0 20 63 72 65 61 74 65 64 20 61 20 6e 65 77 20 63 created a new c
2d6b0 6f 6e 63 68 20 66 69 6c 65 20 28 6e 6f 74 20 6a onch file (not j
2d6c0 75 73 74 20 75 70 64 61 74 65 64 20 74 68 65 20 ust updated the
2d6d0 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 0a 20 contents of a .
2d6e0 20 20 20 20 20 20 20 20 2a 2a 20 76 61 6c 69 64 ** valid
2d6f0 20 63 6f 6e 63 68 20 66 69 6c 65 29 2c 20 74 72 conch file), tr
2d700 79 20 74 6f 20 6d 61 74 63 68 20 74 68 65 20 70 y to match the p
2d710 65 72 6d 69 73 73 69 6f 6e 73 20 6f 66 20 74 68 ermissions of th
2d720 65 20 64 61 74 61 62 61 73 65 20 0a 20 20 20 20 e database .
2d730 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
2d740 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2d750 4b 20 26 26 20 63 72 65 61 74 65 43 6f 6e 63 68 K && createConch
2d760 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 ){. st
2d770 72 75 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 ruct stat buf;.
2d780 20 20 20 20 20 20 20 20 20 69 6e 74 20 65 72 72 int err
2d790 20 3d 20 66 73 74 61 74 28 70 46 69 6c 65 2d 3e = fstat(pFile->
2d7a0 68 2c 20 26 62 75 66 29 3b 0a 20 20 20 20 20 20 h, &buf);.
2d7b0 20 20 20 20 69 66 28 20 65 72 72 3d 3d 30 20 29 if( err==0 )
2d7c0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f {. mo
2d7d0 64 65 5f 74 20 63 6d 6f 64 65 20 3d 20 62 75 66 de_t cmode = buf
2d7e0 2e 73 74 5f 6d 6f 64 65 26 28 53 5f 49 52 55 53 .st_mode&(S_IRUS
2d7f0 52 7c 53 5f 49 57 55 53 52 20 7c 20 53 5f 49 52 R|S_IWUSR | S_IR
2d800 47 52 50 7c 53 5f 49 57 47 52 50 20 7c 0a 20 20 GRP|S_IWGRP |.
2d810 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d830 20 20 20 20 20 20 53 5f 49 52 4f 54 48 7c 53 5f S_IROTH|S_
2d840 49 57 4f 54 48 29 3b 0a 20 20 20 20 20 20 20 20 IWOTH);.
2d850 20 20 20 20 2f 2a 20 74 72 79 20 74 6f 20 6d 61 /* try to ma
2d860 74 63 68 20 74 68 65 20 64 61 74 61 62 61 73 65 tch the database
2d870 20 66 69 6c 65 20 52 2f 57 20 70 65 72 6d 69 73 file R/W permis
2d880 73 69 6f 6e 73 2c 20 69 67 6e 6f 72 65 20 66 61 sions, ignore fa
2d890 69 6c 75 72 65 20 2a 2f 0a 23 69 66 6e 64 65 66 ilure */.#ifndef
2d8a0 20 53 51 4c 49 54 45 5f 50 52 4f 58 59 5f 44 45 SQLITE_PROXY_DE
2d8b0 42 55 47 0a 20 20 20 20 20 20 20 20 20 20 20 20 BUG.
2d8c0 66 63 68 6d 6f 64 28 63 6f 6e 63 68 46 69 6c 65 fchmod(conchFile
2d8d0 2d 3e 68 2c 20 63 6d 6f 64 65 29 3b 0a 23 65 6c ->h, cmode);.#el
2d8e0 73 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 se. i
2d8f0 66 28 20 66 63 68 6d 6f 64 28 63 6f 6e 63 68 46 f( fchmod(conchF
2d900 69 6c 65 2d 3e 68 2c 20 63 6d 6f 64 65 29 21 3d ile->h, cmode)!=
2d910 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 0 ){.
2d920 20 20 20 69 6e 74 20 63 6f 64 65 20 3d 20 65 72 int code = er
2d930 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 20 rno;.
2d940 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65 72 fprintf(stder
2d950 72 2c 20 22 66 63 68 6d 6f 64 20 25 6f 20 46 41 r, "fchmod %o FA
2d960 49 4c 45 44 20 77 69 74 68 20 25 64 20 25 73 5c ILED with %d %s\
2d970 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 n",.
2d980 20 20 20 20 20 20 20 20 20 20 63 6d 6f 64 65 2c cmode,
2d990 20 63 6f 64 65 2c 20 73 74 72 65 72 72 6f 72 28 code, strerror(
2d9a0 63 6f 64 65 29 29 3b 0a 20 20 20 20 20 20 20 20 code));.
2d9b0 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 } else {.
2d9c0 20 20 20 20 20 20 20 20 20 20 20 66 70 72 69 6e fprin
2d9d0 74 66 28 73 74 64 65 72 72 2c 20 22 66 63 68 6d tf(stderr, "fchm
2d9e0 6f 64 20 25 6f 20 53 55 43 43 45 44 45 44 5c 6e od %o SUCCEDED\n
2d9f0 22 2c 63 6d 6f 64 65 29 3b 0a 20 20 20 20 20 20 ",cmode);.
2da00 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2da10 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2da20 20 20 20 20 20 69 6e 74 20 63 6f 64 65 20 3d 20 int code =
2da30 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 errno;.
2da40 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65 72 fprintf(stder
2da50 72 2c 20 22 53 54 41 54 20 46 41 49 4c 45 44 5b r, "STAT FAILED[
2da60 25 64 5d 20 77 69 74 68 20 25 64 20 25 73 5c 6e %d] with %d %s\n
2da70 22 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 ", .
2da80 20 20 20 20 20 20 20 20 65 72 72 2c 20 63 6f 64 err, cod
2da90 65 2c 20 73 74 72 65 72 72 6f 72 28 63 6f 64 65 e, strerror(code
2daa0 29 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 ));.#endif.
2dab0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
2dac0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 . }. c
2dad0 6f 6e 63 68 46 69 6c 65 2d 3e 70 4d 65 74 68 6f onchFile->pMetho
2dae0 64 2d 3e 78 55 6e 6c 6f 63 6b 28 28 73 71 6c 69 d->xUnlock((sqli
2daf0 74 65 33 5f 66 69 6c 65 2a 29 63 6f 6e 63 68 46 te3_file*)conchF
2db00 69 6c 65 2c 20 53 48 41 52 45 44 5f 4c 4f 43 4b ile, SHARED_LOCK
2db10 29 3b 0a 20 20 20 20 20 20 0a 20 20 20 20 65 6e );. . en
2db20 64 5f 74 61 6b 65 63 6f 6e 63 68 3a 0a 20 20 20 d_takeconch:.
2db30 20 20 20 4f 53 54 52 41 43 45 28 28 22 54 52 41 OSTRACE(("TRA
2db40 4e 53 50 52 4f 58 59 3a 20 43 4c 4f 53 45 20 20 NSPROXY: CLOSE
2db50 25 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 29 %d\n", pFile->h)
2db60 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
2db70 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 46 =SQLITE_OK && pF
2db80 69 6c 65 2d 3e 6f 70 65 6e 46 6c 61 67 73 20 29 ile->openFlags )
2db90 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 46 {. if( pF
2dba0 69 6c 65 2d 3e 68 3e 3d 30 20 29 7b 0a 23 69 66 ile->h>=0 ){.#if
2dbb0 64 65 66 20 53 54 52 49 43 54 5f 43 4c 4f 53 45 def STRICT_CLOSE
2dbc0 5f 45 52 52 4f 52 0a 20 20 20 20 20 20 20 20 20 _ERROR.
2dbd0 20 69 66 28 20 63 6c 6f 73 65 28 70 46 69 6c 65 if( close(pFile
2dbe0 2d 3e 68 29 20 29 7b 0a 20 20 20 20 20 20 20 20 ->h) ){.
2dbf0 20 20 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 pFile->lastE
2dc00 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 rrno = errno;.
2dc10 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
2dc20 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4c SQLITE_IOERR_CL
2dc30 4f 53 45 3b 0a 20 20 20 20 20 20 20 20 20 20 7d OSE;. }
2dc40 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 20 20 20 .#else.
2dc50 20 63 6c 6f 73 65 28 70 46 69 6c 65 2d 3e 68 29 close(pFile->h)
2dc60 3b 20 2f 2a 20 73 69 6c 65 6e 74 6c 79 20 6c 65 ; /* silently le
2dc70 61 6b 20 66 64 20 69 66 20 66 61 69 6c 20 2a 2f ak fd if fail */
2dc80 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 20 20 .#endif.
2dc90 7d 0a 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d }. pFile-
2dca0 3e 68 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 20 >h = -1;.
2dcb0 20 69 6e 74 20 66 64 20 3d 20 6f 70 65 6e 28 70 int fd = open(p
2dcc0 43 74 78 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 Ctx->dbPath, pFi
2dcd0 6c 65 2d 3e 6f 70 65 6e 46 6c 61 67 73 2c 0a 20 le->openFlags,.
2dce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2dcf0 20 20 20 20 20 53 51 4c 49 54 45 5f 44 45 46 41 SQLITE_DEFA
2dd00 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 ULT_FILE_PERMISS
2dd10 49 4f 4e 53 29 3b 0a 20 20 20 20 20 20 20 20 4f IONS);. O
2dd20 53 54 52 41 43 45 28 28 22 54 52 41 4e 53 50 52 STRACE(("TRANSPR
2dd30 4f 58 59 3a 20 4f 50 45 4e 20 20 25 64 5c 6e 22 OXY: OPEN %d\n"
2dd40 2c 20 66 64 29 29 3b 0a 20 20 20 20 20 20 20 20 , fd));.
2dd50 69 66 28 20 66 64 3e 3d 30 20 29 7b 0a 20 20 20 if( fd>=0 ){.
2dd60 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 68 20 pFile->h
2dd70 3d 20 66 64 3b 0a 20 20 20 20 20 20 20 20 7d 65 = fd;. }e
2dd80 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 72 lse{. r
2dd90 63 3d 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 c=SQLITE_CANTOPE
2dda0 4e 5f 42 4b 50 54 3b 20 2f 2a 20 53 51 4c 49 54 N_BKPT; /* SQLIT
2ddb0 45 5f 42 55 53 59 3f 20 70 72 6f 78 79 54 61 6b E_BUSY? proxyTak
2ddc0 65 43 6f 6e 63 68 20 63 61 6c 6c 65 64 0a 20 20 eConch called.
2ddd0 20 20 20 20 20 20 20 20 20 64 75 72 69 6e 67 20 during
2dde0 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 20 20 20 20 20 locking */.
2ddf0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
2de00 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
2de10 45 5f 4f 4b 20 26 26 20 21 70 43 74 78 2d 3e 6c E_OK && !pCtx->l
2de20 6f 63 6b 50 72 6f 78 79 20 29 7b 0a 20 20 20 20 ockProxy ){.
2de30 20 20 20 20 63 68 61 72 20 2a 70 61 74 68 20 3d char *path =
2de40 20 74 65 6d 70 4c 6f 63 6b 50 61 74 68 20 3f 20 tempLockPath ?
2de50 74 65 6d 70 4c 6f 63 6b 50 61 74 68 20 3a 20 70 tempLockPath : p
2de60 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 Ctx->lockProxyPa
2de70 74 68 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d th;. rc =
2de80 20 70 72 6f 78 79 43 72 65 61 74 65 55 6e 69 78 proxyCreateUnix
2de90 46 69 6c 65 28 70 61 74 68 2c 20 26 70 43 74 78 File(path, &pCtx
2dea0 2d 3e 6c 6f 63 6b 50 72 6f 78 79 2c 20 31 29 3b ->lockProxy, 1);
2deb0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 . if( rc!
2dec0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 =SQLITE_OK && rc
2ded0 21 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 26 !=SQLITE_NOMEM &
2dee0 26 20 74 72 79 4f 6c 64 4c 6f 63 6b 50 61 74 68 & tryOldLockPath
2def0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a ){. /*
2df00 20 77 65 20 63 6f 75 6c 64 6e 27 74 20 63 72 65 we couldn't cre
2df10 61 74 65 20 74 68 65 20 70 72 6f 78 79 20 6c 6f ate the proxy lo
2df20 63 6b 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 ck file with the
2df30 20 6f 6c 64 20 6c 6f 63 6b 20 66 69 6c 65 20 70 old lock file p
2df40 61 74 68 0a 20 20 20 20 20 20 20 20 20 20 20 2a ath. *
2df50 2a 20 73 6f 20 74 72 79 20 61 67 61 69 6e 20 76 * so try again v
2df60 69 61 20 61 75 74 6f 2d 6e 61 6d 69 6e 67 20 0a ia auto-naming .
2df70 20 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 */.
2df80 20 20 20 20 20 20 20 20 66 6f 72 63 65 4e 65 77 forceNew
2df90 4c 6f 63 6b 50 61 74 68 20 3d 20 31 3b 0a 20 20 LockPath = 1;.
2dfa0 20 20 20 20 20 20 20 20 74 72 79 4f 6c 64 4c 6f tryOldLo
2dfb0 63 6b 50 61 74 68 20 3d 20 30 3b 0a 20 20 20 20 ckPath = 0;.
2dfc0 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 20 continue;
2dfd0 2f 2a 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 68 /* go back to th
2dfe0 65 20 64 6f 20 7b 7d 20 77 68 69 6c 65 20 73 74 e do {} while st
2dff0 61 72 74 20 70 6f 69 6e 74 2c 20 74 72 79 20 61 art point, try a
2e000 67 61 69 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 gain */.
2e010 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
2e020 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2e030 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 K ){. /*
2e040 4e 65 65 64 20 74 6f 20 6d 61 6b 65 20 61 20 63 Need to make a c
2e050 6f 70 79 20 6f 66 20 70 61 74 68 20 69 66 20 77 opy of path if w
2e060 65 20 65 78 74 72 61 63 74 65 64 20 74 68 65 20 e extracted the
2e070 76 61 6c 75 65 0a 20 20 20 20 20 20 20 20 20 2a value. *
2e080 2a 20 66 72 6f 6d 20 74 68 65 20 63 6f 6e 63 68 * from the conch
2e090 20 66 69 6c 65 20 6f 72 20 74 68 65 20 70 61 74 file or the pat
2e0a0 68 20 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 h was allocated
2e0b0 6f 6e 20 74 68 65 20 73 74 61 63 6b 0a 20 20 20 on the stack.
2e0c0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
2e0d0 20 69 66 28 20 74 65 6d 70 4c 6f 63 6b 50 61 74 if( tempLockPat
2e0e0 68 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 h ){. p
2e0f0 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 Ctx->lockProxyPa
2e100 74 68 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 th = sqlite3DbSt
2e110 72 44 75 70 28 30 2c 20 74 65 6d 70 4c 6f 63 6b rDup(0, tempLock
2e120 50 61 74 68 29 3b 0a 20 20 20 20 20 20 20 20 20 Path);.
2e130 20 69 66 28 20 21 70 43 74 78 2d 3e 6c 6f 63 6b if( !pCtx->lock
2e140 50 72 6f 78 79 50 61 74 68 20 29 7b 0a 20 20 20 ProxyPath ){.
2e150 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
2e160 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
2e170 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2e180 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
2e190 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2e1a0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 74 K ){. pCt
2e1b0 78 2d 3e 63 6f 6e 63 68 48 65 6c 64 20 3d 20 31 x->conchHeld = 1
2e1c0 3b 0a 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 ;. .
2e1d0 20 20 20 69 66 28 20 70 43 74 78 2d 3e 6c 6f 63 if( pCtx->loc
2e1e0 6b 50 72 6f 78 79 2d 3e 70 4d 65 74 68 6f 64 20 kProxy->pMethod
2e1f0 3d 3d 20 26 61 66 70 49 6f 4d 65 74 68 6f 64 73 == &afpIoMethods
2e200 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 66 ){. af
2e210 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 pLockingContext
2e220 2a 61 66 70 43 74 78 3b 0a 20 20 20 20 20 20 20 *afpCtx;.
2e230 20 20 20 61 66 70 43 74 78 20 3d 20 28 61 66 70 afpCtx = (afp
2e240 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a LockingContext *
2e250 29 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 )pCtx->lockProxy
2e260 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 ->lockingContext
2e270 3b 0a 20 20 20 20 20 20 20 20 20 20 61 66 70 43 ;. afpC
2e280 74 78 2d 3e 64 62 50 61 74 68 20 3d 20 70 43 74 tx->dbPath = pCt
2e290 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 74 68 x->lockProxyPath
2e2a0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
2e2b0 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 } else {.
2e2c0 20 20 20 63 6f 6e 63 68 46 69 6c 65 2d 3e 70 4d conchFile->pM
2e2d0 65 74 68 6f 64 2d 3e 78 55 6e 6c 6f 63 6b 28 28 ethod->xUnlock((
2e2e0 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 6f sqlite3_file*)co
2e2f0 6e 63 68 46 69 6c 65 2c 20 4e 4f 5f 4c 4f 43 4b nchFile, NO_LOCK
2e300 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
2e310 20 4f 53 54 52 41 43 45 28 28 22 54 41 4b 45 43 OSTRACE(("TAKEC
2e320 4f 4e 43 48 20 20 25 64 20 25 73 5c 6e 22 2c 20 ONCH %d %s\n",
2e330 63 6f 6e 63 68 46 69 6c 65 2d 3e 68 2c 0a 20 20 conchFile->h,.
2e340 20 20 20 20 20 20 20 20 20 20 20 20 20 72 63 3d rc=
2e350 3d 53 51 4c 49 54 45 5f 4f 4b 3f 22 6f 6b 22 3a =SQLITE_OK?"ok":
2e360 22 66 61 69 6c 65 64 22 29 29 3b 0a 20 20 20 20 "failed"));.
2e370 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
2e380 20 7d 20 77 68 69 6c 65 20 28 31 29 3b 20 2f 2a } while (1); /*
2e390 20 69 6e 20 63 61 73 65 20 77 65 20 6e 65 65 64 in case we need
2e3a0 20 74 6f 20 72 65 74 72 79 20 74 68 65 20 3a 61 to retry the :a
2e3b0 75 74 6f 3a 20 6c 6f 63 6b 20 66 69 6c 65 20 2d uto: lock file -
2e3c0 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2e3d0 20 20 20 2a 2a 20 77 65 20 73 68 6f 75 6c 64 20 ** we should
2e3e0 6e 65 76 65 72 20 67 65 74 20 68 65 72 65 20 65 never get here e
2e3f0 78 63 65 70 74 20 76 69 61 20 74 68 65 20 27 63 xcept via the 'c
2e400 6f 6e 74 69 6e 75 65 27 20 63 61 6c 6c 2e 20 2a ontinue' call. *
2e410 2f 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 /. }.}../*.** I
2e420 66 20 70 46 69 6c 65 20 68 6f 6c 64 73 20 61 20 f pFile holds a
2e430 6c 6f 63 6b 20 6f 6e 20 61 20 63 6f 6e 63 68 20 lock on a conch
2e440 66 69 6c 65 2c 20 74 68 65 6e 20 72 65 6c 65 61 file, then relea
2e450 73 65 20 74 68 61 74 20 6c 6f 63 6b 2e 0a 2a 2f se that lock..*/
2e460 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 .static int prox
2e470 79 52 65 6c 65 61 73 65 43 6f 6e 63 68 28 75 6e yReleaseConch(un
2e480 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a ixFile *pFile){.
2e490 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
2e4a0 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 2f 2a E_OK; /*
2e4b0 20 53 75 62 72 6f 75 74 69 6e 65 20 72 65 74 75 Subroutine retu
2e4c0 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 70 72 6f rn code */. pro
2e4d0 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 xyLockingContext
2e4e0 20 2a 70 43 74 78 3b 20 20 2f 2a 20 54 68 65 20 *pCtx; /* The
2e4f0 6c 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 20 locking context
2e500 66 6f 72 20 74 68 65 20 70 72 6f 78 79 20 6c 6f for the proxy lo
2e510 63 6b 20 2a 2f 0a 20 20 75 6e 69 78 46 69 6c 65 ck */. unixFile
2e520 20 2a 63 6f 6e 63 68 46 69 6c 65 3b 20 20 20 20 *conchFile;
2e530 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
2e540 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 2a 2f he conch file */
2e550 0a 0a 20 20 70 43 74 78 20 3d 20 28 70 72 6f 78 .. pCtx = (prox
2e560 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 yLockingContext
2e570 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 *)pFile->locking
2e580 43 6f 6e 74 65 78 74 3b 0a 20 20 63 6f 6e 63 68 Context;. conch
2e590 46 69 6c 65 20 3d 20 70 43 74 78 2d 3e 63 6f 6e File = pCtx->con
2e5a0 63 68 46 69 6c 65 3b 0a 20 20 4f 53 54 52 41 43 chFile;. OSTRAC
2e5b0 45 28 28 22 52 45 4c 45 41 53 45 43 4f 4e 43 48 E(("RELEASECONCH
2e5c0 20 20 25 64 20 66 6f 72 20 25 73 20 70 69 64 3d %d for %s pid=
2e5d0 25 64 5c 6e 22 2c 20 63 6f 6e 63 68 46 69 6c 65 %d\n", conchFile
2e5e0 2d 3e 68 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ->h,.
2e5f0 28 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 (pCtx->lockProxy
2e600 50 61 74 68 20 3f 20 70 43 74 78 2d 3e 6c 6f 63 Path ? pCtx->loc
2e610 6b 50 72 6f 78 79 50 61 74 68 20 3a 20 22 3a 61 kProxyPath : ":a
2e620 75 74 6f 3a 22 29 2c 20 0a 20 20 20 20 20 20 20 uto:"), .
2e630 20 20 20 20 67 65 74 70 69 64 28 29 29 29 3b 0a getpid()));.
2e640 20 20 69 66 28 20 70 43 74 78 2d 3e 63 6f 6e 63 if( pCtx->conc
2e650 68 48 65 6c 64 3e 30 20 29 7b 0a 20 20 20 20 72 hHeld>0 ){. r
2e660 63 20 3d 20 63 6f 6e 63 68 46 69 6c 65 2d 3e 70 c = conchFile->p
2e670 4d 65 74 68 6f 64 2d 3e 78 55 6e 6c 6f 63 6b 28 Method->xUnlock(
2e680 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 (sqlite3_file*)c
2e690 6f 6e 63 68 46 69 6c 65 2c 20 4e 4f 5f 4c 4f 43 onchFile, NO_LOC
2e6a0 4b 29 3b 0a 20 20 7d 0a 20 20 70 43 74 78 2d 3e K);. }. pCtx->
2e6b0 63 6f 6e 63 68 48 65 6c 64 20 3d 20 30 3b 0a 20 conchHeld = 0;.
2e6c0 20 4f 53 54 52 41 43 45 28 28 22 52 45 4c 45 41 OSTRACE(("RELEA
2e6d0 53 45 43 4f 4e 43 48 20 20 25 64 20 25 73 5c 6e SECONCH %d %s\n
2e6e0 22 2c 20 63 6f 6e 63 68 46 69 6c 65 2d 3e 68 2c ", conchFile->h,
2e6f0 0a 20 20 20 20 20 20 20 20 20 20 20 28 72 63 3d . (rc=
2e700 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 22 6f 6b =SQLITE_OK ? "ok
2e710 22 20 3a 20 22 66 61 69 6c 65 64 22 29 29 29 3b " : "failed")));
2e720 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
2e730 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 68 65 ./*.** Given the
2e740 20 6e 61 6d 65 20 6f 66 20 61 20 64 61 74 61 62 name of a datab
2e750 61 73 65 20 66 69 6c 65 2c 20 63 6f 6d 70 75 74 ase file, comput
2e760 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 69 74 e the name of it
2e770 73 20 63 6f 6e 63 68 20 66 69 6c 65 2e 0a 2a 2a s conch file..**
2e780 20 53 74 6f 72 65 20 74 68 65 20 63 6f 6e 63 68 Store the conch
2e790 20 66 69 6c 65 6e 61 6d 65 20 69 6e 20 6d 65 6d filename in mem
2e7a0 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f ory obtained fro
2e7b0 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 m sqlite3_malloc
2e7c0 28 29 2e 0a 2a 2a 20 4d 61 6b 65 20 2a 70 43 6f ()..** Make *pCo
2e7d0 6e 63 68 50 61 74 68 20 70 6f 69 6e 74 20 74 6f nchPath point to
2e7e0 20 74 68 65 20 6e 65 77 20 6e 61 6d 65 2e 20 20 the new name.
2e7f0 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b Return SQLITE_OK
2e800 20 6f 6e 20 73 75 63 63 65 73 73 0a 2a 2a 20 6f on success.** o
2e810 72 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 r SQLITE_NOMEM i
2e820 66 20 75 6e 61 62 6c 65 20 74 6f 20 6f 62 74 61 f unable to obta
2e830 69 6e 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a in memory..**.**
2e840 20 54 68 65 20 63 61 6c 6c 65 72 20 69 73 20 72 The caller is r
2e850 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 65 esponsible for e
2e860 6e 73 75 72 69 6e 67 20 74 68 61 74 20 74 68 65 nsuring that the
2e870 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f 72 allocated memor
2e880 79 0a 2a 2a 20 73 70 61 63 65 20 69 73 20 65 76 y.** space is ev
2e890 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 64 2e 0a entually freed..
2e8a0 2a 2a 0a 2a 2a 20 2a 70 43 6f 6e 63 68 50 61 74 **.** *pConchPat
2e8b0 68 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c h is set to NULL
2e8c0 20 69 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c if a memory all
2e8d0 6f 63 61 74 69 6f 6e 20 65 72 72 6f 72 20 6f 63 ocation error oc
2e8e0 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 curs..*/.static
2e8f0 69 6e 74 20 70 72 6f 78 79 43 72 65 61 74 65 43 int proxyCreateC
2e900 6f 6e 63 68 50 61 74 68 6e 61 6d 65 28 63 68 61 onchPathname(cha
2e910 72 20 2a 64 62 50 61 74 68 2c 20 63 68 61 72 20 r *dbPath, char
2e920 2a 2a 70 43 6f 6e 63 68 50 61 74 68 29 7b 0a 20 **pConchPath){.
2e930 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 int i;
2e940 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2e950 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
2e960 2f 0a 20 20 69 6e 74 20 6c 65 6e 20 3d 20 28 69 /. int len = (i
2e970 6e 74 29 73 74 72 6c 65 6e 28 64 62 50 61 74 68 nt)strlen(dbPath
2e980 29 3b 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 ); /* Length of
2e990 64 61 74 61 62 61 73 65 20 66 69 6c 65 6e 61 6d database filenam
2e9a0 65 20 2d 20 64 62 50 61 74 68 20 2a 2f 0a 20 20 e - dbPath */.
2e9b0 63 68 61 72 20 2a 63 6f 6e 63 68 50 61 74 68 3b char *conchPath;
2e9c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2e9d0 20 62 75 66 66 65 72 20 69 6e 20 77 68 69 63 68 buffer in which
2e9e0 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 63 6f to construct co
2e9f0 6e 63 68 20 6e 61 6d 65 20 2a 2f 0a 0a 20 20 2f nch name */.. /
2ea00 2a 20 41 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 * Allocate space
2ea10 20 66 6f 72 20 74 68 65 20 63 6f 6e 63 68 20 66 for the conch f
2ea20 69 6c 65 6e 61 6d 65 20 61 6e 64 20 69 6e 69 74 ilename and init
2ea30 69 61 6c 69 7a 65 20 74 68 65 20 6e 61 6d 65 20 ialize the name
2ea40 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6e 61 6d 65 to. ** the name
2ea50 20 6f 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c of the original
2ea60 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
2ea70 2a 2f 20 20 0a 20 20 2a 70 43 6f 6e 63 68 50 61 */ . *pConchPa
2ea80 74 68 20 3d 20 63 6f 6e 63 68 50 61 74 68 20 3d th = conchPath =
2ea90 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33 (char *)sqlite3
2eaa0 5f 6d 61 6c 6c 6f 63 28 6c 65 6e 20 2b 20 38 29 _malloc(len + 8)
2eab0 3b 0a 20 20 69 66 28 20 63 6f 6e 63 68 50 61 74 ;. if( conchPat
2eac0 68 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 h==0 ){. retu
2ead0 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b rn SQLITE_NOMEM;
2eae0 0a 20 20 7d 0a 20 20 6d 65 6d 63 70 79 28 63 6f . }. memcpy(co
2eaf0 6e 63 68 50 61 74 68 2c 20 64 62 50 61 74 68 2c nchPath, dbPath,
2eb00 20 6c 65 6e 2b 31 29 3b 0a 20 20 0a 20 20 2f 2a len+1);. . /*
2eb10 20 6e 6f 77 20 69 6e 73 65 72 74 20 61 20 22 2e now insert a ".
2eb20 22 20 62 65 66 6f 72 65 20 74 68 65 20 6c 61 73 " before the las
2eb30 74 20 2f 20 63 68 61 72 61 63 74 65 72 20 2a 2f t / character */
2eb40 0a 20 20 66 6f 72 28 20 69 3d 28 6c 65 6e 2d 31 . for( i=(len-1
2eb50 29 3b 20 69 3e 3d 30 3b 20 69 2d 2d 20 29 7b 0a ); i>=0; i-- ){.
2eb60 20 20 20 20 69 66 28 20 63 6f 6e 63 68 50 61 74 if( conchPat
2eb70 68 5b 69 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 h[i]=='/' ){.
2eb80 20 20 20 69 2b 2b 3b 0a 20 20 20 20 20 20 62 72 i++;. br
2eb90 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 eak;. }. }.
2eba0 20 63 6f 6e 63 68 50 61 74 68 5b 69 5d 3d 27 2e conchPath[i]='.
2ebb0 27 3b 0a 20 20 77 68 69 6c 65 20 28 20 69 3c 6c ';. while ( i<l
2ebc0 65 6e 20 29 7b 0a 20 20 20 20 63 6f 6e 63 68 50 en ){. conchP
2ebd0 61 74 68 5b 69 2b 31 5d 3d 64 62 50 61 74 68 5b ath[i+1]=dbPath[
2ebe0 69 5d 3b 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d i];. i++;. }
2ebf0 0a 0a 20 20 2f 2a 20 61 70 70 65 6e 64 20 74 68 .. /* append th
2ec00 65 20 22 2d 63 6f 6e 63 68 22 20 73 75 66 66 69 e "-conch" suffi
2ec10 78 20 74 6f 20 74 68 65 20 66 69 6c 65 20 2a 2f x to the file */
2ec20 0a 20 20 6d 65 6d 63 70 79 28 26 63 6f 6e 63 68 . memcpy(&conch
2ec30 50 61 74 68 5b 69 2b 31 5d 2c 20 22 2d 63 6f 6e Path[i+1], "-con
2ec40 63 68 22 2c 20 37 29 3b 0a 20 20 61 73 73 65 72 ch", 7);. asser
2ec50 74 28 20 28 69 6e 74 29 73 74 72 6c 65 6e 28 63 t( (int)strlen(c
2ec60 6f 6e 63 68 50 61 74 68 29 20 3d 3d 20 6c 65 6e onchPath) == len
2ec70 2b 37 20 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 +7 );.. return
2ec80 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
2ec90 2a 20 54 61 6b 65 73 20 61 20 66 75 6c 6c 79 20 * Takes a fully
2eca0 63 6f 6e 66 69 67 75 72 65 64 20 70 72 6f 78 79 configured proxy
2ecb0 20 6c 6f 63 6b 69 6e 67 2d 73 74 79 6c 65 20 75 locking-style u
2ecc0 6e 69 78 20 66 69 6c 65 20 61 6e 64 20 73 77 69 nix file and swi
2ecd0 74 63 68 65 73 0a 2a 2a 20 74 68 65 20 6c 6f 63 tches.** the loc
2ece0 61 6c 20 6c 6f 63 6b 20 66 69 6c 65 20 70 61 74 al lock file pat
2ecf0 68 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 h .*/.static int
2ed00 20 73 77 69 74 63 68 4c 6f 63 6b 50 72 6f 78 79 switchLockProxy
2ed10 50 61 74 68 28 75 6e 69 78 46 69 6c 65 20 2a 70 Path(unixFile *p
2ed20 46 69 6c 65 2c 20 63 6f 6e 73 74 20 63 68 61 72 File, const char
2ed30 20 2a 70 61 74 68 29 20 7b 0a 20 20 70 72 6f 78 *path) {. prox
2ed40 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 yLockingContext
2ed50 2a 70 43 74 78 20 3d 20 28 70 72 6f 78 79 4c 6f *pCtx = (proxyLo
2ed60 63 6b 69 6e 67 43 6f 6e 74 65 78 74 2a 29 70 46 ckingContext*)pF
2ed70 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
2ed80 65 78 74 3b 0a 20 20 63 68 61 72 20 2a 6f 6c 64 ext;. char *old
2ed90 50 61 74 68 20 3d 20 70 43 74 78 2d 3e 6c 6f 63 Path = pCtx->loc
2eda0 6b 50 72 6f 78 79 50 61 74 68 3b 0a 20 20 69 6e kProxyPath;. in
2edb0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
2edc0 3b 0a 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e ;.. if( pFile->
2edd0 65 46 69 6c 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f eFileLock!=NO_LO
2ede0 43 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e CK ){. return
2edf0 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 SQLITE_BUSY;.
2ee00 7d 20 20 0a 0a 20 20 2f 2a 20 6e 6f 74 68 69 6e } .. /* nothin
2ee10 67 20 74 6f 20 64 6f 20 69 66 20 74 68 65 20 70 g to do if the p
2ee20 61 74 68 20 69 73 20 4e 55 4c 4c 2c 20 3a 61 75 ath is NULL, :au
2ee30 74 6f 3a 20 6f 72 20 6d 61 74 63 68 65 73 20 74 to: or matches t
2ee40 68 65 20 65 78 69 73 74 69 6e 67 20 70 61 74 68 he existing path
2ee50 20 2a 2f 0a 20 20 69 66 28 20 21 70 61 74 68 20 */. if( !path
2ee60 7c 7c 20 70 61 74 68 5b 30 5d 3d 3d 27 5c 30 27 || path[0]=='\0'
2ee70 20 7c 7c 20 21 73 74 72 63 6d 70 28 70 61 74 68 || !strcmp(path
2ee80 2c 20 22 3a 61 75 74 6f 3a 22 29 20 7c 7c 0a 20 , ":auto:") ||.
2ee90 20 20 20 28 6f 6c 64 50 61 74 68 20 26 26 20 21 (oldPath && !
2eea0 73 74 72 6e 63 6d 70 28 6f 6c 64 50 61 74 68 2c strncmp(oldPath,
2eeb0 20 70 61 74 68 2c 20 4d 41 58 50 41 54 48 4c 45 path, MAXPATHLE
2eec0 4e 29 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 N)) ){. retur
2eed0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
2eee0 65 6c 73 65 7b 0a 20 20 20 20 75 6e 69 78 46 69 else{. unixFi
2eef0 6c 65 20 2a 6c 6f 63 6b 50 72 6f 78 79 20 3d 20 le *lockProxy =
2ef00 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 3b pCtx->lockProxy;
2ef10 0a 20 20 20 20 70 43 74 78 2d 3e 6c 6f 63 6b 50 . pCtx->lockP
2ef20 72 6f 78 79 3d 4e 55 4c 4c 3b 0a 20 20 20 20 70 roxy=NULL;. p
2ef30 43 74 78 2d 3e 63 6f 6e 63 68 48 65 6c 64 20 3d Ctx->conchHeld =
2ef40 20 30 3b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 0;. if( lock
2ef50 50 72 6f 78 79 21 3d 4e 55 4c 4c 20 29 7b 0a 20 Proxy!=NULL ){.
2ef60 20 20 20 20 20 72 63 3d 6c 6f 63 6b 50 72 6f 78 rc=lockProx
2ef70 79 2d 3e 70 4d 65 74 68 6f 64 2d 3e 78 43 6c 6f y->pMethod->xClo
2ef80 73 65 28 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 se((sqlite3_file
2ef90 20 2a 29 6c 6f 63 6b 50 72 6f 78 79 29 3b 0a 20 *)lockProxy);.
2efa0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
2efb0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 73 turn rc;. s
2efc0 71 6c 69 74 65 33 5f 66 72 65 65 28 6c 6f 63 6b qlite3_free(lock
2efd0 50 72 6f 78 79 29 3b 0a 20 20 20 20 7d 0a 20 20 Proxy);. }.
2efe0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 6f sqlite3_free(o
2eff0 6c 64 50 61 74 68 29 3b 0a 20 20 20 20 70 43 74 ldPath);. pCt
2f000 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 74 68 x->lockProxyPath
2f010 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 = sqlite3DbStrD
2f020 75 70 28 30 2c 20 70 61 74 68 29 3b 0a 20 20 7d up(0, path);. }
2f030 0a 20 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b . . return rc;
2f040 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 70 46 69 6c 65 20 .}../*.** pFile
2f050 69 73 20 61 20 66 69 6c 65 20 74 68 61 74 20 68 is a file that h
2f060 61 73 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 62 as been opened b
2f070 79 20 61 20 70 72 69 6f 72 20 78 4f 70 65 6e 20 y a prior xOpen
2f080 63 61 6c 6c 2e 20 20 64 62 50 61 74 68 0a 2a 2a call. dbPath.**
2f090 20 69 73 20 61 20 73 74 72 69 6e 67 20 62 75 66 is a string buf
2f0a0 66 65 72 20 61 74 20 6c 65 61 73 74 20 4d 41 58 fer at least MAX
2f0b0 50 41 54 48 4c 45 4e 2b 31 20 63 68 61 72 61 63 PATHLEN+1 charac
2f0c0 74 65 72 73 20 69 6e 20 73 69 7a 65 2e 0a 2a 2a ters in size..**
2f0d0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
2f0e0 20 66 69 6e 64 20 74 68 65 20 66 69 6c 65 6e 61 find the filena
2f0f0 6d 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 me associated wi
2f100 74 68 20 70 46 69 6c 65 20 61 6e 64 20 77 72 69 th pFile and wri
2f110 74 65 73 20 69 74 0a 2a 2a 20 69 6e 74 20 64 62 tes it.** int db
2f120 50 61 74 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 Path..*/.static
2f130 69 6e 74 20 70 72 6f 78 79 47 65 74 44 62 50 61 int proxyGetDbPa
2f140 74 68 46 6f 72 55 6e 69 78 46 69 6c 65 28 75 6e thForUnixFile(un
2f150 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 63 ixFile *pFile, c
2f160 68 61 72 20 2a 64 62 50 61 74 68 29 7b 0a 23 69 har *dbPath){.#i
2f170 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c f defined(__APPL
2f180 45 5f 5f 29 0a 20 20 69 66 28 20 70 46 69 6c 65 E__). if( pFile
2f190 2d 3e 70 4d 65 74 68 6f 64 20 3d 3d 20 26 61 66 ->pMethod == &af
2f1a0 70 49 6f 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 pIoMethods ){.
2f1b0 20 20 2f 2a 20 61 66 70 20 73 74 79 6c 65 20 6b /* afp style k
2f1c0 65 65 70 73 20 61 20 72 65 66 65 72 65 6e 63 65 eeps a reference
2f1d0 20 74 6f 20 74 68 65 20 64 62 20 70 61 74 68 20 to the db path
2f1e0 69 6e 20 74 68 65 20 66 69 6c 65 50 61 74 68 20 in the filePath
2f1f0 66 69 65 6c 64 20 0a 20 20 20 20 2a 2a 20 6f 66 field . ** of
2f200 20 74 68 65 20 73 74 72 75 63 74 20 2a 2f 0a 20 the struct */.
2f210 20 20 20 61 73 73 65 72 74 28 20 28 69 6e 74 29 assert( (int)
2f220 73 74 72 6c 65 6e 28 28 63 68 61 72 2a 29 70 46 strlen((char*)pF
2f230 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
2f240 65 78 74 29 3c 3d 4d 41 58 50 41 54 48 4c 45 4e ext)<=MAXPATHLEN
2f250 20 29 3b 0a 20 20 20 20 73 74 72 6c 63 70 79 28 );. strlcpy(
2f260 64 62 50 61 74 68 2c 20 28 28 61 66 70 4c 6f 63 dbPath, ((afpLoc
2f270 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 70 46 kingContext *)pF
2f280 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
2f290 65 78 74 29 2d 3e 64 62 50 61 74 68 2c 20 4d 41 ext)->dbPath, MA
2f2a0 58 50 41 54 48 4c 45 4e 29 3b 0a 20 20 7d 20 65 XPATHLEN);. } e
2f2b0 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 lse.#endif. if(
2f2c0 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 20 pFile->pMethod
2f2d0 3d 3d 20 26 64 6f 74 6c 6f 63 6b 49 6f 4d 65 74 == &dotlockIoMet
2f2e0 68 6f 64 73 20 29 7b 0a 20 20 20 20 2f 2a 20 64 hods ){. /* d
2f2f0 6f 74 20 6c 6f 63 6b 20 73 74 79 6c 65 20 75 73 ot lock style us
2f300 65 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 es the locking c
2f310 6f 6e 74 65 78 74 20 74 6f 20 73 74 6f 72 65 20 ontext to store
2f320 74 68 65 20 64 6f 74 20 6c 6f 63 6b 0a 20 20 20 the dot lock.
2f330 20 2a 2a 20 66 69 6c 65 20 70 61 74 68 20 2a 2f ** file path */
2f340 0a 20 20 20 20 69 6e 74 20 6c 65 6e 20 3d 20 73 . int len = s
2f350 74 72 6c 65 6e 28 28 63 68 61 72 20 2a 29 70 46 trlen((char *)pF
2f360 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
2f370 65 78 74 29 20 2d 20 73 74 72 6c 65 6e 28 44 4f ext) - strlen(DO
2f380 54 4c 4f 43 4b 5f 53 55 46 46 49 58 29 3b 0a 20 TLOCK_SUFFIX);.
2f390 20 20 20 6d 65 6d 63 70 79 28 64 62 50 61 74 68 memcpy(dbPath
2f3a0 2c 20 28 63 68 61 72 20 2a 29 70 46 69 6c 65 2d , (char *)pFile-
2f3b0 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 2c >lockingContext,
2f3c0 20 6c 65 6e 20 2b 20 31 29 3b 0a 20 20 7d 65 6c len + 1);. }el
2f3d0 73 65 7b 0a 20 20 20 20 2f 2a 20 61 6c 6c 20 6f se{. /* all o
2f3e0 74 68 65 72 20 73 74 79 6c 65 73 20 75 73 65 20 ther styles use
2f3f0 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f 6e 74 the locking cont
2f400 65 78 74 20 74 6f 20 73 74 6f 72 65 20 74 68 65 ext to store the
2f410 20 64 62 20 66 69 6c 65 20 70 61 74 68 20 2a 2f db file path */
2f420 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 74 72 . assert( str
2f430 6c 65 6e 28 28 63 68 61 72 2a 29 70 46 69 6c 65 len((char*)pFile
2f440 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 ->lockingContext
2f450 29 3c 3d 4d 41 58 50 41 54 48 4c 45 4e 20 29 3b )<=MAXPATHLEN );
2f460 0a 20 20 20 20 73 74 72 6c 63 70 79 28 64 62 50 . strlcpy(dbP
2f470 61 74 68 2c 20 28 63 68 61 72 20 2a 29 70 46 69 ath, (char *)pFi
2f480 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 le->lockingConte
2f490 78 74 2c 20 4d 41 58 50 41 54 48 4c 45 4e 29 3b xt, MAXPATHLEN);
2f4a0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
2f4b0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
2f4c0 2a 20 54 61 6b 65 73 20 61 6e 20 61 6c 72 65 61 * Takes an alrea
2f4d0 64 79 20 66 69 6c 6c 65 64 20 69 6e 20 75 6e 69 dy filled in uni
2f4e0 78 20 66 69 6c 65 20 61 6e 64 20 61 6c 74 65 72 x file and alter
2f4f0 73 20 69 74 20 73 6f 20 61 6c 6c 20 66 69 6c 65 s it so all file
2f500 20 6c 6f 63 6b 69 6e 67 20 0a 2a 2a 20 77 69 6c locking .** wil
2f510 6c 20 62 65 20 70 65 72 66 6f 72 6d 65 64 20 6f l be performed o
2f520 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 72 6f 78 n the local prox
2f530 79 20 6c 6f 63 6b 20 66 69 6c 65 2e 20 20 54 68 y lock file. Th
2f540 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 69 65 6c e following fiel
2f550 64 73 0a 2a 2a 20 61 72 65 20 70 72 65 73 65 72 ds.** are preser
2f560 76 65 64 20 69 6e 20 74 68 65 20 6c 6f 63 6b 69 ved in the locki
2f570 6e 67 20 63 6f 6e 74 65 78 74 20 73 6f 20 74 68 ng context so th
2f580 61 74 20 74 68 65 79 20 63 61 6e 20 62 65 20 72 at they can be r
2f590 65 73 74 6f 72 65 64 20 61 6e 64 20 0a 2a 2a 20 estored and .**
2f5a0 74 68 65 20 75 6e 69 78 20 73 74 72 75 63 74 75 the unix structu
2f5b0 72 65 20 70 72 6f 70 65 72 6c 79 20 63 6c 65 61 re properly clea
2f5c0 6e 65 64 20 75 70 20 61 74 20 63 6c 6f 73 65 20 ned up at close
2f5d0 74 69 6d 65 3a 0a 2a 2a 20 20 2d 3e 6c 6f 63 6b time:.** ->lock
2f5e0 69 6e 67 43 6f 6e 74 65 78 74 0a 2a 2a 20 20 2d ingContext.** -
2f5f0 3e 70 4d 65 74 68 6f 64 0a 2a 2f 0a 73 74 61 74 >pMethod.*/.stat
2f600 69 63 20 69 6e 74 20 70 72 6f 78 79 54 72 61 6e ic int proxyTran
2f610 73 66 6f 72 6d 55 6e 69 78 46 69 6c 65 28 75 6e sformUnixFile(un
2f620 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 63 ixFile *pFile, c
2f630 6f 6e 73 74 20 63 68 61 72 20 2a 70 61 74 68 29 onst char *path)
2f640 20 7b 0a 20 20 70 72 6f 78 79 4c 6f 63 6b 69 6e {. proxyLockin
2f650 67 43 6f 6e 74 65 78 74 20 2a 70 43 74 78 3b 0a gContext *pCtx;.
2f660 20 20 63 68 61 72 20 64 62 50 61 74 68 5b 4d 41 char dbPath[MA
2f670 58 50 41 54 48 4c 45 4e 2b 31 5d 3b 20 20 20 20 XPATHLEN+1];
2f680 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
2f690 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2f6a0 2a 2f 0a 20 20 63 68 61 72 20 2a 6c 6f 63 6b 50 */. char *lockP
2f6b0 61 74 68 3d 4e 55 4c 4c 3b 0a 20 20 69 6e 74 20 ath=NULL;. int
2f6c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
2f6d0 20 20 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e . if( pFile->
2f6e0 65 46 69 6c 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f eFileLock!=NO_LO
2f6f0 43 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e CK ){. return
2f700 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 SQLITE_BUSY;.
2f710 7d 0a 20 20 70 72 6f 78 79 47 65 74 44 62 50 61 }. proxyGetDbPa
2f720 74 68 46 6f 72 55 6e 69 78 46 69 6c 65 28 70 46 thForUnixFile(pF
2f730 69 6c 65 2c 20 64 62 50 61 74 68 29 3b 0a 20 20 ile, dbPath);.
2f740 69 66 28 20 21 70 61 74 68 20 7c 7c 20 70 61 74 if( !path || pat
2f750 68 5b 30 5d 3d 3d 27 5c 30 27 20 7c 7c 20 21 73 h[0]=='\0' || !s
2f760 74 72 63 6d 70 28 70 61 74 68 2c 20 22 3a 61 75 trcmp(path, ":au
2f770 74 6f 3a 22 29 20 29 7b 0a 20 20 20 20 6c 6f 63 to:") ){. loc
2f780 6b 50 61 74 68 3d 4e 55 4c 4c 3b 0a 20 20 7d 65 kPath=NULL;. }e
2f790 6c 73 65 7b 0a 20 20 20 20 6c 6f 63 6b 50 61 74 lse{. lockPat
2f7a0 68 3d 28 63 68 61 72 20 2a 29 70 61 74 68 3b 0a h=(char *)path;.
2f7b0 20 20 7d 0a 20 20 0a 20 20 4f 53 54 52 41 43 45 }. . OSTRACE
2f7c0 28 28 22 54 52 41 4e 53 50 52 4f 58 59 20 20 25 (("TRANSPROXY %
2f7d0 64 20 66 6f 72 20 25 73 20 70 69 64 3d 25 64 5c d for %s pid=%d\
2f7e0 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 n", pFile->h,.
2f7f0 20 20 20 20 20 20 20 20 20 28 6c 6f 63 6b 50 61 (lockPa
2f800 74 68 20 3f 20 6c 6f 63 6b 50 61 74 68 20 3a 20 th ? lockPath :
2f810 22 3a 61 75 74 6f 3a 22 29 2c 20 67 65 74 70 69 ":auto:"), getpi
2f820 64 28 29 29 29 3b 0a 0a 20 20 70 43 74 78 20 3d d()));.. pCtx =
2f830 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 sqlite3_malloc(
2f840 20 73 69 7a 65 6f 66 28 2a 70 43 74 78 29 20 29 sizeof(*pCtx) )
2f850 3b 0a 20 20 69 66 28 20 70 43 74 78 3d 3d 30 20 ;. if( pCtx==0
2f860 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
2f870 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a LITE_NOMEM;. }.
2f880 20 20 6d 65 6d 73 65 74 28 70 43 74 78 2c 20 30 memset(pCtx, 0
2f890 2c 20 73 69 7a 65 6f 66 28 2a 70 43 74 78 29 29 , sizeof(*pCtx))
2f8a0 3b 0a 0a 20 20 72 63 20 3d 20 70 72 6f 78 79 43 ;.. rc = proxyC
2f8b0 72 65 61 74 65 43 6f 6e 63 68 50 61 74 68 6e 61 reateConchPathna
2f8c0 6d 65 28 64 62 50 61 74 68 2c 20 26 70 43 74 78 me(dbPath, &pCtx
2f8d0 2d 3e 63 6f 6e 63 68 46 69 6c 65 50 61 74 68 29 ->conchFilePath)
2f8e0 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
2f8f0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
2f900 3d 20 70 72 6f 78 79 43 72 65 61 74 65 55 6e 69 = proxyCreateUni
2f910 78 46 69 6c 65 28 70 43 74 78 2d 3e 63 6f 6e 63 xFile(pCtx->conc
2f920 68 46 69 6c 65 50 61 74 68 2c 20 26 70 43 74 78 hFilePath, &pCtx
2f930 2d 3e 63 6f 6e 63 68 46 69 6c 65 2c 20 30 29 3b ->conchFile, 0);
2f940 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
2f950 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 26 26 20 ITE_CANTOPEN &&
2f960 28 28 70 46 69 6c 65 2d 3e 6f 70 65 6e 46 6c 61 ((pFile->openFla
2f970 67 73 26 4f 5f 52 44 57 52 29 20 3d 3d 20 30 29 gs&O_RDWR) == 0)
2f980 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 69 66 20 ){. /* if
2f990 28 61 29 20 74 68 65 20 6f 70 65 6e 20 66 6c 61 (a) the open fla
2f9a0 67 73 20 61 72 65 20 6e 6f 74 20 4f 5f 52 44 57 gs are not O_RDW
2f9b0 52 2c 20 28 62 29 20 74 68 65 20 63 6f 6e 63 68 R, (b) the conch
2f9c0 20 69 73 6e 27 74 20 74 68 65 72 65 2c 20 61 6e isn't there, an
2f9d0 64 0a 20 20 20 20 20 20 2a 2a 20 28 63 29 20 74 d. ** (c) t
2f9e0 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d 20 69 he file system i
2f9f0 73 20 72 65 61 64 2d 6f 6e 6c 79 2c 20 74 68 65 s read-only, the
2fa00 6e 20 65 6e 61 62 6c 65 20 6e 6f 2d 6c 6f 63 6b n enable no-lock
2fa10 69 6e 67 20 61 63 63 65 73 73 2e 0a 20 20 20 20 ing access..
2fa20 20 20 2a 2a 20 55 67 68 2c 20 73 69 6e 63 65 20 ** Ugh, since
2fa30 4f 5f 52 44 4f 4e 4c 59 3d 3d 30 78 30 30 30 30 O_RDONLY==0x0000
2fa40 20 77 65 20 74 65 73 74 20 66 6f 72 20 21 4f 5f we test for !O_
2fa50 52 44 57 52 20 73 69 6e 63 65 20 75 6e 69 78 4f RDWR since unixO
2fa60 70 65 6e 20 61 73 73 65 72 74 73 0a 20 20 20 20 pen asserts.
2fa70 20 20 2a 2a 20 74 68 61 74 20 6f 70 65 6e 46 6c ** that openFl
2fa80 61 67 73 20 77 69 6c 6c 20 68 61 76 65 20 6f 6e ags will have on
2fa90 6c 79 20 6f 6e 65 20 6f 66 20 4f 5f 52 44 4f 4e ly one of O_RDON
2faa0 4c 59 20 6f 72 20 4f 5f 52 44 57 52 2e 0a 20 20 LY or O_RDWR..
2fab0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 74 72 */. str
2fac0 75 63 74 20 73 74 61 74 66 73 20 66 73 49 6e 66 uct statfs fsInf
2fad0 6f 3b 0a 20 20 20 20 20 20 73 74 72 75 63 74 20 o;. struct
2fae0 73 74 61 74 20 63 6f 6e 63 68 49 6e 66 6f 3b 0a stat conchInfo;.
2faf0 20 20 20 20 20 20 69 6e 74 20 67 6f 4c 6f 63 6b int goLock
2fb00 6c 65 73 73 20 3d 20 30 3b 0a 0a 20 20 20 20 20 less = 0;..
2fb10 20 69 66 28 20 73 74 61 74 28 70 43 74 78 2d 3e if( stat(pCtx->
2fb20 63 6f 6e 63 68 46 69 6c 65 50 61 74 68 2c 20 26 conchFilePath, &
2fb30 63 6f 6e 63 68 49 6e 66 6f 29 20 3d 3d 20 2d 31 conchInfo) == -1
2fb40 20 29 20 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 ) {. int
2fb50 20 65 72 72 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 err = errno;.
2fb60 20 20 20 20 20 20 69 66 28 20 28 65 72 72 3d 3d if( (err==
2fb70 45 4e 4f 45 4e 54 29 20 26 26 20 28 73 74 61 74 ENOENT) && (stat
2fb80 66 73 28 64 62 50 61 74 68 2c 20 26 66 73 49 6e fs(dbPath, &fsIn
2fb90 66 6f 29 20 21 3d 20 2d 31 29 20 29 7b 0a 20 20 fo) != -1) ){.
2fba0 20 20 20 20 20 20 20 20 67 6f 4c 6f 63 6b 6c 65 goLockle
2fbb0 73 73 20 3d 20 28 66 73 49 6e 66 6f 2e 66 5f 66 ss = (fsInfo.f_f
2fbc0 6c 61 67 73 26 4d 4e 54 5f 52 44 4f 4e 4c 59 29 lags&MNT_RDONLY)
2fbd0 20 3d 3d 20 4d 4e 54 5f 52 44 4f 4e 4c 59 3b 0a == MNT_RDONLY;.
2fbe0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2fbf0 7d 0a 20 20 20 20 20 20 69 66 28 20 67 6f 4c 6f }. if( goLo
2fc00 63 6b 6c 65 73 73 20 29 7b 0a 20 20 20 20 20 20 ckless ){.
2fc10 20 20 70 43 74 78 2d 3e 63 6f 6e 63 68 48 65 6c pCtx->conchHel
2fc20 64 20 3d 20 2d 31 3b 20 2f 2a 20 72 65 61 64 20 d = -1; /* read
2fc30 6f 6e 6c 79 20 46 53 2f 20 6c 6f 63 6b 6c 65 73 only FS/ lockles
2fc40 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20 s */. rc
2fc50 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
2fc60 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 20 20 }. }. }
2fc70 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2fc80 45 5f 4f 4b 20 26 26 20 6c 6f 63 6b 50 61 74 68 E_OK && lockPath
2fc90 20 29 7b 0a 20 20 20 20 70 43 74 78 2d 3e 6c 6f ){. pCtx->lo
2fca0 63 6b 50 72 6f 78 79 50 61 74 68 20 3d 20 73 71 ckProxyPath = sq
2fcb0 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 30 2c lite3DbStrDup(0,
2fcc0 20 6c 6f 63 6b 50 61 74 68 29 3b 0a 20 20 7d 0a lockPath);. }.
2fcd0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2fce0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 43 74 78 E_OK ){. pCtx
2fcf0 2d 3e 64 62 50 61 74 68 20 3d 20 73 71 6c 69 74 ->dbPath = sqlit
2fd00 65 33 44 62 53 74 72 44 75 70 28 30 2c 20 64 62 e3DbStrDup(0, db
2fd10 50 61 74 68 29 3b 0a 20 20 20 20 69 66 28 20 70 Path);. if( p
2fd20 43 74 78 2d 3e 64 62 50 61 74 68 3d 3d 4e 55 4c Ctx->dbPath==NUL
2fd30 4c 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 L ){. rc =
2fd40 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
2fd50 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 }. }. if( rc
2fd60 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2fd70 20 20 20 2f 2a 20 61 6c 6c 20 6d 65 6d 6f 72 79 /* all memory
2fd80 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 2c 20 70 is allocated, p
2fd90 72 6f 78 79 73 20 61 72 65 20 63 72 65 61 74 65 roxys are create
2fda0 64 20 61 6e 64 20 61 73 73 69 67 6e 65 64 2c 20 d and assigned,
2fdb0 0a 20 20 20 20 2a 2a 20 73 77 69 74 63 68 20 74 . ** switch t
2fdc0 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 he locking conte
2fdd0 78 74 20 61 6e 64 20 70 4d 65 74 68 6f 64 20 74 xt and pMethod t
2fde0 68 65 6e 20 72 65 74 75 72 6e 2e 0a 20 20 20 20 hen return..
2fdf0 2a 2f 0a 20 20 20 20 70 43 74 78 2d 3e 6f 6c 64 */. pCtx->old
2fe00 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 3d LockingContext =
2fe10 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 pFile->lockingC
2fe20 6f 6e 74 65 78 74 3b 0a 20 20 20 20 70 46 69 6c ontext;. pFil
2fe30 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 e->lockingContex
2fe40 74 20 3d 20 70 43 74 78 3b 0a 20 20 20 20 70 43 t = pCtx;. pC
2fe50 74 78 2d 3e 70 4f 6c 64 4d 65 74 68 6f 64 20 3d tx->pOldMethod =
2fe60 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 3b pFile->pMethod;
2fe70 0a 20 20 20 20 70 46 69 6c 65 2d 3e 70 4d 65 74 . pFile->pMet
2fe80 68 6f 64 20 3d 20 26 70 72 6f 78 79 49 6f 4d 65 hod = &proxyIoMe
2fe90 74 68 6f 64 73 3b 0a 20 20 7d 65 6c 73 65 7b 0a thods;. }else{.
2fea0 20 20 20 20 69 66 28 20 70 43 74 78 2d 3e 63 6f if( pCtx->co
2feb0 6e 63 68 46 69 6c 65 20 29 7b 20 0a 20 20 20 20 nchFile ){ .
2fec0 20 20 70 43 74 78 2d 3e 63 6f 6e 63 68 46 69 6c pCtx->conchFil
2fed0 65 2d 3e 70 4d 65 74 68 6f 64 2d 3e 78 43 6c 6f e->pMethod->xClo
2fee0 73 65 28 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 se((sqlite3_file
2fef0 20 2a 29 70 43 74 78 2d 3e 63 6f 6e 63 68 46 69 *)pCtx->conchFi
2ff00 6c 65 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 le);. sqlit
2ff10 65 33 5f 66 72 65 65 28 70 43 74 78 2d 3e 63 6f e3_free(pCtx->co
2ff20 6e 63 68 46 69 6c 65 29 3b 0a 20 20 20 20 7d 0a nchFile);. }.
2ff30 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
2ff40 28 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 (pCtx->lockProxy
2ff50 50 61 74 68 29 3b 0a 20 20 20 20 73 71 6c 69 74 Path);. sqlit
2ff60 65 33 5f 66 72 65 65 28 70 43 74 78 2d 3e 63 6f e3_free(pCtx->co
2ff70 6e 63 68 46 69 6c 65 50 61 74 68 29 3b 20 0a 20 nchFilePath); .
2ff80 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
2ff90 70 43 74 78 29 3b 0a 20 20 7d 0a 20 20 4f 53 54 pCtx);. }. OST
2ffa0 52 41 43 45 28 28 22 54 52 41 4e 53 50 52 4f 58 RACE(("TRANSPROX
2ffb0 59 20 20 25 64 20 25 73 5c 6e 22 2c 20 70 46 69 Y %d %s\n", pFi
2ffc0 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20 20 20 20 le->h,.
2ffd0 20 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b (rc==SQLITE_OK
2ffe0 20 3f 20 22 6f 6b 22 20 3a 20 22 66 61 69 6c 65 ? "ok" : "faile
2fff0 64 22 29 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 d")));. return
30000 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}.../*.** Th
30010 69 73 20 72 6f 75 74 69 6e 65 20 68 61 6e 64 6c is routine handl
30020 65 73 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 5f es sqlite3_file_
30030 63 6f 6e 74 72 6f 6c 28 29 20 63 61 6c 6c 73 20 control() calls
30040 74 68 61 74 20 61 72 65 20 73 70 65 63 69 66 69 that are specifi
30050 63 0a 2a 2a 20 74 6f 20 70 72 6f 78 79 20 6c 6f c.** to proxy lo
30060 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 cking..*/.static
30070 20 69 6e 74 20 70 72 6f 78 79 46 69 6c 65 43 6f int proxyFileCo
30080 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69 ntrol(sqlite3_fi
30090 6c 65 20 2a 69 64 2c 20 69 6e 74 20 6f 70 2c 20 le *id, int op,
300a0 76 6f 69 64 20 2a 70 41 72 67 29 7b 0a 20 20 73 void *pArg){. s
300b0 77 69 74 63 68 28 20 6f 70 20 29 7b 0a 20 20 20 witch( op ){.
300c0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 47 45 54 case SQLITE_GET
300d0 5f 4c 4f 43 4b 50 52 4f 58 59 46 49 4c 45 3a 20 _LOCKPROXYFILE:
300e0 7b 0a 20 20 20 20 20 20 75 6e 69 78 46 69 6c 65 {. unixFile
300f0 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 *pFile = (unixF
30100 69 6c 65 2a 29 69 64 3b 0a 20 20 20 20 20 20 69 ile*)id;. i
30110 66 28 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f f( pFile->pMetho
30120 64 20 3d 3d 20 26 70 72 6f 78 79 49 6f 4d 65 74 d == &proxyIoMet
30130 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 20 20 hods ){.
30140 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 proxyLockingCont
30150 65 78 74 20 2a 70 43 74 78 20 3d 20 28 70 72 6f ext *pCtx = (pro
30160 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 xyLockingContext
30170 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 *)pFile->locking
30180 43 6f 6e 74 65 78 74 3b 0a 20 20 20 20 20 20 20 Context;.
30190 20 70 72 6f 78 79 54 61 6b 65 43 6f 6e 63 68 28 proxyTakeConch(
301a0 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 20 20 pFile);.
301b0 69 66 28 20 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 if( pCtx->lockPr
301c0 6f 78 79 50 61 74 68 20 29 7b 0a 20 20 20 20 20 oxyPath ){.
301d0 20 20 20 20 20 2a 28 63 6f 6e 73 74 20 63 68 61 *(const cha
301e0 72 20 2a 2a 29 70 41 72 67 20 3d 20 70 43 74 78 r **)pArg = pCtx
301f0 2d 3e 6c 6f 63 6b 50 72 6f 78 79 50 61 74 68 3b ->lockProxyPath;
30200 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
30210 20 20 20 20 20 20 20 20 20 20 2a 28 63 6f 6e 73 *(cons
30220 74 20 63 68 61 72 20 2a 2a 29 70 41 72 67 20 3d t char **)pArg =
30230 20 22 3a 61 75 74 6f 3a 20 28 6e 6f 74 20 68 65 ":auto: (not he
30240 6c 64 29 22 3b 0a 20 20 20 20 20 20 20 20 7d 0a ld)";. }.
30250 20 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 } else {.
30260 20 20 20 20 20 20 20 2a 28 63 6f 6e 73 74 20 63 *(const c
30270 68 61 72 20 2a 2a 29 70 41 72 67 20 3d 20 4e 55 har **)pArg = NU
30280 4c 4c 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 LL;. }.
30290 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
302a0 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 OK;. }. ca
302b0 73 65 20 53 51 4c 49 54 45 5f 53 45 54 5f 4c 4f se SQLITE_SET_LO
302c0 43 4b 50 52 4f 58 59 46 49 4c 45 3a 20 7b 0a 20 CKPROXYFILE: {.
302d0 20 20 20 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 unixFile *p
302e0 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 File = (unixFile
302f0 2a 29 69 64 3b 0a 20 20 20 20 20 20 69 6e 74 20 *)id;. int
30300 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
30310 20 20 20 20 20 20 69 6e 74 20 69 73 50 72 6f 78 int isProx
30320 79 53 74 79 6c 65 20 3d 20 28 70 46 69 6c 65 2d yStyle = (pFile-
30330 3e 70 4d 65 74 68 6f 64 20 3d 3d 20 26 70 72 6f >pMethod == &pro
30340 78 79 49 6f 4d 65 74 68 6f 64 73 29 3b 0a 20 20 xyIoMethods);.
30350 20 20 20 20 69 66 28 20 70 41 72 67 3d 3d 4e 55 if( pArg==NU
30360 4c 4c 20 7c 7c 20 28 63 6f 6e 73 74 20 63 68 61 LL || (const cha
30370 72 20 2a 29 70 41 72 67 3d 3d 30 20 29 7b 0a 20 r *)pArg==0 ){.
30380 20 20 20 20 20 20 20 69 66 28 20 69 73 50 72 6f if( isPro
30390 78 79 53 74 79 6c 65 20 29 7b 0a 20 20 20 20 20 xyStyle ){.
303a0 20 20 20 20 20 2f 2a 20 74 75 72 6e 20 6f 66 66 /* turn off
303b0 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 2d proxy locking -
303c0 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 20 2a not supported *
303d0 2f 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d /. rc =
303e0 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 2f 2a SQLITE_ERROR /*
303f0 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3f SQLITE_PROTOCOL?
30400 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3f 2a SQLITE_MISUSE?*
30410 2f 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 /;. }else
30420 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 74 {. /* t
30430 75 72 6e 20 6f 66 66 20 70 72 6f 78 79 20 6c 6f urn off proxy lo
30440 63 6b 69 6e 67 20 2d 20 61 6c 72 65 61 64 79 20 cking - already
30450 6f 66 66 20 2d 20 4e 4f 4f 50 20 2a 2f 0a 20 20 off - NOOP */.
30460 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
30470 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 ITE_OK;.
30480 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
30490 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 const cha
304a0 72 20 2a 70 72 6f 78 79 50 61 74 68 20 3d 20 28 r *proxyPath = (
304b0 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 70 41 72 const char *)pAr
304c0 67 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 g;. if( i
304d0 73 50 72 6f 78 79 53 74 79 6c 65 20 29 7b 0a 20 sProxyStyle ){.
304e0 20 20 20 20 20 20 20 20 20 70 72 6f 78 79 4c 6f proxyLo
304f0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 70 43 ckingContext *pC
30500 74 78 20 3d 20 0a 20 20 20 20 20 20 20 20 20 20 tx = .
30510 20 20 28 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 (proxyLockingC
30520 6f 6e 74 65 78 74 2a 29 70 46 69 6c 65 2d 3e 6c ontext*)pFile->l
30530 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 ockingContext;.
30540 20 20 20 20 20 20 20 20 20 69 66 28 20 21 73 74 if( !st
30550 72 63 6d 70 28 70 41 72 67 2c 20 22 3a 61 75 74 rcmp(pArg, ":aut
30560 6f 3a 22 29 20 0a 20 20 20 20 20 20 20 20 20 20 o:") .
30570 20 7c 7c 20 28 70 43 74 78 2d 3e 6c 6f 63 6b 50 || (pCtx->lockP
30580 72 6f 78 79 50 61 74 68 20 26 26 0a 20 20 20 20 roxyPath &&.
30590 20 20 20 20 20 20 20 20 20 20 20 21 73 74 72 6e !strn
305a0 63 6d 70 28 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 cmp(pCtx->lockPr
305b0 6f 78 79 50 61 74 68 2c 20 70 72 6f 78 79 50 61 oxyPath, proxyPa
305c0 74 68 2c 20 4d 41 58 50 41 54 48 4c 45 4e 29 29 th, MAXPATHLEN))
305d0 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20 20 . ){.
305e0 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
305f0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
30600 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
30610 20 20 20 20 20 20 20 72 63 20 3d 20 73 77 69 74 rc = swit
30620 63 68 4c 6f 63 6b 50 72 6f 78 79 50 61 74 68 28 chLockProxyPath(
30630 70 46 69 6c 65 2c 20 70 72 6f 78 79 50 61 74 68 pFile, proxyPath
30640 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
30650 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
30660 20 20 20 20 20 20 20 20 2f 2a 20 74 75 72 6e 20 /* turn
30670 6f 6e 20 70 72 6f 78 79 20 66 69 6c 65 20 6c 6f on proxy file lo
30680 63 6b 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 20 cking */.
30690 20 20 20 72 63 20 3d 20 70 72 6f 78 79 54 72 61 rc = proxyTra
306a0 6e 73 66 6f 72 6d 55 6e 69 78 46 69 6c 65 28 70 nsformUnixFile(p
306b0 46 69 6c 65 2c 20 70 72 6f 78 79 50 61 74 68 29 File, proxyPath)
306c0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
306d0 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e }. return
306e0 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 rc;. }. d
306f0 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 efault: {.
30700 61 73 73 65 72 74 28 20 30 20 29 3b 20 20 2f 2a assert( 0 ); /*
30710 20 54 68 65 20 63 61 6c 6c 20 61 73 73 75 72 65 The call assure
30720 73 20 74 68 61 74 20 6f 6e 6c 79 20 76 61 6c 69 s that only vali
30730 64 20 6f 70 63 6f 64 65 73 20 61 72 65 20 73 65 d opcodes are se
30740 6e 74 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 7d 0a nt */. }. }.
30750 20 20 2f 2a 4e 4f 54 52 45 41 43 48 45 44 2a 2f /*NOTREACHED*/
30760 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
30770 5f 45 52 52 4f 52 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a _ERROR;.}../*.**
30780 20 57 69 74 68 69 6e 20 74 68 69 73 20 64 69 76 Within this div
30790 69 73 69 6f 6e 20 28 74 68 65 20 70 72 6f 78 79 ision (the proxy
307a0 69 6e 67 20 6c 6f 63 6b 69 6e 67 20 69 6d 70 6c ing locking impl
307b0 65 6d 65 6e 74 61 74 69 6f 6e 29 20 74 68 65 20 ementation) the
307c0 70 72 6f 63 65 64 75 72 65 73 0a 2a 2a 20 61 62 procedures.** ab
307d0 6f 76 65 20 74 68 69 73 20 70 6f 69 6e 74 20 61 ove this point a
307e0 72 65 20 61 6c 6c 20 75 74 69 6c 69 74 69 65 73 re all utilities
307f0 2e 20 20 54 68 65 20 6c 6f 63 6b 2d 72 65 6c 61 . The lock-rela
30800 74 65 64 20 6d 65 74 68 6f 64 73 20 6f 66 20 74 ted methods of t
30810 68 65 0a 2a 2a 20 70 72 6f 78 79 2d 6c 6f 63 6b he.** proxy-lock
30820 69 6e 67 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d ing sqlite3_io_m
30830 65 74 68 6f 64 20 6f 62 6a 65 63 74 20 66 6f 6c ethod object fol
30840 6c 6f 77 2e 0a 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 low..*/.../*.**
30850 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68 65 This routine che
30860 63 6b 73 20 69 66 20 74 68 65 72 65 20 69 73 20 cks if there is
30870 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 a RESERVED lock
30880 68 65 6c 64 20 6f 6e 20 74 68 65 20 73 70 65 63 held on the spec
30890 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65 20 62 79 ified.** file by
308a0 20 74 68 69 73 20 6f 72 20 61 6e 79 20 6f 74 68 this or any oth
308b0 65 72 20 70 72 6f 63 65 73 73 2e 20 49 66 20 73 er process. If s
308c0 75 63 68 20 61 20 6c 6f 63 6b 20 69 73 20 68 65 uch a lock is he
308d0 6c 64 2c 20 73 65 74 20 2a 70 52 65 73 4f 75 74 ld, set *pResOut
308e0 0a 2a 2a 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 .** to a non-zer
308f0 6f 20 76 61 6c 75 65 20 6f 74 68 65 72 77 69 73 o value otherwis
30900 65 20 2a 70 52 65 73 4f 75 74 20 69 73 20 73 65 e *pResOut is se
30910 74 20 74 6f 20 7a 65 72 6f 2e 20 20 54 68 65 20 t to zero. The
30920 72 65 74 75 72 6e 20 76 61 6c 75 65 0a 2a 2a 20 return value.**
30930 69 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 is set to SQLITE
30940 5f 4f 4b 20 75 6e 6c 65 73 73 20 61 6e 20 49 2f _OK unless an I/
30950 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 O error occurs d
30960 75 72 69 6e 67 20 6c 6f 63 6b 20 63 68 65 63 6b uring lock check
30970 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ing..*/.static i
30980 6e 74 20 70 72 6f 78 79 43 68 65 63 6b 52 65 73 nt proxyCheckRes
30990 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 ervedLock(sqlite
309a0 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 3_file *id, int
309b0 2a 70 52 65 73 4f 75 74 29 20 7b 0a 20 20 75 6e *pResOut) {. un
309c0 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 ixFile *pFile =
309d0 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 (unixFile*)id;.
309e0 20 69 6e 74 20 72 63 20 3d 20 70 72 6f 78 79 54 int rc = proxyT
309f0 61 6b 65 43 6f 6e 63 68 28 70 46 69 6c 65 29 3b akeConch(pFile);
30a00 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
30a10 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 72 6f 78 E_OK ){. prox
30a20 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 yLockingContext
30a30 2a 70 43 74 78 20 3d 20 28 70 72 6f 78 79 4c 6f *pCtx = (proxyLo
30a40 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 70 ckingContext *)p
30a50 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e File->lockingCon
30a60 74 65 78 74 3b 0a 20 20 20 20 69 66 28 20 70 43 text;. if( pC
30a70 74 78 2d 3e 63 6f 6e 63 68 48 65 6c 64 3e 30 20 tx->conchHeld>0
30a80 29 7b 0a 20 20 20 20 20 20 75 6e 69 78 46 69 6c ){. unixFil
30a90 65 20 2a 70 72 6f 78 79 20 3d 20 70 43 74 78 2d e *proxy = pCtx-
30aa0 3e 6c 6f 63 6b 50 72 6f 78 79 3b 0a 20 20 20 20 >lockProxy;.
30ab0 20 20 72 65 74 75 72 6e 20 70 72 6f 78 79 2d 3e return proxy->
30ac0 70 4d 65 74 68 6f 64 2d 3e 78 43 68 65 63 6b 52 pMethod->xCheckR
30ad0 65 73 65 72 76 65 64 4c 6f 63 6b 28 28 73 71 6c eservedLock((sql
30ae0 69 74 65 33 5f 66 69 6c 65 2a 29 70 72 6f 78 79 ite3_file*)proxy
30af0 2c 20 70 52 65 73 4f 75 74 29 3b 0a 20 20 20 20 , pResOut);.
30b00 7d 65 6c 73 65 7b 20 2f 2a 20 63 6f 6e 63 68 48 }else{ /* conchH
30b10 65 6c 64 20 3c 20 30 20 69 73 20 6c 6f 63 6b 6c eld < 0 is lockl
30b20 65 73 73 20 2a 2f 0a 20 20 20 20 20 20 70 52 65 ess */. pRe
30b30 73 4f 75 74 3d 30 3b 0a 20 20 20 20 7d 0a 20 20 sOut=0;. }.
30b40 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
30b50 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 ../*.** Lock the
30b60 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 20 6c file with the l
30b70 6f 63 6b 20 73 70 65 63 69 66 69 65 64 20 62 79 ock specified by
30b80 20 70 61 72 61 6d 65 74 65 72 20 65 46 69 6c 65 parameter eFile
30b90 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 Lock - one.** of
30ba0 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a the following:.
30bb0 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 53 48 **.** (1) SH
30bc0 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 ARED_LOCK.**
30bd0 20 28 32 29 20 52 45 53 45 52 56 45 44 5f 4c 4f (2) RESERVED_LO
30be0 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 20 50 45 CK.** (3) PE
30bf0 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 NDING_LOCK.**
30c00 20 20 28 34 29 20 45 58 43 4c 55 53 49 56 45 5f (4) EXCLUSIVE_
30c10 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 LOCK.**.** Somet
30c20 69 6d 65 73 20 77 68 65 6e 20 72 65 71 75 65 73 imes when reques
30c30 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 ting one lock st
30c40 61 74 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c 20 ate, additional
30c50 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20 61 lock states.** a
30c60 72 65 20 69 6e 73 65 72 74 65 64 20 69 6e 20 62 re inserted in b
30c70 65 74 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f 63 etween. The loc
30c80 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 69 6c 20 king might fail
30c90 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 61 on one of the la
30ca0 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f ter.** transitio
30cb0 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c ns leaving the l
30cc0 6f 63 6b 20 73 74 61 74 65 20 64 69 66 66 65 72 ock state differ
30cd0 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 69 74 ent from what it
30ce0 20 73 74 61 72 74 65 64 20 62 75 74 0a 2a 2a 20 started but.**
30cf0 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20 69 still short of i
30d00 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 20 66 6f ts goal. The fo
30d10 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 20 73 68 llowing chart sh
30d20 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 65 64 0a ows the allowed.
30d30 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 61 ** transitions a
30d40 6e 64 20 74 68 65 20 69 6e 73 65 72 74 65 64 20 nd the inserted
30d50 69 6e 74 65 72 6d 65 64 69 61 74 65 20 73 74 61 intermediate sta
30d60 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e tes:.**.** UN
30d70 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 52 45 44 LOCKED -> SHARED
30d80 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e .** SHARED ->
30d90 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 20 20 20 RESERVED.**
30da0 53 48 41 52 45 44 20 2d 3e 20 28 50 45 4e 44 49 SHARED -> (PENDI
30db0 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 NG) -> EXCLUSIVE
30dc0 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 45 44 20 .** RESERVED
30dd0 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 -> (PENDING) ->
30de0 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 EXCLUSIVE.**
30df0 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c 55 PENDING -> EXCLU
30e00 53 49 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 SIVE.**.** This
30e10 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c routine will onl
30e20 79 20 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 y increase a loc
30e30 6b 2e 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 k. Use the sqli
30e40 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a te3OsUnlock().**
30e50 20 72 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 routine to lowe
30e60 72 20 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 r a locking leve
30e70 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 l..*/.static int
30e80 20 70 72 6f 78 79 4c 6f 63 6b 28 73 71 6c 69 74 proxyLock(sqlit
30e90 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 e3_file *id, int
30ea0 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 eFileLock) {.
30eb0 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 unixFile *pFile
30ec0 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b = (unixFile*)id;
30ed0 0a 20 20 69 6e 74 20 72 63 20 3d 20 70 72 6f 78 . int rc = prox
30ee0 79 54 61 6b 65 43 6f 6e 63 68 28 70 46 69 6c 65 yTakeConch(pFile
30ef0 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
30f00 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 72 ITE_OK ){. pr
30f10 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 oxyLockingContex
30f20 74 20 2a 70 43 74 78 20 3d 20 28 70 72 6f 78 79 t *pCtx = (proxy
30f30 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a LockingContext *
30f40 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 )pFile->lockingC
30f50 6f 6e 74 65 78 74 3b 0a 20 20 20 20 69 66 28 20 ontext;. if(
30f60 70 43 74 78 2d 3e 63 6f 6e 63 68 48 65 6c 64 3e pCtx->conchHeld>
30f70 30 20 29 7b 0a 20 20 20 20 20 20 75 6e 69 78 46 0 ){. unixF
30f80 69 6c 65 20 2a 70 72 6f 78 79 20 3d 20 70 43 74 ile *proxy = pCt
30f90 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 3b 0a 20 20 x->lockProxy;.
30fa0 20 20 20 20 72 63 20 3d 20 70 72 6f 78 79 2d 3e rc = proxy->
30fb0 70 4d 65 74 68 6f 64 2d 3e 78 4c 6f 63 6b 28 28 pMethod->xLock((
30fc0 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 70 72 sqlite3_file*)pr
30fd0 6f 78 79 2c 20 65 46 69 6c 65 4c 6f 63 6b 29 3b oxy, eFileLock);
30fe0 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 . pFile->eF
30ff0 69 6c 65 4c 6f 63 6b 20 3d 20 70 72 6f 78 79 2d ileLock = proxy-
31000 3e 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 >eFileLock;.
31010 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 }else{. /*
31020 63 6f 6e 63 68 48 65 6c 64 20 3c 20 30 20 69 73 conchHeld < 0 is
31030 20 6c 6f 63 6b 6c 65 73 73 20 2a 2f 0a 20 20 20 lockless */.
31040 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
31050 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4c 6f rc;.}.../*.** Lo
31060 77 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 wer the locking
31070 6c 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 level on file de
31080 73 63 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74 scriptor pFile t
31090 6f 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 o eFileLock. eF
310a0 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 ileLock.** must
310b0 62 65 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 be either NO_LOC
310c0 4b 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b K or SHARED_LOCK
310d0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c ..**.** If the l
310e0 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 ocking level of
310f0 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 the file descrip
31100 74 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 61 tor is already a
31110 74 20 6f 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 t or below.** th
31120 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b e requested lock
31130 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 ing level, this
31140 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d routine is a no-
31150 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e op..*/.static in
31160 74 20 70 72 6f 78 79 55 6e 6c 6f 63 6b 28 73 71 t proxyUnlock(sq
31170 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
31180 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b int eFileLock) {
31190 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
311a0 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
311b0 69 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 70 id;. int rc = p
311c0 72 6f 78 79 54 61 6b 65 43 6f 6e 63 68 28 70 46 roxyTakeConch(pF
311d0 69 6c 65 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d ile);. if( rc==
311e0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
311f0 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e proxyLockingCon
31200 74 65 78 74 20 2a 70 43 74 78 20 3d 20 28 70 72 text *pCtx = (pr
31210 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 oxyLockingContex
31220 74 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 t *)pFile->locki
31230 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 20 20 69 ngContext;. i
31240 66 28 20 70 43 74 78 2d 3e 63 6f 6e 63 68 48 65 f( pCtx->conchHe
31250 6c 64 3e 30 20 29 7b 0a 20 20 20 20 20 20 75 6e ld>0 ){. un
31260 69 78 46 69 6c 65 20 2a 70 72 6f 78 79 20 3d 20 ixFile *proxy =
31270 70 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 3b pCtx->lockProxy;
31280 0a 20 20 20 20 20 20 72 63 20 3d 20 70 72 6f 78 . rc = prox
31290 79 2d 3e 70 4d 65 74 68 6f 64 2d 3e 78 55 6e 6c y->pMethod->xUnl
312a0 6f 63 6b 28 28 73 71 6c 69 74 65 33 5f 66 69 6c ock((sqlite3_fil
312b0 65 2a 29 70 72 6f 78 79 2c 20 65 46 69 6c 65 4c e*)proxy, eFileL
312c0 6f 63 6b 29 3b 0a 20 20 20 20 20 20 70 46 69 6c ock);. pFil
312d0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 70 e->eFileLock = p
312e0 72 6f 78 79 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3b roxy->eFileLock;
312f0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
31300 20 20 2f 2a 20 63 6f 6e 63 68 48 65 6c 64 20 3c /* conchHeld <
31310 20 30 20 69 73 20 6c 6f 63 6b 6c 65 73 73 20 2a 0 is lockless *
31320 2f 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 /. }. }. re
31330 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
31340 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 20 74 * Close a file t
31350 68 61 74 20 75 73 65 73 20 70 72 6f 78 79 20 6c hat uses proxy l
31360 6f 63 6b 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ocks..*/.static
31370 69 6e 74 20 70 72 6f 78 79 43 6c 6f 73 65 28 73 int proxyClose(s
31380 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 qlite3_file *id)
31390 20 7b 0a 20 20 69 66 28 20 69 64 20 29 7b 0a 20 {. if( id ){.
313a0 20 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 unixFile *pFi
313b0 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
313c0 69 64 3b 0a 20 20 20 20 70 72 6f 78 79 4c 6f 63 id;. proxyLoc
313d0 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 70 43 74 kingContext *pCt
313e0 78 20 3d 20 28 70 72 6f 78 79 4c 6f 63 6b 69 6e x = (proxyLockin
313f0 67 43 6f 6e 74 65 78 74 20 2a 29 70 46 69 6c 65 gContext *)pFile
31400 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 ->lockingContext
31410 3b 0a 20 20 20 20 75 6e 69 78 46 69 6c 65 20 2a ;. unixFile *
31420 6c 6f 63 6b 50 72 6f 78 79 20 3d 20 70 43 74 78 lockProxy = pCtx
31430 2d 3e 6c 6f 63 6b 50 72 6f 78 79 3b 0a 20 20 20 ->lockProxy;.
31440 20 75 6e 69 78 46 69 6c 65 20 2a 63 6f 6e 63 68 unixFile *conch
31450 46 69 6c 65 20 3d 20 70 43 74 78 2d 3e 63 6f 6e File = pCtx->con
31460 63 68 46 69 6c 65 3b 0a 20 20 20 20 69 6e 74 20 chFile;. int
31470 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
31480 20 20 20 20 0a 20 20 20 20 69 66 28 20 6c 6f 63 . if( loc
31490 6b 50 72 6f 78 79 20 29 7b 0a 20 20 20 20 20 20 kProxy ){.
314a0 72 63 20 3d 20 6c 6f 63 6b 50 72 6f 78 79 2d 3e rc = lockProxy->
314b0 70 4d 65 74 68 6f 64 2d 3e 78 55 6e 6c 6f 63 6b pMethod->xUnlock
314c0 28 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 ((sqlite3_file*)
314d0 6c 6f 63 6b 50 72 6f 78 79 2c 20 4e 4f 5f 4c 4f lockProxy, NO_LO
314e0 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 CK);. if( r
314f0 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
31500 20 20 20 20 20 72 63 20 3d 20 6c 6f 63 6b 50 72 rc = lockPr
31510 6f 78 79 2d 3e 70 4d 65 74 68 6f 64 2d 3e 78 43 oxy->pMethod->xC
31520 6c 6f 73 65 28 28 73 71 6c 69 74 65 33 5f 66 69 lose((sqlite3_fi
31530 6c 65 2a 29 6c 6f 63 6b 50 72 6f 78 79 29 3b 0a le*)lockProxy);.
31540 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 if( rc ) r
31550 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
31560 73 71 6c 69 74 65 33 5f 66 72 65 65 28 6c 6f 63 sqlite3_free(loc
31570 6b 50 72 6f 78 79 29 3b 0a 20 20 20 20 20 20 70 kProxy);. p
31580 43 74 78 2d 3e 6c 6f 63 6b 50 72 6f 78 79 20 3d Ctx->lockProxy =
31590 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 0;. }. if
315a0 28 20 63 6f 6e 63 68 46 69 6c 65 20 29 7b 0a 20 ( conchFile ){.
315b0 20 20 20 20 20 69 66 28 20 70 43 74 78 2d 3e 63 if( pCtx->c
315c0 6f 6e 63 68 48 65 6c 64 20 29 7b 0a 20 20 20 20 onchHeld ){.
315d0 20 20 20 20 72 63 20 3d 20 70 72 6f 78 79 52 65 rc = proxyRe
315e0 6c 65 61 73 65 43 6f 6e 63 68 28 70 46 69 6c 65 leaseConch(pFile
315f0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
31600 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
31610 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 20 }. rc
31620 3d 20 63 6f 6e 63 68 46 69 6c 65 2d 3e 70 4d 65 = conchFile->pMe
31630 74 68 6f 64 2d 3e 78 43 6c 6f 73 65 28 28 73 71 thod->xClose((sq
31640 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 6f 6e 63 lite3_file*)conc
31650 68 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 69 66 hFile);. if
31660 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
31670 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
31680 66 72 65 65 28 63 6f 6e 63 68 46 69 6c 65 29 3b free(conchFile);
31690 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
316a0 65 33 5f 66 72 65 65 28 70 43 74 78 2d 3e 6c 6f e3_free(pCtx->lo
316b0 63 6b 50 72 6f 78 79 50 61 74 68 29 3b 0a 20 20 ckProxyPath);.
316c0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
316d0 43 74 78 2d 3e 63 6f 6e 63 68 46 69 6c 65 50 61 Ctx->conchFilePa
316e0 74 68 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 th);. sqlite3
316f0 5f 66 72 65 65 28 70 43 74 78 2d 3e 64 62 50 61 _free(pCtx->dbPa
31700 74 68 29 3b 0a 20 20 20 20 2f 2a 20 72 65 73 74 th);. /* rest
31710 6f 72 65 20 74 68 65 20 6f 72 69 67 69 6e 61 6c ore the original
31720 20 6c 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 locking context
31730 20 61 6e 64 20 70 4d 65 74 68 6f 64 20 74 68 65 and pMethod the
31740 6e 20 63 6c 6f 73 65 20 69 74 20 2a 2f 0a 20 20 n close it */.
31750 20 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 pFile->locking
31760 43 6f 6e 74 65 78 74 20 3d 20 70 43 74 78 2d 3e Context = pCtx->
31770 6f 6c 64 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 oldLockingContex
31780 74 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 70 4d t;. pFile->pM
31790 65 74 68 6f 64 20 3d 20 70 43 74 78 2d 3e 70 4f ethod = pCtx->pO
317a0 6c 64 4d 65 74 68 6f 64 3b 0a 20 20 20 20 73 71 ldMethod;. sq
317b0 6c 69 74 65 33 5f 66 72 65 65 28 70 43 74 78 29 lite3_free(pCtx)
317c0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 46 69 ;. return pFi
317d0 6c 65 2d 3e 70 4d 65 74 68 6f 64 2d 3e 78 43 6c le->pMethod->xCl
317e0 6f 73 65 28 69 64 29 3b 0a 20 20 7d 0a 20 20 72 ose(id);. }. r
317f0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
31800 0a 7d 0a 0a 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 .}....#endif /*
31810 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f defined(__APPLE_
31820 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 _) && SQLITE_ENA
31830 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c BLE_LOCKING_STYL
31840 45 20 2a 2f 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 E */./*.** The p
31850 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 73 74 79 roxy locking sty
31860 6c 65 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 le is intended f
31870 6f 72 20 75 73 65 20 77 69 74 68 20 41 46 50 20 or use with AFP
31880 66 69 6c 65 73 79 73 74 65 6d 73 2e 0a 2a 2a 20 filesystems..**
31890 41 6e 64 20 73 69 6e 63 65 20 41 46 50 20 69 73 And since AFP is
318a0 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 only supported
318b0 6f 6e 20 4d 61 63 4f 53 58 2c 20 74 68 65 20 70 on MacOSX, the p
318c0 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 69 73 20 roxy locking is
318d0 61 6c 73 6f 0a 2a 2a 20 72 65 73 74 72 69 63 74 also.** restrict
318e0 65 64 20 74 6f 20 4d 61 63 4f 53 58 2e 0a 2a 2a ed to MacOSX..**
318f0 20 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .**.***********
31900 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 ******** End of
31910 74 68 65 20 70 72 6f 78 79 20 6c 6f 63 6b 20 69 the proxy lock i
31920 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a mplementation **
31930 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
31940 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****.***********
31950 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
31960 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
31970 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
31980 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
31990 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 ***/../*.** Init
319a0 69 61 6c 69 7a 65 20 74 68 65 20 6f 70 65 72 61 ialize the opera
319b0 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65 ting system inte
319c0 72 66 61 63 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 rface..**.** Thi
319d0 73 20 72 6f 75 74 69 6e 65 20 72 65 67 69 73 74 s routine regist
319e0 65 72 73 20 61 6c 6c 20 56 46 53 20 69 6d 70 6c ers all VFS impl
319f0 65 6d 65 6e 74 61 74 69 6f 6e 73 20 66 6f 72 20 ementations for
31a00 75 6e 69 78 2d 6c 69 6b 65 20 6f 70 65 72 61 74 unix-like operat
31a10 69 6e 67 0a 2a 2a 20 73 79 73 74 65 6d 73 2e 20 ing.** systems.
31a20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 2c 20 61 This routine, a
31a30 6e 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6f nd the sqlite3_o
31a40 73 5f 65 6e 64 28 29 20 72 6f 75 74 69 6e 65 20 s_end() routine
31a50 74 68 61 74 20 66 6f 6c 6c 6f 77 73 2c 0a 2a 2a that follows,.**
31a60 20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6f should be the o
31a70 6e 6c 79 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 nly routines in
31a80 74 68 69 73 20 66 69 6c 65 20 74 68 61 74 20 61 this file that a
31a90 72 65 20 76 69 73 69 62 6c 65 20 66 72 6f 6d 20 re visible from
31aa0 6f 74 68 65 72 0a 2a 2a 20 66 69 6c 65 73 2e 0a other.** files..
31ab0 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
31ac0 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 63 ne is called onc
31ad0 65 20 64 75 72 69 6e 67 20 53 51 4c 69 74 65 20 e during SQLite
31ae0 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 61 initialization a
31af0 6e 64 20 62 79 20 61 0a 2a 2a 20 73 69 6e 67 6c nd by a.** singl
31b00 65 20 74 68 72 65 61 64 2e 20 20 54 68 65 20 6d e thread. The m
31b10 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
31b20 20 61 6e 64 20 6d 75 74 65 78 20 73 75 62 73 79 and mutex subsy
31b30 73 74 65 6d 73 20 68 61 76 65 20 6e 6f 74 0a 2a stems have not.*
31b40 2a 20 6e 65 63 65 73 73 61 72 69 6c 79 20 62 65 * necessarily be
31b50 65 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 77 en initialized w
31b60 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 hen this routine
31b70 20 69 73 20 63 61 6c 6c 65 64 2c 20 61 6e 64 20 is called, and
31b80 73 6f 20 74 68 65 79 0a 2a 2a 20 73 68 6f 75 6c so they.** shoul
31b90 64 20 6e 6f 74 20 62 65 20 75 73 65 64 2e 0a 2a d not be used..*
31ba0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 73 /.int sqlite3_os
31bb0 5f 69 6e 69 74 28 76 6f 69 64 29 7b 20 0a 20 20 _init(void){ .
31bc0 2f 2a 20 0a 20 20 2a 2a 20 54 68 65 20 66 6f 6c /* . ** The fol
31bd0 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 64 65 66 lowing macro def
31be0 69 6e 65 73 20 61 6e 20 69 6e 69 74 69 61 6c 69 ines an initiali
31bf0 7a 65 72 20 66 6f 72 20 61 6e 20 73 71 6c 69 74 zer for an sqlit
31c00 65 33 5f 76 66 73 20 6f 62 6a 65 63 74 2e 0a 20 e3_vfs object..
31c10 20 2a 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 ** The name of
31c20 74 68 65 20 56 46 53 20 69 73 20 4e 41 4d 45 2e the VFS is NAME.
31c30 20 20 54 68 65 20 70 41 70 70 44 61 74 61 20 69 The pAppData i
31c40 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 s a pointer to a
31c50 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 74 6f pointer. ** to
31c60 20 74 68 65 20 22 66 69 6e 64 65 72 22 20 66 75 the "finder" fu
31c70 6e 63 74 69 6f 6e 2e 20 20 28 70 41 70 70 44 61 nction. (pAppDa
31c80 74 61 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 ta is a pointer
31c90 74 6f 20 61 20 70 6f 69 6e 74 65 72 20 62 65 63 to a pointer bec
31ca0 61 75 73 65 0a 20 20 2a 2a 20 73 69 6c 6c 79 20 ause. ** silly
31cb0 43 39 30 20 72 75 6c 65 73 20 70 72 6f 68 69 62 C90 rules prohib
31cc0 69 74 20 61 20 76 6f 69 64 2a 20 66 72 6f 6d 20 it a void* from
31cd0 62 65 69 6e 67 20 63 61 73 74 20 74 6f 20 61 20 being cast to a
31ce0 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 function pointer
31cf0 0a 20 20 2a 2a 20 61 6e 64 20 73 6f 20 77 65 20 . ** and so we
31d00 68 61 76 65 20 74 6f 20 67 6f 20 74 68 72 6f 75 have to go throu
31d10 67 68 20 74 68 65 20 69 6e 74 65 72 6d 65 64 69 gh the intermedi
31d20 61 74 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 ate pointer to a
31d30 76 6f 69 64 20 70 72 6f 62 6c 65 6d 73 0a 20 20 void problems.
31d40 2a 2a 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e ** when compilin
31d50 67 20 77 69 74 68 20 2d 70 65 64 61 6e 74 69 63 g with -pedantic
31d60 2d 65 72 72 6f 72 73 20 6f 6e 20 47 43 43 2e 29 -errors on GCC.)
31d70 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 46 . **. ** The F
31d80 49 4e 44 45 52 20 70 61 72 61 6d 65 74 65 72 20 INDER parameter
31d90 74 6f 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 to this macro is
31da0 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
31db0 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 0a pointer to the.
31dc0 20 20 2a 2a 20 66 69 6e 64 65 72 2d 66 75 6e 63 ** finder-func
31dd0 74 69 6f 6e 2e 20 20 54 68 65 20 66 69 6e 64 65 tion. The finde
31de0 72 2d 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 r-function retur
31df0 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 ns a pointer to
31e00 74 68 65 0a 20 20 2a 2a 20 73 71 6c 69 74 65 5f the. ** sqlite_
31e10 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 io_methods objec
31e20 74 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 t that implement
31e30 73 20 74 68 65 20 64 65 73 69 72 65 64 20 6c 6f s the desired lo
31e40 63 6b 69 6e 67 0a 20 20 2a 2a 20 62 65 68 61 76 cking. ** behav
31e50 69 6f 72 73 2e 20 20 53 65 65 20 74 68 65 20 64 iors. See the d
31e60 69 76 69 73 69 6f 6e 20 61 62 6f 76 65 20 74 68 ivision above th
31e70 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 at contains the
31e80 49 4f 4d 45 54 48 4f 44 53 0a 20 20 2a 2a 20 6d IOMETHODS. ** m
31e90 61 63 72 6f 20 66 6f 72 20 61 64 64 69 74 69 6f acro for additio
31ea0 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e n information on
31eb0 20 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e finder-function
31ec0 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4d 6f 73 s.. **. ** Mos
31ed0 74 20 66 69 6e 64 65 72 73 20 73 69 6d 70 6c 79 t finders simply
31ee0 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 return a pointe
31ef0 72 20 74 6f 20 61 20 66 69 78 65 64 20 73 71 6c r to a fixed sql
31f00 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a ite3_io_methods.
31f10 20 20 2a 2a 20 6f 62 6a 65 63 74 2e 20 20 42 75 ** object. Bu
31f20 74 20 74 68 65 20 22 61 75 74 6f 6c 6f 63 6b 49 t the "autolockI
31f30 6f 46 69 6e 64 65 72 22 20 61 76 61 69 6c 61 62 oFinder" availab
31f40 6c 65 20 6f 6e 20 4d 61 63 4f 53 58 20 64 6f 65 le on MacOSX doe
31f50 73 20 61 20 6c 69 74 74 6c 65 0a 20 20 2a 2a 20 s a little. **
31f60 6d 6f 72 65 20 74 68 61 6e 20 74 68 61 74 3b 20 more than that;
31f70 69 74 20 6c 6f 6f 6b 73 20 61 74 20 74 68 65 20 it looks at the
31f80 66 69 6c 65 73 79 73 74 65 6d 20 74 79 70 65 20 filesystem type
31f90 74 68 61 74 20 68 6f 73 74 73 20 74 68 65 20 0a that hosts the .
31fa0 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 ** database fi
31fb0 6c 65 20 61 6e 64 20 74 72 69 65 73 20 74 6f 20 le and tries to
31fc0 63 68 6f 6f 73 65 20 61 6e 20 6c 6f 63 6b 69 6e choose an lockin
31fd0 67 20 6d 65 74 68 6f 64 20 61 70 70 72 6f 70 72 g method appropr
31fe0 69 61 74 65 20 66 6f 72 0a 20 20 2a 2a 20 74 68 iate for. ** th
31ff0 61 74 20 66 69 6c 65 73 79 73 74 65 6d 20 74 69 at filesystem ti
32000 6d 65 2e 0a 20 20 2a 2f 0a 20 20 23 64 65 66 69 me.. */. #defi
32010 6e 65 20 55 4e 49 58 56 46 53 28 56 46 53 4e 41 ne UNIXVFS(VFSNA
32020 4d 45 2c 20 46 49 4e 44 45 52 29 20 7b 20 20 20 ME, FINDER) {
32030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32040 20 20 20 20 20 5c 0a 20 20 20 20 32 2c 20 20 20 \. 2,
32050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32060 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a 2f 20 /* iVersion */
32070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32080 20 20 20 5c 0a 20 20 20 20 73 69 7a 65 6f 66 28 \. sizeof(
32090 75 6e 69 78 46 69 6c 65 29 2c 20 20 20 20 20 2f unixFile), /
320a0 2a 20 73 7a 4f 73 46 69 6c 65 20 2a 2f 20 20 20 * szOsFile */
320b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
320c0 20 5c 0a 20 20 20 20 4d 41 58 5f 50 41 54 48 4e \. MAX_PATHN
320d0 41 4d 45 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 AME, /*
320e0 6d 78 50 61 74 68 6e 61 6d 65 20 2a 2f 20 20 20 mxPathname */
320f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
32100 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20 . 0,
32110 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 4e /* pN
32120 65 78 74 20 2a 2f 20 20 20 20 20 20 20 20 20 20 ext */
32130 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
32140 20 20 20 56 46 53 4e 41 4d 45 2c 20 20 20 20 20 VFSNAME,
32150 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 4e 61 6d /* zNam
32160 65 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 e */
32170 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
32180 20 28 76 6f 69 64 2a 29 26 46 49 4e 44 45 52 2c (void*)&FINDER,
32190 20 20 20 20 20 20 20 2f 2a 20 70 41 70 70 44 61 /* pAppDa
321a0 74 61 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 ta */
321b0 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20 75 \. u
321c0 6e 69 78 4f 70 65 6e 2c 20 20 20 20 20 20 20 20 nixOpen,
321d0 20 20 20 20 20 2f 2a 20 78 4f 70 65 6e 20 2a 2f /* xOpen */
321e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
321f0 20 20 20 20 20 20 20 5c 0a 20 20 20 20 75 6e 69 \. uni
32200 78 44 65 6c 65 74 65 2c 20 20 20 20 20 20 20 20 xDelete,
32210 20 20 20 2f 2a 20 78 44 65 6c 65 74 65 20 2a 2f /* xDelete */
32220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32230 20 20 20 20 20 5c 0a 20 20 20 20 75 6e 69 78 41 \. unixA
32240 63 63 65 73 73 2c 20 20 20 20 20 20 20 20 20 20 ccess,
32250 20 2f 2a 20 78 41 63 63 65 73 73 20 2a 2f 20 20 /* xAccess */
32260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32270 20 20 20 5c 0a 20 20 20 20 75 6e 69 78 46 75 6c \. unixFul
32280 6c 50 61 74 68 6e 61 6d 65 2c 20 20 20 20 20 2f lPathname, /
32290 2a 20 78 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 * xFullPathname
322a0 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
322b0 20 5c 0a 20 20 20 20 75 6e 69 78 44 6c 4f 70 65 \. unixDlOpe
322c0 6e 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 n, /*
322d0 78 44 6c 4f 70 65 6e 20 2a 2f 20 20 20 20 20 20 xDlOpen */
322e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
322f0 0a 20 20 20 20 75 6e 69 78 44 6c 45 72 72 6f 72 . unixDlError
32300 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 , /* xD
32310 6c 45 72 72 6f 72 20 2a 2f 20 20 20 20 20 20 20 lError */
32320 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
32330 20 20 20 75 6e 69 78 44 6c 53 79 6d 2c 20 20 20 unixDlSym,
32340 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 53 /* xDlS
32350 79 6d 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 ym */
32360 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
32370 20 75 6e 69 78 44 6c 43 6c 6f 73 65 2c 20 20 20 unixDlClose,
32380 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 43 6c 6f /* xDlClo
32390 73 65 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 se */
323a0 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20 75 \. u
323b0 6e 69 78 52 61 6e 64 6f 6d 6e 65 73 73 2c 20 20 nixRandomness,
323c0 20 20 20 20 20 2f 2a 20 78 52 61 6e 64 6f 6d 6e /* xRandomn
323d0 65 73 73 20 2a 2f 20 20 20 20 20 20 20 20 20 20 ess */
323e0 20 20 20 20 20 20 20 5c 0a 20 20 20 20 75 6e 69 \. uni
323f0 78 53 6c 65 65 70 2c 20 20 20 20 20 20 20 20 20 xSleep,
32400 20 20 20 2f 2a 20 78 53 6c 65 65 70 20 2a 2f 20 /* xSleep */
32410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32420 20 20 20 20 20 5c 0a 20 20 20 20 75 6e 69 78 43 \. unixC
32430 75 72 72 65 6e 74 54 69 6d 65 2c 20 20 20 20 20 urrentTime,
32440 20 2f 2a 20 78 43 75 72 72 65 6e 74 54 69 6d 65 /* xCurrentTime
32450 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 */
32460 20 20 20 5c 0a 20 20 20 20 75 6e 69 78 47 65 74 \. unixGet
32470 4c 61 73 74 45 72 72 6f 72 2c 20 20 20 20 20 2f LastError, /
32480 2a 20 78 47 65 74 4c 61 73 74 45 72 72 6f 72 20 * xGetLastError
32490 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
324a0 20 5c 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 \. 0,
324b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
324c0 78 52 65 6e 61 6d 65 20 2a 2f 20 20 20 20 20 20 xRename */
324d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
324e0 0a 20 20 20 20 75 6e 69 78 43 75 72 72 65 6e 74 . unixCurrent
324f0 54 69 6d 65 49 6e 74 36 34 2c 20 2f 2a 20 78 43 TimeInt64, /* xC
32500 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36 34 20 urrentTimeInt64
32510 2a 2f 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 */ \.
32520 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 41 6c }.. /*. ** Al
32530 6c 20 64 65 66 61 75 6c 74 20 56 46 53 65 73 20 l default VFSes
32540 66 6f 72 20 75 6e 69 78 20 61 72 65 20 63 6f 6e for unix are con
32550 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 66 6f tained in the fo
32560 6c 6c 6f 77 69 6e 67 20 61 72 72 61 79 2e 0a 20 llowing array..
32570 20 2a 2a 0a 20 20 2a 2a 20 4e 6f 74 65 20 74 68 **. ** Note th
32580 61 74 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 at the sqlite3_v
32590 66 73 2e 70 4e 65 78 74 20 66 69 65 6c 64 20 6f fs.pNext field o
325a0 66 20 74 68 65 20 56 46 53 20 6f 62 6a 65 63 74 f the VFS object
325b0 20 69 73 20 6d 6f 64 69 66 69 65 64 0a 20 20 2a is modified. *
325c0 2a 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 * by the SQLite
325d0 63 6f 72 65 20 77 68 65 6e 20 74 68 65 20 56 46 core when the VF
325e0 53 20 69 73 20 72 65 67 69 73 74 65 72 65 64 2e S is registered.
325f0 20 20 53 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 So the followi
32600 6e 67 0a 20 20 2a 2a 20 61 72 72 61 79 20 63 61 ng. ** array ca
32610 6e 6e 6f 74 20 62 65 20 63 6f 6e 73 74 2e 0a 20 nnot be const..
32620 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 73 71 6c */. static sql
32630 69 74 65 33 5f 76 66 73 20 61 56 66 73 5b 5d 20 ite3_vfs aVfs[]
32640 3d 20 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 = {.#if SQLITE_E
32650 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
32660 59 4c 45 20 26 26 20 28 4f 53 5f 56 58 57 4f 52 YLE && (OS_VXWOR
32670 4b 53 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f KS || defined(__
32680 41 50 50 4c 45 5f 5f 29 29 0a 20 20 20 20 55 4e APPLE__)). UN
32690 49 58 56 46 53 28 22 75 6e 69 78 22 2c 20 20 20 IXVFS("unix",
326a0 20 20 20 20 20 20 20 61 75 74 6f 6c 6f 63 6b 49 autolockI
326b0 6f 46 69 6e 64 65 72 20 29 2c 0a 23 65 6c 73 65 oFinder ),.#else
326c0 0a 20 20 20 20 55 4e 49 58 56 46 53 28 22 75 6e . UNIXVFS("un
326d0 69 78 22 2c 20 20 20 20 20 20 20 20 20 20 70 6f ix", po
326e0 73 69 78 49 6f 46 69 6e 64 65 72 20 29 2c 0a 23 sixIoFinder ),.#
326f0 65 6e 64 69 66 0a 20 20 20 20 55 4e 49 58 56 46 endif. UNIXVF
32700 53 28 22 75 6e 69 78 2d 6e 6f 6e 65 22 2c 20 20 S("unix-none",
32710 20 20 20 6e 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 nolockIoFinde
32720 72 20 29 2c 0a 20 20 20 20 55 4e 49 58 56 46 53 r ),. UNIXVFS
32730 28 22 75 6e 69 78 2d 64 6f 74 66 69 6c 65 22 2c ("unix-dotfile",
32740 20 20 64 6f 74 6c 6f 63 6b 49 6f 46 69 6e 64 65 dotlockIoFinde
32750 72 20 29 2c 0a 23 69 66 20 4f 53 5f 56 58 57 4f r ),.#if OS_VXWO
32760 52 4b 53 0a 20 20 20 20 55 4e 49 58 56 46 53 28 RKS. UNIXVFS(
32770 22 75 6e 69 78 2d 6e 61 6d 65 64 73 65 6d 22 2c "unix-namedsem",
32780 20 73 65 6d 49 6f 46 69 6e 64 65 72 20 29 2c 0a semIoFinder ),.
32790 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
327a0 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
327b0 5f 53 54 59 4c 45 0a 20 20 20 20 55 4e 49 58 56 _STYLE. UNIXV
327c0 46 53 28 22 75 6e 69 78 2d 70 6f 73 69 78 22 2c FS("unix-posix",
327d0 20 20 20 20 70 6f 73 69 78 49 6f 46 69 6e 64 65 posixIoFinde
327e0 72 20 29 2c 0a 23 69 66 20 21 4f 53 5f 56 58 57 r ),.#if !OS_VXW
327f0 4f 52 4b 53 0a 20 20 20 20 55 4e 49 58 56 46 53 ORKS. UNIXVFS
32800 28 22 75 6e 69 78 2d 66 6c 6f 63 6b 22 2c 20 20 ("unix-flock",
32810 20 20 66 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 20 flockIoFinder
32820 29 2c 0a 23 65 6e 64 69 66 0a 23 65 6e 64 69 66 ),.#endif.#endif
32830 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 .#if SQLITE_ENAB
32840 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
32850 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 && defined(__AP
32860 50 4c 45 5f 5f 29 0a 20 20 20 20 55 4e 49 58 56 PLE__). UNIXV
32870 46 53 28 22 75 6e 69 78 2d 61 66 70 22 2c 20 20 FS("unix-afp",
32880 20 20 20 20 61 66 70 49 6f 46 69 6e 64 65 72 20 afpIoFinder
32890 29 2c 0a 20 20 20 20 55 4e 49 58 56 46 53 28 22 ),. UNIXVFS("
328a0 75 6e 69 78 2d 6e 66 73 22 2c 20 20 20 20 20 20 unix-nfs",
328b0 6e 66 73 49 6f 46 69 6e 64 65 72 20 29 2c 0a 20 nfsIoFinder ),.
328c0 20 20 20 55 4e 49 58 56 46 53 28 22 75 6e 69 78 UNIXVFS("unix
328d0 2d 70 72 6f 78 79 22 2c 20 20 20 20 70 72 6f 78 -proxy", prox
328e0 79 49 6f 46 69 6e 64 65 72 20 29 2c 0a 23 65 6e yIoFinder ),.#en
328f0 64 69 66 0a 20 20 7d 3b 0a 20 20 75 6e 73 69 67 dif. };. unsig
32900 6e 65 64 20 69 6e 74 20 69 3b 20 20 20 20 20 20 ned int i;
32910 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
32920 74 65 72 20 2a 2f 0a 0a 20 20 2f 2a 20 52 65 67 ter */.. /* Reg
32930 69 73 74 65 72 20 61 6c 6c 20 56 46 53 65 73 20 ister all VFSes
32940 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 61 defined in the a
32950 56 66 73 5b 5d 20 61 72 72 61 79 20 2a 2f 0a 20 Vfs[] array */.
32960 20 66 6f 72 28 69 3d 30 3b 20 69 3c 28 73 69 7a for(i=0; i<(siz
32970 65 6f 66 28 61 56 66 73 29 2f 73 69 7a 65 6f 66 eof(aVfs)/sizeof
32980 28 73 71 6c 69 74 65 33 5f 76 66 73 29 29 3b 20 (sqlite3_vfs));
32990 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 i++){. sqlite
329a0 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 26 3_vfs_register(&
329b0 61 56 66 73 5b 69 5d 2c 20 69 3d 3d 30 29 3b 0a aVfs[i], i==0);.
329c0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
329d0 49 54 45 5f 4f 4b 3b 20 0a 7d 0a 0a 2f 2a 0a 2a ITE_OK; .}../*.*
329e0 2a 20 53 68 75 74 64 6f 77 6e 20 74 68 65 20 6f * Shutdown the o
329f0 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 perating system
32a00 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2a 0a 2a 2a interface..**.**
32a10 20 53 6f 6d 65 20 6f 70 65 72 61 74 69 6e 67 20 Some operating
32a20 73 79 73 74 65 6d 73 20 6d 69 67 68 74 20 6e 65 systems might ne
32a30 65 64 20 74 6f 20 64 6f 20 73 6f 6d 65 20 63 6c ed to do some cl
32a40 65 61 6e 75 70 20 69 6e 20 74 68 69 73 20 72 6f eanup in this ro
32a50 75 74 69 6e 65 2c 0a 2a 2a 20 74 6f 20 72 65 6c utine,.** to rel
32a60 65 61 73 65 20 64 79 6e 61 6d 69 63 61 6c 6c 79 ease dynamically
32a70 20 61 6c 6c 6f 63 61 74 65 64 20 6f 62 6a 65 63 allocated objec
32a80 74 73 2e 20 20 42 75 74 20 6e 6f 74 20 6f 6e 20 ts. But not on
32a90 75 6e 69 78 2e 0a 2a 2a 20 54 68 69 73 20 72 6f unix..** This ro
32aa0 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
32ab0 20 66 6f 72 20 75 6e 69 78 2e 0a 2a 2f 0a 69 6e for unix..*/.in
32ac0 74 20 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 t sqlite3_os_end
32ad0 28 76 6f 69 64 29 7b 20 0a 20 20 72 65 74 75 72 (void){ . retur
32ae0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 0a 7d 0a n SQLITE_OK; .}.
32af0 20 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 .#endif /* SQLI
32b00 54 45 5f 4f 53 5f 55 4e 49 58 20 2a 2f 0a TE_OS_UNIX */.