/ Hex Artifact Content
Login

Artifact d483d738183c822cc96ec5539424eee5b9847c882dee57f93b880aaf46a7af19:


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 73 79  .h>.#include <sy
0ce0: 73 2f 69 6f 63 74 6c 2e 68 3e 0a 23 69 6e 63 6c  s/ioctl.h>.#incl
0cf0: 75 64 65 20 3c 75 6e 69 73 74 64 2e 68 3e 0a 23  ude <unistd.h>.#
0d00: 69 6e 63 6c 75 64 65 20 3c 74 69 6d 65 2e 68 3e  include <time.h>
0d10: 0a 23 69 6e 63 6c 75 64 65 20 3c 73 79 73 2f 74  .#include <sys/t
0d20: 69 6d 65 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  ime.h>.#include 
0d30: 3c 65 72 72 6e 6f 2e 68 3e 0a 23 69 66 20 21 64  <errno.h>.#if !d
0d40: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d  efined(SQLITE_OM
0d50: 49 54 5f 57 41 4c 29 20 7c 7c 20 53 51 4c 49 54  IT_WAL) || SQLIT
0d60: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e  E_MAX_MMAP_SIZE>
0d70: 30 0a 23 20 69 6e 63 6c 75 64 65 20 3c 73 79 73  0.# include <sys
0d80: 2f 6d 6d 61 6e 2e 68 3e 0a 23 65 6e 64 69 66 0a  /mman.h>.#endif.
0d90: 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  .#if SQLITE_ENAB
0da0: 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45  LE_LOCKING_STYLE
0db0: 0a 23 20 69 6e 63 6c 75 64 65 20 3c 73 79 73 2f  .# include <sys/
0dc0: 69 6f 63 74 6c 2e 68 3e 0a 23 20 69 6e 63 6c 75  ioctl.h>.# inclu
0dd0: 64 65 20 3c 73 79 73 2f 66 69 6c 65 2e 68 3e 0a  de <sys/file.h>.
0de0: 23 20 69 6e 63 6c 75 64 65 20 3c 73 79 73 2f 70  # include <sys/p
0df0: 61 72 61 6d 2e 68 3e 0a 23 65 6e 64 69 66 20 2f  aram.h>.#endif /
0e00: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  * SQLITE_ENABLE_
0e10: 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 2a 2f  LOCKING_STYLE */
0e20: 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f  ..#if defined(__
0e30: 41 50 50 4c 45 5f 5f 29 20 26 26 20 28 28 5f 5f  APPLE__) && ((__
0e40: 4d 41 43 5f 4f 53 5f 58 5f 56 45 52 53 49 4f 4e  MAC_OS_X_VERSION
0e50: 5f 4d 49 4e 5f 52 45 51 55 49 52 45 44 20 3e 20  _MIN_REQUIRED > 
0e60: 31 30 35 30 29 20 7c 7c 20 5c 0a 20 20 20 20 20  1050) || \.     
0e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0e80: 20 20 20 20 20 20 28 5f 5f 49 50 48 4f 4e 45 5f        (__IPHONE_
0e90: 4f 53 5f 56 45 52 53 49 4f 4e 5f 4d 49 4e 5f 52  OS_VERSION_MIN_R
0ea0: 45 51 55 49 52 45 44 20 3e 20 32 30 30 30 29 29  EQUIRED > 2000))
0eb0: 0a 23 20 20 69 66 20 28 21 64 65 66 69 6e 65 64  .#  if (!defined
0ec0: 28 54 41 52 47 45 54 5f 4f 53 5f 45 4d 42 45 44  (TARGET_OS_EMBED
0ed0: 44 45 44 29 20 7c 7c 20 28 54 41 52 47 45 54 5f  DED) || (TARGET_
0ee0: 4f 53 5f 45 4d 42 45 44 44 45 44 3d 3d 30 29 29  OS_EMBEDDED==0))
0ef0: 20 5c 0a 20 20 20 20 20 20 20 26 26 20 28 21 64   \.       && (!d
0f00: 65 66 69 6e 65 64 28 54 41 52 47 45 54 5f 49 50  efined(TARGET_IP
0f10: 48 4f 4e 45 5f 53 49 4d 55 4c 41 54 4f 52 29 20  HONE_SIMULATOR) 
0f20: 7c 7c 20 28 54 41 52 47 45 54 5f 49 50 48 4f 4e  || (TARGET_IPHON
0f30: 45 5f 53 49 4d 55 4c 41 54 4f 52 3d 3d 30 29 29  E_SIMULATOR==0))
0f40: 0a 23 20 20 20 20 64 65 66 69 6e 65 20 48 41 56  .#    define HAV
0f50: 45 5f 47 45 54 48 4f 53 54 55 55 49 44 20 31 0a  E_GETHOSTUUID 1.
0f60: 23 20 20 65 6c 73 65 0a 23 20 20 20 20 77 61 72  #  else.#    war
0f70: 6e 69 6e 67 20 22 67 65 74 68 6f 73 74 75 75 69  ning "gethostuui
0f80: 64 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 2e  d() is disabled.
0f90: 22 0a 23 20 20 65 6e 64 69 66 0a 23 65 6e 64 69  ".#  endif.#endi
0fa0: 66 0a 0a 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52  f...#if OS_VXWOR
0fb0: 4b 53 0a 23 20 69 6e 63 6c 75 64 65 20 3c 73 79  KS.# include <sy
0fc0: 73 2f 69 6f 63 74 6c 2e 68 3e 0a 23 20 69 6e 63  s/ioctl.h>.# inc
0fd0: 6c 75 64 65 20 3c 73 65 6d 61 70 68 6f 72 65 2e  lude <semaphore.
0fe0: 68 3e 0a 23 20 69 6e 63 6c 75 64 65 20 3c 6c 69  h>.# include <li
0ff0: 6d 69 74 73 2e 68 3e 0a 23 65 6e 64 69 66 20 2f  mits.h>.#endif /
1000: 2a 20 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f 0a  * OS_VXWORKS */.
1010: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41  .#if defined(__A
1020: 50 50 4c 45 5f 5f 29 20 7c 7c 20 53 51 4c 49 54  PPLE__) || SQLIT
1030: 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47  E_ENABLE_LOCKING
1040: 5f 53 54 59 4c 45 0a 23 20 69 6e 63 6c 75 64 65  _STYLE.# include
1050: 20 3c 73 79 73 2f 6d 6f 75 6e 74 2e 68 3e 0a 23   <sys/mount.h>.#
1060: 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 48 41  endif..#ifdef HA
1070: 56 45 5f 55 54 49 4d 45 0a 23 20 69 6e 63 6c 75  VE_UTIME.# inclu
1080: 64 65 20 3c 75 74 69 6d 65 2e 68 3e 0a 23 65 6e  de <utime.h>.#en
1090: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77  dif../*.** Allow
10a0: 65 64 20 76 61 6c 75 65 73 20 6f 66 20 75 6e 69  ed values of uni
10b0: 78 46 69 6c 65 2e 66 73 46 6c 61 67 73 0a 2a 2f  xFile.fsFlags.*/
10c0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
10d0: 46 53 46 4c 41 47 53 5f 49 53 5f 4d 53 44 4f 53  FSFLAGS_IS_MSDOS
10e0: 20 20 20 20 20 30 78 31 0a 0a 2f 2a 0a 2a 2a 20       0x1../*.** 
10f0: 49 66 20 77 65 20 61 72 65 20 74 6f 20 62 65 20  If we are to be 
1100: 74 68 72 65 61 64 2d 73 61 66 65 2c 20 69 6e 63  thread-safe, inc
1110: 6c 75 64 65 20 74 68 65 20 70 74 68 72 65 61 64  lude the pthread
1120: 73 20 68 65 61 64 65 72 2e 0a 2a 2f 0a 23 69 66  s header..*/.#if
1130: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
1140: 46 45 0a 23 20 69 6e 63 6c 75 64 65 20 3c 70 74  FE.# include <pt
1150: 68 72 65 61 64 2e 68 3e 0a 23 65 6e 64 69 66 0a  hread.h>.#endif.
1160: 0a 2f 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 70  ./*.** Default p
1170: 65 72 6d 69 73 73 69 6f 6e 73 20 77 68 65 6e 20  ermissions when 
1180: 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 66  creating a new f
1190: 69 6c 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53  ile.*/.#ifndef S
11a0: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49  QLITE_DEFAULT_FI
11b0: 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 0a 23  LE_PERMISSIONS.#
11c0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44   define SQLITE_D
11d0: 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d  EFAULT_FILE_PERM
11e0: 49 53 53 49 4f 4e 53 20 30 36 34 34 0a 23 65 6e  ISSIONS 0644.#en
11f0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 61 75  dif../*.** Defau
1200: 6c 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 77  lt permissions w
1210: 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 75 74  hen creating aut
1220: 6f 20 70 72 6f 78 79 20 64 69 72 0a 2a 2f 0a 23  o proxy dir.*/.#
1230: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45  ifndef SQLITE_DE
1240: 46 41 55 4c 54 5f 50 52 4f 58 59 44 49 52 5f 50  FAULT_PROXYDIR_P
1250: 45 52 4d 49 53 53 49 4f 4e 53 0a 23 20 64 65 66  ERMISSIONS.# def
1260: 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55  ine SQLITE_DEFAU
1270: 4c 54 5f 50 52 4f 58 59 44 49 52 5f 50 45 52 4d  LT_PROXYDIR_PERM
1280: 49 53 53 49 4f 4e 53 20 30 37 35 35 0a 23 65 6e  ISSIONS 0755.#en
1290: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 78 69 6d  dif../*.** Maxim
12a0: 75 6d 20 73 75 70 70 6f 72 74 65 64 20 70 61 74  um supported pat
12b0: 68 2d 6c 65 6e 67 74 68 2e 0a 2a 2f 0a 23 64 65  h-length..*/.#de
12c0: 66 69 6e 65 20 4d 41 58 5f 50 41 54 48 4e 41 4d  fine MAX_PATHNAM
12d0: 45 20 35 31 32 0a 0a 2f 2a 0a 2a 2a 20 4d 61 78  E 512../*.** Max
12e0: 69 6d 75 6d 20 73 75 70 70 6f 72 74 65 64 20 73  imum supported s
12f0: 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b 73 0a 2a 2f  ymbolic links.*/
1300: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
1310: 4d 41 58 5f 53 59 4d 4c 49 4e 4b 53 20 31 30 30  MAX_SYMLINKS 100
1320: 0a 0a 2f 2a 20 41 6c 77 61 79 73 20 63 61 73 74  ../* Always cast
1330: 20 74 68 65 20 67 65 74 70 69 64 28 29 20 72 65   the getpid() re
1340: 74 75 72 6e 20 74 79 70 65 20 66 6f 72 20 63 6f  turn type for co
1350: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68  mpatibility with
1360: 0a 2a 2a 20 6b 65 72 6e 65 6c 20 6d 6f 64 75 6c  .** kernel modul
1370: 65 73 20 69 6e 20 56 78 57 6f 72 6b 73 2e 20 2a  es in VxWorks. *
1380: 2f 0a 23 64 65 66 69 6e 65 20 6f 73 47 65 74 70  /.#define osGetp
1390: 69 64 28 58 29 20 28 70 69 64 5f 74 29 67 65 74  id(X) (pid_t)get
13a0: 70 69 64 28 29 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 6c  pid()../*.** Onl
13b0: 79 20 73 65 74 20 74 68 65 20 6c 61 73 74 45 72  y set the lastEr
13c0: 72 6e 6f 20 69 66 20 74 68 65 20 65 72 72 6f 72  rno if the error
13d0: 20 63 6f 64 65 20 69 73 20 61 20 72 65 61 6c 20   code is a real 
13e0: 65 72 72 6f 72 20 61 6e 64 20 6e 6f 74 20 0a 2a  error and not .*
13f0: 2a 20 61 20 6e 6f 72 6d 61 6c 20 65 78 70 65 63  * a normal expec
1400: 74 65 64 20 72 65 74 75 72 6e 20 63 6f 64 65 20  ted return code 
1410: 6f 66 20 53 51 4c 49 54 45 5f 42 55 53 59 20 6f  of SQLITE_BUSY o
1420: 72 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2f 0a 23  r SQLITE_OK.*/.#
1430: 64 65 66 69 6e 65 20 49 53 5f 4c 4f 43 4b 5f 45  define IS_LOCK_E
1440: 52 52 4f 52 28 78 29 20 20 28 28 78 20 21 3d 20  RROR(x)  ((x != 
1450: 53 51 4c 49 54 45 5f 4f 4b 29 20 26 26 20 28 78  SQLITE_OK) && (x
1460: 20 21 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 29   != SQLITE_BUSY)
1470: 29 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 72 65  )../* Forward re
1480: 66 65 72 65 6e 63 65 73 20 2a 2f 0a 74 79 70 65  ferences */.type
1490: 64 65 66 20 73 74 72 75 63 74 20 75 6e 69 78 53  def struct unixS
14a0: 68 6d 20 75 6e 69 78 53 68 6d 3b 20 20 20 20 20  hm unixShm;     
14b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e            /* Con
14c0: 6e 65 63 74 69 6f 6e 20 73 68 61 72 65 64 20 6d  nection shared m
14d0: 65 6d 6f 72 79 20 2a 2f 0a 74 79 70 65 64 65 66  emory */.typedef
14e0: 20 73 74 72 75 63 74 20 75 6e 69 78 53 68 6d 4e   struct unixShmN
14f0: 6f 64 65 20 75 6e 69 78 53 68 6d 4e 6f 64 65 3b  ode unixShmNode;
1500: 20 20 20 20 20 20 20 2f 2a 20 53 68 61 72 65 64         /* Shared
1510: 20 6d 65 6d 6f 72 79 20 69 6e 73 74 61 6e 63 65   memory instance
1520: 20 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75   */.typedef stru
1530: 63 74 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f  ct unixInodeInfo
1540: 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 3b 20   unixInodeInfo; 
1550: 20 20 2f 2a 20 41 6e 20 69 2d 6e 6f 64 65 20 2a    /* An i-node *
1560: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
1570: 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 55 6e   UnixUnusedFd Un
1580: 69 78 55 6e 75 73 65 64 46 64 3b 20 20 20 20 20  ixUnusedFd;     
1590: 2f 2a 20 41 6e 20 75 6e 75 73 65 64 20 66 69 6c  /* An unused fil
15a0: 65 20 64 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a  e descriptor */.
15b0: 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73  ./*.** Sometimes
15c0: 2c 20 61 66 74 65 72 20 61 20 66 69 6c 65 20 68  , after a file h
15d0: 61 6e 64 6c 65 20 69 73 20 63 6c 6f 73 65 64 20  andle is closed 
15e0: 62 79 20 53 51 4c 69 74 65 2c 20 74 68 65 20 66  by SQLite, the f
15f0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 0a 2a  ile descriptor.*
1600: 2a 20 63 61 6e 6e 6f 74 20 62 65 20 63 6c 6f 73  * cannot be clos
1610: 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 20  ed immediately. 
1620: 49 6e 20 74 68 65 73 65 20 63 61 73 65 73 2c 20  In these cases, 
1630: 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 74 68 65  instances of the
1640: 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74   following.** st
1650: 72 75 63 74 75 72 65 20 61 72 65 20 75 73 65 64  ructure are used
1660: 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 66 69   to store the fi
1670: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 77 68  le descriptor wh
1680: 69 6c 65 20 77 61 69 74 69 6e 67 20 66 6f 72 20  ile waiting for 
1690: 61 6e 0a 2a 2a 20 6f 70 70 6f 72 74 75 6e 69 74  an.** opportunit
16a0: 79 20 74 6f 20 65 69 74 68 65 72 20 63 6c 6f 73  y to either clos
16b0: 65 20 6f 72 20 72 65 75 73 65 20 69 74 2e 0a 2a  e or reuse it..*
16c0: 2f 0a 73 74 72 75 63 74 20 55 6e 69 78 55 6e 75  /.struct UnixUnu
16d0: 73 65 64 46 64 20 7b 0a 20 20 69 6e 74 20 66 64  sedFd {.  int fd
16e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
16f0: 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 63      /* File desc
1700: 72 69 70 74 6f 72 20 74 6f 20 63 6c 6f 73 65 20  riptor to close 
1710: 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 3b 20  */.  int flags; 
1720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1730: 2a 20 46 6c 61 67 73 20 74 68 69 73 20 66 69 6c  * Flags this fil
1740: 65 20 64 65 73 63 72 69 70 74 6f 72 20 77 61 73  e descriptor was
1750: 20 6f 70 65 6e 65 64 20 77 69 74 68 20 2a 2f 0a   opened with */.
1760: 20 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 2a    UnixUnusedFd *
1770: 70 4e 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 4e  pNext;      /* N
1780: 65 78 74 20 75 6e 75 73 65 64 20 66 69 6c 65 20  ext unused file 
1790: 64 65 73 63 72 69 70 74 6f 72 20 6f 6e 20 73 61  descriptor on sa
17a0: 6d 65 20 66 69 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f  me file */.};../
17b0: 2a 0a 2a 2a 20 54 68 65 20 75 6e 69 78 46 69 6c  *.** The unixFil
17c0: 65 20 73 74 72 75 63 74 75 72 65 20 69 73 20 73  e structure is s
17d0: 75 62 63 6c 61 73 73 20 6f 66 20 73 71 6c 69 74  ubclass of sqlit
17e0: 65 33 5f 66 69 6c 65 20 73 70 65 63 69 66 69 63  e3_file specific
17f0: 20 74 6f 20 74 68 65 20 75 6e 69 78 0a 2a 2a 20   to the unix.** 
1800: 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  VFS implementati
1810: 6f 6e 73 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20  ons..*/.typedef 
1820: 73 74 72 75 63 74 20 75 6e 69 78 46 69 6c 65 20  struct unixFile 
1830: 75 6e 69 78 46 69 6c 65 3b 0a 73 74 72 75 63 74  unixFile;.struct
1840: 20 75 6e 69 78 46 69 6c 65 20 7b 0a 20 20 73 71   unixFile {.  sq
1850: 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73  lite3_io_methods
1860: 20 63 6f 6e 73 74 20 2a 70 4d 65 74 68 6f 64 3b   const *pMethod;
1870: 20 20 2f 2a 20 41 6c 77 61 79 73 20 74 68 65 20    /* Always the 
1880: 66 69 72 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20  first entry */. 
1890: 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56   sqlite3_vfs *pV
18a0: 66 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  fs;             
18b0: 20 20 20 20 20 2f 2a 20 54 68 65 20 56 46 53 20       /* The VFS 
18c0: 74 68 61 74 20 63 72 65 61 74 65 64 20 74 68 69  that created thi
18d0: 73 20 75 6e 69 78 46 69 6c 65 20 2a 2f 0a 20 20  s unixFile */.  
18e0: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70  unixInodeInfo *p
18f0: 49 6e 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20  Inode;          
1900: 20 20 20 20 2f 2a 20 49 6e 66 6f 20 61 62 6f 75      /* Info abou
1910: 74 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 69 73 20  t locks on this 
1920: 69 6e 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68  inode */.  int h
1930: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1950: 2a 20 54 68 65 20 66 69 6c 65 20 64 65 73 63 72  * The file descr
1960: 69 70 74 6f 72 20 2a 2f 0a 20 20 75 6e 73 69 67  iptor */.  unsig
1970: 6e 65 64 20 63 68 61 72 20 65 46 69 6c 65 4c 6f  ned char eFileLo
1980: 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  ck;            /
1990: 2a 20 54 68 65 20 74 79 70 65 20 6f 66 20 6c 6f  * The type of lo
19a0: 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 69 73 20  ck held on this 
19b0: 66 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  fd */.  unsigned
19c0: 20 73 68 6f 72 74 20 69 6e 74 20 63 74 72 6c 46   short int ctrlF
19d0: 6c 61 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 42  lags;       /* B
19e0: 65 68 61 76 69 6f 72 61 6c 20 62 69 74 73 2e 20  ehavioral bits. 
19f0: 20 55 4e 49 58 46 49 4c 45 5f 2a 20 66 6c 61 67   UNIXFILE_* flag
1a00: 73 20 2a 2f 0a 20 20 69 6e 74 20 6c 61 73 74 45  s */.  int lastE
1a10: 72 72 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 20  rrno;           
1a20: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
1a30: 65 20 75 6e 69 78 20 65 72 72 6e 6f 20 66 72 6f  e unix errno fro
1a40: 6d 20 6c 61 73 74 20 49 2f 4f 20 65 72 72 6f 72  m last I/O error
1a50: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 6c 6f 63 6b   */.  void *lock
1a60: 69 6e 67 43 6f 6e 74 65 78 74 3b 20 20 20 20 20  ingContext;     
1a70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 63            /* Loc
1a80: 6b 69 6e 67 20 73 74 79 6c 65 20 73 70 65 63 69  king style speci
1a90: 66 69 63 20 73 74 61 74 65 20 2a 2f 0a 20 20 55  fic state */.  U
1aa0: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 50 72  nixUnusedFd *pPr
1ab0: 65 61 6c 6c 6f 63 61 74 65 64 55 6e 75 73 65 64  eallocatedUnused
1ac0: 3b 20 20 2f 2a 20 50 72 65 2d 61 6c 6c 6f 63 61  ;  /* Pre-alloca
1ad0: 74 65 64 20 55 6e 69 78 55 6e 75 73 65 64 46 64  ted UnixUnusedFd
1ae0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
1af0: 20 2a 7a 50 61 74 68 3b 20 20 20 20 20 20 20 20   *zPath;        
1b00: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d            /* Nam
1b10: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 2a 2f  e of the file */
1b20: 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 53 68 6d  .  unixShm *pShm
1b30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1b40: 20 20 20 20 20 20 20 2f 2a 20 53 68 61 72 65 64         /* Shared
1b50: 20 6d 65 6d 6f 72 79 20 73 65 67 6d 65 6e 74 20   memory segment 
1b60: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 20  information */. 
1b70: 20 69 6e 74 20 73 7a 43 68 75 6e 6b 3b 20 20 20   int szChunk;   
1b80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b90: 20 20 20 20 20 2f 2a 20 43 6f 6e 66 69 67 75 72       /* Configur
1ba0: 65 64 20 62 79 20 46 43 4e 54 4c 5f 43 48 55 4e  ed by FCNTL_CHUN
1bb0: 4b 5f 53 49 5a 45 20 2a 2f 0a 23 69 66 20 53 51  K_SIZE */.#if SQ
1bc0: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49  LITE_MAX_MMAP_SI
1bd0: 5a 45 3e 30 0a 20 20 69 6e 74 20 6e 46 65 74 63  ZE>0.  int nFetc
1be0: 68 4f 75 74 3b 20 20 20 20 20 20 20 20 20 20 20  hOut;           
1bf0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
1c00: 6d 62 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64  mber of outstand
1c10: 69 6e 67 20 78 46 65 74 63 68 20 72 65 66 73 20  ing xFetch refs 
1c20: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74  */.  sqlite3_int
1c30: 36 34 20 6d 6d 61 70 53 69 7a 65 3b 20 20 20 20  64 mmapSize;    
1c40: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 61 62           /* Usab
1c50: 6c 65 20 73 69 7a 65 20 6f 66 20 6d 61 70 70 69  le size of mappi
1c60: 6e 67 20 61 74 20 70 4d 61 70 52 65 67 69 6f 6e  ng at pMapRegion
1c70: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e   */.  sqlite3_in
1c80: 74 36 34 20 6d 6d 61 70 53 69 7a 65 41 63 74 75  t64 mmapSizeActu
1c90: 61 6c 3b 20 20 20 20 20 20 20 2f 2a 20 41 63 74  al;       /* Act
1ca0: 75 61 6c 20 73 69 7a 65 20 6f 66 20 6d 61 70 70  ual size of mapp
1cb0: 69 6e 67 20 61 74 20 70 4d 61 70 52 65 67 69 6f  ing at pMapRegio
1cc0: 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69  n */.  sqlite3_i
1cd0: 6e 74 36 34 20 6d 6d 61 70 53 69 7a 65 4d 61 78  nt64 mmapSizeMax
1ce0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f  ;          /* Co
1cf0: 6e 66 69 67 75 72 65 64 20 46 43 4e 54 4c 5f 4d  nfigured FCNTL_M
1d00: 4d 41 50 5f 53 49 5a 45 20 76 61 6c 75 65 20 2a  MAP_SIZE value *
1d10: 2f 0a 20 20 76 6f 69 64 20 2a 70 4d 61 70 52 65  /.  void *pMapRe
1d20: 67 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 20  gion;           
1d30: 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72          /* Memor
1d40: 79 20 6d 61 70 70 65 64 20 72 65 67 69 6f 6e 20  y mapped region 
1d50: 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 20  */.#endif.  int 
1d60: 73 65 63 74 6f 72 53 69 7a 65 3b 20 20 20 20 20  sectorSize;     
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1d80: 2f 2a 20 44 65 76 69 63 65 20 73 65 63 74 6f 72  /* Device sector
1d90: 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 64   size */.  int d
1da0: 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
1db0: 74 69 63 73 3b 20 20 20 20 20 20 20 20 20 20 2f  tics;          /
1dc0: 2a 20 50 72 65 63 6f 6d 70 75 74 65 64 20 64 65  * Precomputed de
1dd0: 76 69 63 65 20 63 68 61 72 61 63 74 65 72 69 73  vice characteris
1de0: 74 69 63 73 20 2a 2f 0a 23 69 66 20 53 51 4c 49  tics */.#if SQLI
1df0: 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e  TE_ENABLE_LOCKIN
1e00: 47 5f 53 54 59 4c 45 0a 20 20 69 6e 74 20 6f 70  G_STYLE.  int op
1e10: 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20  enFlags;        
1e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1e30: 20 54 68 65 20 66 6c 61 67 73 20 73 70 65 63 69   The flags speci
1e40: 66 69 65 64 20 61 74 20 6f 70 65 6e 28 29 20 2a  fied at open() *
1e50: 2f 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c  /.#endif.#if SQL
1e60: 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
1e70: 4e 47 5f 53 54 59 4c 45 20 7c 7c 20 64 65 66 69  NG_STYLE || defi
1e80: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 20  ned(__APPLE__). 
1e90: 20 75 6e 73 69 67 6e 65 64 20 66 73 46 6c 61 67   unsigned fsFlag
1ea0: 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  s;              
1eb0: 20 20 20 20 20 2f 2a 20 63 61 63 68 65 64 20 64       /* cached d
1ec0: 65 74 61 69 6c 73 20 66 72 6f 6d 20 73 74 61 74  etails from stat
1ed0: 66 73 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 23  fs() */.#endif.#
1ee0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
1ef0: 42 4c 45 5f 53 45 54 4c 4b 5f 54 49 4d 45 4f 55  BLE_SETLK_TIMEOU
1f00: 54 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 42 75  T.  unsigned iBu
1f10: 73 79 54 69 6d 65 6f 75 74 3b 20 20 20 20 20 20  syTimeout;      
1f20: 20 20 20 20 20 20 20 20 2f 2a 20 57 61 69 74 20          /* Wait 
1f30: 74 68 69 73 20 6d 61 6e 79 20 6d 69 6c 6c 69 73  this many millis
1f40: 65 63 20 6f 6e 20 6c 6f 63 6b 73 20 2a 2f 0a 23  ec on locks */.#
1f50: 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 56 58 57  endif.#if OS_VXW
1f60: 4f 52 4b 53 0a 20 20 73 74 72 75 63 74 20 76 78  ORKS.  struct vx
1f70: 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70 49 64  worksFileId *pId
1f80: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 6e  ;          /* Un
1f90: 69 71 75 65 20 66 69 6c 65 20 49 44 20 2a 2f 0a  ique file ID */.
1fa0: 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51  #endif.#ifdef SQ
1fb0: 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f 2a 20  LITE_DEBUG.  /* 
1fc0: 54 68 65 20 6e 65 78 74 20 67 72 6f 75 70 20 6f  The next group o
1fd0: 66 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20  f variables are 
1fe0: 75 73 65 64 20 74 6f 20 74 72 61 63 6b 20 77 68  used to track wh
1ff0: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65  ether or not the
2000: 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f  .  ** transactio
2010: 6e 20 63 6f 75 6e 74 65 72 20 69 6e 20 62 79 74  n counter in byt
2020: 65 73 20 32 34 2d 32 37 20 6f 66 20 64 61 74 61  es 24-27 of data
2030: 62 61 73 65 20 66 69 6c 65 73 20 61 72 65 20 75  base files are u
2040: 70 64 61 74 65 64 0a 20 20 2a 2a 20 77 68 65 6e  pdated.  ** when
2050: 65 76 65 72 20 61 6e 79 20 70 61 72 74 20 6f 66  ever any part of
2060: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 68   the database ch
2070: 61 6e 67 65 73 2e 20 20 41 6e 20 61 73 73 65 72  anges.  An asser
2080: 74 69 6f 6e 20 66 61 75 6c 74 20 77 69 6c 6c 0a  tion fault will.
2090: 20 20 2a 2a 20 6f 63 63 75 72 20 69 66 20 61 20    ** occur if a 
20a0: 66 69 6c 65 20 69 73 20 75 70 64 61 74 65 64 20  file is updated 
20b0: 77 69 74 68 6f 75 74 20 61 6c 73 6f 20 75 70 64  without also upd
20c0: 61 74 69 6e 67 20 74 68 65 20 74 72 61 6e 73 61  ating the transa
20d0: 63 74 69 6f 6e 0a 20 20 2a 2a 20 63 6f 75 6e 74  ction.  ** count
20e0: 65 72 2e 20 20 54 68 69 73 20 74 65 73 74 20 69  er.  This test i
20f0: 73 20 6d 61 64 65 20 74 6f 20 61 76 6f 69 64 20  s made to avoid 
2100: 6e 65 77 20 70 72 6f 62 6c 65 6d 73 20 73 69 6d  new problems sim
2110: 69 6c 61 72 20 74 6f 20 74 68 65 0a 20 20 2a 2a  ilar to the.  **
2120: 20 6f 6e 65 20 64 65 73 63 72 69 62 65 64 20 62   one described b
2130: 79 20 74 69 63 6b 65 74 20 23 33 35 38 34 2e 20  y ticket #3584. 
2140: 0a 20 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  .  */.  unsigned
2150: 20 63 68 61 72 20 74 72 61 6e 73 43 6e 74 72 43   char transCntrC
2160: 68 6e 67 3b 20 20 20 2f 2a 20 54 72 75 65 20 69  hng;   /* True i
2170: 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  f the transactio
2180: 6e 20 63 6f 75 6e 74 65 72 20 63 68 61 6e 67 65  n counter change
2190: 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  d */.  unsigned 
21a0: 63 68 61 72 20 64 62 55 70 64 61 74 65 3b 20 20  char dbUpdate;  
21b0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
21c0: 20 61 6e 79 20 70 61 72 74 20 6f 66 20 64 61 74   any part of dat
21d0: 61 62 61 73 65 20 66 69 6c 65 20 63 68 61 6e 67  abase file chang
21e0: 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64  ed */.  unsigned
21f0: 20 63 68 61 72 20 69 6e 4e 6f 72 6d 61 6c 57 72   char inNormalWr
2200: 69 74 65 3b 20 20 20 2f 2a 20 54 72 75 65 20 69  ite;   /* True i
2210: 66 20 69 6e 20 61 20 6e 6f 72 6d 61 6c 20 77 72  f in a normal wr
2220: 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 20 2a 2f  ite operation */
2230: 0a 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66  ..#endif..#ifdef
2240: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 2f   SQLITE_TEST.  /
2250: 2a 20 49 6e 20 74 65 73 74 20 6d 6f 64 65 2c 20  * In test mode, 
2260: 69 6e 63 72 65 61 73 65 20 74 68 65 20 73 69 7a  increase the siz
2270: 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74  e of this struct
2280: 75 72 65 20 61 20 62 69 74 20 73 6f 20 74 68 61  ure a bit so tha
2290: 74 20 0a 20 20 2a 2a 20 69 74 20 69 73 20 6c 61  t .  ** it is la
22a0: 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 73 74  rger than the st
22b0: 72 75 63 74 20 43 72 61 73 68 46 69 6c 65 20 64  ruct CrashFile d
22c0: 65 66 69 6e 65 64 20 69 6e 20 74 65 73 74 36 2e  efined in test6.
22d0: 63 2e 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 61  c..  */.  char a
22e0: 50 61 64 64 69 6e 67 5b 33 32 5d 3b 0a 23 65 6e  Padding[32];.#en
22f0: 64 69 66 0a 7d 3b 0a 0a 2f 2a 20 54 68 69 73 20  dif.};../* This 
2300: 76 61 72 69 61 62 6c 65 20 68 6f 6c 64 73 20 74  variable holds t
2310: 68 65 20 70 72 6f 63 65 73 73 20 69 64 20 28 70  he process id (p
2320: 69 64 29 20 66 72 6f 6d 20 77 68 65 6e 20 74 68  id) from when th
2330: 65 20 78 52 61 6e 64 6f 6d 6e 65 73 73 28 29 0a  e xRandomness().
2340: 2a 2a 20 6d 65 74 68 6f 64 20 77 61 73 20 63 61  ** method was ca
2350: 6c 6c 65 64 2e 20 20 49 66 20 78 4f 70 65 6e 28  lled.  If xOpen(
2360: 29 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d  ) is called from
2370: 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 72 6f   a different pro
2380: 63 65 73 73 20 69 64 2c 0a 2a 2a 20 69 6e 64 69  cess id,.** indi
2390: 63 61 74 69 6e 67 20 74 68 61 74 20 61 20 66 6f  cating that a fo
23a0: 72 6b 28 29 20 68 61 73 20 6f 63 63 75 72 72 65  rk() has occurre
23b0: 64 2c 20 74 68 65 20 50 52 4e 47 20 77 69 6c 6c  d, the PRNG will
23c0: 20 62 65 20 72 65 73 65 74 2e 0a 2a 2f 0a 73 74   be reset..*/.st
23d0: 61 74 69 63 20 70 69 64 5f 74 20 72 61 6e 64 6f  atic pid_t rando
23e0: 6d 6e 65 73 73 50 69 64 20 3d 20 30 3b 0a 0a 2f  mnessPid = 0;../
23f0: 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c  *.** Allowed val
2400: 75 65 73 20 66 6f 72 20 74 68 65 20 75 6e 69 78  ues for the unix
2410: 46 69 6c 65 2e 63 74 72 6c 46 6c 61 67 73 20 62  File.ctrlFlags b
2420: 69 74 6d 61 73 6b 3a 0a 2a 2f 0a 23 64 65 66 69  itmask:.*/.#defi
2430: 6e 65 20 55 4e 49 58 46 49 4c 45 5f 45 58 43 4c  ne UNIXFILE_EXCL
2440: 20 20 20 20 20 20 20 20 30 78 30 31 20 20 20 20          0x01    
2450: 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 73 20   /* Connections 
2460: 66 72 6f 6d 20 6f 6e 65 20 70 72 6f 63 65 73 73  from one process
2470: 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65   only */.#define
2480: 20 55 4e 49 58 46 49 4c 45 5f 52 44 4f 4e 4c 59   UNIXFILE_RDONLY
2490: 20 20 20 20 20 20 30 78 30 32 20 20 20 20 20 2f        0x02     /
24a0: 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20  * Connection is 
24b0: 72 65 61 64 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65  read only */.#de
24c0: 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f 50 45  fine UNIXFILE_PE
24d0: 52 53 49 53 54 5f 57 41 4c 20 30 78 30 34 20 20  RSIST_WAL 0x04  
24e0: 20 20 20 2f 2a 20 50 65 72 73 69 73 74 65 6e 74     /* Persistent
24f0: 20 57 41 4c 20 6d 6f 64 65 20 2a 2f 0a 23 69 66   WAL mode */.#if
2500: 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41  ndef SQLITE_DISA
2510: 42 4c 45 5f 44 49 52 53 59 4e 43 0a 23 20 64 65  BLE_DIRSYNC.# de
2520: 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f 44 49  fine UNIXFILE_DI
2530: 52 53 59 4e 43 20 20 20 20 30 78 30 38 20 20 20  RSYNC    0x08   
2540: 20 20 2f 2a 20 44 69 72 65 63 74 6f 72 79 20 73    /* Directory s
2550: 79 6e 63 20 6e 65 65 64 65 64 20 2a 2f 0a 23 65  ync needed */.#e
2560: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 55 4e 49  lse.# define UNI
2570: 58 46 49 4c 45 5f 44 49 52 53 59 4e 43 20 20 20  XFILE_DIRSYNC   
2580: 20 30 78 30 30 0a 23 65 6e 64 69 66 0a 23 64 65   0x00.#endif.#de
2590: 66 69 6e 65 20 55 4e 49 58 46 49 4c 45 5f 50 53  fine UNIXFILE_PS
25a0: 4f 57 20 20 20 20 20 20 20 20 30 78 31 30 20 20  OW        0x10  
25b0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4f 43     /* SQLITE_IOC
25c0: 41 50 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45  AP_POWERSAFE_OVE
25d0: 52 57 52 49 54 45 20 2a 2f 0a 23 64 65 66 69 6e  RWRITE */.#defin
25e0: 65 20 55 4e 49 58 46 49 4c 45 5f 44 45 4c 45 54  e UNIXFILE_DELET
25f0: 45 20 20 20 20 20 20 30 78 32 30 20 20 20 20 20  E      0x20     
2600: 2f 2a 20 44 65 6c 65 74 65 20 6f 6e 20 63 6c 6f  /* Delete on clo
2610: 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e  se */.#define UN
2620: 49 58 46 49 4c 45 5f 55 52 49 20 20 20 20 20 20  IXFILE_URI      
2630: 20 20 20 30 78 34 30 20 20 20 20 20 2f 2a 20 46     0x40     /* F
2640: 69 6c 65 6e 61 6d 65 20 6d 69 67 68 74 20 68 61  ilename might ha
2650: 76 65 20 71 75 65 72 79 20 70 61 72 61 6d 65 74  ve query paramet
2660: 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55  ers */.#define U
2670: 4e 49 58 46 49 4c 45 5f 4e 4f 4c 4f 43 4b 20 20  NIXFILE_NOLOCK  
2680: 20 20 20 20 30 78 38 30 20 20 20 20 20 2f 2a 20      0x80     /* 
2690: 44 6f 20 6e 6f 20 66 69 6c 65 20 6c 6f 63 6b 69  Do no file locki
26a0: 6e 67 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63  ng */../*.** Inc
26b0: 6c 75 64 65 20 63 6f 64 65 20 74 68 61 74 20 69  lude code that i
26c0: 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20  s common to all 
26d0: 6f 73 5f 2a 2e 63 20 66 69 6c 65 73 0a 2a 2f 0a  os_*.c files.*/.
26e0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 5f 63 6f 6d  #include "os_com
26f0: 6d 6f 6e 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 44 65  mon.h"../*.** De
2700: 66 69 6e 65 20 76 61 72 69 6f 75 73 20 6d 61 63  fine various mac
2710: 72 6f 73 20 74 68 61 74 20 61 72 65 20 6d 69 73  ros that are mis
2720: 73 69 6e 67 20 66 72 6f 6d 20 73 6f 6d 65 20 73  sing from some s
2730: 79 73 74 65 6d 73 2e 0a 2a 2f 0a 23 69 66 6e 64  ystems..*/.#ifnd
2740: 65 66 20 4f 5f 4c 41 52 47 45 46 49 4c 45 0a 23  ef O_LARGEFILE.#
2750: 20 64 65 66 69 6e 65 20 4f 5f 4c 41 52 47 45 46   define O_LARGEF
2760: 49 4c 45 20 30 0a 23 65 6e 64 69 66 0a 23 69 66  ILE 0.#endif.#if
2770: 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42  def SQLITE_DISAB
2780: 4c 45 5f 4c 46 53 0a 23 20 75 6e 64 65 66 20 4f  LE_LFS.# undef O
2790: 5f 4c 41 52 47 45 46 49 4c 45 0a 23 20 64 65 66  _LARGEFILE.# def
27a0: 69 6e 65 20 4f 5f 4c 41 52 47 45 46 49 4c 45 20  ine O_LARGEFILE 
27b0: 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66  0.#endif.#ifndef
27c0: 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 0a 23 20 64 65   O_NOFOLLOW.# de
27d0: 66 69 6e 65 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 20  fine O_NOFOLLOW 
27e0: 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66  0.#endif.#ifndef
27f0: 20 4f 5f 42 49 4e 41 52 59 0a 23 20 64 65 66 69   O_BINARY.# defi
2800: 6e 65 20 4f 5f 42 49 4e 41 52 59 20 30 0a 23 65  ne O_BINARY 0.#e
2810: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  ndif../*.** The 
2820: 74 68 72 65 61 64 69 64 20 6d 61 63 72 6f 20 72  threadid macro r
2830: 65 73 6f 6c 76 65 73 20 74 6f 20 74 68 65 20 74  esolves to the t
2840: 68 72 65 61 64 2d 69 64 20 6f 72 20 74 6f 20 30  hread-id or to 0
2850: 2e 20 20 55 73 65 64 20 66 6f 72 0a 2a 2a 20 74  .  Used for.** t
2860: 65 73 74 69 6e 67 20 61 6e 64 20 64 65 62 75 67  esting and debug
2870: 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 69  ging only..*/.#i
2880: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  f SQLITE_THREADS
2890: 41 46 45 0a 23 64 65 66 69 6e 65 20 74 68 72 65  AFE.#define thre
28a0: 61 64 69 64 20 70 74 68 72 65 61 64 5f 73 65 6c  adid pthread_sel
28b0: 66 28 29 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e  f().#else.#defin
28c0: 65 20 74 68 72 65 61 64 69 64 20 30 0a 23 65 6e  e threadid 0.#en
28d0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 48 41 56 45 5f  dif../*.** HAVE_
28e0: 4d 52 45 4d 41 50 20 64 65 66 61 75 6c 74 73 20  MREMAP defaults 
28f0: 74 6f 20 74 72 75 65 20 6f 6e 20 4c 69 6e 75 78  to true on Linux
2900: 20 61 6e 64 20 66 61 6c 73 65 20 65 76 65 72 79   and false every
2910: 77 68 65 72 65 20 65 6c 73 65 2e 0a 2a 2f 0a 23  where else..*/.#
2920: 69 66 20 21 64 65 66 69 6e 65 64 28 48 41 56 45  if !defined(HAVE
2930: 5f 4d 52 45 4d 41 50 29 0a 23 20 69 66 20 64 65  _MREMAP).# if de
2940: 66 69 6e 65 64 28 5f 5f 6c 69 6e 75 78 5f 5f 29  fined(__linux__)
2950: 20 26 26 20 64 65 66 69 6e 65 64 28 5f 47 4e 55   && defined(_GNU
2960: 5f 53 4f 55 52 43 45 29 0a 23 20 20 64 65 66 69  _SOURCE).#  defi
2970: 6e 65 20 48 41 56 45 5f 4d 52 45 4d 41 50 20 31  ne HAVE_MREMAP 1
2980: 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e  .# else.#  defin
2990: 65 20 48 41 56 45 5f 4d 52 45 4d 41 50 20 30 0a  e HAVE_MREMAP 0.
29a0: 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a  # endif.#endif..
29b0: 2f 2a 0a 2a 2a 20 45 78 70 6c 69 63 69 74 6c 79  /*.** Explicitly
29c0: 20 63 61 6c 6c 20 74 68 65 20 36 34 2d 62 69 74   call the 64-bit
29d0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 6c 73 65 65   version of lsee
29e0: 6b 28 29 20 6f 6e 20 41 6e 64 72 6f 69 64 2e 20  k() on Android. 
29f0: 4f 74 68 65 72 77 69 73 65 2c 20 6c 73 65 65 6b  Otherwise, lseek
2a00: 28 29 0a 2a 2a 20 69 73 20 74 68 65 20 33 32 2d  ().** is the 32-
2a10: 62 69 74 20 76 65 72 73 69 6f 6e 2c 20 65 76 65  bit version, eve
2a20: 6e 20 69 66 20 5f 46 49 4c 45 5f 4f 46 46 53 45  n if _FILE_OFFSE
2a30: 54 5f 42 49 54 53 3d 36 34 20 69 73 20 64 65 66  T_BITS=64 is def
2a40: 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 20  ined..*/.#ifdef 
2a50: 5f 5f 41 4e 44 52 4f 49 44 5f 5f 0a 23 20 64 65  __ANDROID__.# de
2a60: 66 69 6e 65 20 6c 73 65 65 6b 20 6c 73 65 65 6b  fine lseek lseek
2a70: 36 34 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65  64.#endif..#ifde
2a80: 66 20 5f 5f 6c 69 6e 75 78 5f 5f 0a 2f 2a 0a 2a  f __linux__./*.*
2a90: 2a 20 4c 69 6e 75 78 2d 73 70 65 63 69 66 69 63  * Linux-specific
2aa0: 20 49 4f 43 54 4c 20 6d 61 67 69 63 20 6e 75 6d   IOCTL magic num
2ab0: 62 65 72 73 20 75 73 65 64 20 66 6f 72 20 63 6f  bers used for co
2ac0: 6e 74 72 6f 6c 6c 69 6e 67 20 46 32 46 53 0a 2a  ntrolling F2FS.*
2ad0: 2f 0a 23 64 65 66 69 6e 65 20 46 32 46 53 5f 49  /.#define F2FS_I
2ae0: 4f 43 54 4c 5f 4d 41 47 49 43 20 20 20 20 20 20  OCTL_MAGIC      
2af0: 20 20 30 78 66 35 0a 23 64 65 66 69 6e 65 20 46    0xf5.#define F
2b00: 32 46 53 5f 49 4f 43 5f 53 54 41 52 54 5f 41 54  2FS_IOC_START_AT
2b10: 4f 4d 49 43 5f 57 52 49 54 45 20 20 20 20 20 5f  OMIC_WRITE     _
2b20: 49 4f 28 46 32 46 53 5f 49 4f 43 54 4c 5f 4d 41  IO(F2FS_IOCTL_MA
2b30: 47 49 43 2c 20 31 29 0a 23 64 65 66 69 6e 65 20  GIC, 1).#define 
2b40: 46 32 46 53 5f 49 4f 43 5f 43 4f 4d 4d 49 54 5f  F2FS_IOC_COMMIT_
2b50: 41 54 4f 4d 49 43 5f 57 52 49 54 45 20 20 20 20  ATOMIC_WRITE    
2b60: 5f 49 4f 28 46 32 46 53 5f 49 4f 43 54 4c 5f 4d  _IO(F2FS_IOCTL_M
2b70: 41 47 49 43 2c 20 32 29 0a 23 64 65 66 69 6e 65  AGIC, 2).#define
2b80: 20 46 32 46 53 5f 49 4f 43 5f 53 54 41 52 54 5f   F2FS_IOC_START_
2b90: 56 4f 4c 41 54 49 4c 45 5f 57 52 49 54 45 20 20  VOLATILE_WRITE  
2ba0: 20 5f 49 4f 28 46 32 46 53 5f 49 4f 43 54 4c 5f   _IO(F2FS_IOCTL_
2bb0: 4d 41 47 49 43 2c 20 33 29 0a 23 64 65 66 69 6e  MAGIC, 3).#defin
2bc0: 65 20 46 32 46 53 5f 49 4f 43 5f 41 42 4f 52 54  e F2FS_IOC_ABORT
2bd0: 5f 56 4f 4c 41 54 49 4c 45 5f 57 52 49 54 45 20  _VOLATILE_WRITE 
2be0: 20 20 5f 49 4f 28 46 32 46 53 5f 49 4f 43 54 4c    _IO(F2FS_IOCTL
2bf0: 5f 4d 41 47 49 43 2c 20 35 29 0a 23 64 65 66 69  _MAGIC, 5).#defi
2c00: 6e 65 20 46 32 46 53 5f 49 4f 43 5f 47 45 54 5f  ne F2FS_IOC_GET_
2c10: 46 45 41 54 55 52 45 53 20 20 20 20 20 20 20 20  FEATURES        
2c20: 20 20 20 5f 49 4f 52 28 46 32 46 53 5f 49 4f 43     _IOR(F2FS_IOC
2c30: 54 4c 5f 4d 41 47 49 43 2c 20 31 32 2c 20 75 33  TL_MAGIC, 12, u3
2c40: 32 29 0a 23 64 65 66 69 6e 65 20 46 32 46 53 5f  2).#define F2FS_
2c50: 46 45 41 54 55 52 45 5f 41 54 4f 4d 49 43 5f 57  FEATURE_ATOMIC_W
2c60: 52 49 54 45 20 30 78 30 30 30 34 0a 23 65 6e 64  RITE 0x0004.#end
2c70: 69 66 20 2f 2a 20 5f 5f 6c 69 6e 75 78 5f 5f 20  if /* __linux__ 
2c80: 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 44 69 66 66 65  */.../*.** Diffe
2c90: 72 65 6e 74 20 55 6e 69 78 20 73 79 73 74 65 6d  rent Unix system
2ca0: 73 20 64 65 63 6c 61 72 65 20 6f 70 65 6e 28 29  s declare open()
2cb0: 20 69 6e 20 64 69 66 66 65 72 65 6e 74 20 77 61   in different wa
2cc0: 79 73 2e 20 20 53 61 6d 65 20 75 73 65 0a 2a 2a  ys.  Same use.**
2cd0: 20 6f 70 65 6e 28 63 6f 6e 73 74 20 63 68 61 72   open(const char
2ce0: 2a 2c 69 6e 74 2c 6d 6f 64 65 5f 74 29 2e 20 20  *,int,mode_t).  
2cf0: 4f 74 68 65 72 73 20 75 73 65 20 6f 70 65 6e 28  Others use open(
2d00: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 2c  const char*,int,
2d10: 2e 2e 2e 29 2e 0a 2a 2a 20 54 68 65 20 64 69 66  ...)..** The dif
2d20: 66 65 72 65 6e 63 65 20 69 73 20 69 6d 70 6f 72  ference is impor
2d30: 74 61 6e 74 20 77 68 65 6e 20 75 73 69 6e 67 20  tant when using 
2d40: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  a pointer to the
2d50: 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a   function..**.**
2d60: 20 54 68 65 20 73 61 66 65 73 74 20 77 61 79 20   The safest way 
2d70: 74 6f 20 64 65 61 6c 20 77 69 74 68 20 74 68 65  to deal with the
2d80: 20 70 72 6f 62 6c 65 6d 20 69 73 20 74 6f 20 61   problem is to a
2d90: 6c 77 61 79 73 20 75 73 65 20 74 68 69 73 20 77  lways use this w
2da0: 72 61 70 70 65 72 0a 2a 2a 20 77 68 69 63 68 20  rapper.** which 
2db0: 61 6c 77 61 79 73 20 68 61 73 20 74 68 65 20 73  always has the s
2dc0: 61 6d 65 20 77 65 6c 6c 2d 64 65 66 69 6e 65 64  ame well-defined
2dd0: 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2f 0a 73   interface..*/.s
2de0: 74 61 74 69 63 20 69 6e 74 20 70 6f 73 69 78 4f  tatic int posixO
2df0: 70 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  pen(const char *
2e00: 7a 46 69 6c 65 2c 20 69 6e 74 20 66 6c 61 67 73  zFile, int flags
2e10: 2c 20 69 6e 74 20 6d 6f 64 65 29 7b 0a 20 20 72  , int mode){.  r
2e20: 65 74 75 72 6e 20 6f 70 65 6e 28 7a 46 69 6c 65  eturn open(zFile
2e30: 2c 20 66 6c 61 67 73 2c 20 6d 6f 64 65 29 3b 0a  , flags, mode);.
2e40: 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 72 65  }../* Forward re
2e50: 66 65 72 65 6e 63 65 20 2a 2f 0a 73 74 61 74 69  ference */.stati
2e60: 63 20 69 6e 74 20 6f 70 65 6e 44 69 72 65 63 74  c int openDirect
2e70: 6f 72 79 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c  ory(const char*,
2e80: 20 69 6e 74 2a 29 3b 0a 73 74 61 74 69 63 20 69   int*);.static i
2e90: 6e 74 20 75 6e 69 78 47 65 74 70 61 67 65 73 69  nt unixGetpagesi
2ea0: 7a 65 28 76 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a  ze(void);../*.**
2eb0: 20 4d 61 6e 79 20 73 79 73 74 65 6d 20 63 61 6c   Many system cal
2ec0: 6c 73 20 61 72 65 20 61 63 63 65 73 73 65 64 20  ls are accessed 
2ed0: 74 68 72 6f 75 67 68 20 70 6f 69 6e 74 65 72 2d  through pointer-
2ee0: 74 6f 2d 66 75 6e 63 74 69 6f 6e 73 20 73 6f 20  to-functions so 
2ef0: 74 68 61 74 0a 2a 2a 20 74 68 65 79 20 6d 61 79  that.** they may
2f00: 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 61   be overridden a
2f10: 74 20 72 75 6e 74 69 6d 65 20 74 6f 20 66 61 63  t runtime to fac
2f20: 69 6c 69 74 61 74 65 20 66 61 75 6c 74 20 69 6e  ilitate fault in
2f30: 6a 65 63 74 69 6f 6e 20 64 75 72 69 6e 67 0a 2a  jection during.*
2f40: 2a 20 74 65 73 74 69 6e 67 20 61 6e 64 20 73 61  * testing and sa
2f50: 6e 64 62 6f 78 69 6e 67 2e 20 20 54 68 65 20 66  ndboxing.  The f
2f60: 6f 6c 6c 6f 77 69 6e 67 20 61 72 72 61 79 20 68  ollowing array h
2f70: 6f 6c 64 73 20 74 68 65 20 6e 61 6d 65 73 20 61  olds the names a
2f80: 6e 64 20 70 6f 69 6e 74 65 72 73 0a 2a 2a 20 74  nd pointers.** t
2f90: 6f 20 61 6c 6c 20 6f 76 65 72 72 69 64 65 61 62  o all overrideab
2fa0: 6c 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 73 2e  le system calls.
2fb0: 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74 72 75 63  .*/.static struc
2fc0: 74 20 75 6e 69 78 5f 73 79 73 63 61 6c 6c 20 7b  t unix_syscall {
2fd0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
2fe0: 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20  Name;           
2ff0: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20   /* Name of the 
3000: 73 79 73 74 65 6d 20 63 61 6c 6c 20 2a 2f 0a 20  system call */. 
3010: 20 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c   sqlite3_syscall
3020: 5f 70 74 72 20 70 43 75 72 72 65 6e 74 3b 20 2f  _ptr pCurrent; /
3030: 2a 20 43 75 72 72 65 6e 74 20 76 61 6c 75 65 20  * Current value 
3040: 6f 66 20 74 68 65 20 73 79 73 74 65 6d 20 63 61  of the system ca
3050: 6c 6c 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  ll */.  sqlite3_
3060: 73 79 73 63 61 6c 6c 5f 70 74 72 20 70 44 65 66  syscall_ptr pDef
3070: 61 75 6c 74 3b 20 2f 2a 20 44 65 66 61 75 6c 74  ault; /* Default
3080: 20 76 61 6c 75 65 20 2a 2f 0a 7d 20 61 53 79 73   value */.} aSys
3090: 63 61 6c 6c 5b 5d 20 3d 20 7b 0a 20 20 7b 20 22  call[] = {.  { "
30a0: 6f 70 65 6e 22 2c 20 20 20 20 20 20 20 20 20 28  open",         (
30b0: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f  sqlite3_syscall_
30c0: 70 74 72 29 70 6f 73 69 78 4f 70 65 6e 2c 20 20  ptr)posixOpen,  
30d0: 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73  0  },.#define os
30e0: 4f 70 65 6e 20 20 20 20 20 20 28 28 69 6e 74 28  Open      ((int(
30f0: 2a 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69  *)(const char*,i
3100: 6e 74 2c 69 6e 74 29 29 61 53 79 73 63 61 6c 6c  nt,int))aSyscall
3110: 5b 30 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20  [0].pCurrent).. 
3120: 20 7b 20 22 63 6c 6f 73 65 22 2c 20 20 20 20 20   { "close",     
3130: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63     (sqlite3_sysc
3140: 61 6c 6c 5f 70 74 72 29 63 6c 6f 73 65 2c 20 20  all_ptr)close,  
3150: 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e      0  },.#defin
3160: 65 20 6f 73 43 6c 6f 73 65 20 20 20 20 20 28 28  e osClose     ((
3170: 69 6e 74 28 2a 29 28 69 6e 74 29 29 61 53 79 73  int(*)(int))aSys
3180: 63 61 6c 6c 5b 31 5d 2e 70 43 75 72 72 65 6e 74  call[1].pCurrent
3190: 29 0a 0a 20 20 7b 20 22 61 63 63 65 73 73 22 2c  )..  { "access",
31a0: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f         (sqlite3_
31b0: 73 79 73 63 61 6c 6c 5f 70 74 72 29 61 63 63 65  syscall_ptr)acce
31c0: 73 73 2c 20 20 20 20 20 30 20 20 7d 2c 0a 23 64  ss,     0  },.#d
31d0: 65 66 69 6e 65 20 6f 73 41 63 63 65 73 73 20 20  efine osAccess  
31e0: 20 20 28 28 69 6e 74 28 2a 29 28 63 6f 6e 73 74    ((int(*)(const
31f0: 20 63 68 61 72 2a 2c 69 6e 74 29 29 61 53 79 73   char*,int))aSys
3200: 63 61 6c 6c 5b 32 5d 2e 70 43 75 72 72 65 6e 74  call[2].pCurrent
3210: 29 0a 0a 20 20 7b 20 22 67 65 74 63 77 64 22 2c  )..  { "getcwd",
3220: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f         (sqlite3_
3230: 73 79 73 63 61 6c 6c 5f 70 74 72 29 67 65 74 63  syscall_ptr)getc
3240: 77 64 2c 20 20 20 20 20 30 20 20 7d 2c 0a 23 64  wd,     0  },.#d
3250: 65 66 69 6e 65 20 6f 73 47 65 74 63 77 64 20 20  efine osGetcwd  
3260: 20 20 28 28 63 68 61 72 2a 28 2a 29 28 63 68 61    ((char*(*)(cha
3270: 72 2a 2c 73 69 7a 65 5f 74 29 29 61 53 79 73 63  r*,size_t))aSysc
3280: 61 6c 6c 5b 33 5d 2e 70 43 75 72 72 65 6e 74 29  all[3].pCurrent)
3290: 0a 0a 20 20 7b 20 22 73 74 61 74 22 2c 20 20 20  ..  { "stat",   
32a0: 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73        (sqlite3_s
32b0: 79 73 63 61 6c 6c 5f 70 74 72 29 73 74 61 74 2c  yscall_ptr)stat,
32c0: 20 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 64 65         0  },.#de
32d0: 66 69 6e 65 20 6f 73 53 74 61 74 20 20 20 20 20  fine osStat     
32e0: 20 28 28 69 6e 74 28 2a 29 28 63 6f 6e 73 74 20   ((int(*)(const 
32f0: 63 68 61 72 2a 2c 73 74 72 75 63 74 20 73 74 61  char*,struct sta
3300: 74 2a 29 29 61 53 79 73 63 61 6c 6c 5b 34 5d 2e  t*))aSyscall[4].
3310: 70 43 75 72 72 65 6e 74 29 0a 0a 2f 2a 0a 2a 2a  pCurrent)../*.**
3320: 20 54 68 65 20 44 4a 47 50 50 20 63 6f 6d 70 69   The DJGPP compi
3330: 6c 65 72 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  ler environment 
3340: 6c 6f 6f 6b 73 20 6d 6f 73 74 6c 79 20 6c 69 6b  looks mostly lik
3350: 65 20 55 6e 69 78 2c 20 62 75 74 20 69 74 0a 2a  e Unix, but it.*
3360: 2a 20 6c 61 63 6b 73 20 74 68 65 20 66 63 6e 74  * lacks the fcnt
3370: 6c 28 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e  l() system call.
3380: 20 20 53 6f 20 72 65 64 65 66 69 6e 65 20 66 63    So redefine fc
3390: 6e 74 6c 28 29 20 74 6f 20 62 65 20 73 6f 6d 65  ntl() to be some
33a0: 74 68 69 6e 67 0a 2a 2a 20 74 68 61 74 20 61 6c  thing.** that al
33b0: 77 61 79 73 20 73 75 63 63 65 65 64 73 2e 20 20  ways succeeds.  
33c0: 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20  This means that 
33d0: 6c 6f 63 6b 69 6e 67 20 64 6f 65 73 20 6e 6f 74  locking does not
33e0: 20 6f 63 63 75 72 20 75 6e 64 65 72 0a 2a 2a 20   occur under.** 
33f0: 44 4a 47 50 50 2e 20 20 42 75 74 20 69 74 20 69  DJGPP.  But it i
3400: 73 20 44 4f 53 20 2d 20 77 68 61 74 20 64 69 64  s DOS - what did
3410: 20 79 6f 75 20 65 78 70 65 63 74 3f 0a 2a 2f 0a   you expect?.*/.
3420: 23 69 66 64 65 66 20 5f 5f 44 4a 47 50 50 5f 5f  #ifdef __DJGPP__
3430: 0a 20 20 7b 20 22 66 73 74 61 74 22 2c 20 20 20  .  { "fstat",   
3440: 20 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20       0,         
3450: 20 20 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 64          0  },.#d
3460: 65 66 69 6e 65 20 6f 73 46 73 74 61 74 28 61 2c  efine osFstat(a,
3470: 62 2c 63 29 20 20 20 20 30 0a 23 65 6c 73 65 20  b,c)    0.#else 
3480: 20 20 20 20 0a 20 20 7b 20 22 66 73 74 61 74 22      .  { "fstat"
3490: 2c 20 20 20 20 20 20 20 20 28 73 71 6c 69 74 65  ,        (sqlite
34a0: 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 66 73  3_syscall_ptr)fs
34b0: 74 61 74 2c 20 20 20 20 20 20 30 20 20 7d 2c 0a  tat,      0  },.
34c0: 23 64 65 66 69 6e 65 20 6f 73 46 73 74 61 74 20  #define osFstat 
34d0: 20 20 20 20 28 28 69 6e 74 28 2a 29 28 69 6e 74      ((int(*)(int
34e0: 2c 73 74 72 75 63 74 20 73 74 61 74 2a 29 29 61  ,struct stat*))a
34f0: 53 79 73 63 61 6c 6c 5b 35 5d 2e 70 43 75 72 72  Syscall[5].pCurr
3500: 65 6e 74 29 0a 23 65 6e 64 69 66 0a 0a 20 20 7b  ent).#endif..  {
3510: 20 22 66 74 72 75 6e 63 61 74 65 22 2c 20 20 20   "ftruncate",   
3520: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
3530: 6c 5f 70 74 72 29 66 74 72 75 6e 63 61 74 65 2c  l_ptr)ftruncate,
3540: 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65 20    0  },.#define 
3550: 6f 73 46 74 72 75 6e 63 61 74 65 20 28 28 69 6e  osFtruncate ((in
3560: 74 28 2a 29 28 69 6e 74 2c 6f 66 66 5f 74 29 29  t(*)(int,off_t))
3570: 61 53 79 73 63 61 6c 6c 5b 36 5d 2e 70 43 75 72  aSyscall[6].pCur
3580: 72 65 6e 74 29 0a 0a 20 20 7b 20 22 66 63 6e 74  rent)..  { "fcnt
3590: 6c 22 2c 20 20 20 20 20 20 20 20 28 73 71 6c 69  l",        (sqli
35a0: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29  te3_syscall_ptr)
35b0: 66 63 6e 74 6c 2c 20 20 20 20 20 20 30 20 20 7d  fcntl,      0  }
35c0: 2c 0a 23 64 65 66 69 6e 65 20 6f 73 46 63 6e 74  ,.#define osFcnt
35d0: 6c 20 20 20 20 20 28 28 69 6e 74 28 2a 29 28 69  l     ((int(*)(i
35e0: 6e 74 2c 69 6e 74 2c 2e 2e 2e 29 29 61 53 79 73  nt,int,...))aSys
35f0: 63 61 6c 6c 5b 37 5d 2e 70 43 75 72 72 65 6e 74  call[7].pCurrent
3600: 29 0a 0a 20 20 7b 20 22 72 65 61 64 22 2c 20 20  )..  { "read",  
3610: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f         (sqlite3_
3620: 73 79 73 63 61 6c 6c 5f 70 74 72 29 72 65 61 64  syscall_ptr)read
3630: 2c 20 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 64  ,       0  },.#d
3640: 65 66 69 6e 65 20 6f 73 52 65 61 64 20 20 20 20  efine osRead    
3650: 20 20 28 28 73 73 69 7a 65 5f 74 28 2a 29 28 69    ((ssize_t(*)(i
3660: 6e 74 2c 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 29  nt,void*,size_t)
3670: 29 61 53 79 73 63 61 6c 6c 5b 38 5d 2e 70 43 75  )aSyscall[8].pCu
3680: 72 72 65 6e 74 29 0a 0a 23 69 66 20 64 65 66 69  rrent)..#if defi
3690: 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29 20 7c  ned(USE_PREAD) |
36a0: 7c 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  | SQLITE_ENABLE_
36b0: 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20  LOCKING_STYLE.  
36c0: 7b 20 22 70 72 65 61 64 22 2c 20 20 20 20 20 20  { "pread",      
36d0: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61    (sqlite3_sysca
36e0: 6c 6c 5f 70 74 72 29 70 72 65 61 64 2c 20 20 20  ll_ptr)pread,   
36f0: 20 20 20 30 20 20 7d 2c 0a 23 65 6c 73 65 0a 20     0  },.#else. 
3700: 20 7b 20 22 70 72 65 61 64 22 2c 20 20 20 20 20   { "pread",     
3710: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63     (sqlite3_sysc
3720: 61 6c 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20  all_ptr)0,      
3730: 20 20 20 20 30 20 20 7d 2c 0a 23 65 6e 64 69 66      0  },.#endif
3740: 0a 23 64 65 66 69 6e 65 20 6f 73 50 72 65 61 64  .#define osPread
3750: 20 20 20 20 20 28 28 73 73 69 7a 65 5f 74 28 2a       ((ssize_t(*
3760: 29 28 69 6e 74 2c 76 6f 69 64 2a 2c 73 69 7a 65  )(int,void*,size
3770: 5f 74 2c 6f 66 66 5f 74 29 29 61 53 79 73 63 61  _t,off_t))aSysca
3780: 6c 6c 5b 39 5d 2e 70 43 75 72 72 65 6e 74 29 0a  ll[9].pCurrent).
3790: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 55 53 45  .#if defined(USE
37a0: 5f 50 52 45 41 44 36 34 29 0a 20 20 7b 20 22 70  _PREAD64).  { "p
37b0: 72 65 61 64 36 34 22 2c 20 20 20 20 20 20 28 73  read64",      (s
37c0: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70  qlite3_syscall_p
37d0: 74 72 29 70 72 65 61 64 36 34 2c 20 20 20 20 30  tr)pread64,    0
37e0: 20 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22    },.#else.  { "
37f0: 70 72 65 61 64 36 34 22 2c 20 20 20 20 20 20 28  pread64",      (
3800: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f  sqlite3_syscall_
3810: 70 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 20  ptr)0,          
3820: 30 20 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65  0  },.#endif.#de
3830: 66 69 6e 65 20 6f 73 50 72 65 61 64 36 34 20 28  fine osPread64 (
3840: 28 73 73 69 7a 65 5f 74 28 2a 29 28 69 6e 74 2c  (ssize_t(*)(int,
3850: 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 2c 6f 66 66  void*,size_t,off
3860: 36 34 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b 31  64_t))aSyscall[1
3870: 30 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 20  0].pCurrent)..  
3880: 7b 20 22 77 72 69 74 65 22 2c 20 20 20 20 20 20  { "write",      
3890: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61    (sqlite3_sysca
38a0: 6c 6c 5f 70 74 72 29 77 72 69 74 65 2c 20 20 20  ll_ptr)write,   
38b0: 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69 6e 65     0  },.#define
38c0: 20 6f 73 57 72 69 74 65 20 20 20 20 20 28 28 73   osWrite     ((s
38d0: 73 69 7a 65 5f 74 28 2a 29 28 69 6e 74 2c 63 6f  size_t(*)(int,co
38e0: 6e 73 74 20 76 6f 69 64 2a 2c 73 69 7a 65 5f 74  nst void*,size_t
38f0: 29 29 61 53 79 73 63 61 6c 6c 5b 31 31 5d 2e 70  ))aSyscall[11].p
3900: 43 75 72 72 65 6e 74 29 0a 0a 23 69 66 20 64 65  Current)..#if de
3910: 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29  fined(USE_PREAD)
3920: 20 7c 7c 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c   || SQLITE_ENABL
3930: 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a  E_LOCKING_STYLE.
3940: 20 20 7b 20 22 70 77 72 69 74 65 22 2c 20 20 20    { "pwrite",   
3950: 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73      (sqlite3_sys
3960: 63 61 6c 6c 5f 70 74 72 29 70 77 72 69 74 65 2c  call_ptr)pwrite,
3970: 20 20 20 20 20 30 20 20 7d 2c 0a 23 65 6c 73 65       0  },.#else
3980: 0a 20 20 7b 20 22 70 77 72 69 74 65 22 2c 20 20  .  { "pwrite",  
3990: 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79       (sqlite3_sy
39a0: 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 20 20 20  scall_ptr)0,    
39b0: 20 20 20 20 20 20 30 20 20 7d 2c 0a 23 65 6e 64        0  },.#end
39c0: 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 50 77 72  if.#define osPwr
39d0: 69 74 65 20 20 20 20 28 28 73 73 69 7a 65 5f 74  ite    ((ssize_t
39e0: 28 2a 29 28 69 6e 74 2c 63 6f 6e 73 74 20 76 6f  (*)(int,const vo
39f0: 69 64 2a 2c 73 69 7a 65 5f 74 2c 6f 66 66 5f 74  id*,size_t,off_t
3a00: 29 29 5c 0a 20 20 20 20 20 20 20 20 20 20 20 20  ))\.            
3a10: 20 20 20 20 20 20 20 20 61 53 79 73 63 61 6c 6c          aSyscall
3a20: 5b 31 32 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a  [12].pCurrent)..
3a30: 23 69 66 20 64 65 66 69 6e 65 64 28 55 53 45 5f  #if defined(USE_
3a40: 50 52 45 41 44 36 34 29 0a 20 20 7b 20 22 70 77  PREAD64).  { "pw
3a50: 72 69 74 65 36 34 22 2c 20 20 20 20 20 28 73 71  rite64",     (sq
3a60: 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74  lite3_syscall_pt
3a70: 72 29 70 77 72 69 74 65 36 34 2c 20 20 20 30 20  r)pwrite64,   0 
3a80: 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 70   },.#else.  { "p
3a90: 77 72 69 74 65 36 34 22 2c 20 20 20 20 20 28 73  write64",     (s
3aa0: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70  qlite3_syscall_p
3ab0: 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 20 30  tr)0,          0
3ac0: 20 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66    },.#endif.#def
3ad0: 69 6e 65 20 6f 73 50 77 72 69 74 65 36 34 20 20  ine osPwrite64  
3ae0: 28 28 73 73 69 7a 65 5f 74 28 2a 29 28 69 6e 74  ((ssize_t(*)(int
3af0: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 73 69 7a  ,const void*,siz
3b00: 65 5f 74 2c 6f 66 66 36 34 5f 74 29 29 5c 0a 20  e_t,off64_t))\. 
3b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3b20: 20 20 20 61 53 79 73 63 61 6c 6c 5b 31 33 5d 2e     aSyscall[13].
3b30: 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22  pCurrent)..  { "
3b40: 66 63 68 6d 6f 64 22 2c 20 20 20 20 20 20 20 28  fchmod",       (
3b50: 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f  sqlite3_syscall_
3b60: 70 74 72 29 66 63 68 6d 6f 64 2c 20 20 20 20 20  ptr)fchmod,     
3b70: 20 20 20 20 20 30 20 20 7d 2c 0a 23 64 65 66 69       0  },.#defi
3b80: 6e 65 20 6f 73 46 63 68 6d 6f 64 20 20 20 20 28  ne osFchmod    (
3b90: 28 69 6e 74 28 2a 29 28 69 6e 74 2c 6d 6f 64 65  (int(*)(int,mode
3ba0: 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b 31 34 5d  _t))aSyscall[14]
3bb0: 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66 20  .pCurrent)..#if 
3bc0: 64 65 66 69 6e 65 64 28 48 41 56 45 5f 50 4f 53  defined(HAVE_POS
3bd0: 49 58 5f 46 41 4c 4c 4f 43 41 54 45 29 20 26 26  IX_FALLOCATE) &&
3be0: 20 48 41 56 45 5f 50 4f 53 49 58 5f 46 41 4c 4c   HAVE_POSIX_FALL
3bf0: 4f 43 41 54 45 0a 20 20 7b 20 22 66 61 6c 6c 6f  OCATE.  { "fallo
3c00: 63 61 74 65 22 2c 20 20 20 20 28 73 71 6c 69 74  cate",    (sqlit
3c10: 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 70  e3_syscall_ptr)p
3c20: 6f 73 69 78 5f 66 61 6c 6c 6f 63 61 74 65 2c 20  osix_fallocate, 
3c30: 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20   0 },.#else.  { 
3c40: 22 66 61 6c 6c 6f 63 61 74 65 22 2c 20 20 20 20  "fallocate",    
3c50: 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c  (sqlite3_syscall
3c60: 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20 20  _ptr)0,         
3c70: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64         0 },.#end
3c80: 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 46 61 6c  if.#define osFal
3c90: 6c 6f 63 61 74 65 20 28 28 69 6e 74 28 2a 29 28  locate ((int(*)(
3ca0: 69 6e 74 2c 6f 66 66 5f 74 2c 6f 66 66 5f 74 29  int,off_t,off_t)
3cb0: 29 61 53 79 73 63 61 6c 6c 5b 31 35 5d 2e 70 43  )aSyscall[15].pC
3cc0: 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22 75 6e  urrent)..  { "un
3cd0: 6c 69 6e 6b 22 2c 20 20 20 20 20 20 20 28 73 71  link",       (sq
3ce0: 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74  lite3_syscall_pt
3cf0: 72 29 75 6e 6c 69 6e 6b 2c 20 20 20 20 20 20 20  r)unlink,       
3d00: 20 20 20 20 30 20 7d 2c 0a 23 64 65 66 69 6e 65      0 },.#define
3d10: 20 6f 73 55 6e 6c 69 6e 6b 20 20 20 20 28 28 69   osUnlink    ((i
3d20: 6e 74 28 2a 29 28 63 6f 6e 73 74 20 63 68 61 72  nt(*)(const char
3d30: 2a 29 29 61 53 79 73 63 61 6c 6c 5b 31 36 5d 2e  *))aSyscall[16].
3d40: 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20 22  pCurrent)..  { "
3d50: 6f 70 65 6e 44 69 72 65 63 74 6f 72 79 22 2c 20  openDirectory", 
3d60: 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63     (sqlite3_sysc
3d70: 61 6c 6c 5f 70 74 72 29 6f 70 65 6e 44 69 72 65  all_ptr)openDire
3d80: 63 74 6f 72 79 2c 20 20 20 20 20 20 30 20 7d 2c  ctory,      0 },
3d90: 0a 23 64 65 66 69 6e 65 20 6f 73 4f 70 65 6e 44  .#define osOpenD
3da0: 69 72 65 63 74 6f 72 79 20 28 28 69 6e 74 28 2a  irectory ((int(*
3db0: 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e  )(const char*,in
3dc0: 74 2a 29 29 61 53 79 73 63 61 6c 6c 5b 31 37 5d  t*))aSyscall[17]
3dd0: 2e 70 43 75 72 72 65 6e 74 29 0a 0a 20 20 7b 20  .pCurrent)..  { 
3de0: 22 6d 6b 64 69 72 22 2c 20 20 20 20 20 20 20 20  "mkdir",        
3df0: 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c  (sqlite3_syscall
3e00: 5f 70 74 72 29 6d 6b 64 69 72 2c 20 20 20 20 20  _ptr)mkdir,     
3e10: 20 20 20 20 20 20 30 20 7d 2c 0a 23 64 65 66 69        0 },.#defi
3e20: 6e 65 20 6f 73 4d 6b 64 69 72 20 20 20 20 20 28  ne osMkdir     (
3e30: 28 69 6e 74 28 2a 29 28 63 6f 6e 73 74 20 63 68  (int(*)(const ch
3e40: 61 72 2a 2c 6d 6f 64 65 5f 74 29 29 61 53 79 73  ar*,mode_t))aSys
3e50: 63 61 6c 6c 5b 31 38 5d 2e 70 43 75 72 72 65 6e  call[18].pCurren
3e60: 74 29 0a 0a 20 20 7b 20 22 72 6d 64 69 72 22 2c  t)..  { "rmdir",
3e70: 20 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33          (sqlite3
3e80: 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 72 6d 64  _syscall_ptr)rmd
3e90: 69 72 2c 20 20 20 20 20 20 20 20 20 20 20 30 20  ir,           0 
3ea0: 7d 2c 0a 23 64 65 66 69 6e 65 20 6f 73 52 6d 64  },.#define osRmd
3eb0: 69 72 20 20 20 20 20 28 28 69 6e 74 28 2a 29 28  ir     ((int(*)(
3ec0: 63 6f 6e 73 74 20 63 68 61 72 2a 29 29 61 53 79  const char*))aSy
3ed0: 73 63 61 6c 6c 5b 31 39 5d 2e 70 43 75 72 72 65  scall[19].pCurre
3ee0: 6e 74 29 0a 0a 23 69 66 20 64 65 66 69 6e 65 64  nt)..#if defined
3ef0: 28 48 41 56 45 5f 46 43 48 4f 57 4e 29 0a 20 20  (HAVE_FCHOWN).  
3f00: 7b 20 22 66 63 68 6f 77 6e 22 2c 20 20 20 20 20  { "fchown",     
3f10: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61    (sqlite3_sysca
3f20: 6c 6c 5f 70 74 72 29 66 63 68 6f 77 6e 2c 20 20  ll_ptr)fchown,  
3f30: 20 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6c          0 },.#el
3f40: 73 65 0a 20 20 7b 20 22 66 63 68 6f 77 6e 22 2c  se.  { "fchown",
3f50: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f         (sqlite3_
3f60: 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 20  syscall_ptr)0,  
3f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 7d               0 }
3f80: 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65  ,.#endif.#define
3f90: 20 6f 73 46 63 68 6f 77 6e 20 20 20 20 28 28 69   osFchown    ((i
3fa0: 6e 74 28 2a 29 28 69 6e 74 2c 75 69 64 5f 74 2c  nt(*)(int,uid_t,
3fb0: 67 69 64 5f 74 29 29 61 53 79 73 63 61 6c 6c 5b  gid_t))aSyscall[
3fc0: 32 30 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23  20].pCurrent)..#
3fd0: 69 66 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f  if defined(HAVE_
3fe0: 46 43 48 4f 57 4e 29 0a 20 20 7b 20 22 67 65 74  FCHOWN).  { "get
3ff0: 65 75 69 64 22 2c 20 20 20 20 20 20 28 73 71 6c  euid",      (sql
4000: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72  ite3_syscall_ptr
4010: 29 67 65 74 65 75 69 64 2c 20 20 20 20 20 20 20  )geteuid,       
4020: 20 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b    0 },.#else.  {
4030: 20 22 67 65 74 65 75 69 64 22 2c 20 20 20 20 20   "geteuid",     
4040: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
4050: 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20  l_ptr)0,        
4060: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64         0 },.#end
4070: 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 47 65 74  if.#define osGet
4080: 65 75 69 64 20 20 20 28 28 75 69 64 5f 74 28 2a  euid   ((uid_t(*
4090: 29 28 76 6f 69 64 29 29 61 53 79 73 63 61 6c 6c  )(void))aSyscall
40a0: 5b 32 31 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a  [21].pCurrent)..
40b0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c  #if !defined(SQL
40c0: 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 20 7c 7c  ITE_OMIT_WAL) ||
40d0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50   SQLITE_MAX_MMAP
40e0: 5f 53 49 5a 45 3e 30 0a 20 20 7b 20 22 6d 6d 61  _SIZE>0.  { "mma
40f0: 70 22 2c 20 20 20 20 20 20 20 20 20 28 73 71 6c  p",         (sql
4100: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72  ite3_syscall_ptr
4110: 29 6d 6d 61 70 2c 20 20 20 20 20 20 20 20 20 20  )mmap,          
4120: 20 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b    0 },.#else.  {
4130: 20 22 6d 6d 61 70 22 2c 20 20 20 20 20 20 20 20   "mmap",        
4140: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
4150: 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20  l_ptr)0,        
4160: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64         0 },.#end
4170: 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 4d 6d 61  if.#define osMma
4180: 70 20 28 28 76 6f 69 64 2a 28 2a 29 28 76 6f 69  p ((void*(*)(voi
4190: 64 2a 2c 73 69 7a 65 5f 74 2c 69 6e 74 2c 69 6e  d*,size_t,int,in
41a0: 74 2c 69 6e 74 2c 6f 66 66 5f 74 29 29 61 53 79  t,int,off_t))aSy
41b0: 73 63 61 6c 6c 5b 32 32 5d 2e 70 43 75 72 72 65  scall[22].pCurre
41c0: 6e 74 29 0a 0a 23 69 66 20 21 64 65 66 69 6e 65  nt)..#if !define
41d0: 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41  d(SQLITE_OMIT_WA
41e0: 4c 29 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58  L) || SQLITE_MAX
41f0: 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 7b  _MMAP_SIZE>0.  {
4200: 20 22 6d 75 6e 6d 61 70 22 2c 20 20 20 20 20 20   "munmap",      
4210: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
4220: 6c 5f 70 74 72 29 6d 75 6e 6d 61 70 2c 20 20 20  l_ptr)munmap,   
4230: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6c 73         0 },.#els
4240: 65 0a 20 20 7b 20 22 6d 75 6e 6d 61 70 22 2c 20  e.  { "munmap", 
4250: 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73        (sqlite3_s
4260: 79 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 20 20  yscall_ptr)0,   
4270: 20 20 20 20 20 20 20 20 20 20 20 20 30 20 7d 2c              0 },
4280: 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65 20  .#endif.#define 
4290: 6f 73 4d 75 6e 6d 61 70 20 28 28 69 6e 74 28 2a  osMunmap ((int(*
42a0: 29 28 76 6f 69 64 2a 2c 73 69 7a 65 5f 74 29 29  )(void*,size_t))
42b0: 61 53 79 73 63 61 6c 6c 5b 32 33 5d 2e 70 43 75  aSyscall[23].pCu
42c0: 72 72 65 6e 74 29 0a 0a 23 69 66 20 48 41 56 45  rrent)..#if HAVE
42d0: 5f 4d 52 45 4d 41 50 20 26 26 20 28 21 64 65 66  _MREMAP && (!def
42e0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54  ined(SQLITE_OMIT
42f0: 5f 57 41 4c 29 20 7c 7c 20 53 51 4c 49 54 45 5f  _WAL) || SQLITE_
4300: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 29  MAX_MMAP_SIZE>0)
4310: 0a 20 20 7b 20 22 6d 72 65 6d 61 70 22 2c 20 20  .  { "mremap",  
4320: 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 73 79       (sqlite3_sy
4330: 73 63 61 6c 6c 5f 70 74 72 29 6d 72 65 6d 61 70  scall_ptr)mremap
4340: 2c 20 20 20 20 20 20 20 20 20 20 30 20 7d 2c 0a  ,          0 },.
4350: 23 65 6c 73 65 0a 20 20 7b 20 22 6d 72 65 6d 61  #else.  { "mrema
4360: 70 22 2c 20 20 20 20 20 20 20 28 73 71 6c 69 74  p",       (sqlit
4370: 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 30  e3_syscall_ptr)0
4380: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4390: 30 20 7d 2c 0a 23 65 6e 64 69 66 0a 23 64 65 66  0 },.#endif.#def
43a0: 69 6e 65 20 6f 73 4d 72 65 6d 61 70 20 28 28 76  ine osMremap ((v
43b0: 6f 69 64 2a 28 2a 29 28 76 6f 69 64 2a 2c 73 69  oid*(*)(void*,si
43c0: 7a 65 5f 74 2c 73 69 7a 65 5f 74 2c 69 6e 74 2c  ze_t,size_t,int,
43d0: 2e 2e 2e 29 29 61 53 79 73 63 61 6c 6c 5b 32 34  ...))aSyscall[24
43e0: 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66  ].pCurrent)..#if
43f0: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45   !defined(SQLITE
4400: 5f 4f 4d 49 54 5f 57 41 4c 29 20 7c 7c 20 53 51  _OMIT_WAL) || SQ
4410: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49  LITE_MAX_MMAP_SI
4420: 5a 45 3e 30 0a 20 20 7b 20 22 67 65 74 70 61 67  ZE>0.  { "getpag
4430: 65 73 69 7a 65 22 2c 20 20 28 73 71 6c 69 74 65  esize",  (sqlite
4440: 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 29 75 6e  3_syscall_ptr)un
4450: 69 78 47 65 74 70 61 67 65 73 69 7a 65 2c 20 30  ixGetpagesize, 0
4460: 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b 20 22 67   },.#else.  { "g
4470: 65 74 70 61 67 65 73 69 7a 65 22 2c 20 20 28 73  etpagesize",  (s
4480: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70  qlite3_syscall_p
4490: 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 20 20  tr)0,           
44a0: 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64 69 66 0a      0 },.#endif.
44b0: 23 64 65 66 69 6e 65 20 6f 73 47 65 74 70 61 67  #define osGetpag
44c0: 65 73 69 7a 65 20 28 28 69 6e 74 28 2a 29 28 76  esize ((int(*)(v
44d0: 6f 69 64 29 29 61 53 79 73 63 61 6c 6c 5b 32 35  oid))aSyscall[25
44e0: 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 23 69 66  ].pCurrent)..#if
44f0: 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f 52 45   defined(HAVE_RE
4500: 41 44 4c 49 4e 4b 29 0a 20 20 7b 20 22 72 65 61  ADLINK).  { "rea
4510: 64 6c 69 6e 6b 22 2c 20 20 20 20 20 28 73 71 6c  dlink",     (sql
4520: 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72  ite3_syscall_ptr
4530: 29 72 65 61 64 6c 69 6e 6b 2c 20 20 20 20 20 20  )readlink,      
4540: 20 20 30 20 7d 2c 0a 23 65 6c 73 65 0a 20 20 7b    0 },.#else.  {
4550: 20 22 72 65 61 64 6c 69 6e 6b 22 2c 20 20 20 20   "readlink",    
4560: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
4570: 6c 5f 70 74 72 29 30 2c 20 20 20 20 20 20 20 20  l_ptr)0,        
4580: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6e 64         0 },.#end
4590: 69 66 0a 23 64 65 66 69 6e 65 20 6f 73 52 65 61  if.#define osRea
45a0: 64 6c 69 6e 6b 20 28 28 73 73 69 7a 65 5f 74 28  dlink ((ssize_t(
45b0: 2a 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63  *)(const char*,c
45c0: 68 61 72 2a 2c 73 69 7a 65 5f 74 29 29 61 53 79  har*,size_t))aSy
45d0: 73 63 61 6c 6c 5b 32 36 5d 2e 70 43 75 72 72 65  scall[26].pCurre
45e0: 6e 74 29 0a 0a 23 69 66 20 64 65 66 69 6e 65 64  nt)..#if defined
45f0: 28 48 41 56 45 5f 4c 53 54 41 54 29 0a 20 20 7b  (HAVE_LSTAT).  {
4600: 20 22 6c 73 74 61 74 22 2c 20 20 20 20 20 20 20   "lstat",       
4610: 20 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61    (sqlite3_sysca
4620: 6c 6c 5f 70 74 72 29 6c 73 74 61 74 2c 20 20 20  ll_ptr)lstat,   
4630: 20 20 20 20 20 20 20 30 20 7d 2c 0a 23 65 6c 73         0 },.#els
4640: 65 0a 20 20 7b 20 22 6c 73 74 61 74 22 2c 20 20  e.  { "lstat",  
4650: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f         (sqlite3_
4660: 73 79 73 63 61 6c 6c 5f 70 74 72 29 30 2c 20 20  syscall_ptr)0,  
4670: 20 20 20 20 20 20 20 20 20 20 20 20 30 20 7d 2c              0 },
4680: 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 6e 65 20  .#endif.#define 
4690: 6f 73 4c 73 74 61 74 20 20 20 20 20 20 28 28 69  osLstat      ((i
46a0: 6e 74 28 2a 29 28 63 6f 6e 73 74 20 63 68 61 72  nt(*)(const char
46b0: 2a 2c 73 74 72 75 63 74 20 73 74 61 74 2a 29 29  *,struct stat*))
46c0: 61 53 79 73 63 61 6c 6c 5b 32 37 5d 2e 70 43 75  aSyscall[27].pCu
46d0: 72 72 65 6e 74 29 0a 0a 23 69 66 20 64 65 66 69  rrent)..#if defi
46e0: 6e 65 64 28 5f 5f 6c 69 6e 75 78 5f 5f 29 20 26  ned(__linux__) &
46f0: 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45  & defined(SQLITE
4700: 5f 45 4e 41 42 4c 45 5f 42 41 54 43 48 5f 41 54  _ENABLE_BATCH_AT
4710: 4f 4d 49 43 5f 57 52 49 54 45 29 0a 23 20 69 66  OMIC_WRITE).# if
4720: 64 65 66 20 5f 5f 41 4e 44 52 4f 49 44 5f 5f 0a  def __ANDROID__.
4730: 20 20 7b 20 22 69 6f 63 74 6c 22 2c 20 28 73 71    { "ioctl", (sq
4740: 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74  lite3_syscall_pt
4750: 72 29 28 69 6e 74 28 2a 29 28 69 6e 74 2c 20 69  r)(int(*)(int, i
4760: 6e 74 2c 20 2e 2e 2e 29 29 69 6f 63 74 6c 2c 20  nt, ...))ioctl, 
4770: 30 20 7d 2c 0a 23 20 65 6c 73 65 0a 20 20 7b 20  0 },.# else.  { 
4780: 22 69 6f 63 74 6c 22 2c 20 20 20 20 20 20 20 20  "ioctl",        
4790: 20 28 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c   (sqlite3_syscal
47a0: 6c 5f 70 74 72 29 69 6f 63 74 6c 2c 20 20 20 20  l_ptr)ioctl,    
47b0: 20 20 20 20 20 20 30 20 7d 2c 0a 23 20 65 6e 64        0 },.# end
47c0: 69 66 0a 23 65 6c 73 65 0a 20 20 7b 20 22 69 6f  if.#else.  { "io
47d0: 63 74 6c 22 2c 20 20 20 20 20 20 20 20 20 28 73  ctl",         (s
47e0: 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70  qlite3_syscall_p
47f0: 74 72 29 30 2c 20 20 20 20 20 20 20 20 20 20 20  tr)0,           
4800: 20 20 20 30 20 7d 2c 0a 23 65 6e 64 69 66 0a 23     0 },.#endif.#
4810: 64 65 66 69 6e 65 20 6f 73 49 6f 63 74 6c 20 28  define osIoctl (
4820: 28 69 6e 74 28 2a 29 28 69 6e 74 2c 69 6e 74 2c  (int(*)(int,int,
4830: 2e 2e 2e 29 29 61 53 79 73 63 61 6c 6c 5b 32 38  ...))aSyscall[28
4840: 5d 2e 70 43 75 72 72 65 6e 74 29 0a 0a 7d 3b 20  ].pCurrent)..}; 
4850: 2f 2a 20 45 6e 64 20 6f 66 20 74 68 65 20 6f 76  /* End of the ov
4860: 65 72 72 69 64 65 61 62 6c 65 20 73 79 73 74 65  errideable syste
4870: 6d 20 63 61 6c 6c 73 20 2a 2f 0a 0a 0a 2f 2a 0a  m calls */.../*.
4880: 2a 2a 20 4f 6e 20 73 6f 6d 65 20 73 79 73 74 65  ** On some syste
4890: 6d 73 2c 20 63 61 6c 6c 73 20 74 6f 20 66 63 68  ms, calls to fch
48a0: 6f 77 6e 28 29 20 77 69 6c 6c 20 74 72 69 67 67  own() will trigg
48b0: 65 72 20 61 20 6d 65 73 73 61 67 65 20 69 6e 20  er a message in 
48c0: 61 20 73 65 63 75 72 69 74 79 0a 2a 2a 20 6c 6f  a security.** lo
48d0: 67 20 69 66 20 74 68 65 79 20 63 6f 6d 65 20 66  g if they come f
48e0: 72 6f 6d 20 6e 6f 6e 2d 72 6f 6f 74 20 70 72 6f  rom non-root pro
48f0: 63 65 73 73 65 73 2e 20 20 53 6f 20 61 76 6f 69  cesses.  So avoi
4900: 64 20 63 61 6c 6c 69 6e 67 20 66 63 68 6f 77 6e  d calling fchown
4910: 28 29 20 69 66 0a 2a 2a 20 77 65 20 61 72 65 20  () if.** we are 
4920: 6e 6f 74 20 72 75 6e 6e 69 6e 67 20 61 73 20 72  not running as r
4930: 6f 6f 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  oot..*/.static i
4940: 6e 74 20 72 6f 62 75 73 74 46 63 68 6f 77 6e 28  nt robustFchown(
4950: 69 6e 74 20 66 64 2c 20 75 69 64 5f 74 20 75 69  int fd, uid_t ui
4960: 64 2c 20 67 69 64 5f 74 20 67 69 64 29 7b 0a 23  d, gid_t gid){.#
4970: 69 66 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f  if defined(HAVE_
4980: 46 43 48 4f 57 4e 29 0a 20 20 72 65 74 75 72 6e  FCHOWN).  return
4990: 20 6f 73 47 65 74 65 75 69 64 28 29 20 3f 20 30   osGeteuid() ? 0
49a0: 20 3a 20 6f 73 46 63 68 6f 77 6e 28 66 64 2c 75   : osFchown(fd,u
49b0: 69 64 2c 67 69 64 29 3b 0a 23 65 6c 73 65 0a 20  id,gid);.#else. 
49c0: 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69   return 0;.#endi
49d0: 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  f.}../*.** This 
49e0: 69 73 20 74 68 65 20 78 53 65 74 53 79 73 74 65  is the xSetSyste
49f0: 6d 43 61 6c 6c 28 29 20 6d 65 74 68 6f 64 20 6f  mCall() method o
4a00: 66 20 73 71 6c 69 74 65 33 5f 76 66 73 20 66 6f  f sqlite3_vfs fo
4a10: 72 20 61 6c 6c 20 6f 66 20 74 68 65 0a 2a 2a 20  r all of the.** 
4a20: 22 75 6e 69 78 22 20 56 46 53 65 73 2e 20 20 52  "unix" VFSes.  R
4a30: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20  eturn SQLITE_OK 
4a40: 6f 70 6f 6e 20 73 75 63 63 65 73 73 66 75 6c 6c  opon successfull
4a50: 79 20 75 70 64 61 74 69 6e 67 20 74 68 65 0a 2a  y updating the.*
4a60: 2a 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 70 6f  * system call po
4a70: 69 6e 74 65 72 2c 20 6f 72 20 53 51 4c 49 54 45  inter, or SQLITE
4a80: 5f 4e 4f 54 46 4f 55 4e 44 20 69 66 20 74 68 65  _NOTFOUND if the
4a90: 72 65 20 69 73 20 6e 6f 20 63 6f 6e 66 69 67 75  re is no configu
4aa0: 72 61 62 6c 65 0a 2a 2a 20 73 79 73 74 65 6d 20  rable.** system 
4ab0: 63 61 6c 6c 20 6e 61 6d 65 64 20 7a 4e 61 6d 65  call named zName
4ac0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
4ad0: 75 6e 69 78 53 65 74 53 79 73 74 65 6d 43 61 6c  unixSetSystemCal
4ae0: 6c 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73  l(.  sqlite3_vfs
4af0: 20 2a 70 4e 6f 74 55 73 65 64 2c 20 20 20 20 20   *pNotUsed,     
4b00: 20 20 20 2f 2a 20 54 68 65 20 56 46 53 20 70 6f     /* The VFS po
4b10: 69 6e 74 65 72 2e 20 20 4e 6f 74 20 75 73 65 64  inter.  Not used
4b20: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
4b30: 20 2a 7a 4e 61 6d 65 2c 20 20 20 20 20 20 20 20   *zName,        
4b40: 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 73      /* Name of s
4b50: 79 73 74 65 6d 20 63 61 6c 6c 20 74 6f 20 6f 76  ystem call to ov
4b60: 65 72 72 69 64 65 20 2a 2f 0a 20 20 73 71 6c 69  erride */.  sqli
4b70: 74 65 33 5f 73 79 73 63 61 6c 6c 5f 70 74 72 20  te3_syscall_ptr 
4b80: 70 4e 65 77 46 75 6e 63 20 20 2f 2a 20 50 6f 69  pNewFunc  /* Poi
4b90: 6e 74 65 72 20 74 6f 20 6e 65 77 20 73 79 73 74  nter to new syst
4ba0: 65 6d 20 63 61 6c 6c 20 76 61 6c 75 65 20 2a 2f  em call value */
4bb0: 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 69  .){.  unsigned i
4bc0: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72 63 20 3d  nt i;.  int rc =
4bd0: 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44   SQLITE_NOTFOUND
4be0: 3b 0a 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  ;..  UNUSED_PARA
4bf0: 4d 45 54 45 52 28 70 4e 6f 74 55 73 65 64 29 3b  METER(pNotUsed);
4c00: 0a 20 20 69 66 28 20 7a 4e 61 6d 65 3d 3d 30 20  .  if( zName==0 
4c10: 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 6e 6f 20  ){.    /* If no 
4c20: 7a 4e 61 6d 65 20 69 73 20 67 69 76 65 6e 2c 20  zName is given, 
4c30: 72 65 73 74 6f 72 65 20 61 6c 6c 20 73 79 73 74  restore all syst
4c40: 65 6d 20 63 61 6c 6c 73 20 74 6f 20 74 68 65 69  em calls to thei
4c50: 72 20 64 65 66 61 75 6c 74 0a 20 20 20 20 2a 2a  r default.    **
4c60: 20 73 65 74 74 69 6e 67 73 20 61 6e 64 20 72 65   settings and re
4c70: 74 75 72 6e 20 4e 55 4c 4c 0a 20 20 20 20 2a 2f  turn NULL.    */
4c80: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
4c90: 5f 4f 4b 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30  _OK;.    for(i=0
4ca0: 3b 20 69 3c 73 69 7a 65 6f 66 28 61 53 79 73 63  ; i<sizeof(aSysc
4cb0: 61 6c 6c 29 2f 73 69 7a 65 6f 66 28 61 53 79 73  all)/sizeof(aSys
4cc0: 63 61 6c 6c 5b 30 5d 29 3b 20 69 2b 2b 29 7b 0a  call[0]); i++){.
4cd0: 20 20 20 20 20 20 69 66 28 20 61 53 79 73 63 61        if( aSysca
4ce0: 6c 6c 5b 69 5d 2e 70 44 65 66 61 75 6c 74 20 29  ll[i].pDefault )
4cf0: 7b 0a 20 20 20 20 20 20 20 20 61 53 79 73 63 61  {.        aSysca
4d00: 6c 6c 5b 69 5d 2e 70 43 75 72 72 65 6e 74 20 3d  ll[i].pCurrent =
4d10: 20 61 53 79 73 63 61 6c 6c 5b 69 5d 2e 70 44 65   aSyscall[i].pDe
4d20: 66 61 75 6c 74 3b 0a 20 20 20 20 20 20 7d 0a 20  fault;.      }. 
4d30: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20     }.  }else{.  
4d40: 20 20 2f 2a 20 49 66 20 7a 4e 61 6d 65 20 69 73    /* If zName is
4d50: 20 73 70 65 63 69 66 69 65 64 2c 20 6f 70 65 72   specified, oper
4d60: 61 74 65 20 6f 6e 20 6f 6e 6c 79 20 74 68 65 20  ate on only the 
4d70: 6f 6e 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 0a  one system call.
4d80: 20 20 20 20 2a 2a 20 73 70 65 63 69 66 69 65 64      ** specified
4d90: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72  ..    */.    for
4da0: 28 69 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28 61  (i=0; i<sizeof(a
4db0: 53 79 73 63 61 6c 6c 29 2f 73 69 7a 65 6f 66 28  Syscall)/sizeof(
4dc0: 61 53 79 73 63 61 6c 6c 5b 30 5d 29 3b 20 69 2b  aSyscall[0]); i+
4dd0: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74  +){.      if( st
4de0: 72 63 6d 70 28 7a 4e 61 6d 65 2c 20 61 53 79 73  rcmp(zName, aSys
4df0: 63 61 6c 6c 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d  call[i].zName)==
4e00: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28  0 ){.        if(
4e10: 20 61 53 79 73 63 61 6c 6c 5b 69 5d 2e 70 44 65   aSyscall[i].pDe
4e20: 66 61 75 6c 74 3d 3d 30 20 29 7b 0a 20 20 20 20  fault==0 ){.    
4e30: 20 20 20 20 20 20 61 53 79 73 63 61 6c 6c 5b 69        aSyscall[i
4e40: 5d 2e 70 44 65 66 61 75 6c 74 20 3d 20 61 53 79  ].pDefault = aSy
4e50: 73 63 61 6c 6c 5b 69 5d 2e 70 43 75 72 72 65 6e  scall[i].pCurren
4e60: 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  t;.        }.   
4e70: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
4e80: 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 69 66 28  _OK;.        if(
4e90: 20 70 4e 65 77 46 75 6e 63 3d 3d 30 20 29 20 70   pNewFunc==0 ) p
4ea0: 4e 65 77 46 75 6e 63 20 3d 20 61 53 79 73 63 61  NewFunc = aSysca
4eb0: 6c 6c 5b 69 5d 2e 70 44 65 66 61 75 6c 74 3b 0a  ll[i].pDefault;.
4ec0: 20 20 20 20 20 20 20 20 61 53 79 73 63 61 6c 6c          aSyscall
4ed0: 5b 69 5d 2e 70 43 75 72 72 65 6e 74 20 3d 20 70  [i].pCurrent = p
4ee0: 4e 65 77 46 75 6e 63 3b 0a 20 20 20 20 20 20 20  NewFunc;.       
4ef0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
4f00: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
4f10: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
4f20: 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65  Return the value
4f30: 20 6f 66 20 61 20 73 79 73 74 65 6d 20 63 61 6c   of a system cal
4f40: 6c 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20  l.  Return NULL 
4f50: 69 66 20 7a 4e 61 6d 65 20 69 73 20 6e 6f 74 20  if zName is not 
4f60: 61 0a 2a 2a 20 72 65 63 6f 67 6e 69 7a 65 64 20  a.** recognized 
4f70: 73 79 73 74 65 6d 20 63 61 6c 6c 20 6e 61 6d 65  system call name
4f80: 2e 20 20 4e 55 4c 4c 20 69 73 20 61 6c 73 6f 20  .  NULL is also 
4f90: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20  returned if the 
4fa0: 73 79 73 74 65 6d 20 63 61 6c 6c 0a 2a 2a 20 69  system call.** i
4fb0: 73 20 63 75 72 72 65 6e 74 6c 79 20 75 6e 64 65  s currently unde
4fc0: 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  fined..*/.static
4fd0: 20 73 71 6c 69 74 65 33 5f 73 79 73 63 61 6c 6c   sqlite3_syscall
4fe0: 5f 70 74 72 20 75 6e 69 78 47 65 74 53 79 73 74  _ptr unixGetSyst
4ff0: 65 6d 43 61 6c 6c 28 0a 20 20 73 71 6c 69 74 65  emCall(.  sqlite
5000: 33 5f 76 66 73 20 2a 70 4e 6f 74 55 73 65 64 2c  3_vfs *pNotUsed,
5010: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
5020: 4e 61 6d 65 0a 29 7b 0a 20 20 75 6e 73 69 67 6e  Name.){.  unsign
5030: 65 64 20 69 6e 74 20 69 3b 0a 0a 20 20 55 4e 55  ed int i;..  UNU
5040: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 70 4e  SED_PARAMETER(pN
5050: 6f 74 55 73 65 64 29 3b 0a 20 20 66 6f 72 28 69  otUsed);.  for(i
5060: 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28 61 53 79  =0; i<sizeof(aSy
5070: 73 63 61 6c 6c 29 2f 73 69 7a 65 6f 66 28 61 53  scall)/sizeof(aS
5080: 79 73 63 61 6c 6c 5b 30 5d 29 3b 20 69 2b 2b 29  yscall[0]); i++)
5090: 7b 0a 20 20 20 20 69 66 28 20 73 74 72 63 6d 70  {.    if( strcmp
50a0: 28 7a 4e 61 6d 65 2c 20 61 53 79 73 63 61 6c 6c  (zName, aSyscall
50b0: 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d 30 20 29 20  [i].zName)==0 ) 
50c0: 72 65 74 75 72 6e 20 61 53 79 73 63 61 6c 6c 5b  return aSyscall[
50d0: 69 5d 2e 70 43 75 72 72 65 6e 74 3b 0a 20 20 7d  i].pCurrent;.  }
50e0: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
50f0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
5100: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 72   name of the fir
5110: 73 74 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 61  st system call a
5120: 66 74 65 72 20 7a 4e 61 6d 65 2e 20 20 49 66 20  fter zName.  If 
5130: 7a 4e 61 6d 65 3d 3d 4e 55 4c 4c 0a 2a 2a 20 74  zName==NULL.** t
5140: 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 20 6e  hen return the n
5150: 61 6d 65 20 6f 66 20 74 68 65 20 66 69 72 73 74  ame of the first
5160: 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 20 20 52   system call.  R
5170: 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 20 7a 4e  eturn NULL if zN
5180: 61 6d 65 0a 2a 2a 20 69 73 20 74 68 65 20 6c 61  ame.** is the la
5190: 73 74 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 6f  st system call o
51a0: 72 20 69 66 20 7a 4e 61 6d 65 20 69 73 20 6e 6f  r if zName is no
51b0: 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20  t the name of a 
51c0: 76 61 6c 69 64 0a 2a 2a 20 73 79 73 74 65 6d 20  valid.** system 
51d0: 63 61 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  call..*/.static 
51e0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 75 6e 69 78  const char *unix
51f0: 4e 65 78 74 53 79 73 74 65 6d 43 61 6c 6c 28 73  NextSystemCall(s
5200: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 2c 20 63  qlite3_vfs *p, c
5210: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65  onst char *zName
5220: 29 7b 0a 20 20 69 6e 74 20 69 20 3d 20 2d 31 3b  ){.  int i = -1;
5230: 0a 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  ..  UNUSED_PARAM
5240: 45 54 45 52 28 70 29 3b 0a 20 20 69 66 28 20 7a  ETER(p);.  if( z
5250: 4e 61 6d 65 20 29 7b 0a 20 20 20 20 66 6f 72 28  Name ){.    for(
5260: 69 3d 30 3b 20 69 3c 41 72 72 61 79 53 69 7a 65  i=0; i<ArraySize
5270: 28 61 53 79 73 63 61 6c 6c 29 2d 31 3b 20 69 2b  (aSyscall)-1; i+
5280: 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74  +){.      if( st
5290: 72 63 6d 70 28 7a 4e 61 6d 65 2c 20 61 53 79 73  rcmp(zName, aSys
52a0: 63 61 6c 6c 5b 69 5d 2e 7a 4e 61 6d 65 29 3d 3d  call[i].zName)==
52b0: 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d  0 ) break;.    }
52c0: 0a 20 20 7d 0a 20 20 66 6f 72 28 69 2b 2b 3b 20  .  }.  for(i++; 
52d0: 69 3c 41 72 72 61 79 53 69 7a 65 28 61 53 79 73  i<ArraySize(aSys
52e0: 63 61 6c 6c 29 3b 20 69 2b 2b 29 7b 0a 20 20 20  call); i++){.   
52f0: 20 69 66 28 20 61 53 79 73 63 61 6c 6c 5b 69 5d   if( aSyscall[i]
5300: 2e 70 43 75 72 72 65 6e 74 21 3d 30 20 29 20 72  .pCurrent!=0 ) r
5310: 65 74 75 72 6e 20 61 53 79 73 63 61 6c 6c 5b 69  eturn aSyscall[i
5320: 5d 2e 7a 4e 61 6d 65 3b 0a 20 20 7d 0a 20 20 72  ].zName;.  }.  r
5330: 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn 0;.}../*.*
5340: 2a 20 44 6f 20 6e 6f 74 20 61 63 63 65 70 74 20  * Do not accept 
5350: 61 6e 79 20 66 69 6c 65 20 64 65 73 63 72 69 70  any file descrip
5360: 74 6f 72 20 6c 65 73 73 20 74 68 61 6e 20 74 68  tor less than th
5370: 69 73 20 76 61 6c 75 65 2c 20 69 6e 20 6f 72 64  is value, in ord
5380: 65 72 20 74 6f 20 61 76 6f 69 64 0a 2a 2a 20 6f  er to avoid.** o
5390: 70 65 6e 69 6e 67 20 64 61 74 61 62 61 73 65 20  pening database 
53a0: 66 69 6c 65 20 75 73 69 6e 67 20 66 69 6c 65 20  file using file 
53b0: 64 65 73 63 72 69 70 74 6f 72 73 20 74 68 61 74  descriptors that
53c0: 20 61 72 65 20 63 6f 6d 6d 6f 6e 6c 79 20 75 73   are commonly us
53d0: 65 64 20 66 6f 72 20 0a 2a 2a 20 73 74 61 6e 64  ed for .** stand
53e0: 61 72 64 20 69 6e 70 75 74 2c 20 6f 75 74 70 75  ard input, outpu
53f0: 74 2c 20 61 6e 64 20 65 72 72 6f 72 2e 0a 2a 2f  t, and error..*/
5400: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
5410: 4d 49 4e 49 4d 55 4d 5f 46 49 4c 45 5f 44 45 53  MINIMUM_FILE_DES
5420: 43 52 49 50 54 4f 52 0a 23 20 64 65 66 69 6e 65  CRIPTOR.# define
5430: 20 53 51 4c 49 54 45 5f 4d 49 4e 49 4d 55 4d 5f   SQLITE_MINIMUM_
5440: 46 49 4c 45 5f 44 45 53 43 52 49 50 54 4f 52 20  FILE_DESCRIPTOR 
5450: 33 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  3.#endif../*.** 
5460: 49 6e 76 6f 6b 65 20 6f 70 65 6e 28 29 2e 20 20  Invoke open().  
5470: 44 6f 20 73 6f 20 6d 75 6c 74 69 70 6c 65 20 74  Do so multiple t
5480: 69 6d 65 73 2c 20 75 6e 74 69 6c 20 69 74 20 65  imes, until it e
5490: 69 74 68 65 72 20 73 75 63 63 65 65 64 73 20 6f  ither succeeds o
54a0: 72 0a 2a 2a 20 66 61 69 6c 73 20 66 6f 72 20 73  r.** fails for s
54b0: 6f 6d 65 20 72 65 61 73 6f 6e 20 6f 74 68 65 72  ome reason other
54c0: 20 74 68 61 6e 20 45 49 4e 54 52 2e 0a 2a 2a 0a   than EINTR..**.
54d0: 2a 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 63  ** If the file c
54e0: 72 65 61 74 69 6f 6e 20 6d 6f 64 65 20 22 6d 22  reation mode "m"
54f0: 20 69 73 20 30 20 74 68 65 6e 20 73 65 74 20 69   is 0 then set i
5500: 74 20 74 6f 20 74 68 65 20 64 65 66 61 75 6c 74  t to the default
5510: 20 66 6f 72 0a 2a 2a 20 53 51 4c 69 74 65 2e 20   for.** SQLite. 
5520: 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20   The default is 
5530: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46  SQLITE_DEFAULT_F
5540: 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 20  ILE_PERMISSIONS 
5550: 28 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 30 36 34  (normally.** 064
5560: 34 29 20 61 73 20 6d 6f 64 69 66 69 65 64 20 62  4) as modified b
5570: 79 20 74 68 65 20 73 79 73 74 65 6d 20 75 6d 61  y the system uma
5580: 73 6b 2e 20 20 49 66 20 6d 20 69 73 20 6e 6f 74  sk.  If m is not
5590: 20 30 2c 20 74 68 65 6e 0a 2a 2a 20 6d 61 6b 65   0, then.** make
55a0: 20 74 68 65 20 66 69 6c 65 20 63 72 65 61 74 69   the file creati
55b0: 6f 6e 20 6d 6f 64 65 20 62 65 20 65 78 61 63 74  on mode be exact
55c0: 6c 79 20 6d 20 69 67 6e 6f 72 69 6e 67 20 74 68  ly m ignoring th
55d0: 65 20 75 6d 61 73 6b 2e 0a 2a 2a 0a 2a 2a 20 54  e umask..**.** T
55e0: 68 65 20 6d 20 70 61 72 61 6d 65 74 65 72 20 77  he m parameter w
55f0: 69 6c 6c 20 62 65 20 6e 6f 6e 2d 7a 65 72 6f 20  ill be non-zero 
5600: 6f 6e 6c 79 20 77 68 65 6e 20 63 72 65 61 74 69  only when creati
5610: 6e 67 20 2d 77 61 6c 2c 20 2d 6a 6f 75 72 6e 61  ng -wal, -journa
5620: 6c 2c 0a 2a 2a 20 61 6e 64 20 2d 73 68 6d 20 66  l,.** and -shm f
5630: 69 6c 65 73 2e 20 20 57 65 20 77 61 6e 74 20 74  iles.  We want t
5640: 68 6f 73 65 20 66 69 6c 65 73 20 74 6f 20 68 61  hose files to ha
5650: 76 65 20 2a 65 78 61 63 74 6c 79 2a 20 74 68 65  ve *exactly* the
5660: 20 73 61 6d 65 0a 2a 2a 20 70 65 72 6d 69 73 73   same.** permiss
5670: 69 6f 6e 73 20 61 73 20 74 68 65 69 72 20 6f 72  ions as their or
5680: 69 67 69 6e 61 6c 20 64 61 74 61 62 61 73 65 2c  iginal database,
5690: 20 75 6e 61 64 75 6c 74 65 72 61 74 65 64 20 62   unadulterated b
56a0: 79 20 74 68 65 20 75 6d 61 73 6b 2e 0a 2a 2a 20  y the umask..** 
56b0: 49 6e 20 74 68 61 74 20 77 61 79 2c 20 69 66 20  In that way, if 
56c0: 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  a database file 
56d0: 69 73 20 2d 72 77 2d 72 77 2d 72 77 20 6f 72 20  is -rw-rw-rw or 
56e0: 2d 72 77 2d 72 77 2d 72 2d 2c 20 61 6e 64 20 61  -rw-rw-r-, and a
56f0: 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  .** transaction 
5700: 63 72 61 73 68 65 73 20 61 6e 64 20 6c 65 61 76  crashes and leav
5710: 65 73 20 62 65 68 69 6e 64 20 68 6f 74 20 6a 6f  es behind hot jo
5720: 75 72 6e 61 6c 73 2c 20 74 68 65 6e 20 61 6e 79  urnals, then any
5730: 0a 2a 2a 20 70 72 6f 63 65 73 73 20 74 68 61 74  .** process that
5740: 20 69 73 20 61 62 6c 65 20 74 6f 20 77 72 69 74   is able to writ
5750: 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  e to the databas
5760: 65 20 77 69 6c 6c 20 61 6c 73 6f 20 62 65 20 61  e will also be a
5770: 62 6c 65 20 74 6f 0a 2a 2a 20 72 65 63 6f 76 65  ble to.** recove
5780: 72 20 74 68 65 20 68 6f 74 20 6a 6f 75 72 6e 61  r the hot journa
5790: 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ls..*/.static in
57a0: 74 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 63 6f  t robust_open(co
57b0: 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74  nst char *z, int
57c0: 20 66 2c 20 6d 6f 64 65 5f 74 20 6d 29 7b 0a 20   f, mode_t m){. 
57d0: 20 69 6e 74 20 66 64 3b 0a 20 20 6d 6f 64 65 5f   int fd;.  mode_
57e0: 74 20 6d 32 20 3d 20 6d 20 3f 20 6d 20 3a 20 53  t m2 = m ? m : S
57f0: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49  QLITE_DEFAULT_FI
5800: 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 3b 0a  LE_PERMISSIONS;.
5810: 20 20 77 68 69 6c 65 28 31 29 7b 0a 23 69 66 20    while(1){.#if 
5820: 64 65 66 69 6e 65 64 28 4f 5f 43 4c 4f 45 58 45  defined(O_CLOEXE
5830: 43 29 0a 20 20 20 20 66 64 20 3d 20 6f 73 4f 70  C).    fd = osOp
5840: 65 6e 28 7a 2c 66 7c 4f 5f 43 4c 4f 45 58 45 43  en(z,f|O_CLOEXEC
5850: 2c 6d 32 29 3b 0a 23 65 6c 73 65 0a 20 20 20 20  ,m2);.#else.    
5860: 66 64 20 3d 20 6f 73 4f 70 65 6e 28 7a 2c 66 2c  fd = osOpen(z,f,
5870: 6d 32 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  m2);.#endif.    
5880: 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 20  if( fd<0 ){.    
5890: 20 20 69 66 28 20 65 72 72 6e 6f 3d 3d 45 49 4e    if( errno==EIN
58a0: 54 52 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  TR ) continue;. 
58b0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
58c0: 7d 0a 20 20 20 20 69 66 28 20 66 64 3e 3d 53 51  }.    if( fd>=SQ
58d0: 4c 49 54 45 5f 4d 49 4e 49 4d 55 4d 5f 46 49 4c  LITE_MINIMUM_FIL
58e0: 45 5f 44 45 53 43 52 49 50 54 4f 52 20 29 20 62  E_DESCRIPTOR ) b
58f0: 72 65 61 6b 3b 0a 20 20 20 20 6f 73 43 6c 6f 73  reak;.    osClos
5900: 65 28 66 64 29 3b 0a 20 20 20 20 73 71 6c 69 74  e(fd);.    sqlit
5910: 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 57 41  e3_log(SQLITE_WA
5920: 52 4e 49 4e 47 2c 20 0a 20 20 20 20 20 20 20 20  RNING, .        
5930: 20 20 20 20 20 20 20 20 22 61 74 74 65 6d 70 74          "attempt
5940: 20 74 6f 20 6f 70 65 6e 20 5c 22 25 73 5c 22 20   to open \"%s\" 
5950: 61 73 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  as file descript
5960: 6f 72 20 25 64 22 2c 20 7a 2c 20 66 64 29 3b 0a  or %d", z, fd);.
5970: 20 20 20 20 66 64 20 3d 20 2d 31 3b 0a 20 20 20      fd = -1;.   
5980: 20 69 66 28 20 6f 73 4f 70 65 6e 28 22 2f 64 65   if( osOpen("/de
5990: 76 2f 6e 75 6c 6c 22 2c 20 66 2c 20 6d 29 3c 30  v/null", f, m)<0
59a0: 20 29 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20   ) break;.  }.  
59b0: 69 66 28 20 66 64 3e 3d 30 20 29 7b 0a 20 20 20  if( fd>=0 ){.   
59c0: 20 69 66 28 20 6d 21 3d 30 20 29 7b 0a 20 20 20   if( m!=0 ){.   
59d0: 20 20 20 73 74 72 75 63 74 20 73 74 61 74 20 73     struct stat s
59e0: 74 61 74 62 75 66 3b 0a 20 20 20 20 20 20 69 66  tatbuf;.      if
59f0: 28 20 6f 73 46 73 74 61 74 28 66 64 2c 20 26 73  ( osFstat(fd, &s
5a00: 74 61 74 62 75 66 29 3d 3d 30 20 0a 20 20 20 20  tatbuf)==0 .    
5a10: 20 20 20 26 26 20 73 74 61 74 62 75 66 2e 73 74     && statbuf.st
5a20: 5f 73 69 7a 65 3d 3d 30 0a 20 20 20 20 20 20 20  _size==0.       
5a30: 26 26 20 28 73 74 61 74 62 75 66 2e 73 74 5f 6d  && (statbuf.st_m
5a40: 6f 64 65 26 30 37 37 37 29 21 3d 6d 20 0a 20 20  ode&0777)!=m .  
5a50: 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 6f      ){.        o
5a60: 73 46 63 68 6d 6f 64 28 66 64 2c 20 6d 29 3b 0a  sFchmod(fd, m);.
5a70: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 23 69        }.    }.#i
5a80: 66 20 64 65 66 69 6e 65 64 28 46 44 5f 43 4c 4f  f defined(FD_CLO
5a90: 45 58 45 43 29 20 26 26 20 28 21 64 65 66 69 6e  EXEC) && (!defin
5aa0: 65 64 28 4f 5f 43 4c 4f 45 58 45 43 29 20 7c 7c  ed(O_CLOEXEC) ||
5ab0: 20 4f 5f 43 4c 4f 45 58 45 43 3d 3d 30 29 0a 20   O_CLOEXEC==0). 
5ac0: 20 20 20 6f 73 46 63 6e 74 6c 28 66 64 2c 20 46     osFcntl(fd, F
5ad0: 5f 53 45 54 46 44 2c 20 6f 73 46 63 6e 74 6c 28  _SETFD, osFcntl(
5ae0: 66 64 2c 20 46 5f 47 45 54 46 44 2c 20 30 29 20  fd, F_GETFD, 0) 
5af0: 7c 20 46 44 5f 43 4c 4f 45 58 45 43 29 3b 0a 23  | FD_CLOEXEC);.#
5b00: 65 6e 64 69 66 0a 20 20 7d 0a 20 20 72 65 74 75  endif.  }.  retu
5b10: 72 6e 20 66 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn fd;.}../*.** 
5b20: 48 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 73  Helper functions
5b30: 20 74 6f 20 6f 62 74 61 69 6e 20 61 6e 64 20 72   to obtain and r
5b40: 65 6c 69 6e 71 75 69 73 68 20 74 68 65 20 67 6c  elinquish the gl
5b50: 6f 62 61 6c 20 6d 75 74 65 78 2e 20 54 68 65 0a  obal mutex. The.
5b60: 2a 2a 20 67 6c 6f 62 61 6c 20 6d 75 74 65 78 20  ** global mutex 
5b70: 69 73 20 75 73 65 64 20 74 6f 20 70 72 6f 74 65  is used to prote
5b80: 63 74 20 74 68 65 20 75 6e 69 78 49 6e 6f 64 65  ct the unixInode
5b90: 49 6e 66 6f 20 61 6e 64 0a 2a 2a 20 76 78 77 6f  Info and.** vxwo
5ba0: 72 6b 73 46 69 6c 65 49 64 20 6f 62 6a 65 63 74  rksFileId object
5bb0: 73 20 75 73 65 64 20 62 79 20 74 68 69 73 20 66  s used by this f
5bc0: 69 6c 65 2c 20 61 6c 6c 20 6f 66 20 77 68 69 63  ile, all of whic
5bd0: 68 20 6d 61 79 20 62 65 20 0a 2a 2a 20 73 68 61  h may be .** sha
5be0: 72 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20  red by multiple 
5bf0: 74 68 72 65 61 64 73 2e 0a 2a 2a 0a 2a 2a 20 46  threads..**.** F
5c00: 75 6e 63 74 69 6f 6e 20 75 6e 69 78 4d 75 74 65  unction unixMute
5c10: 78 48 65 6c 64 28 29 20 69 73 20 75 73 65 64 20  xHeld() is used 
5c20: 74 6f 20 61 73 73 65 72 74 28 29 20 74 68 61 74  to assert() that
5c30: 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75 74 65   the global mute
5c40: 78 20 0a 2a 2a 20 69 73 20 68 65 6c 64 20 77 68  x .** is held wh
5c50: 65 6e 20 72 65 71 75 69 72 65 64 2e 20 54 68 69  en required. Thi
5c60: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e  s function is on
5c70: 6c 79 20 75 73 65 64 20 61 73 20 70 61 72 74 20  ly used as part 
5c80: 6f 66 20 61 73 73 65 72 74 28 29 20 0a 2a 2a 20  of assert() .** 
5c90: 73 74 61 74 65 6d 65 6e 74 73 2e 20 65 2e 67 2e  statements. e.g.
5ca0: 0a 2a 2a 0a 2a 2a 20 20 20 75 6e 69 78 45 6e 74  .**.**   unixEnt
5cb0: 65 72 4d 75 74 65 78 28 29 0a 2a 2a 20 20 20 20  erMutex().**    
5cc0: 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d 75 74   assert( unixMut
5cd0: 65 78 48 65 6c 64 28 29 20 29 3b 0a 2a 2a 20 20  exHeld() );.**  
5ce0: 20 75 6e 69 78 45 6e 74 65 72 4c 65 61 76 65 28   unixEnterLeave(
5cf0: 29 0a 2a 2a 0a 2a 2a 20 54 6f 20 70 72 65 76 65  ).**.** To preve
5d00: 6e 74 20 64 65 61 64 6c 6f 63 6b 2c 20 74 68 65  nt deadlock, the
5d10: 20 67 6c 6f 62 61 6c 20 75 6e 69 78 42 69 67 4c   global unixBigL
5d20: 6f 63 6b 20 6d 75 73 74 20 6d 75 73 74 20 62 65  ock must must be
5d30: 20 61 63 71 75 69 72 65 64 0a 2a 2a 20 62 65 66   acquired.** bef
5d40: 6f 72 65 20 74 68 65 20 75 6e 69 78 49 6e 6f 64  ore the unixInod
5d50: 65 49 6e 66 6f 2e 70 4c 6f 63 6b 4d 75 74 65 78  eInfo.pLockMutex
5d60: 20 6d 75 74 65 78 2c 20 69 66 20 62 6f 74 68 20   mutex, if both 
5d70: 61 72 65 20 68 65 6c 64 2e 20 20 49 74 20 69 73  are held.  It is
5d80: 0a 2a 2a 20 4f 4b 20 74 6f 20 67 65 74 20 74 68  .** OK to get th
5d90: 65 20 70 4c 6f 63 6b 4d 75 74 65 78 20 77 69 74  e pLockMutex wit
5da0: 68 6f 75 74 20 68 6f 6c 64 69 6e 67 20 75 6e 69  hout holding uni
5db0: 78 42 69 67 4c 6f 63 6b 20 66 69 72 73 74 2c 20  xBigLock first, 
5dc0: 62 75 74 20 69 66 0a 2a 2a 20 74 68 61 74 20 68  but if.** that h
5dd0: 61 70 70 65 6e 73 2c 20 74 68 65 20 75 6e 69 78  appens, the unix
5de0: 42 69 67 4c 6f 63 6b 20 6d 75 74 65 78 20 6d 75  BigLock mutex mu
5df0: 73 74 20 6e 6f 74 20 62 65 20 61 63 71 75 69 72  st not be acquir
5e00: 65 64 20 75 6e 74 69 6c 20 61 66 74 65 72 0a 2a  ed until after.*
5e10: 2a 20 70 4c 6f 63 6b 4d 75 74 65 78 20 69 73 20  * pLockMutex is 
5e20: 72 65 6c 65 61 73 65 64 2e 0a 2a 2a 0a 2a 2a 20  released..**.** 
5e30: 20 20 20 20 20 4f 4b 3a 20 20 20 20 20 65 6e 74       OK:     ent
5e40: 65 72 28 75 6e 69 78 42 69 67 4c 6f 63 6b 29 2c  er(unixBigLock),
5e50: 20 20 65 6e 74 65 72 28 70 4c 6f 63 6b 49 6e 66    enter(pLockInf
5e60: 6f 29 0a 2a 2a 20 20 20 20 20 20 4f 4b 3a 20 20  o).**      OK:  
5e70: 20 20 20 65 6e 74 65 72 28 75 6e 69 78 42 69 67     enter(unixBig
5e80: 4c 6f 63 6b 29 0a 2a 2a 20 20 20 20 20 20 4f 4b  Lock).**      OK
5e90: 3a 20 20 20 20 20 65 6e 74 65 72 28 70 4c 6f 63  :     enter(pLoc
5ea0: 6b 49 6e 66 6f 29 0a 2a 2a 20 20 20 45 52 52 4f  kInfo).**   ERRO
5eb0: 52 3a 20 20 20 20 20 65 6e 74 65 72 28 70 4c 6f  R:     enter(pLo
5ec0: 63 6b 49 6e 66 6f 29 2c 20 65 6e 74 65 72 28 75  ckInfo), enter(u
5ed0: 6e 69 78 42 69 67 4c 6f 63 6b 29 0a 2a 2f 0a 73  nixBigLock).*/.s
5ee0: 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 6d 75  tatic sqlite3_mu
5ef0: 74 65 78 20 2a 75 6e 69 78 42 69 67 4c 6f 63 6b  tex *unixBigLock
5f00: 20 3d 20 30 3b 0a 73 74 61 74 69 63 20 76 6f 69   = 0;.static voi
5f10: 64 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78  d unixEnterMutex
5f20: 28 76 6f 69 64 29 7b 0a 20 20 61 73 73 65 72 74  (void){.  assert
5f30: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
5f40: 6e 6f 74 68 65 6c 64 28 75 6e 69 78 42 69 67 4c  notheld(unixBigL
5f50: 6f 63 6b 29 20 29 3b 20 20 2f 2a 20 4e 6f 74 20  ock) );  /* Not 
5f60: 61 20 72 65 63 75 72 73 69 76 65 20 6d 75 74 65  a recursive mute
5f70: 78 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d  x */.  sqlite3_m
5f80: 75 74 65 78 5f 65 6e 74 65 72 28 75 6e 69 78 42  utex_enter(unixB
5f90: 69 67 4c 6f 63 6b 29 3b 0a 7d 0a 73 74 61 74 69  igLock);.}.stati
5fa0: 63 20 76 6f 69 64 20 75 6e 69 78 4c 65 61 76 65  c void unixLeave
5fb0: 4d 75 74 65 78 28 76 6f 69 64 29 7b 0a 20 20 61  Mutex(void){.  a
5fc0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
5fd0: 75 74 65 78 5f 68 65 6c 64 28 75 6e 69 78 42 69  utex_held(unixBi
5fe0: 67 4c 6f 63 6b 29 20 29 3b 0a 20 20 73 71 6c 69  gLock) );.  sqli
5ff0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
6000: 75 6e 69 78 42 69 67 4c 6f 63 6b 29 3b 0a 7d 0a  unixBigLock);.}.
6010: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
6020: 42 55 47 0a 73 74 61 74 69 63 20 69 6e 74 20 75  BUG.static int u
6030: 6e 69 78 4d 75 74 65 78 48 65 6c 64 28 76 6f 69  nixMutexHeld(voi
6040: 64 29 20 7b 0a 20 20 72 65 74 75 72 6e 20 73 71  d) {.  return sq
6050: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
6060: 28 75 6e 69 78 42 69 67 4c 6f 63 6b 29 3b 0a 7d  (unixBigLock);.}
6070: 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 64 65 66  .#endif...#ifdef
6080: 20 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f   SQLITE_HAVE_OS_
6090: 54 52 41 43 45 0a 2f 2a 0a 2a 2a 20 48 65 6c 70  TRACE./*.** Help
60a0: 65 72 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20  er function for 
60b0: 70 72 69 6e 74 69 6e 67 20 6f 75 74 20 74 72 61  printing out tra
60c0: 63 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  ce information f
60d0: 72 6f 6d 20 64 65 62 75 67 67 69 6e 67 0a 2a 2a  rom debugging.**
60e0: 20 62 69 6e 61 72 69 65 73 2e 20 54 68 69 73 20   binaries. This 
60f0: 72 65 74 75 72 6e 73 20 74 68 65 20 73 74 72 69  returns the stri
6100: 6e 67 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f  ng representatio
6110: 6e 20 6f 66 20 74 68 65 20 73 75 70 70 6c 69 65  n of the supplie
6120: 64 0a 2a 2a 20 69 6e 74 65 67 65 72 20 6c 6f 63  d.** integer loc
6130: 6b 2d 74 79 70 65 2e 0a 2a 2f 0a 73 74 61 74 69  k-type..*/.stati
6140: 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 61 7a  c const char *az
6150: 46 69 6c 65 4c 6f 63 6b 28 69 6e 74 20 65 46 69  FileLock(int eFi
6160: 6c 65 4c 6f 63 6b 29 7b 0a 20 20 73 77 69 74 63  leLock){.  switc
6170: 68 28 20 65 46 69 6c 65 4c 6f 63 6b 20 29 7b 0a  h( eFileLock ){.
6180: 20 20 20 20 63 61 73 65 20 4e 4f 5f 4c 4f 43 4b      case NO_LOCK
6190: 3a 20 72 65 74 75 72 6e 20 22 4e 4f 4e 45 22 3b  : return "NONE";
61a0: 0a 20 20 20 20 63 61 73 65 20 53 48 41 52 45 44  .    case SHARED
61b0: 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 53  _LOCK: return "S
61c0: 48 41 52 45 44 22 3b 0a 20 20 20 20 63 61 73 65  HARED";.    case
61d0: 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 3a 20   RESERVED_LOCK: 
61e0: 72 65 74 75 72 6e 20 22 52 45 53 45 52 56 45 44  return "RESERVED
61f0: 22 3b 0a 20 20 20 20 63 61 73 65 20 50 45 4e 44  ";.    case PEND
6200: 49 4e 47 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e  ING_LOCK: return
6210: 20 22 50 45 4e 44 49 4e 47 22 3b 0a 20 20 20 20   "PENDING";.    
6220: 63 61 73 65 20 45 58 43 4c 55 53 49 56 45 5f 4c  case EXCLUSIVE_L
6230: 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 45 58 43  OCK: return "EXC
6240: 4c 55 53 49 56 45 22 3b 0a 20 20 7d 0a 20 20 72  LUSIVE";.  }.  r
6250: 65 74 75 72 6e 20 22 45 52 52 4f 52 22 3b 0a 7d  eturn "ERROR";.}
6260: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20  .#endif..#ifdef 
6270: 53 51 4c 49 54 45 5f 4c 4f 43 4b 5f 54 52 41 43  SQLITE_LOCK_TRAC
6280: 45 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 6f 75  E./*.** Print ou
6290: 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62  t information ab
62a0: 6f 75 74 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20  out all locking 
62b0: 6f 70 65 72 61 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a  operations..**.*
62c0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
62d0: 73 20 75 73 65 64 20 66 6f 72 20 74 72 6f 75 62  s used for troub
62e0: 6c 65 73 68 6f 6f 74 69 6e 67 20 6c 6f 63 6b 73  leshooting locks
62f0: 20 6f 6e 20 6d 75 6c 74 69 74 68 72 65 61 64 65   on multithreade
6300: 64 0a 2a 2a 20 70 6c 61 74 66 6f 72 6d 73 2e 20  d.** platforms. 
6310: 20 45 6e 61 62 6c 65 20 62 79 20 63 6f 6d 70 69   Enable by compi
6320: 6c 69 6e 67 20 77 69 74 68 20 74 68 65 20 2d 44  ling with the -D
6330: 53 51 4c 49 54 45 5f 4c 4f 43 4b 5f 54 52 41 43  SQLITE_LOCK_TRAC
6340: 45 0a 2a 2a 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e  E.** command-lin
6350: 65 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 20  e option on the 
6360: 63 6f 6d 70 69 6c 65 72 2e 20 20 54 68 69 73 20  compiler.  This 
6370: 63 6f 64 65 20 69 73 20 6e 6f 72 6d 61 6c 6c 79  code is normally
6380: 0a 2a 2a 20 74 75 72 6e 65 64 20 6f 66 66 2e 0a  .** turned off..
6390: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 6f  */.static int lo
63a0: 63 6b 54 72 61 63 65 28 69 6e 74 20 66 64 2c 20  ckTrace(int fd, 
63b0: 69 6e 74 20 6f 70 2c 20 73 74 72 75 63 74 20 66  int op, struct f
63c0: 6c 6f 63 6b 20 2a 70 29 7b 0a 20 20 63 68 61 72  lock *p){.  char
63d0: 20 2a 7a 4f 70 4e 61 6d 65 2c 20 2a 7a 54 79 70   *zOpName, *zTyp
63e0: 65 3b 0a 20 20 69 6e 74 20 73 3b 0a 20 20 69 6e  e;.  int s;.  in
63f0: 74 20 73 61 76 65 64 45 72 72 6e 6f 3b 0a 20 20  t savedErrno;.  
6400: 69 66 28 20 6f 70 3d 3d 46 5f 47 45 54 4c 4b 20  if( op==F_GETLK 
6410: 29 7b 0a 20 20 20 20 7a 4f 70 4e 61 6d 65 20 3d  ){.    zOpName =
6420: 20 22 47 45 54 4c 4b 22 3b 0a 20 20 7d 65 6c 73   "GETLK";.  }els
6430: 65 20 69 66 28 20 6f 70 3d 3d 46 5f 53 45 54 4c  e if( op==F_SETL
6440: 4b 20 29 7b 0a 20 20 20 20 7a 4f 70 4e 61 6d 65  K ){.    zOpName
6450: 20 3d 20 22 53 45 54 4c 4b 22 3b 0a 20 20 7d 65   = "SETLK";.  }e
6460: 6c 73 65 7b 0a 20 20 20 20 73 20 3d 20 6f 73 46  lse{.    s = osF
6470: 63 6e 74 6c 28 66 64 2c 20 6f 70 2c 20 70 29 3b  cntl(fd, op, p);
6480: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75  .    sqlite3Debu
6490: 67 50 72 69 6e 74 66 28 22 66 63 6e 74 6c 20 75  gPrintf("fcntl u
64a0: 6e 6b 6e 6f 77 6e 20 25 64 20 25 64 20 25 64 5c  nknown %d %d %d\
64b0: 6e 22 2c 20 66 64 2c 20 6f 70 2c 20 73 29 3b 0a  n", fd, op, s);.
64c0: 20 20 20 20 72 65 74 75 72 6e 20 73 3b 0a 20 20      return s;.  
64d0: 7d 0a 20 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70  }.  if( p->l_typ
64e0: 65 3d 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a 20 20  e==F_RDLCK ){.  
64f0: 20 20 7a 54 79 70 65 20 3d 20 22 52 44 4c 43 4b    zType = "RDLCK
6500: 22 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70  ";.  }else if( p
6510: 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 57 52 4c 43  ->l_type==F_WRLC
6520: 4b 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d  K ){.    zType =
6530: 20 22 57 52 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73   "WRLCK";.  }els
6540: 65 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70 65 3d  e if( p->l_type=
6550: 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20  =F_UNLCK ){.    
6560: 7a 54 79 70 65 20 3d 20 22 55 4e 4c 43 4b 22 3b  zType = "UNLCK";
6570: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
6580: 73 65 72 74 28 20 30 20 29 3b 0a 20 20 7d 0a 20  sert( 0 );.  }. 
6590: 20 61 73 73 65 72 74 28 20 70 2d 3e 6c 5f 77 68   assert( p->l_wh
65a0: 65 6e 63 65 3d 3d 53 45 45 4b 5f 53 45 54 20 29  ence==SEEK_SET )
65b0: 3b 0a 20 20 73 20 3d 20 6f 73 46 63 6e 74 6c 28  ;.  s = osFcntl(
65c0: 66 64 2c 20 6f 70 2c 20 70 29 3b 0a 20 20 73 61  fd, op, p);.  sa
65d0: 76 65 64 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f  vedErrno = errno
65e0: 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 62 75 67  ;.  sqlite3Debug
65f0: 50 72 69 6e 74 66 28 22 66 63 6e 74 6c 20 25 64  Printf("fcntl %d
6600: 20 25 64 20 25 73 20 25 73 20 25 64 20 25 64 20   %d %s %s %d %d 
6610: 25 64 20 25 64 5c 6e 22 2c 0a 20 20 20 20 20 74  %d %d\n",.     t
6620: 68 72 65 61 64 69 64 2c 20 66 64 2c 20 7a 4f 70  hreadid, fd, zOp
6630: 4e 61 6d 65 2c 20 7a 54 79 70 65 2c 20 28 69 6e  Name, zType, (in
6640: 74 29 70 2d 3e 6c 5f 73 74 61 72 74 2c 20 28 69  t)p->l_start, (i
6650: 6e 74 29 70 2d 3e 6c 5f 6c 65 6e 2c 0a 20 20 20  nt)p->l_len,.   
6660: 20 20 28 69 6e 74 29 70 2d 3e 6c 5f 70 69 64 2c    (int)p->l_pid,
6670: 20 73 29 3b 0a 20 20 69 66 28 20 73 3d 3d 28 2d   s);.  if( s==(-
6680: 31 29 20 26 26 20 6f 70 3d 3d 46 5f 53 45 54 4c  1) && op==F_SETL
6690: 4b 20 26 26 20 28 70 2d 3e 6c 5f 74 79 70 65 3d  K && (p->l_type=
66a0: 3d 46 5f 52 44 4c 43 4b 20 7c 7c 20 70 2d 3e 6c  =F_RDLCK || p->l
66b0: 5f 74 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 29 20  _type==F_WRLCK) 
66c0: 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 66 6c  ){.    struct fl
66d0: 6f 63 6b 20 6c 32 3b 0a 20 20 20 20 6c 32 20 3d  ock l2;.    l2 =
66e0: 20 2a 70 3b 0a 20 20 20 20 6f 73 46 63 6e 74 6c   *p;.    osFcntl
66f0: 28 66 64 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c  (fd, F_GETLK, &l
6700: 32 29 3b 0a 20 20 20 20 69 66 28 20 6c 32 2e 6c  2);.    if( l2.l
6710: 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 29  _type==F_RDLCK )
6720: 7b 0a 20 20 20 20 20 20 7a 54 79 70 65 20 3d 20  {.      zType = 
6730: 22 52 44 4c 43 4b 22 3b 0a 20 20 20 20 7d 65 6c  "RDLCK";.    }el
6740: 73 65 20 69 66 28 20 6c 32 2e 6c 5f 74 79 70 65  se if( l2.l_type
6750: 3d 3d 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 20 20  ==F_WRLCK ){.   
6760: 20 20 20 7a 54 79 70 65 20 3d 20 22 57 52 4c 43     zType = "WRLC
6770: 4b 22 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66  K";.    }else if
6780: 28 20 6c 32 2e 6c 5f 74 79 70 65 3d 3d 46 5f 55  ( l2.l_type==F_U
6790: 4e 4c 43 4b 20 29 7b 0a 20 20 20 20 20 20 7a 54  NLCK ){.      zT
67a0: 79 70 65 20 3d 20 22 55 4e 4c 43 4b 22 3b 0a 20  ype = "UNLCK";. 
67b0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
67c0: 61 73 73 65 72 74 28 20 30 20 29 3b 0a 20 20 20  assert( 0 );.   
67d0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65   }.    sqlite3De
67e0: 62 75 67 50 72 69 6e 74 66 28 22 66 63 6e 74 6c  bugPrintf("fcntl
67f0: 2d 66 61 69 6c 75 72 65 2d 72 65 61 73 6f 6e 3a  -failure-reason:
6800: 20 25 73 20 25 64 20 25 64 20 25 64 5c 6e 22 2c   %s %d %d %d\n",
6810: 0a 20 20 20 20 20 20 20 7a 54 79 70 65 2c 20 28  .       zType, (
6820: 69 6e 74 29 6c 32 2e 6c 5f 73 74 61 72 74 2c 20  int)l2.l_start, 
6830: 28 69 6e 74 29 6c 32 2e 6c 5f 6c 65 6e 2c 20 28  (int)l2.l_len, (
6840: 69 6e 74 29 6c 32 2e 6c 5f 70 69 64 29 3b 0a 20  int)l2.l_pid);. 
6850: 20 7d 0a 20 20 65 72 72 6e 6f 20 3d 20 73 61 76   }.  errno = sav
6860: 65 64 45 72 72 6e 6f 3b 0a 20 20 72 65 74 75 72  edErrno;.  retur
6870: 6e 20 73 3b 0a 7d 0a 23 75 6e 64 65 66 20 6f 73  n s;.}.#undef os
6880: 46 63 6e 74 6c 0a 23 64 65 66 69 6e 65 20 6f 73  Fcntl.#define os
6890: 46 63 6e 74 6c 20 6c 6f 63 6b 54 72 61 63 65 0a  Fcntl lockTrace.
68a0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
68b0: 5f 4c 4f 43 4b 5f 54 52 41 43 45 20 2a 2f 0a 0a  _LOCK_TRACE */..
68c0: 2f 2a 0a 2a 2a 20 52 65 74 72 79 20 66 74 72 75  /*.** Retry ftru
68d0: 6e 63 61 74 65 28 29 20 63 61 6c 6c 73 20 74 68  ncate() calls th
68e0: 61 74 20 66 61 69 6c 20 64 75 65 20 74 6f 20 45  at fail due to E
68f0: 49 4e 54 52 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 63  INTR.**.** All c
6900: 61 6c 6c 73 20 74 6f 20 66 74 72 75 6e 63 61 74  alls to ftruncat
6910: 65 28 29 20 77 69 74 68 69 6e 20 74 68 69 73 20  e() within this 
6920: 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 6d  file should be m
6930: 61 64 65 20 74 68 72 6f 75 67 68 0a 2a 2a 20 74  ade through.** t
6940: 68 69 73 20 77 72 61 70 70 65 72 2e 20 20 4f 6e  his wrapper.  On
6950: 20 74 68 65 20 41 6e 64 72 6f 69 64 20 70 6c 61   the Android pla
6960: 74 66 6f 72 6d 2c 20 62 79 70 61 73 73 69 6e 67  tform, bypassing
6970: 20 74 68 65 20 6c 6f 67 69 63 20 62 65 6c 6f 77   the logic below
6980: 0a 2a 2a 20 63 6f 75 6c 64 20 6c 65 61 64 20 74  .** could lead t
6990: 6f 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61  o a corrupt data
69a0: 62 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  base..*/.static 
69b0: 69 6e 74 20 72 6f 62 75 73 74 5f 66 74 72 75 6e  int robust_ftrun
69c0: 63 61 74 65 28 69 6e 74 20 68 2c 20 73 71 6c 69  cate(int h, sqli
69d0: 74 65 33 5f 69 6e 74 36 34 20 73 7a 29 7b 0a 20  te3_int64 sz){. 
69e0: 20 69 6e 74 20 72 63 3b 0a 23 69 66 64 65 66 20   int rc;.#ifdef 
69f0: 5f 5f 41 4e 44 52 4f 49 44 5f 5f 0a 20 20 2f 2a  __ANDROID__.  /*
6a00: 20 4f 6e 20 41 6e 64 72 6f 69 64 2c 20 66 74 72   On Android, ftr
6a10: 75 6e 63 61 74 65 28 29 20 61 6c 77 61 79 73 20  uncate() always 
6a20: 75 73 65 73 20 33 32 2d 62 69 74 20 6f 66 66 73  uses 32-bit offs
6a30: 65 74 73 2c 20 65 76 65 6e 20 69 66 20 0a 20 20  ets, even if .  
6a40: 2a 2a 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54 5f  ** _FILE_OFFSET_
6a50: 42 49 54 53 3d 36 34 20 69 73 20 64 65 66 69 6e  BITS=64 is defin
6a60: 65 64 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 69  ed. This means i
6a70: 74 20 69 73 20 75 6e 73 61 66 65 20 74 6f 20 61  t is unsafe to a
6a80: 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 74  ttempt to.  ** t
6a90: 72 75 6e 63 61 74 65 20 61 20 66 69 6c 65 20 74  runcate a file t
6aa0: 6f 20 61 6e 79 20 73 69 7a 65 20 6c 61 72 67 65  o any size large
6ab0: 72 20 74 68 61 6e 20 32 47 69 42 2e 20 53 69 6c  r than 2GiB. Sil
6ac0: 65 6e 74 6c 79 20 69 67 6e 6f 72 65 20 61 6e 79  ently ignore any
6ad0: 0a 20 20 2a 2a 20 73 75 63 68 20 61 74 74 65 6d  .  ** such attem
6ae0: 70 74 73 2e 20 20 2a 2f 0a 20 20 69 66 28 20 73  pts.  */.  if( s
6af0: 7a 3e 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34  z>(sqlite3_int64
6b00: 29 30 78 37 46 46 46 46 46 46 46 20 29 7b 0a 20  )0x7FFFFFFF ){. 
6b10: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
6b20: 4b 3b 0a 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69  K;.  }else.#endi
6b30: 66 0a 20 20 64 6f 7b 20 72 63 20 3d 20 6f 73 46  f.  do{ rc = osF
6b40: 74 72 75 6e 63 61 74 65 28 68 2c 73 7a 29 3b 20  truncate(h,sz); 
6b50: 7d 77 68 69 6c 65 28 20 72 63 3c 30 20 26 26 20  }while( rc<0 && 
6b60: 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 29 3b 0a  errno==EINTR );.
6b70: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6b80: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
6b90: 6e 65 20 74 72 61 6e 73 6c 61 74 65 73 20 61 20  ne translates a 
6ba0: 73 74 61 6e 64 61 72 64 20 50 4f 53 49 58 20 65  standard POSIX e
6bb0: 72 72 6e 6f 20 63 6f 64 65 20 69 6e 74 6f 20 73  rrno code into s
6bc0: 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 75 73 65 66  omething.** usef
6bd0: 75 6c 20 74 6f 20 74 68 65 20 63 6c 69 65 6e 74  ul to the client
6be0: 73 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33  s of the sqlite3
6bf0: 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 53 70 65   functions.  Spe
6c00: 63 69 66 69 63 61 6c 6c 79 2c 20 69 74 20 69 73  cifically, it is
6c10: 0a 2a 2a 20 69 6e 74 65 6e 64 65 64 20 74 6f 20  .** intended to 
6c20: 74 72 61 6e 73 6c 61 74 65 20 61 20 76 61 72 69  translate a vari
6c30: 65 74 79 20 6f 66 20 22 74 72 79 20 61 67 61 69  ety of "try agai
6c40: 6e 22 20 65 72 72 6f 72 73 20 69 6e 74 6f 20 53  n" errors into S
6c50: 51 4c 49 54 45 5f 42 55 53 59 0a 2a 2a 20 61 6e  QLITE_BUSY.** an
6c60: 64 20 61 20 76 61 72 69 65 74 79 20 6f 66 20 22  d a variety of "
6c70: 70 6c 65 61 73 65 20 63 6c 6f 73 65 20 74 68 65  please close the
6c80: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
6c90: 20 4e 4f 57 22 20 65 72 72 6f 72 73 20 69 6e 74   NOW" errors int
6ca0: 6f 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 4f 45  o .** SQLITE_IOE
6cb0: 52 52 0a 2a 2a 20 0a 2a 2a 20 45 72 72 6f 72 73  RR.** .** Errors
6cc0: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69   during initiali
6cd0: 7a 61 74 69 6f 6e 20 6f 66 20 6c 6f 63 6b 73 2c  zation of locks,
6ce0: 20 6f 72 20 66 69 6c 65 20 73 79 73 74 65 6d 20   or file system 
6cf0: 73 75 70 70 6f 72 74 20 66 6f 72 20 6c 6f 63 6b  support for lock
6d00: 73 2c 0a 2a 2a 20 73 68 6f 75 6c 64 20 68 61 6e  s,.** should han
6d10: 64 6c 65 20 45 4e 4f 4c 43 4b 2c 20 45 4e 4f 54  dle ENOLCK, ENOT
6d20: 53 55 50 2c 20 45 4f 50 4e 4f 54 53 55 50 50 20  SUP, EOPNOTSUPP 
6d30: 73 65 70 61 72 61 74 65 6c 79 2e 0a 2a 2f 0a 73  separately..*/.s
6d40: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65  tatic int sqlite
6d50: 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72  ErrorFromPosixEr
6d60: 72 6f 72 28 69 6e 74 20 70 6f 73 69 78 45 72 72  ror(int posixErr
6d70: 6f 72 2c 20 69 6e 74 20 73 71 6c 69 74 65 49 4f  or, int sqliteIO
6d80: 45 72 72 29 20 7b 0a 20 20 61 73 73 65 72 74 28  Err) {.  assert(
6d90: 20 28 73 71 6c 69 74 65 49 4f 45 72 72 20 3d 3d   (sqliteIOErr ==
6da0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f   SQLITE_IOERR_LO
6db0: 43 4b 29 20 7c 7c 20 0a 20 20 20 20 20 20 20 20  CK) || .        
6dc0: 20 20 28 73 71 6c 69 74 65 49 4f 45 72 72 20 3d    (sqliteIOErr =
6dd0: 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55  = SQLITE_IOERR_U
6de0: 4e 4c 4f 43 4b 29 20 7c 7c 20 0a 20 20 20 20 20  NLOCK) || .     
6df0: 20 20 20 20 20 28 73 71 6c 69 74 65 49 4f 45 72       (sqliteIOEr
6e00: 72 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52  r == SQLITE_IOER
6e10: 52 5f 52 44 4c 4f 43 4b 29 20 7c 7c 0a 20 20 20  R_RDLOCK) ||.   
6e20: 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 49 4f         (sqliteIO
6e30: 45 72 72 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f  Err == SQLITE_IO
6e40: 45 52 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45  ERR_CHECKRESERVE
6e50: 44 4c 4f 43 4b 29 20 29 3b 0a 20 20 73 77 69 74  DLOCK) );.  swit
6e60: 63 68 20 28 70 6f 73 69 78 45 72 72 6f 72 29 20  ch (posixError) 
6e70: 7b 0a 20 20 63 61 73 65 20 45 41 43 43 45 53 3a  {.  case EACCES:
6e80: 20 0a 20 20 63 61 73 65 20 45 41 47 41 49 4e 3a   .  case EAGAIN:
6e90: 0a 20 20 63 61 73 65 20 45 54 49 4d 45 44 4f 55  .  case ETIMEDOU
6ea0: 54 3a 0a 20 20 63 61 73 65 20 45 42 55 53 59 3a  T:.  case EBUSY:
6eb0: 0a 20 20 63 61 73 65 20 45 49 4e 54 52 3a 0a 20  .  case EINTR:. 
6ec0: 20 63 61 73 65 20 45 4e 4f 4c 43 4b 3a 20 20 0a   case ENOLCK:  .
6ed0: 20 20 20 20 2f 2a 20 72 61 6e 64 6f 6d 20 4e 46      /* random NF
6ee0: 53 20 72 65 74 72 79 20 65 72 72 6f 72 2c 20 75  S retry error, u
6ef0: 6e 6c 65 73 73 20 64 75 72 69 6e 67 20 66 69 6c  nless during fil
6f00: 65 20 73 79 73 74 65 6d 20 73 75 70 70 6f 72 74  e system support
6f10: 20 0a 20 20 20 20 20 2a 20 69 6e 74 72 6f 73 70   .     * introsp
6f20: 65 63 74 69 6f 6e 2c 20 69 6e 20 77 68 69 63 68  ection, in which
6f30: 20 69 74 20 61 63 74 75 61 6c 6c 79 20 6d 65 61   it actually mea
6f40: 6e 73 20 77 68 61 74 20 69 74 20 73 61 79 73 20  ns what it says 
6f50: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  */.    return SQ
6f60: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 0a  LITE_BUSY;.    .
6f70: 20 20 63 61 73 65 20 45 50 45 52 4d 3a 20 0a 20    case EPERM: . 
6f80: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
6f90: 5f 50 45 52 4d 3b 0a 20 20 20 20 0a 20 20 64 65  _PERM;.    .  de
6fa0: 66 61 75 6c 74 3a 20 0a 20 20 20 20 72 65 74 75  fault: .    retu
6fb0: 72 6e 20 73 71 6c 69 74 65 49 4f 45 72 72 3b 0a  rn sqliteIOErr;.
6fc0: 20 20 7d 0a 7d 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a    }.}.../*******
6fd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6fe0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
6ff0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
7000: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
7010: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  *******.********
7020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e  ********** Begin
7030: 20 55 6e 69 71 75 65 20 46 69 6c 65 20 49 44 20   Unique File ID 
7040: 55 74 69 6c 69 74 79 20 55 73 65 64 20 42 79 20  Utility Used By 
7050: 56 78 57 6f 72 6b 73 20 2a 2a 2a 2a 2a 2a 2a 2a  VxWorks ********
7060: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 4f 6e  *******.**.** On
7070: 20 6d 6f 73 74 20 76 65 72 73 69 6f 6e 73 20 6f   most versions o
7080: 66 20 75 6e 69 78 2c 20 77 65 20 63 61 6e 20 67  f unix, we can g
7090: 65 74 20 61 20 75 6e 69 71 75 65 20 49 44 20 66  et a unique ID f
70a0: 6f 72 20 61 20 66 69 6c 65 20 62 79 20 63 6f 6e  or a file by con
70b0: 63 61 74 65 6e 61 74 69 6e 67 0a 2a 2a 20 74 68  catenating.** th
70c0: 65 20 64 65 76 69 63 65 20 6e 75 6d 62 65 72 20  e device number 
70d0: 61 6e 64 20 74 68 65 20 69 6e 6f 64 65 20 6e 75  and the inode nu
70e0: 6d 62 65 72 2e 20 20 42 75 74 20 74 68 69 73 20  mber.  But this 
70f0: 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e  does not work on
7100: 20 56 78 57 6f 72 6b 73 2e 0a 2a 2a 20 4f 6e 20   VxWorks..** On 
7110: 56 78 57 6f 72 6b 73 2c 20 61 20 75 6e 69 71 75  VxWorks, a uniqu
7120: 65 20 66 69 6c 65 20 69 64 20 6d 75 73 74 20 62  e file id must b
7130: 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 63  e based on the c
7140: 61 6e 6f 6e 69 63 61 6c 20 66 69 6c 65 6e 61 6d  anonical filenam
7150: 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74  e..**.** A point
7160: 65 72 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63  er to an instanc
7170: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
7180: 6e 67 20 73 74 72 75 63 74 75 72 65 20 63 61 6e  ng structure can
7190: 20 62 65 20 75 73 65 64 20 61 73 20 61 0a 2a 2a   be used as a.**
71a0: 20 75 6e 69 71 75 65 20 66 69 6c 65 20 49 44 20   unique file ID 
71b0: 69 6e 20 56 78 57 6f 72 6b 73 2e 20 20 45 61 63  in VxWorks.  Eac
71c0: 68 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  h instance of th
71d0: 69 73 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e  is structure con
71e0: 74 61 69 6e 73 0a 2a 2a 20 61 20 63 6f 70 79 20  tains.** a copy 
71f0: 6f 66 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c  of the canonical
7200: 20 66 69 6c 65 6e 61 6d 65 2e 20 20 54 68 65 72   filename.  Ther
7210: 65 20 69 73 20 61 6c 73 6f 20 61 20 72 65 66 65  e is also a refe
7220: 72 65 6e 63 65 20 63 6f 75 6e 74 2e 20 20 0a 2a  rence count.  .*
7230: 2a 20 54 68 65 20 73 74 72 75 63 74 75 72 65 20  * The structure 
7240: 69 73 20 72 65 63 6c 61 69 6d 65 64 20 77 68 65  is reclaimed whe
7250: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  n the number of 
7260: 70 6f 69 6e 74 65 72 73 20 74 6f 20 69 74 20 64  pointers to it d
7270: 72 6f 70 73 20 74 6f 0a 2a 2a 20 7a 65 72 6f 2e  rops to.** zero.
7280: 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65  .**.** There are
7290: 20 6e 65 76 65 72 20 76 65 72 79 20 6d 61 6e 79   never very many
72a0: 20 66 69 6c 65 73 20 6f 70 65 6e 20 61 74 20 6f   files open at o
72b0: 6e 65 20 74 69 6d 65 20 61 6e 64 20 6c 6f 6f 6b  ne time and look
72c0: 75 70 73 20 61 72 65 20 6e 6f 74 0a 2a 2a 20 61  ups are not.** a
72d0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 2d 63 72 69   performance-cri
72e0: 74 69 63 61 6c 20 70 61 74 68 2c 20 73 6f 20 69  tical path, so i
72f0: 74 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 20  t is sufficient 
7300: 74 6f 20 70 75 74 20 74 68 65 73 65 0a 2a 2a 20  to put these.** 
7310: 73 74 72 75 63 74 75 72 65 73 20 6f 6e 20 61 20  structures on a 
7320: 6c 69 6e 6b 65 64 20 6c 69 73 74 2e 0a 2a 2f 0a  linked list..*/.
7330: 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73 46 69  struct vxworksFi
7340: 6c 65 49 64 20 7b 0a 20 20 73 74 72 75 63 74 20  leId {.  struct 
7350: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70  vxworksFileId *p
7360: 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 69  Next;  /* Next i
7370: 6e 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 6d  n a list of them
7380: 20 61 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e 52   all */.  int nR
7390: 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ef;             
73a0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
73b0: 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65 73 20  r of references 
73c0: 74 6f 20 74 68 69 73 20 6f 6e 65 20 2a 2f 0a 20  to this one */. 
73d0: 20 69 6e 74 20 6e 4e 61 6d 65 3b 20 20 20 20 20   int nName;     
73e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
73f0: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 74 68 65 20  * Length of the 
7400: 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 5b 5d  zCanonicalName[]
7410: 20 73 74 72 69 6e 67 20 2a 2f 0a 20 20 63 68 61   string */.  cha
7420: 72 20 2a 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d  r *zCanonicalNam
7430: 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 61  e;         /* Ca
7440: 6e 6f 6e 69 63 61 6c 20 66 69 6c 65 6e 61 6d 65  nonical filename
7450: 20 2a 2f 0a 7d 3b 0a 0a 23 69 66 20 4f 53 5f 56   */.};..#if OS_V
7460: 58 57 4f 52 4b 53 0a 2f 2a 20 0a 2a 2a 20 41 6c  XWORKS./* .** Al
7470: 6c 20 75 6e 69 71 75 65 20 66 69 6c 65 6e 61 6d  l unique filenam
7480: 65 73 20 61 72 65 20 68 65 6c 64 20 6f 6e 20 61  es are held on a
7490: 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 61   linked list hea
74a0: 64 65 64 20 62 79 20 74 68 69 73 0a 2a 2a 20 76  ded by this.** v
74b0: 61 72 69 61 62 6c 65 3a 0a 2a 2f 0a 73 74 61 74  ariable:.*/.stat
74c0: 69 63 20 73 74 72 75 63 74 20 76 78 77 6f 72 6b  ic struct vxwork
74d0: 73 46 69 6c 65 49 64 20 2a 76 78 77 6f 72 6b 73  sFileId *vxworks
74e0: 46 69 6c 65 4c 69 73 74 20 3d 20 30 3b 0a 0a 2f  FileList = 0;../
74f0: 2a 0a 2a 2a 20 53 69 6d 70 6c 69 66 79 20 61 20  *.** Simplify a 
7500: 66 69 6c 65 6e 61 6d 65 20 69 6e 74 6f 20 69 74  filename into it
7510: 73 20 63 61 6e 6f 6e 69 63 61 6c 20 66 6f 72 6d  s canonical form
7520: 0a 2a 2a 20 62 79 20 6d 61 6b 69 6e 67 20 74 68  .** by making th
7530: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 6e  e following chan
7540: 67 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 2a 20 72 65  ges:.**.**  * re
7550: 6d 6f 76 69 6e 67 20 61 6e 79 20 74 72 61 69 6c  moving any trail
7560: 69 6e 67 20 61 6e 64 20 64 75 70 6c 69 63 61 74  ing and duplicat
7570: 65 20 2f 0a 2a 2a 20 20 2a 20 63 6f 6e 76 65 72  e /.**  * conver
7580: 74 20 2f 2e 2f 20 69 6e 74 6f 20 6a 75 73 74 20  t /./ into just 
7590: 2f 0a 2a 2a 20 20 2a 20 63 6f 6e 76 65 72 74 20  /.**  * convert 
75a0: 2f 41 2f 2e 2e 2f 20 77 68 65 72 65 20 41 20 69  /A/../ where A i
75b0: 73 20 61 6e 79 20 73 69 6d 70 6c 65 20 6e 61 6d  s any simple nam
75c0: 65 20 69 6e 74 6f 20 6a 75 73 74 20 2f 0a 2a 2a  e into just /.**
75d0: 0a 2a 2a 20 43 68 61 6e 67 65 73 20 61 72 65 20  .** Changes are 
75e0: 6d 61 64 65 20 69 6e 2d 70 6c 61 63 65 2e 20 20  made in-place.  
75f0: 52 65 74 75 72 6e 20 74 68 65 20 6e 65 77 20 6e  Return the new n
7600: 61 6d 65 20 6c 65 6e 67 74 68 2e 0a 2a 2a 0a 2a  ame length..**.*
7610: 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 66  * The original f
7620: 69 6c 65 6e 61 6d 65 20 69 73 20 69 6e 20 7a 5b  ilename is in z[
7630: 30 2e 2e 6e 2d 31 5d 2e 20 20 52 65 74 75 72 6e  0..n-1].  Return
7640: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a   the number of.*
7650: 2a 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20  * characters in 
7660: 74 68 65 20 73 69 6d 70 6c 69 66 69 65 64 20 6e  the simplified n
7670: 61 6d 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ame..*/.static i
7680: 6e 74 20 76 78 77 6f 72 6b 73 53 69 6d 70 6c 69  nt vxworksSimpli
7690: 66 79 4e 61 6d 65 28 63 68 61 72 20 2a 7a 2c 20  fyName(char *z, 
76a0: 69 6e 74 20 6e 29 7b 0a 20 20 69 6e 74 20 69 2c  int n){.  int i,
76b0: 20 6a 3b 0a 20 20 77 68 69 6c 65 28 20 6e 3e 31   j;.  while( n>1
76c0: 20 26 26 20 7a 5b 6e 2d 31 5d 3d 3d 27 2f 27 20   && z[n-1]=='/' 
76d0: 29 7b 20 6e 2d 2d 3b 20 7d 0a 20 20 66 6f 72 28  ){ n--; }.  for(
76e0: 69 3d 6a 3d 30 3b 20 69 3c 6e 3b 20 69 2b 2b 29  i=j=0; i<n; i++)
76f0: 7b 0a 20 20 20 20 69 66 28 20 7a 5b 69 5d 3d 3d  {.    if( z[i]==
7700: 27 2f 27 20 29 7b 0a 20 20 20 20 20 20 69 66 28  '/' ){.      if(
7710: 20 7a 5b 69 2b 31 5d 3d 3d 27 2f 27 20 29 20 63   z[i+1]=='/' ) c
7720: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 69  ontinue;.      i
7730: 66 28 20 7a 5b 69 2b 31 5d 3d 3d 27 2e 27 20 26  f( z[i+1]=='.' &
7740: 26 20 69 2b 32 3c 6e 20 26 26 20 7a 5b 69 2b 32  & i+2<n && z[i+2
7750: 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 20 20  ]=='/' ){.      
7760: 20 20 69 20 2b 3d 20 31 3b 0a 20 20 20 20 20 20    i += 1;.      
7770: 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20    continue;.    
7780: 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 7a 5b    }.      if( z[
7790: 69 2b 31 5d 3d 3d 27 2e 27 20 26 26 20 69 2b 33  i+1]=='.' && i+3
77a0: 3c 6e 20 26 26 20 7a 5b 69 2b 32 5d 3d 3d 27 2e  <n && z[i+2]=='.
77b0: 27 20 26 26 20 7a 5b 69 2b 33 5d 3d 3d 27 2f 27  ' && z[i+3]=='/'
77c0: 20 29 7b 0a 20 20 20 20 20 20 20 20 77 68 69 6c   ){.        whil
77d0: 65 28 20 6a 3e 30 20 26 26 20 7a 5b 6a 2d 31 5d  e( j>0 && z[j-1]
77e0: 21 3d 27 2f 27 20 29 7b 20 6a 2d 2d 3b 20 7d 0a  !='/' ){ j--; }.
77f0: 20 20 20 20 20 20 20 20 69 66 28 20 6a 3e 30 20          if( j>0 
7800: 29 7b 20 6a 2d 2d 3b 20 7d 0a 20 20 20 20 20 20  ){ j--; }.      
7810: 20 20 69 20 2b 3d 20 32 3b 0a 20 20 20 20 20 20    i += 2;.      
7820: 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20    continue;.    
7830: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 7a 5b    }.    }.    z[
7840: 6a 2b 2b 5d 20 3d 20 7a 5b 69 5d 3b 0a 20 20 7d  j++] = z[i];.  }
7850: 0a 20 20 7a 5b 6a 5d 20 3d 20 30 3b 0a 20 20 72  .  z[j] = 0;.  r
7860: 65 74 75 72 6e 20 6a 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn j;.}../*.*
7870: 2a 20 46 69 6e 64 20 61 20 75 6e 69 71 75 65 20  * Find a unique 
7880: 66 69 6c 65 20 49 44 20 66 6f 72 20 74 68 65 20  file ID for the 
7890: 67 69 76 65 6e 20 61 62 73 6f 6c 75 74 65 20 70  given absolute p
78a0: 61 74 68 6e 61 6d 65 2e 20 20 52 65 74 75 72 6e  athname.  Return
78b0: 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  .** a pointer to
78c0: 20 74 68 65 20 76 78 77 6f 72 6b 73 46 69 6c 65   the vxworksFile
78d0: 49 64 20 6f 62 6a 65 63 74 2e 20 20 54 68 69 73  Id object.  This
78e0: 20 70 6f 69 6e 74 65 72 20 69 73 20 74 68 65 20   pointer is the 
78f0: 75 6e 69 71 75 65 0a 2a 2a 20 66 69 6c 65 20 49  unique.** file I
7900: 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 52 65  D..**.** The nRe
7910: 66 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 76  f field of the v
7920: 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 6f 62 6a  xworksFileId obj
7930: 65 63 74 20 69 73 20 69 6e 63 72 65 6d 65 6e 74  ect is increment
7940: 65 64 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 65  ed before.** the
7950: 20 6f 62 6a 65 63 74 20 69 73 20 72 65 74 75 72   object is retur
7960: 6e 65 64 2e 20 20 41 20 6e 65 77 20 76 78 77 6f  ned.  A new vxwo
7970: 72 6b 73 46 69 6c 65 49 64 20 6f 62 6a 65 63 74  rksFileId object
7980: 20 69 73 20 63 72 65 61 74 65 64 0a 2a 2a 20 61   is created.** a
7990: 6e 64 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  nd added to the 
79a0: 67 6c 6f 62 61 6c 20 6c 69 73 74 20 69 66 20 6e  global list if n
79b0: 65 63 65 73 73 61 72 79 2e 0a 2a 2a 0a 2a 2a 20  ecessary..**.** 
79c0: 49 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  If a memory allo
79d0: 63 61 74 69 6f 6e 20 65 72 72 6f 72 20 6f 63 63  cation error occ
79e0: 75 72 73 2c 20 72 65 74 75 72 6e 20 4e 55 4c 4c  urs, return NULL
79f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74 72 75  ..*/.static stru
7a00: 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65 49 64  ct vxworksFileId
7a10: 20 2a 76 78 77 6f 72 6b 73 46 69 6e 64 46 69 6c   *vxworksFindFil
7a20: 65 49 64 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  eId(const char *
7a30: 7a 41 62 73 6f 6c 75 74 65 4e 61 6d 65 29 7b 0a  zAbsoluteName){.
7a40: 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73    struct vxworks
7a50: 46 69 6c 65 49 64 20 2a 70 4e 65 77 3b 20 20 20  FileId *pNew;   
7a60: 20 20 20 20 20 20 2f 2a 20 73 65 61 72 63 68 20        /* search 
7a70: 6b 65 79 20 61 6e 64 20 6e 65 77 20 66 69 6c 65  key and new file
7a80: 20 49 44 20 2a 2f 0a 20 20 73 74 72 75 63 74 20   ID */.  struct 
7a90: 76 78 77 6f 72 6b 73 46 69 6c 65 49 64 20 2a 70  vxworksFileId *p
7aa0: 43 61 6e 64 69 64 61 74 65 3b 20 20 20 2f 2a 20  Candidate;   /* 
7ab0: 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72  For looping over
7ac0: 20 65 78 69 73 74 69 6e 67 20 66 69 6c 65 20 49   existing file I
7ad0: 44 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 3b 20 20  Ds */.  int n;  
7ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7af0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c              /* L
7b00: 65 6e 67 74 68 20 6f 66 20 7a 41 62 73 6f 6c 75  ength of zAbsolu
7b10: 74 65 4e 61 6d 65 20 73 74 72 69 6e 67 20 2a 2f  teName string */
7b20: 0a 0a 20 20 61 73 73 65 72 74 28 20 7a 41 62 73  ..  assert( zAbs
7b30: 6f 6c 75 74 65 4e 61 6d 65 5b 30 5d 3d 3d 27 2f  oluteName[0]=='/
7b40: 27 20 29 3b 0a 20 20 6e 20 3d 20 28 69 6e 74 29  ' );.  n = (int)
7b50: 73 74 72 6c 65 6e 28 7a 41 62 73 6f 6c 75 74 65  strlen(zAbsolute
7b60: 4e 61 6d 65 29 3b 0a 20 20 70 4e 65 77 20 3d 20  Name);.  pNew = 
7b70: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 36 34  sqlite3_malloc64
7b80: 28 20 73 69 7a 65 6f 66 28 2a 70 4e 65 77 29 20  ( sizeof(*pNew) 
7b90: 2b 20 28 6e 2b 31 29 20 29 3b 0a 20 20 69 66 28  + (n+1) );.  if(
7ba0: 20 70 4e 65 77 3d 3d 30 20 29 20 72 65 74 75 72   pNew==0 ) retur
7bb0: 6e 20 30 3b 0a 20 20 70 4e 65 77 2d 3e 7a 43 61  n 0;.  pNew->zCa
7bc0: 6e 6f 6e 69 63 61 6c 4e 61 6d 65 20 3d 20 28 63  nonicalName = (c
7bd0: 68 61 72 2a 29 26 70 4e 65 77 5b 31 5d 3b 0a 20  har*)&pNew[1];. 
7be0: 20 6d 65 6d 63 70 79 28 70 4e 65 77 2d 3e 7a 43   memcpy(pNew->zC
7bf0: 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 2c 20 7a 41  anonicalName, zA
7c00: 62 73 6f 6c 75 74 65 4e 61 6d 65 2c 20 6e 2b 31  bsoluteName, n+1
7c10: 29 3b 0a 20 20 6e 20 3d 20 76 78 77 6f 72 6b 73  );.  n = vxworks
7c20: 53 69 6d 70 6c 69 66 79 4e 61 6d 65 28 70 4e 65  SimplifyName(pNe
7c30: 77 2d 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d  w->zCanonicalNam
7c40: 65 2c 20 6e 29 3b 0a 0a 20 20 2f 2a 20 53 65 61  e, n);..  /* Sea
7c50: 72 63 68 20 66 6f 72 20 61 6e 20 65 78 69 73 74  rch for an exist
7c60: 69 6e 67 20 65 6e 74 72 79 20 74 68 61 74 20 6d  ing entry that m
7c70: 61 74 63 68 69 6e 67 20 74 68 65 20 63 61 6e 6f  atching the cano
7c80: 6e 69 63 61 6c 20 6e 61 6d 65 2e 0a 20 20 2a 2a  nical name..  **
7c90: 20 49 66 20 66 6f 75 6e 64 2c 20 69 6e 63 72 65   If found, incre
7ca0: 6d 65 6e 74 20 74 68 65 20 72 65 66 65 72 65 6e  ment the referen
7cb0: 63 65 20 63 6f 75 6e 74 20 61 6e 64 20 72 65 74  ce count and ret
7cc0: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  urn a pointer to
7cd0: 0a 20 20 2a 2a 20 74 68 65 20 65 78 69 73 74 69  .  ** the existi
7ce0: 6e 67 20 66 69 6c 65 20 49 44 2e 0a 20 20 2a 2f  ng file ID..  */
7cf0: 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65  .  unixEnterMute
7d00: 78 28 29 3b 0a 20 20 66 6f 72 28 70 43 61 6e 64  x();.  for(pCand
7d10: 69 64 61 74 65 3d 76 78 77 6f 72 6b 73 46 69 6c  idate=vxworksFil
7d20: 65 4c 69 73 74 3b 20 70 43 61 6e 64 69 64 61 74  eList; pCandidat
7d30: 65 3b 20 70 43 61 6e 64 69 64 61 74 65 3d 70 43  e; pCandidate=pC
7d40: 61 6e 64 69 64 61 74 65 2d 3e 70 4e 65 78 74 29  andidate->pNext)
7d50: 7b 0a 20 20 20 20 69 66 28 20 70 43 61 6e 64 69  {.    if( pCandi
7d60: 64 61 74 65 2d 3e 6e 4e 61 6d 65 3d 3d 6e 20 0a  date->nName==n .
7d70: 20 20 20 20 20 26 26 20 6d 65 6d 63 6d 70 28 70       && memcmp(p
7d80: 43 61 6e 64 69 64 61 74 65 2d 3e 7a 43 61 6e 6f  Candidate->zCano
7d90: 6e 69 63 61 6c 4e 61 6d 65 2c 20 70 4e 65 77 2d  nicalName, pNew-
7da0: 3e 7a 43 61 6e 6f 6e 69 63 61 6c 4e 61 6d 65 2c  >zCanonicalName,
7db0: 20 6e 29 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20   n)==0.    ){.  
7dc0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65       sqlite3_fre
7dd0: 65 28 70 4e 65 77 29 3b 0a 20 20 20 20 20 20 20  e(pNew);.       
7de0: 70 43 61 6e 64 69 64 61 74 65 2d 3e 6e 52 65 66  pCandidate->nRef
7df0: 2b 2b 3b 0a 20 20 20 20 20 20 20 75 6e 69 78 4c  ++;.       unixL
7e00: 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 20  eaveMutex();.   
7e10: 20 20 20 20 72 65 74 75 72 6e 20 70 43 61 6e 64      return pCand
7e20: 69 64 61 74 65 3b 0a 20 20 20 20 7d 0a 20 20 7d  idate;.    }.  }
7e30: 0a 0a 20 20 2f 2a 20 4e 6f 20 6d 61 74 63 68 20  ..  /* No match 
7e40: 77 61 73 20 66 6f 75 6e 64 2e 20 20 57 65 20 77  was found.  We w
7e50: 69 6c 6c 20 6d 61 6b 65 20 61 20 6e 65 77 20 66  ill make a new f
7e60: 69 6c 65 20 49 44 20 2a 2f 0a 20 20 70 4e 65 77  ile ID */.  pNew
7e70: 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 70 4e  ->nRef = 1;.  pN
7e80: 65 77 2d 3e 6e 4e 61 6d 65 20 3d 20 6e 3b 0a 20  ew->nName = n;. 
7e90: 20 70 4e 65 77 2d 3e 70 4e 65 78 74 20 3d 20 76   pNew->pNext = v
7ea0: 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73 74 3b 0a  xworksFileList;.
7eb0: 20 20 76 78 77 6f 72 6b 73 46 69 6c 65 4c 69 73    vxworksFileLis
7ec0: 74 20 3d 20 70 4e 65 77 3b 0a 20 20 75 6e 69 78  t = pNew;.  unix
7ed0: 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20  LeaveMutex();.  
7ee0: 72 65 74 75 72 6e 20 70 4e 65 77 3b 0a 7d 0a 0a  return pNew;.}..
7ef0: 2f 2a 0a 2a 2a 20 44 65 63 72 65 6d 65 6e 74 20  /*.** Decrement 
7f00: 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f  the reference co
7f10: 75 6e 74 20 6f 6e 20 61 20 76 78 77 6f 72 6b 73  unt on a vxworks
7f20: 46 69 6c 65 49 64 20 6f 62 6a 65 63 74 2e 20 20  FileId object.  
7f30: 46 72 65 65 0a 2a 2a 20 74 68 65 20 6f 62 6a 65  Free.** the obje
7f40: 63 74 20 77 68 65 6e 20 74 68 65 20 72 65 66 65  ct when the refe
7f50: 72 65 6e 63 65 20 63 6f 75 6e 74 20 72 65 61 63  rence count reac
7f60: 68 65 73 20 7a 65 72 6f 2e 0a 2a 2f 0a 73 74 61  hes zero..*/.sta
7f70: 74 69 63 20 76 6f 69 64 20 76 78 77 6f 72 6b 73  tic void vxworks
7f80: 52 65 6c 65 61 73 65 46 69 6c 65 49 64 28 73 74  ReleaseFileId(st
7f90: 72 75 63 74 20 76 78 77 6f 72 6b 73 46 69 6c 65  ruct vxworksFile
7fa0: 49 64 20 2a 70 49 64 29 7b 0a 20 20 75 6e 69 78  Id *pId){.  unix
7fb0: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20  EnterMutex();.  
7fc0: 61 73 73 65 72 74 28 20 70 49 64 2d 3e 6e 52 65  assert( pId->nRe
7fd0: 66 3e 30 20 29 3b 0a 20 20 70 49 64 2d 3e 6e 52  f>0 );.  pId->nR
7fe0: 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 49 64 2d  ef--;.  if( pId-
7ff0: 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20  >nRef==0 ){.    
8000: 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73 46 69  struct vxworksFi
8010: 6c 65 49 64 20 2a 2a 70 70 3b 0a 20 20 20 20 66  leId **pp;.    f
8020: 6f 72 28 70 70 3d 26 76 78 77 6f 72 6b 73 46 69  or(pp=&vxworksFi
8030: 6c 65 4c 69 73 74 3b 20 2a 70 70 20 26 26 20 2a  leList; *pp && *
8040: 70 70 21 3d 70 49 64 3b 20 70 70 20 3d 20 26 28  pp!=pId; pp = &(
8050: 28 2a 70 70 29 2d 3e 70 4e 65 78 74 29 29 7b 7d  (*pp)->pNext)){}
8060: 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 70  .    assert( *pp
8070: 3d 3d 70 49 64 20 29 3b 0a 20 20 20 20 2a 70 70  ==pId );.    *pp
8080: 20 3d 20 70 49 64 2d 3e 70 4e 65 78 74 3b 0a 20   = pId->pNext;. 
8090: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
80a0: 70 49 64 29 3b 0a 20 20 7d 0a 20 20 75 6e 69 78  pId);.  }.  unix
80b0: 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 7d 0a  LeaveMutex();.}.
80c0: 23 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 57  #endif /* OS_VXW
80d0: 4f 52 4b 53 20 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a  ORKS */./*******
80e0: 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20  ******** End of 
80f0: 55 6e 69 71 75 65 20 46 69 6c 65 20 49 44 20 55  Unique File ID U
8100: 74 69 6c 69 74 79 20 55 73 65 64 20 42 79 20 56  tility Used By V
8110: 78 57 6f 72 6b 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  xWorks *********
8120: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  *******.********
8130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8170: 2a 2a 2a 2a 2a 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a  ******/.../*****
8180: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8190: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
81a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
81b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
81c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a  *********.******
81d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
81e0: 2a 2a 2a 2a 2a 20 50 6f 73 69 78 20 41 64 76 69  ***** Posix Advi
81f0: 73 6f 72 79 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a  sory Locking ***
8200: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8210: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20  *********.**.** 
8220: 50 4f 53 49 58 20 61 64 76 69 73 6f 72 79 20 6c  POSIX advisory l
8230: 6f 63 6b 73 20 61 72 65 20 62 72 6f 6b 65 6e 20  ocks are broken 
8240: 62 79 20 64 65 73 69 67 6e 2e 20 20 41 4e 53 49  by design.  ANSI
8250: 20 53 54 44 20 31 30 30 33 2e 31 20 28 31 39 39   STD 1003.1 (199
8260: 36 29 0a 2a 2a 20 73 65 63 74 69 6f 6e 20 36 2e  6).** section 6.
8270: 35 2e 32 2e 32 20 6c 69 6e 65 73 20 34 38 33 20  5.2.2 lines 483 
8280: 74 68 72 6f 75 67 68 20 34 39 30 20 73 70 65 63  through 490 spec
8290: 69 66 79 20 74 68 61 74 20 77 68 65 6e 20 61 20  ify that when a 
82a0: 70 72 6f 63 65 73 73 0a 2a 2a 20 73 65 74 73 20  process.** sets 
82b0: 6f 72 20 63 6c 65 61 72 73 20 61 20 6c 6f 63 6b  or clears a lock
82c0: 2c 20 74 68 61 74 20 6f 70 65 72 61 74 69 6f 6e  , that operation
82d0: 20 6f 76 65 72 72 69 64 65 73 20 61 6e 79 20 70   overrides any p
82e0: 72 69 6f 72 20 6c 6f 63 6b 73 20 73 65 74 0a 2a  rior locks set.*
82f0: 2a 20 62 79 20 74 68 65 20 73 61 6d 65 20 70 72  * by the same pr
8300: 6f 63 65 73 73 2e 20 20 49 74 20 64 6f 65 73 20  ocess.  It does 
8310: 6e 6f 74 20 65 78 70 6c 69 63 69 74 6c 79 20 73  not explicitly s
8320: 61 79 20 73 6f 2c 20 62 75 74 20 74 68 69 73 20  ay so, but this 
8330: 69 6d 70 6c 69 65 73 0a 2a 2a 20 74 68 61 74 20  implies.** that 
8340: 69 74 20 6f 76 65 72 72 69 64 65 73 20 6c 6f 63  it overrides loc
8350: 6b 73 20 73 65 74 20 62 79 20 74 68 65 20 73 61  ks set by the sa
8360: 6d 65 20 70 72 6f 63 65 73 73 20 75 73 69 6e 67  me process using
8370: 20 61 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20   a different.** 
8380: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e  file descriptor.
8390: 20 20 43 6f 6e 73 69 64 65 72 20 74 68 69 73 20    Consider this 
83a0: 74 65 73 74 20 63 61 73 65 3a 0a 2a 2a 0a 2a 2a  test case:.**.**
83b0: 20 20 20 20 20 20 20 69 6e 74 20 66 64 31 20 3d         int fd1 =
83c0: 20 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 31 22 2c   open("./file1",
83d0: 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54 2c   O_RDWR|O_CREAT,
83e0: 20 30 36 34 34 29 3b 0a 2a 2a 20 20 20 20 20 20   0644);.**      
83f0: 20 69 6e 74 20 66 64 32 20 3d 20 6f 70 65 6e 28   int fd2 = open(
8400: 22 2e 2f 66 69 6c 65 32 22 2c 20 4f 5f 52 44 57  "./file2", O_RDW
8410: 52 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29  R|O_CREAT, 0644)
8420: 3b 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20  ;.**.** Suppose 
8430: 2e 2f 66 69 6c 65 31 20 61 6e 64 20 2e 2f 66 69  ./file1 and ./fi
8440: 6c 65 32 20 61 72 65 20 72 65 61 6c 6c 79 20 74  le2 are really t
8450: 68 65 20 73 61 6d 65 20 66 69 6c 65 20 28 62 65  he same file (be
8460: 63 61 75 73 65 0a 2a 2a 20 6f 6e 65 20 69 73 20  cause.** one is 
8470: 61 20 68 61 72 64 20 6f 72 20 73 79 6d 62 6f 6c  a hard or symbol
8480: 69 63 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 6f  ic link to the o
8490: 74 68 65 72 29 20 74 68 65 6e 20 69 66 20 79 6f  ther) then if yo
84a0: 75 20 73 65 74 0a 2a 2a 20 61 6e 20 65 78 63 6c  u set.** an excl
84b0: 75 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 66 64  usive lock on fd
84c0: 31 2c 20 74 68 65 6e 20 74 72 79 20 74 6f 20 67  1, then try to g
84d0: 65 74 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20  et an exclusive 
84e0: 6c 6f 63 6b 0a 2a 2a 20 6f 6e 20 66 64 32 2c 20  lock.** on fd2, 
84f0: 69 74 20 77 6f 72 6b 73 2e 20 20 49 20 77 6f 75  it works.  I wou
8500: 6c 64 20 68 61 76 65 20 65 78 70 65 63 74 65 64  ld have expected
8510: 20 74 68 65 20 73 65 63 6f 6e 64 20 6c 6f 63 6b   the second lock
8520: 20 74 6f 0a 2a 2a 20 66 61 69 6c 20 73 69 6e 63   to.** fail sinc
8530: 65 20 74 68 65 72 65 20 77 61 73 20 61 6c 72 65  e there was alre
8540: 61 64 79 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68  ady a lock on th
8550: 65 20 66 69 6c 65 20 64 75 65 20 74 6f 20 66 64  e file due to fd
8560: 31 2e 0a 2a 2a 20 42 75 74 20 6e 6f 74 20 73 6f  1..** But not so
8570: 2e 20 20 53 69 6e 63 65 20 62 6f 74 68 20 6c 6f  .  Since both lo
8580: 63 6b 73 20 63 61 6d 65 20 66 72 6f 6d 20 74 68  cks came from th
8590: 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2c 20  e same process, 
85a0: 74 68 65 0a 2a 2a 20 73 65 63 6f 6e 64 20 6f 76  the.** second ov
85b0: 65 72 72 69 64 65 73 20 74 68 65 20 66 69 72 73  errides the firs
85c0: 74 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 20 74  t, even though t
85d0: 68 65 79 20 77 65 72 65 20 6f 6e 20 64 69 66 66  hey were on diff
85e0: 65 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20 64 65  erent.** file de
85f0: 73 63 72 69 70 74 6f 72 73 20 6f 70 65 6e 65 64  scriptors opened
8600: 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 20 66 69   on different fi
8610: 6c 65 20 6e 61 6d 65 73 2e 0a 2a 2a 0a 2a 2a 20  le names..**.** 
8620: 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20  This means that 
8630: 77 65 20 63 61 6e 6e 6f 74 20 75 73 65 20 50 4f  we cannot use PO
8640: 53 49 58 20 6c 6f 63 6b 73 20 74 6f 20 73 79 6e  SIX locks to syn
8650: 63 68 72 6f 6e 69 7a 65 20 66 69 6c 65 20 61 63  chronize file ac
8660: 63 65 73 73 0a 2a 2a 20 61 6d 6f 6e 67 20 63 6f  cess.** among co
8670: 6d 70 65 74 69 6e 67 20 74 68 72 65 61 64 73 20  mpeting threads 
8680: 6f 66 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63  of the same proc
8690: 65 73 73 2e 20 20 50 4f 53 49 58 20 6c 6f 63 6b  ess.  POSIX lock
86a0: 73 20 77 69 6c 6c 20 77 6f 72 6b 20 66 69 6e 65  s will work fine
86b0: 0a 2a 2a 20 74 6f 20 73 79 6e 63 68 72 6f 6e 69  .** to synchroni
86c0: 7a 65 20 61 63 63 65 73 73 20 66 6f 72 20 74 68  ze access for th
86d0: 72 65 61 64 73 20 69 6e 20 73 65 70 61 72 61 74  reads in separat
86e0: 65 20 70 72 6f 63 65 73 73 65 73 2c 20 62 75 74  e processes, but
86f0: 20 6e 6f 74 0a 2a 2a 20 74 68 72 65 61 64 73 20   not.** threads 
8700: 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65 20  within the same 
8710: 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54  process..**.** T
8720: 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 74 68  o work around th
8730: 65 20 70 72 6f 62 6c 65 6d 2c 20 53 51 4c 69 74  e problem, SQLit
8740: 65 20 68 61 73 20 74 6f 20 6d 61 6e 61 67 65 20  e has to manage 
8750: 66 69 6c 65 20 6c 6f 63 6b 73 20 69 6e 74 65 72  file locks inter
8760: 6e 61 6c 6c 79 0a 2a 2a 20 6f 6e 20 69 74 73 20  nally.** on its 
8770: 6f 77 6e 2e 20 20 57 68 65 6e 65 76 65 72 20 61  own.  Whenever a
8780: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 69 73   new database is
8790: 20 6f 70 65 6e 65 64 2c 20 77 65 20 68 61 76 65   opened, we have
87a0: 20 74 6f 20 66 69 6e 64 20 74 68 65 0a 2a 2a 20   to find the.** 
87b0: 73 70 65 63 69 66 69 63 20 69 6e 6f 64 65 20 6f  specific inode o
87c0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
87d0: 69 6c 65 20 28 74 68 65 20 69 6e 6f 64 65 20 69  ile (the inode i
87e0: 73 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20  s determined by 
87f0: 74 68 65 0a 2a 2a 20 73 74 5f 64 65 76 20 61 6e  the.** st_dev an
8800: 64 20 73 74 5f 69 6e 6f 20 66 69 65 6c 64 73 20  d st_ino fields 
8810: 6f 66 20 74 68 65 20 73 74 61 74 20 73 74 72 75  of the stat stru
8820: 63 74 75 72 65 20 74 68 61 74 20 66 73 74 61 74  cture that fstat
8830: 28 29 20 66 69 6c 6c 73 20 69 6e 29 0a 2a 2a 20  () fills in).** 
8840: 61 6e 64 20 63 68 65 63 6b 20 66 6f 72 20 6c 6f  and check for lo
8850: 63 6b 73 20 61 6c 72 65 61 64 79 20 65 78 69 73  cks already exis
8860: 74 69 6e 67 20 6f 6e 20 74 68 61 74 20 69 6e 6f  ting on that ino
8870: 64 65 2e 20 20 57 68 65 6e 20 6c 6f 63 6b 73 20  de.  When locks 
8880: 61 72 65 0a 2a 2a 20 63 72 65 61 74 65 64 20 6f  are.** created o
8890: 72 20 72 65 6d 6f 76 65 64 2c 20 77 65 20 68 61  r removed, we ha
88a0: 76 65 20 74 6f 20 6c 6f 6f 6b 20 61 74 20 6f 75  ve to look at ou
88b0: 72 20 6f 77 6e 20 69 6e 74 65 72 6e 61 6c 20 72  r own internal r
88c0: 65 63 6f 72 64 20 6f 66 20 74 68 65 0a 2a 2a 20  ecord of the.** 
88d0: 6c 6f 63 6b 73 20 74 6f 20 73 65 65 20 69 66 20  locks to see if 
88e0: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 20 68  another thread h
88f0: 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 73 65  as previously se
8900: 74 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 61 74  t a lock on that
8910: 20 73 61 6d 65 0a 2a 2a 20 69 6e 6f 64 65 2e 0a   same.** inode..
8920: 2a 2a 0a 2a 2a 20 28 41 73 69 64 65 3a 20 54 68  **.** (Aside: Th
8930: 65 20 75 73 65 20 6f 66 20 69 6e 6f 64 65 20 6e  e use of inode n
8940: 75 6d 62 65 72 73 20 61 73 20 75 6e 69 71 75 65  umbers as unique
8950: 20 49 44 73 20 64 6f 65 73 20 6e 6f 74 20 77 6f   IDs does not wo
8960: 72 6b 20 6f 6e 20 56 78 57 6f 72 6b 73 2e 0a 2a  rk on VxWorks..*
8970: 2a 20 46 6f 72 20 56 78 57 6f 72 6b 73 2c 20 77  * For VxWorks, w
8980: 65 20 68 61 76 65 20 74 6f 20 75 73 65 20 74 68  e have to use th
8990: 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 75 6e  e alternative un
89a0: 69 71 75 65 20 49 44 20 73 79 73 74 65 6d 20 62  ique ID system b
89b0: 61 73 65 64 20 6f 6e 0a 2a 2a 20 63 61 6e 6f 6e  ased on.** canon
89c0: 69 63 61 6c 20 66 69 6c 65 6e 61 6d 65 20 61 6e  ical filename an
89d0: 64 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e  d implemented in
89e0: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 64 69   the previous di
89f0: 76 69 73 69 6f 6e 2e 29 0a 2a 2a 0a 2a 2a 20 54  vision.).**.** T
8a00: 68 65 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  he sqlite3_file 
8a10: 73 74 72 75 63 74 75 72 65 20 66 6f 72 20 50 4f  structure for PO
8a20: 53 49 58 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72  SIX is no longer
8a30: 20 6a 75 73 74 20 61 6e 20 69 6e 74 65 67 65 72   just an integer
8a40: 20 66 69 6c 65 0a 2a 2a 20 64 65 73 63 72 69 70   file.** descrip
8a50: 74 6f 72 2e 20 20 49 74 20 69 73 20 6e 6f 77 20  tor.  It is now 
8a60: 61 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74  a structure that
8a70: 20 68 6f 6c 64 73 20 74 68 65 20 69 6e 74 65 67   holds the integ
8a80: 65 72 20 66 69 6c 65 0a 2a 2a 20 64 65 73 63 72  er file.** descr
8a90: 69 70 74 6f 72 20 61 6e 64 20 61 20 70 6f 69 6e  iptor and a poin
8aa0: 74 65 72 20 74 6f 20 61 20 73 74 72 75 63 74 75  ter to a structu
8ab0: 72 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65  re that describe
8ac0: 73 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 0a 2a  s the internal.*
8ad0: 2a 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 20 63  * locks on the c
8ae0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 69 6e 6f  orresponding ino
8af0: 64 65 2e 20 20 54 68 65 72 65 20 69 73 20 6f 6e  de.  There is on
8b00: 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 75 63 74  e locking struct
8b10: 75 72 65 0a 2a 2a 20 70 65 72 20 69 6e 6f 64 65  ure.** per inode
8b20: 2c 20 73 6f 20 69 66 20 74 68 65 20 73 61 6d 65  , so if the same
8b30: 20 69 6e 6f 64 65 20 69 73 20 6f 70 65 6e 65 64   inode is opened
8b40: 20 74 77 69 63 65 2c 20 62 6f 74 68 20 75 6e 69   twice, both uni
8b50: 78 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 73  xFile structures
8b60: 0a 2a 2a 20 70 6f 69 6e 74 20 74 6f 20 74 68 65  .** point to the
8b70: 20 73 61 6d 65 20 6c 6f 63 6b 69 6e 67 20 73 74   same locking st
8b80: 72 75 63 74 75 72 65 2e 20 20 54 68 65 20 6c 6f  ructure.  The lo
8b90: 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 20  cking structure 
8ba0: 6b 65 65 70 73 0a 2a 2a 20 61 20 72 65 66 65 72  keeps.** a refer
8bb0: 65 6e 63 65 20 63 6f 75 6e 74 20 28 73 6f 20 77  ence count (so w
8bc0: 65 20 77 69 6c 6c 20 6b 6e 6f 77 20 77 68 65 6e  e will know when
8bd0: 20 74 6f 20 64 65 6c 65 74 65 20 69 74 29 20 61   to delete it) a
8be0: 6e 64 20 61 20 22 63 6e 74 22 0a 2a 2a 20 66 69  nd a "cnt".** fi
8bf0: 65 6c 64 20 74 68 61 74 20 74 65 6c 6c 73 20 75  eld that tells u
8c00: 73 20 69 74 73 20 69 6e 74 65 72 6e 61 6c 20 6c  s its internal l
8c10: 6f 63 6b 20 73 74 61 74 75 73 2e 20 20 63 6e 74  ock status.  cnt
8c20: 3d 3d 30 20 6d 65 61 6e 73 20 74 68 65 0a 2a 2a  ==0 means the.**
8c30: 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b 65   file is unlocke
8c40: 64 2e 20 20 63 6e 74 3d 3d 2d 31 20 6d 65 61 6e  d.  cnt==-1 mean
8c50: 73 20 74 68 65 20 66 69 6c 65 20 68 61 73 20 61  s the file has a
8c60: 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b  n exclusive lock
8c70: 2e 0a 2a 2a 20 63 6e 74 3e 30 20 6d 65 61 6e 73  ..** cnt>0 means
8c80: 20 74 68 65 72 65 20 61 72 65 20 63 6e 74 20 73   there are cnt s
8c90: 68 61 72 65 64 20 6c 6f 63 6b 73 20 6f 6e 20 74  hared locks on t
8ca0: 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 41  he file..**.** A
8cb0: 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6c 6f  ny attempt to lo
8cc0: 63 6b 20 6f 72 20 75 6e 6c 6f 63 6b 20 61 20 66  ck or unlock a f
8cd0: 69 6c 65 20 66 69 72 73 74 20 63 68 65 63 6b 73  ile first checks
8ce0: 20 74 68 65 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20   the locking.** 
8cf0: 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 20  structure.  The 
8d00: 66 63 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63  fcntl() system c
8d10: 61 6c 6c 20 69 73 20 6f 6e 6c 79 20 69 6e 76 6f  all is only invo
8d20: 6b 65 64 20 74 6f 20 73 65 74 20 61 20 0a 2a 2a  ked to set a .**
8d30: 20 50 4f 53 49 58 20 6c 6f 63 6b 20 69 66 20 74   POSIX lock if t
8d40: 68 65 20 69 6e 74 65 72 6e 61 6c 20 6c 6f 63 6b  he internal lock
8d50: 20 73 74 72 75 63 74 75 72 65 20 74 72 61 6e 73   structure trans
8d60: 69 74 69 6f 6e 73 20 62 65 74 77 65 65 6e 0a 2a  itions between.*
8d70: 2a 20 61 20 6c 6f 63 6b 65 64 20 61 6e 64 20 61  * a locked and a
8d80: 6e 20 75 6e 6c 6f 63 6b 65 64 20 73 74 61 74 65  n unlocked state
8d90: 2e 0a 2a 2a 0a 2a 2a 20 42 75 74 20 77 61 69 74  ..**.** But wait
8da0: 3a 20 20 74 68 65 72 65 20 61 72 65 20 79 65 74  :  there are yet
8db0: 20 6d 6f 72 65 20 70 72 6f 62 6c 65 6d 73 20 77   more problems w
8dc0: 69 74 68 20 50 4f 53 49 58 20 61 64 76 69 73 6f  ith POSIX adviso
8dd0: 72 79 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20  ry locks..**.** 
8de0: 49 66 20 79 6f 75 20 63 6c 6f 73 65 20 61 20 66  If you close a f
8df0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 74  ile descriptor t
8e00: 68 61 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 20  hat points to a 
8e10: 66 69 6c 65 20 74 68 61 74 20 68 61 73 20 6c 6f  file that has lo
8e20: 63 6b 73 2c 0a 2a 2a 20 61 6c 6c 20 6c 6f 63 6b  cks,.** all lock
8e30: 73 20 6f 6e 20 74 68 61 74 20 66 69 6c 65 20 74  s on that file t
8e40: 68 61 74 20 61 72 65 20 6f 77 6e 65 64 20 62 79  hat are owned by
8e50: 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f   the current pro
8e60: 63 65 73 73 20 61 72 65 0a 2a 2a 20 72 65 6c 65  cess are.** rele
8e70: 61 73 65 64 2e 20 20 54 6f 20 77 6f 72 6b 20 61  ased.  To work a
8e80: 72 6f 75 6e 64 20 74 68 69 73 20 70 72 6f 62 6c  round this probl
8e90: 65 6d 2c 20 65 61 63 68 20 75 6e 69 78 49 6e 6f  em, each unixIno
8ea0: 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 0a 2a 2a  deInfo object.**
8eb0: 20 6d 61 69 6e 74 61 69 6e 73 20 61 20 63 6f 75   maintains a cou
8ec0: 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72  nt of the number
8ed0: 20 6f 66 20 70 65 6e 64 69 6e 67 20 6c 6f 63 6b   of pending lock
8ee0: 73 20 6f 6e 20 74 68 61 20 69 6e 6f 64 65 2e 0a  s on tha inode..
8ef0: 2a 2a 20 57 68 65 6e 20 61 6e 20 61 74 74 65 6d  ** When an attem
8f00: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 63 6c  pt is made to cl
8f10: 6f 73 65 20 61 6e 20 75 6e 69 78 46 69 6c 65 2c  ose an unixFile,
8f20: 20 69 66 20 74 68 65 72 65 20 61 72 65 0a 2a 2a   if there are.**
8f30: 20 6f 74 68 65 72 20 75 6e 69 78 46 69 6c 65 20   other unixFile 
8f40: 6f 70 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65  open on the same
8f50: 20 69 6e 6f 64 65 20 74 68 61 74 20 61 72 65 20   inode that are 
8f60: 68 6f 6c 64 69 6e 67 20 6c 6f 63 6b 73 2c 20 74  holding locks, t
8f70: 68 65 20 63 61 6c 6c 0a 2a 2a 20 74 6f 20 63 6c  he call.** to cl
8f80: 6f 73 65 28 29 20 74 68 65 20 66 69 6c 65 20 64  ose() the file d
8f90: 65 73 63 72 69 70 74 6f 72 20 69 73 20 64 65 66  escriptor is def
8fa0: 65 72 72 65 64 20 75 6e 74 69 6c 20 61 6c 6c 20  erred until all 
8fb0: 6f 66 20 74 68 65 20 6c 6f 63 6b 73 20 63 6c 65  of the locks cle
8fc0: 61 72 2e 0a 2a 2a 20 54 68 65 20 75 6e 69 78 49  ar..** The unixI
8fd0: 6e 6f 64 65 49 6e 66 6f 20 73 74 72 75 63 74 75  nodeInfo structu
8fe0: 72 65 20 6b 65 65 70 73 20 61 20 6c 69 73 74 20  re keeps a list 
8ff0: 6f 66 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  of file descript
9000: 6f 72 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f  ors that need to
9010: 0a 2a 2a 20 62 65 20 63 6c 6f 73 65 64 20 61 6e  .** be closed an
9020: 64 20 74 68 61 74 20 6c 69 73 74 20 69 73 20 77  d that list is w
9030: 61 6c 6b 65 64 20 28 61 6e 64 20 63 6c 65 61 72  alked (and clear
9040: 65 64 29 20 77 68 65 6e 20 74 68 65 20 6c 61 73  ed) when the las
9050: 74 20 6c 6f 63 6b 0a 2a 2a 20 63 6c 65 61 72 73  t lock.** clears
9060: 2e 0a 2a 2a 0a 2a 2a 20 59 65 74 20 61 6e 6f 74  ..**.** Yet anot
9070: 68 65 72 20 70 72 6f 62 6c 65 6d 3a 20 20 4c 69  her problem:  Li
9080: 6e 75 78 54 68 72 65 61 64 73 20 64 6f 20 6e 6f  nuxThreads do no
9090: 74 20 70 6c 61 79 20 77 65 6c 6c 20 77 69 74 68  t play well with
90a0: 20 70 6f 73 69 78 20 6c 6f 63 6b 73 2e 0a 2a 2a   posix locks..**
90b0: 0a 2a 2a 20 4d 61 6e 79 20 6f 6c 64 65 72 20 76  .** Many older v
90c0: 65 72 73 69 6f 6e 73 20 6f 66 20 6c 69 6e 75 78  ersions of linux
90d0: 20 75 73 65 20 74 68 65 20 4c 69 6e 75 78 54 68   use the LinuxTh
90e0: 72 65 61 64 73 20 6c 69 62 72 61 72 79 20 77 68  reads library wh
90f0: 69 63 68 20 69 73 0a 2a 2a 20 6e 6f 74 20 70 6f  ich is.** not po
9100: 73 69 78 20 63 6f 6d 70 6c 69 61 6e 74 2e 20 20  six compliant.  
9110: 55 6e 64 65 72 20 4c 69 6e 75 78 54 68 72 65 61  Under LinuxThrea
9120: 64 73 2c 20 61 20 6c 6f 63 6b 20 63 72 65 61 74  ds, a lock creat
9130: 65 64 20 62 79 20 74 68 72 65 61 64 0a 2a 2a 20  ed by thread.** 
9140: 41 20 63 61 6e 6e 6f 74 20 62 65 20 6d 6f 64 69  A cannot be modi
9150: 66 69 65 64 20 6f 72 20 6f 76 65 72 72 69 64 64  fied or overridd
9160: 65 6e 20 62 79 20 61 20 64 69 66 66 65 72 65 6e  en by a differen
9170: 74 20 74 68 72 65 61 64 20 42 2e 0a 2a 2a 20 4f  t thread B..** O
9180: 6e 6c 79 20 74 68 72 65 61 64 20 41 20 63 61 6e  nly thread A can
9190: 20 6d 6f 64 69 66 79 20 74 68 65 20 6c 6f 63 6b   modify the lock
91a0: 2e 20 20 4c 6f 63 6b 69 6e 67 20 62 65 68 61 76  .  Locking behav
91b0: 69 6f 72 20 69 73 20 63 6f 72 72 65 63 74 0a 2a  ior is correct.*
91c0: 2a 20 69 66 20 74 68 65 20 61 70 70 6c 69 61 74  * if the appliat
91d0: 69 6f 6e 20 75 73 65 73 20 74 68 65 20 6e 65 77  ion uses the new
91e0: 65 72 20 4e 61 74 69 76 65 20 50 6f 73 69 78 20  er Native Posix 
91f0: 54 68 72 65 61 64 20 4c 69 62 72 61 72 79 20 28  Thread Library (
9200: 4e 50 54 4c 29 0a 2a 2a 20 6f 6e 20 6c 69 6e 75  NPTL).** on linu
9210: 78 20 2d 20 77 69 74 68 20 4e 50 54 4c 20 61 20  x - with NPTL a 
9220: 6c 6f 63 6b 20 63 72 65 61 74 65 64 20 62 79 20  lock created by 
9230: 74 68 72 65 61 64 20 41 20 63 61 6e 20 6f 76 65  thread A can ove
9240: 72 72 69 64 65 20 6c 6f 63 6b 73 0a 2a 2a 20 69  rride locks.** i
9250: 6e 20 74 68 72 65 61 64 20 42 2e 20 20 42 75 74  n thread B.  But
9260: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79   there is no way
9270: 20 74 6f 20 6b 6e 6f 77 20 61 74 20 63 6f 6d 70   to know at comp
9280: 69 6c 65 2d 74 69 6d 65 20 77 68 69 63 68 0a 2a  ile-time which.*
9290: 2a 20 74 68 72 65 61 64 69 6e 67 20 6c 69 62 72  * threading libr
92a0: 61 72 79 20 69 73 20 62 65 69 6e 67 20 75 73 65  ary is being use
92b0: 64 2e 20 20 53 6f 20 74 68 65 72 65 20 69 73 20  d.  So there is 
92c0: 6e 6f 20 77 61 79 20 74 6f 20 6b 6e 6f 77 20 61  no way to know a
92d0: 74 0a 2a 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  t.** compile-tim
92e0: 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74  e whether or not
92f0: 20 74 68 72 65 61 64 20 41 20 63 61 6e 20 6f 76   thread A can ov
9300: 65 72 72 69 64 65 20 6c 6f 63 6b 73 20 6f 6e 20  erride locks on 
9310: 74 68 72 65 61 64 20 42 2e 0a 2a 2a 20 4f 6e 65  thread B..** One
9320: 20 68 61 73 20 74 6f 20 64 6f 20 61 20 72 75 6e   has to do a run
9330: 2d 74 69 6d 65 20 63 68 65 63 6b 20 74 6f 20 64  -time check to d
9340: 69 73 63 6f 76 65 72 20 74 68 65 20 62 65 68 61  iscover the beha
9350: 76 69 6f 72 20 6f 66 20 74 68 65 0a 2a 2a 20 63  vior of the.** c
9360: 75 72 72 65 6e 74 20 70 72 6f 63 65 73 73 2e 0a  urrent process..
9370: 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 75 73 65  **.** SQLite use
9380: 64 20 74 6f 20 73 75 70 70 6f 72 74 20 4c 69 6e  d to support Lin
9390: 75 78 54 68 72 65 61 64 73 2e 20 20 42 75 74 20  uxThreads.  But 
93a0: 73 75 70 70 6f 72 74 20 66 6f 72 20 4c 69 6e 75  support for Linu
93b0: 78 54 68 72 65 61 64 73 0a 2a 2a 20 77 61 73 20  xThreads.** was 
93c0: 64 72 6f 70 70 65 64 20 62 65 67 69 6e 6e 69 6e  dropped beginnin
93d0: 67 20 77 69 74 68 20 76 65 72 73 69 6f 6e 20 33  g with version 3
93e0: 2e 37 2e 30 2e 20 20 53 51 4c 69 74 65 20 77 69  .7.0.  SQLite wi
93f0: 6c 6c 20 73 74 69 6c 6c 20 77 6f 72 6b 20 77 69  ll still work wi
9400: 74 68 0a 2a 2a 20 4c 69 6e 75 78 54 68 72 65 61  th.** LinuxThrea
9410: 64 73 20 70 72 6f 76 69 64 65 64 20 74 68 61 74  ds provided that
9420: 20 28 31 29 20 74 68 65 72 65 20 69 73 20 6e 6f   (1) there is no
9430: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 63   more than one c
9440: 6f 6e 6e 65 63 74 69 6f 6e 20 0a 2a 2a 20 70 65  onnection .** pe
9450: 72 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  r database file 
9460: 69 6e 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63  in the same proc
9470: 65 73 73 20 61 6e 64 20 28 32 29 20 64 61 74 61  ess and (2) data
9480: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73  base connections
9490: 0a 2a 2a 20 64 6f 20 6e 6f 74 20 6d 6f 76 65 20  .** do not move 
94a0: 61 63 72 6f 73 73 20 74 68 72 65 61 64 73 2e 0a  across threads..
94b0: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73  */../*.** An ins
94c0: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c  tance of the fol
94d0: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65  lowing structure
94e0: 20 73 65 72 76 65 73 20 61 73 20 74 68 65 20 6b   serves as the k
94f0: 65 79 20 75 73 65 64 0a 2a 2a 20 74 6f 20 6c 6f  ey used.** to lo
9500: 63 61 74 65 20 61 20 70 61 72 74 69 63 75 6c 61  cate a particula
9510: 72 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20  r unixInodeInfo 
9520: 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 72 75 63  object..*/.struc
9530: 74 20 75 6e 69 78 46 69 6c 65 49 64 20 7b 0a 20  t unixFileId {. 
9540: 20 64 65 76 5f 74 20 64 65 76 3b 20 20 20 20 20   dev_t dev;     
9550: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
9560: 44 65 76 69 63 65 20 6e 75 6d 62 65 72 20 2a 2f  Device number */
9570: 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a  .#if OS_VXWORKS.
9580: 20 20 73 74 72 75 63 74 20 76 78 77 6f 72 6b 73    struct vxworks
9590: 46 69 6c 65 49 64 20 2a 70 49 64 3b 20 20 2f 2a  FileId *pId;  /*
95a0: 20 55 6e 69 71 75 65 20 66 69 6c 65 20 49 44 20   Unique file ID 
95b0: 66 6f 72 20 76 78 77 6f 72 6b 73 2e 20 2a 2f 0a  for vxworks. */.
95c0: 23 65 6c 73 65 0a 20 20 2f 2a 20 57 65 20 61 72  #else.  /* We ar
95d0: 65 20 74 6f 6c 64 20 74 68 61 74 20 73 6f 6d 65  e told that some
95e0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 41 6e 64   versions of And
95f0: 72 6f 69 64 20 63 6f 6e 74 61 69 6e 20 61 20 62  roid contain a b
9600: 75 67 20 74 68 61 74 0a 20 20 2a 2a 20 73 69 7a  ug that.  ** siz
9610: 65 73 20 69 6e 6f 5f 74 20 61 74 20 6f 6e 6c 79  es ino_t at only
9620: 20 33 32 2d 62 69 74 73 20 69 6e 73 74 65 61 64   32-bits instead
9630: 20 6f 66 20 36 34 2d 62 69 74 73 2e 20 28 53 65   of 64-bits. (Se
9640: 65 0a 20 20 2a 2a 20 68 74 74 70 73 3a 2f 2f 61  e.  ** https://a
9650: 6e 64 72 6f 69 64 2d 72 65 76 69 65 77 2e 67 6f  ndroid-review.go
9660: 6f 67 6c 65 73 6f 75 72 63 65 2e 63 6f 6d 2f 23  oglesource.com/#
9670: 2f 63 2f 31 31 35 33 35 31 2f 33 2f 64 69 73 74  /c/115351/3/dist
9680: 2f 73 71 6c 69 74 65 33 2e 63 29 0a 20 20 2a 2a  /sqlite3.c).  **
9690: 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20   To work around 
96a0: 74 68 69 73 2c 20 61 6c 77 61 79 73 20 61 6c 6c  this, always all
96b0: 6f 63 61 74 65 20 36 34 2d 62 69 74 73 20 66 6f  ocate 64-bits fo
96c0: 72 20 74 68 65 20 69 6e 6f 64 65 20 6e 75 6d 62  r the inode numb
96d0: 65 72 2e 20 20 0a 20 20 2a 2a 20 4f 6e 20 73 6d  er.  .  ** On sm
96e0: 61 6c 6c 20 6d 61 63 68 69 6e 65 73 20 74 68 61  all machines tha
96f0: 74 20 6f 6e 6c 79 20 68 61 76 65 20 33 32 2d 62  t only have 32-b
9700: 69 74 20 69 6e 6f 64 65 73 2c 20 74 68 69 73 20  it inodes, this 
9710: 77 61 73 74 65 73 20 34 20 62 79 74 65 73 2c 0a  wastes 4 bytes,.
9720: 20 20 2a 2a 20 62 75 74 20 74 68 61 74 20 73 68    ** but that sh
9730: 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 20 62 69  ould not be a bi
9740: 67 20 64 65 61 6c 2e 20 2a 2f 0a 20 20 2f 2a 20  g deal. */.  /* 
9750: 57 41 53 3a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b  WAS:  ino_t ino;
9760: 20 20 20 2a 2f 0a 20 20 75 36 34 20 69 6e 6f 3b     */.  u64 ino;
9770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9780: 20 20 20 2f 2a 20 49 6e 6f 64 65 20 6e 75 6d 62     /* Inode numb
9790: 65 72 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a  er */.#endif.};.
97a0: 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e  ./*.** An instan
97b0: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ce of the follow
97c0: 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 69 73  ing structure is
97d0: 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 65   allocated for e
97e0: 61 63 68 20 6f 70 65 6e 0a 2a 2a 20 69 6e 6f 64  ach open.** inod
97f0: 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 69 6e 67 6c  e..**.** A singl
9800: 65 20 69 6e 6f 64 65 20 63 61 6e 20 68 61 76 65  e inode can have
9810: 20 6d 75 6c 74 69 70 6c 65 20 66 69 6c 65 20 64   multiple file d
9820: 65 73 63 72 69 70 74 6f 72 73 2c 20 73 6f 20 65  escriptors, so e
9830: 61 63 68 20 75 6e 69 78 46 69 6c 65 0a 2a 2a 20  ach unixFile.** 
9840: 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69  structure contai
9850: 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ns a pointer to 
9860: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
9870: 68 69 73 20 6f 62 6a 65 63 74 20 61 6e 64 20 74  his object and t
9880: 68 69 73 0a 2a 2a 20 6f 62 6a 65 63 74 20 6b 65  his.** object ke
9890: 65 70 73 20 61 20 63 6f 75 6e 74 20 6f 66 20 74  eps a count of t
98a0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 75 6e 69  he number of uni
98b0: 78 46 69 6c 65 20 70 6f 69 6e 74 69 6e 67 20 74  xFile pointing t
98c0: 6f 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 4d 75 74 65  o it..**.** Mute
98d0: 78 20 72 75 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20  x rules:.**.**  
98e0: 28 31 29 20 4f 6e 6c 79 20 74 68 65 20 70 4c 6f  (1) Only the pLo
98f0: 63 6b 4d 75 74 65 78 20 6d 75 74 65 78 20 6d 75  ckMutex mutex mu
9900: 73 74 20 62 65 20 68 65 6c 64 20 69 6e 20 6f 72  st be held in or
9910: 64 65 72 20 74 6f 20 72 65 61 64 20 6f 72 20 77  der to read or w
9920: 72 69 74 65 0a 2a 2a 20 20 20 20 20 20 61 6e 79  rite.**      any
9930: 20 6f 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20   of the locking 
9940: 66 69 65 6c 64 73 3a 0a 2a 2a 20 20 20 20 20 20  fields:.**      
9950: 20 20 20 20 6e 53 68 61 72 65 64 2c 20 6e 4c 6f      nShared, nLo
9960: 63 6b 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 20 62  ck, eFileLock, b
9970: 50 72 6f 63 65 73 73 4c 6f 63 6b 2c 20 70 55 6e  ProcessLock, pUn
9980: 75 73 65 64 0a 2a 2a 0a 2a 2a 20 20 28 32 29 20  used.**.**  (2) 
9990: 57 68 65 6e 20 6e 52 65 66 3e 30 2c 20 74 68 65  When nRef>0, the
99a0: 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  n the following 
99b0: 66 69 65 6c 64 73 20 61 72 65 20 75 6e 63 68 61  fields are uncha
99c0: 6e 67 69 6e 67 20 61 6e 64 20 63 61 6e 0a 2a 2a  nging and can.**
99d0: 20 20 20 20 20 20 62 65 20 72 65 61 64 20 28 62        be read (b
99e0: 75 74 20 6e 6f 74 20 77 72 69 74 74 65 6e 29 20  ut not written) 
99f0: 77 69 74 68 6f 75 74 20 68 6f 6c 64 69 6e 67 20  without holding 
9a00: 61 6e 79 20 6d 75 74 65 78 3a 0a 2a 2a 20 20 20  any mutex:.**   
9a10: 20 20 20 20 20 20 20 66 69 6c 65 49 64 2c 20 70         fileId, p
9a20: 4c 6f 63 6b 4d 75 74 65 78 0a 2a 2a 0a 2a 2a 20  LockMutex.**.** 
9a30: 20 28 33 29 20 57 69 74 68 20 74 68 65 20 65 78   (3) With the ex
9a40: 63 65 70 74 69 6f 6e 73 20 61 62 6f 76 65 2c 20  ceptions above, 
9a50: 61 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20 6d  all the fields m
9a60: 61 79 20 6f 6e 6c 79 20 62 65 20 72 65 61 64 0a  ay only be read.
9a70: 2a 2a 20 20 20 20 20 20 6f 72 20 77 72 69 74 74  **      or writt
9a80: 65 6e 20 77 68 69 6c 65 20 68 6f 6c 64 69 6e 67  en while holding
9a90: 20 74 68 65 20 67 6c 6f 62 61 6c 20 75 6e 69 78   the global unix
9aa0: 42 69 67 4c 6f 63 6b 20 6d 75 74 65 78 2e 0a 2a  BigLock mutex..*
9ab0: 2a 0a 2a 2a 20 44 65 61 64 6c 6f 63 6b 20 70 72  *.** Deadlock pr
9ac0: 65 76 65 6e 74 69 6f 6e 3a 20 20 54 68 65 20 67  evention:  The g
9ad0: 6c 6f 62 61 6c 20 75 6e 69 78 42 69 67 4c 6f 63  lobal unixBigLoc
9ae0: 6b 20 6d 75 74 65 78 20 6d 61 79 20 6e 6f 74 0a  k mutex may not.
9af0: 2a 2a 20 62 65 20 61 63 71 75 69 72 65 64 20 77  ** be acquired w
9b00: 68 69 6c 65 20 68 6f 6c 64 69 6e 67 20 74 68 65  hile holding the
9b10: 20 70 4c 6f 63 6b 4d 75 74 65 78 20 6d 75 74 65   pLockMutex mute
9b20: 78 2e 20 20 49 66 20 62 6f 74 68 20 75 6e 69 78  x.  If both unix
9b30: 42 69 67 4c 6f 63 6b 0a 2a 2a 20 61 6e 64 20 70  BigLock.** and p
9b40: 4c 6f 63 6b 4d 75 74 65 78 20 61 72 65 20 6e 65  LockMutex are ne
9b50: 65 64 65 64 2c 20 74 68 65 6e 20 75 6e 69 78 42  eded, then unixB
9b60: 69 67 4c 6f 63 6b 20 6d 75 73 74 20 62 65 20 61  igLock must be a
9b70: 63 71 75 69 72 65 64 20 66 69 72 73 74 2e 0a 2a  cquired first..*
9b80: 2f 0a 73 74 72 75 63 74 20 75 6e 69 78 49 6e 6f  /.struct unixIno
9b90: 64 65 49 6e 66 6f 20 7b 0a 20 20 73 74 72 75 63  deInfo {.  struc
9ba0: 74 20 75 6e 69 78 46 69 6c 65 49 64 20 66 69 6c  t unixFileId fil
9bb0: 65 49 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 68  eId;       /* Th
9bc0: 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f 0a  e lookup key */.
9bd0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
9be0: 2a 70 4c 6f 63 6b 4d 75 74 65 78 3b 20 20 20 20  *pLockMutex;    
9bf0: 20 20 2f 2a 20 48 6f 6c 64 20 74 68 69 73 20 6d    /* Hold this m
9c00: 75 74 65 78 20 66 6f 72 2e 2e 2e 20 2a 2f 0a 20  utex for... */. 
9c10: 20 69 6e 74 20 6e 53 68 61 72 65 64 3b 20 20 20   int nShared;   
9c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9c30: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
9c40: 53 48 41 52 45 44 20 6c 6f 63 6b 73 20 68 65 6c  SHARED locks hel
9c50: 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 63 6b  d */.  int nLock
9c60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
9c70: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
9c80: 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64 69 6e  er of outstandin
9c90: 67 20 66 69 6c 65 20 6c 6f 63 6b 73 20 2a 2f 0a  g file locks */.
9ca0: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20    unsigned char 
9cb0: 65 46 69 6c 65 4c 6f 63 6b 3b 20 20 20 20 20 20  eFileLock;      
9cc0: 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 53 48      /* One of SH
9cd0: 41 52 45 44 5f 4c 4f 43 4b 2c 20 52 45 53 45 52  ARED_LOCK, RESER
9ce0: 56 45 44 5f 4c 4f 43 4b 20 65 74 63 2e 20 2a 2f  VED_LOCK etc. */
9cf0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  .  unsigned char
9d00: 20 62 50 72 6f 63 65 73 73 4c 6f 63 6b 3b 20 20   bProcessLock;  
9d10: 20 20 20 20 20 2f 2a 20 41 6e 20 65 78 63 6c 75       /* An exclu
9d20: 73 69 76 65 20 70 72 6f 63 65 73 73 20 6c 6f 63  sive process loc
9d30: 6b 20 69 73 20 68 65 6c 64 20 2a 2f 0a 20 20 55  k is held */.  U
9d40: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 55 6e  nixUnusedFd *pUn
9d50: 75 73 65 64 3b 20 20 20 20 20 20 20 20 20 20 20  used;           
9d60: 20 2f 2a 20 55 6e 75 73 65 64 20 66 69 6c 65 20   /* Unused file 
9d70: 64 65 73 63 72 69 70 74 6f 72 73 20 74 6f 20 63  descriptors to c
9d80: 6c 6f 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 52  lose */.  int nR
9d90: 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ef;             
9da0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
9db0: 62 65 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 20  ber of pointers 
9dc0: 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 72  to this structur
9dd0: 65 20 2a 2f 0a 20 20 75 6e 69 78 53 68 6d 4e 6f  e */.  unixShmNo
9de0: 64 65 20 2a 70 53 68 6d 4e 6f 64 65 3b 20 20 20  de *pShmNode;   
9df0: 20 20 20 20 20 20 20 2f 2a 20 53 68 61 72 65 64         /* Shared
9e00: 20 6d 65 6d 6f 72 79 20 61 73 73 6f 63 69 61 74   memory associat
9e10: 65 64 20 77 69 74 68 20 74 68 69 73 20 69 6e 6f  ed with this ino
9e20: 64 65 20 2a 2f 0a 20 20 75 6e 69 78 49 6e 6f 64  de */.  unixInod
9e30: 65 49 6e 66 6f 20 2a 70 4e 65 78 74 3b 20 20 20  eInfo *pNext;   
9e40: 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20          /* List 
9e50: 6f 66 20 61 6c 6c 20 75 6e 69 78 49 6e 6f 64 65  of all unixInode
9e60: 49 6e 66 6f 20 6f 62 6a 65 63 74 73 20 2a 2f 0a  Info objects */.
9e70: 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20    unixInodeInfo 
9e80: 2a 70 50 72 65 76 3b 20 20 20 20 20 20 20 20 20  *pPrev;         
9e90: 20 20 2f 2a 20 20 20 20 2e 2e 2e 2e 20 64 6f 75    /*    .... dou
9ea0: 62 6c 79 20 6c 69 6e 6b 65 64 20 2a 2f 0a 23 69  bly linked */.#i
9eb0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
9ec0: 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20  LOCKING_STYLE.  
9ed0: 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f  unsigned long lo
9ee0: 6e 67 20 73 68 61 72 65 64 42 79 74 65 3b 20 20  ng sharedByte;  
9ef0: 2f 2a 20 66 6f 72 20 41 46 50 20 73 69 6d 75 6c  /* for AFP simul
9f00: 61 74 65 64 20 73 68 61 72 65 64 20 6c 6f 63 6b  ated shared lock
9f10: 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f   */.#endif.#if O
9f20: 53 5f 56 58 57 4f 52 4b 53 0a 20 20 73 65 6d 5f  S_VXWORKS.  sem_
9f30: 74 20 2a 70 53 65 6d 3b 20 20 20 20 20 20 20 20  t *pSem;        
9f40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
9f50: 61 6d 65 64 20 50 4f 53 49 58 20 73 65 6d 61 70  amed POSIX semap
9f60: 68 6f 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 61  hore */.  char a
9f70: 53 65 6d 4e 61 6d 65 5b 4d 41 58 5f 50 41 54 48  SemName[MAX_PATH
9f80: 4e 41 4d 45 2b 32 5d 3b 20 20 2f 2a 20 4e 61 6d  NAME+2];  /* Nam
9f90: 65 20 6f 66 20 74 68 61 74 20 73 65 6d 61 70 68  e of that semaph
9fa0: 6f 72 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b  ore */.#endif.};
9fb0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 74 73 20  ../*.** A lists 
9fc0: 6f 66 20 61 6c 6c 20 75 6e 69 78 49 6e 6f 64 65  of all unixInode
9fd0: 49 6e 66 6f 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a  Info objects..**
9fe0: 0a 2a 2a 20 4d 75 73 74 20 68 6f 6c 64 20 75 6e  .** Must hold un
9ff0: 69 78 42 69 67 4c 6f 63 6b 20 69 6e 20 6f 72 64  ixBigLock in ord
a000: 65 72 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72  er to read or wr
a010: 69 74 65 20 74 68 69 73 20 76 61 72 69 61 62 6c  ite this variabl
a020: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 6e 69  e..*/.static uni
a030: 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 69 6e 6f 64  xInodeInfo *inod
a040: 65 4c 69 73 74 20 3d 20 30 3b 20 20 2f 2a 20 41  eList = 0;  /* A
a050: 6c 6c 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f  ll unixInodeInfo
a060: 20 6f 62 6a 65 63 74 73 20 2a 2f 0a 0a 23 69 66   objects */..#if
a070: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  def SQLITE_DEBUG
a080: 0a 2f 2a 0a 2a 2a 20 54 72 75 65 20 69 66 20 74  ./*.** True if t
a090: 68 65 20 69 6e 6f 64 65 20 6d 75 74 65 78 20 28  he inode mutex (
a0a0: 6f 6e 20 74 68 65 20 75 6e 69 78 46 69 6c 65 2e  on the unixFile.
a0b0: 70 46 69 6c 65 4d 75 74 65 78 20 66 69 65 6c 64  pFileMutex field
a0c0: 29 20 69 73 20 68 65 6c 64 2c 20 6f 72 20 6e 6f  ) is held, or no
a0d0: 74 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  t..** This routi
a0e0: 6e 65 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20  ne is used only 
a0f0: 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20  within assert() 
a100: 74 6f 20 68 65 6c 70 20 76 65 72 69 66 79 20 63  to help verify c
a110: 6f 72 72 65 63 74 20 6d 75 74 65 78 0a 2a 2a 20  orrect mutex.** 
a120: 75 73 61 67 65 2e 0a 2a 2f 0a 69 6e 74 20 75 6e  usage..*/.int un
a130: 69 78 46 69 6c 65 4d 75 74 65 78 48 65 6c 64 28  ixFileMutexHeld(
a140: 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29  unixFile *pFile)
a150: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c  {.  assert( pFil
a160: 65 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a 20 20 72  e->pInode );.  r
a170: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d 75  eturn sqlite3_mu
a180: 74 65 78 5f 68 65 6c 64 28 70 46 69 6c 65 2d 3e  tex_held(pFile->
a190: 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74  pInode->pLockMut
a1a0: 65 78 29 3b 0a 7d 0a 69 6e 74 20 75 6e 69 78 46  ex);.}.int unixF
a1b0: 69 6c 65 4d 75 74 65 78 4e 6f 74 68 65 6c 64 28  ileMutexNotheld(
a1c0: 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 29  unixFile *pFile)
a1d0: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c  {.  assert( pFil
a1e0: 65 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a 20 20 72  e->pInode );.  r
a1f0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 6d 75  eturn sqlite3_mu
a200: 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 46 69 6c  tex_notheld(pFil
a210: 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b  e->pInode->pLock
a220: 4d 75 74 65 78 29 3b 0a 7d 0a 23 65 6e 64 69 66  Mutex);.}.#endif
a230: 0a 0a 2f 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ../*.**.** This 
a240: 66 75 6e 63 74 69 6f 6e 20 2d 20 75 6e 69 78 4c  function - unixL
a250: 6f 67 45 72 72 6f 72 41 74 4c 69 6e 65 28 29 2c  ogErrorAtLine(),
a260: 20 69 73 20 6f 6e 6c 79 20 65 76 65 72 20 63 61   is only ever ca
a270: 6c 6c 65 64 20 76 69 61 20 74 68 65 20 6d 61 63  lled via the mac
a280: 72 6f 0a 2a 2a 20 75 6e 69 78 4c 6f 67 45 72 72  ro.** unixLogErr
a290: 6f 72 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69  or()..**.** It i
a2a0: 73 20 69 6e 76 6f 6b 65 64 20 61 66 74 65 72 20  s invoked after 
a2b0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20  an error occurs 
a2c0: 69 6e 20 61 6e 20 4f 53 20 66 75 6e 63 74 69 6f  in an OS functio
a2d0: 6e 20 61 6e 64 20 65 72 72 6e 6f 20 68 61 73 20  n and errno has 
a2e0: 62 65 65 6e 0a 2a 2a 20 73 65 74 2e 20 49 74 20  been.** set. It 
a2f0: 6c 6f 67 73 20 61 20 6d 65 73 73 61 67 65 20 75  logs a message u
a300: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67  sing sqlite3_log
a310: 28 29 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  () containing th
a320: 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 20  e current value 
a330: 6f 66 0a 2a 2a 20 65 72 72 6e 6f 20 61 6e 64 2c  of.** errno and,
a340: 20 69 66 20 70 6f 73 73 69 62 6c 65 2c 20 74 68   if possible, th
a350: 65 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65  e human-readable
a360: 20 65 71 75 69 76 61 6c 65 6e 74 20 66 72 6f 6d   equivalent from
a370: 20 73 74 72 65 72 72 6f 72 28 29 20 6f 72 0a 2a   strerror() or.*
a380: 2a 20 73 74 72 65 72 72 6f 72 5f 72 28 29 2e 0a  * strerror_r()..
a390: 2a 2a 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20  **.** The first 
a3a0: 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20  argument passed 
a3b0: 74 6f 20 74 68 65 20 6d 61 63 72 6f 20 73 68 6f  to the macro sho
a3c0: 75 6c 64 20 62 65 20 74 68 65 20 65 72 72 6f 72  uld be the error
a3d0: 20 63 6f 64 65 20 74 68 61 74 0a 2a 2a 20 77 69   code that.** wi
a3e0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 74  ll be returned t
a3f0: 6f 20 53 51 4c 69 74 65 20 28 65 2e 67 2e 20 53  o SQLite (e.g. S
a400: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 4c 45  QLITE_IOERR_DELE
a410: 54 45 2c 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  TE, SQLITE_CANTO
a420: 50 45 4e 29 2e 20 0a 2a 2a 20 54 68 65 20 74 77  PEN). .** The tw
a430: 6f 20 73 75 62 73 65 71 75 65 6e 74 20 61 72 67  o subsequent arg
a440: 75 6d 65 6e 74 73 20 73 68 6f 75 6c 64 20 62 65  uments should be
a450: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
a460: 20 4f 53 20 66 75 6e 63 74 69 6f 6e 20 74 68 61   OS function tha
a470: 74 0a 2a 2a 20 66 61 69 6c 65 64 20 28 65 2e 67  t.** failed (e.g
a480: 2e 20 22 75 6e 6c 69 6e 6b 22 2c 20 22 6f 70 65  . "unlink", "ope
a490: 6e 22 29 20 61 6e 64 20 74 68 65 20 61 73 73 6f  n") and the asso
a4a0: 63 69 61 74 65 64 20 66 69 6c 65 2d 73 79 73 74  ciated file-syst
a4b0: 65 6d 20 70 61 74 68 2c 0a 2a 2a 20 69 66 20 61  em path,.** if a
a4c0: 6e 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 75  ny..*/.#define u
a4d0: 6e 69 78 4c 6f 67 45 72 72 6f 72 28 61 2c 62 2c  nixLogError(a,b,
a4e0: 63 29 20 20 20 20 20 75 6e 69 78 4c 6f 67 45 72  c)     unixLogEr
a4f0: 72 6f 72 41 74 4c 69 6e 65 28 61 2c 62 2c 63 2c  rorAtLine(a,b,c,
a500: 5f 5f 4c 49 4e 45 5f 5f 29 0a 73 74 61 74 69 63  __LINE__).static
a510: 20 69 6e 74 20 75 6e 69 78 4c 6f 67 45 72 72 6f   int unixLogErro
a520: 72 41 74 4c 69 6e 65 28 0a 20 20 69 6e 74 20 65  rAtLine(.  int e
a530: 72 72 63 6f 64 65 2c 20 20 20 20 20 20 20 20 20  rrcode,         
a540: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 51             /* SQ
a550: 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20  Lite error code 
a560: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
a570: 2a 7a 46 75 6e 63 2c 20 20 20 20 20 20 20 20 20  *zFunc,         
a580: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20       /* Name of 
a590: 4f 53 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74  OS function that
a5a0: 20 66 61 69 6c 65 64 20 2a 2f 0a 20 20 63 6f 6e   failed */.  con
a5b0: 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20  st char *zPath, 
a5c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
a5d0: 46 69 6c 65 20 70 61 74 68 20 61 73 73 6f 63 69  File path associ
a5e0: 61 74 65 64 20 77 69 74 68 20 65 72 72 6f 72 20  ated with error 
a5f0: 2a 2f 0a 20 20 69 6e 74 20 69 4c 69 6e 65 20 20  */.  int iLine  
a600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a610: 20 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 6c       /* Source l
a620: 69 6e 65 20 6e 75 6d 62 65 72 20 77 68 65 72 65  ine number where
a630: 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20   error occurred 
a640: 2a 2f 0a 29 7b 0a 20 20 63 68 61 72 20 2a 7a 45  */.){.  char *zE
a650: 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  rr;             
a660: 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 73 73 61          /* Messa
a670: 67 65 20 66 72 6f 6d 20 73 74 72 65 72 72 6f 72  ge from strerror
a680: 28 29 20 6f 72 20 65 71 75 69 76 61 6c 65 6e 74  () or equivalent
a690: 20 2a 2f 0a 20 20 69 6e 74 20 69 45 72 72 6e 6f   */.  int iErrno
a6a0: 20 3d 20 65 72 72 6e 6f 3b 20 20 20 20 20 20 20   = errno;       
a6b0: 20 20 20 20 20 20 2f 2a 20 53 61 76 65 64 20 73        /* Saved s
a6c0: 79 73 63 61 6c 6c 20 65 72 72 6f 72 20 6e 75 6d  yscall error num
a6d0: 62 65 72 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 20  ber */..  /* If 
a6e0: 74 68 69 73 20 69 73 20 6e 6f 74 20 61 20 74 68  this is not a th
a6f0: 72 65 61 64 73 61 66 65 20 62 75 69 6c 64 20 28  readsafe build (
a700: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
a710: 45 3d 3d 30 29 2c 20 74 68 65 6e 20 75 73 65 0a  E==0), then use.
a720: 20 20 2a 2a 20 74 68 65 20 73 74 72 65 72 72 6f    ** the strerro
a730: 72 28 29 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20  r() function to 
a740: 6f 62 74 61 69 6e 20 74 68 65 20 68 75 6d 61 6e  obtain the human
a750: 2d 72 65 61 64 61 62 6c 65 20 65 72 72 6f 72 20  -readable error 
a760: 6d 65 73 73 61 67 65 0a 20 20 2a 2a 20 65 71 75  message.  ** equ
a770: 69 76 61 6c 65 6e 74 20 74 6f 20 65 72 72 6e 6f  ivalent to errno
a780: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 75 73 65  . Otherwise, use
a790: 20 73 74 72 65 72 72 6f 72 5f 72 28 29 2e 0a 20   strerror_r().. 
a7a0: 20 2a 2f 20 0a 23 69 66 20 53 51 4c 49 54 45 5f   */ .#if SQLITE_
a7b0: 54 48 52 45 41 44 53 41 46 45 20 26 26 20 64 65  THREADSAFE && de
a7c0: 66 69 6e 65 64 28 48 41 56 45 5f 53 54 52 45 52  fined(HAVE_STRER
a7d0: 52 4f 52 5f 52 29 0a 20 20 63 68 61 72 20 61 45  ROR_R).  char aE
a7e0: 72 72 5b 38 30 5d 3b 0a 20 20 6d 65 6d 73 65 74  rr[80];.  memset
a7f0: 28 61 45 72 72 2c 20 30 2c 20 73 69 7a 65 6f 66  (aErr, 0, sizeof
a800: 28 61 45 72 72 29 29 3b 0a 20 20 7a 45 72 72 20  (aErr));.  zErr 
a810: 3d 20 61 45 72 72 3b 0a 0a 20 20 2f 2a 20 49 66  = aErr;..  /* If
a820: 20 53 54 52 45 52 52 4f 52 5f 52 5f 43 48 41 52   STRERROR_R_CHAR
a830: 5f 50 20 28 73 65 74 20 62 79 20 61 75 74 6f 63  _P (set by autoc
a840: 6f 6e 66 20 73 63 72 69 70 74 73 29 20 6f 72 20  onf scripts) or 
a850: 5f 5f 55 53 45 5f 47 4e 55 20 69 73 20 64 65 66  __USE_GNU is def
a860: 69 6e 65 64 2c 0a 20 20 2a 2a 20 61 73 73 75 6d  ined,.  ** assum
a870: 65 20 74 68 61 74 20 74 68 65 20 73 79 73 74 65  e that the syste
a880: 6d 20 70 72 6f 76 69 64 65 73 20 74 68 65 20 47  m provides the G
a890: 4e 55 20 76 65 72 73 69 6f 6e 20 6f 66 20 73 74  NU version of st
a8a0: 72 65 72 72 6f 72 5f 72 28 29 20 74 68 61 74 0a  rerror_r() that.
a8b0: 20 20 2a 2a 20 72 65 74 75 72 6e 73 20 61 20 70    ** returns a p
a8c0: 6f 69 6e 74 65 72 20 74 6f 20 61 20 62 75 66 66  ointer to a buff
a8d0: 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  er containing th
a8e0: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e  e error message.
a8f0: 20 54 68 61 74 20 70 6f 69 6e 74 65 72 20 0a 20   That pointer . 
a900: 20 2a 2a 20 6d 61 79 20 70 6f 69 6e 74 20 74 6f   ** may point to
a910: 20 61 45 72 72 5b 5d 2c 20 6f 72 20 69 74 20 6d   aErr[], or it m
a920: 61 79 20 70 6f 69 6e 74 20 74 6f 20 73 6f 6d 65  ay point to some
a930: 20 73 74 61 74 69 63 20 73 74 6f 72 61 67 65 20   static storage 
a940: 73 6f 6d 65 77 68 65 72 65 2e 20 0a 20 20 2a 2a  somewhere. .  **
a950: 20 4f 74 68 65 72 77 69 73 65 2c 20 61 73 73 75   Otherwise, assu
a960: 6d 65 20 74 68 61 74 20 74 68 65 20 73 79 73 74  me that the syst
a970: 65 6d 20 70 72 6f 76 69 64 65 73 20 74 68 65 20  em provides the 
a980: 50 4f 53 49 58 20 76 65 72 73 69 6f 6e 20 6f 66  POSIX version of
a990: 20 0a 20 20 2a 2a 20 73 74 72 65 72 72 6f 72 5f   .  ** strerror_
a9a0: 72 28 29 2c 20 77 68 69 63 68 20 61 6c 77 61 79  r(), which alway
a9b0: 73 20 77 72 69 74 65 73 20 61 6e 20 65 72 72 6f  s writes an erro
a9c0: 72 20 6d 65 73 73 61 67 65 20 69 6e 74 6f 20 61  r message into a
a9d0: 45 72 72 5b 5d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  Err[]..  **.  **
a9e0: 20 49 66 20 74 68 65 20 63 6f 64 65 20 69 6e 63   If the code inc
a9f0: 6f 72 72 65 63 74 6c 79 20 61 73 73 75 6d 65 73  orrectly assumes
aa00: 20 74 68 61 74 20 69 74 20 69 73 20 74 68 65 20   that it is the 
aa10: 50 4f 53 49 58 20 76 65 72 73 69 6f 6e 20 74 68  POSIX version th
aa20: 61 74 20 69 73 0a 20 20 2a 2a 20 61 76 61 69 6c  at is.  ** avail
aa30: 61 62 6c 65 2c 20 74 68 65 20 65 72 72 6f 72 20  able, the error 
aa40: 6d 65 73 73 61 67 65 20 77 69 6c 6c 20 6f 66 74  message will oft
aa50: 65 6e 20 62 65 20 61 6e 20 65 6d 70 74 79 20 73  en be an empty s
aa60: 74 72 69 6e 67 2e 20 4e 6f 74 20 61 0a 20 20 2a  tring. Not a.  *
aa70: 2a 20 68 75 67 65 20 70 72 6f 62 6c 65 6d 2e 20  * huge problem. 
aa80: 49 6e 63 6f 72 72 65 63 74 6c 79 20 63 6f 6e 63  Incorrectly conc
aa90: 6c 75 64 69 6e 67 20 74 68 61 74 20 74 68 65 20  luding that the 
aaa0: 47 4e 55 20 76 65 72 73 69 6f 6e 20 69 73 20 61  GNU version is a
aab0: 76 61 69 6c 61 62 6c 65 20 0a 20 20 2a 2a 20 63  vailable .  ** c
aac0: 6f 75 6c 64 20 6c 65 61 64 20 74 6f 20 61 20 73  ould lead to a s
aad0: 65 67 66 61 75 6c 74 20 74 68 6f 75 67 68 2e 0a  egfault though..
aae0: 20 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64    */.#if defined
aaf0: 28 53 54 52 45 52 52 4f 52 5f 52 5f 43 48 41 52  (STRERROR_R_CHAR
ab00: 5f 50 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f  _P) || defined(_
ab10: 5f 55 53 45 5f 47 4e 55 29 0a 20 20 7a 45 72 72  _USE_GNU).  zErr
ab20: 20 3d 20 0a 23 20 65 6e 64 69 66 0a 20 20 73 74   = .# endif.  st
ab30: 72 65 72 72 6f 72 5f 72 28 69 45 72 72 6e 6f 2c  rerror_r(iErrno,
ab40: 20 61 45 72 72 2c 20 73 69 7a 65 6f 66 28 61 45   aErr, sizeof(aE
ab50: 72 72 29 2d 31 29 3b 0a 0a 23 65 6c 69 66 20 53  rr)-1);..#elif S
ab60: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45  QLITE_THREADSAFE
ab70: 0a 20 20 2f 2a 20 54 68 69 73 20 69 73 20 61 20  .  /* This is a 
ab80: 74 68 72 65 61 64 73 61 66 65 20 62 75 69 6c 64  threadsafe build
ab90: 2c 20 62 75 74 20 73 74 72 65 72 72 6f 72 5f 72  , but strerror_r
aba0: 28 29 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61  () is not availa
abb0: 62 6c 65 2e 20 2a 2f 0a 20 20 7a 45 72 72 20 3d  ble. */.  zErr =
abc0: 20 22 22 3b 0a 23 65 6c 73 65 0a 20 20 2f 2a 20   "";.#else.  /* 
abd0: 4e 6f 6e 2d 74 68 72 65 61 64 73 61 66 65 20 62  Non-threadsafe b
abe0: 75 69 6c 64 2c 20 75 73 65 20 73 74 72 65 72 72  uild, use strerr
abf0: 6f 72 28 29 2e 20 2a 2f 0a 20 20 7a 45 72 72 20  or(). */.  zErr 
ac00: 3d 20 73 74 72 65 72 72 6f 72 28 69 45 72 72 6e  = strerror(iErrn
ac10: 6f 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66  o);.#endif..  if
ac20: 28 20 7a 50 61 74 68 3d 3d 30 20 29 20 7a 50 61  ( zPath==0 ) zPa
ac30: 74 68 20 3d 20 22 22 3b 0a 20 20 73 71 6c 69 74  th = "";.  sqlit
ac40: 65 33 5f 6c 6f 67 28 65 72 72 63 6f 64 65 2c 0a  e3_log(errcode,.
ac50: 20 20 20 20 20 20 22 6f 73 5f 75 6e 69 78 2e 63        "os_unix.c
ac60: 3a 25 64 3a 20 28 25 64 29 20 25 73 28 25 73 29  :%d: (%d) %s(%s)
ac70: 20 2d 20 25 73 22 2c 0a 20 20 20 20 20 20 69 4c   - %s",.      iL
ac80: 69 6e 65 2c 20 69 45 72 72 6e 6f 2c 20 7a 46 75  ine, iErrno, zFu
ac90: 6e 63 2c 20 7a 50 61 74 68 2c 20 7a 45 72 72 0a  nc, zPath, zErr.
aca0: 20 20 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 65    );..  return e
acb0: 72 72 63 6f 64 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  rrcode;.}../*.**
acc0: 20 43 6c 6f 73 65 20 61 20 66 69 6c 65 20 64 65   Close a file de
acd0: 73 63 72 69 70 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20  scriptor..**.** 
ace0: 57 65 20 61 73 73 75 6d 65 20 74 68 61 74 20 63  We assume that c
acf0: 6c 6f 73 65 28 29 20 61 6c 6d 6f 73 74 20 61 6c  lose() almost al
ad00: 77 61 79 73 20 77 6f 72 6b 73 2c 20 73 69 6e 63  ways works, sinc
ad10: 65 20 69 74 20 69 73 20 6f 6e 6c 79 20 69 6e 20  e it is only in 
ad20: 61 0a 2a 2a 20 76 65 72 79 20 73 69 63 6b 20 61  a.** very sick a
ad30: 70 70 6c 69 63 61 74 69 6f 6e 20 6f 72 20 6f 6e  pplication or on
ad40: 20 61 20 76 65 72 79 20 73 69 63 6b 20 70 6c 61   a very sick pla
ad50: 74 66 6f 72 6d 20 74 68 61 74 20 69 74 20 6d 69  tform that it mi
ad60: 67 68 74 20 66 61 69 6c 2e 0a 2a 2a 20 49 66 20  ght fail..** If 
ad70: 69 74 20 64 6f 65 73 20 66 61 69 6c 2c 20 73 69  it does fail, si
ad80: 6d 70 6c 79 20 6c 65 61 6b 20 74 68 65 20 66 69  mply leak the fi
ad90: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2c 20 62  le descriptor, b
ada0: 75 74 20 64 6f 20 6c 6f 67 20 74 68 65 0a 2a 2a  ut do log the.**
adb0: 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 4e 6f   error..**.** No
adc0: 74 65 20 74 68 61 74 20 69 74 20 69 73 20 6e 6f  te that it is no
add0: 74 20 73 61 66 65 20 74 6f 20 72 65 74 72 79 20  t safe to retry 
ade0: 63 6c 6f 73 65 28 29 20 61 66 74 65 72 20 45 49  close() after EI
adf0: 4e 54 52 20 73 69 6e 63 65 20 74 68 65 0a 2a 2a  NTR since the.**
ae00: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
ae10: 20 6d 69 67 68 74 20 68 61 76 65 20 61 6c 72 65   might have alre
ae20: 61 64 79 20 62 65 65 6e 20 72 65 75 73 65 64 20  ady been reused 
ae30: 62 79 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61  by another threa
ae40: 64 2e 0a 2a 2a 20 53 6f 20 77 65 20 64 6f 6e 27  d..** So we don'
ae50: 74 20 65 76 65 6e 20 74 72 79 20 74 6f 20 72 65  t even try to re
ae60: 63 6f 76 65 72 20 66 72 6f 6d 20 61 6e 20 45 49  cover from an EI
ae70: 4e 54 52 2e 20 20 4a 75 73 74 20 6c 6f 67 20 74  NTR.  Just log t
ae80: 68 65 20 65 72 72 6f 72 0a 2a 2a 20 61 6e 64 20  he error.** and 
ae90: 6d 6f 76 65 20 6f 6e 2e 0a 2a 2f 0a 73 74 61 74  move on..*/.stat
aea0: 69 63 20 76 6f 69 64 20 72 6f 62 75 73 74 5f 63  ic void robust_c
aeb0: 6c 6f 73 65 28 75 6e 69 78 46 69 6c 65 20 2a 70  lose(unixFile *p
aec0: 46 69 6c 65 2c 20 69 6e 74 20 68 2c 20 69 6e 74  File, int h, int
aed0: 20 6c 69 6e 65 6e 6f 29 7b 0a 20 20 69 66 28 20   lineno){.  if( 
aee0: 6f 73 43 6c 6f 73 65 28 68 29 20 29 7b 0a 20 20  osClose(h) ){.  
aef0: 20 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 41 74    unixLogErrorAt
af00: 4c 69 6e 65 28 53 51 4c 49 54 45 5f 49 4f 45 52  Line(SQLITE_IOER
af10: 52 5f 43 4c 4f 53 45 2c 20 22 63 6c 6f 73 65 22  R_CLOSE, "close"
af20: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
af30: 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 20 3f           pFile ?
af40: 20 70 46 69 6c 65 2d 3e 7a 50 61 74 68 20 3a 20   pFile->zPath : 
af50: 30 2c 20 6c 69 6e 65 6e 6f 29 3b 0a 20 20 7d 0a  0, lineno);.  }.
af60: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65  }../*.** Set the
af70: 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72 72 6e   pFile->lastErrn
af80: 6f 2e 20 20 44 6f 20 74 68 69 73 20 69 6e 20 61  o.  Do this in a
af90: 20 73 75 62 72 6f 75 74 69 6e 65 20 61 73 20 74   subroutine as t
afa0: 68 61 74 20 70 72 6f 76 69 64 65 73 0a 2a 2a 20  hat provides.** 
afb0: 61 20 63 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61  a convenient pla
afc0: 63 65 20 74 6f 20 73 65 74 20 61 20 62 72 65 61  ce to set a brea
afd0: 6b 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69  kpoint..*/.stati
afe0: 63 20 76 6f 69 64 20 73 74 6f 72 65 4c 61 73 74  c void storeLast
aff0: 45 72 72 6e 6f 28 75 6e 69 78 46 69 6c 65 20 2a  Errno(unixFile *
b000: 70 46 69 6c 65 2c 20 69 6e 74 20 65 72 72 6f 72  pFile, int error
b010: 29 7b 0a 20 20 70 46 69 6c 65 2d 3e 6c 61 73 74  ){.  pFile->last
b020: 45 72 72 6e 6f 20 3d 20 65 72 72 6f 72 3b 0a 7d  Errno = error;.}
b030: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c  ../*.** Close al
b040: 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  l file descripto
b050: 72 73 20 61 63 63 75 6d 75 61 74 65 64 20 69 6e  rs accumuated in
b060: 20 74 68 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e   the unixInodeIn
b070: 66 6f 2d 3e 70 55 6e 75 73 65 64 20 6c 69 73 74  fo->pUnused list
b080: 2e 0a 2a 2f 20 0a 73 74 61 74 69 63 20 76 6f 69  ..*/ .static voi
b090: 64 20 63 6c 6f 73 65 50 65 6e 64 69 6e 67 46 64  d closePendingFd
b0a0: 73 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c  s(unixFile *pFil
b0b0: 65 29 7b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49  e){.  unixInodeI
b0c0: 6e 66 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46  nfo *pInode = pF
b0d0: 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55  ile->pInode;.  U
b0e0: 6e 69 78 55 6e 75 73 65 64 46 64 20 2a 70 3b 0a  nixUnusedFd *p;.
b0f0: 20 20 55 6e 69 78 55 6e 75 73 65 64 46 64 20 2a    UnixUnusedFd *
b100: 70 4e 65 78 74 3b 0a 20 20 61 73 73 65 72 74 28  pNext;.  assert(
b110: 20 75 6e 69 78 46 69 6c 65 4d 75 74 65 78 48 65   unixFileMutexHe
b120: 6c 64 28 70 46 69 6c 65 29 20 29 3b 0a 20 20 66  ld(pFile) );.  f
b130: 6f 72 28 70 3d 70 49 6e 6f 64 65 2d 3e 70 55 6e  or(p=pInode->pUn
b140: 75 73 65 64 3b 20 70 3b 20 70 3d 70 4e 65 78 74  used; p; p=pNext
b150: 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70  ){.    pNext = p
b160: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 72 6f 62  ->pNext;.    rob
b170: 75 73 74 5f 63 6c 6f 73 65 28 70 46 69 6c 65 2c  ust_close(pFile,
b180: 20 70 2d 3e 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f   p->fd, __LINE__
b190: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  );.    sqlite3_f
b1a0: 72 65 65 28 70 29 3b 0a 20 20 7d 0a 20 20 70 49  ree(p);.  }.  pI
b1b0: 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 20 3d 20  node->pUnused = 
b1c0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65  0;.}../*.** Rele
b1d0: 61 73 65 20 61 20 75 6e 69 78 49 6e 6f 64 65 49  ase a unixInodeI
b1e0: 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 70 72  nfo structure pr
b1f0: 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 74  eviously allocat
b200: 65 64 20 62 79 20 66 69 6e 64 49 6e 6f 64 65 49  ed by findInodeI
b210: 6e 66 6f 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  nfo()..**.** The
b220: 20 67 6c 6f 62 61 6c 20 6d 75 74 65 78 20 6d 75   global mutex mu
b230: 73 74 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20  st be held when 
b240: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
b250: 63 61 6c 6c 65 64 2c 20 62 75 74 20 74 68 65 20  called, but the 
b260: 6d 75 74 65 78 0a 2a 2a 20 6f 6e 20 74 68 65 20  mutex.** on the 
b270: 69 6e 6f 64 65 20 62 65 69 6e 67 20 64 65 6c 65  inode being dele
b280: 74 65 64 20 6d 75 73 74 20 4e 4f 54 20 62 65 20  ted must NOT be 
b290: 68 65 6c 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  held..*/.static 
b2a0: 76 6f 69 64 20 72 65 6c 65 61 73 65 49 6e 6f 64  void releaseInod
b2b0: 65 49 6e 66 6f 28 75 6e 69 78 46 69 6c 65 20 2a  eInfo(unixFile *
b2c0: 70 46 69 6c 65 29 7b 0a 20 20 75 6e 69 78 49 6e  pFile){.  unixIn
b2d0: 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 20  odeInfo *pInode 
b2e0: 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b  = pFile->pInode;
b2f0: 0a 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d  .  assert( unixM
b300: 75 74 65 78 48 65 6c 64 28 29 20 29 3b 0a 20 20  utexHeld() );.  
b310: 61 73 73 65 72 74 28 20 75 6e 69 78 46 69 6c 65  assert( unixFile
b320: 4d 75 74 65 78 4e 6f 74 68 65 6c 64 28 70 46 69  MutexNotheld(pFi
b330: 6c 65 29 20 29 3b 0a 20 20 69 66 28 20 41 4c 57  le) );.  if( ALW
b340: 41 59 53 28 70 49 6e 6f 64 65 29 20 29 7b 0a 20  AYS(pInode) ){. 
b350: 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 52 65 66 2d     pInode->nRef-
b360: 2d 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 6f 64  -;.    if( pInod
b370: 65 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20  e->nRef==0 ){.  
b380: 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f      assert( pIno
b390: 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 3d 3d 30 20  de->pShmNode==0 
b3a0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
b3b0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 49 6e  _mutex_enter(pIn
b3c0: 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29  ode->pLockMutex)
b3d0: 3b 0a 20 20 20 20 20 20 63 6c 6f 73 65 50 65 6e  ;.      closePen
b3e0: 64 69 6e 67 46 64 73 28 70 46 69 6c 65 29 3b 0a  dingFds(pFile);.
b3f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75        sqlite3_mu
b400: 74 65 78 5f 6c 65 61 76 65 28 70 49 6e 6f 64 65  tex_leave(pInode
b410: 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a 20  ->pLockMutex);. 
b420: 20 20 20 20 20 69 66 28 20 70 49 6e 6f 64 65 2d       if( pInode-
b430: 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 20 20  >pPrev ){.      
b440: 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 65    assert( pInode
b450: 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 3d 3d  ->pPrev->pNext==
b460: 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 20 20 20  pInode );.      
b470: 20 20 70 49 6e 6f 64 65 2d 3e 70 50 72 65 76 2d    pInode->pPrev-
b480: 3e 70 4e 65 78 74 20 3d 20 70 49 6e 6f 64 65 2d  >pNext = pInode-
b490: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 65  >pNext;.      }e
b4a0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 61 73 73  lse{.        ass
b4b0: 65 72 74 28 20 69 6e 6f 64 65 4c 69 73 74 3d 3d  ert( inodeList==
b4c0: 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 20 20 20  pInode );.      
b4d0: 20 20 69 6e 6f 64 65 4c 69 73 74 20 3d 20 70 49    inodeList = pI
b4e0: 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  node->pNext;.   
b4f0: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70     }.      if( p
b500: 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 20 29 7b 0a  Inode->pNext ){.
b510: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
b520: 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 2d 3e 70  pInode->pNext->p
b530: 50 72 65 76 3d 3d 70 49 6e 6f 64 65 20 29 3b 0a  Prev==pInode );.
b540: 20 20 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e          pInode->
b550: 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70  pNext->pPrev = p
b560: 49 6e 6f 64 65 2d 3e 70 50 72 65 76 3b 0a 20 20  Inode->pPrev;.  
b570: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
b580: 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 70  te3_mutex_free(p
b590: 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65  Inode->pLockMute
b5a0: 78 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  x);.      sqlite
b5b0: 33 5f 66 72 65 65 28 70 49 6e 6f 64 65 29 3b 0a  3_free(pInode);.
b5c0: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
b5d0: 2a 2a 20 47 69 76 65 6e 20 61 20 66 69 6c 65 20  ** Given a file 
b5e0: 64 65 73 63 72 69 70 74 6f 72 2c 20 6c 6f 63 61  descriptor, loca
b5f0: 74 65 20 74 68 65 20 75 6e 69 78 49 6e 6f 64 65  te the unixInode
b600: 49 6e 66 6f 20 6f 62 6a 65 63 74 20 74 68 61 74  Info object that
b610: 0a 2a 2a 20 64 65 73 63 72 69 62 65 73 20 74 68  .** describes th
b620: 61 74 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  at file descript
b630: 6f 72 2e 20 20 43 72 65 61 74 65 20 61 20 6e 65  or.  Create a ne
b640: 77 20 6f 6e 65 20 69 66 20 6e 65 63 65 73 73 61  w one if necessa
b650: 72 79 2e 20 20 54 68 65 0a 2a 2a 20 72 65 74 75  ry.  The.** retu
b660: 72 6e 20 76 61 6c 75 65 20 6d 69 67 68 74 20 62  rn value might b
b670: 65 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20  e uninitialized 
b680: 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  if an error occu
b690: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 67 6c  rs..**.** The gl
b6a0: 6f 62 61 6c 20 6d 75 74 65 78 20 6d 75 73 74 20  obal mutex must 
b6b0: 68 65 6c 64 20 77 68 65 6e 20 63 61 6c 6c 69 6e  held when callin
b6c0: 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a  g this routine..
b6d0: 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20  **.** Return an 
b6e0: 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f  appropriate erro
b6f0: 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69  r code..*/.stati
b700: 63 20 69 6e 74 20 66 69 6e 64 49 6e 6f 64 65 49  c int findInodeI
b710: 6e 66 6f 28 0a 20 20 75 6e 69 78 46 69 6c 65 20  nfo(.  unixFile 
b720: 2a 70 46 69 6c 65 2c 20 20 20 20 20 20 20 20 20  *pFile,         
b730: 20 20 20 20 20 20 2f 2a 20 55 6e 69 78 20 66 69        /* Unix fi
b740: 6c 65 20 77 69 74 68 20 66 69 6c 65 20 64 65 73  le with file des
b750: 63 20 75 73 65 64 20 69 6e 20 74 68 65 20 6b 65  c used in the ke
b760: 79 20 2a 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65  y */.  unixInode
b770: 49 6e 66 6f 20 2a 2a 70 70 49 6e 6f 64 65 20 20  Info **ppInode  
b780: 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20        /* Return 
b790: 74 68 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66  the unixInodeInf
b7a0: 6f 20 6f 62 6a 65 63 74 20 68 65 72 65 20 2a 2f  o object here */
b7b0: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20  .){.  int rc;   
b7c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b7d0: 20 20 20 20 20 2f 2a 20 53 79 73 74 65 6d 20 63       /* System c
b7e0: 61 6c 6c 20 72 65 74 75 72 6e 20 63 6f 64 65 20  all return code 
b7f0: 2a 2f 0a 20 20 69 6e 74 20 66 64 3b 20 20 20 20  */.  int fd;    
b800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b810: 20 20 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20      /* The file 
b820: 64 65 73 63 72 69 70 74 6f 72 20 66 6f 72 20 70  descriptor for p
b830: 46 69 6c 65 20 2a 2f 0a 20 20 73 74 72 75 63 74  File */.  struct
b840: 20 75 6e 69 78 46 69 6c 65 49 64 20 66 69 6c 65   unixFileId file
b850: 49 64 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 6b  Id;      /* Look
b860: 75 70 20 6b 65 79 20 66 6f 72 20 74 68 65 20 75  up key for the u
b870: 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 2f 0a  nixInodeInfo */.
b880: 20 20 73 74 72 75 63 74 20 73 74 61 74 20 73 74    struct stat st
b890: 61 74 62 75 66 3b 20 20 20 20 20 20 20 20 20 20  atbuf;          
b8a0: 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 66 69   /* Low-level fi
b8b0: 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a  le information *
b8c0: 2f 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66  /.  unixInodeInf
b8d0: 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 30 3b 20 20  o *pInode = 0;  
b8e0: 20 20 20 2f 2a 20 43 61 6e 64 69 64 61 74 65 20     /* Candidate 
b8f0: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 6f 62  unixInodeInfo ob
b900: 6a 65 63 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72  ject */..  asser
b910: 74 28 20 75 6e 69 78 4d 75 74 65 78 48 65 6c 64  t( unixMutexHeld
b920: 28 29 20 29 3b 0a 0a 20 20 2f 2a 20 47 65 74 20  () );..  /* Get 
b930: 6c 6f 77 2d 6c 65 76 65 6c 20 69 6e 66 6f 72 6d  low-level inform
b940: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20  ation about the 
b950: 66 69 6c 65 20 74 68 61 74 20 77 65 20 63 61 6e  file that we can
b960: 20 75 73 65 64 20 74 6f 0a 20 20 2a 2a 20 63 72   used to.  ** cr
b970: 65 61 74 65 20 61 20 75 6e 69 71 75 65 20 6e 61  eate a unique na
b980: 6d 65 20 66 6f 72 20 74 68 65 20 66 69 6c 65 2e  me for the file.
b990: 0a 20 20 2a 2f 0a 20 20 66 64 20 3d 20 70 46 69  .  */.  fd = pFi
b9a0: 6c 65 2d 3e 68 3b 0a 20 20 72 63 20 3d 20 6f 73  le->h;.  rc = os
b9b0: 46 73 74 61 74 28 66 64 2c 20 26 73 74 61 74 62  Fstat(fd, &statb
b9c0: 75 66 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 30  uf);.  if( rc!=0
b9d0: 20 29 7b 0a 20 20 20 20 73 74 6f 72 65 4c 61 73   ){.    storeLas
b9e0: 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72  tErrno(pFile, er
b9f0: 72 6e 6f 29 3b 0a 23 69 66 20 64 65 66 69 6e 65  rno);.#if define
ba00: 64 28 45 4f 56 45 52 46 4c 4f 57 29 20 26 26 20  d(EOVERFLOW) && 
ba10: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
ba20: 49 53 41 42 4c 45 5f 4c 46 53 29 0a 20 20 20 20  ISABLE_LFS).    
ba30: 69 66 28 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45  if( pFile->lastE
ba40: 72 72 6e 6f 3d 3d 45 4f 56 45 52 46 4c 4f 57 20  rrno==EOVERFLOW 
ba50: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
ba60: 4e 4f 4c 46 53 3b 0a 23 65 6e 64 69 66 0a 20 20  NOLFS;.#endif.  
ba70: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
ba80: 49 4f 45 52 52 3b 0a 20 20 7d 0a 0a 23 69 66 64  IOERR;.  }..#ifd
ba90: 65 66 20 5f 5f 41 50 50 4c 45 5f 5f 0a 20 20 2f  ef __APPLE__.  /
baa0: 2a 20 4f 6e 20 4f 53 20 58 20 6f 6e 20 61 6e 20  * On OS X on an 
bab0: 6d 73 64 6f 73 20 66 69 6c 65 73 79 73 74 65 6d  msdos filesystem
bac0: 2c 20 74 68 65 20 69 6e 6f 64 65 20 6e 75 6d 62  , the inode numb
bad0: 65 72 20 69 73 20 72 65 70 6f 72 74 65 64 0a 20  er is reported. 
bae0: 20 2a 2a 20 69 6e 63 6f 72 72 65 63 74 6c 79 20   ** incorrectly 
baf0: 66 6f 72 20 7a 65 72 6f 2d 73 69 7a 65 20 66 69  for zero-size fi
bb00: 6c 65 73 2e 20 20 53 65 65 20 74 69 63 6b 65 74  les.  See ticket
bb10: 20 23 33 32 36 30 2e 20 20 54 6f 20 77 6f 72 6b   #3260.  To work
bb20: 0a 20 20 2a 2a 20 61 72 6f 75 6e 64 20 74 68 69  .  ** around thi
bb30: 73 20 70 72 6f 62 6c 65 6d 20 28 77 65 20 63 6f  s problem (we co
bb40: 6e 73 69 64 65 72 20 69 74 20 61 20 62 75 67 20  nsider it a bug 
bb50: 69 6e 20 4f 53 20 58 2c 20 6e 6f 74 20 53 51 4c  in OS X, not SQL
bb60: 69 74 65 29 0a 20 20 2a 2a 20 77 65 20 61 6c 77  ite).  ** we alw
bb70: 61 79 73 20 69 6e 63 72 65 61 73 65 20 74 68 65  ays increase the
bb80: 20 66 69 6c 65 20 73 69 7a 65 20 74 6f 20 31 20   file size to 1 
bb90: 62 79 20 77 72 69 74 69 6e 67 20 61 20 73 69 6e  by writing a sin
bba0: 67 6c 65 20 62 79 74 65 0a 20 20 2a 2a 20 70 72  gle byte.  ** pr
bbb0: 69 6f 72 20 74 6f 20 61 63 63 65 73 73 69 6e 67  ior to accessing
bbc0: 20 74 68 65 20 69 6e 6f 64 65 20 6e 75 6d 62 65   the inode numbe
bbd0: 72 2e 20 20 54 68 65 20 6f 6e 65 20 62 79 74 65  r.  The one byte
bbe0: 20 77 72 69 74 74 65 6e 20 69 73 0a 20 20 2a 2a   written is.  **
bbf0: 20 61 6e 20 41 53 43 49 49 20 27 53 27 20 63 68   an ASCII 'S' ch
bc00: 61 72 61 63 74 65 72 20 77 68 69 63 68 20 61 6c  aracter which al
bc10: 73 6f 20 68 61 70 70 65 6e 73 20 74 6f 20 62 65  so happens to be
bc20: 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 0a   the first byte.
bc30: 20 20 2a 2a 20 69 6e 20 74 68 65 20 68 65 61 64    ** in the head
bc40: 65 72 20 6f 66 20 65 76 65 72 79 20 53 51 4c 69  er of every SQLi
bc50: 74 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 6e  te database.  In
bc60: 20 74 68 69 73 20 77 61 79 2c 20 69 66 20 74 68   this way, if th
bc70: 65 72 65 0a 20 20 2a 2a 20 69 73 20 61 20 72 61  ere.  ** is a ra
bc80: 63 65 20 63 6f 6e 64 69 74 69 6f 6e 20 73 75 63  ce condition suc
bc90: 68 20 74 68 61 74 20 61 6e 6f 74 68 65 72 20 74  h that another t
bca0: 68 72 65 61 64 20 68 61 73 20 61 6c 72 65 61 64  hread has alread
bcb0: 79 20 70 6f 70 75 6c 61 74 65 64 0a 20 20 2a 2a  y populated.  **
bcc0: 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20   the first page 
bcd0: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2c  of the database,
bce0: 20 6e 6f 20 64 61 6d 61 67 65 20 69 73 20 64 6f   no damage is do
bcf0: 6e 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 73  ne..  */.  if( s
bd00: 74 61 74 62 75 66 2e 73 74 5f 73 69 7a 65 3d 3d  tatbuf.st_size==
bd10: 30 20 26 26 20 28 70 46 69 6c 65 2d 3e 66 73 46  0 && (pFile->fsF
bd20: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 46 53  lags & SQLITE_FS
bd30: 46 4c 41 47 53 5f 49 53 5f 4d 53 44 4f 53 29 21  FLAGS_IS_MSDOS)!
bd40: 3d 30 20 29 7b 0a 20 20 20 20 64 6f 7b 20 72 63  =0 ){.    do{ rc
bd50: 20 3d 20 6f 73 57 72 69 74 65 28 66 64 2c 20 22   = osWrite(fd, "
bd60: 53 22 2c 20 31 29 3b 20 7d 77 68 69 6c 65 28 20  S", 1); }while( 
bd70: 72 63 3c 30 20 26 26 20 65 72 72 6e 6f 3d 3d 45  rc<0 && errno==E
bd80: 49 4e 54 52 20 29 3b 0a 20 20 20 20 69 66 28 20  INTR );.    if( 
bd90: 72 63 21 3d 31 20 29 7b 0a 20 20 20 20 20 20 73  rc!=1 ){.      s
bda0: 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46  toreLastErrno(pF
bdb0: 69 6c 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20  ile, errno);.   
bdc0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
bdd0: 5f 49 4f 45 52 52 3b 0a 20 20 20 20 7d 0a 20 20  _IOERR;.    }.  
bde0: 20 20 72 63 20 3d 20 6f 73 46 73 74 61 74 28 66    rc = osFstat(f
bdf0: 64 2c 20 26 73 74 61 74 62 75 66 29 3b 0a 20 20  d, &statbuf);.  
be00: 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20    if( rc!=0 ){. 
be10: 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72       storeLastEr
be20: 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72 6e 6f  rno(pFile, errno
be30: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
be40: 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20 20  SQLITE_IOERR;.  
be50: 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a    }.  }.#endif..
be60: 20 20 6d 65 6d 73 65 74 28 26 66 69 6c 65 49 64    memset(&fileId
be70: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 66 69 6c 65  , 0, sizeof(file
be80: 49 64 29 29 3b 0a 20 20 66 69 6c 65 49 64 2e 64  Id));.  fileId.d
be90: 65 76 20 3d 20 73 74 61 74 62 75 66 2e 73 74 5f  ev = statbuf.st_
bea0: 64 65 76 3b 0a 23 69 66 20 4f 53 5f 56 58 57 4f  dev;.#if OS_VXWO
beb0: 52 4b 53 0a 20 20 66 69 6c 65 49 64 2e 70 49 64  RKS.  fileId.pId
bec0: 20 3d 20 70 46 69 6c 65 2d 3e 70 49 64 3b 0a 23   = pFile->pId;.#
bed0: 65 6c 73 65 0a 20 20 66 69 6c 65 49 64 2e 69 6e  else.  fileId.in
bee0: 6f 20 3d 20 28 75 36 34 29 73 74 61 74 62 75 66  o = (u64)statbuf
bef0: 2e 73 74 5f 69 6e 6f 3b 0a 23 65 6e 64 69 66 0a  .st_ino;.#endif.
bf00: 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d 75    assert( unixMu
bf10: 74 65 78 48 65 6c 64 28 29 20 29 3b 0a 20 20 70  texHeld() );.  p
bf20: 49 6e 6f 64 65 20 3d 20 69 6e 6f 64 65 4c 69 73  Inode = inodeLis
bf30: 74 3b 0a 20 20 77 68 69 6c 65 28 20 70 49 6e 6f  t;.  while( pIno
bf40: 64 65 20 26 26 20 6d 65 6d 63 6d 70 28 26 66 69  de && memcmp(&fi
bf50: 6c 65 49 64 2c 20 26 70 49 6e 6f 64 65 2d 3e 66  leId, &pInode->f
bf60: 69 6c 65 49 64 2c 20 73 69 7a 65 6f 66 28 66 69  ileId, sizeof(fi
bf70: 6c 65 49 64 29 29 20 29 7b 0a 20 20 20 20 70 49  leId)) ){.    pI
bf80: 6e 6f 64 65 20 3d 20 70 49 6e 6f 64 65 2d 3e 70  node = pInode->p
bf90: 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Next;.  }.  if( 
bfa0: 70 49 6e 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20  pInode==0 ){.   
bfb0: 20 70 49 6e 6f 64 65 20 3d 20 73 71 6c 69 74 65   pInode = sqlite
bfc0: 33 5f 6d 61 6c 6c 6f 63 36 34 28 20 73 69 7a 65  3_malloc64( size
bfd0: 6f 66 28 2a 70 49 6e 6f 64 65 29 20 29 3b 0a 20  of(*pInode) );. 
bfe0: 20 20 20 69 66 28 20 70 49 6e 6f 64 65 3d 3d 30     if( pInode==0
bff0: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
c000: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b   SQLITE_NOMEM_BK
c010: 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65  PT;.    }.    me
c020: 6d 73 65 74 28 70 49 6e 6f 64 65 2c 20 30 2c 20  mset(pInode, 0, 
c030: 73 69 7a 65 6f 66 28 2a 70 49 6e 6f 64 65 29 29  sizeof(*pInode))
c040: 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 70 49  ;.    memcpy(&pI
c050: 6e 6f 64 65 2d 3e 66 69 6c 65 49 64 2c 20 26 66  node->fileId, &f
c060: 69 6c 65 49 64 2c 20 73 69 7a 65 6f 66 28 66 69  ileId, sizeof(fi
c070: 6c 65 49 64 29 29 3b 0a 20 20 20 20 69 66 28 20  leId));.    if( 
c080: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
c090: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29  fig.bCoreMutex )
c0a0: 7b 0a 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e  {.      pInode->
c0b0: 70 4c 6f 63 6b 4d 75 74 65 78 20 3d 20 73 71 6c  pLockMutex = sql
c0c0: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63  ite3_mutex_alloc
c0d0: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46 41  (SQLITE_MUTEX_FA
c0e0: 53 54 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70  ST);.      if( p
c0f0: 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65  Inode->pLockMute
c100: 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  x==0 ){.        
c110: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 49 6e  sqlite3_free(pIn
c120: 6f 64 65 29 3b 0a 20 20 20 20 20 20 20 20 72 65  ode);.        re
c130: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  turn SQLITE_NOME
c140: 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 0a  M_BKPT;.      }.
c150: 20 20 20 20 7d 0a 20 20 20 20 70 49 6e 6f 64 65      }.    pInode
c160: 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20  ->nRef = 1;.    
c170: 61 73 73 65 72 74 28 20 75 6e 69 78 4d 75 74 65  assert( unixMute
c180: 78 48 65 6c 64 28 29 20 29 3b 0a 20 20 20 20 70  xHeld() );.    p
c190: 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 20 3d 20 69  Inode->pNext = i
c1a0: 6e 6f 64 65 4c 69 73 74 3b 0a 20 20 20 20 70 49  nodeList;.    pI
c1b0: 6e 6f 64 65 2d 3e 70 50 72 65 76 20 3d 20 30 3b  node->pPrev = 0;
c1c0: 0a 20 20 20 20 69 66 28 20 69 6e 6f 64 65 4c 69  .    if( inodeLi
c1d0: 73 74 20 29 20 69 6e 6f 64 65 4c 69 73 74 2d 3e  st ) inodeList->
c1e0: 70 50 72 65 76 20 3d 20 70 49 6e 6f 64 65 3b 0a  pPrev = pInode;.
c1f0: 20 20 20 20 69 6e 6f 64 65 4c 69 73 74 20 3d 20      inodeList = 
c200: 70 49 6e 6f 64 65 3b 0a 20 20 7d 65 6c 73 65 7b  pInode;.  }else{
c210: 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 52 65  .    pInode->nRe
c220: 66 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 70 49 6e  f++;.  }.  *ppIn
c230: 6f 64 65 20 3d 20 70 49 6e 6f 64 65 3b 0a 20 20  ode = pInode;.  
c240: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
c250: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
c260: 6e 20 54 52 55 45 20 69 66 20 70 46 69 6c 65 20  n TRUE if pFile 
c270: 68 61 73 20 62 65 65 6e 20 72 65 6e 61 6d 65 64  has been renamed
c280: 20 6f 72 20 75 6e 6c 69 6e 6b 65 64 20 73 69 6e   or unlinked sin
c290: 63 65 20 69 74 20 77 61 73 20 66 69 72 73 74 20  ce it was first 
c2a0: 6f 70 65 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69  opened..*/.stati
c2b0: 63 20 69 6e 74 20 66 69 6c 65 48 61 73 4d 6f 76  c int fileHasMov
c2c0: 65 64 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69  ed(unixFile *pFi
c2d0: 6c 65 29 7b 0a 23 69 66 20 4f 53 5f 56 58 57 4f  le){.#if OS_VXWO
c2e0: 52 4b 53 0a 20 20 72 65 74 75 72 6e 20 70 46 69  RKS.  return pFi
c2f0: 6c 65 2d 3e 70 49 6e 6f 64 65 21 3d 30 20 26 26  le->pInode!=0 &&
c300: 20 70 46 69 6c 65 2d 3e 70 49 64 21 3d 70 46 69   pFile->pId!=pFi
c310: 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 66 69 6c 65  le->pInode->file
c320: 49 64 2e 70 49 64 3b 0a 23 65 6c 73 65 0a 20 20  Id.pId;.#else.  
c330: 73 74 72 75 63 74 20 73 74 61 74 20 62 75 66 3b  struct stat buf;
c340: 0a 20 20 72 65 74 75 72 6e 20 70 46 69 6c 65 2d  .  return pFile-
c350: 3e 70 49 6e 6f 64 65 21 3d 30 20 26 26 0a 20 20  >pInode!=0 &&.  
c360: 20 20 20 20 28 6f 73 53 74 61 74 28 70 46 69 6c      (osStat(pFil
c370: 65 2d 3e 7a 50 61 74 68 2c 20 26 62 75 66 29 21  e->zPath, &buf)!
c380: 3d 30 20 0a 20 20 20 20 20 20 20 20 20 7c 7c 20  =0 .         || 
c390: 28 75 36 34 29 62 75 66 2e 73 74 5f 69 6e 6f 21  (u64)buf.st_ino!
c3a0: 3d 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e  =pFile->pInode->
c3b0: 66 69 6c 65 49 64 2e 69 6e 6f 29 3b 0a 23 65 6e  fileId.ino);.#en
c3c0: 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68  dif.}.../*.** Ch
c3d0: 65 63 6b 20 61 20 75 6e 69 78 46 69 6c 65 20 74  eck a unixFile t
c3e0: 68 61 74 20 69 73 20 61 20 64 61 74 61 62 61 73  hat is a databas
c3f0: 65 2e 20 20 56 65 72 69 66 79 20 74 68 65 20 66  e.  Verify the f
c400: 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20  ollowing:.**.** 
c410: 28 31 29 20 54 68 65 72 65 20 69 73 20 65 78 61  (1) There is exa
c420: 63 74 6c 79 20 6f 6e 65 20 68 61 72 64 20 6c 69  ctly one hard li
c430: 6e 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 0a 2a  nk on the file.*
c440: 2a 20 28 32 29 20 54 68 65 20 66 69 6c 65 20 69  * (2) The file i
c450: 73 20 6e 6f 74 20 61 20 73 79 6d 62 6f 6c 69 63  s not a symbolic
c460: 20 6c 69 6e 6b 0a 2a 2a 20 28 33 29 20 54 68 65   link.** (3) The
c470: 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 62 65   file has not be
c480: 65 6e 20 72 65 6e 61 6d 65 64 20 6f 72 20 75 6e  en renamed or un
c490: 6c 69 6e 6b 65 64 0a 2a 2a 0a 2a 2a 20 49 73 73  linked.**.** Iss
c4a0: 75 65 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53  ue sqlite3_log(S
c4b0: 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 2c 2e 2e  QLITE_WARNING,..
c4c0: 2e 29 20 6d 65 73 73 61 67 65 73 20 69 66 20 61  .) messages if a
c4d0: 6e 79 74 68 69 6e 67 20 69 73 20 6e 6f 74 20 72  nything is not r
c4e0: 69 67 68 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ight..*/.static 
c4f0: 76 6f 69 64 20 76 65 72 69 66 79 44 62 46 69 6c  void verifyDbFil
c500: 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c  e(unixFile *pFil
c510: 65 29 7b 0a 20 20 73 74 72 75 63 74 20 73 74 61  e){.  struct sta
c520: 74 20 62 75 66 3b 0a 20 20 69 6e 74 20 72 63 3b  t buf;.  int rc;
c530: 0a 0a 20 20 2f 2a 20 54 68 65 73 65 20 76 65 72  ..  /* These ver
c540: 69 66 69 63 61 74 69 6f 6e 73 20 6f 63 63 75 72  ifications occur
c550: 73 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 64  s for the main d
c560: 61 74 61 62 61 73 65 20 6f 6e 6c 79 20 2a 2f 0a  atabase only */.
c570: 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 63 74 72    if( pFile->ctr
c580: 6c 46 6c 61 67 73 20 26 20 55 4e 49 58 46 49 4c  lFlags & UNIXFIL
c590: 45 5f 4e 4f 4c 4f 43 4b 20 29 20 72 65 74 75 72  E_NOLOCK ) retur
c5a0: 6e 3b 0a 0a 20 20 72 63 20 3d 20 6f 73 46 73 74  n;..  rc = osFst
c5b0: 61 74 28 70 46 69 6c 65 2d 3e 68 2c 20 26 62 75  at(pFile->h, &bu
c5c0: 66 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 30 20  f);.  if( rc!=0 
c5d0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c  ){.    sqlite3_l
c5e0: 6f 67 28 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e  og(SQLITE_WARNIN
c5f0: 47 2c 20 22 63 61 6e 6e 6f 74 20 66 73 74 61 74  G, "cannot fstat
c600: 20 64 62 20 66 69 6c 65 20 25 73 22 2c 20 70 46   db file %s", pF
c610: 69 6c 65 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 20  ile->zPath);.   
c620: 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69   return;.  }.  i
c630: 66 28 20 62 75 66 2e 73 74 5f 6e 6c 69 6e 6b 3d  f( buf.st_nlink=
c640: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  =0 ){.    sqlite
c650: 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 57 41 52  3_log(SQLITE_WAR
c660: 4e 49 4e 47 2c 20 22 66 69 6c 65 20 75 6e 6c 69  NING, "file unli
c670: 6e 6b 65 64 20 77 68 69 6c 65 20 6f 70 65 6e 3a  nked while open:
c680: 20 25 73 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61   %s", pFile->zPa
c690: 74 68 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b  th);.    return;
c6a0: 0a 20 20 7d 0a 20 20 69 66 28 20 62 75 66 2e 73  .  }.  if( buf.s
c6b0: 74 5f 6e 6c 69 6e 6b 3e 31 20 29 7b 0a 20 20 20  t_nlink>1 ){.   
c6c0: 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c   sqlite3_log(SQL
c6d0: 49 54 45 5f 57 41 52 4e 49 4e 47 2c 20 22 6d 75  ITE_WARNING, "mu
c6e0: 6c 74 69 70 6c 65 20 6c 69 6e 6b 73 20 74 6f 20  ltiple links to 
c6f0: 66 69 6c 65 3a 20 25 73 22 2c 20 70 46 69 6c 65  file: %s", pFile
c700: 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 20 20 72 65  ->zPath);.    re
c710: 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20  turn;.  }.  if( 
c720: 66 69 6c 65 48 61 73 4d 6f 76 65 64 28 70 46 69  fileHasMoved(pFi
c730: 6c 65 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  le) ){.    sqlit
c740: 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 57 41  e3_log(SQLITE_WA
c750: 52 4e 49 4e 47 2c 20 22 66 69 6c 65 20 72 65 6e  RNING, "file ren
c760: 61 6d 65 64 20 77 68 69 6c 65 20 6f 70 65 6e 3a  amed while open:
c770: 20 25 73 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61   %s", pFile->zPa
c780: 74 68 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b  th);.    return;
c790: 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54  .  }.}.../*.** T
c7a0: 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68 65 63  his routine chec
c7b0: 6b 73 20 69 66 20 74 68 65 72 65 20 69 73 20 61  ks if there is a
c7c0: 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 68   RESERVED lock h
c7d0: 65 6c 64 20 6f 6e 20 74 68 65 20 73 70 65 63 69  eld on the speci
c7e0: 66 69 65 64 0a 2a 2a 20 66 69 6c 65 20 62 79 20  fied.** file by 
c7f0: 74 68 69 73 20 6f 72 20 61 6e 79 20 6f 74 68 65  this or any othe
c800: 72 20 70 72 6f 63 65 73 73 2e 20 49 66 20 73 75  r process. If su
c810: 63 68 20 61 20 6c 6f 63 6b 20 69 73 20 68 65 6c  ch a lock is hel
c820: 64 2c 20 73 65 74 20 2a 70 52 65 73 4f 75 74 0a  d, set *pResOut.
c830: 2a 2a 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f  ** to a non-zero
c840: 20 76 61 6c 75 65 20 6f 74 68 65 72 77 69 73 65   value otherwise
c850: 20 2a 70 52 65 73 4f 75 74 20 69 73 20 73 65 74   *pResOut is set
c860: 20 74 6f 20 7a 65 72 6f 2e 20 20 54 68 65 20 72   to zero.  The r
c870: 65 74 75 72 6e 20 76 61 6c 75 65 0a 2a 2a 20 69  eturn value.** i
c880: 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f  s set to SQLITE_
c890: 4f 4b 20 75 6e 6c 65 73 73 20 61 6e 20 49 2f 4f  OK unless an I/O
c8a0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75   error occurs du
c8b0: 72 69 6e 67 20 6c 6f 63 6b 20 63 68 65 63 6b 69  ring lock checki
c8c0: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ng..*/.static in
c8d0: 74 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72  t unixCheckReser
c8e0: 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f  vedLock(sqlite3_
c8f0: 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70  file *id, int *p
c900: 52 65 73 4f 75 74 29 7b 0a 20 20 69 6e 74 20 72  ResOut){.  int r
c910: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
c920: 20 69 6e 74 20 72 65 73 65 72 76 65 64 20 3d 20   int reserved = 
c930: 30 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70  0;.  unixFile *p
c940: 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65  File = (unixFile
c950: 2a 29 69 64 3b 0a 0a 20 20 53 69 6d 75 6c 61 74  *)id;..  Simulat
c960: 65 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e  eIOError( return
c970: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48   SQLITE_IOERR_CH
c980: 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b  ECKRESERVEDLOCK;
c990: 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70   );..  assert( p
c9a0: 46 69 6c 65 20 29 3b 0a 20 20 61 73 73 65 72 74  File );.  assert
c9b0: 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f  ( pFile->eFileLo
c9c0: 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20  ck<=SHARED_LOCK 
c9d0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  );.  sqlite3_mut
c9e0: 65 78 5f 65 6e 74 65 72 28 70 46 69 6c 65 2d 3e  ex_enter(pFile->
c9f0: 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74  pInode->pLockMut
ca00: 65 78 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b  ex);..  /* Check
ca10: 20 69 66 20 61 20 74 68 72 65 61 64 20 69 6e 20   if a thread in 
ca20: 74 68 69 73 20 70 72 6f 63 65 73 73 20 68 6f 6c  this process hol
ca30: 64 73 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 2a  ds such a lock *
ca40: 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 70  /.  if( pFile->p
ca50: 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b  Inode->eFileLock
ca60: 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a  >SHARED_LOCK ){.
ca70: 20 20 20 20 72 65 73 65 72 76 65 64 20 3d 20 31      reserved = 1
ca80: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 74 68 65  ;.  }..  /* Othe
ca90: 72 77 69 73 65 20 73 65 65 20 69 66 20 73 6f 6d  rwise see if som
caa0: 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20  e other process 
cab0: 68 6f 6c 64 73 20 69 74 2e 0a 20 20 2a 2f 0a 23  holds it..  */.#
cac0: 69 66 6e 64 65 66 20 5f 5f 44 4a 47 50 50 5f 5f  ifndef __DJGPP__
cad0: 0a 20 20 69 66 28 20 21 72 65 73 65 72 76 65 64  .  if( !reserved
cae0: 20 26 26 20 21 70 46 69 6c 65 2d 3e 70 49 6e 6f   && !pFile->pIno
caf0: 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b  de->bProcessLock
cb00: 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 66   ){.    struct f
cb10: 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 20 20 6c  lock lock;.    l
cb20: 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53  ock.l_whence = S
cb30: 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f 63  EEK_SET;.    loc
cb40: 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 52 45 53 45  k.l_start = RESE
cb50: 52 56 45 44 5f 42 59 54 45 3b 0a 20 20 20 20 6c  RVED_BYTE;.    l
cb60: 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 31 3b 0a 20  ock.l_len = 1;. 
cb70: 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d     lock.l_type =
cb80: 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 69 66   F_WRLCK;.    if
cb90: 28 20 6f 73 46 63 6e 74 6c 28 70 46 69 6c 65 2d  ( osFcntl(pFile-
cba0: 3e 68 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f  >h, F_GETLK, &lo
cbb0: 63 6b 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ck) ){.      rc 
cbc0: 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43  = SQLITE_IOERR_C
cbd0: 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b  HECKRESERVEDLOCK
cbe0: 3b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73  ;.      storeLas
cbf0: 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72  tErrno(pFile, er
cc00: 72 6e 6f 29 3b 0a 20 20 20 20 7d 20 65 6c 73 65  rno);.    } else
cc10: 20 69 66 28 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65   if( lock.l_type
cc20: 21 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20  !=F_UNLCK ){.   
cc30: 20 20 20 72 65 73 65 72 76 65 64 20 3d 20 31 3b     reserved = 1;
cc40: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
cc50: 66 0a 20 20 0a 20 20 73 71 6c 69 74 65 33 5f 6d  f.  .  sqlite3_m
cc60: 75 74 65 78 5f 6c 65 61 76 65 28 70 46 69 6c 65  utex_leave(pFile
cc70: 2d 3e 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d  ->pInode->pLockM
cc80: 75 74 65 78 29 3b 0a 20 20 4f 53 54 52 41 43 45  utex);.  OSTRACE
cc90: 28 28 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20  (("TEST WR-LOCK 
cca0: 25 64 20 25 64 20 25 64 20 28 75 6e 69 78 29 5c  %d %d %d (unix)\
ccb0: 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 72 63  n", pFile->h, rc
ccc0: 2c 20 72 65 73 65 72 76 65 64 29 29 3b 0a 0a 20  , reserved));.. 
ccd0: 20 2a 70 52 65 73 4f 75 74 20 3d 20 72 65 73 65   *pResOut = rese
cce0: 72 76 65 64 3b 0a 20 20 72 65 74 75 72 6e 20 72  rved;.  return r
ccf0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20  c;.}../*.** Set 
cd00: 61 20 70 6f 73 69 78 2d 61 64 76 69 73 6f 72 79  a posix-advisory
cd10: 2d 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  -lock..**.** The
cd20: 72 65 20 61 72 65 20 74 77 6f 20 76 65 72 73 69  re are two versi
cd30: 6f 6e 73 20 6f 66 20 74 68 69 73 20 72 6f 75 74  ons of this rout
cd40: 69 6e 65 2e 20 20 49 66 20 63 6f 6d 70 69 6c 65  ine.  If compile
cd50: 64 20 77 69 74 68 0a 2a 2a 20 53 51 4c 49 54 45  d with.** SQLITE
cd60: 5f 45 4e 41 42 4c 45 5f 53 45 54 4c 4b 5f 54 49  _ENABLE_SETLK_TI
cd70: 4d 45 4f 55 54 20 74 68 65 6e 20 74 68 65 20 72  MEOUT then the r
cd80: 6f 75 74 69 6e 65 20 68 61 73 20 61 6e 20 65 78  outine has an ex
cd90: 74 72 61 20 70 61 72 61 6d 65 74 65 72 0a 2a 2a  tra parameter.**
cda0: 20 77 68 69 63 68 20 69 73 20 61 20 70 6f 69 6e   which is a poin
cdb0: 74 65 72 20 74 6f 20 61 20 75 6e 69 78 46 69 6c  ter to a unixFil
cdc0: 65 2e 20 20 49 66 20 74 68 65 20 75 6e 69 78 46  e.  If the unixF
cdd0: 69 6c 65 2d 3e 69 42 75 73 79 54 69 6d 65 6f 75  ile->iBusyTimeou
cde0: 74 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 73 65  t.** value is se
cdf0: 74 2c 20 74 68 65 6e 20 69 74 20 69 73 20 74 68  t, then it is th
ce00: 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 6c 6c  e number of mill
ce10: 69 73 65 63 6f 6e 64 73 20 74 6f 20 77 61 69 74  iseconds to wait
ce20: 20 62 65 66 6f 72 65 0a 2a 2a 20 66 61 69 6c 69   before.** faili
ce30: 6e 67 20 74 68 65 20 6c 6f 63 6b 2e 20 20 54 68  ng the lock.  Th
ce40: 65 20 69 42 75 73 79 54 69 6d 65 6f 75 74 20 76  e iBusyTimeout v
ce50: 61 6c 75 65 20 69 73 20 61 6c 77 61 79 73 20 72  alue is always r
ce60: 65 73 65 74 20 62 61 63 6b 20 74 6f 0a 2a 2a 20  eset back to.** 
ce70: 7a 65 72 6f 20 6f 6e 20 65 61 63 68 20 63 61 6c  zero on each cal
ce80: 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49  l..**.** If SQLI
ce90: 54 45 5f 45 4e 41 42 4c 45 5f 53 45 54 4c 4b 5f  TE_ENABLE_SETLK_
cea0: 54 49 4d 45 4f 55 54 20 69 73 20 6e 6f 74 20 64  TIMEOUT is not d
ceb0: 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 64 6f 20  efined, then do 
cec0: 61 20 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 0a 2a  a non-blocking.*
ced0: 2a 20 61 74 74 65 6d 70 74 20 74 6f 20 73 65 74  * attempt to set
cee0: 20 74 68 65 20 6c 6f 63 6b 2e 0a 2a 2f 0a 23 69   the lock..*/.#i
cef0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  fndef SQLITE_ENA
cf00: 42 4c 45 5f 53 45 54 4c 4b 5f 54 49 4d 45 4f 55  BLE_SETLK_TIMEOU
cf10: 54 0a 23 20 64 65 66 69 6e 65 20 6f 73 53 65 74  T.# define osSet
cf20: 50 6f 73 69 78 41 64 76 69 73 6f 72 79 4c 6f 63  PosixAdvisoryLoc
cf30: 6b 28 68 2c 78 2c 74 29 20 6f 73 46 63 6e 74 6c  k(h,x,t) osFcntl
cf40: 28 68 2c 46 5f 53 45 54 4c 4b 2c 78 29 0a 23 65  (h,F_SETLK,x).#e
cf50: 6c 73 65 0a 73 74 61 74 69 63 20 69 6e 74 20 6f  lse.static int o
cf60: 73 53 65 74 50 6f 73 69 78 41 64 76 69 73 6f 72  sSetPosixAdvisor
cf70: 79 4c 6f 63 6b 28 0a 20 20 69 6e 74 20 68 2c 20  yLock(.  int h, 
cf80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
cf90: 2a 20 54 68 65 20 66 69 6c 65 20 64 65 73 63 72  * The file descr
cfa0: 69 70 74 6f 72 20 6f 6e 20 77 68 69 63 68 20 74  iptor on which t
cfb0: 6f 20 74 61 6b 65 20 74 68 65 20 6c 6f 63 6b 20  o take the lock 
cfc0: 2a 2f 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63  */.  struct floc
cfd0: 6b 20 2a 70 4c 6f 63 6b 2c 20 20 2f 2a 20 54 68  k *pLock,  /* Th
cfe0: 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  e description of
cff0: 20 74 68 65 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75   the lock */.  u
d000: 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 20  nixFile *pFile  
d010: 20 20 20 20 20 2f 2a 20 53 74 72 75 63 74 75 72       /* Structur
d020: 65 20 68 6f 6c 64 69 6e 67 20 74 69 6d 65 6f 75  e holding timeou
d030: 74 20 76 61 6c 75 65 20 2a 2f 0a 29 7b 0a 20 20  t value */.){.  
d040: 69 6e 74 20 72 63 20 3d 20 6f 73 46 63 6e 74 6c  int rc = osFcntl
d050: 28 68 2c 46 5f 53 45 54 4c 4b 2c 70 4c 6f 63 6b  (h,F_SETLK,pLock
d060: 29 3b 0a 20 20 77 68 69 6c 65 28 20 72 63 3c 30  );.  while( rc<0
d070: 20 26 26 20 70 46 69 6c 65 2d 3e 69 42 75 73 79   && pFile->iBusy
d080: 54 69 6d 65 6f 75 74 3e 30 20 29 7b 0a 20 20 20  Timeout>0 ){.   
d090: 20 2f 2a 20 4f 6e 20 73 79 73 74 65 6d 73 20 74   /* On systems t
d0a0: 68 61 74 20 73 75 70 70 6f 72 74 20 73 6f 6d 65  hat support some
d0b0: 20 6b 69 6e 64 20 6f 66 20 62 6c 6f 63 6b 69 6e   kind of blockin
d0c0: 67 20 66 69 6c 65 20 6c 6f 63 6b 20 77 69 74 68  g file lock with
d0d0: 20 61 20 74 69 6d 65 6f 75 74 2c 0a 20 20 20 20   a timeout,.    
d0e0: 2a 2a 20 6d 61 6b 65 20 61 70 70 72 6f 70 72 69  ** make appropri
d0f0: 61 74 65 20 63 68 61 6e 67 65 73 20 68 65 72 65  ate changes here
d100: 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 61 74 20   to invoke that 
d110: 62 6c 6f 63 6b 69 6e 67 20 66 69 6c 65 20 6c 6f  blocking file lo
d120: 63 6b 2e 20 20 4f 6e 0a 20 20 20 20 2a 2a 20 67  ck.  On.    ** g
d130: 65 6e 65 72 69 63 20 70 6f 73 69 78 2c 20 68 6f  eneric posix, ho
d140: 77 65 76 65 72 2c 20 74 68 65 72 65 20 69 73 20  wever, there is 
d150: 6e 6f 20 73 75 63 68 20 41 50 49 2e 20 20 53 6f  no such API.  So
d160: 20 77 65 20 73 69 6d 70 6c 79 20 74 72 79 20 74   we simply try t
d170: 68 65 0a 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 6f  he.    ** lock o
d180: 6e 63 65 20 65 76 65 72 79 20 6d 69 6c 6c 69 73  nce every millis
d190: 65 63 6f 6e 64 20 75 6e 74 69 6c 20 65 69 74 68  econd until eith
d1a0: 65 72 20 74 68 65 20 74 69 6d 65 6f 75 74 20 65  er the timeout e
d1b0: 78 70 69 72 65 73 2c 20 6f 72 20 75 6e 74 69 6c  xpires, or until
d1c0: 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b  .    ** the lock
d1d0: 20 69 73 20 6f 62 74 61 69 6e 65 64 2e 20 2a 2f   is obtained. */
d1e0: 0a 20 20 20 20 75 73 6c 65 65 70 28 31 30 30 30  .    usleep(1000
d1f0: 29 3b 0a 20 20 20 20 72 63 20 3d 20 6f 73 46 63  );.    rc = osFc
d200: 6e 74 6c 28 68 2c 46 5f 53 45 54 4c 4b 2c 70 4c  ntl(h,F_SETLK,pL
d210: 6f 63 6b 29 3b 0a 20 20 20 20 70 46 69 6c 65 2d  ock);.    pFile-
d220: 3e 69 42 75 73 79 54 69 6d 65 6f 75 74 2d 2d 3b  >iBusyTimeout--;
d230: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
d240: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
d250: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 45 54 4c  LITE_ENABLE_SETL
d260: 4b 5f 54 49 4d 45 4f 55 54 20 2a 2f 0a 0a 0a 2f  K_TIMEOUT */.../
d270: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
d280: 73 65 74 20 61 20 73 79 73 74 65 6d 2d 6c 6f 63  set a system-loc
d290: 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 70 46  k on the file pF
d2a0: 69 6c 65 2e 20 20 54 68 65 20 6c 6f 63 6b 20 69  ile.  The lock i
d2b0: 73 20 0a 2a 2a 20 64 65 73 63 72 69 62 65 64 20  s .** described 
d2c0: 62 79 20 70 4c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20  by pLock..**.** 
d2d0: 49 66 20 74 68 65 20 70 46 69 6c 65 20 77 61 73  If the pFile was
d2e0: 20 6f 70 65 6e 65 64 20 72 65 61 64 2f 77 72 69   opened read/wri
d2f0: 74 65 20 66 72 6f 6d 20 75 6e 69 78 2d 65 78 63  te from unix-exc
d300: 6c 2c 20 74 68 65 6e 20 74 68 65 20 6f 6e 6c 79  l, then the only
d310: 20 6c 6f 63 6b 0a 2a 2a 20 65 76 65 72 20 6f 62   lock.** ever ob
d320: 74 61 69 6e 65 64 20 69 73 20 61 6e 20 65 78 63  tained is an exc
d330: 6c 75 73 69 76 65 20 6c 6f 63 6b 2c 20 61 6e 64  lusive lock, and
d340: 20 69 74 20 69 73 20 6f 62 74 61 69 6e 65 64 20   it is obtained 
d350: 65 78 61 63 74 6c 79 20 6f 6e 63 65 0a 2a 2a 20  exactly once.** 
d360: 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 61  the first time a
d370: 6e 79 20 6c 6f 63 6b 20 69 73 20 61 74 74 65 6d  ny lock is attem
d380: 70 74 65 64 2e 20 20 41 6c 6c 20 73 75 62 73 65  pted.  All subse
d390: 71 75 65 6e 74 20 73 79 73 74 65 6d 20 6c 6f 63  quent system loc
d3a0: 6b 69 6e 67 0a 2a 2a 20 6f 70 65 72 61 74 69 6f  king.** operatio
d3b0: 6e 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f 70 73  ns become no-ops
d3c0: 2e 20 20 4c 6f 63 6b 69 6e 67 20 6f 70 65 72 61  .  Locking opera
d3d0: 74 69 6f 6e 73 20 73 74 69 6c 6c 20 68 61 70 70  tions still happ
d3e0: 65 6e 20 69 6e 74 65 72 6e 61 6c 6c 79 2c 0a 2a  en internally,.*
d3f0: 2a 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 6f  * in order to co
d400: 6f 72 64 69 6e 61 74 65 20 61 63 63 65 73 73 20  ordinate access 
d410: 62 65 74 77 65 65 6e 20 73 65 70 61 72 61 74 65  between separate
d420: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
d430: 74 69 6f 6e 73 0a 2a 2a 20 77 69 74 68 69 6e 20  tions.** within 
d440: 74 68 69 73 20 70 72 6f 63 65 73 73 2c 20 62 75  this process, bu
d450: 74 20 61 6c 6c 20 6f 66 20 74 68 61 74 20 69 73  t all of that is
d460: 20 68 61 6e 64 6c 65 64 20 69 6e 20 6d 65 6d 6f   handled in memo
d470: 72 79 20 61 6e 64 20 74 68 65 0a 2a 2a 20 6f 70  ry and the.** op
d480: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 64  erating system d
d490: 6f 65 73 20 6e 6f 74 20 70 61 72 74 69 63 69 70  oes not particip
d4a0: 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ate..**.** This 
d4b0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 70 61  function is a pa
d4c0: 73 73 2d 74 68 72 6f 75 67 68 20 74 6f 20 66 63  ss-through to fc
d4d0: 6e 74 6c 28 46 5f 53 45 54 4c 4b 29 20 69 66 20  ntl(F_SETLK) if 
d4e0: 70 46 69 6c 65 20 69 73 20 75 73 69 6e 67 0a 2a  pFile is using.*
d4f0: 2a 20 61 6e 79 20 56 46 53 20 6f 74 68 65 72 20  * any VFS other 
d500: 74 68 61 6e 20 22 75 6e 69 78 2d 65 78 63 6c 22  than "unix-excl"
d510: 20 6f 72 20 69 66 20 70 46 69 6c 65 20 69 73 20   or if pFile is 
d520: 6f 70 65 6e 65 64 20 6f 6e 20 22 75 6e 69 78 2d  opened on "unix-
d530: 65 78 63 6c 22 0a 2a 2a 20 61 6e 64 20 69 73 20  excl".** and is 
d540: 72 65 61 64 2d 6f 6e 6c 79 2e 0a 2a 2a 0a 2a 2a  read-only..**.**
d550: 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72 6e 65   Zero is returne
d560: 64 20 69 66 20 74 68 65 20 63 61 6c 6c 20 63 6f  d if the call co
d570: 6d 70 6c 65 74 65 73 20 73 75 63 63 65 73 73 66  mpletes successf
d580: 75 6c 6c 79 2c 20 6f 72 20 2d 31 20 69 66 20 61  ully, or -1 if a
d590: 20 63 61 6c 6c 0a 2a 2a 20 74 6f 20 66 63 6e 74   call.** to fcnt
d5a0: 6c 28 29 20 66 61 69 6c 73 2e 20 49 6e 20 74 68  l() fails. In th
d5b0: 69 73 20 63 61 73 65 2c 20 65 72 72 6e 6f 20 69  is case, errno i
d5c0: 73 20 73 65 74 20 61 70 70 72 6f 70 72 69 61 74  s set appropriat
d5d0: 65 6c 79 20 28 62 79 20 66 63 6e 74 6c 28 29 29  ely (by fcntl())
d5e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
d5f0: 75 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 75 6e 69  unixFileLock(uni
d600: 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 73 74  xFile *pFile, st
d610: 72 75 63 74 20 66 6c 6f 63 6b 20 2a 70 4c 6f 63  ruct flock *pLoc
d620: 6b 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  k){.  int rc;.  
d630: 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70  unixInodeInfo *p
d640: 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70  Inode = pFile->p
d650: 49 6e 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 28  Inode;.  assert(
d660: 20 70 49 6e 6f 64 65 21 3d 30 20 29 3b 0a 20 20   pInode!=0 );.  
d670: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
d680: 6d 75 74 65 78 5f 68 65 6c 64 28 70 49 6e 6f 64  mutex_held(pInod
d690: 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 20 29  e->pLockMutex) )
d6a0: 3b 0a 20 20 69 66 28 20 28 70 46 69 6c 65 2d 3e  ;.  if( (pFile->
d6b0: 63 74 72 6c 46 6c 61 67 73 20 26 20 28 55 4e 49  ctrlFlags & (UNI
d6c0: 58 46 49 4c 45 5f 45 58 43 4c 7c 55 4e 49 58 46  XFILE_EXCL|UNIXF
d6d0: 49 4c 45 5f 52 44 4f 4e 4c 59 29 29 3d 3d 55 4e  ILE_RDONLY))==UN
d6e0: 49 58 46 49 4c 45 5f 45 58 43 4c 20 29 7b 0a 20  IXFILE_EXCL ){. 
d6f0: 20 20 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 62     if( pInode->b
d700: 50 72 6f 63 65 73 73 4c 6f 63 6b 3d 3d 30 20 29  ProcessLock==0 )
d710: 7b 0a 20 20 20 20 20 20 73 74 72 75 63 74 20 66  {.      struct f
d720: 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 20 20 20  lock lock;.     
d730: 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 65 2d   assert( pInode-
d740: 3e 6e 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20 20 20  >nLock==0 );.   
d750: 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65     lock.l_whence
d760: 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20   = SEEK_SET;.   
d770: 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20     lock.l_start 
d780: 3d 20 53 48 41 52 45 44 5f 46 49 52 53 54 3b 0a  = SHARED_FIRST;.
d790: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e        lock.l_len
d7a0: 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45 3b 0a   = SHARED_SIZE;.
d7b0: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70        lock.l_typ
d7c0: 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 20  e = F_WRLCK;.   
d7d0: 20 20 20 72 63 20 3d 20 6f 73 53 65 74 50 6f 73     rc = osSetPos
d7e0: 69 78 41 64 76 69 73 6f 72 79 4c 6f 63 6b 28 70  ixAdvisoryLock(p
d7f0: 46 69 6c 65 2d 3e 68 2c 20 26 6c 6f 63 6b 2c 20  File->h, &lock, 
d800: 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 69 66  pFile);.      if
d810: 28 20 72 63 3c 30 20 29 20 72 65 74 75 72 6e 20  ( rc<0 ) return 
d820: 72 63 3b 0a 20 20 20 20 20 20 70 49 6e 6f 64 65  rc;.      pInode
d830: 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b 20 3d  ->bProcessLock =
d840: 20 31 3b 0a 20 20 20 20 20 20 70 49 6e 6f 64 65   1;.      pInode
d850: 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a 20 20 20 20 7d  ->nLock++;.    }
d860: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d  else{.      rc =
d870: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73   0;.    }.  }els
d880: 65 7b 0a 20 20 20 20 72 63 20 3d 20 6f 73 53 65  e{.    rc = osSe
d890: 74 50 6f 73 69 78 41 64 76 69 73 6f 72 79 4c 6f  tPosixAdvisoryLo
d8a0: 63 6b 28 70 46 69 6c 65 2d 3e 68 2c 20 70 4c 6f  ck(pFile->h, pLo
d8b0: 63 6b 2c 20 70 46 69 6c 65 29 3b 0a 20 20 7d 0a  ck, pFile);.  }.
d8c0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
d8d0: 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 20 66  /*.** Lock the f
d8e0: 69 6c 65 20 77 69 74 68 20 74 68 65 20 6c 6f 63  ile with the loc
d8f0: 6b 20 73 70 65 63 69 66 69 65 64 20 62 79 20 70  k specified by p
d900: 61 72 61 6d 65 74 65 72 20 65 46 69 6c 65 4c 6f  arameter eFileLo
d910: 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74  ck - one.** of t
d920: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a  he following:.**
d930: 0a 2a 2a 20 20 20 20 20 28 31 29 20 53 48 41 52  .**     (1) SHAR
d940: 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28  ED_LOCK.**     (
d950: 32 29 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b  2) RESERVED_LOCK
d960: 0a 2a 2a 20 20 20 20 20 28 33 29 20 50 45 4e 44  .**     (3) PEND
d970: 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20  ING_LOCK.**     
d980: 28 34 29 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f  (4) EXCLUSIVE_LO
d990: 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d  CK.**.** Sometim
d9a0: 65 73 20 77 68 65 6e 20 72 65 71 75 65 73 74 69  es when requesti
d9b0: 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 74  ng one lock stat
d9c0: 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f  e, additional lo
d9d0: 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20 61 72 65  ck states.** are
d9e0: 20 69 6e 73 65 72 74 65 64 20 69 6e 20 62 65 74   inserted in bet
d9f0: 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f 63 6b 69  ween.  The locki
da00: 6e 67 20 6d 69 67 68 74 20 66 61 69 6c 20 6f 6e  ng might fail on
da10: 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 61 74 65   one of the late
da20: 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73  r.** transitions
da30: 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 6f 63   leaving the loc
da40: 6b 20 73 74 61 74 65 20 64 69 66 66 65 72 65 6e  k state differen
da50: 74 20 66 72 6f 6d 20 77 68 61 74 20 69 74 20 73  t from what it s
da60: 74 61 72 74 65 64 20 62 75 74 0a 2a 2a 20 73 74  tarted but.** st
da70: 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20 69 74 73  ill short of its
da80: 20 67 6f 61 6c 2e 20 20 54 68 65 20 66 6f 6c 6c   goal.  The foll
da90: 6f 77 69 6e 67 20 63 68 61 72 74 20 73 68 6f 77  owing chart show
daa0: 73 20 74 68 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a  s the allowed.**
dab0: 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64   transitions and
dac0: 20 74 68 65 20 69 6e 73 65 72 74 65 64 20 69 6e   the inserted in
dad0: 74 65 72 6d 65 64 69 61 74 65 20 73 74 61 74 65  termediate state
dae0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f  s:.**.**    UNLO
daf0: 43 4b 45 44 20 2d 3e 20 53 48 41 52 45 44 0a 2a  CKED -> SHARED.*
db00: 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 52  *    SHARED -> R
db10: 45 53 45 52 56 45 44 0a 2a 2a 20 20 20 20 53 48  ESERVED.**    SH
db20: 41 52 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47  ARED -> (PENDING
db30: 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a  ) -> EXCLUSIVE.*
db40: 2a 20 20 20 20 52 45 53 45 52 56 45 44 20 2d 3e  *    RESERVED ->
db50: 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58   (PENDING) -> EX
db60: 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 50 45  CLUSIVE.**    PE
db70: 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c 55 53 49  NDING -> EXCLUSI
db80: 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  VE.**.** This ro
db90: 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 20  utine will only 
dba0: 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 6b 2e  increase a lock.
dbb0: 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 74 65    Use the sqlite
dbc0: 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72  3OsUnlock().** r
dbd0: 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 20  outine to lower 
dbe0: 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2e  a locking level.
dbf0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
dc00: 6e 69 78 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f  nixLock(sqlite3_
dc10: 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65 46  file *id, int eF
dc20: 69 6c 65 4c 6f 63 6b 29 7b 0a 20 20 2f 2a 20 54  ileLock){.  /* T
dc30: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 64 65 73  he following des
dc40: 63 72 69 62 65 73 20 74 68 65 20 69 6d 70 6c 65  cribes the imple
dc50: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
dc60: 20 76 61 72 69 6f 75 73 20 6c 6f 63 6b 73 20 61   various locks a
dc70: 6e 64 0a 20 20 2a 2a 20 6c 6f 63 6b 20 74 72 61  nd.  ** lock tra
dc80: 6e 73 69 74 69 6f 6e 73 20 69 6e 20 74 65 72 6d  nsitions in term
dc90: 73 20 6f 66 20 74 68 65 20 50 4f 53 49 58 20 61  s of the POSIX a
dca0: 64 76 69 73 6f 72 79 20 73 68 61 72 65 64 20 61  dvisory shared a
dcb0: 6e 64 20 65 78 63 6c 75 73 69 76 65 0a 20 20 2a  nd exclusive.  *
dcc0: 2a 20 6c 6f 63 6b 20 70 72 69 6d 69 74 69 76 65  * lock primitive
dcd0: 73 20 28 63 61 6c 6c 65 64 20 72 65 61 64 2d 6c  s (called read-l
dce0: 6f 63 6b 73 20 61 6e 64 20 77 72 69 74 65 2d 6c  ocks and write-l
dcf0: 6f 63 6b 73 20 62 65 6c 6f 77 2c 20 74 6f 20 61  ocks below, to a
dd00: 76 6f 69 64 0a 20 20 2a 2a 20 63 6f 6e 66 75 73  void.  ** confus
dd10: 69 6f 6e 20 77 69 74 68 20 53 51 4c 69 74 65 20  ion with SQLite 
dd20: 6c 6f 63 6b 20 6e 61 6d 65 73 29 2e 20 54 68 65  lock names). The
dd30: 20 61 6c 67 6f 72 69 74 68 6d 73 20 61 72 65 20   algorithms are 
dd40: 63 6f 6d 70 6c 69 63 61 74 65 64 0a 20 20 2a 2a  complicated.  **
dd50: 20 73 6c 69 67 68 74 6c 79 20 69 6e 20 6f 72 64   slightly in ord
dd60: 65 72 20 74 6f 20 62 65 20 63 6f 6d 70 61 74 69  er to be compati
dd70: 62 6c 65 20 77 69 74 68 20 57 69 6e 64 6f 77 73  ble with Windows
dd80: 39 35 20 73 79 73 74 65 6d 73 20 73 69 6d 75 6c  95 systems simul
dd90: 74 61 6e 65 6f 75 73 6c 79 0a 20 20 2a 2a 20 61  taneously.  ** a
dda0: 63 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d  ccessing the sam
ddb0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
ddc0: 20 69 6e 20 63 61 73 65 20 74 68 61 74 20 69 73   in case that is
ddd0: 20 65 76 65 72 20 72 65 71 75 69 72 65 64 2e 0a   ever required..
dde0: 20 20 2a 2a 0a 20 20 2a 2a 20 53 79 6d 62 6f 6c    **.  ** Symbol
ddf0: 73 20 64 65 66 69 6e 65 64 20 69 6e 20 6f 73 2e  s defined in os.
de00: 68 20 69 6e 64 65 6e 74 69 66 79 20 74 68 65 20  h indentify the 
de10: 27 70 65 6e 64 69 6e 67 20 62 79 74 65 27 20 61  'pending byte' a
de20: 6e 64 20 74 68 65 20 27 72 65 73 65 72 76 65 64  nd the 'reserved
de30: 0a 20 20 2a 2a 20 62 79 74 65 27 2c 20 65 61 63  .  ** byte', eac
de40: 68 20 73 69 6e 67 6c 65 20 62 79 74 65 73 20 61  h single bytes a
de50: 74 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66  t well known off
de60: 73 65 74 73 2c 20 61 6e 64 20 74 68 65 20 27 73  sets, and the 's
de70: 68 61 72 65 64 20 62 79 74 65 0a 20 20 2a 2a 20  hared byte.  ** 
de80: 72 61 6e 67 65 27 2c 20 61 20 72 61 6e 67 65 20  range', a range 
de90: 6f 66 20 35 31 30 20 62 79 74 65 73 20 61 74 20  of 510 bytes at 
dea0: 61 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66  a well known off
deb0: 73 65 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54  set..  **.  ** T
dec0: 6f 20 6f 62 74 61 69 6e 20 61 20 53 48 41 52 45  o obtain a SHARE
ded0: 44 20 6c 6f 63 6b 2c 20 61 20 72 65 61 64 2d 6c  D lock, a read-l
dee0: 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20  ock is obtained 
def0: 6f 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 0a  on the 'pending.
df00: 20 20 2a 2a 20 62 79 74 65 27 2e 20 20 49 66 20    ** byte'.  If 
df10: 74 68 69 73 20 69 73 20 73 75 63 63 65 73 73 66  this is successf
df20: 75 6c 2c 20 27 73 68 61 72 65 64 20 62 79 74 65  ul, 'shared byte
df30: 20 72 61 6e 67 65 27 20 69 73 20 72 65 61 64 2d   range' is read-
df40: 6c 6f 63 6b 65 64 0a 20 20 2a 2a 20 61 6e 64 20  locked.  ** and 
df50: 74 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20  the lock on the 
df60: 27 70 65 6e 64 69 6e 67 20 62 79 74 65 27 20 72  'pending byte' r
df70: 65 6c 65 61 73 65 64 2e 20 20 28 4c 65 67 61 63  eleased.  (Legac
df80: 79 20 6e 6f 74 65 3a 20 20 57 68 65 6e 0a 20 20  y note:  When.  
df90: 2a 2a 20 53 51 4c 69 74 65 20 77 61 73 20 66 69  ** SQLite was fi
dfa0: 72 73 74 20 64 65 76 65 6c 6f 70 65 64 2c 20 57  rst developed, W
dfb0: 69 6e 64 6f 77 73 39 35 20 73 79 73 74 65 6d 73  indows95 systems
dfc0: 20 77 65 72 65 20 73 74 69 6c 6c 20 76 65 72 79   were still very
dfd0: 20 63 6f 6d 6d 6f 6e 2c 0a 20 20 2a 2a 20 61 6e   common,.  ** an
dfe0: 64 20 57 69 64 6e 6f 77 73 39 35 20 6c 61 63 6b  d Widnows95 lack
dff0: 73 20 61 20 73 68 61 72 65 64 2d 6c 6f 63 6b 20  s a shared-lock 
e000: 63 61 70 61 62 69 6c 69 74 79 2e 20 20 53 6f 20  capability.  So 
e010: 6f 6e 20 57 69 6e 64 6f 77 73 39 35 2c 20 61 0a  on Windows95, a.
e020: 20 20 2a 2a 20 73 69 6e 67 6c 65 20 72 61 6e 64    ** single rand
e030: 6f 6d 6c 79 20 73 65 6c 65 63 74 65 64 20 62 79  omly selected by
e040: 20 66 72 6f 6d 20 74 68 65 20 27 73 68 61 72 65   from the 'share
e050: 64 20 62 79 74 65 20 72 61 6e 67 65 27 20 69 73  d byte range' is
e060: 20 6c 6f 63 6b 65 64 2e 0a 20 20 2a 2a 20 57 69   locked..  ** Wi
e070: 6e 64 6f 77 73 39 35 20 69 73 20 6e 6f 77 20 70  ndows95 is now p
e080: 72 65 74 74 79 20 6d 75 63 68 20 65 78 74 69 6e  retty much extin
e090: 63 74 2c 20 62 75 74 20 74 68 69 73 20 77 6f 72  ct, but this wor
e0a0: 6b 2d 61 72 6f 75 6e 64 20 66 6f 72 20 74 68 65  k-around for the
e0b0: 0a 20 20 2a 2a 20 6c 61 63 6b 20 6f 66 20 73 68  .  ** lack of sh
e0c0: 61 72 65 64 2d 6c 6f 63 6b 73 20 6f 6e 20 57 69  ared-locks on Wi
e0d0: 6e 64 6f 77 73 39 35 20 6c 69 76 65 73 20 6f 6e  ndows95 lives on
e0e0: 2c 20 66 6f 72 20 62 61 63 6b 77 61 72 64 73 0a  , for backwards.
e0f0: 20 20 2a 2a 20 63 6f 6d 70 61 74 69 62 69 6c 69    ** compatibili
e100: 74 79 2e 29 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41  ty.).  **.  ** A
e110: 20 70 72 6f 63 65 73 73 20 6d 61 79 20 6f 6e 6c   process may onl
e120: 79 20 6f 62 74 61 69 6e 20 61 20 52 45 53 45 52  y obtain a RESER
e130: 56 45 44 20 6c 6f 63 6b 20 61 66 74 65 72 20 69  VED lock after i
e140: 74 20 68 61 73 20 61 20 53 48 41 52 45 44 20 6c  t has a SHARED l
e150: 6f 63 6b 2e 0a 20 20 2a 2a 20 41 20 52 45 53 45  ock..  ** A RESE
e160: 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 69 6d 70  RVED lock is imp
e170: 6c 65 6d 65 6e 74 65 64 20 62 79 20 67 72 61 62  lemented by grab
e180: 62 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63  bing a write-loc
e190: 6b 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 27 72  k on the.  ** 'r
e1a0: 65 73 65 72 76 65 64 20 62 79 74 65 27 2e 20 0a  eserved byte'. .
e1b0: 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 70 72 6f 63    **.  ** A proc
e1c0: 65 73 73 20 6d 61 79 20 6f 6e 6c 79 20 6f 62 74  ess may only obt
e1d0: 61 69 6e 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f  ain a PENDING lo
e1e0: 63 6b 20 61 66 74 65 72 20 69 74 20 68 61 73 20  ck after it has 
e1f0: 6f 62 74 61 69 6e 65 64 20 61 0a 20 20 2a 2a 20  obtained a.  ** 
e200: 53 48 41 52 45 44 20 6c 6f 63 6b 2e 20 41 20 50  SHARED lock. A P
e210: 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69 73 20 69  ENDING lock is i
e220: 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 6f 62  mplemented by ob
e230: 74 61 69 6e 69 6e 67 20 61 20 77 72 69 74 65 2d  taining a write-
e240: 6c 6f 63 6b 0a 20 20 2a 2a 20 6f 6e 20 74 68 65  lock.  ** on the
e250: 20 27 70 65 6e 64 69 6e 67 20 62 79 74 65 27 2e   'pending byte'.
e260: 20 54 68 69 73 20 65 6e 73 75 72 65 73 20 74 68   This ensures th
e270: 61 74 20 6e 6f 20 6e 65 77 20 53 48 41 52 45 44  at no new SHARED
e280: 20 6c 6f 63 6b 73 20 63 61 6e 20 62 65 0a 20 20   locks can be.  
e290: 2a 2a 20 6f 62 74 61 69 6e 65 64 2c 20 62 75 74  ** obtained, but
e2a0: 20 65 78 69 73 74 69 6e 67 20 53 48 41 52 45 44   existing SHARED
e2b0: 20 6c 6f 63 6b 73 20 61 72 65 20 61 6c 6c 6f 77   locks are allow
e2c0: 65 64 20 74 6f 20 70 65 72 73 69 73 74 2e 20 41  ed to persist. A
e2d0: 20 70 72 6f 63 65 73 73 0a 20 20 2a 2a 20 64 6f   process.  ** do
e2e0: 65 73 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 6f  es not have to o
e2f0: 62 74 61 69 6e 20 61 20 52 45 53 45 52 56 45 44  btain a RESERVED
e300: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 77 61 79   lock on the way
e310: 20 74 6f 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f   to a PENDING lo
e320: 63 6b 2e 0a 20 20 2a 2a 20 54 68 69 73 20 70 72  ck..  ** This pr
e330: 6f 70 65 72 74 79 20 69 73 20 75 73 65 64 20 62  operty is used b
e340: 79 20 74 68 65 20 61 6c 67 6f 72 69 74 68 6d 20  y the algorithm 
e350: 66 6f 72 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b  for rolling back
e360: 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a   a journal file.
e370: 20 20 2a 2a 20 61 66 74 65 72 20 61 20 63 72 61    ** after a cra
e380: 73 68 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e  sh..  **.  ** An
e390: 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2c   EXCLUSIVE lock,
e3a0: 20 6f 62 74 61 69 6e 65 64 20 61 66 74 65 72 20   obtained after 
e3b0: 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69  a PENDING lock i
e3c0: 73 20 68 65 6c 64 2c 20 69 73 0a 20 20 2a 2a 20  s held, is.  ** 
e3d0: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 6f  implemented by o
e3e0: 62 74 61 69 6e 69 6e 67 20 61 20 77 72 69 74 65  btaining a write
e3f0: 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 65 6e 74  -lock on the ent
e400: 69 72 65 20 27 73 68 61 72 65 64 20 62 79 74 65  ire 'shared byte
e410: 0a 20 20 2a 2a 20 72 61 6e 67 65 27 2e 20 53 69  .  ** range'. Si
e420: 6e 63 65 20 61 6c 6c 20 6f 74 68 65 72 20 6c 6f  nce all other lo
e430: 63 6b 73 20 72 65 71 75 69 72 65 20 61 20 72 65  cks require a re
e440: 61 64 2d 6c 6f 63 6b 20 6f 6e 20 6f 6e 65 20 6f  ad-lock on one o
e450: 66 20 74 68 65 20 62 79 74 65 73 0a 20 20 2a 2a  f the bytes.  **
e460: 20 77 69 74 68 69 6e 20 74 68 69 73 20 72 61 6e   within this ran
e470: 67 65 2c 20 74 68 69 73 20 65 6e 73 75 72 65 73  ge, this ensures
e480: 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 6c   that no other l
e490: 6f 63 6b 73 20 61 72 65 20 68 65 6c 64 20 6f 6e  ocks are held on
e4a0: 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61   the.  ** databa
e4b0: 73 65 2e 20 0a 20 20 2a 2f 0a 20 20 69 6e 74 20  se. .  */.  int 
e4c0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
e4d0: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c    unixFile *pFil
e4e0: 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69  e = (unixFile*)i
e4f0: 64 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e  d;.  unixInodeIn
e500: 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 20 20 73 74  fo *pInode;.  st
e510: 72 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b  ruct flock lock;
e520: 0a 20 20 69 6e 74 20 74 45 72 72 6e 6f 20 3d 20  .  int tErrno = 
e530: 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46  0;..  assert( pF
e540: 69 6c 65 20 29 3b 0a 20 20 4f 53 54 52 41 43 45  ile );.  OSTRACE
e550: 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 73  (("LOCK    %d %s
e560: 20 77 61 73 20 25 73 28 25 73 2c 25 64 29 20 70   was %s(%s,%d) p
e570: 69 64 3d 25 64 20 28 75 6e 69 78 29 5c 6e 22 2c  id=%d (unix)\n",
e580: 20 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 20 20 20   pFile->h,.     
e590: 20 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 69 6c   azFileLock(eFil
e5a0: 65 4c 6f 63 6b 29 2c 20 61 7a 46 69 6c 65 4c 6f  eLock), azFileLo
e5b0: 63 6b 28 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c  ck(pFile->eFileL
e5c0: 6f 63 6b 29 2c 0a 20 20 20 20 20 20 61 7a 46 69  ock),.      azFi
e5d0: 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 2d 3e 70 49  leLock(pFile->pI
e5e0: 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 29  node->eFileLock)
e5f0: 2c 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d  , pFile->pInode-
e600: 3e 6e 53 68 61 72 65 64 2c 0a 20 20 20 20 20 20  >nShared,.      
e610: 6f 73 47 65 74 70 69 64 28 30 29 29 29 3b 0a 0a  osGetpid(0)));..
e620: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73    /* If there is
e630: 20 61 6c 72 65 61 64 79 20 61 20 6c 6f 63 6b 20   already a lock 
e640: 6f 66 20 74 68 69 73 20 74 79 70 65 20 6f 72 20  of this type or 
e650: 6d 6f 72 65 20 72 65 73 74 72 69 63 74 69 76 65  more restrictive
e660: 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 75 6e 69   on the.  ** uni
e670: 78 46 69 6c 65 2c 20 64 6f 20 6e 6f 74 68 69 6e  xFile, do nothin
e680: 67 2e 20 44 6f 6e 27 74 20 75 73 65 20 74 68 65  g. Don't use the
e690: 20 65 6e 64 5f 6c 6f 63 6b 3a 20 65 78 69 74 20   end_lock: exit 
e6a0: 70 61 74 68 2c 20 61 73 0a 20 20 2a 2a 20 75 6e  path, as.  ** un
e6b0: 69 78 45 6e 74 65 72 4d 75 74 65 78 28 29 20 68  ixEnterMutex() h
e6c0: 61 73 6e 27 74 20 62 65 65 6e 20 63 61 6c 6c 65  asn't been calle
e6d0: 64 20 79 65 74 2e 0a 20 20 2a 2f 0a 20 20 69 66  d yet..  */.  if
e6e0: 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f  ( pFile->eFileLo
e6f0: 63 6b 3e 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b  ck>=eFileLock ){
e700: 0a 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 4c  .    OSTRACE(("L
e710: 4f 43 4b 20 20 20 20 25 64 20 25 73 20 6f 6b 20  OCK    %d %s ok 
e720: 28 61 6c 72 65 61 64 79 20 68 65 6c 64 29 20 28  (already held) (
e730: 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 6c 65 2d  unix)\n", pFile-
e740: 3e 68 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  >h,.            
e750: 61 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 69 6c 65  azFileLock(eFile
e760: 4c 6f 63 6b 29 29 29 3b 0a 20 20 20 20 72 65 74  Lock)));.    ret
e770: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
e780: 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75   }..  /* Make su
e790: 72 65 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 73  re the locking s
e7a0: 65 71 75 65 6e 63 65 20 69 73 20 63 6f 72 72 65  equence is corre
e7b0: 63 74 2e 0a 20 20 2a 2a 20 20 28 31 29 20 57 65  ct..  **  (1) We
e7c0: 20 6e 65 76 65 72 20 6d 6f 76 65 20 66 72 6f 6d   never move from
e7d0: 20 75 6e 6c 6f 63 6b 65 64 20 74 6f 20 61 6e 79   unlocked to any
e7e0: 74 68 69 6e 67 20 68 69 67 68 65 72 20 74 68 61  thing higher tha
e7f0: 6e 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 0a 20  n shared lock.. 
e800: 20 2a 2a 20 20 28 32 29 20 53 51 4c 69 74 65 20   **  (2) SQLite 
e810: 6e 65 76 65 72 20 65 78 70 6c 69 63 69 74 6c 79  never explicitly
e820: 20 72 65 71 75 65 73 74 73 20 61 20 70 65 6e 64   requests a pend
e830: 69 67 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 20 28  ig lock..  **  (
e840: 33 29 20 41 20 73 68 61 72 65 64 20 6c 6f 63 6b  3) A shared lock
e850: 20 69 73 20 61 6c 77 61 79 73 20 68 65 6c 64 20   is always held 
e860: 77 68 65 6e 20 61 20 72 65 73 65 72 76 65 20 6c  when a reserve l
e870: 6f 63 6b 20 69 73 20 72 65 71 75 65 73 74 65 64  ock is requested
e880: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  ..  */.  assert(
e890: 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63   pFile->eFileLoc
e8a0: 6b 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 65 46  k!=NO_LOCK || eF
e8b0: 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f  ileLock==SHARED_
e8c0: 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74  LOCK );.  assert
e8d0: 28 20 65 46 69 6c 65 4c 6f 63 6b 21 3d 50 45 4e  ( eFileLock!=PEN
e8e0: 44 49 4e 47 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61  DING_LOCK );.  a
e8f0: 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b  ssert( eFileLock
e900: 21 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20  !=RESERVED_LOCK 
e910: 7c 7c 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c  || pFile->eFileL
e920: 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b  ock==SHARED_LOCK
e930: 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 6d   );..  /* This m
e940: 75 74 65 78 20 69 73 20 6e 65 65 64 65 64 20 62  utex is needed b
e950: 65 63 61 75 73 65 20 70 46 69 6c 65 2d 3e 70 49  ecause pFile->pI
e960: 6e 6f 64 65 20 69 73 20 73 68 61 72 65 64 20 61  node is shared a
e970: 63 72 6f 73 73 20 74 68 72 65 61 64 73 0a 20 20  cross threads.  
e980: 2a 2f 0a 20 20 70 49 6e 6f 64 65 20 3d 20 70 46  */.  pInode = pF
e990: 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 73  ile->pInode;.  s
e9a0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
e9b0: 65 72 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b  er(pInode->pLock
e9c0: 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 49 66  Mutex);..  /* If
e9d0: 20 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69   some thread usi
e9e0: 6e 67 20 74 68 69 73 20 50 49 44 20 68 61 73 20  ng this PID has 
e9f0: 61 20 6c 6f 63 6b 20 76 69 61 20 61 20 64 69 66  a lock via a dif
ea00: 66 65 72 65 6e 74 20 75 6e 69 78 46 69 6c 65 2a  ferent unixFile*
ea10: 0a 20 20 2a 2a 20 68 61 6e 64 6c 65 20 74 68 61  .  ** handle tha
ea20: 74 20 70 72 65 63 6c 75 64 65 73 20 74 68 65 20  t precludes the 
ea30: 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 2c 20  requested lock, 
ea40: 72 65 74 75 72 6e 20 42 55 53 59 2e 0a 20 20 2a  return BUSY..  *
ea50: 2f 0a 20 20 69 66 28 20 28 70 46 69 6c 65 2d 3e  /.  if( (pFile->
ea60: 65 46 69 6c 65 4c 6f 63 6b 21 3d 70 49 6e 6f 64  eFileLock!=pInod
ea70: 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 26 26 20  e->eFileLock && 
ea80: 0a 20 20 20 20 20 20 20 20 20 20 28 70 49 6e 6f  .          (pIno
ea90: 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 50  de->eFileLock>=P
eaa0: 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 7c 7c 20 65  ENDING_LOCK || e
eab0: 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f  FileLock>SHARED_
eac0: 4c 4f 43 4b 29 29 0a 20 20 29 7b 0a 20 20 20 20  LOCK)).  ){.    
ead0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59  rc = SQLITE_BUSY
eae0: 3b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c  ;.    goto end_l
eaf0: 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49  ock;.  }..  /* I
eb00: 66 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20  f a SHARED lock 
eb10: 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e  is requested, an
eb20: 64 20 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73  d some thread us
eb30: 69 6e 67 20 74 68 69 73 20 50 49 44 20 61 6c 72  ing this PID alr
eb40: 65 61 64 79 0a 20 20 2a 2a 20 68 61 73 20 61 20  eady.  ** has a 
eb50: 53 48 41 52 45 44 20 6f 72 20 52 45 53 45 52 56  SHARED or RESERV
eb60: 45 44 20 6c 6f 63 6b 2c 20 74 68 65 6e 20 69 6e  ED lock, then in
eb70: 63 72 65 6d 65 6e 74 20 72 65 66 65 72 65 6e 63  crement referenc
eb80: 65 20 63 6f 75 6e 74 73 20 61 6e 64 0a 20 20 2a  e counts and.  *
eb90: 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  * return SQLITE_
eba0: 4f 4b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65  OK..  */.  if( e
ebb0: 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44  FileLock==SHARED
ebc0: 5f 4c 4f 43 4b 20 26 26 20 0a 20 20 20 20 20 20  _LOCK && .      
ebd0: 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f  (pInode->eFileLo
ebe0: 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20  ck==SHARED_LOCK 
ebf0: 7c 7c 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65  || pInode->eFile
ec00: 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c  Lock==RESERVED_L
ec10: 4f 43 4b 29 20 29 7b 0a 20 20 20 20 61 73 73 65  OCK) ){.    asse
ec20: 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53  rt( eFileLock==S
ec30: 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20  HARED_LOCK );.  
ec40: 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d    assert( pFile-
ec50: 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 29 3b  >eFileLock==0 );
ec60: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e  .    assert( pIn
ec70: 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e 30 20 29  ode->nShared>0 )
ec80: 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69  ;.    pFile->eFi
ec90: 6c 65 4c 6f 63 6b 20 3d 20 53 48 41 52 45 44 5f  leLock = SHARED_
eca0: 4c 4f 43 4b 3b 0a 20 20 20 20 70 49 6e 6f 64 65  LOCK;.    pInode
ecb0: 2d 3e 6e 53 68 61 72 65 64 2b 2b 3b 0a 20 20 20  ->nShared++;.   
ecc0: 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 2b 2b   pInode->nLock++
ecd0: 3b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c  ;.    goto end_l
ece0: 6f 63 6b 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20  ock;.  }...  /* 
ecf0: 41 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69  A PENDING lock i
ed00: 73 20 6e 65 65 64 65 64 20 62 65 66 6f 72 65 20  s needed before 
ed10: 61 63 71 75 69 72 69 6e 67 20 61 20 53 48 41 52  acquiring a SHAR
ed20: 45 44 20 6c 6f 63 6b 20 61 6e 64 20 62 65 66 6f  ED lock and befo
ed30: 72 65 0a 20 20 2a 2a 20 61 63 71 75 69 72 69 6e  re.  ** acquirin
ed40: 67 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c  g an EXCLUSIVE l
ed50: 6f 63 6b 2e 20 20 46 6f 72 20 74 68 65 20 53 48  ock.  For the SH
ed60: 41 52 45 44 20 6c 6f 63 6b 2c 20 74 68 65 20 50  ARED lock, the P
ed70: 45 4e 44 49 4e 47 20 77 69 6c 6c 0a 20 20 2a 2a  ENDING will.  **
ed80: 20 62 65 20 72 65 6c 65 61 73 65 64 2e 0a 20 20   be released..  
ed90: 2a 2f 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20  */.  lock.l_len 
eda0: 3d 20 31 4c 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 77  = 1L;.  lock.l_w
edb0: 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54  hence = SEEK_SET
edc0: 3b 0a 20 20 69 66 28 20 65 46 69 6c 65 4c 6f 63  ;.  if( eFileLoc
edd0: 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 0a  k==SHARED_LOCK .
ede0: 20 20 20 20 20 20 7c 7c 20 28 65 46 69 6c 65 4c        || (eFileL
edf0: 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c  ock==EXCLUSIVE_L
ee00: 4f 43 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 46  OCK && pFile->eF
ee10: 69 6c 65 4c 6f 63 6b 3c 50 45 4e 44 49 4e 47 5f  ileLock<PENDING_
ee20: 4c 4f 43 4b 29 0a 20 20 29 7b 0a 20 20 20 20 6c  LOCK).  ){.    l
ee30: 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 28 65 46  ock.l_type = (eF
ee40: 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f  ileLock==SHARED_
ee50: 4c 4f 43 4b 3f 46 5f 52 44 4c 43 4b 3a 46 5f 57  LOCK?F_RDLCK:F_W
ee60: 52 4c 43 4b 29 3b 0a 20 20 20 20 6c 6f 63 6b 2e  RLCK);.    lock.
ee70: 6c 5f 73 74 61 72 74 20 3d 20 50 45 4e 44 49 4e  l_start = PENDIN
ee80: 47 5f 42 59 54 45 3b 0a 20 20 20 20 69 66 28 20  G_BYTE;.    if( 
ee90: 75 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69  unixFileLock(pFi
eea0: 6c 65 2c 20 26 6c 6f 63 6b 29 20 29 7b 0a 20 20  le, &lock) ){.  
eeb0: 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72      tErrno = err
eec0: 6e 6f 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73  no;.      rc = s
eed0: 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50 6f  qliteErrorFromPo
eee0: 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f 2c  sixError(tErrno,
eef0: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f   SQLITE_IOERR_LO
ef00: 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  CK);.      if( r
ef10: 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29  c!=SQLITE_BUSY )
ef20: 7b 0a 20 20 20 20 20 20 20 20 73 74 6f 72 65 4c  {.        storeL
ef30: 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20  astErrno(pFile, 
ef40: 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 7d  tErrno);.      }
ef50: 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f  .      goto end_
ef60: 6c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  lock;.    }.  }.
ef70: 0a 0a 20 20 2f 2a 20 49 66 20 63 6f 6e 74 72 6f  ..  /* If contro
ef80: 6c 20 67 65 74 73 20 74 6f 20 74 68 69 73 20 70  l gets to this p
ef90: 6f 69 6e 74 2c 20 74 68 65 6e 20 61 63 74 75 61  oint, then actua
efa0: 6c 6c 79 20 67 6f 20 61 68 65 61 64 20 61 6e 64  lly go ahead and
efb0: 20 6d 61 6b 65 0a 20 20 2a 2a 20 6f 70 65 72 61   make.  ** opera
efc0: 74 69 6e 67 20 73 79 73 74 65 6d 20 63 61 6c 6c  ting system call
efd0: 73 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66  s for the specif
efe0: 69 65 64 20 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20  ied lock..  */. 
eff0: 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d   if( eFileLock==
f000: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20  SHARED_LOCK ){. 
f010: 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64     assert( pInod
f020: 65 2d 3e 6e 53 68 61 72 65 64 3d 3d 30 20 29 3b  e->nShared==0 );
f030: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 49 6e  .    assert( pIn
f040: 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d  ode->eFileLock==
f050: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
f060: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
f070: 3b 0a 0a 20 20 20 20 2f 2a 20 4e 6f 77 20 67 65  ;..    /* Now ge
f080: 74 20 74 68 65 20 72 65 61 64 2d 6c 6f 63 6b 20  t the read-lock 
f090: 2a 2f 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74  */.    lock.l_st
f0a0: 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52  art = SHARED_FIR
f0b0: 53 54 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c  ST;.    lock.l_l
f0c0: 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45  en = SHARED_SIZE
f0d0: 3b 0a 20 20 20 20 69 66 28 20 75 6e 69 78 46 69  ;.    if( unixFi
f0e0: 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c  leLock(pFile, &l
f0f0: 6f 63 6b 29 20 29 7b 0a 20 20 20 20 20 20 74 45  ock) ){.      tE
f100: 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20  rrno = errno;.  
f110: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 45      rc = sqliteE
f120: 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72 72  rrorFromPosixErr
f130: 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49 54  or(tErrno, SQLIT
f140: 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b 0a 20  E_IOERR_LOCK);. 
f150: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 72 6f     }..    /* Dro
f160: 70 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20  p the temporary 
f170: 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 2a 2f 0a  PENDING lock */.
f180: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74      lock.l_start
f190: 20 3d 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b   = PENDING_BYTE;
f1a0: 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20  .    lock.l_len 
f1b0: 3d 20 31 4c 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c  = 1L;.    lock.l
f1c0: 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b  _type = F_UNLCK;
f1d0: 0a 20 20 20 20 69 66 28 20 75 6e 69 78 46 69 6c  .    if( unixFil
f1e0: 65 4c 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f  eLock(pFile, &lo
f1f0: 63 6b 29 20 26 26 20 72 63 3d 3d 53 51 4c 49 54  ck) && rc==SQLIT
f200: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a  E_OK ){.      /*
f210: 20 54 68 69 73 20 63 6f 75 6c 64 20 68 61 70 70   This could happ
f220: 65 6e 20 77 69 74 68 20 61 20 6e 65 74 77 6f 72  en with a networ
f230: 6b 20 6d 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 20  k mount */.     
f240: 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b   tErrno = errno;
f250: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49  .      rc = SQLI
f260: 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b  TE_IOERR_UNLOCK;
f270: 20 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28   .    }..    if(
f280: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 69 66 28   rc ){.      if(
f290: 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59   rc!=SQLITE_BUSY
f2a0: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74 6f 72   ){.        stor
f2b0: 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65  eLastErrno(pFile
f2c0: 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20  , tErrno);.     
f2d0: 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e   }.      goto en
f2e0: 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 65 6c 73  d_lock;.    }els
f2f0: 65 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e  e{.      pFile->
f300: 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 53 48 41 52  eFileLock = SHAR
f310: 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 70  ED_LOCK;.      p
f320: 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a  Inode->nLock++;.
f330: 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 53        pInode->nS
f340: 68 61 72 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d  hared = 1;.    }
f350: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 65 46 69  .  }else if( eFi
f360: 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56  leLock==EXCLUSIV
f370: 45 5f 4c 4f 43 4b 20 26 26 20 70 49 6e 6f 64 65  E_LOCK && pInode
f380: 2d 3e 6e 53 68 61 72 65 64 3e 31 20 29 7b 0a 20  ->nShared>1 ){. 
f390: 20 20 20 2f 2a 20 57 65 20 61 72 65 20 74 72 79     /* We are try
f3a0: 69 6e 67 20 66 6f 72 20 61 6e 20 65 78 63 6c 75  ing for an exclu
f3b0: 73 69 76 65 20 6c 6f 63 6b 20 62 75 74 20 61 6e  sive lock but an
f3c0: 6f 74 68 65 72 20 74 68 72 65 61 64 20 69 6e 20  other thread in 
f3d0: 74 68 69 73 0a 20 20 20 20 2a 2a 20 73 61 6d 65  this.    ** same
f3e0: 20 70 72 6f 63 65 73 73 20 69 73 20 73 74 69 6c   process is stil
f3f0: 6c 20 68 6f 6c 64 69 6e 67 20 61 20 73 68 61 72  l holding a shar
f400: 65 64 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 20 20  ed lock. */.    
f410: 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59  rc = SQLITE_BUSY
f420: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  ;.  }else{.    /
f430: 2a 20 54 68 65 20 72 65 71 75 65 73 74 20 77 61  * The request wa
f440: 73 20 66 6f 72 20 61 20 52 45 53 45 52 56 45 44  s for a RESERVED
f450: 20 6f 72 20 45 58 43 4c 55 53 49 56 45 20 6c 6f   or EXCLUSIVE lo
f460: 63 6b 2e 20 20 49 74 20 69 73 0a 20 20 20 20 2a  ck.  It is.    *
f470: 2a 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 74  * assumed that t
f480: 68 65 72 65 20 69 73 20 61 20 53 48 41 52 45 44  here is a SHARED
f490: 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f 63 6b   or greater lock
f4a0: 20 6f 6e 20 74 68 65 20 66 69 6c 65 0a 20 20 20   on the file.   
f4b0: 20 2a 2a 20 61 6c 72 65 61 64 79 2e 0a 20 20 20   ** already..   
f4c0: 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20   */.    assert( 
f4d0: 30 21 3d 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c  0!=pFile->eFileL
f4e0: 6f 63 6b 20 29 3b 0a 20 20 20 20 6c 6f 63 6b 2e  ock );.    lock.
f4f0: 6c 5f 74 79 70 65 20 3d 20 46 5f 57 52 4c 43 4b  l_type = F_WRLCK
f500: 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 65  ;..    assert( e
f510: 46 69 6c 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56  FileLock==RESERV
f520: 45 44 5f 4c 4f 43 4b 20 7c 7c 20 65 46 69 6c 65  ED_LOCK || eFile
f530: 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f  Lock==EXCLUSIVE_
f540: 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 69 66 28 20  LOCK );.    if( 
f550: 65 46 69 6c 65 4c 6f 63 6b 3d 3d 52 45 53 45 52  eFileLock==RESER
f560: 56 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20  VED_LOCK ){.    
f570: 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d    lock.l_start =
f580: 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a   RESERVED_BYTE;.
f590: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e        lock.l_len
f5a0: 20 3d 20 31 4c 3b 0a 20 20 20 20 7d 65 6c 73 65   = 1L;.    }else
f5b0: 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73  {.      lock.l_s
f5c0: 74 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49  tart = SHARED_FI
f5d0: 52 53 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e  RST;.      lock.
f5e0: 6c 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53  l_len = SHARED_S
f5f0: 49 5a 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  IZE;.    }..    
f600: 69 66 28 20 75 6e 69 78 46 69 6c 65 4c 6f 63 6b  if( unixFileLock
f610: 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b 29 20 29  (pFile, &lock) )
f620: 7b 0a 20 20 20 20 20 20 74 45 72 72 6e 6f 20 3d  {.      tErrno =
f630: 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20 72 63   errno;.      rc
f640: 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46 72   = sqliteErrorFr
f650: 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45 72  omPosixError(tEr
f660: 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52  rno, SQLITE_IOER
f670: 52 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69  R_LOCK);.      i
f680: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55  f( rc!=SQLITE_BU
f690: 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 73 74  SY ){.        st
f6a0: 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69  oreLastErrno(pFi
f6b0: 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20 20  le, tErrno);.   
f6c0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
f6d0: 20 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45   ..#ifdef SQLITE
f6e0: 5f 44 45 42 55 47 0a 20 20 2f 2a 20 53 65 74 20  _DEBUG.  /* Set 
f6f0: 75 70 20 74 68 65 20 74 72 61 6e 73 61 63 74 69  up the transacti
f700: 6f 6e 2d 63 6f 75 6e 74 65 72 20 63 68 61 6e 67  on-counter chang
f710: 65 20 63 68 65 63 6b 69 6e 67 20 66 6c 61 67 73  e checking flags
f720: 20 77 68 65 6e 0a 20 20 2a 2a 20 74 72 61 6e 73   when.  ** trans
f730: 69 74 69 6f 6e 69 6e 67 20 66 72 6f 6d 20 61 20  itioning from a 
f740: 53 48 41 52 45 44 20 74 6f 20 61 20 52 45 53 45  SHARED to a RESE
f750: 52 56 45 44 20 6c 6f 63 6b 2e 20 20 54 68 65 20  RVED lock.  The 
f760: 63 68 61 6e 67 65 0a 20 20 2a 2a 20 66 72 6f 6d  change.  ** from
f770: 20 53 48 41 52 45 44 20 74 6f 20 52 45 53 45 52   SHARED to RESER
f780: 56 45 44 20 6d 61 72 6b 73 20 74 68 65 20 62 65  VED marks the be
f790: 67 69 6e 6e 69 6e 67 20 6f 66 20 61 20 6e 6f 72  ginning of a nor
f7a0: 6d 61 6c 0a 20 20 2a 2a 20 77 72 69 74 65 20 6f  mal.  ** write o
f7b0: 70 65 72 61 74 69 6f 6e 20 28 6e 6f 74 20 61 20  peration (not a 
f7c0: 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c  hot journal roll
f7d0: 62 61 63 6b 29 2e 0a 20 20 2a 2f 0a 20 20 69 66  back)..  */.  if
f7e0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0a  ( rc==SQLITE_OK.
f7f0: 20 20 20 26 26 20 70 46 69 6c 65 2d 3e 65 46 69     && pFile->eFi
f800: 6c 65 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c  leLock<=SHARED_L
f810: 4f 43 4b 0a 20 20 20 26 26 20 65 46 69 6c 65 4c  OCK.   && eFileL
f820: 6f 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f  ock==RESERVED_LO
f830: 43 4b 0a 20 20 29 7b 0a 20 20 20 20 70 46 69 6c  CK.  ){.    pFil
f840: 65 2d 3e 74 72 61 6e 73 43 6e 74 72 43 68 6e 67  e->transCntrChng
f850: 20 3d 20 30 3b 0a 20 20 20 20 70 46 69 6c 65 2d   = 0;.    pFile-
f860: 3e 64 62 55 70 64 61 74 65 20 3d 20 30 3b 0a 20  >dbUpdate = 0;. 
f870: 20 20 20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d     pFile->inNorm
f880: 61 6c 57 72 69 74 65 20 3d 20 31 3b 0a 20 20 7d  alWrite = 1;.  }
f890: 0a 23 65 6e 64 69 66 0a 0a 0a 20 20 69 66 28 20  .#endif...  if( 
f8a0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
f8b0: 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c  .    pFile->eFil
f8c0: 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63  eLock = eFileLoc
f8d0: 6b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65  k;.    pInode->e
f8e0: 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65  FileLock = eFile
f8f0: 4c 6f 63 6b 3b 0a 20 20 7d 65 6c 73 65 20 69 66  Lock;.  }else if
f900: 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43  ( eFileLock==EXC
f910: 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 7b 0a 20  LUSIVE_LOCK ){. 
f920: 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c     pFile->eFileL
f930: 6f 63 6b 20 3d 20 50 45 4e 44 49 4e 47 5f 4c 4f  ock = PENDING_LO
f940: 43 4b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e  CK;.    pInode->
f950: 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44  eFileLock = PEND
f960: 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 0a 65  ING_LOCK;.  }..e
f970: 6e 64 5f 6c 6f 63 6b 3a 0a 20 20 73 71 6c 69 74  nd_lock:.  sqlit
f980: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
f990: 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65  Inode->pLockMute
f9a0: 78 29 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22  x);.  OSTRACE(("
f9b0: 4c 4f 43 4b 20 20 20 20 25 64 20 25 73 20 25 73  LOCK    %d %s %s
f9c0: 20 28 75 6e 69 78 29 5c 6e 22 2c 20 70 46 69 6c   (unix)\n", pFil
f9d0: 65 2d 3e 68 2c 20 61 7a 46 69 6c 65 4c 6f 63 6b  e->h, azFileLock
f9e0: 28 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 0a 20 20  (eFileLock), .  
f9f0: 20 20 20 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f      rc==SQLITE_O
fa00: 4b 20 3f 20 22 6f 6b 22 20 3a 20 22 66 61 69 6c  K ? "ok" : "fail
fa10: 65 64 22 29 29 3b 0a 20 20 72 65 74 75 72 6e 20  ed"));.  return 
fa20: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64  rc;.}../*.** Add
fa30: 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69   the file descri
fa40: 70 74 6f 72 20 75 73 65 64 20 62 79 20 66 69 6c  ptor used by fil
fa50: 65 20 68 61 6e 64 6c 65 20 70 46 69 6c 65 20 74  e handle pFile t
fa60: 6f 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64  o the correspond
fa70: 69 6e 67 0a 2a 2a 20 70 55 6e 75 73 65 64 20 6c  ing.** pUnused l
fa80: 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ist..*/.static v
fa90: 6f 69 64 20 73 65 74 50 65 6e 64 69 6e 67 46 64  oid setPendingFd
faa0: 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65  (unixFile *pFile
fab0: 29 7b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e  ){.  unixInodeIn
fac0: 66 6f 20 2a 70 49 6e 6f 64 65 20 3d 20 70 46 69  fo *pInode = pFi
fad0: 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 55 6e  le->pInode;.  Un
fae0: 69 78 55 6e 75 73 65 64 46 64 20 2a 70 20 3d 20  ixUnusedFd *p = 
faf0: 70 46 69 6c 65 2d 3e 70 50 72 65 61 6c 6c 6f 63  pFile->pPrealloc
fb00: 61 74 65 64 55 6e 75 73 65 64 3b 0a 20 20 61 73  atedUnused;.  as
fb10: 73 65 72 74 28 20 75 6e 69 78 46 69 6c 65 4d 75  sert( unixFileMu
fb20: 74 65 78 48 65 6c 64 28 70 46 69 6c 65 29 20 29  texHeld(pFile) )
fb30: 3b 0a 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70  ;.  p->pNext = p
fb40: 49 6e 6f 64 65 2d 3e 70 55 6e 75 73 65 64 3b 0a  Inode->pUnused;.
fb50: 20 20 70 49 6e 6f 64 65 2d 3e 70 55 6e 75 73 65    pInode->pUnuse
fb60: 64 20 3d 20 70 3b 0a 20 20 70 46 69 6c 65 2d 3e  d = p;.  pFile->
fb70: 68 20 3d 20 2d 31 3b 0a 20 20 70 46 69 6c 65 2d  h = -1;.  pFile-
fb80: 3e 70 50 72 65 61 6c 6c 6f 63 61 74 65 64 55 6e  >pPreallocatedUn
fb90: 75 73 65 64 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a  used = 0;.}../*.
fba0: 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c 6f 63  ** Lower the loc
fbb0: 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20 66 69  king level on fi
fbc0: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 70 46  le descriptor pF
fbd0: 69 6c 65 20 74 6f 20 65 46 69 6c 65 4c 6f 63 6b  ile to eFileLock
fbe0: 2e 20 20 65 46 69 6c 65 4c 6f 63 6b 0a 2a 2a 20  .  eFileLock.** 
fbf0: 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 4e  must be either N
fc00: 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 44  O_LOCK or SHARED
fc10: 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  _LOCK..**.** If 
fc20: 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65  the locking leve
fc30: 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64 65  l of the file de
fc40: 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72 65  scriptor is alre
fc50: 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a  ady at or below.
fc60: 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65 64  ** the requested
fc70: 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20   locking level, 
fc80: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
fc90: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 20 0a 2a 2a 20  a no-op..** .** 
fca0: 49 66 20 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f  If handleNFSUnlo
fcb0: 63 6b 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e  ck is true, then
fcc0: 20 6f 6e 20 64 6f 77 6e 67 72 61 64 69 6e 67 20   on downgrading 
fcd0: 61 6e 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43  an EXCLUSIVE_LOC
fce0: 4b 20 74 6f 20 53 48 41 52 45 44 0a 2a 2a 20 74  K to SHARED.** t
fcf0: 68 65 20 62 79 74 65 20 72 61 6e 67 65 20 69 73  he byte range is
fd00: 20 64 69 76 69 64 65 64 20 69 6e 74 6f 20 32 20   divided into 2 
fd10: 70 61 72 74 73 20 61 6e 64 20 74 68 65 20 66 69  parts and the fi
fd20: 72 73 74 20 70 61 72 74 20 69 73 20 75 6e 6c 6f  rst part is unlo
fd30: 63 6b 65 64 20 74 68 65 6e 0a 2a 2a 20 73 65 74  cked then.** set
fd40: 20 74 6f 20 61 20 72 65 61 64 20 6c 6f 63 6b 2c   to a read lock,
fd50: 20 74 68 65 6e 20 74 68 65 20 6f 74 68 65 72 20   then the other 
fd60: 70 61 72 74 20 69 73 20 73 69 6d 70 6c 79 20 75  part is simply u
fd70: 6e 6c 6f 63 6b 65 64 2e 20 20 54 68 69 73 20 77  nlocked.  This w
fd80: 6f 72 6b 73 20 0a 2a 2a 20 61 72 6f 75 6e 64 20  orks .** around 
fd90: 61 20 62 75 67 20 69 6e 20 42 53 44 20 4e 46 53  a bug in BSD NFS
fda0: 20 6c 6f 63 6b 64 20 28 61 6c 73 6f 20 73 65 65   lockd (also see
fdb0: 6e 20 6f 6e 20 4d 61 63 4f 53 58 20 31 30 2e 33  n on MacOSX 10.3
fdc0: 2b 29 20 74 68 61 74 20 66 61 69 6c 73 20 74 6f  +) that fails to
fdd0: 20 0a 2a 2a 20 72 65 6d 6f 76 65 20 74 68 65 20   .** remove the 
fde0: 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 61 20  write lock on a 
fdf0: 72 65 67 69 6f 6e 20 77 68 65 6e 20 61 20 72 65  region when a re
fe00: 61 64 20 6c 6f 63 6b 20 69 73 20 73 65 74 2e 0a  ad lock is set..
fe10: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 6f  */.static int po
fe20: 73 69 78 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65  sixUnlock(sqlite
fe30: 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20  3_file *id, int 
fe40: 65 46 69 6c 65 4c 6f 63 6b 2c 20 69 6e 74 20 68  eFileLock, int h
fe50: 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f 63 6b 29 7b  andleNFSUnlock){
fe60: 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69  .  unixFile *pFi
fe70: 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29  le = (unixFile*)
fe80: 69 64 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49  id;.  unixInodeI
fe90: 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 20 20 73  nfo *pInode;.  s
fea0: 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b  truct flock lock
feb0: 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
fec0: 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72  ITE_OK;..  asser
fed0: 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 4f 53  t( pFile );.  OS
fee0: 54 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b 20 20  TRACE(("UNLOCK  
fef0: 25 64 20 25 64 20 77 61 73 20 25 64 28 25 64 2c  %d %d was %d(%d,
ff00: 25 64 29 20 70 69 64 3d 25 64 20 28 75 6e 69 78  %d) pid=%d (unix
ff10: 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20  )\n", pFile->h, 
ff20: 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20 20 20 20 20  eFileLock,.     
ff30: 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63   pFile->eFileLoc
ff40: 6b 2c 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65  k, pFile->pInode
ff50: 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 69  ->eFileLock, pFi
ff60: 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 53 68 61  le->pInode->nSha
ff70: 72 65 64 2c 0a 20 20 20 20 20 20 6f 73 47 65 74  red,.      osGet
ff80: 70 69 64 28 30 29 29 29 3b 0a 0a 20 20 61 73 73  pid(0)));..  ass
ff90: 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d  ert( eFileLock<=
ffa0: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20  SHARED_LOCK );. 
ffb0: 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c   if( pFile->eFil
ffc0: 65 4c 6f 63 6b 3c 3d 65 46 69 6c 65 4c 6f 63 6b  eLock<=eFileLock
ffd0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
ffe0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20  QLITE_OK;.  }.  
fff0: 70 49 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e  pInode = pFile->
10000 70 49 6e 6f 64 65 3b 0a 20 20 73 71 6c 69 74 65  pInode;.  sqlite
10010 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 49  3_mutex_enter(pI
10020 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78  node->pLockMutex
10030 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 49 6e  );.  assert( pIn
10040 6f 64 65 2d 3e 6e 53 68 61 72 65 64 21 3d 30 20  ode->nShared!=0 
10050 29 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e  );.  if( pFile->
10060 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44  eFileLock>SHARED
10070 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 61 73 73  _LOCK ){.    ass
10080 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 65 46 69  ert( pInode->eFi
10090 6c 65 4c 6f 63 6b 3d 3d 70 46 69 6c 65 2d 3e 65  leLock==pFile->e
100a0 46 69 6c 65 4c 6f 63 6b 20 29 3b 0a 0a 23 69 66  FileLock );..#if
100b0 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  def SQLITE_DEBUG
100c0 0a 20 20 20 20 2f 2a 20 57 68 65 6e 20 72 65 64  .    /* When red
100d0 75 63 69 6e 67 20 61 20 6c 6f 63 6b 20 73 75 63  ucing a lock suc
100e0 68 20 74 68 61 74 20 6f 74 68 65 72 20 70 72 6f  h that other pro
100f0 63 65 73 73 65 73 20 63 61 6e 20 73 74 61 72 74  cesses can start
10100 0a 20 20 20 20 2a 2a 20 72 65 61 64 69 6e 67 20  .    ** reading 
10110 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
10120 65 20 61 67 61 69 6e 2c 20 6d 61 6b 65 20 73 75  e again, make su
10130 72 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20  re that the.    
10140 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63  ** transaction c
10150 6f 75 6e 74 65 72 20 77 61 73 20 75 70 64 61 74  ounter was updat
10160 65 64 20 69 66 20 61 6e 79 20 70 61 72 74 20 6f  ed if any part o
10170 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20  f the database. 
10180 20 20 20 2a 2a 20 66 69 6c 65 20 63 68 61 6e 67     ** file chang
10190 65 64 2e 20 20 49 66 20 74 68 65 20 74 72 61 6e  ed.  If the tran
101a0 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20  saction counter 
101b0 69 73 20 6e 6f 74 20 75 70 64 61 74 65 64 2c 0a  is not updated,.
101c0 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 63 6f 6e      ** other con
101d0 6e 65 63 74 69 6f 6e 73 20 74 6f 20 74 68 65 20  nections to the 
101e0 73 61 6d 65 20 66 69 6c 65 20 6d 69 67 68 74 20  same file might 
101f0 6e 6f 74 20 72 65 61 6c 69 7a 65 20 74 68 61 74  not realize that
10200 0a 20 20 20 20 2a 2a 20 74 68 65 20 66 69 6c 65  .    ** the file
10210 20 68 61 73 20 63 68 61 6e 67 65 64 20 61 6e 64   has changed and
10220 20 68 65 6e 63 65 20 6d 69 67 68 74 20 6e 6f 74   hence might not
10230 20 6b 6e 6f 77 20 74 6f 20 66 6c 75 73 68 20 74   know to flush t
10240 68 65 69 72 0a 20 20 20 20 2a 2a 20 63 61 63 68  heir.    ** cach
10250 65 2e 20 20 54 68 65 20 75 73 65 20 6f 66 20 61  e.  The use of a
10260 20 73 74 61 6c 65 20 63 61 63 68 65 20 63 61 6e   stale cache can
10270 20 6c 65 61 64 20 74 6f 20 64 61 74 61 62 61 73   lead to databas
10280 65 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 20 20  e corruption..  
10290 20 20 2a 2f 0a 20 20 20 20 70 46 69 6c 65 2d 3e    */.    pFile->
102a0 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 65 20 3d 20  inNormalWrite = 
102b0 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f  0;.#endif..    /
102c0 2a 20 64 6f 77 6e 67 72 61 64 69 6e 67 20 74 6f  * downgrading to
102d0 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 6f   a shared lock o
102e0 6e 20 4e 46 53 20 69 6e 76 6f 6c 76 65 73 20 63  n NFS involves c
102f0 6c 65 61 72 69 6e 67 20 74 68 65 20 77 72 69 74  learing the writ
10300 65 20 6c 6f 63 6b 0a 20 20 20 20 2a 2a 20 62 65  e lock.    ** be
10310 66 6f 72 65 20 65 73 74 61 62 6c 69 73 68 69 6e  fore establishin
10320 67 20 74 68 65 20 72 65 61 64 6c 6f 63 6b 20 2d  g the readlock -
10330 20 74 6f 20 61 76 6f 69 64 20 61 20 72 61 63 65   to avoid a race
10340 20 63 6f 6e 64 69 74 69 6f 6e 20 77 65 20 64 6f   condition we do
10350 77 6e 67 72 61 64 65 0a 20 20 20 20 2a 2a 20 74  wngrade.    ** t
10360 68 65 20 6c 6f 63 6b 20 69 6e 20 32 20 62 6c 6f  he lock in 2 blo
10370 63 6b 73 2c 20 73 6f 20 74 68 61 74 20 70 61 72  cks, so that par
10380 74 20 6f 66 20 74 68 65 20 72 61 6e 67 65 20 77  t of the range w
10390 69 6c 6c 20 62 65 20 63 6f 76 65 72 65 64 20 62  ill be covered b
103a0 79 20 61 20 0a 20 20 20 20 2a 2a 20 77 72 69 74  y a .    ** writ
103b0 65 20 6c 6f 63 6b 20 75 6e 74 69 6c 20 74 68 65  e lock until the
103c0 20 72 65 73 74 20 69 73 20 63 6f 76 65 72 65 64   rest is covered
103d0 20 62 79 20 61 20 72 65 61 64 20 6c 6f 63 6b 3a   by a read lock:
103e0 0a 20 20 20 20 2a 2a 20 20 31 3a 20 20 20 5b 57  .    **  1:   [W
103f0 57 57 57 57 5d 0a 20 20 20 20 2a 2a 20 20 32 3a  WWWW].    **  2:
10400 20 20 20 5b 2e 2e 2e 2e 57 5d 0a 20 20 20 20 2a     [....W].    *
10410 2a 20 20 33 3a 20 20 20 5b 52 52 52 52 57 5d 0a  *  3:   [RRRRW].
10420 20 20 20 20 2a 2a 20 20 34 3a 20 20 20 5b 52 52      **  4:   [RR
10430 52 52 2e 5d 0a 20 20 20 20 2a 2f 0a 20 20 20 20  RR.].    */.    
10440 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53  if( eFileLock==S
10450 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 23 69  HARED_LOCK ){.#i
10460 66 20 21 64 65 66 69 6e 65 64 28 5f 5f 41 50 50  f !defined(__APP
10470 4c 45 5f 5f 29 20 7c 7c 20 21 53 51 4c 49 54 45  LE__) || !SQLITE
10480 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f  _ENABLE_LOCKING_
10490 53 54 59 4c 45 0a 20 20 20 20 20 20 28 76 6f 69  STYLE.      (voi
104a0 64 29 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f 63  d)handleNFSUnloc
104b0 6b 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  k;.      assert(
104c0 20 68 61 6e 64 6c 65 4e 46 53 55 6e 6c 6f 63 6b   handleNFSUnlock
104d0 3d 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69  ==0 );.#endif.#i
104e0 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c  f defined(__APPL
104f0 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45 5f 45  E__) && SQLITE_E
10500 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54  NABLE_LOCKING_ST
10510 59 4c 45 0a 20 20 20 20 20 20 69 66 28 20 68 61  YLE.      if( ha
10520 6e 64 6c 65 4e 46 53 55 6e 6c 6f 63 6b 20 29 7b  ndleNFSUnlock ){
10530 0a 20 20 20 20 20 20 20 20 69 6e 74 20 74 45 72  .        int tEr
10540 72 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20  rno;            
10550 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65     /* Error code
10560 20 66 72 6f 6d 20 73 79 73 74 65 6d 20 63 61 6c   from system cal
10570 6c 20 65 72 72 6f 72 73 20 2a 2f 0a 20 20 20 20  l errors */.    
10580 20 20 20 20 6f 66 66 5f 74 20 64 69 76 53 69 7a      off_t divSiz
10590 65 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45 20  e = SHARED_SIZE 
105a0 2d 20 31 3b 0a 20 20 20 20 20 20 20 20 0a 20 20  - 1;.        .  
105b0 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70        lock.l_typ
105c0 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20  e = F_UNLCK;.   
105d0 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e       lock.l_when
105e0 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20  ce = SEEK_SET;. 
105f0 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74         lock.l_st
10600 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52  art = SHARED_FIR
10610 53 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b  ST;.        lock
10620 2e 6c 5f 6c 65 6e 20 3d 20 64 69 76 53 69 7a 65  .l_len = divSize
10630 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 75 6e  ;.        if( un
10640 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c 65  ixFileLock(pFile
10650 2c 20 26 6c 6f 63 6b 29 3d 3d 28 2d 31 29 20 29  , &lock)==(-1) )
10660 7b 0a 20 20 20 20 20 20 20 20 20 20 74 45 72 72  {.          tErr
10670 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20  no = errno;.    
10680 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54        rc = SQLIT
10690 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b 0a  E_IOERR_UNLOCK;.
106a0 20 20 20 20 20 20 20 20 20 20 73 74 6f 72 65 4c            storeL
106b0 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20  astErrno(pFile, 
106c0 74 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 20  tErrno);.       
106d0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 75 6e 6c 6f     goto end_unlo
106e0 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ck;.        }.  
106f0 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70        lock.l_typ
10700 65 20 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 20  e = F_RDLCK;.   
10710 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e       lock.l_when
10720 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20  ce = SEEK_SET;. 
10730 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74         lock.l_st
10740 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52  art = SHARED_FIR
10750 53 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b  ST;.        lock
10760 2e 6c 5f 6c 65 6e 20 3d 20 64 69 76 53 69 7a 65  .l_len = divSize
10770 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 75 6e  ;.        if( un
10780 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c 65  ixFileLock(pFile
10790 2c 20 26 6c 6f 63 6b 29 3d 3d 28 2d 31 29 20 29  , &lock)==(-1) )
107a0 7b 0a 20 20 20 20 20 20 20 20 20 20 74 45 72 72  {.          tErr
107b0 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20  no = errno;.    
107c0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
107d0 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45  eErrorFromPosixE
107e0 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c  rror(tErrno, SQL
107f0 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b  ITE_IOERR_RDLOCK
10800 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  );.          if(
10810 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 72   IS_LOCK_ERROR(r
10820 63 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  c) ){.          
10830 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f    storeLastErrno
10840 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b  (pFile, tErrno);
10850 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20  .          }.   
10860 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f         goto end_
10870 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 20 20  unlock;.        
10880 7d 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c  }.        lock.l
10890 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b  _type = F_UNLCK;
108a0 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f  .        lock.l_
108b0 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45  whence = SEEK_SE
108c0 54 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e  T;.        lock.
108d0 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52 45 44  l_start = SHARED
108e0 5f 46 49 52 53 54 2b 64 69 76 53 69 7a 65 3b 0a  _FIRST+divSize;.
108f0 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c          lock.l_l
10900 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45  en = SHARED_SIZE
10910 2d 64 69 76 53 69 7a 65 3b 0a 20 20 20 20 20 20  -divSize;.      
10920 20 20 69 66 28 20 75 6e 69 78 46 69 6c 65 4c 6f    if( unixFileLo
10930 63 6b 28 70 46 69 6c 65 2c 20 26 6c 6f 63 6b 29  ck(pFile, &lock)
10940 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 20 20  ==(-1) ){.      
10950 20 20 20 20 74 45 72 72 6e 6f 20 3d 20 65 72 72      tErrno = err
10960 6e 6f 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63  no;.          rc
10970 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f   = SQLITE_IOERR_
10980 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20  UNLOCK;.        
10990 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f    storeLastErrno
109a0 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b  (pFile, tErrno);
109b0 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20  .          goto 
109c0 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20 20  end_unlock;.    
109d0 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73      }.      }els
109e0 65 0a 23 65 6e 64 69 66 20 2f 2a 20 64 65 66 69  e.#endif /* defi
109f0 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26  ned(__APPLE__) &
10a00 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  & SQLITE_ENABLE_
10a10 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 2a 2f  LOCKING_STYLE */
10a20 0a 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 20  .      {.       
10a30 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46   lock.l_type = F
10a40 5f 52 44 4c 43 4b 3b 0a 20 20 20 20 20 20 20 20  _RDLCK;.        
10a50 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20  lock.l_whence = 
10a60 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20  SEEK_SET;.      
10a70 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d    lock.l_start =
10a80 20 53 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20   SHARED_FIRST;. 
10a90 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65         lock.l_le
10aa0 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45 3b  n = SHARED_SIZE;
10ab0 0a 20 20 20 20 20 20 20 20 69 66 28 20 75 6e 69  .        if( uni
10ac0 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 2c  xFileLock(pFile,
10ad0 20 26 6c 6f 63 6b 29 20 29 7b 0a 20 20 20 20 20   &lock) ){.     
10ae0 20 20 20 20 20 2f 2a 20 49 6e 20 74 68 65 6f 72       /* In theor
10af0 79 2c 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 75  y, the call to u
10b00 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 29 20 63 61  nixFileLock() ca
10b10 6e 6e 6f 74 20 66 61 69 6c 20 62 65 63 61 75 73  nnot fail becaus
10b20 65 20 61 6e 6f 74 68 65 72 0a 20 20 20 20 20 20  e another.      
10b30 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 69      ** process i
10b40 73 20 68 6f 6c 64 69 6e 67 20 61 6e 20 69 6e 63  s holding an inc
10b50 6f 6d 70 61 74 69 62 6c 65 20 6c 6f 63 6b 2e 20  ompatible lock. 
10b60 49 66 20 69 74 20 64 6f 65 73 2c 20 74 68 69 73  If it does, this
10b70 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 69   .          ** i
10b80 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68  ndicates that th
10b90 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20  e other process 
10ba0 69 73 20 6e 6f 74 20 66 6f 6c 6c 6f 77 69 6e 67  is not following
10bb0 20 74 68 65 20 6c 6f 63 6b 69 6e 67 0a 20 20 20   the locking.   
10bc0 20 20 20 20 20 20 20 2a 2a 20 70 72 6f 74 6f 63         ** protoc
10bd0 6f 6c 2e 20 49 66 20 74 68 69 73 20 68 61 70 70  ol. If this happ
10be0 65 6e 73 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  ens, return SQLI
10bf0 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43 4b 2e  TE_IOERR_RDLOCK.
10c00 20 52 65 74 75 72 6e 69 6e 67 0a 20 20 20 20 20   Returning.     
10c10 20 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 42       ** SQLITE_B
10c20 55 53 59 20 77 6f 75 6c 64 20 63 6f 6e 66 75 73  USY would confus
10c30 65 20 74 68 65 20 75 70 70 65 72 20 6c 61 79 65  e the upper laye
10c40 72 20 28 69 6e 20 70 72 61 63 74 69 63 65 20 69  r (in practice i
10c50 74 20 63 61 75 73 65 73 20 0a 20 20 20 20 20 20  t causes .      
10c60 20 20 20 20 2a 2a 20 61 6e 20 61 73 73 65 72 74      ** an assert
10c70 20 74 6f 20 66 61 69 6c 29 2e 20 2a 2f 20 0a 20   to fail). */ . 
10c80 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51           rc = SQ
10c90 4c 49 54 45 5f 49 4f 45 52 52 5f 52 44 4c 4f 43  LITE_IOERR_RDLOC
10ca0 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 73 74 6f  K;.          sto
10cb0 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c  reLastErrno(pFil
10cc0 65 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 20  e, errno);.     
10cd0 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 75 6e       goto end_un
10ce0 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a  lock;.        }.
10cf0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
10d00 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20    lock.l_type = 
10d10 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20 20 6c 6f 63  F_UNLCK;.    loc
10d20 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45  k.l_whence = SEE
10d30 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f 63 6b 2e  K_SET;.    lock.
10d40 6c 5f 73 74 61 72 74 20 3d 20 50 45 4e 44 49 4e  l_start = PENDIN
10d50 47 5f 42 59 54 45 3b 0a 20 20 20 20 6c 6f 63 6b  G_BYTE;.    lock
10d60 2e 6c 5f 6c 65 6e 20 3d 20 32 4c 3b 20 20 61 73  .l_len = 2L;  as
10d70 73 65 72 74 28 20 50 45 4e 44 49 4e 47 5f 42 59  sert( PENDING_BY
10d80 54 45 2b 31 3d 3d 52 45 53 45 52 56 45 44 5f 42  TE+1==RESERVED_B
10d90 59 54 45 20 29 3b 0a 20 20 20 20 69 66 28 20 75  YTE );.    if( u
10da0 6e 69 78 46 69 6c 65 4c 6f 63 6b 28 70 46 69 6c  nixFileLock(pFil
10db0 65 2c 20 26 6c 6f 63 6b 29 3d 3d 30 20 29 7b 0a  e, &lock)==0 ){.
10dc0 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46        pInode->eF
10dd0 69 6c 65 4c 6f 63 6b 20 3d 20 53 48 41 52 45 44  ileLock = SHARED
10de0 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d 65 6c 73 65  _LOCK;.    }else
10df0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c  {.      rc = SQL
10e00 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b  ITE_IOERR_UNLOCK
10e10 3b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73  ;.      storeLas
10e20 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72  tErrno(pFile, er
10e30 72 6e 6f 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f  rno);.      goto
10e40 20 65 6e 64 5f 75 6e 6c 6f 63 6b 3b 0a 20 20 20   end_unlock;.   
10e50 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 65 46 69   }.  }.  if( eFi
10e60 6c 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20  leLock==NO_LOCK 
10e70 29 7b 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d  ){.    /* Decrem
10e80 65 6e 74 20 74 68 65 20 73 68 61 72 65 64 20 6c  ent the shared l
10e90 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20 20 52 65  ock counter.  Re
10ea0 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b 20 75  lease the lock u
10eb0 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a 20 4f  sing an.    ** O
10ec0 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77 68 65 6e  S call only when
10ed0 20 61 6c 6c 20 74 68 72 65 61 64 73 20 69 6e 20   all threads in 
10ee0 74 68 69 73 20 73 61 6d 65 20 70 72 6f 63 65 73  this same proces
10ef0 73 20 68 61 76 65 20 72 65 6c 65 61 73 65 64 0a  s have released.
10f00 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b 2e      ** the lock.
10f10 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 49 6e 6f  .    */.    pIno
10f20 64 65 2d 3e 6e 53 68 61 72 65 64 2d 2d 3b 0a 20  de->nShared--;. 
10f30 20 20 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 6e     if( pInode->n
10f40 53 68 61 72 65 64 3d 3d 30 20 29 7b 0a 20 20 20  Shared==0 ){.   
10f50 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d     lock.l_type =
10f60 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20 20 20 20   F_UNLCK;.      
10f70 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20  lock.l_whence = 
10f80 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 20 20  SEEK_SET;.      
10f90 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 6c  lock.l_start = l
10fa0 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 30 4c 3b 0a  ock.l_len = 0L;.
10fb0 20 20 20 20 20 20 69 66 28 20 75 6e 69 78 46 69        if( unixFi
10fc0 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 2c 20 26 6c  leLock(pFile, &l
10fd0 6f 63 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  ock)==0 ){.     
10fe0 20 20 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65     pInode->eFile
10ff0 4c 6f 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a  Lock = NO_LOCK;.
11000 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
11010 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
11020 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b 0a 20  _IOERR_UNLOCK;. 
11030 20 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74         storeLast
11040 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72  Errno(pFile, err
11050 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 70 49 6e  no);.        pIn
11060 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d  ode->eFileLock =
11070 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20   NO_LOCK;.      
11080 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f    pFile->eFileLo
11090 63 6b 20 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20  ck = NO_LOCK;.  
110a0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20      }.    }..   
110b0 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 68   /* Decrement th
110c0 65 20 63 6f 75 6e 74 20 6f 66 20 6c 6f 63 6b 73  e count of locks
110d0 20 61 67 61 69 6e 73 74 20 74 68 69 73 20 73 61   against this sa
110e0 6d 65 20 66 69 6c 65 2e 20 20 57 68 65 6e 20 74  me file.  When t
110f0 68 65 0a 20 20 20 20 2a 2a 20 63 6f 75 6e 74 20  he.    ** count 
11100 72 65 61 63 68 65 73 20 7a 65 72 6f 2c 20 63 6c  reaches zero, cl
11110 6f 73 65 20 61 6e 79 20 6f 74 68 65 72 20 66 69  ose any other fi
11120 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 77  le descriptors w
11130 68 6f 73 65 20 63 6c 6f 73 65 0a 20 20 20 20 2a  hose close.    *
11140 2a 20 77 61 73 20 64 65 66 65 72 72 65 64 20 62  * was deferred b
11150 65 63 61 75 73 65 20 6f 66 20 6f 75 74 73 74 61  ecause of outsta
11160 6e 64 69 6e 67 20 6c 6f 63 6b 73 2e 0a 20 20 20  nding locks..   
11170 20 2a 2f 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e   */.    pInode->
11180 6e 4c 6f 63 6b 2d 2d 3b 0a 20 20 20 20 61 73 73  nLock--;.    ass
11190 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f  ert( pInode->nLo
111a0 63 6b 3e 3d 30 20 29 3b 0a 20 20 20 20 69 66 28  ck>=0 );.    if(
111b0 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 3d 3d   pInode->nLock==
111c0 30 20 29 20 63 6c 6f 73 65 50 65 6e 64 69 6e 67  0 ) closePending
111d0 46 64 73 28 70 46 69 6c 65 29 3b 0a 20 20 7d 0a  Fds(pFile);.  }.
111e0 0a 65 6e 64 5f 75 6e 6c 6f 63 6b 3a 0a 20 20 73  .end_unlock:.  s
111f0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
11200 76 65 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b  ve(pInode->pLock
11210 4d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 72 63  Mutex);.  if( rc
11220 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
11230 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c     pFile->eFileL
11240 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b  ock = eFileLock;
11250 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
11260 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72  ;.}../*.** Lower
11270 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76   the locking lev
11280 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72  el on file descr
11290 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65  iptor pFile to e
112a0 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65  FileLock.  eFile
112b0 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20  Lock.** must be 
112c0 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f  either NO_LOCK o
112d0 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a  r SHARED_LOCK..*
112e0 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b  *.** If the lock
112f0 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65  ing level of the
11300 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
11310 20 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f   is already at o
11320 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72  r below.** the r
11330 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67  equested locking
11340 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75   level, this rou
11350 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  tine is a no-op.
11360 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
11370 6e 69 78 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65  nixUnlock(sqlite
11380 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20  3_file *id, int 
11390 65 46 69 6c 65 4c 6f 63 6b 29 7b 0a 23 69 66 20  eFileLock){.#if 
113a0 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f  SQLITE_MAX_MMAP_
113b0 53 49 5a 45 3e 30 0a 20 20 61 73 73 65 72 74 28  SIZE>0.  assert(
113c0 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52   eFileLock==SHAR
113d0 45 44 5f 4c 4f 43 4b 20 7c 7c 20 28 28 75 6e 69  ED_LOCK || ((uni
113e0 78 46 69 6c 65 20 2a 29 69 64 29 2d 3e 6e 46 65  xFile *)id)->nFe
113f0 74 63 68 4f 75 74 3d 3d 30 20 29 3b 0a 23 65 6e  tchOut==0 );.#en
11400 64 69 66 0a 20 20 72 65 74 75 72 6e 20 70 6f 73  dif.  return pos
11410 69 78 55 6e 6c 6f 63 6b 28 69 64 2c 20 65 46 69  ixUnlock(id, eFi
11420 6c 65 4c 6f 63 6b 2c 20 30 29 3b 0a 7d 0a 0a 23  leLock, 0);.}..#
11430 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d  if SQLITE_MAX_MM
11440 41 50 5f 53 49 5a 45 3e 30 0a 73 74 61 74 69 63  AP_SIZE>0.static
11450 20 69 6e 74 20 75 6e 69 78 4d 61 70 66 69 6c 65   int unixMapfile
11460 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 64 2c 20  (unixFile *pFd, 
11470 69 36 34 20 6e 42 79 74 65 29 3b 0a 73 74 61 74  i64 nByte);.stat
11480 69 63 20 76 6f 69 64 20 75 6e 69 78 55 6e 6d 61  ic void unixUnma
11490 70 66 69 6c 65 28 75 6e 69 78 46 69 6c 65 20 2a  pfile(unixFile *
114a0 70 46 64 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a  pFd);.#endif../*
114b0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
114c0 6e 20 70 65 72 66 6f 72 6d 73 20 74 68 65 20 70  n performs the p
114d0 61 72 74 73 20 6f 66 20 74 68 65 20 22 63 6c 6f  arts of the "clo
114e0 73 65 20 66 69 6c 65 22 20 6f 70 65 72 61 74 69  se file" operati
114f0 6f 6e 20 0a 2a 2a 20 63 6f 6d 6d 6f 6e 20 74 6f  on .** common to
11500 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 73 63 68   all locking sch
11510 65 6d 65 73 2e 20 49 74 20 63 6c 6f 73 65 73 20  emes. It closes 
11520 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 61 6e  the directory an
11530 64 20 66 69 6c 65 0a 2a 2a 20 68 61 6e 64 6c 65  d file.** handle
11540 73 2c 20 69 66 20 74 68 65 79 20 61 72 65 20 76  s, if they are v
11550 61 6c 69 64 2c 20 61 6e 64 20 73 65 74 73 20 61  alid, and sets a
11560 6c 6c 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65  ll fields of the
11570 20 75 6e 69 78 46 69 6c 65 0a 2a 2a 20 73 74 72   unixFile.** str
11580 75 63 74 75 72 65 20 74 6f 20 30 2e 0a 2a 2a 0a  ucture to 0..**.
11590 2a 2a 20 49 74 20 69 73 20 2a 6e 6f 74 2a 20 6e  ** It is *not* n
115a0 65 63 65 73 73 61 72 79 20 74 6f 20 68 6f 6c 64  ecessary to hold
115b0 20 74 68 65 20 6d 75 74 65 78 20 77 68 65 6e 20   the mutex when 
115c0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
115d0 63 61 6c 6c 65 64 2c 0a 2a 2a 20 65 76 65 6e 20  called,.** even 
115e0 6f 6e 20 56 78 57 6f 72 6b 73 2e 20 20 41 20 6d  on VxWorks.  A m
115f0 75 74 65 78 20 77 69 6c 6c 20 62 65 20 61 63 71  utex will be acq
11600 75 69 72 65 64 20 6f 6e 20 56 78 57 6f 72 6b 73  uired on VxWorks
11610 20 62 79 20 74 68 65 0a 2a 2a 20 76 78 77 6f 72   by the.** vxwor
11620 6b 73 52 65 6c 65 61 73 65 46 69 6c 65 49 64 28  ksReleaseFileId(
11630 29 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74  ) routine..*/.st
11640 61 74 69 63 20 69 6e 74 20 63 6c 6f 73 65 55 6e  atic int closeUn
11650 69 78 46 69 6c 65 28 73 71 6c 69 74 65 33 5f 66  ixFile(sqlite3_f
11660 69 6c 65 20 2a 69 64 29 7b 0a 20 20 75 6e 69 78  ile *id){.  unix
11670 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75  File *pFile = (u
11680 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 23 69 66  nixFile*)id;.#if
11690 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50   SQLITE_MAX_MMAP
116a0 5f 53 49 5a 45 3e 30 0a 20 20 75 6e 69 78 55 6e  _SIZE>0.  unixUn
116b0 6d 61 70 66 69 6c 65 28 70 46 69 6c 65 29 3b 0a  mapfile(pFile);.
116c0 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 46 69  #endif.  if( pFi
116d0 6c 65 2d 3e 68 3e 3d 30 20 29 7b 0a 20 20 20 20  le->h>=0 ){.    
116e0 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 46 69  robust_close(pFi
116f0 6c 65 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 5f 5f  le, pFile->h, __
11700 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 70 46 69  LINE__);.    pFi
11710 6c 65 2d 3e 68 20 3d 20 2d 31 3b 0a 20 20 7d 0a  le->h = -1;.  }.
11720 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20  #if OS_VXWORKS. 
11730 20 69 66 28 20 70 46 69 6c 65 2d 3e 70 49 64 20   if( pFile->pId 
11740 29 7b 0a 20 20 20 20 69 66 28 20 70 46 69 6c 65  ){.    if( pFile
11750 2d 3e 63 74 72 6c 46 6c 61 67 73 20 26 20 55 4e  ->ctrlFlags & UN
11760 49 58 46 49 4c 45 5f 44 45 4c 45 54 45 20 29 7b  IXFILE_DELETE ){
11770 0a 20 20 20 20 20 20 6f 73 55 6e 6c 69 6e 6b 28  .      osUnlink(
11780 70 46 69 6c 65 2d 3e 70 49 64 2d 3e 7a 43 61 6e  pFile->pId->zCan
11790 6f 6e 69 63 61 6c 4e 61 6d 65 29 3b 0a 20 20 20  onicalName);.   
117a0 20 7d 0a 20 20 20 20 76 78 77 6f 72 6b 73 52 65   }.    vxworksRe
117b0 6c 65 61 73 65 46 69 6c 65 49 64 28 70 46 69 6c  leaseFileId(pFil
117c0 65 2d 3e 70 49 64 29 3b 0a 20 20 20 20 70 46 69  e->pId);.    pFi
117d0 6c 65 2d 3e 70 49 64 20 3d 20 30 3b 0a 20 20 7d  le->pId = 0;.  }
117e0 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53  .#endif.#ifdef S
117f0 51 4c 49 54 45 5f 55 4e 4c 49 4e 4b 5f 41 46 54  QLITE_UNLINK_AFT
11800 45 52 5f 43 4c 4f 53 45 0a 20 20 69 66 28 20 70  ER_CLOSE.  if( p
11810 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 73 20  File->ctrlFlags 
11820 26 20 55 4e 49 58 46 49 4c 45 5f 44 45 4c 45 54  & UNIXFILE_DELET
11830 45 20 29 7b 0a 20 20 20 20 6f 73 55 6e 6c 69 6e  E ){.    osUnlin
11840 6b 28 70 46 69 6c 65 2d 3e 7a 50 61 74 68 29 3b  k(pFile->zPath);
11850 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65  .    sqlite3_fre
11860 65 28 2a 28 63 68 61 72 2a 2a 29 26 70 46 69 6c  e(*(char**)&pFil
11870 65 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 20 20 70  e->zPath);.    p
11880 46 69 6c 65 2d 3e 7a 50 61 74 68 20 3d 20 30 3b  File->zPath = 0;
11890 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 4f 53  .  }.#endif.  OS
118a0 54 52 41 43 45 28 28 22 43 4c 4f 53 45 20 20 20  TRACE(("CLOSE   
118b0 25 2d 33 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e  %-3d\n", pFile->
118c0 68 29 29 3b 0a 20 20 4f 70 65 6e 43 6f 75 6e 74  h));.  OpenCount
118d0 65 72 28 2d 31 29 3b 0a 20 20 73 71 6c 69 74 65  er(-1);.  sqlite
118e0 33 5f 66 72 65 65 28 70 46 69 6c 65 2d 3e 70 50  3_free(pFile->pP
118f0 72 65 61 6c 6c 6f 63 61 74 65 64 55 6e 75 73 65  reallocatedUnuse
11900 64 29 3b 0a 20 20 6d 65 6d 73 65 74 28 70 46 69  d);.  memset(pFi
11910 6c 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 75 6e  le, 0, sizeof(un
11920 69 78 46 69 6c 65 29 29 3b 0a 20 20 72 65 74 75  ixFile));.  retu
11930 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
11940 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66  ./*.** Close a f
11950 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
11960 6e 74 20 75 6e 69 78 43 6c 6f 73 65 28 73 71 6c  nt unixClose(sql
11970 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 29 7b 0a  ite3_file *id){.
11980 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
11990 45 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65  E_OK;.  unixFile
119a0 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46   *pFile = (unixF
119b0 69 6c 65 20 2a 29 69 64 3b 0a 20 20 75 6e 69 78  ile *)id;.  unix
119c0 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64  InodeInfo *pInod
119d0 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64  e = pFile->pInod
119e0 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 49  e;..  assert( pI
119f0 6e 6f 64 65 21 3d 30 20 29 3b 0a 20 20 76 65 72  node!=0 );.  ver
11a00 69 66 79 44 62 46 69 6c 65 28 70 46 69 6c 65 29  ifyDbFile(pFile)
11a10 3b 0a 20 20 75 6e 69 78 55 6e 6c 6f 63 6b 28 69  ;.  unixUnlock(i
11a20 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 61  d, NO_LOCK);.  a
11a30 73 73 65 72 74 28 20 75 6e 69 78 46 69 6c 65 4d  ssert( unixFileM
11a40 75 74 65 78 4e 6f 74 68 65 6c 64 28 70 46 69 6c  utexNotheld(pFil
11a50 65 29 20 29 3b 0a 20 20 75 6e 69 78 45 6e 74 65  e) );.  unixEnte
11a60 72 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20  rMutex();..  /* 
11a70 75 6e 69 78 46 69 6c 65 2e 70 49 6e 6f 64 65 20  unixFile.pInode 
11a80 69 73 20 61 6c 77 61 79 73 20 76 61 6c 69 64 20  is always valid 
11a90 68 65 72 65 2e 20 4f 74 68 65 72 77 69 73 65 2c  here. Otherwise,
11aa0 20 61 20 64 69 66 66 65 72 65 6e 74 20 63 6c 6f   a different clo
11ab0 73 65 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 20  se.  ** routine 
11ac0 28 65 2e 67 2e 20 6e 6f 6c 6f 63 6b 43 6c 6f 73  (e.g. nolockClos
11ad0 65 28 29 29 20 77 6f 75 6c 64 20 62 65 20 63 61  e()) would be ca
11ae0 6c 6c 65 64 20 69 6e 73 74 65 61 64 2e 0a 20 20  lled instead..  
11af0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 46 69  */.  assert( pFi
11b00 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63  le->pInode->nLoc
11b10 6b 3e 30 20 7c 7c 20 70 46 69 6c 65 2d 3e 70 49  k>0 || pFile->pI
11b20 6e 6f 64 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f  node->bProcessLo
11b30 63 6b 3d 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74  ck==0 );.  sqlit
11b40 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
11b50 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65  Inode->pLockMute
11b60 78 29 3b 0a 20 20 69 66 28 20 70 49 6e 6f 64 65  x);.  if( pInode
11b70 2d 3e 6e 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 2f  ->nLock ){.    /
11b80 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f  * If there are o
11b90 75 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73  utstanding locks
11ba0 2c 20 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c  , do not actuall
11bb0 79 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65  y close the file
11bc0 20 6a 75 73 74 0a 20 20 20 20 2a 2a 20 79 65 74   just.    ** yet
11bd0 20 62 65 63 61 75 73 65 20 74 68 61 74 20 77 6f   because that wo
11be0 75 6c 64 20 63 6c 65 61 72 20 74 68 6f 73 65 20  uld clear those 
11bf0 6c 6f 63 6b 73 2e 20 20 49 6e 73 74 65 61 64 2c  locks.  Instead,
11c00 20 61 64 64 20 74 68 65 20 66 69 6c 65 0a 20 20   add the file.  
11c10 20 20 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20    ** descriptor 
11c20 74 6f 20 70 49 6e 6f 64 65 2d 3e 70 55 6e 75 73  to pInode->pUnus
11c30 65 64 20 6c 69 73 74 2e 20 20 49 74 20 77 69 6c  ed list.  It wil
11c40 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c  l be automatical
11c50 6c 79 20 63 6c 6f 73 65 64 20 0a 20 20 20 20 2a  ly closed .    *
11c60 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20  * when the last 
11c70 6c 6f 63 6b 20 69 73 20 63 6c 65 61 72 65 64 2e  lock is cleared.
11c80 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 65 74 50  .    */.    setP
11c90 65 6e 64 69 6e 67 46 64 28 70 46 69 6c 65 29 3b  endingFd(pFile);
11ca0 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d  .  }.  sqlite3_m
11cb0 75 74 65 78 5f 6c 65 61 76 65 28 70 49 6e 6f 64  utex_leave(pInod
11cc0 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a  e->pLockMutex);.
11cd0 20 20 72 65 6c 65 61 73 65 49 6e 6f 64 65 49 6e    releaseInodeIn
11ce0 66 6f 28 70 46 69 6c 65 29 3b 0a 20 20 72 63 20  fo(pFile);.  rc 
11cf0 3d 20 63 6c 6f 73 65 55 6e 69 78 46 69 6c 65 28  = closeUnixFile(
11d00 69 64 29 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65  id);.  unixLeave
11d10 4d 75 74 65 78 28 29 3b 0a 20 20 72 65 74 75 72  Mutex();.  retur
11d20 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a  n rc;.}../******
11d30 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20  ******** End of 
11d40 74 68 65 20 70 6f 73 69 78 20 61 64 76 69 73 6f  the posix adviso
11d50 72 79 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e  ry lock implemen
11d60 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  tation *********
11d70 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a  ********.*******
11d80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11d90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11da0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11db0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11dc0 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a  *******/../*****
11dd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11de0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11df0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11e00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11e10 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a  *********.******
11e20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11e30 2a 2a 2a 2a 2a 2a 2a 2a 20 4e 6f 2d 6f 70 20 4c  ******** No-op L
11e40 6f 63 6b 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  ocking *********
11e50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
11e60 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20  *********.**.** 
11e70 4f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20 6c  Of the various l
11e80 6f 63 6b 69 6e 67 20 69 6d 70 6c 65 6d 65 6e 74  ocking implement
11e90 61 74 69 6f 6e 73 20 61 76 61 69 6c 61 62 6c 65  ations available
11ea0 2c 20 74 68 69 73 20 69 73 20 62 79 20 66 61 72  , this is by far
11eb0 20 74 68 65 0a 2a 2a 20 73 69 6d 70 6c 65 73 74   the.** simplest
11ec0 3a 20 20 6c 6f 63 6b 69 6e 67 20 69 73 20 69 67  :  locking is ig
11ed0 6e 6f 72 65 64 2e 20 20 4e 6f 20 61 74 74 65 6d  nored.  No attem
11ee0 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 6c 6f  pt is made to lo
11ef0 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  ck the database.
11f00 2a 2a 20 66 69 6c 65 20 66 6f 72 20 72 65 61 64  ** file for read
11f10 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 2e 0a  ing or writing..
11f20 2a 2a 0a 2a 2a 20 54 68 69 73 20 6c 6f 63 6b 69  **.** This locki
11f30 6e 67 20 6d 6f 64 65 20 69 73 20 61 70 70 72 6f  ng mode is appro
11f40 70 72 69 61 74 65 20 66 6f 72 20 75 73 65 20 6f  priate for use o
11f50 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74 61  n read-only data
11f60 62 61 73 65 73 0a 2a 2a 20 28 65 78 3a 20 64 61  bases.** (ex: da
11f70 74 61 62 61 73 65 73 20 74 68 61 74 20 61 72 65  tabases that are
11f80 20 62 75 72 6e 65 64 20 69 6e 74 6f 20 43 44 2d   burned into CD-
11f90 52 4f 4d 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65  ROM, for example
11fa0 2e 29 20 20 49 74 20 63 61 6e 0a 2a 2a 20 61 6c  .)  It can.** al
11fb0 73 6f 20 62 65 20 75 73 65 64 20 69 66 20 74 68  so be used if th
11fc0 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 65 6d  e application em
11fd0 70 6c 6f 79 73 20 73 6f 6d 65 20 65 78 74 65 72  ploys some exter
11fe0 6e 61 6c 20 6d 65 63 68 61 6e 69 73 6d 20 74 6f  nal mechanism to
11ff0 0a 2a 2a 20 70 72 65 76 65 6e 74 20 73 69 6d 75  .** prevent simu
12000 6c 74 61 6e 65 6f 75 73 20 61 63 63 65 73 73 20  ltaneous access 
12010 6f 66 20 74 68 65 20 73 61 6d 65 20 64 61 74 61  of the same data
12020 62 61 73 65 20 62 79 20 74 77 6f 20 6f 72 20 6d  base by two or m
12030 6f 72 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20  ore.** database 
12040 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 20 42 75  connections.  Bu
12050 74 20 74 68 65 72 65 20 69 73 20 61 20 73 65 72  t there is a ser
12060 69 6f 75 73 20 72 69 73 6b 20 6f 66 20 64 61 74  ious risk of dat
12070 61 62 61 73 65 0a 2a 2a 20 63 6f 72 72 75 70 74  abase.** corrupt
12080 69 6f 6e 20 69 66 20 74 68 69 73 20 6c 6f 63 6b  ion if this lock
12090 69 6e 67 20 6d 6f 64 65 20 69 73 20 75 73 65 64  ing mode is used
120a0 20 69 6e 20 73 69 74 75 61 74 69 6f 6e 73 20 77   in situations w
120b0 68 65 72 65 20 6d 75 6c 74 69 70 6c 65 0a 2a 2a  here multiple.**
120c0 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
120d0 74 69 6f 6e 73 20 61 72 65 20 61 63 63 65 73 73  tions are access
120e0 69 6e 67 20 74 68 65 20 73 61 6d 65 20 64 61 74  ing the same dat
120f0 61 62 61 73 65 20 66 69 6c 65 20 61 74 20 74 68  abase file at th
12100 65 20 73 61 6d 65 0a 2a 2a 20 74 69 6d 65 20 61  e same.** time a
12110 6e 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f  nd one or more o
12120 66 20 74 68 6f 73 65 20 63 6f 6e 6e 65 63 74 69  f those connecti
12130 6f 6e 73 20 61 72 65 20 77 72 69 74 69 6e 67 2e  ons are writing.
12140 0a 2a 2f 0a 0a 73 74 61 74 69 63 20 69 6e 74 20  .*/..static int 
12150 6e 6f 6c 6f 63 6b 43 68 65 63 6b 52 65 73 65 72  nolockCheckReser
12160 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f  vedLock(sqlite3_
12170 66 69 6c 65 20 2a 4e 6f 74 55 73 65 64 2c 20 69  file *NotUsed, i
12180 6e 74 20 2a 70 52 65 73 4f 75 74 29 7b 0a 20 20  nt *pResOut){.  
12190 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
121a0 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 2a 70 52  (NotUsed);.  *pR
121b0 65 73 4f 75 74 20 3d 20 30 3b 0a 20 20 72 65 74  esOut = 0;.  ret
121c0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
121d0 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 6c 6f  .static int nolo
121e0 63 6b 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66  ckLock(sqlite3_f
121f0 69 6c 65 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e  ile *NotUsed, in
12200 74 20 4e 6f 74 55 73 65 64 32 29 7b 0a 20 20 55  t NotUsed2){.  U
12210 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32  NUSED_PARAMETER2
12220 28 4e 6f 74 55 73 65 64 2c 20 4e 6f 74 55 73 65  (NotUsed, NotUse
12230 64 32 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  d2);.  return SQ
12240 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 73 74 61 74 69  LITE_OK;.}.stati
12250 63 20 69 6e 74 20 6e 6f 6c 6f 63 6b 55 6e 6c 6f  c int nolockUnlo
12260 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  ck(sqlite3_file 
12270 2a 4e 6f 74 55 73 65 64 2c 20 69 6e 74 20 4e 6f  *NotUsed, int No
12280 74 55 73 65 64 32 29 7b 0a 20 20 55 4e 55 53 45  tUsed2){.  UNUSE
12290 44 5f 50 41 52 41 4d 45 54 45 52 32 28 4e 6f 74  D_PARAMETER2(Not
122a0 55 73 65 64 2c 20 4e 6f 74 55 73 65 64 32 29 3b  Used, NotUsed2);
122b0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
122c0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  _OK;.}../*.** Cl
122d0 6f 73 65 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2f  ose the file..*/
122e0 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 6f 6c 6f  .static int nolo
122f0 63 6b 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f  ckClose(sqlite3_
12300 66 69 6c 65 20 2a 69 64 29 20 7b 0a 20 20 72 65  file *id) {.  re
12310 74 75 72 6e 20 63 6c 6f 73 65 55 6e 69 78 46 69  turn closeUnixFi
12320 6c 65 28 69 64 29 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a  le(id);.}../****
12330 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20  *************** 
12340 45 6e 64 20 6f 66 20 74 68 65 20 6e 6f 2d 6f 70  End of the no-op
12350 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61   lock implementa
12360 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  tion ***********
12370 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a  **********.*****
12380 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12390 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
123a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
123b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
123c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a  *********/../***
123d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
123e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
123f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12400 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12410 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a  ***********.****
12420 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12430 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 64 6f 74 2d  ***** Begin dot-
12440 66 69 6c 65 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a  file Locking ***
12450 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12460 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a  ***********.**.*
12470 2a 20 54 68 65 20 64 6f 74 66 69 6c 65 20 6c 6f  * The dotfile lo
12480 63 6b 69 6e 67 20 69 6d 70 6c 65 6d 65 6e 74 61  cking implementa
12490 74 69 6f 6e 20 75 73 65 73 20 74 68 65 20 65 78  tion uses the ex
124a0 69 73 74 65 6e 63 65 20 6f 66 20 73 65 70 61 72  istence of separ
124b0 61 74 65 20 6c 6f 63 6b 0a 2a 2a 20 66 69 6c 65  ate lock.** file
124c0 73 20 28 72 65 61 6c 6c 79 20 61 20 64 69 72 65  s (really a dire
124d0 63 74 6f 72 79 29 20 74 6f 20 63 6f 6e 74 72 6f  ctory) to contro
124e0 6c 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20  l access to the 
124f0 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 20  database.  This 
12500 77 6f 72 6b 73 0a 2a 2a 20 6f 6e 20 6a 75 73 74  works.** on just
12510 20 61 62 6f 75 74 20 65 76 65 72 79 20 66 69 6c   about every fil
12520 65 73 79 73 74 65 6d 20 69 6d 61 67 69 6e 61 62  esystem imaginab
12530 6c 65 2e 20 20 42 75 74 20 74 68 65 72 65 20 61  le.  But there a
12540 72 65 20 73 65 72 69 6f 75 73 20 64 6f 77 6e 73  re serious downs
12550 69 64 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 28  ides:.**.**    (
12560 31 29 20 20 54 68 65 72 65 20 69 73 20 7a 65 72  1)  There is zer
12570 6f 20 63 6f 6e 63 75 72 72 65 6e 63 79 2e 20 20  o concurrency.  
12580 41 20 73 69 6e 67 6c 65 20 72 65 61 64 65 72 20  A single reader 
12590 62 6c 6f 63 6b 73 20 61 6c 6c 20 6f 74 68 65 72  blocks all other
125a0 0a 2a 2a 20 20 20 20 20 20 20 20 20 63 6f 6e 6e  .**         conn
125b0 65 63 74 69 6f 6e 73 20 66 72 6f 6d 20 72 65 61  ections from rea
125c0 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 20  ding or writing 
125d0 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a  the database..**
125e0 0a 2a 2a 20 20 20 20 28 32 29 20 20 41 6e 20 61  .**    (2)  An a
125f0 70 70 6c 69 63 61 74 69 6f 6e 20 63 72 61 73 68  pplication crash
12600 20 6f 72 20 70 6f 77 65 72 20 6c 6f 73 73 20 63   or power loss c
12610 61 6e 20 6c 65 61 76 65 20 73 74 61 6c 65 20 6c  an leave stale l
12620 6f 63 6b 20 66 69 6c 65 73 0a 2a 2a 20 20 20 20  ock files.**    
12630 20 20 20 20 20 73 69 74 74 69 6e 67 20 61 72 6f       sitting aro
12640 75 6e 64 20 74 68 61 74 20 6e 65 65 64 20 74 6f  und that need to
12650 20 62 65 20 63 6c 65 61 72 65 64 20 6d 61 6e 75   be cleared manu
12660 61 6c 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4e 65 76 65  ally..**.** Neve
12670 72 74 68 65 6c 65 73 73 2c 20 61 20 64 6f 74 6c  rtheless, a dotl
12680 6f 63 6b 20 69 73 20 61 6e 20 61 70 70 72 6f 70  ock is an approp
12690 72 69 61 74 65 20 6c 6f 63 6b 69 6e 67 20 6d 6f  riate locking mo
126a0 64 65 20 66 6f 72 20 75 73 65 20 69 66 20 6e 6f  de for use if no
126b0 0a 2a 2a 20 6f 74 68 65 72 20 6c 6f 63 6b 69 6e  .** other lockin
126c0 67 20 73 74 72 61 74 65 67 79 20 69 73 20 61 76  g strategy is av
126d0 61 69 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 44  ailable..**.** D
126e0 6f 74 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 77  otfile locking w
126f0 6f 72 6b 73 20 62 79 20 63 72 65 61 74 69 6e 67  orks by creating
12700 20 61 20 73 75 62 64 69 72 65 63 74 6f 72 79 20   a subdirectory 
12710 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 65  in the same dire
12720 63 74 6f 72 79 20 61 73 0a 2a 2a 20 74 68 65 20  ctory as.** the 
12730 64 61 74 61 62 61 73 65 20 61 6e 64 20 77 69 74  database and wit
12740 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20  h the same name 
12750 62 75 74 20 77 69 74 68 20 61 20 22 2e 6c 6f 63  but with a ".loc
12760 6b 22 20 65 78 74 65 6e 73 69 6f 6e 20 61 64 64  k" extension add
12770 65 64 2e 0a 2a 2a 20 54 68 65 20 65 78 69 73 74  ed..** The exist
12780 65 6e 63 65 20 6f 66 20 61 20 6c 6f 63 6b 20 64  ence of a lock d
12790 69 72 65 63 74 6f 72 79 20 69 6d 70 6c 69 65 73  irectory implies
127a0 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f   an EXCLUSIVE lo
127b0 63 6b 2e 20 20 41 6c 6c 20 6f 74 68 65 72 0a 2a  ck.  All other.*
127c0 2a 20 6c 6f 63 6b 20 74 79 70 65 73 20 28 53 48  * lock types (SH
127d0 41 52 45 44 2c 20 52 45 53 45 52 56 45 44 2c 20  ARED, RESERVED, 
127e0 50 45 4e 44 49 4e 47 29 20 61 72 65 20 6d 61 70  PENDING) are map
127f0 70 65 64 20 69 6e 74 6f 20 45 58 43 4c 55 53 49  ped into EXCLUSI
12800 56 45 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68  VE..*/../*.** Th
12810 65 20 66 69 6c 65 20 73 75 66 66 69 78 20 61 64  e file suffix ad
12820 64 65 64 20 74 6f 20 74 68 65 20 64 61 74 61 20  ded to the data 
12830 62 61 73 65 20 66 69 6c 65 6e 61 6d 65 20 69 6e  base filename in
12840 20 6f 72 64 65 72 20 74 6f 20 63 72 65 61 74 65   order to create
12850 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 20 64 69 72   the.** lock dir
12860 65 63 74 6f 72 79 2e 0a 2a 2f 0a 23 64 65 66 69  ectory..*/.#defi
12870 6e 65 20 44 4f 54 4c 4f 43 4b 5f 53 55 46 46 49  ne DOTLOCK_SUFFI
12880 58 20 22 2e 6c 6f 63 6b 22 0a 0a 2f 2a 0a 2a 2a  X ".lock"../*.**
12890 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68   This routine ch
128a0 65 63 6b 73 20 69 66 20 74 68 65 72 65 20 69 73  ecks if there is
128b0 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b   a RESERVED lock
128c0 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 73 70 65   held on the spe
128d0 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65 20 62  cified.** file b
128e0 79 20 74 68 69 73 20 6f 72 20 61 6e 79 20 6f 74  y this or any ot
128f0 68 65 72 20 70 72 6f 63 65 73 73 2e 20 49 66 20  her process. If 
12900 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 73 20 68  such a lock is h
12910 65 6c 64 2c 20 73 65 74 20 2a 70 52 65 73 4f 75  eld, set *pResOu
12920 74 0a 2a 2a 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65  t.** to a non-ze
12930 72 6f 20 76 61 6c 75 65 20 6f 74 68 65 72 77 69  ro value otherwi
12940 73 65 20 2a 70 52 65 73 4f 75 74 20 69 73 20 73  se *pResOut is s
12950 65 74 20 74 6f 20 7a 65 72 6f 2e 20 20 54 68 65  et to zero.  The
12960 20 72 65 74 75 72 6e 20 76 61 6c 75 65 0a 2a 2a   return value.**
12970 20 69 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54   is set to SQLIT
12980 45 5f 4f 4b 20 75 6e 6c 65 73 73 20 61 6e 20 49  E_OK unless an I
12990 2f 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20  /O error occurs 
129a0 64 75 72 69 6e 67 20 6c 6f 63 6b 20 63 68 65 63  during lock chec
129b0 6b 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 64  king..**.** In d
129c0 6f 74 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 2c 20  otfile locking, 
129d0 65 69 74 68 65 72 20 61 20 6c 6f 63 6b 20 65 78  either a lock ex
129e0 69 73 74 73 20 6f 72 20 69 74 20 64 6f 65 73 20  ists or it does 
129f0 6e 6f 74 2e 20 20 53 6f 20 69 6e 20 74 68 69 73  not.  So in this
12a00 0a 2a 2a 20 76 61 72 69 61 74 69 6f 6e 20 6f 66  .** variation of
12a10 20 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f   CheckReservedLo
12a20 63 6b 28 29 2c 20 2a 70 52 65 73 4f 75 74 20 69  ck(), *pResOut i
12a30 73 20 73 65 74 20 74 6f 20 74 72 75 65 20 69 66  s set to true if
12a40 20 61 6e 79 20 6c 6f 63 6b 0a 2a 2a 20 69 73 20   any lock.** is 
12a50 68 65 6c 64 20 6f 6e 20 74 68 65 20 66 69 6c 65  held on the file
12a60 20 61 6e 64 20 66 61 6c 73 65 20 69 66 20 74 68   and false if th
12a70 65 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b  e file is unlock
12a80 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ed..*/.static in
12a90 74 20 64 6f 74 6c 6f 63 6b 43 68 65 63 6b 52 65  t dotlockCheckRe
12aa0 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74  servedLock(sqlit
12ab0 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74  e3_file *id, int
12ac0 20 2a 70 52 65 73 4f 75 74 29 20 7b 0a 20 20 69   *pResOut) {.  i
12ad0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
12ae0 4b 3b 0a 20 20 69 6e 74 20 72 65 73 65 72 76 65  K;.  int reserve
12af0 64 20 3d 20 30 3b 0a 20 20 75 6e 69 78 46 69 6c  d = 0;.  unixFil
12b00 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78  e *pFile = (unix
12b10 46 69 6c 65 2a 29 69 64 3b 0a 0a 20 20 53 69 6d  File*)id;..  Sim
12b20 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65  ulateIOError( re
12b30 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52  turn SQLITE_IOER
12b40 52 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c  R_CHECKRESERVEDL
12b50 4f 43 4b 3b 20 29 3b 0a 20 20 0a 20 20 61 73 73  OCK; );.  .  ass
12b60 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20  ert( pFile );.  
12b70 72 65 73 65 72 76 65 64 20 3d 20 6f 73 41 63 63  reserved = osAcc
12b80 65 73 73 28 28 63 6f 6e 73 74 20 63 68 61 72 2a  ess((const char*
12b90 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43  )pFile->lockingC
12ba0 6f 6e 74 65 78 74 2c 20 30 29 3d 3d 30 3b 0a 20  ontext, 0)==0;. 
12bb0 20 4f 53 54 52 41 43 45 28 28 22 54 45 53 54 20   OSTRACE(("TEST 
12bc0 57 52 2d 4c 4f 43 4b 20 25 64 20 25 64 20 25 64  WR-LOCK %d %d %d
12bd0 20 28 64 6f 74 6c 6f 63 6b 29 5c 6e 22 2c 20 70   (dotlock)\n", p
12be0 46 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72 65 73  File->h, rc, res
12bf0 65 72 76 65 64 29 29 3b 0a 20 20 2a 70 52 65 73  erved));.  *pRes
12c00 4f 75 74 20 3d 20 72 65 73 65 72 76 65 64 3b 0a  Out = reserved;.
12c10 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
12c20 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 20 66  /*.** Lock the f
12c30 69 6c 65 20 77 69 74 68 20 74 68 65 20 6c 6f 63  ile with the loc
12c40 6b 20 73 70 65 63 69 66 69 65 64 20 62 79 20 70  k specified by p
12c50 61 72 61 6d 65 74 65 72 20 65 46 69 6c 65 4c 6f  arameter eFileLo
12c60 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74  ck - one.** of t
12c70 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a  he following:.**
12c80 0a 2a 2a 20 20 20 20 20 28 31 29 20 53 48 41 52  .**     (1) SHAR
12c90 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28  ED_LOCK.**     (
12ca0 32 29 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b  2) RESERVED_LOCK
12cb0 0a 2a 2a 20 20 20 20 20 28 33 29 20 50 45 4e 44  .**     (3) PEND
12cc0 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20  ING_LOCK.**     
12cd0 28 34 29 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f  (4) EXCLUSIVE_LO
12ce0 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d  CK.**.** Sometim
12cf0 65 73 20 77 68 65 6e 20 72 65 71 75 65 73 74 69  es when requesti
12d00 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 74  ng one lock stat
12d10 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f  e, additional lo
12d20 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20 61 72 65  ck states.** are
12d30 20 69 6e 73 65 72 74 65 64 20 69 6e 20 62 65 74   inserted in bet
12d40 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f 63 6b 69  ween.  The locki
12d50 6e 67 20 6d 69 67 68 74 20 66 61 69 6c 20 6f 6e  ng might fail on
12d60 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 61 74 65   one of the late
12d70 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73  r.** transitions
12d80 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 6f 63   leaving the loc
12d90 6b 20 73 74 61 74 65 20 64 69 66 66 65 72 65 6e  k state differen
12da0 74 20 66 72 6f 6d 20 77 68 61 74 20 69 74 20 73  t from what it s
12db0 74 61 72 74 65 64 20 62 75 74 0a 2a 2a 20 73 74  tarted but.** st
12dc0 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20 69 74 73  ill short of its
12dd0 20 67 6f 61 6c 2e 20 20 54 68 65 20 66 6f 6c 6c   goal.  The foll
12de0 6f 77 69 6e 67 20 63 68 61 72 74 20 73 68 6f 77  owing chart show
12df0 73 20 74 68 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a  s the allowed.**
12e00 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64   transitions and
12e10 20 74 68 65 20 69 6e 73 65 72 74 65 64 20 69 6e   the inserted in
12e20 74 65 72 6d 65 64 69 61 74 65 20 73 74 61 74 65  termediate state
12e30 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f  s:.**.**    UNLO
12e40 43 4b 45 44 20 2d 3e 20 53 48 41 52 45 44 0a 2a  CKED -> SHARED.*
12e50 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 52  *    SHARED -> R
12e60 45 53 45 52 56 45 44 0a 2a 2a 20 20 20 20 53 48  ESERVED.**    SH
12e70 41 52 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47  ARED -> (PENDING
12e80 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a  ) -> EXCLUSIVE.*
12e90 2a 20 20 20 20 52 45 53 45 52 56 45 44 20 2d 3e  *    RESERVED ->
12ea0 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58   (PENDING) -> EX
12eb0 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 50 45  CLUSIVE.**    PE
12ec0 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c 55 53 49  NDING -> EXCLUSI
12ed0 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  VE.**.** This ro
12ee0 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 20  utine will only 
12ef0 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 6b 2e  increase a lock.
12f00 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 74 65    Use the sqlite
12f10 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72  3OsUnlock().** r
12f20 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 20  outine to lower 
12f30 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2e  a locking level.
12f40 0a 2a 2a 0a 2a 2a 20 57 69 74 68 20 64 6f 74 66  .**.** With dotf
12f50 69 6c 65 20 6c 6f 63 6b 69 6e 67 2c 20 77 65 20  ile locking, we 
12f60 72 65 61 6c 6c 79 20 6f 6e 6c 79 20 73 75 70 70  really only supp
12f70 6f 72 74 20 73 74 61 74 65 20 28 34 29 3a 20 45  ort state (4): E
12f80 58 43 4c 55 53 49 56 45 2e 0a 2a 2a 20 42 75 74  XCLUSIVE..** But
12f90 20 77 65 20 74 72 61 63 6b 20 74 68 65 20 6f 74   we track the ot
12fa0 68 65 72 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65  her locking leve
12fb0 6c 73 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 2a  ls internally..*
12fc0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 64 6f 74  /.static int dot
12fd0 6c 6f 63 6b 4c 6f 63 6b 28 73 71 6c 69 74 65 33  lockLock(sqlite3
12fe0 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65  _file *id, int e
12ff0 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 75 6e  FileLock) {.  un
13000 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20  ixFile *pFile = 
13010 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20  (unixFile*)id;. 
13020 20 63 68 61 72 20 2a 7a 4c 6f 63 6b 46 69 6c 65   char *zLockFile
13030 20 3d 20 28 63 68 61 72 20 2a 29 70 46 69 6c 65   = (char *)pFile
13040 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74  ->lockingContext
13050 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
13060 49 54 45 5f 4f 4b 3b 0a 0a 0a 20 20 2f 2a 20 49  ITE_OK;...  /* I
13070 66 20 77 65 20 68 61 76 65 20 61 6e 79 20 6c 6f  f we have any lo
13080 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 6c 6f 63  ck, then the loc
13090 6b 20 66 69 6c 65 20 61 6c 72 65 61 64 79 20 65  k file already e
130a0 78 69 73 74 73 2e 20 20 41 6c 6c 20 77 65 20 68  xists.  All we h
130b0 61 76 65 0a 20 20 2a 2a 20 74 6f 20 64 6f 20 69  ave.  ** to do i
130c0 73 20 61 64 6a 75 73 74 20 6f 75 72 20 69 6e 74  s adjust our int
130d0 65 72 6e 61 6c 20 72 65 63 6f 72 64 20 6f 66 20  ernal record of 
130e0 74 68 65 20 6c 6f 63 6b 20 6c 65 76 65 6c 2e 0a  the lock level..
130f0 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65    */.  if( pFile
13100 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3e 20 4e 4f  ->eFileLock > NO
13110 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 70 46 69  _LOCK ){.    pFi
13120 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20  le->eFileLock = 
13130 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 2f  eFileLock;.    /
13140 2a 20 41 6c 77 61 79 73 20 75 70 64 61 74 65 20  * Always update 
13150 74 68 65 20 74 69 6d 65 73 74 61 6d 70 20 6f 6e  the timestamp on
13160 20 74 68 65 20 6f 6c 64 20 66 69 6c 65 20 2a 2f   the old file */
13170 0a 23 69 66 64 65 66 20 48 41 56 45 5f 55 54 49  .#ifdef HAVE_UTI
13180 4d 45 0a 20 20 20 20 75 74 69 6d 65 28 7a 4c 6f  ME.    utime(zLo
13190 63 6b 46 69 6c 65 2c 20 4e 55 4c 4c 29 3b 0a 23  ckFile, NULL);.#
131a0 65 6c 73 65 0a 20 20 20 20 75 74 69 6d 65 73 28  else.    utimes(
131b0 7a 4c 6f 63 6b 46 69 6c 65 2c 20 4e 55 4c 4c 29  zLockFile, NULL)
131c0 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74  ;.#endif.    ret
131d0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
131e0 20 7d 0a 20 20 0a 20 20 2f 2a 20 67 72 61 62 20   }.  .  /* grab 
131f0 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63  an exclusive loc
13200 6b 20 2a 2f 0a 20 20 72 63 20 3d 20 6f 73 4d 6b  k */.  rc = osMk
13210 64 69 72 28 7a 4c 6f 63 6b 46 69 6c 65 2c 20 30  dir(zLockFile, 0
13220 37 37 37 29 3b 0a 20 20 69 66 28 20 72 63 3c 30  777);.  if( rc<0
13230 20 29 7b 0a 20 20 20 20 2f 2a 20 66 61 69 6c 65   ){.    /* faile
13240 64 20 74 6f 20 6f 70 65 6e 2f 63 72 65 61 74 65  d to open/create
13250 20 74 68 65 20 6c 6f 63 6b 20 64 69 72 65 63 74   the lock direct
13260 6f 72 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 74  ory */.    int t
13270 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20  Errno = errno;. 
13280 20 20 20 69 66 28 20 45 45 58 49 53 54 20 3d 3d     if( EEXIST ==
13290 20 74 45 72 72 6e 6f 20 29 7b 0a 20 20 20 20 20   tErrno ){.     
132a0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53   rc = SQLITE_BUS
132b0 59 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a  Y;.    } else {.
132c0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
132d0 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45  eErrorFromPosixE
132e0 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c  rror(tErrno, SQL
132f0 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b  ITE_IOERR_LOCK);
13300 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53  .      if( rc!=S
13310 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20  QLITE_BUSY ){.  
13320 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45        storeLastE
13330 72 72 6e 6f 28 70 46 69 6c 65 2c 20 74 45 72 72  rrno(pFile, tErr
13340 6e 6f 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  no);.      }.   
13350 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63   }.    return rc
13360 3b 0a 20 20 7d 20 0a 20 20 0a 20 20 2f 2a 20 67  ;.  } .  .  /* g
13370 6f 74 20 69 74 2c 20 73 65 74 20 74 68 65 20 74  ot it, set the t
13380 79 70 65 20 61 6e 64 20 72 65 74 75 72 6e 20 6f  ype and return o
13390 6b 20 2a 2f 0a 20 20 70 46 69 6c 65 2d 3e 65 46  k */.  pFile->eF
133a0 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c  ileLock = eFileL
133b0 6f 63 6b 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  ock;.  return rc
133c0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72  ;.}../*.** Lower
133d0 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76   the locking lev
133e0 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72  el on file descr
133f0 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65  iptor pFile to e
13400 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65  FileLock.  eFile
13410 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20  Lock.** must be 
13420 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f  either NO_LOCK o
13430 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a  r SHARED_LOCK..*
13440 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b  *.** If the lock
13450 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65  ing level of the
13460 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
13470 20 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f   is already at o
13480 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72  r below.** the r
13490 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67  equested locking
134a0 20 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75   level, this rou
134b0 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  tine is a no-op.
134c0 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 65 20  .**.** When the 
134d0 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 72 65  locking level re
134e0 61 63 68 65 73 20 4e 4f 5f 4c 4f 43 4b 2c 20 64  aches NO_LOCK, d
134f0 65 6c 65 74 65 20 74 68 65 20 6c 6f 63 6b 20 66  elete the lock f
13500 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
13510 6e 74 20 64 6f 74 6c 6f 63 6b 55 6e 6c 6f 63 6b  nt dotlockUnlock
13520 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69  (sqlite3_file *i
13530 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b  d, int eFileLock
13540 29 20 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a  ) {.  unixFile *
13550 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c  pFile = (unixFil
13560 65 2a 29 69 64 3b 0a 20 20 63 68 61 72 20 2a 7a  e*)id;.  char *z
13570 4c 6f 63 6b 46 69 6c 65 20 3d 20 28 63 68 61 72  LockFile = (char
13580 20 2a 29 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e   *)pFile->lockin
13590 67 43 6f 6e 74 65 78 74 3b 0a 20 20 69 6e 74 20  gContext;.  int 
135a0 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70  rc;..  assert( p
135b0 46 69 6c 65 20 29 3b 0a 20 20 4f 53 54 52 41 43  File );.  OSTRAC
135c0 45 28 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25  E(("UNLOCK  %d %
135d0 64 20 77 61 73 20 25 64 20 70 69 64 3d 25 64 20  d was %d pid=%d 
135e0 28 64 6f 74 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46  (dotlock)\n", pF
135f0 69 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 4c 6f 63  ile->h, eFileLoc
13600 6b 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 46  k,.           pF
13610 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20  ile->eFileLock, 
13620 6f 73 47 65 74 70 69 64 28 30 29 29 29 3b 0a 20  osGetpid(0)));. 
13630 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f   assert( eFileLo
13640 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20  ck<=SHARED_LOCK 
13650 29 3b 0a 20 20 0a 20 20 2f 2a 20 6e 6f 2d 6f 70  );.  .  /* no-op
13660 20 69 66 20 70 6f 73 73 69 62 6c 65 20 2a 2f 0a   if possible */.
13670 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69    if( pFile->eFi
13680 6c 65 4c 6f 63 6b 3d 3d 65 46 69 6c 65 4c 6f 63  leLock==eFileLoc
13690 6b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  k ){.    return 
136a0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a  SQLITE_OK;.  }..
136b0 20 20 2f 2a 20 54 6f 20 64 6f 77 6e 67 72 61 64    /* To downgrad
136c0 65 20 74 6f 20 73 68 61 72 65 64 2c 20 73 69 6d  e to shared, sim
136d0 70 6c 79 20 75 70 64 61 74 65 20 6f 75 72 20 69  ply update our i
136e0 6e 74 65 72 6e 61 6c 20 6e 6f 74 69 6f 6e 20 6f  nternal notion o
136f0 66 20 74 68 65 0a 20 20 2a 2a 20 6c 6f 63 6b 20  f the.  ** lock 
13700 73 74 61 74 65 2e 20 20 4e 6f 20 6e 65 65 64 20  state.  No need 
13710 74 6f 20 6d 65 73 73 20 77 69 74 68 20 74 68 65  to mess with the
13720 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2e 0a 20   file on disk.. 
13730 20 2a 2f 0a 20 20 69 66 28 20 65 46 69 6c 65 4c   */.  if( eFileL
13740 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b  ock==SHARED_LOCK
13750 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65   ){.    pFile->e
13760 46 69 6c 65 4c 6f 63 6b 20 3d 20 53 48 41 52 45  FileLock = SHARE
13770 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 72 65 74 75  D_LOCK;.    retu
13780 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
13790 7d 0a 20 20 0a 20 20 2f 2a 20 54 6f 20 66 75 6c  }.  .  /* To ful
137a0 6c 79 20 75 6e 6c 6f 63 6b 20 74 68 65 20 64 61  ly unlock the da
137b0 74 61 62 61 73 65 2c 20 64 65 6c 65 74 65 20 74  tabase, delete t
137c0 68 65 20 6c 6f 63 6b 20 66 69 6c 65 20 2a 2f 0a  he lock file */.
137d0 20 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c    assert( eFileL
137e0 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 29 3b 0a  ock==NO_LOCK );.
137f0 20 20 72 63 20 3d 20 6f 73 52 6d 64 69 72 28 7a    rc = osRmdir(z
13800 4c 6f 63 6b 46 69 6c 65 29 3b 0a 20 20 69 66 28  LockFile);.  if(
13810 20 72 63 3c 30 20 29 7b 0a 20 20 20 20 69 6e 74   rc<0 ){.    int
13820 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b   tErrno = errno;
13830 0a 20 20 20 20 69 66 28 20 74 45 72 72 6e 6f 3d  .    if( tErrno=
13840 3d 45 4e 4f 45 4e 54 20 29 7b 0a 20 20 20 20 20  =ENOENT ){.     
13850 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
13860 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
13870 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f    rc = SQLITE_IO
13880 45 52 52 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20  ERR_UNLOCK;.    
13890 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f    storeLastErrno
138a0 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b  (pFile, tErrno);
138b0 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72  .    }.    retur
138c0 6e 20 72 63 3b 20 0a 20 20 7d 0a 20 20 70 46 69  n rc; .  }.  pFi
138d0 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20  le->eFileLock = 
138e0 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 72 65 74 75 72  NO_LOCK;.  retur
138f0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
13900 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69  /*.** Close a fi
13910 6c 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 74  le.  Make sure t
13920 68 65 20 6c 6f 63 6b 20 68 61 73 20 62 65 65 6e  he lock has been
13930 20 72 65 6c 65 61 73 65 64 20 62 65 66 6f 72 65   released before
13940 20 63 6c 6f 73 69 6e 67 2e 0a 2a 2f 0a 73 74 61   closing..*/.sta
13950 74 69 63 20 69 6e 74 20 64 6f 74 6c 6f 63 6b 43  tic int dotlockC
13960 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c  lose(sqlite3_fil
13970 65 20 2a 69 64 29 20 7b 0a 20 20 75 6e 69 78 46  e *id) {.  unixF
13980 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e  ile *pFile = (un
13990 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 61 73  ixFile*)id;.  as
139a0 73 65 72 74 28 20 69 64 21 3d 30 20 29 3b 0a 20  sert( id!=0 );. 
139b0 20 64 6f 74 6c 6f 63 6b 55 6e 6c 6f 63 6b 28 69   dotlockUnlock(i
139c0 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 73  d, NO_LOCK);.  s
139d0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 46 69 6c  qlite3_free(pFil
139e0 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78  e->lockingContex
139f0 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 63 6c 6f  t);.  return clo
13a00 73 65 55 6e 69 78 46 69 6c 65 28 69 64 29 3b 0a  seUnixFile(id);.
13a10 7d 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  }./*************
13a20 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 74 68 65  ***** End of the
13a30 20 64 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 20 69   dot-file lock i
13a40 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a  mplementation **
13a50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13a60 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  *.**************
13a70 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13a80 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13a90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13aa0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13ab0 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /../************
13ac0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13ad0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13ae0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13af0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13b00 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  **.*************
13b10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65  ************* Be
13b20 67 69 6e 20 66 6c 6f 63 6b 20 4c 6f 63 6b 69 6e  gin flock Lockin
13b30 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  g **************
13b40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
13b50 2a 2a 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65  **.**.** Use the
13b60 20 66 6c 6f 63 6b 28 29 20 73 79 73 74 65 6d 20   flock() system 
13b70 63 61 6c 6c 20 74 6f 20 64 6f 20 66 69 6c 65 20  call to do file 
13b80 6c 6f 63 6b 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 66  locking..**.** f
13b90 6c 6f 63 6b 28 29 20 6c 6f 63 6b 69 6e 67 20 69  lock() locking i
13ba0 73 20 6c 69 6b 65 20 64 6f 74 2d 66 69 6c 65 20  s like dot-file 
13bb0 6c 6f 63 6b 69 6e 67 20 69 6e 20 74 68 61 74 20  locking in that 
13bc0 74 68 65 20 76 61 72 69 6f 75 73 0a 2a 2a 20 66  the various.** f
13bd0 69 6e 65 2d 67 72 61 69 6e 20 6c 6f 63 6b 69 6e  ine-grain lockin
13be0 67 20 6c 65 76 65 6c 73 20 73 75 70 70 6f 72 74  g levels support
13bf0 65 64 20 62 79 20 53 51 4c 69 74 65 20 61 72 65  ed by SQLite are
13c00 20 63 6f 6c 6c 61 70 73 65 64 20 69 6e 74 6f 0a   collapsed into.
13c10 2a 2a 20 61 20 73 69 6e 67 6c 65 20 65 78 63 6c  ** a single excl
13c20 75 73 69 76 65 20 6c 6f 63 6b 2e 20 20 49 6e 20  usive lock.  In 
13c30 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 53 48 41  other words, SHA
13c40 52 45 44 2c 20 52 45 53 45 52 56 45 44 2c 20 61  RED, RESERVED, a
13c50 6e 64 0a 2a 2a 20 50 45 4e 44 49 4e 47 20 6c 6f  nd.** PENDING lo
13c60 63 6b 73 20 61 72 65 20 74 68 65 20 73 61 6d 65  cks are the same
13c70 20 74 68 69 6e 67 20 61 73 20 61 6e 20 45 58 43   thing as an EXC
13c80 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 53 51  LUSIVE lock.  SQ
13c90 4c 69 74 65 0a 2a 2a 20 73 74 69 6c 6c 20 77 6f  Lite.** still wo
13ca0 72 6b 73 20 77 68 65 6e 20 79 6f 75 20 64 6f 20  rks when you do 
13cb0 74 68 69 73 2c 20 62 75 74 20 63 6f 6e 63 75 72  this, but concur
13cc0 72 65 6e 63 79 20 69 73 20 72 65 64 75 63 65 64  rency is reduced
13cd0 20 73 69 6e 63 65 0a 2a 2a 20 6f 6e 6c 79 20 61   since.** only a
13ce0 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 73 73 20   single process 
13cf0 63 61 6e 20 62 65 20 72 65 61 64 69 6e 67 20 74  can be reading t
13d00 68 65 20 64 61 74 61 62 61 73 65 20 61 74 20 61  he database at a
13d10 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6d 69   time..**.** Omi
13d20 74 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 69  t this section i
13d30 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
13d40 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 69 73  LOCKING_STYLE is
13d50 20 74 75 72 6e 65 64 20 6f 66 66 0a 2a 2f 0a 23   turned off.*/.#
13d60 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  if SQLITE_ENABLE
13d70 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 0a  _LOCKING_STYLE..
13d80 2f 2a 0a 2a 2a 20 52 65 74 72 79 20 66 6c 6f 63  /*.** Retry floc
13d90 6b 28 29 20 63 61 6c 6c 73 20 74 68 61 74 20 66  k() calls that f
13da0 61 69 6c 20 77 69 74 68 20 45 49 4e 54 52 0a 2a  ail with EINTR.*
13db0 2f 0a 23 69 66 64 65 66 20 45 49 4e 54 52 0a 73  /.#ifdef EINTR.s
13dc0 74 61 74 69 63 20 69 6e 74 20 72 6f 62 75 73 74  tatic int robust
13dd0 5f 66 6c 6f 63 6b 28 69 6e 74 20 66 64 2c 20 69  _flock(int fd, i
13de0 6e 74 20 6f 70 29 7b 0a 20 20 69 6e 74 20 72 63  nt op){.  int rc
13df0 3b 0a 20 20 64 6f 7b 20 72 63 20 3d 20 66 6c 6f  ;.  do{ rc = flo
13e00 63 6b 28 66 64 2c 6f 70 29 3b 20 7d 77 68 69 6c  ck(fd,op); }whil
13e10 65 28 20 72 63 3c 30 20 26 26 20 65 72 72 6e 6f  e( rc<0 && errno
13e20 3d 3d 45 49 4e 54 52 20 29 3b 0a 20 20 72 65 74  ==EINTR );.  ret
13e30 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6c 73 65 0a  urn rc;.}.#else.
13e40 23 20 64 65 66 69 6e 65 20 72 6f 62 75 73 74 5f  # define robust_
13e50 66 6c 6f 63 6b 28 61 2c 62 29 20 66 6c 6f 63 6b  flock(a,b) flock
13e60 28 61 2c 62 29 0a 23 65 6e 64 69 66 0a 20 20 20  (a,b).#endif.   
13e70 20 20 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72    ../*.** This r
13e80 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 66  outine checks if
13e90 20 74 68 65 72 65 20 69 73 20 61 20 52 45 53 45   there is a RESE
13ea0 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 20 6f  RVED lock held o
13eb0 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 0a  n the specified.
13ec0 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 73 20  ** file by this 
13ed0 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f  or any other pro
13ee0 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 61 20  cess. If such a 
13ef0 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 73 65  lock is held, se
13f00 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 74 6f  t *pResOut.** to
13f10 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75   a non-zero valu
13f20 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 52 65  e otherwise *pRe
13f30 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20 7a  sOut is set to z
13f40 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 72 6e  ero.  The return
13f50 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 74   value.** is set
13f60 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 75 6e   to SQLITE_OK un
13f70 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 72 6f  less an I/O erro
13f80 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20  r occurs during 
13f90 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e 0a 2a  lock checking..*
13fa0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 6c 6f  /.static int flo
13fb0 63 6b 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c  ckCheckReservedL
13fc0 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ock(sqlite3_file
13fd0 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 4f   *id, int *pResO
13fe0 75 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20  ut){.  int rc = 
13ff0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74  SQLITE_OK;.  int
14000 20 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a 20   reserved = 0;. 
14010 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65   unixFile *pFile
14020 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64   = (unixFile*)id
14030 3b 0a 20 20 0a 20 20 53 69 6d 75 6c 61 74 65 49  ;.  .  SimulateI
14040 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 53  OError( return S
14050 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43  QLITE_IOERR_CHEC
14060 4b 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 29  KRESERVEDLOCK; )
14070 3b 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70  ;.  .  assert( p
14080 46 69 6c 65 20 29 3b 0a 20 20 0a 20 20 2f 2a 20  File );.  .  /* 
14090 43 68 65 63 6b 20 69 66 20 61 20 74 68 72 65 61  Check if a threa
140a0 64 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65 73  d in this proces
140b0 73 20 68 6f 6c 64 73 20 73 75 63 68 20 61 20 6c  s holds such a l
140c0 6f 63 6b 20 2a 2f 0a 20 20 69 66 28 20 70 46 69  ock */.  if( pFi
140d0 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 53 48  le->eFileLock>SH
140e0 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20  ARED_LOCK ){.   
140f0 20 72 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20   reserved = 1;. 
14100 20 7d 0a 20 20 0a 20 20 2f 2a 20 4f 74 68 65 72   }.  .  /* Other
14110 77 69 73 65 20 73 65 65 20 69 66 20 73 6f 6d 65  wise see if some
14120 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 68   other process h
14130 6f 6c 64 73 20 69 74 2e 20 2a 2f 0a 20 20 69 66  olds it. */.  if
14140 28 20 21 72 65 73 65 72 76 65 64 20 29 7b 0a 20  ( !reserved ){. 
14150 20 20 20 2f 2a 20 61 74 74 65 6d 70 74 20 74 6f     /* attempt to
14160 20 67 65 74 20 74 68 65 20 6c 6f 63 6b 20 2a 2f   get the lock */
14170 0a 20 20 20 20 69 6e 74 20 6c 72 63 20 3d 20 72  .    int lrc = r
14180 6f 62 75 73 74 5f 66 6c 6f 63 6b 28 70 46 69 6c  obust_flock(pFil
14190 65 2d 3e 68 2c 20 4c 4f 43 4b 5f 45 58 20 7c 20  e->h, LOCK_EX | 
141a0 4c 4f 43 4b 5f 4e 42 29 3b 0a 20 20 20 20 69 66  LOCK_NB);.    if
141b0 28 20 21 6c 72 63 20 29 7b 0a 20 20 20 20 20 20  ( !lrc ){.      
141c0 2f 2a 20 67 6f 74 20 74 68 65 20 6c 6f 63 6b 2c  /* got the lock,
141d0 20 75 6e 6c 6f 63 6b 20 69 74 20 2a 2f 0a 20 20   unlock it */.  
141e0 20 20 20 20 6c 72 63 20 3d 20 72 6f 62 75 73 74      lrc = robust
141f0 5f 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e 68 2c  _flock(pFile->h,
14200 20 4c 4f 43 4b 5f 55 4e 29 3b 0a 20 20 20 20 20   LOCK_UN);.     
14210 20 69 66 20 28 20 6c 72 63 20 29 20 7b 0a 20 20   if ( lrc ) {.  
14220 20 20 20 20 20 20 69 6e 74 20 74 45 72 72 6e 6f        int tErrno
14230 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 20 20   = errno;.      
14240 20 20 2f 2a 20 75 6e 6c 6f 63 6b 20 66 61 69 6c    /* unlock fail
14250 65 64 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72  ed with an error
14260 20 2a 2f 0a 20 20 20 20 20 20 20 20 6c 72 63 20   */.        lrc 
14270 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 55  = SQLITE_IOERR_U
14280 4e 4c 4f 43 4b 3b 20 0a 20 20 20 20 20 20 20 20  NLOCK; .        
14290 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70  storeLastErrno(p
142a0 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20  File, tErrno);. 
142b0 20 20 20 20 20 20 20 72 63 20 3d 20 6c 72 63 3b         rc = lrc;
142c0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65  .      }.    } e
142d0 6c 73 65 20 7b 0a 20 20 20 20 20 20 69 6e 74 20  lse {.      int 
142e0 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a  tErrno = errno;.
142f0 20 20 20 20 20 20 72 65 73 65 72 76 65 64 20 3d        reserved =
14300 20 31 3b 0a 20 20 20 20 20 20 2f 2a 20 73 6f 6d   1;.      /* som
14310 65 6f 6e 65 20 65 6c 73 65 20 6d 69 67 68 74 20  eone else might 
14320 68 61 76 65 20 69 74 20 72 65 73 65 72 76 65 64  have it reserved
14330 20 2a 2f 0a 20 20 20 20 20 20 6c 72 63 20 3d 20   */.      lrc = 
14340 73 71 6c 69 74 65 45 72 72 6f 72 46 72 6f 6d 50  sqliteErrorFromP
14350 6f 73 69 78 45 72 72 6f 72 28 74 45 72 72 6e 6f  osixError(tErrno
14360 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c  , SQLITE_IOERR_L
14370 4f 43 4b 29 3b 20 0a 20 20 20 20 20 20 69 66 28  OCK); .      if(
14380 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 6c   IS_LOCK_ERROR(l
14390 72 63 29 20 29 7b 0a 20 20 20 20 20 20 20 20 73  rc) ){.        s
143a0 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46  toreLastErrno(pF
143b0 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20  ile, tErrno);.  
143c0 20 20 20 20 20 20 72 63 20 3d 20 6c 72 63 3b 0a        rc = lrc;.
143d0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
143e0 7d 0a 20 20 4f 53 54 52 41 43 45 28 28 22 54 45  }.  OSTRACE(("TE
143f0 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64 20 25 64  ST WR-LOCK %d %d
14400 20 25 64 20 28 66 6c 6f 63 6b 29 5c 6e 22 2c 20   %d (flock)\n", 
14410 70 46 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72 65  pFile->h, rc, re
14420 73 65 72 76 65 64 29 29 3b 0a 0a 23 69 66 64 65  served));..#ifde
14430 66 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f  f SQLITE_IGNORE_
14440 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52  FLOCK_LOCK_ERROR
14450 53 0a 20 20 69 66 28 20 28 72 63 20 26 20 30 78  S.  if( (rc & 0x
14460 66 66 29 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f  ff) == SQLITE_IO
14470 45 52 52 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  ERR ){.    rc = 
14480 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 72  SQLITE_OK;.    r
14490 65 73 65 72 76 65 64 3d 31 3b 0a 20 20 7d 0a 23  eserved=1;.  }.#
144a0 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
144b0 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43  IGNORE_FLOCK_LOC
144c0 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20 20 2a 70  K_ERRORS */.  *p
144d0 52 65 73 4f 75 74 20 3d 20 72 65 73 65 72 76 65  ResOut = reserve
144e0 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  d;.  return rc;.
144f0 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68  }../*.** Lock th
14500 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 20  e file with the 
14510 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 64 20 62  lock specified b
14520 79 20 70 61 72 61 6d 65 74 65 72 20 65 46 69 6c  y parameter eFil
14530 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f  eLock - one.** o
14540 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a  f the following:
14550 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 53  .**.**     (1) S
14560 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20  HARED_LOCK.**   
14570 20 20 28 32 29 20 52 45 53 45 52 56 45 44 5f 4c    (2) RESERVED_L
14580 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 20 50  OCK.**     (3) P
14590 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20  ENDING_LOCK.**  
145a0 20 20 20 28 34 29 20 45 58 43 4c 55 53 49 56 45     (4) EXCLUSIVE
145b0 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65  _LOCK.**.** Some
145c0 74 69 6d 65 73 20 77 68 65 6e 20 72 65 71 75 65  times when reque
145d0 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73  sting one lock s
145e0 74 61 74 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c  tate, additional
145f0 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20   lock states.** 
14600 61 72 65 20 69 6e 73 65 72 74 65 64 20 69 6e 20  are inserted in 
14610 62 65 74 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f  between.  The lo
14620 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 69 6c  cking might fail
14630 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c   on one of the l
14640 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69  ater.** transiti
14650 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 65 20  ons leaving the 
14660 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 66 66 65  lock state diffe
14670 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 69  rent from what i
14680 74 20 73 74 61 72 74 65 64 20 62 75 74 0a 2a 2a  t started but.**
14690 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20   still short of 
146a0 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 20 66  its goal.  The f
146b0 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 20 73  ollowing chart s
146c0 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 65 64  hows the allowed
146d0 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20  .** transitions 
146e0 61 6e 64 20 74 68 65 20 69 6e 73 65 72 74 65 64  and the inserted
146f0 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 73 74   intermediate st
14700 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55  ates:.**.**    U
14710 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 52 45  NLOCKED -> SHARE
14720 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d  D.**    SHARED -
14730 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 20 20  > RESERVED.**   
14740 20 53 48 41 52 45 44 20 2d 3e 20 28 50 45 4e 44   SHARED -> (PEND
14750 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56  ING) -> EXCLUSIV
14760 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 45 44  E.**    RESERVED
14770 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e   -> (PENDING) ->
14780 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20   EXCLUSIVE.**   
14790 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c   PENDING -> EXCL
147a0 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 66 6c 6f 63  USIVE.**.** floc
147b0 6b 28 29 20 6f 6e 6c 79 20 72 65 61 6c 6c 79 20  k() only really 
147c0 73 75 70 70 6f 72 74 20 45 58 43 4c 55 53 49 56  support EXCLUSIV
147d0 45 20 6c 6f 63 6b 73 2e 20 20 57 65 20 74 72 61  E locks.  We tra
147e0 63 6b 20 69 6e 74 65 72 6d 65 64 69 61 74 65 0a  ck intermediate.
147f0 2a 2a 20 6c 6f 63 6b 20 73 74 61 74 65 73 20 69  ** lock states i
14800 6e 20 74 68 65 20 73 71 6c 69 74 65 33 5f 66 69  n the sqlite3_fi
14810 6c 65 20 73 74 72 75 63 74 75 72 65 2c 20 62 75  le structure, bu
14820 74 20 61 6c 6c 20 6c 6f 63 6b 73 20 53 48 41 52  t all locks SHAR
14830 45 44 20 6f 72 0a 2a 2a 20 61 62 6f 76 65 20 61  ED or.** above a
14840 72 65 20 72 65 61 6c 6c 79 20 45 58 43 4c 55 53  re really EXCLUS
14850 49 56 45 20 6c 6f 63 6b 73 20 61 6e 64 20 65 78  IVE locks and ex
14860 63 6c 75 64 65 20 61 6c 6c 20 6f 74 68 65 72 20  clude all other 
14870 70 72 6f 63 65 73 73 65 73 20 66 72 6f 6d 0a 2a  processes from.*
14880 2a 20 61 63 63 65 73 73 20 74 68 65 20 66 69 6c  * access the fil
14890 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  e..**.** This ro
148a0 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 20  utine will only 
148b0 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 6b 2e  increase a lock.
148c0 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 74 65    Use the sqlite
148d0 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72  3OsUnlock().** r
148e0 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 20  outine to lower 
148f0 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2e  a locking level.
14900 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66  .*/.static int f
14910 6c 6f 63 6b 4c 6f 63 6b 28 73 71 6c 69 74 65 33  lockLock(sqlite3
14920 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65  _file *id, int e
14930 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 69 6e  FileLock) {.  in
14940 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
14950 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46  ;.  unixFile *pF
14960 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a  ile = (unixFile*
14970 29 69 64 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  )id;..  assert( 
14980 70 46 69 6c 65 20 29 3b 0a 0a 20 20 2f 2a 20 69  pFile );..  /* i
14990 66 20 77 65 20 61 6c 72 65 61 64 79 20 68 61 76  f we already hav
149a0 65 20 61 20 6c 6f 63 6b 2c 20 69 74 20 69 73 20  e a lock, it is 
149b0 65 78 63 6c 75 73 69 76 65 2e 20 20 0a 20 20 2a  exclusive.  .  *
149c0 2a 20 4a 75 73 74 20 61 64 6a 75 73 74 20 6c 65  * Just adjust le
149d0 76 65 6c 20 61 6e 64 20 70 75 6e 74 20 6f 6e 20  vel and punt on 
149e0 6f 75 74 74 61 20 68 65 72 65 2e 20 2a 2f 0a 20  outta here. */. 
149f0 20 69 66 20 28 70 46 69 6c 65 2d 3e 65 46 69 6c   if (pFile->eFil
14a00 65 4c 6f 63 6b 20 3e 20 4e 4f 5f 4c 4f 43 4b 29  eLock > NO_LOCK)
14a10 20 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46   {.    pFile->eF
14a20 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c  ileLock = eFileL
14a30 6f 63 6b 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  ock;.    return 
14a40 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20  SQLITE_OK;.  }. 
14a50 20 0a 20 20 2f 2a 20 67 72 61 62 20 61 6e 20 65   .  /* grab an e
14a60 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 2a 2f  xclusive lock */
14a70 0a 20 20 0a 20 20 69 66 20 28 72 6f 62 75 73 74  .  .  if (robust
14a80 5f 66 6c 6f 63 6b 28 70 46 69 6c 65 2d 3e 68 2c  _flock(pFile->h,
14a90 20 4c 4f 43 4b 5f 45 58 20 7c 20 4c 4f 43 4b 5f   LOCK_EX | LOCK_
14aa0 4e 42 29 29 20 7b 0a 20 20 20 20 69 6e 74 20 74  NB)) {.    int t
14ab0 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20  Errno = errno;. 
14ac0 20 20 20 2f 2a 20 64 69 64 6e 27 74 20 67 65 74     /* didn't get
14ad0 2c 20 6d 75 73 74 20 62 65 20 62 75 73 79 20 2a  , must be busy *
14ae0 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  /.    rc = sqlit
14af0 65 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45  eErrorFromPosixE
14b00 72 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c  rror(tErrno, SQL
14b10 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 29 3b  ITE_IOERR_LOCK);
14b20 0a 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b  .    if( IS_LOCK
14b30 5f 45 52 52 4f 52 28 72 63 29 20 29 7b 0a 20 20  _ERROR(rc) ){.  
14b40 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72      storeLastErr
14b50 6e 6f 28 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f  no(pFile, tErrno
14b60 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 20 65 6c 73  );.    }.  } els
14b70 65 20 7b 0a 20 20 20 20 2f 2a 20 67 6f 74 20 69  e {.    /* got i
14b80 74 2c 20 73 65 74 20 74 68 65 20 74 79 70 65 20  t, set the type 
14b90 61 6e 64 20 72 65 74 75 72 6e 20 6f 6b 20 2a 2f  and return ok */
14ba0 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c  .    pFile->eFil
14bb0 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63  eLock = eFileLoc
14bc0 6b 3b 0a 20 20 7d 0a 20 20 4f 53 54 52 41 43 45  k;.  }.  OSTRACE
14bd0 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 73  (("LOCK    %d %s
14be0 20 25 73 20 28 66 6c 6f 63 6b 29 5c 6e 22 2c 20   %s (flock)\n", 
14bf0 70 46 69 6c 65 2d 3e 68 2c 20 61 7a 46 69 6c 65  pFile->h, azFile
14c00 4c 6f 63 6b 28 65 46 69 6c 65 4c 6f 63 6b 29 2c  Lock(eFileLock),
14c10 20 0a 20 20 20 20 20 20 20 20 20 20 20 72 63 3d   .           rc=
14c20 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 22 6f 6b  =SQLITE_OK ? "ok
14c30 22 20 3a 20 22 66 61 69 6c 65 64 22 29 29 3b 0a  " : "failed"));.
14c40 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 49 47  #ifdef SQLITE_IG
14c50 4e 4f 52 45 5f 46 4c 4f 43 4b 5f 4c 4f 43 4b 5f  NORE_FLOCK_LOCK_
14c60 45 52 52 4f 52 53 0a 20 20 69 66 28 20 28 72 63  ERRORS.  if( (rc
14c70 20 26 20 30 78 66 66 29 20 3d 3d 20 53 51 4c 49   & 0xff) == SQLI
14c80 54 45 5f 49 4f 45 52 52 20 29 7b 0a 20 20 20 20  TE_IOERR ){.    
14c90 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59  rc = SQLITE_BUSY
14ca0 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  ;.  }.#endif /* 
14cb0 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f 46 4c  SQLITE_IGNORE_FL
14cc0 4f 43 4b 5f 4c 4f 43 4b 5f 45 52 52 4f 52 53 20  OCK_LOCK_ERRORS 
14cd0 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  */.  return rc;.
14ce0 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20  }.../*.** Lower 
14cf0 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65  the locking leve
14d00 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69  l on file descri
14d10 70 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46  ptor pFile to eF
14d20 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c  ileLock.  eFileL
14d30 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65  ock.** must be e
14d40 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72  ither NO_LOCK or
14d50 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a   SHARED_LOCK..**
14d60 0a 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69  .** If the locki
14d70 6e 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20  ng level of the 
14d80 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
14d90 69 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72  is already at or
14da0 20 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65   below.** the re
14db0 71 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20  quested locking 
14dc0 6c 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74  level, this rout
14dd0 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a  ine is a no-op..
14de0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 6c  */.static int fl
14df0 6f 63 6b 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65  ockUnlock(sqlite
14e00 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20  3_file *id, int 
14e10 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 75  eFileLock) {.  u
14e20 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d  nixFile *pFile =
14e30 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a   (unixFile*)id;.
14e40 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 46 69    .  assert( pFi
14e50 6c 65 20 29 3b 0a 20 20 4f 53 54 52 41 43 45 28  le );.  OSTRACE(
14e60 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25 64 20  ("UNLOCK  %d %d 
14e70 77 61 73 20 25 64 20 70 69 64 3d 25 64 20 28 66  was %d pid=%d (f
14e80 6c 6f 63 6b 29 5c 6e 22 2c 20 70 46 69 6c 65 2d  lock)\n", pFile-
14e90 3e 68 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20  >h, eFileLock,. 
14ea0 20 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d            pFile-
14eb0 3e 65 46 69 6c 65 4c 6f 63 6b 2c 20 6f 73 47 65  >eFileLock, osGe
14ec0 74 70 69 64 28 30 29 29 29 3b 0a 20 20 61 73 73  tpid(0)));.  ass
14ed0 65 72 74 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d  ert( eFileLock<=
14ee0 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20  SHARED_LOCK );. 
14ef0 20 0a 20 20 2f 2a 20 6e 6f 2d 6f 70 20 69 66 20   .  /* no-op if 
14f00 70 6f 73 73 69 62 6c 65 20 2a 2f 0a 20 20 69 66  possible */.  if
14f10 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f  ( pFile->eFileLo
14f20 63 6b 3d 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b  ck==eFileLock ){
14f30 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
14f40 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a 20 20  TE_OK;.  }.  .  
14f50 2f 2a 20 73 68 61 72 65 64 20 63 61 6e 20 6a 75  /* shared can ju
14f60 73 74 20 62 65 20 73 65 74 20 62 65 63 61 75 73  st be set becaus
14f70 65 20 77 65 20 61 6c 77 61 79 73 20 68 61 76 65  e we always have
14f80 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 2a 2f   an exclusive */
14f90 0a 20 20 69 66 20 28 65 46 69 6c 65 4c 6f 63 6b  .  if (eFileLock
14fa0 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 29 20 7b  ==SHARED_LOCK) {
14fb0 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c  .    pFile->eFil
14fc0 65 4c 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63  eLock = eFileLoc
14fd0 6b 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  k;.    return SQ
14fe0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 0a  LITE_OK;.  }.  .
14ff0 20 20 2f 2a 20 6e 6f 2c 20 72 65 61 6c 6c 79 2c    /* no, really,
15000 20 75 6e 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 69 66   unlock. */.  if
15010 28 20 72 6f 62 75 73 74 5f 66 6c 6f 63 6b 28 70  ( robust_flock(p
15020 46 69 6c 65 2d 3e 68 2c 20 4c 4f 43 4b 5f 55 4e  File->h, LOCK_UN
15030 29 20 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49  ) ){.#ifdef SQLI
15040 54 45 5f 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f  TE_IGNORE_FLOCK_
15050 4c 4f 43 4b 5f 45 52 52 4f 52 53 0a 20 20 20 20  LOCK_ERRORS.    
15060 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
15070 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  ;.#endif /* SQLI
15080 54 45 5f 49 47 4e 4f 52 45 5f 46 4c 4f 43 4b 5f  TE_IGNORE_FLOCK_
15090 4c 4f 43 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20  LOCK_ERRORS */. 
150a0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
150b0 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b 3b 0a 20  _IOERR_UNLOCK;. 
150c0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 46 69 6c   }else{.    pFil
150d0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e  e->eFileLock = N
150e0 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 72 65 74 75  O_LOCK;.    retu
150f0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
15100 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  }.}../*.** Close
15110 20 61 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74   a file..*/.stat
15120 69 63 20 69 6e 74 20 66 6c 6f 63 6b 43 6c 6f 73  ic int flockClos
15130 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a  e(sqlite3_file *
15140 69 64 29 20 7b 0a 20 20 61 73 73 65 72 74 28 20  id) {.  assert( 
15150 69 64 21 3d 30 20 29 3b 0a 20 20 66 6c 6f 63 6b  id!=0 );.  flock
15160 55 6e 6c 6f 63 6b 28 69 64 2c 20 4e 4f 5f 4c 4f  Unlock(id, NO_LO
15170 43 4b 29 3b 0a 20 20 72 65 74 75 72 6e 20 63 6c  CK);.  return cl
15180 6f 73 65 55 6e 69 78 46 69 6c 65 28 69 64 29 3b  oseUnixFile(id);
15190 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  .}..#endif /* SQ
151a0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b  LITE_ENABLE_LOCK
151b0 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 21 4f 53  ING_STYLE && !OS
151c0 5f 56 58 57 4f 52 4b 20 2a 2f 0a 0a 2f 2a 2a 2a  _VXWORK */../***
151d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
151e0 20 45 6e 64 20 6f 66 20 74 68 65 20 66 6c 6f 63   End of the floc
151f0 6b 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74  k lock implement
15200 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ation **********
15210 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a  ***********.****
15220 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15230 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15240 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15250 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15260 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 2a  **********/../**
15270 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15280 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
15290 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
152a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
152b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a  ************.***
152c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
152d0 2a 2a 2a 2a 2a 20 42 65 67 69 6e 20 4e 61 6d 65  ***** Begin Name
152e0 64 20 53 65 6d 61 70 68 6f 72 65 20 4c 6f 63 6b  d Semaphore Lock
152f0 69 6e 67 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ing ************
15300 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a  ************.**.
15310 2a 2a 20 4e 61 6d 65 64 20 73 65 6d 61 70 68 6f  ** Named semapho
15320 72 65 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6f 6e  re locking is on
15330 6c 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20  ly supported on 
15340 56 78 57 6f 72 6b 73 2e 0a 2a 2a 0a 2a 2a 20 53  VxWorks..**.** S
15350 65 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 69 6e 67  emaphore locking
15360 20 69 73 20 6c 69 6b 65 20 64 6f 74 2d 6c 6f 63   is like dot-loc
15370 6b 20 61 6e 64 20 66 6c 6f 63 6b 20 69 6e 20 74  k and flock in t
15380 68 61 74 20 69 74 20 72 65 61 6c 6c 79 20 6f 6e  hat it really on
15390 6c 79 0a 2a 2a 20 73 75 70 70 6f 72 74 73 20 45  ly.** supports E
153a0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 69 6e 67  XCLUSIVE locking
153b0 2e 20 20 4f 6e 6c 79 20 61 20 73 69 6e 67 6c 65  .  Only a single
153c0 20 70 72 6f 63 65 73 73 20 63 61 6e 20 72 65 61   process can rea
153d0 64 20 6f 72 20 77 72 69 74 65 0a 2a 2a 20 74 68  d or write.** th
153e0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
153f0 61 74 20 61 20 74 69 6d 65 2e 20 20 54 68 69 73  at a time.  This
15400 20 72 65 64 75 63 65 73 20 70 6f 74 65 6e 74 69   reduces potenti
15410 61 6c 20 63 6f 6e 63 75 72 72 65 6e 63 79 2c 20  al concurrency, 
15420 62 75 74 0a 2a 2a 20 6d 61 6b 65 73 20 74 68 65  but.** makes the
15430 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e 74 61   lock implementa
15440 74 69 6f 6e 20 6d 75 63 68 20 65 61 73 69 65 72  tion much easier
15450 2e 0a 2a 2f 0a 23 69 66 20 4f 53 5f 56 58 57 4f  ..*/.#if OS_VXWO
15460 52 4b 53 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  RKS../*.** This 
15470 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69  routine checks i
15480 66 20 74 68 65 72 65 20 69 73 20 61 20 52 45 53  f there is a RES
15490 45 52 56 45 44 20 6c 6f 63 6b 20 68 65 6c 64 20  ERVED lock held 
154a0 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64  on the specified
154b0 0a 2a 2a 20 66 69 6c 65 20 62 79 20 74 68 69 73  .** file by this
154c0 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 70 72   or any other pr
154d0 6f 63 65 73 73 2e 20 49 66 20 73 75 63 68 20 61  ocess. If such a
154e0 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 73   lock is held, s
154f0 65 74 20 2a 70 52 65 73 4f 75 74 0a 2a 2a 20 74  et *pResOut.** t
15500 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c  o a non-zero val
15510 75 65 20 6f 74 68 65 72 77 69 73 65 20 2a 70 52  ue otherwise *pR
15520 65 73 4f 75 74 20 69 73 20 73 65 74 20 74 6f 20  esOut is set to 
15530 7a 65 72 6f 2e 20 20 54 68 65 20 72 65 74 75 72  zero.  The retur
15540 6e 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65  n value.** is se
15550 74 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b 20 75  t to SQLITE_OK u
15560 6e 6c 65 73 73 20 61 6e 20 49 2f 4f 20 65 72 72  nless an I/O err
15570 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67  or occurs during
15580 20 6c 6f 63 6b 20 63 68 65 63 6b 69 6e 67 2e 0a   lock checking..
15590 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 65  */.static int se
155a0 6d 58 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c  mXCheckReservedL
155b0 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ock(sqlite3_file
155c0 20 2a 69 64 2c 20 69 6e 74 20 2a 70 52 65 73 4f   *id, int *pResO
155d0 75 74 29 20 7b 0a 20 20 69 6e 74 20 72 63 20 3d  ut) {.  int rc =
155e0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e   SQLITE_OK;.  in
155f0 74 20 72 65 73 65 72 76 65 64 20 3d 20 30 3b 0a  t reserved = 0;.
15600 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c    unixFile *pFil
15610 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69  e = (unixFile*)i
15620 64 3b 0a 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f  d;..  SimulateIO
15630 45 72 72 6f 72 28 20 72 65 74 75 72 6e 20 53 51  Error( return SQ
15640 4c 49 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b  LITE_IOERR_CHECK
15650 52 45 53 45 52 56 45 44 4c 4f 43 4b 3b 20 29 3b  RESERVEDLOCK; );
15660 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 46  .  .  assert( pF
15670 69 6c 65 20 29 3b 0a 0a 20 20 2f 2a 20 43 68 65  ile );..  /* Che
15680 63 6b 20 69 66 20 61 20 74 68 72 65 61 64 20 69  ck if a thread i
15690 6e 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 68  n this process h
156a0 6f 6c 64 73 20 73 75 63 68 20 61 20 6c 6f 63 6b  olds such a lock
156b0 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d   */.  if( pFile-
156c0 3e 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45  >eFileLock>SHARE
156d0 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 65  D_LOCK ){.    re
156e0 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a  served = 1;.  }.
156f0 20 20 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 73    .  /* Otherwis
15700 65 20 73 65 65 20 69 66 20 73 6f 6d 65 20 6f 74  e see if some ot
15710 68 65 72 20 70 72 6f 63 65 73 73 20 68 6f 6c 64  her process hold
15720 73 20 69 74 2e 20 2a 2f 0a 20 20 69 66 28 20 21  s it. */.  if( !
15730 72 65 73 65 72 76 65 64 20 29 7b 0a 20 20 20 20  reserved ){.    
15740 73 65 6d 5f 74 20 2a 70 53 65 6d 20 3d 20 70 46  sem_t *pSem = pF
15750 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53 65  ile->pInode->pSe
15760 6d 3b 0a 0a 20 20 20 20 69 66 28 20 73 65 6d 5f  m;..    if( sem_
15770 74 72 79 77 61 69 74 28 70 53 65 6d 29 3d 3d 2d  trywait(pSem)==-
15780 31 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 74  1 ){.      int t
15790 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20  Errno = errno;. 
157a0 20 20 20 20 20 69 66 28 20 45 41 47 41 49 4e 20       if( EAGAIN 
157b0 21 3d 20 74 45 72 72 6e 6f 20 29 7b 0a 20 20 20  != tErrno ){.   
157c0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
157d0 45 72 72 6f 72 46 72 6f 6d 50 6f 73 69 78 45 72  ErrorFromPosixEr
157e0 72 6f 72 28 74 45 72 72 6e 6f 2c 20 53 51 4c 49  ror(tErrno, SQLI
157f0 54 45 5f 49 4f 45 52 52 5f 43 48 45 43 4b 52 45  TE_IOERR_CHECKRE
15800 53 45 52 56 45 44 4c 4f 43 4b 29 3b 0a 20 20 20  SERVEDLOCK);.   
15810 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45 72       storeLastEr
15820 72 6e 6f 28 70 46 69 6c 65 2c 20 74 45 72 72 6e  rno(pFile, tErrn
15830 6f 29 3b 0a 20 20 20 20 20 20 7d 20 65 6c 73 65  o);.      } else
15840 20 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 73 6f   {.        /* so
15850 6d 65 6f 6e 65 20 65 6c 73 65 20 68 61 73 20 74  meone else has t
15860 68 65 20 6c 6f 63 6b 20 77 68 65 6e 20 77 65 20  he lock when we 
15870 61 72 65 20 69 6e 20 4e 4f 5f 4c 4f 43 4b 20 2a  are in NO_LOCK *
15880 2f 0a 20 20 20 20 20 20 20 20 72 65 73 65 72 76  /.        reserv
15890 65 64 20 3d 20 28 70 46 69 6c 65 2d 3e 65 46 69  ed = (pFile->eFi
158a0 6c 65 4c 6f 63 6b 20 3c 20 53 48 41 52 45 44 5f  leLock < SHARED_
158b0 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 7d 0a 20  LOCK);.      }. 
158c0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
158d0 2f 2a 20 77 65 20 63 6f 75 6c 64 20 68 61 76 65  /* we could have
158e0 20 69 74 20 69 66 20 77 65 20 77 61 6e 74 20 69   it if we want i
158f0 74 20 2a 2f 0a 20 20 20 20 20 20 73 65 6d 5f 70  t */.      sem_p
15900 6f 73 74 28 70 53 65 6d 29 3b 0a 20 20 20 20 7d  ost(pSem);.    }
15910 0a 20 20 7d 0a 20 20 4f 53 54 52 41 43 45 28 28  .  }.  OSTRACE((
15920 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64  "TEST WR-LOCK %d
15930 20 25 64 20 25 64 20 28 73 65 6d 29 5c 6e 22 2c   %d %d (sem)\n",
15940 20 70 46 69 6c 65 2d 3e 68 2c 20 72 63 2c 20 72   pFile->h, rc, r
15950 65 73 65 72 76 65 64 29 29 3b 0a 0a 20 20 2a 70  eserved));..  *p
15960 52 65 73 4f 75 74 20 3d 20 72 65 73 65 72 76 65  ResOut = reserve
15970 64 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  d;.  return rc;.
15980 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68  }../*.** Lock th
15990 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 20  e file with the 
159a0 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 64 20 62  lock specified b
159b0 79 20 70 61 72 61 6d 65 74 65 72 20 65 46 69 6c  y parameter eFil
159c0 65 4c 6f 63 6b 20 2d 20 6f 6e 65 0a 2a 2a 20 6f  eLock - one.** o
159d0 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a  f the following:
159e0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 53  .**.**     (1) S
159f0 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20  HARED_LOCK.**   
15a00 20 20 28 32 29 20 52 45 53 45 52 56 45 44 5f 4c    (2) RESERVED_L
15a10 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 20 50  OCK.**     (3) P
15a20 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20  ENDING_LOCK.**  
15a30 20 20 20 28 34 29 20 45 58 43 4c 55 53 49 56 45     (4) EXCLUSIVE
15a40 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65  _LOCK.**.** Some
15a50 74 69 6d 65 73 20 77 68 65 6e 20 72 65 71 75 65  times when reque
15a60 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73  sting one lock s
15a70 74 61 74 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c  tate, additional
15a80 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20   lock states.** 
15a90 61 72 65 20 69 6e 73 65 72 74 65 64 20 69 6e 20  are inserted in 
15aa0 62 65 74 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f  between.  The lo
15ab0 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 69 6c  cking might fail
15ac0 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c   on one of the l
15ad0 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69  ater.** transiti
15ae0 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 65 20  ons leaving the 
15af0 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 66 66 65  lock state diffe
15b00 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 69  rent from what i
15b10 74 20 73 74 61 72 74 65 64 20 62 75 74 0a 2a 2a  t started but.**
15b20 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20   still short of 
15b30 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 20 66  its goal.  The f
15b40 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 20 73  ollowing chart s
15b50 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 65 64  hows the allowed
15b60 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20  .** transitions 
15b70 61 6e 64 20 74 68 65 20 69 6e 73 65 72 74 65 64  and the inserted
15b80 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 73 74   intermediate st
15b90 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55  ates:.**.**    U
15ba0 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 52 45  NLOCKED -> SHARE
15bb0 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d  D.**    SHARED -
15bc0 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 20 20  > RESERVED.**   
15bd0 20 53 48 41 52 45 44 20 2d 3e 20 28 50 45 4e 44   SHARED -> (PEND
15be0 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56  ING) -> EXCLUSIV
15bf0 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 45 44  E.**    RESERVED
15c00 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e   -> (PENDING) ->
15c10 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20   EXCLUSIVE.**   
15c20 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c   PENDING -> EXCL
15c30 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 53 65 6d 61  USIVE.**.** Sema
15c40 70 68 6f 72 65 20 6c 6f 63 6b 73 20 6f 6e 6c 79  phore locks only
15c50 20 72 65 61 6c 6c 79 20 73 75 70 70 6f 72 74 20   really support 
15c60 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 73 2e  EXCLUSIVE locks.
15c70 20 20 57 65 20 74 72 61 63 6b 20 69 6e 74 65 72    We track inter
15c80 6d 65 64 69 61 74 65 0a 2a 2a 20 6c 6f 63 6b 20  mediate.** lock 
15c90 73 74 61 74 65 73 20 69 6e 20 74 68 65 20 73 71  states in the sq
15ca0 6c 69 74 65 33 5f 66 69 6c 65 20 73 74 72 75 63  lite3_file struc
15cb0 74 75 72 65 2c 20 62 75 74 20 61 6c 6c 20 6c 6f  ture, but all lo
15cc0 63 6b 73 20 53 48 41 52 45 44 20 6f 72 0a 2a 2a  cks SHARED or.**
15cd0 20 61 62 6f 76 65 20 61 72 65 20 72 65 61 6c 6c   above are reall
15ce0 79 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b  y EXCLUSIVE lock
15cf0 73 20 61 6e 64 20 65 78 63 6c 75 64 65 20 61 6c  s and exclude al
15d00 6c 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65  l other processe
15d10 73 20 66 72 6f 6d 0a 2a 2a 20 61 63 63 65 73 73  s from.** access
15d20 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a   the file..**.**
15d30 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69   This routine wi
15d40 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 65 61 73 65  ll only increase
15d50 20 61 20 6c 6f 63 6b 2e 20 20 55 73 65 20 74 68   a lock.  Use th
15d60 65 20 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63  e sqlite3OsUnloc
15d70 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 74  k().** routine t
15d80 6f 20 6c 6f 77 65 72 20 61 20 6c 6f 63 6b 69 6e  o lower a lockin
15d90 67 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 73 74 61 74  g level..*/.stat
15da0 69 63 20 69 6e 74 20 73 65 6d 58 4c 6f 63 6b 28  ic int semXLock(
15db0 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64  sqlite3_file *id
15dc0 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29  , int eFileLock)
15dd0 20 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70   {.  unixFile *p
15de0 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65  File = (unixFile
15df0 2a 29 69 64 3b 0a 20 20 73 65 6d 5f 74 20 2a 70  *)id;.  sem_t *p
15e00 53 65 6d 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e  Sem = pFile->pIn
15e10 6f 64 65 2d 3e 70 53 65 6d 3b 0a 20 20 69 6e 74  ode->pSem;.  int
15e20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
15e30 0a 0a 20 20 2f 2a 20 69 66 20 77 65 20 61 6c 72  ..  /* if we alr
15e40 65 61 64 79 20 68 61 76 65 20 61 20 6c 6f 63 6b  eady have a lock
15e50 2c 20 69 74 20 69 73 20 65 78 63 6c 75 73 69 76  , it is exclusiv
15e60 65 2e 20 20 0a 20 20 2a 2a 20 4a 75 73 74 20 61  e.  .  ** Just a
15e70 64 6a 75 73 74 20 6c 65 76 65 6c 20 61 6e 64 20  djust level and 
15e80 70 75 6e 74 20 6f 6e 20 6f 75 74 74 61 20 68 65  punt on outta he
15e90 72 65 2e 20 2a 2f 0a 20 20 69 66 20 28 70 46 69  re. */.  if (pFi
15ea0 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3e 20  le->eFileLock > 
15eb0 4e 4f 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 70  NO_LOCK) {.    p
15ec0 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20  File->eFileLock 
15ed0 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20  = eFileLock;.   
15ee0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
15ef0 0a 20 20 20 20 67 6f 74 6f 20 73 65 6d 5f 65 6e  .    goto sem_en
15f00 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 0a 20  d_lock;.  }.  . 
15f10 20 2f 2a 20 6c 6f 63 6b 20 73 65 6d 61 70 68 6f   /* lock semapho
15f20 72 65 20 6e 6f 77 20 62 75 74 20 62 61 69 6c 20  re now but bail 
15f30 6f 75 74 20 77 68 65 6e 20 61 6c 72 65 61 64 79  out when already
15f40 20 6c 6f 63 6b 65 64 2e 20 2a 2f 0a 20 20 69 66   locked. */.  if
15f50 28 20 73 65 6d 5f 74 72 79 77 61 69 74 28 70 53  ( sem_trywait(pS
15f60 65 6d 29 3d 3d 2d 31 20 29 7b 0a 20 20 20 20 72  em)==-1 ){.    r
15f70 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b  c = SQLITE_BUSY;
15f80 0a 20 20 20 20 67 6f 74 6f 20 73 65 6d 5f 65 6e  .    goto sem_en
15f90 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f  d_lock;.  }..  /
15fa0 2a 20 67 6f 74 20 69 74 2c 20 73 65 74 20 74 68  * got it, set th
15fb0 65 20 74 79 70 65 20 61 6e 64 20 72 65 74 75 72  e type and retur
15fc0 6e 20 6f 6b 20 2a 2f 0a 20 20 70 46 69 6c 65 2d  n ok */.  pFile-
15fd0 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69  >eFileLock = eFi
15fe0 6c 65 4c 6f 63 6b 3b 0a 0a 20 73 65 6d 5f 65 6e  leLock;.. sem_en
15ff0 64 5f 6c 6f 63 6b 3a 0a 20 20 72 65 74 75 72 6e  d_lock:.  return
16000 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f   rc;.}../*.** Lo
16010 77 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20  wer the locking 
16020 6c 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65  level on file de
16030 73 63 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74  scriptor pFile t
16040 6f 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46  o eFileLock.  eF
16050 69 6c 65 4c 6f 63 6b 0a 2a 2a 20 6d 75 73 74 20  ileLock.** must 
16060 62 65 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43  be either NO_LOC
16070 4b 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b  K or SHARED_LOCK
16080 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6c  ..**.** If the l
16090 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 66 20  ocking level of 
160a0 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70  the file descrip
160b0 74 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 61  tor is already a
160c0 74 20 6f 72 20 62 65 6c 6f 77 0a 2a 2a 20 74 68  t or below.** th
160d0 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b  e requested lock
160e0 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68 69 73 20  ing level, this 
160f0 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d  routine is a no-
16100 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  op..*/.static in
16110 74 20 73 65 6d 58 55 6e 6c 6f 63 6b 28 73 71 6c  t semXUnlock(sql
16120 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69  ite3_file *id, i
16130 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29 20 7b 0a  nt eFileLock) {.
16140 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c    unixFile *pFil
16150 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69  e = (unixFile*)i
16160 64 3b 0a 20 20 73 65 6d 5f 74 20 2a 70 53 65 6d  d;.  sem_t *pSem
16170 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65   = pFile->pInode
16180 2d 3e 70 53 65 6d 3b 0a 0a 20 20 61 73 73 65 72  ->pSem;..  asser
16190 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 61 73  t( pFile );.  as
161a0 73 65 72 74 28 20 70 53 65 6d 20 29 3b 0a 20 20  sert( pSem );.  
161b0 4f 53 54 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b  OSTRACE(("UNLOCK
161c0 20 20 25 64 20 25 64 20 77 61 73 20 25 64 20 70    %d %d was %d p
161d0 69 64 3d 25 64 20 28 73 65 6d 29 5c 6e 22 2c 20  id=%d (sem)\n", 
161e0 70 46 69 6c 65 2d 3e 68 2c 20 65 46 69 6c 65 4c  pFile->h, eFileL
161f0 6f 63 6b 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ock,.           
16200 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b  pFile->eFileLock
16210 2c 20 6f 73 47 65 74 70 69 64 28 30 29 29 29 3b  , osGetpid(0)));
16220 0a 20 20 61 73 73 65 72 74 28 20 65 46 69 6c 65  .  assert( eFile
16230 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f 43  Lock<=SHARED_LOC
16240 4b 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 6e 6f 2d  K );.  .  /* no-
16250 6f 70 20 69 66 20 70 6f 73 73 69 62 6c 65 20 2a  op if possible *
16260 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65  /.  if( pFile->e
16270 46 69 6c 65 4c 6f 63 6b 3d 3d 65 46 69 6c 65 4c  FileLock==eFileL
16280 6f 63 6b 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ock ){.    retur
16290 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
162a0 0a 20 20 0a 20 20 2f 2a 20 73 68 61 72 65 64 20  .  .  /* shared 
162b0 63 61 6e 20 6a 75 73 74 20 62 65 20 73 65 74 20  can just be set 
162c0 62 65 63 61 75 73 65 20 77 65 20 61 6c 77 61 79  because we alway
162d0 73 20 68 61 76 65 20 61 6e 20 65 78 63 6c 75 73  s have an exclus
162e0 69 76 65 20 2a 2f 0a 20 20 69 66 20 28 65 46 69  ive */.  if (eFi
162f0 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c  leLock==SHARED_L
16300 4f 43 4b 29 20 7b 0a 20 20 20 20 70 46 69 6c 65  OCK) {.    pFile
16310 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46  ->eFileLock = eF
16320 69 6c 65 4c 6f 63 6b 3b 0a 20 20 20 20 72 65 74  ileLock;.    ret
16330 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
16340 20 7d 0a 20 20 0a 20 20 2f 2a 20 6e 6f 2c 20 72   }.  .  /* no, r
16350 65 61 6c 6c 79 20 75 6e 6c 6f 63 6b 2e 20 2a 2f  eally unlock. */
16360 0a 20 20 69 66 20 28 20 73 65 6d 5f 70 6f 73 74  .  if ( sem_post
16370 28 70 53 65 6d 29 3d 3d 2d 31 20 29 20 7b 0a 20  (pSem)==-1 ) {. 
16380 20 20 20 69 6e 74 20 72 63 2c 20 74 45 72 72 6e     int rc, tErrn
16390 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20 20 20 72  o = errno;.    r
163a0 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72 46  c = sqliteErrorF
163b0 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74 45  romPosixError(tE
163c0 72 72 6e 6f 2c 20 53 51 4c 49 54 45 5f 49 4f 45  rrno, SQLITE_IOE
163d0 52 52 5f 55 4e 4c 4f 43 4b 29 3b 0a 20 20 20 20  RR_UNLOCK);.    
163e0 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f  if( IS_LOCK_ERRO
163f0 52 28 72 63 29 20 29 7b 0a 20 20 20 20 20 20 73  R(rc) ){.      s
16400 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 46  toreLastErrno(pF
16410 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a 20 20  ile, tErrno);.  
16420 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 72    }.    return r
16430 63 3b 20 0a 20 20 7d 0a 20 20 70 46 69 6c 65 2d  c; .  }.  pFile-
16440 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f 5f  >eFileLock = NO_
16450 4c 4f 43 4b 3b 0a 20 20 72 65 74 75 72 6e 20 53  LOCK;.  return S
16460 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
16470 20 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c 65   ** Close a file
16480 2e 0a 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  .. */.static int
16490 20 73 65 6d 58 43 6c 6f 73 65 28 73 71 6c 69 74   semXClose(sqlit
164a0 65 33 5f 66 69 6c 65 20 2a 69 64 29 20 7b 0a 20  e3_file *id) {. 
164b0 20 69 66 28 20 69 64 20 29 7b 0a 20 20 20 20 75   if( id ){.    u
164c0 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d  nixFile *pFile =
164d0 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a   (unixFile*)id;.
164e0 20 20 20 20 73 65 6d 58 55 6e 6c 6f 63 6b 28 69      semXUnlock(i
164f0 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 20  d, NO_LOCK);.   
16500 20 61 73 73 65 72 74 28 20 70 46 69 6c 65 20 29   assert( pFile )
16510 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 75 6e  ;.    assert( un
16520 69 78 46 69 6c 65 4d 75 74 65 78 4e 6f 74 68 65  ixFileMutexNothe
16530 6c 64 28 70 46 69 6c 65 29 20 29 3b 0a 20 20 20  ld(pFile) );.   
16540 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78 28   unixEnterMutex(
16550 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 49 6e  );.    releaseIn
16560 6f 64 65 49 6e 66 6f 28 70 46 69 6c 65 29 3b 0a  odeInfo(pFile);.
16570 20 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74      unixLeaveMut
16580 65 78 28 29 3b 0a 20 20 20 20 63 6c 6f 73 65 55  ex();.    closeU
16590 6e 69 78 46 69 6c 65 28 69 64 29 3b 0a 20 20 7d  nixFile(id);.  }
165a0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
165b0 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f  _OK;.}..#endif /
165c0 2a 20 4f 53 5f 56 58 57 4f 52 4b 53 20 2a 2f 0a  * OS_VXWORKS */.
165d0 2f 2a 0a 2a 2a 20 4e 61 6d 65 64 20 73 65 6d 61  /*.** Named sema
165e0 70 68 6f 72 65 20 6c 6f 63 6b 69 6e 67 20 69 73  phore locking is
165f0 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20   only available 
16600 6f 6e 20 56 78 57 6f 72 6b 73 2e 0a 2a 2a 0a 2a  on VxWorks..**.*
16610 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45  ************** E
16620 6e 64 20 6f 66 20 74 68 65 20 6e 61 6d 65 64 20  nd of the named 
16630 73 65 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 20 69  semaphore lock i
16640 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a  mplementation **
16650 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
16660 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16670 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16680 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16690 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
166a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
166b0 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
166c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
166d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
166e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
166f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16700 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .***************
16710 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67  ************ Beg
16720 69 6e 20 41 46 50 20 4c 6f 63 6b 69 6e 67 20 2a  in AFP Locking *
16730 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16740 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
16750 0a 2a 2a 0a 2a 2a 20 41 46 50 20 69 73 20 74 68  .**.** AFP is th
16760 65 20 41 70 70 6c 65 20 46 69 6c 69 6e 67 20 50  e Apple Filing P
16770 72 6f 74 6f 63 6f 6c 2e 20 20 41 46 50 20 69 73  rotocol.  AFP is
16780 20 61 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 73   a network files
16790 79 73 74 65 6d 20 66 6f 75 6e 64 0a 2a 2a 20 6f  ystem found.** o
167a0 6e 20 41 70 70 6c 65 20 4d 61 63 69 6e 74 6f 73  n Apple Macintos
167b0 68 20 63 6f 6d 70 75 74 65 72 73 20 2d 20 62 6f  h computers - bo
167c0 74 68 20 4f 53 39 20 61 6e 64 20 4f 53 58 2e 0a  th OS9 and OSX..
167d0 2a 2a 0a 2a 2a 20 54 68 69 72 64 2d 70 61 72 74  **.** Third-part
167e0 79 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  y implementation
167f0 73 20 6f 66 20 41 46 50 20 61 72 65 20 61 76 61  s of AFP are ava
16800 69 6c 61 62 6c 65 2e 20 20 42 75 74 20 74 68 69  ilable.  But thi
16810 73 20 63 6f 64 65 20 68 65 72 65 0a 2a 2a 20 6f  s code here.** o
16820 6e 6c 79 20 77 6f 72 6b 73 20 6f 6e 20 4f 53 58  nly works on OSX
16830 2e 0a 2a 2f 0a 0a 23 69 66 20 64 65 66 69 6e 65  ..*/..#if define
16840 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20  d(__APPLE__) && 
16850 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f  SQLITE_ENABLE_LO
16860 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 2f 2a 0a 2a  CKING_STYLE./*.*
16870 2a 20 54 68 65 20 61 66 70 4c 6f 63 6b 69 6e 67  * The afpLocking
16880 43 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72  Context structur
16890 65 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 61  e contains all a
168a0 66 70 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 63  fp lock specific
168b0 20 73 74 61 74 65 0a 2a 2f 0a 74 79 70 65 64 65   state.*/.typede
168c0 66 20 73 74 72 75 63 74 20 61 66 70 4c 6f 63 6b  f struct afpLock
168d0 69 6e 67 43 6f 6e 74 65 78 74 20 61 66 70 4c 6f  ingContext afpLo
168e0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b 0a 73 74  ckingContext;.st
168f0 72 75 63 74 20 61 66 70 4c 6f 63 6b 69 6e 67 43  ruct afpLockingC
16900 6f 6e 74 65 78 74 20 7b 0a 20 20 69 6e 74 20 72  ontext {.  int r
16910 65 73 65 72 76 65 64 3b 0a 20 20 63 6f 6e 73 74  eserved;.  const
16920 20 63 68 61 72 20 2a 64 62 50 61 74 68 3b 20 20   char *dbPath;  
16930 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61             /* Na
16940 6d 65 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 66  me of the open f
16950 69 6c 65 20 2a 2f 0a 7d 3b 0a 0a 73 74 72 75 63  ile */.};..struc
16960 74 20 42 79 74 65 52 61 6e 67 65 4c 6f 63 6b 50  t ByteRangeLockP
16970 42 32 0a 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20  B2.{.  unsigned 
16980 6c 6f 6e 67 20 6c 6f 6e 67 20 6f 66 66 73 65 74  long long offset
16990 3b 20 20 20 20 20 20 20 20 2f 2a 20 6f 66 66 73  ;        /* offs
169a0 65 74 20 74 6f 20 66 69 72 73 74 20 62 79 74 65  et to first byte
169b0 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e   to lock */.  un
169c0 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67  signed long long
169d0 20 6c 65 6e 67 74 68 3b 20 20 20 20 20 20 20 20   length;        
169e0 2f 2a 20 6e 62 72 20 6f 66 20 62 79 74 65 73 20  /* nbr of bytes 
169f0 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e 73  to lock */.  uns
16a00 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20  igned long long 
16a10 72 65 74 52 61 6e 67 65 53 74 61 72 74 3b 20 2f  retRangeStart; /
16a20 2a 20 6e 62 72 20 6f 66 20 31 73 74 20 62 79 74  * nbr of 1st byt
16a30 65 20 6c 6f 63 6b 65 64 20 69 66 20 73 75 63 63  e locked if succ
16a40 65 73 73 66 75 6c 20 2a 2f 0a 20 20 75 6e 73 69  essful */.  unsi
16a50 67 6e 65 64 20 63 68 61 72 20 75 6e 4c 6f 63 6b  gned char unLock
16a60 46 6c 61 67 3b 20 20 20 20 20 20 20 20 20 2f 2a  Flag;         /*
16a70 20 31 20 3d 20 75 6e 6c 6f 63 6b 2c 20 30 20 3d   1 = unlock, 0 =
16a80 20 6c 6f 63 6b 20 2a 2f 0a 20 20 75 6e 73 69 67   lock */.  unsig
16a90 6e 65 64 20 63 68 61 72 20 73 74 61 72 74 45 6e  ned char startEn
16aa0 64 46 6c 61 67 3b 20 20 20 20 20 20 20 2f 2a 20  dFlag;       /* 
16ab0 31 3d 72 65 6c 20 74 6f 20 65 6e 64 20 6f 66 20  1=rel to end of 
16ac0 66 6f 72 6b 2c 20 30 3d 72 65 6c 20 74 6f 20 73  fork, 0=rel to s
16ad0 74 61 72 74 20 2a 2f 0a 20 20 69 6e 74 20 66 64  tart */.  int fd
16ae0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
16af0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66              /* f
16b00 69 6c 65 20 64 65 73 63 20 74 6f 20 61 73 73 6f  ile desc to asso
16b10 63 20 74 68 69 73 20 6c 6f 63 6b 20 77 69 74 68  c this lock with
16b20 20 2a 2f 0a 7d 3b 0a 0a 23 64 65 66 69 6e 65 20   */.};..#define 
16b30 61 66 70 66 73 42 79 74 65 52 61 6e 67 65 4c 6f  afpfsByteRangeLo
16b40 63 6b 32 46 53 43 54 4c 20 20 20 20 20 20 20 20  ck2FSCTL        
16b50 5f 49 4f 57 52 28 27 7a 27 2c 20 32 33 2c 20 73  _IOWR('z', 23, s
16b60 74 72 75 63 74 20 42 79 74 65 52 61 6e 67 65 4c  truct ByteRangeL
16b70 6f 63 6b 50 42 32 29 0a 0a 2f 2a 0a 2a 2a 20 54  ockPB2)../*.** T
16b80 68 69 73 20 69 73 20 61 20 75 74 69 6c 69 74 79  his is a utility
16b90 20 66 6f 72 20 73 65 74 74 69 6e 67 20 6f 72 20   for setting or 
16ba0 63 6c 65 61 72 69 6e 67 20 61 20 62 69 74 2d 72  clearing a bit-r
16bb0 61 6e 67 65 20 6c 6f 63 6b 20 6f 6e 20 61 6e 0a  ange lock on an.
16bc0 2a 2a 20 41 46 50 20 66 69 6c 65 73 79 73 74 65  ** AFP filesyste
16bd0 6d 2e 0a 2a 2a 20 0a 2a 2a 20 52 65 74 75 72 6e  m..** .** Return
16be0 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75   SQLITE_OK on su
16bf0 63 63 65 73 73 2c 20 53 51 4c 49 54 45 5f 42 55  ccess, SQLITE_BU
16c00 53 59 20 6f 6e 20 66 61 69 6c 75 72 65 2e 0a 2a  SY on failure..*
16c10 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66 70  /.static int afp
16c20 53 65 74 4c 6f 63 6b 28 0a 20 20 63 6f 6e 73 74  SetLock(.  const
16c30 20 63 68 61 72 20 2a 70 61 74 68 2c 20 20 20 20   char *path,    
16c40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d            /* Nam
16c50 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f  e of the file to
16c60 20 62 65 20 6c 6f 63 6b 65 64 20 6f 72 20 75 6e   be locked or un
16c70 6c 6f 63 6b 65 64 20 2a 2f 0a 20 20 75 6e 69 78  locked */.  unix
16c80 46 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20 20  File *pFile,    
16c90 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70             /* Op
16ca0 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  en file descript
16cb0 6f 72 20 6f 6e 20 70 61 74 68 20 2a 2f 0a 20 20  or on path */.  
16cc0 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f  unsigned long lo
16cd0 6e 67 20 6f 66 66 73 65 74 2c 20 20 20 20 20 2f  ng offset,     /
16ce0 2a 20 46 69 72 73 74 20 62 79 74 65 20 74 6f 20  * First byte to 
16cf0 62 65 20 6c 6f 63 6b 65 64 20 2a 2f 0a 20 20 75  be locked */.  u
16d00 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e  nsigned long lon
16d10 67 20 6c 65 6e 67 74 68 2c 20 20 20 20 20 2f 2a  g length,     /*
16d20 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   Number of bytes
16d30 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e   to lock */.  in
16d40 74 20 73 65 74 4c 6f 63 6b 46 6c 61 67 20 20 20  t setLockFlag   
16d50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
16d60 54 72 75 65 20 74 6f 20 73 65 74 20 6c 6f 63 6b  True to set lock
16d70 2e 20 20 46 61 6c 73 65 20 74 6f 20 63 6c 65 61  .  False to clea
16d80 72 20 6c 6f 63 6b 20 2a 2f 0a 29 7b 0a 20 20 73  r lock */.){.  s
16d90 74 72 75 63 74 20 42 79 74 65 52 61 6e 67 65 4c  truct ByteRangeL
16da0 6f 63 6b 50 42 32 20 70 62 3b 0a 20 20 69 6e 74  ockPB2 pb;.  int
16db0 20 65 72 72 3b 0a 20 20 0a 20 20 70 62 2e 75 6e   err;.  .  pb.un
16dc0 4c 6f 63 6b 46 6c 61 67 20 3d 20 73 65 74 4c 6f  LockFlag = setLo
16dd0 63 6b 46 6c 61 67 20 3f 20 30 20 3a 20 31 3b 0a  ckFlag ? 0 : 1;.
16de0 20 20 70 62 2e 73 74 61 72 74 45 6e 64 46 6c 61    pb.startEndFla
16df0 67 20 3d 20 30 3b 0a 20 20 70 62 2e 6f 66 66 73  g = 0;.  pb.offs
16e00 65 74 20 3d 20 6f 66 66 73 65 74 3b 0a 20 20 70  et = offset;.  p
16e10 62 2e 6c 65 6e 67 74 68 20 3d 20 6c 65 6e 67 74  b.length = lengt
16e20 68 3b 20 0a 20 20 70 62 2e 66 64 20 3d 20 70 46  h; .  pb.fd = pF
16e30 69 6c 65 2d 3e 68 3b 0a 20 20 0a 20 20 4f 53 54  ile->h;.  .  OST
16e40 52 41 43 45 28 28 22 41 46 50 53 45 54 4c 4f 43  RACE(("AFPSETLOC
16e50 4b 20 5b 25 73 5d 20 66 6f 72 20 25 64 25 73 20  K [%s] for %d%s 
16e60 69 6e 20 72 61 6e 67 65 20 25 6c 6c 78 3a 25 6c  in range %llx:%l
16e70 6c 78 5c 6e 22 2c 20 0a 20 20 20 20 28 73 65 74  lx\n", .    (set
16e80 4c 6f 63 6b 46 6c 61 67 3f 22 4f 4e 22 3a 22 4f  LockFlag?"ON":"O
16e90 46 46 22 29 2c 20 70 46 69 6c 65 2d 3e 68 2c 20  FF"), pFile->h, 
16ea0 28 70 62 2e 66 64 3d 3d 2d 31 3f 22 5b 74 65 73  (pb.fd==-1?"[tes
16eb0 74 76 61 6c 2d 31 5d 22 3a 22 22 29 2c 0a 20 20  tval-1]":""),.  
16ec0 20 20 6f 66 66 73 65 74 2c 20 6c 65 6e 67 74 68    offset, length
16ed0 29 29 3b 0a 20 20 65 72 72 20 3d 20 66 73 63 74  ));.  err = fsct
16ee0 6c 28 70 61 74 68 2c 20 61 66 70 66 73 42 79 74  l(path, afpfsByt
16ef0 65 52 61 6e 67 65 4c 6f 63 6b 32 46 53 43 54 4c  eRangeLock2FSCTL
16f00 2c 20 26 70 62 2c 20 30 29 3b 0a 20 20 69 66 20  , &pb, 0);.  if 
16f10 28 20 65 72 72 3d 3d 2d 31 20 29 20 7b 0a 20 20  ( err==-1 ) {.  
16f20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 69 6e    int rc;.    in
16f30 74 20 74 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f  t tErrno = errno
16f40 3b 0a 20 20 20 20 4f 53 54 52 41 43 45 28 28 22  ;.    OSTRACE(("
16f50 41 46 50 53 45 54 4c 4f 43 4b 20 66 61 69 6c 65  AFPSETLOCK faile
16f60 64 20 74 6f 20 66 73 63 74 6c 28 29 20 27 25 73  d to fsctl() '%s
16f70 27 20 25 64 20 25 73 5c 6e 22 2c 0a 20 20 20 20  ' %d %s\n",.    
16f80 20 20 20 20 20 20 20 20 20 70 61 74 68 2c 20 74           path, t
16f90 45 72 72 6e 6f 2c 20 73 74 72 65 72 72 6f 72 28  Errno, strerror(
16fa0 74 45 72 72 6e 6f 29 29 29 3b 0a 23 69 66 64 65  tErrno)));.#ifde
16fb0 66 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45 5f  f SQLITE_IGNORE_
16fc0 41 46 50 5f 4c 4f 43 4b 5f 45 52 52 4f 52 53 0a  AFP_LOCK_ERRORS.
16fd0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
16fe0 42 55 53 59 3b 0a 23 65 6c 73 65 0a 20 20 20 20  BUSY;.#else.    
16ff0 72 63 20 3d 20 73 71 6c 69 74 65 45 72 72 6f 72  rc = sqliteError
17000 46 72 6f 6d 50 6f 73 69 78 45 72 72 6f 72 28 74  FromPosixError(t
17010 45 72 72 6e 6f 2c 0a 20 20 20 20 20 20 20 20 20  Errno,.         
17020 20 20 20 20 20 20 20 20 20 20 20 73 65 74 4c 6f             setLo
17030 63 6b 46 6c 61 67 20 3f 20 53 51 4c 49 54 45 5f  ckFlag ? SQLITE_
17040 49 4f 45 52 52 5f 4c 4f 43 4b 20 3a 20 53 51 4c  IOERR_LOCK : SQL
17050 49 54 45 5f 49 4f 45 52 52 5f 55 4e 4c 4f 43 4b  ITE_IOERR_UNLOCK
17060 29 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  );.#endif /* SQL
17070 49 54 45 5f 49 47 4e 4f 52 45 5f 41 46 50 5f 4c  ITE_IGNORE_AFP_L
17080 4f 43 4b 5f 45 52 52 4f 52 53 20 2a 2f 0a 20 20  OCK_ERRORS */.  
17090 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52    if( IS_LOCK_ER
170a0 52 4f 52 28 72 63 29 20 29 7b 0a 20 20 20 20 20  ROR(rc) ){.     
170b0 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28   storeLastErrno(
170c0 70 46 69 6c 65 2c 20 74 45 72 72 6e 6f 29 3b 0a  pFile, tErrno);.
170d0 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e      }.    return
170e0 20 72 63 3b 0a 20 20 7d 20 65 6c 73 65 20 7b 0a   rc;.  } else {.
170f0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
17100 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  E_OK;.  }.}../*.
17110 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
17120 63 68 65 63 6b 73 20 69 66 20 74 68 65 72 65 20  checks if there 
17130 69 73 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f  is a RESERVED lo
17140 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 73  ck held on the s
17150 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65  pecified.** file
17160 20 62 79 20 74 68 69 73 20 6f 72 20 61 6e 79 20   by this or any 
17170 6f 74 68 65 72 20 70 72 6f 63 65 73 73 2e 20 49  other process. I
17180 66 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 73  f such a lock is
17190 20 68 65 6c 64 2c 20 73 65 74 20 2a 70 52 65 73   held, set *pRes
171a0 4f 75 74 0a 2a 2a 20 74 6f 20 61 20 6e 6f 6e 2d  Out.** to a non-
171b0 7a 65 72 6f 20 76 61 6c 75 65 20 6f 74 68 65 72  zero value other
171c0 77 69 73 65 20 2a 70 52 65 73 4f 75 74 20 69 73  wise *pResOut is
171d0 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 20 54   set to zero.  T
171e0 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 0a  he return value.
171f0 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 53 51 4c  ** is set to SQL
17200 49 54 45 5f 4f 4b 20 75 6e 6c 65 73 73 20 61 6e  ITE_OK unless an
17210 20 49 2f 4f 20 65 72 72 6f 72 20 6f 63 63 75 72   I/O error occur
17220 73 20 64 75 72 69 6e 67 20 6c 6f 63 6b 20 63 68  s during lock ch
17230 65 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69  ecking..*/.stati
17240 63 20 69 6e 74 20 61 66 70 43 68 65 63 6b 52 65  c int afpCheckRe
17250 73 65 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74  servedLock(sqlit
17260 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74  e3_file *id, int
17270 20 2a 70 52 65 73 4f 75 74 29 7b 0a 20 20 69 6e   *pResOut){.  in
17280 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
17290 3b 0a 20 20 69 6e 74 20 72 65 73 65 72 76 65 64  ;.  int reserved
172a0 20 3d 20 30 3b 0a 20 20 75 6e 69 78 46 69 6c 65   = 0;.  unixFile
172b0 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46   *pFile = (unixF
172c0 69 6c 65 2a 29 69 64 3b 0a 20 20 61 66 70 4c 6f  ile*)id;.  afpLo
172d0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 63 6f  ckingContext *co
172e0 6e 74 65 78 74 3b 0a 20 20 0a 20 20 53 69 6d 75  ntext;.  .  Simu
172f0 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65 74  lateIOError( ret
17300 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  urn SQLITE_IOERR
17310 5f 43 48 45 43 4b 52 45 53 45 52 56 45 44 4c 4f  _CHECKRESERVEDLO
17320 43 4b 3b 20 29 3b 0a 20 20 0a 20 20 61 73 73 65  CK; );.  .  asse
17330 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 63  rt( pFile );.  c
17340 6f 6e 74 65 78 74 20 3d 20 28 61 66 70 4c 6f 63  ontext = (afpLoc
17350 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29 20 70  kingContext *) p
17360 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e  File->lockingCon
17370 74 65 78 74 3b 0a 20 20 69 66 28 20 63 6f 6e 74  text;.  if( cont
17380 65 78 74 2d 3e 72 65 73 65 72 76 65 64 20 29 7b  ext->reserved ){
17390 0a 20 20 20 20 2a 70 52 65 73 4f 75 74 20 3d 20  .    *pResOut = 
173a0 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  1;.    return SQ
173b0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 73  LITE_OK;.  }.  s
173c0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
173d0 65 72 28 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65  er(pFile->pInode
173e0 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a 20  ->pLockMutex);. 
173f0 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 20 74   /* Check if a t
17400 68 72 65 61 64 20 69 6e 20 74 68 69 73 20 70 72  hread in this pr
17410 6f 63 65 73 73 20 68 6f 6c 64 73 20 73 75 63 68  ocess holds such
17420 20 61 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 66 28   a lock */.  if(
17430 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e   pFile->pInode->
17440 65 46 69 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44  eFileLock>SHARED
17450 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 65 73  _LOCK ){.    res
17460 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20  erved = 1;.  }. 
17470 20 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 73 65   .  /* Otherwise
17480 20 73 65 65 20 69 66 20 73 6f 6d 65 20 6f 74 68   see if some oth
17490 65 72 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73  er process holds
174a0 20 69 74 2e 0a 20 20 20 2a 2f 0a 20 20 69 66 28   it..   */.  if(
174b0 20 21 72 65 73 65 72 76 65 64 20 29 7b 0a 20 20   !reserved ){.  
174c0 20 20 2f 2a 20 6c 6f 63 6b 20 74 68 65 20 52 45    /* lock the RE
174d0 53 45 52 56 45 44 20 62 79 74 65 20 2a 2f 0a 20  SERVED byte */. 
174e0 20 20 20 69 6e 74 20 6c 72 63 20 3d 20 61 66 70     int lrc = afp
174f0 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d  SetLock(context-
17500 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20  >dbPath, pFile, 
17510 52 45 53 45 52 56 45 44 5f 42 59 54 45 2c 20 31  RESERVED_BYTE, 1
17520 2c 31 29 3b 20 20 0a 20 20 20 20 69 66 28 20 53  ,1);  .    if( S
17530 51 4c 49 54 45 5f 4f 4b 3d 3d 6c 72 63 20 29 7b  QLITE_OK==lrc ){
17540 0a 20 20 20 20 20 20 2f 2a 20 69 66 20 77 65 20  .      /* if we 
17550 73 75 63 63 65 65 64 65 64 20 69 6e 20 74 61 6b  succeeded in tak
17560 69 6e 67 20 74 68 65 20 72 65 73 65 72 76 65 64  ing the reserved
17570 20 6c 6f 63 6b 2c 20 75 6e 6c 6f 63 6b 20 69 74   lock, unlock it
17580 20 74 6f 20 72 65 73 74 6f 72 65 0a 20 20 20 20   to restore.    
17590 20 20 2a 2a 20 74 68 65 20 6f 72 69 67 69 6e 61    ** the origina
175a0 6c 20 73 74 61 74 65 20 2a 2f 0a 20 20 20 20 20  l state */.     
175b0 20 6c 72 63 20 3d 20 61 66 70 53 65 74 4c 6f 63   lrc = afpSetLoc
175c0 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74  k(context->dbPat
175d0 68 2c 20 70 46 69 6c 65 2c 20 52 45 53 45 52 56  h, pFile, RESERV
175e0 45 44 5f 42 59 54 45 2c 20 31 2c 20 30 29 3b 0a  ED_BYTE, 1, 0);.
175f0 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20      } else {.   
17600 20 20 20 2f 2a 20 69 66 20 77 65 20 66 61 69 6c     /* if we fail
17610 65 64 20 74 6f 20 67 65 74 20 74 68 65 20 6c 6f  ed to get the lo
17620 63 6b 20 74 68 65 6e 20 73 6f 6d 65 6f 6e 65 20  ck then someone 
17630 65 6c 73 65 20 6d 75 73 74 20 68 61 76 65 20 69  else must have i
17640 74 20 2a 2f 0a 20 20 20 20 20 20 72 65 73 65 72  t */.      reser
17650 76 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20  ved = 1;.    }. 
17660 20 20 20 69 66 28 20 49 53 5f 4c 4f 43 4b 5f 45     if( IS_LOCK_E
17670 52 52 4f 52 28 6c 72 63 29 20 29 7b 0a 20 20 20  RROR(lrc) ){.   
17680 20 20 20 72 63 3d 6c 72 63 3b 0a 20 20 20 20 7d     rc=lrc;.    }
17690 0a 20 20 7d 0a 20 20 0a 20 20 73 71 6c 69 74 65  .  }.  .  sqlite
176a0 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 46  3_mutex_leave(pF
176b0 69 6c 65 2d 3e 70 49 6e 6f 64 65 2d 3e 70 4c 6f  ile->pInode->pLo
176c0 63 6b 4d 75 74 65 78 29 3b 0a 20 20 4f 53 54 52  ckMutex);.  OSTR
176d0 41 43 45 28 28 22 54 45 53 54 20 57 52 2d 4c 4f  ACE(("TEST WR-LO
176e0 43 4b 20 25 64 20 25 64 20 25 64 20 28 61 66 70  CK %d %d %d (afp
176f0 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20  )\n", pFile->h, 
17700 72 63 2c 20 72 65 73 65 72 76 65 64 29 29 3b 0a  rc, reserved));.
17710 20 20 0a 20 20 2a 70 52 65 73 4f 75 74 20 3d 20    .  *pResOut = 
17720 72 65 73 65 72 76 65 64 3b 0a 20 20 72 65 74 75  reserved;.  retu
17730 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
17740 4c 6f 63 6b 20 74 68 65 20 66 69 6c 65 20 77 69  Lock the file wi
17750 74 68 20 74 68 65 20 6c 6f 63 6b 20 73 70 65 63  th the lock spec
17760 69 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74  ified by paramet
17770 65 72 20 65 46 69 6c 65 4c 6f 63 6b 20 2d 20 6f  er eFileLock - o
17780 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c  ne.** of the fol
17790 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20  lowing:.**.**   
177a0 20 20 28 31 29 20 53 48 41 52 45 44 5f 4c 4f 43    (1) SHARED_LOC
177b0 4b 0a 2a 2a 20 20 20 20 20 28 32 29 20 52 45 53  K.**     (2) RES
177c0 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20  ERVED_LOCK.**   
177d0 20 20 28 33 29 20 50 45 4e 44 49 4e 47 5f 4c 4f    (3) PENDING_LO
177e0 43 4b 0a 2a 2a 20 20 20 20 20 28 34 29 20 45 58  CK.**     (4) EX
177f0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a 2a 2a 0a  CLUSIVE_LOCK.**.
17800 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 68 65  ** Sometimes whe
17810 6e 20 72 65 71 75 65 73 74 69 6e 67 20 6f 6e 65  n requesting one
17820 20 6c 6f 63 6b 20 73 74 61 74 65 2c 20 61 64 64   lock state, add
17830 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 73 74 61  itional lock sta
17840 74 65 73 0a 2a 2a 20 61 72 65 20 69 6e 73 65 72  tes.** are inser
17850 74 65 64 20 69 6e 20 62 65 74 77 65 65 6e 2e 20  ted in between. 
17860 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 69 67   The locking mig
17870 68 74 20 66 61 69 6c 20 6f 6e 20 6f 6e 65 20 6f  ht fail on one o
17880 66 20 74 68 65 20 6c 61 74 65 72 0a 2a 2a 20 74  f the later.** t
17890 72 61 6e 73 69 74 69 6f 6e 73 20 6c 65 61 76 69  ransitions leavi
178a0 6e 67 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74  ng the lock stat
178b0 65 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d  e different from
178c0 20 77 68 61 74 20 69 74 20 73 74 61 72 74 65 64   what it started
178d0 20 62 75 74 0a 2a 2a 20 73 74 69 6c 6c 20 73 68   but.** still sh
178e0 6f 72 74 20 6f 66 20 69 74 73 20 67 6f 61 6c 2e  ort of its goal.
178f0 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20    The following 
17900 63 68 61 72 74 20 73 68 6f 77 73 20 74 68 65 20  chart shows the 
17910 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 61 6e 73  allowed.** trans
17920 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 69  itions and the i
17930 6e 73 65 72 74 65 64 20 69 6e 74 65 72 6d 65 64  nserted intermed
17940 69 61 74 65 20 73 74 61 74 65 73 3a 0a 2a 2a 0a  iate states:.**.
17950 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 44 20 2d  **    UNLOCKED -
17960 3e 20 53 48 41 52 45 44 0a 2a 2a 20 20 20 20 53  > SHARED.**    S
17970 48 41 52 45 44 20 2d 3e 20 52 45 53 45 52 56 45  HARED -> RESERVE
17980 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d  D.**    SHARED -
17990 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45  > (PENDING) -> E
179a0 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 52  XCLUSIVE.**    R
179b0 45 53 45 52 56 45 44 20 2d 3e 20 28 50 45 4e 44  ESERVED -> (PEND
179c0 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56  ING) -> EXCLUSIV
179d0 45 0a 2a 2a 20 20 20 20 50 45 4e 44 49 4e 47 20  E.**    PENDING 
179e0 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 0a  -> EXCLUSIVE.**.
179f0 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
17a00 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 65 61  will only increa
17a10 73 65 20 61 20 6c 6f 63 6b 2e 20 20 55 73 65 20  se a lock.  Use 
17a20 74 68 65 20 73 71 6c 69 74 65 33 4f 73 55 6e 6c  the sqlite3OsUnl
17a30 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65  ock().** routine
17a40 20 74 6f 20 6c 6f 77 65 72 20 61 20 6c 6f 63 6b   to lower a lock
17a50 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 73 74  ing level..*/.st
17a60 61 74 69 63 20 69 6e 74 20 61 66 70 4c 6f 63 6b  atic int afpLock
17a70 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69  (sqlite3_file *i
17a80 64 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b  d, int eFileLock
17a90 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
17aa0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46  LITE_OK;.  unixF
17ab0 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e  ile *pFile = (un
17ac0 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 75 6e  ixFile*)id;.  un
17ad0 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e  ixInodeInfo *pIn
17ae0 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e  ode = pFile->pIn
17af0 6f 64 65 3b 0a 20 20 61 66 70 4c 6f 63 6b 69 6e  ode;.  afpLockin
17b00 67 43 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78  gContext *contex
17b10 74 20 3d 20 28 61 66 70 4c 6f 63 6b 69 6e 67 43  t = (afpLockingC
17b20 6f 6e 74 65 78 74 20 2a 29 20 70 46 69 6c 65 2d  ontext *) pFile-
17b30 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 3b  >lockingContext;
17b40 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 70 46  .  .  assert( pF
17b50 69 6c 65 20 29 3b 0a 20 20 4f 53 54 52 41 43 45  ile );.  OSTRACE
17b60 28 28 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 73  (("LOCK    %d %s
17b70 20 77 61 73 20 25 73 28 25 73 2c 25 64 29 20 70   was %s(%s,%d) p
17b80 69 64 3d 25 64 20 28 61 66 70 29 5c 6e 22 2c 20  id=%d (afp)\n", 
17b90 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 20 20 20 20  pFile->h,.      
17ba0 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f 63 6b 28       azFileLock(
17bb0 65 46 69 6c 65 4c 6f 63 6b 29 2c 20 61 7a 46 69  eFileLock), azFi
17bc0 6c 65 4c 6f 63 6b 28 70 46 69 6c 65 2d 3e 65 46  leLock(pFile->eF
17bd0 69 6c 65 4c 6f 63 6b 29 2c 0a 20 20 20 20 20 20  ileLock),.      
17be0 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f 63 6b 28       azFileLock(
17bf0 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63  pInode->eFileLoc
17c00 6b 29 2c 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61  k), pInode->nSha
17c10 72 65 64 20 2c 20 6f 73 47 65 74 70 69 64 28 30  red , osGetpid(0
17c20 29 29 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68  )));..  /* If th
17c30 65 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 61  ere is already a
17c40 20 6c 6f 63 6b 20 6f 66 20 74 68 69 73 20 74 79   lock of this ty
17c50 70 65 20 6f 72 20 6d 6f 72 65 20 72 65 73 74 72  pe or more restr
17c60 69 63 74 69 76 65 20 6f 6e 20 74 68 65 0a 20 20  ictive on the.  
17c70 2a 2a 20 75 6e 69 78 46 69 6c 65 2c 20 64 6f 20  ** unixFile, do 
17c80 6e 6f 74 68 69 6e 67 2e 20 44 6f 6e 27 74 20 75  nothing. Don't u
17c90 73 65 20 74 68 65 20 61 66 70 5f 65 6e 64 5f 6c  se the afp_end_l
17ca0 6f 63 6b 3a 20 65 78 69 74 20 70 61 74 68 2c 20  ock: exit path, 
17cb0 61 73 0a 20 20 2a 2a 20 75 6e 69 78 45 6e 74 65  as.  ** unixEnte
17cc0 72 4d 75 74 65 78 28 29 20 68 61 73 6e 27 74 20  rMutex() hasn't 
17cd0 62 65 65 6e 20 63 61 6c 6c 65 64 20 79 65 74 2e  been called yet.
17ce0 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69 6c  .  */.  if( pFil
17cf0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 65 46  e->eFileLock>=eF
17d00 69 6c 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 4f  ileLock ){.    O
17d10 53 54 52 41 43 45 28 28 22 4c 4f 43 4b 20 20 20  STRACE(("LOCK   
17d20 20 25 64 20 25 73 20 6f 6b 20 28 61 6c 72 65 61   %d %s ok (alrea
17d30 64 79 20 68 65 6c 64 29 20 28 61 66 70 29 5c 6e  dy held) (afp)\n
17d40 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20 20 20  ", pFile->h,.   
17d50 20 20 20 20 20 20 20 20 61 7a 46 69 6c 65 4c 6f          azFileLo
17d60 63 6b 28 65 46 69 6c 65 4c 6f 63 6b 29 29 29 3b  ck(eFileLock)));
17d70 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
17d80 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  TE_OK;.  }..  /*
17d90 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6c   Make sure the l
17da0 6f 63 6b 69 6e 67 20 73 65 71 75 65 6e 63 65 20  ocking sequence 
17db0 69 73 20 63 6f 72 72 65 63 74 0a 20 20 2a 2a 20  is correct.  ** 
17dc0 20 28 31 29 20 57 65 20 6e 65 76 65 72 20 6d 6f   (1) We never mo
17dd0 76 65 20 66 72 6f 6d 20 75 6e 6c 6f 63 6b 65 64  ve from unlocked
17de0 20 74 6f 20 61 6e 79 74 68 69 6e 67 20 68 69 67   to anything hig
17df0 68 65 72 20 74 68 61 6e 20 73 68 61 72 65 64 20  her than shared 
17e00 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 20 28 32 29 20  lock..  **  (2) 
17e10 53 51 4c 69 74 65 20 6e 65 76 65 72 20 65 78 70  SQLite never exp
17e20 6c 69 63 69 74 6c 79 20 72 65 71 75 65 73 74 73  licitly requests
17e30 20 61 20 70 65 6e 64 69 67 20 6c 6f 63 6b 2e 0a   a pendig lock..
17e40 20 20 2a 2a 20 20 28 33 29 20 41 20 73 68 61 72    **  (3) A shar
17e50 65 64 20 6c 6f 63 6b 20 69 73 20 61 6c 77 61 79  ed lock is alway
17e60 73 20 68 65 6c 64 20 77 68 65 6e 20 61 20 72 65  s held when a re
17e70 73 65 72 76 65 20 6c 6f 63 6b 20 69 73 20 72 65  serve lock is re
17e80 71 75 65 73 74 65 64 2e 0a 20 20 2a 2f 0a 20 20  quested..  */.  
17e90 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 65  assert( pFile->e
17ea0 46 69 6c 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f 43  FileLock!=NO_LOC
17eb0 4b 20 7c 7c 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d  K || eFileLock==
17ec0 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20  SHARED_LOCK );. 
17ed0 20 61 73 73 65 72 74 28 20 65 46 69 6c 65 4c 6f   assert( eFileLo
17ee0 63 6b 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b  ck!=PENDING_LOCK
17ef0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 46   );.  assert( eF
17f00 69 6c 65 4c 6f 63 6b 21 3d 52 45 53 45 52 56 45  ileLock!=RESERVE
17f10 44 5f 4c 4f 43 4b 20 7c 7c 20 70 46 69 6c 65 2d  D_LOCK || pFile-
17f20 3e 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52  >eFileLock==SHAR
17f30 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 0a 20 20  ED_LOCK );.  .  
17f40 2f 2a 20 54 68 69 73 20 6d 75 74 65 78 20 69 73  /* This mutex is
17f50 20 6e 65 65 64 65 64 20 62 65 63 61 75 73 65 20   needed because 
17f60 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 20 69 73  pFile->pInode is
17f70 20 73 68 61 72 65 64 20 61 63 72 6f 73 73 20 74   shared across t
17f80 68 72 65 61 64 73 0a 20 20 2a 2f 0a 20 20 70 49  hreads.  */.  pI
17f90 6e 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49  node = pFile->pI
17fa0 6e 6f 64 65 3b 0a 20 20 73 71 6c 69 74 65 33 5f  node;.  sqlite3_
17fb0 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 49 6e 6f  mutex_enter(pIno
17fc0 64 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b  de->pLockMutex);
17fd0 0a 0a 20 20 2f 2a 20 49 66 20 73 6f 6d 65 20 74  ..  /* If some t
17fe0 68 72 65 61 64 20 75 73 69 6e 67 20 74 68 69 73  hread using this
17ff0 20 50 49 44 20 68 61 73 20 61 20 6c 6f 63 6b 20   PID has a lock 
18000 76 69 61 20 61 20 64 69 66 66 65 72 65 6e 74 20  via a different 
18010 75 6e 69 78 46 69 6c 65 2a 0a 20 20 2a 2a 20 68  unixFile*.  ** h
18020 61 6e 64 6c 65 20 74 68 61 74 20 70 72 65 63 6c  andle that precl
18030 75 64 65 73 20 74 68 65 20 72 65 71 75 65 73 74  udes the request
18040 65 64 20 6c 6f 63 6b 2c 20 72 65 74 75 72 6e 20  ed lock, return 
18050 42 55 53 59 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  BUSY..  */.  if(
18060 20 28 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f   (pFile->eFileLo
18070 63 6b 21 3d 70 49 6e 6f 64 65 2d 3e 65 46 69 6c  ck!=pInode->eFil
18080 65 4c 6f 63 6b 20 26 26 20 0a 20 20 20 20 20 20  eLock && .      
18090 20 28 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c   (pInode->eFileL
180a0 6f 63 6b 3e 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43  ock>=PENDING_LOC
180b0 4b 20 7c 7c 20 65 46 69 6c 65 4c 6f 63 6b 3e 53  K || eFileLock>S
180c0 48 41 52 45 44 5f 4c 4f 43 4b 29 29 0a 20 20 20  HARED_LOCK)).   
180d0 20 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51    ){.    rc = SQ
180e0 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 67  LITE_BUSY;.    g
180f0 6f 74 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b  oto afp_end_lock
18100 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f 2a 20 49 66  ;.  }.  .  /* If
18110 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69   a SHARED lock i
18120 73 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e 64  s requested, and
18130 20 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69   some thread usi
18140 6e 67 20 74 68 69 73 20 50 49 44 20 61 6c 72 65  ng this PID alre
18150 61 64 79 0a 20 20 2a 2a 20 68 61 73 20 61 20 53  ady.  ** has a S
18160 48 41 52 45 44 20 6f 72 20 52 45 53 45 52 56 45  HARED or RESERVE
18170 44 20 6c 6f 63 6b 2c 20 74 68 65 6e 20 69 6e 63  D lock, then inc
18180 72 65 6d 65 6e 74 20 72 65 66 65 72 65 6e 63 65  rement reference
18190 20 63 6f 75 6e 74 73 20 61 6e 64 0a 20 20 2a 2a   counts and.  **
181a0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
181b0 4b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 46  K..  */.  if( eF
181c0 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f  ileLock==SHARED_
181d0 4c 4f 43 4b 20 26 26 20 0a 20 20 20 20 20 28 70  LOCK && .     (p
181e0 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b  Inode->eFileLock
181f0 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c  ==SHARED_LOCK ||
18200 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f   pInode->eFileLo
18210 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43  ck==RESERVED_LOC
18220 4b 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74  K) ){.    assert
18230 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41  ( eFileLock==SHA
18240 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20  RED_LOCK );.    
18250 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 65  assert( pFile->e
18260 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20  FileLock==0 );. 
18270 20 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64     assert( pInod
18280 65 2d 3e 6e 53 68 61 72 65 64 3e 30 20 29 3b 0a  e->nShared>0 );.
18290 20 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65      pFile->eFile
182a0 4c 6f 63 6b 20 3d 20 53 48 41 52 45 44 5f 4c 4f  Lock = SHARED_LO
182b0 43 4b 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e  CK;.    pInode->
182c0 6e 53 68 61 72 65 64 2b 2b 3b 0a 20 20 20 20 70  nShared++;.    p
182d0 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a  Inode->nLock++;.
182e0 20 20 20 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64      goto afp_end
182f0 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 20 20 20 20 0a  _lock;.  }.    .
18300 20 20 2f 2a 20 41 20 50 45 4e 44 49 4e 47 20 6c    /* A PENDING l
18310 6f 63 6b 20 69 73 20 6e 65 65 64 65 64 20 62 65  ock is needed be
18320 66 6f 72 65 20 61 63 71 75 69 72 69 6e 67 20 61  fore acquiring a
18330 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 61 6e 64   SHARED lock and
18340 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20 61 63 71   before.  ** acq
18350 75 69 72 69 6e 67 20 61 6e 20 45 58 43 4c 55 53  uiring an EXCLUS
18360 49 56 45 20 6c 6f 63 6b 2e 20 20 46 6f 72 20 74  IVE lock.  For t
18370 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20  he SHARED lock, 
18380 74 68 65 20 50 45 4e 44 49 4e 47 20 77 69 6c 6c  the PENDING will
18390 0a 20 20 2a 2a 20 62 65 20 72 65 6c 65 61 73 65  .  ** be release
183a0 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 46  d..  */.  if( eF
183b0 69 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f  ileLock==SHARED_
183c0 4c 4f 43 4b 20 0a 20 20 20 20 20 20 7c 7c 20 28  LOCK .      || (
183d0 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55  eFileLock==EXCLU
183e0 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 70 46 69  SIVE_LOCK && pFi
183f0 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3c 50 45  le->eFileLock<PE
18400 4e 44 49 4e 47 5f 4c 4f 43 4b 29 0a 20 20 29 7b  NDING_LOCK).  ){
18410 0a 20 20 20 20 69 6e 74 20 66 61 69 6c 65 64 3b  .    int failed;
18420 0a 20 20 20 20 66 61 69 6c 65 64 20 3d 20 61 66  .    failed = af
18430 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74  pSetLock(context
18440 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c  ->dbPath, pFile,
18450 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c 20 31   PENDING_BYTE, 1
18460 2c 20 31 29 3b 0a 20 20 20 20 69 66 20 28 66 61  , 1);.    if (fa
18470 69 6c 65 64 29 20 7b 0a 20 20 20 20 20 20 72 63  iled) {.      rc
18480 20 3d 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 20   = failed;.     
18490 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f   goto afp_end_lo
184a0 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ck;.    }.  }.  
184b0 0a 20 20 2f 2a 20 49 66 20 63 6f 6e 74 72 6f 6c  .  /* If control
184c0 20 67 65 74 73 20 74 6f 20 74 68 69 73 20 70 6f   gets to this po
184d0 69 6e 74 2c 20 74 68 65 6e 20 61 63 74 75 61 6c  int, then actual
184e0 6c 79 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20  ly go ahead and 
184f0 6d 61 6b 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74  make.  ** operat
18500 69 6e 67 20 73 79 73 74 65 6d 20 63 61 6c 6c 73  ing system calls
18510 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69   for the specifi
18520 65 64 20 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20  ed lock..  */.  
18530 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 53  if( eFileLock==S
18540 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20  HARED_LOCK ){.  
18550 20 20 69 6e 74 20 6c 72 63 31 2c 20 6c 72 63 32    int lrc1, lrc2
18560 2c 20 6c 72 63 31 45 72 72 6e 6f 20 3d 20 30 3b  , lrc1Errno = 0;
18570 0a 20 20 20 20 6c 6f 6e 67 20 6c 6b 2c 20 6d 61  .    long lk, ma
18580 73 6b 3b 0a 20 20 20 20 0a 20 20 20 20 61 73 73  sk;.    .    ass
18590 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 68  ert( pInode->nSh
185a0 61 72 65 64 3d 3d 30 20 29 3b 0a 20 20 20 20 61  ared==0 );.    a
185b0 73 73 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 65  ssert( pInode->e
185c0 46 69 6c 65 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20  FileLock==0 );. 
185d0 20 20 20 20 20 20 20 0a 20 20 20 20 6d 61 73 6b         .    mask
185e0 20 3d 20 28 73 69 7a 65 6f 66 28 6c 6f 6e 67 29   = (sizeof(long)
185f0 3d 3d 38 29 20 3f 20 4c 41 52 47 45 53 54 5f 49  ==8) ? LARGEST_I
18600 4e 54 36 34 20 3a 20 30 78 37 66 66 66 66 66 66  NT64 : 0x7ffffff
18610 66 3b 0a 20 20 20 20 2f 2a 20 4e 6f 77 20 67 65  f;.    /* Now ge
18620 74 20 74 68 65 20 72 65 61 64 2d 6c 6f 63 6b 20  t the read-lock 
18630 53 48 41 52 45 44 5f 4c 4f 43 4b 20 2a 2f 0a 20  SHARED_LOCK */. 
18640 20 20 20 2f 2a 20 6e 6f 74 65 20 74 68 61 74 20     /* note that 
18650 74 68 65 20 71 75 61 6c 69 74 79 20 6f 66 20 74  the quality of t
18660 68 65 20 72 61 6e 64 6f 6d 6e 65 73 73 20 64 6f  he randomness do
18670 65 73 6e 27 74 20 6d 61 74 74 65 72 20 74 68 61  esn't matter tha
18680 74 20 6d 75 63 68 20 2a 2f 0a 20 20 20 20 6c 6b  t much */.    lk
18690 20 3d 20 72 61 6e 64 6f 6d 28 29 3b 20 0a 20 20   = random(); .  
186a0 20 20 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64    pInode->shared
186b0 42 79 74 65 20 3d 20 28 6c 6b 20 26 20 6d 61 73  Byte = (lk & mas
186c0 6b 29 25 28 53 48 41 52 45 44 5f 53 49 5a 45 20  k)%(SHARED_SIZE 
186d0 2d 20 31 29 3b 0a 20 20 20 20 6c 72 63 31 20 3d  - 1);.    lrc1 =
186e0 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74   afpSetLock(cont
186f0 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69  ext->dbPath, pFi
18700 6c 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 53  le, .          S
18710 48 41 52 45 44 5f 46 49 52 53 54 2b 70 49 6e 6f  HARED_FIRST+pIno
18720 64 65 2d 3e 73 68 61 72 65 64 42 79 74 65 2c 20  de->sharedByte, 
18730 31 2c 20 31 29 3b 0a 20 20 20 20 69 66 28 20 49  1, 1);.    if( I
18740 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52 28 6c 72 63  S_LOCK_ERROR(lrc
18750 31 29 20 29 7b 0a 20 20 20 20 20 20 6c 72 63 31  1) ){.      lrc1
18760 45 72 72 6e 6f 20 3d 20 70 46 69 6c 65 2d 3e 6c  Errno = pFile->l
18770 61 73 74 45 72 72 6e 6f 3b 0a 20 20 20 20 7d 0a  astErrno;.    }.
18780 20 20 20 20 2f 2a 20 44 72 6f 70 20 74 68 65 20      /* Drop the 
18790 74 65 6d 70 6f 72 61 72 79 20 50 45 4e 44 49 4e  temporary PENDIN
187a0 47 20 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 6c 72  G lock */.    lr
187b0 63 32 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28  c2 = afpSetLock(
187c0 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c  context->dbPath,
187d0 20 70 46 69 6c 65 2c 20 50 45 4e 44 49 4e 47 5f   pFile, PENDING_
187e0 42 59 54 45 2c 20 31 2c 20 30 29 3b 0a 20 20 20  BYTE, 1, 0);.   
187f0 20 0a 20 20 20 20 69 66 28 20 49 53 5f 4c 4f 43   .    if( IS_LOC
18800 4b 5f 45 52 52 4f 52 28 6c 72 63 31 29 20 29 20  K_ERROR(lrc1) ) 
18810 7b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73  {.      storeLas
18820 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 6c 72  tErrno(pFile, lr
18830 63 31 45 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20  c1Errno);.      
18840 72 63 20 3d 20 6c 72 63 31 3b 0a 20 20 20 20 20  rc = lrc1;.     
18850 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f   goto afp_end_lo
18860 63 6b 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 69  ck;.    } else i
18870 66 28 20 49 53 5f 4c 4f 43 4b 5f 45 52 52 4f 52  f( IS_LOCK_ERROR
18880 28 6c 72 63 32 29 20 29 7b 0a 20 20 20 20 20 20  (lrc2) ){.      
18890 72 63 20 3d 20 6c 72 63 32 3b 0a 20 20 20 20 20  rc = lrc2;.     
188a0 20 67 6f 74 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f   goto afp_end_lo
188b0 63 6b 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20 69  ck;.    } else i
188c0 66 28 20 6c 72 63 31 20 21 3d 20 53 51 4c 49 54  f( lrc1 != SQLIT
188d0 45 5f 4f 4b 20 29 20 7b 0a 20 20 20 20 20 20 72  E_OK ) {.      r
188e0 63 20 3d 20 6c 72 63 31 3b 0a 20 20 20 20 7d 20  c = lrc1;.    } 
188f0 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 70 46 69  else {.      pFi
18900 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20  le->eFileLock = 
18910 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20  SHARED_LOCK;.   
18920 20 20 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f 63 6b     pInode->nLock
18930 2b 2b 3b 0a 20 20 20 20 20 20 70 49 6e 6f 64 65  ++;.      pInode
18940 2d 3e 6e 53 68 61 72 65 64 20 3d 20 31 3b 0a 20  ->nShared = 1;. 
18950 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28     }.  }else if(
18960 20 65 46 69 6c 65 4c 6f 63 6b 3d 3d 45 58 43 4c   eFileLock==EXCL
18970 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 70 49  USIVE_LOCK && pI
18980 6e 6f 64 65 2d 3e 6e 53 68 61 72 65 64 3e 31 20  node->nShared>1 
18990 29 7b 0a 20 20 20 20 2f 2a 20 57 65 20 61 72 65  ){.    /* We are
189a0 20 74 72 79 69 6e 67 20 66 6f 72 20 61 6e 20 65   trying for an e
189b0 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 62 75  xclusive lock bu
189c0 74 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64  t another thread
189d0 20 69 6e 20 74 68 69 73 0a 20 20 20 20 20 2a 2a   in this.     **
189e0 20 73 61 6d 65 20 70 72 6f 63 65 73 73 20 69 73   same process is
189f0 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 20 61   still holding a
18a00 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20 2a 2f   shared lock. */
18a10 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
18a20 5f 42 55 53 59 3b 0a 20 20 7d 65 6c 73 65 7b 0a  _BUSY;.  }else{.
18a30 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65      /* The reque
18a40 73 74 20 77 61 73 20 66 6f 72 20 61 20 52 45 53  st was for a RES
18a50 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55 53 49  ERVED or EXCLUSI
18a60 56 45 20 6c 6f 63 6b 2e 20 20 49 74 20 69 73 0a  VE lock.  It is.
18a70 20 20 20 20 2a 2a 20 61 73 73 75 6d 65 64 20 74      ** assumed t
18a80 68 61 74 20 74 68 65 72 65 20 69 73 20 61 20 53  hat there is a S
18a90 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 65 72  HARED or greater
18aa0 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c   lock on the fil
18ab0 65 0a 20 20 20 20 2a 2a 20 61 6c 72 65 61 64 79  e.    ** already
18ac0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74  ..    */.    int
18ad0 20 66 61 69 6c 65 64 20 3d 20 30 3b 0a 20 20 20   failed = 0;.   
18ae0 20 61 73 73 65 72 74 28 20 30 21 3d 70 46 69 6c   assert( 0!=pFil
18af0 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 29 3b 0a  e->eFileLock );.
18b00 20 20 20 20 69 66 20 28 65 46 69 6c 65 4c 6f 63      if (eFileLoc
18b10 6b 20 3e 3d 20 52 45 53 45 52 56 45 44 5f 4c 4f  k >= RESERVED_LO
18b20 43 4b 20 26 26 20 70 46 69 6c 65 2d 3e 65 46 69  CK && pFile->eFi
18b30 6c 65 4c 6f 63 6b 20 3c 20 52 45 53 45 52 56 45  leLock < RESERVE
18b40 44 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20 20 20 20  D_LOCK) {.      
18b50 20 20 2f 2a 20 41 63 71 75 69 72 65 20 61 20 52    /* Acquire a R
18b60 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 2a 2f 0a  ESERVED lock */.
18b70 20 20 20 20 20 20 20 20 66 61 69 6c 65 64 20 3d          failed =
18b80 20 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74   afpSetLock(cont
18b90 65 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69  ext->dbPath, pFi
18ba0 6c 65 2c 20 52 45 53 45 52 56 45 44 5f 42 59 54  le, RESERVED_BYT
18bb0 45 2c 20 31 2c 31 29 3b 0a 20 20 20 20 20 20 69  E, 1,1);.      i
18bc0 66 28 20 21 66 61 69 6c 65 64 20 29 7b 0a 20 20  f( !failed ){.  
18bd0 20 20 20 20 20 20 63 6f 6e 74 65 78 74 2d 3e 72        context->r
18be0 65 73 65 72 76 65 64 20 3d 20 31 3b 0a 20 20 20  eserved = 1;.   
18bf0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69     }.    }.    i
18c00 66 20 28 21 66 61 69 6c 65 64 20 26 26 20 65 46  f (!failed && eF
18c10 69 6c 65 4c 6f 63 6b 20 3d 3d 20 45 58 43 4c 55  ileLock == EXCLU
18c20 53 49 56 45 5f 4c 4f 43 4b 29 20 7b 0a 20 20 20  SIVE_LOCK) {.   
18c30 20 20 20 2f 2a 20 41 63 71 75 69 72 65 20 61 6e     /* Acquire an
18c40 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20   EXCLUSIVE lock 
18c50 2a 2f 0a 20 20 20 20 20 20 20 20 0a 20 20 20 20  */.        .    
18c60 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20    /* Remove the 
18c70 73 68 61 72 65 64 20 6c 6f 63 6b 20 62 65 66 6f  shared lock befo
18c80 72 65 20 74 72 79 69 6e 67 20 74 68 65 20 72 61  re trying the ra
18c90 6e 67 65 2e 20 20 77 65 27 6c 6c 20 6e 65 65 64  nge.  we'll need
18ca0 20 74 6f 20 0a 20 20 20 20 20 20 2a 2a 20 72 65   to .      ** re
18cb0 65 73 74 61 62 6c 69 73 68 20 74 68 65 20 73 68  establish the sh
18cc0 61 72 65 64 20 6c 6f 63 6b 20 69 66 20 77 65 20  ared lock if we 
18cd0 63 61 6e 27 74 20 67 65 74 20 74 68 65 20 20 61  can't get the  a
18ce0 66 70 55 6e 6c 6f 63 6b 0a 20 20 20 20 20 20 2a  fpUnlock.      *
18cf0 2f 0a 20 20 20 20 20 20 69 66 28 20 21 28 66 61  /.      if( !(fa
18d00 69 6c 65 64 20 3d 20 61 66 70 53 65 74 4c 6f 63  iled = afpSetLoc
18d10 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74  k(context->dbPat
18d20 68 2c 20 70 46 69 6c 65 2c 20 53 48 41 52 45 44  h, pFile, SHARED
18d30 5f 46 49 52 53 54 20 2b 0a 20 20 20 20 20 20 20  _FIRST +.       
18d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18d50 20 20 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64    pInode->shared
18d60 42 79 74 65 2c 20 31 2c 20 30 29 29 20 29 7b 0a  Byte, 1, 0)) ){.
18d70 20 20 20 20 20 20 20 20 69 6e 74 20 66 61 69 6c          int fail
18d80 65 64 32 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  ed2 = SQLITE_OK;
18d90 0a 20 20 20 20 20 20 20 20 2f 2a 20 6e 6f 77 20  .        /* now 
18da0 61 74 74 65 6d 6d 70 74 20 74 6f 20 67 65 74 20  attemmpt to get 
18db0 74 68 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f  the exclusive lo
18dc0 63 6b 20 72 61 6e 67 65 20 2a 2f 0a 20 20 20 20  ck range */.    
18dd0 20 20 20 20 66 61 69 6c 65 64 20 3d 20 61 66 70      failed = afp
18de0 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d  SetLock(context-
18df0 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65 2c 20  >dbPath, pFile, 
18e00 53 48 41 52 45 44 5f 46 49 52 53 54 2c 20 0a 20  SHARED_FIRST, . 
18e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
18e20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 48                SH
18e30 41 52 45 44 5f 53 49 5a 45 2c 20 31 29 3b 0a 20  ARED_SIZE, 1);. 
18e40 20 20 20 20 20 20 20 69 66 28 20 66 61 69 6c 65         if( faile
18e50 64 20 26 26 20 28 66 61 69 6c 65 64 32 20 3d 20  d && (failed2 = 
18e60 61 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65  afpSetLock(conte
18e70 78 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c  xt->dbPath, pFil
18e80 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20  e, .            
18e90 20 20 20 20 20 20 20 20 20 20 20 53 48 41 52 45             SHARE
18ea0 44 5f 46 49 52 53 54 20 2b 20 70 49 6e 6f 64 65  D_FIRST + pInode
18eb0 2d 3e 73 68 61 72 65 64 42 79 74 65 2c 20 31 2c  ->sharedByte, 1,
18ec0 20 31 29 29 20 29 7b 0a 20 20 20 20 20 20 20 20   1)) ){.        
18ed0 20 20 2f 2a 20 43 61 6e 27 74 20 72 65 65 73 74    /* Can't reest
18ee0 61 62 6c 69 73 68 20 74 68 65 20 73 68 61 72 65  ablish the share
18ef0 64 20 6c 6f 63 6b 2e 20 20 53 71 6c 69 74 65 20  d lock.  Sqlite 
18f00 63 61 6e 27 74 20 64 65 61 6c 2c 20 74 68 69 73  can't deal, this
18f10 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a   is.          **
18f20 20 61 20 63 72 69 74 69 63 61 6c 20 49 2f 4f 20   a critical I/O 
18f30 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 20 20  error.          
18f40 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 72 63 20  */.          rc 
18f50 3d 20 28 28 66 61 69 6c 65 64 20 26 20 30 78 66  = ((failed & 0xf
18f60 66 29 20 3d 3d 20 53 51 4c 49 54 45 5f 49 4f 45  f) == SQLITE_IOE
18f70 52 52 29 20 3f 20 66 61 69 6c 65 64 32 20 3a 20  RR) ? failed2 : 
18f80 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
18f90 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4c 4f 43  SQLITE_IOERR_LOC
18fa0 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74  K;.          got
18fb0 6f 20 61 66 70 5f 65 6e 64 5f 6c 6f 63 6b 3b 0a  o afp_end_lock;.
18fc0 20 20 20 20 20 20 20 20 7d 20 0a 20 20 20 20 20          } .     
18fd0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
18fe0 72 63 20 3d 20 66 61 69 6c 65 64 3b 20 0a 20 20  rc = failed; .  
18ff0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
19000 69 66 28 20 66 61 69 6c 65 64 20 29 7b 0a 20 20  if( failed ){.  
19010 20 20 20 20 72 63 20 3d 20 66 61 69 6c 65 64 3b      rc = failed;
19020 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20  .    }.  }.  .  
19030 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
19040 4b 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e  K ){.    pFile->
19050 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65 46 69 6c  eFileLock = eFil
19060 65 4c 6f 63 6b 3b 0a 20 20 20 20 70 49 6e 6f 64  eLock;.    pInod
19070 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 65  e->eFileLock = e
19080 46 69 6c 65 4c 6f 63 6b 3b 0a 20 20 7d 65 6c 73  FileLock;.  }els
19090 65 20 69 66 28 20 65 46 69 6c 65 4c 6f 63 6b 3d  e if( eFileLock=
190a0 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20  =EXCLUSIVE_LOCK 
190b0 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 65 46  ){.    pFile->eF
190c0 69 6c 65 4c 6f 63 6b 20 3d 20 50 45 4e 44 49 4e  ileLock = PENDIN
190d0 47 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 49 6e 6f  G_LOCK;.    pIno
190e0 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20  de->eFileLock = 
190f0 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20  PENDING_LOCK;.  
19100 7d 0a 20 20 0a 61 66 70 5f 65 6e 64 5f 6c 6f 63  }.  .afp_end_loc
19110 6b 3a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  k:.  sqlite3_mut
19120 65 78 5f 6c 65 61 76 65 28 70 49 6e 6f 64 65 2d  ex_leave(pInode-
19130 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a 20 20  >pLockMutex);.  
19140 4f 53 54 52 41 43 45 28 28 22 4c 4f 43 4b 20 20  OSTRACE(("LOCK  
19150 20 20 25 64 20 25 73 20 25 73 20 28 61 66 70 29    %d %s %s (afp)
19160 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 61  \n", pFile->h, a
19170 7a 46 69 6c 65 4c 6f 63 6b 28 65 46 69 6c 65 4c  zFileLock(eFileL
19180 6f 63 6b 29 2c 20 0a 20 20 20 20 20 20 20 20 20  ock), .         
19190 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20  rc==SQLITE_OK ? 
191a0 22 6f 6b 22 20 3a 20 22 66 61 69 6c 65 64 22 29  "ok" : "failed")
191b0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
191c0 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74  }../*.** Lower t
191d0 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c  he locking level
191e0 20 6f 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70   on file descrip
191f0 74 6f 72 20 70 46 69 6c 65 20 74 6f 20 65 46 69  tor pFile to eFi
19200 6c 65 4c 6f 63 6b 2e 20 20 65 46 69 6c 65 4c 6f  leLock.  eFileLo
19210 63 6b 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 69  ck.** must be ei
19220 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20  ther NO_LOCK or 
19230 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a  SHARED_LOCK..**.
19240 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69 6e  ** If the lockin
19250 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 66  g level of the f
19260 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69  ile descriptor i
19270 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72 20  s already at or 
19280 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65 71  below.** the req
19290 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20 6c  uested locking l
192a0 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74 69  evel, this routi
192b0 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a  ne is a no-op..*
192c0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66 70  /.static int afp
192d0 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66  Unlock(sqlite3_f
192e0 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 65 46 69  ile *id, int eFi
192f0 6c 65 4c 6f 63 6b 29 20 7b 0a 20 20 69 6e 74 20  leLock) {.  int 
19300 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
19310 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c    unixFile *pFil
19320 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69  e = (unixFile*)i
19330 64 3b 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e  d;.  unixInodeIn
19340 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 20 20 61 66  fo *pInode;.  af
19350 70 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20  pLockingContext 
19360 2a 63 6f 6e 74 65 78 74 20 3d 20 28 61 66 70 4c  *context = (afpL
19370 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 2a 29  ockingContext *)
19380 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69 6e 67 43   pFile->lockingC
19390 6f 6e 74 65 78 74 3b 0a 20 20 69 6e 74 20 73 6b  ontext;.  int sk
193a0 69 70 53 68 61 72 65 64 20 3d 20 30 3b 0a 23 69  ipShared = 0;.#i
193b0 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
193c0 0a 20 20 69 6e 74 20 68 20 3d 20 70 46 69 6c 65  .  int h = pFile
193d0 2d 3e 68 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61  ->h;.#endif..  a
193e0 73 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a  ssert( pFile );.
193f0 20 20 4f 53 54 52 41 43 45 28 28 22 55 4e 4c 4f    OSTRACE(("UNLO
19400 43 4b 20 20 25 64 20 25 64 20 77 61 73 20 25 64  CK  %d %d was %d
19410 28 25 64 2c 25 64 29 20 70 69 64 3d 25 64 20 28  (%d,%d) pid=%d (
19420 61 66 70 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e  afp)\n", pFile->
19430 68 2c 20 65 46 69 6c 65 4c 6f 63 6b 2c 0a 20 20  h, eFileLock,.  
19440 20 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e           pFile->
19450 65 46 69 6c 65 4c 6f 63 6b 2c 20 70 46 69 6c 65  eFileLock, pFile
19460 2d 3e 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c  ->pInode->eFileL
19470 6f 63 6b 2c 20 70 46 69 6c 65 2d 3e 70 49 6e 6f  ock, pFile->pIno
19480 64 65 2d 3e 6e 53 68 61 72 65 64 2c 0a 20 20 20  de->nShared,.   
19490 20 20 20 20 20 20 20 20 6f 73 47 65 74 70 69 64          osGetpid
194a0 28 30 29 29 29 3b 0a 0a 20 20 61 73 73 65 72 74  (0)));..  assert
194b0 28 20 65 46 69 6c 65 4c 6f 63 6b 3c 3d 53 48 41  ( eFileLock<=SHA
194c0 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66  RED_LOCK );.  if
194d0 28 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f  ( pFile->eFileLo
194e0 63 6b 3c 3d 65 46 69 6c 65 4c 6f 63 6b 20 29 7b  ck<=eFileLock ){
194f0 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
19500 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 49 6e  TE_OK;.  }.  pIn
19510 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e  ode = pFile->pIn
19520 6f 64 65 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d  ode;.  sqlite3_m
19530 75 74 65 78 5f 65 6e 74 65 72 28 70 49 6e 6f 64  utex_enter(pInod
19540 65 2d 3e 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a  e->pLockMutex);.
19550 20 20 61 73 73 65 72 74 28 20 70 49 6e 6f 64 65    assert( pInode
19560 2d 3e 6e 53 68 61 72 65 64 21 3d 30 20 29 3b 0a  ->nShared!=0 );.
19570 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 65 46 69    if( pFile->eFi
19580 6c 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c 4f  leLock>SHARED_LO
19590 43 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74  CK ){.    assert
195a0 28 20 70 49 6e 6f 64 65 2d 3e 65 46 69 6c 65 4c  ( pInode->eFileL
195b0 6f 63 6b 3d 3d 70 46 69 6c 65 2d 3e 65 46 69 6c  ock==pFile->eFil
195c0 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 53 69 6d  eLock );.    Sim
195d0 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69  ulateIOErrorBeni
195e0 67 6e 28 31 29 3b 0a 20 20 20 20 53 69 6d 75 6c  gn(1);.    Simul
195f0 61 74 65 49 4f 45 72 72 6f 72 28 20 68 3d 28 2d  ateIOError( h=(-
19600 31 29 20 29 0a 20 20 20 20 53 69 6d 75 6c 61 74  1) ).    Simulat
19610 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 30  eIOErrorBenign(0
19620 29 3b 0a 20 20 20 20 0a 23 69 66 64 65 66 20 53  );.    .#ifdef S
19630 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20  QLITE_DEBUG.    
19640 2f 2a 20 57 68 65 6e 20 72 65 64 75 63 69 6e 67  /* When reducing
19650 20 61 20 6c 6f 63 6b 20 73 75 63 68 20 74 68 61   a lock such tha
19660 74 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65  t other processe
19670 73 20 63 61 6e 20 73 74 61 72 74 0a 20 20 20 20  s can start.    
19680 2a 2a 20 72 65 61 64 69 6e 67 20 74 68 65 20 64  ** reading the d
19690 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 67 61  atabase file aga
196a0 69 6e 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68  in, make sure th
196b0 61 74 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 72  at the.    ** tr
196c0 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65  ansaction counte
196d0 72 20 77 61 73 20 75 70 64 61 74 65 64 20 69 66  r was updated if
196e0 20 61 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65   any part of the
196f0 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a   database.    **
19700 20 66 69 6c 65 20 63 68 61 6e 67 65 64 2e 20 20   file changed.  
19710 49 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69  If the transacti
19720 6f 6e 20 63 6f 75 6e 74 65 72 20 69 73 20 6e 6f  on counter is no
19730 74 20 75 70 64 61 74 65 64 2c 0a 20 20 20 20 2a  t updated,.    *
19740 2a 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69  * other connecti
19750 6f 6e 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20  ons to the same 
19760 66 69 6c 65 20 6d 69 67 68 74 20 6e 6f 74 20 72  file might not r
19770 65 61 6c 69 7a 65 20 74 68 61 74 0a 20 20 20 20  ealize that.    
19780 2a 2a 20 74 68 65 20 66 69 6c 65 20 68 61 73 20  ** the file has 
19790 63 68 61 6e 67 65 64 20 61 6e 64 20 68 65 6e 63  changed and henc
197a0 65 20 6d 69 67 68 74 20 6e 6f 74 20 6b 6e 6f 77  e might not know
197b0 20 74 6f 20 66 6c 75 73 68 20 74 68 65 69 72 0a   to flush their.
197c0 20 20 20 20 2a 2a 20 63 61 63 68 65 2e 20 20 54      ** cache.  T
197d0 68 65 20 75 73 65 20 6f 66 20 61 20 73 74 61 6c  he use of a stal
197e0 65 20 63 61 63 68 65 20 63 61 6e 20 6c 65 61 64  e cache can lead
197f0 20 74 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72   to database cor
19800 72 75 70 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a  ruption..    */.
19810 20 20 20 20 61 73 73 65 72 74 28 20 70 46 69 6c      assert( pFil
19820 65 2d 3e 69 6e 4e 6f 72 6d 61 6c 57 72 69 74 65  e->inNormalWrite
19830 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 7c  ==0.           |
19840 7c 20 70 46 69 6c 65 2d 3e 64 62 55 70 64 61 74  | pFile->dbUpdat
19850 65 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20  e==0.           
19860 7c 7c 20 70 46 69 6c 65 2d 3e 74 72 61 6e 73 43  || pFile->transC
19870 6e 74 72 43 68 6e 67 3d 3d 31 20 29 3b 0a 20 20  ntrChng==1 );.  
19880 20 20 70 46 69 6c 65 2d 3e 69 6e 4e 6f 72 6d 61    pFile->inNorma
19890 6c 57 72 69 74 65 20 3d 20 30 3b 0a 23 65 6e 64  lWrite = 0;.#end
198a0 69 66 0a 20 20 20 20 0a 20 20 20 20 69 66 28 20  if.    .    if( 
198b0 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b  pFile->eFileLock
198c0 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b  ==EXCLUSIVE_LOCK
198d0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61   ){.      rc = a
198e0 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78  fpSetLock(contex
198f0 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65  t->dbPath, pFile
19900 2c 20 53 48 41 52 45 44 5f 46 49 52 53 54 2c 20  , SHARED_FIRST, 
19910 53 48 41 52 45 44 5f 53 49 5a 45 2c 20 30 29 3b  SHARED_SIZE, 0);
19920 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53  .      if( rc==S
19930 51 4c 49 54 45 5f 4f 4b 20 26 26 20 28 65 46 69  QLITE_OK && (eFi
19940 6c 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c  leLock==SHARED_L
19950 4f 43 4b 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e 6e  OCK || pInode->n
19960 53 68 61 72 65 64 3e 31 29 20 29 7b 0a 20 20 20  Shared>1) ){.   
19970 20 20 20 20 20 2f 2a 20 6f 6e 6c 79 20 72 65 2d       /* only re-
19980 65 73 74 61 62 6c 69 73 68 20 74 68 65 20 73 68  establish the sh
19990 61 72 65 64 20 6c 6f 63 6b 20 69 66 20 6e 65 63  ared lock if nec
199a0 65 73 73 61 72 79 20 2a 2f 0a 20 20 20 20 20 20  essary */.      
199b0 20 20 69 6e 74 20 73 68 61 72 65 64 4c 6f 63 6b    int sharedLock
199c0 42 79 74 65 20 3d 20 53 48 41 52 45 44 5f 46 49  Byte = SHARED_FI
199d0 52 53 54 2b 70 49 6e 6f 64 65 2d 3e 73 68 61 72  RST+pInode->shar
199e0 65 64 42 79 74 65 3b 0a 20 20 20 20 20 20 20 20  edByte;.        
199f0 72 63 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28  rc = afpSetLock(
19a00 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c  context->dbPath,
19a10 20 70 46 69 6c 65 2c 20 73 68 61 72 65 64 4c 6f   pFile, sharedLo
19a20 63 6b 42 79 74 65 2c 20 31 2c 20 31 29 3b 0a 20  ckByte, 1, 1);. 
19a30 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20       } else {.  
19a40 20 20 20 20 20 20 73 6b 69 70 53 68 61 72 65 64        skipShared
19a50 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20   = 1;.      }.  
19a60 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d    }.    if( rc==
19a70 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 46 69  SQLITE_OK && pFi
19a80 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 3e 3d 50  le->eFileLock>=P
19a90 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 29 7b 0a 20  ENDING_LOCK ){. 
19aa0 20 20 20 20 20 72 63 20 3d 20 61 66 70 53 65 74       rc = afpSet
19ab0 4c 6f 63 6b 28 63 6f 6e 74 65 78 74 2d 3e 64 62  Lock(context->db
19ac0 50 61 74 68 2c 20 70 46 69 6c 65 2c 20 50 45 4e  Path, pFile, PEN
19ad0 44 49 4e 47 5f 42 59 54 45 2c 20 31 2c 20 30 29  DING_BYTE, 1, 0)
19ae0 3b 0a 20 20 20 20 7d 20 0a 20 20 20 20 69 66 28  ;.    } .    if(
19af0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
19b00 26 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f  & pFile->eFileLo
19b10 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43  ck>=RESERVED_LOC
19b20 4b 20 26 26 20 63 6f 6e 74 65 78 74 2d 3e 72 65  K && context->re
19b30 73 65 72 76 65 64 20 29 7b 0a 20 20 20 20 20 20  served ){.      
19b40 72 63 20 3d 20 61 66 70 53 65 74 4c 6f 63 6b 28  rc = afpSetLock(
19b50 63 6f 6e 74 65 78 74 2d 3e 64 62 50 61 74 68 2c  context->dbPath,
19b60 20 70 46 69 6c 65 2c 20 52 45 53 45 52 56 45 44   pFile, RESERVED
19b70 5f 42 59 54 45 2c 20 31 2c 20 30 29 3b 0a 20 20  _BYTE, 1, 0);.  
19b80 20 20 20 20 69 66 28 20 21 72 63 20 29 7b 20 0a      if( !rc ){ .
19b90 20 20 20 20 20 20 20 20 63 6f 6e 74 65 78 74 2d          context-
19ba0 3e 72 65 73 65 72 76 65 64 20 3d 20 30 3b 20 0a  >reserved = 0; .
19bb0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
19bc0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
19bd0 5f 4f 4b 20 26 26 20 28 65 46 69 6c 65 4c 6f 63  _OK && (eFileLoc
19be0 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c  k==SHARED_LOCK |
19bf0 7c 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72 65  | pInode->nShare
19c00 64 3e 31 29 29 7b 0a 20 20 20 20 20 20 70 49 6e  d>1)){.      pIn
19c10 6f 64 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d  ode->eFileLock =
19c20 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20   SHARED_LOCK;.  
19c30 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63    }.  }.  if( rc
19c40 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65  ==SQLITE_OK && e
19c50 46 69 6c 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43  FileLock==NO_LOC
19c60 4b 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 44 65 63  K ){..    /* Dec
19c70 72 65 6d 65 6e 74 20 74 68 65 20 73 68 61 72 65  rement the share
19c80 64 20 6c 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20  d lock counter. 
19c90 20 52 65 6c 65 61 73 65 20 74 68 65 20 6c 6f 63   Release the loc
19ca0 6b 20 75 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a  k using an.    *
19cb0 2a 20 4f 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77  * OS call only w
19cc0 68 65 6e 20 61 6c 6c 20 74 68 72 65 61 64 73 20  hen all threads 
19cd0 69 6e 20 74 68 69 73 20 73 61 6d 65 20 70 72 6f  in this same pro
19ce0 63 65 73 73 20 68 61 76 65 20 72 65 6c 65 61 73  cess have releas
19cf0 65 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f  ed.    ** the lo
19d00 63 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 75  ck..    */.    u
19d10 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e  nsigned long lon
19d20 67 20 73 68 61 72 65 64 4c 6f 63 6b 42 79 74 65  g sharedLockByte
19d30 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53 54 2b   = SHARED_FIRST+
19d40 70 49 6e 6f 64 65 2d 3e 73 68 61 72 65 64 42 79  pInode->sharedBy
19d50 74 65 3b 0a 20 20 20 20 70 49 6e 6f 64 65 2d 3e  te;.    pInode->
19d60 6e 53 68 61 72 65 64 2d 2d 3b 0a 20 20 20 20 69  nShared--;.    i
19d70 66 28 20 70 49 6e 6f 64 65 2d 3e 6e 53 68 61 72  f( pInode->nShar
19d80 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 53  ed==0 ){.      S
19d90 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65  imulateIOErrorBe
19da0 6e 69 67 6e 28 31 29 3b 0a 20 20 20 20 20 20 53  nign(1);.      S
19db0 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20  imulateIOError( 
19dc0 68 3d 28 2d 31 29 20 29 0a 20 20 20 20 20 20 53  h=(-1) ).      S
19dd0 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 42 65  imulateIOErrorBe
19de0 6e 69 67 6e 28 30 29 3b 0a 20 20 20 20 20 20 69  nign(0);.      i
19df0 66 28 20 21 73 6b 69 70 53 68 61 72 65 64 20 29  f( !skipShared )
19e00 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 61  {.        rc = a
19e10 66 70 53 65 74 4c 6f 63 6b 28 63 6f 6e 74 65 78  fpSetLock(contex
19e20 74 2d 3e 64 62 50 61 74 68 2c 20 70 46 69 6c 65  t->dbPath, pFile
19e30 2c 20 73 68 61 72 65 64 4c 6f 63 6b 42 79 74 65  , sharedLockByte
19e40 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d  , 1, 0);.      }
19e50 0a 20 20 20 20 20 20 69 66 28 20 21 72 63 20 29  .      if( !rc )
19e60 7b 0a 20 20 20 20 20 20 20 20 70 49 6e 6f 64 65  {.        pInode
19e70 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20 3d 20 4e 4f  ->eFileLock = NO
19e80 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 70  _LOCK;.        p
19e90 46 69 6c 65 2d 3e 65 46 69 6c 65 4c 6f 63 6b 20  File->eFileLock 
19ea0 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20  = NO_LOCK;.     
19eb0 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28   }.    }.    if(
19ec0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
19ed0 7b 0a 20 20 20 20 20 20 70 49 6e 6f 64 65 2d 3e  {.      pInode->
19ee0 6e 4c 6f 63 6b 2d 2d 3b 0a 20 20 20 20 20 20 61  nLock--;.      a
19ef0 73 73 65 72 74 28 20 70 49 6e 6f 64 65 2d 3e 6e  ssert( pInode->n
19f00 4c 6f 63 6b 3e 3d 30 20 29 3b 0a 20 20 20 20 20  Lock>=0 );.     
19f10 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f   if( pInode->nLo
19f20 63 6b 3d 3d 30 20 29 20 63 6c 6f 73 65 50 65 6e  ck==0 ) closePen
19f30 64 69 6e 67 46 64 73 28 70 46 69 6c 65 29 3b 0a  dingFds(pFile);.
19f40 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 73      }.  }.  .  s
19f50 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
19f60 76 65 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b  ve(pInode->pLock
19f70 4d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 72 63  Mutex);.  if( rc
19f80 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
19f90 20 20 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65 4c     pFile->eFileL
19fa0 6f 63 6b 20 3d 20 65 46 69 6c 65 4c 6f 63 6b 3b  ock = eFileLock;
19fb0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
19fc0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  ;.}../*.** Close
19fd0 20 61 20 66 69 6c 65 20 26 20 63 6c 65 61 6e 75   a file & cleanu
19fe0 70 20 41 46 50 20 73 70 65 63 69 66 69 63 20 6c  p AFP specific l
19ff0 6f 63 6b 69 6e 67 20 63 6f 6e 74 65 78 74 20 0a  ocking context .
1a000 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 66  */.static int af
1a010 70 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66  pClose(sqlite3_f
1a020 69 6c 65 20 2a 69 64 29 20 7b 0a 20 20 69 6e 74  ile *id) {.  int
1a030 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
1a040 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69  .  unixFile *pFi
1a050 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29  le = (unixFile*)
1a060 69 64 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  id;.  assert( id
1a070 21 3d 30 20 29 3b 0a 20 20 61 66 70 55 6e 6c 6f  !=0 );.  afpUnlo
1a080 63 6b 28 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b  ck(id, NO_LOCK);
1a090 0a 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 46  .  assert( unixF
1a0a0 69 6c 65 4d 75 74 65 78 4e 6f 74 68 65 6c 64 28  ileMutexNotheld(
1a0b0 70 46 69 6c 65 29 20 29 3b 0a 20 20 75 6e 69 78  pFile) );.  unix
1a0c0 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20  EnterMutex();.  
1a0d0 69 66 28 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64  if( pFile->pInod
1a0e0 65 20 29 7b 0a 20 20 20 20 75 6e 69 78 49 6e 6f  e ){.    unixIno
1a0f0 64 65 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 20 3d  deInfo *pInode =
1a100 20 70 46 69 6c 65 2d 3e 70 49 6e 6f 64 65 3b 0a   pFile->pInode;.
1a110 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
1a120 78 5f 65 6e 74 65 72 28 70 49 6e 6f 64 65 2d 3e  x_enter(pInode->
1a130 70 4c 6f 63 6b 4d 75 74 65 78 29 3b 0a 20 20 20  pLockMutex);.   
1a140 20 69 66 28 20 70 49 6e 6f 64 65 2d 3e 6e 4c 6f   if( pInode->nLo
1a150 63 6b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49  ck ){.      /* I
1a160 66 20 74 68 65 72 65 20 61 72 65 20 6f 75 74 73  f there are outs
1a170 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 2c 20 64  tanding locks, d
1a180 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 63  o not actually c
1a190 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 6a 75  lose the file ju
1a1a0 73 74 0a 20 20 20 20 20 20 2a 2a 20 79 65 74 20  st.      ** yet 
1a1b0 62 65 63 61 75 73 65 20 74 68 61 74 20 77 6f 75  because that wou
1a1c0 6c 64 20 63 6c 65 61 72 20 74 68 6f 73 65 20 6c  ld clear those l
1a1d0 6f 63 6b 73 2e 20 20 49 6e 73 74 65 61 64 2c 20  ocks.  Instead, 
1a1e0 61 64 64 20 74 68 65 20 66 69 6c 65 0a 20 20 20  add the file.   
1a1f0 20 20 20 2a 2a 20 64 65 73 63 72 69 70 74 6f 72     ** descriptor
1a200 20 74 6f 20 70 49 6e 6f 64 65 2d 3e 61 50 65 6e   to pInode->aPen
1a210 64 69 6e 67 2e 20 20 49 74 20 77 69 6c 6c 20 62  ding.  It will b
1a220 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  e automatically 
1a230 63 6c 6f 73 65 64 20 77 68 65 6e 0a 20 20 20 20  closed when.    
1a240 20 20 2a 2a 20 74 68 65 20 6c 61 73 74 20 6c 6f    ** the last lo
1a250 63 6b 20 69 73 20 63 6c 65 61 72 65 64 2e 0a 20  ck is cleared.. 
1a260 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 65       */.      se
1a270 74 50 65 6e 64 69 6e 67 46 64 28 70 46 69 6c 65  tPendingFd(pFile
1a280 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
1a290 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
1a2a0 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63 6b 4d 75  (pInode->pLockMu
1a2b0 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65  tex);.  }.  rele
1a2c0 61 73 65 49 6e 6f 64 65 49 6e 66 6f 28 70 46 69  aseInodeInfo(pFi
1a2d0 6c 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66  le);.  sqlite3_f
1a2e0 72 65 65 28 70 46 69 6c 65 2d 3e 6c 6f 63 6b 69  ree(pFile->locki
1a2f0 6e 67 43 6f 6e 74 65 78 74 29 3b 0a 20 20 72 63  ngContext);.  rc
1a300 20 3d 20 63 6c 6f 73 65 55 6e 69 78 46 69 6c 65   = closeUnixFile
1a310 28 69 64 29 3b 0a 20 20 75 6e 69 78 4c 65 61 76  (id);.  unixLeav
1a320 65 4d 75 74 65 78 28 29 3b 0a 20 20 72 65 74 75  eMutex();.  retu
1a330 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6e 64 69 66  rn rc;.}..#endif
1a340 20 2f 2a 20 64 65 66 69 6e 65 64 28 5f 5f 41 50   /* defined(__AP
1a350 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45  PLE__) && SQLITE
1a360 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f  _ENABLE_LOCKING_
1a370 53 54 59 4c 45 20 2a 2f 0a 2f 2a 0a 2a 2a 20 54  STYLE */./*.** T
1a380 68 65 20 63 6f 64 65 20 61 62 6f 76 65 20 69 73  he code above is
1a390 20 74 68 65 20 41 46 50 20 6c 6f 63 6b 20 69 6d   the AFP lock im
1a3a0 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 54  plementation.  T
1a3b0 68 65 20 63 6f 64 65 20 69 73 20 73 70 65 63 69  he code is speci
1a3c0 66 69 63 0a 2a 2a 20 74 6f 20 4d 61 63 4f 53 58  fic.** to MacOSX
1a3d0 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74 20 77 6f   and does not wo
1a3e0 72 6b 20 6f 6e 20 6f 74 68 65 72 20 75 6e 69 78  rk on other unix
1a3f0 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20 4e 6f 20   platforms.  No 
1a400 61 6c 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 69  alternative.** i
1a410 73 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 49 66  s available.  If
1a420 20 79 6f 75 20 64 6f 6e 27 74 20 63 6f 6d 70 69   you don't compi
1a430 6c 65 20 66 6f 72 20 61 20 6d 61 63 2c 20 74 68  le for a mac, th
1a440 65 6e 20 74 68 65 20 22 75 6e 69 78 2d 61 66 70  en the "unix-afp
1a450 22 0a 2a 2a 20 56 46 53 20 69 73 20 6e 6f 74 20  ".** VFS is not 
1a460 61 76 61 69 6c 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a  available..**.**
1a470 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a480 2a 2a 2a 20 45 6e 64 20 6f 66 20 74 68 65 20 41  *** End of the A
1a490 46 50 20 6c 6f 63 6b 20 69 6d 70 6c 65 6d 65 6e  FP lock implemen
1a4a0 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  tation *********
1a4b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a  *************.**
1a4c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a4d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a4e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a4f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a500 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f  ************/../
1a510 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a520 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a530 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a540 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a550 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
1a560 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a570 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e  ********** Begin
1a580 20 4e 46 53 20 4c 6f 63 6b 69 6e 67 20 2a 2a 2a   NFS Locking ***
1a590 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a5a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
1a5b0 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50  #if defined(__AP
1a5c0 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45  PLE__) && SQLITE
1a5d0 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f  _ENABLE_LOCKING_
1a5e0 53 54 59 4c 45 0a 2f 2a 0a 20 2a 2a 20 4c 6f 77  STYLE./*. ** Low
1a5f0 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c  er the locking l
1a600 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65 73  evel on file des
1a610 63 72 69 70 74 6f 72 20 70 46 69 6c 65 20 74 6f  criptor pFile to
1a620 20 65 46 69 6c 65 4c 6f 63 6b 2e 20 20 65 46 69   eFileLock.  eFi
1a630 6c 65 4c 6f 63 6b 0a 20 2a 2a 20 6d 75 73 74 20  leLock. ** must 
1a640 62 65 20 65 69 74 68 65 72 20 4e 4f 5f 4c 4f 43  be either NO_LOC
1a650 4b 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b  K or SHARED_LOCK
1a660 2e 0a 20 2a 2a 0a 20 2a 2a 20 49 66 20 74 68 65  .. **. ** If the
1a670 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f   locking level o
1a680 66 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72  f the file descr
1a690 69 70 74 6f 72 20 69 73 20 61 6c 72 65 61 64 79  iptor is already
1a6a0 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a 20 2a 2a   at or below. **
1a6b0 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c   the requested l
1a6c0 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20 74 68  ocking level, th
1a6d0 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20  is routine is a 
1a6e0 6e 6f 2d 6f 70 2e 0a 20 2a 2f 0a 73 74 61 74 69  no-op.. */.stati
1a6f0 63 20 69 6e 74 20 6e 66 73 55 6e 6c 6f 63 6b 28  c int nfsUnlock(
1a700 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64  sqlite3_file *id
1a710 2c 20 69 6e 74 20 65 46 69 6c 65 4c 6f 63 6b 29  , int eFileLock)
1a720 7b 0a 20 20 72 65 74 75 72 6e 20 70 6f 73 69 78  {.  return posix
1a730 55 6e 6c 6f 63 6b 28 69 64 2c 20 65 46 69 6c 65  Unlock(id, eFile
1a740 4c 6f 63 6b 2c 20 31 29 3b 0a 7d 0a 0a 23 65 6e  Lock, 1);.}..#en
1a750 64 69 66 20 2f 2a 20 64 65 66 69 6e 65 64 28 5f  dif /* defined(_
1a760 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c  _APPLE__) && SQL
1a770 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
1a780 4e 47 5f 53 54 59 4c 45 20 2a 2f 0a 2f 2a 0a 2a  NG_STYLE */./*.*
1a790 2a 20 54 68 65 20 63 6f 64 65 20 61 62 6f 76 65  * The code above
1a7a0 20 69 73 20 74 68 65 20 4e 46 53 20 6c 6f 63 6b   is the NFS lock
1a7b0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e   implementation.
1a7c0 20 20 54 68 65 20 63 6f 64 65 20 69 73 20 73 70    The code is sp
1a7d0 65 63 69 66 69 63 0a 2a 2a 20 74 6f 20 4d 61 63  ecific.** to Mac
1a7e0 4f 53 58 20 61 6e 64 20 64 6f 65 73 20 6e 6f 74  OSX and does not
1a7f0 20 77 6f 72 6b 20 6f 6e 20 6f 74 68 65 72 20 75   work on other u
1a800 6e 69 78 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20  nix platforms.  
1a810 4e 6f 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 2a  No alternative.*
1a820 2a 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2e 20  * is available. 
1a830 20 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   .**.***********
1a840 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f  ********** End o
1a850 66 20 74 68 65 20 4e 46 53 20 6c 6f 63 6b 20 69  f the NFS lock i
1a860 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2a  mplementation **
1a870 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a880 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****.***********
1a890 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a8a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a8b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a8c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a8d0 2a 2a 2a 2f 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a  ***/../*********
1a8e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a8f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a900 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a910 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a920 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  *****.**********
1a930 2a 2a 2a 2a 2a 2a 20 4e 6f 6e 2d 6c 6f 63 6b 69  ****** Non-locki
1a940 6e 67 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  ng sqlite3_file 
1a950 6d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a  methods ********
1a960 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1a970 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20  *****.**.** The 
1a980 6e 65 78 74 20 64 69 76 69 73 69 6f 6e 20 63 6f  next division co
1a990 6e 74 61 69 6e 73 20 69 6d 70 6c 65 6d 65 6e 74  ntains implement
1a9a0 61 74 69 6f 6e 73 20 66 6f 72 20 61 6c 6c 20 6d  ations for all m
1a9b0 65 74 68 6f 64 73 20 6f 66 20 74 68 65 20 0a 2a  ethods of the .*
1a9c0 2a 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 6f  * sqlite3_file o
1a9d0 62 6a 65 63 74 20 6f 74 68 65 72 20 74 68 61 6e  bject other than
1a9e0 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74   the locking met
1a9f0 68 6f 64 73 2e 20 20 54 68 65 20 6c 6f 63 6b 69  hods.  The locki
1aa00 6e 67 0a 2a 2a 20 6d 65 74 68 6f 64 73 20 77 65  ng.** methods we
1aa10 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 64 69  re defined in di
1aa20 76 69 73 69 6f 6e 73 20 61 62 6f 76 65 20 28 6f  visions above (o
1aa30 6e 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f  ne locking metho
1aa40 64 20 70 65 72 0a 2a 2a 20 64 69 76 69 73 69 6f  d per.** divisio
1aa50 6e 29 2e 20 20 54 68 6f 73 65 20 6d 65 74 68 6f  n).  Those metho
1aa60 64 73 20 74 68 61 74 20 61 72 65 20 63 6f 6d 6d  ds that are comm
1aa70 6f 6e 20 74 6f 20 61 6c 6c 20 6c 6f 63 6b 69 6e  on to all lockin
1aa80 67 20 6d 6f 64 65 73 0a 2a 2a 20 61 72 65 20 67  g modes.** are g
1aa90 61 74 68 65 72 20 74 6f 67 65 74 68 65 72 20 69  ather together i
1aaa0 6e 74 6f 20 74 68 69 73 20 64 69 76 69 73 69 6f  nto this divisio
1aab0 6e 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 65 65  n..*/../*.** See
1aac0 6b 20 74 6f 20 74 68 65 20 6f 66 66 73 65 74 20  k to the offset 
1aad0 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65  passed as the se
1aae0 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2c 20 74  cond argument, t
1aaf0 68 65 6e 20 72 65 61 64 20 63 6e 74 20 0a 2a 2a  hen read cnt .**
1ab00 20 62 79 74 65 73 20 69 6e 74 6f 20 70 42 75 66   bytes into pBuf
1ab10 2e 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  . Return the num
1ab20 62 65 72 20 6f 66 20 62 79 74 65 73 20 61 63 74  ber of bytes act
1ab30 75 61 6c 6c 79 20 72 65 61 64 2e 0a 2a 2a 0a 2a  ually read..**.*
1ab40 2a 20 4e 42 3a 20 20 49 66 20 79 6f 75 20 64 65  * NB:  If you de
1ab50 66 69 6e 65 20 55 53 45 5f 50 52 45 41 44 20 6f  fine USE_PREAD o
1ab60 72 20 55 53 45 5f 50 52 45 41 44 36 34 2c 20 74  r USE_PREAD64, t
1ab70 68 65 6e 20 69 74 20 6d 69 67 68 74 20 61 6c 73  hen it might als
1ab80 6f 0a 2a 2a 20 62 65 20 6e 65 63 65 73 73 61 72  o.** be necessar
1ab90 79 20 74 6f 20 64 65 66 69 6e 65 20 5f 58 4f 50  y to define _XOP
1aba0 45 4e 5f 53 4f 55 52 43 45 20 74 6f 20 62 65 20  EN_SOURCE to be 
1abb0 35 30 30 2e 20 20 54 68 69 73 20 76 61 72 69 65  500.  This varie
1abc0 73 20 66 72 6f 6d 0a 2a 2a 20 6f 6e 65 20 73 79  s from.** one sy
1abd0 73 74 65 6d 20 74 6f 20 61 6e 6f 74 68 65 72 2e  stem to another.
1abe0 20 20 53 69 6e 63 65 20 53 51 4c 69 74 65 20 64    Since SQLite d
1abf0 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 55  oes not define U
1ac00 53 45 5f 50 52 45 41 44 0a 2a 2a 20 69 6e 20 61  SE_PREAD.** in a
1ac10 6e 79 20 66 6f 72 6d 20 62 79 20 64 65 66 61 75  ny form by defau
1ac20 6c 74 2c 20 77 65 20 77 69 6c 6c 20 6e 6f 74 20  lt, we will not 
1ac30 61 74 74 65 6d 70 74 20 74 6f 20 64 65 66 69 6e  attempt to defin
1ac40 65 20 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 2e  e _XOPEN_SOURCE.
1ac50 0a 2a 2a 20 53 65 65 20 74 69 63 6b 65 74 73 20  .** See tickets 
1ac60 23 32 37 34 31 20 61 6e 64 20 23 32 36 38 31 2e  #2741 and #2681.
1ac70 0a 2a 2a 0a 2a 2a 20 54 6f 20 61 76 6f 69 64 20  .**.** To avoid 
1ac80 73 74 6f 6d 70 69 6e 67 20 74 68 65 20 65 72 72  stomping the err
1ac90 6e 6f 20 76 61 6c 75 65 20 6f 6e 20 61 20 66 61  no value on a fa
1aca0 69 6c 65 64 20 72 65 61 64 20 74 68 65 20 6c 61  iled read the la
1acb0 73 74 45 72 72 6e 6f 20 76 61 6c 75 65 0a 2a 2a  stErrno value.**
1acc0 20 69 73 20 73 65 74 20 62 65 66 6f 72 65 20 72   is set before r
1acd0 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61  eturning..*/.sta
1ace0 74 69 63 20 69 6e 74 20 73 65 65 6b 41 6e 64 52  tic int seekAndR
1acf0 65 61 64 28 75 6e 69 78 46 69 6c 65 20 2a 69 64  ead(unixFile *id
1ad00 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20  , sqlite3_int64 
1ad10 6f 66 66 73 65 74 2c 20 76 6f 69 64 20 2a 70 42  offset, void *pB
1ad20 75 66 2c 20 69 6e 74 20 63 6e 74 29 7b 0a 20 20  uf, int cnt){.  
1ad30 69 6e 74 20 67 6f 74 3b 0a 20 20 69 6e 74 20 70  int got;.  int p
1ad40 72 69 6f 72 20 3d 20 30 3b 0a 23 69 66 20 28 21  rior = 0;.#if (!
1ad50 64 65 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41  defined(USE_PREA
1ad60 44 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 55  D) && !defined(U
1ad70 53 45 5f 50 52 45 41 44 36 34 29 29 0a 20 20 69  SE_PREAD64)).  i
1ad80 36 34 20 6e 65 77 4f 66 66 73 65 74 3b 0a 23 65  64 newOffset;.#e
1ad90 6e 64 69 66 0a 20 20 54 49 4d 45 52 5f 53 54 41  ndif.  TIMER_STA
1ada0 52 54 3b 0a 20 20 61 73 73 65 72 74 28 20 63 6e  RT;.  assert( cn
1adb0 74 3d 3d 28 63 6e 74 26 30 78 31 66 66 66 66 29  t==(cnt&0x1ffff)
1adc0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64   );.  assert( id
1add0 2d 3e 68 3e 32 20 29 3b 0a 20 20 64 6f 7b 0a 23  ->h>2 );.  do{.#
1ade0 69 66 20 64 65 66 69 6e 65 64 28 55 53 45 5f 50  if defined(USE_P
1adf0 52 45 41 44 29 0a 20 20 20 20 67 6f 74 20 3d 20  READ).    got = 
1ae00 6f 73 50 72 65 61 64 28 69 64 2d 3e 68 2c 20 70  osPread(id->h, p
1ae10 42 75 66 2c 20 63 6e 74 2c 20 6f 66 66 73 65 74  Buf, cnt, offset
1ae20 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49  );.    SimulateI
1ae30 4f 45 72 72 6f 72 28 20 67 6f 74 20 3d 20 2d 31  OError( got = -1
1ae40 20 29 3b 0a 23 65 6c 69 66 20 64 65 66 69 6e 65   );.#elif define
1ae50 64 28 55 53 45 5f 50 52 45 41 44 36 34 29 0a 20  d(USE_PREAD64). 
1ae60 20 20 20 67 6f 74 20 3d 20 6f 73 50 72 65 61 64     got = osPread
1ae70 36 34 28 69 64 2d 3e 68 2c 20 70 42 75 66 2c 20  64(id->h, pBuf, 
1ae80 63 6e 74 2c 20 6f 66 66 73 65 74 29 3b 0a 20 20  cnt, offset);.  
1ae90 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f    SimulateIOErro
1aea0 72 28 20 67 6f 74 20 3d 20 2d 31 20 29 3b 0a 23  r( got = -1 );.#
1aeb0 65 6c 73 65 0a 20 20 20 20 6e 65 77 4f 66 66 73  else.    newOffs
1aec0 65 74 20 3d 20 6c 73 65 65 6b 28 69 64 2d 3e 68  et = lseek(id->h
1aed0 2c 20 6f 66 66 73 65 74 2c 20 53 45 45 4b 5f 53  , offset, SEEK_S
1aee0 45 54 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74  ET);.    Simulat
1aef0 65 49 4f 45 72 72 6f 72 28 20 6e 65 77 4f 66 66  eIOError( newOff
1af00 73 65 74 20 3d 20 2d 31 20 29 3b 0a 20 20 20 20  set = -1 );.    
1af10 69 66 28 20 6e 65 77 4f 66 66 73 65 74 3c 30 20  if( newOffset<0 
1af20 29 7b 0a 20 20 20 20 20 20 73 74 6f 72 65 4c 61  ){.      storeLa
1af30 73 74 45 72 72 6e 6f 28 28 75 6e 69 78 46 69 6c  stErrno((unixFil
1af40 65 2a 29 69 64 2c 20 65 72 72 6e 6f 29 3b 0a 20  e*)id, errno);. 
1af50 20 20 20 20 20 72 65 74 75 72 6e 20 2d 31 3b 0a       return -1;.
1af60 20 20 20 20 7d 0a 20 20 20 20 67 6f 74 20 3d 20      }.    got = 
1af70 6f 73 52 65 61 64 28 69 64 2d 3e 68 2c 20 70 42  osRead(id->h, pB
1af80 75 66 2c 20 63 6e 74 29 3b 0a 23 65 6e 64 69 66  uf, cnt);.#endif
1af90 0a 20 20 20 20 69 66 28 20 67 6f 74 3d 3d 63 6e  .    if( got==cn
1afa0 74 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 69  t ) break;.    i
1afb0 66 28 20 67 6f 74 3c 30 20 29 7b 0a 20 20 20 20  f( got<0 ){.    
1afc0 20 20 69 66 28 20 65 72 72 6e 6f 3d 3d 45 49 4e    if( errno==EIN
1afd0 54 52 20 29 7b 20 67 6f 74 20 3d 20 31 3b 20 63  TR ){ got = 1; c
1afe0 6f 6e 74 69 6e 75 65 3b 20 7d 0a 20 20 20 20 20  ontinue; }.     
1aff0 20 70 72 69 6f 72 20 3d 20 30 3b 0a 20 20 20 20   prior = 0;.    
1b000 20 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f    storeLastErrno
1b010 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 2c 20  ((unixFile*)id, 
1b020 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 20 20 62   errno);.      b
1b030 72 65 61 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 20  reak;.    }else 
1b040 69 66 28 20 67 6f 74 3e 30 20 29 7b 0a 20 20 20  if( got>0 ){.   
1b050 20 20 20 63 6e 74 20 2d 3d 20 67 6f 74 3b 0a 20     cnt -= got;. 
1b060 20 20 20 20 20 6f 66 66 73 65 74 20 2b 3d 20 67       offset += g
1b070 6f 74 3b 0a 20 20 20 20 20 20 70 72 69 6f 72 20  ot;.      prior 
1b080 2b 3d 20 67 6f 74 3b 0a 20 20 20 20 20 20 70 42  += got;.      pB
1b090 75 66 20 3d 20 28 76 6f 69 64 2a 29 28 67 6f 74  uf = (void*)(got
1b0a0 20 2b 20 28 63 68 61 72 2a 29 70 42 75 66 29 3b   + (char*)pBuf);
1b0b0 0a 20 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28  .    }.  }while(
1b0c0 20 67 6f 74 3e 30 20 29 3b 0a 20 20 54 49 4d 45   got>0 );.  TIME
1b0d0 52 5f 45 4e 44 3b 0a 20 20 4f 53 54 52 41 43 45  R_END;.  OSTRACE
1b0e0 28 28 22 52 45 41 44 20 20 20 20 25 2d 33 64 20  (("READ    %-3d 
1b0f0 25 35 64 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e  %5d %7lld %llu\n
1b100 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  ",.            i
1b110 64 2d 3e 68 2c 20 67 6f 74 2b 70 72 69 6f 72 2c  d->h, got+prior,
1b120 20 6f 66 66 73 65 74 2d 70 72 69 6f 72 2c 20 54   offset-prior, T
1b130 49 4d 45 52 5f 45 4c 41 50 53 45 44 29 29 3b 0a  IMER_ELAPSED));.
1b140 20 20 72 65 74 75 72 6e 20 67 6f 74 2b 70 72 69    return got+pri
1b150 6f 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61  or;.}../*.** Rea
1b160 64 20 64 61 74 61 20 66 72 6f 6d 20 61 20 66 69  d data from a fi
1b170 6c 65 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72  le into a buffer
1b180 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  .  Return SQLITE
1b190 5f 4f 4b 20 69 66 20 61 6c 6c 0a 2a 2a 20 62 79  _OK if all.** by
1b1a0 74 65 73 20 77 65 72 65 20 72 65 61 64 20 73 75  tes were read su
1b1b0 63 63 65 73 73 66 75 6c 6c 79 20 61 6e 64 20 53  ccessfully and S
1b1c0 51 4c 49 54 45 5f 49 4f 45 52 52 20 69 66 20 61  QLITE_IOERR if a
1b1d0 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20  nything goes.** 
1b1e0 77 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63  wrong..*/.static
1b1f0 20 69 6e 74 20 75 6e 69 78 52 65 61 64 28 0a 20   int unixRead(. 
1b200 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69   sqlite3_file *i
1b210 64 2c 20 0a 20 20 76 6f 69 64 20 2a 70 42 75 66  d, .  void *pBuf
1b220 2c 20 0a 20 20 69 6e 74 20 61 6d 74 2c 0a 20 20  , .  int amt,.  
1b230 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 6f 66  sqlite3_int64 of
1b240 66 73 65 74 0a 29 7b 0a 20 20 75 6e 69 78 46 69  fset.){.  unixFi
1b250 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69  le *pFile = (uni
1b260 78 46 69 6c 65 20 2a 29 69 64 3b 0a 20 20 69 6e  xFile *)id;.  in
1b270 74 20 67 6f 74 3b 0a 20 20 61 73 73 65 72 74 28  t got;.  assert(
1b280 20 69 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28   id );.  assert(
1b290 20 6f 66 66 73 65 74 3e 3d 30 20 29 3b 0a 20 20   offset>=0 );.  
1b2a0 61 73 73 65 72 74 28 20 61 6d 74 3e 30 20 29 3b  assert( amt>0 );
1b2b0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69  ..  /* If this i
1b2c0 73 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c  s a database fil
1b2d0 65 20 28 6e 6f 74 20 61 20 6a 6f 75 72 6e 61 6c  e (not a journal
1b2e0 2c 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c  , master-journal
1b2f0 20 6f 72 20 74 65 6d 70 0a 20 20 2a 2a 20 66 69   or temp.  ** fi
1b300 6c 65 29 2c 20 74 68 65 20 62 79 74 65 73 20 69  le), the bytes i
1b310 6e 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 72 61  n the locking ra
1b320 6e 67 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72  nge should never
1b330 20 62 65 20 72 65 61 64 20 6f 72 20 77 72 69 74   be read or writ
1b340 74 65 6e 2e 20 2a 2f 0a 23 69 66 20 30 0a 20 20  ten. */.#if 0.  
1b350 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 70  assert( pFile->p
1b360 50 72 65 61 6c 6c 6f 63 61 74 65 64 55 6e 75 73  PreallocatedUnus
1b370 65 64 3d 3d 30 0a 20 20 20 20 20 20 20 7c 7c 20  ed==0.       || 
1b380 6f 66 66 73 65 74 3e 3d 50 45 4e 44 49 4e 47 5f  offset>=PENDING_
1b390 42 59 54 45 2b 35 31 32 0a 20 20 20 20 20 20 20  BYTE+512.       
1b3a0 7c 7c 20 6f 66 66 73 65 74 2b 61 6d 74 3c 3d 50  || offset+amt<=P
1b3b0 45 4e 44 49 4e 47 5f 42 59 54 45 20 0a 20 20 29  ENDING_BYTE .  )
1b3c0 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51  ;.#endif..#if SQ
1b3d0 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49  LITE_MAX_MMAP_SI
1b3e0 5a 45 3e 30 0a 20 20 2f 2a 20 44 65 61 6c 20 77  ZE>0.  /* Deal w
1b3f0 69 74 68 20 61 73 20 6d 75 63 68 20 6f 66 20 74  ith as much of t
1b400 68 69 73 20 72 65 61 64 20 72 65 71 75 65 73 74  his read request
1b410 20 61 73 20 70 6f 73 73 69 62 6c 65 20 62 79 20   as possible by 
1b420 74 72 61 6e 73 66 65 72 69 6e 67 0a 20 20 2a 2a  transfering.  **
1b430 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 6d   data from the m
1b440 65 6d 6f 72 79 20 6d 61 70 70 69 6e 67 20 75 73  emory mapping us
1b450 69 6e 67 20 6d 65 6d 63 70 79 28 29 2e 20 20 2a  ing memcpy().  *
1b460 2f 0a 20 20 69 66 28 20 6f 66 66 73 65 74 3c 70  /.  if( offset<p
1b470 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20 29  File->mmapSize )
1b480 7b 0a 20 20 20 20 69 66 28 20 6f 66 66 73 65 74  {.    if( offset
1b490 2b 61 6d 74 20 3c 3d 20 70 46 69 6c 65 2d 3e 6d  +amt <= pFile->m
1b4a0 6d 61 70 53 69 7a 65 20 29 7b 0a 20 20 20 20 20  mapSize ){.     
1b4b0 20 6d 65 6d 63 70 79 28 70 42 75 66 2c 20 26 28   memcpy(pBuf, &(
1b4c0 28 75 38 20 2a 29 28 70 46 69 6c 65 2d 3e 70 4d  (u8 *)(pFile->pM
1b4d0 61 70 52 65 67 69 6f 6e 29 29 5b 6f 66 66 73 65  apRegion))[offse
1b4e0 74 5d 2c 20 61 6d 74 29 3b 0a 20 20 20 20 20 20  t], amt);.      
1b4f0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
1b500 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
1b510 20 20 20 69 6e 74 20 6e 43 6f 70 79 20 3d 20 70     int nCopy = p
1b520 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20 2d  File->mmapSize -
1b530 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 20 20 6d   offset;.      m
1b540 65 6d 63 70 79 28 70 42 75 66 2c 20 26 28 28 75  emcpy(pBuf, &((u
1b550 38 20 2a 29 28 70 46 69 6c 65 2d 3e 70 4d 61 70  8 *)(pFile->pMap
1b560 52 65 67 69 6f 6e 29 29 5b 6f 66 66 73 65 74 5d  Region))[offset]
1b570 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20 20 20  , nCopy);.      
1b580 70 42 75 66 20 3d 20 26 28 28 75 38 20 2a 29 70  pBuf = &((u8 *)p
1b590 42 75 66 29 5b 6e 43 6f 70 79 5d 3b 0a 20 20 20  Buf)[nCopy];.   
1b5a0 20 20 20 61 6d 74 20 2d 3d 20 6e 43 6f 70 79 3b     amt -= nCopy;
1b5b0 0a 20 20 20 20 20 20 6f 66 66 73 65 74 20 2b 3d  .      offset +=
1b5c0 20 6e 43 6f 70 79 3b 0a 20 20 20 20 7d 0a 20 20   nCopy;.    }.  
1b5d0 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 67 6f 74 20  }.#endif..  got 
1b5e0 3d 20 73 65 65 6b 41 6e 64 52 65 61 64 28 70 46  = seekAndRead(pF
1b5f0 69 6c 65 2c 20 6f 66 66 73 65 74 2c 20 70 42 75  ile, offset, pBu
1b600 66 2c 20 61 6d 74 29 3b 0a 20 20 69 66 28 20 67  f, amt);.  if( g
1b610 6f 74 3d 3d 61 6d 74 20 29 7b 0a 20 20 20 20 72  ot==amt ){.    r
1b620 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
1b630 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 67 6f 74  .  }else if( got
1b640 3c 30 20 29 7b 0a 20 20 20 20 2f 2a 20 6c 61 73  <0 ){.    /* las
1b650 74 45 72 72 6e 6f 20 73 65 74 20 62 79 20 73 65  tErrno set by se
1b660 65 6b 41 6e 64 52 65 61 64 20 2a 2f 0a 20 20 20  ekAndRead */.   
1b670 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49   return SQLITE_I
1b680 4f 45 52 52 5f 52 45 41 44 3b 0a 20 20 7d 65 6c  OERR_READ;.  }el
1b690 73 65 7b 0a 20 20 20 20 73 74 6f 72 65 4c 61 73  se{.    storeLas
1b6a0 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 30 29  tErrno(pFile, 0)
1b6b0 3b 20 20 20 2f 2a 20 6e 6f 74 20 61 20 73 79 73  ;   /* not a sys
1b6c0 74 65 6d 20 65 72 72 6f 72 20 2a 2f 0a 20 20 20  tem error */.   
1b6d0 20 2f 2a 20 55 6e 72 65 61 64 20 70 61 72 74 73   /* Unread parts
1b6e0 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 20 6d   of the buffer m
1b6f0 75 73 74 20 62 65 20 7a 65 72 6f 2d 66 69 6c 6c  ust be zero-fill
1b700 65 64 20 2a 2f 0a 20 20 20 20 6d 65 6d 73 65 74  ed */.    memset
1b710 28 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b  (&((char*)pBuf)[
1b720 67 6f 74 5d 2c 20 30 2c 20 61 6d 74 2d 67 6f 74  got], 0, amt-got
1b730 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
1b740 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54  LITE_IOERR_SHORT
1b750 5f 52 45 41 44 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  _READ;.  }.}../*
1b760 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73  .** Attempt to s
1b770 65 65 6b 20 74 68 65 20 66 69 6c 65 2d 64 65 73  eek the file-des
1b780 63 72 69 70 74 6f 72 20 70 61 73 73 65 64 20 61  criptor passed a
1b790 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  s the first argu
1b7a0 6d 65 6e 74 20 74 6f 0a 2a 2a 20 61 62 73 6f 6c  ment to.** absol
1b7b0 75 74 65 20 6f 66 66 73 65 74 20 69 4f 66 66 2c  ute offset iOff,
1b7c0 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f   then attempt to
1b7d0 20 77 72 69 74 65 20 6e 42 75 66 20 62 79 74 65   write nBuf byte
1b7e0 73 20 6f 66 20 64 61 74 61 20 66 72 6f 6d 0a 2a  s of data from.*
1b7f0 2a 20 70 42 75 66 20 74 6f 20 69 74 2e 20 49 66  * pBuf to it. If
1b800 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
1b810 2c 20 72 65 74 75 72 6e 20 2d 31 20 61 6e 64 20  , return -1 and 
1b820 73 65 74 20 2a 70 69 45 72 72 6e 6f 2e 20 4f 74  set *piErrno. Ot
1b830 68 65 72 77 69 73 65 2c 20 0a 2a 2a 20 72 65 74  herwise, .** ret
1b840 75 72 6e 20 74 68 65 20 61 63 74 75 61 6c 20 6e  urn the actual n
1b850 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77  umber of bytes w
1b860 72 69 74 74 65 6e 20 28 77 68 69 63 68 20 6d 61  ritten (which ma
1b870 79 20 62 65 20 6c 65 73 73 20 74 68 61 6e 0a 2a  y be less than.*
1b880 2a 20 6e 42 75 66 29 2e 0a 2a 2f 0a 73 74 61 74  * nBuf)..*/.stat
1b890 69 63 20 69 6e 74 20 73 65 65 6b 41 6e 64 57 72  ic int seekAndWr
1b8a0 69 74 65 46 64 28 0a 20 20 69 6e 74 20 66 64 2c  iteFd(.  int fd,
1b8b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b8c0 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65           /* File
1b8d0 20 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20 77   descriptor to w
1b8e0 72 69 74 65 20 74 6f 20 2a 2f 0a 20 20 69 36 34  rite to */.  i64
1b8f0 20 69 4f 66 66 2c 20 20 20 20 20 20 20 20 20 20   iOff,          
1b900 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1b910 46 69 6c 65 20 6f 66 66 73 65 74 20 74 6f 20 62  File offset to b
1b920 65 67 69 6e 20 77 72 69 74 69 6e 67 20 61 74 20  egin writing at 
1b930 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  */.  const void 
1b940 2a 70 42 75 66 2c 20 20 20 20 20 20 20 20 20 20  *pBuf,          
1b950 20 20 20 20 20 2f 2a 20 43 6f 70 79 20 64 61 74       /* Copy dat
1b960 61 20 66 72 6f 6d 20 74 68 69 73 20 62 75 66 66  a from this buff
1b970 65 72 20 74 6f 20 74 68 65 20 66 69 6c 65 20 2a  er to the file *
1b980 2f 0a 20 20 69 6e 74 20 6e 42 75 66 2c 20 20 20  /.  int nBuf,   
1b990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b9a0 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 62      /* Size of b
1b9b0 75 66 66 65 72 20 70 42 75 66 20 69 6e 20 62 79  uffer pBuf in by
1b9c0 74 65 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 69  tes */.  int *pi
1b9d0 45 72 72 6e 6f 20 20 20 20 20 20 20 20 20 20 20  Errno           
1b9e0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
1b9f0 20 45 72 72 6f 72 20 6e 75 6d 62 65 72 20 69 66   Error number if
1ba00 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 2a 2f   error occurs */
1ba10 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30  .){.  int rc = 0
1ba20 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1ba30 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72        /* Value r
1ba40 65 74 75 72 6e 65 64 20 62 79 20 73 79 73 74 65  eturned by syste
1ba50 6d 20 63 61 6c 6c 20 2a 2f 0a 0a 20 20 61 73 73  m call */..  ass
1ba60 65 72 74 28 20 6e 42 75 66 3d 3d 28 6e 42 75 66  ert( nBuf==(nBuf
1ba70 26 30 78 31 66 66 66 66 29 20 29 3b 0a 20 20 61  &0x1ffff) );.  a
1ba80 73 73 65 72 74 28 20 66 64 3e 32 20 29 3b 0a 20  ssert( fd>2 );. 
1ba90 20 61 73 73 65 72 74 28 20 70 69 45 72 72 6e 6f   assert( piErrno
1baa0 21 3d 30 20 29 3b 0a 20 20 6e 42 75 66 20 26 3d  !=0 );.  nBuf &=
1bab0 20 30 78 31 66 66 66 66 3b 0a 20 20 54 49 4d 45   0x1ffff;.  TIME
1bac0 52 5f 53 54 41 52 54 3b 0a 0a 23 69 66 20 64 65  R_START;..#if de
1bad0 66 69 6e 65 64 28 55 53 45 5f 50 52 45 41 44 29  fined(USE_PREAD)
1bae0 0a 20 20 64 6f 7b 20 72 63 20 3d 20 28 69 6e 74  .  do{ rc = (int
1baf0 29 6f 73 50 77 72 69 74 65 28 66 64 2c 20 70 42  )osPwrite(fd, pB
1bb00 75 66 2c 20 6e 42 75 66 2c 20 69 4f 66 66 29 3b  uf, nBuf, iOff);
1bb10 20 7d 77 68 69 6c 65 28 20 72 63 3c 30 20 26 26   }while( rc<0 &&
1bb20 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 29 3b   errno==EINTR );
1bb30 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 55  .#elif defined(U
1bb40 53 45 5f 50 52 45 41 44 36 34 29 0a 20 20 64 6f  SE_PREAD64).  do
1bb50 7b 20 72 63 20 3d 20 28 69 6e 74 29 6f 73 50 77  { rc = (int)osPw
1bb60 72 69 74 65 36 34 28 66 64 2c 20 70 42 75 66 2c  rite64(fd, pBuf,
1bb70 20 6e 42 75 66 2c 20 69 4f 66 66 29 3b 7d 77 68   nBuf, iOff);}wh
1bb80 69 6c 65 28 20 72 63 3c 30 20 26 26 20 65 72 72  ile( rc<0 && err
1bb90 6e 6f 3d 3d 45 49 4e 54 52 29 3b 0a 23 65 6c 73  no==EINTR);.#els
1bba0 65 0a 20 20 64 6f 7b 0a 20 20 20 20 69 36 34 20  e.  do{.    i64 
1bbb0 69 53 65 65 6b 20 3d 20 6c 73 65 65 6b 28 66 64  iSeek = lseek(fd
1bbc0 2c 20 69 4f 66 66 2c 20 53 45 45 4b 5f 53 45 54  , iOff, SEEK_SET
1bbd0 29 3b 0a 20 20 20 20 53 69 6d 75 6c 61 74 65 49  );.    SimulateI
1bbe0 4f 45 72 72 6f 72 28 20 69 53 65 65 6b 20 3d 20  OError( iSeek = 
1bbf0 2d 31 20 29 3b 0a 20 20 20 20 69 66 28 20 69 53  -1 );.    if( iS
1bc00 65 65 6b 3c 30 20 29 7b 0a 20 20 20 20 20 20 72  eek<0 ){.      r
1bc10 63 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 62 72  c = -1;.      br
1bc20 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72  eak;.    }.    r
1bc30 63 20 3d 20 6f 73 57 72 69 74 65 28 66 64 2c 20  c = osWrite(fd, 
1bc40 70 42 75 66 2c 20 6e 42 75 66 29 3b 0a 20 20 7d  pBuf, nBuf);.  }
1bc50 77 68 69 6c 65 28 20 72 63 3c 30 20 26 26 20 65  while( rc<0 && e
1bc60 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 29 3b 0a 23  rrno==EINTR );.#
1bc70 65 6e 64 69 66 0a 0a 20 20 54 49 4d 45 52 5f 45  endif..  TIMER_E
1bc80 4e 44 3b 0a 20 20 4f 53 54 52 41 43 45 28 28 22  ND;.  OSTRACE(("
1bc90 57 52 49 54 45 20 20 20 25 2d 33 64 20 25 35 64  WRITE   %-3d %5d
1bca0 20 25 37 6c 6c 64 20 25 6c 6c 75 5c 6e 22 2c 20   %7lld %llu\n", 
1bcb0 66 64 2c 20 72 63 2c 20 69 4f 66 66 2c 20 54 49  fd, rc, iOff, TI
1bcc0 4d 45 52 5f 45 4c 41 50 53 45 44 29 29 3b 0a 0a  MER_ELAPSED));..
1bcd0 20 20 69 66 28 20 72 63 3c 30 20 29 20 2a 70 69    if( rc<0 ) *pi
1bce0 45 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20  Errno = errno;. 
1bcf0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a   return rc;.}...
1bd00 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 6f 20 74 68  /*.** Seek to th
1bd10 65 20 6f 66 66 73 65 74 20 69 6e 20 69 64 2d 3e  e offset in id->
1bd20 6f 66 66 73 65 74 20 74 68 65 6e 20 72 65 61 64  offset then read
1bd30 20 63 6e 74 20 62 79 74 65 73 20 69 6e 74 6f 20   cnt bytes into 
1bd40 70 42 75 66 2e 0a 2a 2a 20 52 65 74 75 72 6e 20  pBuf..** Return 
1bd50 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
1bd60 74 65 73 20 61 63 74 75 61 6c 6c 79 20 72 65 61  tes actually rea
1bd70 64 2e 20 20 55 70 64 61 74 65 20 74 68 65 20 6f  d.  Update the o
1bd80 66 66 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20  ffset..**.** To 
1bd90 61 76 6f 69 64 20 73 74 6f 6d 70 69 6e 67 20 74  avoid stomping t
1bda0 68 65 20 65 72 72 6e 6f 20 76 61 6c 75 65 20 6f  he errno value o
1bdb0 6e 20 61 20 66 61 69 6c 65 64 20 77 72 69 74 65  n a failed write
1bdc0 20 74 68 65 20 6c 61 73 74 45 72 72 6e 6f 20 76   the lastErrno v
1bdd0 61 6c 75 65 0a 2a 2a 20 69 73 20 73 65 74 20 62  alue.** is set b
1bde0 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e  efore returning.
1bdf0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73  .*/.static int s
1be00 65 65 6b 41 6e 64 57 72 69 74 65 28 75 6e 69 78  eekAndWrite(unix
1be10 46 69 6c 65 20 2a 69 64 2c 20 69 36 34 20 6f 66  File *id, i64 of
1be20 66 73 65 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64  fset, const void
1be30 20 2a 70 42 75 66 2c 20 69 6e 74 20 63 6e 74 29   *pBuf, int cnt)
1be40 7b 0a 20 20 72 65 74 75 72 6e 20 73 65 65 6b 41  {.  return seekA
1be50 6e 64 57 72 69 74 65 46 64 28 69 64 2d 3e 68 2c  ndWriteFd(id->h,
1be60 20 6f 66 66 73 65 74 2c 20 70 42 75 66 2c 20 63   offset, pBuf, c
1be70 6e 74 2c 20 26 69 64 2d 3e 6c 61 73 74 45 72 72  nt, &id->lastErr
1be80 6e 6f 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 57  no);.}.../*.** W
1be90 72 69 74 65 20 64 61 74 61 20 66 72 6f 6d 20 61  rite data from a
1bea0 20 62 75 66 66 65 72 20 69 6e 74 6f 20 61 20 66   buffer into a f
1beb0 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 51 4c  ile.  Return SQL
1bec0 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73  ITE_OK on succes
1bed0 73 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20 6f 74 68  s.** or some oth
1bee0 65 72 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 6e  er error code on
1bef0 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a 73 74 61   failure..*/.sta
1bf00 74 69 63 20 69 6e 74 20 75 6e 69 78 57 72 69 74  tic int unixWrit
1bf10 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  e(.  sqlite3_fil
1bf20 65 20 2a 69 64 2c 20 0a 20 20 63 6f 6e 73 74 20  e *id, .  const 
1bf30 76 6f 69 64 20 2a 70 42 75 66 2c 20 0a 20 20 69  void *pBuf, .  i
1bf40 6e 74 20 61 6d 74 2c 0a 20 20 73 71 6c 69 74 65  nt amt,.  sqlite
1bf50 33 5f 69 6e 74 36 34 20 6f 66 66 73 65 74 20 0a  3_int64 offset .
1bf60 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70  ){.  unixFile *p
1bf70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65  File = (unixFile
1bf80 2a 29 69 64 3b 0a 20 20 69 6e 74 20 77 72 6f 74  *)id;.  int wrot
1bf90 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 28  e = 0;.  assert(
1bfa0 20 69 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28   id );.  assert(
1bfb0 20 61 6d 74 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20   amt>0 );..  /* 
1bfc0 49 66 20 74 68 69 73 20 69 73 20 61 20 64 61 74  If this is a dat
1bfd0 61 62 61 73 65 20 66 69 6c 65 20 28 6e 6f 74 20  abase file (not 
1bfe0 61 20 6a 6f 75 72 6e 61 6c 2c 20 6d 61 73 74 65  a journal, maste
1bff0 72 2d 6a 6f 75 72 6e 61 6c 20 6f 72 20 74 65 6d  r-journal or tem
1c000 70 0a 20 20 2a 2a 20 66 69 6c 65 29 2c 20 74 68  p.  ** file), th
1c010 65 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 6c  e bytes in the l
1c020 6f 63 6b 69 6e 67 20 72 61 6e 67 65 20 73 68 6f  ocking range sho
1c030 75 6c 64 20 6e 65 76 65 72 20 62 65 20 72 65 61  uld never be rea
1c040 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 2a 2f  d or written. */
1c050 0a 23 69 66 20 30 0a 20 20 61 73 73 65 72 74 28  .#if 0.  assert(
1c060 20 70 46 69 6c 65 2d 3e 70 50 72 65 61 6c 6c 6f   pFile->pPreallo
1c070 63 61 74 65 64 55 6e 75 73 65 64 3d 3d 30 0a 20  catedUnused==0. 
1c080 20 20 20 20 20 20 7c 7c 20 6f 66 66 73 65 74 3e        || offset>
1c090 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 2b 35 31  =PENDING_BYTE+51
1c0a0 32 0a 20 20 20 20 20 20 20 7c 7c 20 6f 66 66 73  2.       || offs
1c0b0 65 74 2b 61 6d 74 3c 3d 50 45 4e 44 49 4e 47 5f  et+amt<=PENDING_
1c0c0 42 59 54 45 20 0a 20 20 29 3b 0a 23 65 6e 64 69  BYTE .  );.#endi
1c0d0 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  f..#ifdef SQLITE
1c0e0 5f 44 45 42 55 47 0a 20 20 2f 2a 20 49 66 20 77  _DEBUG.  /* If w
1c0f0 65 20 61 72 65 20 64 6f 69 6e 67 20 61 20 6e 6f  e are doing a no
1c100 72 6d 61 6c 20 77 72 69 74 65 20 74 6f 20 61 20  rmal write to a 
1c110 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 61  database file (a
1c120 73 20 6f 70 70 6f 73 65 64 20 74 6f 0a 20 20 2a  s opposed to.  *
1c130 2a 20 64 6f 69 6e 67 20 61 20 68 6f 74 2d 6a 6f  * doing a hot-jo
1c140 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 6f  urnal rollback o
1c150 72 20 61 20 77 72 69 74 65 20 74 6f 20 73 6f 6d  r a write to som
1c160 65 20 66 69 6c 65 20 6f 74 68 65 72 20 74 68 61  e file other tha
1c170 6e 20 61 0a 20 20 2a 2a 20 6e 6f 72 6d 61 6c 20  n a.  ** normal 
1c180 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 20 74  database file) t
1c190 68 65 6e 20 72 65 63 6f 72 64 20 74 68 65 20 66  hen record the f
1c1a0 61 63 74 20 74 68 61 74 20 74 68 65 20 64 61 74  act that the dat
1c1b0 61 62 61 73 65 0a 20 20 2a 2a 20 68 61 73 20 63  abase.  ** has c
1c1c0 68 61 6e 67 65 64 2e 20 20 49 66 20 74 68 65 20  hanged.  If the 
1c1d0 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e  transaction coun
1c1e0 74 65 72 20 69 73 20 6d 6f 64 69 66 69 65 64 2c  ter is modified,
1c1f0 20 72 65 63 6f 72 64 20 74 68 61 74 0a 20 20 2a   record that.  *
1c200 2a 20 66 61 63 74 20 74 6f 6f 2e 0a 20 20 2a 2f  * fact too..  */
1c210 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 69 6e  .  if( pFile->in
1c220 4e 6f 72 6d 61 6c 57 72 69 74 65 20 29 7b 0a 20  NormalWrite ){. 
1c230 20 20 20 70 46 69 6c 65 2d 3e 64 62 55 70 64 61     pFile->dbUpda
1c240 74 65 20 3d 20 31 3b 20 20 2f 2a 20 54 68 65 20  te = 1;  /* The 
1c250 64 61 74 61 62 61 73 65 20 68 61 73 20 62 65 65  database has bee
1c260 6e 20 6d 6f 64 69 66 69 65 64 20 2a 2f 0a 20 20  n modified */.  
1c270 20 20 69 66 28 20 6f 66 66 73 65 74 3c 3d 32 34    if( offset<=24
1c280 20 26 26 20 6f 66 66 73 65 74 2b 61 6d 74 3e 3d   && offset+amt>=
1c290 32 37 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20  27 ){.      int 
1c2a0 72 63 3b 0a 20 20 20 20 20 20 63 68 61 72 20 6f  rc;.      char o
1c2b0 6c 64 43 6e 74 72 5b 34 5d 3b 0a 20 20 20 20 20  ldCntr[4];.     
1c2c0 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
1c2d0 42 65 6e 69 67 6e 28 31 29 3b 0a 20 20 20 20 20  Benign(1);.     
1c2e0 20 72 63 20 3d 20 73 65 65 6b 41 6e 64 52 65 61   rc = seekAndRea
1c2f0 64 28 70 46 69 6c 65 2c 20 32 34 2c 20 6f 6c 64  d(pFile, 24, old
1c300 43 6e 74 72 2c 20 34 29 3b 0a 20 20 20 20 20 20  Cntr, 4);.      
1c310 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 42  SimulateIOErrorB
1c320 65 6e 69 67 6e 28 30 29 3b 0a 20 20 20 20 20 20  enign(0);.      
1c330 69 66 28 20 72 63 21 3d 34 20 7c 7c 20 6d 65 6d  if( rc!=4 || mem
1c340 63 6d 70 28 6f 6c 64 43 6e 74 72 2c 20 26 28 28  cmp(oldCntr, &((
1c350 63 68 61 72 2a 29 70 42 75 66 29 5b 32 34 2d 6f  char*)pBuf)[24-o
1c360 66 66 73 65 74 5d 2c 20 34 29 21 3d 30 20 29 7b  ffset], 4)!=0 ){
1c370 0a 20 20 20 20 20 20 20 20 70 46 69 6c 65 2d 3e  .        pFile->
1c380 74 72 61 6e 73 43 6e 74 72 43 68 6e 67 20 3d 20  transCntrChng = 
1c390 31 3b 20 20 2f 2a 20 54 68 65 20 74 72 61 6e 73  1;  /* The trans
1c3a0 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 68  action counter h
1c3b0 61 73 20 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20  as changed */.  
1c3c0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
1c3d0 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 65 66 69  #endif..#if defi
1c3e0 6e 65 64 28 53 51 4c 49 54 45 5f 4d 4d 41 50 5f  ned(SQLITE_MMAP_
1c3f0 52 45 41 44 57 52 49 54 45 29 20 26 26 20 53 51  READWRITE) && SQ
1c400 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49  LITE_MAX_MMAP_SI
1c410 5a 45 3e 30 0a 20 20 2f 2a 20 44 65 61 6c 20 77  ZE>0.  /* Deal w
1c420 69 74 68 20 61 73 20 6d 75 63 68 20 6f 66 20 74  ith as much of t
1c430 68 69 73 20 77 72 69 74 65 20 72 65 71 75 65 73  his write reques
1c440 74 20 61 73 20 70 6f 73 73 69 62 6c 65 20 62 79  t as possible by
1c450 20 74 72 61 6e 73 66 65 72 69 6e 67 0a 20 20 2a   transfering.  *
1c460 2a 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20  * data from the 
1c470 6d 65 6d 6f 72 79 20 6d 61 70 70 69 6e 67 20 75  memory mapping u
1c480 73 69 6e 67 20 6d 65 6d 63 70 79 28 29 2e 20 20  sing memcpy().  
1c490 2a 2f 0a 20 20 69 66 28 20 6f 66 66 73 65 74 3c  */.  if( offset<
1c4a0 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20  pFile->mmapSize 
1c4b0 29 7b 0a 20 20 20 20 69 66 28 20 6f 66 66 73 65  ){.    if( offse
1c4c0 74 2b 61 6d 74 20 3c 3d 20 70 46 69 6c 65 2d 3e  t+amt <= pFile->
1c4d0 6d 6d 61 70 53 69 7a 65 20 29 7b 0a 20 20 20 20  mmapSize ){.    
1c4e0 20 20 6d 65 6d 63 70 79 28 26 28 28 75 38 20 2a    memcpy(&((u8 *
1c4f0 29 28 70 46 69 6c 65 2d 3e 70 4d 61 70 52 65 67  )(pFile->pMapReg
1c500 69 6f 6e 29 29 5b 6f 66 66 73 65 74 5d 2c 20 70  ion))[offset], p
1c510 42 75 66 2c 20 61 6d 74 29 3b 0a 20 20 20 20 20  Buf, amt);.     
1c520 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
1c530 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  K;.    }else{.  
1c540 20 20 20 20 69 6e 74 20 6e 43 6f 70 79 20 3d 20      int nCopy = 
1c550 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20  pFile->mmapSize 
1c560 2d 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 20 20  - offset;.      
1c570 6d 65 6d 63 70 79 28 26 28 28 75 38 20 2a 29 28  memcpy(&((u8 *)(
1c580 70 46 69 6c 65 2d 3e 70 4d 61 70 52 65 67 69 6f  pFile->pMapRegio
1c590 6e 29 29 5b 6f 66 66 73 65 74 5d 2c 20 70 42 75  n))[offset], pBu
1c5a0 66 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20 20  f, nCopy);.     
1c5b0 20 70 42 75 66 20 3d 20 26 28 28 75 38 20 2a 29   pBuf = &((u8 *)
1c5c0 70 42 75 66 29 5b 6e 43 6f 70 79 5d 3b 0a 20 20  pBuf)[nCopy];.  
1c5d0 20 20 20 20 61 6d 74 20 2d 3d 20 6e 43 6f 70 79      amt -= nCopy
1c5e0 3b 0a 20 20 20 20 20 20 6f 66 66 73 65 74 20 2b  ;.      offset +
1c5f0 3d 20 6e 43 6f 70 79 3b 0a 20 20 20 20 7d 0a 20  = nCopy;.    }. 
1c600 20 7d 0a 23 65 6e 64 69 66 0a 20 0a 20 20 77 68   }.#endif. .  wh
1c610 69 6c 65 28 20 28 77 72 6f 74 65 20 3d 20 73 65  ile( (wrote = se
1c620 65 6b 41 6e 64 57 72 69 74 65 28 70 46 69 6c 65  ekAndWrite(pFile
1c630 2c 20 6f 66 66 73 65 74 2c 20 70 42 75 66 2c 20  , offset, pBuf, 
1c640 61 6d 74 29 29 3c 61 6d 74 20 26 26 20 77 72 6f  amt))<amt && wro
1c650 74 65 3e 30 20 29 7b 0a 20 20 20 20 61 6d 74 20  te>0 ){.    amt 
1c660 2d 3d 20 77 72 6f 74 65 3b 0a 20 20 20 20 6f 66  -= wrote;.    of
1c670 66 73 65 74 20 2b 3d 20 77 72 6f 74 65 3b 0a 20  fset += wrote;. 
1c680 20 20 20 70 42 75 66 20 3d 20 26 28 28 63 68 61     pBuf = &((cha
1c690 72 2a 29 70 42 75 66 29 5b 77 72 6f 74 65 5d 3b  r*)pBuf)[wrote];
1c6a0 0a 20 20 7d 0a 20 20 53 69 6d 75 6c 61 74 65 49  .  }.  SimulateI
1c6b0 4f 45 72 72 6f 72 28 28 20 77 72 6f 74 65 3d 28  OError(( wrote=(
1c6c0 2d 31 29 2c 20 61 6d 74 3d 31 20 29 29 3b 0a 20  -1), amt=1 ));. 
1c6d0 20 53 69 6d 75 6c 61 74 65 44 69 73 6b 66 75 6c   SimulateDiskful
1c6e0 6c 45 72 72 6f 72 28 28 20 77 72 6f 74 65 3d 30  lError(( wrote=0
1c6f0 2c 20 61 6d 74 3d 31 20 29 29 3b 0a 0a 20 20 69  , amt=1 ));..  i
1c700 66 28 20 61 6d 74 3e 77 72 6f 74 65 20 29 7b 0a  f( amt>wrote ){.
1c710 20 20 20 20 69 66 28 20 77 72 6f 74 65 3c 30 20      if( wrote<0 
1c720 26 26 20 70 46 69 6c 65 2d 3e 6c 61 73 74 45 72  && pFile->lastEr
1c730 72 6e 6f 21 3d 45 4e 4f 53 50 43 20 29 7b 0a 20  rno!=ENOSPC ){. 
1c740 20 20 20 20 20 2f 2a 20 6c 61 73 74 45 72 72 6e       /* lastErrn
1c750 6f 20 73 65 74 20 62 79 20 73 65 65 6b 41 6e 64  o set by seekAnd
1c760 57 72 69 74 65 20 2a 2f 0a 20 20 20 20 20 20 72  Write */.      r
1c770 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45  eturn SQLITE_IOE
1c780 52 52 5f 57 52 49 54 45 3b 0a 20 20 20 20 7d 65  RR_WRITE;.    }e
1c790 6c 73 65 7b 0a 20 20 20 20 20 20 73 74 6f 72 65  lse{.      store
1c7a0 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65 2c  LastErrno(pFile,
1c7b0 20 30 29 3b 20 2f 2a 20 6e 6f 74 20 61 20 73 79   0); /* not a sy
1c7c0 73 74 65 6d 20 65 72 72 6f 72 20 2a 2f 0a 20 20  stem error */.  
1c7d0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
1c7e0 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 7d 0a 20 20  E_FULL;.    }.  
1c7f0 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  }..  return SQLI
1c800 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66  TE_OK;.}..#ifdef
1c810 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a   SQLITE_TEST./*.
1c820 2a 2a 20 43 6f 75 6e 74 20 74 68 65 20 6e 75 6d  ** Count the num
1c830 62 65 72 20 6f 66 20 66 75 6c 6c 73 79 6e 63 73  ber of fullsyncs
1c840 20 61 6e 64 20 6e 6f 72 6d 61 6c 20 73 79 6e 63   and normal sync
1c850 73 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  s.  This is used
1c860 20 74 6f 20 74 65 73 74 0a 2a 2a 20 74 68 61 74   to test.** that
1c870 20 73 79 6e 63 73 20 61 6e 64 20 66 75 6c 6c 73   syncs and fulls
1c880 79 6e 63 73 20 61 72 65 20 6f 63 63 75 72 72 69  yncs are occurri
1c890 6e 67 20 61 74 20 74 68 65 20 72 69 67 68 74 20  ng at the right 
1c8a0 74 69 6d 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  times..*/.int sq
1c8b0 6c 69 74 65 33 5f 73 79 6e 63 5f 63 6f 75 6e 74  lite3_sync_count
1c8c0 20 3d 20 30 3b 0a 69 6e 74 20 73 71 6c 69 74 65   = 0;.int sqlite
1c8d0 33 5f 66 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e 74  3_fullsync_count
1c8e0 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a   = 0;.#endif../*
1c8f0 0a 2a 2a 20 57 65 20 64 6f 20 6e 6f 74 20 74 72  .** We do not tr
1c900 75 73 74 20 73 79 73 74 65 6d 73 20 74 6f 20 70  ust systems to p
1c910 72 6f 76 69 64 65 20 61 20 77 6f 72 6b 69 6e 67  rovide a working
1c920 20 66 64 61 74 61 73 79 6e 63 28 29 2e 20 20 53   fdatasync().  S
1c930 6f 6d 65 20 64 6f 2e 0a 2a 2a 20 4f 74 68 65 72  ome do..** Other
1c940 73 20 64 6f 20 6e 6f 2e 20 20 54 6f 20 62 65 20  s do no.  To be 
1c950 73 61 66 65 2c 20 77 65 20 77 69 6c 6c 20 73 74  safe, we will st
1c960 69 63 6b 20 77 69 74 68 20 74 68 65 20 28 73 6c  ick with the (sl
1c970 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 29 0a 2a  ightly slower).*
1c980 2a 20 66 73 79 6e 63 28 29 2e 20 49 66 20 79 6f  * fsync(). If yo
1c990 75 20 6b 6e 6f 77 20 74 68 61 74 20 79 6f 75 72  u know that your
1c9a0 20 73 79 73 74 65 6d 20 64 6f 65 73 20 73 75 70   system does sup
1c9b0 70 6f 72 74 20 66 64 61 74 61 73 79 6e 63 28 29  port fdatasync()
1c9c0 20 63 6f 72 72 65 63 74 6c 79 2c 0a 2a 2a 20 74   correctly,.** t
1c9d0 68 65 6e 20 73 69 6d 70 6c 79 20 63 6f 6d 70 69  hen simply compi
1c9e0 6c 65 20 77 69 74 68 20 2d 44 66 64 61 74 61 73  le with -Dfdatas
1c9f0 79 6e 63 3d 66 64 61 74 61 73 79 6e 63 20 6f 72  ync=fdatasync or
1ca00 20 2d 44 48 41 56 45 5f 46 44 41 54 41 53 59 4e   -DHAVE_FDATASYN
1ca10 43 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65  C.*/.#if !define
1ca20 64 28 66 64 61 74 61 73 79 6e 63 29 20 26 26 20  d(fdatasync) && 
1ca30 21 48 41 56 45 5f 46 44 41 54 41 53 59 4e 43 0a  !HAVE_FDATASYNC.
1ca40 23 20 64 65 66 69 6e 65 20 66 64 61 74 61 73 79  # define fdatasy
1ca50 6e 63 20 66 73 79 6e 63 0a 23 65 6e 64 69 66 0a  nc fsync.#endif.
1ca60 0a 2f 2a 0a 2a 2a 20 44 65 66 69 6e 65 20 48 41  ./*.** Define HA
1ca70 56 45 5f 46 55 4c 4c 46 53 59 4e 43 20 74 6f 20  VE_FULLFSYNC to 
1ca80 30 20 6f 72 20 31 20 64 65 70 65 6e 64 69 6e 67  0 or 1 depending
1ca90 20 6f 6e 20 77 68 65 74 68 65 72 20 6f 72 20 6e   on whether or n
1caa0 6f 74 0a 2a 2a 20 74 68 65 20 46 5f 46 55 4c 4c  ot.** the F_FULL
1cab0 46 53 59 4e 43 20 6d 61 63 72 6f 20 69 73 20 64  FSYNC macro is d
1cac0 65 66 69 6e 65 64 2e 20 20 46 5f 46 55 4c 4c 46  efined.  F_FULLF
1cad0 53 59 4e 43 20 69 73 20 63 75 72 72 65 6e 74 6c  SYNC is currentl
1cae0 79 0a 2a 2a 20 6f 6e 6c 79 20 61 76 61 69 6c 61  y.** only availa
1caf0 62 6c 65 20 6f 6e 20 4d 61 63 20 4f 53 20 58 2e  ble on Mac OS X.
1cb00 20 20 42 75 74 20 74 68 61 74 20 63 6f 75 6c 64    But that could
1cb10 20 63 68 61 6e 67 65 2e 0a 2a 2f 0a 23 69 66 64   change..*/.#ifd
1cb20 65 66 20 46 5f 46 55 4c 4c 46 53 59 4e 43 0a 23  ef F_FULLFSYNC.#
1cb30 20 64 65 66 69 6e 65 20 48 41 56 45 5f 46 55 4c   define HAVE_FUL
1cb40 4c 46 53 59 4e 43 20 31 0a 23 65 6c 73 65 0a 23  LFSYNC 1.#else.#
1cb50 20 64 65 66 69 6e 65 20 48 41 56 45 5f 46 55 4c   define HAVE_FUL
1cb60 4c 46 53 59 4e 43 20 30 0a 23 65 6e 64 69 66 0a  LFSYNC 0.#endif.
1cb70 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 73 79 6e  ../*.** The fsyn
1cb80 63 28 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 20  c() system call 
1cb90 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 61 73  does not work as
1cba0 20 61 64 76 65 72 74 69 73 65 64 20 6f 6e 20 6d   advertised on m
1cbb0 61 6e 79 0a 2a 2a 20 75 6e 69 78 20 73 79 73 74  any.** unix syst
1cbc0 65 6d 73 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77  ems.  The follow
1cbd0 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 69 73  ing procedure is
1cbe0 20 61 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 6d   an attempt to m
1cbf0 61 6b 65 0a 2a 2a 20 69 74 20 77 6f 72 6b 20 62  ake.** it work b
1cc00 65 74 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  etter..**.** The
1cc10 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 20   SQLITE_NO_SYNC 
1cc20 6d 61 63 72 6f 20 64 69 73 61 62 6c 65 73 20 61  macro disables a
1cc30 6c 6c 20 66 73 79 6e 63 28 29 73 2e 20 20 54 68  ll fsync()s.  Th
1cc40 69 73 20 69 73 20 75 73 65 66 75 6c 0a 2a 2a 20  is is useful.** 
1cc50 66 6f 72 20 74 65 73 74 69 6e 67 20 77 68 65 6e  for testing when
1cc60 20 77 65 20 77 61 6e 74 20 74 6f 20 72 75 6e 20   we want to run 
1cc70 74 68 72 6f 75 67 68 20 74 68 65 20 74 65 73 74  through the test
1cc80 20 73 75 69 74 65 20 71 75 69 63 6b 6c 79 2e 0a   suite quickly..
1cc90 2a 2a 20 59 6f 75 20 61 72 65 20 73 74 72 6f 6e  ** You are stron
1cca0 67 6c 79 20 61 64 76 69 73 65 64 20 2a 6e 6f 74  gly advised *not
1ccb0 2a 20 74 6f 20 64 65 70 6c 6f 79 20 77 69 74 68  * to deploy with
1ccc0 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 0a   SQLITE_NO_SYNC.
1ccd0 2a 2a 20 65 6e 61 62 6c 65 64 2c 20 68 6f 77 65  ** enabled, howe
1cce0 76 65 72 2c 20 73 69 6e 63 65 20 77 69 74 68 20  ver, since with 
1ccf0 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 20 65  SQLITE_NO_SYNC e
1cd00 6e 61 62 6c 65 64 2c 20 61 6e 20 4f 53 20 63 72  nabled, an OS cr
1cd10 61 73 68 0a 2a 2a 20 6f 72 20 70 6f 77 65 72 20  ash.** or power 
1cd20 66 61 69 6c 75 72 65 20 77 69 6c 6c 20 6c 69 6b  failure will lik
1cd30 65 6c 79 20 63 6f 72 72 75 70 74 20 74 68 65 20  ely corrupt the 
1cd40 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a  database file..*
1cd50 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 73 65 74 73  *.** SQLite sets
1cd60 20 74 68 65 20 64 61 74 61 4f 6e 6c 79 20 66 6c   the dataOnly fl
1cd70 61 67 20 69 66 20 74 68 65 20 73 69 7a 65 20 6f  ag if the size o
1cd80 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 75 6e  f the file is un
1cd90 63 68 61 6e 67 65 64 2e 0a 2a 2a 20 54 68 65 20  changed..** The 
1cda0 69 64 65 61 20 62 65 68 69 6e 64 20 64 61 74 61  idea behind data
1cdb0 4f 6e 6c 79 20 69 73 20 74 68 61 74 20 69 74 20  Only is that it 
1cdc0 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 77 72 69 74  should only writ
1cdd0 65 20 74 68 65 20 66 69 6c 65 20 63 6f 6e 74 65  e the file conte
1cde0 6e 74 0a 2a 2a 20 74 6f 20 64 69 73 6b 2c 20 6e  nt.** to disk, n
1cdf0 6f 74 20 74 68 65 20 69 6e 6f 64 65 2e 20 20 57  ot the inode.  W
1ce00 65 20 6f 6e 6c 79 20 73 65 74 20 64 61 74 61 4f  e only set dataO
1ce10 6e 6c 79 20 69 66 20 74 68 65 20 66 69 6c 65 20  nly if the file 
1ce20 73 69 7a 65 20 69 73 20 0a 2a 2a 20 75 6e 63 68  size is .** unch
1ce30 61 6e 67 65 64 20 73 69 6e 63 65 20 74 68 65 20  anged since the 
1ce40 66 69 6c 65 20 73 69 7a 65 20 69 73 20 70 61 72  file size is par
1ce50 74 20 6f 66 20 74 68 65 20 69 6e 6f 64 65 2e 20  t of the inode. 
1ce60 20 48 6f 77 65 76 65 72 2c 20 0a 2a 2a 20 54 65   However, .** Te
1ce70 64 20 54 73 27 6f 20 74 65 6c 6c 73 20 75 73 20  d Ts'o tells us 
1ce80 74 68 61 74 20 66 64 61 74 61 73 79 6e 63 28 29  that fdatasync()
1ce90 20 77 69 6c 6c 20 61 6c 73 6f 20 77 72 69 74 65   will also write
1cea0 20 74 68 65 20 69 6e 6f 64 65 20 69 66 20 74 68   the inode if th
1ceb0 65 0a 2a 2a 20 66 69 6c 65 20 73 69 7a 65 20 68  e.** file size h
1cec0 61 73 20 63 68 61 6e 67 65 64 2e 20 20 54 68 65  as changed.  The
1ced0 20 6f 6e 6c 79 20 72 65 61 6c 20 64 69 66 66 65   only real diffe
1cee0 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 66 64  rence between fd
1cef0 61 74 61 73 79 6e 63 28 29 0a 2a 2a 20 61 6e 64  atasync().** and
1cf00 20 66 73 79 6e 63 28 29 2c 20 54 65 64 20 74 65   fsync(), Ted te
1cf10 6c 6c 73 20 75 73 2c 20 69 73 20 74 68 61 74 20  lls us, is that 
1cf20 66 64 61 74 61 73 79 6e 63 28 29 20 77 69 6c 6c  fdatasync() will
1cf30 20 6e 6f 74 20 66 6c 75 73 68 20 74 68 65 0a 2a   not flush the.*
1cf40 2a 20 69 6e 6f 64 65 20 69 66 20 74 68 65 20 6d  * inode if the m
1cf50 74 69 6d 65 20 6f 72 20 6f 77 6e 65 72 20 6f 72  time or owner or
1cf60 20 6f 74 68 65 72 20 69 6e 6f 64 65 20 61 74 74   other inode att
1cf70 72 69 62 75 74 65 73 20 68 61 76 65 20 63 68 61  ributes have cha
1cf80 6e 67 65 64 2e 0a 2a 2a 20 57 65 20 6f 6e 6c 79  nged..** We only
1cf90 20 63 61 72 65 20 61 62 6f 75 74 20 74 68 65 20   care about the 
1cfa0 66 69 6c 65 20 73 69 7a 65 2c 20 6e 6f 74 20 74  file size, not t
1cfb0 68 65 20 6f 74 68 65 72 20 66 69 6c 65 20 61 74  he other file at
1cfc0 74 72 69 62 75 74 65 73 2c 20 73 6f 0a 2a 2a 20  tributes, so.** 
1cfd0 61 73 20 66 61 72 20 61 73 20 53 51 4c 69 74 65  as far as SQLite
1cfe0 20 69 73 20 63 6f 6e 63 65 72 6e 65 64 2c 20 61   is concerned, a
1cff0 6e 20 66 64 61 74 61 73 79 6e 63 28 29 20 69 73  n fdatasync() is
1d000 20 61 6c 77 61 79 73 20 61 64 65 71 75 61 74 65   always adequate
1d010 2e 0a 2a 2a 20 53 6f 2c 20 77 65 20 61 6c 77 61  ..** So, we alwa
1d020 79 73 20 75 73 65 20 66 64 61 74 61 73 79 6e 63  ys use fdatasync
1d030 28 29 20 69 66 20 69 74 20 69 73 20 61 76 61 69  () if it is avai
1d040 6c 61 62 6c 65 2c 20 72 65 67 61 72 64 6c 65 73  lable, regardles
1d050 73 20 6f 66 0a 2a 2a 20 74 68 65 20 76 61 6c 75  s of.** the valu
1d060 65 20 6f 66 20 74 68 65 20 64 61 74 61 4f 6e 6c  e of the dataOnl
1d070 79 20 66 6c 61 67 2e 0a 2a 2f 0a 73 74 61 74 69  y flag..*/.stati
1d080 63 20 69 6e 74 20 66 75 6c 6c 5f 66 73 79 6e 63  c int full_fsync
1d090 28 69 6e 74 20 66 64 2c 20 69 6e 74 20 66 75 6c  (int fd, int ful
1d0a0 6c 53 79 6e 63 2c 20 69 6e 74 20 64 61 74 61 4f  lSync, int dataO
1d0b0 6e 6c 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  nly){.  int rc;.
1d0c0 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  .  /* The follow
1d0d0 69 6e 67 20 22 69 66 64 65 66 2f 65 6c 69 66 2f  ing "ifdef/elif/
1d0e0 65 6c 73 65 2f 22 20 62 6c 6f 63 6b 20 68 61 73  else/" block has
1d0f0 20 74 68 65 20 73 61 6d 65 20 73 74 72 75 63 74   the same struct
1d100 75 72 65 20 61 73 0a 20 20 2a 2a 20 74 68 65 20  ure as.  ** the 
1d110 6f 6e 65 20 62 65 6c 6f 77 2e 20 49 74 20 69 73  one below. It is
1d120 20 72 65 70 6c 69 63 61 74 65 64 20 68 65 72 65   replicated here
1d130 20 73 6f 6c 65 6c 79 20 74 6f 20 61 76 6f 69 64   solely to avoid
1d140 20 63 6c 75 74 74 65 72 69 6e 67 20 0a 20 20 2a   cluttering .  *
1d150 2a 20 75 70 20 74 68 65 20 72 65 61 6c 20 63 6f  * up the real co
1d160 64 65 20 77 69 74 68 20 74 68 65 20 55 4e 55 53  de with the UNUS
1d170 45 44 5f 50 41 52 41 4d 45 54 45 52 28 29 20 6d  ED_PARAMETER() m
1d180 61 63 72 6f 73 2e 0a 20 20 2a 2f 0a 23 69 66 64  acros..  */.#ifd
1d190 65 66 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e  ef SQLITE_NO_SYN
1d1a0 43 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  C.  UNUSED_PARAM
1d1b0 45 54 45 52 28 66 64 29 3b 0a 20 20 55 4e 55 53  ETER(fd);.  UNUS
1d1c0 45 44 5f 50 41 52 41 4d 45 54 45 52 28 66 75 6c  ED_PARAMETER(ful
1d1d0 6c 53 79 6e 63 29 3b 0a 20 20 55 4e 55 53 45 44  lSync);.  UNUSED
1d1e0 5f 50 41 52 41 4d 45 54 45 52 28 64 61 74 61 4f  _PARAMETER(dataO
1d1f0 6e 6c 79 29 3b 0a 23 65 6c 69 66 20 48 41 56 45  nly);.#elif HAVE
1d200 5f 46 55 4c 4c 46 53 59 4e 43 0a 20 20 55 4e 55  _FULLFSYNC.  UNU
1d210 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 64 61  SED_PARAMETER(da
1d220 74 61 4f 6e 6c 79 29 3b 0a 23 65 6c 73 65 0a 20  taOnly);.#else. 
1d230 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45   UNUSED_PARAMETE
1d240 52 28 66 75 6c 6c 53 79 6e 63 29 3b 0a 20 20 55  R(fullSync);.  U
1d250 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
1d260 64 61 74 61 4f 6e 6c 79 29 3b 0a 23 65 6e 64 69  dataOnly);.#endi
1d270 66 0a 0a 20 20 2f 2a 20 52 65 63 6f 72 64 20 74  f..  /* Record t
1d280 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d  he number of tim
1d290 65 73 20 74 68 61 74 20 77 65 20 64 6f 20 61 20  es that we do a 
1d2a0 6e 6f 72 6d 61 6c 20 66 73 79 6e 63 28 29 20 61  normal fsync() a
1d2b0 6e 64 20 0a 20 20 2a 2a 20 46 55 4c 4c 53 59 4e  nd .  ** FULLSYN
1d2c0 43 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  C.  This is used
1d2d0 20 64 75 72 69 6e 67 20 74 65 73 74 69 6e 67 20   during testing 
1d2e0 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74  to verify that t
1d2f0 68 69 73 20 70 72 6f 63 65 64 75 72 65 0a 20 20  his procedure.  
1d300 2a 2a 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77  ** gets called w
1d310 69 74 68 20 74 68 65 20 63 6f 72 72 65 63 74 20  ith the correct 
1d320 61 72 67 75 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a  arguments..  */.
1d330 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
1d340 53 54 0a 20 20 69 66 28 20 66 75 6c 6c 53 79 6e  ST.  if( fullSyn
1d350 63 20 29 20 73 71 6c 69 74 65 33 5f 66 75 6c 6c  c ) sqlite3_full
1d360 73 79 6e 63 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20  sync_count++;.  
1d370 73 71 6c 69 74 65 33 5f 73 79 6e 63 5f 63 6f 75  sqlite3_sync_cou
1d380 6e 74 2b 2b 3b 0a 23 65 6e 64 69 66 0a 0a 20 20  nt++;.#endif..  
1d390 2f 2a 20 49 66 20 77 65 20 63 6f 6d 70 69 6c 65  /* If we compile
1d3a0 64 20 77 69 74 68 20 74 68 65 20 53 51 4c 49 54  d with the SQLIT
1d3b0 45 5f 4e 4f 5f 53 59 4e 43 20 66 6c 61 67 2c 20  E_NO_SYNC flag, 
1d3c0 74 68 65 6e 20 73 79 6e 63 69 6e 67 20 69 73 20  then syncing is 
1d3d0 61 0a 20 20 2a 2a 20 6e 6f 2d 6f 70 2e 20 20 42  a.  ** no-op.  B
1d3e0 75 74 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20  ut go ahead and 
1d3f0 63 61 6c 6c 20 66 73 74 61 74 28 29 20 74 6f 20  call fstat() to 
1d400 76 61 6c 69 64 61 74 65 20 74 68 65 20 66 69 6c  validate the fil
1d410 65 0a 20 20 2a 2a 20 64 65 73 63 72 69 70 74 6f  e.  ** descripto
1d420 72 20 61 73 20 77 65 20 6e 65 65 64 20 61 20 6d  r as we need a m
1d430 65 74 68 6f 64 20 74 6f 20 70 72 6f 76 6f 6b 65  ethod to provoke
1d440 20 61 20 66 61 69 6c 75 72 65 20 64 75 72 69 6e   a failure durin
1d450 67 0a 20 20 2a 2a 20 63 6f 76 65 72 61 74 65 20  g.  ** coverate 
1d460 74 65 73 74 69 6e 67 2e 0a 20 20 2a 2f 0a 23 69  testing..  */.#i
1d470 66 64 65 66 20 53 51 4c 49 54 45 5f 4e 4f 5f 53  fdef SQLITE_NO_S
1d480 59 4e 43 0a 20 20 7b 0a 20 20 20 20 73 74 72 75  YNC.  {.    stru
1d490 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 20 20  ct stat buf;.   
1d4a0 20 72 63 20 3d 20 6f 73 46 73 74 61 74 28 66 64   rc = osFstat(fd
1d4b0 2c 20 26 62 75 66 29 3b 0a 20 20 7d 0a 23 65 6c  , &buf);.  }.#el
1d4c0 69 66 20 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e  if HAVE_FULLFSYN
1d4d0 43 0a 20 20 69 66 28 20 66 75 6c 6c 53 79 6e 63  C.  if( fullSync
1d4e0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 6f 73 46   ){.    rc = osF
1d4f0 63 6e 74 6c 28 66 64 2c 20 46 5f 46 55 4c 4c 46  cntl(fd, F_FULLF
1d500 53 59 4e 43 2c 20 30 29 3b 0a 20 20 7d 65 6c 73  SYNC, 0);.  }els
1d510 65 7b 0a 20 20 20 20 72 63 20 3d 20 31 3b 0a 20  e{.    rc = 1;. 
1d520 20 7d 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 46   }.  /* If the F
1d530 55 4c 4c 46 53 59 4e 43 20 66 61 69 6c 65 64 2c  ULLFSYNC failed,
1d540 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 61 74   fall back to at
1d550 74 65 6d 70 74 69 6e 67 20 61 6e 20 66 73 79 6e  tempting an fsyn
1d560 63 28 29 2e 0a 20 20 2a 2a 20 49 74 20 73 68 6f  c()..  ** It sho
1d570 75 6c 64 6e 27 74 20 62 65 20 70 6f 73 73 69 62  uldn't be possib
1d580 6c 65 20 66 6f 72 20 66 75 6c 6c 66 73 79 6e 63  le for fullfsync
1d590 20 74 6f 20 66 61 69 6c 20 6f 6e 20 74 68 65 20   to fail on the 
1d5a0 6c 6f 63 61 6c 20 0a 20 20 2a 2a 20 66 69 6c 65  local .  ** file
1d5b0 20 73 79 73 74 65 6d 20 28 6f 6e 20 4f 53 58 29   system (on OSX)
1d5c0 2c 20 73 6f 20 66 61 69 6c 75 72 65 20 69 6e 64  , so failure ind
1d5d0 69 63 61 74 65 73 20 74 68 61 74 20 46 55 4c 4c  icates that FULL
1d5e0 46 53 59 4e 43 0a 20 20 2a 2a 20 69 73 6e 27 74  FSYNC.  ** isn't
1d5f0 20 73 75 70 70 6f 72 74 65 64 20 66 6f 72 20 74   supported for t
1d600 68 69 73 20 66 69 6c 65 20 73 79 73 74 65 6d 2e  his file system.
1d610 20 53 6f 2c 20 61 74 74 65 6d 70 74 20 61 6e 20   So, attempt an 
1d620 66 73 79 6e 63 20 0a 20 20 2a 2a 20 61 6e 64 20  fsync .  ** and 
1d630 28 66 6f 72 20 6e 6f 77 29 20 69 67 6e 6f 72 65  (for now) ignore
1d640 20 74 68 65 20 6f 76 65 72 68 65 61 64 20 6f 66   the overhead of
1d650 20 61 20 73 75 70 65 72 66 6c 75 6f 75 73 20 66   a superfluous f
1d660 63 6e 74 6c 20 63 61 6c 6c 2e 20 20 0a 20 20 2a  cntl call.  .  *
1d670 2a 20 49 74 27 64 20 62 65 20 62 65 74 74 65 72  * It'd be better
1d680 20 74 6f 20 64 65 74 65 63 74 20 66 75 6c 6c 66   to detect fullf
1d690 73 79 6e 63 20 73 75 70 70 6f 72 74 20 6f 6e 63  sync support onc
1d6a0 65 20 61 6e 64 20 61 76 6f 69 64 20 0a 20 20 2a  e and avoid .  *
1d6b0 2a 20 74 68 65 20 66 63 6e 74 6c 20 63 61 6c 6c  * the fcntl call
1d6c0 20 65 76 65 72 79 20 74 69 6d 65 20 73 79 6e 63   every time sync
1d6d0 20 69 73 20 63 61 6c 6c 65 64 2e 0a 20 20 2a 2f   is called..  */
1d6e0 0a 20 20 69 66 28 20 72 63 20 29 20 72 63 20 3d  .  if( rc ) rc =
1d6f0 20 66 73 79 6e 63 28 66 64 29 3b 0a 0a 23 65 6c   fsync(fd);..#el
1d700 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50 50  if defined(__APP
1d710 4c 45 5f 5f 29 0a 20 20 2f 2a 20 66 64 61 74 61  LE__).  /* fdata
1d720 73 79 6e 63 28 29 20 6f 6e 20 48 46 53 2b 20 64  sync() on HFS+ d
1d730 6f 65 73 6e 27 74 20 79 65 74 20 66 6c 75 73 68  oesn't yet flush
1d740 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 20 69   the file size i
1d750 66 20 69 74 20 63 68 61 6e 67 65 64 20 63 6f 72  f it changed cor
1d760 72 65 63 74 6c 79 0a 20 20 2a 2a 20 73 6f 20 63  rectly.  ** so c
1d770 75 72 72 65 6e 74 6c 79 20 77 65 20 64 65 66 61  urrently we defa
1d780 75 6c 74 20 74 6f 20 74 68 65 20 6d 61 63 72 6f  ult to the macro
1d790 20 74 68 61 74 20 72 65 64 65 66 69 6e 65 73 20   that redefines 
1d7a0 66 64 61 74 61 73 79 6e 63 20 74 6f 20 66 73 79  fdatasync to fsy
1d7b0 6e 63 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 66  nc.  */.  rc = f
1d7c0 73 79 6e 63 28 66 64 29 3b 0a 23 65 6c 73 65 20  sync(fd);.#else 
1d7d0 0a 20 20 72 63 20 3d 20 66 64 61 74 61 73 79 6e  .  rc = fdatasyn
1d7e0 63 28 66 64 29 3b 0a 23 69 66 20 4f 53 5f 56 58  c(fd);.#if OS_VX
1d7f0 57 4f 52 4b 53 0a 20 20 69 66 28 20 72 63 3d 3d  WORKS.  if( rc==
1d800 2d 31 20 26 26 20 65 72 72 6e 6f 3d 3d 45 4e 4f  -1 && errno==ENO
1d810 54 53 55 50 20 29 7b 0a 20 20 20 20 72 63 20 3d  TSUP ){.    rc =
1d820 20 66 73 79 6e 63 28 66 64 29 3b 0a 20 20 7d 0a   fsync(fd);.  }.
1d830 23 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 57  #endif /* OS_VXW
1d840 4f 52 4b 53 20 2a 2f 0a 23 65 6e 64 69 66 20 2f  ORKS */.#endif /
1d850 2a 20 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4e  * ifdef SQLITE_N
1d860 4f 5f 53 59 4e 43 20 65 6c 69 66 20 48 41 56 45  O_SYNC elif HAVE
1d870 5f 46 55 4c 4c 46 53 59 4e 43 20 2a 2f 0a 0a 20  _FULLFSYNC */.. 
1d880 20 69 66 28 20 4f 53 5f 56 58 57 4f 52 4b 53 20   if( OS_VXWORKS 
1d890 26 26 20 72 63 21 3d 20 2d 31 20 29 7b 0a 20 20  && rc!= -1 ){.  
1d8a0 20 20 72 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20    rc = 0;.  }.  
1d8b0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
1d8c0 0a 2a 2a 20 4f 70 65 6e 20 61 20 66 69 6c 65 20  .** Open a file 
1d8d0 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20 74 68  descriptor to th
1d8e0 65 20 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74  e directory cont
1d8f0 61 69 6e 69 6e 67 20 66 69 6c 65 20 7a 46 69 6c  aining file zFil
1d900 65 6e 61 6d 65 2e 0a 2a 2a 20 49 66 20 73 75 63  ename..** If suc
1d910 63 65 73 73 66 75 6c 2c 20 2a 70 46 64 20 69 73  cessful, *pFd is
1d920 20 73 65 74 20 74 6f 20 74 68 65 20 6f 70 65 6e   set to the open
1d930 65 64 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  ed file descript
1d940 6f 72 20 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 45  or and.** SQLITE
1d950 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e  _OK is returned.
1d960 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   If an error occ
1d970 75 72 73 2c 20 65 69 74 68 65 72 20 53 51 4c 49  urs, either SQLI
1d980 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a 20 6f 72 20 53  TE_NOMEM.** or S
1d990 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 69  QLITE_CANTOPEN i
1d9a0 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a  s returned and *
1d9b0 70 46 64 20 69 73 20 73 65 74 20 74 6f 20 61 6e  pFd is set to an
1d9c0 20 75 6e 64 65 66 69 6e 65 64 0a 2a 2a 20 76 61   undefined.** va
1d9d0 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64  lue..**.** The d
1d9e0 69 72 65 63 74 6f 72 79 20 66 69 6c 65 20 64 65  irectory file de
1d9f0 73 63 72 69 70 74 6f 72 20 69 73 20 75 73 65 64  scriptor is used
1da00 20 66 6f 72 20 6f 6e 6c 79 20 6f 6e 65 20 74 68   for only one th
1da10 69 6e 67 20 2d 20 74 6f 0a 2a 2a 20 66 73 79 6e  ing - to.** fsyn
1da20 63 28 29 20 61 20 64 69 72 65 63 74 6f 72 79 20  c() a directory 
1da30 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 66 69 6c  to make sure fil
1da40 65 20 63 72 65 61 74 69 6f 6e 20 61 6e 64 20 64  e creation and d
1da50 65 6c 65 74 69 6f 6e 20 65 76 65 6e 74 73 0a 2a  eletion events.*
1da60 2a 20 61 72 65 20 66 6c 75 73 68 65 64 20 74 6f  * are flushed to
1da70 20 64 69 73 6b 2e 20 20 53 75 63 68 20 66 73 79   disk.  Such fsy
1da80 6e 63 73 20 61 72 65 20 6e 6f 74 20 6e 65 65 64  ncs are not need
1da90 65 64 20 6f 6e 20 6e 65 77 65 72 0a 2a 2a 20 6a  ed on newer.** j
1daa0 6f 75 72 6e 61 6c 69 6e 67 20 66 69 6c 65 73 79  ournaling filesy
1dab0 73 74 65 6d 73 2c 20 62 75 74 20 61 72 65 20 72  stems, but are r
1dac0 65 71 75 69 72 65 64 20 6f 6e 20 6f 6c 64 65 72  equired on older
1dad0 20 66 69 6c 65 73 79 73 74 65 6d 73 2e 0a 2a 2a   filesystems..**
1dae0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1daf0 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64   can be overridd
1db00 65 6e 20 75 73 69 6e 67 20 74 68 65 20 78 53 65  en using the xSe
1db10 74 53 79 73 43 61 6c 6c 20 69 6e 74 65 72 66 61  tSysCall interfa
1db20 63 65 2e 0a 2a 2a 20 54 68 65 20 61 62 69 6c 69  ce..** The abili
1db30 74 79 20 74 6f 20 6f 76 65 72 72 69 64 65 20 74  ty to override t
1db40 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 73 20  his routine was 
1db50 61 64 64 65 64 20 69 6e 20 73 75 70 70 6f 72 74  added in support
1db60 20 6f 66 20 74 68 65 0a 2a 2a 20 63 68 72 6f 6d   of the.** chrom
1db70 69 75 6d 20 73 61 6e 64 62 6f 78 2e 20 20 4f 70  ium sandbox.  Op
1db80 65 6e 69 6e 67 20 61 20 64 69 72 65 63 74 6f 72  ening a director
1db90 79 20 69 73 20 61 20 73 65 63 75 72 69 74 79 20  y is a security 
1dba0 72 69 73 6b 20 28 77 65 20 61 72 65 0a 2a 2a 20  risk (we are.** 
1dbb0 74 6f 6c 64 29 20 73 6f 20 6d 61 6b 69 6e 67 20  told) so making 
1dbc0 69 74 20 6f 76 65 72 72 69 64 65 61 62 6c 65 20  it overrideable 
1dbd0 61 6c 6c 6f 77 73 20 74 68 65 20 63 68 72 6f 6d  allows the chrom
1dbe0 69 75 6d 20 73 61 6e 64 62 6f 78 20 74 6f 0a 2a  ium sandbox to.*
1dbf0 2a 20 72 65 70 6c 61 63 65 20 74 68 69 73 20 72  * replace this r
1dc00 6f 75 74 69 6e 65 20 77 69 74 68 20 61 20 68 61  outine with a ha
1dc10 72 6d 6c 65 73 73 20 6e 6f 2d 6f 70 2e 20 20 54  rmless no-op.  T
1dc20 6f 20 6d 61 6b 65 20 74 68 69 73 20 72 6f 75 74  o make this rout
1dc30 69 6e 65 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 2c 20  ine.** a no-op, 
1dc40 72 65 70 6c 61 63 65 20 69 74 20 77 69 74 68 20  replace it with 
1dc50 61 20 73 74 75 62 20 74 68 61 74 20 72 65 74 75  a stub that retu
1dc60 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 20 62 75  rns SQLITE_OK bu
1dc70 74 20 6c 65 61 76 65 73 0a 2a 2a 20 2a 70 46 64  t leaves.** *pFd
1dc80 20 73 65 74 20 74 6f 20 61 20 6e 65 67 61 74 69   set to a negati
1dc90 76 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a  ve number..**.**
1dca0 20 49 66 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73   If SQLITE_OK is
1dcb0 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 20 63   returned, the c
1dcc0 61 6c 6c 65 72 20 69 73 20 72 65 73 70 6f 6e 73  aller is respons
1dcd0 69 62 6c 65 20 66 6f 72 20 63 6c 6f 73 69 6e 67  ible for closing
1dce0 0a 2a 2a 20 74 68 65 20 66 69 6c 65 20 64 65 73  .** the file des
1dcf0 63 72 69 70 74 6f 72 20 2a 70 46 64 20 75 73 69  criptor *pFd usi
1dd00 6e 67 20 63 6c 6f 73 65 28 29 2e 0a 2a 2f 0a 73  ng close()..*/.s
1dd10 74 61 74 69 63 20 69 6e 74 20 6f 70 65 6e 44 69  tatic int openDi
1dd20 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 63 68  rectory(const ch
1dd30 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 69  ar *zFilename, i
1dd40 6e 74 20 2a 70 46 64 29 7b 0a 20 20 69 6e 74 20  nt *pFd){.  int 
1dd50 69 69 3b 0a 20 20 69 6e 74 20 66 64 20 3d 20 2d  ii;.  int fd = -
1dd60 31 3b 0a 20 20 63 68 61 72 20 7a 44 69 72 6e 61  1;.  char zDirna
1dd70 6d 65 5b 4d 41 58 5f 50 41 54 48 4e 41 4d 45 2b  me[MAX_PATHNAME+
1dd80 31 5d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 73  1];..  sqlite3_s
1dd90 6e 70 72 69 6e 74 66 28 4d 41 58 5f 50 41 54 48  nprintf(MAX_PATH
1dda0 4e 41 4d 45 2c 20 7a 44 69 72 6e 61 6d 65 2c 20  NAME, zDirname, 
1ddb0 22 25 73 22 2c 20 7a 46 69 6c 65 6e 61 6d 65 29  "%s", zFilename)
1ddc0 3b 0a 20 20 66 6f 72 28 69 69 3d 28 69 6e 74 29  ;.  for(ii=(int)
1ddd0 73 74 72 6c 65 6e 28 7a 44 69 72 6e 61 6d 65 29  strlen(zDirname)
1dde0 3b 20 69 69 3e 30 20 26 26 20 7a 44 69 72 6e 61  ; ii>0 && zDirna
1ddf0 6d 65 5b 69 69 5d 21 3d 27 2f 27 3b 20 69 69 2d  me[ii]!='/'; ii-
1de00 2d 29 3b 0a 20 20 69 66 28 20 69 69 3e 30 20 29  -);.  if( ii>0 )
1de10 7b 0a 20 20 20 20 7a 44 69 72 6e 61 6d 65 5b 69  {.    zDirname[i
1de20 69 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 7d 65 6c  i] = '\0';.  }el
1de30 73 65 7b 0a 20 20 20 20 69 66 28 20 7a 44 69 72  se{.    if( zDir
1de40 6e 61 6d 65 5b 30 5d 21 3d 27 2f 27 20 29 20 7a  name[0]!='/' ) z
1de50 44 69 72 6e 61 6d 65 5b 30 5d 20 3d 20 27 2e 27  Dirname[0] = '.'
1de60 3b 0a 20 20 20 20 7a 44 69 72 6e 61 6d 65 5b 31  ;.    zDirname[1
1de70 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 66 64 20  ] = 0;.  }.  fd 
1de80 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 7a 44  = robust_open(zD
1de90 69 72 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59  irname, O_RDONLY
1dea0 7c 4f 5f 42 49 4e 41 52 59 2c 20 30 29 3b 0a 20  |O_BINARY, 0);. 
1deb0 20 69 66 28 20 66 64 3e 3d 30 20 29 7b 0a 20 20   if( fd>=0 ){.  
1dec0 20 20 4f 53 54 52 41 43 45 28 28 22 4f 50 45 4e    OSTRACE(("OPEN
1ded0 44 49 52 20 25 2d 33 64 20 25 73 5c 6e 22 2c 20  DIR %-3d %s\n", 
1dee0 66 64 2c 20 7a 44 69 72 6e 61 6d 65 29 29 3b 0a  fd, zDirname));.
1def0 20 20 7d 0a 20 20 2a 70 46 64 20 3d 20 66 64 3b    }.  *pFd = fd;
1df00 0a 20 20 69 66 28 20 66 64 3e 3d 30 20 29 20 72  .  if( fd>=0 ) r
1df10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
1df20 0a 20 20 72 65 74 75 72 6e 20 75 6e 69 78 4c 6f  .  return unixLo
1df30 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 43 41  gError(SQLITE_CA
1df40 4e 54 4f 50 45 4e 5f 42 4b 50 54 2c 20 22 6f 70  NTOPEN_BKPT, "op
1df50 65 6e 44 69 72 65 63 74 6f 72 79 22 2c 20 7a 44  enDirectory", zD
1df60 69 72 6e 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  irname);.}../*.*
1df70 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20  * Make sure all 
1df80 77 72 69 74 65 73 20 74 6f 20 61 20 70 61 72 74  writes to a part
1df90 69 63 75 6c 61 72 20 66 69 6c 65 20 61 72 65 20  icular file are 
1dfa0 63 6f 6d 6d 69 74 74 65 64 20 74 6f 20 64 69 73  committed to dis
1dfb0 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 61 74 61  k..**.** If data
1dfc0 4f 6e 6c 79 3d 3d 30 20 74 68 65 6e 20 62 6f 74  Only==0 then bot
1dfd0 68 20 74 68 65 20 66 69 6c 65 20 69 74 73 65 6c  h the file itsel
1dfe0 66 20 61 6e 64 20 69 74 73 20 6d 65 74 61 64 61  f and its metada
1dff0 74 61 20 28 66 69 6c 65 0a 2a 2a 20 73 69 7a 65  ta (file.** size
1e000 2c 20 61 63 63 65 73 73 20 74 69 6d 65 2c 20 65  , access time, e
1e010 74 63 29 20 61 72 65 20 73 79 6e 63 65 64 2e 20  tc) are synced. 
1e020 20 49 66 20 64 61 74 61 4f 6e 6c 79 21 3d 30 20   If dataOnly!=0 
1e030 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 0a 2a 2a  then only the.**
1e040 20 66 69 6c 65 20 64 61 74 61 20 69 73 20 73 79   file data is sy
1e050 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64 65  nced..**.** Unde
1e060 72 20 55 6e 69 78 2c 20 61 6c 73 6f 20 6d 61 6b  r Unix, also mak
1e070 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20  e sure that the 
1e080 64 69 72 65 63 74 6f 72 79 20 65 6e 74 72 79 20  directory entry 
1e090 66 6f 72 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20  for the file.** 
1e0a0 68 61 73 20 62 65 65 6e 20 63 72 65 61 74 65 64  has been created
1e0b0 20 62 79 20 66 73 79 6e 63 2d 69 6e 67 20 74 68   by fsync-ing th
1e0c0 65 20 64 69 72 65 63 74 6f 72 79 20 74 68 61 74  e directory that
1e0d0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66 69   contains the fi
1e0e0 6c 65 2e 0a 2a 2a 20 49 66 20 77 65 20 64 6f 20  le..** If we do 
1e0f0 6e 6f 74 20 64 6f 20 74 68 69 73 20 61 6e 64 20  not do this and 
1e100 77 65 20 65 6e 63 6f 75 6e 74 65 72 20 61 20 70  we encounter a p
1e110 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 74 68  ower failure, th
1e120 65 20 64 69 72 65 63 74 6f 72 79 0a 2a 2a 20 65  e directory.** e
1e130 6e 74 72 79 20 66 6f 72 20 74 68 65 20 6a 6f 75  ntry for the jou
1e140 72 6e 61 6c 20 6d 69 67 68 74 20 6e 6f 74 20 65  rnal might not e
1e150 78 69 73 74 20 61 66 74 65 72 20 77 65 20 72 65  xist after we re
1e160 62 6f 6f 74 2e 20 20 54 68 65 20 6e 65 78 74 0a  boot.  The next.
1e170 2a 2a 20 53 51 4c 69 74 65 20 74 6f 20 61 63 63  ** SQLite to acc
1e180 65 73 73 20 74 68 65 20 66 69 6c 65 20 77 69 6c  ess the file wil
1e190 6c 20 6e 6f 74 20 6b 6e 6f 77 20 74 68 61 74 20  l not know that 
1e1a0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73  the journal exis
1e1b0 74 73 20 28 62 65 63 61 75 73 65 0a 2a 2a 20 74  ts (because.** t
1e1c0 68 65 20 64 69 72 65 63 74 6f 72 79 20 65 6e 74  he directory ent
1e1d0 72 79 20 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e  ry for the journ
1e1e0 61 6c 20 77 61 73 20 6e 65 76 65 72 20 63 72 65  al was never cre
1e1f0 61 74 65 64 29 20 61 6e 64 20 74 68 65 20 74 72  ated) and the tr
1e200 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 77 69 6c  ansaction.** wil
1e210 6c 20 6e 6f 74 20 72 6f 6c 6c 20 62 61 63 6b 20  l not roll back 
1e220 2d 20 70 6f 73 73 69 62 6c 79 20 6c 65 61 64 69  - possibly leadi
1e230 6e 67 20 74 6f 20 64 61 74 61 62 61 73 65 20 63  ng to database c
1e240 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74  orruption..*/.st
1e250 61 74 69 63 20 69 6e 74 20 75 6e 69 78 53 79 6e  atic int unixSyn
1e260 63 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a  c(sqlite3_file *
1e270 69 64 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a  id, int flags){.
1e280 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 6e 69 78    int rc;.  unix
1e290 46 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75  File *pFile = (u
1e2a0 6e 69 78 46 69 6c 65 2a 29 69 64 3b 0a 0a 20 20  nixFile*)id;..  
1e2b0 69 6e 74 20 69 73 44 61 74 61 4f 6e 6c 79 20 3d  int isDataOnly =
1e2c0 20 28 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 53   (flags&SQLITE_S
1e2d0 59 4e 43 5f 44 41 54 41 4f 4e 4c 59 29 3b 0a 20  YNC_DATAONLY);. 
1e2e0 20 69 6e 74 20 69 73 46 75 6c 6c 73 79 6e 63 20   int isFullsync 
1e2f0 3d 20 28 66 6c 61 67 73 26 30 78 30 46 29 3d 3d  = (flags&0x0F)==
1e300 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c 4c  SQLITE_SYNC_FULL
1e310 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 68  ;..  /* Check th
1e320 61 74 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45  at one of SQLITE
1e330 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 6f 72 20  _SYNC_NORMAL or 
1e340 46 55 4c 4c 20 77 61 73 20 70 61 73 73 65 64 20  FULL was passed 
1e350 2a 2f 0a 20 20 61 73 73 65 72 74 28 28 66 6c 61  */.  assert((fla
1e360 67 73 26 30 78 30 46 29 3d 3d 53 51 4c 49 54 45  gs&0x0F)==SQLITE
1e370 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 0a 20 20 20  _SYNC_NORMAL.   
1e380 20 20 20 7c 7c 20 28 66 6c 61 67 73 26 30 78 30     || (flags&0x0
1e390 46 29 3d 3d 53 51 4c 49 54 45 5f 53 59 4e 43 5f  F)==SQLITE_SYNC_
1e3a0 46 55 4c 4c 0a 20 20 29 3b 0a 0a 20 20 2f 2a 20  FULL.  );..  /* 
1e3b0 55 6e 69 78 20 63 61 6e 6e 6f 74 2c 20 62 75 74  Unix cannot, but
1e3c0 20 73 6f 6d 65 20 73 79 73 74 65 6d 73 20 6d 61   some systems ma
1e3d0 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  y return SQLITE_
1e3e0 46 55 4c 4c 20 66 72 6f 6d 20 68 65 72 65 2e 20  FULL from here. 
1e3f0 54 68 69 73 0a 20 20 2a 2a 20 6c 69 6e 65 20 69  This.  ** line i
1e400 73 20 74 6f 20 74 65 73 74 20 74 68 61 74 20 64  s to test that d
1e410 6f 69 6e 67 20 73 6f 20 64 6f 65 73 20 6e 6f 74  oing so does not
1e420 20 63 61 75 73 65 20 61 6e 79 20 70 72 6f 62 6c   cause any probl
1e430 65 6d 73 2e 0a 20 20 2a 2f 0a 20 20 53 69 6d 75  ems..  */.  Simu
1e440 6c 61 74 65 44 69 73 6b 66 75 6c 6c 45 72 72 6f  lateDiskfullErro
1e450 72 28 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  r( return SQLITE
1e460 5f 46 55 4c 4c 20 29 3b 0a 0a 20 20 61 73 73 65  _FULL );..  asse
1e470 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20 4f  rt( pFile );.  O
1e480 53 54 52 41 43 45 28 28 22 53 59 4e 43 20 20 20  STRACE(("SYNC   
1e490 20 25 2d 33 64 5c 6e 22 2c 20 70 46 69 6c 65 2d   %-3d\n", pFile-
1e4a0 3e 68 29 29 3b 0a 20 20 72 63 20 3d 20 66 75 6c  >h));.  rc = ful
1e4b0 6c 5f 66 73 79 6e 63 28 70 46 69 6c 65 2d 3e 68  l_fsync(pFile->h
1e4c0 2c 20 69 73 46 75 6c 6c 73 79 6e 63 2c 20 69 73  , isFullsync, is
1e4d0 44 61 74 61 4f 6e 6c 79 29 3b 0a 20 20 53 69 6d  DataOnly);.  Sim
1e4e0 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 72 63  ulateIOError( rc
1e4f0 3d 31 20 29 3b 0a 20 20 69 66 28 20 72 63 20 29  =1 );.  if( rc )
1e500 7b 0a 20 20 20 20 73 74 6f 72 65 4c 61 73 74 45  {.    storeLastE
1e510 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72 6e  rrno(pFile, errn
1e520 6f 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 75  o);.    return u
1e530 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c 49  nixLogError(SQLI
1e540 54 45 5f 49 4f 45 52 52 5f 46 53 59 4e 43 2c 20  TE_IOERR_FSYNC, 
1e550 22 66 75 6c 6c 5f 66 73 79 6e 63 22 2c 20 70 46  "full_fsync", pF
1e560 69 6c 65 2d 3e 7a 50 61 74 68 29 3b 0a 20 20 7d  ile->zPath);.  }
1e570 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 66 73 79 6e  ..  /* Also fsyn
1e580 63 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20  c the directory 
1e590 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 66  containing the f
1e5a0 69 6c 65 20 69 66 20 74 68 65 20 44 49 52 53 59  ile if the DIRSY
1e5b0 4e 43 20 66 6c 61 67 0a 20 20 2a 2a 20 69 73 20  NC flag.  ** is 
1e5c0 73 65 74 2e 20 20 54 68 69 73 20 69 73 20 61 20  set.  This is a 
1e5d0 6f 6e 65 2d 74 69 6d 65 20 6f 63 63 75 72 72 65  one-time occurre
1e5e0 6e 63 65 2e 20 20 4d 61 6e 79 20 73 79 73 74 65  nce.  Many syste
1e5f0 6d 73 20 28 65 78 61 6d 70 6c 65 73 3a 20 41 49  ms (examples: AI
1e600 58 29 0a 20 20 2a 2a 20 61 72 65 20 75 6e 61 62  X).  ** are unab
1e610 6c 65 20 74 6f 20 66 73 79 6e 63 20 61 20 64 69  le to fsync a di
1e620 72 65 63 74 6f 72 79 2c 20 73 6f 20 69 67 6e 6f  rectory, so igno
1e630 72 65 20 65 72 72 6f 72 73 20 6f 6e 20 74 68 65  re errors on the
1e640 20 66 73 79 6e 63 2e 0a 20 20 2a 2f 0a 20 20 69   fsync..  */.  i
1e650 66 28 20 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c  f( pFile->ctrlFl
1e660 61 67 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 44  ags & UNIXFILE_D
1e670 49 52 53 59 4e 43 20 29 7b 0a 20 20 20 20 69 6e  IRSYNC ){.    in
1e680 74 20 64 69 72 66 64 3b 0a 20 20 20 20 4f 53 54  t dirfd;.    OST
1e690 52 41 43 45 28 28 22 44 49 52 53 59 4e 43 20 25  RACE(("DIRSYNC %
1e6a0 73 20 28 68 61 76 65 5f 66 75 6c 6c 66 73 79 6e  s (have_fullfsyn
1e6b0 63 3d 25 64 20 66 75 6c 6c 73 79 6e 63 3d 25 64  c=%d fullsync=%d
1e6c0 29 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61  )\n", pFile->zPa
1e6d0 74 68 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  th,.            
1e6e0 48 41 56 45 5f 46 55 4c 4c 46 53 59 4e 43 2c 20  HAVE_FULLFSYNC, 
1e6f0 69 73 46 75 6c 6c 73 79 6e 63 29 29 3b 0a 20 20  isFullsync));.  
1e700 20 20 72 63 20 3d 20 6f 73 4f 70 65 6e 44 69 72    rc = osOpenDir
1e710 65 63 74 6f 72 79 28 70 46 69 6c 65 2d 3e 7a 50  ectory(pFile->zP
1e720 61 74 68 2c 20 26 64 69 72 66 64 29 3b 0a 20 20  ath, &dirfd);.  
1e730 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
1e740 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 66 75 6c  _OK ){.      ful
1e750 6c 5f 66 73 79 6e 63 28 64 69 72 66 64 2c 20 30  l_fsync(dirfd, 0
1e760 2c 20 30 29 3b 0a 20 20 20 20 20 20 72 6f 62 75  , 0);.      robu
1e770 73 74 5f 63 6c 6f 73 65 28 70 46 69 6c 65 2c 20  st_close(pFile, 
1e780 64 69 72 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29  dirfd, __LINE__)
1e790 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
1e7a0 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53     assert( rc==S
1e7b0 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 29  QLITE_CANTOPEN )
1e7c0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c  ;.      rc = SQL
1e7d0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20  ITE_OK;.    }.  
1e7e0 20 20 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61    pFile->ctrlFla
1e7f0 67 73 20 26 3d 20 7e 55 4e 49 58 46 49 4c 45 5f  gs &= ~UNIXFILE_
1e800 44 49 52 53 59 4e 43 3b 0a 20 20 7d 0a 20 20 72  DIRSYNC;.  }.  r
1e810 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
1e820 2a 2a 20 54 72 75 6e 63 61 74 65 20 61 6e 20 6f  ** Truncate an o
1e830 70 65 6e 20 66 69 6c 65 20 74 6f 20 61 20 73 70  pen file to a sp
1e840 65 63 69 66 69 65 64 20 73 69 7a 65 0a 2a 2f 0a  ecified size.*/.
1e850 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 54  static int unixT
1e860 72 75 6e 63 61 74 65 28 73 71 6c 69 74 65 33 5f  runcate(sqlite3_
1e870 66 69 6c 65 20 2a 69 64 2c 20 69 36 34 20 6e 42  file *id, i64 nB
1e880 79 74 65 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65  yte){.  unixFile
1e890 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46   *pFile = (unixF
1e8a0 69 6c 65 20 2a 29 69 64 3b 0a 20 20 69 6e 74 20  ile *)id;.  int 
1e8b0 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 70 46  rc;.  assert( pF
1e8c0 69 6c 65 20 29 3b 0a 20 20 53 69 6d 75 6c 61 74  ile );.  Simulat
1e8d0 65 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e  eIOError( return
1e8e0 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 54 52   SQLITE_IOERR_TR
1e8f0 55 4e 43 41 54 45 20 29 3b 0a 0a 20 20 2f 2a 20  UNCATE );..  /* 
1e900 49 66 20 74 68 65 20 75 73 65 72 20 68 61 73 20  If the user has 
1e910 63 6f 6e 66 69 67 75 72 65 64 20 61 20 63 68 75  configured a chu
1e920 6e 6b 2d 73 69 7a 65 20 66 6f 72 20 74 68 69 73  nk-size for this
1e930 20 66 69 6c 65 2c 20 74 72 75 6e 63 61 74 65 20   file, truncate 
1e940 74 68 65 0a 20 20 2a 2a 20 66 69 6c 65 20 73 6f  the.  ** file so
1e950 20 74 68 61 74 20 69 74 20 63 6f 6e 73 69 73 74   that it consist
1e960 73 20 6f 66 20 61 6e 20 69 6e 74 65 67 65 72 20  s of an integer 
1e970 6e 75 6d 62 65 72 20 6f 66 20 63 68 75 6e 6b 73  number of chunks
1e980 20 28 69 2e 65 2e 20 74 68 65 0a 20 20 2a 2a 20   (i.e. the.  ** 
1e990 61 63 74 75 61 6c 20 66 69 6c 65 20 73 69 7a 65  actual file size
1e9a0 20 61 66 74 65 72 20 74 68 65 20 6f 70 65 72 61   after the opera
1e9b0 74 69 6f 6e 20 6d 61 79 20 62 65 20 6c 61 72 67  tion may be larg
1e9c0 65 72 20 74 68 61 6e 20 74 68 65 20 72 65 71 75  er than the requ
1e9d0 65 73 74 65 64 0a 20 20 2a 2a 20 73 69 7a 65 29  ested.  ** size)
1e9e0 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 46 69  ..  */.  if( pFi
1e9f0 6c 65 2d 3e 73 7a 43 68 75 6e 6b 3e 30 20 29 7b  le->szChunk>0 ){
1ea00 0a 20 20 20 20 6e 42 79 74 65 20 3d 20 28 28 6e  .    nByte = ((n
1ea10 42 79 74 65 20 2b 20 70 46 69 6c 65 2d 3e 73 7a  Byte + pFile->sz
1ea20 43 68 75 6e 6b 20 2d 20 31 29 2f 70 46 69 6c 65  Chunk - 1)/pFile
1ea30 2d 3e 73 7a 43 68 75 6e 6b 29 20 2a 20 70 46 69  ->szChunk) * pFi
1ea40 6c 65 2d 3e 73 7a 43 68 75 6e 6b 3b 0a 20 20 7d  le->szChunk;.  }
1ea50 0a 0a 20 20 72 63 20 3d 20 72 6f 62 75 73 74 5f  ..  rc = robust_
1ea60 66 74 72 75 6e 63 61 74 65 28 70 46 69 6c 65 2d  ftruncate(pFile-
1ea70 3e 68 2c 20 6e 42 79 74 65 29 3b 0a 20 20 69 66  >h, nByte);.  if
1ea80 28 20 72 63 20 29 7b 0a 20 20 20 20 73 74 6f 72  ( rc ){.    stor
1ea90 65 4c 61 73 74 45 72 72 6e 6f 28 70 46 69 6c 65  eLastErrno(pFile
1eaa0 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 72 65  , errno);.    re
1eab0 74 75 72 6e 20 75 6e 69 78 4c 6f 67 45 72 72 6f  turn unixLogErro
1eac0 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 54  r(SQLITE_IOERR_T
1ead0 52 55 4e 43 41 54 45 2c 20 22 66 74 72 75 6e 63  RUNCATE, "ftrunc
1eae0 61 74 65 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61  ate", pFile->zPa
1eaf0 74 68 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 23 69  th);.  }else{.#i
1eb00 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55  fdef SQLITE_DEBU
1eb10 47 0a 20 20 20 20 2f 2a 20 49 66 20 77 65 20 61  G.    /* If we a
1eb20 72 65 20 64 6f 69 6e 67 20 61 20 6e 6f 72 6d 61  re doing a norma
1eb30 6c 20 77 72 69 74 65 20 74 6f 20 61 20 64 61 74  l write to a dat
1eb40 61 62 61 73 65 20 66 69 6c 65 20 28 61 73 20 6f  abase file (as o
1eb50 70 70 6f 73 65 64 20 74 6f 0a 20 20 20 20 2a 2a  pposed to.    **
1eb60 20 64 6f 69 6e 67 20 61 20 68 6f 74 2d 6a 6f 75   doing a hot-jou
1eb70 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 6f 72  rnal rollback or
1eb80 20 61 20 77 72 69 74 65 20 74 6f 20 73 6f 6d 65   a write to some
1eb90 20 66 69 6c 65 20 6f 74 68 65 72 20 74 68 61 6e   file other than
1eba0 20 61 0a 20 20 20 20 2a 2a 20 6e 6f 72 6d 61 6c   a.    ** normal
1ebb0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 29 20   database file) 
1ebc0 61 6e 64 20 77 65 20 74 72 75 6e 63 61 74 65 20  and we truncate 
1ebd0 74 68 65 20 66 69 6c 65 20 74 6f 20 7a 65 72 6f  the file to zero
1ebe0 20 6c 65 6e 67 74 68 2c 0a 20 20 20 20 2a 2a 20   length,.    ** 
1ebf0 74 68 61 74 20 65 66 66 65 63 74 69 76 65 6c 79  that effectively
1ec00 20 75 70 64 61 74 65 73 20 74 68 65 20 63 68 61   updates the cha
1ec10 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20 20 54 68  nge counter.  Th
1ec20 69 73 20 6d 69 67 68 74 20 68 61 70 70 65 6e 0a  is might happen.
1ec30 20 20 20 20 2a 2a 20 77 68 65 6e 20 72 65 73 74      ** when rest
1ec40 6f 72 69 6e 67 20 61 20 64 61 74 61 62 61 73 65  oring a database
1ec50 20 75 73 69 6e 67 20 74 68 65 20 62 61 63 6b 75   using the backu
1ec60 70 20 41 50 49 20 66 72 6f 6d 20 61 20 7a 65 72  p API from a zer
1ec70 6f 2d 6c 65 6e 67 74 68 0a 20 20 20 20 2a 2a 20  o-length.    ** 
1ec80 73 6f 75 72 63 65 2e 0a 20 20 20 20 2a 2f 0a 20  source..    */. 
1ec90 20 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 69 6e     if( pFile->in
1eca0 4e 6f 72 6d 61 6c 57 72 69 74 65 20 26 26 20 6e  NormalWrite && n
1ecb0 42 79 74 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20  Byte==0 ){.     
1ecc0 20 70 46 69 6c 65 2d 3e 74 72 61 6e 73 43 6e 74   pFile->transCnt
1ecd0 72 43 68 6e 67 20 3d 20 31 3b 0a 20 20 20 20 7d  rChng = 1;.    }
1ece0 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 51 4c  .#endif..#if SQL
1ecf0 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a  ITE_MAX_MMAP_SIZ
1ed00 45 3e 30 0a 20 20 20 20 2f 2a 20 49 66 20 74 68  E>0.    /* If th
1ed10 65 20 66 69 6c 65 20 77 61 73 20 6a 75 73 74 20  e file was just 
1ed20 74 72 75 6e 63 61 74 65 64 20 74 6f 20 61 20 73  truncated to a s
1ed30 69 7a 65 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e  ize smaller than
1ed40 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 0a 20   the currently. 
1ed50 20 20 20 2a 2a 20 6d 61 70 70 65 64 20 72 65 67     ** mapped reg
1ed60 69 6f 6e 2c 20 72 65 64 75 63 65 20 74 68 65 20  ion, reduce the 
1ed70 65 66 66 65 63 74 69 76 65 20 6d 61 70 70 69 6e  effective mappin
1ed80 67 20 73 69 7a 65 20 61 73 20 77 65 6c 6c 2e 20  g size as well. 
1ed90 53 51 4c 69 74 65 20 77 69 6c 6c 0a 20 20 20 20  SQLite will.    
1eda0 2a 2a 20 75 73 65 20 72 65 61 64 28 29 20 61 6e  ** use read() an
1edb0 64 20 77 72 69 74 65 28 29 20 74 6f 20 61 63 63  d write() to acc
1edc0 65 73 73 20 64 61 74 61 20 62 65 79 6f 6e 64 20  ess data beyond 
1edd0 74 68 69 73 20 70 6f 69 6e 74 20 66 72 6f 6d 20  this point from 
1ede0 6e 6f 77 20 6f 6e 2e 20 20 0a 20 20 20 20 2a 2f  now on.  .    */
1edf0 0a 20 20 20 20 69 66 28 20 6e 42 79 74 65 3c 70  .    if( nByte<p
1ee00 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 20 29  File->mmapSize )
1ee10 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6d  {.      pFile->m
1ee20 6d 61 70 53 69 7a 65 20 3d 20 6e 42 79 74 65 3b  mapSize = nByte;
1ee30 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20  .    }.#endif.. 
1ee40 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1ee50 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  _OK;.  }.}../*.*
1ee60 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68 65 20  * Determine the 
1ee70 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 20  current size of 
1ee80 61 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 0a  a file in bytes.
1ee90 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e  */.static int un
1eea0 69 78 46 69 6c 65 53 69 7a 65 28 73 71 6c 69 74  ixFileSize(sqlit
1eeb0 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 36 34  e3_file *id, i64
1eec0 20 2a 70 53 69 7a 65 29 7b 0a 20 20 69 6e 74 20   *pSize){.  int 
1eed0 72 63 3b 0a 20 20 73 74 72 75 63 74 20 73 74 61  rc;.  struct sta
1eee0 74 20 62 75 66 3b 0a 20 20 61 73 73 65 72 74 28  t buf;.  assert(
1eef0 20 69 64 20 29 3b 0a 20 20 72 63 20 3d 20 6f 73   id );.  rc = os
1ef00 46 73 74 61 74 28 28 28 75 6e 69 78 46 69 6c 65  Fstat(((unixFile
1ef10 2a 29 69 64 29 2d 3e 68 2c 20 26 62 75 66 29 3b  *)id)->h, &buf);
1ef20 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72  .  SimulateIOErr
1ef30 6f 72 28 20 72 63 3d 31 20 29 3b 0a 20 20 69 66  or( rc=1 );.  if
1ef40 28 20 72 63 21 3d 30 20 29 7b 0a 20 20 20 20 73  ( rc!=0 ){.    s
1ef50 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28 28 75  toreLastErrno((u
1ef60 6e 69 78 46 69 6c 65 2a 29 69 64 2c 20 65 72 72  nixFile*)id, err
1ef70 6e 6f 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  no);.    return 
1ef80 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54  SQLITE_IOERR_FST
1ef90 41 54 3b 0a 20 20 7d 0a 20 20 2a 70 53 69 7a 65  AT;.  }.  *pSize
1efa0 20 3d 20 62 75 66 2e 73 74 5f 73 69 7a 65 3b 0a   = buf.st_size;.
1efb0 0a 20 20 2f 2a 20 57 68 65 6e 20 6f 70 65 6e 69  .  /* When openi
1efc0 6e 67 20 61 20 7a 65 72 6f 2d 73 69 7a 65 20 64  ng a zero-size d
1efd0 61 74 61 62 61 73 65 2c 20 74 68 65 20 66 69 6e  atabase, the fin
1efe0 64 49 6e 6f 64 65 49 6e 66 6f 28 29 20 70 72 6f  dInodeInfo() pro
1eff0 63 65 64 75 72 65 0a 20 20 2a 2a 20 77 72 69 74  cedure.  ** writ
1f000 65 73 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65  es a single byte
1f010 20 69 6e 74 6f 20 74 68 61 74 20 66 69 6c 65 20   into that file 
1f020 69 6e 20 6f 72 64 65 72 20 74 6f 20 77 6f 72 6b  in order to work
1f030 20 61 72 6f 75 6e 64 20 61 20 62 75 67 0a 20 20   around a bug.  
1f040 2a 2a 20 69 6e 20 74 68 65 20 4f 53 2d 58 20 6d  ** in the OS-X m
1f050 73 64 6f 73 20 66 69 6c 65 73 79 73 74 65 6d 2e  sdos filesystem.
1f060 20 20 49 6e 20 6f 72 64 65 72 20 74 6f 20 61 76    In order to av
1f070 6f 69 64 20 70 72 6f 62 6c 65 6d 73 20 77 69 74  oid problems wit
1f080 68 20 75 70 70 65 72 0a 20 20 2a 2a 20 6c 61 79  h upper.  ** lay
1f090 65 72 73 2c 20 77 65 20 6e 65 65 64 20 74 6f 20  ers, we need to 
1f0a0 72 65 70 6f 72 74 20 74 68 69 73 20 66 69 6c 65  report this file
1f0b0 20 73 69 7a 65 20 61 73 20 7a 65 72 6f 20 65 76   size as zero ev
1f0c0 65 6e 20 74 68 6f 75 67 68 20 69 74 20 69 73 0a  en though it is.
1f0d0 20 20 2a 2a 20 72 65 61 6c 6c 79 20 31 2e 20 20    ** really 1.  
1f0e0 20 54 69 63 6b 65 74 20 23 33 32 36 30 2e 0a 20   Ticket #3260.. 
1f0f0 20 2a 2f 0a 20 20 69 66 28 20 2a 70 53 69 7a 65   */.  if( *pSize
1f100 3d 3d 31 20 29 20 2a 70 53 69 7a 65 20 3d 20 30  ==1 ) *pSize = 0
1f110 3b 0a 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  ;...  return SQL
1f120 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 53  ITE_OK;.}..#if S
1f130 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43  QLITE_ENABLE_LOC
1f140 4b 49 4e 47 5f 53 54 59 4c 45 20 26 26 20 64 65  KING_STYLE && de
1f150 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29  fined(__APPLE__)
1f160 0a 2f 2a 0a 2a 2a 20 48 61 6e 64 6c 65 72 20 66  ./*.** Handler f
1f170 6f 72 20 70 72 6f 78 79 2d 6c 6f 63 6b 69 6e 67  or proxy-locking
1f180 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 76 65   file-control ve
1f190 72 62 73 2e 20 20 44 65 66 69 6e 65 64 20 62 65  rbs.  Defined be
1f1a0 6c 6f 77 20 69 6e 20 74 68 65 0a 2a 2a 20 70 72  low in the.** pr
1f1b0 6f 78 79 69 6e 67 20 6c 6f 63 6b 69 6e 67 20 64  oxying locking d
1f1c0 69 76 69 73 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74  ivision..*/.stat
1f1d0 69 63 20 69 6e 74 20 70 72 6f 78 79 46 69 6c 65  ic int proxyFile
1f1e0 43 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f  Control(sqlite3_
1f1f0 66 69 6c 65 2a 2c 69 6e 74 2c 76 6f 69 64 2a 29  file*,int,void*)
1f200 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 0a 2a 2a  ;.#endif../* .**
1f210 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
1f220 73 20 63 61 6c 6c 65 64 20 74 6f 20 68 61 6e 64  s called to hand
1f230 6c 65 20 74 68 65 20 53 51 4c 49 54 45 5f 46 43  le the SQLITE_FC
1f240 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e 54 20 0a 2a  NTL_SIZE_HINT .*
1f250 2a 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 6f  * file-control o
1f260 70 65 72 61 74 69 6f 6e 2e 20 20 45 6e 6c 61 72  peration.  Enlar
1f270 67 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ge the database 
1f280 74 6f 20 6e 42 79 74 65 73 20 69 6e 20 73 69 7a  to nBytes in siz
1f290 65 0a 2a 2a 20 28 72 6f 75 6e 64 65 64 20 75 70  e.** (rounded up
1f2a0 20 74 6f 20 74 68 65 20 6e 65 78 74 20 63 68 75   to the next chu
1f2b0 6e 6b 2d 73 69 7a 65 29 2e 20 20 49 66 20 74 68  nk-size).  If th
1f2c0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 6c  e database is al
1f2d0 72 65 61 64 79 0a 2a 2a 20 6e 42 79 74 65 73 20  ready.** nBytes 
1f2e0 6f 72 20 6c 61 72 67 65 72 2c 20 74 68 69 73 20  or larger, this 
1f2f0 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d  routine is a no-
1f300 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  op..*/.static in
1f310 74 20 66 63 6e 74 6c 53 69 7a 65 48 69 6e 74 28  t fcntlSizeHint(
1f320 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 2c  unixFile *pFile,
1f330 20 69 36 34 20 6e 42 79 74 65 29 7b 0a 20 20 69   i64 nByte){.  i
1f340 66 28 20 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e  f( pFile->szChun
1f350 6b 3e 30 20 29 7b 0a 20 20 20 20 69 36 34 20 6e  k>0 ){.    i64 n
1f360 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20  Size;           
1f370 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 71 75           /* Requ
1f380 69 72 65 64 20 66 69 6c 65 20 73 69 7a 65 20 2a  ired file size *
1f390 2f 0a 20 20 20 20 73 74 72 75 63 74 20 73 74 61  /.    struct sta
1f3a0 74 20 62 75 66 3b 20 20 20 20 20 20 20 20 20 20  t buf;          
1f3b0 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 68      /* Used to h
1f3c0 6f 6c 64 20 72 65 74 75 72 6e 20 76 61 6c 75 65  old return value
1f3d0 73 20 6f 66 20 66 73 74 61 74 28 29 20 2a 2f 0a  s of fstat() */.
1f3e0 20 20 20 0a 20 20 20 20 69 66 28 20 6f 73 46 73     .    if( osFs
1f3f0 74 61 74 28 70 46 69 6c 65 2d 3e 68 2c 20 26 62  tat(pFile->h, &b
1f400 75 66 29 20 29 7b 0a 20 20 20 20 20 20 72 65 74  uf) ){.      ret
1f410 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  urn SQLITE_IOERR
1f420 5f 46 53 54 41 54 3b 0a 20 20 20 20 7d 0a 0a 20  _FSTAT;.    }.. 
1f430 20 20 20 6e 53 69 7a 65 20 3d 20 28 28 6e 42 79     nSize = ((nBy
1f440 74 65 2b 70 46 69 6c 65 2d 3e 73 7a 43 68 75 6e  te+pFile->szChun
1f450 6b 2d 31 29 20 2f 20 70 46 69 6c 65 2d 3e 73 7a  k-1) / pFile->sz
1f460 43 68 75 6e 6b 29 20 2a 20 70 46 69 6c 65 2d 3e  Chunk) * pFile->
1f470 73 7a 43 68 75 6e 6b 3b 0a 20 20 20 20 69 66 28  szChunk;.    if(
1f480 20 6e 53 69 7a 65 3e 28 69 36 34 29 62 75 66 2e   nSize>(i64)buf.
1f490 73 74 5f 73 69 7a 65 20 29 7b 0a 0a 23 69 66 20  st_size ){..#if 
1f4a0 64 65 66 69 6e 65 64 28 48 41 56 45 5f 50 4f 53  defined(HAVE_POS
1f4b0 49 58 5f 46 41 4c 4c 4f 43 41 54 45 29 20 26 26  IX_FALLOCATE) &&
1f4c0 20 48 41 56 45 5f 50 4f 53 49 58 5f 46 41 4c 4c   HAVE_POSIX_FALL
1f4d0 4f 43 41 54 45 0a 20 20 20 20 20 20 2f 2a 20 54  OCATE.      /* T
1f4e0 68 65 20 63 6f 64 65 20 62 65 6c 6f 77 20 69 73  he code below is
1f4f0 20 68 61 6e 64 6c 69 6e 67 20 74 68 65 20 72 65   handling the re
1f500 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 6f 73  turn value of os
1f510 46 61 6c 6c 6f 63 61 74 65 28 29 20 0a 20 20 20  Fallocate() .   
1f520 20 20 20 2a 2a 20 63 6f 72 72 65 63 74 6c 79 2e     ** correctly.
1f530 20 70 6f 73 69 78 5f 66 61 6c 6c 6f 63 61 74 65   posix_fallocate
1f540 28 29 20 69 73 20 64 65 66 69 6e 65 64 20 74 6f  () is defined to
1f550 20 22 72 65 74 75 72 6e 73 20 7a 65 72 6f 20 6f   "returns zero o
1f560 6e 20 73 75 63 63 65 73 73 2c 20 0a 20 20 20 20  n success, .    
1f570 20 20 2a 2a 20 6f 72 20 61 6e 20 65 72 72 6f 72    ** or an error
1f580 20 6e 75 6d 62 65 72 20 6f 6e 20 20 66 61 69 6c   number on  fail
1f590 75 72 65 22 2e 20 53 65 65 20 74 68 65 20 6d 61  ure". See the ma
1f5a0 6e 70 61 67 65 20 66 6f 72 20 64 65 74 61 69 6c  npage for detail
1f5b0 73 2e 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20  s. */.      int 
1f5c0 65 72 72 3b 0a 20 20 20 20 20 20 64 6f 7b 0a 20  err;.      do{. 
1f5d0 20 20 20 20 20 20 20 65 72 72 20 3d 20 6f 73 46         err = osF
1f5e0 61 6c 6c 6f 63 61 74 65 28 70 46 69 6c 65 2d 3e  allocate(pFile->
1f5f0 68 2c 20 62 75 66 2e 73 74 5f 73 69 7a 65 2c 20  h, buf.st_size, 
1f600 6e 53 69 7a 65 2d 62 75 66 2e 73 74 5f 73 69 7a  nSize-buf.st_siz
1f610 65 29 3b 0a 20 20 20 20 20 20 7d 77 68 69 6c 65  e);.      }while
1f620 28 20 65 72 72 3d 3d 45 49 4e 54 52 20 29 3b 0a  ( err==EINTR );.
1f630 20 20 20 20 20 20 69 66 28 20 65 72 72 20 26 26        if( err &&
1f640 20 65 72 72 21 3d 45 49 4e 56 41 4c 20 29 20 72   err!=EINVAL ) r
1f650 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45  eturn SQLITE_IOE
1f660 52 52 5f 57 52 49 54 45 3b 0a 23 65 6c 73 65 0a  RR_WRITE;.#else.
1f670 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20        /* If the 
1f680 4f 53 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65  OS does not have
1f690 20 70 6f 73 69 78 5f 66 61 6c 6c 6f 63 61 74 65   posix_fallocate
1f6a0 28 29 2c 20 66 61 6b 65 20 69 74 2e 20 57 72 69  (), fake it. Wri
1f6b0 74 65 20 61 20 0a 20 20 20 20 20 20 2a 2a 20 73  te a .      ** s
1f6c0 69 6e 67 6c 65 20 62 79 74 65 20 74 6f 20 74 68  ingle byte to th
1f6d0 65 20 6c 61 73 74 20 62 79 74 65 20 69 6e 20 65  e last byte in e
1f6e0 61 63 68 20 62 6c 6f 63 6b 20 74 68 61 74 20 66  ach block that f
1f6f0 61 6c 6c 73 20 65 6e 74 69 72 65 6c 79 0a 20 20  alls entirely.  
1f700 20 20 20 20 2a 2a 20 77 69 74 68 69 6e 20 74 68      ** within th
1f710 65 20 65 78 74 65 6e 64 65 64 20 72 65 67 69 6f  e extended regio
1f720 6e 2e 20 54 68 65 6e 2c 20 69 66 20 72 65 71 75  n. Then, if requ
1f730 69 72 65 64 2c 20 61 20 73 69 6e 67 6c 65 20 62  ired, a single b
1f740 79 74 65 0a 20 20 20 20 20 20 2a 2a 20 61 74 20  yte.      ** at 
1f750 6f 66 66 73 65 74 20 28 6e 53 69 7a 65 2d 31 29  offset (nSize-1)
1f760 2c 20 74 6f 20 73 65 74 20 74 68 65 20 73 69 7a  , to set the siz
1f770 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f  e of the file co
1f780 72 72 65 63 74 6c 79 2e 0a 20 20 20 20 20 20 2a  rrectly..      *
1f790 2a 20 54 68 69 73 20 69 73 20 61 20 73 69 6d 69  * This is a simi
1f7a0 6c 61 72 20 74 65 63 68 6e 69 71 75 65 20 74 6f  lar technique to
1f7b0 20 74 68 61 74 20 75 73 65 64 20 62 79 20 67 6c   that used by gl
1f7c0 69 62 63 20 6f 6e 20 73 79 73 74 65 6d 73 0a 20  ibc on systems. 
1f7d0 20 20 20 20 20 2a 2a 20 74 68 61 74 20 64 6f 20       ** that do 
1f7e0 6e 6f 74 20 68 61 76 65 20 61 20 72 65 61 6c 20  not have a real 
1f7f0 66 61 6c 6c 6f 63 61 74 65 28 29 20 63 61 6c 6c  fallocate() call
1f800 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20  ..      */.     
1f810 20 69 6e 74 20 6e 42 6c 6b 20 3d 20 62 75 66 2e   int nBlk = buf.
1f820 73 74 5f 62 6c 6b 73 69 7a 65 3b 20 20 2f 2a 20  st_blksize;  /* 
1f830 46 69 6c 65 2d 73 79 73 74 65 6d 20 62 6c 6f 63  File-system bloc
1f840 6b 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20  k size */.      
1f850 69 6e 74 20 6e 57 72 69 74 65 20 3d 20 30 3b 20  int nWrite = 0; 
1f860 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
1f870 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77  umber of bytes w
1f880 72 69 74 74 65 6e 20 62 79 20 73 65 65 6b 41 6e  ritten by seekAn
1f890 64 57 72 69 74 65 20 2a 2f 0a 20 20 20 20 20 20  dWrite */.      
1f8a0 69 36 34 20 69 57 72 69 74 65 3b 20 20 20 20 20  i64 iWrite;     
1f8b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
1f8c0 65 78 74 20 6f 66 66 73 65 74 20 74 6f 20 77 72  ext offset to wr
1f8d0 69 74 65 20 74 6f 20 2a 2f 0a 0a 20 20 20 20 20  ite to */..     
1f8e0 20 69 57 72 69 74 65 20 3d 20 28 62 75 66 2e 73   iWrite = (buf.s
1f8f0 74 5f 73 69 7a 65 2f 6e 42 6c 6b 29 2a 6e 42 6c  t_size/nBlk)*nBl
1f900 6b 20 2b 20 6e 42 6c 6b 20 2d 20 31 3b 0a 20 20  k + nBlk - 1;.  
1f910 20 20 20 20 61 73 73 65 72 74 28 20 69 57 72 69      assert( iWri
1f920 74 65 3e 3d 62 75 66 2e 73 74 5f 73 69 7a 65 20  te>=buf.st_size 
1f930 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
1f940 20 28 28 69 57 72 69 74 65 2b 31 29 25 6e 42 6c   ((iWrite+1)%nBl
1f950 6b 29 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 66  k)==0 );.      f
1f960 6f 72 28 2f 2a 6e 6f 2d 6f 70 2a 2f 3b 20 69 57  or(/*no-op*/; iW
1f970 72 69 74 65 3c 6e 53 69 7a 65 2b 6e 42 6c 6b 2d  rite<nSize+nBlk-
1f980 31 3b 20 69 57 72 69 74 65 2b 3d 6e 42 6c 6b 20  1; iWrite+=nBlk 
1f990 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69  ){.        if( i
1f9a0 57 72 69 74 65 3e 3d 6e 53 69 7a 65 20 29 20 69  Write>=nSize ) i
1f9b0 57 72 69 74 65 20 3d 20 6e 53 69 7a 65 20 2d 20  Write = nSize - 
1f9c0 31 3b 0a 20 20 20 20 20 20 20 20 6e 57 72 69 74  1;.        nWrit
1f9d0 65 20 3d 20 73 65 65 6b 41 6e 64 57 72 69 74 65  e = seekAndWrite
1f9e0 28 70 46 69 6c 65 2c 20 69 57 72 69 74 65 2c 20  (pFile, iWrite, 
1f9f0 22 22 2c 20 31 29 3b 0a 20 20 20 20 20 20 20 20  "", 1);.        
1fa00 69 66 28 20 6e 57 72 69 74 65 21 3d 31 20 29 20  if( nWrite!=1 ) 
1fa10 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f  return SQLITE_IO
1fa20 45 52 52 5f 57 52 49 54 45 3b 0a 20 20 20 20 20  ERR_WRITE;.     
1fa30 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a   }.#endif.    }.
1fa40 20 20 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f    }..#if SQLITE_
1fa50 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a  MAX_MMAP_SIZE>0.
1fa60 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 6d 6d 61    if( pFile->mma
1fa70 70 53 69 7a 65 4d 61 78 3e 30 20 26 26 20 6e 42  pSizeMax>0 && nB
1fa80 79 74 65 3e 70 46 69 6c 65 2d 3e 6d 6d 61 70 53  yte>pFile->mmapS
1fa90 69 7a 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  ize ){.    int r
1faa0 63 3b 0a 20 20 20 20 69 66 28 20 70 46 69 6c 65  c;.    if( pFile
1fab0 2d 3e 73 7a 43 68 75 6e 6b 3c 3d 30 20 29 7b 0a  ->szChunk<=0 ){.
1fac0 20 20 20 20 20 20 69 66 28 20 72 6f 62 75 73 74        if( robust
1fad0 5f 66 74 72 75 6e 63 61 74 65 28 70 46 69 6c 65  _ftruncate(pFile
1fae0 2d 3e 68 2c 20 6e 42 79 74 65 29 20 29 7b 0a 20  ->h, nByte) ){. 
1faf0 20 20 20 20 20 20 20 73 74 6f 72 65 4c 61 73 74         storeLast
1fb00 45 72 72 6e 6f 28 70 46 69 6c 65 2c 20 65 72 72  Errno(pFile, err
1fb10 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74  no);.        ret
1fb20 75 72 6e 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72  urn unixLogError
1fb30 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 54 52  (SQLITE_IOERR_TR
1fb40 55 4e 43 41 54 45 2c 20 22 66 74 72 75 6e 63 61  UNCATE, "ftrunca
1fb50 74 65 22 2c 20 70 46 69 6c 65 2d 3e 7a 50 61 74  te", pFile->zPat
1fb60 68 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  h);.      }.    
1fb70 7d 0a 0a 20 20 20 20 72 63 20 3d 20 75 6e 69 78  }..    rc = unix
1fb80 4d 61 70 66 69 6c 65 28 70 46 69 6c 65 2c 20 6e  Mapfile(pFile, n
1fb90 42 79 74 65 29 3b 0a 20 20 20 20 72 65 74 75 72  Byte);.    retur
1fba0 6e 20 72 63 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  n rc;.  }.#endif
1fbb0 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ..  return SQLIT
1fbc0 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  E_OK;.}../*.** I
1fbd0 66 20 2a 70 41 72 67 20 69 73 20 69 6e 69 74 69  f *pArg is initi
1fbe0 61 6c 6c 79 20 6e 65 67 61 74 69 76 65 20 74 68  ally negative th
1fbf0 65 6e 20 74 68 69 73 20 69 73 20 61 20 71 75 65  en this is a que
1fc00 72 79 2e 20 20 53 65 74 20 2a 70 41 72 67 20 74  ry.  Set *pArg t
1fc10 6f 0a 2a 2a 20 31 20 6f 72 20 30 20 64 65 70 65  o.** 1 or 0 depe
1fc20 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72  nding on whether
1fc30 20 6f 72 20 6e 6f 74 20 62 69 74 20 6d 61 73 6b   or not bit mask
1fc40 20 6f 66 20 70 46 69 6c 65 2d 3e 63 74 72 6c 46   of pFile->ctrlF
1fc50 6c 61 67 73 20 69 73 20 73 65 74 2e 0a 2a 2a 0a  lags is set..**.
1fc60 2a 2a 20 49 66 20 2a 70 41 72 67 20 69 73 20 30  ** If *pArg is 0
1fc70 20 6f 72 20 31 2c 20 74 68 65 6e 20 63 6c 65 61   or 1, then clea
1fc80 72 20 6f 72 20 73 65 74 20 74 68 65 20 6d 61 73  r or set the mas
1fc90 6b 20 62 69 74 20 6f 66 20 70 46 69 6c 65 2d 3e  k bit of pFile->
1fca0 63 74 72 6c 46 6c 61 67 73 2e 0a 2a 2f 0a 73 74  ctrlFlags..*/.st
1fcb0 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78 4d 6f  atic void unixMo
1fcc0 64 65 42 69 74 28 75 6e 69 78 46 69 6c 65 20 2a  deBit(unixFile *
1fcd0 70 46 69 6c 65 2c 20 75 6e 73 69 67 6e 65 64 20  pFile, unsigned 
1fce0 63 68 61 72 20 6d 61 73 6b 2c 20 69 6e 74 20 2a  char mask, int *
1fcf0 70 41 72 67 29 7b 0a 20 20 69 66 28 20 2a 70 41  pArg){.  if( *pA
1fd00 72 67 3c 30 20 29 7b 0a 20 20 20 20 2a 70 41 72  rg<0 ){.    *pAr
1fd10 67 20 3d 20 28 70 46 69 6c 65 2d 3e 63 74 72 6c  g = (pFile->ctrl
1fd20 46 6c 61 67 73 20 26 20 6d 61 73 6b 29 21 3d 30  Flags & mask)!=0
1fd30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 28 2a  ;.  }else if( (*
1fd40 70 41 72 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20  pArg)==0 ){.    
1fd50 70 46 69 6c 65 2d 3e 63 74 72 6c 46 6c 61 67 73  pFile->ctrlFlags
1fd60 20 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 7d 65 6c   &= ~mask;.  }el
1fd70 73 65 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 63  se{.    pFile->c
1fd80 74 72 6c 46 6c 61 67 73 20 7c 3d 20 6d 61 73 6b  trlFlags |= mask
1fd90 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 46 6f 72 77  ;.  }.}../* Forw
1fda0 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  ard declaration 
1fdb0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e  */.static int un
1fdc0 69 78 47 65 74 54 65 6d 70 6e 61 6d 65 28 69 6e  ixGetTempname(in
1fdd0 74 20 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a 42  t nBuf, char *zB
1fde0 75 66 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 66 6f  uf);../*.** Info
1fdf0 72 6d 61 74 69 6f 6e 20 61 6e 64 20 63 6f 6e 74  rmation and cont
1fe00 72 6f 6c 20 6f 66 20 61 6e 20 6f 70 65 6e 20 66  rol of an open f
1fe10 69 6c 65 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73  ile handle..*/.s
1fe20 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 46 69  tatic int unixFi
1fe30 6c 65 43 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65  leControl(sqlite
1fe40 33 5f 66 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20  3_file *id, int 
1fe50 6f 70 2c 20 76 6f 69 64 20 2a 70 41 72 67 29 7b  op, void *pArg){
1fe60 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69  .  unixFile *pFi
1fe70 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29  le = (unixFile*)
1fe80 69 64 3b 0a 20 20 73 77 69 74 63 68 28 20 6f 70  id;.  switch( op
1fe90 20 29 7b 0a 23 69 66 20 64 65 66 69 6e 65 64 28   ){.#if defined(
1fea0 5f 5f 6c 69 6e 75 78 5f 5f 29 20 26 26 20 64 65  __linux__) && de
1feb0 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41  fined(SQLITE_ENA
1fec0 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43  BLE_BATCH_ATOMIC
1fed0 5f 57 52 49 54 45 29 0a 20 20 20 20 63 61 73 65  _WRITE).    case
1fee0 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 42 45   SQLITE_FCNTL_BE
1fef0 47 49 4e 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45  GIN_ATOMIC_WRITE
1ff00 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63  : {.      int rc
1ff10 20 3d 20 6f 73 49 6f 63 74 6c 28 70 46 69 6c 65   = osIoctl(pFile
1ff20 2d 3e 68 2c 20 46 32 46 53 5f 49 4f 43 5f 53 54  ->h, F2FS_IOC_ST
1ff30 41 52 54 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45  ART_ATOMIC_WRITE
1ff40 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
1ff50 72 63 20 3f 20 53 51 4c 49 54 45 5f 49 4f 45 52  rc ? SQLITE_IOER
1ff60 52 5f 42 45 47 49 4e 5f 41 54 4f 4d 49 43 20 3a  R_BEGIN_ATOMIC :
1ff70 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20   SQLITE_OK;.    
1ff80 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  }.    case SQLIT
1ff90 45 5f 46 43 4e 54 4c 5f 43 4f 4d 4d 49 54 5f 41  E_FCNTL_COMMIT_A
1ffa0 54 4f 4d 49 43 5f 57 52 49 54 45 3a 20 7b 0a 20  TOMIC_WRITE: {. 
1ffb0 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 6f 73       int rc = os
1ffc0 49 6f 63 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20  Ioctl(pFile->h, 
1ffd0 46 32 46 53 5f 49 4f 43 5f 43 4f 4d 4d 49 54 5f  F2FS_IOC_COMMIT_
1ffe0 41 54 4f 4d 49 43 5f 57 52 49 54 45 29 3b 0a 20  ATOMIC_WRITE);. 
1fff0 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 20 3f       return rc ?
20000 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 43 4f   SQLITE_IOERR_CO
20010 4d 4d 49 54 5f 41 54 4f 4d 49 43 20 3a 20 53 51  MMIT_ATOMIC : SQ
20020 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20  LITE_OK;.    }. 
20030 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46     case SQLITE_F
20040 43 4e 54 4c 5f 52 4f 4c 4c 42 41 43 4b 5f 41 54  CNTL_ROLLBACK_AT
20050 4f 4d 49 43 5f 57 52 49 54 45 3a 20 7b 0a 20 20  OMIC_WRITE: {.  
20060 20 20 20 20 69 6e 74 20 72 63 20 3d 20 6f 73 49      int rc = osI
20070 6f 63 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 46  octl(pFile->h, F
20080 32 46 53 5f 49 4f 43 5f 41 42 4f 52 54 5f 56 4f  2FS_IOC_ABORT_VO
20090 4c 41 54 49 4c 45 5f 57 52 49 54 45 29 3b 0a 20  LATILE_WRITE);. 
200a0 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 20 3f       return rc ?
200b0 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 52 4f   SQLITE_IOERR_RO
200c0 4c 4c 42 41 43 4b 5f 41 54 4f 4d 49 43 20 3a 20  LLBACK_ATOMIC : 
200d0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d  SQLITE_OK;.    }
200e0 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 5f 6c 69 6e  .#endif /* __lin
200f0 75 78 5f 5f 20 26 26 20 53 51 4c 49 54 45 5f 45  ux__ && SQLITE_E
20100 4e 41 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f 4d  NABLE_BATCH_ATOM
20110 49 43 5f 57 52 49 54 45 20 2a 2f 0a 0a 20 20 20  IC_WRITE */..   
20120 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e   case SQLITE_FCN
20130 54 4c 5f 4c 4f 43 4b 53 54 41 54 45 3a 20 7b 0a  TL_LOCKSTATE: {.
20140 20 20 20 20 20 20 2a 28 69 6e 74 2a 29 70 41 72        *(int*)pAr
20150 67 20 3d 20 70 46 69 6c 65 2d 3e 65 46 69 6c 65  g = pFile->eFile
20160 4c 6f 63 6b 3b 0a 20 20 20 20 20 20 72 65 74 75  Lock;.      retu
20170 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
20180 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c    }.    case SQL
20190 49 54 45 5f 46 43 4e 54 4c 5f 4c 41 53 54 5f 45  ITE_FCNTL_LAST_E
201a0 52 52 4e 4f 3a 20 7b 0a 20 20 20 20 20 20 2a 28  RRNO: {.      *(
201b0 69 6e 74 2a 29 70 41 72 67 20 3d 20 70 46 69 6c  int*)pArg = pFil
201c0 65 2d 3e 6c 61 73 74 45 72 72 6e 6f 3b 0a 20 20  e->lastErrno;.  
201d0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
201e0 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  E_OK;.    }.    
201f0 63 61 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54  case SQLITE_FCNT
20200 4c 5f 43 48 55 4e 4b 5f 53 49 5a 45 3a 20 7b 0a  L_CHUNK_SIZE: {.
20210 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 73 7a 43        pFile->szC
20220 68 75 6e 6b 20 3d 20 2a 28 69 6e 74 20 2a 29 70  hunk = *(int *)p
20230 41 72 67 3b 0a 20 20 20 20 20 20 72 65 74 75 72  Arg;.      retur
20240 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20  n SQLITE_OK;.   
20250 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49   }.    case SQLI
20260 54 45 5f 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49  TE_FCNTL_SIZE_HI
20270 4e 54 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20  NT: {.      int 
20280 72 63 3b 0a 20 20 20 20 20 20 53 69 6d 75 6c 61  rc;.      Simula
20290 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28  teIOErrorBenign(
202a0 31 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 66  1);.      rc = f
202b0 63 6e 74 6c 53 69 7a 65 48 69 6e 74 28 70 46 69  cntlSizeHint(pFi
202c0 6c 65 2c 20 2a 28 69 36 34 20 2a 29 70 41 72 67  le, *(i64 *)pArg
202d0 29 3b 0a 20 20 20 20 20 20 53 69 6d 75 6c 61 74  );.      Simulat
202e0 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28 30  eIOErrorBenign(0
202f0 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
20300 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61  rc;.    }.    ca
20310 73 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f  se SQLITE_FCNTL_
20320 50 45 52 53 49 53 54 5f 57 41 4c 3a 20 7b 0a 20  PERSIST_WAL: {. 
20330 20 20 20 20 20 75 6e 69 78 4d 6f 64 65 42 69 74       unixModeBit
20340 28 70 46 69 6c 65 2c 20 55 4e 49 58 46 49 4c 45  (pFile, UNIXFILE
20350 5f 50 45 52 53 49 53 54 5f 57 41 4c 2c 20 28 69  _PERSIST_WAL, (i
20360 6e 74 2a 29 70 41 72 67 29 3b 0a 20 20 20 20 20  nt*)pArg);.     
20370 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
20380 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  K;.    }.    cas
20390 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 50  e SQLITE_FCNTL_P
203a0 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49  OWERSAFE_OVERWRI
203b0 54 45 3a 20 7b 0a 20 20 20 20 20 20 75 6e 69 78  TE: {.      unix
203c0 4d 6f 64 65 42 69 74 28 70 46 69 6c 65 2c 20 55  ModeBit(pFile, U
203d0 4e 49 58 46 49 4c 45 5f 50 53 4f 57 2c 20 28 69  NIXFILE_PSOW, (i
203e0 6e 74 2a 29 70 41 72 67 29 3b 0a 20 20 20 20 20  nt*)pArg);.     
203f0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
20400 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  K;.    }.    cas
20410 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 56  e SQLITE_FCNTL_V
20420 46 53 4e 41 4d 45 3a 20 7b 0a 20 20 20 20 20 20  FSNAME: {.      
20430 2a 28 63 68 61 72 2a 2a 29 70 41 72 67 20 3d 20  *(char**)pArg = 
20440 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
20450 22 25 73 22 2c 20 70 46 69 6c 65 2d 3e 70 56 66  "%s", pFile->pVf
20460 73 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20  s->zName);.     
20470 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
20480 4b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  K;.    }.    cas
20490 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 54  e SQLITE_FCNTL_T
204a0 45 4d 50 46 49 4c 45 4e 41 4d 45 3a 20 7b 0a 20  EMPFILENAME: {. 
204b0 20 20 20 20 20 63 68 61 72 20 2a 7a 54 46 69 6c       char *zTFil
204c0 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  e = sqlite3_mall
204d0 6f 63 36 34 28 20 70 46 69 6c 65 2d 3e 70 56 66  oc64( pFile->pVf
204e0 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 20 29 3b  s->mxPathname );
204f0 0a 20 20 20 20 20 20 69 66 28 20 7a 54 46 69 6c  .      if( zTFil
20500 65 20 29 7b 0a 20 20 20 20 20 20 20 20 75 6e 69  e ){.        uni
20510 78 47 65 74 54 65 6d 70 6e 61 6d 65 28 70 46 69  xGetTempname(pFi
20520 6c 65 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68  le->pVfs->mxPath
20530 6e 61 6d 65 2c 20 7a 54 46 69 6c 65 29 3b 0a 20  name, zTFile);. 
20540 20 20 20 20 20 20 20 2a 28 63 68 61 72 2a 2a 29         *(char**)
20550 70 41 72 67 20 3d 20 7a 54 46 69 6c 65 3b 0a 20  pArg = zTFile;. 
20560 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74       }.      ret
20570 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
20580 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51     }.    case SQ
20590 4c 49 54 45 5f 46 43 4e 54 4c 5f 48 41 53 5f 4d  LITE_FCNTL_HAS_M
205a0 4f 56 45 44 3a 20 7b 0a 20 20 20 20 20 20 2a 28  OVED: {.      *(
205b0 69 6e 74 2a 29 70 41 72 67 20 3d 20 66 69 6c 65  int*)pArg = file
205c0 48 61 73 4d 6f 76 65 64 28 70 46 69 6c 65 29 3b  HasMoved(pFile);
205d0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
205e0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 23  LITE_OK;.    }.#
205f0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
20600 42 4c 45 5f 53 45 54 4c 4b 5f 54 49 4d 45 4f 55  BLE_SETLK_TIMEOU
20610 54 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  T.    case SQLIT
20620 45 5f 46 43 4e 54 4c 5f 4c 4f 43 4b 5f 54 49 4d  E_FCNTL_LOCK_TIM
20630 45 4f 55 54 3a 20 7b 0a 20 20 20 20 20 20 70 46  EOUT: {.      pF
20640 69 6c 65 2d 3e 69 42 75 73 79 54 69 6d 65 6f 75  ile->iBusyTimeou
20650 74 20 3d 20 2a 28 69 6e 74 2a 29 70 41 72 67 3b  t = *(int*)pArg;
20660 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
20670 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 23  LITE_OK;.    }.#
20680 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45  endif.#if SQLITE
20690 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30  _MAX_MMAP_SIZE>0
206a0 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
206b0 5f 46 43 4e 54 4c 5f 4d 4d 41 50 5f 53 49 5a 45  _FCNTL_MMAP_SIZE
206c0 3a 20 7b 0a 20 20 20 20 20 20 69 36 34 20 6e 65  : {.      i64 ne
206d0 77 4c 69 6d 69 74 20 3d 20 2a 28 69 36 34 2a 29  wLimit = *(i64*)
206e0 70 41 72 67 3b 0a 20 20 20 20 20 20 69 6e 74 20  pArg;.      int 
206f0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
20700 20 20 20 20 20 20 69 66 28 20 6e 65 77 4c 69 6d        if( newLim
20710 69 74 3e 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  it>sqlite3Global
20720 43 6f 6e 66 69 67 2e 6d 78 4d 6d 61 70 20 29 7b  Config.mxMmap ){
20730 0a 20 20 20 20 20 20 20 20 6e 65 77 4c 69 6d 69  .        newLimi
20740 74 20 3d 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  t = sqlite3Globa
20750 6c 43 6f 6e 66 69 67 2e 6d 78 4d 6d 61 70 3b 0a  lConfig.mxMmap;.
20760 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f        }..      /
20770 2a 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 6e  * The value of n
20780 65 77 4c 69 6d 69 74 20 6d 61 79 20 62 65 20 65  ewLimit may be e
20790 76 65 6e 74 75 61 6c 6c 79 20 63 61 73 74 20 74  ventually cast t
207a0 6f 20 28 73 69 7a 65 5f 74 29 20 61 6e 64 20 70  o (size_t) and p
207b0 61 73 73 65 64 0a 20 20 20 20 20 20 2a 2a 20 74  assed.      ** t
207c0 6f 20 6d 6d 61 70 28 29 2e 20 52 65 73 74 72 69  o mmap(). Restri
207d0 63 74 20 69 74 73 20 76 61 6c 75 65 20 74 6f 20  ct its value to 
207e0 32 47 42 20 69 66 20 28 73 69 7a 65 5f 74 29 20  2GB if (size_t) 
207f0 69 73 20 6e 6f 74 20 61 74 20 6c 65 61 73 74 20  is not at least 
20800 61 0a 20 20 20 20 20 20 2a 2a 20 36 34 2d 62 69  a.      ** 64-bi
20810 74 20 74 79 70 65 2e 20 2a 2f 0a 20 20 20 20 20  t type. */.     
20820 20 69 66 28 20 6e 65 77 4c 69 6d 69 74 3e 30 20   if( newLimit>0 
20830 26 26 20 73 69 7a 65 6f 66 28 73 69 7a 65 5f 74  && sizeof(size_t
20840 29 3c 38 20 29 7b 0a 20 20 20 20 20 20 20 20 6e  )<8 ){.        n
20850 65 77 4c 69 6d 69 74 20 3d 20 28 6e 65 77 4c 69  ewLimit = (newLi
20860 6d 69 74 20 26 20 30 78 37 46 46 46 46 46 46 46  mit & 0x7FFFFFFF
20870 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20  );.      }..    
20880 20 20 2a 28 69 36 34 2a 29 70 41 72 67 20 3d 20    *(i64*)pArg = 
20890 70 46 69 6c 65 2d 3e 6d 6d 61 70 53 69 7a 65 4d  pFile->mmapSizeM
208a0 61 78 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 65  ax;.      if( ne
208b0 77 4c 69 6d 69 74 3e 3d 30 20 26 26 20 6e 65 77  wLimit>=0 && new
208c0 4c 69 6d 69 74 21 3d 70 46 69 6c 65 2d 3e 6d 6d  Limit!=pFile->mm
208d0 61 70 53 69 7a 65 4d 61 78 20 26 26 20 70 46 69  apSizeMax && pFi
208e0 6c 65 2d 3e 6e 46 65 74 63 68 4f 75 74 3d 3d 30  le->nFetchOut==0
208f0 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46 69 6c   ){.        pFil
20900 65 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 20 3d  e->mmapSizeMax =
20910 20 6e 65 77 4c 69 6d 69 74 3b 0a 20 20 20 20 20   newLimit;.     
20920 20 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 6d 6d     if( pFile->mm
20930 61 70 53 69 7a 65 3e 30 20 29 7b 0a 20 20 20 20  apSize>0 ){.    
20940 20 20 20 20 20 20 75 6e 69 78 55 6e 6d 61 70 66        unixUnmapf
20950 69 6c 65 28 70 46 69 6c 65 29 3b 0a 20 20 20 20  ile(pFile);.    
20960 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 4d        rc = unixM
20970 61 70 66 69 6c 65 28 70 46 69 6c 65 2c 20 2d 31  apfile(pFile, -1
20980 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
20990 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72     }.      retur
209a0 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 23 65 6e 64  n rc;.    }.#end
209b0 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  if.#ifdef SQLITE
209c0 5f 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68  _DEBUG.    /* Th
209d0 65 20 70 61 67 65 72 20 63 61 6c 6c 73 20 74 68  e pager calls th
209e0 69 73 20 6d 65 74 68 6f 64 20 74 6f 20 73 69 67  is method to sig
209f0 6e 61 6c 20 74 68 61 74 20 69 74 20 68 61 73 20  nal that it has 
20a00 64 6f 6e 65 0a 20 20 20 20 2a 2a 20 61 20 72 6f  done.    ** a ro
20a10 6c 6c 62 61 63 6b 20 61 6e 64 20 74 68 61 74 20  llback and that 
20a20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
20a30 74 68 65 72 65 66 6f 72 65 20 75 6e 63 68 61 6e  therefore unchan
20a40 67 65 64 20 61 6e 64 0a 20 20 20 20 2a 2a 20 69  ged and.    ** i
20a50 74 20 68 65 6e 63 65 20 69 74 20 69 73 20 4f 4b  t hence it is OK
20a60 20 66 6f 72 20 74 68 65 20 74 72 61 6e 73 61 63   for the transac
20a70 74 69 6f 6e 20 63 68 61 6e 67 65 20 63 6f 75 6e  tion change coun
20a80 74 65 72 20 74 6f 20 62 65 0a 20 20 20 20 2a 2a  ter to be.    **
20a90 20 75 6e 63 68 61 6e 67 65 64 2e 0a 20 20 20 20   unchanged..    
20aa0 2a 2f 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49  */.    case SQLI
20ab0 54 45 5f 46 43 4e 54 4c 5f 44 42 5f 55 4e 43 48  TE_FCNTL_DB_UNCH
20ac0 41 4e 47 45 44 3a 20 7b 0a 20 20 20 20 20 20 28  ANGED: {.      (
20ad0 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d 3e  (unixFile*)id)->
20ae0 64 62 55 70 64 61 74 65 20 3d 20 30 3b 0a 20 20  dbUpdate = 0;.  
20af0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
20b00 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64  E_OK;.    }.#end
20b10 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e  if.#if SQLITE_EN
20b20 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59  ABLE_LOCKING_STY
20b30 4c 45 20 26 26 20 64 65 66 69 6e 65 64 28 5f 5f  LE && defined(__
20b40 41 50 50 4c 45 5f 5f 29 0a 20 20 20 20 63 61 73  APPLE__).    cas
20b50 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 53  e SQLITE_FCNTL_S
20b60 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46 49 4c 45  ET_LOCKPROXYFILE
20b70 3a 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  :.    case SQLIT
20b80 45 5f 46 43 4e 54 4c 5f 47 45 54 5f 4c 4f 43 4b  E_FCNTL_GET_LOCK
20b90 50 52 4f 58 59 46 49 4c 45 3a 20 7b 0a 20 20 20  PROXYFILE: {.   
20ba0 20 20 20 72 65 74 75 72 6e 20 70 72 6f 78 79 46     return proxyF
20bb0 69 6c 65 43 6f 6e 74 72 6f 6c 28 69 64 2c 6f 70  ileControl(id,op
20bc0 2c 70 41 72 67 29 3b 0a 20 20 20 20 7d 0a 23 65  ,pArg);.    }.#e
20bd0 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45  ndif /* SQLITE_E
20be0 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54  NABLE_LOCKING_ST
20bf0 59 4c 45 20 26 26 20 64 65 66 69 6e 65 64 28 5f  YLE && defined(_
20c00 5f 41 50 50 4c 45 5f 5f 29 20 2a 2f 0a 20 20 7d  _APPLE__) */.  }
20c10 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
20c20 5f 4e 4f 54 46 4f 55 4e 44 3b 0a 7d 0a 0a 2f 2a  _NOTFOUND;.}../*
20c30 0a 2a 2a 20 49 66 20 70 46 64 2d 3e 73 65 63 74  .** If pFd->sect
20c40 6f 72 53 69 7a 65 20 69 73 20 6e 6f 6e 2d 7a 65  orSize is non-ze
20c50 72 6f 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e  ro when this fun
20c60 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c  ction is called,
20c70 20 69 74 20 69 73 20 61 0a 2a 2a 20 6e 6f 2d 6f   it is a.** no-o
20c80 70 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68  p. Otherwise, th
20c90 65 20 76 61 6c 75 65 73 20 6f 66 20 70 46 64 2d  e values of pFd-
20ca0 3e 73 65 63 74 6f 72 53 69 7a 65 20 61 6e 64 20  >sectorSize and 
20cb0 0a 2a 2a 20 70 46 64 2d 3e 64 65 76 69 63 65 43  .** pFd->deviceC
20cc0 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 61  haracteristics a
20cd0 72 65 20 73 65 74 20 61 63 63 6f 72 64 69 6e 67  re set according
20ce0 20 74 6f 20 74 68 65 20 66 69 6c 65 2d 73 79 73   to the file-sys
20cf0 74 65 6d 20 0a 2a 2a 20 63 68 61 72 61 63 74 65  tem .** characte
20d00 72 69 73 74 69 63 73 2e 20 0a 2a 2a 0a 2a 2a 20  ristics. .**.** 
20d10 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 76 65  There are two ve
20d20 72 73 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 66  rsions of this f
20d30 75 6e 63 74 69 6f 6e 2e 20 4f 6e 65 20 66 6f 72  unction. One for
20d40 20 51 4e 58 20 61 6e 64 20 6f 6e 65 20 66 6f 72   QNX and one for
20d50 20 61 6c 6c 0a 2a 2a 20 6f 74 68 65 72 20 73 79   all.** other sy
20d60 73 74 65 6d 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65  stems..*/.#ifnde
20d70 66 20 5f 5f 51 4e 58 4e 54 4f 5f 5f 0a 73 74 61  f __QNXNTO__.sta
20d80 74 69 63 20 76 6f 69 64 20 73 65 74 44 65 76 69  tic void setDevi
20d90 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63  ceCharacteristic
20da0 73 28 75 6e 69 78 46 69 6c 65 20 2a 70 46 64 29  s(unixFile *pFd)
20db0 7b 0a 20 20 61 73 73 65 72 74 28 20 70 46 64 2d  {.  assert( pFd-
20dc0 3e 64 65 76 69 63 65 43 68 61 72 61 63 74 65 72  >deviceCharacter
20dd0 69 73 74 69 63 73 3d 3d 30 20 7c 7c 20 70 46 64  istics==0 || pFd
20de0 2d 3e 73 65 63 74 6f 72 53 69 7a 65 21 3d 30 20  ->sectorSize!=0 
20df0 29 3b 0a 20 20 69 66 28 20 70 46 64 2d 3e 73 65  );.  if( pFd->se
20e00 63 74 6f 72 53 69 7a 65 3d 3d 30 20 29 7b 0a 23  ctorSize==0 ){.#
20e10 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c 69 6e  if defined(__lin
20e20 75 78 5f 5f 29 20 26 26 20 64 65 66 69 6e 65 64  ux__) && defined
20e30 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42  (SQLITE_ENABLE_B
20e40 41 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54  ATCH_ATOMIC_WRIT
20e50 45 29 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a  E).    int res;.
20e60 20 20 20 20 75 33 32 20 66 20 3d 20 30 3b 0a 0a      u32 f = 0;..
20e70 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 66 6f 72      /* Check for
20e80 20 73 75 70 70 6f 72 74 20 66 6f 72 20 46 32 46   support for F2F
20e90 53 20 61 74 6f 6d 69 63 20 62 61 74 63 68 20 77  S atomic batch w
20ea0 72 69 74 65 73 2e 20 2a 2f 0a 20 20 20 20 72 65  rites. */.    re
20eb0 73 20 3d 20 6f 73 49 6f 63 74 6c 28 70 46 64 2d  s = osIoctl(pFd-
20ec0 3e 68 2c 20 46 32 46 53 5f 49 4f 43 5f 47 45 54  >h, F2FS_IOC_GET
20ed0 5f 46 45 41 54 55 52 45 53 2c 20 26 66 29 3b 0a  _FEATURES, &f);.
20ee0 20 20 20 20 69 66 28 20 72 65 73 3d 3d 30 20 26      if( res==0 &
20ef0 26 20 28 66 20 26 20 46 32 46 53 5f 46 45 41 54  & (f & F2FS_FEAT
20f00 55 52 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45  URE_ATOMIC_WRITE
20f10 29 20 29 7b 0a 20 20 20 20 20 20 70 46 64 2d 3e  ) ){.      pFd->
20f20 64 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69  deviceCharacteri
20f30 73 74 69 63 73 20 3d 20 53 51 4c 49 54 45 5f 49  stics = SQLITE_I
20f40 4f 43 41 50 5f 42 41 54 43 48 5f 41 54 4f 4d 49  OCAP_BATCH_ATOMI
20f50 43 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 20  C;.    }.#endif 
20f60 2f 2a 20 5f 5f 6c 69 6e 75 78 5f 5f 20 26 26 20  /* __linux__ && 
20f70 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41  SQLITE_ENABLE_BA
20f80 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45  TCH_ATOMIC_WRITE
20f90 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20   */..    /* Set 
20fa0 74 68 65 20 50 4f 57 45 52 53 41 46 45 5f 4f 56  the POWERSAFE_OV
20fb0 45 52 57 52 49 54 45 20 66 6c 61 67 20 69 66 20  ERWRITE flag if 
20fc0 72 65 71 75 65 73 74 65 64 2e 20 2a 2f 0a 20 20  requested. */.  
20fd0 20 20 69 66 28 20 70 46 64 2d 3e 63 74 72 6c 46    if( pFd->ctrlF
20fe0 6c 61 67 73 20 26 20 55 4e 49 58 46 49 4c 45 5f  lags & UNIXFILE_
20ff0 50 53 4f 57 20 29 7b 0a 20 20 20 20 20 20 70 46  PSOW ){.      pF
21000 64 2d 3e 64 65 76 69 63 65 43 68 61 72 61 63 74  d->deviceCharact
21010 65 72 69 73 74 69 63 73 20 7c 3d 20 53 51 4c 49  eristics |= SQLI
21020 54 45 5f 49 4f 43 41 50 5f 50 4f 57 45 52 53 41  TE_IOCAP_POWERSA
21030 46 45 5f 4f 56 45 52 57 52 49 54 45 3b 0a 20 20  FE_OVERWRITE;.  
21040 20 20 7d 0a 0a 20 20 20 20 70 46 64 2d 3e 73 65    }..    pFd->se
21050 63 74 6f 72 53 69 7a 65 20 3d 20 53 51 4c 49 54  ctorSize = SQLIT
21060 45 5f 44 45 46 41 55 4c 54 5f 53 45 43 54 4f 52  E_DEFAULT_SECTOR
21070 5f 53 49 5a 45 3b 0a 20 20 7d 0a 7d 0a 23 65 6c  _SIZE;.  }.}.#el
21080 73 65 0a 23 69 6e 63 6c 75 64 65 20 3c 73 79 73  se.#include <sys
21090 2f 64 63 6d 64 5f 62 6c 6b 2e 68 3e 0a 23 69 6e  /dcmd_blk.h>.#in
210a0 63 6c 75 64 65 20 3c 73 79 73 2f 73 74 61 74 76  clude <sys/statv
210b0 66 73 2e 68 3e 0a 73 74 61 74 69 63 20 76 6f 69  fs.h>.static voi
210c0 64 20 73 65 74 44 65 76 69 63 65 43 68 61 72 61  d setDeviceChara
210d0 63 74 65 72 69 73 74 69 63 73 28 75 6e 69 78 46  cteristics(unixF
210e0 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 69  ile *pFile){.  i
210f0 66 28 20 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72  f( pFile->sector
21100 53 69 7a 65 20 3d 3d 20 30 20 29 7b 0a 20 20 20  Size == 0 ){.   
21110 20 73 74 72 75 63 74 20 73 74 61 74 76 66 73 20   struct statvfs 
21120 66 73 49 6e 66 6f 3b 0a 20 20 20 20 20 20 20 0a  fsInfo;.       .
21130 20 20 20 20 2f 2a 20 53 65 74 20 64 65 66 61 75      /* Set defau
21140 6c 74 73 20 66 6f 72 20 6e 6f 6e 2d 73 75 70 70  lts for non-supp
21150 6f 72 74 65 64 20 66 69 6c 65 73 79 73 74 65 6d  orted filesystem
21160 73 20 2a 2f 0a 20 20 20 20 70 46 69 6c 65 2d 3e  s */.    pFile->
21170 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 53 51 4c  sectorSize = SQL
21180 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 45 43 54  ITE_DEFAULT_SECT
21190 4f 52 5f 53 49 5a 45 3b 0a 20 20 20 20 70 46 69  OR_SIZE;.    pFi
211a0 6c 65 2d 3e 64 65 76 69 63 65 43 68 61 72 61 63  le->deviceCharac
211b0 74 65 72 69 73 74 69 63 73 20 3d 20 30 3b 0a 20  teristics = 0;. 
211c0 20 20 20 69 66 28 20 66 73 74 61 74 76 66 73 28     if( fstatvfs(
211d0 70 46 69 6c 65 2d 3e 68 2c 20 26 66 73 49 6e 66  pFile->h, &fsInf
211e0 6f 29 20 3d 3d 20 2d 31 20 29 20 7b 0a 20 20 20  o) == -1 ) {.   
211f0 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d     return;.    }
21200 0a 0a 20 20 20 20 69 66 28 20 21 73 74 72 63 6d  ..    if( !strcm
21210 70 28 66 73 49 6e 66 6f 2e 66 5f 62 61 73 65 74  p(fsInfo.f_baset
21220 79 70 65 2c 20 22 74 6d 70 22 29 20 29 20 7b 0a  ype, "tmp") ) {.
21230 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 73 65 63        pFile->sec
21240 74 6f 72 53 69 7a 65 20 3d 20 66 73 49 6e 66 6f  torSize = fsInfo
21250 2e 66 5f 62 73 69 7a 65 3b 0a 20 20 20 20 20 20  .f_bsize;.      
21260 70 46 69 6c 65 2d 3e 64 65 76 69 63 65 43 68 61  pFile->deviceCha
21270 72 61 63 74 65 72 69 73 74 69 63 73 20 3d 0a 20  racteristics =. 
21280 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4f         SQLITE_IO
21290 43 41 50 5f 41 54 4f 4d 49 43 34 4b 20 7c 20 20  CAP_ATOMIC4K |  
212a0 20 20 20 20 20 2f 2a 20 41 6c 6c 20 72 61 6d 20       /* All ram 
212b0 66 69 6c 65 73 79 73 74 65 6d 20 77 72 69 74 65  filesystem write
212c0 73 20 61 72 65 20 61 74 6f 6d 69 63 20 2a 2f 0a  s are atomic */.
212d0 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 49          SQLITE_I
212e0 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e 44  OCAP_SAFE_APPEND
212f0 20 7c 20 20 20 20 2f 2a 20 67 72 6f 77 69 6e 67   |    /* growing
21300 20 74 68 65 20 66 69 6c 65 20 64 6f 65 73 20 6e   the file does n
21310 6f 74 20 6f 63 63 75 72 20 75 6e 74 69 6c 0a 20  ot occur until. 
21320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21340 20 20 20 20 20 2a 2a 20 74 68 65 20 77 72 69 74       ** the writ
21350 65 20 73 75 63 63 65 65 64 73 20 2a 2f 0a 20 20  e succeeds */.  
21360 20 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4f 43        SQLITE_IOC
21370 41 50 5f 53 45 51 55 45 4e 54 49 41 4c 20 7c 20  AP_SEQUENTIAL | 
21380 20 20 20 20 2f 2a 20 54 68 65 20 72 61 6d 20 66      /* The ram f
21390 69 6c 65 73 79 73 74 65 6d 20 68 61 73 20 6e 6f  ilesystem has no
213a0 20 77 72 69 74 65 20 62 65 68 69 6e 64 0a 20 20   write behind.  
213b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
213c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
213d0 20 20 20 20 2a 2a 20 73 6f 20 69 74 20 69 73 20      ** so it is 
213e0 6f 72 64 65 72 65 64 20 2a 2f 0a 20 20 20 20 20  ordered */.     
213f0 20 20 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20     0;.    }else 
21400 69 66 28 20 73 74 72 73 74 72 28 66 73 49 6e 66  if( strstr(fsInf
21410 6f 2e 66 5f 62 61 73 65 74 79 70 65 2c 20 22 65  o.f_basetype, "e
21420 74 66 73 22 29 20 29 7b 0a 20 20 20 20 20 20 70  tfs") ){.      p
21430 46 69 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65  File->sectorSize
21440 20 3d 20 66 73 49 6e 66 6f 2e 66 5f 62 73 69 7a   = fsInfo.f_bsiz
21450 65 3b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e  e;.      pFile->
21460 64 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69  deviceCharacteri
21470 73 74 69 63 73 20 3d 0a 20 20 20 20 20 20 20 20  stics =.        
21480 2f 2a 20 65 74 66 73 20 63 6c 75 73 74 65 72 20  /* etfs cluster 
21490 73 69 7a 65 20 77 72 69 74 65 73 20 61 72 65 20  size writes are 
214a0 61 74 6f 6d 69 63 20 2a 2f 0a 20 20 20 20 20 20  atomic */.      
214b0 20 20 28 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72    (pFile->sector
214c0 53 69 7a 65 20 2f 20 35 31 32 20 2a 20 53 51 4c  Size / 512 * SQL
214d0 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43  ITE_IOCAP_ATOMIC
214e0 35 31 32 29 20 7c 0a 20 20 20 20 20 20 20 20 53  512) |.        S
214f0 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45  QLITE_IOCAP_SAFE
21500 5f 41 50 50 45 4e 44 20 7c 20 20 20 20 2f 2a 20  _APPEND |    /* 
21510 67 72 6f 77 69 6e 67 20 74 68 65 20 66 69 6c 65  growing the file
21520 20 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20   does not occur 
21530 75 6e 74 69 6c 0a 20 20 20 20 20 20 20 20 20 20  until.          
21540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21550 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74              ** t
21560 68 65 20 77 72 69 74 65 20 73 75 63 63 65 65 64  he write succeed
21570 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 53 51 4c  s */.        SQL
21580 49 54 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e  ITE_IOCAP_SEQUEN
21590 54 49 41 4c 20 7c 20 20 20 20 20 2f 2a 20 54 68  TIAL |     /* Th
215a0 65 20 72 61 6d 20 66 69 6c 65 73 79 73 74 65 6d  e ram filesystem
215b0 20 68 61 73 20 6e 6f 20 77 72 69 74 65 20 62 65   has no write be
215c0 68 69 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20  hind.           
215d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
215e0 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 6f             ** so
215f0 20 69 74 20 69 73 20 6f 72 64 65 72 65 64 20 2a   it is ordered *
21600 2f 0a 20 20 20 20 20 20 20 20 30 3b 0a 20 20 20  /.        0;.   
21610 20 7d 65 6c 73 65 20 69 66 28 20 21 73 74 72 63   }else if( !strc
21620 6d 70 28 66 73 49 6e 66 6f 2e 66 5f 62 61 73 65  mp(fsInfo.f_base
21630 74 79 70 65 2c 20 22 71 6e 78 36 22 29 20 29 7b  type, "qnx6") ){
21640 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 73 65  .      pFile->se
21650 63 74 6f 72 53 69 7a 65 20 3d 20 66 73 49 6e 66  ctorSize = fsInf
21660 6f 2e 66 5f 62 73 69 7a 65 3b 0a 20 20 20 20 20  o.f_bsize;.     
21670 20 70 46 69 6c 65 2d 3e 64 65 76 69 63 65 43 68   pFile->deviceCh
21680 61 72 61 63 74 65 72 69 73 74 69 63 73 20 3d 0a  aracteristics =.
21690 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 49          SQLITE_I
216a0 4f 43 41 50 5f 41 54 4f 4d 49 43 20 7c 20 20 20  OCAP_ATOMIC |   
216b0 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 66 69 6c        /* All fil
216c0 65 73 79 73 74 65 6d 20 77 72 69 74 65 73 20 61  esystem writes a
216d0 72 65 20 61 74 6f 6d 69 63 20 2a 2f 0a 20 20 20  re atomic */.   
216e0 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4f 43 41       SQLITE_IOCA
216f0 50 5f 53 41 46 45 5f 41 50 50 45 4e 44 20 7c 20  P_SAFE_APPEND | 
21700 20 20 20 2f 2a 20 67 72 6f 77 69 6e 67 20 74 68     /* growing th
21710 65 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20  e file does not 
21720 6f 63 63 75 72 20 75 6e 74 69 6c 0a 20 20 20 20  occur until.    
21730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21750 20 20 2a 2a 20 74 68 65 20 77 72 69 74 65 20 73    ** the write s
21760 75 63 63 65 65 64 73 20 2a 2f 0a 20 20 20 20 20  ucceeds */.     
21770 20 20 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f     SQLITE_IOCAP_
21780 53 45 51 55 45 4e 54 49 41 4c 20 7c 20 20 20 20  SEQUENTIAL |    
21790 20 2f 2a 20 54 68 65 20 72 61 6d 20 66 69 6c 65   /* The ram file
217a0 73 79 73 74 65 6d 20 68 61 73 20 6e 6f 20 77 72  system has no wr
217b0 69 74 65 20 62 65 68 69 6e 64 0a 20 20 20 20 20  ite behind.     
217c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
217d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
217e0 20 2a 2a 20 73 6f 20 69 74 20 69 73 20 6f 72 64   ** so it is ord
217f0 65 72 65 64 20 2a 2f 0a 20 20 20 20 20 20 20 20  ered */.        
21800 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  0;.    }else if(
21810 20 21 73 74 72 63 6d 70 28 66 73 49 6e 66 6f 2e   !strcmp(fsInfo.
21820 66 5f 62 61 73 65 74 79 70 65 2c 20 22 71 6e 78  f_basetype, "qnx
21830 34 22 29 20 29 7b 0a 20 20 20 20 20 20 70 46 69  4") ){.      pFi
21840 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d  le->sectorSize =
21850 20 66 73 49 6e 66 6f 2e 66 5f 62 73 69 7a 65 3b   fsInfo.f_bsize;
21860 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 64 65  .      pFile->de
21870 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74  viceCharacterist
21880 69 63 73 20 3d 0a 20 20 20 20 20 20 20 20 2f 2a  ics =.        /*
21890 20 66 75 6c 6c 20 62 69 74 73 65 74 20 6f 66 20   full bitset of 
218a0 61 74 6f 6d 69 63 73 20 66 72 6f 6d 20 6d 61 78  atomics from max
218b0 20 73 65 63 74 6f 72 20 73 69 7a 65 20 61 6e 64   sector size and
218c0 20 73 6d 61 6c 6c 65 72 20 2a 2f 0a 20 20 20 20   smaller */.    
218d0 20 20 20 20 28 28 70 46 69 6c 65 2d 3e 73 65 63      ((pFile->sec
218e0 74 6f 72 53 69 7a 65 20 2f 20 35 31 32 20 2a 20  torSize / 512 * 
218f0 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f  SQLITE_IOCAP_ATO
21900 4d 49 43 35 31 32 29 20 3c 3c 20 31 29 20 2d 20  MIC512) << 1) - 
21910 32 20 7c 0a 20 20 20 20 20 20 20 20 53 51 4c 49  2 |.        SQLI
21920 54 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e 54  TE_IOCAP_SEQUENT
21930 49 41 4c 20 7c 20 20 20 20 20 2f 2a 20 54 68 65  IAL |     /* The
21940 20 72 61 6d 20 66 69 6c 65 73 79 73 74 65 6d 20   ram filesystem 
21950 68 61 73 20 6e 6f 20 77 72 69 74 65 20 62 65 68  has no write beh
21960 69 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20  ind.            
21970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21980 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 6f 20            ** so 
21990 69 74 20 69 73 20 6f 72 64 65 72 65 64 20 2a 2f  it is ordered */
219a0 0a 20 20 20 20 20 20 20 20 30 3b 0a 20 20 20 20  .        0;.    
219b0 7d 65 6c 73 65 20 69 66 28 20 73 74 72 73 74 72  }else if( strstr
219c0 28 66 73 49 6e 66 6f 2e 66 5f 62 61 73 65 74 79  (fsInfo.f_basety
219d0 70 65 2c 20 22 64 6f 73 22 29 20 29 7b 0a 20 20  pe, "dos") ){.  
219e0 20 20 20 20 70 46 69 6c 65 2d 3e 73 65 63 74 6f      pFile->secto
219f0 72 53 69 7a 65 20 3d 20 66 73 49 6e 66 6f 2e 66  rSize = fsInfo.f
21a00 5f 62 73 69 7a 65 3b 0a 20 20 20 20 20 20 70 46  _bsize;.      pF
21a10 69 6c 65 2d 3e 64 65 76 69 63 65 43 68 61 72 61  ile->deviceChara
21a20 63 74 65 72 69 73 74 69 63 73 20 3d 0a 20 20 20  cteristics =.   
21a30 20 20 20 20 20 2f 2a 20 66 75 6c 6c 20 62 69 74       /* full bit
21a40 73 65 74 20 6f 66 20 61 74 6f 6d 69 63 73 20 66  set of atomics f
21a50 72 6f 6d 20 6d 61 78 20 73 65 63 74 6f 72 20 73  rom max sector s
21a60 69 7a 65 20 61 6e 64 20 73 6d 61 6c 6c 65 72 20  ize and smaller 
21a70 2a 2f 0a 20 20 20 20 20 20 20 20 28 28 70 46 69  */.        ((pFi
21a80 6c 65 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 2f  le->sectorSize /
21a90 20 35 31 32 20 2a 20 53 51 4c 49 54 45 5f 49 4f   512 * SQLITE_IO
21aa0 43 41 50 5f 41 54 4f 4d 49 43 35 31 32 29 20 3c  CAP_ATOMIC512) <
21ab0 3c 20 31 29 20 2d 20 32 20 7c 0a 20 20 20 20 20  < 1) - 2 |.     
21ac0 20 20 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f     SQLITE_IOCAP_
21ad0 53 45 51 55 45 4e 54 49 41 4c 20 7c 20 20 20 20  SEQUENTIAL |    
21ae0 20 2f 2a 20 54 68 65 20 72 61 6d 20 66 69 6c 65   /* The ram file
21af0 73 79 73 74 65 6d 20 68 61 73 20 6e 6f 20 77 72  system has no wr
21b00 69 74 65 20 62 65 68 69 6e 64 0a 20 20 20 20 20  ite behind.     
21b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21b30 20 2a 2a 20 73 6f 20 69 74 20 69 73 20 6f 72 64   ** so it is ord
21b40 65 72 65 64 20 2a 2f 0a 20 20 20 20 20 20 20 20  ered */.        
21b50 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
21b60 20 20 20 20 70 46 69 6c 65 2d 3e 64 65 76 69 63      pFile->devic
21b70 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73  eCharacteristics
21b80 20 3d 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54   =.        SQLIT
21b90 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 35 31  E_IOCAP_ATOMIC51
21ba0 32 20 7c 20 20 20 20 20 20 2f 2a 20 62 6c 6f 63  2 |      /* bloc
21bb0 6b 73 20 61 72 65 20 61 74 6f 6d 69 63 20 2a 2f  ks are atomic */
21bc0 0a 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f  .        SQLITE_
21bd0 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e  IOCAP_SAFE_APPEN
21be0 44 20 7c 20 20 20 20 2f 2a 20 67 72 6f 77 69 6e  D |    /* growin
21bf0 67 20 74 68 65 20 66 69 6c 65 20 64 6f 65 73 20  g the file does 
21c00 6e 6f 74 20 6f 63 63 75 72 20 75 6e 74 69 6c 0a  not occur until.
21c10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21c30 20 20 20 20 20 20 2a 2a 20 74 68 65 20 77 72 69        ** the wri
21c40 74 65 20 73 75 63 63 65 65 64 73 20 2a 2f 0a 20  te succeeds */. 
21c50 20 20 20 20 20 20 20 30 3b 0a 20 20 20 20 7d 0a         0;.    }.
21c60 20 20 7d 0a 20 20 2f 2a 20 4c 61 73 74 20 63 68    }.  /* Last ch
21c70 61 6e 63 65 20 76 65 72 69 66 69 63 61 74 69 6f  ance verificatio
21c80 6e 2e 20 20 49 66 20 74 68 65 20 73 65 63 74 6f  n.  If the secto
21c90 72 20 73 69 7a 65 20 69 73 6e 27 74 20 61 20 6d  r size isn't a m
21ca0 75 6c 74 69 70 6c 65 20 6f 66 20 35 31 32 0a 20  ultiple of 512. 
21cb0 20 2a 2a 20 74 68 65 6e 20 69 74 20 69 73 6e 27   ** then it isn'
21cc0 74 20 76 61 6c 69 64 2e 2a 2f 0a 20 20 69 66 28  t valid.*/.  if(
21cd0 20 70 46 69 6c 65 2d 3e 73 65 63 74 6f 72 53 69   pFile->sectorSi
21ce0 7a 65 20 25 20 35 31 32 20 21 3d 20 30 20 29 7b  ze % 512 != 0 ){
21cf0 0a 20 20 20 20 70 46 69 6c 65 2d 3e 64 65 76 69  .    pFile->devi
21d00 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63  ceCharacteristic
21d10 73 20 3d 20 30 3b 0a 20 20 20 20 70 46 69 6c 65  s = 0;.    pFile
21d20 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 53  ->sectorSize = S
21d30 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 45  QLITE_DEFAULT_SE
21d40 43 54 4f 52 5f 53 49 5a 45 3b 0a 20 20 7d 0a 7d  CTOR_SIZE;.  }.}
21d50 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52  .#endif../*.** R
21d60 65 74 75 72 6e 20 74 68 65 20 73 65 63 74 6f 72  eturn the sector
21d70 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 6f   size in bytes o
21d80 66 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67  f the underlying
21d90 20 62 6c 6f 63 6b 20 64 65 76 69 63 65 20 66 6f   block device fo
21da0 72 0a 2a 2a 20 74 68 65 20 73 70 65 63 69 66 69  r.** the specifi
21db0 65 64 20 66 69 6c 65 2e 20 54 68 69 73 20 69 73  ed file. This is
21dc0 20 61 6c 6d 6f 73 74 20 61 6c 77 61 79 73 20 35   almost always 5
21dd0 31 32 20 62 79 74 65 73 2c 20 62 75 74 20 6d 61  12 bytes, but ma
21de0 79 20 62 65 0a 2a 2a 20 6c 61 72 67 65 72 20 66  y be.** larger f
21df0 6f 72 20 73 6f 6d 65 20 64 65 76 69 63 65 73 2e  or some devices.
21e00 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 63 6f  .**.** SQLite co
21e10 64 65 20 61 73 73 75 6d 65 73 20 74 68 69 73 20  de assumes this 
21e20 66 75 6e 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20  function cannot 
21e30 66 61 69 6c 2e 20 49 74 20 61 6c 73 6f 20 61 73  fail. It also as
21e40 73 75 6d 65 73 20 74 68 61 74 0a 2a 2a 20 69 66  sumes that.** if
21e50 20 74 77 6f 20 66 69 6c 65 73 20 61 72 65 20 63   two files are c
21e60 72 65 61 74 65 64 20 69 6e 20 74 68 65 20 73 61  reated in the sa
21e70 6d 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 64  me file-system d
21e80 69 72 65 63 74 6f 72 79 20 28 69 2e 65 2e 0a 2a  irectory (i.e..*
21e90 2a 20 61 20 64 61 74 61 62 61 73 65 20 61 6e 64  * a database and
21ea0 20 69 74 73 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   its journal fil
21eb0 65 29 20 74 68 61 74 20 74 68 65 20 73 65 63 74  e) that the sect
21ec0 6f 72 20 73 69 7a 65 20 77 69 6c 6c 20 62 65 20  or size will be 
21ed0 74 68 65 0a 2a 2a 20 73 61 6d 65 20 66 6f 72 20  the.** same for 
21ee0 62 6f 74 68 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  both..*/.static 
21ef0 69 6e 74 20 75 6e 69 78 53 65 63 74 6f 72 53 69  int unixSectorSi
21f00 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  ze(sqlite3_file 
21f10 2a 69 64 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65  *id){.  unixFile
21f20 20 2a 70 46 64 20 3d 20 28 75 6e 69 78 46 69 6c   *pFd = (unixFil
21f30 65 2a 29 69 64 3b 0a 20 20 73 65 74 44 65 76 69  e*)id;.  setDevi
21f40 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63  ceCharacteristic
21f50 73 28 70 46 64 29 3b 0a 20 20 72 65 74 75 72 6e  s(pFd);.  return
21f60 20 70 46 64 2d 3e 73 65 63 74 6f 72 53 69 7a 65   pFd->sectorSize
21f70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
21f80 6e 20 74 68 65 20 64 65 76 69 63 65 20 63 68 61  n the device cha
21f90 72 61 63 74 65 72 69 73 74 69 63 73 20 66 6f 72  racteristics for
21fa0 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a   the file..**.**
21fb0 20 54 68 69 73 20 56 46 53 20 69 73 20 73 65 74   This VFS is set
21fc0 20 75 70 20 74 6f 20 72 65 74 75 72 6e 20 53 51   up to return SQ
21fd0 4c 49 54 45 5f 49 4f 43 41 50 5f 50 4f 57 45 52  LITE_IOCAP_POWER
21fe0 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 20 62  SAFE_OVERWRITE b
21ff0 79 20 64 65 66 61 75 6c 74 2e 0a 2a 2a 20 48 6f  y default..** Ho
22000 77 65 76 65 72 2c 20 74 68 61 74 20 63 68 6f 69  wever, that choi
22010 63 65 20 69 73 20 63 6f 6e 74 72 6f 76 65 72 73  ce is controvers
22020 69 61 6c 20 73 69 6e 63 65 20 74 65 63 68 6e 69  ial since techni
22030 63 61 6c 6c 79 20 74 68 65 20 75 6e 64 65 72 6c  cally the underl
22040 79 69 6e 67 0a 2a 2a 20 66 69 6c 65 20 73 79 73  ying.** file sys
22050 74 65 6d 20 64 6f 65 73 20 6e 6f 74 20 61 6c 77  tem does not alw
22060 61 79 73 20 70 72 6f 76 69 64 65 20 70 6f 77 65  ays provide powe
22070 72 73 61 66 65 20 6f 76 65 72 77 72 69 74 65 73  rsafe overwrites
22080 2e 20 20 28 49 6e 20 6f 74 68 65 72 0a 2a 2a 20  .  (In other.** 
22090 77 6f 72 64 73 2c 20 61 66 74 65 72 20 61 20 70  words, after a p
220a0 6f 77 65 72 2d 6c 6f 73 73 20 65 76 65 6e 74 2c  ower-loss event,
220b0 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 66 69   parts of the fi
220c0 6c 65 20 74 68 61 74 20 77 65 72 65 20 6e 65 76  le that were nev
220d0 65 72 0a 2a 2a 20 77 72 69 74 74 65 6e 20 6d 69  er.** written mi
220e0 67 68 74 20 65 6e 64 20 75 70 20 62 65 69 6e 67  ght end up being
220f0 20 61 6c 74 65 72 65 64 2e 29 20 20 48 6f 77 65   altered.)  Howe
22100 76 65 72 2c 20 6e 6f 6e 2d 50 53 4f 57 20 62 65  ver, non-PSOW be
22110 68 61 76 69 6f 72 20 69 73 20 76 65 72 79 2c 0a  havior is very,.
22120 2a 2a 20 76 65 72 79 20 72 61 72 65 2e 20 20 41  ** very rare.  A
22130 6e 64 20 61 73 73 65 72 74 69 6e 67 20 50 53 4f  nd asserting PSO
22140 57 20 6d 61 6b 65 73 20 61 20 6c 61 72 67 65 20  W makes a large 
22150 72 65 64 75 63 74 69 6f 6e 20 69 6e 20 74 68 65  reduction in the
22160 20 61 6d 6f 75 6e 74 0a 2a 2a 20 6f 66 20 72 65   amount.** of re
22170 71 75 69 72 65 64 20 49 2f 4f 20 66 6f 72 20 6a  quired I/O for j
22180 6f 75 72 6e 61 6c 69 6e 67 2c 20 73 69 6e 63 65  ournaling, since
22190 20 61 20 6c 6f 74 20 6f 66 20 70 61 64 64 69 6e   a lot of paddin
221a0 67 20 69 73 20 65 6c 69 6d 69 6e 61 74 65 64 2e  g is eliminated.
221b0 0a 2a 2a 20 20 48 65 6e 63 65 2c 20 77 68 69 6c  .**  Hence, whil
221c0 65 20 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52  e POWERSAFE_OVER
221d0 57 52 49 54 45 20 69 73 20 6f 6e 20 62 79 20 64  WRITE is on by d
221e0 65 66 61 75 6c 74 2c 20 74 68 65 72 65 20 69 73  efault, there is
221f0 20 61 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 0a   a file-control.
22200 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20  ** available to 
22210 74 75 72 6e 20 69 74 20 6f 66 66 20 61 6e 64 20  turn it off and 
22220 55 52 49 20 71 75 65 72 79 20 70 61 72 61 6d 65  URI query parame
22230 74 65 72 20 61 76 61 69 6c 61 62 6c 65 20 74 6f  ter available to
22240 20 74 75 72 6e 20 69 74 20 6f 66 66 2e 0a 2a 2f   turn it off..*/
22250 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78  .static int unix
22260 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69  DeviceCharacteri
22270 73 74 69 63 73 28 73 71 6c 69 74 65 33 5f 66 69  stics(sqlite3_fi
22280 6c 65 20 2a 69 64 29 7b 0a 20 20 75 6e 69 78 46  le *id){.  unixF
22290 69 6c 65 20 2a 70 46 64 20 3d 20 28 75 6e 69 78  ile *pFd = (unix
222a0 46 69 6c 65 2a 29 69 64 3b 0a 20 20 73 65 74 44  File*)id;.  setD
222b0 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
222c0 74 69 63 73 28 70 46 64 29 3b 0a 20 20 72 65 74  tics(pFd);.  ret
222d0 75 72 6e 20 70 46 64 2d 3e 64 65 76 69 63 65 43  urn pFd->deviceC
222e0 68 61 72 61 63 74 65 72 69 73 74 69 63 73 3b 0a  haracteristics;.
222f0 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28  }..#if !defined(
22300 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29  SQLITE_OMIT_WAL)
22310 20 7c 7c 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d   || SQLITE_MAX_M
22320 4d 41 50 5f 53 49 5a 45 3e 30 0a 0a 2f 2a 0a 2a  MAP_SIZE>0../*.*
22330 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 79 73  * Return the sys
22340 74 65 6d 20 70 61 67 65 20 73 69 7a 65 2e 0a 2a  tem page size..*
22350 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
22360 6f 6e 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65  on should not be
22370 20 63 61 6c 6c 65 64 20 64 69 72 65 63 74 6c 79   called directly
22380 20 62 79 20 6f 74 68 65 72 20 63 6f 64 65 20 69   by other code i
22390 6e 20 74 68 69 73 20 66 69 6c 65 2e 20 0a 2a 2a  n this file. .**
223a0 20 49 6e 73 74 65 61 64 2c 20 69 74 20 73 68 6f   Instead, it sho
223b0 75 6c 64 20 62 65 20 63 61 6c 6c 65 64 20 76 69  uld be called vi
223c0 61 20 6d 61 63 72 6f 20 6f 73 47 65 74 70 61 67  a macro osGetpag
223d0 65 73 69 7a 65 28 29 2e 0a 2a 2f 0a 73 74 61 74  esize()..*/.stat
223e0 69 63 20 69 6e 74 20 75 6e 69 78 47 65 74 70 61  ic int unixGetpa
223f0 67 65 73 69 7a 65 28 76 6f 69 64 29 7b 0a 23 69  gesize(void){.#i
22400 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20 72  f OS_VXWORKS.  r
22410 65 74 75 72 6e 20 31 30 32 34 3b 0a 23 65 6c 69  eturn 1024;.#eli
22420 66 20 64 65 66 69 6e 65 64 28 5f 42 53 44 5f 53  f defined(_BSD_S
22430 4f 55 52 43 45 29 0a 20 20 72 65 74 75 72 6e 20  OURCE).  return 
22440 67 65 74 70 61 67 65 73 69 7a 65 28 29 3b 0a 23  getpagesize();.#
22450 65 6c 73 65 0a 20 20 72 65 74 75 72 6e 20 28 69  else.  return (i
22460 6e 74 29 73 79 73 63 6f 6e 66 28 5f 53 43 5f 50  nt)sysconf(_SC_P
22470 41 47 45 53 49 5a 45 29 3b 0a 23 65 6e 64 69 66  AGESIZE);.#endif
22480 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 21 64  .}..#endif /* !d
22490 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d  efined(SQLITE_OM
224a0 49 54 5f 57 41 4c 29 20 7c 7c 20 53 51 4c 49 54  IT_WAL) || SQLIT
224b0 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e  E_MAX_MMAP_SIZE>
224c0 30 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51  0 */..#ifndef SQ
224d0 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 0a 2f  LITE_OMIT_WAL../
224e0 2a 0a 2a 2a 20 4f 62 6a 65 63 74 20 75 73 65 64  *.** Object used
224f0 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 61 6e   to represent an
22500 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 62   shared memory b
22510 75 66 66 65 72 2e 20 20 0a 2a 2a 0a 2a 2a 20 57  uffer.  .**.** W
22520 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 74 68 72  hen multiple thr
22530 65 61 64 73 20 61 6c 6c 20 72 65 66 65 72 65 6e  eads all referen
22540 63 65 20 74 68 65 20 73 61 6d 65 20 77 61 6c 2d  ce the same wal-
22550 69 6e 64 65 78 2c 20 65 61 63 68 20 74 68 72 65  index, each thre
22560 61 64 0a 2a 2a 20 68 61 73 20 69 74 73 20 6f 77  ad.** has its ow
22570 6e 20 75 6e 69 78 53 68 6d 20 6f 62 6a 65 63 74  n unixShm object
22580 2c 20 62 75 74 20 74 68 65 79 20 61 6c 6c 20 70  , but they all p
22590 6f 69 6e 74 20 74 6f 20 61 20 73 69 6e 67 6c 65  oint to a single
225a0 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20   instance.** of 
225b0 74 68 69 73 20 75 6e 69 78 53 68 6d 4e 6f 64 65  this unixShmNode
225c0 20 6f 62 6a 65 63 74 2e 20 20 49 6e 20 6f 74 68   object.  In oth
225d0 65 72 20 77 6f 72 64 73 2c 20 65 61 63 68 20 77  er words, each w
225e0 61 6c 2d 69 6e 64 65 78 20 69 73 20 6f 70 65 6e  al-index is open
225f0 65 64 0a 2a 2a 20 6f 6e 6c 79 20 6f 6e 63 65 20  ed.** only once 
22600 70 65 72 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a  per process..**.
22610 2a 2a 20 45 61 63 68 20 75 6e 69 78 53 68 6d 4e  ** Each unixShmN
22620 6f 64 65 20 6f 62 6a 65 63 74 20 69 73 20 63 6f  ode object is co
22630 6e 6e 65 63 74 65 64 20 74 6f 20 61 20 73 69 6e  nnected to a sin
22640 67 6c 65 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66  gle unixInodeInf
22650 6f 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 57 65 20  o object..** We 
22660 63 6f 75 6c 64 20 63 6f 61 6c 65 73 63 65 20 74  could coalesce t
22670 68 69 73 20 6f 62 6a 65 63 74 20 69 6e 74 6f 20  his object into 
22680 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f 2c 20 62  unixInodeInfo, b
22690 75 74 20 74 68 61 74 20 77 6f 75 6c 64 20 6d 65  ut that would me
226a0 61 6e 0a 2a 2a 20 65 76 65 72 79 20 6f 70 65 6e  an.** every open
226b0 20 66 69 6c 65 20 74 68 61 74 20 64 6f 65 73 20   file that does 
226c0 6e 6f 74 20 75 73 65 20 73 68 61 72 65 64 20 6d  not use shared m
226d0 65 6d 6f 72 79 20 28 69 6e 20 6f 74 68 65 72 20  emory (in other 
226e0 77 6f 72 64 73 2c 20 6d 6f 73 74 0a 2a 2a 20 6f  words, most.** o
226f0 70 65 6e 20 66 69 6c 65 73 29 20 77 6f 75 6c 64  pen files) would
22700 20 68 61 76 65 20 74 6f 20 63 61 72 72 79 20 61   have to carry a
22710 72 6f 75 6e 64 20 74 68 69 73 20 65 78 74 72 61  round this extra
22720 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 53   information.  S
22730 6f 0a 2a 2a 20 74 68 65 20 75 6e 69 78 49 6e 6f  o.** the unixIno
22740 64 65 49 6e 66 6f 20 6f 62 6a 65 63 74 20 63 6f  deInfo object co
22750 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72  ntains a pointer
22760 20 74 6f 20 74 68 69 73 20 75 6e 69 78 53 68 6d   to this unixShm
22770 4e 6f 64 65 20 6f 62 6a 65 63 74 0a 2a 2a 20 61  Node object.** a
22780 6e 64 20 74 68 65 20 75 6e 69 78 53 68 6d 4e 6f  nd the unixShmNo
22790 64 65 20 6f 62 6a 65 63 74 20 69 73 20 63 72 65  de object is cre
227a0 61 74 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 6e  ated only when n
227b0 65 65 64 65 64 2e 0a 2a 2a 0a 2a 2a 20 75 6e 69  eeded..**.** uni
227c0 78 4d 75 74 65 78 48 65 6c 64 28 29 20 6d 75 73  xMutexHeld() mus
227d0 74 20 62 65 20 74 72 75 65 20 77 68 65 6e 20 63  t be true when c
227e0 72 65 61 74 69 6e 67 20 6f 72 20 64 65 73 74 72  reating or destr
227f0 6f 79 69 6e 67 0a 2a 2a 20 74 68 69 73 20 6f 62  oying.** this ob
22800 6a 65 63 74 20 6f 72 20 77 68 69 6c 65 20 72 65  ject or while re
22810 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67  ading or writing
22820 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66   the following f
22830 69 65 6c 64 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  ields:.**.**    
22840 20 20 6e 52 65 66 0a 2a 2a 0a 2a 2a 20 54 68 65    nRef.**.** The
22850 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 69 65 6c 64   following field
22860 73 20 61 72 65 20 72 65 61 64 2d 6f 6e 6c 79 20  s are read-only 
22870 61 66 74 65 72 20 74 68 65 20 6f 62 6a 65 63 74  after the object
22880 20 69 73 20 63 72 65 61 74 65 64 3a 0a 2a 2a 20   is created:.** 
22890 0a 2a 2a 20 20 20 20 20 20 68 53 68 6d 0a 2a 2a  .**      hShm.**
228a0 20 20 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 0a        zFilename.
228b0 2a 2a 0a 2a 2a 20 45 69 74 68 65 72 20 75 6e 69  **.** Either uni
228c0 78 53 68 6d 4e 6f 64 65 2e 70 53 68 6d 4d 75 74  xShmNode.pShmMut
228d0 65 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20  ex must be held 
228e0 6f 72 20 75 6e 69 78 53 68 6d 4e 6f 64 65 2e 6e  or unixShmNode.n
228f0 52 65 66 3d 3d 30 20 61 6e 64 0a 2a 2a 20 75 6e  Ref==0 and.** un
22900 69 78 4d 75 74 65 78 48 65 6c 64 28 29 20 69 73  ixMutexHeld() is
22910 20 74 72 75 65 20 77 68 65 6e 20 72 65 61 64 69   true when readi
22920 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 20 61 6e  ng or writing an
22930 79 20 6f 74 68 65 72 20 66 69 65 6c 64 0a 2a 2a  y other field.**
22940 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75   in this structu
22950 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 75 6e  re..*/.struct un
22960 69 78 53 68 6d 4e 6f 64 65 20 7b 0a 20 20 75 6e  ixShmNode {.  un
22970 69 78 49 6e 6f 64 65 49 6e 66 6f 20 2a 70 49 6e  ixInodeInfo *pIn
22980 6f 64 65 3b 20 20 20 20 20 2f 2a 20 75 6e 69 78  ode;     /* unix
22990 49 6e 6f 64 65 49 6e 66 6f 20 74 68 61 74 20 6f  InodeInfo that o
229a0 77 6e 73 20 74 68 69 73 20 53 48 4d 20 6e 6f 64  wns this SHM nod
229b0 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d  e */.  sqlite3_m
229c0 75 74 65 78 20 2a 70 53 68 6d 4d 75 74 65 78 3b  utex *pShmMutex;
229d0 20 20 2f 2a 20 4d 75 74 65 78 20 74 6f 20 61 63    /* Mutex to ac
229e0 63 65 73 73 20 74 68 69 73 20 6f 62 6a 65 63 74  cess this object
229f0 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c   */.  char *zFil
22a00 65 6e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20  ename;          
22a10 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20   /* Name of the 
22a20 6d 6d 61 70 70 65 64 20 66 69 6c 65 20 2a 2f 0a  mmapped file */.
22a30 20 20 69 6e 74 20 68 53 68 6d 3b 20 20 20 20 20    int hShm;     
22a40 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
22a50 4f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69  Open file descri
22a60 70 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  ptor */.  int sz
22a70 52 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 20 20  Region;         
22a80 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
22a90 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 72 65  shared-memory re
22aa0 67 69 6f 6e 73 20 2a 2f 0a 20 20 75 31 36 20 6e  gions */.  u16 n
22ab0 52 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 20 20  Region;         
22ac0 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66        /* Size of
22ad0 20 61 72 72 61 79 20 61 70 52 65 67 69 6f 6e 20   array apRegion 
22ae0 2a 2f 0a 20 20 75 38 20 69 73 52 65 61 64 6f 6e  */.  u8 isReadon
22af0 6c 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ly;             
22b00 2f 2a 20 54 72 75 65 20 69 66 20 72 65 61 64 2d  /* True if read-
22b10 6f 6e 6c 79 20 2a 2f 0a 20 20 75 38 20 69 73 55  only */.  u8 isU
22b20 6e 6c 6f 63 6b 65 64 3b 20 20 20 20 20 20 20 20  nlocked;        
22b30 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
22b40 6e 6f 20 44 4d 53 20 6c 6f 63 6b 20 68 65 6c 64  no DMS lock held
22b50 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 61 70 52   */.  char **apR
22b60 65 67 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20  egion;          
22b70 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 6d 61 70   /* Array of map
22b80 70 65 64 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72  ped shared-memor
22b90 79 20 72 65 67 69 6f 6e 73 20 2a 2f 0a 20 20 69  y regions */.  i
22ba0 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20  nt nRef;        
22bb0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
22bc0 62 65 72 20 6f 66 20 75 6e 69 78 53 68 6d 20 6f  ber of unixShm o
22bd0 62 6a 65 63 74 73 20 70 6f 69 6e 74 69 6e 67 20  bjects pointing 
22be0 74 6f 20 74 68 69 73 20 2a 2f 0a 20 20 75 6e 69  to this */.  uni
22bf0 78 53 68 6d 20 2a 70 46 69 72 73 74 3b 20 20 20  xShm *pFirst;   
22c00 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 75          /* All u
22c10 6e 69 78 53 68 6d 20 6f 62 6a 65 63 74 73 20 70  nixShm objects p
22c20 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 69 73 20  ointing to this 
22c30 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
22c40 5f 44 45 42 55 47 0a 20 20 75 38 20 65 78 63 6c  _DEBUG.  u8 excl
22c50 4d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 20 20  Mask;           
22c60 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 65      /* Mask of e
22c70 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 73 20 68  xclusive locks h
22c80 65 6c 64 20 2a 2f 0a 20 20 75 38 20 73 68 61 72  eld */.  u8 shar
22c90 65 64 4d 61 73 6b 3b 20 20 20 20 20 20 20 20 20  edMask;         
22ca0 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 73      /* Mask of s
22cb0 68 61 72 65 64 20 6c 6f 63 6b 73 20 68 65 6c 64  hared locks held
22cc0 20 2a 2f 0a 20 20 75 38 20 6e 65 78 74 53 68 6d   */.  u8 nextShm
22cd0 49 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  Id;             
22ce0 20 2f 2a 20 4e 65 78 74 20 61 76 61 69 6c 61 62   /* Next availab
22cf0 6c 65 20 75 6e 69 78 53 68 6d 2e 69 64 20 76 61  le unixShm.id va
22d00 6c 75 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b  lue */.#endif.};
22d10 0a 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72  ../*.** Structur
22d20 65 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c  e used internall
22d30 79 20 62 79 20 74 68 69 73 20 56 46 53 20 74 6f  y by this VFS to
22d40 20 72 65 63 6f 72 64 20 74 68 65 20 73 74 61 74   record the stat
22d50 65 20 6f 66 20 61 6e 0a 2a 2a 20 6f 70 65 6e 20  e of an.** open 
22d60 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 63 6f  shared memory co
22d70 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20  nnection..**.** 
22d80 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 69  The following fi
22d90 65 6c 64 73 20 61 72 65 20 69 6e 69 74 69 61 6c  elds are initial
22da0 69 7a 65 64 20 77 68 65 6e 20 74 68 69 73 20 6f  ized when this o
22db0 62 6a 65 63 74 20 69 73 20 63 72 65 61 74 65 64  bject is created
22dc0 20 61 6e 64 0a 2a 2a 20 61 72 65 20 72 65 61 64   and.** are read
22dd0 2d 6f 6e 6c 79 20 74 68 65 72 65 61 66 74 65 72  -only thereafter
22de0 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 75 6e 69 78 53  :.**.**    unixS
22df0 68 6d 2e 70 53 68 6d 4e 6f 64 65 0a 2a 2a 20 20  hm.pShmNode.**  
22e00 20 20 75 6e 69 78 53 68 6d 2e 69 64 0a 2a 2a 0a    unixShm.id.**.
22e10 2a 2a 20 41 6c 6c 20 6f 74 68 65 72 20 66 69 65  ** All other fie
22e20 6c 64 73 20 61 72 65 20 72 65 61 64 2f 77 72 69  lds are read/wri
22e30 74 65 2e 20 20 54 68 65 20 75 6e 69 78 53 68 6d  te.  The unixShm
22e40 2e 70 53 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d  .pShmNode->pShmM
22e50 75 74 65 78 20 6d 75 73 74 0a 2a 2a 20 62 65 20  utex must.** be 
22e60 68 65 6c 64 20 77 68 69 6c 65 20 61 63 63 65 73  held while acces
22e70 73 69 6e 67 20 61 6e 79 20 72 65 61 64 2f 77 72  sing any read/wr
22e80 69 74 65 20 66 69 65 6c 64 73 2e 0a 2a 2f 0a 73  ite fields..*/.s
22e90 74 72 75 63 74 20 75 6e 69 78 53 68 6d 20 7b 0a  truct unixShm {.
22ea0 20 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70    unixShmNode *p
22eb0 53 68 6d 4e 6f 64 65 3b 20 20 20 20 20 2f 2a 20  ShmNode;     /* 
22ec0 54 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 75  The underlying u
22ed0 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62 6a 65 63  nixShmNode objec
22ee0 74 20 2a 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a  t */.  unixShm *
22ef0 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 20  pNext;          
22f00 20 20 2f 2a 20 4e 65 78 74 20 75 6e 69 78 53 68    /* Next unixSh
22f10 6d 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20  m with the same 
22f20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 2f 0a 20  unixShmNode */. 
22f30 20 75 38 20 68 61 73 4d 75 74 65 78 3b 20 20 20   u8 hasMutex;   
22f40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
22f50 72 75 65 20 69 66 20 68 6f 6c 64 69 6e 67 20 74  rue if holding t
22f60 68 65 20 75 6e 69 78 53 68 6d 4e 6f 64 65 2d 3e  he unixShmNode->
22f70 70 53 68 6d 4d 75 74 65 78 20 2a 2f 0a 20 20 75  pShmMutex */.  u
22f80 38 20 69 64 3b 20 20 20 20 20 20 20 20 20 20 20  8 id;           
22f90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 64 20            /* Id 
22fa0 6f 66 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 69  of this connecti
22fb0 6f 6e 20 77 69 74 68 69 6e 20 69 74 73 20 75 6e  on within its un
22fc0 69 78 53 68 6d 4e 6f 64 65 20 2a 2f 0a 20 20 75  ixShmNode */.  u
22fd0 31 36 20 73 68 61 72 65 64 4d 61 73 6b 3b 20 20  16 sharedMask;  
22fe0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73            /* Mas
22ff0 6b 20 6f 66 20 73 68 61 72 65 64 20 6c 6f 63 6b  k of shared lock
23000 73 20 68 65 6c 64 20 2a 2f 0a 20 20 75 31 36 20  s held */.  u16 
23010 65 78 63 6c 4d 61 73 6b 3b 20 20 20 20 20 20 20  exclMask;       
23020 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f         /* Mask o
23030 66 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b  f exclusive lock
23040 73 20 68 65 6c 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a  s held */.};../*
23050 0a 2a 2a 20 43 6f 6e 73 74 61 6e 74 73 20 75 73  .** Constants us
23060 65 64 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 0a 2a  ed for locking.*
23070 2f 0a 23 64 65 66 69 6e 65 20 55 4e 49 58 5f 53  /.#define UNIX_S
23080 48 4d 5f 42 41 53 45 20 20 20 28 28 32 32 2b 53  HM_BASE   ((22+S
23090 51 4c 49 54 45 5f 53 48 4d 5f 4e 4c 4f 43 4b 29  QLITE_SHM_NLOCK)
230a0 2a 34 29 20 20 20 20 20 20 20 20 20 2f 2a 20 66  *4)         /* f
230b0 69 72 73 74 20 6c 6f 63 6b 20 62 79 74 65 20 2a  irst lock byte *
230c0 2f 0a 23 64 65 66 69 6e 65 20 55 4e 49 58 5f 53  /.#define UNIX_S
230d0 48 4d 5f 44 4d 53 20 20 20 20 28 55 4e 49 58 5f  HM_DMS    (UNIX_
230e0 53 48 4d 5f 42 41 53 45 2b 53 51 4c 49 54 45 5f  SHM_BASE+SQLITE_
230f0 53 48 4d 5f 4e 4c 4f 43 4b 29 20 20 2f 2a 20 64  SHM_NLOCK)  /* d
23100 65 61 64 6d 61 6e 20 73 77 69 74 63 68 20 2a 2f  eadman switch */
23110 0a 0a 2f 2a 0a 2a 2a 20 41 70 70 6c 79 20 70 6f  ../*.** Apply po
23120 73 69 78 20 61 64 76 69 73 6f 72 79 20 6c 6f 63  six advisory loc
23130 6b 73 20 66 6f 72 20 61 6c 6c 20 62 79 74 65 73  ks for all bytes
23140 20 66 72 6f 6d 20 6f 66 73 74 20 74 68 72 6f 75   from ofst throu
23150 67 68 20 6f 66 73 74 2b 6e 2d 31 2e 0a 2a 2a 0a  gh ofst+n-1..**.
23160 2a 2a 20 4c 6f 63 6b 73 20 62 6c 6f 63 6b 20 69  ** Locks block i
23170 66 20 74 68 65 20 6d 61 73 6b 20 69 73 20 65 78  f the mask is ex
23180 61 63 74 6c 79 20 55 4e 49 58 5f 53 48 4d 5f 43  actly UNIX_SHM_C
23190 20 61 6e 64 20 61 72 65 20 6e 6f 6e 2d 62 6c 6f   and are non-blo
231a0 63 6b 69 6e 67 0a 2a 2a 20 6f 74 68 65 72 77 69  cking.** otherwi
231b0 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  se..*/.static in
231c0 74 20 75 6e 69 78 53 68 6d 53 79 73 74 65 6d 4c  t unixShmSystemL
231d0 6f 63 6b 28 0a 20 20 75 6e 69 78 46 69 6c 65 20  ock(.  unixFile 
231e0 2a 70 46 69 6c 65 2c 20 20 20 20 20 20 20 2f 2a  *pFile,       /*
231f0 20 4f 70 65 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e   Open connection
23200 20 74 6f 20 74 68 65 20 57 41 4c 20 66 69 6c 65   to the WAL file
23210 20 2a 2f 0a 20 20 69 6e 74 20 6c 6f 63 6b 54 79   */.  int lockTy
23220 70 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  pe,          /* 
23230 46 5f 55 4e 4c 43 4b 2c 20 46 5f 52 44 4c 43 4b  F_UNLCK, F_RDLCK
23240 2c 20 6f 72 20 46 5f 57 52 4c 43 4b 20 2a 2f 0a  , or F_WRLCK */.
23250 20 20 69 6e 74 20 6f 66 73 74 2c 20 20 20 20 20    int ofst,     
23260 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73           /* Firs
23270 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 6c 6f  t byte of the lo
23280 63 6b 69 6e 67 20 72 61 6e 67 65 20 2a 2f 0a 20  cking range */. 
23290 20 69 6e 74 20 6e 20 20 20 20 20 20 20 20 20 20   int n          
232a0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
232b0 72 20 6f 66 20 62 79 74 65 73 20 74 6f 20 6c 6f  r of bytes to lo
232c0 63 6b 20 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 53  ck */.){.  unixS
232d0 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f 64 65  hmNode *pShmNode
232e0 3b 20 2f 2a 20 41 70 70 6c 79 20 6c 6f 63 6b 73  ; /* Apply locks
232f0 20 74 6f 20 74 68 69 73 20 6f 70 65 6e 20 73 68   to this open sh
23300 61 72 65 64 2d 6d 65 6d 6f 72 79 20 73 65 67 6d  ared-memory segm
23310 65 6e 74 20 2a 2f 0a 20 20 73 74 72 75 63 74 20  ent */.  struct 
23320 66 6c 6f 63 6b 20 66 3b 20 20 20 20 20 20 20 20  flock f;        
23330 2f 2a 20 54 68 65 20 70 6f 73 69 78 20 61 64 76  /* The posix adv
23340 69 73 6f 72 79 20 6c 6f 63 6b 69 6e 67 20 73 74  isory locking st
23350 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 69 6e 74  ructure */.  int
23360 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
23370 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f      /* Result co
23380 64 65 20 66 6f 72 6d 20 66 63 6e 74 6c 28 29 20  de form fcntl() 
23390 2a 2f 0a 0a 20 20 2f 2a 20 41 63 63 65 73 73 20  */..  /* Access 
233a0 74 6f 20 74 68 65 20 75 6e 69 78 53 68 6d 4e 6f  to the unixShmNo
233b0 64 65 20 6f 62 6a 65 63 74 20 69 73 20 73 65 72  de object is ser
233c0 69 61 6c 69 7a 65 64 20 62 79 20 74 68 65 20 63  ialized by the c
233d0 61 6c 6c 65 72 20 2a 2f 0a 20 20 70 53 68 6d 4e  aller */.  pShmN
233e0 6f 64 65 20 3d 20 70 46 69 6c 65 2d 3e 70 49 6e  ode = pFile->pIn
233f0 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 3b 0a 20  ode->pShmNode;. 
23400 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f 64   assert( pShmNod
23410 65 2d 3e 6e 52 65 66 3d 3d 30 20 7c 7c 20 73 71  e->nRef==0 || sq
23420 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
23430 28 70 53 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d  (pShmNode->pShmM
23440 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72  utex) );.  asser
23450 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65  t( pShmNode->nRe
23460 66 3e 30 20 7c 7c 20 75 6e 69 78 4d 75 74 65 78  f>0 || unixMutex
23470 48 65 6c 64 28 29 20 29 3b 0a 0a 20 20 2f 2a 20  Held() );..  /* 
23480 53 68 61 72 65 64 20 6c 6f 63 6b 73 20 6e 65 76  Shared locks nev
23490 65 72 20 73 70 61 6e 20 6d 6f 72 65 20 74 68 61  er span more tha
234a0 6e 20 6f 6e 65 20 62 79 74 65 20 2a 2f 0a 20 20  n one byte */.  
234b0 61 73 73 65 72 74 28 20 6e 3d 3d 31 20 7c 7c 20  assert( n==1 || 
234c0 6c 6f 63 6b 54 79 70 65 21 3d 46 5f 52 44 4c 43  lockType!=F_RDLC
234d0 4b 20 29 3b 0a 0a 20 20 2f 2a 20 4c 6f 63 6b 73  K );..  /* Locks
234e0 20 61 72 65 20 77 69 74 68 69 6e 20 72 61 6e 67   are within rang
234f0 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 6e  e */.  assert( n
23500 3e 3d 31 20 26 26 20 6e 3c 3d 53 51 4c 49 54 45  >=1 && n<=SQLITE
23510 5f 53 48 4d 5f 4e 4c 4f 43 4b 20 29 3b 0a 0a 20  _SHM_NLOCK );.. 
23520 20 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 68   if( pShmNode->h
23530 53 68 6d 3e 3d 30 20 29 7b 0a 20 20 20 20 2f 2a  Shm>=0 ){.    /*
23540 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20   Initialize the 
23550 6c 6f 63 6b 69 6e 67 20 70 61 72 61 6d 65 74 65  locking paramete
23560 72 73 20 2a 2f 0a 20 20 20 20 66 2e 6c 5f 74 79  rs */.    f.l_ty
23570 70 65 20 3d 20 6c 6f 63 6b 54 79 70 65 3b 0a 20  pe = lockType;. 
23580 20 20 20 66 2e 6c 5f 77 68 65 6e 63 65 20 3d 20     f.l_whence = 
23590 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 66 2e  SEEK_SET;.    f.
235a0 6c 5f 73 74 61 72 74 20 3d 20 6f 66 73 74 3b 0a  l_start = ofst;.
235b0 20 20 20 20 66 2e 6c 5f 6c 65 6e 20 3d 20 6e 3b      f.l_len = n;
235c0 0a 20 20 20 20 72 63 20 3d 20 6f 73 53 65 74 50  .    rc = osSetP
235d0 6f 73 69 78 41 64 76 69 73 6f 72 79 4c 6f 63 6b  osixAdvisoryLock
235e0 28 70 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 2c  (pShmNode->hShm,
235f0 20 26 66 2c 20 70 46 69 6c 65 29 3b 0a 20 20 20   &f, pFile);.   
23600 20 72 63 20 3d 20 28 72 63 21 3d 28 2d 31 29 29   rc = (rc!=(-1))
23610 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53   ? SQLITE_OK : S
23620 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a  QLITE_BUSY;.  }.
23630 0a 20 20 2f 2a 20 55 70 64 61 74 65 20 74 68 65  .  /* Update the
23640 20 67 6c 6f 62 61 6c 20 6c 6f 63 6b 20 73 74 61   global lock sta
23650 74 65 20 61 6e 64 20 64 6f 20 64 65 62 75 67 20  te and do debug 
23660 74 72 61 63 69 6e 67 20 2a 2f 0a 23 69 66 64 65  tracing */.#ifde
23670 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20  f SQLITE_DEBUG. 
23680 20 7b 20 75 31 36 20 6d 61 73 6b 3b 0a 20 20 4f   { u16 mask;.  O
23690 53 54 52 41 43 45 28 28 22 53 48 4d 2d 4c 4f 43  STRACE(("SHM-LOC
236a0 4b 20 22 29 29 3b 0a 20 20 6d 61 73 6b 20 3d 20  K "));.  mask = 
236b0 6f 66 73 74 3e 33 31 20 3f 20 30 78 66 66 66 66  ofst>31 ? 0xffff
236c0 20 3a 20 28 31 3c 3c 28 6f 66 73 74 2b 6e 29 29   : (1<<(ofst+n))
236d0 20 2d 20 28 31 3c 3c 6f 66 73 74 29 3b 0a 20 20   - (1<<ofst);.  
236e0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
236f0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63  K ){.    if( loc
23700 6b 54 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29  kType==F_UNLCK )
23710 7b 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28  {.      OSTRACE(
23720 28 22 75 6e 6c 6f 63 6b 20 25 64 20 6f 6b 22 2c  ("unlock %d ok",
23730 20 6f 66 73 74 29 29 3b 0a 20 20 20 20 20 20 70   ofst));.      p
23740 53 68 6d 4e 6f 64 65 2d 3e 65 78 63 6c 4d 61 73  ShmNode->exclMas
23750 6b 20 26 3d 20 7e 6d 61 73 6b 3b 0a 20 20 20 20  k &= ~mask;.    
23760 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 68 61 72    pShmNode->shar
23770 65 64 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b  edMask &= ~mask;
23780 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6c  .    }else if( l
23790 6f 63 6b 54 79 70 65 3d 3d 46 5f 52 44 4c 43 4b  ockType==F_RDLCK
237a0 20 29 7b 0a 20 20 20 20 20 20 4f 53 54 52 41 43   ){.      OSTRAC
237b0 45 28 28 22 72 65 61 64 2d 6c 6f 63 6b 20 25 64  E(("read-lock %d
237c0 20 6f 6b 22 2c 20 6f 66 73 74 29 29 3b 0a 20 20   ok", ofst));.  
237d0 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78      pShmNode->ex
237e0 63 6c 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b  clMask &= ~mask;
237f0 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d  .      pShmNode-
23800 3e 73 68 61 72 65 64 4d 61 73 6b 20 7c 3d 20 6d  >sharedMask |= m
23810 61 73 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ask;.    }else{.
23820 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 6f        assert( lo
23830 63 6b 54 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20  ckType==F_WRLCK 
23840 29 3b 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45  );.      OSTRACE
23850 28 28 22 77 72 69 74 65 2d 6c 6f 63 6b 20 25 64  (("write-lock %d
23860 20 6f 6b 22 2c 20 6f 66 73 74 29 29 3b 0a 20 20   ok", ofst));.  
23870 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78      pShmNode->ex
23880 63 6c 4d 61 73 6b 20 7c 3d 20 6d 61 73 6b 3b 0a  clMask |= mask;.
23890 20 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e        pShmNode->
238a0 73 68 61 72 65 64 4d 61 73 6b 20 26 3d 20 7e 6d  sharedMask &= ~m
238b0 61 73 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c  ask;.    }.  }el
238c0 73 65 7b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b  se{.    if( lock
238d0 54 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20 29 7b  Type==F_UNLCK ){
238e0 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28 28  .      OSTRACE((
238f0 22 75 6e 6c 6f 63 6b 20 25 64 20 66 61 69 6c 65  "unlock %d faile
23900 64 22 2c 20 6f 66 73 74 29 29 3b 0a 20 20 20 20  d", ofst));.    
23910 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b 54 79  }else if( lockTy
23920 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a 20  pe==F_RDLCK ){. 
23930 20 20 20 20 20 4f 53 54 52 41 43 45 28 28 22 72       OSTRACE(("r
23940 65 61 64 2d 6c 6f 63 6b 20 66 61 69 6c 65 64 22  ead-lock failed"
23950 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ));.    }else{. 
23960 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 6f 63       assert( loc
23970 6b 54 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20 29  kType==F_WRLCK )
23980 3b 0a 20 20 20 20 20 20 4f 53 54 52 41 43 45 28  ;.      OSTRACE(
23990 28 22 77 72 69 74 65 2d 6c 6f 63 6b 20 25 64 20  ("write-lock %d 
239a0 66 61 69 6c 65 64 22 2c 20 6f 66 73 74 29 29 3b  failed", ofst));
239b0 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 4f 53 54  .    }.  }.  OST
239c0 52 41 43 45 28 28 22 20 2d 20 61 66 74 65 72 77  RACE((" - afterw
239d0 61 72 64 73 20 25 30 33 78 2c 25 30 33 78 5c 6e  ards %03x,%03x\n
239e0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70 53  ",.           pS
239f0 68 6d 4e 6f 64 65 2d 3e 73 68 61 72 65 64 4d 61  hmNode->sharedMa
23a00 73 6b 2c 20 70 53 68 6d 4e 6f 64 65 2d 3e 65 78  sk, pShmNode->ex
23a10 63 6c 4d 61 73 6b 29 29 3b 0a 20 20 7d 0a 23 65  clMask));.  }.#e
23a20 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72  ndif..  return r
23a30 63 3b 20 20 20 20 20 20 20 20 0a 7d 0a 0a 2f 2a  c;        .}../*
23a40 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6d  .** Return the m
23a50 69 6e 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  inimum number of
23a60 20 33 32 4b 42 20 73 68 6d 20 72 65 67 69 6f 6e   32KB shm region
23a70 73 20 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65  s that should be
23a80 20 6d 61 70 70 65 64 20 61 74 0a 2a 2a 20 61 20   mapped at.** a 
23a90 74 69 6d 65 2c 20 61 73 73 75 6d 69 6e 67 20 74  time, assuming t
23aa0 68 61 74 20 65 61 63 68 20 6d 61 70 70 69 6e 67  hat each mapping
23ab0 20 6d 75 73 74 20 62 65 20 61 6e 20 69 6e 74 65   must be an inte
23ac0 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20  ger multiple of 
23ad0 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 73  the.** current s
23ae0 79 73 74 65 6d 20 70 61 67 65 2d 73 69 7a 65 2e  ystem page-size.
23af0 0a 2a 2a 0a 2a 2a 20 55 73 75 61 6c 6c 79 2c 20  .**.** Usually, 
23b00 74 68 69 73 20 69 73 20 31 2e 20 54 68 65 20 65  this is 1. The e
23b10 78 63 65 70 74 69 6f 6e 20 73 65 65 6d 73 20 74  xception seems t
23b20 6f 20 62 65 20 73 79 73 74 65 6d 73 20 74 68 61  o be systems tha
23b30 74 20 61 72 65 20 63 6f 6e 66 69 67 75 72 65 64  t are configured
23b40 0a 2a 2a 20 74 6f 20 75 73 65 20 36 34 4b 42 20  .** to use 64KB 
23b50 70 61 67 65 73 20 2d 20 69 6e 20 74 68 69 73 20  pages - in this 
23b60 63 61 73 65 20 65 61 63 68 20 6d 61 70 70 69 6e  case each mappin
23b70 67 20 6d 75 73 74 20 63 6f 76 65 72 20 61 74 20  g must cover at 
23b80 6c 65 61 73 74 20 74 77 6f 0a 2a 2a 20 73 68 6d  least two.** shm
23b90 20 72 65 67 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61   regions..*/.sta
23ba0 74 69 63 20 69 6e 74 20 75 6e 69 78 53 68 6d 52  tic int unixShmR
23bb0 65 67 69 6f 6e 50 65 72 4d 61 70 28 76 6f 69 64  egionPerMap(void
23bc0 29 7b 0a 20 20 69 6e 74 20 73 68 6d 73 7a 20 3d  ){.  int shmsz =
23bd0 20 33 32 2a 31 30 32 34 3b 20 20 20 20 20 20 20   32*1024;       
23be0 20 20 20 20 20 2f 2a 20 53 48 4d 20 72 65 67 69       /* SHM regi
23bf0 6f 6e 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74  on size */.  int
23c00 20 70 67 73 7a 20 3d 20 6f 73 47 65 74 70 61 67   pgsz = osGetpag
23c10 65 73 69 7a 65 28 29 3b 20 20 20 2f 2a 20 53 79  esize();   /* Sy
23c20 73 74 65 6d 20 70 61 67 65 20 73 69 7a 65 20 2a  stem page size *
23c30 2f 0a 20 20 61 73 73 65 72 74 28 20 28 28 70 67  /.  assert( ((pg
23c40 73 7a 2d 31 29 26 70 67 73 7a 29 3d 3d 30 20 29  sz-1)&pgsz)==0 )
23c50 3b 20 20 20 2f 2a 20 50 61 67 65 20 73 69 7a 65  ;   /* Page size
23c60 20 6d 75 73 74 20 62 65 20 61 20 70 6f 77 65 72   must be a power
23c70 20 6f 66 20 32 20 2a 2f 0a 20 20 69 66 28 20 70   of 2 */.  if( p
23c80 67 73 7a 3c 73 68 6d 73 7a 20 29 20 72 65 74 75  gsz<shmsz ) retu
23c90 72 6e 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 70  rn 1;.  return p
23ca0 67 73 7a 2f 73 68 6d 73 7a 3b 0a 7d 0a 0a 2f 2a  gsz/shmsz;.}../*
23cb0 0a 2a 2a 20 50 75 72 67 65 20 74 68 65 20 75 6e  .** Purge the un
23cc0 69 78 53 68 6d 4e 6f 64 65 4c 69 73 74 20 6c 69  ixShmNodeList li
23cd0 73 74 20 6f 66 20 61 6c 6c 20 65 6e 74 72 69 65  st of all entrie
23ce0 73 20 77 69 74 68 20 75 6e 69 78 53 68 6d 4e 6f  s with unixShmNo
23cf0 64 65 2e 6e 52 65 66 3d 3d 30 2e 0a 2a 2a 0a 2a  de.nRef==0..**.*
23d00 2a 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 20  * This is not a 
23d10 56 46 53 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72  VFS shared-memor
23d20 79 20 6d 65 74 68 6f 64 3b 20 69 74 20 69 73 20  y method; it is 
23d30 61 20 75 74 69 6c 69 74 79 20 66 75 6e 63 74 69  a utility functi
23d40 6f 6e 20 63 61 6c 6c 65 64 0a 2a 2a 20 62 79 20  on called.** by 
23d50 56 46 53 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72  VFS shared-memor
23d60 79 20 6d 65 74 68 6f 64 73 2e 0a 2a 2f 0a 73 74  y methods..*/.st
23d70 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78 53 68  atic void unixSh
23d80 6d 50 75 72 67 65 28 75 6e 69 78 46 69 6c 65 20  mPurge(unixFile 
23d90 2a 70 46 64 29 7b 0a 20 20 75 6e 69 78 53 68 6d  *pFd){.  unixShm
23da0 4e 6f 64 65 20 2a 70 20 3d 20 70 46 64 2d 3e 70  Node *p = pFd->p
23db0 49 6e 6f 64 65 2d 3e 70 53 68 6d 4e 6f 64 65 3b  Inode->pShmNode;
23dc0 0a 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 4d  .  assert( unixM
23dd0 75 74 65 78 48 65 6c 64 28 29 20 29 3b 0a 20 20  utexHeld() );.  
23de0 69 66 28 20 70 20 26 26 20 41 4c 57 41 59 53 28  if( p && ALWAYS(
23df0 70 2d 3e 6e 52 65 66 3d 3d 30 29 20 29 7b 0a 20  p->nRef==0) ){. 
23e00 20 20 20 69 6e 74 20 6e 53 68 6d 50 65 72 4d 61     int nShmPerMa
23e10 70 20 3d 20 75 6e 69 78 53 68 6d 52 65 67 69 6f  p = unixShmRegio
23e20 6e 50 65 72 4d 61 70 28 29 3b 0a 20 20 20 20 69  nPerMap();.    i
23e30 6e 74 20 69 3b 0a 20 20 20 20 61 73 73 65 72 74  nt i;.    assert
23e40 28 20 70 2d 3e 70 49 6e 6f 64 65 3d 3d 70 46 64  ( p->pInode==pFd
23e50 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a 20 20 20 20  ->pInode );.    
23e60 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 72  sqlite3_mutex_fr
23e70 65 65 28 70 2d 3e 70 53 68 6d 4d 75 74 65 78 29  ee(p->pShmMutex)
23e80 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
23e90 3c 70 2d 3e 6e 52 65 67 69 6f 6e 3b 20 69 2b 3d  <p->nRegion; i+=
23ea0 6e 53 68 6d 50 65 72 4d 61 70 29 7b 0a 20 20 20  nShmPerMap){.   
23eb0 20 20 20 69 66 28 20 70 2d 3e 68 53 68 6d 3e 3d     if( p->hShm>=
23ec0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 6f 73 4d  0 ){.        osM
23ed0 75 6e 6d 61 70 28 70 2d 3e 61 70 52 65 67 69 6f  unmap(p->apRegio
23ee0 6e 5b 69 5d 2c 20 70 2d 3e 73 7a 52 65 67 69 6f  n[i], p->szRegio
23ef0 6e 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  n);.      }else{
23f00 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
23f10 5f 66 72 65 65 28 70 2d 3e 61 70 52 65 67 69 6f  _free(p->apRegio
23f20 6e 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20  n[i]);.      }. 
23f30 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
23f40 5f 66 72 65 65 28 70 2d 3e 61 70 52 65 67 69 6f  _free(p->apRegio
23f50 6e 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 68  n);.    if( p->h
23f60 53 68 6d 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20  Shm>=0 ){.      
23f70 72 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 46 64  robust_close(pFd
23f80 2c 20 70 2d 3e 68 53 68 6d 2c 20 5f 5f 4c 49 4e  , p->hShm, __LIN
23f90 45 5f 5f 29 3b 0a 20 20 20 20 20 20 70 2d 3e 68  E__);.      p->h
23fa0 53 68 6d 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a  Shm = -1;.    }.
23fb0 20 20 20 20 70 2d 3e 70 49 6e 6f 64 65 2d 3e 70      p->pInode->p
23fc0 53 68 6d 4e 6f 64 65 20 3d 20 30 3b 0a 20 20 20  ShmNode = 0;.   
23fd0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29   sqlite3_free(p)
23fe0 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  ;.  }.}../*.** T
23ff0 68 65 20 44 4d 53 20 6c 6f 63 6b 20 68 61 73 20  he DMS lock has 
24000 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 74 61 6b  not yet been tak
24010 65 6e 20 6f 6e 20 73 68 6d 20 66 69 6c 65 20 70  en on shm file p
24020 53 68 6d 4e 6f 64 65 2e 20 41 74 74 65 6d 70 74  ShmNode. Attempt
24030 20 74 6f 0a 2a 2a 20 74 61 6b 65 20 69 74 20 6e   to.** take it n
24040 6f 77 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54  ow. Return SQLIT
24050 45 5f 4f 4b 20 69 66 20 73 75 63 63 65 73 73 66  E_OK if successf
24060 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65  ul, or an SQLite
24070 20 65 72 72 6f 72 0a 2a 2a 20 63 6f 64 65 20 6f   error.** code o
24080 74 68 65 72 77 69 73 65 2e 0a 2a 2a 0a 2a 2a 20  therwise..**.** 
24090 49 66 20 74 68 65 20 44 4d 53 20 63 61 6e 6e 6f  If the DMS canno
240a0 74 20 62 65 20 6c 6f 63 6b 65 64 20 62 65 63 61  t be locked beca
240b0 75 73 65 20 74 68 69 73 20 69 73 20 61 20 72 65  use this is a re
240c0 61 64 6f 6e 6c 79 5f 73 68 6d 3d 31 20 0a 2a 2a  adonly_shm=1 .**
240d0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 6e 64 20   connection and 
240e0 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73  no other process
240f0 20 61 6c 72 65 61 64 79 20 68 6f 6c 64 73 20 61   already holds a
24100 20 6c 6f 63 6b 2c 20 72 65 74 75 72 6e 0a 2a 2a   lock, return.**
24110 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59   SQLITE_READONLY
24120 5f 43 41 4e 54 49 4e 49 54 20 61 6e 64 20 73 65  _CANTINIT and se
24130 74 20 70 53 68 6d 4e 6f 64 65 2d 3e 69 73 55 6e  t pShmNode->isUn
24140 6c 6f 63 6b 65 64 3d 31 2e 0a 2a 2f 0a 73 74 61  locked=1..*/.sta
24150 74 69 63 20 69 6e 74 20 75 6e 69 78 4c 6f 63 6b  tic int unixLock
24160 53 68 61 72 65 64 4d 65 6d 6f 72 79 28 75 6e 69  SharedMemory(uni
24170 78 46 69 6c 65 20 2a 70 44 62 46 64 2c 20 75 6e  xFile *pDbFd, un
24180 69 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e  ixShmNode *pShmN
24190 6f 64 65 29 7b 0a 20 20 73 74 72 75 63 74 20 66  ode){.  struct f
241a0 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69 6e 74  lock lock;.  int
241b0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
241c0 0a 0a 20 20 2f 2a 20 55 73 65 20 46 5f 47 45 54  ..  /* Use F_GET
241d0 4c 4b 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  LK to determine 
241e0 74 68 65 20 6c 6f 63 6b 73 20 6f 74 68 65 72 20  the locks other 
241f0 70 72 6f 63 65 73 73 65 73 20 61 72 65 20 68 6f  processes are ho
24200 6c 64 69 6e 67 0a 20 20 2a 2a 20 6f 6e 20 74 68  lding.  ** on th
24210 65 20 44 4d 53 20 62 79 74 65 2e 20 49 66 20 69  e DMS byte. If i
24220 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74  t indicates that
24230 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 73   another process
24240 20 69 73 20 68 6f 6c 64 69 6e 67 0a 20 20 2a 2a   is holding.  **
24250 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20   a SHARED lock, 
24260 74 68 65 6e 20 74 68 69 73 20 70 72 6f 63 65 73  then this proces
24270 73 20 6d 61 79 20 61 6c 73 6f 20 74 61 6b 65 20  s may also take 
24280 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 0a 20 20  a SHARED lock.  
24290 2a 2a 20 61 6e 64 20 70 72 6f 63 65 65 64 20 77  ** and proceed w
242a0 69 74 68 20 6f 70 65 6e 69 6e 67 20 74 68 65 20  ith opening the 
242b0 2a 2d 73 68 6d 20 66 69 6c 65 2e 20 0a 20 20 2a  *-shm file. .  *
242c0 2a 0a 20 20 2a 2a 20 4f 72 2c 20 69 66 20 6e 6f  *.  ** Or, if no
242d0 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 69   other process i
242e0 73 20 68 6f 6c 64 69 6e 67 20 61 6e 79 20 6c 6f  s holding any lo
242f0 63 6b 2c 20 74 68 65 6e 20 74 68 69 73 20 70 72  ck, then this pr
24300 6f 63 65 73 73 0a 20 20 2a 2a 20 69 73 20 74 68  ocess.  ** is th
24310 65 20 66 69 72 73 74 20 74 6f 20 6f 70 65 6e 20  e first to open 
24320 69 74 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65  it. In this case
24330 20 74 61 6b 65 20 61 6e 20 45 58 43 4c 55 53 49   take an EXCLUSI
24340 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20  VE lock on the. 
24350 20 2a 2a 20 44 4d 53 20 62 79 74 65 20 61 6e 64   ** DMS byte and
24360 20 74 72 75 6e 63 61 74 65 20 74 68 65 20 2a 2d   truncate the *-
24370 73 68 6d 20 66 69 6c 65 20 74 6f 20 7a 65 72 6f  shm file to zero
24380 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 20   bytes in size. 
24390 54 68 65 6e 0a 20 20 2a 2a 20 64 6f 77 6e 67 72  Then.  ** downgr
243a0 61 64 65 20 74 6f 20 61 20 53 48 41 52 45 44 20  ade to a SHARED 
243b0 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 44 4d 53 20  lock on the DMS 
243c0 62 79 74 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  byte..  **.  ** 
243d0 49 66 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65  If another proce
243e0 73 73 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 6e  ss is holding an
243f0 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20   EXCLUSIVE lock 
24400 6f 6e 20 74 68 65 20 44 4d 53 20 62 79 74 65 2c  on the DMS byte,
24410 0a 20 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c  .  ** return SQL
24420 49 54 45 5f 42 55 53 59 20 74 6f 20 74 68 65 20  ITE_BUSY to the 
24430 63 61 6c 6c 65 72 20 28 69 74 20 77 69 6c 6c 20  caller (it will 
24440 74 72 79 20 61 67 61 69 6e 29 2e 20 41 6e 20 65  try again). An e
24450 61 72 6c 69 65 72 0a 20 20 2a 2a 20 76 65 72 73  arlier.  ** vers
24460 69 6f 6e 20 6f 66 20 74 68 69 73 20 63 6f 64 65  ion of this code
24470 20 61 74 74 65 6d 70 74 65 64 20 74 68 65 20 53   attempted the S
24480 48 41 52 45 44 20 6c 6f 63 6b 20 61 74 20 74 68  HARED lock at th
24490 69 73 20 70 6f 69 6e 74 2e 20 42 75 74 0a 20 20  is point. But.  
244a0 2a 2a 20 74 68 69 73 20 69 6e 74 72 6f 64 75 63  ** this introduc
244b0 65 64 20 61 20 73 75 62 74 6c 65 20 72 61 63 65  ed a subtle race
244c0 20 63 6f 6e 64 69 74 69 6f 6e 3a 20 69 66 20 74   condition: if t
244d0 68 65 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 69  he process holdi
244e0 6e 67 0a 20 20 2a 2a 20 45 58 43 4c 55 53 49 56  ng.  ** EXCLUSIV
244f0 45 20 66 61 69 6c 65 64 20 6a 75 73 74 20 62 65  E failed just be
24500 66 6f 72 65 20 74 72 75 6e 63 61 74 69 6e 67 20  fore truncating 
24510 74 68 65 20 2a 2d 73 68 6d 20 66 69 6c 65 2c 20  the *-shm file, 
24520 74 68 65 6e 20 74 68 69 73 0a 20 20 2a 2a 20 70  then this.  ** p
24530 72 6f 63 65 73 73 20 6d 69 67 68 74 20 6f 70 65  rocess might ope
24540 6e 20 61 6e 64 20 75 73 65 20 74 68 65 20 2a 2d  n and use the *-
24550 73 68 6d 20 66 69 6c 65 20 77 69 74 68 6f 75 74  shm file without
24560 20 74 72 75 6e 63 61 74 69 6e 67 20 69 74 2e 0a   truncating it..
24570 20 20 2a 2a 20 41 6e 64 20 69 66 20 74 68 65 20    ** And if the 
24580 2a 2d 73 68 6d 20 66 69 6c 65 20 68 61 73 20 62  *-shm file has b
24590 65 65 6e 20 63 6f 72 72 75 70 74 65 64 20 62 79  een corrupted by
245a0 20 61 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65   a power failure
245b0 20 6f 72 0a 20 20 2a 2a 20 73 79 73 74 65 6d 20   or.  ** system 
245c0 63 72 61 73 68 2c 20 74 68 65 20 64 61 74 61 62  crash, the datab
245d0 61 73 65 20 69 74 73 65 6c 66 20 6d 61 79 20 61  ase itself may a
245e0 6c 73 6f 20 62 65 63 6f 6d 65 20 63 6f 72 72 75  lso become corru
245f0 70 74 2e 20 20 2a 2f 0a 20 20 6c 6f 63 6b 2e 6c  pt.  */.  lock.l
24600 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53  _whence = SEEK_S
24610 45 54 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61  ET;.  lock.l_sta
24620 72 74 20 3d 20 55 4e 49 58 5f 53 48 4d 5f 44 4d  rt = UNIX_SHM_DM
24630 53 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20  S;.  lock.l_len 
24640 3d 20 31 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 74 79  = 1;.  lock.l_ty
24650 70 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20  pe = F_WRLCK;.  
24660 69 66 28 20 6f 73 46 63 6e 74 6c 28 70 53 68 6d  if( osFcntl(pShm
24670 4e 6f 64 65 2d 3e 68 53 68 6d 2c 20 46 5f 47 45  Node->hShm, F_GE
24680 54 4c 4b 2c 20 26 6c 6f 63 6b 29 21 3d 30 20 29  TLK, &lock)!=0 )
24690 20 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49   {.    rc = SQLI
246a0 54 45 5f 49 4f 45 52 52 5f 4c 4f 43 4b 3b 0a 20  TE_IOERR_LOCK;. 
246b0 20 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b 2e   }else if( lock.
246c0 6c 5f 74 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b 20  l_type==F_UNLCK 
246d0 29 7b 0a 20 20 20 20 69 66 28 20 70 53 68 6d 4e  ){.    if( pShmN
246e0 6f 64 65 2d 3e 69 73 52 65 61 64 6f 6e 6c 79 20  ode->isReadonly 
246f0 29 7b 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f 64  ){.      pShmNod
24700 65 2d 3e 69 73 55 6e 6c 6f 63 6b 65 64 20 3d 20  e->isUnlocked = 
24710 31 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51  1;.      rc = SQ
24720 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f 43 41  LITE_READONLY_CA
24730 4e 54 49 4e 49 54 3b 0a 20 20 20 20 7d 65 6c 73  NTINIT;.    }els
24740 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 75 6e  e{.      rc = un
24750 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28  ixShmSystemLock(
24760 70 44 62 46 64 2c 20 46 5f 57 52 4c 43 4b 2c 20  pDbFd, F_WRLCK, 
24770 55 4e 49 58 5f 53 48 4d 5f 44 4d 53 2c 20 31 29  UNIX_SHM_DMS, 1)
24780 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d  ;.      if( rc==
24790 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 6f 62  SQLITE_OK && rob
247a0 75 73 74 5f 66 74 72 75 6e 63 61 74 65 28 70 53  ust_ftruncate(pS
247b0 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 2c 20 30 29  hmNode->hShm, 0)
247c0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d   ){.        rc =
247d0 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51   unixLogError(SQ
247e0 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4f 50  LITE_IOERR_SHMOP
247f0 45 4e 2c 22 66 74 72 75 6e 63 61 74 65 22 2c 70  EN,"ftruncate",p
24800 53 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61  ShmNode->zFilena
24810 6d 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  me);.      }.   
24820 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6c   }.  }else if( l
24830 6f 63 6b 2e 6c 5f 74 79 70 65 3d 3d 46 5f 57 52  ock.l_type==F_WR
24840 4c 43 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  LCK ){.    rc = 
24850 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d  SQLITE_BUSY;.  }
24860 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ..  if( rc==SQLI
24870 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73  TE_OK ){.    ass
24880 65 72 74 28 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65  ert( lock.l_type
24890 3d 3d 46 5f 55 4e 4c 43 4b 20 7c 7c 20 6c 6f 63  ==F_UNLCK || loc
248a0 6b 2e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43  k.l_type==F_RDLC
248b0 4b 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 75 6e  K );.    rc = un
248c0 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28  ixShmSystemLock(
248d0 70 44 62 46 64 2c 20 46 5f 52 44 4c 43 4b 2c 20  pDbFd, F_RDLCK, 
248e0 55 4e 49 58 5f 53 48 4d 5f 44 4d 53 2c 20 31 29  UNIX_SHM_DMS, 1)
248f0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
24900 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e  c;.}../*.** Open
24910 20 61 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79   a shared-memory
24920 20 61 72 65 61 20 61 73 73 6f 63 69 61 74 65 64   area associated
24930 20 77 69 74 68 20 6f 70 65 6e 20 64 61 74 61 62   with open datab
24940 61 73 65 20 66 69 6c 65 20 70 44 62 46 64 2e 20  ase file pDbFd. 
24950 20 0a 2a 2a 20 54 68 69 73 20 70 61 72 74 69 63   .** This partic
24960 75 6c 61 72 20 69 6d 70 6c 65 6d 65 6e 74 61 74  ular implementat
24970 69 6f 6e 20 75 73 65 73 20 6d 6d 61 70 70 65 64  ion uses mmapped
24980 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68   files..**.** Th
24990 65 20 66 69 6c 65 20 75 73 65 64 20 74 6f 20 69  e file used to i
249a0 6d 70 6c 65 6d 65 6e 74 20 73 68 61 72 65 64 2d  mplement shared-
249b0 6d 65 6d 6f 72 79 20 69 73 20 69 6e 20 74 68 65  memory is in the
249c0 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 0a   same directory.
249d0 2a 2a 20 61 73 20 74 68 65 20 6f 70 65 6e 20 64  ** as the open d
249e0 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64  atabase file and
249f0 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e 61   has the same na
24a00 6d 65 20 61 73 20 74 68 65 20 6f 70 65 6e 20 64  me as the open d
24a10 61 74 61 62 61 73 65 0a 2a 2a 20 66 69 6c 65 20  atabase.** file 
24a20 77 69 74 68 20 74 68 65 20 22 2d 73 68 6d 22 20  with the "-shm" 
24a30 73 75 66 66 69 78 20 61 64 64 65 64 2e 20 20 46  suffix added.  F
24a40 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 74  or example, if t
24a50 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
24a60 0a 2a 2a 20 69 73 20 22 2f 68 6f 6d 65 2f 75 73  .** is "/home/us
24a70 65 72 31 2f 63 6f 6e 66 69 67 2e 64 62 22 20 74  er1/config.db" t
24a80 68 65 6e 20 74 68 65 20 66 69 6c 65 20 74 68 61  hen the file tha
24a90 74 20 69 73 20 63 72 65 61 74 65 64 20 61 6e 64  t is created and
24aa0 20 6d 6d 61 70 70 65 64 0a 2a 2a 20 66 6f 72 20   mmapped.** for 
24ab0 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 77 69  shared memory wi
24ac0 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 22 2f 68  ll be called "/h
24ad0 6f 6d 65 2f 75 73 65 72 31 2f 63 6f 6e 66 69 67  ome/user1/config
24ae0 2e 64 62 2d 73 68 6d 22 2e 20 20 0a 2a 2a 0a 2a  .db-shm".  .**.*
24af0 2a 20 41 6e 6f 74 68 65 72 20 61 70 70 72 6f 61  * Another approa
24b00 63 68 20 74 6f 20 69 73 20 74 6f 20 75 73 65 20  ch to is to use 
24b10 66 69 6c 65 73 20 69 6e 20 2f 64 65 76 2f 73 68  files in /dev/sh
24b20 6d 20 6f 72 20 2f 64 65 76 2f 74 6d 70 20 6f 72  m or /dev/tmp or
24b30 20 61 6e 0a 2a 2a 20 73 6f 6d 65 20 6f 74 68 65   an.** some othe
24b40 72 20 74 6d 70 66 73 20 6d 6f 75 6e 74 2e 20 42  r tmpfs mount. B
24b50 75 74 20 69 66 20 61 20 66 69 6c 65 20 69 6e 20  ut if a file in 
24b60 61 20 64 69 66 66 65 72 65 6e 74 20 64 69 72 65  a different dire
24b70 63 74 6f 72 79 0a 2a 2a 20 66 72 6f 6d 20 74 68  ctory.** from th
24b80 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
24b90 69 73 20 75 73 65 64 2c 20 74 68 65 6e 20 64 69  is used, then di
24ba0 66 66 65 72 69 6e 67 20 61 63 63 65 73 73 20 70  ffering access p
24bb0 65 72 6d 69 73 73 69 6f 6e 73 0a 2a 2a 20 6f 72  ermissions.** or
24bc0 20 61 20 63 68 72 6f 6f 74 28 29 20 6d 69 67 68   a chroot() migh
24bd0 74 20 63 61 75 73 65 20 74 77 6f 20 64 69 66 66  t cause two diff
24be0 65 72 65 6e 74 20 70 72 6f 63 65 73 73 65 73 20  erent processes 
24bf0 6f 6e 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 64  on the same.** d
24c00 61 74 61 62 61 73 65 20 74 6f 20 65 6e 64 20 75  atabase to end u
24c10 70 20 75 73 69 6e 67 20 64 69 66 66 65 72 65 6e  p using differen
24c20 74 20 66 69 6c 65 73 20 66 6f 72 20 73 68 61 72  t files for shar
24c30 65 64 20 6d 65 6d 6f 72 79 20 2d 20 0a 2a 2a 20  ed memory - .** 
24c40 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 74 68 65  meaning that the
24c50 69 72 20 6d 65 6d 6f 72 79 20 77 6f 75 6c 64 20  ir memory would 
24c60 6e 6f 74 20 72 65 61 6c 6c 79 20 62 65 20 73 68  not really be sh
24c70 61 72 65 64 20 2d 20 72 65 73 75 6c 74 69 6e 67  ared - resulting
24c80 0a 2a 2a 20 69 6e 20 64 61 74 61 62 61 73 65 20  .** in database 
24c90 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 4e 65 76  corruption.  Nev
24ca0 65 72 74 68 65 6c 65 73 73 2c 20 74 68 69 73 20  ertheless, this 
24cb0 74 6d 70 66 73 20 66 69 6c 65 20 75 73 61 67 65  tmpfs file usage
24cc0 0a 2a 2a 20 63 61 6e 20 62 65 20 65 6e 61 62 6c  .** can be enabl
24cd0 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69  ed at compile-ti
24ce0 6d 65 20 75 73 69 6e 67 20 2d 44 53 51 4c 49 54  me using -DSQLIT
24cf0 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 59 3d  E_SHM_DIRECTORY=
24d00 22 2f 64 65 76 2f 73 68 6d 22 0a 2a 2a 20 6f 72  "/dev/shm".** or
24d10 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e 74 2e   the equivalent.
24d20 20 20 54 68 65 20 75 73 65 20 6f 66 20 74 68 65    The use of the
24d30 20 53 51 4c 49 54 45 5f 53 48 4d 5f 44 49 52 45   SQLITE_SHM_DIRE
24d40 43 54 4f 52 59 20 63 6f 6d 70 69 6c 65 2d 74 69  CTORY compile-ti
24d50 6d 65 0a 2a 2a 20 6f 70 74 69 6f 6e 20 72 65 73  me.** option res
24d60 75 6c 74 73 20 69 6e 20 61 6e 20 69 6e 63 6f 6d  ults in an incom
24d70 70 61 74 69 62 6c 65 20 62 75 69 6c 64 20 6f 66  patible build of
24d80 20 53 51 4c 69 74 65 3b 20 20 62 75 69 6c 64 73   SQLite;  builds
24d90 20 6f 66 20 53 51 4c 69 74 65 0a 2a 2a 20 74 68   of SQLite.** th
24da0 61 74 20 77 69 74 68 20 64 69 66 66 65 72 69 6e  at with differin
24db0 67 20 53 51 4c 49 54 45 5f 53 48 4d 5f 44 49 52  g SQLITE_SHM_DIR
24dc0 45 43 54 4f 52 59 20 73 65 74 74 69 6e 67 73 20  ECTORY settings 
24dd0 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74  attempt to use t
24de0 68 65 0a 2a 2a 20 73 61 6d 65 20 64 61 74 61 62  he.** same datab
24df0 61 73 65 20 66 69 6c 65 20 61 74 20 74 68 65 20  ase file at the 
24e00 73 61 6d 65 20 74 69 6d 65 2c 20 64 61 74 61 62  same time, datab
24e10 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 77  ase corruption w
24e20 69 6c 6c 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65  ill likely.** re
24e30 73 75 6c 74 2e 20 54 68 65 20 53 51 4c 49 54 45  sult. The SQLITE
24e40 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52 59 20 63  _SHM_DIRECTORY c
24e50 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
24e60 6f 6e 20 69 73 20 63 6f 6e 73 69 64 65 72 65 64  on is considered
24e70 0a 2a 2a 20 22 75 6e 73 75 70 70 6f 72 74 65 64  .** "unsupported
24e80 22 20 61 6e 64 20 6d 61 79 20 67 6f 20 61 77 61  " and may go awa
24e90 79 20 69 6e 20 61 20 66 75 74 75 72 65 20 53 51  y in a future SQ
24ea0 4c 69 74 65 20 72 65 6c 65 61 73 65 2e 0a 2a 2a  Lite release..**
24eb0 0a 2a 2a 20 57 68 65 6e 20 6f 70 65 6e 69 6e 67  .** When opening
24ec0 20 61 20 6e 65 77 20 73 68 61 72 65 64 2d 6d 65   a new shared-me
24ed0 6d 6f 72 79 20 66 69 6c 65 2c 20 69 66 20 6e 6f  mory file, if no
24ee0 20 6f 74 68 65 72 20 69 6e 73 74 61 6e 63 65 73   other instances
24ef0 20 6f 66 20 74 68 61 74 0a 2a 2a 20 66 69 6c 65   of that.** file
24f00 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f   are currently o
24f10 70 65 6e 2c 20 69 6e 20 74 68 69 73 20 70 72 6f  pen, in this pro
24f20 63 65 73 73 20 6f 72 20 69 6e 20 6f 74 68 65 72  cess or in other
24f30 20 70 72 6f 63 65 73 73 65 73 2c 20 74 68 65 6e   processes, then
24f40 0a 2a 2a 20 74 68 65 20 66 69 6c 65 20 6d 75 73  .** the file mus
24f50 74 20 62 65 20 74 72 75 6e 63 61 74 65 64 20 74  t be truncated t
24f60 6f 20 7a 65 72 6f 20 6c 65 6e 67 74 68 20 6f 72  o zero length or
24f70 20 68 61 76 65 20 69 74 73 20 68 65 61 64 65 72   have its header
24f80 20 63 6c 65 61 72 65 64 2e 0a 2a 2a 0a 2a 2a 20   cleared..**.** 
24f90 49 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20  If the original 
24fa0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 70  database file (p
24fb0 44 62 46 64 29 20 69 73 20 75 73 69 6e 67 20 74  DbFd) is using t
24fc0 68 65 20 22 75 6e 69 78 2d 65 78 63 6c 22 20 56  he "unix-excl" V
24fd0 46 53 0a 2a 2a 20 74 68 61 74 20 6d 65 61 6e 73  FS.** that means
24fe0 20 74 68 61 74 20 61 6e 20 65 78 63 6c 75 73 69   that an exclusi
24ff0 76 65 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20  ve lock is held 
25000 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  on the database 
25010 66 69 6c 65 20 61 6e 64 0a 2a 2a 20 74 68 61 74  file and.** that
25020 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 73   no other proces
25030 73 65 73 20 61 72 65 20 61 62 6c 65 20 74 6f 20  ses are able to 
25040 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 68  read or write th
25050 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 6e 0a  e database.  In.
25060 2a 2a 20 74 68 61 74 20 63 61 73 65 2c 20 77 65  ** that case, we
25070 20 64 6f 20 6e 6f 74 20 72 65 61 6c 6c 79 20 6e   do not really n
25080 65 65 64 20 73 68 61 72 65 64 20 6d 65 6d 6f 72  eed shared memor
25090 79 2e 20 20 4e 6f 20 73 68 61 72 65 64 20 6d 65  y.  No shared me
250a0 6d 6f 72 79 0a 2a 2a 20 66 69 6c 65 20 69 73 20  mory.** file is 
250b0 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 73 68  created.  The sh
250c0 61 72 65 64 20 6d 65 6d 6f 72 79 20 77 69 6c 6c  ared memory will
250d0 20 62 65 20 73 69 6d 75 6c 61 74 65 64 20 77 69   be simulated wi
250e0 74 68 20 68 65 61 70 20 6d 65 6d 6f 72 79 2e 0a  th heap memory..
250f0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e  */.static int un
25100 69 78 4f 70 65 6e 53 68 61 72 65 64 4d 65 6d 6f  ixOpenSharedMemo
25110 72 79 28 75 6e 69 78 46 69 6c 65 20 2a 70 44 62  ry(unixFile *pDb
25120 46 64 29 7b 0a 20 20 73 74 72 75 63 74 20 75 6e  Fd){.  struct un
25130 69 78 53 68 6d 20 2a 70 20 3d 20 30 3b 20 20 20  ixShm *p = 0;   
25140 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f         /* The co
25150 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 62 65 20 6f  nnection to be o
25160 70 65 6e 65 64 20 2a 2f 0a 20 20 73 74 72 75 63  pened */.  struc
25170 74 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70  t unixShmNode *p
25180 53 68 6d 4e 6f 64 65 3b 20 20 20 2f 2a 20 54 68  ShmNode;   /* Th
25190 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 6d 61  e underlying mma
251a0 70 70 65 64 20 66 69 6c 65 20 2a 2f 0a 20 20 69  pped file */.  i
251b0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
251c0 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  K;             /
251d0 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a 2f  * Result code */
251e0 0a 20 20 75 6e 69 78 49 6e 6f 64 65 49 6e 66 6f  .  unixInodeInfo
251f0 20 2a 70 49 6e 6f 64 65 3b 20 20 20 20 20 20 20   *pInode;       
25200 20 20 20 2f 2a 20 54 68 65 20 69 6e 6f 64 65 20     /* The inode 
25210 6f 66 20 66 64 20 2a 2f 0a 20 20 63 68 61 72 20  of fd */.  char 
25220 2a 7a 53 68 6d 3b 20 20 20 20 20 20 20 20 20 20  *zShm;          
25230 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68     /* Name of th
25240 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20  e file used for 
25250 53 48 4d 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 68  SHM */.  int nSh
25260 6d 46 69 6c 65 6e 61 6d 65 3b 20 20 20 20 20 20  mFilename;      
25270 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65           /* Size
25280 20 6f 66 20 74 68 65 20 53 48 4d 20 66 69 6c 65   of the SHM file
25290 6e 61 6d 65 20 69 6e 20 62 79 74 65 73 20 2a 2f  name in bytes */
252a0 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20  ..  /* Allocate 
252b0 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 6e 65  space for the ne
252c0 77 20 75 6e 69 78 53 68 6d 20 6f 62 6a 65 63 74  w unixShm object
252d0 2e 20 2a 2f 0a 20 20 70 20 3d 20 73 71 6c 69 74  . */.  p = sqlit
252e0 65 33 5f 6d 61 6c 6c 6f 63 36 34 28 20 73 69 7a  e3_malloc64( siz
252f0 65 6f 66 28 2a 70 29 20 29 3b 0a 20 20 69 66 28  eof(*p) );.  if(
25300 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53   p==0 ) return S
25310 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54  QLITE_NOMEM_BKPT
25320 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c  ;.  memset(p, 0,
25330 20 73 69 7a 65 6f 66 28 2a 70 29 29 3b 0a 20 20   sizeof(*p));.  
25340 61 73 73 65 72 74 28 20 70 44 62 46 64 2d 3e 70  assert( pDbFd->p
25350 53 68 6d 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20  Shm==0 );..  /* 
25360 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20  Check to see if 
25370 61 20 75 6e 69 78 53 68 6d 4e 6f 64 65 20 6f 62  a unixShmNode ob
25380 6a 65 63 74 20 61 6c 72 65 61 64 79 20 65 78 69  ject already exi
25390 73 74 73 2e 20 52 65 75 73 65 20 61 6e 20 65 78  sts. Reuse an ex
253a0 69 73 74 69 6e 67 0a 20 20 2a 2a 20 6f 6e 65 20  isting.  ** one 
253b0 69 66 20 70 72 65 73 65 6e 74 2e 20 43 72 65 61  if present. Crea
253c0 74 65 20 61 20 6e 65 77 20 6f 6e 65 20 69 66 20  te a new one if 
253d0 6e 65 63 65 73 73 61 72 79 2e 0a 20 20 2a 2f 0a  necessary..  */.
253e0 20 20 61 73 73 65 72 74 28 20 75 6e 69 78 46 69    assert( unixFi
253f0 6c 65 4d 75 74 65 78 4e 6f 74 68 65 6c 64 28 70  leMutexNotheld(p
25400 44 62 46 64 29 20 29 3b 0a 20 20 75 6e 69 78 45  DbFd) );.  unixE
25410 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70  nterMutex();.  p
25420 49 6e 6f 64 65 20 3d 20 70 44 62 46 64 2d 3e 70  Inode = pDbFd->p
25430 49 6e 6f 64 65 3b 0a 20 20 70 53 68 6d 4e 6f 64  Inode;.  pShmNod
25440 65 20 3d 20 70 49 6e 6f 64 65 2d 3e 70 53 68 6d  e = pInode->pShm
25450 4e 6f 64 65 3b 0a 20 20 69 66 28 20 70 53 68 6d  Node;.  if( pShm
25460 4e 6f 64 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73  Node==0 ){.    s
25470 74 72 75 63 74 20 73 74 61 74 20 73 53 74 61 74  truct stat sStat
25480 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
25490 20 20 2f 2a 20 66 73 74 61 74 28 29 20 69 6e 66    /* fstat() inf
254a0 6f 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 66  o for database f
254b0 69 6c 65 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53  ile */.#ifndef S
254c0 51 4c 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54  QLITE_SHM_DIRECT
254d0 4f 52 59 0a 20 20 20 20 63 6f 6e 73 74 20 63 68  ORY.    const ch
254e0 61 72 20 2a 7a 42 61 73 65 50 61 74 68 20 3d 20  ar *zBasePath = 
254f0 70 44 62 46 64 2d 3e 7a 50 61 74 68 3b 0a 23 65  pDbFd->zPath;.#e
25500 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 43 61 6c  ndif..    /* Cal
25510 6c 20 66 73 74 61 74 28 29 20 74 6f 20 66 69 67  l fstat() to fig
25520 75 72 65 20 6f 75 74 20 74 68 65 20 70 65 72 6d  ure out the perm
25530 69 73 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 64  issions on the d
25540 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66  atabase file. If
25550 0a 20 20 20 20 2a 2a 20 61 20 6e 65 77 20 2a 2d  .    ** a new *-
25560 73 68 6d 20 66 69 6c 65 20 69 73 20 63 72 65 61  shm file is crea
25570 74 65 64 2c 20 61 6e 20 61 74 74 65 6d 70 74 20  ted, an attempt 
25580 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f 20  will be made to 
25590 63 72 65 61 74 65 20 69 74 0a 20 20 20 20 2a 2a  create it.    **
255a0 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 70   with the same p
255b0 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 20 20 20 20  ermissions..    
255c0 2a 2f 0a 20 20 20 20 69 66 28 20 6f 73 46 73 74  */.    if( osFst
255d0 61 74 28 70 44 62 46 64 2d 3e 68 2c 20 26 73 53  at(pDbFd->h, &sS
255e0 74 61 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63  tat) ){.      rc
255f0 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f   = SQLITE_IOERR_
25600 46 53 54 41 54 3b 0a 20 20 20 20 20 20 67 6f 74  FSTAT;.      got
25610 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72 3b 0a  o shm_open_err;.
25620 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51      }..#ifdef SQ
25630 4c 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f  LITE_SHM_DIRECTO
25640 52 59 0a 20 20 20 20 6e 53 68 6d 46 69 6c 65 6e  RY.    nShmFilen
25650 61 6d 65 20 3d 20 73 69 7a 65 6f 66 28 53 51 4c  ame = sizeof(SQL
25660 49 54 45 5f 53 48 4d 5f 44 49 52 45 43 54 4f 52  ITE_SHM_DIRECTOR
25670 59 29 20 2b 20 33 31 3b 0a 23 65 6c 73 65 0a 20  Y) + 31;.#else. 
25680 20 20 20 6e 53 68 6d 46 69 6c 65 6e 61 6d 65 20     nShmFilename 
25690 3d 20 36 20 2b 20 28 69 6e 74 29 73 74 72 6c 65  = 6 + (int)strle
256a0 6e 28 7a 42 61 73 65 50 61 74 68 29 3b 0a 23 65  n(zBasePath);.#e
256b0 6e 64 69 66 0a 20 20 20 20 70 53 68 6d 4e 6f 64  ndif.    pShmNod
256c0 65 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  e = sqlite3_mall
256d0 6f 63 36 34 28 20 73 69 7a 65 6f 66 28 2a 70 53  oc64( sizeof(*pS
256e0 68 6d 4e 6f 64 65 29 20 2b 20 6e 53 68 6d 46 69  hmNode) + nShmFi
256f0 6c 65 6e 61 6d 65 20 29 3b 0a 20 20 20 20 69 66  lename );.    if
25700 28 20 70 53 68 6d 4e 6f 64 65 3d 3d 30 20 29 7b  ( pShmNode==0 ){
25710 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49  .      rc = SQLI
25720 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20  TE_NOMEM_BKPT;. 
25730 20 20 20 20 20 67 6f 74 6f 20 73 68 6d 5f 6f 70       goto shm_op
25740 65 6e 5f 65 72 72 3b 0a 20 20 20 20 7d 0a 20 20  en_err;.    }.  
25750 20 20 6d 65 6d 73 65 74 28 70 53 68 6d 4e 6f 64    memset(pShmNod
25760 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a 70 53  e, 0, sizeof(*pS
25770 68 6d 4e 6f 64 65 29 2b 6e 53 68 6d 46 69 6c 65  hmNode)+nShmFile
25780 6e 61 6d 65 29 3b 0a 20 20 20 20 7a 53 68 6d 20  name);.    zShm 
25790 3d 20 70 53 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c  = pShmNode->zFil
257a0 65 6e 61 6d 65 20 3d 20 28 63 68 61 72 2a 29 26  ename = (char*)&
257b0 70 53 68 6d 4e 6f 64 65 5b 31 5d 3b 0a 23 69 66  pShmNode[1];.#if
257c0 64 65 66 20 53 51 4c 49 54 45 5f 53 48 4d 5f 44  def SQLITE_SHM_D
257d0 49 52 45 43 54 4f 52 59 0a 20 20 20 20 73 71 6c  IRECTORY.    sql
257e0 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e 53  ite3_snprintf(nS
257f0 68 6d 46 69 6c 65 6e 61 6d 65 2c 20 7a 53 68 6d  hmFilename, zShm
25800 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  , .             
25810 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 53          SQLITE_S
25820 48 4d 5f 44 49 52 45 43 54 4f 52 59 20 22 2f 73  HM_DIRECTORY "/s
25830 71 6c 69 74 65 2d 73 68 6d 2d 25 78 2d 25 78 22  qlite-shm-%x-%x"
25840 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
25850 20 20 20 20 20 20 20 28 75 33 32 29 73 53 74 61         (u32)sSta
25860 74 2e 73 74 5f 69 6e 6f 2c 20 28 75 33 32 29 73  t.st_ino, (u32)s
25870 53 74 61 74 2e 73 74 5f 64 65 76 29 3b 0a 23 65  Stat.st_dev);.#e
25880 6c 73 65 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  lse.    sqlite3_
25890 73 6e 70 72 69 6e 74 66 28 6e 53 68 6d 46 69 6c  snprintf(nShmFil
258a0 65 6e 61 6d 65 2c 20 7a 53 68 6d 2c 20 22 25 73  ename, zShm, "%s
258b0 2d 73 68 6d 22 2c 20 7a 42 61 73 65 50 61 74 68  -shm", zBasePath
258c0 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 46 69  );.    sqlite3Fi
258d0 6c 65 53 75 66 66 69 78 33 28 70 44 62 46 64 2d  leSuffix3(pDbFd-
258e0 3e 7a 50 61 74 68 2c 20 7a 53 68 6d 29 3b 0a 23  >zPath, zShm);.#
258f0 65 6e 64 69 66 0a 20 20 20 20 70 53 68 6d 4e 6f  endif.    pShmNo
25900 64 65 2d 3e 68 53 68 6d 20 3d 20 2d 31 3b 0a 20  de->hShm = -1;. 
25910 20 20 20 70 44 62 46 64 2d 3e 70 49 6e 6f 64 65     pDbFd->pInode
25920 2d 3e 70 53 68 6d 4e 6f 64 65 20 3d 20 70 53 68  ->pShmNode = pSh
25930 6d 4e 6f 64 65 3b 0a 20 20 20 20 70 53 68 6d 4e  mNode;.    pShmN
25940 6f 64 65 2d 3e 70 49 6e 6f 64 65 20 3d 20 70 44  ode->pInode = pD
25950 62 46 64 2d 3e 70 49 6e 6f 64 65 3b 0a 20 20 20  bFd->pInode;.   
25960 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c 6f 62   if( sqlite3Glob
25970 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75  alConfig.bCoreMu
25980 74 65 78 20 29 7b 0a 20 20 20 20 20 20 70 53 68  tex ){.      pSh
25990 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d 75 74 65 78  mNode->pShmMutex
259a0 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78   = sqlite3_mutex
259b0 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55  _alloc(SQLITE_MU
259c0 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 20  TEX_FAST);.     
259d0 20 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70   if( pShmNode->p
259e0 53 68 6d 4d 75 74 65 78 3d 3d 30 20 29 7b 0a 20  ShmMutex==0 ){. 
259f0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49         rc = SQLI
25a00 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20  TE_NOMEM_BKPT;. 
25a10 20 20 20 20 20 20 20 67 6f 74 6f 20 73 68 6d 5f         goto shm_
25a20 6f 70 65 6e 5f 65 72 72 3b 0a 20 20 20 20 20 20  open_err;.      
25a30 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  }.    }..    if(
25a40 20 70 49 6e 6f 64 65 2d 3e 62 50 72 6f 63 65 73   pInode->bProces
25a50 73 4c 6f 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 20  sLock==0 ){.    
25a60 20 20 69 66 28 20 30 3d 3d 73 71 6c 69 74 65 33    if( 0==sqlite3
25a70 5f 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 70 44 62  _uri_boolean(pDb
25a80 46 64 2d 3e 7a 50 61 74 68 2c 20 22 72 65 61 64  Fd->zPath, "read
25a90 6f 6e 6c 79 5f 73 68 6d 22 2c 20 30 29 20 29 7b  only_shm", 0) ){
25aa0 0a 20 20 20 20 20 20 20 20 70 53 68 6d 4e 6f 64  .        pShmNod
25ab0 65 2d 3e 68 53 68 6d 20 3d 20 72 6f 62 75 73 74  e->hShm = robust
25ac0 5f 6f 70 65 6e 28 7a 53 68 6d 2c 20 4f 5f 52 44  _open(zShm, O_RD
25ad0 57 52 7c 4f 5f 43 52 45 41 54 2c 28 73 53 74 61  WR|O_CREAT,(sSta
25ae0 74 2e 73 74 5f 6d 6f 64 65 26 30 37 37 37 29 29  t.st_mode&0777))
25af0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
25b00 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 68 53  if( pShmNode->hS
25b10 68 6d 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20  hm<0 ){.        
25b20 70 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 20 3d  pShmNode->hShm =
25b30 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 7a 53 68   robust_open(zSh
25b40 6d 2c 20 4f 5f 52 44 4f 4e 4c 59 2c 20 28 73 53  m, O_RDONLY, (sS
25b50 74 61 74 2e 73 74 5f 6d 6f 64 65 26 30 37 37 37  tat.st_mode&0777
25b60 29 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  ));.        if( 
25b70 70 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 3c 30  pShmNode->hShm<0
25b80 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63   ){.          rc
25b90 20 3d 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28   = unixLogError(
25ba0 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f  SQLITE_CANTOPEN_
25bb0 42 4b 50 54 2c 20 22 6f 70 65 6e 22 2c 20 7a 53  BKPT, "open", zS
25bc0 68 6d 29 3b 0a 20 20 20 20 20 20 20 20 20 20 67  hm);.          g
25bd0 6f 74 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72  oto shm_open_err
25be0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
25bf0 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 69 73      pShmNode->is
25c00 52 65 61 64 6f 6e 6c 79 20 3d 20 31 3b 0a 20 20  Readonly = 1;.  
25c10 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20      }..      /* 
25c20 49 66 20 74 68 69 73 20 70 72 6f 63 65 73 73 20  If this process 
25c30 69 73 20 72 75 6e 6e 69 6e 67 20 61 73 20 72 6f  is running as ro
25c40 6f 74 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 68  ot, make sure th
25c50 61 74 20 74 68 65 20 53 48 4d 20 66 69 6c 65 0a  at the SHM file.
25c60 20 20 20 20 20 20 2a 2a 20 69 73 20 6f 77 6e 65        ** is owne
25c70 64 20 62 79 20 74 68 65 20 73 61 6d 65 20 75 73  d by the same us
25c80 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 68 65  er that owns the
25c90 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61   original databa
25ca0 73 65 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 0a  se.  Otherwise,.
25cb0 20 20 20 20 20 20 2a 2a 20 74 68 65 20 6f 72 69        ** the ori
25cc0 67 69 6e 61 6c 20 6f 77 6e 65 72 20 77 69 6c 6c  ginal owner will
25cd0 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 20   not be able to 
25ce0 63 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 20 20 2a  connect..      *
25cf0 2f 0a 20 20 20 20 20 20 72 6f 62 75 73 74 46 63  /.      robustFc
25d00 68 6f 77 6e 28 70 53 68 6d 4e 6f 64 65 2d 3e 68  hown(pShmNode->h
25d10 53 68 6d 2c 20 73 53 74 61 74 2e 73 74 5f 75 69  Shm, sStat.st_ui
25d20 64 2c 20 73 53 74 61 74 2e 73 74 5f 67 69 64 29  d, sStat.st_gid)
25d30 3b 0a 0a 20 20 20 20 20 20 72 63 20 3d 20 75 6e  ;..      rc = un
25d40 69 78 4c 6f 63 6b 53 68 61 72 65 64 4d 65 6d 6f  ixLockSharedMemo
25d50 72 79 28 70 44 62 46 64 2c 20 70 53 68 6d 4e 6f  ry(pDbFd, pShmNo
25d60 64 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  de);.      if( r
25d70 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c!=SQLITE_OK && 
25d80 72 63 21 3d 53 51 4c 49 54 45 5f 52 45 41 44 4f  rc!=SQLITE_READO
25d90 4e 4c 59 5f 43 41 4e 54 49 4e 49 54 20 29 20 67  NLY_CANTINIT ) g
25da0 6f 74 6f 20 73 68 6d 5f 6f 70 65 6e 5f 65 72 72  oto shm_open_err
25db0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
25dc0 2a 20 4d 61 6b 65 20 74 68 65 20 6e 65 77 20 63  * Make the new c
25dd0 6f 6e 6e 65 63 74 69 6f 6e 20 61 20 63 68 69 6c  onnection a chil
25de0 64 20 6f 66 20 74 68 65 20 75 6e 69 78 53 68 6d  d of the unixShm
25df0 4e 6f 64 65 20 2a 2f 0a 20 20 70 2d 3e 70 53 68  Node */.  p->pSh
25e00 6d 4e 6f 64 65 20 3d 20 70 53 68 6d 4e 6f 64 65  mNode = pShmNode
25e10 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
25e20 44 45 42 55 47 0a 20 20 70 2d 3e 69 64 20 3d 20  DEBUG.  p->id = 
25e30 70 53 68 6d 4e 6f 64 65 2d 3e 6e 65 78 74 53 68  pShmNode->nextSh
25e40 6d 49 64 2b 2b 3b 0a 23 65 6e 64 69 66 0a 20 20  mId++;.#endif.  
25e50 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 2b 2b  pShmNode->nRef++
25e60 3b 0a 20 20 70 44 62 46 64 2d 3e 70 53 68 6d 20  ;.  pDbFd->pShm 
25e70 3d 20 70 3b 0a 20 20 75 6e 69 78 4c 65 61 76 65  = p;.  unixLeave
25e80 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 54  Mutex();..  /* T
25e90 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75  he reference cou
25ea0 6e 74 20 6f 6e 20 70 53 68 6d 4e 6f 64 65 20 68  nt on pShmNode h
25eb0 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20  as already been 
25ec0 69 6e 63 72 65 6d 65 6e 74 65 64 20 75 6e 64 65  incremented unde
25ed0 72 0a 20 20 2a 2a 20 74 68 65 20 63 6f 76 65 72  r.  ** the cover
25ee0 20 6f 66 20 74 68 65 20 75 6e 69 78 45 6e 74 65   of the unixEnte
25ef0 72 4d 75 74 65 78 28 29 20 6d 75 74 65 78 20 61  rMutex() mutex a
25f00 6e 64 20 74 68 65 20 70 6f 69 6e 74 65 72 20 66  nd the pointer f
25f10 72 6f 6d 20 74 68 65 0a 20 20 2a 2a 20 6e 65 77  rom the.  ** new
25f20 20 28 73 74 72 75 63 74 20 75 6e 69 78 53 68 6d   (struct unixShm
25f30 29 20 6f 62 6a 65 63 74 20 74 6f 20 74 68 65 20  ) object to the 
25f40 70 53 68 6d 4e 6f 64 65 20 68 61 73 20 62 65 65  pShmNode has bee
25f50 6e 20 73 65 74 2e 20 41 6c 6c 20 74 68 61 74 20  n set. All that 
25f60 69 73 0a 20 20 2a 2a 20 6c 65 66 74 20 74 6f 20  is.  ** left to 
25f70 64 6f 20 69 73 20 74 6f 20 6c 69 6e 6b 20 74 68  do is to link th
25f80 65 20 6e 65 77 20 6f 62 6a 65 63 74 20 69 6e 74  e new object int
25f90 6f 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73  o the linked lis
25fa0 74 20 73 74 61 72 74 69 6e 67 0a 20 20 2a 2a 20  t starting.  ** 
25fb0 61 74 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69  at pShmNode->pFi
25fc0 72 73 74 2e 20 54 68 69 73 20 6d 75 73 74 20 62  rst. This must b
25fd0 65 20 64 6f 6e 65 20 77 68 69 6c 65 20 68 6f 6c  e done while hol
25fe0 64 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 70 53  ding the.  ** pS
25ff0 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d 75 74 65  hmNode->pShmMute
26000 78 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65  x..  */.  sqlite
26010 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 53  3_mutex_enter(pS
26020 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d 75 74 65  hmNode->pShmMute
26030 78 29 3b 0a 20 20 70 2d 3e 70 4e 65 78 74 20 3d  x);.  p->pNext =
26040 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73   pShmNode->pFirs
26050 74 3b 0a 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 70  t;.  pShmNode->p
26060 46 69 72 73 74 20 3d 20 70 3b 0a 20 20 73 71 6c  First = p;.  sql
26070 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
26080 28 70 53 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d  (pShmNode->pShmM
26090 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
260a0 72 63 3b 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 68  rc;..  /* Jump h
260b0 65 72 65 20 6f 6e 20 61 6e 79 20 65 72 72 6f 72  ere on any error
260c0 20 2a 2f 0a 73 68 6d 5f 6f 70 65 6e 5f 65 72 72   */.shm_open_err
260d0 3a 0a 20 20 75 6e 69 78 53 68 6d 50 75 72 67 65  :.  unixShmPurge
260e0 28 70 44 62 46 64 29 3b 20 20 20 20 20 20 20 2f  (pDbFd);       /
260f0 2a 20 54 68 69 73 20 63 61 6c 6c 20 66 72 65 65  * This call free
26100 73 20 70 53 68 6d 4e 6f 64 65 20 69 66 20 72 65  s pShmNode if re
26110 71 75 69 72 65 64 20 2a 2f 0a 20 20 73 71 6c 69  quired */.  sqli
26120 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 75  te3_free(p);.  u
26130 6e 69 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b  nixLeaveMutex();
26140 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
26150 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
26160 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74  tion is called t
26170 6f 20 6f 62 74 61 69 6e 20 61 20 70 6f 69 6e 74  o obtain a point
26180 65 72 20 74 6f 20 72 65 67 69 6f 6e 20 69 52 65  er to region iRe
26190 67 69 6f 6e 20 6f 66 20 74 68 65 20 0a 2a 2a 20  gion of the .** 
261a0 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 61 73  shared-memory as
261b0 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68  sociated with th
261c0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
261d0 66 64 2e 20 53 68 61 72 65 64 2d 6d 65 6d 6f 72  fd. Shared-memor
261e0 79 20 72 65 67 69 6f 6e 73 20 0a 2a 2a 20 61 72  y regions .** ar
261f0 65 20 6e 75 6d 62 65 72 65 64 20 73 74 61 72 74  e numbered start
26200 69 6e 67 20 66 72 6f 6d 20 7a 65 72 6f 2e 20 45  ing from zero. E
26210 61 63 68 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72  ach shared-memor
26220 79 20 72 65 67 69 6f 6e 20 69 73 20 73 7a 52 65  y region is szRe
26230 67 69 6f 6e 20 0a 2a 2a 20 62 79 74 65 73 20 69  gion .** bytes i
26240 6e 20 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 49 66  n size..**.** If
26250 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
26260 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  , an error code 
26270 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20  is returned and 
26280 2a 70 70 20 69 73 20 73 65 74 20 74 6f 20 4e 55  *pp is set to NU
26290 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77  LL..**.** Otherw
262a0 69 73 65 2c 20 69 66 20 74 68 65 20 62 45 78 74  ise, if the bExt
262b0 65 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73  end parameter is
262c0 20 30 20 61 6e 64 20 74 68 65 20 72 65 71 75 65   0 and the reque
262d0 73 74 65 64 20 73 68 61 72 65 64 2d 6d 65 6d 6f  sted shared-memo
262e0 72 79 0a 2a 2a 20 72 65 67 69 6f 6e 20 68 61 73  ry.** region has
262f0 20 6e 6f 74 20 62 65 65 6e 20 61 6c 6c 6f 63 61   not been alloca
26300 74 65 64 20 28 62 79 20 61 6e 79 20 63 6c 69 65  ted (by any clie
26310 6e 74 2c 20 69 6e 63 6c 75 64 69 6e 67 20 6f 6e  nt, including on
26320 65 20 72 75 6e 6e 69 6e 67 20 69 6e 20 61 0a 2a  e running in a.*
26330 2a 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65  * separate proce
26340 73 73 29 2c 20 74 68 65 6e 20 2a 70 70 20 69 73  ss), then *pp is
26350 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 61 6e 64   set to NULL and
26360 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72   SQLITE_OK retur
26370 6e 65 64 2e 20 49 66 20 0a 2a 2a 20 62 45 78 74  ned. If .** bExt
26380 65 6e 64 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 20  end is non-zero 
26390 61 6e 64 20 74 68 65 20 72 65 71 75 65 73 74 65  and the requeste
263a0 64 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20  d shared-memory 
263b0 72 65 67 69 6f 6e 20 68 61 73 20 6e 6f 74 20 79  region has not y
263c0 65 74 20 0a 2a 2a 20 62 65 65 6e 20 61 6c 6c 6f  et .** been allo
263d0 63 61 74 65 64 2c 20 69 74 20 69 73 20 61 6c 6c  cated, it is all
263e0 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 20 66  ocated by this f
263f0 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49  unction..**.** I
26400 66 20 74 68 65 20 73 68 61 72 65 64 2d 6d 65 6d  f the shared-mem
26410 6f 72 79 20 72 65 67 69 6f 6e 20 68 61 73 20 61  ory region has a
26420 6c 72 65 61 64 79 20 62 65 65 6e 20 61 6c 6c 6f  lready been allo
26430 63 61 74 65 64 20 6f 72 20 69 73 20 61 6c 6c 6f  cated or is allo
26440 63 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 69 73  cated by.** this
26450 20 63 61 6c 6c 20 61 73 20 64 65 73 63 72 69 62   call as describ
26460 65 64 20 61 62 6f 76 65 2c 20 74 68 65 6e 20 69  ed above, then i
26470 74 20 69 73 20 6d 61 70 70 65 64 20 69 6e 74 6f  t is mapped into
26480 20 74 68 69 73 20 70 72 6f 63 65 73 73 65 73 20   this processes 
26490 0a 2a 2a 20 61 64 64 72 65 73 73 20 73 70 61 63  .** address spac
264a0 65 20 28 69 66 20 69 74 20 69 73 20 6e 6f 74 20  e (if it is not 
264b0 61 6c 72 65 61 64 79 29 2c 20 2a 70 70 20 69 73  already), *pp is
264c0 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f   set to point to
264d0 20 74 68 65 20 6d 61 70 70 65 64 20 0a 2a 2a 20   the mapped .** 
264e0 6d 65 6d 6f 72 79 20 61 6e 64 20 53 51 4c 49 54  memory and SQLIT
264f0 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 0a 2a  E_OK returned..*
26500 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
26510 78 53 68 6d 4d 61 70 28 0a 20 20 73 71 6c 69 74  xShmMap(.  sqlit
26520 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 20 20 20  e3_file *fd,    
26530 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61             /* Ha
26540 6e 64 6c 65 20 6f 70 65 6e 20 6f 6e 20 64 61 74  ndle open on dat
26550 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20  abase file */.  
26560 69 6e 74 20 69 52 65 67 69 6f 6e 2c 20 20 20 20  int iRegion,    
26570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
26580 2f 2a 20 52 65 67 69 6f 6e 20 74 6f 20 72 65 74  /* Region to ret
26590 72 69 65 76 65 20 2a 2f 0a 20 20 69 6e 74 20 73  rieve */.  int s
265a0 7a 52 65 67 69 6f 6e 2c 20 20 20 20 20 20 20 20  zRegion,        
265b0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69             /* Si
265c0 7a 65 20 6f 66 20 72 65 67 69 6f 6e 73 20 2a 2f  ze of regions */
265d0 0a 20 20 69 6e 74 20 62 45 78 74 65 6e 64 2c 20  .  int bExtend, 
265e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
265f0 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 78     /* True to ex
26600 74 65 6e 64 20 66 69 6c 65 20 69 66 20 6e 65 63  tend file if nec
26610 65 73 73 61 72 79 20 2a 2f 0a 20 20 76 6f 69 64  essary */.  void
26620 20 76 6f 6c 61 74 69 6c 65 20 2a 2a 70 70 20 20   volatile **pp  
26630 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f              /* O
26640 55 54 3a 20 4d 61 70 70 65 64 20 6d 65 6d 6f 72  UT: Mapped memor
26650 79 20 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 46 69  y */.){.  unixFi
26660 6c 65 20 2a 70 44 62 46 64 20 3d 20 28 75 6e 69  le *pDbFd = (uni
26670 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20 75 6e 69  xFile*)fd;.  uni
26680 78 53 68 6d 20 2a 70 3b 0a 20 20 75 6e 69 78 53  xShm *p;.  unixS
26690 68 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f 64 65  hmNode *pShmNode
266a0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
266b0 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e 53  ITE_OK;.  int nS
266c0 68 6d 50 65 72 4d 61 70 20 3d 20 75 6e 69 78 53  hmPerMap = unixS
266d0 68 6d 52 65 67 69 6f 6e 50 65 72 4d 61 70 28 29  hmRegionPerMap()
266e0 3b 0a 20 20 69 6e 74 20 6e 52 65 71 52 65 67 69  ;.  int nReqRegi
266f0 6f 6e 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65  on;..  /* If the
26700 20 73 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 66   shared-memory f
26710 69 6c 65 20 68 61 73 20 6e 6f 74 20 79 65 74 20  ile has not yet 
26720 62 65 65 6e 20 6f 70 65 6e 65 64 2c 20 6f 70 65  been opened, ope
26730 6e 20 69 74 20 6e 6f 77 2e 20 2a 2f 0a 20 20 69  n it now. */.  i
26740 66 28 20 70 44 62 46 64 2d 3e 70 53 68 6d 3d 3d  f( pDbFd->pShm==
26750 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 75 6e  0 ){.    rc = un
26760 69 78 4f 70 65 6e 53 68 61 72 65 64 4d 65 6d 6f  ixOpenSharedMemo
26770 72 79 28 70 44 62 46 64 29 3b 0a 20 20 20 20 69  ry(pDbFd);.    i
26780 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
26790 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20   ) return rc;.  
267a0 7d 0a 0a 20 20 70 20 3d 20 70 44 62 46 64 2d 3e  }..  p = pDbFd->
267b0 70 53 68 6d 3b 0a 20 20 70 53 68 6d 4e 6f 64 65  pShm;.  pShmNode
267c0 20 3d 20 70 2d 3e 70 53 68 6d 4e 6f 64 65 3b 0a   = p->pShmNode;.
267d0 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
267e0 65 6e 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d 3e  enter(pShmNode->
267f0 70 53 68 6d 4d 75 74 65 78 29 3b 0a 20 20 69 66  pShmMutex);.  if
26800 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 69 73 55 6e  ( pShmNode->isUn
26810 6c 6f 63 6b 65 64 20 29 7b 0a 20 20 20 20 72 63  locked ){.    rc
26820 20 3d 20 75 6e 69 78 4c 6f 63 6b 53 68 61 72 65   = unixLockShare
26830 64 4d 65 6d 6f 72 79 28 70 44 62 46 64 2c 20 70  dMemory(pDbFd, p
26840 53 68 6d 4e 6f 64 65 29 3b 0a 20 20 20 20 69 66  ShmNode);.    if
26850 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
26860 29 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f 6f  ) goto shmpage_o
26870 75 74 3b 0a 20 20 20 20 70 53 68 6d 4e 6f 64 65  ut;.    pShmNode
26880 2d 3e 69 73 55 6e 6c 6f 63 6b 65 64 20 3d 20 30  ->isUnlocked = 0
26890 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
268a0 73 7a 52 65 67 69 6f 6e 3d 3d 70 53 68 6d 4e 6f  szRegion==pShmNo
268b0 64 65 2d 3e 73 7a 52 65 67 69 6f 6e 20 7c 7c 20  de->szRegion || 
268c0 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 67 69 6f  pShmNode->nRegio
268d0 6e 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74  n==0 );.  assert
268e0 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 49 6e 6f  ( pShmNode->pIno
268f0 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e 6f 64  de==pDbFd->pInod
26900 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  e );.  assert( p
26910 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 3e 3d 30  ShmNode->hShm>=0
26920 20 7c 7c 20 70 44 62 46 64 2d 3e 70 49 6e 6f 64   || pDbFd->pInod
26930 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b 3d  e->bProcessLock=
26940 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =1 );.  assert( 
26950 70 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 3c 30  pShmNode->hShm<0
26960 20 7c 7c 20 70 44 62 46 64 2d 3e 70 49 6e 6f 64   || pDbFd->pInod
26970 65 2d 3e 62 50 72 6f 63 65 73 73 4c 6f 63 6b 3d  e->bProcessLock=
26980 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 4d 69 6e 69  =0 );..  /* Mini
26990 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 72 65  mum number of re
269a0 67 69 6f 6e 73 20 72 65 71 75 69 72 65 64 20 74  gions required t
269b0 6f 20 62 65 20 6d 61 70 70 65 64 2e 20 2a 2f 0a  o be mapped. */.
269c0 20 20 6e 52 65 71 52 65 67 69 6f 6e 20 3d 20 28    nReqRegion = (
269d0 28 69 52 65 67 69 6f 6e 2b 6e 53 68 6d 50 65 72  (iRegion+nShmPer
269e0 4d 61 70 29 20 2f 20 6e 53 68 6d 50 65 72 4d 61  Map) / nShmPerMa
269f0 70 29 20 2a 20 6e 53 68 6d 50 65 72 4d 61 70 3b  p) * nShmPerMap;
26a00 0a 0a 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 65  ..  if( pShmNode
26a10 2d 3e 6e 52 65 67 69 6f 6e 3c 6e 52 65 71 52 65  ->nRegion<nReqRe
26a20 67 69 6f 6e 20 29 7b 0a 20 20 20 20 63 68 61 72  gion ){.    char
26a30 20 2a 2a 61 70 4e 65 77 3b 20 20 20 20 20 20 20   **apNew;       
26a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
26a50 2a 20 4e 65 77 20 61 70 52 65 67 69 6f 6e 5b 5d  * New apRegion[]
26a60 20 61 72 72 61 79 20 2a 2f 0a 20 20 20 20 69 6e   array */.    in
26a70 74 20 6e 42 79 74 65 20 3d 20 6e 52 65 71 52 65  t nByte = nReqRe
26a80 67 69 6f 6e 2a 73 7a 52 65 67 69 6f 6e 3b 20 20  gion*szRegion;  
26a90 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 72 65 71 75   /* Minimum requ
26aa0 69 72 65 64 20 66 69 6c 65 20 73 69 7a 65 20 2a  ired file size *
26ab0 2f 0a 20 20 20 20 73 74 72 75 63 74 20 73 74 61  /.    struct sta
26ac0 74 20 73 53 74 61 74 3b 20 20 20 20 20 20 20 20  t sStat;        
26ad0 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64           /* Used
26ae0 20 62 79 20 66 73 74 61 74 28 29 20 2a 2f 0a 0a   by fstat() */..
26af0 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 73 7a      pShmNode->sz
26b00 52 65 67 69 6f 6e 20 3d 20 73 7a 52 65 67 69 6f  Region = szRegio
26b10 6e 3b 0a 0a 20 20 20 20 69 66 28 20 70 53 68 6d  n;..    if( pShm
26b20 4e 6f 64 65 2d 3e 68 53 68 6d 3e 3d 30 20 29 7b  Node->hShm>=0 ){
26b30 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65  .      /* The re
26b40 71 75 65 73 74 65 64 20 72 65 67 69 6f 6e 20 69  quested region i
26b50 73 20 6e 6f 74 20 6d 61 70 70 65 64 20 69 6e 74  s not mapped int
26b60 6f 20 74 68 69 73 20 70 72 6f 63 65 73 73 65 73  o this processes
26b70 20 61 64 64 72 65 73 73 20 73 70 61 63 65 2e 0a   address space..
26b80 20 20 20 20 20 20 2a 2a 20 43 68 65 63 6b 20 74        ** Check t
26b90 6f 20 73 65 65 20 69 66 20 69 74 20 68 61 73 20  o see if it has 
26ba0 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 28  been allocated (
26bb0 69 2e 65 2e 20 69 66 20 74 68 65 20 77 61 6c 2d  i.e. if the wal-
26bc0 69 6e 64 65 78 20 66 69 6c 65 20 69 73 0a 20 20  index file is.  
26bd0 20 20 20 20 2a 2a 20 6c 61 72 67 65 20 65 6e 6f      ** large eno
26be0 75 67 68 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74  ugh to contain t
26bf0 68 65 20 72 65 71 75 65 73 74 65 64 20 72 65 67  he requested reg
26c00 69 6f 6e 29 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  ion)..      */. 
26c10 20 20 20 20 20 69 66 28 20 6f 73 46 73 74 61 74       if( osFstat
26c20 28 70 53 68 6d 4e 6f 64 65 2d 3e 68 53 68 6d 2c  (pShmNode->hShm,
26c30 20 26 73 53 74 61 74 29 20 29 7b 0a 20 20 20 20   &sStat) ){.    
26c40 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
26c50 49 4f 45 52 52 5f 53 48 4d 53 49 5a 45 3b 0a 20  IOERR_SHMSIZE;. 
26c60 20 20 20 20 20 20 20 67 6f 74 6f 20 73 68 6d 70         goto shmp
26c70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d  age_out;.      }
26c80 0a 20 20 0a 20 20 20 20 20 20 69 66 28 20 73 53  .  .      if( sS
26c90 74 61 74 2e 73 74 5f 73 69 7a 65 3c 6e 42 79 74  tat.st_size<nByt
26ca0 65 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20  e ){.        /* 
26cb0 54 68 65 20 72 65 71 75 65 73 74 65 64 20 6d 65  The requested me
26cc0 6d 6f 72 79 20 72 65 67 69 6f 6e 20 64 6f 65 73  mory region does
26cd0 20 6e 6f 74 20 65 78 69 73 74 2e 20 49 66 20 62   not exist. If b
26ce0 45 78 74 65 6e 64 20 69 73 20 73 65 74 20 74 6f  Extend is set to
26cf0 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 61 6c 73  .        ** fals
26d00 65 2c 20 65 78 69 74 20 65 61 72 6c 79 2e 20 2a  e, exit early. *
26d10 70 70 20 77 69 6c 6c 20 62 65 20 73 65 74 20 74  pp will be set t
26d20 6f 20 4e 55 4c 4c 20 61 6e 64 20 53 51 4c 49 54  o NULL and SQLIT
26d30 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 0a 20  E_OK returned.. 
26d40 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20         */.      
26d50 20 20 69 66 28 20 21 62 45 78 74 65 6e 64 20 29    if( !bExtend )
26d60 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f  {.          goto
26d70 20 73 68 6d 70 61 67 65 5f 6f 75 74 3b 0a 20 20   shmpage_out;.  
26d80 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20        }..       
26d90 20 2f 2a 20 41 6c 74 65 72 6e 61 74 69 76 65 6c   /* Alternativel
26da0 79 2c 20 69 66 20 62 45 78 74 65 6e 64 20 69 73  y, if bExtend is
26db0 20 74 72 75 65 2c 20 65 78 74 65 6e 64 20 74 68   true, extend th
26dc0 65 20 66 69 6c 65 2e 20 44 6f 20 74 68 69 73 20  e file. Do this 
26dd0 62 79 0a 20 20 20 20 20 20 20 20 2a 2a 20 77 72  by.        ** wr
26de0 69 74 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 62  iting a single b
26df0 79 74 65 20 74 6f 20 74 68 65 20 65 6e 64 20 6f  yte to the end o
26e00 66 20 65 61 63 68 20 28 4f 53 29 20 70 61 67 65  f each (OS) page
26e10 20 62 65 69 6e 67 0a 20 20 20 20 20 20 20 20 2a   being.        *
26e20 2a 20 61 6c 6c 6f 63 61 74 65 64 20 6f 72 20 65  * allocated or e
26e30 78 74 65 6e 64 65 64 2e 20 54 65 63 68 6e 69 63  xtended. Technic
26e40 61 6c 6c 79 2c 20 77 65 20 6e 65 65 64 20 6f 6e  ally, we need on
26e50 6c 79 20 77 72 69 74 65 20 74 6f 20 74 68 65 0a  ly write to the.
26e60 20 20 20 20 20 20 20 20 2a 2a 20 6c 61 73 74 20          ** last 
26e70 70 61 67 65 20 69 6e 20 6f 72 64 65 72 20 74 6f  page in order to
26e80 20 65 78 74 65 6e 64 20 74 68 65 20 66 69 6c 65   extend the file
26e90 2e 20 42 75 74 20 77 72 69 74 69 6e 67 20 74 6f  . But writing to
26ea0 20 61 6c 6c 20 6e 65 77 0a 20 20 20 20 20 20 20   all new.       
26eb0 20 2a 2a 20 70 61 67 65 73 20 66 6f 72 63 65 73   ** pages forces
26ec0 20 74 68 65 20 4f 53 20 74 6f 20 61 6c 6c 6f 63   the OS to alloc
26ed0 61 74 65 20 74 68 65 6d 20 69 6d 6d 65 64 69 61  ate them immedia
26ee0 74 65 6c 79 2c 20 77 68 69 63 68 20 72 65 64 75  tely, which redu
26ef0 63 65 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 74  ces.        ** t
26f00 68 65 20 63 68 61 6e 63 65 73 20 6f 66 20 53 49  he chances of SI
26f10 47 42 55 53 20 77 68 69 6c 65 20 61 63 63 65 73  GBUS while acces
26f20 73 69 6e 67 20 74 68 65 20 6d 61 70 70 65 64 20  sing the mapped 
26f30 72 65 67 69 6f 6e 20 6c 61 74 65 72 20 6f 6e 2e  region later on.
26f40 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  .        */.    
26f50 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 20 20      else{.      
26f60 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74      static const
26f70 20 69 6e 74 20 70 67 73 7a 20 3d 20 34 30 39 36   int pgsz = 4096
26f80 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20  ;.          int 
26f90 69 50 67 3b 0a 0a 20 20 20 20 20 20 20 20 20 20  iPg;..          
26fa0 2f 2a 20 57 72 69 74 65 20 74 6f 20 74 68 65 20  /* Write to the 
26fb0 6c 61 73 74 20 62 79 74 65 20 6f 66 20 65 61 63  last byte of eac
26fc0 68 20 6e 65 77 6c 79 20 61 6c 6c 6f 63 61 74 65  h newly allocate
26fd0 64 20 6f 72 20 65 78 74 65 6e 64 65 64 20 70 61  d or extended pa
26fe0 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20  ge */.          
26ff0 61 73 73 65 72 74 28 20 28 6e 42 79 74 65 20 25  assert( (nByte %
27000 20 70 67 73 7a 29 3d 3d 30 20 29 3b 0a 20 20 20   pgsz)==0 );.   
27010 20 20 20 20 20 20 20 66 6f 72 28 69 50 67 3d 28         for(iPg=(
27020 73 53 74 61 74 2e 73 74 5f 73 69 7a 65 2f 70 67  sStat.st_size/pg
27030 73 7a 29 3b 20 69 50 67 3c 28 6e 42 79 74 65 2f  sz); iPg<(nByte/
27040 70 67 73 7a 29 3b 20 69 50 67 2b 2b 29 7b 0a 20  pgsz); iPg++){. 
27050 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 78             int x
27060 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20   = 0;.          
27070 20 20 69 66 28 20 73 65 65 6b 41 6e 64 57 72 69    if( seekAndWri
27080 74 65 46 64 28 70 53 68 6d 4e 6f 64 65 2d 3e 68  teFd(pShmNode->h
27090 53 68 6d 2c 20 69 50 67 2a 70 67 73 7a 20 2b 20  Shm, iPg*pgsz + 
270a0 70 67 73 7a 2d 31 2c 22 22 2c 31 2c 26 78 29 21  pgsz-1,"",1,&x)!
270b0 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  =1 ){.          
270c0 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
270d0 7a 46 69 6c 65 20 3d 20 70 53 68 6d 4e 6f 64 65  zFile = pShmNode
270e0 2d 3e 7a 46 69 6c 65 6e 61 6d 65 3b 0a 20 20 20  ->zFilename;.   
270f0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20             rc = 
27100 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c  unixLogError(SQL
27110 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 53 49 5a  ITE_IOERR_SHMSIZ
27120 45 2c 20 22 77 72 69 74 65 22 2c 20 7a 46 69 6c  E, "write", zFil
27130 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  e);.            
27140 20 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f 6f    goto shmpage_o
27150 75 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ut;.            
27160 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  }.          }.  
27170 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
27180 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 4d 61      }..    /* Ma
27190 70 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20  p the requested 
271a0 6d 65 6d 6f 72 79 20 72 65 67 69 6f 6e 20 69 6e  memory region in
271b0 74 6f 20 74 68 69 73 20 70 72 6f 63 65 73 73 65  to this processe
271c0 73 20 61 64 64 72 65 73 73 20 73 70 61 63 65 2e  s address space.
271d0 20 2a 2f 0a 20 20 20 20 61 70 4e 65 77 20 3d 20   */.    apNew = 
271e0 28 63 68 61 72 20 2a 2a 29 73 71 6c 69 74 65 33  (char **)sqlite3
271f0 5f 72 65 61 6c 6c 6f 63 28 0a 20 20 20 20 20 20  _realloc(.      
27200 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 61 70 52 65    pShmNode->apRe
27210 67 69 6f 6e 2c 20 6e 52 65 71 52 65 67 69 6f 6e  gion, nReqRegion
27220 2a 73 69 7a 65 6f 66 28 63 68 61 72 20 2a 29 0a  *sizeof(char *).
27230 20 20 20 20 29 3b 0a 20 20 20 20 69 66 28 20 21      );.    if( !
27240 61 70 4e 65 77 20 29 7b 0a 20 20 20 20 20 20 72  apNew ){.      r
27250 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  c = SQLITE_IOERR
27260 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20  _NOMEM_BKPT;.   
27270 20 20 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f     goto shmpage_
27280 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  out;.    }.    p
27290 53 68 6d 4e 6f 64 65 2d 3e 61 70 52 65 67 69 6f  ShmNode->apRegio
272a0 6e 20 3d 20 61 70 4e 65 77 3b 0a 20 20 20 20 77  n = apNew;.    w
272b0 68 69 6c 65 28 20 70 53 68 6d 4e 6f 64 65 2d 3e  hile( pShmNode->
272c0 6e 52 65 67 69 6f 6e 3c 6e 52 65 71 52 65 67 69  nRegion<nReqRegi
272d0 6f 6e 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20  on ){.      int 
272e0 6e 4d 61 70 20 3d 20 73 7a 52 65 67 69 6f 6e 2a  nMap = szRegion*
272f0 6e 53 68 6d 50 65 72 4d 61 70 3b 0a 20 20 20 20  nShmPerMap;.    
27300 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 76    int i;.      v
27310 6f 69 64 20 2a 70 4d 65 6d 3b 0a 20 20 20 20 20  oid *pMem;.     
27320 20 69 66 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 68   if( pShmNode->h
27330 53 68 6d 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20  Shm>=0 ){.      
27340 20 20 70 4d 65 6d 20 3d 20 6f 73 4d 6d 61 70 28    pMem = osMmap(
27350 30 2c 20 6e 4d 61 70 2c 0a 20 20 20 20 20 20 20  0, nMap,.       
27360 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 69       pShmNode->i
27370 73 52 65 61 64 6f 6e 6c 79 20 3f 20 50 52 4f 54  sReadonly ? PROT
27380 5f 52 45 41 44 20 3a 20 50 52 4f 54 5f 52 45 41  _READ : PROT_REA
27390 44 7c 50 52 4f 54 5f 57 52 49 54 45 2c 20 0a 20  D|PROT_WRITE, . 
273a0 20 20 20 20 20 20 20 20 20 20 20 4d 41 50 5f 53             MAP_S
273b0 48 41 52 45 44 2c 20 70 53 68 6d 4e 6f 64 65 2d  HARED, pShmNode-
273c0 3e 68 53 68 6d 2c 20 73 7a 52 65 67 69 6f 6e 2a  >hShm, szRegion*
273d0 28 69 36 34 29 70 53 68 6d 4e 6f 64 65 2d 3e 6e  (i64)pShmNode->n
273e0 52 65 67 69 6f 6e 0a 20 20 20 20 20 20 20 20 29  Region.        )
273f0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 4d  ;.        if( pM
27400 65 6d 3d 3d 4d 41 50 5f 46 41 49 4c 45 44 20 29  em==MAP_FAILED )
27410 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d  {.          rc =
27420 20 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51   unixLogError(SQ
27430 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4d 4d 41  LITE_IOERR_SHMMA
27440 50 2c 20 22 6d 6d 61 70 22 2c 20 70 53 68 6d 4e  P, "mmap", pShmN
27450 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 3b  ode->zFilename);
27460 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20  .          goto 
27470 73 68 6d 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20  shmpage_out;.   
27480 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c       }.      }el
27490 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  se{.        pMem
274a0 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f   = sqlite3_mallo
274b0 63 36 34 28 73 7a 52 65 67 69 6f 6e 29 3b 0a 20  c64(szRegion);. 
274c0 20 20 20 20 20 20 20 69 66 28 20 70 4d 65 6d 3d         if( pMem=
274d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  =0 ){.          
274e0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  rc = SQLITE_NOME
274f0 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20  M_BKPT;.        
27500 20 20 67 6f 74 6f 20 73 68 6d 70 61 67 65 5f 6f    goto shmpage_o
27510 75 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ut;.        }.  
27520 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 4d 65        memset(pMe
27530 6d 2c 20 30 2c 20 73 7a 52 65 67 69 6f 6e 29 3b  m, 0, szRegion);
27540 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
27550 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 53 68 6d 50  for(i=0; i<nShmP
27560 65 72 4d 61 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  erMap; i++){.   
27570 20 20 20 20 20 70 53 68 6d 4e 6f 64 65 2d 3e 61       pShmNode->a
27580 70 52 65 67 69 6f 6e 5b 70 53 68 6d 4e 6f 64 65  pRegion[pShmNode
27590 2d 3e 6e 52 65 67 69 6f 6e 2b 69 5d 20 3d 20 26  ->nRegion+i] = &
275a0 28 28 63 68 61 72 2a 29 70 4d 65 6d 29 5b 73 7a  ((char*)pMem)[sz
275b0 52 65 67 69 6f 6e 2a 69 5d 3b 0a 20 20 20 20 20  Region*i];.     
275c0 20 7d 0a 20 20 20 20 20 20 70 53 68 6d 4e 6f 64   }.      pShmNod
275d0 65 2d 3e 6e 52 65 67 69 6f 6e 20 2b 3d 20 6e 53  e->nRegion += nS
275e0 68 6d 50 65 72 4d 61 70 3b 0a 20 20 20 20 7d 0a  hmPerMap;.    }.
275f0 20 20 7d 0a 0a 73 68 6d 70 61 67 65 5f 6f 75 74    }..shmpage_out
27600 3a 0a 20 20 69 66 28 20 70 53 68 6d 4e 6f 64 65  :.  if( pShmNode
27610 2d 3e 6e 52 65 67 69 6f 6e 3e 69 52 65 67 69 6f  ->nRegion>iRegio
27620 6e 20 29 7b 0a 20 20 20 20 2a 70 70 20 3d 20 70  n ){.    *pp = p
27630 53 68 6d 4e 6f 64 65 2d 3e 61 70 52 65 67 69 6f  ShmNode->apRegio
27640 6e 5b 69 52 65 67 69 6f 6e 5d 3b 0a 20 20 7d 65  n[iRegion];.  }e
27650 6c 73 65 7b 0a 20 20 20 20 2a 70 70 20 3d 20 30  lse{.    *pp = 0
27660 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 53 68 6d  ;.  }.  if( pShm
27670 4e 6f 64 65 2d 3e 69 73 52 65 61 64 6f 6e 6c 79  Node->isReadonly
27680 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f   && rc==SQLITE_O
27690 4b 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  K ) rc = SQLITE_
276a0 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 73 71 6c 69  READONLY;.  sqli
276b0 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
276c0 70 53 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d 75  pShmNode->pShmMu
276d0 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  tex);.  return r
276e0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  c;.}../*.** Chan
276f0 67 65 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74  ge the lock stat
27700 65 20 66 6f 72 20 61 20 73 68 61 72 65 64 2d 6d  e for a shared-m
27710 65 6d 6f 72 79 20 73 65 67 6d 65 6e 74 2e 0a 2a  emory segment..*
27720 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74  *.** Note that t
27730 68 65 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 20  he relationship 
27740 62 65 74 77 65 65 6e 20 53 48 41 52 45 64 20 61  between SHAREd a
27750 6e 64 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63  nd EXCLUSIVE loc
27760 6b 73 20 69 73 20 61 20 6c 69 74 74 6c 65 0a 2a  ks is a little.*
27770 2a 20 64 69 66 66 65 72 65 6e 74 20 68 65 72 65  * different here
27780 20 74 68 61 6e 20 69 6e 20 70 6f 73 69 78 2e 20   than in posix. 
27790 20 49 6e 20 78 53 68 6d 4c 6f 63 6b 28 29 2c 20   In xShmLock(), 
277a0 6f 6e 65 20 63 61 6e 20 67 6f 20 66 72 6f 6d 20  one can go from 
277b0 75 6e 6c 6f 63 6b 65 64 0a 2a 2a 20 74 6f 20 73  unlocked.** to s
277c0 68 61 72 65 64 20 61 6e 64 20 62 61 63 6b 20 6f  hared and back o
277d0 72 20 66 72 6f 6d 20 75 6e 6c 6f 63 6b 65 64 20  r from unlocked 
277e0 74 6f 20 65 78 63 6c 75 73 69 76 65 20 61 6e 64  to exclusive and
277f0 20 62 61 63 6b 2e 20 20 42 75 74 20 6f 6e 65 20   back.  But one 
27800 6d 61 79 0a 2a 2a 20 6e 6f 74 20 67 6f 20 66 72  may.** not go fr
27810 6f 6d 20 73 68 61 72 65 64 20 74 6f 20 65 78 63  om shared to exc
27820 6c 75 73 69 76 65 20 6f 72 20 66 72 6f 6d 20 65  lusive or from e
27830 78 63 6c 75 73 69 76 65 20 74 6f 20 73 68 61 72  xclusive to shar
27840 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ed..*/.static in
27850 74 20 75 6e 69 78 53 68 6d 4c 6f 63 6b 28 0a 20  t unixShmLock(. 
27860 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66   sqlite3_file *f
27870 64 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  d,          /* D
27880 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 6f 6c  atabase file hol
27890 64 69 6e 67 20 74 68 65 20 73 68 61 72 65 64 20  ding the shared 
278a0 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 6e 74 20  memory */.  int 
278b0 6f 66 73 74 2c 20 20 20 20 20 20 20 20 20 20 20  ofst,           
278c0 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20         /* First 
278d0 6c 6f 63 6b 20 74 6f 20 61 63 71 75 69 72 65 20  lock to acquire 
278e0 6f 72 20 72 65 6c 65 61 73 65 20 2a 2f 0a 20 20  or release */.  
278f0 69 6e 74 20 6e 2c 20 20 20 20 20 20 20 20 20 20  int n,          
27900 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
27910 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 74 6f  mber of locks to
27920 20 61 63 71 75 69 72 65 20 6f 72 20 72 65 6c 65   acquire or rele
27930 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61  ase */.  int fla
27940 67 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20  gs              
27950 20 20 20 20 2f 2a 20 57 68 61 74 20 74 6f 20 64      /* What to d
27960 6f 20 77 69 74 68 20 74 68 65 20 6c 6f 63 6b 20  o with the lock 
27970 2a 2f 0a 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65  */.){.  unixFile
27980 20 2a 70 44 62 46 64 20 3d 20 28 75 6e 69 78 46   *pDbFd = (unixF
27990 69 6c 65 2a 29 66 64 3b 20 20 20 20 20 20 2f 2a  ile*)fd;      /*
279a0 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 68 6f 6c 64   Connection hold
279b0 69 6e 67 20 73 68 61 72 65 64 20 6d 65 6d 6f 72  ing shared memor
279c0 79 20 2a 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a  y */.  unixShm *
279d0 70 20 3d 20 70 44 62 46 64 2d 3e 70 53 68 6d 3b  p = pDbFd->pShm;
279e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
279f0 54 68 65 20 73 68 61 72 65 64 20 6d 65 6d 6f 72  The shared memor
27a00 79 20 62 65 69 6e 67 20 6c 6f 63 6b 65 64 20 2a  y being locked *
27a10 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70 58 3b  /.  unixShm *pX;
27a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
27a30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72            /* For
27a40 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 61 6c   looping over al
27a50 6c 20 73 69 62 6c 69 6e 67 73 20 2a 2f 0a 20 20  l siblings */.  
27a60 75 6e 69 78 53 68 6d 4e 6f 64 65 20 2a 70 53 68  unixShmNode *pSh
27a70 6d 4e 6f 64 65 20 3d 20 70 2d 3e 70 53 68 6d 4e  mNode = p->pShmN
27a80 6f 64 65 3b 20 20 2f 2a 20 54 68 65 20 75 6e 64  ode;  /* The und
27a90 65 72 6c 79 69 6e 67 20 66 69 6c 65 20 69 4e 6f  erlying file iNo
27aa0 64 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d  de */.  int rc =
27ab0 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20   SQLITE_OK;     
27ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
27ad0 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a   Result code */.
27ae0 20 20 75 31 36 20 6d 61 73 6b 3b 20 20 20 20 20    u16 mask;     
27af0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
27b00 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20          /* Mask 
27b10 6f 66 20 6c 6f 63 6b 73 20 74 6f 20 74 61 6b 65  of locks to take
27b20 20 6f 72 20 72 65 6c 65 61 73 65 20 2a 2f 0a 0a   or release */..
27b30 20 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f    assert( pShmNo
27b40 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e 6f 64  de==pDbFd->pInod
27b50 65 2d 3e 70 53 68 6d 4e 6f 64 65 20 29 3b 0a 20  e->pShmNode );. 
27b60 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f 64   assert( pShmNod
27b70 65 2d 3e 70 49 6e 6f 64 65 3d 3d 70 44 62 46 64  e->pInode==pDbFd
27b80 2d 3e 70 49 6e 6f 64 65 20 29 3b 0a 20 20 61 73  ->pInode );.  as
27b90 73 65 72 74 28 20 6f 66 73 74 3e 3d 30 20 26 26  sert( ofst>=0 &&
27ba0 20 6f 66 73 74 2b 6e 3c 3d 53 51 4c 49 54 45 5f   ofst+n<=SQLITE_
27bb0 53 48 4d 5f 4e 4c 4f 43 4b 20 29 3b 0a 20 20 61  SHM_NLOCK );.  a
27bc0 73 73 65 72 74 28 20 6e 3e 3d 31 20 29 3b 0a 20  ssert( n>=1 );. 
27bd0 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 3d 3d   assert( flags==
27be0 28 53 51 4c 49 54 45 5f 53 48 4d 5f 4c 4f 43 4b  (SQLITE_SHM_LOCK
27bf0 20 7c 20 53 51 4c 49 54 45 5f 53 48 4d 5f 53 48   | SQLITE_SHM_SH
27c00 41 52 45 44 29 0a 20 20 20 20 20 20 20 7c 7c 20  ARED).       || 
27c10 66 6c 61 67 73 3d 3d 28 53 51 4c 49 54 45 5f 53  flags==(SQLITE_S
27c20 48 4d 5f 4c 4f 43 4b 20 7c 20 53 51 4c 49 54 45  HM_LOCK | SQLITE
27c30 5f 53 48 4d 5f 45 58 43 4c 55 53 49 56 45 29 0a  _SHM_EXCLUSIVE).
27c40 20 20 20 20 20 20 20 7c 7c 20 66 6c 61 67 73 3d         || flags=
27c50 3d 28 53 51 4c 49 54 45 5f 53 48 4d 5f 55 4e 4c  =(SQLITE_SHM_UNL
27c60 4f 43 4b 20 7c 20 53 51 4c 49 54 45 5f 53 48 4d  OCK | SQLITE_SHM
27c70 5f 53 48 41 52 45 44 29 0a 20 20 20 20 20 20 20  _SHARED).       
27c80 7c 7c 20 66 6c 61 67 73 3d 3d 28 53 51 4c 49 54  || flags==(SQLIT
27c90 45 5f 53 48 4d 5f 55 4e 4c 4f 43 4b 20 7c 20 53  E_SHM_UNLOCK | S
27ca0 51 4c 49 54 45 5f 53 48 4d 5f 45 58 43 4c 55 53  QLITE_SHM_EXCLUS
27cb0 49 56 45 29 20 29 3b 0a 20 20 61 73 73 65 72 74  IVE) );.  assert
27cc0 28 20 6e 3d 3d 31 20 7c 7c 20 28 66 6c 61 67 73  ( n==1 || (flags
27cd0 20 26 20 53 51 4c 49 54 45 5f 53 48 4d 5f 45 58   & SQLITE_SHM_EX
27ce0 43 4c 55 53 49 56 45 29 21 3d 30 20 29 3b 0a 20  CLUSIVE)!=0 );. 
27cf0 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f 64   assert( pShmNod
27d00 65 2d 3e 68 53 68 6d 3e 3d 30 20 7c 7c 20 70 44  e->hShm>=0 || pD
27d10 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 62 50 72  bFd->pInode->bPr
27d20 6f 63 65 73 73 4c 6f 63 6b 3d 3d 31 20 29 3b 0a  ocessLock==1 );.
27d30 20 20 61 73 73 65 72 74 28 20 70 53 68 6d 4e 6f    assert( pShmNo
27d40 64 65 2d 3e 68 53 68 6d 3c 30 20 7c 7c 20 70 44  de->hShm<0 || pD
27d50 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 62 50 72  bFd->pInode->bPr
27d60 6f 63 65 73 73 4c 6f 63 6b 3d 3d 30 20 29 3b 0a  ocessLock==0 );.
27d70 0a 20 20 6d 61 73 6b 20 3d 20 28 31 3c 3c 28 6f  .  mask = (1<<(o
27d80 66 73 74 2b 6e 29 29 20 2d 20 28 31 3c 3c 6f 66  fst+n)) - (1<<of
27d90 73 74 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e  st);.  assert( n
27da0 3e 31 20 7c 7c 20 6d 61 73 6b 3d 3d 28 31 3c 3c  >1 || mask==(1<<
27db0 6f 66 73 74 29 20 29 3b 0a 20 20 73 71 6c 69 74  ofst) );.  sqlit
27dc0 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
27dd0 53 68 6d 4e 6f 64 65 2d 3e 70 53 68 6d 4d 75 74  ShmNode->pShmMut
27de0 65 78 29 3b 0a 20 20 69 66 28 20 66 6c 61 67 73  ex);.  if( flags
27df0 20 26 20 53 51 4c 49 54 45 5f 53 48 4d 5f 55 4e   & SQLITE_SHM_UN
27e00 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 75 31 36 20  LOCK ){.    u16 
27e10 61 6c 6c 4d 61 73 6b 20 3d 20 30 3b 20 2f 2a 20  allMask = 0; /* 
27e20 4d 61 73 6b 20 6f 66 20 6c 6f 63 6b 73 20 68 65  Mask of locks he
27e30 6c 64 20 62 79 20 73 69 62 6c 69 6e 67 73 20 2a  ld by siblings *
27e40 2f 0a 0a 20 20 20 20 2f 2a 20 53 65 65 20 69 66  /..    /* See if
27e50 20 61 6e 79 20 73 69 62 6c 69 6e 67 73 20 68 6f   any siblings ho
27e60 6c 64 20 74 68 69 73 20 73 61 6d 65 20 6c 6f 63  ld this same loc
27e70 6b 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 58 3d  k */.    for(pX=
27e80 70 53 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74  pShmNode->pFirst
27e90 3b 20 70 58 3b 20 70 58 3d 70 58 2d 3e 70 4e 65  ; pX; pX=pX->pNe
27ea0 78 74 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  xt){.      if( p
27eb0 58 3d 3d 70 20 29 20 63 6f 6e 74 69 6e 75 65 3b  X==p ) continue;
27ec0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28  .      assert( (
27ed0 70 58 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 20 28  pX->exclMask & (
27ee0 70 2d 3e 65 78 63 6c 4d 61 73 6b 7c 70 2d 3e 73  p->exclMask|p->s
27ef0 68 61 72 65 64 4d 61 73 6b 29 29 3d 3d 30 20 29  haredMask))==0 )
27f00 3b 0a 20 20 20 20 20 20 61 6c 6c 4d 61 73 6b 20  ;.      allMask 
27f10 7c 3d 20 70 58 2d 3e 73 68 61 72 65 64 4d 61 73  |= pX->sharedMas
27f20 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a  k;.    }..    /*
27f30 20 55 6e 6c 6f 63 6b 20 74 68 65 20 73 79 73 74   Unlock the syst
27f40 65 6d 2d 6c 65 76 65 6c 20 6c 6f 63 6b 73 20 2a  em-level locks *
27f50 2f 0a 20 20 20 20 69 66 28 20 28 6d 61 73 6b 20  /.    if( (mask 
27f60 26 20 61 6c 6c 4d 61 73 6b 29 3d 3d 30 20 29 7b  & allMask)==0 ){
27f70 0a 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78  .      rc = unix
27f80 53 68 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 70 44  ShmSystemLock(pD
27f90 62 46 64 2c 20 46 5f 55 4e 4c 43 4b 2c 20 6f 66  bFd, F_UNLCK, of
27fa0 73 74 2b 55 4e 49 58 5f 53 48 4d 5f 42 41 53 45  st+UNIX_SHM_BASE
27fb0 2c 20 6e 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  , n);.    }else{
27fc0 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49  .      rc = SQLI
27fd0 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 0a 20 20  TE_OK;.    }..  
27fe0 20 20 2f 2a 20 55 6e 64 6f 20 74 68 65 20 6c 6f    /* Undo the lo
27ff0 63 61 6c 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 20  cal locks */.   
28000 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
28010 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 65  OK ){.      p->e
28020 78 63 6c 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b  xclMask &= ~mask
28030 3b 0a 20 20 20 20 20 20 70 2d 3e 73 68 61 72 65  ;.      p->share
28040 64 4d 61 73 6b 20 26 3d 20 7e 6d 61 73 6b 3b 0a  dMask &= ~mask;.
28050 20 20 20 20 7d 20 0a 20 20 7d 65 6c 73 65 20 69      } .  }else i
28060 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54  f( flags & SQLIT
28070 45 5f 53 48 4d 5f 53 48 41 52 45 44 20 29 7b 0a  E_SHM_SHARED ){.
28080 20 20 20 20 75 31 36 20 61 6c 6c 53 68 61 72 65      u16 allShare
28090 64 20 3d 20 30 3b 20 20 2f 2a 20 55 6e 69 6f 6e  d = 0;  /* Union
280a0 20 6f 66 20 6c 6f 63 6b 73 20 68 65 6c 64 20 62   of locks held b
280b0 79 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 74  y connections ot
280c0 68 65 72 20 74 68 61 6e 20 22 70 22 20 2a 2f 0a  her than "p" */.
280d0 0a 20 20 20 20 2f 2a 20 46 69 6e 64 20 6f 75 74  .    /* Find out
280e0 20 77 68 69 63 68 20 73 68 61 72 65 64 20 6c 6f   which shared lo
280f0 63 6b 73 20 61 72 65 20 61 6c 72 65 61 64 79 20  cks are already 
28100 68 65 6c 64 20 62 79 20 73 69 62 6c 69 6e 67 20  held by sibling 
28110 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0a 20 20 20  connections..   
28120 20 2a 2a 20 49 66 20 61 6e 79 20 73 69 62 6c 69   ** If any sibli
28130 6e 67 20 61 6c 72 65 61 64 79 20 68 6f 6c 64 73  ng already holds
28140 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f   an exclusive lo
28150 63 6b 2c 20 67 6f 20 61 68 65 61 64 20 61 6e 64  ck, go ahead and
28160 20 72 65 74 75 72 6e 0a 20 20 20 20 2a 2a 20 53   return.    ** S
28170 51 4c 49 54 45 5f 42 55 53 59 2e 0a 20 20 20 20  QLITE_BUSY..    
28180 2a 2f 0a 20 20 20 20 66 6f 72 28 70 58 3d 70 53  */.    for(pX=pS
28190 68 6d 4e 6f 64 65 2d 3e 70 46 69 72 73 74 3b 20  hmNode->pFirst; 
281a0 70 58 3b 20 70 58 3d 70 58 2d 3e 70 4e 65 78 74  pX; pX=pX->pNext
281b0 29 7b 0a 20 20 20 20 20 20 69 66 28 20 28 70 58  ){.      if( (pX
281c0 2d 3e 65 78 63 6c 4d 61 73 6b 20 26 20 6d 61 73  ->exclMask & mas
281d0 6b 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  k)!=0 ){.       
281e0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53   rc = SQLITE_BUS
281f0 59 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  Y;.        break
28200 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
28210 61 6c 6c 53 68 61 72 65 64 20 7c 3d 20 70 58 2d  allShared |= pX-
28220 3e 73 68 61 72 65 64 4d 61 73 6b 3b 0a 20 20 20  >sharedMask;.   
28230 20 7d 0a 0a 20 20 20 20 2f 2a 20 47 65 74 20 73   }..    /* Get s
28240 68 61 72 65 64 20 6c 6f 63 6b 73 20 61 74 20 74  hared locks at t
28250 68 65 20 73 79 73 74 65 6d 20 6c 65 76 65 6c 2c  he system level,
28260 20 69 66 20 6e 65 63 65 73 73 61 72 79 20 2a 2f   if necessary */
28270 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  .    if( rc==SQL
28280 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
28290 69 66 28 20 28 61 6c 6c 53 68 61 72 65 64 20 26  if( (allShared &
282a0 20 6d 61 73 6b 29 3d 3d 30 20 29 7b 0a 20 20 20   mask)==0 ){.   
282b0 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78 53 68       rc = unixSh
282c0 6d 53 79 73 74 65 6d 4c 6f 63 6b 28 70 44 62 46  mSystemLock(pDbF
282d0 64 2c 20 46 5f 52 44 4c 43 4b 2c 20 6f 66 73 74  d, F_RDLCK, ofst
282e0 2b 55 4e 49 58 5f 53 48 4d 5f 42 41 53 45 2c 20  +UNIX_SHM_BASE, 
282f0 6e 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  n);.      }else{
28300 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51  .        rc = SQ
28310 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d  LITE_OK;.      }
28320 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 47  .    }..    /* G
28330 65 74 20 74 68 65 20 6c 6f 63 61 6c 20 73 68 61  et the local sha
28340 72 65 64 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 20  red locks */.   
28350 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
28360 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 73  OK ){.      p->s
28370 68 61 72 65 64 4d 61 73 6b 20 7c 3d 20 6d 61 73  haredMask |= mas
28380 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  k;.    }.  }else
28390 7b 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75  {.    /* Make su
283a0 72 65 20 6e 6f 20 73 69 62 6c 69 6e 67 20 63 6f  re no sibling co
283b0 6e 6e 65 63 74 69 6f 6e 73 20 68 6f 6c 64 20 6c  nnections hold l
283c0 6f 63 6b 73 20 74 68 61 74 20 77 69 6c 6c 20 62  ocks that will b
283d0 6c 6f 63 6b 20 74 68 69 73 0a 20 20 20 20 2a 2a  lock this.    **
283e0 20 6c 6f 63 6b 2e 20 20 49 66 20 61 6e 79 20 64   lock.  If any d
283f0 6f 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  o, return SQLITE
28400 5f 42 55 53 59 20 72 69 67 68 74 20 61 77 61 79  _BUSY right away
28410 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72  ..    */.    for
28420 28 70 58 3d 70 53 68 6d 4e 6f 64 65 2d 3e 70 46  (pX=pShmNode->pF
28430 69 72 73 74 3b 20 70 58 3b 20 70 58 3d 70 58 2d  irst; pX; pX=pX-
28440 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 69  >pNext){.      i
28450 66 28 20 28 70 58 2d 3e 65 78 63 6c 4d 61 73 6b  f( (pX->exclMask
28460 20 26 20 6d 61 73 6b 29 21 3d 30 20 7c 7c 20 28   & mask)!=0 || (
28470 70 58 2d 3e 73 68 61 72 65 64 4d 61 73 6b 20 26  pX->sharedMask &
28480 20 6d 61 73 6b 29 21 3d 30 20 29 7b 0a 20 20 20   mask)!=0 ){.   
28490 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
284a0 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 20 20 62  _BUSY;.        b
284b0 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20  reak;.      }.  
284c0 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 47 65    }.  .    /* Ge
284d0 74 20 74 68 65 20 65 78 63 6c 75 73 69 76 65 20  t the exclusive 
284e0 6c 6f 63 6b 73 20 61 74 20 74 68 65 20 73 79 73  locks at the sys
284f0 74 65 6d 20 6c 65 76 65 6c 2e 20 20 54 68 65 6e  tem level.  Then
28500 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 0a 20   if successful. 
28510 20 20 20 2a 2a 20 61 6c 73 6f 20 6d 61 72 6b 20     ** also mark 
28520 74 68 65 20 6c 6f 63 61 6c 20 63 6f 6e 6e 65 63  the local connec
28530 74 69 6f 6e 20 61 73 20 62 65 69 6e 67 20 6c 6f  tion as being lo
28540 63 6b 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  cked..    */.   
28550 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
28560 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  OK ){.      rc =
28570 20 75 6e 69 78 53 68 6d 53 79 73 74 65 6d 4c 6f   unixShmSystemLo
28580 63 6b 28 70 44 62 46 64 2c 20 46 5f 57 52 4c 43  ck(pDbFd, F_WRLC
28590 4b 2c 20 6f 66 73 74 2b 55 4e 49 58 5f 53 48 4d  K, ofst+UNIX_SHM
285a0 5f 42 41 53 45 2c 20 6e 29 3b 0a 20 20 20 20 20  _BASE, n);.     
285b0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
285c0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73  OK ){.        as
285d0 73 65 72 74 28 20 28 70 2d 3e 73 68 61 72 65 64  sert( (p->shared
285e0 4d 61 73 6b 20 26 20 6d 61 73 6b 29 3d 3d 30 20  Mask & mask)==0 
285f0 29 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 78  );.        p->ex
28600 63 6c 4d 61 73 6b 20 7c 3d 20 6d 61 73 6b 3b 0a  clMask |= mask;.
28610 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
28620 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  }.  sqlite3_mute
28630 78 5f 6c 65 61 76 65 28 70 53 68 6d 4e 6f 64 65  x_leave(pShmNode
28640 2d 3e 70 53 68 6d 4d 75 74 65 78 29 3b 0a 20 20  ->pShmMutex);.  
28650 4f 53 54 52 41 43 45 28 28 22 53 48 4d 2d 4c 4f  OSTRACE(("SHM-LO
28660 43 4b 20 73 68 6d 69 64 2d 25 64 2c 20 70 69 64  CK shmid-%d, pid
28670 2d 25 64 20 67 6f 74 20 25 30 33 78 2c 25 30 33  -%d got %03x,%03
28680 78 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20  x\n",.          
28690 20 70 2d 3e 69 64 2c 20 6f 73 47 65 74 70 69 64   p->id, osGetpid
286a0 28 30 29 2c 20 70 2d 3e 73 68 61 72 65 64 4d 61  (0), p->sharedMa
286b0 73 6b 2c 20 70 2d 3e 65 78 63 6c 4d 61 73 6b 29  sk, p->exclMask)
286c0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
286d0 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65  }../*.** Impleme
286e0 6e 74 20 61 20 6d 65 6d 6f 72 79 20 62 61 72 72  nt a memory barr
286f0 69 65 72 20 6f 72 20 6d 65 6d 6f 72 79 20 66 65  ier or memory fe
28700 6e 63 65 20 6f 6e 20 73 68 61 72 65 64 20 6d 65  nce on shared me
28710 6d 6f 72 79 2e 20 20 0a 2a 2a 0a 2a 2a 20 41 6c  mory.  .**.** Al
28720 6c 20 6c 6f 61 64 73 20 61 6e 64 20 73 74 6f 72  l loads and stor
28730 65 73 20 62 65 67 75 6e 20 62 65 66 6f 72 65 20  es begun before 
28740 74 68 65 20 62 61 72 72 69 65 72 20 6d 75 73 74  the barrier must
28750 20 63 6f 6d 70 6c 65 74 65 20 62 65 66 6f 72 65   complete before
28760 0a 2a 2a 20 61 6e 79 20 6c 6f 61 64 20 6f 72 20  .** any load or 
28770 73 74 6f 72 65 20 62 65 67 75 6e 20 61 66 74 65  store begun afte
28780 72 20 74 68 65 20 62 61 72 72 69 65 72 2e 0a 2a  r the barrier..*
28790 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e  /.static void un
287a0 69 78 53 68 6d 42 61 72 72 69 65 72 28 0a 20 20  ixShmBarrier(.  
287b0 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64  sqlite3_file *fd
287c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
287d0 2f 2a 20 44 61 74 61 62 61 73 65 20 66 69 6c 65  /* Database file
287e0 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 73 68 61   holding the sha
287f0 72 65 64 20 6d 65 6d 6f 72 79 20 2a 2f 0a 29 7b  red memory */.){
28800 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
28810 54 45 52 28 66 64 29 3b 0a 20 20 73 71 6c 69 74  TER(fd);.  sqlit
28820 65 33 4d 65 6d 6f 72 79 42 61 72 72 69 65 72 28  e3MemoryBarrier(
28830 29 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 63 6f  );         /* co
28840 6d 70 69 6c 65 72 2d 64 65 66 69 6e 65 64 20 6d  mpiler-defined m
28850 65 6d 6f 72 79 20 62 61 72 72 69 65 72 20 2a 2f  emory barrier */
28860 0a 20 20 61 73 73 65 72 74 28 20 66 64 2d 3e 70  .  assert( fd->p
28870 4d 65 74 68 6f 64 73 2d 3e 78 4c 6f 63 6b 3d 3d  Methods->xLock==
28880 6e 6f 6c 6f 63 6b 4c 6f 63 6b 20 0a 20 20 20 20  nolockLock .    
28890 20 20 20 7c 7c 20 75 6e 69 78 46 69 6c 65 4d 75     || unixFileMu
288a0 74 65 78 4e 6f 74 68 65 6c 64 28 28 75 6e 69 78  texNotheld((unix
288b0 46 69 6c 65 2a 29 66 64 29 20 0a 20 20 29 3b 0a  File*)fd) .  );.
288c0 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74 65 78    unixEnterMutex
288d0 28 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ();             
288e0 20 20 2f 2a 20 41 6c 73 6f 20 6d 75 74 65 78 2c    /* Also mutex,
288f0 20 66 6f 72 20 72 65 64 75 6e 64 61 6e 63 79 20   for redundancy 
28900 2a 2f 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75  */.  unixLeaveMu
28910 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  tex();.}../*.** 
28920 43 6c 6f 73 65 20 61 20 63 6f 6e 6e 65 63 74 69  Close a connecti
28930 6f 6e 20 74 6f 20 73 68 61 72 65 64 2d 6d 65 6d  on to shared-mem
28940 6f 72 79 2e 20 20 44 65 6c 65 74 65 20 74 68 65  ory.  Delete the
28950 20 75 6e 64 65 72 6c 79 69 6e 67 20 0a 2a 2a 20   underlying .** 
28960 73 74 6f 72 61 67 65 20 69 66 20 64 65 6c 65 74  storage if delet
28970 65 46 6c 61 67 20 69 73 20 74 72 75 65 2e 0a 2a  eFlag is true..*
28980 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73  *.** If there is
28990 20 6e 6f 20 73 68 61 72 65 64 20 6d 65 6d 6f 72   no shared memor
289a0 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  y associated wit
289b0 68 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  h the connection
289c0 20 74 68 65 6e 20 74 68 69 73 0a 2a 2a 20 72 6f   then this.** ro
289d0 75 74 69 6e 65 20 69 73 20 61 20 68 61 72 6d 6c  utine is a harml
289e0 65 73 73 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74  ess no-op..*/.st
289f0 61 74 69 63 20 69 6e 74 20 75 6e 69 78 53 68 6d  atic int unixShm
28a00 55 6e 6d 61 70 28 0a 20 20 73 71 6c 69 74 65 33  Unmap(.  sqlite3
28a10 5f 66 69 6c 65 20 2a 66 64 2c 20 20 20 20 20 20  _file *fd,      
28a20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
28a30 75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62  underlying datab
28a40 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e  ase file */.  in
28a50 74 20 64 65 6c 65 74 65 46 6c 61 67 20 20 20 20  t deleteFlag    
28a60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
28a70 20 44 65 6c 65 74 65 20 73 68 61 72 65 64 2d 6d   Delete shared-m
28a80 65 6d 6f 72 79 20 69 66 20 74 72 75 65 20 2a 2f  emory if true */
28a90 0a 29 7b 0a 20 20 75 6e 69 78 53 68 6d 20 2a 70  .){.  unixShm *p
28aa0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
28ab0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e        /* The con
28ac0 6e 65 63 74 69 6f 6e 20 74 6f 20 62 65 20 63 6c  nection to be cl
28ad0 6f 73 65 64 20 2a 2f 0a 20 20 75 6e 69 78 53 68  osed */.  unixSh
28ae0 6d 4e 6f 64 65 20 2a 70 53 68 6d 4e 6f 64 65 3b  mNode *pShmNode;
28af0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
28b00 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 68 61 72   underlying shar
28b10 65 64 2d 6d 65 6d 6f 72 79 20 66 69 6c 65 20 2a  ed-memory file *
28b20 2f 0a 20 20 75 6e 69 78 53 68 6d 20 2a 2a 70 70  /.  unixShm **pp
28b30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
28b40 20 20 20 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69      /* For loopi
28b50 6e 67 20 6f 76 65 72 20 73 69 62 6c 69 6e 67 20  ng over sibling 
28b60 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 20  connections */. 
28b70 20 75 6e 69 78 46 69 6c 65 20 2a 70 44 62 46 64   unixFile *pDbFd
28b80 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
28b90 20 2f 2a 20 54 68 65 20 75 6e 64 65 72 6c 79 69   /* The underlyi
28ba0 6e 67 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ng database file
28bb0 20 2a 2f 0a 0a 20 20 70 44 62 46 64 20 3d 20 28   */..  pDbFd = (
28bc0 75 6e 69 78 46 69 6c 65 2a 29 66 64 3b 0a 20 20  unixFile*)fd;.  
28bd0 70 20 3d 20 70 44 62 46 64 2d 3e 70 53 68 6d 3b  p = pDbFd->pShm;
28be0 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65  .  if( p==0 ) re
28bf0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
28c00 20 20 70 53 68 6d 4e 6f 64 65 20 3d 20 70 2d 3e    pShmNode = p->
28c10 70 53 68 6d 4e 6f 64 65 3b 0a 0a 20 20 61 73 73  pShmNode;..  ass
28c20 65 72 74 28 20 70 53 68 6d 4e 6f 64 65 3d 3d 70  ert( pShmNode==p
28c30 44 62 46 64 2d 3e 70 49 6e 6f 64 65 2d 3e 70 53  DbFd->pInode->pS
28c40 68 6d 4e 6f 64 65 20 29 3b 0a 20 20 61 73 73 65  hmNode );.  asse
28c50 72 74 28 20 70 53 68 6d 4e 6f 64 65 2d 3e 70 49  rt( pShmNode->pI
28c60 6e 6f 64 65 3d 3d 70 44 62 46 64 2d 3e 70 49 6e  node==pDbFd->pIn
28c70 6f 64 65 20 29 3b 0a 0a 20 20 2f 2a 20 52 65 6d  ode );..  /* Rem
28c80 6f 76 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70  ove connection p
28c90 20 66 72 6f 6d 20 74 68 65 20 73 65 74 20 6f 66   from the set of
28ca0 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 73 73   connections ass
28cb0 6f 63 69 61 74 65 64 0a 20 20 2a 2a 20 77 69 74  ociated.  ** wit
28cc0 68 20 70 53 68 6d 4e 6f 64 65 20 2a 2f 0a 20 20  h pShmNode */.  
28cd0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
28ce0 74 65 72 28 70 53 68 6d 4e 6f 64 65 2d 3e 70 53  ter(pShmNode->pS
28cf0 68 6d 4d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28  hmMutex);.  for(
28d00 70 70 3d 26 70 53 68 6d 4e 6f 64 65 2d 3e 70 46  pp=&pShmNode->pF
28d10 69 72 73 74 3b 20 28 2a 70 70 29 21 3d 70 3b 20  irst; (*pp)!=p; 
28d20 70 70 20 3d 20 26 28 2a 70 70 29 2d 3e 70 4e 65  pp = &(*pp)->pNe
28d30 78 74 29 7b 7d 0a 20 20 2a 70 70 20 3d 20 70 2d  xt){}.  *pp = p-
28d40 3e 70 4e 65 78 74 3b 0a 0a 20 20 2f 2a 20 46 72  >pNext;..  /* Fr
28d50 65 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f  ee the connectio
28d60 6e 20 70 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  n p */.  sqlite3
28d70 5f 66 72 65 65 28 70 29 3b 0a 20 20 70 44 62 46  _free(p);.  pDbF
28d80 64 2d 3e 70 53 68 6d 20 3d 20 30 3b 0a 20 20 73  d->pShm = 0;.  s
28d90 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
28da0 76 65 28 70 53 68 6d 4e 6f 64 65 2d 3e 70 53 68  ve(pShmNode->pSh
28db0 6d 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 49  mMutex);..  /* I
28dc0 66 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66  f pShmNode->nRef
28dd0 20 68 61 73 20 72 65 61 63 68 65 64 20 30 2c 20   has reached 0, 
28de0 74 68 65 6e 20 63 6c 6f 73 65 20 74 68 65 20 75  then close the u
28df0 6e 64 65 72 6c 79 69 6e 67 0a 20 20 2a 2a 20 73  nderlying.  ** s
28e00 68 61 72 65 64 2d 6d 65 6d 6f 72 79 20 66 69 6c  hared-memory fil
28e10 65 2c 20 74 6f 6f 20 2a 2f 0a 20 20 61 73 73 65  e, too */.  asse
28e20 72 74 28 20 75 6e 69 78 46 69 6c 65 4d 75 74 65  rt( unixFileMute
28e30 78 4e 6f 74 68 65 6c 64 28 70 44 62 46 64 29 20  xNotheld(pDbFd) 
28e40 29 3b 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75  );.  unixEnterMu
28e50 74 65 78 28 29 3b 0a 20 20 61 73 73 65 72 74 28  tex();.  assert(
28e60 20 70 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 3e   pShmNode->nRef>
28e70 30 20 29 3b 0a 20 20 70 53 68 6d 4e 6f 64 65 2d  0 );.  pShmNode-
28e80 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70  >nRef--;.  if( p
28e90 53 68 6d 4e 6f 64 65 2d 3e 6e 52 65 66 3d 3d 30  ShmNode->nRef==0
28ea0 20 29 7b 0a 20 20 20 20 69 66 28 20 64 65 6c 65   ){.    if( dele
28eb0 74 65 46 6c 61 67 20 26 26 20 70 53 68 6d 4e 6f  teFlag && pShmNo
28ec0 64 65 2d 3e 68 53 68 6d 3e 3d 30 20 29 7b 0a 20  de->hShm>=0 ){. 
28ed0 20 20 20 20 20 6f 73 55 6e 6c 69 6e 6b 28 70 53       osUnlink(pS
28ee0 68 6d 4e 6f 64 65 2d 3e 7a 46 69 6c 65 6e 61 6d  hmNode->zFilenam
28ef0 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e  e);.    }.    un
28f00 69 78 53 68 6d 50 75 72 67 65 28 70 44 62 46 64  ixShmPurge(pDbFd
28f10 29 3b 0a 20 20 7d 0a 20 20 75 6e 69 78 4c 65 61  );.  }.  unixLea
28f20 76 65 4d 75 74 65 78 28 29 3b 0a 0a 20 20 72 65  veMutex();..  re
28f30 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
28f40 7d 0a 0a 0a 23 65 6c 73 65 0a 23 20 64 65 66 69  }...#else.# defi
28f50 6e 65 20 75 6e 69 78 53 68 6d 4d 61 70 20 20 20  ne unixShmMap   
28f60 20 20 30 0a 23 20 64 65 66 69 6e 65 20 75 6e 69    0.# define uni
28f70 78 53 68 6d 4c 6f 63 6b 20 20 20 20 30 0a 23 20  xShmLock    0.# 
28f80 64 65 66 69 6e 65 20 75 6e 69 78 53 68 6d 42 61  define unixShmBa
28f90 72 72 69 65 72 20 30 0a 23 20 64 65 66 69 6e 65  rrier 0.# define
28fa0 20 75 6e 69 78 53 68 6d 55 6e 6d 61 70 20 20 20   unixShmUnmap   
28fb0 30 0a 23 65 6e 64 69 66 20 2f 2a 20 23 69 66 6e  0.#endif /* #ifn
28fc0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
28fd0 57 41 4c 20 2a 2f 0a 0a 23 69 66 20 53 51 4c 49  WAL */..#if SQLI
28fe0 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45  TE_MAX_MMAP_SIZE
28ff0 3e 30 0a 2f 2a 0a 2a 2a 20 49 66 20 69 74 20 69  >0./*.** If it i
29000 73 20 63 75 72 72 65 6e 74 6c 79 20 6d 65 6d 6f  s currently memo
29010 72 79 20 6d 61 70 70 65 64 2c 20 75 6e 6d 61 70  ry mapped, unmap
29020 20 66 69 6c 65 20 70 46 64 2e 0a 2a 2f 0a 73 74   file pFd..*/.st
29030 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78 55 6e  atic void unixUn
29040 6d 61 70 66 69 6c 65 28 75 6e 69 78 46 69 6c 65  mapfile(unixFile
29050 20 2a 70 46 64 29 7b 0a 20 20 61 73 73 65 72 74   *pFd){.  assert
29060 28 20 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74  ( pFd->nFetchOut
29070 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 46 64  ==0 );.  if( pFd
29080 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 20 29 7b 0a  ->pMapRegion ){.
29090 20 20 20 20 6f 73 4d 75 6e 6d 61 70 28 70 46 64      osMunmap(pFd
290a0 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 2c 20 70 46  ->pMapRegion, pF
290b0 64 2d 3e 6d 6d 61 70 53 69 7a 65 41 63 74 75 61  d->mmapSizeActua
290c0 6c 29 3b 0a 20 20 20 20 70 46 64 2d 3e 70 4d 61  l);.    pFd->pMa
290d0 70 52 65 67 69 6f 6e 20 3d 20 30 3b 0a 20 20 20  pRegion = 0;.   
290e0 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 20 3d   pFd->mmapSize =
290f0 20 30 3b 0a 20 20 20 20 70 46 64 2d 3e 6d 6d 61   0;.    pFd->mma
29100 70 53 69 7a 65 41 63 74 75 61 6c 20 3d 20 30 3b  pSizeActual = 0;
29110 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74  .  }.}../*.** At
29120 74 65 6d 70 74 20 74 6f 20 73 65 74 20 74 68 65  tempt to set the
29130 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6d 65 6d   size of the mem
29140 6f 72 79 20 6d 61 70 70 69 6e 67 20 6d 61 69 6e  ory mapping main
29150 74 61 69 6e 65 64 20 62 79 20 66 69 6c 65 20 0a  tained by file .
29160 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 70 46  ** descriptor pF
29170 64 20 74 6f 20 6e 4e 65 77 20 62 79 74 65 73 2e  d to nNew bytes.
29180 20 41 6e 79 20 65 78 69 73 74 69 6e 67 20 6d 61   Any existing ma
29190 70 70 69 6e 67 20 69 73 20 64 69 73 63 61 72 64  pping is discard
291a0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63  ed..**.** If suc
291b0 63 65 73 73 66 75 6c 2c 20 74 68 69 73 20 66 75  cessful, this fu
291c0 6e 63 74 69 6f 6e 20 73 65 74 73 20 74 68 65 20  nction sets the 
291d0 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 62  following variab
291e0 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20  les:.**.**      
291f0 20 75 6e 69 78 46 69 6c 65 2e 70 4d 61 70 52 65   unixFile.pMapRe
29200 67 69 6f 6e 0a 2a 2a 20 20 20 20 20 20 20 75 6e  gion.**       un
29210 69 78 46 69 6c 65 2e 6d 6d 61 70 53 69 7a 65 0a  ixFile.mmapSize.
29220 2a 2a 20 20 20 20 20 20 20 75 6e 69 78 46 69 6c  **       unixFil
29230 65 2e 6d 6d 61 70 53 69 7a 65 41 63 74 75 61 6c  e.mmapSizeActual
29240 0a 2a 2a 0a 2a 2a 20 49 66 20 75 6e 73 75 63 63  .**.** If unsucc
29250 65 73 73 66 75 6c 2c 20 61 6e 20 65 72 72 6f 72  essful, an error
29260 20 6d 65 73 73 61 67 65 20 69 73 20 6c 6f 67 67   message is logg
29270 65 64 20 76 69 61 20 73 71 6c 69 74 65 33 5f 6c  ed via sqlite3_l
29280 6f 67 28 29 20 61 6e 64 0a 2a 2a 20 74 68 65 20  og() and.** the 
29290 74 68 72 65 65 20 76 61 72 69 61 62 6c 65 73 20  three variables 
292a0 61 62 6f 76 65 20 61 72 65 20 7a 65 72 6f 65 64  above are zeroed
292b0 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 53  . In this case S
292c0 51 4c 69 74 65 20 73 68 6f 75 6c 64 0a 2a 2a 20  QLite should.** 
292d0 63 6f 6e 74 69 6e 75 65 20 61 63 63 65 73 73 69  continue accessi
292e0 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ng the database 
292f0 75 73 69 6e 67 20 74 68 65 20 78 52 65 61 64 28  using the xRead(
29300 29 20 61 6e 64 20 78 57 72 69 74 65 28 29 0a 2a  ) and xWrite().*
29310 2a 20 6d 65 74 68 6f 64 73 2e 0a 2a 2f 0a 73 74  * methods..*/.st
29320 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78 52 65  atic void unixRe
29330 6d 61 70 66 69 6c 65 28 0a 20 20 75 6e 69 78 46  mapfile(.  unixF
29340 69 6c 65 20 2a 70 46 64 2c 20 20 20 20 20 20 20  ile *pFd,       
29350 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69             /* Fi
29360 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6f 62  le descriptor ob
29370 6a 65 63 74 20 2a 2f 0a 20 20 69 36 34 20 6e 4e  ject */.  i64 nN
29380 65 77 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ew              
29390 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 71            /* Req
293a0 75 69 72 65 64 20 6d 61 70 70 69 6e 67 20 73 69  uired mapping si
293b0 7a 65 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73 74  ze */.){.  const
293c0 20 63 68 61 72 20 2a 7a 45 72 72 20 3d 20 22 6d   char *zErr = "m
293d0 6d 61 70 22 3b 0a 20 20 69 6e 74 20 68 20 3d 20  map";.  int h = 
293e0 70 46 64 2d 3e 68 3b 20 20 20 20 20 20 20 20 20  pFd->h;         
293f0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
29400 46 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  File descriptor 
29410 6f 70 65 6e 20 6f 6e 20 64 62 20 66 69 6c 65 20  open on db file 
29420 2a 2f 0a 20 20 75 38 20 2a 70 4f 72 69 67 20 3d  */.  u8 *pOrig =
29430 20 28 75 38 20 2a 29 70 46 64 2d 3e 70 4d 61 70   (u8 *)pFd->pMap
29440 52 65 67 69 6f 6e 3b 20 20 20 2f 2a 20 50 6f 69  Region;   /* Poi
29450 6e 74 65 72 20 74 6f 20 63 75 72 72 65 6e 74 20  nter to current 
29460 66 69 6c 65 20 6d 61 70 70 69 6e 67 20 2a 2f 0a  file mapping */.
29470 20 20 69 36 34 20 6e 4f 72 69 67 20 3d 20 70 46    i64 nOrig = pF
29480 64 2d 3e 6d 6d 61 70 53 69 7a 65 41 63 74 75 61  d->mmapSizeActua
29490 6c 3b 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f  l;     /* Size o
294a0 66 20 70 4f 72 69 67 20 72 65 67 69 6f 6e 20 69  f pOrig region i
294b0 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 38 20  n bytes */.  u8 
294c0 2a 70 4e 65 77 20 3d 20 30 3b 20 20 20 20 20 20  *pNew = 0;      
294d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
294e0 20 20 2f 2a 20 4c 6f 63 61 74 69 6f 6e 20 6f 66    /* Location of
294f0 20 6e 65 77 20 6d 61 70 70 69 6e 67 20 2a 2f 0a   new mapping */.
29500 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 50 52    int flags = PR
29510 4f 54 5f 52 45 41 44 3b 20 20 20 20 20 20 20 20  OT_READ;        
29520 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20         /* Flags 
29530 74 6f 20 70 61 73 73 20 74 6f 20 6d 6d 61 70 28  to pass to mmap(
29540 29 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20  ) */..  assert( 
29550 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74 3d 3d  pFd->nFetchOut==
29560 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e  0 );.  assert( n
29570 4e 65 77 3e 70 46 64 2d 3e 6d 6d 61 70 53 69 7a  New>pFd->mmapSiz
29580 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e  e );.  assert( n
29590 4e 65 77 3c 3d 70 46 64 2d 3e 6d 6d 61 70 53 69  New<=pFd->mmapSi
295a0 7a 65 4d 61 78 20 29 3b 0a 20 20 61 73 73 65 72  zeMax );.  asser
295b0 74 28 20 6e 4e 65 77 3e 30 20 29 3b 0a 20 20 61  t( nNew>0 );.  a
295c0 73 73 65 72 74 28 20 70 46 64 2d 3e 6d 6d 61 70  ssert( pFd->mmap
295d0 53 69 7a 65 41 63 74 75 61 6c 3e 3d 70 46 64 2d  SizeActual>=pFd-
295e0 3e 6d 6d 61 70 53 69 7a 65 20 29 3b 0a 20 20 61  >mmapSize );.  a
295f0 73 73 65 72 74 28 20 4d 41 50 5f 46 41 49 4c 45  ssert( MAP_FAILE
29600 44 21 3d 30 20 29 3b 0a 0a 23 69 66 64 65 66 20  D!=0 );..#ifdef 
29610 53 51 4c 49 54 45 5f 4d 4d 41 50 5f 52 45 41 44  SQLITE_MMAP_READ
29620 57 52 49 54 45 0a 20 20 69 66 28 20 28 70 46 64  WRITE.  if( (pFd
29630 2d 3e 63 74 72 6c 46 6c 61 67 73 20 26 20 55 4e  ->ctrlFlags & UN
29640 49 58 46 49 4c 45 5f 52 44 4f 4e 4c 59 29 3d 3d  IXFILE_RDONLY)==
29650 30 20 29 20 66 6c 61 67 73 20 7c 3d 20 50 52 4f  0 ) flags |= PRO
29660 54 5f 57 52 49 54 45 3b 0a 23 65 6e 64 69 66 0a  T_WRITE;.#endif.
29670 0a 20 20 69 66 28 20 70 4f 72 69 67 20 29 7b 0a  .  if( pOrig ){.
29680 23 69 66 20 48 41 56 45 5f 4d 52 45 4d 41 50 0a  #if HAVE_MREMAP.
29690 20 20 20 20 69 36 34 20 6e 52 65 75 73 65 20 3d      i64 nReuse =
296a0 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 3b 0a   pFd->mmapSize;.
296b0 23 65 6c 73 65 0a 20 20 20 20 63 6f 6e 73 74 20  #else.    const 
296c0 69 6e 74 20 73 7a 53 79 73 70 61 67 65 20 3d 20  int szSyspage = 
296d0 6f 73 47 65 74 70 61 67 65 73 69 7a 65 28 29 3b  osGetpagesize();
296e0 0a 20 20 20 20 69 36 34 20 6e 52 65 75 73 65 20  .    i64 nReuse 
296f0 3d 20 28 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65  = (pFd->mmapSize
29700 20 26 20 7e 28 73 7a 53 79 73 70 61 67 65 2d 31   & ~(szSyspage-1
29710 29 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 75  ));.#endif.    u
29720 38 20 2a 70 52 65 71 20 3d 20 26 70 4f 72 69 67  8 *pReq = &pOrig
29730 5b 6e 52 65 75 73 65 5d 3b 0a 0a 20 20 20 20 2f  [nReuse];..    /
29740 2a 20 55 6e 6d 61 70 20 61 6e 79 20 70 61 67 65  * Unmap any page
29750 73 20 6f 66 20 74 68 65 20 65 78 69 73 74 69 6e  s of the existin
29760 67 20 6d 61 70 70 69 6e 67 20 74 68 61 74 20 63  g mapping that c
29770 61 6e 6e 6f 74 20 62 65 20 72 65 75 73 65 64 2e  annot be reused.
29780 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e 52 65 75   */.    if( nReu
29790 73 65 21 3d 6e 4f 72 69 67 20 29 7b 0a 20 20 20  se!=nOrig ){.   
297a0 20 20 20 6f 73 4d 75 6e 6d 61 70 28 70 52 65 71     osMunmap(pReq
297b0 2c 20 6e 4f 72 69 67 2d 6e 52 65 75 73 65 29 3b  , nOrig-nReuse);
297c0 0a 20 20 20 20 7d 0a 0a 23 69 66 20 48 41 56 45  .    }..#if HAVE
297d0 5f 4d 52 45 4d 41 50 0a 20 20 20 20 70 4e 65 77  _MREMAP.    pNew
297e0 20 3d 20 6f 73 4d 72 65 6d 61 70 28 70 4f 72 69   = osMremap(pOri
297f0 67 2c 20 6e 52 65 75 73 65 2c 20 6e 4e 65 77 2c  g, nReuse, nNew,
29800 20 4d 52 45 4d 41 50 5f 4d 41 59 4d 4f 56 45 29   MREMAP_MAYMOVE)
29810 3b 0a 20 20 20 20 7a 45 72 72 20 3d 20 22 6d 72  ;.    zErr = "mr
29820 65 6d 61 70 22 3b 0a 23 65 6c 73 65 0a 20 20 20  emap";.#else.   
29830 20 70 4e 65 77 20 3d 20 6f 73 4d 6d 61 70 28 70   pNew = osMmap(p
29840 52 65 71 2c 20 6e 4e 65 77 2d 6e 52 65 75 73 65  Req, nNew-nReuse
29850 2c 20 66 6c 61 67 73 2c 20 4d 41 50 5f 53 48 41  , flags, MAP_SHA
29860 52 45 44 2c 20 68 2c 20 6e 52 65 75 73 65 29 3b  RED, h, nReuse);
29870 0a 20 20 20 20 69 66 28 20 70 4e 65 77 21 3d 4d  .    if( pNew!=M
29880 41 50 5f 46 41 49 4c 45 44 20 29 7b 0a 20 20 20  AP_FAILED ){.   
29890 20 20 20 69 66 28 20 70 4e 65 77 21 3d 70 52 65     if( pNew!=pRe
298a0 71 20 29 7b 0a 20 20 20 20 20 20 20 20 6f 73 4d  q ){.        osM
298b0 75 6e 6d 61 70 28 70 4e 65 77 2c 20 6e 4e 65 77  unmap(pNew, nNew
298c0 20 2d 20 6e 52 65 75 73 65 29 3b 0a 20 20 20 20   - nReuse);.    
298d0 20 20 20 20 70 4e 65 77 20 3d 20 30 3b 0a 20 20      pNew = 0;.  
298e0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
298f0 20 20 20 70 4e 65 77 20 3d 20 70 4f 72 69 67 3b     pNew = pOrig;
29900 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 23  .      }.    }.#
29910 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 54 68  endif..    /* Th
29920 65 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 74  e attempt to ext
29930 65 6e 64 20 74 68 65 20 65 78 69 73 74 69 6e 67  end the existing
29940 20 6d 61 70 70 69 6e 67 20 66 61 69 6c 65 64 2e   mapping failed.
29950 20 46 72 65 65 20 69 74 2e 20 2a 2f 0a 20 20 20   Free it. */.   
29960 20 69 66 28 20 70 4e 65 77 3d 3d 4d 41 50 5f 46   if( pNew==MAP_F
29970 41 49 4c 45 44 20 7c 7c 20 70 4e 65 77 3d 3d 30  AILED || pNew==0
29980 20 29 7b 0a 20 20 20 20 20 20 6f 73 4d 75 6e 6d   ){.      osMunm
29990 61 70 28 70 4f 72 69 67 2c 20 6e 52 65 75 73 65  ap(pOrig, nReuse
299a0 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  );.    }.  }..  
299b0 2f 2a 20 49 66 20 70 4e 65 77 20 69 73 20 73 74  /* If pNew is st
299c0 69 6c 6c 20 4e 55 4c 4c 2c 20 74 72 79 20 74 6f  ill NULL, try to
299d0 20 63 72 65 61 74 65 20 61 6e 20 65 6e 74 69 72   create an entir
299e0 65 6c 79 20 6e 65 77 20 6d 61 70 70 69 6e 67 2e  ely new mapping.
299f0 20 2a 2f 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d   */.  if( pNew==
29a00 30 20 29 7b 0a 20 20 20 20 70 4e 65 77 20 3d 20  0 ){.    pNew = 
29a10 6f 73 4d 6d 61 70 28 30 2c 20 6e 4e 65 77 2c 20  osMmap(0, nNew, 
29a20 66 6c 61 67 73 2c 20 4d 41 50 5f 53 48 41 52 45  flags, MAP_SHARE
29a30 44 2c 20 68 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20  D, h, 0);.  }.. 
29a40 20 69 66 28 20 70 4e 65 77 3d 3d 4d 41 50 5f 46   if( pNew==MAP_F
29a50 41 49 4c 45 44 20 29 7b 0a 20 20 20 20 70 4e 65  AILED ){.    pNe
29a60 77 20 3d 20 30 3b 0a 20 20 20 20 6e 4e 65 77 20  w = 0;.    nNew 
29a70 3d 20 30 3b 0a 20 20 20 20 75 6e 69 78 4c 6f 67  = 0;.    unixLog
29a80 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 4f 4b 2c  Error(SQLITE_OK,
29a90 20 7a 45 72 72 2c 20 70 46 64 2d 3e 7a 50 61 74   zErr, pFd->zPat
29aa0 68 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74  h);..    /* If t
29ab0 68 65 20 6d 6d 61 70 28 29 20 61 62 6f 76 65 20  he mmap() above 
29ac0 66 61 69 6c 65 64 2c 20 61 73 73 75 6d 65 20 74  failed, assume t
29ad0 68 61 74 20 61 6c 6c 20 73 75 62 73 65 71 75 65  hat all subseque
29ae0 6e 74 20 6d 6d 61 70 28 29 20 63 61 6c 6c 73 0a  nt mmap() calls.
29af0 20 20 20 20 2a 2a 20 77 69 6c 6c 20 70 72 6f 62      ** will prob
29b00 61 62 6c 79 20 66 61 69 6c 20 74 6f 6f 2e 20 46  ably fail too. F
29b10 61 6c 6c 20 62 61 63 6b 20 74 6f 20 75 73 69 6e  all back to usin
29b20 67 20 78 52 65 61 64 2f 78 57 72 69 74 65 20 65  g xRead/xWrite e
29b30 78 63 6c 75 73 69 76 65 6c 79 0a 20 20 20 20 2a  xclusively.    *
29b40 2a 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20  * in this case. 
29b50 20 2a 2f 0a 20 20 20 20 70 46 64 2d 3e 6d 6d 61   */.    pFd->mma
29b60 70 53 69 7a 65 4d 61 78 20 3d 20 30 3b 0a 20 20  pSizeMax = 0;.  
29b70 7d 0a 20 20 70 46 64 2d 3e 70 4d 61 70 52 65 67  }.  pFd->pMapReg
29b80 69 6f 6e 20 3d 20 28 76 6f 69 64 20 2a 29 70 4e  ion = (void *)pN
29b90 65 77 3b 0a 20 20 70 46 64 2d 3e 6d 6d 61 70 53  ew;.  pFd->mmapS
29ba0 69 7a 65 20 3d 20 70 46 64 2d 3e 6d 6d 61 70 53  ize = pFd->mmapS
29bb0 69 7a 65 41 63 74 75 61 6c 20 3d 20 6e 4e 65 77  izeActual = nNew
29bc0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 65 6d 6f 72  ;.}../*.** Memor
29bd0 79 20 6d 61 70 20 6f 72 20 72 65 6d 61 70 20 74  y map or remap t
29be0 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 20 62  he file opened b
29bf0 79 20 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f  y file-descripto
29c00 72 20 70 46 64 20 28 69 66 20 74 68 65 20 66 69  r pFd (if the fi
29c10 6c 65 0a 2a 2a 20 69 73 20 61 6c 72 65 61 64 79  le.** is already
29c20 20 6d 61 70 70 65 64 2c 20 74 68 65 20 65 78 69   mapped, the exi
29c30 73 74 69 6e 67 20 6d 61 70 70 69 6e 67 20 69 73  sting mapping is
29c40 20 72 65 70 6c 61 63 65 64 20 62 79 20 74 68 65   replaced by the
29c50 20 6e 65 77 29 2e 20 4f 72 2c 20 69 66 20 0a 2a   new). Or, if .*
29c60 2a 20 74 68 65 72 65 20 61 6c 72 65 61 64 79 20  * there already 
29c70 65 78 69 73 74 73 20 61 20 6d 61 70 70 69 6e 67  exists a mapping
29c80 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 2c 20   for this file, 
29c90 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 73 74  and there are st
29ca0 69 6c 6c 20 0a 2a 2a 20 6f 75 74 73 74 61 6e 64  ill .** outstand
29cb0 69 6e 67 20 78 46 65 74 63 68 28 29 20 72 65 66  ing xFetch() ref
29cc0 65 72 65 6e 63 65 73 20 74 6f 20 69 74 2c 20 74  erences to it, t
29cd0 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
29ce0 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 49  a no-op..**.** I
29cf0 66 20 70 61 72 61 6d 65 74 65 72 20 6e 42 79 74  f parameter nByt
29d00 65 20 69 73 20 6e 6f 6e 2d 6e 65 67 61 74 69 76  e is non-negativ
29d10 65 2c 20 74 68 65 6e 20 69 74 20 69 73 20 74 68  e, then it is th
29d20 65 20 72 65 71 75 65 73 74 65 64 20 73 69 7a 65  e requested size
29d30 20 6f 66 20 0a 2a 2a 20 74 68 65 20 6d 61 70 70   of .** the mapp
29d40 69 6e 67 20 74 6f 20 63 72 65 61 74 65 2e 20 4f  ing to create. O
29d50 74 68 65 72 77 69 73 65 2c 20 69 66 20 6e 42 79  therwise, if nBy
29d60 74 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20  te is less than 
29d70 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 0a  zero, then the .
29d80 2a 2a 20 72 65 71 75 65 73 74 65 64 20 73 69 7a  ** requested siz
29d90 65 20 69 73 20 74 68 65 20 73 69 7a 65 20 6f 66  e is the size of
29da0 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73   the file on dis
29db0 6b 2e 20 54 68 65 20 61 63 74 75 61 6c 20 73 69  k. The actual si
29dc0 7a 65 20 6f 66 20 74 68 65 0a 2a 2a 20 63 72 65  ze of the.** cre
29dd0 61 74 65 64 20 6d 61 70 70 69 6e 67 20 69 73 20  ated mapping is 
29de0 65 69 74 68 65 72 20 74 68 65 20 72 65 71 75 65  either the reque
29df0 73 74 65 64 20 73 69 7a 65 20 6f 72 20 74 68 65  sted size or the
29e00 20 76 61 6c 75 65 20 63 6f 6e 66 69 67 75 72 65   value configure
29e10 64 20 0a 2a 2a 20 75 73 69 6e 67 20 53 51 4c 49  d .** using SQLI
29e20 54 45 5f 46 43 4e 54 4c 5f 4d 4d 41 50 5f 4c 49  TE_FCNTL_MMAP_LI
29e30 4d 49 54 2c 20 77 68 69 63 68 65 76 65 72 20 69  MIT, whichever i
29e40 73 20 73 6d 61 6c 6c 65 72 2e 0a 2a 2a 0a 2a 2a  s smaller..**.**
29e50 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65   SQLITE_OK is re
29e60 74 75 72 6e 65 64 20 69 66 20 6e 6f 20 65 72 72  turned if no err
29e70 6f 72 20 6f 63 63 75 72 73 20 28 65 76 65 6e 20  or occurs (even 
29e80 69 66 20 74 68 65 20 6d 61 70 70 69 6e 67 20 69  if the mapping i
29e90 73 20 6e 6f 74 0a 2a 2a 20 72 65 63 72 65 61 74  s not.** recreat
29ea0 65 64 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f  ed as a result o
29eb0 66 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65  f outstanding re
29ec0 66 65 72 65 6e 63 65 73 29 20 6f 72 20 61 6e 20  ferences) or an 
29ed0 53 51 4c 69 74 65 20 65 72 72 6f 72 0a 2a 2a 20  SQLite error.** 
29ee0 63 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a  code otherwise..
29ef0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e  */.static int un
29f00 69 78 4d 61 70 66 69 6c 65 28 75 6e 69 78 46 69  ixMapfile(unixFi
29f10 6c 65 20 2a 70 46 64 2c 20 69 36 34 20 6e 4d 61  le *pFd, i64 nMa
29f20 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 6e 4d  p){.  assert( nM
29f30 61 70 3e 3d 30 20 7c 7c 20 70 46 64 2d 3e 6e 46  ap>=0 || pFd->nF
29f40 65 74 63 68 4f 75 74 3d 3d 30 20 29 3b 0a 20 20  etchOut==0 );.  
29f50 61 73 73 65 72 74 28 20 6e 4d 61 70 3e 30 20 7c  assert( nMap>0 |
29f60 7c 20 28 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65  | (pFd->mmapSize
29f70 3d 3d 30 20 26 26 20 70 46 64 2d 3e 70 4d 61 70  ==0 && pFd->pMap
29f80 52 65 67 69 6f 6e 3d 3d 30 29 20 29 3b 0a 20 20  Region==0) );.  
29f90 69 66 28 20 70 46 64 2d 3e 6e 46 65 74 63 68 4f  if( pFd->nFetchO
29fa0 75 74 3e 30 20 29 20 72 65 74 75 72 6e 20 53 51  ut>0 ) return SQ
29fb0 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20  LITE_OK;..  if( 
29fc0 6e 4d 61 70 3c 30 20 29 7b 0a 20 20 20 20 73 74  nMap<0 ){.    st
29fd0 72 75 63 74 20 73 74 61 74 20 73 74 61 74 62 75  ruct stat statbu
29fe0 66 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c  f;          /* L
29ff0 6f 77 2d 6c 65 76 65 6c 20 66 69 6c 65 20 69 6e  ow-level file in
2a000 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 20 20 20  formation */.   
2a010 20 69 66 28 20 6f 73 46 73 74 61 74 28 70 46 64   if( osFstat(pFd
2a020 2d 3e 68 2c 20 26 73 74 61 74 62 75 66 29 20 29  ->h, &statbuf) )
2a030 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  {.      return S
2a040 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54 41  QLITE_IOERR_FSTA
2a050 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 4d 61  T;.    }.    nMa
2a060 70 20 3d 20 73 74 61 74 62 75 66 2e 73 74 5f 73  p = statbuf.st_s
2a070 69 7a 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e  ize;.  }.  if( n
2a080 4d 61 70 3e 70 46 64 2d 3e 6d 6d 61 70 53 69 7a  Map>pFd->mmapSiz
2a090 65 4d 61 78 20 29 7b 0a 20 20 20 20 6e 4d 61 70  eMax ){.    nMap
2a0a0 20 3d 20 70 46 64 2d 3e 6d 6d 61 70 53 69 7a 65   = pFd->mmapSize
2a0b0 4d 61 78 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65  Max;.  }..  asse
2a0c0 72 74 28 20 6e 4d 61 70 3e 30 20 7c 7c 20 28 70  rt( nMap>0 || (p
2a0d0 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 3d 3d 30 20  Fd->mmapSize==0 
2a0e0 26 26 20 70 46 64 2d 3e 70 4d 61 70 52 65 67 69  && pFd->pMapRegi
2a0f0 6f 6e 3d 3d 30 29 20 29 3b 0a 20 20 69 66 28 20  on==0) );.  if( 
2a100 6e 4d 61 70 21 3d 70 46 64 2d 3e 6d 6d 61 70 53  nMap!=pFd->mmapS
2a110 69 7a 65 20 29 7b 0a 20 20 20 20 75 6e 69 78 52  ize ){.    unixR
2a120 65 6d 61 70 66 69 6c 65 28 70 46 64 2c 20 6e 4d  emapfile(pFd, nM
2a130 61 70 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75  ap);.  }..  retu
2a140 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
2a150 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
2a160 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30  _MAX_MMAP_SIZE>0
2a170 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 70 6f   */../*.** If po
2a180 73 73 69 62 6c 65 2c 20 72 65 74 75 72 6e 20 61  ssible, return a
2a190 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 6d 61   pointer to a ma
2a1a0 70 70 69 6e 67 20 6f 66 20 66 69 6c 65 20 66 64  pping of file fd
2a1b0 20 73 74 61 72 74 69 6e 67 20 61 74 20 6f 66 66   starting at off
2a1c0 73 65 74 0a 2a 2a 20 69 4f 66 66 2e 20 54 68 65  set.** iOff. The
2a1d0 20 6d 61 70 70 69 6e 67 20 6d 75 73 74 20 62 65   mapping must be
2a1e0 20 76 61 6c 69 64 20 66 6f 72 20 61 74 20 6c 65   valid for at le
2a1f0 61 73 74 20 6e 41 6d 74 20 62 79 74 65 73 2e 0a  ast nAmt bytes..
2a200 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 68 20 61 20  **.** If such a 
2a210 70 6f 69 6e 74 65 72 20 63 61 6e 20 62 65 20 6f  pointer can be o
2a220 62 74 61 69 6e 65 64 2c 20 73 74 6f 72 65 20 69  btained, store i
2a230 74 20 69 6e 20 2a 70 70 20 61 6e 64 20 72 65 74  t in *pp and ret
2a240 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a  urn SQLITE_OK..*
2a250 2a 20 4f 72 2c 20 69 66 20 6f 6e 65 20 63 61 6e  * Or, if one can
2a260 6e 6f 74 20 62 75 74 20 6e 6f 20 65 72 72 6f 72  not but no error
2a270 20 6f 63 63 75 72 73 2c 20 73 65 74 20 2a 70 70   occurs, set *pp
2a280 20 74 6f 20 30 20 61 6e 64 20 72 65 74 75 72 6e   to 0 and return
2a290 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 46   SQLITE_OK..** F
2a2a0 69 6e 61 6c 6c 79 2c 20 69 66 20 61 6e 20 65 72  inally, if an er
2a2b0 72 6f 72 20 64 6f 65 73 20 6f 63 63 75 72 2c 20  ror does occur, 
2a2c0 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65  return an SQLite
2a2d0 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 54 68 65   error code. The
2a2e0 20 66 69 6e 61 6c 0a 2a 2a 20 76 61 6c 75 65 20   final.** value 
2a2f0 6f 66 20 2a 70 70 20 69 73 20 75 6e 64 65 66 69  of *pp is undefi
2a300 6e 65 64 20 69 6e 20 74 68 69 73 20 63 61 73 65  ned in this case
2a310 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20  ..**.** If this 
2a320 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 72 65  function does re
2a330 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 2c 20  turn a pointer, 
2a340 74 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20  the caller must 
2a350 65 76 65 6e 74 75 61 6c 6c 79 20 0a 2a 2a 20 72  eventually .** r
2a360 65 6c 65 61 73 65 20 74 68 65 20 72 65 66 65 72  elease the refer
2a370 65 6e 63 65 20 62 79 20 63 61 6c 6c 69 6e 67 20  ence by calling 
2a380 75 6e 69 78 55 6e 66 65 74 63 68 28 29 2e 0a 2a  unixUnfetch()..*
2a390 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
2a3a0 78 46 65 74 63 68 28 73 71 6c 69 74 65 33 5f 66  xFetch(sqlite3_f
2a3b0 69 6c 65 20 2a 66 64 2c 20 69 36 34 20 69 4f 66  ile *fd, i64 iOf
2a3c0 66 2c 20 69 6e 74 20 6e 41 6d 74 2c 20 76 6f 69  f, int nAmt, voi
2a3d0 64 20 2a 2a 70 70 29 7b 0a 23 69 66 20 53 51 4c  d **pp){.#if SQL
2a3e0 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a  ITE_MAX_MMAP_SIZ
2a3f0 45 3e 30 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a  E>0.  unixFile *
2a400 70 46 64 20 3d 20 28 75 6e 69 78 46 69 6c 65 20  pFd = (unixFile 
2a410 2a 29 66 64 3b 20 20 20 2f 2a 20 54 68 65 20 75  *)fd;   /* The u
2a420 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62 61  nderlying databa
2a430 73 65 20 66 69 6c 65 20 2a 2f 0a 23 65 6e 64 69  se file */.#endi
2a440 66 0a 20 20 2a 70 70 20 3d 20 30 3b 0a 0a 23 69  f.  *pp = 0;..#i
2a450 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41  f SQLITE_MAX_MMA
2a460 50 5f 53 49 5a 45 3e 30 0a 20 20 69 66 28 20 70  P_SIZE>0.  if( p
2a470 46 64 2d 3e 6d 6d 61 70 53 69 7a 65 4d 61 78 3e  Fd->mmapSizeMax>
2a480 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 46 64  0 ){.    if( pFd
2a490 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 3d 3d 30 20  ->pMapRegion==0 
2a4a0 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 20  ){.      int rc 
2a4b0 3d 20 75 6e 69 78 4d 61 70 66 69 6c 65 28 70 46  = unixMapfile(pF
2a4c0 64 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 69 66  d, -1);.      if
2a4d0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
2a4e0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20  ) return rc;.   
2a4f0 20 7d 0a 20 20 20 20 69 66 28 20 70 46 64 2d 3e   }.    if( pFd->
2a500 6d 6d 61 70 53 69 7a 65 20 3e 3d 20 69 4f 66 66  mmapSize >= iOff
2a510 2b 6e 41 6d 74 20 29 7b 0a 20 20 20 20 20 20 2a  +nAmt ){.      *
2a520 70 70 20 3d 20 26 28 28 75 38 20 2a 29 70 46 64  pp = &((u8 *)pFd
2a530 2d 3e 70 4d 61 70 52 65 67 69 6f 6e 29 5b 69 4f  ->pMapRegion)[iO
2a540 66 66 5d 3b 0a 20 20 20 20 20 20 70 46 64 2d 3e  ff];.      pFd->
2a550 6e 46 65 74 63 68 4f 75 74 2b 2b 3b 0a 20 20 20  nFetchOut++;.   
2a560 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20   }.  }.#endif.  
2a570 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2a580 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68  ;.}../*.** If th
2a590 65 20 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74  e third argument
2a5a0 20 69 73 20 6e 6f 6e 2d 4e 55 4c 4c 2c 20 74 68   is non-NULL, th
2a5b0 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  en this function
2a5c0 20 72 65 6c 65 61 73 65 73 20 61 20 0a 2a 2a 20   releases a .** 
2a5d0 72 65 66 65 72 65 6e 63 65 20 6f 62 74 61 69 6e  reference obtain
2a5e0 65 64 20 62 79 20 61 6e 20 65 61 72 6c 69 65 72  ed by an earlier
2a5f0 20 63 61 6c 6c 20 74 6f 20 75 6e 69 78 46 65 74   call to unixFet
2a600 63 68 28 29 2e 20 54 68 65 20 73 65 63 6f 6e 64  ch(). The second
2a610 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 70 61 73  .** argument pas
2a620 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63  sed to this func
2a630 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 74 68 65  tion must be the
2a640 20 73 61 6d 65 20 61 73 20 74 68 65 20 63 6f 72   same as the cor
2a650 72 65 73 70 6f 6e 64 69 6e 67 0a 2a 2a 20 61 72  responding.** ar
2a660 67 75 6d 65 6e 74 20 74 68 61 74 20 77 61 73 20  gument that was 
2a670 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 75 6e  passed to the un
2a680 69 78 46 65 74 63 68 28 29 20 69 6e 76 6f 63 61  ixFetch() invoca
2a690 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20 4f 72 2c  tion. .**.** Or,
2a6a0 20 69 66 20 74 68 65 20 74 68 69 72 64 20 61 72   if the third ar
2a6b0 67 75 6d 65 6e 74 20 69 73 20 4e 55 4c 4c 2c 20  gument is NULL, 
2a6c0 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  then this functi
2a6d0 6f 6e 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c  on is being call
2a6e0 65 64 20 0a 2a 2a 20 74 6f 20 69 6e 66 6f 72 6d  ed .** to inform
2a6f0 20 74 68 65 20 56 46 53 20 6c 61 79 65 72 20 74   the VFS layer t
2a700 68 61 74 2c 20 61 63 63 6f 72 64 69 6e 67 20 74  hat, according t
2a710 6f 20 50 4f 53 49 58 2c 20 61 6e 79 20 65 78 69  o POSIX, any exi
2a720 73 74 69 6e 67 20 6d 61 70 70 69 6e 67 20 0a 2a  sting mapping .*
2a730 2a 20 6d 61 79 20 6e 6f 77 20 62 65 20 69 6e 76  * may now be inv
2a740 61 6c 69 64 20 61 6e 64 20 73 68 6f 75 6c 64 20  alid and should 
2a750 62 65 20 75 6e 6d 61 70 70 65 64 2e 0a 2a 2f 0a  be unmapped..*/.
2a760 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 55  static int unixU
2a770 6e 66 65 74 63 68 28 73 71 6c 69 74 65 33 5f 66  nfetch(sqlite3_f
2a780 69 6c 65 20 2a 66 64 2c 20 69 36 34 20 69 4f 66  ile *fd, i64 iOf
2a790 66 2c 20 76 6f 69 64 20 2a 70 29 7b 0a 23 69 66  f, void *p){.#if
2a7a0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50   SQLITE_MAX_MMAP
2a7b0 5f 53 49 5a 45 3e 30 0a 20 20 75 6e 69 78 46 69  _SIZE>0.  unixFi
2a7c0 6c 65 20 2a 70 46 64 20 3d 20 28 75 6e 69 78 46  le *pFd = (unixF
2a7d0 69 6c 65 20 2a 29 66 64 3b 20 20 20 2f 2a 20 54  ile *)fd;   /* T
2a7e0 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 64 61  he underlying da
2a7f0 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20  tabase file */. 
2a800 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45   UNUSED_PARAMETE
2a810 52 28 69 4f 66 66 29 3b 0a 0a 20 20 2f 2a 20 49  R(iOff);..  /* I
2a820 66 20 70 3d 3d 30 20 28 75 6e 6d 61 70 20 74 68  f p==0 (unmap th
2a830 65 20 65 6e 74 69 72 65 20 66 69 6c 65 29 20 74  e entire file) t
2a840 68 65 6e 20 74 68 65 72 65 20 6d 75 73 74 20 62  hen there must b
2a850 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67  e no outstanding
2a860 20 0a 20 20 2a 2a 20 78 46 65 74 63 68 20 72 65   .  ** xFetch re
2a870 66 65 72 65 6e 63 65 73 2e 20 4f 72 2c 20 69 66  ferences. Or, if
2a880 20 70 21 3d 30 20 28 6d 65 61 6e 69 6e 67 20 69   p!=0 (meaning i
2a890 74 20 69 73 20 61 6e 20 78 46 65 74 63 68 20 72  t is an xFetch r
2a8a0 65 66 65 72 65 6e 63 65 29 2c 0a 20 20 2a 2a 20  eference),.  ** 
2a8b0 74 68 65 6e 20 74 68 65 72 65 20 6d 75 73 74 20  then there must 
2a8c0 62 65 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20  be at least one 
2a8d0 6f 75 74 73 74 61 6e 64 69 6e 67 2e 20 20 2a 2f  outstanding.  */
2a8e0 0a 20 20 61 73 73 65 72 74 28 20 28 70 3d 3d 30  .  assert( (p==0
2a8f0 29 3d 3d 28 70 46 64 2d 3e 6e 46 65 74 63 68 4f  )==(pFd->nFetchO
2a900 75 74 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a 20  ut==0) );..  /* 
2a910 49 66 20 70 21 3d 30 2c 20 69 74 20 6d 75 73 74  If p!=0, it must
2a920 20 6d 61 74 63 68 20 74 68 65 20 69 4f 66 66 20   match the iOff 
2a930 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 61 73 73 65  value. */.  asse
2a940 72 74 28 20 70 3d 3d 30 20 7c 7c 20 70 3d 3d 26  rt( p==0 || p==&
2a950 28 28 75 38 20 2a 29 70 46 64 2d 3e 70 4d 61 70  ((u8 *)pFd->pMap
2a960 52 65 67 69 6f 6e 29 5b 69 4f 66 66 5d 20 29 3b  Region)[iOff] );
2a970 0a 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20  ..  if( p ){.   
2a980 20 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75 74 2d   pFd->nFetchOut-
2a990 2d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  -;.  }else{.    
2a9a0 75 6e 69 78 55 6e 6d 61 70 66 69 6c 65 28 70 46  unixUnmapfile(pF
2a9b0 64 29 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72  d);.  }..  asser
2a9c0 74 28 20 70 46 64 2d 3e 6e 46 65 74 63 68 4f 75  t( pFd->nFetchOu
2a9d0 74 3e 3d 30 20 29 3b 0a 23 65 6c 73 65 0a 20 20  t>=0 );.#else.  
2a9e0 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
2a9f0 28 66 64 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50  (fd);.  UNUSED_P
2aa00 41 52 41 4d 45 54 45 52 28 70 29 3b 0a 20 20 55  ARAMETER(p);.  U
2aa10 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
2aa20 69 4f 66 66 29 3b 0a 23 65 6e 64 69 66 0a 20 20  iOff);.#endif.  
2aa30 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2aa40 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 48 65 72 65 20  ;.}../*.** Here 
2aa50 65 6e 64 73 20 74 68 65 20 69 6d 70 6c 65 6d 65  ends the impleme
2aa60 6e 74 61 74 69 6f 6e 20 6f 66 20 61 6c 6c 20 73  ntation of all s
2aa70 71 6c 69 74 65 33 5f 66 69 6c 65 20 6d 65 74 68  qlite3_file meth
2aa80 6f 64 73 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  ods..**.********
2aa90 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 45  ************** E
2aaa0 6e 64 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  nd sqlite3_file 
2aab0 4d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a  Methods ********
2aac0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2aad0 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  *******.********
2aae0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2aaf0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ab00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ab10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2ab20 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54  ******/../*.** T
2ab30 68 69 73 20 64 69 76 69 73 69 6f 6e 20 63 6f 6e  his division con
2ab40 74 61 69 6e 73 20 64 65 66 69 6e 69 74 69 6f 6e  tains definition
2ab50 73 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 6f 5f  s of sqlite3_io_
2ab60 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 73 20  methods objects 
2ab70 74 68 61 74 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e  that.** implemen
2ab80 74 20 76 61 72 69 6f 75 73 20 66 69 6c 65 20 6c  t various file l
2ab90 6f 63 6b 69 6e 67 20 73 74 72 61 74 65 67 69 65  ocking strategie
2aba0 73 2e 20 20 49 74 20 61 6c 73 6f 20 63 6f 6e 74  s.  It also cont
2abb0 61 69 6e 73 20 64 65 66 69 6e 69 74 69 6f 6e 73  ains definitions
2abc0 0a 2a 2a 20 6f 66 20 22 66 69 6e 64 65 72 22 20  .** of "finder" 
2abd0 66 75 6e 63 74 69 6f 6e 73 2e 20 20 41 20 66 69  functions.  A fi
2abe0 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 69 73  nder-function is
2abf0 20 75 73 65 64 20 74 6f 20 6c 6f 63 61 74 65 20   used to locate 
2ac00 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 0a  the appropriate.
2ac10 2a 2a 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65  ** sqlite3_io_me
2ac20 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 66 6f 72  thods object for
2ac30 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61   a particular da
2ac40 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68  tabase file.  Th
2ac50 65 20 70 41 70 70 44 61 74 61 0a 2a 2a 20 66 69  e pAppData.** fi
2ac60 65 6c 64 20 6f 66 20 74 68 65 20 73 71 6c 69 74  eld of the sqlit
2ac70 65 33 5f 76 66 73 20 56 46 53 20 6f 62 6a 65 63  e3_vfs VFS objec
2ac80 74 73 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a  ts are initializ
2ac90 65 64 20 74 6f 20 62 65 20 70 6f 69 6e 74 65 72  ed to be pointer
2aca0 73 20 74 6f 0a 2a 2a 20 74 68 65 20 63 6f 72 72  s to.** the corr
2acb0 65 63 74 20 66 69 6e 64 65 72 2d 66 75 6e 63 74  ect finder-funct
2acc0 69 6f 6e 20 66 6f 72 20 74 68 61 74 20 56 46 53  ion for that VFS
2acd0 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 66 69 6e  ..**.** Most fin
2ace0 64 65 72 20 66 75 6e 63 74 69 6f 6e 73 20 72 65  der functions re
2acf0 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74  turn a pointer t
2ad00 6f 20 61 20 66 69 78 65 64 20 73 71 6c 69 74 65  o a fixed sqlite
2ad10 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20  3_io_methods.** 
2ad20 6f 62 6a 65 63 74 2e 20 20 54 68 65 20 6f 6e 6c  object.  The onl
2ad30 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 66 69  y interesting fi
2ad40 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 69 73  nder-function is
2ad50 20 61 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65   autolockIoFinde
2ad60 72 2c 20 77 68 69 63 68 0a 2a 2a 20 6c 6f 6f 6b  r, which.** look
2ad70 73 20 61 74 20 74 68 65 20 66 69 6c 65 73 79 73  s at the filesys
2ad80 74 65 6d 20 74 79 70 65 20 61 6e 64 20 74 72 69  tem type and tri
2ad90 65 73 20 74 6f 20 67 75 65 73 73 20 74 68 65 20  es to guess the 
2ada0 62 65 73 74 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20  best locking.** 
2adb0 73 74 72 61 74 65 67 79 20 66 72 6f 6d 20 74 68  strategy from th
2adc0 61 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 66 69  at..**.** For fi
2add0 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20 46 2c  nder-function F,
2ade0 20 74 77 6f 20 6f 62 6a 65 63 74 73 20 61 72 65   two objects are
2adf0 20 63 72 65 61 74 65 64 3a 0a 2a 2a 0a 2a 2a 20   created:.**.** 
2ae00 20 20 20 28 31 29 20 54 68 65 20 72 65 61 6c 20     (1) The real 
2ae10 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e 20  finder-function 
2ae20 6e 61 6d 65 64 20 22 46 49 6d 70 74 28 29 22 2e  named "FImpt()".
2ae30 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 29 20 41 20  .**.**    (2) A 
2ae40 63 6f 6e 73 74 61 6e 74 20 70 6f 69 6e 74 65 72  constant pointer
2ae50 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f   to this functio
2ae60 6e 20 6e 61 6d 65 64 20 6a 75 73 74 20 22 46 22  n named just "F"
2ae70 2e 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 41 20 70 6f 69  ..**.**.** A poi
2ae80 6e 74 65 72 20 74 6f 20 74 68 65 20 46 20 70 6f  nter to the F po
2ae90 69 6e 74 65 72 20 69 73 20 75 73 65 64 20 61 73  inter is used as
2aea0 20 74 68 65 20 70 41 70 70 44 61 74 61 20 76 61   the pAppData va
2aeb0 6c 75 65 20 66 6f 72 20 56 46 53 0a 2a 2a 20 6f  lue for VFS.** o
2aec0 62 6a 65 63 74 73 2e 20 20 57 65 20 68 61 76 65  bjects.  We have
2aed0 20 74 6f 20 64 6f 20 74 68 69 73 20 69 6e 73 74   to do this inst
2aee0 65 61 64 20 6f 66 20 6c 65 74 74 69 6e 67 20 70  ead of letting p
2aef0 41 70 70 44 61 74 61 20 70 6f 69 6e 74 0a 2a 2a  AppData point.**
2af00 20 64 69 72 65 63 74 6c 79 20 61 74 20 74 68 65   directly at the
2af10 20 66 69 6e 64 65 72 2d 66 75 6e 63 74 69 6f 6e   finder-function
2af20 20 73 69 6e 63 65 20 43 39 30 20 72 75 6c 65 73   since C90 rules
2af30 20 70 72 65 76 65 6e 74 20 61 20 76 6f 69 64 2a   prevent a void*
2af40 0a 2a 2a 20 66 72 6f 6d 20 62 65 20 63 61 73 74  .** from be cast
2af50 20 69 6e 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e   into a function
2af60 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 0a   pointer..**.**.
2af70 2a 2a 20 45 61 63 68 20 69 6e 73 74 61 6e 63 65  ** Each instance
2af80 20 6f 66 20 74 68 69 73 20 6d 61 63 72 6f 20 67   of this macro g
2af90 65 6e 65 72 61 74 65 73 20 74 77 6f 20 6f 62 6a  enerates two obj
2afa0 65 63 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20  ects:.**.**   * 
2afb0 20 41 20 63 6f 6e 73 74 61 6e 74 20 73 71 6c 69   A constant sqli
2afc0 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f  te3_io_methods o
2afd0 62 6a 65 63 74 20 63 61 6c 6c 20 4d 45 54 48 4f  bject call METHO
2afe0 44 20 74 68 61 74 20 68 61 73 20 6c 6f 63 6b 69  D that has locki
2aff0 6e 67 0a 2a 2a 20 20 20 20 20 20 6d 65 74 68 6f  ng.**      metho
2b000 64 73 20 43 4c 4f 53 45 2c 20 4c 4f 43 4b 2c 20  ds CLOSE, LOCK, 
2b010 55 4e 4c 4f 43 4b 2c 20 43 4b 52 45 53 4c 4f 43  UNLOCK, CKRESLOC
2b020 4b 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 41 6e  K..**.**   *  An
2b030 20 49 2f 4f 20 6d 65 74 68 6f 64 20 66 69 6e 64   I/O method find
2b040 65 72 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c  er function call
2b050 65 64 20 46 49 4e 44 45 52 20 74 68 61 74 20 72  ed FINDER that r
2b060 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72  eturns a pointer
2b070 0a 2a 2a 20 20 20 20 20 20 74 6f 20 74 68 65 20  .**      to the 
2b080 4d 45 54 48 4f 44 20 6f 62 6a 65 63 74 20 69 6e  METHOD object in
2b090 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 62 75   the previous bu
2b0a0 6c 6c 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65  llet..*/.#define
2b0b0 20 49 4f 4d 45 54 48 4f 44 53 28 46 49 4e 44 45   IOMETHODS(FINDE
2b0c0 52 2c 4d 45 54 48 4f 44 2c 56 45 52 53 49 4f 4e  R,METHOD,VERSION
2b0d0 2c 43 4c 4f 53 45 2c 4c 4f 43 4b 2c 55 4e 4c 4f  ,CLOSE,LOCK,UNLO
2b0e0 43 4b 2c 43 4b 4c 4f 43 4b 2c 53 48 4d 4d 41 50  CK,CKLOCK,SHMMAP
2b0f0 29 20 20 20 20 20 5c 0a 73 74 61 74 69 63 20 63  )     \.static c
2b100 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f  onst sqlite3_io_
2b110 6d 65 74 68 6f 64 73 20 4d 45 54 48 4f 44 20 3d  methods METHOD =
2b120 20 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20   {              
2b130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b140 20 20 20 20 20 5c 0a 20 20 20 56 45 52 53 49 4f       \.   VERSIO
2b150 4e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  N,              
2b160 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f        /* iVersio
2b170 6e 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20  n */            
2b180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b190 20 20 20 20 5c 0a 20 20 20 43 4c 4f 53 45 2c 20      \.   CLOSE, 
2b1a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b1b0 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 2a       /* xClose *
2b1c0 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  /               
2b1d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b1e0 20 20 20 5c 0a 20 20 20 75 6e 69 78 52 65 61 64     \.   unixRead
2b1f0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2b200 20 20 20 20 2f 2a 20 78 52 65 61 64 20 2a 2f 20      /* xRead */ 
2b210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b230 20 20 5c 0a 20 20 20 75 6e 69 78 57 72 69 74 65    \.   unixWrite
2b240 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2b250 20 20 20 2f 2a 20 78 57 72 69 74 65 20 2a 2f 20     /* xWrite */ 
2b260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b280 20 5c 0a 20 20 20 75 6e 69 78 54 72 75 6e 63 61   \.   unixTrunca
2b290 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  te,             
2b2a0 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a    /* xTruncate *
2b2b0 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  /               
2b2c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b2d0 5c 0a 20 20 20 75 6e 69 78 53 79 6e 63 2c 20 20  \.   unixSync,  
2b2e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b2f0 20 2f 2a 20 78 53 79 6e 63 20 2a 2f 20 20 20 20   /* xSync */    
2b300 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b310 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c                 \
2b320 0a 20 20 20 75 6e 69 78 46 69 6c 65 53 69 7a 65  .   unixFileSize
2b330 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2b340 2f 2a 20 78 46 69 6c 65 53 69 7a 65 20 2a 2f 20  /* xFileSize */ 
2b350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a                \.
2b370 20 20 20 4c 4f 43 4b 2c 20 20 20 20 20 20 20 20     LOCK,        
2b380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2b390 2a 20 78 4c 6f 63 6b 20 2a 2f 20 20 20 20 20 20  * xLock */      
2b3a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b3b0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20               \. 
2b3c0 20 20 55 4e 4c 4f 43 4b 2c 20 20 20 20 20 20 20    UNLOCK,       
2b3d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2b3e0 20 78 55 6e 6c 6f 63 6b 20 2a 2f 20 20 20 20 20   xUnlock */     
2b3f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b400 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20              \.  
2b410 20 43 4b 4c 4f 43 4b 2c 20 20 20 20 20 20 20 20   CKLOCK,        
2b420 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2b430 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f  xCheckReservedLo
2b440 63 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20  ck */           
2b450 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20             \.   
2b460 75 6e 69 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 2c  unixFileControl,
2b470 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
2b480 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 2a 2f 20 20  FileControl */  
2b490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b4a0 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 75            \.   u
2b4b0 6e 69 78 53 65 63 74 6f 72 53 69 7a 65 2c 20 20  nixSectorSize,  
2b4c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53             /* xS
2b4d0 65 63 74 6f 72 53 69 7a 65 20 2a 2f 20 20 20 20  ectorSize */    
2b4e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b4f0 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e           \.   un
2b500 69 78 44 65 76 69 63 65 43 68 61 72 61 63 74 65  ixDeviceCharacte
2b510 72 69 73 74 69 63 73 2c 20 20 2f 2a 20 78 44 65  ristics,  /* xDe
2b520 76 69 63 65 43 61 70 61 62 69 6c 69 74 69 65 73  viceCapabilities
2b530 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20   */             
2b540 20 20 20 20 20 20 20 20 5c 0a 20 20 20 53 48 4d          \.   SHM
2b550 4d 41 50 2c 20 20 20 20 20 20 20 20 20 20 20 20  MAP,            
2b560 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d           /* xShm
2b570 4d 61 70 20 2a 2f 20 20 20 20 20 20 20 20 20 20  Map */          
2b580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b590 20 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78         \.   unix
2b5a0 53 68 6d 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20  ShmLock,        
2b5b0 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4c          /* xShmL
2b5c0 6f 63 6b 20 2a 2f 20 20 20 20 20 20 20 20 20 20  ock */          
2b5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b5e0 20 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53        \.   unixS
2b5f0 68 6d 42 61 72 72 69 65 72 2c 20 20 20 20 20 20  hmBarrier,      
2b600 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 42 61         /* xShmBa
2b610 72 72 69 65 72 20 2a 2f 20 20 20 20 20 20 20 20  rrier */        
2b620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b630 20 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 53 68       \.   unixSh
2b640 6d 55 6e 6d 61 70 2c 20 20 20 20 20 20 20 20 20  mUnmap,         
2b650 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 55 6e 6d        /* xShmUnm
2b660 61 70 20 2a 2f 20 20 20 20 20 20 20 20 20 20 20  ap */           
2b670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b680 20 20 20 20 5c 0a 20 20 20 75 6e 69 78 46 65 74      \.   unixFet
2b690 63 68 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ch,             
2b6a0 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68 20 2a       /* xFetch *
2b6b0 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  /               
2b6c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b6d0 20 20 20 5c 0a 20 20 20 75 6e 69 78 55 6e 66 65     \.   unixUnfe
2b6e0 74 63 68 2c 20 20 20 20 20 20 20 20 20 20 20 20  tch,            
2b6f0 20 20 20 20 2f 2a 20 78 55 6e 66 65 74 63 68 20      /* xUnfetch 
2b700 2a 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 20  */              
2b710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b720 20 20 5c 0a 7d 3b 20 20 20 20 20 20 20 20 20 20    \.};          
2b730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b770 20 5c 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20   \.static const 
2b780 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
2b790 64 73 20 2a 46 49 4e 44 45 52 23 23 49 6d 70 6c  ds *FINDER##Impl
2b7a0 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20  (const char *z, 
2b7b0 75 6e 69 78 46 69 6c 65 20 2a 70 29 7b 20 20 20  unixFile *p){   
2b7c0 5c 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d  \.  UNUSED_PARAM
2b7d0 45 54 45 52 28 7a 29 3b 20 55 4e 55 53 45 44 5f  ETER(z); UNUSED_
2b7e0 50 41 52 41 4d 45 54 45 52 28 70 29 3b 20 20 20  PARAMETER(p);   
2b7f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c                 \
2b810 0a 20 20 72 65 74 75 72 6e 20 26 4d 45 54 48 4f  .  return &METHO
2b820 44 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  D;              
2b830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a                \.
2b860 7d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  }               
2b870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2b8a0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 73               \.s
2b8b0 74 61 74 69 63 20 63 6f 6e 73 74 20 73 71 6c 69  tatic const sqli
2b8c0 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 2a  te3_io_methods *
2b8d0 28 2a 63 6f 6e 73 74 20 46 49 4e 44 45 52 29 28  (*const FINDER)(
2b8e0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69 78  const char*,unix
2b8f0 46 69 6c 65 20 2a 70 29 20 20 20 20 5c 0a 20 20  File *p)    \.  
2b900 20 20 3d 20 46 49 4e 44 45 52 23 23 49 6d 70 6c    = FINDER##Impl
2b910 3b 0a 0a 2f 2a 0a 2a 2a 20 48 65 72 65 20 61 72  ;../*.** Here ar
2b920 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 73 71 6c  e all of the sql
2b930 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20  ite3_io_methods 
2b940 6f 62 6a 65 63 74 73 20 66 6f 72 20 65 61 63 68  objects for each
2b950 20 6f 66 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 69   of the.** locki
2b960 6e 67 20 73 74 72 61 74 65 67 69 65 73 2e 20 20  ng strategies.  
2b970 46 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 72  Functions that r
2b980 65 74 75 72 6e 20 70 6f 69 6e 74 65 72 73 20 74  eturn pointers t
2b990 6f 20 74 68 65 73 65 20 6d 65 74 68 6f 64 73 0a  o these methods.
2b9a0 2a 2a 20 61 72 65 20 61 6c 73 6f 20 63 72 65 61  ** are also crea
2b9b0 74 65 64 2e 0a 2a 2f 0a 49 4f 4d 45 54 48 4f 44  ted..*/.IOMETHOD
2b9c0 53 28 0a 20 20 70 6f 73 69 78 49 6f 46 69 6e 64  S(.  posixIoFind
2b9d0 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  er,            /
2b9e0 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f  * Finder functio
2b9f0 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 70 6f 73 69  n name */.  posi
2ba00 78 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20  xIoMethods,     
2ba10 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33        /* sqlite3
2ba20 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65  _io_methods obje
2ba30 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 33 2c 20  ct name */.  3, 
2ba40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2ba50 20 20 20 20 20 20 20 2f 2a 20 73 68 61 72 65 64         /* shared
2ba60 20 6d 65 6d 6f 72 79 20 61 6e 64 20 6d 6d 61 70   memory and mmap
2ba70 20 61 72 65 20 65 6e 61 62 6c 65 64 20 2a 2f 0a   are enabled */.
2ba80 20 20 75 6e 69 78 43 6c 6f 73 65 2c 20 20 20 20    unixClose,    
2ba90 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
2baa0 43 6c 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a  Close method */.
2bab0 20 20 75 6e 69 78 4c 6f 63 6b 2c 20 20 20 20 20    unixLock,     
2bac0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
2bad0 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20  Lock method */. 
2bae0 20 75 6e 69 78 55 6e 6c 6f 63 6b 2c 20 20 20 20   unixUnlock,    
2baf0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55             /* xU
2bb00 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a  nlock method */.
2bb10 20 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72    unixCheckReser
2bb20 76 65 64 4c 6f 63 6b 2c 20 20 20 20 2f 2a 20 78  vedLock,    /* x
2bb30 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63  CheckReservedLoc
2bb40 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 75 6e  k method */.  un
2bb50 69 78 53 68 6d 4d 61 70 20 20 20 20 20 20 20 20  ixShmMap        
2bb60 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4d          /* xShmM
2bb70 61 70 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a 49  ap method */.).I
2bb80 4f 4d 45 54 48 4f 44 53 28 0a 20 20 6e 6f 6c 6f  OMETHODS(.  nolo
2bb90 63 6b 49 6f 46 69 6e 64 65 72 2c 20 20 20 20 20  ckIoFinder,     
2bba0 20 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20        /* Finder 
2bbb0 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f  function name */
2bbc0 0a 20 20 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f  .  nolockIoMetho
2bbd0 64 73 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ds,          /* 
2bbe0 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
2bbf0 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a  ds object name *
2bc00 2f 0a 20 20 33 2c 20 20 20 20 20 20 20 20 20 20  /.  3,          
2bc10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2bc20 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 61   shared memory a
2bc30 6e 64 20 6d 6d 61 70 20 61 72 65 20 65 6e 61 62  nd mmap are enab
2bc40 6c 65 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 43  led */.  nolockC
2bc50 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20 20  lose,           
2bc60 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74     /* xClose met
2bc70 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 4c  hod */.  nolockL
2bc80 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20  ock,            
2bc90 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68     /* xLock meth
2bca0 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 55 6e  od */.  nolockUn
2bcb0 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20  lock,           
2bcc0 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74    /* xUnlock met
2bcd0 68 6f 64 20 2a 2f 0a 20 20 6e 6f 6c 6f 63 6b 43  hod */.  nolockC
2bce0 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
2bcf0 2c 20 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65  ,  /* xCheckRese
2bd00 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20  rvedLock method 
2bd10 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20 20 20  */.  0          
2bd20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2bd30 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64  * xShmMap method
2bd40 20 2a 2f 0a 29 0a 49 4f 4d 45 54 48 4f 44 53 28   */.).IOMETHODS(
2bd50 0a 20 20 64 6f 74 6c 6f 63 6b 49 6f 46 69 6e 64  .  dotlockIoFind
2bd60 65 72 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  er,          /* 
2bd70 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20  Finder function 
2bd80 6e 61 6d 65 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63  name */.  dotloc
2bd90 6b 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20  kIoMethods,     
2bda0 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 69      /* sqlite3_i
2bdb0 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74  o_methods object
2bdc0 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 20 20   name */.  1,   
2bdd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2bde0 20 20 20 20 20 2f 2a 20 73 68 61 72 65 64 20 6d       /* shared m
2bdf0 65 6d 6f 72 79 20 69 73 20 64 69 73 61 62 6c 65  emory is disable
2be00 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b 43 6c  d */.  dotlockCl
2be10 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  ose,            
2be20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f   /* xClose metho
2be30 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b 4c 6f  d */.  dotlockLo
2be40 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ck,             
2be50 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64   /* xLock method
2be60 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b 55 6e 6c   */.  dotlockUnl
2be70 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20  ock,            
2be80 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f  /* xUnlock metho
2be90 64 20 2a 2f 0a 20 20 64 6f 74 6c 6f 63 6b 43 68  d */.  dotlockCh
2bea0 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 2c  eckReservedLock,
2beb0 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76   /* xCheckReserv
2bec0 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f  edLock method */
2bed0 0a 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20  .  0            
2bee0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2bef0 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64 20 2a  xShmMap method *
2bf00 2f 0a 29 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f  /.)..#if SQLITE_
2bf10 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53  ENABLE_LOCKING_S
2bf20 54 59 4c 45 0a 49 4f 4d 45 54 48 4f 44 53 28 0a  TYLE.IOMETHODS(.
2bf30 20 20 66 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 2c    flockIoFinder,
2bf40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
2bf50 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20 6e  inder function n
2bf60 61 6d 65 20 2a 2f 0a 20 20 66 6c 6f 63 6b 49 6f  ame */.  flockIo
2bf70 4d 65 74 68 6f 64 73 2c 20 20 20 20 20 20 20 20  Methods,        
2bf80 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 69 6f     /* sqlite3_io
2bf90 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 20  _methods object 
2bfa0 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 20 20 20  name */.  1,    
2bfb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2bfc0 20 20 20 20 2f 2a 20 73 68 61 72 65 64 20 6d 65      /* shared me
2bfd0 6d 6f 72 79 20 69 73 20 64 69 73 61 62 6c 65 64  mory is disabled
2bfe0 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 6c 6f 73 65   */.  flockClose
2bff0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2c000 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f 64  /* xClose method
2c010 20 2a 2f 0a 20 20 66 6c 6f 63 6b 4c 6f 63 6b 2c   */.  flockLock,
2c020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c030 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64 20  /* xLock method 
2c040 2a 2f 0a 20 20 66 6c 6f 63 6b 55 6e 6c 6f 63 6b  */.  flockUnlock
2c050 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
2c060 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f 64  * xUnlock method
2c070 20 2a 2f 0a 20 20 66 6c 6f 63 6b 43 68 65 63 6b   */.  flockCheck
2c080 52 65 73 65 72 76 65 64 4c 6f 63 6b 2c 20 20 20  ReservedLock,   
2c090 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 65  /* xCheckReserve
2c0a0 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a  dLock method */.
2c0b0 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20    0             
2c0c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
2c0d0 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64 20 2a 2f  ShmMap method */
2c0e0 0a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 4f  .).#endif..#if O
2c0f0 53 5f 56 58 57 4f 52 4b 53 0a 49 4f 4d 45 54 48  S_VXWORKS.IOMETH
2c100 4f 44 53 28 0a 20 20 73 65 6d 49 6f 46 69 6e 64  ODS(.  semIoFind
2c110 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  er,             
2c120 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63 74   /* Finder funct
2c130 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 73 65  ion name */.  se
2c140 6d 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20 20  mIoMethods,     
2c150 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c 69 74          /* sqlit
2c160 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 6f 62  e3_io_methods ob
2c170 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 20 31  ject name */.  1
2c180 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
2c190 20 20 20 20 20 20 20 20 20 2f 2a 20 73 68 61 72           /* shar
2c1a0 65 64 20 6d 65 6d 6f 72 79 20 69 73 20 64 69 73  ed memory is dis
2c1b0 61 62 6c 65 64 20 2a 2f 0a 20 20 73 65 6d 58 43  abled */.  semXC
2c1c0 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20 20  lose,           
2c1d0 20 20 20 20 20 2f 2a 20 78 43 6c 6f 73 65 20 6d       /* xClose m
2c1e0 65 74 68 6f 64 20 2a 2f 0a 20 20 73 65 6d 58 4c  ethod */.  semXL
2c1f0 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20  ock,            
2c200 20 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65       /* xLock me
2c210 74 68 6f 64 20 2a 2f 0a 20 20 73 65 6d 58 55 6e  thod */.  semXUn
2c220 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20  lock,           
2c230 20 20 20 20 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d      /* xUnlock m
2c240 65 74 68 6f 64 20 2a 2f 0a 20 20 73 65 6d 58 43  ethod */.  semXC
2c250 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
2c260 2c 20 20 20 20 2f 2a 20 78 43 68 65 63 6b 52 65  ,    /* xCheckRe
2c270 73 65 72 76 65 64 4c 6f 63 6b 20 6d 65 74 68 6f  servedLock metho
2c280 64 20 2a 2f 0a 20 20 30 20 20 20 20 20 20 20 20  d */.  0        
2c290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c2a0 20 2f 2a 20 78 53 68 6d 4d 61 70 20 6d 65 74 68   /* xShmMap meth
2c2b0 6f 64 20 2a 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a  od */.).#endif..
2c2c0 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41 50  #if defined(__AP
2c2d0 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49 54 45  PLE__) && SQLITE
2c2e0 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f  _ENABLE_LOCKING_
2c2f0 53 54 59 4c 45 0a 49 4f 4d 45 54 48 4f 44 53 28  STYLE.IOMETHODS(
2c300 0a 20 20 61 66 70 49 6f 46 69 6e 64 65 72 2c 20  .  afpIoFinder, 
2c310 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2c320 46 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 20  Finder function 
2c330 6e 61 6d 65 20 2a 2f 0a 20 20 61 66 70 49 6f 4d  name */.  afpIoM
2c340 65 74 68 6f 64 73 2c 20 20 20 20 20 20 20 20 20  ethods,         
2c350 20 20 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 69      /* sqlite3_i
2c360 6f 5f 6d 65 74 68 6f 64 73 20 6f 62 6a 65 63 74  o_methods object
2c370 20 6e 61 6d 65 20 2a 2f 0a 20 20 31 2c 20 20 20   name */.  1,   
2c380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c390 20 20 20 20 20 2f 2a 20 73 68 61 72 65 64 20 6d       /* shared m
2c3a0 65 6d 6f 72 79 20 69 73 20 64 69 73 61 62 6c 65  emory is disable
2c3b0 64 20 2a 2f 0a 20 20 61 66 70 43 6c 6f 73 65 2c  d */.  afpClose,
2c3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c3d0 20 2f 2a 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f   /* xClose metho
2c3e0 64 20 2a 2f 0a 20 20 61 66 70 4c 6f 63 6b 2c 20  d */.  afpLock, 
2c3f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c400 20 2f 2a 20 78 4c 6f 63 6b 20 6d 65 74 68 6f 64   /* xLock method
2c410 20 2a 2f 0a 20 20 61 66 70 55 6e 6c 6f 63 6b 2c   */.  afpUnlock,
2c420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c430 2f 2a 20 78 55 6e 6c 6f 63 6b 20 6d 65 74 68 6f  /* xUnlock metho
2c440 64 20 2a 2f 0a 20 20 61 66 70 43 68 65 63 6b 52  d */.  afpCheckR
2c450 65 73 65 72 76 65 64 4c 6f 63 6b 2c 20 20 20 20  eservedLock,    
2c460 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76   /* xCheckReserv
2c470 65 64 4c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f  edLock method */
2c480 0a 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20  .  0            
2c490 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2c4a0 78 53 68 6d 4d 61 70 20 6d 65 74 68 6f 64 20 2a  xShmMap method *
2c4b0 2f 0a 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  /.).#endif../*.*
2c4c0 2a 20 54 68 65 20 70 72 6f 78 79 20 6c 6f 63 6b  * The proxy lock
2c4d0 69 6e 67 20 6d 65 74 68 6f 64 20 69 73 20 61 20  ing method is a 
2c4e0 22 73 75 70 65 72 2d 6d 65 74 68 6f 64 22 20 69  "super-method" i
2c4f0 6e 20 74 68 65 20 73 65 6e 73 65 20 74 68 61 74  n the sense that
2c500 20 69 74 0a 2a 2a 20 6f 70 65 6e 73 20 73 65 63   it.** opens sec
2c510 6f 6e 64 61 72 79 20 66 69 6c 65 20 64 65 73 63  ondary file desc
2c520 72 69 70 74 6f 72 73 20 66 6f 72 20 74 68 65 20  riptors for the 
2c530 63 6f 6e 63 68 20 61 6e 64 20 6c 6f 63 6b 20 66  conch and lock f
2c540 69 6c 65 73 20 61 6e 64 0a 2a 2a 20 69 74 20 75  iles and.** it u
2c550 73 65 73 20 70 72 6f 78 79 2c 20 64 6f 74 2d 66  ses proxy, dot-f
2c560 69 6c 65 2c 20 41 46 50 2c 20 61 6e 64 20 66 6c  ile, AFP, and fl
2c570 6f 63 6b 28 29 20 6c 6f 63 6b 69 6e 67 20 6d 65  ock() locking me
2c580 74 68 6f 64 73 20 6f 6e 20 74 68 6f 73 65 0a 2a  thods on those.*
2c590 2a 20 73 65 63 6f 6e 64 61 72 79 20 66 69 6c 65  * secondary file
2c5a0 73 2e 20 20 46 6f 72 20 74 68 69 73 20 72 65 61  s.  For this rea
2c5b0 73 6f 6e 2c 20 74 68 65 20 64 69 76 69 73 69 6f  son, the divisio
2c5c0 6e 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74  n that implement
2c5d0 73 0a 2a 2a 20 70 72 6f 78 79 20 6c 6f 63 6b 69  s.** proxy locki
2c5e0 6e 67 20 69 73 20 6c 6f 63 61 74 65 64 20 6d 75  ng is located mu
2c5f0 63 68 20 66 75 72 74 68 65 72 20 64 6f 77 6e 20  ch further down 
2c600 69 6e 20 74 68 65 20 66 69 6c 65 2e 20 20 42 75  in the file.  Bu
2c610 74 20 77 65 20 6e 65 65 64 0a 2a 2a 20 74 6f 20  t we need.** to 
2c620 67 6f 20 61 68 65 61 64 20 61 6e 64 20 64 65 66  go ahead and def
2c630 69 6e 65 20 74 68 65 20 73 71 6c 69 74 65 33 5f  ine the sqlite3_
2c640 69 6f 5f 6d 65 74 68 6f 64 73 20 61 6e 64 20 66  io_methods and f
2c650 69 6e 64 65 72 20 66 75 6e 63 74 69 6f 6e 0a 2a  inder function.*
2c660 2a 20 66 6f 72 20 70 72 6f 78 79 20 6c 6f 63 6b  * for proxy lock
2c670 69 6e 67 20 68 65 72 65 2e 20 20 53 6f 20 77 65  ing here.  So we
2c680 20 66 6f 72 77 61 72 64 20 64 65 63 6c 61 72 65   forward declare
2c690 20 74 68 65 20 49 2f 4f 20 6d 65 74 68 6f 64 73   the I/O methods
2c6a0 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64  ..*/.#if defined
2c6b0 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 53  (__APPLE__) && S
2c6c0 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43  QLITE_ENABLE_LOC
2c6d0 4b 49 4e 47 5f 53 54 59 4c 45 0a 73 74 61 74 69  KING_STYLE.stati
2c6e0 63 20 69 6e 74 20 70 72 6f 78 79 43 6c 6f 73 65  c int proxyClose
2c6f0 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 3b  (sqlite3_file*);
2c700 0a 73 74 61 74 69 63 20 69 6e 74 20 70 72 6f 78  .static int prox
2c710 79 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69  yLock(sqlite3_fi
2c720 6c 65 2a 2c 20 69 6e 74 29 3b 0a 73 74 61 74 69  le*, int);.stati
2c730 63 20 69 6e 74 20 70 72 6f 78 79 55 6e 6c 6f 63  c int proxyUnloc
2c740 6b 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c  k(sqlite3_file*,
2c750 20 69 6e 74 29 3b 0a 73 74 61 74 69 63 20 69 6e   int);.static in
2c760 74 20 70 72 6f 78 79 43 68 65 63 6b 52 65 73 65  t proxyCheckRese
2c770 72 76 65 64 4c 6f 63 6b 28 73 71 6c 69 74 65 33  rvedLock(sqlite3
2c780 5f 66 69 6c 65 2a 2c 20 69 6e 74 2a 29 3b 0a 49  _file*, int*);.I
2c790 4f 4d 45 54 48 4f 44 53 28 0a 20 20 70 72 6f 78  OMETHODS(.  prox
2c7a0 79 49 6f 46 69 6e 64 65 72 2c 20 20 20 20 20 20  yIoFinder,      
2c7b0 20 20 20 20 20 20 2f 2a 20 46 69 6e 64 65 72 20        /* Finder 
2c7c0 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f  function name */
2c7d0 0a 20 20 70 72 6f 78 79 49 6f 4d 65 74 68 6f 64  .  proxyIoMethod
2c7e0 73 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  s,           /* 
2c7f0 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
2c800 64 73 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a  ds object name *
2c810 2f 0a 20 20 31 2c 20 20 20 20 20 20 20 20 20 20  /.  1,          
2c820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2c830 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 69   shared memory i
2c840 73 20 64 69 73 61 62 6c 65 64 20 2a 2f 0a 20 20  s disabled */.  
2c850 70 72 6f 78 79 43 6c 6f 73 65 2c 20 20 20 20 20  proxyClose,     
2c860 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c            /* xCl
2c870 6f 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20  ose method */.  
2c880 70 72 6f 78 79 4c 6f 63 6b 2c 20 20 20 20 20 20  proxyLock,      
2c890 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f            /* xLo
2c8a0 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 70  ck method */.  p
2c8b0 72 6f 78 79 55 6e 6c 6f 63 6b 2c 20 20 20 20 20  roxyUnlock,     
2c8c0 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e 6c           /* xUnl
2c8d0 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20  ock method */.  
2c8e0 70 72 6f 78 79 43 68 65 63 6b 52 65 73 65 72 76  proxyCheckReserv
2c8f0 65 64 4c 6f 63 6b 2c 20 20 20 2f 2a 20 78 43 68  edLock,   /* xCh
2c900 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20  eckReservedLock 
2c910 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 30 20 20 20  method */.  0   
2c920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2c930 20 20 20 20 20 20 2f 2a 20 78 53 68 6d 4d 61 70        /* xShmMap
2c940 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a 23 65 6e   method */.).#en
2c950 64 69 66 0a 0a 2f 2a 20 6e 66 73 20 6c 6f 63 6b  dif../* nfs lock
2c960 64 20 6f 6e 20 4f 53 58 20 31 30 2e 33 2b 20 64  d on OSX 10.3+ d
2c970 6f 65 73 6e 27 74 20 63 6c 65 61 72 20 77 72 69  oesn't clear wri
2c980 74 65 20 6c 6f 63 6b 73 20 77 68 65 6e 20 61 20  te locks when a 
2c990 72 65 61 64 20 6c 6f 63 6b 20 69 73 20 73 65 74  read lock is set
2c9a0 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28   */.#if defined(
2c9b0 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 53 51  __APPLE__) && SQ
2c9c0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b  LITE_ENABLE_LOCK
2c9d0 49 4e 47 5f 53 54 59 4c 45 0a 49 4f 4d 45 54 48  ING_STYLE.IOMETH
2c9e0 4f 44 53 28 0a 20 20 6e 66 73 49 6f 46 69 6e 64  ODS(.  nfsIoFind
2c9f0 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  er,             
2ca00 20 20 2f 2a 20 46 69 6e 64 65 72 20 66 75 6e 63    /* Finder func
2ca10 74 69 6f 6e 20 6e 61 6d 65 20 2a 2f 0a 20 20 6e  tion name */.  n
2ca20 66 73 49 6f 4d 65 74 68 6f 64 73 2c 20 20 20 20  fsIoMethods,    
2ca30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c            /* sql
2ca40 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20  ite3_io_methods 
2ca50 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20  object name */. 
2ca60 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   1,             
2ca70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73              /* s
2ca80 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 69 73 20  hared memory is 
2ca90 64 69 73 61 62 6c 65 64 20 2a 2f 0a 20 20 75 6e  disabled */.  un
2caa0 69 78 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20  ixClose,        
2cab0 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f           /* xClo
2cac0 73 65 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 75  se method */.  u
2cad0 6e 69 78 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20  nixLock,        
2cae0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4c 6f            /* xLo
2caf0 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 6e  ck method */.  n
2cb00 66 73 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20  fsUnlock,       
2cb10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 55 6e            /* xUn
2cb20 6c 6f 63 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20  lock method */. 
2cb30 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72 76   unixCheckReserv
2cb40 65 64 4c 6f 63 6b 2c 20 20 20 20 20 2f 2a 20 78  edLock,     /* x
2cb50 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63  CheckReservedLoc
2cb60 6b 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 30 20  k method */.  0 
2cb70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2cb80 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 68 6d           /* xShm
2cb90 4d 61 70 20 6d 65 74 68 6f 64 20 2a 2f 0a 29 0a  Map method */.).
2cba0 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 65 66 69  #endif..#if defi
2cbb0 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26  ned(__APPLE__) &
2cbc0 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  & SQLITE_ENABLE_
2cbd0 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 2f 2a  LOCKING_STYLE./*
2cbe0 20 0a 2a 2a 20 54 68 69 73 20 22 66 69 6e 64 65   .** This "finde
2cbf0 72 22 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65  r" function atte
2cc00 6d 70 74 73 20 74 6f 20 64 65 74 65 72 6d 69 6e  mpts to determin
2cc10 65 20 74 68 65 20 62 65 73 74 20 6c 6f 63 6b 69  e the best locki
2cc20 6e 67 20 73 74 72 61 74 65 67 79 20 0a 2a 2a 20  ng strategy .** 
2cc30 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65  for the database
2cc40 20 66 69 6c 65 20 22 66 69 6c 65 50 61 74 68 22   file "filePath"
2cc50 2e 20 20 49 74 20 74 68 65 6e 20 72 65 74 75 72  .  It then retur
2cc60 6e 73 20 74 68 65 20 73 71 6c 69 74 65 33 5f 69  ns the sqlite3_i
2cc70 6f 5f 6d 65 74 68 6f 64 73 0a 2a 2a 20 6f 62 6a  o_methods.** obj
2cc80 65 63 74 20 74 68 61 74 20 69 6d 70 6c 65 6d 65  ect that impleme
2cc90 6e 74 73 20 74 68 61 74 20 73 74 72 61 74 65 67  nts that strateg
2cca0 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73  y..**.** This is
2ccb0 20 66 6f 72 20 4d 61 63 4f 53 58 20 6f 6e 6c 79   for MacOSX only
2ccc0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73  ..*/.static cons
2ccd0 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74  t sqlite3_io_met
2cce0 68 6f 64 73 20 2a 61 75 74 6f 6c 6f 63 6b 49 6f  hods *autolockIo
2ccf0 46 69 6e 64 65 72 49 6d 70 6c 28 0a 20 20 63 6f  FinderImpl(.  co
2cd00 6e 73 74 20 63 68 61 72 20 2a 66 69 6c 65 50 61  nst char *filePa
2cd10 74 68 2c 20 20 20 20 2f 2a 20 6e 61 6d 65 20 6f  th,    /* name o
2cd20 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
2cd30 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78 46 69 6c  ile */.  unixFil
2cd40 65 20 2a 70 4e 65 77 20 20 20 20 20 20 20 20 20  e *pNew         
2cd50 20 20 2f 2a 20 6f 70 65 6e 20 66 69 6c 65 20 6f    /* open file o
2cd60 62 6a 65 63 74 20 66 6f 72 20 74 68 65 20 64 61  bject for the da
2cd70 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 29  tabase file */.)
2cd80 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74  {.  static const
2cd90 20 73 74 72 75 63 74 20 4d 61 70 70 69 6e 67 20   struct Mapping 
2cda0 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72  {.    const char
2cdb0 20 2a 7a 46 69 6c 65 73 79 73 74 65 6d 3b 20 20   *zFilesystem;  
2cdc0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
2cdd0 69 6c 65 73 79 73 74 65 6d 20 74 79 70 65 20 6e  ilesystem type n
2cde0 61 6d 65 20 2a 2f 0a 20 20 20 20 63 6f 6e 73 74  ame */.    const
2cdf0 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68   sqlite3_io_meth
2ce00 6f 64 73 20 2a 70 4d 65 74 68 6f 64 73 3b 20 20  ods *pMethods;  
2ce10 20 2f 2a 20 41 70 70 72 6f 70 72 69 61 74 65 20   /* Appropriate 
2ce20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68 6f 64 20 2a  locking method *
2ce30 2f 0a 20 20 7d 20 61 4d 61 70 5b 5d 20 3d 20 7b  /.  } aMap[] = {
2ce40 0a 20 20 20 20 7b 20 22 68 66 73 22 2c 20 20 20  .    { "hfs",   
2ce50 20 26 70 6f 73 69 78 49 6f 4d 65 74 68 6f 64 73   &posixIoMethods
2ce60 20 7d 2c 0a 20 20 20 20 7b 20 22 75 66 73 22 2c   },.    { "ufs",
2ce70 20 20 20 20 26 70 6f 73 69 78 49 6f 4d 65 74 68      &posixIoMeth
2ce80 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 22 61 66  ods },.    { "af
2ce90 70 66 73 22 2c 20 20 26 61 66 70 49 6f 4d 65 74  pfs",  &afpIoMet
2cea0 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 22 73  hods },.    { "s
2ceb0 6d 62 66 73 22 2c 20 20 26 61 66 70 49 6f 4d 65  mbfs",  &afpIoMe
2cec0 74 68 6f 64 73 20 7d 2c 0a 20 20 20 20 7b 20 22  thods },.    { "
2ced0 77 65 62 64 61 76 22 2c 20 26 6e 6f 6c 6f 63 6b  webdav", &nolock
2cee0 49 6f 4d 65 74 68 6f 64 73 20 7d 2c 0a 20 20 20  IoMethods },.   
2cef0 20 7b 20 30 2c 20 30 20 7d 0a 20 20 7d 3b 0a 20   { 0, 0 }.  };. 
2cf00 20 69 6e 74 20 69 3b 0a 20 20 73 74 72 75 63 74   int i;.  struct
2cf10 20 73 74 61 74 66 73 20 66 73 49 6e 66 6f 3b 0a   statfs fsInfo;.
2cf20 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c    struct flock l
2cf30 6f 63 6b 49 6e 66 6f 3b 0a 0a 20 20 69 66 28 20  ockInfo;..  if( 
2cf40 21 66 69 6c 65 50 61 74 68 20 29 7b 0a 20 20 20  !filePath ){.   
2cf50 20 2f 2a 20 49 66 20 66 69 6c 65 50 61 74 68 3d   /* If filePath=
2cf60 3d 4e 55 4c 4c 20 74 68 61 74 20 6d 65 61 6e 73  =NULL that means
2cf70 20 77 65 20 61 72 65 20 64 65 61 6c 69 6e 67 20   we are dealing 
2cf80 77 69 74 68 20 61 20 74 72 61 6e 73 69 65 6e 74  with a transient
2cf90 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 74 68 61   file.    ** tha
2cfa0 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20  t does not need 
2cfb0 74 6f 20 62 65 20 6c 6f 63 6b 65 64 2e 20 2a 2f  to be locked. */
2cfc0 0a 20 20 20 20 72 65 74 75 72 6e 20 26 6e 6f 6c  .    return &nol
2cfd0 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20  ockIoMethods;.  
2cfe0 7d 0a 20 20 69 66 28 20 73 74 61 74 66 73 28 66  }.  if( statfs(f
2cff0 69 6c 65 50 61 74 68 2c 20 26 66 73 49 6e 66 6f  ilePath, &fsInfo
2d000 29 20 21 3d 20 2d 31 20 29 7b 0a 20 20 20 20 69  ) != -1 ){.    i
2d010 66 28 20 66 73 49 6e 66 6f 2e 66 5f 66 6c 61 67  f( fsInfo.f_flag
2d020 73 20 26 20 4d 4e 54 5f 52 44 4f 4e 4c 59 20 29  s & MNT_RDONLY )
2d030 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 26  {.      return &
2d040 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b  nolockIoMethods;
2d050 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69  .    }.    for(i
2d060 3d 30 3b 20 61 4d 61 70 5b 69 5d 2e 7a 46 69 6c  =0; aMap[i].zFil
2d070 65 73 79 73 74 65 6d 3b 20 69 2b 2b 29 7b 0a 20  esystem; i++){. 
2d080 20 20 20 20 20 69 66 28 20 73 74 72 63 6d 70 28       if( strcmp(
2d090 66 73 49 6e 66 6f 2e 66 5f 66 73 74 79 70 65 6e  fsInfo.f_fstypen
2d0a0 61 6d 65 2c 20 61 4d 61 70 5b 69 5d 2e 7a 46 69  ame, aMap[i].zFi
2d0b0 6c 65 73 79 73 74 65 6d 29 3d 3d 30 20 29 7b 0a  lesystem)==0 ){.
2d0c0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 61          return a
2d0d0 4d 61 70 5b 69 5d 2e 70 4d 65 74 68 6f 64 73 3b  Map[i].pMethods;
2d0e0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
2d0f0 20 7d 0a 0a 20 20 2f 2a 20 44 65 66 61 75 6c 74   }..  /* Default
2d100 20 63 61 73 65 2e 20 48 61 6e 64 6c 65 73 2c 20   case. Handles, 
2d110 61 6d 6f 6e 67 73 74 20 6f 74 68 65 72 73 2c 20  amongst others, 
2d120 22 6e 66 73 22 2e 0a 20 20 2a 2a 20 54 65 73 74  "nfs"..  ** Test
2d130 20 62 79 74 65 2d 72 61 6e 67 65 20 6c 6f 63 6b   byte-range lock
2d140 20 75 73 69 6e 67 20 66 63 6e 74 6c 28 29 2e 20   using fcntl(). 
2d150 49 66 20 74 68 65 20 63 61 6c 6c 20 73 75 63 63  If the call succ
2d160 65 65 64 73 2c 20 0a 20 20 2a 2a 20 61 73 73 75  eeds, .  ** assu
2d170 6d 65 20 74 68 61 74 20 74 68 65 20 66 69 6c 65  me that the file
2d180 2d 73 79 73 74 65 6d 20 73 75 70 70 6f 72 74 73  -system supports
2d190 20 50 4f 53 49 58 20 73 74 79 6c 65 20 6c 6f 63   POSIX style loc
2d1a0 6b 73 2e 20 0a 20 20 2a 2f 0a 20 20 6c 6f 63 6b  ks. .  */.  lock
2d1b0 49 6e 66 6f 2e 6c 5f 6c 65 6e 20 3d 20 31 3b 0a  Info.l_len = 1;.
2d1c0 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 73 74 61    lockInfo.l_sta
2d1d0 72 74 20 3d 20 30 3b 0a 20 20 6c 6f 63 6b 49 6e  rt = 0;.  lockIn
2d1e0 66 6f 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45  fo.l_whence = SE
2d1f0 45 4b 5f 53 45 54 3b 0a 20 20 6c 6f 63 6b 49 6e  EK_SET;.  lockIn
2d200 66 6f 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 52 44  fo.l_type = F_RD
2d210 4c 43 4b 3b 0a 20 20 69 66 28 20 6f 73 46 63 6e  LCK;.  if( osFcn
2d220 74 6c 28 70 4e 65 77 2d 3e 68 2c 20 46 5f 47 45  tl(pNew->h, F_GE
2d230 54 4c 4b 2c 20 26 6c 6f 63 6b 49 6e 66 6f 29 21  TLK, &lockInfo)!
2d240 3d 2d 31 20 29 20 7b 0a 20 20 20 20 69 66 28 20  =-1 ) {.    if( 
2d250 73 74 72 63 6d 70 28 66 73 49 6e 66 6f 2e 66 5f  strcmp(fsInfo.f_
2d260 66 73 74 79 70 65 6e 61 6d 65 2c 20 22 6e 66 73  fstypename, "nfs
2d270 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72  ")==0 ){.      r
2d280 65 74 75 72 6e 20 26 6e 66 73 49 6f 4d 65 74 68  eturn &nfsIoMeth
2d290 6f 64 73 3b 0a 20 20 20 20 7d 20 65 6c 73 65 20  ods;.    } else 
2d2a0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 26  {.      return &
2d2b0 70 6f 73 69 78 49 6f 4d 65 74 68 6f 64 73 3b 0a  posixIoMethods;.
2d2c0 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
2d2d0 20 20 20 72 65 74 75 72 6e 20 26 64 6f 74 6c 6f     return &dotlo
2d2e0 63 6b 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d  ckIoMethods;.  }
2d2f0 0a 7d 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .}.static const 
2d300 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
2d310 64 73 20 0a 20 20 2a 28 2a 63 6f 6e 73 74 20 61  ds .  *(*const a
2d320 75 74 6f 6c 6f 63 6b 49 6f 46 69 6e 64 65 72 29  utolockIoFinder)
2d330 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69  (const char*,uni
2d340 78 46 69 6c 65 2a 29 20 3d 20 61 75 74 6f 6c 6f  xFile*) = autolo
2d350 63 6b 49 6f 46 69 6e 64 65 72 49 6d 70 6c 3b 0a  ckIoFinderImpl;.
2d360 0a 23 65 6e 64 69 66 20 2f 2a 20 64 65 66 69 6e  .#endif /* defin
2d370 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 26  ed(__APPLE__) &&
2d380 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c   SQLITE_ENABLE_L
2d390 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 20 2a 2f 0a  OCKING_STYLE */.
2d3a0 0a 23 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a  .#if OS_VXWORKS.
2d3b0 2f 2a 0a 2a 2a 20 54 68 69 73 20 22 66 69 6e 64  /*.** This "find
2d3c0 65 72 22 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72  er" function for
2d3d0 20 56 78 57 6f 72 6b 73 20 63 68 65 63 6b 73 20   VxWorks checks 
2d3e0 74 6f 20 73 65 65 20 69 66 20 70 6f 73 69 78 20  to see if posix 
2d3f0 61 64 76 69 73 6f 72 79 0a 2a 2a 20 6c 6f 63 6b  advisory.** lock
2d400 69 6e 67 20 77 6f 72 6b 73 2e 20 20 49 66 20 69  ing works.  If i
2d410 74 20 64 6f 65 73 2c 20 74 68 65 6e 20 74 68 61  t does, then tha
2d420 74 20 69 73 20 77 68 61 74 20 69 73 20 75 73 65  t is what is use
2d430 64 2e 20 20 49 66 20 69 74 20 64 6f 65 73 20 6e  d.  If it does n
2d440 6f 74 0a 2a 2a 20 77 6f 72 6b 2c 20 74 68 65 6e  ot.** work, then
2d450 20 66 61 6c 6c 62 61 63 6b 20 74 6f 20 6e 61 6d   fallback to nam
2d460 65 64 20 73 65 6d 61 70 68 6f 72 65 20 6c 6f 63  ed semaphore loc
2d470 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  king..*/.static 
2d480 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 69 6f  const sqlite3_io
2d490 5f 6d 65 74 68 6f 64 73 20 2a 76 78 77 6f 72 6b  _methods *vxwork
2d4a0 73 49 6f 46 69 6e 64 65 72 49 6d 70 6c 28 0a 20  sIoFinderImpl(. 
2d4b0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 66 69 6c   const char *fil
2d4c0 65 50 61 74 68 2c 20 20 20 20 2f 2a 20 6e 61 6d  ePath,    /* nam
2d4d0 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  e of the databas
2d4e0 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 6e 69 78  e file */.  unix
2d4f0 46 69 6c 65 20 2a 70 4e 65 77 20 20 20 20 20 20  File *pNew      
2d500 20 20 20 20 20 2f 2a 20 74 68 65 20 6f 70 65 6e       /* the open
2d510 20 66 69 6c 65 20 6f 62 6a 65 63 74 20 2a 2f 0a   file object */.
2d520 29 7b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63  ){.  struct floc
2d530 6b 20 6c 6f 63 6b 49 6e 66 6f 3b 0a 0a 20 20 69  k lockInfo;..  i
2d540 66 28 20 21 66 69 6c 65 50 61 74 68 20 29 7b 0a  f( !filePath ){.
2d550 20 20 20 20 2f 2a 20 49 66 20 66 69 6c 65 50 61      /* If filePa
2d560 74 68 3d 3d 4e 55 4c 4c 20 74 68 61 74 20 6d 65  th==NULL that me
2d570 61 6e 73 20 77 65 20 61 72 65 20 64 65 61 6c 69  ans we are deali
2d580 6e 67 20 77 69 74 68 20 61 20 74 72 61 6e 73 69  ng with a transi
2d590 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20  ent file.    ** 
2d5a0 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65  that does not ne
2d5b0 65 64 20 74 6f 20 62 65 20 6c 6f 63 6b 65 64 2e  ed to be locked.
2d5c0 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 26   */.    return &
2d5d0 6e 6f 6c 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 3b  nolockIoMethods;
2d5e0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 65 73 74 20  .  }..  /* Test 
2d5f0 69 66 20 66 63 6e 74 6c 28 29 20 69 73 20 73 75  if fcntl() is su
2d600 70 70 6f 72 74 65 64 20 61 6e 64 20 75 73 65 20  pported and use 
2d610 50 4f 53 49 58 20 73 74 79 6c 65 20 6c 6f 63 6b  POSIX style lock
2d620 73 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 73  s..  ** Otherwis
2d630 65 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74  e fall back to t
2d640 68 65 20 6e 61 6d 65 64 20 73 65 6d 61 70 68 6f  he named semapho
2d650 72 65 20 6d 65 74 68 6f 64 2e 0a 20 20 2a 2f 0a  re method..  */.
2d660 20 20 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 6c 65 6e    lockInfo.l_len
2d670 20 3d 20 31 3b 0a 20 20 6c 6f 63 6b 49 6e 66 6f   = 1;.  lockInfo
2d680 2e 6c 5f 73 74 61 72 74 20 3d 20 30 3b 0a 20 20  .l_start = 0;.  
2d690 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 77 68 65 6e 63  lockInfo.l_whenc
2d6a0 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20  e = SEEK_SET;.  
2d6b0 6c 6f 63 6b 49 6e 66 6f 2e 6c 5f 74 79 70 65 20  lockInfo.l_type 
2d6c0 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 69 66 28  = F_RDLCK;.  if(
2d6d0 20 6f 73 46 63 6e 74 6c 28 70 4e 65 77 2d 3e 68   osFcntl(pNew->h
2d6e0 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_GETLK, &lock
2d6f0 49 6e 66 6f 29 21 3d 2d 31 20 29 20 7b 0a 20 20  Info)!=-1 ) {.  
2d700 20 20 72 65 74 75 72 6e 20 26 70 6f 73 69 78 49    return &posixI
2d710 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d 65 6c 73  oMethods;.  }els
2d720 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 26 73  e{.    return &s
2d730 65 6d 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d  emIoMethods;.  }
2d740 0a 7d 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .}.static const 
2d750 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
2d760 64 73 20 0a 20 20 2a 28 2a 63 6f 6e 73 74 20 76  ds .  *(*const v
2d770 78 77 6f 72 6b 73 49 6f 46 69 6e 64 65 72 29 28  xworksIoFinder)(
2d780 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 69 78  const char*,unix
2d790 46 69 6c 65 2a 29 20 3d 20 76 78 77 6f 72 6b 73  File*) = vxworks
2d7a0 49 6f 46 69 6e 64 65 72 49 6d 70 6c 3b 0a 0a 23  IoFinderImpl;..#
2d7b0 65 6e 64 69 66 20 2f 2a 20 4f 53 5f 56 58 57 4f  endif /* OS_VXWO
2d7c0 52 4b 53 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e  RKS */../*.** An
2d7d0 20 61 62 73 74 72 61 63 74 20 74 79 70 65 20 66   abstract type f
2d7e0 6f 72 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  or a pointer to 
2d7f0 61 6e 20 49 4f 20 6d 65 74 68 6f 64 20 66 69 6e  an IO method fin
2d800 64 65 72 20 66 75 6e 63 74 69 6f 6e 3a 0a 2a 2f  der function:.*/
2d810 0a 74 79 70 65 64 65 66 20 63 6f 6e 73 74 20 73  .typedef const s
2d820 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64  qlite3_io_method
2d830 73 20 2a 28 2a 66 69 6e 64 65 72 5f 74 79 70 65  s *(*finder_type
2d840 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e  )(const char*,un
2d850 69 78 46 69 6c 65 2a 29 3b 0a 0a 0a 2f 2a 2a 2a  ixFile*);.../***
2d860 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d870 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d880 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d890 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d8a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 2a 2a 2a 2a  *********.******
2d8b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d8c0 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 76  ****** sqlite3_v
2d8d0 66 73 20 6d 65 74 68 6f 64 73 20 2a 2a 2a 2a 2a  fs methods *****
2d8e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d8f0 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68  *******.**.** Th
2d900 69 73 20 64 69 76 69 73 69 6f 6e 20 63 6f 6e 74  is division cont
2d910 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65 6d 65  ains the impleme
2d920 6e 74 61 74 69 6f 6e 20 6f 66 20 6d 65 74 68 6f  ntation of metho
2d930 64 73 20 6f 6e 20 74 68 65 0a 2a 2a 20 73 71 6c  ds on the.** sql
2d940 69 74 65 33 5f 76 66 73 20 6f 62 6a 65 63 74 2e  ite3_vfs object.
2d950 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69  .*/../*.** Initi
2d960 61 6c 69 7a 65 20 74 68 65 20 63 6f 6e 74 65 6e  alize the conten
2d970 74 73 20 6f 66 20 74 68 65 20 75 6e 69 78 46 69  ts of the unixFi
2d980 6c 65 20 73 74 72 75 63 74 75 72 65 20 70 6f 69  le structure poi
2d990 6e 74 65 64 20 74 6f 20 62 79 20 70 49 64 2e 0a  nted to by pId..
2d9a0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69  */.static int fi
2d9b0 6c 6c 49 6e 55 6e 69 78 46 69 6c 65 28 0a 20 20  llInUnixFile(.  
2d9c0 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66  sqlite3_vfs *pVf
2d9d0 73 2c 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74  s,      /* Point
2d9e0 65 72 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74  er to vfs object
2d9f0 20 2a 2f 0a 20 20 69 6e 74 20 68 2c 20 20 20 20   */.  int h,    
2da00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2da10 20 4f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72   Open file descr
2da20 69 70 74 6f 72 20 6f 66 20 66 69 6c 65 20 62 65  iptor of file be
2da30 69 6e 67 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 20  ing opened */.  
2da40 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 49  sqlite3_file *pI
2da50 64 2c 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65  d,      /* Write
2da60 20 74 6f 20 74 68 65 20 75 6e 69 78 46 69 6c 65   to the unixFile
2da70 20 73 74 72 75 63 74 75 72 65 20 68 65 72 65 20   structure here 
2da80 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
2da90 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20  *zFilename,  /* 
2daa0 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65  Name of the file
2dab0 20 62 65 69 6e 67 20 6f 70 65 6e 65 64 20 2a 2f   being opened */
2dac0 0a 20 20 69 6e 74 20 63 74 72 6c 46 6c 61 67 73  .  int ctrlFlags
2dad0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 5a 65             /* Ze
2dae0 72 6f 20 6f 72 20 6d 6f 72 65 20 55 4e 49 58 46  ro or more UNIXF
2daf0 49 4c 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a  ILE_* values */.
2db00 29 7b 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69 74  ){.  const sqlit
2db10 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 20 2a 70  e3_io_methods *p
2db20 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 3b 0a 20 20  LockingStyle;.  
2db30 75 6e 69 78 46 69 6c 65 20 2a 70 4e 65 77 20 3d  unixFile *pNew =
2db40 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 70 49 64   (unixFile *)pId
2db50 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
2db60 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72  ITE_OK;..  asser
2db70 74 28 20 70 4e 65 77 2d 3e 70 49 6e 6f 64 65 3d  t( pNew->pInode=
2db80 3d 4e 55 4c 4c 20 29 3b 0a 0a 20 20 2f 2a 20 4e  =NULL );..  /* N
2db90 6f 20 6c 6f 63 6b 69 6e 67 20 6f 63 63 75 72 73  o locking occurs
2dba0 20 69 6e 20 74 65 6d 70 6f 72 61 72 79 20 66 69   in temporary fi
2dbb0 6c 65 73 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  les */.  assert(
2dbc0 20 7a 46 69 6c 65 6e 61 6d 65 21 3d 30 20 7c 7c   zFilename!=0 ||
2dbd0 20 28 63 74 72 6c 46 6c 61 67 73 20 26 20 55 4e   (ctrlFlags & UN
2dbe0 49 58 46 49 4c 45 5f 4e 4f 4c 4f 43 4b 29 21 3d  IXFILE_NOLOCK)!=
2dbf0 30 20 29 3b 0a 0a 20 20 4f 53 54 52 41 43 45 28  0 );..  OSTRACE(
2dc00 28 22 4f 50 45 4e 20 20 20 20 25 2d 33 64 20 25  ("OPEN    %-3d %
2dc10 73 5c 6e 22 2c 20 68 2c 20 7a 46 69 6c 65 6e 61  s\n", h, zFilena
2dc20 6d 65 29 29 3b 0a 20 20 70 4e 65 77 2d 3e 68 20  me));.  pNew->h 
2dc30 3d 20 68 3b 0a 20 20 70 4e 65 77 2d 3e 70 56 66  = h;.  pNew->pVf
2dc40 73 20 3d 20 70 56 66 73 3b 0a 20 20 70 4e 65 77  s = pVfs;.  pNew
2dc50 2d 3e 7a 50 61 74 68 20 3d 20 7a 46 69 6c 65 6e  ->zPath = zFilen
2dc60 61 6d 65 3b 0a 20 20 70 4e 65 77 2d 3e 63 74 72  ame;.  pNew->ctr
2dc70 6c 46 6c 61 67 73 20 3d 20 28 75 38 29 63 74 72  lFlags = (u8)ctr
2dc80 6c 46 6c 61 67 73 3b 0a 23 69 66 20 53 51 4c 49  lFlags;.#if SQLI
2dc90 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45  TE_MAX_MMAP_SIZE
2dca0 3e 30 0a 20 20 70 4e 65 77 2d 3e 6d 6d 61 70 53  >0.  pNew->mmapS
2dcb0 69 7a 65 4d 61 78 20 3d 20 73 71 6c 69 74 65 33  izeMax = sqlite3
2dcc0 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 73 7a 4d  GlobalConfig.szM
2dcd0 6d 61 70 3b 0a 23 65 6e 64 69 66 0a 20 20 69 66  map;.#endif.  if
2dce0 28 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 62 6f  ( sqlite3_uri_bo
2dcf0 6f 6c 65 61 6e 28 28 28 63 74 72 6c 46 6c 61 67  olean(((ctrlFlag
2dd00 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 55 52 49  s & UNIXFILE_URI
2dd10 29 20 3f 20 7a 46 69 6c 65 6e 61 6d 65 20 3a 20  ) ? zFilename : 
2dd20 30 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  0),.            
2dd30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22                 "
2dd40 70 73 6f 77 22 2c 20 53 51 4c 49 54 45 5f 50 4f  psow", SQLITE_PO
2dd50 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54  WERSAFE_OVERWRIT
2dd60 45 29 20 29 7b 0a 20 20 20 20 70 4e 65 77 2d 3e  E) ){.    pNew->
2dd70 63 74 72 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49  ctrlFlags |= UNI
2dd80 58 46 49 4c 45 5f 50 53 4f 57 3b 0a 20 20 7d 0a  XFILE_PSOW;.  }.
2dd90 20 20 69 66 28 20 73 74 72 63 6d 70 28 70 56 66    if( strcmp(pVf
2dda0 73 2d 3e 7a 4e 61 6d 65 2c 22 75 6e 69 78 2d 65  s->zName,"unix-e
2ddb0 78 63 6c 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20  xcl")==0 ){.    
2ddc0 70 4e 65 77 2d 3e 63 74 72 6c 46 6c 61 67 73 20  pNew->ctrlFlags 
2ddd0 7c 3d 20 55 4e 49 58 46 49 4c 45 5f 45 58 43 4c  |= UNIXFILE_EXCL
2dde0 3b 0a 20 20 7d 0a 0a 23 69 66 20 4f 53 5f 56 58  ;.  }..#if OS_VX
2ddf0 57 4f 52 4b 53 0a 20 20 70 4e 65 77 2d 3e 70 49  WORKS.  pNew->pI
2de00 64 20 3d 20 76 78 77 6f 72 6b 73 46 69 6e 64 46  d = vxworksFindF
2de10 69 6c 65 49 64 28 7a 46 69 6c 65 6e 61 6d 65 29  ileId(zFilename)
2de20 3b 0a 20 20 69 66 28 20 70 4e 65 77 2d 3e 70 49  ;.  if( pNew->pI
2de30 64 3d 3d 30 20 29 7b 0a 20 20 20 20 63 74 72 6c  d==0 ){.    ctrl
2de40 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c  Flags |= UNIXFIL
2de50 45 5f 4e 4f 4c 4f 43 4b 3b 0a 20 20 20 20 72 63  E_NOLOCK;.    rc
2de60 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f   = SQLITE_NOMEM_
2de70 42 4b 50 54 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  BKPT;.  }.#endif
2de80 0a 0a 20 20 69 66 28 20 63 74 72 6c 46 6c 61 67  ..  if( ctrlFlag
2de90 73 20 26 20 55 4e 49 58 46 49 4c 45 5f 4e 4f 4c  s & UNIXFILE_NOL
2dea0 4f 43 4b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b  OCK ){.    pLock
2deb0 69 6e 67 53 74 79 6c 65 20 3d 20 26 6e 6f 6c 6f  ingStyle = &nolo
2dec0 63 6b 49 6f 4d 65 74 68 6f 64 73 3b 0a 20 20 7d  ckIoMethods;.  }
2ded0 65 6c 73 65 7b 0a 20 20 20 20 70 4c 6f 63 6b 69  else{.    pLocki
2dee0 6e 67 53 74 79 6c 65 20 3d 20 28 2a 2a 28 66 69  ngStyle = (**(fi
2def0 6e 64 65 72 5f 74 79 70 65 2a 29 70 56 66 73 2d  nder_type*)pVfs-
2df00 3e 70 41 70 70 44 61 74 61 29 28 7a 46 69 6c 65  >pAppData)(zFile
2df10 6e 61 6d 65 2c 20 70 4e 65 77 29 3b 0a 23 69 66  name, pNew);.#if
2df20 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c   SQLITE_ENABLE_L
2df30 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20 20  OCKING_STYLE.   
2df40 20 2f 2a 20 43 61 63 68 65 20 7a 46 69 6c 65 6e   /* Cache zFilen
2df50 61 6d 65 20 69 6e 20 74 68 65 20 6c 6f 63 6b 69  ame in the locki
2df60 6e 67 20 63 6f 6e 74 65 78 74 20 28 41 46 50 20  ng context (AFP 
2df70 61 6e 64 20 64 6f 74 6c 6f 63 6b 20 6f 76 65 72  and dotlock over
2df80 72 69 64 65 29 20 66 6f 72 0a 20 20 20 20 2a 2a  ride) for.    **
2df90 20 70 72 6f 78 79 4c 6f 63 6b 20 61 63 74 69 76   proxyLock activ
2dfa0 61 74 69 6f 6e 20 69 73 20 70 6f 73 73 69 62 6c  ation is possibl
2dfb0 65 20 28 72 65 6d 6f 74 65 20 70 72 6f 78 79 20  e (remote proxy 
2dfc0 69 73 20 62 61 73 65 64 20 6f 6e 20 64 62 20 6e  is based on db n
2dfd0 61 6d 65 29 0a 20 20 20 20 2a 2a 20 7a 46 69 6c  ame).    ** zFil
2dfe0 65 6e 61 6d 65 20 72 65 6d 61 69 6e 73 20 76 61  ename remains va
2dff0 6c 69 64 20 75 6e 74 69 6c 20 66 69 6c 65 20 69  lid until file i
2e000 73 20 63 6c 6f 73 65 64 2c 20 74 6f 20 73 75 70  s closed, to sup
2e010 70 6f 72 74 20 2a 2f 0a 20 20 20 20 70 4e 65 77  port */.    pNew
2e020 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74  ->lockingContext
2e030 20 3d 20 28 76 6f 69 64 2a 29 7a 46 69 6c 65 6e   = (void*)zFilen
2e040 61 6d 65 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a  ame;.#endif.  }.
2e050 0a 20 20 69 66 28 20 70 4c 6f 63 6b 69 6e 67 53  .  if( pLockingS
2e060 74 79 6c 65 20 3d 3d 20 26 70 6f 73 69 78 49 6f  tyle == &posixIo
2e070 4d 65 74 68 6f 64 73 0a 23 69 66 20 64 65 66 69  Methods.#if defi
2e080 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26  ned(__APPLE__) &
2e090 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  & SQLITE_ENABLE_
2e0a0 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20 20  LOCKING_STYLE.  
2e0b0 20 20 7c 7c 20 70 4c 6f 63 6b 69 6e 67 53 74 79    || pLockingSty
2e0c0 6c 65 20 3d 3d 20 26 6e 66 73 49 6f 4d 65 74 68  le == &nfsIoMeth
2e0d0 6f 64 73 0a 23 65 6e 64 69 66 0a 20 20 29 7b 0a  ods.#endif.  ){.
2e0e0 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74      unixEnterMut
2e0f0 65 78 28 29 3b 0a 20 20 20 20 72 63 20 3d 20 66  ex();.    rc = f
2e100 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 70 4e 65  indInodeInfo(pNe
2e110 77 2c 20 26 70 4e 65 77 2d 3e 70 49 6e 6f 64 65  w, &pNew->pInode
2e120 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
2e130 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2e140 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72    /* If an error
2e150 20 6f 63 63 75 72 72 65 64 20 69 6e 20 66 69 6e   occurred in fin
2e160 64 49 6e 6f 64 65 49 6e 66 6f 28 29 2c 20 63 6c  dInodeInfo(), cl
2e170 6f 73 65 20 74 68 65 20 66 69 6c 65 20 64 65 73  ose the file des
2e180 63 72 69 70 74 6f 72 0a 20 20 20 20 20 20 2a 2a  criptor.      **
2e190 20 69 6d 6d 65 64 69 61 74 65 6c 79 2c 20 62 65   immediately, be
2e1a0 66 6f 72 65 20 72 65 6c 65 61 73 69 6e 67 20 74  fore releasing t
2e1b0 68 65 20 6d 75 74 65 78 2e 20 66 69 6e 64 49 6e  he mutex. findIn
2e1c0 6f 64 65 49 6e 66 6f 28 29 20 6d 61 79 20 66 61  odeInfo() may fa
2e1d0 69 6c 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 74  il.      ** in t
2e1e0 77 6f 20 73 63 65 6e 61 72 69 6f 73 3a 0a 20 20  wo scenarios:.  
2e1f0 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20      **.      ** 
2e200 20 20 28 61 29 20 41 20 63 61 6c 6c 20 74 6f 20    (a) A call to 
2e210 66 73 74 61 74 28 29 20 66 61 69 6c 65 64 2e 0a  fstat() failed..
2e220 20 20 20 20 20 20 2a 2a 20 20 20 28 62 29 20 41        **   (b) A
2e230 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 65 64 2e 0a   malloc failed..
2e240 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a        **.      *
2e250 2a 20 53 63 65 6e 61 72 69 6f 20 28 62 29 20 6d  * Scenario (b) m
2e260 61 79 20 6f 6e 6c 79 20 6f 63 63 75 72 20 69 66  ay only occur if
2e270 20 74 68 65 20 70 72 6f 63 65 73 73 20 69 73 20   the process is 
2e280 68 6f 6c 64 69 6e 67 20 6e 6f 20 6f 74 68 65 72  holding no other
2e290 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 64  .      ** file d
2e2a0 65 73 63 72 69 70 74 6f 72 73 20 6f 70 65 6e 20  escriptors open 
2e2b0 6f 6e 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65  on the same file
2e2c0 2e 20 49 66 20 74 68 65 72 65 20 77 65 72 65 20  . If there were 
2e2d0 6f 74 68 65 72 20 66 69 6c 65 0a 20 20 20 20 20  other file.     
2e2e0 20 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 73 20   ** descriptors 
2e2f0 6f 6e 20 74 68 69 73 20 66 69 6c 65 2c 20 74 68  on this file, th
2e300 65 6e 20 6e 6f 20 6d 61 6c 6c 6f 63 20 77 6f 75  en no malloc wou
2e310 6c 64 20 62 65 20 72 65 71 75 69 72 65 64 20 62  ld be required b
2e320 79 0a 20 20 20 20 20 20 2a 2a 20 66 69 6e 64 49  y.      ** findI
2e330 6e 6f 64 65 49 6e 66 6f 28 29 2e 20 49 66 20 74  nodeInfo(). If t
2e340 68 69 73 20 69 73 20 74 68 65 20 63 61 73 65 2c  his is the case,
2e350 20 69 74 20 69 73 20 71 75 69 74 65 20 73 61 66   it is quite saf
2e360 65 20 74 6f 20 63 6c 6f 73 65 0a 20 20 20 20 20  e to close.     
2e370 20 2a 2a 20 68 61 6e 64 6c 65 20 68 20 2d 20 61   ** handle h - a
2e380 73 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65  s it is guarante
2e390 65 64 20 74 68 61 74 20 6e 6f 20 70 6f 73 69 78  ed that no posix
2e3a0 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 62 65 20 72   locks will be r
2e3b0 65 6c 65 61 73 65 64 0a 20 20 20 20 20 20 2a 2a  eleased.      **
2e3c0 20 62 79 20 64 6f 69 6e 67 20 73 6f 2e 0a 20 20   by doing so..  
2e3d0 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20      **.      ** 
2e3e0 49 66 20 73 63 65 6e 61 72 69 6f 20 28 61 29 20  If scenario (a) 
2e3f0 63 61 75 73 65 64 20 74 68 65 20 65 72 72 6f 72  caused the error
2e400 20 74 68 65 6e 20 74 68 69 6e 67 73 20 61 72 65   then things are
2e410 20 6e 6f 74 20 73 6f 20 73 61 66 65 2e 20 54 68   not so safe. Th
2e420 65 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6c 69  e.      ** impli
2e430 63 69 74 20 61 73 73 75 6d 70 74 69 6f 6e 20 68  cit assumption h
2e440 65 72 65 20 69 73 20 74 68 61 74 20 69 66 20 66  ere is that if f
2e450 73 74 61 74 28 29 20 66 61 69 6c 73 2c 20 74 68  stat() fails, th
2e460 69 6e 67 73 20 61 72 65 20 69 6e 0a 20 20 20 20  ings are in.    
2e470 20 20 2a 2a 20 73 75 63 68 20 62 61 64 20 73 68    ** such bad sh
2e480 61 70 65 20 74 68 61 74 20 64 72 6f 70 70 69 6e  ape that droppin
2e490 67 20 61 20 6c 6f 63 6b 20 6f 72 20 74 77 6f 20  g a lock or two 
2e4a0 64 6f 65 73 6e 27 74 20 6d 61 74 74 65 72 20 6d  doesn't matter m
2e4b0 75 63 68 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  uch..      */.  
2e4c0 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65      robust_close
2e4d0 28 70 4e 65 77 2c 20 68 2c 20 5f 5f 4c 49 4e 45  (pNew, h, __LINE
2e4e0 5f 5f 29 3b 0a 20 20 20 20 20 20 68 20 3d 20 2d  __);.      h = -
2e4f0 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 69  1;.    }.    uni
2e500 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20  xLeaveMutex();. 
2e510 20 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 45   }..#if SQLITE_E
2e520 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54  NABLE_LOCKING_ST
2e530 59 4c 45 20 26 26 20 64 65 66 69 6e 65 64 28 5f  YLE && defined(_
2e540 5f 41 50 50 4c 45 5f 5f 29 0a 20 20 65 6c 73 65  _APPLE__).  else
2e550 20 69 66 28 20 70 4c 6f 63 6b 69 6e 67 53 74 79   if( pLockingSty
2e560 6c 65 20 3d 3d 20 26 61 66 70 49 6f 4d 65 74 68  le == &afpIoMeth
2e570 6f 64 73 20 29 7b 0a 20 20 20 20 2f 2a 20 41 46  ods ){.    /* AF
2e580 50 20 6c 6f 63 6b 69 6e 67 20 75 73 65 73 20 74  P locking uses t
2e590 68 65 20 66 69 6c 65 20 70 61 74 68 20 73 6f 20  he file path so 
2e5a0 69 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 69  it needs to be i
2e5b0 6e 63 6c 75 64 65 64 20 69 6e 0a 20 20 20 20 2a  ncluded in.    *
2e5c0 2a 20 74 68 65 20 61 66 70 4c 6f 63 6b 69 6e 67  * the afpLocking
2e5d0 43 6f 6e 74 65 78 74 2e 0a 20 20 20 20 2a 2f 0a  Context..    */.
2e5e0 20 20 20 20 61 66 70 4c 6f 63 6b 69 6e 67 43 6f      afpLockingCo
2e5f0 6e 74 65 78 74 20 2a 70 43 74 78 3b 0a 20 20 20  ntext *pCtx;.   
2e600 20 70 4e 65 77 2d 3e 6c 6f 63 6b 69 6e 67 43 6f   pNew->lockingCo
2e610 6e 74 65 78 74 20 3d 20 70 43 74 78 20 3d 20 73  ntext = pCtx = s
2e620 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 36 34 28  qlite3_malloc64(
2e630 20 73 69 7a 65 6f 66 28 2a 70 43 74 78 29 20 29   sizeof(*pCtx) )
2e640 3b 0a 20 20 20 20 69 66 28 20 70 43 74 78 3d 3d  ;.    if( pCtx==
2e650 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  0 ){.      rc = 
2e660 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50  SQLITE_NOMEM_BKP
2e670 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  T;.    }else{.  
2e680 20 20 20 20 2f 2a 20 4e 42 3a 20 7a 46 69 6c 65      /* NB: zFile
2e690 6e 61 6d 65 20 65 78 69 73 74 73 20 61 6e 64 20  name exists and 
2e6a0 72 65 6d 61 69 6e 73 20 76 61 6c 69 64 20 75 6e  remains valid un
2e6b0 74 69 6c 20 74 68 65 20 66 69 6c 65 20 69 73 20  til the file is 
2e6c0 63 6c 6f 73 65 64 0a 20 20 20 20 20 20 2a 2a 20  closed.      ** 
2e6d0 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 72 65 71  according to req
2e6e0 75 69 72 65 6d 65 6e 74 20 46 31 31 31 34 31 2e  uirement F11141.
2e6f0 20 20 53 6f 20 77 65 20 64 6f 20 6e 6f 74 20 6e    So we do not n
2e700 65 65 64 20 74 6f 20 6d 61 6b 65 20 61 0a 20 20  eed to make a.  
2e710 20 20 20 20 2a 2a 20 63 6f 70 79 20 6f 66 20 74      ** copy of t
2e720 68 65 20 66 69 6c 65 6e 61 6d 65 2e 20 2a 2f 0a  he filename. */.
2e730 20 20 20 20 20 20 70 43 74 78 2d 3e 64 62 50 61        pCtx->dbPa
2e740 74 68 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3b 0a  th = zFilename;.
2e750 20 20 20 20 20 20 70 43 74 78 2d 3e 72 65 73 65        pCtx->rese
2e760 72 76 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20  rved = 0;.      
2e770 73 72 61 6e 64 6f 6d 64 65 76 28 29 3b 0a 20 20  srandomdev();.  
2e780 20 20 20 20 75 6e 69 78 45 6e 74 65 72 4d 75 74      unixEnterMut
2e790 65 78 28 29 3b 0a 20 20 20 20 20 20 72 63 20 3d  ex();.      rc =
2e7a0 20 66 69 6e 64 49 6e 6f 64 65 49 6e 66 6f 28 70   findInodeInfo(p
2e7b0 4e 65 77 2c 20 26 70 4e 65 77 2d 3e 70 49 6e 6f  New, &pNew->pIno
2e7c0 64 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  de);.      if( r
2e7d0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
2e7e0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f          sqlite3_
2e7f0 66 72 65 65 28 70 4e 65 77 2d 3e 6c 6f 63 6b 69  free(pNew->locki
2e800 6e 67 43 6f 6e 74 65 78 74 29 3b 0a 20 20 20 20  ngContext);.    
2e810 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65      robust_close
2e820 28 70 4e 65 77 2c 20 68 2c 20 5f 5f 4c 49 4e 45  (pNew, h, __LINE
2e830 5f 5f 29 3b 0a 20 20 20 20 20 20 20 20 68 20 3d  __);.        h =
2e840 20 2d 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20   -1;.      }.   
2e850 20 20 20 75 6e 69 78 4c 65 61 76 65 4d 75 74 65     unixLeaveMute
2e860 78 28 29 3b 20 20 20 20 20 20 20 20 0a 20 20 20  x();        .   
2e870 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20   }.  }.#endif.. 
2e880 20 65 6c 73 65 20 69 66 28 20 70 4c 6f 63 6b 69   else if( pLocki
2e890 6e 67 53 74 79 6c 65 20 3d 3d 20 26 64 6f 74 6c  ngStyle == &dotl
2e8a0 6f 63 6b 49 6f 4d 65 74 68 6f 64 73 20 29 7b 0a  ockIoMethods ){.
2e8b0 20 20 20 20 2f 2a 20 44 6f 74 66 69 6c 65 20 6c      /* Dotfile l
2e8c0 6f 63 6b 69 6e 67 20 75 73 65 73 20 74 68 65 20  ocking uses the 
2e8d0 66 69 6c 65 20 70 61 74 68 20 73 6f 20 69 74 20  file path so it 
2e8e0 6e 65 65 64 73 20 74 6f 20 62 65 20 69 6e 63 6c  needs to be incl
2e8f0 75 64 65 64 20 69 6e 0a 20 20 20 20 2a 2a 20 74  uded in.    ** t
2e900 68 65 20 64 6f 74 6c 6f 63 6b 4c 6f 63 6b 69 6e  he dotlockLockin
2e910 67 43 6f 6e 74 65 78 74 20 0a 20 20 20 20 2a 2f  gContext .    */
2e920 0a 20 20 20 20 63 68 61 72 20 2a 7a 4c 6f 63 6b  .    char *zLock
2e930 46 69 6c 65 3b 0a 20 20 20 20 69 6e 74 20 6e 46  File;.    int nF
2e940 69 6c 65 6e 61 6d 65 3b 0a 20 20 20 20 61 73 73  ilename;.    ass
2e950 65 72 74 28 20 7a 46 69 6c 65 6e 61 6d 65 21 3d  ert( zFilename!=
2e960 30 20 29 3b 0a 20 20 20 20 6e 46 69 6c 65 6e 61  0 );.    nFilena
2e970 6d 65 20 3d 20 28 69 6e 74 29 73 74 72 6c 65 6e  me = (int)strlen
2e980 28 7a 46 69 6c 65 6e 61 6d 65 29 20 2b 20 36 3b  (zFilename) + 6;
2e990 0a 20 20 20 20 7a 4c 6f 63 6b 46 69 6c 65 20 3d  .    zLockFile =
2e9a0 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33   (char *)sqlite3
2e9b0 5f 6d 61 6c 6c 6f 63 36 34 28 6e 46 69 6c 65 6e  _malloc64(nFilen
2e9c0 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 7a 4c  ame);.    if( zL
2e9d0 6f 63 6b 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20  ockFile==0 ){.  
2e9e0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2e9f0 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20  NOMEM_BKPT;.    
2ea00 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
2ea10 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 6e 46  ite3_snprintf(nF
2ea20 69 6c 65 6e 61 6d 65 2c 20 7a 4c 6f 63 6b 46 69  ilename, zLockFi
2ea30 6c 65 2c 20 22 25 73 22 20 44 4f 54 4c 4f 43 4b  le, "%s" DOTLOCK
2ea40 5f 53 55 46 46 49 58 2c 20 7a 46 69 6c 65 6e 61  _SUFFIX, zFilena
2ea50 6d 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  me);.    }.    p
2ea60 4e 65 77 2d 3e 6c 6f 63 6b 69 6e 67 43 6f 6e 74  New->lockingCont
2ea70 65 78 74 20 3d 20 7a 4c 6f 63 6b 46 69 6c 65 3b  ext = zLockFile;
2ea80 0a 20 20 7d 0a 0a 23 69 66 20 4f 53 5f 56 58 57  .  }..#if OS_VXW
2ea90 4f 52 4b 53 0a 20 20 65 6c 73 65 20 69 66 28 20  ORKS.  else if( 
2eaa0 70 4c 6f 63 6b 69 6e 67 53 74 79 6c 65 20 3d 3d  pLockingStyle ==
2eab0 20 26 73 65 6d 49 6f 4d 65 74 68 6f 64 73 20 29   &semIoMethods )
2eac0 7b 0a 20 20 20 20 2f 2a 20 4e 61 6d 65 64 20 73  {.    /* Named s
2ead0 65 6d 61 70 68 6f 72 65 20 6c 6f 63 6b 69 6e 67  emaphore locking
2eae0 20 75 73 65 73 20 74 68 65 20 66 69 6c 65 20 70   uses the file p
2eaf0 61 74 68 20 73 6f 20 69 74 20 6e 65 65 64 73 20  ath so it needs 
2eb00 74 6f 20 62 65 0a 20 20 20 20 2a 2a 20 69 6e 63  to be.    ** inc
2eb10 6c 75 64 65 64 20 69 6e 20 74 68 65 20 73 65 6d  luded in the sem
2eb20 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74 0a 20  LockingContext. 
2eb30 20 20 20 2a 2f 0a 20 20 20 20 75 6e 69 78 45 6e     */.    unixEn
2eb40 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20  terMutex();.    
2eb50 72 63 20 3d 20 66 69 6e 64 49 6e 6f 64 65 49 6e  rc = findInodeIn
2eb60 66 6f 28 70 4e 65 77 2c 20 26 70 4e 65 77 2d 3e  fo(pNew, &pNew->
2eb70 70 49 6e 6f 64 65 29 3b 0a 20 20 20 20 69 66 28  pInode);.    if(
2eb80 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29   (rc==SQLITE_OK)
2eb90 20 26 26 20 28 70 4e 65 77 2d 3e 70 49 6e 6f 64   && (pNew->pInod
2eba0 65 2d 3e 70 53 65 6d 3d 3d 4e 55 4c 4c 29 20 29  e->pSem==NULL) )
2ebb0 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 53  {.      char *zS
2ebc0 65 6d 4e 61 6d 65 20 3d 20 70 4e 65 77 2d 3e 70  emName = pNew->p
2ebd0 49 6e 6f 64 65 2d 3e 61 53 65 6d 4e 61 6d 65 3b  Inode->aSemName;
2ebe0 0a 20 20 20 20 20 20 69 6e 74 20 6e 3b 0a 20 20  .      int n;.  
2ebf0 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 72      sqlite3_snpr
2ec00 69 6e 74 66 28 4d 41 58 5f 50 41 54 48 4e 41 4d  intf(MAX_PATHNAM
2ec10 45 2c 20 7a 53 65 6d 4e 61 6d 65 2c 20 22 2f 25  E, zSemName, "/%
2ec20 73 2e 73 65 6d 22 2c 0a 20 20 20 20 20 20 20 20  s.sem",.        
2ec30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70                 p
2ec40 4e 65 77 2d 3e 70 49 64 2d 3e 7a 43 61 6e 6f 6e  New->pId->zCanon
2ec50 69 63 61 6c 4e 61 6d 65 29 3b 0a 20 20 20 20 20  icalName);.     
2ec60 20 66 6f 72 28 20 6e 3d 31 3b 20 7a 53 65 6d 4e   for( n=1; zSemN
2ec70 61 6d 65 5b 6e 5d 3b 20 6e 2b 2b 20 29 0a 20 20  ame[n]; n++ ).  
2ec80 20 20 20 20 20 20 69 66 28 20 7a 53 65 6d 4e 61        if( zSemNa
2ec90 6d 65 5b 6e 5d 3d 3d 27 2f 27 20 29 20 7a 53 65  me[n]=='/' ) zSe
2eca0 6d 4e 61 6d 65 5b 6e 5d 20 3d 20 27 5f 27 3b 0a  mName[n] = '_';.
2ecb0 20 20 20 20 20 20 70 4e 65 77 2d 3e 70 49 6e 6f        pNew->pIno
2ecc0 64 65 2d 3e 70 53 65 6d 20 3d 20 73 65 6d 5f 6f  de->pSem = sem_o
2ecd0 70 65 6e 28 7a 53 65 6d 4e 61 6d 65 2c 20 4f 5f  pen(zSemName, O_
2ece0 43 52 45 41 54 2c 20 30 36 36 36 2c 20 31 29 3b  CREAT, 0666, 1);
2ecf0 0a 20 20 20 20 20 20 69 66 28 20 70 4e 65 77 2d  .      if( pNew-
2ed00 3e 70 49 6e 6f 64 65 2d 3e 70 53 65 6d 20 3d 3d  >pInode->pSem ==
2ed10 20 53 45 4d 5f 46 41 49 4c 45 44 20 29 7b 0a 20   SEM_FAILED ){. 
2ed20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49         rc = SQLI
2ed30 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20  TE_NOMEM_BKPT;. 
2ed40 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 70 49 6e         pNew->pIn
2ed50 6f 64 65 2d 3e 61 53 65 6d 4e 61 6d 65 5b 30 5d  ode->aSemName[0]
2ed60 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 7d   = '\0';.      }
2ed70 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 69 78 4c  .    }.    unixL
2ed80 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 7d  eaveMutex();.  }
2ed90 0a 23 65 6e 64 69 66 0a 20 20 0a 20 20 73 74 6f  .#endif.  .  sto
2eda0 72 65 4c 61 73 74 45 72 72 6e 6f 28 70 4e 65 77  reLastErrno(pNew
2edb0 2c 20 30 29 3b 0a 23 69 66 20 4f 53 5f 56 58 57  , 0);.#if OS_VXW
2edc0 4f 52 4b 53 0a 20 20 69 66 28 20 72 63 21 3d 53  ORKS.  if( rc!=S
2edd0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2ede0 69 66 28 20 68 3e 3d 30 20 29 20 72 6f 62 75 73  if( h>=0 ) robus
2edf0 74 5f 63 6c 6f 73 65 28 70 4e 65 77 2c 20 68 2c  t_close(pNew, h,
2ee00 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20   __LINE__);.    
2ee10 68 20 3d 20 2d 31 3b 0a 20 20 20 20 6f 73 55 6e  h = -1;.    osUn
2ee20 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b  link(zFilename);
2ee30 0a 20 20 20 20 70 4e 65 77 2d 3e 63 74 72 6c 46  .    pNew->ctrlF
2ee40 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45  lags |= UNIXFILE
2ee50 5f 44 45 4c 45 54 45 3b 0a 20 20 7d 0a 23 65 6e  _DELETE;.  }.#en
2ee60 64 69 66 0a 20 20 69 66 28 20 72 63 21 3d 53 51  dif.  if( rc!=SQ
2ee70 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69  LITE_OK ){.    i
2ee80 66 28 20 68 3e 3d 30 20 29 20 72 6f 62 75 73 74  f( h>=0 ) robust
2ee90 5f 63 6c 6f 73 65 28 70 4e 65 77 2c 20 68 2c 20  _close(pNew, h, 
2eea0 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20 7d 65 6c  __LINE__);.  }el
2eeb0 73 65 7b 0a 20 20 20 20 70 4e 65 77 2d 3e 70 4d  se{.    pNew->pM
2eec0 65 74 68 6f 64 20 3d 20 70 4c 6f 63 6b 69 6e 67  ethod = pLocking
2eed0 53 74 79 6c 65 3b 0a 20 20 20 20 4f 70 65 6e 43  Style;.    OpenC
2eee0 6f 75 6e 74 65 72 28 2b 31 29 3b 0a 20 20 20 20  ounter(+1);.    
2eef0 76 65 72 69 66 79 44 62 46 69 6c 65 28 70 4e 65  verifyDbFile(pNe
2ef00 77 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  w);.  }.  return
2ef10 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65   rc;.}../*.** Re
2ef20 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
2ef30 20 61 20 64 69 72 65 63 74 6f 72 79 20 69 6e 20   a directory in 
2ef40 77 68 69 63 68 20 74 6f 20 70 75 74 20 74 65 6d  which to put tem
2ef50 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a 2a 2a  porary files..**
2ef60 20 49 66 20 6e 6f 20 73 75 69 74 61 62 6c 65 20   If no suitable 
2ef70 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 64  temporary file d
2ef80 69 72 65 63 74 6f 72 79 20 63 61 6e 20 62 65 20  irectory can be 
2ef90 66 6f 75 6e 64 2c 20 72 65 74 75 72 6e 20 4e 55  found, return NU
2efa0 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f  LL..*/.static co
2efb0 6e 73 74 20 63 68 61 72 20 2a 75 6e 69 78 54 65  nst char *unixTe
2efc0 6d 70 46 69 6c 65 44 69 72 28 76 6f 69 64 29 7b  mpFileDir(void){
2efd0 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
2efe0 63 68 61 72 20 2a 61 7a 44 69 72 73 5b 5d 20 3d  char *azDirs[] =
2eff0 20 7b 0a 20 20 20 20 20 30 2c 0a 20 20 20 20 20   {.     0,.     
2f000 30 2c 0a 20 20 20 20 20 22 2f 76 61 72 2f 74 6d  0,.     "/var/tm
2f010 70 22 2c 0a 20 20 20 20 20 22 2f 75 73 72 2f 74  p",.     "/usr/t
2f020 6d 70 22 2c 0a 20 20 20 20 20 22 2f 74 6d 70 22  mp",.     "/tmp"
2f030 2c 0a 20 20 20 20 20 22 2e 22 0a 20 20 7d 3b 0a  ,.     ".".  };.
2f040 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 69    unsigned int i
2f050 20 3d 20 30 3b 0a 20 20 73 74 72 75 63 74 20 73   = 0;.  struct s
2f060 74 61 74 20 62 75 66 3b 0a 20 20 63 6f 6e 73 74  tat buf;.  const
2f070 20 63 68 61 72 20 2a 7a 44 69 72 20 3d 20 73 71   char *zDir = sq
2f080 6c 69 74 65 33 5f 74 65 6d 70 5f 64 69 72 65 63  lite3_temp_direc
2f090 74 6f 72 79 3b 0a 0a 20 20 69 66 28 20 21 61 7a  tory;..  if( !az
2f0a0 44 69 72 73 5b 30 5d 20 29 20 61 7a 44 69 72 73  Dirs[0] ) azDirs
2f0b0 5b 30 5d 20 3d 20 67 65 74 65 6e 76 28 22 53 51  [0] = getenv("SQ
2f0c0 4c 49 54 45 5f 54 4d 50 44 49 52 22 29 3b 0a 20  LITE_TMPDIR");. 
2f0d0 20 69 66 28 20 21 61 7a 44 69 72 73 5b 31 5d 20   if( !azDirs[1] 
2f0e0 29 20 61 7a 44 69 72 73 5b 31 5d 20 3d 20 67 65  ) azDirs[1] = ge
2f0f0 74 65 6e 76 28 22 54 4d 50 44 49 52 22 29 3b 0a  tenv("TMPDIR");.
2f100 20 20 77 68 69 6c 65 28 31 29 7b 0a 20 20 20 20    while(1){.    
2f110 69 66 28 20 7a 44 69 72 21 3d 30 0a 20 20 20 20  if( zDir!=0.    
2f120 20 26 26 20 6f 73 53 74 61 74 28 7a 44 69 72 2c   && osStat(zDir,
2f130 20 26 62 75 66 29 3d 3d 30 0a 20 20 20 20 20 26   &buf)==0.     &
2f140 26 20 53 5f 49 53 44 49 52 28 62 75 66 2e 73 74  & S_ISDIR(buf.st
2f150 5f 6d 6f 64 65 29 0a 20 20 20 20 20 26 26 20 6f  _mode).     && o
2f160 73 41 63 63 65 73 73 28 7a 44 69 72 2c 20 30 33  sAccess(zDir, 03
2f170 29 3d 3d 30 0a 20 20 20 20 29 7b 0a 20 20 20 20  )==0.    ){.    
2f180 20 20 72 65 74 75 72 6e 20 7a 44 69 72 3b 0a 20    return zDir;. 
2f190 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 3e 3d     }.    if( i>=
2f1a0 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f 73  sizeof(azDirs)/s
2f1b0 69 7a 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d 29  izeof(azDirs[0])
2f1c0 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 7a 44   ) break;.    zD
2f1d0 69 72 20 3d 20 61 7a 44 69 72 73 5b 69 2b 2b 5d  ir = azDirs[i++]
2f1e0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30  ;.  }.  return 0
2f1f0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
2f200 65 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69  e a temporary fi
2f210 6c 65 20 6e 61 6d 65 20 69 6e 20 7a 42 75 66 2e  le name in zBuf.
2f220 20 20 7a 42 75 66 20 6d 75 73 74 20 62 65 20 61    zBuf must be a
2f230 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 79 20 74  llocated.** by t
2f240 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65  he calling proce
2f250 73 73 20 61 6e 64 20 6d 75 73 74 20 62 65 20 62  ss and must be b
2f260 69 67 20 65 6e 6f 75 67 68 20 74 6f 20 68 6f 6c  ig enough to hol
2f270 64 20 61 74 20 6c 65 61 73 74 0a 2a 2a 20 70 56  d at least.** pV
2f280 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 20 62  fs->mxPathname b
2f290 79 74 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ytes..*/.static 
2f2a0 69 6e 74 20 75 6e 69 78 47 65 74 54 65 6d 70 6e  int unixGetTempn
2f2b0 61 6d 65 28 69 6e 74 20 6e 42 75 66 2c 20 63 68  ame(int nBuf, ch
2f2c0 61 72 20 2a 7a 42 75 66 29 7b 0a 20 20 63 6f 6e  ar *zBuf){.  con
2f2d0 73 74 20 63 68 61 72 20 2a 7a 44 69 72 3b 0a 20  st char *zDir;. 
2f2e0 20 69 6e 74 20 69 4c 69 6d 69 74 20 3d 20 30 3b   int iLimit = 0;
2f2f0 0a 0a 20 20 2f 2a 20 49 74 27 73 20 6f 64 64 20  ..  /* It's odd 
2f300 74 6f 20 73 69 6d 75 6c 61 74 65 20 61 6e 20 69  to simulate an i
2f310 6f 2d 65 72 72 6f 72 20 68 65 72 65 2c 20 62 75  o-error here, bu
2f320 74 20 72 65 61 6c 6c 79 20 74 68 69 73 20 69 73  t really this is
2f330 20 6a 75 73 74 0a 20 20 2a 2a 20 75 73 69 6e 67   just.  ** using
2f340 20 74 68 65 20 69 6f 2d 65 72 72 6f 72 20 69 6e   the io-error in
2f350 66 72 61 73 74 72 75 63 74 75 72 65 20 74 6f 20  frastructure to 
2f360 74 65 73 74 20 74 68 61 74 20 53 51 4c 69 74 65  test that SQLite
2f370 20 68 61 6e 64 6c 65 73 20 74 68 69 73 0a 20 20   handles this.  
2f380 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 66 61 69 6c  ** function fail
2f390 69 6e 67 2e 20 0a 20 20 2a 2f 0a 20 20 7a 42 75  ing. .  */.  zBu
2f3a0 66 5b 30 5d 20 3d 20 30 3b 0a 20 20 53 69 6d 75  f[0] = 0;.  Simu
2f3b0 6c 61 74 65 49 4f 45 72 72 6f 72 28 20 72 65 74  lateIOError( ret
2f3c0 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  urn SQLITE_IOERR
2f3d0 20 29 3b 0a 0a 20 20 7a 44 69 72 20 3d 20 75 6e   );..  zDir = un
2f3e0 69 78 54 65 6d 70 46 69 6c 65 44 69 72 28 29 3b  ixTempFileDir();
2f3f0 0a 20 20 69 66 28 20 7a 44 69 72 3d 3d 30 20 29  .  if( zDir==0 )
2f400 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49   return SQLITE_I
2f410 4f 45 52 52 5f 47 45 54 54 45 4d 50 50 41 54 48  OERR_GETTEMPPATH
2f420 3b 0a 20 20 64 6f 7b 0a 20 20 20 20 75 36 34 20  ;.  do{.    u64 
2f430 72 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72  r;.    sqlite3_r
2f440 61 6e 64 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66  andomness(sizeof
2f450 28 72 29 2c 20 26 72 29 3b 0a 20 20 20 20 61 73  (r), &r);.    as
2f460 73 65 72 74 28 20 6e 42 75 66 3e 32 20 29 3b 0a  sert( nBuf>2 );.
2f470 20 20 20 20 7a 42 75 66 5b 6e 42 75 66 2d 32 5d      zBuf[nBuf-2]
2f480 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65   = 0;.    sqlite
2f490 33 5f 73 6e 70 72 69 6e 74 66 28 6e 42 75 66 2c  3_snprintf(nBuf,
2f4a0 20 7a 42 75 66 2c 20 22 25 73 2f 22 53 51 4c 49   zBuf, "%s/"SQLI
2f4b0 54 45 5f 54 45 4d 50 5f 46 49 4c 45 5f 50 52 45  TE_TEMP_FILE_PRE
2f4c0 46 49 58 22 25 6c 6c 78 25 63 22 2c 0a 20 20 20  FIX"%llx%c",.   
2f4d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2f4e0 20 20 7a 44 69 72 2c 20 72 2c 20 30 29 3b 0a 20    zDir, r, 0);. 
2f4f0 20 20 20 69 66 28 20 7a 42 75 66 5b 6e 42 75 66     if( zBuf[nBuf
2f500 2d 32 5d 21 3d 30 20 7c 7c 20 28 69 4c 69 6d 69  -2]!=0 || (iLimi
2f510 74 2b 2b 29 3e 31 30 20 29 20 72 65 74 75 72 6e  t++)>10 ) return
2f520 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
2f530 20 7d 77 68 69 6c 65 28 20 6f 73 41 63 63 65 73   }while( osAcces
2f540 73 28 7a 42 75 66 2c 30 29 3d 3d 30 20 29 3b 0a  s(zBuf,0)==0 );.
2f550 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
2f560 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54  OK;.}..#if SQLIT
2f570 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47  E_ENABLE_LOCKING
2f580 5f 53 54 59 4c 45 20 26 26 20 64 65 66 69 6e 65  _STYLE && define
2f590 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 2f 2a 0a  d(__APPLE__)./*.
2f5a0 2a 2a 20 52 6f 75 74 69 6e 65 20 74 6f 20 74 72  ** Routine to tr
2f5b0 61 6e 73 66 6f 72 6d 20 61 20 75 6e 69 78 46 69  ansform a unixFi
2f5c0 6c 65 20 69 6e 74 6f 20 61 20 70 72 6f 78 79 2d  le into a proxy-
2f5d0 6c 6f 63 6b 69 6e 67 20 75 6e 69 78 46 69 6c 65  locking unixFile
2f5e0 2e 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74  ..** Implementat
2f5f0 69 6f 6e 20 69 6e 20 74 68 65 20 70 72 6f 78 79  ion in the proxy
2f600 2d 6c 6f 63 6b 20 64 69 76 69 73 69 6f 6e 2c 20  -lock division, 
2f610 62 75 74 20 75 73 65 64 20 62 79 20 75 6e 69 78  but used by unix
2f620 4f 70 65 6e 28 29 0a 2a 2a 20 69 66 20 53 51 4c  Open().** if SQL
2f630 49 54 45 5f 50 52 45 46 45 52 5f 50 52 4f 58 59  ITE_PREFER_PROXY
2f640 5f 4c 4f 43 4b 49 4e 47 20 69 73 20 64 65 66 69  _LOCKING is defi
2f650 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ned..*/.static i
2f660 6e 74 20 70 72 6f 78 79 54 72 61 6e 73 66 6f 72  nt proxyTransfor
2f670 6d 55 6e 69 78 46 69 6c 65 28 75 6e 69 78 46 69  mUnixFile(unixFi
2f680 6c 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a  le*, const char*
2f690 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  );.#endif../*.**
2f6a0 20 53 65 61 72 63 68 20 66 6f 72 20 61 6e 20 75   Search for an u
2f6b0 6e 75 73 65 64 20 66 69 6c 65 20 64 65 73 63 72  nused file descr
2f6c0 69 70 74 6f 72 20 74 68 61 74 20 77 61 73 20 6f  iptor that was o
2f6d0 70 65 6e 65 64 20 6f 6e 20 74 68 65 20 64 61 74  pened on the dat
2f6e0 61 62 61 73 65 20 0a 2a 2a 20 66 69 6c 65 20 28  abase .** file (
2f6f0 6e 6f 74 20 61 20 6a 6f 75 72 6e 61 6c 20 6f 72  not a journal or
2f700 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20   master-journal 
2f710 66 69 6c 65 29 20 69 64 65 6e 74 69 66 69 65 64  file) identified
2f720 20 62 79 20 70 61 74 68 6e 61 6d 65 0a 2a 2a 20   by pathname.** 
2f730 7a 50 61 74 68 20 77 69 74 68 20 53 51 4c 49 54  zPath with SQLIT
2f740 45 5f 4f 50 45 4e 5f 58 58 58 20 66 6c 61 67 73  E_OPEN_XXX flags
2f750 20 6d 61 74 63 68 69 6e 67 20 74 68 6f 73 65 20   matching those 
2f760 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65  passed as the se
2f770 63 6f 6e 64 0a 2a 2a 20 61 72 67 75 6d 65 6e 74  cond.** argument
2f780 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f   to this functio
2f790 6e 2e 0a 2a 2a 0a 2a 2a 20 53 75 63 68 20 61 20  n..**.** Such a 
2f7a0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
2f7b0 6d 61 79 20 65 78 69 73 74 20 69 66 20 61 20 64  may exist if a d
2f7c0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
2f7d0 6f 6e 20 77 61 73 20 63 6c 6f 73 65 64 0a 2a 2a  on was closed.**
2f7e0 20 62 75 74 20 74 68 65 20 61 73 73 6f 63 69 61   but the associa
2f7f0 74 65 64 20 66 69 6c 65 20 64 65 73 63 72 69 70  ted file descrip
2f800 74 6f 72 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65  tor could not be
2f810 20 63 6c 6f 73 65 64 20 62 65 63 61 75 73 65 20   closed because 
2f820 73 6f 6d 65 0a 2a 2a 20 6f 74 68 65 72 20 66 69  some.** other fi
2f830 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6f 70  le descriptor op
2f840 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 66  en on the same f
2f850 69 6c 65 20 69 73 20 68 6f 6c 64 69 6e 67 20 61  ile is holding a
2f860 20 66 69 6c 65 2d 6c 6f 63 6b 2e 0a 2a 2a 20 52   file-lock..** R
2f870 65 66 65 72 20 74 6f 20 63 6f 6d 6d 65 6e 74 73  efer to comments
2f880 20 69 6e 20 74 68 65 20 75 6e 69 78 43 6c 6f 73   in the unixClos
2f890 65 28 29 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64  e() function and
2f8a0 20 74 68 65 20 6c 65 6e 67 74 68 79 20 63 6f 6d   the lengthy com
2f8b0 6d 65 6e 74 0a 2a 2a 20 64 65 73 63 72 69 62 69  ment.** describi
2f8c0 6e 67 20 22 50 6f 73 69 78 20 41 64 76 69 73 6f  ng "Posix Adviso
2f8d0 72 79 20 4c 6f 63 6b 69 6e 67 22 20 61 74 20 74  ry Locking" at t
2f8e0 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 69 73  he start of this
2f8f0 20 66 69 6c 65 20 66 6f 72 20 0a 2a 2a 20 66 75   file for .** fu
2f900 72 74 68 65 72 20 64 65 74 61 69 6c 73 2e 20 41  rther details. A
2f910 6c 73 6f 2c 20 74 69 63 6b 65 74 20 23 34 30 31  lso, ticket #401
2f920 38 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 73 75  8..**.** If a su
2f930 69 74 61 62 6c 65 20 66 69 6c 65 20 64 65 73 63  itable file desc
2f940 72 69 70 74 6f 72 20 69 73 20 66 6f 75 6e 64 2c  riptor is found,
2f950 20 74 68 65 6e 20 69 74 20 69 73 20 72 65 74 75   then it is retu
2f960 72 6e 65 64 2e 20 49 66 20 6e 6f 0a 2a 2a 20 73  rned. If no.** s
2f970 75 63 68 20 66 69 6c 65 20 64 65 73 63 72 69 70  uch file descrip
2f980 74 6f 72 20 69 73 20 6c 6f 63 61 74 65 64 2c 20  tor is located, 
2f990 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  -1 is returned..
2f9a0 2a 2f 0a 73 74 61 74 69 63 20 55 6e 69 78 55 6e  */.static UnixUn
2f9b0 75 73 65 64 46 64 20 2a 66 69 6e 64 52 65 75 73  usedFd *findReus
2f9c0 61 62 6c 65 46 64 28 63 6f 6e 73 74 20 63 68 61  ableFd(const cha
2f9d0 72 20 2a 7a 50 61 74 68 2c 20 69 6e 74 20 66 6c  r *zPath, int fl
2f9e0 61 67 73 29 7b 0a 20 20 55 6e 69 78 55 6e 75 73  ags){.  UnixUnus
2f9f0 65 64 46 64 20 2a 70 55 6e 75 73 65 64 20 3d 20  edFd *pUnused = 
2fa00 30 3b 0a 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20  0;..  /* Do not 
2fa10 73 65 61 72 63 68 20 66 6f 72 20 61 6e 20 75 6e  search for an un
2fa20 75 73 65 64 20 66 69 6c 65 20 64 65 73 63 72 69  used file descri
2fa30 70 74 6f 72 20 6f 6e 20 76 78 77 6f 72 6b 73 2e  ptor on vxworks.
2fa40 20 4e 6f 74 20 62 65 63 61 75 73 65 0a 20 20 2a   Not because.  *
2fa50 2a 20 76 78 77 6f 72 6b 73 20 77 6f 75 6c 64 20  * vxworks would 
2fa60 6e 6f 74 20 62 65 6e 65 66 69 74 20 66 72 6f 6d  not benefit from
2fa70 20 74 68 65 20 63 68 61 6e 67 65 20 28 69 74 20   the change (it 
2fa80 6d 69 67 68 74 2c 20 77 65 27 72 65 20 6e 6f 74  might, we're not
2fa90 20 73 75 72 65 29 2c 0a 20 20 2a 2a 20 62 75 74   sure),.  ** but
2faa0 20 62 65 63 61 75 73 65 20 6e 6f 20 77 61 79 20   because no way 
2fab0 74 6f 20 74 65 73 74 20 69 74 20 69 73 20 63 75  to test it is cu
2fac0 72 72 65 6e 74 6c 79 20 61 76 61 69 6c 61 62 6c  rrently availabl
2fad0 65 2e 20 49 74 20 69 73 20 62 65 74 74 65 72 20  e. It is better 
2fae0 0a 20 20 2a 2a 20 6e 6f 74 20 74 6f 20 72 69 73  .  ** not to ris
2faf0 6b 20 62 72 65 61 6b 69 6e 67 20 76 78 77 6f 72  k breaking vxwor
2fb00 6b 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74  ks support for t
2fb10 68 65 20 73 61 6b 65 20 6f 66 20 73 75 63 68 20  he sake of such 
2fb20 61 6e 20 6f 62 73 63 75 72 65 20 0a 20 20 2a 2a  an obscure .  **
2fb30 20 66 65 61 74 75 72 65 2e 20 20 2a 2f 0a 23 69   feature.  */.#i
2fb40 66 20 21 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20  f !OS_VXWORKS.  
2fb50 73 74 72 75 63 74 20 73 74 61 74 20 73 53 74 61  struct stat sSta
2fb60 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
2fb70 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 73 20       /* Results 
2fb80 6f 66 20 73 74 61 74 28 29 20 63 61 6c 6c 20 2a  of stat() call *
2fb90 2f 0a 0a 20 20 75 6e 69 78 45 6e 74 65 72 4d 75  /..  unixEnterMu
2fba0 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 41 20 73  tex();..  /* A s
2fbb0 74 61 74 28 29 20 63 61 6c 6c 20 6d 61 79 20 66  tat() call may f
2fbc0 61 69 6c 20 66 6f 72 20 76 61 72 69 6f 75 73 20  ail for various 
2fbd0 72 65 61 73 6f 6e 73 2e 20 49 66 20 74 68 69 73  reasons. If this
2fbe0 20 68 61 70 70 65 6e 73 2c 20 69 74 20 69 73 0a   happens, it is.
2fbf0 20 20 2a 2a 20 61 6c 6d 6f 73 74 20 63 65 72 74    ** almost cert
2fc00 61 69 6e 20 74 68 61 74 20 61 6e 20 6f 70 65 6e  ain that an open
2fc10 28 29 20 63 61 6c 6c 20 6f 6e 20 74 68 65 20 73  () call on the s
2fc20 61 6d 65 20 70 61 74 68 20 77 69 6c 6c 20 61 6c  ame path will al
2fc30 73 6f 20 66 61 69 6c 2e 0a 20 20 2a 2a 20 46 6f  so fail..  ** Fo
2fc40 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c 20 69  r this reason, i
2fc50 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
2fc60 73 20 69 6e 20 74 68 65 20 73 74 61 74 28 29 20  s in the stat() 
2fc70 63 61 6c 6c 20 68 65 72 65 2c 20 69 74 20 69 73  call here, it is
2fc80 0a 20 20 2a 2a 20 69 67 6e 6f 72 65 64 20 61 6e  .  ** ignored an
2fc90 64 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64  d -1 is returned
2fca0 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c  . The caller wil
2fcb0 6c 20 74 72 79 20 74 6f 20 6f 70 65 6e 20 61 20  l try to open a 
2fcc0 6e 65 77 20 66 69 6c 65 0a 20 20 2a 2a 20 64 65  new file.  ** de
2fcd0 73 63 72 69 70 74 6f 72 20 6f 6e 20 74 68 65 20  scriptor on the 
2fce0 73 61 6d 65 20 70 61 74 68 2c 20 66 61 69 6c 2c  same path, fail,
2fcf0 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 65   and return an e
2fd00 72 72 6f 72 20 74 6f 20 53 51 4c 69 74 65 2e 0a  rror to SQLite..
2fd10 20 20 2a 2a 0a 20 20 2a 2a 20 45 76 65 6e 20 69    **.  ** Even i
2fd20 66 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 6f  f a subsequent o
2fd30 70 65 6e 28 29 20 63 61 6c 6c 20 64 6f 65 73 20  pen() call does 
2fd40 73 75 63 63 65 65 64 2c 20 74 68 65 20 63 6f 6e  succeed, the con
2fd50 73 65 71 75 65 6e 63 65 73 20 6f 66 0a 20 20 2a  sequences of.  *
2fd60 2a 20 6e 6f 74 20 73 65 61 72 63 68 69 6e 67 20  * not searching 
2fd70 66 6f 72 20 61 20 72 65 75 73 61 62 6c 65 20 66  for a reusable f
2fd80 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 61  ile descriptor a
2fd90 72 65 20 6e 6f 74 20 64 69 72 65 2e 20 20 2a 2f  re not dire.  */
2fda0 0a 20 20 69 66 28 20 69 6e 6f 64 65 4c 69 73 74  .  if( inodeList
2fdb0 21 3d 30 20 26 26 20 30 3d 3d 6f 73 53 74 61 74  !=0 && 0==osStat
2fdc0 28 7a 50 61 74 68 2c 20 26 73 53 74 61 74 29 20  (zPath, &sStat) 
2fdd0 29 7b 0a 20 20 20 20 75 6e 69 78 49 6e 6f 64 65  ){.    unixInode
2fde0 49 6e 66 6f 20 2a 70 49 6e 6f 64 65 3b 0a 0a 20  Info *pInode;.. 
2fdf0 20 20 20 70 49 6e 6f 64 65 20 3d 20 69 6e 6f 64     pInode = inod
2fe00 65 4c 69 73 74 3b 0a 20 20 20 20 77 68 69 6c 65  eList;.    while
2fe10 28 20 70 49 6e 6f 64 65 20 26 26 20 28 70 49 6e  ( pInode && (pIn
2fe20 6f 64 65 2d 3e 66 69 6c 65 49 64 2e 64 65 76 21  ode->fileId.dev!
2fe30 3d 73 53 74 61 74 2e 73 74 5f 64 65 76 0a 20 20  =sStat.st_dev.  
2fe40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2fe50 20 20 20 7c 7c 20 70 49 6e 6f 64 65 2d 3e 66 69     || pInode->fi
2fe60 6c 65 49 64 2e 69 6e 6f 21 3d 28 75 36 34 29 73  leId.ino!=(u64)s
2fe70 53 74 61 74 2e 73 74 5f 69 6e 6f 29 20 29 7b 0a  Stat.st_ino) ){.
2fe80 20 20 20 20 20 20 20 70 49 6e 6f 64 65 20 3d 20         pInode = 
2fe90 70 49 6e 6f 64 65 2d 3e 70 4e 65 78 74 3b 0a 20  pInode->pNext;. 
2fea0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 49 6e     }.    if( pIn
2feb0 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 55 6e 69  ode ){.      Uni
2fec0 78 55 6e 75 73 65 64 46 64 20 2a 2a 70 70 3b 0a  xUnusedFd **pp;.
2fed0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71        assert( sq
2fee0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6e 6f 74 68  lite3_mutex_noth
2fef0 65 6c 64 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63  eld(pInode->pLoc
2ff00 6b 4d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 20  kMutex) );.     
2ff10 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
2ff20 6e 74 65 72 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f  nter(pInode->pLo
2ff30 63 6b 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20  ckMutex);.      
2ff40 66 6f 72 28 70 70 3d 26 70 49 6e 6f 64 65 2d 3e  for(pp=&pInode->
2ff50 70 55 6e 75 73 65 64 3b 20 2a 70 70 20 26 26 20  pUnused; *pp && 
2ff60 28 2a 70 70 29 2d 3e 66 6c 61 67 73 21 3d 66 6c  (*pp)->flags!=fl
2ff70 61 67 73 3b 20 70 70 3d 26 28 28 2a 70 70 29 2d  ags; pp=&((*pp)-
2ff80 3e 70 4e 65 78 74 29 29 3b 0a 20 20 20 20 20 20  >pNext));.      
2ff90 70 55 6e 75 73 65 64 20 3d 20 2a 70 70 3b 0a 20  pUnused = *pp;. 
2ffa0 20 20 20 20 20 69 66 28 20 70 55 6e 75 73 65 64       if( pUnused
2ffb0 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 70 20   ){.        *pp 
2ffc0 3d 20 70 55 6e 75 73 65 64 2d 3e 70 4e 65 78 74  = pUnused->pNext
2ffd0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
2ffe0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
2fff0 61 76 65 28 70 49 6e 6f 64 65 2d 3e 70 4c 6f 63  ave(pInode->pLoc
30000 6b 4d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20  kMutex);.    }. 
30010 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d 75   }.  unixLeaveMu
30020 74 65 78 28 29 3b 0a 23 65 6e 64 69 66 20 20 20  tex();.#endif   
30030 20 2f 2a 20 69 66 20 21 4f 53 5f 56 58 57 4f 52   /* if !OS_VXWOR
30040 4b 53 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 70  KS */.  return p
30050 55 6e 75 73 65 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Unused;.}../*.**
30060 20 46 69 6e 64 20 74 68 65 20 6d 6f 64 65 2c 20   Find the mode, 
30070 75 69 64 20 61 6e 64 20 67 69 64 20 6f 66 20 66  uid and gid of f
30080 69 6c 65 20 7a 46 69 6c 65 2e 20 0a 2a 2f 0a 73  ile zFile. .*/.s
30090 74 61 74 69 63 20 69 6e 74 20 67 65 74 46 69 6c  tatic int getFil
300a0 65 4d 6f 64 65 28 0a 20 20 63 6f 6e 73 74 20 63  eMode(.  const c
300b0 68 61 72 20 2a 7a 46 69 6c 65 2c 20 20 20 20 20  har *zFile,     
300c0 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65           /* File
300d0 20 6e 61 6d 65 20 2a 2f 0a 20 20 6d 6f 64 65 5f   name */.  mode_
300e0 74 20 2a 70 4d 6f 64 65 2c 20 20 20 20 20 20 20  t *pMode,       
300f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
30100 54 3a 20 50 65 72 6d 69 73 73 69 6f 6e 73 20 6f  T: Permissions o
30110 66 20 7a 46 69 6c 65 20 2a 2f 0a 20 20 75 69 64  f zFile */.  uid
30120 5f 74 20 2a 70 55 69 64 2c 20 20 20 20 20 20 20  _t *pUid,       
30130 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
30140 4f 55 54 3a 20 75 69 64 20 6f 66 20 7a 46 69 6c  OUT: uid of zFil
30150 65 2e 20 2a 2f 0a 20 20 67 69 64 5f 74 20 2a 70  e. */.  gid_t *p
30160 47 69 64 20 20 20 20 20 20 20 20 20 20 20 20 20  Gid             
30170 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
30180 67 69 64 20 6f 66 20 7a 46 69 6c 65 2e 20 2a 2f  gid of zFile. */
30190 0a 29 7b 0a 20 20 73 74 72 75 63 74 20 73 74 61  .){.  struct sta
301a0 74 20 73 53 74 61 74 3b 20 20 20 20 20 20 20 20  t sStat;        
301b0 20 20 20 20 20 20 2f 2a 20 4f 75 74 70 75 74 20        /* Output 
301c0 6f 66 20 73 74 61 74 28 29 20 6f 6e 20 64 61 74  of stat() on dat
301d0 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20  abase file */.  
301e0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
301f0 4f 4b 3b 0a 20 20 69 66 28 20 30 3d 3d 6f 73 53  OK;.  if( 0==osS
30200 74 61 74 28 7a 46 69 6c 65 2c 20 26 73 53 74 61  tat(zFile, &sSta
30210 74 29 20 29 7b 0a 20 20 20 20 2a 70 4d 6f 64 65  t) ){.    *pMode
30220 20 3d 20 73 53 74 61 74 2e 73 74 5f 6d 6f 64 65   = sStat.st_mode
30230 20 26 20 30 37 37 37 3b 0a 20 20 20 20 2a 70 55   & 0777;.    *pU
30240 69 64 20 3d 20 73 53 74 61 74 2e 73 74 5f 75 69  id = sStat.st_ui
30250 64 3b 0a 20 20 20 20 2a 70 47 69 64 20 3d 20 73  d;.    *pGid = s
30260 53 74 61 74 2e 73 74 5f 67 69 64 3b 0a 20 20 7d  Stat.st_gid;.  }
30270 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53  else{.    rc = S
30280 51 4c 49 54 45 5f 49 4f 45 52 52 5f 46 53 54 41  QLITE_IOERR_FSTA
30290 54 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  T;.  }.  return 
302a0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  rc;.}../*.** Thi
302b0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
302c0 6c 6c 65 64 20 62 79 20 75 6e 69 78 4f 70 65 6e  lled by unixOpen
302d0 28 29 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  () to determine 
302e0 74 68 65 20 75 6e 69 78 20 70 65 72 6d 69 73 73  the unix permiss
302f0 69 6f 6e 73 0a 2a 2a 20 74 6f 20 63 72 65 61 74  ions.** to creat
30300 65 20 6e 65 77 20 66 69 6c 65 73 20 77 69 74 68  e new files with
30310 2e 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63  . If no error oc
30320 63 75 72 73 2c 20 74 68 65 6e 20 53 51 4c 49 54  curs, then SQLIT
30330 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64  E_OK is returned
30340 0a 2a 2a 20 61 6e 64 20 61 20 76 61 6c 75 65 20  .** and a value 
30350 73 75 69 74 61 62 6c 65 20 66 6f 72 20 70 61 73  suitable for pas
30360 73 69 6e 67 20 61 73 20 74 68 65 20 74 68 69 72  sing as the thir
30370 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 6f 70  d argument to op
30380 65 6e 28 32 29 20 69 73 0a 2a 2a 20 77 72 69 74  en(2) is.** writ
30390 74 65 6e 20 74 6f 20 2a 70 4d 6f 64 65 2e 20 49  ten to *pMode. I
303a0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63  f an IO error oc
303b0 63 75 72 73 2c 20 61 6e 20 53 51 4c 69 74 65 20  curs, an SQLite 
303c0 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 0a 2a  error code is .*
303d0 2a 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74  * returned and t
303e0 68 65 20 76 61 6c 75 65 20 6f 66 20 2a 70 4d 6f  he value of *pMo
303f0 64 65 20 69 73 20 6e 6f 74 20 6d 6f 64 69 66 69  de is not modifi
30400 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 6d 6f 73  ed..**.** In mos
30410 74 20 63 61 73 65 73 2c 20 74 68 69 73 20 72 6f  t cases, this ro
30420 75 74 69 6e 65 20 73 65 74 73 20 2a 70 4d 6f 64  utine sets *pMod
30430 65 20 74 6f 20 30 2c 20 77 68 69 63 68 20 77 69  e to 0, which wi
30440 6c 6c 20 62 65 63 6f 6d 65 0a 2a 2a 20 61 6e 20  ll become.** an 
30450 69 6e 64 69 63 61 74 69 6f 6e 20 74 6f 20 72 6f  indication to ro
30460 62 75 73 74 5f 6f 70 65 6e 28 29 20 74 6f 20 63  bust_open() to c
30470 72 65 61 74 65 20 74 68 65 20 66 69 6c 65 20 75  reate the file u
30480 73 69 6e 67 0a 2a 2a 20 53 51 4c 49 54 45 5f 44  sing.** SQLITE_D
30490 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d  EFAULT_FILE_PERM
304a0 49 53 53 49 4f 4e 53 20 61 64 6a 75 73 74 65 64  ISSIONS adjusted
304b0 20 62 79 20 74 68 65 20 75 6d 61 73 6b 2e 0a 2a   by the umask..*
304c0 2a 20 42 75 74 20 69 66 20 74 68 65 20 66 69 6c  * But if the fil
304d0 65 20 62 65 69 6e 67 20 6f 70 65 6e 65 64 20 69  e being opened i
304e0 73 20 61 20 57 41 4c 20 6f 72 20 72 65 67 75 6c  s a WAL or regul
304f0 61 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c  ar journal file,
30500 20 74 68 65 6e 20 0a 2a 2a 20 74 68 69 73 20 66   then .** this f
30510 75 6e 63 74 69 6f 6e 20 71 75 65 72 69 65 73 20  unction queries 
30520 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20  the file-system 
30530 66 6f 72 20 74 68 65 20 70 65 72 6d 69 73 73 69  for the permissi
30540 6f 6e 73 20 6f 6e 20 74 68 65 20 0a 2a 2a 20 63  ons on the .** c
30550 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 64 61 74  orresponding dat
30560 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 73  abase file and s
30570 65 74 73 20 2a 70 4d 6f 64 65 20 74 6f 20 74 68  ets *pMode to th
30580 69 73 20 76 61 6c 75 65 2e 20 57 68 65 6e 65 76  is value. Whenev
30590 65 72 20 0a 2a 2a 20 70 6f 73 73 69 62 6c 65 2c  er .** possible,
305a0 20 57 41 4c 20 61 6e 64 20 6a 6f 75 72 6e 61 6c   WAL and journal
305b0 20 66 69 6c 65 73 20 61 72 65 20 63 72 65 61 74   files are creat
305c0 65 64 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d  ed using the sam
305d0 65 20 70 65 72 6d 69 73 73 69 6f 6e 73 20 0a 2a  e permissions .*
305e0 2a 20 61 73 20 74 68 65 20 61 73 73 6f 63 69 61  * as the associa
305f0 74 65 64 20 64 61 74 61 62 61 73 65 20 66 69 6c  ted database fil
30600 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  e..**.** If the 
30610 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 38 5f  SQLITE_ENABLE_8_
30620 33 5f 4e 41 4d 45 53 20 6f 70 74 69 6f 6e 20 69  3_NAMES option i
30630 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 20  s enabled, then 
30640 74 68 65 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c 20  the.** original 
30650 66 69 6c 65 6e 61 6d 65 20 69 73 20 75 6e 61 76  filename is unav
30660 61 69 6c 61 62 6c 65 2e 20 20 42 75 74 20 38 5f  ailable.  But 8_
30670 33 5f 4e 41 4d 45 53 20 69 73 20 6f 6e 6c 79 20  3_NAMES is only 
30680 75 73 65 64 20 66 6f 72 0a 2a 2a 20 46 41 54 20  used for.** FAT 
30690 66 69 6c 65 73 79 73 74 65 6d 73 20 61 6e 64 20  filesystems and 
306a0 70 65 72 6d 69 73 73 69 6f 6e 73 20 64 6f 20 6e  permissions do n
306b0 6f 74 20 6d 61 74 74 65 72 20 74 68 65 72 65 2c  ot matter there,
306c0 20 73 6f 20 6a 75 73 74 20 75 73 65 0a 2a 2a 20   so just use.** 
306d0 74 68 65 20 64 65 66 61 75 6c 74 20 70 65 72 6d  the default perm
306e0 69 73 73 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 61 74  issions..*/.stat
306f0 69 63 20 69 6e 74 20 66 69 6e 64 43 72 65 61 74  ic int findCreat
30700 65 46 69 6c 65 4d 6f 64 65 28 0a 20 20 63 6f 6e  eFileMode(.  con
30710 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20  st char *zPath, 
30720 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
30730 50 61 74 68 20 6f 66 20 66 69 6c 65 20 28 70 6f  Path of file (po
30740 73 73 69 62 6c 79 29 20 62 65 69 6e 67 20 63 72  ssibly) being cr
30750 65 61 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 66  eated */.  int f
30760 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20  lags,           
30770 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c             /* Fl
30780 61 67 73 20 70 61 73 73 65 64 20 61 73 20 34 74  ags passed as 4t
30790 68 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 4f  h argument to xO
307a0 70 65 6e 28 29 20 2a 2f 0a 20 20 6d 6f 64 65 5f  pen() */.  mode_
307b0 74 20 2a 70 4d 6f 64 65 2c 20 20 20 20 20 20 20  t *pMode,       
307c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
307d0 54 3a 20 50 65 72 6d 69 73 73 69 6f 6e 73 20 74  T: Permissions t
307e0 6f 20 6f 70 65 6e 20 66 69 6c 65 20 77 69 74 68  o open file with
307f0 20 2a 2f 0a 20 20 75 69 64 5f 74 20 2a 70 55 69   */.  uid_t *pUi
30800 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d,              
30810 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 75 69        /* OUT: ui
30820 64 20 74 6f 20 73 65 74 20 6f 6e 20 74 68 65 20  d to set on the 
30830 66 69 6c 65 20 2a 2f 0a 20 20 67 69 64 5f 74 20  file */.  gid_t 
30840 2a 70 47 69 64 20 20 20 20 20 20 20 20 20 20 20  *pGid           
30850 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54            /* OUT
30860 3a 20 67 69 64 20 74 6f 20 73 65 74 20 6f 6e 20  : gid to set on 
30870 74 68 65 20 66 69 6c 65 20 2a 2f 0a 29 7b 0a 20  the file */.){. 
30880 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
30890 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20  _OK;            
308a0 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 20   /* Return Code 
308b0 2a 2f 0a 20 20 2a 70 4d 6f 64 65 20 3d 20 30 3b  */.  *pMode = 0;
308c0 0a 20 20 2a 70 55 69 64 20 3d 20 30 3b 0a 20 20  .  *pUid = 0;.  
308d0 2a 70 47 69 64 20 3d 20 30 3b 0a 20 20 69 66 28  *pGid = 0;.  if(
308e0 20 66 6c 61 67 73 20 26 20 28 53 51 4c 49 54 45   flags & (SQLITE
308f0 5f 4f 50 45 4e 5f 57 41 4c 7c 53 51 4c 49 54 45  _OPEN_WAL|SQLITE
30900 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e  _OPEN_MAIN_JOURN
30910 41 4c 29 20 29 7b 0a 20 20 20 20 63 68 61 72 20  AL) ){.    char 
30920 7a 44 62 5b 4d 41 58 5f 50 41 54 48 4e 41 4d 45  zDb[MAX_PATHNAME
30930 2b 31 5d 3b 20 20 20 20 20 2f 2a 20 44 61 74 61  +1];     /* Data
30940 62 61 73 65 20 66 69 6c 65 20 70 61 74 68 20 2a  base file path *
30950 2f 0a 20 20 20 20 69 6e 74 20 6e 44 62 3b 20 20  /.    int nDb;  
30960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
30970 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
30980 20 76 61 6c 69 64 20 62 79 74 65 73 20 69 6e 20   valid bytes in 
30990 7a 44 62 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 7a  zDb */..    /* z
309a0 50 61 74 68 20 69 73 20 61 20 70 61 74 68 20 74  Path is a path t
309b0 6f 20 61 20 57 41 4c 20 6f 72 20 6a 6f 75 72 6e  o a WAL or journ
309c0 61 6c 20 66 69 6c 65 2e 20 54 68 65 20 66 6f 6c  al file. The fol
309d0 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 64 65 72  lowing block der
309e0 69 76 65 73 0a 20 20 20 20 2a 2a 20 74 68 65 20  ives.    ** the 
309f0 70 61 74 68 20 74 6f 20 74 68 65 20 61 73 73 6f  path to the asso
30a00 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20  ciated database 
30a10 66 69 6c 65 20 66 72 6f 6d 20 7a 50 61 74 68 2e  file from zPath.
30a20 20 54 68 69 73 20 62 6c 6f 63 6b 20 68 61 6e 64   This block hand
30a30 6c 65 73 0a 20 20 20 20 2a 2a 20 74 68 65 20 66  les.    ** the f
30a40 6f 6c 6c 6f 77 69 6e 67 20 6e 61 6d 69 6e 67 20  ollowing naming 
30a50 63 6f 6e 76 65 6e 74 69 6f 6e 73 3a 0a 20 20 20  conventions:.   
30a60 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 22 3c 70   **.    **   "<p
30a70 61 74 68 20 74 6f 20 64 62 3e 2d 6a 6f 75 72 6e  ath to db>-journ
30a80 61 6c 22 0a 20 20 20 20 2a 2a 20 20 20 22 3c 70  al".    **   "<p
30a90 61 74 68 20 74 6f 20 64 62 3e 2d 77 61 6c 22 0a  ath to db>-wal".
30aa0 20 20 20 20 2a 2a 20 20 20 22 3c 70 61 74 68 20      **   "<path 
30ab0 74 6f 20 64 62 3e 2d 6a 6f 75 72 6e 61 6c 4e 4e  to db>-journalNN
30ac0 22 0a 20 20 20 20 2a 2a 20 20 20 22 3c 70 61 74  ".    **   "<pat
30ad0 68 20 74 6f 20 64 62 3e 2d 77 61 6c 4e 4e 22 0a  h to db>-walNN".
30ae0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 77 68      **.    ** wh
30af0 65 72 65 20 4e 4e 20 69 73 20 61 20 64 65 63 69  ere NN is a deci
30b00 6d 61 6c 20 6e 75 6d 62 65 72 2e 20 54 68 65 20  mal number. The 
30b10 4e 4e 20 6e 61 6d 69 6e 67 20 73 63 68 65 6d 65  NN naming scheme
30b20 73 20 61 72 65 20 0a 20 20 20 20 2a 2a 20 75 73  s are .    ** us
30b30 65 64 20 62 79 20 74 68 65 20 74 65 73 74 5f 6d  ed by the test_m
30b40 75 6c 74 69 70 6c 65 78 2e 63 20 6d 6f 64 75 6c  ultiplex.c modul
30b50 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 6e 44  e..    */.    nD
30b60 62 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65  b = sqlite3Strle
30b70 6e 33 30 28 7a 50 61 74 68 29 20 2d 20 31 3b 20  n30(zPath) - 1; 
30b80 0a 20 20 20 20 77 68 69 6c 65 28 20 7a 50 61 74  .    while( zPat
30b90 68 5b 6e 44 62 5d 21 3d 27 2d 27 20 29 7b 0a 20  h[nDb]!='-' ){. 
30ba0 20 20 20 20 20 2f 2a 20 49 6e 20 6e 6f 72 6d 61       /* In norma
30bb0 6c 20 6f 70 65 72 61 74 69 6f 6e 2c 20 74 68 65  l operation, the
30bc0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61   journal file na
30bd0 6d 65 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 63  me will always c
30be0 6f 6e 74 61 69 6e 0a 20 20 20 20 20 20 2a 2a 20  ontain.      ** 
30bf0 61 20 27 2d 27 20 63 68 61 72 61 63 74 65 72 2e  a '-' character.
30c00 20 20 48 6f 77 65 76 65 72 20 69 6e 20 38 2b 33    However in 8+3
30c10 20 66 69 6c 65 6e 61 6d 65 20 6d 6f 64 65 2c 20   filename mode, 
30c20 6f 72 20 69 66 20 61 20 63 6f 72 72 75 70 74 0a  or if a corrupt.
30c30 20 20 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63        ** rollbac
30c40 6b 20 6a 6f 75 72 6e 61 6c 20 73 70 65 63 69 66  k journal specif
30c50 69 65 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  ies a master jou
30c60 72 6e 61 6c 20 77 69 74 68 20 61 20 67 6f 6f 66  rnal with a goof
30c70 79 20 6e 61 6d 65 2c 20 74 68 65 6e 0a 20 20 20  y name, then.   
30c80 20 20 20 2a 2a 20 74 68 65 20 27 2d 27 20 6d 69     ** the '-' mi
30c90 67 68 74 20 62 65 20 6d 69 73 73 69 6e 67 2e 20  ght be missing. 
30ca0 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6e 44 62  */.      if( nDb
30cb0 3d 3d 30 20 7c 7c 20 7a 50 61 74 68 5b 6e 44 62  ==0 || zPath[nDb
30cc0 5d 3d 3d 27 2e 27 20 29 20 72 65 74 75 72 6e 20  ]=='.' ) return 
30cd0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20  SQLITE_OK;.     
30ce0 20 6e 44 62 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20   nDb--;.    }.  
30cf0 20 20 6d 65 6d 63 70 79 28 7a 44 62 2c 20 7a 50    memcpy(zDb, zP
30d00 61 74 68 2c 20 6e 44 62 29 3b 0a 20 20 20 20 7a  ath, nDb);.    z
30d10 44 62 5b 6e 44 62 5d 20 3d 20 27 5c 30 27 3b 0a  Db[nDb] = '\0';.
30d20 0a 20 20 20 20 72 63 20 3d 20 67 65 74 46 69 6c  .    rc = getFil
30d30 65 4d 6f 64 65 28 7a 44 62 2c 20 70 4d 6f 64 65  eMode(zDb, pMode
30d40 2c 20 70 55 69 64 2c 20 70 47 69 64 29 3b 0a 20  , pUid, pGid);. 
30d50 20 7d 65 6c 73 65 20 69 66 28 20 66 6c 61 67 73   }else if( flags
30d60 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44   & SQLITE_OPEN_D
30d70 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 20 29 7b 0a  ELETEONCLOSE ){.
30d80 20 20 20 20 2a 70 4d 6f 64 65 20 3d 20 30 36 30      *pMode = 060
30d90 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 66  0;.  }else if( f
30da0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50  lags & SQLITE_OP
30db0 45 4e 5f 55 52 49 20 29 7b 0a 20 20 20 20 2f 2a  EN_URI ){.    /*
30dc0 20 49 66 20 74 68 69 73 20 69 73 20 61 20 6d 61   If this is a ma
30dd0 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  in database file
30de0 20 61 6e 64 20 74 68 65 20 66 69 6c 65 20 77 61   and the file wa
30df0 73 20 6f 70 65 6e 65 64 20 75 73 69 6e 67 20 61  s opened using a
30e00 20 55 52 49 0a 20 20 20 20 2a 2a 20 66 69 6c 65   URI.    ** file
30e10 6e 61 6d 65 2c 20 63 68 65 63 6b 20 66 6f 72 20  name, check for 
30e20 74 68 65 20 22 6d 6f 64 65 6f 66 22 20 70 61 72  the "modeof" par
30e30 61 6d 65 74 65 72 2e 20 49 66 20 70 72 65 73 65  ameter. If prese
30e40 6e 74 2c 20 69 6e 74 65 72 70 72 65 74 0a 20 20  nt, interpret.  
30e50 20 20 2a 2a 20 69 74 73 20 76 61 6c 75 65 20 61    ** its value a
30e60 73 20 61 20 66 69 6c 65 6e 61 6d 65 20 61 6e 64  s a filename and
30e70 20 74 72 79 20 74 6f 20 63 6f 70 79 20 74 68 65   try to copy the
30e80 20 6d 6f 64 65 2c 20 75 69 64 20 61 6e 64 20 67   mode, uid and g
30e90 69 64 20 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 74  id from.    ** t
30ea0 68 61 74 20 66 69 6c 65 2e 20 20 2a 2f 0a 20 20  hat file.  */.  
30eb0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20    const char *z 
30ec0 3d 20 73 71 6c 69 74 65 33 5f 75 72 69 5f 70 61  = sqlite3_uri_pa
30ed0 72 61 6d 65 74 65 72 28 7a 50 61 74 68 2c 20 22  rameter(zPath, "
30ee0 6d 6f 64 65 6f 66 22 29 3b 0a 20 20 20 20 69 66  modeof");.    if
30ef0 28 20 7a 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ( z ){.      rc 
30f00 3d 20 67 65 74 46 69 6c 65 4d 6f 64 65 28 7a 2c  = getFileMode(z,
30f10 20 70 4d 6f 64 65 2c 20 70 55 69 64 2c 20 70 47   pMode, pUid, pG
30f20 69 64 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  id);.    }.  }. 
30f30 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
30f40 2a 0a 2a 2a 20 4f 70 65 6e 20 74 68 65 20 66 69  *.** Open the fi
30f50 6c 65 20 7a 50 61 74 68 2e 0a 2a 2a 20 0a 2a 2a  le zPath..** .**
30f60 20 50 72 65 76 69 6f 75 73 6c 79 2c 20 74 68 65   Previously, the
30f70 20 53 51 4c 69 74 65 20 4f 53 20 6c 61 79 65 72   SQLite OS layer
30f80 20 75 73 65 64 20 74 68 72 65 65 20 66 75 6e 63   used three func
30f90 74 69 6f 6e 73 20 69 6e 20 70 6c 61 63 65 20 6f  tions in place o
30fa0 66 20 74 68 69 73 0a 2a 2a 20 6f 6e 65 3a 0a 2a  f this.** one:.*
30fb0 2a 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33  *.**     sqlite3
30fc0 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65 28  OsOpenReadWrite(
30fd0 29 3b 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  );.**     sqlite
30fe0 33 4f 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 28  3OsOpenReadOnly(
30ff0 29 3b 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  );.**     sqlite
31000 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65  3OsOpenExclusive
31010 28 29 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20  ();.**.** These 
31020 63 61 6c 6c 73 20 63 6f 72 72 65 73 70 6f 6e 64  calls correspond
31030 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   to the followin
31040 67 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 6f  g combinations o
31050 66 20 66 6c 61 67 73 3a 0a 2a 2a 0a 2a 2a 20 20  f flags:.**.**  
31060 20 20 20 52 65 61 64 57 72 69 74 65 28 29 20 2d     ReadWrite() -
31070 3e 20 20 20 20 20 28 52 45 41 44 57 52 49 54 45  >     (READWRITE
31080 20 7c 20 43 52 45 41 54 45 29 0a 2a 2a 20 20 20   | CREATE).**   
31090 20 20 52 65 61 64 4f 6e 6c 79 28 29 20 20 2d 3e    ReadOnly()  ->
310a0 20 20 20 20 20 28 52 45 41 44 4f 4e 4c 59 29 20       (READONLY) 
310b0 0a 2a 2a 20 20 20 20 20 4f 70 65 6e 45 78 63 6c  .**     OpenExcl
310c0 75 73 69 76 65 28 29 20 2d 3e 20 28 52 45 41 44  usive() -> (READ
310d0 57 52 49 54 45 20 7c 20 43 52 45 41 54 45 20 7c  WRITE | CREATE |
310e0 20 45 58 43 4c 55 53 49 56 45 29 0a 2a 2a 0a 2a   EXCLUSIVE).**.*
310f0 2a 20 54 68 65 20 6f 6c 64 20 4f 70 65 6e 45 78  * The old OpenEx
31100 63 6c 75 73 69 76 65 28 29 20 61 63 63 65 70 74  clusive() accept
31110 65 64 20 61 20 62 6f 6f 6c 65 61 6e 20 61 72 67  ed a boolean arg
31120 75 6d 65 6e 74 20 2d 20 22 64 65 6c 46 6c 61 67  ument - "delFlag
31130 22 2e 20 49 66 0a 2a 2a 20 74 72 75 65 2c 20 74  ". If.** true, t
31140 68 65 20 66 69 6c 65 20 77 61 73 20 63 6f 6e 66  he file was conf
31150 69 67 75 72 65 64 20 74 6f 20 62 65 20 61 75 74  igured to be aut
31160 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74  omatically delet
31170 65 64 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 66  ed when the.** f
31180 69 6c 65 20 68 61 6e 64 6c 65 20 63 6c 6f 73 65  ile handle close
31190 64 2e 20 54 6f 20 61 63 68 69 65 76 65 20 74 68  d. To achieve th
311a0 65 20 73 61 6d 65 20 65 66 66 65 63 74 20 75 73  e same effect us
311b0 69 6e 67 20 74 68 69 73 20 6e 65 77 20 0a 2a 2a  ing this new .**
311c0 20 69 6e 74 65 72 66 61 63 65 2c 20 61 64 64 20   interface, add 
311d0 74 68 65 20 44 45 4c 45 54 45 4f 4e 43 4c 4f 53  the DELETEONCLOS
311e0 45 20 66 6c 61 67 20 74 6f 20 74 68 6f 73 65 20  E flag to those 
311f0 73 70 65 63 69 66 69 65 64 20 61 62 6f 76 65 20  specified above 
31200 66 6f 72 20 0a 2a 2a 20 4f 70 65 6e 45 78 63 6c  for .** OpenExcl
31210 75 73 69 76 65 28 29 2e 0a 2a 2f 0a 73 74 61 74  usive()..*/.stat
31220 69 63 20 69 6e 74 20 75 6e 69 78 4f 70 65 6e 28  ic int unixOpen(
31230 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  .  sqlite3_vfs *
31240 70 56 66 73 2c 20 20 20 20 20 20 20 20 20 20 20  pVfs,           
31250 2f 2a 20 54 68 65 20 56 46 53 20 66 6f 72 20 77  /* The VFS for w
31260 68 69 63 68 20 74 68 69 73 20 69 73 20 74 68 65  hich this is the
31270 20 78 4f 70 65 6e 20 6d 65 74 68 6f 64 20 2a 2f   xOpen method */
31280 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
31290 50 61 74 68 2c 20 20 20 20 20 20 20 20 20 20 20  Path,           
312a0 2f 2a 20 50 61 74 68 6e 61 6d 65 20 6f 66 20 66  /* Pathname of f
312b0 69 6c 65 20 74 6f 20 62 65 20 6f 70 65 6e 65 64  ile to be opened
312c0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69   */.  sqlite3_fi
312d0 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20 20 20 20  le *pFile,      
312e0 20 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 64     /* The file d
312f0 65 73 63 72 69 70 74 6f 72 20 74 6f 20 62 65 20  escriptor to be 
31300 66 69 6c 6c 65 64 20 69 6e 20 2a 2f 0a 20 20 69  filled in */.  i
31310 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20  nt flags,       
31320 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
31330 6e 70 75 74 20 66 6c 61 67 73 20 74 6f 20 63 6f  nput flags to co
31340 6e 74 72 6f 6c 20 74 68 65 20 6f 70 65 6e 69 6e  ntrol the openin
31350 67 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4f 75 74  g */.  int *pOut
31360 46 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20  Flags           
31370 20 20 20 20 2f 2a 20 4f 75 74 70 75 74 20 66 6c      /* Output fl
31380 61 67 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20  ags returned to 
31390 53 51 4c 69 74 65 20 63 6f 72 65 20 2a 2f 0a 29  SQLite core */.)
313a0 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 20  {.  unixFile *p 
313b0 3d 20 28 75 6e 69 78 46 69 6c 65 20 2a 29 70 46  = (unixFile *)pF
313c0 69 6c 65 3b 0a 20 20 69 6e 74 20 66 64 20 3d 20  ile;.  int fd = 
313d0 2d 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  -1;             
313e0 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65        /* File de
313f0 73 63 72 69 70 74 6f 72 20 72 65 74 75 72 6e 65  scriptor returne
31400 64 20 62 79 20 6f 70 65 6e 28 29 20 2a 2f 0a 20  d by open() */. 
31410 20 69 6e 74 20 6f 70 65 6e 46 6c 61 67 73 20 3d   int openFlags =
31420 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   0;             
31430 2f 2a 20 46 6c 61 67 73 20 74 6f 20 70 61 73 73  /* Flags to pass
31440 20 74 6f 20 6f 70 65 6e 28 29 20 2a 2f 0a 20 20   to open() */.  
31450 69 6e 74 20 65 54 79 70 65 20 3d 20 66 6c 61 67  int eType = flag
31460 73 26 30 78 46 46 46 46 46 46 30 30 3b 20 20 2f  s&0xFFFFFF00;  /
31470 2a 20 54 79 70 65 20 6f 66 20 66 69 6c 65 20 74  * Type of file t
31480 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20  o open */.  int 
31490 6e 6f 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20  noLock;         
314a0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
314b0 75 65 20 74 6f 20 6f 6d 69 74 20 6c 6f 63 6b 69  ue to omit locki
314c0 6e 67 20 70 72 69 6d 69 74 69 76 65 73 20 2a 2f  ng primitives */
314d0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
314e0 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20  TE_OK;          
314f0 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 52 65    /* Function Re
31500 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20 20 69  turn Code */.  i
31510 6e 74 20 63 74 72 6c 46 6c 61 67 73 20 3d 20 30  nt ctrlFlags = 0
31520 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
31530 20 55 4e 49 58 46 49 4c 45 5f 2a 20 66 6c 61 67   UNIXFILE_* flag
31540 73 20 2a 2f 0a 0a 20 20 69 6e 74 20 69 73 45 78  s */..  int isEx
31550 63 6c 75 73 69 76 65 20 20 3d 20 28 66 6c 61 67  clusive  = (flag
31560 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  s & SQLITE_OPEN_
31570 45 58 43 4c 55 53 49 56 45 29 3b 0a 20 20 69 6e  EXCLUSIVE);.  in
31580 74 20 69 73 44 65 6c 65 74 65 20 20 20 20 20 3d  t isDelete     =
31590 20 28 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45   (flags & SQLITE
315a0 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c  _OPEN_DELETEONCL
315b0 4f 53 45 29 3b 0a 20 20 69 6e 74 20 69 73 43 72  OSE);.  int isCr
315c0 65 61 74 65 20 20 20 20 20 3d 20 28 66 6c 61 67  eate     = (flag
315d0 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  s & SQLITE_OPEN_
315e0 43 52 45 41 54 45 29 3b 0a 20 20 69 6e 74 20 69  CREATE);.  int i
315f0 73 52 65 61 64 6f 6e 6c 79 20 20 20 3d 20 28 66  sReadonly   = (f
31600 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50  lags & SQLITE_OP
31610 45 4e 5f 52 45 41 44 4f 4e 4c 59 29 3b 0a 20 20  EN_READONLY);.  
31620 69 6e 74 20 69 73 52 65 61 64 57 72 69 74 65 20  int isReadWrite 
31630 20 3d 20 28 66 6c 61 67 73 20 26 20 53 51 4c 49   = (flags & SQLI
31640 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54  TE_OPEN_READWRIT
31650 45 29 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 45  E);.#if SQLITE_E
31660 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54  NABLE_LOCKING_ST
31670 59 4c 45 0a 20 20 69 6e 74 20 69 73 41 75 74 6f  YLE.  int isAuto
31680 50 72 6f 78 79 20 20 3d 20 28 66 6c 61 67 73 20  Proxy  = (flags 
31690 26 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 41 55  & SQLITE_OPEN_AU
316a0 54 4f 50 52 4f 58 59 29 3b 0a 23 65 6e 64 69 66  TOPROXY);.#endif
316b0 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 41  .#if defined(__A
316c0 50 50 4c 45 5f 5f 29 20 7c 7c 20 53 51 4c 49 54  PPLE__) || SQLIT
316d0 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47  E_ENABLE_LOCKING
316e0 5f 53 54 59 4c 45 0a 20 20 73 74 72 75 63 74 20  _STYLE.  struct 
316f0 73 74 61 74 66 73 20 66 73 49 6e 66 6f 3b 0a 23  statfs fsInfo;.#
31700 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 49 66 20 63  endif..  /* If c
31710 72 65 61 74 69 6e 67 20 61 20 6d 61 73 74 65 72  reating a master
31720 20 6f 72 20 6d 61 69 6e 2d 66 69 6c 65 20 6a 6f   or main-file jo
31730 75 72 6e 61 6c 2c 20 74 68 69 73 20 66 75 6e 63  urnal, this func
31740 74 69 6f 6e 20 77 69 6c 6c 20 6f 70 65 6e 0a 20  tion will open. 
31750 20 2a 2a 20 61 20 66 69 6c 65 2d 64 65 73 63 72   ** a file-descr
31760 69 70 74 6f 72 20 6f 6e 20 74 68 65 20 64 69 72  iptor on the dir
31770 65 63 74 6f 72 79 20 74 6f 6f 2e 20 54 68 65 20  ectory too. The 
31780 66 69 72 73 74 20 74 69 6d 65 20 75 6e 69 78 53  first time unixS
31790 79 6e 63 28 29 0a 20 20 2a 2a 20 69 73 20 63 61  ync().  ** is ca
317a0 6c 6c 65 64 20 74 68 65 20 64 69 72 65 63 74 6f  lled the directo
317b0 72 79 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  ry file descript
317c0 6f 72 20 77 69 6c 6c 20 62 65 20 66 73 79 6e 63  or will be fsync
317d0 28 29 65 64 20 61 6e 64 20 63 6c 6f 73 65 28 29  ()ed and close()
317e0 64 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74 20 69 73  d..  */.  int is
317f0 4e 65 77 4a 72 6e 6c 20 3d 20 28 69 73 43 72 65  NewJrnl = (isCre
31800 61 74 65 20 26 26 20 28 0a 20 20 20 20 20 20 20  ate && (.       
31810 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f   eType==SQLITE_O
31820 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e  PEN_MASTER_JOURN
31830 41 4c 20 0a 20 20 20 20 20 7c 7c 20 65 54 79 70  AL .     || eTyp
31840 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d  e==SQLITE_OPEN_M
31850 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20 0a 20 20 20  AIN_JOURNAL .   
31860 20 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49    || eType==SQLI
31870 54 45 5f 4f 50 45 4e 5f 57 41 4c 0a 20 20 29 29  TE_OPEN_WAL.  ))
31880 3b 0a 0a 20 20 2f 2a 20 49 66 20 61 72 67 75 6d  ;..  /* If argum
31890 65 6e 74 20 7a 50 61 74 68 20 69 73 20 61 20 4e  ent zPath is a N
318a0 55 4c 4c 20 70 6f 69 6e 74 65 72 2c 20 74 68 69  ULL pointer, thi
318b0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 72 65  s function is re
318c0 71 75 69 72 65 64 20 74 6f 20 6f 70 65 6e 0a 20  quired to open. 
318d0 20 2a 2a 20 61 20 74 65 6d 70 6f 72 61 72 79 20   ** a temporary 
318e0 66 69 6c 65 2e 20 55 73 65 20 74 68 69 73 20 62  file. Use this b
318f0 75 66 66 65 72 20 74 6f 20 73 74 6f 72 65 20 74  uffer to store t
31900 68 65 20 66 69 6c 65 20 6e 61 6d 65 20 69 6e 2e  he file name in.
31910 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 7a 54 6d  .  */.  char zTm
31920 70 6e 61 6d 65 5b 4d 41 58 5f 50 41 54 48 4e 41  pname[MAX_PATHNA
31930 4d 45 2b 32 5d 3b 0a 20 20 63 6f 6e 73 74 20 63  ME+2];.  const c
31940 68 61 72 20 2a 7a 4e 61 6d 65 20 3d 20 7a 50 61  har *zName = zPa
31950 74 68 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20  th;..  /* Check 
31960 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  the following st
31970 61 74 65 6d 65 6e 74 73 20 61 72 65 20 74 72 75  atements are tru
31980 65 3a 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20  e: .  **.  **   
31990 28 61 29 20 45 78 61 63 74 6c 79 20 6f 6e 65 20  (a) Exactly one 
319a0 6f 66 20 74 68 65 20 52 45 41 44 57 52 49 54 45  of the READWRITE
319b0 20 61 6e 64 20 52 45 41 44 4f 4e 4c 59 20 66 6c   and READONLY fl
319c0 61 67 73 20 6d 75 73 74 20 62 65 20 73 65 74 2c  ags must be set,
319d0 20 61 6e 64 20 0a 20 20 2a 2a 20 20 20 28 62 29   and .  **   (b)
319e0 20 69 66 20 43 52 45 41 54 45 20 69 73 20 73 65   if CREATE is se
319f0 74 2c 20 74 68 65 6e 20 52 45 41 44 57 52 49 54  t, then READWRIT
31a00 45 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 20 73  E must also be s
31a10 65 74 2c 20 61 6e 64 0a 20 20 2a 2a 20 20 20 28  et, and.  **   (
31a20 63 29 20 69 66 20 45 58 43 4c 55 53 49 56 45 20  c) if EXCLUSIVE 
31a30 69 73 20 73 65 74 2c 20 74 68 65 6e 20 43 52 45  is set, then CRE
31a40 41 54 45 20 6d 75 73 74 20 61 6c 73 6f 20 62 65  ATE must also be
31a50 20 73 65 74 2e 0a 20 20 2a 2a 20 20 20 28 64 29   set..  **   (d)
31a60 20 69 66 20 44 45 4c 45 54 45 4f 4e 43 4c 4f 53   if DELETEONCLOS
31a70 45 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 43  E is set, then C
31a80 52 45 41 54 45 20 6d 75 73 74 20 61 6c 73 6f 20  REATE must also 
31a90 62 65 20 73 65 74 2e 0a 20 20 2a 2f 0a 20 20 61  be set..  */.  a
31aa0 73 73 65 72 74 28 28 69 73 52 65 61 64 6f 6e 6c  ssert((isReadonl
31ab0 79 3d 3d 30 20 7c 7c 20 69 73 52 65 61 64 57 72  y==0 || isReadWr
31ac0 69 74 65 3d 3d 30 29 20 26 26 20 28 69 73 52 65  ite==0) && (isRe
31ad0 61 64 57 72 69 74 65 20 7c 7c 20 69 73 52 65 61  adWrite || isRea
31ae0 64 6f 6e 6c 79 29 29 3b 0a 20 20 61 73 73 65 72  donly));.  asser
31af0 74 28 69 73 43 72 65 61 74 65 3d 3d 30 20 7c 7c  t(isCreate==0 ||
31b00 20 69 73 52 65 61 64 57 72 69 74 65 29 3b 0a 20   isReadWrite);. 
31b10 20 61 73 73 65 72 74 28 69 73 45 78 63 6c 75 73   assert(isExclus
31b20 69 76 65 3d 3d 30 20 7c 7c 20 69 73 43 72 65 61  ive==0 || isCrea
31b30 74 65 29 3b 0a 20 20 61 73 73 65 72 74 28 69 73  te);.  assert(is
31b40 44 65 6c 65 74 65 3d 3d 30 20 7c 7c 20 69 73 43  Delete==0 || isC
31b50 72 65 61 74 65 29 3b 0a 0a 20 20 2f 2a 20 54 68  reate);..  /* Th
31b60 65 20 6d 61 69 6e 20 44 42 2c 20 6d 61 69 6e 20  e main DB, main 
31b70 6a 6f 75 72 6e 61 6c 2c 20 57 41 4c 20 66 69 6c  journal, WAL fil
31b80 65 20 61 6e 64 20 6d 61 73 74 65 72 20 6a 6f 75  e and master jou
31b90 72 6e 61 6c 20 61 72 65 20 6e 65 76 65 72 20 0a  rnal are never .
31ba0 20 20 2a 2a 20 61 75 74 6f 6d 61 74 69 63 61 6c    ** automatical
31bb0 6c 79 20 64 65 6c 65 74 65 64 2e 20 4e 6f 72 20  ly deleted. Nor 
31bc0 61 72 65 20 74 68 65 79 20 65 76 65 72 20 74 65  are they ever te
31bd0 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 20 20  mporary files.  
31be0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 21 69  */.  assert( (!i
31bf0 73 44 65 6c 65 74 65 20 26 26 20 7a 4e 61 6d 65  sDelete && zName
31c00 29 20 7c 7c 20 65 54 79 70 65 21 3d 53 51 4c 49  ) || eType!=SQLI
31c10 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20  TE_OPEN_MAIN_DB 
31c20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 21 69  );.  assert( (!i
31c30 73 44 65 6c 65 74 65 20 26 26 20 7a 4e 61 6d 65  sDelete && zName
31c40 29 20 7c 7c 20 65 54 79 70 65 21 3d 53 51 4c 49  ) || eType!=SQLI
31c50 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55  TE_OPEN_MAIN_JOU
31c60 52 4e 41 4c 20 29 3b 0a 20 20 61 73 73 65 72 74  RNAL );.  assert
31c70 28 20 28 21 69 73 44 65 6c 65 74 65 20 26 26 20  ( (!isDelete && 
31c80 7a 4e 61 6d 65 29 20 7c 7c 20 65 54 79 70 65 21  zName) || eType!
31c90 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53  =SQLITE_OPEN_MAS
31ca0 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 29 3b 0a 20  TER_JOURNAL );. 
31cb0 20 61 73 73 65 72 74 28 20 28 21 69 73 44 65 6c   assert( (!isDel
31cc0 65 74 65 20 26 26 20 7a 4e 61 6d 65 29 20 7c 7c  ete && zName) ||
31cd0 20 65 54 79 70 65 21 3d 53 51 4c 49 54 45 5f 4f   eType!=SQLITE_O
31ce0 50 45 4e 5f 57 41 4c 20 29 3b 0a 0a 20 20 2f 2a  PEN_WAL );..  /*
31cf0 20 41 73 73 65 72 74 20 74 68 61 74 20 74 68 65   Assert that the
31d00 20 75 70 70 65 72 20 6c 61 79 65 72 20 68 61 73   upper layer has
31d10 20 73 65 74 20 6f 6e 65 20 6f 66 20 74 68 65 20   set one of the 
31d20 22 66 69 6c 65 2d 74 79 70 65 22 20 66 6c 61 67  "file-type" flag
31d30 73 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  s. */.  assert( 
31d40 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50  eType==SQLITE_OP
31d50 45 4e 5f 4d 41 49 4e 5f 44 42 20 20 20 20 20 20  EN_MAIN_DB      
31d60 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45  || eType==SQLITE
31d70 5f 4f 50 45 4e 5f 54 45 4d 50 5f 44 42 20 0a 20  _OPEN_TEMP_DB . 
31d80 20 20 20 20 20 20 7c 7c 20 65 54 79 70 65 3d 3d        || eType==
31d90 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e  SQLITE_OPEN_MAIN
31da0 5f 4a 4f 55 52 4e 41 4c 20 7c 7c 20 65 54 79 70  _JOURNAL || eTyp
31db0 65 3d 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54  e==SQLITE_OPEN_T
31dc0 45 4d 50 5f 4a 4f 55 52 4e 41 4c 20 0a 20 20 20  EMP_JOURNAL .   
31dd0 20 20 20 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51      || eType==SQ
31de0 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55  LITE_OPEN_SUBJOU
31df0 52 4e 41 4c 20 20 20 7c 7c 20 65 54 79 70 65 3d  RNAL   || eType=
31e00 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 53  =SQLITE_OPEN_MAS
31e10 54 45 52 5f 4a 4f 55 52 4e 41 4c 20 0a 20 20 20  TER_JOURNAL .   
31e20 20 20 20 20 7c 7c 20 65 54 79 70 65 3d 3d 53 51      || eType==SQ
31e30 4c 49 54 45 5f 4f 50 45 4e 5f 54 52 41 4e 53 49  LITE_OPEN_TRANSI
31e40 45 4e 54 5f 44 42 20 7c 7c 20 65 54 79 70 65 3d  ENT_DB || eType=
31e50 3d 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 57 41 4c  =SQLITE_OPEN_WAL
31e60 0a 20 20 29 3b 0a 0a 20 20 2f 2a 20 44 65 74 65  .  );..  /* Dete
31e70 63 74 20 61 20 70 69 64 20 63 68 61 6e 67 65 20  ct a pid change 
31e80 61 6e 64 20 72 65 73 65 74 20 74 68 65 20 50 52  and reset the PR
31e90 4e 47 2e 20 20 54 68 65 72 65 20 69 73 20 61 20  NG.  There is a 
31ea0 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 0a 20  race condition. 
31eb0 20 2a 2a 20 68 65 72 65 20 73 75 63 68 20 74 68   ** here such th
31ec0 61 74 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 74  at two or more t
31ed0 68 72 65 61 64 73 20 61 6c 6c 20 74 72 79 69 6e  hreads all tryin
31ee0 67 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62 61  g to open databa
31ef0 73 65 73 20 61 74 0a 20 20 2a 2a 20 74 68 65 20  ses at.  ** the 
31f00 73 61 6d 65 20 69 6e 73 74 61 6e 74 20 6d 69 67  same instant mig
31f10 68 74 20 61 6c 6c 20 72 65 73 65 74 20 74 68 65  ht all reset the
31f20 20 50 52 4e 47 2e 20 20 42 75 74 20 6d 75 6c 74   PRNG.  But mult
31f30 69 70 6c 65 20 72 65 73 65 74 73 0a 20 20 2a 2a  iple resets.  **
31f40 20 61 72 65 20 68 61 72 6d 6c 65 73 73 2e 0a 20   are harmless.. 
31f50 20 2a 2f 0a 20 20 69 66 28 20 72 61 6e 64 6f 6d   */.  if( random
31f60 6e 65 73 73 50 69 64 21 3d 6f 73 47 65 74 70 69  nessPid!=osGetpi
31f70 64 28 30 29 20 29 7b 0a 20 20 20 20 72 61 6e 64  d(0) ){.    rand
31f80 6f 6d 6e 65 73 73 50 69 64 20 3d 20 6f 73 47 65  omnessPid = osGe
31f90 74 70 69 64 28 30 29 3b 0a 20 20 20 20 73 71 6c  tpid(0);.    sql
31fa0 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28  ite3_randomness(
31fb0 30 2c 30 29 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73  0,0);.  }.  mems
31fc0 65 74 28 70 2c 20 30 2c 20 73 69 7a 65 6f 66 28  et(p, 0, sizeof(
31fd0 75 6e 69 78 46 69 6c 65 29 29 3b 0a 0a 20 20 69  unixFile));..  i
31fe0 66 28 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45  f( eType==SQLITE
31ff0 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 20 29 7b  _OPEN_MAIN_DB ){
32000 0a 20 20 20 20 55 6e 69 78 55 6e 75 73 65 64 46  .    UnixUnusedF
32010 64 20 2a 70 55 6e 75 73 65 64 3b 0a 20 20 20 20  d *pUnused;.    
32020 70 55 6e 75 73 65 64 20 3d 20 66 69 6e 64 52 65  pUnused = findRe
32030 75 73 61 62 6c 65 46 64 28 7a 4e 61 6d 65 2c 20  usableFd(zName, 
32040 66 6c 61 67 73 29 3b 0a 20 20 20 20 69 66 28 20  flags);.    if( 
32050 70 55 6e 75 73 65 64 20 29 7b 0a 20 20 20 20 20  pUnused ){.     
32060 20 66 64 20 3d 20 70 55 6e 75 73 65 64 2d 3e 66   fd = pUnused->f
32070 64 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  d;.    }else{.  
32080 20 20 20 20 70 55 6e 75 73 65 64 20 3d 20 73 71      pUnused = sq
32090 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 36 34 28 73  lite3_malloc64(s
320a0 69 7a 65 6f 66 28 2a 70 55 6e 75 73 65 64 29 29  izeof(*pUnused))
320b0 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 55 6e  ;.      if( !pUn
320c0 75 73 65 64 20 29 7b 0a 20 20 20 20 20 20 20 20  used ){.        
320d0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
320e0 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20  MEM_BKPT;.      
320f0 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 70  }.    }.    p->p
32100 50 72 65 61 6c 6c 6f 63 61 74 65 64 55 6e 75 73  PreallocatedUnus
32110 65 64 20 3d 20 70 55 6e 75 73 65 64 3b 0a 0a 20  ed = pUnused;.. 
32120 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 66     /* Database f
32130 69 6c 65 6e 61 6d 65 73 20 61 72 65 20 64 6f 75  ilenames are dou
32140 62 6c 65 2d 7a 65 72 6f 20 74 65 72 6d 69 6e 61  ble-zero termina
32150 74 65 64 20 69 66 20 74 68 65 79 20 61 72 65 20  ted if they are 
32160 6e 6f 74 0a 20 20 20 20 2a 2a 20 55 52 49 73 20  not.    ** URIs 
32170 77 69 74 68 20 70 61 72 61 6d 65 74 65 72 73 2e  with parameters.
32180 20 20 48 65 6e 63 65 2c 20 74 68 65 79 20 63 61    Hence, they ca
32190 6e 20 61 6c 77 61 79 73 20 62 65 20 70 61 73 73  n always be pass
321a0 65 64 20 69 6e 74 6f 0a 20 20 20 20 2a 2a 20 73  ed into.    ** s
321b0 71 6c 69 74 65 33 5f 75 72 69 5f 70 61 72 61 6d  qlite3_uri_param
321c0 65 74 65 72 28 29 2e 20 2a 2f 0a 20 20 20 20 61  eter(). */.    a
321d0 73 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20  ssert( (flags & 
321e0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29  SQLITE_OPEN_URI)
321f0 20 7c 7c 20 7a 4e 61 6d 65 5b 73 74 72 6c 65 6e   || zName[strlen
32200 28 7a 4e 61 6d 65 29 2b 31 5d 3d 3d 30 20 29 3b  (zName)+1]==0 );
32210 0a 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 7a  ..  }else if( !z
32220 4e 61 6d 65 20 29 7b 0a 20 20 20 20 2f 2a 20 49  Name ){.    /* I
32230 66 20 7a 4e 61 6d 65 20 69 73 20 4e 55 4c 4c 2c  f zName is NULL,
32240 20 74 68 65 20 75 70 70 65 72 20 6c 61 79 65 72   the upper layer
32250 20 69 73 20 72 65 71 75 65 73 74 69 6e 67 20 61   is requesting a
32260 20 74 65 6d 70 20 66 69 6c 65 2e 20 2a 2f 0a 20   temp file. */. 
32270 20 20 20 61 73 73 65 72 74 28 69 73 44 65 6c 65     assert(isDele
32280 74 65 20 26 26 20 21 69 73 4e 65 77 4a 72 6e 6c  te && !isNewJrnl
32290 29 3b 0a 20 20 20 20 72 63 20 3d 20 75 6e 69 78  );.    rc = unix
322a0 47 65 74 54 65 6d 70 6e 61 6d 65 28 70 56 66 73  GetTempname(pVfs
322b0 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2c 20 7a 54  ->mxPathname, zT
322c0 6d 70 6e 61 6d 65 29 3b 0a 20 20 20 20 69 66 28  mpname);.    if(
322d0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
322e0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  {.      return r
322f0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 4e 61  c;.    }.    zNa
32300 6d 65 20 3d 20 7a 54 6d 70 6e 61 6d 65 3b 0a 0a  me = zTmpname;..
32310 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 64      /* Generated
32320 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 6e   temporary filen
32330 61 6d 65 73 20 61 72 65 20 61 6c 77 61 79 73 20  ames are always 
32340 64 6f 75 62 6c 65 2d 7a 65 72 6f 20 74 65 72 6d  double-zero term
32350 69 6e 61 74 65 64 0a 20 20 20 20 2a 2a 20 66 6f  inated.    ** fo
32360 72 20 75 73 65 20 62 79 20 73 71 6c 69 74 65 33  r use by sqlite3
32370 5f 75 72 69 5f 70 61 72 61 6d 65 74 65 72 28 29  _uri_parameter()
32380 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28  . */.    assert(
32390 20 7a 4e 61 6d 65 5b 73 74 72 6c 65 6e 28 7a 4e   zName[strlen(zN
323a0 61 6d 65 29 2b 31 5d 3d 3d 30 20 29 3b 0a 20 20  ame)+1]==0 );.  
323b0 7d 0a 0a 20 20 2f 2a 20 44 65 74 65 72 6d 69 6e  }..  /* Determin
323c0 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  e the value of t
323d0 68 65 20 66 6c 61 67 73 20 70 61 72 61 6d 65 74  he flags paramet
323e0 65 72 20 70 61 73 73 65 64 20 74 6f 20 50 4f 53  er passed to POS
323f0 49 58 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a 2a  IX function.  **
32400 20 6f 70 65 6e 28 29 2e 20 54 68 65 73 65 20 6d   open(). These m
32410 75 73 74 20 62 65 20 63 61 6c 63 75 6c 61 74 65  ust be calculate
32420 64 20 65 76 65 6e 20 69 66 20 6f 70 65 6e 28 29  d even if open()
32430 20 69 73 20 6e 6f 74 20 63 61 6c 6c 65 64 2c 20   is not called, 
32440 61 73 0a 20 20 2a 2a 20 74 68 65 79 20 6d 61 79  as.  ** they may
32450 20 62 65 20 73 74 6f 72 65 64 20 61 73 20 70 61   be stored as pa
32460 72 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 68  rt of the file h
32470 61 6e 64 6c 65 20 61 6e 64 20 75 73 65 64 20 62  andle and used b
32480 79 20 74 68 65 20 0a 20 20 2a 2a 20 27 63 6f 6e  y the .  ** 'con
32490 63 68 20 66 69 6c 65 27 20 6c 6f 63 6b 69 6e 67  ch file' locking
324a0 20 66 75 6e 63 74 69 6f 6e 73 20 6c 61 74 65 72   functions later
324b0 20 6f 6e 2e 20 20 2a 2f 0a 20 20 69 66 28 20 69   on.  */.  if( i
324c0 73 52 65 61 64 6f 6e 6c 79 20 29 20 20 6f 70 65  sReadonly )  ope
324d0 6e 46 6c 61 67 73 20 7c 3d 20 4f 5f 52 44 4f 4e  nFlags |= O_RDON
324e0 4c 59 3b 0a 20 20 69 66 28 20 69 73 52 65 61 64  LY;.  if( isRead
324f0 57 72 69 74 65 20 29 20 6f 70 65 6e 46 6c 61 67  Write ) openFlag
32500 73 20 7c 3d 20 4f 5f 52 44 57 52 3b 0a 20 20 69  s |= O_RDWR;.  i
32510 66 28 20 69 73 43 72 65 61 74 65 20 29 20 20 20  f( isCreate )   
32520 20 6f 70 65 6e 46 6c 61 67 73 20 7c 3d 20 4f 5f   openFlags |= O_
32530 43 52 45 41 54 3b 0a 20 20 69 66 28 20 69 73 45  CREAT;.  if( isE
32540 78 63 6c 75 73 69 76 65 20 29 20 6f 70 65 6e 46  xclusive ) openF
32550 6c 61 67 73 20 7c 3d 20 28 4f 5f 45 58 43 4c 7c  lags |= (O_EXCL|
32560 4f 5f 4e 4f 46 4f 4c 4c 4f 57 29 3b 0a 20 20 6f  O_NOFOLLOW);.  o
32570 70 65 6e 46 6c 61 67 73 20 7c 3d 20 28 4f 5f 4c  penFlags |= (O_L
32580 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52  ARGEFILE|O_BINAR
32590 59 29 3b 0a 0a 20 20 69 66 28 20 66 64 3c 30 20  Y);..  if( fd<0 
325a0 29 7b 0a 20 20 20 20 6d 6f 64 65 5f 74 20 6f 70  ){.    mode_t op
325b0 65 6e 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20  enMode;         
325c0 20 20 20 20 20 2f 2a 20 50 65 72 6d 69 73 73 69       /* Permissi
325d0 6f 6e 73 20 74 6f 20 63 72 65 61 74 65 20 66 69  ons to create fi
325e0 6c 65 20 77 69 74 68 20 2a 2f 0a 20 20 20 20 75  le with */.    u
325f0 69 64 5f 74 20 75 69 64 3b 20 20 20 20 20 20 20  id_t uid;       
32600 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
32610 55 73 65 72 69 64 20 66 6f 72 20 74 68 65 20 66  Userid for the f
32620 69 6c 65 20 2a 2f 0a 20 20 20 20 67 69 64 5f 74  ile */.    gid_t
32630 20 67 69 64 3b 20 20 20 20 20 20 20 20 20 20 20   gid;           
32640 20 20 20 20 20 20 20 20 20 2f 2a 20 47 72 6f 75           /* Grou
32650 70 69 64 20 66 6f 72 20 74 68 65 20 66 69 6c 65  pid for the file
32660 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 66 69 6e   */.    rc = fin
32670 64 43 72 65 61 74 65 46 69 6c 65 4d 6f 64 65 28  dCreateFileMode(
32680 7a 4e 61 6d 65 2c 20 66 6c 61 67 73 2c 20 26 6f  zName, flags, &o
32690 70 65 6e 4d 6f 64 65 2c 20 26 75 69 64 2c 20 26  penMode, &uid, &
326a0 67 69 64 29 3b 0a 20 20 20 20 69 66 28 20 72 63  gid);.    if( rc
326b0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
326c0 20 20 20 20 20 61 73 73 65 72 74 28 20 21 70 2d       assert( !p-
326d0 3e 70 50 72 65 61 6c 6c 6f 63 61 74 65 64 55 6e  >pPreallocatedUn
326e0 75 73 65 64 20 29 3b 0a 20 20 20 20 20 20 61 73  used );.      as
326f0 73 65 72 74 28 20 65 54 79 70 65 3d 3d 53 51 4c  sert( eType==SQL
32700 49 54 45 5f 4f 50 45 4e 5f 57 41 4c 20 7c 7c 20  ITE_OPEN_WAL || 
32710 65 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 4f 50  eType==SQLITE_OP
32720 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 20  EN_MAIN_JOURNAL 
32730 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
32740 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 64  rc;.    }.    fd
32750 20 3d 20 72 6f 62 75 73 74 5f 6f 70 65 6e 28 7a   = robust_open(z
32760 4e 61 6d 65 2c 20 6f 70 65 6e 46 6c 61 67 73 2c  Name, openFlags,
32770 20 6f 70 65 6e 4d 6f 64 65 29 3b 0a 20 20 20 20   openMode);.    
32780 4f 53 54 52 41 43 45 28 28 22 4f 50 45 4e 58 20  OSTRACE(("OPENX 
32790 20 20 25 2d 33 64 20 25 73 20 30 25 6f 5c 6e 22    %-3d %s 0%o\n"
327a0 2c 20 66 64 2c 20 7a 4e 61 6d 65 2c 20 6f 70 65  , fd, zName, ope
327b0 6e 46 6c 61 67 73 29 29 3b 0a 20 20 20 20 61 73  nFlags));.    as
327c0 73 65 72 74 28 20 21 69 73 45 78 63 6c 75 73 69  sert( !isExclusi
327d0 76 65 20 7c 7c 20 28 6f 70 65 6e 46 6c 61 67 73  ve || (openFlags
327e0 20 26 20 4f 5f 43 52 45 41 54 29 21 3d 30 20 29   & O_CREAT)!=0 )
327f0 3b 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 29  ;.    if( fd<0 )
32800 7b 0a 20 20 20 20 20 20 69 66 28 20 69 73 4e 65  {.      if( isNe
32810 77 4a 72 6e 6c 20 26 26 20 65 72 72 6e 6f 3d 3d  wJrnl && errno==
32820 45 41 43 43 45 53 20 26 26 20 6f 73 41 63 63 65  EACCES && osAcce
32830 73 73 28 7a 4e 61 6d 65 2c 20 46 5f 4f 4b 29 20  ss(zName, F_OK) 
32840 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66  ){.        /* If
32850 20 75 6e 61 62 6c 65 20 74 6f 20 63 72 65 61 74   unable to creat
32860 65 20 61 20 6a 6f 75 72 6e 61 6c 20 62 65 63 61  e a journal beca
32870 75 73 65 20 74 68 65 20 64 69 72 65 63 74 6f 72  use the director
32880 79 20 69 73 20 6e 6f 74 0a 20 20 20 20 20 20 20  y is not.       
32890 20 2a 2a 20 77 72 69 74 61 62 6c 65 2c 20 63 68   ** writable, ch
328a0 61 6e 67 65 20 74 68 65 20 65 72 72 6f 72 20 63  ange the error c
328b0 6f 64 65 20 74 6f 20 69 6e 64 69 63 61 74 65 20  ode to indicate 
328c0 74 68 61 74 2e 20 2a 2f 0a 20 20 20 20 20 20 20  that. */.       
328d0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41   rc = SQLITE_REA
328e0 44 4f 4e 4c 59 5f 44 49 52 45 43 54 4f 52 59 3b  DONLY_DIRECTORY;
328f0 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28  .      }else if(
32900 20 65 72 72 6e 6f 21 3d 45 49 53 44 49 52 20 26   errno!=EISDIR &
32910 26 20 69 73 52 65 61 64 57 72 69 74 65 20 29 7b  & isReadWrite ){
32920 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 61 69 6c  .        /* Fail
32930 65 64 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 66  ed to open the f
32940 69 6c 65 20 66 6f 72 20 72 65 61 64 2f 77 72 69  ile for read/wri
32950 74 65 20 61 63 63 65 73 73 2e 20 54 72 79 20 72  te access. Try r
32960 65 61 64 2d 6f 6e 6c 79 2e 20 2a 2f 0a 20 20 20  ead-only. */.   
32970 20 20 20 20 20 66 6c 61 67 73 20 26 3d 20 7e 28       flags &= ~(
32980 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44  SQLITE_OPEN_READ
32990 57 52 49 54 45 7c 53 51 4c 49 54 45 5f 4f 50 45  WRITE|SQLITE_OPE
329a0 4e 5f 43 52 45 41 54 45 29 3b 0a 20 20 20 20 20  N_CREATE);.     
329b0 20 20 20 6f 70 65 6e 46 6c 61 67 73 20 26 3d 20     openFlags &= 
329c0 7e 28 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54  ~(O_RDWR|O_CREAT
329d0 29 3b 0a 20 20 20 20 20 20 20 20 66 6c 61 67 73  );.        flags
329e0 20 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f   |= SQLITE_OPEN_
329f0 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 20  READONLY;.      
32a00 20 20 6f 70 65 6e 46 6c 61 67 73 20 7c 3d 20 4f    openFlags |= O
32a10 5f 52 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 20 20  _RDONLY;.       
32a20 20 69 73 52 65 61 64 6f 6e 6c 79 20 3d 20 31 3b   isReadonly = 1;
32a30 0a 20 20 20 20 20 20 20 20 66 64 20 3d 20 72 6f  .        fd = ro
32a40 62 75 73 74 5f 6f 70 65 6e 28 7a 4e 61 6d 65 2c  bust_open(zName,
32a50 20 6f 70 65 6e 46 6c 61 67 73 2c 20 6f 70 65 6e   openFlags, open
32a60 4d 6f 64 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20  Mode);.      }. 
32a70 20 20 20 7d 0a 20 20 20 20 69 66 28 20 66 64 3c     }.    if( fd<
32a80 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 72  0 ){.      int r
32a90 63 32 20 3d 20 75 6e 69 78 4c 6f 67 45 72 72 6f  c2 = unixLogErro
32aa0 72 28 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45  r(SQLITE_CANTOPE
32ab0 4e 5f 42 4b 50 54 2c 20 22 6f 70 65 6e 22 2c 20  N_BKPT, "open", 
32ac0 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 66  zName);.      if
32ad0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
32ae0 29 20 72 63 20 3d 20 72 63 32 3b 0a 20 20 20 20  ) rc = rc2;.    
32af0 20 20 67 6f 74 6f 20 6f 70 65 6e 5f 66 69 6e 69    goto open_fini
32b00 73 68 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  shed;.    }..   
32b10 20 2f 2a 20 49 66 20 74 68 69 73 20 70 72 6f 63   /* If this proc
32b20 65 73 73 20 69 73 20 72 75 6e 6e 69 6e 67 20 61  ess is running a
32b30 73 20 72 6f 6f 74 20 61 6e 64 20 69 66 20 63 72  s root and if cr
32b40 65 61 74 69 6e 67 20 61 20 6e 65 77 20 72 6f 6c  eating a new rol
32b50 6c 62 61 63 6b 0a 20 20 20 20 2a 2a 20 6a 6f 75  lback.    ** jou
32b60 72 6e 61 6c 20 6f 72 20 57 41 4c 20 66 69 6c 65  rnal or WAL file
32b70 2c 20 73 65 74 20 74 68 65 20 6f 77 6e 65 72 73  , set the owners
32b80 68 69 70 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  hip of the journ
32b90 61 6c 20 6f 72 20 57 41 4c 20 74 6f 20 62 65 0a  al or WAL to be.
32ba0 20 20 20 20 2a 2a 20 74 68 65 20 73 61 6d 65 20      ** the same 
32bb0 61 73 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20  as the original 
32bc0 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 2a 2f  database..    */
32bd0 0a 20 20 20 20 69 66 28 20 66 6c 61 67 73 20 26  .    if( flags &
32be0 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 57 41   (SQLITE_OPEN_WA
32bf0 4c 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41  L|SQLITE_OPEN_MA
32c00 49 4e 5f 4a 4f 55 52 4e 41 4c 29 20 29 7b 0a 20  IN_JOURNAL) ){. 
32c10 20 20 20 20 20 72 6f 62 75 73 74 46 63 68 6f 77       robustFchow
32c20 6e 28 66 64 2c 20 75 69 64 2c 20 67 69 64 29 3b  n(fd, uid, gid);
32c30 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73  .    }.  }.  ass
32c40 65 72 74 28 20 66 64 3e 3d 30 20 29 3b 0a 20 20  ert( fd>=0 );.  
32c50 69 66 28 20 70 4f 75 74 46 6c 61 67 73 20 29 7b  if( pOutFlags ){
32c60 0a 20 20 20 20 2a 70 4f 75 74 46 6c 61 67 73 20  .    *pOutFlags 
32c70 3d 20 66 6c 61 67 73 3b 0a 20 20 7d 0a 0a 20 20  = flags;.  }..  
32c80 69 66 28 20 70 2d 3e 70 50 72 65 61 6c 6c 6f 63  if( p->pPrealloc
32c90 61 74 65 64 55 6e 75 73 65 64 20 29 7b 0a 20 20  atedUnused ){.  
32ca0 20 20 70 2d 3e 70 50 72 65 61 6c 6c 6f 63 61 74    p->pPreallocat
32cb0 65 64 55 6e 75 73 65 64 2d 3e 66 64 20 3d 20 66  edUnused->fd = f
32cc0 64 3b 0a 20 20 20 20 70 2d 3e 70 50 72 65 61 6c  d;.    p->pPreal
32cd0 6c 6f 63 61 74 65 64 55 6e 75 73 65 64 2d 3e 66  locatedUnused->f
32ce0 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a 20 20  lags = flags;.  
32cf0 7d 0a 0a 20 20 69 66 28 20 69 73 44 65 6c 65 74  }..  if( isDelet
32d00 65 20 29 7b 0a 23 69 66 20 4f 53 5f 56 58 57 4f  e ){.#if OS_VXWO
32d10 52 4b 53 0a 20 20 20 20 7a 50 61 74 68 20 3d 20  RKS.    zPath = 
32d20 7a 4e 61 6d 65 3b 0a 23 65 6c 69 66 20 64 65 66  zName;.#elif def
32d30 69 6e 65 64 28 53 51 4c 49 54 45 5f 55 4e 4c 49  ined(SQLITE_UNLI
32d40 4e 4b 5f 41 46 54 45 52 5f 43 4c 4f 53 45 29 0a  NK_AFTER_CLOSE).
32d50 20 20 20 20 7a 50 61 74 68 20 3d 20 73 71 6c 69      zPath = sqli
32d60 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 25 73 22  te3_mprintf("%s"
32d70 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 69 66  , zName);.    if
32d80 28 20 7a 50 61 74 68 3d 3d 30 20 29 7b 0a 20 20  ( zPath==0 ){.  
32d90 20 20 20 20 72 6f 62 75 73 74 5f 63 6c 6f 73 65      robust_close
32da0 28 70 2c 20 66 64 2c 20 5f 5f 4c 49 4e 45 5f 5f  (p, fd, __LINE__
32db0 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
32dc0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50  SQLITE_NOMEM_BKP
32dd0 54 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20  T;.    }.#else. 
32de0 20 20 20 6f 73 55 6e 6c 69 6e 6b 28 7a 4e 61 6d     osUnlink(zNam
32df0 65 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 23  e);.#endif.  }.#
32e00 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  if SQLITE_ENABLE
32e10 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 0a 20  _LOCKING_STYLE. 
32e20 20 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 6f 70   else{.    p->op
32e30 65 6e 46 6c 61 67 73 20 3d 20 6f 70 65 6e 46 6c  enFlags = openFl
32e40 61 67 73 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  ags;.  }.#endif.
32e50 20 20 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f    .#if defined(_
32e60 5f 41 50 50 4c 45 5f 5f 29 20 7c 7c 20 53 51 4c  _APPLE__) || SQL
32e70 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
32e80 4e 47 5f 53 54 59 4c 45 0a 20 20 69 66 28 20 66  NG_STYLE.  if( f
32e90 73 74 61 74 66 73 28 66 64 2c 20 26 66 73 49 6e  statfs(fd, &fsIn
32ea0 66 6f 29 20 3d 3d 20 2d 31 20 29 7b 0a 20 20 20  fo) == -1 ){.   
32eb0 20 73 74 6f 72 65 4c 61 73 74 45 72 72 6e 6f 28   storeLastErrno(
32ec0 70 2c 20 65 72 72 6e 6f 29 3b 0a 20 20 20 20 72  p, errno);.    r
32ed0 6f 62 75 73 74 5f 63 6c 6f 73 65 28 70 2c 20 66  obust_close(p, f
32ee0 64 2c 20 5f 5f 4c 49 4e 45 5f 5f 29 3b 0a 20 20  d, __LINE__);.  
32ef0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
32f00 49 4f 45 52 52 5f 41 43 43 45 53 53 3b 0a 20 20  IOERR_ACCESS;.  
32f10 7d 0a 20 20 69 66 20 28 30 20 3d 3d 20 73 74 72  }.  if (0 == str
32f20 6e 63 6d 70 28 22 6d 73 64 6f 73 22 2c 20 66 73  ncmp("msdos", fs
32f30 49 6e 66 6f 2e 66 5f 66 73 74 79 70 65 6e 61 6d  Info.f_fstypenam
32f40 65 2c 20 35 29 29 20 7b 0a 20 20 20 20 28 28 75  e, 5)) {.    ((u
32f50 6e 69 78 46 69 6c 65 2a 29 70 46 69 6c 65 29 2d  nixFile*)pFile)-
32f60 3e 66 73 46 6c 61 67 73 20 7c 3d 20 53 51 4c 49  >fsFlags |= SQLI
32f70 54 45 5f 46 53 46 4c 41 47 53 5f 49 53 5f 4d 53  TE_FSFLAGS_IS_MS
32f80 44 4f 53 3b 0a 20 20 7d 0a 20 20 69 66 20 28 30  DOS;.  }.  if (0
32f90 20 3d 3d 20 73 74 72 6e 63 6d 70 28 22 65 78 66   == strncmp("exf
32fa0 61 74 22 2c 20 66 73 49 6e 66 6f 2e 66 5f 66 73  at", fsInfo.f_fs
32fb0 74 79 70 65 6e 61 6d 65 2c 20 35 29 29 20 7b 0a  typename, 5)) {.
32fc0 20 20 20 20 28 28 75 6e 69 78 46 69 6c 65 2a 29      ((unixFile*)
32fd0 70 46 69 6c 65 29 2d 3e 66 73 46 6c 61 67 73 20  pFile)->fsFlags 
32fe0 7c 3d 20 53 51 4c 49 54 45 5f 46 53 46 4c 41 47  |= SQLITE_FSFLAG
32ff0 53 5f 49 53 5f 4d 53 44 4f 53 3b 0a 20 20 7d 0a  S_IS_MSDOS;.  }.
33000 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 53 65 74  #endif..  /* Set
33010 20 75 70 20 61 70 70 72 6f 70 72 69 61 74 65 20   up appropriate 
33020 63 74 72 6c 46 6c 61 67 73 20 2a 2f 0a 20 20 69  ctrlFlags */.  i
33030 66 28 20 69 73 44 65 6c 65 74 65 20 29 20 20 20  f( isDelete )   
33040 20 20 20 20 20 20 20 20 20 20 20 20 20 63 74 72               ctr
33050 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49  lFlags |= UNIXFI
33060 4c 45 5f 44 45 4c 45 54 45 3b 0a 20 20 69 66 28  LE_DELETE;.  if(
33070 20 69 73 52 65 61 64 6f 6e 6c 79 20 29 20 20 20   isReadonly )   
33080 20 20 20 20 20 20 20 20 20 20 20 63 74 72 6c 46             ctrlF
33090 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49 4c 45  lags |= UNIXFILE
330a0 5f 52 44 4f 4e 4c 59 3b 0a 20 20 6e 6f 4c 6f 63  _RDONLY;.  noLoc
330b0 6b 20 3d 20 65 54 79 70 65 21 3d 53 51 4c 49 54  k = eType!=SQLIT
330c0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 3b 0a  E_OPEN_MAIN_DB;.
330d0 20 20 69 66 28 20 6e 6f 4c 6f 63 6b 20 29 20 20    if( noLock )  
330e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
330f0 63 74 72 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49  ctrlFlags |= UNI
33100 58 46 49 4c 45 5f 4e 4f 4c 4f 43 4b 3b 0a 20 20  XFILE_NOLOCK;.  
33110 69 66 28 20 69 73 4e 65 77 4a 72 6e 6c 20 29 20  if( isNewJrnl ) 
33120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 74                ct
33130 72 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46  rlFlags |= UNIXF
33140 49 4c 45 5f 44 49 52 53 59 4e 43 3b 0a 20 20 69  ILE_DIRSYNC;.  i
33150 66 28 20 66 6c 61 67 73 20 26 20 53 51 4c 49 54  f( flags & SQLIT
33160 45 5f 4f 50 45 4e 5f 55 52 49 20 29 20 63 74 72  E_OPEN_URI ) ctr
33170 6c 46 6c 61 67 73 20 7c 3d 20 55 4e 49 58 46 49  lFlags |= UNIXFI
33180 4c 45 5f 55 52 49 3b 0a 0a 23 69 66 20 53 51 4c  LE_URI;..#if SQL
33190 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
331a0 4e 47 5f 53 54 59 4c 45 0a 23 69 66 20 53 51 4c  NG_STYLE.#if SQL
331b0 49 54 45 5f 50 52 45 46 45 52 5f 50 52 4f 58 59  ITE_PREFER_PROXY
331c0 5f 4c 4f 43 4b 49 4e 47 0a 20 20 69 73 41 75 74  _LOCKING.  isAut
331d0 6f 50 72 6f 78 79 20 3d 20 31 3b 0a 23 65 6e 64  oProxy = 1;.#end
331e0 69 66 0a 20 20 69 66 28 20 69 73 41 75 74 6f 50  if.  if( isAutoP
331f0 72 6f 78 79 20 26 26 20 28 7a 50 61 74 68 21 3d  roxy && (zPath!=
33200 4e 55 4c 4c 29 20 26 26 20 28 21 6e 6f 4c 6f 63  NULL) && (!noLoc
33210 6b 29 20 26 26 20 70 56 66 73 2d 3e 78 4f 70 65  k) && pVfs->xOpe
33220 6e 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 65  n ){.    char *e
33230 6e 76 66 6f 72 63 65 20 3d 20 67 65 74 65 6e 76  nvforce = getenv
33240 28 22 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 50  ("SQLITE_FORCE_P
33250 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 22 29 3b 0a  ROXY_LOCKING");.
33260 20 20 20 20 69 6e 74 20 75 73 65 50 72 6f 78 79      int useProxy
33270 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 53 51   = 0;..    /* SQ
33280 4c 49 54 45 5f 46 4f 52 43 45 5f 50 52 4f 58 59  LITE_FORCE_PROXY
33290 5f 4c 4f 43 4b 49 4e 47 3d 3d 31 20 6d 65 61 6e  _LOCKING==1 mean
332a0 73 20 66 6f 72 63 65 20 61 6c 77 61 79 73 20 75  s force always u
332b0 73 65 20 70 72 6f 78 79 2c 20 30 20 6d 65 61 6e  se proxy, 0 mean
332c0 73 20 0a 20 20 20 20 2a 2a 20 6e 65 76 65 72 20  s .    ** never 
332d0 75 73 65 20 70 72 6f 78 79 2c 20 4e 55 4c 4c 20  use proxy, NULL 
332e0 6d 65 61 6e 73 20 75 73 65 20 70 72 6f 78 79 20  means use proxy 
332f0 66 6f 72 20 6e 6f 6e 2d 6c 6f 63 61 6c 20 66 69  for non-local fi
33300 6c 65 73 20 6f 6e 6c 79 2e 20 20 2a 2f 0a 20 20  les only.  */.  
33310 20 20 69 66 28 20 65 6e 76 66 6f 72 63 65 21 3d    if( envforce!=
33320 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 20 20 75 73  NULL ){.      us
33330 65 50 72 6f 78 79 20 3d 20 61 74 6f 69 28 65 6e  eProxy = atoi(en
33340 76 66 6f 72 63 65 29 3e 30 3b 0a 20 20 20 20 7d  vforce)>0;.    }
33350 65 6c 73 65 7b 0a 20 20 20 20 20 20 75 73 65 50  else{.      useP
33360 72 6f 78 79 20 3d 20 21 28 66 73 49 6e 66 6f 2e  roxy = !(fsInfo.
33370 66 5f 66 6c 61 67 73 26 4d 4e 54 5f 4c 4f 43 41  f_flags&MNT_LOCA
33380 4c 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  L);.    }.    if
33390 28 20 75 73 65 50 72 6f 78 79 20 29 7b 0a 20 20  ( useProxy ){.  
333a0 20 20 20 20 72 63 20 3d 20 66 69 6c 6c 49 6e 55      rc = fillInU
333b0 6e 69 78 46 69 6c 65 28 70 56 66 73 2c 20 66 64  nixFile(pVfs, fd
333c0 2c 20 70 46 69 6c 65 2c 20 7a 50 61 74 68 2c 20  , pFile, zPath, 
333d0 63 74 72 6c 46 6c 61 67 73 29 3b 0a 20 20 20 20  ctrlFlags);.    
333e0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
333f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72  _OK ){.        r
33400 63 20 3d 20 70 72 6f 78 79 54 72 61 6e 73 66 6f  c = proxyTransfo
33410 72 6d 55 6e 69 78 46 69 6c 65 28 28 75 6e 69 78  rmUnixFile((unix
33420 46 69 6c 65 2a 29 70 46 69 6c 65 2c 20 22 3a 61  File*)pFile, ":a
33430 75 74 6f 3a 22 29 3b 0a 20 20 20 20 20 20 20 20  uto:");.        
33440 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
33450 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f  K ){.          /
33460 2a 20 55 73 65 20 75 6e 69 78 43 6c 6f 73 65 20  * Use unixClose 
33470 74 6f 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20  to clean up the 
33480 72 65 73 6f 75 72 63 65 73 20 61 64 64 65 64 20  resources added 
33490 69 6e 20 66 69 6c 6c 49 6e 55 6e 69 78 46 69 6c  in fillInUnixFil
334a0 65 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  e .          ** 
334b0 61 6e 64 20 63 6c 65 61 72 20 61 6c 6c 20 74 68  and clear all th
334c0 65 20 73 74 72 75 63 74 75 72 65 27 73 20 72 65  e structure's re
334d0 66 65 72 65 6e 63 65 73 2e 20 20 53 70 65 63 69  ferences.  Speci
334e0 66 69 63 61 6c 6c 79 2c 20 0a 20 20 20 20 20 20  fically, .      
334f0 20 20 20 20 2a 2a 20 70 46 69 6c 65 2d 3e 70 4d      ** pFile->pM
33500 65 74 68 6f 64 73 20 77 69 6c 6c 20 62 65 20 4e  ethods will be N
33510 55 4c 4c 20 73 6f 20 73 71 6c 69 74 65 33 4f 73  ULL so sqlite3Os
33520 43 6c 6f 73 65 20 77 69 6c 6c 20 62 65 20 61 20  Close will be a 
33530 6e 6f 2d 6f 70 20 0a 20 20 20 20 20 20 20 20 20  no-op .         
33540 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 75 6e   */.          un
33550 69 78 43 6c 6f 73 65 28 70 46 69 6c 65 29 3b 0a  ixClose(pFile);.
33560 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
33570 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20   rc;.        }. 
33580 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f 74       }.      got
33590 6f 20 6f 70 65 6e 5f 66 69 6e 69 73 68 65 64 3b  o open_finished;
335a0 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
335b0 66 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 7a  f.  .  assert( z
335c0 50 61 74 68 3d 3d 30 20 7c 7c 20 7a 50 61 74 68  Path==0 || zPath
335d0 5b 30 5d 3d 3d 27 2f 27 20 0a 20 20 20 20 20 20  [0]=='/' .      
335e0 7c 7c 20 65 54 79 70 65 3d 3d 53 51 4c 49 54 45  || eType==SQLITE
335f0 5f 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55  _OPEN_MASTER_JOU
33600 52 4e 41 4c 20 7c 7c 20 65 54 79 70 65 3d 3d 53  RNAL || eType==S
33610 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f  QLITE_OPEN_MAIN_
33620 4a 4f 55 52 4e 41 4c 20 0a 20 20 29 3b 0a 20 20  JOURNAL .  );.  
33630 72 63 20 3d 20 66 69 6c 6c 49 6e 55 6e 69 78 46  rc = fillInUnixF
33640 69 6c 65 28 70 56 66 73 2c 20 66 64 2c 20 70 46  ile(pVfs, fd, pF
33650 69 6c 65 2c 20 7a 50 61 74 68 2c 20 63 74 72 6c  ile, zPath, ctrl
33660 46 6c 61 67 73 29 3b 0a 0a 6f 70 65 6e 5f 66 69  Flags);..open_fi
33670 6e 69 73 68 65 64 3a 0a 20 20 69 66 28 20 72 63  nished:.  if( rc
33680 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
33690 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
336a0 70 2d 3e 70 50 72 65 61 6c 6c 6f 63 61 74 65 64  p->pPreallocated
336b0 55 6e 75 73 65 64 29 3b 0a 20 20 7d 0a 20 20 72  Unused);.  }.  r
336c0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a  eturn rc;.}.../*
336d0 0a 2a 2a 20 44 65 6c 65 74 65 20 74 68 65 20 66  .** Delete the f
336e0 69 6c 65 20 61 74 20 7a 50 61 74 68 2e 20 49 66  ile at zPath. If
336f0 20 74 68 65 20 64 69 72 53 79 6e 63 20 61 72 67   the dirSync arg
33700 75 6d 65 6e 74 20 69 73 20 74 72 75 65 2c 20 66  ument is true, f
33710 73 79 6e 63 28 29 0a 2a 2a 20 74 68 65 20 64 69  sync().** the di
33720 72 65 63 74 6f 72 79 20 61 66 74 65 72 20 64 65  rectory after de
33730 6c 65 74 69 6e 67 20 74 68 65 20 66 69 6c 65 2e  leting the file.
33740 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
33750 6e 69 78 44 65 6c 65 74 65 28 0a 20 20 73 71 6c  nixDelete(.  sql
33760 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65  ite3_vfs *NotUse
33770 64 2c 20 20 20 20 20 2f 2a 20 56 46 53 20 63 6f  d,     /* VFS co
33780 6e 74 61 69 6e 69 6e 67 20 74 68 69 73 20 61 73  ntaining this as
33790 20 74 68 65 20 78 44 65 6c 65 74 65 20 6d 65 74   the xDelete met
337a0 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  hod */.  const c
337b0 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20 20 20  har *zPath,     
337c0 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 66 69     /* Name of fi
337d0 6c 65 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64  le to be deleted
337e0 20 2a 2f 0a 20 20 69 6e 74 20 64 69 72 53 79 6e   */.  int dirSyn
337f0 63 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  c               
33800 2f 2a 20 49 66 20 74 72 75 65 2c 20 66 73 79 6e  /* If true, fsyn
33810 63 28 29 20 64 69 72 65 63 74 6f 72 79 20 61 66  c() directory af
33820 74 65 72 20 64 65 6c 65 74 69 6e 67 20 66 69 6c  ter deleting fil
33830 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  e */.){.  int rc
33840 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
33850 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
33860 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 53 69 6d  (NotUsed);.  Sim
33870 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 72 65 74  ulateIOError(ret
33880 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  urn SQLITE_IOERR
33890 5f 44 45 4c 45 54 45 29 3b 0a 20 20 69 66 28 20  _DELETE);.  if( 
338a0 6f 73 55 6e 6c 69 6e 6b 28 7a 50 61 74 68 29 3d  osUnlink(zPath)=
338b0 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 69 66 28  =(-1) ){.    if(
338c0 20 65 72 72 6e 6f 3d 3d 45 4e 4f 45 4e 54 0a 23   errno==ENOENT.#
338d0 69 66 20 4f 53 5f 56 58 57 4f 52 4b 53 0a 20 20  if OS_VXWORKS.  
338e0 20 20 20 20 20 20 7c 7c 20 6f 73 41 63 63 65 73        || osAcces
338f0 73 28 7a 50 61 74 68 2c 30 29 21 3d 30 0a 23 65  s(zPath,0)!=0.#e
33900 6e 64 69 66 0a 20 20 20 20 29 7b 0a 20 20 20 20  ndif.    ){.    
33910 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f    rc = SQLITE_IO
33920 45 52 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54  ERR_DELETE_NOENT
33930 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
33940 20 20 20 72 63 20 3d 20 75 6e 69 78 4c 6f 67 45     rc = unixLogE
33950 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52  rror(SQLITE_IOER
33960 52 5f 44 45 4c 45 54 45 2c 20 22 75 6e 6c 69 6e  R_DELETE, "unlin
33970 6b 22 2c 20 7a 50 61 74 68 29 3b 0a 20 20 20 20  k", zPath);.    
33980 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  }.    return rc;
33990 0a 20 20 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  .  }.#ifndef SQL
339a0 49 54 45 5f 44 49 53 41 42 4c 45 5f 44 49 52 53  ITE_DISABLE_DIRS
339b0 59 4e 43 0a 20 20 69 66 28 20 28 64 69 72 53 79  YNC.  if( (dirSy
339c0 6e 63 20 26 20 31 29 21 3d 30 20 29 7b 0a 20 20  nc & 1)!=0 ){.  
339d0 20 20 69 6e 74 20 66 64 3b 0a 20 20 20 20 72 63    int fd;.    rc
339e0 20 3d 20 6f 73 4f 70 65 6e 44 69 72 65 63 74 6f   = osOpenDirecto
339f0 72 79 28 7a 50 61 74 68 2c 20 26 66 64 29 3b 0a  ry(zPath, &fd);.
33a00 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
33a10 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69  TE_OK ){.      i
33a20 66 28 20 66 75 6c 6c 5f 66 73 79 6e 63 28 66 64  f( full_fsync(fd
33a30 2c 30 2c 30 29 20 29 7b 0a 20 20 20 20 20 20 20  ,0,0) ){.       
33a40 20 72 63 20 3d 20 75 6e 69 78 4c 6f 67 45 72 72   rc = unixLogErr
33a50 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f  or(SQLITE_IOERR_
33a60 44 49 52 5f 46 53 59 4e 43 2c 20 22 66 73 79 6e  DIR_FSYNC, "fsyn
33a70 63 22 2c 20 7a 50 61 74 68 29 3b 0a 20 20 20 20  c", zPath);.    
33a80 20 20 7d 0a 20 20 20 20 20 20 72 6f 62 75 73 74    }.      robust
33a90 5f 63 6c 6f 73 65 28 30 2c 20 66 64 2c 20 5f 5f  _close(0, fd, __
33aa0 4c 49 4e 45 5f 5f 29 3b 0a 20 20 20 20 7d 65 6c  LINE__);.    }el
33ab0 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74  se{.      assert
33ac0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 43 41 4e  ( rc==SQLITE_CAN
33ad0 54 4f 50 45 4e 20 29 3b 0a 20 20 20 20 20 20 72  TOPEN );.      r
33ae0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
33af0 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a     }.  }.#endif.
33b00 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
33b10 2f 2a 0a 2a 2a 20 54 65 73 74 20 74 68 65 20 65  /*.** Test the e
33b20 78 69 73 74 65 6e 63 65 20 6f 66 20 6f 72 20 61  xistence of or a
33b30 63 63 65 73 73 20 70 65 72 6d 69 73 73 69 6f 6e  ccess permission
33b40 73 20 6f 66 20 66 69 6c 65 20 7a 50 61 74 68 2e  s of file zPath.
33b50 20 54 68 65 0a 2a 2a 20 74 65 73 74 20 70 65 72   The.** test per
33b60 66 6f 72 6d 65 64 20 64 65 70 65 6e 64 73 20 6f  formed depends o
33b70 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 66  n the value of f
33b80 6c 61 67 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  lags:.**.**     
33b90 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58  SQLITE_ACCESS_EX
33ba0 49 53 54 53 3a 20 52 65 74 75 72 6e 20 31 20 69  ISTS: Return 1 i
33bb0 66 20 74 68 65 20 66 69 6c 65 20 65 78 69 73 74  f the file exist
33bc0 73 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f  s.**     SQLITE_
33bd0 41 43 43 45 53 53 5f 52 45 41 44 57 52 49 54 45  ACCESS_READWRITE
33be0 3a 20 52 65 74 75 72 6e 20 31 20 69 66 20 74 68  : Return 1 if th
33bf0 65 20 66 69 6c 65 20 69 73 20 72 65 61 64 20 61  e file is read a
33c00 6e 64 20 77 72 69 74 61 62 6c 65 2e 0a 2a 2a 20  nd writable..** 
33c10 20 20 20 20 53 51 4c 49 54 45 5f 41 43 43 45 53      SQLITE_ACCES
33c20 53 5f 52 45 41 44 4f 4e 4c 59 3a 20 52 65 74 75  S_READONLY: Retu
33c30 72 6e 20 31 20 69 66 20 74 68 65 20 66 69 6c 65  rn 1 if the file
33c40 20 69 73 20 72 65 61 64 61 62 6c 65 2e 0a 2a 2a   is readable..**
33c50 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 20 72 65  .** Otherwise re
33c60 74 75 72 6e 20 30 2e 0a 2a 2f 0a 73 74 61 74 69  turn 0..*/.stati
33c70 63 20 69 6e 74 20 75 6e 69 78 41 63 63 65 73 73  c int unixAccess
33c80 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20  (.  sqlite3_vfs 
33c90 2a 4e 6f 74 55 73 65 64 2c 20 20 20 2f 2a 20 54  *NotUsed,   /* T
33ca0 68 65 20 56 46 53 20 63 6f 6e 74 61 69 6e 69 6e  he VFS containin
33cb0 67 20 74 68 69 73 20 78 41 63 63 65 73 73 20 6d  g this xAccess m
33cc0 65 74 68 6f 64 20 2a 2f 0a 20 20 63 6f 6e 73 74  ethod */.  const
33cd0 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 20 20   char *zPath,   
33ce0 20 20 20 2f 2a 20 50 61 74 68 20 6f 66 20 74 68     /* Path of th
33cf0 65 20 66 69 6c 65 20 74 6f 20 65 78 61 6d 69 6e  e file to examin
33d00 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73  e */.  int flags
33d10 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
33d20 2a 20 57 68 61 74 20 64 6f 20 77 65 20 77 61 6e  * What do we wan
33d30 74 20 74 6f 20 6c 65 61 72 6e 20 61 62 6f 75 74  t to learn about
33d40 20 74 68 65 20 7a 50 61 74 68 20 66 69 6c 65 3f   the zPath file?
33d50 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 4f   */.  int *pResO
33d60 75 74 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ut            /*
33d70 20 57 72 69 74 65 20 72 65 73 75 6c 74 20 62 6f   Write result bo
33d80 6f 6c 65 61 6e 20 68 65 72 65 20 2a 2f 0a 29 7b  olean here */.){
33d90 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
33da0 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20  TER(NotUsed);.  
33db0 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28  SimulateIOError(
33dc0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49   return SQLITE_I
33dd0 4f 45 52 52 5f 41 43 43 45 53 53 3b 20 29 3b 0a  OERR_ACCESS; );.
33de0 20 20 61 73 73 65 72 74 28 20 70 52 65 73 4f 75    assert( pResOu
33df0 74 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 54 68  t!=0 );..  /* Th
33e00 65 20 73 70 65 63 20 73 61 79 73 20 74 68 65 72  e spec says ther
33e10 65 20 61 72 65 20 74 68 72 65 65 20 70 6f 73 73  e are three poss
33e20 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20  ible values for 
33e30 66 6c 61 67 73 2e 20 20 42 75 74 20 6f 6e 6c 79  flags.  But only
33e40 0a 20 20 2a 2a 20 74 77 6f 20 6f 66 20 74 68 65  .  ** two of the
33e50 6d 20 61 72 65 20 61 63 74 75 61 6c 6c 79 20 75  m are actually u
33e60 73 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  sed */.  assert(
33e70 20 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41   flags==SQLITE_A
33e80 43 43 45 53 53 5f 45 58 49 53 54 53 20 7c 7c 20  CCESS_EXISTS || 
33e90 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41 43  flags==SQLITE_AC
33ea0 43 45 53 53 5f 52 45 41 44 57 52 49 54 45 20 29  CESS_READWRITE )
33eb0 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67 73 3d 3d  ;..  if( flags==
33ec0 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58  SQLITE_ACCESS_EX
33ed0 49 53 54 53 20 29 7b 0a 20 20 20 20 73 74 72 75  ISTS ){.    stru
33ee0 63 74 20 73 74 61 74 20 62 75 66 3b 0a 20 20 20  ct stat buf;.   
33ef0 20 2a 70 52 65 73 4f 75 74 20 3d 20 28 30 3d 3d   *pResOut = (0==
33f00 6f 73 53 74 61 74 28 7a 50 61 74 68 2c 20 26 62  osStat(zPath, &b
33f10 75 66 29 20 26 26 20 62 75 66 2e 73 74 5f 73 69  uf) && buf.st_si
33f20 7a 65 3e 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  ze>0);.  }else{.
33f30 20 20 20 20 2a 70 52 65 73 4f 75 74 20 3d 20 6f      *pResOut = o
33f40 73 41 63 63 65 73 73 28 7a 50 61 74 68 2c 20 57  sAccess(zPath, W
33f50 5f 4f 4b 7c 52 5f 4f 4b 29 3d 3d 30 3b 0a 20 20  _OK|R_OK)==0;.  
33f60 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  }.  return SQLIT
33f70 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 0a 2a  E_OK;.}../*.**.*
33f80 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6b 46  /.static int mkF
33f90 75 6c 6c 50 61 74 68 6e 61 6d 65 28 0a 20 20 63  ullPathname(.  c
33fa0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68  onst char *zPath
33fb0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
33fc0 2a 20 49 6e 70 75 74 20 70 61 74 68 20 2a 2f 0a  * Input path */.
33fd0 20 20 63 68 61 72 20 2a 7a 4f 75 74 2c 20 20 20    char *zOut,   
33fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
33ff0 20 20 2f 2a 20 4f 75 74 70 75 74 20 62 75 66 66    /* Output buff
34000 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74  er */.  int nOut
34010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
34020 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63          /* Alloc
34030 61 74 65 64 20 73 69 7a 65 20 6f 66 20 62 75 66  ated size of buf
34040 66 65 72 20 7a 4f 75 74 20 2a 2f 0a 29 7b 0a 20  fer zOut */.){. 
34050 20 69 6e 74 20 6e 50 61 74 68 20 3d 20 73 71 6c   int nPath = sql
34060 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 50 61  ite3Strlen30(zPa
34070 74 68 29 3b 0a 20 20 69 6e 74 20 69 4f 66 66 20  th);.  int iOff 
34080 3d 20 30 3b 0a 20 20 69 66 28 20 7a 50 61 74 68  = 0;.  if( zPath
34090 5b 30 5d 21 3d 27 2f 27 20 29 7b 0a 20 20 20 20  [0]!='/' ){.    
340a0 69 66 28 20 6f 73 47 65 74 63 77 64 28 7a 4f 75  if( osGetcwd(zOu
340b0 74 2c 20 6e 4f 75 74 2d 32 29 3d 3d 30 20 29 7b  t, nOut-2)==0 ){
340c0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 75 6e  .      return un
340d0 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c 49 54  ixLogError(SQLIT
340e0 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 2c  E_CANTOPEN_BKPT,
340f0 20 22 67 65 74 63 77 64 22 2c 20 7a 50 61 74 68   "getcwd", zPath
34100 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 4f 66  );.    }.    iOf
34110 66 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65  f = sqlite3Strle
34120 6e 33 30 28 7a 4f 75 74 29 3b 0a 20 20 20 20 7a  n30(zOut);.    z
34130 4f 75 74 5b 69 4f 66 66 2b 2b 5d 20 3d 20 27 2f  Out[iOff++] = '/
34140 27 3b 0a 20 20 7d 0a 20 20 69 66 28 20 28 69 4f  ';.  }.  if( (iO
34150 66 66 2b 6e 50 61 74 68 2b 31 29 3e 6e 4f 75 74  ff+nPath+1)>nOut
34160 20 29 7b 0a 20 20 20 20 2f 2a 20 53 51 4c 69 74   ){.    /* SQLit
34170 65 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 78  e assumes that x
34180 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 29 20 6e  FullPathname() n
34190 75 6c 2d 74 65 72 6d 69 6e 61 74 65 73 20 74 68  ul-terminates th
341a0 65 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 0a  e output buffer.
341b0 20 20 20 20 2a 2a 20 65 76 65 6e 20 69 66 20 69      ** even if i
341c0 74 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72  t returns an err
341d0 6f 72 2e 20 20 2a 2f 0a 20 20 20 20 7a 4f 75 74  or.  */.    zOut
341e0 5b 69 4f 66 66 5d 20 3d 20 27 5c 30 27 3b 0a 20  [iOff] = '\0';. 
341f0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
34200 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 3b 0a  _CANTOPEN_BKPT;.
34210 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e    }.  sqlite3_sn
34220 70 72 69 6e 74 66 28 6e 4f 75 74 2d 69 4f 66 66  printf(nOut-iOff
34230 2c 20 26 7a 4f 75 74 5b 69 4f 66 66 5d 2c 20 22  , &zOut[iOff], "
34240 25 73 22 2c 20 7a 50 61 74 68 29 3b 0a 20 20 72  %s", zPath);.  r
34250 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
34260 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 75 72 6e 20 61  .}../*.** Turn a
34270 20 72 65 6c 61 74 69 76 65 20 70 61 74 68 6e 61   relative pathna
34280 6d 65 20 69 6e 74 6f 20 61 20 66 75 6c 6c 20 70  me into a full p
34290 61 74 68 6e 61 6d 65 2e 20 54 68 65 20 72 65 6c  athname. The rel
342a0 61 74 69 76 65 20 70 61 74 68 0a 2a 2a 20 69 73  ative path.** is
342b0 20 73 74 6f 72 65 64 20 61 73 20 61 20 6e 75 6c   stored as a nul
342c0 2d 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69  -terminated stri
342d0 6e 67 20 69 6e 20 74 68 65 20 62 75 66 66 65 72  ng in the buffer
342e0 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 0a 2a   pointed to by.*
342f0 2a 20 7a 50 61 74 68 2e 20 0a 2a 2a 0a 2a 2a 20  * zPath. .**.** 
34300 7a 4f 75 74 20 70 6f 69 6e 74 73 20 74 6f 20 61  zOut points to a
34310 20 62 75 66 66 65 72 20 6f 66 20 61 74 20 6c 65   buffer of at le
34320 61 73 74 20 73 71 6c 69 74 65 33 5f 76 66 73 2e  ast sqlite3_vfs.
34330 6d 78 50 61 74 68 6e 61 6d 65 20 62 79 74 65 73  mxPathname bytes
34340 20 0a 2a 2a 20 28 69 6e 20 74 68 69 73 20 63 61   .** (in this ca
34350 73 65 2c 20 4d 41 58 5f 50 41 54 48 4e 41 4d 45  se, MAX_PATHNAME
34360 20 62 79 74 65 73 29 2e 20 54 68 65 20 66 75 6c   bytes). The ful
34370 6c 2d 70 61 74 68 20 69 73 20 77 72 69 74 74 65  l-path is writte
34380 6e 20 74 6f 0a 2a 2a 20 74 68 69 73 20 62 75 66  n to.** this buf
34390 66 65 72 20 62 65 66 6f 72 65 20 72 65 74 75 72  fer before retur
343a0 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ning..*/.static 
343b0 69 6e 74 20 75 6e 69 78 46 75 6c 6c 50 61 74 68  int unixFullPath
343c0 6e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f  name(.  sqlite3_
343d0 76 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20  vfs *pVfs,      
343e0 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72        /* Pointer
343f0 20 74 6f 20 76 66 73 20 6f 62 6a 65 63 74 20 2a   to vfs object *
34400 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
34410 7a 50 61 74 68 2c 20 20 20 20 20 20 20 20 20 20  zPath,          
34420 20 20 2f 2a 20 50 6f 73 73 69 62 6c 79 20 72 65    /* Possibly re
34430 6c 61 74 69 76 65 20 69 6e 70 75 74 20 70 61 74  lative input pat
34440 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74 2c  h */.  int nOut,
34450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
34460 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20       /* Size of 
34470 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69 6e  output buffer in
34480 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 61 72   bytes */.  char
34490 20 2a 7a 4f 75 74 20 20 20 20 20 20 20 20 20 20   *zOut          
344a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 75 74            /* Out
344b0 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 29 7b  put buffer */.){
344c0 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 48 41  .#if !defined(HA
344d0 56 45 5f 52 45 41 44 4c 49 4e 4b 29 20 7c 7c 20  VE_READLINK) || 
344e0 21 64 65 66 69 6e 65 64 28 48 41 56 45 5f 4c 53  !defined(HAVE_LS
344f0 54 41 54 29 0a 20 20 72 65 74 75 72 6e 20 6d 6b  TAT).  return mk
34500 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 7a 50 61  FullPathname(zPa
34510 74 68 2c 20 7a 4f 75 74 2c 20 6e 4f 75 74 29 3b  th, zOut, nOut);
34520 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 72 63 20  .#else.  int rc 
34530 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  = SQLITE_OK;.  i
34540 6e 74 20 6e 42 79 74 65 3b 0a 20 20 69 6e 74 20  nt nByte;.  int 
34550 6e 4c 69 6e 6b 20 3d 20 31 3b 20 20 20 20 20 20  nLink = 1;      
34560 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
34570 62 65 72 20 6f 66 20 73 79 6d 62 6f 6c 69 63 20  ber of symbolic 
34580 6c 69 6e 6b 73 20 66 6f 6c 6c 6f 77 65 64 20 73  links followed s
34590 6f 20 66 61 72 20 2a 2f 0a 20 20 63 6f 6e 73 74  o far */.  const
345a0 20 63 68 61 72 20 2a 7a 49 6e 20 3d 20 7a 50 61   char *zIn = zPa
345b0 74 68 3b 20 20 20 20 20 20 2f 2a 20 49 6e 70 75  th;      /* Inpu
345c0 74 20 70 61 74 68 20 66 6f 72 20 65 61 63 68 20  t path for each 
345d0 69 74 65 72 61 74 69 6f 6e 20 6f 66 20 6c 6f 6f  iteration of loo
345e0 70 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 44 65  p */.  char *zDe
345f0 6c 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74  l = 0;..  assert
34600 28 20 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61  ( pVfs->mxPathna
34610 6d 65 3d 3d 4d 41 58 5f 50 41 54 48 4e 41 4d 45  me==MAX_PATHNAME
34620 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52   );.  UNUSED_PAR
34630 41 4d 45 54 45 52 28 70 56 66 73 29 3b 0a 0a 20  AMETER(pVfs);.. 
34640 20 2f 2a 20 49 74 27 73 20 6f 64 64 20 74 6f 20   /* It's odd to 
34650 73 69 6d 75 6c 61 74 65 20 61 6e 20 69 6f 2d 65  simulate an io-e
34660 72 72 6f 72 20 68 65 72 65 2c 20 62 75 74 20 72  rror here, but r
34670 65 61 6c 6c 79 20 74 68 69 73 20 69 73 20 6a 75  eally this is ju
34680 73 74 0a 20 20 2a 2a 20 75 73 69 6e 67 20 74 68  st.  ** using th
34690 65 20 69 6f 2d 65 72 72 6f 72 20 69 6e 66 72 61  e io-error infra
346a0 73 74 72 75 63 74 75 72 65 20 74 6f 20 74 65 73  structure to tes
346b0 74 20 74 68 61 74 20 53 51 4c 69 74 65 20 68 61  t that SQLite ha
346c0 6e 64 6c 65 73 20 74 68 69 73 0a 20 20 2a 2a 20  ndles this.  ** 
346d0 66 75 6e 63 74 69 6f 6e 20 66 61 69 6c 69 6e 67  function failing
346e0 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  . This function 
346f0 63 6f 75 6c 64 20 66 61 69 6c 20 69 66 2c 20 66  could fail if, f
34700 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 0a  or example, the.
34710 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 77 6f 72    ** current wor
34720 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 79 20 68  king directory h
34730 61 73 20 62 65 65 6e 20 75 6e 6c 69 6e 6b 65 64  as been unlinked
34740 2e 0a 20 20 2a 2f 0a 20 20 53 69 6d 75 6c 61 74  ..  */.  Simulat
34750 65 49 4f 45 72 72 6f 72 28 20 72 65 74 75 72 6e  eIOError( return
34760 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 29 3b   SQLITE_ERROR );
34770 0a 0a 20 20 64 6f 20 7b 0a 0a 20 20 20 20 2f 2a  ..  do {..    /*
34780 20 43 61 6c 6c 20 73 74 61 74 28 29 20 6f 6e 20   Call stat() on 
34790 70 61 74 68 20 7a 49 6e 2e 20 53 65 74 20 62 4c  path zIn. Set bL
347a0 69 6e 6b 20 74 6f 20 74 72 75 65 20 69 66 20 74  ink to true if t
347b0 68 65 20 70 61 74 68 20 69 73 20 61 20 73 79 6d  he path is a sym
347c0 62 6f 6c 69 63 0a 20 20 20 20 2a 2a 20 6c 69 6e  bolic.    ** lin
347d0 6b 2c 20 6f 72 20 66 61 6c 73 65 20 6f 74 68 65  k, or false othe
347e0 72 77 69 73 65 2e 20 20 2a 2f 0a 20 20 20 20 69  rwise.  */.    i
347f0 6e 74 20 62 4c 69 6e 6b 20 3d 20 30 3b 0a 20 20  nt bLink = 0;.  
34800 20 20 73 74 72 75 63 74 20 73 74 61 74 20 62 75    struct stat bu
34810 66 3b 0a 20 20 20 20 69 66 28 20 6f 73 4c 73 74  f;.    if( osLst
34820 61 74 28 7a 49 6e 2c 20 26 62 75 66 29 21 3d 30  at(zIn, &buf)!=0
34830 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 65 72   ){.      if( er
34840 72 6e 6f 21 3d 45 4e 4f 45 4e 54 20 29 7b 0a 20  rno!=ENOENT ){. 
34850 20 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 78         rc = unix
34860 4c 6f 67 45 72 72 6f 72 28 53 51 4c 49 54 45 5f  LogError(SQLITE_
34870 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 2c 20 22  CANTOPEN_BKPT, "
34880 6c 73 74 61 74 22 2c 20 7a 49 6e 29 3b 0a 20 20  lstat", zIn);.  
34890 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b      }.    }else{
348a0 0a 20 20 20 20 20 20 62 4c 69 6e 6b 20 3d 20 53  .      bLink = S
348b0 5f 49 53 4c 4e 4b 28 62 75 66 2e 73 74 5f 6d 6f  _ISLNK(buf.st_mo
348c0 64 65 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  de);.    }..    
348d0 69 66 28 20 62 4c 69 6e 6b 20 29 7b 0a 20 20 20  if( bLink ){.   
348e0 20 20 20 69 66 28 20 7a 44 65 6c 3d 3d 30 20 29     if( zDel==0 )
348f0 7b 0a 20 20 20 20 20 20 20 20 7a 44 65 6c 20 3d  {.        zDel =
34900 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28   sqlite3_malloc(
34910 6e 4f 75 74 29 3b 0a 20 20 20 20 20 20 20 20 69  nOut);.        i
34920 66 28 20 7a 44 65 6c 3d 3d 30 20 29 20 72 63 20  f( zDel==0 ) rc 
34930 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42  = SQLITE_NOMEM_B
34940 4b 50 54 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  KPT;.      }else
34950 20 69 66 28 20 2b 2b 6e 4c 69 6e 6b 3e 53 51 4c   if( ++nLink>SQL
34960 49 54 45 5f 4d 41 58 5f 53 59 4d 4c 49 4e 4b 53  ITE_MAX_SYMLINKS
34970 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d   ){.        rc =
34980 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e   SQLITE_CANTOPEN
34990 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 0a 0a  _BKPT;.      }..
349a0 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
349b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
349c0 20 20 20 6e 42 79 74 65 20 3d 20 6f 73 52 65 61     nByte = osRea
349d0 64 6c 69 6e 6b 28 7a 49 6e 2c 20 7a 44 65 6c 2c  dlink(zIn, zDel,
349e0 20 6e 4f 75 74 2d 31 29 3b 0a 20 20 20 20 20 20   nOut-1);.      
349f0 20 20 69 66 28 20 6e 42 79 74 65 3c 30 20 29 7b    if( nByte<0 ){
34a00 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20  .          rc = 
34a10 75 6e 69 78 4c 6f 67 45 72 72 6f 72 28 53 51 4c  unixLogError(SQL
34a20 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50  ITE_CANTOPEN_BKP
34a30 54 2c 20 22 72 65 61 64 6c 69 6e 6b 22 2c 20 7a  T, "readlink", z
34a40 49 6e 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c  In);.        }el
34a50 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66  se{.          if
34a60 28 20 7a 44 65 6c 5b 30 5d 21 3d 27 2f 27 20 29  ( zDel[0]!='/' )
34a70 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e  {.            in
34a80 74 20 6e 3b 0a 20 20 20 20 20 20 20 20 20 20 20  t n;.           
34a90 20 66 6f 72 28 6e 20 3d 20 73 71 6c 69 74 65 33   for(n = sqlite3
34aa0 53 74 72 6c 65 6e 33 30 28 7a 49 6e 29 3b 20 6e  Strlen30(zIn); n
34ab0 3e 30 20 26 26 20 7a 49 6e 5b 6e 2d 31 5d 21 3d  >0 && zIn[n-1]!=
34ac0 27 2f 27 3b 20 6e 2d 2d 29 3b 0a 20 20 20 20 20  '/'; n--);.     
34ad0 20 20 20 20 20 20 20 69 66 28 20 6e 42 79 74 65         if( nByte
34ae0 2b 6e 2b 31 3e 6e 4f 75 74 20 29 7b 0a 20 20 20  +n+1>nOut ){.   
34af0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20             rc = 
34b00 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f  SQLITE_CANTOPEN_
34b10 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20  BKPT;.          
34b20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
34b30 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 28 26         memmove(&
34b40 7a 44 65 6c 5b 6e 5d 2c 20 7a 44 65 6c 2c 20 6e  zDel[n], zDel, n
34b50 42 79 74 65 2b 31 29 3b 0a 20 20 20 20 20 20 20  Byte+1);.       
34b60 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a 44         memcpy(zD
34b70 65 6c 2c 20 7a 49 6e 2c 20 6e 29 3b 0a 20 20 20  el, zIn, n);.   
34b80 20 20 20 20 20 20 20 20 20 20 20 6e 42 79 74 65             nByte
34b90 20 2b 3d 20 6e 3b 0a 20 20 20 20 20 20 20 20 20   += n;.         
34ba0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d     }.          }
34bb0 0a 20 20 20 20 20 20 20 20 20 20 7a 44 65 6c 5b  .          zDel[
34bc0 6e 42 79 74 65 5d 20 3d 20 27 5c 30 27 3b 0a 20  nByte] = '\0';. 
34bd0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
34be0 0a 0a 20 20 20 20 20 20 7a 49 6e 20 3d 20 7a 44  ..      zIn = zD
34bf0 65 6c 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61  el;.    }..    a
34c00 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54  ssert( rc!=SQLIT
34c10 45 5f 4f 4b 20 7c 7c 20 7a 49 6e 21 3d 7a 4f 75  E_OK || zIn!=zOu
34c20 74 20 7c 7c 20 7a 49 6e 5b 30 5d 3d 3d 27 2f 27  t || zIn[0]=='/'
34c30 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d   );.    if( rc==
34c40 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 7a 49 6e  SQLITE_OK && zIn
34c50 21 3d 7a 4f 75 74 20 29 7b 0a 20 20 20 20 20 20  !=zOut ){.      
34c60 72 63 20 3d 20 6d 6b 46 75 6c 6c 50 61 74 68 6e  rc = mkFullPathn
34c70 61 6d 65 28 7a 49 6e 2c 20 7a 4f 75 74 2c 20 6e  ame(zIn, zOut, n
34c80 4f 75 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  Out);.    }.    
34c90 69 66 28 20 62 4c 69 6e 6b 3d 3d 30 20 29 20 62  if( bLink==0 ) b
34ca0 72 65 61 6b 3b 0a 20 20 20 20 7a 49 6e 20 3d 20  reak;.    zIn = 
34cb0 7a 4f 75 74 3b 0a 20 20 7d 77 68 69 6c 65 28 20  zOut;.  }while( 
34cc0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b  rc==SQLITE_OK );
34cd0 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65  ..  sqlite3_free
34ce0 28 7a 44 65 6c 29 3b 0a 20 20 72 65 74 75 72 6e  (zDel);.  return
34cf0 20 72 63 3b 0a 23 65 6e 64 69 66 20 20 20 2f 2a   rc;.#endif   /*
34d00 20 48 41 56 45 5f 52 45 41 44 4c 49 4e 4b 20 26   HAVE_READLINK &
34d10 26 20 48 41 56 45 5f 4c 53 54 41 54 20 2a 2f 0a  & HAVE_LSTAT */.
34d20 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  }...#ifndef SQLI
34d30 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54  TE_OMIT_LOAD_EXT
34d40 45 4e 53 49 4f 4e 0a 2f 2a 0a 2a 2a 20 49 6e 74  ENSION./*.** Int
34d50 65 72 66 61 63 65 73 20 66 6f 72 20 6f 70 65 6e  erfaces for open
34d60 69 6e 67 20 61 20 73 68 61 72 65 64 20 6c 69 62  ing a shared lib
34d70 72 61 72 79 2c 20 66 69 6e 64 69 6e 67 20 65 6e  rary, finding en
34d80 74 72 79 20 70 6f 69 6e 74 73 0a 2a 2a 20 77 69  try points.** wi
34d90 74 68 69 6e 20 74 68 65 20 73 68 61 72 65 64 20  thin the shared 
34da0 6c 69 62 72 61 72 79 2c 20 61 6e 64 20 63 6c 6f  library, and clo
34db0 73 69 6e 67 20 74 68 65 20 73 68 61 72 65 64 20  sing the shared 
34dc0 6c 69 62 72 61 72 79 2e 0a 2a 2f 0a 23 69 6e 63  library..*/.#inc
34dd0 6c 75 64 65 20 3c 64 6c 66 63 6e 2e 68 3e 0a 73  lude <dlfcn.h>.s
34de0 74 61 74 69 63 20 76 6f 69 64 20 2a 75 6e 69 78  tatic void *unix
34df0 44 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76  DlOpen(sqlite3_v
34e00 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 63 6f 6e  fs *NotUsed, con
34e10 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
34e20 6d 65 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 41  me){.  UNUSED_PA
34e30 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29  RAMETER(NotUsed)
34e40 3b 0a 20 20 72 65 74 75 72 6e 20 64 6c 6f 70 65  ;.  return dlope
34e50 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 52 54 4c  n(zFilename, RTL
34e60 44 5f 4e 4f 57 20 7c 20 52 54 4c 44 5f 47 4c 4f  D_NOW | RTLD_GLO
34e70 42 41 4c 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  BAL);.}../*.** S
34e80 51 4c 69 74 65 20 63 61 6c 6c 73 20 74 68 69 73  QLite calls this
34e90 20 66 75 6e 63 74 69 6f 6e 20 69 6d 6d 65 64 69   function immedi
34ea0 61 74 65 6c 79 20 61 66 74 65 72 20 61 20 63 61  ately after a ca
34eb0 6c 6c 20 74 6f 20 75 6e 69 78 44 6c 53 79 6d 28  ll to unixDlSym(
34ec0 29 20 6f 72 0a 2a 2a 20 75 6e 69 78 44 6c 4f 70  ) or.** unixDlOp
34ed0 65 6e 28 29 20 66 61 69 6c 73 20 28 72 65 74 75  en() fails (retu
34ee0 72 6e 73 20 61 20 6e 75 6c 6c 20 70 6f 69 6e 74  rns a null point
34ef0 65 72 29 2e 20 49 66 20 61 20 6d 6f 72 65 20 64  er). If a more d
34f00 65 74 61 69 6c 65 64 20 65 72 72 6f 72 0a 2a 2a  etailed error.**
34f10 20 6d 65 73 73 61 67 65 20 69 73 20 61 76 61 69   message is avai
34f20 6c 61 62 6c 65 2c 20 69 74 20 69 73 20 77 72 69  lable, it is wri
34f30 74 74 65 6e 20 74 6f 20 7a 42 75 66 4f 75 74 2e  tten to zBufOut.
34f40 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6d 65 73   If no error mes
34f50 73 61 67 65 0a 2a 2a 20 69 73 20 61 76 61 69 6c  sage.** is avail
34f60 61 62 6c 65 2c 20 7a 42 75 66 4f 75 74 20 69 73  able, zBufOut is
34f70 20 6c 65 66 74 20 75 6e 6d 6f 64 69 66 69 65 64   left unmodified
34f80 20 61 6e 64 20 53 51 4c 69 74 65 20 75 73 65 73   and SQLite uses
34f90 20 61 20 64 65 66 61 75 6c 74 0a 2a 2a 20 65 72   a default.** er
34fa0 72 6f 72 20 6d 65 73 73 61 67 65 2e 0a 2a 2f 0a  ror message..*/.
34fb0 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69 78  static void unix
34fc0 44 6c 45 72 72 6f 72 28 73 71 6c 69 74 65 33 5f  DlError(sqlite3_
34fd0 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e  vfs *NotUsed, in
34fe0 74 20 6e 42 75 66 2c 20 63 68 61 72 20 2a 7a 42  t nBuf, char *zB
34ff0 75 66 4f 75 74 29 7b 0a 20 20 63 6f 6e 73 74 20  ufOut){.  const 
35000 63 68 61 72 20 2a 7a 45 72 72 3b 0a 20 20 55 4e  char *zErr;.  UN
35010 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
35020 6f 74 55 73 65 64 29 3b 0a 20 20 75 6e 69 78 45  otUsed);.  unixE
35030 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 7a  nterMutex();.  z
35040 45 72 72 20 3d 20 64 6c 65 72 72 6f 72 28 29 3b  Err = dlerror();
35050 0a 20 20 69 66 28 20 7a 45 72 72 20 29 7b 0a 20  .  if( zErr ){. 
35060 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 69     sqlite3_snpri
35070 6e 74 66 28 6e 42 75 66 2c 20 7a 42 75 66 4f 75  ntf(nBuf, zBufOu
35080 74 2c 20 22 25 73 22 2c 20 7a 45 72 72 29 3b 0a  t, "%s", zErr);.
35090 20 20 7d 0a 20 20 75 6e 69 78 4c 65 61 76 65 4d    }.  unixLeaveM
350a0 75 74 65 78 28 29 3b 0a 7d 0a 73 74 61 74 69 63  utex();.}.static
350b0 20 76 6f 69 64 20 28 2a 75 6e 69 78 44 6c 53 79   void (*unixDlSy
350c0 6d 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e  m(sqlite3_vfs *N
350d0 6f 74 55 73 65 64 2c 20 76 6f 69 64 20 2a 70 2c  otUsed, void *p,
350e0 20 63 6f 6e 73 74 20 63 68 61 72 2a 7a 53 79 6d   const char*zSym
350f0 29 29 28 76 6f 69 64 29 7b 0a 20 20 2f 2a 20 0a  ))(void){.  /* .
35100 20 20 2a 2a 20 47 43 43 20 77 69 74 68 20 2d 70    ** GCC with -p
35110 65 64 61 6e 74 69 63 2d 65 72 72 6f 72 73 20 73  edantic-errors s
35120 61 79 73 20 74 68 61 74 20 43 39 30 20 64 6f 65  ays that C90 doe
35130 73 20 6e 6f 74 20 61 6c 6c 6f 77 20 61 20 76 6f  s not allow a vo
35140 69 64 2a 20 74 6f 20 62 65 0a 20 20 2a 2a 20 63  id* to be.  ** c
35150 61 73 74 20 69 6e 74 6f 20 61 20 70 6f 69 6e 74  ast into a point
35160 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e  er to a function
35170 2e 20 20 41 6e 64 20 79 65 74 20 74 68 65 20 6c  .  And yet the l
35180 69 62 72 61 72 79 20 64 6c 73 79 6d 28 29 20 72  ibrary dlsym() r
35190 6f 75 74 69 6e 65 0a 20 20 2a 2a 20 72 65 74 75  outine.  ** retu
351a0 72 6e 73 20 61 20 76 6f 69 64 2a 20 77 68 69 63  rns a void* whic
351b0 68 20 69 73 20 72 65 61 6c 6c 79 20 61 20 70 6f  h is really a po
351c0 69 6e 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74  inter to a funct
351d0 69 6f 6e 2e 20 20 53 6f 20 68 6f 77 20 64 6f 20  ion.  So how do 
351e0 77 65 0a 20 20 2a 2a 20 75 73 65 20 64 6c 73 79  we.  ** use dlsy
351f0 6d 28 29 20 77 69 74 68 20 2d 70 65 64 61 6e 74  m() with -pedant
35200 69 63 2d 65 72 72 6f 72 73 3f 0a 20 20 2a 2a 0a  ic-errors?.  **.
35210 20 20 2a 2a 20 56 61 72 69 61 62 6c 65 20 78 20    ** Variable x 
35220 62 65 6c 6f 77 20 69 73 20 64 65 66 69 6e 65 64  below is defined
35230 20 74 6f 20 62 65 20 61 20 70 6f 69 6e 74 65 72   to be a pointer
35240 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 20 74   to a function t
35250 61 6b 69 6e 67 0a 20 20 2a 2a 20 70 61 72 61 6d  aking.  ** param
35260 65 74 65 72 73 20 76 6f 69 64 2a 20 61 6e 64 20  eters void* and 
35270 63 6f 6e 73 74 20 63 68 61 72 2a 20 61 6e 64 20  const char* and 
35280 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f 69 6e  returning a poin
35290 74 65 72 20 74 6f 20 61 20 66 75 6e 63 74 69 6f  ter to a functio
352a0 6e 2e 0a 20 20 2a 2a 20 57 65 20 69 6e 69 74 69  n..  ** We initi
352b0 61 6c 69 7a 65 20 78 20 62 79 20 61 73 73 69 67  alize x by assig
352c0 6e 69 6e 67 20 69 74 20 61 20 70 6f 69 6e 74 65  ning it a pointe
352d0 72 20 74 6f 20 74 68 65 20 64 6c 73 79 6d 28 29  r to the dlsym()
352e0 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20   function..  ** 
352f0 28 54 68 61 74 20 61 73 73 69 67 6e 6d 65 6e 74  (That assignment
35300 20 72 65 71 75 69 72 65 73 20 61 20 63 61 73 74   requires a cast
35310 2e 29 20 20 54 68 65 6e 20 77 65 20 63 61 6c 6c  .)  Then we call
35320 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 68   the function th
35330 61 74 0a 20 20 2a 2a 20 78 20 70 6f 69 6e 74 73  at.  ** x points
35340 20 74 6f 2e 20 20 0a 20 20 2a 2a 0a 20 20 2a 2a   to.  .  **.  **
35350 20 54 68 69 73 20 77 6f 72 6b 2d 61 72 6f 75 6e   This work-aroun
35360 64 20 69 73 20 75 6e 6c 69 6b 65 6c 79 20 74 6f  d is unlikely to
35370 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 20   work correctly 
35380 6f 6e 20 61 6e 79 20 73 79 73 74 65 6d 20 77 68  on any system wh
35390 65 72 65 0a 20 20 2a 2a 20 79 6f 75 20 72 65 61  ere.  ** you rea
353a0 6c 6c 79 20 63 61 6e 6e 6f 74 20 63 61 73 74 20  lly cannot cast 
353b0 61 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74  a function point
353c0 65 72 20 69 6e 74 6f 20 76 6f 69 64 2a 2e 20 20  er into void*.  
353d0 42 75 74 20 74 68 65 6e 2c 20 6f 6e 20 74 68 65  But then, on the
353e0 0a 20 20 2a 2a 20 6f 74 68 65 72 20 68 61 6e 64  .  ** other hand
353f0 2c 20 64 6c 73 79 6d 28 29 20 77 69 6c 6c 20 6e  , dlsym() will n
35400 6f 74 20 77 6f 72 6b 20 6f 6e 20 73 75 63 68 20  ot work on such 
35410 61 20 73 79 73 74 65 6d 20 65 69 74 68 65 72 2c  a system either,
35420 20 73 6f 20 77 65 20 68 61 76 65 0a 20 20 2a 2a   so we have.  **
35430 20 6e 6f 74 20 72 65 61 6c 6c 79 20 6c 6f 73 74   not really lost
35440 20 61 6e 79 74 68 69 6e 67 2e 0a 20 20 2a 2f 0a   anything..  */.
35450 20 20 76 6f 69 64 20 28 2a 28 2a 78 29 28 76 6f    void (*(*x)(vo
35460 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29  id*,const char*)
35470 29 28 76 6f 69 64 29 3b 0a 20 20 55 4e 55 53 45  )(void);.  UNUSE
35480 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55  D_PARAMETER(NotU
35490 73 65 64 29 3b 0a 20 20 78 20 3d 20 28 76 6f 69  sed);.  x = (voi
354a0 64 28 2a 28 2a 29 28 76 6f 69 64 2a 2c 63 6f 6e  d(*(*)(void*,con
354b0 73 74 20 63 68 61 72 2a 29 29 28 76 6f 69 64 29  st char*))(void)
354c0 29 64 6c 73 79 6d 3b 0a 20 20 72 65 74 75 72 6e  )dlsym;.  return
354d0 20 28 2a 78 29 28 70 2c 20 7a 53 79 6d 29 3b 0a   (*x)(p, zSym);.
354e0 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e  }.static void un
354f0 69 78 44 6c 43 6c 6f 73 65 28 73 71 6c 69 74 65  ixDlClose(sqlite
35500 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20  3_vfs *NotUsed, 
35510 76 6f 69 64 20 2a 70 48 61 6e 64 6c 65 29 7b 0a  void *pHandle){.
35520 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54    UNUSED_PARAMET
35530 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 64  ER(NotUsed);.  d
35540 6c 63 6c 6f 73 65 28 70 48 61 6e 64 6c 65 29 3b  lclose(pHandle);
35550 0a 7d 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 53  .}.#else /* if S
35560 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f  QLITE_OMIT_LOAD_
35570 45 58 54 45 4e 53 49 4f 4e 20 69 73 20 64 65 66  EXTENSION is def
35580 69 6e 65 64 3a 20 2a 2f 0a 20 20 23 64 65 66 69  ined: */.  #defi
35590 6e 65 20 75 6e 69 78 44 6c 4f 70 65 6e 20 20 30  ne unixDlOpen  0
355a0 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44  .  #define unixD
355b0 6c 45 72 72 6f 72 20 30 0a 20 20 23 64 65 66 69  lError 0.  #defi
355c0 6e 65 20 75 6e 69 78 44 6c 53 79 6d 20 20 20 30  ne unixDlSym   0
355d0 0a 20 20 23 64 65 66 69 6e 65 20 75 6e 69 78 44  .  #define unixD
355e0 6c 43 6c 6f 73 65 20 30 0a 23 65 6e 64 69 66 0a  lClose 0.#endif.
355f0 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 6e 42 75  ./*.** Write nBu
35600 66 20 62 79 74 65 73 20 6f 66 20 72 61 6e 64 6f  f bytes of rando
35610 6d 20 64 61 74 61 20 74 6f 20 74 68 65 20 73 75  m data to the su
35620 70 70 6c 69 65 64 20 62 75 66 66 65 72 20 7a 42  pplied buffer zB
35630 75 66 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  uf..*/.static in
35640 74 20 75 6e 69 78 52 61 6e 64 6f 6d 6e 65 73 73  t unixRandomness
35650 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f  (sqlite3_vfs *No
35660 74 55 73 65 64 2c 20 69 6e 74 20 6e 42 75 66 2c  tUsed, int nBuf,
35670 20 63 68 61 72 20 2a 7a 42 75 66 29 7b 0a 20 20   char *zBuf){.  
35680 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
35690 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 61 73 73  (NotUsed);.  ass
356a0 65 72 74 28 28 73 69 7a 65 5f 74 29 6e 42 75 66  ert((size_t)nBuf
356b0 3e 3d 28 73 69 7a 65 6f 66 28 74 69 6d 65 5f 74  >=(sizeof(time_t
356c0 29 2b 73 69 7a 65 6f 66 28 69 6e 74 29 29 29 3b  )+sizeof(int)));
356d0 0a 0a 20 20 2f 2a 20 57 65 20 68 61 76 65 20 74  ..  /* We have t
356e0 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 7a 42 75  o initialize zBu
356f0 66 20 74 6f 20 70 72 65 76 65 6e 74 20 76 61 6c  f to prevent val
35700 67 72 69 6e 64 20 66 72 6f 6d 20 72 65 70 6f 72  grind from repor
35710 74 69 6e 67 0a 20 20 2a 2a 20 65 72 72 6f 72 73  ting.  ** errors
35720 2e 20 20 54 68 65 20 72 65 70 6f 72 74 73 20 69  .  The reports i
35730 73 73 75 65 64 20 62 79 20 76 61 6c 67 72 69 6e  ssued by valgrin
35740 64 20 61 72 65 20 69 6e 63 6f 72 72 65 63 74 20  d are incorrect 
35750 2d 20 77 65 20 77 6f 75 6c 64 0a 20 20 2a 2a 20  - we would.  ** 
35760 70 72 65 66 65 72 20 74 68 61 74 20 74 68 65 20  prefer that the 
35770 72 61 6e 64 6f 6d 6e 65 73 73 20 62 65 20 69 6e  randomness be in
35780 63 72 65 61 73 65 64 20 62 79 20 6d 61 6b 69 6e  creased by makin
35790 67 20 75 73 65 20 6f 66 20 74 68 65 0a 20 20 2a  g use of the.  *
357a0 2a 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20  * uninitialized 
357b0 73 70 61 63 65 20 69 6e 20 7a 42 75 66 20 2d 20  space in zBuf - 
357c0 62 75 74 20 76 61 6c 67 72 69 6e 64 20 65 72 72  but valgrind err
357d0 6f 72 73 20 74 65 6e 64 20 74 6f 20 77 6f 72 72  ors tend to worr
357e0 79 0a 20 20 2a 2a 20 73 6f 6d 65 20 75 73 65 72  y.  ** some user
357f0 73 2e 20 20 52 61 74 68 65 72 20 74 68 61 6e 20  s.  Rather than 
35800 61 72 67 75 65 2c 20 69 74 20 73 65 65 6d 73 20  argue, it seems 
35810 65 61 73 69 65 72 20 6a 75 73 74 20 74 6f 20 69  easier just to i
35820 6e 69 74 69 61 6c 69 7a 65 0a 20 20 2a 2a 20 74  nitialize.  ** t
35830 68 65 20 77 68 6f 6c 65 20 61 72 72 61 79 20 61  he whole array a
35840 6e 64 20 73 69 6c 65 6e 63 65 20 76 61 6c 67 72  nd silence valgr
35850 69 6e 64 2c 20 65 76 65 6e 20 69 66 20 74 68 61  ind, even if tha
35860 74 20 6d 65 61 6e 73 20 6c 65 73 73 20 72 61 6e  t means less ran
35870 64 6f 6d 6e 65 73 73 0a 20 20 2a 2a 20 69 6e 20  domness.  ** in 
35880 74 68 65 20 72 61 6e 64 6f 6d 20 73 65 65 64 2e  the random seed.
35890 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20  .  **.  ** When 
358a0 74 65 73 74 69 6e 67 2c 20 69 6e 69 74 69 61 6c  testing, initial
358b0 69 7a 69 6e 67 20 7a 42 75 66 5b 5d 20 74 6f 20  izing zBuf[] to 
358c0 7a 65 72 6f 20 69 73 20 61 6c 6c 20 77 65 20 64  zero is all we d
358d0 6f 2e 20 20 54 68 61 74 20 6d 65 61 6e 73 0a 20  o.  That means. 
358e0 20 2a 2a 20 74 68 61 74 20 77 65 20 61 6c 77 61   ** that we alwa
358f0 79 73 20 75 73 65 20 74 68 65 20 73 61 6d 65 20  ys use the same 
35900 72 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 73 65  random number se
35910 71 75 65 6e 63 65 2e 20 20 54 68 69 73 20 6d 61  quence.  This ma
35920 6b 65 73 20 74 68 65 0a 20 20 2a 2a 20 74 65 73  kes the.  ** tes
35930 74 73 20 72 65 70 65 61 74 61 62 6c 65 2e 0a 20  ts repeatable.. 
35940 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 7a 42 75   */.  memset(zBu
35950 66 2c 20 30 2c 20 6e 42 75 66 29 3b 0a 20 20 72  f, 0, nBuf);.  r
35960 61 6e 64 6f 6d 6e 65 73 73 50 69 64 20 3d 20 6f  andomnessPid = o
35970 73 47 65 74 70 69 64 28 30 29 3b 20 20 0a 23 69  sGetpid(0);  .#i
35980 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54  f !defined(SQLIT
35990 45 5f 54 45 53 54 29 20 26 26 20 21 64 65 66 69  E_TEST) && !defi
359a0 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ned(SQLITE_OMIT_
359b0 52 41 4e 44 4f 4d 4e 45 53 53 29 0a 20 20 7b 0a  RANDOMNESS).  {.
359c0 20 20 20 20 69 6e 74 20 66 64 2c 20 67 6f 74 3b      int fd, got;
359d0 0a 20 20 20 20 66 64 20 3d 20 72 6f 62 75 73 74  .    fd = robust
359e0 5f 6f 70 65 6e 28 22 2f 64 65 76 2f 75 72 61 6e  _open("/dev/uran
359f0 64 6f 6d 22 2c 20 4f 5f 52 44 4f 4e 4c 59 2c 20  dom", O_RDONLY, 
35a00 30 29 3b 0a 20 20 20 20 69 66 28 20 66 64 3c 30  0);.    if( fd<0
35a10 20 29 7b 0a 20 20 20 20 20 20 74 69 6d 65 5f 74   ){.      time_t
35a20 20 74 3b 0a 20 20 20 20 20 20 74 69 6d 65 28 26   t;.      time(&
35a30 74 29 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79  t);.      memcpy
35a40 28 7a 42 75 66 2c 20 26 74 2c 20 73 69 7a 65 6f  (zBuf, &t, sizeo
35a50 66 28 74 29 29 3b 0a 20 20 20 20 20 20 6d 65 6d  f(t));.      mem
35a60 63 70 79 28 26 7a 42 75 66 5b 73 69 7a 65 6f 66  cpy(&zBuf[sizeof
35a70 28 74 29 5d 2c 20 26 72 61 6e 64 6f 6d 6e 65 73  (t)], &randomnes
35a80 73 50 69 64 2c 20 73 69 7a 65 6f 66 28 72 61 6e  sPid, sizeof(ran
35a90 64 6f 6d 6e 65 73 73 50 69 64 29 29 3b 0a 20 20  domnessPid));.  
35aa0 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65      assert( size
35ab0 6f 66 28 74 29 2b 73 69 7a 65 6f 66 28 72 61 6e  of(t)+sizeof(ran
35ac0 64 6f 6d 6e 65 73 73 50 69 64 29 3c 3d 28 73 69  domnessPid)<=(si
35ad0 7a 65 5f 74 29 6e 42 75 66 20 29 3b 0a 20 20 20  ze_t)nBuf );.   
35ae0 20 20 20 6e 42 75 66 20 3d 20 73 69 7a 65 6f 66     nBuf = sizeof
35af0 28 74 29 20 2b 20 73 69 7a 65 6f 66 28 72 61 6e  (t) + sizeof(ran
35b00 64 6f 6d 6e 65 73 73 50 69 64 29 3b 0a 20 20 20  domnessPid);.   
35b10 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 64 6f   }else{.      do
35b20 7b 20 67 6f 74 20 3d 20 6f 73 52 65 61 64 28 66  { got = osRead(f
35b30 64 2c 20 7a 42 75 66 2c 20 6e 42 75 66 29 3b 20  d, zBuf, nBuf); 
35b40 7d 77 68 69 6c 65 28 20 67 6f 74 3c 30 20 26 26  }while( got<0 &&
35b50 20 65 72 72 6e 6f 3d 3d 45 49 4e 54 52 20 29 3b   errno==EINTR );
35b60 0a 20 20 20 20 20 20 72 6f 62 75 73 74 5f 63 6c  .      robust_cl
35b70 6f 73 65 28 30 2c 20 66 64 2c 20 5f 5f 4c 49 4e  ose(0, fd, __LIN
35b80 45 5f 5f 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  E__);.    }.  }.
35b90 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20  #endif.  return 
35ba0 6e 42 75 66 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  nBuf;.}.../*.** 
35bb0 53 6c 65 65 70 20 66 6f 72 20 61 20 6c 69 74 74  Sleep for a litt
35bc0 6c 65 20 77 68 69 6c 65 2e 20 20 52 65 74 75 72  le while.  Retur
35bd0 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20  n the amount of 
35be0 74 69 6d 65 20 73 6c 65 70 74 2e 0a 2a 2a 20 54  time slept..** T
35bf0 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74  he argument is t
35c00 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 63  he number of mic
35c10 72 6f 73 65 63 6f 6e 64 73 20 77 65 20 77 61 6e  roseconds we wan
35c20 74 20 74 6f 20 73 6c 65 65 70 2e 0a 2a 2a 20 54  t to sleep..** T
35c30 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20  he return value 
35c40 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  is the number of
35c50 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 20 6f 66   microseconds of
35c60 20 73 6c 65 65 70 20 61 63 74 75 61 6c 6c 79 0a   sleep actually.
35c70 2a 2a 20 72 65 71 75 65 73 74 65 64 20 66 72 6f  ** requested fro
35c80 6d 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67  m the underlying
35c90 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
35ca0 6d 2c 20 61 20 6e 75 6d 62 65 72 20 77 68 69 63  m, a number whic
35cb0 68 0a 2a 2a 20 6d 69 67 68 74 20 62 65 20 67 72  h.** might be gr
35cc0 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71  eater than or eq
35cd0 75 61 6c 20 74 6f 20 74 68 65 20 61 72 67 75 6d  ual to the argum
35ce0 65 6e 74 2c 20 62 75 74 20 6e 6f 74 20 6c 65 73  ent, but not les
35cf0 73 0a 2a 2a 20 74 68 61 6e 20 74 68 65 20 61 72  s.** than the ar
35d00 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69  gument..*/.stati
35d10 63 20 69 6e 74 20 75 6e 69 78 53 6c 65 65 70 28  c int unixSleep(
35d20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74  sqlite3_vfs *Not
35d30 55 73 65 64 2c 20 69 6e 74 20 6d 69 63 72 6f 73  Used, int micros
35d40 65 63 6f 6e 64 73 29 7b 0a 23 69 66 20 4f 53 5f  econds){.#if OS_
35d50 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 75 63 74  VXWORKS.  struct
35d60 20 74 69 6d 65 73 70 65 63 20 73 70 3b 0a 0a 20   timespec sp;.. 
35d70 20 73 70 2e 74 76 5f 73 65 63 20 3d 20 6d 69 63   sp.tv_sec = mic
35d80 72 6f 73 65 63 6f 6e 64 73 20 2f 20 31 30 30 30  roseconds / 1000
35d90 30 30 30 3b 0a 20 20 73 70 2e 74 76 5f 6e 73 65  000;.  sp.tv_nse
35da0 63 20 3d 20 28 6d 69 63 72 6f 73 65 63 6f 6e 64  c = (microsecond
35db0 73 20 25 20 31 30 30 30 30 30 30 29 20 2a 20 31  s % 1000000) * 1
35dc0 30 30 30 3b 0a 20 20 6e 61 6e 6f 73 6c 65 65 70  000;.  nanosleep
35dd0 28 26 73 70 2c 20 4e 55 4c 4c 29 3b 0a 20 20 55  (&sp, NULL);.  U
35de0 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28  NUSED_PARAMETER(
35df0 4e 6f 74 55 73 65 64 29 3b 0a 20 20 72 65 74 75  NotUsed);.  retu
35e00 72 6e 20 6d 69 63 72 6f 73 65 63 6f 6e 64 73 3b  rn microseconds;
35e10 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 48  .#elif defined(H
35e20 41 56 45 5f 55 53 4c 45 45 50 29 20 26 26 20 48  AVE_USLEEP) && H
35e30 41 56 45 5f 55 53 4c 45 45 50 0a 20 20 75 73 6c  AVE_USLEEP.  usl
35e40 65 65 70 28 6d 69 63 72 6f 73 65 63 6f 6e 64 73  eep(microseconds
35e50 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41  );.  UNUSED_PARA
35e60 4d 45 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a  METER(NotUsed);.
35e70 20 20 72 65 74 75 72 6e 20 6d 69 63 72 6f 73 65    return microse
35e80 63 6f 6e 64 73 3b 0a 23 65 6c 73 65 0a 20 20 69  conds;.#else.  i
35e90 6e 74 20 73 65 63 6f 6e 64 73 20 3d 20 28 6d 69  nt seconds = (mi
35ea0 63 72 6f 73 65 63 6f 6e 64 73 2b 39 39 39 39 39  croseconds+99999
35eb0 39 29 2f 31 30 30 30 30 30 30 3b 0a 20 20 73 6c  9)/1000000;.  sl
35ec0 65 65 70 28 73 65 63 6f 6e 64 73 29 3b 0a 20 20  eep(seconds);.  
35ed0 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
35ee0 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 72 65 74  (NotUsed);.  ret
35ef0 75 72 6e 20 73 65 63 6f 6e 64 73 2a 31 30 30 30  urn seconds*1000
35f00 30 30 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  000;.#endif.}../
35f10 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
35f20 6e 67 20 76 61 72 69 61 62 6c 65 2c 20 69 66 20  ng variable, if 
35f30 73 65 74 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72  set to a non-zer
35f40 6f 20 76 61 6c 75 65 2c 20 69 73 20 69 6e 74 65  o value, is inte
35f50 72 70 72 65 74 65 64 20 61 73 0a 2a 2a 20 74 68  rpreted as.** th
35f60 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 63 6f  e number of seco
35f70 6e 64 73 20 73 69 6e 63 65 20 31 39 37 30 20 61  nds since 1970 a
35f80 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 73 65  nd is used to se
35f90 74 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 0a  t the result of.
35fa0 2a 2a 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72  ** sqlite3OsCurr
35fb0 65 6e 74 54 69 6d 65 28 29 20 64 75 72 69 6e 67  entTime() during
35fc0 20 74 65 73 74 69 6e 67 2e 0a 2a 2f 0a 23 69 66   testing..*/.#if
35fd0 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
35fe0 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 75 72 72  int sqlite3_curr
35ff0 65 6e 74 5f 74 69 6d 65 20 3d 20 30 3b 20 20 2f  ent_time = 0;  /
36000 2a 20 46 61 6b 65 20 73 79 73 74 65 6d 20 74 69  * Fake system ti
36010 6d 65 20 69 6e 20 73 65 63 6f 6e 64 73 20 73 69  me in seconds si
36020 6e 63 65 20 31 39 37 30 2e 20 2a 2f 0a 23 65 6e  nce 1970. */.#en
36030 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20  dif../*.** Find 
36040 74 68 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65  the current time
36050 20 28 69 6e 20 55 6e 69 76 65 72 73 61 6c 20 43   (in Universal C
36060 6f 6f 72 64 69 6e 61 74 65 64 20 54 69 6d 65 29  oordinated Time)
36070 2e 20 20 57 72 69 74 65 20 69 6e 74 6f 20 2a 70  .  Write into *p
36080 69 4e 6f 77 0a 2a 2a 20 74 68 65 20 63 75 72 72  iNow.** the curr
36090 65 6e 74 20 74 69 6d 65 20 61 6e 64 20 64 61 74  ent time and dat
360a0 65 20 61 73 20 61 20 4a 75 6c 69 61 6e 20 44 61  e as a Julian Da
360b0 79 20 6e 75 6d 62 65 72 20 74 69 6d 65 73 20 38  y number times 8
360c0 36 5f 34 30 30 5f 30 30 30 2e 20 20 49 6e 0a 2a  6_400_000.  In.*
360d0 2a 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 77  * other words, w
360e0 72 69 74 65 20 69 6e 74 6f 20 2a 70 69 4e 6f 77  rite into *piNow
360f0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d   the number of m
36100 69 6c 6c 69 73 65 63 6f 6e 64 73 20 73 69 6e 63  illiseconds sinc
36110 65 20 74 68 65 20 4a 75 6c 69 61 6e 0a 2a 2a 20  e the Julian.** 
36120 65 70 6f 63 68 20 6f 66 20 6e 6f 6f 6e 20 69 6e  epoch of noon in
36130 20 47 72 65 65 6e 77 69 63 68 20 6f 6e 20 4e 6f   Greenwich on No
36140 76 65 6d 62 65 72 20 32 34 2c 20 34 37 31 34 20  vember 24, 4714 
36150 42 2e 43 20 61 63 63 6f 72 64 69 6e 67 20 74 6f  B.C according to
36160 20 74 68 65 0a 2a 2a 20 70 72 6f 6c 65 70 74 69   the.** prolepti
36170 63 20 47 72 65 67 6f 72 69 61 6e 20 63 61 6c 65  c Gregorian cale
36180 6e 64 61 72 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73  ndar..**.** On s
36190 75 63 63 65 73 73 2c 20 72 65 74 75 72 6e 20 53  uccess, return S
361a0 51 4c 49 54 45 5f 4f 4b 2e 20 20 52 65 74 75 72  QLITE_OK.  Retur
361b0 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 69  n SQLITE_ERROR i
361c0 66 20 74 68 65 20 74 69 6d 65 20 61 6e 64 20 64  f the time and d
361d0 61 74 65 20 0a 2a 2a 20 63 61 6e 6e 6f 74 20 62  ate .** cannot b
361e0 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 61 74  e found..*/.stat
361f0 69 63 20 69 6e 74 20 75 6e 69 78 43 75 72 72 65  ic int unixCurre
36200 6e 74 54 69 6d 65 49 6e 74 36 34 28 73 71 6c 69  ntTimeInt64(sqli
36210 74 65 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64  te3_vfs *NotUsed
36220 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20  , sqlite3_int64 
36230 2a 70 69 4e 6f 77 29 7b 0a 20 20 73 74 61 74 69  *piNow){.  stati
36240 63 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f  c const sqlite3_
36250 69 6e 74 36 34 20 75 6e 69 78 45 70 6f 63 68 20  int64 unixEpoch 
36260 3d 20 32 34 34 30 35 38 37 35 2a 28 73 71 6c 69  = 24405875*(sqli
36270 74 65 33 5f 69 6e 74 36 34 29 38 36 34 30 30 30  te3_int64)864000
36280 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  0;.  int rc = SQ
36290 4c 49 54 45 5f 4f 4b 3b 0a 23 69 66 20 64 65 66  LITE_OK;.#if def
362a0 69 6e 65 64 28 4e 4f 5f 47 45 54 54 4f 44 29 0a  ined(NO_GETTOD).
362b0 20 20 74 69 6d 65 5f 74 20 74 3b 0a 20 20 74 69    time_t t;.  ti
362c0 6d 65 28 26 74 29 3b 0a 20 20 2a 70 69 4e 6f 77  me(&t);.  *piNow
362d0 20 3d 20 28 28 73 71 6c 69 74 65 33 5f 69 6e 74   = ((sqlite3_int
362e0 36 34 29 74 29 2a 31 30 30 30 20 2b 20 75 6e 69  64)t)*1000 + uni
362f0 78 45 70 6f 63 68 3b 0a 23 65 6c 69 66 20 4f 53  xEpoch;.#elif OS
36300 5f 56 58 57 4f 52 4b 53 0a 20 20 73 74 72 75 63  _VXWORKS.  struc
36310 74 20 74 69 6d 65 73 70 65 63 20 73 4e 6f 77 3b  t timespec sNow;
36320 0a 20 20 63 6c 6f 63 6b 5f 67 65 74 74 69 6d 65  .  clock_gettime
36330 28 43 4c 4f 43 4b 5f 52 45 41 4c 54 49 4d 45 2c  (CLOCK_REALTIME,
36340 20 26 73 4e 6f 77 29 3b 0a 20 20 2a 70 69 4e 6f   &sNow);.  *piNo
36350 77 20 3d 20 75 6e 69 78 45 70 6f 63 68 20 2b 20  w = unixEpoch + 
36360 31 30 30 30 2a 28 73 71 6c 69 74 65 33 5f 69 6e  1000*(sqlite3_in
36370 74 36 34 29 73 4e 6f 77 2e 74 76 5f 73 65 63 20  t64)sNow.tv_sec 
36380 2b 20 73 4e 6f 77 2e 74 76 5f 6e 73 65 63 2f 31  + sNow.tv_nsec/1
36390 30 30 30 30 30 30 3b 0a 23 65 6c 73 65 0a 20 20  000000;.#else.  
363a0 73 74 72 75 63 74 20 74 69 6d 65 76 61 6c 20 73  struct timeval s
363b0 4e 6f 77 3b 0a 20 20 28 76 6f 69 64 29 67 65 74  Now;.  (void)get
363c0 74 69 6d 65 6f 66 64 61 79 28 26 73 4e 6f 77 2c  timeofday(&sNow,
363d0 20 30 29 3b 20 20 2f 2a 20 43 61 6e 6e 6f 74 20   0);  /* Cannot 
363e0 66 61 69 6c 20 67 69 76 65 6e 20 76 61 6c 69 64  fail given valid
363f0 20 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20   arguments */.  
36400 2a 70 69 4e 6f 77 20 3d 20 75 6e 69 78 45 70 6f  *piNow = unixEpo
36410 63 68 20 2b 20 31 30 30 30 2a 28 73 71 6c 69 74  ch + 1000*(sqlit
36420 65 33 5f 69 6e 74 36 34 29 73 4e 6f 77 2e 74 76  e3_int64)sNow.tv
36430 5f 73 65 63 20 2b 20 73 4e 6f 77 2e 74 76 5f 75  _sec + sNow.tv_u
36440 73 65 63 2f 31 30 30 30 3b 0a 23 65 6e 64 69 66  sec/1000;.#endif
36450 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
36460 54 45 53 54 0a 20 20 69 66 28 20 73 71 6c 69 74  TEST.  if( sqlit
36470 65 33 5f 63 75 72 72 65 6e 74 5f 74 69 6d 65 20  e3_current_time 
36480 29 7b 0a 20 20 20 20 2a 70 69 4e 6f 77 20 3d 20  ){.    *piNow = 
36490 31 30 30 30 2a 28 73 71 6c 69 74 65 33 5f 69 6e  1000*(sqlite3_in
364a0 74 36 34 29 73 71 6c 69 74 65 33 5f 63 75 72 72  t64)sqlite3_curr
364b0 65 6e 74 5f 74 69 6d 65 20 2b 20 75 6e 69 78 45  ent_time + unixE
364c0 70 6f 63 68 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  poch;.  }.#endif
364d0 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45  .  UNUSED_PARAME
364e0 54 45 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20  TER(NotUsed);.  
364f0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69  return rc;.}..#i
36500 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
36510 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a  T_DEPRECATED./*.
36520 2a 2a 20 46 69 6e 64 20 74 68 65 20 63 75 72 72  ** Find the curr
36530 65 6e 74 20 74 69 6d 65 20 28 69 6e 20 55 6e 69  ent time (in Uni
36540 76 65 72 73 61 6c 20 43 6f 6f 72 64 69 6e 61 74  versal Coordinat
36550 65 64 20 54 69 6d 65 29 2e 20 20 57 72 69 74 65  ed Time).  Write
36560 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20   the.** current 
36570 74 69 6d 65 20 61 6e 64 20 64 61 74 65 20 61 73  time and date as
36580 20 61 20 4a 75 6c 69 61 6e 20 44 61 79 20 6e 75   a Julian Day nu
36590 6d 62 65 72 20 69 6e 74 6f 20 2a 70 72 4e 6f 77  mber into *prNow
365a0 20 61 6e 64 0a 2a 2a 20 72 65 74 75 72 6e 20 30   and.** return 0
365b0 2e 20 20 52 65 74 75 72 6e 20 31 20 69 66 20 74  .  Return 1 if t
365c0 68 65 20 74 69 6d 65 20 61 6e 64 20 64 61 74 65  he time and date
365d0 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64   cannot be found
365e0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
365f0 75 6e 69 78 43 75 72 72 65 6e 74 54 69 6d 65 28  unixCurrentTime(
36600 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 4e 6f 74  sqlite3_vfs *Not
36610 55 73 65 64 2c 20 64 6f 75 62 6c 65 20 2a 70 72  Used, double *pr
36620 4e 6f 77 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  Now){.  sqlite3_
36630 69 6e 74 36 34 20 69 20 3d 20 30 3b 0a 20 20 69  int64 i = 0;.  i
36640 6e 74 20 72 63 3b 0a 20 20 55 4e 55 53 45 44 5f  nt rc;.  UNUSED_
36650 50 41 52 41 4d 45 54 45 52 28 4e 6f 74 55 73 65  PARAMETER(NotUse
36660 64 29 3b 0a 20 20 72 63 20 3d 20 75 6e 69 78 43  d);.  rc = unixC
36670 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36 34 28  urrentTimeInt64(
36680 30 2c 20 26 69 29 3b 0a 20 20 2a 70 72 4e 6f 77  0, &i);.  *prNow
36690 20 3d 20 69 2f 38 36 34 30 30 30 30 30 2e 30 3b   = i/86400000.0;
366a0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
366b0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 75  #else.# define u
366c0 6e 69 78 43 75 72 72 65 6e 74 54 69 6d 65 20 30  nixCurrentTime 0
366d0 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54  .#endif../*.** T
366e0 68 65 20 78 47 65 74 4c 61 73 74 45 72 72 6f 72  he xGetLastError
366f0 28 29 20 6d 65 74 68 6f 64 20 69 73 20 64 65 73  () method is des
36700 69 67 6e 65 64 20 74 6f 20 72 65 74 75 72 6e 20  igned to return 
36710 61 20 62 65 74 74 65 72 0a 2a 2a 20 6c 6f 77 2d  a better.** low-
36720 6c 65 76 65 6c 20 65 72 72 6f 72 20 6d 65 73 73  level error mess
36730 61 67 65 20 77 68 65 6e 20 6f 70 65 72 61 74 69  age when operati
36740 6e 67 2d 73 79 73 74 65 6d 20 70 72 6f 62 6c 65  ng-system proble
36750 6d 73 20 63 6f 6d 65 20 75 70 0a 2a 2a 20 64 75  ms come up.** du
36760 72 69 6e 67 20 53 51 4c 69 74 65 20 6f 70 65 72  ring SQLite oper
36770 61 74 69 6f 6e 2e 20 20 4f 6e 6c 79 20 74 68 65  ation.  Only the
36780 20 69 6e 74 65 67 65 72 20 72 65 74 75 72 6e 20   integer return 
36790 63 6f 64 65 20 69 73 20 63 75 72 72 65 6e 74 6c  code is currentl
367a0 79 0a 2a 2a 20 75 73 65 64 2e 0a 2a 2f 0a 73 74  y.** used..*/.st
367b0 61 74 69 63 20 69 6e 74 20 75 6e 69 78 47 65 74  atic int unixGet
367c0 4c 61 73 74 45 72 72 6f 72 28 73 71 6c 69 74 65  LastError(sqlite
367d0 33 5f 76 66 73 20 2a 4e 6f 74 55 73 65 64 2c 20  3_vfs *NotUsed, 
367e0 69 6e 74 20 4e 6f 74 55 73 65 64 32 2c 20 63 68  int NotUsed2, ch
367f0 61 72 20 2a 4e 6f 74 55 73 65 64 33 29 7b 0a 20  ar *NotUsed3){. 
36800 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45   UNUSED_PARAMETE
36810 52 28 4e 6f 74 55 73 65 64 29 3b 0a 20 20 55 4e  R(NotUsed);.  UN
36820 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e  USED_PARAMETER(N
36830 6f 74 55 73 65 64 32 29 3b 0a 20 20 55 4e 55 53  otUsed2);.  UNUS
36840 45 44 5f 50 41 52 41 4d 45 54 45 52 28 4e 6f 74  ED_PARAMETER(Not
36850 55 73 65 64 33 29 3b 0a 20 20 72 65 74 75 72 6e  Used3);.  return
36860 20 65 72 72 6e 6f 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a   errno;.}.../*.*
36870 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36880 2a 2a 2a 2a 2a 2a 2a 20 45 6e 64 20 6f 66 20 73  ******* End of s
36890 71 6c 69 74 65 33 5f 76 66 73 20 6d 65 74 68 6f  qlite3_vfs metho
368a0 64 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ds *************
368b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
368c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
368d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
368e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
368f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36900 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a  *************/..
36910 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
36920 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36930 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36940 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36950 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a  ***************.
36960 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
36970 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 42 65 67 69 6e  ********** Begin
36980 20 50 72 6f 78 79 20 4c 6f 63 6b 69 6e 67 20 2a   Proxy Locking *
36990 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
369a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a  ***************.
369b0 2a 2a 0a 2a 2a 20 50 72 6f 78 79 20 6c 6f 63 6b  **.** Proxy lock
369c0 69 6e 67 20 69 73 20 61 20 22 75 62 65 72 2d 6c  ing is a "uber-l
369d0 6f 63 6b 69 6e 67 2d 6d 65 74 68 6f 64 22 20 69  ocking-method" i
369e0 6e 20 74 68 69 73 20 73 65 6e 73 65 3a 20 20 49  n this sense:  I
369f0 74 20 75 73 65 73 20 74 68 65 0a 2a 2a 20 6f 74  t uses the.** ot
36a00 68 65 72 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68  her locking meth
36a10 6f 64 73 20 6f 6e 20 73 65 63 6f 6e 64 61 72 79  ods on secondary
36a20 20 6c 6f 63 6b 20 66 69 6c 65 73 2e 20 20 50 72   lock files.  Pr
36a30 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 69 73 20 61  oxy locking is a
36a40 0a 2a 2a 20 6d 65 74 61 2d 6c 61 79 65 72 20 6f  .** meta-layer o
36a50 76 65 72 20 74 6f 70 20 6f 66 20 74 68 65 20 70  ver top of the p
36a60 72 69 6d 69 74 69 76 65 20 6c 6f 63 6b 69 6e 67  rimitive locking
36a70 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 62 6f   implemented abo
36a80 76 65 2e 20 20 46 6f 72 0a 2a 2a 20 74 68 69 73  ve.  For.** this
36a90 20 72 65 61 73 6f 6e 2c 20 74 68 65 20 64 69 76   reason, the div
36aa0 69 73 69 6f 6e 20 74 68 61 74 20 69 6d 70 6c 65  ision that imple
36ab0 6d 65 6e 74 73 20 6f 66 20 70 72 6f 78 79 20 6c  ments of proxy l
36ac0 6f 63 6b 69 6e 67 20 69 73 20 64 65 66 65 72 72  ocking is deferr
36ad0 65 64 0a 2a 2a 20 75 6e 74 69 6c 20 6c 61 74 65  ed.** until late
36ae0 20 69 6e 20 74 68 65 20 66 69 6c 65 20 28 68 65   in the file (he
36af0 72 65 29 20 61 66 74 65 72 20 61 6c 6c 20 6f 66  re) after all of
36b00 20 74 68 65 20 6f 74 68 65 72 20 49 2f 4f 20 6d   the other I/O m
36b10 65 74 68 6f 64 73 20 68 61 76 65 0a 2a 2a 20 62  ethods have.** b
36b20 65 65 6e 20 64 65 66 69 6e 65 64 20 2d 20 73 6f  een defined - so
36b30 20 74 68 61 74 20 74 68 65 20 70 72 69 6d 69 74   that the primit
36b40 69 76 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 74 68  ive locking meth
36b50 6f 64 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c  ods are availabl
36b60 65 0a 2a 2a 20 61 73 20 73 65 72 76 69 63 65 73  e.** as services
36b70 20 74 6f 20 68 65 6c 70 20 77 69 74 68 20 74 68   to help with th
36b80 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
36b90 20 6f 66 20 70 72 6f 78 79 20 6c 6f 63 6b 69 6e   of proxy lockin
36ba0 67 2e 0a 2a 2a 0a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a  g..**.****.**.**
36bb0 20 54 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63   The default loc
36bc0 6b 69 6e 67 20 73 63 68 65 6d 65 73 20 69 6e 20  king schemes in 
36bd0 53 51 4c 69 74 65 20 75 73 65 20 62 79 74 65 2d  SQLite use byte-
36be0 72 61 6e 67 65 20 6c 6f 63 6b 73 20 6f 6e 20 74  range locks on t
36bf0 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66  he.** database f
36c00 69 6c 65 20 74 6f 20 63 6f 6f 72 64 69 6e 61 74  ile to coordinat
36c10 65 20 73 61 66 65 2c 20 63 6f 6e 63 75 72 72 65  e safe, concurre
36c20 6e 74 20 61 63 63 65 73 73 20 62 79 20 6d 75 6c  nt access by mul
36c30 74 69 70 6c 65 20 72 65 61 64 65 72 73 0a 2a 2a  tiple readers.**
36c40 20 61 6e 64 20 77 72 69 74 65 72 73 20 5b 68 74   and writers [ht
36c50 74 70 3a 2f 2f 73 71 6c 69 74 65 2e 6f 72 67 2f  tp://sqlite.org/
36c60 6c 6f 63 6b 69 6e 67 76 33 2e 68 74 6d 6c 5d 2e  lockingv3.html].
36c70 20 20 54 68 65 20 66 69 76 65 20 66 69 6c 65 20    The five file 
36c80 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 73 74 61 74 65  locking.** state
36c90 73 20 28 55 4e 4c 4f 43 4b 45 44 2c 20 50 45 4e  s (UNLOCKED, PEN
36ca0 44 49 4e 47 2c 20 53 48 41 52 45 44 2c 20 52 45  DING, SHARED, RE
36cb0 53 45 52 56 45 44 2c 20 45 58 43 4c 55 53 49 56  SERVED, EXCLUSIV
36cc0 45 29 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74  E) are implement
36cd0 65 64 0a 2a 2a 20 61 73 20 50 4f 53 49 58 20 72  ed.** as POSIX r
36ce0 65 61 64 20 26 20 77 72 69 74 65 20 6c 6f 63 6b  ead & write lock
36cf0 73 20 6f 76 65 72 20 66 69 78 65 64 20 73 65 74  s over fixed set
36d00 20 6f 66 20 6c 6f 63 61 74 69 6f 6e 73 20 28 76   of locations (v
36d10 69 61 20 66 73 63 74 6c 29 2c 0a 2a 2a 20 6f 6e  ia fsctl),.** on
36d20 20 41 46 50 20 61 6e 64 20 53 4d 42 20 6f 6e 6c   AFP and SMB onl
36d30 79 20 65 78 63 6c 75 73 69 76 65 20 62 79 74 65  y exclusive byte
36d40 2d 72 61 6e 67 65 20 6c 6f 63 6b 73 20 61 72 65  -range locks are
36d50 20 61 76 61 69 6c 61 62 6c 65 20 76 69 61 20 66   available via f
36d60 73 63 74 6c 0a 2a 2a 20 77 69 74 68 20 5f 49 4f  sctl.** with _IO
36d70 57 52 28 27 7a 27 2c 20 32 33 2c 20 73 74 72 75  WR('z', 23, stru
36d80 63 74 20 42 79 74 65 52 61 6e 67 65 4c 6f 63 6b  ct ByteRangeLock
36d90 50 42 32 29 20 74 6f 20 74 72 61 63 6b 20 74 68  PB2) to track th
36da0 65 20 73 61 6d 65 20 35 20 73 74 61 74 65 73 2e  e same 5 states.
36db0 0a 2a 2a 20 54 6f 20 73 69 6d 75 6c 61 74 65 20  .** To simulate 
36dc0 61 20 46 5f 52 44 4c 43 4b 20 6f 6e 20 74 68 65  a F_RDLCK on the
36dd0 20 73 68 61 72 65 64 20 72 61 6e 67 65 2c 20 6f   shared range, o
36de0 6e 20 41 46 50 20 61 20 72 61 6e 64 6f 6d 6c 79  n AFP a randomly
36df0 20 73 65 6c 65 63 74 65 64 0a 2a 2a 20 61 64 64   selected.** add
36e00 72 65 73 73 20 69 6e 20 74 68 65 20 73 68 61 72  ress in the shar
36e10 65 64 20 72 61 6e 67 65 20 69 73 20 74 61 6b 65  ed range is take
36e20 6e 20 66 6f 72 20 61 20 53 48 41 52 45 44 20 6c  n for a SHARED l
36e30 6f 63 6b 2c 20 74 68 65 20 65 6e 74 69 72 65 0a  ock, the entire.
36e40 2a 2a 20 73 68 61 72 65 64 20 72 61 6e 67 65 20  ** shared range 
36e50 69 73 20 74 61 6b 65 6e 20 66 6f 72 20 61 6e 20  is taken for an 
36e60 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 29 3a  EXCLUSIVE lock):
36e70 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 50 45 4e 44  .**.**      PEND
36e80 49 4e 47 5f 42 59 54 45 20 20 20 20 20 20 20 20  ING_BYTE        
36e90 30 78 34 30 30 30 30 30 30 30 0a 2a 2a 20 20 20  0x40000000.**   
36ea0 20 20 20 52 45 53 45 52 56 45 44 5f 42 59 54 45     RESERVED_BYTE
36eb0 20 20 20 20 20 20 20 30 78 34 30 30 30 30 30 30         0x4000000
36ec0 31 0a 2a 2a 20 20 20 20 20 20 53 48 41 52 45 44  1.**      SHARED
36ed0 5f 52 41 4e 47 45 20 20 20 20 20 20 20 20 30 78  _RANGE        0x
36ee0 34 30 30 30 30 30 30 32 20 2d 3e 20 30 78 34 30  40000002 -> 0x40
36ef0 30 30 30 32 30 30 0a 2a 2a 0a 2a 2a 20 54 68 69  000200.**.** Thi
36f00 73 20 77 6f 72 6b 73 20 77 65 6c 6c 20 6f 6e 20  s works well on 
36f10 74 68 65 20 6c 6f 63 61 6c 20 66 69 6c 65 20 73  the local file s
36f20 79 73 74 65 6d 2c 20 62 75 74 20 73 68 6f 77 73  ystem, but shows
36f30 20 61 20 6e 65 61 72 6c 79 20 31 30 30 78 0a 2a   a nearly 100x.*
36f40 2a 20 73 6c 6f 77 64 6f 77 6e 20 69 6e 20 72 65  * slowdown in re
36f50 61 64 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 6f  ad performance o
36f60 6e 20 41 46 50 20 62 65 63 61 75 73 65 20 74 68  n AFP because th
36f70 65 20 41 46 50 20 63 6c 69 65 6e 74 20 64 69 73  e AFP client dis
36f80 61 62 6c 65 73 0a 2a 2a 20 74 68 65 20 72 65 61  ables.** the rea
36f90 64 20 63 61 63 68 65 20 77 68 65 6e 20 62 79 74  d cache when byt
36fa0 65 2d 72 61 6e 67 65 20 6c 6f 63 6b 73 20 61 72  e-range locks ar
36fb0 65 20 70 72 65 73 65 6e 74 2e 20 20 45 6e 61 62  e present.  Enab
36fc0 6c 69 6e 67 20 74 68 65 20 72 65 61 64 0a 2a 2a  ling the read.**
36fd0 20 63 61 63 68 65 20 65 78 70 6f 73 65 73 20 61   cache exposes a
36fe0 20 63 61 63 68 65 20 63 6f 68 65 72 65 6e 63 79   cache coherency
36ff0 20 70 72 6f 62 6c 65 6d 20 74 68 61 74 20 69 73   problem that is
37000 20 70 72 65 73 65 6e 74 20 6f 6e 20 61 6c 6c 20   present on all 
37010 4f 53 20 58 0a 2a 2a 20 73 75 70 70 6f 72 74 65  OS X.** supporte
37020 64 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20 73  d network file s
37030 79 73 74 65 6d 73 2e 20 20 4e 46 53 20 61 6e 64  ystems.  NFS and
37040 20 41 46 50 20 62 6f 74 68 20 6f 62 73 65 72 76   AFP both observ
37050 65 20 74 68 65 0a 2a 2a 20 63 6c 6f 73 65 2d 74  e the.** close-t
37060 6f 2d 6f 70 65 6e 20 73 65 6d 61 6e 74 69 63 73  o-open semantics
37070 20 66 6f 72 20 65 6e 73 75 72 69 6e 67 20 63 61   for ensuring ca
37080 63 68 65 20 63 6f 68 65 72 65 6e 63 79 0a 2a 2a  che coherency.**
37090 20 5b 68 74 74 70 3a 2f 2f 6e 66 73 2e 73 6f 75   [http://nfs.sou
370a0 72 63 65 66 6f 72 67 65 2e 6e 65 74 2f 23 66 61  rceforge.net/#fa
370b0 71 5f 61 38 5d 2c 20 77 68 69 63 68 20 64 6f 65  q_a8], which doe
370c0 73 20 6e 6f 74 20 65 66 66 65 63 74 69 76 65 6c  s not effectivel
370d0 79 0a 2a 2a 20 61 64 64 72 65 73 73 20 74 68 65  y.** address the
370e0 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 66 6f   requirements fo
370f0 72 20 63 6f 6e 63 75 72 72 65 6e 74 20 64 61 74  r concurrent dat
37100 61 62 61 73 65 20 61 63 63 65 73 73 20 62 79 20  abase access by 
37110 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20 72 65 61 64  multiple.** read
37120 65 72 73 20 61 6e 64 20 77 72 69 74 65 72 73 0a  ers and writers.
37130 2a 2a 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 6e  ** [http://www.n
37140 61 62 62 6c 65 2e 63 6f 6d 2f 53 51 4c 69 74 65  abble.com/SQLite
37150 2d 6f 6e 2d 4e 46 53 2d 63 61 63 68 65 2d 63 6f  -on-NFS-cache-co
37160 68 65 72 65 6e 63 79 2d 74 64 31 35 36 35 35 37  herency-td156557
37170 30 31 2e 68 74 6d 6c 5d 2e 0a 2a 2a 0a 2a 2a 20  01.html]..**.** 
37180 54 6f 20 61 64 64 72 65 73 73 20 74 68 65 20 70  To address the p
37190 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e 64 20 63  erformance and c
371a0 61 63 68 65 20 63 6f 68 65 72 65 6e 63 79 20 69  ache coherency i
371b0 73 73 75 65 73 2c 20 70 72 6f 78 79 20 66 69 6c  ssues, proxy fil
371c0 65 20 6c 6f 63 6b 69 6e 67 0a 2a 2a 20 63 68 61  e locking.** cha
371d0 6e 67 65 73 20 74 68 65 20 77 61 79 20 64 61 74  nges the way dat
371e0 61 62 61 73 65 20 61 63 63 65 73 73 20 69 73 20  abase access is 
371f0 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 20 6c 69  controlled by li
37200 6d 69 74 69 6e 67 20 61 63 63 65 73 73 20 74 6f  miting access to
37210 20 61 0a 2a 2a 20 73 69 6e 67 6c 65 20 68 6f 73   a.** single hos
37220 74 20 61 74 20 61 20 74 69 6d 65 20 61 6e 64 20  t at a time and 
37230 6d 6f 76 69 6e 67 20 66 69 6c 65 20 6c 6f 63 6b  moving file lock
37240 73 20 6f 66 66 20 6f 66 20 74 68 65 20 64 61 74  s off of the dat
37250 61 62 61 73 65 20 66 69 6c 65 0a 2a 2a 20 61 6e  abase file.** an
37260 64 20 6f 6e 74 6f 20 61 20 70 72 6f 78 79 20 66  d onto a proxy f
37270 69 6c 65 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c  ile on the local
37280 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 20 20 0a   file system.  .
37290 2a 2a 0a 2a 2a 0a 2a 2a 20 55 73 69 6e 67 20 70  **.**.** Using p
372a0 72 6f 78 79 20 6c 6f 63 6b 73 0a 2a 2a 20 2d 2d  roxy locks.** --
372b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a  ---------------.
372c0 2a 2a 0a 2a 2a 20 43 20 41 50 49 73 0a 2a 2a 0a  **.** C APIs.**.
372d0 2a 2a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65  **  sqlite3_file
372e0 5f 63 6f 6e 74 72 6f 6c 28 64 62 2c 20 64 62 6e  _control(db, dbn
372f0 61 6d 65 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54  ame, SQLITE_FCNT
37300 4c 5f 53 45 54 5f 4c 4f 43 4b 50 52 4f 58 59 46  L_SET_LOCKPROXYF
37310 49 4c 45 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20  ILE,.**         
37320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3c 70                <p
37330 72 6f 78 79 5f 70 61 74 68 3e 20 7c 20 22 3a 61  roxy_path> | ":a
37340 75 74 6f 3a 22 29 3b 0a 2a 2a 20 20 73 71 6c 69  uto:");.**  sqli
37350 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c  te3_file_control
37360 28 64 62 2c 20 64 62 6e 61 6d 65 2c 20 53 51 4c  (db, dbname, SQL
37370 49 54 45 5f 46 43 4e 54 4c 5f 47 45 54 5f 4c 4f  ITE_FCNTL_GET_LO
37380 43 4b 50 52 4f 58 59 46 49 4c 45 2c 0a 2a 2a 20  CKPROXYFILE,.** 
37390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
373a0 20 20 20 20 20 20 26 3c 70 72 6f 78 79 5f 70 61        &<proxy_pa
373b0 74 68 3e 29 3b 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 53  th>);.**.**.** S
373c0 51 4c 20 70 72 61 67 6d 61 73 0a 2a 2a 0a 2a 2a  QL pragmas.**.**
373d0 20 20 50 52 41 47 4d 41 20 5b 64 61 74 61 62 61    PRAGMA [databa
373e0 73 65 2e 5d 6c 6f 63 6b 5f 70 72 6f 78 79 5f 66  se.]lock_proxy_f
373f0 69 6c 65 3d 3c 70 72 6f 78 79 5f 70 61 74 68 3e  ile=<proxy_path>
37400 20 7c 20 3a 61 75 74 6f 3a 0a 2a 2a 20 20 50 52   | :auto:.**  PR
37410 41 47 4d 41 20 5b 64 61 74 61 62 61 73 65 2e 5d  AGMA [database.]
37420 6c 6f 63 6b 5f 70 72 6f 78 79 5f 66 69 6c 65 0a  lock_proxy_file.
37430 2a 2a 0a 2a 2a 20 53 70 65 63 69 66 79 69 6e 67  **.** Specifying
37440 20 22 3a 61 75 74 6f 3a 22 20 6d 65 61 6e 73 20   ":auto:" means 
37450 74 68 61 74 20 69 66 20 74 68 65 72 65 20 69 73  that if there is
37460 20 61 20 63 6f 6e 63 68 20 66 69 6c 65 20 77 69   a conch file wi
37470 74 68 20 61 20 6d 61 74 63 68 69 6e 67 0a 2a 2a  th a matching.**
37480 20 68 6f 73 74 20 49 44 20 69 6e 20 69 74 2c 20   host ID in it, 
37490 74 68 65 20 70 72 6f 78 79 20 70 61 74 68 20 69  the proxy path i
374a0 6e 20 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65  n the conch file
374b0 20 77 69 6c 6c 20 62 65 20 75 73 65 64 2c 20 6f   will be used, o
374c0 74 68 65 72 77 69 73 65 0a 2a 2a 20 61 20 70 72  therwise.** a pr
374d0 6f 78 79 20 70 61 74 68 20 62 61 73 65 64 20 6f  oxy path based o
374e0 6e 20 74 68 65 20 75 73 65 72 27 73 20 74 65 6d  n the user's tem
374f0 70 20 64 69 72 0a 2a 2a 20 28 76 69 61 20 63 6f  p dir.** (via co
37500 6e 66 73 74 72 28 5f 43 53 5f 44 41 52 57 49 4e  nfstr(_CS_DARWIN
37510 5f 55 53 45 52 5f 54 45 4d 50 5f 44 49 52 2c 2e  _USER_TEMP_DIR,.
37520 2e 2e 29 29 20 77 69 6c 6c 20 62 65 20 75 73 65  ..)) will be use
37530 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 61 63 74  d and the.** act
37540 75 61 6c 20 70 72 6f 78 79 20 66 69 6c 65 20 6e  ual proxy file n
37550 61 6d 65 20 69 73 20 67 65 6e 65 72 61 74 65 64  ame is generated
37560 20 66 72 6f 6d 20 74 68 65 20 6e 61 6d 65 20 61   from the name a
37570 6e 64 20 70 61 74 68 20 6f 66 20 74 68 65 0a 2a  nd path of the.*
37580 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  * database file.
37590 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2a    For example:.*
375a0 2a 0a 2a 2a 20 20 20 20 20 20 20 46 6f 72 20 64  *.**       For d
375b0 61 74 61 62 61 73 65 20 70 61 74 68 20 22 2f 55  atabase path "/U
375c0 73 65 72 73 2f 6d 65 2f 66 6f 6f 2e 64 62 22 20  sers/me/foo.db" 
375d0 0a 2a 2a 20 20 20 20 20 20 20 54 68 65 20 6c 6f  .**       The lo
375e0 63 6b 20 70 61 74 68 20 77 69 6c 6c 20 62 65 20  ck path will be 
375f0 22 3c 74 6d 70 64 69 72 3e 2f 73 71 6c 69 74 65  "<tmpdir>/sqlite
37600 70 6c 6f 63 6b 73 2f 5f 55 73 65 72 73 5f 6d 65  plocks/_Users_me
37610 5f 66 6f 6f 2e 64 62 3a 61 75 74 6f 3a 22 29 0a  _foo.db:auto:").
37620 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 61 20 6c 6f 63  **.** Once a loc
37630 6b 20 70 72 6f 78 79 20 69 73 20 63 6f 6e 66 69  k proxy is confi
37640 67 75 72 65 64 20 66 6f 72 20 61 20 64 61 74 61  gured for a data
37650 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c  base connection,
37660 20 69 74 20 63 61 6e 20 6e 6f 74 0a 2a 2a 20 62   it can not.** b
37670 65 20 72 65 6d 6f 76 65 64 2c 20 68 6f 77 65 76  e removed, howev
37680 65 72 20 69 74 20 6d 61 79 20 62 65 20 73 77 69  er it may be swi
37690 74 63 68 65 64 20 74 6f 20 61 20 64 69 66 66 65  tched to a diffe
376a0 72 65 6e 74 20 70 72 6f 78 79 20 70 61 74 68 20  rent proxy path 
376b0 76 69 61 0a 2a 2a 20 74 68 65 20 61 62 6f 76 65  via.** the above
376c0 20 41 50 49 73 20 28 61 73 73 75 6d 69 6e 67 20   APIs (assuming 
376d0 74 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 69  the conch file i
376e0 73 20 6e 6f 74 20 62 65 69 6e 67 20 68 65 6c 64  s not being held
376f0 20 62 79 20 61 6e 6f 74 68 65 72 0a 2a 2a 20 63   by another.** c
37700 6f 6e 6e 65 63 74 69 6f 6e 20 6f 72 20 70 72 6f  onnection or pro
37710 63 65 73 73 29 2e 20 0a 2a 2a 0a 2a 2a 0a 2a 2a  cess). .**.**.**
37720 20 48 6f 77 20 70 72 6f 78 79 20 6c 6f 63 6b 69   How proxy locki
37730 6e 67 20 77 6f 72 6b 73 0a 2a 2a 20 2d 2d 2d 2d  ng works.** ----
37740 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
37750 2d 2d 2d 0a 2a 2a 0a 2a 2a 20 50 72 6f 78 79 20  ---.**.** Proxy 
37760 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 72 65 6c  file locking rel
37770 69 65 73 20 70 72 69 6d 61 72 69 6c 79 20 6f 6e  ies primarily on
37780 20 74 77 6f 20 6e 65 77 20 73 75 70 70 6f 72 74   two new support
37790 69 6e 67 20 66 69 6c 65 73 3a 20 0a 2a 2a 0a 2a  ing files: .**.*
377a0 2a 20 20 20 2a 20 20 63 6f 6e 63 68 20 66 69 6c  *   *  conch fil
377b0 65 20 74 6f 20 6c 69 6d 69 74 20 61 63 63 65 73  e to limit acces
377c0 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  s to the databas
377d0 65 20 66 69 6c 65 20 74 6f 20 61 20 73 69 6e 67  e file to a sing
377e0 6c 65 20 68 6f 73 74 0a 2a 2a 20 20 20 20 20 20  le host.**      
377f0 61 74 20 61 20 74 69 6d 65 0a 2a 2a 0a 2a 2a 20  at a time.**.** 
37800 20 20 2a 20 20 70 72 6f 78 79 20 66 69 6c 65 20    *  proxy file 
37810 74 6f 20 61 63 74 20 61 73 20 61 20 70 72 6f 78  to act as a prox
37820 79 20 66 6f 72 20 74 68 65 20 61 64 76 69 73 6f  y for the adviso
37830 72 79 20 6c 6f 63 6b 73 20 6e 6f 72 6d 61 6c 6c  ry locks normall
37840 79 0a 2a 2a 20 20 20 20 20 20 74 61 6b 65 6e 20  y.**      taken 
37850 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  on the database.
37860 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6e 63 68 20  **.** The conch 
37870 66 69 6c 65 20 2d 20 74 6f 20 75 73 65 20 61 20  file - to use a 
37880 70 72 6f 78 79 20 66 69 6c 65 2c 20 73 71 6c 69  proxy file, sqli
37890 74 65 20 6d 75 73 74 20 66 69 72 73 74 20 22 68  te must first "h
378a0 6f 6c 64 20 74 68 65 20 63 6f 6e 63 68 22 0a 2a  old the conch".*
378b0 2a 20 62 79 20 74 61 6b 69 6e 67 20 61 6e 20 73  * by taking an s
378c0 71 6c 69 74 65 2d 73 74 79 6c 65 20 73 68 61 72  qlite-style shar
378d0 65 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 63  ed lock on the c
378e0 6f 6e 63 68 20 66 69 6c 65 2c 20 72 65 61 64 69  onch file, readi
378f0 6e 67 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e  ng the.** conten
37900 74 73 20 61 6e 64 20 63 6f 6d 70 61 72 69 6e 67  ts and comparing
37910 20 74 68 65 20 68 6f 73 74 27 73 20 75 6e 69 71   the host's uniq
37920 75 65 20 68 6f 73 74 20 49 44 20 28 73 65 65 20  ue host ID (see 
37930 62 65 6c 6f 77 29 20 61 6e 64 20 6c 6f 63 6b 0a  below) and lock.
37940 2a 2a 20 70 72 6f 78 79 20 70 61 74 68 20 61 67  ** proxy path ag
37950 61 69 6e 73 74 20 74 68 65 20 76 61 6c 75 65 73  ainst the values
37960 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63   stored in the c
37970 6f 6e 63 68 2e 20 20 54 68 65 20 63 6f 6e 63 68  onch.  The conch
37980 20 66 69 6c 65 20 69 73 0a 2a 2a 20 73 74 6f 72   file is.** stor
37990 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64  ed in the same d
379a0 69 72 65 63 74 6f 72 79 20 61 73 20 74 68 65 20  irectory as the 
379b0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e  database file an
379c0 64 20 74 68 65 20 66 69 6c 65 20 6e 61 6d 65 0a  d the file name.
379d0 2a 2a 20 69 73 20 70 61 74 74 65 72 6e 65 64 20  ** is patterned 
379e0 61 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61  after the databa
379f0 73 65 20 66 69 6c 65 20 6e 61 6d 65 20 61 73 20  se file name as 
37a00 22 2e 3c 64 61 74 61 62 61 73 65 6e 61 6d 65 3e  ".<databasename>
37a10 2d 63 6f 6e 63 68 22 2e 0a 2a 2a 20 49 66 20 74  -conch"..** If t
37a20 68 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 64 6f  he conch file do
37a30 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 6f 72  es not exist, or
37a40 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 20 64 6f   its contents do
37a50 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 0a 2a   not match the.*
37a60 2a 20 68 6f 73 74 20 49 44 20 61 6e 64 2f 6f 72  * host ID and/or
37a70 20 70 72 6f 78 79 20 70 61 74 68 2c 20 74 68 65   proxy path, the
37a80 6e 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 65 73  n the lock is es
37a90 63 61 6c 61 74 65 64 20 74 6f 20 61 6e 20 65 78  calated to an ex
37aa0 63 6c 75 73 69 76 65 0a 2a 2a 20 6c 6f 63 6b 20  clusive.** lock 
37ab0 61 6e 64 20 74 68 65 20 63 6f 6e 63 68 20 66 69  and the conch fi
37ac0 6c 65 20 63 6f 6e 74 65 6e 74 73 20 69 73 20 75  le contents is u
37ad0 70 64 61 74 65 64 20 77 69 74 68 20 74 68 65 20  pdated with the 
37ae0 68 6f 73 74 20 49 44 20 61 6e 64 20 70 72 6f 78  host ID and prox
37af0 79 0a 2a 2a 20 70 61 74 68 20 61 6e 64 20 74 68  y.** path and th
37b00 65 20 6c 6f 63 6b 20 69 73 20 64 6f 77 6e 67 72  e lock is downgr
37b10 61 64 65 64 20 74 6f 20 61 20 73 68 61 72 65 64  aded to a shared
37b20 20 6c 6f 63 6b 20 61 67 61 69 6e 2e 20 20 49 66   lock again.  If
37b30 20 74 68 65 20 63 6f 6e 63 68 0a 2a 2a 20 69 73   the conch.** is
37b40 20 68 65 6c 64 20 62 79 20 61 6e 6f 74 68 65 72   held by another
37b50 20 70 72 6f 63 65 73 73 20 28 77 69 74 68 20 61   process (with a
37b60 20 73 68 61 72 65 64 20 6c 6f 63 6b 29 2c 20 74   shared lock), t
37b70 68 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63  he exclusive loc
37b80 6b 0a 2a 2a 20 77 69 6c 6c 20 66 61 69 6c 20 61  k.** will fail a
37b90 6e 64 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69  nd SQLITE_BUSY i
37ba0 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a  s returned..**.*
37bb0 2a 20 54 68 65 20 70 72 6f 78 79 20 66 69 6c 65  * The proxy file
37bc0 20 2d 20 61 20 73 69 6e 67 6c 65 2d 62 79 74 65   - a single-byte
37bd0 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20 61   file used for a
37be0 6c 6c 20 61 64 76 69 73 6f 72 79 20 66 69 6c 65  ll advisory file
37bf0 20 6c 6f 63 6b 73 0a 2a 2a 20 6e 6f 72 6d 61 6c   locks.** normal
37c00 6c 79 20 74 61 6b 65 6e 20 6f 6e 20 74 68 65 20  ly taken on the 
37c10 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20  database file.  
37c20 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 66 6f 72   This allows for
37c30 20 73 61 66 65 20 73 68 61 72 69 6e 67 0a 2a 2a   safe sharing.**
37c40 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65   of the database
37c50 20 66 69 6c 65 20 66 6f 72 20 6d 75 6c 74 69 70   file for multip
37c60 6c 65 20 72 65 61 64 65 72 73 20 61 6e 64 20 77  le readers and w
37c70 72 69 74 65 72 73 20 6f 6e 20 74 68 65 20 73 61  riters on the sa
37c80 6d 65 0a 2a 2a 20 68 6f 73 74 20 28 74 68 65 20  me.** host (the 
37c90 63 6f 6e 63 68 20 65 6e 73 75 72 65 73 20 74 68  conch ensures th
37ca0 61 74 20 74 68 65 79 20 61 6c 6c 20 75 73 65 20  at they all use 
37cb0 74 68 65 20 73 61 6d 65 20 6c 6f 63 61 6c 20 6c  the same local l
37cc0 6f 63 6b 20 66 69 6c 65 29 2e 0a 2a 2a 0a 2a 2a  ock file)..**.**
37cd0 20 52 65 71 75 65 73 74 69 6e 67 20 74 68 65 20   Requesting the 
37ce0 6c 6f 63 6b 20 70 72 6f 78 79 20 64 6f 65 73 20  lock proxy does 
37cf0 6e 6f 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20  not immediately 
37d00 74 61 6b 65 20 74 68 65 20 63 6f 6e 63 68 2c 20  take the conch, 
37d10 69 74 20 69 73 0a 2a 2a 20 6f 6e 6c 79 20 74 61  it is.** only ta
37d20 6b 65 6e 20 77 68 65 6e 20 74 68 65 20 66 69 72  ken when the fir
37d30 73 74 20 72 65 71 75 65 73 74 20 74 6f 20 6c 6f  st request to lo
37d40 63 6b 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ck database file
37d50 20 69 73 20 6d 61 64 65 2e 20 20 0a 2a 2a 20 54   is made.  .** T
37d60 68 69 73 20 6d 61 74 63 68 65 73 20 74 68 65 20  his matches the 
37d70 73 65 6d 61 6e 74 69 63 73 20 6f 66 20 74 68 65  semantics of the
37d80 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 6c 6f 63   traditional loc
37d90 6b 69 6e 67 20 62 65 68 61 76 69 6f 72 2c 20 77  king behavior, w
37da0 68 65 72 65 0a 2a 2a 20 6f 70 65 6e 69 6e 67 20  here.** opening 
37db0 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20  a connection to 
37dc0 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  a database file 
37dd0 64 6f 65 73 20 6e 6f 74 20 74 61 6b 65 20 61 20  does not take a 
37de0 6c 6f 63 6b 20 6f 6e 20 69 74 2e 0a 2a 2a 20 54  lock on it..** T
37df0 68 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 61  he shared lock a
37e00 6e 64 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20  nd an open file 
37e10 64 65 73 63 72 69 70 74 6f 72 20 61 72 65 20 6d  descriptor are m
37e20 61 69 6e 74 61 69 6e 65 64 20 75 6e 74 69 6c 20  aintained until 
37e30 0a 2a 2a 20 74 68 65 20 63 6f 6e 6e 65 63 74 69  .** the connecti
37e40 6f 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  on to the databa
37e50 73 65 20 69 73 20 63 6c 6f 73 65 64 2e 20 0a 2a  se is closed. .*
37e60 2a 0a 2a 2a 20 54 68 65 20 70 72 6f 78 79 20 66  *.** The proxy f
37e70 69 6c 65 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b  ile and the lock
37e80 20 66 69 6c 65 20 61 72 65 20 6e 65 76 65 72 20   file are never 
37e90 64 65 6c 65 74 65 64 20 73 6f 20 74 68 65 79 20  deleted so they 
37ea0 6f 6e 6c 79 20 6e 65 65 64 0a 2a 2a 20 74 6f 20  only need.** to 
37eb0 62 65 20 63 72 65 61 74 65 64 20 74 68 65 20 66  be created the f
37ec0 69 72 73 74 20 74 69 6d 65 20 74 68 65 79 20 61  irst time they a
37ed0 72 65 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 43  re used..**.** C
37ee0 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74  onfiguration opt
37ef0 69 6f 6e 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d  ions.** --------
37f00 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a  -------------.**
37f10 0a 2a 2a 20 20 53 51 4c 49 54 45 5f 50 52 45 46  .**  SQLITE_PREF
37f20 45 52 5f 50 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47  ER_PROXY_LOCKING
37f30 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 44 61 74  .**.**       Dat
37f40 61 62 61 73 65 20 66 69 6c 65 73 20 61 63 63 65  abase files acce
37f50 73 73 65 64 20 6f 6e 20 6e 6f 6e 2d 6c 6f 63 61  ssed on non-loca
37f60 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 73 20 61  l file systems a
37f70 72 65 0a 2a 2a 20 20 20 20 20 20 20 61 75 74 6f  re.**       auto
37f80 6d 61 74 69 63 61 6c 6c 79 20 63 6f 6e 66 69 67  matically config
37f90 75 72 65 64 20 66 6f 72 20 70 72 6f 78 79 20 6c  ured for proxy l
37fa0 6f 63 6b 69 6e 67 2c 20 6c 6f 63 6b 20 66 69 6c  ocking, lock fil
37fb0 65 73 20 61 72 65 0a 2a 2a 20 20 20 20 20 20 20  es are.**       
37fc0 6e 61 6d 65 64 20 61 75 74 6f 6d 61 74 69 63 61  named automatica
37fd0 6c 6c 79 20 75 73 69 6e 67 20 74 68 65 20 73 61  lly using the sa
37fe0 6d 65 20 6c 6f 67 69 63 20 61 73 0a 2a 2a 20 20  me logic as.**  
37ff0 20 20 20 20 20 50 52 41 47 4d 41 20 6c 6f 63 6b       PRAGMA lock
38000 5f 70 72 6f 78 79 5f 66 69 6c 65 3d 22 3a 61 75  _proxy_file=":au
38010 74 6f 3a 22 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20  to:".**    .**  
38020 53 51 4c 49 54 45 5f 50 52 4f 58 59 5f 44 45 42  SQLITE_PROXY_DEB
38030 55 47 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 45  UG.**.**       E
38040 6e 61 62 6c 65 73 20 74 68 65 20 6c 6f 67 67 69  nables the loggi
38050 6e 67 20 6f 66 20 65 72 72 6f 72 20 6d 65 73 73  ng of error mess
38060 61 67 65 73 20 64 75 72 69 6e 67 20 68 6f 73 74  ages during host
38070 20 69 64 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20   id file.**     
38080 20 20 72 65 74 72 69 65 76 61 6c 20 61 6e 64 20    retrieval and 
38090 63 72 65 61 74 69 6f 6e 0a 2a 2a 0a 2a 2a 20 20  creation.**.**  
380a0 4c 4f 43 4b 50 52 4f 58 59 44 49 52 0a 2a 2a 0a  LOCKPROXYDIR.**.
380b0 2a 2a 20 20 20 20 20 20 20 4f 76 65 72 72 69 64  **       Overrid
380c0 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 64  es the default d
380d0 69 72 65 63 74 6f 72 79 20 75 73 65 64 20 66 6f  irectory used fo
380e0 72 20 6c 6f 63 6b 20 70 72 6f 78 79 20 66 69 6c  r lock proxy fil
380f0 65 73 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 20  es that.**      
38100 20 61 72 65 20 6e 61 6d 65 64 20 61 75 74 6f 6d   are named autom
38110 61 74 69 63 61 6c 6c 79 20 76 69 61 20 74 68 65  atically via the
38120 20 22 3a 61 75 74 6f 3a 22 20 73 65 74 74 69 6e   ":auto:" settin
38130 67 0a 2a 2a 0a 2a 2a 20 20 53 51 4c 49 54 45 5f  g.**.**  SQLITE_
38140 44 45 46 41 55 4c 54 5f 50 52 4f 58 59 44 49 52  DEFAULT_PROXYDIR
38150 5f 50 45 52 4d 49 53 53 49 4f 4e 53 0a 2a 2a 0a  _PERMISSIONS.**.
38160 2a 2a 20 20 20 20 20 20 20 50 65 72 6d 69 73 73  **       Permiss
38170 69 6f 6e 73 20 74 6f 20 75 73 65 20 77 68 65 6e  ions to use when
38180 20 63 72 65 61 74 69 6e 67 20 61 20 64 69 72 65   creating a dire
38190 63 74 6f 72 79 20 66 6f 72 20 73 74 6f 72 69 6e  ctory for storin
381a0 67 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 6c  g the.**       l
381b0 6f 63 6b 20 70 72 6f 78 79 20 66 69 6c 65 73 2c  ock proxy files,
381c0 20 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20   only used when 
381d0 4c 4f 43 4b 50 52 4f 58 59 44 49 52 20 69 73 20  LOCKPROXYDIR is 
381e0 6e 6f 74 20 73 65 74 2e 0a 2a 2a 20 20 20 20 0a  not set..**    .
381f0 2a 2a 20 20 20 20 0a 2a 2a 20 41 73 20 6d 65 6e  **    .** As men
38200 74 69 6f 6e 65 64 20 61 62 6f 76 65 2c 20 77 68  tioned above, wh
38210 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  en compiled with
38220 20 53 51 4c 49 54 45 5f 50 52 45 46 45 52 5f 50   SQLITE_PREFER_P
38230 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 2c 0a 2a 2a  ROXY_LOCKING,.**
38240 20 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76   setting the env
38250 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c  ironment variabl
38260 65 20 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 50  e SQLITE_FORCE_P
38270 52 4f 58 59 5f 4c 4f 43 4b 49 4e 47 20 74 6f 20  ROXY_LOCKING to 
38280 31 20 77 69 6c 6c 0a 2a 2a 20 66 6f 72 63 65 20  1 will.** force 
38290 70 72 6f 78 79 20 6c 6f 63 6b 69 6e 67 20 74 6f  proxy locking to
382a0 20 62 65 20 75 73 65 64 20 66 6f 72 20 65 76 65   be used for eve
382b0 72 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ry database file
382c0 20 6f 70 65 6e 65 64 2c 20 61 6e 64 20 30 0a 2a   opened, and 0.*
382d0 2a 20 77 69 6c 6c 20 66 6f 72 63 65 20 61 75 74  * will force aut
382e0 6f 6d 61 74 69 63 20 70 72 6f 78 79 20 6c 6f 63  omatic proxy loc
382f0 6b 69 6e 67 20 74 6f 20 62 65 20 64 69 73 61 62  king to be disab
38300 6c 65 64 20 66 6f 72 20 61 6c 6c 20 64 61 74 61  led for all data
38310 62 61 73 65 0a 2a 2a 20 66 69 6c 65 73 20 28 65  base.** files (e
38320 78 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c 69 6e  xplicitly callin
38330 67 20 74 68 65 20 53 51 4c 49 54 45 5f 46 43 4e  g the SQLITE_FCN
38340 54 4c 5f 53 45 54 5f 4c 4f 43 4b 50 52 4f 58 59  TL_SET_LOCKPROXY
38350 46 49 4c 45 20 70 72 61 67 6d 61 20 6f 72 0a 2a  FILE pragma or.*
38360 2a 20 73 71 6c 69 74 65 5f 66 69 6c 65 5f 63 6f  * sqlite_file_co
38370 6e 74 72 6f 6c 20 41 50 49 20 69 73 20 6e 6f 74  ntrol API is not
38380 20 61 66 66 65 63 74 65 64 20 62 79 20 53 51 4c   affected by SQL
38390 49 54 45 5f 46 4f 52 43 45 5f 50 52 4f 58 59 5f  ITE_FORCE_PROXY_
383a0 4c 4f 43 4b 49 4e 47 29 2e 0a 2a 2f 0a 0a 2f 2a  LOCKING)..*/../*
383b0 0a 2a 2a 20 50 72 6f 78 79 20 6c 6f 63 6b 69 6e  .** Proxy lockin
383c0 67 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61  g is only availa
383d0 62 6c 65 20 6f 6e 20 4d 61 63 4f 53 58 20 0a 2a  ble on MacOSX .*
383e0 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f  /.#if defined(__
383f0 41 50 50 4c 45 5f 5f 29 20 26 26 20 53 51 4c 49  APPLE__) && SQLI
38400 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e  TE_ENABLE_LOCKIN
38410 47 5f 53 54 59 4c 45 0a 0a 2f 2a 0a 2a 2a 20 54  G_STYLE../*.** T
38420 68 65 20 70 72 6f 78 79 4c 6f 63 6b 69 6e 67 43  he proxyLockingC
38430 6f 6e 74 65 78 74 20 68 61 73 20 74 68 65 20 70  ontext has the p
38440 61 74 68 20 61 6e 64 20 66 69 6c 65 20 73 74 72  ath and file str
38450 75 63 74 75 72 65 73 20 66 6f 72 20 74 68 65 20  uctures for the 
38460 72 65 6d 6f 74 65 20 0a 2a 2a 20 61 6e 64 20 6c  remote .** and l
38470 6f 63 61 6c 20 70 72 6f 78 79 20 66 69 6c 65 73  ocal proxy files
38480 20 69 6e 20 69 74 0a 2a 2f 0a 74 79 70 65 64 65   in it.*/.typede
38490 66 20 73 74 72 75 63 74 20 70 72 6f 78 79 4c 6f  f struct proxyLo
384a0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 70 72 6f  ckingContext pro
384b0 78 79 4c 6f 63 6b 69 6e 67 43 6f 6e 74 65 78 74  xyLockingContext
384c0 3b 0a 73 74 72 75 63 74 20 70 72 6f 78 79 4c 6f  ;.struct proxyLo
384d0 63 6b 69 6e 67 43 6f 6e 74 65 78 74 20 7b 0a 20  ckingContext {. 
384e0 20 75 6e 69 78 46 69 6c 65 20 2a 63 6f 6e 63 68   unixFile *conch
384f0 46 69 6c 65 3b 20 20 20 20 20 20 20 20 20 2f 2a  File;         /*
38500 20 4f 70 65 6e 20 63 6f 6e 63 68 20 66 69 6c 65   Open conch file
38510 20 2a 2f 0a 20 20 63 68 61 72 20 2a 63 6f 6e 63   */.  char *conc
38520 68 46 69 6c 65 50 61 74 68 3b 20 20 20 20 20 20  hFilePath;      
38530 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68     /* Name of th
38540 65 20 63 6f 6e 63 68 20 66 69 6c 65 20 2a 2f 0a  e conch file */.
38550 20 20 75 6e 69 78 46 69 6c 65 20 2a 6c 6f 63 6b    unixFile *lock
38560 50 72 6f 78 79 3b 20 20 20 20 20 20 20 20 20 2f  Proxy;         /
38570 2a 20 4f 70 65 6e 20 70 72 6f 78 79 20 6c 6f 63  * Open proxy loc
38580 6b 20 66 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72  k file */.  char
38590 20 2a 6c 6