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 20 55 73 65 20 70 72 65 61 64 28 f../* Use pread(
0b40: 29 20 61 6e 64 20 70 77 72 69 74 65 28 29 20 69 ) and pwrite() i
0b50: 66 20 74 68 65 79 20 61 72 65 20 61 76 61 69 6c f they are avail
0b60: 61 62 6c 65 20 2a 2f 0a 23 69 66 20 64 65 66 69 able */.#if defi
0b70: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 23 ned(__APPLE__).#
0b80: 20 64 65 66 69 6e 65 20 48 41 56 45 5f 50 52 45 define HAVE_PRE
0b90: 41 44 20 31 0a 23 20 64 65 66 69 6e 65 20 48 41 AD 1.# define HA
0ba0: 56 45 5f 50 57 52 49 54 45 20 31 0a 23 65 6e 64 VE_PWRITE 1.#end
0bb0: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 48 if.#if defined(H
0bc0: 41 56 45 5f 50 52 45 41 44 36 34 29 20 26 26 20 AVE_PREAD64) &&
0bd0: 64 65 66 69 6e 65 64 28 48 41 56 45 5f 50 57 52 defined(HAVE_PWR
0be0: 49 54 45 36 34 29 0a 23 20 75 6e 64 65 66 20 55 ITE64).# undef U
0bf0: 53 45 5f 50 52 45 41 44 0a 23 20 64 65 66 69 6e SE_PREAD.# defin
0c00: 65 20 55 53 45 5f 50 52 45 41 44 36 34 20 31 0a e USE_PREAD64 1.
0c10: 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 48 41 #elif defined(HA
0c20: 56 45 5f 50 52 45 41 44 29 20 26 26 20 64 65 66 VE_PREAD) && def
0c30: 69 6e 65 64 28 48 41 56 45 5f 50 57 52 49 54 45 ined(HAVE_PWRITE
0c40: 29 0a 23 20 75 6e 64 65 66 20 55 53 45 5f 50 52 ).# undef USE_PR
0c50: 45 41 44 36 34 0a 23 20 64 65 66 69 6e 65 20 55 EAD64.# define U
0c60: 53 45 5f 50 52 45 41 44 20 31 0a 23 65 6e 64 69 SE_PREAD 1.#endi
0c70: 66 0a 0a 2f 2a 0a 2a 2a 20 73 74 61 6e 64 61 72 f../*.** standar
0c80: 64 20 69 6e 63 6c 75 64 65 20 66 69 6c 65 73 2e d include files.
0c90: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c 73 79 .*/.#include <sy
0ca0: 73 2f 74 79 70 65 73 2e 68 3e 0a 23 69 6e 63 6c s/types.h>.#incl
0cb0: 75 64 65 20 3c 73 79 73 2f 73 74 61 74 2e 68 3e ude <sys/stat.h>
0cc0: 0a 23 69 6e 63 6c 75 64 65 20 3c 66 63 6e 74 6c .#include <fcntl
0cd0: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 75 6e .h>.#include <un
0ce0: 69 73 74 64 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 istd.h>.#include
0cf0: 20 3c 74 69 6d 65 2e 68 3e 0a 23 69 6e 63 6c 75 <time.h>.#inclu
0d00: 64 65 20 3c 73 79 73 2f 74 69 6d 65 2e 68 3e 0a de <sys/time.h>.
0d10: 23 69 6e 63 6c 75 64 65 20 3c 65 72 72 6e 6f 2e #include <errno.
0d20: 68 3e 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 h>.#if !defined(
0d30: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 SQLITE_OMIT_WAL)
0d40: 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d || SQLITE_MAX_M
0d50: 4d 41 50 5f 53 49 5a 45 3e 30 0a 23 20 69 6e 63 MAP_SIZE>0.# inc
0d60: 6c 75 64 65 20 3c 73 79 73 2f 6d 6d 61 6e 2e 68 lude <sys/mman.h
0d70: 3e 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51 >.#endif..#if SQ
0d80: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b LITE_ENABLE_LOCK
0d90: 49 4e 47 5f 53 54 59 4c 45 0a 23 20 69 6e 63 6c ING_STYLE.# incl
0da0: 75 64 65 20 3c 73 79 73 2f 69 6f 63 74 6c 2e 68 ude <sys/ioctl.h
0db0: 3e 0a 23 20 69 6e 63 6c 75 64 65 20 3c 73 79 73 >.# include <sys
0dc0: 2f 66 69 6c 65 2e 68 3e 0a 23 20 69 6e 63 6c 75 /file.h>.# inclu
0dd0: 64 65 20 3c 73 79 73 2f 70 61 72 61 6d 2e 68 3e de <sys/param.h>
0de0: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
0df0: 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
0e00: 5f 53 54 59 4c 45 20 2a 2f 0a 0a 23 69 66 20 64 _STYLE */..#if d
0e10: 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
0e20: 29 20 26 26 20 28 28 5f 5f 4d 41 43 5f 4f 53 5f ) && ((__MAC_OS_
0e30: 58 5f 56 45 52 53 49 4f 4e 5f 4d 49 4e 5f 52 45 X_VERSION_MIN_RE
0e40: 51 55 49 52 45 44 20 3e 20 31 30 35 30 29 20 7c QUIRED > 1050) |
0e50: 7c 20 5c 0a 20 20 20 20 20 20 20 20 20 20 20 20 | \.
0e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 (
0e70: 5f 5f 49 50 48 4f 4e 45 5f 4f 53 5f 56 45 52 53 __IPHONE_OS_VERS
0e80: 49 4f 4e 5f 4d 49 4e 5f 52 45 51 55 49 52 45 44 ION_MIN_REQUIRED
0e90: 20 3e 20 32 30 30 30 29 29 0a 23 20 20 69 66 20 > 2000)).# if
0ea0: 28 21 64 65 66 69 6e 65 64 28 54 41 52 47 45 54 (!defined(TARGET
0eb0: 5f 4f 53 5f 45 4d 42 45 44 44 45 44 29 20 7c 7c _OS_EMBEDDED) ||
0ec0: 20 28 54 41 52 47 45 54 5f 4f 53 5f 45 4d 42 45 (TARGET_OS_EMBE
0ed0: 44 44 45 44 3d 3d 30 29 29 20 5c 0a 20 20 20 20 DDED==0)) \.
0ee0: 20 20 20 26 26 20 28 21 64 65 66 69 6e 65 64 28 && (!defined(
0ef0: 54 41 52 47 45 54 5f 49 50 48 4f 4e 45 5f 53 49 TARGET_IPHONE_SI
0f00: 4d 55 4c 41 54 4f 52 29 20 7c 7c 20 28 54 41 52 MULATOR) || (TAR
0f10: 47 45 54 5f 49 50 48 4f 4e 45 5f 53 49 4d 55 4c GET_IPHONE_SIMUL
0f20: 41 54 4f 52 3d 3d 30 29 29 0a 23 20 20 20 20 64 ATOR==0)).# d
0f30: 65 66 69 6e 65 20 48 41 56 45 5f 47 45 54 48 4f efine HAVE_GETHO
0f40: 53 54 55 55 49 44 20 31 0a 23 20 20 65 6c 73 65 STUUID 1.# else
0f50: 0a 23 20 20 20 20 77 61 72 6e 69 6e 67 20 22 67 .# warning "g
0f60: 65 74 68 6f 73 74 75 75 69 64 28 29 20 69 73 20 ethostuuid() is
0f70: 64 69 73 61 62 6c 65 64 2e 22 0a 23 20 20 65 6e disabled.".# en
0f80: 64 69 66 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 dif.#endif...#if
0f90: 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 23 20 69 6e OS_VXWORKS.# in
0fa0: 63 6c 75 64 65 20 3c 73 79 73 2f 69 6f 63 74 6c clude <sys/ioctl
0fb0: 2e 68 3e 0a 23 20 69 6e 63 6c 75 64 65 20 3c 73 .h>.# include <s
0fc0: 65 6d 61 70 68 6f 72 65 2e 68 3e 0a 23 20 69 6e emaphore.h>.# in
0fd0: 63 6c 75 64 65 20 3c 6c 69 6d 69 74 73 2e 68 3e clude <limits.h>
0fe0: 0a 23 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 .#endif /* OS_VX
0ff0: 57 4f 52 4b 53 20 2a 2f 0a 0a 23 69 66 20 64 65 WORKS */..#if de
1000: 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
1010: 20 7c 7c 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c || SQLITE_ENABL
1020: 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a E_LOCKING_STYLE.
1030: 23 20 69 6e 63 6c 75 64 65 20 3c 73 79 73 2f 6d # include <sys/m
1040: 6f 75 6e 74 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a ount.h>.#endif..
1050: 23 69 66 64 65 66 20 48 41 56 45 5f 55 54 49 4d #ifdef HAVE_UTIM
1060: 45 0a 23 20 69 6e 63 6c 75 64 65 20 3c 75 74 69 E.# include <uti
1070: 6d 65 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a me.h>.#endif../*
1080: 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 .** Allowed valu
1090: 65 73 20 6f 66 20 75 6e 69 78 46 69 6c 65 2e 66 es of unixFile.f
10a0: 73 46 6c 61 67 73 0a 2a 2f 0a 23 64 65 66 69 6e sFlags.*/.#defin
10b0: 65 20 53 51 4c 49 54 45 5f 46 53 46 4c 41 47 53 e SQLITE_FSFLAGS
10c0: 5f 49 53 5f 4d 53 44 4f 53 20 20 20 20 20 30 78 _IS_MSDOS 0x
10d0: 31 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77 65 20 61 1../*.** If we a
10e0: 72 65 20 74 6f 20 62 65 20 74 68 72 65 61 64 2d re to be thread-
10f0: 73 61 66 65 2c 20 69 6e 63 6c 75 64 65 20 74 68 safe, include th
1100: 65 20 70 74 68 72 65 61 64 73 20 68 65 61 64 65 e pthreads heade
1110: 72 20 61 6e 64 20 64 65 66 69 6e 65 0a 2a 2a 20 r and define.**
1120: 74 68 65 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f the SQLITE_UNIX_
1130: 54 48 52 45 41 44 53 20 6d 61 63 72 6f 2e 0a 2a THREADS macro..*
1140: 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52 /.#if SQLITE_THR
1150: 45 41 44 53 41 46 45 0a 23 20 69 6e 63 6c 75 64 EADSAFE.# includ
1160: 65 20 3c 70 74 68 72 65 61 64 2e 68 3e 0a 23 20 e <pthread.h>.#
1170: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 4e define SQLITE_UN
1180: 49 58 5f 54 48 52 45 41 44 53 20 31 0a 23 65 6e IX_THREADS 1.#en
1190: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 61 75 dif../*.** Defau
11a0: 6c 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 77 lt permissions w
11b0: 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20 6e hen creating a n
11c0: 65 77 20 66 69 6c 65 0a 2a 2f 0a 23 69 66 6e 64 ew file.*/.#ifnd
11d0: 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ef SQLITE_DEFAUL
11e0: 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f T_FILE_PERMISSIO
11f0: 4e 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 NS.# define SQLI
1200: 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f TE_DEFAULT_FILE_
1210: 50 45 52 4d 49 53 53 49 4f 4e 53 20 30 36 34 34 PERMISSIONS 0644
1220: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 .#endif../*.** D
1230: 65 66 61 75 6c 74 20 70 65 72 6d 69 73 73 69 6f efault permissio
1240: 6e 73 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 ns when creating
1250: 20 61 75 74 6f 20 70 72 6f 78 79 20 64 69 72 0a auto proxy dir.
1260: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
1270: 45 5f 44 45 46 41 55 4c 54 5f 50 52 4f 58 59 44 E_DEFAULT_PROXYD
1280: 49 52 5f 50 45 52 4d 49 53 53 49 4f 4e 53 0a 23 IR_PERMISSIONS.#
1290: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
12a0: 45 46 41 55 4c 54 5f 50 52 4f 58 59 44 49 52 5f EFAULT_PROXYDIR_
12b0: 50 45 52 4d 49 53 53 49 4f 4e 53 20 30 37 35 35 PERMISSIONS 0755
12c0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d .#endif../*.** M
12d0: 61 78 69 6d 75 6d 20 73 75 70 70 6f 72 74 65 64 aximum supported
12e0: 20 70 61 74 68 2d 6c 65 6e 67 74 68 2e 0a 2a 2f path-length..*/
12f0: 0a 23 64 65 66 69 6e 65 20 4d 41 58 5f 50 41 54 .#define MAX_PAT
1300: 48 4e 41 4d 45 20 35 31 32 0a 0a 2f 2a 0a 2a 2a HNAME 512../*.**
1310: 20 4d 61 78 69 6d 75 6d 20 73 75 70 70 6f 72 74 Maximum support
1320: 65 64 20 73 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b ed symbolic link
1330: 73 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s.*/.#define SQL
1340: 49 54 45 5f 4d 41 58 5f 53 59 4d 4c 49 4e 4b 53 ITE_MAX_SYMLINKS
1350: 20 31 30 30 0a 0a 2f 2a 20 41 6c 77 61 79 73 20 100../* Always
1360: 63 61 73 74 20 74 68 65 20 67 65 74 70 69 64 28 cast the getpid(
1370: 29 20 72 65 74 75 72 6e 20 74 79 70 65 20 66 6f ) return type fo
1380: 72 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 r compatibility
1390: 77 69 74 68 0a 2a 2a 20 6b 65 72 6e 65 6c 20 6d with.** kernel m
13a0: 6f 64 75 6c 65 73 20 69 6e 20 56 78 57 6f 72 6b odules in VxWork
13b0: 73 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 6f 73 s. */.#define os
13c0: 47 65 74 70 69 64 28 58 29 20 28 70 69 64 5f 74 Getpid(X) (pid_t
13d0: 29 67 65 74 70 69 64 28 29 0a 0a 2f 2a 0a 2a 2a )getpid()../*.**
13e0: 20 4f 6e 6c 79 20 73 65 74 20 74 68 65 20 6c 61 Only set the la
13f0: 73 74 45 72 72 6e 6f 20 69 66 20 74 68 65 20 65 stErrno if the e
1400: 72 72 6f 72 20 63 6f 64 65 20 69 73 20 61 20 72 rror code is a r
1410: 65 61 6c 20 65 72 72 6f 72 20 61 6e 64 20 6e 6f eal error and no
1420: 74 20 0a 2a 2a 20 61 20 6e 6f 72 6d 61 6c 20 65 t .** a normal e
1430: 78 70 65 63 74 65 64 20 72 65 74 75 72 6e 20 63 xpected return c
1440: 6f 64 65 20 6f 66 20 53 51 4c 49 54 45 5f 42 55 ode of SQLITE_BU
1450: 53 59 20 6f 72 20 53 51 4c 49 54 45 5f 4f 4b 0a SY or SQLITE_OK.
1460: 2a 2f 0a 23 64 65 66 69 6e 65 20 49 53 5f 4c 4f */.#define IS_LO
1470: 43 4b 5f 45 52 52 4f 52 28 78 29 20 20 28 28 78 CK_ERROR(x) ((x
1480: 20 21 3d 20 53 51 4c 49 54 45 5f 4f 4b 29 20 26 != SQLITE_OK) &
1490: 26 20 28 78 20 21 3d 20 53 51 4c 49 54 45 5f 42 & (x != SQLITE_B
14a0: 55 53 59 29 29 0a 0a 2f 2a 20 46 6f 72 77 61 72 USY))../* Forwar
14b0: 64 20 72 65 66 65 72 65 6e 63 65 73 20 2a 2f 0a d references */.
14c0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 75 typedef struct u
14d0: 6e 69 78 53 68 6d 20 75 6e 69 78 53 68 6d 3b 20 nixShm unixShm;
14e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
14f0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 73 68 61 72 Connection shar
1500: 65 64 20 6d 65 6d 6f 72 79 20 2a 2f 0a 74 79 70 ed memory */.typ
1510: 65 64 65 66 20 73 74 72 75 63 74 20 75 6e 69 78 edef struct unix
1520: 53 68 6d 4e 6f 64 65 20 75 6e 69 78 53 68 6d 4e ShmNode unixShmN
1530: 6f 64 65 3b 20 20 20 20 20 20 20 2f 2a 20 53 68 ode; /* Sh
1540: 61 72 65 64 20 6d 65 6d 6f 72 79 20 69 6e 73 74 ared memory inst
1550: 61 6e 63 65 20 2a 2f 0a 74 79 70 65 64 65 66 20 ance */.typedef
1560: 73 74 72 75 63 74 20 75 6e 69 78 49 6e 6f 64 65 struct unixInode
1570: 49 6e 66 6f 20 75 6e 69 78 49 6e 6f 64 65 49 6e Info unixInodeIn
1580: 66 6f 3b 20 20 20 2f 2a 20 41 6e 20 69 2d 6e 6f fo; /* An i-no
1590: 64 65 20 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 de */.typedef st
15a0: 72 75 63 74 20 55 6e 69 78 55 6e 75 73 65 64 46 ruct UnixUnusedF
15b0: 64 20 55 6e 69 78 55 6e 75 73 65 64 46 64 3b 20 d UnixUnusedFd;
15c0: 20 20 20 20 2f 2a 20 41 6e 20 75 6e 75 73 65 64 /* An unused
15d0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
15e0: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 74 */../*.** Somet
15f0: 69 6d 65 73 2c 20 61 66 74 65 72 20 61 20 66 69 imes, after a fi
1600: 6c 65 20 68 61 6e 64 6c 65 20 69 73 20 63 6c 6f le handle is clo
1610: 73 65 64 20 62 79 20 53 51 4c 69 74 65 2c 20 74 sed by SQLite, t
1620: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
1630: 6f 72 0a 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 20 or.** cannot be
1640: 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 74 65 closed immediate
1650: 6c 79 2e 20 49 6e 20 74 68 65 73 65 20 63 61 73 ly. In these cas
1660: 65 73 2c 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 es, instances of
1670: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a the following.*
1680: 2a 20 73 74 72 75 63 74 75 72 65 20 61 72 65 20 * structure are
1690: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 used to store th
16a0: 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f e file descripto
16b0: 72 20 77 68 69 6c 65 20 77 61 69 74 69 6e 67 20 r while waiting
16c0: 66 6f 72 20 61 6e 0a 2a 2a 20 6f 70 70 6f 72 74 for an.** opport
16d0: 75 6e 69 74 79 20 74 6f 20 65 69 74 68 65 72 20 unity to either
16e0: 63 6c 6f 73 65 20 6f 72 20 72 65 75 73 65 20 69 close or reuse i
16f0: 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 55 6e 69 t..*/.struct Uni
1700: 78 55 6e 75 73 65 64 46 64 20 7b 0a 20 20 69 6e xUnusedFd {. in
1710: 74 20 66 64 3b 20 20 20 20 20 20 20 20 20 20 20 t fd;
1720: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 /* File
1730: 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20 63 6c descriptor to cl
1740: 6f 73 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 ose */. int fla
1750: 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 gs;
1760: 20 20 20 2f 2a 20 46 6c 61 67 73 20 74 68 69 73 /* Flags this
1770: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
1780: 20 77 61 73 20 6f 70 65 6e 65 64 20 77 69 74 68 was opened with
1790: 20 2a 2f 0a 20 20 55 6e 69 78 55 6e 75 73 65 64 */. UnixUnused
17a0: 46 64 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 Fd *pNext;
17b0: 2f 2a 20 4e 65 78 74 20 75 6e 75 73 65 64 20 66 /* Next unused f
17c0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6f ile descriptor o
17d0: 6e 20 73 61 6d 65 20 66 69 6c 65 20 2a 2f 0a 7d n same file */.}
17e0: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 75 6e 69 ;../*.** The uni
17f0: 78 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 xFile structure
1800: 69 73 20 73 75 62 63 6c 61 73 73 20 6f 66 20 73 is subclass of s
1810: 71 6c 69 74 65 33 5f 66 69 6c 65 20 73 70 65 63 qlite3_file spec
1820: 69 66 69 63 20 74 6f 20 74 68 65 20 75 6e 69 78 ific to the unix
1830: 0a 2a 2a 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e .** VFS implemen
1840: 74 61 74 69 6f 6e 73 2e 0a 2a 2f 0a 74 79 70 65 tations..*/.type
1850: 64 65 66 20 73 74 72 75 63 74 20 75 6e 69 78 46 def struct unixF
1860: 69 6c 65 20 75 6e 69 78 46 69 6c 65 3b 0a 73 74 ile unixFile;.st
1870: 72 75 63 74 20 75 6e 69 78 46 69 6c 65 20 7b 0a ruct unixFile {.
1880: 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 sqlite3_io_met
1890: 68 6f 64 73 20 63 6f 6e 73 74 20 2a 70 4d 65 74 hods const *pMet
18a0: 68 6f 64 3b 20 20 2f 2a 20 41 6c 77 61 79 73 20 hod; /* Always
18b0: 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 20 the first entry
18c0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 */. sqlite3_vfs
18d0: 20 2a 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 *pVfs;
18e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
18f0: 56 46 53 20 74 68 61 74 20 63 72 65 61 74 65 64 VFS that created
1900: 20 74 68 69 73 20 75 6e 69 78 46 69 6c 65 20 2a this unixFile *
1910: 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 /. unixInodeInf
1920: 6f 20 2a 70 49 6e 6f 64 65 3b 20 20 20 20 20 20 o *pInode;
1930: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 66 6f 20 /* Info
1940: 61 62 6f 75 74 20 6c 6f 63 6b 73 20 6f 6e 20 74 about locks on t
1950: 68 69 73 20 69 6e 6f 64 65 20 2a 2f 0a 20 20 69 his inode */. i
1960: 6e 74 20 68 3b 20 20 20 20 20 20 20 20 20 20 20 nt h;
1970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1980: 20 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 64 /* The file d
1990: 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a 20 20 75 escriptor */. u
19a0: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 65 46 69 nsigned char eFi
19b0: 6c 65 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 leLock;
19c0: 20 20 20 2f 2a 20 54 68 65 20 74 79 70 65 20 6f /* The type o
19d0: 66 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 f lock held on t
19e0: 68 69 73 20 66 64 20 2a 2f 0a 20 20 75 6e 73 69 his fd */. unsi
19f0: 67 6e 65 64 20 73 68 6f 72 74 20 69 6e 74 20 63 gned short int c
1a00: 74 72 6c 46 6c 61 67 73 3b 20 20 20 20 20 20 20 trlFlags;
1a10: 2f 2a 20 42 65 68 61 76 69 6f 72 61 6c 20 62 69 /* Behavioral bi
1a20: 74 73 2e 20 20 55 4e 49 58 46 49 4c 45 5f 2a 20 ts. UNIXFILE_*
1a30: 66 6c 61 67 73 20 2a 2f 0a 20 20 69 6e 74 20 6c flags */. int l
1a40: 61 73 74 45 72 72 6e 6f 3b 20 20 20 20 20 20 20 astErrno;
1a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1a60: 2a 20 54 68 65 20 75 6e 69 78 20 65 72 72 6e 6f * The unix errno
1a70: 20 66 72 6f 6d 20 6c 61 73 74 20 49 2f 4f 20 65 from last I/O e
1a80: 72 72 6f 72 20 2a 2f 0a 20 20 76 6f 69 64 20 2a rror */. void *
1a90: 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 20 lockingContext;
1aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1ab0: 20 4c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 73 Locking style s
1ac0: 70 65 63 69 66 69 63 20 73 74 61 74 65 20 2a 2f pecific state */
1ad0: 0a 20 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 . UnixUnusedFd
1ae0: 2a 70 55 6e 75 73 65 64 3b 20 20 20 20 20 20 20 *pUnused;
1af0: 20 20 20 20 20 20 20 2f 2a 20 50 72 65 2d 61 6c /* Pre-al
1b00: 6c 6f 63 61 74 65 64 20 55 6e 69 78 55 6e 75 73 located UnixUnus
1b10: 65 64 46 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 edFd */. const
1b20: 63 68 61 72 20 2a 7a 50 61 74 68 3b 20 20 20 20 char *zPath;
1b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1b40: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c Name of the fil
1b50: 65 20 2a 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a e */. unixShm *
1b60: 70 53 68 6d 3b 20 20 20 20 20 20 20 20 20 20 20 pShm;
1b70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
1b80: 61 72 65 64 20 6d 65 6d 6f 72 79 20 73 65 67 6d ared memory segm
1b90: 65 6e 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ent information
1ba0: 2a 2f 0a 20 20 69 6e 74 20 73 7a 43 68 75 6e 6b */. int szChunk
1bb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1bc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 66 /* Conf
1bd0: 69 67 75 72 65 64 20 62 79 20 46 43 4e 54 4c 5f igured by FCNTL_
1be0: 43 48 55 4e 4b 5f 53 49 5a 45 20 2a 2f 0a 23 69 CHUNK_SIZE */.#i
1bf0: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 f SQLITE_MAX_MMA
1c00: 50 5f 53 49 5a 45 3e 30 0a 20 20 69 6e 74 20 6e P_SIZE>0. int n
1c10: 46 65 74 63 68 4f 75 74 3b 20 20 20 20 20 20 20 FetchOut;
1c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1c30: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6f 75 74 73 * Number of outs
1c40: 74 61 6e 64 69 6e 67 20 78 46 65 74 63 68 20 72 tanding xFetch r
1c50: 65 66 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 efs */. sqlite3
1c60: 5f 69 6e 74 36 34 20 6d 6d 61 70 53 69 7a 65 3b _int64 mmapSize;
1c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1c80: 55 73 61 62 6c 65 20 73 69 7a 65 20 6f 66 20 6d Usable size of m
1c90: 61 70 70 69 6e 67 20 61 74 20 70 4d 61 70 52 65 apping at pMapRe
1ca0: 67 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 gion */. sqlite
1cb0: 33 5f 69 6e 74 36 34 20 6d 6d 61 70 53 69 7a 65 3_int64 mmapSize
1cc0: 41 63 74 75 61 6c 3b 20 20 20 20 20 20 20 2f 2a Actual; /*
1cd0: 20 41 63 74 75 61 6c 20 73 69 7a 65 20 6f 66 20 Actual size of
1ce0: 6d 61 70 70 69 6e 67 20 61 74 20 70 4d 61 70 52 mapping at pMapR
1cf0: 65 67 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 egion */. sqlit
1d00: 65 33 5f 69 6e 74 36 34 20 6d 6d 61 70 53 69 7a e3_int64 mmapSiz
1d10: 65 4d 61 78 3b 20 20 20 20 20 20 20 20 20 20 2f eMax; /
1d20: 2a 20 43 6f 6e 66 69 67 75 72 65 64 20 46 43 4e * Configured FCN
1d30: 54 4c 5f 4d 4d 41 50 5f 53 49 5a 45 20 76 61 6c TL_MMAP_SIZE val
1d40: 75 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4d ue */. void *pM
1d50: 61 70 52 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 apRegion;
1d60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
1d70: 65 6d 6f 72 79 20 6d 61 70 70 65 64 20 72 65 67 emory mapped reg
1d80: 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 ion */.#endif.#i
1d90: 66 64 65 66 20 5f 5f 51 4e 58 4e 54 4f 5f 5f 0a fdef __QNXNTO__.
1da0: 20 20 69 6e 74 20 73 65 63 74 6f 72 53 69 7a 65 int sectorSize
1db0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1dc0: 20 20 20 20 20 20 2f 2a 20 44 65 76 69 63 65 20 /* Device
1dd0: 73 65 63 74 6f 72 20 73 69 7a 65 20 2a 2f 0a 20 sector size */.
1de0: 20 69 6e 74 20 64 65 76 69 63 65 43 68 61 72 61 int deviceChara
1df0: 63 74 65 72 69 73 74 69 63 73 3b 20 20 20 20 20 cteristics;
1e00: 20 20 20 20 20 2f 2a 20 50 72 65 63 6f 6d 70 75 /* Precompu
1e10: 74 65 64 20 64 65 76 69 63 65 20 63 68 61 72 61 ted device chara
1e20: 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 23 65 cteristics */.#e
1e30: 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f ndif.#if SQLITE_
1e40: 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 ENABLE_LOCKING_S
1e50: 54 59 4c 45 0a 20 20 69 6e 74 20 6f 70 65 6e 46 TYLE. int openF
1e60: 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 lags;
1e70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
1e80: 65 20 66 6c 61 67 73 20 73 70 65 63 69 66 69 65 e flags specifie
1e90: 64 20 61 74 20 6f 70 65 6e 28 29 20 2a 2f 0a 23 d at open() */.#
1ea0: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
1eb0: 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f _ENABLE_LOCKING_
1ec0: 53 54 59 4c 45 20 7c 7c 20 64 65 66 69 6e 65 64 STYLE || defined
1ed0: 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 20 20 75 6e (__APPLE__). un
1ee0: 73 69 67 6e 65 64 20 66 73 46 6c 61 67 73 3b 20 signed fsFlags;
1ef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f00: 20 20 2f 2a 20 63 61 63 68 65 64 20 64 65 74 61 /* cached deta
1f10: 69 6c 73 20 66 72 6f 6d 20 73 74 61 74 66 73 28 ils from statfs(
1f20: 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 20 ) */.#endif.#if
1f30: 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 OS_VXWORKS. str
1f40: 75 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 uct vxworksFileI
1f50: 64 20 2a 70 49 64 3b 20 20 20 20 20 20 20 20 20 d *pId;
1f60: 20 2f 2a 20 55 6e 69 71 75 65 20 66 69 6c 65 20 /* Unique file
1f70: 49 44 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 ID */.#endif.#if
1f80: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
1f90: 0a 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 67 . /* The next g
1fa0: 72 6f 75 70 20 6f 66 20 76 61 72 69 61 62 6c 65 roup of variable
1fb0: 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 74 72 s are used to tr
1fc0: 61 63 6b 20 77 68 65 74 68 65 72 20 6f 72 20 6e ack whether or n
1fd0: 6f 74 20 74 68 65 0a 20 20 2a 2a 20 74 72 61 6e ot the. ** tran
1fe0: 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 saction counter
1ff0: 69 6e 20 62 79 74 65 73 20 32 34 2d 32 37 20 6f in bytes 24-27 o
2000: 66 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 f database files
2010: 20 61 72 65 20 75 70 64 61 74 65 64 0a 20 20 2a are updated. *
2020: 2a 20 77 68 65 6e 65 76 65 72 20 61 6e 79 20 70 * whenever any p
2030: 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 art of the datab
2040: 61 73 65 20 63 68 61 6e 67 65 73 2e 20 20 41 6e ase changes. An
2050: 20 61 73 73 65 72 74 69 6f 6e 20 66 61 75 6c 74 assertion fault
2060: 20 77 69 6c 6c 0a 20 20 2a 2a 20 6f 63 63 75 72 will. ** occur
2070: 20 69 66 20 61 20 66 69 6c 65 20 69 73 20 75 70 if a file is up
2080: 64 61 74 65 64 20 77 69 74 68 6f 75 74 20 61 6c dated without al
2090: 73 6f 20 75 70 64 61 74 69 6e 67 20 74 68 65 20 so updating the
20a0: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a transaction. **
20b0: 20 63 6f 75 6e 74 65 72 2e 20 20 54 68 69 73 20 counter. This
20c0: 74 65 73 74 20 69 73 20 6d 61 64 65 20 74 6f 20 test is made to
20d0: 61 76 6f 69 64 20 6e 65 77 20 70 72 6f 62 6c 65 avoid new proble
20e0: 6d 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 ms similar to th
20f0: 65 0a 20 20 2a 2a 20 6f 6e 65 20 64 65 73 63 72 e. ** one descr
2100: 69 62 65 64 20 62 79 20 74 69 63 6b 65 74 20 23 ibed by ticket #
2110: 33 35 38 34 2e 20 0a 20 20 2a 2f 0a 20 20 75 6e 3584. . */. un
2120: 73 69 67 6e 65 64 20 63 68 61 72 20 74 72 61 6e signed char tran
2130: 73 43 6e 74 72 43 68 6e 67 3b 20 20 20 2f 2a 20 sCntrChng; /*
2140: 54 72 75 65 20 69 66 20 74 68 65 20 74 72 61 6e True if the tran
2150: 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 saction counter
2160: 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20 75 6e 73 changed */. uns
2170: 69 67 6e 65 64 20 63 68 61 72 20 64 62 55 70 64 igned char dbUpd
2180: 61 74 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 ate; /* T
2190: 72 75 65 20 69 66 20 61 6e 79 20 70 61 72 74 20 rue if any part
21a0: 6f 66 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 of database file
21b0: 20 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20 75 6e changed */. un
21c0: 73 69 67 6e 65 64 20 63 68 61 72 20 69 6e 4e 6f signed char inNo
21d0: 72 6d 61 6c 57 72 69 74 65 3b 20 20 20 2f 2a 20 rmalWrite; /*
21e0: 54 72 75 65 20 69 66 20 69 6e 20 61 20 6e 6f 72 True if in a nor
21f0: 6d 61 6c 20 77 72 69 74 65 20 6f 70 65 72 61 74 mal write operat
2200: 69 6f 6e 20 2a 2f 0a 0a 23 65 6e 64 69 66 0a 0a ion */..#endif..
2210: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 #ifdef SQLITE_TE
2220: 53 54 0a 20 20 2f 2a 20 49 6e 20 74 65 73 74 20 ST. /* In test
2230: 6d 6f 64 65 2c 20 69 6e 63 72 65 61 73 65 20 74 mode, increase t
2240: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 69 73 20 he size of this
2250: 73 74 72 75 63 74 75 72 65 20 61 20 62 69 74 20 structure a bit
2260: 73 6f 20 74 68 61 74 20 0a 20 20 2a 2a 20 69 74 so that . ** it
2270: 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 is larger than
2280: 74 68 65 20 73 74 72 75 63 74 20 43 72 61 73 68 the struct Crash
2290: 46 69 6c 65 20 64 65 66 69 6e 65 64 20 69 6e 20 File defined in
22a0: 74 65 73 74 36 2e 63 2e 0a 20 20 2a 2f 0a 20 20 test6.c.. */.
22b0: 63 68 61 72 20 61 50 61 64 64 69 6e 67 5b 33 32 char aPadding[32
22c0: 5d 3b 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a ];.#endif.};../*
22d0: 20 54 68 69 73 20 76 61 72 69 61 62 6c 65 20 68 This variable h
22e0: 6f 6c 64 73 20 74 68 65 20 70 72 6f 63 65 73 73 olds the process
22f0: 20 69 64 20 28 70 69 64 29 20 66 72 6f 6d 20 77 id (pid) from w
2300: 68 65 6e 20 74 68 65 20 78 52 61 6e 64 6f 6d 6e hen the xRandomn
2310: 65 73 73 28 29 0a 2a 2a 20 6d 65 74 68 6f 64 20 ess().** method
2320: 77 61 73 20 63 61 6c 6c 65 64 2e 20 20 49 66 20 was called. If
2330: 78 4f 70 65 6e 28 29 20 69 73 20 63 61 6c 6c 65 xOpen() is calle
2340: 64 20 66 72 6f 6d 20 61 20 64 69 66 66 65 72 65 d from a differe
2350: 6e 74 20 70 72 6f 63 65 73 73 20 69 64 2c 0a 2a nt process id,.*
2360: 2a 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 61 * indicating tha
2370: 74 20 61 20 66 6f 72 6b 28 29 20 68 61 73 20 6f t a fork() has o
2380: 63 63 75 72 72 65 64 2c 20 74 68 65 20 50 52 4e ccurred, the PRN
2390: 47 20 77 69 6c 6c 20 62 65 20 72 65 73 65 74 2e G will be reset.
23a0: 0a 2a 2f 0a 73 74 61 74 69 63 20 70 69 64 5f 74 .*/.static pid_t
23b0: 20 72 61 6e 64 6f 6d 6e 65 73 73 50 69 64 20 3d randomnessPid =
23c0: 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 0;../*.** Allow
23d0: 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 ed values for th
23e0: 65 20 75 6e 69 78 46 69 6c 65 2e 63 74 72 6c 46 e unixFile.ctrlF
23f0: 6c 61 67 73 20 62 69 74 6d 61 73 6b 3a 0a 2a 2f lags bitmask:.*/
2400: 0a 23 64 65 66 69 6e 65 20 55 4e 49 58 46 49 4c .#define UNIXFIL
2410: 45 5f 45 58 43 4c 20 20 20 20 20 20 20 20 30 78 E_EXCL 0x
2420: 30 31 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 01 /* Connec
2430: 74 69 6f 6e 73 20 66 72 6f 6d 20 6f 6e 65 20 70 tions from one p
2440: 72 6f 63 65 73 73 20 6f 6e 6c 79 20 2a 2f 0a 23 rocess only */.#
2450: 64 65 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f define UNIXFILE_
2460: 52 44 4f 4e 4c 59 20 20 20 20 20 20 30 78 30 32 RDONLY 0x02
2470: 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 /* Connecti
2480: 6f 6e 20 69 73 20 72 65 61 64 20 6f 6e 6c 79 20 on is read only
2490: 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e 49 58 46 */.#define UNIXF
24a0: 49 4c 45 5f 50 45 52 53 49 53 54 5f 57 41 4c 20 ILE_PERSIST_WAL
24b0: 30 78 30 34 20 20 20 20 20 2f 2a 20 50 65 72 73 0x04 /* Pers
24c0: 69 73 74 65 6e 74 20 57 41 4c 20 6d 6f 64 65 20 istent WAL mode
24d0: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
24e0: 45 5f 44 49 53 41 42 4c 45 5f 44 49 52 53 59 4e E_DISABLE_DIRSYN
24f0: 43 0a 23 20 64 65 66 69 6e 65 20 55 4e 49 58 46 C.# define UNIXF
2500: 49 4c 45 5f 44 49 52 53 59 4e 43 20 20 20 20 30 ILE_DIRSYNC 0
2510: 78 30 38 20 20 20 20 20 2f 2a 20 44 69 72 65 63 x08 /* Direc
2520: 74 6f 72 79 20 73 79 6e 63 20 6e 65 65 64 65 64 tory sync needed
2530: 20 2a 2f 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 */.#else.# defi
2540: 6e 65 20 55 4e 49 58 46 49 4c 45 5f 44 49 52 53 ne UNIXFILE_DIRS
2550: 59 4e 43 20 20 20 20 30 78 30 30 0a 23 65 6e 64 YNC 0x00.#end
2560: 69 66 0a 23 64 65 66 69 6e 65 20 55 4e 49 58 46 if.#define UNIXF
2570: 49 4c 45 5f 50 53 4f 57 20 20 20 20 20 20 20 20 ILE_PSOW
2580: 30 78 31 30 20 20 20 20 20 2f 2a 20 53 51 4c 49 0x10 /* SQLI
2590: 54 45 5f 49 4f 43 41 50 5f 50 4f 57 45 52 53 41 TE_IOCAP_POWERSA
25a0: 46 45 5f 4f 56 45 52 57 52 49 54 45 20 2a 2f 0a FE_OVERWRITE */.
25b0: 23 64 65 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 #define UNIXFILE
25c0: 5f 44 45 4c 45 54 45 20 20 20 20 20 20 30 78 32 _DELETE 0x2
25d0: 30 20 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 0 /* Delete
25e0: 6f 6e 20 63 6c 6f 73 65 20 2a 2f 0a 23 64 65 66 on close */.#def
25f0: 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f 55 52 49 ine UNIXFILE_URI
2600: 20 20 20 20 20 20 20 20 20 30 78 34 30 20 20 20 0x40
2610: 20 20 2f 2a 20 46 69 6c 65 6e 61 6d 65 20 6d 69 /* Filename mi
2620: 67 68 74 20 68 61 76 65 20 71 75 65 72 79 20 70 ght have query p
2630: 61 72 61 6d 65 74 65 72 73 20 2a 2f 0a 23 64 65 arameters */.#de
2640: 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f 4e 4f fine UNIXFILE_NO
2650: 4c 4f 43 4b 20 20 20 20 20 20 30 78 38 30 20 20 LOCK 0x80
2660: 20 20 20 2f 2a 20 44 6f 20 6e 6f 20 66 69 6c 65 /* Do no file
2670: 20 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 0a 2f 2a 0a locking */../*.
2680: 2a 2a 20 49 6e 63 6c 75 64 65 20 63 6f 64 65 20 ** Include code
2690: 74 68 61 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 that is common t
26a0: 6f 20 61 6c 6c 20 6f 73 5f 2a 2e 63 20 66 69 6c o all os_*.c fil
26b0: 65 73 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 es.*/.#include "
26c0: 6f 73 5f 63 6f 6d 6d 6f 6e 2e 68 22 0a 0a 2f 2a os_common.h"../*
26d0: 0a 2a 2a 20 44 65 66 69 6e 65 20 76 61 72 69 6f .** Define vario
26e0: 75 73 20 6d 61 63 72 6f 73 20 74 68 61 74 20 61 us macros that a
26f0: 72 65 20 6d 69 73 73 69 6e 67 20 66 72 6f 6d 20 re missing from
2700: 73 6f 6d 65 20 73 79 73 74 65 6d 73 2e 0a 2a 2f some systems..*/
2710: 0a 23 69 66 6e 64 65 66 20 4f 5f 4c 41 52 47 45 .#ifndef O_LARGE
2720: 46 49 4c 45 0a 23 20 64 65 66 69 6e 65 20 4f 5f FILE.# define O_
2730: 4c 41 52 47 45 46 49 4c 45 20 30 0a 23 65 6e 64 LARGEFILE 0.#end
2740: 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 if.#ifdef SQLITE
2750: 5f 44 49 53 41 42 4c 45 5f 4c 46 53 0a 23 20 75 _DISABLE_LFS.# u
2760: 6e 64 65 66 20 4f 5f 4c 41 52 47 45 46 49 4c 45 ndef O_LARGEFILE
2770: 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4c 41 52 47 .# define O_LARG
2780: 45 46 49 4c 45 20 30 0a 23 65 6e 64 69 66 0a 23 EFILE 0.#endif.#
2790: 69 66 6e 64 65 66 20 4f 5f 4e 4f 46 4f 4c 4c 4f ifndef O_NOFOLLO
27a0: 57 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4e 4f 46 W.# define O_NOF
27b0: 4f 4c 4c 4f 57 20 30 0a 23 65 6e 64 69 66 0a 23 OLLOW 0.#endif.#
27c0: 69 66 6e 64 65 66 20 4f 5f 42 49 4e 41 52 59 0a ifndef O_BINARY.
27d0: 23 20 64 65 66 69 6e 65 20 4f 5f 42 49 4e 41 52 # define O_BINAR
27e0: 59 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a Y 0.#endif../*.*
27f0: 2a 20 54 68 65 20 74 68 72 65 61 64 69 64 20 6d * The threadid m
2800: 61 63 72 6f 20 72 65 73 6f 6c 76 65 73 20 74 6f acro resolves to
2810: 20 74 68 65 20 74 68 72 65 61 64 2d 69 64 20 6f the thread-id o
2820: 72 20 74 6f 20 30 2e 20 20 55 73 65 64 20 66 6f r to 0. Used fo
2830: 72 0a 2a 2a 20 74 65 73 74 69 6e 67 20 61 6e 64 r.** testing and
2840: 20 64 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e debugging only.
2850: 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 .*/.#if SQLITE_T
2860: 48 52 45 41 44 53 41 46 45 0a 23 64 65 66 69 6e HREADSAFE.#defin
2870: 65 20 74 68 72 65 61 64 69 64 20 70 74 68 72 65 e threadid pthre
2880: 61 64 5f 73 65 6c 66 28 29 0a 23 65 6c 73 65 0a ad_self().#else.
2890: 23 64 65 66 69 6e 65 20 74 68 72 65 61 64 69 64 #define threadid
28a0: 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 0.#endif../*.**
28b0: 20 48 41 56 45 5f 4d 52 45 4d 41 50 20 64 65 66 HAVE_MREMAP def
28c0: 61 75 6c 74 73 20 74 6f 20 74 72 75 65 20 6f 6e aults to true on
28d0: 20 4c 69 6e 75 78 20 61 6e 64 20 66 61 6c 73 65 Linux and false
28e0: 20 65 76 65 72 79 77 68 65 72 65 20 65 6c 73 65 everywhere else
28f0: 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 ..*/.#if !define
2900: 64 28 48 41 56 45 5f 4d 52 45 4d 41 50 29 0a 23 d(HAVE_MREMAP).#
2910: 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c 69 if defined(__li
2920: 6e 75 78 5f 5f 29 20 26 26 20 64 65 66 69 6e 65 nux__) && define
2930: 64 28 5f 47 4e 55 5f 53 4f 55 52 43 45 29 0a 23 d(_GNU_SOURCE).#
2940: 20 20 64 65 66 69 6e 65 20 48 41 56 45 5f 4d 52 define HAVE_MR
2950: 45 4d 41 50 20 31 0a 23 20 65 6c 73 65 0a 23 20 EMAP 1.# else.#
2960: 20 64 65 66 69 6e 65 20 48 41 56 45 5f 4d 52 45 define HAVE_MRE
2970: 4d 41 50 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 MAP 0.# endif.#e
2980: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 70 6c ndif../*.** Expl
2990: 69 63 69 74 6c 79 20 63 61 6c 6c 20 74 68 65 20 icitly call the
29a0: 36 34 2d 62 69 74 20 76 65 72 73 69 6f 6e 20 6f 64-bit version o
29b0: 66 20 6c 73 65 65 6b 28 29 20 6f 6e 20 41 6e 64 f lseek() on And
29c0: 72 6f 69 64 2e 20 4f 74 68 65 72 77 69 73 65 2c roid. Otherwise,
29d0: 20 6c 73 65 65 6b 28 29 0a 2a 2a 20 69 73 20 74 lseek().** is t
29e0: 68 65 20 33 32 2d 62 69 74 20 76 65 72 73 69 6f he 32-bit versio
29f0: 6e 2c 20 65 76 65 6e 20 69 66 20 5f 46 49 4c 45 n, even if _FILE
2a00: 5f 4f 46 46 53 45 54 5f 42 49 54 53 3d 36 34 20 _OFFSET_BITS=64
2a10: 69 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 is defined..*/.#
2a20: 69 66 64 65 66 20 5f 5f 41 4e 44 52 4f 49 44 5f ifdef __ANDROID_
2a30: 5f 0a 23 20 64 65 66 69 6e 65 20 6c 73 65 65 6b _.# define lseek
2a40: 20 6c 73 65 65 6b 36 34 0a 23 65 6e 64 69 66 0a lseek64.#endif.
2a50: 0a 2f 2a 0a 2a 2a 20 44 69 66 66 65 72 65 6e 74 ./*.** Different
2a60: 20 55 6e 69 78 20 73 79 73 74 65 6d 73 20 64 65 Unix systems de
2a70: 63 6c 61 72 65 20 6f 70 65 6e 28 29 20 69 6e 20 clare open() in
2a80: 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 2e 20 different ways.
2a90: 20 53 61 6d 65 20 75 73 65 0a 2a 2a 20 6f 70 65 Same use.** ope
2aa0: 6e 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e n(const char*,in
2ab0: 74 2c 6d 6f 64 65 5f 74 29 2e 20 20 4f 74 68 65 t,mode_t). Othe
2ac0: 72 73 20 75 73 65 20 6f 70 65 6e 28 63 6f 6e 73 rs use open(cons
2ad0: 74 20 63 68 61 72 2a 2c 69 6e 74 2c 2e 2e 2e 29 t char*,int,...)
2ae0: 2e 0a 2a 2a 20 54 68 65 20 64 69 66 66 65 72 65 ..** The differe
2af0: 6e 63 65 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 nce is important
2b00: 20 77 68 65 6e 20 75 73 69 6e 67 20 61 20 70 6f when using a po
2b10: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 66 75 6e inter to the fun
2b20: 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ction..**.** The
2b30: 20 73 61 66 65 73 74 20 77 61 79 20 74 6f 20 64 safest way to d
2b40: 65 61 6c 20 77 69 74 68 20 74 68 65 20 70 72 6f eal with the pro
2b50: 62 6c 65 6d 20 69 73 20 74 6f 20 61 6c 77 61 79 blem is to alway
2b60: 73 20 75 73 65 20 74 68 69 73 20 77 72 61 70 70 s use this wrapp
2b70: 65 72 0a 2a 2a 20 77 68 69 63 68 20 61 6c 77 61 er.** which alwa
2b80: 79 73 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 ys has the same
2b90: 77 65 6c 6c 2d 64 65 66 69 6e 65 64 20 69 6e 74 well-defined int
2ba0: 65 72 66 61 63 65 2e 0a 2a 2f 0a 73 74 61 74 69 erface..*/.stati
2bb0: 63 20 69 6e 74 20 70 6f 73 69 78 4f 70 65 6e 28 c int posixOpen(
2bc0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c const char *zFil
2bd0: 65 2c 20 69 6e 74 20 66 6c 61 67 73 2c 20 69 6e e, int flags, in
2be0: 74 20 6d 6f 64 65 29 7b 0a 20 20 72 65 74 75 72 t mode){. retur
2bf0: 6e 20 6f 70 65 6e 28 7a 46 69 6c 65 2c 20 66 6c n open(zFile, fl
2c00: 61 67 73 2c 20 6d 6f 64 65 29 3b 0a 7d 0a 0a 2f ags, mode);.}../
2c10: 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 * Forward refere
2c20: 6e 63 65 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e nce */.static in
2c30: 74 20 6f 70 65 6e 44 69 72 65 63 74 6f 72 79 28 t openDirectory(
2c40: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 const char*, int
2c50: 2a 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 75 *);.static int u
2c60: 6e 69 78 47 65 74 70 61 67 65 73 69 7a 65 28 76 nixGetpagesize(v
2c70: 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6e oid);../*.** Man
2c80: 79 20 73 79 73 74 65 6d 20 63 61 6c 6c 73 20 61 y system calls a
2c90: 72 65 20 61 63 63 65 73 73 65 64 20 74 68 72 6f re accessed thro
2ca0: 75 67 68 20 70 6f 69 6e 74 65 72 2d 74 6f 2d 66 ugh pointer-to-f
2cb0: 75 6e 63 74 69 6f 6e 73 20 73 6f 20 74 68 61 74 unctions so that
2cc0: 0a 2a 2a 20 74 68 65 79 20 6d 61 79 20 62 65 20 .** they may be
2cd0: 6f 76 65 72 72 69 64 64 65 6e 20 61 74 20 72 75 overridden at ru
2ce0: 6e 74 69 6d 65 20 74 6f 20 66 61 63 69 6c 69 74 ntime to facilit
2cf0: 61 74 65 20 66 61 75 6c 74 20 69 6e 6a 65 63 74 ate fault inject
2d00: 69 6f 6e 20 64 75 72 69 6e 67 0a 2a 2a 20 74 65 ion during.** te
2d10: 73 74 69 6e 67 20 61 6e 64 20 73 61 6e 64 62 6f sting and sandbo
2d20: 78 69 6e 67 2e 20 20 54 68 65 20 66 6f 6c 6c 6f xing. The follo
2d30: 77 69 6e 67 20 61 72 72 61 79 20 68 6f 6c 64 73 wing array holds
2d40: 20 74 68 65 20 6e 61 6d 65 73 20 61 6e 64 20 70 the names and p
2d50: 6f 69 6e 74 65 72 73 0a 2a 2a 20 74 6f 20 61 6c ointers.** to al
2d60: 6c 20 6f 76 65 72 72 69 64 65 61 62 6c 65 20 73 l overrideable s
2d70: 79 73 74 65 6d 20 63 61 6c 6c 73 2e 0a 2a 2f 0a ystem calls..*/.
2d80: 73 74 61 74 69 63 20 73 74 72 75 63 74 20 75 6e static struct un
2d90: 69 78 5f 73 79 73 63 61 6c 6c 20 7b 0a 20 20 63 ix_syscall {. c
2da0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 onst char *zName
2db0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
2dc0: 4e 61 6d 65 20 6f 66 20 74 68 65 20 73 79 73 74 Name of the syst
2dd0: 65 6d 20 63 61 6c 6c 20 2a 2f 0a 20 20 73 71 6c em call */. sql
2de0: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 ite3_syscall_ptr
2df0: 20 70 43 75 72 72 65 6e 74 3b 20 2f 2a 20 43 75 pCurrent; /* Cu
2e00: 72 72 65 6e 74 20 76 61 6c 75 65 20 6f 66 20 74 rrent value of t
2e10: 68 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 2a he system call *
2e20: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 79 73 63 /. sqlite3_sysc
2e30: 61 6c 6c 5f 70 74 72 20 70 44 65 66 61 75 6c 74 all_ptr pDefault
2e40: 3b 20 2f 2a 20 44 65 66 61 75 6c 74 20 76 61 6c ; /* Default val
2e50: 75 65 20 2a 2f 0a 7d 20 61 53 79 73 63 61 6c 6c ue */.} aSyscall
2e60: 5b 5d 20 3d 20 7b 0a 20 20 7b 20 22 6f 70 65 6e [] = {. { "open
2e70: 22 2c 20 20 20 20 20 20 20 20 20 28 73 71 6c 69 ", (sqli
2e80: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 te3_syscall_ptr)
2e90: 70 6f 73 69 78 4f 70 65 6e 2c 20 20 30 20 20 7d posixOpen, 0 }
2ea0: 2c 0a 23 64 65 66 69 6e 65 20 6f 73 4f 70 65 6e ,.#define osOpen
2eb0: 20 20 20 20 20 20 28 28 69 6e 74 28 2a 29 28 63 ((int(*)(c
2ec0: 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 2c 69 onst char*,int,i
2ed0: 6e 74 29 29 61 53 79 73 63 61 6c 6c 5b 30 5d 2e nt))aSyscall[0].
2ee0: 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22 pCurrent).. { "
2ef0: 63 6c 6f 73 65 22 2c 20 20 20 20 20 20 20 20 28 close", (
2f00: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f sqlite3_syscall_
2f10: 70 74 72 29 63 6c 6f 73 65 2c 20 20 20 20 20 20 ptr)close,
2f20: 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73 0 },.#define os
2f30: 43 6c 6f 73 65 20 20 20 20 20 28 28 69 6e 74 28 Close ((int(
2f40: 2a 29 28 69 6e 74 29 29 61 53 79 73 63 61 6c 6c *)(int))aSyscall
2f50: 5b 31 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 [1].pCurrent)..
2f60: 20 7b 20 22 61 63 63 65 73 73 22 2c 20 20 20 20 { "access",
2f70: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
2f80: 61 6c 6c 5f 70 74 72 29 61 63 63 65 73 73 2c 20 all_ptr)access,
2f90: 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 0 },.#defin
2fa0: 65 20 6f 73 41 63 63 65 73 73 20 20 20 20 28 28 e osAccess ((
2fb0: 69 6e 74 28 2a 29 28 63 6f 6e 73 74 20 63 68 61 int(*)(const cha
2fc0: 72 2a 2c 69 6e 74 29 29 61 53 79 73 63 61 6c 6c r*,int))aSyscall
2fd0: 5b 32 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 [2].pCurrent)..
2fe0: 20 7b 20 22 67 65 74 63 77 64 22 2c 20 20 20 20 { "getcwd",
2ff0: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
3000: 61 6c 6c 5f 70 74 72 29 67 65 74 63 77 64 2c 20 all_ptr)getcwd,
3010: 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 0 },.#defin
3020: 65 20 6f 73 47 65 74 63 77 64 20 20 20 20 28 28 e osGetcwd ((
3030: 63 68 61 72 2a 28 2a 29 28 63 68 61 72 2a 2c 73 char*(*)(char*,s
3040: 69 7a 65 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b ize_t))aSyscall[
3050: 33 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 3].pCurrent)..
3060: 7b 20 22 73 74 61 74 22 2c 20 20 20 20 20 20 20 { "stat",
3070: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 (sqlite3_sysca
3080: 6c 6c 5f 70 74 72 29 73 74 61 74 2c 20 20 20 20 ll_ptr)stat,
3090: 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65 0 },.#define
30a0: 20 6f 73 53 74 61 74 20 20 20 20 20 20 28 28 69 osStat ((i
30b0: 6e 74 28 2a 29 28 63 6f 6e 73 74 20 63 68 61 72 nt(*)(const char
30c0: 2a 2c 73 74 72 75 63 74 20 73 74 61 74 2a 29 29 *,struct stat*))
30d0: 61 53 79 73 63 61 6c 6c 5b 34 5d 2e 70 43 75 72 aSyscall[4].pCur
30e0: 72 65 6e 74 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 rent)../*.** The
30f0: 20 44 4a 47 50 50 20 63 6f 6d 70 69 6c 65 72 20 DJGPP compiler
3100: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 6c 6f 6f 6b environment look
3110: 73 20 6d 6f 73 74 6c 79 20 6c 69 6b 65 20 55 6e s mostly like Un
3120: 69 78 2c 20 62 75 74 20 69 74 0a 2a 2a 20 6c 61 ix, but it.** la
3130: 63 6b 73 20 74 68 65 20 66 63 6e 74 6c 28 29 20 cks the fcntl()
3140: 73 79 73 74 65 6d 20 63 61 6c 6c 2e 20 20 53 6f system call. So
3150: 20 72 65 64 65 66 69 6e 65 20 66 63 6e 74 6c 28 redefine fcntl(
3160: 29 20 74 6f 20 62 65 20 73 6f 6d 65 74 68 69 6e ) to be somethin
3170: 67 0a 2a 2a 20 74 68 61 74 20 61 6c 77 61 79 73 g.** that always
3180: 20 73 75 63 63 65 65 64 73 2e 20 20 54 68 69 73 succeeds. This
3190: 20 6d 65 61 6e 73 20 74 68 61 74 20 6c 6f 63 6b means that lock
31a0: 69 6e 67 20 64 6f 65 73 20 6e 6f 74 20 6f 63 63 ing does not occ
31b0: 75 72 20 75 6e 64 65 72 0a 2a 2a 20 44 4a 47 50 ur under.** DJGP
31c0: 50 2e 20 20 42 75 74 20 69 74 20 69 73 20 44 4f P. But it is DO
31d0: 53 20 2d 20 77 68 61 74 20 64 69 64 20 79 6f 75 S - what did you
31e0: 20 65 78 70 65 63 74 3f 0a 2a 2f 0a 23 69 66 64 expect?.*/.#ifd
31f0: 65 66 20 5f 5f 44 4a 47 50 50 5f 5f 0a 20 20 7b ef __DJGPP__. {
3200: 20 22 66 73 74 61 74 22 2c 20 20 20 20 20 20 20 "fstat",
3210: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 0,
3220: 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 0 },.#defin
3230: 65 20 6f 73 46 73 74 61 74 28 61 2c 62 2c 63 29 e osFstat(a,b,c)
3240: 20 20 20 20 30 0a 23 65 6c 73 65 20 20 20 20 20 0.#else
3250: 0a 20 20 7b 20 22 66 73 74 61 74 22 2c 20 20 20 . { "fstat",
3260: 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 (sqlite3_sy
3270: 73 63 61 6c 6c 5f 70 74 72 29 66 73 74 61 74 2c scall_ptr)fstat,
3280: 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 0 },.#def
3290: 69 6e 65 20 6f 73 46 73 74 61 74 20 20 20 20 20 ine osFstat
32a0: 28 28 69 6e 74 28 2a 29 28 69 6e 74 2c 73 74 72 ((int(*)(int,str
32b0: 75 63 74 20 73 74 61 74 2a 29 29 61 53 79 73 63 uct stat*))aSysc
32c0: 61 6c 6c 5b 35 5d 2e 70 43 75 72 72 65 6e 74 29 all[5].pCurrent)
32d0: 0a 23 65 6e 64 69 66 0a 0a 20 20 7b 20 22 66 74 .#endif.. { "ft
32e0: 72 75 6e 63 61 74 65 22 2c 20 20 20 20 28 73 71 runcate", (sq
32f0: 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 lite3_syscall_pt
3300: 72 29 66 74 72 75 6e 63 61 74 65 2c 20 20 30 20 r)ftruncate, 0
3310: 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73 46 74 },.#define osFt
3320: 72 75 6e 63 61 74 65 20 28 28 69 6e 74 28 2a 29 runcate ((int(*)
3330: 28 69 6e 74 2c 6f 66 66 5f 74 29 29 61 53 79 73 (int,off_t))aSys
3340: 63 61 6c 6c 5b 36 5d 2e 70 43 75 72 72 65 6e 74 call[6].pCurrent
3350: 29 0a 0a 20 20 7b 20 22 66 63 6e 74 6c 22 2c 20 ).. { "fcntl",
3360: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f (sqlite3_
3370: 73 79 73 63 61 6c 6c 5f 70 74 72 29 66 63 6e 74 syscall_ptr)fcnt
3380: 6c 2c 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 64 l, 0 },.#d
3390: 65 66 69 6e 65 20 6f 73 46 63 6e 74 6c 20 20 20 efine osFcntl
33a0: 20 20 28 28 69 6e 74 28 2a 29 28 69 6e 74 2c 69 ((int(*)(int,i
33b0: 6e 74 2c 2e 2e 2e 29 29 61 53 79 73 63 61 6c 6c nt,...))aSyscall
33c0: 5b 37 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 [7].pCurrent)..
33d0: 20 7b 20 22 72 65 61 64 22 2c 20 20 20 20 20 20 { "read",
33e0: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
33f0: 61 6c 6c 5f 70 74 72 29 72 65 61 64 2c 20 20 20 all_ptr)read,
3400: 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 0 },.#defin
3410: 65 20 6f 73 52 65 61 64 20 20 20 20 20 20 28 28 e osRead ((
3420: 73 73 69 7a 65 5f 74 28 2a 29 28 69 6e 74 2c 76 ssize_t(*)(int,v
3430: 6f 69 64 2a 2c 73 69 7a 65 5f 74 29 29 61 53 79 oid*,size_t))aSy
3440: 73 63 61 6c 6c 5b 38 5d 2e 70 43 75 72 72 65 6e scall[8].pCurren
3450: 74 29 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 t)..#if defined(
3460: 55 53 45 5f 50 52 45 41 44 29 20 7c 7c 20 53 51 USE_PREAD) || SQ
3470: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b LITE_ENABLE_LOCK
3480: 49 4e 47 5f 53 54 59 4c 45 0a 20 20 7b 20 22 70 ING_STYLE. { "p
3490: 72 65 61 64 22 2c 20 20 20 20 20 20 20 20 28 73 read", (s
34a0: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 qlite3_syscall_p
34b0: 74 72 29 70 72 65 61 64 2c 20 20 20 20 20 20 30 tr)pread, 0
34c0: 20 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 },.#else. { "
34d0: 70 72 65 61 64 22 2c 20 20 20 20 20 20 20 20 28 pread", (
34e0: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f sqlite3_syscall_
34f0: 70 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 20 ptr)0,
3500: 30 20 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65 0 },.#endif.#de
3510: 66 69 6e 65 20 6f 73 50 72 65 61 64 20 20 20 20 fine osPread
3520: 20 28 28 73 73 69 7a 65 5f 74 28 2a 29 28 69 6e ((ssize_t(*)(in
3530: 74 2c 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 2c 6f t,void*,size_t,o
3540: 66 66 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b 39 ff_t))aSyscall[9
3550: 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66 ].pCurrent)..#if
3560: 20 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 defined(USE_PRE
3570: 41 44 36 34 29 0a 20 20 7b 20 22 70 72 65 61 64 AD64). { "pread
3580: 36 34 22 2c 20 20 20 20 20 20 28 73 71 6c 69 74 64", (sqlit
3590: 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 70 e3_syscall_ptr)p
35a0: 72 65 61 64 36 34 2c 20 20 20 20 30 20 20 7d 2c read64, 0 },
35b0: 0a 23 65 6c 73 65 0a 20 20 7b 20 22 70 72 65 61 .#else. { "prea
35c0: 64 36 34 22 2c 20 20 20 20 20 20 28 73 71 6c 69 d64", (sqli
35d0: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 te3_syscall_ptr)
35e0: 30 2c 20 20 20 20 20 20 20 20 20 20 30 20 20 7d 0, 0 }
35f0: 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65 ,.#endif.#define
3600: 20 6f 73 50 72 65 61 64 36 34 20 28 28 73 73 69 osPread64 ((ssi
3610: 7a 65 5f 74 28 2a 29 28 69 6e 74 2c 76 6f 69 64 ze_t(*)(int,void
3620: 2a 2c 73 69 7a 65 5f 74 2c 6f 66 66 36 34 5f 74 *,size_t,off64_t
3630: 29 29 61 53 79 73 63 61 6c 6c 5b 31 30 5d 2e 70 ))aSyscall[10].p
3640: 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22 77 Current).. { "w
3650: 72 69 74 65 22 2c 20 20 20 20 20 20 20 20 28 73 rite", (s
3660: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 qlite3_syscall_p
3670: 74 72 29 77 72 69 74 65 2c 20 20 20 20 20 20 30 tr)write, 0
3680: 20 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73 57 },.#define osW
3690: 72 69 74 65 20 20 20 20 20 28 28 73 73 69 7a 65 rite ((ssize
36a0: 5f 74 28 2a 29 28 69 6e 74 2c 63 6f 6e 73 74 20 _t(*)(int,const
36b0: 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 29 29 61 53 void*,size_t))aS
36c0: 79 73 63 61 6c 6c 5b 31 31 5d 2e 70 43 75 72 72 yscall[11].pCurr
36d0: 65 6e 74 29 0a 0a 23 69 66 20 64 65 66 69 6e 65 ent)..#if define
36e0: 64 28 55 53 45 5f 50 52 45 41 44 29 20 7c 7c 20 d(USE_PREAD) ||
36f0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f SQLITE_ENABLE_LO
3700: 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 7b 20 CKING_STYLE. {
3710: 22 70 77 72 69 74 65 22 2c 20 20 20 20 20 20 20 "pwrite",
3720: 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c (sqlite3_syscall
3730: 5f 70 74 72 29 70 77 72 69 74 65 2c 20 20 20 20 _ptr)pwrite,
3740: 20 30 20 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 0 },.#else. {
3750: 20 22 70 77 72 69 74 65 22 2c 20 20 20 20 20 20 "pwrite",
3760: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c (sqlite3_syscal
3770: 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20 l_ptr)0,
3780: 20 20 30 20 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 0 },.#endif.#
3790: 64 65 66 69 6e 65 20 6f 73 50 77 72 69 74 65 20 define osPwrite
37a0: 20 20 20 28 28 73 73 69 7a 65 5f 74 28 2a 29 28 ((ssize_t(*)(
37b0: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
37c0: 73 69 7a 65 5f 74 2c 6f 66 66 5f 74 29 29 5c 0a size_t,off_t))\.
37d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37e0: 20 20 20 20 61 53 79 73 63 61 6c 6c 5b 31 32 5d aSyscall[12]
37f0: 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66 20 .pCurrent)..#if
3800: 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 defined(USE_PREA
3810: 44 36 34 29 0a 20 20 7b 20 22 70 77 72 69 74 65 D64). { "pwrite
3820: 36 34 22 2c 20 20 20 20 20 28 73 71 6c 69 74 65 64", (sqlite
3830: 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 70 77 3_syscall_ptr)pw
3840: 72 69 74 65 36 34 2c 20 20 20 30 20 20 7d 2c 0a rite64, 0 },.
3850: 23 65 6c 73 65 0a 20 20 7b 20 22 70 77 72 69 74 #else. { "pwrit
3860: 65 36 34 22 2c 20 20 20 20 20 28 73 71 6c 69 74 e64", (sqlit
3870: 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 e3_syscall_ptr)0
3880: 2c 20 20 20 20 20 20 20 20 20 20 30 20 20 7d 2c , 0 },
3890: 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65 20 .#endif.#define
38a0: 6f 73 50 77 72 69 74 65 36 34 20 20 28 28 73 73 osPwrite64 ((ss
38b0: 69 7a 65 5f 74 28 2a 29 28 69 6e 74 2c 63 6f 6e ize_t(*)(int,con
38c0: 73 74 20 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 2c st void*,size_t,
38d0: 6f 66 66 36 34 5f 74 29 29 5c 0a 20 20 20 20 20 off64_t))\.
38e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
38f0: 53 79 73 63 61 6c 6c 5b 31 33 5d 2e 70 43 75 72 Syscall[13].pCur
3900: 72 65 6e 74 29 0a 0a 20 20 7b 20 22 66 63 68 6d rent).. { "fchm
3910: 6f 64 22 2c 20 20 20 20 20 20 20 28 73 71 6c 69 od", (sqli
3920: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 te3_syscall_ptr)
3930: 66 63 68 6d 6f 64 2c 20 20 20 20 20 20 20 20 20 fchmod,
3940: 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 0 },.#define o
3950: 73 46 63 68 6d 6f 64 20 20 20 20 28 28 69 6e 74 sFchmod ((int
3960: 28 2a 29 28 69 6e 74 2c 6d 6f 64 65 5f 74 29 29 (*)(int,mode_t))
3970: 61 53 79 73 63 61 6c 6c 5b 31 34 5d 2e 70 43 75 aSyscall[14].pCu
3980: 72 72 65 6e 74 29 0a 0a 23 69 66 20 64 65 66 69 rrent)..#if defi
3990: 6e 65 64 28 48 41 56 45 5f 50 4f 53 49 58 5f 46 ned(HAVE_POSIX_F
39a0: 41 4c 4c 4f 43 41 54 45 29 20 26 26 20 48 41 56 ALLOCATE) && HAV
39b0: 45 5f 50 4f 53 49 58 5f 46 41 4c 4c 4f 43 41 54 E_POSIX_FALLOCAT
39c0: 45 0a 20 20 7b 20 22 66 61 6c 6c 6f 63 61 74 65 E. { "fallocate
39d0: 22 2c 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 ", (sqlite3_s
39e0: 79 73 63 61 6c 6c 5f 70 74 72 29 70 6f 73 69 78 yscall_ptr)posix
39f0: 5f 66 61 6c 6c 6f 63 61 74 65 2c 20 20 30 20 7d _fallocate, 0 }
3a00: 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 66 61 6c ,.#else. { "fal
3a10: 6c 6f 63 61 74 65 22 2c 20 20 20 20 28 73 71 6c locate", (sql
3a20: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 ite3_syscall_ptr
3a30: 29 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 )0,
3a40: 20 20 20 30 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 0 },.#endif.#
3a50: 64 65 66 69 6e 65 20 6f 73 46 61 6c 6c 6f 63 61 define osFalloca
3a60: 74 65 20 28 28 69 6e 74 28 2a 29 28 69 6e 74 2c te ((int(*)(int,
3a70: 6f 66 66 5f 74 2c 6f 66 66 5f 74 29 29 61 53 79 off_t,off_t))aSy
3a80: 73 63 61 6c 6c 5b 31 35 5d 2e 70 43 75 72 72 65 scall[15].pCurre
3a90: 6e 74 29 0a 0a 20 20 7b 20 22 75 6e 6c 69 6e 6b nt).. { "unlink
3aa0: 22 2c 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 ", (sqlite
3ab0: 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 75 6e 3_syscall_ptr)un
3ac0: 6c 69 6e 6b 2c 20 20 20 20 20 20 20 20 20 20 20 link,
3ad0: 30 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73 55 0 },.#define osU
3ae0: 6e 6c 69 6e 6b 20 20 20 20 28 28 69 6e 74 28 2a nlink ((int(*
3af0: 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 61 )(const char*))a
3b00: 53 79 73 63 61 6c 6c 5b 31 36 5d 2e 70 43 75 72 Syscall[16].pCur
3b10: 72 65 6e 74 29 0a 0a 20 20 7b 20 22 6f 70 65 6e rent).. { "open
3b20: 44 69 72 65 63 74 6f 72 79 22 2c 20 20 20 20 28 Directory", (
3b30: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f sqlite3_syscall_
3b40: 70 74 72 29 6f 70 65 6e 44 69 72 65 63 74 6f 72 ptr)openDirector
3b50: 79 2c 20 20 20 20 20 20 30 20 7d 2c 0a 23 64 65 y, 0 },.#de
3b60: 66 69 6e 65 20 6f 73 4f 70 65 6e 44 69 72 65 63 fine osOpenDirec
3b70: 74 6f 72 79 20 28 28 69 6e 74 28 2a 29 28 63 6f tory ((int(*)(co
3b80: 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 2a 29 29 nst char*,int*))
3b90: 61 53 79 73 63 61 6c 6c 5b 31 37 5d 2e 70 43 75 aSyscall[17].pCu
3ba0: 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22 6d 6b 64 rrent).. { "mkd
3bb0: 69 72 22 2c 20 20 20 20 20 20 20 20 28 73 71 6c ir", (sql
3bc0: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 ite3_syscall_ptr
3bd0: 29 6d 6b 64 69 72 2c 20 20 20 20 20 20 20 20 20 )mkdir,
3be0: 20 20 30 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 0 },.#define o
3bf0: 73 4d 6b 64 69 72 20 20 20 20 20 28 28 69 6e 74 sMkdir ((int
3c00: 28 2a 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c (*)(const char*,
3c10: 6d 6f 64 65 5f 74 29 29 61 53 79 73 63 61 6c 6c mode_t))aSyscall
3c20: 5b 31 38 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a [18].pCurrent)..
3c30: 20 20 7b 20 22 72 6d 64 69 72 22 2c 20 20 20 20 { "rmdir",
3c40: 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 (sqlite3_sys
3c50: 63 61 6c 6c 5f 70 74 72 29 72 6d 64 69 72 2c 20 call_ptr)rmdir,
3c60: 20 20 20 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 0 },.#
3c70: 64 65 66 69 6e 65 20 6f 73 52 6d 64 69 72 20 20 define osRmdir
3c80: 20 20 20 28 28 69 6e 74 28 2a 29 28 63 6f 6e 73 ((int(*)(cons
3c90: 74 20 63 68 61 72 2a 29 29 61 53 79 73 63 61 6c t char*))aSyscal
3ca0: 6c 5b 31 39 5d 2e 70 43 75 72 72 65 6e 74 29 0a l[19].pCurrent).
3cb0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 48 41 56 .#if defined(HAV
3cc0: 45 5f 46 43 48 4f 57 4e 29 0a 20 20 7b 20 22 66 E_FCHOWN). { "f
3cd0: 63 68 6f 77 6e 22 2c 20 20 20 20 20 20 20 28 73 chown", (s
3ce0: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 qlite3_syscall_p
3cf0: 74 72 29 66 63 68 6f 77 6e 2c 20 20 20 20 20 20 tr)fchown,
3d00: 20 20 20 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 0 },.#else.
3d10: 20 7b 20 22 66 63 68 6f 77 6e 22 2c 20 20 20 20 { "fchown",
3d20: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
3d30: 61 6c 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 all_ptr)0,
3d40: 20 20 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 0 },.#e
3d50: 6e 64 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 46 ndif.#define osF
3d60: 63 68 6f 77 6e 20 20 20 20 28 28 69 6e 74 28 2a chown ((int(*
3d70: 29 28 69 6e 74 2c 75 69 64 5f 74 2c 67 69 64 5f )(int,uid_t,gid_
3d80: 74 29 29 61 53 79 73 63 61 6c 6c 5b 32 30 5d 2e t))aSyscall[20].
3d90: 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22 pCurrent).. { "
3da0: 67 65 74 65 75 69 64 22 2c 20 20 20 20 20 20 28 geteuid", (
3db0: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f sqlite3_syscall_
3dc0: 70 74 72 29 67 65 74 65 75 69 64 2c 20 20 20 20 ptr)geteuid,
3dd0: 20 20 20 20 20 30 20 7d 2c 0a 23 64 65 66 69 6e 0 },.#defin
3de0: 65 20 6f 73 47 65 74 65 75 69 64 20 20 20 28 28 e osGeteuid ((
3df0: 75 69 64 5f 74 28 2a 29 28 76 6f 69 64 29 29 61 uid_t(*)(void))a
3e00: 53 79 73 63 61 6c 6c 5b 32 31 5d 2e 70 43 75 72 Syscall[21].pCur
3e10: 72 65 6e 74 29 0a 0a 23 69 66 20 21 64 65 66 69 rent)..#if !defi
3e20: 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
3e30: 57 41 4c 29 20 7c 7c 20 53 51 4c 49 54 45 5f 4d WAL) || SQLITE_M
3e40: 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 AX_MMAP_SIZE>0.
3e50: 20 7b 20 22 6d 6d 61 70 22 2c 20 20 20 20 20 20 { "mmap",
3e60: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
3e70: 61 6c 6c 5f 70 74 72 29 6d 6d 61 70 2c 20 20 20 all_ptr)mmap,
3e80: 20 20 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 0 },.#e
3e90: 6c 73 65 0a 20 20 7b 20 22 6d 6d 61 70 22 2c 20 lse. { "mmap",
3ea0: 20 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 (sqlite3
3eb0: 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 _syscall_ptr)0,
3ec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 0
3ed0: 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e },.#endif.#defin
3ee0: 65 20 6f 73 4d 6d 61 70 20 28 28 76 6f 69 64 2a e osMmap ((void*
3ef0: 28 2a 29 28 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 (*)(void*,size_t
3f00: 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 6f 66 66 ,int,int,int,off
3f10: 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b 32 32 5d _t))aSyscall[22]
3f20: 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66 20 .pCurrent)..#if
3f30: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
3f40: 4f 4d 49 54 5f 57 41 4c 29 20 7c 7c 20 53 51 4c OMIT_WAL) || SQL
3f50: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
3f60: 45 3e 30 0a 20 20 7b 20 22 6d 75 6e 6d 61 70 22 E>0. { "munmap"
3f70: 2c 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 , (sqlite3
3f80: 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 6d 75 6e _syscall_ptr)mun
3f90: 6d 61 70 2c 20 20 20 20 20 20 20 20 20 20 30 20 map, 0
3fa0: 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 6d 75 },.#else. { "mu
3fb0: 6e 6d 61 70 22 2c 20 20 20 20 20 20 20 28 73 71 nmap", (sq
3fc0: 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 lite3_syscall_pt
3fd0: 72 29 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 r)0,
3fe0: 20 20 20 30 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 0 },.#endif.#
3ff0: 64 65 66 69 6e 65 20 6f 73 4d 75 6e 6d 61 70 20 define osMunmap
4000: 28 28 76 6f 69 64 2a 28 2a 29 28 76 6f 69 64 2a ((void*(*)(void*
4010: 2c 73 69 7a 65 5f 74 29 29 61 53 79 73 63 61 6c ,size_t))aSyscal
4020: 6c 5b 32 33 5d 2e 70 43 75 72 72 65 6e 74 29 0a l[23].pCurrent).
4030: 0a 23 69 66 20 48 41 56 45 5f 4d 52 45 4d 41 50 .#if HAVE_MREMAP
4040: 20 26 26 20 28 21 64 65 66 69 6e 65 64 28 53 51 && (!defined(SQ
4050: 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 20 7c LITE_OMIT_WAL) |
4060: 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 | SQLITE_MAX_MMA
4070: 50 5f 53 49 5a 45 3e 30 29 0a 20 20 7b 20 22 6d P_SIZE>0). { "m
4080: 72 65 6d 61 70 22 2c 20 20 20 20 20 20 20 28 73 remap", (s
4090: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 qlite3_syscall_p
40a0: 74 72 29 6d 72 65 6d 61 70 2c 20 20 20 20 20 20 tr)mremap,
40b0: 20 20 20 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 0 },.#else.
40c0: 20 7b 20 22 6d 72 65 6d 61 70 22 2c 20 20 20 20 { "mremap",
40d0: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 (sqlite3_sysc
40e0: 61 6c 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 all_ptr)0,
40f0: 20 20 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 0 },.#e
4100: 6e 64 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 4d ndif.#define osM
4110: 72 65 6d 61 70 20 28 28 76 6f 69 64 2a 28 2a 29 remap ((void*(*)
4120: 28 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 2c 73 69 (void*,size_t,si
4130: 7a 65 5f 74 2c 69 6e 74 2c 2e 2e 2e 29 29 61 53 ze_t,int,...))aS
4140: 79 73 63 61 6c 6c 5b 32 34 5d 2e 70 43 75 72 72 yscall[24].pCurr
4150: 65 6e 74 29 0a 0a 23 69 66 20 21 64 65 66 69 6e ent)..#if !defin
4160: 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ed(SQLITE_OMIT_W
4170: 41 4c 29 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 AL) || SQLITE_MA
4180: 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 X_MMAP_SIZE>0.
4190: 7b 20 22 67 65 74 70 61 67 65 73 69 7a 65 22 2c { "getpagesize",
41a0: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 (sqlite3_sysca
41b0: 6c 6c 5f 70 74 72 29 75 6e 69 78 47 65 74 70 61 ll_ptr)unixGetpa
41c0: 67 65 73 69 7a 65 2c 20 30 20 7d 2c 0a 23 65 6c gesize, 0 },.#el
41d0: 73 65 0a 20 20 7b 20 22 67 65 74 70 61 67 65 73 se. { "getpages
41e0: 69 7a 65 22 2c 20 20 28 73 71 6c 69 74 65 33 5f ize", (sqlite3_
41f0: 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 20 syscall_ptr)0,
4200: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 7d 0 }
4210: 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65 ,.#endif.#define
4220: 20 6f 73 47 65 74 70 61 67 65 73 69 7a 65 20 28 osGetpagesize (
4230: 28 69 6e 74 28 2a 29 28 76 6f 69 64 29 29 61 53 (int(*)(void))aS
4240: 79 73 63 61 6c 6c 5b 32 35 5d 2e 70 43 75 72 72 yscall[25].pCurr
4250: 65 6e 74 29 0a 0a 23 69 66 20 64 65 66 69 6e 65 ent)..#if define
4260: 64 28 48 41 56 45 5f 52 45 41 44 4c 49 4e 4b 29 d(HAVE_READLINK)
4270: 0a 20 20 7b 20 22 72 65 61 64 6c 69 6e 6b 22 2c . { "readlink",
4280: 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 (sqlite3_sy
4290: 73 63 61 6c 6c 5f 70 74 72 29 72 65 61 64 6c 69 scall_ptr)readli
42a0: 6e 6b 2c 20 20 20 20 20 20 20 20 30 20 7d 2c 0a nk, 0 },.
42b0: 23 65 6c 73 65 0a 20 20 7b 20 22 72 65 61 64 6c #else. { "readl
42c0: 69 6e 6b 22 2c 20 20 20 20 20 28 73 71 6c 69 74 ink", (sqlit
42d0: 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 e3_syscall_ptr)0
42e0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
42f0: 30 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66 0 },.#endif.#def
4300: 69 6e 65 20 6f 73 52 65 61 64 6c 69 6e 6b 20 28 ine osReadlink (
4310: 28 73 73 69 7a 65 5f 74 28 2a 29 28 63 6f 6e 73 (ssize_t(*)(cons
4320: 74 20 63 68 61 72 2a 2c 63 68 61 72 2a 2c 73 69 t char*,char*,si
4330: 7a 65 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b 32 ze_t))aSyscall[2
4340: 36 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 6].pCurrent)..#i
4350: 66 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f 4c f defined(HAVE_L
4360: 53 54 41 54 29 0a 20 20 7b 20 22 6c 73 74 61 74 STAT). { "lstat
4370: 22 2c 20 20 20 20 20 20 20 20 20 28 73 71 6c 69 ", (sqli
4380: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 te3_syscall_ptr)
4390: 6c 73 74 61 74 2c 20 20 20 20 20 20 20 20 20 20 lstat,
43a0: 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 0 },.#else. { "
43b0: 6c 73 74 61 74 22 2c 20 20 20 20 20 20 20 20 20 lstat",
43c0: 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c (sqlite3_syscall
43d0: 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 _ptr)0,
43e0: 20 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64 69 66 0 },.#endif
43f0: 0a 23 64 65 66 69 6e 65 20 6f 73 4c 73 74 61 74 .#define osLstat
4400: 20 20 20 20 20 20 28 28 69 6e 74 28 2a 29 28 63 ((int(*)(c
4410: 6f 6e 73 74 20 63 68 61 72 2a 2c 73 74 72 75 63 onst char*,struc
4420: 74 20 73 74 61 74 2a 29 29 61 53 79 73 63 61 6c t stat*))aSyscal
4430: 6c 5b 32 37 5d 2e 70 43 75 72 72 65 6e 74 29 0a l[27].pCurrent).
4440: 0a 7d 3b 20 2f 2a 20 45 6e 64 20 6f 66 20 74 68 .}; /* End of th
4450: 65 20 6f 76 65 72 72 69 64 65 61 62 6c 65 20 73 e overrideable s
4460: 79 73 74 65 6d 20 63 61 6c 6c 73 20 2a 2f 0a 0a ystem calls */..
4470: 0a 2f 2a 0a 2a 2a 20 4f 6e 20 73 6f 6d 65 20 73 ./*.** On some s
4480: 79 73 74 65 6d 73 2c 20 63 61 6c 6c 73 20 74 6f ystems, calls to
4490: 20 66 63 68 6f 77 6e 28 29 20 77 69 6c 6c 20 74 fchown() will t
44a0: 72 69 67 67 65 72 20 61 20 6d 65 73 73 61 67 65 rigger a message
44b0: 20 69 6e 20 61 20 73 65 63 75 72 69 74 79 0a 2a in a security.*
44c0: 2a 20 6c 6f 67 20 69 66 20 74 68 65 79 20 63 6f * log if they co
44d0: 6d 65 20 66 72 6f 6d 20 6e 6f 6e 2d 72 6f 6f 74 me from non-root
44e0: 20 70 72 6f 63 65 73 73 65 73 2e 20 20 53 6f 20 processes. So
44f0: 61 76 6f 69 64 20 63 61 6c 6c 69 6e 67 20 66 63 avoid calling fc
4500: 68 6f 77 6e 28 29 20 69 66 0a 2a 2a 20 77 65 20 hown() if.** we
4510: 61 72 65 20 6e 6f 74 20 72 75 6e 6e 69 6e 67 20 are not running
4520: 61 73 20 72 6f 6f 74 2e 0a 2a 2f 0a 73 74 61 74 as root..*/.stat
4530: 69 63 20 69 6e 74 20 72 6f 62 75 73 74 46 63 68 ic int robustFch
4540: 6f 77 6e 28 69 6e 74 20 66 64 2c 20 75 69 64 5f own(int fd, uid_
4550: 74 20 75 69 64 2c 20 67 69 64 5f 74 20 67 69 64 t uid, gid_t gid
4560: 29 7b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 48 ){.#if defined(H
4570: 41 56 45 5f 46 43 48 4f 57 4e 29 0a 20 20 72 65 AVE_FCHOWN). re
4580: 74 75 72 6e 20 6f 73 47 65 74 65 75 69 64 28 29 turn osGeteuid()
4590: 20 3f 20 30 20 3a 20 6f 73 46 63 68 6f 77 6e 28 ? 0 : osFchown(
45a0: 66 64 2c 75 69 64 2c 67 69 64 29 3b 0a 23 65 6c fd,uid,gid);.#el
45b0: 73 65 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 23 se. return 0;.#
45c0: 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 endif.}../*.** T
45d0: 68 69 73 20 69 73 20 74 68 65 20 78 53 65 74 53 his is the xSetS
45e0: 79 73 74 65 6d 43 61 6c 6c 28 29 20 6d 65 74 68 ystemCall() meth
45f0: 6f 64 20 6f 66 20 73 71 6c 69 74 65 33 5f 76 66 od of sqlite3_vf
4600: 73 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 s for all of the
4610: 0a 2a 2a 20 22 75 6e 69 78 22 20 56 46 53 65 73 .** "unix" VFSes
4620: 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 . Return SQLITE
4630: 5f 4f 4b 20 6f 70 6f 6e 20 73 75 63 63 65 73 73 _OK opon success
4640: 66 75 6c 6c 79 20 75 70 64 61 74 69 6e 67 20 74 fully updating t
4650: 68 65 0a 2a 2a 20 73 79 73 74 65 6d 20 63 61 6c he.** system cal
4660: 6c 20 70 6f 69 6e 74 65 72 2c 20 6f 72 20 53 51 l pointer, or SQ
4670: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 69 66 LITE_NOTFOUND if
4680: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6e there is no con
4690: 66 69 67 75 72 61 62 6c 65 0a 2a 2a 20 73 79 73 figurable.** sys
46a0: 74 65 6d 20 63 61 6c 6c 20 6e 61 6d 65 64 20 7a tem call named z
46b0: 4e 61 6d 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 Name..*/.static
46c0: 69 6e 74 20 75 6e 69 78 53 65 74 53 79 73 74 65 int unixSetSyste
46d0: 6d 43 61 6c 6c 28 0a 20 20 73 71 6c 69 74 65 33 mCall(. sqlite3
46e0: 5f 76 66 73 20 2a 70 4e 6f 74 55 73 65 64 2c 20 _vfs *pNotUsed,
46f0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 46 /* The VF
4700: 53 20 70 6f 69 6e 74 65 72 2e 20 20 4e 6f 74 20 S pointer. Not
4710: 75 73 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 used */. const
4720: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 20 20 20 char *zName,
4730: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
4740: 6f 66 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 74 of system call t
4750: 6f 20 6f 76 65 72 72 69 64 65 20 2a 2f 0a 20 20 o override */.
4760: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f sqlite3_syscall_
4770: 70 74 72 20 70 4e 65 77 46 75 6e 63 20 20 2f 2a ptr pNewFunc /*
4780: 20 50 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 Pointer to new
4790: 73 79 73 74 65 6d 20 63 61 6c 6c 20 76 61 6c 75 system call valu
47a0: 65 20 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 6e e */.){. unsign
47b0: 65 64 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 ed int i;. int
47c0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 46 rc = SQLITE_NOTF
47d0: 4f 55 4e 44 3b 0a 0a 20 20 55 4e 55 53 45 44 5f OUND;.. UNUSED_
47e0: 50 41 52 41 4d 45 54 45 52 28 70 4e 6f 74 55 73 PARAMETER(pNotUs
47f0: 65 64 29 3b 0a 20 20 69 66 28 20 7a 4e 61 6d 65 ed);. if( zName
4800: 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 ==0 ){. /* If
4810: 20 6e 6f 20 7a 4e 61 6d 65 20 69 73 20 67 69 76 no zName is giv
4820: 65 6e 2c 20 72 65 73 74 6f 72 65 20 61 6c 6c 20 en, restore all
4830: 73 79 73 74 65 6d 20 63 61 6c 6c 73 20 74 6f 20 system calls to
4840: 74 68 65 69 72 20 64 65 66 61 75 6c 74 0a 20 20 their default.
4850: 20 20 2a 2a 20 73 65 74 74 69 6e 67 73 20 61 6e ** settings an
4860: 64 20 72 65 74 75 72 6e 20 4e 55 4c 4c 0a 20 20 d return NULL.
4870: 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 */. rc = SQ
4880: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 66 6f 72 LITE_OK;. for
4890: 28 69 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28 61 (i=0; i<sizeof(a
48a0: 53 79 73 63 61 6c 6c 29 2f 73 69 7a 65 6f 66 28 Syscall)/sizeof(
48b0: 61 53 79 73 63 61 6c 6c 5b 30 5d 29 3b 20 69 2b aSyscall[0]); i+
48c0: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 61 53 +){. if( aS
48d0: 79 73 63 61 6c 6c 5b 69 5d 2e 70 44 65 66 61 75 yscall[i].pDefau
48e0: 6c 74 20 29 7b 0a 20 20 20 20 20 20 20 20 61 53 lt ){. aS
48f0: 79 73 63 61 6c 6c 5b 69 5d 2e 70 43 75 72 72 65 yscall[i].pCurre
4900: 6e 74 20 3d 20 61 53 79 73 63 61 6c 6c 5b 69 5d nt = aSyscall[i]
4910: 2e 70 44 65 66 61 75 6c 74 3b 0a 20 20 20 20 20 .pDefault;.
4920: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 }. }. }else
4930: 7b 0a 20 20 20 20 2f 2a 20 49 66 20 7a 4e 61 6d {. /* If zNam
4940: 65 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 e is specified,
4950: 6f 70 65 72 61 74 65 20 6f 6e 20 6f 6e 6c 79 20 operate on only
4960: 74 68 65 20 6f 6e 65 20 73 79 73 74 65 6d 20 63 the one system c
4970: 61 6c 6c 0a 20 20 20 20 2a 2a 20 73 70 65 63 69 all. ** speci
4980: 66 69 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 fied.. */.
4990: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65 for(i=0; i<size
49a0: 6f 66 28 61 53 79 73 63 61 6c 6c 29 2f 73 69 7a of(aSyscall)/siz
49b0: 65 6f 66 28 61 53 79 73 63 61 6c 6c 5b 30 5d 29 eof(aSyscall[0])
49c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 ; i++){. if
49d0: 28 20 73 74 72 63 6d 70 28 7a 4e 61 6d 65 2c 20 ( strcmp(zName,
49e0: 61 53 79 73 63 61 6c 6c 5b 69 5d 2e 7a 4e 61 6d aSyscall[i].zNam
49f0: 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 e)==0 ){.
4a00: 20 69 66 28 20 61 53 79 73 63 61 6c 6c 5b 69 5d if( aSyscall[i]
4a10: 2e 70 44 65 66 61 75 6c 74 3d 3d 30 20 29 7b 0a .pDefault==0 ){.
4a20: 20 20 20 20 20 20 20 20 20 20 61 53 79 73 63 61 aSysca
4a30: 6c 6c 5b 69 5d 2e 70 44 65 66 61 75 6c 74 20 3d ll[i].pDefault =
4a40: 20 61 53 79 73 63 61 6c 6c 5b 69 5d 2e 70 43 75 aSyscall[i].pCu
4a50: 72 72 65 6e 74 3b 0a 20 20 20 20 20 20 20 20 7d rrent;. }
4a60: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
4a70: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
4a80: 20 69 66 28 20 70 4e 65 77 46 75 6e 63 3d 3d 30 if( pNewFunc==0
4a90: 20 29 20 70 4e 65 77 46 75 6e 63 20 3d 20 61 53 ) pNewFunc = aS
4aa0: 79 73 63 61 6c 6c 5b 69 5d 2e 70 44 65 66 61 75 yscall[i].pDefau
4ab0: 6c 74 3b 0a 20 20 20 20 20 20 20 20 61 53 79 73 lt;. aSys
4ac0: 63 61 6c 6c 5b 69 5d 2e 70 43 75 72 72 65 6e 74 call[i].pCurrent
4ad0: 20 3d 20 70 4e 65 77 46 75 6e 63 3b 0a 20 20 20 = pNewFunc;.
4ae0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
4af0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 }. }. }.
4b00: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
4b10: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 .** Return the v
4b20: 61 6c 75 65 20 6f 66 20 61 20 73 79 73 74 65 6d alue of a system
4b30: 20 63 61 6c 6c 2e 20 20 52 65 74 75 72 6e 20 4e call. Return N
4b40: 55 4c 4c 20 69 66 20 7a 4e 61 6d 65 20 69 73 20 ULL if zName is
4b50: 6e 6f 74 20 61 0a 2a 2a 20 72 65 63 6f 67 6e 69 not a.** recogni
4b60: 7a 65 64 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 zed system call
4b70: 6e 61 6d 65 2e 20 20 4e 55 4c 4c 20 69 73 20 61 name. NULL is a
4b80: 6c 73 6f 20 72 65 74 75 72 6e 65 64 20 69 66 20 lso returned if
4b90: 74 68 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 0a the system call.
4ba0: 2a 2a 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 ** is currently
4bb0: 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 undefined..*/.st
4bc0: 61 74 69 63 20 73 71 6c 69 74 65 33 5f 73 79 73 atic sqlite3_sys
4bd0: 63 61 6c 6c 5f 70 74 72 20 75 6e 69 78 47 65 74 call_ptr unixGet
4be0: 53 79 73 74 65 6d 43 61 6c 6c 28 0a 20 20 73 71 SystemCall(. sq
4bf0: 6c 69 74 65 33 5f 76 66 73 20 2a 70 4e 6f 74 55 lite3_vfs *pNotU
4c00: 73 65 64 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 sed,. const cha
4c10: 72 20 2a 7a 4e 61 6d 65 0a 29 7b 0a 20 20 75 6e r *zName.){. un
4c20: 73 69 67 6e 65 64 20 69 6e 74 20 69 3b 0a 0a 20 signed int i;..
4c30: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
4c40: 52 28 70 4e 6f 74 55 73 65 64 29 3b 0a 20 20 66 R(pNotUsed);. f
4c50: 6f 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 or(i=0; i<sizeof
4c60: 28 61 53 79 73 63 61 6c 6c 29 2f 73 69 7a 65 6f (aSyscall)/sizeo
4c70: 66 28 61 53 79 73 63 61 6c 6c 5b 30 5d 29 3b 20 f(aSyscall[0]);
4c80: 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 73 74 i++){. if( st
4c90: 72 63 6d 70 28 7a 4e 61 6d 65 2c 20 61 53 79 73 rcmp(zName, aSys
4ca0: 63 61 6c 6c 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d call[i].zName)==
4cb0: 30 20 29 20 72 65 74 75 72 6e 20 61 53 79 73 63 0 ) return aSysc
4cc0: 61 6c 6c 5b 69 5d 2e 70 43 75 72 72 65 6e 74 3b all[i].pCurrent;
4cd0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b . }. return 0;
4ce0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
4cf0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
4d00: 20 66 69 72 73 74 20 73 79 73 74 65 6d 20 63 61 first system ca
4d10: 6c 6c 20 61 66 74 65 72 20 7a 4e 61 6d 65 2e 20 ll after zName.
4d20: 20 49 66 20 7a 4e 61 6d 65 3d 3d 4e 55 4c 4c 0a If zName==NULL.
4d30: 2a 2a 20 74 68 65 6e 20 72 65 74 75 72 6e 20 74 ** then return t
4d40: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 he name of the f
4d50: 69 72 73 74 20 73 79 73 74 65 6d 20 63 61 6c 6c irst system call
4d60: 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69 . Return NULL i
4d70: 66 20 7a 4e 61 6d 65 0a 2a 2a 20 69 73 20 74 68 f zName.** is th
4d80: 65 20 6c 61 73 74 20 73 79 73 74 65 6d 20 63 61 e last system ca
4d90: 6c 6c 20 6f 72 20 69 66 20 7a 4e 61 6d 65 20 69 ll or if zName i
4da0: 73 20 6e 6f 74 20 74 68 65 20 6e 61 6d 65 20 6f s not the name o
4db0: 66 20 61 20 76 61 6c 69 64 0a 2a 2a 20 73 79 73 f a valid.** sys
4dc0: 74 65 6d 20 63 61 6c 6c 2e 0a 2a 2f 0a 73 74 61 tem call..*/.sta
4dd0: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a tic const char *
4de0: 75 6e 69 78 4e 65 78 74 53 79 73 74 65 6d 43 61 unixNextSystemCa
4df0: 6c 6c 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a ll(sqlite3_vfs *
4e00: 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a p, const char *z
4e10: 4e 61 6d 65 29 7b 0a 20 20 69 6e 74 20 69 20 3d Name){. int i =
4e20: 20 2d 31 3b 0a 0a 20 20 55 4e 55 53 45 44 5f 50 -1;.. UNUSED_P
4e30: 41 52 41 4d 45 54 45 52 28 70 29 3b 0a 20 20 69 ARAMETER(p);. i
4e40: 66 28 20 7a 4e 61 6d 65 20 29 7b 0a 20 20 20 20 f( zName ){.
4e50: 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72 61 79 for(i=0; i<Array
4e60: 53 69 7a 65 28 61 53 79 73 63 61 6c 6c 29 2d 31 Size(aSyscall)-1
4e70: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 ; i++){. if
4e80: 28 20 73 74 72 63 6d 70 28 7a 4e 61 6d 65 2c 20 ( strcmp(zName,
4e90: 61 53 79 73 63 61 6c 6c 5b 69 5d 2e 7a 4e 61 6d aSyscall[i].zNam
4ea0: 65 29 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 e)==0 ) break;.
4eb0: 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 69 }. }. for(i
4ec0: 2b 2b 3b 20 69 3c 41 72 72 61 79 53 69 7a 65 28 ++; i<ArraySize(
4ed0: 61 53 79 73 63 61 6c 6c 29 3b 20 69 2b 2b 29 7b aSyscall); i++){
4ee0: 0a 20 20 20 20 69 66 28 20 61 53 79 73 63 61 6c . if( aSyscal
4ef0: 6c 5b 69 5d 2e 70 43 75 72 72 65 6e 74 21 3d 30 l[i].pCurrent!=0
4f00: 20 29 20 72 65 74 75 72 6e 20 61 53 79 73 63 61 ) return aSysca
4f10: 6c 6c 5b 69 5d 2e 7a 4e 61 6d 65 3b 0a 20 20 7d ll[i].zName;. }
4f20: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a . return 0;.}..
4f30: 2f 2a 0a 2a 2a 20 44 6f 20 6e 6f 74 20 61 63 63 /*.** Do not acc
4f40: 65 70 74 20 61 6e 79 20 66 69 6c 65 20 64 65 73 ept any file des
4f50: 63 72 69 70 74 6f 72 20 6c 65 73 73 20 74 68 61 criptor less tha
4f60: 6e 20 74 68 69 73 20 76 61 6c 75 65 2c 20 69 6e n this value, in
4f70: 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69 64 0a order to avoid.
4f80: 2a 2a 20 6f 70 65 6e 69 6e 67 20 64 61 74 61 62 ** opening datab
4f90: 61 73 65 20 66 69 6c 65 20 75 73 69 6e 67 20 66 ase file using f
4fa0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 ile descriptors
4fb0: 74 68 61 74 20 61 72 65 20 63 6f 6d 6d 6f 6e 6c that are commonl
4fc0: 79 20 75 73 65 64 20 66 6f 72 20 0a 2a 2a 20 73 y used for .** s
4fd0: 74 61 6e 64 61 72 64 20 69 6e 70 75 74 2c 20 6f tandard input, o
4fe0: 75 74 70 75 74 2c 20 61 6e 64 20 65 72 72 6f 72 utput, and error
4ff0: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
5000: 49 54 45 5f 4d 49 4e 49 4d 55 4d 5f 46 49 4c 45 ITE_MINIMUM_FILE
5010: 5f 44 45 53 43 52 49 50 54 4f 52 0a 23 20 64 65 _DESCRIPTOR.# de
5020: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 49 4e 49 fine SQLITE_MINI
5030: 4d 55 4d 5f 46 49 4c 45 5f 44 45 53 43 52 49 50 MUM_FILE_DESCRIP
5040: 54 4f 52 20 33 0a 23 65 6e 64 69 66 0a 0a 2f 2a TOR 3.#endif../*
5050: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 6f 70 65 6e 28 .** Invoke open(
5060: 29 2e 20 20 44 6f 20 73 6f 20 6d 75 6c 74 69 70 ). Do so multip
5070: 6c 65 20 74 69 6d 65 73 2c 20 75 6e 74 69 6c 20 le times, until
5080: 69 74 20 65 69 74 68 65 72 20 73 75 63 63 65 65 it either succee
5090: 64 73 20 6f 72 0a 2a 2a 20 66 61 69 6c 73 20 66 ds or.** fails f
50a0: 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 20 6f or some reason o
50b0: 74 68 65 72 20 74 68 61 6e 20 45 49 4e 54 52 2e ther than EINTR.
50c0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 .**.** If the fi
50d0: 6c 65 20 63 72 65 61 74 69 6f 6e 20 6d 6f 64 65 le creation mode
50e0: 20 22 6d 22 20 69 73 20 30 20 74 68 65 6e 20 73 "m" is 0 then s
50f0: 65 74 20 69 74 20 74 6f 20 74 68 65 20 64 65 66 et it to the def
5100: 61 75 6c 74 20 66 6f 72 0a 2a 2a 20 53 51 4c 69 ault for.** SQLi
5110: 74 65 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 te. The default
5120: 20 69 73 20 53 51 4c 49 54 45 5f 44 45 46 41 55 is SQLITE_DEFAU
5130: 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 LT_FILE_PERMISSI
5140: 4f 4e 53 20 28 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a ONS (normally.**
5150: 20 30 36 34 34 29 20 61 73 20 6d 6f 64 69 66 69 0644) as modifi
5160: 65 64 20 62 79 20 74 68 65 20 73 79 73 74 65 6d ed by the system
5170: 20 75 6d 61 73 6b 2e 20 20 49 66 20 6d 20 69 73 umask. If m is
5180: 20 6e 6f 74 20 30 2c 20 74 68 65 6e 0a 2a 2a 20 not 0, then.**
5190: 6d 61 6b 65 20 74 68 65 20 66 69 6c 65 20 63 72 make the file cr
51a0: 65 61 74 69 6f 6e 20 6d 6f 64 65 20 62 65 20 65 eation mode be e
51b0: 78 61 63 74 6c 79 20 6d 20 69 67 6e 6f 72 69 6e xactly m ignorin
51c0: 67 20 74 68 65 20 75 6d 61 73 6b 2e 0a 2a 2a 0a g the umask..**.
51d0: 2a 2a 20 54 68 65 20 6d 20 70 61 72 61 6d 65 74 ** The m paramet
51e0: 65 72 20 77 69 6c 6c 20 62 65 20 6e 6f 6e 2d 7a er will be non-z
51f0: 65 72 6f 20 6f 6e 6c 79 20 77 68 65 6e 20 63 72 ero only when cr
5200: 65 61 74 69 6e 67 20 2d 77 61 6c 2c 20 2d 6a 6f eating -wal, -jo
5210: 75 72 6e 61 6c 2c 0a 2a 2a 20 61 6e 64 20 2d 73 urnal,.** and -s
5220: 68 6d 20 66 69 6c 65 73 2e 20 20 57 65 20 77 61 hm files. We wa
5230: 6e 74 20 74 68 6f 73 65 20 66 69 6c 65 73 20 74 nt those files t
5240: 6f 20 68 61 76 65 20 2a 65 78 61 63 74 6c 79 2a o have *exactly*
5250: 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 70 65 72 the same.** per
5260: 6d 69 73 73 69 6f 6e 73 20 61 73 20 74 68 65 69 missions as thei
5270: 72 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 r original datab
5280: 61 73 65 2c 20 75 6e 61 64 75 6c 74 65 72 61 74 ase, unadulterat
5290: 65 64 20 62 79 20 74 68 65 20 75 6d 61 73 6b 2e ed by the umask.
52a0: 0a 2a 2a 20 49 6e 20 74 68 61 74 20 77 61 79 2c .** In that way,
52b0: 20 69 66 20 61 20 64 61 74 61 62 61 73 65 20 66 if a database f
52c0: 69 6c 65 20 69 73 20 2d 72 77 2d 72 77 2d 72 77 ile is -rw-rw-rw
52d0: 20 6f 72 20 2d 72 77 2d 72 77 2d 72 2d 2c 20 61 or -rw-rw-r-, a
52e0: 6e 64 20 61 0a 2a 2a 20 74 72 61 6e 73 61 63 74 nd a.** transact
52f0: 69 6f 6e 20 63 72 61 73 68 65 73 20 61 6e 64 20 ion crashes and
5300: 6c 65 61 76 65 73 20 62 65 68 69 6e 64 20 68 6f leaves behind ho
5310: 74 20 6a 6f 75 72 6e 61 6c 73 2c 20 74 68 65 6e t journals, then
5320: 20 61 6e 79 0a 2a 2a 20 70 72 6f 63 65 73 73 20 any.** process
5330: 74 68 61 74 20 69 73 20 61 62 6c 65 20 74 6f 20 that is able to
5340: 77 72 69 74 65 20 74 6f 20 74 68 65 20 64 61 74 write to the dat
5350: 61 62 61 73 65 20 77 69 6c 6c 20 61 6c 73 6f 20 abase will also
5360: 62 65 20 61 62 6c 65 20 74 6f 0a 2a 2a 20 72 65 be able to.** re
5370: 63 6f 76 65 72 20 74 68 65 20 68 6f 74 20 6a 6f cover the hot jo
5380: 75 72 6e 61 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 urnals..*/.stati
5390: 63 20 69 6e 74 20 72 6f 62 75 73 74 5f 6f 70 65 c int robust_ope
53a0: 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c n(const char *z,
53b0: 20 69 6e 74 20 66 2c 20 6d 6f 64 65 5f 74 20 6d int f, mode_t m
53c0: 29 7b 0a 20 20 69 6e 74 20 66 64 3b 0a 20 20 6d ){. int fd;. m
53d0: 6f 64 65 5f 74 20 6d 32 20 3d 20 6d 20 3f 20 6d ode_t m2 = m ? m
53e0: 20 3a 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c : SQLITE_DEFAUL
53f0: 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f T_FILE_PERMISSIO
5400: 4e 53 3b 0a 20 20 77 68 69 6c 65 28 31 29 7b 0a NS;. while(1){.
5410: 23 69 66 20 64 65 66 69 6e 65 64 28 4f 5f 43 4c #if defined(O_CL
5420: 4f 45 58 45 43 29 0a 20 20 20 20 66 64 20 3d 20 OEXEC). fd =
5430: 6f 73 4f 70 65 6e 28 7a 2c 66 7c 4f 5f 43 4c 4f osOpen(z,f|O_CLO
5440: 45 58 45 43 2c 6d 32 29 3b 0a 23 65 6c 73 65 0a EXEC,m2);.#else.
5450: 20 20 20 20 66 64 20 3d 20 6f 73 4f 70 65 6e 28 fd = osOpen(
5460: 7a 2c 66 2c 6d 32 29 3b 0a 23 65 6e 64 69 66 0a z,f,m2);.#endif.
5470: 20 20 20 20 69 66 28 20 66 64 3c 30 20 29 7b 0a if( fd<0 ){.
5480: 20 20 20 20 20 20 69 66 28 20 65 72 72 6e 6f 3d if( errno=
5490: 3d 45 49 4e 54 52 20 29 20 63 6f 6e 74 69 6e 75 =EINTR ) continu
54a0: 65 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a e;. break;.
54b0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 66 64 }. if( fd
54c0: 3e 3d 53 51 4c 49 54 45 5f 4d 49 4e 49 4d 55 4d >=SQLITE_MINIMUM
54d0: 5f 46 49 4c 45 5f 44 45 53 43 52 49 50 54 4f 52 _FILE_DESCRIPTOR
54e0: 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 6f 73 ) break;. os
54f0: 43 6c 6f 73 65 28 66 64 29 3b 0a 20 20 20 20 73 Close(fd);. s
5500: 71 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 qlite3_log(SQLIT
5510: 45 5f 57 41 52 4e 49 4e 47 2c 20 0a 20 20 20 20 E_WARNING, .
5520: 20 20 20 20 20 20 20 20 20 20 20 20 22 61 74 74 "att
5530: 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 5c 22 25 empt to open \"%
5540: 73 5c 22 20 61 73 20 66 69 6c 65 20 64 65 73 63 s\" as file desc
5550: 72 69 70 74 6f 72 20 25 64 22 2c 20 7a 2c 20 66 riptor %d", z, f
5560: 64 29 3b 0a 20 20 20 20 66 64 20 3d 20 2d 31 3b d);. fd = -1;
5570: 0a 20 20 20 20 69 66 28 20 6f 73 4f 70 65 6e 28 . if( osOpen(
5580: 22 2f 64 65 76 2f 6e 75 6c 6c 22 2c 20 66 2c 20 "/dev/null", f,
5590: 6d 29 3c 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 m)<0 ) break;.
55a0: 7d 0a 20 20 69 66 28 20 66 64 3e 3d 30 20 29 7b }. if( fd>=0 ){
55b0: 0a 20 20 20 20 69 66 28 20 6d 21 3d 30 20 29 7b . if( m!=0 ){
55c0: 0a 20 20 20 20 20 20 73 74 72 75 63 74 20 73 74 . struct st
55d0: 61 74 20 73 74 61 74 62 75 66 3b 0a 20 20 20 20 at statbuf;.
55e0: 20 20 69 66 28 20 6f 73 46 73 74 61 74 28 66 64 if( osFstat(fd
55f0: 2c 20 26 73 74 61 74 62 75 66 29 3d 3d 30 20 0a , &statbuf)==0 .
5600: 20 20 20 20 20 20 20 26 26 20 73 74 61 74 62 75 && statbu
5610: 66 2e 73 74 5f 73 69 7a 65 3d 3d 30 0a 20 20 20 f.st_size==0.
5620: 20 20 20 20 26 26 20 28 73 74 61 74 62 75 66 2e && (statbuf.
5630: 73 74 5f 6d 6f 64 65 26 30 37 37 37 29 21 3d 6d st_mode&0777)!=m
5640: 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 . ){.
5650: 20 20 20 6f 73 46 63 68 6d 6f 64 28 66 64 2c 20 osFchmod(fd,
5660: 6d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 m);. }.
5670: 7d 0a 23 69 66 20 64 65 66 69 6e 65 64 28 46 44 }.#if defined(FD
5680: 5f 43 4c 4f 45 58 45 43 29 20 26 26 20 28 21 64 _CLOEXEC) && (!d
5690: 65 66 69 6e 65 64 28 4f 5f 43 4c 4f 45 58 45 43 efined(O_CLOEXEC
56a0: 29 20 7c 7c 20 4f 5f 43 4c 4f 45 58 45 43 3d 3d ) || O_CLOEXEC==
56b0: 30 29 0a 20 20 20 20 6f 73 46 63 6e 74 6c 28 66 0). osFcntl(f
56c0: 64 2c 20 46 5f 53 45 54 46 44 2c 20 6f 73 46 63 d, F_SETFD, osFc
56d0: 6e 74 6c 28 66 64 2c 20 46 5f 47 45 54 46 44 2c ntl(fd, F_GETFD,
56e0: 20 30 29 20 7c 20 46 44 5f 43 4c 4f 45 58 45 43 0) | FD_CLOEXEC
56f0: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 );.#endif. }.
5700: 72 65 74 75 72 6e 20 66 64 3b 0a 7d 0a 0a 2f 2a return fd;.}../*
5710: 0a 2a 2a 20 48 65 6c 70 65 72 20 66 75 6e 63 74 .** Helper funct
5720: 69 6f 6e 73 20 74 6f 20 6f 62 74 61 69 6e 20 61 ions to obtain a
5730: 6e 64 20 72 65 6c 69 6e 71 75 69 73 68 20 74 68 nd relinquish th
5740: 65 20 67 6c 6f 62 61 6c 20 6d 75 74 65 78 2e 20 e global mutex.
5750: 54 68 65 0a 2a 2a 20 67 6c 6f 62 61 6c 20 6d 75 The.** global mu
5760: 74 65 78 20 69 73 20 75 73 65 64 20 74 6f 20 70 tex is used to p
5770: 72 6f 74 65 63 74 20 74 68 65 20 75 6e 69 78 49 rotect the unixI
5780: 6e 6f 64 65 49 6e 66 6f 20 61 6e 64 0a 2a 2a 20 nodeInfo and.**
5790: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 6f 62 vxworksFileId ob
57a0: 6a 65 63 74 73 20 75 73 65 64 20 62 79 20 74 68 jects used by th
57b0: 69 73 20 66 69 6c 65 2c 20 61 6c 6c 20 6f 66 20 is file, all of
57c0: 77 68 69 63 68 20 6d 61 79 20 62 65 20 0a 2a 2a which may be .**
57d0: 20 73 68 61 72 65 64 20 62 79 20 6d 75 6c 74 69 shared by multi
57e0: 70 6c 65 20 74 68 72 65 61 64 73 2e 0a 2a 2a 0a ple threads..**.
57f0: 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 75 6e 69 78 ** Function unix
5800: 4d 75 74 65 78 48 65 6c 64 28 29 20 69 73 20 75 MutexHeld() is u
5810: 73 65 64 20 74 6f 20 61 73 73 65 72 74 28 29 20 sed to assert()
5820: 74 68 61 74 20 74 68 65 20 67 6c 6f 62 61 6c 20 that the global
5830: 6d 75 74 65 78 20 0a 2a 2a 20 69 73 20 68 65 6c mutex .** is hel
5840: 64 20 77 68 65 6e 20 72 65 71 75 69 72 65 64 2e d when required.
5850: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
5860: 73 20 6f 6e 6c 79 20 75 73 65 64 20 61 73 20 70 s only used as p
5870: 61 72 74 20 6f 66 20 61 73 73 65 72 74 28 29 20 art of assert()
5880: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 .** statements.
5890: 65 2e 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 75 6e 69 e.g..**.** uni
58a0: 78 45 6e 74 65 72 4d 75 74 65 78 28 29 0a 2a 2a xEnterMutex().**
58b0: 20 20 20 20 20 61 73 73 65 72 74 28 20 75 6e 69 assert( uni
58c0: 78 4d 75 74 65 78 48 65 6c 64 28 29 20 29 3b 0a xMutexHeld() );.
58d0: 2a 2a 20 20 20 75 6e 69 78 45 6e 74 65 72 4c 65 ** unixEnterLe
58e0: 61 76 65 28 29 0a 2a 2f 0a 73 74 61 74 69 63 20 ave().*/.static
58f0: 76 6f 69 64 20 75 6e 69 78 45 6e 74 65 72 4d 75 void unixEnterMu
5900: 74 65 78 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c tex(void){. sql
5910: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
5920: 28 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c (sqlite3MutexAll
5930: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
5940: 53 54 41 54 49 43 5f 56 46 53 31 29 29 3b 0a 7d STATIC_VFS1));.}
5950: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69 .static void uni
5960: 78 4c 65 61 76 65 4d 75 74 65 78 28 76 6f 69 64 xLeaveMutex(void
5970: 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 ){. sqlite3_mut
5980: 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 65 33 ex_leave(sqlite3
5990: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
59a0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 56 E_MUTEX_STATIC_V
59b0: 46 53 31 29 29 3b 0a 7d 0a 23 69 66 64 65 66 20 FS1));.}.#ifdef
59c0: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 73 74 61 SQLITE_DEBUG.sta
59d0: 74 69 63 20 69 6e 74 20 75 6e 69 78 4d 75 74 65 tic int unixMute
59e0: 78 48 65 6c 64 28 76 6f 69 64 29 20 7b 0a 20 20 xHeld(void) {.
59f0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d return sqlite3_m
5a00: 75 74 65 78 5f 68 65 6c 64 28 73 71 6c 69 74 65 utex_held(sqlite
5a10: 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 3MutexAlloc(SQLI
5a20: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f TE_MUTEX_STATIC_
5a30: 56 46 53 31 29 29 3b 0a 7d 0a 23 65 6e 64 69 66 VFS1));.}.#endif
5a40: 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ...#ifdef SQLITE
5a50: 5f 48 41 56 45 5f 4f 53 5f 54 52 41 43 45 0a 2f _HAVE_OS_TRACE./
5a60: 2a 0a 2a 2a 20 48 65 6c 70 65 72 20 66 75 6e 63 *.** Helper func
5a70: 74 69 6f 6e 20 66 6f 72 20 70 72 69 6e 74 69 6e tion for printin
5a80: 67 20 6f 75 74 20 74 72 61 63 65 20 69 6e 66 6f g out trace info
5a90: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 64 65 62 rmation from deb
5aa0: 75 67 67 69 6e 67 0a 2a 2a 20 62 69 6e 61 72 69 ugging.** binari
5ab0: 65 73 2e 20 54 68 69 73 20 72 65 74 75 72 6e 73 es. This returns
5ac0: 20 74 68 65 20 73 74 72 69 6e 67 20 72 65 70 72 the string repr
5ad0: 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 esentation of th
5ae0: 65 20 73 75 70 70 6c 69 65 64 0a 2a 2a 20 69 6e e supplied.** in
5af0: 74 65 67 65 72 20 6c 6f 63 6b 2d 74 79 70 65 2e teger lock-type.
5b00: 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 .*/.static const
5b10: 20 63 68 61 72 20 2a 61 7a 46 69 6c 65 4c 6f 63 char *azFileLoc
5b20: 6b 28 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 k(int eFileLock)
5b30: 7b 0a 20 20 73 77 69 74 63 68 28 20 65 46 69 6c {. switch( eFil
5b40: 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 63 61 73 eLock ){. cas
5b50: 65 20 4e 4f 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 e NO_LOCK: retur
5b60: 6e 20 22 4e 4f 4e 45 22 3b 0a 20 20 20 20 63 61 n "NONE";. ca
5b70: 73 65 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3a 20 se SHARED_LOCK:
5b80: 72 65 74 75 72 6e 20 22 53 48 41 52 45 44 22 3b return "SHARED";
5b90: 0a 20 20 20 20 63 61 73 65 20 52 45 53 45 52 56 . case RESERV
5ba0: 45 44 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e 20 ED_LOCK: return
5bb0: 22 52 45 53 45 52 56 45 44 22 3b 0a 20 20 20 20 "RESERVED";.
5bc0: 63 61 73 65 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 case PENDING_LOC
5bd0: 4b 3a 20 72 65 74 75 72 6e 20 22 50 45 4e 44 49 K: return "PENDI
5be0: 4e 47 22 3b 0a 20 20 20 20 63 61 73 65 20 45 58 NG";. case EX
5bf0: 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 3a 20 72 65 CLUSIVE_LOCK: re
5c00: 74 75 72 6e 20 22 45 58 43 4c 55 53 49 56 45 22 turn "EXCLUSIVE"
5c10: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 22 ;. }. return "
5c20: 45 52 52 4f 52 22 3b 0a 7d 0a 23 65 6e 64 69 66 ERROR";.}.#endif
5c30: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
5c40: 4c 4f 43 4b 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a LOCK_TRACE./*.**
5c50: 20 50 72 69 6e 74 20 6f 75 74 20 69 6e 66 6f 72 Print out infor
5c60: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 6c 6c mation about all
5c70: 20 6c 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69 locking operati
5c80: 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 ons..**.** This
5c90: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 routine is used
5ca0: 66 6f 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f 74 for troubleshoot
5cb0: 69 6e 67 20 6c 6f 63 6b 73 20 6f 6e 20 6d 75 6c ing locks on mul
5cc0: 74 69 74 68 72 65 61 64 65 64 0a 2a 2a 20 70 6c tithreaded.** pl
5cd0: 61 74 66 6f 72 6d 73 2e 20 20 45 6e 61 62 6c 65 atforms. Enable
5ce0: 20 62 79 20 63 6f 6d 70 69 6c 69 6e 67 20 77 69 by compiling wi
5cf0: 74 68 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f th the -DSQLITE_
5d00: 4c 4f 43 4b 5f 54 52 41 43 45 0a 2a 2a 20 63 6f LOCK_TRACE.** co
5d10: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f mmand-line optio
5d20: 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 n on the compile
5d30: 72 2e 20 20 54 68 69 73 20 63 6f 64 65 20 69 73 r. This code is
5d40: 20 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 74 75 72 normally.** tur
5d50: 6e 65 64 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74 ned off..*/.stat
5d60: 69 63 20 69 6e 74 20 6c 6f 63 6b 54 72 61 63 65 ic int lockTrace
5d70: 28 69 6e 74 20 66 64 2c 20 69 6e 74 20 6f 70 2c (int fd, int op,
5d80: 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 2a 70 struct flock *p
5d90: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 4f 70 4e 61 ){. char *zOpNa
5da0: 6d 65 2c 20 2a 7a 54 79 70 65 3b 0a 20 20 69 6e me, *zType;. in
5db0: 74 20 73 3b 0a 20 20 69 6e 74 20 73 61 76 65 64 t s;. int saved
5dc0: 45 72 72 6e 6f 3b 0a 20 20 69 66 28 20 6f 70 3d Errno;. if( op=
5dd0: 3d 46 5f 47 45 54 4c 4b 20 29 7b 0a 20 20 20 20 =F_GETLK ){.
5de0: 7a 4f 70 4e 61 6d 65 20 3d 20 22 47 45 54 4c 4b zOpName = "GETLK
5df0: 22 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6f ";. }else if( o
5e00: 70 3d 3d 46 5f 53 45 54 4c 4b 20 29 7b 0a 20 20 p==F_SETLK ){.
5e10: 20 20 7a 4f 70 4e 61 6d 65 20 3d 20 22 53 45 54 zOpName = "SET
5e20: 4c 4b 22 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 LK";. }else{.
5e30: 20 20 73 20 3d 20 6f 73 46 63 6e 74 6c 28 66 64 s = osFcntl(fd
5e40: 2c 20 6f 70 2c 20 70 29 3b 0a 20 20 20 20 73 71 , op, p);. sq
5e50: 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
5e60: 28 22 66 63 6e 74 6c 20 75 6e 6b 6e 6f 77 6e 20 ("fcntl unknown
5e70: 25 64 20 25 64 20 25 64 5c 6e 22 2c 20 66 64 2c %d %d %d\n", fd,
5e80: 20 6f 70 2c 20 73 29 3b 0a 20 20 20 20 72 65 74 op, s);. ret
5e90: 75 72 6e 20 73 3b 0a 20 20 7d 0a 20 20 69 66 28 urn s;. }. if(
5ea0: 20 70 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 p->l_type==F_RD
5eb0: 4c 43 4b 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 LCK ){. zType
5ec0: 20 3d 20 22 52 44 4c 43 4b 22 3b 0a 20 20 7d 65 = "RDLCK";. }e
5ed0: 6c 73 65 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70 lse if( p->l_typ
5ee0: 65 3d 3d 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 20 e==F_WRLCK ){.
5ef0: 20 20 7a 54 79 70 65 20 3d 20 22 57 52 4c 43 4b zType = "WRLCK
5f00: 22 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 ";. }else if( p
5f10: 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 55 4e 4c 43 ->l_type==F_UNLC
5f20: 4b 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d K ){. zType =
5f30: 20 22 55 4e 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73 "UNLCK";. }els
5f40: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 30 e{. assert( 0
5f50: 20 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 );. }. assert
5f60: 28 20 70 2d 3e 6c 5f 77 68 65 6e 63 65 3d 3d 53 ( p->l_whence==S
5f70: 45 45 4b 5f 53 45 54 20 29 3b 0a 20 20 73 20 3d EEK_SET );. s =
5f80: 20 6f 73 46 63 6e 74 6c 28 66 64 2c 20 6f 70 2c osFcntl(fd, op,
5f90: 20 70 29 3b 0a 20 20 73 61 76 65 64 45 72 72 6e p);. savedErrn
5fa0: 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 73 71 6c o = errno;. sql
5fb0: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
5fc0: 22 66 63 6e 74 6c 20 25 64 20 25 64 20 25 73 20 "fcntl %d %d %s
5fd0: 25 73 20 25 64 20 25 64 20 25 64 20 25 64 5c 6e %s %d %d %d %d\n
5fe0: 22 2c 0a 20 20 20 20 20 74 68 72 65 61 64 69 64 ",. threadid
5ff0: 2c 20 66 64 2c 20 7a 4f 70 4e 61 6d 65 2c 20 7a , fd, zOpName, z
6000: 54 79 70 65 2c 20 28 69 6e 74 29 70 2d 3e 6c 5f Type, (int)p->l_
6010: 73 74 61 72 74 2c 20 28 69 6e 74 29 70 2d 3e 6c start, (int)p->l
6020: 5f 6c 65 6e 2c 0a 20 20 20 20 20 28 69 6e 74 29 _len,. (int)
6030: 70 2d 3e 6c 5f 70 69 64 2c 20 73 29 3b 0a 20 20 p->l_pid, s);.
6040: 69 66 28 20 73 3d 3d 28 2d 31 29 20 26 26 20 6f if( s==(-1) && o
6050: 70 3d 3d 46 5f 53 45 54 4c 4b 20 26 26 20 28 70 p==F_SETLK && (p
6060: 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43 ->l_type==F_RDLC
6070: 4b 20 7c 7c 20 70 2d 3e 6c 5f 74 79 70 65 3d 3d K || p->l_type==
6080: 46 5f 57 52 4c 43 4b 29 20 29 7b 0a 20 20 20 20 F_WRLCK) ){.
6090: 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c 32 3b struct flock l2;
60a0: 0a 20 20 20 20 6c 32 20 3d 20 2a 70 3b 0a 20 20 . l2 = *p;.
60b0: 20 20 6f 73 46 63 6e 74 6c 28 66 64 2c 20 46 5f osFcntl(fd, F_
60c0: 47 45 54 4c 4b 2c 20 26 6c 32 29 3b 0a 20 20 20 GETLK, &l2);.
60d0: 20 69 66 28 20 6c 32 2e 6c 5f 74 79 70 65 3d 3d if( l2.l_type==
60e0: 46 5f 52 44 4c 43 4b 20 29 7b 0a 20 20 20 20 20 F_RDLCK ){.
60f0: 20 7a 54 79 70 65 20 3d 20 22 52 44 4c 43 4b 22 zType = "RDLCK"
6100: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
6110: 6c 32 2e 6c 5f 74 79 70 65 3d 3d 46 5f 57 52 4c l2.l_type==F_WRL
6120: 43 4b 20 29 7b 0a 20 20 20 20 20 20 7a 54 79 70 CK ){. zTyp
6130: 65 20 3d 20 22 57 52 4c 43 4b 22 3b 0a 20 20 20 e = "WRLCK";.
6140: 20 7d 65 6c 73 65 20 69 66 28 20 6c 32 2e 6c 5f }else if( l2.l_
6150: 74 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29 7b type==F_UNLCK ){
6160: 0a 20 20 20 20 20 20 7a 54 79 70 65 20 3d 20 22 . zType = "
6170: 55 4e 4c 43 4b 22 3b 0a 20 20 20 20 7d 65 6c 73 UNLCK";. }els
6180: 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 e{. assert(
6190: 20 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 0 );. }.
61a0: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
61b0: 74 66 28 22 66 63 6e 74 6c 2d 66 61 69 6c 75 72 tf("fcntl-failur
61c0: 65 2d 72 65 61 73 6f 6e 3a 20 25 73 20 25 64 20 e-reason: %s %d
61d0: 25 64 20 25 64 5c 6e 22 2c 0a 20 20 20 20 20 20 %d %d\n",.
61e0: 20 7a 54 79 70 65 2c 20 28 69 6e 74 29 6c 32 2e zType, (int)l2.
61f0: 6c 5f 73 74 61 72 74 2c 20 28 69 6e 74 29 6c 32 l_start, (int)l2
6200: 2e 6c 5f 6c 65 6e 2c 20 28 69 6e 74 29 6c 32 2e .l_len, (int)l2.
6210: 6c 5f 70 69 64 29 3b 0a 20 20 7d 0a 20 20 65 72 l_pid);. }. er
6220: 72 6e 6f 20 3d 20 73 61 76 65 64 45 72 72 6e 6f rno = savedErrno
6230: 3b 0a 20 20 72 65 74 75 72 6e 20 73 3b 0a 7d 0a ;. return s;.}.
6240: 23 75 6e 64 65 66 20 6f 73 46 63 6e 74 6c 0a 23 #undef osFcntl.#
6250: 64 65 66 69 6e 65 20 6f 73 46 63 6e 74 6c 20 6c define osFcntl l
6260: 6f 63 6b 54 72 61 63 65 0a 23 65 6e 64 69 66 20 ockTrace.#endif
6270: 2f 2a 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 5f 54 /* SQLITE_LOCK_T
6280: 52 41 43 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 RACE */../*.** R
6290: 65 74 72 79 20 66 74 72 75 6e 63 61 74 65 28 29 etry ftruncate()
62a0: 20 63 61 6c 6c 73 20 74 68 61 74 20 66 61 69 6c calls that fail
62b0: 20 64 75 65 20 74 6f 20 45 49 4e 54 52 0a 2a 2a due to EINTR.**
62c0: 0a 2a 2a 20 41 6c 6c 20 63 61 6c 6c 73 20 74 6f .** All calls to
62d0: 20 66 74 72 75 6e 63 61 74 65 28 29 20 77 69 74 ftruncate() wit
62e0: 68 69 6e 20 74 68 69 73 20 66 69 6c 65 20 73 68 hin this file sh
62f0: 6f 75 6c 64 20 62 65 20 6d 61 64 65 20 74 68 72 ould be made thr
6300: 6f 75 67 68 0a 2a 2a 20 74 68 69 73 20 77 72 61 ough.** this wra
6310: 70 70 65 72 2e 20 20 4f 6e 20 74 68 65 20 41 6e pper. On the An
6320: 64 72 6f 69 64 20 70 6c 61 74 66 6f 72 6d 2c 20 droid platform,
6330: 62 79 70 61 73 73 69 6e 67 20 74 68 65 20 6c 6f bypassing the lo
6340: 67 69 63 20 62 65 6c 6f 77 0a 2a 2a 20 63 6f 75 gic below.** cou
6350: 6c 64 20 6c 65 61 64 20 74 6f 20 61 20 63 6f 72 ld lead to a cor
6360: 72 75 70 74 20 64 61 74 61 62 61 73 65 2e 0a 2a rupt database..*
6370: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 6f 62 /.static int rob
6380: 75 73 74 5f 66 74 72 75 6e 63 61 74 65 28 69 6e ust_ftruncate(in
6390: 74 20 68 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 t h, sqlite3_int
63a0: 36 34 20 73 7a 29 7b 0a 20 20 69 6e 74 20 72 63 64 sz){. int rc
63b0: 3b 0a 23 69 66 64 65 66 20 5f 5f 41 4e 44 52 4f ;.#ifdef __ANDRO
63c0: 49 44 5f 5f 0a 20 20 2f 2a 20 4f 6e 20 41 6e 64 ID__. /* On And
63d0: 72 6f 69 64 2c 20 66 74 72 75 6e 63 61 74 65 28 roid, ftruncate(
63e0: 29 20 61 6c 77 61 79 73 20 75 73 65 73 20 33 32 ) always uses 32
63f0: 2d 62 69 74 20 6f 66 66 73 65 74 73 2c 20 65 76 -bit offsets, ev
6400: 65 6e 20 69 66 20 0a 20 20 2a 2a 20 5f 46 49 4c en if . ** _FIL
6410: 45 5f 4f 46 46 53 45 54 5f 42 49 54 53 3d 36 34 E_OFFSET_BITS=64
6420: 20 69 73 20 64 65 66 69 6e 65 64 2e 20 54 68 69 is defined. Thi
6430: 73 20 6d 65 61 6e 73 20 69 74 20 69 73 20 75 6e s means it is un
6440: 73 61 66 65 20 74 6f 20 61 74 74 65 6d 70 74 20 safe to attempt
6450: 74 6f 0a 20 20 2a 2a 20 74 72 75 6e 63 61 74 65 to. ** truncate
6460: 20 61 20 66 69 6c 65 20 74 6f 20 61 6e 79 20 73 a file to any s
6470: 69 7a 65 20 6c 61 72 67 65 72 20 74 68 61 6e 20 ize larger than
6480: 32 47 69 42 2e 20 53 69 6c 65 6e 74 6c 79 20 69 2GiB. Silently i
6490: 67 6e 6f 72 65 20 61 6e 79 0a 20 20 2a 2a 20 73 gnore any. ** s
64a0: 75 63 68 20 61 74 74 65 6d 70 74 73 2e 20 20 2a uch attempts. *
64b0: 2f 0a 20 20 69 66 28 20 73 7a 3e 28 73 71 6c 69 /. if( sz>(sqli
64c0: 74 65 33 5f 69 6e 74 36 34 29 30 78 37 46 46 46 te3_int64)0x7FFF
64d0: 46 46 46 46 20 29 7b 0a 20 20 20 20 72 63 20 3d FFFF ){. rc =
64e0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
64f0: 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 64 6f 7b lse.#endif. do{
6500: 20 72 63 20 3d 20 6f 73 46 74 72 75 6e 63 61 74 rc = osFtruncat
6510: 65 28 68 2c 73 7a 29 3b 20 7d 77 68 69 6c 65 28 e(h,sz); }while(
6520: 20 72 63 3c 30 20 26 26 20 65 72 72 6e 6f 3d 3d rc<0 && errno==
6530: 45 49 4e 54 52 20 29 3b 0a 20 20 72 65 74 75 72 EINTR );. retur
6540: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
6550: 68 69 73 20 72 6f 75 74 69 6e 65 20 74 72 61 6e his routine tran
6560: 73 6c 61 74 65 73 20 61 20 73 74 61 6e 64 61 72 slates a standar
6570: 64 20 50 4f 53 49 58 20 65 72 72 6e 6f 20 63 6f d POSIX errno co
6580: 64 65 20 69 6e 74 6f 20 73 6f 6d 65 74 68 69 6e de into somethin
6590: 67 0a 2a 2a 20 75 73 65 66 75 6c 20 74 6f 20 74 g.** useful to t
65a0: 68 65 20 63 6c 69 65 6e 74 73 20 6f 66 20 74 68 he clients of th
65b0: 65 20 73 71 6c 69 74 65 33 20 66 75 6e 63 74 69 e sqlite3 functi
65c0: 6f 6e 73 2e 20 20 53 70 65 63 69 66 69 63 61 6c ons. Specifical
65d0: 6c 79 2c 20 69 74 20 69 73 0a 2a 2a 20 69 6e 74 ly, it is.** int
65e0: 65 6e 64 65 64 20 74 6f 20 74 72 61 6e 73 6c 61 ended to transla
65f0: 74 65 20 61 20 76 61 72 69 65 74 79 20 6f 66 20 te a variety of
6600: 22 74 72 79 20 61 67 61 69 6e 22 20 65 72 72 6f "try again" erro
6610: 72 73 20 69 6e 74 6f 20 53 51 4c 49 54 45 5f 42 rs into SQLITE_B
6620: 55 53 59 0a 2a 2a 20 61 6e 64 20 61 20 76 61 72 USY.** and a var
6630: 69 65 74 79 20 6f 66 20 22 70 6c 65 61 73 65 20 iety of "please
6640: 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 64 close the file d
6650: 65 73 63 72 69 70 74 6f 72 20 4e 4f 57 22 20 65 escriptor NOW" e
6660: 72 72 6f 72 73 20 69 6e 74 6f 20 0a 2a 2a 20 53 rrors into .** S
6670: 51 4c 49 54 45 5f 49 4f 45 52 52 0a 2a 2a 20 0a QLITE_IOERR.** .
6680: 2a 2a 20 45 72 72 6f 72 73 20 64 75 72 69 6e 67 ** Errors during
6690: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 initialization
66a0: 6f 66 20 6c 6f 63 6b 73 2c 20 6f 72 20 66 69 6c of locks, or fil
66b0: 65 20 73 79 73 74 65 6d 20 73 75 70 70 6f 72 74 e system support
66c0: 20 66 6f 72 20 6c 6f 63 6b 73 2c 0a 2a 2a 20 73 for locks,.** s
66d0: 68 6f 75 6c 64 20 68 61 6e 64 6c 65 20 45 4e 4f hould handle ENO
66e0: 4c 43 4b 2c 20 45 4e 4f 54 53 55 50 2c 20 45 4f LCK, ENOTSUP, EO
66f0: 50 4e 4f 54 53 55 50 50 20 73 65 70 61 72 61 74 PNOTSUPP separat
6700: 65 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ely..*/.static i
6710: 6e 74 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72 nt sqliteErrorFr
6720: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 69 6e 74 omPosixError(int
6730: 20 70 6f 73 69 78 45 72 72 6f 72 2c 20 69 6e 74 posixError, int
6740: 20 73 71 6c 69 74 65 49 4f 45 72 72 29 20 7b 0a sqliteIOErr) {.
6750: 20 20 61 73 73 65 72 74 28 20 28 73 71 6c 69 74 assert( (sqlit
6760: 65 49 4f 45 72 72 20 3d 3d 20 53 51 4c 49 54 45 eIOErr == SQLITE
6770: 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 20 7c 7c 20 _IOERR_LOCK) ||
6780: 0a 20 20 20 20 20 20 20 20 20 20 28 73 71 6c 69 . (sqli
6790: 74 65 49 4f 45 72 72 20 3d 3d 20 53 51 4c 49 54 teIOErr == SQLIT
67a0: 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 29 20 E_IOERR_UNLOCK)
67b0: 7c 7c 20 0a 20 20 20 20 20 20 20 20 20 20 28 73 || . (s
67c0: 71 6c 69 74 65 49 4f 45 72 72 20 3d 3d 20 53 51 qliteIOErr == SQ
67d0: 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 LITE_IOERR_RDLOC
67e0: 4b 29 20 7c 7c 0a 20 20 20 20 20 20 20 20 20 20 K) ||.
67f0: 28 73 71 6c 69 74 65 49 4f 45 72 72 20 3d 3d 20 (sqliteIOErr ==
6800: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 SQLITE_IOERR_CHE
6810: 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 29 20 CKRESERVEDLOCK)
6820: 29 3b 0a 20 20 73 77 69 74 63 68 20 28 70 6f 73 );. switch (pos
6830: 69 78 45 72 72 6f 72 29 20 7b 0a 20 20 63 61 73 ixError) {. cas
6840: 65 20 45 41 43 43 45 53 3a 20 0a 20 20 63 61 73 e EACCES: . cas
6850: 65 20 45 41 47 41 49 4e 3a 0a 20 20 63 61 73 65 e EAGAIN:. case
6860: 20 45 54 49 4d 45 44 4f 55 54 3a 0a 20 20 63 61 ETIMEDOUT:. ca
6870: 73 65 20 45 42 55 53 59 3a 0a 20 20 63 61 73 65 se EBUSY:. case
6880: 20 45 49 4e 54 52 3a 0a 20 20 63 61 73 65 20 45 EINTR:. case E
6890: 4e 4f 4c 43 4b 3a 20 20 0a 20 20 20 20 2f 2a 20 NOLCK: . /*
68a0: 72 61 6e 64 6f 6d 20 4e 46 53 20 72 65 74 72 79 random NFS retry
68b0: 20 65 72 72 6f 72 2c 20 75 6e 6c 65 73 73 20 64 error, unless d
68c0: 75 72 69 6e 67 20 66 69 6c 65 20 73 79 73 74 65 uring file syste
68d0: 6d 20 73 75 70 70 6f 72 74 20 0a 20 20 20 20 20 m support .
68e0: 2a 20 69 6e 74 72 6f 73 70 65 63 74 69 6f 6e 2c * introspection,
68f0: 20 69 6e 20 77 68 69 63 68 20 69 74 20 61 63 74 in which it act
6900: 75 61 6c 6c 79 20 6d 65 61 6e 73 20 77 68 61 74 ually means what
6910: 20 69 74 20 73 61 79 73 20 2a 2f 0a 20 20 20 20 it says */.
6920: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
6930: 53 59 3b 0a 20 20 20 20 0a 20 20 63 61 73 65 20 SY;. . case
6940: 45 50 45 52 4d 3a 20 0a 20 20 20 20 72 65 74 75 EPERM: . retu
6950: 72 6e 20 53 51 4c 49 54 45 5f 50 45 52 4d 3b 0a rn SQLITE_PERM;.
6960: 20 20 20 20 0a 20 20 64 65 66 61 75 6c 74 3a 20 . default:
6970: 0a 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 . return sqli
6980: 74 65 49 4f 45 72 72 3b 0a 20 20 7d 0a 7d 0a 0a teIOErr;. }.}..
6990: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ./**************
69a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
69b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
69c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
69d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
69e0: 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .***************
69f0: 2a 2a 2a 20 42 65 67 69 6e 20 55 6e 69 71 75 65 *** Begin Unique
6a00: 20 46 69 6c 65 20 49 44 20 55 74 69 6c 69 74 79 File ID Utility
6a10: 20 55 73 65 64 20 42 79 20 56 78 57 6f 72 6b 73 Used By VxWorks
6a20: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
6a30: 0a 2a 2a 0a 2a 2a 20 4f 6e 20 6d 6f 73 74 20 76 .**.** On most v
6a40: 65 72 73 69 6f 6e 73 20 6f 66 20 75 6e 69 78 2c ersions of unix,
6a50: 20 77 65 20 63 61 6e 20 67 65 74 20 61 20 75 6e we can get a un
6a60: 69 71 75 65 20 49 44 20 66 6f 72 20 61 20 66 69 ique ID for a fi
6a70: 6c 65 20 62 79 20 63 6f 6e 63 61 74 65 6e 61 74 le by concatenat
6a80: 69 6e 67 0a 2a 2a 20 74 68 65 20 64 65 76 69 63 ing.** the devic
6a90: 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 74 68 65 e number and the
6aa0: 20 69 6e 6f 64 65 20 6e 75 6d 62 65 72 2e 20 20 inode number.
6ab0: 42 75 74 20 74 68 69 73 20 64 6f 65 73 20 6e 6f But this does no
6ac0: 74 20 77 6f 72 6b 20 6f 6e 20 56 78 57 6f 72 6b t work on VxWork
6ad0: 73 2e 0a 2a 2a 20 4f 6e 20 56 78 57 6f 72 6b 73 s..** On VxWorks
6ae0: 2c 20 61 20 75 6e 69 71 75 65 20 66 69 6c 65 20 , a unique file
6af0: 69 64 20 6d 75 73 74 20 62 65 20 62 61 73 65 64 id must be based
6b00: 20 6f 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 on the canonica
6b10: 6c 20 66 69 6c 65 6e 61 6d 65 2e 0a 2a 2a 0a 2a l filename..**.*
6b20: 2a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 * A pointer to a
6b30: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
6b40: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
6b50: 63 74 75 72 65 20 63 61 6e 20 62 65 20 75 73 65 cture can be use
6b60: 64 20 61 73 20 61 0a 2a 2a 20 75 6e 69 71 75 65 d as a.** unique
6b70: 20 66 69 6c 65 20 49 44 20 69 6e 20 56 78 57 6f file ID in VxWo
6b80: 72 6b 73 2e 20 20 45 61 63 68 20 69 6e 73 74 61 rks. Each insta
6b90: 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 nce of this stru
6ba0: 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 0a 2a cture contains.*
6bb0: 2a 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 * a copy of the
6bc0: 63 61 6e 6f 6e 69 63 61 6c 20 66 69 6c 65 6e 61 canonical filena
6bd0: 6d 65 2e 20 20 54 68 65 72 65 20 69 73 20 61 6c me. There is al
6be0: 73 6f 20 61 20 72 65 66 65 72 65 6e 63 65 20 63 so a reference c
6bf0: 6f 75 6e 74 2e 20 20 0a 2a 2a 20 54 68 65 20 73 ount. .** The s
6c00: 74 72 75 63 74 75 72 65 20 69 73 20 72 65 63 6c tructure is recl
6c10: 61 69 6d 65 64 20 77 68 65 6e 20 74 68 65 20 6e aimed when the n
6c20: 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 65 72 umber of pointer
6c30: 73 20 74 6f 20 69 74 20 64 72 6f 70 73 20 74 6f s to it drops to
6c40: 0a 2a 2a 20 7a 65 72 6f 2e 0a 2a 2a 0a 2a 2a 20 .** zero..**.**
6c50: 54 68 65 72 65 20 61 72 65 20 6e 65 76 65 72 20 There are never
6c60: 76 65 72 79 20 6d 61 6e 79 20 66 69 6c 65 73 20 very many files
6c70: 6f 70 65 6e 20 61 74 20 6f 6e 65 20 74 69 6d 65 open at one time
6c80: 20 61 6e 64 20 6c 6f 6f 6b 75 70 73 20 61 72 65 and lookups are
6c90: 20 6e 6f 74 0a 2a 2a 20 61 20 70 65 72 66 6f 72 not.** a perfor
6ca0: 6d 61 6e 63 65 2d 63 72 69 74 69 63 61 6c 20 70 mance-critical p
6cb0: 61 74 68 2c 20 73 6f 20 69 74 20 69 73 20 73 75 ath, so it is su
6cc0: 66 66 69 63 69 65 6e 74 20 74 6f 20 70 75 74 20 fficient to put
6cd0: 74 68 65 73 65 0a 2a 2a 20 73 74 72 75 63 74 75 these.** structu
6ce0: 72 65 73 20 6f 6e 20 61 20 6c 69 6e 6b 65 64 20 res on a linked
6cf0: 6c 69 73 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 list..*/.struct
6d00: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 7b 0a vxworksFileId {.
6d10: 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73 struct vxworks
6d20: 46 69 6c 65 49 64 20 2a 70 4e 65 78 74 3b 20 20 FileId *pNext;
6d30: 2f 2a 20 4e 65 78 74 20 69 6e 20 61 20 6c 69 73 /* Next in a lis
6d40: 74 20 6f 66 20 74 68 65 6d 20 61 6c 6c 20 2a 2f t of them all */
6d50: 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 . int nRef;
6d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6d70: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 /* Number of re
6d80: 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 69 73 ferences to this
6d90: 20 6f 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4e one */. int nN
6da0: 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ame;
6db0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 /* Lengt
6dc0: 68 20 6f 66 20 74 68 65 20 7a 43 61 6e 6f 6e 69 h of the zCanoni
6dd0: 63 61 6c 4e 61 6d 65 5b 5d 20 73 74 72 69 6e 67 calName[] string
6de0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 61 6e */. char *zCan
6df0: 6f 6e 69 63 61 6c 4e 61 6d 65 3b 20 20 20 20 20 onicalName;
6e00: 20 20 20 20 2f 2a 20 43 61 6e 6f 6e 69 63 61 6c /* Canonical
6e10: 20 66 69 6c 65 6e 61 6d 65 20 2a 2f 0a 7d 3b 0a filename */.};.
6e20: 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a .#if OS_VXWORKS.
6e30: 2f 2a 20 0a 2a 2a 20 41 6c 6c 20 75 6e 69 71 75 /* .** All uniqu
6e40: 65 20 66 69 6c 65 6e 61 6d 65 73 20 61 72 65 20 e filenames are
6e50: 68 65 6c 64 20 6f 6e 20 61 20 6c 69 6e 6b 65 64 held on a linked
6e60: 20 6c 69 73 74 20 68 65 61 64 65 64 20 62 79 20 list headed by
6e70: 74 68 69 73 0a 2a 2a 20 76 61 72 69 61 62 6c 65 this.** variable
6e80: 3a 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74 72 75 :.*/.static stru
6e90: 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 ct vxworksFileId
6ea0: 20 2a 76 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 *vxworksFileLis
6eb0: 74 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 53 69 t = 0;../*.** Si
6ec0: 6d 70 6c 69 66 79 20 61 20 66 69 6c 65 6e 61 6d mplify a filenam
6ed0: 65 20 69 6e 74 6f 20 69 74 73 20 63 61 6e 6f 6e e into its canon
6ee0: 69 63 61 6c 20 66 6f 72 6d 0a 2a 2a 20 62 79 20 ical form.** by
6ef0: 6d 61 6b 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f making the follo
6f00: 77 69 6e 67 20 63 68 61 6e 67 65 73 3a 0a 2a 2a wing changes:.**
6f10: 0a 2a 2a 20 20 2a 20 72 65 6d 6f 76 69 6e 67 20 .** * removing
6f20: 61 6e 79 20 74 72 61 69 6c 69 6e 67 20 61 6e 64 any trailing and
6f30: 20 64 75 70 6c 69 63 61 74 65 20 2f 0a 2a 2a 20 duplicate /.**
6f40: 20 2a 20 63 6f 6e 76 65 72 74 20 2f 2e 2f 20 69 * convert /./ i
6f50: 6e 74 6f 20 6a 75 73 74 20 2f 0a 2a 2a 20 20 2a nto just /.** *
6f60: 20 63 6f 6e 76 65 72 74 20 2f 41 2f 2e 2e 2f 20 convert /A/../
6f70: 77 68 65 72 65 20 41 20 69 73 20 61 6e 79 20 73 where A is any s
6f80: 69 6d 70 6c 65 20 6e 61 6d 65 20 69 6e 74 6f 20 imple name into
6f90: 6a 75 73 74 20 2f 0a 2a 2a 0a 2a 2a 20 43 68 61 just /.**.** Cha
6fa0: 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 69 6e nges are made in
6fb0: 2d 70 6c 61 63 65 2e 20 20 52 65 74 75 72 6e 20 -place. Return
6fc0: 74 68 65 20 6e 65 77 20 6e 61 6d 65 20 6c 65 6e the new name len
6fd0: 67 74 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f gth..**.** The o
6fe0: 72 69 67 69 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 riginal filename
6ff0: 20 69 73 20 69 6e 20 7a 5b 30 2e 2e 6e 2d 31 5d is in z[0..n-1]
7000: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 . Return the nu
7010: 6d 62 65 72 20 6f 66 0a 2a 2a 20 63 68 61 72 61 mber of.** chara
7020: 63 74 65 72 73 20 69 6e 20 74 68 65 20 73 69 6d cters in the sim
7030: 70 6c 69 66 69 65 64 20 6e 61 6d 65 2e 0a 2a 2f plified name..*/
7040: 0a 73 74 61 74 69 63 20 69 6e 74 20 76 78 77 6f .static int vxwo
7050: 72 6b 73 53 69 6d 70 6c 69 66 79 4e 61 6d 65 28 rksSimplifyName(
7060: 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 7b char *z, int n){
7070: 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 77 . int i, j;. w
7080: 68 69 6c 65 28 20 6e 3e 31 20 26 26 20 7a 5b 6e hile( n>1 && z[n
7090: 2d 31 5d 3d 3d 27 2f 27 20 29 7b 20 6e 2d 2d 3b -1]=='/' ){ n--;
70a0: 20 7d 0a 20 20 66 6f 72 28 69 3d 6a 3d 30 3b 20 }. for(i=j=0;
70b0: 69 3c 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 i<n; i++){. i
70c0: 66 28 20 7a 5b 69 5d 3d 3d 27 2f 27 20 29 7b 0a f( z[i]=='/' ){.
70d0: 20 20 20 20 20 20 69 66 28 20 7a 5b 69 2b 31 5d if( z[i+1]
70e0: 3d 3d 27 2f 27 20 29 20 63 6f 6e 74 69 6e 75 65 =='/' ) continue
70f0: 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 5b 69 2b ;. if( z[i+
7100: 31 5d 3d 3d 27 2e 27 20 26 26 20 69 2b 32 3c 6e 1]=='.' && i+2<n
7110: 20 26 26 20 7a 5b 69 2b 32 5d 3d 3d 27 2f 27 20 && z[i+2]=='/'
7120: 29 7b 0a 20 20 20 20 20 20 20 20 69 20 2b 3d 20 ){. i +=
7130: 31 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69 1;. conti
7140: 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 nue;. }.
7150: 20 20 20 69 66 28 20 7a 5b 69 2b 31 5d 3d 3d 27 if( z[i+1]=='
7160: 2e 27 20 26 26 20 69 2b 33 3c 6e 20 26 26 20 7a .' && i+3<n && z
7170: 5b 69 2b 32 5d 3d 3d 27 2e 27 20 26 26 20 7a 5b [i+2]=='.' && z[
7180: 69 2b 33 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 i+3]=='/' ){.
7190: 20 20 20 20 20 77 68 69 6c 65 28 20 6a 3e 30 20 while( j>0
71a0: 26 26 20 7a 5b 6a 2d 31 5d 21 3d 27 2f 27 20 29 && z[j-1]!='/' )
71b0: 7b 20 6a 2d 2d 3b 20 7d 0a 20 20 20 20 20 20 20 { j--; }.
71c0: 20 69 66 28 20 6a 3e 30 20 29 7b 20 6a 2d 2d 3b if( j>0 ){ j--;
71d0: 20 7d 0a 20 20 20 20 20 20 20 20 69 20 2b 3d 20 }. i +=
71e0: 32 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69 2;. conti
71f0: 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 nue;. }.
7200: 20 7d 0a 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 }. z[j++] =
7210: 7a 5b 69 5d 3b 0a 20 20 7d 0a 20 20 7a 5b 6a 5d z[i];. }. z[j]
7220: 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 6a = 0;. return j
7230: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 ;.}../*.** Find
7240: 61 20 75 6e 69 71 75 65 20 66 69 6c 65 20 49 44 a unique file ID
7250: 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 20 61 for the given a
7260: 62 73 6f 6c 75 74 65 20 70 61 74 68 6e 61 6d 65 bsolute pathname
7270: 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 61 20 70 . Return.** a p
7280: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 76 78 ointer to the vx
7290: 77 6f 72 6b 73 46 69 6c 65 49 64 20 6f 62 6a 65 worksFileId obje
72a0: 63 74 2e 20 20 54 68 69 73 20 70 6f 69 6e 74 65 ct. This pointe
72b0: 72 20 69 73 20 74 68 65 20 75 6e 69 71 75 65 0a r is the unique.
72c0: 2a 2a 20 66 69 6c 65 20 49 44 2e 0a 2a 2a 0a 2a ** file ID..**.*
72d0: 2a 20 54 68 65 20 6e 52 65 66 20 66 69 65 6c 64 * The nRef field
72e0: 20 6f 66 20 74 68 65 20 76 78 77 6f 72 6b 73 46 of the vxworksF
72f0: 69 6c 65 49 64 20 6f 62 6a 65 63 74 20 69 73 20 ileId object is
7300: 69 6e 63 72 65 6d 65 6e 74 65 64 20 62 65 66 6f incremented befo
7310: 72 65 0a 2a 2a 20 74 68 65 20 6f 62 6a 65 63 74 re.** the object
7320: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 41 is returned. A
7330: 20 6e 65 77 20 76 78 77 6f 72 6b 73 46 69 6c 65 new vxworksFile
7340: 49 64 20 6f 62 6a 65 63 74 20 69 73 20 63 72 65 Id object is cre
7350: 61 74 65 64 0a 2a 2a 20 61 6e 64 20 61 64 64 65 ated.** and adde
7360: 64 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 6c 20 d to the global
7370: 6c 69 73 74 20 69 66 20 6e 65 63 65 73 73 61 72 list if necessar
7380: 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 6d 65 y..**.** If a me
7390: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
73a0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 error occurs, re
73b0: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 turn NULL..*/.st
73c0: 61 74 69 63 20 73 74 72 75 63 74 20 76 78 77 6f atic struct vxwo
73d0: 72 6b 73 46 69 6c 65 49 64 20 2a 76 78 77 6f 72 rksFileId *vxwor
73e0: 6b 73 46 69 6e 64 46 69 6c 65 49 64 28 63 6f 6e ksFindFileId(con
73f0: 73 74 20 63 68 61 72 20 2a 7a 41 62 73 6f 6c 75 st char *zAbsolu
7400: 74 65 4e 61 6d 65 29 7b 0a 20 20 73 74 72 75 63 teName){. struc
7410: 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 t vxworksFileId
7420: 2a 70 4e 65 77 3b 20 20 20 20 20 20 20 20 20 2f *pNew; /
7430: 2a 20 73 65 61 72 63 68 20 6b 65 79 20 61 6e 64 * search key and
7440: 20 6e 65 77 20 66 69 6c 65 20 49 44 20 2a 2f 0a new file ID */.
7450: 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73 struct vxworks
7460: 46 69 6c 65 49 64 20 2a 70 43 61 6e 64 69 64 61 FileId *pCandida
7470: 74 65 3b 20 20 20 2f 2a 20 46 6f 72 20 6c 6f 6f te; /* For loo
7480: 70 69 6e 67 20 6f 76 65 72 20 65 78 69 73 74 69 ping over existi
7490: 6e 67 20 66 69 6c 65 20 49 44 73 20 2a 2f 0a 20 ng file IDs */.
74a0: 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 int n;
74b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
74c0: 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f /* Length o
74d0: 66 20 7a 41 62 73 6f 6c 75 74 65 4e 61 6d 65 20 f zAbsoluteName
74e0: 73 74 72 69 6e 67 20 2a 2f 0a 0a 20 20 61 73 73 string */.. ass
74f0: 65 72 74 28 20 7a 41 62 73 6f 6c 75 74 65 4e 61 ert( zAbsoluteNa
7500: 6d 65 5b 30 5d 3d 3d 27 2f 27 20 29 3b 0a 20 20 me[0]=='/' );.
7510: 6e 20 3d 20 28 69 6e 74 29 73 74 72 6c 65 6e 28 n = (int)strlen(
7520: 7a 41 62 73 6f 6c 75 74 65 4e 61 6d 65 29 3b 0a zAbsoluteName);.
7530: 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 pNew = sqlite3
7540: 5f 6d 61 6c 6c 6f 63 36 34 28 20 73 69 7a 65 6f _malloc64( sizeo
7550: 66 28 2a 70 4e 65 77 29 20 2b 20 28 6e 2b 31 29 f(*pNew) + (n+1)
7560: 20 29 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d );. if( pNew==
7570: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
7580: 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c pNew->zCanonical
7590: 4e 61 6d 65 20 3d 20 28 63 68 61 72 2a 29 26 70 Name = (char*)&p
75a0: 4e 65 77 5b 31 5d 3b 0a 20 20 6d 65 6d 63 70 79 New[1];. memcpy
75b0: 28 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e 69 63 61 (pNew->zCanonica
75c0: 6c 4e 61 6d 65 2c 20 7a 41 62 73 6f 6c 75 74 65 lName, zAbsolute
75d0: 4e 61 6d 65 2c 20 6e 2b 31 29 3b 0a 20 20 6e 20 Name, n+1);. n
75e0: 3d 20 76 78 77 6f 72 6b 73 53 69 6d 70 6c 69 66 = vxworksSimplif
75f0: 79 4e 61 6d 65 28 70 4e 65 77 2d 3e 7a 43 61 6e yName(pNew->zCan
7600: 6f 6e 69 63 61 6c 4e 61 6d 65 2c 20 6e 29 3b 0a onicalName, n);.
7610: 0a 20 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 . /* Search for
7620: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 an existing ent
7630: 72 79 20 74 68 61 74 20 6d 61 74 63 68 69 6e 67 ry that matching
7640: 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20 6e the canonical n
7650: 61 6d 65 2e 0a 20 20 2a 2a 20 49 66 20 66 6f 75 ame.. ** If fou
7660: 6e 64 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 nd, increment th
7670: 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e e reference coun
7680: 74 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70 t and return a p
7690: 6f 69 6e 74 65 72 20 74 6f 0a 20 20 2a 2a 20 74 ointer to. ** t
76a0: 68 65 20 65 78 69 73 74 69 6e 67 20 66 69 6c 65 he existing file
76b0: 20 49 44 2e 0a 20 20 2a 2f 0a 20 20 75 6e 69 78 ID.. */. unix
76c0: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 EnterMutex();.
76d0: 66 6f 72 28 70 43 61 6e 64 69 64 61 74 65 3d 76 for(pCandidate=v
76e0: 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 74 3b 20 xworksFileList;
76f0: 70 43 61 6e 64 69 64 61 74 65 3b 20 70 43 61 6e pCandidate; pCan
7700: 64 69 64 61 74 65 3d 70 43 61 6e 64 69 64 61 74 didate=pCandidat
7710: 65 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 e->pNext){. i
7720: 66 28 20 70 43 61 6e 64 69 64 61 74 65 2d 3e 6e f( pCandidate->n
7730: 4e 61 6d 65 3d 3d 6e 20 0a 20 20 20 20 20 26 26 Name==n . &&
7740: 20 6d 65 6d 63 6d 70 28 70 43 61 6e 64 69 64 61 memcmp(pCandida
7750: 74 65 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 te->zCanonicalNa
7760: 6d 65 2c 20 70 4e 65 77 2d 3e 7a 43 61 6e 6f 6e me, pNew->zCanon
7770: 69 63 61 6c 4e 61 6d 65 2c 20 6e 29 3d 3d 30 0a icalName, n)==0.
7780: 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 73 71 ){. sq
7790: 6c 69 74 65 33 5f 66 72 65 65 28 70 4e 65 77 29 lite3_free(pNew)
77a0: 3b 0a 20 20 20 20 20 20 20 70 43 61 6e 64 69 64 ;. pCandid
77b0: 61 74 65 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 ate->nRef++;.
77c0: 20 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 unixLeaveMut
77d0: 65 78 28 29 3b 0a 20 20 20 20 20 20 20 72 65 74 ex();. ret
77e0: 75 72 6e 20 70 43 61 6e 64 69 64 61 74 65 3b 0a urn pCandidate;.
77f0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
7800: 4e 6f 20 6d 61 74 63 68 20 77 61 73 20 66 6f 75 No match was fou
7810: 6e 64 2e 20 20 57 65 20 77 69 6c 6c 20 6d 61 6b nd. We will mak
7820: 65 20 61 20 6e 65 77 20 66 69 6c 65 20 49 44 20 e a new file ID
7830: 2a 2f 0a 20 20 70 4e 65 77 2d 3e 6e 52 65 66 20 */. pNew->nRef
7840: 3d 20 31 3b 0a 20 20 70 4e 65 77 2d 3e 6e 4e 61 = 1;. pNew->nNa
7850: 6d 65 20 3d 20 6e 3b 0a 20 20 70 4e 65 77 2d 3e me = n;. pNew->
7860: 70 4e 65 78 74 20 3d 20 76 78 77 6f 72 6b 73 46 pNext = vxworksF
7870: 69 6c 65 4c 69 73 74 3b 0a 20 20 76 78 77 6f 72 ileList;. vxwor
7880: 6b 73 46 69 6c 65 4c 69 73 74 20 3d 20 70 4e 65 ksFileList = pNe
7890: 77 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 w;. unixLeaveMu
78a0: 74 65 78 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 tex();. return
78b0: 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 pNew;.}../*.** D
78c0: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 72 65 66 ecrement the ref
78d0: 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 6f 6e 20 erence count on
78e0: 61 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 a vxworksFileId
78f0: 6f 62 6a 65 63 74 2e 20 20 46 72 65 65 0a 2a 2a object. Free.**
7900: 20 74 68 65 20 6f 62 6a 65 63 74 20 77 68 65 6e the object when
7910: 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 the reference c
7920: 6f 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65 72 ount reaches zer
7930: 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 o..*/.static voi
7940: 64 20 76 78 77 6f 72 6b 73 52 65 6c 65 61 73 65 d vxworksRelease
7950: 46 69 6c 65 49 64 28 73 74 72 75 63 74 20 76 78 FileId(struct vx
7960: 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70 49 64 worksFileId *pId
7970: 29 7b 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 ){. unixEnterMu
7980: 74 65 78 28 29 3b 0a 20 20 61 73 73 65 72 74 28 tex();. assert(
7990: 20 70 49 64 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a pId->nRef>0 );.
79a0: 20 20 70 49 64 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 pId->nRef--;.
79b0: 20 69 66 28 20 70 49 64 2d 3e 6e 52 65 66 3d 3d if( pId->nRef==
79c0: 30 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 0 ){. struct
79d0: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 2a vxworksFileId **
79e0: 70 70 3b 0a 20 20 20 20 66 6f 72 28 70 70 3d 26 pp;. for(pp=&
79f0: 76 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 74 3b vxworksFileList;
7a00: 20 2a 70 70 20 26 26 20 2a 70 70 21 3d 70 49 64 *pp && *pp!=pId
7a10: 3b 20 70 70 20 3d 20 26 28 28 2a 70 70 29 2d 3e ; pp = &((*pp)->
7a20: 70 4e 65 78 74 29 29 7b 7d 0a 20 20 20 20 61 73 pNext)){}. as
7a30: 73 65 72 74 28 20 2a 70 70 3d 3d 70 49 64 20 29 sert( *pp==pId )
7a40: 3b 0a 20 20 20 20 2a 70 70 20 3d 20 70 49 64 2d ;. *pp = pId-
7a50: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 >pNext;. sqli
7a60: 74 65 33 5f 66 72 65 65 28 70 49 64 29 3b 0a 20 te3_free(pId);.
7a70: 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 }. unixLeaveMu
7a80: 74 65 78 28 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 tex();.}.#endif
7a90: 2f 2a 20 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f /* OS_VXWORKS */
7aa0: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ./**************
7ab0: 2a 20 45 6e 64 20 6f 66 20 55 6e 69 71 75 65 20 * End of Unique
7ac0: 46 69 6c 65 20 49 44 20 55 74 69 6c 69 74 79 20 File ID Utility
7ad0: 55 73 65 64 20 42 79 20 56 78 57 6f 72 6b 73 20 Used By VxWorks
7ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7af0: 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .***************
7b00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
7b40: 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .../************
7b50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b70: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7b90: 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
7ba0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 50 ************** P
7bb0: 6f 73 69 78 20 41 64 76 69 73 6f 72 79 20 4c 6f osix Advisory Lo
7bc0: 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a cking **********
7bd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7be0: 2a 2a 0a 2a 2a 0a 2a 2a 20 50 4f 53 49 58 20 61 **.**.** POSIX a
7bf0: 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 20 61 72 dvisory locks ar
7c00: 65 20 62 72 6f 6b 65 6e 20 62 79 20 64 65 73 69 e broken by desi
7c10: 67 6e 2e 20 20 41 4e 53 49 20 53 54 44 20 31 30 gn. ANSI STD 10
7c20: 30 33 2e 31 20 28 31 39 39 36 29 0a 2a 2a 20 73 03.1 (1996).** s
7c30: 65 63 74 69 6f 6e 20 36 2e 35 2e 32 2e 32 20 6c ection 6.5.2.2 l
7c40: 69 6e 65 73 20 34 38 33 20 74 68 72 6f 75 67 68 ines 483 through
7c50: 20 34 39 30 20 73 70 65 63 69 66 79 20 74 68 61 490 specify tha
7c60: 74 20 77 68 65 6e 20 61 20 70 72 6f 63 65 73 73 t when a process
7c70: 0a 2a 2a 20 73 65 74 73 20 6f 72 20 63 6c 65 61 .** sets or clea
7c80: 72 73 20 61 20 6c 6f 63 6b 2c 20 74 68 61 74 20 rs a lock, that
7c90: 6f 70 65 72 61 74 69 6f 6e 20 6f 76 65 72 72 69 operation overri
7ca0: 64 65 73 20 61 6e 79 20 70 72 69 6f 72 20 6c 6f des any prior lo
7cb0: 63 6b 73 20 73 65 74 0a 2a 2a 20 62 79 20 74 68 cks set.** by th
7cc0: 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 e same process.
7cd0: 20 49 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 70 It does not exp
7ce0: 6c 69 63 69 74 6c 79 20 73 61 79 20 73 6f 2c 20 licitly say so,
7cf0: 62 75 74 20 74 68 69 73 20 69 6d 70 6c 69 65 73 but this implies
7d00: 0a 2a 2a 20 74 68 61 74 20 69 74 20 6f 76 65 72 .** that it over
7d10: 72 69 64 65 73 20 6c 6f 63 6b 73 20 73 65 74 20 rides locks set
7d20: 62 79 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63 by the same proc
7d30: 65 73 73 20 75 73 69 6e 67 20 61 20 64 69 66 66 ess using a diff
7d40: 65 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20 64 65 erent.** file de
7d50: 73 63 72 69 70 74 6f 72 2e 20 20 43 6f 6e 73 69 scriptor. Consi
7d60: 64 65 72 20 74 68 69 73 20 74 65 73 74 20 63 61 der this test ca
7d70: 73 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 se:.**.**
7d80: 69 6e 74 20 66 64 31 20 3d 20 6f 70 65 6e 28 22 int fd1 = open("
7d90: 2e 2f 66 69 6c 65 31 22 2c 20 4f 5f 52 44 57 52 ./file1", O_RDWR
7da0: 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b |O_CREAT, 0644);
7db0: 0a 2a 2a 20 20 20 20 20 20 20 69 6e 74 20 66 64 .** int fd
7dc0: 32 20 3d 20 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 2 = open("./file
7dd0: 32 22 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 2", O_RDWR|O_CRE
7de0: 41 54 2c 20 30 36 34 34 29 3b 0a 2a 2a 0a 2a 2a AT, 0644);.**.**
7df0: 20 53 75 70 70 6f 73 65 20 2e 2f 66 69 6c 65 31 Suppose ./file1
7e00: 20 61 6e 64 20 2e 2f 66 69 6c 65 32 20 61 72 65 and ./file2 are
7e10: 20 72 65 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 really the same
7e20: 20 66 69 6c 65 20 28 62 65 63 61 75 73 65 0a 2a file (because.*
7e30: 2a 20 6f 6e 65 20 69 73 20 61 20 68 61 72 64 20 * one is a hard
7e40: 6f 72 20 73 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b or symbolic link
7e50: 20 74 6f 20 74 68 65 20 6f 74 68 65 72 29 20 74 to the other) t
7e60: 68 65 6e 20 69 66 20 79 6f 75 20 73 65 74 0a 2a hen if you set.*
7e70: 2a 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c * an exclusive l
7e80: 6f 63 6b 20 6f 6e 20 66 64 31 2c 20 74 68 65 6e ock on fd1, then
7e90: 20 74 72 79 20 74 6f 20 67 65 74 20 61 6e 20 65 try to get an e
7ea0: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 0a 2a 2a xclusive lock.**
7eb0: 20 6f 6e 20 66 64 32 2c 20 69 74 20 77 6f 72 6b on fd2, it work
7ec0: 73 2e 20 20 49 20 77 6f 75 6c 64 20 68 61 76 65 s. I would have
7ed0: 20 65 78 70 65 63 74 65 64 20 74 68 65 20 73 65 expected the se
7ee0: 63 6f 6e 64 20 6c 6f 63 6b 20 74 6f 0a 2a 2a 20 cond lock to.**
7ef0: 66 61 69 6c 20 73 69 6e 63 65 20 74 68 65 72 65 fail since there
7f00: 20 77 61 73 20 61 6c 72 65 61 64 79 20 61 20 6c was already a l
7f10: 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 ock on the file
7f20: 64 75 65 20 74 6f 20 66 64 31 2e 0a 2a 2a 20 42 due to fd1..** B
7f30: 75 74 20 6e 6f 74 20 73 6f 2e 20 20 53 69 6e 63 ut not so. Sinc
7f40: 65 20 62 6f 74 68 20 6c 6f 63 6b 73 20 63 61 6d e both locks cam
7f50: 65 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65 20 e from the same
7f60: 70 72 6f 63 65 73 73 2c 20 74 68 65 0a 2a 2a 20 process, the.**
7f70: 73 65 63 6f 6e 64 20 6f 76 65 72 72 69 64 65 73 second overrides
7f80: 20 74 68 65 20 66 69 72 73 74 2c 20 65 76 65 6e the first, even
7f90: 20 74 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 though they wer
7fa0: 65 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 0a 2a e on different.*
7fb0: 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f * file descripto
7fc0: 72 73 20 6f 70 65 6e 65 64 20 6f 6e 20 64 69 66 rs opened on dif
7fd0: 66 65 72 65 6e 74 20 66 69 6c 65 20 6e 61 6d 65 ferent file name
7fe0: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d 65 s..**.** This me
7ff0: 61 6e 73 20 74 68 61 74 20 77 65 20 63 61 6e 6e ans that we cann
8000: 6f 74 20 75 73 65 20 50 4f 53 49 58 20 6c 6f 63 ot use POSIX loc
8010: 6b 73 20 74 6f 20 73 79 6e 63 68 72 6f 6e 69 7a ks to synchroniz
8020: 65 20 66 69 6c 65 20 61 63 63 65 73 73 0a 2a 2a e file access.**
8030: 20 61 6d 6f 6e 67 20 63 6f 6d 70 65 74 69 6e 67 among competing
8040: 20 74 68 72 65 61 64 73 20 6f 66 20 74 68 65 20 threads of the
8050: 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 20 50 same process. P
8060: 4f 53 49 58 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 OSIX locks will
8070: 77 6f 72 6b 20 66 69 6e 65 0a 2a 2a 20 74 6f 20 work fine.** to
8080: 73 79 6e 63 68 72 6f 6e 69 7a 65 20 61 63 63 65 synchronize acce
8090: 73 73 20 66 6f 72 20 74 68 72 65 61 64 73 20 69 ss for threads i
80a0: 6e 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 n separate proce
80b0: 73 73 65 73 2c 20 62 75 74 20 6e 6f 74 0a 2a 2a sses, but not.**
80c0: 20 74 68 72 65 61 64 73 20 77 69 74 68 69 6e 20 threads within
80d0: 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 the same process
80e0: 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b 20 ..**.** To work
80f0: 61 72 6f 75 6e 64 20 74 68 65 20 70 72 6f 62 6c around the probl
8100: 65 6d 2c 20 53 51 4c 69 74 65 20 68 61 73 20 74 em, SQLite has t
8110: 6f 20 6d 61 6e 61 67 65 20 66 69 6c 65 20 6c 6f o manage file lo
8120: 63 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a cks internally.*
8130: 2a 20 6f 6e 20 69 74 73 20 6f 77 6e 2e 20 20 57 * on its own. W
8140: 68 65 6e 65 76 65 72 20 61 20 6e 65 77 20 64 61 henever a new da
8150: 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e 65 64 tabase is opened
8160: 2c 20 77 65 20 68 61 76 65 20 74 6f 20 66 69 6e , we have to fin
8170: 64 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 d the.** specifi
8180: 63 20 69 6e 6f 64 65 20 6f 66 20 74 68 65 20 64 c inode of the d
8190: 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 74 68 atabase file (th
81a0: 65 20 69 6e 6f 64 65 20 69 73 20 64 65 74 65 72 e inode is deter
81b0: 6d 69 6e 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 mined by the.**
81c0: 73 74 5f 64 65 76 20 61 6e 64 20 73 74 5f 69 6e st_dev and st_in
81d0: 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 o fields of the
81e0: 73 74 61 74 20 73 74 72 75 63 74 75 72 65 20 74 stat structure t
81f0: 68 61 74 20 66 73 74 61 74 28 29 20 66 69 6c 6c hat fstat() fill
8200: 73 20 69 6e 29 0a 2a 2a 20 61 6e 64 20 63 68 65 s in).** and che
8210: 63 6b 20 66 6f 72 20 6c 6f 63 6b 73 20 61 6c 72 ck for locks alr
8220: 65 61 64 79 20 65 78 69 73 74 69 6e 67 20 6f 6e eady existing on
8230: 20 74 68 61 74 20 69 6e 6f 64 65 2e 20 20 57 68 that inode. Wh
8240: 65 6e 20 6c 6f 63 6b 73 20 61 72 65 0a 2a 2a 20 en locks are.**
8250: 63 72 65 61 74 65 64 20 6f 72 20 72 65 6d 6f 76 created or remov
8260: 65 64 2c 20 77 65 20 68 61 76 65 20 74 6f 20 6c ed, we have to l
8270: 6f 6f 6b 20 61 74 20 6f 75 72 20 6f 77 6e 20 69 ook at our own i
8280: 6e 74 65 72 6e 61 6c 20 72 65 63 6f 72 64 20 6f nternal record o
8290: 66 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 73 20 74 f the.** locks t
82a0: 6f 20 73 65 65 20 69 66 20 61 6e 6f 74 68 65 72 o see if another
82b0: 20 74 68 72 65 61 64 20 68 61 73 20 70 72 65 76 thread has prev
82c0: 69 6f 75 73 6c 79 20 73 65 74 20 61 20 6c 6f 63 iously set a loc
82d0: 6b 20 6f 6e 20 74 68 61 74 20 73 61 6d 65 0a 2a k on that same.*
82e0: 2a 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 28 * inode..**.** (
82f0: 41 73 69 64 65 3a 20 54 68 65 20 75 73 65 20 6f Aside: The use o
8300: 66 20 69 6e 6f 64 65 20 6e 75 6d 62 65 72 73 20 f inode numbers
8310: 61 73 20 75 6e 69 71 75 65 20 49 44 73 20 64 6f as unique IDs do
8320: 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e 20 56 es not work on V
8330: 78 57 6f 72 6b 73 2e 0a 2a 2a 20 46 6f 72 20 56 xWorks..** For V
8340: 78 57 6f 72 6b 73 2c 20 77 65 20 68 61 76 65 20 xWorks, we have
8350: 74 6f 20 75 73 65 20 74 68 65 20 61 6c 74 65 72 to use the alter
8360: 6e 61 74 69 76 65 20 75 6e 69 71 75 65 20 49 44 native unique ID
8370: 20 73 79 73 74 65 6d 20 62 61 73 65 64 20 6f 6e system based on
8380: 0a 2a 2a 20 63 61 6e 6f 6e 69 63 61 6c 20 66 69 .** canonical fi
8390: 6c 65 6e 61 6d 65 20 61 6e 64 20 69 6d 70 6c 65 lename and imple
83a0: 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 70 72 mented in the pr
83b0: 65 76 69 6f 75 73 20 64 69 76 69 73 69 6f 6e 2e evious division.
83c0: 29 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 ).**.** The sqli
83d0: 74 65 33 5f 66 69 6c 65 20 73 74 72 75 63 74 75 te3_file structu
83e0: 72 65 20 66 6f 72 20 50 4f 53 49 58 20 69 73 20 re for POSIX is
83f0: 6e 6f 20 6c 6f 6e 67 65 72 20 6a 75 73 74 20 61 no longer just a
8400: 6e 20 69 6e 74 65 67 65 72 20 66 69 6c 65 0a 2a n integer file.*
8410: 2a 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 49 * descriptor. I
8420: 74 20 69 73 20 6e 6f 77 20 61 20 73 74 72 75 63 t is now a struc
8430: 74 75 72 65 20 74 68 61 74 20 68 6f 6c 64 73 20 ture that holds
8440: 74 68 65 20 69 6e 74 65 67 65 72 20 66 69 6c 65 the integer file
8450: 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 61 .** descriptor a
8460: 6e 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 nd a pointer to
8470: 61 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74 a structure that
8480: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 69 describes the i
8490: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 6c 6f 63 6b 73 nternal.** locks
84a0: 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f on the correspo
84b0: 6e 64 69 6e 67 20 69 6e 6f 64 65 2e 20 20 54 68 nding inode. Th
84c0: 65 72 65 20 69 73 20 6f 6e 65 20 6c 6f 63 6b 69 ere is one locki
84d0: 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 ng structure.**
84e0: 70 65 72 20 69 6e 6f 64 65 2c 20 73 6f 20 69 66 per inode, so if
84f0: 20 74 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20 the same inode
8500: 69 73 20 6f 70 65 6e 65 64 20 74 77 69 63 65 2c is opened twice,
8510: 20 62 6f 74 68 20 75 6e 69 78 46 69 6c 65 20 73 both unixFile s
8520: 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 70 6f 69 tructures.** poi
8530: 6e 74 20 74 6f 20 74 68 65 20 73 61 6d 65 20 6c nt to the same l
8540: 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 ocking structure
8550: 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 73 . The locking s
8560: 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 0a 2a tructure keeps.*
8570: 2a 20 61 20 72 65 66 65 72 65 6e 63 65 20 63 6f * a reference co
8580: 75 6e 74 20 28 73 6f 20 77 65 20 77 69 6c 6c 20 unt (so we will
8590: 6b 6e 6f 77 20 77 68 65 6e 20 74 6f 20 64 65 6c know when to del
85a0: 65 74 65 20 69 74 29 20 61 6e 64 20 61 20 22 63 ete it) and a "c
85b0: 6e 74 22 0a 2a 2a 20 66 69 65 6c 64 20 74 68 61 nt".** field tha
85c0: 74 20 74 65 6c 6c 73 20 75 73 20 69 74 73 20 69 t tells us its i
85d0: 6e 74 65 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 nternal lock sta
85e0: 74 75 73 2e 20 20 63 6e 74 3d 3d 30 20 6d 65 61 tus. cnt==0 mea
85f0: 6e 73 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 69 ns the.** file i
8600: 73 20 75 6e 6c 6f 63 6b 65 64 2e 20 20 63 6e 74 s unlocked. cnt
8610: 3d 3d 2d 31 20 6d 65 61 6e 73 20 74 68 65 20 66 ==-1 means the f
8620: 69 6c 65 20 68 61 73 20 61 6e 20 65 78 63 6c 75 ile has an exclu
8630: 73 69 76 65 20 6c 6f 63 6b 2e 0a 2a 2a 20 63 6e sive lock..** cn
8640: 74 3e 30 20 6d 65 61 6e 73 20 74 68 65 72 65 20 t>0 means there
8650: 61 72 65 20 63 6e 74 20 73 68 61 72 65 64 20 6c are cnt shared l
8660: 6f 63 6b 73 20 6f 6e 20 74 68 65 20 66 69 6c 65 ocks on the file
8670: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 79 20 61 74 74 65 ..**.** Any atte
8680: 6d 70 74 20 74 6f 20 6c 6f 63 6b 20 6f 72 20 75 mpt to lock or u
8690: 6e 6c 6f 63 6b 20 61 20 66 69 6c 65 20 66 69 72 nlock a file fir
86a0: 73 74 20 63 68 65 63 6b 73 20 74 68 65 20 6c 6f st checks the lo
86b0: 63 6b 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 cking.** structu
86c0: 72 65 2e 20 20 54 68 65 20 66 63 6e 74 6c 28 29 re. The fcntl()
86d0: 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 69 73 20 system call is
86e0: 6f 6e 6c 79 20 69 6e 76 6f 6b 65 64 20 74 6f 20 only invoked to
86f0: 73 65 74 20 61 20 0a 2a 2a 20 50 4f 53 49 58 20 set a .** POSIX
8700: 6c 6f 63 6b 20 69 66 20 74 68 65 20 69 6e 74 65 lock if the inte
8710: 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 72 75 63 74 rnal lock struct
8720: 75 72 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 ure transitions
8730: 62 65 74 77 65 65 6e 0a 2a 2a 20 61 20 6c 6f 63 between.** a loc
8740: 6b 65 64 20 61 6e 64 20 61 6e 20 75 6e 6c 6f 63 ked and an unloc
8750: 6b 65 64 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a ked state..**.**
8760: 20 42 75 74 20 77 61 69 74 3a 20 20 74 68 65 72 But wait: ther
8770: 65 20 61 72 65 20 79 65 74 20 6d 6f 72 65 20 70 e are yet more p
8780: 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 50 4f 53 roblems with POS
8790: 49 58 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 6b IX advisory lock
87a0: 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 79 6f 75 20 s..**.** If you
87b0: 63 6c 6f 73 65 20 61 20 66 69 6c 65 20 64 65 73 close a file des
87c0: 63 72 69 70 74 6f 72 20 74 68 61 74 20 70 6f 69 criptor that poi
87d0: 6e 74 73 20 74 6f 20 61 20 66 69 6c 65 20 74 68 nts to a file th
87e0: 61 74 20 68 61 73 20 6c 6f 63 6b 73 2c 0a 2a 2a at has locks,.**
87f0: 20 61 6c 6c 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 all locks on th
8800: 61 74 20 66 69 6c 65 20 74 68 61 74 20 61 72 65 at file that are
8810: 20 6f 77 6e 65 64 20 62 79 20 74 68 65 20 63 75 owned by the cu
8820: 72 72 65 6e 74 20 70 72 6f 63 65 73 73 20 61 72 rrent process ar
8830: 65 0a 2a 2a 20 72 65 6c 65 61 73 65 64 2e 20 20 e.** released.
8840: 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 74 To work around t
8850: 68 69 73 20 70 72 6f 62 6c 65 6d 2c 20 65 61 63 his problem, eac
8860: 68 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 h unixInodeInfo
8870: 6f 62 6a 65 63 74 0a 2a 2a 20 6d 61 69 6e 74 61 object.** mainta
8880: 69 6e 73 20 61 20 63 6f 75 6e 74 20 6f 66 20 74 ins a count of t
8890: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 65 6e he number of pen
88a0: 64 69 6e 67 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 ding locks on th
88b0: 61 20 69 6e 6f 64 65 2e 0a 2a 2a 20 57 68 65 6e a inode..** When
88c0: 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d an attempt is m
88d0: 61 64 65 20 74 6f 20 63 6c 6f 73 65 20 61 6e 20 ade to close an
88e0: 75 6e 69 78 46 69 6c 65 2c 20 69 66 20 74 68 65 unixFile, if the
88f0: 72 65 20 61 72 65 0a 2a 2a 20 6f 74 68 65 72 20 re are.** other
8900: 75 6e 69 78 46 69 6c 65 20 6f 70 65 6e 20 6f 6e unixFile open on
8910: 20 74 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20 the same inode
8920: 74 68 61 74 20 61 72 65 20 68 6f 6c 64 69 6e 67 that are holding
8930: 20 6c 6f 63 6b 73 2c 20 74 68 65 20 63 61 6c 6c locks, the call
8940: 0a 2a 2a 20 74 6f 20 63 6c 6f 73 65 28 29 20 74 .** to close() t
8950: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
8960: 6f 72 20 69 73 20 64 65 66 65 72 72 65 64 20 75 or is deferred u
8970: 6e 74 69 6c 20 61 6c 6c 20 6f 66 20 74 68 65 20 ntil all of the
8980: 6c 6f 63 6b 73 20 63 6c 65 61 72 2e 0a 2a 2a 20 locks clear..**
8990: 54 68 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 The unixInodeInf
89a0: 6f 20 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 o structure keep
89b0: 73 20 61 20 6c 69 73 74 20 6f 66 20 66 69 6c 65 s a list of file
89c0: 20 64 65 73 63 72 69 70 74 6f 72 73 20 74 68 61 descriptors tha
89d0: 74 20 6e 65 65 64 20 74 6f 0a 2a 2a 20 62 65 20 t need to.** be
89e0: 63 6c 6f 73 65 64 20 61 6e 64 20 74 68 61 74 20 closed and that
89f0: 6c 69 73 74 20 69 73 20 77 61 6c 6b 65 64 20 28 list is walked (
8a00: 61 6e 64 20 63 6c 65 61 72 65 64 29 20 77 68 65 and cleared) whe
8a10: 6e 20 74 68 65 20 6c 61 73 74 20 6c 6f 63 6b 0a n the last lock.
8a20: 2a 2a 20 63 6c 65 61 72 73 2e 0a 2a 2a 0a 2a 2a ** clears..**.**
8a30: 20 59 65 74 20 61 6e 6f 74 68 65 72 20 70 72 6f Yet another pro
8a40: 62 6c 65 6d 3a 20 20 4c 69 6e 75 78 54 68 72 65 blem: LinuxThre
8a50: 61 64 73 20 64 6f 20 6e 6f 74 20 70 6c 61 79 20 ads do not play
8a60: 77 65 6c 6c 20 77 69 74 68 20 70 6f 73 69 78 20 well with posix
8a70: 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4d 61 6e locks..**.** Man
8a80: 79 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 y older versions
8a90: 20 6f 66 20 6c 69 6e 75 78 20 75 73 65 20 74 68 of linux use th
8aa0: 65 20 4c 69 6e 75 78 54 68 72 65 61 64 73 20 6c e LinuxThreads l
8ab0: 69 62 72 61 72 79 20 77 68 69 63 68 20 69 73 0a ibrary which is.
8ac0: 2a 2a 20 6e 6f 74 20 70 6f 73 69 78 20 63 6f 6d ** not posix com
8ad0: 70 6c 69 61 6e 74 2e 20 20 55 6e 64 65 72 20 4c pliant. Under L
8ae0: 69 6e 75 78 54 68 72 65 61 64 73 2c 20 61 20 6c inuxThreads, a l
8af0: 6f 63 6b 20 63 72 65 61 74 65 64 20 62 79 20 74 ock created by t
8b00: 68 72 65 61 64 0a 2a 2a 20 41 20 63 61 6e 6e 6f hread.** A canno
8b10: 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 6f 72 t be modified or
8b20: 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 61 overridden by a
8b30: 20 64 69 66 66 65 72 65 6e 74 20 74 68 72 65 61 different threa
8b40: 64 20 42 2e 0a 2a 2a 20 4f 6e 6c 79 20 74 68 72 d B..** Only thr
8b50: 65 61 64 20 41 20 63 61 6e 20 6d 6f 64 69 66 79 ead A can modify
8b60: 20 74 68 65 20 6c 6f 63 6b 2e 20 20 4c 6f 63 6b the lock. Lock
8b70: 69 6e 67 20 62 65 68 61 76 69 6f 72 20 69 73 20 ing behavior is
8b80: 63 6f 72 72 65 63 74 0a 2a 2a 20 69 66 20 74 68 correct.** if th
8b90: 65 20 61 70 70 6c 69 61 74 69 6f 6e 20 75 73 65 e appliation use
8ba0: 73 20 74 68 65 20 6e 65 77 65 72 20 4e 61 74 69 s the newer Nati
8bb0: 76 65 20 50 6f 73 69 78 20 54 68 72 65 61 64 20 ve Posix Thread
8bc0: 4c 69 62 72 61 72 79 20 28 4e 50 54 4c 29 0a 2a Library (NPTL).*
8bd0: 2a 20 6f 6e 20 6c 69 6e 75 78 20 2d 20 77 69 74 * on linux - wit
8be0: 68 20 4e 50 54 4c 20 61 20 6c 6f 63 6b 20 63 72 h NPTL a lock cr
8bf0: 65 61 74 65 64 20 62 79 20 74 68 72 65 61 64 20 eated by thread
8c00: 41 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 6c A can override l
8c10: 6f 63 6b 73 0a 2a 2a 20 69 6e 20 74 68 72 65 61 ocks.** in threa
8c20: 64 20 42 2e 20 20 42 75 74 20 74 68 65 72 65 20 d B. But there
8c30: 69 73 20 6e 6f 20 77 61 79 20 74 6f 20 6b 6e 6f is no way to kno
8c40: 77 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d w at compile-tim
8c50: 65 20 77 68 69 63 68 0a 2a 2a 20 74 68 72 65 61 e which.** threa
8c60: 64 69 6e 67 20 6c 69 62 72 61 72 79 20 69 73 20 ding library is
8c70: 62 65 69 6e 67 20 75 73 65 64 2e 20 20 53 6f 20 being used. So
8c80: 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 there is no way
8c90: 74 6f 20 6b 6e 6f 77 20 61 74 0a 2a 2a 20 63 6f to know at.** co
8ca0: 6d 70 69 6c 65 2d 74 69 6d 65 20 77 68 65 74 68 mpile-time wheth
8cb0: 65 72 20 6f 72 20 6e 6f 74 20 74 68 72 65 61 64 er or not thread
8cc0: 20 41 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 A can override
8cd0: 6c 6f 63 6b 73 20 6f 6e 20 74 68 72 65 61 64 20 locks on thread
8ce0: 42 2e 0a 2a 2a 20 4f 6e 65 20 68 61 73 20 74 6f B..** One has to
8cf0: 20 64 6f 20 61 20 72 75 6e 2d 74 69 6d 65 20 63 do a run-time c
8d00: 68 65 63 6b 20 74 6f 20 64 69 73 63 6f 76 65 72 heck to discover
8d10: 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 the behavior of
8d20: 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 the.** current
8d30: 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 53 process..**.** S
8d40: 51 4c 69 74 65 20 75 73 65 64 20 74 6f 20 73 75 QLite used to su
8d50: 70 70 6f 72 74 20 4c 69 6e 75 78 54 68 72 65 61 pport LinuxThrea
8d60: 64 73 2e 20 20 42 75 74 20 73 75 70 70 6f 72 74 ds. But support
8d70: 20 66 6f 72 20 4c 69 6e 75 78 54 68 72 65 61 64 for LinuxThread
8d80: 73 0a 2a 2a 20 77 61 73 20 64 72 6f 70 70 65 64 s.** was dropped
8d90: 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 beginning with
8da0: 76 65 72 73 69 6f 6e 20 33 2e 37 2e 30 2e 20 20 version 3.7.0.
8db0: 53 51 4c 69 74 65 20 77 69 6c 6c 20 73 74 69 6c SQLite will stil
8dc0: 6c 20 77 6f 72 6b 20 77 69 74 68 0a 2a 2a 20 4c l work with.** L
8dd0: 69 6e 75 78 54 68 72 65 61 64 73 20 70 72 6f 76 inuxThreads prov
8de0: 69 64 65 64 20 74 68 61 74 20 28 31 29 20 74 68 ided that (1) th
8df0: 65 72 65 20 69 73 20 6e 6f 20 6d 6f 72 65 20 74 ere is no more t
8e00: 68 61 6e 20 6f 6e 65 20 63 6f 6e 6e 65 63 74 69 han one connecti
8e10: 6f 6e 20 0a 2a 2a 20 70 65 72 20 64 61 74 61 62 on .** per datab
8e20: 61 73 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 ase file in the
8e30: 73 61 6d 65 20 70 72 6f 63 65 73 73 20 61 6e 64 same process and
8e40: 20 28 32 29 20 64 61 74 61 62 61 73 65 20 63 6f (2) database co
8e50: 6e 6e 65 63 74 69 6f 6e 73 0a 2a 2a 20 64 6f 20 nnections.** do
8e60: 6e 6f 74 20 6d 6f 76 65 20 61 63 72 6f 73 73 20 not move across
8e70: 74 68 72 65 61 64 73 2e 0a 2a 2f 0a 0a 2f 2a 0a threads..*/../*.
8e80: 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ** An instance o
8e90: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
8ea0: 73 74 72 75 63 74 75 72 65 20 73 65 72 76 65 73 structure serves
8eb0: 20 61 73 20 74 68 65 20 6b 65 79 20 75 73 65 64 as the key used
8ec0: 0a 2a 2a 20 74 6f 20 6c 6f 63 61 74 65 20 61 20 .** to locate a
8ed0: 70 61 72 74 69 63 75 6c 61 72 20 75 6e 69 78 49 particular unixI
8ee0: 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 2e nodeInfo object.
8ef0: 0a 2a 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 46 .*/.struct unixF
8f00: 69 6c 65 49 64 20 7b 0a 20 20 64 65 76 5f 74 20 ileId {. dev_t
8f10: 64 65 76 3b 20 20 20 20 20 20 20 20 20 20 20 20 dev;
8f20: 20 20 20 20 20 20 2f 2a 20 44 65 76 69 63 65 20 /* Device
8f30: 6e 75 6d 62 65 72 20 2a 2f 0a 23 69 66 20 4f 53 number */.#if OS
8f40: 5f 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 75 63 _VXWORKS. struc
8f50: 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 t vxworksFileId
8f60: 2a 70 49 64 3b 20 20 2f 2a 20 55 6e 69 71 75 65 *pId; /* Unique
8f70: 20 66 69 6c 65 20 49 44 20 66 6f 72 20 76 78 77 file ID for vxw
8f80: 6f 72 6b 73 2e 20 2a 2f 0a 23 65 6c 73 65 0a 20 orks. */.#else.
8f90: 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20 20 20 20 ino_t ino;
8fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8fb0: 49 6e 6f 64 65 20 6e 75 6d 62 65 72 20 2a 2f 0a Inode number */.
8fc0: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
8fd0: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
8fe0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
8ff0: 72 75 63 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 ructure is alloc
9000: 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 6f 70 ated for each op
9010: 65 6e 0a 2a 2a 20 69 6e 6f 64 65 2e 20 20 4f 72 en.** inode. Or
9020: 2c 20 6f 6e 20 4c 69 6e 75 78 54 68 72 65 61 64 , on LinuxThread
9030: 73 2c 20 74 68 65 72 65 20 69 73 20 6f 6e 65 20 s, there is one
9040: 6f 66 20 74 68 65 73 65 20 73 74 72 75 63 74 75 of these structu
9050: 72 65 73 20 66 6f 72 0a 2a 2a 20 65 61 63 68 20 res for.** each
9060: 69 6e 6f 64 65 20 6f 70 65 6e 65 64 20 62 79 20 inode opened by
9070: 65 61 63 68 20 74 68 72 65 61 64 2e 0a 2a 2a 0a each thread..**.
9080: 2a 2a 20 41 20 73 69 6e 67 6c 65 20 69 6e 6f 64 ** A single inod
9090: 65 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 e can have multi
90a0: 70 6c 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 ple file descrip
90b0: 74 6f 72 73 2c 20 73 6f 20 65 61 63 68 20 75 6e tors, so each un
90c0: 69 78 46 69 6c 65 0a 2a 2a 20 73 74 72 75 63 74 ixFile.** struct
90d0: 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 ure contains a p
90e0: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e 73 ointer to an ins
90f0: 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 tance of this ob
9100: 6a 65 63 74 20 61 6e 64 20 74 68 69 73 0a 2a 2a ject and this.**
9110: 20 6f 62 6a 65 63 74 20 6b 65 65 70 73 20 61 20 object keeps a
9120: 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d count of the num
9130: 62 65 72 20 6f 66 20 75 6e 69 78 46 69 6c 65 20 ber of unixFile
9140: 70 6f 69 6e 74 69 6e 67 20 74 6f 20 69 74 2e 0a pointing to it..
9150: 2a 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 49 6e */.struct unixIn
9160: 6f 64 65 49 6e 66 6f 20 7b 0a 20 20 73 74 72 75 odeInfo {. stru
9170: 63 74 20 75 6e 69 78 46 69 6c 65 49 64 20 66 69 ct unixFileId fi
9180: 6c 65 49 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 leId; /* T
9190: 68 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f he lookup key */
91a0: 0a 20 20 69 6e 74 20 6e 53 68 61 72 65 64 3b 20 . int nShared;
91b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
91c0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
91d0: 53 48 41 52 45 44 20 6c 6f 63 6b 73 20 68 65 6c SHARED locks hel
91e0: 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 d */. unsigned
91f0: 63 68 61 72 20 65 46 69 6c 65 4c 6f 63 6b 3b 20 char eFileLock;
9200: 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 /* One of
9210: 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c 20 52 45 SHARED_LOCK, RE
9220: 53 45 52 56 45 44 5f 4c 4f 43 4b 20 65 74 63 2e SERVED_LOCK etc.
9230: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 */. unsigned c
9240: 68 61 72 20 62 50 72 6f 63 65 73 73 4c 6f 63 6b har bProcessLock
9250: 3b 20 20 20 20 20 2f 2a 20 41 6e 20 65 78 63 6c ; /* An excl
9260: 75 73 69 76 65 20 70 72 6f 63 65 73 73 20 6c 6f usive process lo
9270: 63 6b 20 69 73 20 68 65 6c 64 20 2a 2f 0a 20 20 ck is held */.
9280: 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 20 int nRef;
9290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
92a0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 /* Number of poi
92b0: 6e 74 65 72 73 20 74 6f 20 74 68 69 73 20 73 74 nters to this st
92c0: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 75 6e 69 ructure */. uni
92d0: 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f xShmNode *pShmNo
92e0: 64 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 de; /*
92f0: 53 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 61 73 Shared memory as
9300: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
9310: 69 73 20 69 6e 6f 64 65 20 2a 2f 0a 20 20 69 6e is inode */. in
9320: 74 20 6e 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 t nLock;
9330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9340: 20 4e 75 6d 62 65 72 20 6f 66 20 6f 75 74 73 74 Number of outst
9350: 61 6e 64 69 6e 67 20 66 69 6c 65 20 6c 6f 63 6b anding file lock
9360: 73 20 2a 2f 0a 20 20 55 6e 69 78 55 6e 75 73 65 s */. UnixUnuse
9370: 64 46 64 20 2a 70 55 6e 75 73 65 64 3b 20 20 20 dFd *pUnused;
9380: 20 20 20 20 20 20 20 2f 2a 20 55 6e 75 73 65 64 /* Unused
9390: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
93a0: 73 20 74 6f 20 63 6c 6f 73 65 20 2a 2f 0a 20 20 s to close */.
93b0: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 unixInodeInfo *p
93c0: 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 Next;
93d0: 2f 2a 20 4c 69 73 74 20 6f 66 20 61 6c 6c 20 75 /* List of all u
93e0: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a nixInodeInfo obj
93f0: 65 63 74 73 20 2a 2f 0a 20 20 75 6e 69 78 49 6e ects */. unixIn
9400: 6f 64 65 49 6e 66 6f 20 2a 70 50 72 65 76 3b 20 odeInfo *pPrev;
9410: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 20 /*
9420: 2e 2e 2e 2e 20 64 6f 75 62 6c 79 20 6c 69 6e 6b .... doubly link
9430: 65 64 20 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 ed */.#if SQLITE
9440: 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f _ENABLE_LOCKING_
9450: 53 54 59 4c 45 0a 20 20 75 6e 73 69 67 6e 65 64 STYLE. unsigned
9460: 20 6c 6f 6e 67 20 6c 6f 6e 67 20 73 68 61 72 65 long long share
9470: 64 42 79 74 65 3b 20 20 2f 2a 20 66 6f 72 20 41 dByte; /* for A
9480: 46 50 20 73 69 6d 75 6c 61 74 65 64 20 73 68 61 FP simulated sha
9490: 72 65 64 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 red lock */.#end
94a0: 69 66 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b if.#if OS_VXWORK
94b0: 53 0a 20 20 73 65 6d 5f 74 20 2a 70 53 65 6d 3b S. sem_t *pSem;
94c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
94d0: 20 20 20 20 2f 2a 20 4e 61 6d 65 64 20 50 4f 53 /* Named POS
94e0: 49 58 20 73 65 6d 61 70 68 6f 72 65 20 2a 2f 0a IX semaphore */.
94f0: 20 20 63 68 61 72 20 61 53 65 6d 4e 61 6d 65 5b char aSemName[
9500: 4d 41 58 5f 50 41 54 48 4e 41 4d 45 2b 32 5d 3b MAX_PATHNAME+2];
9510: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 61 /* Name of tha
9520: 74 20 73 65 6d 61 70 68 6f 72 65 20 2a 2f 0a 23 t semaphore */.#
9530: 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 endif.};../*.**
9540: 41 20 6c 69 73 74 73 20 6f 66 20 61 6c 6c 20 75 A lists of all u
9550: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a nixInodeInfo obj
9560: 65 63 74 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ects..*/.static
9570: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 69 unixInodeInfo *i
9580: 6e 6f 64 65 4c 69 73 74 20 3d 20 30 3b 0a 0a 2f nodeList = 0;../
9590: 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e *.**.** This fun
95a0: 63 74 69 6f 6e 20 2d 20 75 6e 69 78 4c 6f 67 45 ction - unixLogE
95b0: 72 72 6f 72 41 74 4c 69 6e 65 28 29 2c 20 69 73 rrorAtLine(), is
95c0: 20 6f 6e 6c 79 20 65 76 65 72 20 63 61 6c 6c 65 only ever calle
95d0: 64 20 76 69 61 20 74 68 65 20 6d 61 63 72 6f 0a d via the macro.
95e0: 2a 2a 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 ** unixLogError(
95f0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 69 )..**.** It is i
9600: 6e 76 6f 6b 65 64 20 61 66 74 65 72 20 61 6e 20 nvoked after an
9610: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 69 6e 20 error occurs in
9620: 61 6e 20 4f 53 20 66 75 6e 63 74 69 6f 6e 20 61 an OS function a
9630: 6e 64 20 65 72 72 6e 6f 20 68 61 73 20 62 65 65 nd errno has bee
9640: 6e 0a 2a 2a 20 73 65 74 2e 20 49 74 20 6c 6f 67 n.** set. It log
9650: 73 20 61 20 6d 65 73 73 61 67 65 20 75 73 69 6e s a message usin
9660: 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 29 20 g sqlite3_log()
9670: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
9680: 75 72 72 65 6e 74 20 76 61 6c 75 65 20 6f 66 0a urrent value of.
9690: 2a 2a 20 65 72 72 6e 6f 20 61 6e 64 2c 20 69 66 ** errno and, if
96a0: 20 70 6f 73 73 69 62 6c 65 2c 20 74 68 65 20 68 possible, the h
96b0: 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 65 71 uman-readable eq
96c0: 75 69 76 61 6c 65 6e 74 20 66 72 6f 6d 20 73 74 uivalent from st
96d0: 72 65 72 72 6f 72 28 29 20 6f 72 0a 2a 2a 20 73 rerror() or.** s
96e0: 74 72 65 72 72 6f 72 5f 72 28 29 2e 0a 2a 2a 0a trerror_r()..**.
96f0: 2a 2a 20 54 68 65 20 66 69 72 73 74 20 61 72 67 ** The first arg
9700: 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f 20 ument passed to
9710: 74 68 65 20 6d 61 63 72 6f 20 73 68 6f 75 6c 64 the macro should
9720: 20 62 65 20 74 68 65 20 65 72 72 6f 72 20 63 6f be the error co
9730: 64 65 20 74 68 61 74 0a 2a 2a 20 77 69 6c 6c 20 de that.** will
9740: 62 65 20 72 65 74 75 72 6e 65 64 20 74 6f 20 53 be returned to S
9750: 51 4c 69 74 65 20 28 65 2e 67 2e 20 53 51 4c 49 QLite (e.g. SQLI
9760: 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 2c TE_IOERR_DELETE,
9770: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
9780: 29 2e 20 0a 2a 2a 20 54 68 65 20 74 77 6f 20 73 ). .** The two s
9790: 75 62 73 65 71 75 65 6e 74 20 61 72 67 75 6d 65 ubsequent argume
97a0: 6e 74 73 20 73 68 6f 75 6c 64 20 62 65 20 74 68 nts should be th
97b0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4f 53 e name of the OS
97c0: 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 0a 2a function that.*
97d0: 2a 20 66 61 69 6c 65 64 20 28 65 2e 67 2e 20 22 * failed (e.g. "
97e0: 75 6e 6c 69 6e 6b 22 2c 20 22 6f 70 65 6e 22 29 unlink", "open")
97f0: 20 61 6e 64 20 74 68 65 20 61 73 73 6f 63 69 61 and the associa
9800: 74 65 64 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 ted file-system
9810: 70 61 74 68 2c 0a 2a 2a 20 69 66 20 61 6e 79 2e path,.** if any.
9820: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 75 6e 69 78 .*/.#define unix
9830: 4c 6f 67 45 72 72 6f 72 28 61 2c 62 2c 63 29 20 LogError(a,b,c)
9840: 20 20 20 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 unixLogError
9850: 41 74 4c 69 6e 65 28 61 2c 62 2c 63 2c 5f 5f 4c AtLine(a,b,c,__L
9860: 49 4e 45 5f 5f 29 0a 73 74 61 74 69 63 20 69 6e INE__).static in
9870: 74 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 41 74 t unixLogErrorAt
9880: 4c 69 6e 65 28 0a 20 20 69 6e 74 20 65 72 72 63 Line(. int errc
9890: 6f 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ode,
98a0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 69 74 /* SQLit
98b0: 65 20 65 72 72 6f 72 20 63 6f 64 65 20 2a 2f 0a e error code */.
98c0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
98d0: 75 6e 63 2c 20 20 20 20 20 20 20 20 20 20 20 20 unc,
98e0: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 4f 53 20 /* Name of OS
98f0: 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20 66 61 function that fa
9900: 69 6c 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 iled */. const
9910: 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 char *zPath,
9920: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c /* Fil
9930: 65 20 70 61 74 68 20 61 73 73 6f 63 69 61 74 65 e path associate
9940: 64 20 77 69 74 68 20 65 72 72 6f 72 20 2a 2f 0a d with error */.
9950: 20 20 69 6e 74 20 69 4c 69 6e 65 20 20 20 20 20 int iLine
9960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9970: 20 20 2f 2a 20 53 6f 75 72 63 65 20 6c 69 6e 65 /* Source line
9980: 20 6e 75 6d 62 65 72 20 77 68 65 72 65 20 65 72 number where er
9990: 72 6f 72 20 6f 63 63 75 72 72 65 64 20 2a 2f 0a ror occurred */.
99a0: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 3b ){. char *zErr;
99b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
99c0: 20 20 20 20 20 2f 2a 20 4d 65 73 73 61 67 65 20 /* Message
99d0: 66 72 6f 6d 20 73 74 72 65 72 72 6f 72 28 29 20 from strerror()
99e0: 6f 72 20 65 71 75 69 76 61 6c 65 6e 74 20 2a 2f or equivalent */
99f0: 0a 20 20 69 6e 74 20 69 45 72 72 6e 6f 20 3d 20 . int iErrno =
9a00: 65 72 72 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 errno;
9a10: 20 20 20 2f 2a 20 53 61 76 65 64 20 73 79 73 63 /* Saved sysc
9a20: 61 6c 6c 20 65 72 72 6f 72 20 6e 75 6d 62 65 72 all error number
9a30: 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 */.. /* If thi
9a40: 73 20 69 73 20 6e 6f 74 20 61 20 74 68 72 65 61 s is not a threa
9a50: 64 73 61 66 65 20 62 75 69 6c 64 20 28 53 51 4c dsafe build (SQL
9a60: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3d ITE_THREADSAFE==
9a70: 30 29 2c 20 74 68 65 6e 20 75 73 65 0a 20 20 2a 0), then use. *
9a80: 2a 20 74 68 65 20 73 74 72 65 72 72 6f 72 28 29 * the strerror()
9a90: 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 6f 62 74 function to obt
9aa0: 61 69 6e 20 74 68 65 20 68 75 6d 61 6e 2d 72 65 ain the human-re
9ab0: 61 64 61 62 6c 65 20 65 72 72 6f 72 20 6d 65 73 adable error mes
9ac0: 73 61 67 65 0a 20 20 2a 2a 20 65 71 75 69 76 61 sage. ** equiva
9ad0: 6c 65 6e 74 20 74 6f 20 65 72 72 6e 6f 2e 20 4f lent to errno. O
9ae0: 74 68 65 72 77 69 73 65 2c 20 75 73 65 20 73 74 therwise, use st
9af0: 72 65 72 72 6f 72 5f 72 28 29 2e 0a 20 20 2a 2f rerror_r().. */
9b00: 20 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 48 52 .#if SQLITE_THR
9b10: 45 41 44 53 41 46 45 20 26 26 20 64 65 66 69 6e EADSAFE && defin
9b20: 65 64 28 48 41 56 45 5f 53 54 52 45 52 52 4f 52 ed(HAVE_STRERROR
9b30: 5f 52 29 0a 20 20 63 68 61 72 20 61 45 72 72 5b _R). char aErr[
9b40: 38 30 5d 3b 0a 20 20 6d 65 6d 73 65 74 28 61 45 80];. memset(aE
9b50: 72 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 61 45 rr, 0, sizeof(aE
9b60: 72 72 29 29 3b 0a 20 20 7a 45 72 72 20 3d 20 61 rr));. zErr = a
9b70: 45 72 72 3b 0a 0a 20 20 2f 2a 20 49 66 20 53 54 Err;.. /* If ST
9b80: 52 45 52 52 4f 52 5f 52 5f 43 48 41 52 5f 50 20 RERROR_R_CHAR_P
9b90: 28 73 65 74 20 62 79 20 61 75 74 6f 63 6f 6e 66 (set by autoconf
9ba0: 20 73 63 72 69 70 74 73 29 20 6f 72 20 5f 5f 55 scripts) or __U
9bb0: 53 45 5f 47 4e 55 20 69 73 20 64 65 66 69 6e 65 SE_GNU is define
9bc0: 64 2c 0a 20 20 2a 2a 20 61 73 73 75 6d 65 20 74 d,. ** assume t
9bd0: 68 61 74 20 74 68 65 20 73 79 73 74 65 6d 20 70 hat the system p
9be0: 72 6f 76 69 64 65 73 20 74 68 65 20 47 4e 55 20 rovides the GNU
9bf0: 76 65 72 73 69 6f 6e 20 6f 66 20 73 74 72 65 72 version of strer
9c00: 72 6f 72 5f 72 28 29 20 74 68 61 74 0a 20 20 2a ror_r() that. *
9c10: 2a 20 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e * returns a poin
9c20: 74 65 72 20 74 6f 20 61 20 62 75 66 66 65 72 20 ter to a buffer
9c30: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 65 containing the e
9c40: 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 20 54 68 rror message. Th
9c50: 61 74 20 70 6f 69 6e 74 65 72 20 0a 20 20 2a 2a at pointer . **
9c60: 20 6d 61 79 20 70 6f 69 6e 74 20 74 6f 20 61 45 may point to aE
9c70: 72 72 5b 5d 2c 20 6f 72 20 69 74 20 6d 61 79 20 rr[], or it may
9c80: 70 6f 69 6e 74 20 74 6f 20 73 6f 6d 65 20 73 74 point to some st
9c90: 61 74 69 63 20 73 74 6f 72 61 67 65 20 73 6f 6d atic storage som
9ca0: 65 77 68 65 72 65 2e 20 0a 20 20 2a 2a 20 4f 74 ewhere. . ** Ot
9cb0: 68 65 72 77 69 73 65 2c 20 61 73 73 75 6d 65 20 herwise, assume
9cc0: 74 68 61 74 20 74 68 65 20 73 79 73 74 65 6d 20 that the system
9cd0: 70 72 6f 76 69 64 65 73 20 74 68 65 20 50 4f 53 provides the POS
9ce0: 49 58 20 76 65 72 73 69 6f 6e 20 6f 66 20 0a 20 IX version of .
9cf0: 20 2a 2a 20 73 74 72 65 72 72 6f 72 5f 72 28 29 ** strerror_r()
9d00: 2c 20 77 68 69 63 68 20 61 6c 77 61 79 73 20 77 , which always w
9d10: 72 69 74 65 73 20 61 6e 20 65 72 72 6f 72 20 6d rites an error m
9d20: 65 73 73 61 67 65 20 69 6e 74 6f 20 61 45 72 72 essage into aErr
9d30: 5b 5d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 [].. **. ** If
9d40: 20 74 68 65 20 63 6f 64 65 20 69 6e 63 6f 72 72 the code incorr
9d50: 65 63 74 6c 79 20 61 73 73 75 6d 65 73 20 74 68 ectly assumes th
9d60: 61 74 20 69 74 20 69 73 20 74 68 65 20 50 4f 53 at it is the POS
9d70: 49 58 20 76 65 72 73 69 6f 6e 20 74 68 61 74 20 IX version that
9d80: 69 73 0a 20 20 2a 2a 20 61 76 61 69 6c 61 62 6c is. ** availabl
9d90: 65 2c 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 e, the error mes
9da0: 73 61 67 65 20 77 69 6c 6c 20 6f 66 74 65 6e 20 sage will often
9db0: 62 65 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 be an empty stri
9dc0: 6e 67 2e 20 4e 6f 74 20 61 0a 20 20 2a 2a 20 68 ng. Not a. ** h
9dd0: 75 67 65 20 70 72 6f 62 6c 65 6d 2e 20 49 6e 63 uge problem. Inc
9de0: 6f 72 72 65 63 74 6c 79 20 63 6f 6e 63 6c 75 64 orrectly conclud
9df0: 69 6e 67 20 74 68 61 74 20 74 68 65 20 47 4e 55 ing that the GNU
9e00: 20 76 65 72 73 69 6f 6e 20 69 73 20 61 76 61 69 version is avai
9e10: 6c 61 62 6c 65 20 0a 20 20 2a 2a 20 63 6f 75 6c lable . ** coul
9e20: 64 20 6c 65 61 64 20 74 6f 20 61 20 73 65 67 66 d lead to a segf
9e30: 61 75 6c 74 20 74 68 6f 75 67 68 2e 0a 20 20 2a ault though.. *
9e40: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 54 /.#if defined(ST
9e50: 52 45 52 52 4f 52 5f 52 5f 43 48 41 52 5f 50 29 RERROR_R_CHAR_P)
9e60: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 55 53 || defined(__US
9e70: 45 5f 47 4e 55 29 0a 20 20 7a 45 72 72 20 3d 20 E_GNU). zErr =
9e80: 0a 23 20 65 6e 64 69 66 0a 20 20 73 74 72 65 72 .# endif. strer
9e90: 72 6f 72 5f 72 28 69 45 72 72 6e 6f 2c 20 61 45 ror_r(iErrno, aE
9ea0: 72 72 2c 20 73 69 7a 65 6f 66 28 61 45 72 72 29 rr, sizeof(aErr)
9eb0: 2d 31 29 3b 0a 0a 23 65 6c 69 66 20 53 51 4c 49 -1);..#elif SQLI
9ec0: 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a 20 20 TE_THREADSAFE.
9ed0: 2f 2a 20 54 68 69 73 20 69 73 20 61 20 74 68 72 /* This is a thr
9ee0: 65 61 64 73 61 66 65 20 62 75 69 6c 64 2c 20 62 eadsafe build, b
9ef0: 75 74 20 73 74 72 65 72 72 6f 72 5f 72 28 29 20 ut strerror_r()
9f00: 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 is not available
9f10: 2e 20 2a 2f 0a 20 20 7a 45 72 72 20 3d 20 22 22 . */. zErr = ""
9f20: 3b 0a 23 65 6c 73 65 0a 20 20 2f 2a 20 4e 6f 6e ;.#else. /* Non
9f30: 2d 74 68 72 65 61 64 73 61 66 65 20 62 75 69 6c -threadsafe buil
9f40: 64 2c 20 75 73 65 20 73 74 72 65 72 72 6f 72 28 d, use strerror(
9f50: 29 2e 20 2a 2f 0a 20 20 7a 45 72 72 20 3d 20 73 ). */. zErr = s
9f60: 74 72 65 72 72 6f 72 28 69 45 72 72 6e 6f 29 3b trerror(iErrno);
9f70: 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 7a .#endif.. if( z
9f80: 50 61 74 68 3d 3d 30 20 29 20 7a 50 61 74 68 20 Path==0 ) zPath
9f90: 3d 20 22 22 3b 0a 20 20 73 71 6c 69 74 65 33 5f = "";. sqlite3_
9fa0: 6c 6f 67 28 65 72 72 63 6f 64 65 2c 0a 20 20 20 log(errcode,.
9fb0: 20 20 20 22 6f 73 5f 75 6e 69 78 2e 63 3a 25 64 "os_unix.c:%d
9fc0: 3a 20 28 25 64 29 20 25 73 28 25 73 29 20 2d 20 : (%d) %s(%s) -
9fd0: 25 73 22 2c 0a 20 20 20 20 20 20 69 4c 69 6e 65 %s",. iLine
9fe0: 2c 20 69 45 72 72 6e 6f 2c 20 7a 46 75 6e 63 2c , iErrno, zFunc,
9ff0: 20 7a 50 61 74 68 2c 20 7a 45 72 72 0a 20 20 29 zPath, zErr. )
a000: 3b 0a 0a 20 20 72 65 74 75 72 6e 20 65 72 72 63 ;.. return errc
a010: 6f 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c ode;.}../*.** Cl
a020: 6f 73 65 20 61 20 66 69 6c 65 20 64 65 73 63 72 ose a file descr
a030: 69 70 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20 57 65 20 iptor..**.** We
a040: 61 73 73 75 6d 65 20 74 68 61 74 20 63 6c 6f 73 assume that clos
a050: 65 28 29 20 61 6c 6d 6f 73 74 20 61 6c 77 61 79 e() almost alway
a060: 73 20 77 6f 72 6b 73 2c 20 73 69 6e 63 65 20 69 s works, since i
a070: 74 20 69 73 20 6f 6e 6c 79 20 69 6e 20 61 0a 2a t is only in a.*
a080: 2a 20 76 65 72 79 20 73 69 63 6b 20 61 70 70 6c * very sick appl
a090: 69 63 61 74 69 6f 6e 20 6f 72 20 6f 6e 20 61 20 ication or on a
a0a0: 76 65 72 79 20 73 69 63 6b 20 70 6c 61 74 66 6f very sick platfo
a0b0: 72 6d 20 74 68 61 74 20 69 74 20 6d 69 67 68 74 rm that it might
a0c0: 20 66 61 69 6c 2e 0a 2a 2a 20 49 66 20 69 74 20 fail..** If it
a0d0: 64 6f 65 73 20 66 61 69 6c 2c 20 73 69 6d 70 6c does fail, simpl
a0e0: 79 20 6c 65 61 6b 20 74 68 65 20 66 69 6c 65 20 y leak the file
a0f0: 64 65 73 63 72 69 70 74 6f 72 2c 20 62 75 74 20 descriptor, but
a100: 64 6f 20 6c 6f 67 20 74 68 65 0a 2a 2a 20 65 72 do log the.** er
a110: 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 ror..**.** Note
a120: 74 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 73 that it is not s
a130: 61 66 65 20 74 6f 20 72 65 74 72 79 20 63 6c 6f afe to retry clo
a140: 73 65 28 29 20 61 66 74 65 72 20 45 49 4e 54 52 se() after EINTR
a150: 20 73 69 6e 63 65 20 74 68 65 0a 2a 2a 20 66 69 since the.** fi
a160: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6d 69 le descriptor mi
a170: 67 68 74 20 68 61 76 65 20 61 6c 72 65 61 64 79 ght have already
a180: 20 62 65 65 6e 20 72 65 75 73 65 64 20 62 79 20 been reused by
a190: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 2e 0a another thread..
a1a0: 2a 2a 20 53 6f 20 77 65 20 64 6f 6e 27 74 20 65 ** So we don't e
a1b0: 76 65 6e 20 74 72 79 20 74 6f 20 72 65 63 6f 76 ven try to recov
a1c0: 65 72 20 66 72 6f 6d 20 61 6e 20 45 49 4e 54 52 er from an EINTR
a1d0: 2e 20 20 4a 75 73 74 20 6c 6f 67 20 74 68 65 20 . Just log the
a1e0: 65 72 72 6f 72 0a 2a 2a 20 61 6e 64 20 6d 6f 76 error.** and mov
a1f0: 65 20 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 e on..*/.static
a200: 76 6f 69 64 20 72 6f 62 75 73 74 5f 63 6c 6f 73 void robust_clos
a210: 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c e(unixFile *pFil
a220: 65 2c 20 69 6e 74 20 68 2c 20 69 6e 74 20 6c 69 e, int h, int li
a230: 6e 65 6e 6f 29 7b 0a 20 20 69 66 28 20 6f 73 43 neno){. if( osC
a240: 6c 6f 73 65 28 68 29 20 29 7b 0a 20 20 20 20 75 lose(h) ){. u
a250: 6e 69 78 4c 6f 67 45 72 72 6f 72 41 74 4c 69 6e nixLogErrorAtLin
a260: 65 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 e(SQLITE_IOERR_C
a270: 4c 4f 53 45 2c 20 22 63 6c 6f 73 65 22 2c 0a 20 LOSE, "close",.
a280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a290: 20 20 20 20 20 20 70 46 69 6c 65 20 3f 20 70 46 pFile ? pF
a2a0: 69 6c 65 2d 3e 7a 50 61 74 68 20 3a 20 30 2c 20 ile->zPath : 0,
a2b0: 6c 69 6e 65 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a lineno);. }.}..
a2c0: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 70 46 /*.** Set the pF
a2d0: 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 2e 20 ile->lastErrno.
a2e0: 20 44 6f 20 74 68 69 73 20 69 6e 20 61 20 73 75 Do this in a su
a2f0: 62 72 6f 75 74 69 6e 65 20 61 73 20 74 68 61 74 broutine as that
a300: 20 70 72 6f 76 69 64 65 73 0a 2a 2a 20 61 20 63 provides.** a c
a310: 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 20 onvenient place
a320: 74 6f 20 73 65 74 20 61 20 62 72 65 61 6b 70 6f to set a breakpo
a330: 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 int..*/.static v
a340: 6f 69 64 20 73 74 6f 72 65 4c 61 73 74 45 72 72 oid storeLastErr
a350: 6e 6f 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 no(unixFile *pFi
a360: 6c 65 2c 20 69 6e 74 20 65 72 72 6f 72 29 7b 0a le, int error){.
a370: 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 pFile->lastErr
a380: 6e 6f 20 3d 20 65 72 72 6f 72 3b 0a 7d 0a 0a 2f no = error;.}../
a390: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 66 *.** Close all f
a3a0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 ile descriptors
a3b0: 61 63 63 75 6d 75 61 74 65 64 20 69 6e 20 74 68 accumuated in th
a3c0: 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 2d e unixInodeInfo-
a3d0: 3e 70 55 6e 75 73 65 64 20 6c 69 73 74 2e 0a 2a >pUnused list..*
a3e0: 2f 20 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 / .static void c
a3f0: 6c 6f 73 65 50 65 6e 64 69 6e 67 46 64 73 28 75 losePendingFds(u
a400: 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b nixFile *pFile){
a410: 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f . unixInodeInfo
a420: 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 *pInode = pFile
a430: 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55 6e 69 78 ->pInode;. Unix
a440: 55 6e 75 73 65 64 46 64 20 2a 70 3b 0a 20 20 55 UnusedFd *p;. U
a450: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 4e 65 nixUnusedFd *pNe
a460: 78 74 3b 0a 20 20 66 6f 72 28 70 3d 70 49 6e 6f xt;. for(p=pIno
a470: 64 65 2d 3e 70 55 6e 75 73 65 64 3b 20 70 3b 20 de->pUnused; p;
a480: 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e p=pNext){. pN
a490: 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a ext = p->pNext;.
a4a0: 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 robust_close
a4b0: 28 70 46 69 6c 65 2c 20 70 2d 3e 66 64 2c 20 5f (pFile, p->fd, _
a4c0: 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 73 71 _LINE__);. sq
a4d0: 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 lite3_free(p);.
a4e0: 20 7d 0a 20 20 70 49 6e 6f 64 65 2d 3e 70 55 6e }. pInode->pUn
a4f0: 75 73 65 64 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a used = 0;.}../*.
a500: 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 75 6e 69 ** Release a uni
a510: 78 49 6e 6f 64 65 49 6e 66 6f 20 73 74 72 75 63 xInodeInfo struc
a520: 74 75 72 65 20 70 72 65 76 69 6f 75 73 6c 79 20 ture previously
a530: 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 66 69 6e allocated by fin
a540: 64 49 6e 6f 64 65 49 6e 66 6f 28 29 2e 0a 2a 2a dInodeInfo()..**
a550: 0a 2a 2a 20 54 68 65 20 6d 75 74 65 78 20 65 6e .** The mutex en
a560: 74 65 72 65 64 20 75 73 69 6e 67 20 74 68 65 20 tered using the
a570: 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 unixEnterMutex()
a580: 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 20 62 function must b
a590: 65 20 68 65 6c 64 0a 2a 2a 20 77 68 65 6e 20 74 e held.** when t
a5a0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
a5b0: 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
a5c0: 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 49 6e c void releaseIn
a5d0: 6f 64 65 49 6e 66 6f 28 75 6e 69 78 46 69 6c 65 odeInfo(unixFile
a5e0: 20 2a 70 46 69 6c 65 29 7b 0a 20 20 75 6e 69 78 *pFile){. unix
a5f0: 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 InodeInfo *pInod
a600: 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 e = pFile->pInod
a610: 65 3b 0a 20 20 61 73 73 65 72 74 28 20 75 6e 69 e;. assert( uni
a620: 78 4d 75 74 65 78 48 65 6c 64 28 29 20 29 3b 0a xMutexHeld() );.
a630: 20 20 69 66 28 20 41 4c 57 41 59 53 28 70 49 6e if( ALWAYS(pIn
a640: 6f 64 65 29 20 29 7b 0a 20 20 20 20 70 49 6e 6f ode) ){. pIno
a650: 64 65 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 20 20 de->nRef--;.
a660: 69 66 28 20 70 49 6e 6f 64 65 2d 3e 6e 52 65 66 if( pInode->nRef
a670: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 61 73 73 ==0 ){. ass
a680: 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 70 53 68 ert( pInode->pSh
a690: 6d 4e 6f 64 65 3d 3d 30 20 29 3b 0a 20 20 20 20 mNode==0 );.
a6a0: 20 20 63 6c 6f 73 65 50 65 6e 64 69 6e 67 46 64 closePendingFd
a6b0: 73 28 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 s(pFile);.
a6c0: 69 66 28 20 70 49 6e 6f 64 65 2d 3e 70 50 72 65 if( pInode->pPre
a6d0: 76 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 v ){. ass
a6e0: 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 70 50 72 ert( pInode->pPr
a6f0: 65 76 2d 3e 70 4e 65 78 74 3d 3d 70 49 6e 6f 64 ev->pNext==pInod
a700: 65 20 29 3b 0a 20 20 20 20 20 20 20 20 70 49 6e e );. pIn
a710: 6f 64 65 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 ode->pPrev->pNex
a720: 74 20 3d 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 t = pInode->pNex
a730: 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a t;. }else{.
a740: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
a750: 69 6e 6f 64 65 4c 69 73 74 3d 3d 70 49 6e 6f 64 inodeList==pInod
a760: 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 6e 6f e );. ino
a770: 64 65 4c 69 73 74 20 3d 20 70 49 6e 6f 64 65 2d deList = pInode-
a780: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a >pNext;. }.
a790: 20 20 20 20 20 20 69 66 28 20 70 49 6e 6f 64 65 if( pInode
a7a0: 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 ->pNext ){.
a7b0: 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
a7c0: 65 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 3d e->pNext->pPrev=
a7d0: 3d 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 20 20 =pInode );.
a7e0: 20 20 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 pInode->pNext
a7f0: 2d 3e 70 50 72 65 76 20 3d 20 70 49 6e 6f 64 65 ->pPrev = pInode
a800: 2d 3e 70 50 72 65 76 3b 0a 20 20 20 20 20 20 7d ->pPrev;. }
a810: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 . sqlite3_f
a820: 72 65 65 28 70 49 6e 6f 64 65 29 3b 0a 20 20 20 ree(pInode);.
a830: 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 }. }.}../*.**
a840: 47 69 76 65 6e 20 61 20 66 69 6c 65 20 64 65 73 Given a file des
a850: 63 72 69 70 74 6f 72 2c 20 6c 6f 63 61 74 65 20 criptor, locate
a860: 74 68 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 the unixInodeInf
a870: 6f 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a 2a o object that.**
a880: 20 64 65 73 63 72 69 62 65 73 20 74 68 61 74 20 describes that
a890: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e file descriptor.
a8a0: 20 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 6f Create a new o
a8b0: 6e 65 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e ne if necessary.
a8c0: 20 20 54 68 65 0a 2a 2a 20 72 65 74 75 72 6e 20 The.** return
a8d0: 76 61 6c 75 65 20 6d 69 67 68 74 20 62 65 20 75 value might be u
a8e0: 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 66 20 ninitialized if
a8f0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e an error occurs.
a900: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 65 78 .**.** The mutex
a910: 20 65 6e 74 65 72 65 64 20 75 73 69 6e 67 20 74 entered using t
a920: 68 65 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 he unixEnterMute
a930: 78 28 29 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73 x() function mus
a940: 74 20 62 65 20 68 65 6c 64 0a 2a 2a 20 77 68 65 t be held.** whe
a950: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 n this function
a960: 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a is called..**.**
a970: 20 52 65 74 75 72 6e 20 61 6e 20 61 70 70 72 6f Return an appro
a980: 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 priate error cod
a990: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
a9a0: 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 0a findInodeInfo(.
a9b0: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
a9c0: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
a9d0: 20 2f 2a 20 55 6e 69 78 20 66 69 6c 65 20 77 69 /* Unix file wi
a9e0: 74 68 20 66 69 6c 65 20 64 65 73 63 20 75 73 65 th file desc use
a9f0: 64 20 69 6e 20 74 68 65 20 6b 65 79 20 2a 2f 0a d in the key */.
aa00: 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 unixInodeInfo
aa10: 2a 2a 70 70 49 6e 6f 64 65 20 20 20 20 20 20 20 **ppInode
aa20: 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 75 /* Return the u
aa30: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a nixInodeInfo obj
aa40: 65 63 74 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 ect here */.){.
aa50: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
aa60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
aa70: 2f 2a 20 53 79 73 74 65 6d 20 63 61 6c 6c 20 72 /* System call r
aa80: 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
aa90: 69 6e 74 20 66 64 3b 20 20 20 20 20 20 20 20 20 int fd;
aaa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
aab0: 2a 20 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 * The file descr
aac0: 69 70 74 6f 72 20 66 6f 72 20 70 46 69 6c 65 20 iptor for pFile
aad0: 2a 2f 0a 20 20 73 74 72 75 63 74 20 75 6e 69 78 */. struct unix
aae0: 46 69 6c 65 49 64 20 66 69 6c 65 49 64 3b 20 20 FileId fileId;
aaf0: 20 20 20 20 2f 2a 20 4c 6f 6f 6b 75 70 20 6b 65 /* Lookup ke
ab00: 79 20 66 6f 72 20 74 68 65 20 75 6e 69 78 49 6e y for the unixIn
ab10: 6f 64 65 49 6e 66 6f 20 2a 2f 0a 20 20 73 74 72 odeInfo */. str
ab20: 75 63 74 20 73 74 61 74 20 73 74 61 74 62 75 66 uct stat statbuf
ab30: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c ; /* L
ab40: 6f 77 2d 6c 65 76 65 6c 20 66 69 6c 65 20 69 6e ow-level file in
ab50: 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 formation */. u
ab60: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 nixInodeInfo *pI
ab70: 6e 6f 64 65 20 3d 20 30 3b 20 20 20 20 20 2f 2a node = 0; /*
ab80: 20 43 61 6e 64 69 64 61 74 65 20 75 6e 69 78 49 Candidate unixI
ab90: 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 20 nodeInfo object
aba0: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 75 6e */.. assert( un
abb0: 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 29 3b ixMutexHeld() );
abc0: 0a 0a 20 20 2f 2a 20 47 65 74 20 6c 6f 77 2d 6c .. /* Get low-l
abd0: 65 76 65 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e evel information
abe0: 20 61 62 6f 75 74 20 74 68 65 20 66 69 6c 65 20 about the file
abf0: 74 68 61 74 20 77 65 20 63 61 6e 20 75 73 65 64 that we can used
ac00: 20 74 6f 0a 20 20 2a 2a 20 63 72 65 61 74 65 20 to. ** create
ac10: 61 20 75 6e 69 71 75 65 20 6e 61 6d 65 20 66 6f a unique name fo
ac20: 72 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2f r the file.. */
ac30: 0a 20 20 66 64 20 3d 20 70 46 69 6c 65 2d 3e 68 . fd = pFile->h
ac40: 3b 0a 20 20 72 63 20 3d 20 6f 73 46 73 74 61 74 ;. rc = osFstat
ac50: 28 66 64 2c 20 26 73 74 61 74 62 75 66 29 3b 0a (fd, &statbuf);.
ac60: 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20 if( rc!=0 ){.
ac70: 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e storeLastErrn
ac80: 6f 28 70 46 69 6c 65 2c 20 65 72 72 6e 6f 29 3b o(pFile, errno);
ac90: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 45 4f 56 .#if defined(EOV
aca0: 45 52 46 4c 4f 57 29 20 26 26 20 64 65 66 69 6e ERFLOW) && defin
acb0: 65 64 28 53 51 4c 49 54 45 5f 44 49 53 41 42 4c ed(SQLITE_DISABL
acc0: 45 5f 4c 46 53 29 0a 20 20 20 20 69 66 28 20 70 E_LFS). if( p
acd0: 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 3d File->lastErrno=
ace0: 3d 45 4f 56 45 52 46 4c 4f 57 20 29 20 72 65 74 =EOVERFLOW ) ret
acf0: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 urn SQLITE_NOLFS
ad00: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74 ;.#endif. ret
ad10: 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
ad20: 3b 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20 5f 5f ;. }..#ifdef __
ad30: 41 50 50 4c 45 5f 5f 0a 20 20 2f 2a 20 4f 6e 20 APPLE__. /* On
ad40: 4f 53 20 58 20 6f 6e 20 61 6e 20 6d 73 64 6f 73 OS X on an msdos
ad50: 20 66 69 6c 65 73 79 73 74 65 6d 2c 20 74 68 65 filesystem, the
ad60: 20 69 6e 6f 64 65 20 6e 75 6d 62 65 72 20 69 73 inode number is
ad70: 20 72 65 70 6f 72 74 65 64 0a 20 20 2a 2a 20 69 reported. ** i
ad80: 6e 63 6f 72 72 65 63 74 6c 79 20 66 6f 72 20 7a ncorrectly for z
ad90: 65 72 6f 2d 73 69 7a 65 20 66 69 6c 65 73 2e 20 ero-size files.
ada0: 20 53 65 65 20 74 69 63 6b 65 74 20 23 33 32 36 See ticket #326
adb0: 30 2e 20 20 54 6f 20 77 6f 72 6b 0a 20 20 2a 2a 0. To work. **
adc0: 20 61 72 6f 75 6e 64 20 74 68 69 73 20 70 72 6f around this pro
add0: 62 6c 65 6d 20 28 77 65 20 63 6f 6e 73 69 64 65 blem (we conside
ade0: 72 20 69 74 20 61 20 62 75 67 20 69 6e 20 4f 53 r it a bug in OS
adf0: 20 58 2c 20 6e 6f 74 20 53 51 4c 69 74 65 29 0a X, not SQLite).
ae00: 20 20 2a 2a 20 77 65 20 61 6c 77 61 79 73 20 69 ** we always i
ae10: 6e 63 72 65 61 73 65 20 74 68 65 20 66 69 6c 65 ncrease the file
ae20: 20 73 69 7a 65 20 74 6f 20 31 20 62 79 20 77 72 size to 1 by wr
ae30: 69 74 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 62 iting a single b
ae40: 79 74 65 0a 20 20 2a 2a 20 70 72 69 6f 72 20 74 yte. ** prior t
ae50: 6f 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 o accessing the
ae60: 69 6e 6f 64 65 20 6e 75 6d 62 65 72 2e 20 20 54 inode number. T
ae70: 68 65 20 6f 6e 65 20 62 79 74 65 20 77 72 69 74 he one byte writ
ae80: 74 65 6e 20 69 73 0a 20 20 2a 2a 20 61 6e 20 41 ten is. ** an A
ae90: 53 43 49 49 20 27 53 27 20 63 68 61 72 61 63 74 SCII 'S' charact
aea0: 65 72 20 77 68 69 63 68 20 61 6c 73 6f 20 68 61 er which also ha
aeb0: 70 70 65 6e 73 20 74 6f 20 62 65 20 74 68 65 20 ppens to be the
aec0: 66 69 72 73 74 20 62 79 74 65 0a 20 20 2a 2a 20 first byte. **
aed0: 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 6f 66 in the header of
aee0: 20 65 76 65 72 79 20 53 51 4c 69 74 65 20 64 61 every SQLite da
aef0: 74 61 62 61 73 65 2e 20 20 49 6e 20 74 68 69 73 tabase. In this
af00: 20 77 61 79 2c 20 69 66 20 74 68 65 72 65 0a 20 way, if there.
af10: 20 2a 2a 20 69 73 20 61 20 72 61 63 65 20 63 6f ** is a race co
af20: 6e 64 69 74 69 6f 6e 20 73 75 63 68 20 74 68 61 ndition such tha
af30: 74 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 t another thread
af40: 20 68 61 73 20 61 6c 72 65 61 64 79 20 70 6f 70 has already pop
af50: 75 6c 61 74 65 64 0a 20 20 2a 2a 20 74 68 65 20 ulated. ** the
af60: 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 first page of th
af70: 65 20 64 61 74 61 62 61 73 65 2c 20 6e 6f 20 64 e database, no d
af80: 61 6d 61 67 65 20 69 73 20 64 6f 6e 65 2e 0a 20 amage is done..
af90: 20 2a 2f 0a 20 20 69 66 28 20 73 74 61 74 62 75 */. if( statbu
afa0: 66 2e 73 74 5f 73 69 7a 65 3d 3d 30 20 26 26 20 f.st_size==0 &&
afb0: 28 70 46 69 6c 65 2d 3e 66 73 46 6c 61 67 73 20 (pFile->fsFlags
afc0: 26 20 53 51 4c 49 54 45 5f 46 53 46 4c 41 47 53 & SQLITE_FSFLAGS
afd0: 5f 49 53 5f 4d 53 44 4f 53 29 21 3d 30 20 29 7b _IS_MSDOS)!=0 ){
afe0: 0a 20 20 20 20 64 6f 7b 20 72 63 20 3d 20 6f 73 . do{ rc = os
aff0: 57 72 69 74 65 28 66 64 2c 20 22 53 22 2c 20 31 Write(fd, "S", 1
b000: 29 3b 20 7d 77 68 69 6c 65 28 20 72 63 3c 30 20 ); }while( rc<0
b010: 26 26 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 && errno==EINTR
b020: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 31 );. if( rc!=1
b030: 20 29 7b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c ){. storeL
b040: 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 astErrno(pFile,
b050: 65 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 72 65 errno);. re
b060: 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 turn SQLITE_IOER
b070: 52 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 R;. }. rc
b080: 3d 20 6f 73 46 73 74 61 74 28 66 64 2c 20 26 73 = osFstat(fd, &s
b090: 74 61 74 62 75 66 29 3b 0a 20 20 20 20 69 66 28 tatbuf);. if(
b0a0: 20 72 63 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 rc!=0 ){.
b0b0: 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 storeLastErrno(p
b0c0: 46 69 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 File, errno);.
b0d0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
b0e0: 45 5f 49 4f 45 52 52 3b 0a 20 20 20 20 7d 0a 20 E_IOERR;. }.
b0f0: 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 6d 65 6d }.#endif.. mem
b100: 73 65 74 28 26 66 69 6c 65 49 64 2c 20 30 2c 20 set(&fileId, 0,
b110: 73 69 7a 65 6f 66 28 66 69 6c 65 49 64 29 29 3b sizeof(fileId));
b120: 0a 20 20 66 69 6c 65 49 64 2e 64 65 76 20 3d 20 . fileId.dev =
b130: 73 74 61 74 62 75 66 2e 73 74 5f 64 65 76 3b 0a statbuf.st_dev;.
b140: 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 #if OS_VXWORKS.
b150: 20 66 69 6c 65 49 64 2e 70 49 64 20 3d 20 70 46 fileId.pId = pF
b160: 69 6c 65 2d 3e 70 49 64 3b 0a 23 65 6c 73 65 0a ile->pId;.#else.
b170: 20 20 66 69 6c 65 49 64 2e 69 6e 6f 20 3d 20 73 fileId.ino = s
b180: 74 61 74 62 75 66 2e 73 74 5f 69 6e 6f 3b 0a 23 tatbuf.st_ino;.#
b190: 65 6e 64 69 66 0a 20 20 70 49 6e 6f 64 65 20 3d endif. pInode =
b1a0: 20 69 6e 6f 64 65 4c 69 73 74 3b 0a 20 20 77 68 inodeList;. wh
b1b0: 69 6c 65 28 20 70 49 6e 6f 64 65 20 26 26 20 6d ile( pInode && m
b1c0: 65 6d 63 6d 70 28 26 66 69 6c 65 49 64 2c 20 26 emcmp(&fileId, &
b1d0: 70 49 6e 6f 64 65 2d 3e 66 69 6c 65 49 64 2c 20 pInode->fileId,
b1e0: 73 69 7a 65 6f 66 28 66 69 6c 65 49 64 29 29 20 sizeof(fileId))
b1f0: 29 7b 0a 20 20 20 20 70 49 6e 6f 64 65 20 3d 20 ){. pInode =
b200: 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b 0a 20 pInode->pNext;.
b210: 20 7d 0a 20 20 69 66 28 20 70 49 6e 6f 64 65 3d }. if( pInode=
b220: 3d 30 20 29 7b 0a 20 20 20 20 70 49 6e 6f 64 65 =0 ){. pInode
b230: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f = sqlite3_mallo
b240: 63 36 34 28 20 73 69 7a 65 6f 66 28 2a 70 49 6e c64( sizeof(*pIn
b250: 6f 64 65 29 20 29 3b 0a 20 20 20 20 69 66 28 20 ode) );. if(
b260: 70 49 6e 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 pInode==0 ){.
b270: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
b280: 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
b290: 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 49 }. memset(pI
b2a0: 6e 6f 64 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 node, 0, sizeof(
b2b0: 2a 70 49 6e 6f 64 65 29 29 3b 0a 20 20 20 20 6d *pInode));. m
b2c0: 65 6d 63 70 79 28 26 70 49 6e 6f 64 65 2d 3e 66 emcpy(&pInode->f
b2d0: 69 6c 65 49 64 2c 20 26 66 69 6c 65 49 64 2c 20 ileId, &fileId,
b2e0: 73 69 7a 65 6f 66 28 66 69 6c 65 49 64 29 29 3b sizeof(fileId));
b2f0: 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 52 65 . pInode->nRe
b300: 66 20 3d 20 31 3b 0a 20 20 20 20 70 49 6e 6f 64 f = 1;. pInod
b310: 65 2d 3e 70 4e 65 78 74 20 3d 20 69 6e 6f 64 65 e->pNext = inode
b320: 4c 69 73 74 3b 0a 20 20 20 20 70 49 6e 6f 64 65 List;. pInode
b330: 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 ->pPrev = 0;.
b340: 20 69 66 28 20 69 6e 6f 64 65 4c 69 73 74 20 29 if( inodeList )
b350: 20 69 6e 6f 64 65 4c 69 73 74 2d 3e 70 50 72 65 inodeList->pPre
b360: 76 20 3d 20 70 49 6e 6f 64 65 3b 0a 20 20 20 20 v = pInode;.
b370: 69 6e 6f 64 65 4c 69 73 74 20 3d 20 70 49 6e 6f inodeList = pIno
b380: 64 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 de;. }else{.
b390: 20 70 49 6e 6f 64 65 2d 3e 6e 52 65 66 2b 2b 3b pInode->nRef++;
b3a0: 0a 20 20 7d 0a 20 20 2a 70 70 49 6e 6f 64 65 20 . }. *ppInode
b3b0: 3d 20 70 49 6e 6f 64 65 3b 0a 20 20 72 65 74 75 = pInode;. retu
b3c0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
b3d0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 ./*.** Return TR
b3e0: 55 45 20 69 66 20 70 46 69 6c 65 20 68 61 73 20 UE if pFile has
b3f0: 62 65 65 6e 20 72 65 6e 61 6d 65 64 20 6f 72 20 been renamed or
b400: 75 6e 6c 69 6e 6b 65 64 20 73 69 6e 63 65 20 69 unlinked since i
b410: 74 20 77 61 73 20 66 69 72 73 74 20 6f 70 65 6e t was first open
b420: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
b430: 74 20 66 69 6c 65 48 61 73 4d 6f 76 65 64 28 75 t fileHasMoved(u
b440: 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b nixFile *pFile){
b450: 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a .#if OS_VXWORKS.
b460: 20 20 72 65 74 75 72 6e 20 70 46 69 6c 65 2d 3e return pFile->
b470: 70 49 6e 6f 64 65 21 3d 30 20 26 26 20 70 46 69 pInode!=0 && pFi
b480: 6c 65 2d 3e 70 49 64 21 3d 70 46 69 6c 65 2d 3e le->pId!=pFile->
b490: 70 49 6e 6f 64 65 2d 3e 66 69 6c 65 49 64 2e 70 pInode->fileId.p
b4a0: 49 64 3b 0a 23 65 6c 73 65 0a 20 20 73 74 72 75 Id;.#else. stru
b4b0: 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 20 72 ct stat buf;. r
b4c0: 65 74 75 72 6e 20 70 46 69 6c 65 2d 3e 70 49 6e eturn pFile->pIn
b4d0: 6f 64 65 21 3d 30 20 26 26 0a 20 20 20 20 20 20 ode!=0 &&.
b4e0: 28 6f 73 53 74 61 74 28 70 46 69 6c 65 2d 3e 7a (osStat(pFile->z
b4f0: 50 61 74 68 2c 20 26 62 75 66 29 21 3d 30 20 7c Path, &buf)!=0 |
b500: 7c 20 62 75 66 2e 73 74 5f 69 6e 6f 21 3d 70 46 | buf.st_ino!=pF
b510: 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 66 69 6c ile->pInode->fil
b520: 65 49 64 2e 69 6e 6f 29 3b 0a 23 65 6e 64 69 66 eId.ino);.#endif
b530: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b .}.../*.** Check
b540: 20 61 20 75 6e 69 78 46 69 6c 65 20 74 68 61 74 a unixFile that
b550: 20 69 73 20 61 20 64 61 74 61 62 61 73 65 2e 20 is a database.
b560: 20 56 65 72 69 66 79 20 74 68 65 20 66 6f 6c 6c Verify the foll
b570: 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 28 31 29 owing:.**.** (1)
b580: 20 54 68 65 72 65 20 69 73 20 65 78 61 63 74 6c There is exactl
b590: 79 20 6f 6e 65 20 68 61 72 64 20 6c 69 6e 6b 20 y one hard link
b5a0: 6f 6e 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20 28 on the file.** (
b5b0: 32 29 20 54 68 65 20 66 69 6c 65 20 69 73 20 6e 2) The file is n
b5c0: 6f 74 20 61 20 73 79 6d 62 6f 6c 69 63 20 6c 69 ot a symbolic li
b5d0: 6e 6b 0a 2a 2a 20 28 33 29 20 54 68 65 20 66 69 nk.** (3) The fi
b5e0: 6c 65 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 le has not been
b5f0: 72 65 6e 61 6d 65 64 20 6f 72 20 75 6e 6c 69 6e renamed or unlin
b600: 6b 65 64 0a 2a 2a 0a 2a 2a 20 49 73 73 75 65 20 ked.**.** Issue
b610: 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 sqlite3_log(SQLI
b620: 54 45 5f 57 41 52 4e 49 4e 47 2c 2e 2e 2e 29 20 TE_WARNING,...)
b630: 6d 65 73 73 61 67 65 73 20 69 66 20 61 6e 79 74 messages if anyt
b640: 68 69 6e 67 20 69 73 20 6e 6f 74 20 72 69 67 68 hing is not righ
b650: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 t..*/.static voi
b660: 64 20 76 65 72 69 66 79 44 62 46 69 6c 65 28 75 d verifyDbFile(u
b670: 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b nixFile *pFile){
b680: 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 20 62 . struct stat b
b690: 75 66 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 uf;. int rc;..
b6a0: 20 2f 2a 20 54 68 65 73 65 20 76 65 72 69 66 69 /* These verifi
b6b0: 63 61 74 69 6f 6e 73 20 6f 63 63 75 72 73 20 66 cations occurs f
b6c0: 6f 72 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 or the main data
b6d0: 62 61 73 65 20 6f 6e 6c 79 20 2a 2f 0a 20 20 69 base only */. i
b6e0: 66 28 20 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c f( pFile->ctrlFl
b6f0: 61 67 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 4e ags & UNIXFILE_N
b700: 4f 4c 4f 43 4b 20 29 20 72 65 74 75 72 6e 3b 0a OLOCK ) return;.
b710: 0a 20 20 72 63 20 3d 20 6f 73 46 73 74 61 74 28 . rc = osFstat(
b720: 70 46 69 6c 65 2d 3e 68 2c 20 26 62 75 66 29 3b pFile->h, &buf);
b730: 0a 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a . if( rc!=0 ){.
b740: 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 sqlite3_log(
b750: 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 2c 20 SQLITE_WARNING,
b760: 22 63 61 6e 6e 6f 74 20 66 73 74 61 74 20 64 62 "cannot fstat db
b770: 20 66 69 6c 65 20 25 73 22 2c 20 70 46 69 6c 65 file %s", pFile
b780: 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 20 20 72 65 ->zPath);. re
b790: 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20 turn;. }. if(
b7a0: 62 75 66 2e 73 74 5f 6e 6c 69 6e 6b 3d 3d 30 20 buf.st_nlink==0
b7b0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c ){. sqlite3_l
b7c0: 6f 67 28 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e og(SQLITE_WARNIN
b7d0: 47 2c 20 22 66 69 6c 65 20 75 6e 6c 69 6e 6b 65 G, "file unlinke
b7e0: 64 20 77 68 69 6c 65 20 6f 70 65 6e 3a 20 25 73 d while open: %s
b7f0: 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61 74 68 29 ", pFile->zPath)
b800: 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 ;. return;.
b810: 7d 0a 20 20 69 66 28 20 62 75 66 2e 73 74 5f 6e }. if( buf.st_n
b820: 6c 69 6e 6b 3e 31 20 29 7b 0a 20 20 20 20 73 71 link>1 ){. sq
b830: 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 lite3_log(SQLITE
b840: 5f 57 41 52 4e 49 4e 47 2c 20 22 6d 75 6c 74 69 _WARNING, "multi
b850: 70 6c 65 20 6c 69 6e 6b 73 20 74 6f 20 66 69 6c ple links to fil
b860: 65 3a 20 25 73 22 2c 20 70 46 69 6c 65 2d 3e 7a e: %s", pFile->z
b870: 50 61 74 68 29 3b 0a 20 20 20 20 72 65 74 75 72 Path);. retur
b880: 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 69 6c n;. }. if( fil
b890: 65 48 61 73 4d 6f 76 65 64 28 70 46 69 6c 65 29 eHasMoved(pFile)
b8a0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ){. sqlite3_
b8b0: 6c 6f 67 28 53 51 4c 49 54 45 5f 57 41 52 4e 49 log(SQLITE_WARNI
b8c0: 4e 47 2c 20 22 66 69 6c 65 20 72 65 6e 61 6d 65 NG, "file rename
b8d0: 64 20 77 68 69 6c 65 20 6f 70 65 6e 3a 20 25 73 d while open: %s
b8e0: 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61 74 68 29 ", pFile->zPath)
b8f0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 ;. return;.
b900: 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 }.}.../*.** This
b910: 20 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 routine checks
b920: 69 66 20 74 68 65 72 65 20 69 73 20 61 20 52 45 if there is a RE
b930: 53 45 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 SERVED lock held
b940: 20 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 on the specifie
b950: 64 0a 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 d.** file by thi
b960: 73 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 s or any other p
b970: 72 6f 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 rocess. If such
b980: 61 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 a lock is held,
b990: 73 65 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 set *pResOut.**
b9a0: 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 to a non-zero va
b9b0: 6c 75 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 lue otherwise *p
b9c0: 52 65 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f ResOut is set to
b9d0: 20 7a 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 zero. The retu
b9e0: 72 6e 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 rn value.** is s
b9f0: 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 et to SQLITE_OK
ba00: 75 6e 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 unless an I/O er
ba10: 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e ror occurs durin
ba20: 67 20 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e g lock checking.
ba30: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
ba40: 6e 69 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 nixCheckReserved
ba50: 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c Lock(sqlite3_fil
ba60: 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 e *id, int *pRes
ba70: 4f 75 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d Out){. int rc =
ba80: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e SQLITE_OK;. in
ba90: 74 20 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a t reserved = 0;.
baa0: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
bab0: 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
bac0: 64 3b 0a 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f d;.. SimulateIO
bad0: 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 53 51 Error( return SQ
bae0: 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b LITE_IOERR_CHECK
baf0: 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 29 3b RESERVEDLOCK; );
bb00: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c .. assert( pFil
bb10: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 e );. assert( p
bb20: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3c File->eFileLock<
bb30: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a =SHARED_LOCK );.
bb40: 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 unixEnterMutex
bb50: 28 29 3b 20 2f 2a 20 42 65 63 61 75 73 65 20 70 (); /* Because p
bb60: 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 20 69 73 20 File->pInode is
bb70: 73 68 61 72 65 64 20 61 63 72 6f 73 73 20 74 68 shared across th
bb80: 72 65 61 64 73 20 2a 2f 0a 0a 20 20 2f 2a 20 43 reads */.. /* C
bb90: 68 65 63 6b 20 69 66 20 61 20 74 68 72 65 61 64 heck if a thread
bba0: 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65 73 73 in this process
bbb0: 20 68 6f 6c 64 73 20 73 75 63 68 20 61 20 6c 6f holds such a lo
bbc0: 63 6b 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c ck */. if( pFil
bbd0: 65 2d 3e 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 e->pInode->eFile
bbe0: 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b Lock>SHARED_LOCK
bbf0: 20 29 7b 0a 20 20 20 20 72 65 73 65 72 76 65 64 ){. reserved
bc00: 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 = 1;. }.. /*
bc10: 4f 74 68 65 72 77 69 73 65 20 73 65 65 20 69 66 Otherwise see if
bc20: 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 some other proc
bc30: 65 73 73 20 68 6f 6c 64 73 20 69 74 2e 0a 20 20 ess holds it..
bc40: 2a 2f 0a 23 69 66 6e 64 65 66 20 5f 5f 44 4a 47 */.#ifndef __DJG
bc50: 50 50 5f 5f 0a 20 20 69 66 28 20 21 72 65 73 65 PP__. if( !rese
bc60: 72 76 65 64 20 26 26 20 21 70 46 69 6c 65 2d 3e rved && !pFile->
bc70: 70 49 6e 6f 64 65 2d 3e 62 50 72 6f 63 65 73 73 pInode->bProcess
bc80: 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 73 74 72 75 Lock ){. stru
bc90: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 ct flock lock;.
bca0: 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 lock.l_whence
bcb0: 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 = SEEK_SET;.
bcc0: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 lock.l_start =
bcd0: 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a 20 RESERVED_BYTE;.
bce0: 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 lock.l_len =
bcf0: 31 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 1;. lock.l_ty
bd00: 70 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 pe = F_WRLCK;.
bd10: 20 20 69 66 28 20 6f 73 46 63 6e 74 6c 28 70 46 if( osFcntl(pF
bd20: 69 6c 65 2d 3e 68 2c 20 46 5f 47 45 54 4c 4b 2c ile->h, F_GETLK,
bd30: 20 26 6c 6f 63 6b 29 20 29 7b 0a 20 20 20 20 20 &lock) ){.
bd40: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 rc = SQLITE_IOE
bd50: 52 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 RR_CHECKRESERVED
bd60: 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 73 74 6f 72 LOCK;. stor
bd70: 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 eLastErrno(pFile
bd80: 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 7d 20 , errno);. }
bd90: 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b 2e 6c 5f else if( lock.l_
bda0: 74 79 70 65 21 3d 46 5f 55 4e 4c 43 4b 20 29 7b type!=F_UNLCK ){
bdb0: 0a 20 20 20 20 20 20 72 65 73 65 72 76 65 64 20 . reserved
bdc0: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 = 1;. }. }.#
bdd0: 65 6e 64 69 66 0a 20 20 0a 20 20 75 6e 69 78 4c endif. . unixL
bde0: 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 4f eaveMutex();. O
bdf0: 53 54 52 41 43 45 28 28 22 54 45 53 54 20 57 52 STRACE(("TEST WR
be00: 2d 4c 4f 43 4b 20 25 64 20 25 64 20 25 64 20 28 -LOCK %d %d %d (
be10: 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 6c 65 2d unix)\n", pFile-
be20: 3e 68 2c 20 72 63 2c 20 72 65 73 65 72 76 65 64 >h, rc, reserved
be30: 29 29 3b 0a 0a 20 20 2a 70 52 65 73 4f 75 74 20 ));.. *pResOut
be40: 3d 20 72 65 73 65 72 76 65 64 3b 0a 20 20 72 65 = reserved;. re
be50: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
be60: 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73 65 74 * Attempt to set
be70: 20 61 20 73 79 73 74 65 6d 2d 6c 6f 63 6b 20 6f a system-lock o
be80: 6e 20 74 68 65 20 66 69 6c 65 20 70 46 69 6c 65 n the file pFile
be90: 2e 20 20 54 68 65 20 6c 6f 63 6b 20 69 73 20 0a . The lock is .
bea0: 2a 2a 20 64 65 73 63 72 69 62 65 64 20 62 79 20 ** described by
beb0: 70 4c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 pLock..**.** If
bec0: 74 68 65 20 70 46 69 6c 65 20 77 61 73 20 6f 70 the pFile was op
bed0: 65 6e 65 64 20 72 65 61 64 2f 77 72 69 74 65 20 ened read/write
bee0: 66 72 6f 6d 20 75 6e 69 78 2d 65 78 63 6c 2c 20 from unix-excl,
bef0: 74 68 65 6e 20 74 68 65 20 6f 6e 6c 79 20 6c 6f then the only lo
bf00: 63 6b 0a 2a 2a 20 65 76 65 72 20 6f 62 74 61 69 ck.** ever obtai
bf10: 6e 65 64 20 69 73 20 61 6e 20 65 78 63 6c 75 73 ned is an exclus
bf20: 69 76 65 20 6c 6f 63 6b 2c 20 61 6e 64 20 69 74 ive lock, and it
bf30: 20 69 73 20 6f 62 74 61 69 6e 65 64 20 65 78 61 is obtained exa
bf40: 63 74 6c 79 20 6f 6e 63 65 0a 2a 2a 20 74 68 65 ctly once.** the
bf50: 20 66 69 72 73 74 20 74 69 6d 65 20 61 6e 79 20 first time any
bf60: 6c 6f 63 6b 20 69 73 20 61 74 74 65 6d 70 74 65 lock is attempte
bf70: 64 2e 20 20 41 6c 6c 20 73 75 62 73 65 71 75 65 d. All subseque
bf80: 6e 74 20 73 79 73 74 65 6d 20 6c 6f 63 6b 69 6e nt system lockin
bf90: 67 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 73 20 g.** operations
bfa0: 62 65 63 6f 6d 65 20 6e 6f 2d 6f 70 73 2e 20 20 become no-ops.
bfb0: 4c 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69 6f Locking operatio
bfc0: 6e 73 20 73 74 69 6c 6c 20 68 61 70 70 65 6e 20 ns still happen
bfd0: 69 6e 74 65 72 6e 61 6c 6c 79 2c 0a 2a 2a 20 69 internally,.** i
bfe0: 6e 20 6f 72 64 65 72 20 74 6f 20 63 6f 6f 72 64 n order to coord
bff0: 69 6e 61 74 65 20 61 63 63 65 73 73 20 62 65 74 inate access bet
c000: 77 65 65 6e 20 73 65 70 61 72 61 74 65 20 64 61 ween separate da
c010: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
c020: 6e 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 69 ns.** within thi
c030: 73 20 70 72 6f 63 65 73 73 2c 20 62 75 74 20 61 s process, but a
c040: 6c 6c 20 6f 66 20 74 68 61 74 20 69 73 20 68 61 ll of that is ha
c050: 6e 64 6c 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 ndled in memory
c060: 61 6e 64 20 74 68 65 0a 2a 2a 20 6f 70 65 72 61 and the.** opera
c070: 74 69 6e 67 20 73 79 73 74 65 6d 20 64 6f 65 73 ting system does
c080: 20 6e 6f 74 20 70 61 72 74 69 63 69 70 61 74 65 not participate
c090: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
c0a0: 63 74 69 6f 6e 20 69 73 20 61 20 70 61 73 73 2d ction is a pass-
c0b0: 74 68 72 6f 75 67 68 20 74 6f 20 66 63 6e 74 6c through to fcntl
c0c0: 28 46 5f 53 45 54 4c 4b 29 20 69 66 20 70 46 69 (F_SETLK) if pFi
c0d0: 6c 65 20 69 73 20 75 73 69 6e 67 0a 2a 2a 20 61 le is using.** a
c0e0: 6e 79 20 56 46 53 20 6f 74 68 65 72 20 74 68 61 ny VFS other tha
c0f0: 6e 20 22 75 6e 69 78 2d 65 78 63 6c 22 20 6f 72 n "unix-excl" or
c100: 20 69 66 20 70 46 69 6c 65 20 69 73 20 6f 70 65 if pFile is ope
c110: 6e 65 64 20 6f 6e 20 22 75 6e 69 78 2d 65 78 63 ned on "unix-exc
c120: 6c 22 0a 2a 2a 20 61 6e 64 20 69 73 20 72 65 61 l".** and is rea
c130: 64 2d 6f 6e 6c 79 2e 0a 2a 2a 0a 2a 2a 20 5a 65 d-only..**.** Ze
c140: 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 ro is returned i
c150: 66 20 74 68 65 20 63 61 6c 6c 20 63 6f 6d 70 6c f the call compl
c160: 65 74 65 73 20 73 75 63 63 65 73 73 66 75 6c 6c etes successfull
c170: 79 2c 20 6f 72 20 2d 31 20 69 66 20 61 20 63 61 y, or -1 if a ca
c180: 6c 6c 0a 2a 2a 20 74 6f 20 66 63 6e 74 6c 28 29 ll.** to fcntl()
c190: 20 66 61 69 6c 73 2e 20 49 6e 20 74 68 69 73 20 fails. In this
c1a0: 63 61 73 65 2c 20 65 72 72 6e 6f 20 69 73 20 73 case, errno is s
c1b0: 65 74 20 61 70 70 72 6f 70 72 69 61 74 65 6c 79 et appropriately
c1c0: 20 28 62 79 20 66 63 6e 74 6c 28 29 29 2e 0a 2a (by fcntl())..*
c1d0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 /.static int uni
c1e0: 78 46 69 6c 65 4c 6f 63 6b 28 75 6e 69 78 46 69 xFileLock(unixFi
c1f0: 6c 65 20 2a 70 46 69 6c 65 2c 20 73 74 72 75 63 le *pFile, struc
c200: 74 20 66 6c 6f 63 6b 20 2a 70 4c 6f 63 6b 29 7b t flock *pLock){
c210: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 6e 69 . int rc;. uni
c220: 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f xInodeInfo *pIno
c230: 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f de = pFile->pIno
c240: 64 65 3b 0a 20 20 61 73 73 65 72 74 28 20 75 6e de;. assert( un
c250: 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 29 3b ixMutexHeld() );
c260: 0a 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 . assert( pInod
c270: 65 21 3d 30 20 29 3b 0a 20 20 69 66 28 20 28 70 e!=0 );. if( (p
c280: 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 73 20 File->ctrlFlags
c290: 26 20 28 55 4e 49 58 46 49 4c 45 5f 45 58 43 4c & (UNIXFILE_EXCL
c2a0: 7c 55 4e 49 58 46 49 4c 45 5f 52 44 4f 4e 4c 59 |UNIXFILE_RDONLY
c2b0: 29 29 3d 3d 55 4e 49 58 46 49 4c 45 5f 45 58 43 ))==UNIXFILE_EXC
c2c0: 4c 20 29 7b 0a 20 20 20 20 69 66 28 20 70 49 6e L ){. if( pIn
c2d0: 6f 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 ode->bProcessLoc
c2e0: 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 74 k==0 ){. st
c2f0: 72 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b ruct flock lock;
c300: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
c310: 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 Inode->nLock==0
c320: 29 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f );. lock.l_
c330: 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 whence = SEEK_SE
c340: 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f T;. lock.l_
c350: 73 74 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 start = SHARED_F
c360: 49 52 53 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b IRST;. lock
c370: 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f .l_len = SHARED_
c380: 53 49 5a 45 3b 0a 20 20 20 20 20 20 6c 6f 63 6b SIZE;. lock
c390: 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 57 52 4c 43 .l_type = F_WRLC
c3a0: 4b 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 6f 73 K;. rc = os
c3b0: 46 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 Fcntl(pFile->h,
c3c0: 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b F_SETLK, &lock);
c3d0: 0a 20 20 20 20 20 20 69 66 28 20 72 63 3c 30 20 . if( rc<0
c3e0: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
c3f0: 20 20 20 70 49 6e 6f 64 65 2d 3e 62 50 72 6f 63 pInode->bProc
c400: 65 73 73 4c 6f 63 6b 20 3d 20 31 3b 0a 20 20 20 essLock = 1;.
c410: 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b pInode->nLock
c420: 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ++;. }else{.
c430: 20 20 20 20 20 72 63 20 3d 20 30 3b 0a 20 20 20 rc = 0;.
c440: 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }. }else{.
c450: 72 63 20 3d 20 6f 73 46 63 6e 74 6c 28 70 46 69 rc = osFcntl(pFi
c460: 6c 65 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 le->h, F_SETLK,
c470: 70 4c 6f 63 6b 29 3b 0a 20 20 7d 0a 20 20 72 65 pLock);. }. re
c480: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
c490: 2a 20 4c 6f 63 6b 20 74 68 65 20 66 69 6c 65 20 * Lock the file
c4a0: 77 69 74 68 20 74 68 65 20 6c 6f 63 6b 20 73 70 with the lock sp
c4b0: 65 63 69 66 69 65 64 20 62 79 20 70 61 72 61 6d ecified by param
c4c0: 65 74 65 72 20 65 46 69 6c 65 4c 6f 63 6b 20 2d eter eFileLock -
c4d0: 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 one.** of the f
c4e0: 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 ollowing:.**.**
c4f0: 20 20 20 20 28 31 29 20 53 48 41 52 45 44 5f 4c (1) SHARED_L
c500: 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 32 29 20 52 OCK.** (2) R
c510: 45 53 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 ESERVED_LOCK.**
c520: 20 20 20 20 28 33 29 20 50 45 4e 44 49 4e 47 5f (3) PENDING_
c530: 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 34 29 20 LOCK.** (4)
c540: 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a 2a EXCLUSIVE_LOCK.*
c550: 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 *.** Sometimes w
c560: 68 65 6e 20 72 65 71 75 65 73 74 69 6e 67 20 6f hen requesting o
c570: 6e 65 20 6c 6f 63 6b 20 73 74 61 74 65 2c 20 61 ne lock state, a
c580: 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 73 dditional lock s
c590: 74 61 74 65 73 0a 2a 2a 20 61 72 65 20 69 6e 73 tates.** are ins
c5a0: 65 72 74 65 64 20 69 6e 20 62 65 74 77 65 65 6e erted in between
c5b0: 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 6d . The locking m
c5c0: 69 67 68 74 20 66 61 69 6c 20 6f 6e 20 6f 6e 65 ight fail on one
c5d0: 20 6f 66 20 74 68 65 20 6c 61 74 65 72 0a 2a 2a of the later.**
c5e0: 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 6c 65 61 transitions lea
c5f0: 76 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20 73 74 ving the lock st
c600: 61 74 65 20 64 69 66 66 65 72 65 6e 74 20 66 72 ate different fr
c610: 6f 6d 20 77 68 61 74 20 69 74 20 73 74 61 72 74 om what it start
c620: 65 64 20 62 75 74 0a 2a 2a 20 73 74 69 6c 6c 20 ed but.** still
c630: 73 68 6f 72 74 20 6f 66 20 69 74 73 20 67 6f 61 short of its goa
c640: 6c 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e l. The followin
c650: 67 20 63 68 61 72 74 20 73 68 6f 77 73 20 74 68 g chart shows th
c660: 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 61 e allowed.** tra
c670: 6e 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 nsitions and the
c680: 20 69 6e 73 65 72 74 65 64 20 69 6e 74 65 72 6d inserted interm
c690: 65 64 69 61 74 65 20 73 74 61 74 65 73 3a 0a 2a ediate states:.*
c6a0: 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 44 *.** UNLOCKED
c6b0: 20 2d 3e 20 53 48 41 52 45 44 0a 2a 2a 20 20 20 -> SHARED.**
c6c0: 20 53 48 41 52 45 44 20 2d 3e 20 52 45 53 45 52 SHARED -> RESER
c6d0: 56 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 VED.** SHARED
c6e0: 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e -> (PENDING) ->
c6f0: 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 EXCLUSIVE.**
c700: 20 52 45 53 45 52 56 45 44 20 2d 3e 20 28 50 45 RESERVED -> (PE
c710: 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 NDING) -> EXCLUS
c720: 49 56 45 0a 2a 2a 20 20 20 20 50 45 4e 44 49 4e IVE.** PENDIN
c730: 47 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a G -> EXCLUSIVE.*
c740: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
c750: 65 20 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 e will only incr
c760: 65 61 73 65 20 61 20 6c 6f 63 6b 2e 20 20 55 73 ease a lock. Us
c770: 65 20 74 68 65 20 73 71 6c 69 74 65 33 4f 73 55 e the sqlite3OsU
c780: 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 nlock().** routi
c790: 6e 65 20 74 6f 20 6c 6f 77 65 72 20 61 20 6c 6f ne to lower a lo
c7a0: 63 6b 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a 2f 0a cking level..*/.
c7b0: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 4c static int unixL
c7c0: 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 ock(sqlite3_file
c7d0: 20 2a 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c *id, int eFileL
c7e0: 6f 63 6b 29 7b 0a 20 20 2f 2a 20 54 68 65 20 66 ock){. /* The f
c7f0: 6f 6c 6c 6f 77 69 6e 67 20 64 65 73 63 72 69 62 ollowing describ
c800: 65 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 es the implement
c810: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 61 72 ation of the var
c820: 69 6f 75 73 20 6c 6f 63 6b 73 20 61 6e 64 0a 20 ious locks and.
c830: 20 2a 2a 20 6c 6f 63 6b 20 74 72 61 6e 73 69 74 ** lock transit
c840: 69 6f 6e 73 20 69 6e 20 74 65 72 6d 73 20 6f 66 ions in terms of
c850: 20 74 68 65 20 50 4f 53 49 58 20 61 64 76 69 73 the POSIX advis
c860: 6f 72 79 20 73 68 61 72 65 64 20 61 6e 64 20 65 ory shared and e
c870: 78 63 6c 75 73 69 76 65 0a 20 20 2a 2a 20 6c 6f xclusive. ** lo
c880: 63 6b 20 70 72 69 6d 69 74 69 76 65 73 20 28 63 ck primitives (c
c890: 61 6c 6c 65 64 20 72 65 61 64 2d 6c 6f 63 6b 73 alled read-locks
c8a0: 20 61 6e 64 20 77 72 69 74 65 2d 6c 6f 63 6b 73 and write-locks
c8b0: 20 62 65 6c 6f 77 2c 20 74 6f 20 61 76 6f 69 64 below, to avoid
c8c0: 0a 20 20 2a 2a 20 63 6f 6e 66 75 73 69 6f 6e 20 . ** confusion
c8d0: 77 69 74 68 20 53 51 4c 69 74 65 20 6c 6f 63 6b with SQLite lock
c8e0: 20 6e 61 6d 65 73 29 2e 20 54 68 65 20 61 6c 67 names). The alg
c8f0: 6f 72 69 74 68 6d 73 20 61 72 65 20 63 6f 6d 70 orithms are comp
c900: 6c 69 63 61 74 65 64 0a 20 20 2a 2a 20 73 6c 69 licated. ** sli
c910: 67 68 74 6c 79 20 69 6e 20 6f 72 64 65 72 20 74 ghtly in order t
c920: 6f 20 62 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 o be compatible
c930: 77 69 74 68 20 57 69 6e 64 6f 77 73 39 35 20 73 with Windows95 s
c940: 79 73 74 65 6d 73 20 73 69 6d 75 6c 74 61 6e 65 ystems simultane
c950: 6f 75 73 6c 79 0a 20 20 2a 2a 20 61 63 63 65 73 ously. ** acces
c960: 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 64 61 sing the same da
c970: 74 61 62 61 73 65 20 66 69 6c 65 2c 20 69 6e 20 tabase file, in
c980: 63 61 73 65 20 74 68 61 74 20 69 73 20 65 76 65 case that is eve
c990: 72 20 72 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a r required.. **
c9a0: 0a 20 20 2a 2a 20 53 79 6d 62 6f 6c 73 20 64 65 . ** Symbols de
c9b0: 66 69 6e 65 64 20 69 6e 20 6f 73 2e 68 20 69 6e fined in os.h in
c9c0: 64 65 6e 74 69 66 79 20 74 68 65 20 27 70 65 6e dentify the 'pen
c9d0: 64 69 6e 67 20 62 79 74 65 27 20 61 6e 64 20 74 ding byte' and t
c9e0: 68 65 20 27 72 65 73 65 72 76 65 64 0a 20 20 2a he 'reserved. *
c9f0: 2a 20 62 79 74 65 27 2c 20 65 61 63 68 20 73 69 * byte', each si
ca00: 6e 67 6c 65 20 62 79 74 65 73 20 61 74 20 77 65 ngle bytes at we
ca10: 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66 73 65 74 73 ll known offsets
ca20: 2c 20 61 6e 64 20 74 68 65 20 27 73 68 61 72 65 , and the 'share
ca30: 64 20 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e 67 d byte. ** rang
ca40: 65 27 2c 20 61 20 72 61 6e 67 65 20 6f 66 20 35 e', a range of 5
ca50: 31 30 20 62 79 74 65 73 20 61 74 20 61 20 77 65 10 bytes at a we
ca60: 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66 73 65 74 2e ll known offset.
ca70: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 6f 20 6f 62 . **. ** To ob
ca80: 74 61 69 6e 20 61 20 53 48 41 52 45 44 20 6c 6f tain a SHARED lo
ca90: 63 6b 2c 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 ck, a read-lock
caa0: 69 73 20 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 is obtained on t
cab0: 68 65 20 27 70 65 6e 64 69 6e 67 0a 20 20 2a 2a he 'pending. **
cac0: 20 62 79 74 65 27 2e 20 20 49 66 20 74 68 69 73 byte'. If this
cad0: 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 2c 20 is successful,
cae0: 27 73 68 61 72 65 64 20 62 79 74 65 20 72 61 6e 'shared byte ran
caf0: 67 65 27 20 69 73 20 72 65 61 64 2d 6c 6f 63 6b ge' is read-lock
cb00: 65 64 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 ed. ** and the
cb10: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 27 70 65 6e lock on the 'pen
cb20: 64 69 6e 67 20 62 79 74 65 27 20 72 65 6c 65 61 ding byte' relea
cb30: 73 65 64 2e 20 20 28 4c 65 67 61 63 79 20 6e 6f sed. (Legacy no
cb40: 74 65 3a 20 20 57 68 65 6e 0a 20 20 2a 2a 20 53 te: When. ** S
cb50: 51 4c 69 74 65 20 77 61 73 20 66 69 72 73 74 20 QLite was first
cb60: 64 65 76 65 6c 6f 70 65 64 2c 20 57 69 6e 64 6f developed, Windo
cb70: 77 73 39 35 20 73 79 73 74 65 6d 73 20 77 65 72 ws95 systems wer
cb80: 65 20 73 74 69 6c 6c 20 76 65 72 79 20 63 6f 6d e still very com
cb90: 6d 6f 6e 2c 0a 20 20 2a 2a 20 61 6e 64 20 57 69 mon,. ** and Wi
cba0: 64 6e 6f 77 73 39 35 20 6c 61 63 6b 73 20 61 20 dnows95 lacks a
cbb0: 73 68 61 72 65 64 2d 6c 6f 63 6b 20 63 61 70 61 shared-lock capa
cbc0: 62 69 6c 69 74 79 2e 20 20 53 6f 20 6f 6e 20 57 bility. So on W
cbd0: 69 6e 64 6f 77 73 39 35 2c 20 61 0a 20 20 2a 2a indows95, a. **
cbe0: 20 73 69 6e 67 6c 65 20 72 61 6e 64 6f 6d 6c 79 single randomly
cbf0: 20 73 65 6c 65 63 74 65 64 20 62 79 20 66 72 6f selected by fro
cc00: 6d 20 74 68 65 20 27 73 68 61 72 65 64 20 62 79 m the 'shared by
cc10: 74 65 20 72 61 6e 67 65 27 20 69 73 20 6c 6f 63 te range' is loc
cc20: 6b 65 64 2e 0a 20 20 2a 2a 20 57 69 6e 64 6f 77 ked.. ** Window
cc30: 73 39 35 20 69 73 20 6e 6f 77 20 70 72 65 74 74 s95 is now prett
cc40: 79 20 6d 75 63 68 20 65 78 74 69 6e 63 74 2c 20 y much extinct,
cc50: 62 75 74 20 74 68 69 73 20 77 6f 72 6b 2d 61 72 but this work-ar
cc60: 6f 75 6e 64 20 66 6f 72 20 74 68 65 0a 20 20 2a ound for the. *
cc70: 2a 20 6c 61 63 6b 20 6f 66 20 73 68 61 72 65 64 * lack of shared
cc80: 2d 6c 6f 63 6b 73 20 6f 6e 20 57 69 6e 64 6f 77 -locks on Window
cc90: 73 39 35 20 6c 69 76 65 73 20 6f 6e 2c 20 66 6f s95 lives on, fo
cca0: 72 20 62 61 63 6b 77 61 72 64 73 0a 20 20 2a 2a r backwards. **
ccb0: 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2e 29 compatibility.)
ccc0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 70 72 6f . **. ** A pro
ccd0: 63 65 73 73 20 6d 61 79 20 6f 6e 6c 79 20 6f 62 cess may only ob
cce0: 74 61 69 6e 20 61 20 52 45 53 45 52 56 45 44 20 tain a RESERVED
ccf0: 6c 6f 63 6b 20 61 66 74 65 72 20 69 74 20 68 61 lock after it ha
cd00: 73 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2e s a SHARED lock.
cd10: 0a 20 20 2a 2a 20 41 20 52 45 53 45 52 56 45 44 . ** A RESERVED
cd20: 20 6c 6f 63 6b 20 69 73 20 69 6d 70 6c 65 6d 65 lock is impleme
cd30: 6e 74 65 64 20 62 79 20 67 72 61 62 62 69 6e 67 nted by grabbing
cd40: 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e a write-lock on
cd50: 20 74 68 65 0a 20 20 2a 2a 20 27 72 65 73 65 72 the. ** 'reser
cd60: 76 65 64 20 62 79 74 65 27 2e 20 0a 20 20 2a 2a ved byte'. . **
cd70: 0a 20 20 2a 2a 20 41 20 70 72 6f 63 65 73 73 20 . ** A process
cd80: 6d 61 79 20 6f 6e 6c 79 20 6f 62 74 61 69 6e 20 may only obtain
cd90: 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 61 a PENDING lock a
cda0: 66 74 65 72 20 69 74 20 68 61 73 20 6f 62 74 61 fter it has obta
cdb0: 69 6e 65 64 20 61 0a 20 20 2a 2a 20 53 48 41 52 ined a. ** SHAR
cdc0: 45 44 20 6c 6f 63 6b 2e 20 41 20 50 45 4e 44 49 ED lock. A PENDI
cdd0: 4e 47 20 6c 6f 63 6b 20 69 73 20 69 6d 70 6c 65 NG lock is imple
cde0: 6d 65 6e 74 65 64 20 62 79 20 6f 62 74 61 69 6e mented by obtain
cdf0: 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b ing a write-lock
ce00: 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 27 70 65 . ** on the 'pe
ce10: 6e 64 69 6e 67 20 62 79 74 65 27 2e 20 54 68 69 nding byte'. Thi
ce20: 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 20 6e s ensures that n
ce30: 6f 20 6e 65 77 20 53 48 41 52 45 44 20 6c 6f 63 o new SHARED loc
ce40: 6b 73 20 63 61 6e 20 62 65 0a 20 20 2a 2a 20 6f ks can be. ** o
ce50: 62 74 61 69 6e 65 64 2c 20 62 75 74 20 65 78 69 btained, but exi
ce60: 73 74 69 6e 67 20 53 48 41 52 45 44 20 6c 6f 63 sting SHARED loc
ce70: 6b 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 74 ks are allowed t
ce80: 6f 20 70 65 72 73 69 73 74 2e 20 41 20 70 72 6f o persist. A pro
ce90: 63 65 73 73 0a 20 20 2a 2a 20 64 6f 65 73 20 6e cess. ** does n
cea0: 6f 74 20 68 61 76 65 20 74 6f 20 6f 62 74 61 69 ot have to obtai
ceb0: 6e 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 n a RESERVED loc
cec0: 6b 20 6f 6e 20 74 68 65 20 77 61 79 20 74 6f 20 k on the way to
ced0: 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 2e 0a a PENDING lock..
cee0: 20 20 2a 2a 20 54 68 69 73 20 70 72 6f 70 65 72 ** This proper
cef0: 74 79 20 69 73 20 75 73 65 64 20 62 79 20 74 68 ty is used by th
cf00: 65 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 e algorithm for
cf10: 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 6a rolling back a j
cf20: 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 20 20 2a 2a ournal file. **
cf30: 20 61 66 74 65 72 20 61 20 63 72 61 73 68 2e 0a after a crash..
cf40: 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e 20 45 58 43 **. ** An EXC
cf50: 4c 55 53 49 56 45 20 6c 6f 63 6b 2c 20 6f 62 74 LUSIVE lock, obt
cf60: 61 69 6e 65 64 20 61 66 74 65 72 20 61 20 50 45 ained after a PE
cf70: 4e 44 49 4e 47 20 6c 6f 63 6b 20 69 73 20 68 65 NDING lock is he
cf80: 6c 64 2c 20 69 73 0a 20 20 2a 2a 20 69 6d 70 6c ld, is. ** impl
cf90: 65 6d 65 6e 74 65 64 20 62 79 20 6f 62 74 61 69 emented by obtai
cfa0: 6e 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 ning a write-loc
cfb0: 6b 20 6f 6e 20 74 68 65 20 65 6e 74 69 72 65 20 k on the entire
cfc0: 27 73 68 61 72 65 64 20 62 79 74 65 0a 20 20 2a 'shared byte. *
cfd0: 2a 20 72 61 6e 67 65 27 2e 20 53 69 6e 63 65 20 * range'. Since
cfe0: 61 6c 6c 20 6f 74 68 65 72 20 6c 6f 63 6b 73 20 all other locks
cff0: 72 65 71 75 69 72 65 20 61 20 72 65 61 64 2d 6c require a read-l
d000: 6f 63 6b 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 ock on one of th
d010: 65 20 62 79 74 65 73 0a 20 20 2a 2a 20 77 69 74 e bytes. ** wit
d020: 68 69 6e 20 74 68 69 73 20 72 61 6e 67 65 2c 20 hin this range,
d030: 74 68 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 this ensures tha
d040: 74 20 6e 6f 20 6f 74 68 65 72 20 6c 6f 63 6b 73 t no other locks
d050: 20 61 72 65 20 68 65 6c 64 20 6f 6e 20 74 68 65 are held on the
d060: 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 . ** database.
d070: 0a 20 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d . */. int rc =
d080: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e SQLITE_OK;. un
d090: 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 ixFile *pFile =
d0a0: 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 (unixFile*)id;.
d0b0: 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a unixInodeInfo *
d0c0: 70 49 6e 6f 64 65 3b 0a 20 20 73 74 72 75 63 74 pInode;. struct
d0d0: 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69 flock lock;. i
d0e0: 6e 74 20 74 45 72 72 6e 6f 20 3d 20 30 3b 0a 0a nt tErrno = 0;..
d0f0: 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 assert( pFile
d100: 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c );. OSTRACE(("L
d110: 4f 43 4b 20 20 20 20 25 64 20 25 73 20 77 61 73 OCK %d %s was
d120: 20 25 73 28 25 73 2c 25 64 29 20 70 69 64 3d 25 %s(%s,%d) pid=%
d130: 64 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 d (unix)\n", pFi
d140: 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20 61 7a 46 le->h,. azF
d150: 69 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 ileLock(eFileLoc
d160: 6b 29 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 70 k), azFileLock(p
d170: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29 File->eFileLock)
d180: 2c 0a 20 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f ,. azFileLo
d190: 63 6b 28 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 ck(pFile->pInode
d1a0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 70 46 ->eFileLock), pF
d1b0: 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 53 68 ile->pInode->nSh
d1c0: 61 72 65 64 2c 0a 20 20 20 20 20 20 6f 73 47 65 ared,. osGe
d1d0: 74 70 69 64 28 30 29 29 29 3b 0a 0a 20 20 2f 2a tpid(0)));.. /*
d1e0: 20 49 66 20 74 68 65 72 65 20 69 73 20 61 6c 72 If there is alr
d1f0: 65 61 64 79 20 61 20 6c 6f 63 6b 20 6f 66 20 74 eady a lock of t
d200: 68 69 73 20 74 79 70 65 20 6f 72 20 6d 6f 72 65 his type or more
d210: 20 72 65 73 74 72 69 63 74 69 76 65 20 6f 6e 20 restrictive on
d220: 74 68 65 0a 20 20 2a 2a 20 75 6e 69 78 46 69 6c the. ** unixFil
d230: 65 2c 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 20 44 e, do nothing. D
d240: 6f 6e 27 74 20 75 73 65 20 74 68 65 20 65 6e 64 on't use the end
d250: 5f 6c 6f 63 6b 3a 20 65 78 69 74 20 70 61 74 68 _lock: exit path
d260: 2c 20 61 73 0a 20 20 2a 2a 20 75 6e 69 78 45 6e , as. ** unixEn
d270: 74 65 72 4d 75 74 65 78 28 29 20 68 61 73 6e 27 terMutex() hasn'
d280: 74 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 79 65 t been called ye
d290: 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 t.. */. if( pF
d2a0: 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d ile->eFileLock>=
d2b0: 65 46 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 eFileLock ){.
d2c0: 20 4f 53 54 52 41 43 45 28 28 22 4c 4f 43 4b 20 OSTRACE(("LOCK
d2d0: 20 20 20 25 64 20 25 73 20 6f 6b 20 28 61 6c 72 %d %s ok (alr
d2e0: 65 61 64 79 20 68 65 6c 64 29 20 28 75 6e 69 78 eady held) (unix
d2f0: 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a )\n", pFile->h,.
d300: 20 20 20 20 20 20 20 20 20 20 20 20 61 7a 46 69 azFi
d310: 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b leLock(eFileLock
d320: 29 29 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 )));. return
d330: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a SQLITE_OK;. }..
d340: 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 /* Make sure t
d350: 68 65 20 6c 6f 63 6b 69 6e 67 20 73 65 71 75 65 he locking seque
d360: 6e 63 65 20 69 73 20 63 6f 72 72 65 63 74 2e 0a nce is correct..
d370: 20 20 2a 2a 20 20 28 31 29 20 57 65 20 6e 65 76 ** (1) We nev
d380: 65 72 20 6d 6f 76 65 20 66 72 6f 6d 20 75 6e 6c er move from unl
d390: 6f 63 6b 65 64 20 74 6f 20 61 6e 79 74 68 69 6e ocked to anythin
d3a0: 67 20 68 69 67 68 65 72 20 74 68 61 6e 20 73 68 g higher than sh
d3b0: 61 72 65 64 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 ared lock.. **
d3c0: 20 28 32 29 20 53 51 4c 69 74 65 20 6e 65 76 65 (2) SQLite neve
d3d0: 72 20 65 78 70 6c 69 63 69 74 6c 79 20 72 65 71 r explicitly req
d3e0: 75 65 73 74 73 20 61 20 70 65 6e 64 69 67 20 6c uests a pendig l
d3f0: 6f 63 6b 2e 0a 20 20 2a 2a 20 20 28 33 29 20 41 ock.. ** (3) A
d400: 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 69 73 20 shared lock is
d410: 61 6c 77 61 79 73 20 68 65 6c 64 20 77 68 65 6e always held when
d420: 20 61 20 72 65 73 65 72 76 65 20 6c 6f 63 6b 20 a reserve lock
d430: 69 73 20 72 65 71 75 65 73 74 65 64 2e 0a 20 20 is requested..
d440: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 */. assert( pFi
d450: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 21 3d 4e le->eFileLock!=N
d460: 4f 5f 4c 4f 43 4b 20 7c 7c 20 65 46 69 6c 65 4c O_LOCK || eFileL
d470: 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock==SHARED_LOCK
d480: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 46 );. assert( eF
d490: 69 6c 65 4c 6f 63 6b 21 3d 50 45 4e 44 49 4e 47 ileLock!=PENDING
d4a0: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 _LOCK );. asser
d4b0: 74 28 20 65 46 69 6c 65 4c 6f 63 6b 21 3d 52 45 t( eFileLock!=RE
d4c0: 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70 SERVED_LOCK || p
d4d0: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d File->eFileLock=
d4e0: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a =SHARED_LOCK );.
d4f0: 0a 20 20 2f 2a 20 54 68 69 73 20 6d 75 74 65 78 . /* This mutex
d500: 20 69 73 20 6e 65 65 64 65 64 20 62 65 63 61 75 is needed becau
d510: 73 65 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 se pFile->pInode
d520: 20 69 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 is shared acros
d530: 73 20 74 68 72 65 61 64 73 0a 20 20 2a 2f 0a 20 s threads. */.
d540: 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 unixEnterMutex(
d550: 29 3b 0a 20 20 70 49 6e 6f 64 65 20 3d 20 70 46 );. pInode = pF
d560: 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 0a 20 20 ile->pInode;..
d570: 2f 2a 20 49 66 20 73 6f 6d 65 20 74 68 72 65 61 /* If some threa
d580: 64 20 75 73 69 6e 67 20 74 68 69 73 20 50 49 44 d using this PID
d590: 20 68 61 73 20 61 20 6c 6f 63 6b 20 76 69 61 20 has a lock via
d5a0: 61 20 64 69 66 66 65 72 65 6e 74 20 75 6e 69 78 a different unix
d5b0: 46 69 6c 65 2a 0a 20 20 2a 2a 20 68 61 6e 64 6c File*. ** handl
d5c0: 65 20 74 68 61 74 20 70 72 65 63 6c 75 64 65 73 e that precludes
d5d0: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c the requested l
d5e0: 6f 63 6b 2c 20 72 65 74 75 72 6e 20 42 55 53 59 ock, return BUSY
d5f0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 70 46 .. */. if( (pF
d600: 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 21 3d ile->eFileLock!=
d610: 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 pInode->eFileLoc
d620: 6b 20 26 26 20 0a 20 20 20 20 20 20 20 20 20 20 k && .
d630: 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f (pInode->eFileLo
d640: 63 6b 3e 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b ck>=PENDING_LOCK
d650: 20 7c 7c 20 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 || eFileLock>SH
d660: 41 52 45 44 5f 4c 4f 43 4b 29 29 0a 20 20 29 7b ARED_LOCK)). ){
d670: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
d680: 5f 42 55 53 59 3b 0a 20 20 20 20 67 6f 74 6f 20 _BUSY;. goto
d690: 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 end_lock;. }..
d6a0: 20 2f 2a 20 49 66 20 61 20 53 48 41 52 45 44 20 /* If a SHARED
d6b0: 6c 6f 63 6b 20 69 73 20 72 65 71 75 65 73 74 65 lock is requeste
d6c0: 64 2c 20 61 6e 64 20 73 6f 6d 65 20 74 68 72 65 d, and some thre
d6d0: 61 64 20 75 73 69 6e 67 20 74 68 69 73 20 50 49 ad using this PI
d6e0: 44 20 61 6c 72 65 61 64 79 0a 20 20 2a 2a 20 68 D already. ** h
d6f0: 61 73 20 61 20 53 48 41 52 45 44 20 6f 72 20 52 as a SHARED or R
d700: 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 74 68 ESERVED lock, th
d710: 65 6e 20 69 6e 63 72 65 6d 65 6e 74 20 72 65 66 en increment ref
d720: 65 72 65 6e 63 65 20 63 6f 75 6e 74 73 20 61 6e erence counts an
d730: 64 0a 20 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 d. ** return SQ
d740: 4c 49 54 45 5f 4f 4b 2e 0a 20 20 2a 2f 0a 20 20 LITE_OK.. */.
d750: 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 if( eFileLock==S
d760: 48 41 52 45 44 5f 4c 4f 43 4b 20 26 26 20 0a 20 HARED_LOCK && .
d770: 20 20 20 20 20 28 70 49 6e 6f 64 65 2d 3e 65 46 (pInode->eF
d780: 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f ileLock==SHARED_
d790: 4c 4f 43 4b 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e LOCK || pInode->
d7a0: 65 46 69 6c 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 eFileLock==RESER
d7b0: 56 45 44 5f 4c 4f 43 4b 29 20 29 7b 0a 20 20 20 VED_LOCK) ){.
d7c0: 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f assert( eFileLo
d7d0: 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 ck==SHARED_LOCK
d7e0: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
d7f0: 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d File->eFileLock=
d800: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 =0 );. assert
d810: 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 ( pInode->nShare
d820: 64 3e 30 20 29 3b 0a 20 20 20 20 70 46 69 6c 65 d>0 );. pFile
d830: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 53 48 ->eFileLock = SH
d840: 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 ARED_LOCK;. p
d850: 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 2b 2b Inode->nShared++
d860: 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c ;. pInode->nL
d870: 6f 63 6b 2b 2b 3b 0a 20 20 20 20 67 6f 74 6f 20 ock++;. goto
d880: 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 0a 0a end_lock;. }...
d890: 20 20 2f 2a 20 41 20 50 45 4e 44 49 4e 47 20 6c /* A PENDING l
d8a0: 6f 63 6b 20 69 73 20 6e 65 65 64 65 64 20 62 65 ock is needed be
d8b0: 66 6f 72 65 20 61 63 71 75 69 72 69 6e 67 20 61 fore acquiring a
d8c0: 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 61 6e 64 SHARED lock and
d8d0: 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 63 71 before. ** acq
d8e0: 75 69 72 69 6e 67 20 61 6e 20 45 58 43 4c 55 53 uiring an EXCLUS
d8f0: 49 56 45 20 6c 6f 63 6b 2e 20 20 46 6f 72 20 74 IVE lock. For t
d900: 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20 he SHARED lock,
d910: 74 68 65 20 50 45 4e 44 49 4e 47 20 77 69 6c 6c the PENDING will
d920: 0a 20 20 2a 2a 20 62 65 20 72 65 6c 65 61 73 65 . ** be release
d930: 64 2e 0a 20 20 2a 2f 0a 20 20 6c 6f 63 6b 2e 6c d.. */. lock.l
d940: 5f 6c 65 6e 20 3d 20 31 4c 3b 0a 20 20 6c 6f 63 _len = 1L;. loc
d950: 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 k.l_whence = SEE
d960: 4b 5f 53 45 54 3b 0a 20 20 69 66 28 20 65 46 69 K_SET;. if( eFi
d970: 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c leLock==SHARED_L
d980: 4f 43 4b 20 0a 20 20 20 20 20 20 7c 7c 20 28 65 OCK . || (e
d990: 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 FileLock==EXCLUS
d9a0: 49 56 45 5f 4c 4f 43 4b 20 26 26 20 70 46 69 6c IVE_LOCK && pFil
d9b0: 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3c 50 45 4e e->eFileLock<PEN
d9c0: 44 49 4e 47 5f 4c 4f 43 4b 29 0a 20 20 29 7b 0a DING_LOCK). ){.
d9d0: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 lock.l_type
d9e0: 3d 20 28 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 = (eFileLock==SH
d9f0: 41 52 45 44 5f 4c 4f 43 4b 3f 46 5f 52 44 4c 43 ARED_LOCK?F_RDLC
da00: 4b 3a 46 5f 57 52 4c 43 4b 29 3b 0a 20 20 20 20 K:F_WRLCK);.
da10: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50 lock.l_start = P
da20: 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20 ENDING_BYTE;.
da30: 20 69 66 28 20 75 6e 69 78 46 69 6c 65 4c 6f 63 if( unixFileLoc
da40: 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b 29 20 k(pFile, &lock)
da50: 29 7b 0a 20 20 20 20 20 20 74 45 72 72 6e 6f 20 ){. tErrno
da60: 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 = errno;. r
da70: 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 c = sqliteErrorF
da80: 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 romPosixError(tE
da90: 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 rrno, SQLITE_IOE
daa0: 52 52 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 RR_LOCK);.
dab0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 if( rc!=SQLITE_B
dac0: 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 73 USY ){. s
dad0: 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 toreLastErrno(pF
dae0: 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20 ile, tErrno);.
daf0: 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f }. goto
db00: 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d end_lock;. }
db10: 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 49 66 20 63 . }... /* If c
db20: 6f 6e 74 72 6f 6c 20 67 65 74 73 20 74 6f 20 74 ontrol gets to t
db30: 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 his point, then
db40: 61 63 74 75 61 6c 6c 79 20 67 6f 20 61 68 65 61 actually go ahea
db50: 64 20 61 6e 64 20 6d 61 6b 65 0a 20 20 2a 2a 20 d and make. **
db60: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d operating system
db70: 20 63 61 6c 6c 73 20 66 6f 72 20 74 68 65 20 73 calls for the s
db80: 70 65 63 69 66 69 65 64 20 6c 6f 63 6b 2e 0a 20 pecified lock..
db90: 20 2a 2f 0a 20 20 69 66 28 20 65 46 69 6c 65 4c */. if( eFileL
dba0: 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock==SHARED_LOCK
dbb0: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
dbc0: 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3d pInode->nShared=
dbd0: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 =0 );. assert
dbe0: 28 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c ( pInode->eFileL
dbf0: 6f 63 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 ock==0 );. as
dc00: 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
dc10: 5f 4f 4b 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4e _OK );.. /* N
dc20: 6f 77 20 67 65 74 20 74 68 65 20 72 65 61 64 2d ow get the read-
dc30: 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b lock */. lock
dc40: 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 45 .l_start = SHARE
dc50: 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 6c 6f 63 D_FIRST;. loc
dc60: 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 k.l_len = SHARED
dc70: 5f 53 49 5a 45 3b 0a 20 20 20 20 69 66 28 20 75 _SIZE;. if( u
dc80: 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c nixFileLock(pFil
dc90: 65 2c 20 26 6c 6f 63 6b 29 20 29 7b 0a 20 20 20 e, &lock) ){.
dca0: 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e tErrno = errn
dcb0: 6f 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 o;. rc = sq
dcc0: 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 liteErrorFromPos
dcd0: 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 ixError(tErrno,
dce0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 SQLITE_IOERR_LOC
dcf0: 4b 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f K);. }.. /
dd00: 2a 20 44 72 6f 70 20 74 68 65 20 74 65 6d 70 6f * Drop the tempo
dd10: 72 61 72 79 20 50 45 4e 44 49 4e 47 20 6c 6f 63 rary PENDING loc
dd20: 6b 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f k */. lock.l_
dd30: 73 74 61 72 74 20 3d 20 50 45 4e 44 49 4e 47 5f start = PENDING_
dd40: 42 59 54 45 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c BYTE;. lock.l
dd50: 5f 6c 65 6e 20 3d 20 31 4c 3b 0a 20 20 20 20 6c _len = 1L;. l
dd60: 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 ock.l_type = F_U
dd70: 4e 4c 43 4b 3b 0a 20 20 20 20 69 66 28 20 75 6e NLCK;. if( un
dd80: 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 ixFileLock(pFile
dd90: 2c 20 26 6c 6f 63 6b 29 20 26 26 20 72 63 3d 3d , &lock) && rc==
dda0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
ddb0: 20 20 20 2f 2a 20 54 68 69 73 20 63 6f 75 6c 64 /* This could
ddc0: 20 68 61 70 70 65 6e 20 77 69 74 68 20 61 20 6e happen with a n
ddd0: 65 74 77 6f 72 6b 20 6d 6f 75 6e 74 20 2a 2f 0a etwork mount */.
dde0: 20 20 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 tErrno = e
ddf0: 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 63 20 3d rrno;. rc =
de00: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e SQLITE_IOERR_UN
de10: 4c 4f 43 4b 3b 20 0a 20 20 20 20 7d 0a 0a 20 20 LOCK; . }..
de20: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
de30: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
de40: 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 _BUSY ){.
de50: 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 storeLastErrno(
de60: 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a pFile, tErrno);.
de70: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f }. go
de80: 74 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 to end_lock;.
de90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 46 }else{. pF
dea0: 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d ile->eFileLock =
deb0: 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 SHARED_LOCK;.
dec0: 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 pInode->nLoc
ded0: 6b 2b 2b 3b 0a 20 20 20 20 20 20 70 49 6e 6f 64 k++;. pInod
dee0: 65 2d 3e 6e 53 68 61 72 65 64 20 3d 20 31 3b 0a e->nShared = 1;.
def0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 }. }else if
df00: 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 ( eFileLock==EXC
df10: 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 70 LUSIVE_LOCK && p
df20: 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e 31 Inode->nShared>1
df30: 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65 20 61 72 ){. /* We ar
df40: 65 20 74 72 79 69 6e 67 20 66 6f 72 20 61 6e 20 e trying for an
df50: 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 62 exclusive lock b
df60: 75 74 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61 ut another threa
df70: 64 20 69 6e 20 74 68 69 73 0a 20 20 20 20 2a 2a d in this. **
df80: 20 73 61 6d 65 20 70 72 6f 63 65 73 73 20 69 73 same process is
df90: 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 20 61 still holding a
dfa0: 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20 2a 2f shared lock. */
dfb0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
dfc0: 5f 42 55 53 59 3b 0a 20 20 7d 65 6c 73 65 7b 0a _BUSY;. }else{.
dfd0: 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65 /* The reque
dfe0: 73 74 20 77 61 73 20 66 6f 72 20 61 20 52 45 53 st was for a RES
dff0: 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55 53 49 ERVED or EXCLUSI
e000: 56 45 20 6c 6f 63 6b 2e 20 20 49 74 20 69 73 0a VE lock. It is.
e010: 20 20 20 20 2a 2a 20 61 73 73 75 6d 65 64 20 74 ** assumed t
e020: 68 61 74 20 74 68 65 72 65 20 69 73 20 61 20 53 hat there is a S
e030: 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 65 72 HARED or greater
e040: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c lock on the fil
e050: 65 0a 20 20 20 20 2a 2a 20 61 6c 72 65 61 64 79 e. ** already
e060: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 .. */. ass
e070: 65 72 74 28 20 30 21 3d 70 46 69 6c 65 2d 3e 65 ert( 0!=pFile->e
e080: 46 69 6c 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 FileLock );.
e090: 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f lock.l_type = F_
e0a0: 57 52 4c 43 4b 3b 0a 0a 20 20 20 20 61 73 73 65 WRLCK;.. asse
e0b0: 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 52 rt( eFileLock==R
e0c0: 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c 20 ESERVED_LOCK ||
e0d0: 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 eFileLock==EXCLU
e0e0: 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 SIVE_LOCK );.
e0f0: 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d if( eFileLock==
e100: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 7b RESERVED_LOCK ){
e110: 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 . lock.l_st
e120: 61 72 74 20 3d 20 52 45 53 45 52 56 45 44 5f 42 art = RESERVED_B
e130: 59 54 45 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e YTE;. lock.
e140: 6c 5f 6c 65 6e 20 3d 20 31 4c 3b 0a 20 20 20 20 l_len = 1L;.
e150: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6c 6f 63 }else{. loc
e160: 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 k.l_start = SHAR
e170: 45 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 20 20 ED_FIRST;.
e180: 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 lock.l_len = SHA
e190: 52 45 44 5f 53 49 5a 45 3b 0a 20 20 20 20 7d 0a RED_SIZE;. }.
e1a0: 0a 20 20 20 20 69 66 28 20 75 6e 69 78 46 69 6c . if( unixFil
e1b0: 65 4c 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f eLock(pFile, &lo
e1c0: 63 6b 29 20 29 7b 0a 20 20 20 20 20 20 74 45 72 ck) ){. tEr
e1d0: 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 rno = errno;.
e1e0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45 72 rc = sqliteEr
e1f0: 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f rorFromPosixErro
e200: 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 r(tErrno, SQLITE
e210: 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 0a 20 20 _IOERR_LOCK);.
e220: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
e230: 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 TE_BUSY ){.
e240: 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e storeLastErrn
e250: 6f 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 o(pFile, tErrno)
e260: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
e270: 20 20 7d 0a 20 20 0a 0a 23 69 66 64 65 66 20 53 }. ..#ifdef S
e280: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f 2a QLITE_DEBUG. /*
e290: 20 53 65 74 20 75 70 20 74 68 65 20 74 72 61 6e Set up the tran
e2a0: 73 61 63 74 69 6f 6e 2d 63 6f 75 6e 74 65 72 20 saction-counter
e2b0: 63 68 61 6e 67 65 20 63 68 65 63 6b 69 6e 67 20 change checking
e2c0: 66 6c 61 67 73 20 77 68 65 6e 0a 20 20 2a 2a 20 flags when. **
e2d0: 74 72 61 6e 73 69 74 69 6f 6e 69 6e 67 20 66 72 transitioning fr
e2e0: 6f 6d 20 61 20 53 48 41 52 45 44 20 74 6f 20 61 om a SHARED to a
e2f0: 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 2e 20 RESERVED lock.
e300: 20 54 68 65 20 63 68 61 6e 67 65 0a 20 20 2a 2a The change. **
e310: 20 66 72 6f 6d 20 53 48 41 52 45 44 20 74 6f 20 from SHARED to
e320: 52 45 53 45 52 56 45 44 20 6d 61 72 6b 73 20 74 RESERVED marks t
e330: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
e340: 61 20 6e 6f 72 6d 61 6c 0a 20 20 2a 2a 20 77 72 a normal. ** wr
e350: 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 20 28 6e ite operation (n
e360: 6f 74 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c ot a hot journal
e370: 20 72 6f 6c 6c 62 61 63 6b 29 2e 0a 20 20 2a 2f rollback).. */
e380: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
e390: 45 5f 4f 4b 0a 20 20 20 26 26 20 70 46 69 6c 65 E_OK. && pFile
e3a0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 41 ->eFileLock<=SHA
e3b0: 52 45 44 5f 4c 4f 43 4b 0a 20 20 20 26 26 20 65 RED_LOCK. && e
e3c0: 46 69 6c 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 FileLock==RESERV
e3d0: 45 44 5f 4c 4f 43 4b 0a 20 20 29 7b 0a 20 20 20 ED_LOCK. ){.
e3e0: 20 70 46 69 6c 65 2d 3e 74 72 61 6e 73 43 6e 74 pFile->transCnt
e3f0: 72 43 68 6e 67 20 3d 20 30 3b 0a 20 20 20 20 70 rChng = 0;. p
e400: 46 69 6c 65 2d 3e 64 62 55 70 64 61 74 65 20 3d File->dbUpdate =
e410: 20 30 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 69 0;. pFile->i
e420: 6e 4e 6f 72 6d 61 6c 57 72 69 74 65 20 3d 20 31 nNormalWrite = 1
e430: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 0a 20 ;. }.#endif...
e440: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
e450: 4f 4b 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d OK ){. pFile-
e460: 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 >eFileLock = eFi
e470: 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 70 49 6e 6f leLock;. pIno
e480: 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 de->eFileLock =
e490: 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 7d 65 6c eFileLock;. }el
e4a0: 73 65 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b se if( eFileLock
e4b0: 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b ==EXCLUSIVE_LOCK
e4c0: 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 ){. pFile->e
e4d0: 46 69 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44 49 FileLock = PENDI
e4e0: 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 49 6e NG_LOCK;. pIn
e4f0: 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d ode->eFileLock =
e500: 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 PENDING_LOCK;.
e510: 20 7d 0a 0a 65 6e 64 5f 6c 6f 63 6b 3a 0a 20 20 }..end_lock:.
e520: 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 unixLeaveMutex()
e530: 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c 4f ;. OSTRACE(("LO
e540: 43 4b 20 20 20 20 25 64 20 25 73 20 25 73 20 28 CK %d %s %s (
e550: 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 6c 65 2d unix)\n", pFile-
e560: 3e 68 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 >h, azFileLock(e
e570: 46 69 6c 65 4c 6f 63 6b 29 2c 20 0a 20 20 20 20 FileLock), .
e580: 20 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 rc==SQLITE_OK
e590: 3f 20 22 6f 6b 22 20 3a 20 22 66 61 69 6c 65 64 ? "ok" : "failed
e5a0: 22 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 "));. return rc
e5b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 74 ;.}../*.** Add t
e5c0: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
e5d0: 6f 72 20 75 73 65 64 20 62 79 20 66 69 6c 65 20 or used by file
e5e0: 68 61 6e 64 6c 65 20 70 46 69 6c 65 20 74 6f 20 handle pFile to
e5f0: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
e600: 67 0a 2a 2a 20 70 55 6e 75 73 65 64 20 6c 69 73 g.** pUnused lis
e610: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 t..*/.static voi
e620: 64 20 73 65 74 50 65 6e 64 69 6e 67 46 64 28 75 d setPendingFd(u
e630: 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29 7b nixFile *pFile){
e640: 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f . unixInodeInfo
e650: 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 *pInode = pFile
e660: 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55 6e 69 78 ->pInode;. Unix
e670: 55 6e 75 73 65 64 46 64 20 2a 70 20 3d 20 70 46 UnusedFd *p = pF
e680: 69 6c 65 2d 3e 70 55 6e 75 73 65 64 3b 0a 20 20 ile->pUnused;.
e690: 70 2d 3e 70 4e 65 78 74 20 3d 20 70 49 6e 6f 64 p->pNext = pInod
e6a0: 65 2d 3e 70 55 6e 75 73 65 64 3b 0a 20 20 70 49 e->pUnused;. pI
e6b0: 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 20 3d 20 node->pUnused =
e6c0: 70 3b 0a 20 20 70 46 69 6c 65 2d 3e 68 20 3d 20 p;. pFile->h =
e6d0: 2d 31 3b 0a 20 20 70 46 69 6c 65 2d 3e 70 55 6e -1;. pFile->pUn
e6e0: 75 73 65 64 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a used = 0;.}../*.
e6f0: 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c 6f 63 ** Lower the loc
e700: 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 66 69 king level on fi
e710: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 70 46 le descriptor pF
e720: 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c 6f 63 6b ile to eFileLock
e730: 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 . eFileLock.**
e740: 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 4e must be either N
e750: 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 44 O_LOCK or SHARED
e760: 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 _LOCK..**.** If
e770: 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 the locking leve
e780: 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64 65 l of the file de
e790: 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72 65 scriptor is alre
e7a0: 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a ady at or below.
e7b0: 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65 64 ** the requested
e7c0: 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20 locking level,
e7d0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
e7e0: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 20 0a 2a 2a 20 a no-op..** .**
e7f0: 49 66 20 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f If handleNFSUnlo
e800: 63 6b 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e ck is true, then
e810: 20 6f 6e 20 64 6f 77 6e 67 72 61 64 69 6e 67 20 on downgrading
e820: 61 6e 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 an EXCLUSIVE_LOC
e830: 4b 20 74 6f 20 53 48 41 52 45 44 0a 2a 2a 20 74 K to SHARED.** t
e840: 68 65 20 62 79 74 65 20 72 61 6e 67 65 20 69 73 he byte range is
e850: 20 64 69 76 69 64 65 64 20 69 6e 74 6f 20 32 20 divided into 2
e860: 70 61 72 74 73 20 61 6e 64 20 74 68 65 20 66 69 parts and the fi
e870: 72 73 74 20 70 61 72 74 20 69 73 20 75 6e 6c 6f rst part is unlo
e880: 63 6b 65 64 20 74 68 65 6e 0a 2a 2a 20 73 65 74 cked then.** set
e890: 20 74 6f 20 61 20 72 65 61 64 20 6c 6f 63 6b 2c to a read lock,
e8a0: 20 74 68 65 6e 20 74 68 65 20 6f 74 68 65 72 20 then the other
e8b0: 70 61 72 74 20 69 73 20 73 69 6d 70 6c 79 20 75 part is simply u
e8c0: 6e 6c 6f 63 6b 65 64 2e 20 20 54 68 69 73 20 77 nlocked. This w
e8d0: 6f 72 6b 73 20 0a 2a 2a 20 61 72 6f 75 6e 64 20 orks .** around
e8e0: 61 20 62 75 67 20 69 6e 20 42 53 44 20 4e 46 53 a bug in BSD NFS
e8f0: 20 6c 6f 63 6b 64 20 28 61 6c 73 6f 20 73 65 65 lockd (also see
e900: 6e 20 6f 6e 20 4d 61 63 4f 53 58 20 31 30 2e 33 n on MacOSX 10.3
e910: 2b 29 20 74 68 61 74 20 66 61 69 6c 73 20 74 6f +) that fails to
e920: 20 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 68 65 20 .** remove the
e930: 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 61 20 write lock on a
e940: 72 65 67 69 6f 6e 20 77 68 65 6e 20 61 20 72 65 region when a re
e950: 61 64 20 6c 6f 63 6b 20 69 73 20 73 65 74 2e 0a ad lock is set..
e960: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 6f */.static int po
e970: 73 69 78 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 sixUnlock(sqlite
e980: 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 3_file *id, int
e990: 65 46 69 6c 65 4c 6f 63 6b 2c 20 69 6e 74 20 68 eFileLock, int h
e9a0: 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f 63 6b 29 7b andleNFSUnlock){
e9b0: 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
e9c0: 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
e9d0: 69 64 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 id;. unixInodeI
e9e0: 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 20 20 73 nfo *pInode;. s
e9f0: 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b truct flock lock
ea00: 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
ea10: 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
ea20: 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 4f 53 t( pFile );. OS
ea30: 54 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b 20 20 TRACE(("UNLOCK
ea40: 25 64 20 25 64 20 77 61 73 20 25 64 28 25 64 2c %d %d was %d(%d,
ea50: 25 64 29 20 70 69 64 3d 25 64 20 28 75 6e 69 78 %d) pid=%d (unix
ea60: 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 )\n", pFile->h,
ea70: 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20 20 20 20 20 eFileLock,.
ea80: 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
ea90: 6b 2c 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 k, pFile->pInode
eaa0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 69 ->eFileLock, pFi
eab0: 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 le->pInode->nSha
eac0: 72 65 64 2c 0a 20 20 20 20 20 20 6f 73 47 65 74 red,. osGet
ead0: 70 69 64 28 30 29 29 29 3b 0a 0a 20 20 61 73 73 pid(0)));.. ass
eae0: 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d ert( eFileLock<=
eaf0: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 SHARED_LOCK );.
eb00: 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c if( pFile->eFil
eb10: 65 4c 6f 63 6b 3c 3d 65 46 69 6c 65 4c 6f 63 6b eLock<=eFileLock
eb20: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
eb30: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 QLITE_OK;. }.
eb40: 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 unixEnterMutex()
eb50: 3b 0a 20 20 70 49 6e 6f 64 65 20 3d 20 70 46 69 ;. pInode = pFi
eb60: 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 61 73 le->pInode;. as
eb70: 73 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 sert( pInode->nS
eb80: 68 61 72 65 64 21 3d 30 20 29 3b 0a 20 20 69 66 hared!=0 );. if
eb90: 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f ( pFile->eFileLo
eba0: 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 ck>SHARED_LOCK )
ebb0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 {. assert( pI
ebc0: 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d node->eFileLock=
ebd0: 3d 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 =pFile->eFileLoc
ebe0: 6b 20 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c k );..#ifdef SQL
ebf0: 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a ITE_DEBUG. /*
ec00: 20 57 68 65 6e 20 72 65 64 75 63 69 6e 67 20 61 When reducing a
ec10: 20 6c 6f 63 6b 20 73 75 63 68 20 74 68 61 74 20 lock such that
ec20: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 other processes
ec30: 63 61 6e 20 73 74 61 72 74 0a 20 20 20 20 2a 2a can start. **
ec40: 20 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 reading the dat
ec50: 61 62 61 73 65 20 66 69 6c 65 20 61 67 61 69 6e abase file again
ec60: 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 , make sure that
ec70: 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 72 61 6e the. ** tran
ec80: 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 saction counter
ec90: 77 61 73 20 75 70 64 61 74 65 64 20 69 66 20 61 was updated if a
eca0: 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 ny part of the d
ecb0: 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 atabase. ** f
ecc0: 69 6c 65 20 63 68 61 6e 67 65 64 2e 20 20 49 66 ile changed. If
ecd0: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
ece0: 20 63 6f 75 6e 74 65 72 20 69 73 20 6e 6f 74 20 counter is not
ecf0: 75 70 64 61 74 65 64 2c 0a 20 20 20 20 2a 2a 20 updated,. **
ed00: 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
ed10: 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20 66 69 s to the same fi
ed20: 6c 65 20 6d 69 67 68 74 20 6e 6f 74 20 72 65 61 le might not rea
ed30: 6c 69 7a 65 20 74 68 61 74 0a 20 20 20 20 2a 2a lize that. **
ed40: 20 74 68 65 20 66 69 6c 65 20 68 61 73 20 63 68 the file has ch
ed50: 61 6e 67 65 64 20 61 6e 64 20 68 65 6e 63 65 20 anged and hence
ed60: 6d 69 67 68 74 20 6e 6f 74 20 6b 6e 6f 77 20 74 might not know t
ed70: 6f 20 66 6c 75 73 68 20 74 68 65 69 72 0a 20 20 o flush their.
ed80: 20 20 2a 2a 20 63 61 63 68 65 2e 20 20 54 68 65 ** cache. The
ed90: 20 75 73 65 20 6f 66 20 61 20 73 74 61 6c 65 20 use of a stale
eda0: 63 61 63 68 65 20 63 61 6e 20 6c 65 61 64 20 74 cache can lead t
edb0: 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 o database corru
edc0: 70 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 ption.. */.
edd0: 20 20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 pFile->inNorma
ede0: 6c 57 72 69 74 65 20 3d 20 30 3b 0a 23 65 6e 64 lWrite = 0;.#end
edf0: 69 66 0a 0a 20 20 20 20 2f 2a 20 64 6f 77 6e 67 if.. /* downg
ee00: 72 61 64 69 6e 67 20 74 6f 20 61 20 73 68 61 72 rading to a shar
ee10: 65 64 20 6c 6f 63 6b 20 6f 6e 20 4e 46 53 20 69 ed lock on NFS i
ee20: 6e 76 6f 6c 76 65 73 20 63 6c 65 61 72 69 6e 67 nvolves clearing
ee30: 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 0a the write lock.
ee40: 20 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 65 73 ** before es
ee50: 74 61 62 6c 69 73 68 69 6e 67 20 74 68 65 20 72 tablishing the r
ee60: 65 61 64 6c 6f 63 6b 20 2d 20 74 6f 20 61 76 6f eadlock - to avo
ee70: 69 64 20 61 20 72 61 63 65 20 63 6f 6e 64 69 74 id a race condit
ee80: 69 6f 6e 20 77 65 20 64 6f 77 6e 67 72 61 64 65 ion we downgrade
ee90: 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b . ** the lock
eea0: 20 69 6e 20 32 20 62 6c 6f 63 6b 73 2c 20 73 6f in 2 blocks, so
eeb0: 20 74 68 61 74 20 70 61 72 74 20 6f 66 20 74 68 that part of th
eec0: 65 20 72 61 6e 67 65 20 77 69 6c 6c 20 62 65 20 e range will be
eed0: 63 6f 76 65 72 65 64 20 62 79 20 61 20 0a 20 20 covered by a .
eee0: 20 20 2a 2a 20 77 72 69 74 65 20 6c 6f 63 6b 20 ** write lock
eef0: 75 6e 74 69 6c 20 74 68 65 20 72 65 73 74 20 69 until the rest i
ef00: 73 20 63 6f 76 65 72 65 64 20 62 79 20 61 20 72 s covered by a r
ef10: 65 61 64 20 6c 6f 63 6b 3a 0a 20 20 20 20 2a 2a ead lock:. **
ef20: 20 20 31 3a 20 20 20 5b 57 57 57 57 57 5d 0a 20 1: [WWWWW].
ef30: 20 20 20 2a 2a 20 20 32 3a 20 20 20 5b 2e 2e 2e ** 2: [...
ef40: 2e 57 5d 0a 20 20 20 20 2a 2a 20 20 33 3a 20 20 .W]. ** 3:
ef50: 20 5b 52 52 52 52 57 5d 0a 20 20 20 20 2a 2a 20 [RRRRW]. **
ef60: 20 34 3a 20 20 20 5b 52 52 52 52 2e 5d 0a 20 20 4: [RRRR.].
ef70: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 65 46 69 */. if( eFi
ef80: 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c leLock==SHARED_L
ef90: 4f 43 4b 20 29 7b 0a 23 69 66 20 21 64 65 66 69 OCK ){.#if !defi
efa0: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 7c ned(__APPLE__) |
efb0: 7c 20 21 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 | !SQLITE_ENABLE
efc0: 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 _LOCKING_STYLE.
efd0: 20 20 20 20 20 28 76 6f 69 64 29 68 61 6e 64 6c (void)handl
efe0: 65 4e 46 53 55 6e 6c 6f 63 6b 3b 0a 20 20 20 20 eNFSUnlock;.
eff0: 20 20 61 73 73 65 72 74 28 20 68 61 6e 64 6c 65 assert( handle
f000: 4e 46 53 55 6e 6c 6f 63 6b 3d 3d 30 20 29 3b 0a NFSUnlock==0 );.
f010: 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
f020: 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 ed(__APPLE__) &&
f030: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
f040: 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 20 OCKING_STYLE.
f050: 20 20 20 69 66 28 20 68 61 6e 64 6c 65 4e 46 53 if( handleNFS
f060: 55 6e 6c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 Unlock ){.
f070: 20 20 69 6e 74 20 74 45 72 72 6e 6f 3b 20 20 20 int tErrno;
f080: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
f090: 72 72 6f 72 20 63 6f 64 65 20 66 72 6f 6d 20 73 rror code from s
f0a0: 79 73 74 65 6d 20 63 61 6c 6c 20 65 72 72 6f 72 ystem call error
f0b0: 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 6f 66 66 s */. off
f0c0: 5f 74 20 64 69 76 53 69 7a 65 20 3d 20 53 48 41 _t divSize = SHA
f0d0: 52 45 44 5f 53 49 5a 45 20 2d 20 31 3b 0a 20 20 RED_SIZE - 1;.
f0e0: 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 6c . l
f0f0: 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 ock.l_type = F_U
f100: 4e 4c 43 4b 3b 0a 20 20 20 20 20 20 20 20 6c 6f NLCK;. lo
f110: 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 ck.l_whence = SE
f120: 45 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20 20 20 EK_SET;.
f130: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 lock.l_start = S
f140: 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20 20 HARED_FIRST;.
f150: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 lock.l_len
f160: 3d 20 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 20 = divSize;.
f170: 20 20 20 69 66 28 20 75 6e 69 78 46 69 6c 65 4c if( unixFileL
f180: 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b ock(pFile, &lock
f190: 29 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 )==(-1) ){.
f1a0: 20 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 tErrno = er
f1b0: 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 rno;. r
f1c0: 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 c = SQLITE_IOERR
f1d0: 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 20 _UNLOCK;.
f1e0: 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e storeLastErrn
f1f0: 6f 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 o(pFile, tErrno)
f200: 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
f210: 20 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 end_unlock;.
f220: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 6c }. l
f230: 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 52 ock.l_type = F_R
f240: 44 4c 43 4b 3b 0a 20 20 20 20 20 20 20 20 6c 6f DLCK;. lo
f250: 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 ck.l_whence = SE
f260: 45 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20 20 20 EK_SET;.
f270: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 lock.l_start = S
f280: 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20 20 HARED_FIRST;.
f290: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 lock.l_len
f2a0: 3d 20 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 20 = divSize;.
f2b0: 20 20 20 69 66 28 20 75 6e 69 78 46 69 6c 65 4c if( unixFileL
f2c0: 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b ock(pFile, &lock
f2d0: 29 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 )==(-1) ){.
f2e0: 20 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 tErrno = er
f2f0: 72 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 rno;. r
f300: 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 c = sqliteErrorF
f310: 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 romPosixError(tE
f320: 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 rrno, SQLITE_IOE
f330: 52 52 5f 52 44 4c 4f 43 4b 29 3b 0a 20 20 20 20 RR_RDLOCK);.
f340: 20 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 if( IS_LOC
f350: 4b 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 K_ERROR(rc) ){.
f360: 20 20 20 20 20 20 20 20 20 20 20 73 74 6f 72 65 store
f370: 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c LastErrno(pFile,
f380: 20 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 tErrno);.
f390: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
f3a0: 67 6f 74 6f 20 65 6e 64 5f 75 6e 6c 6f 63 6b 3b goto end_unlock;
f3b0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
f3c0: 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d lock.l_type =
f3d0: 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20 20 20 20 F_UNLCK;.
f3e0: 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 lock.l_whence
f3f0: 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 = SEEK_SET;.
f400: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 lock.l_start
f410: 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53 54 2b = SHARED_FIRST+
f420: 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 divSize;.
f430: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 lock.l_len = SH
f440: 41 52 45 44 5f 53 49 5a 45 2d 64 69 76 53 69 7a ARED_SIZE-divSiz
f450: 65 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 75 e;. if( u
f460: 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c nixFileLock(pFil
f470: 65 2c 20 26 6c 6f 63 6b 29 3d 3d 28 2d 31 29 20 e, &lock)==(-1)
f480: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 74 45 72 ){. tEr
f490: 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 rno = errno;.
f4a0: 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
f4b0: 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b TE_IOERR_UNLOCK;
f4c0: 0a 20 20 20 20 20 20 20 20 20 20 73 74 6f 72 65 . store
f4d0: 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c LastErrno(pFile,
f4e0: 20 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 tErrno);.
f4f0: 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 75 6e 6c goto end_unl
f500: 6f 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ock;. }.
f510: 20 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 }else.#endi
f520: 66 20 2f 2a 20 64 65 66 69 6e 65 64 28 5f 5f 41 f /* defined(__A
f530: 50 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 PPLE__) && SQLIT
f540: 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
f550: 5f 53 54 59 4c 45 20 2a 2f 0a 20 20 20 20 20 20 _STYLE */.
f560: 7b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c {. lock.l
f570: 5f 74 79 70 65 20 3d 20 46 5f 52 44 4c 43 4b 3b _type = F_RDLCK;
f580: 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f . lock.l_
f590: 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 whence = SEEK_SE
f5a0: 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e T;. lock.
f5b0: 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 45 44 l_start = SHARED
f5c0: 5f 46 49 52 53 54 3b 0a 20 20 20 20 20 20 20 20 _FIRST;.
f5d0: 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 lock.l_len = SHA
f5e0: 52 45 44 5f 53 49 5a 45 3b 0a 20 20 20 20 20 20 RED_SIZE;.
f5f0: 20 20 69 66 28 20 75 6e 69 78 46 69 6c 65 4c 6f if( unixFileLo
f600: 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b 29 ck(pFile, &lock)
f610: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a ){. /*
f620: 20 49 6e 20 74 68 65 6f 72 79 2c 20 74 68 65 20 In theory, the
f630: 63 61 6c 6c 20 74 6f 20 75 6e 69 78 46 69 6c 65 call to unixFile
f640: 4c 6f 63 6b 28 29 20 63 61 6e 6e 6f 74 20 66 61 Lock() cannot fa
f650: 69 6c 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68 il because anoth
f660: 65 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 er. **
f670: 70 72 6f 63 65 73 73 20 69 73 20 68 6f 6c 64 69 process is holdi
f680: 6e 67 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 ng an incompatib
f690: 6c 65 20 6c 6f 63 6b 2e 20 49 66 20 69 74 20 64 le lock. If it d
f6a0: 6f 65 73 2c 20 74 68 69 73 20 0a 20 20 20 20 20 oes, this .
f6b0: 20 20 20 20 20 2a 2a 20 69 6e 64 69 63 61 74 65 ** indicate
f6c0: 73 20 74 68 61 74 20 74 68 65 20 6f 74 68 65 72 s that the other
f6d0: 20 70 72 6f 63 65 73 73 20 69 73 20 6e 6f 74 20 process is not
f6e0: 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 6c 6f following the lo
f6f0: 63 6b 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 cking.
f700: 2a 2a 20 70 72 6f 74 6f 63 6f 6c 2e 20 49 66 20 ** protocol. If
f710: 74 68 69 73 20 68 61 70 70 65 6e 73 2c 20 72 65 this happens, re
f720: 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 turn SQLITE_IOER
f730: 52 5f 52 44 4c 4f 43 4b 2e 20 52 65 74 75 72 6e R_RDLOCK. Return
f740: 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 2a 2a ing. **
f750: 20 53 51 4c 49 54 45 5f 42 55 53 59 20 77 6f 75 SQLITE_BUSY wou
f760: 6c 64 20 63 6f 6e 66 75 73 65 20 74 68 65 20 75 ld confuse the u
f770: 70 70 65 72 20 6c 61 79 65 72 20 28 69 6e 20 70 pper layer (in p
f780: 72 61 63 74 69 63 65 20 69 74 20 63 61 75 73 65 ractice it cause
f790: 73 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 s . **
f7a0: 61 6e 20 61 73 73 65 72 74 20 74 6f 20 66 61 69 an assert to fai
f7b0: 6c 29 2e 20 2a 2f 20 0a 20 20 20 20 20 20 20 20 l). */ .
f7c0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f rc = SQLITE_IO
f7d0: 45 52 52 5f 52 44 4c 4f 43 4b 3b 0a 20 20 20 20 ERR_RDLOCK;.
f7e0: 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 storeLastE
f7f0: 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72 6e rrno(pFile, errn
f800: 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f o);. go
f810: 74 6f 20 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 to end_unlock;.
f820: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
f830: 0a 20 20 20 20 7d 0a 20 20 20 20 6c 6f 63 6b 2e . }. lock.
f840: 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b l_type = F_UNLCK
f850: 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 ;. lock.l_whe
f860: 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a nce = SEEK_SET;.
f870: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 lock.l_start
f880: 20 3d 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b = PENDING_BYTE;
f890: 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 . lock.l_len
f8a0: 3d 20 32 4c 3b 20 20 61 73 73 65 72 74 28 20 50 = 2L; assert( P
f8b0: 45 4e 44 49 4e 47 5f 42 59 54 45 2b 31 3d 3d 52 ENDING_BYTE+1==R
f8c0: 45 53 45 52 56 45 44 5f 42 59 54 45 20 29 3b 0a ESERVED_BYTE );.
f8d0: 20 20 20 20 69 66 28 20 75 6e 69 78 46 69 6c 65 if( unixFile
f8e0: 4c 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 Lock(pFile, &loc
f8f0: 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 k)==0 ){. p
f900: 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b Inode->eFileLock
f910: 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a = SHARED_LOCK;.
f920: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
f930: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 rc = SQLITE_IOE
f940: 52 52 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20 20 RR_UNLOCK;.
f950: 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 storeLastErrno(
f960: 70 46 69 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 pFile, errno);.
f970: 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 75 6e goto end_un
f980: 6c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a lock;. }. }.
f990: 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d if( eFileLock=
f9a0: 3d 4e 4f 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 =NO_LOCK ){.
f9b0: 2f 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 /* Decrement the
f9c0: 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 63 6f 75 shared lock cou
f9d0: 6e 74 65 72 2e 20 20 52 65 6c 65 61 73 65 20 74 nter. Release t
f9e0: 68 65 20 6c 6f 63 6b 20 75 73 69 6e 67 20 61 6e he lock using an
f9f0: 0a 20 20 20 20 2a 2a 20 4f 53 20 63 61 6c 6c 20 . ** OS call
fa00: 6f 6e 6c 79 20 77 68 65 6e 20 61 6c 6c 20 74 68 only when all th
fa10: 72 65 61 64 73 20 69 6e 20 74 68 69 73 20 73 61 reads in this sa
fa20: 6d 65 20 70 72 6f 63 65 73 73 20 68 61 76 65 20 me process have
fa30: 72 65 6c 65 61 73 65 64 0a 20 20 20 20 2a 2a 20 released. **
fa40: 74 68 65 20 6c 6f 63 6b 2e 0a 20 20 20 20 2a 2f the lock.. */
fa50: 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 . pInode->nSh
fa60: 61 72 65 64 2d 2d 3b 0a 20 20 20 20 69 66 28 20 ared--;. if(
fa70: 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3d pInode->nShared=
fa80: 3d 30 20 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b =0 ){. lock
fa90: 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 .l_type = F_UNLC
faa0: 4b 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f K;. lock.l_
fab0: 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 whence = SEEK_SE
fac0: 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f T;. lock.l_
fad0: 73 74 61 72 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c start = lock.l_l
fae0: 65 6e 20 3d 20 30 4c 3b 0a 20 20 20 20 20 20 69 en = 0L;. i
faf0: 66 28 20 75 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 f( unixFileLock(
fb00: 70 46 69 6c 65 2c 20 26 6c 6f 63 6b 29 3d 3d 30 pFile, &lock)==0
fb10: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 49 6e 6f ){. pIno
fb20: 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 de->eFileLock =
fb30: 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d NO_LOCK;. }
fb40: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 else{. rc
fb50: 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = SQLITE_IOERR_
fb60: 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 UNLOCK;.
fb70: 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 storeLastErrno(p
fb80: 46 69 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 File, errno);.
fb90: 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 pInode->eF
fba0: 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 ileLock = NO_LOC
fbb0: 4b 3b 0a 20 20 20 20 20 20 20 20 70 46 69 6c 65 K;. pFile
fbc0: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f ->eFileLock = NO
fbd0: 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 _LOCK;. }.
fbe0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 65 63 }.. /* Dec
fbf0: 72 65 6d 65 6e 74 20 74 68 65 20 63 6f 75 6e 74 rement the count
fc00: 20 6f 66 20 6c 6f 63 6b 73 20 61 67 61 69 6e 73 of locks agains
fc10: 74 20 74 68 69 73 20 73 61 6d 65 20 66 69 6c 65 t this same file
fc20: 2e 20 20 57 68 65 6e 20 74 68 65 0a 20 20 20 20 . When the.
fc30: 2a 2a 20 63 6f 75 6e 74 20 72 65 61 63 68 65 73 ** count reaches
fc40: 20 7a 65 72 6f 2c 20 63 6c 6f 73 65 20 61 6e 79 zero, close any
fc50: 20 6f 74 68 65 72 20 66 69 6c 65 20 64 65 73 63 other file desc
fc60: 72 69 70 74 6f 72 73 20 77 68 6f 73 65 20 63 6c riptors whose cl
fc70: 6f 73 65 0a 20 20 20 20 2a 2a 20 77 61 73 20 64 ose. ** was d
fc80: 65 66 65 72 72 65 64 20 62 65 63 61 75 73 65 20 eferred because
fc90: 6f 66 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 6c of outstanding l
fca0: 6f 63 6b 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ocks.. */.
fcb0: 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 2d 2d pInode->nLock--
fcc0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 ;. assert( pI
fcd0: 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 3e 3d 30 20 29 node->nLock>=0 )
fce0: 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f 64 65 ;. if( pInode
fcf0: 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 29 7b 0a 20 20 ->nLock==0 ){.
fd00: 20 20 20 20 63 6c 6f 73 65 50 65 6e 64 69 6e 67 closePending
fd10: 46 64 73 28 70 46 69 6c 65 29 3b 0a 20 20 20 20 Fds(pFile);.
fd20: 7d 0a 20 20 7d 0a 0a 65 6e 64 5f 75 6e 6c 6f 63 }. }..end_unloc
fd30: 6b 3a 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 k:. unixLeaveMu
fd40: 74 65 78 28 29 3b 0a 20 20 69 66 28 20 72 63 3d tex();. if( rc=
fd50: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 70 46 69 =SQLITE_OK ) pFi
fd60: 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 le->eFileLock =
fd70: 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 72 65 74 eFileLock;. ret
fd80: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
fd90: 20 4c 6f 77 65 72 20 74 68 65 20 6c 6f 63 6b 69 Lower the locki
fda0: 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 66 69 6c 65 ng level on file
fdb0: 20 64 65 73 63 72 69 70 74 6f 72 20 70 46 69 6c descriptor pFil
fdc0: 65 20 74 6f 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 e to eFileLock.
fdd0: 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 eFileLock.** mu
fde0: 73 74 20 62 65 20 65 69 74 68 65 72 20 4e 4f 5f st be either NO_
fdf0: 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 44 5f 4c LOCK or SHARED_L
fe00: 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 OCK..**.** If th
fe10: 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 e locking level
fe20: 6f 66 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 of the file desc
fe30: 72 69 70 74 6f 72 20 69 73 20 61 6c 72 65 61 64 riptor is alread
fe40: 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a 2a 2a y at or below.**
fe50: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c the requested l
fe60: 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68 ocking level, th
fe70: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 is routine is a
fe80: 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 no-op..*/.static
fe90: 20 69 6e 74 20 75 6e 69 78 55 6e 6c 6f 63 6b 28 int unixUnlock(
fea0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 sqlite3_file *id
feb0: 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 , int eFileLock)
fec0: 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 {.#if SQLITE_MAX
fed0: 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 61 _MMAP_SIZE>0. a
fee0: 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b ssert( eFileLock
fef0: 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c ==SHARED_LOCK ||
ff00: 20 28 28 75 6e 69 78 46 69 6c 65 20 2a 29 69 64 ((unixFile *)id
ff10: 29 2d 3e 6e 46 65 74 63 68 4f 75 74 3d 3d 30 20 )->nFetchOut==0
ff20: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 );.#endif. retu
ff30: 72 6e 20 70 6f 73 69 78 55 6e 6c 6f 63 6b 28 69 rn posixUnlock(i
ff40: 64 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 20 30 29 d, eFileLock, 0)
ff50: 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f ;.}..#if SQLITE_
ff60: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a MAX_MMAP_SIZE>0.
ff70: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 4d static int unixM
ff80: 61 70 66 69 6c 65 28 75 6e 69 78 46 69 6c 65 20 apfile(unixFile
ff90: 2a 70 46 64 2c 20 69 36 34 20 6e 42 79 74 65 29 *pFd, i64 nByte)
ffa0: 3b 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e ;.static void un
ffb0: 69 78 55 6e 6d 61 70 66 69 6c 65 28 75 6e 69 78 ixUnmapfile(unix
ffc0: 46 69 6c 65 20 2a 70 46 64 29 3b 0a 23 65 6e 64 File *pFd);.#end
ffd0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 if../*.** This f
ffe0: 75 6e 63 74 69 6f 6e 20 70 65 72 66 6f 72 6d 73 unction performs
fff0: 20 74 68 65 20 70 61 72 74 73 20 6f 66 20 74 68 the parts of th
10000 65 20 22 63 6c 6f 73 65 20 66 69 6c 65 22 20 6f e "close file" o
10010 70 65 72 61 74 69 6f 6e 20 0a 2a 2a 20 63 6f 6d peration .** com
10020 6d 6f 6e 20 74 6f 20 61 6c 6c 20 6c 6f 63 6b 69 mon to all locki
10030 6e 67 20 73 63 68 65 6d 65 73 2e 20 49 74 20 63 ng schemes. It c
10040 6c 6f 73 65 73 20 74 68 65 20 64 69 72 65 63 74 loses the direct
10050 6f 72 79 20 61 6e 64 20 66 69 6c 65 0a 2a 2a 20 ory and file.**
10060 68 61 6e 64 6c 65 73 2c 20 69 66 20 74 68 65 79 handles, if they
10070 20 61 72 65 20 76 61 6c 69 64 2c 20 61 6e 64 20 are valid, and
10080 73 65 74 73 20 61 6c 6c 20 66 69 65 6c 64 73 20 sets all fields
10090 6f 66 20 74 68 65 20 75 6e 69 78 46 69 6c 65 0a of the unixFile.
100a0 2a 2a 20 73 74 72 75 63 74 75 72 65 20 74 6f 20 ** structure to
100b0 30 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 2a 0..**.** It is *
100c0 6e 6f 74 2a 20 6e 65 63 65 73 73 61 72 79 20 74 not* necessary t
100d0 6f 20 68 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 o hold the mutex
100e0 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 when this routi
100f0 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c 0a 2a 2a ne is called,.**
10100 20 65 76 65 6e 20 6f 6e 20 56 78 57 6f 72 6b 73 even on VxWorks
10110 2e 20 20 41 20 6d 75 74 65 78 20 77 69 6c 6c 20 . A mutex will
10120 62 65 20 61 63 71 75 69 72 65 64 20 6f 6e 20 56 be acquired on V
10130 78 57 6f 72 6b 73 20 62 79 20 74 68 65 0a 2a 2a xWorks by the.**
10140 20 76 78 77 6f 72 6b 73 52 65 6c 65 61 73 65 46 vxworksReleaseF
10150 69 6c 65 49 64 28 29 20 72 6f 75 74 69 6e 65 2e ileId() routine.
10160 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 .*/.static int c
10170 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28 73 71 6c loseUnixFile(sql
10180 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 7b 0a ite3_file *id){.
10190 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
101a0 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
101b0 64 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 d;.#if SQLITE_MA
101c0 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 X_MMAP_SIZE>0.
101d0 75 6e 69 78 55 6e 6d 61 70 66 69 6c 65 28 70 46 unixUnmapfile(pF
101e0 69 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 20 20 69 ile);.#endif. i
101f0 66 28 20 70 46 69 6c 65 2d 3e 68 3e 3d 30 20 29 f( pFile->h>=0 )
10200 7b 0a 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f {. robust_clo
10210 73 65 28 70 46 69 6c 65 2c 20 70 46 69 6c 65 2d se(pFile, pFile-
10220 3e 68 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 >h, __LINE__);.
10230 20 20 20 70 46 69 6c 65 2d 3e 68 20 3d 20 2d 31 pFile->h = -1
10240 3b 0a 20 20 7d 0a 23 69 66 20 4f 53 5f 56 58 57 ;. }.#if OS_VXW
10250 4f 52 4b 53 0a 20 20 69 66 28 20 70 46 69 6c 65 ORKS. if( pFile
10260 2d 3e 70 49 64 20 29 7b 0a 20 20 20 20 69 66 28 ->pId ){. if(
10270 20 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 pFile->ctrlFlag
10280 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 44 45 4c s & UNIXFILE_DEL
10290 45 54 45 20 29 7b 0a 20 20 20 20 20 20 6f 73 55 ETE ){. osU
102a0 6e 6c 69 6e 6b 28 70 46 69 6c 65 2d 3e 70 49 64 nlink(pFile->pId
102b0 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 ->zCanonicalName
102c0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 76 78 77 );. }. vxw
102d0 6f 72 6b 73 52 65 6c 65 61 73 65 46 69 6c 65 49 orksReleaseFileI
102e0 64 28 70 46 69 6c 65 2d 3e 70 49 64 29 3b 0a 20 d(pFile->pId);.
102f0 20 20 20 70 46 69 6c 65 2d 3e 70 49 64 20 3d 20 pFile->pId =
10300 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 0;. }.#endif.#i
10310 66 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 4c 49 fdef SQLITE_UNLI
10320 4e 4b 5f 41 46 54 45 52 5f 43 4c 4f 53 45 0a 20 NK_AFTER_CLOSE.
10330 20 69 66 28 20 70 46 69 6c 65 2d 3e 63 74 72 6c if( pFile->ctrl
10340 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 4c 45 Flags & UNIXFILE
10350 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 20 20 6f _DELETE ){. o
10360 73 55 6e 6c 69 6e 6b 28 70 46 69 6c 65 2d 3e 7a sUnlink(pFile->z
10370 50 61 74 68 29 3b 0a 20 20 20 20 73 71 6c 69 74 Path);. sqlit
10380 65 33 5f 66 72 65 65 28 2a 28 63 68 61 72 2a 2a e3_free(*(char**
10390 29 26 70 46 69 6c 65 2d 3e 7a 50 61 74 68 29 3b )&pFile->zPath);
103a0 0a 20 20 20 20 70 46 69 6c 65 2d 3e 7a 50 61 74 . pFile->zPat
103b0 68 20 3d 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 h = 0;. }.#endi
103c0 66 0a 20 20 4f 53 54 52 41 43 45 28 28 22 43 4c f. OSTRACE(("CL
103d0 4f 53 45 20 20 20 25 2d 33 64 5c 6e 22 2c 20 70 OSE %-3d\n", p
103e0 46 69 6c 65 2d 3e 68 29 29 3b 0a 20 20 4f 70 65 File->h));. Ope
103f0 6e 43 6f 75 6e 74 65 72 28 2d 31 29 3b 0a 20 20 nCounter(-1);.
10400 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 46 69 sqlite3_free(pFi
10410 6c 65 2d 3e 70 55 6e 75 73 65 64 29 3b 0a 20 20 le->pUnused);.
10420 6d 65 6d 73 65 74 28 70 46 69 6c 65 2c 20 30 2c memset(pFile, 0,
10430 20 73 69 7a 65 6f 66 28 75 6e 69 78 46 69 6c 65 sizeof(unixFile
10440 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c ));. return SQL
10450 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
10460 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 2e 0a 2a Close a file..*
10470 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 /.static int uni
10480 78 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 xClose(sqlite3_f
10490 69 6c 65 20 2a 69 64 29 7b 0a 20 20 69 6e 74 20 ile *id){. int
104a0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
104b0 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
104c0 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 e = (unixFile *)
104d0 69 64 3b 0a 20 20 76 65 72 69 66 79 44 62 46 69 id;. verifyDbFi
104e0 6c 65 28 70 46 69 6c 65 29 3b 0a 20 20 75 6e 69 le(pFile);. uni
104f0 78 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f 5f 4c xUnlock(id, NO_L
10500 4f 43 4b 29 3b 0a 20 20 75 6e 69 78 45 6e 74 65 OCK);. unixEnte
10510 72 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 rMutex();.. /*
10520 75 6e 69 78 46 69 6c 65 2e 70 49 6e 6f 64 65 20 unixFile.pInode
10530 69 73 20 61 6c 77 61 79 73 20 76 61 6c 69 64 20 is always valid
10540 68 65 72 65 2e 20 4f 74 68 65 72 77 69 73 65 2c here. Otherwise,
10550 20 61 20 64 69 66 66 65 72 65 6e 74 20 63 6c 6f a different clo
10560 73 65 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 20 se. ** routine
10570 28 65 2e 67 2e 20 6e 6f 6c 6f 63 6b 43 6c 6f 73 (e.g. nolockClos
10580 65 28 29 29 20 77 6f 75 6c 64 20 62 65 20 63 61 e()) would be ca
10590 6c 6c 65 64 20 69 6e 73 74 65 61 64 2e 0a 20 20 lled instead..
105a0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 */. assert( pFi
105b0 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 le->pInode->nLoc
105c0 6b 3e 30 20 7c 7c 20 70 46 69 6c 65 2d 3e 70 49 k>0 || pFile->pI
105d0 6e 6f 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f node->bProcessLo
105e0 63 6b 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 41 ck==0 );. if( A
105f0 4c 57 41 59 53 28 70 46 69 6c 65 2d 3e 70 49 6e LWAYS(pFile->pIn
10600 6f 64 65 29 20 26 26 20 70 46 69 6c 65 2d 3e 70 ode) && pFile->p
10610 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 20 29 7b 0a Inode->nLock ){.
10620 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 /* If there
10630 61 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 are outstanding
10640 6c 6f 63 6b 73 2c 20 64 6f 20 6e 6f 74 20 61 63 locks, do not ac
10650 74 75 61 6c 6c 79 20 63 6c 6f 73 65 20 74 68 65 tually close the
10660 20 66 69 6c 65 20 6a 75 73 74 0a 20 20 20 20 2a file just. *
10670 2a 20 79 65 74 20 62 65 63 61 75 73 65 20 74 68 * yet because th
10680 61 74 20 77 6f 75 6c 64 20 63 6c 65 61 72 20 74 at would clear t
10690 68 6f 73 65 20 6c 6f 63 6b 73 2e 20 20 49 6e 73 hose locks. Ins
106a0 74 65 61 64 2c 20 61 64 64 20 74 68 65 20 66 69 tead, add the fi
106b0 6c 65 0a 20 20 20 20 2a 2a 20 64 65 73 63 72 69 le. ** descri
106c0 70 74 6f 72 20 74 6f 20 70 49 6e 6f 64 65 2d 3e ptor to pInode->
106d0 70 55 6e 75 73 65 64 20 6c 69 73 74 2e 20 20 49 pUnused list. I
106e0 74 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 t will be automa
106f0 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64 20 0a tically closed .
10700 20 20 20 20 2a 2a 20 77 68 65 6e 20 74 68 65 20 ** when the
10710 6c 61 73 74 20 6c 6f 63 6b 20 69 73 20 63 6c 65 last lock is cle
10720 61 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ared.. */.
10730 20 73 65 74 50 65 6e 64 69 6e 67 46 64 28 70 46 setPendingFd(pF
10740 69 6c 65 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 ile);. }. rele
10750 61 73 65 49 6e 6f 64 65 49 6e 66 6f 28 70 46 69 aseInodeInfo(pFi
10760 6c 65 29 3b 0a 20 20 72 63 20 3d 20 63 6c 6f 73 le);. rc = clos
10770 65 55 6e 69 78 46 69 6c 65 28 69 64 29 3b 0a 20 eUnixFile(id);.
10780 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
10790 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
107a0 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a }../************
107b0 2a 2a 20 45 6e 64 20 6f 66 20 74 68 65 20 70 6f ** End of the po
107c0 73 69 78 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 six advisory loc
107d0 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e k implementation
107e0 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
107f0 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
10800 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10810 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10820 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10830 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10840 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a */../***********
10850 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10860 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10870 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10880 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10890 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***.************
108a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
108b0 2a 2a 20 4e 6f 2d 6f 70 20 4c 6f 63 6b 69 6e 67 ** No-op Locking
108c0 20 2a 2a 2a 2a 2a 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 0a 2a 2a 0a 2a 2a 20 4f 66 20 74 68 65 ***.**.** Of the
108f0 20 76 61 72 69 6f 75 73 20 6c 6f 63 6b 69 6e 67 various locking
10900 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
10910 20 61 76 61 69 6c 61 62 6c 65 2c 20 74 68 69 73 available, this
10920 20 69 73 20 62 79 20 66 61 72 20 74 68 65 0a 2a is by far the.*
10930 2a 20 73 69 6d 70 6c 65 73 74 3a 20 20 6c 6f 63 * simplest: loc
10940 6b 69 6e 67 20 69 73 20 69 67 6e 6f 72 65 64 2e king is ignored.
10950 20 20 4e 6f 20 61 74 74 65 6d 70 74 20 69 73 20 No attempt is
10960 6d 61 64 65 20 74 6f 20 6c 6f 63 6b 20 74 68 65 made to lock the
10970 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 66 69 6c database.** fil
10980 65 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 e for reading or
10990 20 77 72 69 74 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 writing..**.**
109a0 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 6d 6f 64 This locking mod
109b0 65 20 69 73 20 61 70 70 72 6f 70 72 69 61 74 65 e is appropriate
109c0 20 66 6f 72 20 75 73 65 20 6f 6e 20 72 65 61 64 for use on read
109d0 2d 6f 6e 6c 79 20 64 61 74 61 62 61 73 65 73 0a -only databases.
109e0 2a 2a 20 28 65 78 3a 20 64 61 74 61 62 61 73 65 ** (ex: database
109f0 73 20 74 68 61 74 20 61 72 65 20 62 75 72 6e 65 s that are burne
10a00 64 20 69 6e 74 6f 20 43 44 2d 52 4f 4d 2c 20 66 d into CD-ROM, f
10a10 6f 72 20 65 78 61 6d 70 6c 65 2e 29 20 20 49 74 or example.) It
10a20 20 63 61 6e 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 can.** also be
10a30 75 73 65 64 20 69 66 20 74 68 65 20 61 70 70 6c used if the appl
10a40 69 63 61 74 69 6f 6e 20 65 6d 70 6c 6f 79 73 20 ication employs
10a50 73 6f 6d 65 20 65 78 74 65 72 6e 61 6c 20 6d 65 some external me
10a60 63 68 61 6e 69 73 6d 20 74 6f 0a 2a 2a 20 70 72 chanism to.** pr
10a70 65 76 65 6e 74 20 73 69 6d 75 6c 74 61 6e 65 6f event simultaneo
10a80 75 73 20 61 63 63 65 73 73 20 6f 66 20 74 68 65 us access of the
10a90 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 62 same database b
10aa0 79 20 74 77 6f 20 6f 72 20 6d 6f 72 65 0a 2a 2a y two or more.**
10ab0 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
10ac0 74 69 6f 6e 73 2e 20 20 42 75 74 20 74 68 65 72 tions. But ther
10ad0 65 20 69 73 20 61 20 73 65 72 69 6f 75 73 20 72 e is a serious r
10ae0 69 73 6b 20 6f 66 20 64 61 74 61 62 61 73 65 0a isk of database.
10af0 2a 2a 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 66 ** corruption if
10b00 20 74 68 69 73 20 6c 6f 63 6b 69 6e 67 20 6d 6f this locking mo
10b10 64 65 20 69 73 20 75 73 65 64 20 69 6e 20 73 69 de is used in si
10b20 74 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20 6d tuations where m
10b30 75 6c 74 69 70 6c 65 0a 2a 2a 20 64 61 74 61 62 ultiple.** datab
10b40 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 ase connections
10b50 61 72 65 20 61 63 63 65 73 73 69 6e 67 20 74 68 are accessing th
10b60 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 e same database
10b70 66 69 6c 65 20 61 74 20 74 68 65 20 73 61 6d 65 file at the same
10b80 0a 2a 2a 20 74 69 6d 65 20 61 6e 64 20 6f 6e 65 .** time and one
10b90 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 6f 73 or more of thos
10ba0 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 72 e connections ar
10bb0 65 20 77 72 69 74 69 6e 67 2e 0a 2a 2f 0a 0a 73 e writing..*/..s
10bc0 74 61 74 69 63 20 69 6e 74 20 6e 6f 6c 6f 63 6b tatic int nolock
10bd0 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 CheckReservedLoc
10be0 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a k(sqlite3_file *
10bf0 4e 6f 74 55 73 65 64 2c 20 69 6e 74 20 2a 70 52 NotUsed, int *pR
10c00 65 73 4f 75 74 29 7b 0a 20 20 55 4e 55 53 45 44 esOut){. UNUSED
10c10 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 _PARAMETER(NotUs
10c20 65 64 29 3b 0a 20 20 2a 70 52 65 73 4f 75 74 20 ed);. *pResOut
10c30 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 = 0;. return SQ
10c40 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 73 74 61 74 69 LITE_OK;.}.stati
10c50 63 20 69 6e 74 20 6e 6f 6c 6f 63 6b 4c 6f 63 6b c int nolockLock
10c60 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 4e (sqlite3_file *N
10c70 6f 74 55 73 65 64 2c 20 69 6e 74 20 4e 6f 74 55 otUsed, int NotU
10c80 73 65 64 32 29 7b 0a 20 20 55 4e 55 53 45 44 5f sed2){. UNUSED_
10c90 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 PARAMETER2(NotUs
10ca0 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 ed, NotUsed2);.
10cb0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
10cc0 4b 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 K;.}.static int
10cd0 6e 6f 6c 6f 63 6b 55 6e 6c 6f 63 6b 28 73 71 6c nolockUnlock(sql
10ce0 69 74 65 33 5f 66 69 6c 65 20 2a 4e 6f 74 55 73 ite3_file *NotUs
10cf0 65 64 2c 20 69 6e 74 20 4e 6f 74 55 73 65 64 32 ed, int NotUsed2
10d00 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 ){. UNUSED_PARA
10d10 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 METER2(NotUsed,
10d20 4e 6f 74 55 73 65 64 32 29 3b 0a 20 20 72 65 74 NotUsed2);. ret
10d30 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
10d40 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 74 68 ../*.** Close th
10d50 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 e file..*/.stati
10d60 63 20 69 6e 74 20 6e 6f 6c 6f 63 6b 43 6c 6f 73 c int nolockClos
10d70 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a e(sqlite3_file *
10d80 69 64 29 20 7b 0a 20 20 72 65 74 75 72 6e 20 63 id) {. return c
10d90 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28 69 64 29 loseUnixFile(id)
10da0 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ;.}../**********
10db0 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 ********* End of
10dc0 20 74 68 65 20 6e 6f 2d 6f 70 20 6c 6f 63 6b 20 the no-op lock
10dd0 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a implementation *
10de0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10df0 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****.***********
10e00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e40 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a ***/../*********
10e50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e70 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10e90 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a *****.**********
10ea0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 ***************
10eb0 42 65 67 69 6e 20 64 6f 74 2d 66 69 6c 65 20 4c Begin dot-file L
10ec0 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a ocking *********
10ed0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
10ee0 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 *****.**.** The
10ef0 64 6f 74 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 dotfile locking
10f00 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 75 implementation u
10f10 73 65 73 20 74 68 65 20 65 78 69 73 74 65 6e 63 ses the existenc
10f20 65 20 6f 66 20 73 65 70 61 72 61 74 65 20 6c 6f e of separate lo
10f30 63 6b 0a 2a 2a 20 66 69 6c 65 73 20 28 72 65 61 ck.** files (rea
10f40 6c 6c 79 20 61 20 64 69 72 65 63 74 6f 72 79 29 lly a directory)
10f50 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 63 63 65 to control acce
10f60 73 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ss to the databa
10f70 73 65 2e 20 20 54 68 69 73 20 77 6f 72 6b 73 0a se. This works.
10f80 2a 2a 20 6f 6e 20 6a 75 73 74 20 61 62 6f 75 74 ** on just about
10f90 20 65 76 65 72 79 20 66 69 6c 65 73 79 73 74 65 every filesyste
10fa0 6d 20 69 6d 61 67 69 6e 61 62 6c 65 2e 20 20 42 m imaginable. B
10fb0 75 74 20 74 68 65 72 65 20 61 72 65 20 73 65 72 ut there are ser
10fc0 69 6f 75 73 20 64 6f 77 6e 73 69 64 65 73 3a 0a ious downsides:.
10fd0 2a 2a 0a 2a 2a 20 20 20 20 28 31 29 20 20 54 68 **.** (1) Th
10fe0 65 72 65 20 69 73 20 7a 65 72 6f 20 63 6f 6e 63 ere is zero conc
10ff0 75 72 72 65 6e 63 79 2e 20 20 41 20 73 69 6e 67 urrency. A sing
11000 6c 65 20 72 65 61 64 65 72 20 62 6c 6f 63 6b 73 le reader blocks
11010 20 61 6c 6c 20 6f 74 68 65 72 0a 2a 2a 20 20 20 all other.**
11020 20 20 20 20 20 20 63 6f 6e 6e 65 63 74 69 6f 6e connection
11030 73 20 66 72 6f 6d 20 72 65 61 64 69 6e 67 20 6f s from reading o
11040 72 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 r writing the da
11050 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 tabase..**.**
11060 20 28 32 29 20 20 41 6e 20 61 70 70 6c 69 63 61 (2) An applica
11070 74 69 6f 6e 20 63 72 61 73 68 20 6f 72 20 70 6f tion crash or po
11080 77 65 72 20 6c 6f 73 73 20 63 61 6e 20 6c 65 61 wer loss can lea
11090 76 65 20 73 74 61 6c 65 20 6c 6f 63 6b 20 66 69 ve stale lock fi
110a0 6c 65 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 73 les.** s
110b0 69 74 74 69 6e 67 20 61 72 6f 75 6e 64 20 74 68 itting around th
110c0 61 74 20 6e 65 65 64 20 74 6f 20 62 65 20 63 6c at need to be cl
110d0 65 61 72 65 64 20 6d 61 6e 75 61 6c 6c 79 2e 0a eared manually..
110e0 2a 2a 0a 2a 2a 20 4e 65 76 65 72 74 68 65 6c 65 **.** Neverthele
110f0 73 73 2c 20 61 20 64 6f 74 6c 6f 63 6b 20 69 73 ss, a dotlock is
11100 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 an appropriate
11110 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65 20 66 6f 72 locking mode for
11120 20 75 73 65 20 69 66 20 6e 6f 0a 2a 2a 20 6f 74 use if no.** ot
11130 68 65 72 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 her locking stra
11140 74 65 67 79 20 69 73 20 61 76 61 69 6c 61 62 6c tegy is availabl
11150 65 2e 0a 2a 2a 0a 2a 2a 20 44 6f 74 66 69 6c 65 e..**.** Dotfile
11160 20 6c 6f 63 6b 69 6e 67 20 77 6f 72 6b 73 20 62 locking works b
11170 79 20 63 72 65 61 74 69 6e 67 20 61 20 73 75 62 y creating a sub
11180 64 69 72 65 63 74 6f 72 79 20 69 6e 20 74 68 65 directory in the
11190 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 20 same directory
111a0 61 73 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 as.** the databa
111b0 73 65 20 61 6e 64 20 77 69 74 68 20 74 68 65 20 se and with the
111c0 73 61 6d 65 20 6e 61 6d 65 20 62 75 74 20 77 69 same name but wi
111d0 74 68 20 61 20 22 2e 6c 6f 63 6b 22 20 65 78 74 th a ".lock" ext
111e0 65 6e 73 69 6f 6e 20 61 64 64 65 64 2e 0a 2a 2a ension added..**
111f0 20 54 68 65 20 65 78 69 73 74 65 6e 63 65 20 6f The existence o
11200 66 20 61 20 6c 6f 63 6b 20 64 69 72 65 63 74 6f f a lock directo
11210 72 79 20 69 6d 70 6c 69 65 73 20 61 6e 20 45 58 ry implies an EX
11220 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 41 CLUSIVE lock. A
11230 6c 6c 20 6f 74 68 65 72 0a 2a 2a 20 6c 6f 63 6b ll other.** lock
11240 20 74 79 70 65 73 20 28 53 48 41 52 45 44 2c 20 types (SHARED,
11250 52 45 53 45 52 56 45 44 2c 20 50 45 4e 44 49 4e RESERVED, PENDIN
11260 47 29 20 61 72 65 20 6d 61 70 70 65 64 20 69 6e G) are mapped in
11270 74 6f 20 45 58 43 4c 55 53 49 56 45 2e 0a 2a 2f to EXCLUSIVE..*/
11280 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 69 6c 65 ../*.** The file
11290 20 73 75 66 66 69 78 20 61 64 64 65 64 20 74 6f suffix added to
112a0 20 74 68 65 20 64 61 74 61 20 62 61 73 65 20 66 the data base f
112b0 69 6c 65 6e 61 6d 65 20 69 6e 20 6f 72 64 65 72 ilename in order
112c0 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 0a 2a to create the.*
112d0 2a 20 6c 6f 63 6b 20 64 69 72 65 63 74 6f 72 79 * lock directory
112e0 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 44 4f 54 ..*/.#define DOT
112f0 4c 4f 43 4b 5f 53 55 46 46 49 58 20 22 2e 6c 6f LOCK_SUFFIX ".lo
11300 63 6b 22 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ck"../*.** This
11310 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 routine checks i
11320 66 20 74 68 65 72 65 20 69 73 20 61 20 52 45 53 f there is a RES
11330 45 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 20 ERVED lock held
11340 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 on the specified
11350 0a 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 73 .** file by this
11360 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 72 or any other pr
11370 6f 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 61 ocess. If such a
11380 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 73 lock is held, s
11390 65 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 74 et *pResOut.** t
113a0 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c o a non-zero val
113b0 75 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 52 ue otherwise *pR
113c0 65 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20 esOut is set to
113d0 7a 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 72 zero. The retur
113e0 6e 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 n value.** is se
113f0 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 75 t to SQLITE_OK u
11400 6e 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 72 nless an I/O err
11410 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 or occurs during
11420 20 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e 0a lock checking..
11430 2a 2a 0a 2a 2a 20 49 6e 20 64 6f 74 66 69 6c 65 **.** In dotfile
11440 20 6c 6f 63 6b 69 6e 67 2c 20 65 69 74 68 65 72 locking, either
11450 20 61 20 6c 6f 63 6b 20 65 78 69 73 74 73 20 6f a lock exists o
11460 72 20 69 74 20 64 6f 65 73 20 6e 6f 74 2e 20 20 r it does not.
11470 53 6f 20 69 6e 20 74 68 69 73 0a 2a 2a 20 76 61 So in this.** va
11480 72 69 61 74 69 6f 6e 20 6f 66 20 43 68 65 63 6b riation of Check
11490 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 29 2c 20 ReservedLock(),
114a0 2a 70 52 65 73 4f 75 74 20 69 73 20 73 65 74 20 *pResOut is set
114b0 74 6f 20 74 72 75 65 20 69 66 20 61 6e 79 20 6c to true if any l
114c0 6f 63 6b 0a 2a 2a 20 69 73 20 68 65 6c 64 20 6f ock.** is held o
114d0 6e 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 66 n the file and f
114e0 61 6c 73 65 20 69 66 20 74 68 65 20 66 69 6c 65 alse if the file
114f0 20 69 73 20 75 6e 6c 6f 63 6b 65 64 2e 0a 2a 2f is unlocked..*/
11500 0a 73 74 61 74 69 63 20 69 6e 74 20 64 6f 74 6c .static int dotl
11510 6f 63 6b 43 68 65 63 6b 52 65 73 65 72 76 65 64 ockCheckReserved
11520 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c Lock(sqlite3_fil
11530 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 e *id, int *pRes
11540 4f 75 74 29 20 7b 0a 20 20 69 6e 74 20 72 63 20 Out) {. int rc
11550 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
11560 6e 74 20 72 65 73 65 72 76 65 64 20 3d 20 30 3b nt reserved = 0;
11570 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 . unixFile *pFi
11580 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 le = (unixFile*)
11590 69 64 3b 0a 0a 20 20 53 69 6d 75 6c 61 74 65 49 id;.. SimulateI
115a0 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 53 OError( return S
115b0 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 QLITE_IOERR_CHEC
115c0 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 29 KRESERVEDLOCK; )
115d0 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 ;. . assert( p
115e0 46 69 6c 65 20 29 3b 0a 20 20 72 65 73 65 72 76 File );. reserv
115f0 65 64 20 3d 20 6f 73 41 63 63 65 73 73 28 28 63 ed = osAccess((c
11600 6f 6e 73 74 20 63 68 61 72 2a 29 70 46 69 6c 65 onst char*)pFile
11610 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 ->lockingContext
11620 2c 20 30 29 3d 3d 30 3b 0a 20 20 4f 53 54 52 41 , 0)==0;. OSTRA
11630 43 45 28 28 22 54 45 53 54 20 57 52 2d 4c 4f 43 CE(("TEST WR-LOC
11640 4b 20 25 64 20 25 64 20 25 64 20 28 64 6f 74 6c K %d %d %d (dotl
11650 6f 63 6b 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e ock)\n", pFile->
11660 68 2c 20 72 63 2c 20 72 65 73 65 72 76 65 64 29 h, rc, reserved)
11670 29 3b 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 );. *pResOut =
11680 72 65 73 65 72 76 65 64 3b 0a 20 20 72 65 74 75 reserved;. retu
11690 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
116a0 4c 6f 63 6b 20 74 68 65 20 66 69 6c 65 20 77 69 Lock the file wi
116b0 74 68 20 74 68 65 20 6c 6f 63 6b 20 73 70 65 63 th the lock spec
116c0 69 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 ified by paramet
116d0 65 72 20 65 46 69 6c 65 4c 6f 63 6b 20 2d 20 6f er eFileLock - o
116e0 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c ne.** of the fol
116f0 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 lowing:.**.**
11700 20 20 28 31 29 20 53 48 41 52 45 44 5f 4c 4f 43 (1) SHARED_LOC
11710 4b 0a 2a 2a 20 20 20 20 20 28 32 29 20 52 45 53 K.** (2) RES
11720 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 ERVED_LOCK.**
11730 20 20 28 33 29 20 50 45 4e 44 49 4e 47 5f 4c 4f (3) PENDING_LO
11740 43 4b 0a 2a 2a 20 20 20 20 20 28 34 29 20 45 58 CK.** (4) EX
11750 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a CLUSIVE_LOCK.**.
11760 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 68 65 ** Sometimes whe
11770 6e 20 72 65 71 75 65 73 74 69 6e 67 20 6f 6e 65 n requesting one
11780 20 6c 6f 63 6b 20 73 74 61 74 65 2c 20 61 64 64 lock state, add
11790 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 itional lock sta
117a0 74 65 73 0a 2a 2a 20 61 72 65 20 69 6e 73 65 72 tes.** are inser
117b0 74 65 64 20 69 6e 20 62 65 74 77 65 65 6e 2e 20 ted in between.
117c0 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 69 67 The locking mig
117d0 68 74 20 66 61 69 6c 20 6f 6e 20 6f 6e 65 20 6f ht fail on one o
117e0 66 20 74 68 65 20 6c 61 74 65 72 0a 2a 2a 20 74 f the later.** t
117f0 72 61 6e 73 69 74 69 6f 6e 73 20 6c 65 61 76 69 ransitions leavi
11800 6e 67 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74 ng the lock stat
11810 65 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d e different from
11820 20 77 68 61 74 20 69 74 20 73 74 61 72 74 65 64 what it started
11830 20 62 75 74 0a 2a 2a 20 73 74 69 6c 6c 20 73 68 but.** still sh
11840 6f 72 74 20 6f 66 20 69 74 73 20 67 6f 61 6c 2e ort of its goal.
11850 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 The following
11860 63 68 61 72 74 20 73 68 6f 77 73 20 74 68 65 20 chart shows the
11870 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 61 6e 73 allowed.** trans
11880 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 69 itions and the i
11890 6e 73 65 72 74 65 64 20 69 6e 74 65 72 6d 65 64 nserted intermed
118a0 69 61 74 65 20 73 74 61 74 65 73 3a 0a 2a 2a 0a iate states:.**.
118b0 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 44 20 2d ** UNLOCKED -
118c0 3e 20 53 48 41 52 45 44 0a 2a 2a 20 20 20 20 53 > SHARED.** S
118d0 48 41 52 45 44 20 2d 3e 20 52 45 53 45 52 56 45 HARED -> RESERVE
118e0 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d D.** SHARED -
118f0 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 > (PENDING) -> E
11900 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 52 XCLUSIVE.** R
11910 45 53 45 52 56 45 44 20 2d 3e 20 28 50 45 4e 44 ESERVED -> (PEND
11920 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 ING) -> EXCLUSIV
11930 45 0a 2a 2a 20 20 20 20 50 45 4e 44 49 4e 47 20 E.** PENDING
11940 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 0a -> EXCLUSIVE.**.
11950 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
11960 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 65 61 will only increa
11970 73 65 20 61 20 6c 6f 63 6b 2e 20 20 55 73 65 20 se a lock. Use
11980 74 68 65 20 73 71 6c 69 74 65 33 4f 73 55 6e 6c the sqlite3OsUnl
11990 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 ock().** routine
119a0 20 74 6f 20 6c 6f 77 65 72 20 61 20 6c 6f 63 6b to lower a lock
119b0 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a 2a 0a 2a 2a ing level..**.**
119c0 20 57 69 74 68 20 64 6f 74 66 69 6c 65 20 6c 6f With dotfile lo
119d0 63 6b 69 6e 67 2c 20 77 65 20 72 65 61 6c 6c 79 cking, we really
119e0 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 20 73 74 only support st
119f0 61 74 65 20 28 34 29 3a 20 45 58 43 4c 55 53 49 ate (4): EXCLUSI
11a00 56 45 2e 0a 2a 2a 20 42 75 74 20 77 65 20 74 72 VE..** But we tr
11a10 61 63 6b 20 74 68 65 20 6f 74 68 65 72 20 6c 6f ack the other lo
11a20 63 6b 69 6e 67 20 6c 65 76 65 6c 73 20 69 6e 74 cking levels int
11a30 65 72 6e 61 6c 6c 79 2e 0a 2a 2f 0a 73 74 61 74 ernally..*/.stat
11a40 69 63 20 69 6e 74 20 64 6f 74 6c 6f 63 6b 4c 6f ic int dotlockLo
11a50 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ck(sqlite3_file
11a60 2a 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f *id, int eFileLo
11a70 63 6b 29 20 7b 0a 20 20 75 6e 69 78 46 69 6c 65 ck) {. unixFile
11a80 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 *pFile = (unixF
11a90 69 6c 65 2a 29 69 64 3b 0a 20 20 63 68 61 72 20 ile*)id;. char
11aa0 2a 7a 4c 6f 63 6b 46 69 6c 65 20 3d 20 28 63 68 *zLockFile = (ch
11ab0 61 72 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b ar *)pFile->lock
11ac0 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 69 6e ingContext;. in
11ad0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
11ae0 3b 0a 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 68 ;... /* If we h
11af0 61 76 65 20 61 6e 79 20 6c 6f 63 6b 2c 20 74 68 ave any lock, th
11b00 65 6e 20 74 68 65 20 6c 6f 63 6b 20 66 69 6c 65 en the lock file
11b10 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 2e already exists.
11b20 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a 20 20 All we have.
11b30 2a 2a 20 74 6f 20 64 6f 20 69 73 20 61 64 6a 75 ** to do is adju
11b40 73 74 20 6f 75 72 20 69 6e 74 65 72 6e 61 6c 20 st our internal
11b50 72 65 63 6f 72 64 20 6f 66 20 74 68 65 20 6c 6f record of the lo
11b60 63 6b 20 6c 65 76 65 6c 2e 0a 20 20 2a 2f 0a 20 ck level.. */.
11b70 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c if( pFile->eFil
11b80 65 4c 6f 63 6b 20 3e 20 4e 4f 5f 4c 4f 43 4b 20 eLock > NO_LOCK
11b90 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 ){. pFile->eF
11ba0 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c ileLock = eFileL
11bb0 6f 63 6b 3b 0a 20 20 20 20 2f 2a 20 41 6c 77 61 ock;. /* Alwa
11bc0 79 73 20 75 70 64 61 74 65 20 74 68 65 20 74 69 ys update the ti
11bd0 6d 65 73 74 61 6d 70 20 6f 6e 20 74 68 65 20 6f mestamp on the o
11be0 6c 64 20 66 69 6c 65 20 2a 2f 0a 23 69 66 64 65 ld file */.#ifde
11bf0 66 20 48 41 56 45 5f 55 54 49 4d 45 0a 20 20 20 f HAVE_UTIME.
11c00 20 75 74 69 6d 65 28 7a 4c 6f 63 6b 46 69 6c 65 utime(zLockFile
11c10 2c 20 4e 55 4c 4c 29 3b 0a 23 65 6c 73 65 0a 20 , NULL);.#else.
11c20 20 20 20 75 74 69 6d 65 73 28 7a 4c 6f 63 6b 46 utimes(zLockF
11c30 69 6c 65 2c 20 4e 55 4c 4c 29 3b 0a 23 65 6e 64 ile, NULL);.#end
11c40 69 66 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 if. return SQ
11c50 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a LITE_OK;. }. .
11c60 20 20 2f 2a 20 67 72 61 62 20 61 6e 20 65 78 63 /* grab an exc
11c70 6c 75 73 69 76 65 20 6c 6f 63 6b 20 2a 2f 0a 20 lusive lock */.
11c80 20 72 63 20 3d 20 6f 73 4d 6b 64 69 72 28 7a 4c rc = osMkdir(zL
11c90 6f 63 6b 46 69 6c 65 2c 20 30 37 37 37 29 3b 0a ockFile, 0777);.
11ca0 20 20 69 66 28 20 72 63 3c 30 20 29 7b 0a 20 20 if( rc<0 ){.
11cb0 20 20 2f 2a 20 66 61 69 6c 65 64 20 74 6f 20 6f /* failed to o
11cc0 70 65 6e 2f 63 72 65 61 74 65 20 74 68 65 20 6c pen/create the l
11cd0 6f 63 6b 20 64 69 72 65 63 74 6f 72 79 20 2a 2f ock directory */
11ce0 0a 20 20 20 20 69 6e 74 20 74 45 72 72 6e 6f 20 . int tErrno
11cf0 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 69 66 28 = errno;. if(
11d00 20 45 45 58 49 53 54 20 3d 3d 20 74 45 72 72 6e EEXIST == tErrn
11d10 6f 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 o ){. rc =
11d20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
11d30 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 } else {.
11d40 72 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 rc = sqliteError
11d50 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 FromPosixError(t
11d60 45 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f Errno, SQLITE_IO
11d70 45 52 52 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 ERR_LOCK);.
11d80 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
11d90 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 BUSY ){.
11da0 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 storeLastErrno(p
11db0 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 File, tErrno);.
11dc0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
11dd0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 20 return rc;. }
11de0 0a 20 20 0a 20 20 2f 2a 20 67 6f 74 20 69 74 2c . . /* got it,
11df0 20 73 65 74 20 74 68 65 20 74 79 70 65 20 61 6e set the type an
11e00 64 20 72 65 74 75 72 6e 20 6f 6b 20 2a 2f 0a 20 d return ok */.
11e10 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
11e20 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 k = eFileLock;.
11e30 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
11e40 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c *.** Lower the l
11e50 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 ocking level on
11e60 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
11e70 70 46 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c 6f pFile to eFileLo
11e80 63 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a ck. eFileLock.*
11e90 2a 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 * must be either
11ea0 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 NO_LOCK or SHAR
11eb0 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 ED_LOCK..**.** I
11ec0 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 f the locking le
11ed0 76 65 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 vel of the file
11ee0 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c descriptor is al
11ef0 72 65 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f ready at or belo
11f00 77 0a 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 w.** the request
11f10 65 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c ed locking level
11f20 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 , this routine i
11f30 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a s a no-op..**.**
11f40 20 57 68 65 6e 20 74 68 65 20 6c 6f 63 6b 69 6e When the lockin
11f50 67 20 6c 65 76 65 6c 20 72 65 61 63 68 65 73 20 g level reaches
11f60 4e 4f 5f 4c 4f 43 4b 2c 20 64 65 6c 65 74 65 20 NO_LOCK, delete
11f70 74 68 65 20 6c 6f 63 6b 20 66 69 6c 65 2e 0a 2a the lock file..*
11f80 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 64 6f 74 /.static int dot
11f90 6c 6f 63 6b 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 lockUnlock(sqlit
11fa0 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 e3_file *id, int
11fb0 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 eFileLock) {.
11fc0 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 unixFile *pFile
11fd0 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b = (unixFile*)id;
11fe0 0a 20 20 63 68 61 72 20 2a 7a 4c 6f 63 6b 46 69 . char *zLockFi
11ff0 6c 65 20 3d 20 28 63 68 61 72 20 2a 29 70 46 69 le = (char *)pFi
12000 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 le->lockingConte
12010 78 74 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 xt;. int rc;..
12020 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 assert( pFile )
12030 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 55 4e ;. OSTRACE(("UN
12040 4c 4f 43 4b 20 20 25 64 20 25 64 20 77 61 73 20 LOCK %d %d was
12050 25 64 20 70 69 64 3d 25 64 20 28 64 6f 74 6c 6f %d pid=%d (dotlo
12060 63 6b 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 ck)\n", pFile->h
12070 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20 20 20 , eFileLock,.
12080 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 65 pFile->e
12090 46 69 6c 65 4c 6f 63 6b 2c 20 6f 73 47 65 74 70 FileLock, osGetp
120a0 69 64 28 30 29 29 29 3b 0a 20 20 61 73 73 65 72 id(0)));. asser
120b0 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 t( eFileLock<=SH
120c0 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 0a ARED_LOCK );. .
120d0 20 20 2f 2a 20 6e 6f 2d 6f 70 20 69 66 20 70 6f /* no-op if po
120e0 73 73 69 62 6c 65 20 2a 2f 0a 20 20 69 66 28 20 ssible */. if(
120f0 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
12100 3d 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 ==eFileLock ){.
12110 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
12120 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 _OK;. }.. /* T
12130 6f 20 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 73 o downgrade to s
12140 68 61 72 65 64 2c 20 73 69 6d 70 6c 79 20 75 70 hared, simply up
12150 64 61 74 65 20 6f 75 72 20 69 6e 74 65 72 6e 61 date our interna
12160 6c 20 6e 6f 74 69 6f 6e 20 6f 66 20 74 68 65 0a l notion of the.
12170 20 20 2a 2a 20 6c 6f 63 6b 20 73 74 61 74 65 2e ** lock state.
12180 20 20 4e 6f 20 6e 65 65 64 20 74 6f 20 6d 65 73 No need to mes
12190 73 20 77 69 74 68 20 74 68 65 20 66 69 6c 65 20 s with the file
121a0 6f 6e 20 64 69 73 6b 2e 0a 20 20 2a 2f 0a 20 20 on disk.. */.
121b0 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 if( eFileLock==S
121c0 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 HARED_LOCK ){.
121d0 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f pFile->eFileLo
121e0 63 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b ck = SHARED_LOCK
121f0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
12200 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a 20 ITE_OK;. }. .
12210 20 2f 2a 20 54 6f 20 66 75 6c 6c 79 20 75 6e 6c /* To fully unl
12220 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 ock the database
12230 2c 20 64 65 6c 65 74 65 20 74 68 65 20 6c 6f 63 , delete the loc
12240 6b 20 66 69 6c 65 20 2a 2f 0a 20 20 61 73 73 65 k file */. asse
12250 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 4e rt( eFileLock==N
12260 4f 5f 4c 4f 43 4b 20 29 3b 0a 20 20 72 63 20 3d O_LOCK );. rc =
12270 20 6f 73 52 6d 64 69 72 28 7a 4c 6f 63 6b 46 69 osRmdir(zLockFi
12280 6c 65 29 3b 0a 20 20 69 66 28 20 72 63 3c 30 20 le);. if( rc<0
12290 29 7b 0a 20 20 20 20 69 6e 74 20 74 45 72 72 6e ){. int tErrn
122a0 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 69 o = errno;. i
122b0 66 28 20 74 45 72 72 6e 6f 3d 3d 45 4e 4f 45 4e f( tErrno==ENOEN
122c0 54 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 T ){. rc =
122d0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
122e0 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d else{. rc =
122f0 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e SQLITE_IOERR_UN
12300 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 73 74 6f 72 LOCK;. stor
12310 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 eLastErrno(pFile
12320 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 7d , tErrno);. }
12330 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 20 . return rc;
12340 0a 20 20 7d 0a 20 20 70 46 69 6c 65 2d 3e 65 46 . }. pFile->eF
12350 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 ileLock = NO_LOC
12360 4b 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 K;. return SQLI
12370 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
12380 43 6c 6f 73 65 20 61 20 66 69 6c 65 2e 20 20 4d Close a file. M
12390 61 6b 65 20 73 75 72 65 20 74 68 65 20 6c 6f 63 ake sure the loc
123a0 6b 20 68 61 73 20 62 65 65 6e 20 72 65 6c 65 61 k has been relea
123b0 73 65 64 20 62 65 66 6f 72 65 20 63 6c 6f 73 69 sed before closi
123c0 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ng..*/.static in
123d0 74 20 64 6f 74 6c 6f 63 6b 43 6c 6f 73 65 28 73 t dotlockClose(s
123e0 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 qlite3_file *id)
123f0 20 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 {. unixFile *p
12400 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 File = (unixFile
12410 2a 29 69 64 3b 0a 20 20 61 73 73 65 72 74 28 20 *)id;. assert(
12420 69 64 21 3d 30 20 29 3b 0a 20 20 64 6f 74 6c 6f id!=0 );. dotlo
12430 63 6b 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f 5f ckUnlock(id, NO_
12440 4c 4f 43 4b 29 3b 0a 20 20 73 71 6c 69 74 65 33 LOCK);. sqlite3
12450 5f 66 72 65 65 28 70 46 69 6c 65 2d 3e 6c 6f 63 _free(pFile->loc
12460 6b 69 6e 67 43 6f 6e 74 65 78 74 29 3b 0a 20 20 kingContext);.
12470 72 65 74 75 72 6e 20 63 6c 6f 73 65 55 6e 69 78 return closeUnix
12480 46 69 6c 65 28 69 64 29 3b 0a 7d 0a 2f 2a 2a 2a File(id);.}./***
12490 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 ***************
124a0 45 6e 64 20 6f 66 20 74 68 65 20 64 6f 74 2d 66 End of the dot-f
124b0 69 6c 65 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 ile lock impleme
124c0 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a ntation ********
124d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a ***********.****
124e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
124f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12500 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12510 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12520 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a **********/../**
12530 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12540 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12550 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12560 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12570 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a ************.***
12580 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12590 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 66 6c ******* Begin fl
125a0 6f 63 6b 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a ock Locking ****
125b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
125c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a ************.**.
125d0 2a 2a 20 55 73 65 20 74 68 65 20 66 6c 6f 63 6b ** Use the flock
125e0 28 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 74 () system call t
125f0 6f 20 64 6f 20 66 69 6c 65 20 6c 6f 63 6b 69 6e o do file lockin
12600 67 2e 0a 2a 2a 0a 2a 2a 20 66 6c 6f 63 6b 28 29 g..**.** flock()
12610 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6c 69 6b 65 locking is like
12620 20 64 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 69 6e dot-file lockin
12630 67 20 69 6e 20 74 68 61 74 20 74 68 65 20 76 61 g in that the va
12640 72 69 6f 75 73 0a 2a 2a 20 66 69 6e 65 2d 67 72 rious.** fine-gr
12650 61 69 6e 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 ain locking leve
12660 6c 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 ls supported by
12670 53 51 4c 69 74 65 20 61 72 65 20 63 6f 6c 6c 61 SQLite are colla
12680 70 73 65 64 20 69 6e 74 6f 0a 2a 2a 20 61 20 73 psed into.** a s
12690 69 6e 67 6c 65 20 65 78 63 6c 75 73 69 76 65 20 ingle exclusive
126a0 6c 6f 63 6b 2e 20 20 49 6e 20 6f 74 68 65 72 20 lock. In other
126b0 77 6f 72 64 73 2c 20 53 48 41 52 45 44 2c 20 52 words, SHARED, R
126c0 45 53 45 52 56 45 44 2c 20 61 6e 64 0a 2a 2a 20 ESERVED, and.**
126d0 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 73 20 61 72 PENDING locks ar
126e0 65 20 74 68 65 20 73 61 6d 65 20 74 68 69 6e 67 e the same thing
126f0 20 61 73 20 61 6e 20 45 58 43 4c 55 53 49 56 45 as an EXCLUSIVE
12700 20 6c 6f 63 6b 2e 20 20 53 51 4c 69 74 65 0a 2a lock. SQLite.*
12710 2a 20 73 74 69 6c 6c 20 77 6f 72 6b 73 20 77 68 * still works wh
12720 65 6e 20 79 6f 75 20 64 6f 20 74 68 69 73 2c 20 en you do this,
12730 62 75 74 20 63 6f 6e 63 75 72 72 65 6e 63 79 20 but concurrency
12740 69 73 20 72 65 64 75 63 65 64 20 73 69 6e 63 65 is reduced since
12750 0a 2a 2a 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c .** only a singl
12760 65 20 70 72 6f 63 65 73 73 20 63 61 6e 20 62 65 e process can be
12770 20 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 reading the dat
12780 61 62 61 73 65 20 61 74 20 61 20 74 69 6d 65 2e abase at a time.
12790 0a 2a 2a 0a 2a 2a 20 4f 6d 69 74 20 74 68 69 73 .**.** Omit this
127a0 20 73 65 63 74 69 6f 6e 20 69 66 20 53 51 4c 49 section if SQLI
127b0 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e TE_ENABLE_LOCKIN
127c0 47 5f 53 54 59 4c 45 20 69 73 20 74 75 72 6e 65 G_STYLE is turne
127d0 64 20 6f 66 66 0a 2a 2f 0a 23 69 66 20 53 51 4c d off.*/.#if SQL
127e0 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 ITE_ENABLE_LOCKI
127f0 4e 47 5f 53 54 59 4c 45 0a 0a 2f 2a 0a 2a 2a 20 NG_STYLE../*.**
12800 52 65 74 72 79 20 66 6c 6f 63 6b 28 29 20 63 61 Retry flock() ca
12810 6c 6c 73 20 74 68 61 74 20 66 61 69 6c 20 77 69 lls that fail wi
12820 74 68 20 45 49 4e 54 52 0a 2a 2f 0a 23 69 66 64 th EINTR.*/.#ifd
12830 65 66 20 45 49 4e 54 52 0a 73 74 61 74 69 63 20 ef EINTR.static
12840 69 6e 74 20 72 6f 62 75 73 74 5f 66 6c 6f 63 6b int robust_flock
12850 28 69 6e 74 20 66 64 2c 20 69 6e 74 20 6f 70 29 (int fd, int op)
12860 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 64 6f {. int rc;. do
12870 7b 20 72 63 20 3d 20 66 6c 6f 63 6b 28 66 64 2c { rc = flock(fd,
12880 6f 70 29 3b 20 7d 77 68 69 6c 65 28 20 72 63 3c op); }while( rc<
12890 30 20 26 26 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 0 && errno==EINT
128a0 52 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 R );. return rc
128b0 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 ;.}.#else.# defi
128c0 6e 65 20 72 6f 62 75 73 74 5f 66 6c 6f 63 6b 28 ne robust_flock(
128d0 61 2c 62 29 20 66 6c 6f 63 6b 28 61 2c 62 29 0a a,b) flock(a,b).
128e0 23 65 6e 64 69 66 0a 20 20 20 20 20 0a 0a 2f 2a #endif. ../*
128f0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
12900 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 72 65 checks if there
12910 20 69 73 20 61 20 52 45 53 45 52 56 45 44 20 6c is a RESERVED l
12920 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 ock held on the
12930 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c specified.** fil
12940 65 20 62 79 20 74 68 69 73 20 6f 72 20 61 6e 79 e by this or any
12950 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 2e 20 other process.
12960 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 If such a lock i
12970 73 20 68 65 6c 64 2c 20 73 65 74 20 2a 70 52 65 s held, set *pRe
12980 73 4f 75 74 0a 2a 2a 20 74 6f 20 61 20 6e 6f 6e sOut.** to a non
12990 2d 7a 65 72 6f 20 76 61 6c 75 65 20 6f 74 68 65 -zero value othe
129a0 72 77 69 73 65 20 2a 70 52 65 73 4f 75 74 20 69 rwise *pResOut i
129b0 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 20 s set to zero.
129c0 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 The return value
129d0 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 53 51 .** is set to SQ
129e0 4c 49 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 20 61 LITE_OK unless a
129f0 6e 20 49 2f 4f 20 65 72 72 6f 72 20 6f 63 63 75 n I/O error occu
12a00 72 73 20 64 75 72 69 6e 67 20 6c 6f 63 6b 20 63 rs during lock c
12a10 68 65 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 hecking..*/.stat
12a20 69 63 20 69 6e 74 20 66 6c 6f 63 6b 43 68 65 63 ic int flockChec
12a30 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 kReservedLock(sq
12a40 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
12a50 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 7b 0a 20 int *pResOut){.
12a60 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
12a70 5f 4f 4b 3b 0a 20 20 69 6e 74 20 72 65 73 65 72 _OK;. int reser
12a80 76 65 64 20 3d 20 30 3b 0a 20 20 75 6e 69 78 46 ved = 0;. unixF
12a90 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e ile *pFile = (un
12aa0 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 0a 20 ixFile*)id;. .
12ab0 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 SimulateIOError
12ac0 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ( return SQLITE_
12ad0 49 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 IOERR_CHECKRESER
12ae0 56 45 44 4c 4f 43 4b 3b 20 29 3b 0a 20 20 0a 20 VEDLOCK; );. .
12af0 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 assert( pFile )
12b00 3b 0a 20 20 0a 20 20 2f 2a 20 43 68 65 63 6b 20 ;. . /* Check
12b10 69 66 20 61 20 74 68 72 65 61 64 20 69 6e 20 74 if a thread in t
12b20 68 69 73 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 his process hold
12b30 73 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 2a 2f s such a lock */
12b40 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 . if( pFile->eF
12b50 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c ileLock>SHARED_L
12b60 4f 43 4b 20 29 7b 0a 20 20 20 20 72 65 73 65 72 OCK ){. reser
12b70 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 0a ved = 1;. }. .
12b80 20 20 2f 2a 20 4f 74 68 65 72 77 69 73 65 20 73 /* Otherwise s
12b90 65 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 ee if some other
12ba0 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 69 process holds i
12bb0 74 2e 20 2a 2f 0a 20 20 69 66 28 20 21 72 65 73 t. */. if( !res
12bc0 65 72 76 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20 erved ){. /*
12bd0 61 74 74 65 6d 70 74 20 74 6f 20 67 65 74 20 74 attempt to get t
12be0 68 65 20 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 69 he lock */. i
12bf0 6e 74 20 6c 72 63 20 3d 20 72 6f 62 75 73 74 5f nt lrc = robust_
12c00 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e 68 2c 20 flock(pFile->h,
12c10 4c 4f 43 4b 5f 45 58 20 7c 20 4c 4f 43 4b 5f 4e LOCK_EX | LOCK_N
12c20 42 29 3b 0a 20 20 20 20 69 66 28 20 21 6c 72 63 B);. if( !lrc
12c30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 67 6f 74 ){. /* got
12c40 20 74 68 65 20 6c 6f 63 6b 2c 20 75 6e 6c 6f 63 the lock, unloc
12c50 6b 20 69 74 20 2a 2f 0a 20 20 20 20 20 20 6c 72 k it */. lr
12c60 63 20 3d 20 72 6f 62 75 73 74 5f 66 6c 6f 63 6b c = robust_flock
12c70 28 70 46 69 6c 65 2d 3e 68 2c 20 4c 4f 43 4b 5f (pFile->h, LOCK_
12c80 55 4e 29 3b 0a 20 20 20 20 20 20 69 66 20 28 20 UN);. if (
12c90 6c 72 63 20 29 20 7b 0a 20 20 20 20 20 20 20 20 lrc ) {.
12ca0 69 6e 74 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 int tErrno = err
12cb0 6e 6f 3b 0a 20 20 20 20 20 20 20 20 2f 2a 20 75 no;. /* u
12cc0 6e 6c 6f 63 6b 20 66 61 69 6c 65 64 20 77 69 74 nlock failed wit
12cd0 68 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 h an error */.
12ce0 20 20 20 20 20 20 6c 72 63 20 3d 20 53 51 4c 49 lrc = SQLI
12cf0 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b TE_IOERR_UNLOCK;
12d00 20 0a 20 20 20 20 20 20 20 20 73 74 6f 72 65 4c . storeL
12d10 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 astErrno(pFile,
12d20 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 20 tErrno);.
12d30 20 72 63 20 3d 20 6c 72 63 3b 0a 20 20 20 20 20 rc = lrc;.
12d40 20 7d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a }. } else {.
12d50 20 20 20 20 20 20 69 6e 74 20 74 45 72 72 6e 6f int tErrno
12d60 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 = errno;.
12d70 72 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 reserved = 1;.
12d80 20 20 20 20 2f 2a 20 73 6f 6d 65 6f 6e 65 20 65 /* someone e
12d90 6c 73 65 20 6d 69 67 68 74 20 68 61 76 65 20 69 lse might have i
12da0 74 20 72 65 73 65 72 76 65 64 20 2a 2f 0a 20 20 t reserved */.
12db0 20 20 20 20 6c 72 63 20 3d 20 73 71 6c 69 74 65 lrc = sqlite
12dc0 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 ErrorFromPosixEr
12dd0 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 ror(tErrno, SQLI
12de0 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 20 TE_IOERR_LOCK);
12df0 0a 20 20 20 20 20 20 69 66 28 20 49 53 5f 4c 4f . if( IS_LO
12e00 43 4b 5f 45 52 52 4f 52 28 6c 72 63 29 20 29 7b CK_ERROR(lrc) ){
12e10 0a 20 20 20 20 20 20 20 20 73 74 6f 72 65 4c 61 . storeLa
12e20 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 74 stErrno(pFile, t
12e30 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 Errno);.
12e40 72 63 20 3d 20 6c 72 63 3b 0a 20 20 20 20 20 20 rc = lrc;.
12e50 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 4f 53 }. }. }. OS
12e60 54 52 41 43 45 28 28 22 54 45 53 54 20 57 52 2d TRACE(("TEST WR-
12e70 4c 4f 43 4b 20 25 64 20 25 64 20 25 64 20 28 66 LOCK %d %d %d (f
12e80 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46 69 6c 65 2d lock)\n", pFile-
12e90 3e 68 2c 20 72 63 2c 20 72 65 73 65 72 76 65 64 >h, rc, reserved
12ea0 29 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ));..#ifdef SQLI
12eb0 54 45 5f 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f TE_IGNORE_FLOCK_
12ec0 4c 4f 43 4b 5f 45 52 52 4f 52 53 0a 20 20 69 66 LOCK_ERRORS. if
12ed0 28 20 28 72 63 20 26 20 53 51 4c 49 54 45 5f 49 ( (rc & SQLITE_I
12ee0 4f 45 52 52 29 20 3d 3d 20 53 51 4c 49 54 45 5f OERR) == SQLITE_
12ef0 49 4f 45 52 52 20 29 7b 0a 20 20 20 20 72 63 20 IOERR ){. rc
12f00 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
12f10 20 72 65 73 65 72 76 65 64 3d 31 3b 0a 20 20 7d reserved=1;. }
12f20 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
12f30 45 5f 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c E_IGNORE_FLOCK_L
12f40 4f 43 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20 20 OCK_ERRORS */.
12f50 2a 70 52 65 73 4f 75 74 20 3d 20 72 65 73 65 72 *pResOut = reser
12f60 76 65 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ved;. return rc
12f70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 ;.}../*.** Lock
12f80 74 68 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 the file with th
12f90 65 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 64 e lock specified
12fa0 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 65 46 by parameter eF
12fb0 69 6c 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a ileLock - one.**
12fc0 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
12fd0 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 g:.**.** (1)
12fe0 20 53 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 SHARED_LOCK.**
12ff0 20 20 20 20 28 32 29 20 52 45 53 45 52 56 45 44 (2) RESERVED
13000 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 _LOCK.** (3)
13010 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a PENDING_LOCK.**
13020 20 20 20 20 20 28 34 29 20 45 58 43 4c 55 53 49 (4) EXCLUSI
13030 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f VE_LOCK.**.** So
13040 6d 65 74 69 6d 65 73 20 77 68 65 6e 20 72 65 71 metimes when req
13050 75 65 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b uesting one lock
13060 20 73 74 61 74 65 2c 20 61 64 64 69 74 69 6f 6e state, addition
13070 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a al lock states.*
13080 2a 20 61 72 65 20 69 6e 73 65 72 74 65 64 20 69 * are inserted i
13090 6e 20 62 65 74 77 65 65 6e 2e 20 20 54 68 65 20 n between. The
130a0 6c 6f 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 locking might fa
130b0 69 6c 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 il on one of the
130c0 20 6c 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 later.** transi
130d0 74 69 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 tions leaving th
130e0 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 66 e lock state dif
130f0 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 ferent from what
13100 20 69 74 20 73 74 61 72 74 65 64 20 62 75 74 0a it started but.
13110 2a 2a 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f ** still short o
13120 66 20 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 f its goal. The
13130 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 following chart
13140 20 73 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 shows the allow
13150 65 64 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e ed.** transition
13160 73 20 61 6e 64 20 74 68 65 20 69 6e 73 65 72 74 s and the insert
13170 65 64 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 ed intermediate
13180 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 states:.**.**
13190 20 55 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 UNLOCKED -> SHA
131a0 52 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 RED.** SHARED
131b0 20 2d 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 -> RESERVED.**
131c0 20 20 20 53 48 41 52 45 44 20 2d 3e 20 28 50 45 SHARED -> (PE
131d0 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 NDING) -> EXCLUS
131e0 49 56 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 IVE.** RESERV
131f0 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 ED -> (PENDING)
13200 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 -> EXCLUSIVE.**
13210 20 20 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 PENDING -> EX
13220 43 4c 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 66 6c CLUSIVE.**.** fl
13230 6f 63 6b 28 29 20 6f 6e 6c 79 20 72 65 61 6c 6c ock() only reall
13240 79 20 73 75 70 70 6f 72 74 20 45 58 43 4c 55 53 y support EXCLUS
13250 49 56 45 20 6c 6f 63 6b 73 2e 20 20 57 65 20 74 IVE locks. We t
13260 72 61 63 6b 20 69 6e 74 65 72 6d 65 64 69 61 74 rack intermediat
13270 65 0a 2a 2a 20 6c 6f 63 6b 20 73 74 61 74 65 73 e.** lock states
13280 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 33 5f in the sqlite3_
13290 66 69 6c 65 20 73 74 72 75 63 74 75 72 65 2c 20 file structure,
132a0 62 75 74 20 61 6c 6c 20 6c 6f 63 6b 73 20 53 48 but all locks SH
132b0 41 52 45 44 20 6f 72 0a 2a 2a 20 61 62 6f 76 65 ARED or.** above
132c0 20 61 72 65 20 72 65 61 6c 6c 79 20 45 58 43 4c are really EXCL
132d0 55 53 49 56 45 20 6c 6f 63 6b 73 20 61 6e 64 20 USIVE locks and
132e0 65 78 63 6c 75 64 65 20 61 6c 6c 20 6f 74 68 65 exclude all othe
132f0 72 20 70 72 6f 63 65 73 73 65 73 20 66 72 6f 6d r processes from
13300 0a 2a 2a 20 61 63 63 65 73 73 20 74 68 65 20 66 .** access the f
13310 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 ile..**.** This
13320 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c routine will onl
13330 79 20 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 y increase a loc
13340 6b 2e 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 k. Use the sqli
13350 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a te3OsUnlock().**
13360 20 72 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 routine to lowe
13370 72 20 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 r a locking leve
13380 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 l..*/.static int
13390 20 66 6c 6f 63 6b 4c 6f 63 6b 28 73 71 6c 69 74 flockLock(sqlit
133a0 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 e3_file *id, int
133b0 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 eFileLock) {.
133c0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
133d0 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a OK;. unixFile *
133e0 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c pFile = (unixFil
133f0 65 2a 29 69 64 3b 0a 0a 20 20 61 73 73 65 72 74 e*)id;.. assert
13400 28 20 70 46 69 6c 65 20 29 3b 0a 0a 20 20 2f 2a ( pFile );.. /*
13410 20 69 66 20 77 65 20 61 6c 72 65 61 64 79 20 68 if we already h
13420 61 76 65 20 61 20 6c 6f 63 6b 2c 20 69 74 20 69 ave a lock, it i
13430 73 20 65 78 63 6c 75 73 69 76 65 2e 20 20 0a 20 s exclusive. .
13440 20 2a 2a 20 4a 75 73 74 20 61 64 6a 75 73 74 20 ** Just adjust
13450 6c 65 76 65 6c 20 61 6e 64 20 70 75 6e 74 20 6f level and punt o
13460 6e 20 6f 75 74 74 61 20 68 65 72 65 2e 20 2a 2f n outta here. */
13470 0a 20 20 69 66 20 28 70 46 69 6c 65 2d 3e 65 46 . if (pFile->eF
13480 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f 5f 4c 4f 43 ileLock > NO_LOC
13490 4b 29 20 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e K) {. pFile->
134a0 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c eFileLock = eFil
134b0 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 65 74 75 72 eLock;. retur
134c0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
134d0 0a 20 20 0a 20 20 2f 2a 20 67 72 61 62 20 61 6e . . /* grab an
134e0 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 exclusive lock
134f0 2a 2f 0a 20 20 0a 20 20 69 66 20 28 72 6f 62 75 */. . if (robu
13500 73 74 5f 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e st_flock(pFile->
13510 68 2c 20 4c 4f 43 4b 5f 45 58 20 7c 20 4c 4f 43 h, LOCK_EX | LOC
13520 4b 5f 4e 42 29 29 20 7b 0a 20 20 20 20 69 6e 74 K_NB)) {. int
13530 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b tErrno = errno;
13540 0a 20 20 20 20 2f 2a 20 64 69 64 6e 27 74 20 67 . /* didn't g
13550 65 74 2c 20 6d 75 73 74 20 62 65 20 62 75 73 79 et, must be busy
13560 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c */. rc = sql
13570 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 iteErrorFromPosi
13580 78 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 xError(tErrno, S
13590 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b QLITE_IOERR_LOCK
135a0 29 3b 0a 20 20 20 20 69 66 28 20 49 53 5f 4c 4f );. if( IS_LO
135b0 43 4b 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a CK_ERROR(rc) ){.
135c0 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 storeLastE
135d0 72 72 6e 6f 28 70 46 69 6c 65 2c 20 74 45 72 72 rrno(pFile, tErr
135e0 6e 6f 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 20 65 no);. }. } e
135f0 6c 73 65 20 7b 0a 20 20 20 20 2f 2a 20 67 6f 74 lse {. /* got
13600 20 69 74 2c 20 73 65 74 20 74 68 65 20 74 79 70 it, set the typ
13610 65 20 61 6e 64 20 72 65 74 75 72 6e 20 6f 6b 20 e and return ok
13620 2a 2f 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 */. pFile->eF
13630 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c ileLock = eFileL
13640 6f 63 6b 3b 0a 20 20 7d 0a 20 20 4f 53 54 52 41 ock;. }. OSTRA
13650 43 45 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 CE(("LOCK %d
13660 25 73 20 25 73 20 28 66 6c 6f 63 6b 29 5c 6e 22 %s %s (flock)\n"
13670 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 61 7a 46 69 , pFile->h, azFi
13680 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b leLock(eFileLock
13690 29 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 72 ), . r
136a0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 22 c==SQLITE_OK ? "
136b0 6f 6b 22 20 3a 20 22 66 61 69 6c 65 64 22 29 29 ok" : "failed"))
136c0 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
136d0 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43 IGNORE_FLOCK_LOC
136e0 4b 5f 45 52 52 4f 52 53 0a 20 20 69 66 28 20 28 K_ERRORS. if( (
136f0 72 63 20 26 20 53 51 4c 49 54 45 5f 49 4f 45 52 rc & SQLITE_IOER
13700 52 29 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f 45 R) == SQLITE_IOE
13710 52 52 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 RR ){. rc = S
13720 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a QLITE_BUSY;. }.
13730 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
13740 5f 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f _IGNORE_FLOCK_LO
13750 43 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20 20 72 CK_ERRORS */. r
13760 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
13770 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c 6f .** Lower the lo
13780 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 66 cking level on f
13790 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 70 ile descriptor p
137a0 46 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c 6f 63 File to eFileLoc
137b0 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a 2a k. eFileLock.**
137c0 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 must be either
137d0 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 NO_LOCK or SHARE
137e0 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 D_LOCK..**.** If
137f0 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 the locking lev
13800 65 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64 el of the file d
13810 65 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72 escriptor is alr
13820 65 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 eady at or below
13830 0a 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65 .** the requeste
13840 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c d locking level,
13850 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
13860 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 a no-op..*/.sta
13870 74 69 63 20 69 6e 74 20 66 6c 6f 63 6b 55 6e 6c tic int flockUnl
13880 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 ock(sqlite3_file
13890 20 2a 69 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c *id, int eFileL
138a0 6f 63 6b 29 20 7b 0a 20 20 75 6e 69 78 46 69 6c ock) {. unixFil
138b0 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 e *pFile = (unix
138c0 46 69 6c 65 2a 29 69 64 3b 0a 20 20 0a 20 20 61 File*)id;. . a
138d0 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a ssert( pFile );.
138e0 20 20 4f 53 54 52 41 43 45 28 28 22 55 4e 4c 4f OSTRACE(("UNLO
138f0 43 4b 20 20 25 64 20 25 64 20 77 61 73 20 25 64 CK %d %d was %d
13900 20 70 69 64 3d 25 64 20 28 66 6c 6f 63 6b 29 5c pid=%d (flock)\
13910 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 65 46 n", pFile->h, eF
13920 69 6c 65 4c 6f 63 6b 2c 0a 20 20 20 20 20 20 20 ileLock,.
13930 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 pFile->eFile
13940 4c 6f 63 6b 2c 20 6f 73 47 65 74 70 69 64 28 30 Lock, osGetpid(0
13950 29 29 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 )));. assert( e
13960 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 FileLock<=SHARED
13970 5f 4c 4f 43 4b 20 29 3b 0a 20 20 0a 20 20 2f 2a _LOCK );. . /*
13980 20 6e 6f 2d 6f 70 20 69 66 20 70 6f 73 73 69 62 no-op if possib
13990 6c 65 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c le */. if( pFil
139a0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 65 46 e->eFileLock==eF
139b0 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 72 ileLock ){. r
139c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
139d0 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 73 68 61 . }. . /* sha
139e0 72 65 64 20 63 61 6e 20 6a 75 73 74 20 62 65 20 red can just be
139f0 73 65 74 20 62 65 63 61 75 73 65 20 77 65 20 61 set because we a
13a00 6c 77 61 79 73 20 68 61 76 65 20 61 6e 20 65 78 lways have an ex
13a10 63 6c 75 73 69 76 65 20 2a 2f 0a 20 20 69 66 20 clusive */. if
13a20 28 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 (eFileLock==SHAR
13a30 45 44 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 70 ED_LOCK) {. p
13a40 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 File->eFileLock
13a50 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 = eFileLock;.
13a60 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
13a70 4b 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 6e K;. }. . /* n
13a80 6f 2c 20 72 65 61 6c 6c 79 2c 20 75 6e 6c 6f 63 o, really, unloc
13a90 6b 2e 20 2a 2f 0a 20 20 69 66 28 20 72 6f 62 75 k. */. if( robu
13aa0 73 74 5f 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e st_flock(pFile->
13ab0 68 2c 20 4c 4f 43 4b 5f 55 4e 29 20 29 7b 0a 23 h, LOCK_UN) ){.#
13ac0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 49 47 4e ifdef SQLITE_IGN
13ad0 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 ORE_FLOCK_LOCK_E
13ae0 52 52 4f 52 53 0a 20 20 20 20 72 65 74 75 72 6e RRORS. return
13af0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 SQLITE_OK;.#end
13b00 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 49 47 4e if /* SQLITE_IGN
13b10 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 ORE_FLOCK_LOCK_E
13b20 52 52 4f 52 53 20 2a 2f 0a 20 20 20 20 72 65 74 RRORS */. ret
13b30 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
13b40 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 7d 65 6c 73 65 _UNLOCK;. }else
13b50 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 {. pFile->eFi
13b60 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 4b leLock = NO_LOCK
13b70 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
13b80 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a 2f ITE_OK;. }.}../
13b90 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c *.** Close a fil
13ba0 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
13bb0 20 66 6c 6f 63 6b 43 6c 6f 73 65 28 73 71 6c 69 flockClose(sqli
13bc0 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 20 7b 0a te3_file *id) {.
13bd0 20 20 61 73 73 65 72 74 28 20 69 64 21 3d 30 20 assert( id!=0
13be0 29 3b 0a 20 20 66 6c 6f 63 6b 55 6e 6c 6f 63 6b );. flockUnlock
13bf0 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 (id, NO_LOCK);.
13c00 20 72 65 74 75 72 6e 20 63 6c 6f 73 65 55 6e 69 return closeUni
13c10 78 46 69 6c 65 28 69 64 29 3b 0a 7d 0a 0a 23 65 xFile(id);.}..#e
13c20 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 ndif /* SQLITE_E
13c30 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
13c40 59 4c 45 20 26 26 20 21 4f 53 5f 56 58 57 4f 52 YLE && !OS_VXWOR
13c50 4b 20 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a K */../*********
13c60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f ********** End o
13c70 66 20 74 68 65 20 66 6c 6f 63 6b 20 6c 6f 63 6b f the flock lock
13c80 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
13c90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13ca0 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a *****.**********
13cb0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13cc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13cd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13ce0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13cf0 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a ****/../********
13d00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13d10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13d20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13d30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13d40 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ******.*********
13d50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 ***************
13d60 42 65 67 69 6e 20 4e 61 6d 65 64 20 53 65 6d 61 Begin Named Sema
13d70 70 68 6f 72 65 20 4c 6f 63 6b 69 6e 67 20 2a 2a phore Locking **
13d80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
13d90 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 4e 61 6d ******.**.** Nam
13da0 65 64 20 73 65 6d 61 70 68 6f 72 65 20 6c 6f 63 ed semaphore loc
13db0 6b 69 6e 67 20 69 73 20 6f 6e 6c 79 20 73 75 70 king is only sup
13dc0 70 6f 72 74 65 64 20 6f 6e 20 56 78 57 6f 72 6b ported on VxWork
13dd0 73 2e 0a 2a 2a 0a 2a 2a 20 53 65 6d 61 70 68 6f s..**.** Semapho
13de0 72 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6c 69 re locking is li
13df0 6b 65 20 64 6f 74 2d 6c 6f 63 6b 20 61 6e 64 20 ke dot-lock and
13e00 66 6c 6f 63 6b 20 69 6e 20 74 68 61 74 20 69 74 flock in that it
13e10 20 72 65 61 6c 6c 79 20 6f 6e 6c 79 0a 2a 2a 20 really only.**
13e20 73 75 70 70 6f 72 74 73 20 45 58 43 4c 55 53 49 supports EXCLUSI
13e30 56 45 20 6c 6f 63 6b 69 6e 67 2e 20 20 4f 6e 6c VE locking. Onl
13e40 79 20 61 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 y a single proce
13e50 73 73 20 63 61 6e 20 72 65 61 64 20 6f 72 20 77 ss can read or w
13e60 72 69 74 65 0a 2a 2a 20 74 68 65 20 64 61 74 61 rite.** the data
13e70 62 61 73 65 20 66 69 6c 65 20 61 74 20 61 20 74 base file at a t
13e80 69 6d 65 2e 20 20 54 68 69 73 20 72 65 64 75 63 ime. This reduc
13e90 65 73 20 70 6f 74 65 6e 74 69 61 6c 20 63 6f 6e es potential con
13ea0 63 75 72 72 65 6e 63 79 2c 20 62 75 74 0a 2a 2a currency, but.**
13eb0 20 6d 61 6b 65 73 20 74 68 65 20 6c 6f 63 6b 20 makes the lock
13ec0 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d implementation m
13ed0 75 63 68 20 65 61 73 69 65 72 2e 0a 2a 2f 0a 23 uch easier..*/.#
13ee0 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 0a 2f if OS_VXWORKS../
13ef0 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
13f00 65 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 72 e checks if ther
13f10 65 20 69 73 20 61 20 52 45 53 45 52 56 45 44 20 e is a RESERVED
13f20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 lock held on the
13f30 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 specified.** fi
13f40 6c 65 20 62 79 20 74 68 69 73 20 6f 72 20 61 6e le by this or an
13f50 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 2e y other process.
13f60 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 If such a lock
13f70 69 73 20 68 65 6c 64 2c 20 73 65 74 20 2a 70 52 is held, set *pR
13f80 65 73 4f 75 74 0a 2a 2a 20 74 6f 20 61 20 6e 6f esOut.** to a no
13f90 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 20 6f 74 68 n-zero value oth
13fa0 65 72 77 69 73 65 20 2a 70 52 65 73 4f 75 74 20 erwise *pResOut
13fb0 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 is set to zero.
13fc0 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 The return valu
13fd0 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 53 e.** is set to S
13fe0 51 4c 49 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 20 QLITE_OK unless
13ff0 61 6e 20 49 2f 4f 20 65 72 72 6f 72 20 6f 63 63 an I/O error occ
14000 75 72 73 20 64 75 72 69 6e 67 20 6c 6f 63 6b 20 urs during lock
14010 63 68 65 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 checking..*/.sta
14020 74 69 63 20 69 6e 74 20 73 65 6d 58 43 68 65 63 tic int semXChec
14030 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 kReservedLock(sq
14040 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
14050 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 20 7b 0a int *pResOut) {.
14060 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
14070 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 72 65 73 65 E_OK;. int rese
14080 72 76 65 64 20 3d 20 30 3b 0a 20 20 75 6e 69 78 rved = 0;. unix
14090 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 File *pFile = (u
140a0 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 0a 20 20 nixFile*)id;..
140b0 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 SimulateIOError(
140c0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
140d0 4f 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 56 OERR_CHECKRESERV
140e0 45 44 4c 4f 43 4b 3b 20 29 3b 0a 20 20 0a 20 20 EDLOCK; );. .
140f0 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b assert( pFile );
14100 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 .. /* Check if
14110 61 20 74 68 72 65 61 64 20 69 6e 20 74 68 69 73 a thread in this
14120 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 73 process holds s
14130 75 63 68 20 61 20 6c 6f 63 6b 20 2a 2f 0a 20 20 uch a lock */.
14140 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 if( pFile->eFile
14150 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b Lock>SHARED_LOCK
14160 20 29 7b 0a 20 20 20 20 72 65 73 65 72 76 65 64 ){. reserved
14170 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f = 1;. }. . /
14180 2a 20 4f 74 68 65 72 77 69 73 65 20 73 65 65 20 * Otherwise see
14190 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 if some other pr
141a0 6f 63 65 73 73 20 68 6f 6c 64 73 20 69 74 2e 20 ocess holds it.
141b0 2a 2f 0a 20 20 69 66 28 20 21 72 65 73 65 72 76 */. if( !reserv
141c0 65 64 20 29 7b 0a 20 20 20 20 73 65 6d 5f 74 20 ed ){. sem_t
141d0 2a 70 53 65 6d 20 3d 20 70 46 69 6c 65 2d 3e 70 *pSem = pFile->p
141e0 49 6e 6f 64 65 2d 3e 70 53 65 6d 3b 0a 0a 20 20 Inode->pSem;..
141f0 20 20 69 66 28 20 73 65 6d 5f 74 72 79 77 61 69 if( sem_trywai
14200 74 28 70 53 65 6d 29 3d 3d 2d 31 20 29 7b 0a 20 t(pSem)==-1 ){.
14210 20 20 20 20 20 69 6e 74 20 74 45 72 72 6e 6f 20 int tErrno
14220 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 69 = errno;. i
14230 66 28 20 45 41 47 41 49 4e 20 21 3d 20 74 45 72 f( EAGAIN != tEr
14240 72 6e 6f 20 29 7b 0a 20 20 20 20 20 20 20 20 72 rno ){. r
14250 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 c = sqliteErrorF
14260 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 romPosixError(tE
14270 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 rrno, SQLITE_IOE
14280 52 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 RR_CHECKRESERVED
14290 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 20 20 73 LOCK);. s
142a0 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 toreLastErrno(pF
142b0 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20 ile, tErrno);.
142c0 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 } else {.
142d0 20 20 20 20 20 2f 2a 20 73 6f 6d 65 6f 6e 65 20 /* someone
142e0 65 6c 73 65 20 68 61 73 20 74 68 65 20 6c 6f 63 else has the loc
142f0 6b 20 77 68 65 6e 20 77 65 20 61 72 65 20 69 6e k when we are in
14300 20 4e 4f 5f 4c 4f 43 4b 20 2a 2f 0a 20 20 20 20 NO_LOCK */.
14310 20 20 20 20 72 65 73 65 72 76 65 64 20 3d 20 28 reserved = (
14320 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
14330 20 3c 20 53 48 41 52 45 44 5f 4c 4f 43 4b 29 3b < SHARED_LOCK);
14340 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
14350 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 77 65 20 se{. /* we
14360 63 6f 75 6c 64 20 68 61 76 65 20 69 74 20 69 66 could have it if
14370 20 77 65 20 77 61 6e 74 20 69 74 20 2a 2f 0a 20 we want it */.
14380 20 20 20 20 20 73 65 6d 5f 70 6f 73 74 28 70 53 sem_post(pS
14390 65 6d 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 em);. }. }.
143a0 20 4f 53 54 52 41 43 45 28 28 22 54 45 53 54 20 OSTRACE(("TEST
143b0 57 52 2d 4c 4f 43 4b 20 25 64 20 25 64 20 25 64 WR-LOCK %d %d %d
143c0 20 28 73 65 6d 29 5c 6e 22 2c 20 70 46 69 6c 65 (sem)\n", pFile
143d0 2d 3e 68 2c 20 72 63 2c 20 72 65 73 65 72 76 65 ->h, rc, reserve
143e0 64 29 29 3b 0a 0a 20 20 2a 70 52 65 73 4f 75 74 d));.. *pResOut
143f0 20 3d 20 72 65 73 65 72 76 65 64 3b 0a 20 20 72 = reserved;. r
14400 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
14410 2a 2a 20 4c 6f 63 6b 20 74 68 65 20 66 69 6c 65 ** Lock the file
14420 20 77 69 74 68 20 74 68 65 20 6c 6f 63 6b 20 73 with the lock s
14430 70 65 63 69 66 69 65 64 20 62 79 20 70 61 72 61 pecified by para
14440 6d 65 74 65 72 20 65 46 69 6c 65 4c 6f 63 6b 20 meter eFileLock
14450 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20 - one.** of the
14460 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a following:.**.**
14470 20 20 20 20 20 28 31 29 20 53 48 41 52 45 44 5f (1) SHARED_
14480 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 32 29 20 LOCK.** (2)
14490 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a RESERVED_LOCK.**
144a0 20 20 20 20 20 28 33 29 20 50 45 4e 44 49 4e 47 (3) PENDING
144b0 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 34 29 _LOCK.** (4)
144c0 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a EXCLUSIVE_LOCK.
144d0 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 **.** Sometimes
144e0 77 68 65 6e 20 72 65 71 75 65 73 74 69 6e 67 20 when requesting
144f0 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 74 65 2c 20 one lock state,
14500 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 additional lock
14510 73 74 61 74 65 73 0a 2a 2a 20 61 72 65 20 69 6e states.** are in
14520 73 65 72 74 65 64 20 69 6e 20 62 65 74 77 65 65 serted in betwee
14530 6e 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 n. The locking
14540 6d 69 67 68 74 20 66 61 69 6c 20 6f 6e 20 6f 6e might fail on on
14550 65 20 6f 66 20 74 68 65 20 6c 61 74 65 72 0a 2a e of the later.*
14560 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 6c 65 * transitions le
14570 61 76 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20 73 aving the lock s
14580 74 61 74 65 20 64 69 66 66 65 72 65 6e 74 20 66 tate different f
14590 72 6f 6d 20 77 68 61 74 20 69 74 20 73 74 61 72 rom what it star
145a0 74 65 64 20 62 75 74 0a 2a 2a 20 73 74 69 6c 6c ted but.** still
145b0 20 73 68 6f 72 74 20 6f 66 20 69 74 73 20 67 6f short of its go
145c0 61 6c 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 al. The followi
145d0 6e 67 20 63 68 61 72 74 20 73 68 6f 77 73 20 74 ng chart shows t
145e0 68 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 he allowed.** tr
145f0 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 ansitions and th
14600 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 65 72 e inserted inter
14610 6d 65 64 69 61 74 65 20 73 74 61 74 65 73 3a 0a mediate states:.
14620 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 **.** UNLOCKE
14630 44 20 2d 3e 20 53 48 41 52 45 44 0a 2a 2a 20 20 D -> SHARED.**
14640 20 20 53 48 41 52 45 44 20 2d 3e 20 52 45 53 45 SHARED -> RESE
14650 52 56 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 RVED.** SHARE
14660 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d D -> (PENDING) -
14670 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 > EXCLUSIVE.**
14680 20 20 52 45 53 45 52 56 45 44 20 2d 3e 20 28 50 RESERVED -> (P
14690 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 ENDING) -> EXCLU
146a0 53 49 56 45 0a 2a 2a 20 20 20 20 50 45 4e 44 49 SIVE.** PENDI
146b0 4e 47 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a NG -> EXCLUSIVE.
146c0 2a 2a 0a 2a 2a 20 53 65 6d 61 70 68 6f 72 65 20 **.** Semaphore
146d0 6c 6f 63 6b 73 20 6f 6e 6c 79 20 72 65 61 6c 6c locks only reall
146e0 79 20 73 75 70 70 6f 72 74 20 45 58 43 4c 55 53 y support EXCLUS
146f0 49 56 45 20 6c 6f 63 6b 73 2e 20 20 57 65 20 74 IVE locks. We t
14700 72 61 63 6b 20 69 6e 74 65 72 6d 65 64 69 61 74 rack intermediat
14710 65 0a 2a 2a 20 6c 6f 63 6b 20 73 74 61 74 65 73 e.** lock states
14720 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 33 5f in the sqlite3_
14730 66 69 6c 65 20 73 74 72 75 63 74 75 72 65 2c 20 file structure,
14740 62 75 74 20 61 6c 6c 20 6c 6f 63 6b 73 20 53 48 but all locks SH
14750 41 52 45 44 20 6f 72 0a 2a 2a 20 61 62 6f 76 65 ARED or.** above
14760 20 61 72 65 20 72 65 61 6c 6c 79 20 45 58 43 4c are really EXCL
14770 55 53 49 56 45 20 6c 6f 63 6b 73 20 61 6e 64 20 USIVE locks and
14780 65 78 63 6c 75 64 65 20 61 6c 6c 20 6f 74 68 65 exclude all othe
14790 72 20 70 72 6f 63 65 73 73 65 73 20 66 72 6f 6d r processes from
147a0 0a 2a 2a 20 61 63 63 65 73 73 20 74 68 65 20 66 .** access the f
147b0 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 ile..**.** This
147c0 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c routine will onl
147d0 79 20 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 y increase a loc
147e0 6b 2e 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 k. Use the sqli
147f0 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a te3OsUnlock().**
14800 20 72 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 routine to lowe
14810 72 20 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 r a locking leve
14820 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 l..*/.static int
14830 20 73 65 6d 58 4c 6f 63 6b 28 73 71 6c 69 74 65 semXLock(sqlite
14840 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 3_file *id, int
14850 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 75 eFileLock) {. u
14860 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d nixFile *pFile =
14870 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a (unixFile*)id;.
14880 20 20 73 65 6d 5f 74 20 2a 70 53 65 6d 20 3d 20 sem_t *pSem =
14890 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 pFile->pInode->p
148a0 53 65 6d 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 Sem;. int rc =
148b0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a SQLITE_OK;.. /*
148c0 20 69 66 20 77 65 20 61 6c 72 65 61 64 79 20 68 if we already h
148d0 61 76 65 20 61 20 6c 6f 63 6b 2c 20 69 74 20 69 ave a lock, it i
148e0 73 20 65 78 63 6c 75 73 69 76 65 2e 20 20 0a 20 s exclusive. .
148f0 20 2a 2a 20 4a 75 73 74 20 61 64 6a 75 73 74 20 ** Just adjust
14900 6c 65 76 65 6c 20 61 6e 64 20 70 75 6e 74 20 6f level and punt o
14910 6e 20 6f 75 74 74 61 20 68 65 72 65 2e 20 2a 2f n outta here. */
14920 0a 20 20 69 66 20 28 70 46 69 6c 65 2d 3e 65 46 . if (pFile->eF
14930 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f 5f 4c 4f 43 ileLock > NO_LOC
14940 4b 29 20 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e K) {. pFile->
14950 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c eFileLock = eFil
14960 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 63 20 3d 20 eLock;. rc =
14970 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 67 SQLITE_OK;. g
14980 6f 74 6f 20 73 65 6d 5f 65 6e 64 5f 6c 6f 63 6b oto sem_end_lock
14990 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 6c 6f ;. }. . /* lo
149a0 63 6b 20 73 65 6d 61 70 68 6f 72 65 20 6e 6f 77 ck semaphore now
149b0 20 62 75 74 20 62 61 69 6c 20 6f 75 74 20 77 68 but bail out wh
149c0 65 6e 20 61 6c 72 65 61 64 79 20 6c 6f 63 6b 65 en already locke
149d0 64 2e 20 2a 2f 0a 20 20 69 66 28 20 73 65 6d 5f d. */. if( sem_
149e0 74 72 79 77 61 69 74 28 70 53 65 6d 29 3d 3d 2d trywait(pSem)==-
149f0 31 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 1 ){. rc = SQ
14a00 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 67 LITE_BUSY;. g
14a10 6f 74 6f 20 73 65 6d 5f 65 6e 64 5f 6c 6f 63 6b oto sem_end_lock
14a20 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 67 6f 74 20 ;. }.. /* got
14a30 69 74 2c 20 73 65 74 20 74 68 65 20 74 79 70 65 it, set the type
14a40 20 61 6e 64 20 72 65 74 75 72 6e 20 6f 6b 20 2a and return ok *
14a50 2f 0a 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 /. pFile->eFile
14a60 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b Lock = eFileLock
14a70 3b 0a 0a 20 73 65 6d 5f 65 6e 64 5f 6c 6f 63 6b ;.. sem_end_lock
14a80 3a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d :. return rc;.}
14a90 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 ../*.** Lower th
14aa0 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 e locking level
14ab0 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 on file descript
14ac0 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46 69 6c or pFile to eFil
14ad0 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c 6f 63 eLock. eFileLoc
14ae0 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 69 74 k.** must be eit
14af0 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 her NO_LOCK or S
14b00 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a HARED_LOCK..**.*
14b10 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 * If the locking
14b20 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 66 69 level of the fi
14b30 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 le descriptor is
14b40 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72 20 62 already at or b
14b50 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65 71 75 elow.** the requ
14b60 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 ested locking le
14b70 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74 69 6e vel, this routin
14b80 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f e is a no-op..*/
14b90 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65 6d 58 .static int semX
14ba0 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 Unlock(sqlite3_f
14bb0 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65 46 69 ile *id, int eFi
14bc0 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 75 6e 69 78 leLock) {. unix
14bd0 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 File *pFile = (u
14be0 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 73 nixFile*)id;. s
14bf0 65 6d 5f 74 20 2a 70 53 65 6d 20 3d 20 70 46 69 em_t *pSem = pFi
14c00 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 6d le->pInode->pSem
14c10 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 ;.. assert( pFi
14c20 6c 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 le );. assert(
14c30 70 53 65 6d 20 29 3b 0a 20 20 4f 53 54 52 41 43 pSem );. OSTRAC
14c40 45 28 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25 E(("UNLOCK %d %
14c50 64 20 77 61 73 20 25 64 20 70 69 64 3d 25 64 20 d was %d pid=%d
14c60 28 73 65 6d 29 5c 6e 22 2c 20 70 46 69 6c 65 2d (sem)\n", pFile-
14c70 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20 >h, eFileLock,.
14c80 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d pFile-
14c90 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 6f 73 47 65 >eFileLock, osGe
14ca0 74 70 69 64 28 30 29 29 29 3b 0a 20 20 61 73 73 tpid(0)));. ass
14cb0 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d ert( eFileLock<=
14cc0 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 SHARED_LOCK );.
14cd0 20 0a 20 20 2f 2a 20 6e 6f 2d 6f 70 20 69 66 20 . /* no-op if
14ce0 70 6f 73 73 69 62 6c 65 20 2a 2f 0a 20 20 69 66 possible */. if
14cf0 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f ( pFile->eFileLo
14d00 63 6b 3d 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b ck==eFileLock ){
14d10 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
14d20 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a 20 20 TE_OK;. }. .
14d30 2f 2a 20 73 68 61 72 65 64 20 63 61 6e 20 6a 75 /* shared can ju
14d40 73 74 20 62 65 20 73 65 74 20 62 65 63 61 75 73 st be set becaus
14d50 65 20 77 65 20 61 6c 77 61 79 73 20 68 61 76 65 e we always have
14d60 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 2a 2f an exclusive */
14d70 0a 20 20 69 66 20 28 65 46 69 6c 65 4c 6f 63 6b . if (eFileLock
14d80 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 29 20 7b ==SHARED_LOCK) {
14d90 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c . pFile->eFil
14da0 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 eLock = eFileLoc
14db0 6b 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 k;. return SQ
14dc0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a LITE_OK;. }. .
14dd0 20 20 2f 2a 20 6e 6f 2c 20 72 65 61 6c 6c 79 20 /* no, really
14de0 75 6e 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 69 66 20 unlock. */. if
14df0 28 20 73 65 6d 5f 70 6f 73 74 28 70 53 65 6d 29 ( sem_post(pSem)
14e00 3d 3d 2d 31 20 29 20 7b 0a 20 20 20 20 69 6e 74 ==-1 ) {. int
14e10 20 72 63 2c 20 74 45 72 72 6e 6f 20 3d 20 65 72 rc, tErrno = er
14e20 72 6e 6f 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 rno;. rc = sq
14e30 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 liteErrorFromPos
14e40 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 ixError(tErrno,
14e50 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c SQLITE_IOERR_UNL
14e60 4f 43 4b 29 3b 0a 20 20 20 20 69 66 28 20 49 53 OCK);. if( IS
14e70 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 72 63 29 20 _LOCK_ERROR(rc)
14e80 29 7b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61 ){. storeLa
14e90 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 74 stErrno(pFile, t
14ea0 45 72 72 6e 6f 29 3b 0a 20 20 20 20 7d 0a 20 20 Errno);. }.
14eb0 20 20 72 65 74 75 72 6e 20 72 63 3b 20 0a 20 20 return rc; .
14ec0 7d 0a 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 }. pFile->eFile
14ed0 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a Lock = NO_LOCK;.
14ee0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
14ef0 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 20 2a 2a 20 43 6c OK;.}../*. ** Cl
14f00 6f 73 65 20 61 20 66 69 6c 65 2e 0a 20 2a 2f 0a ose a file.. */.
14f10 73 74 61 74 69 63 20 69 6e 74 20 73 65 6d 58 43 static int semXC
14f20 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c lose(sqlite3_fil
14f30 65 20 2a 69 64 29 20 7b 0a 20 20 69 66 28 20 69 e *id) {. if( i
14f40 64 20 29 7b 0a 20 20 20 20 75 6e 69 78 46 69 6c d ){. unixFil
14f50 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 e *pFile = (unix
14f60 46 69 6c 65 2a 29 69 64 3b 0a 20 20 20 20 73 65 File*)id;. se
14f70 6d 58 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f 5f mXUnlock(id, NO_
14f80 4c 4f 43 4b 29 3b 0a 20 20 20 20 61 73 73 65 72 LOCK);. asser
14f90 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 t( pFile );.
14fa0 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 unixEnterMutex()
14fb0 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 49 6e 6f ;. releaseIno
14fc0 64 65 49 6e 66 6f 28 70 46 69 6c 65 29 3b 0a 20 deInfo(pFile);.
14fd0 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 unixLeaveMute
14fe0 78 28 29 3b 0a 20 20 20 20 63 6c 6f 73 65 55 6e x();. closeUn
14ff0 69 78 46 69 6c 65 28 69 64 29 3b 0a 20 20 7d 0a ixFile(id);. }.
15000 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
15010 4f 4b 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a OK;.}..#endif /*
15020 20 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f 0a 2f OS_VXWORKS */./
15030 2a 0a 2a 2a 20 4e 61 6d 65 64 20 73 65 6d 61 70 *.** Named semap
15040 68 6f 72 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 hore locking is
15050 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 6f only available o
15060 6e 20 56 78 57 6f 72 6b 73 2e 0a 2a 2a 0a 2a 2a n VxWorks..**.**
15070 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e ************* En
15080 64 20 6f 66 20 74 68 65 20 6e 61 6d 65 64 20 73 d of the named s
15090 65 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 20 69 6d emaphore lock im
150a0 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a 2a plementation ***
150b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a *************.**
150c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
150d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
150e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
150f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
15100 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 0a ************/...
15110 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a /***************
15120 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
15130 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
15140 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
15150 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a ***************.
15160 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
15170 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 *********** Begi
15180 6e 20 41 46 50 20 4c 6f 63 6b 69 6e 67 20 2a 2a n AFP Locking **
15190 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
151a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a ***************.
151b0 2a 2a 0a 2a 2a 20 41 46 50 20 69 73 20 74 68 65 **.** AFP is the
151c0 20 41 70 70 6c 65 20 46 69 6c 69 6e 67 20 50 72 Apple Filing Pr
151d0 6f 74 6f 63 6f 6c 2e 20 20 41 46 50 20 69 73 20 otocol. AFP is
151e0 61 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 73 79 a network filesy
151f0 73 74 65 6d 20 66 6f 75 6e 64 0a 2a 2a 20 6f 6e stem found.** on
15200 20 41 70 70 6c 65 20 4d 61 63 69 6e 74 6f 73 68 Apple Macintosh
15210 20 63 6f 6d 70 75 74 65 72 73 20 2d 20 62 6f 74 computers - bot
15220 68 20 4f 53 39 20 61 6e 64 20 4f 53 58 2e 0a 2a h OS9 and OSX..*
15230 2a 0a 2a 2a 20 54 68 69 72 64 2d 70 61 72 74 79 *.** Third-party
15240 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
15250 20 6f 66 20 41 46 50 20 61 72 65 20 61 76 61 69 of AFP are avai
15260 6c 61 62 6c 65 2e 20 20 42 75 74 20 74 68 69 73 lable. But this
15270 20 63 6f 64 65 20 68 65 72 65 0a 2a 2a 20 6f 6e code here.** on
15280 6c 79 20 77 6f 72 6b 73 20 6f 6e 20 4f 53 58 2e ly works on OSX.
15290 0a 2a 2f 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 .*/..#if defined
152a0 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 53 (__APPLE__) && S
152b0 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 QLITE_ENABLE_LOC
152c0 4b 49 4e 47 5f 53 54 59 4c 45 0a 2f 2a 0a 2a 2a KING_STYLE./*.**
152d0 20 54 68 65 20 61 66 70 4c 6f 63 6b 69 6e 67 43 The afpLockingC
152e0 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72 65 ontext structure
152f0 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 61 66 contains all af
15300 70 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 63 20 p lock specific
15310 73 74 61 74 65 0a 2a 2f 0a 74 79 70 65 64 65 66 state.*/.typedef
15320 20 73 74 72 75 63 74 20 61 66 70 4c 6f 63 6b 69 struct afpLocki
15330 6e 67 43 6f 6e 74 65 78 74 20 61 66 70 4c 6f 63 ngContext afpLoc
15340 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 73 74 72 kingContext;.str
15350 75 63 74 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f uct afpLockingCo
15360 6e 74 65 78 74 20 7b 0a 20 20 69 6e 74 20 72 65 ntext {. int re
15370 73 65 72 76 65 64 3b 0a 20 20 63 6f 6e 73 74 20 served;. const
15380 63 68 61 72 20 2a 64 62 50 61 74 68 3b 20 20 20 char *dbPath;
15390 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d /* Nam
153a0 65 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 66 69 e of the open fi
153b0 6c 65 20 2a 2f 0a 7d 3b 0a 0a 73 74 72 75 63 74 le */.};..struct
153c0 20 42 79 74 65 52 61 6e 67 65 4c 6f 63 6b 50 42 ByteRangeLockPB
153d0 32 0a 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 6c 2.{. unsigned l
153e0 6f 6e 67 20 6c 6f 6e 67 20 6f 66 66 73 65 74 3b ong long offset;
153f0 20 20 20 20 20 20 20 20 2f 2a 20 6f 66 66 73 65 /* offse
15400 74 20 74 6f 20 66 69 72 73 74 20 62 79 74 65 20 t to first byte
15410 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e 73 to lock */. uns
15420 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 igned long long
15430 6c 65 6e 67 74 68 3b 20 20 20 20 20 20 20 20 2f length; /
15440 2a 20 6e 62 72 20 6f 66 20 62 79 74 65 73 20 74 * nbr of bytes t
15450 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e 73 69 o lock */. unsi
15460 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 72 gned long long r
15470 65 74 52 61 6e 67 65 53 74 61 72 74 3b 20 2f 2a etRangeStart; /*
15480 20 6e 62 72 20 6f 66 20 31 73 74 20 62 79 74 65 nbr of 1st byte
15490 20 6c 6f 63 6b 65 64 20 69 66 20 73 75 63 63 65 locked if succe
154a0 73 73 66 75 6c 20 2a 2f 0a 20 20 75 6e 73 69 67 ssful */. unsig
154b0 6e 65 64 20 63 68 61 72 20 75 6e 4c 6f 63 6b 46 ned char unLockF
154c0 6c 61 67 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 lag; /*
154d0 31 20 3d 20 75 6e 6c 6f 63 6b 2c 20 30 20 3d 20 1 = unlock, 0 =
154e0 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e 73 69 67 6e lock */. unsign
154f0 65 64 20 63 68 61 72 20 73 74 61 72 74 45 6e 64 ed char startEnd
15500 46 6c 61 67 3b 20 20 20 20 20 20 20 2f 2a 20 31 Flag; /* 1
15510 3d 72 65 6c 20 74 6f 20 65 6e 64 20 6f 66 20 66 =rel to end of f
15520 6f 72 6b 2c 20 30 3d 72 65 6c 20 74 6f 20 73 74 ork, 0=rel to st
15530 61 72 74 20 2a 2f 0a 20 20 69 6e 74 20 66 64 3b art */. int fd;
15540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15550 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 69 /* fi
15560 6c 65 20 64 65 73 63 20 74 6f 20 61 73 73 6f 63 le desc to assoc
15570 20 74 68 69 73 20 6c 6f 63 6b 20 77 69 74 68 20 this lock with
15580 2a 2f 0a 7d 3b 0a 0a 23 64 65 66 69 6e 65 20 61 */.};..#define a
15590 66 70 66 73 42 79 74 65 52 61 6e 67 65 4c 6f 63 fpfsByteRangeLoc
155a0 6b 32 46 53 43 54 4c 20 20 20 20 20 20 20 20 5f k2FSCTL _
155b0 49 4f 57 52 28 27 7a 27 2c 20 32 33 2c 20 73 74 IOWR('z', 23, st
155c0 72 75 63 74 20 42 79 74 65 52 61 6e 67 65 4c 6f ruct ByteRangeLo
155d0 63 6b 50 42 32 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 ckPB2)../*.** Th
155e0 69 73 20 69 73 20 61 20 75 74 69 6c 69 74 79 20 is is a utility
155f0 66 6f 72 20 73 65 74 74 69 6e 67 20 6f 72 20 63 for setting or c
15600 6c 65 61 72 69 6e 67 20 61 20 62 69 74 2d 72 61 learing a bit-ra
15610 6e 67 65 20 6c 6f 63 6b 20 6f 6e 20 61 6e 0a 2a nge lock on an.*
15620 2a 20 41 46 50 20 66 69 6c 65 73 79 73 74 65 6d * AFP filesystem
15630 2e 0a 2a 2a 20 0a 2a 2a 20 52 65 74 75 72 6e 20 ..** .** Return
15640 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 SQLITE_OK on suc
15650 63 65 73 73 2c 20 53 51 4c 49 54 45 5f 42 55 53 cess, SQLITE_BUS
15660 59 20 6f 6e 20 66 61 69 6c 75 72 65 2e 0a 2a 2f Y on failure..*/
15670 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66 70 53 .static int afpS
15680 65 74 4c 6f 63 6b 28 0a 20 20 63 6f 6e 73 74 20 etLock(. const
15690 63 68 61 72 20 2a 70 61 74 68 2c 20 20 20 20 20 char *path,
156a0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 /* Name
156b0 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f 20 of the file to
156c0 62 65 20 6c 6f 63 6b 65 64 20 6f 72 20 75 6e 6c be locked or unl
156d0 6f 63 6b 65 64 20 2a 2f 0a 20 20 75 6e 69 78 46 ocked */. unixF
156e0 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20 20 20 ile *pFile,
156f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 /* Ope
15700 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f n file descripto
15710 72 20 6f 6e 20 70 61 74 68 20 2a 2f 0a 20 20 75 r on path */. u
15720 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e nsigned long lon
15730 67 20 6f 66 66 73 65 74 2c 20 20 20 20 20 2f 2a g offset, /*
15740 20 46 69 72 73 74 20 62 79 74 65 20 74 6f 20 62 First byte to b
15750 65 20 6c 6f 63 6b 65 64 20 2a 2f 0a 20 20 75 6e e locked */. un
15760 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 signed long long
15770 20 6c 65 6e 67 74 68 2c 20 20 20 20 20 2f 2a 20 length, /*
15780 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
15790 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 to lock */. int
157a0 20 73 65 74 4c 6f 63 6b 46 6c 61 67 20 20 20 20 setLockFlag
157b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
157c0 72 75 65 20 74 6f 20 73 65 74 20 6c 6f 63 6b 2e rue to set lock.
157d0 20 20 46 61 6c 73 65 20 74 6f 20 63 6c 65 61 72 False to clear
157e0 20 6c 6f 63 6b 20 2a 2f 0a 29 7b 0a 20 20 73 74 lock */.){. st
157f0 72 75 63 74 20 42 79 74 65 52 61 6e 67 65 4c 6f ruct ByteRangeLo
15800 63 6b 50 42 32 20 70 62 3b 0a 20 20 69 6e 74 20 ckPB2 pb;. int
15810 65 72 72 3b 0a 20 20 0a 20 20 70 62 2e 75 6e 4c err;. . pb.unL
15820 6f 63 6b 46 6c 61 67 20 3d 20 73 65 74 4c 6f 63 ockFlag = setLoc
15830 6b 46 6c 61 67 20 3f 20 30 20 3a 20 31 3b 0a 20 kFlag ? 0 : 1;.
15840 20 70 62 2e 73 74 61 72 74 45 6e 64 46 6c 61 67 pb.startEndFlag
15850 20 3d 20 30 3b 0a 20 20 70 62 2e 6f 66 66 73 65 = 0;. pb.offse
15860 74 20 3d 20 6f 66 66 73 65 74 3b 0a 20 20 70 62 t = offset;. pb
15870 2e 6c 65 6e 67 74 68 20 3d 20 6c 65 6e 67 74 68 .length = length
15880 3b 20 0a 20 20 70 62 2e 66 64 20 3d 20 70 46 69 ; . pb.fd = pFi
15890 6c 65 2d 3e 68 3b 0a 20 20 0a 20 20 4f 53 54 52 le->h;. . OSTR
158a0 41 43 45 28 28 22 41 46 50 53 45 54 4c 4f 43 4b ACE(("AFPSETLOCK
158b0 20 5b 25 73 5d 20 66 6f 72 20 25 64 25 73 20 69 [%s] for %d%s i
158c0 6e 20 72 61 6e 67 65 20 25 6c 6c 78 3a 25 6c 6c n range %llx:%ll
158d0 78 5c 6e 22 2c 20 0a 20 20 20 20 28 73 65 74 4c x\n", . (setL
158e0 6f 63 6b 46 6c 61 67 3f 22 4f 4e 22 3a 22 4f 46 ockFlag?"ON":"OF
158f0 46 22 29 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 28 F"), pFile->h, (
15900 70 62 2e 66 64 3d 3d 2d 31 3f 22 5b 74 65 73 74 pb.fd==-1?"[test
15910 76 61 6c 2d 31 5d 22 3a 22 22 29 2c 0a 20 20 20 val-1]":""),.
15920 20 6f 66 66 73 65 74 2c 20 6c 65 6e 67 74 68 29 offset, length)
15930 29 3b 0a 20 20 65 72 72 20 3d 20 66 73 63 74 6c );. err = fsctl
15940 28 70 61 74 68 2c 20 61 66 70 66 73 42 79 74 65 (path, afpfsByte
15950 52 61 6e 67 65 4c 6f 63 6b 32 46 53 43 54 4c 2c RangeLock2FSCTL,
15960 20 26 70 62 2c 20 30 29 3b 0a 20 20 69 66 20 28 &pb, 0);. if (
15970 20 65 72 72 3d 3d 2d 31 20 29 20 7b 0a 20 20 20 err==-1 ) {.
15980 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 69 6e 74 int rc;. int
15990 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b tErrno = errno;
159a0 0a 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 41 . OSTRACE(("A
159b0 46 50 53 45 54 4c 4f 43 4b 20 66 61 69 6c 65 64 FPSETLOCK failed
159c0 20 74 6f 20 66 73 63 74 6c 28 29 20 27 25 73 27 to fsctl() '%s'
159d0 20 25 64 20 25 73 5c 6e 22 2c 0a 20 20 20 20 20 %d %s\n",.
159e0 20 20 20 20 20 20 20 20 70 61 74 68 2c 20 74 45 path, tE
159f0 72 72 6e 6f 2c 20 73 74 72 65 72 72 6f 72 28 74 rrno, strerror(t
15a00 45 72 72 6e 6f 29 29 29 3b 0a 23 69 66 64 65 66 Errno)));.#ifdef
15a10 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f 41 SQLITE_IGNORE_A
15a20 46 50 5f 4c 4f 43 4b 5f 45 52 52 4f 52 53 0a 20 FP_LOCK_ERRORS.
15a30 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 rc = SQLITE_B
15a40 55 53 59 3b 0a 23 65 6c 73 65 0a 20 20 20 20 72 USY;.#else. r
15a50 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 c = sqliteErrorF
15a60 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 romPosixError(tE
15a70 72 72 6e 6f 2c 0a 20 20 20 20 20 20 20 20 20 20 rrno,.
15a80 20 20 20 20 20 20 20 20 20 20 73 65 74 4c 6f 63 setLoc
15a90 6b 46 6c 61 67 20 3f 20 53 51 4c 49 54 45 5f 49 kFlag ? SQLITE_I
15aa0 4f 45 52 52 5f 4c 4f 43 4b 20 3a 20 53 51 4c 49 OERR_LOCK : SQLI
15ab0 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 29 TE_IOERR_UNLOCK)
15ac0 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 ;.#endif /* SQLI
15ad0 54 45 5f 49 47 4e 4f 52 45 5f 41 46 50 5f 4c 4f TE_IGNORE_AFP_LO
15ae0 43 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20 20 20 CK_ERRORS */.
15af0 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 if( IS_LOCK_ERR
15b00 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 20 20 20 OR(rc) ){.
15b10 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 storeLastErrno(p
15b20 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 File, tErrno);.
15b30 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
15b40 72 63 3b 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 rc;. } else {.
15b50 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
15b60 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a _OK;. }.}../*.*
15b70 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 * This routine c
15b80 68 65 63 6b 73 20 69 66 20 74 68 65 72 65 20 69 hecks if there i
15b90 73 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 s a RESERVED loc
15ba0 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 73 70 k held on the sp
15bb0 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65 20 ecified.** file
15bc0 62 79 20 74 68 69 73 20 6f 72 20 61 6e 79 20 6f by this or any o
15bd0 74 68 65 72 20 70 72 6f 63 65 73 73 2e 20 49 66 ther process. If
15be0 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 73 20 such a lock is
15bf0 68 65 6c 64 2c 20 73 65 74 20 2a 70 52 65 73 4f held, set *pResO
15c00 75 74 0a 2a 2a 20 74 6f 20 61 20 6e 6f 6e 2d 7a ut.** to a non-z
15c10 65 72 6f 20 76 61 6c 75 65 20 6f 74 68 65 72 77 ero value otherw
15c20 69 73 65 20 2a 70 52 65 73 4f 75 74 20 69 73 20 ise *pResOut is
15c30 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 20 54 68 set to zero. Th
15c40 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 0a 2a e return value.*
15c50 2a 20 69 73 20 73 65 74 20 74 6f 20 53 51 4c 49 * is set to SQLI
15c60 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 20 61 6e 20 TE_OK unless an
15c70 49 2f 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 I/O error occurs
15c80 20 64 75 72 69 6e 67 20 6c 6f 63 6b 20 63 68 65 during lock che
15c90 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 cking..*/.static
15ca0 20 69 6e 74 20 61 66 70 43 68 65 63 6b 52 65 73 int afpCheckRes
15cb0 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 ervedLock(sqlite
15cc0 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 3_file *id, int
15cd0 2a 70 52 65 73 4f 75 74 29 7b 0a 20 20 69 6e 74 *pResOut){. int
15ce0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
15cf0 0a 20 20 69 6e 74 20 72 65 73 65 72 76 65 64 20 . int reserved
15d00 3d 20 30 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 = 0;. unixFile
15d10 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 *pFile = (unixFi
15d20 6c 65 2a 29 69 64 3b 0a 20 20 61 66 70 4c 6f 63 le*)id;. afpLoc
15d30 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 63 6f 6e kingContext *con
15d40 74 65 78 74 3b 0a 20 20 0a 20 20 53 69 6d 75 6c text;. . Simul
15d50 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65 74 75 ateIOError( retu
15d60 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f rn SQLITE_IOERR_
15d70 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 CHECKRESERVEDLOC
15d80 4b 3b 20 29 3b 0a 20 20 0a 20 20 61 73 73 65 72 K; );. . asser
15d90 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 63 6f t( pFile );. co
15da0 6e 74 65 78 74 20 3d 20 28 61 66 70 4c 6f 63 6b ntext = (afpLock
15db0 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 20 70 46 ingContext *) pF
15dc0 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 ile->lockingCont
15dd0 65 78 74 3b 0a 20 20 69 66 28 20 63 6f 6e 74 65 ext;. if( conte
15de0 78 74 2d 3e 72 65 73 65 72 76 65 64 20 29 7b 0a xt->reserved ){.
15df0 20 20 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 31 *pResOut = 1
15e00 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
15e10 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 75 6e ITE_OK;. }. un
15e20 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 20 ixEnterMutex();
15e30 2f 2a 20 42 65 63 61 75 73 65 20 70 46 69 6c 65 /* Because pFile
15e40 2d 3e 70 49 6e 6f 64 65 20 69 73 20 73 68 61 72 ->pInode is shar
15e50 65 64 20 61 63 72 6f 73 73 20 74 68 72 65 61 64 ed across thread
15e60 73 20 2a 2f 0a 20 20 0a 20 20 2f 2a 20 43 68 65 s */. . /* Che
15e70 63 6b 20 69 66 20 61 20 74 68 72 65 61 64 20 69 ck if a thread i
15e80 6e 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 68 n this process h
15e90 6f 6c 64 73 20 73 75 63 68 20 61 20 6c 6f 63 6b olds such a lock
15ea0 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d */. if( pFile-
15eb0 3e 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f >pInode->eFileLo
15ec0 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 ck>SHARED_LOCK )
15ed0 7b 0a 20 20 20 20 72 65 73 65 72 76 65 64 20 3d {. reserved =
15ee0 20 31 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 1;. }. . /*
15ef0 4f 74 68 65 72 77 69 73 65 20 73 65 65 20 69 66 Otherwise see if
15f00 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 some other proc
15f10 65 73 73 20 68 6f 6c 64 73 20 69 74 2e 0a 20 20 ess holds it..
15f20 20 2a 2f 0a 20 20 69 66 28 20 21 72 65 73 65 72 */. if( !reser
15f30 76 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20 6c 6f ved ){. /* lo
15f40 63 6b 20 74 68 65 20 52 45 53 45 52 56 45 44 20 ck the RESERVED
15f50 62 79 74 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 byte */. int
15f60 6c 72 63 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b lrc = afpSetLock
15f70 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 (context->dbPath
15f80 2c 20 70 46 69 6c 65 2c 20 52 45 53 45 52 56 45 , pFile, RESERVE
15f90 44 5f 42 59 54 45 2c 20 31 2c 31 29 3b 20 20 0a D_BYTE, 1,1); .
15fa0 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f if( SQLITE_O
15fb0 4b 3d 3d 6c 72 63 20 29 7b 0a 20 20 20 20 20 20 K==lrc ){.
15fc0 2f 2a 20 69 66 20 77 65 20 73 75 63 63 65 65 64 /* if we succeed
15fd0 65 64 20 69 6e 20 74 61 6b 69 6e 67 20 74 68 65 ed in taking the
15fe0 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b 2c 20 reserved lock,
15ff0 75 6e 6c 6f 63 6b 20 69 74 20 74 6f 20 72 65 73 unlock it to res
16000 74 6f 72 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 tore. ** th
16010 65 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 65 e original state
16020 20 2a 2f 0a 20 20 20 20 20 20 6c 72 63 20 3d 20 */. lrc =
16030 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 afpSetLock(conte
16040 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c xt->dbPath, pFil
16050 65 2c 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 e, RESERVED_BYTE
16060 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 7d 20 65 , 1, 0);. } e
16070 6c 73 65 20 7b 0a 20 20 20 20 20 20 2f 2a 20 69 lse {. /* i
16080 66 20 77 65 20 66 61 69 6c 65 64 20 74 6f 20 67 f we failed to g
16090 65 74 20 74 68 65 20 6c 6f 63 6b 20 74 68 65 6e et the lock then
160a0 20 73 6f 6d 65 6f 6e 65 20 65 6c 73 65 20 6d 75 someone else mu
160b0 73 74 20 68 61 76 65 20 69 74 20 2a 2f 0a 20 20 st have it */.
160c0 20 20 20 20 72 65 73 65 72 76 65 64 20 3d 20 31 reserved = 1
160d0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
160e0 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 6c 72 IS_LOCK_ERROR(lr
160f0 63 29 20 29 7b 0a 20 20 20 20 20 20 72 63 3d 6c c) ){. rc=l
16100 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 rc;. }. }.
16110 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 . unixLeaveMute
16120 78 28 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 x();. OSTRACE((
16130 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64 "TEST WR-LOCK %d
16140 20 25 64 20 25 64 20 28 61 66 70 29 5c 6e 22 2c %d %d (afp)\n",
16150 20 70 46 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72 pFile->h, rc, r
16160 65 73 65 72 76 65 64 29 29 3b 0a 20 20 0a 20 20 eserved));. .
16170 2a 70 52 65 73 4f 75 74 20 3d 20 72 65 73 65 72 *pResOut = reser
16180 76 65 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ved;. return rc
16190 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 ;.}../*.** Lock
161a0 74 68 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 the file with th
161b0 65 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 64 e lock specified
161c0 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 65 46 by parameter eF
161d0 69 6c 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a ileLock - one.**
161e0 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
161f0 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 g:.**.** (1)
16200 20 53 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 SHARED_LOCK.**
16210 20 20 20 20 28 32 29 20 52 45 53 45 52 56 45 44 (2) RESERVED
16220 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 _LOCK.** (3)
16230 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a PENDING_LOCK.**
16240 20 20 20 20 20 28 34 29 20 45 58 43 4c 55 53 49 (4) EXCLUSI
16250 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f VE_LOCK.**.** So
16260 6d 65 74 69 6d 65 73 20 77 68 65 6e 20 72 65 71 metimes when req
16270 75 65 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b uesting one lock
16280 20 73 74 61 74 65 2c 20 61 64 64 69 74 69 6f 6e state, addition
16290 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a al lock states.*
162a0 2a 20 61 72 65 20 69 6e 73 65 72 74 65 64 20 69 * are inserted i
162b0 6e 20 62 65 74 77 65 65 6e 2e 20 20 54 68 65 20 n between. The
162c0 6c 6f 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 locking might fa
162d0 69 6c 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 il on one of the
162e0 20 6c 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 later.** transi
162f0 74 69 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 tions leaving th
16300 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 66 e lock state dif
16310 66 65 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 ferent from what
16320 20 69 74 20 73 74 61 72 74 65 64 20 62 75 74 0a it started but.
16330 2a 2a 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f ** still short o
16340 66 20 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 f its goal. The
16350 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 following chart
16360 20 73 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 shows the allow
16370 65 64 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e ed.** transition
16380 73 20 61 6e 64 20 74 68 65 20 69 6e 73 65 72 74 s and the insert
16390 65 64 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 ed intermediate
163a0 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 states:.**.**
163b0 20 55 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 UNLOCKED -> SHA
163c0 52 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 RED.** SHARED
163d0 20 2d 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 -> RESERVED.**
163e0 20 20 20 53 48 41 52 45 44 20 2d 3e 20 28 50 45 SHARED -> (PE
163f0 4e 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 NDING) -> EXCLUS
16400 49 56 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 IVE.** RESERV
16410 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 ED -> (PENDING)
16420 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 -> EXCLUSIVE.**
16430 20 20 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 PENDING -> EX
16440 43 4c 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 54 68 CLUSIVE.**.** Th
16450 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 is routine will
16460 6f 6e 6c 79 20 69 6e 63 72 65 61 73 65 20 61 20 only increase a
16470 6c 6f 63 6b 2e 20 20 55 73 65 20 74 68 65 20 73 lock. Use the s
16480 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 qlite3OsUnlock()
16490 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 74 6f 20 6c .** routine to l
164a0 6f 77 65 72 20 61 20 6c 6f 63 6b 69 6e 67 20 6c ower a locking l
164b0 65 76 65 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 evel..*/.static
164c0 69 6e 74 20 61 66 70 4c 6f 63 6b 28 73 71 6c 69 int afpLock(sqli
164d0 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e te3_file *id, in
164e0 74 20 65 46 69 6c 65 4c 6f 63 6b 29 7b 0a 20 20 t eFileLock){.
164f0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
16500 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a OK;. unixFile *
16510 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c pFile = (unixFil
16520 65 2a 29 69 64 3b 0a 20 20 75 6e 69 78 49 6e 6f e*)id;. unixIno
16530 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 20 3d deInfo *pInode =
16540 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a pFile->pInode;.
16550 20 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 afpLockingCont
16560 65 78 74 20 2a 63 6f 6e 74 65 78 74 20 3d 20 28 ext *context = (
16570 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 afpLockingContex
16580 74 20 2a 29 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b t *) pFile->lock
16590 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 0a 20 ingContext;. .
165a0 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 assert( pFile )
165b0 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c 4f ;. OSTRACE(("LO
165c0 43 4b 20 20 20 20 25 64 20 25 73 20 77 61 73 20 CK %d %s was
165d0 25 73 28 25 73 2c 25 64 29 20 70 69 64 3d 25 64 %s(%s,%d) pid=%d
165e0 20 28 61 66 70 29 5c 6e 22 2c 20 70 46 69 6c 65 (afp)\n", pFile
165f0 2d 3e 68 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ->h,.
16600 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 azFileLock(eFile
16610 4c 6f 63 6b 29 2c 20 61 7a 46 69 6c 65 4c 6f 63 Lock), azFileLoc
16620 6b 28 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f k(pFile->eFileLo
16630 63 6b 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ck),.
16640 61 7a 46 69 6c 65 4c 6f 63 6b 28 70 49 6e 6f 64 azFileLock(pInod
16650 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 70 e->eFileLock), p
16660 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 20 2c Inode->nShared ,
16670 20 6f 73 47 65 74 70 69 64 28 30 29 29 29 3b 0a osGetpid(0)));.
16680 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 . /* If there i
16690 73 20 61 6c 72 65 61 64 79 20 61 20 6c 6f 63 6b s already a lock
166a0 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 6f 72 of this type or
166b0 20 6d 6f 72 65 20 72 65 73 74 72 69 63 74 69 76 more restrictiv
166c0 65 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 75 6e e on the. ** un
166d0 69 78 46 69 6c 65 2c 20 64 6f 20 6e 6f 74 68 69 ixFile, do nothi
166e0 6e 67 2e 20 44 6f 6e 27 74 20 75 73 65 20 74 68 ng. Don't use th
166f0 65 20 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3a 20 e afp_end_lock:
16700 65 78 69 74 20 70 61 74 68 2c 20 61 73 0a 20 20 exit path, as.
16710 2a 2a 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 ** unixEnterMute
16720 78 28 29 20 68 61 73 6e 27 74 20 62 65 65 6e 20 x() hasn't been
16730 63 61 6c 6c 65 64 20 79 65 74 2e 0a 20 20 2a 2f called yet.. */
16740 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 . if( pFile->eF
16750 69 6c 65 4c 6f 63 6b 3e 3d 65 46 69 6c 65 4c 6f ileLock>=eFileLo
16760 63 6b 20 29 7b 0a 20 20 20 20 4f 53 54 52 41 43 ck ){. OSTRAC
16770 45 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 E(("LOCK %d %
16780 73 20 6f 6b 20 28 61 6c 72 65 61 64 79 20 68 65 s ok (already he
16790 6c 64 29 20 28 61 66 70 29 5c 6e 22 2c 20 70 46 ld) (afp)\n", pF
167a0 69 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20 20 20 ile->h,.
167b0 20 20 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 azFileLock(eF
167c0 69 6c 65 4c 6f 63 6b 29 29 29 3b 0a 20 20 20 20 ileLock)));.
167d0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
167e0 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b 65 ;. }.. /* Make
167f0 20 73 75 72 65 20 74 68 65 20 6c 6f 63 6b 69 6e sure the lockin
16800 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 63 6f g sequence is co
16810 72 72 65 63 74 0a 20 20 2a 2a 20 20 28 31 29 20 rrect. ** (1)
16820 57 65 20 6e 65 76 65 72 20 6d 6f 76 65 20 66 72 We never move fr
16830 6f 6d 20 75 6e 6c 6f 63 6b 65 64 20 74 6f 20 61 om unlocked to a
16840 6e 79 74 68 69 6e 67 20 68 69 67 68 65 72 20 74 nything higher t
16850 68 61 6e 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e han shared lock.
16860 0a 20 20 2a 2a 20 20 28 32 29 20 53 51 4c 69 74 . ** (2) SQLit
16870 65 20 6e 65 76 65 72 20 65 78 70 6c 69 63 69 74 e never explicit
16880 6c 79 20 72 65 71 75 65 73 74 73 20 61 20 70 65 ly requests a pe
16890 6e 64 69 67 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 ndig lock.. **
168a0 20 28 33 29 20 41 20 73 68 61 72 65 64 20 6c 6f (3) A shared lo
168b0 63 6b 20 69 73 20 61 6c 77 61 79 73 20 68 65 6c ck is always hel
168c0 64 20 77 68 65 6e 20 61 20 72 65 73 65 72 76 65 d when a reserve
168d0 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 65 73 74 lock is request
168e0 65 64 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 ed.. */. asser
168f0 74 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c t( pFile->eFileL
16900 6f 63 6b 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 ock!=NO_LOCK ||
16910 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 eFileLock==SHARE
16920 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 D_LOCK );. asse
16930 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 21 3d 50 rt( eFileLock!=P
16940 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 29 3b 0a 20 ENDING_LOCK );.
16950 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f assert( eFileLo
16960 63 6b 21 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 ck!=RESERVED_LOC
16970 4b 20 7c 7c 20 70 46 69 6c 65 2d 3e 65 46 69 6c K || pFile->eFil
16980 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
16990 43 4b 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 54 68 CK );. . /* Th
169a0 69 73 20 6d 75 74 65 78 20 69 73 20 6e 65 65 64 is mutex is need
169b0 65 64 20 62 65 63 61 75 73 65 20 70 46 69 6c 65 ed because pFile
169c0 2d 3e 70 49 6e 6f 64 65 20 69 73 20 73 68 61 72 ->pInode is shar
169d0 65 64 20 61 63 72 6f 73 73 20 74 68 72 65 61 64 ed across thread
169e0 73 0a 20 20 2a 2f 0a 20 20 75 6e 69 78 45 6e 74 s. */. unixEnt
169f0 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 49 6e erMutex();. pIn
16a00 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e ode = pFile->pIn
16a10 6f 64 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 73 6f ode;.. /* If so
16a20 6d 65 20 74 68 72 65 61 64 20 75 73 69 6e 67 20 me thread using
16a30 74 68 69 73 20 50 49 44 20 68 61 73 20 61 20 6c this PID has a l
16a40 6f 63 6b 20 76 69 61 20 61 20 64 69 66 66 65 72 ock via a differ
16a50 65 6e 74 20 75 6e 69 78 46 69 6c 65 2a 0a 20 20 ent unixFile*.
16a60 2a 2a 20 68 61 6e 64 6c 65 20 74 68 61 74 20 70 ** handle that p
16a70 72 65 63 6c 75 64 65 73 20 74 68 65 20 72 65 71 recludes the req
16a80 75 65 73 74 65 64 20 6c 6f 63 6b 2c 20 72 65 74 uested lock, ret
16a90 75 72 6e 20 42 55 53 59 2e 0a 20 20 2a 2f 0a 20 urn BUSY.. */.
16aa0 20 69 66 28 20 28 70 46 69 6c 65 2d 3e 65 46 69 if( (pFile->eFi
16ab0 6c 65 4c 6f 63 6b 21 3d 70 49 6e 6f 64 65 2d 3e leLock!=pInode->
16ac0 65 46 69 6c 65 4c 6f 63 6b 20 26 26 20 0a 20 20 eFileLock && .
16ad0 20 20 20 20 20 28 70 49 6e 6f 64 65 2d 3e 65 46 (pInode->eF
16ae0 69 6c 65 4c 6f 63 6b 3e 3d 50 45 4e 44 49 4e 47 ileLock>=PENDING
16af0 5f 4c 4f 43 4b 20 7c 7c 20 65 46 69 6c 65 4c 6f _LOCK || eFileLo
16b00 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 29 29 ck>SHARED_LOCK))
16b10 0a 20 20 20 20 20 29 7b 0a 20 20 20 20 72 63 20 . ){. rc
16b20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 = SQLITE_BUSY;.
16b30 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f goto afp_end_
16b40 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f lock;. }. . /
16b50 2a 20 49 66 20 61 20 53 48 41 52 45 44 20 6c 6f * If a SHARED lo
16b60 63 6b 20 69 73 20 72 65 71 75 65 73 74 65 64 2c ck is requested,
16b70 20 61 6e 64 20 73 6f 6d 65 20 74 68 72 65 61 64 and some thread
16b80 20 75 73 69 6e 67 20 74 68 69 73 20 50 49 44 20 using this PID
16b90 61 6c 72 65 61 64 79 0a 20 20 2a 2a 20 68 61 73 already. ** has
16ba0 20 61 20 53 48 41 52 45 44 20 6f 72 20 52 45 53 a SHARED or RES
16bb0 45 52 56 45 44 20 6c 6f 63 6b 2c 20 74 68 65 6e ERVED lock, then
16bc0 20 69 6e 63 72 65 6d 65 6e 74 20 72 65 66 65 72 increment refer
16bd0 65 6e 63 65 20 63 6f 75 6e 74 73 20 61 6e 64 0a ence counts and.
16be0 20 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 ** return SQLI
16bf0 54 45 5f 4f 4b 2e 0a 20 20 2a 2f 0a 20 20 69 66 TE_OK.. */. if
16c00 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 ( eFileLock==SHA
16c10 52 45 44 5f 4c 4f 43 4b 20 26 26 20 0a 20 20 20 RED_LOCK && .
16c20 20 20 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 (pInode->eFile
16c30 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 Lock==SHARED_LOC
16c40 4b 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e 65 46 69 K || pInode->eFi
16c50 6c 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 45 44 leLock==RESERVED
16c60 5f 4c 4f 43 4b 29 20 29 7b 0a 20 20 20 20 61 73 _LOCK) ){. as
16c70 73 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3d sert( eFileLock=
16c80 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a =SHARED_LOCK );.
16c90 20 20 20 20 61 73 73 65 72 74 28 20 70 46 69 6c assert( pFil
16ca0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 e->eFileLock==0
16cb0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
16cc0 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e 30 Inode->nShared>0
16cd0 20 29 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 );. pFile->e
16ce0 46 69 6c 65 4c 6f 63 6b 20 3d 20 53 48 41 52 45 FileLock = SHARE
16cf0 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 49 6e 6f D_LOCK;. pIno
16d00 64 65 2d 3e 6e 53 68 61 72 65 64 2b 2b 3b 0a 20 de->nShared++;.
16d10 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b pInode->nLock
16d20 2b 2b 3b 0a 20 20 20 20 67 6f 74 6f 20 61 66 70 ++;. goto afp
16d30 5f 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 _end_lock;. }.
16d40 20 20 20 0a 20 20 2f 2a 20 41 20 50 45 4e 44 49 . /* A PENDI
16d50 4e 47 20 6c 6f 63 6b 20 69 73 20 6e 65 65 64 65 NG lock is neede
16d60 64 20 62 65 66 6f 72 65 20 61 63 71 75 69 72 69 d before acquiri
16d70 6e 67 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b ng a SHARED lock
16d80 20 61 6e 64 20 62 65 66 6f 72 65 0a 20 20 2a 2a and before. **
16d90 20 61 63 71 75 69 72 69 6e 67 20 61 6e 20 45 58 acquiring an EX
16da0 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 46 CLUSIVE lock. F
16db0 6f 72 20 74 68 65 20 53 48 41 52 45 44 20 6c 6f or the SHARED lo
16dc0 63 6b 2c 20 74 68 65 20 50 45 4e 44 49 4e 47 20 ck, the PENDING
16dd0 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 72 65 6c will. ** be rel
16de0 65 61 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 eased.. */. if
16df0 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 ( eFileLock==SHA
16e00 52 45 44 5f 4c 4f 43 4b 20 0a 20 20 20 20 20 20 RED_LOCK .
16e10 7c 7c 20 28 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 || (eFileLock==E
16e20 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 XCLUSIVE_LOCK &&
16e30 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
16e40 6b 3c 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 29 0a k<PENDING_LOCK).
16e50 20 20 29 7b 0a 20 20 20 20 69 6e 74 20 66 61 69 ){. int fai
16e60 6c 65 64 3b 0a 20 20 20 20 66 61 69 6c 65 64 20 led;. failed
16e70 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e = afpSetLock(con
16e80 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 text->dbPath, pF
16e90 69 6c 65 2c 20 50 45 4e 44 49 4e 47 5f 42 59 54 ile, PENDING_BYT
16ea0 45 2c 20 31 2c 20 31 29 3b 0a 20 20 20 20 69 66 E, 1, 1);. if
16eb0 20 28 66 61 69 6c 65 64 29 20 7b 0a 20 20 20 20 (failed) {.
16ec0 20 20 72 63 20 3d 20 66 61 69 6c 65 64 3b 0a 20 rc = failed;.
16ed0 20 20 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e goto afp_en
16ee0 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 d_lock;. }.
16ef0 7d 0a 20 20 0a 20 20 2f 2a 20 49 66 20 63 6f 6e }. . /* If con
16f00 74 72 6f 6c 20 67 65 74 73 20 74 6f 20 74 68 69 trol gets to thi
16f10 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 61 63 s point, then ac
16f20 74 75 61 6c 6c 79 20 67 6f 20 61 68 65 61 64 20 tually go ahead
16f30 61 6e 64 20 6d 61 6b 65 0a 20 20 2a 2a 20 6f 70 and make. ** op
16f40 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 63 erating system c
16f50 61 6c 6c 73 20 66 6f 72 20 74 68 65 20 73 70 65 alls for the spe
16f60 63 69 66 69 65 64 20 6c 6f 63 6b 2e 0a 20 20 2a cified lock.. *
16f70 2f 0a 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 /. if( eFileLoc
16f80 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 k==SHARED_LOCK )
16f90 7b 0a 20 20 20 20 69 6e 74 20 6c 72 63 31 2c 20 {. int lrc1,
16fa0 6c 72 63 32 2c 20 6c 72 63 31 45 72 72 6e 6f 20 lrc2, lrc1Errno
16fb0 3d 20 30 3b 0a 20 20 20 20 6c 6f 6e 67 20 6c 6b = 0;. long lk
16fc0 2c 20 6d 61 73 6b 3b 0a 20 20 20 20 0a 20 20 20 , mask;. .
16fd0 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 65 2d assert( pInode-
16fe0 3e 6e 53 68 61 72 65 64 3d 3d 30 20 29 3b 0a 20 >nShared==0 );.
16ff0 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 assert( pInod
17000 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 e->eFileLock==0
17010 29 3b 0a 20 20 20 20 20 20 20 20 0a 20 20 20 20 );. .
17020 6d 61 73 6b 20 3d 20 28 73 69 7a 65 6f 66 28 6c mask = (sizeof(l
17030 6f 6e 67 29 3d 3d 38 29 20 3f 20 4c 41 52 47 45 ong)==8) ? LARGE
17040 53 54 5f 49 4e 54 36 34 20 3a 20 30 78 37 66 66 ST_INT64 : 0x7ff
17050 66 66 66 66 66 3b 0a 20 20 20 20 2f 2a 20 4e 6f fffff;. /* No
17060 77 20 67 65 74 20 74 68 65 20 72 65 61 64 2d 6c w get the read-l
17070 6f 63 6b 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 ock SHARED_LOCK
17080 2a 2f 0a 20 20 20 20 2f 2a 20 6e 6f 74 65 20 74 */. /* note t
17090 68 61 74 20 74 68 65 20 71 75 61 6c 69 74 79 20 hat the quality
170a0 6f 66 20 74 68 65 20 72 61 6e 64 6f 6d 6e 65 73 of the randomnes
170b0 73 20 64 6f 65 73 6e 27 74 20 6d 61 74 74 65 72 s doesn't matter
170c0 20 74 68 61 74 20 6d 75 63 68 20 2a 2f 0a 20 20 that much */.
170d0 20 20 6c 6b 20 3d 20 72 61 6e 64 6f 6d 28 29 3b lk = random();
170e0 20 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 73 68 . pInode->sh
170f0 61 72 65 64 42 79 74 65 20 3d 20 28 6c 6b 20 26 aredByte = (lk &
17100 20 6d 61 73 6b 29 25 28 53 48 41 52 45 44 5f 53 mask)%(SHARED_S
17110 49 5a 45 20 2d 20 31 29 3b 0a 20 20 20 20 6c 72 IZE - 1);. lr
17120 63 31 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 c1 = afpSetLock(
17130 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c context->dbPath,
17140 20 70 46 69 6c 65 2c 20 0a 20 20 20 20 20 20 20 pFile, .
17150 20 20 20 53 48 41 52 45 44 5f 46 49 52 53 54 2b SHARED_FIRST+
17160 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64 42 79 pInode->sharedBy
17170 74 65 2c 20 31 2c 20 31 29 3b 0a 20 20 20 20 69 te, 1, 1);. i
17180 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 f( IS_LOCK_ERROR
17190 28 6c 72 63 31 29 20 29 7b 0a 20 20 20 20 20 20 (lrc1) ){.
171a0 6c 72 63 31 45 72 72 6e 6f 20 3d 20 70 46 69 6c lrc1Errno = pFil
171b0 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 3b 0a 20 20 e->lastErrno;.
171c0 20 20 7d 0a 20 20 20 20 2f 2a 20 44 72 6f 70 20 }. /* Drop
171d0 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 50 45 the temporary PE
171e0 4e 44 49 4e 47 20 6c 6f 63 6b 20 2a 2f 0a 20 20 NDING lock */.
171f0 20 20 6c 72 63 32 20 3d 20 61 66 70 53 65 74 4c lrc2 = afpSetL
17200 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 ock(context->dbP
17210 61 74 68 2c 20 70 46 69 6c 65 2c 20 50 45 4e 44 ath, pFile, PEND
17220 49 4e 47 5f 42 59 54 45 2c 20 31 2c 20 30 29 3b ING_BYTE, 1, 0);
17230 0a 20 20 20 20 0a 20 20 20 20 69 66 28 20 49 53 . . if( IS
17240 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 6c 72 63 31 _LOCK_ERROR(lrc1
17250 29 20 29 20 7b 0a 20 20 20 20 20 20 73 74 6f 72 ) ) {. stor
17260 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 eLastErrno(pFile
17270 2c 20 6c 72 63 31 45 72 72 6e 6f 29 3b 0a 20 20 , lrc1Errno);.
17280 20 20 20 20 72 63 20 3d 20 6c 72 63 31 3b 0a 20 rc = lrc1;.
17290 20 20 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e goto afp_en
172a0 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 20 65 6c d_lock;. } el
172b0 73 65 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 se if( IS_LOCK_E
172c0 52 52 4f 52 28 6c 72 63 32 29 20 29 7b 0a 20 20 RROR(lrc2) ){.
172d0 20 20 20 20 72 63 20 3d 20 6c 72 63 32 3b 0a 20 rc = lrc2;.
172e0 20 20 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e goto afp_en
172f0 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 20 65 6c d_lock;. } el
17300 73 65 20 69 66 28 20 6c 72 63 31 20 21 3d 20 53 se if( lrc1 != S
17310 51 4c 49 54 45 5f 4f 4b 20 29 20 7b 0a 20 20 20 QLITE_OK ) {.
17320 20 20 20 72 63 20 3d 20 6c 72 63 31 3b 0a 20 20 rc = lrc1;.
17330 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 } else {.
17340 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 pFile->eFileLoc
17350 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b k = SHARED_LOCK;
17360 0a 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e . pInode->n
17370 4c 6f 63 6b 2b 2b 3b 0a 20 20 20 20 20 20 70 49 Lock++;. pI
17380 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 20 3d 20 node->nShared =
17390 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 1;. }. }else
173a0 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d if( eFileLock==
173b0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 EXCLUSIVE_LOCK &
173c0 26 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 & pInode->nShare
173d0 64 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65 d>1 ){. /* We
173e0 20 61 72 65 20 74 72 79 69 6e 67 20 66 6f 72 20 are trying for
173f0 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 an exclusive loc
17400 6b 20 62 75 74 20 61 6e 6f 74 68 65 72 20 74 68 k but another th
17410 72 65 61 64 20 69 6e 20 74 68 69 73 0a 20 20 20 read in this.
17420 20 20 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65 73 ** same proces
17430 73 20 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64 69 s is still holdi
17440 6e 67 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b ng a shared lock
17450 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 . */. rc = SQ
17460 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65 6c LITE_BUSY;. }el
17470 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 se{. /* The r
17480 65 71 75 65 73 74 20 77 61 73 20 66 6f 72 20 61 equest was for a
17490 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 RESERVED or EXC
174a0 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49 74 LUSIVE lock. It
174b0 20 69 73 0a 20 20 20 20 2a 2a 20 61 73 73 75 6d is. ** assum
174c0 65 64 20 74 68 61 74 20 74 68 65 72 65 20 69 73 ed that there is
174d0 20 61 20 53 48 41 52 45 44 20 6f 72 20 67 72 65 a SHARED or gre
174e0 61 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 ater lock on the
174f0 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c 72 file. ** alr
17500 65 61 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 eady.. */.
17510 20 69 6e 74 20 66 61 69 6c 65 64 20 3d 20 30 3b int failed = 0;
17520 0a 20 20 20 20 61 73 73 65 72 74 28 20 30 21 3d . assert( 0!=
17530 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
17540 20 29 3b 0a 20 20 20 20 69 66 20 28 65 46 69 6c );. if (eFil
17550 65 4c 6f 63 6b 20 3e 3d 20 52 45 53 45 52 56 45 eLock >= RESERVE
17560 44 5f 4c 4f 43 4b 20 26 26 20 70 46 69 6c 65 2d D_LOCK && pFile-
17570 3e 65 46 69 6c 65 4c 6f 63 6b 20 3c 20 52 45 53 >eFileLock < RES
17580 45 52 56 45 44 5f 4c 4f 43 4b 29 20 7b 0a 20 20 ERVED_LOCK) {.
17590 20 20 20 20 20 20 2f 2a 20 41 63 71 75 69 72 65 /* Acquire
175a0 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b a RESERVED lock
175b0 20 2a 2f 0a 20 20 20 20 20 20 20 20 66 61 69 6c */. fail
175c0 65 64 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 ed = afpSetLock(
175d0 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c context->dbPath,
175e0 20 70 46 69 6c 65 2c 20 52 45 53 45 52 56 45 44 pFile, RESERVED
175f0 5f 42 59 54 45 2c 20 31 2c 31 29 3b 0a 20 20 20 _BYTE, 1,1);.
17600 20 20 20 69 66 28 20 21 66 61 69 6c 65 64 20 29 if( !failed )
17610 7b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 65 78 {. contex
17620 74 2d 3e 72 65 73 65 72 76 65 64 20 3d 20 31 3b t->reserved = 1;
17630 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
17640 20 20 20 69 66 20 28 21 66 61 69 6c 65 64 20 26 if (!failed &
17650 26 20 65 46 69 6c 65 4c 6f 63 6b 20 3d 3d 20 45 & eFileLock == E
17660 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 20 7b XCLUSIVE_LOCK) {
17670 0a 20 20 20 20 20 20 2f 2a 20 41 63 71 75 69 72 . /* Acquir
17680 65 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c e an EXCLUSIVE l
17690 6f 63 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 0a ock */. .
176a0 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 /* Remove
176b0 74 68 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 the shared lock
176c0 62 65 66 6f 72 65 20 74 72 79 69 6e 67 20 74 68 before trying th
176d0 65 20 72 61 6e 67 65 2e 20 20 77 65 27 6c 6c 20 e range. we'll
176e0 6e 65 65 64 20 74 6f 20 0a 20 20 20 20 20 20 2a need to . *
176f0 2a 20 72 65 65 73 74 61 62 6c 69 73 68 20 74 68 * reestablish th
17700 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 69 66 e shared lock if
17710 20 77 65 20 63 61 6e 27 74 20 67 65 74 20 74 68 we can't get th
17720 65 20 20 61 66 70 55 6e 6c 6f 63 6b 0a 20 20 20 e afpUnlock.
17730 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
17740 21 28 66 61 69 6c 65 64 20 3d 20 61 66 70 53 65 !(failed = afpSe
17750 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 tLock(context->d
17760 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20 53 48 bPath, pFile, SH
17770 41 52 45 44 5f 46 49 52 53 54 20 2b 0a 20 20 20 ARED_FIRST +.
17780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17790 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 73 68 pInode->sh
177a0 61 72 65 64 42 79 74 65 2c 20 31 2c 20 30 29 29 aredByte, 1, 0))
177b0 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 ){. int
177c0 66 61 69 6c 65 64 32 20 3d 20 53 51 4c 49 54 45 failed2 = SQLITE
177d0 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 2f 2a 20 _OK;. /*
177e0 6e 6f 77 20 61 74 74 65 6d 6d 70 74 20 74 6f 20 now attemmpt to
177f0 67 65 74 20 74 68 65 20 65 78 63 6c 75 73 69 76 get the exclusiv
17800 65 20 6c 6f 63 6b 20 72 61 6e 67 65 20 2a 2f 0a e lock range */.
17810 20 20 20 20 20 20 20 20 66 61 69 6c 65 64 20 3d failed =
17820 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 afpSetLock(cont
17830 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 ext->dbPath, pFi
17840 6c 65 2c 20 53 48 41 52 45 44 5f 46 49 52 53 54 le, SHARED_FIRST
17850 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 , .
17860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17870 20 20 53 48 41 52 45 44 5f 53 49 5a 45 2c 20 31 SHARED_SIZE, 1
17880 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 66 );. if( f
17890 61 69 6c 65 64 20 26 26 20 28 66 61 69 6c 65 64 ailed && (failed
178a0 32 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 2 = afpSetLock(c
178b0 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 ontext->dbPath,
178c0 70 46 69 6c 65 2c 20 0a 20 20 20 20 20 20 20 20 pFile, .
178d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
178e0 48 41 52 45 44 5f 46 49 52 53 54 20 2b 20 70 49 HARED_FIRST + pI
178f0 6e 6f 64 65 2d 3e 73 68 61 72 65 64 42 79 74 65 node->sharedByte
17900 2c 20 31 2c 20 31 29 29 20 29 7b 0a 20 20 20 20 , 1, 1)) ){.
17910 20 20 20 20 20 20 2f 2a 20 43 61 6e 27 74 20 72 /* Can't r
17920 65 65 73 74 61 62 6c 69 73 68 20 74 68 65 20 73 eestablish the s
17930 68 61 72 65 64 20 6c 6f 63 6b 2e 20 20 53 71 6c hared lock. Sql
17940 69 74 65 20 63 61 6e 27 74 20 64 65 61 6c 2c 20 ite can't deal,
17950 74 68 69 73 20 69 73 0a 20 20 20 20 20 20 20 20 this is.
17960 20 20 2a 2a 20 61 20 63 72 69 74 69 63 61 6c 20 ** a critical
17970 49 2f 4f 20 65 72 72 6f 72 0a 20 20 20 20 20 20 I/O error.
17980 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 */.
17990 20 72 63 20 3d 20 28 28 66 61 69 6c 65 64 20 26 rc = ((failed &
179a0 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 20 3d SQLITE_IOERR) =
179b0 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 20 = SQLITE_IOERR)
179c0 3f 20 66 61 69 6c 65 64 32 20 3a 20 0a 20 20 20 ? failed2 : .
179d0 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
179e0 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3b 0a 20 TE_IOERR_LOCK;.
179f0 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 61 66 goto af
17a00 70 5f 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 p_end_lock;.
17a10 20 20 20 20 7d 20 0a 20 20 20 20 20 20 7d 65 6c } . }el
17a20 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d se{. rc =
17a30 20 66 61 69 6c 65 64 3b 20 0a 20 20 20 20 20 20 failed; .
17a40 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
17a50 66 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 failed ){.
17a60 72 63 20 3d 20 66 61 69 6c 65 64 3b 0a 20 20 20 rc = failed;.
17a70 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 69 66 28 20 }. }. . if(
17a80 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
17a90 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c . pFile->eFil
17aa0 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 eLock = eFileLoc
17ab0 6b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 k;. pInode->e
17ac0 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 FileLock = eFile
17ad0 4c 6f 63 6b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 Lock;. }else if
17ae0 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 ( eFileLock==EXC
17af0 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 7b 0a 20 LUSIVE_LOCK ){.
17b00 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c pFile->eFileL
17b10 6f 63 6b 20 3d 20 50 45 4e 44 49 4e 47 5f 4c 4f ock = PENDING_LO
17b20 43 4b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e CK;. pInode->
17b30 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44 eFileLock = PEND
17b40 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 20 ING_LOCK;. }.
17b50 0a 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3a 0a 20 .afp_end_lock:.
17b60 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
17b70 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 4c );. OSTRACE(("L
17b80 4f 43 4b 20 20 20 20 25 64 20 25 73 20 25 73 20 OCK %d %s %s
17b90 28 61 66 70 29 5c 6e 22 2c 20 70 46 69 6c 65 2d (afp)\n", pFile-
17ba0 3e 68 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 >h, azFileLock(e
17bb0 46 69 6c 65 4c 6f 63 6b 29 2c 20 0a 20 20 20 20 FileLock), .
17bc0 20 20 20 20 20 72 63 3d 3d 53 51 4c 49 54 45 5f rc==SQLITE_
17bd0 4f 4b 20 3f 20 22 6f 6b 22 20 3a 20 22 66 61 69 OK ? "ok" : "fai
17be0 6c 65 64 22 29 29 3b 0a 20 20 72 65 74 75 72 6e led"));. return
17bf0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f rc;.}../*.** Lo
17c00 77 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 wer the locking
17c10 6c 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 level on file de
17c20 73 63 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74 scriptor pFile t
17c30 6f 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 o eFileLock. eF
17c40 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 ileLock.** must
17c50 62 65 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 be either NO_LOC
17c60 4b 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b K or SHARED_LOCK
17c70 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c ..**.** If the l
17c80 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 ocking level of
17c90 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 the file descrip
17ca0 74 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 61 tor is already a
17cb0 74 20 6f 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 t or below.** th
17cc0 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b e requested lock
17cd0 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 ing level, this
17ce0 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d routine is a no-
17cf0 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e op..*/.static in
17d00 74 20 61 66 70 55 6e 6c 6f 63 6b 28 73 71 6c 69 t afpUnlock(sqli
17d10 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e te3_file *id, in
17d20 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 t eFileLock) {.
17d30 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
17d40 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 _OK;. unixFile
17d50 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 *pFile = (unixFi
17d60 6c 65 2a 29 69 64 3b 0a 20 20 75 6e 69 78 49 6e le*)id;. unixIn
17d70 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b odeInfo *pInode;
17d80 0a 20 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e . afpLockingCon
17d90 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 20 3d 20 text *context =
17da0 28 61 66 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 (afpLockingConte
17db0 78 74 20 2a 29 20 70 46 69 6c 65 2d 3e 6c 6f 63 xt *) pFile->loc
17dc0 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 20 20 69 kingContext;. i
17dd0 6e 74 20 73 6b 69 70 53 68 61 72 65 64 20 3d 20 nt skipShared =
17de0 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 0;.#ifdef SQLITE
17df0 5f 54 45 53 54 0a 20 20 69 6e 74 20 68 20 3d 20 _TEST. int h =
17e00 70 46 69 6c 65 2d 3e 68 3b 0a 23 65 6e 64 69 66 pFile->h;.#endif
17e10 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c .. assert( pFil
17e20 65 20 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 e );. OSTRACE((
17e30 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25 64 20 77 "UNLOCK %d %d w
17e40 61 73 20 25 64 28 25 64 2c 25 64 29 20 70 69 64 as %d(%d,%d) pid
17e50 3d 25 64 20 28 61 66 70 29 5c 6e 22 2c 20 70 46 =%d (afp)\n", pF
17e60 69 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 ile->h, eFileLoc
17e70 6b 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 46 k,. pF
17e80 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 ile->eFileLock,
17e90 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 65 pFile->pInode->e
17ea0 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 69 6c 65 2d FileLock, pFile-
17eb0 3e 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 >pInode->nShared
17ec0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 6f 73 47 ,. osG
17ed0 65 74 70 69 64 28 30 29 29 29 3b 0a 0a 20 20 61 etpid(0)));.. a
17ee0 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b ssert( eFileLock
17ef0 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b <=SHARED_LOCK );
17f00 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 . if( pFile->eF
17f10 69 6c 65 4c 6f 63 6b 3c 3d 65 46 69 6c 65 4c 6f ileLock<=eFileLo
17f20 63 6b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ck ){. return
17f30 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
17f40 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 unixEnterMutex
17f50 28 29 3b 0a 20 20 70 49 6e 6f 64 65 20 3d 20 70 ();. pInode = p
17f60 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 File->pInode;.
17f70 61 73 73 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e assert( pInode->
17f80 6e 53 68 61 72 65 64 21 3d 30 20 29 3b 0a 20 20 nShared!=0 );.
17f90 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 if( pFile->eFile
17fa0 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f 43 4b Lock>SHARED_LOCK
17fb0 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
17fc0 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 pInode->eFileLoc
17fd0 6b 3d 3d 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c k==pFile->eFileL
17fe0 6f 63 6b 20 29 3b 0a 20 20 20 20 53 69 6d 75 6c ock );. Simul
17ff0 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e ateIOErrorBenign
18000 28 31 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 (1);. Simulat
18010 65 49 4f 45 72 72 6f 72 28 20 68 3d 28 2d 31 29 eIOError( h=(-1)
18020 20 29 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49 ). SimulateI
18030 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 30 29 3b OErrorBenign(0);
18040 0a 20 20 20 20 0a 23 69 66 64 65 66 20 53 51 4c . .#ifdef SQL
18050 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a ITE_DEBUG. /*
18060 20 57 68 65 6e 20 72 65 64 75 63 69 6e 67 20 61 When reducing a
18070 20 6c 6f 63 6b 20 73 75 63 68 20 74 68 61 74 20 lock such that
18080 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 other processes
18090 63 61 6e 20 73 74 61 72 74 0a 20 20 20 20 2a 2a can start. **
180a0 20 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 reading the dat
180b0 61 62 61 73 65 20 66 69 6c 65 20 61 67 61 69 6e abase file again
180c0 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 , make sure that
180d0 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 72 61 6e the. ** tran
180e0 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 saction counter
180f0 77 61 73 20 75 70 64 61 74 65 64 20 69 66 20 61 was updated if a
18100 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 ny part of the d
18110 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 atabase. ** f
18120 69 6c 65 20 63 68 61 6e 67 65 64 2e 20 20 49 66 ile changed. If
18130 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
18140 20 63 6f 75 6e 74 65 72 20 69 73 20 6e 6f 74 20 counter is not
18150 75 70 64 61 74 65 64 2c 0a 20 20 20 20 2a 2a 20 updated,. **
18160 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
18170 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20 66 69 s to the same fi
18180 6c 65 20 6d 69 67 68 74 20 6e 6f 74 20 72 65 61 le might not rea
18190 6c 69 7a 65 20 74 68 61 74 0a 20 20 20 20 2a 2a lize that. **
181a0 20 74 68 65 20 66 69 6c 65 20 68 61 73 20 63 68 the file has ch
181b0 61 6e 67 65 64 20 61 6e 64 20 68 65 6e 63 65 20 anged and hence
181c0 6d 69 67 68 74 20 6e 6f 74 20 6b 6e 6f 77 20 74 might not know t
181d0 6f 20 66 6c 75 73 68 20 74 68 65 69 72 0a 20 20 o flush their.
181e0 20 20 2a 2a 20 63 61 63 68 65 2e 20 20 54 68 65 ** cache. The
181f0 20 75 73 65 20 6f 66 20 61 20 73 74 61 6c 65 20 use of a stale
18200 63 61 63 68 65 20 63 61 6e 20 6c 65 61 64 20 74 cache can lead t
18210 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 o database corru
18220 70 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 ption.. */.
18230 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d assert( pFile-
18240 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 65 3d 3d >inNormalWrite==
18250 30 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 0. ||
18260 70 46 69 6c 65 2d 3e 64 62 55 70 64 61 74 65 3d pFile->dbUpdate=
18270 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c =0. ||
18280 20 70 46 69 6c 65 2d 3e 74 72 61 6e 73 43 6e 74 pFile->transCnt
18290 72 43 68 6e 67 3d 3d 31 20 29 3b 0a 20 20 20 20 rChng==1 );.
182a0 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 pFile->inNormalW
182b0 72 69 74 65 20 3d 20 30 3b 0a 23 65 6e 64 69 66 rite = 0;.#endif
182c0 0a 20 20 20 20 0a 20 20 20 20 69 66 28 20 70 46 . . if( pF
182d0 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d ile->eFileLock==
182e0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 EXCLUSIVE_LOCK )
182f0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 66 70 {. rc = afp
18300 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d SetLock(context-
18310 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20 >dbPath, pFile,
18320 53 48 41 52 45 44 5f 46 49 52 53 54 2c 20 53 48 SHARED_FIRST, SH
18330 41 52 45 44 5f 53 49 5a 45 2c 20 30 29 3b 0a 20 ARED_SIZE, 0);.
18340 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
18350 49 54 45 5f 4f 4b 20 26 26 20 28 65 46 69 6c 65 ITE_OK && (eFile
18360 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 Lock==SHARED_LOC
18370 4b 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 K || pInode->nSh
18380 61 72 65 64 3e 31 29 20 29 7b 0a 20 20 20 20 20 ared>1) ){.
18390 20 20 20 2f 2a 20 6f 6e 6c 79 20 72 65 2d 65 73 /* only re-es
183a0 74 61 62 6c 69 73 68 20 74 68 65 20 73 68 61 72 tablish the shar
183b0 65 64 20 6c 6f 63 6b 20 69 66 20 6e 65 63 65 73 ed lock if neces
183c0 73 61 72 79 20 2a 2f 0a 20 20 20 20 20 20 20 20 sary */.
183d0 69 6e 74 20 73 68 61 72 65 64 4c 6f 63 6b 42 79 int sharedLockBy
183e0 74 65 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53 te = SHARED_FIRS
183f0 54 2b 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64 T+pInode->shared
18400 42 79 74 65 3b 0a 20 20 20 20 20 20 20 20 72 63 Byte;. rc
18410 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f = afpSetLock(co
18420 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 ntext->dbPath, p
18430 46 69 6c 65 2c 20 73 68 61 72 65 64 4c 6f 63 6b File, sharedLock
18440 42 79 74 65 2c 20 31 2c 20 31 29 3b 0a 20 20 20 Byte, 1, 1);.
18450 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 } else {.
18460 20 20 20 20 73 6b 69 70 53 68 61 72 65 64 20 3d skipShared =
18470 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1;. }.
18480 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
18490 4c 49 54 45 5f 4f 4b 20 26 26 20 70 46 69 6c 65 LITE_OK && pFile
184a0 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 50 45 4e ->eFileLock>=PEN
184b0 44 49 4e 47 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 DING_LOCK ){.
184c0 20 20 20 72 63 20 3d 20 61 66 70 53 65 74 4c 6f rc = afpSetLo
184d0 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 ck(context->dbPa
184e0 74 68 2c 20 70 46 69 6c 65 2c 20 50 45 4e 44 49 th, pFile, PENDI
184f0 4e 47 5f 42 59 54 45 2c 20 31 2c 20 30 29 3b 0a NG_BYTE, 1, 0);.
18500 20 20 20 20 7d 20 0a 20 20 20 20 69 66 28 20 72 } . if( r
18510 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
18520 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b pFile->eFileLock
18530 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 >=RESERVED_LOCK
18540 26 26 20 63 6f 6e 74 65 78 74 2d 3e 72 65 73 65 && context->rese
18550 72 76 65 64 20 29 7b 0a 20 20 20 20 20 20 72 63 rved ){. rc
18560 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f = afpSetLock(co
18570 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 ntext->dbPath, p
18580 46 69 6c 65 2c 20 52 45 53 45 52 56 45 44 5f 42 File, RESERVED_B
18590 59 54 45 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 YTE, 1, 0);.
185a0 20 20 69 66 28 20 21 72 63 20 29 7b 20 0a 20 20 if( !rc ){ .
185b0 20 20 20 20 20 20 63 6f 6e 74 65 78 74 2d 3e 72 context->r
185c0 65 73 65 72 76 65 64 20 3d 20 30 3b 20 0a 20 20 eserved = 0; .
185d0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
185e0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
185f0 4b 20 26 26 20 28 65 46 69 6c 65 4c 6f 63 6b 3d K && (eFileLock=
18600 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c 20 =SHARED_LOCK ||
18610 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e pInode->nShared>
18620 31 29 29 7b 0a 20 20 20 20 20 20 70 49 6e 6f 64 1)){. pInod
18630 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 53 e->eFileLock = S
18640 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 HARED_LOCK;.
18650 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d }. }. if( rc==
18660 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 46 69 SQLITE_OK && eFi
18670 6c 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 leLock==NO_LOCK
18680 29 7b 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 ){.. /* Decre
18690 6d 65 6e 74 20 74 68 65 20 73 68 61 72 65 64 20 ment the shared
186a0 6c 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20 20 52 lock counter. R
186b0 65 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b 20 elease the lock
186c0 75 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a 20 using an. **
186d0 4f 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77 68 65 OS call only whe
186e0 6e 20 61 6c 6c 20 74 68 72 65 61 64 73 20 69 6e n all threads in
186f0 20 74 68 69 73 20 73 61 6d 65 20 70 72 6f 63 65 this same proce
18700 73 73 20 68 61 76 65 20 72 65 6c 65 61 73 65 64 ss have released
18710 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b . ** the lock
18720 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 75 6e 73 .. */. uns
18730 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 igned long long
18740 73 68 61 72 65 64 4c 6f 63 6b 42 79 74 65 20 3d sharedLockByte =
18750 20 53 48 41 52 45 44 5f 46 49 52 53 54 2b 70 49 SHARED_FIRST+pI
18760 6e 6f 64 65 2d 3e 73 68 61 72 65 64 42 79 74 65 node->sharedByte
18770 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 53 ;. pInode->nS
18780 68 61 72 65 64 2d 2d 3b 0a 20 20 20 20 69 66 28 hared--;. if(
18790 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 pInode->nShared
187a0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 53 69 6d ==0 ){. Sim
187b0 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 ulateIOErrorBeni
187c0 67 6e 28 31 29 3b 0a 20 20 20 20 20 20 53 69 6d gn(1);. Sim
187d0 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 68 3d ulateIOError( h=
187e0 28 2d 31 29 20 29 0a 20 20 20 20 20 20 53 69 6d (-1) ). Sim
187f0 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 ulateIOErrorBeni
18800 67 6e 28 30 29 3b 0a 20 20 20 20 20 20 69 66 28 gn(0);. if(
18810 20 21 73 6b 69 70 53 68 61 72 65 64 20 29 7b 0a !skipShared ){.
18820 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 66 70 rc = afp
18830 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d SetLock(context-
18840 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20 >dbPath, pFile,
18850 73 68 61 72 65 64 4c 6f 63 6b 42 79 74 65 2c 20 sharedLockByte,
18860 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 1, 0);. }.
18870 20 20 20 20 20 69 66 28 20 21 72 63 20 29 7b 0a if( !rc ){.
18880 20 20 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e pInode->
18890 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c eFileLock = NO_L
188a0 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 70 46 69 OCK;. pFi
188b0 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 le->eFileLock =
188c0 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d NO_LOCK;. }
188d0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
188e0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
188f0 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c pInode->nL
18900 6f 63 6b 2d 2d 3b 0a 20 20 20 20 20 20 61 73 73 ock--;. ass
18910 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f ert( pInode->nLo
18920 63 6b 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 ck>=0 );. i
18930 66 28 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b f( pInode->nLock
18940 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 63 ==0 ){. c
18950 6c 6f 73 65 50 65 6e 64 69 6e 67 46 64 73 28 70 losePendingFds(p
18960 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 File);. }.
18970 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 75 6e }. }. . un
18980 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a ixLeaveMutex();.
18990 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
189a0 5f 4f 4b 20 29 20 70 46 69 6c 65 2d 3e 65 46 69 _OK ) pFile->eFi
189b0 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f leLock = eFileLo
189c0 63 6b 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b ck;. return rc;
189d0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 .}../*.** Close
189e0 61 20 66 69 6c 65 20 26 20 63 6c 65 61 6e 75 70 a file & cleanup
189f0 20 41 46 50 20 73 70 65 63 69 66 69 63 20 6c 6f AFP specific lo
18a00 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 20 0a 2a cking context .*
18a10 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66 70 /.static int afp
18a20 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 Close(sqlite3_fi
18a30 6c 65 20 2a 69 64 29 20 7b 0a 20 20 69 6e 74 20 le *id) {. int
18a40 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
18a50 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
18a60 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
18a70 64 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 21 d;. assert( id!
18a80 3d 30 20 29 3b 0a 20 20 61 66 70 55 6e 6c 6f 63 =0 );. afpUnloc
18a90 6b 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a k(id, NO_LOCK);.
18aa0 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 unixEnterMutex
18ab0 28 29 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 2d ();. if( pFile-
18ac0 3e 70 49 6e 6f 64 65 20 26 26 20 70 46 69 6c 65 >pInode && pFile
18ad0 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 20 ->pInode->nLock
18ae0 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 ){. /* If the
18af0 72 65 20 61 72 65 20 6f 75 74 73 74 61 6e 64 69 re are outstandi
18b00 6e 67 20 6c 6f 63 6b 73 2c 20 64 6f 20 6e 6f 74 ng locks, do not
18b10 20 61 63 74 75 61 6c 6c 79 20 63 6c 6f 73 65 20 actually close
18b20 74 68 65 20 66 69 6c 65 20 6a 75 73 74 0a 20 20 the file just.
18b30 20 20 2a 2a 20 79 65 74 20 62 65 63 61 75 73 65 ** yet because
18b40 20 74 68 61 74 20 77 6f 75 6c 64 20 63 6c 65 61 that would clea
18b50 72 20 74 68 6f 73 65 20 6c 6f 63 6b 73 2e 20 20 r those locks.
18b60 49 6e 73 74 65 61 64 2c 20 61 64 64 20 74 68 65 Instead, add the
18b70 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 64 65 73 file. ** des
18b80 63 72 69 70 74 6f 72 20 74 6f 20 70 49 6e 6f 64 criptor to pInod
18b90 65 2d 3e 61 50 65 6e 64 69 6e 67 2e 20 20 49 74 e->aPending. It
18ba0 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 will be automat
18bb0 69 63 61 6c 6c 79 20 63 6c 6f 73 65 64 20 77 68 ically closed wh
18bc0 65 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 61 en. ** the la
18bd0 73 74 20 6c 6f 63 6b 20 69 73 20 63 6c 65 61 72 st lock is clear
18be0 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 ed.. */. s
18bf0 65 74 50 65 6e 64 69 6e 67 46 64 28 70 46 69 6c etPendingFd(pFil
18c00 65 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 e);. }. releas
18c10 65 49 6e 6f 64 65 49 6e 66 6f 28 70 46 69 6c 65 eInodeInfo(pFile
18c20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 );. sqlite3_fre
18c30 65 28 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 e(pFile->locking
18c40 43 6f 6e 74 65 78 74 29 3b 0a 20 20 72 63 20 3d Context);. rc =
18c50 20 63 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28 69 closeUnixFile(i
18c60 64 29 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d d);. unixLeaveM
18c70 75 74 65 78 28 29 3b 0a 20 20 72 65 74 75 72 6e utex();. return
18c80 20 72 63 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f rc;.}..#endif /
18c90 2a 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c * defined(__APPL
18ca0 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 E__) && SQLITE_E
18cb0 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
18cc0 59 4c 45 20 2a 2f 0a 2f 2a 0a 2a 2a 20 54 68 65 YLE */./*.** The
18cd0 20 63 6f 64 65 20 61 62 6f 76 65 20 69 73 20 74 code above is t
18ce0 68 65 20 41 46 50 20 6c 6f 63 6b 20 69 6d 70 6c he AFP lock impl
18cf0 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54 68 65 ementation. The
18d00 20 63 6f 64 65 20 69 73 20 73 70 65 63 69 66 69 code is specifi
18d10 63 0a 2a 2a 20 74 6f 20 4d 61 63 4f 53 58 20 61 c.** to MacOSX a
18d20 6e 64 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b nd does not work
18d30 20 6f 6e 20 6f 74 68 65 72 20 75 6e 69 78 20 70 on other unix p
18d40 6c 61 74 66 6f 72 6d 73 2e 20 20 4e 6f 20 61 6c latforms. No al
18d50 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 69 73 20 ternative.** is
18d60 61 76 61 69 6c 61 62 6c 65 2e 20 20 49 66 20 79 available. If y
18d70 6f 75 20 64 6f 6e 27 74 20 63 6f 6d 70 69 6c 65 ou don't compile
18d80 20 66 6f 72 20 61 20 6d 61 63 2c 20 74 68 65 6e for a mac, then
18d90 20 74 68 65 20 22 75 6e 69 78 2d 61 66 70 22 0a the "unix-afp".
18da0 2a 2a 20 56 46 53 20 69 73 20 6e 6f 74 20 61 76 ** VFS is not av
18db0 61 69 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 2a 2a ailable..**.****
18dc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18dd0 2a 20 45 6e 64 20 6f 66 20 74 68 65 20 41 46 50 * End of the AFP
18de0 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61 lock implementa
18df0 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a tion ***********
18e00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a ***********.****
18e10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a **********/../**
18e60 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e70 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18e90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18ea0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a ************.***
18eb0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18ec0 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 4e ******** Begin N
18ed0 46 53 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a FS Locking *****
18ee0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18ef0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 23 69 ***********/..#i
18f00 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c f defined(__APPL
18f10 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 E__) && SQLITE_E
18f20 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
18f30 59 4c 45 0a 2f 2a 0a 20 2a 2a 20 4c 6f 77 65 72 YLE./*. ** Lower
18f40 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 the locking lev
18f50 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 el on file descr
18f60 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 iptor pFile to e
18f70 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 FileLock. eFile
18f80 4c 6f 63 6b 0a 20 2a 2a 20 6d 75 73 74 20 62 65 Lock. ** must be
18f90 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 either NO_LOCK
18fa0 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a or SHARED_LOCK..
18fb0 20 2a 2a 0a 20 2a 2a 20 49 66 20 74 68 65 20 6c **. ** If the l
18fc0 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 ocking level of
18fd0 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 the file descrip
18fe0 74 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 61 tor is already a
18ff0 74 20 6f 72 20 62 65 6c 6f 77 0a 20 2a 2a 20 74 t or below. ** t
19000 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 he requested loc
19010 6b 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 king level, this
19020 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f routine is a no
19030 2d 6f 70 2e 0a 20 2a 2f 0a 73 74 61 74 69 63 20 -op.. */.static
19040 69 6e 74 20 6e 66 73 55 6e 6c 6f 63 6b 28 73 71 int nfsUnlock(sq
19050 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
19060 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 7b 0a int eFileLock){.
19070 20 20 72 65 74 75 72 6e 20 70 6f 73 69 78 55 6e return posixUn
19080 6c 6f 63 6b 28 69 64 2c 20 65 46 69 6c 65 4c 6f lock(id, eFileLo
19090 63 6b 2c 20 31 29 3b 0a 7d 0a 0a 23 65 6e 64 69 ck, 1);.}..#endi
190a0 66 20 2f 2a 20 64 65 66 69 6e 65 64 28 5f 5f 41 f /* defined(__A
190b0 50 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 PPLE__) && SQLIT
190c0 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
190d0 5f 53 54 59 4c 45 20 2a 2f 0a 2f 2a 0a 2a 2a 20 _STYLE */./*.**
190e0 54 68 65 20 63 6f 64 65 20 61 62 6f 76 65 20 69 The code above i
190f0 73 20 74 68 65 20 4e 46 53 20 6c 6f 63 6b 20 69 s the NFS lock i
19100 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 mplementation.
19110 54 68 65 20 63 6f 64 65 20 69 73 20 73 70 65 63 The code is spec
19120 69 66 69 63 0a 2a 2a 20 74 6f 20 4d 61 63 4f 53 ific.** to MacOS
19130 58 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 77 X and does not w
19140 6f 72 6b 20 6f 6e 20 6f 74 68 65 72 20 75 6e 69 ork on other uni
19150 78 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20 4e 6f x platforms. No
19160 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 alternative.**
19170 69 73 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 0a is available. .
19180 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
19190 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 ******** End of
191a0 74 68 65 20 4e 46 53 20 6c 6f 63 6b 20 69 6d 70 the NFS lock imp
191b0 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a lementation ****
191c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
191d0 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **.*************
191e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
191f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19200 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19210 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19220 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a */../***********
19230 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19240 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19250 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19260 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19270 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***.************
19280 2a 2a 2a 2a 20 4e 6f 6e 2d 6c 6f 63 6b 69 6e 67 **** Non-locking
19290 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 6d 65 sqlite3_file me
192a0 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a thods **********
192b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
192c0 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 65 ***.**.** The ne
192d0 78 74 20 64 69 76 69 73 69 6f 6e 20 63 6f 6e 74 xt division cont
192e0 61 69 6e 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 ains implementat
192f0 69 6f 6e 73 20 66 6f 72 20 61 6c 6c 20 6d 65 74 ions for all met
19300 68 6f 64 73 20 6f 66 20 74 68 65 20 0a 2a 2a 20 hods of the .**
19310 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 6f 62 6a sqlite3_file obj
19320 65 63 74 20 6f 74 68 65 72 20 74 68 61 6e 20 74 ect other than t
19330 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f he locking metho
19340 64 73 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 ds. The locking
19350 0a 2a 2a 20 6d 65 74 68 6f 64 73 20 77 65 72 65 .** methods were
19360 20 64 65 66 69 6e 65 64 20 69 6e 20 64 69 76 69 defined in divi
19370 73 69 6f 6e 73 20 61 62 6f 76 65 20 28 6f 6e 65 sions above (one
19380 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 20 locking method
19390 70 65 72 0a 2a 2a 20 64 69 76 69 73 69 6f 6e 29 per.** division)
193a0 2e 20 20 54 68 6f 73 65 20 6d 65 74 68 6f 64 73 . Those methods
193b0 20 74 68 61 74 20 61 72 65 20 63 6f 6d 6d 6f 6e that are common
193c0 20 74 6f 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 to all locking
193d0 6d 6f 64 65 73 0a 2a 2a 20 61 72 65 20 67 61 74 modes.** are gat
193e0 68 65 72 20 74 6f 67 65 74 68 65 72 20 69 6e 74 her together int
193f0 6f 20 74 68 69 73 20 64 69 76 69 73 69 6f 6e 2e o this division.
19400 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 .*/../*.** Seek
19410 74 6f 20 74 68 65 20 6f 66 66 73 65 74 20 70 61 to the offset pa
19420 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f ssed as the seco
19430 6e 64 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 65 nd argument, the
19440 6e 20 72 65 61 64 20 63 6e 74 20 0a 2a 2a 20 62 n read cnt .** b
19450 79 74 65 73 20 69 6e 74 6f 20 70 42 75 66 2e 20 ytes into pBuf.
19460 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
19470 72 20 6f 66 20 62 79 74 65 73 20 61 63 74 75 61 r of bytes actua
19480 6c 6c 79 20 72 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 lly read..**.**
19490 4e 42 3a 20 20 49 66 20 79 6f 75 20 64 65 66 69 NB: If you defi
194a0 6e 65 20 55 53 45 5f 50 52 45 41 44 20 6f 72 20 ne USE_PREAD or
194b0 55 53 45 5f 50 52 45 41 44 36 34 2c 20 74 68 65 USE_PREAD64, the
194c0 6e 20 69 74 20 6d 69 67 68 74 20 61 6c 73 6f 0a n it might also.
194d0 2a 2a 20 62 65 20 6e 65 63 65 73 73 61 72 79 20 ** be necessary
194e0 74 6f 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e to define _XOPEN
194f0 5f 53 4f 55 52 43 45 20 74 6f 20 62 65 20 35 30 _SOURCE to be 50
19500 30 2e 20 20 54 68 69 73 20 76 61 72 69 65 73 20 0. This varies
19510 66 72 6f 6d 0a 2a 2a 20 6f 6e 65 20 73 79 73 74 from.** one syst
19520 65 6d 20 74 6f 20 61 6e 6f 74 68 65 72 2e 20 20 em to another.
19530 53 69 6e 63 65 20 53 51 4c 69 74 65 20 64 6f 65 Since SQLite doe
19540 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 55 53 45 s not define USE
19550 5f 50 52 45 41 44 0a 2a 2a 20 69 6e 20 61 6e 79 _PREAD.** in any
19560 20 66 6f 72 6d 20 62 79 20 64 65 66 61 75 6c 74 form by default
19570 2c 20 77 65 20 77 69 6c 6c 20 6e 6f 74 20 61 74 , we will not at
19580 74 65 6d 70 74 20 74 6f 20 64 65 66 69 6e 65 20 tempt to define
19590 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 2e 0a 2a _XOPEN_SOURCE..*
195a0 2a 20 53 65 65 20 74 69 63 6b 65 74 73 20 23 32 * See tickets #2
195b0 37 34 31 20 61 6e 64 20 23 32 36 38 31 2e 0a 2a 741 and #2681..*
195c0 2a 0a 2a 2a 20 54 6f 20 61 76 6f 69 64 20 73 74 *.** To avoid st
195d0 6f 6d 70 69 6e 67 20 74 68 65 20 65 72 72 6e 6f omping the errno
195e0 20 76 61 6c 75 65 20 6f 6e 20 61 20 66 61 69 6c value on a fail
195f0 65 64 20 72 65 61 64 20 74 68 65 20 6c 61 73 74 ed read the last
19600 45 72 72 6e 6f 20 76 61 6c 75 65 0a 2a 2a 20 69 Errno value.** i
19610 73 20 73 65 74 20 62 65 66 6f 72 65 20 72 65 74 s set before ret
19620 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 urning..*/.stati
19630 63 20 69 6e 74 20 73 65 65 6b 41 6e 64 52 65 61 c int seekAndRea
19640 64 28 75 6e 69 78 46 69 6c 65 20 2a 69 64 2c 20 d(unixFile *id,
19650 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6f 66 sqlite3_int64 of
19660 66 73 65 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 fset, void *pBuf
19670 2c 20 69 6e 74 20 63 6e 74 29 7b 0a 20 20 69 6e , int cnt){. in
19680 74 20 67 6f 74 3b 0a 20 20 69 6e 74 20 70 72 69 t got;. int pri
19690 6f 72 20 3d 20 30 3b 0a 23 69 66 20 28 21 64 65 or = 0;.#if (!de
196a0 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29 fined(USE_PREAD)
196b0 20 26 26 20 21 64 65 66 69 6e 65 64 28 55 53 45 && !defined(USE
196c0 5f 50 52 45 41 44 36 34 29 29 0a 20 20 69 36 34 _PREAD64)). i64
196d0 20 6e 65 77 4f 66 66 73 65 74 3b 0a 23 65 6e 64 newOffset;.#end
196e0 69 66 0a 20 20 54 49 4d 45 52 5f 53 54 41 52 54 if. TIMER_START
196f0 3b 0a 20 20 61 73 73 65 72 74 28 20 63 6e 74 3d ;. assert( cnt=
19700 3d 28 63 6e 74 26 30 78 31 66 66 66 66 29 20 29 =(cnt&0x1ffff) )
19710 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 2d 3e ;. assert( id->
19720 68 3e 32 20 29 3b 0a 20 20 64 6f 7b 0a 23 69 66 h>2 );. do{.#if
19730 20 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 defined(USE_PRE
19740 41 44 29 0a 20 20 20 20 67 6f 74 20 3d 20 6f 73 AD). got = os
19750 50 72 65 61 64 28 69 64 2d 3e 68 2c 20 70 42 75 Pread(id->h, pBu
19760 66 2c 20 63 6e 74 2c 20 6f 66 66 73 65 74 29 3b f, cnt, offset);
19770 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 . SimulateIOE
19780 72 72 6f 72 28 20 67 6f 74 20 3d 20 2d 31 20 29 rror( got = -1 )
19790 3b 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 ;.#elif defined(
197a0 55 53 45 5f 50 52 45 41 44 36 34 29 0a 20 20 20 USE_PREAD64).
197b0 20 67 6f 74 20 3d 20 6f 73 50 72 65 61 64 36 34 got = osPread64
197c0 28 69 64 2d 3e 68 2c 20 70 42 75 66 2c 20 63 6e (id->h, pBuf, cn
197d0 74 2c 20 6f 66 66 73 65 74 29 3b 0a 20 20 20 20 t, offset);.
197e0 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 SimulateIOError(
197f0 20 67 6f 74 20 3d 20 2d 31 20 29 3b 0a 23 65 6c got = -1 );.#el
19800 73 65 0a 20 20 20 20 6e 65 77 4f 66 66 73 65 74 se. newOffset
19810 20 3d 20 6c 73 65 65 6b 28 69 64 2d 3e 68 2c 20 = lseek(id->h,
19820 6f 66 66 73 65 74 2c 20 53 45 45 4b 5f 53 45 54 offset, SEEK_SET
19830 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49 );. SimulateI
19840 4f 45 72 72 6f 72 28 20 6e 65 77 4f 66 66 73 65 OError( newOffse
19850 74 20 3d 20 2d 31 20 29 3b 0a 20 20 20 20 69 66 t = -1 );. if
19860 28 20 6e 65 77 4f 66 66 73 65 74 3c 30 20 29 7b ( newOffset<0 ){
19870 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 . storeLast
19880 45 72 72 6e 6f 28 28 75 6e 69 78 46 69 6c 65 2a Errno((unixFile*
19890 29 69 64 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 )id, errno);.
198a0 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a 20 20 return -1;.
198b0 20 20 7d 0a 20 20 20 20 67 6f 74 20 3d 20 6f 73 }. got = os
198c0 52 65 61 64 28 69 64 2d 3e 68 2c 20 70 42 75 66 Read(id->h, pBuf
198d0 2c 20 63 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 20 , cnt);.#endif.
198e0 20 20 20 69 66 28 20 67 6f 74 3d 3d 63 6e 74 20 if( got==cnt
198f0 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 69 66 28 ) break;. if(
19900 20 67 6f 74 3c 30 20 29 7b 0a 20 20 20 20 20 20 got<0 ){.
19910 69 66 28 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 if( errno==EINTR
19920 20 29 7b 20 67 6f 74 20 3d 20 31 3b 20 63 6f 6e ){ got = 1; con
19930 74 69 6e 75 65 3b 20 7d 0a 20 20 20 20 20 20 70 tinue; }. p
19940 72 69 6f 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 rior = 0;.
19950 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 28 storeLastErrno((
19960 75 6e 69 78 46 69 6c 65 2a 29 69 64 2c 20 20 65 unixFile*)id, e
19970 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 62 72 65 rrno);. bre
19980 61 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 ak;. }else if
19990 28 20 67 6f 74 3e 30 20 29 7b 0a 20 20 20 20 20 ( got>0 ){.
199a0 20 63 6e 74 20 2d 3d 20 67 6f 74 3b 0a 20 20 20 cnt -= got;.
199b0 20 20 20 6f 66 66 73 65 74 20 2b 3d 20 67 6f 74 offset += got
199c0 3b 0a 20 20 20 20 20 20 70 72 69 6f 72 20 2b 3d ;. prior +=
199d0 20 67 6f 74 3b 0a 20 20 20 20 20 20 70 42 75 66 got;. pBuf
199e0 20 3d 20 28 76 6f 69 64 2a 29 28 67 6f 74 20 2b = (void*)(got +
199f0 20 28 63 68 61 72 2a 29 70 42 75 66 29 3b 0a 20 (char*)pBuf);.
19a00 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 67 }. }while( g
19a10 6f 74 3e 30 20 29 3b 0a 20 20 54 49 4d 45 52 5f ot>0 );. TIMER_
19a20 45 4e 44 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 END;. OSTRACE((
19a30 22 52 45 41 44 20 20 20 20 25 2d 33 64 20 25 35 "READ %-3d %5
19a40 64 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e 22 2c d %7lld %llu\n",
19a50 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 64 2d . id-
19a60 3e 68 2c 20 67 6f 74 2b 70 72 69 6f 72 2c 20 6f >h, got+prior, o
19a70 66 66 73 65 74 2d 70 72 69 6f 72 2c 20 54 49 4d ffset-prior, TIM
19a80 45 52 5f 45 4c 41 50 53 45 44 29 29 3b 0a 20 20 ER_ELAPSED));.
19a90 72 65 74 75 72 6e 20 67 6f 74 2b 70 72 69 6f 72 return got+prior
19aa0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 ;.}../*.** Read
19ab0 64 61 74 61 20 66 72 6f 6d 20 61 20 66 69 6c 65 data from a file
19ac0 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72 2e 20 into a buffer.
19ad0 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
19ae0 4b 20 69 66 20 61 6c 6c 0a 2a 2a 20 62 79 74 65 K if all.** byte
19af0 73 20 77 65 72 65 20 72 65 61 64 20 73 75 63 63 s were read succ
19b00 65 73 73 66 75 6c 6c 79 20 61 6e 64 20 53 51 4c essfully and SQL
19b10 49 54 45 5f 49 4f 45 52 52 20 69 66 20 61 6e 79 ITE_IOERR if any
19b20 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 77 72 thing goes.** wr
19b30 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ong..*/.static i
19b40 6e 74 20 75 6e 69 78 52 65 61 64 28 0a 20 20 73 nt unixRead(. s
19b50 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c qlite3_file *id,
19b60 20 0a 20 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 . void *pBuf,
19b70 0a 20 20 69 6e 74 20 61 6d 74 2c 0a 20 20 73 71 . int amt,. sq
19b80 6c 69 74 65 33 5f 69 6e 74 36 34 20 6f 66 66 73 lite3_int64 offs
19b90 65 74 0a 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 et.){. unixFile
19ba0 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 *pFile = (unixF
19bb0 69 6c 65 20 2a 29 69 64 3b 0a 20 20 69 6e 74 20 ile *)id;. int
19bc0 67 6f 74 3b 0a 20 20 61 73 73 65 72 74 28 20 69 got;. assert( i
19bd0 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6f d );. assert( o
19be0 66 66 73 65 74 3e 3d 30 20 29 3b 0a 20 20 61 73 ffset>=0 );. as
19bf0 73 65 72 74 28 20 61 6d 74 3e 30 20 29 3b 0a 0a sert( amt>0 );..
19c00 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 /* If this is
19c10 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 a database file
19c20 28 6e 6f 74 20 61 20 6a 6f 75 72 6e 61 6c 2c 20 (not a journal,
19c30 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6f master-journal o
19c40 72 20 74 65 6d 70 0a 20 20 2a 2a 20 66 69 6c 65 r temp. ** file
19c50 29 2c 20 74 68 65 20 62 79 74 65 73 20 69 6e 20 ), the bytes in
19c60 74 68 65 20 6c 6f 63 6b 69 6e 67 20 72 61 6e 67 the locking rang
19c70 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 e should never b
19c80 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 e read or writte
19c90 6e 2e 20 2a 2f 0a 23 69 66 20 30 0a 20 20 61 73 n. */.#if 0. as
19ca0 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 70 55 6e sert( pFile->pUn
19cb0 75 73 65 64 3d 3d 30 0a 20 20 20 20 20 20 20 7c used==0. |
19cc0 7c 20 6f 66 66 73 65 74 3e 3d 50 45 4e 44 49 4e | offset>=PENDIN
19cd0 47 5f 42 59 54 45 2b 35 31 32 0a 20 20 20 20 20 G_BYTE+512.
19ce0 20 20 7c 7c 20 6f 66 66 73 65 74 2b 61 6d 74 3c || offset+amt<
19cf0 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 0a 20 =PENDING_BYTE .
19d00 20 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 );.#endif..#if
19d10 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
19d20 53 49 5a 45 3e 30 0a 20 20 2f 2a 20 44 65 61 6c SIZE>0. /* Deal
19d30 20 77 69 74 68 20 61 73 20 6d 75 63 68 20 6f 66 with as much of
19d40 20 74 68 69 73 20 72 65 61 64 20 72 65 71 75 65 this read reque
19d50 73 74 20 61 73 20 70 6f 73 73 69 62 6c 65 20 62 st as possible b
19d60 79 20 74 72 61 6e 73 66 65 72 69 6e 67 0a 20 20 y transfering.
19d70 2a 2a 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 ** data from the
19d80 20 6d 65 6d 6f 72 79 20 6d 61 70 70 69 6e 67 20 memory mapping
19d90 75 73 69 6e 67 20 6d 65 6d 63 70 79 28 29 2e 20 using memcpy().
19da0 20 2a 2f 0a 20 20 69 66 28 20 6f 66 66 73 65 74 */. if( offset
19db0 3c 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 <pFile->mmapSize
19dc0 20 29 7b 0a 20 20 20 20 69 66 28 20 6f 66 66 73 ){. if( offs
19dd0 65 74 2b 61 6d 74 20 3c 3d 20 70 46 69 6c 65 2d et+amt <= pFile-
19de0 3e 6d 6d 61 70 53 69 7a 65 20 29 7b 0a 20 20 20 >mmapSize ){.
19df0 20 20 20 6d 65 6d 63 70 79 28 70 42 75 66 2c 20 memcpy(pBuf,
19e00 26 28 28 75 38 20 2a 29 28 70 46 69 6c 65 2d 3e &((u8 *)(pFile->
19e10 70 4d 61 70 52 65 67 69 6f 6e 29 29 5b 6f 66 66 pMapRegion))[off
19e20 73 65 74 5d 2c 20 61 6d 74 29 3b 0a 20 20 20 20 set], amt);.
19e30 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
19e40 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 OK;. }else{.
19e50 20 20 20 20 20 69 6e 74 20 6e 43 6f 70 79 20 3d int nCopy =
19e60 20 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 pFile->mmapSize
19e70 20 2d 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 20 - offset;.
19e80 20 6d 65 6d 63 70 79 28 70 42 75 66 2c 20 26 28 memcpy(pBuf, &(
19e90 28 75 38 20 2a 29 28 70 46 69 6c 65 2d 3e 70 4d (u8 *)(pFile->pM
19ea0 61 70 52 65 67 69 6f 6e 29 29 5b 6f 66 66 73 65 apRegion))[offse
19eb0 74 5d 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20 t], nCopy);.
19ec0 20 20 70 42 75 66 20 3d 20 26 28 28 75 38 20 2a pBuf = &((u8 *
19ed0 29 70 42 75 66 29 5b 6e 43 6f 70 79 5d 3b 0a 20 )pBuf)[nCopy];.
19ee0 20 20 20 20 20 61 6d 74 20 2d 3d 20 6e 43 6f 70 amt -= nCop
19ef0 79 3b 0a 20 20 20 20 20 20 6f 66 66 73 65 74 20 y;. offset
19f00 2b 3d 20 6e 43 6f 70 79 3b 0a 20 20 20 20 7d 0a += nCopy;. }.
19f10 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 67 6f }.#endif.. go
19f20 74 20 3d 20 73 65 65 6b 41 6e 64 52 65 61 64 28 t = seekAndRead(
19f30 70 46 69 6c 65 2c 20 6f 66 66 73 65 74 2c 20 70 pFile, offset, p
19f40 42 75 66 2c 20 61 6d 74 29 3b 0a 20 20 69 66 28 Buf, amt);. if(
19f50 20 67 6f 74 3d 3d 61 6d 74 20 29 7b 0a 20 20 20 got==amt ){.
19f60 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
19f70 4b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 67 K;. }else if( g
19f80 6f 74 3c 30 20 29 7b 0a 20 20 20 20 2f 2a 20 6c ot<0 ){. /* l
19f90 61 73 74 45 72 72 6e 6f 20 73 65 74 20 62 79 20 astErrno set by
19fa0 73 65 65 6b 41 6e 64 52 65 61 64 20 2a 2f 0a 20 seekAndRead */.
19fb0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
19fc0 5f 49 4f 45 52 52 5f 52 45 41 44 3b 0a 20 20 7d _IOERR_READ;. }
19fd0 65 6c 73 65 7b 0a 20 20 20 20 73 74 6f 72 65 4c else{. storeL
19fe0 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 astErrno(pFile,
19ff0 30 29 3b 20 20 20 2f 2a 20 6e 6f 74 20 61 20 73 0); /* not a s
1a000 79 73 74 65 6d 20 65 72 72 6f 72 20 2a 2f 0a 20 ystem error */.
1a010 20 20 20 2f 2a 20 55 6e 72 65 61 64 20 70 61 72 /* Unread par
1a020 74 73 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 ts of the buffer
1a030 20 6d 75 73 74 20 62 65 20 7a 65 72 6f 2d 66 69 must be zero-fi
1a040 6c 6c 65 64 20 2a 2f 0a 20 20 20 20 6d 65 6d 73 lled */. mems
1a050 65 74 28 26 28 28 63 68 61 72 2a 29 70 42 75 66 et(&((char*)pBuf
1a060 29 5b 67 6f 74 5d 2c 20 30 2c 20 61 6d 74 2d 67 )[got], 0, amt-g
1a070 6f 74 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 ot);. return
1a080 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f SQLITE_IOERR_SHO
1a090 52 54 5f 52 45 41 44 3b 0a 20 20 7d 0a 7d 0a 0a RT_READ;. }.}..
1a0a0 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f /*.** Attempt to
1a0b0 20 73 65 65 6b 20 74 68 65 20 66 69 6c 65 2d 64 seek the file-d
1a0c0 65 73 63 72 69 70 74 6f 72 20 70 61 73 73 65 64 escriptor passed
1a0d0 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72 as the first ar
1a0e0 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 61 62 73 gument to.** abs
1a0f0 6f 6c 75 74 65 20 6f 66 66 73 65 74 20 69 4f 66 olute offset iOf
1a100 66 2c 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 f, then attempt
1a110 74 6f 20 77 72 69 74 65 20 6e 42 75 66 20 62 79 to write nBuf by
1a120 74 65 73 20 6f 66 20 64 61 74 61 20 66 72 6f 6d tes of data from
1a130 0a 2a 2a 20 70 42 75 66 20 74 6f 20 69 74 2e 20 .** pBuf to it.
1a140 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 If an error occu
1a150 72 73 2c 20 72 65 74 75 72 6e 20 2d 31 20 61 6e rs, return -1 an
1a160 64 20 73 65 74 20 2a 70 69 45 72 72 6e 6f 2e 20 d set *piErrno.
1a170 4f 74 68 65 72 77 69 73 65 2c 20 0a 2a 2a 20 72 Otherwise, .** r
1a180 65 74 75 72 6e 20 74 68 65 20 61 63 74 75 61 6c eturn the actual
1a190 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
1a1a0 20 77 72 69 74 74 65 6e 20 28 77 68 69 63 68 20 written (which
1a1b0 6d 61 79 20 62 65 20 6c 65 73 73 20 74 68 61 6e may be less than
1a1c0 0a 2a 2a 20 6e 42 75 66 29 2e 0a 2a 2f 0a 73 74 .** nBuf)..*/.st
1a1d0 61 74 69 63 20 69 6e 74 20 73 65 65 6b 41 6e 64 atic int seekAnd
1a1e0 57 72 69 74 65 46 64 28 0a 20 20 69 6e 74 20 66 WriteFd(. int f
1a1f0 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d,
1a200 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
1a210 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 74 6f le descriptor to
1a220 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a 20 20 69 write to */. i
1a230 36 34 20 69 4f 66 66 2c 20 20 20 20 20 20 20 20 64 iOff,
1a240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1a250 2a 20 46 69 6c 65 20 6f 66 66 73 65 74 20 74 6f * File offset to
1a260 20 62 65 67 69 6e 20 77 72 69 74 69 6e 67 20 61 begin writing a
1a270 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 t */. const voi
1a280 64 20 2a 70 42 75 66 2c 20 20 20 20 20 20 20 20 d *pBuf,
1a290 20 20 20 20 20 20 20 2f 2a 20 43 6f 70 79 20 64 /* Copy d
1a2a0 61 74 61 20 66 72 6f 6d 20 74 68 69 73 20 62 75 ata from this bu
1a2b0 66 66 65 72 20 74 6f 20 74 68 65 20 66 69 6c 65 ffer to the file
1a2c0 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 66 2c 20 */. int nBuf,
1a2d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a2e0 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
1a2f0 20 62 75 66 66 65 72 20 70 42 75 66 20 69 6e 20 buffer pBuf in
1a300 62 79 74 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a bytes */. int *
1a310 70 69 45 72 72 6e 6f 20 20 20 20 20 20 20 20 20 piErrno
1a320 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
1a330 54 3a 20 45 72 72 6f 72 20 6e 75 6d 62 65 72 20 T: Error number
1a340 69 66 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 if error occurs
1a350 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d */.){. int rc =
1a360 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
1a370 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 /* Value
1a380 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 79 73 returned by sys
1a390 74 65 6d 20 63 61 6c 6c 20 2a 2f 0a 0a 20 20 61 tem call */.. a
1a3a0 73 73 65 72 74 28 20 6e 42 75 66 3d 3d 28 6e 42 ssert( nBuf==(nB
1a3b0 75 66 26 30 78 31 66 66 66 66 29 20 29 3b 0a 20 uf&0x1ffff) );.
1a3c0 20 61 73 73 65 72 74 28 20 66 64 3e 32 20 29 3b assert( fd>2 );
1a3d0 0a 20 20 61 73 73 65 72 74 28 20 70 69 45 72 72 . assert( piErr
1a3e0 6e 6f 21 3d 30 20 29 3b 0a 20 20 6e 42 75 66 20 no!=0 );. nBuf
1a3f0 26 3d 20 30 78 31 66 66 66 66 3b 0a 20 20 54 49 &= 0x1ffff;. TI
1a400 4d 45 52 5f 53 54 41 52 54 3b 0a 0a 23 69 66 20 MER_START;..#if
1a410 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 defined(USE_PREA
1a420 44 29 0a 20 20 64 6f 7b 20 72 63 20 3d 20 28 69 D). do{ rc = (i
1a430 6e 74 29 6f 73 50 77 72 69 74 65 28 66 64 2c 20 nt)osPwrite(fd,
1a440 70 42 75 66 2c 20 6e 42 75 66 2c 20 69 4f 66 66 pBuf, nBuf, iOff
1a450 29 3b 20 7d 77 68 69 6c 65 28 20 72 63 3c 30 20 ); }while( rc<0
1a460 26 26 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 && errno==EINTR
1a470 29 3b 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 );.#elif defined
1a480 28 55 53 45 5f 50 52 45 41 44 36 34 29 0a 20 20 (USE_PREAD64).
1a490 64 6f 7b 20 72 63 20 3d 20 28 69 6e 74 29 6f 73 do{ rc = (int)os
1a4a0 50 77 72 69 74 65 36 34 28 66 64 2c 20 70 42 75 Pwrite64(fd, pBu
1a4b0 66 2c 20 6e 42 75 66 2c 20 69 4f 66 66 29 3b 7d f, nBuf, iOff);}
1a4c0 77 68 69 6c 65 28 20 72 63 3c 30 20 26 26 20 65 while( rc<0 && e
1a4d0 72 72 6e 6f 3d 3d 45 49 4e 54 52 29 3b 0a 23 65 rrno==EINTR);.#e
1a4e0 6c 73 65 0a 20 20 64 6f 7b 0a 20 20 20 20 69 36 lse. do{. i6
1a4f0 34 20 69 53 65 65 6b 20 3d 20 6c 73 65 65 6b 28 4 iSeek = lseek(
1a500 66 64 2c 20 69 4f 66 66 2c 20 53 45 45 4b 5f 53 fd, iOff, SEEK_S
1a510 45 54 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 ET);. Simulat
1a520 65 49 4f 45 72 72 6f 72 28 20 69 53 65 65 6b 20 eIOError( iSeek
1a530 3d 20 2d 31 20 29 3b 0a 20 20 20 20 69 66 28 20 = -1 );. if(
1a540 69 53 65 65 6b 3c 30 20 29 7b 0a 20 20 20 20 20 iSeek<0 ){.
1a550 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 rc = -1;.
1a560 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 break;. }.
1a570 20 72 63 20 3d 20 6f 73 57 72 69 74 65 28 66 64 rc = osWrite(fd
1a580 2c 20 70 42 75 66 2c 20 6e 42 75 66 29 3b 0a 20 , pBuf, nBuf);.
1a590 20 7d 77 68 69 6c 65 28 20 72 63 3c 30 20 26 26 }while( rc<0 &&
1a5a0 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 29 3b errno==EINTR );
1a5b0 0a 23 65 6e 64 69 66 0a 0a 20 20 54 49 4d 45 52 .#endif.. TIMER
1a5c0 5f 45 4e 44 3b 0a 20 20 4f 53 54 52 41 43 45 28 _END;. OSTRACE(
1a5d0 28 22 57 52 49 54 45 20 20 20 25 2d 33 64 20 25 ("WRITE %-3d %
1a5e0 35 64 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e 22 5d %7lld %llu\n"
1a5f0 2c 20 66 64 2c 20 72 63 2c 20 69 4f 66 66 2c 20 , fd, rc, iOff,
1a600 54 49 4d 45 52 5f 45 4c 41 50 53 45 44 29 29 3b TIMER_ELAPSED));
1a610 0a 0a 20 20 69 66 28 20 72 63 3c 30 20 29 20 2a .. if( rc<0 ) *
1a620 70 69 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b piErrno = errno;
1a630 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
1a640 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 6f 20 ../*.** Seek to
1a650 74 68 65 20 6f 66 66 73 65 74 20 69 6e 20 69 64 the offset in id
1a660 2d 3e 6f 66 66 73 65 74 20 74 68 65 6e 20 72 65 ->offset then re
1a670 61 64 20 63 6e 74 20 62 79 74 65 73 20 69 6e 74 ad cnt bytes int
1a680 6f 20 70 42 75 66 2e 0a 2a 2a 20 52 65 74 75 72 o pBuf..** Retur
1a690 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
1a6a0 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79 20 72 bytes actually r
1a6b0 65 61 64 2e 20 20 55 70 64 61 74 65 20 74 68 65 ead. Update the
1a6c0 20 6f 66 66 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 54 offset..**.** T
1a6d0 6f 20 61 76 6f 69 64 20 73 74 6f 6d 70 69 6e 67 o avoid stomping
1a6e0 20 74 68 65 20 65 72 72 6e 6f 20 76 61 6c 75 65 the errno value
1a6f0 20 6f 6e 20 61 20 66 61 69 6c 65 64 20 77 72 69 on a failed wri
1a700 74 65 20 74 68 65 20 6c 61 73 74 45 72 72 6e 6f te the lastErrno
1a710 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 74 value.** is set
1a720 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
1a730 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 g..*/.static int
1a740 20 73 65 65 6b 41 6e 64 57 72 69 74 65 28 75 6e seekAndWrite(un
1a750 69 78 46 69 6c 65 20 2a 69 64 2c 20 69 36 34 20 ixFile *id, i64
1a760 6f 66 66 73 65 74 2c 20 63 6f 6e 73 74 20 76 6f offset, const vo
1a770 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20 63 6e id *pBuf, int cn
1a780 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 65 65 t){. return see
1a790 6b 41 6e 64 57 72 69 74 65 46 64 28 69 64 2d 3e kAndWriteFd(id->
1a7a0 68 2c 20 6f 66 66 73 65 74 2c 20 70 42 75 66 2c h, offset, pBuf,
1a7b0 20 63 6e 74 2c 20 26 69 64 2d 3e 6c 61 73 74 45 cnt, &id->lastE
1a7c0 72 72 6e 6f 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a rrno);.}.../*.**
1a7d0 20 57 72 69 74 65 20 64 61 74 61 20 66 72 6f 6d Write data from
1a7e0 20 61 20 62 75 66 66 65 72 20 69 6e 74 6f 20 61 a buffer into a
1a7f0 20 66 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 file. Return S
1a800 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
1a810 65 73 73 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20 6f ess.** or some o
1a820 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 20 ther error code
1a830 6f 6e 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 on failure..*/.s
1a840 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 57 72 tatic int unixWr
1a850 69 74 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 ite(. sqlite3_f
1a860 69 6c 65 20 2a 69 64 2c 20 0a 20 20 63 6f 6e 73 ile *id, . cons
1a870 74 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 0a 20 t void *pBuf, .
1a880 20 69 6e 74 20 61 6d 74 2c 0a 20 20 73 71 6c 69 int amt,. sqli
1a890 74 65 33 5f 69 6e 74 36 34 20 6f 66 66 73 65 74 te3_int64 offset
1a8a0 20 0a 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 .){. unixFile
1a8b0 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 *pFile = (unixFi
1a8c0 6c 65 2a 29 69 64 3b 0a 20 20 69 6e 74 20 77 72 le*)id;. int wr
1a8d0 6f 74 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 ote = 0;. asser
1a8e0 74 28 20 69 64 20 29 3b 0a 20 20 61 73 73 65 72 t( id );. asser
1a8f0 74 28 20 61 6d 74 3e 30 20 29 3b 0a 0a 20 20 2f t( amt>0 );.. /
1a900 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 20 64 * If this is a d
1a910 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 6e 6f atabase file (no
1a920 74 20 61 20 6a 6f 75 72 6e 61 6c 2c 20 6d 61 73 t a journal, mas
1a930 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6f 72 20 74 ter-journal or t
1a940 65 6d 70 0a 20 20 2a 2a 20 66 69 6c 65 29 2c 20 emp. ** file),
1a950 74 68 65 20 62 79 74 65 73 20 69 6e 20 74 68 65 the bytes in the
1a960 20 6c 6f 63 6b 69 6e 67 20 72 61 6e 67 65 20 73 locking range s
1a970 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 72 hould never be r
1a980 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 ead or written.
1a990 2a 2f 0a 23 69 66 20 30 0a 20 20 61 73 73 65 72 */.#if 0. asser
1a9a0 74 28 20 70 46 69 6c 65 2d 3e 70 55 6e 75 73 65 t( pFile->pUnuse
1a9b0 64 3d 3d 30 0a 20 20 20 20 20 20 20 7c 7c 20 6f d==0. || o
1a9c0 66 66 73 65 74 3e 3d 50 45 4e 44 49 4e 47 5f 42 ffset>=PENDING_B
1a9d0 59 54 45 2b 35 31 32 0a 20 20 20 20 20 20 20 7c YTE+512. |
1a9e0 7c 20 6f 66 66 73 65 74 2b 61 6d 74 3c 3d 50 45 | offset+amt<=PE
1a9f0 4e 44 49 4e 47 5f 42 59 54 45 20 0a 20 20 29 3b NDING_BYTE . );
1aa00 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
1aa10 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f SQLITE_DEBUG. /
1aa20 2a 20 49 66 20 77 65 20 61 72 65 20 64 6f 69 6e * If we are doin
1aa30 67 20 61 20 6e 6f 72 6d 61 6c 20 77 72 69 74 65 g a normal write
1aa40 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 66 to a database f
1aa50 69 6c 65 20 28 61 73 20 6f 70 70 6f 73 65 64 20 ile (as opposed
1aa60 74 6f 0a 20 20 2a 2a 20 64 6f 69 6e 67 20 61 20 to. ** doing a
1aa70 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c hot-journal roll
1aa80 62 61 63 6b 20 6f 72 20 61 20 77 72 69 74 65 20 back or a write
1aa90 74 6f 20 73 6f 6d 65 20 66 69 6c 65 20 6f 74 68 to some file oth
1aaa0 65 72 20 74 68 61 6e 20 61 0a 20 20 2a 2a 20 6e er than a. ** n
1aab0 6f 72 6d 61 6c 20 64 61 74 61 62 61 73 65 20 66 ormal database f
1aac0 69 6c 65 29 20 74 68 65 6e 20 72 65 63 6f 72 64 ile) then record
1aad0 20 74 68 65 20 66 61 63 74 20 74 68 61 74 20 74 the fact that t
1aae0 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a he database. **
1aaf0 20 68 61 73 20 63 68 61 6e 67 65 64 2e 20 20 49 has changed. I
1ab00 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f f the transactio
1ab10 6e 20 63 6f 75 6e 74 65 72 20 69 73 20 6d 6f 64 n counter is mod
1ab20 69 66 69 65 64 2c 20 72 65 63 6f 72 64 20 74 68 ified, record th
1ab30 61 74 0a 20 20 2a 2a 20 66 61 63 74 20 74 6f 6f at. ** fact too
1ab40 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 .. */. if( pFi
1ab50 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 le->inNormalWrit
1ab60 65 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e e ){. pFile->
1ab70 64 62 55 70 64 61 74 65 20 3d 20 31 3b 20 20 2f dbUpdate = 1; /
1ab80 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 68 * The database h
1ab90 61 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 as been modified
1aba0 20 2a 2f 0a 20 20 20 20 69 66 28 20 6f 66 66 73 */. if( offs
1abb0 65 74 3c 3d 32 34 20 26 26 20 6f 66 66 73 65 74 et<=24 && offset
1abc0 2b 61 6d 74 3e 3d 32 37 20 29 7b 0a 20 20 20 20 +amt>=27 ){.
1abd0 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 20 20 int rc;.
1abe0 63 68 61 72 20 6f 6c 64 43 6e 74 72 5b 34 5d 3b char oldCntr[4];
1abf0 0a 20 20 20 20 20 20 53 69 6d 75 6c 61 74 65 49 . SimulateI
1ac00 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 31 29 3b OErrorBenign(1);
1ac10 0a 20 20 20 20 20 20 72 63 20 3d 20 73 65 65 6b . rc = seek
1ac20 41 6e 64 52 65 61 64 28 70 46 69 6c 65 2c 20 32 AndRead(pFile, 2
1ac30 34 2c 20 6f 6c 64 43 6e 74 72 2c 20 34 29 3b 0a 4, oldCntr, 4);.
1ac40 20 20 20 20 20 20 53 69 6d 75 6c 61 74 65 49 4f SimulateIO
1ac50 45 72 72 6f 72 42 65 6e 69 67 6e 28 30 29 3b 0a ErrorBenign(0);.
1ac60 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 34 20 if( rc!=4
1ac70 7c 7c 20 6d 65 6d 63 6d 70 28 6f 6c 64 43 6e 74 || memcmp(oldCnt
1ac80 72 2c 20 26 28 28 63 68 61 72 2a 29 70 42 75 66 r, &((char*)pBuf
1ac90 29 5b 32 34 2d 6f 66 66 73 65 74 5d 2c 20 34 29 )[24-offset], 4)
1aca0 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 !=0 ){. p
1acb0 46 69 6c 65 2d 3e 74 72 61 6e 73 43 6e 74 72 43 File->transCntrC
1acc0 68 6e 67 20 3d 20 31 3b 20 20 2f 2a 20 54 68 65 hng = 1; /* The
1acd0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 transaction cou
1ace0 6e 74 65 72 20 68 61 73 20 63 68 61 6e 67 65 64 nter has changed
1acf0 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 */. }.
1ad00 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 }. }.#endif..#i
1ad10 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
1ad20 5f 4d 4d 41 50 5f 52 45 41 44 57 52 49 54 45 29 _MMAP_READWRITE)
1ad30 20 26 26 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d && SQLITE_MAX_M
1ad40 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 2f 2a 20 MAP_SIZE>0. /*
1ad50 44 65 61 6c 20 77 69 74 68 20 61 73 20 6d 75 63 Deal with as muc
1ad60 68 20 6f 66 20 74 68 69 73 20 77 72 69 74 65 20 h of this write
1ad70 72 65 71 75 65 73 74 20 61 73 20 70 6f 73 73 69 request as possi
1ad80 62 6c 65 20 62 79 20 74 72 61 6e 73 66 65 72 69 ble by transferi
1ad90 6e 67 0a 20 20 2a 2a 20 64 61 74 61 20 66 72 6f ng. ** data fro
1ada0 6d 20 74 68 65 20 6d 65 6d 6f 72 79 20 6d 61 70 m the memory map
1adb0 70 69 6e 67 20 75 73 69 6e 67 20 6d 65 6d 63 70 ping using memcp
1adc0 79 28 29 2e 20 20 2a 2f 0a 20 20 69 66 28 20 6f y(). */. if( o
1add0 66 66 73 65 74 3c 70 46 69 6c 65 2d 3e 6d 6d 61 ffset<pFile->mma
1ade0 70 53 69 7a 65 20 29 7b 0a 20 20 20 20 69 66 28 pSize ){. if(
1adf0 20 6f 66 66 73 65 74 2b 61 6d 74 20 3c 3d 20 70 offset+amt <= p
1ae00 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20 29 File->mmapSize )
1ae10 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 {. memcpy(&
1ae20 28 28 75 38 20 2a 29 28 70 46 69 6c 65 2d 3e 70 ((u8 *)(pFile->p
1ae30 4d 61 70 52 65 67 69 6f 6e 29 29 5b 6f 66 66 73 MapRegion))[offs
1ae40 65 74 5d 2c 20 70 42 75 66 2c 20 61 6d 74 29 3b et], pBuf, amt);
1ae50 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
1ae60 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c LITE_OK;. }el
1ae70 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 43 se{. int nC
1ae80 6f 70 79 20 3d 20 70 46 69 6c 65 2d 3e 6d 6d 61 opy = pFile->mma
1ae90 70 53 69 7a 65 20 2d 20 6f 66 66 73 65 74 3b 0a pSize - offset;.
1aea0 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 28 28 memcpy(&((
1aeb0 75 38 20 2a 29 28 70 46 69 6c 65 2d 3e 70 4d 61 u8 *)(pFile->pMa
1aec0 70 52 65 67 69 6f 6e 29 29 5b 6f 66 66 73 65 74 pRegion))[offset
1aed0 5d 2c 20 70 42 75 66 2c 20 6e 43 6f 70 79 29 3b ], pBuf, nCopy);
1aee0 0a 20 20 20 20 20 20 70 42 75 66 20 3d 20 26 28 . pBuf = &(
1aef0 28 75 38 20 2a 29 70 42 75 66 29 5b 6e 43 6f 70 (u8 *)pBuf)[nCop
1af00 79 5d 3b 0a 20 20 20 20 20 20 61 6d 74 20 2d 3d y];. amt -=
1af10 20 6e 43 6f 70 79 3b 0a 20 20 20 20 20 20 6f 66 nCopy;. of
1af20 66 73 65 74 20 2b 3d 20 6e 43 6f 70 79 3b 0a 20 fset += nCopy;.
1af30 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a }. }.#endif.
1af40 20 0a 20 20 77 68 69 6c 65 28 20 28 77 72 6f 74 . while( (wrot
1af50 65 20 3d 20 73 65 65 6b 41 6e 64 57 72 69 74 65 e = seekAndWrite
1af60 28 70 46 69 6c 65 2c 20 6f 66 66 73 65 74 2c 20 (pFile, offset,
1af70 70 42 75 66 2c 20 61 6d 74 29 29 3c 61 6d 74 20 pBuf, amt))<amt
1af80 26 26 20 77 72 6f 74 65 3e 30 20 29 7b 0a 20 20 && wrote>0 ){.
1af90 20 20 61 6d 74 20 2d 3d 20 77 72 6f 74 65 3b 0a amt -= wrote;.
1afa0 20 20 20 20 6f 66 66 73 65 74 20 2b 3d 20 77 72 offset += wr
1afb0 6f 74 65 3b 0a 20 20 20 20 70 42 75 66 20 3d 20 ote;. pBuf =
1afc0 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 77 &((char*)pBuf)[w
1afd0 72 6f 74 65 5d 3b 0a 20 20 7d 0a 20 20 53 69 6d rote];. }. Sim
1afe0 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 28 20 77 ulateIOError(( w
1aff0 72 6f 74 65 3d 28 2d 31 29 2c 20 61 6d 74 3d 31 rote=(-1), amt=1
1b000 20 29 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 44 ));. SimulateD
1b010 69 73 6b 66 75 6c 6c 45 72 72 6f 72 28 28 20 77 iskfullError(( w
1b020 72 6f 74 65 3d 30 2c 20 61 6d 74 3d 31 20 29 29 rote=0, amt=1 ))
1b030 3b 0a 0a 20 20 69 66 28 20 61 6d 74 3e 77 72 6f ;.. if( amt>wro
1b040 74 65 20 29 7b 0a 20 20 20 20 69 66 28 20 77 72 te ){. if( wr
1b050 6f 74 65 3c 30 20 26 26 20 70 46 69 6c 65 2d 3e ote<0 && pFile->
1b060 6c 61 73 74 45 72 72 6e 6f 21 3d 45 4e 4f 53 50 lastErrno!=ENOSP
1b070 43 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 6c 61 C ){. /* la
1b080 73 74 45 72 72 6e 6f 20 73 65 74 20 62 79 20 73 stErrno set by s
1b090 65 65 6b 41 6e 64 57 72 69 74 65 20 2a 2f 0a 20 eekAndWrite */.
1b0a0 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
1b0b0 54 45 5f 49 4f 45 52 52 5f 57 52 49 54 45 3b 0a TE_IOERR_WRITE;.
1b0c0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
1b0d0 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 storeLastErrno(
1b0e0 70 46 69 6c 65 2c 20 30 29 3b 20 2f 2a 20 6e 6f pFile, 0); /* no
1b0f0 74 20 61 20 73 79 73 74 65 6d 20 65 72 72 6f 72 t a system error
1b100 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e */. return
1b110 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 SQLITE_FULL;.
1b120 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 }. }.. retur
1b130 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1b140 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 #ifdef SQLITE_TE
1b150 53 54 0a 2f 2a 0a 2a 2a 20 43 6f 75 6e 74 20 74 ST./*.** Count t
1b160 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 75 6c he number of ful
1b170 6c 73 79 6e 63 73 20 61 6e 64 20 6e 6f 72 6d 61 lsyncs and norma
1b180 6c 20 73 79 6e 63 73 2e 20 20 54 68 69 73 20 69 l syncs. This i
1b190 73 20 75 73 65 64 20 74 6f 20 74 65 73 74 0a 2a s used to test.*
1b1a0 2a 20 74 68 61 74 20 73 79 6e 63 73 20 61 6e 64 * that syncs and
1b1b0 20 66 75 6c 6c 73 79 6e 63 73 20 61 72 65 20 6f fullsyncs are o
1b1c0 63 63 75 72 72 69 6e 67 20 61 74 20 74 68 65 20 ccurring at the
1b1d0 72 69 67 68 74 20 74 69 6d 65 73 2e 0a 2a 2f 0a right times..*/.
1b1e0 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 79 6e 63 int sqlite3_sync
1b1f0 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 69 6e 74 20 _count = 0;.int
1b200 73 71 6c 69 74 65 33 5f 66 75 6c 6c 73 79 6e 63 sqlite3_fullsync
1b210 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 23 65 6e 64 _count = 0;.#end
1b220 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 65 20 64 6f 20 if../*.** We do
1b230 6e 6f 74 20 74 72 75 73 74 20 73 79 73 74 65 6d not trust system
1b240 73 20 74 6f 20 70 72 6f 76 69 64 65 20 61 20 77 s to provide a w
1b250 6f 72 6b 69 6e 67 20 66 64 61 74 61 73 79 6e 63 orking fdatasync
1b260 28 29 2e 20 20 53 6f 6d 65 20 64 6f 2e 0a 2a 2a (). Some do..**
1b270 20 4f 74 68 65 72 73 20 64 6f 20 6e 6f 2e 20 20 Others do no.
1b280 54 6f 20 62 65 20 73 61 66 65 2c 20 77 65 20 77 To be safe, we w
1b290 69 6c 6c 20 73 74 69 63 6b 20 77 69 74 68 20 74 ill stick with t
1b2a0 68 65 20 28 73 6c 69 67 68 74 6c 79 20 73 6c 6f he (slightly slo
1b2b0 77 65 72 29 0a 2a 2a 20 66 73 79 6e 63 28 29 2e wer).** fsync().
1b2c0 20 49 66 20 79 6f 75 20 6b 6e 6f 77 20 74 68 61 If you know tha
1b2d0 74 20 79 6f 75 72 20 73 79 73 74 65 6d 20 64 6f t your system do
1b2e0 65 73 20 73 75 70 70 6f 72 74 20 66 64 61 74 61 es support fdata
1b2f0 73 79 6e 63 28 29 20 63 6f 72 72 65 63 74 6c 79 sync() correctly
1b300 2c 0a 2a 2a 20 74 68 65 6e 20 73 69 6d 70 6c 79 ,.** then simply
1b310 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 2d 44 compile with -D
1b320 66 64 61 74 61 73 79 6e 63 3d 66 64 61 74 61 73 fdatasync=fdatas
1b330 79 6e 63 20 6f 72 20 2d 44 48 41 56 45 5f 46 44 ync or -DHAVE_FD
1b340 41 54 41 53 59 4e 43 0a 2a 2f 0a 23 69 66 20 21 ATASYNC.*/.#if !
1b350 64 65 66 69 6e 65 64 28 66 64 61 74 61 73 79 6e defined(fdatasyn
1b360 63 29 20 26 26 20 21 48 41 56 45 5f 46 44 41 54 c) && !HAVE_FDAT
1b370 41 53 59 4e 43 0a 23 20 64 65 66 69 6e 65 20 66 ASYNC.# define f
1b380 64 61 74 61 73 79 6e 63 20 66 73 79 6e 63 0a 23 datasync fsync.#
1b390 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 endif../*.** Def
1b3a0 69 6e 65 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 ine HAVE_FULLFSY
1b3b0 4e 43 20 74 6f 20 30 20 6f 72 20 31 20 64 65 70 NC to 0 or 1 dep
1b3c0 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 ending on whethe
1b3d0 72 20 6f 72 20 6e 6f 74 0a 2a 2a 20 74 68 65 20 r or not.** the
1b3e0 46 5f 46 55 4c 4c 46 53 59 4e 43 20 6d 61 63 72 F_FULLFSYNC macr
1b3f0 6f 20 69 73 20 64 65 66 69 6e 65 64 2e 20 20 46 o is defined. F
1b400 5f 46 55 4c 4c 46 53 59 4e 43 20 69 73 20 63 75 _FULLFSYNC is cu
1b410 72 72 65 6e 74 6c 79 0a 2a 2a 20 6f 6e 6c 79 20 rrently.** only
1b420 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 4d 61 63 available on Mac
1b430 20 4f 53 20 58 2e 20 20 42 75 74 20 74 68 61 74 OS X. But that
1b440 20 63 6f 75 6c 64 20 63 68 61 6e 67 65 2e 0a 2a could change..*
1b450 2f 0a 23 69 66 64 65 66 20 46 5f 46 55 4c 4c 46 /.#ifdef F_FULLF
1b460 53 59 4e 43 0a 23 20 64 65 66 69 6e 65 20 48 41 SYNC.# define HA
1b470 56 45 5f 46 55 4c 4c 46 53 59 4e 43 20 31 0a 23 VE_FULLFSYNC 1.#
1b480 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 48 41 else.# define HA
1b490 56 45 5f 46 55 4c 4c 46 53 59 4e 43 20 30 0a 23 VE_FULLFSYNC 0.#
1b4a0 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 endif.../*.** Th
1b4b0 65 20 66 73 79 6e 63 28 29 20 73 79 73 74 65 6d e fsync() system
1b4c0 20 63 61 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 77 call does not w
1b4d0 6f 72 6b 20 61 73 20 61 64 76 65 72 74 69 73 65 ork as advertise
1b4e0 64 20 6f 6e 20 6d 61 6e 79 0a 2a 2a 20 75 6e 69 d on many.** uni
1b4f0 78 20 73 79 73 74 65 6d 73 2e 20 20 54 68 65 20 x systems. The
1b500 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 63 65 64 following proced
1b510 75 72 65 20 69 73 20 61 6e 20 61 74 74 65 6d 70 ure is an attemp
1b520 74 20 74 6f 20 6d 61 6b 65 0a 2a 2a 20 69 74 20 t to make.** it
1b530 77 6f 72 6b 20 62 65 74 74 65 72 2e 0a 2a 2a 0a work better..**.
1b540 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4e 4f ** The SQLITE_NO
1b550 5f 53 59 4e 43 20 6d 61 63 72 6f 20 64 69 73 61 _SYNC macro disa
1b560 62 6c 65 73 20 61 6c 6c 20 66 73 79 6e 63 28 29 bles all fsync()
1b570 73 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 66 s. This is usef
1b580 75 6c 0a 2a 2a 20 66 6f 72 20 74 65 73 74 69 6e ul.** for testin
1b590 67 20 77 68 65 6e 20 77 65 20 77 61 6e 74 20 74 g when we want t
1b5a0 6f 20 72 75 6e 20 74 68 72 6f 75 67 68 20 74 68 o run through th
1b5b0 65 20 74 65 73 74 20 73 75 69 74 65 20 71 75 69 e test suite qui
1b5c0 63 6b 6c 79 2e 0a 2a 2a 20 59 6f 75 20 61 72 65 ckly..** You are
1b5d0 20 73 74 72 6f 6e 67 6c 79 20 61 64 76 69 73 65 strongly advise
1b5e0 64 20 2a 6e 6f 74 2a 20 74 6f 20 64 65 70 6c 6f d *not* to deplo
1b5f0 79 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e 4f y with SQLITE_NO
1b600 5f 53 59 4e 43 0a 2a 2a 20 65 6e 61 62 6c 65 64 _SYNC.** enabled
1b610 2c 20 68 6f 77 65 76 65 72 2c 20 73 69 6e 63 65 , however, since
1b620 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e 4f 5f with SQLITE_NO_
1b630 53 59 4e 43 20 65 6e 61 62 6c 65 64 2c 20 61 6e SYNC enabled, an
1b640 20 4f 53 20 63 72 61 73 68 0a 2a 2a 20 6f 72 20 OS crash.** or
1b650 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 77 69 power failure wi
1b660 6c 6c 20 6c 69 6b 65 6c 79 20 63 6f 72 72 75 70 ll likely corrup
1b670 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 t the database f
1b680 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 ile..**.** SQLit
1b690 65 20 73 65 74 73 20 74 68 65 20 64 61 74 61 4f e sets the dataO
1b6a0 6e 6c 79 20 66 6c 61 67 20 69 66 20 74 68 65 20 nly flag if the
1b6b0 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 size of the file
1b6c0 20 69 73 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a is unchanged..*
1b6d0 2a 20 54 68 65 20 69 64 65 61 20 62 65 68 69 6e * The idea behin
1b6e0 64 20 64 61 74 61 4f 6e 6c 79 20 69 73 20 74 68 d dataOnly is th
1b6f0 61 74 20 69 74 20 73 68 6f 75 6c 64 20 6f 6e 6c at it should onl
1b700 79 20 77 72 69 74 65 20 74 68 65 20 66 69 6c 65 y write the file
1b710 20 63 6f 6e 74 65 6e 74 0a 2a 2a 20 74 6f 20 64 content.** to d
1b720 69 73 6b 2c 20 6e 6f 74 20 74 68 65 20 69 6e 6f isk, not the ino
1b730 64 65 2e 20 20 57 65 20 6f 6e 6c 79 20 73 65 74 de. We only set
1b740 20 64 61 74 61 4f 6e 6c 79 20 69 66 20 74 68 65 dataOnly if the
1b750 20 66 69 6c 65 20 73 69 7a 65 20 69 73 20 0a 2a file size is .*
1b760 2a 20 75 6e 63 68 61 6e 67 65 64 20 73 69 6e 63 * unchanged sinc
1b770 65 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 20 e the file size
1b780 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 69 is part of the i
1b790 6e 6f 64 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 node. However,
1b7a0 0a 2a 2a 20 54 65 64 20 54 73 27 6f 20 74 65 6c .** Ted Ts'o tel
1b7b0 6c 73 20 75 73 20 74 68 61 74 20 66 64 61 74 61 ls us that fdata
1b7c0 73 79 6e 63 28 29 20 77 69 6c 6c 20 61 6c 73 6f sync() will also
1b7d0 20 77 72 69 74 65 20 74 68 65 20 69 6e 6f 64 65 write the inode
1b7e0 20 69 66 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 if the.** file
1b7f0 73 69 7a 65 20 68 61 73 20 63 68 61 6e 67 65 64 size has changed
1b800 2e 20 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 6c . The only real
1b810 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 difference betw
1b820 65 65 6e 20 66 64 61 74 61 73 79 6e 63 28 29 0a een fdatasync().
1b830 2a 2a 20 61 6e 64 20 66 73 79 6e 63 28 29 2c 20 ** and fsync(),
1b840 54 65 64 20 74 65 6c 6c 73 20 75 73 2c 20 69 73 Ted tells us, is
1b850 20 74 68 61 74 20 66 64 61 74 61 73 79 6e 63 28 that fdatasync(
1b860 29 20 77 69 6c 6c 20 6e 6f 74 20 66 6c 75 73 68 ) will not flush
1b870 20 74 68 65 0a 2a 2a 20 69 6e 6f 64 65 20 69 66 the.** inode if
1b880 20 74 68 65 20 6d 74 69 6d 65 20 6f 72 20 6f 77 the mtime or ow
1b890 6e 65 72 20 6f 72 20 6f 74 68 65 72 20 69 6e 6f ner or other ino
1b8a0 64 65 20 61 74 74 72 69 62 75 74 65 73 20 68 61 de attributes ha
1b8b0 76 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2a 20 57 ve changed..** W
1b8c0 65 20 6f 6e 6c 79 20 63 61 72 65 20 61 62 6f 75 e only care abou
1b8d0 74 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 2c t the file size,
1b8e0 20 6e 6f 74 20 74 68 65 20 6f 74 68 65 72 20 66 not the other f
1b8f0 69 6c 65 20 61 74 74 72 69 62 75 74 65 73 2c 20 ile attributes,
1b900 73 6f 0a 2a 2a 20 61 73 20 66 61 72 20 61 73 20 so.** as far as
1b910 53 51 4c 69 74 65 20 69 73 20 63 6f 6e 63 65 72 SQLite is concer
1b920 6e 65 64 2c 20 61 6e 20 66 64 61 74 61 73 79 6e ned, an fdatasyn
1b930 63 28 29 20 69 73 20 61 6c 77 61 79 73 20 61 64 c() is always ad
1b940 65 71 75 61 74 65 2e 0a 2a 2a 20 53 6f 2c 20 77 equate..** So, w
1b950 65 20 61 6c 77 61 79 73 20 75 73 65 20 66 64 61 e always use fda
1b960 74 61 73 79 6e 63 28 29 20 69 66 20 69 74 20 69 tasync() if it i
1b970 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 72 65 67 s available, reg
1b980 61 72 64 6c 65 73 73 20 6f 66 0a 2a 2a 20 74 68 ardless of.** th
1b990 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 64 e value of the d
1b9a0 61 74 61 4f 6e 6c 79 20 66 6c 61 67 2e 0a 2a 2f ataOnly flag..*/
1b9b0 0a 73 74 61 74 69 63 20 69 6e 74 20 66 75 6c 6c .static int full
1b9c0 5f 66 73 79 6e 63 28 69 6e 74 20 66 64 2c 20 69 _fsync(int fd, i
1b9d0 6e 74 20 66 75 6c 6c 53 79 6e 63 2c 20 69 6e 74 nt fullSync, int
1b9e0 20 64 61 74 61 4f 6e 6c 79 29 7b 0a 20 20 69 6e dataOnly){. in
1b9f0 74 20 72 63 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 t rc;.. /* The
1ba00 66 6f 6c 6c 6f 77 69 6e 67 20 22 69 66 64 65 66 following "ifdef
1ba10 2f 65 6c 69 66 2f 65 6c 73 65 2f 22 20 62 6c 6f /elif/else/" blo
1ba20 63 6b 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 ck has the same
1ba30 73 74 72 75 63 74 75 72 65 20 61 73 0a 20 20 2a structure as. *
1ba40 2a 20 74 68 65 20 6f 6e 65 20 62 65 6c 6f 77 2e * the one below.
1ba50 20 49 74 20 69 73 20 72 65 70 6c 69 63 61 74 65 It is replicate
1ba60 64 20 68 65 72 65 20 73 6f 6c 65 6c 79 20 74 6f d here solely to
1ba70 20 61 76 6f 69 64 20 63 6c 75 74 74 65 72 69 6e avoid clutterin
1ba80 67 20 0a 20 20 2a 2a 20 75 70 20 74 68 65 20 72 g . ** up the r
1ba90 65 61 6c 20 63 6f 64 65 20 77 69 74 68 20 74 68 eal code with th
1baa0 65 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 e UNUSED_PARAMET
1bab0 45 52 28 29 20 6d 61 63 72 6f 73 2e 0a 20 20 2a ER() macros.. *
1bac0 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
1bad0 4e 4f 5f 53 59 4e 43 0a 20 20 55 4e 55 53 45 44 NO_SYNC. UNUSED
1bae0 5f 50 41 52 41 4d 45 54 45 52 28 66 64 29 3b 0a _PARAMETER(fd);.
1baf0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
1bb00 45 52 28 66 75 6c 6c 53 79 6e 63 29 3b 0a 20 20 ER(fullSync);.
1bb10 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
1bb20 28 64 61 74 61 4f 6e 6c 79 29 3b 0a 23 65 6c 69 (dataOnly);.#eli
1bb30 66 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e 43 f HAVE_FULLFSYNC
1bb40 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
1bb50 54 45 52 28 64 61 74 61 4f 6e 6c 79 29 3b 0a 23 TER(dataOnly);.#
1bb60 65 6c 73 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 else. UNUSED_PA
1bb70 52 41 4d 45 54 45 52 28 66 75 6c 6c 53 79 6e 63 RAMETER(fullSync
1bb80 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 );. UNUSED_PARA
1bb90 4d 45 54 45 52 28 64 61 74 61 4f 6e 6c 79 29 3b METER(dataOnly);
1bba0 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 52 65 .#endif.. /* Re
1bbb0 63 6f 72 64 20 74 68 65 20 6e 75 6d 62 65 72 20 cord the number
1bbc0 6f 66 20 74 69 6d 65 73 20 74 68 61 74 20 77 65 of times that we
1bbd0 20 64 6f 20 61 20 6e 6f 72 6d 61 6c 20 66 73 79 do a normal fsy
1bbe0 6e 63 28 29 20 61 6e 64 20 0a 20 20 2a 2a 20 46 nc() and . ** F
1bbf0 55 4c 4c 53 59 4e 43 2e 20 20 54 68 69 73 20 69 ULLSYNC. This i
1bc00 73 20 75 73 65 64 20 64 75 72 69 6e 67 20 74 65 s used during te
1bc10 73 74 69 6e 67 20 74 6f 20 76 65 72 69 66 79 20 sting to verify
1bc20 74 68 61 74 20 74 68 69 73 20 70 72 6f 63 65 64 that this proced
1bc30 75 72 65 0a 20 20 2a 2a 20 67 65 74 73 20 63 61 ure. ** gets ca
1bc40 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 63 6f lled with the co
1bc50 72 72 65 63 74 20 61 72 67 75 6d 65 6e 74 73 2e rrect arguments.
1bc60 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c . */.#ifdef SQL
1bc70 49 54 45 5f 54 45 53 54 0a 20 20 69 66 28 20 66 ITE_TEST. if( f
1bc80 75 6c 6c 53 79 6e 63 20 29 20 73 71 6c 69 74 65 ullSync ) sqlite
1bc90 33 5f 66 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e 74 3_fullsync_count
1bca0 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 79 ++;. sqlite3_sy
1bcb0 6e 63 5f 63 6f 75 6e 74 2b 2b 3b 0a 23 65 6e 64 nc_count++;.#end
1bcc0 69 66 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 63 if.. /* If we c
1bcd0 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 ompiled with the
1bce0 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 20 SQLITE_NO_SYNC
1bcf0 66 6c 61 67 2c 20 74 68 65 6e 20 73 79 6e 63 69 flag, then synci
1bd00 6e 67 20 69 73 20 61 0a 20 20 2a 2a 20 6e 6f 2d ng is a. ** no-
1bd10 6f 70 2e 20 20 42 75 74 20 67 6f 20 61 68 65 61 op. But go ahea
1bd20 64 20 61 6e 64 20 63 61 6c 6c 20 66 73 74 61 74 d and call fstat
1bd30 28 29 20 74 6f 20 76 61 6c 69 64 61 74 65 20 74 () to validate t
1bd40 68 65 20 66 69 6c 65 0a 20 20 2a 2a 20 64 65 73 he file. ** des
1bd50 63 72 69 70 74 6f 72 20 61 73 20 77 65 20 6e 65 criptor as we ne
1bd60 65 64 20 61 20 6d 65 74 68 6f 64 20 74 6f 20 70 ed a method to p
1bd70 72 6f 76 6f 6b 65 20 61 20 66 61 69 6c 75 72 65 rovoke a failure
1bd80 20 64 75 72 69 6e 67 0a 20 20 2a 2a 20 63 6f 76 during. ** cov
1bd90 65 72 61 74 65 20 74 65 73 74 69 6e 67 2e 0a 20 erate testing..
1bda0 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
1bdb0 45 5f 4e 4f 5f 53 59 4e 43 0a 20 20 7b 0a 20 20 E_NO_SYNC. {.
1bdc0 20 20 73 74 72 75 63 74 20 73 74 61 74 20 62 75 struct stat bu
1bdd0 66 3b 0a 20 20 20 20 72 63 20 3d 20 6f 73 46 73 f;. rc = osFs
1bde0 74 61 74 28 66 64 2c 20 26 62 75 66 29 3b 0a 20 tat(fd, &buf);.
1bdf0 20 7d 0a 23 65 6c 69 66 20 48 41 56 45 5f 46 55 }.#elif HAVE_FU
1be00 4c 4c 46 53 59 4e 43 0a 20 20 69 66 28 20 66 75 LLFSYNC. if( fu
1be10 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 20 20 72 63 llSync ){. rc
1be20 20 3d 20 6f 73 46 63 6e 74 6c 28 66 64 2c 20 46 = osFcntl(fd, F
1be30 5f 46 55 4c 4c 46 53 59 4e 43 2c 20 30 29 3b 0a _FULLFSYNC, 0);.
1be40 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 }else{. rc
1be50 3d 20 31 3b 0a 20 20 7d 0a 20 20 2f 2a 20 49 66 = 1;. }. /* If
1be60 20 74 68 65 20 46 55 4c 4c 46 53 59 4e 43 20 66 the FULLFSYNC f
1be70 61 69 6c 65 64 2c 20 66 61 6c 6c 20 62 61 63 6b ailed, fall back
1be80 20 74 6f 20 61 74 74 65 6d 70 74 69 6e 67 20 61 to attempting a
1be90 6e 20 66 73 79 6e 63 28 29 2e 0a 20 20 2a 2a 20 n fsync().. **
1bea0 49 74 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 It shouldn't be
1beb0 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 66 75 6c possible for ful
1bec0 6c 66 73 79 6e 63 20 74 6f 20 66 61 69 6c 20 6f lfsync to fail o
1bed0 6e 20 74 68 65 20 6c 6f 63 61 6c 20 0a 20 20 2a n the local . *
1bee0 2a 20 66 69 6c 65 20 73 79 73 74 65 6d 20 28 6f * file system (o
1bef0 6e 20 4f 53 58 29 2c 20 73 6f 20 66 61 69 6c 75 n OSX), so failu
1bf00 72 65 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 re indicates tha
1bf10 74 20 46 55 4c 4c 46 53 59 4e 43 0a 20 20 2a 2a t FULLFSYNC. **
1bf20 20 69 73 6e 27 74 20 73 75 70 70 6f 72 74 65 64 isn't supported
1bf30 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 20 73 for this file s
1bf40 79 73 74 65 6d 2e 20 53 6f 2c 20 61 74 74 65 6d ystem. So, attem
1bf50 70 74 20 61 6e 20 66 73 79 6e 63 20 0a 20 20 2a pt an fsync . *
1bf60 2a 20 61 6e 64 20 28 66 6f 72 20 6e 6f 77 29 20 * and (for now)
1bf70 69 67 6e 6f 72 65 20 74 68 65 20 6f 76 65 72 68 ignore the overh
1bf80 65 61 64 20 6f 66 20 61 20 73 75 70 65 72 66 6c ead of a superfl
1bf90 75 6f 75 73 20 66 63 6e 74 6c 20 63 61 6c 6c 2e uous fcntl call.
1bfa0 20 20 0a 20 20 2a 2a 20 49 74 27 64 20 62 65 20 . ** It'd be
1bfb0 62 65 74 74 65 72 20 74 6f 20 64 65 74 65 63 74 better to detect
1bfc0 20 66 75 6c 6c 66 73 79 6e 63 20 73 75 70 70 6f fullfsync suppo
1bfd0 72 74 20 6f 6e 63 65 20 61 6e 64 20 61 76 6f 69 rt once and avoi
1bfe0 64 20 0a 20 20 2a 2a 20 74 68 65 20 66 63 6e 74 d . ** the fcnt
1bff0 6c 20 63 61 6c 6c 20 65 76 65 72 79 20 74 69 6d l call every tim
1c000 65 20 73 79 6e 63 20 69 73 20 63 61 6c 6c 65 64 e sync is called
1c010 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 20 .. */. if( rc
1c020 29 20 72 63 20 3d 20 66 73 79 6e 63 28 66 64 29 ) rc = fsync(fd)
1c030 3b 0a 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 ;..#elif defined
1c040 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 20 20 2f 2a (__APPLE__). /*
1c050 20 66 64 61 74 61 73 79 6e 63 28 29 20 6f 6e 20 fdatasync() on
1c060 48 46 53 2b 20 64 6f 65 73 6e 27 74 20 79 65 74 HFS+ doesn't yet
1c070 20 66 6c 75 73 68 20 74 68 65 20 66 69 6c 65 20 flush the file
1c080 73 69 7a 65 20 69 66 20 69 74 20 63 68 61 6e 67 size if it chang
1c090 65 64 20 63 6f 72 72 65 63 74 6c 79 0a 20 20 2a ed correctly. *
1c0a0 2a 20 73 6f 20 63 75 72 72 65 6e 74 6c 79 20 77 * so currently w
1c0b0 65 20 64 65 66 61 75 6c 74 20 74 6f 20 74 68 65 e default to the
1c0c0 20 6d 61 63 72 6f 20 74 68 61 74 20 72 65 64 65 macro that rede
1c0d0 66 69 6e 65 73 20 66 64 61 74 61 73 79 6e 63 20 fines fdatasync
1c0e0 74 6f 20 66 73 79 6e 63 0a 20 20 2a 2f 0a 20 20 to fsync. */.
1c0f0 72 63 20 3d 20 66 73 79 6e 63 28 66 64 29 3b 0a rc = fsync(fd);.
1c100 23 65 6c 73 65 20 0a 20 20 72 63 20 3d 20 66 64 #else . rc = fd
1c110 61 74 61 73 79 6e 63 28 66 64 29 3b 0a 23 69 66 atasync(fd);.#if
1c120 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 69 66 OS_VXWORKS. if
1c130 28 20 72 63 3d 3d 2d 31 20 26 26 20 65 72 72 6e ( rc==-1 && errn
1c140 6f 3d 3d 45 4e 4f 54 53 55 50 20 29 7b 0a 20 20 o==ENOTSUP ){.
1c150 20 20 72 63 20 3d 20 66 73 79 6e 63 28 66 64 29 rc = fsync(fd)
1c160 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 ;. }.#endif /*
1c170 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f 0a 23 65 OS_VXWORKS */.#e
1c180 6e 64 69 66 20 2f 2a 20 69 66 64 65 66 20 53 51 ndif /* ifdef SQ
1c190 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 20 65 6c 69 LITE_NO_SYNC eli
1c1a0 66 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e 43 f HAVE_FULLFSYNC
1c1b0 20 2a 2f 0a 0a 20 20 69 66 28 20 4f 53 5f 56 58 */.. if( OS_VX
1c1c0 57 4f 52 4b 53 20 26 26 20 72 63 21 3d 20 2d 31 WORKS && rc!= -1
1c1d0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 30 3b 0a ){. rc = 0;.
1c1e0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
1c1f0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 .}../*.** Open a
1c200 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
1c210 20 74 6f 20 74 68 65 20 64 69 72 65 63 74 6f 72 to the director
1c220 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 66 69 6c y containing fil
1c230 65 20 7a 46 69 6c 65 6e 61 6d 65 2e 0a 2a 2a 20 e zFilename..**
1c240 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 2a If successful, *
1c250 70 46 64 20 69 73 20 73 65 74 20 74 6f 20 74 68 pFd is set to th
1c260 65 20 6f 70 65 6e 65 64 20 66 69 6c 65 20 64 65 e opened file de
1c270 73 63 72 69 70 74 6f 72 20 61 6e 64 0a 2a 2a 20 scriptor and.**
1c280 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
1c290 75 72 6e 65 64 2e 20 49 66 20 61 6e 20 65 72 72 urned. If an err
1c2a0 6f 72 20 6f 63 63 75 72 73 2c 20 65 69 74 68 65 or occurs, eithe
1c2b0 72 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a r SQLITE_NOMEM.*
1c2c0 2a 20 6f 72 20 53 51 4c 49 54 45 5f 43 41 4e 54 * or SQLITE_CANT
1c2d0 4f 50 45 4e 20 69 73 20 72 65 74 75 72 6e 65 64 OPEN is returned
1c2e0 20 61 6e 64 20 2a 70 46 64 20 69 73 20 73 65 74 and *pFd is set
1c2f0 20 74 6f 20 61 6e 20 75 6e 64 65 66 69 6e 65 64 to an undefined
1c300 0a 2a 2a 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a .** value..**.**
1c310 20 54 68 65 20 64 69 72 65 63 74 6f 72 79 20 66 The directory f
1c320 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 ile descriptor i
1c330 73 20 75 73 65 64 20 66 6f 72 20 6f 6e 6c 79 20 s used for only
1c340 6f 6e 65 20 74 68 69 6e 67 20 2d 20 74 6f 0a 2a one thing - to.*
1c350 2a 20 66 73 79 6e 63 28 29 20 61 20 64 69 72 65 * fsync() a dire
1c360 63 74 6f 72 79 20 74 6f 20 6d 61 6b 65 20 73 75 ctory to make su
1c370 72 65 20 66 69 6c 65 20 63 72 65 61 74 69 6f 6e re file creation
1c380 20 61 6e 64 20 64 65 6c 65 74 69 6f 6e 20 65 76 and deletion ev
1c390 65 6e 74 73 0a 2a 2a 20 61 72 65 20 66 6c 75 73 ents.** are flus
1c3a0 68 65 64 20 74 6f 20 64 69 73 6b 2e 20 20 53 75 hed to disk. Su
1c3b0 63 68 20 66 73 79 6e 63 73 20 61 72 65 20 6e 6f ch fsyncs are no
1c3c0 74 20 6e 65 65 64 65 64 20 6f 6e 20 6e 65 77 65 t needed on newe
1c3d0 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 69 6e 67 20 r.** journaling
1c3e0 66 69 6c 65 73 79 73 74 65 6d 73 2c 20 62 75 74 filesystems, but
1c3f0 20 61 72 65 20 72 65 71 75 69 72 65 64 20 6f 6e are required on
1c400 20 6f 6c 64 65 72 20 66 69 6c 65 73 79 73 74 65 older filesyste
1c410 6d 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ms..**.** This r
1c420 6f 75 74 69 6e 65 20 63 61 6e 20 62 65 20 6f 76 outine can be ov
1c430 65 72 72 69 64 64 65 6e 20 75 73 69 6e 67 20 74 erridden using t
1c440 68 65 20 78 53 65 74 53 79 73 43 61 6c 6c 20 69 he xSetSysCall i
1c450 6e 74 65 72 66 61 63 65 2e 0a 2a 2a 20 54 68 65 nterface..** The
1c460 20 61 62 69 6c 69 74 79 20 74 6f 20 6f 76 65 72 ability to over
1c470 72 69 64 65 20 74 68 69 73 20 72 6f 75 74 69 6e ride this routin
1c480 65 20 77 61 73 20 61 64 64 65 64 20 69 6e 20 73 e was added in s
1c490 75 70 70 6f 72 74 20 6f 66 20 74 68 65 0a 2a 2a upport of the.**
1c4a0 20 63 68 72 6f 6d 69 75 6d 20 73 61 6e 64 62 6f chromium sandbo
1c4b0 78 2e 20 20 4f 70 65 6e 69 6e 67 20 61 20 64 69 x. Opening a di
1c4c0 72 65 63 74 6f 72 79 20 69 73 20 61 20 73 65 63 rectory is a sec
1c4d0 75 72 69 74 79 20 72 69 73 6b 20 28 77 65 20 61 urity risk (we a
1c4e0 72 65 0a 2a 2a 20 74 6f 6c 64 29 20 73 6f 20 6d re.** told) so m
1c4f0 61 6b 69 6e 67 20 69 74 20 6f 76 65 72 72 69 64 aking it overrid
1c500 65 61 62 6c 65 20 61 6c 6c 6f 77 73 20 74 68 65 eable allows the
1c510 20 63 68 72 6f 6d 69 75 6d 20 73 61 6e 64 62 6f chromium sandbo
1c520 78 20 74 6f 0a 2a 2a 20 72 65 70 6c 61 63 65 20 x to.** replace
1c530 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 74 this routine wit
1c540 68 20 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d h a harmless no-
1c550 6f 70 2e 20 20 54 6f 20 6d 61 6b 65 20 74 68 69 op. To make thi
1c560 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 61 20 6e s routine.** a n
1c570 6f 2d 6f 70 2c 20 72 65 70 6c 61 63 65 20 69 74 o-op, replace it
1c580 20 77 69 74 68 20 61 20 73 74 75 62 20 74 68 61 with a stub tha
1c590 74 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 t returns SQLITE
1c5a0 5f 4f 4b 20 62 75 74 20 6c 65 61 76 65 73 0a 2a _OK but leaves.*
1c5b0 2a 20 2a 70 46 64 20 73 65 74 20 74 6f 20 61 20 * *pFd set to a
1c5c0 6e 65 67 61 74 69 76 65 20 6e 75 6d 62 65 72 2e negative number.
1c5d0 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 .**.** If SQLITE
1c5e0 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2c _OK is returned,
1c5f0 20 74 68 65 20 63 61 6c 6c 65 72 20 69 73 20 72 the caller is r
1c600 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 63 esponsible for c
1c610 6c 6f 73 69 6e 67 0a 2a 2a 20 74 68 65 20 66 69 losing.** the fi
1c620 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 2a 70 le descriptor *p
1c630 46 64 20 75 73 69 6e 67 20 63 6c 6f 73 65 28 29 Fd using close()
1c640 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1c650 6f 70 65 6e 44 69 72 65 63 74 6f 72 79 28 63 6f openDirectory(co
1c660 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e nst char *zFilen
1c670 61 6d 65 2c 20 69 6e 74 20 2a 70 46 64 29 7b 0a ame, int *pFd){.
1c680 20 20 69 6e 74 20 69 69 3b 0a 20 20 69 6e 74 20 int ii;. int
1c690 66 64 20 3d 20 2d 31 3b 0a 20 20 63 68 61 72 20 fd = -1;. char
1c6a0 7a 44 69 72 6e 61 6d 65 5b 4d 41 58 5f 50 41 54 zDirname[MAX_PAT
1c6b0 48 4e 41 4d 45 2b 31 5d 3b 0a 0a 20 20 73 71 6c HNAME+1];.. sql
1c6c0 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 4d 41 ite3_snprintf(MA
1c6d0 58 5f 50 41 54 48 4e 41 4d 45 2c 20 7a 44 69 72 X_PATHNAME, zDir
1c6e0 6e 61 6d 65 2c 20 22 25 73 22 2c 20 7a 46 69 6c name, "%s", zFil
1c6f0 65 6e 61 6d 65 29 3b 0a 20 20 66 6f 72 28 69 69 ename);. for(ii
1c700 3d 28 69 6e 74 29 73 74 72 6c 65 6e 28 7a 44 69 =(int)strlen(zDi
1c710 72 6e 61 6d 65 29 3b 20 69 69 3e 30 20 26 26 20 rname); ii>0 &&
1c720 7a 44 69 72 6e 61 6d 65 5b 69 69 5d 21 3d 27 2f zDirname[ii]!='/
1c730 27 3b 20 69 69 2d 2d 29 3b 0a 20 20 69 66 28 20 '; ii--);. if(
1c740 69 69 3e 30 20 29 7b 0a 20 20 20 20 7a 44 69 72 ii>0 ){. zDir
1c750 6e 61 6d 65 5b 69 69 5d 20 3d 20 27 5c 30 27 3b name[ii] = '\0';
1c760 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 . }else{. if
1c770 28 20 7a 44 69 72 6e 61 6d 65 5b 30 5d 21 3d 27 ( zDirname[0]!='
1c780 2f 27 20 29 20 7a 44 69 72 6e 61 6d 65 5b 30 5d /' ) zDirname[0]
1c790 20 3d 20 27 2e 27 3b 0a 20 20 20 20 7a 44 69 72 = '.';. zDir
1c7a0 6e 61 6d 65 5b 31 5d 20 3d 20 30 3b 0a 20 20 7d name[1] = 0;. }
1c7b0 0a 20 20 66 64 20 3d 20 72 6f 62 75 73 74 5f 6f . fd = robust_o
1c7c0 70 65 6e 28 7a 44 69 72 6e 61 6d 65 2c 20 4f 5f pen(zDirname, O_
1c7d0 52 44 4f 4e 4c 59 7c 4f 5f 42 49 4e 41 52 59 2c RDONLY|O_BINARY,
1c7e0 20 30 29 3b 0a 20 20 69 66 28 20 66 64 3e 3d 30 0);. if( fd>=0
1c7f0 20 29 7b 0a 20 20 20 20 4f 53 54 52 41 43 45 28 ){. OSTRACE(
1c800 28 22 4f 50 45 4e 44 49 52 20 25 2d 33 64 20 25 ("OPENDIR %-3d %
1c810 73 5c 6e 22 2c 20 66 64 2c 20 7a 44 69 72 6e 61 s\n", fd, zDirna
1c820 6d 65 29 29 3b 0a 20 20 7d 0a 20 20 2a 70 46 64 me));. }. *pFd
1c830 20 3d 20 66 64 3b 0a 20 20 69 66 28 20 66 64 3e = fd;. if( fd>
1c840 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =0 ) return SQLI
1c850 54 45 5f 4f 4b 3b 0a 20 20 72 65 74 75 72 6e 20 TE_OK;. return
1c860 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c unixLogError(SQL
1c870 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 ITE_CANTOPEN_BKP
1c880 54 2c 20 22 6f 70 65 6e 44 69 72 65 63 74 6f 72 T, "openDirector
1c890 79 22 2c 20 7a 44 69 72 6e 61 6d 65 29 3b 0a 7d y", zDirname);.}
1c8a0 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 ../*.** Make sur
1c8b0 65 20 61 6c 6c 20 77 72 69 74 65 73 20 74 6f 20 e all writes to
1c8c0 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 69 6c a particular fil
1c8d0 65 20 61 72 65 20 63 6f 6d 6d 69 74 74 65 64 20 e are committed
1c8e0 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 49 to disk..**.** I
1c8f0 66 20 64 61 74 61 4f 6e 6c 79 3d 3d 30 20 74 68 f dataOnly==0 th
1c900 65 6e 20 62 6f 74 68 20 74 68 65 20 66 69 6c 65 en both the file
1c910 20 69 74 73 65 6c 66 20 61 6e 64 20 69 74 73 20 itself and its
1c920 6d 65 74 61 64 61 74 61 20 28 66 69 6c 65 0a 2a metadata (file.*
1c930 2a 20 73 69 7a 65 2c 20 61 63 63 65 73 73 20 74 * size, access t
1c940 69 6d 65 2c 20 65 74 63 29 20 61 72 65 20 73 79 ime, etc) are sy
1c950 6e 63 65 64 2e 20 20 49 66 20 64 61 74 61 4f 6e nced. If dataOn
1c960 6c 79 21 3d 30 20 74 68 65 6e 20 6f 6e 6c 79 20 ly!=0 then only
1c970 74 68 65 0a 2a 2a 20 66 69 6c 65 20 64 61 74 61 the.** file data
1c980 20 69 73 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a 2a is synced..**.*
1c990 2a 20 55 6e 64 65 72 20 55 6e 69 78 2c 20 61 6c * Under Unix, al
1c9a0 73 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 so make sure tha
1c9b0 74 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 t the directory
1c9c0 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 66 69 entry for the fi
1c9d0 6c 65 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 63 le.** has been c
1c9e0 72 65 61 74 65 64 20 62 79 20 66 73 79 6e 63 2d reated by fsync-
1c9f0 69 6e 67 20 74 68 65 20 64 69 72 65 63 74 6f 72 ing the director
1ca00 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 y that contains
1ca10 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 20 49 66 20 the file..** If
1ca20 77 65 20 64 6f 20 6e 6f 74 20 64 6f 20 74 68 69 we do not do thi
1ca30 73 20 61 6e 64 20 77 65 20 65 6e 63 6f 75 6e 74 s and we encount
1ca40 65 72 20 61 20 70 6f 77 65 72 20 66 61 69 6c 75 er a power failu
1ca50 72 65 2c 20 74 68 65 20 64 69 72 65 63 74 6f 72 re, the director
1ca60 79 0a 2a 2a 20 65 6e 74 72 79 20 66 6f 72 20 74 y.** entry for t
1ca70 68 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 74 he journal might
1ca80 20 6e 6f 74 20 65 78 69 73 74 20 61 66 74 65 72 not exist after
1ca90 20 77 65 20 72 65 62 6f 6f 74 2e 20 20 54 68 65 we reboot. The
1caa0 20 6e 65 78 74 0a 2a 2a 20 53 51 4c 69 74 65 20 next.** SQLite
1cab0 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 66 69 to access the fi
1cac0 6c 65 20 77 69 6c 6c 20 6e 6f 74 20 6b 6e 6f 77 le will not know
1cad0 20 74 68 61 74 20 74 68 65 20 6a 6f 75 72 6e 61 that the journa
1cae0 6c 20 65 78 69 73 74 73 20 28 62 65 63 61 75 73 l exists (becaus
1caf0 65 0a 2a 2a 20 74 68 65 20 64 69 72 65 63 74 6f e.** the directo
1cb00 72 79 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 ry entry for the
1cb10 20 6a 6f 75 72 6e 61 6c 20 77 61 73 20 6e 65 76 journal was nev
1cb20 65 72 20 63 72 65 61 74 65 64 29 20 61 6e 64 20 er created) and
1cb30 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a the transaction.
1cb40 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 72 6f 6c 6c ** will not roll
1cb50 20 62 61 63 6b 20 2d 20 70 6f 73 73 69 62 6c 79 back - possibly
1cb60 20 6c 65 61 64 69 6e 67 20 74 6f 20 64 61 74 61 leading to data
1cb70 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 2e base corruption.
1cb80 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
1cb90 6e 69 78 53 79 6e 63 28 73 71 6c 69 74 65 33 5f nixSync(sqlite3_
1cba0 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 66 6c file *id, int fl
1cbb0 61 67 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a ags){. int rc;.
1cbc0 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c unixFile *pFil
1cbd0 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 e = (unixFile*)i
1cbe0 64 3b 0a 0a 20 20 69 6e 74 20 69 73 44 61 74 61 d;.. int isData
1cbf0 4f 6e 6c 79 20 3d 20 28 66 6c 61 67 73 26 53 51 Only = (flags&SQ
1cc00 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41 4f 4e LITE_SYNC_DATAON
1cc10 4c 59 29 3b 0a 20 20 69 6e 74 20 69 73 46 75 6c LY);. int isFul
1cc20 6c 73 79 6e 63 20 3d 20 28 66 6c 61 67 73 26 30 lsync = (flags&0
1cc30 78 30 46 29 3d 3d 53 51 4c 49 54 45 5f 53 59 4e x0F)==SQLITE_SYN
1cc40 43 5f 46 55 4c 4c 3b 0a 0a 20 20 2f 2a 20 43 68 C_FULL;.. /* Ch
1cc50 65 63 6b 20 74 68 61 74 20 6f 6e 65 20 6f 66 20 eck that one of
1cc60 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
1cc70 41 4c 20 6f 72 20 46 55 4c 4c 20 77 61 73 20 70 AL or FULL was p
1cc80 61 73 73 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 assed */. asser
1cc90 74 28 28 66 6c 61 67 73 26 30 78 30 46 29 3d 3d t((flags&0x0F)==
1cca0 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
1ccb0 41 4c 0a 20 20 20 20 20 20 7c 7c 20 28 66 6c 61 AL. || (fla
1ccc0 67 73 26 30 78 30 46 29 3d 3d 53 51 4c 49 54 45 gs&0x0F)==SQLITE
1ccd0 5f 53 59 4e 43 5f 46 55 4c 4c 0a 20 20 29 3b 0a _SYNC_FULL. );.
1cce0 0a 20 20 2f 2a 20 55 6e 69 78 20 63 61 6e 6e 6f . /* Unix canno
1ccf0 74 2c 20 62 75 74 20 73 6f 6d 65 20 73 79 73 74 t, but some syst
1cd00 65 6d 73 20 6d 61 79 20 72 65 74 75 72 6e 20 53 ems may return S
1cd10 51 4c 49 54 45 5f 46 55 4c 4c 20 66 72 6f 6d 20 QLITE_FULL from
1cd20 68 65 72 65 2e 20 54 68 69 73 0a 20 20 2a 2a 20 here. This. **
1cd30 6c 69 6e 65 20 69 73 20 74 6f 20 74 65 73 74 20 line is to test
1cd40 74 68 61 74 20 64 6f 69 6e 67 20 73 6f 20 64 6f that doing so do
1cd50 65 73 20 6e 6f 74 20 63 61 75 73 65 20 61 6e 79 es not cause any
1cd60 20 70 72 6f 62 6c 65 6d 73 2e 0a 20 20 2a 2f 0a problems.. */.
1cd70 20 20 53 69 6d 75 6c 61 74 65 44 69 73 6b 66 75 SimulateDiskfu
1cd80 6c 6c 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 llError( return
1cd90 53 51 4c 49 54 45 5f 46 55 4c 4c 20 29 3b 0a 0a SQLITE_FULL );..
1cda0 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 assert( pFile
1cdb0 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 53 );. OSTRACE(("S
1cdc0 59 4e 43 20 20 20 20 25 2d 33 64 5c 6e 22 2c 20 YNC %-3d\n",
1cdd0 70 46 69 6c 65 2d 3e 68 29 29 3b 0a 20 20 72 63 pFile->h));. rc
1cde0 20 3d 20 66 75 6c 6c 5f 66 73 79 6e 63 28 70 46 = full_fsync(pF
1cdf0 69 6c 65 2d 3e 68 2c 20 69 73 46 75 6c 6c 73 79 ile->h, isFullsy
1ce00 6e 63 2c 20 69 73 44 61 74 61 4f 6e 6c 79 29 3b nc, isDataOnly);
1ce10 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 . SimulateIOErr
1ce20 6f 72 28 20 72 63 3d 31 20 29 3b 0a 20 20 69 66 or( rc=1 );. if
1ce30 28 20 72 63 20 29 7b 0a 20 20 20 20 73 74 6f 72 ( rc ){. stor
1ce40 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 eLastErrno(pFile
1ce50 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 72 65 , errno);. re
1ce60 74 75 72 6e 20 75 6e 69 78 4c 6f 67 45 72 72 6f turn unixLogErro
1ce70 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 r(SQLITE_IOERR_F
1ce80 53 59 4e 43 2c 20 22 66 75 6c 6c 5f 66 73 79 6e SYNC, "full_fsyn
1ce90 63 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61 74 68 c", pFile->zPath
1cea0 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 6c 73 );. }.. /* Als
1ceb0 6f 20 66 73 79 6e 63 20 74 68 65 20 64 69 72 65 o fsync the dire
1cec0 63 74 6f 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 ctory containing
1ced0 20 74 68 65 20 66 69 6c 65 20 69 66 20 74 68 65 the file if the
1cee0 20 44 49 52 53 59 4e 43 20 66 6c 61 67 0a 20 20 DIRSYNC flag.
1cef0 2a 2a 20 69 73 20 73 65 74 2e 20 20 54 68 69 73 ** is set. This
1cf00 20 69 73 20 61 20 6f 6e 65 2d 74 69 6d 65 20 6f is a one-time o
1cf10 63 63 75 72 72 65 6e 63 65 2e 20 20 4d 61 6e 79 ccurrence. Many
1cf20 20 73 79 73 74 65 6d 73 20 28 65 78 61 6d 70 6c systems (exampl
1cf30 65 73 3a 20 41 49 58 29 0a 20 20 2a 2a 20 61 72 es: AIX). ** ar
1cf40 65 20 75 6e 61 62 6c 65 20 74 6f 20 66 73 79 6e e unable to fsyn
1cf50 63 20 61 20 64 69 72 65 63 74 6f 72 79 2c 20 73 c a directory, s
1cf60 6f 20 69 67 6e 6f 72 65 20 65 72 72 6f 72 73 20 o ignore errors
1cf70 6f 6e 20 74 68 65 20 66 73 79 6e 63 2e 0a 20 20 on the fsync..
1cf80 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e */. if( pFile->
1cf90 63 74 72 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 ctrlFlags & UNIX
1cfa0 46 49 4c 45 5f 44 49 52 53 59 4e 43 20 29 7b 0a FILE_DIRSYNC ){.
1cfb0 20 20 20 20 69 6e 74 20 64 69 72 66 64 3b 0a 20 int dirfd;.
1cfc0 20 20 20 4f 53 54 52 41 43 45 28 28 22 44 49 52 OSTRACE(("DIR
1cfd0 53 59 4e 43 20 25 73 20 28 68 61 76 65 5f 66 75 SYNC %s (have_fu
1cfe0 6c 6c 66 73 79 6e 63 3d 25 64 20 66 75 6c 6c 73 llfsync=%d fulls
1cff0 79 6e 63 3d 25 64 29 5c 6e 22 2c 20 70 46 69 6c ync=%d)\n", pFil
1d000 65 2d 3e 7a 50 61 74 68 2c 0a 20 20 20 20 20 20 e->zPath,.
1d010 20 20 20 20 20 20 48 41 56 45 5f 46 55 4c 4c 46 HAVE_FULLF
1d020 53 59 4e 43 2c 20 69 73 46 75 6c 6c 73 79 6e 63 SYNC, isFullsync
1d030 29 29 3b 0a 20 20 20 20 72 63 20 3d 20 6f 73 4f ));. rc = osO
1d040 70 65 6e 44 69 72 65 63 74 6f 72 79 28 70 46 69 penDirectory(pFi
1d050 6c 65 2d 3e 7a 50 61 74 68 2c 20 26 64 69 72 66 le->zPath, &dirf
1d060 64 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d d);. if( rc==
1d070 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1d080 20 20 20 66 75 6c 6c 5f 66 73 79 6e 63 28 64 69 full_fsync(di
1d090 72 66 64 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 rfd, 0, 0);.
1d0a0 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 robust_close(p
1d0b0 46 69 6c 65 2c 20 64 69 72 66 64 2c 20 5f 5f 4c File, dirfd, __L
1d0c0 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 7d 65 6c 73 INE__);. }els
1d0d0 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 e{. assert(
1d0e0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 43 41 4e 54 rc==SQLITE_CANT
1d0f0 4f 50 45 4e 20 29 3b 0a 20 20 20 20 20 20 72 63 OPEN );. rc
1d100 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1d110 20 20 7d 0a 20 20 20 20 70 46 69 6c 65 2d 3e 63 }. pFile->c
1d120 74 72 6c 46 6c 61 67 73 20 26 3d 20 7e 55 4e 49 trlFlags &= ~UNI
1d130 58 46 49 4c 45 5f 44 49 52 53 59 4e 43 3b 0a 20 XFILE_DIRSYNC;.
1d140 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
1d150 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 }../*.** Truncat
1d160 65 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 74 e an open file t
1d170 6f 20 61 20 73 70 65 63 69 66 69 65 64 20 73 69 o a specified si
1d180 7a 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 ze.*/.static int
1d190 20 75 6e 69 78 54 72 75 6e 63 61 74 65 28 73 71 unixTruncate(sq
1d1a0 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 lite3_file *id,
1d1b0 69 36 34 20 6e 42 79 74 65 29 7b 0a 20 20 75 6e i64 nByte){. un
1d1c0 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 ixFile *pFile =
1d1d0 28 75 6e 69 78 46 69 6c 65 20 2a 29 69 64 3b 0a (unixFile *)id;.
1d1e0 20 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 int rc;. asse
1d1f0 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 53 rt( pFile );. S
1d200 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 imulateIOError(
1d210 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f return SQLITE_IO
1d220 45 52 52 5f 54 52 55 4e 43 41 54 45 20 29 3b 0a ERR_TRUNCATE );.
1d230 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 75 73 65 . /* If the use
1d240 72 20 68 61 73 20 63 6f 6e 66 69 67 75 72 65 64 r has configured
1d250 20 61 20 63 68 75 6e 6b 2d 73 69 7a 65 20 66 6f a chunk-size fo
1d260 72 20 74 68 69 73 20 66 69 6c 65 2c 20 74 72 75 r this file, tru
1d270 6e 63 61 74 65 20 74 68 65 0a 20 20 2a 2a 20 66 ncate the. ** f
1d280 69 6c 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 ile so that it c
1d290 6f 6e 73 69 73 74 73 20 6f 66 20 61 6e 20 69 6e onsists of an in
1d2a0 74 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 teger number of
1d2b0 63 68 75 6e 6b 73 20 28 69 2e 65 2e 20 74 68 65 chunks (i.e. the
1d2c0 0a 20 20 2a 2a 20 61 63 74 75 61 6c 20 66 69 6c . ** actual fil
1d2d0 65 20 73 69 7a 65 20 61 66 74 65 72 20 74 68 65 e size after the
1d2e0 20 6f 70 65 72 61 74 69 6f 6e 20 6d 61 79 20 62 operation may b
1d2f0 65 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 68 e larger than th
1d300 65 20 72 65 71 75 65 73 74 65 64 0a 20 20 2a 2a e requested. **
1d310 20 73 69 7a 65 29 2e 0a 20 20 2a 2f 0a 20 20 69 size).. */. i
1d320 66 28 20 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e f( pFile->szChun
1d330 6b 3e 30 20 29 7b 0a 20 20 20 20 6e 42 79 74 65 k>0 ){. nByte
1d340 20 3d 20 28 28 6e 42 79 74 65 20 2b 20 70 46 69 = ((nByte + pFi
1d350 6c 65 2d 3e 73 7a 43 68 75 6e 6b 20 2d 20 31 29 le->szChunk - 1)
1d360 2f 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e 6b 29 /pFile->szChunk)
1d370 20 2a 20 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e * pFile->szChun
1d380 6b 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 72 k;. }.. rc = r
1d390 6f 62 75 73 74 5f 66 74 72 75 6e 63 61 74 65 28 obust_ftruncate(
1d3a0 70 46 69 6c 65 2d 3e 68 2c 20 6e 42 79 74 65 29 pFile->h, nByte)
1d3b0 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
1d3c0 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f storeLastErrno
1d3d0 28 70 46 69 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a (pFile, errno);.
1d3e0 20 20 20 20 72 65 74 75 72 6e 20 75 6e 69 78 4c return unixL
1d3f0 6f 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 ogError(SQLITE_I
1d400 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 2c 20 22 OERR_TRUNCATE, "
1d410 66 74 72 75 6e 63 61 74 65 22 2c 20 70 46 69 6c ftruncate", pFil
1d420 65 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 7d 65 6c e->zPath);. }el
1d430 73 65 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 se{.#ifdef SQLIT
1d440 45 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 49 E_DEBUG. /* I
1d450 66 20 77 65 20 61 72 65 20 64 6f 69 6e 67 20 61 f we are doing a
1d460 20 6e 6f 72 6d 61 6c 20 77 72 69 74 65 20 74 6f normal write to
1d470 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 a database file
1d480 20 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f 0a (as opposed to.
1d490 20 20 20 20 2a 2a 20 64 6f 69 6e 67 20 61 20 68 ** doing a h
1d4a0 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 ot-journal rollb
1d4b0 61 63 6b 20 6f 72 20 61 20 77 72 69 74 65 20 74 ack or a write t
1d4c0 6f 20 73 6f 6d 65 20 66 69 6c 65 20 6f 74 68 65 o some file othe
1d4d0 72 20 74 68 61 6e 20 61 0a 20 20 20 20 2a 2a 20 r than a. **
1d4e0 6e 6f 72 6d 61 6c 20 64 61 74 61 62 61 73 65 20 normal database
1d4f0 66 69 6c 65 29 20 61 6e 64 20 77 65 20 74 72 75 file) and we tru
1d500 6e 63 61 74 65 20 74 68 65 20 66 69 6c 65 20 74 ncate the file t
1d510 6f 20 7a 65 72 6f 20 6c 65 6e 67 74 68 2c 0a 20 o zero length,.
1d520 20 20 20 2a 2a 20 74 68 61 74 20 65 66 66 65 63 ** that effec
1d530 74 69 76 65 6c 79 20 75 70 64 61 74 65 73 20 74 tively updates t
1d540 68 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 he change counte
1d550 72 2e 20 20 54 68 69 73 20 6d 69 67 68 74 20 68 r. This might h
1d560 61 70 70 65 6e 0a 20 20 20 20 2a 2a 20 77 68 65 appen. ** whe
1d570 6e 20 72 65 73 74 6f 72 69 6e 67 20 61 20 64 61 n restoring a da
1d580 74 61 62 61 73 65 20 75 73 69 6e 67 20 74 68 65 tabase using the
1d590 20 62 61 63 6b 75 70 20 41 50 49 20 66 72 6f 6d backup API from
1d5a0 20 61 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 0a 20 a zero-length.
1d5b0 20 20 20 2a 2a 20 73 6f 75 72 63 65 2e 0a 20 20 ** source..
1d5c0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 46 69 */. if( pFi
1d5d0 6c 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 le->inNormalWrit
1d5e0 65 20 26 26 20 6e 42 79 74 65 3d 3d 30 20 29 7b e && nByte==0 ){
1d5f0 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 74 72 . pFile->tr
1d600 61 6e 73 43 6e 74 72 43 68 6e 67 20 3d 20 31 3b ansCntrChng = 1;
1d610 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 23 . }.#endif..#
1d620 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d if SQLITE_MAX_MM
1d630 41 50 5f 53 49 5a 45 3e 30 0a 20 20 20 20 2f 2a AP_SIZE>0. /*
1d640 20 49 66 20 74 68 65 20 66 69 6c 65 20 77 61 73 If the file was
1d650 20 6a 75 73 74 20 74 72 75 6e 63 61 74 65 64 20 just truncated
1d660 74 6f 20 61 20 73 69 7a 65 20 73 6d 61 6c 6c 65 to a size smalle
1d670 72 20 74 68 61 6e 20 74 68 65 20 63 75 72 72 65 r than the curre
1d680 6e 74 6c 79 0a 20 20 20 20 2a 2a 20 6d 61 70 70 ntly. ** mapp
1d690 65 64 20 72 65 67 69 6f 6e 2c 20 72 65 64 75 63 ed region, reduc
1d6a0 65 20 74 68 65 20 65 66 66 65 63 74 69 76 65 20 e the effective
1d6b0 6d 61 70 70 69 6e 67 20 73 69 7a 65 20 61 73 20 mapping size as
1d6c0 77 65 6c 6c 2e 20 53 51 4c 69 74 65 20 77 69 6c well. SQLite wil
1d6d0 6c 0a 20 20 20 20 2a 2a 20 75 73 65 20 72 65 61 l. ** use rea
1d6e0 64 28 29 20 61 6e 64 20 77 72 69 74 65 28 29 20 d() and write()
1d6f0 74 6f 20 61 63 63 65 73 73 20 64 61 74 61 20 62 to access data b
1d700 65 79 6f 6e 64 20 74 68 69 73 20 70 6f 69 6e 74 eyond this point
1d710 20 66 72 6f 6d 20 6e 6f 77 20 6f 6e 2e 20 20 0a from now on. .
1d720 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e */. if( n
1d730 42 79 74 65 3c 70 46 69 6c 65 2d 3e 6d 6d 61 70 Byte<pFile->mmap
1d740 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 70 46 Size ){. pF
1d750 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20 3d 20 ile->mmapSize =
1d760 6e 42 79 74 65 3b 0a 20 20 20 20 7d 0a 23 65 6e nByte;. }.#en
1d770 64 69 66 0a 0a 20 20 20 20 72 65 74 75 72 6e 20 dif.. return
1d780 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d SQLITE_OK;. }.}
1d790 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 6e ../*.** Determin
1d7a0 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 69 e the current si
1d7b0 7a 65 20 6f 66 20 61 20 66 69 6c 65 20 69 6e 20 ze of a file in
1d7c0 62 79 74 65 73 0a 2a 2f 0a 73 74 61 74 69 63 20 bytes.*/.static
1d7d0 69 6e 74 20 75 6e 69 78 46 69 6c 65 53 69 7a 65 int unixFileSize
1d7e0 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 (sqlite3_file *i
1d7f0 64 2c 20 69 36 34 20 2a 70 53 69 7a 65 29 7b 0a d, i64 *pSize){.
1d800 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 74 72 75 int rc;. stru
1d810 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 20 61 ct stat buf;. a
1d820 73 73 65 72 74 28 20 69 64 20 29 3b 0a 20 20 72 ssert( id );. r
1d830 63 20 3d 20 6f 73 46 73 74 61 74 28 28 28 75 6e c = osFstat(((un
1d840 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 ixFile*)id)->h,
1d850 26 62 75 66 29 3b 0a 20 20 53 69 6d 75 6c 61 74 &buf);. Simulat
1d860 65 49 4f 45 72 72 6f 72 28 20 72 63 3d 31 20 29 eIOError( rc=1 )
1d870 3b 0a 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b ;. if( rc!=0 ){
1d880 0a 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72 . storeLastEr
1d890 72 6e 6f 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 rno((unixFile*)i
1d8a0 64 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 72 d, errno);. r
1d8b0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 eturn SQLITE_IOE
1d8c0 52 52 5f 46 53 54 41 54 3b 0a 20 20 7d 0a 20 20 RR_FSTAT;. }.
1d8d0 2a 70 53 69 7a 65 20 3d 20 62 75 66 2e 73 74 5f *pSize = buf.st_
1d8e0 73 69 7a 65 3b 0a 0a 20 20 2f 2a 20 57 68 65 6e size;.. /* When
1d8f0 20 6f 70 65 6e 69 6e 67 20 61 20 7a 65 72 6f 2d opening a zero-
1d900 73 69 7a 65 20 64 61 74 61 62 61 73 65 2c 20 74 size database, t
1d910 68 65 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f he findInodeInfo
1d920 28 29 20 70 72 6f 63 65 64 75 72 65 0a 20 20 2a () procedure. *
1d930 2a 20 77 72 69 74 65 73 20 61 20 73 69 6e 67 6c * writes a singl
1d940 65 20 62 79 74 65 20 69 6e 74 6f 20 74 68 61 74 e byte into that
1d950 20 66 69 6c 65 20 69 6e 20 6f 72 64 65 72 20 74 file in order t
1d960 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 61 20 o work around a
1d970 62 75 67 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 bug. ** in the
1d980 4f 53 2d 58 20 6d 73 64 6f 73 20 66 69 6c 65 73 OS-X msdos files
1d990 79 73 74 65 6d 2e 20 20 49 6e 20 6f 72 64 65 72 ystem. In order
1d9a0 20 74 6f 20 61 76 6f 69 64 20 70 72 6f 62 6c 65 to avoid proble
1d9b0 6d 73 20 77 69 74 68 20 75 70 70 65 72 0a 20 20 ms with upper.
1d9c0 2a 2a 20 6c 61 79 65 72 73 2c 20 77 65 20 6e 65 ** layers, we ne
1d9d0 65 64 20 74 6f 20 72 65 70 6f 72 74 20 74 68 69 ed to report thi
1d9e0 73 20 66 69 6c 65 20 73 69 7a 65 20 61 73 20 7a s file size as z
1d9f0 65 72 6f 20 65 76 65 6e 20 74 68 6f 75 67 68 20 ero even though
1da00 69 74 20 69 73 0a 20 20 2a 2a 20 72 65 61 6c 6c it is. ** reall
1da10 79 20 31 2e 20 20 20 54 69 63 6b 65 74 20 23 33 y 1. Ticket #3
1da20 32 36 30 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 260.. */. if(
1da30 2a 70 53 69 7a 65 3d 3d 31 20 29 20 2a 70 53 69 *pSize==1 ) *pSi
1da40 7a 65 20 3d 20 30 3b 0a 0a 0a 20 20 72 65 74 75 ze = 0;... retu
1da50 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
1da60 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 .#if SQLITE_ENAB
1da70 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
1da80 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 && defined(__AP
1da90 50 4c 45 5f 5f 29 0a 2f 2a 0a 2a 2a 20 48 61 6e PLE__)./*.** Han
1daa0 64 6c 65 72 20 66 6f 72 20 70 72 6f 78 79 2d 6c dler for proxy-l
1dab0 6f 63 6b 69 6e 67 20 66 69 6c 65 2d 63 6f 6e 74 ocking file-cont
1dac0 72 6f 6c 20 76 65 72 62 73 2e 20 20 44 65 66 69 rol verbs. Defi
1dad0 6e 65 64 20 62 65 6c 6f 77 20 69 6e 20 74 68 65 ned below in the
1dae0 0a 2a 2a 20 70 72 6f 78 79 69 6e 67 20 6c 6f 63 .** proxying loc
1daf0 6b 69 6e 67 20 64 69 76 69 73 69 6f 6e 2e 0a 2a king division..*
1db00 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f /.static int pro
1db10 78 79 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 73 71 xyFileControl(sq
1db20 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 69 6e 74 2c lite3_file*,int,
1db30 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a void*);.#endif..
1db40 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 /* .** This func
1db50 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 tion is called t
1db60 6f 20 68 61 6e 64 6c 65 20 74 68 65 20 53 51 4c o handle the SQL
1db70 49 54 45 5f 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 ITE_FCNTL_SIZE_H
1db80 49 4e 54 20 0a 2a 2a 20 66 69 6c 65 2d 63 6f 6e INT .** file-con
1db90 74 72 6f 6c 20 6f 70 65 72 61 74 69 6f 6e 2e 20 trol operation.
1dba0 20 45 6e 6c 61 72 67 65 20 74 68 65 20 64 61 74 Enlarge the dat
1dbb0 61 62 61 73 65 20 74 6f 20 6e 42 79 74 65 73 20 abase to nBytes
1dbc0 69 6e 20 73 69 7a 65 0a 2a 2a 20 28 72 6f 75 6e in size.** (roun
1dbd0 64 65 64 20 75 70 20 74 6f 20 74 68 65 20 6e 65 ded up to the ne
1dbe0 78 74 20 63 68 75 6e 6b 2d 73 69 7a 65 29 2e 20 xt chunk-size).
1dbf0 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 If the database
1dc00 20 69 73 20 61 6c 72 65 61 64 79 0a 2a 2a 20 6e is already.** n
1dc10 42 79 74 65 73 20 6f 72 20 6c 61 72 67 65 72 2c Bytes or larger,
1dc20 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
1dc30 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 a no-op..*/.sta
1dc40 74 69 63 20 69 6e 74 20 66 63 6e 74 6c 53 69 7a tic int fcntlSiz
1dc50 65 48 69 6e 74 28 75 6e 69 78 46 69 6c 65 20 2a eHint(unixFile *
1dc60 70 46 69 6c 65 2c 20 69 36 34 20 6e 42 79 74 65 pFile, i64 nByte
1dc70 29 7b 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e ){. if( pFile->
1dc80 73 7a 43 68 75 6e 6b 3e 30 20 29 7b 0a 20 20 20 szChunk>0 ){.
1dc90 20 69 36 34 20 6e 53 69 7a 65 3b 20 20 20 20 20 i64 nSize;
1dca0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1dcb0 2a 20 52 65 71 75 69 72 65 64 20 66 69 6c 65 20 * Required file
1dcc0 73 69 7a 65 20 2a 2f 0a 20 20 20 20 73 74 72 75 size */. stru
1dcd0 63 74 20 73 74 61 74 20 62 75 66 3b 20 20 20 20 ct stat buf;
1dce0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 /* Use
1dcf0 64 20 74 6f 20 68 6f 6c 64 20 72 65 74 75 72 6e d to hold return
1dd00 20 76 61 6c 75 65 73 20 6f 66 20 66 73 74 61 74 values of fstat
1dd10 28 29 20 2a 2f 0a 20 20 20 0a 20 20 20 20 69 66 () */. . if
1dd20 28 20 6f 73 46 73 74 61 74 28 70 46 69 6c 65 2d ( osFstat(pFile-
1dd30 3e 68 2c 20 26 62 75 66 29 20 29 7b 0a 20 20 20 >h, &buf) ){.
1dd40 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
1dd50 5f 49 4f 45 52 52 5f 46 53 54 41 54 3b 0a 20 20 _IOERR_FSTAT;.
1dd60 20 20 7d 0a 0a 20 20 20 20 6e 53 69 7a 65 20 3d }.. nSize =
1dd70 20 28 28 6e 42 79 74 65 2b 70 46 69 6c 65 2d 3e ((nByte+pFile->
1dd80 73 7a 43 68 75 6e 6b 2d 31 29 20 2f 20 70 46 69 szChunk-1) / pFi
1dd90 6c 65 2d 3e 73 7a 43 68 75 6e 6b 29 20 2a 20 70 le->szChunk) * p
1dda0 46 69 6c 65 2d 3e 73 7a 43 68 75 6e 6b 3b 0a 20 File->szChunk;.
1ddb0 20 20 20 69 66 28 20 6e 53 69 7a 65 3e 28 69 36 if( nSize>(i6
1ddc0 34 29 62 75 66 2e 73 74 5f 73 69 7a 65 20 29 7b 4)buf.st_size ){
1ddd0 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 48 41 ..#if defined(HA
1dde0 56 45 5f 50 4f 53 49 58 5f 46 41 4c 4c 4f 43 41 VE_POSIX_FALLOCA
1ddf0 54 45 29 20 26 26 20 48 41 56 45 5f 50 4f 53 49 TE) && HAVE_POSI
1de00 58 5f 46 41 4c 4c 4f 43 41 54 45 0a 20 20 20 20 X_FALLOCATE.
1de10 20 20 2f 2a 20 54 68 65 20 63 6f 64 65 20 62 65 /* The code be
1de20 6c 6f 77 20 69 73 20 68 61 6e 64 6c 69 6e 67 20 low is handling
1de30 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 the return value
1de40 20 6f 66 20 6f 73 46 61 6c 6c 6f 63 61 74 65 28 of osFallocate(
1de50 29 20 0a 20 20 20 20 20 20 2a 2a 20 63 6f 72 72 ) . ** corr
1de60 65 63 74 6c 79 2e 20 70 6f 73 69 78 5f 66 61 6c ectly. posix_fal
1de70 6c 6f 63 61 74 65 28 29 20 69 73 20 64 65 66 69 locate() is defi
1de80 6e 65 64 20 74 6f 20 22 72 65 74 75 72 6e 73 20 ned to "returns
1de90 7a 65 72 6f 20 6f 6e 20 73 75 63 63 65 73 73 2c zero on success,
1dea0 20 0a 20 20 20 20 20 20 2a 2a 20 6f 72 20 61 6e . ** or an
1deb0 20 65 72 72 6f 72 20 6e 75 6d 62 65 72 20 6f 6e error number on
1dec0 20 20 66 61 69 6c 75 72 65 22 2e 20 53 65 65 20 failure". See
1ded0 74 68 65 20 6d 61 6e 70 61 67 65 20 66 6f 72 20 the manpage for
1dee0 64 65 74 61 69 6c 73 2e 20 2a 2f 0a 20 20 20 20 details. */.
1def0 20 20 69 6e 74 20 65 72 72 3b 0a 20 20 20 20 20 int err;.
1df00 20 64 6f 7b 0a 20 20 20 20 20 20 20 20 65 72 72 do{. err
1df10 20 3d 20 6f 73 46 61 6c 6c 6f 63 61 74 65 28 70 = osFallocate(p
1df20 46 69 6c 65 2d 3e 68 2c 20 62 75 66 2e 73 74 5f File->h, buf.st_
1df30 73 69 7a 65 2c 20 6e 53 69 7a 65 2d 62 75 66 2e size, nSize-buf.
1df40 73 74 5f 73 69 7a 65 29 3b 0a 20 20 20 20 20 20 st_size);.
1df50 7d 77 68 69 6c 65 28 20 65 72 72 3d 3d 45 49 4e }while( err==EIN
1df60 54 52 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 TR );. if(
1df70 65 72 72 20 29 20 72 65 74 75 72 6e 20 53 51 4c err ) return SQL
1df80 49 54 45 5f 49 4f 45 52 52 5f 57 52 49 54 45 3b ITE_IOERR_WRITE;
1df90 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 2f 2a 20 .#else. /*
1dfa0 49 66 20 74 68 65 20 4f 53 20 64 6f 65 73 20 6e If the OS does n
1dfb0 6f 74 20 68 61 76 65 20 70 6f 73 69 78 5f 66 61 ot have posix_fa
1dfc0 6c 6c 6f 63 61 74 65 28 29 2c 20 66 61 6b 65 20 llocate(), fake
1dfd0 69 74 2e 20 57 72 69 74 65 20 61 20 0a 20 20 20 it. Write a .
1dfe0 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 ** single byt
1dff0 65 20 74 6f 20 74 68 65 20 6c 61 73 74 20 62 79 e to the last by
1e000 74 65 20 69 6e 20 65 61 63 68 20 62 6c 6f 63 6b te in each block
1e010 20 74 68 61 74 20 66 61 6c 6c 73 20 65 6e 74 69 that falls enti
1e020 72 65 6c 79 0a 20 20 20 20 20 20 2a 2a 20 77 69 rely. ** wi
1e030 74 68 69 6e 20 74 68 65 20 65 78 74 65 6e 64 65 thin the extende
1e040 64 20 72 65 67 69 6f 6e 2e 20 54 68 65 6e 2c 20 d region. Then,
1e050 69 66 20 72 65 71 75 69 72 65 64 2c 20 61 20 73 if required, a s
1e060 69 6e 67 6c 65 20 62 79 74 65 0a 20 20 20 20 20 ingle byte.
1e070 20 2a 2a 20 61 74 20 6f 66 66 73 65 74 20 28 6e ** at offset (n
1e080 53 69 7a 65 2d 31 29 2c 20 74 6f 20 73 65 74 20 Size-1), to set
1e090 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
1e0a0 66 69 6c 65 20 63 6f 72 72 65 63 74 6c 79 2e 0a file correctly..
1e0b0 20 20 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 ** This is
1e0c0 20 61 20 73 69 6d 69 6c 61 72 20 74 65 63 68 6e a similar techn
1e0d0 69 71 75 65 20 74 6f 20 74 68 61 74 20 75 73 65 ique to that use
1e0e0 64 20 62 79 20 67 6c 69 62 63 20 6f 6e 20 73 79 d by glibc on sy
1e0f0 73 74 65 6d 73 0a 20 20 20 20 20 20 2a 2a 20 74 stems. ** t
1e100 68 61 74 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 hat do not have
1e110 61 20 72 65 61 6c 20 66 61 6c 6c 6f 63 61 74 65 a real fallocate
1e120 28 29 20 63 61 6c 6c 2e 0a 20 20 20 20 20 20 2a () call.. *
1e130 2f 0a 20 20 20 20 20 20 69 6e 74 20 6e 42 6c 6b /. int nBlk
1e140 20 3d 20 62 75 66 2e 73 74 5f 62 6c 6b 73 69 7a = buf.st_blksiz
1e150 65 3b 20 20 2f 2a 20 46 69 6c 65 2d 73 79 73 74 e; /* File-syst
1e160 65 6d 20 62 6c 6f 63 6b 20 73 69 7a 65 20 2a 2f em block size */
1e170 0a 20 20 20 20 20 20 69 6e 74 20 6e 57 72 69 74 . int nWrit
1e180 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 e = 0;
1e190 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1e1a0 62 79 74 65 73 20 77 72 69 74 74 65 6e 20 62 79 bytes written by
1e1b0 20 73 65 65 6b 41 6e 64 57 72 69 74 65 20 2a 2f seekAndWrite */
1e1c0 0a 20 20 20 20 20 20 69 36 34 20 69 57 72 69 74 . i64 iWrit
1e1d0 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
1e1e0 20 20 20 2f 2a 20 4e 65 78 74 20 6f 66 66 73 65 /* Next offse
1e1f0 74 20 74 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f t to write to */
1e200 0a 0a 20 20 20 20 20 20 69 57 72 69 74 65 20 3d .. iWrite =
1e210 20 28 62 75 66 2e 73 74 5f 73 69 7a 65 2f 6e 42 (buf.st_size/nB
1e220 6c 6b 29 2a 6e 42 6c 6b 20 2b 20 6e 42 6c 6b 20 lk)*nBlk + nBlk
1e230 2d 20 31 3b 0a 20 20 20 20 20 20 61 73 73 65 72 - 1;. asser
1e240 74 28 20 69 57 72 69 74 65 3e 3d 62 75 66 2e 73 t( iWrite>=buf.s
1e250 74 5f 73 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 t_size );.
1e260 61 73 73 65 72 74 28 20 28 28 69 57 72 69 74 65 assert( ((iWrite
1e270 2b 31 29 25 6e 42 6c 6b 29 3d 3d 30 20 29 3b 0a +1)%nBlk)==0 );.
1e280 20 20 20 20 20 20 66 6f 72 28 2f 2a 6e 6f 2d 6f for(/*no-o
1e290 70 2a 2f 3b 20 69 57 72 69 74 65 3c 6e 53 69 7a p*/; iWrite<nSiz
1e2a0 65 2b 6e 42 6c 6b 2d 31 3b 20 69 57 72 69 74 65 e+nBlk-1; iWrite
1e2b0 2b 3d 6e 42 6c 6b 20 29 7b 0a 20 20 20 20 20 20 +=nBlk ){.
1e2c0 20 20 69 66 28 20 69 57 72 69 74 65 3e 3d 6e 53 if( iWrite>=nS
1e2d0 69 7a 65 20 29 20 69 57 72 69 74 65 20 3d 20 6e ize ) iWrite = n
1e2e0 53 69 7a 65 20 2d 20 31 3b 0a 20 20 20 20 20 20 Size - 1;.
1e2f0 20 20 6e 57 72 69 74 65 20 3d 20 73 65 65 6b 41 nWrite = seekA
1e300 6e 64 57 72 69 74 65 28 70 46 69 6c 65 2c 20 69 ndWrite(pFile, i
1e310 57 72 69 74 65 2c 20 22 22 2c 20 31 29 3b 0a 20 Write, "", 1);.
1e320 20 20 20 20 20 20 20 69 66 28 20 6e 57 72 69 74 if( nWrit
1e330 65 21 3d 31 20 29 20 72 65 74 75 72 6e 20 53 51 e!=1 ) return SQ
1e340 4c 49 54 45 5f 49 4f 45 52 52 5f 57 52 49 54 45 LITE_IOERR_WRITE
1e350 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 ;. }.#endif
1e360 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 20 . }. }..#if
1e370 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
1e380 53 49 5a 45 3e 30 0a 20 20 69 66 28 20 70 46 69 SIZE>0. if( pFi
1e390 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 3e le->mmapSizeMax>
1e3a0 30 20 26 26 20 6e 42 79 74 65 3e 70 46 69 6c 65 0 && nByte>pFile
1e3b0 2d 3e 6d 6d 61 70 53 69 7a 65 20 29 7b 0a 20 20 ->mmapSize ){.
1e3c0 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 69 66 int rc;. if
1e3d0 28 20 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e 6b ( pFile->szChunk
1e3e0 3c 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 <=0 ){. if(
1e3f0 20 72 6f 62 75 73 74 5f 66 74 72 75 6e 63 61 74 robust_ftruncat
1e400 65 28 70 46 69 6c 65 2d 3e 68 2c 20 6e 42 79 74 e(pFile->h, nByt
1e410 65 29 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74 e) ){. st
1e420 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 oreLastErrno(pFi
1e430 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 le, errno);.
1e440 20 20 20 20 72 65 74 75 72 6e 20 75 6e 69 78 4c return unixL
1e450 6f 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 ogError(SQLITE_I
1e460 4f 45 52 52 5f 54 52 55 4e 43 41 54 45 2c 20 22 OERR_TRUNCATE, "
1e470 66 74 72 75 6e 63 61 74 65 22 2c 20 70 46 69 6c ftruncate", pFil
1e480 65 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 20 20 20 e->zPath);.
1e490 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 72 63 }. }.. rc
1e4a0 20 3d 20 75 6e 69 78 4d 61 70 66 69 6c 65 28 70 = unixMapfile(p
1e4b0 46 69 6c 65 2c 20 6e 42 79 74 65 29 3b 0a 20 20 File, nByte);.
1e4c0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
1e4d0 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 .#endif.. retur
1e4e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1e4f0 2f 2a 0a 2a 2a 20 49 66 20 2a 70 41 72 67 20 69 /*.** If *pArg i
1e500 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e 65 67 61 s initially nega
1e510 74 69 76 65 20 74 68 65 6e 20 74 68 69 73 20 69 tive then this i
1e520 73 20 61 20 71 75 65 72 79 2e 20 20 53 65 74 20 s a query. Set
1e530 2a 70 41 72 67 20 74 6f 0a 2a 2a 20 31 20 6f 72 *pArg to.** 1 or
1e540 20 30 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 0 depending on
1e550 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 62 whether or not b
1e560 69 74 20 6d 61 73 6b 20 6f 66 20 70 46 69 6c 65 it mask of pFile
1e570 2d 3e 63 74 72 6c 46 6c 61 67 73 20 69 73 20 73 ->ctrlFlags is s
1e580 65 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 41 et..**.** If *pA
1e590 72 67 20 69 73 20 30 20 6f 72 20 31 2c 20 74 68 rg is 0 or 1, th
1e5a0 65 6e 20 63 6c 65 61 72 20 6f 72 20 73 65 74 20 en clear or set
1e5b0 74 68 65 20 6d 61 73 6b 20 62 69 74 20 6f 66 20 the mask bit of
1e5c0 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 73 pFile->ctrlFlags
1e5d0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
1e5e0 20 75 6e 69 78 4d 6f 64 65 42 69 74 28 75 6e 69 unixModeBit(uni
1e5f0 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 75 6e xFile *pFile, un
1e600 73 69 67 6e 65 64 20 63 68 61 72 20 6d 61 73 6b signed char mask
1e610 2c 20 69 6e 74 20 2a 70 41 72 67 29 7b 0a 20 20 , int *pArg){.
1e620 69 66 28 20 2a 70 41 72 67 3c 30 20 29 7b 0a 20 if( *pArg<0 ){.
1e630 20 20 20 2a 70 41 72 67 20 3d 20 28 70 46 69 6c *pArg = (pFil
1e640 65 2d 3e 63 74 72 6c 46 6c 61 67 73 20 26 20 6d e->ctrlFlags & m
1e650 61 73 6b 29 21 3d 30 3b 0a 20 20 7d 65 6c 73 65 ask)!=0;. }else
1e660 20 69 66 28 20 28 2a 70 41 72 67 29 3d 3d 30 20 if( (*pArg)==0
1e670 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 63 74 ){. pFile->ct
1e680 72 6c 46 6c 61 67 73 20 26 3d 20 7e 6d 61 73 6b rlFlags &= ~mask
1e690 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
1e6a0 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 73 20 File->ctrlFlags
1e6b0 7c 3d 20 6d 61 73 6b 3b 0a 20 20 7d 0a 7d 0a 0a |= mask;. }.}..
1e6c0 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 /* Forward decla
1e6d0 72 61 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 ration */.static
1e6e0 20 69 6e 74 20 75 6e 69 78 47 65 74 54 65 6d 70 int unixGetTemp
1e6f0 6e 61 6d 65 28 69 6e 74 20 6e 42 75 66 2c 20 63 name(int nBuf, c
1e700 68 61 72 20 2a 7a 42 75 66 29 3b 0a 0a 2f 2a 0a har *zBuf);../*.
1e710 2a 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 ** Information a
1e720 6e 64 20 63 6f 6e 74 72 6f 6c 20 6f 66 20 61 6e nd control of an
1e730 20 6f 70 65 6e 20 66 69 6c 65 20 68 61 6e 64 6c open file handl
1e740 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
1e750 20 75 6e 69 78 46 69 6c 65 43 6f 6e 74 72 6f 6c unixFileControl
1e760 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 (sqlite3_file *i
1e770 64 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69 64 20 d, int op, void
1e780 2a 70 41 72 67 29 7b 0a 20 20 75 6e 69 78 46 69 *pArg){. unixFi
1e790 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 le *pFile = (uni
1e7a0 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 73 77 69 xFile*)id;. swi
1e7b0 74 63 68 28 20 6f 70 20 29 7b 0a 20 20 20 20 63 tch( op ){. c
1e7c0 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c ase SQLITE_FCNTL
1e7d0 5f 4c 4f 43 4b 53 54 41 54 45 3a 20 7b 0a 20 20 _LOCKSTATE: {.
1e7e0 20 20 20 20 2a 28 69 6e 74 2a 29 70 41 72 67 20 *(int*)pArg
1e7f0 3d 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f = pFile->eFileLo
1e800 63 6b 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ck;. return
1e810 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
1e820 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 }. case SQLIT
1e830 45 5f 46 43 4e 54 4c 5f 4c 41 53 54 5f 45 52 52 E_FCNTL_LAST_ERR
1e840 4e 4f 3a 20 7b 0a 20 20 20 20 20 20 2a 28 69 6e NO: {. *(in
1e850 74 2a 29 70 41 72 67 20 3d 20 70 46 69 6c 65 2d t*)pArg = pFile-
1e860 3e 6c 61 73 74 45 72 72 6e 6f 3b 0a 20 20 20 20 >lastErrno;.
1e870 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1e880 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 OK;. }. ca
1e890 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f se SQLITE_FCNTL_
1e8a0 43 48 55 4e 4b 5f 53 49 5a 45 3a 20 7b 0a 20 20 CHUNK_SIZE: {.
1e8b0 20 20 20 20 70 46 69 6c 65 2d 3e 73 7a 43 68 75 pFile->szChu
1e8c0 6e 6b 20 3d 20 2a 28 69 6e 74 20 2a 29 70 41 72 nk = *(int *)pAr
1e8d0 67 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 g;. return
1e8e0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
1e8f0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 . case SQLITE
1e900 5f 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e 54 _FCNTL_SIZE_HINT
1e910 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 : {. int rc
1e920 3b 0a 20 20 20 20 20 20 53 69 6d 75 6c 61 74 65 ;. Simulate
1e930 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 31 29 IOErrorBenign(1)
1e940 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 63 6e ;. rc = fcn
1e950 74 6c 53 69 7a 65 48 69 6e 74 28 70 46 69 6c 65 tlSizeHint(pFile
1e960 2c 20 2a 28 69 36 34 20 2a 29 70 41 72 67 29 3b , *(i64 *)pArg);
1e970 0a 20 20 20 20 20 20 53 69 6d 75 6c 61 74 65 49 . SimulateI
1e980 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 30 29 3b OErrorBenign(0);
1e990 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
1e9a0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 ;. }. case
1e9b0 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 50 45 SQLITE_FCNTL_PE
1e9c0 52 53 49 53 54 5f 57 41 4c 3a 20 7b 0a 20 20 20 RSIST_WAL: {.
1e9d0 20 20 20 75 6e 69 78 4d 6f 64 65 42 69 74 28 70 unixModeBit(p
1e9e0 46 69 6c 65 2c 20 55 4e 49 58 46 49 4c 45 5f 50 File, UNIXFILE_P
1e9f0 45 52 53 49 53 54 5f 57 41 4c 2c 20 28 69 6e 74 ERSIST_WAL, (int
1ea00 2a 29 70 41 72 67 29 3b 0a 20 20 20 20 20 20 72 *)pArg);. r
1ea10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1ea20 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
1ea30 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 50 4f 57 SQLITE_FCNTL_POW
1ea40 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 ERSAFE_OVERWRITE
1ea50 3a 20 7b 0a 20 20 20 20 20 20 75 6e 69 78 4d 6f : {. unixMo
1ea60 64 65 42 69 74 28 70 46 69 6c 65 2c 20 55 4e 49 deBit(pFile, UNI
1ea70 58 46 49 4c 45 5f 50 53 4f 57 2c 20 28 69 6e 74 XFILE_PSOW, (int
1ea80 2a 29 70 41 72 67 29 3b 0a 20 20 20 20 20 20 72 *)pArg);. r
1ea90 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1eaa0 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
1eab0 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 56 46 53 SQLITE_FCNTL_VFS
1eac0 4e 41 4d 45 3a 20 7b 0a 20 20 20 20 20 20 2a 28 NAME: {. *(
1ead0 63 68 61 72 2a 2a 29 70 41 72 67 20 3d 20 73 71 char**)pArg = sq
1eae0 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 25 lite3_mprintf("%
1eaf0 73 22 2c 20 70 46 69 6c 65 2d 3e 70 56 66 73 2d s", pFile->pVfs-
1eb00 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 72 >zName);. r
1eb10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1eb20 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 . }. case
1eb30 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 54 45 4d SQLITE_FCNTL_TEM
1eb40 50 46 49 4c 45 4e 41 4d 45 3a 20 7b 0a 20 20 20 PFILENAME: {.
1eb50 20 20 20 63 68 61 72 20 2a 7a 54 46 69 6c 65 20 char *zTFile
1eb60 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 = sqlite3_malloc
1eb70 36 34 28 20 70 46 69 6c 65 2d 3e 70 56 66 73 2d 64( pFile->pVfs-
1eb80 3e 6d 78 50 61 74 68 6e 61 6d 65 20 29 3b 0a 20 >mxPathname );.
1eb90 20 20 20 20 20 69 66 28 20 7a 54 46 69 6c 65 20 if( zTFile
1eba0 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 69 78 47 ){. unixG
1ebb0 65 74 54 65 6d 70 6e 61 6d 65 28 70 46 69 6c 65 etTempname(pFile
1ebc0 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 ->pVfs->mxPathna
1ebd0 6d 65 2c 20 7a 54 46 69 6c 65 29 3b 0a 20 20 20 me, zTFile);.
1ebe0 20 20 20 20 20 2a 28 63 68 61 72 2a 2a 29 70 41 *(char**)pA
1ebf0 72 67 20 3d 20 7a 54 46 69 6c 65 3b 0a 20 20 20 rg = zTFile;.
1ec00 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72 }. retur
1ec10 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 n SQLITE_OK;.
1ec20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 }. case SQLI
1ec30 54 45 5f 46 43 4e 54 4c 5f 48 41 53 5f 4d 4f 56 TE_FCNTL_HAS_MOV
1ec40 45 44 3a 20 7b 0a 20 20 20 20 20 20 2a 28 69 6e ED: {. *(in
1ec50 74 2a 29 70 41 72 67 20 3d 20 66 69 6c 65 48 61 t*)pArg = fileHa
1ec60 73 4d 6f 76 65 64 28 70 46 69 6c 65 29 3b 0a 20 sMoved(pFile);.
1ec70 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
1ec80 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 23 69 66 TE_OK;. }.#if
1ec90 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
1eca0 5f 53 49 5a 45 3e 30 0a 20 20 20 20 63 61 73 65 _SIZE>0. case
1ecb0 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4d 4d SQLITE_FCNTL_MM
1ecc0 41 50 5f 53 49 5a 45 3a 20 7b 0a 20 20 20 20 20 AP_SIZE: {.
1ecd0 20 69 36 34 20 6e 65 77 4c 69 6d 69 74 20 3d 20 i64 newLimit =
1ece0 2a 28 69 36 34 2a 29 70 41 72 67 3b 0a 20 20 20 *(i64*)pArg;.
1ecf0 20 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 int rc = SQLI
1ed00 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 69 66 28 TE_OK;. if(
1ed10 20 6e 65 77 4c 69 6d 69 74 3e 73 71 6c 69 74 65 newLimit>sqlite
1ed20 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 78 3GlobalConfig.mx
1ed30 4d 6d 61 70 20 29 7b 0a 20 20 20 20 20 20 20 20 Mmap ){.
1ed40 6e 65 77 4c 69 6d 69 74 20 3d 20 73 71 6c 69 74 newLimit = sqlit
1ed50 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d e3GlobalConfig.m
1ed60 78 4d 6d 61 70 3b 0a 20 20 20 20 20 20 7d 0a 20 xMmap;. }.
1ed70 20 20 20 20 20 2a 28 69 36 34 2a 29 70 41 72 67 *(i64*)pArg
1ed80 20 3d 20 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 = pFile->mmapSi
1ed90 7a 65 4d 61 78 3b 0a 20 20 20 20 20 20 69 66 28 zeMax;. if(
1eda0 20 6e 65 77 4c 69 6d 69 74 3e 3d 30 20 26 26 20 newLimit>=0 &&
1edb0 6e 65 77 4c 69 6d 69 74 21 3d 70 46 69 6c 65 2d newLimit!=pFile-
1edc0 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 20 26 26 20 >mmapSizeMax &&
1edd0 70 46 69 6c 65 2d 3e 6e 46 65 74 63 68 4f 75 74 pFile->nFetchOut
1ede0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ==0 ){. p
1edf0 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 File->mmapSizeMa
1ee00 78 20 3d 20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 x = newLimit;.
1ee10 20 20 20 20 20 20 69 66 28 20 70 46 69 6c 65 2d if( pFile-
1ee20 3e 6d 6d 61 70 53 69 7a 65 3e 30 20 29 7b 0a 20 >mmapSize>0 ){.
1ee30 20 20 20 20 20 20 20 20 20 75 6e 69 78 55 6e 6d unixUnm
1ee40 61 70 66 69 6c 65 28 70 46 69 6c 65 29 3b 0a 20 apfile(pFile);.
1ee50 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 75 6e rc = un
1ee60 69 78 4d 61 70 66 69 6c 65 28 70 46 69 6c 65 2c ixMapfile(pFile,
1ee70 20 2d 31 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a -1);. }.
1ee80 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 }. re
1ee90 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 23 turn rc;. }.#
1eea0 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
1eeb0 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a ITE_DEBUG. /*
1eec0 20 54 68 65 20 70 61 67 65 72 20 63 61 6c 6c 73 The pager calls
1eed0 20 74 68 69 73 20 6d 65 74 68 6f 64 20 74 6f 20 this method to
1eee0 73 69 67 6e 61 6c 20 74 68 61 74 20 69 74 20 68 signal that it h
1eef0 61 73 20 64 6f 6e 65 0a 20 20 20 20 2a 2a 20 61 as done. ** a
1ef00 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 74 68 rollback and th
1ef10 61 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20 at the database
1ef20 69 73 20 74 68 65 72 65 66 6f 72 65 20 75 6e 63 is therefore unc
1ef30 68 61 6e 67 65 64 20 61 6e 64 0a 20 20 20 20 2a hanged and. *
1ef40 2a 20 69 74 20 68 65 6e 63 65 20 69 74 20 69 73 * it hence it is
1ef50 20 4f 4b 20 66 6f 72 20 74 68 65 20 74 72 61 6e OK for the tran
1ef60 73 61 63 74 69 6f 6e 20 63 68 61 6e 67 65 20 63 saction change c
1ef70 6f 75 6e 74 65 72 20 74 6f 20 62 65 0a 20 20 20 ounter to be.
1ef80 20 2a 2a 20 75 6e 63 68 61 6e 67 65 64 2e 0a 20 ** unchanged..
1ef90 20 20 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 */. case S
1efa0 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 44 42 5f 55 QLITE_FCNTL_DB_U
1efb0 4e 43 48 41 4e 47 45 44 3a 20 7b 0a 20 20 20 20 NCHANGED: {.
1efc0 20 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 ((unixFile*)id
1efd0 29 2d 3e 64 62 55 70 64 61 74 65 20 3d 20 30 3b )->dbUpdate = 0;
1efe0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
1eff0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 23 LITE_OK;. }.#
1f000 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
1f010 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f _ENABLE_LOCKING_
1f020 53 54 59 4c 45 20 26 26 20 64 65 66 69 6e 65 64 STYLE && defined
1f030 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 20 20 20 20 (__APPLE__).
1f040 63 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 case SQLITE_FCNT
1f050 4c 5f 53 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46 L_SET_LOCKPROXYF
1f060 49 4c 45 3a 0a 20 20 20 20 63 61 73 65 20 53 51 ILE:. case SQ
1f070 4c 49 54 45 5f 46 43 4e 54 4c 5f 47 45 54 5f 4c LITE_FCNTL_GET_L
1f080 4f 43 4b 50 52 4f 58 59 46 49 4c 45 3a 20 7b 0a OCKPROXYFILE: {.
1f090 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 72 6f return pro
1f0a0 78 79 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 69 64 xyFileControl(id
1f0b0 2c 6f 70 2c 70 41 72 67 29 3b 0a 20 20 20 20 7d ,op,pArg);. }
1f0c0 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
1f0d0 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 E_ENABLE_LOCKING
1f0e0 5f 53 54 59 4c 45 20 26 26 20 64 65 66 69 6e 65 _STYLE && define
1f0f0 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 2a 2f 0a d(__APPLE__) */.
1f100 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
1f110 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 7d 0a ITE_NOTFOUND;.}.
1f120 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
1f130 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 69 6e e sector size in
1f140 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 75 6e bytes of the un
1f150 64 65 72 6c 79 69 6e 67 20 62 6c 6f 63 6b 20 64 derlying block d
1f160 65 76 69 63 65 20 66 6f 72 0a 2a 2a 20 74 68 65 evice for.** the
1f170 20 73 70 65 63 69 66 69 65 64 20 66 69 6c 65 2e specified file.
1f180 20 54 68 69 73 20 69 73 20 61 6c 6d 6f 73 74 20 This is almost
1f190 61 6c 77 61 79 73 20 35 31 32 20 62 79 74 65 73 always 512 bytes
1f1a0 2c 20 62 75 74 20 6d 61 79 20 62 65 0a 2a 2a 20 , but may be.**
1f1b0 6c 61 72 67 65 72 20 66 6f 72 20 73 6f 6d 65 20 larger for some
1f1c0 64 65 76 69 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 53 devices..**.** S
1f1d0 51 4c 69 74 65 20 63 6f 64 65 20 61 73 73 75 6d QLite code assum
1f1e0 65 73 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e es this function
1f1f0 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 20 49 74 cannot fail. It
1f200 20 61 6c 73 6f 20 61 73 73 75 6d 65 73 20 74 68 also assumes th
1f210 61 74 0a 2a 2a 20 69 66 20 74 77 6f 20 66 69 6c at.** if two fil
1f220 65 73 20 61 72 65 20 63 72 65 61 74 65 64 20 69 es are created i
1f230 6e 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65 2d n the same file-
1f240 73 79 73 74 65 6d 20 64 69 72 65 63 74 6f 72 79 system directory
1f250 20 28 69 2e 65 2e 0a 2a 2a 20 61 20 64 61 74 61 (i.e..** a data
1f260 62 61 73 65 20 61 6e 64 20 69 74 73 20 6a 6f 75 base and its jou
1f270 72 6e 61 6c 20 66 69 6c 65 29 20 74 68 61 74 20 rnal file) that
1f280 74 68 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 the sector size
1f290 77 69 6c 6c 20 62 65 20 74 68 65 0a 2a 2a 20 73 will be the.** s
1f2a0 61 6d 65 20 66 6f 72 20 62 6f 74 68 2e 0a 2a 2f ame for both..*/
1f2b0 0a 23 69 66 6e 64 65 66 20 5f 5f 51 4e 58 4e 54 .#ifndef __QNXNT
1f2c0 4f 5f 5f 20 0a 73 74 61 74 69 63 20 69 6e 74 20 O__ .static int
1f2d0 75 6e 69 78 53 65 63 74 6f 72 53 69 7a 65 28 73 unixSectorSize(s
1f2e0 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 4e 6f 74 qlite3_file *Not
1f2f0 55 73 65 64 29 7b 0a 20 20 55 4e 55 53 45 44 5f Used){. UNUSED_
1f300 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 PARAMETER(NotUse
1f310 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c d);. return SQL
1f320 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 45 43 54 ITE_DEFAULT_SECT
1f330 4f 52 5f 53 49 5a 45 3b 0a 7d 0a 23 65 6e 64 69 OR_SIZE;.}.#endi
1f340 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
1f350 6c 6f 77 69 6e 67 20 76 65 72 73 69 6f 6e 20 6f lowing version o
1f360 66 20 75 6e 69 78 53 65 63 74 6f 72 53 69 7a 65 f unixSectorSize
1f370 28 29 20 69 73 20 6f 70 74 69 6d 69 7a 65 64 20 () is optimized
1f380 66 6f 72 20 51 4e 58 2e 0a 2a 2f 0a 23 69 66 64 for QNX..*/.#ifd
1f390 65 66 20 5f 5f 51 4e 58 4e 54 4f 5f 5f 0a 23 69 ef __QNXNTO__.#i
1f3a0 6e 63 6c 75 64 65 20 3c 73 79 73 2f 64 63 6d 64 nclude <sys/dcmd
1f3b0 5f 62 6c 6b 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 _blk.h>.#include
1f3c0 20 3c 73 79 73 2f 73 74 61 74 76 66 73 2e 68 3e <sys/statvfs.h>
1f3d0 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 .static int unix
1f3e0 53 65 63 74 6f 72 53 69 7a 65 28 73 71 6c 69 74 SectorSize(sqlit
1f3f0 65 33 5f 66 69 6c 65 20 2a 69 64 29 7b 0a 20 20 e3_file *id){.
1f400 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 unixFile *pFile
1f410 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b = (unixFile*)id;
1f420 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 73 65 . if( pFile->se
1f430 63 74 6f 72 53 69 7a 65 20 3d 3d 20 30 20 29 7b ctorSize == 0 ){
1f440 0a 20 20 20 20 73 74 72 75 63 74 20 73 74 61 74 . struct stat
1f450 76 66 73 20 66 73 49 6e 66 6f 3b 0a 20 20 20 20 vfs fsInfo;.
1f460 20 20 20 0a 20 20 20 20 2f 2a 20 53 65 74 20 64 . /* Set d
1f470 65 66 61 75 6c 74 73 20 66 6f 72 20 6e 6f 6e 2d efaults for non-
1f480 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65 73 79 supported filesy
1f490 73 74 65 6d 73 20 2a 2f 0a 20 20 20 20 70 46 69 stems */. pFi
1f4a0 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d le->sectorSize =
1f4b0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
1f4c0 53 45 43 54 4f 52 5f 53 49 5a 45 3b 0a 20 20 20 SECTOR_SIZE;.
1f4d0 20 70 46 69 6c 65 2d 3e 64 65 76 69 63 65 43 68 pFile->deviceCh
1f4e0 61 72 61 63 74 65 72 69 73 74 69 63 73 20 3d 20 aracteristics =
1f4f0 30 3b 0a 20 20 20 20 69 66 28 20 66 73 74 61 74 0;. if( fstat
1f500 76 66 73 28 70 46 69 6c 65 2d 3e 68 2c 20 26 66 vfs(pFile->h, &f
1f510 73 49 6e 66 6f 29 20 3d 3d 20 2d 31 20 29 20 7b sInfo) == -1 ) {
1f520 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 46 . return pF
1f530 69 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3b ile->sectorSize;
1f540 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 . }.. if(
1f550 21 73 74 72 63 6d 70 28 66 73 49 6e 66 6f 2e 66 !strcmp(fsInfo.f
1f560 5f 62 61 73 65 74 79 70 65 2c 20 22 74 6d 70 22 _basetype, "tmp"
1f570 29 20 29 20 7b 0a 20 20 20 20 20 20 70 46 69 6c ) ) {. pFil
1f580 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 e->sectorSize =
1f590 66 73 49 6e 66 6f 2e 66 5f 62 73 69 7a 65 3b 0a fsInfo.f_bsize;.
1f5a0 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 64 65 76 pFile->dev
1f5b0 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 iceCharacteristi
1f5c0 63 73 20 3d 0a 20 20 20 20 20 20 20 20 53 51 4c cs =. SQL
1f5d0 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 ITE_IOCAP_ATOMIC
1f5e0 34 4b 20 7c 20 20 20 20 20 20 20 2f 2a 20 41 6c 4K | /* Al
1f5f0 6c 20 72 61 6d 20 66 69 6c 65 73 79 73 74 65 6d l ram filesystem
1f600 20 77 72 69 74 65 73 20 61 72 65 20 61 74 6f 6d writes are atom
1f610 69 63 20 2a 2f 0a 20 20 20 20 20 20 20 20 53 51 ic */. SQ
1f620 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f LITE_IOCAP_SAFE_
1f630 41 50 50 45 4e 44 20 7c 20 20 20 20 2f 2a 20 67 APPEND | /* g
1f640 72 6f 77 69 6e 67 20 74 68 65 20 66 69 6c 65 20 rowing the file
1f650 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20 75 does not occur u
1f660 6e 74 69 6c 0a 20 20 20 20 20 20 20 20 20 20 20 ntil.
1f670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f680 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 ** th
1f690 65 20 77 72 69 74 65 20 73 75 63 63 65 65 64 73 e write succeeds
1f6a0 20 2a 2f 0a 20 20 20 20 20 20 20 20 53 51 4c 49 */. SQLI
1f6b0 54 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e 54 TE_IOCAP_SEQUENT
1f6c0 49 41 4c 20 7c 20 20 20 20 20 2f 2a 20 54 68 65 IAL | /* The
1f6d0 20 72 61 6d 20 66 69 6c 65 73 79 73 74 65 6d 20 ram filesystem
1f6e0 68 61 73 20 6e 6f 20 77 72 69 74 65 20 62 65 68 has no write beh
1f6f0 69 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 ind.
1f700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f710 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 6f 20 ** so
1f720 69 74 20 69 73 20 6f 72 64 65 72 65 64 20 2a 2f it is ordered */
1f730 0a 20 20 20 20 20 20 20 20 30 3b 0a 20 20 20 20 . 0;.
1f740 7d 65 6c 73 65 20 69 66 28 20 73 74 72 73 74 72 }else if( strstr
1f750 28 66 73 49 6e 66 6f 2e 66 5f 62 61 73 65 74 79 (fsInfo.f_basety
1f760 70 65 2c 20 22 65 74 66 73 22 29 20 29 7b 0a 20 pe, "etfs") ){.
1f770 20 20 20 20 20 70 46 69 6c 65 2d 3e 73 65 63 74 pFile->sect
1f780 6f 72 53 69 7a 65 20 3d 20 66 73 49 6e 66 6f 2e orSize = fsInfo.
1f790 66 5f 62 73 69 7a 65 3b 0a 20 20 20 20 20 20 70 f_bsize;. p
1f7a0 46 69 6c 65 2d 3e 64 65 76 69 63 65 43 68 61 72 File->deviceChar
1f7b0 61 63 74 65 72 69 73 74 69 63 73 20 3d 0a 20 20 acteristics =.
1f7c0 20 20 20 20 20 20 2f 2a 20 65 74 66 73 20 63 6c /* etfs cl
1f7d0 75 73 74 65 72 20 73 69 7a 65 20 77 72 69 74 65 uster size write
1f7e0 73 20 61 72 65 20 61 74 6f 6d 69 63 20 2a 2f 0a s are atomic */.
1f7f0 20 20 20 20 20 20 20 20 28 70 46 69 6c 65 2d 3e (pFile->
1f800 73 65 63 74 6f 72 53 69 7a 65 20 2f 20 35 31 32 sectorSize / 512
1f810 20 2a 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f * SQLITE_IOCAP_
1f820 41 54 4f 4d 49 43 35 31 32 29 20 7c 0a 20 20 20 ATOMIC512) |.
1f830 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4f 43 41 SQLITE_IOCA
1f840 50 5f 53 41 46 45 5f 41 50 50 45 4e 44 20 7c 20 P_SAFE_APPEND |
1f850 20 20 20 2f 2a 20 67 72 6f 77 69 6e 67 20 74 68 /* growing th
1f860 65 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 e file does not
1f870 6f 63 63 75 72 20 75 6e 74 69 6c 0a 20 20 20 20 occur until.
1f880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f8a0 20 20 2a 2a 20 74 68 65 20 77 72 69 74 65 20 73 ** the write s
1f8b0 75 63 63 65 65 64 73 20 2a 2f 0a 20 20 20 20 20 ucceeds */.
1f8c0 20 20 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f SQLITE_IOCAP_
1f8d0 53 45 51 55 45 4e 54 49 41 4c 20 7c 20 20 20 20 SEQUENTIAL |
1f8e0 20 2f 2a 20 54 68 65 20 72 61 6d 20 66 69 6c 65 /* The ram file
1f8f0 73 79 73 74 65 6d 20 68 61 73 20 6e 6f 20 77 72 system has no wr
1f900 69 74 65 20 62 65 68 69 6e 64 0a 20 20 20 20 20 ite behind.
1f910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f930 20 2a 2a 20 73 6f 20 69 74 20 69 73 20 6f 72 64 ** so it is ord
1f940 65 72 65 64 20 2a 2f 0a 20 20 20 20 20 20 20 20 ered */.
1f950 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 0;. }else if(
1f960 20 21 73 74 72 63 6d 70 28 66 73 49 6e 66 6f 2e !strcmp(fsInfo.
1f970 66 5f 62 61 73 65 74 79 70 65 2c 20 22 71 6e 78 f_basetype, "qnx
1f980 36 22 29 20 29 7b 0a 20 20 20 20 20 20 70 46 69 6") ){. pFi
1f990 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d le->sectorSize =
1f9a0 20 66 73 49 6e 66 6f 2e 66 5f 62 73 69 7a 65 3b fsInfo.f_bsize;
1f9b0 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 64 65 . pFile->de
1f9c0 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
1f9d0 69 63 73 20 3d 0a 20 20 20 20 20 20 20 20 53 51 ics =. SQ
1f9e0 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 LITE_IOCAP_ATOMI
1f9f0 43 20 7c 20 20 20 20 20 20 20 20 20 2f 2a 20 41 C | /* A
1fa00 6c 6c 20 66 69 6c 65 73 79 73 74 65 6d 20 77 72 ll filesystem wr
1fa10 69 74 65 73 20 61 72 65 20 61 74 6f 6d 69 63 20 ites are atomic
1fa20 2a 2f 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54 */. SQLIT
1fa30 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 E_IOCAP_SAFE_APP
1fa40 45 4e 44 20 7c 20 20 20 20 2f 2a 20 67 72 6f 77 END | /* grow
1fa50 69 6e 67 20 74 68 65 20 66 69 6c 65 20 64 6f 65 ing the file doe
1fa60 73 20 6e 6f 74 20 6f 63 63 75 72 20 75 6e 74 69 s not occur unti
1fa70 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l.
1fa80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fa90 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 77 ** the w
1faa0 72 69 74 65 20 73 75 63 63 65 65 64 73 20 2a 2f rite succeeds */
1fab0 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f . SQLITE_
1fac0 49 4f 43 41 50 5f 53 45 51 55 45 4e 54 49 41 4c IOCAP_SEQUENTIAL
1fad0 20 7c 20 20 20 20 20 2f 2a 20 54 68 65 20 72 61 | /* The ra
1fae0 6d 20 66 69 6c 65 73 79 73 74 65 6d 20 68 61 73 m filesystem has
1faf0 20 6e 6f 20 77 72 69 74 65 20 62 65 68 69 6e 64 no write behind
1fb00 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1fb10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fb20 20 20 20 20 20 20 20 2a 2a 20 73 6f 20 69 74 20 ** so it
1fb30 69 73 20 6f 72 64 65 72 65 64 20 2a 2f 0a 20 20 is ordered */.
1fb40 20 20 20 20 20 20 30 3b 0a 20 20 20 20 7d 65 6c 0;. }el
1fb50 73 65 20 69 66 28 20 21 73 74 72 63 6d 70 28 66 se if( !strcmp(f
1fb60 73 49 6e 66 6f 2e 66 5f 62 61 73 65 74 79 70 65 sInfo.f_basetype
1fb70 2c 20 22 71 6e 78 34 22 29 20 29 7b 0a 20 20 20 , "qnx4") ){.
1fb80 20 20 20 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72 pFile->sector
1fb90 53 69 7a 65 20 3d 20 66 73 49 6e 66 6f 2e 66 5f Size = fsInfo.f_
1fba0 62 73 69 7a 65 3b 0a 20 20 20 20 20 20 70 46 69 bsize;. pFi
1fbb0 6c 65 2d 3e 64 65 76 69 63 65 43 68 61 72 61 63 le->deviceCharac
1fbc0 74 65 72 69 73 74 69 63 73 20 3d 0a 20 20 20 20 teristics =.
1fbd0 20 20 20 20 2f 2a 20 66 75 6c 6c 20 62 69 74 73 /* full bits
1fbe0 65 74 20 6f 66 20 61 74 6f 6d 69 63 73 20 66 72 et of atomics fr
1fbf0 6f 6d 20 6d 61 78 20 73 65 63 74 6f 72 20 73 69 om max sector si
1fc00 7a 65 20 61 6e 64 20 73 6d 61 6c 6c 65 72 20 2a ze and smaller *
1fc10 2f 0a 20 20 20 20 20 20 20 20 28 28 70 46 69 6c /. ((pFil
1fc20 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 2f 20 e->sectorSize /
1fc30 35 31 32 20 2a 20 53 51 4c 49 54 45 5f 49 4f 43 512 * SQLITE_IOC
1fc40 41 50 5f 41 54 4f 4d 49 43 35 31 32 29 20 3c 3c AP_ATOMIC512) <<
1fc50 20 31 29 20 2d 20 32 20 7c 0a 20 20 20 20 20 20 1) - 2 |.
1fc60 20 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 SQLITE_IOCAP_S
1fc70 45 51 55 45 4e 54 49 41 4c 20 7c 20 20 20 20 20 EQUENTIAL |
1fc80 2f 2a 20 54 68 65 20 72 61 6d 20 66 69 6c 65 73 /* The ram files
1fc90 79 73 74 65 6d 20 68 61 73 20 6e 6f 20 77 72 69 ystem has no wri
1fca0 74 65 20 62 65 68 69 6e 64 0a 20 20 20 20 20 20 te behind.
1fcb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fcc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fcd0 2a 2a 20 73 6f 20 69 74 20 69 73 20 6f 72 64 65 ** so it is orde
1fce0 72 65 64 20 2a 2f 0a 20 20 20 20 20 20 20 20 30 red */. 0
1fcf0 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
1fd00 73 74 72 73 74 72 28 66 73 49 6e 66 6f 2e 66 5f strstr(fsInfo.f_
1fd10 62 61 73 65 74 79 70 65 2c 20 22 64 6f 73 22 29 basetype, "dos")
1fd20 20 29 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d ){. pFile-
1fd30 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 66 73 >sectorSize = fs
1fd40 49 6e 66 6f 2e 66 5f 62 73 69 7a 65 3b 0a 20 20 Info.f_bsize;.
1fd50 20 20 20 20 70 46 69 6c 65 2d 3e 64 65 76 69 63 pFile->devic
1fd60 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
1fd70 20 3d 0a 20 20 20 20 20 20 20 20 2f 2a 20 66 75 =. /* fu
1fd80 6c 6c 20 62 69 74 73 65 74 20 6f 66 20 61 74 6f ll bitset of ato
1fd90 6d 69 63 73 20 66 72 6f 6d 20 6d 61 78 20 73 65 mics from max se
1fda0 63 74 6f 72 20 73 69 7a 65 20 61 6e 64 20 73 6d ctor size and sm
1fdb0 61 6c 6c 65 72 20 2a 2f 0a 20 20 20 20 20 20 20 aller */.
1fdc0 20 28 28 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72 ((pFile->sector
1fdd0 53 69 7a 65 20 2f 20 35 31 32 20 2a 20 53 51 4c Size / 512 * SQL
1fde0 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 ITE_IOCAP_ATOMIC
1fdf0 35 31 32 29 20 3c 3c 20 31 29 20 2d 20 32 20 7c 512) << 1) - 2 |
1fe00 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f . SQLITE_
1fe10 49 4f 43 41 50 5f 53 45 51 55 45 4e 54 49 41 4c IOCAP_SEQUENTIAL
1fe20 20 7c 20 20 20 20 20 2f 2a 20 54 68 65 20 72 61 | /* The ra
1fe30 6d 20 66 69 6c 65 73 79 73 74 65 6d 20 68 61 73 m filesystem has
1fe40 20 6e 6f 20 77 72 69 74 65 20 62 65 68 69 6e 64 no write behind
1fe50 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1fe60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fe70 20 20 20 20 20 20 20 2a 2a 20 73 6f 20 69 74 20 ** so it
1fe80 69 73 20 6f 72 64 65 72 65 64 20 2a 2f 0a 20 20 is ordered */.
1fe90 20 20 20 20 20 20 30 3b 0a 20 20 20 20 7d 65 6c 0;. }el
1fea0 73 65 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d se{. pFile-
1feb0 3e 64 65 76 69 63 65 43 68 61 72 61 63 74 65 72 >deviceCharacter
1fec0 69 73 74 69 63 73 20 3d 0a 20 20 20 20 20 20 20 istics =.
1fed0 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 SQLITE_IOCAP_AT
1fee0 4f 4d 49 43 35 31 32 20 7c 20 20 20 20 20 20 2f OMIC512 | /
1fef0 2a 20 62 6c 6f 63 6b 73 20 61 72 65 20 61 74 6f * blocks are ato
1ff00 6d 69 63 20 2a 2f 0a 20 20 20 20 20 20 20 20 53 mic */. S
1ff10 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 QLITE_IOCAP_SAFE
1ff20 5f 41 50 50 45 4e 44 20 7c 20 20 20 20 2f 2a 20 _APPEND | /*
1ff30 67 72 6f 77 69 6e 67 20 74 68 65 20 66 69 6c 65 growing the file
1ff40 20 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20 does not occur
1ff50 75 6e 74 69 6c 0a 20 20 20 20 20 20 20 20 20 20 until.
1ff60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ff70 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 ** t
1ff80 68 65 20 77 72 69 74 65 20 73 75 63 63 65 65 64 he write succeed
1ff90 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 30 3b 0a s */. 0;.
1ffa0 20 20 20 20 7d 0a 20 20 7d 0a 20 20 2f 2a 20 4c }. }. /* L
1ffb0 61 73 74 20 63 68 61 6e 63 65 20 76 65 72 69 66 ast chance verif
1ffc0 69 63 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 ication. If the
1ffd0 20 73 65 63 74 6f 72 20 73 69 7a 65 20 69 73 6e sector size isn
1ffe0 27 74 20 61 20 6d 75 6c 74 69 70 6c 65 20 6f 66 't a multiple of
1fff0 20 35 31 32 0a 20 20 2a 2a 20 74 68 65 6e 20 69 512. ** then i
20000 74 20 69 73 6e 27 74 20 76 61 6c 69 64 2e 2a 2f t isn't valid.*/
20010 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 73 65 . if( pFile->se
20020 63 74 6f 72 53 69 7a 65 20 25 20 35 31 32 20 21 ctorSize % 512 !
20030 3d 20 30 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 = 0 ){. pFile
20040 2d 3e 64 65 76 69 63 65 43 68 61 72 61 63 74 65 ->deviceCharacte
20050 72 69 73 74 69 63 73 20 3d 20 30 3b 0a 20 20 20 ristics = 0;.
20060 20 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72 53 69 pFile->sectorSi
20070 7a 65 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 ze = SQLITE_DEFA
20080 55 4c 54 5f 53 45 43 54 4f 52 5f 53 49 5a 45 3b ULT_SECTOR_SIZE;
20090 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 46 . }. return pF
200a0 69 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3b ile->sectorSize;
200b0 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 5f 51 .}.#endif /* __Q
200c0 4e 58 4e 54 4f 5f 5f 20 2a 2f 0a 0a 2f 2a 0a 2a NXNTO__ */../*.*
200d0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 64 65 76 * Return the dev
200e0 69 63 65 20 63 68 61 72 61 63 74 65 72 69 73 74 ice characterist
200f0 69 63 73 20 66 6f 72 20 74 68 65 20 66 69 6c 65 ics for the file
20100 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 56 46 53 ..**.** This VFS
20110 20 69 73 20 73 65 74 20 75 70 20 74 6f 20 72 65 is set up to re
20120 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 43 41 turn SQLITE_IOCA
20130 50 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 P_POWERSAFE_OVER
20140 57 52 49 54 45 20 62 79 20 64 65 66 61 75 6c 74 WRITE by default
20150 2e 0a 2a 2a 20 48 6f 77 65 76 65 72 2c 20 74 68 ..** However, th
20160 61 74 20 63 68 6f 69 63 65 20 69 73 20 63 6f 6e at choice is con
20170 74 72 6f 76 65 72 73 69 61 6c 20 73 69 6e 63 65 troversial since
20180 20 74 65 63 68 6e 69 63 61 6c 6c 79 20 74 68 65 technically the
20190 20 75 6e 64 65 72 6c 79 69 6e 67 0a 2a 2a 20 66 underlying.** f
201a0 69 6c 65 20 73 79 73 74 65 6d 20 64 6f 65 73 20 ile system does
201b0 6e 6f 74 20 61 6c 77 61 79 73 20 70 72 6f 76 69 not always provi
201c0 64 65 20 70 6f 77 65 72 73 61 66 65 20 6f 76 65 de powersafe ove
201d0 72 77 72 69 74 65 73 2e 20 20 28 49 6e 20 6f 74 rwrites. (In ot
201e0 68 65 72 0a 2a 2a 20 77 6f 72 64 73 2c 20 61 66 her.** words, af
201f0 74 65 72 20 61 20 70 6f 77 65 72 2d 6c 6f 73 73 ter a power-loss
20200 20 65 76 65 6e 74 2c 20 70 61 72 74 73 20 6f 66 event, parts of
20210 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 77 the file that w
20220 65 72 65 20 6e 65 76 65 72 0a 2a 2a 20 77 72 69 ere never.** wri
20230 74 74 65 6e 20 6d 69 67 68 74 20 65 6e 64 20 75 tten might end u
20240 70 20 62 65 69 6e 67 20 61 6c 74 65 72 65 64 2e p being altered.
20250 29 20 20 48 6f 77 65 76 65 72 2c 20 6e 6f 6e 2d ) However, non-
20260 50 53 4f 57 20 62 65 68 61 76 69 6f 72 20 69 73 PSOW behavior is
20270 20 76 65 72 79 2c 0a 2a 2a 20 76 65 72 79 20 72 very,.** very r
20280 61 72 65 2e 20 20 41 6e 64 20 61 73 73 65 72 74 are. And assert
20290 69 6e 67 20 50 53 4f 57 20 6d 61 6b 65 73 20 61 ing PSOW makes a
202a0 20 6c 61 72 67 65 20 72 65 64 75 63 74 69 6f 6e large reduction
202b0 20 69 6e 20 74 68 65 20 61 6d 6f 75 6e 74 0a 2a in the amount.*
202c0 2a 20 6f 66 20 72 65 71 75 69 72 65 64 20 49 2f * of required I/
202d0 4f 20 66 6f 72 20 6a 6f 75 72 6e 61 6c 69 6e 67 O for journaling
202e0 2c 20 73 69 6e 63 65 20 61 20 6c 6f 74 20 6f 66 , since a lot of
202f0 20 70 61 64 64 69 6e 67 20 69 73 20 65 6c 69 6d padding is elim
20300 69 6e 61 74 65 64 2e 0a 2a 2a 20 20 48 65 6e 63 inated..** Henc
20310 65 2c 20 77 68 69 6c 65 20 50 4f 57 45 52 53 41 e, while POWERSA
20320 46 45 5f 4f 56 45 52 57 52 49 54 45 20 69 73 20 FE_OVERWRITE is
20330 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2c 20 74 on by default, t
20340 68 65 72 65 20 69 73 20 61 20 66 69 6c 65 2d 63 here is a file-c
20350 6f 6e 74 72 6f 6c 0a 2a 2a 20 61 76 61 69 6c 61 ontrol.** availa
20360 62 6c 65 20 74 6f 20 74 75 72 6e 20 69 74 20 6f ble to turn it o
20370 66 66 20 61 6e 64 20 55 52 49 20 71 75 65 72 79 ff and URI query
20380 20 70 61 72 61 6d 65 74 65 72 20 61 76 61 69 6c parameter avail
20390 61 62 6c 65 20 74 6f 20 74 75 72 6e 20 69 74 20 able to turn it
203a0 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 off..*/.static i
203b0 6e 74 20 75 6e 69 78 44 65 76 69 63 65 43 68 61 nt unixDeviceCha
203c0 72 61 63 74 65 72 69 73 74 69 63 73 28 73 71 6c racteristics(sql
203d0 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 7b 0a ite3_file *id){.
203e0 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 20 3d 20 unixFile *p =
203f0 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 (unixFile*)id;.
20400 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a 23 69 66 int rc = 0;.#if
20410 64 65 66 20 5f 5f 51 4e 58 4e 54 4f 5f 5f 0a 20 def __QNXNTO__.
20420 20 69 66 28 20 70 2d 3e 73 65 63 74 6f 72 53 69 if( p->sectorSi
20430 7a 65 3d 3d 30 20 29 20 75 6e 69 78 53 65 63 74 ze==0 ) unixSect
20440 6f 72 53 69 7a 65 28 69 64 29 3b 0a 20 20 72 63 orSize(id);. rc
20450 20 3d 20 70 2d 3e 64 65 76 69 63 65 43 68 61 72 = p->deviceChar
20460 61 63 74 65 72 69 73 74 69 63 73 3b 0a 23 65 6e acteristics;.#en
20470 64 69 66 0a 20 20 69 66 28 20 70 2d 3e 63 74 72 dif. if( p->ctr
20480 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 4c lFlags & UNIXFIL
20490 45 5f 50 53 4f 57 20 29 7b 0a 20 20 20 20 72 63 E_PSOW ){. rc
204a0 20 7c 3d 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 |= SQLITE_IOCAP
204b0 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 _POWERSAFE_OVERW
204c0 52 49 54 45 3b 0a 20 20 7d 0a 20 20 72 65 74 75 RITE;. }. retu
204d0 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 20 21 64 rn rc;.}..#if !d
204e0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
204f0 49 54 5f 57 41 4c 29 20 7c 7c 20 53 51 4c 49 54 IT_WAL) || SQLIT
20500 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e E_MAX_MMAP_SIZE>
20510 30 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 0../*.** Return
20520 74 68 65 20 73 79 73 74 65 6d 20 70 61 67 65 20 the system page
20530 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 size..**.** This
20540 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 function should
20550 20 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 64 not be called d
20560 69 72 65 63 74 6c 79 20 62 79 20 6f 74 68 65 72 irectly by other
20570 20 63 6f 64 65 20 69 6e 20 74 68 69 73 20 66 69 code in this fi
20580 6c 65 2e 20 0a 2a 2a 20 49 6e 73 74 65 61 64 2c le. .** Instead,
20590 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 63 61 it should be ca
205a0 6c 6c 65 64 20 76 69 61 20 6d 61 63 72 6f 20 6f lled via macro o
205b0 73 47 65 74 70 61 67 65 73 69 7a 65 28 29 2e 0a sGetpagesize()..
205c0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
205d0 69 78 47 65 74 70 61 67 65 73 69 7a 65 28 76 6f ixGetpagesize(vo
205e0 69 64 29 7b 0a 23 69 66 20 4f 53 5f 56 58 57 4f id){.#if OS_VXWO
205f0 52 4b 53 0a 20 20 72 65 74 75 72 6e 20 31 30 32 RKS. return 102
20600 34 3b 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 4;.#elif defined
20610 28 5f 42 53 44 5f 53 4f 55 52 43 45 29 0a 20 20 (_BSD_SOURCE).
20620 72 65 74 75 72 6e 20 67 65 74 70 61 67 65 73 69 return getpagesi
20630 7a 65 28 29 3b 0a 23 65 6c 73 65 0a 20 20 72 65 ze();.#else. re
20640 74 75 72 6e 20 28 69 6e 74 29 73 79 73 63 6f 6e turn (int)syscon
20650 66 28 5f 53 43 5f 50 41 47 45 53 49 5a 45 29 3b f(_SC_PAGESIZE);
20660 0a 23 65 6e 64 69 66 0a 7d 0a 0a 23 65 6e 64 69 .#endif.}..#endi
20670 66 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 53 51 f /* !defined(SQ
20680 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 20 7c LITE_OMIT_WAL) |
20690 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 | SQLITE_MAX_MMA
206a0 50 5f 53 49 5a 45 3e 30 20 2a 2f 0a 0a 23 69 66 P_SIZE>0 */..#if
206b0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
206c0 5f 57 41 4c 0a 0a 2f 2a 0a 2a 2a 20 4f 62 6a 65 _WAL../*.** Obje
206d0 63 74 20 75 73 65 64 20 74 6f 20 72 65 70 72 65 ct used to repre
206e0 73 65 6e 74 20 61 6e 20 73 68 61 72 65 64 20 6d sent an shared m
206f0 65 6d 6f 72 79 20 62 75 66 66 65 72 2e 20 20 0a emory buffer. .
20700 2a 2a 0a 2a 2a 20 57 68 65 6e 20 6d 75 6c 74 69 **.** When multi
20710 70 6c 65 20 74 68 72 65 61 64 73 20 61 6c 6c 20 ple threads all
20720 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 73 61 reference the sa
20730 6d 65 20 77 61 6c 2d 69 6e 64 65 78 2c 20 65 61 me wal-index, ea
20740 63 68 20 74 68 72 65 61 64 0a 2a 2a 20 68 61 73 ch thread.** has
20750 20 69 74 73 20 6f 77 6e 20 75 6e 69 78 53 68 6d its own unixShm
20760 20 6f 62 6a 65 63 74 2c 20 62 75 74 20 74 68 65 object, but the
20770 79 20 61 6c 6c 20 70 6f 69 6e 74 20 74 6f 20 61 y all point to a
20780 20 73 69 6e 67 6c 65 20 69 6e 73 74 61 6e 63 65 single instance
20790 0a 2a 2a 20 6f 66 20 74 68 69 73 20 75 6e 69 78 .** of this unix
207a0 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 2e 20 ShmNode object.
207b0 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c In other words,
207c0 20 65 61 63 68 20 77 61 6c 2d 69 6e 64 65 78 20 each wal-index
207d0 69 73 20 6f 70 65 6e 65 64 0a 2a 2a 20 6f 6e 6c is opened.** onl
207e0 79 20 6f 6e 63 65 20 70 65 72 20 70 72 6f 63 65 y once per proce
207f0 73 73 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 75 ss..**.** Each u
20800 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 nixShmNode objec
20810 74 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20 74 t is connected t
20820 6f 20 61 20 73 69 6e 67 6c 65 20 75 6e 69 78 49 o a single unixI
20830 6e 6f 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 2e nodeInfo object.
20840 0a 2a 2a 20 57 65 20 63 6f 75 6c 64 20 63 6f 61 .** We could coa
20850 6c 65 73 63 65 20 74 68 69 73 20 6f 62 6a 65 63 lesce this objec
20860 74 20 69 6e 74 6f 20 75 6e 69 78 49 6e 6f 64 65 t into unixInode
20870 49 6e 66 6f 2c 20 62 75 74 20 74 68 61 74 20 77 Info, but that w
20880 6f 75 6c 64 20 6d 65 61 6e 0a 2a 2a 20 65 76 65 ould mean.** eve
20890 72 79 20 6f 70 65 6e 20 66 69 6c 65 20 74 68 61 ry open file tha
208a0 74 20 64 6f 65 73 20 6e 6f 74 20 75 73 65 20 73 t does not use s
208b0 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 28 69 6e hared memory (in
208c0 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 6d 6f other words, mo
208d0 73 74 0a 2a 2a 20 6f 70 65 6e 20 66 69 6c 65 73 st.** open files
208e0 29 20 77 6f 75 6c 64 20 68 61 76 65 20 74 6f 20 ) would have to
208f0 63 61 72 72 79 20 61 72 6f 75 6e 64 20 74 68 69 carry around thi
20900 73 20 65 78 74 72 61 20 69 6e 66 6f 72 6d 61 74 s extra informat
20910 69 6f 6e 2e 20 20 53 6f 0a 2a 2a 20 74 68 65 20 ion. So.** the
20920 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62 unixInodeInfo ob
20930 6a 65 63 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 ject contains a
20940 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 pointer to this
20950 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 unixShmNode obje
20960 63 74 0a 2a 2a 20 61 6e 64 20 74 68 65 20 75 6e ct.** and the un
20970 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 ixShmNode object
20980 20 69 73 20 63 72 65 61 74 65 64 20 6f 6e 6c 79 is created only
20990 20 77 68 65 6e 20 6e 65 65 64 65 64 2e 0a 2a 2a when needed..**
209a0 0a 2a 2a 20 75 6e 69 78 4d 75 74 65 78 48 65 6c .** unixMutexHel
209b0 64 28 29 20 6d 75 73 74 20 62 65 20 74 72 75 65 d() must be true
209c0 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 6f when creating o
209d0 72 20 64 65 73 74 72 6f 79 69 6e 67 0a 2a 2a 20 r destroying.**
209e0 74 68 69 73 20 6f 62 6a 65 63 74 20 6f 72 20 77 this object or w
209f0 68 69 6c 65 20 72 65 61 64 69 6e 67 20 6f 72 20 hile reading or
20a00 77 72 69 74 69 6e 67 20 74 68 65 20 66 6f 6c 6c writing the foll
20a10 6f 77 69 6e 67 20 66 69 65 6c 64 73 3a 0a 2a 2a owing fields:.**
20a20 0a 2a 2a 20 20 20 20 20 20 6e 52 65 66 0a 2a 2a .** nRef.**
20a30 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
20a40 67 20 66 69 65 6c 64 73 20 61 72 65 20 72 65 61 g fields are rea
20a50 64 2d 6f 6e 6c 79 20 61 66 74 65 72 20 74 68 65 d-only after the
20a60 20 6f 62 6a 65 63 74 20 69 73 20 63 72 65 61 74 object is creat
20a70 65 64 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 20 20 20 ed:.** .**
20a80 66 69 64 0a 2a 2a 20 20 20 20 20 20 7a 46 69 6c fid.** zFil
20a90 65 6e 61 6d 65 0a 2a 2a 0a 2a 2a 20 45 69 74 68 ename.**.** Eith
20aa0 65 72 20 75 6e 69 78 53 68 6d 4e 6f 64 65 2e 6d er unixShmNode.m
20ab0 75 74 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c utex must be hel
20ac0 64 20 6f 72 20 75 6e 69 78 53 68 6d 4e 6f 64 65 d or unixShmNode
20ad0 2e 6e 52 65 66 3d 3d 30 20 61 6e 64 0a 2a 2a 20 .nRef==0 and.**
20ae0 75 6e 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 unixMutexHeld()
20af0 69 73 20 74 72 75 65 20 77 68 65 6e 20 72 65 61 is true when rea
20b00 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 20 ding or writing
20b10 61 6e 79 20 6f 74 68 65 72 20 66 69 65 6c 64 0a any other field.
20b20 2a 2a 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 ** in this struc
20b30 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ture..*/.struct
20b40 75 6e 69 78 53 68 6d 4e 6f 64 65 20 7b 0a 20 20 unixShmNode {.
20b50 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 unixInodeInfo *p
20b60 49 6e 6f 64 65 3b 20 20 20 20 20 2f 2a 20 75 6e Inode; /* un
20b70 69 78 49 6e 6f 64 65 49 6e 66 6f 20 74 68 61 74 ixInodeInfo that
20b80 20 6f 77 6e 73 20 74 68 69 73 20 53 48 4d 20 6e owns this SHM n
20b90 6f 64 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ode */. sqlite3
20ba0 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 20 _mutex *mutex;
20bb0 20 20 20 20 2f 2a 20 4d 75 74 65 78 20 74 6f 20 /* Mutex to
20bc0 61 63 63 65 73 73 20 74 68 69 73 20 6f 62 6a 65 access this obje
20bd0 63 74 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46 ct */. char *zF
20be0 69 6c 65 6e 61 6d 65 3b 20 20 20 20 20 20 20 20 ilename;
20bf0 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
20c00 65 20 6d 6d 61 70 70 65 64 20 66 69 6c 65 20 2a e mmapped file *
20c10 2f 0a 20 20 69 6e 74 20 68 3b 20 20 20 20 20 20 /. int h;
20c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
20c30 2a 20 4f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 * Open file desc
20c40 72 69 70 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 riptor */. int
20c50 73 7a 52 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 szRegion;
20c60 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
20c70 66 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 f shared-memory
20c80 72 65 67 69 6f 6e 73 20 2a 2f 0a 20 20 75 31 36 regions */. u16
20c90 20 6e 52 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 nRegion;
20ca0 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
20cb0 6f 66 20 61 72 72 61 79 20 61 70 52 65 67 69 6f of array apRegio
20cc0 6e 20 2a 2f 0a 20 20 75 38 20 69 73 52 65 61 64 n */. u8 isRead
20cd0 6f 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 20 20 only;
20ce0 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 61 /* True if rea
20cf0 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 63 68 61 72 d-only */. char
20d00 20 2a 2a 61 70 52 65 67 69 6f 6e 3b 20 20 20 20 **apRegion;
20d10 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 /* Array
20d20 6f 66 20 6d 61 70 70 65 64 20 73 68 61 72 65 64 of mapped shared
20d30 2d 6d 65 6d 6f 72 79 20 72 65 67 69 6f 6e 73 20 -memory regions
20d40 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 */. int nRef;
20d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20d60 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 69 /* Number of uni
20d70 78 53 68 6d 20 6f 62 6a 65 63 74 73 20 70 6f 69 xShm objects poi
20d80 6e 74 69 6e 67 20 74 6f 20 74 68 69 73 20 2a 2f nting to this */
20d90 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 46 69 72 . unixShm *pFir
20da0 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a st; /*
20db0 20 41 6c 6c 20 75 6e 69 78 53 68 6d 20 6f 62 6a All unixShm obj
20dc0 65 63 74 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f ects pointing to
20dd0 20 74 68 69 73 20 2a 2f 0a 23 69 66 64 65 66 20 this */.#ifdef
20de0 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 75 SQLITE_DEBUG. u
20df0 38 20 65 78 63 6c 4d 61 73 6b 3b 20 20 20 20 20 8 exclMask;
20e00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 /* Mas
20e10 6b 20 6f 66 20 65 78 63 6c 75 73 69 76 65 20 6c k of exclusive l
20e20 6f 63 6b 73 20 68 65 6c 64 20 2a 2f 0a 20 20 75 ocks held */. u
20e30 38 20 73 68 61 72 65 64 4d 61 73 6b 3b 20 20 20 8 sharedMask;
20e40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 /* Mas
20e50 6b 20 6f 66 20 73 68 61 72 65 64 20 6c 6f 63 6b k of shared lock
20e60 73 20 68 65 6c 64 20 2a 2f 0a 20 20 75 38 20 6e s held */. u8 n
20e70 65 78 74 53 68 6d 49 64 3b 20 20 20 20 20 20 20 extShmId;
20e80 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 61 /* Next a
20e90 76 61 69 6c 61 62 6c 65 20 75 6e 69 78 53 68 6d vailable unixShm
20ea0 2e 69 64 20 76 61 6c 75 65 20 2a 2f 0a 23 65 6e .id value */.#en
20eb0 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 74 dif.};../*.** St
20ec0 72 75 63 74 75 72 65 20 75 73 65 64 20 69 6e 74 ructure used int
20ed0 65 72 6e 61 6c 6c 79 20 62 79 20 74 68 69 73 20 ernally by this
20ee0 56 46 53 20 74 6f 20 72 65 63 6f 72 64 20 74 68 VFS to record th
20ef0 65 20 73 74 61 74 65 20 6f 66 20 61 6e 0a 2a 2a e state of an.**
20f00 20 6f 70 65 6e 20 73 68 61 72 65 64 20 6d 65 6d open shared mem
20f10 6f 72 79 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a ory connection..
20f20 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 **.** The follow
20f30 69 6e 67 20 66 69 65 6c 64 73 20 61 72 65 20 69 ing fields are i
20f40 6e 69 74 69 61 6c 69 7a 65 64 20 77 68 65 6e 20 nitialized when
20f50 74 68 69 73 20 6f 62 6a 65 63 74 20 69 73 20 63 this object is c
20f60 72 65 61 74 65 64 20 61 6e 64 0a 2a 2a 20 61 72 reated and.** ar
20f70 65 20 72 65 61 64 2d 6f 6e 6c 79 20 74 68 65 72 e read-only ther
20f80 65 61 66 74 65 72 3a 0a 2a 2a 0a 2a 2a 20 20 20 eafter:.**.**
20f90 20 75 6e 69 78 53 68 6d 2e 70 46 69 6c 65 0a 2a unixShm.pFile.*
20fa0 2a 20 20 20 20 75 6e 69 78 53 68 6d 2e 69 64 0a * unixShm.id.
20fb0 2a 2a 0a 2a 2a 20 41 6c 6c 20 6f 74 68 65 72 20 **.** All other
20fc0 66 69 65 6c 64 73 20 61 72 65 20 72 65 61 64 2f fields are read/
20fd0 77 72 69 74 65 2e 20 20 54 68 65 20 75 6e 69 78 write. The unix
20fe0 53 68 6d 2e 70 46 69 6c 65 2d 3e 6d 75 74 65 78 Shm.pFile->mutex
20ff0 20 6d 75 73 74 20 62 65 20 68 65 6c 64 0a 2a 2a must be held.**
21000 20 77 68 69 6c 65 20 61 63 63 65 73 73 69 6e 67 while accessing
21010 20 61 6e 79 20 72 65 61 64 2f 77 72 69 74 65 20 any read/write
21020 66 69 65 6c 64 73 2e 0a 2a 2f 0a 73 74 72 75 63 fields..*/.struc
21030 74 20 75 6e 69 78 53 68 6d 20 7b 0a 20 20 75 6e t unixShm {. un
21040 69 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e ixShmNode *pShmN
21050 6f 64 65 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 ode; /* The
21060 75 6e 64 65 72 6c 79 69 6e 67 20 75 6e 69 78 53 underlying unixS
21070 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 20 2a 2f hmNode object */
21080 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 4e 65 78 . unixShm *pNex
21090 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t; /*
210a0 20 4e 65 78 74 20 75 6e 69 78 53 68 6d 20 77 69 Next unixShm wi
210b0 74 68 20 74 68 65 20 73 61 6d 65 20 75 6e 69 78 th the same unix
210c0 53 68 6d 4e 6f 64 65 20 2a 2f 0a 20 20 75 38 20 ShmNode */. u8
210d0 68 61 73 4d 75 74 65 78 3b 20 20 20 20 20 20 20 hasMutex;
210e0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
210f0 69 66 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 75 if holding the u
21100 6e 69 78 53 68 6d 4e 6f 64 65 20 6d 75 74 65 78 nixShmNode mutex
21110 20 2a 2f 0a 20 20 75 38 20 69 64 3b 20 20 20 20 */. u8 id;
21120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21130 20 2f 2a 20 49 64 20 6f 66 20 74 68 69 73 20 63 /* Id of this c
21140 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 69 6e onnection within
21150 20 69 74 73 20 75 6e 69 78 53 68 6d 4e 6f 64 65 its unixShmNode
21160 20 2a 2f 0a 20 20 75 31 36 20 73 68 61 72 65 64 */. u16 shared
21170 4d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 20 20 Mask;
21180 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 73 68 61 72 /* Mask of shar
21190 65 64 20 6c 6f 63 6b 73 20 68 65 6c 64 20 2a 2f ed locks held */
211a0 0a 20 20 75 31 36 20 65 78 63 6c 4d 61 73 6b 3b . u16 exclMask;
211b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
211c0 20 4d 61 73 6b 20 6f 66 20 65 78 63 6c 75 73 69 Mask of exclusi
211d0 76 65 20 6c 6f 63 6b 73 20 68 65 6c 64 20 2a 2f ve locks held */
211e0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 .};../*.** Const
211f0 61 6e 74 73 20 75 73 65 64 20 66 6f 72 20 6c 6f ants used for lo
21200 63 6b 69 6e 67 0a 2a 2f 0a 23 64 65 66 69 6e 65 cking.*/.#define
21210 20 55 4e 49 58 5f 53 48 4d 5f 42 41 53 45 20 20 UNIX_SHM_BASE
21220 20 28 28 32 32 2b 53 51 4c 49 54 45 5f 53 48 4d ((22+SQLITE_SHM
21230 5f 4e 4c 4f 43 4b 29 2a 34 29 20 20 20 20 20 20 _NLOCK)*4)
21240 20 20 20 2f 2a 20 66 69 72 73 74 20 6c 6f 63 6b /* first lock
21250 20 62 79 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 byte */.#define
21260 20 55 4e 49 58 5f 53 48 4d 5f 44 4d 53 20 20 20 UNIX_SHM_DMS
21270 20 28 55 4e 49 58 5f 53 48 4d 5f 42 41 53 45 2b (UNIX_SHM_BASE+
21280 53 51 4c 49 54 45 5f 53 48 4d 5f 4e 4c 4f 43 4b SQLITE_SHM_NLOCK
21290 29 20 20 2f 2a 20 64 65 61 64 6d 61 6e 20 73 77 ) /* deadman sw
212a0 69 74 63 68 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 itch */../*.** A
212b0 70 70 6c 79 20 70 6f 73 69 78 20 61 64 76 69 73 pply posix advis
212c0 6f 72 79 20 6c 6f 63 6b 73 20 66 6f 72 20 61 6c ory locks for al
212d0 6c 20 62 79 74 65 73 20 66 72 6f 6d 20 6f 66 73 l bytes from ofs
212e0 74 20 74 68 72 6f 75 67 68 20 6f 66 73 74 2b 6e t through ofst+n
212f0 2d 31 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63 6b 73 20 -1..**.** Locks
21300 62 6c 6f 63 6b 20 69 66 20 74 68 65 20 6d 61 73 block if the mas
21310 6b 20 69 73 20 65 78 61 63 74 6c 79 20 55 4e 49 k is exactly UNI
21320 58 5f 53 48 4d 5f 43 20 61 6e 64 20 61 72 65 20 X_SHM_C and are
21330 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 non-blocking.**
21340 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 74 otherwise..*/.st
21350 61 74 69 63 20 69 6e 74 20 75 6e 69 78 53 68 6d atic int unixShm
21360 53 79 73 74 65 6d 4c 6f 63 6b 28 0a 20 20 75 6e SystemLock(. un
21370 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 ixFile *pFile,
21380 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 63 6f 6e /* Open con
21390 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 57 nection to the W
213a0 41 4c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 AL file */. int
213b0 20 6c 6f 63 6b 54 79 70 65 2c 20 20 20 20 20 20 lockType,
213c0 20 20 20 20 2f 2a 20 46 5f 55 4e 4c 43 4b 2c 20 /* F_UNLCK,
213d0 46 5f 52 44 4c 43 4b 2c 20 6f 72 20 46 5f 57 52 F_RDLCK, or F_WR
213e0 4c 43 4b 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 73 LCK */. int ofs
213f0 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
21400 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 /* First byte of
21410 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 72 61 6e the locking ran
21420 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 20 20 20 ge */. int n
21430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
21440 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 * Number of byte
21450 73 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 29 7b 0a s to lock */.){.
21460 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70 unixShmNode *p
21470 53 68 6d 4e 6f 64 65 3b 20 2f 2a 20 41 70 70 6c ShmNode; /* Appl
21480 79 20 6c 6f 63 6b 73 20 74 6f 20 74 68 69 73 20 y locks to this
21490 6f 70 65 6e 20 73 68 61 72 65 64 2d 6d 65 6d 6f open shared-memo
214a0 72 79 20 73 65 67 6d 65 6e 74 20 2a 2f 0a 20 20 ry segment */.
214b0 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 66 3b 20 struct flock f;
214c0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f /* The po
214d0 73 69 78 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 six advisory loc
214e0 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 2a king structure *
214f0 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c /. int rc = SQL
21500 49 54 45 5f 4f 4b 3b 20 20 20 20 2f 2a 20 52 65 ITE_OK; /* Re
21510 73 75 6c 74 20 63 6f 64 65 20 66 6f 72 6d 20 66 sult code form f
21520 63 6e 74 6c 28 29 20 2a 2f 0a 0a 20 20 2f 2a 20 cntl() */.. /*
21530 41 63 63 65 73 73 20 74 6f 20 74 68 65 20 75 6e Access to the un
21540 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 ixShmNode object
21550 20 69 73 20 73 65 72 69 61 6c 69 7a 65 64 20 62 is serialized b
21560 79 20 74 68 65 20 63 61 6c 6c 65 72 20 2a 2f 0a y the caller */.
21570 20 20 70 53 68 6d 4e 6f 64 65 20 3d 20 70 46 69 pShmNode = pFi
21580 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 6d le->pInode->pShm
21590 4e 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 28 20 Node;. assert(
215a0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
215b0 6c 64 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 ld(pShmNode->mut
215c0 65 78 29 20 7c 7c 20 70 53 68 6d 4e 6f 64 65 2d ex) || pShmNode-
215d0 3e 6e 52 65 66 3d 3d 30 20 29 3b 0a 0a 20 20 2f >nRef==0 );.. /
215e0 2a 20 53 68 61 72 65 64 20 6c 6f 63 6b 73 20 6e * Shared locks n
215f0 65 76 65 72 20 73 70 61 6e 20 6d 6f 72 65 20 74 ever span more t
21600 68 61 6e 20 6f 6e 65 20 62 79 74 65 20 2a 2f 0a han one byte */.
21610 20 20 61 73 73 65 72 74 28 20 6e 3d 3d 31 20 7c assert( n==1 |
21620 7c 20 6c 6f 63 6b 54 79 70 65 21 3d 46 5f 52 44 | lockType!=F_RD
21630 4c 43 4b 20 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 63 LCK );.. /* Loc
21640 6b 73 20 61 72 65 20 77 69 74 68 69 6e 20 72 61 ks are within ra
21650 6e 67 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 nge */. assert(
21660 20 6e 3e 3d 31 20 26 26 20 6e 3c 3d 53 51 4c 49 n>=1 && n<=SQLI
21670 54 45 5f 53 48 4d 5f 4e 4c 4f 43 4b 20 29 3b 0a TE_SHM_NLOCK );.
21680 0a 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d . if( pShmNode-
21690 3e 68 3e 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 >h>=0 ){. /*
216a0 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6c Initialize the l
216b0 6f 63 6b 69 6e 67 20 70 61 72 61 6d 65 74 65 72 ocking parameter
216c0 73 20 2a 2f 0a 20 20 20 20 6d 65 6d 73 65 74 28 s */. memset(
216d0 26 66 2c 20 30 2c 20 73 69 7a 65 6f 66 28 66 29 &f, 0, sizeof(f)
216e0 29 3b 0a 20 20 20 20 66 2e 6c 5f 74 79 70 65 20 );. f.l_type
216f0 3d 20 6c 6f 63 6b 54 79 70 65 3b 0a 20 20 20 20 = lockType;.
21700 66 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 f.l_whence = SEE
21710 4b 5f 53 45 54 3b 0a 20 20 20 20 66 2e 6c 5f 73 K_SET;. f.l_s
21720 74 61 72 74 20 3d 20 6f 66 73 74 3b 0a 20 20 20 tart = ofst;.
21730 20 66 2e 6c 5f 6c 65 6e 20 3d 20 6e 3b 0a 0a 20 f.l_len = n;..
21740 20 20 20 72 63 20 3d 20 6f 73 46 63 6e 74 6c 28 rc = osFcntl(
21750 70 53 68 6d 4e 6f 64 65 2d 3e 68 2c 20 46 5f 53 pShmNode->h, F_S
21760 45 54 4c 4b 2c 20 26 66 29 3b 0a 20 20 20 20 72 ETLK, &f);. r
21770 63 20 3d 20 28 72 63 21 3d 28 2d 31 29 29 20 3f c = (rc!=(-1)) ?
21780 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 4c SQLITE_OK : SQL
21790 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a 0a 20 ITE_BUSY;. }..
217a0 20 2f 2a 20 55 70 64 61 74 65 20 74 68 65 20 67 /* Update the g
217b0 6c 6f 62 61 6c 20 6c 6f 63 6b 20 73 74 61 74 65 lobal lock state
217c0 20 61 6e 64 20 64 6f 20 64 65 62 75 67 20 74 72 and do debug tr
217d0 61 63 69 6e 67 20 2a 2f 0a 23 69 66 64 65 66 20 acing */.#ifdef
217e0 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 7b SQLITE_DEBUG. {
217f0 20 75 31 36 20 6d 61 73 6b 3b 0a 20 20 4f 53 54 u16 mask;. OST
21800 52 41 43 45 28 28 22 53 48 4d 2d 4c 4f 43 4b 20 RACE(("SHM-LOCK
21810 22 29 29 3b 0a 20 20 6d 61 73 6b 20 3d 20 6f 66 "));. mask = of
21820 73 74 3e 33 31 20 3f 20 30 78 66 66 66 66 20 3a st>31 ? 0xffff :
21830 20 28 31 3c 3c 28 6f 66 73 74 2b 6e 29 29 20 2d (1<<(ofst+n)) -
21840 20 28 31 3c 3c 6f 66 73 74 29 3b 0a 20 20 69 66 (1<<ofst);. if
21850 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
21860 29 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 54 ){. if( lockT
21870 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a ype==F_UNLCK ){.
21880 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 OSTRACE(("
21890 75 6e 6c 6f 63 6b 20 25 64 20 6f 6b 22 2c 20 6f unlock %d ok", o
218a0 66 73 74 29 29 3b 0a 20 20 20 20 20 20 70 53 68 fst));. pSh
218b0 6d 4e 6f 64 65 2d 3e 65 78 63 6c 4d 61 73 6b 20 mNode->exclMask
218c0 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 20 20 20 20 &= ~mask;.
218d0 70 53 68 6d 4e 6f 64 65 2d 3e 73 68 61 72 65 64 pShmNode->shared
218e0 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b 0a 20 Mask &= ~mask;.
218f0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 }else if( loc
21900 6b 54 79 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 29 kType==F_RDLCK )
21910 7b 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 {. OSTRACE(
21920 28 22 72 65 61 64 2d 6c 6f 63 6b 20 25 64 20 6f ("read-lock %d o
21930 6b 22 2c 20 6f 66 73 74 29 29 3b 0a 20 20 20 20 k", ofst));.
21940 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78 63 6c pShmNode->excl
21950 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b 0a 20 Mask &= ~mask;.
21960 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 pShmNode->s
21970 68 61 72 65 64 4d 61 73 6b 20 7c 3d 20 6d 61 73 haredMask |= mas
21980 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 k;. }else{.
21990 20 20 20 20 61 73 73 65 72 74 28 20 6c 6f 63 6b assert( lock
219a0 54 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20 29 3b Type==F_WRLCK );
219b0 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 28 . OSTRACE((
219c0 22 77 72 69 74 65 2d 6c 6f 63 6b 20 25 64 20 6f "write-lock %d o
219d0 6b 22 2c 20 6f 66 73 74 29 29 3b 0a 20 20 20 20 k", ofst));.
219e0 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78 63 6c pShmNode->excl
219f0 4d 61 73 6b 20 7c 3d 20 6d 61 73 6b 3b 0a 20 20 Mask |= mask;.
21a00 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 68 pShmNode->sh
21a10 61 72 65 64 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 aredMask &= ~mas
21a20 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 k;. }. }else
21a30 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 54 79 {. if( lockTy
21a40 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 pe==F_UNLCK ){.
21a50 20 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 75 OSTRACE(("u
21a60 6e 6c 6f 63 6b 20 25 64 20 66 61 69 6c 65 64 22 nlock %d failed"
21a70 2c 20 6f 66 73 74 29 29 3b 0a 20 20 20 20 7d 65 , ofst));. }e
21a80 6c 73 65 20 69 66 28 20 6c 6f 63 6b 54 79 70 65 lse if( lockType
21a90 3d 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a 20 20 20 ==F_RDLCK ){.
21aa0 20 20 20 4f 53 54 52 41 43 45 28 28 22 72 65 61 OSTRACE(("rea
21ab0 64 2d 6c 6f 63 6b 20 66 61 69 6c 65 64 22 29 29 d-lock failed"))
21ac0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
21ad0 20 20 20 61 73 73 65 72 74 28 20 6c 6f 63 6b 54 assert( lockT
21ae0 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20 29 3b 0a ype==F_WRLCK );.
21af0 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 OSTRACE(("
21b00 77 72 69 74 65 2d 6c 6f 63 6b 20 25 64 20 66 61 write-lock %d fa
21b10 69 6c 65 64 22 2c 20 6f 66 73 74 29 29 3b 0a 20 iled", ofst));.
21b20 20 20 20 7d 0a 20 20 7d 0a 20 20 4f 53 54 52 41 }. }. OSTRA
21b30 43 45 28 28 22 20 2d 20 61 66 74 65 72 77 61 72 CE((" - afterwar
21b40 64 73 20 25 30 33 78 2c 25 30 33 78 5c 6e 22 2c ds %03x,%03x\n",
21b50 0a 20 20 20 20 20 20 20 20 20 20 20 70 53 68 6d . pShm
21b60 4e 6f 64 65 2d 3e 73 68 61 72 65 64 4d 61 73 6b Node->sharedMask
21b70 2c 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78 63 6c , pShmNode->excl
21b80 4d 61 73 6b 29 29 3b 0a 20 20 7d 0a 23 65 6e 64 Mask));. }.#end
21b90 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b if.. return rc;
21ba0 20 20 20 20 20 20 20 20 0a 7d 0a 0a 2f 2a 0a 2a .}../*.*
21bb0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d 69 6e * Return the min
21bc0 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 33 imum number of 3
21bd0 32 4b 42 20 73 68 6d 20 72 65 67 69 6f 6e 73 20 2KB shm regions
21be0 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 6d that should be m
21bf0 61 70 70 65 64 20 61 74 0a 2a 2a 20 61 20 74 69 apped at.** a ti
21c00 6d 65 2c 20 61 73 73 75 6d 69 6e 67 20 74 68 61 me, assuming tha
21c10 74 20 65 61 63 68 20 6d 61 70 70 69 6e 67 20 6d t each mapping m
21c20 75 73 74 20 62 65 20 61 6e 20 69 6e 74 65 67 65 ust be an intege
21c30 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 74 68 r multiple of th
21c40 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 73 79 73 e.** current sys
21c50 74 65 6d 20 70 61 67 65 2d 73 69 7a 65 2e 0a 2a tem page-size..*
21c60 2a 0a 2a 2a 20 55 73 75 61 6c 6c 79 2c 20 74 68 *.** Usually, th
21c70 69 73 20 69 73 20 31 2e 20 54 68 65 20 65 78 63 is is 1. The exc
21c80 65 70 74 69 6f 6e 20 73 65 65 6d 73 20 74 6f 20 eption seems to
21c90 62 65 20 73 79 73 74 65 6d 73 20 74 68 61 74 20 be systems that
21ca0 61 72 65 20 63 6f 6e 66 69 67 75 72 65 64 0a 2a are configured.*
21cb0 2a 20 74 6f 20 75 73 65 20 36 34 4b 42 20 70 61 * to use 64KB pa
21cc0 67 65 73 20 2d 20 69 6e 20 74 68 69 73 20 63 61 ges - in this ca
21cd0 73 65 20 65 61 63 68 20 6d 61 70 70 69 6e 67 20 se each mapping
21ce0 6d 75 73 74 20 63 6f 76 65 72 20 61 74 20 6c 65 must cover at le
21cf0 61 73 74 20 74 77 6f 0a 2a 2a 20 73 68 6d 20 72 ast two.** shm r
21d00 65 67 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61 74 69 egions..*/.stati
21d10 63 20 69 6e 74 20 75 6e 69 78 53 68 6d 52 65 67 c int unixShmReg
21d20 69 6f 6e 50 65 72 4d 61 70 28 76 6f 69 64 29 7b ionPerMap(void){
21d30 0a 20 20 69 6e 74 20 73 68 6d 73 7a 20 3d 20 33 . int shmsz = 3
21d40 32 2a 31 30 32 34 3b 20 20 20 20 20 20 20 20 20 2*1024;
21d50 20 20 20 2f 2a 20 53 48 4d 20 72 65 67 69 6f 6e /* SHM region
21d60 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 70 size */. int p
21d70 67 73 7a 20 3d 20 6f 73 47 65 74 70 61 67 65 73 gsz = osGetpages
21d80 69 7a 65 28 29 3b 20 20 20 2f 2a 20 53 79 73 74 ize(); /* Syst
21d90 65 6d 20 70 61 67 65 20 73 69 7a 65 20 2a 2f 0a em page size */.
21da0 20 20 61 73 73 65 72 74 28 20 28 28 70 67 73 7a assert( ((pgsz
21db0 2d 31 29 26 70 67 73 7a 29 3d 3d 30 20 29 3b 20 -1)&pgsz)==0 );
21dc0 20 20 2f 2a 20 50 61 67 65 20 73 69 7a 65 20 6d /* Page size m
21dd0 75 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 6f ust be a power o
21de0 66 20 32 20 2a 2f 0a 20 20 69 66 28 20 70 67 73 f 2 */. if( pgs
21df0 7a 3c 73 68 6d 73 7a 20 29 20 72 65 74 75 72 6e z<shmsz ) return
21e00 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 70 67 73 1;. return pgs
21e10 7a 2f 73 68 6d 73 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a z/shmsz;.}../*.*
21e20 2a 20 50 75 72 67 65 20 74 68 65 20 75 6e 69 78 * Purge the unix
21e30 53 68 6d 4e 6f 64 65 4c 69 73 74 20 6c 69 73 74 ShmNodeList list
21e40 20 6f 66 20 61 6c 6c 20 65 6e 74 72 69 65 73 20 of all entries
21e50 77 69 74 68 20 75 6e 69 78 53 68 6d 4e 6f 64 65 with unixShmNode
21e60 2e 6e 52 65 66 3d 3d 30 2e 0a 2a 2a 0a 2a 2a 20 .nRef==0..**.**
21e70 54 68 69 73 20 69 73 20 6e 6f 74 20 61 20 56 46 This is not a VF
21e80 53 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 S shared-memory
21e90 6d 65 74 68 6f 64 3b 20 69 74 20 69 73 20 61 20 method; it is a
21ea0 75 74 69 6c 69 74 79 20 66 75 6e 63 74 69 6f 6e utility function
21eb0 20 63 61 6c 6c 65 64 0a 2a 2a 20 62 79 20 56 46 called.** by VF
21ec0 53 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 S shared-memory
21ed0 6d 65 74 68 6f 64 73 2e 0a 2a 2f 0a 73 74 61 74 methods..*/.stat
21ee0 69 63 20 76 6f 69 64 20 75 6e 69 78 53 68 6d 50 ic void unixShmP
21ef0 75 72 67 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 urge(unixFile *p
21f00 46 64 29 7b 0a 20 20 75 6e 69 78 53 68 6d 4e 6f Fd){. unixShmNo
21f10 64 65 20 2a 70 20 3d 20 70 46 64 2d 3e 70 49 6e de *p = pFd->pIn
21f20 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 3b 0a 20 ode->pShmNode;.
21f30 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d 75 74 assert( unixMut
21f40 65 78 48 65 6c 64 28 29 20 29 3b 0a 20 20 69 66 exHeld() );. if
21f50 28 20 70 20 26 26 20 41 4c 57 41 59 53 28 70 2d ( p && ALWAYS(p-
21f60 3e 6e 52 65 66 3d 3d 30 29 20 29 7b 0a 20 20 20 >nRef==0) ){.
21f70 20 69 6e 74 20 6e 53 68 6d 50 65 72 4d 61 70 20 int nShmPerMap
21f80 3d 20 75 6e 69 78 53 68 6d 52 65 67 69 6f 6e 50 = unixShmRegionP
21f90 65 72 4d 61 70 28 29 3b 0a 20 20 20 20 69 6e 74 erMap();. int
21fa0 20 69 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 i;. assert(
21fb0 70 2d 3e 70 49 6e 6f 64 65 3d 3d 70 46 64 2d 3e p->pInode==pFd->
21fc0 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 20 73 71 pInode );. sq
21fd0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 lite3_mutex_free
21fe0 28 70 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 (p->mutex);.
21ff0 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 52 for(i=0; i<p->nR
22000 65 67 69 6f 6e 3b 20 69 2b 3d 6e 53 68 6d 50 65 egion; i+=nShmPe
22010 72 4d 61 70 29 7b 0a 20 20 20 20 20 20 69 66 28 rMap){. if(
22020 20 70 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 20 20 p->h>=0 ){.
22030 20 20 20 20 6f 73 4d 75 6e 6d 61 70 28 70 2d 3e osMunmap(p->
22040 61 70 52 65 67 69 6f 6e 5b 69 5d 2c 20 70 2d 3e apRegion[i], p->
22050 73 7a 52 65 67 69 6f 6e 29 3b 0a 20 20 20 20 20 szRegion);.
22060 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
22070 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e sqlite3_free(p->
22080 61 70 52 65 67 69 6f 6e 5b 69 5d 29 3b 0a 20 20 apRegion[i]);.
22090 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
220a0 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e sqlite3_free(p->
220b0 61 70 52 65 67 69 6f 6e 29 3b 0a 20 20 20 20 69 apRegion);. i
220c0 66 28 20 70 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 f( p->h>=0 ){.
220d0 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 robust_close
220e0 28 70 46 64 2c 20 70 2d 3e 68 2c 20 5f 5f 4c 49 (pFd, p->h, __LI
220f0 4e 45 5f 5f 29 3b 0a 20 20 20 20 20 20 70 2d 3e NE__);. p->
22100 68 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 h = -1;. }.
22110 20 20 70 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 68 p->pInode->pSh
22120 6d 4e 6f 64 65 20 3d 20 30 3b 0a 20 20 20 20 73 mNode = 0;. s
22130 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
22140 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 }.}../*.** Ope
22150 6e 20 61 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 n a shared-memor
22160 79 20 61 72 65 61 20 61 73 73 6f 63 69 61 74 65 y area associate
22170 64 20 77 69 74 68 20 6f 70 65 6e 20 64 61 74 61 d with open data
22180 62 61 73 65 20 66 69 6c 65 20 70 44 62 46 64 2e base file pDbFd.
22190 20 20 0a 2a 2a 20 54 68 69 73 20 70 61 72 74 69 .** This parti
221a0 63 75 6c 61 72 20 69 6d 70 6c 65 6d 65 6e 74 61 cular implementa
221b0 74 69 6f 6e 20 75 73 65 73 20 6d 6d 61 70 70 65 tion uses mmappe
221c0 64 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 d files..**.** T
221d0 68 65 20 66 69 6c 65 20 75 73 65 64 20 74 6f 20 he file used to
221e0 69 6d 70 6c 65 6d 65 6e 74 20 73 68 61 72 65 64 implement shared
221f0 2d 6d 65 6d 6f 72 79 20 69 73 20 69 6e 20 74 68 -memory is in th
22200 65 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 e same directory
22210 0a 2a 2a 20 61 73 20 74 68 65 20 6f 70 65 6e 20 .** as the open
22220 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e database file an
22230 64 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e d has the same n
22240 61 6d 65 20 61 73 20 74 68 65 20 6f 70 65 6e 20 ame as the open
22250 64 61 74 61 62 61 73 65 0a 2a 2a 20 66 69 6c 65 database.** file
22260 20 77 69 74 68 20 74 68 65 20 22 2d 73 68 6d 22 with the "-shm"
22270 20 73 75 66 66 69 78 20 61 64 64 65 64 2e 20 20 suffix added.
22280 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 For example, if
22290 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
222a0 65 0a 2a 2a 20 69 73 20 22 2f 68 6f 6d 65 2f 75 e.** is "/home/u
222b0 73 65 72 31 2f 63 6f 6e 66 69 67 2e 64 62 22 20 ser1/config.db"
222c0 74 68 65 6e 20 74 68 65 20 66 69 6c 65 20 74 68 then the file th
222d0 61 74 20 69 73 20 63 72 65 61 74 65 64 20 61 6e at is created an
222e0 64 20 6d 6d 61 70 70 65 64 0a 2a 2a 20 66 6f 72 d mmapped.** for
222f0 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 77 shared memory w
22300 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 22 2f ill be called "/
22310 68 6f 6d 65 2f 75 73 65 72 31 2f 63 6f 6e 66 69 home/user1/confi
22320 67 2e 64 62 2d 73 68 6d 22 2e 20 20 0a 2a 2a 0a g.db-shm". .**.
22330 2a 2a 20 41 6e 6f 74 68 65 72 20 61 70 70 72 6f ** Another appro
22340 61 63 68 20 74 6f 20 69 73 20 74 6f 20 75 73 65 ach to is to use
22350 20 66 69 6c 65 73 20 69 6e 20 2f 64 65 76 2f 73 files in /dev/s
22360 68 6d 20 6f 72 20 2f 64 65 76 2f 74 6d 70 20 6f hm or /dev/tmp o
22370 72 20 61 6e 0a 2a 2a 20 73 6f 6d 65 20 6f 74 68 r an.** some oth
22380 65 72 20 74 6d 70 66 73 20 6d 6f 75 6e 74 2e 20 er tmpfs mount.
22390 42 75 74 20 69 66 20 61 20 66 69 6c 65 20 69 6e But if a file in
223a0 20 61 20 64 69 66 66 65 72 65 6e 74 20 64 69 72 a different dir
223b0 65 63 74 6f 72 79 0a 2a 2a 20 66 72 6f 6d 20 74 ectory.** from t
223c0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
223d0 20 69 73 20 75 73 65 64 2c 20 74 68 65 6e 20 64 is used, then d
223e0 69 66 66 65 72 69 6e 67 20 61 63 63 65 73 73 20 iffering access
223f0 70 65 72 6d 69 73 73 69 6f 6e 73 0a 2a 2a 20 6f permissions.** o
22400 72 20 61 20 63 68 72 6f 6f 74 28 29 20 6d 69 67 r a chroot() mig
22410 68 74 20 63 61 75 73 65 20 74 77 6f 20 64 69 66 ht cause two dif
22420 66 65 72 65 6e 74 20 70 72 6f 63 65 73 73 65 73 ferent processes
22430 20 6f 6e 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 on the same.**
22440 64 61 74 61 62 61 73 65 20 74 6f 20 65 6e 64 20 database to end
22450 75 70 20 75 73 69 6e 67 20 64 69 66 66 65 72 65 up using differe
22460 6e 74 20 66 69 6c 65 73 20 66 6f 72 20 73 68 61 nt files for sha
22470 72 65 64 20 6d 65 6d 6f 72 79 20 2d 20 0a 2a 2a red memory - .**
22480 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 74 68 meaning that th
22490 65 69 72 20 6d 65 6d 6f 72 79 20 77 6f 75 6c 64 eir memory would
224a0 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 65 20 73 not really be s
224b0 68 61 72 65 64 20 2d 20 72 65 73 75 6c 74 69 6e hared - resultin
224c0 67 0a 2a 2a 20 69 6e 20 64 61 74 61 62 61 73 65 g.** in database
224d0 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 4e 65 corruption. Ne
224e0 76 65 72 74 68 65 6c 65 73 73 2c 20 74 68 69 73 vertheless, this
224f0 20 74 6d 70 66 73 20 66 69 6c 65 20 75 73 61 67 tmpfs file usag
22500 65 0a 2a 2a 20 63 61 6e 20 62 65 20 65 6e 61 62 e.** can be enab
22510 6c 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 led at compile-t
22520 69 6d 65 20 75 73 69 6e 67 20 2d 44 53 51 4c 49 ime using -DSQLI
22530 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 59 TE_SHM_DIRECTORY
22540 3d 22 2f 64 65 76 2f 73 68 6d 22 0a 2a 2a 20 6f ="/dev/shm".** o
22550 72 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e 74 r the equivalent
22560 2e 20 20 54 68 65 20 75 73 65 20 6f 66 20 74 68 . The use of th
22570 65 20 53 51 4c 49 54 45 5f 53 48 4d 5f 44 49 52 e SQLITE_SHM_DIR
22580 45 43 54 4f 52 59 20 63 6f 6d 70 69 6c 65 2d 74 ECTORY compile-t
22590 69 6d 65 0a 2a 2a 20 6f 70 74 69 6f 6e 20 72 65 ime.** option re
225a0 73 75 6c 74 73 20 69 6e 20 61 6e 20 69 6e 63 6f sults in an inco
225b0 6d 70 61 74 69 62 6c 65 20 62 75 69 6c 64 20 6f mpatible build o
225c0 66 20 53 51 4c 69 74 65 3b 20 20 62 75 69 6c 64 f SQLite; build
225d0 73 20 6f 66 20 53 51 4c 69 74 65 0a 2a 2a 20 74 s of SQLite.** t
225e0 68 61 74 20 77 69 74 68 20 64 69 66 66 65 72 69 hat with differi
225f0 6e 67 20 53 51 4c 49 54 45 5f 53 48 4d 5f 44 49 ng SQLITE_SHM_DI
22600 52 45 43 54 4f 52 59 20 73 65 74 74 69 6e 67 73 RECTORY settings
22610 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 attempt to use
22620 74 68 65 0a 2a 2a 20 73 61 6d 65 20 64 61 74 61 the.** same data
22630 62 61 73 65 20 66 69 6c 65 20 61 74 20 74 68 65 base file at the
22640 20 73 61 6d 65 20 74 69 6d 65 2c 20 64 61 74 61 same time, data
22650 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 base corruption
22660 77 69 6c 6c 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 will likely.** r
22670 65 73 75 6c 74 2e 20 54 68 65 20 53 51 4c 49 54 esult. The SQLIT
22680 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 59 20 E_SHM_DIRECTORY
22690 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
226a0 69 6f 6e 20 69 73 20 63 6f 6e 73 69 64 65 72 65 ion is considere
226b0 64 0a 2a 2a 20 22 75 6e 73 75 70 70 6f 72 74 65 d.** "unsupporte
226c0 64 22 20 61 6e 64 20 6d 61 79 20 67 6f 20 61 77 d" and may go aw
226d0 61 79 20 69 6e 20 61 20 66 75 74 75 72 65 20 53 ay in a future S
226e0 51 4c 69 74 65 20 72 65 6c 65 61 73 65 2e 0a 2a QLite release..*
226f0 2a 0a 2a 2a 20 57 68 65 6e 20 6f 70 65 6e 69 6e *.** When openin
22700 67 20 61 20 6e 65 77 20 73 68 61 72 65 64 2d 6d g a new shared-m
22710 65 6d 6f 72 79 20 66 69 6c 65 2c 20 69 66 20 6e emory file, if n
22720 6f 20 6f 74 68 65 72 20 69 6e 73 74 61 6e 63 65 o other instance
22730 73 20 6f 66 20 74 68 61 74 0a 2a 2a 20 66 69 6c s of that.** fil
22740 65 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 e are currently
22750 6f 70 65 6e 2c 20 69 6e 20 74 68 69 73 20 70 72 open, in this pr
22760 6f 63 65 73 73 20 6f 72 20 69 6e 20 6f 74 68 65 ocess or in othe
22770 72 20 70 72 6f 63 65 73 73 65 73 2c 20 74 68 65 r processes, the
22780 6e 0a 2a 2a 20 74 68 65 20 66 69 6c 65 20 6d 75 n.** the file mu
22790 73 74 20 62 65 20 74 72 75 6e 63 61 74 65 64 20 st be truncated
227a0 74 6f 20 7a 65 72 6f 20 6c 65 6e 67 74 68 20 6f to zero length o
227b0 72 20 68 61 76 65 20 69 74 73 20 68 65 61 64 65 r have its heade
227c0 72 20 63 6c 65 61 72 65 64 2e 0a 2a 2a 0a 2a 2a r cleared..**.**
227d0 20 49 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c If the original
227e0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 database file (
227f0 70 44 62 46 64 29 20 69 73 20 75 73 69 6e 67 20 pDbFd) is using
22800 74 68 65 20 22 75 6e 69 78 2d 65 78 63 6c 22 20 the "unix-excl"
22810 56 46 53 0a 2a 2a 20 74 68 61 74 20 6d 65 61 6e VFS.** that mean
22820 73 20 74 68 61 74 20 61 6e 20 65 78 63 6c 75 73 s that an exclus
22830 69 76 65 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 ive lock is held
22840 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
22850 20 66 69 6c 65 20 61 6e 64 0a 2a 2a 20 74 68 61 file and.** tha
22860 74 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 t no other proce
22870 73 73 65 73 20 61 72 65 20 61 62 6c 65 20 74 6f sses are able to
22880 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 read or write t
22890 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 6e he database. In
228a0 0a 2a 2a 20 74 68 61 74 20 63 61 73 65 2c 20 77 .** that case, w
228b0 65 20 64 6f 20 6e 6f 74 20 72 65 61 6c 6c 79 20 e do not really
228c0 6e 65 65 64 20 73 68 61 72 65 64 20 6d 65 6d 6f need shared memo
228d0 72 79 2e 20 20 4e 6f 20 73 68 61 72 65 64 20 6d ry. No shared m
228e0 65 6d 6f 72 79 0a 2a 2a 20 66 69 6c 65 20 69 73 emory.** file is
228f0 20 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 created. The s
22900 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 77 69 6c hared memory wil
22910 6c 20 62 65 20 73 69 6d 75 6c 61 74 65 64 20 77 l be simulated w
22920 69 74 68 20 68 65 61 70 20 6d 65 6d 6f 72 79 2e ith heap memory.
22930 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
22940 6e 69 78 4f 70 65 6e 53 68 61 72 65 64 4d 65 6d nixOpenSharedMem
22950 6f 72 79 28 75 6e 69 78 46 69 6c 65 20 2a 70 44 ory(unixFile *pD
22960 62 46 64 29 7b 0a 20 20 73 74 72 75 63 74 20 75 bFd){. struct u
22970 6e 69 78 53 68 6d 20 2a 70 20 3d 20 30 3b 20 20 nixShm *p = 0;
22980 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 /* The c
22990 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 62 65 20 onnection to be
229a0 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 73 74 72 75 opened */. stru
229b0 63 74 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a ct unixShmNode *
229c0 70 53 68 6d 4e 6f 64 65 3b 20 20 20 2f 2a 20 54 pShmNode; /* T
229d0 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 6d he underlying mm
229e0 61 70 70 65 64 20 66 69 6c 65 20 2a 2f 0a 20 20 apped file */.
229f0 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
22a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22a10 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a /* Result code *
22a20 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 /. unixInodeInf
22a30 6f 20 2a 70 49 6e 6f 64 65 3b 20 20 20 20 20 20 o *pInode;
22a40 20 20 20 20 2f 2a 20 54 68 65 20 69 6e 6f 64 65 /* The inode
22a50 20 6f 66 20 66 64 20 2a 2f 0a 20 20 63 68 61 72 of fd */. char
22a60 20 2a 7a 53 68 6d 46 69 6c 65 6e 61 6d 65 3b 20 *zShmFilename;
22a70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
22a80 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 ame of the file
22a90 75 73 65 64 20 66 6f 72 20 53 48 4d 20 2a 2f 0a used for SHM */.
22aa0 20 20 69 6e 74 20 6e 53 68 6d 46 69 6c 65 6e 61 int nShmFilena
22ab0 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 me;
22ac0 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 /* Size of the
22ad0 20 53 48 4d 20 66 69 6c 65 6e 61 6d 65 20 69 6e SHM filename in
22ae0 20 62 79 74 65 73 20 2a 2f 0a 0a 20 20 2f 2a 20 bytes */.. /*
22af0 41 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 Allocate space f
22b00 6f 72 20 74 68 65 20 6e 65 77 20 75 6e 69 78 53 or the new unixS
22b10 68 6d 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20 20 hm object. */.
22b20 70 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c p = sqlite3_mall
22b30 6f 63 36 34 28 20 73 69 7a 65 6f 66 28 2a 70 29 oc64( sizeof(*p)
22b40 20 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 );. if( p==0 )
22b50 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
22b60 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 6d 65 6d OMEM_BKPT;. mem
22b70 73 65 74 28 70 2c 20 30 2c 20 73 69 7a 65 6f 66 set(p, 0, sizeof
22b80 28 2a 70 29 29 3b 0a 20 20 61 73 73 65 72 74 28 (*p));. assert(
22b90 20 70 44 62 46 64 2d 3e 70 53 68 6d 3d 3d 30 20 pDbFd->pShm==0
22ba0 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 );.. /* Check t
22bb0 6f 20 73 65 65 20 69 66 20 61 20 75 6e 69 78 53 o see if a unixS
22bc0 68 6d 4e 6f 64 65 20 6f 62 6a 65 63 74 20 61 6c hmNode object al
22bd0 72 65 61 64 79 20 65 78 69 73 74 73 2e 20 52 65 ready exists. Re
22be0 75 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 0a use an existing.
22bf0 20 20 2a 2a 20 6f 6e 65 20 69 66 20 70 72 65 73 ** one if pres
22c00 65 6e 74 2e 20 43 72 65 61 74 65 20 61 20 6e 65 ent. Create a ne
22c10 77 20 6f 6e 65 20 69 66 20 6e 65 63 65 73 73 61 w one if necessa
22c20 72 79 2e 0a 20 20 2a 2f 0a 20 20 75 6e 69 78 45 ry.. */. unixE
22c30 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 nterMutex();. p
22c40 49 6e 6f 64 65 20 3d 20 70 44 62 46 64 2d 3e 70 Inode = pDbFd->p
22c50 49 6e 6f 64 65 3b 0a 20 20 70 53 68 6d 4e 6f 64 Inode;. pShmNod
22c60 65 20 3d 20 70 49 6e 6f 64 65 2d 3e 70 53 68 6d e = pInode->pShm
22c70 4e 6f 64 65 3b 0a 20 20 69 66 28 20 70 53 68 6d Node;. if( pShm
22c80 4e 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 Node==0 ){. s
22c90 74 72 75 63 74 20 73 74 61 74 20 73 53 74 61 74 truct stat sStat
22ca0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
22cb0 20 20 2f 2a 20 66 73 74 61 74 28 29 20 69 6e 66 /* fstat() inf
22cc0 6f 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 66 o for database f
22cd0 69 6c 65 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ile */.#ifndef S
22ce0 51 4c 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 QLITE_SHM_DIRECT
22cf0 4f 52 59 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 ORY. const ch
22d00 61 72 20 2a 7a 42 61 73 65 50 61 74 68 20 3d 20 ar *zBasePath =
22d10 70 44 62 46 64 2d 3e 7a 50 61 74 68 3b 0a 23 65 pDbFd->zPath;.#e
22d20 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 43 61 6c ndif.. /* Cal
22d30 6c 20 66 73 74 61 74 28 29 20 74 6f 20 66 69 67 l fstat() to fig
22d40 75 72 65 20 6f 75 74 20 74 68 65 20 70 65 72 6d ure out the perm
22d50 69 73 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 64 issions on the d
22d60 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 atabase file. If
22d70 0a 20 20 20 20 2a 2a 20 61 20 6e 65 77 20 2a 2d . ** a new *-
22d80 73 68 6d 20 66 69 6c 65 20 69 73 20 63 72 65 61 shm file is crea
22d90 74 65 64 2c 20 61 6e 20 61 74 74 65 6d 70 74 20 ted, an attempt
22da0 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f 20 will be made to
22db0 63 72 65 61 74 65 20 69 74 0a 20 20 20 20 2a 2a create it. **
22dc0 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 70 with the same p
22dd0 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 20 20 20 20 ermissions..
22de0 2a 2f 0a 20 20 20 20 69 66 28 20 6f 73 46 73 74 */. if( osFst
22df0 61 74 28 70 44 62 46 64 2d 3e 68 2c 20 26 73 53 at(pDbFd->h, &sS
22e00 74 61 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63 tat) ){. rc
22e10 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = SQLITE_IOERR_
22e20 46 53 54 41 54 3b 0a 20 20 20 20 20 20 67 6f 74 FSTAT;. got
22e30 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a o shm_open_err;.
22e40 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }..#ifdef SQ
22e50 4c 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f LITE_SHM_DIRECTO
22e60 52 59 0a 20 20 20 20 6e 53 68 6d 46 69 6c 65 6e RY. nShmFilen
22e70 61 6d 65 20 3d 20 73 69 7a 65 6f 66 28 53 51 4c ame = sizeof(SQL
22e80 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 ITE_SHM_DIRECTOR
22e90 59 29 20 2b 20 33 31 3b 0a 23 65 6c 73 65 0a 20 Y) + 31;.#else.
22ea0 20 20 20 6e 53 68 6d 46 69 6c 65 6e 61 6d 65 20 nShmFilename
22eb0 3d 20 36 20 2b 20 28 69 6e 74 29 73 74 72 6c 65 = 6 + (int)strle
22ec0 6e 28 7a 42 61 73 65 50 61 74 68 29 3b 0a 23 65 n(zBasePath);.#e
22ed0 6e 64 69 66 0a 20 20 20 20 70 53 68 6d 4e 6f 64 ndif. pShmNod
22ee0 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c e = sqlite3_mall
22ef0 6f 63 36 34 28 20 73 69 7a 65 6f 66 28 2a 70 53 oc64( sizeof(*pS
22f00 68 6d 4e 6f 64 65 29 20 2b 20 6e 53 68 6d 46 69 hmNode) + nShmFi
22f10 6c 65 6e 61 6d 65 20 29 3b 0a 20 20 20 20 69 66 lename );. if
22f20 28 20 70 53 68 6d 4e 6f 64 65 3d 3d 30 20 29 7b ( pShmNode==0 ){
22f30 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
22f40 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
22f50 20 20 20 20 20 67 6f 74 6f 20 73 68 6d 5f 6f 70 goto shm_op
22f60 65 6e 5f 65 72 72 3b 0a 20 20 20 20 7d 0a 20 20 en_err;. }.
22f70 20 20 6d 65 6d 73 65 74 28 70 53 68 6d 4e 6f 64 memset(pShmNod
22f80 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a 70 53 e, 0, sizeof(*pS
22f90 68 6d 4e 6f 64 65 29 2b 6e 53 68 6d 46 69 6c 65 hmNode)+nShmFile
22fa0 6e 61 6d 65 29 3b 0a 20 20 20 20 7a 53 68 6d 46 name);. zShmF
22fb0 69 6c 65 6e 61 6d 65 20 3d 20 70 53 68 6d 4e 6f ilename = pShmNo
22fc0 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 de->zFilename =
22fd0 28 63 68 61 72 2a 29 26 70 53 68 6d 4e 6f 64 65 (char*)&pShmNode
22fe0 5b 31 5d 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 [1];.#ifdef SQLI
22ff0 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 59 TE_SHM_DIRECTORY
23000 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 . sqlite3_snp
23010 72 69 6e 74 66 28 6e 53 68 6d 46 69 6c 65 6e 61 rintf(nShmFilena
23020 6d 65 2c 20 7a 53 68 6d 46 69 6c 65 6e 61 6d 65 me, zShmFilename
23030 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 , .
23040 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53 SQLITE_S
23050 48 4d 5f 44 49 52 45 43 54 4f 52 59 20 22 2f 73 HM_DIRECTORY "/s
23060 71 6c 69 74 65 2d 73 68 6d 2d 25 78 2d 25 78 22 qlite-shm-%x-%x"
23070 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
23080 20 20 20 20 20 20 20 28 75 33 32 29 73 53 74 61 (u32)sSta
23090 74 2e 73 74 5f 69 6e 6f 2c 20 28 75 33 32 29 73 t.st_ino, (u32)s
230a0 53 74 61 74 2e 73 74 5f 64 65 76 29 3b 0a 23 65 Stat.st_dev);.#e
230b0 6c 73 65 0a 20 20 20 20 73 71 6c 69 74 65 33 5f lse. sqlite3_
230c0 73 6e 70 72 69 6e 74 66 28 6e 53 68 6d 46 69 6c snprintf(nShmFil
230d0 65 6e 61 6d 65 2c 20 7a 53 68 6d 46 69 6c 65 6e ename, zShmFilen
230e0 61 6d 65 2c 20 22 25 73 2d 73 68 6d 22 2c 20 7a ame, "%s-shm", z
230f0 42 61 73 65 50 61 74 68 29 3b 0a 20 20 20 20 73 BasePath);. s
23100 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 qlite3FileSuffix
23110 33 28 70 44 62 46 64 2d 3e 7a 50 61 74 68 2c 20 3(pDbFd->zPath,
23120 7a 53 68 6d 46 69 6c 65 6e 61 6d 65 29 3b 0a 23 zShmFilename);.#
23130 65 6e 64 69 66 0a 20 20 20 20 70 53 68 6d 4e 6f endif. pShmNo
23140 64 65 2d 3e 68 20 3d 20 2d 31 3b 0a 20 20 20 20 de->h = -1;.
23150 70 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 pDbFd->pInode->p
23160 53 68 6d 4e 6f 64 65 20 3d 20 70 53 68 6d 4e 6f ShmNode = pShmNo
23170 64 65 3b 0a 20 20 20 20 70 53 68 6d 4e 6f 64 65 de;. pShmNode
23180 2d 3e 70 49 6e 6f 64 65 20 3d 20 70 44 62 46 64 ->pInode = pDbFd
23190 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 20 20 69 66 ->pInode;. if
231a0 28 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 ( sqlite3GlobalC
231b0 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
231c0 20 29 7b 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f ){. pShmNo
231d0 64 65 2d 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 de->mutex = sqli
231e0 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 te3_mutex_alloc(
231f0 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46 41 53 SQLITE_MUTEX_FAS
23200 54 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 53 T);. if( pS
23210 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 3d 3d 30 hmNode->mutex==0
23220 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
23230 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
23240 50 54 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f PT;. goto
23250 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a 20 shm_open_err;.
23260 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 }. }..
23270 20 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 62 50 if( pInode->bP
23280 72 6f 63 65 73 73 4c 6f 63 6b 3d 3d 30 20 29 7b rocessLock==0 ){
23290 0a 20 20 20 20 20 20 69 6e 74 20 6f 70 65 6e 46 . int openF
232a0 6c 61 67 73 20 3d 20 4f 5f 52 44 57 52 20 7c 20 lags = O_RDWR |
232b0 4f 5f 43 52 45 41 54 3b 0a 20 20 20 20 20 20 69 O_CREAT;. i
232c0 66 28 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 62 f( sqlite3_uri_b
232d0 6f 6f 6c 65 61 6e 28 70 44 62 46 64 2d 3e 7a 50 oolean(pDbFd->zP
232e0 61 74 68 2c 20 22 72 65 61 64 6f 6e 6c 79 5f 73 ath, "readonly_s
232f0 68 6d 22 2c 20 30 29 20 29 7b 0a 20 20 20 20 20 hm", 0) ){.
23300 20 20 20 6f 70 65 6e 46 6c 61 67 73 20 3d 20 4f openFlags = O
23310 5f 52 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 20 20 _RDONLY;.
23320 20 70 53 68 6d 4e 6f 64 65 2d 3e 69 73 52 65 61 pShmNode->isRea
23330 64 6f 6e 6c 79 20 3d 20 31 3b 0a 20 20 20 20 20 donly = 1;.
23340 20 7d 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 }. pShmNod
23350 65 2d 3e 68 20 3d 20 72 6f 62 75 73 74 5f 6f 70 e->h = robust_op
23360 65 6e 28 7a 53 68 6d 46 69 6c 65 6e 61 6d 65 2c en(zShmFilename,
23370 20 6f 70 65 6e 46 6c 61 67 73 2c 20 28 73 53 74 openFlags, (sSt
23380 61 74 2e 73 74 5f 6d 6f 64 65 26 30 37 37 37 29 at.st_mode&0777)
23390 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 53 68 );. if( pSh
233a0 6d 4e 6f 64 65 2d 3e 68 3c 30 20 29 7b 0a 20 20 mNode->h<0 ){.
233b0 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 4c rc = unixL
233c0 6f 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 ogError(SQLITE_C
233d0 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 2c 20 22 6f ANTOPEN_BKPT, "o
233e0 70 65 6e 22 2c 20 7a 53 68 6d 46 69 6c 65 6e 61 pen", zShmFilena
233f0 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 me);. got
23400 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a o shm_open_err;.
23410 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f }.. /
23420 2a 20 49 66 20 74 68 69 73 20 70 72 6f 63 65 73 * If this proces
23430 73 20 69 73 20 72 75 6e 6e 69 6e 67 20 61 73 20 s is running as
23440 72 6f 6f 74 2c 20 6d 61 6b 65 20 73 75 72 65 20 root, make sure
23450 74 68 61 74 20 74 68 65 20 53 48 4d 20 66 69 6c that the SHM fil
23460 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 6f 77 e. ** is ow
23470 6e 65 64 20 62 79 20 74 68 65 20 73 61 6d 65 20 ned by the same
23480 75 73 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 user that owns t
23490 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 he original data
234a0 62 61 73 65 2e 20 20 4f 74 68 65 72 77 69 73 65 base. Otherwise
234b0 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 6f ,. ** the o
234c0 72 69 67 69 6e 61 6c 20 6f 77 6e 65 72 20 77 69 riginal owner wi
234d0 6c 6c 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 ll not be able t
234e0 6f 20 63 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 20 o connect..
234f0 20 2a 2f 0a 20 20 20 20 20 20 72 6f 62 75 73 74 */. robust
23500 46 63 68 6f 77 6e 28 70 53 68 6d 4e 6f 64 65 2d Fchown(pShmNode-
23510 3e 68 2c 20 73 53 74 61 74 2e 73 74 5f 75 69 64 >h, sStat.st_uid
23520 2c 20 73 53 74 61 74 2e 73 74 5f 67 69 64 29 3b , sStat.st_gid);
23530 0a 20 20 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 . . /* Che
23540 63 6b 20 74 6f 20 73 65 65 20 69 66 20 61 6e 6f ck to see if ano
23550 74 68 65 72 20 70 72 6f 63 65 73 73 20 69 73 20 ther process is
23560 68 6f 6c 64 69 6e 67 20 74 68 65 20 64 65 61 64 holding the dead
23570 2d 6d 61 6e 20 73 77 69 74 63 68 2e 0a 20 20 20 -man switch..
23580 20 20 20 2a 2a 20 49 66 20 6e 6f 74 2c 20 74 72 ** If not, tr
23590 75 6e 63 61 74 65 20 74 68 65 20 66 69 6c 65 20 uncate the file
235a0 74 6f 20 7a 65 72 6f 20 6c 65 6e 67 74 68 2e 20 to zero length.
235b0 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
235c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
235d0 20 20 20 20 20 20 69 66 28 20 75 6e 69 78 53 68 if( unixSh
235e0 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 70 44 62 46 mSystemLock(pDbF
235f0 64 2c 20 46 5f 57 52 4c 43 4b 2c 20 55 4e 49 58 d, F_WRLCK, UNIX
23600 5f 53 48 4d 5f 44 4d 53 2c 20 31 29 3d 3d 53 51 _SHM_DMS, 1)==SQ
23610 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
23620 20 20 20 69 66 28 20 72 6f 62 75 73 74 5f 66 74 if( robust_ft
23630 72 75 6e 63 61 74 65 28 70 53 68 6d 4e 6f 64 65 runcate(pShmNode
23640 2d 3e 68 2c 20 30 29 20 29 7b 0a 20 20 20 20 20 ->h, 0) ){.
23650 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 4c 6f rc = unixLo
23660 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f gError(SQLITE_IO
23670 45 52 52 5f 53 48 4d 4f 50 45 4e 2c 20 22 66 74 ERR_SHMOPEN, "ft
23680 72 75 6e 63 61 74 65 22 2c 20 7a 53 68 6d 46 69 runcate", zShmFi
23690 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 lename);.
236a0 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
236b0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
236c0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 OK ){. rc
236d0 20 3d 20 75 6e 69 78 53 68 6d 53 79 73 74 65 6d = unixShmSystem
236e0 4c 6f 63 6b 28 70 44 62 46 64 2c 20 46 5f 52 44 Lock(pDbFd, F_RD
236f0 4c 43 4b 2c 20 55 4e 49 58 5f 53 48 4d 5f 44 4d LCK, UNIX_SHM_DM
23700 53 2c 20 31 29 3b 0a 20 20 20 20 20 20 7d 0a 20 S, 1);. }.
23710 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 6f if( rc ) go
23720 74 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b to shm_open_err;
23730 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
23740 20 4d 61 6b 65 20 74 68 65 20 6e 65 77 20 63 6f Make the new co
23750 6e 6e 65 63 74 69 6f 6e 20 61 20 63 68 69 6c 64 nnection a child
23760 20 6f 66 20 74 68 65 20 75 6e 69 78 53 68 6d 4e of the unixShmN
23770 6f 64 65 20 2a 2f 0a 20 20 70 2d 3e 70 53 68 6d ode */. p->pShm
23780 4e 6f 64 65 20 3d 20 70 53 68 6d 4e 6f 64 65 3b Node = pShmNode;
23790 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
237a0 45 42 55 47 0a 20 20 70 2d 3e 69 64 20 3d 20 70 EBUG. p->id = p
237b0 53 68 6d 4e 6f 64 65 2d 3e 6e 65 78 74 53 68 6d ShmNode->nextShm
237c0 49 64 2b 2b 3b 0a 23 65 6e 64 69 66 0a 20 20 70 Id++;.#endif. p
237d0 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 2b 2b 3b ShmNode->nRef++;
237e0 0a 20 20 70 44 62 46 64 2d 3e 70 53 68 6d 20 3d . pDbFd->pShm =
237f0 20 70 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d p;. unixLeaveM
23800 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 54 68 utex();.. /* Th
23810 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e e reference coun
23820 74 20 6f 6e 20 70 53 68 6d 4e 6f 64 65 20 68 61 t on pShmNode ha
23830 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 69 s already been i
23840 6e 63 72 65 6d 65 6e 74 65 64 20 75 6e 64 65 72 ncremented under
23850 0a 20 20 2a 2a 20 74 68 65 20 63 6f 76 65 72 20 . ** the cover
23860 6f 66 20 74 68 65 20 75 6e 69 78 45 6e 74 65 72 of the unixEnter
23870 4d 75 74 65 78 28 29 20 6d 75 74 65 78 20 61 6e Mutex() mutex an
23880 64 20 74 68 65 20 70 6f 69 6e 74 65 72 20 66 72 d the pointer fr
23890 6f 6d 20 74 68 65 0a 20 20 2a 2a 20 6e 65 77 20 om the. ** new
238a0 28 73 74 72 75 63 74 20 75 6e 69 78 53 68 6d 29 (struct unixShm)
238b0 20 6f 62 6a 65 63 74 20 74 6f 20 74 68 65 20 70 object to the p
238c0 53 68 6d 4e 6f 64 65 20 68 61 73 20 62 65 65 6e ShmNode has been
238d0 20 73 65 74 2e 20 41 6c 6c 20 74 68 61 74 20 69 set. All that i
238e0 73 0a 20 20 2a 2a 20 6c 65 66 74 20 74 6f 20 64 s. ** left to d
238f0 6f 20 69 73 20 74 6f 20 6c 69 6e 6b 20 74 68 65 o is to link the
23900 20 6e 65 77 20 6f 62 6a 65 63 74 20 69 6e 74 6f new object into
23910 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 the linked list
23920 20 73 74 61 72 74 69 6e 67 0a 20 20 2a 2a 20 61 starting. ** a
23930 74 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 t pShmNode->pFir
23940 73 74 2e 20 54 68 69 73 20 6d 75 73 74 20 62 65 st. This must be
23950 20 64 6f 6e 65 20 77 68 69 6c 65 20 68 6f 6c 64 done while hold
23960 69 6e 67 20 74 68 65 20 70 53 68 6d 4e 6f 64 65 ing the pShmNode
23970 2d 3e 6d 75 74 65 78 20 0a 20 20 2a 2a 20 6d 75 ->mutex . ** mu
23980 74 65 78 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 tex.. */. sqli
23990 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
239a0 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 29 pShmNode->mutex)
239b0 3b 0a 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 ;. p->pNext = p
239c0 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74 3b ShmNode->pFirst;
239d0 0a 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 . pShmNode->pFi
239e0 72 73 74 20 3d 20 70 3b 0a 20 20 73 71 6c 69 74 rst = p;. sqlit
239f0 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 e3_mutex_leave(p
23a00 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 29 3b ShmNode->mutex);
23a10 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
23a20 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 _OK;.. /* Jump
23a30 68 65 72 65 20 6f 6e 20 61 6e 79 20 65 72 72 6f here on any erro
23a40 72 20 2a 2f 0a 73 68 6d 5f 6f 70 65 6e 5f 65 72 r */.shm_open_er
23a50 72 3a 0a 20 20 75 6e 69 78 53 68 6d 50 75 72 67 r:. unixShmPurg
23a60 65 28 70 44 62 46 64 29 3b 20 20 20 20 20 20 20 e(pDbFd);
23a70 2f 2a 20 54 68 69 73 20 63 61 6c 6c 20 66 72 65 /* This call fre
23a80 65 73 20 70 53 68 6d 4e 6f 64 65 20 69 66 20 72 es pShmNode if r
23a90 65 71 75 69 72 65 64 20 2a 2f 0a 20 20 73 71 6c equired */. sql
23aa0 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 ite3_free(p);.
23ab0 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 unixLeaveMutex()
23ac0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
23ad0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
23ae0 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
23af0 74 6f 20 6f 62 74 61 69 6e 20 61 20 70 6f 69 6e to obtain a poin
23b00 74 65 72 20 74 6f 20 72 65 67 69 6f 6e 20 69 52 ter to region iR
23b10 65 67 69 6f 6e 20 6f 66 20 74 68 65 20 0a 2a 2a egion of the .**
23b20 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 61 shared-memory a
23b30 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
23b40 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
23b50 20 66 64 2e 20 53 68 61 72 65 64 2d 6d 65 6d 6f fd. Shared-memo
23b60 72 79 20 72 65 67 69 6f 6e 73 20 0a 2a 2a 20 61 ry regions .** a
23b70 72 65 20 6e 75 6d 62 65 72 65 64 20 73 74 61 72 re numbered star
23b80 74 69 6e 67 20 66 72 6f 6d 20 7a 65 72 6f 2e 20 ting from zero.
23b90 45 61 63 68 20 73 68 61 72 65 64 2d 6d 65 6d 6f Each shared-memo
23ba0 72 79 20 72 65 67 69 6f 6e 20 69 73 20 73 7a 52 ry region is szR
23bb0 65 67 69 6f 6e 20 0a 2a 2a 20 62 79 74 65 73 20 egion .** bytes
23bc0 69 6e 20 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 49 in size..**.** I
23bd0 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
23be0 73 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 s, an error code
23bf0 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 is returned and
23c00 20 2a 70 70 20 69 73 20 73 65 74 20 74 6f 20 4e *pp is set to N
23c10 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 ULL..**.** Other
23c20 77 69 73 65 2c 20 69 66 20 74 68 65 20 62 45 78 wise, if the bEx
23c30 74 65 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 tend parameter i
23c40 73 20 30 20 61 6e 64 20 74 68 65 20 72 65 71 75 s 0 and the requ
23c50 65 73 74 65 64 20 73 68 61 72 65 64 2d 6d 65 6d ested shared-mem
23c60 6f 72 79 0a 2a 2a 20 72 65 67 69 6f 6e 20 68 61 ory.** region ha
23c70 73 20 6e 6f 74 20 62 65 65 6e 20 61 6c 6c 6f 63 s not been alloc
23c80 61 74 65 64 20 28 62 79 20 61 6e 79 20 63 6c 69 ated (by any cli
23c90 65 6e 74 2c 20 69 6e 63 6c 75 64 69 6e 67 20 6f ent, including o
23ca0 6e 65 20 72 75 6e 6e 69 6e 67 20 69 6e 20 61 0a ne running in a.
23cb0 2a 2a 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 ** separate proc
23cc0 65 73 73 29 2c 20 74 68 65 6e 20 2a 70 70 20 69 ess), then *pp i
23cd0 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 61 6e s set to NULL an
23ce0 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 d SQLITE_OK retu
23cf0 72 6e 65 64 2e 20 49 66 20 0a 2a 2a 20 62 45 78 rned. If .** bEx
23d00 74 65 6e 64 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f tend is non-zero
23d10 20 61 6e 64 20 74 68 65 20 72 65 71 75 65 73 74 and the request
23d20 65 64 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 ed shared-memory
23d30 20 72 65 67 69 6f 6e 20 68 61 73 20 6e 6f 74 20 region has not
23d40 79 65 74 20 0a 2a 2a 20 62 65 65 6e 20 61 6c 6c yet .** been all
23d50 6f 63 61 74 65 64 2c 20 69 74 20 69 73 20 61 6c ocated, it is al
23d60 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 20 located by this
23d70 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 function..**.**
23d80 49 66 20 74 68 65 20 73 68 61 72 65 64 2d 6d 65 If the shared-me
23d90 6d 6f 72 79 20 72 65 67 69 6f 6e 20 68 61 73 20 mory region has
23da0 61 6c 72 65 61 64 79 20 62 65 65 6e 20 61 6c 6c already been all
23db0 6f 63 61 74 65 64 20 6f 72 20 69 73 20 61 6c 6c ocated or is all
23dc0 6f 63 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 69 ocated by.** thi
23dd0 73 20 63 61 6c 6c 20 61 73 20 64 65 73 63 72 69 s call as descri
23de0 62 65 64 20 61 62 6f 76 65 2c 20 74 68 65 6e 20 bed above, then
23df0 69 74 20 69 73 20 6d 61 70 70 65 64 20 69 6e 74 it is mapped int
23e00 6f 20 74 68 69 73 20 70 72 6f 63 65 73 73 65 73 o this processes
23e10 20 0a 2a 2a 20 61 64 64 72 65 73 73 20 73 70 61 .** address spa
23e20 63 65 20 28 69 66 20 69 74 20 69 73 20 6e 6f 74 ce (if it is not
23e30 20 61 6c 72 65 61 64 79 29 2c 20 2a 70 70 20 69 already), *pp i
23e40 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 s set to point t
23e50 6f 20 74 68 65 20 6d 61 70 70 65 64 20 0a 2a 2a o the mapped .**
23e60 20 6d 65 6d 6f 72 79 20 61 6e 64 20 53 51 4c 49 memory and SQLI
23e70 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 0a TE_OK returned..
23e80 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
23e90 69 78 53 68 6d 4d 61 70 28 0a 20 20 73 71 6c 69 ixShmMap(. sqli
23ea0 74 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 20 20 te3_file *fd,
23eb0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
23ec0 61 6e 64 6c 65 20 6f 70 65 6e 20 6f 6e 20 64 61 andle open on da
23ed0 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
23ee0 20 69 6e 74 20 69 52 65 67 69 6f 6e 2c 20 20 20 int iRegion,
23ef0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23f00 20 2f 2a 20 52 65 67 69 6f 6e 20 74 6f 20 72 65 /* Region to re
23f10 74 72 69 65 76 65 20 2a 2f 0a 20 20 69 6e 74 20 trieve */. int
23f20 73 7a 52 65 67 69 6f 6e 2c 20 20 20 20 20 20 20 szRegion,
23f30 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
23f40 69 7a 65 20 6f 66 20 72 65 67 69 6f 6e 73 20 2a ize of regions *
23f50 2f 0a 20 20 69 6e 74 20 62 45 78 74 65 6e 64 2c /. int bExtend,
23f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23f70 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 /* True to e
23f80 78 74 65 6e 64 20 66 69 6c 65 20 69 66 20 6e 65 xtend file if ne
23f90 63 65 73 73 61 72 79 20 2a 2f 0a 20 20 76 6f 69 cessary */. voi
23fa0 64 20 76 6f 6c 61 74 69 6c 65 20 2a 2a 70 70 20 d volatile **pp
23fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23fc0 4f 55 54 3a 20 4d 61 70 70 65 64 20 6d 65 6d 6f OUT: Mapped memo
23fd0 72 79 20 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 46 ry */.){. unixF
23fe0 69 6c 65 20 2a 70 44 62 46 64 20 3d 20 28 75 6e ile *pDbFd = (un
23ff0 69 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20 75 6e ixFile*)fd;. un
24000 69 78 53 68 6d 20 2a 70 3b 0a 20 20 75 6e 69 78 ixShm *p;. unix
24010 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f 64 ShmNode *pShmNod
24020 65 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 e;. int rc = SQ
24030 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e LITE_OK;. int n
24040 53 68 6d 50 65 72 4d 61 70 20 3d 20 75 6e 69 78 ShmPerMap = unix
24050 53 68 6d 52 65 67 69 6f 6e 50 65 72 4d 61 70 28 ShmRegionPerMap(
24060 29 3b 0a 20 20 69 6e 74 20 6e 52 65 71 52 65 67 );. int nReqReg
24070 69 6f 6e 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 ion;.. /* If th
24080 65 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 e shared-memory
24090 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 79 65 74 file has not yet
240a0 20 62 65 65 6e 20 6f 70 65 6e 65 64 2c 20 6f 70 been opened, op
240b0 65 6e 20 69 74 20 6e 6f 77 2e 20 2a 2f 0a 20 20 en it now. */.
240c0 69 66 28 20 70 44 62 46 64 2d 3e 70 53 68 6d 3d if( pDbFd->pShm=
240d0 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 75 =0 ){. rc = u
240e0 6e 69 78 4f 70 65 6e 53 68 61 72 65 64 4d 65 6d nixOpenSharedMem
240f0 6f 72 79 28 70 44 62 46 64 29 3b 0a 20 20 20 20 ory(pDbFd);.
24100 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
24110 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 K ) return rc;.
24120 20 7d 0a 0a 20 20 70 20 3d 20 70 44 62 46 64 2d }.. p = pDbFd-
24130 3e 70 53 68 6d 3b 0a 20 20 70 53 68 6d 4e 6f 64 >pShm;. pShmNod
24140 65 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f 64 65 3b e = p->pShmNode;
24150 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
24160 5f 65 6e 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d _enter(pShmNode-
24170 3e 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65 72 >mutex);. asser
24180 74 28 20 73 7a 52 65 67 69 6f 6e 3d 3d 70 53 68 t( szRegion==pSh
24190 6d 4e 6f 64 65 2d 3e 73 7a 52 65 67 69 6f 6e 20 mNode->szRegion
241a0 7c 7c 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 || pShmNode->nRe
241b0 67 69 6f 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73 gion==0 );. ass
241c0 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 ert( pShmNode->p
241d0 49 6e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 Inode==pDbFd->pI
241e0 6e 6f 64 65 20 29 3b 0a 20 20 61 73 73 65 72 74 node );. assert
241f0 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 68 3e 3d 30 ( pShmNode->h>=0
24200 20 7c 7c 20 70 44 62 46 64 2d 3e 70 49 6e 6f 64 || pDbFd->pInod
24210 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b 3d e->bProcessLock=
24220 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =1 );. assert(
24230 70 53 68 6d 4e 6f 64 65 2d 3e 68 3c 30 20 7c 7c pShmNode->h<0 ||
24240 20 70 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e pDbFd->pInode->
24250 62 50 72 6f 63 65 73 73 4c 6f 63 6b 3d 3d 30 20 bProcessLock==0
24260 29 3b 0a 0a 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d );.. /* Minimum
24270 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 67 69 6f number of regio
24280 6e 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 62 ns required to b
24290 65 20 6d 61 70 70 65 64 2e 20 2a 2f 0a 20 20 6e e mapped. */. n
242a0 52 65 71 52 65 67 69 6f 6e 20 3d 20 28 28 69 52 ReqRegion = ((iR
242b0 65 67 69 6f 6e 2b 6e 53 68 6d 50 65 72 4d 61 70 egion+nShmPerMap
242c0 29 20 2f 20 6e 53 68 6d 50 65 72 4d 61 70 29 20 ) / nShmPerMap)
242d0 2a 20 6e 53 68 6d 50 65 72 4d 61 70 3b 0a 0a 20 * nShmPerMap;..
242e0 20 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e if( pShmNode->n
242f0 52 65 67 69 6f 6e 3c 6e 52 65 71 52 65 67 69 6f Region<nReqRegio
24300 6e 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 2a n ){. char **
24310 61 70 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 apNew;
24320 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
24330 65 77 20 61 70 52 65 67 69 6f 6e 5b 5d 20 61 72 ew apRegion[] ar
24340 72 61 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e ray */. int n
24350 42 79 74 65 20 3d 20 6e 52 65 71 52 65 67 69 6f Byte = nReqRegio
24360 6e 2a 73 7a 52 65 67 69 6f 6e 3b 20 20 20 2f 2a n*szRegion; /*
24370 20 4d 69 6e 69 6d 75 6d 20 72 65 71 75 69 72 65 Minimum require
24380 64 20 66 69 6c 65 20 73 69 7a 65 20 2a 2f 0a 20 d file size */.
24390 20 20 20 73 74 72 75 63 74 20 73 74 61 74 20 73 struct stat s
243a0 53 74 61 74 3b 20 20 20 20 20 20 20 20 20 20 20 Stat;
243b0 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 62 79 /* Used by
243c0 20 66 73 74 61 74 28 29 20 2a 2f 0a 0a 20 20 20 fstat() */..
243d0 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 7a 52 65 67 pShmNode->szReg
243e0 69 6f 6e 20 3d 20 73 7a 52 65 67 69 6f 6e 3b 0a ion = szRegion;.
243f0 0a 20 20 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 . if( pShmNod
24400 65 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 20 20 20 e->h>=0 ){.
24410 20 2f 2a 20 54 68 65 20 72 65 71 75 65 73 74 65 /* The requeste
24420 64 20 72 65 67 69 6f 6e 20 69 73 20 6e 6f 74 20 d region is not
24430 6d 61 70 70 65 64 20 69 6e 74 6f 20 74 68 69 73 mapped into this
24440 20 70 72 6f 63 65 73 73 65 73 20 61 64 64 72 65 processes addre
24450 73 73 20 73 70 61 63 65 2e 0a 20 20 20 20 20 20 ss space..
24460 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20 ** Check to see
24470 69 66 20 69 74 20 68 61 73 20 62 65 65 6e 20 61 if it has been a
24480 6c 6c 6f 63 61 74 65 64 20 28 69 2e 65 2e 20 69 llocated (i.e. i
24490 66 20 74 68 65 20 77 61 6c 2d 69 6e 64 65 78 20 f the wal-index
244a0 66 69 6c 65 20 69 73 0a 20 20 20 20 20 20 2a 2a file is. **
244b0 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 74 6f large enough to
244c0 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 72 65 71 contain the req
244d0 75 65 73 74 65 64 20 72 65 67 69 6f 6e 29 2e 0a uested region)..
244e0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
244f0 66 28 20 6f 73 46 73 74 61 74 28 70 53 68 6d 4e f( osFstat(pShmN
24500 6f 64 65 2d 3e 68 2c 20 26 73 53 74 61 74 29 20 ode->h, &sStat)
24510 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
24520 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d SQLITE_IOERR_SHM
24530 53 49 5a 45 3b 0a 20 20 20 20 20 20 20 20 67 6f SIZE;. go
24540 74 6f 20 73 68 6d 70 61 67 65 5f 6f 75 74 3b 0a to shmpage_out;.
24550 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 20 }. .
24560 20 69 66 28 20 73 53 74 61 74 2e 73 74 5f 73 69 if( sStat.st_si
24570 7a 65 3c 6e 42 79 74 65 20 29 7b 0a 20 20 20 20 ze<nByte ){.
24580 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65 /* The reque
24590 73 74 65 64 20 6d 65 6d 6f 72 79 20 72 65 67 69 sted memory regi
245a0 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 on does not exis
245b0 74 2e 20 49 66 20 62 45 78 74 65 6e 64 20 69 73 t. If bExtend is
245c0 20 73 65 74 20 74 6f 0a 20 20 20 20 20 20 20 20 set to.
245d0 2a 2a 20 66 61 6c 73 65 2c 20 65 78 69 74 20 65 ** false, exit e
245e0 61 72 6c 79 2e 20 2a 70 70 20 77 69 6c 6c 20 62 arly. *pp will b
245f0 65 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 61 6e e set to NULL an
24600 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 d SQLITE_OK retu
24610 72 6e 65 64 2e 0a 20 20 20 20 20 20 20 20 2a 2f rned.. */
24620 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 62 45 . if( !bE
24630 78 74 65 6e 64 20 29 7b 0a 20 20 20 20 20 20 20 xtend ){.
24640 20 20 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f goto shmpage_
24650 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a out;. }..
24660 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 74 65 72 /* Alter
24670 6e 61 74 69 76 65 6c 79 2c 20 69 66 20 62 45 78 natively, if bEx
24680 74 65 6e 64 20 69 73 20 74 72 75 65 2c 20 65 78 tend is true, ex
24690 74 65 6e 64 20 74 68 65 20 66 69 6c 65 2e 20 44 tend the file. D
246a0 6f 20 74 68 69 73 20 62 79 0a 20 20 20 20 20 20 o this by.
246b0 20 20 2a 2a 20 77 72 69 74 69 6e 67 20 61 20 73 ** writing a s
246c0 69 6e 67 6c 65 20 62 79 74 65 20 74 6f 20 74 68 ingle byte to th
246d0 65 20 65 6e 64 20 6f 66 20 65 61 63 68 20 28 4f e end of each (O
246e0 53 29 20 70 61 67 65 20 62 65 69 6e 67 0a 20 20 S) page being.
246f0 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 ** allocat
24700 65 64 20 6f 72 20 65 78 74 65 6e 64 65 64 2e 20 ed or extended.
24710 54 65 63 68 6e 69 63 61 6c 6c 79 2c 20 77 65 20 Technically, we
24720 6e 65 65 64 20 6f 6e 6c 79 20 77 72 69 74 65 20 need only write
24730 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a to the. *
24740 2a 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 6f * last page in o
24750 72 64 65 72 20 74 6f 20 65 78 74 65 6e 64 20 74 rder to extend t
24760 68 65 20 66 69 6c 65 2e 20 42 75 74 20 77 72 69 he file. But wri
24770 74 69 6e 67 20 74 6f 20 61 6c 6c 20 6e 65 77 0a ting to all new.
24780 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 73 ** pages
24790 20 66 6f 72 63 65 73 20 74 68 65 20 4f 53 20 74 forces the OS t
247a0 6f 20 61 6c 6c 6f 63 61 74 65 20 74 68 65 6d 20 o allocate them
247b0 69 6d 6d 65 64 69 61 74 65 6c 79 2c 20 77 68 69 immediately, whi
247c0 63 68 20 72 65 64 75 63 65 73 0a 20 20 20 20 20 ch reduces.
247d0 20 20 20 2a 2a 20 74 68 65 20 63 68 61 6e 63 65 ** the chance
247e0 73 20 6f 66 20 53 49 47 42 55 53 20 77 68 69 6c s of SIGBUS whil
247f0 65 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 e accessing the
24800 6d 61 70 70 65 64 20 72 65 67 69 6f 6e 20 6c 61 mapped region la
24810 74 65 72 20 6f 6e 2e 0a 20 20 20 20 20 20 20 20 ter on..
24820 2a 2f 0a 20 20 20 20 20 20 20 20 65 6c 73 65 7b */. else{
24830 0a 20 20 20 20 20 20 20 20 20 20 73 74 61 74 69 . stati
24840 63 20 63 6f 6e 73 74 20 69 6e 74 20 70 67 73 7a c const int pgsz
24850 20 3d 20 34 30 39 36 3b 0a 20 20 20 20 20 20 20 = 4096;.
24860 20 20 20 69 6e 74 20 69 50 67 3b 0a 0a 20 20 20 int iPg;..
24870 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 /* Write
24880 74 6f 20 74 68 65 20 6c 61 73 74 20 62 79 74 65 to the last byte
24890 20 6f 66 20 65 61 63 68 20 6e 65 77 6c 79 20 61 of each newly a
248a0 6c 6c 6f 63 61 74 65 64 20 6f 72 20 65 78 74 65 llocated or exte
248b0 6e 64 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 20 nded page */.
248c0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 assert( (
248d0 6e 42 79 74 65 20 25 20 70 67 73 7a 29 3d 3d 30 nByte % pgsz)==0
248e0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f );. fo
248f0 72 28 69 50 67 3d 28 73 53 74 61 74 2e 73 74 5f r(iPg=(sStat.st_
24900 73 69 7a 65 2f 70 67 73 7a 29 3b 20 69 50 67 3c size/pgsz); iPg<
24910 28 6e 42 79 74 65 2f 70 67 73 7a 29 3b 20 69 50 (nByte/pgsz); iP
24920 67 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 g++){.
24930 20 20 69 6e 74 20 78 20 3d 20 30 3b 0a 20 20 20 int x = 0;.
24940 20 20 20 20 20 20 20 20 20 69 66 28 20 73 65 65 if( see
24950 6b 41 6e 64 57 72 69 74 65 46 64 28 70 53 68 6d kAndWriteFd(pShm
24960 4e 6f 64 65 2d 3e 68 2c 20 69 50 67 2a 70 67 73 Node->h, iPg*pgs
24970 7a 20 2b 20 70 67 73 7a 2d 31 2c 20 22 22 2c 20 z + pgsz-1, "",
24980 31 2c 20 26 78 29 21 3d 31 20 29 7b 0a 20 20 20 1, &x)!=1 ){.
24990 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
249a0 20 63 68 61 72 20 2a 7a 46 69 6c 65 20 3d 20 70 char *zFile = p
249b0 53 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61 ShmNode->zFilena
249c0 6d 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 me;.
249d0 20 20 72 63 20 3d 20 75 6e 69 78 4c 6f 67 45 72 rc = unixLogEr
249e0 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 ror(SQLITE_IOERR
249f0 5f 53 48 4d 53 49 5a 45 2c 20 22 77 72 69 74 65 _SHMSIZE, "write
24a00 22 2c 20 7a 46 69 6c 65 29 3b 0a 20 20 20 20 20 ", zFile);.
24a10 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 73 68 goto sh
24a20 6d 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 20 mpage_out;.
24a30 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
24a40 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
24a50 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 }. }..
24a60 20 20 2f 2a 20 4d 61 70 20 74 68 65 20 72 65 71 /* Map the req
24a70 75 65 73 74 65 64 20 6d 65 6d 6f 72 79 20 72 65 uested memory re
24a80 67 69 6f 6e 20 69 6e 74 6f 20 74 68 69 73 20 70 gion into this p
24a90 72 6f 63 65 73 73 65 73 20 61 64 64 72 65 73 73 rocesses address
24aa0 20 73 70 61 63 65 2e 20 2a 2f 0a 20 20 20 20 61 space. */. a
24ab0 70 4e 65 77 20 3d 20 28 63 68 61 72 20 2a 2a 29 pNew = (char **)
24ac0 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 sqlite3_realloc(
24ad0 0a 20 20 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 . pShmNod
24ae0 65 2d 3e 61 70 52 65 67 69 6f 6e 2c 20 6e 52 65 e->apRegion, nRe
24af0 71 52 65 67 69 6f 6e 2a 73 69 7a 65 6f 66 28 63 qRegion*sizeof(c
24b00 68 61 72 20 2a 29 0a 20 20 20 20 29 3b 0a 20 20 har *). );.
24b10 20 20 69 66 28 20 21 61 70 4e 65 77 20 29 7b 0a if( !apNew ){.
24b20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
24b30 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b E_IOERR_NOMEM_BK
24b40 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 73 PT;. goto s
24b50 68 6d 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 hmpage_out;.
24b60 7d 0a 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e }. pShmNode->
24b70 61 70 52 65 67 69 6f 6e 20 3d 20 61 70 4e 65 77 apRegion = apNew
24b80 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 53 68 ;. while( pSh
24b90 6d 4e 6f 64 65 2d 3e 6e 52 65 67 69 6f 6e 3c 6e mNode->nRegion<n
24ba0 52 65 71 52 65 67 69 6f 6e 20 29 7b 0a 20 20 20 ReqRegion ){.
24bb0 20 20 20 69 6e 74 20 6e 4d 61 70 20 3d 20 73 7a int nMap = sz
24bc0 52 65 67 69 6f 6e 2a 6e 53 68 6d 50 65 72 4d 61 Region*nShmPerMa
24bd0 70 3b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a p;. int i;.
24be0 20 20 20 20 20 20 76 6f 69 64 20 2a 70 4d 65 6d void *pMem
24bf0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 53 68 6d ;. if( pShm
24c00 4e 6f 64 65 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 Node->h>=0 ){.
24c10 20 20 20 20 20 20 70 4d 65 6d 20 3d 20 6f 73 4d pMem = osM
24c20 6d 61 70 28 30 2c 20 6e 4d 61 70 2c 0a 20 20 20 map(0, nMap,.
24c30 20 20 20 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 pShmNod
24c40 65 2d 3e 69 73 52 65 61 64 6f 6e 6c 79 20 3f 20 e->isReadonly ?
24c50 50 52 4f 54 5f 52 45 41 44 20 3a 20 50 52 4f 54 PROT_READ : PROT
24c60 5f 52 45 41 44 7c 50 52 4f 54 5f 57 52 49 54 45 _READ|PROT_WRITE
24c70 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 4d , . M
24c80 41 50 5f 53 48 41 52 45 44 2c 20 70 53 68 6d 4e AP_SHARED, pShmN
24c90 6f 64 65 2d 3e 68 2c 20 73 7a 52 65 67 69 6f 6e ode->h, szRegion
24ca0 2a 28 69 36 34 29 70 53 68 6d 4e 6f 64 65 2d 3e *(i64)pShmNode->
24cb0 6e 52 65 67 69 6f 6e 0a 20 20 20 20 20 20 20 20 nRegion.
24cc0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
24cd0 4d 65 6d 3d 3d 4d 41 50 5f 46 41 49 4c 45 44 20 Mem==MAP_FAILED
24ce0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
24cf0 3d 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 = unixLogError(S
24d00 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4d QLITE_IOERR_SHMM
24d10 41 50 2c 20 22 6d 6d 61 70 22 2c 20 70 53 68 6d AP, "mmap", pShm
24d20 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 Node->zFilename)
24d30 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
24d40 20 73 68 6d 70 61 67 65 5f 6f 75 74 3b 0a 20 20 shmpage_out;.
24d50 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 }. }e
24d60 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 lse{. pMe
24d70 6d 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c m = sqlite3_mall
24d80 6f 63 36 34 28 73 7a 52 65 67 69 6f 6e 29 3b 0a oc64(szRegion);.
24d90 20 20 20 20 20 20 20 20 69 66 28 20 70 4d 65 6d if( pMem
24da0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
24db0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
24dc0 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 EM_BKPT;.
24dd0 20 20 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f goto shmpage_
24de0 6f 75 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 out;. }.
24df0 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 4d memset(pM
24e00 65 6d 2c 20 30 2c 20 73 7a 52 65 67 69 6f 6e 29 em, 0, szRegion)
24e10 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
24e20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 53 68 6d for(i=0; i<nShm
24e30 50 65 72 4d 61 70 3b 20 69 2b 2b 29 7b 0a 20 20 PerMap; i++){.
24e40 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e pShmNode->
24e50 61 70 52 65 67 69 6f 6e 5b 70 53 68 6d 4e 6f 64 apRegion[pShmNod
24e60 65 2d 3e 6e 52 65 67 69 6f 6e 2b 69 5d 20 3d 20 e->nRegion+i] =
24e70 26 28 28 63 68 61 72 2a 29 70 4d 65 6d 29 5b 73 &((char*)pMem)[s
24e80 7a 52 65 67 69 6f 6e 2a 69 5d 3b 0a 20 20 20 20 zRegion*i];.
24e90 20 20 7d 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f }. pShmNo
24ea0 64 65 2d 3e 6e 52 65 67 69 6f 6e 20 2b 3d 20 6e de->nRegion += n
24eb0 53 68 6d 50 65 72 4d 61 70 3b 0a 20 20 20 20 7d ShmPerMap;. }
24ec0 0a 20 20 7d 0a 0a 73 68 6d 70 61 67 65 5f 6f 75 . }..shmpage_ou
24ed0 74 3a 0a 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 t:. if( pShmNod
24ee0 65 2d 3e 6e 52 65 67 69 6f 6e 3e 69 52 65 67 69 e->nRegion>iRegi
24ef0 6f 6e 20 29 7b 0a 20 20 20 20 2a 70 70 20 3d 20 on ){. *pp =
24f00 70 53 68 6d 4e 6f 64 65 2d 3e 61 70 52 65 67 69 pShmNode->apRegi
24f10 6f 6e 5b 69 52 65 67 69 6f 6e 5d 3b 0a 20 20 7d on[iRegion];. }
24f20 65 6c 73 65 7b 0a 20 20 20 20 2a 70 70 20 3d 20 else{. *pp =
24f30 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 53 68 0;. }. if( pSh
24f40 6d 4e 6f 64 65 2d 3e 69 73 52 65 61 64 6f 6e 6c mNode->isReadonl
24f50 79 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f y && rc==SQLITE_
24f60 4f 4b 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 OK ) rc = SQLITE
24f70 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 73 71 6c _READONLY;. sql
24f80 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
24f90 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 (pShmNode->mutex
24fa0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
24fb0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 }../*.** Change
24fc0 74 68 65 20 6c 6f 63 6b 20 73 74 61 74 65 20 66 the lock state f
24fd0 6f 72 20 61 20 73 68 61 72 65 64 2d 6d 65 6d 6f or a shared-memo
24fe0 72 79 20 73 65 67 6d 65 6e 74 2e 0a 2a 2a 0a 2a ry segment..**.*
24ff0 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 * Note that the
25000 72 65 6c 61 74 69 6f 6e 73 68 69 70 20 62 65 74 relationship bet
25010 77 65 65 6e 20 53 48 41 52 45 64 20 61 6e 64 20 ween SHAREd and
25020 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 73 20 EXCLUSIVE locks
25030 69 73 20 61 20 6c 69 74 74 6c 65 0a 2a 2a 20 64 is a little.** d
25040 69 66 66 65 72 65 6e 74 20 68 65 72 65 20 74 68 ifferent here th
25050 61 6e 20 69 6e 20 70 6f 73 69 78 2e 20 20 49 6e an in posix. In
25060 20 78 53 68 6d 4c 6f 63 6b 28 29 2c 20 6f 6e 65 xShmLock(), one
25070 20 63 61 6e 20 67 6f 20 66 72 6f 6d 20 75 6e 6c can go from unl
25080 6f 63 6b 65 64 0a 2a 2a 20 74 6f 20 73 68 61 72 ocked.** to shar
25090 65 64 20 61 6e 64 20 62 61 63 6b 20 6f 72 20 66 ed and back or f
250a0 72 6f 6d 20 75 6e 6c 6f 63 6b 65 64 20 74 6f 20 rom unlocked to
250b0 65 78 63 6c 75 73 69 76 65 20 61 6e 64 20 62 61 exclusive and ba
250c0 63 6b 2e 20 20 42 75 74 20 6f 6e 65 20 6d 61 79 ck. But one may
250d0 0a 2a 2a 20 6e 6f 74 20 67 6f 20 66 72 6f 6d 20 .** not go from
250e0 73 68 61 72 65 64 20 74 6f 20 65 78 63 6c 75 73 shared to exclus
250f0 69 76 65 20 6f 72 20 66 72 6f 6d 20 65 78 63 6c ive or from excl
25100 75 73 69 76 65 20 74 6f 20 73 68 61 72 65 64 2e usive to shared.
25110 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
25120 6e 69 78 53 68 6d 4c 6f 63 6b 28 0a 20 20 73 71 nixShmLock(. sq
25130 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 lite3_file *fd,
25140 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 /* Data
25150 62 61 73 65 20 66 69 6c 65 20 68 6f 6c 64 69 6e base file holdin
25160 67 20 74 68 65 20 73 68 61 72 65 64 20 6d 65 6d g the shared mem
25170 6f 72 79 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 73 ory */. int ofs
25180 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
25190 20 20 20 20 2f 2a 20 46 69 72 73 74 20 6c 6f 63 /* First loc
251a0 6b 20 74 6f 20 61 63 71 75 69 72 65 20 6f 72 20 k to acquire or
251b0 72 65 6c 65 61 73 65 20 2a 2f 0a 20 20 69 6e 74 release */. int
251c0 20 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 n,
251d0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
251e0 72 20 6f 66 20 6c 6f 63 6b 73 20 74 6f 20 61 63 r of locks to ac
251f0 71 75 69 72 65 20 6f 72 20 72 65 6c 65 61 73 65 quire or release
25200 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 */. int flags
25210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25220 20 2f 2a 20 57 68 61 74 20 74 6f 20 64 6f 20 77 /* What to do w
25230 69 74 68 20 74 68 65 20 6c 6f 63 6b 20 2a 2f 0a ith the lock */.
25240 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 ){. unixFile *p
25250 44 62 46 64 20 3d 20 28 75 6e 69 78 46 69 6c 65 DbFd = (unixFile
25260 2a 29 66 64 3b 20 20 20 20 20 20 2f 2a 20 43 6f *)fd; /* Co
25270 6e 6e 65 63 74 69 6f 6e 20 68 6f 6c 64 69 6e 67 nnection holding
25280 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 2a shared memory *
25290 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 20 3d /. unixShm *p =
252a0 20 70 44 62 46 64 2d 3e 70 53 68 6d 3b 20 20 20 pDbFd->pShm;
252b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
252c0 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 62 shared memory b
252d0 65 69 6e 67 20 6c 6f 63 6b 65 64 20 2a 2f 0a 20 eing locked */.
252e0 20 75 6e 69 78 53 68 6d 20 2a 70 58 3b 20 20 20 unixShm *pX;
252f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25300 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 6c 6f /* For lo
25310 6f 70 69 6e 67 20 6f 76 65 72 20 61 6c 6c 20 73 oping over all s
25320 69 62 6c 69 6e 67 73 20 2a 2f 0a 20 20 75 6e 69 iblings */. uni
25330 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f xShmNode *pShmNo
25340 64 65 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f 64 65 de = p->pShmNode
25350 3b 20 20 2f 2a 20 54 68 65 20 75 6e 64 65 72 6c ; /* The underl
25360 79 69 6e 67 20 66 69 6c 65 20 69 4e 6f 64 65 20 ying file iNode
25370 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 */. int rc = SQ
25380 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
25390 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
253a0 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 20 20 75 sult code */. u
253b0 31 36 20 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 16 mask;
253c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
253d0 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 /* Mask of
253e0 6c 6f 63 6b 73 20 74 6f 20 74 61 6b 65 20 6f 72 locks to take or
253f0 20 72 65 6c 65 61 73 65 20 2a 2f 0a 0a 20 20 61 release */.. a
25400 73 73 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 3d ssert( pShmNode=
25410 3d 70 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e =pDbFd->pInode->
25420 70 53 68 6d 4e 6f 64 65 20 29 3b 0a 20 20 61 73 pShmNode );. as
25430 73 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e sert( pShmNode->
25440 70 49 6e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 pInode==pDbFd->p
25450 49 6e 6f 64 65 20 29 3b 0a 20 20 61 73 73 65 72 Inode );. asser
25460 74 28 20 6f 66 73 74 3e 3d 30 20 26 26 20 6f 66 t( ofst>=0 && of
25470 73 74 2b 6e 3c 3d 53 51 4c 49 54 45 5f 53 48 4d st+n<=SQLITE_SHM
25480 5f 4e 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 _NLOCK );. asse
25490 72 74 28 20 6e 3e 3d 31 20 29 3b 0a 20 20 61 73 rt( n>=1 );. as
254a0 73 65 72 74 28 20 66 6c 61 67 73 3d 3d 28 53 51 sert( flags==(SQ
254b0 4c 49 54 45 5f 53 48 4d 5f 4c 4f 43 4b 20 7c 20 LITE_SHM_LOCK |
254c0 53 51 4c 49 54 45 5f 53 48 4d 5f 53 48 41 52 45 SQLITE_SHM_SHARE
254d0 44 29 0a 20 20 20 20 20 20 20 7c 7c 20 66 6c 61 D). || fla
254e0 67 73 3d 3d 28 53 51 4c 49 54 45 5f 53 48 4d 5f gs==(SQLITE_SHM_
254f0 4c 4f 43 4b 20 7c 20 53 51 4c 49 54 45 5f 53 48 LOCK | SQLITE_SH
25500 4d 5f 45 58 43 4c 55 53 49 56 45 29 0a 20 20 20 M_EXCLUSIVE).
25510 20 20 20 20 7c 7c 20 66 6c 61 67 73 3d 3d 28 53 || flags==(S
25520 51 4c 49 54 45 5f 53 48 4d 5f 55 4e 4c 4f 43 4b QLITE_SHM_UNLOCK
25530 20 7c 20 53 51 4c 49 54 45 5f 53 48 4d 5f 53 48 | SQLITE_SHM_SH
25540 41 52 45 44 29 0a 20 20 20 20 20 20 20 7c 7c 20 ARED). ||
25550 66 6c 61 67 73 3d 3d 28 53 51 4c 49 54 45 5f 53 flags==(SQLITE_S
25560 48 4d 5f 55 4e 4c 4f 43 4b 20 7c 20 53 51 4c 49 HM_UNLOCK | SQLI
25570 54 45 5f 53 48 4d 5f 45 58 43 4c 55 53 49 56 45 TE_SHM_EXCLUSIVE
25580 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e ) );. assert( n
25590 3d 3d 31 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 ==1 || (flags &
255a0 53 51 4c 49 54 45 5f 53 48 4d 5f 45 58 43 4c 55 SQLITE_SHM_EXCLU
255b0 53 49 56 45 29 21 3d 30 20 29 3b 0a 20 20 61 73 SIVE)!=0 );. as
255c0 73 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e sert( pShmNode->
255d0 68 3e 3d 30 20 7c 7c 20 70 44 62 46 64 2d 3e 70 h>=0 || pDbFd->p
255e0 49 6e 6f 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c Inode->bProcessL
255f0 6f 63 6b 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 ock==1 );. asse
25600 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 68 3c rt( pShmNode->h<
25610 30 20 7c 7c 20 70 44 62 46 64 2d 3e 70 49 6e 6f 0 || pDbFd->pIno
25620 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b de->bProcessLock
25630 3d 3d 30 20 29 3b 0a 0a 20 20 6d 61 73 6b 20 3d ==0 );.. mask =
25640 20 28 31 3c 3c 28 6f 66 73 74 2b 6e 29 29 20 2d (1<<(ofst+n)) -
25650 20 28 31 3c 3c 6f 66 73 74 29 3b 0a 20 20 61 73 (1<<ofst);. as
25660 73 65 72 74 28 20 6e 3e 31 20 7c 7c 20 6d 61 73 sert( n>1 || mas
25670 6b 3d 3d 28 31 3c 3c 6f 66 73 74 29 20 29 3b 0a k==(1<<ofst) );.
25680 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
25690 65 6e 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d 3e enter(pShmNode->
256a0 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 66 6c mutex);. if( fl
256b0 61 67 73 20 26 20 53 51 4c 49 54 45 5f 53 48 4d ags & SQLITE_SHM
256c0 5f 55 4e 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 75 _UNLOCK ){. u
256d0 31 36 20 61 6c 6c 4d 61 73 6b 20 3d 20 30 3b 20 16 allMask = 0;
256e0 2f 2a 20 4d 61 73 6b 20 6f 66 20 6c 6f 63 6b 73 /* Mask of locks
256f0 20 68 65 6c 64 20 62 79 20 73 69 62 6c 69 6e 67 held by sibling
25700 73 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 53 65 65 s */.. /* See
25710 20 69 66 20 61 6e 79 20 73 69 62 6c 69 6e 67 73 if any siblings
25720 20 68 6f 6c 64 20 74 68 69 73 20 73 61 6d 65 20 hold this same
25730 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 66 6f 72 28 lock */. for(
25740 70 58 3d 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 pX=pShmNode->pFi
25750 72 73 74 3b 20 70 58 3b 20 70 58 3d 70 58 2d 3e rst; pX; pX=pX->
25760 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 69 66 pNext){. if
25770 28 20 70 58 3d 3d 70 20 29 20 63 6f 6e 74 69 6e ( pX==p ) contin
25780 75 65 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ue;. assert
25790 28 20 28 70 58 2d 3e 65 78 63 6c 4d 61 73 6b 20 ( (pX->exclMask
257a0 26 20 28 70 2d 3e 65 78 63 6c 4d 61 73 6b 7c 70 & (p->exclMask|p
257b0 2d 3e 73 68 61 72 65 64 4d 61 73 6b 29 29 3d 3d ->sharedMask))==
257c0 30 20 29 3b 0a 20 20 20 20 20 20 61 6c 6c 4d 61 0 );. allMa
257d0 73 6b 20 7c 3d 20 70 58 2d 3e 73 68 61 72 65 64 sk |= pX->shared
257e0 4d 61 73 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 Mask;. }..
257f0 20 2f 2a 20 55 6e 6c 6f 63 6b 20 74 68 65 20 73 /* Unlock the s
25800 79 73 74 65 6d 2d 6c 65 76 65 6c 20 6c 6f 63 6b ystem-level lock
25810 73 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 6d 61 s */. if( (ma
25820 73 6b 20 26 20 61 6c 6c 4d 61 73 6b 29 3d 3d 30 sk & allMask)==0
25830 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 75 ){. rc = u
25840 6e 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b nixShmSystemLock
25850 28 70 44 62 46 64 2c 20 46 5f 55 4e 4c 43 4b 2c (pDbFd, F_UNLCK,
25860 20 6f 66 73 74 2b 55 4e 49 58 5f 53 48 4d 5f 42 ofst+UNIX_SHM_B
25870 41 53 45 2c 20 6e 29 3b 0a 20 20 20 20 7d 65 6c ASE, n);. }el
25880 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
25890 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
258a0 0a 20 20 20 20 2f 2a 20 55 6e 64 6f 20 74 68 65 . /* Undo the
258b0 20 6c 6f 63 61 6c 20 6c 6f 63 6b 73 20 2a 2f 0a local locks */.
258c0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
258d0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 TE_OK ){. p
258e0 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 3d 20 7e 6d ->exclMask &= ~m
258f0 61 73 6b 3b 0a 20 20 20 20 20 20 70 2d 3e 73 68 ask;. p->sh
25900 61 72 65 64 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 aredMask &= ~mas
25910 6b 3b 0a 20 20 20 20 7d 20 0a 20 20 7d 65 6c 73 k;. } . }els
25920 65 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 e if( flags & SQ
25930 4c 49 54 45 5f 53 48 4d 5f 53 48 41 52 45 44 20 LITE_SHM_SHARED
25940 29 7b 0a 20 20 20 20 75 31 36 20 61 6c 6c 53 68 ){. u16 allSh
25950 61 72 65 64 20 3d 20 30 3b 20 20 2f 2a 20 55 6e ared = 0; /* Un
25960 69 6f 6e 20 6f 66 20 6c 6f 63 6b 73 20 68 65 6c ion of locks hel
25970 64 20 62 79 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 d by connections
25980 20 6f 74 68 65 72 20 74 68 61 6e 20 22 70 22 20 other than "p"
25990 2a 2f 0a 0a 20 20 20 20 2f 2a 20 46 69 6e 64 20 */.. /* Find
259a0 6f 75 74 20 77 68 69 63 68 20 73 68 61 72 65 64 out which shared
259b0 20 6c 6f 63 6b 73 20 61 72 65 20 61 6c 72 65 61 locks are alrea
259c0 64 79 20 68 65 6c 64 20 62 79 20 73 69 62 6c 69 dy held by sibli
259d0 6e 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0a ng connections..
259e0 20 20 20 20 2a 2a 20 49 66 20 61 6e 79 20 73 69 ** If any si
259f0 62 6c 69 6e 67 20 61 6c 72 65 61 64 79 20 68 6f bling already ho
25a00 6c 64 73 20 61 6e 20 65 78 63 6c 75 73 69 76 65 lds an exclusive
25a10 20 6c 6f 63 6b 2c 20 67 6f 20 61 68 65 61 64 20 lock, go ahead
25a20 61 6e 64 20 72 65 74 75 72 6e 0a 20 20 20 20 2a and return. *
25a30 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 0a 20 * SQLITE_BUSY..
25a40 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 58 */. for(pX
25a50 3d 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 =pShmNode->pFirs
25a60 74 3b 20 70 58 3b 20 70 58 3d 70 58 2d 3e 70 4e t; pX; pX=pX->pN
25a70 65 78 74 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ext){. if(
25a80 28 70 58 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 20 (pX->exclMask &
25a90 6d 61 73 6b 29 21 3d 30 20 29 7b 0a 20 20 20 20 mask)!=0 ){.
25aa0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
25ab0 42 55 53 59 3b 0a 20 20 20 20 20 20 20 20 62 72 BUSY;. br
25ac0 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 eak;. }.
25ad0 20 20 20 61 6c 6c 53 68 61 72 65 64 20 7c 3d 20 allShared |=
25ae0 70 58 2d 3e 73 68 61 72 65 64 4d 61 73 6b 3b 0a pX->sharedMask;.
25af0 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 47 65 }.. /* Ge
25b00 74 20 73 68 61 72 65 64 20 6c 6f 63 6b 73 20 61 t shared locks a
25b10 74 20 74 68 65 20 73 79 73 74 65 6d 20 6c 65 76 t the system lev
25b20 65 6c 2c 20 69 66 20 6e 65 63 65 73 73 61 72 79 el, if necessary
25b30 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d */. if( rc==
25b40 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
25b50 20 20 20 69 66 28 20 28 61 6c 6c 53 68 61 72 65 if( (allShare
25b60 64 20 26 20 6d 61 73 6b 29 3d 3d 30 20 29 7b 0a d & mask)==0 ){.
25b70 20 20 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 rc = uni
25b80 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 70 xShmSystemLock(p
25b90 44 62 46 64 2c 20 46 5f 52 44 4c 43 4b 2c 20 6f DbFd, F_RDLCK, o
25ba0 66 73 74 2b 55 4e 49 58 5f 53 48 4d 5f 42 41 53 fst+UNIX_SHM_BAS
25bb0 45 2c 20 6e 29 3b 0a 20 20 20 20 20 20 7d 65 6c E, n);. }el
25bc0 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d se{. rc =
25bd0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
25be0 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f }. }.. /
25bf0 2a 20 47 65 74 20 74 68 65 20 6c 6f 63 61 6c 20 * Get the local
25c00 73 68 61 72 65 64 20 6c 6f 63 6b 73 20 2a 2f 0a shared locks */.
25c10 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
25c20 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 TE_OK ){. p
25c30 2d 3e 73 68 61 72 65 64 4d 61 73 6b 20 7c 3d 20 ->sharedMask |=
25c40 6d 61 73 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 mask;. }. }e
25c50 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 lse{. /* Make
25c60 20 73 75 72 65 20 6e 6f 20 73 69 62 6c 69 6e 67 sure no sibling
25c70 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 68 6f 6c connections hol
25c80 64 20 6c 6f 63 6b 73 20 74 68 61 74 20 77 69 6c d locks that wil
25c90 6c 20 62 6c 6f 63 6b 20 74 68 69 73 0a 20 20 20 l block this.
25ca0 20 2a 2a 20 6c 6f 63 6b 2e 20 20 49 66 20 61 6e ** lock. If an
25cb0 79 20 64 6f 2c 20 72 65 74 75 72 6e 20 53 51 4c y do, return SQL
25cc0 49 54 45 5f 42 55 53 59 20 72 69 67 68 74 20 61 ITE_BUSY right a
25cd0 77 61 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 way.. */.
25ce0 66 6f 72 28 70 58 3d 70 53 68 6d 4e 6f 64 65 2d for(pX=pShmNode-
25cf0 3e 70 46 69 72 73 74 3b 20 70 58 3b 20 70 58 3d >pFirst; pX; pX=
25d00 70 58 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 pX->pNext){.
25d10 20 20 69 66 28 20 28 70 58 2d 3e 65 78 63 6c 4d if( (pX->exclM
25d20 61 73 6b 20 26 20 6d 61 73 6b 29 21 3d 30 20 7c ask & mask)!=0 |
25d30 7c 20 28 70 58 2d 3e 73 68 61 72 65 64 4d 61 73 | (pX->sharedMas
25d40 6b 20 26 20 6d 61 73 6b 29 21 3d 30 20 29 7b 0a k & mask)!=0 ){.
25d50 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
25d60 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 ITE_BUSY;.
25d70 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d break;. }
25d80 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a . }. . /*
25d90 20 47 65 74 20 74 68 65 20 65 78 63 6c 75 73 69 Get the exclusi
25da0 76 65 20 6c 6f 63 6b 73 20 61 74 20 74 68 65 20 ve locks at the
25db0 73 79 73 74 65 6d 20 6c 65 76 65 6c 2e 20 20 54 system level. T
25dc0 68 65 6e 20 69 66 20 73 75 63 63 65 73 73 66 75 hen if successfu
25dd0 6c 0a 20 20 20 20 2a 2a 20 61 6c 73 6f 20 6d 61 l. ** also ma
25de0 72 6b 20 74 68 65 20 6c 6f 63 61 6c 20 63 6f 6e rk the local con
25df0 6e 65 63 74 69 6f 6e 20 61 73 20 62 65 69 6e 67 nection as being
25e00 20 6c 6f 63 6b 65 64 2e 0a 20 20 20 20 2a 2f 0a locked.. */.
25e10 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
25e20 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
25e30 63 20 3d 20 75 6e 69 78 53 68 6d 53 79 73 74 65 c = unixShmSyste
25e40 6d 4c 6f 63 6b 28 70 44 62 46 64 2c 20 46 5f 57 mLock(pDbFd, F_W
25e50 52 4c 43 4b 2c 20 6f 66 73 74 2b 55 4e 49 58 5f RLCK, ofst+UNIX_
25e60 53 48 4d 5f 42 41 53 45 2c 20 6e 29 3b 0a 20 20 SHM_BASE, n);.
25e70 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
25e80 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
25e90 20 61 73 73 65 72 74 28 20 28 70 2d 3e 73 68 61 assert( (p->sha
25ea0 72 65 64 4d 61 73 6b 20 26 20 6d 61 73 6b 29 3d redMask & mask)=
25eb0 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 70 2d =0 );. p-
25ec0 3e 65 78 63 6c 4d 61 73 6b 20 7c 3d 20 6d 61 73 >exclMask |= mas
25ed0 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
25ee0 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
25ef0 75 74 65 78 5f 6c 65 61 76 65 28 70 53 68 6d 4e utex_leave(pShmN
25f00 6f 64 65 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 4f ode->mutex);. O
25f10 53 54 52 41 43 45 28 28 22 53 48 4d 2d 4c 4f 43 STRACE(("SHM-LOC
25f20 4b 20 73 68 6d 69 64 2d 25 64 2c 20 70 69 64 2d K shmid-%d, pid-
25f30 25 64 20 67 6f 74 20 25 30 33 78 2c 25 30 33 78 %d got %03x,%03x
25f40 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
25f50 70 2d 3e 69 64 2c 20 6f 73 47 65 74 70 69 64 28 p->id, osGetpid(
25f60 30 29 2c 20 70 2d 3e 73 68 61 72 65 64 4d 61 73 0), p->sharedMas
25f70 6b 2c 20 70 2d 3e 65 78 63 6c 4d 61 73 6b 29 29 k, p->exclMask))
25f80 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
25f90 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e ../*.** Implemen
25fa0 74 20 61 20 6d 65 6d 6f 72 79 20 62 61 72 72 69 t a memory barri
25fb0 65 72 20 6f 72 20 6d 65 6d 6f 72 79 20 66 65 6e er or memory fen
25fc0 63 65 20 6f 6e 20 73 68 61 72 65 64 20 6d 65 6d ce on shared mem
25fd0 6f 72 79 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 6c 6c ory. .**.** All
25fe0 20 6c 6f 61 64 73 20 61 6e 64 20 73 74 6f 72 65 loads and store
25ff0 73 20 62 65 67 75 6e 20 62 65 66 6f 72 65 20 74 s begun before t
26000 68 65 20 62 61 72 72 69 65 72 20 6d 75 73 74 20 he barrier must
26010 63 6f 6d 70 6c 65 74 65 20 62 65 66 6f 72 65 0a complete before.
26020 2a 2a 20 61 6e 79 20 6c 6f 61 64 20 6f 72 20 73 ** any load or s
26030 74 6f 72 65 20 62 65 67 75 6e 20 61 66 74 65 72 tore begun after
26040 20 74 68 65 20 62 61 72 72 69 65 72 2e 0a 2a 2f the barrier..*/
26050 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69 .static void uni
26060 78 53 68 6d 42 61 72 72 69 65 72 28 0a 20 20 73 xShmBarrier(. s
26070 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 20 qlite3_file *fd
26080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
26090 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 20 * Database file
260a0 68 6f 6c 64 69 6e 67 20 74 68 65 20 73 68 61 72 holding the shar
260b0 65 64 20 6d 65 6d 6f 72 79 20 2a 2f 0a 29 7b 0a ed memory */.){.
260c0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
260d0 45 52 28 66 64 29 3b 0a 20 20 73 71 6c 69 74 65 ER(fd);. sqlite
260e0 33 4d 65 6d 6f 72 79 42 61 72 72 69 65 72 28 29 3MemoryBarrier()
260f0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 63 6f 6d ; /* com
26100 70 69 6c 65 72 2d 64 65 66 69 6e 65 64 20 6d 65 piler-defined me
26110 6d 6f 72 79 20 62 61 72 72 69 65 72 20 2a 2f 0a mory barrier */.
26120 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 unixEnterMutex
26130 28 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ();
26140 20 20 2f 2a 20 41 6c 73 6f 20 6d 75 74 65 78 2c /* Also mutex,
26150 20 66 6f 72 20 72 65 64 75 6e 64 61 6e 63 79 20 for redundancy
26160 2a 2f 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 */. unixLeaveMu
26170 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 tex();.}../*.**
26180 43 6c 6f 73 65 20 61 20 63 6f 6e 6e 65 63 74 69 Close a connecti
26190 6f 6e 20 74 6f 20 73 68 61 72 65 64 2d 6d 65 6d on to shared-mem
261a0 6f 72 79 2e 20 20 44 65 6c 65 74 65 20 74 68 65 ory. Delete the
261b0 20 75 6e 64 65 72 6c 79 69 6e 67 20 0a 2a 2a 20 underlying .**
261c0 73 74 6f 72 61 67 65 20 69 66 20 64 65 6c 65 74 storage if delet
261d0 65 46 6c 61 67 20 69 73 20 74 72 75 65 2e 0a 2a eFlag is true..*
261e0 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 *.** If there is
261f0 20 6e 6f 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 no shared memor
26200 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 y associated wit
26210 68 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e h the connection
26220 20 74 68 65 6e 20 74 68 69 73 0a 2a 2a 20 72 6f then this.** ro
26230 75 74 69 6e 65 20 69 73 20 61 20 68 61 72 6d 6c utine is a harml
26240 65 73 73 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 ess no-op..*/.st
26250 61 74 69 63 20 69 6e 74 20 75 6e 69 78 53 68 6d atic int unixShm
26260 55 6e 6d 61 70 28 0a 20 20 73 71 6c 69 74 65 33 Unmap(. sqlite3
26270 5f 66 69 6c 65 20 2a 66 64 2c 20 20 20 20 20 20 _file *fd,
26280 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
26290 75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62 underlying datab
262a0 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e ase file */. in
262b0 74 20 64 65 6c 65 74 65 46 6c 61 67 20 20 20 20 t deleteFlag
262c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
262d0 20 44 65 6c 65 74 65 20 73 68 61 72 65 64 2d 6d Delete shared-m
262e0 65 6d 6f 72 79 20 69 66 20 74 72 75 65 20 2a 2f emory if true */
262f0 0a 29 7b 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 .){. unixShm *p
26300 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
26310 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e /* The con
26320 6e 65 63 74 69 6f 6e 20 74 6f 20 62 65 20 63 6c nection to be cl
26330 6f 73 65 64 20 2a 2f 0a 20 20 75 6e 69 78 53 68 osed */. unixSh
26340 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f 64 65 3b mNode *pShmNode;
26350 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
26360 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 68 61 72 underlying shar
26370 65 64 2d 6d 65 6d 6f 72 79 20 66 69 6c 65 20 2a ed-memory file *
26380 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a 2a 70 70 /. unixShm **pp
26390 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
263a0 20 20 20 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 /* For loopi
263b0 6e 67 20 6f 76 65 72 20 73 69 62 6c 69 6e 67 20 ng over sibling
263c0 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 20 connections */.
263d0 20 75 6e 69 78 46 69 6c 65 20 2a 70 44 62 46 64 unixFile *pDbFd
263e0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
263f0 20 2f 2a 20 54 68 65 20 75 6e 64 65 72 6c 79 69 /* The underlyi
26400 6e 67 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ng database file
26410 20 2a 2f 0a 0a 20 20 70 44 62 46 64 20 3d 20 28 */.. pDbFd = (
26420 75 6e 69 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20 unixFile*)fd;.
26430 70 20 3d 20 70 44 62 46 64 2d 3e 70 53 68 6d 3b p = pDbFd->pShm;
26440 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 . if( p==0 ) re
26450 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
26460 20 20 70 53 68 6d 4e 6f 64 65 20 3d 20 70 2d 3e pShmNode = p->
26470 70 53 68 6d 4e 6f 64 65 3b 0a 0a 20 20 61 73 73 pShmNode;.. ass
26480 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 3d 3d 70 ert( pShmNode==p
26490 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 DbFd->pInode->pS
264a0 68 6d 4e 6f 64 65 20 29 3b 0a 20 20 61 73 73 65 hmNode );. asse
264b0 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 49 rt( pShmNode->pI
264c0 6e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e node==pDbFd->pIn
264d0 6f 64 65 20 29 3b 0a 0a 20 20 2f 2a 20 52 65 6d ode );.. /* Rem
264e0 6f 76 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 ove connection p
264f0 20 66 72 6f 6d 20 74 68 65 20 73 65 74 20 6f 66 from the set of
26500 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 73 73 connections ass
26510 6f 63 69 61 74 65 64 0a 20 20 2a 2a 20 77 69 74 ociated. ** wit
26520 68 20 70 53 68 6d 4e 6f 64 65 20 2a 2f 0a 20 20 h pShmNode */.
26530 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e sqlite3_mutex_en
26540 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d 3e 6d 75 ter(pShmNode->mu
26550 74 65 78 29 3b 0a 20 20 66 6f 72 28 70 70 3d 26 tex);. for(pp=&
26560 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74 pShmNode->pFirst
26570 3b 20 28 2a 70 70 29 21 3d 70 3b 20 70 70 20 3d ; (*pp)!=p; pp =
26580 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 29 7b &(*pp)->pNext){
26590 7d 0a 20 20 2a 70 70 20 3d 20 70 2d 3e 70 4e 65 }. *pp = p->pNe
265a0 78 74 3b 0a 0a 20 20 2f 2a 20 46 72 65 65 20 74 xt;.. /* Free t
265b0 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 20 he connection p
265c0 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 */. sqlite3_fre
265d0 65 28 70 29 3b 0a 20 20 70 44 62 46 64 2d 3e 70 e(p);. pDbFd->p
265e0 53 68 6d 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 Shm = 0;. sqlit
265f0 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 e3_mutex_leave(p
26600 53 68 6d 4e 6f 64 65 2d 3e 6d 75 74 65 78 29 3b ShmNode->mutex);
26610 0a 0a 20 20 2f 2a 20 49 66 20 70 53 68 6d 4e 6f .. /* If pShmNo
26620 64 65 2d 3e 6e 52 65 66 20 68 61 73 20 72 65 61 de->nRef has rea
26630 63 68 65 64 20 30 2c 20 74 68 65 6e 20 63 6c 6f ched 0, then clo
26640 73 65 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e se the underlyin
26650 67 0a 20 20 2a 2a 20 73 68 61 72 65 64 2d 6d 65 g. ** shared-me
26660 6d 6f 72 79 20 66 69 6c 65 2c 20 74 6f 6f 20 2a mory file, too *
26670 2f 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 /. unixEnterMut
26680 65 78 28 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ex();. assert(
26690 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 3e 30 pShmNode->nRef>0
266a0 20 29 3b 0a 20 20 70 53 68 6d 4e 6f 64 65 2d 3e );. pShmNode->
266b0 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 53 nRef--;. if( pS
266c0 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 3d 3d 30 20 hmNode->nRef==0
266d0 29 7b 0a 20 20 20 20 69 66 28 20 64 65 6c 65 74 ){. if( delet
266e0 65 46 6c 61 67 20 26 26 20 70 53 68 6d 4e 6f 64 eFlag && pShmNod
266f0 65 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 20 20 20 e->h>=0 ){.
26700 20 6f 73 55 6e 6c 69 6e 6b 28 70 53 68 6d 4e 6f osUnlink(pShmNo
26710 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a de->zFilename);.
26720 20 20 20 20 7d 0a 20 20 20 20 75 6e 69 78 53 68 }. unixSh
26730 6d 50 75 72 67 65 28 70 44 62 46 64 29 3b 0a 20 mPurge(pDbFd);.
26740 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 }. unixLeaveMu
26750 74 65 78 28 29 3b 0a 0a 20 20 72 65 74 75 72 6e tex();.. return
26760 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a SQLITE_OK;.}...
26770 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 75 #else.# define u
26780 6e 69 78 53 68 6d 4d 61 70 20 20 20 20 20 30 0a nixShmMap 0.
26790 23 20 64 65 66 69 6e 65 20 75 6e 69 78 53 68 6d # define unixShm
267a0 4c 6f 63 6b 20 20 20 20 30 0a 23 20 64 65 66 69 Lock 0.# defi
267b0 6e 65 20 75 6e 69 78 53 68 6d 42 61 72 72 69 65 ne unixShmBarrie
267c0 72 20 30 0a 23 20 64 65 66 69 6e 65 20 75 6e 69 r 0.# define uni
267d0 78 53 68 6d 55 6e 6d 61 70 20 20 20 30 0a 23 65 xShmUnmap 0.#e
267e0 6e 64 69 66 20 2f 2a 20 23 69 66 6e 64 65 66 20 ndif /* #ifndef
267f0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 20 SQLITE_OMIT_WAL
26800 2a 2f 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d */..#if SQLITE_M
26810 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 2f AX_MMAP_SIZE>0./
26820 2a 0a 2a 2a 20 49 66 20 69 74 20 69 73 20 63 75 *.** If it is cu
26830 72 72 65 6e 74 6c 79 20 6d 65 6d 6f 72 79 20 6d rrently memory m
26840 61 70 70 65 64 2c 20 75 6e 6d 61 70 20 66 69 6c apped, unmap fil
26850 65 20 70 46 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 e pFd..*/.static
26860 20 76 6f 69 64 20 75 6e 69 78 55 6e 6d 61 70 66 void unixUnmapf
26870 69 6c 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 ile(unixFile *pF
26880 64 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 46 d){. assert( pF
26890 64 2d 3e 6e 46 65 74 63 68 4f 75 74 3d 3d 30 20 d->nFetchOut==0
268a0 29 3b 0a 20 20 69 66 28 20 70 46 64 2d 3e 70 4d );. if( pFd->pM
268b0 61 70 52 65 67 69 6f 6e 20 29 7b 0a 20 20 20 20 apRegion ){.
268c0 6f 73 4d 75 6e 6d 61 70 28 70 46 64 2d 3e 70 4d osMunmap(pFd->pM
268d0 61 70 52 65 67 69 6f 6e 2c 20 70 46 64 2d 3e 6d apRegion, pFd->m
268e0 6d 61 70 53 69 7a 65 41 63 74 75 61 6c 29 3b 0a mapSizeActual);.
268f0 20 20 20 20 70 46 64 2d 3e 70 4d 61 70 52 65 67 pFd->pMapReg
26900 69 6f 6e 20 3d 20 30 3b 0a 20 20 20 20 70 46 64 ion = 0;. pFd
26910 2d 3e 6d 6d 61 70 53 69 7a 65 20 3d 20 30 3b 0a ->mmapSize = 0;.
26920 20 20 20 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a pFd->mmapSiz
26930 65 41 63 74 75 61 6c 20 3d 20 30 3b 0a 20 20 7d eActual = 0;. }
26940 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 .}../*.** Attemp
26950 74 20 74 6f 20 73 65 74 20 74 68 65 20 73 69 7a t to set the siz
26960 65 20 6f 66 20 74 68 65 20 6d 65 6d 6f 72 79 20 e of the memory
26970 6d 61 70 70 69 6e 67 20 6d 61 69 6e 74 61 69 6e mapping maintain
26980 65 64 20 62 79 20 66 69 6c 65 20 0a 2a 2a 20 64 ed by file .** d
26990 65 73 63 72 69 70 74 6f 72 20 70 46 64 20 74 6f escriptor pFd to
269a0 20 6e 4e 65 77 20 62 79 74 65 73 2e 20 41 6e 79 nNew bytes. Any
269b0 20 65 78 69 73 74 69 6e 67 20 6d 61 70 70 69 6e existing mappin
269c0 67 20 69 73 20 64 69 73 63 61 72 64 65 64 2e 0a g is discarded..
269d0 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 **.** If success
269e0 66 75 6c 2c 20 74 68 69 73 20 66 75 6e 63 74 69 ful, this functi
269f0 6f 6e 20 73 65 74 73 20 74 68 65 20 66 6f 6c 6c on sets the foll
26a00 6f 77 69 6e 67 20 76 61 72 69 61 62 6c 65 73 3a owing variables:
26a10 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 75 6e 69 .**.** uni
26a20 78 46 69 6c 65 2e 70 4d 61 70 52 65 67 69 6f 6e xFile.pMapRegion
26a30 0a 2a 2a 20 20 20 20 20 20 20 75 6e 69 78 46 69 .** unixFi
26a40 6c 65 2e 6d 6d 61 70 53 69 7a 65 0a 2a 2a 20 20 le.mmapSize.**
26a50 20 20 20 20 20 75 6e 69 78 46 69 6c 65 2e 6d 6d unixFile.mm
26a60 61 70 53 69 7a 65 41 63 74 75 61 6c 0a 2a 2a 0a apSizeActual.**.
26a70 2a 2a 20 49 66 20 75 6e 73 75 63 63 65 73 73 66 ** If unsuccessf
26a80 75 6c 2c 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 ul, an error mes
26a90 73 61 67 65 20 69 73 20 6c 6f 67 67 65 64 20 76 sage is logged v
26aa0 69 61 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 29 ia sqlite3_log()
26ab0 20 61 6e 64 0a 2a 2a 20 74 68 65 20 74 68 72 65 and.** the thre
26ac0 65 20 76 61 72 69 61 62 6c 65 73 20 61 62 6f 76 e variables abov
26ad0 65 20 61 72 65 20 7a 65 72 6f 65 64 2e 20 49 6e e are zeroed. In
26ae0 20 74 68 69 73 20 63 61 73 65 20 53 51 4c 69 74 this case SQLit
26af0 65 20 73 68 6f 75 6c 64 0a 2a 2a 20 63 6f 6e 74 e should.** cont
26b00 69 6e 75 65 20 61 63 63 65 73 73 69 6e 67 20 74 inue accessing t
26b10 68 65 20 64 61 74 61 62 61 73 65 20 75 73 69 6e he database usin
26b20 67 20 74 68 65 20 78 52 65 61 64 28 29 20 61 6e g the xRead() an
26b30 64 20 78 57 72 69 74 65 28 29 0a 2a 2a 20 6d 65 d xWrite().** me
26b40 74 68 6f 64 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 thods..*/.static
26b50 20 76 6f 69 64 20 75 6e 69 78 52 65 6d 61 70 66 void unixRemapf
26b60 69 6c 65 28 0a 20 20 75 6e 69 78 46 69 6c 65 20 ile(. unixFile
26b70 2a 70 46 64 2c 20 20 20 20 20 20 20 20 20 20 20 *pFd,
26b80 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 /* File d
26b90 65 73 63 72 69 70 74 6f 72 20 6f 62 6a 65 63 74 escriptor object
26ba0 20 2a 2f 0a 20 20 69 36 34 20 6e 4e 65 77 20 20 */. i64 nNew
26bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26bc0 20 20 20 20 20 20 2f 2a 20 52 65 71 75 69 72 65 /* Require
26bd0 64 20 6d 61 70 70 69 6e 67 20 73 69 7a 65 20 2a d mapping size *
26be0 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 /.){. const cha
26bf0 72 20 2a 7a 45 72 72 20 3d 20 22 6d 6d 61 70 22 r *zErr = "mmap"
26c00 3b 0a 20 20 69 6e 74 20 68 20 3d 20 70 46 64 2d ;. int h = pFd-
26c10 3e 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 >h;
26c20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 /* File
26c30 20 64 65 73 63 72 69 70 74 6f 72 20 6f 70 65 6e descriptor open
26c40 20 6f 6e 20 64 62 20 66 69 6c 65 20 2a 2f 0a 20 on db file */.
26c50 20 75 38 20 2a 70 4f 72 69 67 20 3d 20 28 75 38 u8 *pOrig = (u8
26c60 20 2a 29 70 46 64 2d 3e 70 4d 61 70 52 65 67 69 *)pFd->pMapRegi
26c70 6f 6e 3b 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 on; /* Pointer
26c80 20 74 6f 20 63 75 72 72 65 6e 74 20 66 69 6c 65 to current file
26c90 20 6d 61 70 70 69 6e 67 20 2a 2f 0a 20 20 69 36 mapping */. i6
26ca0 34 20 6e 4f 72 69 67 20 3d 20 70 46 64 2d 3e 6d 4 nOrig = pFd->m
26cb0 6d 61 70 53 69 7a 65 41 63 74 75 61 6c 3b 20 20 mapSizeActual;
26cc0 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 70 4f /* Size of pO
26cd0 72 69 67 20 72 65 67 69 6f 6e 20 69 6e 20 62 79 rig region in by
26ce0 74 65 73 20 2a 2f 0a 20 20 75 38 20 2a 70 4e 65 tes */. u8 *pNe
26cf0 77 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 w = 0;
26d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
26d10 20 4c 6f 63 61 74 69 6f 6e 20 6f 66 20 6e 65 77 Location of new
26d20 20 6d 61 70 70 69 6e 67 20 2a 2f 0a 20 20 69 6e mapping */. in
26d30 74 20 66 6c 61 67 73 20 3d 20 50 52 4f 54 5f 52 t flags = PROT_R
26d40 45 41 44 3b 20 20 20 20 20 20 20 20 20 20 20 20 EAD;
26d50 20 20 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 70 /* Flags to p
26d60 61 73 73 20 74 6f 20 6d 6d 61 70 28 29 20 2a 2f ass to mmap() */
26d70 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46 64 2d .. assert( pFd-
26d80 3e 6e 46 65 74 63 68 4f 75 74 3d 3d 30 20 29 3b >nFetchOut==0 );
26d90 0a 20 20 61 73 73 65 72 74 28 20 6e 4e 65 77 3e . assert( nNew>
26da0 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 20 29 3b pFd->mmapSize );
26db0 0a 20 20 61 73 73 65 72 74 28 20 6e 4e 65 77 3c . assert( nNew<
26dc0 3d 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 =pFd->mmapSizeMa
26dd0 78 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e x );. assert( n
26de0 4e 65 77 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 New>0 );. asser
26df0 74 28 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 t( pFd->mmapSize
26e00 41 63 74 75 61 6c 3e 3d 70 46 64 2d 3e 6d 6d 61 Actual>=pFd->mma
26e10 70 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 pSize );. asser
26e20 74 28 20 4d 41 50 5f 46 41 49 4c 45 44 21 3d 30 t( MAP_FAILED!=0
26e30 20 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 );..#ifdef SQLI
26e40 54 45 5f 4d 4d 41 50 5f 52 45 41 44 57 52 49 54 TE_MMAP_READWRIT
26e50 45 0a 20 20 69 66 28 20 28 70 46 64 2d 3e 63 74 E. if( (pFd->ct
26e60 72 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 rlFlags & UNIXFI
26e70 4c 45 5f 52 44 4f 4e 4c 59 29 3d 3d 30 20 29 20 LE_RDONLY)==0 )
26e80 66 6c 61 67 73 20 7c 3d 20 50 52 4f 54 5f 57 52 flags |= PROT_WR
26e90 49 54 45 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 ITE;.#endif.. i
26ea0 66 28 20 70 4f 72 69 67 20 29 7b 0a 23 69 66 20 f( pOrig ){.#if
26eb0 48 41 56 45 5f 4d 52 45 4d 41 50 0a 20 20 20 20 HAVE_MREMAP.
26ec0 69 36 34 20 6e 52 65 75 73 65 20 3d 20 70 46 64 i64 nReuse = pFd
26ed0 2d 3e 6d 6d 61 70 53 69 7a 65 3b 0a 23 65 6c 73 ->mmapSize;.#els
26ee0 65 0a 20 20 20 20 63 6f 6e 73 74 20 69 6e 74 20 e. const int
26ef0 73 7a 53 79 73 70 61 67 65 20 3d 20 6f 73 47 65 szSyspage = osGe
26f00 74 70 61 67 65 73 69 7a 65 28 29 3b 0a 20 20 20 tpagesize();.
26f10 20 69 36 34 20 6e 52 65 75 73 65 20 3d 20 28 70 i64 nReuse = (p
26f20 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 20 26 20 7e Fd->mmapSize & ~
26f30 28 73 7a 53 79 73 70 61 67 65 2d 31 29 29 3b 0a (szSyspage-1));.
26f40 23 65 6e 64 69 66 0a 20 20 20 20 75 38 20 2a 70 #endif. u8 *p
26f50 52 65 71 20 3d 20 26 70 4f 72 69 67 5b 6e 52 65 Req = &pOrig[nRe
26f60 75 73 65 5d 3b 0a 0a 20 20 20 20 2f 2a 20 55 6e use];.. /* Un
26f70 6d 61 70 20 61 6e 79 20 70 61 67 65 73 20 6f 66 map any pages of
26f80 20 74 68 65 20 65 78 69 73 74 69 6e 67 20 6d 61 the existing ma
26f90 70 70 69 6e 67 20 74 68 61 74 20 63 61 6e 6e 6f pping that canno
26fa0 74 20 62 65 20 72 65 75 73 65 64 2e 20 2a 2f 0a t be reused. */.
26fb0 20 20 20 20 69 66 28 20 6e 52 65 75 73 65 21 3d if( nReuse!=
26fc0 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 20 6f nOrig ){. o
26fd0 73 4d 75 6e 6d 61 70 28 70 52 65 71 2c 20 6e 4f sMunmap(pReq, nO
26fe0 72 69 67 2d 6e 52 65 75 73 65 29 3b 0a 20 20 20 rig-nReuse);.
26ff0 20 7d 0a 0a 23 69 66 20 48 41 56 45 5f 4d 52 45 }..#if HAVE_MRE
27000 4d 41 50 0a 20 20 20 20 70 4e 65 77 20 3d 20 6f MAP. pNew = o
27010 73 4d 72 65 6d 61 70 28 70 4f 72 69 67 2c 20 6e sMremap(pOrig, n
27020 52 65 75 73 65 2c 20 6e 4e 65 77 2c 20 4d 52 45 Reuse, nNew, MRE
27030 4d 41 50 5f 4d 41 59 4d 4f 56 45 29 3b 0a 20 20 MAP_MAYMOVE);.
27040 20 20 7a 45 72 72 20 3d 20 22 6d 72 65 6d 61 70 zErr = "mremap
27050 22 3b 0a 23 65 6c 73 65 0a 20 20 20 20 70 4e 65 ";.#else. pNe
27060 77 20 3d 20 6f 73 4d 6d 61 70 28 70 52 65 71 2c w = osMmap(pReq,
27070 20 6e 4e 65 77 2d 6e 52 65 75 73 65 2c 20 66 6c nNew-nReuse, fl
27080 61 67 73 2c 20 4d 41 50 5f 53 48 41 52 45 44 2c ags, MAP_SHARED,
27090 20 68 2c 20 6e 52 65 75 73 65 29 3b 0a 20 20 20 h, nReuse);.
270a0 20 69 66 28 20 70 4e 65 77 21 3d 4d 41 50 5f 46 if( pNew!=MAP_F
270b0 41 49 4c 45 44 20 29 7b 0a 20 20 20 20 20 20 69 AILED ){. i
270c0 66 28 20 70 4e 65 77 21 3d 70 52 65 71 20 29 7b f( pNew!=pReq ){
270d0 0a 20 20 20 20 20 20 20 20 6f 73 4d 75 6e 6d 61 . osMunma
270e0 70 28 70 4e 65 77 2c 20 6e 4e 65 77 20 2d 20 6e p(pNew, nNew - n
270f0 52 65 75 73 65 29 3b 0a 20 20 20 20 20 20 20 20 Reuse);.
27100 70 4e 65 77 20 3d 20 30 3b 0a 20 20 20 20 20 20 pNew = 0;.
27110 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 }else{. p
27120 4e 65 77 20 3d 20 70 4f 72 69 67 3b 0a 20 20 20 New = pOrig;.
27130 20 20 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 }. }.#endi
27140 66 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 61 74 f.. /* The at
27150 74 65 6d 70 74 20 74 6f 20 65 78 74 65 6e 64 20 tempt to extend
27160 74 68 65 20 65 78 69 73 74 69 6e 67 20 6d 61 70 the existing map
27170 70 69 6e 67 20 66 61 69 6c 65 64 2e 20 46 72 65 ping failed. Fre
27180 65 20 69 74 2e 20 2a 2f 0a 20 20 20 20 69 66 28 e it. */. if(
27190 20 70 4e 65 77 3d 3d 4d 41 50 5f 46 41 49 4c 45 pNew==MAP_FAILE
271a0 44 20 7c 7c 20 70 4e 65 77 3d 3d 30 20 29 7b 0a D || pNew==0 ){.
271b0 20 20 20 20 20 20 6f 73 4d 75 6e 6d 61 70 28 70 osMunmap(p
271c0 4f 72 69 67 2c 20 6e 52 65 75 73 65 29 3b 0a 20 Orig, nReuse);.
271d0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 }. }.. /* I
271e0 66 20 70 4e 65 77 20 69 73 20 73 74 69 6c 6c 20 f pNew is still
271f0 4e 55 4c 4c 2c 20 74 72 79 20 74 6f 20 63 72 65 NULL, try to cre
27200 61 74 65 20 61 6e 20 65 6e 74 69 72 65 6c 79 20 ate an entirely
27210 6e 65 77 20 6d 61 70 70 69 6e 67 2e 20 2a 2f 0a new mapping. */.
27220 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 29 7b if( pNew==0 ){
27230 0a 20 20 20 20 70 4e 65 77 20 3d 20 6f 73 4d 6d . pNew = osMm
27240 61 70 28 30 2c 20 6e 4e 65 77 2c 20 66 6c 61 67 ap(0, nNew, flag
27250 73 2c 20 4d 41 50 5f 53 48 41 52 45 44 2c 20 68 s, MAP_SHARED, h
27260 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 , 0);. }.. if(
27270 20 70 4e 65 77 3d 3d 4d 41 50 5f 46 41 49 4c 45 pNew==MAP_FAILE
27280 44 20 29 7b 0a 20 20 20 20 70 4e 65 77 20 3d 20 D ){. pNew =
27290 30 3b 0a 20 20 20 20 6e 4e 65 77 20 3d 20 30 3b 0;. nNew = 0;
272a0 0a 20 20 20 20 75 6e 69 78 4c 6f 67 45 72 72 6f . unixLogErro
272b0 72 28 53 51 4c 49 54 45 5f 4f 4b 2c 20 7a 45 72 r(SQLITE_OK, zEr
272c0 72 2c 20 70 46 64 2d 3e 7a 50 61 74 68 29 3b 0a r, pFd->zPath);.
272d0 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6d . /* If the m
272e0 6d 61 70 28 29 20 61 62 6f 76 65 20 66 61 69 6c map() above fail
272f0 65 64 2c 20 61 73 73 75 6d 65 20 74 68 61 74 20 ed, assume that
27300 61 6c 6c 20 73 75 62 73 65 71 75 65 6e 74 20 6d all subsequent m
27310 6d 61 70 28 29 20 63 61 6c 6c 73 0a 20 20 20 20 map() calls.
27320 2a 2a 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 ** will probably
27330 20 66 61 69 6c 20 74 6f 6f 2e 20 46 61 6c 6c 20 fail too. Fall
27340 62 61 63 6b 20 74 6f 20 75 73 69 6e 67 20 78 52 back to using xR
27350 65 61 64 2f 78 57 72 69 74 65 20 65 78 63 6c 75 ead/xWrite exclu
27360 73 69 76 65 6c 79 0a 20 20 20 20 2a 2a 20 69 6e sively. ** in
27370 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a this case. */.
27380 20 20 20 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a pFd->mmapSiz
27390 65 4d 61 78 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 eMax = 0;. }.
273a0 70 46 64 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 20 pFd->pMapRegion
273b0 3d 20 28 76 6f 69 64 20 2a 29 70 4e 65 77 3b 0a = (void *)pNew;.
273c0 20 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 20 pFd->mmapSize
273d0 3d 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 41 = pFd->mmapSizeA
273e0 63 74 75 61 6c 20 3d 20 6e 4e 65 77 3b 0a 7d 0a ctual = nNew;.}.
273f0 0a 2f 2a 0a 2a 2a 20 4d 65 6d 6f 72 79 20 6d 61 ./*.** Memory ma
27400 70 20 6f 72 20 72 65 6d 61 70 20 74 68 65 20 66 p or remap the f
27410 69 6c 65 20 6f 70 65 6e 65 64 20 62 79 20 66 69 ile opened by fi
27420 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 20 70 46 le-descriptor pF
27430 64 20 28 69 66 20 74 68 65 20 66 69 6c 65 0a 2a d (if the file.*
27440 2a 20 69 73 20 61 6c 72 65 61 64 79 20 6d 61 70 * is already map
27450 70 65 64 2c 20 74 68 65 20 65 78 69 73 74 69 6e ped, the existin
27460 67 20 6d 61 70 70 69 6e 67 20 69 73 20 72 65 70 g mapping is rep
27470 6c 61 63 65 64 20 62 79 20 74 68 65 20 6e 65 77 laced by the new
27480 29 2e 20 4f 72 2c 20 69 66 20 0a 2a 2a 20 74 68 ). Or, if .** th
27490 65 72 65 20 61 6c 72 65 61 64 79 20 65 78 69 73 ere already exis
274a0 74 73 20 61 20 6d 61 70 70 69 6e 67 20 66 6f 72 ts a mapping for
274b0 20 74 68 69 73 20 66 69 6c 65 2c 20 61 6e 64 20 this file, and
274c0 74 68 65 72 65 20 61 72 65 20 73 74 69 6c 6c 20 there are still
274d0 0a 2a 2a 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 .** outstanding
274e0 78 46 65 74 63 68 28 29 20 72 65 66 65 72 65 6e xFetch() referen
274f0 63 65 73 20 74 6f 20 69 74 2c 20 74 68 69 73 20 ces to it, this
27500 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f function is a no
27510 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 -op..**.** If pa
27520 72 61 6d 65 74 65 72 20 6e 42 79 74 65 20 69 73 rameter nByte is
27530 20 6e 6f 6e 2d 6e 65 67 61 74 69 76 65 2c 20 74 non-negative, t
27540 68 65 6e 20 69 74 20 69 73 20 74 68 65 20 72 65 hen it is the re
27550 71 75 65 73 74 65 64 20 73 69 7a 65 20 6f 66 20 quested size of
27560 0a 2a 2a 20 74 68 65 20 6d 61 70 70 69 6e 67 20 .** the mapping
27570 74 6f 20 63 72 65 61 74 65 2e 20 4f 74 68 65 72 to create. Other
27580 77 69 73 65 2c 20 69 66 20 6e 42 79 74 65 20 69 wise, if nByte i
27590 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f s less than zero
275a0 2c 20 74 68 65 6e 20 74 68 65 20 0a 2a 2a 20 72 , then the .** r
275b0 65 71 75 65 73 74 65 64 20 73 69 7a 65 20 69 73 equested size is
275c0 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
275d0 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2e 20 54 file on disk. T
275e0 68 65 20 61 63 74 75 61 6c 20 73 69 7a 65 20 6f he actual size o
275f0 66 20 74 68 65 0a 2a 2a 20 63 72 65 61 74 65 64 f the.** created
27600 20 6d 61 70 70 69 6e 67 20 69 73 20 65 69 74 68 mapping is eith
27610 65 72 20 74 68 65 20 72 65 71 75 65 73 74 65 64 er the requested
27620 20 73 69 7a 65 20 6f 72 20 74 68 65 20 76 61 6c size or the val
27630 75 65 20 63 6f 6e 66 69 67 75 72 65 64 20 0a 2a ue configured .*
27640 2a 20 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 46 * using SQLITE_F
27650 43 4e 54 4c 5f 4d 4d 41 50 5f 4c 49 4d 49 54 2c CNTL_MMAP_LIMIT,
27660 20 77 68 69 63 68 65 76 65 72 20 69 73 20 73 6d whichever is sm
27670 61 6c 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c aller..**.** SQL
27680 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
27690 65 64 20 69 66 20 6e 6f 20 65 72 72 6f 72 20 6f ed if no error o
276a0 63 63 75 72 73 20 28 65 76 65 6e 20 69 66 20 74 ccurs (even if t
276b0 68 65 20 6d 61 70 70 69 6e 67 20 69 73 20 6e 6f he mapping is no
276c0 74 0a 2a 2a 20 72 65 63 72 65 61 74 65 64 20 61 t.** recreated a
276d0 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 6f 75 s a result of ou
276e0 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 tstanding refere
276f0 6e 63 65 73 29 20 6f 72 20 61 6e 20 53 51 4c 69 nces) or an SQLi
27700 74 65 20 65 72 72 6f 72 0a 2a 2a 20 63 6f 64 65 te error.** code
27710 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 otherwise..*/.s
27720 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 4d 61 tatic int unixMa
27730 70 66 69 6c 65 28 75 6e 69 78 46 69 6c 65 20 2a pfile(unixFile *
27740 70 46 64 2c 20 69 36 34 20 6e 4d 61 70 29 7b 0a pFd, i64 nMap){.
27750 20 20 61 73 73 65 72 74 28 20 6e 4d 61 70 3e 3d assert( nMap>=
27760 30 20 7c 7c 20 70 46 64 2d 3e 6e 46 65 74 63 68 0 || pFd->nFetch
27770 4f 75 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 Out==0 );. asse
27780 72 74 28 20 6e 4d 61 70 3e 30 20 7c 7c 20 28 70 rt( nMap>0 || (p
27790 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 3d 3d 30 20 Fd->mmapSize==0
277a0 26 26 20 70 46 64 2d 3e 70 4d 61 70 52 65 67 69 && pFd->pMapRegi
277b0 6f 6e 3d 3d 30 29 20 29 3b 0a 20 20 69 66 28 20 on==0) );. if(
277c0 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74 3e 30 pFd->nFetchOut>0
277d0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
277e0 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 6e 4d 61 70 _OK;.. if( nMap
277f0 3c 30 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 <0 ){. struct
27800 20 73 74 61 74 20 73 74 61 74 62 75 66 3b 20 20 stat statbuf;
27810 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 77 2d 6c /* Low-l
27820 65 76 65 6c 20 66 69 6c 65 20 69 6e 66 6f 72 6d evel file inform
27830 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 66 28 ation */. if(
27840 20 6f 73 46 73 74 61 74 28 70 46 64 2d 3e 68 2c osFstat(pFd->h,
27850 20 26 73 74 61 74 62 75 66 29 20 29 7b 0a 20 20 &statbuf) ){.
27860 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
27870 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 3b 0a 20 E_IOERR_FSTAT;.
27880 20 20 20 7d 0a 20 20 20 20 6e 4d 61 70 20 3d 20 }. nMap =
27890 73 74 61 74 62 75 66 2e 73 74 5f 73 69 7a 65 3b statbuf.st_size;
278a0 0a 20 20 7d 0a 20 20 69 66 28 20 6e 4d 61 70 3e . }. if( nMap>
278b0 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 pFd->mmapSizeMax
278c0 20 29 7b 0a 20 20 20 20 6e 4d 61 70 20 3d 20 70 ){. nMap = p
278d0 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 3b Fd->mmapSizeMax;
278e0 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 . }.. assert(
278f0 6e 4d 61 70 3e 30 20 7c 7c 20 28 70 46 64 2d 3e nMap>0 || (pFd->
27900 6d 6d 61 70 53 69 7a 65 3d 3d 30 20 26 26 20 70 mmapSize==0 && p
27910 46 64 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 3d 3d Fd->pMapRegion==
27920 30 29 20 29 3b 0a 20 20 69 66 28 20 6e 4d 61 70 0) );. if( nMap
27930 21 3d 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 20 !=pFd->mmapSize
27940 29 7b 0a 20 20 20 20 75 6e 69 78 52 65 6d 61 70 ){. unixRemap
27950 66 69 6c 65 28 70 46 64 2c 20 6e 4d 61 70 29 3b file(pFd, nMap);
27960 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 . }.. return S
27970 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 QLITE_OK;.}.#end
27980 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 41 58 if /* SQLITE_MAX
27990 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 20 2a 2f 0a _MMAP_SIZE>0 */.
279a0 0a 2f 2a 0a 2a 2a 20 49 66 20 70 6f 73 73 69 62 ./*.** If possib
279b0 6c 65 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69 le, return a poi
279c0 6e 74 65 72 20 74 6f 20 61 20 6d 61 70 70 69 6e nter to a mappin
279d0 67 20 6f 66 20 66 69 6c 65 20 66 64 20 73 74 61 g of file fd sta
279e0 72 74 69 6e 67 20 61 74 20 6f 66 66 73 65 74 0a rting at offset.
279f0 2a 2a 20 69 4f 66 66 2e 20 54 68 65 20 6d 61 70 ** iOff. The map
27a00 70 69 6e 67 20 6d 75 73 74 20 62 65 20 76 61 6c ping must be val
27a10 69 64 20 66 6f 72 20 61 74 20 6c 65 61 73 74 20 id for at least
27a20 6e 41 6d 74 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a nAmt bytes..**.*
27a30 2a 20 49 66 20 73 75 63 68 20 61 20 70 6f 69 6e * If such a poin
27a40 74 65 72 20 63 61 6e 20 62 65 20 6f 62 74 61 69 ter can be obtai
27a50 6e 65 64 2c 20 73 74 6f 72 65 20 69 74 20 69 6e ned, store it in
27a60 20 2a 70 70 20 61 6e 64 20 72 65 74 75 72 6e 20 *pp and return
27a70 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 4f 72 SQLITE_OK..** Or
27a80 2c 20 69 66 20 6f 6e 65 20 63 61 6e 6e 6f 74 20 , if one cannot
27a90 62 75 74 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 but no error occ
27aa0 75 72 73 2c 20 73 65 74 20 2a 70 70 20 74 6f 20 urs, set *pp to
27ab0 30 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c 0 and return SQL
27ac0 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 46 69 6e 61 6c ITE_OK..** Final
27ad0 6c 79 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 20 ly, if an error
27ae0 64 6f 65 73 20 6f 63 63 75 72 2c 20 72 65 74 75 does occur, retu
27af0 72 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 rn an SQLite err
27b00 6f 72 20 63 6f 64 65 2e 20 54 68 65 20 66 69 6e or code. The fin
27b10 61 6c 0a 2a 2a 20 76 61 6c 75 65 20 6f 66 20 2a al.** value of *
27b20 70 70 20 69 73 20 75 6e 64 65 66 69 6e 65 64 20 pp is undefined
27b30 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a in this case..**
27b40 0a 2a 2a 20 49 66 20 74 68 69 73 20 66 75 6e 63 .** If this func
27b50 74 69 6f 6e 20 64 6f 65 73 20 72 65 74 75 72 6e tion does return
27b60 20 61 20 70 6f 69 6e 74 65 72 2c 20 74 68 65 20 a pointer, the
27b70 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 76 65 6e caller must even
27b80 74 75 61 6c 6c 79 20 0a 2a 2a 20 72 65 6c 65 61 tually .** relea
27b90 73 65 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 se the reference
27ba0 20 62 79 20 63 61 6c 6c 69 6e 67 20 75 6e 69 78 by calling unix
27bb0 55 6e 66 65 74 63 68 28 29 2e 0a 2a 2f 0a 73 74 Unfetch()..*/.st
27bc0 61 74 69 63 20 69 6e 74 20 75 6e 69 78 46 65 74 atic int unixFet
27bd0 63 68 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ch(sqlite3_file
27be0 2a 66 64 2c 20 69 36 34 20 69 4f 66 66 2c 20 69 *fd, i64 iOff, i
27bf0 6e 74 20 6e 41 6d 74 2c 20 76 6f 69 64 20 2a 2a nt nAmt, void **
27c00 70 70 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f pp){.#if SQLITE_
27c10 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a MAX_MMAP_SIZE>0.
27c20 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 64 20 unixFile *pFd
27c30 3d 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 66 64 = (unixFile *)fd
27c40 3b 20 20 20 2f 2a 20 54 68 65 20 75 6e 64 65 72 ; /* The under
27c50 6c 79 69 6e 67 20 64 61 74 61 62 61 73 65 20 66 lying database f
27c60 69 6c 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 ile */.#endif.
27c70 2a 70 70 20 3d 20 30 3b 0a 0a 23 69 66 20 53 51 *pp = 0;..#if SQ
27c80 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 LITE_MAX_MMAP_SI
27c90 5a 45 3e 30 0a 20 20 69 66 28 20 70 46 64 2d 3e ZE>0. if( pFd->
27ca0 6d 6d 61 70 53 69 7a 65 4d 61 78 3e 30 20 29 7b mmapSizeMax>0 ){
27cb0 0a 20 20 20 20 69 66 28 20 70 46 64 2d 3e 70 4d . if( pFd->pM
27cc0 61 70 52 65 67 69 6f 6e 3d 3d 30 20 29 7b 0a 20 apRegion==0 ){.
27cd0 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 75 6e int rc = un
27ce0 69 78 4d 61 70 66 69 6c 65 28 70 46 64 2c 20 2d ixMapfile(pFd, -
27cf0 31 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 1);. if( rc
27d00 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 !=SQLITE_OK ) re
27d10 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
27d20 20 20 20 69 66 28 20 70 46 64 2d 3e 6d 6d 61 70 if( pFd->mmap
27d30 53 69 7a 65 20 3e 3d 20 69 4f 66 66 2b 6e 41 6d Size >= iOff+nAm
27d40 74 20 29 7b 0a 20 20 20 20 20 20 2a 70 70 20 3d t ){. *pp =
27d50 20 26 28 28 75 38 20 2a 29 70 46 64 2d 3e 70 4d &((u8 *)pFd->pM
27d60 61 70 52 65 67 69 6f 6e 29 5b 69 4f 66 66 5d 3b apRegion)[iOff];
27d70 0a 20 20 20 20 20 20 70 46 64 2d 3e 6e 46 65 74 . pFd->nFet
27d80 63 68 4f 75 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 chOut++;. }.
27d90 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 }.#endif. retu
27da0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
27db0 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 74 68 ./*.** If the th
27dc0 69 72 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ird argument is
27dd0 6e 6f 6e 2d 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 non-NULL, then t
27de0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 6c his function rel
27df0 65 61 73 65 73 20 61 20 0a 2a 2a 20 72 65 66 65 eases a .** refe
27e00 72 65 6e 63 65 20 6f 62 74 61 69 6e 65 64 20 62 rence obtained b
27e10 79 20 61 6e 20 65 61 72 6c 69 65 72 20 63 61 6c y an earlier cal
27e20 6c 20 74 6f 20 75 6e 69 78 46 65 74 63 68 28 29 l to unixFetch()
27e30 2e 20 54 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 . The second.**
27e40 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 argument passed
27e50 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e to this function
27e60 20 6d 75 73 74 20 62 65 20 74 68 65 20 73 61 6d must be the sam
27e70 65 20 61 73 20 74 68 65 20 63 6f 72 72 65 73 70 e as the corresp
27e80 6f 6e 64 69 6e 67 0a 2a 2a 20 61 72 67 75 6d 65 onding.** argume
27e90 6e 74 20 74 68 61 74 20 77 61 73 20 70 61 73 73 nt that was pass
27ea0 65 64 20 74 6f 20 74 68 65 20 75 6e 69 78 46 65 ed to the unixFe
27eb0 74 63 68 28 29 20 69 6e 76 6f 63 61 74 69 6f 6e tch() invocation
27ec0 2e 20 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 69 66 20 . .**.** Or, if
27ed0 74 68 65 20 74 68 69 72 64 20 61 72 67 75 6d 65 the third argume
27ee0 6e 74 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e nt is NULL, then
27ef0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
27f00 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 0a s being called .
27f10 2a 2a 20 74 6f 20 69 6e 66 6f 72 6d 20 74 68 65 ** to inform the
27f20 20 56 46 53 20 6c 61 79 65 72 20 74 68 61 74 2c VFS layer that,
27f30 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 50 4f according to PO
27f40 53 49 58 2c 20 61 6e 79 20 65 78 69 73 74 69 6e SIX, any existin
27f50 67 20 6d 61 70 70 69 6e 67 20 0a 2a 2a 20 6d 61 g mapping .** ma
27f60 79 20 6e 6f 77 20 62 65 20 69 6e 76 61 6c 69 64 y now be invalid
27f70 20 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 75 and should be u
27f80 6e 6d 61 70 70 65 64 2e 0a 2a 2f 0a 73 74 61 74 nmapped..*/.stat
27f90 69 63 20 69 6e 74 20 75 6e 69 78 55 6e 66 65 74 ic int unixUnfet
27fa0 63 68 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ch(sqlite3_file
27fb0 2a 66 64 2c 20 69 36 34 20 69 4f 66 66 2c 20 76 *fd, i64 iOff, v
27fc0 6f 69 64 20 2a 70 29 7b 0a 23 69 66 20 53 51 4c oid *p){.#if SQL
27fd0 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
27fe0 45 3e 30 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a E>0. unixFile *
27ff0 70 46 64 20 3d 20 28 75 6e 69 78 46 69 6c 65 20 pFd = (unixFile
28000 2a 29 66 64 3b 20 20 20 2f 2a 20 54 68 65 20 75 *)fd; /* The u
28010 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62 61 nderlying databa
28020 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 55 4e 55 se file */. UNU
28030 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 69 4f SED_PARAMETER(iO
28040 66 66 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 3d ff);.. /* If p=
28050 3d 30 20 28 75 6e 6d 61 70 20 74 68 65 20 65 6e =0 (unmap the en
28060 74 69 72 65 20 66 69 6c 65 29 20 74 68 65 6e 20 tire file) then
28070 74 68 65 72 65 20 6d 75 73 74 20 62 65 20 6e 6f there must be no
28080 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 0a 20 20 outstanding .
28090 2a 2a 20 78 46 65 74 63 68 20 72 65 66 65 72 65 ** xFetch refere
280a0 6e 63 65 73 2e 20 4f 72 2c 20 69 66 20 70 21 3d nces. Or, if p!=
280b0 30 20 28 6d 65 61 6e 69 6e 67 20 69 74 20 69 73 0 (meaning it is
280c0 20 61 6e 20 78 46 65 74 63 68 20 72 65 66 65 72 an xFetch refer
280d0 65 6e 63 65 29 2c 0a 20 20 2a 2a 20 74 68 65 6e ence),. ** then
280e0 20 74 68 65 72 65 20 6d 75 73 74 20 62 65 20 61 there must be a
280f0 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f 75 74 73 t least one outs
28100 74 61 6e 64 69 6e 67 2e 20 20 2a 2f 0a 20 20 61 tanding. */. a
28110 73 73 65 72 74 28 20 28 70 3d 3d 30 29 3d 3d 28 ssert( (p==0)==(
28120 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74 3d 3d pFd->nFetchOut==
28130 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 0) );.. /* If p
28140 21 3d 30 2c 20 69 74 20 6d 75 73 74 20 6d 61 74 !=0, it must mat
28150 63 68 20 74 68 65 20 69 4f 66 66 20 76 61 6c 75 ch the iOff valu
28160 65 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 e. */. assert(
28170 70 3d 3d 30 20 7c 7c 20 70 3d 3d 26 28 28 75 38 p==0 || p==&((u8
28180 20 2a 29 70 46 64 2d 3e 70 4d 61 70 52 65 67 69 *)pFd->pMapRegi
28190 6f 6e 29 5b 69 4f 66 66 5d 20 29 3b 0a 0a 20 20 on)[iOff] );..
281a0 69 66 28 20 70 20 29 7b 0a 20 20 20 20 70 46 64 if( p ){. pFd
281b0 2d 3e 6e 46 65 74 63 68 4f 75 74 2d 2d 3b 0a 20 ->nFetchOut--;.
281c0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 75 6e 69 78 }else{. unix
281d0 55 6e 6d 61 70 66 69 6c 65 28 70 46 64 29 3b 0a Unmapfile(pFd);.
281e0 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 70 }.. assert( p
281f0 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74 3e 3d 30 Fd->nFetchOut>=0
28200 20 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e 55 53 );.#else. UNUS
28210 45 44 5f 50 41 52 41 4d 45 54 45 52 28 66 64 29 ED_PARAMETER(fd)
28220 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d ;. UNUSED_PARAM
28230 45 54 45 52 28 70 29 3b 0a 20 20 55 4e 55 53 45 ETER(p);. UNUSE
28240 44 5f 50 41 52 41 4d 45 54 45 52 28 69 4f 66 66 D_PARAMETER(iOff
28250 29 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 );.#endif. retu
28260 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
28270 0a 2f 2a 0a 2a 2a 20 48 65 72 65 20 65 6e 64 73 ./*.** Here ends
28280 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 the implementat
28290 69 6f 6e 20 6f 66 20 61 6c 6c 20 73 71 6c 69 74 ion of all sqlit
282a0 65 33 5f 66 69 6c 65 20 6d 65 74 68 6f 64 73 2e e3_file methods.
282b0 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .**.************
282c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 73 ********** End s
282d0 71 6c 69 74 65 33 5f 66 69 6c 65 20 4d 65 74 68 qlite3_file Meth
282e0 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ods ************
282f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28300 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***.************
28310 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28320 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28330 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28340 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
28350 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 **/../*.** This
28360 64 69 76 69 73 69 6f 6e 20 63 6f 6e 74 61 69 6e division contain
28370 73 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 6f 66 s definitions of
28380 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 sqlite3_io_meth
28390 6f 64 73 20 6f 62 6a 65 63 74 73 20 74 68 61 74 ods objects that
283a0 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 20 76 61 .** implement va
283b0 72 69 6f 75 73 20 66 69 6c 65 20 6c 6f 63 6b 69 rious file locki
283c0 6e 67 20 73 74 72 61 74 65 67 69 65 73 2e 20 20 ng strategies.
283d0 49 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 It also contains
283e0 20 64 65 66 69 6e 69 74 69 6f 6e 73 0a 2a 2a 20 definitions.**
283f0 6f 66 20 22 66 69 6e 64 65 72 22 20 66 75 6e 63 of "finder" func
28400 74 69 6f 6e 73 2e 20 20 41 20 66 69 6e 64 65 72 tions. A finder
28410 2d 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 -function is use
28420 64 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 20 d to locate the
28430 61 70 70 72 6f 70 72 69 61 74 65 0a 2a 2a 20 73 appropriate.** s
28440 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 qlite3_io_method
28450 73 20 6f 62 6a 65 63 74 20 66 6f 72 20 61 20 70 s object for a p
28460 61 72 74 69 63 75 6c 61 72 20 64 61 74 61 62 61 articular databa
28470 73 65 20 66 69 6c 65 2e 20 20 54 68 65 20 70 41 se file. The pA
28480 70 70 44 61 74 61 0a 2a 2a 20 66 69 65 6c 64 20 ppData.** field
28490 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 of the sqlite3_v
284a0 66 73 20 56 46 53 20 6f 62 6a 65 63 74 73 20 61 fs VFS objects a
284b0 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 re initialized t
284c0 6f 20 62 65 20 70 6f 69 6e 74 65 72 73 20 74 6f o be pointers to
284d0 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 63 74 20 .** the correct
284e0 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 finder-function
284f0 66 6f 72 20 74 68 61 74 20 56 46 53 2e 0a 2a 2a for that VFS..**
28500 0a 2a 2a 20 4d 6f 73 74 20 66 69 6e 64 65 72 20 .** Most finder
28510 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e functions return
28520 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
28530 66 69 78 65 64 20 73 71 6c 69 74 65 33 5f 69 6f fixed sqlite3_io
28540 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20 6f 62 6a 65 _methods.** obje
28550 63 74 2e 20 20 54 68 65 20 6f 6e 6c 79 20 69 6e ct. The only in
28560 74 65 72 65 73 74 69 6e 67 20 66 69 6e 64 65 72 teresting finder
28570 2d 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 75 74 -function is aut
28580 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 2c 20 77 olockIoFinder, w
28590 68 69 63 68 0a 2a 2a 20 6c 6f 6f 6b 73 20 61 74 hich.** looks at
285a0 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 the filesystem
285b0 74 79 70 65 20 61 6e 64 20 74 72 69 65 73 20 74 type and tries t
285c0 6f 20 67 75 65 73 73 20 74 68 65 20 62 65 73 74 o guess the best
285d0 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 73 74 72 61 locking.** stra
285e0 74 65 67 79 20 66 72 6f 6d 20 74 68 61 74 2e 0a tegy from that..
285f0 2a 2a 0a 2a 2a 20 46 6f 72 20 66 69 6e 64 65 72 **.** For finder
28600 2d 66 75 6e 63 74 69 6f 6e 20 46 2c 20 74 77 6f -function F, two
28610 20 6f 62 6a 65 63 74 73 20 61 72 65 20 63 72 65 objects are cre
28620 61 74 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 28 ated:.**.** (
28630 31 29 20 54 68 65 20 72 65 61 6c 20 66 69 6e 64 1) The real find
28640 65 72 2d 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 er-function name
28650 64 20 22 46 49 6d 70 74 28 29 22 2e 0a 2a 2a 0a d "FImpt()"..**.
28660 2a 2a 20 20 20 20 28 32 29 20 41 20 63 6f 6e 73 ** (2) A cons
28670 74 61 6e 74 20 70 6f 69 6e 74 65 72 20 74 6f 20 tant pointer to
28680 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6e 61 this function na
28690 6d 65 64 20 6a 75 73 74 20 22 46 22 2e 0a 2a 2a med just "F"..**
286a0 0a 2a 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 72 .**.** A pointer
286b0 20 74 6f 20 74 68 65 20 46 20 70 6f 69 6e 74 65 to the F pointe
286c0 72 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 r is used as the
286d0 20 70 41 70 70 44 61 74 61 20 76 61 6c 75 65 20 pAppData value
286e0 66 6f 72 20 56 46 53 0a 2a 2a 20 6f 62 6a 65 63 for VFS.** objec
286f0 74 73 2e 20 20 57 65 20 68 61 76 65 20 74 6f 20 ts. We have to
28700 64 6f 20 74 68 69 73 20 69 6e 73 74 65 61 64 20 do this instead
28710 6f 66 20 6c 65 74 74 69 6e 67 20 70 41 70 70 44 of letting pAppD
28720 61 74 61 20 70 6f 69 6e 74 0a 2a 2a 20 64 69 72 ata point.** dir
28730 65 63 74 6c 79 20 61 74 20 74 68 65 20 66 69 6e ectly at the fin
28740 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 73 69 6e der-function sin
28750 63 65 20 43 39 30 20 72 75 6c 65 73 20 70 72 65 ce C90 rules pre
28760 76 65 6e 74 20 61 20 76 6f 69 64 2a 0a 2a 2a 20 vent a void*.**
28770 66 72 6f 6d 20 62 65 20 63 61 73 74 20 69 6e 74 from be cast int
28780 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 o a function poi
28790 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 45 nter..**.**.** E
287a0 61 63 68 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 ach instance of
287b0 74 68 69 73 20 6d 61 63 72 6f 20 67 65 6e 65 72 this macro gener
287c0 61 74 65 73 20 74 77 6f 20 6f 62 6a 65 63 74 73 ates two objects
287d0 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 41 20 63 :.**.** * A c
287e0 6f 6e 73 74 61 6e 74 20 73 71 6c 69 74 65 33 5f onstant sqlite3_
287f0 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 io_methods objec
28800 74 20 63 61 6c 6c 20 4d 45 54 48 4f 44 20 74 68 t call METHOD th
28810 61 74 20 68 61 73 20 6c 6f 63 6b 69 6e 67 0a 2a at has locking.*
28820 2a 20 20 20 20 20 20 6d 65 74 68 6f 64 73 20 43 * methods C
28830 4c 4f 53 45 2c 20 4c 4f 43 4b 2c 20 55 4e 4c 4f LOSE, LOCK, UNLO
28840 43 4b 2c 20 43 4b 52 45 53 4c 4f 43 4b 2e 0a 2a CK, CKRESLOCK..*
28850 2a 0a 2a 2a 20 20 20 2a 20 20 41 6e 20 49 2f 4f *.** * An I/O
28860 20 6d 65 74 68 6f 64 20 66 69 6e 64 65 72 20 66 method finder f
28870 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 64 20 46 unction called F
28880 49 4e 44 45 52 20 74 68 61 74 20 72 65 74 75 72 INDER that retur
28890 6e 73 20 61 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 ns a pointer.**
288a0 20 20 20 20 20 74 6f 20 74 68 65 20 4d 45 54 48 to the METH
288b0 4f 44 20 6f 62 6a 65 63 74 20 69 6e 20 74 68 65 OD object in the
288c0 20 70 72 65 76 69 6f 75 73 20 62 75 6c 6c 65 74 previous bullet
288d0 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4f 4d ..*/.#define IOM
288e0 45 54 48 4f 44 53 28 46 49 4e 44 45 52 2c 4d 45 ETHODS(FINDER,ME
288f0 54 48 4f 44 2c 56 45 52 53 49 4f 4e 2c 43 4c 4f THOD,VERSION,CLO
28900 53 45 2c 4c 4f 43 4b 2c 55 4e 4c 4f 43 4b 2c 43 SE,LOCK,UNLOCK,C
28910 4b 4c 4f 43 4b 2c 53 48 4d 4d 41 50 29 20 20 20 KLOCK,SHMMAP)
28920 20 20 5c 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 \.static const
28930 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 sqlite3_io_meth
28940 6f 64 73 20 4d 45 54 48 4f 44 20 3d 20 7b 20 20 ods METHOD = {
28950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28970 20 5c 0a 20 20 20 56 45 52 53 49 4f 4e 2c 20 20 \. VERSION,
28980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28990 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e 20 2a 2f /* iVersion */
289a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
289b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
289c0 5c 0a 20 20 20 43 4c 4f 53 45 2c 20 20 20 20 20 \. CLOSE,
289d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
289e0 20 2f 2a 20 78 43 6c 6f 73 65 20 2a 2f 20 20 20 /* xClose */
289f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
28a10 0a 20 20 20 75 6e 69 78 52 65 61 64 2c 20 20 20 . unixRead,
28a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28a30 2f 2a 20 78 52 65 61 64 20 2a 2f 20 20 20 20 20 /* xRead */
28a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28a50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a \.
28a60 20 20 20 75 6e 69 78 57 72 69 74 65 2c 20 20 20 unixWrite,
28a70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
28a80 2a 20 78 57 72 69 74 65 20 2a 2f 20 20 20 20 20 * xWrite */
28a90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
28ab0 20 20 75 6e 69 78 54 72 75 6e 63 61 74 65 2c 20 unixTruncate,
28ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
28ad0 20 78 54 72 75 6e 63 61 74 65 20 2a 2f 20 20 20 xTruncate */
28ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28af0 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 \.
28b00 20 75 6e 69 78 53 79 6e 63 2c 20 20 20 20 20 20 unixSync,
28b10 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
28b20 78 53 79 6e 63 20 2a 2f 20 20 20 20 20 20 20 20 xSync */
28b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28b40 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
28b50 75 6e 69 78 46 69 6c 65 53 69 7a 65 2c 20 20 20 unixFileSize,
28b60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
28b70 46 69 6c 65 53 69 7a 65 20 2a 2f 20 20 20 20 20 FileSize */
28b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28b90 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 4c \. L
28ba0 4f 43 4b 2c 20 20 20 20 20 20 20 20 20 20 20 20 OCK,
28bb0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c /* xL
28bc0 6f 63 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 20 ock */
28bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28be0 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 55 4e \. UN
28bf0 4c 4f 43 4b 2c 20 20 20 20 20 20 20 20 20 20 20 LOCK,
28c00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e /* xUn
28c10 6c 6f 63 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 lock */
28c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28c30 20 20 20 20 20 20 20 20 5c 0a 20 20 20 43 4b 4c \. CKL
28c40 4f 43 4b 2c 20 20 20 20 20 20 20 20 20 20 20 20 OCK,
28c50 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 68 65 /* xChe
28c60 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 2a ckReservedLock *
28c70 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 /
28c80 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 \. unix
28c90 46 69 6c 65 43 6f 6e 74 72 6f 6c 2c 20 20 20 20 FileControl,
28ca0 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69 6c 65 /* xFile
28cb0 43 6f 6e 74 72 6f 6c 20 2a 2f 20 20 20 20 20 20 Control */
28cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28cd0 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 \. unixS
28ce0 65 63 74 6f 72 53 69 7a 65 2c 20 20 20 20 20 20 ectorSize,
28cf0 20 20 20 20 20 20 20 2f 2a 20 78 53 65 63 74 6f /* xSecto
28d00 72 53 69 7a 65 20 2a 2f 20 20 20 20 20 20 20 20 rSize */
28d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28d20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 44 65 \. unixDe
28d30 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
28d40 69 63 73 2c 20 20 2f 2a 20 78 44 65 76 69 63 65 ics, /* xDevice
28d50 43 61 70 61 62 69 6c 69 74 69 65 73 20 2a 2f 20 Capabilities */
28d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28d70 20 20 20 20 5c 0a 20 20 20 53 48 4d 4d 41 50 2c \. SHMMAP,
28d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28d90 20 20 20 20 20 2f 2a 20 78 53 68 6d 4d 61 70 20 /* xShmMap
28da0 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
28db0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28dc0 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 68 6d 4c \. unixShmL
28dd0 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 ock,
28de0 20 20 20 20 2f 2a 20 78 53 68 6d 4c 6f 63 6b 20 /* xShmLock
28df0 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 */
28e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28e10 20 20 5c 0a 20 20 20 75 6e 69 78 53 68 6d 42 61 \. unixShmBa
28e20 72 72 69 65 72 2c 20 20 20 20 20 20 20 20 20 20 rrier,
28e30 20 20 20 2f 2a 20 78 53 68 6d 42 61 72 72 69 65 /* xShmBarrie
28e40 72 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 r */
28e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28e60 20 5c 0a 20 20 20 75 6e 69 78 53 68 6d 55 6e 6d \. unixShmUnm
28e70 61 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ap,
28e80 20 20 2f 2a 20 78 53 68 6d 55 6e 6d 61 70 20 2a /* xShmUnmap *
28e90 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 /
28ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28eb0 5c 0a 20 20 20 75 6e 69 78 46 65 74 63 68 2c 20 \. unixFetch,
28ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28ed0 20 2f 2a 20 78 46 65 74 63 68 20 2a 2f 20 20 20 /* xFetch */
28ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28ef0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
28f00 0a 20 20 20 75 6e 69 78 55 6e 66 65 74 63 68 2c . unixUnfetch,
28f10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28f20 2f 2a 20 78 55 6e 66 65 74 63 68 20 2a 2f 20 20 /* xUnfetch */
28f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a \.
28f50 7d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 };
28f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28f90 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 73 \.s
28fa0 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69 tatic const sqli
28fb0 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 2a te3_io_methods *
28fc0 46 49 4e 44 45 52 23 23 49 6d 70 6c 28 63 6f 6e FINDER##Impl(con
28fd0 73 74 20 63 68 61 72 20 2a 7a 2c 20 75 6e 69 78 st char *z, unix
28fe0 46 69 6c 65 20 2a 70 29 7b 20 20 20 5c 0a 20 20 File *p){ \.
28ff0 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
29000 28 7a 29 3b 20 55 4e 55 53 45 44 5f 50 41 52 41 (z); UNUSED_PARA
29010 4d 45 54 45 52 28 70 29 3b 20 20 20 20 20 20 20 METER(p);
29020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29030 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 72 \. r
29040 65 74 75 72 6e 20 26 4d 45 54 48 4f 44 3b 20 20 eturn &METHOD;
29050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29080 20 20 20 20 20 20 20 20 20 20 5c 0a 7d 20 20 20 \.}
29090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
290a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
290b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
290c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
290d0 20 20 20 20 20 20 20 20 20 5c 0a 73 74 61 74 69 \.stati
290e0 63 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f c const sqlite3_
290f0 69 6f 5f 6d 65 74 68 6f 64 73 20 2a 28 2a 63 6f io_methods *(*co
29100 6e 73 74 20 46 49 4e 44 45 52 29 28 63 6f 6e 73 nst FINDER)(cons
29110 74 20 63 68 61 72 2a 2c 75 6e 69 78 46 69 6c 65 t char*,unixFile
29120 20 2a 70 29 20 20 20 20 5c 0a 20 20 20 20 3d 20 *p) \. =
29130 46 49 4e 44 45 52 23 23 49 6d 70 6c 3b 0a 0a 2f FINDER##Impl;../
29140 2a 0a 2a 2a 20 48 65 72 65 20 61 72 65 20 61 6c *.** Here are al
29150 6c 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 l of the sqlite3
29160 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 _io_methods obje
29170 63 74 73 20 66 6f 72 20 65 61 63 68 20 6f 66 20 cts for each of
29180 74 68 65 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 20 73 the.** locking s
29190 74 72 61 74 65 67 69 65 73 2e 20 20 46 75 6e 63 trategies. Func
291a0 74 69 6f 6e 73 20 74 68 61 74 20 72 65 74 75 72 tions that retur
291b0 6e 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 n pointers to th
291c0 65 73 65 20 6d 65 74 68 6f 64 73 0a 2a 2a 20 61 ese methods.** a
291d0 72 65 20 61 6c 73 6f 20 63 72 65 61 74 65 64 2e re also created.
291e0 0a 2a 2f 0a 49 4f 4d 45 54 48 4f 44 53 28 0a 20 .*/.IOMETHODS(.
291f0 20 70 6f 73 69 78 49 6f 46 69 6e 64 65 72 2c 20 posixIoFinder,
29200 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
29210 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20 6e 61 nder function na
29220 6d 65 20 2a 2f 0a 20 20 70 6f 73 69 78 49 6f 4d me */. posixIoM
29230 65 74 68 6f 64 73 2c 20 20 20 20 20 20 20 20 20 ethods,
29240 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 69 6f 5f /* sqlite3_io_
29250 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 6e methods object n
29260 61 6d 65 20 2a 2f 0a 20 20 33 2c 20 20 20 20 20 ame */. 3,
29270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29280 20 20 20 2f 2a 20 73 68 61 72 65 64 20 6d 65 6d /* shared mem
29290 6f 72 79 20 61 6e 64 20 6d 6d 61 70 20 61 72 65 ory and mmap are
292a0 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 75 6e enabled */. un
292b0 69 78 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 ixClose,
292c0 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 /* xClos
292d0 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 75 6e e method */. un
292e0 69 78 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 ixLock,
292f0 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b /* xLock
29300 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 75 6e 69 method */. uni
29310 78 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 xUnlock,
29320 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 /* xUnloc
29330 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 75 6e k method */. un
29340 69 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c ixCheckReservedL
29350 6f 63 6b 2c 20 20 20 20 2f 2a 20 78 43 68 65 63 ock, /* xChec
29360 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 6d 65 kReservedLock me
29370 74 68 6f 64 20 2a 2f 0a 20 20 75 6e 69 78 53 68 thod */. unixSh
29380 6d 4d 61 70 20 20 20 20 20 20 20 20 20 20 20 20 mMap
29390 20 20 20 20 2f 2a 20 78 53 68 6d 4d 61 70 20 6d /* xShmMap m
293a0 65 74 68 6f 64 20 2a 2f 0a 29 0a 49 4f 4d 45 54 ethod */.).IOMET
293b0 48 4f 44 53 28 0a 20 20 6e 6f 6c 6f 63 6b 49 6f HODS(. nolockIo
293c0 46 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 20 Finder,
293d0 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 /* Finder func
293e0 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 6e tion name */. n
293f0 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 2c 20 olockIoMethods,
29400 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 /* sqli
29410 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f te3_io_methods o
29420 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 bject name */.
29430 33 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3,
29440 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 68 61 /* sha
29450 72 65 64 20 6d 65 6d 6f 72 79 20 69 73 20 64 69 red memory is di
29460 73 61 62 6c 65 64 20 2a 2f 0a 20 20 6e 6f 6c 6f sabled */. nolo
29470 63 6b 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 ckClose,
29480 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 /* xClose
29490 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f method */. nolo
294a0 63 6b 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 ckLock,
294b0 20 20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d /* xLock m
294c0 65 74 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 ethod */. noloc
294d0 6b 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 kUnlock,
294e0 20 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 /* xUnlock
294f0 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f method */. nolo
29500 63 6b 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c ckCheckReservedL
29510 6f 63 6b 2c 20 20 2f 2a 20 78 43 68 65 63 6b 52 ock, /* xCheckR
29520 65 73 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 eservedLock meth
29530 6f 64 20 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 od */. 0
29540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29550 20 20 2f 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 /* xShmMap met
29560 68 6f 64 20 2a 2f 0a 29 0a 49 4f 4d 45 54 48 4f hod */.).IOMETHO
29570 44 53 28 0a 20 20 64 6f 74 6c 6f 63 6b 49 6f 46 DS(. dotlockIoF
29580 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 20 20 inder,
29590 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 69 /* Finder functi
295a0 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 64 6f 74 on name */. dot
295b0 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 2c 20 20 lockIoMethods,
295c0 20 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 /* sqlite
295d0 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 3_io_methods obj
295e0 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c ect name */. 1,
295f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29600 20 20 20 20 20 20 20 20 2f 2a 20 73 68 61 72 65 /* share
29610 64 20 6d 65 6d 6f 72 79 20 69 73 20 64 69 73 61 d memory is disa
29620 62 6c 65 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 bled */. dotloc
29630 6b 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 kClose,
29640 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 /* xClose me
29650 74 68 6f 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 thod */. dotloc
29660 6b 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 kLock,
29670 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 /* xLock met
29680 68 6f 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b hod */. dotlock
29690 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 Unlock,
296a0 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 /* xUnlock me
296b0 74 68 6f 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 thod */. dotloc
296c0 6b 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f kCheckReservedLo
296d0 63 6b 2c 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 ck, /* xCheckRes
296e0 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 ervedLock method
296f0 20 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20 20 */. 0
29700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29710 2f 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f /* xShmMap metho
29720 64 20 2a 2f 0a 29 0a 0a 23 69 66 20 53 51 4c 49 d */.)..#if SQLI
29730 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e TE_ENABLE_LOCKIN
29740 47 5f 53 54 59 4c 45 0a 49 4f 4d 45 54 48 4f 44 G_STYLE.IOMETHOD
29750 53 28 0a 20 20 66 6c 6f 63 6b 49 6f 46 69 6e 64 S(. flockIoFind
29760 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f er, /
29770 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f * Finder functio
29780 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 66 6c 6f 63 n name */. floc
29790 6b 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 kIoMethods,
297a0 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 /* sqlite3
297b0 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 _io_methods obje
297c0 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 ct name */. 1,
297d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
297e0 20 20 20 20 20 20 20 2f 2a 20 73 68 61 72 65 64 /* shared
297f0 20 6d 65 6d 6f 72 79 20 69 73 20 64 69 73 61 62 memory is disab
29800 6c 65 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 6c led */. flockCl
29810 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ose,
29820 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 /* xClose met
29830 68 6f 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 4c 6f hod */. flockLo
29840 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ck,
29850 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 /* xLock meth
29860 6f 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 55 6e 6c od */. flockUnl
29870 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 ock,
29880 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 /* xUnlock met
29890 68 6f 64 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 68 hod */. flockCh
298a0 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 2c eckReservedLock,
298b0 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 /* xCheckRese
298c0 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 rvedLock method
298d0 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20 20 20 */. 0
298e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
298f0 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64 * xShmMap method
29900 20 2a 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 */.).#endif..#i
29910 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 49 4f 4d f OS_VXWORKS.IOM
29920 45 54 48 4f 44 53 28 0a 20 20 73 65 6d 49 6f 46 ETHODS(. semIoF
29930 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 20 20 inder,
29940 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 /* Finder fu
29950 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 nction name */.
29960 20 73 65 6d 49 6f 4d 65 74 68 6f 64 73 2c 20 20 semIoMethods,
29970 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 /* sq
29980 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 lite3_io_methods
29990 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a object name */.
299a0 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 1,
299b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 /* s
299c0 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 69 73 20 hared memory is
299d0 64 69 73 61 62 6c 65 64 20 2a 2f 0a 20 20 73 65 disabled */. se
299e0 6d 58 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 mXClose,
299f0 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 /* xClos
29a00 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 73 65 e method */. se
29a10 6d 58 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 mXLock,
29a20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b /* xLock
29a30 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 73 65 6d method */. sem
29a40 58 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 XUnlock,
29a50 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 /* xUnloc
29a60 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 73 65 k method */. se
29a70 6d 58 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c mXCheckReservedL
29a80 6f 63 6b 2c 20 20 20 20 2f 2a 20 78 43 68 65 63 ock, /* xChec
29a90 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 6d 65 kReservedLock me
29aa0 74 68 6f 64 20 2a 2f 0a 20 20 30 20 20 20 20 20 thod */. 0
29ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29ac0 20 20 20 20 2f 2a 20 78 53 68 6d 4d 61 70 20 6d /* xShmMap m
29ad0 65 74 68 6f 64 20 2a 2f 0a 29 0a 23 65 6e 64 69 ethod */.).#endi
29ae0 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f f..#if defined(_
29af0 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c _APPLE__) && SQL
29b00 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 ITE_ENABLE_LOCKI
29b10 4e 47 5f 53 54 59 4c 45 0a 49 4f 4d 45 54 48 4f NG_STYLE.IOMETHO
29b20 44 53 28 0a 20 20 61 66 70 49 6f 46 69 6e 64 65 DS(. afpIoFinde
29b30 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r,
29b40 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 69 /* Finder functi
29b50 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 61 66 70 on name */. afp
29b60 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 20 IoMethods,
29b70 20 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 /* sqlite
29b80 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 3_io_methods obj
29b90 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c ect name */. 1,
29ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29bb0 20 20 20 20 20 20 20 20 2f 2a 20 73 68 61 72 65 /* share
29bc0 64 20 6d 65 6d 6f 72 79 20 69 73 20 64 69 73 61 d memory is disa
29bd0 62 6c 65 64 20 2a 2f 0a 20 20 61 66 70 43 6c 6f bled */. afpClo
29be0 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 se,
29bf0 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 /* xClose me
29c00 74 68 6f 64 20 2a 2f 0a 20 20 61 66 70 4c 6f 63 thod */. afpLoc
29c10 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k,
29c20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 /* xLock met
29c30 68 6f 64 20 2a 2f 0a 20 20 61 66 70 55 6e 6c 6f hod */. afpUnlo
29c40 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ck,
29c50 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 /* xUnlock me
29c60 74 68 6f 64 20 2a 2f 0a 20 20 61 66 70 43 68 65 thod */. afpChe
29c70 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 2c 20 ckReservedLock,
29c80 20 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 /* xCheckRes
29c90 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 ervedLock method
29ca0 20 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20 20 */. 0
29cb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29cc0 2f 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f /* xShmMap metho
29cd0 64 20 2a 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a 2f d */.).#endif../
29ce0 2a 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 20 6c *.** The proxy l
29cf0 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 20 69 73 ocking method is
29d00 20 61 20 22 73 75 70 65 72 2d 6d 65 74 68 6f 64 a "super-method
29d10 22 20 69 6e 20 74 68 65 20 73 65 6e 73 65 20 74 " in the sense t
29d20 68 61 74 20 69 74 0a 2a 2a 20 6f 70 65 6e 73 20 hat it.** opens
29d30 73 65 63 6f 6e 64 61 72 79 20 66 69 6c 65 20 64 secondary file d
29d40 65 73 63 72 69 70 74 6f 72 73 20 66 6f 72 20 74 escriptors for t
29d50 68 65 20 63 6f 6e 63 68 20 61 6e 64 20 6c 6f 63 he conch and loc
29d60 6b 20 66 69 6c 65 73 20 61 6e 64 0a 2a 2a 20 69 k files and.** i
29d70 74 20 75 73 65 73 20 70 72 6f 78 79 2c 20 64 6f t uses proxy, do
29d80 74 2d 66 69 6c 65 2c 20 41 46 50 2c 20 61 6e 64 t-file, AFP, and
29d90 20 66 6c 6f 63 6b 28 29 20 6c 6f 63 6b 69 6e 67 flock() locking
29da0 20 6d 65 74 68 6f 64 73 20 6f 6e 20 74 68 6f 73 methods on thos
29db0 65 0a 2a 2a 20 73 65 63 6f 6e 64 61 72 79 20 66 e.** secondary f
29dc0 69 6c 65 73 2e 20 20 46 6f 72 20 74 68 69 73 20 iles. For this
29dd0 72 65 61 73 6f 6e 2c 20 74 68 65 20 64 69 76 69 reason, the divi
29de0 73 69 6f 6e 20 74 68 61 74 20 69 6d 70 6c 65 6d sion that implem
29df0 65 6e 74 73 0a 2a 2a 20 70 72 6f 78 79 20 6c 6f ents.** proxy lo
29e00 63 6b 69 6e 67 20 69 73 20 6c 6f 63 61 74 65 64 cking is located
29e10 20 6d 75 63 68 20 66 75 72 74 68 65 72 20 64 6f much further do
29e20 77 6e 20 69 6e 20 74 68 65 20 66 69 6c 65 2e 20 wn in the file.
29e30 20 42 75 74 20 77 65 20 6e 65 65 64 0a 2a 2a 20 But we need.**
29e40 74 6f 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20 to go ahead and
29e50 64 65 66 69 6e 65 20 74 68 65 20 73 71 6c 69 74 define the sqlit
29e60 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 61 6e e3_io_methods an
29e70 64 20 66 69 6e 64 65 72 20 66 75 6e 63 74 69 6f d finder functio
29e80 6e 0a 2a 2a 20 66 6f 72 20 70 72 6f 78 79 20 6c n.** for proxy l
29e90 6f 63 6b 69 6e 67 20 68 65 72 65 2e 20 20 53 6f ocking here. So
29ea0 20 77 65 20 66 6f 72 77 61 72 64 20 64 65 63 6c we forward decl
29eb0 61 72 65 20 74 68 65 20 49 2f 4f 20 6d 65 74 68 are the I/O meth
29ec0 6f 64 73 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 ods..*/.#if defi
29ed0 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 ned(__APPLE__) &
29ee0 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f & SQLITE_ENABLE_
29ef0 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 73 74 LOCKING_STYLE.st
29f00 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 43 6c atic int proxyCl
29f10 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 ose(sqlite3_file
29f20 2a 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 70 *);.static int p
29f30 72 6f 78 79 4c 6f 63 6b 28 73 71 6c 69 74 65 33 roxyLock(sqlite3
29f40 5f 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 73 74 _file*, int);.st
29f50 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 55 6e atic int proxyUn
29f60 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c lock(sqlite3_fil
29f70 65 2a 2c 20 69 6e 74 29 3b 0a 73 74 61 74 69 63 e*, int);.static
29f80 20 69 6e 74 20 70 72 6f 78 79 43 68 65 63 6b 52 int proxyCheckR
29f90 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 eservedLock(sqli
29fa0 74 65 33 5f 66 69 6c 65 2a 2c 20 69 6e 74 2a 29 te3_file*, int*)
29fb0 3b 0a 49 4f 4d 45 54 48 4f 44 53 28 0a 20 20 70 ;.IOMETHODS(. p
29fc0 72 6f 78 79 49 6f 46 69 6e 64 65 72 2c 20 20 20 roxyIoFinder,
29fd0 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6e 64 /* Find
29fe0 65 72 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 er function name
29ff0 20 2a 2f 0a 20 20 70 72 6f 78 79 49 6f 4d 65 74 */. proxyIoMet
2a000 68 6f 64 73 2c 20 20 20 20 20 20 20 20 20 20 20 hods,
2a010 2f 2a 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 /* sqlite3_io_me
2a020 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d thods object nam
2a030 65 20 2a 2f 0a 20 20 31 2c 20 20 20 20 20 20 20 e */. 1,
2a040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a050 20 2f 2a 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 /* shared memor
2a060 79 20 69 73 20 64 69 73 61 62 6c 65 64 20 2a 2f y is disabled */
2a070 0a 20 20 70 72 6f 78 79 43 6c 6f 73 65 2c 20 20 . proxyClose,
2a080 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a090 78 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f xClose method */
2a0a0 0a 20 20 70 72 6f 78 79 4c 6f 63 6b 2c 20 20 20 . proxyLock,
2a0b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a0c0 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a xLock method */.
2a0d0 20 20 70 72 6f 78 79 55 6e 6c 6f 63 6b 2c 20 20 proxyUnlock,
2a0e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
2a0f0 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f Unlock method */
2a100 0a 20 20 70 72 6f 78 79 43 68 65 63 6b 52 65 73 . proxyCheckRes
2a110 65 72 76 65 64 4c 6f 63 6b 2c 20 20 20 2f 2a 20 ervedLock, /*
2a120 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f xCheckReservedLo
2a130 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 30 ck method */. 0
2a140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a150 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d /* xShm
2a160 4d 61 70 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a Map method */.).
2a170 23 65 6e 64 69 66 0a 0a 2f 2a 20 6e 66 73 20 6c #endif../* nfs l
2a180 6f 63 6b 64 20 6f 6e 20 4f 53 58 20 31 30 2e 33 ockd on OSX 10.3
2a190 2b 20 64 6f 65 73 6e 27 74 20 63 6c 65 61 72 20 + doesn't clear
2a1a0 77 72 69 74 65 20 6c 6f 63 6b 73 20 77 68 65 6e write locks when
2a1b0 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 69 73 20 a read lock is
2a1c0 73 65 74 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e set */.#if defin
2a1d0 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 ed(__APPLE__) &&
2a1e0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
2a1f0 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 49 4f 4d OCKING_STYLE.IOM
2a200 45 54 48 4f 44 53 28 0a 20 20 6e 66 73 49 6f 46 ETHODS(. nfsIoF
2a210 69 6e 64 65 72 2c 20 20 20 20 20 20 20 20 20 20 inder,
2a220 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 /* Finder f
2a230 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a unction name */.
2a240 20 20 6e 66 73 49 6f 4d 65 74 68 6f 64 73 2c 20 nfsIoMethods,
2a250 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a260 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f sqlite3_io_metho
2a270 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a ds object name *
2a280 2f 0a 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 /. 1,
2a290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2a2a0 2a 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 * shared memory
2a2b0 69 73 20 64 69 73 61 62 6c 65 64 20 2a 2f 0a 20 is disabled */.
2a2c0 20 75 6e 69 78 43 6c 6f 73 65 2c 20 20 20 20 20 unixClose,
2a2d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
2a2e0 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a Close method */.
2a2f0 20 20 75 6e 69 78 4c 6f 63 6b 2c 20 20 20 20 20 unixLock,
2a300 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a310 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a xLock method */.
2a320 20 20 6e 66 73 55 6e 6c 6f 63 6b 2c 20 20 20 20 nfsUnlock,
2a330 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a340 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a xUnlock method *
2a350 2f 0a 20 20 75 6e 69 78 43 68 65 63 6b 52 65 73 /. unixCheckRes
2a360 65 72 76 65 64 4c 6f 63 6b 2c 20 20 20 20 20 2f ervedLock, /
2a370 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 * xCheckReserved
2a380 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 Lock method */.
2a390 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
2a3a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
2a3b0 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64 20 2a 2f ShmMap method */
2a3c0 0a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 .).#endif..#if d
2a3d0 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
2a3e0 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 ) && SQLITE_ENAB
2a3f0 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
2a400 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 22 66 69 ./* .** This "fi
2a410 6e 64 65 72 22 20 66 75 6e 63 74 69 6f 6e 20 61 nder" function a
2a420 74 74 65 6d 70 74 73 20 74 6f 20 64 65 74 65 72 ttempts to deter
2a430 6d 69 6e 65 20 74 68 65 20 62 65 73 74 20 6c 6f mine the best lo
2a440 63 6b 69 6e 67 20 73 74 72 61 74 65 67 79 20 0a cking strategy .
2a450 2a 2a 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 ** for the datab
2a460 61 73 65 20 66 69 6c 65 20 22 66 69 6c 65 50 61 ase file "filePa
2a470 74 68 22 2e 20 20 49 74 20 74 68 65 6e 20 72 65 th". It then re
2a480 74 75 72 6e 73 20 74 68 65 20 73 71 6c 69 74 65 turns the sqlite
2a490 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20 3_io_methods.**
2a4a0 6f 62 6a 65 63 74 20 74 68 61 74 20 69 6d 70 6c object that impl
2a4b0 65 6d 65 6e 74 73 20 74 68 61 74 20 73 74 72 61 ements that stra
2a4c0 74 65 67 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 tegy..**.** This
2a4d0 20 69 73 20 66 6f 72 20 4d 61 63 4f 53 58 20 6f is for MacOSX o
2a4e0 6e 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 nly..*/.static c
2a4f0 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f onst sqlite3_io_
2a500 6d 65 74 68 6f 64 73 20 2a 61 75 74 6f 6c 6f 63 methods *autoloc
2a510 6b 49 6f 46 69 6e 64 65 72 49 6d 70 6c 28 0a 20 kIoFinderImpl(.
2a520 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c const char *fil
2a530 65 50 61 74 68 2c 20 20 20 20 2f 2a 20 6e 61 6d ePath, /* nam
2a540 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
2a550 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 e file */. unix
2a560 46 69 6c 65 20 2a 70 4e 65 77 20 20 20 20 20 20 File *pNew
2a570 20 20 20 20 20 2f 2a 20 6f 70 65 6e 20 66 69 6c /* open fil
2a580 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 e object for the
2a590 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
2a5a0 2f 0a 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f /.){. static co
2a5b0 6e 73 74 20 73 74 72 75 63 74 20 4d 61 70 70 69 nst struct Mappi
2a5c0 6e 67 20 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 ng {. const c
2a5d0 68 61 72 20 2a 7a 46 69 6c 65 73 79 73 74 65 6d har *zFilesystem
2a5e0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
2a5f0 2a 20 46 69 6c 65 73 79 73 74 65 6d 20 74 79 70 * Filesystem typ
2a600 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 63 6f e name */. co
2a610 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d nst sqlite3_io_m
2a620 65 74 68 6f 64 73 20 2a 70 4d 65 74 68 6f 64 73 ethods *pMethods
2a630 3b 20 20 20 2f 2a 20 41 70 70 72 6f 70 72 69 61 ; /* Appropria
2a640 74 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f te locking metho
2a650 64 20 2a 2f 0a 20 20 7d 20 61 4d 61 70 5b 5d 20 d */. } aMap[]
2a660 3d 20 7b 0a 20 20 20 20 7b 20 22 68 66 73 22 2c = {. { "hfs",
2a670 20 20 20 20 26 70 6f 73 69 78 49 6f 4d 65 74 68 &posixIoMeth
2a680 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 22 75 66 ods },. { "uf
2a690 73 22 2c 20 20 20 20 26 70 6f 73 69 78 49 6f 4d s", &posixIoM
2a6a0 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 ethods },. {
2a6b0 22 61 66 70 66 73 22 2c 20 20 26 61 66 70 49 6f "afpfs", &afpIo
2a6c0 4d 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b Methods },. {
2a6d0 20 22 73 6d 62 66 73 22 2c 20 20 26 61 66 70 49 "smbfs", &afpI
2a6e0 6f 4d 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 oMethods },.
2a6f0 7b 20 22 77 65 62 64 61 76 22 2c 20 26 6e 6f 6c { "webdav", &nol
2a700 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 20 7d 2c 0a ockIoMethods },.
2a710 20 20 20 20 7b 20 30 2c 20 30 20 7d 0a 20 20 7d { 0, 0 }. }
2a720 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 73 74 72 ;. int i;. str
2a730 75 63 74 20 73 74 61 74 66 73 20 66 73 49 6e 66 uct statfs fsInf
2a740 6f 3b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 o;. struct floc
2a750 6b 20 6c 6f 63 6b 49 6e 66 6f 3b 0a 0a 20 20 69 k lockInfo;.. i
2a760 66 28 20 21 66 69 6c 65 50 61 74 68 20 29 7b 0a f( !filePath ){.
2a770 20 20 20 20 2f 2a 20 49 66 20 66 69 6c 65 50 61 /* If filePa
2a780 74 68 3d 3d 4e 55 4c 4c 20 74 68 61 74 20 6d 65 th==NULL that me
2a790 61 6e 73 20 77 65 20 61 72 65 20 64 65 61 6c 69 ans we are deali
2a7a0 6e 67 20 77 69 74 68 20 61 20 74 72 61 6e 73 69 ng with a transi
2a7b0 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 ent file. **
2a7c0 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 that does not ne
2a7d0 65 64 20 74 6f 20 62 65 20 6c 6f 63 6b 65 64 2e ed to be locked.
2a7e0 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 26 */. return &
2a7f0 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b nolockIoMethods;
2a800 0a 20 20 7d 0a 20 20 69 66 28 20 73 74 61 74 66 . }. if( statf
2a810 73 28 66 69 6c 65 50 61 74 68 2c 20 26 66 73 49 s(filePath, &fsI
2a820 6e 66 6f 29 20 21 3d 20 2d 31 20 29 7b 0a 20 20 nfo) != -1 ){.
2a830 20 20 69 66 28 20 66 73 49 6e 66 6f 2e 66 5f 66 if( fsInfo.f_f
2a840 6c 61 67 73 20 26 20 4d 4e 54 5f 52 44 4f 4e 4c lags & MNT_RDONL
2a850 59 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 Y ){. retur
2a860 6e 20 26 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f n &nolockIoMetho
2a870 64 73 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f ds;. }. fo
2a880 72 28 69 3d 30 3b 20 61 4d 61 70 5b 69 5d 2e 7a r(i=0; aMap[i].z
2a890 46 69 6c 65 73 79 73 74 65 6d 3b 20 69 2b 2b 29 Filesystem; i++)
2a8a0 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 63 {. if( strc
2a8b0 6d 70 28 66 73 49 6e 66 6f 2e 66 5f 66 73 74 79 mp(fsInfo.f_fsty
2a8c0 70 65 6e 61 6d 65 2c 20 61 4d 61 70 5b 69 5d 2e pename, aMap[i].
2a8d0 7a 46 69 6c 65 73 79 73 74 65 6d 29 3d 3d 30 20 zFilesystem)==0
2a8e0 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
2a8f0 6e 20 61 4d 61 70 5b 69 5d 2e 70 4d 65 74 68 6f n aMap[i].pMetho
2a900 64 73 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ds;. }.
2a910 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 44 65 66 61 }. }.. /* Defa
2a920 75 6c 74 20 63 61 73 65 2e 20 48 61 6e 64 6c 65 ult case. Handle
2a930 73 2c 20 61 6d 6f 6e 67 73 74 20 6f 74 68 65 72 s, amongst other
2a940 73 2c 20 22 6e 66 73 22 2e 0a 20 20 2a 2a 20 54 s, "nfs".. ** T
2a950 65 73 74 20 62 79 74 65 2d 72 61 6e 67 65 20 6c est byte-range l
2a960 6f 63 6b 20 75 73 69 6e 67 20 66 63 6e 74 6c 28 ock using fcntl(
2a970 29 2e 20 49 66 20 74 68 65 20 63 61 6c 6c 20 73 ). If the call s
2a980 75 63 63 65 65 64 73 2c 20 0a 20 20 2a 2a 20 61 ucceeds, . ** a
2a990 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 20 66 ssume that the f
2a9a0 69 6c 65 2d 73 79 73 74 65 6d 20 73 75 70 70 6f ile-system suppo
2a9b0 72 74 73 20 50 4f 53 49 58 20 73 74 79 6c 65 20 rts POSIX style
2a9c0 6c 6f 63 6b 73 2e 20 0a 20 20 2a 2f 0a 20 20 6c locks. . */. l
2a9d0 6f 63 6b 49 6e 66 6f 2e 6c 5f 6c 65 6e 20 3d 20 ockInfo.l_len =
2a9e0 31 3b 0a 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 1;. lockInfo.l_
2a9f0 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 6c 6f 63 start = 0;. loc
2aa00 6b 49 6e 66 6f 2e 6c 5f 77 68 65 6e 63 65 20 3d kInfo.l_whence =
2aa10 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 6c 6f 63 SEEK_SET;. loc
2aa20 6b 49 6e 66 6f 2e 6c 5f 74 79 70 65 20 3d 20 46 kInfo.l_type = F
2aa30 5f 52 44 4c 43 4b 3b 0a 20 20 69 66 28 20 6f 73 _RDLCK;. if( os
2aa40 46 63 6e 74 6c 28 70 4e 65 77 2d 3e 68 2c 20 46 Fcntl(pNew->h, F
2aa50 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63 6b 49 6e 66 _GETLK, &lockInf
2aa60 6f 29 21 3d 2d 31 20 29 20 7b 0a 20 20 20 20 69 o)!=-1 ) {. i
2aa70 66 28 20 73 74 72 63 6d 70 28 66 73 49 6e 66 6f f( strcmp(fsInfo
2aa80 2e 66 5f 66 73 74 79 70 65 6e 61 6d 65 2c 20 22 .f_fstypename, "
2aa90 6e 66 73 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 nfs")==0 ){.
2aaa0 20 20 72 65 74 75 72 6e 20 26 6e 66 73 49 6f 4d return &nfsIoM
2aab0 65 74 68 6f 64 73 3b 0a 20 20 20 20 7d 20 65 6c ethods;. } el
2aac0 73 65 20 7b 0a 20 20 20 20 20 20 72 65 74 75 72 se {. retur
2aad0 6e 20 26 70 6f 73 69 78 49 6f 4d 65 74 68 6f 64 n &posixIoMethod
2aae0 73 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 s;. }. }else
2aaf0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 26 64 6f {. return &do
2ab00 74 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b 0a tlockIoMethods;.
2ab10 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 63 6f 6e }.}.static con
2ab20 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 st sqlite3_io_me
2ab30 74 68 6f 64 73 20 0a 20 20 2a 28 2a 63 6f 6e 73 thods . *(*cons
2ab40 74 20 61 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 t autolockIoFind
2ab50 65 72 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c er)(const char*,
2ab60 75 6e 69 78 46 69 6c 65 2a 29 20 3d 20 61 75 74 unixFile*) = aut
2ab70 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 49 6d 70 olockIoFinderImp
2ab80 6c 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 64 65 l;..#endif /* de
2ab90 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
2aba0 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c && SQLITE_ENABL
2abb0 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 E_LOCKING_STYLE
2abc0 2a 2f 0a 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 */..#if OS_VXWOR
2abd0 4b 53 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 22 66 KS./*.** This "f
2abe0 69 6e 64 65 72 22 20 66 75 6e 63 74 69 6f 6e 20 inder" function
2abf0 66 6f 72 20 56 78 57 6f 72 6b 73 20 63 68 65 63 for VxWorks chec
2ac00 6b 73 20 74 6f 20 73 65 65 20 69 66 20 70 6f 73 ks to see if pos
2ac10 69 78 20 61 64 76 69 73 6f 72 79 0a 2a 2a 20 6c ix advisory.** l
2ac20 6f 63 6b 69 6e 67 20 77 6f 72 6b 73 2e 20 20 49 ocking works. I
2ac30 66 20 69 74 20 64 6f 65 73 2c 20 74 68 65 6e 20 f it does, then
2ac40 74 68 61 74 20 69 73 20 77 68 61 74 20 69 73 20 that is what is
2ac50 75 73 65 64 2e 20 20 49 66 20 69 74 20 64 6f 65 used. If it doe
2ac60 73 20 6e 6f 74 0a 2a 2a 20 77 6f 72 6b 2c 20 74 s not.** work, t
2ac70 68 65 6e 20 66 61 6c 6c 62 61 63 6b 20 74 6f 20 hen fallback to
2ac80 6e 61 6d 65 64 20 73 65 6d 61 70 68 6f 72 65 20 named semaphore
2ac90 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 locking..*/.stat
2aca0 69 63 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 ic const sqlite3
2acb0 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 2a 76 78 77 _io_methods *vxw
2acc0 6f 72 6b 73 49 6f 46 69 6e 64 65 72 49 6d 70 6c orksIoFinderImpl
2acd0 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
2ace0 66 69 6c 65 50 61 74 68 2c 20 20 20 20 2f 2a 20 filePath, /*
2acf0 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 name of the data
2ad00 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 base file */. u
2ad10 6e 69 78 46 69 6c 65 20 2a 70 4e 65 77 20 20 20 nixFile *pNew
2ad20 20 20 20 20 20 20 20 20 2f 2a 20 74 68 65 20 6f /* the o
2ad30 70 65 6e 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 pen file object
2ad40 2a 2f 0a 29 7b 0a 20 20 73 74 72 75 63 74 20 66 */.){. struct f
2ad50 6c 6f 63 6b 20 6c 6f 63 6b 49 6e 66 6f 3b 0a 0a lock lockInfo;..
2ad60 20 20 69 66 28 20 21 66 69 6c 65 50 61 74 68 20 if( !filePath
2ad70 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 66 69 6c ){. /* If fil
2ad80 65 50 61 74 68 3d 3d 4e 55 4c 4c 20 74 68 61 74 ePath==NULL that
2ad90 20 6d 65 61 6e 73 20 77 65 20 61 72 65 20 64 65 means we are de
2ada0 61 6c 69 6e 67 20 77 69 74 68 20 61 20 74 72 61 aling with a tra
2adb0 6e 73 69 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 nsient file.
2adc0 2a 2a 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 ** that does not
2add0 20 6e 65 65 64 20 74 6f 20 62 65 20 6c 6f 63 6b need to be lock
2ade0 65 64 2e 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 ed. */. retur
2adf0 6e 20 26 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f n &nolockIoMetho
2ae00 64 73 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 65 ds;. }.. /* Te
2ae10 73 74 20 69 66 20 66 63 6e 74 6c 28 29 20 69 73 st if fcntl() is
2ae20 20 73 75 70 70 6f 72 74 65 64 20 61 6e 64 20 75 supported and u
2ae30 73 65 20 50 4f 53 49 58 20 73 74 79 6c 65 20 6c se POSIX style l
2ae40 6f 63 6b 73 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 ocks.. ** Other
2ae50 77 69 73 65 20 66 61 6c 6c 20 62 61 63 6b 20 74 wise fall back t
2ae60 6f 20 74 68 65 20 6e 61 6d 65 64 20 73 65 6d 61 o the named sema
2ae70 70 68 6f 72 65 20 6d 65 74 68 6f 64 2e 0a 20 20 phore method..
2ae80 2a 2f 0a 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f */. lockInfo.l_
2ae90 6c 65 6e 20 3d 20 31 3b 0a 20 20 6c 6f 63 6b 49 len = 1;. lockI
2aea0 6e 66 6f 2e 6c 5f 73 74 61 72 74 20 3d 20 30 3b nfo.l_start = 0;
2aeb0 0a 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 77 68 . lockInfo.l_wh
2aec0 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b ence = SEEK_SET;
2aed0 0a 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 74 79 . lockInfo.l_ty
2aee0 70 65 20 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 pe = F_RDLCK;.
2aef0 69 66 28 20 6f 73 46 63 6e 74 6c 28 70 4e 65 77 if( osFcntl(pNew
2af00 2d 3e 68 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c ->h, F_GETLK, &l
2af10 6f 63 6b 49 6e 66 6f 29 21 3d 2d 31 20 29 20 7b ockInfo)!=-1 ) {
2af20 0a 20 20 20 20 72 65 74 75 72 6e 20 26 70 6f 73 . return &pos
2af30 69 78 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d ixIoMethods;. }
2af40 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e else{. return
2af50 20 26 73 65 6d 49 6f 4d 65 74 68 6f 64 73 3b 0a &semIoMethods;.
2af60 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 63 6f 6e }.}.static con
2af70 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 st sqlite3_io_me
2af80 74 68 6f 64 73 20 0a 20 20 2a 28 2a 63 6f 6e 73 thods . *(*cons
2af90 74 20 76 78 77 6f 72 6b 73 49 6f 46 69 6e 64 65 t vxworksIoFinde
2afa0 72 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 r)(const char*,u
2afb0 6e 69 78 46 69 6c 65 2a 29 20 3d 20 76 78 77 6f nixFile*) = vxwo
2afc0 72 6b 73 49 6f 46 69 6e 64 65 72 49 6d 70 6c 3b rksIoFinderImpl;
2afd0 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 ..#endif /* OS_V
2afe0 58 57 4f 52 4b 53 20 2a 2f 0a 0a 2f 2a 0a 2a 2a XWORKS */../*.**
2aff0 20 41 6e 20 61 62 73 74 72 61 63 74 20 74 79 70 An abstract typ
2b000 65 20 66 6f 72 20 61 20 70 6f 69 6e 74 65 72 20 e for a pointer
2b010 74 6f 20 61 6e 20 49 4f 20 6d 65 74 68 6f 64 20 to an IO method
2b020 66 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 3a finder function:
2b030 0a 2a 2f 0a 74 79 70 65 64 65 66 20 63 6f 6e 73 .*/.typedef cons
2b040 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 t sqlite3_io_met
2b050 68 6f 64 73 20 2a 28 2a 66 69 6e 64 65 72 5f 74 hods *(*finder_t
2b060 79 70 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a ype)(const char*
2b070 2c 75 6e 69 78 46 69 6c 65 2a 29 3b 0a 0a 0a 2f ,unixFile*);.../
2b080 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b090 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b0a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b0b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b0c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a ************.***
2b0d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b0e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 ********* sqlite
2b0f0 33 5f 76 66 73 20 6d 65 74 68 6f 64 73 20 2a 2a 3_vfs methods **
2b100 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
2b110 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a **********.**.**
2b120 20 54 68 69 73 20 64 69 76 69 73 69 6f 6e 20 63 This division c
2b130 6f 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c ontains the impl
2b140 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 6d 65 ementation of me
2b150 74 68 6f 64 73 20 6f 6e 20 74 68 65 0a 2a 2a 20 thods on the.**
2b160 73 71 6c 69 74 65 33 5f 76 66 73 20 6f 62 6a 65 sqlite3_vfs obje
2b170 63 74 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6e ct..*/../*.** In
2b180 69 74 69 61 6c 69 7a 65 20 74 68 65 20 63 6f 6e itialize the con
2b190 74 65 6e 74 73 20 6f 66 20 74 68 65 20 75 6e 69 tents of the uni
2b1a0 78 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 xFile structure
2b1b0 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 70 49 pointed to by pI
2b1c0 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
2b1d0 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 6c 65 28 fillInUnixFile(
2b1e0 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
2b1f0 70 56 66 73 2c 20 20 20 20 20 20 2f 2a 20 50 6f pVfs, /* Po
2b200 69 6e 74 65 72 20 74 6f 20 76 66 73 20 6f 62 6a inter to vfs obj
2b210 65 63 74 20 2a 2f 0a 20 20 69 6e 74 20 68 2c 20 ect */. int h,
2b220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b230 20 2f 2a 20 4f 70 65 6e 20 66 69 6c 65 20 64 65 /* Open file de
2b240 73 63 72 69 70 74 6f 72 20 6f 66 20 66 69 6c 65 scriptor of file
2b250 20 62 65 69 6e 67 20 6f 70 65 6e 65 64 20 2a 2f being opened */
2b260 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 . sqlite3_file
2b270 2a 70 49 64 2c 20 20 20 20 20 20 2f 2a 20 57 72 *pId, /* Wr
2b280 69 74 65 20 74 6f 20 74 68 65 20 75 6e 69 78 46 ite to the unixF
2b290 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 68 65 ile structure he
2b2a0 72 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 re */. const ch
2b2b0 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
2b2c0 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 /* Name of the f
2b2d0 69 6c 65 20 62 65 69 6e 67 20 6f 70 65 6e 65 64 ile being opened
2b2e0 20 2a 2f 0a 20 20 69 6e 74 20 63 74 72 6c 46 6c */. int ctrlFl
2b2f0 61 67 73 20 20 20 20 20 20 20 20 20 20 20 2f 2a ags /*
2b300 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 55 4e Zero or more UN
2b310 49 58 46 49 4c 45 5f 2a 20 76 61 6c 75 65 73 20 IXFILE_* values
2b320 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 73 71 */.){. const sq
2b330 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 lite3_io_methods
2b340 20 2a 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 3b *pLockingStyle;
2b350 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 4e 65 . unixFile *pNe
2b360 77 20 3d 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 w = (unixFile *)
2b370 70 49 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 pId;. int rc =
2b380 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 SQLITE_OK;.. as
2b390 73 65 72 74 28 20 70 4e 65 77 2d 3e 70 49 6e 6f sert( pNew->pIno
2b3a0 64 65 3d 3d 4e 55 4c 4c 20 29 3b 0a 0a 20 20 2f de==NULL );.. /
2b3b0 2a 20 55 73 75 61 6c 6c 79 20 74 68 65 20 70 61 * Usually the pa
2b3c0 74 68 20 7a 46 69 6c 65 6e 61 6d 65 20 73 68 6f th zFilename sho
2b3d0 75 6c 64 20 6e 6f 74 20 62 65 20 61 20 72 65 6c uld not be a rel
2b3e0 61 74 69 76 65 20 70 61 74 68 6e 61 6d 65 2e 20 ative pathname.
2b3f0 54 68 65 0a 20 20 2a 2a 20 65 78 63 65 70 74 69 The. ** excepti
2b400 6f 6e 20 69 73 20 77 68 65 6e 20 6f 70 65 6e 69 on is when openi
2b410 6e 67 20 74 68 65 20 70 72 6f 78 79 20 22 63 6f ng the proxy "co
2b420 6e 63 68 22 20 66 69 6c 65 20 69 6e 20 62 75 69 nch" file in bui
2b430 6c 64 73 20 74 68 61 74 0a 20 20 2a 2a 20 69 6e lds that. ** in
2b440 63 6c 75 64 65 20 74 68 65 20 73 70 65 63 69 61 clude the specia
2b450 6c 20 41 70 70 6c 65 20 6c 6f 63 6b 69 6e 67 20 l Apple locking
2b460 73 74 79 6c 65 73 2e 0a 20 20 2a 2f 0a 23 69 66 styles.. */.#if
2b470 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 defined(__APPLE
2b480 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 4e __) && SQLITE_EN
2b490 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 ABLE_LOCKING_STY
2b4a0 4c 45 0a 20 20 61 73 73 65 72 74 28 20 7a 46 69 LE. assert( zFi
2b4b0 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 7a 46 69 lename==0 || zFi
2b4c0 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 27 2f 27 20 0a lename[0]=='/' .
2b4d0 20 20 20 20 7c 7c 20 70 56 66 73 2d 3e 70 41 70 || pVfs->pAp
2b4e0 70 44 61 74 61 3d 3d 28 76 6f 69 64 2a 29 26 61 pData==(void*)&a
2b4f0 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 20 utolockIoFinder
2b500 29 3b 0a 23 65 6c 73 65 0a 20 20 61 73 73 65 72 );.#else. asser
2b510 74 28 20 7a 46 69 6c 65 6e 61 6d 65 3d 3d 30 20 t( zFilename==0
2b520 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 3d || zFilename[0]=
2b530 3d 27 2f 27 20 29 3b 0a 23 65 6e 64 69 66 0a 0a ='/' );.#endif..
2b540 20 20 2f 2a 20 4e 6f 20 6c 6f 63 6b 69 6e 67 20 /* No locking
2b550 6f 63 63 75 72 73 20 69 6e 20 74 65 6d 70 6f 72 occurs in tempor
2b560 61 72 79 20 66 69 6c 65 73 20 2a 2f 0a 20 20 61 ary files */. a
2b570 73 73 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65 ssert( zFilename
2b580 21 3d 30 20 7c 7c 20 28 63 74 72 6c 46 6c 61 67 !=0 || (ctrlFlag
2b590 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 4e 4f 4c s & UNIXFILE_NOL
2b5a0 4f 43 4b 29 21 3d 30 20 29 3b 0a 0a 20 20 4f 53 OCK)!=0 );.. OS
2b5b0 54 52 41 43 45 28 28 22 4f 50 45 4e 20 20 20 20 TRACE(("OPEN
2b5c0 25 2d 33 64 20 25 73 5c 6e 22 2c 20 68 2c 20 7a %-3d %s\n", h, z
2b5d0 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 70 4e Filename));. pN
2b5e0 65 77 2d 3e 68 20 3d 20 68 3b 0a 20 20 70 4e 65 ew->h = h;. pNe
2b5f0 77 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a w->pVfs = pVfs;.
2b600 20 20 70 4e 65 77 2d 3e 7a 50 61 74 68 20 3d 20 pNew->zPath =
2b610 7a 46 69 6c 65 6e 61 6d 65 3b 0a 20 20 70 4e 65 zFilename;. pNe
2b620 77 2d 3e 63 74 72 6c 46 6c 61 67 73 20 3d 20 28 w->ctrlFlags = (
2b630 75 38 29 63 74 72 6c 46 6c 61 67 73 3b 0a 23 69 u8)ctrlFlags;.#i
2b640 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 f SQLITE_MAX_MMA
2b650 50 5f 53 49 5a 45 3e 30 0a 20 20 70 4e 65 77 2d P_SIZE>0. pNew-
2b660 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 20 3d 20 73 >mmapSizeMax = s
2b670 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
2b680 69 67 2e 73 7a 4d 6d 61 70 3b 0a 23 65 6e 64 69 ig.szMmap;.#endi
2b690 66 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f f. if( sqlite3_
2b6a0 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 28 28 63 74 uri_boolean(((ct
2b6b0 72 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 rlFlags & UNIXFI
2b6c0 4c 45 5f 55 52 49 29 20 3f 20 7a 46 69 6c 65 6e LE_URI) ? zFilen
2b6d0 61 6d 65 20 3a 20 30 29 2c 0a 20 20 20 20 20 20 ame : 0),.
2b6e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b6f0 20 20 20 20 20 22 70 73 6f 77 22 2c 20 53 51 4c "psow", SQL
2b700 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 ITE_POWERSAFE_OV
2b710 45 52 57 52 49 54 45 29 20 29 7b 0a 20 20 20 20 ERWRITE) ){.
2b720 70 4e 65 77 2d 3e 63 74 72 6c 46 6c 61 67 73 20 pNew->ctrlFlags
2b730 7c 3d 20 55 4e 49 58 46 49 4c 45 5f 50 53 4f 57 |= UNIXFILE_PSOW
2b740 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 74 72 63 ;. }. if( strc
2b750 6d 70 28 70 56 66 73 2d 3e 7a 4e 61 6d 65 2c 22 mp(pVfs->zName,"
2b760 75 6e 69 78 2d 65 78 63 6c 22 29 3d 3d 30 20 29 unix-excl")==0 )
2b770 7b 0a 20 20 20 20 70 4e 65 77 2d 3e 63 74 72 6c {. pNew->ctrl
2b780 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c Flags |= UNIXFIL
2b790 45 5f 45 58 43 4c 3b 0a 20 20 7d 0a 0a 23 69 66 E_EXCL;. }..#if
2b7a0 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 70 4e OS_VXWORKS. pN
2b7b0 65 77 2d 3e 70 49 64 20 3d 20 76 78 77 6f 72 6b ew->pId = vxwork
2b7c0 73 46 69 6e 64 46 69 6c 65 49 64 28 7a 46 69 6c sFindFileId(zFil
2b7d0 65 6e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 4e ename);. if( pN
2b7e0 65 77 2d 3e 70 49 64 3d 3d 30 20 29 7b 0a 20 20 ew->pId==0 ){.
2b7f0 20 20 63 74 72 6c 46 6c 61 67 73 20 7c 3d 20 55 ctrlFlags |= U
2b800 4e 49 58 46 49 4c 45 5f 4e 4f 4c 4f 43 4b 3b 0a NIXFILE_NOLOCK;.
2b810 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2b820 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a NOMEM_BKPT;. }.
2b830 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 63 74 #endif.. if( ct
2b840 72 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 rlFlags & UNIXFI
2b850 4c 45 5f 4e 4f 4c 4f 43 4b 20 29 7b 0a 20 20 20 LE_NOLOCK ){.
2b860 20 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d pLockingStyle =
2b870 20 26 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 &nolockIoMethod
2b880 73 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 s;. }else{.
2b890 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d 20 pLockingStyle =
2b8a0 28 2a 2a 28 66 69 6e 64 65 72 5f 74 79 70 65 2a (**(finder_type*
2b8b0 29 70 56 66 73 2d 3e 70 41 70 70 44 61 74 61 29 )pVfs->pAppData)
2b8c0 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 4e 65 77 (zFilename, pNew
2b8d0 29 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e );.#if SQLITE_EN
2b8e0 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 ABLE_LOCKING_STY
2b8f0 4c 45 0a 20 20 20 20 2f 2a 20 43 61 63 68 65 20 LE. /* Cache
2b900 7a 46 69 6c 65 6e 61 6d 65 20 69 6e 20 74 68 65 zFilename in the
2b910 20 6c 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 locking context
2b920 20 28 41 46 50 20 61 6e 64 20 64 6f 74 6c 6f 63 (AFP and dotloc
2b930 6b 20 6f 76 65 72 72 69 64 65 29 20 66 6f 72 0a k override) for.
2b940 20 20 20 20 2a 2a 20 70 72 6f 78 79 4c 6f 63 6b ** proxyLock
2b950 20 61 63 74 69 76 61 74 69 6f 6e 20 69 73 20 70 activation is p
2b960 6f 73 73 69 62 6c 65 20 28 72 65 6d 6f 74 65 20 ossible (remote
2b970 70 72 6f 78 79 20 69 73 20 62 61 73 65 64 20 6f proxy is based o
2b980 6e 20 64 62 20 6e 61 6d 65 29 0a 20 20 20 20 2a n db name). *
2b990 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 72 65 6d 61 * zFilename rema
2b9a0 69 6e 73 20 76 61 6c 69 64 20 75 6e 74 69 6c 20 ins valid until
2b9b0 66 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 2c 20 file is closed,
2b9c0 74 6f 20 73 75 70 70 6f 72 74 20 2a 2f 0a 20 20 to support */.
2b9d0 20 20 70 4e 65 77 2d 3e 6c 6f 63 6b 69 6e 67 43 pNew->lockingC
2b9e0 6f 6e 74 65 78 74 20 3d 20 28 76 6f 69 64 2a 29 ontext = (void*)
2b9f0 7a 46 69 6c 65 6e 61 6d 65 3b 0a 23 65 6e 64 69 zFilename;.#endi
2ba00 66 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 4c 6f f. }.. if( pLo
2ba10 63 6b 69 6e 67 53 74 79 6c 65 20 3d 3d 20 26 70 ckingStyle == &p
2ba20 6f 73 69 78 49 6f 4d 65 74 68 6f 64 73 0a 23 69 osixIoMethods.#i
2ba30 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c f defined(__APPL
2ba40 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45 E__) && SQLITE_E
2ba50 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
2ba60 59 4c 45 0a 20 20 20 20 7c 7c 20 70 4c 6f 63 6b YLE. || pLock
2ba70 69 6e 67 53 74 79 6c 65 20 3d 3d 20 26 6e 66 73 ingStyle == &nfs
2ba80 49 6f 4d 65 74 68 6f 64 73 0a 23 65 6e 64 69 66 IoMethods.#endif
2ba90 0a 20 20 29 7b 0a 20 20 20 20 75 6e 69 78 45 6e . ){. unixEn
2baa0 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 terMutex();.
2bab0 72 63 20 3d 20 66 69 6e 64 49 6e 6f 64 65 49 6e rc = findInodeIn
2bac0 66 6f 28 70 4e 65 77 2c 20 26 70 4e 65 77 2d 3e fo(pNew, &pNew->
2bad0 70 49 6e 6f 64 65 29 3b 0a 20 20 20 20 69 66 28 pInode);. if(
2bae0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2baf0 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6e {. /* If an
2bb00 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20 error occurred
2bb10 69 6e 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f in findInodeInfo
2bb20 28 29 2c 20 63 6c 6f 73 65 20 74 68 65 20 66 69 (), close the fi
2bb30 6c 65 20 64 65 73 63 72 69 70 74 6f 72 0a 20 20 le descriptor.
2bb40 20 20 20 20 2a 2a 20 69 6d 6d 65 64 69 61 74 65 ** immediate
2bb50 6c 79 2c 20 62 65 66 6f 72 65 20 72 65 6c 65 61 ly, before relea
2bb60 73 69 6e 67 20 74 68 65 20 6d 75 74 65 78 2e 20 sing the mutex.
2bb70 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 29 20 findInodeInfo()
2bb80 6d 61 79 20 66 61 69 6c 0a 20 20 20 20 20 20 2a may fail. *
2bb90 2a 20 69 6e 20 74 77 6f 20 73 63 65 6e 61 72 69 * in two scenari
2bba0 6f 73 3a 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 os:. **.
2bbb0 20 20 20 2a 2a 20 20 20 28 61 29 20 41 20 63 61 ** (a) A ca
2bbc0 6c 6c 20 74 6f 20 66 73 74 61 74 28 29 20 66 61 ll to fstat() fa
2bbd0 69 6c 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 20 iled.. **
2bbe0 20 28 62 29 20 41 20 6d 61 6c 6c 6f 63 20 66 61 (b) A malloc fa
2bbf0 69 6c 65 64 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 iled.. **.
2bc00 20 20 20 20 20 2a 2a 20 53 63 65 6e 61 72 69 6f ** Scenario
2bc10 20 28 62 29 20 6d 61 79 20 6f 6e 6c 79 20 6f 63 (b) may only oc
2bc20 63 75 72 20 69 66 20 74 68 65 20 70 72 6f 63 65 cur if the proce
2bc30 73 73 20 69 73 20 68 6f 6c 64 69 6e 67 20 6e 6f ss is holding no
2bc40 20 6f 74 68 65 72 0a 20 20 20 20 20 20 2a 2a 20 other. **
2bc50 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 file descriptors
2bc60 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d open on the sam
2bc70 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 72 65 e file. If there
2bc80 20 77 65 72 65 20 6f 74 68 65 72 20 66 69 6c 65 were other file
2bc90 0a 20 20 20 20 20 20 2a 2a 20 64 65 73 63 72 69 . ** descri
2bca0 70 74 6f 72 73 20 6f 6e 20 74 68 69 73 20 66 69 ptors on this fi
2bcb0 6c 65 2c 20 74 68 65 6e 20 6e 6f 20 6d 61 6c 6c le, then no mall
2bcc0 6f 63 20 77 6f 75 6c 64 20 62 65 20 72 65 71 75 oc would be requ
2bcd0 69 72 65 64 20 62 79 0a 20 20 20 20 20 20 2a 2a ired by. **
2bce0 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 29 findInodeInfo()
2bcf0 2e 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 . If this is the
2bd00 20 63 61 73 65 2c 20 69 74 20 69 73 20 71 75 69 case, it is qui
2bd10 74 65 20 73 61 66 65 20 74 6f 20 63 6c 6f 73 65 te safe to close
2bd20 0a 20 20 20 20 20 20 2a 2a 20 68 61 6e 64 6c 65 . ** handle
2bd30 20 68 20 2d 20 61 73 20 69 74 20 69 73 20 67 75 h - as it is gu
2bd40 61 72 61 6e 74 65 65 64 20 74 68 61 74 20 6e 6f aranteed that no
2bd50 20 70 6f 73 69 78 20 6c 6f 63 6b 73 20 77 69 6c posix locks wil
2bd60 6c 20 62 65 20 72 65 6c 65 61 73 65 64 0a 20 20 l be released.
2bd70 20 20 20 20 2a 2a 20 62 79 20 64 6f 69 6e 67 20 ** by doing
2bd80 73 6f 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 so.. **.
2bd90 20 20 20 2a 2a 20 49 66 20 73 63 65 6e 61 72 69 ** If scenari
2bda0 6f 20 28 61 29 20 63 61 75 73 65 64 20 74 68 65 o (a) caused the
2bdb0 20 65 72 72 6f 72 20 74 68 65 6e 20 74 68 69 6e error then thin
2bdc0 67 73 20 61 72 65 20 6e 6f 74 20 73 6f 20 73 61 gs are not so sa
2bdd0 66 65 2e 20 54 68 65 0a 20 20 20 20 20 20 2a 2a fe. The. **
2bde0 20 69 6d 70 6c 69 63 69 74 20 61 73 73 75 6d 70 implicit assump
2bdf0 74 69 6f 6e 20 68 65 72 65 20 69 73 20 74 68 61 tion here is tha
2be00 74 20 69 66 20 66 73 74 61 74 28 29 20 66 61 69 t if fstat() fai
2be10 6c 73 2c 20 74 68 69 6e 67 73 20 61 72 65 20 69 ls, things are i
2be20 6e 0a 20 20 20 20 20 20 2a 2a 20 73 75 63 68 20 n. ** such
2be30 62 61 64 20 73 68 61 70 65 20 74 68 61 74 20 64 bad shape that d
2be40 72 6f 70 70 69 6e 67 20 61 20 6c 6f 63 6b 20 6f ropping a lock o
2be50 72 20 74 77 6f 20 64 6f 65 73 6e 27 74 20 6d 61 r two doesn't ma
2be60 74 74 65 72 20 6d 75 63 68 2e 0a 20 20 20 20 20 tter much..
2be70 20 2a 2f 0a 20 20 20 20 20 20 72 6f 62 75 73 74 */. robust
2be80 5f 63 6c 6f 73 65 28 70 4e 65 77 2c 20 68 2c 20 _close(pNew, h,
2be90 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 20 __LINE__);.
2bea0 20 68 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 h = -1;. }.
2beb0 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 unixLeaveMute
2bec0 78 28 29 3b 0a 20 20 7d 0a 0a 23 69 66 20 53 51 x();. }..#if SQ
2bed0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b LITE_ENABLE_LOCK
2bee0 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 64 65 66 ING_STYLE && def
2bef0 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a ined(__APPLE__).
2bf00 20 20 65 6c 73 65 20 69 66 28 20 70 4c 6f 63 6b else if( pLock
2bf10 69 6e 67 53 74 79 6c 65 20 3d 3d 20 26 61 66 70 ingStyle == &afp
2bf20 49 6f 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 IoMethods ){.
2bf30 20 2f 2a 20 41 46 50 20 6c 6f 63 6b 69 6e 67 20 /* AFP locking
2bf40 75 73 65 73 20 74 68 65 20 66 69 6c 65 20 70 61 uses the file pa
2bf50 74 68 20 73 6f 20 69 74 20 6e 65 65 64 73 20 74 th so it needs t
2bf60 6f 20 62 65 20 69 6e 63 6c 75 64 65 64 20 69 6e o be included in
2bf70 0a 20 20 20 20 2a 2a 20 74 68 65 20 61 66 70 4c . ** the afpL
2bf80 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 2e 0a 20 ockingContext..
2bf90 20 20 20 2a 2f 0a 20 20 20 20 61 66 70 4c 6f 63 */. afpLoc
2bfa0 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 70 43 74 kingContext *pCt
2bfb0 78 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6c 6f 63 x;. pNew->loc
2bfc0 6b 69 6e 67 43 6f 6e 74 65 78 74 20 3d 20 70 43 kingContext = pC
2bfd0 74 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c tx = sqlite3_mal
2bfe0 6c 6f 63 36 34 28 20 73 69 7a 65 6f 66 28 2a 70 loc64( sizeof(*p
2bff0 43 74 78 29 20 29 3b 0a 20 20 20 20 69 66 28 20 Ctx) );. if(
2c000 70 43 74 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 pCtx==0 ){.
2c010 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
2c020 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c EM_BKPT;. }el
2c030 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 4e 42 3a se{. /* NB:
2c040 20 7a 46 69 6c 65 6e 61 6d 65 20 65 78 69 73 74 zFilename exist
2c050 73 20 61 6e 64 20 72 65 6d 61 69 6e 73 20 76 61 s and remains va
2c060 6c 69 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 lid until the fi
2c070 6c 65 20 69 73 20 63 6c 6f 73 65 64 0a 20 20 20 le is closed.
2c080 20 20 20 2a 2a 20 61 63 63 6f 72 64 69 6e 67 20 ** according
2c090 74 6f 20 72 65 71 75 69 72 65 6d 65 6e 74 20 46 to requirement F
2c0a0 31 31 31 34 31 2e 20 20 53 6f 20 77 65 20 64 6f 11141. So we do
2c0b0 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 6d 61 6b not need to mak
2c0c0 65 20 61 0a 20 20 20 20 20 20 2a 2a 20 63 6f 70 e a. ** cop
2c0d0 79 20 6f 66 20 74 68 65 20 66 69 6c 65 6e 61 6d y of the filenam
2c0e0 65 2e 20 2a 2f 0a 20 20 20 20 20 20 70 43 74 78 e. */. pCtx
2c0f0 2d 3e 64 62 50 61 74 68 20 3d 20 7a 46 69 6c 65 ->dbPath = zFile
2c100 6e 61 6d 65 3b 0a 20 20 20 20 20 20 70 43 74 78 name;. pCtx
2c110 2d 3e 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a ->reserved = 0;.
2c120 20 20 20 20 20 20 73 72 61 6e 64 6f 6d 64 65 76 srandomdev
2c130 28 29 3b 0a 20 20 20 20 20 20 75 6e 69 78 45 6e ();. unixEn
2c140 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 terMutex();.
2c150 20 20 72 63 20 3d 20 66 69 6e 64 49 6e 6f 64 65 rc = findInode
2c160 49 6e 66 6f 28 70 4e 65 77 2c 20 26 70 4e 65 77 Info(pNew, &pNew
2c170 2d 3e 70 49 6e 6f 64 65 29 3b 0a 20 20 20 20 20 ->pInode);.
2c180 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
2c190 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 OK ){. sq
2c1a0 6c 69 74 65 33 5f 66 72 65 65 28 70 4e 65 77 2d lite3_free(pNew-
2c1b0 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 29 >lockingContext)
2c1c0 3b 0a 20 20 20 20 20 20 20 20 72 6f 62 75 73 74 ;. robust
2c1d0 5f 63 6c 6f 73 65 28 70 4e 65 77 2c 20 68 2c 20 _close(pNew, h,
2c1e0 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 20 __LINE__);.
2c1f0 20 20 20 68 20 3d 20 2d 31 3b 0a 20 20 20 20 20 h = -1;.
2c200 20 7d 0a 20 20 20 20 20 20 75 6e 69 78 4c 65 61 }. unixLea
2c210 76 65 4d 75 74 65 78 28 29 3b 20 20 20 20 20 20 veMutex();
2c220 20 20 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e . }. }.#en
2c230 64 69 66 0a 0a 20 20 65 6c 73 65 20 69 66 28 20 dif.. else if(
2c240 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d 3d pLockingStyle ==
2c250 20 26 64 6f 74 6c 6f 63 6b 49 6f 4d 65 74 68 6f &dotlockIoMetho
2c260 64 73 20 29 7b 0a 20 20 20 20 2f 2a 20 44 6f 74 ds ){. /* Dot
2c270 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 75 73 65 file locking use
2c280 73 20 74 68 65 20 66 69 6c 65 20 70 61 74 68 20 s the file path
2c290 73 6f 20 69 74 20 6e 65 65 64 73 20 74 6f 20 62 so it needs to b
2c2a0 65 20 69 6e 63 6c 75 64 65 64 20 69 6e 0a 20 20 e included in.
2c2b0 20 20 2a 2a 20 74 68 65 20 64 6f 74 6c 6f 63 6b ** the dotlock
2c2c0 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 0a LockingContext .
2c2d0 20 20 20 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 */. char
2c2e0 2a 7a 4c 6f 63 6b 46 69 6c 65 3b 0a 20 20 20 20 *zLockFile;.
2c2f0 69 6e 74 20 6e 46 69 6c 65 6e 61 6d 65 3b 0a 20 int nFilename;.
2c300 20 20 20 61 73 73 65 72 74 28 20 7a 46 69 6c 65 assert( zFile
2c310 6e 61 6d 65 21 3d 30 20 29 3b 0a 20 20 20 20 6e name!=0 );. n
2c320 46 69 6c 65 6e 61 6d 65 20 3d 20 28 69 6e 74 29 Filename = (int)
2c330 73 74 72 6c 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 strlen(zFilename
2c340 29 20 2b 20 36 3b 0a 20 20 20 20 7a 4c 6f 63 6b ) + 6;. zLock
2c350 46 69 6c 65 20 3d 20 28 63 68 61 72 20 2a 29 73 File = (char *)s
2c360 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 36 34 28 qlite3_malloc64(
2c370 6e 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 nFilename);.
2c380 69 66 28 20 7a 4c 6f 63 6b 46 69 6c 65 3d 3d 30 if( zLockFile==0
2c390 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
2c3a0 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
2c3b0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
2c3c0 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 sqlite3_snpri
2c3d0 6e 74 66 28 6e 46 69 6c 65 6e 61 6d 65 2c 20 7a ntf(nFilename, z
2c3e0 4c 6f 63 6b 46 69 6c 65 2c 20 22 25 73 22 20 44 LockFile, "%s" D
2c3f0 4f 54 4c 4f 43 4b 5f 53 55 46 46 49 58 2c 20 7a OTLOCK_SUFFIX, z
2c400 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 7d Filename);. }
2c410 0a 20 20 20 20 70 4e 65 77 2d 3e 6c 6f 63 6b 69 . pNew->locki
2c420 6e 67 43 6f 6e 74 65 78 74 20 3d 20 7a 4c 6f 63 ngContext = zLoc
2c430 6b 46 69 6c 65 3b 0a 20 20 7d 0a 0a 23 69 66 20 kFile;. }..#if
2c440 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 65 6c 73 OS_VXWORKS. els
2c450 65 20 69 66 28 20 70 4c 6f 63 6b 69 6e 67 53 74 e if( pLockingSt
2c460 79 6c 65 20 3d 3d 20 26 73 65 6d 49 6f 4d 65 74 yle == &semIoMet
2c470 68 6f 64 73 20 29 7b 0a 20 20 20 20 2f 2a 20 4e hods ){. /* N
2c480 61 6d 65 64 20 73 65 6d 61 70 68 6f 72 65 20 6c amed semaphore l
2c490 6f 63 6b 69 6e 67 20 75 73 65 73 20 74 68 65 20 ocking uses the
2c4a0 66 69 6c 65 20 70 61 74 68 20 73 6f 20 69 74 20 file path so it
2c4b0 6e 65 65 64 73 20 74 6f 20 62 65 0a 20 20 20 20 needs to be.
2c4c0 2a 2a 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 ** included in t
2c4d0 68 65 20 73 65 6d 4c 6f 63 6b 69 6e 67 43 6f 6e he semLockingCon
2c4e0 74 65 78 74 0a 20 20 20 20 2a 2f 0a 20 20 20 20 text. */.
2c4f0 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 unixEnterMutex()
2c500 3b 0a 20 20 20 20 72 63 20 3d 20 66 69 6e 64 49 ;. rc = findI
2c510 6e 6f 64 65 49 6e 66 6f 28 70 4e 65 77 2c 20 26 nodeInfo(pNew, &
2c520 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 29 3b 0a 20 pNew->pInode);.
2c530 20 20 20 69 66 28 20 28 72 63 3d 3d 53 51 4c 49 if( (rc==SQLI
2c540 54 45 5f 4f 4b 29 20 26 26 20 28 70 4e 65 77 2d TE_OK) && (pNew-
2c550 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 6d 3d 3d 4e >pInode->pSem==N
2c560 55 4c 4c 29 20 29 7b 0a 20 20 20 20 20 20 63 68 ULL) ){. ch
2c570 61 72 20 2a 7a 53 65 6d 4e 61 6d 65 20 3d 20 70 ar *zSemName = p
2c580 4e 65 77 2d 3e 70 49 6e 6f 64 65 2d 3e 61 53 65 New->pInode->aSe
2c590 6d 4e 61 6d 65 3b 0a 20 20 20 20 20 20 69 6e 74 mName;. int
2c5a0 20 6e 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 n;. sqlite
2c5b0 33 5f 73 6e 70 72 69 6e 74 66 28 4d 41 58 5f 50 3_snprintf(MAX_P
2c5c0 41 54 48 4e 41 4d 45 2c 20 7a 53 65 6d 4e 61 6d ATHNAME, zSemNam
2c5d0 65 2c 20 22 2f 25 73 2e 73 65 6d 22 2c 0a 20 20 e, "/%s.sem",.
2c5e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2c5f0 20 20 20 20 20 70 4e 65 77 2d 3e 70 49 64 2d 3e pNew->pId->
2c600 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 29 3b zCanonicalName);
2c610 0a 20 20 20 20 20 20 66 6f 72 28 20 6e 3d 31 3b . for( n=1;
2c620 20 7a 53 65 6d 4e 61 6d 65 5b 6e 5d 3b 20 6e 2b zSemName[n]; n+
2c630 2b 20 29 0a 20 20 20 20 20 20 20 20 69 66 28 20 + ). if(
2c640 7a 53 65 6d 4e 61 6d 65 5b 6e 5d 3d 3d 27 2f 27 zSemName[n]=='/'
2c650 20 29 20 7a 53 65 6d 4e 61 6d 65 5b 6e 5d 20 3d ) zSemName[n] =
2c660 20 27 5f 27 3b 0a 20 20 20 20 20 20 70 4e 65 77 '_';. pNew
2c670 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 6d 20 3d ->pInode->pSem =
2c680 20 73 65 6d 5f 6f 70 65 6e 28 7a 53 65 6d 4e 61 sem_open(zSemNa
2c690 6d 65 2c 20 4f 5f 43 52 45 41 54 2c 20 30 36 36 me, O_CREAT, 066
2c6a0 36 2c 20 31 29 3b 0a 20 20 20 20 20 20 69 66 28 6, 1);. if(
2c6b0 20 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 2d 3e 70 pNew->pInode->p
2c6c0 53 65 6d 20 3d 3d 20 53 45 4d 5f 46 41 49 4c 45 Sem == SEM_FAILE
2c6d0 44 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 D ){. rc
2c6e0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 = SQLITE_NOMEM_B
2c6f0 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 KPT;. pNe
2c700 77 2d 3e 70 49 6e 6f 64 65 2d 3e 61 53 65 6d 4e w->pInode->aSemN
2c710 61 6d 65 5b 30 5d 20 3d 20 27 5c 30 27 3b 0a 20 ame[0] = '\0';.
2c720 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
2c730 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 unixLeaveMutex(
2c740 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 );. }.#endif.
2c750 0a 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e . storeLastErrn
2c760 6f 28 70 4e 65 77 2c 20 30 29 3b 0a 23 69 66 20 o(pNew, 0);.#if
2c770 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 69 66 28 OS_VXWORKS. if(
2c780 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2c790 7b 0a 20 20 20 20 69 66 28 20 68 3e 3d 30 20 29 {. if( h>=0 )
2c7a0 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 4e robust_close(pN
2c7b0 65 77 2c 20 68 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 ew, h, __LINE__)
2c7c0 3b 0a 20 20 20 20 68 20 3d 20 2d 31 3b 0a 20 20 ;. h = -1;.
2c7d0 20 20 6f 73 55 6e 6c 69 6e 6b 28 7a 46 69 6c 65 osUnlink(zFile
2c7e0 6e 61 6d 65 29 3b 0a 20 20 20 20 70 4e 65 77 2d name);. pNew-
2c7f0 3e 63 74 72 6c 46 6c 61 67 73 20 7c 3d 20 55 4e >ctrlFlags |= UN
2c800 49 58 46 49 4c 45 5f 44 45 4c 45 54 45 3b 0a 20 IXFILE_DELETE;.
2c810 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 }.#endif. if(
2c820 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2c830 0a 20 20 20 20 69 66 28 20 68 3e 3d 30 20 29 20 . if( h>=0 )
2c840 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 4e 65 robust_close(pNe
2c850 77 2c 20 68 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b w, h, __LINE__);
2c860 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e . }else{. pN
2c870 65 77 2d 3e 70 4d 65 74 68 6f 64 20 3d 20 70 4c ew->pMethod = pL
2c880 6f 63 6b 69 6e 67 53 74 79 6c 65 3b 0a 20 20 20 ockingStyle;.
2c890 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 2b 31 29 OpenCounter(+1)
2c8a0 3b 0a 20 20 20 20 76 65 72 69 66 79 44 62 46 69 ;. verifyDbFi
2c8b0 6c 65 28 70 4e 65 77 29 3b 0a 20 20 7d 0a 20 20 le(pNew);. }.
2c8c0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
2c8d0 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e .** Return the n
2c8e0 61 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f ame of a directo
2c8f0 72 79 20 69 6e 20 77 68 69 63 68 20 74 6f 20 70 ry in which to p
2c900 75 74 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c ut temporary fil
2c910 65 73 2e 0a 2a 2a 20 49 66 20 6e 6f 20 73 75 69 es..** If no sui
2c920 74 61 62 6c 65 20 74 65 6d 70 6f 72 61 72 79 20 table temporary
2c930 66 69 6c 65 20 64 69 72 65 63 74 6f 72 79 20 63 file directory c
2c940 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 72 65 74 an be found, ret
2c950 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 urn NULL..*/.sta
2c960 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a tic const char *
2c970 75 6e 69 78 54 65 6d 70 46 69 6c 65 44 69 72 28 unixTempFileDir(
2c980 76 6f 69 64 29 7b 0a 20 20 73 74 61 74 69 63 20 void){. static
2c990 63 6f 6e 73 74 20 63 68 61 72 20 2a 61 7a 44 69 const char *azDi
2c9a0 72 73 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 30 2c rs[] = {. 0,
2c9b0 0a 20 20 20 20 20 30 2c 0a 20 20 20 20 20 22 2f . 0,. "/
2c9c0 76 61 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 var/tmp",. "
2c9d0 2f 75 73 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 /usr/tmp",.
2c9e0 22 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2e 22 "/tmp",. "."
2c9f0 0a 20 20 7d 3b 0a 20 20 75 6e 73 69 67 6e 65 64 . };. unsigned
2ca00 20 69 6e 74 20 69 20 3d 20 30 3b 0a 20 20 73 74 int i = 0;. st
2ca10 72 75 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 ruct stat buf;.
2ca20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 69 const char *zDi
2ca30 72 20 3d 20 73 71 6c 69 74 65 33 5f 74 65 6d 70 r = sqlite3_temp
2ca40 5f 64 69 72 65 63 74 6f 72 79 3b 0a 0a 20 20 69 _directory;.. i
2ca50 66 28 20 21 61 7a 44 69 72 73 5b 30 5d 20 29 20 f( !azDirs[0] )
2ca60 61 7a 44 69 72 73 5b 30 5d 20 3d 20 67 65 74 65 azDirs[0] = gete
2ca70 6e 76 28 22 53 51 4c 49 54 45 5f 54 4d 50 44 49 nv("SQLITE_TMPDI
2ca80 52 22 29 3b 0a 20 20 69 66 28 20 21 61 7a 44 69 R");. if( !azDi
2ca90 72 73 5b 31 5d 20 29 20 61 7a 44 69 72 73 5b 31 rs[1] ) azDirs[1
2caa0 5d 20 3d 20 67 65 74 65 6e 76 28 22 54 4d 50 44 ] = getenv("TMPD
2cab0 49 52 22 29 3b 0a 20 20 77 68 69 6c 65 28 31 29 IR");. while(1)
2cac0 7b 0a 20 20 20 20 69 66 28 20 7a 44 69 72 21 3d {. if( zDir!=
2cad0 30 0a 20 20 20 20 20 26 26 20 6f 73 53 74 61 74 0. && osStat
2cae0 28 7a 44 69 72 2c 20 26 62 75 66 29 3d 3d 30 0a (zDir, &buf)==0.
2caf0 20 20 20 20 20 26 26 20 53 5f 49 53 44 49 52 28 && S_ISDIR(
2cb00 62 75 66 2e 73 74 5f 6d 6f 64 65 29 0a 20 20 20 buf.st_mode).
2cb10 20 20 26 26 20 6f 73 41 63 63 65 73 73 28 7a 44 && osAccess(zD
2cb20 69 72 2c 20 30 33 29 3d 3d 30 0a 20 20 20 20 29 ir, 03)==0. )
2cb30 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 7a {. return z
2cb40 44 69 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 Dir;. }. i
2cb50 66 28 20 69 3e 3d 73 69 7a 65 6f 66 28 61 7a 44 f( i>=sizeof(azD
2cb60 69 72 73 29 2f 73 69 7a 65 6f 66 28 61 7a 44 69 irs)/sizeof(azDi
2cb70 72 73 5b 30 5d 29 20 29 20 62 72 65 61 6b 3b 0a rs[0]) ) break;.
2cb80 20 20 20 20 7a 44 69 72 20 3d 20 61 7a 44 69 72 zDir = azDir
2cb90 73 5b 69 2b 2b 5d 3b 0a 20 20 7d 0a 20 20 72 65 s[i++];. }. re
2cba0 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn 0;.}../*.**
2cbb0 20 43 72 65 61 74 65 20 61 20 74 65 6d 70 6f 72 Create a tempor
2cbc0 61 72 79 20 66 69 6c 65 20 6e 61 6d 65 20 69 6e ary file name in
2cbd0 20 7a 42 75 66 2e 20 20 7a 42 75 66 20 6d 75 73 zBuf. zBuf mus
2cbe0 74 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a t be allocated.*
2cbf0 2a 20 62 79 20 74 68 65 20 63 61 6c 6c 69 6e 67 * by the calling
2cc00 20 70 72 6f 63 65 73 73 20 61 6e 64 20 6d 75 73 process and mus
2cc10 74 20 62 65 20 62 69 67 20 65 6e 6f 75 67 68 20 t be big enough
2cc20 74 6f 20 68 6f 6c 64 20 61 74 20 6c 65 61 73 74 to hold at least
2cc30 0a 2a 2a 20 70 56 66 73 2d 3e 6d 78 50 61 74 68 .** pVfs->mxPath
2cc40 6e 61 6d 65 20 62 79 74 65 73 2e 0a 2a 2f 0a 73 name bytes..*/.s
2cc50 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 47 65 tatic int unixGe
2cc60 74 54 65 6d 70 6e 61 6d 65 28 69 6e 74 20 6e 42 tTempname(int nB
2cc70 75 66 2c 20 63 68 61 72 20 2a 7a 42 75 66 29 7b uf, char *zBuf){
2cc80 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
2cc90 44 69 72 3b 0a 20 20 69 6e 74 20 69 4c 69 6d 69 Dir;. int iLimi
2cca0 74 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 49 74 27 t = 0;.. /* It'
2ccb0 73 20 6f 64 64 20 74 6f 20 73 69 6d 75 6c 61 74 s odd to simulat
2ccc0 65 20 61 6e 20 69 6f 2d 65 72 72 6f 72 20 68 65 e an io-error he
2ccd0 72 65 2c 20 62 75 74 20 72 65 61 6c 6c 79 20 74 re, but really t
2cce0 68 69 73 20 69 73 20 6a 75 73 74 0a 20 20 2a 2a his is just. **
2ccf0 20 75 73 69 6e 67 20 74 68 65 20 69 6f 2d 65 72 using the io-er
2cd00 72 6f 72 20 69 6e 66 72 61 73 74 72 75 63 74 75 ror infrastructu
2cd10 72 65 20 74 6f 20 74 65 73 74 20 74 68 61 74 20 re to test that
2cd20 53 51 4c 69 74 65 20 68 61 6e 64 6c 65 73 20 74 SQLite handles t
2cd30 68 69 73 0a 20 20 2a 2a 20 66 75 6e 63 74 69 6f his. ** functio
2cd40 6e 20 66 61 69 6c 69 6e 67 2e 20 0a 20 20 2a 2f n failing. . */
2cd50 0a 20 20 7a 42 75 66 5b 30 5d 20 3d 20 30 3b 0a . zBuf[0] = 0;.
2cd60 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f SimulateIOErro
2cd70 72 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 r( return SQLITE
2cd80 5f 49 4f 45 52 52 20 29 3b 0a 0a 20 20 7a 44 69 _IOERR );.. zDi
2cd90 72 20 3d 20 75 6e 69 78 54 65 6d 70 46 69 6c 65 r = unixTempFile
2cda0 44 69 72 28 29 3b 0a 20 20 69 66 28 20 7a 44 69 Dir();. if( zDi
2cdb0 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 r==0 ) return SQ
2cdc0 4c 49 54 45 5f 49 4f 45 52 52 5f 47 45 54 54 45 LITE_IOERR_GETTE
2cdd0 4d 50 50 41 54 48 3b 0a 20 20 64 6f 7b 0a 20 20 MPPATH;. do{.
2cde0 20 20 75 36 34 20 72 3b 0a 20 20 20 20 73 71 6c u64 r;. sql
2cdf0 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 ite3_randomness(
2ce00 73 69 7a 65 6f 66 28 72 29 2c 20 26 72 29 3b 0a sizeof(r), &r);.
2ce10 20 20 20 20 61 73 73 65 72 74 28 20 6e 42 75 66 assert( nBuf
2ce20 3e 32 20 29 3b 0a 20 20 20 20 7a 42 75 66 5b 6e >2 );. zBuf[n
2ce30 42 75 66 2d 32 5d 20 3d 20 30 3b 0a 20 20 20 20 Buf-2] = 0;.
2ce40 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 sqlite3_snprintf
2ce50 28 6e 42 75 66 2c 20 7a 42 75 66 2c 20 22 25 73 (nBuf, zBuf, "%s
2ce60 2f 22 53 51 4c 49 54 45 5f 54 45 4d 50 5f 46 49 /"SQLITE_TEMP_FI
2ce70 4c 45 5f 50 52 45 46 49 58 22 25 6c 6c 78 25 63 LE_PREFIX"%llx%c
2ce80 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
2ce90 20 20 20 20 20 20 20 20 7a 44 69 72 2c 20 72 2c zDir, r,
2cea0 20 30 29 3b 0a 20 20 20 20 69 66 28 20 7a 42 75 0);. if( zBu
2ceb0 66 5b 6e 42 75 66 2d 32 5d 21 3d 30 20 7c 7c 20 f[nBuf-2]!=0 ||
2cec0 28 69 4c 69 6d 69 74 2b 2b 29 3e 31 30 20 29 20 (iLimit++)>10 )
2ced0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 return SQLITE_ER
2cee0 52 4f 52 3b 0a 20 20 7d 77 68 69 6c 65 28 20 6f ROR;. }while( o
2cef0 73 41 63 63 65 73 73 28 7a 42 75 66 2c 30 29 3d sAccess(zBuf,0)=
2cf00 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 =0 );. return S
2cf10 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
2cf20 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c SQLITE_ENABLE_L
2cf30 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 OCKING_STYLE &&
2cf40 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f defined(__APPLE_
2cf50 5f 29 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 _)./*.** Routine
2cf60 20 74 6f 20 74 72 61 6e 73 66 6f 72 6d 20 61 20 to transform a
2cf70 75 6e 69 78 46 69 6c 65 20 69 6e 74 6f 20 61 20 unixFile into a
2cf80 70 72 6f 78 79 2d 6c 6f 63 6b 69 6e 67 20 75 6e proxy-locking un
2cf90 69 78 46 69 6c 65 2e 0a 2a 2a 20 49 6d 70 6c 65 ixFile..** Imple
2cfa0 6d 65 6e 74 61 74 69 6f 6e 20 69 6e 20 74 68 65 mentation in the
2cfb0 20 70 72 6f 78 79 2d 6c 6f 63 6b 20 64 69 76 69 proxy-lock divi
2cfc0 73 69 6f 6e 2c 20 62 75 74 20 75 73 65 64 20 62 sion, but used b
2cfd0 79 20 75 6e 69 78 4f 70 65 6e 28 29 0a 2a 2a 20 y unixOpen().**
2cfe0 69 66 20 53 51 4c 49 54 45 5f 50 52 45 46 45 52 if SQLITE_PREFER
2cff0 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 20 69 _PROXY_LOCKING i
2d000 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 s defined..*/.st
2d010 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 54 72 atic int proxyTr
2d020 61 6e 73 66 6f 72 6d 55 6e 69 78 46 69 6c 65 28 ansformUnixFile(
2d030 75 6e 69 78 46 69 6c 65 2a 2c 20 63 6f 6e 73 74 unixFile*, const
2d040 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 0a char*);.#endif.
2d050 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 66 6f ./*.** Search fo
2d060 72 20 61 6e 20 75 6e 75 73 65 64 20 66 69 6c 65 r an unused file
2d070 20 64 65 73 63 72 69 70 74 6f 72 20 74 68 61 74 descriptor that
2d080 20 77 61 73 20 6f 70 65 6e 65 64 20 6f 6e 20 74 was opened on t
2d090 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 he database .**
2d0a0 66 69 6c 65 20 28 6e 6f 74 20 61 20 6a 6f 75 72 file (not a jour
2d0b0 6e 61 6c 20 6f 72 20 6d 61 73 74 65 72 2d 6a 6f nal or master-jo
2d0c0 75 72 6e 61 6c 20 66 69 6c 65 29 20 69 64 65 6e urnal file) iden
2d0d0 74 69 66 69 65 64 20 62 79 20 70 61 74 68 6e 61 tified by pathna
2d0e0 6d 65 0a 2a 2a 20 7a 50 61 74 68 20 77 69 74 68 me.** zPath with
2d0f0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 58 58 58 SQLITE_OPEN_XXX
2d100 20 66 6c 61 67 73 20 6d 61 74 63 68 69 6e 67 20 flags matching
2d110 74 68 6f 73 65 20 70 61 73 73 65 64 20 61 73 20 those passed as
2d120 74 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 the second.** ar
2d130 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 gument to this f
2d140 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 53 unction..**.** S
2d150 75 63 68 20 61 20 66 69 6c 65 20 64 65 73 63 72 uch a file descr
2d160 69 70 74 6f 72 20 6d 61 79 20 65 78 69 73 74 20 iptor may exist
2d170 69 66 20 61 20 64 61 74 61 62 61 73 65 20 63 6f if a database co
2d180 6e 6e 65 63 74 69 6f 6e 20 77 61 73 20 63 6c 6f nnection was clo
2d190 73 65 64 0a 2a 2a 20 62 75 74 20 74 68 65 20 61 sed.** but the a
2d1a0 73 73 6f 63 69 61 74 65 64 20 66 69 6c 65 20 64 ssociated file d
2d1b0 65 73 63 72 69 70 74 6f 72 20 63 6f 75 6c 64 20 escriptor could
2d1c0 6e 6f 74 20 62 65 20 63 6c 6f 73 65 64 20 62 65 not be closed be
2d1d0 63 61 75 73 65 20 73 6f 6d 65 0a 2a 2a 20 6f 74 cause some.** ot
2d1e0 68 65 72 20 66 69 6c 65 20 64 65 73 63 72 69 70 her file descrip
2d1f0 74 6f 72 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 tor open on the
2d200 73 61 6d 65 20 66 69 6c 65 20 69 73 20 68 6f 6c same file is hol
2d210 64 69 6e 67 20 61 20 66 69 6c 65 2d 6c 6f 63 6b ding a file-lock
2d220 2e 0a 2a 2a 20 52 65 66 65 72 20 74 6f 20 63 6f ..** Refer to co
2d230 6d 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 75 6e mments in the un
2d240 69 78 43 6c 6f 73 65 28 29 20 66 75 6e 63 74 69 ixClose() functi
2d250 6f 6e 20 61 6e 64 20 74 68 65 20 6c 65 6e 67 74 on and the lengt
2d260 68 79 20 63 6f 6d 6d 65 6e 74 0a 2a 2a 20 64 65 hy comment.** de
2d270 73 63 72 69 62 69 6e 67 20 22 50 6f 73 69 78 20 scribing "Posix
2d280 41 64 76 69 73 6f 72 79 20 4c 6f 63 6b 69 6e 67 Advisory Locking
2d290 22 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f " at the start o
2d2a0 66 20 74 68 69 73 20 66 69 6c 65 20 66 6f 72 20 f this file for
2d2b0 0a 2a 2a 20 66 75 72 74 68 65 72 20 64 65 74 61 .** further deta
2d2c0 69 6c 73 2e 20 41 6c 73 6f 2c 20 74 69 63 6b 65 ils. Also, ticke
2d2d0 74 20 23 34 30 31 38 2e 0a 2a 2a 0a 2a 2a 20 49 t #4018..**.** I
2d2e0 66 20 61 20 73 75 69 74 61 62 6c 65 20 66 69 6c f a suitable fil
2d2f0 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 e descriptor is
2d300 66 6f 75 6e 64 2c 20 74 68 65 6e 20 69 74 20 69 found, then it i
2d310 73 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 6e s returned. If n
2d320 6f 0a 2a 2a 20 73 75 63 68 20 66 69 6c 65 20 64 o.** such file d
2d330 65 73 63 72 69 70 74 6f 72 20 69 73 20 6c 6f 63 escriptor is loc
2d340 61 74 65 64 2c 20 2d 31 20 69 73 20 72 65 74 75 ated, -1 is retu
2d350 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 rned..*/.static
2d360 55 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 66 69 UnixUnusedFd *fi
2d370 6e 64 52 65 75 73 61 62 6c 65 46 64 28 63 6f 6e ndReusableFd(con
2d380 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 st char *zPath,
2d390 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 55 6e int flags){. Un
2d3a0 69 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e 75 ixUnusedFd *pUnu
2d3b0 73 65 64 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 44 sed = 0;.. /* D
2d3c0 6f 20 6e 6f 74 20 73 65 61 72 63 68 20 66 6f 72 o not search for
2d3d0 20 61 6e 20 75 6e 75 73 65 64 20 66 69 6c 65 20 an unused file
2d3e0 64 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 76 78 descriptor on vx
2d3f0 77 6f 72 6b 73 2e 20 4e 6f 74 20 62 65 63 61 75 works. Not becau
2d400 73 65 0a 20 20 2a 2a 20 76 78 77 6f 72 6b 73 20 se. ** vxworks
2d410 77 6f 75 6c 64 20 6e 6f 74 20 62 65 6e 65 66 69 would not benefi
2d420 74 20 66 72 6f 6d 20 74 68 65 20 63 68 61 6e 67 t from the chang
2d430 65 20 28 69 74 20 6d 69 67 68 74 2c 20 77 65 27 e (it might, we'
2d440 72 65 20 6e 6f 74 20 73 75 72 65 29 2c 0a 20 20 re not sure),.
2d450 2a 2a 20 62 75 74 20 62 65 63 61 75 73 65 20 6e ** but because n
2d460 6f 20 77 61 79 20 74 6f 20 74 65 73 74 20 69 74 o way to test it
2d470 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 76 is currently av
2d480 61 69 6c 61 62 6c 65 2e 20 49 74 20 69 73 20 62 ailable. It is b
2d490 65 74 74 65 72 20 0a 20 20 2a 2a 20 6e 6f 74 20 etter . ** not
2d4a0 74 6f 20 72 69 73 6b 20 62 72 65 61 6b 69 6e 67 to risk breaking
2d4b0 20 76 78 77 6f 72 6b 73 20 73 75 70 70 6f 72 74 vxworks support
2d4c0 20 66 6f 72 20 74 68 65 20 73 61 6b 65 20 6f 66 for the sake of
2d4d0 20 73 75 63 68 20 61 6e 20 6f 62 73 63 75 72 65 such an obscure
2d4e0 20 0a 20 20 2a 2a 20 66 65 61 74 75 72 65 2e 20 . ** feature.
2d4f0 20 2a 2f 0a 23 69 66 20 21 4f 53 5f 56 58 57 4f */.#if !OS_VXWO
2d500 52 4b 53 0a 20 20 73 74 72 75 63 74 20 73 74 61 RKS. struct sta
2d510 74 20 73 53 74 61 74 3b 20 20 20 20 20 20 20 20 t sStat;
2d520 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
2d530 73 75 6c 74 73 20 6f 66 20 73 74 61 74 28 29 20 sults of stat()
2d540 63 61 6c 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 41 20 call */.. /* A
2d550 73 74 61 74 28 29 20 63 61 6c 6c 20 6d 61 79 20 stat() call may
2d560 66 61 69 6c 20 66 6f 72 20 76 61 72 69 6f 75 73 fail for various
2d570 20 72 65 61 73 6f 6e 73 2e 20 49 66 20 74 68 69 reasons. If thi
2d580 73 20 68 61 70 70 65 6e 73 2c 20 69 74 20 69 73 s happens, it is
2d590 0a 20 20 2a 2a 20 61 6c 6d 6f 73 74 20 63 65 72 . ** almost cer
2d5a0 74 61 69 6e 20 74 68 61 74 20 61 6e 20 6f 70 65 tain that an ope
2d5b0 6e 28 29 20 63 61 6c 6c 20 6f 6e 20 74 68 65 20 n() call on the
2d5c0 73 61 6d 65 20 70 61 74 68 20 77 69 6c 6c 20 61 same path will a
2d5d0 6c 73 6f 20 66 61 69 6c 2e 0a 20 20 2a 2a 20 46 lso fail.. ** F
2d5e0 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c 20 or this reason,
2d5f0 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 if an error occu
2d600 72 73 20 69 6e 20 74 68 65 20 73 74 61 74 28 29 rs in the stat()
2d610 20 63 61 6c 6c 20 68 65 72 65 2c 20 69 74 20 69 call here, it i
2d620 73 0a 20 20 2a 2a 20 69 67 6e 6f 72 65 64 20 61 s. ** ignored a
2d630 6e 64 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 nd -1 is returne
2d640 64 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 d. The caller wi
2d650 6c 6c 20 74 72 79 20 74 6f 20 6f 70 65 6e 20 61 ll try to open a
2d660 20 6e 65 77 20 66 69 6c 65 0a 20 20 2a 2a 20 64 new file. ** d
2d670 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 74 68 65 escriptor on the
2d680 20 73 61 6d 65 20 70 61 74 68 2c 20 66 61 69 6c same path, fail
2d690 2c 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 , and return an
2d6a0 65 72 72 6f 72 20 74 6f 20 53 51 4c 69 74 65 2e error to SQLite.
2d6b0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 76 65 6e 20 . **. ** Even
2d6c0 69 66 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 if a subsequent
2d6d0 6f 70 65 6e 28 29 20 63 61 6c 6c 20 64 6f 65 73 open() call does
2d6e0 20 73 75 63 63 65 65 64 2c 20 74 68 65 20 63 6f succeed, the co
2d6f0 6e 73 65 71 75 65 6e 63 65 73 20 6f 66 0a 20 20 nsequences of.
2d700 2a 2a 20 6e 6f 74 20 73 65 61 72 63 68 69 6e 67 ** not searching
2d710 20 66 6f 72 20 61 20 72 65 75 73 61 62 6c 65 20 for a reusable
2d720 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
2d730 61 72 65 20 6e 6f 74 20 64 69 72 65 2e 20 20 2a are not dire. *
2d740 2f 0a 20 20 69 66 28 20 30 3d 3d 6f 73 53 74 61 /. if( 0==osSta
2d750 74 28 7a 50 61 74 68 2c 20 26 73 53 74 61 74 29 t(zPath, &sStat)
2d760 20 29 7b 0a 20 20 20 20 75 6e 69 78 49 6e 6f 64 ){. unixInod
2d770 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 0a eInfo *pInode;..
2d780 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 unixEnterMut
2d790 65 78 28 29 3b 0a 20 20 20 20 70 49 6e 6f 64 65 ex();. pInode
2d7a0 20 3d 20 69 6e 6f 64 65 4c 69 73 74 3b 0a 20 20 = inodeList;.
2d7b0 20 20 77 68 69 6c 65 28 20 70 49 6e 6f 64 65 20 while( pInode
2d7c0 26 26 20 28 70 49 6e 6f 64 65 2d 3e 66 69 6c 65 && (pInode->file
2d7d0 49 64 2e 64 65 76 21 3d 73 53 74 61 74 2e 73 74 Id.dev!=sStat.st
2d7e0 5f 64 65 76 0a 20 20 20 20 20 20 20 20 20 20 20 _dev.
2d7f0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 49 6e || pIn
2d800 6f 64 65 2d 3e 66 69 6c 65 49 64 2e 69 6e 6f 21 ode->fileId.ino!
2d810 3d 73 53 74 61 74 2e 73 74 5f 69 6e 6f 29 20 29 =sStat.st_ino) )
2d820 7b 0a 20 20 20 20 20 20 20 70 49 6e 6f 64 65 20 {. pInode
2d830 3d 20 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b = pInode->pNext;
2d840 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
2d850 49 6e 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 55 Inode ){. U
2d860 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 2a 70 70 nixUnusedFd **pp
2d870 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 70 3d 26 ;. for(pp=&
2d880 70 49 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 3b pInode->pUnused;
2d890 20 2a 70 70 20 26 26 20 28 2a 70 70 29 2d 3e 66 *pp && (*pp)->f
2d8a0 6c 61 67 73 21 3d 66 6c 61 67 73 3b 20 70 70 3d lags!=flags; pp=
2d8b0 26 28 28 2a 70 70 29 2d 3e 70 4e 65 78 74 29 29 &((*pp)->pNext))
2d8c0 3b 0a 20 20 20 20 20 20 70 55 6e 75 73 65 64 20 ;. pUnused
2d8d0 3d 20 2a 70 70 3b 0a 20 20 20 20 20 20 69 66 28 = *pp;. if(
2d8e0 20 70 55 6e 75 73 65 64 20 29 7b 0a 20 20 20 20 pUnused ){.
2d8f0 20 20 20 20 2a 70 70 20 3d 20 70 55 6e 75 73 65 *pp = pUnuse
2d900 64 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 d->pNext;.
2d910 7d 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 69 78 }. }. unix
2d920 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 LeaveMutex();.
2d930 7d 0a 23 65 6e 64 69 66 20 20 20 20 2f 2a 20 69 }.#endif /* i
2d940 66 20 21 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f f !OS_VXWORKS */
2d950 0a 20 20 72 65 74 75 72 6e 20 70 55 6e 75 73 65 . return pUnuse
2d960 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 d;.}../*.** Find
2d970 20 74 68 65 20 6d 6f 64 65 2c 20 75 69 64 20 61 the mode, uid a
2d980 6e 64 20 67 69 64 20 6f 66 20 66 69 6c 65 20 7a nd gid of file z
2d990 46 69 6c 65 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 File. .*/.static
2d9a0 20 69 6e 74 20 67 65 74 46 69 6c 65 4d 6f 64 65 int getFileMode
2d9b0 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a (. const char *
2d9c0 7a 46 69 6c 65 2c 20 20 20 20 20 20 20 20 20 20 zFile,
2d9d0 20 20 20 20 2f 2a 20 46 69 6c 65 20 6e 61 6d 65 /* File name
2d9e0 20 2a 2f 0a 20 20 6d 6f 64 65 5f 74 20 2a 70 4d */. mode_t *pM
2d9f0 6f 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ode,
2da00 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 50 65 /* OUT: Pe
2da10 72 6d 69 73 73 69 6f 6e 73 20 6f 66 20 7a 46 69 rmissions of zFi
2da20 6c 65 20 2a 2f 0a 20 20 75 69 64 5f 74 20 2a 70 le */. uid_t *p
2da30 55 69 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 Uid,
2da40 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
2da50 75 69 64 20 6f 66 20 7a 46 69 6c 65 2e 20 2a 2f uid of zFile. */
2da60 0a 20 20 67 69 64 5f 74 20 2a 70 47 69 64 20 20 . gid_t *pGid
2da70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2da80 20 20 20 2f 2a 20 4f 55 54 3a 20 67 69 64 20 6f /* OUT: gid o
2da90 66 20 7a 46 69 6c 65 2e 20 2a 2f 0a 29 7b 0a 20 f zFile. */.){.
2daa0 20 73 74 72 75 63 74 20 73 74 61 74 20 73 53 74 struct stat sSt
2dab0 61 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 at;
2dac0 20 2f 2a 20 4f 75 74 70 75 74 20 6f 66 20 73 74 /* Output of st
2dad0 61 74 28 29 20 6f 6e 20 64 61 74 61 62 61 73 65 at() on database
2dae0 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 72 file */. int r
2daf0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
2db00 20 69 66 28 20 30 3d 3d 6f 73 53 74 61 74 28 7a if( 0==osStat(z
2db10 46 69 6c 65 2c 20 26 73 53 74 61 74 29 20 29 7b File, &sStat) ){
2db20 0a 20 20 20 20 2a 70 4d 6f 64 65 20 3d 20 73 53 . *pMode = sS
2db30 74 61 74 2e 73 74 5f 6d 6f 64 65 20 26 20 30 37 tat.st_mode & 07
2db40 37 37 3b 0a 20 20 20 20 2a 70 55 69 64 20 3d 20 77;. *pUid =
2db50 73 53 74 61 74 2e 73 74 5f 75 69 64 3b 0a 20 20 sStat.st_uid;.
2db60 20 20 2a 70 47 69 64 20 3d 20 73 53 74 61 74 2e *pGid = sStat.
2db70 73 74 5f 67 69 64 3b 0a 20 20 7d 65 6c 73 65 7b st_gid;. }else{
2db80 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
2db90 5f 49 4f 45 52 52 5f 46 53 54 41 54 3b 0a 20 20 _IOERR_FSTAT;.
2dba0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
2dbb0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
2dbc0 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
2dbd0 62 79 20 75 6e 69 78 4f 70 65 6e 28 29 20 74 6f by unixOpen() to
2dbe0 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 75 determine the u
2dbf0 6e 69 78 20 70 65 72 6d 69 73 73 69 6f 6e 73 0a nix permissions.
2dc00 2a 2a 20 74 6f 20 63 72 65 61 74 65 20 6e 65 77 ** to create new
2dc10 20 66 69 6c 65 73 20 77 69 74 68 2e 20 49 66 20 files with. If
2dc20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c no error occurs,
2dc30 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 then SQLITE_OK
2dc40 69 73 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20 61 is returned.** a
2dc50 6e 64 20 61 20 76 61 6c 75 65 20 73 75 69 74 61 nd a value suita
2dc60 62 6c 65 20 66 6f 72 20 70 61 73 73 69 6e 67 20 ble for passing
2dc70 61 73 20 74 68 65 20 74 68 69 72 64 20 61 72 67 as the third arg
2dc80 75 6d 65 6e 74 20 74 6f 20 6f 70 65 6e 28 32 29 ument to open(2)
2dc90 20 69 73 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 is.** written t
2dca0 6f 20 2a 70 4d 6f 64 65 2e 20 49 66 20 61 6e 20 o *pMode. If an
2dcb0 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c IO error occurs,
2dcc0 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
2dcd0 20 63 6f 64 65 20 69 73 20 0a 2a 2a 20 72 65 74 code is .** ret
2dce0 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 76 61 urned and the va
2dcf0 6c 75 65 20 6f 66 20 2a 70 4d 6f 64 65 20 69 73 lue of *pMode is
2dd00 20 6e 6f 74 20 6d 6f 64 69 66 69 65 64 2e 0a 2a not modified..*
2dd10 2a 0a 2a 2a 20 49 6e 20 6d 6f 73 74 20 63 61 73 *.** In most cas
2dd20 65 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 es, this routine
2dd30 20 73 65 74 73 20 2a 70 4d 6f 64 65 20 74 6f 20 sets *pMode to
2dd40 30 2c 20 77 68 69 63 68 20 77 69 6c 6c 20 62 65 0, which will be
2dd50 63 6f 6d 65 0a 2a 2a 20 61 6e 20 69 6e 64 69 63 come.** an indic
2dd60 61 74 69 6f 6e 20 74 6f 20 72 6f 62 75 73 74 5f ation to robust_
2dd70 6f 70 65 6e 28 29 20 74 6f 20 63 72 65 61 74 65 open() to create
2dd80 20 74 68 65 20 66 69 6c 65 20 75 73 69 6e 67 0a the file using.
2dd90 2a 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ** SQLITE_DEFAUL
2dda0 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f T_FILE_PERMISSIO
2ddb0 4e 53 20 61 64 6a 75 73 74 65 64 20 62 79 20 74 NS adjusted by t
2ddc0 68 65 20 75 6d 61 73 6b 2e 0a 2a 2a 20 42 75 74 he umask..** But
2ddd0 20 69 66 20 74 68 65 20 66 69 6c 65 20 62 65 69 if the file bei
2dde0 6e 67 20 6f 70 65 6e 65 64 20 69 73 20 61 20 57 ng opened is a W
2ddf0 41 4c 20 6f 72 20 72 65 67 75 6c 61 72 20 6a 6f AL or regular jo
2de00 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 65 6e urnal file, then
2de10 20 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 .** this functi
2de20 6f 6e 20 71 75 65 72 69 65 73 20 74 68 65 20 66 on queries the f
2de30 69 6c 65 2d 73 79 73 74 65 6d 20 66 6f 72 20 74 ile-system for t
2de40 68 65 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 6f he permissions o
2de50 6e 20 74 68 65 20 0a 2a 2a 20 63 6f 72 72 65 73 n the .** corres
2de60 70 6f 6e 64 69 6e 67 20 64 61 74 61 62 61 73 65 ponding database
2de70 20 66 69 6c 65 20 61 6e 64 20 73 65 74 73 20 2a file and sets *
2de80 70 4d 6f 64 65 20 74 6f 20 74 68 69 73 20 76 61 pMode to this va
2de90 6c 75 65 2e 20 57 68 65 6e 65 76 65 72 20 0a 2a lue. Whenever .*
2dea0 2a 20 70 6f 73 73 69 62 6c 65 2c 20 57 41 4c 20 * possible, WAL
2deb0 61 6e 64 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 and journal file
2dec0 73 20 61 72 65 20 63 72 65 61 74 65 64 20 75 73 s are created us
2ded0 69 6e 67 20 74 68 65 20 73 61 6d 65 20 70 65 72 ing the same per
2dee0 6d 69 73 73 69 6f 6e 73 20 0a 2a 2a 20 61 73 20 missions .** as
2def0 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 64 the associated d
2df00 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a atabase file..**
2df10 0a 2a 2a 20 49 66 20 74 68 65 20 53 51 4c 49 54 .** If the SQLIT
2df20 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e 41 4d E_ENABLE_8_3_NAM
2df30 45 53 20 6f 70 74 69 6f 6e 20 69 73 20 65 6e 61 ES option is ena
2df40 62 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 2a bled, then the.*
2df50 2a 20 6f 72 69 67 69 6e 61 6c 20 66 69 6c 65 6e * original filen
2df60 61 6d 65 20 69 73 20 75 6e 61 76 61 69 6c 61 62 ame is unavailab
2df70 6c 65 2e 20 20 42 75 74 20 38 5f 33 5f 4e 41 4d le. But 8_3_NAM
2df80 45 53 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 ES is only used
2df90 66 6f 72 0a 2a 2a 20 46 41 54 20 66 69 6c 65 73 for.** FAT files
2dfa0 79 73 74 65 6d 73 20 61 6e 64 20 70 65 72 6d 69 ystems and permi
2dfb0 73 73 69 6f 6e 73 20 64 6f 20 6e 6f 74 20 6d 61 ssions do not ma
2dfc0 74 74 65 72 20 74 68 65 72 65 2c 20 73 6f 20 6a tter there, so j
2dfd0 75 73 74 20 75 73 65 0a 2a 2a 20 74 68 65 20 64 ust use.** the d
2dfe0 65 66 61 75 6c 74 20 70 65 72 6d 69 73 73 69 6f efault permissio
2dff0 6e 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ns..*/.static in
2e000 74 20 66 69 6e 64 43 72 65 61 74 65 46 69 6c 65 t findCreateFile
2e010 4d 6f 64 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 Mode(. const ch
2e020 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 20 20 ar *zPath,
2e030 20 20 20 20 20 20 20 20 2f 2a 20 50 61 74 68 20 /* Path
2e040 6f 66 20 66 69 6c 65 20 28 70 6f 73 73 69 62 6c of file (possibl
2e050 79 29 20 62 65 69 6e 67 20 63 72 65 61 74 65 64 y) being created
2e060 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c */. int flags,
2e070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2e080 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 /* Flags p
2e090 61 73 73 65 64 20 61 73 20 34 74 68 20 61 72 67 assed as 4th arg
2e0a0 75 6d 65 6e 74 20 74 6f 20 78 4f 70 65 6e 28 29 ument to xOpen()
2e0b0 20 2a 2f 0a 20 20 6d 6f 64 65 5f 74 20 2a 70 4d */. mode_t *pM
2e0c0 6f 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ode,
2e0d0 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 50 65 /* OUT: Pe
2e0e0 72 6d 69 73 73 69 6f 6e 73 20 74 6f 20 6f 70 65 rmissions to ope
2e0f0 6e 20 66 69 6c 65 20 77 69 74 68 20 2a 2f 0a 20 n file with */.
2e100 20 75 69 64 5f 74 20 2a 70 55 69 64 2c 20 20 20 uid_t *pUid,
2e110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2e120 20 2f 2a 20 4f 55 54 3a 20 75 69 64 20 74 6f 20 /* OUT: uid to
2e130 73 65 74 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 set on the file
2e140 2a 2f 0a 20 20 67 69 64 5f 74 20 2a 70 47 69 64 */. gid_t *pGid
2e150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2e160 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 67 69 64 /* OUT: gid
2e170 20 74 6f 20 73 65 74 20 6f 6e 20 74 68 65 20 66 to set on the f
2e180 69 6c 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ile */.){. int
2e190 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 rc = SQLITE_OK;
2e1a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
2e1b0 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20 20 eturn Code */.
2e1c0 2a 70 4d 6f 64 65 20 3d 20 30 3b 0a 20 20 2a 70 *pMode = 0;. *p
2e1d0 55 69 64 20 3d 20 30 3b 0a 20 20 2a 70 47 69 64 Uid = 0;. *pGid
2e1e0 20 3d 20 30 3b 0a 20 20 69 66 28 20 66 6c 61 67 = 0;. if( flag
2e1f0 73 20 26 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e s & (SQLITE_OPEN
2e200 5f 57 41 4c 7c 53 51 4c 49 54 45 5f 4f 50 45 4e _WAL|SQLITE_OPEN
2e210 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 20 29 _MAIN_JOURNAL) )
2e220 7b 0a 20 20 20 20 63 68 61 72 20 7a 44 62 5b 4d {. char zDb[M
2e230 41 58 5f 50 41 54 48 4e 41 4d 45 2b 31 5d 3b 20 AX_PATHNAME+1];
2e240 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
2e250 66 69 6c 65 20 70 61 74 68 20 2a 2f 0a 20 20 20 file path */.
2e260 20 69 6e 74 20 6e 44 62 3b 20 20 20 20 20 20 20 int nDb;
2e270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2e280 2a 20 4e 75 6d 62 65 72 20 6f 66 20 76 61 6c 69 * Number of vali
2e290 64 20 62 79 74 65 73 20 69 6e 20 7a 44 62 20 2a d bytes in zDb *
2e2a0 2f 0a 0a 20 20 20 20 2f 2a 20 7a 50 61 74 68 20 /.. /* zPath
2e2b0 69 73 20 61 20 70 61 74 68 20 74 6f 20 61 20 57 is a path to a W
2e2c0 41 4c 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 66 69 AL or journal fi
2e2d0 6c 65 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e le. The followin
2e2e0 67 20 62 6c 6f 63 6b 20 64 65 72 69 76 65 73 0a g block derives.
2e2f0 20 20 20 20 2a 2a 20 74 68 65 20 70 61 74 68 20 ** the path
2e300 74 6f 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 to the associate
2e310 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 d database file
2e320 66 72 6f 6d 20 7a 50 61 74 68 2e 20 54 68 69 73 from zPath. This
2e330 20 62 6c 6f 63 6b 20 68 61 6e 64 6c 65 73 0a 20 block handles.
2e340 20 20 20 2a 2a 20 74 68 65 20 66 6f 6c 6c 6f 77 ** the follow
2e350 69 6e 67 20 6e 61 6d 69 6e 67 20 63 6f 6e 76 65 ing naming conve
2e360 6e 74 69 6f 6e 73 3a 0a 20 20 20 20 2a 2a 0a 20 ntions:. **.
2e370 20 20 20 2a 2a 20 20 20 22 3c 70 61 74 68 20 74 ** "<path t
2e380 6f 20 64 62 3e 2d 6a 6f 75 72 6e 61 6c 22 0a 20 o db>-journal".
2e390 20 20 20 2a 2a 20 20 20 22 3c 70 61 74 68 20 74 ** "<path t
2e3a0 6f 20 64 62 3e 2d 77 61 6c 22 0a 20 20 20 20 2a o db>-wal". *
2e3b0 2a 20 20 20 22 3c 70 61 74 68 20 74 6f 20 64 62 * "<path to db
2e3c0 3e 2d 6a 6f 75 72 6e 61 6c 4e 4e 22 0a 20 20 20 >-journalNN".
2e3d0 20 2a 2a 20 20 20 22 3c 70 61 74 68 20 74 6f 20 ** "<path to
2e3e0 64 62 3e 2d 77 61 6c 4e 4e 22 0a 20 20 20 20 2a db>-walNN". *
2e3f0 2a 0a 20 20 20 20 2a 2a 20 77 68 65 72 65 20 4e *. ** where N
2e400 4e 20 69 73 20 61 20 64 65 63 69 6d 61 6c 20 6e N is a decimal n
2e410 75 6d 62 65 72 2e 20 54 68 65 20 4e 4e 20 6e 61 umber. The NN na
2e420 6d 69 6e 67 20 73 63 68 65 6d 65 73 20 61 72 65 ming schemes are
2e430 20 0a 20 20 20 20 2a 2a 20 75 73 65 64 20 62 79 . ** used by
2e440 20 74 68 65 20 74 65 73 74 5f 6d 75 6c 74 69 70 the test_multip
2e450 6c 65 78 2e 63 20 6d 6f 64 75 6c 65 2e 0a 20 20 lex.c module..
2e460 20 20 2a 2f 0a 20 20 20 20 6e 44 62 20 3d 20 73 */. nDb = s
2e470 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
2e480 50 61 74 68 29 20 2d 20 31 3b 20 0a 20 20 20 20 Path) - 1; .
2e490 77 68 69 6c 65 28 20 7a 50 61 74 68 5b 6e 44 62 while( zPath[nDb
2e4a0 5d 21 3d 27 2d 27 20 29 7b 0a 23 69 66 6e 64 65 ]!='-' ){.#ifnde
2e4b0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
2e4c0 38 5f 33 5f 4e 41 4d 45 53 0a 20 20 20 20 20 20 8_3_NAMES.
2e4d0 2f 2a 20 49 6e 20 74 68 65 20 6e 6f 72 6d 61 6c /* In the normal
2e4e0 20 63 61 73 65 20 28 38 2b 33 20 66 69 6c 65 6e case (8+3 filen
2e4f0 61 6d 65 73 20 64 69 73 61 62 6c 65 64 29 20 74 ames disabled) t
2e500 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e he journal filen
2e510 61 6d 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 ame. ** is
2e520 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20 63 6f guaranteed to co
2e530 6e 74 61 69 6e 20 61 20 27 2d 27 20 63 68 61 72 ntain a '-' char
2e540 61 63 74 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 acter. */.
2e550 61 73 73 65 72 74 28 20 6e 44 62 3e 30 20 29 3b assert( nDb>0 );
2e560 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 . assert( s
2e570 71 6c 69 74 65 33 49 73 61 6c 6e 75 6d 28 7a 50 qlite3Isalnum(zP
2e580 61 74 68 5b 6e 44 62 5d 29 20 29 3b 0a 23 65 6c ath[nDb]) );.#el
2e590 73 65 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 38 se. /* If 8
2e5a0 2b 33 20 6e 61 6d 65 73 20 61 72 65 20 70 6f 73 +3 names are pos
2e5b0 73 69 62 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 sible, then the
2e5c0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 69 67 journal file mig
2e5d0 68 74 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 0a 20 ht not contain.
2e5e0 20 20 20 20 20 2a 2a 20 61 20 27 2d 27 20 63 68 ** a '-' ch
2e5f0 61 72 61 63 74 65 72 2e 20 20 53 6f 20 63 68 65 aracter. So che
2e600 63 6b 20 66 6f 72 20 74 68 61 74 20 63 61 73 65 ck for that case
2e610 20 61 6e 64 20 72 65 74 75 72 6e 20 65 61 72 6c and return earl
2e620 79 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 y. */. if(
2e630 6e 44 62 3d 3d 30 20 7c 7c 20 7a 50 61 74 68 5b nDb==0 || zPath[
2e640 6e 44 62 5d 3d 3d 27 2e 27 20 29 20 72 65 74 75 nDb]=='.' ) retu
2e650 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 rn SQLITE_OK;.#e
2e660 6e 64 69 66 0a 20 20 20 20 20 20 6e 44 62 2d 2d ndif. nDb--
2e670 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 63 ;. }. memc
2e680 70 79 28 7a 44 62 2c 20 7a 50 61 74 68 2c 20 6e py(zDb, zPath, n
2e690 44 62 29 3b 0a 20 20 20 20 7a 44 62 5b 6e 44 62 Db);. zDb[nDb
2e6a0 5d 20 3d 20 27 5c 30 27 3b 0a 0a 20 20 20 20 72 ] = '\0';.. r
2e6b0 63 20 3d 20 67 65 74 46 69 6c 65 4d 6f 64 65 28 c = getFileMode(
2e6c0 7a 44 62 2c 20 70 4d 6f 64 65 2c 20 70 55 69 64 zDb, pMode, pUid
2e6d0 2c 20 70 47 69 64 29 3b 0a 20 20 7d 65 6c 73 65 , pGid);. }else
2e6e0 20 69 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c if( flags & SQL
2e6f0 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f ITE_OPEN_DELETEO
2e700 4e 43 4c 4f 53 45 20 29 7b 0a 20 20 20 20 2a 70 NCLOSE ){. *p
2e710 4d 6f 64 65 20 3d 20 30 36 30 30 3b 0a 20 20 7d Mode = 0600;. }
2e720 65 6c 73 65 20 69 66 28 20 66 6c 61 67 73 20 26 else if( flags &
2e730 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 SQLITE_OPEN_URI
2e740 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 ){. /* If th
2e750 69 73 20 69 73 20 61 20 6d 61 69 6e 20 64 61 74 is is a main dat
2e760 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 74 abase file and t
2e770 68 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 6e he file was open
2e780 65 64 20 75 73 69 6e 67 20 61 20 55 52 49 0a 20 ed using a URI.
2e790 20 20 20 2a 2a 20 66 69 6c 65 6e 61 6d 65 2c 20 ** filename,
2e7a0 63 68 65 63 6b 20 66 6f 72 20 74 68 65 20 22 6d check for the "m
2e7b0 6f 64 65 6f 66 22 20 70 61 72 61 6d 65 74 65 72 odeof" parameter
2e7c0 2e 20 49 66 20 70 72 65 73 65 6e 74 2c 20 69 6e . If present, in
2e7d0 74 65 72 70 72 65 74 0a 20 20 20 20 2a 2a 20 69 terpret. ** i
2e7e0 74 73 20 76 61 6c 75 65 20 61 73 20 61 20 66 69 ts value as a fi
2e7f0 6c 65 6e 61 6d 65 20 61 6e 64 20 74 72 79 20 74 lename and try t
2e800 6f 20 63 6f 70 79 20 74 68 65 20 6d 6f 64 65 2c o copy the mode,
2e810 20 75 69 64 20 61 6e 64 20 67 69 64 20 66 72 6f uid and gid fro
2e820 6d 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 66 69 m. ** that fi
2e830 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 63 6f 6e 73 le. */. cons
2e840 74 20 63 68 61 72 20 2a 7a 20 3d 20 73 71 6c 69 t char *z = sqli
2e850 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 te3_uri_paramete
2e860 72 28 7a 50 61 74 68 2c 20 22 6d 6f 64 65 6f 66 r(zPath, "modeof
2e870 22 29 3b 0a 20 20 20 20 69 66 28 20 7a 20 29 7b ");. if( z ){
2e880 0a 20 20 20 20 20 20 72 63 20 3d 20 67 65 74 46 . rc = getF
2e890 69 6c 65 4d 6f 64 65 28 7a 2c 20 70 4d 6f 64 65 ileMode(z, pMode
2e8a0 2c 20 70 55 69 64 2c 20 70 47 69 64 29 3b 0a 20 , pUid, pGid);.
2e8b0 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
2e8c0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f n rc;.}../*.** O
2e8d0 70 65 6e 20 74 68 65 20 66 69 6c 65 20 7a 50 61 pen the file zPa
2e8e0 74 68 2e 0a 2a 2a 20 0a 2a 2a 20 50 72 65 76 69 th..** .** Previ
2e8f0 6f 75 73 6c 79 2c 20 74 68 65 20 53 51 4c 69 74 ously, the SQLit
2e900 65 20 4f 53 20 6c 61 79 65 72 20 75 73 65 64 20 e OS layer used
2e910 74 68 72 65 65 20 66 75 6e 63 74 69 6f 6e 73 20 three functions
2e920 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68 69 73 in place of this
2e930 0a 2a 2a 20 6f 6e 65 3a 0a 2a 2a 0a 2a 2a 20 20 .** one:.**.**
2e940 20 20 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e sqlite3OsOpen
2e950 52 65 61 64 57 72 69 74 65 28 29 3b 0a 2a 2a 20 ReadWrite();.**
2e960 20 20 20 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 sqlite3OsOpe
2e970 6e 52 65 61 64 4f 6e 6c 79 28 29 3b 0a 2a 2a 20 nReadOnly();.**
2e980 20 20 20 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 sqlite3OsOpe
2e990 6e 45 78 63 6c 75 73 69 76 65 28 29 3b 0a 2a 2a nExclusive();.**
2e9a0 0a 2a 2a 20 54 68 65 73 65 20 63 61 6c 6c 73 20 .** These calls
2e9b0 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 correspond to th
2e9c0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 62 e following comb
2e9d0 69 6e 61 74 69 6f 6e 73 20 6f 66 20 66 6c 61 67 inations of flag
2e9e0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 52 65 61 s:.**.** Rea
2e9f0 64 57 72 69 74 65 28 29 20 2d 3e 20 20 20 20 20 dWrite() ->
2ea00 28 52 45 41 44 57 52 49 54 45 20 7c 20 43 52 45 (READWRITE | CRE
2ea10 41 54 45 29 0a 2a 2a 20 20 20 20 20 52 65 61 64 ATE).** Read
2ea20 4f 6e 6c 79 28 29 20 20 2d 3e 20 20 20 20 20 28 Only() -> (
2ea30 52 45 41 44 4f 4e 4c 59 29 20 0a 2a 2a 20 20 20 READONLY) .**
2ea40 20 20 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 OpenExclusive(
2ea50 29 20 2d 3e 20 28 52 45 41 44 57 52 49 54 45 20 ) -> (READWRITE
2ea60 7c 20 43 52 45 41 54 45 20 7c 20 45 58 43 4c 55 | CREATE | EXCLU
2ea70 53 49 56 45 29 0a 2a 2a 0a 2a 2a 20 54 68 65 20 SIVE).**.** The
2ea80 6f 6c 64 20 4f 70 65 6e 45 78 63 6c 75 73 69 76 old OpenExclusiv
2ea90 65 28 29 20 61 63 63 65 70 74 65 64 20 61 20 62 e() accepted a b
2eaa0 6f 6f 6c 65 61 6e 20 61 72 67 75 6d 65 6e 74 20 oolean argument
2eab0 2d 20 22 64 65 6c 46 6c 61 67 22 2e 20 49 66 0a - "delFlag". If.
2eac0 2a 2a 20 74 72 75 65 2c 20 74 68 65 20 66 69 6c ** true, the fil
2ead0 65 20 77 61 73 20 63 6f 6e 66 69 67 75 72 65 64 e was configured
2eae0 20 74 6f 20 62 65 20 61 75 74 6f 6d 61 74 69 63 to be automatic
2eaf0 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 77 68 65 ally deleted whe
2eb00 6e 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 68 61 n the.** file ha
2eb10 6e 64 6c 65 20 63 6c 6f 73 65 64 2e 20 54 6f 20 ndle closed. To
2eb20 61 63 68 69 65 76 65 20 74 68 65 20 73 61 6d 65 achieve the same
2eb30 20 65 66 66 65 63 74 20 75 73 69 6e 67 20 74 68 effect using th
2eb40 69 73 20 6e 65 77 20 0a 2a 2a 20 69 6e 74 65 72 is new .** inter
2eb50 66 61 63 65 2c 20 61 64 64 20 74 68 65 20 44 45 face, add the DE
2eb60 4c 45 54 45 4f 4e 43 4c 4f 53 45 20 66 6c 61 67 LETEONCLOSE flag
2eb70 20 74 6f 20 74 68 6f 73 65 20 73 70 65 63 69 66 to those specif
2eb80 69 65 64 20 61 62 6f 76 65 20 66 6f 72 20 0a 2a ied above for .*
2eb90 2a 20 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 * OpenExclusive(
2eba0 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 )..*/.static int
2ebb0 20 75 6e 69 78 4f 70 65 6e 28 0a 20 20 73 71 6c unixOpen(. sql
2ebc0 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 ite3_vfs *pVfs,
2ebd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
2ebe0 20 56 46 53 20 66 6f 72 20 77 68 69 63 68 20 74 VFS for which t
2ebf0 68 69 73 20 69 73 20 74 68 65 20 78 4f 70 65 6e his is the xOpen
2ec00 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e method */. con
2ec10 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 st char *zPath,
2ec20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 74 /* Pat
2ec30 68 6e 61 6d 65 20 6f 66 20 66 69 6c 65 20 74 6f hname of file to
2ec40 20 62 65 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 be opened */.
2ec50 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 sqlite3_file *pF
2ec60 69 6c 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 ile, /*
2ec70 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 The file descrip
2ec80 74 6f 72 20 74 6f 20 62 65 20 66 69 6c 6c 65 64 tor to be filled
2ec90 20 69 6e 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 in */. int fla
2eca0 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 gs,
2ecb0 20 20 20 20 20 20 2f 2a 20 49 6e 70 75 74 20 66 /* Input f
2ecc0 6c 61 67 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 lags to control
2ecd0 74 68 65 20 6f 70 65 6e 69 6e 67 20 2a 2f 0a 20 the opening */.
2ece0 20 69 6e 74 20 2a 70 4f 75 74 46 6c 61 67 73 20 int *pOutFlags
2ecf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2ed00 20 4f 75 74 70 75 74 20 66 6c 61 67 73 20 72 65 Output flags re
2ed10 74 75 72 6e 65 64 20 74 6f 20 53 51 4c 69 74 65 turned to SQLite
2ed20 20 63 6f 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 6e core */.){. un
2ed30 69 78 46 69 6c 65 20 2a 70 20 3d 20 28 75 6e 69 ixFile *p = (uni
2ed40 78 46 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a 20 xFile *)pFile;.
2ed50 20 69 6e 74 20 66 64 20 3d 20 2d 31 3b 20 20 20 int fd = -1;
2ed60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ed70 2f 2a 20 46 69 6c 65 20 64 65 73 63 72 69 70 74 /* File descript
2ed80 6f 72 20 72 65 74 75 72 6e 65 64 20 62 79 20 6f or returned by o
2ed90 70 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6f pen() */. int o
2eda0 70 65 6e 46 6c 61 67 73 20 3d 20 30 3b 20 20 20 penFlags = 0;
2edb0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 /* Fla
2edc0 67 73 20 74 6f 20 70 61 73 73 20 74 6f 20 6f 70 gs to pass to op
2edd0 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 65 54 en() */. int eT
2ede0 79 70 65 20 3d 20 66 6c 61 67 73 26 30 78 46 46 ype = flags&0xFF
2edf0 46 46 46 46 30 30 3b 20 20 2f 2a 20 54 79 70 65 FFFF00; /* Type
2ee00 20 6f 66 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e of file to open
2ee10 20 2a 2f 0a 20 20 69 6e 74 20 6e 6f 4c 6f 63 6b */. int noLock
2ee20 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2ee30 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
2ee40 6f 6d 69 74 20 6c 6f 63 6b 69 6e 67 20 70 72 69 omit locking pri
2ee50 6d 69 74 69 76 65 73 20 2a 2f 0a 20 20 69 6e 74 mitives */. int
2ee60 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
2ee70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
2ee80 75 6e 63 74 69 6f 6e 20 52 65 74 75 72 6e 20 43 unction Return C
2ee90 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 63 74 72 ode */. int ctr
2eea0 6c 46 6c 61 67 73 20 3d 20 30 3b 20 20 20 20 20 lFlags = 0;
2eeb0 20 20 20 20 20 20 20 20 2f 2a 20 55 4e 49 58 46 /* UNIXF
2eec0 49 4c 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 0a ILE_* flags */..
2eed0 20 20 69 6e 74 20 69 73 45 78 63 6c 75 73 69 76 int isExclusiv
2eee0 65 20 20 3d 20 28 66 6c 61 67 73 20 26 20 53 51 e = (flags & SQ
2eef0 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 LITE_OPEN_EXCLUS
2ef00 49 56 45 29 3b 0a 20 20 69 6e 74 20 69 73 44 65 IVE);. int isDe
2ef10 6c 65 74 65 20 20 20 20 20 3d 20 28 66 6c 61 67 lete = (flag
2ef20 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f s & SQLITE_OPEN_
2ef30 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 29 3b 0a DELETEONCLOSE);.
2ef40 20 20 69 6e 74 20 69 73 43 72 65 61 74 65 20 20 int isCreate
2ef50 20 20 20 3d 20 28 66 6c 61 67 73 20 26 20 53 51 = (flags & SQ
2ef60 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 LITE_OPEN_CREATE
2ef70 29 3b 0a 20 20 69 6e 74 20 69 73 52 65 61 64 6f );. int isReado
2ef80 6e 6c 79 20 20 20 3d 20 28 66 6c 61 67 73 20 26 nly = (flags &
2ef90 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
2efa0 44 4f 4e 4c 59 29 3b 0a 20 20 69 6e 74 20 69 73 DONLY);. int is
2efb0 52 65 61 64 57 72 69 74 65 20 20 3d 20 28 66 6c ReadWrite = (fl
2efc0 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 ags & SQLITE_OPE
2efd0 4e 5f 52 45 41 44 57 52 49 54 45 29 3b 0a 23 69 N_READWRITE);.#i
2efe0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
2eff0 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 LOCKING_STYLE.
2f000 69 6e 74 20 69 73 41 75 74 6f 50 72 6f 78 79 20 int isAutoProxy
2f010 20 3d 20 28 66 6c 61 67 73 20 26 20 53 51 4c 49 = (flags & SQLI
2f020 54 45 5f 4f 50 45 4e 5f 41 55 54 4f 50 52 4f 58 TE_OPEN_AUTOPROX
2f030 59 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 Y);.#endif.#if d
2f040 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f efined(__APPLE__
2f050 29 20 7c 7c 20 53 51 4c 49 54 45 5f 45 4e 41 42 ) || SQLITE_ENAB
2f060 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 LE_LOCKING_STYLE
2f070 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 66 73 . struct statfs
2f080 20 66 73 49 6e 66 6f 3b 0a 23 65 6e 64 69 66 0a fsInfo;.#endif.
2f090 0a 20 20 2f 2a 20 49 66 20 63 72 65 61 74 69 6e . /* If creatin
2f0a0 67 20 61 20 6d 61 73 74 65 72 20 6f 72 20 6d 61 g a master or ma
2f0b0 69 6e 2d 66 69 6c 65 20 6a 6f 75 72 6e 61 6c 2c in-file journal,
2f0c0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 this function w
2f0d0 69 6c 6c 20 6f 70 65 6e 0a 20 20 2a 2a 20 61 20 ill open. ** a
2f0e0 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 20 file-descriptor
2f0f0 6f 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 on the directory
2f100 20 74 6f 6f 2e 20 54 68 65 20 66 69 72 73 74 20 too. The first
2f110 74 69 6d 65 20 75 6e 69 78 53 79 6e 63 28 29 0a time unixSync().
2f120 20 20 2a 2a 20 69 73 20 63 61 6c 6c 65 64 20 74 ** is called t
2f130 68 65 20 64 69 72 65 63 74 6f 72 79 20 66 69 6c he directory fil
2f140 65 20 64 65 73 63 72 69 70 74 6f 72 20 77 69 6c e descriptor wil
2f150 6c 20 62 65 20 66 73 79 6e 63 28 29 65 64 20 61 l be fsync()ed a
2f160 6e 64 20 63 6c 6f 73 65 28 29 64 2e 0a 20 20 2a nd close()d.. *
2f170 2f 0a 20 20 69 6e 74 20 73 79 6e 63 44 69 72 20 /. int syncDir
2f180 3d 20 28 69 73 43 72 65 61 74 65 20 26 26 20 28 = (isCreate && (
2f190 0a 20 20 20 20 20 20 20 20 65 54 79 70 65 3d 3d . eType==
2f1a0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53 54 SQLITE_OPEN_MAST
2f1b0 45 52 5f 4a 4f 55 52 4e 41 4c 20 0a 20 20 20 20 ER_JOURNAL .
2f1c0 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 || eType==SQLIT
2f1d0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
2f1e0 4e 41 4c 20 0a 20 20 20 20 20 7c 7c 20 65 54 79 NAL . || eTy
2f1f0 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f pe==SQLITE_OPEN_
2f200 57 41 4c 0a 20 20 29 29 3b 0a 0a 20 20 2f 2a 20 WAL. ));.. /*
2f210 49 66 20 61 72 67 75 6d 65 6e 74 20 7a 50 61 74 If argument zPat
2f220 68 20 69 73 20 61 20 4e 55 4c 4c 20 70 6f 69 6e h is a NULL poin
2f230 74 65 72 2c 20 74 68 69 73 20 66 75 6e 63 74 69 ter, this functi
2f240 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 20 74 on is required t
2f250 6f 20 6f 70 65 6e 0a 20 20 2a 2a 20 61 20 74 65 o open. ** a te
2f260 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 55 73 mporary file. Us
2f270 65 20 74 68 69 73 20 62 75 66 66 65 72 20 74 6f e this buffer to
2f280 20 73 74 6f 72 65 20 74 68 65 20 66 69 6c 65 20 store the file
2f290 6e 61 6d 65 20 69 6e 2e 0a 20 20 2a 2f 0a 20 20 name in.. */.
2f2a0 63 68 61 72 20 7a 54 6d 70 6e 61 6d 65 5b 4d 41 char zTmpname[MA
2f2b0 58 5f 50 41 54 48 4e 41 4d 45 2b 32 5d 3b 0a 20 X_PATHNAME+2];.
2f2c0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
2f2d0 6d 65 20 3d 20 7a 50 61 74 68 3b 0a 0a 20 20 2f me = zPath;.. /
2f2e0 2a 20 43 68 65 63 6b 20 74 68 65 20 66 6f 6c 6c * Check the foll
2f2f0 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 73 owing statements
2f300 20 61 72 65 20 74 72 75 65 3a 20 0a 20 20 2a 2a are true: . **
2f310 0a 20 20 2a 2a 20 20 20 28 61 29 20 45 78 61 63 . ** (a) Exac
2f320 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 52 tly one of the R
2f330 45 41 44 57 52 49 54 45 20 61 6e 64 20 52 45 41 EADWRITE and REA
2f340 44 4f 4e 4c 59 20 66 6c 61 67 73 20 6d 75 73 74 DONLY flags must
2f350 20 62 65 20 73 65 74 2c 20 61 6e 64 20 0a 20 20 be set, and .
2f360 2a 2a 20 20 20 28 62 29 20 69 66 20 43 52 45 41 ** (b) if CREA
2f370 54 45 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 TE is set, then
2f380 52 45 41 44 57 52 49 54 45 20 6d 75 73 74 20 61 READWRITE must a
2f390 6c 73 6f 20 62 65 20 73 65 74 2c 20 61 6e 64 0a lso be set, and.
2f3a0 20 20 2a 2a 20 20 20 28 63 29 20 69 66 20 45 58 ** (c) if EX
2f3b0 43 4c 55 53 49 56 45 20 69 73 20 73 65 74 2c 20 CLUSIVE is set,
2f3c0 74 68 65 6e 20 43 52 45 41 54 45 20 6d 75 73 74 then CREATE must
2f3d0 20 61 6c 73 6f 20 62 65 20 73 65 74 2e 0a 20 20 also be set..
2f3e0 2a 2a 20 20 20 28 64 29 20 69 66 20 44 45 4c 45 ** (d) if DELE
2f3f0 54 45 4f 4e 43 4c 4f 53 45 20 69 73 20 73 65 74 TEONCLOSE is set
2f400 2c 20 74 68 65 6e 20 43 52 45 41 54 45 20 6d 75 , then CREATE mu
2f410 73 74 20 61 6c 73 6f 20 62 65 20 73 65 74 2e 0a st also be set..
2f420 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 28 69 */. assert((i
2f430 73 52 65 61 64 6f 6e 6c 79 3d 3d 30 20 7c 7c 20 sReadonly==0 ||
2f440 69 73 52 65 61 64 57 72 69 74 65 3d 3d 30 29 20 isReadWrite==0)
2f450 26 26 20 28 69 73 52 65 61 64 57 72 69 74 65 20 && (isReadWrite
2f460 7c 7c 20 69 73 52 65 61 64 6f 6e 6c 79 29 29 3b || isReadonly));
2f470 0a 20 20 61 73 73 65 72 74 28 69 73 43 72 65 61 . assert(isCrea
2f480 74 65 3d 3d 30 20 7c 7c 20 69 73 52 65 61 64 57 te==0 || isReadW
2f490 72 69 74 65 29 3b 0a 20 20 61 73 73 65 72 74 28 rite);. assert(
2f4a0 69 73 45 78 63 6c 75 73 69 76 65 3d 3d 30 20 7c isExclusive==0 |
2f4b0 7c 20 69 73 43 72 65 61 74 65 29 3b 0a 20 20 61 | isCreate);. a
2f4c0 73 73 65 72 74 28 69 73 44 65 6c 65 74 65 3d 3d ssert(isDelete==
2f4d0 30 20 7c 7c 20 69 73 43 72 65 61 74 65 29 3b 0a 0 || isCreate);.
2f4e0 0a 20 20 2f 2a 20 54 68 65 20 6d 61 69 6e 20 44 . /* The main D
2f4f0 42 2c 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 2c B, main journal,
2f500 20 57 41 4c 20 66 69 6c 65 20 61 6e 64 20 6d 61 WAL file and ma
2f510 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 61 72 65 ster journal are
2f520 20 6e 65 76 65 72 20 0a 20 20 2a 2a 20 61 75 74 never . ** aut
2f530 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 omatically delet
2f540 65 64 2e 20 4e 6f 72 20 61 72 65 20 74 68 65 79 ed. Nor are they
2f550 20 65 76 65 72 20 74 65 6d 70 6f 72 61 72 79 20 ever temporary
2f560 66 69 6c 65 73 2e 20 20 2a 2f 0a 20 20 61 73 73 files. */. ass
2f570 65 72 74 28 20 28 21 69 73 44 65 6c 65 74 65 20 ert( (!isDelete
2f580 26 26 20 7a 4e 61 6d 65 29 20 7c 7c 20 65 54 79 && zName) || eTy
2f590 70 65 21 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f pe!=SQLITE_OPEN_
2f5a0 4d 41 49 4e 5f 44 42 20 29 3b 0a 20 20 61 73 73 MAIN_DB );. ass
2f5b0 65 72 74 28 20 28 21 69 73 44 65 6c 65 74 65 20 ert( (!isDelete
2f5c0 26 26 20 7a 4e 61 6d 65 29 20 7c 7c 20 65 54 79 && zName) || eTy
2f5d0 70 65 21 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f pe!=SQLITE_OPEN_
2f5e0 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 29 3b 0a MAIN_JOURNAL );.
2f5f0 20 20 61 73 73 65 72 74 28 20 28 21 69 73 44 65 assert( (!isDe
2f600 6c 65 74 65 20 26 26 20 7a 4e 61 6d 65 29 20 7c lete && zName) |
2f610 7c 20 65 54 79 70 65 21 3d 53 51 4c 49 54 45 5f | eType!=SQLITE_
2f620 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 OPEN_MASTER_JOUR
2f630 4e 41 4c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 NAL );. assert(
2f640 20 28 21 69 73 44 65 6c 65 74 65 20 26 26 20 7a (!isDelete && z
2f650 4e 61 6d 65 29 20 7c 7c 20 65 54 79 70 65 21 3d Name) || eType!=
2f660 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 57 41 4c 20 SQLITE_OPEN_WAL
2f670 29 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 );.. /* Assert
2f680 74 68 61 74 20 74 68 65 20 75 70 70 65 72 20 6c that the upper l
2f690 61 79 65 72 20 68 61 73 20 73 65 74 20 6f 6e 65 ayer has set one
2f6a0 20 6f 66 20 74 68 65 20 22 66 69 6c 65 2d 74 79 of the "file-ty
2f6b0 70 65 22 20 66 6c 61 67 73 2e 20 2a 2f 0a 20 20 pe" flags. */.
2f6c0 61 73 73 65 72 74 28 20 65 54 79 70 65 3d 3d 53 assert( eType==S
2f6d0 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f QLITE_OPEN_MAIN_
2f6e0 44 42 20 20 20 20 20 20 7c 7c 20 65 54 79 70 65 DB || eType
2f6f0 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 ==SQLITE_OPEN_TE
2f700 4d 50 5f 44 42 20 0a 20 20 20 20 20 20 20 7c 7c MP_DB . ||
2f710 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f eType==SQLITE_O
2f720 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c PEN_MAIN_JOURNAL
2f730 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 || eType==SQLIT
2f740 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 E_OPEN_TEMP_JOUR
2f750 4e 41 4c 20 0a 20 20 20 20 20 20 20 7c 7c 20 65 NAL . || e
2f760 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 Type==SQLITE_OPE
2f770 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 20 20 7c N_SUBJOURNAL |
2f780 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f | eType==SQLITE_
2f790 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 OPEN_MASTER_JOUR
2f7a0 4e 41 4c 20 0a 20 20 20 20 20 20 20 7c 7c 20 65 NAL . || e
2f7b0 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 Type==SQLITE_OPE
2f7c0 4e 5f 54 52 41 4e 53 49 45 4e 54 5f 44 42 20 7c N_TRANSIENT_DB |
2f7d0 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f | eType==SQLITE_
2f7e0 4f 50 45 4e 5f 57 41 4c 0a 20 20 29 3b 0a 0a 20 OPEN_WAL. );..
2f7f0 20 2f 2a 20 44 65 74 65 63 74 20 61 20 70 69 64 /* Detect a pid
2f800 20 63 68 61 6e 67 65 20 61 6e 64 20 72 65 73 65 change and rese
2f810 74 20 74 68 65 20 50 52 4e 47 2e 20 20 54 68 65 t the PRNG. The
2f820 72 65 20 69 73 20 61 20 72 61 63 65 20 63 6f 6e re is a race con
2f830 64 69 74 69 6f 6e 0a 20 20 2a 2a 20 68 65 72 65 dition. ** here
2f840 20 73 75 63 68 20 74 68 61 74 20 74 77 6f 20 6f such that two o
2f850 72 20 6d 6f 72 65 20 74 68 72 65 61 64 73 20 61 r more threads a
2f860 6c 6c 20 74 72 79 69 6e 67 20 74 6f 20 6f 70 65 ll trying to ope
2f870 6e 20 64 61 74 61 62 61 73 65 73 20 61 74 0a 20 n databases at.
2f880 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 69 6e 73 ** the same ins
2f890 74 61 6e 74 20 6d 69 67 68 74 20 61 6c 6c 20 72 tant might all r
2f8a0 65 73 65 74 20 74 68 65 20 50 52 4e 47 2e 20 20 eset the PRNG.
2f8b0 42 75 74 20 6d 75 6c 74 69 70 6c 65 20 72 65 73 But multiple res
2f8c0 65 74 73 0a 20 20 2a 2a 20 61 72 65 20 68 61 72 ets. ** are har
2f8d0 6d 6c 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 mless.. */. if
2f8e0 28 20 72 61 6e 64 6f 6d 6e 65 73 73 50 69 64 21 ( randomnessPid!
2f8f0 3d 6f 73 47 65 74 70 69 64 28 30 29 20 29 7b 0a =osGetpid(0) ){.
2f900 20 20 20 20 72 61 6e 64 6f 6d 6e 65 73 73 50 69 randomnessPi
2f910 64 20 3d 20 6f 73 47 65 74 70 69 64 28 30 29 3b d = osGetpid(0);
2f920 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72 61 6e . sqlite3_ran
2f930 64 6f 6d 6e 65 73 73 28 30 2c 30 29 3b 0a 20 20 domness(0,0);.
2f940 7d 0a 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 }.. memset(p, 0
2f950 2c 20 73 69 7a 65 6f 66 28 75 6e 69 78 46 69 6c , sizeof(unixFil
2f960 65 29 29 3b 0a 0a 20 20 69 66 28 20 65 54 79 70 e));.. if( eTyp
2f970 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d e==SQLITE_OPEN_M
2f980 41 49 4e 5f 44 42 20 29 7b 0a 20 20 20 20 55 6e AIN_DB ){. Un
2f990 69 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e 75 ixUnusedFd *pUnu
2f9a0 73 65 64 3b 0a 20 20 20 20 70 55 6e 75 73 65 64 sed;. pUnused
2f9b0 20 3d 20 66 69 6e 64 52 65 75 73 61 62 6c 65 46 = findReusableF
2f9c0 64 28 7a 4e 61 6d 65 2c 20 66 6c 61 67 73 29 3b d(zName, flags);
2f9d0 0a 20 20 20 20 69 66 28 20 70 55 6e 75 73 65 64 . if( pUnused
2f9e0 20 29 7b 0a 20 20 20 20 20 20 66 64 20 3d 20 70 ){. fd = p
2f9f0 55 6e 75 73 65 64 2d 3e 66 64 3b 0a 20 20 20 20 Unused->fd;.
2fa00 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 55 6e }else{. pUn
2fa10 75 73 65 64 20 3d 20 73 71 6c 69 74 65 33 5f 6d used = sqlite3_m
2fa20 61 6c 6c 6f 63 36 34 28 73 69 7a 65 6f 66 28 2a alloc64(sizeof(*
2fa30 70 55 6e 75 73 65 64 29 29 3b 0a 20 20 20 20 20 pUnused));.
2fa40 20 69 66 28 20 21 70 55 6e 75 73 65 64 20 29 7b if( !pUnused ){
2fa50 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
2fa60 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
2fa70 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d T;. }. }
2fa80 0a 20 20 20 20 70 2d 3e 70 55 6e 75 73 65 64 20 . p->pUnused
2fa90 3d 20 70 55 6e 75 73 65 64 3b 0a 0a 20 20 20 20 = pUnused;..
2faa0 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 /* Database file
2fab0 6e 61 6d 65 73 20 61 72 65 20 64 6f 75 62 6c 65 names are double
2fac0 2d 7a 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 64 -zero terminated
2fad0 20 69 66 20 74 68 65 79 20 61 72 65 20 6e 6f 74 if they are not
2fae0 0a 20 20 20 20 2a 2a 20 55 52 49 73 20 77 69 74 . ** URIs wit
2faf0 68 20 70 61 72 61 6d 65 74 65 72 73 2e 20 20 48 h parameters. H
2fb00 65 6e 63 65 2c 20 74 68 65 79 20 63 61 6e 20 61 ence, they can a
2fb10 6c 77 61 79 73 20 62 65 20 70 61 73 73 65 64 20 lways be passed
2fb20 69 6e 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 into. ** sqli
2fb30 74 65 33 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 te3_uri_paramete
2fb40 72 28 29 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 r(). */. asse
2fb50 72 74 28 20 28 66 6c 61 67 73 20 26 20 53 51 4c rt( (flags & SQL
2fb60 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29 20 7c 7c ITE_OPEN_URI) ||
2fb70 20 7a 4e 61 6d 65 5b 73 74 72 6c 65 6e 28 7a 4e zName[strlen(zN
2fb80 61 6d 65 29 2b 31 5d 3d 3d 30 20 29 3b 0a 0a 20 ame)+1]==0 );..
2fb90 20 7d 65 6c 73 65 20 69 66 28 20 21 7a 4e 61 6d }else if( !zNam
2fba0 65 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 7a e ){. /* If z
2fbb0 4e 61 6d 65 20 69 73 20 4e 55 4c 4c 2c 20 74 68 Name is NULL, th
2fbc0 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 69 73 e upper layer is
2fbd0 20 72 65 71 75 65 73 74 69 6e 67 20 61 20 74 65 requesting a te
2fbe0 6d 70 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 mp file. */.
2fbf0 61 73 73 65 72 74 28 69 73 44 65 6c 65 74 65 20 assert(isDelete
2fc00 26 26 20 21 73 79 6e 63 44 69 72 29 3b 0a 20 20 && !syncDir);.
2fc10 20 20 72 63 20 3d 20 75 6e 69 78 47 65 74 54 65 rc = unixGetTe
2fc20 6d 70 6e 61 6d 65 28 70 56 66 73 2d 3e 6d 78 50 mpname(pVfs->mxP
2fc30 61 74 68 6e 61 6d 65 2c 20 7a 54 6d 70 6e 61 6d athname, zTmpnam
2fc40 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
2fc50 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2fc60 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
2fc70 20 20 7d 0a 20 20 20 20 7a 4e 61 6d 65 20 3d 20 }. zName =
2fc80 7a 54 6d 70 6e 61 6d 65 3b 0a 0a 20 20 20 20 2f zTmpname;.. /
2fc90 2a 20 47 65 6e 65 72 61 74 65 64 20 74 65 6d 70 * Generated temp
2fca0 6f 72 61 72 79 20 66 69 6c 65 6e 61 6d 65 73 20 orary filenames
2fcb0 61 72 65 20 61 6c 77 61 79 73 20 64 6f 75 62 6c are always doubl
2fcc0 65 2d 7a 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 e-zero terminate
2fcd0 64 0a 20 20 20 20 2a 2a 20 66 6f 72 20 75 73 65 d. ** for use
2fce0 20 62 79 20 73 71 6c 69 74 65 33 5f 75 72 69 5f by sqlite3_uri_
2fcf0 70 61 72 61 6d 65 74 65 72 28 29 2e 20 2a 2f 0a parameter(). */.
2fd00 20 20 20 20 61 73 73 65 72 74 28 20 7a 4e 61 6d assert( zNam
2fd10 65 5b 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 2b e[strlen(zName)+
2fd20 31 5d 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 1]==0 );. }..
2fd30 2f 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68 65 /* Determine the
2fd40 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 66 6c value of the fl
2fd50 61 67 73 20 70 61 72 61 6d 65 74 65 72 20 70 61 ags parameter pa
2fd60 73 73 65 64 20 74 6f 20 50 4f 53 49 58 20 66 75 ssed to POSIX fu
2fd70 6e 63 74 69 6f 6e 0a 20 20 2a 2a 20 6f 70 65 6e nction. ** open
2fd80 28 29 2e 20 54 68 65 73 65 20 6d 75 73 74 20 62 (). These must b
2fd90 65 20 63 61 6c 63 75 6c 61 74 65 64 20 65 76 65 e calculated eve
2fda0 6e 20 69 66 20 6f 70 65 6e 28 29 20 69 73 20 6e n if open() is n
2fdb0 6f 74 20 63 61 6c 6c 65 64 2c 20 61 73 0a 20 20 ot called, as.
2fdc0 2a 2a 20 74 68 65 79 20 6d 61 79 20 62 65 20 73 ** they may be s
2fdd0 74 6f 72 65 64 20 61 73 20 70 61 72 74 20 6f 66 tored as part of
2fde0 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 the file handle
2fdf0 20 61 6e 64 20 75 73 65 64 20 62 79 20 74 68 65 and used by the
2fe00 20 0a 20 20 2a 2a 20 27 63 6f 6e 63 68 20 66 69 . ** 'conch fi
2fe10 6c 65 27 20 6c 6f 63 6b 69 6e 67 20 66 75 6e 63 le' locking func
2fe20 74 69 6f 6e 73 20 6c 61 74 65 72 20 6f 6e 2e 20 tions later on.
2fe30 20 2a 2f 0a 20 20 69 66 28 20 69 73 52 65 61 64 */. if( isRead
2fe40 6f 6e 6c 79 20 29 20 20 6f 70 65 6e 46 6c 61 67 only ) openFlag
2fe50 73 20 7c 3d 20 4f 5f 52 44 4f 4e 4c 59 3b 0a 20 s |= O_RDONLY;.
2fe60 20 69 66 28 20 69 73 52 65 61 64 57 72 69 74 65 if( isReadWrite
2fe70 20 29 20 6f 70 65 6e 46 6c 61 67 73 20 7c 3d 20 ) openFlags |=
2fe80 4f 5f 52 44 57 52 3b 0a 20 20 69 66 28 20 69 73 O_RDWR;. if( is
2fe90 43 72 65 61 74 65 20 29 20 20 20 20 6f 70 65 6e Create ) open
2fea0 46 6c 61 67 73 20 7c 3d 20 4f 5f 43 52 45 41 54 Flags |= O_CREAT
2feb0 3b 0a 20 20 69 66 28 20 69 73 45 78 63 6c 75 73 ;. if( isExclus
2fec0 69 76 65 20 29 20 6f 70 65 6e 46 6c 61 67 73 20 ive ) openFlags
2fed0 7c 3d 20 28 4f 5f 45 58 43 4c 7c 4f 5f 4e 4f 46 |= (O_EXCL|O_NOF
2fee0 4f 4c 4c 4f 57 29 3b 0a 20 20 6f 70 65 6e 46 6c OLLOW);. openFl
2fef0 61 67 73 20 7c 3d 20 28 4f 5f 4c 41 52 47 45 46 ags |= (O_LARGEF
2ff00 49 4c 45 7c 4f 5f 42 49 4e 41 52 59 29 3b 0a 0a ILE|O_BINARY);..
2ff10 20 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 if( fd<0 ){.
2ff20 20 20 6d 6f 64 65 5f 74 20 6f 70 65 6e 4d 6f 64 mode_t openMod
2ff30 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
2ff40 2f 2a 20 50 65 72 6d 69 73 73 69 6f 6e 73 20 74 /* Permissions t
2ff50 6f 20 63 72 65 61 74 65 20 66 69 6c 65 20 77 69 o create file wi
2ff60 74 68 20 2a 2f 0a 20 20 20 20 75 69 64 5f 74 20 th */. uid_t
2ff70 75 69 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 uid;
2ff80 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 72 69 /* Useri
2ff90 64 20 66 6f 72 20 74 68 65 20 66 69 6c 65 20 2a d for the file *
2ffa0 2f 0a 20 20 20 20 67 69 64 5f 74 20 67 69 64 3b /. gid_t gid;
2ffb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ffc0 20 20 20 20 2f 2a 20 47 72 6f 75 70 69 64 20 66 /* Groupid f
2ffd0 6f 72 20 74 68 65 20 66 69 6c 65 20 2a 2f 0a 20 or the file */.
2ffe0 20 20 20 72 63 20 3d 20 66 69 6e 64 43 72 65 61 rc = findCrea
2fff0 74 65 46 69 6c 65 4d 6f 64 65 28 7a 4e 61 6d 65 teFileMode(zName
30000 2c 20 66 6c 61 67 73 2c 20 26 6f 70 65 6e 4d 6f , flags, &openMo
30010 64 65 2c 20 26 75 69 64 2c 20 26 67 69 64 29 3b de, &uid, &gid);
30020 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
30030 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
30040 61 73 73 65 72 74 28 20 21 70 2d 3e 70 55 6e 75 assert( !p->pUnu
30050 73 65 64 20 29 3b 0a 20 20 20 20 20 20 61 73 73 sed );. ass
30060 65 72 74 28 20 65 54 79 70 65 3d 3d 53 51 4c 49 ert( eType==SQLI
30070 54 45 5f 4f 50 45 4e 5f 57 41 4c 20 7c 7c 20 65 TE_OPEN_WAL || e
30080 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 Type==SQLITE_OPE
30090 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 29 N_MAIN_JOURNAL )
300a0 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 ;. return r
300b0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 64 20 c;. }. fd
300c0 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 7a 4e = robust_open(zN
300d0 61 6d 65 2c 20 6f 70 65 6e 46 6c 61 67 73 2c 20 ame, openFlags,
300e0 6f 70 65 6e 4d 6f 64 65 29 3b 0a 20 20 20 20 4f openMode);. O
300f0 53 54 52 41 43 45 28 28 22 4f 50 45 4e 58 20 20 STRACE(("OPENX
30100 20 25 2d 33 64 20 25 73 20 30 25 6f 5c 6e 22 2c %-3d %s 0%o\n",
30110 20 66 64 2c 20 7a 4e 61 6d 65 2c 20 6f 70 65 6e fd, zName, open
30120 46 6c 61 67 73 29 29 3b 0a 20 20 20 20 61 73 73 Flags));. ass
30130 65 72 74 28 20 21 69 73 45 78 63 6c 75 73 69 76 ert( !isExclusiv
30140 65 20 7c 7c 20 28 6f 70 65 6e 46 6c 61 67 73 20 e || (openFlags
30150 26 20 4f 5f 43 52 45 41 54 29 21 3d 30 20 29 3b & O_CREAT)!=0 );
30160 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 26 26 . if( fd<0 &&
30170 20 65 72 72 6e 6f 21 3d 45 49 53 44 49 52 20 26 errno!=EISDIR &
30180 26 20 69 73 52 65 61 64 57 72 69 74 65 20 29 7b & isReadWrite ){
30190 0a 20 20 20 20 20 20 2f 2a 20 46 61 69 6c 65 64 . /* Failed
301a0 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 66 69 6c to open the fil
301b0 65 20 66 6f 72 20 72 65 61 64 2f 77 72 69 74 65 e for read/write
301c0 20 61 63 63 65 73 73 2e 20 54 72 79 20 72 65 61 access. Try rea
301d0 64 2d 6f 6e 6c 79 2e 20 2a 2f 0a 20 20 20 20 20 d-only. */.
301e0 20 66 6c 61 67 73 20 26 3d 20 7e 28 53 51 4c 49 flags &= ~(SQLI
301f0 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
30200 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 E|SQLITE_OPEN_CR
30210 45 41 54 45 29 3b 0a 20 20 20 20 20 20 6f 70 65 EATE);. ope
30220 6e 46 6c 61 67 73 20 26 3d 20 7e 28 4f 5f 52 44 nFlags &= ~(O_RD
30230 57 52 7c 4f 5f 43 52 45 41 54 29 3b 0a 20 20 20 WR|O_CREAT);.
30240 20 20 20 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 flags |= SQLI
30250 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 TE_OPEN_READONLY
30260 3b 0a 20 20 20 20 20 20 6f 70 65 6e 46 6c 61 67 ;. openFlag
30270 73 20 7c 3d 20 4f 5f 52 44 4f 4e 4c 59 3b 0a 20 s |= O_RDONLY;.
30280 20 20 20 20 20 69 73 52 65 61 64 6f 6e 6c 79 20 isReadonly
30290 3d 20 31 3b 0a 20 20 20 20 20 20 66 64 20 3d 20 = 1;. fd =
302a0 72 6f 62 75 73 74 5f 6f 70 65 6e 28 7a 4e 61 6d robust_open(zNam
302b0 65 2c 20 6f 70 65 6e 46 6c 61 67 73 2c 20 6f 70 e, openFlags, op
302c0 65 6e 4d 6f 64 65 29 3b 0a 20 20 20 20 7d 0a 20 enMode);. }.
302d0 20 20 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 if( fd<0 ){.
302e0 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 4c 6f rc = unixLo
302f0 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 41 gError(SQLITE_CA
30300 4e 54 4f 50 45 4e 5f 42 4b 50 54 2c 20 22 6f 70 NTOPEN_BKPT, "op
30310 65 6e 22 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 en", zName);.
30320 20 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 66 69 6e goto open_fin
30330 69 73 68 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 ished;. }..
30340 20 20 2f 2a 20 49 66 20 74 68 69 73 20 70 72 6f /* If this pro
30350 63 65 73 73 20 69 73 20 72 75 6e 6e 69 6e 67 20 cess is running
30360 61 73 20 72 6f 6f 74 20 61 6e 64 20 69 66 20 63 as root and if c
30370 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 72 6f reating a new ro
30380 6c 6c 62 61 63 6b 0a 20 20 20 20 2a 2a 20 6a 6f llback. ** jo
30390 75 72 6e 61 6c 20 6f 72 20 57 41 4c 20 66 69 6c urnal or WAL fil
303a0 65 2c 20 73 65 74 20 74 68 65 20 6f 77 6e 65 72 e, set the owner
303b0 73 68 69 70 20 6f 66 20 74 68 65 20 6a 6f 75 72 ship of the jour
303c0 6e 61 6c 20 6f 72 20 57 41 4c 20 74 6f 20 62 65 nal or WAL to be
303d0 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 61 6d 65 . ** the same
303e0 20 61 73 20 74 68 65 20 6f 72 69 67 69 6e 61 6c as the original
303f0 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 2a database.. *
30400 2f 0a 20 20 20 20 69 66 28 20 66 6c 61 67 73 20 /. if( flags
30410 26 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 57 & (SQLITE_OPEN_W
30420 41 4c 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d AL|SQLITE_OPEN_M
30430 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 20 29 7b 0a AIN_JOURNAL) ){.
30440 20 20 20 20 20 20 72 6f 62 75 73 74 46 63 68 6f robustFcho
30450 77 6e 28 66 64 2c 20 75 69 64 2c 20 67 69 64 29 wn(fd, uid, gid)
30460 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 ;. }. }. as
30470 73 65 72 74 28 20 66 64 3e 3d 30 20 29 3b 0a 20 sert( fd>=0 );.
30480 20 69 66 28 20 70 4f 75 74 46 6c 61 67 73 20 29 if( pOutFlags )
30490 7b 0a 20 20 20 20 2a 70 4f 75 74 46 6c 61 67 73 {. *pOutFlags
304a0 20 3d 20 66 6c 61 67 73 3b 0a 20 20 7d 0a 0a 20 = flags;. }..
304b0 20 69 66 28 20 70 2d 3e 70 55 6e 75 73 65 64 20 if( p->pUnused
304c0 29 7b 0a 20 20 20 20 70 2d 3e 70 55 6e 75 73 65 ){. p->pUnuse
304d0 64 2d 3e 66 64 20 3d 20 66 64 3b 0a 20 20 20 20 d->fd = fd;.
304e0 70 2d 3e 70 55 6e 75 73 65 64 2d 3e 66 6c 61 67 p->pUnused->flag
304f0 73 20 3d 20 66 6c 61 67 73 3b 0a 20 20 7d 0a 0a s = flags;. }..
30500 20 20 69 66 28 20 69 73 44 65 6c 65 74 65 20 29 if( isDelete )
30510 7b 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 {.#if OS_VXWORKS
30520 0a 20 20 20 20 7a 50 61 74 68 20 3d 20 7a 4e 61 . zPath = zNa
30530 6d 65 3b 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 me;.#elif define
30540 64 28 53 51 4c 49 54 45 5f 55 4e 4c 49 4e 4b 5f d(SQLITE_UNLINK_
30550 41 46 54 45 52 5f 43 4c 4f 53 45 29 0a 20 20 20 AFTER_CLOSE).
30560 20 7a 50 61 74 68 20 3d 20 73 71 6c 69 74 65 33 zPath = sqlite3
30570 5f 6d 70 72 69 6e 74 66 28 22 25 73 22 2c 20 7a _mprintf("%s", z
30580 4e 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 7a Name);. if( z
30590 50 61 74 68 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Path==0 ){.
305a0 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 2c robust_close(p,
305b0 20 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a fd, __LINE__);.
305c0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
305d0 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a ITE_NOMEM_BKPT;.
305e0 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 }.#else.
305f0 6f 73 55 6e 6c 69 6e 6b 28 7a 4e 61 6d 65 29 3b osUnlink(zName);
30600 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 23 69 66 20 .#endif. }.#if
30610 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f SQLITE_ENABLE_LO
30620 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 65 6c CKING_STYLE. el
30630 73 65 7b 0a 20 20 20 20 70 2d 3e 6f 70 65 6e 46 se{. p->openF
30640 6c 61 67 73 20 3d 20 6f 70 65 6e 46 6c 61 67 73 lags = openFlags
30650 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 0a ;. }.#endif. .
30660 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 #if defined(__AP
30670 50 4c 45 5f 5f 29 20 7c 7c 20 53 51 4c 49 54 45 PLE__) || SQLITE
30680 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f _ENABLE_LOCKING_
30690 53 54 59 4c 45 0a 20 20 69 66 28 20 66 73 74 61 STYLE. if( fsta
306a0 74 66 73 28 66 64 2c 20 26 66 73 49 6e 66 6f 29 tfs(fd, &fsInfo)
306b0 20 3d 3d 20 2d 31 20 29 7b 0a 20 20 20 20 73 74 == -1 ){. st
306c0 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 2c 20 oreLastErrno(p,
306d0 65 72 72 6e 6f 29 3b 0a 20 20 20 20 72 6f 62 75 errno);. robu
306e0 73 74 5f 63 6c 6f 73 65 28 70 2c 20 66 64 2c 20 st_close(p, fd,
306f0 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 72 __LINE__);. r
30700 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 eturn SQLITE_IOE
30710 52 52 5f 41 43 43 45 53 53 3b 0a 20 20 7d 0a 20 RR_ACCESS;. }.
30720 20 69 66 20 28 30 20 3d 3d 20 73 74 72 6e 63 6d if (0 == strncm
30730 70 28 22 6d 73 64 6f 73 22 2c 20 66 73 49 6e 66 p("msdos", fsInf
30740 6f 2e 66 5f 66 73 74 79 70 65 6e 61 6d 65 2c 20 o.f_fstypename,
30750 35 29 29 20 7b 0a 20 20 20 20 28 28 75 6e 69 78 5)) {. ((unix
30760 46 69 6c 65 2a 29 70 46 69 6c 65 29 2d 3e 66 73 File*)pFile)->fs
30770 46 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f Flags |= SQLITE_
30780 46 53 46 4c 41 47 53 5f 49 53 5f 4d 53 44 4f 53 FSFLAGS_IS_MSDOS
30790 3b 0a 20 20 7d 0a 20 20 69 66 20 28 30 20 3d 3d ;. }. if (0 ==
307a0 20 73 74 72 6e 63 6d 70 28 22 65 78 66 61 74 22 strncmp("exfat"
307b0 2c 20 66 73 49 6e 66 6f 2e 66 5f 66 73 74 79 70 , fsInfo.f_fstyp
307c0 65 6e 61 6d 65 2c 20 35 29 29 20 7b 0a 20 20 20 ename, 5)) {.
307d0 20 28 28 75 6e 69 78 46 69 6c 65 2a 29 70 46 69 ((unixFile*)pFi
307e0 6c 65 29 2d 3e 66 73 46 6c 61 67 73 20 7c 3d 20 le)->fsFlags |=
307f0 53 51 4c 49 54 45 5f 46 53 46 4c 41 47 53 5f 49 SQLITE_FSFLAGS_I
30800 53 5f 4d 53 44 4f 53 3b 0a 20 20 7d 0a 23 65 6e S_MSDOS;. }.#en
30810 64 69 66 0a 0a 20 20 2f 2a 20 53 65 74 20 75 70 dif.. /* Set up
30820 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 74 72 appropriate ctr
30830 6c 46 6c 61 67 73 20 2a 2f 0a 20 20 69 66 28 20 lFlags */. if(
30840 69 73 44 65 6c 65 74 65 20 29 20 20 20 20 20 20 isDelete )
30850 20 20 20 20 20 20 20 20 20 20 63 74 72 6c 46 6c ctrlFl
30860 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45 5f ags |= UNIXFILE_
30870 44 45 4c 45 54 45 3b 0a 20 20 69 66 28 20 69 73 DELETE;. if( is
30880 52 65 61 64 6f 6e 6c 79 20 29 20 20 20 20 20 20 Readonly )
30890 20 20 20 20 20 20 20 20 63 74 72 6c 46 6c 61 67 ctrlFlag
308a0 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45 5f 52 44 s |= UNIXFILE_RD
308b0 4f 4e 4c 59 3b 0a 20 20 6e 6f 4c 6f 63 6b 20 3d ONLY;. noLock =
308c0 20 65 54 79 70 65 21 3d 53 51 4c 49 54 45 5f 4f eType!=SQLITE_O
308d0 50 45 4e 5f 4d 41 49 4e 5f 44 42 3b 0a 20 20 69 PEN_MAIN_DB;. i
308e0 66 28 20 6e 6f 4c 6f 63 6b 20 29 20 20 20 20 20 f( noLock )
308f0 20 20 20 20 20 20 20 20 20 20 20 20 20 63 74 72 ctr
30900 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 lFlags |= UNIXFI
30910 4c 45 5f 4e 4f 4c 4f 43 4b 3b 0a 20 20 69 66 28 LE_NOLOCK;. if(
30920 20 73 79 6e 63 44 69 72 20 29 20 20 20 20 20 20 syncDir )
30930 20 20 20 20 20 20 20 20 20 20 20 63 74 72 6c 46 ctrlF
30940 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45 lags |= UNIXFILE
30950 5f 44 49 52 53 59 4e 43 3b 0a 20 20 69 66 28 20 _DIRSYNC;. if(
30960 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f flags & SQLITE_O
30970 50 45 4e 5f 55 52 49 20 29 20 63 74 72 6c 46 6c PEN_URI ) ctrlFl
30980 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45 5f ags |= UNIXFILE_
30990 55 52 49 3b 0a 0a 23 69 66 20 53 51 4c 49 54 45 URI;..#if SQLITE
309a0 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f _ENABLE_LOCKING_
309b0 53 54 59 4c 45 0a 23 69 66 20 53 51 4c 49 54 45 STYLE.#if SQLITE
309c0 5f 50 52 45 46 45 52 5f 50 52 4f 58 59 5f 4c 4f _PREFER_PROXY_LO
309d0 43 4b 49 4e 47 0a 20 20 69 73 41 75 74 6f 50 72 CKING. isAutoPr
309e0 6f 78 79 20 3d 20 31 3b 0a 23 65 6e 64 69 66 0a oxy = 1;.#endif.
309f0 20 20 69 66 28 20 69 73 41 75 74 6f 50 72 6f 78 if( isAutoProx
30a00 79 20 26 26 20 28 7a 50 61 74 68 21 3d 4e 55 4c y && (zPath!=NUL
30a10 4c 29 20 26 26 20 28 21 6e 6f 4c 6f 63 6b 29 20 L) && (!noLock)
30a20 26 26 20 70 56 66 73 2d 3e 78 4f 70 65 6e 20 29 && pVfs->xOpen )
30a30 7b 0a 20 20 20 20 63 68 61 72 20 2a 65 6e 76 66 {. char *envf
30a40 6f 72 63 65 20 3d 20 67 65 74 65 6e 76 28 22 53 orce = getenv("S
30a50 51 4c 49 54 45 5f 46 4f 52 43 45 5f 50 52 4f 58 QLITE_FORCE_PROX
30a60 59 5f 4c 4f 43 4b 49 4e 47 22 29 3b 0a 20 20 20 Y_LOCKING");.
30a70 20 69 6e 74 20 75 73 65 50 72 6f 78 79 20 3d 20 int useProxy =
30a80 30 3b 0a 0a 20 20 20 20 2f 2a 20 53 51 4c 49 54 0;.. /* SQLIT
30a90 45 5f 46 4f 52 43 45 5f 50 52 4f 58 59 5f 4c 4f E_FORCE_PROXY_LO
30aa0 43 4b 49 4e 47 3d 3d 31 20 6d 65 61 6e 73 20 66 CKING==1 means f
30ab0 6f 72 63 65 20 61 6c 77 61 79 73 20 75 73 65 20 orce always use
30ac0 70 72 6f 78 79 2c 20 30 20 6d 65 61 6e 73 20 0a proxy, 0 means .
30ad0 20 20 20 20 2a 2a 20 6e 65 76 65 72 20 75 73 65 ** never use
30ae0 20 70 72 6f 78 79 2c 20 4e 55 4c 4c 20 6d 65 61 proxy, NULL mea
30af0 6e 73 20 75 73 65 20 70 72 6f 78 79 20 66 6f 72 ns use proxy for
30b00 20 6e 6f 6e 2d 6c 6f 63 61 6c 20 66 69 6c 65 73 non-local files
30b10 20 6f 6e 6c 79 2e 20 20 2a 2f 0a 20 20 20 20 69 only. */. i
30b20 66 28 20 65 6e 76 66 6f 72 63 65 21 3d 4e 55 4c f( envforce!=NUL
30b30 4c 20 29 7b 0a 20 20 20 20 20 20 75 73 65 50 72 L ){. usePr
30b40 6f 78 79 20 3d 20 61 74 6f 69 28 65 6e 76 66 6f oxy = atoi(envfo
30b50 72 63 65 29 3e 30 3b 0a 20 20 20 20 7d 65 6c 73 rce)>0;. }els
30b60 65 7b 0a 20 20 20 20 20 20 75 73 65 50 72 6f 78 e{. useProx
30b70 79 20 3d 20 21 28 66 73 49 6e 66 6f 2e 66 5f 66 y = !(fsInfo.f_f
30b80 6c 61 67 73 26 4d 4e 54 5f 4c 4f 43 41 4c 29 3b lags&MNT_LOCAL);
30b90 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 75 . }. if( u
30ba0 73 65 50 72 6f 78 79 20 29 7b 0a 20 20 20 20 20 seProxy ){.
30bb0 20 72 63 20 3d 20 66 69 6c 6c 49 6e 55 6e 69 78 rc = fillInUnix
30bc0 46 69 6c 65 28 70 56 66 73 2c 20 66 64 2c 20 70 File(pVfs, fd, p
30bd0 46 69 6c 65 2c 20 7a 50 61 74 68 2c 20 63 74 72 File, zPath, ctr
30be0 6c 46 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 69 lFlags);. i
30bf0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
30c00 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
30c10 20 70 72 6f 78 79 54 72 61 6e 73 66 6f 72 6d 55 proxyTransformU
30c20 6e 69 78 46 69 6c 65 28 28 75 6e 69 78 46 69 6c nixFile((unixFil
30c30 65 2a 29 70 46 69 6c 65 2c 20 22 3a 61 75 74 6f e*)pFile, ":auto
30c40 3a 22 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 :");. if(
30c50 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
30c60 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 {. /* U
30c70 73 65 20 75 6e 69 78 43 6c 6f 73 65 20 74 6f 20 se unixClose to
30c80 63 6c 65 61 6e 20 75 70 20 74 68 65 20 72 65 73 clean up the res
30c90 6f 75 72 63 65 73 20 61 64 64 65 64 20 69 6e 20 ources added in
30ca0 66 69 6c 6c 49 6e 55 6e 69 78 46 69 6c 65 20 0a fillInUnixFile .
30cb0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 ** and
30cc0 20 63 6c 65 61 72 20 61 6c 6c 20 74 68 65 20 73 clear all the s
30cd0 74 72 75 63 74 75 72 65 27 73 20 72 65 66 65 72 tructure's refer
30ce0 65 6e 63 65 73 2e 20 20 53 70 65 63 69 66 69 63 ences. Specific
30cf0 61 6c 6c 79 2c 20 0a 20 20 20 20 20 20 20 20 20 ally, .
30d00 20 2a 2a 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 ** pFile->pMeth
30d10 6f 64 73 20 77 69 6c 6c 20 62 65 20 4e 55 4c 4c ods will be NULL
30d20 20 73 6f 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f so sqlite3OsClo
30d30 73 65 20 77 69 6c 6c 20 62 65 20 61 20 6e 6f 2d se will be a no-
30d40 6f 70 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2f op . */
30d50 0a 20 20 20 20 20 20 20 20 20 20 75 6e 69 78 43 . unixC
30d60 6c 6f 73 65 28 70 46 69 6c 65 29 3b 0a 20 20 20 lose(pFile);.
30d70 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
30d80 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
30d90 20 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f 20 6f }. goto o
30da0 70 65 6e 5f 66 69 6e 69 73 68 65 64 3b 0a 20 20 pen_finished;.
30db0 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
30dc0 20 0a 20 20 72 63 20 3d 20 66 69 6c 6c 49 6e 55 . rc = fillInU
30dd0 6e 69 78 46 69 6c 65 28 70 56 66 73 2c 20 66 64 nixFile(pVfs, fd
30de0 2c 20 70 46 69 6c 65 2c 20 7a 50 61 74 68 2c 20 , pFile, zPath,
30df0 63 74 72 6c 46 6c 61 67 73 29 3b 0a 0a 6f 70 65 ctrlFlags);..ope
30e00 6e 5f 66 69 6e 69 73 68 65 64 3a 0a 20 20 69 66 n_finished:. if
30e10 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
30e20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 ){. sqlite3_f
30e30 72 65 65 28 70 2d 3e 70 55 6e 75 73 65 64 29 3b ree(p->pUnused);
30e40 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
30e50 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 ;.}.../*.** Dele
30e60 74 65 20 74 68 65 20 66 69 6c 65 20 61 74 20 7a te the file at z
30e70 50 61 74 68 2e 20 49 66 20 74 68 65 20 64 69 72 Path. If the dir
30e80 53 79 6e 63 20 61 72 67 75 6d 65 6e 74 20 69 73 Sync argument is
30e90 20 74 72 75 65 2c 20 66 73 79 6e 63 28 29 0a 2a true, fsync().*
30ea0 2a 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 * the directory
30eb0 61 66 74 65 72 20 64 65 6c 65 74 69 6e 67 20 74 after deleting t
30ec0 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 he file..*/.stat
30ed0 69 63 20 69 6e 74 20 75 6e 69 78 44 65 6c 65 74 ic int unixDelet
30ee0 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 e(. sqlite3_vfs
30ef0 20 2a 4e 6f 74 55 73 65 64 2c 20 20 20 20 20 2f *NotUsed, /
30f00 2a 20 56 46 53 20 63 6f 6e 74 61 69 6e 69 6e 67 * VFS containing
30f10 20 74 68 69 73 20 61 73 20 74 68 65 20 78 44 65 this as the xDe
30f20 6c 65 74 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 lete method */.
30f30 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 const char *zPa
30f40 74 68 2c 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 th, /* Na
30f50 6d 65 20 6f 66 20 66 69 6c 65 20 74 6f 20 62 65 me of file to be
30f60 20 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 69 6e deleted */. in
30f70 74 20 64 69 72 53 79 6e 63 20 20 20 20 20 20 20 t dirSync
30f80 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 72 /* If tr
30f90 75 65 2c 20 66 73 79 6e 63 28 29 20 64 69 72 65 ue, fsync() dire
30fa0 63 74 6f 72 79 20 61 66 74 65 72 20 64 65 6c 65 ctory after dele
30fb0 74 69 6e 67 20 66 69 6c 65 20 2a 2f 0a 29 7b 0a ting file */.){.
30fc0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
30fd0 45 5f 4f 4b 3b 0a 20 20 55 4e 55 53 45 44 5f 50 E_OK;. UNUSED_P
30fe0 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 ARAMETER(NotUsed
30ff0 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 );. SimulateIOE
31000 72 72 6f 72 28 72 65 74 75 72 6e 20 53 51 4c 49 rror(return SQLI
31010 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 29 TE_IOERR_DELETE)
31020 3b 0a 20 20 69 66 28 20 6f 73 55 6e 6c 69 6e 6b ;. if( osUnlink
31030 28 7a 50 61 74 68 29 3d 3d 28 2d 31 29 20 29 7b (zPath)==(-1) ){
31040 0a 20 20 20 20 69 66 28 20 65 72 72 6e 6f 3d 3d . if( errno==
31050 45 4e 4f 45 4e 54 0a 23 69 66 20 4f 53 5f 56 58 ENOENT.#if OS_VX
31060 57 4f 52 4b 53 0a 20 20 20 20 20 20 20 20 7c 7c WORKS. ||
31070 20 6f 73 41 63 63 65 73 73 28 7a 50 61 74 68 2c osAccess(zPath,
31080 30 29 21 3d 30 0a 23 65 6e 64 69 66 0a 20 20 20 0)!=0.#endif.
31090 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
310a0 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 QLITE_IOERR_DELE
310b0 54 45 5f 4e 4f 45 4e 54 3b 0a 20 20 20 20 7d 65 TE_NOENT;. }e
310c0 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 lse{. rc =
310d0 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c unixLogError(SQL
310e0 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45 54 45 ITE_IOERR_DELETE
310f0 2c 20 22 75 6e 6c 69 6e 6b 22 2c 20 7a 50 61 74 , "unlink", zPat
31100 68 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 h);. }. re
31110 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 23 69 66 turn rc;. }.#if
31120 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 ndef SQLITE_DISA
31130 42 4c 45 5f 44 49 52 53 59 4e 43 0a 20 20 69 66 BLE_DIRSYNC. if
31140 28 20 28 64 69 72 53 79 6e 63 20 26 20 31 29 21 ( (dirSync & 1)!
31150 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 66 64 =0 ){. int fd
31160 3b 0a 20 20 20 20 72 63 20 3d 20 6f 73 4f 70 65 ;. rc = osOpe
31170 6e 44 69 72 65 63 74 6f 72 79 28 7a 50 61 74 68 nDirectory(zPath
31180 2c 20 26 66 64 29 3b 0a 20 20 20 20 69 66 28 20 , &fd);. if(
31190 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
311a0 0a 20 20 20 20 20 20 69 66 28 20 66 75 6c 6c 5f . if( full_
311b0 66 73 79 6e 63 28 66 64 2c 30 2c 30 29 20 29 7b fsync(fd,0,0) ){
311c0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 75 6e . rc = un
311d0 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c 49 54 ixLogError(SQLIT
311e0 45 5f 49 4f 45 52 52 5f 44 49 52 5f 46 53 59 4e E_IOERR_DIR_FSYN
311f0 43 2c 20 22 66 73 79 6e 63 22 2c 20 7a 50 61 74 C, "fsync", zPat
31200 68 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 h);. }.
31210 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 30 robust_close(0
31220 2c 20 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b , fd, __LINE__);
31230 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
31240 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 assert( rc==SQ
31250 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 29 3b LITE_CANTOPEN );
31260 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
31270 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d TE_OK;. }. }
31280 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e .#endif. return
31290 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 65 rc;.}../*.** Te
312a0 73 74 20 74 68 65 20 65 78 69 73 74 65 6e 63 65 st the existence
312b0 20 6f 66 20 6f 72 20 61 63 63 65 73 73 20 70 65 of or access pe
312c0 72 6d 69 73 73 69 6f 6e 73 20 6f 66 20 66 69 6c rmissions of fil
312d0 65 20 7a 50 61 74 68 2e 20 54 68 65 0a 2a 2a 20 e zPath. The.**
312e0 74 65 73 74 20 70 65 72 66 6f 72 6d 65 64 20 64 test performed d
312f0 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 76 61 epends on the va
31300 6c 75 65 20 6f 66 20 66 6c 61 67 73 3a 0a 2a 2a lue of flags:.**
31310 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 41 .** SQLITE_A
31320 43 43 45 53 53 5f 45 58 49 53 54 53 3a 20 52 65 CCESS_EXISTS: Re
31330 74 75 72 6e 20 31 20 69 66 20 74 68 65 20 66 69 turn 1 if the fi
31340 6c 65 20 65 78 69 73 74 73 0a 2a 2a 20 20 20 20 le exists.**
31350 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 52 SQLITE_ACCESS_R
31360 45 41 44 57 52 49 54 45 3a 20 52 65 74 75 72 6e EADWRITE: Return
31370 20 31 20 69 66 20 74 68 65 20 66 69 6c 65 20 69 1 if the file i
31380 73 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 61 s read and writa
31390 62 6c 65 2e 0a 2a 2a 20 20 20 20 20 53 51 4c 49 ble..** SQLI
313a0 54 45 5f 41 43 43 45 53 53 5f 52 45 41 44 4f 4e TE_ACCESS_READON
313b0 4c 59 3a 20 52 65 74 75 72 6e 20 31 20 69 66 20 LY: Return 1 if
313c0 74 68 65 20 66 69 6c 65 20 69 73 20 72 65 61 64 the file is read
313d0 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 able..**.** Othe
313e0 72 77 69 73 65 20 72 65 74 75 72 6e 20 30 2e 0a rwise return 0..
313f0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
31400 69 78 41 63 63 65 73 73 28 0a 20 20 73 71 6c 69 ixAccess(. sqli
31410 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 te3_vfs *NotUsed
31420 2c 20 20 20 2f 2a 20 54 68 65 20 56 46 53 20 63 , /* The VFS c
31430 6f 6e 74 61 69 6e 69 6e 67 20 74 68 69 73 20 78 ontaining this x
31440 41 63 63 65 73 73 20 6d 65 74 68 6f 64 20 2a 2f Access method */
31450 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
31460 50 61 74 68 2c 20 20 20 20 20 20 2f 2a 20 50 61 Path, /* Pa
31470 74 68 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 th of the file t
31480 6f 20 65 78 61 6d 69 6e 65 20 2a 2f 0a 20 20 69 o examine */. i
31490 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 nt flags,
314a0 20 20 20 20 20 20 20 2f 2a 20 57 68 61 74 20 64 /* What d
314b0 6f 20 77 65 20 77 61 6e 74 20 74 6f 20 6c 65 61 o we want to lea
314c0 72 6e 20 61 62 6f 75 74 20 74 68 65 20 7a 50 61 rn about the zPa
314d0 74 68 20 66 69 6c 65 3f 20 2a 2f 0a 20 20 69 6e th file? */. in
314e0 74 20 2a 70 52 65 73 4f 75 74 20 20 20 20 20 20 t *pResOut
314f0 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 72 /* Write r
31500 65 73 75 6c 74 20 62 6f 6f 6c 65 61 6e 20 68 65 esult boolean he
31510 72 65 20 2a 2f 0a 29 7b 0a 20 20 55 4e 55 53 45 re */.){. UNUSE
31520 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 D_PARAMETER(NotU
31530 73 65 64 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 sed);. Simulate
31540 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 IOError( return
31550 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 41 43 43 SQLITE_IOERR_ACC
31560 45 53 53 3b 20 29 3b 0a 20 20 61 73 73 65 72 74 ESS; );. assert
31570 28 20 70 52 65 73 4f 75 74 21 3d 30 20 29 3b 0a ( pResOut!=0 );.
31580 0a 20 20 2f 2a 20 54 68 65 20 73 70 65 63 20 73 . /* The spec s
31590 61 79 73 20 74 68 65 72 65 20 61 72 65 20 74 68 ays there are th
315a0 72 65 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c ree possible val
315b0 75 65 73 20 66 6f 72 20 66 6c 61 67 73 2e 20 20 ues for flags.
315c0 42 75 74 20 6f 6e 6c 79 0a 20 20 2a 2a 20 74 77 But only. ** tw
315d0 6f 20 6f 66 20 74 68 65 6d 20 61 72 65 20 61 63 o of them are ac
315e0 74 75 61 6c 6c 79 20 75 73 65 64 20 2a 2f 0a 20 tually used */.
315f0 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 3d 3d assert( flags==
31600 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 SQLITE_ACCESS_EX
31610 49 53 54 53 20 7c 7c 20 66 6c 61 67 73 3d 3d 53 ISTS || flags==S
31620 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 52 45 41 QLITE_ACCESS_REA
31630 44 57 52 49 54 45 20 29 3b 0a 0a 20 20 69 66 28 DWRITE );.. if(
31640 20 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41 flags==SQLITE_A
31650 43 43 45 53 53 5f 45 58 49 53 54 53 20 29 7b 0a CCESS_EXISTS ){.
31660 20 20 20 20 73 74 72 75 63 74 20 73 74 61 74 20 struct stat
31670 62 75 66 3b 0a 20 20 20 20 2a 70 52 65 73 4f 75 buf;. *pResOu
31680 74 20 3d 20 28 30 3d 3d 6f 73 53 74 61 74 28 7a t = (0==osStat(z
31690 50 61 74 68 2c 20 26 62 75 66 29 20 26 26 20 62 Path, &buf) && b
316a0 75 66 2e 73 74 5f 73 69 7a 65 3e 30 29 3b 0a 20 uf.st_size>0);.
316b0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 52 65 }else{. *pRe
316c0 73 4f 75 74 20 3d 20 6f 73 41 63 63 65 73 73 28 sOut = osAccess(
316d0 7a 50 61 74 68 2c 20 57 5f 4f 4b 7c 52 5f 4f 4b zPath, W_OK|R_OK
316e0 29 3d 3d 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 )==0;. }. retu
316f0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
31700 0a 2f 2a 0a 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 ./*.**.*/.static
31710 20 69 6e 74 20 6d 6b 46 75 6c 6c 50 61 74 68 6e int mkFullPathn
31720 61 6d 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 ame(. const cha
31730 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 20 20 20 r *zPath,
31740 20 20 20 20 20 20 20 2f 2a 20 49 6e 70 75 74 20 /* Input
31750 70 61 74 68 20 2a 2f 0a 20 20 63 68 61 72 20 2a path */. char *
31760 7a 4f 75 74 2c 20 20 20 20 20 20 20 20 20 20 20 zOut,
31770 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75 74 /* Out
31780 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 put buffer */.
31790 69 6e 74 20 6e 4f 75 74 20 20 20 20 20 20 20 20 int nOut
317a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
317b0 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 69 7a /* Allocated siz
317c0 65 20 6f 66 20 62 75 66 66 65 72 20 7a 4f 75 74 e of buffer zOut
317d0 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 50 61 */.){. int nPa
317e0 74 68 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c th = sqlite3Strl
317f0 65 6e 33 30 28 7a 50 61 74 68 29 3b 0a 20 20 69 en30(zPath);. i
31800 6e 74 20 69 4f 66 66 20 3d 20 30 3b 0a 20 20 69 nt iOff = 0;. i
31810 66 28 20 7a 50 61 74 68 5b 30 5d 21 3d 27 2f 27 f( zPath[0]!='/'
31820 20 29 7b 0a 20 20 20 20 69 66 28 20 6f 73 47 65 ){. if( osGe
31830 74 63 77 64 28 7a 4f 75 74 2c 20 6e 4f 75 74 2d tcwd(zOut, nOut-
31840 32 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 2)==0 ){. r
31850 65 74 75 72 6e 20 75 6e 69 78 4c 6f 67 45 72 72 eturn unixLogErr
31860 6f 72 28 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 or(SQLITE_CANTOP
31870 45 4e 5f 42 4b 50 54 2c 20 22 67 65 74 63 77 64 EN_BKPT, "getcwd
31880 22 2c 20 7a 50 61 74 68 29 3b 0a 20 20 20 20 7d ", zPath);. }
31890 0a 20 20 20 20 69 4f 66 66 20 3d 20 73 71 6c 69 . iOff = sqli
318a0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4f 75 74 te3Strlen30(zOut
318b0 29 3b 0a 20 20 20 20 7a 4f 75 74 5b 69 4f 66 66 );. zOut[iOff
318c0 2b 2b 5d 20 3d 20 27 2f 27 3b 0a 20 20 7d 0a 20 ++] = '/';. }.
318d0 20 69 66 28 20 28 69 4f 66 66 2b 6e 50 61 74 68 if( (iOff+nPath
318e0 2b 31 29 3e 6e 4f 75 74 20 29 7b 0a 20 20 20 20 +1)>nOut ){.
318f0 2f 2a 20 53 51 4c 69 74 65 20 61 73 73 75 6d 65 /* SQLite assume
31900 73 20 74 68 61 74 20 78 46 75 6c 6c 50 61 74 68 s that xFullPath
31910 6e 61 6d 65 28 29 20 6e 75 6c 2d 74 65 72 6d 69 name() nul-termi
31920 6e 61 74 65 73 20 74 68 65 20 6f 75 74 70 75 74 nates the output
31930 20 62 75 66 66 65 72 0a 20 20 20 20 2a 2a 20 65 buffer. ** e
31940 76 65 6e 20 69 66 20 69 74 20 72 65 74 75 72 6e ven if it return
31950 73 20 61 6e 20 65 72 72 6f 72 2e 20 20 2a 2f 0a s an error. */.
31960 20 20 20 20 7a 4f 75 74 5b 69 4f 66 66 5d 20 3d zOut[iOff] =
31970 20 27 5c 30 27 3b 0a 20 20 20 20 72 65 74 75 72 '\0';. retur
31980 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 n SQLITE_CANTOPE
31990 4e 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 N_BKPT;. }. sq
319a0 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e lite3_snprintf(n
319b0 4f 75 74 2d 69 4f 66 66 2c 20 26 7a 4f 75 74 5b Out-iOff, &zOut[
319c0 69 4f 66 66 5d 2c 20 22 25 73 22 2c 20 7a 50 61 iOff], "%s", zPa
319d0 74 68 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 th);. return SQ
319e0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
319f0 2a 20 54 75 72 6e 20 61 20 72 65 6c 61 74 69 76 * Turn a relativ
31a00 65 20 70 61 74 68 6e 61 6d 65 20 69 6e 74 6f 20 e pathname into
31a10 61 20 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 2e a full pathname.
31a20 20 54 68 65 20 72 65 6c 61 74 69 76 65 20 70 61 The relative pa
31a30 74 68 0a 2a 2a 20 69 73 20 73 74 6f 72 65 64 20 th.** is stored
31a40 61 73 20 61 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 as a nul-termina
31a50 74 65 64 20 73 74 72 69 6e 67 20 69 6e 20 74 68 ted string in th
31a60 65 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 64 e buffer pointed
31a70 20 74 6f 20 62 79 0a 2a 2a 20 7a 50 61 74 68 2e to by.** zPath.
31a80 20 0a 2a 2a 0a 2a 2a 20 7a 4f 75 74 20 70 6f 69 .**.** zOut poi
31a90 6e 74 73 20 74 6f 20 61 20 62 75 66 66 65 72 20 nts to a buffer
31aa0 6f 66 20 61 74 20 6c 65 61 73 74 20 73 71 6c 69 of at least sqli
31ab0 74 65 33 5f 76 66 73 2e 6d 78 50 61 74 68 6e 61 te3_vfs.mxPathna
31ac0 6d 65 20 62 79 74 65 73 20 0a 2a 2a 20 28 69 6e me bytes .** (in
31ad0 20 74 68 69 73 20 63 61 73 65 2c 20 4d 41 58 5f this case, MAX_
31ae0 50 41 54 48 4e 41 4d 45 20 62 79 74 65 73 29 2e PATHNAME bytes).
31af0 20 54 68 65 20 66 75 6c 6c 2d 70 61 74 68 20 69 The full-path i
31b00 73 20 77 72 69 74 74 65 6e 20 74 6f 0a 2a 2a 20 s written to.**
31b10 74 68 69 73 20 62 75 66 66 65 72 20 62 65 66 6f this buffer befo
31b20 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f re returning..*/
31b30 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 .static int unix
31b40 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 0a 20 20 FullPathname(.
31b50 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 sqlite3_vfs *pVf
31b60 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a s, /*
31b70 20 50 6f 69 6e 74 65 72 20 74 6f 20 76 66 73 20 Pointer to vfs
31b80 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 63 6f 6e 73 object */. cons
31b90 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 t char *zPath,
31ba0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 73 /* Pos
31bb0 73 69 62 6c 79 20 72 65 6c 61 74 69 76 65 20 69 sibly relative i
31bc0 6e 70 75 74 20 70 61 74 68 20 2a 2f 0a 20 20 69 nput path */. i
31bd0 6e 74 20 6e 4f 75 74 2c 20 20 20 20 20 20 20 20 nt nOut,
31be0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
31bf0 53 69 7a 65 20 6f 66 20 6f 75 74 70 75 74 20 62 Size of output b
31c00 75 66 66 65 72 20 69 6e 20 62 79 74 65 73 20 2a uffer in bytes *
31c10 2f 0a 20 20 63 68 61 72 20 2a 7a 4f 75 74 20 20 /. char *zOut
31c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31c30 20 20 2f 2a 20 4f 75 74 70 75 74 20 62 75 66 66 /* Output buff
31c40 65 72 20 2a 2f 0a 29 7b 0a 23 69 66 20 21 64 65 er */.){.#if !de
31c50 66 69 6e 65 64 28 48 41 56 45 5f 52 45 41 44 4c fined(HAVE_READL
31c60 49 4e 4b 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 INK) || !defined
31c70 28 48 41 56 45 5f 4c 53 54 41 54 29 0a 20 20 72 (HAVE_LSTAT). r
31c80 65 74 75 72 6e 20 6d 6b 46 75 6c 6c 50 61 74 68 eturn mkFullPath
31c90 6e 61 6d 65 28 7a 50 61 74 68 2c 20 7a 4f 75 74 name(zPath, zOut
31ca0 2c 20 6e 4f 75 74 29 3b 0a 23 65 6c 73 65 0a 20 , nOut);.#else.
31cb0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
31cc0 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e 42 79 74 65 _OK;. int nByte
31cd0 3b 0a 20 20 69 6e 74 20 6e 4c 69 6e 6b 20 3d 20 ;. int nLink =
31ce0 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1;
31cf0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 /* Number of s
31d00 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b 73 20 66 6f ymbolic links fo
31d10 6c 6c 6f 77 65 64 20 73 6f 20 66 61 72 20 2a 2f llowed so far */
31d20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
31d30 49 6e 20 3d 20 7a 50 61 74 68 3b 20 20 20 20 20 In = zPath;
31d40 20 2f 2a 20 49 6e 70 75 74 20 70 61 74 68 20 66 /* Input path f
31d50 6f 72 20 65 61 63 68 20 69 74 65 72 61 74 69 6f or each iteratio
31d60 6e 20 6f 66 20 6c 6f 6f 70 20 2a 2f 0a 20 20 63 n of loop */. c
31d70 68 61 72 20 2a 7a 44 65 6c 20 3d 20 30 3b 0a 0a har *zDel = 0;..
31d80 20 20 61 73 73 65 72 74 28 20 70 56 66 73 2d 3e assert( pVfs->
31d90 6d 78 50 61 74 68 6e 61 6d 65 3d 3d 4d 41 58 5f mxPathname==MAX_
31da0 50 41 54 48 4e 41 4d 45 20 29 3b 0a 20 20 55 4e PATHNAME );. UN
31db0 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 70 USED_PARAMETER(p
31dc0 56 66 73 29 3b 0a 0a 20 20 2f 2a 20 49 74 27 73 Vfs);.. /* It's
31dd0 20 6f 64 64 20 74 6f 20 73 69 6d 75 6c 61 74 65 odd to simulate
31de0 20 61 6e 20 69 6f 2d 65 72 72 6f 72 20 68 65 72 an io-error her
31df0 65 2c 20 62 75 74 20 72 65 61 6c 6c 79 20 74 68 e, but really th
31e00 69 73 20 69 73 20 6a 75 73 74 0a 20 20 2a 2a 20 is is just. **
31e10 75 73 69 6e 67 20 74 68 65 20 69 6f 2d 65 72 72 using the io-err
31e20 6f 72 20 69 6e 66 72 61 73 74 72 75 63 74 75 72 or infrastructur
31e30 65 20 74 6f 20 74 65 73 74 20 74 68 61 74 20 53 e to test that S
31e40 51 4c 69 74 65 20 68 61 6e 64 6c 65 73 20 74 68 QLite handles th
31e50 69 73 0a 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e is. ** function
31e60 20 66 61 69 6c 69 6e 67 2e 20 54 68 69 73 20 66 failing. This f
31e70 75 6e 63 74 69 6f 6e 20 63 6f 75 6c 64 20 66 61 unction could fa
31e80 69 6c 20 69 66 2c 20 66 6f 72 20 65 78 61 6d 70 il if, for examp
31e90 6c 65 2c 20 74 68 65 0a 20 20 2a 2a 20 63 75 72 le, the. ** cur
31ea0 72 65 6e 74 20 77 6f 72 6b 69 6e 67 20 64 69 72 rent working dir
31eb0 65 63 74 6f 72 79 20 68 61 73 20 62 65 65 6e 20 ectory has been
31ec0 75 6e 6c 69 6e 6b 65 64 2e 0a 20 20 2a 2f 0a 20 unlinked.. */.
31ed0 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 SimulateIOError
31ee0 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ( return SQLITE_
31ef0 45 52 52 4f 52 20 29 3b 0a 0a 20 20 64 6f 20 7b ERROR );.. do {
31f00 0a 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 73 74 .. /* Call st
31f10 61 74 28 29 20 6f 6e 20 70 61 74 68 20 7a 49 6e at() on path zIn
31f20 2e 20 53 65 74 20 62 4c 69 6e 6b 20 74 6f 20 74 . Set bLink to t
31f30 72 75 65 20 69 66 20 74 68 65 20 70 61 74 68 20 rue if the path
31f40 69 73 20 61 20 73 79 6d 62 6f 6c 69 63 0a 20 20 is a symbolic.
31f50 20 20 2a 2a 20 6c 69 6e 6b 2c 20 6f 72 20 66 61 ** link, or fa
31f60 6c 73 65 20 6f 74 68 65 72 77 69 73 65 2e 20 20 lse otherwise.
31f70 2a 2f 0a 20 20 20 20 69 6e 74 20 62 4c 69 6e 6b */. int bLink
31f80 20 3d 20 30 3b 0a 20 20 20 20 73 74 72 75 63 74 = 0;. struct
31f90 20 73 74 61 74 20 62 75 66 3b 0a 20 20 20 20 69 stat buf;. i
31fa0 66 28 20 6f 73 4c 73 74 61 74 28 7a 49 6e 2c 20 f( osLstat(zIn,
31fb0 26 62 75 66 29 21 3d 30 20 29 7b 0a 20 20 20 20 &buf)!=0 ){.
31fc0 20 20 69 66 28 20 65 72 72 6e 6f 21 3d 45 4e 4f if( errno!=ENO
31fd0 45 4e 54 20 29 7b 0a 20 20 20 20 20 20 20 20 72 ENT ){. r
31fe0 63 20 3d 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 c = unixLogError
31ff0 28 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e (SQLITE_CANTOPEN
32000 5f 42 4b 50 54 2c 20 22 6c 73 74 61 74 22 2c 20 _BKPT, "lstat",
32010 7a 49 6e 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 zIn);. }.
32020 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 62 }else{. b
32030 4c 69 6e 6b 20 3d 20 53 5f 49 53 4c 4e 4b 28 62 Link = S_ISLNK(b
32040 75 66 2e 73 74 5f 6d 6f 64 65 29 3b 0a 20 20 20 uf.st_mode);.
32050 20 7d 0a 0a 20 20 20 20 69 66 28 20 62 4c 69 6e }.. if( bLin
32060 6b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 7a k ){. if( z
32070 44 65 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 Del==0 ){.
32080 20 20 7a 44 65 6c 20 3d 20 73 71 6c 69 74 65 33 zDel = sqlite3
32090 5f 6d 61 6c 6c 6f 63 28 6e 4f 75 74 29 3b 0a 20 _malloc(nOut);.
320a0 20 20 20 20 20 20 20 69 66 28 20 7a 44 65 6c 3d if( zDel=
320b0 3d 30 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 =0 ) rc = SQLITE
320c0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
320d0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 2b 2b 6e }else if( ++n
320e0 4c 69 6e 6b 3e 53 51 4c 49 54 45 5f 4d 41 58 5f Link>SQLITE_MAX_
320f0 53 59 4d 4c 49 4e 4b 53 20 29 7b 0a 20 20 20 20 SYMLINKS ){.
32100 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
32110 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 3b 0a 20 CANTOPEN_BKPT;.
32120 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 }.. if
32130 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
32140 29 7b 0a 20 20 20 20 20 20 20 20 6e 42 79 74 65 ){. nByte
32150 20 3d 20 6f 73 52 65 61 64 6c 69 6e 6b 28 7a 49 = osReadlink(zI
32160 6e 2c 20 7a 44 65 6c 2c 20 6e 4f 75 74 2d 31 29 n, zDel, nOut-1)
32170 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 42 ;. if( nB
32180 79 74 65 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 yte<0 ){.
32190 20 20 20 72 63 20 3d 20 75 6e 69 78 4c 6f 67 45 rc = unixLogE
321a0 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 41 4e 54 rror(SQLITE_CANT
321b0 4f 50 45 4e 5f 42 4b 50 54 2c 20 22 72 65 61 64 OPEN_BKPT, "read
321c0 6c 69 6e 6b 22 2c 20 7a 49 6e 29 3b 0a 20 20 20 link", zIn);.
321d0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
321e0 20 20 20 20 20 20 69 66 28 20 7a 44 65 6c 5b 30 if( zDel[0
321f0 5d 21 3d 27 2f 27 20 29 7b 0a 20 20 20 20 20 20 ]!='/' ){.
32200 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a 20 20 20 int n;.
32210 20 20 20 20 20 20 20 20 20 66 6f 72 28 6e 20 3d for(n =
32220 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
32230 28 7a 49 6e 29 3b 20 6e 3e 30 20 26 26 20 7a 49 (zIn); n>0 && zI
32240 6e 5b 6e 2d 31 5d 21 3d 27 2f 27 3b 20 6e 2d 2d n[n-1]!='/'; n--
32250 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
32260 66 28 20 6e 42 79 74 65 2b 6e 2b 31 3e 6e 4f 75 f( nByte+n+1>nOu
32270 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
32280 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
32290 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 3b 0a 20 20 ANTOPEN_BKPT;.
322a0 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }else{
322b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d . m
322c0 65 6d 6d 6f 76 65 28 26 7a 44 65 6c 5b 6e 5d 2c emmove(&zDel[n],
322d0 20 7a 44 65 6c 2c 20 6e 42 79 74 65 2b 31 29 3b zDel, nByte+1);
322e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d . m
322f0 65 6d 63 70 79 28 7a 44 65 6c 2c 20 7a 49 6e 2c emcpy(zDel, zIn,
32300 20 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 n);.
32310 20 20 20 6e 42 79 74 65 20 2b 3d 20 6e 3b 0a 20 nByte += n;.
32320 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
32330 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
32340 20 20 20 7a 44 65 6c 5b 6e 42 79 74 65 5d 20 3d zDel[nByte] =
32350 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 7d '\0';. }
32360 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
32370 7a 49 6e 20 3d 20 7a 44 65 6c 3b 0a 20 20 20 20 zIn = zDel;.
32380 7d 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 }.. assert( r
32390 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c!=SQLITE_OK ||
323a0 7a 49 6e 21 3d 7a 4f 75 74 20 7c 7c 20 7a 49 6e zIn!=zOut || zIn
323b0 5b 30 5d 3d 3d 27 2f 27 20 29 3b 0a 20 20 20 20 [0]=='/' );.
323c0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
323d0 4b 20 26 26 20 7a 49 6e 21 3d 7a 4f 75 74 20 29 K && zIn!=zOut )
323e0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6b 46 {. rc = mkF
323f0 75 6c 6c 50 61 74 68 6e 61 6d 65 28 7a 49 6e 2c ullPathname(zIn,
32400 20 7a 4f 75 74 2c 20 6e 4f 75 74 29 3b 0a 20 20 zOut, nOut);.
32410 20 20 7d 0a 20 20 20 20 69 66 28 20 62 4c 69 6e }. if( bLin
32420 6b 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 k==0 ) break;.
32430 20 20 7a 49 6e 20 3d 20 7a 4f 75 74 3b 0a 20 20 zIn = zOut;.
32440 7d 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 }while( rc==SQLI
32450 54 45 5f 4f 4b 20 29 3b 0a 0a 20 20 73 71 6c 69 TE_OK );.. sqli
32460 74 65 33 5f 66 72 65 65 28 7a 44 65 6c 29 3b 0a te3_free(zDel);.
32470 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e return rc;.#en
32480 64 69 66 20 20 20 2f 2a 20 48 41 56 45 5f 52 45 dif /* HAVE_RE
32490 41 44 4c 49 4e 4b 20 26 26 20 48 41 56 45 5f 4c ADLINK && HAVE_L
324a0 53 54 41 54 20 2a 2f 0a 7d 0a 0a 0a 23 69 66 6e STAT */.}...#ifn
324b0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
324c0 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e 0a 2f LOAD_EXTENSION./
324d0 2a 0a 2a 2a 20 49 6e 74 65 72 66 61 63 65 73 20 *.** Interfaces
324e0 66 6f 72 20 6f 70 65 6e 69 6e 67 20 61 20 73 68 for opening a sh
324f0 61 72 65 64 20 6c 69 62 72 61 72 79 2c 20 66 69 ared library, fi
32500 6e 64 69 6e 67 20 65 6e 74 72 79 20 70 6f 69 6e nding entry poin
32510 74 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 ts.** within the
32520 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 2c shared library,
32530 20 61 6e 64 20 63 6c 6f 73 69 6e 67 20 74 68 65 and closing the
32540 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 2e shared library.
32550 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c 64 6c .*/.#include <dl
32560 66 63 6e 2e 68 3e 0a 73 74 61 74 69 63 20 76 6f fcn.h>.static vo
32570 69 64 20 2a 75 6e 69 78 44 6c 4f 70 65 6e 28 73 id *unixDlOpen(s
32580 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 qlite3_vfs *NotU
32590 73 65 64 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 sed, const char
325a0 2a 7a 46 69 6c 65 6e 61 6d 65 29 7b 0a 20 20 55 *zFilename){. U
325b0 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
325c0 4e 6f 74 55 73 65 64 29 3b 0a 20 20 72 65 74 75 NotUsed);. retu
325d0 72 6e 20 64 6c 6f 70 65 6e 28 7a 46 69 6c 65 6e rn dlopen(zFilen
325e0 61 6d 65 2c 20 52 54 4c 44 5f 4e 4f 57 20 7c 20 ame, RTLD_NOW |
325f0 52 54 4c 44 5f 47 4c 4f 42 41 4c 29 3b 0a 7d 0a RTLD_GLOBAL);.}.
32600 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 63 61 ./*.** SQLite ca
32610 6c 6c 73 20 74 68 69 73 20 66 75 6e 63 74 69 6f lls this functio
32620 6e 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 n immediately af
32630 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 75 6e ter a call to un
32640 69 78 44 6c 53 79 6d 28 29 20 6f 72 0a 2a 2a 20 ixDlSym() or.**
32650 75 6e 69 78 44 6c 4f 70 65 6e 28 29 20 66 61 69 unixDlOpen() fai
32660 6c 73 20 28 72 65 74 75 72 6e 73 20 61 20 6e 75 ls (returns a nu
32670 6c 6c 20 70 6f 69 6e 74 65 72 29 2e 20 49 66 20 ll pointer). If
32680 61 20 6d 6f 72 65 20 64 65 74 61 69 6c 65 64 20 a more detailed
32690 65 72 72 6f 72 0a 2a 2a 20 6d 65 73 73 61 67 65 error.** message
326a0 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 69 is available, i
326b0 74 20 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 t is written to
326c0 7a 42 75 66 4f 75 74 2e 20 49 66 20 6e 6f 20 65 zBufOut. If no e
326d0 72 72 6f 72 20 6d 65 73 73 61 67 65 0a 2a 2a 20 rror message.**
326e0 69 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 7a 42 is available, zB
326f0 75 66 4f 75 74 20 69 73 20 6c 65 66 74 20 75 6e ufOut is left un
32700 6d 6f 64 69 66 69 65 64 20 61 6e 64 20 53 51 4c modified and SQL
32710 69 74 65 20 75 73 65 73 20 61 20 64 65 66 61 75 ite uses a defau
32720 6c 74 0a 2a 2a 20 65 72 72 6f 72 20 6d 65 73 73 lt.** error mess
32730 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 age..*/.static v
32740 6f 69 64 20 75 6e 69 78 44 6c 45 72 72 6f 72 28 oid unixDlError(
32750 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74 sqlite3_vfs *Not
32760 55 73 65 64 2c 20 69 6e 74 20 6e 42 75 66 2c 20 Used, int nBuf,
32770 63 68 61 72 20 2a 7a 42 75 66 4f 75 74 29 7b 0a char *zBufOut){.
32780 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 const char *zE
32790 72 72 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 rr;. UNUSED_PAR
327a0 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b AMETER(NotUsed);
327b0 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 . unixEnterMute
327c0 78 28 29 3b 0a 20 20 7a 45 72 72 20 3d 20 64 6c x();. zErr = dl
327d0 65 72 72 6f 72 28 29 3b 0a 20 20 69 66 28 20 7a error();. if( z
327e0 45 72 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 Err ){. sqlit
327f0 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e 42 75 66 e3_snprintf(nBuf
32800 2c 20 7a 42 75 66 4f 75 74 2c 20 22 25 73 22 2c , zBufOut, "%s",
32810 20 7a 45 72 72 29 3b 0a 20 20 7d 0a 20 20 75 6e zErr);. }. un
32820 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a ixLeaveMutex();.
32830 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 28 2a }.static void (*
32840 75 6e 69 78 44 6c 53 79 6d 28 73 71 6c 69 74 65 unixDlSym(sqlite
32850 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 3_vfs *NotUsed,
32860 76 6f 69 64 20 2a 70 2c 20 63 6f 6e 73 74 20 63 void *p, const c
32870 68 61 72 2a 7a 53 79 6d 29 29 28 76 6f 69 64 29 har*zSym))(void)
32880 7b 0a 20 20 2f 2a 20 0a 20 20 2a 2a 20 47 43 43 {. /* . ** GCC
32890 20 77 69 74 68 20 2d 70 65 64 61 6e 74 69 63 2d with -pedantic-
328a0 65 72 72 6f 72 73 20 73 61 79 73 20 74 68 61 74 errors says that
328b0 20 43 39 30 20 64 6f 65 73 20 6e 6f 74 20 61 6c C90 does not al
328c0 6c 6f 77 20 61 20 76 6f 69 64 2a 20 74 6f 20 62 low a void* to b
328d0 65 0a 20 20 2a 2a 20 63 61 73 74 20 69 6e 74 6f e. ** cast into
328e0 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
328f0 66 75 6e 63 74 69 6f 6e 2e 20 20 41 6e 64 20 79 function. And y
32900 65 74 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 et the library d
32910 6c 73 79 6d 28 29 20 72 6f 75 74 69 6e 65 0a 20 lsym() routine.
32920 20 2a 2a 20 72 65 74 75 72 6e 73 20 61 20 76 6f ** returns a vo
32930 69 64 2a 20 77 68 69 63 68 20 69 73 20 72 65 61 id* which is rea
32940 6c 6c 79 20 61 20 70 6f 69 6e 74 65 72 20 74 6f lly a pointer to
32950 20 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 53 6f a function. So
32960 20 68 6f 77 20 64 6f 20 77 65 0a 20 20 2a 2a 20 how do we. **
32970 75 73 65 20 64 6c 73 79 6d 28 29 20 77 69 74 68 use dlsym() with
32980 20 2d 70 65 64 61 6e 74 69 63 2d 65 72 72 6f 72 -pedantic-error
32990 73 3f 0a 20 20 2a 2a 0a 20 20 2a 2a 20 56 61 72 s?. **. ** Var
329a0 69 61 62 6c 65 20 78 20 62 65 6c 6f 77 20 69 73 iable x below is
329b0 20 64 65 66 69 6e 65 64 20 74 6f 20 62 65 20 61 defined to be a
329c0 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 75 pointer to a fu
329d0 6e 63 74 69 6f 6e 20 74 61 6b 69 6e 67 0a 20 20 nction taking.
329e0 2a 2a 20 70 61 72 61 6d 65 74 65 72 73 20 76 6f ** parameters vo
329f0 69 64 2a 20 61 6e 64 20 63 6f 6e 73 74 20 63 68 id* and const ch
32a00 61 72 2a 20 61 6e 64 20 72 65 74 75 72 6e 69 6e ar* and returnin
32a10 67 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 g a pointer to a
32a20 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 function.. **
32a30 57 65 20 69 6e 69 74 69 61 6c 69 7a 65 20 78 20 We initialize x
32a40 62 79 20 61 73 73 69 67 6e 69 6e 67 20 69 74 20 by assigning it
32a50 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
32a60 20 64 6c 73 79 6d 28 29 20 66 75 6e 63 74 69 6f dlsym() functio
32a70 6e 2e 0a 20 20 2a 2a 20 28 54 68 61 74 20 61 73 n.. ** (That as
32a80 73 69 67 6e 6d 65 6e 74 20 72 65 71 75 69 72 65 signment require
32a90 73 20 61 20 63 61 73 74 2e 29 20 20 54 68 65 6e s a cast.) Then
32aa0 20 77 65 20 63 61 6c 6c 20 74 68 65 20 66 75 6e we call the fun
32ab0 63 74 69 6f 6e 20 74 68 61 74 0a 20 20 2a 2a 20 ction that. **
32ac0 78 20 70 6f 69 6e 74 73 20 74 6f 2e 20 20 0a 20 x points to. .
32ad0 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 20 77 6f **. ** This wo
32ae0 72 6b 2d 61 72 6f 75 6e 64 20 69 73 20 75 6e 6c rk-around is unl
32af0 69 6b 65 6c 79 20 74 6f 20 77 6f 72 6b 20 63 6f ikely to work co
32b00 72 72 65 63 74 6c 79 20 6f 6e 20 61 6e 79 20 73 rrectly on any s
32b10 79 73 74 65 6d 20 77 68 65 72 65 0a 20 20 2a 2a ystem where. **
32b20 20 79 6f 75 20 72 65 61 6c 6c 79 20 63 61 6e 6e you really cann
32b30 6f 74 20 63 61 73 74 20 61 20 66 75 6e 63 74 69 ot cast a functi
32b40 6f 6e 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f 20 on pointer into
32b50 76 6f 69 64 2a 2e 20 20 42 75 74 20 74 68 65 6e void*. But then
32b60 2c 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 6f 74 , on the. ** ot
32b70 68 65 72 20 68 61 6e 64 2c 20 64 6c 73 79 6d 28 her hand, dlsym(
32b80 29 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 ) will not work
32b90 6f 6e 20 73 75 63 68 20 61 20 73 79 73 74 65 6d on such a system
32ba0 20 65 69 74 68 65 72 2c 20 73 6f 20 77 65 20 68 either, so we h
32bb0 61 76 65 0a 20 20 2a 2a 20 6e 6f 74 20 72 65 61 ave. ** not rea
32bc0 6c 6c 79 20 6c 6f 73 74 20 61 6e 79 74 68 69 6e lly lost anythin
32bd0 67 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 g.. */. void (
32be0 2a 28 2a 78 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 *(*x)(void*,cons
32bf0 74 20 63 68 61 72 2a 29 29 28 76 6f 69 64 29 3b t char*))(void);
32c00 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
32c10 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 TER(NotUsed);.
32c20 78 20 3d 20 28 76 6f 69 64 28 2a 28 2a 29 28 76 x = (void(*(*)(v
32c30 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
32c40 29 29 28 76 6f 69 64 29 29 64 6c 73 79 6d 3b 0a ))(void))dlsym;.
32c50 20 20 72 65 74 75 72 6e 20 28 2a 78 29 28 70 2c return (*x)(p,
32c60 20 7a 53 79 6d 29 3b 0a 7d 0a 73 74 61 74 69 63 zSym);.}.static
32c70 20 76 6f 69 64 20 75 6e 69 78 44 6c 43 6c 6f 73 void unixDlClos
32c80 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e e(sqlite3_vfs *N
32c90 6f 74 55 73 65 64 2c 20 76 6f 69 64 20 2a 70 48 otUsed, void *pH
32ca0 61 6e 64 6c 65 29 7b 0a 20 20 55 4e 55 53 45 44 andle){. UNUSED
32cb0 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 _PARAMETER(NotUs
32cc0 65 64 29 3b 0a 20 20 64 6c 63 6c 6f 73 65 28 70 ed);. dlclose(p
32cd0 48 61 6e 64 6c 65 29 3b 0a 7d 0a 23 65 6c 73 65 Handle);.}.#else
32ce0 20 2f 2a 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d /* if SQLITE_OM
32cf0 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f IT_LOAD_EXTENSIO
32d00 4e 20 69 73 20 64 65 66 69 6e 65 64 3a 20 2a 2f N is defined: */
32d10 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44 . #define unixD
32d20 6c 4f 70 65 6e 20 20 30 0a 20 20 23 64 65 66 69 lOpen 0. #defi
32d30 6e 65 20 75 6e 69 78 44 6c 45 72 72 6f 72 20 30 ne unixDlError 0
32d40 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44 . #define unixD
32d50 6c 53 79 6d 20 20 20 30 0a 20 20 23 64 65 66 69 lSym 0. #defi
32d60 6e 65 20 75 6e 69 78 44 6c 43 6c 6f 73 65 20 30 ne unixDlClose 0
32d70 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 .#endif../*.** W
32d80 72 69 74 65 20 6e 42 75 66 20 62 79 74 65 73 20 rite nBuf bytes
32d90 6f 66 20 72 61 6e 64 6f 6d 20 64 61 74 61 20 74 of random data t
32da0 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 62 o the supplied b
32db0 75 66 66 65 72 20 7a 42 75 66 2e 0a 2a 2f 0a 73 uffer zBuf..*/.s
32dc0 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 52 61 tatic int unixRa
32dd0 6e 64 6f 6d 6e 65 73 73 28 73 71 6c 69 74 65 33 ndomness(sqlite3
32de0 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 69 _vfs *NotUsed, i
32df0 6e 74 20 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a nt nBuf, char *z
32e00 42 75 66 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 Buf){. UNUSED_P
32e10 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 ARAMETER(NotUsed
32e20 29 3b 0a 20 20 61 73 73 65 72 74 28 28 73 69 7a );. assert((siz
32e30 65 5f 74 29 6e 42 75 66 3e 3d 28 73 69 7a 65 6f e_t)nBuf>=(sizeo
32e40 66 28 74 69 6d 65 5f 74 29 2b 73 69 7a 65 6f 66 f(time_t)+sizeof
32e50 28 69 6e 74 29 29 29 3b 0a 0a 20 20 2f 2a 20 57 (int)));.. /* W
32e60 65 20 68 61 76 65 20 74 6f 20 69 6e 69 74 69 61 e have to initia
32e70 6c 69 7a 65 20 7a 42 75 66 20 74 6f 20 70 72 65 lize zBuf to pre
32e80 76 65 6e 74 20 76 61 6c 67 72 69 6e 64 20 66 72 vent valgrind fr
32e90 6f 6d 20 72 65 70 6f 72 74 69 6e 67 0a 20 20 2a om reporting. *
32ea0 2a 20 65 72 72 6f 72 73 2e 20 20 54 68 65 20 72 * errors. The r
32eb0 65 70 6f 72 74 73 20 69 73 73 75 65 64 20 62 79 eports issued by
32ec0 20 76 61 6c 67 72 69 6e 64 20 61 72 65 20 69 6e valgrind are in
32ed0 63 6f 72 72 65 63 74 20 2d 20 77 65 20 77 6f 75 correct - we wou
32ee0 6c 64 0a 20 20 2a 2a 20 70 72 65 66 65 72 20 74 ld. ** prefer t
32ef0 68 61 74 20 74 68 65 20 72 61 6e 64 6f 6d 6e 65 hat the randomne
32f00 73 73 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 ss be increased
32f10 62 79 20 6d 61 6b 69 6e 67 20 75 73 65 20 6f 66 by making use of
32f20 20 74 68 65 0a 20 20 2a 2a 20 75 6e 69 6e 69 74 the. ** uninit
32f30 69 61 6c 69 7a 65 64 20 73 70 61 63 65 20 69 6e ialized space in
32f40 20 7a 42 75 66 20 2d 20 62 75 74 20 76 61 6c 67 zBuf - but valg
32f50 72 69 6e 64 20 65 72 72 6f 72 73 20 74 65 6e 64 rind errors tend
32f60 20 74 6f 20 77 6f 72 72 79 0a 20 20 2a 2a 20 73 to worry. ** s
32f70 6f 6d 65 20 75 73 65 72 73 2e 20 20 52 61 74 68 ome users. Rath
32f80 65 72 20 74 68 61 6e 20 61 72 67 75 65 2c 20 69 er than argue, i
32f90 74 20 73 65 65 6d 73 20 65 61 73 69 65 72 20 6a t seems easier j
32fa0 75 73 74 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a ust to initializ
32fb0 65 0a 20 20 2a 2a 20 74 68 65 20 77 68 6f 6c 65 e. ** the whole
32fc0 20 61 72 72 61 79 20 61 6e 64 20 73 69 6c 65 6e array and silen
32fd0 63 65 20 76 61 6c 67 72 69 6e 64 2c 20 65 76 65 ce valgrind, eve
32fe0 6e 20 69 66 20 74 68 61 74 20 6d 65 61 6e 73 20 n if that means
32ff0 6c 65 73 73 20 72 61 6e 64 6f 6d 6e 65 73 73 0a less randomness.
33000 20 20 2a 2a 20 69 6e 20 74 68 65 20 72 61 6e 64 ** in the rand
33010 6f 6d 20 73 65 65 64 2e 0a 20 20 2a 2a 0a 20 20 om seed.. **.
33020 2a 2a 20 57 68 65 6e 20 74 65 73 74 69 6e 67 2c ** When testing,
33030 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 7a 42 initializing zB
33040 75 66 5b 5d 20 74 6f 20 7a 65 72 6f 20 69 73 20 uf[] to zero is
33050 61 6c 6c 20 77 65 20 64 6f 2e 20 20 54 68 61 74 all we do. That
33060 20 6d 65 61 6e 73 0a 20 20 2a 2a 20 74 68 61 74 means. ** that
33070 20 77 65 20 61 6c 77 61 79 73 20 75 73 65 20 74 we always use t
33080 68 65 20 73 61 6d 65 20 72 61 6e 64 6f 6d 20 6e he same random n
33090 75 6d 62 65 72 20 73 65 71 75 65 6e 63 65 2e 20 umber sequence.
330a0 20 54 68 69 73 20 6d 61 6b 65 73 20 74 68 65 0a This makes the.
330b0 20 20 2a 2a 20 74 65 73 74 73 20 72 65 70 65 61 ** tests repea
330c0 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 6d 65 table.. */. me
330d0 6d 73 65 74 28 7a 42 75 66 2c 20 30 2c 20 6e 42 mset(zBuf, 0, nB
330e0 75 66 29 3b 0a 20 20 72 61 6e 64 6f 6d 6e 65 73 uf);. randomnes
330f0 73 50 69 64 20 3d 20 6f 73 47 65 74 70 69 64 28 sPid = osGetpid(
33100 30 29 3b 20 20 0a 23 69 66 20 21 64 65 66 69 6e 0); .#if !defin
33110 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 ed(SQLITE_TEST)
33120 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
33130 54 45 5f 4f 4d 49 54 5f 52 41 4e 44 4f 4d 4e 45 TE_OMIT_RANDOMNE
33140 53 53 29 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 SS). {. int
33150 66 64 2c 20 67 6f 74 3b 0a 20 20 20 20 66 64 20 fd, got;. fd
33160 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 22 2f = robust_open("/
33170 64 65 76 2f 75 72 61 6e 64 6f 6d 22 2c 20 4f 5f dev/urandom", O_
33180 52 44 4f 4e 4c 59 2c 20 30 29 3b 0a 20 20 20 20 RDONLY, 0);.
33190 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 20 if( fd<0 ){.
331a0 20 20 74 69 6d 65 5f 74 20 74 3b 0a 20 20 20 20 time_t t;.
331b0 20 20 74 69 6d 65 28 26 74 29 3b 0a 20 20 20 20 time(&t);.
331c0 20 20 6d 65 6d 63 70 79 28 7a 42 75 66 2c 20 26 memcpy(zBuf, &
331d0 74 2c 20 73 69 7a 65 6f 66 28 74 29 29 3b 0a 20 t, sizeof(t));.
331e0 20 20 20 20 20 6d 65 6d 63 70 79 28 26 7a 42 75 memcpy(&zBu
331f0 66 5b 73 69 7a 65 6f 66 28 74 29 5d 2c 20 26 72 f[sizeof(t)], &r
33200 61 6e 64 6f 6d 6e 65 73 73 50 69 64 2c 20 73 69 andomnessPid, si
33210 7a 65 6f 66 28 72 61 6e 64 6f 6d 6e 65 73 73 50 zeof(randomnessP
33220 69 64 29 29 3b 0a 20 20 20 20 20 20 61 73 73 65 id));. asse
33230 72 74 28 20 73 69 7a 65 6f 66 28 74 29 2b 73 69 rt( sizeof(t)+si
33240 7a 65 6f 66 28 72 61 6e 64 6f 6d 6e 65 73 73 50 zeof(randomnessP
33250 69 64 29 3c 3d 28 73 69 7a 65 5f 74 29 6e 42 75 id)<=(size_t)nBu
33260 66 20 29 3b 0a 20 20 20 20 20 20 6e 42 75 66 20 f );. nBuf
33270 3d 20 73 69 7a 65 6f 66 28 74 29 20 2b 20 73 69 = sizeof(t) + si
33280 7a 65 6f 66 28 72 61 6e 64 6f 6d 6e 65 73 73 50 zeof(randomnessP
33290 69 64 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a id);. }else{.
332a0 20 20 20 20 20 20 64 6f 7b 20 67 6f 74 20 3d 20 do{ got =
332b0 6f 73 52 65 61 64 28 66 64 2c 20 7a 42 75 66 2c osRead(fd, zBuf,
332c0 20 6e 42 75 66 29 3b 20 7d 77 68 69 6c 65 28 20 nBuf); }while(
332d0 67 6f 74 3c 30 20 26 26 20 65 72 72 6e 6f 3d 3d got<0 && errno==
332e0 45 49 4e 54 52 20 29 3b 0a 20 20 20 20 20 20 72 EINTR );. r
332f0 6f 62 75 73 74 5f 63 6c 6f 73 65 28 30 2c 20 66 obust_close(0, f
33300 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 d, __LINE__);.
33310 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
33320 20 72 65 74 75 72 6e 20 6e 42 75 66 3b 0a 7d 0a return nBuf;.}.
33330 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f ../*.** Sleep fo
33340 72 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 r a little while
33350 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d . Return the am
33360 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 ount of time sle
33370 70 74 2e 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d pt..** The argum
33380 65 6e 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 ent is the numbe
33390 72 20 6f 66 20 6d 69 63 72 6f 73 65 63 6f 6e 64 r of microsecond
333a0 73 20 77 65 20 77 61 6e 74 20 74 6f 20 73 6c 65 s we want to sle
333b0 65 70 2e 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 ep..** The retur
333c0 6e 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 6e n value is the n
333d0 75 6d 62 65 72 20 6f 66 20 6d 69 63 72 6f 73 65 umber of microse
333e0 63 6f 6e 64 73 20 6f 66 20 73 6c 65 65 70 20 61 conds of sleep a
333f0 63 74 75 61 6c 6c 79 0a 2a 2a 20 72 65 71 75 65 ctually.** reque
33400 73 74 65 64 20 66 72 6f 6d 20 74 68 65 20 75 6e sted from the un
33410 64 65 72 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 derlying operati
33420 6e 67 20 73 79 73 74 65 6d 2c 20 61 20 6e 75 6d ng system, a num
33430 62 65 72 20 77 68 69 63 68 0a 2a 2a 20 6d 69 67 ber which.** mig
33440 68 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 ht be greater th
33450 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 74 an or equal to t
33460 68 65 20 61 72 67 75 6d 65 6e 74 2c 20 62 75 74 he argument, but
33470 20 6e 6f 74 20 6c 65 73 73 0a 2a 2a 20 74 68 61 not less.** tha
33480 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2e 0a n the argument..
33490 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e */.static int un
334a0 69 78 53 6c 65 65 70 28 73 71 6c 69 74 65 33 5f ixSleep(sqlite3_
334b0 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e vfs *NotUsed, in
334c0 74 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 29 7b t microseconds){
334d0 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a .#if OS_VXWORKS.
334e0 20 20 73 74 72 75 63 74 20 74 69 6d 65 73 70 65 struct timespe
334f0 63 20 73 70 3b 0a 0a 20 20 73 70 2e 74 76 5f 73 c sp;.. sp.tv_s
33500 65 63 20 3d 20 6d 69 63 72 6f 73 65 63 6f 6e 64 ec = microsecond
33510 73 20 2f 20 31 30 30 30 30 30 30 3b 0a 20 20 73 s / 1000000;. s
33520 70 2e 74 76 5f 6e 73 65 63 20 3d 20 28 6d 69 63 p.tv_nsec = (mic
33530 72 6f 73 65 63 6f 6e 64 73 20 25 20 31 30 30 30 roseconds % 1000
33540 30 30 30 29 20 2a 20 31 30 30 30 3b 0a 20 20 6e 000) * 1000;. n
33550 61 6e 6f 73 6c 65 65 70 28 26 73 70 2c 20 4e 55 anosleep(&sp, NU
33560 4c 4c 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 LL);. UNUSED_PA
33570 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 RAMETER(NotUsed)
33580 3b 0a 20 20 72 65 74 75 72 6e 20 6d 69 63 72 6f ;. return micro
33590 73 65 63 6f 6e 64 73 3b 0a 23 65 6c 69 66 20 64 seconds;.#elif d
335a0 65 66 69 6e 65 64 28 48 41 56 45 5f 55 53 4c 45 efined(HAVE_USLE
335b0 45 50 29 20 26 26 20 48 41 56 45 5f 55 53 4c 45 EP) && HAVE_USLE
335c0 45 50 0a 20 20 75 73 6c 65 65 70 28 6d 69 63 72 EP. usleep(micr
335d0 6f 73 65 63 6f 6e 64 73 29 3b 0a 20 20 55 4e 55 oseconds);. UNU
335e0 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f SED_PARAMETER(No
335f0 74 55 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e tUsed);. return
33600 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 3b 0a 23 microseconds;.#
33610 65 6c 73 65 0a 20 20 69 6e 74 20 73 65 63 6f 6e else. int secon
33620 64 73 20 3d 20 28 6d 69 63 72 6f 73 65 63 6f 6e ds = (microsecon
33630 64 73 2b 39 39 39 39 39 39 29 2f 31 30 30 30 30 ds+999999)/10000
33640 30 30 3b 0a 20 20 73 6c 65 65 70 28 73 65 63 6f 00;. sleep(seco
33650 6e 64 73 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 nds);. UNUSED_P
33660 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 ARAMETER(NotUsed
33670 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 65 63 6f );. return seco
33680 6e 64 73 2a 31 30 30 30 30 30 30 3b 0a 23 65 6e nds*1000000;.#en
33690 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 dif.}../*.** The
336a0 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 following varia
336b0 62 6c 65 2c 20 69 66 20 73 65 74 20 74 6f 20 61 ble, if set to a
336c0 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 2c non-zero value,
336d0 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 is interpreted
336e0 61 73 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65 72 as.** the number
336f0 20 6f 66 20 73 65 63 6f 6e 64 73 20 73 69 6e 63 of seconds sinc
33700 65 20 31 39 37 30 20 61 6e 64 20 69 73 20 75 73 e 1970 and is us
33710 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 72 65 ed to set the re
33720 73 75 6c 74 20 6f 66 0a 2a 2a 20 73 71 6c 69 74 sult of.** sqlit
33730 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 28 e3OsCurrentTime(
33740 29 20 64 75 72 69 6e 67 20 74 65 73 74 69 6e 67 ) during testing
33750 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
33760 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c 69 TE_TEST.int sqli
33770 74 65 33 5f 63 75 72 72 65 6e 74 5f 74 69 6d 65 te3_current_time
33780 20 3d 20 30 3b 20 20 2f 2a 20 46 61 6b 65 20 73 = 0; /* Fake s
33790 79 73 74 65 6d 20 74 69 6d 65 20 69 6e 20 73 65 ystem time in se
337a0 63 6f 6e 64 73 20 73 69 6e 63 65 20 31 39 37 30 conds since 1970
337b0 2e 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a . */.#endif../*.
337c0 2a 2a 20 46 69 6e 64 20 74 68 65 20 63 75 72 72 ** Find the curr
337d0 65 6e 74 20 74 69 6d 65 20 28 69 6e 20 55 6e 69 ent time (in Uni
337e0 76 65 72 73 61 6c 20 43 6f 6f 72 64 69 6e 61 74 versal Coordinat
337f0 65 64 20 54 69 6d 65 29 2e 20 20 57 72 69 74 65 ed Time). Write
33800 20 69 6e 74 6f 20 2a 70 69 4e 6f 77 0a 2a 2a 20 into *piNow.**
33810 74 68 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65 the current time
33820 20 61 6e 64 20 64 61 74 65 20 61 73 20 61 20 4a and date as a J
33830 75 6c 69 61 6e 20 44 61 79 20 6e 75 6d 62 65 72 ulian Day number
33840 20 74 69 6d 65 73 20 38 36 5f 34 30 30 5f 30 30 times 86_400_00
33850 30 2e 20 20 49 6e 0a 2a 2a 20 6f 74 68 65 72 20 0. In.** other
33860 77 6f 72 64 73 2c 20 77 72 69 74 65 20 69 6e 74 words, write int
33870 6f 20 2a 70 69 4e 6f 77 20 74 68 65 20 6e 75 6d o *piNow the num
33880 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f ber of milliseco
33890 6e 64 73 20 73 69 6e 63 65 20 74 68 65 20 4a 75 nds since the Ju
338a0 6c 69 61 6e 0a 2a 2a 20 65 70 6f 63 68 20 6f 66 lian.** epoch of
338b0 20 6e 6f 6f 6e 20 69 6e 20 47 72 65 65 6e 77 69 noon in Greenwi
338c0 63 68 20 6f 6e 20 4e 6f 76 65 6d 62 65 72 20 32 ch on November 2
338d0 34 2c 20 34 37 31 34 20 42 2e 43 20 61 63 63 6f 4, 4714 B.C acco
338e0 72 64 69 6e 67 20 74 6f 20 74 68 65 0a 2a 2a 20 rding to the.**
338f0 70 72 6f 6c 65 70 74 69 63 20 47 72 65 67 6f 72 proleptic Gregor
33900 69 61 6e 20 63 61 6c 65 6e 64 61 72 2e 0a 2a 2a ian calendar..**
33910 0a 2a 2a 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 .** On success,
33920 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
33930 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 . Return SQLITE
33940 5f 45 52 52 4f 52 20 69 66 20 74 68 65 20 74 69 _ERROR if the ti
33950 6d 65 20 61 6e 64 20 64 61 74 65 20 0a 2a 2a 20 me and date .**
33960 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2e cannot be found.
33970 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 .*/.static int u
33980 6e 69 78 43 75 72 72 65 6e 74 54 69 6d 65 49 6e nixCurrentTimeIn
33990 74 36 34 28 73 71 6c 69 74 65 33 5f 76 66 73 20 t64(sqlite3_vfs
339a0 2a 4e 6f 74 55 73 65 64 2c 20 73 71 6c 69 74 65 *NotUsed, sqlite
339b0 33 5f 69 6e 74 36 34 20 2a 70 69 4e 6f 77 29 7b 3_int64 *piNow){
339c0 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 . static const
339d0 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 75 6e sqlite3_int64 un
339e0 69 78 45 70 6f 63 68 20 3d 20 32 34 34 30 35 38 ixEpoch = 244058
339f0 37 35 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 75*(sqlite3_int6
33a00 34 29 38 36 34 30 30 30 30 3b 0a 20 20 69 6e 74 4)8640000;. int
33a10 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
33a20 0a 23 69 66 20 64 65 66 69 6e 65 64 28 4e 4f 5f .#if defined(NO_
33a30 47 45 54 54 4f 44 29 0a 20 20 74 69 6d 65 5f 74 GETTOD). time_t
33a40 20 74 3b 0a 20 20 74 69 6d 65 28 26 74 29 3b 0a t;. time(&t);.
33a50 20 20 2a 70 69 4e 6f 77 20 3d 20 28 28 73 71 6c *piNow = ((sql
33a60 69 74 65 33 5f 69 6e 74 36 34 29 74 29 2a 31 30 ite3_int64)t)*10
33a70 30 30 20 2b 20 75 6e 69 78 45 70 6f 63 68 3b 0a 00 + unixEpoch;.
33a80 23 65 6c 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 #elif OS_VXWORKS
33a90 0a 20 20 73 74 72 75 63 74 20 74 69 6d 65 73 70 . struct timesp
33aa0 65 63 20 73 4e 6f 77 3b 0a 20 20 63 6c 6f 63 6b ec sNow;. clock
33ab0 5f 67 65 74 74 69 6d 65 28 43 4c 4f 43 4b 5f 52 _gettime(CLOCK_R
33ac0 45 41 4c 54 49 4d 45 2c 20 26 73 4e 6f 77 29 3b EALTIME, &sNow);
33ad0 0a 20 20 2a 70 69 4e 6f 77 20 3d 20 75 6e 69 78 . *piNow = unix
33ae0 45 70 6f 63 68 20 2b 20 31 30 30 30 2a 28 73 71 Epoch + 1000*(sq
33af0 6c 69 74 65 33 5f 69 6e 74 36 34 29 73 4e 6f 77 lite3_int64)sNow
33b00 2e 74 76 5f 73 65 63 20 2b 20 73 4e 6f 77 2e 74 .tv_sec + sNow.t
33b10 76 5f 6e 73 65 63 2f 31 30 30 30 30 30 30 3b 0a v_nsec/1000000;.
33b20 23 65 6c 73 65 0a 20 20 73 74 72 75 63 74 20 74 #else. struct t
33b30 69 6d 65 76 61 6c 20 73 4e 6f 77 3b 0a 20 20 28 imeval sNow;. (
33b40 76 6f 69 64 29 67 65 74 74 69 6d 65 6f 66 64 61 void)gettimeofda
33b50 79 28 26 73 4e 6f 77 2c 20 30 29 3b 20 20 2f 2a y(&sNow, 0); /*
33b60 20 43 61 6e 6e 6f 74 20 66 61 69 6c 20 67 69 76 Cannot fail giv
33b70 65 6e 20 76 61 6c 69 64 20 61 72 67 75 6d 65 6e en valid argumen
33b80 74 73 20 2a 2f 0a 20 20 2a 70 69 4e 6f 77 20 3d ts */. *piNow =
33b90 20 75 6e 69 78 45 70 6f 63 68 20 2b 20 31 30 30 unixEpoch + 100
33ba0 30 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 0*(sqlite3_int64
33bb0 29 73 4e 6f 77 2e 74 76 5f 73 65 63 20 2b 20 73 )sNow.tv_sec + s
33bc0 4e 6f 77 2e 74 76 5f 75 73 65 63 2f 31 30 30 30 Now.tv_usec/1000
33bd0 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 ;.#endif..#ifdef
33be0 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 SQLITE_TEST. i
33bf0 66 28 20 73 71 6c 69 74 65 33 5f 63 75 72 72 65 f( sqlite3_curre
33c00 6e 74 5f 74 69 6d 65 20 29 7b 0a 20 20 20 20 2a nt_time ){. *
33c10 70 69 4e 6f 77 20 3d 20 31 30 30 30 2a 28 73 71 piNow = 1000*(sq
33c20 6c 69 74 65 33 5f 69 6e 74 36 34 29 73 71 6c 69 lite3_int64)sqli
33c30 74 65 33 5f 63 75 72 72 65 6e 74 5f 74 69 6d 65 te3_current_time
33c40 20 2b 20 75 6e 69 78 45 70 6f 63 68 3b 0a 20 20 + unixEpoch;.
33c50 7d 0a 23 65 6e 64 69 66 0a 20 20 55 4e 55 53 45 }.#endif. UNUSE
33c60 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 D_PARAMETER(NotU
33c70 73 65 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 sed);. return r
33c80 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 c;.}..#ifndef SQ
33c90 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
33ca0 41 54 45 44 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 ATED./*.** Find
33cb0 74 68 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65 the current time
33cc0 20 28 69 6e 20 55 6e 69 76 65 72 73 61 6c 20 43 (in Universal C
33cd0 6f 6f 72 64 69 6e 61 74 65 64 20 54 69 6d 65 29 oordinated Time)
33ce0 2e 20 20 57 72 69 74 65 20 74 68 65 0a 2a 2a 20 . Write the.**
33cf0 63 75 72 72 65 6e 74 20 74 69 6d 65 20 61 6e 64 current time and
33d00 20 64 61 74 65 20 61 73 20 61 20 4a 75 6c 69 61 date as a Julia
33d10 6e 20 44 61 79 20 6e 75 6d 62 65 72 20 69 6e 74 n Day number int
33d20 6f 20 2a 70 72 4e 6f 77 20 61 6e 64 0a 2a 2a 20 o *prNow and.**
33d30 72 65 74 75 72 6e 20 30 2e 20 20 52 65 74 75 72 return 0. Retur
33d40 6e 20 31 20 69 66 20 74 68 65 20 74 69 6d 65 20 n 1 if the time
33d50 61 6e 64 20 64 61 74 65 20 63 61 6e 6e 6f 74 20 and date cannot
33d60 62 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 61 be found..*/.sta
33d70 74 69 63 20 69 6e 74 20 75 6e 69 78 43 75 72 72 tic int unixCurr
33d80 65 6e 74 54 69 6d 65 28 73 71 6c 69 74 65 33 5f entTime(sqlite3_
33d90 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 64 6f vfs *NotUsed, do
33da0 75 62 6c 65 20 2a 70 72 4e 6f 77 29 7b 0a 20 20 uble *prNow){.
33db0 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 20 sqlite3_int64 i
33dc0 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 = 0;. int rc;.
33dd0 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
33de0 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 72 63 R(NotUsed);. rc
33df0 20 3d 20 75 6e 69 78 43 75 72 72 65 6e 74 54 69 = unixCurrentTi
33e00 6d 65 49 6e 74 36 34 28 30 2c 20 26 69 29 3b 0a meInt64(0, &i);.
33e10 20 20 2a 70 72 4e 6f 77 20 3d 20 69 2f 38 36 34 *prNow = i/864
33e20 30 30 30 30 30 2e 30 3b 0a 20 20 72 65 74 75 72 00000.0;. retur
33e30 6e 20 72 63 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 n rc;.}.#else.#
33e40 64 65 66 69 6e 65 20 75 6e 69 78 43 75 72 72 65 define unixCurre
33e50 6e 74 54 69 6d 65 20 30 0a 23 65 6e 64 69 66 0a ntTime 0.#endif.
33e60 0a 2f 2a 0a 2a 2a 20 54 68 65 20 78 47 65 74 4c ./*.** The xGetL
33e70 61 73 74 45 72 72 6f 72 28 29 20 6d 65 74 68 6f astError() metho
33e80 64 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f d is designed to
33e90 20 72 65 74 75 72 6e 20 61 20 62 65 74 74 65 72 return a better
33ea0 0a 2a 2a 20 6c 6f 77 2d 6c 65 76 65 6c 20 65 72 .** low-level er
33eb0 72 6f 72 20 6d 65 73 73 61 67 65 20 77 68 65 6e ror message when
33ec0 20 6f 70 65 72 61 74 69 6e 67 2d 73 79 73 74 65 operating-syste
33ed0 6d 20 70 72 6f 62 6c 65 6d 73 20 63 6f 6d 65 20 m problems come
33ee0 75 70 0a 2a 2a 20 64 75 72 69 6e 67 20 53 51 4c up.** during SQL
33ef0 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 ite operation.
33f00 4f 6e 6c 79 20 74 68 65 20 69 6e 74 65 67 65 72 Only the integer
33f10 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69 73 20 return code is
33f20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 75 73 65 currently.** use
33f30 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
33f40 20 75 6e 69 78 47 65 74 4c 61 73 74 45 72 72 6f unixGetLastErro
33f50 72 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e r(sqlite3_vfs *N
33f60 6f 74 55 73 65 64 2c 20 69 6e 74 20 4e 6f 74 55 otUsed, int NotU
33f70 73 65 64 32 2c 20 63 68 61 72 20 2a 4e 6f 74 55 sed2, char *NotU
33f80 73 65 64 33 29 7b 0a 20 20 55 4e 55 53 45 44 5f sed3){. UNUSED_
33f90 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 PARAMETER(NotUse
33fa0 64 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 d);. UNUSED_PAR
33fb0 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 32 29 AMETER(NotUsed2)
33fc0 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d ;. UNUSED_PARAM
33fd0 45 54 45 52 28 4e 6f 74 55 73 65 64 33 29 3b 0a ETER(NotUsed3);.
33fe0 20 20 72 65 74 75 72 6e 20 65 72 72 6e 6f 3b 0a return errno;.
33ff0 7d 0a 0a 0a 2f 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a }.../*.*********
34000 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 ***************
34010 45 6e 64 20 6f 66 20 73 71 6c 69 74 65 33 5f 76 End of sqlite3_v
34020 66 73 20 6d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a fs methods *****
34030 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34040 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ******.*********
34050 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34060 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34070 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34080 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34090 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a *****/../*******
340a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
340b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
340c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
340d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
340e0 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a *******.********
340f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34100 2a 2a 20 42 65 67 69 6e 20 50 72 6f 78 79 20 4c ** Begin Proxy L
34110 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a ocking *********
34120 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
34130 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 50 72 *******.**.** Pr
34140 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 69 73 20 61 oxy locking is a
34150 20 22 75 62 65 72 2d 6c 6f 63 6b 69 6e 67 2d 6d "uber-locking-m
34160 65 74 68 6f 64 22 20 69 6e 20 74 68 69 73 20 73 ethod" in this s
34170 65 6e 73 65 3a 20 20 49 74 20 75 73 65 73 20 74 ense: It uses t
34180 68 65 0a 2a 2a 20 6f 74 68 65 72 20 6c 6f 63 6b he.** other lock
34190 69 6e 67 20 6d 65 74 68 6f 64 73 20 6f 6e 20 73 ing methods on s
341a0 65 63 6f 6e 64 61 72 79 20 6c 6f 63 6b 20 66 69 econdary lock fi
341b0 6c 65 73 2e 20 20 50 72 6f 78 79 20 6c 6f 63 6b les. Proxy lock
341c0 69 6e 67 20 69 73 20 61 0a 2a 2a 20 6d 65 74 61 ing is a.** meta
341d0 2d 6c 61 79 65 72 20 6f 76 65 72 20 74 6f 70 20 -layer over top
341e0 6f 66 20 74 68 65 20 70 72 69 6d 69 74 69 76 65 of the primitive
341f0 20 6c 6f 63 6b 69 6e 67 20 69 6d 70 6c 65 6d 65 locking impleme
34200 6e 74 65 64 20 61 62 6f 76 65 2e 20 20 46 6f 72 nted above. For
34210 0a 2a 2a 20 74 68 69 73 20 72 65 61 73 6f 6e 2c .** this reason,
34220 20 74 68 65 20 64 69 76 69 73 69 6f 6e 20 74 68 the division th
34230 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 6f 66 at implements of
34240 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 69 proxy locking i
34250 73 20 64 65 66 65 72 72 65 64 0a 2a 2a 20 75 6e s deferred.** un
34260 74 69 6c 20 6c 61 74 65 20 69 6e 20 74 68 65 20 til late in the
34270 66 69 6c 65 20 28 68 65 72 65 29 20 61 66 74 65 file (here) afte
34280 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 6f 74 68 r all of the oth
34290 65 72 20 49 2f 4f 20 6d 65 74 68 6f 64 73 20 68 er I/O methods h
342a0 61 76 65 0a 2a 2a 20 62 65 65 6e 20 64 65 66 69 ave.** been defi
342b0 6e 65 64 20 2d 20 73 6f 20 74 68 61 74 20 74 68 ned - so that th
342c0 65 20 70 72 69 6d 69 74 69 76 65 20 6c 6f 63 6b e primitive lock
342d0 69 6e 67 20 6d 65 74 68 6f 64 73 20 61 72 65 20 ing methods are
342e0 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 61 73 20 available.** as
342f0 73 65 72 76 69 63 65 73 20 74 6f 20 68 65 6c 70 services to help
34300 20 77 69 74 68 20 74 68 65 20 69 6d 70 6c 65 6d with the implem
34310 65 6e 74 61 74 69 6f 6e 20 6f 66 20 70 72 6f 78 entation of prox
34320 79 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2a 0a 2a 2a y locking..**.**
34330 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 65 66 **.**.** The def
34340 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 20 73 63 68 ault locking sch
34350 65 6d 65 73 20 69 6e 20 53 51 4c 69 74 65 20 75 emes in SQLite u
34360 73 65 20 62 79 74 65 2d 72 61 6e 67 65 20 6c 6f se byte-range lo
34370 63 6b 73 20 6f 6e 20 74 68 65 0a 2a 2a 20 64 61 cks on the.** da
34380 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 tabase file to c
34390 6f 6f 72 64 69 6e 61 74 65 20 73 61 66 65 2c 20 oordinate safe,
343a0 63 6f 6e 63 75 72 72 65 6e 74 20 61 63 63 65 73 concurrent acces
343b0 73 20 62 79 20 6d 75 6c 74 69 70 6c 65 20 72 65 s by multiple re
343c0 61 64 65 72 73 0a 2a 2a 20 61 6e 64 20 77 72 69 aders.** and wri
343d0 74 65 72 73 20 5b 68 74 74 70 3a 2f 2f 73 71 6c ters [http://sql
343e0 69 74 65 2e 6f 72 67 2f 6c 6f 63 6b 69 6e 67 76 ite.org/lockingv
343f0 33 2e 68 74 6d 6c 5d 2e 20 20 54 68 65 20 66 69 3.html]. The fi
34400 76 65 20 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 0a ve file locking.
34410 2a 2a 20 73 74 61 74 65 73 20 28 55 4e 4c 4f 43 ** states (UNLOC
34420 4b 45 44 2c 20 50 45 4e 44 49 4e 47 2c 20 53 48 KED, PENDING, SH
34430 41 52 45 44 2c 20 52 45 53 45 52 56 45 44 2c 20 ARED, RESERVED,
34440 45 58 43 4c 55 53 49 56 45 29 20 61 72 65 20 69 EXCLUSIVE) are i
34450 6d 70 6c 65 6d 65 6e 74 65 64 0a 2a 2a 20 61 73 mplemented.** as
34460 20 50 4f 53 49 58 20 72 65 61 64 20 26 20 77 72 POSIX read & wr
34470 69 74 65 20 6c 6f 63 6b 73 20 6f 76 65 72 20 66 ite locks over f
34480 69 78 65 64 20 73 65 74 20 6f 66 20 6c 6f 63 61 ixed set of loca
34490 74 69 6f 6e 73 20 28 76 69 61 20 66 73 63 74 6c tions (via fsctl
344a0 29 2c 0a 2a 2a 20 6f 6e 20 41 46 50 20 61 6e 64 ),.** on AFP and
344b0 20 53 4d 42 20 6f 6e 6c 79 20 65 78 63 6c 75 73 SMB only exclus
344c0 69 76 65 20 62 79 74 65 2d 72 61 6e 67 65 20 6c ive byte-range l
344d0 6f 63 6b 73 20 61 72 65 20 61 76 61 69 6c 61 62 ocks are availab
344e0 6c 65 20 76 69 61 20 66 73 63 74 6c 0a 2a 2a 20 le via fsctl.**
344f0 77 69 74 68 20 5f 49 4f 57 52 28 27 7a 27 2c 20 with _IOWR('z',
34500 32 33 2c 20 73 74 72 75 63 74 20 42 79 74 65 52 23, struct ByteR
34510 61 6e 67 65 4c 6f 63 6b 50 42 32 29 20 74 6f 20 angeLockPB2) to
34520 74 72 61 63 6b 20 74 68 65 20 73 61 6d 65 20 35 track the same 5
34530 20 73 74 61 74 65 73 2e 0a 2a 2a 20 54 6f 20 73 states..** To s
34540 69 6d 75 6c 61 74 65 20 61 20 46 5f 52 44 4c 43 imulate a F_RDLC
34550 4b 20 6f 6e 20 74 68 65 20 73 68 61 72 65 64 20 K on the shared
34560 72 61 6e 67 65 2c 20 6f 6e 20 41 46 50 20 61 20 range, on AFP a
34570 72 61 6e 64 6f 6d 6c 79 20 73 65 6c 65 63 74 65 randomly selecte
34580 64 0a 2a 2a 20 61 64 64 72 65 73 73 20 69 6e 20 d.** address in
34590 74 68 65 20 73 68 61 72 65 64 20 72 61 6e 67 65 the shared range
345a0 20 69 73 20 74 61 6b 65 6e 20 66 6f 72 20 61 20 is taken for a
345b0 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20 74 68 65 SHARED lock, the
345c0 20 65 6e 74 69 72 65 0a 2a 2a 20 73 68 61 72 65 entire.** share
345d0 64 20 72 61 6e 67 65 20 69 73 20 74 61 6b 65 6e d range is taken
345e0 20 66 6f 72 20 61 6e 20 45 58 43 4c 55 53 49 56 for an EXCLUSIV
345f0 45 20 6c 6f 63 6b 29 3a 0a 2a 2a 0a 2a 2a 20 20 E lock):.**.**
34600 20 20 20 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 PENDING_BYTE
34610 20 20 20 20 20 20 20 20 30 78 34 30 30 30 30 30 0x400000
34620 30 30 0a 2a 2a 20 20 20 20 20 20 52 45 53 45 52 00.** RESER
34630 56 45 44 5f 42 59 54 45 20 20 20 20 20 20 20 30 VED_BYTE 0
34640 78 34 30 30 30 30 30 30 31 0a 2a 2a 20 20 20 20 x40000001.**
34650 20 20 53 48 41 52 45 44 5f 52 41 4e 47 45 20 20 SHARED_RANGE
34660 20 20 20 20 20 20 30 78 34 30 30 30 30 30 30 32 0x40000002
34670 20 2d 3e 20 30 78 34 30 30 30 30 32 30 30 0a 2a -> 0x40000200.*
34680 2a 0a 2a 2a 20 54 68 69 73 20 77 6f 72 6b 73 20 *.** This works
34690 77 65 6c 6c 20 6f 6e 20 74 68 65 20 6c 6f 63 61 well on the loca
346a0 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 2c 20 62 l file system, b
346b0 75 74 20 73 68 6f 77 73 20 61 20 6e 65 61 72 6c ut shows a nearl
346c0 79 20 31 30 30 78 0a 2a 2a 20 73 6c 6f 77 64 6f y 100x.** slowdo
346d0 77 6e 20 69 6e 20 72 65 61 64 20 70 65 72 66 6f wn in read perfo
346e0 72 6d 61 6e 63 65 20 6f 6e 20 41 46 50 20 62 65 rmance on AFP be
346f0 63 61 75 73 65 20 74 68 65 20 41 46 50 20 63 6c cause the AFP cl
34700 69 65 6e 74 20 64 69 73 61 62 6c 65 73 0a 2a 2a ient disables.**
34710 20 74 68 65 20 72 65 61 64 20 63 61 63 68 65 20 the read cache
34720 77 68 65 6e 20 62 79 74 65 2d 72 61 6e 67 65 20 when byte-range
34730 6c 6f 63 6b 73 20 61 72 65 20 70 72 65 73 65 6e locks are presen
34740 74 2e 20 20 45 6e 61 62 6c 69 6e 67 20 74 68 65 t. Enabling the
34750 20 72 65 61 64 0a 2a 2a 20 63 61 63 68 65 20 65 read.** cache e
34760 78 70 6f 73 65 73 20 61 20 63 61 63 68 65 20 63 xposes a cache c
34770 6f 68 65 72 65 6e 63 79 20 70 72 6f 62 6c 65 6d oherency problem
34780 20 74 68 61 74 20 69 73 20 70 72 65 73 65 6e 74 that is present
34790 20 6f 6e 20 61 6c 6c 20 4f 53 20 58 0a 2a 2a 20 on all OS X.**
347a0 73 75 70 70 6f 72 74 65 64 20 6e 65 74 77 6f 72 supported networ
347b0 6b 20 66 69 6c 65 20 73 79 73 74 65 6d 73 2e 20 k file systems.
347c0 20 4e 46 53 20 61 6e 64 20 41 46 50 20 62 6f 74 NFS and AFP bot
347d0 68 20 6f 62 73 65 72 76 65 20 74 68 65 0a 2a 2a h observe the.**
347e0 20 63 6c 6f 73 65 2d 74 6f 2d 6f 70 65 6e 20 73 close-to-open s
347f0 65 6d 61 6e 74 69 63 73 20 66 6f 72 20 65 6e 73 emantics for ens
34800 75 72 69 6e 67 20 63 61 63 68 65 20 63 6f 68 65 uring cache cohe
34810 72 65 6e 63 79 0a 2a 2a 20 5b 68 74 74 70 3a 2f rency.** [http:/
34820 2f 6e 66 73 2e 73 6f 75 72 63 65 66 6f 72 67 65 /nfs.sourceforge
34830 2e 6e 65 74 2f 23 66 61 71 5f 61 38 5d 2c 20 77 .net/#faq_a8], w
34840 68 69 63 68 20 64 6f 65 73 20 6e 6f 74 20 65 66 hich does not ef
34850 66 65 63 74 69 76 65 6c 79 0a 2a 2a 20 61 64 64 fectively.** add
34860 72 65 73 73 20 74 68 65 20 72 65 71 75 69 72 65 ress the require
34870 6d 65 6e 74 73 20 66 6f 72 20 63 6f 6e 63 75 72 ments for concur
34880 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 61 63 rent database ac
34890 63 65 73 73 20 62 79 20 6d 75 6c 74 69 70 6c 65 cess by multiple
348a0 0a 2a 2a 20 72 65 61 64 65 72 73 20 61 6e 64 20 .** readers and
348b0 77 72 69 74 65 72 73 0a 2a 2a 20 5b 68 74 74 70 writers.** [http
348c0 3a 2f 2f 77 77 77 2e 6e 61 62 62 6c 65 2e 63 6f ://www.nabble.co
348d0 6d 2f 53 51 4c 69 74 65 2d 6f 6e 2d 4e 46 53 2d m/SQLite-on-NFS-
348e0 63 61 63 68 65 2d 63 6f 68 65 72 65 6e 63 79 2d cache-coherency-
348f0 74 64 31 35 36 35 35 37 30 31 2e 68 74 6d 6c 5d td15655701.html]
34900 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 61 64 64 72 65 ..**.** To addre
34910 73 73 20 74 68 65 20 70 65 72 66 6f 72 6d 61 6e ss the performan
34920 63 65 20 61 6e 64 20 63 61 63 68 65 20 63 6f 68 ce and cache coh
34930 65 72 65 6e 63 79 20 69 73 73 75 65 73 2c 20 70 erency issues, p
34940 72 6f 78 79 20 66 69 6c 65 20 6c 6f 63 6b 69 6e roxy file lockin
34950 67 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74 68 65 g.** changes the
34960 20 77 61 79 20 64 61 74 61 62 61 73 65 20 61 63 way database ac
34970 63 65 73 73 20 69 73 20 63 6f 6e 74 72 6f 6c 6c cess is controll
34980 65 64 20 62 79 20 6c 69 6d 69 74 69 6e 67 20 61 ed by limiting a
34990 63 63 65 73 73 20 74 6f 20 61 0a 2a 2a 20 73 69 ccess to a.** si
349a0 6e 67 6c 65 20 68 6f 73 74 20 61 74 20 61 20 74 ngle host at a t
349b0 69 6d 65 20 61 6e 64 20 6d 6f 76 69 6e 67 20 66 ime and moving f
349c0 69 6c 65 20 6c 6f 63 6b 73 20 6f 66 66 20 6f 66 ile locks off of
349d0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
349e0 6c 65 0a 2a 2a 20 61 6e 64 20 6f 6e 74 6f 20 61 le.** and onto a
349f0 20 70 72 6f 78 79 20 66 69 6c 65 20 6f 6e 20 74 proxy file on t
34a00 68 65 20 6c 6f 63 61 6c 20 66 69 6c 65 20 73 79 he local file sy
34a10 73 74 65 6d 2e 20 20 0a 2a 2a 0a 2a 2a 0a 2a 2a stem. .**.**.**
34a20 20 55 73 69 6e 67 20 70 72 6f 78 79 20 6c 6f 63 Using proxy loc
34a30 6b 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ks.** ----------
34a40 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 0a 2a 2a 20 43 20 -------.**.** C
34a50 41 50 49 73 0a 2a 2a 0a 2a 2a 20 20 73 71 6c 69 APIs.**.** sqli
34a60 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c te3_file_control
34a70 28 64 62 2c 20 64 62 6e 61 6d 65 2c 20 53 51 4c (db, dbname, SQL
34a80 49 54 45 5f 46 43 4e 54 4c 5f 53 45 54 5f 4c 4f ITE_FCNTL_SET_LO
34a90 43 4b 50 52 4f 58 59 46 49 4c 45 2c 0a 2a 2a 20 CKPROXYFILE,.**
34aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34ab0 20 20 20 20 20 20 3c 70 72 6f 78 79 5f 70 61 74 <proxy_pat
34ac0 68 3e 20 7c 20 22 3a 61 75 74 6f 3a 22 29 3b 0a h> | ":auto:");.
34ad0 2a 2a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 ** sqlite3_file
34ae0 5f 63 6f 6e 74 72 6f 6c 28 64 62 2c 20 64 62 6e _control(db, dbn
34af0 61 6d 65 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 ame, SQLITE_FCNT
34b00 4c 5f 47 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46 L_GET_LOCKPROXYF
34b10 49 4c 45 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20 ILE,.**
34b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26 3c &<
34b30 70 72 6f 78 79 5f 70 61 74 68 3e 29 3b 0a 2a 2a proxy_path>);.**
34b40 0a 2a 2a 0a 2a 2a 20 53 51 4c 20 70 72 61 67 6d .**.** SQL pragm
34b50 61 73 0a 2a 2a 0a 2a 2a 20 20 50 52 41 47 4d 41 as.**.** PRAGMA
34b60 20 5b 64 61 74 61 62 61 73 65 2e 5d 6c 6f 63 6b [database.]lock
34b70 5f 70 72 6f 78 79 5f 66 69 6c 65 3d 3c 70 72 6f _proxy_file=<pro
34b80 78 79 5f 70 61 74 68 3e 20 7c 20 3a 61 75 74 6f xy_path> | :auto
34b90 3a 0a 2a 2a 20 20 50 52 41 47 4d 41 20 5b 64 61 :.** PRAGMA [da
34ba0 74 61 62 61 73 65 2e 5d 6c 6f 63 6b 5f 70 72 6f tabase.]lock_pro
34bb0 78 79 5f 66 69 6c 65 0a 2a 2a 0a 2a 2a 20 53 70 xy_file.**.** Sp
34bc0 65 63 69 66 79 69 6e 67 20 22 3a 61 75 74 6f 3a ecifying ":auto:
34bd0 22 20 6d 65 61 6e 73 20 74 68 61 74 20 69 66 20 " means that if
34be0 74 68 65 72 65 20 69 73 20 61 20 63 6f 6e 63 68 there is a conch
34bf0 20 66 69 6c 65 20 77 69 74 68 20 61 20 6d 61 74 file with a mat
34c00 63 68 69 6e 67 0a 2a 2a 20 68 6f 73 74 20 49 44 ching.** host ID
34c10 20 69 6e 20 69 74 2c 20 74 68 65 20 70 72 6f 78 in it, the prox
34c20 79 20 70 61 74 68 20 69 6e 20 74 68 65 20 63 6f y path in the co
34c30 6e 63 68 20 66 69 6c 65 20 77 69 6c 6c 20 62 65 nch file will be
34c40 20 75 73 65 64 2c 20 6f 74 68 65 72 77 69 73 65 used, otherwise
34c50 0a 2a 2a 20 61 20 70 72 6f 78 79 20 70 61 74 68 .** a proxy path
34c60 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 75 73 based on the us
34c70 65 72 27 73 20 74 65 6d 70 20 64 69 72 0a 2a 2a er's temp dir.**
34c80 20 28 76 69 61 20 63 6f 6e 66 73 74 72 28 5f 43 (via confstr(_C
34c90 53 5f 44 41 52 57 49 4e 5f 55 53 45 52 5f 54 45 S_DARWIN_USER_TE
34ca0 4d 50 5f 44 49 52 2c 2e 2e 2e 29 29 20 77 69 6c MP_DIR,...)) wil
34cb0 6c 20 62 65 20 75 73 65 64 20 61 6e 64 20 74 68 l be used and th
34cc0 65 0a 2a 2a 20 61 63 74 75 61 6c 20 70 72 6f 78 e.** actual prox
34cd0 79 20 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 67 y file name is g
34ce0 65 6e 65 72 61 74 65 64 20 66 72 6f 6d 20 74 68 enerated from th
34cf0 65 20 6e 61 6d 65 20 61 6e 64 20 70 61 74 68 20 e name and path
34d00 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 of the.** databa
34d10 73 65 20 66 69 6c 65 2e 20 20 46 6f 72 20 65 78 se file. For ex
34d20 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 ample:.**.**
34d30 20 20 20 46 6f 72 20 64 61 74 61 62 61 73 65 20 For database
34d40 70 61 74 68 20 22 2f 55 73 65 72 73 2f 6d 65 2f path "/Users/me/
34d50 66 6f 6f 2e 64 62 22 20 0a 2a 2a 20 20 20 20 20 foo.db" .**
34d60 20 20 54 68 65 20 6c 6f 63 6b 20 70 61 74 68 20 The lock path
34d70 77 69 6c 6c 20 62 65 20 22 3c 74 6d 70 64 69 72 will be "<tmpdir
34d80 3e 2f 73 71 6c 69 74 65 70 6c 6f 63 6b 73 2f 5f >/sqliteplocks/_
34d90 55 73 65 72 73 5f 6d 65 5f 66 6f 6f 2e 64 62 3a Users_me_foo.db:
34da0 61 75 74 6f 3a 22 29 0a 2a 2a 0a 2a 2a 20 4f 6e auto:").**.** On
34db0 63 65 20 61 20 6c 6f 63 6b 20 70 72 6f 78 79 20 ce a lock proxy
34dc0 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 66 6f is configured fo
34dd0 72 20 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e r a database con
34de0 6e 65 63 74 69 6f 6e 2c 20 69 74 20 63 61 6e 20 nection, it can
34df0 6e 6f 74 0a 2a 2a 20 62 65 20 72 65 6d 6f 76 65 not.** be remove
34e00 64 2c 20 68 6f 77 65 76 65 72 20 69 74 20 6d 61 d, however it ma
34e10 79 20 62 65 20 73 77 69 74 63 68 65 64 20 74 6f y be switched to
34e20 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 72 6f a different pro
34e30 78 79 20 70 61 74 68 20 76 69 61 0a 2a 2a 20 74 xy path via.** t
34e40 68 65 20 61 62 6f 76 65 20 41 50 49 73 20 28 61 he above APIs (a
34e50 73 73 75 6d 69 6e 67 20 74 68 65 20 63 6f 6e 63 ssuming the conc
34e60 68 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 62 65 h file is not be
34e70 69 6e 67 20 68 65 6c 64 20 62 79 20 61 6e 6f 74 ing held by anot
34e80 68 65 72 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f her.** connectio
34e90 6e 20 6f 72 20 70 72 6f 63 65 73 73 29 2e 20 0a n or process). .
34ea0 2a 2a 0a 2a 2a 0a 2a 2a 20 48 6f 77 20 70 72 6f **.**.** How pro
34eb0 78 79 20 6c 6f 63 6b 69 6e 67 20 77 6f 72 6b 73 xy locking works
34ec0 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .** ------------
34ed0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 0a 2a -----------.**.*
34ee0 2a 20 50 72 6f 78 79 20 66 69 6c 65 20 6c 6f 63 * Proxy file loc
34ef0 6b 69 6e 67 20 72 65 6c 69 65 73 20 70 72 69 6d king relies prim
34f00 61 72 69 6c 79 20 6f 6e 20 74 77 6f 20 6e 65 77 arily on two new
34f10 20 73 75 70 70 6f 72 74 69 6e 67 20 66 69 6c 65 supporting file
34f20 73 3a 20 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 63 s: .**.** * c
34f30 6f 6e 63 68 20 66 69 6c 65 20 74 6f 20 6c 69 6d onch file to lim
34f40 69 74 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 it access to the
34f50 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
34f60 6f 20 61 20 73 69 6e 67 6c 65 20 68 6f 73 74 0a o a single host.
34f70 2a 2a 20 20 20 20 20 20 61 74 20 61 20 74 69 6d ** at a tim
34f80 65 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 70 72 6f e.**.** * pro
34f90 78 79 20 66 69 6c 65 20 74 6f 20 61 63 74 20 61 xy file to act a
34fa0 73 20 61 20 70 72 6f 78 79 20 66 6f 72 20 74 68 s a proxy for th
34fb0 65 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 e advisory locks
34fc0 20 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 20 20 20 normally.**
34fd0 20 20 74 61 6b 65 6e 20 6f 6e 20 74 68 65 20 64 taken on the d
34fe0 61 74 61 62 61 73 65 0a 2a 2a 0a 2a 2a 20 54 68 atabase.**.** Th
34ff0 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 2d 20 74 e conch file - t
35000 6f 20 75 73 65 20 61 20 70 72 6f 78 79 20 66 69 o use a proxy fi
35010 6c 65 2c 20 73 71 6c 69 74 65 20 6d 75 73 74 20 le, sqlite must
35020 66 69 72 73 74 20 22 68 6f 6c 64 20 74 68 65 20 first "hold the
35030 63 6f 6e 63 68 22 0a 2a 2a 20 62 79 20 74 61 6b conch".** by tak
35040 69 6e 67 20 61 6e 20 73 71 6c 69 74 65 2d 73 74 ing an sqlite-st
35050 79 6c 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 yle shared lock
35060 6f 6e 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c on the conch fil
35070 65 2c 20 72 65 61 64 69 6e 67 20 74 68 65 0a 2a e, reading the.*
35080 2a 20 63 6f 6e 74 65 6e 74 73 20 61 6e 64 20 63 * contents and c
35090 6f 6d 70 61 72 69 6e 67 20 74 68 65 20 68 6f 73 omparing the hos
350a0 74 27 73 20 75 6e 69 71 75 65 20 68 6f 73 74 20 t's unique host
350b0 49 44 20 28 73 65 65 20 62 65 6c 6f 77 29 20 61 ID (see below) a
350c0 6e 64 20 6c 6f 63 6b 0a 2a 2a 20 70 72 6f 78 79 nd lock.** proxy
350d0 20 70 61 74 68 20 61 67 61 69 6e 73 74 20 74 68 path against th
350e0 65 20 76 61 6c 75 65 73 20 73 74 6f 72 65 64 20 e values stored
350f0 69 6e 20 74 68 65 20 63 6f 6e 63 68 2e 20 20 54 in the conch. T
35100 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 69 73 he conch file is
35110 0a 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20 74 68 .** stored in th
35120 65 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 e same directory
35130 20 61 73 20 74 68 65 20 64 61 74 61 62 61 73 65 as the database
35140 20 66 69 6c 65 20 61 6e 64 20 74 68 65 20 66 69 file and the fi
35150 6c 65 20 6e 61 6d 65 0a 2a 2a 20 69 73 20 70 61 le name.** is pa
35160 74 74 65 72 6e 65 64 20 61 66 74 65 72 20 74 68 tterned after th
35170 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
35180 6e 61 6d 65 20 61 73 20 22 2e 3c 64 61 74 61 62 name as ".<datab
35190 61 73 65 6e 61 6d 65 3e 2d 63 6f 6e 63 68 22 2e asename>-conch".
351a0 0a 2a 2a 20 49 66 20 74 68 65 20 63 6f 6e 63 68 .** If the conch
351b0 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 file does not e
351c0 78 69 73 74 2c 20 6f 72 20 69 74 73 20 63 6f 6e xist, or its con
351d0 74 65 6e 74 73 20 64 6f 20 6e 6f 74 20 6d 61 74 tents do not mat
351e0 63 68 20 74 68 65 0a 2a 2a 20 68 6f 73 74 20 49 ch the.** host I
351f0 44 20 61 6e 64 2f 6f 72 20 70 72 6f 78 79 20 70 D and/or proxy p
35200 61 74 68 2c 20 74 68 65 6e 20 74 68 65 20 6c 6f ath, then the lo
35210 63 6b 20 69 73 20 65 73 63 61 6c 61 74 65 64 20 ck is escalated
35220 74 6f 20 61 6e 20 65 78 63 6c 75 73 69 76 65 0a to an exclusive.
35230 2a 2a 20 6c 6f 63 6b 20 61 6e 64 20 74 68 65 20 ** lock and the
35240 63 6f 6e 63 68 20 66 69 6c 65 20 63 6f 6e 74 65 conch file conte
35250 6e 74 73 20 69 73 20 75 70 64 61 74 65 64 20 77 nts is updated w
35260 69 74 68 20 74 68 65 20 68 6f 73 74 20 49 44 20 ith the host ID
35270 61 6e 64 20 70 72 6f 78 79 0a 2a 2a 20 70 61 74 and proxy.** pat
35280 68 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 69 h and the lock i
35290 73 20 64 6f 77 6e 67 72 61 64 65 64 20 74 6f 20 s downgraded to
352a0 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 61 67 a shared lock ag
352b0 61 69 6e 2e 20 20 49 66 20 74 68 65 20 63 6f 6e ain. If the con
352c0 63 68 0a 2a 2a 20 69 73 20 68 65 6c 64 20 62 79 ch.** is held by
352d0 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 73 another process
352e0 20 28 77 69 74 68 20 61 20 73 68 61 72 65 64 20 (with a shared
352f0 6c 6f 63 6b 29 2c 20 74 68 65 20 65 78 63 6c 75 lock), the exclu
35300 73 69 76 65 20 6c 6f 63 6b 0a 2a 2a 20 77 69 6c sive lock.** wil
35310 6c 20 66 61 69 6c 20 61 6e 64 20 53 51 4c 49 54 l fail and SQLIT
35320 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e E_BUSY is return
35330 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 72 ed..**.** The pr
35340 6f 78 79 20 66 69 6c 65 20 2d 20 61 20 73 69 6e oxy file - a sin
35350 67 6c 65 2d 62 79 74 65 20 66 69 6c 65 20 75 73 gle-byte file us
35360 65 64 20 66 6f 72 20 61 6c 6c 20 61 64 76 69 73 ed for all advis
35370 6f 72 79 20 66 69 6c 65 20 6c 6f 63 6b 73 0a 2a ory file locks.*
35380 2a 20 6e 6f 72 6d 61 6c 6c 79 20 74 61 6b 65 6e * normally taken
35390 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
353a0 20 66 69 6c 65 2e 20 20 20 54 68 69 73 20 61 6c file. This al
353b0 6c 6f 77 73 20 66 6f 72 20 73 61 66 65 20 73 68 lows for safe sh
353c0 61 72 69 6e 67 0a 2a 2a 20 6f 66 20 74 68 65 20 aring.** of the
353d0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 66 6f database file fo
353e0 72 20 6d 75 6c 74 69 70 6c 65 20 72 65 61 64 65 r multiple reade
353f0 72 73 20 61 6e 64 20 77 72 69 74 65 72 73 20 6f rs and writers o
35400 6e 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 68 6f n the same.** ho
35410 73 74 20 28 74 68 65 20 63 6f 6e 63 68 20 65 6e st (the conch en
35420 73 75 72 65 73 20 74 68 61 74 20 74 68 65 79 20 sures that they
35430 61 6c 6c 20 75 73 65 20 74 68 65 20 73 61 6d 65 all use the same
35440 20 6c 6f 63 61 6c 20 6c 6f 63 6b 20 66 69 6c 65 local lock file
35450 29 2e 0a 2a 2a 0a 2a 2a 20 52 65 71 75 65 73 74 )..**.** Request
35460 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20 70 72 6f ing the lock pro
35470 78 79 20 64 6f 65 73 20 6e 6f 74 20 69 6d 6d 65 xy does not imme
35480 64 69 61 74 65 6c 79 20 74 61 6b 65 20 74 68 65 diately take the
35490 20 63 6f 6e 63 68 2c 20 69 74 20 69 73 0a 2a 2a conch, it is.**
354a0 20 6f 6e 6c 79 20 74 61 6b 65 6e 20 77 68 65 6e only taken when
354b0 20 74 68 65 20 66 69 72 73 74 20 72 65 71 75 65 the first reque
354c0 73 74 20 74 6f 20 6c 6f 63 6b 20 64 61 74 61 62 st to lock datab
354d0 61 73 65 20 66 69 6c 65 20 69 73 20 6d 61 64 65 ase file is made
354e0 2e 20 20 0a 2a 2a 20 54 68 69 73 20 6d 61 74 63 . .** This matc
354f0 68 65 73 20 74 68 65 20 73 65 6d 61 6e 74 69 63 hes the semantic
35500 73 20 6f 66 20 74 68 65 20 74 72 61 64 69 74 69 s of the traditi
35510 6f 6e 61 6c 20 6c 6f 63 6b 69 6e 67 20 62 65 68 onal locking beh
35520 61 76 69 6f 72 2c 20 77 68 65 72 65 0a 2a 2a 20 avior, where.**
35530 6f 70 65 6e 69 6e 67 20 61 20 63 6f 6e 6e 65 63 opening a connec
35540 74 69 6f 6e 20 74 6f 20 61 20 64 61 74 61 62 61 tion to a databa
35550 73 65 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 se file does not
35560 20 74 61 6b 65 20 61 20 6c 6f 63 6b 20 6f 6e 20 take a lock on
35570 69 74 2e 0a 2a 2a 20 54 68 65 20 73 68 61 72 65 it..** The share
35580 64 20 6c 6f 63 6b 20 61 6e 64 20 61 6e 20 6f 70 d lock and an op
35590 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 en file descript
355a0 6f 72 20 61 72 65 20 6d 61 69 6e 74 61 69 6e 65 or are maintaine
355b0 64 20 75 6e 74 69 6c 20 0a 2a 2a 20 74 68 65 20 d until .** the
355c0 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 connection to th
355d0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c e database is cl
355e0 6f 73 65 64 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 65 osed. .**.** The
355f0 20 70 72 6f 78 79 20 66 69 6c 65 20 61 6e 64 20 proxy file and
35600 74 68 65 20 6c 6f 63 6b 20 66 69 6c 65 20 61 72 the lock file ar
35610 65 20 6e 65 76 65 72 20 64 65 6c 65 74 65 64 20 e never deleted
35620 73 6f 20 74 68 65 79 20 6f 6e 6c 79 20 6e 65 65 so they only nee
35630 64 0a 2a 2a 20 74 6f 20 62 65 20 63 72 65 61 74 d.** to be creat
35640 65 64 20 74 68 65 20 66 69 72 73 74 20 74 69 6d ed the first tim
35650 65 20 74 68 65 79 20 61 72 65 20 75 73 65 64 2e e they are used.
35660 0a 2a 2a 0a 2a 2a 20 43 6f 6e 66 69 67 75 72 61 .**.** Configura
35670 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 0a 2a 2a 20 tion options.**
35680 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
35690 2d 2d 2d 2d 2d 0a 2a 2a 0a 2a 2a 20 20 53 51 4c -----.**.** SQL
356a0 49 54 45 5f 50 52 45 46 45 52 5f 50 52 4f 58 59 ITE_PREFER_PROXY
356b0 5f 4c 4f 43 4b 49 4e 47 0a 2a 2a 0a 2a 2a 20 20 _LOCKING.**.**
356c0 20 20 20 20 20 44 61 74 61 62 61 73 65 20 66 69 Database fi
356d0 6c 65 73 20 61 63 63 65 73 73 65 64 20 6f 6e 20 les accessed on
356e0 6e 6f 6e 2d 6c 6f 63 61 6c 20 66 69 6c 65 20 73 non-local file s
356f0 79 73 74 65 6d 73 20 61 72 65 0a 2a 2a 20 20 20 ystems are.**
35700 20 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c automaticall
35710 79 20 63 6f 6e 66 69 67 75 72 65 64 20 66 6f 72 y configured for
35720 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 2c 20 proxy locking,
35730 6c 6f 63 6b 20 66 69 6c 65 73 20 61 72 65 0a 2a lock files are.*
35740 2a 20 20 20 20 20 20 20 6e 61 6d 65 64 20 61 75 * named au
35750 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 73 69 6e tomatically usin
35760 67 20 74 68 65 20 73 61 6d 65 20 6c 6f 67 69 63 g the same logic
35770 20 61 73 0a 2a 2a 20 20 20 20 20 20 20 50 52 41 as.** PRA
35780 47 4d 41 20 6c 6f 63 6b 5f 70 72 6f 78 79 5f 66 GMA lock_proxy_f
35790 69 6c 65 3d 22 3a 61 75 74 6f 3a 22 0a 2a 2a 20 ile=":auto:".**
357a0 20 20 20 0a 2a 2a 20 20 53 51 4c 49 54 45 5f 50 .** SQLITE_P
357b0 52 4f 58 59 5f 44 45 42 55 47 0a 2a 2a 0a 2a 2a ROXY_DEBUG.**.**
357c0 20 20 20 20 20 20 20 45 6e 61 62 6c 65 73 20 74 Enables t
357d0 68 65 20 6c 6f 67 67 69 6e 67 20 6f 66 20 65 72 he logging of er
357e0 72 6f 72 20 6d 65 73 73 61 67 65 73 20 64 75 72 ror messages dur
357f0 69 6e 67 20 68 6f 73 74 20 69 64 20 66 69 6c 65 ing host id file
35800 0a 2a 2a 20 20 20 20 20 20 20 72 65 74 72 69 65 .** retrie
35810 76 61 6c 20 61 6e 64 20 63 72 65 61 74 69 6f 6e val and creation
35820 0a 2a 2a 0a 2a 2a 20 20 4c 4f 43 4b 50 52 4f 58 .**.** LOCKPROX
35830 59 44 49 52 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 YDIR.**.**
35840 20 4f 76 65 72 72 69 64 65 73 20 74 68 65 20 64 Overrides the d
35850 65 66 61 75 6c 74 20 64 69 72 65 63 74 6f 72 79 efault directory
35860 20 75 73 65 64 20 66 6f 72 20 6c 6f 63 6b 20 70 used for lock p
35870 72 6f 78 79 20 66 69 6c 65 73 20 74 68 61 74 0a roxy files that.
35880 2a 2a 20 20 20 20 20 20 20 61 72 65 20 6e 61 6d ** are nam
35890 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 ed automatically
358a0 20 76 69 61 20 74 68 65 20 22 3a 61 75 74 6f 3a via the ":auto:
358b0 22 20 73 65 74 74 69 6e 67 0a 2a 2a 0a 2a 2a 20 " setting.**.**
358c0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
358d0 50 52 4f 58 59 44 49 52 5f 50 45 52 4d 49 53 53 PROXYDIR_PERMISS
358e0 49 4f 4e 53 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 IONS.**.**
358f0 20 50 65 72 6d 69 73 73 69 6f 6e 73 20 74 6f 20 Permissions to
35900 75 73 65 20 77 68 65 6e 20 63 72 65 61 74 69 6e use when creatin
35910 67 20 61 20 64 69 72 65 63 74 6f 72 79 20 66 6f g a directory fo
35920 72 20 73 74 6f 72 69 6e 67 20 74 68 65 0a 2a 2a r storing the.**
35930 20 20 20 20 20 20 20 6c 6f 63 6b 20 70 72 6f 78 lock prox
35940 79 20 66 69 6c 65 73 2c 20 6f 6e 6c 79 20 75 73 y files, only us
35950 65 64 20 77 68 65 6e 20 4c 4f 43 4b 50 52 4f 58 ed when LOCKPROX
35960 59 44 49 52 20 69 73 20 6e 6f 74 20 73 65 74 2e YDIR is not set.
35970 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20 20 20 0a 2a .** .** .*
35980 2a 20 41 73 20 6d 65 6e 74 69 6f 6e 65 64 20 61 * As mentioned a
35990 62 6f 76 65 2c 20 77 68 65 6e 20 63 6f 6d 70 69 bove, when compi
359a0 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f led with SQLITE_
359b0 50 52 45 46 45 52 5f 50 52 4f 58 59 5f 4c 4f 43 PREFER_PROXY_LOC
359c0 4b 49 4e 47 2c 0a 2a 2a 20 73 65 74 74 69 6e 67 KING,.** setting
359d0 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment
359e0 20 76 61 72 69 61 62 6c 65 20 53 51 4c 49 54 45 variable SQLITE
359f0 5f 46 4f 52 43 45 5f 50 52 4f 58 59 5f 4c 4f 43 _FORCE_PROXY_LOC
35a00 4b 49 4e 47 20 74 6f 20 31 20 77 69 6c 6c 0a 2a KING to 1 will.*
35a10 2a 20 66 6f 72 63 65 20 70 72 6f 78 79 20 6c 6f * force proxy lo
35a20 63 6b 69 6e 67 20 74 6f 20 62 65 20 75 73 65 64 cking to be used
35a30 20 66 6f 72 20 65 76 65 72 79 20 64 61 74 61 62 for every datab
35a40 61 73 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 2c ase file opened,
35a50 20 61 6e 64 20 30 0a 2a 2a 20 77 69 6c 6c 20 66 and 0.** will f
35a60 6f 72 63 65 20 61 75 74 6f 6d 61 74 69 63 20 70 orce automatic p
35a70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 74 6f 20 roxy locking to
35a80 62 65 20 64 69 73 61 62 6c 65 64 20 66 6f 72 20 be disabled for
35a90 61 6c 6c 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 all database.**
35aa0 66 69 6c 65 73 20 28 65 78 70 6c 69 63 69 74 6c files (explicitl
35ab0 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 53 51 y calling the SQ
35ac0 4c 49 54 45 5f 46 43 4e 54 4c 5f 53 45 54 5f 4c LITE_FCNTL_SET_L
35ad0 4f 43 4b 50 52 4f 58 59 46 49 4c 45 20 70 72 61 OCKPROXYFILE pra
35ae0 67 6d 61 20 6f 72 0a 2a 2a 20 73 71 6c 69 74 65 gma or.** sqlite
35af0 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c 20 41 50 _file_control AP
35b00 49 20 69 73 20 6e 6f 74 20 61 66 66 65 63 74 65 I is not affecte
35b10 64 20 62 79 20 53 51 4c 49 54 45 5f 46 4f 52 43 d by SQLITE_FORC
35b20 45 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 29 E_PROXY_LOCKING)
35b30 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 78 ..*/../*.** Prox
35b40 79 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6f 6e 6c y locking is onl
35b50 79 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 4d y available on M
35b60 61 63 4f 53 58 20 0a 2a 2f 0a 23 69 66 20 64 65 acOSX .*/.#if de
35b70 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 fined(__APPLE__)
35b80 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c && SQLITE_ENABL
35b90 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a E_LOCKING_STYLE.
35ba0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 ./*.** The proxy
35bb0 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 68 LockingContext h
35bc0 61 73 20 74 68 65 20 70 61 74 68 20 61 6e 64 20 as the path and
35bd0 66 69 6c 65 20 73 74 72 75 63 74 75 72 65 73 20 file structures
35be0 66 6f 72 20 74 68 65 20 72 65 6d 6f 74 65 20 0a for the remote .
35bf0 2a 2a 20 61 6e 64 20 6c 6f 63 61 6c 20 70 72 6f ** and local pro
35c00 78 79 20 66 69 6c 65 73 20 69 6e 20 69 74 0a 2a xy files in it.*
35c10 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 /.typedef struct
35c20 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e proxyLockingCon
35c30 74 65 78 74 20 70 72 6f 78 79 4c 6f 63 6b 69 6e text proxyLockin
35c40 67 43 6f 6e 74 65 78 74 3b 0a 73 74 72 75 63 74 gContext;.struct
35c50 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e proxyLockingCon
35c60 74 65 78 74 20 7b 0a 20 20 75 6e 69 78 46 69 6c text {. unixFil
35c70 65 20 2a 63 6f 6e 63 68 46 69 6c 65 3b 20 20 20 e *conchFile;
35c80 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 63 6f /* Open co
35c90 6e 63 68 20 66 69 6c 65 20 2a 2f 0a 20 20 63 68 nch file */. ch
35ca0 61 72 20 2a 63 6f 6e 63 68 46 69 6c 65 50 61 74 ar *conchFilePat
35cb0 68 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 h; /* Na
35cc0 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 63 68 20 me of the conch
35cd0 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 46 69 file */. unixFi
35ce0 6c 65 20 2a 6c 6f 63 6b 50 72 6f 78 79 3b 20 20 le *lockProxy;
35cf0 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 70 /* Open p
35d00 72 6f 78 79 20 6c 6f 63 6b 20 66 69 6c 65 20 2a roxy lock file *
35d10 2f 0a 20 20 63 68 61 72 20 2a 6c 6f 63 6b 50 72 /. char *lockPr
35d20 6f 78 79 50 61 74 68 3b 20 20 20 20 20 20 20 20 oxyPath;
35d30 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
35d40 70 72 6f 78 79 20 6c 6f 63 6b 20 66 69 6c 65 20 proxy lock file
35d50 2a 2f 0a 20 20 63 68 61 72 20 2a 64 62 50 61 74 */. char *dbPat
35d60 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
35d70 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
35d80 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f 0a 20 20 open file */.
35d90 69 6e 74 20 63 6f 6e 63 68 48 65 6c 64 3b 20 20 int conchHeld;
35da0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
35db0 31 20 69 66 20 74 68 65 20 63 6f 6e 63 68 20 69 1 if the conch i
35dc0 73 20 68 65 6c 64 2c 20 2d 31 20 69 66 20 6c 6f s held, -1 if lo
35dd0 63 6b 6c 65 73 73 20 2a 2f 0a 20 20 69 6e 74 20 ckless */. int
35de0 6e 46 61 69 6c 73 3b 20 20 20 20 20 20 20 20 20 nFails;
35df0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
35e00 65 72 20 6f 66 20 63 6f 6e 63 68 20 74 61 6b 69 er of conch taki
35e10 6e 67 20 66 61 69 6c 75 72 65 73 20 2a 2f 0a 20 ng failures */.
35e20 20 76 6f 69 64 20 2a 6f 6c 64 4c 6f 63 6b 69 6e void *oldLockin
35e30 67 43 6f 6e 74 65 78 74 3b 20 20 20 20 20 2f 2a gContext; /*
35e40 20 4f 72 69 67 69 6e 61 6c 20 6c 6f 63 6b 69 6e Original lockin
35e50 67 63 6f 6e 74 65 78 74 20 74 6f 20 72 65 73 74 gcontext to rest
35e60 6f 72 65 20 6f 6e 20 63 6c 6f 73 65 20 2a 2f 0a ore on close */.
35e70 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 sqlite3_io_met
35e80 68 6f 64 73 20 63 6f 6e 73 74 20 2a 70 4f 6c 64 hods const *pOld
35e90 4d 65 74 68 6f 64 3b 20 20 20 20 20 2f 2a 20 4f Method; /* O
35ea0 72 69 67 69 6e 61 6c 20 49 2f 4f 20 6d 65 74 68 riginal I/O meth
35eb0 6f 64 73 20 66 6f 72 20 63 6c 6f 73 65 20 2a 2f ods for close */
35ec0 0a 7d 3b 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 65 20 .};../* .** The
35ed0 70 72 6f 78 79 20 6c 6f 63 6b 20 66 69 6c 65 20 proxy lock file
35ee0 70 61 74 68 20 66 6f 72 20 74 68 65 20 64 61 74 path for the dat
35ef0 61 62 61 73 65 20 61 74 20 64 62 50 61 74 68 20 abase at dbPath
35f00 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
35f10 6c 50 61 74 68 2c 20 0a 2a 2a 20 77 68 69 63 68 lPath, .** which
35f20 20 6d 75 73 74 20 70 6f 69 6e 74 20 74 6f 20 76 must point to v
35f30 61 6c 69 64 2c 20 77 72 69 74 61 62 6c 65 20 6d alid, writable m
35f40 65 6d 6f 72 79 20 6c 61 72 67 65 20 65 6e 6f 75 emory large enou
35f50 67 68 20 66 6f 72 20 61 20 6d 61 78 4c 65 6e 20 gh for a maxLen
35f60 6c 65 6e 67 74 68 0a 2a 2a 20 66 69 6c 65 20 70 length.** file p
35f70 61 74 68 2e 20 0a 2a 2f 0a 73 74 61 74 69 63 20 ath. .*/.static
35f80 69 6e 74 20 70 72 6f 78 79 47 65 74 4c 6f 63 6b int proxyGetLock
35f90 50 61 74 68 28 63 6f 6e 73 74 20 63 68 61 72 20 Path(const char
35fa0 2a 64 62 50 61 74 68 2c 20 63 68 61 72 20 2a 6c *dbPath, char *l
35fb0 50 61 74 68 2c 20 73 69 7a 65 5f 74 20 6d 61 78 Path, size_t max
35fc0 4c 65 6e 29 7b 0a 20 20 69 6e 74 20 6c 65 6e 3b Len){. int len;
35fd0 0a 20 20 69 6e 74 20 64 62 4c 65 6e 3b 0a 20 20 . int dbLen;.
35fe0 69 6e 74 20 69 3b 0a 0a 23 69 66 64 65 66 20 4c int i;..#ifdef L
35ff0 4f 43 4b 50 52 4f 58 59 44 49 52 0a 20 20 6c 65 OCKPROXYDIR. le
36000 6e 20 3d 20 73 74 72 6c 63 70 79 28 6c 50 61 74 n = strlcpy(lPat
36010 68 2c 20 4c 4f 43 4b 50 52 4f 58 59 44 49 52 2c h, LOCKPROXYDIR,
36020 20 6d 61 78 4c 65 6e 29 3b 0a 23 65 6c 73 65 0a maxLen);.#else.
36030 23 20 69 66 64 65 66 20 5f 43 53 5f 44 41 52 57 # ifdef _CS_DARW
36040 49 4e 5f 55 53 45 52 5f 54 45 4d 50 5f 44 49 52 IN_USER_TEMP_DIR
36050 0a 20 20 7b 0a 20 20 20 20 69 66 28 20 21 63 6f . {. if( !co
36060 6e 66 73 74 72 28 5f 43 53 5f 44 41 52 57 49 4e nfstr(_CS_DARWIN
36070 5f 55 53 45 52 5f 54 45 4d 50 5f 44 49 52 2c 20 _USER_TEMP_DIR,
36080 6c 50 61 74 68 2c 20 6d 61 78 4c 65 6e 29 20 29 lPath, maxLen) )
36090 7b 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 {. OSTRACE(
360a0 28 22 47 45 54 4c 4f 43 4b 50 41 54 48 20 20 66 ("GETLOCKPATH f
360b0 61 69 6c 65 64 20 25 73 20 65 72 72 6e 6f 3d 25 ailed %s errno=%
360c0 64 20 70 69 64 3d 25 64 5c 6e 22 2c 0a 20 20 20 d pid=%d\n",.
360d0 20 20 20 20 20 20 20 20 20 20 20 20 6c 50 61 74 lPat
360e0 68 2c 20 65 72 72 6e 6f 2c 20 6f 73 47 65 74 70 h, errno, osGetp
360f0 69 64 28 30 29 29 29 3b 0a 20 20 20 20 20 20 72 id(0)));. r
36100 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 eturn SQLITE_IOE
36110 52 52 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d 0a 20 RR_LOCK;. }.
36120 20 20 20 6c 65 6e 20 3d 20 73 74 72 6c 63 61 74 len = strlcat
36130 28 6c 50 61 74 68 2c 20 22 73 71 6c 69 74 65 70 (lPath, "sqlitep
36140 6c 6f 63 6b 73 22 2c 20 6d 61 78 4c 65 6e 29 3b locks", maxLen);
36150 20 20 20 20 0a 20 20 7d 0a 23 20 65 6c 73 65 0a . }.# else.
36160 20 20 6c 65 6e 20 3d 20 73 74 72 6c 63 70 79 28 len = strlcpy(
36170 6c 50 61 74 68 2c 20 22 2f 74 6d 70 2f 22 2c 20 lPath, "/tmp/",
36180 6d 61 78 4c 65 6e 29 3b 0a 23 20 65 6e 64 69 66 maxLen);.# endif
36190 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 6c .#endif.. if( l
361a0 50 61 74 68 5b 6c 65 6e 2d 31 5d 21 3d 27 2f 27 Path[len-1]!='/'
361b0 20 29 7b 0a 20 20 20 20 6c 65 6e 20 3d 20 73 74 ){. len = st
361c0 72 6c 63 61 74 28 6c 50 61 74 68 2c 20 22 2f 22 rlcat(lPath, "/"
361d0 2c 20 6d 61 78 4c 65 6e 29 3b 0a 20 20 7d 0a 20 , maxLen);. }.
361e0 20 0a 20 20 2f 2a 20 74 72 61 6e 73 66 6f 72 6d . /* transform
361f0 20 74 68 65 20 64 62 20 70 61 74 68 20 74 6f 20 the db path to
36200 61 20 75 6e 69 71 75 65 20 63 61 63 68 65 20 6e a unique cache n
36210 61 6d 65 20 2a 2f 0a 20 20 64 62 4c 65 6e 20 3d ame */. dbLen =
36220 20 28 69 6e 74 29 73 74 72 6c 65 6e 28 64 62 50 (int)strlen(dbP
36230 61 74 68 29 3b 0a 20 20 66 6f 72 28 20 69 3d 30 ath);. for( i=0
36240 3b 20 69 3c 64 62 4c 65 6e 20 26 26 20 28 69 2b ; i<dbLen && (i+
36250 6c 65 6e 2b 37 29 3c 28 69 6e 74 29 6d 61 78 4c len+7)<(int)maxL
36260 65 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 63 68 en; i++){. ch
36270 61 72 20 63 20 3d 20 64 62 50 61 74 68 5b 69 5d ar c = dbPath[i]
36280 3b 0a 20 20 20 20 6c 50 61 74 68 5b 69 2b 6c 65 ;. lPath[i+le
36290 6e 5d 20 3d 20 28 63 3d 3d 27 2f 27 29 3f 27 5f n] = (c=='/')?'_
362a0 27 3a 63 3b 0a 20 20 7d 0a 20 20 6c 50 61 74 68 ':c;. }. lPath
362b0 5b 69 2b 6c 65 6e 5d 3d 27 5c 30 27 3b 0a 20 20 [i+len]='\0';.
362c0 73 74 72 6c 63 61 74 28 6c 50 61 74 68 2c 20 22 strlcat(lPath, "
362d0 3a 61 75 74 6f 3a 22 2c 20 6d 61 78 4c 65 6e 29 :auto:", maxLen)
362e0 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22 47 45 ;. OSTRACE(("GE
362f0 54 4c 4f 43 4b 50 41 54 48 20 20 70 72 6f 78 79 TLOCKPATH proxy
36300 20 6c 6f 63 6b 20 70 61 74 68 3d 25 73 20 70 69 lock path=%s pi
36310 64 3d 25 64 5c 6e 22 2c 20 6c 50 61 74 68 2c 20 d=%d\n", lPath,
36320 6f 73 47 65 74 70 69 64 28 30 29 29 29 3b 0a 20 osGetpid(0)));.
36330 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
36340 4b 3b 0a 7d 0a 0a 2f 2a 20 0a 20 2a 2a 20 43 72 K;.}../* . ** Cr
36350 65 61 74 65 73 20 74 68 65 20 6c 6f 63 6b 20 66 eates the lock f
36360 69 6c 65 20 61 6e 64 20 61 6e 79 20 6d 69 73 73 ile and any miss
36370 69 6e 67 20 64 69 72 65 63 74 6f 72 69 65 73 20 ing directories
36380 69 6e 20 6c 6f 63 6b 50 61 74 68 0a 20 2a 2f 0a in lockPath. */.
36390 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 static int proxy
363a0 43 72 65 61 74 65 4c 6f 63 6b 50 61 74 68 28 63 CreateLockPath(c
363b0 6f 6e 73 74 20 63 68 61 72 20 2a 6c 6f 63 6b 50 onst char *lockP
363c0 61 74 68 29 7b 0a 20 20 69 6e 74 20 69 2c 20 6c ath){. int i, l
363d0 65 6e 3b 0a 20 20 63 68 61 72 20 62 75 66 5b 4d en;. char buf[M
363e0 41 58 50 41 54 48 4c 45 4e 5d 3b 0a 20 20 69 6e AXPATHLEN];. in
363f0 74 20 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 0a t start = 0;. .
36400 20 20 61 73 73 65 72 74 28 6c 6f 63 6b 50 61 74 assert(lockPat
36410 68 21 3d 4e 55 4c 4c 29 3b 0a 20 20 2f 2a 20 74 h!=NULL);. /* t
36420 72 79 20 74 6f 20 63 72 65 61 74 65 20 61 6c 6c ry to create all
36430 20 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 the intermediat
36440 65 20 64 69 72 65 63 74 6f 72 69 65 73 20 2a 2f e directories */
36450 0a 20 20 6c 65 6e 20 3d 20 28 69 6e 74 29 73 74 . len = (int)st
36460 72 6c 65 6e 28 6c 6f 63 6b 50 61 74 68 29 3b 0a rlen(lockPath);.
36470 20 20 62 75 66 5b 30 5d 20 3d 20 6c 6f 63 6b 50 buf[0] = lockP
36480 61 74 68 5b 30 5d 3b 0a 20 20 66 6f 72 28 20 69 ath[0];. for( i
36490 3d 31 3b 20 69 3c 6c 65 6e 3b 20 69 2b 2b 20 29 =1; i<len; i++ )
364a0 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 50 61 {. if( lockPa
364b0 74 68 5b 69 5d 20 3d 3d 20 27 2f 27 20 26 26 20 th[i] == '/' &&
364c0 28 69 20 2d 20 73 74 61 72 74 20 3e 20 30 29 20 (i - start > 0)
364d0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 6f 6e 6c 79 ){. /* only
364e0 20 6d 6b 64 69 72 20 69 66 20 6c 65 61 66 20 64 mkdir if leaf d
364f0 69 72 20 21 3d 20 22 2e 22 20 6f 72 20 22 2f 22 ir != "." or "/"
36500 20 6f 72 20 22 2e 2e 22 20 2a 2f 0a 20 20 20 20 or ".." */.
36510 20 20 69 66 28 20 69 2d 73 74 61 72 74 3e 32 20 if( i-start>2
36520 7c 7c 20 28 69 2d 73 74 61 72 74 3d 3d 31 20 26 || (i-start==1 &
36530 26 20 62 75 66 5b 73 74 61 72 74 5d 20 21 3d 20 & buf[start] !=
36540 27 2e 27 20 26 26 20 62 75 66 5b 73 74 61 72 74 '.' && buf[start
36550 5d 20 21 3d 20 27 2f 27 29 20 0a 20 20 20 20 20 ] != '/') .
36560 20 20 20 20 7c 7c 20 28 69 2d 73 74 61 72 74 3d || (i-start=
36570 3d 32 20 26 26 20 62 75 66 5b 73 74 61 72 74 5d =2 && buf[start]
36580 20 21 3d 20 27 2e 27 20 26 26 20 62 75 66 5b 73 != '.' && buf[s
36590 74 61 72 74 2b 31 5d 20 21 3d 20 27 2e 27 29 20 tart+1] != '.')
365a0 29 7b 0a 20 20 20 20 20 20 20 20 62 75 66 5b 69 ){. buf[i
365b0 5d 3d 27 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 ]='\0';.
365c0 69 66 28 20 6f 73 4d 6b 64 69 72 28 62 75 66 2c if( osMkdir(buf,
365d0 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
365e0 50 52 4f 58 59 44 49 52 5f 50 45 52 4d 49 53 53 PROXYDIR_PERMISS
365f0 49 4f 4e 53 29 20 29 7b 0a 20 20 20 20 20 20 20 IONS) ){.
36600 20 20 20 69 6e 74 20 65 72 72 3d 65 72 72 6e 6f int err=errno
36610 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
36620 65 72 72 21 3d 45 45 58 49 53 54 20 29 20 7b 0a err!=EEXIST ) {.
36630 20 20 20 20 20 20 20 20 20 20 20 20 4f 53 54 52 OSTR
36640 41 43 45 28 28 22 43 52 45 41 54 45 4c 4f 43 4b ACE(("CREATELOCK
36650 50 41 54 48 20 20 46 41 49 4c 45 44 20 63 72 65 PATH FAILED cre
36660 61 74 69 6e 67 20 25 73 2c 20 22 0a 20 20 20 20 ating %s, ".
36670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36680 20 22 27 25 73 27 20 70 72 6f 78 79 20 6c 6f 63 "'%s' proxy loc
36690 6b 20 70 61 74 68 3d 25 73 20 70 69 64 3d 25 64 k path=%s pid=%d
366a0 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
366b0 20 20 20 20 20 20 20 20 20 20 62 75 66 2c 20 73 buf, s
366c0 74 72 65 72 72 6f 72 28 65 72 72 29 2c 20 6c 6f trerror(err), lo
366d0 63 6b 50 61 74 68 2c 20 6f 73 47 65 74 70 69 64 ckPath, osGetpid
366e0 28 30 29 29 29 3b 0a 20 20 20 20 20 20 20 20 20 (0)));.
366f0 20 20 20 72 65 74 75 72 6e 20 65 72 72 3b 0a 20 return err;.
36700 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
36710 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
36720 20 20 20 73 74 61 72 74 3d 69 2b 31 3b 0a 20 20 start=i+1;.
36730 20 20 7d 0a 20 20 20 20 62 75 66 5b 69 5d 20 3d }. buf[i] =
36740 20 6c 6f 63 6b 50 61 74 68 5b 69 5d 3b 0a 20 20 lockPath[i];.
36750 7d 0a 20 20 4f 53 54 52 41 43 45 28 28 22 43 52 }. OSTRACE(("CR
36760 45 41 54 45 4c 4f 43 4b 50 41 54 48 20 20 70 72 EATELOCKPATH pr
36770 6f 78 79 20 6c 6f 63 6b 20 70 61 74 68 3d 25 73 oxy lock path=%s
36780 20 70 69 64 3d 25 64 5c 6e 22 2c 6c 6f 63 6b 50 pid=%d\n",lockP
36790 61 74 68 2c 6f 73 47 65 74 70 69 64 28 30 29 29 ath,osGetpid(0))
367a0 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d );. return 0;.}
367b0 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 ../*.** Create a
367c0 20 6e 65 77 20 56 46 53 20 66 69 6c 65 20 64 65 new VFS file de
367d0 73 63 72 69 70 74 6f 72 20 28 73 74 6f 72 65 64 scriptor (stored
367e0 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 in memory obtai
367f0 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 73 71 6c 69 ned from.** sqli
36800 74 65 33 5f 6d 61 6c 6c 6f 63 29 20 61 6e 64 20 te3_malloc) and
36810 6f 70 65 6e 20 74 68 65 20 66 69 6c 65 20 6e 61 open the file na
36820 6d 65 64 20 22 70 61 74 68 22 20 69 6e 20 74 68 med "path" in th
36830 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f e file descripto
36840 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c r..**.** The cal
36850 6c 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62 ler is responsib
36860 6c 65 20 6e 6f 74 20 6f 6e 6c 79 20 66 6f 72 20 le not only for
36870 63 6c 6f 73 69 6e 67 20 74 68 65 20 66 69 6c 65 closing the file
36880 20 64 65 73 63 72 69 70 74 6f 72 0a 2a 2a 20 62 descriptor.** b
36890 75 74 20 61 6c 73 6f 20 66 6f 72 20 66 72 65 65 ut also for free
368a0 69 6e 67 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 ing the memory a
368b0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
368c0 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 he file descript
368d0 6f 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e or..*/.static in
368e0 74 20 70 72 6f 78 79 43 72 65 61 74 65 55 6e 69 t proxyCreateUni
368f0 78 46 69 6c 65 28 0a 20 20 20 20 63 6f 6e 73 74 xFile(. const
36900 20 63 68 61 72 20 2a 70 61 74 68 2c 20 20 20 20 char *path,
36910 20 20 20 20 2f 2a 20 70 61 74 68 20 66 6f 72 20 /* path for
36920 74 68 65 20 6e 65 77 20 75 6e 69 78 46 69 6c 65 the new unixFile
36930 20 2a 2f 0a 20 20 20 20 75 6e 69 78 46 69 6c 65 */. unixFile
36940 20 2a 2a 70 70 46 69 6c 65 2c 20 20 20 20 20 20 **ppFile,
36950 20 2f 2a 20 75 6e 69 78 46 69 6c 65 20 63 72 65 /* unixFile cre
36960 61 74 65 64 20 61 6e 64 20 72 65 74 75 72 6e 65 ated and returne
36970 64 20 62 79 20 72 65 66 20 2a 2f 0a 20 20 20 20 d by ref */.
36980 69 6e 74 20 69 73 6c 6f 63 6b 66 69 6c 65 20 20 int islockfile
36990 20 20 20 20 20 20 20 20 20 2f 2a 20 69 66 20 6e /* if n
369a0 6f 6e 20 7a 65 72 6f 20 6d 69 73 73 69 6e 67 20 on zero missing
369b0 64 69 72 73 20 77 69 6c 6c 20 62 65 20 63 72 65 dirs will be cre
369c0 61 74 65 64 20 2a 2f 0a 29 20 7b 0a 20 20 69 6e ated */.) {. in
369d0 74 20 66 64 20 3d 20 2d 31 3b 0a 20 20 75 6e 69 t fd = -1;. uni
369e0 78 46 69 6c 65 20 2a 70 4e 65 77 3b 0a 20 20 69 xFile *pNew;. i
369f0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
36a00 4b 3b 0a 20 20 69 6e 74 20 6f 70 65 6e 46 6c 61 K;. int openFla
36a10 67 73 20 3d 20 4f 5f 52 44 57 52 20 7c 20 4f 5f gs = O_RDWR | O_
36a20 43 52 45 41 54 3b 0a 20 20 73 71 6c 69 74 65 33 CREAT;. sqlite3
36a30 5f 76 66 73 20 64 75 6d 6d 79 56 66 73 3b 0a 20 _vfs dummyVfs;.
36a40 20 69 6e 74 20 74 65 72 72 6e 6f 20 3d 20 30 3b int terrno = 0;
36a50 0a 20 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 . UnixUnusedFd
36a60 2a 70 55 6e 75 73 65 64 20 3d 20 4e 55 4c 4c 3b *pUnused = NULL;
36a70 0a 0a 20 20 2f 2a 20 31 2e 20 66 69 72 73 74 20 .. /* 1. first
36a80 74 72 79 20 74 6f 20 6f 70 65 6e 2f 63 72 65 61 try to open/crea
36a90 74 65 20 74 68 65 20 66 69 6c 65 0a 20 20 2a 2a te the file. **
36aa0 20 32 2e 20 69 66 20 74 68 61 74 20 66 61 69 6c 2. if that fail
36ab0 73 2c 20 61 6e 64 20 74 68 69 73 20 69 73 20 61 s, and this is a
36ac0 20 6c 6f 63 6b 20 66 69 6c 65 20 28 6e 6f 74 2d lock file (not-
36ad0 63 6f 6e 63 68 29 2c 20 74 72 79 20 63 72 65 61 conch), try crea
36ae0 74 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20 70 61 ting. ** the pa
36af0 72 65 6e 74 20 64 69 72 65 63 74 6f 72 69 65 73 rent directories
36b00 20 61 6e 64 20 74 68 65 6e 20 74 72 79 20 61 67 and then try ag
36b10 61 69 6e 2e 0a 20 20 2a 2a 20 33 2e 20 69 66 20 ain.. ** 3. if
36b20 74 68 61 74 20 66 61 69 6c 73 2c 20 74 72 79 20 that fails, try
36b30 74 6f 20 6f 70 65 6e 20 74 68 65 20 66 69 6c 65 to open the file
36b40 20 72 65 61 64 2d 6f 6e 6c 79 0a 20 20 2a 2a 20 read-only. **
36b50 6f 74 68 65 72 77 69 73 65 20 72 65 74 75 72 6e otherwise return
36b60 20 42 55 53 59 20 28 69 66 20 6c 6f 63 6b 20 66 BUSY (if lock f
36b70 69 6c 65 29 20 6f 72 20 43 41 4e 54 4f 50 45 4e ile) or CANTOPEN
36b80 20 66 6f 72 20 74 68 65 20 63 6f 6e 63 68 20 66 for the conch f
36b90 69 6c 65 0a 20 20 2a 2f 0a 20 20 70 55 6e 75 73 ile. */. pUnus
36ba0 65 64 20 3d 20 66 69 6e 64 52 65 75 73 61 62 6c ed = findReusabl
36bb0 65 46 64 28 70 61 74 68 2c 20 6f 70 65 6e 46 6c eFd(path, openFl
36bc0 61 67 73 29 3b 0a 20 20 69 66 28 20 70 55 6e 75 ags);. if( pUnu
36bd0 73 65 64 20 29 7b 0a 20 20 20 20 66 64 20 3d 20 sed ){. fd =
36be0 70 55 6e 75 73 65 64 2d 3e 66 64 3b 0a 20 20 7d pUnused->fd;. }
36bf0 65 6c 73 65 7b 0a 20 20 20 20 70 55 6e 75 73 65 else{. pUnuse
36c00 64 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c d = sqlite3_mall
36c10 6f 63 36 34 28 73 69 7a 65 6f 66 28 2a 70 55 6e oc64(sizeof(*pUn
36c20 75 73 65 64 29 29 3b 0a 20 20 20 20 69 66 28 20 used));. if(
36c30 21 70 55 6e 75 73 65 64 20 29 7b 0a 20 20 20 20 !pUnused ){.
36c40 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
36c50 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
36c60 7d 0a 20 20 7d 0a 20 20 69 66 28 20 66 64 3c 30 }. }. if( fd<0
36c70 20 29 7b 0a 20 20 20 20 66 64 20 3d 20 72 6f 62 ){. fd = rob
36c80 75 73 74 5f 6f 70 65 6e 28 70 61 74 68 2c 20 6f ust_open(path, o
36c90 70 65 6e 46 6c 61 67 73 2c 20 30 29 3b 0a 20 20 penFlags, 0);.
36ca0 20 20 74 65 72 72 6e 6f 20 3d 20 65 72 72 6e 6f terrno = errno
36cb0 3b 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 26 ;. if( fd<0 &
36cc0 26 20 65 72 72 6e 6f 3d 3d 45 4e 4f 45 4e 54 20 & errno==ENOENT
36cd0 26 26 20 69 73 6c 6f 63 6b 66 69 6c 65 20 29 7b && islockfile ){
36ce0 0a 20 20 20 20 20 20 69 66 28 20 70 72 6f 78 79 . if( proxy
36cf0 43 72 65 61 74 65 4c 6f 63 6b 50 61 74 68 28 70 CreateLockPath(p
36d00 61 74 68 29 20 3d 3d 20 53 51 4c 49 54 45 5f 4f ath) == SQLITE_O
36d10 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 66 64 20 K ){. fd
36d20 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 70 61 = robust_open(pa
36d30 74 68 2c 20 6f 70 65 6e 46 6c 61 67 73 2c 20 30 th, openFlags, 0
36d40 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d );. }. }
36d50 0a 20 20 7d 0a 20 20 69 66 28 20 66 64 3c 30 20 . }. if( fd<0
36d60 29 7b 0a 20 20 20 20 6f 70 65 6e 46 6c 61 67 73 ){. openFlags
36d70 20 3d 20 4f 5f 52 44 4f 4e 4c 59 3b 0a 20 20 20 = O_RDONLY;.
36d80 20 66 64 20 3d 20 72 6f 62 75 73 74 5f 6f 70 65 fd = robust_ope
36d90 6e 28 70 61 74 68 2c 20 6f 70 65 6e 46 6c 61 67 n(path, openFlag
36da0 73 2c 20 30 29 3b 0a 20 20 20 20 74 65 72 72 6e s, 0);. terrn
36db0 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 7d 0a 20 o = errno;. }.
36dc0 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 if( fd<0 ){.
36dd0 20 69 66 28 20 69 73 6c 6f 63 6b 66 69 6c 65 20 if( islockfile
36de0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
36df0 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
36e00 20 7d 0a 20 20 20 20 73 77 69 74 63 68 20 28 74 }. switch (t
36e10 65 72 72 6e 6f 29 20 7b 0a 20 20 20 20 20 20 63 errno) {. c
36e20 61 73 65 20 45 41 43 43 45 53 3a 0a 20 20 20 20 ase EACCES:.
36e30 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
36e40 45 5f 50 45 52 4d 3b 0a 20 20 20 20 20 20 63 61 E_PERM;. ca
36e50 73 65 20 45 49 4f 3a 20 0a 20 20 20 20 20 20 20 se EIO: .
36e60 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
36e70 4f 45 52 52 5f 4c 4f 43 4b 3b 20 2f 2a 20 65 76 OERR_LOCK; /* ev
36e80 65 6e 20 74 68 6f 75 67 68 20 69 74 20 69 73 20 en though it is
36e90 74 68 65 20 63 6f 6e 63 68 20 2a 2f 0a 20 20 20 the conch */.
36ea0 20 20 20 64 65 66 61 75 6c 74 3a 0a 20 20 20 20 default:.
36eb0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
36ec0 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 3b E_CANTOPEN_BKPT;
36ed0 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 . }. }. .
36ee0 70 4e 65 77 20 3d 20 28 75 6e 69 78 46 69 6c 65 pNew = (unixFile
36ef0 20 2a 29 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f *)sqlite3_mallo
36f00 63 36 34 28 73 69 7a 65 6f 66 28 2a 70 4e 65 77 c64(sizeof(*pNew
36f10 29 29 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d ));. if( pNew==
36f20 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 72 63 20 3d NULL ){. rc =
36f30 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
36f40 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 PT;. goto end
36f50 5f 63 72 65 61 74 65 5f 70 72 6f 78 79 3b 0a 20 _create_proxy;.
36f60 20 7d 0a 20 20 6d 65 6d 73 65 74 28 70 4e 65 77 }. memset(pNew
36f70 2c 20 30 2c 20 73 69 7a 65 6f 66 28 75 6e 69 78 , 0, sizeof(unix
36f80 46 69 6c 65 29 29 3b 0a 20 20 70 4e 65 77 2d 3e File));. pNew->
36f90 6f 70 65 6e 46 6c 61 67 73 20 3d 20 6f 70 65 6e openFlags = open
36fa0 46 6c 61 67 73 3b 0a 20 20 6d 65 6d 73 65 74 28 Flags;. memset(
36fb0 26 64 75 6d 6d 79 56 66 73 2c 20 30 2c 20 73 69 &dummyVfs, 0, si
36fc0 7a 65 6f 66 28 64 75 6d 6d 79 56 66 73 29 29 3b zeof(dummyVfs));
36fd0 0a 20 20 64 75 6d 6d 79 56 66 73 2e 70 41 70 70 . dummyVfs.pApp
36fe0 44 61 74 61 20 3d 20 28 76 6f 69 64 2a 29 26 61 Data = (void*)&a
36ff0 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 3b utolockIoFinder;
37000 0a 20 20 64 75 6d 6d 79 56 66 73 2e 7a 4e 61 6d . dummyVfs.zNam
37010 65 20 3d 20 22 64 75 6d 6d 79 22 3b 0a 20 20 70 e = "dummy";. p
37020 55 6e 75 73 65 64 2d 3e 66 64 20 3d 20 66 64 3b Unused->fd = fd;
37030 0a 20 20 70 55 6e 75 73 65 64 2d 3e 66 6c 61 67 . pUnused->flag
37040 73 20 3d 20 6f 70 65 6e 46 6c 61 67 73 3b 0a 20 s = openFlags;.
37050 20 70 4e 65 77 2d 3e 70 55 6e 75 73 65 64 20 3d pNew->pUnused =
37060 20 70 55 6e 75 73 65 64 3b 0a 20 20 0a 20 20 72 pUnused;. . r
37070 63 20 3d 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 c = fillInUnixFi
37080 6c 65 28 26 64 75 6d 6d 79 56 66 73 2c 20 66 64 le(&dummyVfs, fd
37090 2c 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a , (sqlite3_file*
370a0 29 70 4e 65 77 2c 20 70 61 74 68 2c 20 30 29 3b )pNew, path, 0);
370b0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
370c0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 70 46 E_OK ){. *ppF
370d0 69 6c 65 20 3d 20 70 4e 65 77 3b 0a 20 20 20 20 ile = pNew;.
370e0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
370f0 3b 0a 20 20 7d 0a 65 6e 64 5f 63 72 65 61 74 65 ;. }.end_create
37100 5f 70 72 6f 78 79 3a 20 20 20 20 0a 20 20 72 6f _proxy: . ro
37110 62 75 73 74 5f 63 6c 6f 73 65 28 70 4e 65 77 2c bust_close(pNew,
37120 20 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a fd, __LINE__);.
37130 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
37140 4e 65 77 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f New);. sqlite3_
37150 66 72 65 65 28 70 55 6e 75 73 65 64 29 3b 0a 20 free(pUnused);.
37160 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 return rc;.}..#
37170 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 ifdef SQLITE_TES
37180 54 0a 2f 2a 20 73 69 6d 75 6c 61 74 65 20 6d 75 T./* simulate mu
37190 6c 74 69 70 6c 65 20 68 6f 73 74 73 20 62 79 20 ltiple hosts by
371a0 63 72 65 61 74 69 6e 67 20 75 6e 69 71 75 65 20 creating unique
371b0 68 6f 73 74 69 64 20 66 69 6c 65 20 70 61 74 68 hostid file path
371c0 73 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 s */.int sqlite3
371d0 5f 68 6f 73 74 69 64 5f 6e 75 6d 20 3d 20 30 3b _hostid_num = 0;
371e0 0a 23 65 6e 64 69 66 0a 0a 23 64 65 66 69 6e 65 .#endif..#define
371f0 20 50 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 4e PROXY_HOSTIDLEN
37200 20 20 20 20 31 36 20 20 2f 2a 20 63 6f 6e 63 68 16 /* conch
37210 20 66 69 6c 65 20 68 6f 73 74 20 69 64 20 6c 65 file host id le
37220 6e 67 74 68 20 2a 2f 0a 0a 23 69 66 64 65 66 20 ngth */..#ifdef
37230 48 41 56 45 5f 47 45 54 48 4f 53 54 55 55 49 44 HAVE_GETHOSTUUID
37240 0a 2f 2a 20 4e 6f 74 20 61 6c 77 61 79 73 20 64 ./* Not always d
37250 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 68 65 efined in the he
37260 61 64 65 72 73 20 61 73 20 69 74 20 6f 75 67 68 aders as it ough
37270 74 20 74 6f 20 62 65 20 2a 2f 0a 65 78 74 65 72 t to be */.exter
37280 6e 20 69 6e 74 20 67 65 74 68 6f 73 74 75 75 69 n int gethostuui
37290 64 28 75 75 69 64 5f 74 20 69 64 2c 20 63 6f 6e d(uuid_t id, con
372a0 73 74 20 73 74 72 75 63 74 20 74 69 6d 65 73 70 st struct timesp
372b0 65 63 20 2a 77 61 69 74 29 3b 0a 23 65 6e 64 69 ec *wait);.#endi
372c0 66 0a 0a 2f 2a 20 67 65 74 20 74 68 65 20 68 6f f../* get the ho
372d0 73 74 20 49 44 20 76 69 61 20 67 65 74 68 6f 73 st ID via gethos
372e0 74 75 75 69 64 28 29 2c 20 70 48 6f 73 74 49 44 tuuid(), pHostID
372f0 20 6d 75 73 74 20 70 6f 69 6e 74 20 74 6f 20 50 must point to P
37300 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 4e 20 0a ROXY_HOSTIDLEN .
37310 2a 2a 20 62 79 74 65 73 20 6f 66 20 77 72 69 74 ** bytes of writ
37320 61 62 6c 65 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a able memory..*/.
37330 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78 79 static int proxy
37340 47 65 74 48 6f 73 74 49 44 28 75 6e 73 69 67 6e GetHostID(unsign
37350 65 64 20 63 68 61 72 20 2a 70 48 6f 73 74 49 44 ed char *pHostID
37360 2c 20 69 6e 74 20 2a 70 45 72 72 6f 72 29 7b 0a , int *pError){.
37370 20 20 61 73 73 65 72 74 28 50 52 4f 58 59 5f 48 assert(PROXY_H
37380 4f 53 54 49 44 4c 45 4e 20 3d 3d 20 73 69 7a 65 OSTIDLEN == size
37390 6f 66 28 75 75 69 64 5f 74 29 29 3b 0a 20 20 6d of(uuid_t));. m
373a0 65 6d 73 65 74 28 70 48 6f 73 74 49 44 2c 20 30 emset(pHostID, 0
373b0 2c 20 50 52 4f 58 59 5f 48 4f 53 54 49 44 4c 45 , PROXY_HOSTIDLE
373c0 4e 29 3b 0a 23 69 66 64 65 66 20 48 41 56 45 5f N);.#ifdef HAVE_
373d0 47 45 54 48 4f 53 54 55 55 49 44 0a 20 20 7b 0a GETHOSTUUID. {.
373e0 20 20 20 20 73 74 72 75 63 74 20 74 69 6d 65 73 struct times
373f0 70 65 63 20 74 69 6d 65 6f 75 74 20 3d 20 7b 31 pec timeout = {1
37400 2c 20 30 7d 3b 20 2f 2a 20 31 20 73 65 63 20 74 , 0}; /* 1 sec t
37410 69 6d 65 6f 75 74 20 2a 2f 0a 20 20 20 20 69 66 imeout */. if
37420 28 20 67 65 74 68 6f 73 74 75 75 69 64 28 70 48 ( gethostuuid(pH
37430 6f 73 74 49 44 2c 20 26 74 69 6d 65 6f 75 74 29 ostID, &timeout)
37440 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 65 72 ){. int er
37450 72 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 r = errno;.
37460 20 69 66 28 20 70 45 72 72 6f 72 20 29 7b 0a 20 if( pError ){.
37470 20 20 20 20 20 20 20 2a 70 45 72 72 6f 72 20 3d *pError =
37480 20 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 err;. }.
37490 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
374a0 45 5f 49 4f 45 52 52 3b 0a 20 20 20 20 7d 0a 20 E_IOERR;. }.
374b0 20 7d 0a 23 65 6c 73 65 0a 20 20 55 4e 55 53 45 }.#else. UNUSE
374c0 44 5f 50 41 52 41 4d 45 54 45 52 28 70 45 72 72 D_PARAMETER(pErr
374d0 6f 72 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 64 or);.#endif.#ifd
374e0 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 ef SQLITE_TEST.
374f0 20 2f 2a 20 73 69 6d 75 6c 61 74 65 20 6d 75 6c /* simulate mul
37500 74 69 70 6c 65 20 68 6f 73 74 73 20 62 79 20 63 tiple hosts by c
37510 72 65 61 74 69 6e 67 20 75 6e 69 71 75 65 20 68 reating unique h
37520 6f 73 74 69 64 20 66 69 6c 65 20 70 61 74 68 73 ostid file paths
37530 20 2a 2f 0a 20 20 69 66 28 20 73 71 6c 69 74 65 */. if( sqlite
37540 33 5f 68 6f 73 74 69 64 5f 6e 75 6d 20 21 3d 20 3_hostid_num !=
37550 30 29 7b 0a 20 20 20 20 70 48 6f 73 74 49 44 5b 0){. pHostID[
37560 30 5d 20 3d 20 28 63 68 61 72 29 28 70 48 6f 73 0] = (char)(pHos
37570 74 49 44 5b 30 5d 20 2b 20 28 63 68 61 72 29 28 tID[0] + (char)(
37580 73 71 6c 69 74 65 33 5f 68 6f 73 74 69 64 5f 6e sqlite3_hostid_n
37590 75 6d 20 26 20 30 78 46 46 29 29 3b 0a 20 20 7d um & 0xFF));. }
375a0 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 72 65 74 .#endif. . ret
375b0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
375c0 0a 0a 2f 2a 20 54 68 65 20 63 6f 6e 63 68 20 66 ../* The conch f
375d0 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 ile contains the
375e0 20 68 65 61 64 65 72 2c 20 68 6f 73 74 20 69 64 header, host id
375f0 20 61 6e 64 20 6c 6f 63 6b 20 66 69 6c 65 20 70 and lock file p
37600 61 74 68 0a 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ath. */.#define
37610 50 52 4f 58 59 5f 43 4f 4e 43 48 56 45 52 53 49 PROXY_CONCHVERSI
37620 4f 4e 20 32 20 20 20 2f 2a 20 31 2d 62 79 74 65 ON 2 /* 1-byte
37630 20 68 65 61 64 65 72 2c 20 31 36 2d 62 79 74 65 header, 16-byte
37640 20 68 6f 73 74 20 69 64 2c 20 70 61 74 68 20 2a host id, path *
37650 2f 0a 23 64 65 66 69 6e 65 20 50 52 4f 58 59 5f /.#define PROXY_
37660 48 45 41 44 45 52 4c 45 4e 20 20 20 20 31 20 20 HEADERLEN 1
37670 20 2f 2a 20 63 6f 6e 63 68 20 66 69 6c 65 20 68 /* conch file h
37680 65 61 64 65 72 20 6c 65 6e 67 74 68 20 2a 2f 0a eader length */.
37690 23 64 65 66 69 6e 65 20 50 52 4f 58 59 5f 50 41 #define PROXY_PA
376a0 54 48 49 4e 44 45 58 20 20 20 20 28 50 52 4f 58 THINDEX (PROX
376b0 59 5f 48 45 41 44 45 52 4c 45 4e 2b 50 52 4f 58 Y_HEADERLEN+PROX
376c0 59 5f 48 4f 53 54 49 44 4c 45 4e 29 0a 23 64 65 Y_HOSTIDLEN).#de
376d0 66 69 6e 65 20 50 52 4f 58 59 5f 4d 41 58 43 4f fine PROXY_MAXCO
376e0 4e 43 48 4c 45 4e 20 20 28 50 52 4f 58 59 5f 48 NCHLEN (PROXY_H
376f0 45 41 44 45 52 4c 45 4e 2b 50 52 4f 58 59 5f 48 EADERLEN+PROXY_H
37700 4f 53 54 49 44 4c 45 4e 2b 4d 41 58 50 41 54 48 OSTIDLEN+MAXPATH
37710 4c 45 4e 29 0a 0a 2f 2a 20 0a 2a 2a 20 54 61 6b LEN)../* .** Tak
37720 65 73 20 61 6e 20 6f 70 65 6e 20 63 6f 6e 63 68 es an open conch
37730 20 66 69 6c 65 2c 20 63 6f 70 69 65 73 20 74 68 file, copies th
37740 65 20 63 6f 6e 74 65 6e 74 73 20 74 6f 20 61 20 e contents to a
37750 6e 65 77 20 70 61 74 68 20 61 6e 64 20 74 68 65 new path and the
37760 6e 20 6d 6f 76 65 73 20 0a 2a 2a 20 69 74 20 62 n moves .** it b
37770 61 63 6b 2e 20 20 54 68 65 20 6e 65 77 6c 79 20 ack. The newly
37780 63 72 65 61 74 65 64 20 66 69 6c 65 27 73 20 66 created file's f
37790 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 ile descriptor i
377a0 73 20 61 73 73 69 67 6e 65 64 20 74 6f 20 74 68 s assigned to th
377b0 65 0a 2a 2a 20 63 6f 6e 63 68 20 66 69 6c 65 20 e.** conch file
377c0 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 66 69 structure and fi
377d0 6e 61 6c 6c 79 20 74 68 65 20 6f 72 69 67 69 6e nally the origin
377e0 61 6c 20 63 6f 6e 63 68 20 66 69 6c 65 20 64 65 al conch file de
377f0 73 63 72 69 70 74 6f 72 20 69 73 20 0a 2a 2a 20 scriptor is .**
37800 63 6c 6f 73 65 64 2e 20 20 52 65 74 75 72 6e 73 closed. Returns
37810 20 7a 65 72 6f 20 69 66 20 73 75 63 63 65 73 73 zero if success
37820 66 75 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ful..*/.static i
37830 6e 74 20 70 72 6f 78 79 42 72 65 61 6b 43 6f 6e nt proxyBreakCon
37840 63 68 4c 6f 63 6b 28 75 6e 69 78 46 69 6c 65 20 chLock(unixFile
37850 2a 70 46 69 6c 65 2c 20 75 75 69 64 5f 74 20 6d *pFile, uuid_t m
37860 79 48 6f 73 74 49 44 29 7b 0a 20 20 70 72 6f 78 yHostID){. prox
37870 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 yLockingContext
37880 2a 70 43 74 78 20 3d 20 28 70 72 6f 78 79 4c 6f *pCtx = (proxyLo
37890 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 70 ckingContext *)p
378a0 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e File->lockingCon
378b0 74 65 78 74 3b 20 0a 20 20 75 6e 69 78 46 69 6c text; . unixFil
378c0 65 20 2a 63 6f 6e 63 68 46 69 6c 65 20 3d 20 70 e *conchFile = p
378d0 43 74 78 2d 3e 63 6f 6e 63 68 46 69 6c 65 3b 0a Ctx->conchFile;.
378e0 20 20 63 68 61 72 20 74 50 61 74 68 5b 4d 41 58 char tPath[MAX
378f0 50 41 54 48 4c 45 4e 5d 3b 0a 20 20 63 68 61 72 PATHLEN];. char
37900 20 62 75 66 5b 50 52 4f 58 59 5f 4d 41 58 43 4f buf[PROXY_MAXCO
37910 4e 43 48 4c 45 4e 5d 3b 0a 20 20 63 68 61 72 20 NCHLEN];. char
37920 2a 63 50 61 74 68 20 3d 20 70 43 74 78 2d 3e 63 *cPath = pCtx->c
37930 6f 6e 63 68 46 69 6c 65 50 61 74 68 3b 0a 20 20 onchFilePath;.
37940 73 69 7a 65 5f 74 20 72 65 61 64 4c 65 6e 20 3d size_t readLen =
37950 20 30 3b 0a 20 20 73 69 7a 65 5f 74 20 70 61 74 0;. size_t pat
37960 68 4c 65 6e 20 3d 20 30 3b 0a 20 20 63 68 61 72 hLen = 0;. char
37970 20 65 72 72 6d 73 67 5b 36 34 5d 20 3d 20 22 22 errmsg[64] = ""
37980 3b 0a 20 20 69 6e 74 20 66 64 20 3d 20 2d 31 3b ;. int fd = -1;
37990 0a 20 20 69 6e 74 20 72 63 20 3d 20 2d 31 3b 0a . int rc = -1;.
379a0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
379b0 45 52 28 6d 79 48 6f 73 74 49 44 29 3b 0a 0a 20 ER(myHostID);..
379c0 20 2f 2a 20 63 72 65 61 74 65 20 61 20 6e 65 77 /* create a new
379d0 20 70 61 74 68 20 62 79 20 72 65 70 6c 61 63 65 path by replace
379e0 20 74 68 65 20 74 72 61 69 6c 69 6e 67 20 27 2d the trailing '-
379f0 63 6f 6e 63 68 27 20 77 69 74 68 20 27 2d 62 72 conch' with '-br
37a00 65 61 6b 27 20 2a 2f 0a 20 20 70 61 74 68 4c 65 eak' */. pathLe
37a10 6e 20 3d 20 73 74 72 6c 63 70 79 28 74 50 61 74 n = strlcpy(tPat
37a20 68 2c 20 63 50 61 74 68 2c 20 4d 41 58 50 41 54 h, cPath, MAXPAT
37a30 48 4c 45 4e 29 3b 0a 20 20 69 66 28 20 70 61 74 HLEN);. if( pat
37a40 68 4c 65 6e 3e 4d 41 58 50 41 54 48 4c 45 4e 20 hLen>MAXPATHLEN
37a50 7c 7c 20 70 61 74 68 4c 65 6e 3c 36 20 7c 7c 20 || pathLen<6 ||
37a60 0a 20 20 20 20 20 28 73 74 72 6c 63 70 79 28 26 . (strlcpy(&
37a70 74 50 61 74 68 5b 70 61 74 68 4c 65 6e 2d 35 5d tPath[pathLen-5]
37a80 2c 20 22 62 72 65 61 6b 22 2c 20 36 29 20 21 3d , "break", 6) !=
37a90 20 35 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 5) ){. sqlit
37aa0 65 33 5f 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 e3_snprintf(size
37ab0 6f 66 28 65 72 72 6d 73 67 29 2c 65 72 72 6d 73 of(errmsg),errms
37ac0 67 2c 22 70 61 74 68 20 65 72 72 6f 72 20 28 6c g,"path error (l
37ad0 65 6e 20 25 64 29 22 2c 28 69 6e 74 29 70 61 74 en %d)",(int)pat
37ae0 68 4c 65 6e 29 3b 0a 20 20 20 20 67 6f 74 6f 20 hLen);. goto
37af0 65 6e 64 5f 62 72 65 61 6b 6c 6f 63 6b 3b 0a 20 end_breaklock;.
37b00 20 7d 0a 20 20 2f 2a 20 72 65 61 64 20 74 68 65 }. /* read the
37b10 20 63 6f 6e 63 68 20 63 6f 6e 74 65 6e 74 20 2a conch content *
37b20 2f 0a 20 20 72 65 61 64 4c 65 6e 20 3d 20 6f 73 /. readLen = os
37b30 50 72 65 61 64 28 63 6f 6e 63 68 46 69 6c 65 2d Pread(conchFile-
37b40 3e 68 2c 20 62 75 66 2c 20 50 52 4f 58 59 5f 4d >h, buf, PROXY_M
37b50 41 58 43 4f 4e 43 48 4c 45 4e 2c 20 30 29 3b 0a AXCONCHLEN, 0);.
37b60 20 20 69 66 28 20 72 65 61 64 4c 65 6e 3c 50 52 if( readLen<PR
37b70 4f 58 59 5f 50 41 54 48 49 4e 44 45 58 20 29 7b OXY_PATHINDEX ){
37b80 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 . sqlite3_snp
37b90 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 65 72 72 rintf(sizeof(err
37ba0 6d 73 67 29 2c 65 72 72 6d 73 67 2c 22 72 65 61 msg),errmsg,"rea
37bb0 64 20 65 72 72 6f 72 20 28 6c 65 6e 20 25 64 29 d error (len %d)
37bc0 22 2c 28 69 6e 74 29 72 65 61 64 4c 65 6e 29 3b ",(int)readLen);
37bd0 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 62 72 . goto end_br
37be0 65 61 6b 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 2f eaklock;. }. /
37bf0 2a 20 77 72 69 74 65 20 69 74 20 6f 75 74 20 74 * write it out t
37c00 6f 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 o the temporary
37c10 62 72 65 61 6b 20 66 69 6c 65 20 2a 2f 0a 20 20 break file */.
37c20 66 64 20 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e fd = robust_open
37c30 28 74 50 61 74 68 2c 20 28 4f 5f 52 44 57 52 7c (tPath, (O_RDWR|
37c40 4f 5f 43 52 45 41 54 7c 4f 5f 45 58 43 4c 29 2c O_CREAT|O_EXCL),
37c50 20 30 29 3b 0a 20 20 69 66 28 20 66 64 3c 30 20 0);. if( fd<0
37c60 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 ){. sqlite3_s
37c70 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 28 65 nprintf(sizeof(e
37c80 72 72 6d 73 67 29 2c 20 65 72 72 6d 73 67 2c 20 rrmsg), errmsg,
37c90 22 63 72 65 61 74 65 20 66 61 69 6c 65 64 20 28 "create failed (
37ca0 25 64 29 22 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 %d)", errno);.
37cb0 20 20 67 6f 74 6f 20 65 6e 64 5f 62 72 65 61 6b goto end_break
37cc0 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 lock;. }. if(
37cd0 6f 73 50 77 72 69 74 65 28 66 64 2c 20 62 75 66 osPwrite(fd, buf
37ce0 2c 20 72 65 61 64 4c 65 6e 2c 20 30 29 20 21 3d , readLen, 0) !=
37cf0 20 28 73 73 69 7a 65 5f 74 29 72 65 61 64 4c 65 (ssize_t)readLe
37d00 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 n ){. sqlite3
37d10 5f 73 6e 70 72 69 6e 74 66 28 73 69 7a 65 6f 66 _snprintf(sizeof
37d20 28 65 72 72 6d 73 67 29 2c 20 65 72 72 6d 73 67 (errmsg), errmsg
37d30 2c 20 22 77 72 69 74 65 20 66 61 69 6c 65 64 20 , "write failed
37d40 28 25 64 29 22 2c 20 65 72 72 6e 6f 29 3b 0a 20 (%d)", errno);.
37d50 20 20 20 67 6f 74 6f 20 65 6e 64 5f 62 72 65 61 goto end_brea
37d60 6b 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 69 66 28 klock;. }. if(
37d70 20 72 65 6e 61 6d 65 28 74 50 61 74 68 2c 20 63 rename(tPath, c
37d80 50 61 74 68 29 20 29 7b 0a 20 20 20 20 73 71 6c Path) ){. sql
37d90 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 73 69 ite3_snprintf(si
37da0 7a 65 6f 66 28 65 72 72 6d 73 67 29 2c 20 65 72 zeof(errmsg), er
37db0 72 6d 73 67 2c 20 22 72 65 6e 61 6d 65 20 66 61 rmsg, "rename fa
37dc0 69 6c 65 64 20 28 25 64 29 22 2c 20 65 72 72 6e iled (%d)", errn
37dd0 6f 29 3b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 o);. goto end
37de0 5f 62 72 65 61 6b 6c 6f 63 6b 3b 0a 20 20 7d 0a _breaklock;. }.
37df0 20 20 72 63 20 3d 20 30 3b 0a 20 20 66 70 72 69 rc = 0;. fpri
37e00 6e 74 66 28 73 74 64 65 72 72 2c 20 22 62 72 6f ntf(stderr, "bro
37e10 6b 65 20 73 74 61 6c 65 20 6c 6f 63 6b 20 6f 6e ke stale lock on
37e20 20 25 73 5c 6e 22 2c 20 63 50 61 74 68 29 3b 0a %s\n", cPath);.
37e30 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 robust_close(p
37e40 46 69 6c 65 2c 20 63 6f 6e 63 68 46 69 6c 65 2d File, conchFile-
37e50 3e 68 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 >h, __LINE__);.
37e60 20 63 6f 6e 63 68 46 69 6c 65 2d 3e 68 20 3d 20 conchFile->h =
37e70 66 64 3b 0a 20 20 63 6f 6e 63 68 46 69 6c 65 2d fd;. conchFile-
37e80 3e 6f 70 65 6e 46 6c 61 67 73 20 3d 20 4f 5f 52 >openFlags = O_R
37e90 44 57 52 20 7c 20 4f 5f 43 52 45 41 54 3b 0a 0a DWR | O_CREAT;..
37ea0 65 6e 64 5f 62 72 65 61 6b 6c 6f 63 6b 3a 0a 20 end_breaklock:.
37eb0 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 69 if( rc ){. i
37ec0 66 28 20 66 64 3e 3d 30 20 29 7b 0a 20 20 20 20 f( fd>=0 ){.
37ed0 20 20 6f 73 55 6e 6c 69 6e 6b 28 74 50 61 74 68 osUnlink(tPath
37ee0 29 3b 0a 20 20 20 20 20 20 72 6f 62 75 73 74 5f );. robust_
37ef0 63 6c 6f 73 65 28 70 46 69 6c 65 2c 20 66 64 2c close(pFile, fd,
37f00 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 __LINE__);.
37f10 7d 0a 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 }. fprintf(st
37f20 64 65 72 72 2c 20 22 66 61 69 6c 65 64 20 74 6f derr, "failed to
37f30 20 62 72 65 61 6b 20 73 74 61 6c 65 20 6c 6f 63 break stale loc
37f40 6b 20 6f 6e 20 25 73 2c 20 25 73 5c 6e 22 2c 20 k on %s, %s\n",
37f50 63 50 61 74 68 2c 20 65 72 72 6d 73 67 29 3b 0a cPath, errmsg);.
37f60 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
37f70 0a 7d 0a 0a 2f 2a 20 54 61 6b 65 20 74 68 65 20 .}../* Take the
37f80 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 6f requested lock o
37f90 6e 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 n the conch file
37fa0 20 61 6e 64 20 62 72 65 61 6b 20 61 20 73 74 61 and break a sta
37fb0 6c 65 20 6c 6f 63 6b 20 69 66 20 74 68 65 20 0a le lock if the .
37fc0 2a 2a 20 68 6f 73 74 20 69 64 20 6d 61 74 63 68 ** host id match
37fd0 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e es..*/.static in
37fe0 74 20 70 72 6f 78 79 43 6f 6e 63 68 4c 6f 63 6b t proxyConchLock
37ff0 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 (unixFile *pFile
38000 2c 20 75 75 69 64 5f 74 20 6d 79 48 6f 73 74 49 , uuid_t myHostI
38010 44 2c 20 69 6e 74 20 6c 6f 63 6b 54 79 70 65 29 D, int lockType)
38020 7b 0a 20 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 {. proxyLocking
38030 43 6f 6e 74 65 78 74 20 2a 70 43 74 78 20 3d 20 Context *pCtx =
38040 28 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e (proxyLockingCon
38050 74 65 78 74 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f text *)pFile->lo
38060 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 20 0a 20 ckingContext; .
38070 20 75 6e 69 78 46 69 6c 65 20 2a 63 6f 6e 63 68 unixFile *conch
38080 46 69 6c 65 20 3d 20 70 43 74 78 2d 3e 63 6f 6e File = pCtx->con
38090 63 68 46 69 6c 65 3b 0a 20 20 69 6e 74 20 72 63 chFile;. int rc
380a0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
380b0 69 6e 74 20 6e 54 72 69 65 73 20 3d 20 30 3b 0a int nTries = 0;.
380c0 20 20 73 74 72 75 63 74 20 74 69 6d 65 73 70 65 struct timespe
380d0 63 20 63 6f 6e 63 68 4d 6f 64 54 69 6d 65 3b 0a c conchModTime;.
380e0 20 20 0a 20 20 6d 65 6d 73 65 74 28 26 63 6f 6e . memset(&con
380f0 63 68 4d 6f 64 54 69 6d 65 2c 20 30 2c 20 73 69 chModTime, 0, si
38100 7a 65 6f 66 28 63 6f 6e 63 68 4d 6f 64 54 69 6d zeof(conchModTim
38110 65 29 29 3b 0a 20 20 64 6f 20 7b 0a 20 20 20 20 e));. do {.
38120 72 63 20 3d 20 63 6f 6e 63 68 46 69 6c 65 2d 3e rc = conchFile->
38130 70 4d 65 74 68 6f 64 2d 3e 78 4c 6f 63 6b 28 28 pMethod->xLock((
38140 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 63 6f sqlite3_file*)co
38150 6e 63 68 46 69 6c 65 2c 20 6c 6f 63 6b 54 79 70 nchFile, lockTyp
38160 65 29 3b 0a 20 20 20 20 6e 54 72 69 65 73 20 2b e);. nTries +
38170 2b 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 +;. if( rc==S
38180 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 QLITE_BUSY ){.
38190 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6c 6f /* If the lo
381a0 63 6b 20 66 61 69 6c 65 64 20 28 62 75 73 79 29 ck failed (busy)
381b0 3a 0a 20 20 20 20 20 20 20 2a 20 31 73 74 20 74 :. * 1st t
381c0 72 79 3a 20 67 65 74 20 74 68 65 20 6d 6f 64 20 ry: get the mod
381d0 74 69 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 63 time of the conc
381e0 68 2c 20 77 61 69 74 20 30 2e 35 73 20 61 6e 64 h, wait 0.5s and
381f0 20 74 72 79 20 61 67 61 69 6e 2e 20 0a 20 20 20 try again. .
38200 20 20 20 20 2a 20 32 6e 64 20 74 72 79 3a 20 66 * 2nd try: f
38210 61 69 6c 20 69 66 20 74 68 65 20 6d 6f 64 20 74 ail if the mod t
38220 69 6d 65 20 63 68 61 6e 67 65 64 20 6f 72 20 68 ime changed or h
38230 6f 73 74 20 69 64 20 69 73 20 64 69 66 66 65 72 ost id is differ
38240 65 6e 74 2c 20 77 61 69 74 20 0a 20 20 20 20 20 ent, wait .
38250 20 20 2a 20 20 20 20 20 20 20 20 20 20 20 31 30 * 10
38260 20 73 65 63 20 61 6e 64 20 74 72 79 20 61 67 61 sec and try aga
38270 69 6e 0a 20 20 20 20 20 20 20 2a 20 33 72 64 20 in. * 3rd
38280 74 72 79 3a 20 62 72 65 61 6b 20 74 68 65 20 6c try: break the l
38290 6f 63 6b 20 75 6e 6c 65 73 73 20 74 68 65 20 6d ock unless the m
382a0 6f 64 20 74 69 6d 65 20 68 61 73 20 63 68 61 6e od time has chan
382b0 67 65 64 2e 0a 20 20 20 20 20 20 20 2a 2f 0a 20 ged.. */.
382c0 20 20 20 20 20 73 74 72 75 63 74 20 73 74 61 74 struct stat
382d0 20 62 75 66 3b 0a 20 20 20 20 20 20 69 66 28 20 buf;. if(
382e0 6f 73 46 73 74 61 74 28 63 6f 6e 63 68 46 69 6c osFstat(conchFil
382f0 65 2d 3e 68 2c 20 26 62 75 66 29 20 29 7b 0a 20 e->h, &buf) ){.
38300 20 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 storeLast
38310 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72 Errno(pFile, err
38320 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 no);. ret
38330 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
38340 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 _LOCK;. }.
38350 20 20 20 20 20 0a 20 20 20 20 20 20 69 66 28 20 . if(
38360 6e 54 72 69 65 73 3d 3d 31 20 29 7b 0a 20 20 20 nTries==1 ){.
38370 20 20 20 20 20 63 6f 6e 63 68 4d 6f 64 54 69 6d conchModTim
38380 65 20 3d 20 62 75 66 2e 73 74 5f 6d 74 69 6d 65 e = buf.st_mtime
38390 73 70 65 63 3b 0a 20 20 20 20 20 20 20 20 75 73 spec;. us
383a0 6c 65 65 70 28 35 30 30 30 30 30 29 3b 20 2f 2a leep(500000); /*
383b0 20 77 61 69 74 20 30 2e 35 20 73 65 63 20 61 6e wait 0.5 sec an
383c0 64 20 74 72 79 20 74 68 65 20 6c 6f 63 6b 20 61 d try the lock a
383d0 67 61 69 6e 2a 2f 0a 20 20 20 20 20 20 20 20 63 gain*/. c
383e0 6f 6e 74 69 6e 75 65 3b 20 20 0a 20 20 20 20 20 ontinue; .
383f0 20 7d 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 }.. assert
38400 28 20 6e 54 72 69 65 73 3e 31 20 29 3b 0a 20 20 ( nTries>1 );.
38410 20 20 20 20 69 66 28 20 63 6f 6e 63 68 4d 6f 64 if( conchMod
38420 54 69 6d 65 2e 74 76 5f 73 65 63 20 21 3d 20 62 Time.tv_sec != b
38430 75 66 2e 73 74 5f 6d 74 69 6d 65 73 70 65 63 2e uf.st_mtimespec.
38440 74 76 5f 73 65 63 20 7c 7c 20 0a 20 20 20 20 20 tv_sec || .
38450 20 20 20 20 63 6f 6e 63 68 4d 6f 64 54 69 6d 65 conchModTime
38460 2e 74 76 5f 6e 73 65 63 20 21 3d 20 62 75 66 2e .tv_nsec != buf.
38470 73 74 5f 6d 74 69 6d 65 73 70 65 63 2e 74 76 5f st_mtimespec.tv_
38480 6e 73 65 63 20 29 7b 0a 20 20 20 20 20 20 20 20 nsec ){.
38490 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 return SQLITE_BU
384a0 53 59 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 SY;. }.
384b0 20 20 0a 20 20 20 20 20 20 69 66 28 20 6e 54 72 . if( nTr
384c0 69 65 73 3d 3d 32 20 29 7b 20 20 0a 20 20 20 20 ies==2 ){ .
384d0 20 20 20 20 63 68 61 72 20 74 42 75 66 5b 50 52 char tBuf[PR
384e0 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 4e 5d OXY_MAXCONCHLEN]
384f0 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6c 65 ;. int le
38500 6e 20 3d 20 6f 73 50 72 65 61 64 28 63 6f 6e 63 n = osPread(conc
38510 68 46 69 6c 65 2d 3e 68 2c 20 74 42 75 66 2c 20 hFile->h, tBuf,
38520 50 52 4f 58 59 5f 4d 41 58 43 4f 4e 43 48 4c 45 PROXY_MAXCONCHLE
38530 4e 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 69 N, 0);. i
38540 66 28 20 6c 65 6e 3c 30 20 29 7b 0a 20 20 20 20 f( len<0 ){.
38550 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 storeLastE
38560 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72 6e rrno(pFile, errn
38570 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65 o);. re
38580 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 turn SQLITE_IOER
38590 52 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 2