/ Hex Artifact Content
Login

Artifact 63608cd3dd4dd71a91329d35557bb0c0820d18fc:


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 63   file contains c
0190: 6f 64 65 20 74 68 61 74 20 69 73 20 73 70 65 63  ode that is spec
01a0: 69 66 69 63 20 74 6f 20 55 6e 69 78 20 73 79 73  ific to Unix sys
01b0: 74 65 6d 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64  tems..*/.#includ
01c0: 65 20 22 6f 73 2e 68 22 20 20 20 20 20 20 20 20  e "os.h"        
01d0: 20 20 2f 2a 20 4d 75 73 74 20 62 65 20 66 69 72    /* Must be fir
01e0: 73 74 20 74 6f 20 65 6e 61 62 6c 65 20 6c 61 72  st to enable lar
01f0: 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 20  ge file support 
0200: 2a 2f 0a 23 69 66 20 4f 53 5f 55 4e 49 58 20 20  */.#if OS_UNIX  
0210: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
0220: 68 69 73 20 66 69 6c 65 20 69 73 20 75 73 65 64  his file is used
0230: 20 6f 6e 20 75 6e 69 78 20 6f 6e 6c 79 20 2a 2f   on unix only */
0240: 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74  .#include "sqlit
0250: 65 49 6e 74 2e 68 22 0a 0a 0a 23 69 6e 63 6c 75  eInt.h"...#inclu
0260: 64 65 20 3c 74 69 6d 65 2e 68 3e 0a 23 69 6e 63  de <time.h>.#inc
0270: 6c 75 64 65 20 3c 65 72 72 6e 6f 2e 68 3e 0a 23  lude <errno.h>.#
0280: 69 6e 63 6c 75 64 65 20 3c 75 6e 69 73 74 64 2e  include <unistd.
0290: 68 3e 0a 23 69 66 6e 64 65 66 20 4f 5f 4c 41 52  h>.#ifndef O_LAR
02a0: 47 45 46 49 4c 45 0a 23 20 64 65 66 69 6e 65 20  GEFILE.# define 
02b0: 4f 5f 4c 41 52 47 45 46 49 4c 45 20 30 0a 23 65  O_LARGEFILE 0.#e
02c0: 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49  ndif.#ifdef SQLI
02d0: 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 0a 23  TE_DISABLE_LFS.#
02e0: 20 75 6e 64 65 66 20 4f 5f 4c 41 52 47 45 46 49   undef O_LARGEFI
02f0: 4c 45 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4c 41  LE.# define O_LA
0300: 52 47 45 46 49 4c 45 20 30 0a 23 65 6e 64 69 66  RGEFILE 0.#endif
0310: 0a 23 69 66 6e 64 65 66 20 4f 5f 4e 4f 46 4f 4c  .#ifndef O_NOFOL
0320: 4c 4f 57 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4e  LOW.# define O_N
0330: 4f 46 4f 4c 4c 4f 57 20 30 0a 23 65 6e 64 69 66  OFOLLOW 0.#endif
0340: 0a 23 69 66 6e 64 65 66 20 4f 5f 42 49 4e 41 52  .#ifndef O_BINAR
0350: 59 0a 23 20 64 65 66 69 6e 65 20 4f 5f 42 49 4e  Y.# define O_BIN
0360: 41 52 59 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a  ARY 0.#endif../*
0370: 0a 2a 2a 20 54 68 65 20 44 4a 47 50 50 20 63 6f  .** The DJGPP co
0380: 6d 70 69 6c 65 72 20 65 6e 76 69 72 6f 6e 6d 65  mpiler environme
0390: 6e 74 20 6c 6f 6f 6b 73 20 6d 6f 73 74 6c 79 20  nt looks mostly 
03a0: 6c 69 6b 65 20 55 6e 69 78 2c 20 62 75 74 20 69  like Unix, but i
03b0: 74 0a 2a 2a 20 6c 61 63 6b 73 20 74 68 65 20 66  t.** lacks the f
03c0: 63 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63 61  cntl() system ca
03d0: 6c 6c 2e 20 20 53 6f 20 72 65 64 65 66 69 6e 65  ll.  So redefine
03e0: 20 66 63 6e 74 6c 28 29 20 74 6f 20 62 65 20 73   fcntl() to be s
03f0: 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 74 68 61 74  omething.** that
0400: 20 61 6c 77 61 79 73 20 73 75 63 63 65 65 64 73   always succeeds
0410: 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68  .  This means th
0420: 61 74 20 6c 6f 63 6b 69 6e 67 20 64 6f 65 73 20  at locking does 
0430: 6e 6f 74 20 6f 63 63 75 72 20 75 6e 64 65 72 0a  not occur under.
0440: 2a 2a 20 44 4a 47 50 50 2e 20 20 42 75 74 20 69  ** DJGPP.  But i
0450: 74 73 20 44 4f 53 20 2d 20 77 68 61 74 20 64 69  ts DOS - what di
0460: 64 20 79 6f 75 20 65 78 70 65 63 74 3f 0a 2a 2f  d you expect?.*/
0470: 0a 23 69 66 64 65 66 20 5f 5f 44 4a 47 50 50 5f  .#ifdef __DJGPP_
0480: 5f 0a 23 20 64 65 66 69 6e 65 20 66 63 6e 74 6c  _.# define fcntl
0490: 28 41 2c 42 2c 43 29 20 30 0a 23 65 6e 64 69 66  (A,B,C) 0.#endif
04a0: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 75  ../*.** Macros u
04b0: 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65  sed to determine
04c0: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
04d0: 74 6f 20 75 73 65 20 74 68 72 65 61 64 73 2e 20  to use threads. 
04e0: 20 54 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 55   The.** SQLITE_U
04f0: 4e 49 58 5f 54 48 52 45 41 44 53 20 6d 61 63 72  NIX_THREADS macr
0500: 6f 20 69 73 20 64 65 66 69 6e 65 64 20 69 66 20  o is defined if 
0510: 77 65 20 61 72 65 20 73 79 6e 63 68 72 6f 6e 69  we are synchroni
0520: 7a 69 6e 67 20 66 6f 72 0a 2a 2a 20 50 6f 73 69  zing for.** Posi
0530: 78 20 74 68 72 65 61 64 73 20 61 6e 64 20 53 51  x threads and SQ
0540: 4c 49 54 45 5f 57 33 32 5f 54 48 52 45 41 44 53  LITE_W32_THREADS
0550: 20 69 73 20 64 65 66 69 6e 65 64 20 69 66 20 77   is defined if w
0560: 65 20 61 72 65 0a 2a 2a 20 73 79 6e 63 68 72 6f  e are.** synchro
0570: 6e 69 7a 69 6e 67 20 75 73 69 6e 67 20 57 69 6e  nizing using Win
0580: 33 32 20 74 68 72 65 61 64 73 2e 0a 2a 2f 0a 23  32 threads..*/.#
0590: 69 66 20 64 65 66 69 6e 65 64 28 54 48 52 45 41  if defined(THREA
05a0: 44 53 41 46 45 29 20 26 26 20 54 48 52 45 41 44  DSAFE) && THREAD
05b0: 53 41 46 45 0a 23 20 69 6e 63 6c 75 64 65 20 3c  SAFE.# include <
05c0: 70 74 68 72 65 61 64 2e 68 3e 0a 23 20 64 65 66  pthread.h>.# def
05d0: 69 6e 65 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f  ine SQLITE_UNIX_
05e0: 54 48 52 45 41 44 53 20 31 0a 23 65 6e 64 69 66  THREADS 1.#endif
05f0: 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65  .../*.** Include
0600: 20 63 6f 64 65 20 74 68 61 74 20 69 73 20 63 6f   code that is co
0610: 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 6f 73 5f 2a  mmon to all os_*
0620: 2e 63 20 66 69 6c 65 73 0a 2a 2f 0a 23 69 6e 63  .c files.*/.#inc
0630: 6c 75 64 65 20 22 6f 73 5f 63 6f 6d 6d 6f 6e 2e  lude "os_common.
0640: 68 22 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28  h"..#if defined(
0650: 54 48 52 45 41 44 53 41 46 45 29 20 26 26 20 64  THREADSAFE) && d
0660: 65 66 69 6e 65 64 28 5f 5f 6c 69 6e 75 78 5f 5f  efined(__linux__
0670: 29 0a 23 64 65 66 69 6e 65 20 67 65 74 70 69 64  ).#define getpid
0680: 20 70 74 68 72 65 61 64 5f 73 65 6c 66 0a 23 65   pthread_self.#e
0690: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 48 65 72 65  ndif../*.** Here
06a0: 20 69 73 20 74 68 65 20 64 69 72 74 20 6f 6e 20   is the dirt on 
06b0: 50 4f 53 49 58 20 61 64 76 69 73 6f 72 79 20 6c  POSIX advisory l
06c0: 6f 63 6b 73 3a 20 20 41 4e 53 49 20 53 54 44 20  ocks:  ANSI STD 
06d0: 31 30 30 33 2e 31 20 28 31 39 39 36 29 0a 2a 2a  1003.1 (1996).**
06e0: 20 73 65 63 74 69 6f 6e 20 36 2e 35 2e 32 2e 32   section 6.5.2.2
06f0: 20 6c 69 6e 65 73 20 34 38 33 20 74 68 72 6f 75   lines 483 throu
0700: 67 68 20 34 39 30 20 73 70 65 63 69 66 79 20 74  gh 490 specify t
0710: 68 61 74 20 77 68 65 6e 20 61 20 70 72 6f 63 65  hat when a proce
0720: 73 73 0a 2a 2a 20 73 65 74 73 20 6f 72 20 63 6c  ss.** sets or cl
0730: 65 61 72 73 20 61 20 6c 6f 63 6b 2c 20 74 68 61  ears a lock, tha
0740: 74 20 6f 70 65 72 61 74 69 6f 6e 20 6f 76 65 72  t operation over
0750: 72 69 64 65 73 20 61 6e 79 20 70 72 69 6f 72 20  rides any prior 
0760: 6c 6f 63 6b 73 20 73 65 74 0a 2a 2a 20 62 79 20  locks set.** by 
0770: 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73  the same process
0780: 2e 20 20 49 74 20 64 6f 65 73 20 6e 6f 74 20 65  .  It does not e
0790: 78 70 6c 69 63 69 74 6c 79 20 73 61 79 20 73 6f  xplicitly say so
07a0: 2c 20 62 75 74 20 74 68 69 73 20 69 6d 70 6c 69  , but this impli
07b0: 65 73 0a 2a 2a 20 74 68 61 74 20 69 74 20 6f 76  es.** that it ov
07c0: 65 72 72 69 64 65 73 20 6c 6f 63 6b 73 20 73 65  errides locks se
07d0: 74 20 62 79 20 74 68 65 20 73 61 6d 65 20 70 72  t by the same pr
07e0: 6f 63 65 73 73 20 75 73 69 6e 67 20 61 20 64 69  ocess using a di
07f0: 66 66 65 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20  fferent.** file 
0800: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 43 6f 6e  descriptor.  Con
0810: 73 69 64 65 72 20 74 68 69 73 20 74 65 73 74 20  sider this test 
0820: 63 61 73 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  case:.**.**     
0830: 20 20 69 6e 74 20 66 64 31 20 3d 20 6f 70 65 6e    int fd1 = open
0840: 28 22 2e 2f 66 69 6c 65 31 22 2c 20 4f 5f 52 44  ("./file1", O_RD
0850: 57 52 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34  WR|O_CREAT, 0644
0860: 29 3b 0a 2a 2a 20 20 20 20 20 20 20 69 6e 74 20  );.**       int 
0870: 66 64 32 20 3d 20 6f 70 65 6e 28 22 2e 2f 66 69  fd2 = open("./fi
0880: 6c 65 32 22 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43  le2", O_RDWR|O_C
0890: 52 45 41 54 2c 20 30 36 34 34 29 3b 0a 2a 2a 0a  REAT, 0644);.**.
08a0: 2a 2a 20 53 75 70 70 6f 73 65 20 2e 2f 66 69 6c  ** Suppose ./fil
08b0: 65 31 20 61 6e 64 20 2e 2f 66 69 6c 65 32 20 61  e1 and ./file2 a
08c0: 72 65 20 72 65 61 6c 6c 79 20 74 68 65 20 73 61  re really the sa
08d0: 6d 65 20 66 69 6c 65 20 28 62 65 63 61 75 73 65  me file (because
08e0: 0a 2a 2a 20 6f 6e 65 20 69 73 20 61 20 68 61 72  .** one is a har
08f0: 64 20 6f 72 20 73 79 6d 62 6f 6c 69 63 20 6c 69  d or symbolic li
0900: 6e 6b 20 74 6f 20 74 68 65 20 6f 74 68 65 72 29  nk to the other)
0910: 20 74 68 65 6e 20 69 66 20 79 6f 75 20 73 65 74   then if you set
0920: 0a 2a 2a 20 61 6e 20 65 78 63 6c 75 73 69 76 65  .** an exclusive
0930: 20 6c 6f 63 6b 20 6f 6e 20 66 64 31 2c 20 74 68   lock on fd1, th
0940: 65 6e 20 74 72 79 20 74 6f 20 67 65 74 20 61 6e  en try to get an
0950: 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 0a   exclusive lock.
0960: 2a 2a 20 6f 6e 20 66 64 32 2c 20 69 74 20 77 6f  ** on fd2, it wo
0970: 72 6b 73 2e 20 20 49 20 77 6f 75 6c 64 20 68 61  rks.  I would ha
0980: 76 65 20 65 78 70 65 63 74 65 64 20 74 68 65 20  ve expected the 
0990: 73 65 63 6f 6e 64 20 6c 6f 63 6b 20 74 6f 0a 2a  second lock to.*
09a0: 2a 20 66 61 69 6c 20 73 69 6e 63 65 20 74 68 65  * fail since the
09b0: 72 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 61  re was already a
09c0: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c   lock on the fil
09d0: 65 20 64 75 65 20 74 6f 20 66 64 31 2e 0a 2a 2a  e due to fd1..**
09e0: 20 42 75 74 20 6e 6f 74 20 73 6f 2e 20 20 53 69   But not so.  Si
09f0: 6e 63 65 20 62 6f 74 68 20 6c 6f 63 6b 73 20 63  nce both locks c
0a00: 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 73 61 6d  ame from the sam
0a10: 65 20 70 72 6f 63 65 73 73 2c 20 74 68 65 0a 2a  e process, the.*
0a20: 2a 20 73 65 63 6f 6e 64 20 6f 76 65 72 72 69 64  * second overrid
0a30: 65 73 20 74 68 65 20 66 69 72 73 74 2c 20 65 76  es the first, ev
0a40: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 79 20 77  en though they w
0a50: 65 72 65 20 6f 6e 20 64 69 66 66 65 72 65 6e 74  ere on different
0a60: 0a 2a 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70  .** file descrip
0a70: 74 6f 72 73 20 6f 70 65 6e 65 64 20 6f 6e 20 64  tors opened on d
0a80: 69 66 66 65 72 65 6e 74 20 66 69 6c 65 20 6e 61  ifferent file na
0a90: 6d 65 73 2e 0a 2a 2a 0a 2a 2a 20 42 75 6d 6d 65  mes..**.** Bumme
0aa0: 72 2e 20 20 49 66 20 79 6f 75 20 61 73 6b 20 6d  r.  If you ask m
0ab0: 65 2c 20 74 68 69 73 20 69 73 20 62 72 6f 6b 65  e, this is broke
0ac0: 6e 2e 20 20 42 61 64 6c 79 20 62 72 6f 6b 65 6e  n.  Badly broken
0ad0: 2e 20 20 49 74 20 6d 65 61 6e 73 0a 2a 2a 20 74  .  It means.** t
0ae0: 68 61 74 20 77 65 20 63 61 6e 6e 6f 74 20 75 73  hat we cannot us
0af0: 65 20 50 4f 53 49 58 20 6c 6f 63 6b 73 20 74 6f  e POSIX locks to
0b00: 20 73 79 6e 63 68 72 6f 6e 69 7a 65 20 66 69 6c   synchronize fil
0b10: 65 20 61 63 63 65 73 73 20 61 6d 6f 6e 67 0a 2a  e access among.*
0b20: 2a 20 63 6f 6d 70 65 74 69 6e 67 20 74 68 72 65  * competing thre
0b30: 61 64 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20  ads of the same 
0b40: 70 72 6f 63 65 73 73 2e 20 20 50 4f 53 49 58 20  process.  POSIX 
0b50: 6c 6f 63 6b 73 20 77 69 6c 6c 20 77 6f 72 6b 20  locks will work 
0b60: 66 69 6e 65 0a 2a 2a 20 74 6f 20 73 79 6e 63 68  fine.** to synch
0b70: 72 6f 6e 69 7a 65 20 61 63 63 65 73 73 20 66 6f  ronize access fo
0b80: 72 20 74 68 72 65 61 64 73 20 69 6e 20 73 65 70  r threads in sep
0b90: 61 72 61 74 65 20 70 72 6f 63 65 73 73 65 73 2c  arate processes,
0ba0: 20 62 75 74 20 6e 6f 74 0a 2a 2a 20 74 68 72 65   but not.** thre
0bb0: 61 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  ads within the s
0bc0: 61 6d 65 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a  ame process..**.
0bd0: 2a 2a 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e  ** To work aroun
0be0: 64 20 74 68 65 20 70 72 6f 62 6c 65 6d 2c 20 53  d the problem, S
0bf0: 51 4c 69 74 65 20 68 61 73 20 74 6f 20 6d 61 6e  QLite has to man
0c00: 61 67 65 20 66 69 6c 65 20 6c 6f 63 6b 73 20 69  age file locks i
0c10: 6e 74 65 72 6e 61 6c 6c 79 0a 2a 2a 20 6f 6e 20  nternally.** on 
0c20: 69 74 73 20 6f 77 6e 2e 20 20 57 68 65 6e 65 76  its own.  Whenev
0c30: 65 72 20 61 20 6e 65 77 20 64 61 74 61 62 61 73  er a new databas
0c40: 65 20 69 73 20 6f 70 65 6e 65 64 2c 20 77 65 20  e is opened, we 
0c50: 68 61 76 65 20 74 6f 20 66 69 6e 64 20 74 68 65  have to find the
0c60: 0a 2a 2a 20 73 70 65 63 69 66 69 63 20 69 6e 6f  .** specific ino
0c70: 64 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  de of the databa
0c80: 73 65 20 66 69 6c 65 20 28 74 68 65 20 69 6e 6f  se file (the ino
0c90: 64 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64  de is determined
0ca0: 20 62 79 20 74 68 65 0a 2a 2a 20 73 74 5f 64 65   by the.** st_de
0cb0: 76 20 61 6e 64 20 73 74 5f 69 6e 6f 20 66 69 65  v and st_ino fie
0cc0: 6c 64 73 20 6f 66 20 74 68 65 20 73 74 61 74 20  lds of the stat 
0cd0: 73 74 72 75 63 74 75 72 65 20 74 68 61 74 20 66  structure that f
0ce0: 73 74 61 74 28 29 20 66 69 6c 6c 73 20 69 6e 29  stat() fills in)
0cf0: 0a 2a 2a 20 61 6e 64 20 63 68 65 63 6b 20 66 6f  .** and check fo
0d00: 72 20 6c 6f 63 6b 73 20 61 6c 72 65 61 64 79 20  r locks already 
0d10: 65 78 69 73 74 69 6e 67 20 6f 6e 20 74 68 61 74  existing on that
0d20: 20 69 6e 6f 64 65 2e 20 20 57 68 65 6e 20 6c 6f   inode.  When lo
0d30: 63 6b 73 20 61 72 65 0a 2a 2a 20 63 72 65 61 74  cks are.** creat
0d40: 65 64 20 6f 72 20 72 65 6d 6f 76 65 64 2c 20 77  ed or removed, w
0d50: 65 20 68 61 76 65 20 74 6f 20 6c 6f 6f 6b 20 61  e have to look a
0d60: 74 20 6f 75 72 20 6f 77 6e 20 69 6e 74 65 72 6e  t our own intern
0d70: 61 6c 20 72 65 63 6f 72 64 20 6f 66 20 74 68 65  al record of the
0d80: 0a 2a 2a 20 6c 6f 63 6b 73 20 74 6f 20 73 65 65  .** locks to see
0d90: 20 69 66 20 61 6e 6f 74 68 65 72 20 74 68 72 65   if another thre
0da0: 61 64 20 68 61 73 20 70 72 65 76 69 6f 75 73 6c  ad has previousl
0db0: 79 20 73 65 74 20 61 20 6c 6f 63 6b 20 6f 6e 20  y set a lock on 
0dc0: 74 68 61 74 20 73 61 6d 65 0a 2a 2a 20 69 6e 6f  that same.** ino
0dd0: 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4f 73  de..**.** The Os
0de0: 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 66  File structure f
0df0: 6f 72 20 50 4f 53 49 58 20 69 73 20 6e 6f 20 6c  or POSIX is no l
0e00: 6f 6e 67 65 72 20 6a 75 73 74 20 61 6e 20 69 6e  onger just an in
0e10: 74 65 67 65 72 20 66 69 6c 65 0a 2a 2a 20 64 65  teger file.** de
0e20: 73 63 72 69 70 74 6f 72 2e 20 20 49 74 20 69 73  scriptor.  It is
0e30: 20 6e 6f 77 20 61 20 73 74 72 75 63 74 75 72 65   now a structure
0e40: 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68 65 20   that holds the 
0e50: 69 6e 74 65 67 65 72 20 66 69 6c 65 0a 2a 2a 20  integer file.** 
0e60: 64 65 73 63 72 69 70 74 6f 72 20 61 6e 64 20 61  descriptor and a
0e70: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 74   pointer to a st
0e80: 72 75 63 74 75 72 65 20 74 68 61 74 20 64 65 73  ructure that des
0e90: 63 72 69 62 65 73 20 74 68 65 20 69 6e 74 65 72  cribes the inter
0ea0: 6e 61 6c 0a 2a 2a 20 6c 6f 63 6b 73 20 6f 6e 20  nal.** locks on 
0eb0: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  the correspondin
0ec0: 67 20 69 6e 6f 64 65 2e 20 20 54 68 65 72 65 20  g inode.  There 
0ed0: 69 73 20 6f 6e 65 20 6c 6f 63 6b 69 6e 67 20 73  is one locking s
0ee0: 74 72 75 63 74 75 72 65 0a 2a 2a 20 70 65 72 20  tructure.** per 
0ef0: 69 6e 6f 64 65 2c 20 73 6f 20 69 66 20 74 68 65  inode, so if the
0f00: 20 73 61 6d 65 20 69 6e 6f 64 65 20 69 73 20 6f   same inode is o
0f10: 70 65 6e 65 64 20 74 77 69 63 65 2c 20 62 6f 74  pened twice, bot
0f20: 68 20 4f 73 46 69 6c 65 20 73 74 72 75 63 74 75  h OsFile structu
0f30: 72 65 73 0a 2a 2a 20 70 6f 69 6e 74 20 74 6f 20  res.** point to 
0f40: 74 68 65 20 73 61 6d 65 20 6c 6f 63 6b 69 6e 67  the same locking
0f50: 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65   structure.  The
0f60: 20 6c 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75   locking structu
0f70: 72 65 20 6b 65 65 70 73 0a 2a 2a 20 61 20 72 65  re keeps.** a re
0f80: 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 28 73  ference count (s
0f90: 6f 20 77 65 20 77 69 6c 6c 20 6b 6e 6f 77 20 77  o we will know w
0fa0: 68 65 6e 20 74 6f 20 64 65 6c 65 74 65 20 69 74  hen to delete it
0fb0: 29 20 61 6e 64 20 61 20 22 63 6e 74 22 0a 2a 2a  ) and a "cnt".**
0fc0: 20 66 69 65 6c 64 20 74 68 61 74 20 74 65 6c 6c   field that tell
0fd0: 73 20 75 73 20 69 74 73 20 69 6e 74 65 72 6e 61  s us its interna
0fe0: 6c 20 6c 6f 63 6b 20 73 74 61 74 75 73 2e 20 20  l lock status.  
0ff0: 63 6e 74 3d 3d 30 20 6d 65 61 6e 73 20 74 68 65  cnt==0 means the
1000: 0a 2a 2a 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f  .** file is unlo
1010: 63 6b 65 64 2e 20 20 63 6e 74 3d 3d 2d 31 20 6d  cked.  cnt==-1 m
1020: 65 61 6e 73 20 74 68 65 20 66 69 6c 65 20 68 61  eans the file ha
1030: 73 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c  s an exclusive l
1040: 6f 63 6b 2e 0a 2a 2a 20 63 6e 74 3e 30 20 6d 65  ock..** cnt>0 me
1050: 61 6e 73 20 74 68 65 72 65 20 61 72 65 20 63 6e  ans there are cn
1060: 74 20 73 68 61 72 65 64 20 6c 6f 63 6b 73 20 6f  t shared locks o
1070: 6e 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a  n the file..**.*
1080: 2a 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f  * Any attempt to
1090: 20 6c 6f 63 6b 20 6f 72 20 75 6e 6c 6f 63 6b 20   lock or unlock 
10a0: 61 20 66 69 6c 65 20 66 69 72 73 74 20 63 68 65  a file first che
10b0: 63 6b 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 0a  cks the locking.
10c0: 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 54  ** structure.  T
10d0: 68 65 20 66 63 6e 74 6c 28 29 20 73 79 73 74 65  he fcntl() syste
10e0: 6d 20 63 61 6c 6c 20 69 73 20 6f 6e 6c 79 20 69  m call is only i
10f0: 6e 76 6f 6b 65 64 20 74 6f 20 73 65 74 20 61 20  nvoked to set a 
1100: 0a 2a 2a 20 50 4f 53 49 58 20 6c 6f 63 6b 20 69  .** POSIX lock i
1110: 66 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 6c  f the internal l
1120: 6f 63 6b 20 73 74 72 75 63 74 75 72 65 20 74 72  ock structure tr
1130: 61 6e 73 69 74 69 6f 6e 73 20 62 65 74 77 65 65  ansitions betwee
1140: 6e 0a 2a 2a 20 61 20 6c 6f 63 6b 65 64 20 61 6e  n.** a locked an
1150: 64 20 61 6e 20 75 6e 6c 6f 63 6b 65 64 20 73 74  d an unlocked st
1160: 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 34 2d  ate..**.** 2004-
1170: 4a 61 6e 2d 31 31 3a 0a 2a 2a 20 4d 6f 72 65 20  Jan-11:.** More 
1180: 72 65 63 65 6e 74 20 64 69 73 63 6f 76 65 72 69  recent discoveri
1190: 65 73 20 61 62 6f 75 74 20 50 4f 53 49 58 20 61  es about POSIX a
11a0: 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 2e 20 20  dvisory locks.  
11b0: 28 54 68 65 20 6d 6f 72 65 0a 2a 2a 20 49 20 64  (The more.** I d
11c0: 69 73 63 6f 76 65 72 2c 20 74 68 65 20 6d 6f 72  iscover, the mor
11d0: 65 20 49 20 72 65 61 6c 69 7a 65 20 74 68 65 20  e I realize the 
11e0: 61 20 50 4f 53 49 58 20 61 64 76 69 73 6f 72 79  a POSIX advisory
11f0: 20 6c 6f 63 6b 73 20 61 72 65 0a 2a 2a 20 61 6e   locks are.** an
1200: 20 61 62 6f 6d 69 6e 61 74 69 6f 6e 2e 29 0a 2a   abomination.).*
1210: 2a 0a 2a 2a 20 49 66 20 79 6f 75 20 63 6c 6f 73  *.** If you clos
1220: 65 20 61 20 66 69 6c 65 20 64 65 73 63 72 69 70  e a file descrip
1230: 74 6f 72 20 74 68 61 74 20 70 6f 69 6e 74 73 20  tor that points 
1240: 74 6f 20 61 20 66 69 6c 65 20 74 68 61 74 20 68  to a file that h
1250: 61 73 20 6c 6f 63 6b 73 2c 0a 2a 2a 20 61 6c 6c  as locks,.** all
1260: 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 61 74 20 66   locks on that f
1270: 69 6c 65 20 74 68 61 74 20 61 72 65 20 6f 77 6e  ile that are own
1280: 65 64 20 62 79 20 74 68 65 20 63 75 72 72 65 6e  ed by the curren
1290: 74 20 70 72 6f 63 65 73 73 20 61 72 65 0a 2a 2a  t process are.**
12a0: 20 72 65 6c 65 61 73 65 64 2e 20 20 54 6f 20 77   released.  To w
12b0: 6f 72 6b 20 61 72 6f 75 6e 64 20 74 68 69 73 20  ork around this 
12c0: 70 72 6f 62 6c 65 6d 2c 20 65 61 63 68 20 4f 73  problem, each Os
12d0: 46 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 63  File structure c
12e0: 6f 6e 74 61 69 6e 73 0a 2a 2a 20 61 20 70 6f 69  ontains.** a poi
12f0: 6e 74 65 72 20 74 6f 20 61 6e 20 6f 70 65 6e 43  nter to an openC
1300: 6e 74 20 73 74 72 75 63 74 75 72 65 2e 20 20 54  nt structure.  T
1310: 68 65 72 65 20 69 73 20 6f 6e 65 20 6f 70 65 6e  here is one open
1320: 43 6e 74 20 73 74 72 75 63 74 75 72 65 0a 2a 2a  Cnt structure.**
1330: 20 70 65 72 20 6f 70 65 6e 20 69 6e 6f 64 65 2c   per open inode,
1340: 20 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61   which means tha
1350: 74 20 6d 75 6c 74 69 70 6c 65 20 4f 73 46 69 6c  t multiple OsFil
1360: 65 73 20 63 61 6e 20 70 6f 69 6e 74 20 74 6f 20  es can point to 
1370: 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 6f 70 65 6e  a single.** open
1380: 43 6e 74 2e 20 20 57 68 65 6e 20 61 6e 20 61 74  Cnt.  When an at
1390: 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f  tempt is made to
13a0: 20 63 6c 6f 73 65 20 61 6e 20 4f 73 46 69 6c 65   close an OsFile
13b0: 2c 20 69 66 20 74 68 65 72 65 20 61 72 65 0a 2a  , if there are.*
13c0: 2a 20 6f 74 68 65 72 20 4f 73 46 69 6c 65 73 20  * other OsFiles 
13d0: 6f 70 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65  open on the same
13e0: 20 69 6e 6f 64 65 20 74 68 61 74 20 61 72 65 20   inode that are 
13f0: 68 6f 6c 64 69 6e 67 20 6c 6f 63 6b 73 2c 20 74  holding locks, t
1400: 68 65 20 63 61 6c 6c 0a 2a 2a 20 74 6f 20 63 6c  he call.** to cl
1410: 6f 73 65 28 29 20 74 68 65 20 66 69 6c 65 20 64  ose() the file d
1420: 65 73 63 72 69 70 74 6f 72 20 69 73 20 64 65 66  escriptor is def
1430: 65 72 72 65 64 20 75 6e 74 69 6c 20 61 6c 6c 20  erred until all 
1440: 6f 66 20 74 68 65 20 6c 6f 63 6b 73 20 63 6c 65  of the locks cle
1450: 61 72 2e 0a 2a 2a 20 54 68 65 20 6f 70 65 6e 43  ar..** The openC
1460: 6e 74 20 73 74 72 75 63 74 75 72 65 20 6b 65 65  nt structure kee
1470: 70 73 20 61 20 6c 69 73 74 20 6f 66 20 66 69 6c  ps a list of fil
1480: 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 74 68  e descriptors th
1490: 61 74 20 6e 65 65 64 20 74 6f 0a 2a 2a 20 62 65  at need to.** be
14a0: 20 63 6c 6f 73 65 64 20 61 6e 64 20 74 68 61 74   closed and that
14b0: 20 6c 69 73 74 20 69 73 20 77 61 6c 6b 65 64 20   list is walked 
14c0: 28 61 6e 64 20 63 6c 65 61 72 65 64 29 20 77 68  (and cleared) wh
14d0: 65 6e 20 74 68 65 20 6c 61 73 74 20 6c 6f 63 6b  en the last lock
14e0: 0a 2a 2a 20 63 6c 65 61 72 73 2e 0a 2a 2a 0a 2a  .** clears..**.*
14f0: 2a 20 46 69 72 73 74 2c 20 75 6e 64 65 72 20 4c  * First, under L
1500: 69 6e 75 78 20 74 68 72 65 61 64 73 2c 20 62 65  inux threads, be
1510: 63 61 75 73 65 20 65 61 63 68 20 74 68 72 65 61  cause each threa
1520: 64 20 68 61 73 20 61 20 73 65 70 61 72 61 74 65  d has a separate
1530: 0a 2a 2a 20 70 72 6f 63 65 73 73 20 49 44 2c 20  .** process ID, 
1540: 6c 6f 63 6b 20 6f 70 65 72 61 74 69 6f 6e 73 20  lock operations 
1550: 69 6e 20 6f 6e 65 20 74 68 72 65 61 64 20 64 6f  in one thread do
1560: 20 6e 6f 74 20 6f 76 65 72 72 69 64 65 20 6c 6f   not override lo
1570: 63 6b 73 0a 2a 2a 20 74 6f 20 74 68 65 20 73 61  cks.** to the sa
1580: 6d 65 20 66 69 6c 65 20 69 6e 20 6f 74 68 65 72  me file in other
1590: 20 74 68 72 65 61 64 73 2e 20 20 4c 69 6e 75 78   threads.  Linux
15a0: 20 74 68 72 65 61 64 73 20 62 65 68 61 76 65 20   threads behave 
15b0: 6c 69 6b 65 0a 2a 2a 20 73 65 70 61 72 61 74 65  like.** separate
15c0: 20 70 72 6f 63 65 73 73 65 73 20 69 6e 20 74 68   processes in th
15d0: 69 73 20 72 65 73 70 65 63 74 2e 20 20 42 75 74  is respect.  But
15e0: 2c 20 69 66 20 79 6f 75 20 63 6c 6f 73 65 20 61  , if you close a
15f0: 20 66 69 6c 65 0a 2a 2a 20 64 65 73 63 72 69 70   file.** descrip
1600: 74 6f 72 20 69 6e 20 6c 69 6e 75 78 20 74 68 72  tor in linux thr
1610: 65 61 64 73 2c 20 61 6c 6c 20 6c 6f 63 6b 73 20  eads, all locks 
1620: 61 72 65 20 63 6c 65 61 72 65 64 2c 20 65 76 65  are cleared, eve
1630: 6e 20 6c 6f 63 6b 73 0a 2a 2a 20 6f 6e 20 6f 74  n locks.** on ot
1640: 68 65 72 20 74 68 72 65 61 64 73 20 61 6e 64 20  her threads and 
1650: 65 76 65 6e 20 74 68 6f 75 67 68 20 74 68 65 20  even though the 
1660: 6f 74 68 65 72 20 74 68 72 65 61 64 73 20 68 61  other threads ha
1670: 76 65 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20  ve different.** 
1680: 70 72 6f 63 65 73 73 20 49 44 73 2e 20 20 4c 69  process IDs.  Li
1690: 6e 75 78 20 74 68 72 65 61 64 73 20 69 73 20 69  nux threads is i
16a0: 6e 63 6f 6e 73 69 73 74 65 6e 74 20 69 6e 20 74  nconsistent in t
16b0: 68 69 73 20 72 65 73 70 65 63 74 2e 0a 2a 2a 20  his respect..** 
16c0: 28 49 27 6d 20 62 65 67 69 6e 6e 69 6e 67 20 74  (I'm beginning t
16d0: 6f 20 74 68 69 6e 6b 20 74 68 61 74 20 6c 69 6e  o think that lin
16e0: 75 78 20 74 68 72 65 61 64 73 20 69 73 20 61 6e  ux threads is an
16f0: 20 61 62 6f 6d 69 6e 61 74 69 6f 6e 20 74 6f 6f   abomination too
1700: 2e 29 0a 2a 2a 20 54 68 65 20 63 6f 6e 73 65 71  .).** The conseq
1710: 75 65 6e 63 65 20 6f 66 20 74 68 69 73 20 61 6c  uence of this al
1720: 6c 20 69 73 20 74 68 61 74 20 74 68 65 20 68 61  l is that the ha
1730: 73 68 20 74 61 62 6c 65 20 66 6f 72 20 74 68 65  sh table for the
1740: 20 6c 6f 63 6b 49 6e 66 6f 0a 2a 2a 20 73 74 72   lockInfo.** str
1750: 75 63 74 75 72 65 20 68 61 73 20 74 6f 20 69 6e  ucture has to in
1760: 63 6c 75 64 65 20 74 68 65 20 70 72 6f 63 65 73  clude the proces
1770: 73 20 69 64 20 61 73 20 70 61 72 74 20 6f 66 20  s id as part of 
1780: 69 74 73 20 6b 65 79 20 62 65 63 61 75 73 65 0a  its key because.
1790: 2a 2a 20 6c 6f 63 6b 73 20 69 6e 20 64 69 66 66  ** locks in diff
17a0: 65 72 65 6e 74 20 74 68 72 65 61 64 73 20 61 72  erent threads ar
17b0: 65 20 74 72 65 61 74 65 64 20 61 73 20 64 69 73  e treated as dis
17c0: 74 69 6e 63 74 2e 20 20 42 75 74 20 74 68 65 20  tinct.  But the 
17d0: 0a 2a 2a 20 6f 70 65 6e 43 6e 74 20 73 74 72 75  .** openCnt stru
17e0: 63 74 75 72 65 20 73 68 6f 75 6c 64 20 6e 6f 74  cture should not
17f0: 20 69 6e 63 6c 75 64 65 20 74 68 65 20 70 72 6f   include the pro
1800: 63 65 73 73 20 69 64 20 69 6e 20 69 74 73 0a 2a  cess id in its.*
1810: 2a 20 6b 65 79 20 62 65 63 61 75 73 65 20 63 6c  * key because cl
1820: 6f 73 65 28 29 20 63 6c 65 61 72 73 20 6c 6f 63  ose() clears loc
1830: 6b 20 6f 6e 20 61 6c 6c 20 74 68 72 65 61 64 73  k on all threads
1840: 2c 20 6e 6f 74 20 6a 75 73 74 20 74 68 65 20 63  , not just the c
1850: 75 72 72 65 6e 74 0a 2a 2a 20 74 68 72 65 61 64  urrent.** thread
1860: 2e 20 20 57 65 72 65 20 69 74 20 6e 6f 74 20 66  .  Were it not f
1870: 6f 72 20 74 68 69 73 20 67 6f 6f 66 69 6e 65 73  or this goofines
1880: 73 20 69 6e 20 6c 69 6e 75 78 20 74 68 72 65 61  s in linux threa
1890: 64 73 2c 20 77 65 20 63 6f 75 6c 64 0a 2a 2a 20  ds, we could.** 
18a0: 63 6f 6d 62 69 6e 65 20 74 68 65 20 6c 6f 63 6b  combine the lock
18b0: 49 6e 66 6f 20 61 6e 64 20 6f 70 65 6e 43 6e 74  Info and openCnt
18c0: 20 73 74 72 75 63 74 75 72 65 73 20 69 6e 74 6f   structures into
18d0: 20 61 20 73 69 6e 67 6c 65 20 73 74 72 75 63 74   a single struct
18e0: 75 72 65 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41  ure..*/../*.** A
18f0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
1900: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  e following stru
1910: 63 74 75 72 65 20 73 65 72 76 65 73 20 61 73 20  cture serves as 
1920: 74 68 65 20 6b 65 79 20 75 73 65 64 0a 2a 2a 20  the key used.** 
1930: 74 6f 20 6c 6f 63 61 74 65 20 61 20 70 61 72 74  to locate a part
1940: 69 63 75 6c 61 72 20 6c 6f 63 6b 49 6e 66 6f 20  icular lockInfo 
1950: 73 74 72 75 63 74 75 72 65 20 67 69 76 65 6e 20  structure given 
1960: 69 74 73 20 69 6e 6f 64 65 2e 20 20 4e 6f 74 65  its inode.  Note
1970: 0a 2a 2a 20 74 68 61 74 20 77 65 20 68 61 76 65  .** that we have
1980: 20 74 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20   to include the 
1990: 70 72 6f 63 65 73 73 20 49 44 20 61 73 20 70 61  process ID as pa
19a0: 72 74 20 6f 66 20 74 68 65 20 6b 65 79 2e 20 20  rt of the key.  
19b0: 4f 6e 20 73 6f 6d 65 0a 2a 2a 20 74 68 72 65 61  On some.** threa
19c0: 64 69 6e 67 20 69 6d 70 6c 65 6d 65 6e 74 61 74  ding implementat
19d0: 69 6f 6e 73 20 28 65 78 3a 20 6c 69 6e 75 78 29  ions (ex: linux)
19e0: 2c 20 65 61 63 68 20 74 68 72 65 61 64 20 68 61  , each thread ha
19f0: 73 20 61 20 73 65 70 61 72 61 74 65 0a 2a 2a 20  s a separate.** 
1a00: 70 72 6f 63 65 73 73 20 49 44 2e 0a 2a 2f 0a 73  process ID..*/.s
1a10: 74 72 75 63 74 20 6c 6f 63 6b 4b 65 79 20 7b 0a  truct lockKey {.
1a20: 20 20 64 65 76 5f 74 20 64 65 76 3b 20 20 20 2f    dev_t dev;   /
1a30: 2a 20 44 65 76 69 63 65 20 6e 75 6d 62 65 72 20  * Device number 
1a40: 2a 2f 0a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20  */.  ino_t ino; 
1a50: 20 20 2f 2a 20 49 6e 6f 64 65 20 6e 75 6d 62 65    /* Inode numbe
1a60: 72 20 2a 2f 0a 20 20 70 69 64 5f 74 20 70 69 64  r */.  pid_t pid
1a70: 3b 20 20 20 2f 2a 20 50 72 6f 63 65 73 73 20 49  ;   /* Process I
1a80: 44 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41  D */.};../*.** A
1a90: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
1aa0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  e following stru
1ab0: 63 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 61 74  cture is allocat
1ac0: 65 64 20 66 6f 72 20 65 61 63 68 20 6f 70 65 6e  ed for each open
1ad0: 0a 2a 2a 20 69 6e 6f 64 65 20 6f 6e 20 65 61 63  .** inode on eac
1ae0: 68 20 74 68 72 65 61 64 20 77 69 74 68 20 61 20  h thread with a 
1af0: 64 69 66 66 65 72 65 6e 74 20 70 72 6f 63 65 73  different proces
1b00: 73 20 49 44 2e 20 20 28 54 68 72 65 61 64 73 20  s ID.  (Threads 
1b10: 68 61 76 65 0a 2a 2a 20 64 69 66 66 65 72 65 6e  have.** differen
1b20: 74 20 70 72 6f 63 65 73 73 20 49 44 73 20 6f 6e  t process IDs on
1b30: 20 6c 69 6e 75 78 2c 20 62 75 74 20 6e 6f 74 20   linux, but not 
1b40: 6f 6e 20 6d 6f 73 74 20 6f 74 68 65 72 20 75 6e  on most other un
1b50: 69 78 65 73 2e 29 0a 2a 2a 0a 2a 2a 20 41 20 73  ixes.).**.** A s
1b60: 69 6e 67 6c 65 20 69 6e 6f 64 65 20 63 61 6e 20  ingle inode can 
1b70: 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 20 66 69  have multiple fi
1b80: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 2c 20  le descriptors, 
1b90: 73 6f 20 65 61 63 68 20 4f 73 46 69 6c 65 0a 2a  so each OsFile.*
1ba0: 2a 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74  * structure cont
1bb0: 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74  ains a pointer t
1bc0: 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66  o an instance of
1bd0: 20 74 68 69 73 20 6f 62 6a 65 63 74 20 61 6e 64   this object and
1be0: 20 74 68 69 73 0a 2a 2a 20 6f 62 6a 65 63 74 20   this.** object 
1bf0: 6b 65 65 70 73 20 61 20 63 6f 75 6e 74 20 6f 66  keeps a count of
1c00: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 4f   the number of O
1c10: 73 46 69 6c 65 73 20 70 6f 69 6e 74 69 6e 67 20  sFiles pointing 
1c20: 74 6f 20 69 74 2e 0a 2a 2f 0a 73 74 72 75 63 74  to it..*/.struct
1c30: 20 6c 6f 63 6b 49 6e 66 6f 20 7b 0a 20 20 73 74   lockInfo {.  st
1c40: 72 75 63 74 20 6c 6f 63 6b 4b 65 79 20 6b 65 79  ruct lockKey key
1c50: 3b 20 20 2f 2a 20 54 68 65 20 6c 6f 6f 6b 75 70  ;  /* The lookup
1c60: 20 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20 63 6e   key */.  int cn
1c70: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  t;             /
1c80: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 53 48 41 52  * Number of SHAR
1c90: 45 44 20 6c 6f 63 6b 73 20 68 65 6c 64 20 2a 2f  ED locks held */
1ca0: 0a 20 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65 3b  .  int locktype;
1cb0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f          /* One o
1cc0: 66 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c 20 52  f SHARED_LOCK, R
1cd0: 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 65 74 63  ESERVED_LOCK etc
1ce0: 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b  . */.  int nRef;
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
1d00: 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 65 72  umber of pointer
1d10: 73 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74  s to this struct
1d20: 75 72 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  ure */.};../*.**
1d30: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   An instance of 
1d40: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  the following st
1d50: 72 75 63 74 75 72 65 20 73 65 72 76 65 73 20 61  ructure serves a
1d60: 73 20 74 68 65 20 6b 65 79 20 75 73 65 64 0a 2a  s the key used.*
1d70: 2a 20 74 6f 20 6c 6f 63 61 74 65 20 61 20 70 61  * to locate a pa
1d80: 72 74 69 63 75 6c 61 72 20 6f 70 65 6e 43 6e 74  rticular openCnt
1d90: 20 73 74 72 75 63 74 75 72 65 20 67 69 76 65 6e   structure given
1da0: 20 69 74 73 20 69 6e 6f 64 65 2e 20 20 54 68 69   its inode.  Thi
1db0: 73 0a 2a 2a 20 69 73 20 74 68 65 20 73 61 6d 65  s.** is the same
1dc0: 20 61 73 20 74 68 65 20 6c 6f 63 6b 4b 65 79 20   as the lockKey 
1dd0: 65 78 63 65 70 74 20 74 68 61 74 20 74 68 65 20  except that the 
1de0: 70 72 6f 63 65 73 73 20 49 44 20 69 73 20 6f 6d  process ID is om
1df0: 69 74 74 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74  itted..*/.struct
1e00: 20 6f 70 65 6e 4b 65 79 20 7b 0a 20 20 64 65 76   openKey {.  dev
1e10: 5f 74 20 64 65 76 3b 20 20 20 2f 2a 20 44 65 76  _t dev;   /* Dev
1e20: 69 63 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20  ice number */.  
1e30: 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20 20 2f 2a 20  ino_t ino;   /* 
1e40: 49 6e 6f 64 65 20 6e 75 6d 62 65 72 20 2a 2f 0a  Inode number */.
1e50: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73  };../*.** An ins
1e60: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c  tance of the fol
1e70: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65  lowing structure
1e80: 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f   is allocated fo
1e90: 72 20 65 61 63 68 20 6f 70 65 6e 0a 2a 2a 20 69  r each open.** i
1ea0: 6e 6f 64 65 2e 20 20 54 68 69 73 20 73 74 72 75  node.  This stru
1eb0: 63 74 75 72 65 20 6b 65 65 70 73 20 74 72 61 63  cture keeps trac
1ec0: 6b 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20  k of the number 
1ed0: 6f 66 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 61 74  of locks on that
1ee0: 0a 2a 2a 20 69 6e 6f 64 65 2e 20 20 49 66 20 61  .** inode.  If a
1ef0: 20 63 6c 6f 73 65 20 69 73 20 61 74 74 65 6d 70   close is attemp
1f00: 74 65 64 20 61 67 61 69 6e 73 74 20 61 6e 20 69  ted against an i
1f10: 6e 6f 64 65 20 74 68 61 74 20 69 73 20 68 6f 6c  node that is hol
1f20: 64 69 6e 67 0a 2a 2a 20 6c 6f 63 6b 73 2c 20 74  ding.** locks, t
1f30: 68 65 20 63 6c 6f 73 65 20 69 73 20 64 65 66 65  he close is defe
1f40: 72 72 65 64 20 75 6e 74 69 6c 20 61 6c 6c 20 6c  rred until all l
1f50: 6f 63 6b 73 20 63 6c 65 61 72 20 62 79 20 61 64  ocks clear by ad
1f60: 64 69 6e 67 20 74 68 65 0a 2a 2a 20 66 69 6c 65  ding the.** file
1f70: 20 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20 62   descriptor to b
1f80: 65 20 63 6c 6f 73 65 64 20 74 6f 20 74 68 65 20  e closed to the 
1f90: 70 65 6e 64 69 6e 67 20 6c 69 73 74 2e 0a 2a 2f  pending list..*/
1fa0: 0a 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 20  .struct openCnt 
1fb0: 7b 0a 20 20 73 74 72 75 63 74 20 6f 70 65 6e 4b  {.  struct openK
1fc0: 65 79 20 6b 65 79 3b 20 20 20 2f 2a 20 54 68 65  ey key;   /* The
1fd0: 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f 0a 20   lookup key */. 
1fe0: 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20   int nRef;      
1ff0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
2000: 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20   of pointers to 
2010: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a  this structure *
2020: 2f 0a 20 20 69 6e 74 20 6e 4c 6f 63 6b 3b 20 20  /.  int nLock;  
2030: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
2040: 62 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64 69  ber of outstandi
2050: 6e 67 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e  ng locks */.  in
2060: 74 20 6e 50 65 6e 64 69 6e 67 3b 20 20 20 20 20  t nPending;     
2070: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
2080: 20 70 65 6e 64 69 6e 67 20 63 6c 6f 73 65 28 29   pending close()
2090: 20 6f 70 65 72 61 74 69 6f 6e 73 20 2a 2f 0a 20   operations */. 
20a0: 20 69 6e 74 20 2a 61 50 65 6e 64 69 6e 67 3b 20   int *aPending; 
20b0: 20 20 20 20 20 20 20 2f 2a 20 4d 61 6c 6c 6f 63         /* Malloc
20c0: 65 64 20 73 70 61 63 65 20 68 6f 6c 64 69 6e 67  ed space holding
20d0: 20 66 64 27 73 20 61 77 61 69 74 69 6e 67 20 61   fd's awaiting a
20e0: 20 63 6c 6f 73 65 28 29 20 2a 2f 0a 7d 3b 0a 0a   close() */.};..
20f0: 2f 2a 20 0a 2a 2a 20 54 68 65 73 65 20 68 61 73  /* .** These has
2100: 68 20 74 61 62 6c 65 20 6d 61 70 73 20 69 6e 6f  h table maps ino
2110: 64 65 73 20 61 6e 64 20 70 72 6f 63 65 73 73 20  des and process 
2120: 49 44 73 20 69 6e 74 6f 20 6c 6f 63 6b 49 6e 66  IDs into lockInf
2130: 6f 20 61 6e 64 20 6f 70 65 6e 43 6e 74 0a 2a 2a  o and openCnt.**
2140: 20 73 74 72 75 63 74 75 72 65 73 2e 20 20 41 63   structures.  Ac
2150: 63 65 73 73 20 74 6f 20 74 68 65 73 65 20 68 61  cess to these ha
2160: 73 68 20 74 61 62 6c 65 73 20 6d 75 73 74 20 62  sh tables must b
2170: 65 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 61  e protected by a
2180: 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74 69   mutex..*/.stati
2190: 63 20 48 61 73 68 20 6c 6f 63 6b 48 61 73 68 20  c Hash lockHash 
21a0: 3d 20 7b 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  = { SQLITE_HASH_
21b0: 42 49 4e 41 52 59 2c 20 30 2c 20 30 2c 20 30 2c  BINARY, 0, 0, 0,
21c0: 20 30 2c 20 30 20 7d 3b 0a 73 74 61 74 69 63 20   0, 0 };.static 
21d0: 48 61 73 68 20 6f 70 65 6e 48 61 73 68 20 3d 20  Hash openHash = 
21e0: 7b 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 42 49  { SQLITE_HASH_BI
21f0: 4e 41 52 59 2c 20 30 2c 20 30 2c 20 30 2c 20 30  NARY, 0, 0, 0, 0
2200: 2c 20 30 20 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65  , 0 };../*.** Re
2210: 6c 65 61 73 65 20 61 20 6c 6f 63 6b 49 6e 66 6f  lease a lockInfo
2220: 20 73 74 72 75 63 74 75 72 65 20 70 72 65 76 69   structure previ
2230: 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20  ously allocated 
2240: 62 79 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28  by findLockInfo(
2250: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  )..*/.static voi
2260: 64 20 72 65 6c 65 61 73 65 4c 6f 63 6b 49 6e 66  d releaseLockInf
2270: 6f 28 73 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66  o(struct lockInf
2280: 6f 20 2a 70 4c 6f 63 6b 29 7b 0a 20 20 70 4c 6f  o *pLock){.  pLo
2290: 63 6b 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66  ck->nRef--;.  if
22a0: 28 20 70 4c 6f 63 6b 2d 3e 6e 52 65 66 3d 3d 30  ( pLock->nRef==0
22b0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 48   ){.    sqlite3H
22c0: 61 73 68 49 6e 73 65 72 74 28 26 6c 6f 63 6b 48  ashInsert(&lockH
22d0: 61 73 68 2c 20 26 70 4c 6f 63 6b 2d 3e 6b 65 79  ash, &pLock->key
22e0: 2c 20 73 69 7a 65 6f 66 28 70 4c 6f 63 6b 2d 3e  , sizeof(pLock->
22f0: 6b 65 79 29 2c 20 30 29 3b 0a 20 20 20 20 73 71  key), 0);.    sq
2300: 6c 69 74 65 46 72 65 65 28 70 4c 6f 63 6b 29 3b  liteFree(pLock);
2310: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  .  }.}../*.** Re
2320: 6c 65 61 73 65 20 61 20 6f 70 65 6e 43 6e 74 20  lease a openCnt 
2330: 73 74 72 75 63 74 75 72 65 20 70 72 65 76 69 6f  structure previo
2340: 75 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 62  usly allocated b
2350: 79 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 29  y findLockInfo()
2360: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
2370: 20 72 65 6c 65 61 73 65 4f 70 65 6e 43 6e 74 28   releaseOpenCnt(
2380: 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a  struct openCnt *
2390: 70 4f 70 65 6e 29 7b 0a 20 20 70 4f 70 65 6e 2d  pOpen){.  pOpen-
23a0: 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70  >nRef--;.  if( p
23b0: 4f 70 65 6e 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b  Open->nRef==0 ){
23c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68  .    sqlite3Hash
23d0: 49 6e 73 65 72 74 28 26 6f 70 65 6e 48 61 73 68  Insert(&openHash
23e0: 2c 20 26 70 4f 70 65 6e 2d 3e 6b 65 79 2c 20 73  , &pOpen->key, s
23f0: 69 7a 65 6f 66 28 70 4f 70 65 6e 2d 3e 6b 65 79  izeof(pOpen->key
2400: 29 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74  ), 0);.    sqlit
2410: 65 46 72 65 65 28 70 4f 70 65 6e 2d 3e 61 50 65  eFree(pOpen->aPe
2420: 6e 64 69 6e 67 29 3b 0a 20 20 20 20 73 71 6c 69  nding);.    sqli
2430: 74 65 46 72 65 65 28 70 4f 70 65 6e 29 3b 0a 20  teFree(pOpen);. 
2440: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65   }.}../*.** Give
2450: 6e 20 61 20 66 69 6c 65 20 64 65 73 63 72 69 70  n a file descrip
2460: 74 6f 72 2c 20 6c 6f 63 61 74 65 20 6c 6f 63 6b  tor, locate lock
2470: 49 6e 66 6f 20 61 6e 64 20 6f 70 65 6e 43 6e 74  Info and openCnt
2480: 20 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74   structures that
2490: 0a 2a 2a 20 64 65 73 63 72 69 62 65 73 20 74 68  .** describes th
24a0: 61 74 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  at file descript
24b0: 6f 72 2e 20 20 43 72 65 61 74 65 20 61 20 6e 65  or.  Create a ne
24c0: 77 20 6f 6e 65 73 20 69 66 20 6e 65 63 65 73 73  w ones if necess
24d0: 61 72 79 2e 20 20 54 68 65 0a 2a 2a 20 72 65 74  ary.  The.** ret
24e0: 75 72 6e 20 76 61 6c 75 65 73 20 6d 69 67 68 74  urn values might
24f0: 20 62 65 20 75 6e 73 65 74 20 69 66 20 61 6e 20   be unset if an 
2500: 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2a  error occurs..**
2510: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
2520: 75 6d 62 65 72 20 6f 66 20 65 72 72 6f 72 73 2e  umber of errors.
2530: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66  .*/.static int f
2540: 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 0a 20 20 69  indLockInfo(.  i
2550: 6e 74 20 66 64 2c 20 20 20 20 20 20 20 20 20 20  nt fd,          
2560: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2570: 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  he file descript
2580: 6f 72 20 75 73 65 64 20 69 6e 20 74 68 65 20 6b  or used in the k
2590: 65 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 6c  ey */.  struct l
25a0: 6f 63 6b 49 6e 66 6f 20 2a 2a 70 70 4c 6f 63 6b  ockInfo **ppLock
25b0: 2c 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74  ,    /* Return t
25c0: 68 65 20 6c 6f 63 6b 49 6e 66 6f 20 73 74 72 75  he lockInfo stru
25d0: 63 74 75 72 65 20 68 65 72 65 20 2a 2f 0a 20 20  cture here */.  
25e0: 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a  struct openCnt *
25f0: 2a 70 70 4f 70 65 6e 20 20 20 2f 2a 20 52 65 74  *ppOpen   /* Ret
2600: 75 72 6e 20 74 68 65 20 6f 70 65 6e 43 6e 74 20  urn the openCnt 
2610: 73 74 72 75 63 74 75 72 65 20 68 65 72 65 20 2a  structure here *
2620: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  /.){.  int rc;. 
2630: 20 73 74 72 75 63 74 20 6c 6f 63 6b 4b 65 79 20   struct lockKey 
2640: 6b 65 79 31 3b 0a 20 20 73 74 72 75 63 74 20 6f  key1;.  struct o
2650: 70 65 6e 4b 65 79 20 6b 65 79 32 3b 0a 20 20 73  penKey key2;.  s
2660: 74 72 75 63 74 20 73 74 61 74 20 73 74 61 74 62  truct stat statb
2670: 75 66 3b 0a 20 20 73 74 72 75 63 74 20 6c 6f 63  uf;.  struct loc
2680: 6b 49 6e 66 6f 20 2a 70 4c 6f 63 6b 3b 0a 20 20  kInfo *pLock;.  
2690: 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a  struct openCnt *
26a0: 70 4f 70 65 6e 3b 0a 20 20 72 63 20 3d 20 66 73  pOpen;.  rc = fs
26b0: 74 61 74 28 66 64 2c 20 26 73 74 61 74 62 75 66  tat(fd, &statbuf
26c0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 30 20 29  );.  if( rc!=0 )
26d0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 6d 65 6d   return 1;.  mem
26e0: 73 65 74 28 26 6b 65 79 31 2c 20 30 2c 20 73 69  set(&key1, 0, si
26f0: 7a 65 6f 66 28 6b 65 79 31 29 29 3b 0a 20 20 6b  zeof(key1));.  k
2700: 65 79 31 2e 64 65 76 20 3d 20 73 74 61 74 62 75  ey1.dev = statbu
2710: 66 2e 73 74 5f 64 65 76 3b 0a 20 20 6b 65 79 31  f.st_dev;.  key1
2720: 2e 69 6e 6f 20 3d 20 73 74 61 74 62 75 66 2e 73  .ino = statbuf.s
2730: 74 5f 69 6e 6f 3b 0a 20 20 6b 65 79 31 2e 70 69  t_ino;.  key1.pi
2740: 64 20 3d 20 67 65 74 70 69 64 28 29 3b 0a 20 20  d = getpid();.  
2750: 6d 65 6d 73 65 74 28 26 6b 65 79 32 2c 20 30 2c  memset(&key2, 0,
2760: 20 73 69 7a 65 6f 66 28 6b 65 79 32 29 29 3b 0a   sizeof(key2));.
2770: 20 20 6b 65 79 32 2e 64 65 76 20 3d 20 73 74 61    key2.dev = sta
2780: 74 62 75 66 2e 73 74 5f 64 65 76 3b 0a 20 20 6b  tbuf.st_dev;.  k
2790: 65 79 32 2e 69 6e 6f 20 3d 20 73 74 61 74 62 75  ey2.ino = statbu
27a0: 66 2e 73 74 5f 69 6e 6f 3b 0a 20 20 70 4c 6f 63  f.st_ino;.  pLoc
27b0: 6b 20 3d 20 28 73 74 72 75 63 74 20 6c 6f 63 6b  k = (struct lock
27c0: 49 6e 66 6f 2a 29 73 71 6c 69 74 65 33 48 61 73  Info*)sqlite3Has
27d0: 68 46 69 6e 64 28 26 6c 6f 63 6b 48 61 73 68 2c  hFind(&lockHash,
27e0: 20 26 6b 65 79 31 2c 20 73 69 7a 65 6f 66 28 6b   &key1, sizeof(k
27f0: 65 79 31 29 29 3b 0a 20 20 69 66 28 20 70 4c 6f  ey1));.  if( pLo
2800: 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 72  ck==0 ){.    str
2810: 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70 4f  uct lockInfo *pO
2820: 6c 64 3b 0a 20 20 20 20 70 4c 6f 63 6b 20 3d 20  ld;.    pLock = 
2830: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 52 61 77 28  sqliteMallocRaw(
2840: 20 73 69 7a 65 6f 66 28 2a 70 4c 6f 63 6b 29 20   sizeof(*pLock) 
2850: 29 3b 0a 20 20 20 20 69 66 28 20 70 4c 6f 63 6b  );.    if( pLock
2860: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  ==0 ) return 1;.
2870: 20 20 20 20 70 4c 6f 63 6b 2d 3e 6b 65 79 20 3d      pLock->key =
2880: 20 6b 65 79 31 3b 0a 20 20 20 20 70 4c 6f 63 6b   key1;.    pLock
2890: 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20  ->nRef = 1;.    
28a0: 70 4c 6f 63 6b 2d 3e 63 6e 74 20 3d 20 30 3b 0a  pLock->cnt = 0;.
28b0: 20 20 20 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74      pLock->lockt
28c0: 79 70 65 20 3d 20 30 3b 0a 20 20 20 20 70 4f 6c  ype = 0;.    pOl
28d0: 64 20 3d 20 73 71 6c 69 74 65 33 48 61 73 68 49  d = sqlite3HashI
28e0: 6e 73 65 72 74 28 26 6c 6f 63 6b 48 61 73 68 2c  nsert(&lockHash,
28f0: 20 26 70 4c 6f 63 6b 2d 3e 6b 65 79 2c 20 73 69   &pLock->key, si
2900: 7a 65 6f 66 28 6b 65 79 31 29 2c 20 70 4c 6f 63  zeof(key1), pLoc
2910: 6b 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64  k);.    if( pOld
2920: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 61 73 73  !=0 ){.      ass
2930: 65 72 74 28 20 70 4f 6c 64 3d 3d 70 4c 6f 63 6b  ert( pOld==pLock
2940: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
2950: 46 72 65 65 28 70 4c 6f 63 6b 29 3b 0a 20 20 20  Free(pLock);.   
2960: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20     return 1;.   
2970: 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20   }.  }else{.    
2980: 70 4c 6f 63 6b 2d 3e 6e 52 65 66 2b 2b 3b 0a 20  pLock->nRef++;. 
2990: 20 7d 0a 20 20 2a 70 70 4c 6f 63 6b 20 3d 20 70   }.  *ppLock = p
29a0: 4c 6f 63 6b 3b 0a 20 20 70 4f 70 65 6e 20 3d 20  Lock;.  pOpen = 
29b0: 28 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 2a  (struct openCnt*
29c0: 29 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64  )sqlite3HashFind
29d0: 28 26 6f 70 65 6e 48 61 73 68 2c 20 26 6b 65 79  (&openHash, &key
29e0: 32 2c 20 73 69 7a 65 6f 66 28 6b 65 79 32 29 29  2, sizeof(key2))
29f0: 3b 0a 20 20 69 66 28 20 70 4f 70 65 6e 3d 3d 30  ;.  if( pOpen==0
2a00: 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 6f   ){.    struct o
2a10: 70 65 6e 43 6e 74 20 2a 70 4f 6c 64 3b 0a 20 20  penCnt *pOld;.  
2a20: 20 20 70 4f 70 65 6e 20 3d 20 73 71 6c 69 74 65    pOpen = sqlite
2a30: 4d 61 6c 6c 6f 63 52 61 77 28 20 73 69 7a 65 6f  MallocRaw( sizeo
2a40: 66 28 2a 70 4f 70 65 6e 29 20 29 3b 0a 20 20 20  f(*pOpen) );.   
2a50: 20 69 66 28 20 70 4f 70 65 6e 3d 3d 30 20 29 7b   if( pOpen==0 ){
2a60: 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 4c 6f  .      releaseLo
2a70: 63 6b 49 6e 66 6f 28 70 4c 6f 63 6b 29 3b 0a 20  ckInfo(pLock);. 
2a80: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20       return 1;. 
2a90: 20 20 20 7d 0a 20 20 20 20 70 4f 70 65 6e 2d 3e     }.    pOpen->
2aa0: 6b 65 79 20 3d 20 6b 65 79 32 3b 0a 20 20 20 20  key = key2;.    
2ab0: 70 4f 70 65 6e 2d 3e 6e 52 65 66 20 3d 20 31 3b  pOpen->nRef = 1;
2ac0: 0a 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 4c 6f 63  .    pOpen->nLoc
2ad0: 6b 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 65 6e  k = 0;.    pOpen
2ae0: 2d 3e 6e 50 65 6e 64 69 6e 67 20 3d 20 30 3b 0a  ->nPending = 0;.
2af0: 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64      pOpen->aPend
2b00: 69 6e 67 20 3d 20 30 3b 0a 20 20 20 20 70 4f 6c  ing = 0;.    pOl
2b10: 64 20 3d 20 73 71 6c 69 74 65 33 48 61 73 68 49  d = sqlite3HashI
2b20: 6e 73 65 72 74 28 26 6f 70 65 6e 48 61 73 68 2c  nsert(&openHash,
2b30: 20 26 70 4f 70 65 6e 2d 3e 6b 65 79 2c 20 73 69   &pOpen->key, si
2b40: 7a 65 6f 66 28 6b 65 79 32 29 2c 20 70 4f 70 65  zeof(key2), pOpe
2b50: 6e 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64  n);.    if( pOld
2b60: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 61 73 73  !=0 ){.      ass
2b70: 65 72 74 28 20 70 4f 6c 64 3d 3d 70 4f 70 65 6e  ert( pOld==pOpen
2b80: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
2b90: 46 72 65 65 28 70 4f 70 65 6e 29 3b 0a 20 20 20  Free(pOpen);.   
2ba0: 20 20 20 72 65 6c 65 61 73 65 4c 6f 63 6b 49 6e     releaseLockIn
2bb0: 66 6f 28 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 20  fo(pLock);.     
2bc0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d   return 1;.    }
2bd0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4f  .  }else{.    pO
2be0: 70 65 6e 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 7d  pen->nRef++;.  }
2bf0: 0a 20 20 2a 70 70 4f 70 65 6e 20 3d 20 70 4f 70  .  *ppOpen = pOp
2c00: 65 6e 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a  en;.  return 0;.
2c10: 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20  }../*.** Delete 
2c20: 74 68 65 20 6e 61 6d 65 64 20 66 69 6c 65 0a 2a  the named file.*
2c30: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 44  /.int sqlite3OsD
2c40: 65 6c 65 74 65 28 63 6f 6e 73 74 20 63 68 61 72  elete(const char
2c50: 20 2a 7a 46 69 6c 65 6e 61 6d 65 29 7b 0a 20 20   *zFilename){.  
2c60: 75 6e 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65  unlink(zFilename
2c70: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
2c80: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
2c90: 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74  Return TRUE if t
2ca0: 68 65 20 6e 61 6d 65 64 20 66 69 6c 65 20 65 78  he named file ex
2cb0: 69 73 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ists..*/.int sql
2cc0: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
2cd0: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
2ce0: 6c 65 6e 61 6d 65 29 7b 0a 20 20 72 65 74 75 72  lename){.  retur
2cf0: 6e 20 61 63 63 65 73 73 28 7a 46 69 6c 65 6e 61  n access(zFilena
2d00: 6d 65 2c 20 30 29 3d 3d 30 3b 0a 7d 0a 0a 2f 2a  me, 0)==0;.}../*
2d10: 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f  .** Attempt to o
2d20: 70 65 6e 20 61 20 66 69 6c 65 20 66 6f 72 20 62  pen a file for b
2d30: 6f 74 68 20 72 65 61 64 69 6e 67 20 61 6e 64 20  oth reading and 
2d40: 77 72 69 74 69 6e 67 2e 20 20 49 66 20 74 68 61  writing.  If tha
2d50: 74 0a 2a 2a 20 66 61 69 6c 73 2c 20 74 72 79 20  t.** fails, try 
2d60: 6f 70 65 6e 69 6e 67 20 69 74 20 72 65 61 64 2d  opening it read-
2d70: 6f 6e 6c 79 2e 20 20 49 66 20 74 68 65 20 66 69  only.  If the fi
2d80: 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73  le does not exis
2d90: 74 2c 0a 2a 2a 20 74 72 79 20 74 6f 20 63 72 65  t,.** try to cre
2da0: 61 74 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  ate it..**.** On
2db0: 20 73 75 63 63 65 73 73 2c 20 61 20 68 61 6e 64   success, a hand
2dc0: 6c 65 20 66 6f 72 20 74 68 65 20 6f 70 65 6e 20  le for the open 
2dd0: 66 69 6c 65 20 69 73 20 77 72 69 74 74 65 6e 20  file is written 
2de0: 74 6f 20 2a 69 64 0a 2a 2a 20 61 6e 64 20 2a 70  to *id.** and *p
2df0: 52 65 61 64 6f 6e 6c 79 20 69 73 20 73 65 74 20  Readonly is set 
2e00: 74 6f 20 30 20 69 66 20 74 68 65 20 66 69 6c 65  to 0 if the file
2e10: 20 77 61 73 20 6f 70 65 6e 65 64 20 66 6f 72 20   was opened for 
2e20: 72 65 61 64 69 6e 67 20 61 6e 64 0a 2a 2a 20 77  reading and.** w
2e30: 72 69 74 69 6e 67 20 6f 72 20 31 20 69 66 20 74  riting or 1 if t
2e40: 68 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 6e  he file was open
2e50: 65 64 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 20 54  ed read-only.  T
2e60: 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75  he function retu
2e70: 72 6e 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b  rns.** SQLITE_OK
2e80: 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75  ..**.** On failu
2e90: 72 65 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e  re, the function
2ea0: 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f   returns SQLITE_
2eb0: 43 41 4e 54 4f 50 45 4e 20 61 6e 64 20 6c 65 61  CANTOPEN and lea
2ec0: 76 65 73 0a 2a 2a 20 2a 69 64 20 61 6e 64 20 2a  ves.** *id and *
2ed0: 70 52 65 61 64 6f 6e 6c 79 20 75 6e 63 68 61 6e  pReadonly unchan
2ee0: 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ged..*/.int sqli
2ef0: 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57 72 69  te3OsOpenReadWri
2f00: 74 65 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  te(.  const char
2f10: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 4f   *zFilename,.  O
2f20: 73 46 69 6c 65 20 2a 69 64 2c 0a 20 20 69 6e 74  sFile *id,.  int
2f30: 20 2a 70 52 65 61 64 6f 6e 6c 79 0a 29 7b 0a 20   *pReadonly.){. 
2f40: 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72   int rc;.  asser
2f50: 74 28 20 21 69 64 2d 3e 69 73 4f 70 65 6e 20 29  t( !id->isOpen )
2f60: 3b 0a 20 20 69 64 2d 3e 64 69 72 66 64 20 3d 20  ;.  id->dirfd = 
2f70: 2d 31 3b 0a 20 20 69 64 2d 3e 68 20 3d 20 6f 70  -1;.  id->h = op
2f80: 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f  en(zFilename, O_
2f90: 52 44 57 52 7c 4f 5f 43 52 45 41 54 7c 4f 5f 4c  RDWR|O_CREAT|O_L
2fa0: 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52  ARGEFILE|O_BINAR
2fb0: 59 2c 20 30 36 34 34 29 3b 0a 20 20 69 66 28 20  Y, 0644);.  if( 
2fc0: 69 64 2d 3e 68 3c 30 20 29 7b 0a 20 20 20 20 69  id->h<0 ){.    i
2fd0: 64 2d 3e 68 20 3d 20 6f 70 65 6e 28 7a 46 69 6c  d->h = open(zFil
2fe0: 65 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 7c  ename, O_RDONLY|
2ff0: 4f 5f 4c 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49  O_LARGEFILE|O_BI
3000: 4e 41 52 59 29 3b 0a 20 20 20 20 69 66 28 20 69  NARY);.    if( i
3010: 64 2d 3e 68 3c 30 20 29 7b 0a 20 20 20 20 20 20  d->h<0 ){.      
3020: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41  return SQLITE_CA
3030: 4e 54 4f 50 45 4e 3b 20 0a 20 20 20 20 7d 0a 20  NTOPEN; .    }. 
3040: 20 20 20 2a 70 52 65 61 64 6f 6e 6c 79 20 3d 20     *pReadonly = 
3050: 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  1;.  }else{.    
3060: 2a 70 52 65 61 64 6f 6e 6c 79 20 3d 20 30 3b 0a  *pReadonly = 0;.
3070: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 45    }.  sqlite3OsE
3080: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 72  nterMutex();.  r
3090: 63 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f  c = findLockInfo
30a0: 28 69 64 2d 3e 68 2c 20 26 69 64 2d 3e 70 4c 6f  (id->h, &id->pLo
30b0: 63 6b 2c 20 26 69 64 2d 3e 70 4f 70 65 6e 29 3b  ck, &id->pOpen);
30c0: 0a 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76  .  sqlite3OsLeav
30d0: 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20  eMutex();.  if( 
30e0: 72 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28  rc ){.    close(
30f0: 69 64 2d 3e 68 29 3b 0a 20 20 20 20 72 65 74 75  id->h);.    retu
3100: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
3110: 0a 20 20 7d 0a 20 20 69 64 2d 3e 6c 6f 63 6b 74  .  }.  id->lockt
3120: 79 70 65 20 3d 20 30 3b 0a 20 20 69 64 2d 3e 69  ype = 0;.  id->i
3130: 73 4f 70 65 6e 20 3d 20 31 3b 0a 20 20 54 52 41  sOpen = 1;.  TRA
3140: 43 45 33 28 22 4f 50 45 4e 20 20 20 20 25 2d 33  CE3("OPEN    %-3
3150: 64 20 25 73 5c 6e 22 2c 20 69 64 2d 3e 68 2c 20  d %s\n", id->h, 
3160: 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 4f 70  zFilename);.  Op
3170: 65 6e 43 6f 75 6e 74 65 72 28 2b 31 29 3b 0a 20  enCounter(+1);. 
3180: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
3190: 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 41 74 74  K;.}.../*.** Att
31a0: 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 6e  empt to open a n
31b0: 65 77 20 66 69 6c 65 20 66 6f 72 20 65 78 63 6c  ew file for excl
31c0: 75 73 69 76 65 20 61 63 63 65 73 73 20 62 79 20  usive access by 
31d0: 74 68 69 73 20 70 72 6f 63 65 73 73 2e 0a 2a 2a  this process..**
31e0: 20 54 68 65 20 66 69 6c 65 20 77 69 6c 6c 20 62   The file will b
31f0: 65 20 6f 70 65 6e 65 64 20 66 6f 72 20 62 6f 74  e opened for bot
3200: 68 20 72 65 61 64 69 6e 67 20 61 6e 64 20 77 72  h reading and wr
3210: 69 74 69 6e 67 2e 20 20 54 6f 20 61 76 6f 69 64  iting.  To avoid
3220: 0a 2a 2a 20 61 20 70 6f 74 65 6e 74 69 61 6c 20  .** a potential 
3230: 73 65 63 75 72 69 74 79 20 70 72 6f 62 6c 65 6d  security problem
3240: 2c 20 77 65 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f  , we do not allo
3250: 77 20 74 68 65 20 66 69 6c 65 20 74 6f 20 68 61  w the file to ha
3260: 76 65 0a 2a 2a 20 70 72 65 76 69 6f 75 73 6c 79  ve.** previously
3270: 20 65 78 69 73 74 65 64 2e 20 20 4e 6f 72 20 64   existed.  Nor d
3280: 6f 20 77 65 20 61 6c 6c 6f 77 20 74 68 65 20 66  o we allow the f
3290: 69 6c 65 20 74 6f 20 62 65 20 61 20 73 79 6d 62  ile to be a symb
32a0: 6f 6c 69 63 0a 2a 2a 20 6c 69 6e 6b 2e 0a 2a 2a  olic.** link..**
32b0: 0a 2a 2a 20 49 66 20 64 65 6c 46 6c 61 67 20 69  .** If delFlag i
32c0: 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6d 61 6b  s true, then mak
32d0: 65 20 61 72 72 61 6e 67 65 6d 65 6e 74 73 20 74  e arrangements t
32e0: 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  o automatically 
32f0: 64 65 6c 65 74 65 0a 2a 2a 20 74 68 65 20 66 69  delete.** the fi
3300: 6c 65 20 77 68 65 6e 20 69 74 20 69 73 20 63 6c  le when it is cl
3310: 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73  osed..**.** On s
3320: 75 63 63 65 73 73 2c 20 77 72 69 74 65 20 74 68  uccess, write th
3330: 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 69 6e  e file handle in
3340: 74 6f 20 2a 69 64 20 61 6e 64 20 72 65 74 75 72  to *id and retur
3350: 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a  n SQLITE_OK..**.
3360: 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65 2c 20 72  ** On failure, r
3370: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e  eturn SQLITE_CAN
3380: 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74 20 73 71  TOPEN..*/.int sq
3390: 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75  lite3OsOpenExclu
33a0: 73 69 76 65 28 63 6f 6e 73 74 20 63 68 61 72 20  sive(const char 
33b0: 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 73 46 69  *zFilename, OsFi
33c0: 6c 65 20 2a 69 64 2c 20 69 6e 74 20 64 65 6c 46  le *id, int delF
33d0: 6c 61 67 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  lag){.  int rc;.
33e0: 20 20 61 73 73 65 72 74 28 20 21 69 64 2d 3e 69    assert( !id->i
33f0: 73 4f 70 65 6e 20 29 3b 0a 20 20 69 66 28 20 61  sOpen );.  if( a
3400: 63 63 65 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c  ccess(zFilename,
3410: 20 30 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65   0)==0 ){.    re
3420: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54  turn SQLITE_CANT
3430: 4f 50 45 4e 3b 0a 20 20 7d 0a 20 20 69 64 2d 3e  OPEN;.  }.  id->
3440: 64 69 72 66 64 20 3d 20 2d 31 3b 0a 20 20 69 64  dirfd = -1;.  id
3450: 2d 3e 68 20 3d 20 6f 70 65 6e 28 7a 46 69 6c 65  ->h = open(zFile
3460: 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20  name,.          
3470: 20 20 20 20 20 20 4f 5f 52 44 57 52 7c 4f 5f 43        O_RDWR|O_C
3480: 52 45 41 54 7c 4f 5f 45 58 43 4c 7c 4f 5f 4e 4f  REAT|O_EXCL|O_NO
3490: 46 4f 4c 4c 4f 57 7c 4f 5f 4c 41 52 47 45 46 49  FOLLOW|O_LARGEFI
34a0: 4c 45 7c 4f 5f 42 49 4e 41 52 59 2c 20 30 36 30  LE|O_BINARY, 060
34b0: 30 29 3b 0a 20 20 69 66 28 20 69 64 2d 3e 68 3c  0);.  if( id->h<
34c0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
34d0: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b  SQLITE_CANTOPEN;
34e0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73  .  }.  sqlite3Os
34f0: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20  EnterMutex();.  
3500: 72 63 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66  rc = findLockInf
3510: 6f 28 69 64 2d 3e 68 2c 20 26 69 64 2d 3e 70 4c  o(id->h, &id->pL
3520: 6f 63 6b 2c 20 26 69 64 2d 3e 70 4f 70 65 6e 29  ock, &id->pOpen)
3530: 3b 0a 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61  ;.  sqlite3OsLea
3540: 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28  veMutex();.  if(
3550: 20 72 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65   rc ){.    close
3560: 28 69 64 2d 3e 68 29 3b 0a 20 20 20 20 75 6e 6c  (id->h);.    unl
3570: 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a  ink(zFilename);.
3580: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
3590: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69  E_NOMEM;.  }.  i
35a0: 64 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 30 3b  d->locktype = 0;
35b0: 0a 20 20 69 64 2d 3e 69 73 4f 70 65 6e 20 3d 20  .  id->isOpen = 
35c0: 31 3b 0a 20 20 69 66 28 20 64 65 6c 46 6c 61 67  1;.  if( delFlag
35d0: 20 29 7b 0a 20 20 20 20 75 6e 6c 69 6e 6b 28 7a   ){.    unlink(z
35e0: 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 7d 0a 20  Filename);.  }. 
35f0: 20 54 52 41 43 45 33 28 22 4f 50 45 4e 2d 45 58   TRACE3("OPEN-EX
3600: 20 25 2d 33 64 20 25 73 5c 6e 22 2c 20 69 64 2d   %-3d %s\n", id-
3610: 3e 68 2c 20 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a  >h, zFilename);.
3620: 20 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 2b 31    OpenCounter(+1
3630: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
3640: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
3650: 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20  Attempt to open 
3660: 61 20 6e 65 77 20 66 69 6c 65 20 66 6f 72 20 72  a new file for r
3670: 65 61 64 2d 6f 6e 6c 79 20 61 63 63 65 73 73 2e  ead-only access.
3680: 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 65 73  .**.** On succes
3690: 73 2c 20 77 72 69 74 65 20 74 68 65 20 66 69 6c  s, write the fil
36a0: 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f 20 2a 69  e handle into *i
36b0: 64 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c  d and return SQL
36c0: 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  ITE_OK..**.** On
36d0: 20 66 61 69 6c 75 72 65 2c 20 72 65 74 75 72 6e   failure, return
36e0: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e   SQLITE_CANTOPEN
36f0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
3700: 4f 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 28 63  OsOpenReadOnly(c
3710: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
3720: 6e 61 6d 65 2c 20 4f 73 46 69 6c 65 20 2a 69 64  name, OsFile *id
3730: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 61  ){.  int rc;.  a
3740: 73 73 65 72 74 28 20 21 69 64 2d 3e 69 73 4f 70  ssert( !id->isOp
3750: 65 6e 20 29 3b 0a 20 20 69 64 2d 3e 64 69 72 66  en );.  id->dirf
3760: 64 20 3d 20 2d 31 3b 0a 20 20 69 64 2d 3e 68 20  d = -1;.  id->h 
3770: 3d 20 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65  = open(zFilename
3780: 2c 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f 4c 41 52  , O_RDONLY|O_LAR
3790: 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52 59 29  GEFILE|O_BINARY)
37a0: 3b 0a 20 20 69 66 28 20 69 64 2d 3e 68 3c 30 20  ;.  if( id->h<0 
37b0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
37c0: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20  LITE_CANTOPEN;. 
37d0: 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 45 6e   }.  sqlite3OsEn
37e0: 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 72 63  terMutex();.  rc
37f0: 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28   = findLockInfo(
3800: 69 64 2d 3e 68 2c 20 26 69 64 2d 3e 70 4c 6f 63  id->h, &id->pLoc
3810: 6b 2c 20 26 69 64 2d 3e 70 4f 70 65 6e 29 3b 0a  k, &id->pOpen);.
3820: 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65    sqlite3OsLeave
3830: 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20 72  Mutex();.  if( r
3840: 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28 69  c ){.    close(i
3850: 64 2d 3e 68 29 3b 0a 20 20 20 20 72 65 74 75 72  d->h);.    retur
3860: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
3870: 20 20 7d 0a 20 20 69 64 2d 3e 6c 6f 63 6b 74 79    }.  id->lockty
3880: 70 65 20 3d 20 30 3b 0a 20 20 69 64 2d 3e 69 73  pe = 0;.  id->is
3890: 4f 70 65 6e 20 3d 20 31 3b 0a 20 20 54 52 41 43  Open = 1;.  TRAC
38a0: 45 33 28 22 4f 50 45 4e 2d 52 4f 20 25 2d 33 64  E3("OPEN-RO %-3d
38b0: 20 25 73 5c 6e 22 2c 20 69 64 2d 3e 68 2c 20 7a   %s\n", id->h, z
38c0: 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 4f 70 65  Filename);.  Ope
38d0: 6e 43 6f 75 6e 74 65 72 28 2b 31 29 3b 0a 20 20  nCounter(+1);.  
38e0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
38f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  ;.}../*.** Attem
3900: 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 66 69 6c  pt to open a fil
3910: 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 6f 72  e descriptor for
3920: 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 74   the directory t
3930: 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 0a 2a  hat contains a.*
3940: 2a 20 66 69 6c 65 2e 20 20 54 68 69 73 20 66 69  * file.  This fi
3950: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 63 61  le descriptor ca
3960: 6e 20 62 65 20 75 73 65 64 20 74 6f 20 66 73 79  n be used to fsy
3970: 6e 63 28 29 20 74 68 65 20 64 69 72 65 63 74 6f  nc() the directo
3980: 72 79 0a 2a 2a 20 69 6e 20 6f 72 64 65 72 20 74  ry.** in order t
3990: 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20  o make sure the 
39a0: 63 72 65 61 74 69 6f 6e 20 6f 66 20 61 20 6e 65  creation of a ne
39b0: 77 20 66 69 6c 65 20 69 73 20 61 63 74 75 61 6c  w file is actual
39c0: 6c 79 20 77 72 69 74 74 65 6e 0a 2a 2a 20 74 6f  ly written.** to
39d0: 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69   disk..**.** Thi
39e0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6f 6e 6c  s routine is onl
39f0: 79 20 6d 65 61 6e 69 6e 67 66 75 6c 20 66 6f 72  y meaningful for
3a00: 20 55 6e 69 78 2e 20 20 49 74 20 69 73 20 61 20   Unix.  It is a 
3a10: 6e 6f 2d 6f 70 20 75 6e 64 65 72 0a 2a 2a 20 77  no-op under.** w
3a20: 69 6e 64 6f 77 73 20 73 69 6e 63 65 20 77 69 6e  indows since win
3a30: 64 6f 77 73 20 64 6f 65 73 20 6e 6f 74 20 73 75  dows does not su
3a40: 70 70 6f 72 74 20 68 61 72 64 20 6c 69 6e 6b 73  pport hard links
3a50: 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 65  ..**.** On succe
3a60: 73 73 2c 20 61 20 68 61 6e 64 6c 65 20 66 6f 72  ss, a handle for
3a70: 20 61 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 70   a previously op
3a80: 65 6e 20 66 69 6c 65 20 69 73 20 61 74 20 2a 69  en file is at *i
3a90: 64 20 69 73 0a 2a 2a 20 75 70 64 61 74 65 64 20  d is.** updated 
3aa0: 77 69 74 68 20 74 68 65 20 6e 65 77 20 64 69 72  with the new dir
3ab0: 65 63 74 6f 72 79 20 66 69 6c 65 20 64 65 73 63  ectory file desc
3ac0: 72 69 70 74 6f 72 20 61 6e 64 20 53 51 4c 49 54  riptor and SQLIT
3ad0: 45 5f 4f 4b 20 69 73 0a 2a 2a 20 72 65 74 75 72  E_OK is.** retur
3ae0: 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61  ned..**.** On fa
3af0: 69 6c 75 72 65 2c 20 74 68 65 20 66 75 6e 63 74  ilure, the funct
3b00: 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49  ion returns SQLI
3b10: 54 45 5f 43 41 4e 54 4f 50 45 4e 20 61 6e 64 20  TE_CANTOPEN and 
3b20: 6c 65 61 76 65 73 0a 2a 2a 20 2a 69 64 20 75 6e  leaves.** *id un
3b30: 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20  changed..*/.int 
3b40: 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 44 69 72  sqlite3OsOpenDir
3b50: 65 63 74 6f 72 79 28 0a 20 20 63 6f 6e 73 74 20  ectory(.  const 
3b60: 63 68 61 72 20 2a 7a 44 69 72 6e 61 6d 65 2c 0a  char *zDirname,.
3b70: 20 20 4f 73 46 69 6c 65 20 2a 69 64 0a 29 7b 0a    OsFile *id.){.
3b80: 20 20 69 66 28 20 21 69 64 2d 3e 69 73 4f 70 65    if( !id->isOpe
3b90: 6e 20 29 7b 0a 20 20 20 20 2f 2a 20 44 6f 20 6e  n ){.    /* Do n
3ba0: 6f 74 20 6f 70 65 6e 20 74 68 65 20 64 69 72 65  ot open the dire
3bb0: 63 74 6f 72 79 20 69 66 20 74 68 65 20 63 6f 72  ctory if the cor
3bc0: 72 65 73 70 6f 6e 64 69 6e 67 20 66 69 6c 65 20  responding file 
3bd0: 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 0a 20  is not already. 
3be0: 20 20 20 2a 2a 20 6f 70 65 6e 2e 20 2a 2f 0a 20     ** open. */. 
3bf0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
3c00: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20  _CANTOPEN;.  }. 
3c10: 20 61 73 73 65 72 74 28 20 69 64 2d 3e 64 69 72   assert( id->dir
3c20: 66 64 3c 30 20 29 3b 0a 20 20 69 64 2d 3e 64 69  fd<0 );.  id->di
3c30: 72 66 64 20 3d 20 6f 70 65 6e 28 7a 44 69 72 6e  rfd = open(zDirn
3c40: 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f  ame, O_RDONLY|O_
3c50: 42 49 4e 41 52 59 2c 20 30 36 34 34 29 3b 0a 20  BINARY, 0644);. 
3c60: 20 69 66 28 20 69 64 2d 3e 64 69 72 66 64 3c 30   if( id->dirfd<0
3c70: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
3c80: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20  QLITE_CANTOPEN; 
3c90: 0a 20 20 7d 0a 20 20 54 52 41 43 45 33 28 22 4f  .  }.  TRACE3("O
3ca0: 50 45 4e 44 49 52 20 25 2d 33 64 20 25 73 5c 6e  PENDIR %-3d %s\n
3cb0: 22 2c 20 69 64 2d 3e 64 69 72 66 64 2c 20 7a 44  ", id->dirfd, zD
3cc0: 69 72 6e 61 6d 65 29 3b 0a 20 20 72 65 74 75 72  irname);.  retur
3cd0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
3ce0: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 74  /*.** Create a t
3cf0: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 6e 61  emporary file na
3d00: 6d 65 20 69 6e 20 7a 42 75 66 2e 20 20 7a 42 75  me in zBuf.  zBu
3d10: 66 20 6d 75 73 74 20 62 65 20 62 69 67 20 65 6e  f must be big en
3d20: 6f 75 67 68 20 74 6f 0a 2a 2a 20 68 6f 6c 64 20  ough to.** hold 
3d30: 61 74 20 6c 65 61 73 74 20 53 51 4c 49 54 45 5f  at least SQLITE_
3d40: 54 45 4d 50 4e 41 4d 45 5f 53 49 5a 45 20 63 68  TEMPNAME_SIZE ch
3d50: 61 72 61 63 74 65 72 73 2e 0a 2a 2f 0a 69 6e 74  aracters..*/.int
3d60: 20 73 71 6c 69 74 65 33 4f 73 54 65 6d 70 46 69   sqlite3OsTempFi
3d70: 6c 65 4e 61 6d 65 28 63 68 61 72 20 2a 7a 42 75  leName(char *zBu
3d80: 66 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e  f){.  static con
3d90: 73 74 20 63 68 61 72 20 2a 61 7a 44 69 72 73 5b  st char *azDirs[
3da0: 5d 20 3d 20 7b 0a 20 20 20 20 20 22 2f 76 61 72  ] = {.     "/var
3db0: 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f 75 73  /tmp",.     "/us
3dc0: 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f 74  r/tmp",.     "/t
3dd0: 6d 70 22 2c 0a 20 20 20 20 20 22 2e 22 2c 0a 20  mp",.     ".",. 
3de0: 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 75 6e 73   };.  static uns
3df0: 69 67 6e 65 64 20 63 68 61 72 20 7a 43 68 61 72  igned char zChar
3e00: 73 5b 5d 20 3d 0a 20 20 20 20 22 61 62 63 64 65  s[] =.    "abcde
3e10: 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72 73 74 75  fghijklmnopqrstu
3e20: 76 77 78 79 7a 22 0a 20 20 20 20 22 41 42 43 44  vwxyz".    "ABCD
3e30: 45 46 47 48 49 4a 4b 4c 4d 4e 4f 50 51 52 53 54  EFGHIJKLMNOPQRST
3e40: 55 56 57 58 59 5a 22 0a 20 20 20 20 22 30 31 32  UVWXYZ".    "012
3e50: 33 34 35 36 37 38 39 22 3b 0a 20 20 69 6e 74 20  3456789";.  int 
3e60: 69 2c 20 6a 3b 0a 20 20 73 74 72 75 63 74 20 73  i, j;.  struct s
3e70: 74 61 74 20 62 75 66 3b 0a 20 20 63 6f 6e 73 74  tat buf;.  const
3e80: 20 63 68 61 72 20 2a 7a 44 69 72 20 3d 20 22 2e   char *zDir = ".
3e90: 22 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  ";.  for(i=0; i<
3ea0: 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f 73  sizeof(azDirs)/s
3eb0: 69 7a 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d 29  izeof(azDirs[0])
3ec0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20  ; i++){.    if( 
3ed0: 73 74 61 74 28 61 7a 44 69 72 73 5b 69 5d 2c 20  stat(azDirs[i], 
3ee0: 26 62 75 66 29 20 29 20 63 6f 6e 74 69 6e 75 65  &buf) ) continue
3ef0: 3b 0a 20 20 20 20 69 66 28 20 21 53 5f 49 53 44  ;.    if( !S_ISD
3f00: 49 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29 20  IR(buf.st_mode) 
3f10: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20  ) continue;.    
3f20: 69 66 28 20 61 63 63 65 73 73 28 61 7a 44 69 72  if( access(azDir
3f30: 73 5b 69 5d 2c 20 30 37 29 20 29 20 63 6f 6e 74  s[i], 07) ) cont
3f40: 69 6e 75 65 3b 0a 20 20 20 20 7a 44 69 72 20 3d  inue;.    zDir =
3f50: 20 61 7a 44 69 72 73 5b 69 5d 3b 0a 20 20 20 20   azDirs[i];.    
3f60: 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 64 6f 7b  break;.  }.  do{
3f70: 0a 20 20 20 20 73 70 72 69 6e 74 66 28 7a 42 75  .    sprintf(zBu
3f80: 66 2c 20 22 25 73 2f 22 54 45 4d 50 5f 46 49 4c  f, "%s/"TEMP_FIL
3f90: 45 5f 50 52 45 46 49 58 2c 20 7a 44 69 72 29 3b  E_PREFIX, zDir);
3fa0: 0a 20 20 20 20 6a 20 3d 20 73 74 72 6c 65 6e 28  .    j = strlen(
3fb0: 7a 42 75 66 29 3b 0a 20 20 20 20 73 71 6c 69 74  zBuf);.    sqlit
3fc0: 65 33 52 61 6e 64 6f 6d 6e 65 73 73 28 31 35 2c  e3Randomness(15,
3fd0: 20 26 7a 42 75 66 5b 6a 5d 29 3b 0a 20 20 20 20   &zBuf[j]);.    
3fe0: 66 6f 72 28 69 3d 30 3b 20 69 3c 31 35 3b 20 69  for(i=0; i<15; i
3ff0: 2b 2b 2c 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20  ++, j++){.      
4000: 7a 42 75 66 5b 6a 5d 20 3d 20 28 63 68 61 72 29  zBuf[j] = (char)
4010: 7a 43 68 61 72 73 5b 20 28 28 75 6e 73 69 67 6e  zChars[ ((unsign
4020: 65 64 20 63 68 61 72 29 7a 42 75 66 5b 6a 5d 29  ed char)zBuf[j])
4030: 25 28 73 69 7a 65 6f 66 28 7a 43 68 61 72 73 29  %(sizeof(zChars)
4040: 2d 31 29 20 5d 3b 0a 20 20 20 20 7d 0a 20 20 20  -1) ];.    }.   
4050: 20 7a 42 75 66 5b 6a 5d 20 3d 20 30 3b 0a 20 20   zBuf[j] = 0;.  
4060: 7d 77 68 69 6c 65 28 20 61 63 63 65 73 73 28 7a  }while( access(z
4070: 42 75 66 2c 30 29 3d 3d 30 20 29 3b 0a 20 20 72  Buf,0)==0 );.  r
4080: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
4090: 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20   .}../*.** Read 
40a0: 64 61 74 61 20 66 72 6f 6d 20 61 20 66 69 6c 65  data from a file
40b0: 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72 2e 20   into a buffer. 
40c0: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   Return SQLITE_O
40d0: 4b 20 69 66 20 61 6c 6c 0a 2a 2a 20 62 79 74 65  K if all.** byte
40e0: 73 20 77 65 72 65 20 72 65 61 64 20 73 75 63 63  s were read succ
40f0: 65 73 73 66 75 6c 6c 79 20 61 6e 64 20 53 51 4c  essfully and SQL
4100: 49 54 45 5f 49 4f 45 52 52 20 69 66 20 61 6e 79  ITE_IOERR if any
4110: 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 77 72  thing goes.** wr
4120: 6f 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ong..*/.int sqli
4130: 74 65 33 4f 73 52 65 61 64 28 4f 73 46 69 6c 65  te3OsRead(OsFile
4140: 20 2a 69 64 2c 20 76 6f 69 64 20 2a 70 42 75 66   *id, void *pBuf
4150: 2c 20 69 6e 74 20 61 6d 74 29 7b 0a 20 20 69 6e  , int amt){.  in
4160: 74 20 67 6f 74 3b 0a 20 20 61 73 73 65 72 74 28  t got;.  assert(
4170: 20 69 64 2d 3e 69 73 4f 70 65 6e 20 29 3b 0a 20   id->isOpen );. 
4180: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
4190: 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a  (SQLITE_IOERR);.
41a0: 20 20 54 49 4d 45 52 5f 53 54 41 52 54 3b 0a 20    TIMER_START;. 
41b0: 20 67 6f 74 20 3d 20 72 65 61 64 28 69 64 2d 3e   got = read(id->
41c0: 68 2c 20 70 42 75 66 2c 20 61 6d 74 29 3b 0a 20  h, pBuf, amt);. 
41d0: 20 54 49 4d 45 52 5f 45 4e 44 3b 0a 20 20 54 52   TIMER_END;.  TR
41e0: 41 43 45 34 28 22 52 45 41 44 20 20 20 20 25 2d  ACE4("READ    %-
41f0: 33 64 20 25 37 64 20 25 64 5c 6e 22 2c 20 69 64  3d %7d %d\n", id
4200: 2d 3e 68 2c 20 6c 61 73 74 5f 70 61 67 65 2c 20  ->h, last_page, 
4210: 65 6c 61 70 73 65 29 3b 0a 20 20 53 45 45 4b 28  elapse);.  SEEK(
4220: 30 29 3b 0a 20 20 2f 2a 20 69 66 28 20 67 6f 74  0);.  /* if( got
4230: 3c 30 20 29 20 67 6f 74 20 3d 20 30 3b 20 2a 2f  <0 ) got = 0; */
4240: 0a 20 20 69 66 28 20 67 6f 74 3d 3d 61 6d 74 20  .  if( got==amt 
4250: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
4260: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65  LITE_OK;.  }else
4270: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
4280: 49 54 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 7d  ITE_IOERR;.  }.}
4290: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 64 61  ../*.** Write da
42a0: 74 61 20 66 72 6f 6d 20 61 20 62 75 66 66 65 72  ta from a buffer
42b0: 20 69 6e 74 6f 20 61 20 66 69 6c 65 2e 20 20 52   into a file.  R
42c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20  eturn SQLITE_OK 
42d0: 6f 6e 20 73 75 63 63 65 73 73 0a 2a 2a 20 6f 72  on success.** or
42e0: 20 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f   some other erro
42f0: 72 20 63 6f 64 65 20 6f 6e 20 66 61 69 6c 75 72  r code on failur
4300: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
4310: 33 4f 73 57 72 69 74 65 28 4f 73 46 69 6c 65 20  3OsWrite(OsFile 
4320: 2a 69 64 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20  *id, const void 
4330: 2a 70 42 75 66 2c 20 69 6e 74 20 61 6d 74 29 7b  *pBuf, int amt){
4340: 0a 20 20 69 6e 74 20 77 72 6f 74 65 20 3d 20 30  .  int wrote = 0
4350: 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 2d 3e  ;.  assert( id->
4360: 69 73 4f 70 65 6e 20 29 3b 0a 20 20 53 69 6d 75  isOpen );.  Simu
4370: 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51 4c 49  lateIOError(SQLI
4380: 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 54 49 4d  TE_IOERR);.  TIM
4390: 45 52 5f 53 54 41 52 54 3b 0a 20 20 77 68 69 6c  ER_START;.  whil
43a0: 65 28 20 61 6d 74 3e 30 20 26 26 20 28 77 72 6f  e( amt>0 && (wro
43b0: 74 65 20 3d 20 77 72 69 74 65 28 69 64 2d 3e 68  te = write(id->h
43c0: 2c 20 70 42 75 66 2c 20 61 6d 74 29 29 3e 30 20  , pBuf, amt))>0 
43d0: 29 7b 0a 20 20 20 20 61 6d 74 20 2d 3d 20 77 72  ){.    amt -= wr
43e0: 6f 74 65 3b 0a 20 20 20 20 70 42 75 66 20 3d 20  ote;.    pBuf = 
43f0: 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b 77  &((char*)pBuf)[w
4400: 72 6f 74 65 5d 3b 0a 20 20 7d 0a 20 20 54 49 4d  rote];.  }.  TIM
4410: 45 52 5f 45 4e 44 3b 0a 20 20 54 52 41 43 45 34  ER_END;.  TRACE4
4420: 28 22 57 52 49 54 45 20 20 20 25 2d 33 64 20 25  ("WRITE   %-3d %
4430: 37 64 20 25 64 5c 6e 22 2c 20 69 64 2d 3e 68 2c  7d %d\n", id->h,
4440: 20 6c 61 73 74 5f 70 61 67 65 2c 20 65 6c 61 70   last_page, elap
4450: 73 65 29 3b 0a 20 20 53 45 45 4b 28 30 29 3b 0a  se);.  SEEK(0);.
4460: 20 20 69 66 28 20 61 6d 74 3e 30 20 29 7b 0a 20    if( amt>0 ){. 
4470: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
4480: 5f 46 55 4c 4c 3b 0a 20 20 7d 0a 20 20 72 65 74  _FULL;.  }.  ret
4490: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
44a0: 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65  ../*.** Move the
44b0: 20 72 65 61 64 2f 77 72 69 74 65 20 70 6f 69 6e   read/write poin
44c0: 74 65 72 20 69 6e 20 61 20 66 69 6c 65 2e 0a 2a  ter in a file..*
44d0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 53  /.int sqlite3OsS
44e0: 65 65 6b 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20  eek(OsFile *id, 
44f0: 6f 66 66 5f 74 20 6f 66 66 73 65 74 29 7b 0a 20  off_t offset){. 
4500: 20 61 73 73 65 72 74 28 20 69 64 2d 3e 69 73 4f   assert( id->isO
4510: 70 65 6e 20 29 3b 0a 20 20 53 45 45 4b 28 6f 66  pen );.  SEEK(of
4520: 66 73 65 74 2f 31 30 32 34 20 2b 20 31 29 3b 0a  fset/1024 + 1);.
4530: 20 20 6c 73 65 65 6b 28 69 64 2d 3e 68 2c 20 6f    lseek(id->h, o
4540: 66 66 73 65 74 2c 20 53 45 45 4b 5f 53 45 54 29  ffset, SEEK_SET)
4550: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
4560: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d  E_OK;.}../*.** M
4570: 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 77 72 69  ake sure all wri
4580: 74 65 73 20 74 6f 20 61 20 70 61 72 74 69 63 75  tes to a particu
4590: 6c 61 72 20 66 69 6c 65 20 61 72 65 20 63 6f 6d  lar file are com
45a0: 6d 69 74 74 65 64 20 74 6f 20 64 69 73 6b 2e 0a  mitted to disk..
45b0: 2a 2a 0a 2a 2a 20 55 6e 64 65 72 20 55 6e 69 78  **.** Under Unix
45c0: 2c 20 61 6c 73 6f 20 6d 61 6b 65 20 73 75 72 65  , also make sure
45d0: 20 74 68 61 74 20 74 68 65 20 64 69 72 65 63 74   that the direct
45e0: 6f 72 79 20 65 6e 74 72 79 20 66 6f 72 20 74 68  ory entry for th
45f0: 65 20 66 69 6c 65 0a 2a 2a 20 68 61 73 20 62 65  e file.** has be
4600: 65 6e 20 63 72 65 61 74 65 64 20 62 79 20 66 73  en created by fs
4610: 79 6e 63 2d 69 6e 67 20 74 68 65 20 64 69 72 65  ync-ing the dire
4620: 63 74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61  ctory that conta
4630: 69 6e 73 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a  ins the file..**
4640: 20 49 66 20 77 65 20 64 6f 20 6e 6f 74 20 64 6f   If we do not do
4650: 20 74 68 69 73 20 61 6e 64 20 77 65 20 65 6e 63   this and we enc
4660: 6f 75 6e 74 65 72 20 61 20 70 6f 77 65 72 20 66  ounter a power f
4670: 61 69 6c 75 72 65 2c 20 74 68 65 20 64 69 72 65  ailure, the dire
4680: 63 74 6f 72 79 0a 2a 2a 20 65 6e 74 72 79 20 66  ctory.** entry f
4690: 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6d  or the journal m
46a0: 69 67 68 74 20 6e 6f 74 20 65 78 69 73 74 20 61  ight not exist a
46b0: 66 74 65 72 20 77 65 20 72 65 62 6f 6f 74 2e 20  fter we reboot. 
46c0: 20 54 68 65 20 6e 65 78 74 0a 2a 2a 20 53 51 4c   The next.** SQL
46d0: 69 74 65 20 74 6f 20 61 63 63 65 73 73 20 74 68  ite to access th
46e0: 65 20 66 69 6c 65 20 77 69 6c 6c 20 6e 6f 74 20  e file will not 
46f0: 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 20 6a 6f  know that the jo
4700: 75 72 6e 61 6c 20 65 78 69 73 74 73 20 28 62 65  urnal exists (be
4710: 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 64 69 72  cause.** the dir
4720: 65 63 74 6f 72 79 20 65 6e 74 72 79 20 66 6f 72  ectory entry for
4730: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 61 73   the journal was
4740: 20 6e 65 76 65 72 20 63 72 65 61 74 65 64 29 20   never created) 
4750: 61 6e 64 20 74 68 65 20 74 72 61 6e 73 61 63 74  and the transact
4760: 69 6f 6e 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20  ion.** will not 
4770: 72 6f 6c 6c 20 62 61 63 6b 20 2d 20 70 6f 73 73  roll back - poss
4780: 69 62 6c 79 20 6c 65 61 64 69 6e 67 20 74 6f 20  ibly leading to 
4790: 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 74  database corrupt
47a0: 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ion..*/.int sqli
47b0: 74 65 33 4f 73 53 79 6e 63 28 4f 73 46 69 6c 65  te3OsSync(OsFile
47c0: 20 2a 69 64 29 7b 0a 20 20 61 73 73 65 72 74 28   *id){.  assert(
47d0: 20 69 64 2d 3e 69 73 4f 70 65 6e 20 29 3b 0a 20   id->isOpen );. 
47e0: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
47f0: 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a  (SQLITE_IOERR);.
4800: 20 20 54 52 41 43 45 32 28 22 53 59 4e 43 20 20    TRACE2("SYNC  
4810: 20 20 25 2d 33 64 5c 6e 22 2c 20 69 64 2d 3e 68    %-3d\n", id->h
4820: 29 3b 0a 20 20 69 66 28 20 66 73 79 6e 63 28 69  );.  if( fsync(i
4830: 64 2d 3e 68 29 20 29 7b 0a 20 20 20 20 72 65 74  d->h) ){.    ret
4840: 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  urn SQLITE_IOERR
4850: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 64 2d 3e  ;.  }.  if( id->
4860: 64 69 72 66 64 3e 3d 30 20 29 7b 0a 20 20 20 20  dirfd>=0 ){.    
4870: 54 52 41 43 45 32 28 22 44 49 52 53 59 4e 43 20  TRACE2("DIRSYNC 
4880: 25 2d 33 64 5c 6e 22 2c 20 69 64 2d 3e 64 69 72  %-3d\n", id->dir
4890: 66 64 29 3b 0a 20 20 20 20 66 73 79 6e 63 28 69  fd);.    fsync(i
48a0: 64 2d 3e 64 69 72 66 64 29 3b 0a 20 20 20 20 63  d->dirfd);.    c
48b0: 6c 6f 73 65 28 69 64 2d 3e 64 69 72 66 64 29 3b  lose(id->dirfd);
48c0: 20 20 2f 2a 20 4f 6e 6c 79 20 6e 65 65 64 20 74    /* Only need t
48d0: 6f 20 73 79 6e 63 20 6f 6e 63 65 2c 20 73 6f 20  o sync once, so 
48e0: 63 6c 6f 73 65 20 74 68 65 20 64 69 72 65 63 74  close the direct
48f0: 6f 72 79 20 2a 2f 0a 20 20 20 20 69 64 2d 3e 64  ory */.    id->d
4900: 69 72 66 64 20 3d 20 2d 31 3b 20 20 20 20 2f 2a  irfd = -1;    /*
4910: 20 77 68 65 6e 20 77 65 20 61 72 65 20 64 6f 6e   when we are don
4920: 65 2e 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75  e. */.  }.  retu
4930: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
4940: 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20  ./*.** Sync the 
4950: 64 69 72 65 63 74 6f 72 79 20 7a 44 69 72 6e 61  directory zDirna
4960: 6d 65 2e 20 54 68 69 73 20 69 73 20 61 20 6e 6f  me. This is a no
4970: 2d 6f 70 20 6f 6e 20 6f 70 65 72 61 74 69 6e 67  -op on operating
4980: 20 73 79 73 74 65 6d 73 20 6f 74 68 65 72 0a 2a   systems other.*
4990: 2a 20 74 68 61 6e 20 55 4e 49 58 2e 0a 2a 2f 0a  * than UNIX..*/.
49a0: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 53 79 6e  int sqlite3OsSyn
49b0: 63 44 69 72 65 63 74 6f 72 79 28 63 6f 6e 73 74  cDirectory(const
49c0: 20 63 68 61 72 20 2a 7a 44 69 72 6e 61 6d 65 29   char *zDirname)
49d0: 7b 0a 20 20 69 6e 74 20 66 64 3b 0a 20 20 69 6e  {.  int fd;.  in
49e0: 74 20 72 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49  t r;.  SimulateI
49f0: 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f  OError(SQLITE_IO
4a00: 45 52 52 29 3b 0a 20 20 66 64 20 3d 20 6f 70 65  ERR);.  fd = ope
4a10: 6e 28 7a 44 69 72 6e 61 6d 65 2c 20 4f 5f 52 44  n(zDirname, O_RD
4a20: 4f 4e 4c 59 7c 4f 5f 42 49 4e 41 52 59 2c 20 30  ONLY|O_BINARY, 0
4a30: 36 34 34 29 3b 0a 20 20 54 52 41 43 45 33 28 22  644);.  TRACE3("
4a40: 44 49 52 53 59 4e 43 20 25 2d 33 64 20 28 25 73  DIRSYNC %-3d (%s
4a50: 29 5c 6e 22 2c 20 66 64 2c 20 7a 44 69 72 6e 61  )\n", fd, zDirna
4a60: 6d 65 29 3b 0a 20 20 69 66 28 20 66 64 3c 30 20  me);.  if( fd<0 
4a70: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
4a80: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a  LITE_CANTOPEN; .
4a90: 20 20 7d 0a 20 20 72 20 3d 20 66 73 79 6e 63 28    }.  r = fsync(
4aa0: 66 64 29 3b 0a 20 20 63 6c 6f 73 65 28 66 64 29  fd);.  close(fd)
4ab0: 3b 0a 20 20 72 65 74 75 72 6e 20 28 28 72 3d 3d  ;.  return ((r==
4ac0: 30 29 3f 53 51 4c 49 54 45 5f 4f 4b 3a 53 51 4c  0)?SQLITE_OK:SQL
4ad0: 49 54 45 5f 49 4f 45 52 52 29 3b 0a 7d 0a 0a 2f  ITE_IOERR);.}../
4ae0: 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 65 20 61 6e  *.** Truncate an
4af0: 20 6f 70 65 6e 20 66 69 6c 65 20 74 6f 20 61 20   open file to a 
4b00: 73 70 65 63 69 66 69 65 64 20 73 69 7a 65 0a 2a  specified size.*
4b10: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 54  /.int sqlite3OsT
4b20: 72 75 6e 63 61 74 65 28 4f 73 46 69 6c 65 20 2a  runcate(OsFile *
4b30: 69 64 2c 20 6f 66 66 5f 74 20 6e 42 79 74 65 29  id, off_t nByte)
4b40: 7b 0a 20 20 61 73 73 65 72 74 28 20 69 64 2d 3e  {.  assert( id->
4b50: 69 73 4f 70 65 6e 20 29 3b 0a 20 20 53 69 6d 75  isOpen );.  Simu
4b60: 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51 4c 49  lateIOError(SQLI
4b70: 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 72 65 74  TE_IOERR);.  ret
4b80: 75 72 6e 20 66 74 72 75 6e 63 61 74 65 28 69 64  urn ftruncate(id
4b90: 2d 3e 68 2c 20 6e 42 79 74 65 29 3d 3d 30 20 3f  ->h, nByte)==0 ?
4ba0: 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 4c   SQLITE_OK : SQL
4bb0: 49 54 45 5f 49 4f 45 52 52 3b 0a 7d 0a 0a 2f 2a  ITE_IOERR;.}../*
4bc0: 0a 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68  .** Determine th
4bd0: 65 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f  e current size o
4be0: 66 20 61 20 66 69 6c 65 20 69 6e 20 62 79 74 65  f a file in byte
4bf0: 73 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  s.*/.int sqlite3
4c00: 4f 73 46 69 6c 65 53 69 7a 65 28 4f 73 46 69 6c  OsFileSize(OsFil
4c10: 65 20 2a 69 64 2c 20 6f 66 66 5f 74 20 2a 70 53  e *id, off_t *pS
4c20: 69 7a 65 29 7b 0a 20 20 73 74 72 75 63 74 20 73  ize){.  struct s
4c30: 74 61 74 20 62 75 66 3b 0a 20 20 61 73 73 65 72  tat buf;.  asser
4c40: 74 28 20 69 64 2d 3e 69 73 4f 70 65 6e 20 29 3b  t( id->isOpen );
4c50: 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72  .  SimulateIOErr
4c60: 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29  or(SQLITE_IOERR)
4c70: 3b 0a 20 20 69 66 28 20 66 73 74 61 74 28 69 64  ;.  if( fstat(id
4c80: 2d 3e 68 2c 20 26 62 75 66 29 21 3d 30 20 29 7b  ->h, &buf)!=0 ){
4c90: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
4ca0: 54 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 20 20  TE_IOERR;.  }.  
4cb0: 2a 70 53 69 7a 65 20 3d 20 62 75 66 2e 73 74 5f  *pSize = buf.st_
4cc0: 73 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 53  size;.  return S
4cd0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
4ce0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
4cf0: 63 68 65 63 6b 73 20 69 66 20 74 68 65 72 65 20  checks if there 
4d00: 69 73 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f  is a RESERVED lo
4d10: 63 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 73  ck held on the s
4d20: 70 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65  pecified.** file
4d30: 20 62 79 20 74 68 69 73 20 6f 72 20 61 6e 79 20   by this or any 
4d40: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 2e 20 49  other process. I
4d50: 66 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 73  f such a lock is
4d60: 20 68 65 6c 64 2c 20 72 65 74 75 72 6e 0a 2a 2a   held, return.**
4d70: 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 20 49 66 20 74   non-zero.  If t
4d80: 68 65 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63  he file is unloc
4d90: 6b 65 64 20 6f 72 20 68 6f 6c 64 73 20 6f 6e 6c  ked or holds onl
4da0: 79 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 2c 20  y SHARED locks, 
4db0: 74 68 65 6e 0a 2a 2a 20 72 65 74 75 72 6e 20 7a  then.** return z
4dc0: 65 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ero..*/.int sqli
4dd0: 74 65 33 4f 73 43 68 65 63 6b 52 65 73 65 72 76  te3OsCheckReserv
4de0: 65 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a 69  edLock(OsFile *i
4df0: 64 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 30 3b  d){.  int r = 0;
4e00: 0a 0a 20 20 61 73 73 65 72 74 28 20 69 64 2d 3e  ..  assert( id->
4e10: 69 73 4f 70 65 6e 20 29 3b 0a 20 20 73 71 6c 69  isOpen );.  sqli
4e20: 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28  te3OsEnterMutex(
4e30: 29 3b 20 2f 2a 20 4e 65 65 64 65 64 20 62 65 63  ); /* Needed bec
4e40: 61 75 73 65 20 69 64 2d 3e 70 4c 6f 63 6b 20 69  ause id->pLock i
4e50: 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 73 20  s shared across 
4e60: 74 68 72 65 61 64 73 20 2a 2f 0a 0a 20 20 2f 2a  threads */..  /*
4e70: 20 43 68 65 63 6b 20 69 66 20 61 20 74 68 72 65   Check if a thre
4e80: 61 64 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65  ad in this proce
4e90: 73 73 20 68 6f 6c 64 73 20 73 75 63 68 20 61 20  ss holds such a 
4ea0: 6c 6f 63 6b 20 2a 2f 0a 20 20 69 66 28 20 69 64  lock */.  if( id
4eb0: 2d 3e 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70  ->pLock->locktyp
4ec0: 65 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 7b  e>SHARED_LOCK ){
4ed0: 0a 20 20 20 20 72 20 3d 20 31 3b 0a 20 20 7d 0a  .    r = 1;.  }.
4ee0: 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69 73 65 20  .  /* Otherwise 
4ef0: 73 65 65 20 69 66 20 73 6f 6d 65 20 6f 74 68 65  see if some othe
4f00: 72 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20  r process holds 
4f10: 69 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21  it..  */.  if( !
4f20: 72 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20  r ){.    struct 
4f30: 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 20 20  flock lock;.    
4f40: 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20  lock.l_whence = 
4f50: 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f  SEEK_SET;.    lo
4f60: 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 52 45 53  ck.l_start = RES
4f70: 45 52 56 45 44 5f 42 59 54 45 3b 0a 20 20 20 20  ERVED_BYTE;.    
4f80: 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 31 3b 0a  lock.l_len = 1;.
4f90: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20      lock.l_type 
4fa0: 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 66  = F_WRLCK;.    f
4fb0: 63 6e 74 6c 28 69 64 2d 3e 68 2c 20 46 5f 47 45  cntl(id->h, F_GE
4fc0: 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b 0a 20 20 20  TLK, &lock);.   
4fd0: 20 69 66 28 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65   if( lock.l_type
4fe0: 21 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20  !=F_UNLCK ){.   
4ff0: 20 20 20 72 20 3d 20 31 3b 0a 20 20 20 20 7d 0a     r = 1;.    }.
5000: 20 20 7d 0a 20 20 0a 20 20 73 71 6c 69 74 65 33    }.  .  sqlite3
5010: 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a  OsLeaveMutex();.
5020: 20 20 54 52 41 43 45 33 28 22 54 45 53 54 20 57    TRACE3("TEST W
5030: 52 2d 4c 4f 43 4b 20 25 64 20 25 64 5c 6e 22 2c  R-LOCK %d %d\n",
5040: 20 69 64 2d 3e 68 2c 20 72 29 3b 0a 0a 20 20 72   id->h, r);..  r
5050: 65 74 75 72 6e 20 72 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn r;.}../*.*
5060: 2a 20 4c 6f 63 6b 20 74 68 65 20 66 69 6c 65 20  * Lock the file 
5070: 77 69 74 68 20 74 68 65 20 6c 6f 63 6b 20 73 70  with the lock sp
5080: 65 63 69 66 69 65 64 20 62 79 20 70 61 72 61 6d  ecified by param
5090: 65 74 65 72 20 6c 6f 63 6b 74 79 70 65 20 2d 20  eter locktype - 
50a0: 6f 6e 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f  one.** of the fo
50b0: 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20  llowing:.**.**  
50c0: 20 20 20 28 31 29 20 53 48 41 52 45 44 5f 4c 4f     (1) SHARED_LO
50d0: 43 4b 0a 2a 2a 20 20 20 20 20 28 32 29 20 52 45  CK.**     (2) RE
50e0: 53 45 52 56 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20  SERVED_LOCK.**  
50f0: 20 20 20 28 33 29 20 50 45 4e 44 49 4e 47 5f 4c     (3) PENDING_L
5100: 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 34 29 20 45  OCK.**     (4) E
5110: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 0a 2a 2a  XCLUSIVE_LOCK.**
5120: 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 68  .** Sometimes wh
5130: 65 6e 20 72 65 71 75 65 73 74 69 6e 67 20 6f 6e  en requesting on
5140: 65 20 6c 6f 63 6b 20 73 74 61 74 65 2c 20 61 64  e lock state, ad
5150: 64 69 74 69 6f 6e 61 6c 20 6c 6f 63 6b 20 73 74  ditional lock st
5160: 61 74 65 73 0a 2a 2a 20 61 72 65 20 69 6e 73 65  ates.** are inse
5170: 72 74 65 64 20 69 6e 20 62 65 74 77 65 65 6e 2e  rted in between.
5180: 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 6d 69    The locking mi
5190: 67 68 74 20 66 61 69 6c 20 6f 6e 20 6f 6e 65 20  ght fail on one 
51a0: 6f 66 20 74 68 65 20 6c 61 74 65 72 0a 2a 2a 20  of the later.** 
51b0: 74 72 61 6e 73 69 74 69 6f 6e 73 20 6c 65 61 76  transitions leav
51c0: 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20 73 74 61  ing the lock sta
51d0: 74 65 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f  te different fro
51e0: 6d 20 77 68 61 74 20 69 74 20 73 74 61 72 74 65  m what it starte
51f0: 64 20 62 75 74 0a 2a 2a 20 73 74 69 6c 6c 20 73  d but.** still s
5200: 68 6f 72 74 20 6f 66 20 69 74 73 20 67 6f 61 6c  hort of its goal
5210: 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  .  The following
5220: 20 63 68 61 72 74 20 73 68 6f 77 73 20 74 68 65   chart shows the
5230: 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 72 61 6e   allowed.** tran
5240: 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20  sitions and the 
5250: 69 6e 73 65 72 74 65 64 20 69 6e 74 65 72 6d 65  inserted interme
5260: 64 69 61 74 65 20 73 74 61 74 65 73 3a 0a 2a 2a  diate states:.**
5270: 0a 2a 2a 20 20 20 20 55 4e 4c 4f 43 4b 45 44 20  .**    UNLOCKED 
5280: 2d 3e 20 53 48 41 52 45 44 0a 2a 2a 20 20 20 20  -> SHARED.**    
5290: 53 48 41 52 45 44 20 2d 3e 20 52 45 53 45 52 56  SHARED -> RESERV
52a0: 45 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20  ED.**    SHARED 
52b0: 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20  -> (PENDING) -> 
52c0: 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20  EXCLUSIVE.**    
52d0: 52 45 53 45 52 56 45 44 20 2d 3e 20 28 50 45 4e  RESERVED -> (PEN
52e0: 44 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49  DING) -> EXCLUSI
52f0: 56 45 0a 2a 2a 20 20 20 20 50 45 4e 44 49 4e 47  VE.**    PENDING
5300: 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a   -> EXCLUSIVE.**
5310: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
5320: 20 77 69 6c 6c 20 6f 6e 6c 79 20 69 6e 63 72 65   will only incre
5330: 61 73 65 20 61 20 6c 6f 63 6b 2e 20 20 55 73 65  ase a lock.  Use
5340: 20 74 68 65 20 73 71 6c 69 74 65 33 4f 73 55 6e   the sqlite3OsUn
5350: 6c 6f 63 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e  lock().** routin
5360: 65 20 74 6f 20 6c 6f 77 65 72 20 61 20 6c 6f 63  e to lower a loc
5370: 6b 69 6e 67 20 6c 65 76 65 6c 2e 0a 2a 2f 0a 69  king level..*/.i
5380: 6e 74 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b  nt sqlite3OsLock
5390: 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e 74  (OsFile *id, int
53a0: 20 6c 6f 63 6b 74 79 70 65 29 7b 0a 20 20 2f 2a   locktype){.  /*
53b0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 64   The following d
53c0: 65 73 63 72 69 62 65 73 20 74 68 65 20 69 6d 70  escribes the imp
53d0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  lementation of t
53e0: 68 65 20 76 61 72 69 6f 75 73 20 6c 6f 63 6b 73  he various locks
53f0: 20 61 6e 64 0a 20 20 2a 2a 20 6c 6f 63 6b 20 74   and.  ** lock t
5400: 72 61 6e 73 69 74 69 6f 6e 73 20 69 6e 20 74 65  ransitions in te
5410: 72 6d 73 20 6f 66 20 74 68 65 20 50 4f 53 49 58  rms of the POSIX
5420: 20 61 64 76 69 73 6f 72 79 20 73 68 61 72 65 64   advisory shared
5430: 20 61 6e 64 20 65 78 63 6c 75 73 69 76 65 0a 20   and exclusive. 
5440: 20 2a 2a 20 6c 6f 63 6b 20 70 72 69 6d 69 74 69   ** lock primiti
5450: 76 65 73 20 28 63 61 6c 6c 65 64 20 72 65 61 64  ves (called read
5460: 2d 6c 6f 63 6b 73 20 61 6e 64 20 77 72 69 74 65  -locks and write
5470: 2d 6c 6f 63 6b 73 20 62 65 6c 6f 77 2c 20 74 6f  -locks below, to
5480: 20 61 76 6f 69 64 0a 20 20 2a 2a 20 63 6f 6e 66   avoid.  ** conf
5490: 75 73 69 6f 6e 20 77 69 74 68 20 53 51 4c 69 74  usion with SQLit
54a0: 65 20 6c 6f 63 6b 20 6e 61 6d 65 73 29 2e 20 54  e lock names). T
54b0: 68 65 20 61 6c 67 6f 72 69 74 68 6d 73 20 61 72  he algorithms ar
54c0: 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 0a 20 20  e complicated.  
54d0: 2a 2a 20 73 6c 69 67 68 74 6c 79 20 69 6e 20 6f  ** slightly in o
54e0: 72 64 65 72 20 74 6f 20 62 65 20 63 6f 6d 70 61  rder to be compa
54f0: 74 69 62 6c 65 20 77 69 74 68 20 77 69 6e 64 6f  tible with windo
5500: 77 73 20 73 79 73 74 65 6d 73 20 73 69 6d 75 6c  ws systems simul
5510: 74 61 6e 65 6f 75 73 6c 79 0a 20 20 2a 2a 20 61  taneously.  ** a
5520: 63 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d  ccessing the sam
5530: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
5540: 20 69 6e 20 63 61 73 65 20 74 68 61 74 20 69 73   in case that is
5550: 20 65 76 65 72 20 72 65 71 75 69 72 65 64 2e 0a   ever required..
5560: 20 20 2a 2a 0a 20 20 2a 2a 20 53 79 6d 62 6f 6c    **.  ** Symbol
5570: 73 20 64 65 66 69 6e 65 64 20 69 6e 20 6f 73 2e  s defined in os.
5580: 68 20 69 6e 64 65 6e 74 69 66 79 20 74 68 65 20  h indentify the 
5590: 27 70 65 6e 64 69 6e 67 20 62 79 74 65 27 20 61  'pending byte' a
55a0: 6e 64 20 74 68 65 20 27 72 65 73 65 72 76 65 64  nd the 'reserved
55b0: 0a 20 20 2a 2a 20 62 79 74 65 27 2c 20 65 61 63  .  ** byte', eac
55c0: 68 20 73 69 6e 67 6c 65 20 62 79 74 65 73 20 61  h single bytes a
55d0: 74 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66  t well known off
55e0: 73 65 74 73 2c 20 61 6e 64 20 74 68 65 20 27 73  sets, and the 's
55f0: 68 61 72 65 64 20 62 79 74 65 0a 20 20 2a 2a 20  hared byte.  ** 
5600: 72 61 6e 67 65 27 2c 20 61 20 72 61 6e 67 65 20  range', a range 
5610: 6f 66 20 35 31 30 20 62 79 74 65 73 20 61 74 20  of 510 bytes at 
5620: 61 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 6f 66 66  a well known off
5630: 73 65 74 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54  set..  **.  ** T
5640: 6f 20 6f 62 74 61 69 6e 20 61 20 53 48 41 52 45  o obtain a SHARE
5650: 44 20 6c 6f 63 6b 2c 20 61 20 72 65 61 64 2d 6c  D lock, a read-l
5660: 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20  ock is obtained 
5670: 6f 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 0a  on the 'pending.
5680: 20 20 2a 2a 20 62 79 74 65 27 2e 20 20 49 66 20    ** byte'.  If 
5690: 74 68 69 73 20 69 73 20 73 75 63 63 65 73 73 66  this is successf
56a0: 75 6c 2c 20 61 20 72 61 6e 64 6f 6d 20 62 79 74  ul, a random byt
56b0: 65 20 66 72 6f 6d 20 74 68 65 20 27 73 68 61 72  e from the 'shar
56c0: 65 64 20 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e  ed byte.  ** ran
56d0: 67 65 27 20 69 73 20 72 65 61 64 2d 6c 6f 63 6b  ge' is read-lock
56e0: 65 64 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20  ed and the lock 
56f0: 6f 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 20  on the 'pending 
5700: 62 79 74 65 27 20 72 65 6c 65 61 73 65 64 2e 0a  byte' released..
5710: 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 70 72 6f 63    **.  ** A proc
5720: 65 73 73 20 6d 61 79 20 6f 6e 6c 79 20 6f 62 74  ess may only obt
5730: 61 69 6e 20 61 20 52 45 53 45 52 56 45 44 20 6c  ain a RESERVED l
5740: 6f 63 6b 20 61 66 74 65 72 20 69 74 20 68 61 73  ock after it has
5750: 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 0a 20   a SHARED lock. 
5760: 20 2a 2a 20 28 74 68 65 20 73 71 6c 69 74 65 33   ** (the sqlite3
5770: 4f 73 4c 6f 63 6b 28 29 20 72 6f 75 74 69 6e 65  OsLock() routine
5780: 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 6f 62 74   will try to obt
5790: 61 69 6e 20 74 68 69 73 20 6c 6f 63 6b 0a 20 20  ain this lock.  
57a0: 2a 2a 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ** automatically
57b0: 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c   if it is not al
57c0: 72 65 61 64 79 20 68 65 6c 64 29 2e 20 41 20 52  ready held). A R
57d0: 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 0a  ESERVED lock is.
57e0: 20 20 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 65 64    ** implemented
57f0: 20 62 79 20 67 72 61 62 62 69 6e 67 20 61 20 77   by grabbing a w
5800: 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65  rite-lock on the
5810: 20 27 72 65 73 65 72 76 65 64 20 62 79 74 65 27   'reserved byte'
5820: 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 70  . .  **.  ** A p
5830: 72 6f 63 65 73 73 20 6d 61 79 20 6f 6e 6c 79 20  rocess may only 
5840: 6f 62 74 61 69 6e 20 61 20 50 45 4e 44 49 4e 47  obtain a PENDING
5850: 20 6c 6f 63 6b 20 61 66 74 65 72 20 69 74 20 68   lock after it h
5860: 61 73 20 6f 62 74 61 69 6e 65 64 20 61 0a 20 20  as obtained a.  
5870: 2a 2a 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 28  ** SHARED lock (
5880: 64 6f 6e 65 20 61 75 74 6f 6d 61 74 69 63 61 6c  done automatical
5890: 6c 79 20 62 79 20 73 71 6c 69 74 65 33 4f 73 4c  ly by sqlite3OsL
58a0: 6f 63 6b 28 29 29 2e 20 41 20 50 45 4e 44 49 4e  ock()). A PENDIN
58b0: 47 20 6c 6f 63 6b 20 69 73 0a 20 20 2a 2a 20 69  G lock is.  ** i
58c0: 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 6f 62  mplemented by ob
58d0: 74 61 69 6e 69 6e 67 20 61 20 77 72 69 74 65 2d  taining a write-
58e0: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 27 70 65 6e  lock on the 'pen
58f0: 64 69 6e 67 20 62 79 74 65 27 2e 20 54 68 69 73  ding byte'. This
5900: 0a 20 20 2a 2a 20 65 6e 73 75 72 65 73 20 74 68  .  ** ensures th
5910: 61 74 20 6e 6f 20 6e 65 77 20 53 48 41 52 45 44  at no new SHARED
5920: 20 6c 6f 63 6b 73 20 63 61 6e 20 62 65 20 6f 62   locks can be ob
5930: 74 61 69 6e 65 64 2c 20 62 75 74 20 65 78 69 73  tained, but exis
5940: 74 69 6e 67 20 53 48 41 52 45 44 0a 20 20 2a 2a  ting SHARED.  **
5950: 20 6c 6f 63 6b 73 20 61 72 65 20 61 6c 6c 6f 77   locks are allow
5960: 65 64 20 74 6f 20 70 65 72 73 69 73 74 2e 20 41  ed to persist. A
5970: 20 70 72 6f 63 65 73 73 20 64 6f 65 73 20 6e 6f   process does no
5980: 74 20 68 61 76 65 20 74 6f 20 6f 62 74 61 69 6e  t have to obtain
5990: 20 61 0a 20 20 2a 2a 20 52 45 53 45 52 56 45 44   a.  ** RESERVED
59a0: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 77 61 79   lock on the way
59b0: 20 74 6f 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f   to a PENDING lo
59c0: 63 6b 2e 20 54 68 69 73 20 70 72 6f 70 65 72 74  ck. This propert
59d0: 79 20 69 73 20 75 73 65 64 20 62 79 0a 20 20 2a  y is used by.  *
59e0: 2a 20 74 68 65 20 61 6c 67 6f 72 69 74 68 6d 20  * the algorithm 
59f0: 66 6f 72 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b  for rolling back
5a00: 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20   a journal file 
5a10: 61 66 74 65 72 20 61 20 63 72 61 73 68 2e 0a 20  after a crash.. 
5a20: 20 2a 2a 0a 20 20 2a 2a 20 41 6e 20 45 58 43 4c   **.  ** An EXCL
5a30: 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 20 69 6d  USIVE lock is im
5a40: 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 6f 62 74  plemented by obt
5a50: 61 69 6e 69 6e 67 20 61 20 77 72 69 74 65 2d 6c  aining a write-l
5a60: 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20  ock on the.  ** 
5a70: 65 6e 74 69 72 65 20 27 73 68 61 72 65 64 20 62  entire 'shared b
5a80: 79 74 65 20 72 61 6e 67 65 27 2e 20 53 69 6e 63  yte range'. Sinc
5a90: 65 20 61 6c 6c 20 6f 74 68 65 72 20 6c 6f 63 6b  e all other lock
5aa0: 73 20 72 65 71 75 69 72 65 20 61 20 72 65 61 64  s require a read
5ab0: 2d 6c 6f 63 6b 0a 20 20 2a 2a 20 6f 6e 20 6f 6e  -lock.  ** on on
5ac0: 65 20 6f 66 20 74 68 65 20 62 79 74 65 73 20 77  e of the bytes w
5ad0: 69 74 68 69 6e 20 74 68 69 73 20 72 61 6e 67 65  ithin this range
5ae0: 2c 20 74 68 69 73 20 65 6e 73 75 72 65 73 20 74  , this ensures t
5af0: 68 61 74 20 6e 6f 20 6f 74 68 65 72 0a 20 20 2a  hat no other.  *
5b00: 2a 20 6c 6f 63 6b 73 20 61 72 65 20 68 65 6c 64  * locks are held
5b10: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   on the database
5b20: 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65  . .  **.  ** The
5b30: 20 72 65 61 73 6f 6e 20 61 20 73 69 6e 67 6c 65   reason a single
5b40: 20 62 79 74 65 20 63 61 6e 6e 6f 74 20 62 65 20   byte cannot be 
5b50: 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20  used instead of 
5b60: 74 68 65 20 27 73 68 61 72 65 64 20 62 79 74 65  the 'shared byte
5b70: 0a 20 20 2a 2a 20 72 61 6e 67 65 27 20 69 73 20  .  ** range' is 
5b80: 74 68 61 74 20 73 6f 6d 65 20 76 65 72 73 69 6f  that some versio
5b90: 6e 73 20 6f 66 20 77 69 6e 64 6f 77 73 20 64 6f  ns of windows do
5ba0: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 72 65 61   not support rea
5bb0: 64 2d 6c 6f 63 6b 73 2e 20 42 79 0a 20 20 2a 2a  d-locks. By.  **
5bc0: 20 6c 6f 63 6b 69 6e 67 20 61 20 72 61 6e 64 6f   locking a rando
5bd0: 6d 20 62 79 74 65 20 66 72 6f 6d 20 61 20 72 61  m byte from a ra
5be0: 6e 67 65 2c 20 63 6f 6e 63 75 72 72 65 6e 74 20  nge, concurrent 
5bf0: 53 48 41 52 45 44 20 6c 6f 63 6b 73 20 6d 61 79  SHARED locks may
5c00: 20 65 78 69 73 74 0a 20 20 2a 2a 20 65 76 65 6e   exist.  ** even
5c10: 20 69 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20   if the locking 
5c20: 70 72 69 6d 69 74 69 76 65 20 75 73 65 64 20 69  primitive used i
5c30: 73 20 61 6c 77 61 79 73 20 61 20 77 72 69 74 65  s always a write
5c40: 2d 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20 69 6e  -lock..  */.  in
5c50: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
5c60: 3b 0a 20 20 73 74 72 75 63 74 20 6c 6f 63 6b 49  ;.  struct lockI
5c70: 6e 66 6f 20 2a 70 4c 6f 63 6b 20 3d 20 69 64 2d  nfo *pLock = id-
5c80: 3e 70 4c 6f 63 6b 3b 0a 20 20 73 74 72 75 63 74  >pLock;.  struct
5c90: 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69   flock lock;.  i
5ca0: 6e 74 20 73 3b 0a 0a 20 20 61 73 73 65 72 74 28  nt s;..  assert(
5cb0: 20 69 64 2d 3e 69 73 4f 70 65 6e 20 29 3b 0a 20   id->isOpen );. 
5cc0: 20 54 52 41 43 45 36 28 22 4c 4f 43 4b 20 25 64   TRACE6("LOCK %d
5cd0: 20 25 64 20 77 61 73 20 25 64 28 25 64 2c 25 64   %d was %d(%d,%d
5ce0: 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20  )\n",.          
5cf0: 69 64 2d 3e 68 2c 20 6c 6f 63 6b 74 79 70 65 2c  id->h, locktype,
5d00: 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 2c 20 70   id->locktype, p
5d10: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 2c 20  Lock->locktype, 
5d20: 70 4c 6f 63 6b 2d 3e 63 6e 74 29 3b 0a 0a 20 20  pLock->cnt);..  
5d30: 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61  /* If there is a
5d40: 6c 72 65 61 64 79 20 61 20 6c 6f 63 6b 20 6f 66  lready a lock of
5d50: 20 74 68 69 73 20 74 79 70 65 20 6f 72 20 6d 6f   this type or mo
5d60: 72 65 20 72 65 73 74 72 69 63 74 69 76 65 20 6f  re restrictive o
5d70: 6e 20 74 68 65 0a 20 20 2a 2a 20 4f 73 46 69 6c  n the.  ** OsFil
5d80: 65 2c 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 20 44  e, do nothing. D
5d90: 6f 6e 27 74 20 75 73 65 20 74 68 65 20 65 6e 64  on't use the end
5da0: 5f 6c 6f 63 6b 3a 20 65 78 69 74 20 70 61 74 68  _lock: exit path
5db0: 2c 20 61 73 0a 20 20 2a 2a 20 73 71 6c 69 74 65  , as.  ** sqlite
5dc0: 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 20  3OsEnterMutex() 
5dd0: 68 61 73 6e 27 74 20 62 65 65 6e 20 63 61 6c 6c  hasn't been call
5de0: 65 64 20 79 65 74 2e 0a 20 20 2a 2f 0a 20 20 69  ed yet..  */.  i
5df0: 66 28 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 3e  f( id->locktype>
5e00: 3d 6c 6f 63 6b 74 79 70 65 20 29 7b 0a 20 20 20  =locktype ){.   
5e10: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
5e20: 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b  K;.  }..  /* Mak
5e30: 65 20 73 75 72 65 20 74 68 65 20 6c 6f 63 6b 69  e sure the locki
5e40: 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 63  ng sequence is c
5e50: 6f 72 72 65 63 74 0a 20 20 2a 2f 0a 20 20 61 73  orrect.  */.  as
5e60: 73 65 72 74 28 20 69 64 2d 3e 6c 6f 63 6b 74 79  sert( id->lockty
5e70: 70 65 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 6c  pe!=NO_LOCK || l
5e80: 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44 5f  ocktype==SHARED_
5e90: 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74  LOCK );.  assert
5ea0: 28 20 6c 6f 63 6b 74 79 70 65 21 3d 50 45 4e 44  ( locktype!=PEND
5eb0: 49 4e 47 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73  ING_LOCK );.  as
5ec0: 73 65 72 74 28 20 6c 6f 63 6b 74 79 70 65 21 3d  sert( locktype!=
5ed0: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c  RESERVED_LOCK ||
5ee0: 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d 53   id->locktype==S
5ef0: 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 0a 20  HARED_LOCK );.. 
5f00: 20 2f 2a 20 54 68 69 73 20 6d 75 74 65 78 20 69   /* This mutex i
5f10: 73 20 6e 65 65 64 65 64 20 62 65 63 61 75 73 65  s needed because
5f20: 20 69 64 2d 3e 70 4c 6f 63 6b 20 69 73 20 73 68   id->pLock is sh
5f30: 61 72 65 64 20 61 63 72 6f 73 73 20 74 68 72 65  ared across thre
5f40: 61 64 73 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74  ads.  */.  sqlit
5f50: 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29  e3OsEnterMutex()
5f60: 3b 0a 0a 20 20 2f 2a 20 49 66 20 73 6f 6d 65 20  ;..  /* If some 
5f70: 74 68 72 65 61 64 20 75 73 69 6e 67 20 74 68 69  thread using thi
5f80: 73 20 50 49 44 20 68 61 73 20 61 20 6c 6f 63 6b  s PID has a lock
5f90: 20 76 69 61 20 61 20 64 69 66 66 65 72 65 6e 74   via a different
5fa0: 20 4f 73 46 69 6c 65 2a 0a 20 20 2a 2a 20 68 61   OsFile*.  ** ha
5fb0: 6e 64 6c 65 20 74 68 61 74 20 70 72 65 63 6c 75  ndle that preclu
5fc0: 64 65 73 20 74 68 65 20 72 65 71 75 65 73 74 65  des the requeste
5fd0: 64 20 6c 6f 63 6b 2c 20 72 65 74 75 72 6e 20 42  d lock, return B
5fe0: 55 53 59 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  USY..  */.  if( 
5ff0: 28 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 21 3d 70  (id->locktype!=p
6000: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20 26  Lock->locktype &
6010: 26 20 0a 20 20 20 20 20 20 20 20 20 20 28 70 4c  & .          (pL
6020: 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3e 3d 50  ock->locktype>=P
6030: 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 7c 7c 20 6c  ENDING_LOCK || l
6040: 6f 63 6b 74 79 70 65 3e 53 48 41 52 45 44 5f 4c  ocktype>SHARED_L
6050: 4f 43 4b 29 29 0a 20 20 29 7b 0a 20 20 20 20 72  OCK)).  ){.    r
6060: 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b  c = SQLITE_BUSY;
6070: 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f  .    goto end_lo
6080: 63 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66  ck;.  }..  /* If
6090: 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69   a SHARED lock i
60a0: 73 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e 64  s requested, and
60b0: 20 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69   some thread usi
60c0: 6e 67 20 74 68 69 73 20 50 49 44 20 61 6c 72 65  ng this PID alre
60d0: 61 64 79 0a 20 20 2a 2a 20 68 61 73 20 61 20 53  ady.  ** has a S
60e0: 48 41 52 45 44 20 6f 72 20 52 45 53 45 52 56 45  HARED or RESERVE
60f0: 44 20 6c 6f 63 6b 2c 20 74 68 65 6e 20 69 6e 63  D lock, then inc
6100: 72 65 6d 65 6e 74 20 72 65 66 65 72 65 6e 63 65  rement reference
6110: 20 63 6f 75 6e 74 73 20 61 6e 64 0a 20 20 2a 2a   counts and.  **
6120: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
6130: 4b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6c 6f  K..  */.  if( lo
6140: 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c  cktype==SHARED_L
6150: 4f 43 4b 20 26 26 20 0a 20 20 20 20 20 20 28 70  OCK && .      (p
6160: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d  Lock->locktype==
6170: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70  SHARED_LOCK || p
6180: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d  Lock->locktype==
6190: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 29 20 29  RESERVED_LOCK) )
61a0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6c 6f  {.    assert( lo
61b0: 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c  cktype==SHARED_L
61c0: 4f 43 4b 20 29 3b 0a 20 20 20 20 61 73 73 65 72  OCK );.    asser
61d0: 74 28 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 3d  t( id->locktype=
61e0: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  =0 );.    assert
61f0: 28 20 70 4c 6f 63 6b 2d 3e 63 6e 74 3e 30 20 29  ( pLock->cnt>0 )
6200: 3b 0a 20 20 20 20 69 64 2d 3e 6c 6f 63 6b 74 79  ;.    id->lockty
6210: 70 65 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b  pe = SHARED_LOCK
6220: 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 63 6e 74  ;.    pLock->cnt
6230: 2b 2b 3b 0a 20 20 20 20 69 64 2d 3e 70 4f 70 65  ++;.    id->pOpe
6240: 6e 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a 20 20 20 20  n->nLock++;.    
6250: 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20  goto end_lock;. 
6260: 20 7d 0a 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e   }..  lock.l_len
6270: 20 3d 20 31 4c 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f   = 1L;.  lock.l_
6280: 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45  whence = SEEK_SE
6290: 54 3b 0a 0a 20 20 2f 2a 20 41 20 50 45 4e 44 49  T;..  /* A PENDI
62a0: 4e 47 20 6c 6f 63 6b 20 69 73 20 6e 65 65 64 65  NG lock is neede
62b0: 64 20 62 65 66 6f 72 65 20 61 63 71 75 69 72 69  d before acquiri
62c0: 6e 67 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b  ng a SHARED lock
62d0: 20 61 6e 64 20 62 65 66 6f 72 65 0a 20 20 2a 2a   and before.  **
62e0: 20 61 63 71 75 69 72 69 6e 67 20 61 6e 20 45 58   acquiring an EX
62f0: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 46  CLUSIVE lock.  F
6300: 6f 72 20 74 68 65 20 53 48 41 52 45 44 20 6c 6f  or the SHARED lo
6310: 63 6b 2c 20 74 68 65 20 50 45 4e 44 49 4e 47 20  ck, the PENDING 
6320: 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 72 65 6c  will.  ** be rel
6330: 65 61 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66  eased..  */.  if
6340: 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52  ( locktype==SHAR
6350: 45 44 5f 4c 4f 43 4b 20 0a 20 20 20 20 20 20 7c  ED_LOCK .      |
6360: 7c 20 28 6c 6f 63 6b 74 79 70 65 3d 3d 45 58 43  | (locktype==EXC
6370: 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 69  LUSIVE_LOCK && i
6380: 64 2d 3e 6c 6f 63 6b 74 79 70 65 3c 50 45 4e 44  d->locktype<PEND
6390: 49 4e 47 5f 4c 4f 43 4b 29 0a 20 20 29 7b 0a 20  ING_LOCK).  ){. 
63a0: 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d     lock.l_type =
63b0: 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 20 20 6c 6f   F_RDLCK;.    lo
63c0: 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50 45 4e  ck.l_start = PEN
63d0: 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20 20 73  DING_BYTE;.    s
63e0: 20 3d 20 66 63 6e 74 6c 28 69 64 2d 3e 68 2c 20   = fcntl(id->h, 
63f0: 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b  F_SETLK, &lock);
6400: 0a 20 20 20 20 69 66 28 20 73 20 29 7b 0a 20 20  .    if( s ){.  
6410: 20 20 20 20 72 63 20 3d 20 28 65 72 72 6e 6f 3d      rc = (errno=
6420: 3d 45 49 4e 56 41 4c 29 20 3f 20 53 51 4c 49 54  =EINVAL) ? SQLIT
6430: 45 5f 4e 4f 4c 46 53 20 3a 20 53 51 4c 49 54 45  E_NOLFS : SQLITE
6440: 5f 42 55 53 59 3b 0a 20 20 20 20 20 20 67 6f 74  _BUSY;.      got
6450: 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20  o end_lock;.    
6460: 7d 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 49 66 20  }.  }...  /* If 
6470: 63 6f 6e 74 72 6f 6c 20 67 65 74 73 20 74 6f 20  control gets to 
6480: 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 6e  this point, then
6490: 20 61 63 74 75 61 6c 6c 79 20 67 6f 20 61 68 65   actually go ahe
64a0: 61 64 20 61 6e 64 20 6d 61 6b 65 0a 20 20 2a 2a  ad and make.  **
64b0: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
64c0: 6d 20 63 61 6c 6c 73 20 66 6f 72 20 74 68 65 20  m calls for the 
64d0: 73 70 65 63 69 66 69 65 64 20 6c 6f 63 6b 2e 0a  specified lock..
64e0: 20 20 2a 2f 0a 20 20 69 66 28 20 6c 6f 63 6b 74    */.  if( lockt
64f0: 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b  ype==SHARED_LOCK
6500: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20   ){.    assert( 
6510: 70 4c 6f 63 6b 2d 3e 63 6e 74 3d 3d 30 20 29 3b  pLock->cnt==0 );
6520: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f  .    assert( pLo
6530: 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d 30 20  ck->locktype==0 
6540: 29 3b 0a 0a 20 20 20 20 2f 2a 20 4e 6f 77 20 67  );..    /* Now g
6550: 65 74 20 74 68 65 20 72 65 61 64 2d 6c 6f 63 6b  et the read-lock
6560: 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73   */.    lock.l_s
6570: 74 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49  tart = SHARED_FI
6580: 52 53 54 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f  RST;.    lock.l_
6590: 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a  len = SHARED_SIZ
65a0: 45 3b 0a 20 20 20 20 73 20 3d 20 66 63 6e 74 6c  E;.    s = fcntl
65b0: 28 69 64 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c  (id->h, F_SETLK,
65c0: 20 26 6c 6f 63 6b 29 3b 0a 0a 20 20 20 20 2f 2a   &lock);..    /*
65d0: 20 44 72 6f 70 20 74 68 65 20 74 65 6d 70 6f 72   Drop the tempor
65e0: 61 72 79 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b  ary PENDING lock
65f0: 20 2a 2f 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73   */.    lock.l_s
6600: 74 61 72 74 20 3d 20 50 45 4e 44 49 4e 47 5f 42  tart = PENDING_B
6610: 59 54 45 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f  YTE;.    lock.l_
6620: 6c 65 6e 20 3d 20 31 4c 3b 0a 20 20 20 20 6c 6f  len = 1L;.    lo
6630: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e  ck.l_type = F_UN
6640: 4c 43 4b 3b 0a 20 20 20 20 66 63 6e 74 6c 28 69  LCK;.    fcntl(i
6650: 64 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26  d->h, F_SETLK, &
6660: 6c 6f 63 6b 29 3b 0a 20 20 20 20 69 66 28 20 73  lock);.    if( s
6670: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 28   ){.      rc = (
6680: 65 72 72 6e 6f 3d 3d 45 49 4e 56 41 4c 29 20 3f  errno==EINVAL) ?
6690: 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 3a 20   SQLITE_NOLFS : 
66a0: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20  SQLITE_BUSY;.   
66b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 64   }else{.      id
66c0: 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 53 48 41  ->locktype = SHA
66d0: 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20  RED_LOCK;.      
66e0: 69 64 2d 3e 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b  id->pOpen->nLock
66f0: 2b 2b 3b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 2d  ++;.      pLock-
6700: 3e 63 6e 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a  >cnt = 1;.    }.
6710: 20 20 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b    }else if( lock
6720: 74 79 70 65 3d 3d 45 58 43 4c 55 53 49 56 45 5f  type==EXCLUSIVE_
6730: 4c 4f 43 4b 20 26 26 20 70 4c 6f 63 6b 2d 3e 63  LOCK && pLock->c
6740: 6e 74 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20 57  nt>1 ){.    /* W
6750: 65 20 61 72 65 20 74 72 79 69 6e 67 20 66 6f 72  e are trying for
6760: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f   an exclusive lo
6770: 63 6b 20 62 75 74 20 61 6e 6f 74 68 65 72 20 74  ck but another t
6780: 68 72 65 61 64 20 69 6e 20 74 68 69 73 0a 20 20  hread in this.  
6790: 20 20 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65 73    ** same proces
67a0: 73 20 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64 69  s is still holdi
67b0: 6e 67 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b  ng a shared lock
67c0: 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51  . */.    rc = SQ
67d0: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65 6c  LITE_BUSY;.  }el
67e0: 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72  se{.    /* The r
67f0: 65 71 75 65 73 74 20 77 61 73 20 66 6f 72 20 61  equest was for a
6800: 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58 43   RESERVED or EXC
6810: 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49 74  LUSIVE lock.  It
6820: 20 69 73 0a 20 20 20 20 2a 2a 20 61 73 73 75 6d   is.    ** assum
6830: 65 64 20 74 68 61 74 20 74 68 65 72 65 20 69 73  ed that there is
6840: 20 61 20 53 48 41 52 45 44 20 6f 72 20 67 72 65   a SHARED or gre
6850: 61 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65  ater lock on the
6860: 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c 72   file.    ** alr
6870: 65 61 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  eady..    */.   
6880: 20 61 73 73 65 72 74 28 20 30 21 3d 69 64 2d 3e   assert( 0!=id->
6890: 6c 6f 63 6b 74 79 70 65 20 29 3b 0a 20 20 20 20  locktype );.    
68a0: 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f  lock.l_type = F_
68b0: 57 52 4c 43 4b 3b 0a 20 20 20 20 73 77 69 74 63  WRLCK;.    switc
68c0: 68 28 20 6c 6f 63 6b 74 79 70 65 20 29 7b 0a 20  h( locktype ){. 
68d0: 20 20 20 20 20 63 61 73 65 20 52 45 53 45 52 56       case RESERV
68e0: 45 44 5f 4c 4f 43 4b 3a 0a 20 20 20 20 20 20 20  ED_LOCK:.       
68f0: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20   lock.l_start = 
6900: 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a 20  RESERVED_BYTE;. 
6910: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
6920: 20 20 20 20 63 61 73 65 20 45 58 43 4c 55 53 49      case EXCLUSI
6930: 56 45 5f 4c 4f 43 4b 3a 0a 20 20 20 20 20 20 20  VE_LOCK:.       
6940: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20   lock.l_start = 
6950: 53 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20  SHARED_FIRST;.  
6960: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e        lock.l_len
6970: 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45 3b 0a   = SHARED_SIZE;.
6980: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
6990: 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0a 20 20       default:.  
69a0: 20 20 20 20 20 20 61 73 73 65 72 74 28 30 29 3b        assert(0);
69b0: 0a 20 20 20 20 7d 0a 20 20 20 20 73 20 3d 20 66  .    }.    s = f
69c0: 63 6e 74 6c 28 69 64 2d 3e 68 2c 20 46 5f 53 45  cntl(id->h, F_SE
69d0: 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b 0a 20 20 20  TLK, &lock);.   
69e0: 20 69 66 28 20 73 20 29 7b 0a 20 20 20 20 20 20   if( s ){.      
69f0: 72 63 20 3d 20 28 65 72 72 6e 6f 3d 3d 45 49 4e  rc = (errno==EIN
6a00: 56 41 4c 29 20 3f 20 53 51 4c 49 54 45 5f 4e 4f  VAL) ? SQLITE_NO
6a10: 4c 46 53 20 3a 20 53 51 4c 49 54 45 5f 42 55 53  LFS : SQLITE_BUS
6a20: 59 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a  Y;.    }.  }.  .
6a30: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
6a40: 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 64 2d 3e 6c  _OK ){.    id->l
6a50: 6f 63 6b 74 79 70 65 20 3d 20 6c 6f 63 6b 74 79  ocktype = lockty
6a60: 70 65 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 6c  pe;.    pLock->l
6a70: 6f 63 6b 74 79 70 65 20 3d 20 6c 6f 63 6b 74 79  ocktype = lockty
6a80: 70 65 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  pe;.  }else if( 
6a90: 6c 6f 63 6b 74 79 70 65 3d 3d 45 58 43 4c 55 53  locktype==EXCLUS
6aa0: 49 56 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20  IVE_LOCK ){.    
6ab0: 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 50  id->locktype = P
6ac0: 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 20  ENDING_LOCK;.   
6ad0: 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65   pLock->locktype
6ae0: 20 3d 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b   = PENDING_LOCK;
6af0: 0a 20 20 7d 0a 0a 65 6e 64 5f 6c 6f 63 6b 3a 0a  .  }..end_lock:.
6b00: 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65    sqlite3OsLeave
6b10: 4d 75 74 65 78 28 29 3b 0a 20 20 54 52 41 43 45  Mutex();.  TRACE
6b20: 34 28 22 4c 4f 43 4b 20 25 64 20 25 64 20 25 73  4("LOCK %d %d %s
6b30: 5c 6e 22 2c 20 69 64 2d 3e 68 2c 20 6c 6f 63 6b  \n", id->h, lock
6b40: 74 79 70 65 2c 20 72 63 3d 3d 53 51 4c 49 54 45  type, rc==SQLITE
6b50: 5f 4f 4b 20 3f 20 22 6f 6b 22 20 3a 20 22 66 61  _OK ? "ok" : "fa
6b60: 69 6c 65 64 22 29 3b 0a 20 20 72 65 74 75 72 6e  iled");.  return
6b70: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f   rc;.}../*.** Lo
6b80: 77 65 72 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20  wer the locking 
6b90: 6c 65 76 65 6c 20 6f 6e 20 66 69 6c 65 20 64 65  level on file de
6ba0: 73 63 72 69 70 74 6f 72 20 69 64 20 74 6f 20 6c  scriptor id to l
6bb0: 6f 63 6b 74 79 70 65 2e 20 20 6c 6f 63 6b 74 79  ocktype.  lockty
6bc0: 70 65 0a 2a 2a 20 6d 75 73 74 20 62 65 20 65 69  pe.** must be ei
6bd0: 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 20 6f 72 20  ther NO_LOCK or 
6be0: 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a  SHARED_LOCK..**.
6bf0: 2a 2a 20 49 66 20 74 68 65 20 6c 6f 63 6b 69 6e  ** If the lockin
6c00: 67 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 66  g level of the f
6c10: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69  ile descriptor i
6c20: 73 20 61 6c 72 65 61 64 79 20 61 74 20 6f 72 20  s already at or 
6c30: 62 65 6c 6f 77 0a 2a 2a 20 74 68 65 20 72 65 71  below.** the req
6c40: 75 65 73 74 65 64 20 6c 6f 63 6b 69 6e 67 20 6c  uested locking l
6c50: 65 76 65 6c 2c 20 74 68 69 73 20 72 6f 75 74 69  evel, this routi
6c60: 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a  ne is a no-op..*
6c70: 2a 0a 2a 2a 20 49 74 20 69 73 20 6e 6f 74 20 70  *.** It is not p
6c80: 6f 73 73 69 62 6c 65 20 66 6f 72 20 74 68 69 73  ossible for this
6c90: 20 72 6f 75 74 69 6e 65 20 74 6f 20 66 61 69 6c   routine to fail
6ca0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
6cb0: 4f 73 55 6e 6c 6f 63 6b 28 4f 73 46 69 6c 65 20  OsUnlock(OsFile 
6cc0: 2a 69 64 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 70  *id, int locktyp
6cd0: 65 29 7b 0a 20 20 73 74 72 75 63 74 20 6c 6f 63  e){.  struct loc
6ce0: 6b 49 6e 66 6f 20 2a 70 4c 6f 63 6b 3b 0a 20 20  kInfo *pLock;.  
6cf0: 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63  struct flock loc
6d00: 6b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 69 64  k;..  assert( id
6d10: 2d 3e 69 73 4f 70 65 6e 20 29 3b 0a 20 20 54 52  ->isOpen );.  TR
6d20: 41 43 45 36 28 22 55 4e 4c 4f 43 4b 20 25 64 20  ACE6("UNLOCK %d 
6d30: 25 64 20 77 61 73 20 25 64 28 25 64 2c 25 64 29  %d was %d(%d,%d)
6d40: 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 69  \n",.          i
6d50: 64 2d 3e 68 2c 20 6c 6f 63 6b 74 79 70 65 2c 20  d->h, locktype, 
6d60: 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 2c 20 69 64  id->locktype, id
6d70: 2d 3e 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70  ->pLock->locktyp
6d80: 65 2c 20 69 64 2d 3e 70 4c 6f 63 6b 2d 3e 63 6e  e, id->pLock->cn
6d90: 74 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 6c  t);..  assert( l
6da0: 6f 63 6b 74 79 70 65 3c 3d 53 48 41 52 45 44 5f  ocktype<=SHARED_
6db0: 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 69 64  LOCK );.  if( id
6dc0: 2d 3e 6c 6f 63 6b 74 79 70 65 3c 3d 6c 6f 63 6b  ->locktype<=lock
6dd0: 74 79 70 65 20 29 7b 0a 20 20 20 20 72 65 74 75  type ){.    retu
6de0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
6df0: 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 45 6e 74  }.  sqlite3OsEnt
6e00: 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 4c 6f  erMutex();.  pLo
6e10: 63 6b 20 3d 20 69 64 2d 3e 70 4c 6f 63 6b 3b 0a  ck = id->pLock;.
6e20: 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d    assert( pLock-
6e30: 3e 63 6e 74 21 3d 30 20 29 3b 0a 20 20 69 66 28  >cnt!=0 );.  if(
6e40: 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 3e 53 48   id->locktype>SH
6e50: 41 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20  ARED_LOCK ){.   
6e60: 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d 3e   assert( pLock->
6e70: 6c 6f 63 6b 74 79 70 65 3d 3d 69 64 2d 3e 6c 6f  locktype==id->lo
6e80: 63 6b 74 79 70 65 20 29 3b 0a 20 20 20 20 6c 6f  cktype );.    lo
6e90: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e  ck.l_type = F_UN
6ea0: 4c 43 4b 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f  LCK;.    lock.l_
6eb0: 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45  whence = SEEK_SE
6ec0: 54 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74  T;.    lock.l_st
6ed0: 61 72 74 20 3d 20 50 45 4e 44 49 4e 47 5f 42 59  art = PENDING_BY
6ee0: 54 45 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c  TE;.    lock.l_l
6ef0: 65 6e 20 3d 20 32 4c 3b 20 20 61 73 73 65 72 74  en = 2L;  assert
6f00: 28 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2b 31  ( PENDING_BYTE+1
6f10: 3d 3d 52 45 53 45 52 56 45 44 5f 42 59 54 45 20  ==RESERVED_BYTE 
6f20: 29 3b 0a 20 20 20 20 66 63 6e 74 6c 28 69 64 2d  );.    fcntl(id-
6f30: 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f  >h, F_SETLK, &lo
6f40: 63 6b 29 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e  ck);.    pLock->
6f50: 6c 6f 63 6b 74 79 70 65 20 3d 20 53 48 41 52 45  locktype = SHARE
6f60: 44 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 20 69 66  D_LOCK;.  }.  if
6f70: 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 4e 4f 5f 4c  ( locktype==NO_L
6f80: 4f 43 4b 20 29 7b 0a 20 20 20 20 73 74 72 75 63  OCK ){.    struc
6f90: 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 70 65 6e  t openCnt *pOpen
6fa0: 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d  ;..    /* Decrem
6fb0: 65 6e 74 20 74 68 65 20 73 68 61 72 65 64 20 6c  ent the shared l
6fc0: 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20 20 52 65  ock counter.  Re
6fd0: 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b 20 75  lease the lock u
6fe0: 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a 20 4f  sing an.    ** O
6ff0: 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77 68 65 6e  S call only when
7000: 20 61 6c 6c 20 74 68 72 65 61 64 73 20 69 6e 20   all threads in 
7010: 74 68 69 73 20 73 61 6d 65 20 70 72 6f 63 65 73  this same proces
7020: 73 20 68 61 76 65 20 72 65 6c 65 61 73 65 64 0a  s have released.
7030: 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b 2e      ** the lock.
7040: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4c 6f 63  .    */.    pLoc
7050: 6b 2d 3e 63 6e 74 2d 2d 3b 0a 20 20 20 20 69 66  k->cnt--;.    if
7060: 28 20 70 4c 6f 63 6b 2d 3e 63 6e 74 3d 3d 30 20  ( pLock->cnt==0 
7070: 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f  ){.      lock.l_
7080: 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a  type = F_UNLCK;.
7090: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65        lock.l_whe
70a0: 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a  nce = SEEK_SET;.
70b0: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61        lock.l_sta
70c0: 72 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20  rt = lock.l_len 
70d0: 3d 20 30 4c 3b 0a 20 20 20 20 20 20 66 63 6e 74  = 0L;.      fcnt
70e0: 6c 28 69 64 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b  l(id->h, F_SETLK
70f0: 2c 20 26 6c 6f 63 6b 29 3b 0a 20 20 20 20 20 20  , &lock);.      
7100: 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20  pLock->locktype 
7110: 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d  = NO_LOCK;.    }
7120: 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65  ..    /* Decreme
7130: 6e 74 20 74 68 65 20 63 6f 75 6e 74 20 6f 66 20  nt the count of 
7140: 6c 6f 63 6b 73 20 61 67 61 69 6e 73 74 20 74 68  locks against th
7150: 69 73 20 73 61 6d 65 20 66 69 6c 65 2e 20 20 57  is same file.  W
7160: 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 63  hen the.    ** c
7170: 6f 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65 72  ount reaches zer
7180: 6f 2c 20 63 6c 6f 73 65 20 61 6e 79 20 6f 74 68  o, close any oth
7190: 65 72 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  er file descript
71a0: 6f 72 73 20 77 68 6f 73 65 20 63 6c 6f 73 65 0a  ors whose close.
71b0: 20 20 20 20 2a 2a 20 77 61 73 20 64 65 66 65 72      ** was defer
71c0: 72 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 6f  red because of o
71d0: 75 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73  utstanding locks
71e0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4f 70  ..    */.    pOp
71f0: 65 6e 20 3d 20 69 64 2d 3e 70 4f 70 65 6e 3b 0a  en = id->pOpen;.
7200: 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b      pOpen->nLock
7210: 2d 2d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  --;.    assert( 
7220: 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b 3e 3d 30 20  pOpen->nLock>=0 
7230: 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 70 65 6e  );.    if( pOpen
7240: 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 26 26 20 70 4f  ->nLock==0 && pO
7250: 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67 3e 30 20  pen->nPending>0 
7260: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a  ){.      int i;.
7270: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69        for(i=0; i
7280: 3c 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67  <pOpen->nPending
7290: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; i++){.        
72a0: 63 6c 6f 73 65 28 70 4f 70 65 6e 2d 3e 61 50 65  close(pOpen->aPe
72b0: 6e 64 69 6e 67 5b 69 5d 29 3b 0a 20 20 20 20 20  nding[i]);.     
72c0: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46   }.      sqliteF
72d0: 72 65 65 28 70 4f 70 65 6e 2d 3e 61 50 65 6e 64  ree(pOpen->aPend
72e0: 69 6e 67 29 3b 0a 20 20 20 20 20 20 70 4f 70 65  ing);.      pOpe
72f0: 6e 2d 3e 6e 50 65 6e 64 69 6e 67 20 3d 20 30 3b  n->nPending = 0;
7300: 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50  .      pOpen->aP
7310: 65 6e 64 69 6e 67 20 3d 20 30 3b 0a 20 20 20 20  ending = 0;.    
7320: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f  }.  }.  sqlite3O
7330: 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20  sLeaveMutex();. 
7340: 20 69 64 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20   id->locktype = 
7350: 6c 6f 63 6b 74 79 70 65 3b 0a 20 20 72 65 74 75  locktype;.  retu
7360: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
7370: 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66  ./*.** Close a f
7380: 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ile..*/.int sqli
7390: 74 65 33 4f 73 43 6c 6f 73 65 28 4f 73 46 69 6c  te3OsClose(OsFil
73a0: 65 20 2a 69 64 29 7b 0a 20 20 69 66 28 20 21 69  e *id){.  if( !i
73b0: 64 2d 3e 69 73 4f 70 65 6e 20 29 20 72 65 74 75  d->isOpen ) retu
73c0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
73d0: 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28  sqlite3OsUnlock(
73e0: 69 64 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20  id, NO_LOCK);.  
73f0: 69 66 28 20 69 64 2d 3e 64 69 72 66 64 3e 3d 30  if( id->dirfd>=0
7400: 20 29 20 63 6c 6f 73 65 28 69 64 2d 3e 64 69 72   ) close(id->dir
7410: 66 64 29 3b 0a 20 20 69 64 2d 3e 64 69 72 66 64  fd);.  id->dirfd
7420: 20 3d 20 2d 31 3b 0a 20 20 73 71 6c 69 74 65 33   = -1;.  sqlite3
7430: 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a  OsEnterMutex();.
7440: 20 20 69 66 28 20 69 64 2d 3e 70 4f 70 65 6e 2d    if( id->pOpen-
7450: 3e 6e 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 2f 2a  >nLock ){.    /*
7460: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f 75   If there are ou
7470: 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 2c  tstanding locks,
7480: 20 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79   do not actually
7490: 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20   close the file 
74a0: 6a 75 73 74 0a 20 20 20 20 2a 2a 20 79 65 74 20  just.    ** yet 
74b0: 62 65 63 61 75 73 65 20 74 68 61 74 20 77 6f 75  because that wou
74c0: 6c 64 20 63 6c 65 61 72 20 74 68 6f 73 65 20 6c  ld clear those l
74d0: 6f 63 6b 73 2e 20 20 49 6e 73 74 65 61 64 2c 20  ocks.  Instead, 
74e0: 61 64 64 20 74 68 65 20 66 69 6c 65 0a 20 20 20  add the file.   
74f0: 20 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 74   ** descriptor t
7500: 6f 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e  o pOpen->aPendin
7510: 67 2e 20 20 49 74 20 77 69 6c 6c 20 62 65 20 61  g.  It will be a
7520: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f  utomatically clo
7530: 73 65 64 20 77 68 65 6e 0a 20 20 20 20 2a 2a 20  sed when.    ** 
7540: 74 68 65 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73  the last lock is
7550: 20 63 6c 65 61 72 65 64 2e 0a 20 20 20 20 2a 2f   cleared..    */
7560: 0a 20 20 20 20 69 6e 74 20 2a 61 4e 65 77 3b 0a  .    int *aNew;.
7570: 20 20 20 20 73 74 72 75 63 74 20 6f 70 65 6e 43      struct openC
7580: 6e 74 20 2a 70 4f 70 65 6e 20 3d 20 69 64 2d 3e  nt *pOpen = id->
7590: 70 4f 70 65 6e 3b 0a 20 20 20 20 70 4f 70 65 6e  pOpen;.    pOpen
75a0: 2d 3e 6e 50 65 6e 64 69 6e 67 2b 2b 3b 0a 20 20  ->nPending++;.  
75b0: 20 20 61 4e 65 77 20 3d 20 73 71 6c 69 74 65 52    aNew = sqliteR
75c0: 65 61 6c 6c 6f 63 28 20 70 4f 70 65 6e 2d 3e 61  ealloc( pOpen->a
75d0: 50 65 6e 64 69 6e 67 2c 20 70 4f 70 65 6e 2d 3e  Pending, pOpen->
75e0: 6e 50 65 6e 64 69 6e 67 2a 73 69 7a 65 6f 66 28  nPending*sizeof(
75f0: 69 6e 74 29 20 29 3b 0a 20 20 20 20 69 66 28 20  int) );.    if( 
7600: 61 4e 65 77 3d 3d 30 20 29 7b 0a 20 20 20 20 20  aNew==0 ){.     
7610: 20 2f 2a 20 49 66 20 61 20 6d 61 6c 6c 6f 63 20   /* If a malloc 
7620: 66 61 69 6c 73 2c 20 6a 75 73 74 20 6c 65 61 6b  fails, just leak
7630: 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69   the file descri
7640: 70 74 6f 72 20 2a 2f 0a 20 20 20 20 7d 65 6c 73  ptor */.    }els
7650: 65 7b 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e  e{.      pOpen->
7660: 61 50 65 6e 64 69 6e 67 20 3d 20 61 4e 65 77 3b  aPending = aNew;
7670: 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50  .      pOpen->aP
7680: 65 6e 64 69 6e 67 5b 70 4f 70 65 6e 2d 3e 6e 50  ending[pOpen->nP
7690: 65 6e 64 69 6e 67 2d 31 5d 20 3d 20 69 64 2d 3e  ending-1] = id->
76a0: 68 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  h;.    }.  }else
76b0: 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61  {.    /* There a
76c0: 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e  re no outstandin
76d0: 67 20 6c 6f 63 6b 73 20 73 6f 20 77 65 20 63 61  g locks so we ca
76e0: 6e 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65  n close the file
76f0: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 2a 2f 0a   immediately */.
7700: 20 20 20 20 63 6c 6f 73 65 28 69 64 2d 3e 68 29      close(id->h)
7710: 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 4c  ;.  }.  releaseL
7720: 6f 63 6b 49 6e 66 6f 28 69 64 2d 3e 70 4c 6f 63  ockInfo(id->pLoc
7730: 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65 4f 70 65  k);.  releaseOpe
7740: 6e 43 6e 74 28 69 64 2d 3e 70 4f 70 65 6e 29 3b  nCnt(id->pOpen);
7750: 0a 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76  .  sqlite3OsLeav
7760: 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 64 2d 3e  eMutex();.  id->
7770: 69 73 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 54 52  isOpen = 0;.  TR
7780: 41 43 45 32 28 22 43 4c 4f 53 45 20 20 20 25 2d  ACE2("CLOSE   %-
7790: 33 64 5c 6e 22 2c 20 69 64 2d 3e 68 29 3b 0a 20  3d\n", id->h);. 
77a0: 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 2d 31 29   OpenCounter(-1)
77b0: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
77c0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47  E_OK;.}../*.** G
77d0: 65 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74  et information t
77e0: 6f 20 73 65 65 64 20 74 68 65 20 72 61 6e 64 6f  o seed the rando
77f0: 6d 20 6e 75 6d 62 65 72 20 67 65 6e 65 72 61 74  m number generat
7800: 6f 72 2e 20 20 54 68 65 20 73 65 65 64 0a 2a 2a  or.  The seed.**
7810: 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f   is written into
7820: 20 74 68 65 20 62 75 66 66 65 72 20 7a 42 75 66   the buffer zBuf
7830: 5b 32 35 36 5d 2e 20 20 54 68 65 20 63 61 6c 6c  [256].  The call
7840: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73  ing function mus
7850: 74 0a 2a 2a 20 73 75 70 70 6c 79 20 61 20 73 75  t.** supply a su
7860: 66 66 69 63 69 65 6e 74 6c 79 20 6c 61 72 67 65  fficiently large
7870: 20 62 75 66 66 65 72 2e 0a 2a 2f 0a 69 6e 74 20   buffer..*/.int 
7880: 73 71 6c 69 74 65 33 4f 73 52 61 6e 64 6f 6d 53  sqlite3OsRandomS
7890: 65 65 64 28 63 68 61 72 20 2a 7a 42 75 66 29 7b  eed(char *zBuf){
78a0: 0a 20 20 2f 2a 20 57 65 20 68 61 76 65 20 74 6f  .  /* We have to
78b0: 20 69 6e 69 74 69 61 6c 69 7a 65 20 7a 42 75 66   initialize zBuf
78c0: 20 74 6f 20 70 72 65 76 65 6e 74 20 76 61 6c 67   to prevent valg
78d0: 72 69 6e 64 20 66 72 6f 6d 20 72 65 70 6f 72 74  rind from report
78e0: 69 6e 67 0a 20 20 2a 2a 20 65 72 72 6f 72 73 2e  ing.  ** errors.
78f0: 20 20 54 68 65 20 72 65 70 6f 72 74 73 20 69 73    The reports is
7900: 73 75 65 64 20 62 79 20 76 61 6c 67 72 69 6e 64  sued by valgrind
7910: 20 61 72 65 20 69 6e 63 6f 72 72 65 63 74 20 2d   are incorrect -
7920: 20 77 65 20 77 6f 75 6c 64 0a 20 20 2a 2a 20 70   we would.  ** p
7930: 72 65 66 65 72 20 74 68 61 74 20 74 68 65 20 72  refer that the r
7940: 61 6e 64 6f 6d 6e 65 73 73 20 62 65 20 69 6e 63  andomness be inc
7950: 72 65 61 73 65 64 20 62 79 20 6d 61 6b 69 6e 67  reased by making
7960: 20 75 73 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a   use of the.  **
7970: 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 73   uninitialized s
7980: 70 61 63 65 20 69 6e 20 7a 42 75 66 20 2d 20 62  pace in zBuf - b
7990: 75 74 20 76 61 6c 67 72 69 6e 64 20 65 72 72 6f  ut valgrind erro
79a0: 72 73 20 74 65 6e 64 20 74 6f 20 77 6f 72 72 79  rs tend to worry
79b0: 0a 20 20 2a 2a 20 73 6f 6d 65 20 75 73 65 72 73  .  ** some users
79c0: 2e 20 20 52 61 74 68 65 72 20 74 68 61 6e 20 61  .  Rather than a
79d0: 72 67 75 65 2c 20 69 74 20 73 65 65 6d 73 20 65  rgue, it seems e
79e0: 61 73 69 65 72 20 6a 75 73 74 20 74 6f 20 69 6e  asier just to in
79f0: 69 74 69 61 6c 69 7a 65 0a 20 20 2a 2a 20 74 68  itialize.  ** th
7a00: 65 20 77 68 6f 6c 65 20 61 72 72 61 79 20 61 6e  e whole array an
7a10: 64 20 73 69 6c 65 6e 63 65 20 76 61 6c 67 72 69  d silence valgri
7a20: 6e 64 2c 20 65 76 65 6e 20 69 66 20 74 68 61 74  nd, even if that
7a30: 20 6d 65 61 6e 73 20 6c 65 73 73 20 72 61 6e 64   means less rand
7a40: 6f 6d 6e 65 73 73 0a 20 20 2a 2a 20 69 6e 20 74  omness.  ** in t
7a50: 68 65 20 72 61 6e 64 6f 6d 20 73 65 65 64 2e 0a  he random seed..
7a60: 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 74    **.  ** When t
7a70: 65 73 74 69 6e 67 2c 20 69 6e 69 74 69 61 6c 69  esting, initiali
7a80: 7a 69 6e 67 20 7a 42 75 66 5b 5d 20 74 6f 20 7a  zing zBuf[] to z
7a90: 65 72 6f 20 69 73 20 61 6c 6c 20 77 65 20 64 6f  ero is all we do
7aa0: 2e 20 20 54 68 61 74 20 6d 65 61 6e 73 0a 20 20  .  That means.  
7ab0: 2a 2a 20 74 68 61 74 20 77 65 20 61 6c 77 61 79  ** that we alway
7ac0: 73 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 72  s use the same r
7ad0: 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 73 65 71  andom number seq
7ae0: 75 65 6e 63 65 2e 2a 20 54 68 69 73 20 6d 61 6b  uence.* This mak
7af0: 65 73 20 74 68 65 0a 20 20 2a 2a 20 74 65 73 74  es the.  ** test
7b00: 73 20 72 65 70 65 61 74 61 62 6c 65 2e 0a 20 20  s repeatable..  
7b10: 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 7a 42 75 66  */.  memset(zBuf
7b20: 2c 20 30 2c 20 32 35 36 29 3b 0a 23 69 66 20 21  , 0, 256);.#if !
7b30: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54  defined(SQLITE_T
7b40: 45 53 54 29 0a 20 20 7b 0a 20 20 20 20 69 6e 74  EST).  {.    int
7b50: 20 70 69 64 3b 0a 20 20 20 20 74 69 6d 65 28 28   pid;.    time((
7b60: 74 69 6d 65 5f 74 2a 29 7a 42 75 66 29 3b 0a 20  time_t*)zBuf);. 
7b70: 20 20 20 70 69 64 20 3d 20 67 65 74 70 69 64 28     pid = getpid(
7b80: 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 7a  );.    memcpy(&z
7b90: 42 75 66 5b 73 69 7a 65 6f 66 28 74 69 6d 65 5f  Buf[sizeof(time_
7ba0: 74 29 5d 2c 20 26 70 69 64 2c 20 73 69 7a 65 6f  t)], &pid, sizeo
7bb0: 66 28 70 69 64 29 29 3b 0a 20 20 7d 0a 23 65 6e  f(pid));.  }.#en
7bc0: 64 69 66 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  dif.  return SQL
7bd0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
7be0: 20 53 6c 65 65 70 20 66 6f 72 20 61 20 6c 69 74   Sleep for a lit
7bf0: 74 6c 65 20 77 68 69 6c 65 2e 20 20 52 65 74 75  tle while.  Retu
7c00: 72 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66  rn the amount of
7c10: 20 74 69 6d 65 20 73 6c 65 70 74 2e 0a 2a 2f 0a   time slept..*/.
7c20: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 53 6c 65  int sqlite3OsSle
7c30: 65 70 28 69 6e 74 20 6d 73 29 7b 0a 23 69 66 20  ep(int ms){.#if 
7c40: 64 65 66 69 6e 65 64 28 48 41 56 45 5f 55 53 4c  defined(HAVE_USL
7c50: 45 45 50 29 20 26 26 20 48 41 56 45 5f 55 53 4c  EEP) && HAVE_USL
7c60: 45 45 50 0a 20 20 75 73 6c 65 65 70 28 6d 73 2a  EEP.  usleep(ms*
7c70: 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20  1000);.  return 
7c80: 6d 73 3b 0a 23 65 6c 73 65 0a 20 20 73 6c 65 65  ms;.#else.  slee
7c90: 70 28 28 6d 73 2b 39 39 39 29 2f 31 30 30 30 29  p((ms+999)/1000)
7ca0: 3b 0a 20 20 72 65 74 75 72 6e 20 31 30 30 30 2a  ;.  return 1000*
7cb0: 28 28 6d 73 2b 39 39 39 29 2f 31 30 30 30 29 3b  ((ms+999)/1000);
7cc0: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a  .#endif.}../*.**
7cd0: 20 53 74 61 74 69 63 20 76 61 72 69 61 62 6c 65   Static variable
7ce0: 73 20 75 73 65 64 20 66 6f 72 20 74 68 72 65 61  s used for threa
7cf0: 64 20 73 79 6e 63 68 72 6f 6e 69 7a 61 74 69 6f  d synchronizatio
7d00: 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  n.*/.static int 
7d10: 69 6e 4d 75 74 65 78 20 3d 20 30 3b 0a 23 69 66  inMutex = 0;.#if
7d20: 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f  def SQLITE_UNIX_
7d30: 54 48 52 45 41 44 53 0a 73 74 61 74 69 63 20 70  THREADS.static p
7d40: 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 74 20 6d  thread_mutex_t m
7d50: 75 74 65 78 20 3d 20 50 54 48 52 45 41 44 5f 4d  utex = PTHREAD_M
7d60: 55 54 45 58 5f 49 4e 49 54 49 41 4c 49 5a 45 52  UTEX_INITIALIZER
7d70: 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  ;.#endif../*.** 
7d80: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61  The following pa
7d90: 69 72 20 6f 66 20 72 6f 75 74 69 6e 65 20 69 6d  ir of routine im
7da0: 70 6c 65 6d 65 6e 74 20 6d 75 74 75 61 6c 20 65  plement mutual e
7db0: 78 63 6c 75 73 69 6f 6e 20 66 6f 72 0a 2a 2a 20  xclusion for.** 
7dc0: 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 70  multi-threaded p
7dd0: 72 6f 63 65 73 73 65 73 2e 20 20 4f 6e 6c 79 20  rocesses.  Only 
7de0: 61 20 73 69 6e 67 6c 65 20 74 68 72 65 61 64 20  a single thread 
7df0: 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 0a 2a 2a  is allowed to.**
7e00: 20 65 78 65 63 75 74 65 64 20 63 6f 64 65 20 74   executed code t
7e10: 68 61 74 20 69 73 20 73 75 72 72 6f 75 6e 64 65  hat is surrounde
7e20: 64 20 62 79 20 45 6e 74 65 72 4d 75 74 65 78 28  d by EnterMutex(
7e30: 29 20 61 6e 64 20 4c 65 61 76 65 4d 75 74 65 78  ) and LeaveMutex
7e40: 28 29 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 69 74 65  ()..**.** SQLite
7e50: 20 75 73 65 73 20 6f 6e 6c 79 20 61 20 73 69 6e   uses only a sin
7e60: 67 6c 65 20 4d 75 74 65 78 2e 20 20 54 68 65 72  gle Mutex.  Ther
7e70: 65 20 69 73 20 6e 6f 74 20 6d 75 63 68 20 63 72  e is not much cr
7e80: 69 74 69 63 61 6c 0a 2a 2a 20 63 6f 64 65 20 61  itical.** code a
7e90: 6e 64 20 77 68 61 74 20 6c 69 74 74 6c 65 20 74  nd what little t
7ea0: 68 65 72 65 20 69 73 20 65 78 65 63 75 74 65 73  here is executes
7eb0: 20 71 75 69 63 6b 6c 79 20 61 6e 64 20 77 69 74   quickly and wit
7ec0: 68 6f 75 74 20 62 6c 6f 63 6b 69 6e 67 2e 0a 2a  hout blocking..*
7ed0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4f 73  /.void sqlite3Os
7ee0: 45 6e 74 65 72 4d 75 74 65 78 28 29 7b 0a 23 69  EnterMutex(){.#i
7ef0: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58  fdef SQLITE_UNIX
7f00: 5f 54 48 52 45 41 44 53 0a 20 20 70 74 68 72 65  _THREADS.  pthre
7f10: 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 6d  ad_mutex_lock(&m
7f20: 75 74 65 78 29 3b 0a 23 65 6e 64 69 66 0a 20 20  utex);.#endif.  
7f30: 61 73 73 65 72 74 28 20 21 69 6e 4d 75 74 65 78  assert( !inMutex
7f40: 20 29 3b 0a 20 20 69 6e 4d 75 74 65 78 20 3d 20   );.  inMutex = 
7f50: 31 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  1;.}.void sqlite
7f60: 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 7b  3OsLeaveMutex(){
7f70: 0a 20 20 61 73 73 65 72 74 28 20 69 6e 4d 75 74  .  assert( inMut
7f80: 65 78 20 29 3b 0a 20 20 69 6e 4d 75 74 65 78 20  ex );.  inMutex 
7f90: 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  = 0;.#ifdef SQLI
7fa0: 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 0a  TE_UNIX_THREADS.
7fb0: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
7fc0: 75 6e 6c 6f 63 6b 28 26 6d 75 74 65 78 29 3b 0a  unlock(&mutex);.
7fd0: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  #endif.}../*.** 
7fe0: 54 75 72 6e 20 61 20 72 65 6c 61 74 69 76 65 20  Turn a relative 
7ff0: 70 61 74 68 6e 61 6d 65 20 69 6e 74 6f 20 61 20  pathname into a 
8000: 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 2e 20 20  full pathname.  
8010: 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  Return a pointer
8020: 0a 2a 2a 20 74 6f 20 74 68 65 20 66 75 6c 6c 20  .** to the full 
8030: 70 61 74 68 6e 61 6d 65 20 73 74 6f 72 65 64 20  pathname stored 
8040: 69 6e 20 73 70 61 63 65 20 6f 62 74 61 69 6e 65  in space obtaine
8050: 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c  d from sqliteMal
8060: 6c 6f 63 28 29 2e 0a 2a 2a 20 54 68 65 20 63 61  loc()..** The ca
8070: 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 69  lling function i
8080: 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f  s responsible fo
8090: 72 20 66 72 65 65 69 6e 67 20 74 68 69 73 20 73  r freeing this s
80a0: 70 61 63 65 20 6f 6e 63 65 20 69 74 0a 2a 2a 20  pace once it.** 
80b0: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6e 65 65  is no longer nee
80c0: 64 65 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71  ded..*/.char *sq
80d0: 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 68 6e  lite3OsFullPathn
80e0: 61 6d 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  ame(const char *
80f0: 7a 52 65 6c 61 74 69 76 65 29 7b 0a 20 20 63 68  zRelative){.  ch
8100: 61 72 20 2a 7a 46 75 6c 6c 20 3d 20 30 3b 0a 20  ar *zFull = 0;. 
8110: 20 69 66 28 20 7a 52 65 6c 61 74 69 76 65 5b 30   if( zRelative[0
8120: 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20 20 20 73 71  ]=='/' ){.    sq
8130: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26  lite3SetString(&
8140: 7a 46 75 6c 6c 2c 20 7a 52 65 6c 61 74 69 76 65  zFull, zRelative
8150: 2c 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 7d  , (char*)0);.  }
8160: 65 6c 73 65 7b 0a 20 20 20 20 63 68 61 72 20 7a  else{.    char z
8170: 42 75 66 5b 35 30 30 30 5d 3b 0a 20 20 20 20 73  Buf[5000];.    s
8180: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
8190: 26 7a 46 75 6c 6c 2c 20 67 65 74 63 77 64 28 7a  &zFull, getcwd(z
81a0: 42 75 66 2c 20 73 69 7a 65 6f 66 28 7a 42 75 66  Buf, sizeof(zBuf
81b0: 29 29 2c 20 22 2f 22 2c 20 7a 52 65 6c 61 74 69  )), "/", zRelati
81c0: 76 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  ve,.            
81d0: 20 20 20 20 20 20 20 20 28 63 68 61 72 2a 29 30          (char*)0
81e0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
81f0: 7a 46 75 6c 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  zFull;.}../*.** 
8200: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61  The following va
8210: 72 69 61 62 6c 65 2c 20 69 66 20 73 65 74 20 74  riable, if set t
8220: 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c  o a non-zero val
8230: 75 65 2c 20 62 65 63 6f 6d 65 73 20 74 68 65 20  ue, becomes the 
8240: 72 65 73 75 6c 74 0a 2a 2a 20 72 65 74 75 72 6e  result.** return
8250: 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 4f  ed from sqlite3O
8260: 73 43 75 72 72 65 6e 74 54 69 6d 65 28 29 2e 20  sCurrentTime(). 
8270: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 66 6f   This is used fo
8280: 72 20 74 65 73 74 69 6e 67 2e 0a 2a 2f 0a 23 69  r testing..*/.#i
8290: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
82a0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 75 72  .int sqlite3_cur
82b0: 72 65 6e 74 5f 74 69 6d 65 20 3d 20 30 3b 0a 23  rent_time = 0;.#
82c0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e  endif../*.** Fin
82d0: 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 69  d the current ti
82e0: 6d 65 20 28 69 6e 20 55 6e 69 76 65 72 73 61 6c  me (in Universal
82f0: 20 43 6f 6f 72 64 69 6e 61 74 65 64 20 54 69 6d   Coordinated Tim
8300: 65 29 2e 20 20 57 72 69 74 65 20 74 68 65 0a 2a  e).  Write the.*
8310: 2a 20 63 75 72 72 65 6e 74 20 74 69 6d 65 20 61  * current time a
8320: 6e 64 20 64 61 74 65 20 61 73 20 61 20 4a 75 6c  nd date as a Jul
8330: 69 61 6e 20 44 61 79 20 6e 75 6d 62 65 72 20 69  ian Day number i
8340: 6e 74 6f 20 2a 70 72 4e 6f 77 20 61 6e 64 0a 2a  nto *prNow and.*
8350: 2a 20 72 65 74 75 72 6e 20 30 2e 20 20 52 65 74  * return 0.  Ret
8360: 75 72 6e 20 31 20 69 66 20 74 68 65 20 74 69 6d  urn 1 if the tim
8370: 65 20 61 6e 64 20 64 61 74 65 20 63 61 6e 6e 6f  e and date canno
8380: 74 20 62 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 69  t be found..*/.i
8390: 6e 74 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72  nt sqlite3OsCurr
83a0: 65 6e 74 54 69 6d 65 28 64 6f 75 62 6c 65 20 2a  entTime(double *
83b0: 70 72 4e 6f 77 29 7b 0a 20 20 74 69 6d 65 5f 74  prNow){.  time_t
83c0: 20 74 3b 0a 20 20 74 69 6d 65 28 26 74 29 3b 0a   t;.  time(&t);.
83d0: 20 20 2a 70 72 4e 6f 77 20 3d 20 74 2f 38 36 34    *prNow = t/864
83e0: 30 30 2e 30 20 2b 20 32 34 34 30 35 38 37 2e 35  00.0 + 2440587.5
83f0: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
8400: 54 45 53 54 0a 20 20 69 66 28 20 73 71 6c 69 74  TEST.  if( sqlit
8410: 65 33 5f 63 75 72 72 65 6e 74 5f 74 69 6d 65 20  e3_current_time 
8420: 29 7b 0a 20 20 20 20 2a 70 72 4e 6f 77 20 3d 20  ){.    *prNow = 
8430: 73 71 6c 69 74 65 33 5f 63 75 72 72 65 6e 74 5f  sqlite3_current_
8440: 74 69 6d 65 2f 38 36 34 30 30 2e 30 20 2b 20 32  time/86400.0 + 2
8450: 34 34 30 35 38 37 2e 35 3b 0a 20 20 7d 0a 23 65  440587.5;.  }.#e
8460: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 30 3b  ndif.  return 0;
8470: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 74  .}../*.** Find t
8480: 68 65 20 74 69 6d 65 20 74 68 61 74 20 74 68 65  he time that the
8490: 20 66 69 6c 65 20 77 61 73 20 6c 61 73 74 20 6d   file was last m
84a0: 6f 64 69 66 69 65 64 2e 20 20 57 72 69 74 65 20  odified.  Write 
84b0: 74 68 65 0a 2a 2a 20 6d 6f 64 69 66 69 63 61 74  the.** modificat
84c0: 69 6f 6e 20 74 69 6d 65 20 61 6e 64 20 64 61 74  ion time and dat
84d0: 65 20 61 73 20 61 20 4a 75 6c 69 61 6e 20 44 61  e as a Julian Da
84e0: 79 20 6e 75 6d 62 65 72 20 69 6e 74 6f 20 2a 70  y number into *p
84f0: 72 4e 6f 77 20 61 6e 64 0a 2a 2a 20 72 65 74 75  rNow and.** retu
8500: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 20 52  rn SQLITE_OK.  R
8510: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
8520: 4f 52 20 69 66 20 74 68 65 20 6d 6f 64 69 66 69  OR if the modifi
8530: 63 61 74 69 6f 6e 0a 2a 2a 20 74 69 6d 65 20 63  cation.** time c
8540: 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2e 0a  annot be found..
8550: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73  */.int sqlite3Os
8560: 46 69 6c 65 4d 6f 64 54 69 6d 65 28 4f 73 46 69  FileModTime(OsFi
8570: 6c 65 20 2a 69 64 2c 20 64 6f 75 62 6c 65 20 2a  le *id, double *
8580: 70 72 4e 6f 77 29 7b 0a 20 20 69 6e 74 20 72 63  prNow){.  int rc
8590: 3b 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 20  ;.  struct stat 
85a0: 73 74 61 74 62 75 66 3b 0a 20 20 69 66 28 20 66  statbuf;.  if( f
85b0: 73 74 61 74 28 69 64 2d 3e 68 2c 20 26 73 74 61  stat(id->h, &sta
85c0: 74 62 75 66 29 3d 3d 30 20 29 7b 0a 20 20 20 20  tbuf)==0 ){.    
85d0: 2a 70 72 4e 6f 77 20 3d 20 73 74 61 74 62 75 66  *prNow = statbuf
85e0: 2e 73 74 5f 6d 74 69 6d 65 2f 38 36 34 30 30 2e  .st_mtime/86400.
85f0: 30 20 2b 20 32 34 34 30 35 38 37 2e 35 3b 0a 20  0 + 2440587.5;. 
8600: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
8610: 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  K;.  }else{.    
8620: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f  rc = SQLITE_ERRO
8630: 52 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  R;.  }.  return 
8640: 72 63 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a  rc;.}..#endif /*
8650: 20 4f 53 5f 55 4e 49 58 20 2a 2f 0a               OS_UNIX */.