/ Hex Artifact Content
Login

Artifact e6ff5035b3d06fc69773e52e1bc6f7f7ccace084:


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 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
01d0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a  #include "os.h".
01e0: 23 69 66 20 4f 53 5f 55 4e 49 58 20 20 20 20 20  #if OS_UNIX     
01f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73           /* This
0200: 20 66 69 6c 65 20 69 73 20 75 73 65 64 20 6f 6e   file is used on
0210: 20 75 6e 69 78 20 6f 6e 6c 79 20 2a 2f 0a 0a 2f   unix only */../
0220: 2a 0a 2a 2a 20 54 68 65 73 65 20 23 64 65 66 69  *.** These #defi
0230: 6e 65 73 20 73 68 6f 75 6c 64 20 65 6e 61 62 6c  nes should enabl
0240: 65 20 3e 32 47 42 20 66 69 6c 65 20 73 75 70 70  e >2GB file supp
0250: 6f 72 74 20 6f 6e 20 50 6f 73 69 78 20 69 66 20  ort on Posix if 
0260: 74 68 65 0a 2a 2a 20 75 6e 64 65 72 6c 79 69 6e  the.** underlyin
0270: 67 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  g operating syst
0280: 65 6d 20 73 75 70 70 6f 72 74 73 20 69 74 2e 20  em supports it. 
0290: 20 49 66 20 74 68 65 20 4f 53 20 6c 61 63 6b 73   If the OS lacks
02a0: 0a 2a 2a 20 6c 61 72 67 65 20 66 69 6c 65 20 73  .** large file s
02b0: 75 70 70 6f 72 74 2c 20 6f 72 20 69 66 20 74 68  upport, or if th
02c0: 65 20 4f 53 20 69 73 20 77 69 6e 64 6f 77 73 2c  e OS is windows,
02d0: 20 74 68 65 73 65 20 73 68 6f 75 6c 64 20 62 65   these should be
02e0: 20 6e 6f 2d 6f 70 73 2e 0a 2a 2a 0a 2a 2a 20 4c   no-ops..**.** L
02f0: 61 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72  arge file suppor
0300: 74 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c 65  t can be disable
0310: 64 20 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51  d using the -DSQ
0320: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53  LITE_DISABLE_LFS
0330: 20 73 77 69 74 63 68 0a 2a 2a 20 6f 6e 20 74 68   switch.** on th
0340: 65 20 63 6f 6d 70 69 6c 65 72 20 63 6f 6d 6d 61  e compiler comma
0350: 6e 64 20 6c 69 6e 65 2e 20 20 54 68 69 73 20 69  nd line.  This i
0360: 73 20 6e 65 63 65 73 73 61 72 79 20 69 66 20 79  s necessary if y
0370: 6f 75 20 61 72 65 20 63 6f 6d 70 69 6c 69 6e 67  ou are compiling
0380: 0a 2a 2a 20 6f 6e 20 61 20 72 65 63 65 6e 74 20  .** on a recent 
0390: 6d 61 63 68 69 6e 65 20 28 65 78 3a 20 52 65 64  machine (ex: Red
03a0: 48 61 74 20 37 2e 32 29 20 62 75 74 20 79 6f 75  Hat 7.2) but you
03b0: 20 77 61 6e 74 20 79 6f 75 72 20 63 6f 64 65 20   want your code 
03c0: 74 6f 20 77 6f 72 6b 0a 2a 2a 20 6f 6e 20 61 6e  to work.** on an
03d0: 20 6f 6c 64 65 72 20 6d 61 63 68 69 6e 65 20 28   older machine (
03e0: 65 78 3a 20 52 65 64 48 61 74 20 36 2e 30 29 2e  ex: RedHat 6.0).
03f0: 20 20 49 66 20 79 6f 75 20 63 6f 6d 70 69 6c 65    If you compile
0400: 20 6f 6e 20 52 65 64 48 61 74 20 37 2e 32 0a 2a   on RedHat 7.2.*
0410: 2a 20 77 69 74 68 6f 75 74 20 74 68 69 73 20 6f  * without this o
0420: 70 74 69 6f 6e 2c 20 4c 46 53 20 69 73 20 65 6e  ption, LFS is en
0430: 61 62 6c 65 2e 20 20 42 75 74 20 4c 46 53 20 64  able.  But LFS d
0440: 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 20 69 6e  oes not exist in
0450: 20 74 68 65 20 6b 65 72 6e 65 6c 0a 2a 2a 20 69   the kernel.** i
0460: 6e 20 52 65 64 48 61 74 20 36 2e 30 2c 20 73 6f  n RedHat 6.0, so
0470: 20 74 68 65 20 63 6f 64 65 20 77 6f 6e 27 74 20   the code won't 
0480: 77 6f 72 6b 2e 20 20 48 65 6e 63 65 2c 20 66 6f  work.  Hence, fo
0490: 72 20 6d 61 78 69 6d 75 6d 20 62 69 6e 61 72 79  r maximum binary
04a0: 0a 2a 2a 20 70 6f 72 74 61 62 69 6c 69 74 79 20  .** portability 
04b0: 79 6f 75 20 73 68 6f 75 6c 64 20 6f 6d 69 74 20  you should omit 
04c0: 4c 46 53 2e 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c  LFS..**.** Simil
04d0: 61 72 20 69 73 20 74 72 75 65 20 66 6f 72 20 4d  ar is true for M
04e0: 61 63 4f 53 2e 20 20 4c 46 53 20 69 73 20 6f 6e  acOS.  LFS is on
04f0: 6c 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20  ly supported on 
0500: 4d 61 63 4f 53 20 39 20 61 6e 64 20 6c 61 74 65  MacOS 9 and late
0510: 72 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51  r..*/.#ifndef SQ
0520: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53  LITE_DISABLE_LFS
0530: 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45  .# define _LARGE
0540: 5f 46 49 4c 45 20 20 20 20 20 20 20 31 0a 23 20  _FILE       1.# 
0550: 69 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f 46 46  ifndef _FILE_OFF
0560: 53 45 54 5f 42 49 54 53 0a 23 20 20 20 64 65 66  SET_BITS.#   def
0570: 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54  ine _FILE_OFFSET
0580: 5f 42 49 54 53 20 36 34 0a 23 20 65 6e 64 69 66  _BITS 64.# endif
0590: 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45  .# define _LARGE
05a0: 46 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a 23 65  FILE_SOURCE 1.#e
05b0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 73 74 61 6e  ndif../*.** stan
05c0: 64 61 72 64 20 69 6e 63 6c 75 64 65 20 66 69 6c  dard include fil
05d0: 65 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20  es..*/.#include 
05e0: 3c 73 79 73 2f 74 79 70 65 73 2e 68 3e 0a 23 69  <sys/types.h>.#i
05f0: 6e 63 6c 75 64 65 20 3c 73 79 73 2f 73 74 61 74  nclude <sys/stat
0600: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 66 63  .h>.#include <fc
0610: 6e 74 6c 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  ntl.h>.#include 
0620: 3c 75 6e 69 73 74 64 2e 68 3e 0a 23 69 6e 63 6c  <unistd.h>.#incl
0630: 75 64 65 20 3c 74 69 6d 65 2e 68 3e 0a 23 69 6e  ude <time.h>.#in
0640: 63 6c 75 64 65 20 3c 73 79 73 2f 74 69 6d 65 2e  clude <sys/time.
0650: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 65 72 72  h>.#include <err
0660: 6e 6f 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63  no.h>../*.** Mac
0670: 72 6f 73 20 75 73 65 64 20 74 6f 20 64 65 74 65  ros used to dete
0680: 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72  rmine whether or
0690: 20 6e 6f 74 20 74 6f 20 75 73 65 20 74 68 72 65   not to use thre
06a0: 61 64 73 2e 20 20 54 68 65 0a 2a 2a 20 53 51 4c  ads.  The.** SQL
06b0: 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53  ITE_UNIX_THREADS
06c0: 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65   macro is define
06d0: 64 20 69 66 20 77 65 20 61 72 65 20 73 79 6e 63  d if we are sync
06e0: 68 72 6f 6e 69 7a 69 6e 67 20 66 6f 72 0a 2a 2a  hronizing for.**
06f0: 20 50 6f 73 69 78 20 74 68 72 65 61 64 73 20 61   Posix threads a
0700: 6e 64 20 53 51 4c 49 54 45 5f 57 33 32 5f 54 48  nd SQLITE_W32_TH
0710: 52 45 41 44 53 20 69 73 20 64 65 66 69 6e 65 64  READS is defined
0720: 20 69 66 20 77 65 20 61 72 65 0a 2a 2a 20 73 79   if we are.** sy
0730: 6e 63 68 72 6f 6e 69 7a 69 6e 67 20 75 73 69 6e  nchronizing usin
0740: 67 20 57 69 6e 33 32 20 74 68 72 65 61 64 73 2e  g Win32 threads.
0750: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28  .*/.#if defined(
0760: 54 48 52 45 41 44 53 41 46 45 29 20 26 26 20 54  THREADSAFE) && T
0770: 48 52 45 41 44 53 41 46 45 0a 23 20 69 6e 63 6c  HREADSAFE.# incl
0780: 75 64 65 20 3c 70 74 68 72 65 61 64 2e 68 3e 0a  ude <pthread.h>.
0790: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  # define SQLITE_
07a0: 55 4e 49 58 5f 54 48 52 45 41 44 53 20 31 0a 23  UNIX_THREADS 1.#
07b0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66  endif../*.** Def
07c0: 61 75 6c 74 20 70 65 72 6d 69 73 73 69 6f 6e 73  ault permissions
07d0: 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61   when creating a
07e0: 20 6e 65 77 20 66 69 6c 65 0a 2a 2f 0a 23 69 66   new file.*/.#if
07f0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41  ndef SQLITE_DEFA
0800: 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53  ULT_FILE_PERMISS
0810: 49 4f 4e 53 0a 23 20 64 65 66 69 6e 65 20 53 51  IONS.# define SQ
0820: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c  LITE_DEFAULT_FIL
0830: 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 20 30 36  E_PERMISSIONS 06
0840: 34 34 0a 23 65 6e 64 69 66 0a 0a 0a 0a 2f 2a 0a  44.#endif..../*.
0850: 2a 2a 20 54 68 65 20 75 6e 69 78 46 69 6c 65 20  ** The unixFile 
0860: 73 74 72 75 63 74 75 72 65 20 69 73 20 73 75 62  structure is sub
0870: 63 6c 61 73 73 20 6f 66 20 4f 73 46 69 6c 65 20  class of OsFile 
0880: 73 70 65 63 69 66 69 63 20 66 6f 72 20 74 68 65  specific for the
0890: 20 75 6e 69 78 0a 2a 2a 20 70 72 6f 74 61 62 69   unix.** protabi
08a0: 6c 69 74 79 20 6c 61 79 65 72 2e 0a 2a 2f 0a 74  lity layer..*/.t
08b0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 75 6e  ypedef struct un
08c0: 69 78 46 69 6c 65 20 75 6e 69 78 46 69 6c 65 3b  ixFile unixFile;
08d0: 0a 73 74 72 75 63 74 20 75 6e 69 78 46 69 6c 65  .struct unixFile
08e0: 20 7b 0a 20 20 49 6f 4d 65 74 68 6f 64 20 63 6f   {.  IoMethod co
08f0: 6e 73 74 20 2a 70 4d 65 74 68 6f 64 3b 20 20 2f  nst *pMethod;  /
0900: 2a 20 41 6c 77 61 79 73 20 74 68 65 20 66 69 72  * Always the fir
0910: 73 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 73 74  st entry */.  st
0920: 72 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f  ruct openCnt *pO
0930: 70 65 6e 3b 20 20 20 20 2f 2a 20 49 6e 66 6f 20  pen;    /* Info 
0940: 61 62 6f 75 74 20 61 6c 6c 20 6f 70 65 6e 20 66  about all open f
0950: 64 27 73 20 6f 6e 20 74 68 69 73 20 69 6e 6f 64  d's on this inod
0960: 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 6c 6f  e */.  struct lo
0970: 63 6b 49 6e 66 6f 20 2a 70 4c 6f 63 6b 3b 20 20  ckInfo *pLock;  
0980: 20 2f 2a 20 49 6e 66 6f 20 61 62 6f 75 74 20 6c   /* Info about l
0990: 6f 63 6b 73 20 6f 6e 20 74 68 69 73 20 69 6e 6f  ocks on this ino
09a0: 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68 3b 20 20  de */.  int h;  
09b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
09c0: 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 64 65    /* The file de
09d0: 73 63 72 69 70 74 6f 72 20 2a 2f 0a 20 20 75 6e  scriptor */.  un
09e0: 73 69 67 6e 65 64 20 63 68 61 72 20 6c 6f 63 6b  signed char lock
09f0: 74 79 70 65 3b 20 20 20 2f 2a 20 54 68 65 20 74  type;   /* The t
0a00: 79 70 65 20 6f 66 20 6c 6f 63 6b 20 68 65 6c 64  ype of lock held
0a10: 20 6f 6e 20 74 68 69 73 20 66 64 20 2a 2f 0a 20   on this fd */. 
0a20: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 69   unsigned char i
0a30: 73 4f 70 65 6e 3b 20 20 20 20 20 2f 2a 20 54 72  sOpen;     /* Tr
0a40: 75 65 20 69 66 20 6e 65 65 64 73 20 74 6f 20 62  ue if needs to b
0a50: 65 20 63 6c 6f 73 65 64 20 2a 2f 0a 20 20 75 6e  e closed */.  un
0a60: 73 69 67 6e 65 64 20 63 68 61 72 20 66 75 6c 6c  signed char full
0a70: 53 79 6e 63 3b 20 20 20 2f 2a 20 55 73 65 20 46  Sync;   /* Use F
0a80: 5f 46 55 4c 4c 53 59 4e 43 20 69 66 20 61 76 61  _FULLSYNC if ava
0a90: 69 6c 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20  ilable */.  int 
0aa0: 64 69 72 66 64 3b 20 20 20 20 20 20 20 20 20 20  dirfd;          
0ab0: 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65        /* File de
0ac0: 73 63 72 69 70 74 6f 72 20 66 6f 72 20 74 68 65  scriptor for the
0ad0: 20 64 69 72 65 63 74 6f 72 79 20 2a 2f 0a 23 69   directory */.#i
0ae0: 66 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58  fdef SQLITE_UNIX
0af0: 5f 54 48 52 45 41 44 53 0a 20 20 70 74 68 72 65  _THREADS.  pthre
0b00: 61 64 5f 74 20 74 69 64 3b 20 20 20 20 20 20 20  ad_t tid;       
0b10: 20 20 20 20 20 2f 2a 20 54 68 65 20 74 68 72 65       /* The thre
0b20: 61 64 20 61 75 74 68 6f 72 69 7a 65 64 20 74 6f  ad authorized to
0b30: 20 75 73 65 20 74 68 69 73 20 4f 73 46 69 6c 65   use this OsFile
0b40: 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f   */.#endif.};../
0b50: 2a 0a 2a 2a 20 50 72 6f 76 69 64 65 20 74 68 65  *.** Provide the
0b60: 20 61 62 69 6c 69 74 79 20 74 6f 20 6f 76 65 72   ability to over
0b70: 72 69 64 65 20 73 6f 6d 65 20 4f 53 2d 6c 61 79  ride some OS-lay
0b80: 65 72 20 66 75 6e 63 74 69 6f 6e 73 20 64 75 72  er functions dur
0b90: 69 6e 67 0a 2a 2a 20 74 65 73 74 69 6e 67 2e 20  ing.** testing. 
0ba0: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 74 6f   This is used to
0bb0: 20 73 69 6d 75 6c 61 74 65 20 4f 53 20 63 72 61   simulate OS cra
0bc0: 73 68 65 73 20 74 6f 20 76 65 72 69 66 79 20 74  shes to verify t
0bd0: 68 61 74 20 0a 2a 2a 20 63 6f 6d 6d 69 74 73 20  hat .** commits 
0be0: 61 72 65 20 61 74 6f 6d 69 63 20 65 76 65 6e 20  are atomic even 
0bf0: 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20  in the event of 
0c00: 61 6e 20 4f 53 20 63 72 61 73 68 2e 0a 2a 2f 0a  an OS crash..*/.
0c10: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43 52  #ifdef SQLITE_CR
0c20: 41 53 48 5f 54 45 53 54 0a 20 20 65 78 74 65 72  ASH_TEST.  exter
0c30: 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 43 72 61  n int sqlite3Cra
0c40: 73 68 54 65 73 74 45 6e 61 62 6c 65 3b 0a 20 20  shTestEnable;.  
0c50: 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74  extern int sqlit
0c60: 65 33 43 72 61 73 68 4f 70 65 6e 52 65 61 64 57  e3CrashOpenReadW
0c70: 72 69 74 65 28 63 6f 6e 73 74 20 63 68 61 72 2a  rite(const char*
0c80: 2c 20 4f 73 46 69 6c 65 2a 2a 2c 20 69 6e 74 2a  , OsFile**, int*
0c90: 29 3b 0a 20 20 65 78 74 65 72 6e 20 69 6e 74 20  );.  extern int 
0ca0: 73 71 6c 69 74 65 33 43 72 61 73 68 4f 70 65 6e  sqlite3CrashOpen
0cb0: 45 78 63 6c 75 73 69 76 65 28 63 6f 6e 73 74 20  Exclusive(const 
0cc0: 63 68 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2a 2c  char*, OsFile**,
0cd0: 20 69 6e 74 29 3b 0a 20 20 65 78 74 65 72 6e 20   int);.  extern 
0ce0: 69 6e 74 20 73 71 6c 69 74 65 33 43 72 61 73 68  int sqlite3Crash
0cf0: 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 28 63 6f 6e  OpenReadOnly(con
0d00: 73 74 20 63 68 61 72 2a 2c 20 4f 73 46 69 6c 65  st char*, OsFile
0d10: 2a 2a 2c 20 69 6e 74 29 3b 0a 23 20 64 65 66 69  **, int);.# defi
0d20: 6e 65 20 43 52 41 53 48 5f 54 45 53 54 5f 4f 56  ne CRASH_TEST_OV
0d30: 45 52 52 49 44 45 28 58 2c 41 2c 42 2c 43 29 20  ERRIDE(X,A,B,C) 
0d40: 5c 0a 20 20 20 20 69 66 28 73 71 6c 69 74 65 33  \.    if(sqlite3
0d50: 43 72 61 73 68 54 65 73 74 45 6e 61 62 6c 65 29  CrashTestEnable)
0d60: 7b 20 72 65 74 75 72 6e 20 58 28 41 2c 42 2c 43  { return X(A,B,C
0d70: 29 3b 20 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66  ); }.#else.# def
0d80: 69 6e 65 20 43 52 41 53 48 5f 54 45 53 54 5f 4f  ine CRASH_TEST_O
0d90: 56 45 52 52 49 44 45 28 58 2c 41 2c 42 2c 43 29  VERRIDE(X,A,B,C)
0da0: 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 65    /* no-op */.#e
0db0: 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63  ndif.../*.** Inc
0dc0: 6c 75 64 65 20 63 6f 64 65 20 74 68 61 74 20 69  lude code that i
0dd0: 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20  s common to all 
0de0: 6f 73 5f 2a 2e 63 20 66 69 6c 65 73 0a 2a 2f 0a  os_*.c files.*/.
0df0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 5f 63 6f 6d  #include "os_com
0e00: 6d 6f 6e 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 44 6f  mon.h"../*.** Do
0e10: 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 61 6e 79   not include any
0e20: 20 6f 66 20 74 68 65 20 46 69 6c 65 20 49 2f 4f   of the File I/O
0e30: 20 69 6e 74 65 72 66 61 63 65 20 70 72 6f 63 65   interface proce
0e40: 64 75 72 65 73 20 69 66 20 74 68 65 0a 2a 2a 20  dures if the.** 
0e50: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b  SQLITE_OMIT_DISK
0e60: 49 4f 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  IO macro is defi
0e70: 6e 65 64 20 28 69 6e 64 69 63 61 74 69 6e 67 20  ned (indicating 
0e80: 74 68 61 74 20 74 68 65 72 65 20 64 61 74 61 62  that there datab
0e90: 61 73 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 20 69  ase.** will be i
0ea0: 6e 2d 6d 65 6d 6f 72 79 20 6f 6e 6c 79 29 0a 2a  n-memory only).*
0eb0: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  /.#ifndef SQLITE
0ec0: 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 0a 0a 2f  _OMIT_DISKIO.../
0ed0: 2a 0a 2a 2a 20 44 65 66 69 6e 65 20 76 61 72 69  *.** Define vari
0ee0: 6f 75 73 20 6d 61 63 72 6f 73 20 74 68 61 74 20  ous macros that 
0ef0: 61 72 65 20 6d 69 73 73 69 6e 67 20 66 72 6f 6d  are missing from
0f00: 20 73 6f 6d 65 20 73 79 73 74 65 6d 73 2e 0a 2a   some systems..*
0f10: 2f 0a 23 69 66 6e 64 65 66 20 4f 5f 4c 41 52 47  /.#ifndef O_LARG
0f20: 45 46 49 4c 45 0a 23 20 64 65 66 69 6e 65 20 4f  EFILE.# define O
0f30: 5f 4c 41 52 47 45 46 49 4c 45 20 30 0a 23 65 6e  _LARGEFILE 0.#en
0f40: 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54  dif.#ifdef SQLIT
0f50: 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 0a 23 20  E_DISABLE_LFS.# 
0f60: 75 6e 64 65 66 20 4f 5f 4c 41 52 47 45 46 49 4c  undef O_LARGEFIL
0f70: 45 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4c 41 52  E.# define O_LAR
0f80: 47 45 46 49 4c 45 20 30 0a 23 65 6e 64 69 66 0a  GEFILE 0.#endif.
0f90: 23 69 66 6e 64 65 66 20 4f 5f 4e 4f 46 4f 4c 4c  #ifndef O_NOFOLL
0fa0: 4f 57 0a 23 20 64 65 66 69 6e 65 20 4f 5f 4e 4f  OW.# define O_NO
0fb0: 46 4f 4c 4c 4f 57 20 30 0a 23 65 6e 64 69 66 0a  FOLLOW 0.#endif.
0fc0: 23 69 66 6e 64 65 66 20 4f 5f 42 49 4e 41 52 59  #ifndef O_BINARY
0fd0: 0a 23 20 64 65 66 69 6e 65 20 4f 5f 42 49 4e 41  .# define O_BINA
0fe0: 52 59 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  RY 0.#endif../*.
0ff0: 2a 2a 20 54 68 65 20 44 4a 47 50 50 20 63 6f 6d  ** The DJGPP com
1000: 70 69 6c 65 72 20 65 6e 76 69 72 6f 6e 6d 65 6e  piler environmen
1010: 74 20 6c 6f 6f 6b 73 20 6d 6f 73 74 6c 79 20 6c  t looks mostly l
1020: 69 6b 65 20 55 6e 69 78 2c 20 62 75 74 20 69 74  ike Unix, but it
1030: 0a 2a 2a 20 6c 61 63 6b 73 20 74 68 65 20 66 63  .** lacks the fc
1040: 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63 61 6c  ntl() system cal
1050: 6c 2e 20 20 53 6f 20 72 65 64 65 66 69 6e 65 20  l.  So redefine 
1060: 66 63 6e 74 6c 28 29 20 74 6f 20 62 65 20 73 6f  fcntl() to be so
1070: 6d 65 74 68 69 6e 67 0a 2a 2a 20 74 68 61 74 20  mething.** that 
1080: 61 6c 77 61 79 73 20 73 75 63 63 65 65 64 73 2e  always succeeds.
1090: 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61    This means tha
10a0: 74 20 6c 6f 63 6b 69 6e 67 20 64 6f 65 73 20 6e  t locking does n
10b0: 6f 74 20 6f 63 63 75 72 20 75 6e 64 65 72 0a 2a  ot occur under.*
10c0: 2a 20 44 4a 47 50 50 2e 20 20 42 75 74 20 69 74  * DJGPP.  But it
10d0: 27 73 20 44 4f 53 20 2d 20 77 68 61 74 20 64 69  's DOS - what di
10e0: 64 20 79 6f 75 20 65 78 70 65 63 74 3f 0a 2a 2f  d you expect?.*/
10f0: 0a 23 69 66 64 65 66 20 5f 5f 44 4a 47 50 50 5f  .#ifdef __DJGPP_
1100: 5f 0a 23 20 64 65 66 69 6e 65 20 66 63 6e 74 6c  _.# define fcntl
1110: 28 41 2c 42 2c 43 29 20 30 0a 23 65 6e 64 69 66  (A,B,C) 0.#endif
1120: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 74 68 72 65  ../*.** The thre
1130: 61 64 69 64 20 6d 61 63 72 6f 20 72 65 73 6f 6c  adid macro resol
1140: 76 65 73 20 74 6f 20 74 68 65 20 74 68 72 65 61  ves to the threa
1150: 64 2d 69 64 20 6f 72 20 74 6f 20 30 2e 20 20 55  d-id or to 0.  U
1160: 73 65 64 20 66 6f 72 0a 2a 2a 20 74 65 73 74 69  sed for.** testi
1170: 6e 67 20 61 6e 64 20 64 65 62 75 67 67 69 6e 67  ng and debugging
1180: 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 69 66 64 65 66   only..*/.#ifdef
1190: 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52   SQLITE_UNIX_THR
11a0: 45 41 44 53 0a 23 64 65 66 69 6e 65 20 74 68 72  EADS.#define thr
11b0: 65 61 64 69 64 20 70 74 68 72 65 61 64 5f 73 65  eadid pthread_se
11c0: 6c 66 28 29 0a 23 65 6c 73 65 0a 23 64 65 66 69  lf().#else.#defi
11d0: 6e 65 20 74 68 72 65 61 64 69 64 20 30 0a 23 65  ne threadid 0.#e
11e0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20  ndif../*.** Set 
11f0: 6f 72 20 63 68 65 63 6b 20 74 68 65 20 4f 73 46  or check the OsF
1200: 69 6c 65 2e 74 69 64 20 66 69 65 6c 64 2e 20 20  ile.tid field.  
1210: 54 68 69 73 20 66 69 65 6c 64 20 69 73 20 73 65  This field is se
1220: 74 20 77 68 65 6e 20 61 6e 20 4f 73 46 69 6c 65  t when an OsFile
1230: 0a 2a 2a 20 69 73 20 66 69 72 73 74 20 6f 70 65  .** is first ope
1240: 6e 65 64 2e 20 20 41 6c 6c 20 73 75 62 73 65 71  ned.  All subseq
1250: 75 65 6e 74 20 75 73 65 73 20 6f 66 20 74 68 65  uent uses of the
1260: 20 4f 73 46 69 6c 65 20 76 65 72 69 66 79 20 74   OsFile verify t
1270: 68 61 74 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20  hat the.** same 
1280: 74 68 72 65 61 64 20 69 73 20 6f 70 65 72 61 74  thread is operat
1290: 69 6e 67 20 6f 6e 20 74 68 65 20 4f 73 46 69 6c  ing on the OsFil
12a0: 65 2e 20 20 53 6f 6d 65 20 6f 70 65 72 61 74 69  e.  Some operati
12b0: 6e 67 20 73 79 73 74 65 6d 73 20 64 6f 0a 2a 2a  ng systems do.**
12c0: 20 6e 6f 74 20 61 6c 6c 6f 77 20 6c 6f 63 6b 73   not allow locks
12d0: 20 74 6f 20 62 65 20 6f 76 65 72 72 69 64 64 65   to be overridde
12e0: 6e 20 62 79 20 6f 74 68 65 72 20 74 68 72 65 61  n by other threa
12f0: 64 73 20 61 6e 64 20 74 68 61 74 20 72 65 73 74  ds and that rest
1300: 72 69 63 74 69 6f 6e 0a 2a 2a 20 6d 65 61 6e 73  riction.** means
1310: 20 74 68 61 74 20 73 71 6c 69 74 65 33 2a 20 64   that sqlite3* d
1320: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 73 20  atabase handles 
1330: 63 61 6e 6e 6f 74 20 62 65 20 6d 6f 76 65 64 20  cannot be moved 
1340: 66 72 6f 6d 20 6f 6e 65 20 74 68 72 65 61 64 0a  from one thread.
1350: 2a 2a 20 74 6f 20 61 6e 6f 74 68 65 72 2e 20 20  ** to another.  
1360: 54 68 69 73 20 6c 6f 67 69 63 20 6d 61 6b 65 73  This logic makes
1370: 20 73 75 72 65 20 61 20 75 73 65 72 20 64 6f 65   sure a user doe
1380: 73 20 6e 6f 74 20 74 72 79 20 74 6f 20 64 6f 20  s not try to do 
1390: 74 68 61 74 0a 2a 2a 20 62 79 20 6d 69 73 74 61  that.** by mista
13a0: 6b 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e  ke..*/.#if defin
13b0: 65 64 28 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54  ed(SQLITE_UNIX_T
13c0: 48 52 45 41 44 53 29 0a 23 20 64 65 66 69 6e 65  HREADS).# define
13d0: 20 53 45 54 5f 54 48 52 45 41 44 49 44 28 58 29   SET_THREADID(X)
13e0: 20 20 20 28 58 29 2d 3e 74 69 64 20 3d 20 70 74     (X)->tid = pt
13f0: 68 72 65 61 64 5f 73 65 6c 66 28 29 0a 23 20 64  hread_self().# d
1400: 65 66 69 6e 65 20 43 48 45 43 4b 5f 54 48 52 45  efine CHECK_THRE
1410: 41 44 49 44 28 58 29 20 28 74 68 72 65 61 64 73  ADID(X) (threads
1420: 4f 76 65 72 72 69 64 65 45 61 63 68 4f 74 68 65  OverrideEachOthe
1430: 72 73 4c 6f 63 6b 73 3d 3d 30 20 26 26 20 5c 0a  rsLocks==0 && \.
1440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1450: 20 20 20 20 20 20 20 20 20 20 20 20 21 70 74 68              !pth
1460: 72 65 61 64 5f 65 71 75 61 6c 28 28 58 29 2d 3e  read_equal((X)->
1470: 74 69 64 2c 20 70 74 68 72 65 61 64 5f 73 65 6c  tid, pthread_sel
1480: 66 28 29 29 29 0a 23 65 6c 73 65 0a 23 20 64 65  f())).#else.# de
1490: 66 69 6e 65 20 53 45 54 5f 54 48 52 45 41 44 49  fine SET_THREADI
14a0: 44 28 58 29 0a 23 20 64 65 66 69 6e 65 20 43 48  D(X).# define CH
14b0: 45 43 4b 5f 54 48 52 45 41 44 49 44 28 58 29 20  ECK_THREADID(X) 
14c0: 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  0.#endif../*.** 
14d0: 48 65 72 65 20 69 73 20 74 68 65 20 64 69 72 74  Here is the dirt
14e0: 20 6f 6e 20 50 4f 53 49 58 20 61 64 76 69 73 6f   on POSIX adviso
14f0: 72 79 20 6c 6f 63 6b 73 3a 20 20 41 4e 53 49 20  ry locks:  ANSI 
1500: 53 54 44 20 31 30 30 33 2e 31 20 28 31 39 39 36  STD 1003.1 (1996
1510: 29 0a 2a 2a 20 73 65 63 74 69 6f 6e 20 36 2e 35  ).** section 6.5
1520: 2e 32 2e 32 20 6c 69 6e 65 73 20 34 38 33 20 74  .2.2 lines 483 t
1530: 68 72 6f 75 67 68 20 34 39 30 20 73 70 65 63 69  hrough 490 speci
1540: 66 79 20 74 68 61 74 20 77 68 65 6e 20 61 20 70  fy that when a p
1550: 72 6f 63 65 73 73 0a 2a 2a 20 73 65 74 73 20 6f  rocess.** sets o
1560: 72 20 63 6c 65 61 72 73 20 61 20 6c 6f 63 6b 2c  r clears a lock,
1570: 20 74 68 61 74 20 6f 70 65 72 61 74 69 6f 6e 20   that operation 
1580: 6f 76 65 72 72 69 64 65 73 20 61 6e 79 20 70 72  overrides any pr
1590: 69 6f 72 20 6c 6f 63 6b 73 20 73 65 74 0a 2a 2a  ior locks set.**
15a0: 20 62 79 20 74 68 65 20 73 61 6d 65 20 70 72 6f   by the same pro
15b0: 63 65 73 73 2e 20 20 49 74 20 64 6f 65 73 20 6e  cess.  It does n
15c0: 6f 74 20 65 78 70 6c 69 63 69 74 6c 79 20 73 61  ot explicitly sa
15d0: 79 20 73 6f 2c 20 62 75 74 20 74 68 69 73 20 69  y so, but this i
15e0: 6d 70 6c 69 65 73 0a 2a 2a 20 74 68 61 74 20 69  mplies.** that i
15f0: 74 20 6f 76 65 72 72 69 64 65 73 20 6c 6f 63 6b  t overrides lock
1600: 73 20 73 65 74 20 62 79 20 74 68 65 20 73 61 6d  s set by the sam
1610: 65 20 70 72 6f 63 65 73 73 20 75 73 69 6e 67 20  e process using 
1620: 61 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a 20 66  a different.** f
1630: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 20  ile descriptor. 
1640: 20 43 6f 6e 73 69 64 65 72 20 74 68 69 73 20 74   Consider this t
1650: 65 73 74 20 63 61 73 65 3a 0a 2a 2a 0a 2a 2a 20  est case:.**.** 
1660: 20 20 20 20 20 20 69 6e 74 20 66 64 31 20 3d 20        int fd1 = 
1670: 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 31 22 2c 20  open("./file1", 
1680: 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54 2c 20  O_RDWR|O_CREAT, 
1690: 30 36 34 34 29 3b 0a 2a 2a 20 20 20 20 20 20 20  0644);.**       
16a0: 69 6e 74 20 66 64 32 20 3d 20 6f 70 65 6e 28 22  int fd2 = open("
16b0: 2e 2f 66 69 6c 65 32 22 2c 20 4f 5f 52 44 57 52  ./file2", O_RDWR
16c0: 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b  |O_CREAT, 0644);
16d0: 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20 2e  .**.** Suppose .
16e0: 2f 66 69 6c 65 31 20 61 6e 64 20 2e 2f 66 69 6c  /file1 and ./fil
16f0: 65 32 20 61 72 65 20 72 65 61 6c 6c 79 20 74 68  e2 are really th
1700: 65 20 73 61 6d 65 20 66 69 6c 65 20 28 62 65 63  e same file (bec
1710: 61 75 73 65 0a 2a 2a 20 6f 6e 65 20 69 73 20 61  ause.** one is a
1720: 20 68 61 72 64 20 6f 72 20 73 79 6d 62 6f 6c 69   hard or symboli
1730: 63 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 6f 74  c link to the ot
1740: 68 65 72 29 20 74 68 65 6e 20 69 66 20 79 6f 75  her) then if you
1750: 20 73 65 74 0a 2a 2a 20 61 6e 20 65 78 63 6c 75   set.** an exclu
1760: 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 66 64 31  sive lock on fd1
1770: 2c 20 74 68 65 6e 20 74 72 79 20 74 6f 20 67 65  , then try to ge
1780: 74 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c  t an exclusive l
1790: 6f 63 6b 0a 2a 2a 20 6f 6e 20 66 64 32 2c 20 69  ock.** on fd2, i
17a0: 74 20 77 6f 72 6b 73 2e 20 20 49 20 77 6f 75 6c  t works.  I woul
17b0: 64 20 68 61 76 65 20 65 78 70 65 63 74 65 64 20  d have expected 
17c0: 74 68 65 20 73 65 63 6f 6e 64 20 6c 6f 63 6b 20  the second lock 
17d0: 74 6f 0a 2a 2a 20 66 61 69 6c 20 73 69 6e 63 65  to.** fail since
17e0: 20 74 68 65 72 65 20 77 61 73 20 61 6c 72 65 61   there was alrea
17f0: 64 79 20 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65  dy a lock on the
1800: 20 66 69 6c 65 20 64 75 65 20 74 6f 20 66 64 31   file due to fd1
1810: 2e 0a 2a 2a 20 42 75 74 20 6e 6f 74 20 73 6f 2e  ..** But not so.
1820: 20 20 53 69 6e 63 65 20 62 6f 74 68 20 6c 6f 63    Since both loc
1830: 6b 73 20 63 61 6d 65 20 66 72 6f 6d 20 74 68 65  ks came from the
1840: 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2c 20 74   same process, t
1850: 68 65 0a 2a 2a 20 73 65 63 6f 6e 64 20 6f 76 65  he.** second ove
1860: 72 72 69 64 65 73 20 74 68 65 20 66 69 72 73 74  rrides the first
1870: 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 20 74 68  , even though th
1880: 65 79 20 77 65 72 65 20 6f 6e 20 64 69 66 66 65  ey were on diffe
1890: 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20 64 65 73  rent.** file des
18a0: 63 72 69 70 74 6f 72 73 20 6f 70 65 6e 65 64 20  criptors opened 
18b0: 6f 6e 20 64 69 66 66 65 72 65 6e 74 20 66 69 6c  on different fil
18c0: 65 20 6e 61 6d 65 73 2e 0a 2a 2a 0a 2a 2a 20 42  e names..**.** B
18d0: 75 6d 6d 65 72 2e 20 20 49 66 20 79 6f 75 20 61  ummer.  If you a
18e0: 73 6b 20 6d 65 2c 20 74 68 69 73 20 69 73 20 62  sk me, this is b
18f0: 72 6f 6b 65 6e 2e 20 20 42 61 64 6c 79 20 62 72  roken.  Badly br
1900: 6f 6b 65 6e 2e 20 20 49 74 20 6d 65 61 6e 73 0a  oken.  It means.
1910: 2a 2a 20 74 68 61 74 20 77 65 20 63 61 6e 6e 6f  ** that we canno
1920: 74 20 75 73 65 20 50 4f 53 49 58 20 6c 6f 63 6b  t use POSIX lock
1930: 73 20 74 6f 20 73 79 6e 63 68 72 6f 6e 69 7a 65  s to synchronize
1940: 20 66 69 6c 65 20 61 63 63 65 73 73 20 61 6d 6f   file access amo
1950: 6e 67 0a 2a 2a 20 63 6f 6d 70 65 74 69 6e 67 20  ng.** competing 
1960: 74 68 72 65 61 64 73 20 6f 66 20 74 68 65 20 73  threads of the s
1970: 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 20 50 4f  ame process.  PO
1980: 53 49 58 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 77  SIX locks will w
1990: 6f 72 6b 20 66 69 6e 65 0a 2a 2a 20 74 6f 20 73  ork fine.** to s
19a0: 79 6e 63 68 72 6f 6e 69 7a 65 20 61 63 63 65 73  ynchronize acces
19b0: 73 20 66 6f 72 20 74 68 72 65 61 64 73 20 69 6e  s for threads in
19c0: 20 73 65 70 61 72 61 74 65 20 70 72 6f 63 65 73   separate proces
19d0: 73 65 73 2c 20 62 75 74 20 6e 6f 74 0a 2a 2a 20  ses, but not.** 
19e0: 74 68 72 65 61 64 73 20 77 69 74 68 69 6e 20 74  threads within t
19f0: 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2e  he same process.
1a00: 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b 20 61  .**.** To work a
1a10: 72 6f 75 6e 64 20 74 68 65 20 70 72 6f 62 6c 65  round the proble
1a20: 6d 2c 20 53 51 4c 69 74 65 20 68 61 73 20 74 6f  m, SQLite has to
1a30: 20 6d 61 6e 61 67 65 20 66 69 6c 65 20 6c 6f 63   manage file loc
1a40: 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a 2a  ks internally.**
1a50: 20 6f 6e 20 69 74 73 20 6f 77 6e 2e 20 20 57 68   on its own.  Wh
1a60: 65 6e 65 76 65 72 20 61 20 6e 65 77 20 64 61 74  enever a new dat
1a70: 61 62 61 73 65 20 69 73 20 6f 70 65 6e 65 64 2c  abase is opened,
1a80: 20 77 65 20 68 61 76 65 20 74 6f 20 66 69 6e 64   we have to find
1a90: 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 66 69 63   the.** specific
1aa0: 20 69 6e 6f 64 65 20 6f 66 20 74 68 65 20 64 61   inode of the da
1ab0: 74 61 62 61 73 65 20 66 69 6c 65 20 28 74 68 65  tabase file (the
1ac0: 20 69 6e 6f 64 65 20 69 73 20 64 65 74 65 72 6d   inode is determ
1ad0: 69 6e 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 73  ined by the.** s
1ae0: 74 5f 64 65 76 20 61 6e 64 20 73 74 5f 69 6e 6f  t_dev and st_ino
1af0: 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 73   fields of the s
1b00: 74 61 74 20 73 74 72 75 63 74 75 72 65 20 74 68  tat structure th
1b10: 61 74 20 66 73 74 61 74 28 29 20 66 69 6c 6c 73  at fstat() fills
1b20: 20 69 6e 29 0a 2a 2a 20 61 6e 64 20 63 68 65 63   in).** and chec
1b30: 6b 20 66 6f 72 20 6c 6f 63 6b 73 20 61 6c 72 65  k for locks alre
1b40: 61 64 79 20 65 78 69 73 74 69 6e 67 20 6f 6e 20  ady existing on 
1b50: 74 68 61 74 20 69 6e 6f 64 65 2e 20 20 57 68 65  that inode.  Whe
1b60: 6e 20 6c 6f 63 6b 73 20 61 72 65 0a 2a 2a 20 63  n locks are.** c
1b70: 72 65 61 74 65 64 20 6f 72 20 72 65 6d 6f 76 65  reated or remove
1b80: 64 2c 20 77 65 20 68 61 76 65 20 74 6f 20 6c 6f  d, we have to lo
1b90: 6f 6b 20 61 74 20 6f 75 72 20 6f 77 6e 20 69 6e  ok at our own in
1ba0: 74 65 72 6e 61 6c 20 72 65 63 6f 72 64 20 6f 66  ternal record of
1bb0: 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 73 20 74 6f   the.** locks to
1bc0: 20 73 65 65 20 69 66 20 61 6e 6f 74 68 65 72 20   see if another 
1bd0: 74 68 72 65 61 64 20 68 61 73 20 70 72 65 76 69  thread has previ
1be0: 6f 75 73 6c 79 20 73 65 74 20 61 20 6c 6f 63 6b  ously set a lock
1bf0: 20 6f 6e 20 74 68 61 74 20 73 61 6d 65 0a 2a 2a   on that same.**
1c00: 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68   inode..**.** Th
1c10: 65 20 4f 73 46 69 6c 65 20 73 74 72 75 63 74 75  e OsFile structu
1c20: 72 65 20 66 6f 72 20 50 4f 53 49 58 20 69 73 20  re for POSIX is 
1c30: 6e 6f 20 6c 6f 6e 67 65 72 20 6a 75 73 74 20 61  no longer just a
1c40: 6e 20 69 6e 74 65 67 65 72 20 66 69 6c 65 0a 2a  n integer file.*
1c50: 2a 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 49  * descriptor.  I
1c60: 74 20 69 73 20 6e 6f 77 20 61 20 73 74 72 75 63  t is now a struc
1c70: 74 75 72 65 20 74 68 61 74 20 68 6f 6c 64 73 20  ture that holds 
1c80: 74 68 65 20 69 6e 74 65 67 65 72 20 66 69 6c 65  the integer file
1c90: 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 61  .** descriptor a
1ca0: 6e 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  nd a pointer to 
1cb0: 61 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74  a structure that
1cc0: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 69   describes the i
1cd0: 6e 74 65 72 6e 61 6c 0a 2a 2a 20 6c 6f 63 6b 73  nternal.** locks
1ce0: 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f   on the correspo
1cf0: 6e 64 69 6e 67 20 69 6e 6f 64 65 2e 20 20 54 68  nding inode.  Th
1d00: 65 72 65 20 69 73 20 6f 6e 65 20 6c 6f 63 6b 69  ere is one locki
1d10: 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20  ng structure.** 
1d20: 70 65 72 20 69 6e 6f 64 65 2c 20 73 6f 20 69 66  per inode, so if
1d30: 20 74 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20   the same inode 
1d40: 69 73 20 6f 70 65 6e 65 64 20 74 77 69 63 65 2c  is opened twice,
1d50: 20 62 6f 74 68 20 4f 73 46 69 6c 65 20 73 74 72   both OsFile str
1d60: 75 63 74 75 72 65 73 0a 2a 2a 20 70 6f 69 6e 74  uctures.** point
1d70: 20 74 6f 20 74 68 65 20 73 61 6d 65 20 6c 6f 63   to the same loc
1d80: 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 20  king structure. 
1d90: 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72   The locking str
1da0: 75 63 74 75 72 65 20 6b 65 65 70 73 0a 2a 2a 20  ucture keeps.** 
1db0: 61 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e  a reference coun
1dc0: 74 20 28 73 6f 20 77 65 20 77 69 6c 6c 20 6b 6e  t (so we will kn
1dd0: 6f 77 20 77 68 65 6e 20 74 6f 20 64 65 6c 65 74  ow when to delet
1de0: 65 20 69 74 29 20 61 6e 64 20 61 20 22 63 6e 74  e it) and a "cnt
1df0: 22 0a 2a 2a 20 66 69 65 6c 64 20 74 68 61 74 20  ".** field that 
1e00: 74 65 6c 6c 73 20 75 73 20 69 74 73 20 69 6e 74  tells us its int
1e10: 65 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 61 74 75  ernal lock statu
1e20: 73 2e 20 20 63 6e 74 3d 3d 30 20 6d 65 61 6e 73  s.  cnt==0 means
1e30: 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20 69 73 20   the.** file is 
1e40: 75 6e 6c 6f 63 6b 65 64 2e 20 20 63 6e 74 3d 3d  unlocked.  cnt==
1e50: 2d 31 20 6d 65 61 6e 73 20 74 68 65 20 66 69 6c  -1 means the fil
1e60: 65 20 68 61 73 20 61 6e 20 65 78 63 6c 75 73 69  e has an exclusi
1e70: 76 65 20 6c 6f 63 6b 2e 0a 2a 2a 20 63 6e 74 3e  ve lock..** cnt>
1e80: 30 20 6d 65 61 6e 73 20 74 68 65 72 65 20 61 72  0 means there ar
1e90: 65 20 63 6e 74 20 73 68 61 72 65 64 20 6c 6f 63  e cnt shared loc
1ea0: 6b 73 20 6f 6e 20 74 68 65 20 66 69 6c 65 2e 0a  ks on the file..
1eb0: 2a 2a 0a 2a 2a 20 41 6e 79 20 61 74 74 65 6d 70  **.** Any attemp
1ec0: 74 20 74 6f 20 6c 6f 63 6b 20 6f 72 20 75 6e 6c  t to lock or unl
1ed0: 6f 63 6b 20 61 20 66 69 6c 65 20 66 69 72 73 74  ock a file first
1ee0: 20 63 68 65 63 6b 73 20 74 68 65 20 6c 6f 63 6b   checks the lock
1ef0: 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 72 65  ing.** structure
1f00: 2e 20 20 54 68 65 20 66 63 6e 74 6c 28 29 20 73  .  The fcntl() s
1f10: 79 73 74 65 6d 20 63 61 6c 6c 20 69 73 20 6f 6e  ystem call is on
1f20: 6c 79 20 69 6e 76 6f 6b 65 64 20 74 6f 20 73 65  ly invoked to se
1f30: 74 20 61 20 0a 2a 2a 20 50 4f 53 49 58 20 6c 6f  t a .** POSIX lo
1f40: 63 6b 20 69 66 20 74 68 65 20 69 6e 74 65 72 6e  ck if the intern
1f50: 61 6c 20 6c 6f 63 6b 20 73 74 72 75 63 74 75 72  al lock structur
1f60: 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 62 65  e transitions be
1f70: 74 77 65 65 6e 0a 2a 2a 20 61 20 6c 6f 63 6b 65  tween.** a locke
1f80: 64 20 61 6e 64 20 61 6e 20 75 6e 6c 6f 63 6b 65  d and an unlocke
1f90: 64 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 32  d state..**.** 2
1fa0: 30 30 34 2d 4a 61 6e 2d 31 31 3a 0a 2a 2a 20 4d  004-Jan-11:.** M
1fb0: 6f 72 65 20 72 65 63 65 6e 74 20 64 69 73 63 6f  ore recent disco
1fc0: 76 65 72 69 65 73 20 61 62 6f 75 74 20 50 4f 53  veries about POS
1fd0: 49 58 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 6b  IX advisory lock
1fe0: 73 2e 20 20 28 54 68 65 20 6d 6f 72 65 0a 2a 2a  s.  (The more.**
1ff0: 20 49 20 64 69 73 63 6f 76 65 72 2c 20 74 68 65   I discover, the
2000: 20 6d 6f 72 65 20 49 20 72 65 61 6c 69 7a 65 20   more I realize 
2010: 74 68 65 20 61 20 50 4f 53 49 58 20 61 64 76 69  the a POSIX advi
2020: 73 6f 72 79 20 6c 6f 63 6b 73 20 61 72 65 0a 2a  sory locks are.*
2030: 2a 20 61 6e 20 61 62 6f 6d 69 6e 61 74 69 6f 6e  * an abomination
2040: 2e 29 0a 2a 2a 0a 2a 2a 20 49 66 20 79 6f 75 20  .).**.** If you 
2050: 63 6c 6f 73 65 20 61 20 66 69 6c 65 20 64 65 73  close a file des
2060: 63 72 69 70 74 6f 72 20 74 68 61 74 20 70 6f 69  criptor that poi
2070: 6e 74 73 20 74 6f 20 61 20 66 69 6c 65 20 74 68  nts to a file th
2080: 61 74 20 68 61 73 20 6c 6f 63 6b 73 2c 0a 2a 2a  at has locks,.**
2090: 20 61 6c 6c 20 6c 6f 63 6b 73 20 6f 6e 20 74 68   all locks on th
20a0: 61 74 20 66 69 6c 65 20 74 68 61 74 20 61 72 65  at file that are
20b0: 20 6f 77 6e 65 64 20 62 79 20 74 68 65 20 63 75   owned by the cu
20c0: 72 72 65 6e 74 20 70 72 6f 63 65 73 73 20 61 72  rrent process ar
20d0: 65 0a 2a 2a 20 72 65 6c 65 61 73 65 64 2e 20 20  e.** released.  
20e0: 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 74  To work around t
20f0: 68 69 73 20 70 72 6f 62 6c 65 6d 2c 20 65 61 63  his problem, eac
2100: 68 20 4f 73 46 69 6c 65 20 73 74 72 75 63 74 75  h OsFile structu
2110: 72 65 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20 61  re contains.** a
2120: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 6f   pointer to an o
2130: 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65  penCnt structure
2140: 2e 20 20 54 68 65 72 65 20 69 73 20 6f 6e 65 20  .  There is one 
2150: 6f 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72  openCnt structur
2160: 65 0a 2a 2a 20 70 65 72 20 6f 70 65 6e 20 69 6e  e.** per open in
2170: 6f 64 65 2c 20 77 68 69 63 68 20 6d 65 61 6e 73  ode, which means
2180: 20 74 68 61 74 20 6d 75 6c 74 69 70 6c 65 20 4f   that multiple O
2190: 73 46 69 6c 65 73 20 63 61 6e 20 70 6f 69 6e 74  sFiles can point
21a0: 20 74 6f 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20   to a single.** 
21b0: 6f 70 65 6e 43 6e 74 2e 20 20 57 68 65 6e 20 61  openCnt.  When a
21c0: 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64  n attempt is mad
21d0: 65 20 74 6f 20 63 6c 6f 73 65 20 61 6e 20 4f 73  e to close an Os
21e0: 46 69 6c 65 2c 20 69 66 20 74 68 65 72 65 20 61  File, if there a
21f0: 72 65 0a 2a 2a 20 6f 74 68 65 72 20 4f 73 46 69  re.** other OsFi
2200: 6c 65 73 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20  les open on the 
2210: 73 61 6d 65 20 69 6e 6f 64 65 20 74 68 61 74 20  same inode that 
2220: 61 72 65 20 68 6f 6c 64 69 6e 67 20 6c 6f 63 6b  are holding lock
2230: 73 2c 20 74 68 65 20 63 61 6c 6c 0a 2a 2a 20 74  s, the call.** t
2240: 6f 20 63 6c 6f 73 65 28 29 20 74 68 65 20 66 69  o close() the fi
2250: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 73  le descriptor is
2260: 20 64 65 66 65 72 72 65 64 20 75 6e 74 69 6c 20   deferred until 
2270: 61 6c 6c 20 6f 66 20 74 68 65 20 6c 6f 63 6b 73  all of the locks
2280: 20 63 6c 65 61 72 2e 0a 2a 2a 20 54 68 65 20 6f   clear..** The o
2290: 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65  penCnt structure
22a0: 20 6b 65 65 70 73 20 61 20 6c 69 73 74 20 6f 66   keeps a list of
22b0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
22c0: 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f 0a 2a  s that need to.*
22d0: 2a 20 62 65 20 63 6c 6f 73 65 64 20 61 6e 64 20  * be closed and 
22e0: 74 68 61 74 20 6c 69 73 74 20 69 73 20 77 61 6c  that list is wal
22f0: 6b 65 64 20 28 61 6e 64 20 63 6c 65 61 72 65 64  ked (and cleared
2300: 29 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20  ) when the last 
2310: 6c 6f 63 6b 0a 2a 2a 20 63 6c 65 61 72 73 2e 0a  lock.** clears..
2320: 2a 2a 0a 2a 2a 20 46 69 72 73 74 2c 20 75 6e 64  **.** First, und
2330: 65 72 20 4c 69 6e 75 78 20 74 68 72 65 61 64 73  er Linux threads
2340: 2c 20 62 65 63 61 75 73 65 20 65 61 63 68 20 74  , because each t
2350: 68 72 65 61 64 20 68 61 73 20 61 20 73 65 70 61  hread has a sepa
2360: 72 61 74 65 0a 2a 2a 20 70 72 6f 63 65 73 73 20  rate.** process 
2370: 49 44 2c 20 6c 6f 63 6b 20 6f 70 65 72 61 74 69  ID, lock operati
2380: 6f 6e 73 20 69 6e 20 6f 6e 65 20 74 68 72 65 61  ons in one threa
2390: 64 20 64 6f 20 6e 6f 74 20 6f 76 65 72 72 69 64  d do not overrid
23a0: 65 20 6c 6f 63 6b 73 0a 2a 2a 20 74 6f 20 74 68  e locks.** to th
23b0: 65 20 73 61 6d 65 20 66 69 6c 65 20 69 6e 20 6f  e same file in o
23c0: 74 68 65 72 20 74 68 72 65 61 64 73 2e 20 20 4c  ther threads.  L
23d0: 69 6e 75 78 20 74 68 72 65 61 64 73 20 62 65 68  inux threads beh
23e0: 61 76 65 20 6c 69 6b 65 0a 2a 2a 20 73 65 70 61  ave like.** sepa
23f0: 72 61 74 65 20 70 72 6f 63 65 73 73 65 73 20 69  rate processes i
2400: 6e 20 74 68 69 73 20 72 65 73 70 65 63 74 2e 20  n this respect. 
2410: 20 42 75 74 2c 20 69 66 20 79 6f 75 20 63 6c 6f   But, if you clo
2420: 73 65 20 61 20 66 69 6c 65 0a 2a 2a 20 64 65 73  se a file.** des
2430: 63 72 69 70 74 6f 72 20 69 6e 20 6c 69 6e 75 78  criptor in linux
2440: 20 74 68 72 65 61 64 73 2c 20 61 6c 6c 20 6c 6f   threads, all lo
2450: 63 6b 73 20 61 72 65 20 63 6c 65 61 72 65 64 2c  cks are cleared,
2460: 20 65 76 65 6e 20 6c 6f 63 6b 73 0a 2a 2a 20 6f   even locks.** o
2470: 6e 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20  n other threads 
2480: 61 6e 64 20 65 76 65 6e 20 74 68 6f 75 67 68 20  and even though 
2490: 74 68 65 20 6f 74 68 65 72 20 74 68 72 65 61 64  the other thread
24a0: 73 20 68 61 76 65 20 64 69 66 66 65 72 65 6e 74  s have different
24b0: 0a 2a 2a 20 70 72 6f 63 65 73 73 20 49 44 73 2e  .** process IDs.
24c0: 20 20 4c 69 6e 75 78 20 74 68 72 65 61 64 73 20    Linux threads 
24d0: 69 73 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20  is inconsistent 
24e0: 69 6e 20 74 68 69 73 20 72 65 73 70 65 63 74 2e  in this respect.
24f0: 0a 2a 2a 20 28 49 27 6d 20 62 65 67 69 6e 6e 69  .** (I'm beginni
2500: 6e 67 20 74 6f 20 74 68 69 6e 6b 20 74 68 61 74  ng to think that
2510: 20 6c 69 6e 75 78 20 74 68 72 65 61 64 73 20 69   linux threads i
2520: 73 20 61 6e 20 61 62 6f 6d 69 6e 61 74 69 6f 6e  s an abomination
2530: 20 74 6f 6f 2e 29 0a 2a 2a 20 54 68 65 20 63 6f   too.).** The co
2540: 6e 73 65 71 75 65 6e 63 65 20 6f 66 20 74 68 69  nsequence of thi
2550: 73 20 61 6c 6c 20 69 73 20 74 68 61 74 20 74 68  s all is that th
2560: 65 20 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72  e hash table for
2570: 20 74 68 65 20 6c 6f 63 6b 49 6e 66 6f 0a 2a 2a   the lockInfo.**
2580: 20 73 74 72 75 63 74 75 72 65 20 68 61 73 20 74   structure has t
2590: 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20 70 72  o include the pr
25a0: 6f 63 65 73 73 20 69 64 20 61 73 20 70 61 72 74  ocess id as part
25b0: 20 6f 66 20 69 74 73 20 6b 65 79 20 62 65 63 61   of its key beca
25c0: 75 73 65 0a 2a 2a 20 6c 6f 63 6b 73 20 69 6e 20  use.** locks in 
25d0: 64 69 66 66 65 72 65 6e 74 20 74 68 72 65 61 64  different thread
25e0: 73 20 61 72 65 20 74 72 65 61 74 65 64 20 61 73  s are treated as
25f0: 20 64 69 73 74 69 6e 63 74 2e 20 20 42 75 74 20   distinct.  But 
2600: 74 68 65 20 0a 2a 2a 20 6f 70 65 6e 43 6e 74 20  the .** openCnt 
2610: 73 74 72 75 63 74 75 72 65 20 73 68 6f 75 6c 64  structure should
2620: 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 74 68 65   not include the
2630: 20 70 72 6f 63 65 73 73 20 69 64 20 69 6e 20 69   process id in i
2640: 74 73 0a 2a 2a 20 6b 65 79 20 62 65 63 61 75 73  ts.** key becaus
2650: 65 20 63 6c 6f 73 65 28 29 20 63 6c 65 61 72 73  e close() clears
2660: 20 6c 6f 63 6b 20 6f 6e 20 61 6c 6c 20 74 68 72   lock on all thr
2670: 65 61 64 73 2c 20 6e 6f 74 20 6a 75 73 74 20 74  eads, not just t
2680: 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 74 68  he current.** th
2690: 72 65 61 64 2e 20 20 57 65 72 65 20 69 74 20 6e  read.  Were it n
26a0: 6f 74 20 66 6f 72 20 74 68 69 73 20 67 6f 6f 66  ot for this goof
26b0: 69 6e 65 73 73 20 69 6e 20 6c 69 6e 75 78 20 74  iness in linux t
26c0: 68 72 65 61 64 73 2c 20 77 65 20 63 6f 75 6c 64  hreads, we could
26d0: 0a 2a 2a 20 63 6f 6d 62 69 6e 65 20 74 68 65 20  .** combine the 
26e0: 6c 6f 63 6b 49 6e 66 6f 20 61 6e 64 20 6f 70 65  lockInfo and ope
26f0: 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65 73 20  nCnt structures 
2700: 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 73 74  into a single st
2710: 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 32  ructure..**.** 2
2720: 30 30 34 2d 4a 75 6e 2d 32 38 3a 0a 2a 2a 20 4f  004-Jun-28:.** O
2730: 6e 20 73 6f 6d 65 20 76 65 72 73 69 6f 6e 73 20  n some versions 
2740: 6f 66 20 6c 69 6e 75 78 2c 20 74 68 72 65 61 64  of linux, thread
2750: 73 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 65  s can override e
2760: 61 63 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73  ach others locks
2770: 2e 0a 2a 2a 20 4f 6e 20 6f 74 68 65 72 73 20 6e  ..** On others n
2780: 6f 74 2e 20 20 53 6f 6d 65 74 69 6d 65 73 20 79  ot.  Sometimes y
2790: 6f 75 20 63 61 6e 20 63 68 61 6e 67 65 20 74 68  ou can change th
27a0: 65 20 62 65 68 61 76 69 6f 72 20 6f 6e 20 74 68  e behavior on th
27b0: 65 20 73 61 6d 65 0a 2a 2a 20 73 79 73 74 65 6d  e same.** system
27c0: 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65 20   by setting the 
27d0: 4c 44 5f 41 53 53 55 4d 45 5f 4b 45 52 4e 45 4c  LD_ASSUME_KERNEL
27e0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
27f0: 69 61 62 6c 65 2e 20 20 54 68 65 0a 2a 2a 20 50  iable.  The.** P
2800: 4f 53 49 58 20 73 74 61 6e 64 61 72 64 20 69 73  OSIX standard is
2810: 20 73 69 6c 65 6e 74 20 61 73 20 74 6f 20 77 68   silent as to wh
2820: 69 63 68 20 62 65 68 61 76 69 6f 72 20 69 73 20  ich behavior is 
2830: 63 6f 72 72 65 63 74 2c 20 61 73 20 66 61 72 0a  correct, as far.
2840: 2a 2a 20 61 73 20 49 20 63 61 6e 20 74 65 6c 6c  ** as I can tell
2850: 2c 20 73 6f 20 6f 74 68 65 72 20 76 65 72 73 69  , so other versi
2860: 6f 6e 73 20 6f 66 20 75 6e 69 78 20 6d 69 67 68  ons of unix migh
2870: 74 20 73 68 6f 77 20 74 68 65 20 73 61 6d 65 0a  t show the same.
2880: 2a 2a 20 69 6e 63 6f 6e 73 69 73 74 65 6e 63 79  ** inconsistency
2890: 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 6c  .  There is no l
28a0: 69 74 74 6c 65 20 64 6f 75 62 74 20 69 6e 20 6d  ittle doubt in m
28b0: 79 20 6d 69 6e 64 20 74 68 61 74 20 70 6f 73 69  y mind that posi
28c0: 78 0a 2a 2a 20 61 64 76 69 73 6f 72 79 20 6c 6f  x.** advisory lo
28d0: 63 6b 73 20 61 6e 64 20 6c 69 6e 75 78 20 74 68  cks and linux th
28e0: 72 65 61 64 73 20 61 72 65 20 70 72 6f 66 6f 75  reads are profou
28f0: 6e 64 6c 79 20 62 72 6f 6b 65 6e 2e 0a 2a 2a 0a  ndly broken..**.
2900: 2a 2a 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e  ** To work aroun
2910: 64 20 74 68 65 20 69 6e 63 6f 6e 73 69 73 74 65  d the inconsiste
2920: 6e 63 69 65 73 2c 20 77 65 20 68 61 76 65 20 74  ncies, we have t
2930: 6f 20 74 65 73 74 20 61 74 20 72 75 6e 74 69 6d  o test at runtim
2940: 65 20 0a 2a 2a 20 77 68 65 74 68 65 72 20 6f 72  e .** whether or
2950: 20 6e 6f 74 20 74 68 72 65 61 64 73 20 63 61 6e   not threads can
2960: 20 6f 76 65 72 72 69 64 65 20 65 61 63 68 20 6f   override each o
2970: 74 68 65 72 73 20 6c 6f 63 6b 73 2e 20 20 54 68  thers locks.  Th
2980: 69 73 20 74 65 73 74 0a 2a 2a 20 69 73 20 72 75  is test.** is ru
2990: 6e 20 6f 6e 63 65 2c 20 74 68 65 20 66 69 72 73  n once, the firs
29a0: 74 20 74 69 6d 65 20 61 6e 79 20 6c 6f 63 6b 20  t time any lock 
29b0: 69 73 20 61 74 74 65 6d 70 74 65 64 2e 20 20 41  is attempted.  A
29c0: 20 73 74 61 74 69 63 20 0a 2a 2a 20 76 61 72 69   static .** vari
29d0: 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f 20 72  able is set to r
29e0: 65 63 6f 72 64 20 74 68 65 20 72 65 73 75 6c 74  ecord the result
29f0: 73 20 6f 66 20 74 68 69 73 20 74 65 73 74 20 66  s of this test f
2a00: 6f 72 20 66 75 74 75 72 65 0a 2a 2a 20 75 73 65  or future.** use
2a10: 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69  ..*/../*.** An i
2a20: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66  nstance of the f
2a30: 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75  ollowing structu
2a40: 72 65 20 73 65 72 76 65 73 20 61 73 20 74 68 65  re serves as the
2a50: 20 6b 65 79 20 75 73 65 64 0a 2a 2a 20 74 6f 20   key used.** to 
2a60: 6c 6f 63 61 74 65 20 61 20 70 61 72 74 69 63 75  locate a particu
2a70: 6c 61 72 20 6c 6f 63 6b 49 6e 66 6f 20 73 74 72  lar lockInfo str
2a80: 75 63 74 75 72 65 20 67 69 76 65 6e 20 69 74 73  ucture given its
2a90: 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 49 66   inode..**.** If
2aa0: 20 74 68 72 65 61 64 73 20 63 61 6e 6e 6f 74 20   threads cannot 
2ab0: 6f 76 65 72 72 69 64 65 20 65 61 63 68 20 6f 74  override each ot
2ac0: 68 65 72 73 20 6c 6f 63 6b 73 2c 20 74 68 65 6e  hers locks, then
2ad0: 20 77 65 20 73 65 74 20 74 68 65 0a 2a 2a 20 6c   we set the.** l
2ae0: 6f 63 6b 4b 65 79 2e 74 69 64 20 66 69 65 6c 64  ockKey.tid field
2af0: 20 74 6f 20 74 68 65 20 74 68 72 65 61 64 20 49   to the thread I
2b00: 44 2e 20 20 49 66 20 74 68 72 65 61 64 73 20 63  D.  If threads c
2b10: 61 6e 20 6f 76 65 72 72 69 64 65 0a 2a 2a 20 65  an override.** e
2b20: 61 63 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73  ach others locks
2b30: 20 74 68 65 6e 20 74 69 64 20 69 73 20 61 6c 77   then tid is alw
2b40: 61 79 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e  ays set to zero.
2b50: 20 20 74 69 64 20 69 73 20 61 6c 73 6f 0a 2a 2a    tid is also.**
2b60: 20 73 65 74 20 74 6f 20 7a 65 72 6f 20 69 66 20   set to zero if 
2b70: 77 65 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 6f  we compile witho
2b80: 75 74 20 74 68 72 65 61 64 69 6e 67 20 73 75 70  ut threading sup
2b90: 70 6f 72 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20  port..*/.struct 
2ba0: 6c 6f 63 6b 4b 65 79 20 7b 0a 20 20 64 65 76 5f  lockKey {.  dev_
2bb0: 74 20 64 65 76 3b 20 20 20 20 20 20 20 2f 2a 20  t dev;       /* 
2bc0: 44 65 76 69 63 65 20 6e 75 6d 62 65 72 20 2a 2f  Device number */
2bd0: 0a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20 20  .  ino_t ino;   
2be0: 20 20 20 20 2f 2a 20 49 6e 6f 64 65 20 6e 75 6d      /* Inode num
2bf0: 62 65 72 20 2a 2f 0a 23 69 66 64 65 66 20 53 51  ber */.#ifdef SQ
2c00: 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44  LITE_UNIX_THREAD
2c10: 53 0a 20 20 70 74 68 72 65 61 64 5f 74 20 74 69  S.  pthread_t ti
2c20: 64 3b 20 20 20 2f 2a 20 54 68 72 65 61 64 20 49  d;   /* Thread I
2c30: 44 20 6f 72 20 7a 65 72 6f 20 69 66 20 74 68 72  D or zero if thr
2c40: 65 61 64 73 20 63 61 6e 20 6f 76 65 72 72 69 64  eads can overrid
2c50: 65 20 65 61 63 68 20 6f 74 68 65 72 20 2a 2f 0a  e each other */.
2c60: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  #endif.};../*.**
2c70: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20   An instance of 
2c80: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  the following st
2c90: 72 75 63 74 75 72 65 20 69 73 20 61 6c 6c 6f 63  ructure is alloc
2ca0: 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 6f 70  ated for each op
2cb0: 65 6e 0a 2a 2a 20 69 6e 6f 64 65 20 6f 6e 20 65  en.** inode on e
2cc0: 61 63 68 20 74 68 72 65 61 64 20 77 69 74 68 20  ach thread with 
2cd0: 61 20 64 69 66 66 65 72 65 6e 74 20 70 72 6f 63  a different proc
2ce0: 65 73 73 20 49 44 2e 20 20 28 54 68 72 65 61 64  ess ID.  (Thread
2cf0: 73 20 68 61 76 65 0a 2a 2a 20 64 69 66 66 65 72  s have.** differ
2d00: 65 6e 74 20 70 72 6f 63 65 73 73 20 49 44 73 20  ent process IDs 
2d10: 6f 6e 20 6c 69 6e 75 78 2c 20 62 75 74 20 6e 6f  on linux, but no
2d20: 74 20 6f 6e 20 6d 6f 73 74 20 6f 74 68 65 72 20  t on most other 
2d30: 75 6e 69 78 65 73 2e 29 0a 2a 2a 0a 2a 2a 20 41  unixes.).**.** A
2d40: 20 73 69 6e 67 6c 65 20 69 6e 6f 64 65 20 63 61   single inode ca
2d50: 6e 20 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 20  n have multiple 
2d60: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73  file descriptors
2d70: 2c 20 73 6f 20 65 61 63 68 20 4f 73 46 69 6c 65  , so each OsFile
2d80: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 63 6f  .** structure co
2d90: 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72  ntains a pointer
2da0: 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e 63 65 20   to an instance 
2db0: 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 61  of this object a
2dc0: 6e 64 20 74 68 69 73 0a 2a 2a 20 6f 62 6a 65 63  nd this.** objec
2dd0: 74 20 6b 65 65 70 73 20 61 20 63 6f 75 6e 74 20  t keeps a count 
2de0: 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  of the number of
2df0: 20 4f 73 46 69 6c 65 73 20 70 6f 69 6e 74 69 6e   OsFiles pointin
2e00: 67 20 74 6f 20 69 74 2e 0a 2a 2f 0a 73 74 72 75  g to it..*/.stru
2e10: 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 7b 0a 20 20  ct lockInfo {.  
2e20: 73 74 72 75 63 74 20 6c 6f 63 6b 4b 65 79 20 6b  struct lockKey k
2e30: 65 79 3b 20 20 2f 2a 20 54 68 65 20 6c 6f 6f 6b  ey;  /* The look
2e40: 75 70 20 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20  up key */.  int 
2e50: 63 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  cnt;            
2e60: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 53 48   /* Number of SH
2e70: 41 52 45 44 20 6c 6f 63 6b 73 20 68 65 6c 64 20  ARED locks held 
2e80: 2a 2f 0a 20 20 69 6e 74 20 6c 6f 63 6b 74 79 70  */.  int locktyp
2e90: 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65  e;        /* One
2ea0: 20 6f 66 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c   of SHARED_LOCK,
2eb0: 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 65   RESERVED_LOCK e
2ec0: 74 63 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65  tc. */.  int nRe
2ed0: 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  f;            /*
2ee0: 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74   Number of point
2ef0: 65 72 73 20 74 6f 20 74 68 69 73 20 73 74 72 75  ers to this stru
2f00: 63 74 75 72 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a  cture */.};../*.
2f10: 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f  ** An instance o
2f20: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
2f30: 73 74 72 75 63 74 75 72 65 20 73 65 72 76 65 73  structure serves
2f40: 20 61 73 20 74 68 65 20 6b 65 79 20 75 73 65 64   as the key used
2f50: 0a 2a 2a 20 74 6f 20 6c 6f 63 61 74 65 20 61 20  .** to locate a 
2f60: 70 61 72 74 69 63 75 6c 61 72 20 6f 70 65 6e 43  particular openC
2f70: 6e 74 20 73 74 72 75 63 74 75 72 65 20 67 69 76  nt structure giv
2f80: 65 6e 20 69 74 73 20 69 6e 6f 64 65 2e 20 20 54  en its inode.  T
2f90: 68 69 73 0a 2a 2a 20 69 73 20 74 68 65 20 73 61  his.** is the sa
2fa0: 6d 65 20 61 73 20 74 68 65 20 6c 6f 63 6b 4b 65  me as the lockKe
2fb0: 79 20 65 78 63 65 70 74 20 74 68 61 74 20 74 68  y except that th
2fc0: 65 20 74 68 72 65 61 64 20 49 44 20 69 73 20 6f  e thread ID is o
2fd0: 6d 69 74 74 65 64 2e 0a 2a 2f 0a 73 74 72 75 63  mitted..*/.struc
2fe0: 74 20 6f 70 65 6e 4b 65 79 20 7b 0a 20 20 64 65  t openKey {.  de
2ff0: 76 5f 74 20 64 65 76 3b 20 20 20 2f 2a 20 44 65  v_t dev;   /* De
3000: 76 69 63 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20  vice number */. 
3010: 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20 20 2f 2a   ino_t ino;   /*
3020: 20 49 6e 6f 64 65 20 6e 75 6d 62 65 72 20 2a 2f   Inode number */
3030: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e  .};../*.** An in
3040: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f  stance of the fo
3050: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
3060: 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66  e is allocated f
3070: 6f 72 20 65 61 63 68 20 6f 70 65 6e 0a 2a 2a 20  or each open.** 
3080: 69 6e 6f 64 65 2e 20 20 54 68 69 73 20 73 74 72  inode.  This str
3090: 75 63 74 75 72 65 20 6b 65 65 70 73 20 74 72 61  ucture keeps tra
30a0: 63 6b 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72  ck of the number
30b0: 20 6f 66 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 61   of locks on tha
30c0: 74 0a 2a 2a 20 69 6e 6f 64 65 2e 20 20 49 66 20  t.** inode.  If 
30d0: 61 20 63 6c 6f 73 65 20 69 73 20 61 74 74 65 6d  a close is attem
30e0: 70 74 65 64 20 61 67 61 69 6e 73 74 20 61 6e 20  pted against an 
30f0: 69 6e 6f 64 65 20 74 68 61 74 20 69 73 20 68 6f  inode that is ho
3100: 6c 64 69 6e 67 0a 2a 2a 20 6c 6f 63 6b 73 2c 20  lding.** locks, 
3110: 74 68 65 20 63 6c 6f 73 65 20 69 73 20 64 65 66  the close is def
3120: 65 72 72 65 64 20 75 6e 74 69 6c 20 61 6c 6c 20  erred until all 
3130: 6c 6f 63 6b 73 20 63 6c 65 61 72 20 62 79 20 61  locks clear by a
3140: 64 64 69 6e 67 20 74 68 65 0a 2a 2a 20 66 69 6c  dding the.** fil
3150: 65 20 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20  e descriptor to 
3160: 62 65 20 63 6c 6f 73 65 64 20 74 6f 20 74 68 65  be closed to the
3170: 20 70 65 6e 64 69 6e 67 20 6c 69 73 74 2e 0a 2a   pending list..*
3180: 2f 0a 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74  /.struct openCnt
3190: 20 7b 0a 20 20 73 74 72 75 63 74 20 6f 70 65 6e   {.  struct open
31a0: 4b 65 79 20 6b 65 79 3b 20 20 20 2f 2a 20 54 68  Key key;   /* Th
31b0: 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f 0a  e lookup key */.
31c0: 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20    int nRef;     
31d0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
31e0: 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f  r of pointers to
31f0: 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20   this structure 
3200: 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 63 6b 3b 20  */.  int nLock; 
3210: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
3220: 6d 62 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64  mber of outstand
3230: 69 6e 67 20 6c 6f 63 6b 73 20 2a 2f 0a 20 20 69  ing locks */.  i
3240: 6e 74 20 6e 50 65 6e 64 69 6e 67 3b 20 20 20 20  nt nPending;    
3250: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
3260: 66 20 70 65 6e 64 69 6e 67 20 63 6c 6f 73 65 28  f pending close(
3270: 29 20 6f 70 65 72 61 74 69 6f 6e 73 20 2a 2f 0a  ) operations */.
3280: 20 20 69 6e 74 20 2a 61 50 65 6e 64 69 6e 67 3b    int *aPending;
3290: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 6c 6c 6f          /* Mallo
32a0: 63 65 64 20 73 70 61 63 65 20 68 6f 6c 64 69 6e  ced space holdin
32b0: 67 20 66 64 27 73 20 61 77 61 69 74 69 6e 67 20  g fd's awaiting 
32c0: 61 20 63 6c 6f 73 65 28 29 20 2a 2f 0a 7d 3b 0a  a close() */.};.
32d0: 0a 2f 2a 20 0a 2a 2a 20 54 68 65 73 65 20 68 61  ./* .** These ha
32e0: 73 68 20 74 61 62 6c 65 20 6d 61 70 73 20 69 6e  sh table maps in
32f0: 6f 64 65 73 20 61 6e 64 20 70 72 6f 63 65 73 73  odes and process
3300: 20 49 44 73 20 69 6e 74 6f 20 6c 6f 63 6b 49 6e   IDs into lockIn
3310: 66 6f 20 61 6e 64 20 6f 70 65 6e 43 6e 74 0a 2a  fo and openCnt.*
3320: 2a 20 73 74 72 75 63 74 75 72 65 73 2e 20 20 41  * structures.  A
3330: 63 63 65 73 73 20 74 6f 20 74 68 65 73 65 20 68  ccess to these h
3340: 61 73 68 20 74 61 62 6c 65 73 20 6d 75 73 74 20  ash tables must 
3350: 62 65 20 70 72 6f 74 65 63 74 65 64 20 62 79 20  be protected by 
3360: 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73 74 61 74  a mutex..*/.stat
3370: 69 63 20 48 61 73 68 20 6c 6f 63 6b 48 61 73 68  ic Hash lockHash
3380: 20 3d 20 7b 20 53 51 4c 49 54 45 5f 48 41 53 48   = { SQLITE_HASH
3390: 5f 42 49 4e 41 52 59 2c 20 30 2c 20 30 2c 20 30  _BINARY, 0, 0, 0
33a0: 2c 20 30 2c 20 30 20 7d 3b 0a 73 74 61 74 69 63  , 0, 0 };.static
33b0: 20 48 61 73 68 20 6f 70 65 6e 48 61 73 68 20 3d   Hash openHash =
33c0: 20 7b 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 42   { SQLITE_HASH_B
33d0: 49 4e 41 52 59 2c 20 30 2c 20 30 2c 20 30 2c 20  INARY, 0, 0, 0, 
33e0: 30 2c 20 30 20 7d 3b 0a 0a 0a 23 69 66 64 65 66  0, 0 };...#ifdef
33f0: 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52   SQLITE_UNIX_THR
3400: 45 41 44 53 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  EADS./*.** This 
3410: 76 61 72 69 61 62 6c 65 20 72 65 63 6f 72 64 73  variable records
3420: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
3430: 74 68 72 65 61 64 73 20 63 61 6e 20 6f 76 65 72  threads can over
3440: 72 69 64 65 20 65 61 63 68 20 6f 74 68 65 72 73  ride each others
3450: 0a 2a 2a 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a  .** locks..**.**
3460: 20 20 20 20 30 3a 20 20 4e 6f 2e 20 20 54 68 72      0:  No.  Thr
3470: 65 61 64 73 20 63 61 6e 6e 6f 74 20 6f 76 65 72  eads cannot over
3480: 72 69 64 65 20 65 61 63 68 20 6f 74 68 65 72 73  ride each others
3490: 20 6c 6f 63 6b 73 2e 0a 2a 2a 20 20 20 20 31 3a   locks..**    1:
34a0: 20 20 59 65 73 2e 20 20 54 68 72 65 61 64 73 20    Yes.  Threads 
34b0: 63 61 6e 20 6f 76 65 72 72 69 64 65 20 65 61 63  can override eac
34c0: 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73 2e 0a  h others locks..
34d0: 2a 2a 20 20 20 2d 31 3a 20 20 57 65 20 64 6f 6e  **   -1:  We don
34e0: 27 74 20 6b 6e 6f 77 20 79 65 74 2e 0a 2a 2f 0a  't know yet..*/.
34f0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
3500: 53 54 0a 69 6e 74 20 74 68 72 65 61 64 73 4f 76  ST.int threadsOv
3510: 65 72 72 69 64 65 45 61 63 68 4f 74 68 65 72 73  errideEachOthers
3520: 4c 6f 63 6b 73 20 3d 20 2d 31 3b 0a 23 65 6c 73  Locks = -1;.#els
3530: 65 0a 73 74 61 74 69 63 20 69 6e 74 20 74 68 72  e.static int thr
3540: 65 61 64 73 4f 76 65 72 72 69 64 65 45 61 63 68  eadsOverrideEach
3550: 4f 74 68 65 72 73 4c 6f 63 6b 73 20 3d 20 2d 31  OthersLocks = -1
3560: 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  ;.#endif../*.** 
3570: 54 68 69 73 20 73 74 72 75 63 74 75 72 65 20 68  This structure h
3580: 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  olds information
3590: 20 70 61 73 73 65 64 20 69 6e 74 6f 20 69 6e 64   passed into ind
35a0: 69 76 69 64 75 61 6c 20 74 65 73 74 0a 2a 2a 20  ividual test.** 
35b0: 74 68 72 65 61 64 73 20 62 79 20 74 68 65 20 74  threads by the t
35c0: 65 73 74 54 68 72 65 61 64 4c 6f 63 6b 69 6e 67  estThreadLocking
35d0: 42 65 68 61 76 69 6f 72 28 29 20 72 6f 75 74 69  Behavior() routi
35e0: 6e 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 74 68  ne..*/.struct th
35f0: 72 65 61 64 54 65 73 74 44 61 74 61 20 7b 0a 20  readTestData {. 
3600: 20 69 6e 74 20 66 64 3b 20 20 20 20 20 20 20 20   int fd;        
3610: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20          /* File 
3620: 74 6f 20 62 65 20 6c 6f 63 6b 65 64 20 2a 2f 0a  to be locked */.
3630: 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 6c    struct flock l
3640: 6f 63 6b 3b 20 20 20 20 20 2f 2a 20 54 68 65 20  ock;     /* The 
3650: 6c 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69 6f  locking operatio
3660: 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 65 73 75 6c  n */.  int resul
3670: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  t;            /*
3680: 20 52 65 73 75 6c 74 20 6f 66 20 74 68 65 20 6c   Result of the l
3690: 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e  ocking operation
36a0: 20 2a 2f 0a 7d 3b 0a 0a 23 69 66 64 65 66 20 53   */.};..#ifdef S
36b0: 51 4c 49 54 45 5f 4c 4f 43 4b 5f 54 52 41 43 45  QLITE_LOCK_TRACE
36c0: 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 6f 75 74  ./*.** Print out
36d0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f   information abo
36e0: 75 74 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 6f  ut all locking o
36f0: 70 65 72 61 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a  perations..**.**
3700: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
3710: 20 75 73 65 64 20 66 6f 72 20 74 72 6f 75 62 6c   used for troubl
3720: 65 73 68 6f 6f 74 69 6e 67 20 6c 6f 63 6b 73 20  eshooting locks 
3730: 6f 6e 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64  on multithreaded
3740: 0a 2a 2a 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20  .** platforms.  
3750: 45 6e 61 62 6c 65 20 62 79 20 63 6f 6d 70 69 6c  Enable by compil
3760: 69 6e 67 20 77 69 74 68 20 74 68 65 20 2d 44 53  ing with the -DS
3770: 51 4c 49 54 45 5f 4c 4f 43 4b 5f 54 52 41 43 45  QLITE_LOCK_TRACE
3780: 0a 2a 2a 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65  .** command-line
3790: 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 20 63   option on the c
37a0: 6f 6d 70 69 6c 65 72 2e 20 20 54 68 69 73 20 63  ompiler.  This c
37b0: 6f 64 65 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 0a  ode is normally.
37c0: 2a 2a 20 74 75 72 6e 6e 65 64 20 6f 66 66 2e 0a  ** turnned off..
37d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 6f  */.static int lo
37e0: 63 6b 54 72 61 63 65 28 69 6e 74 20 66 64 2c 20  ckTrace(int fd, 
37f0: 69 6e 74 20 6f 70 2c 20 73 74 72 75 63 74 20 66  int op, struct f
3800: 6c 6f 63 6b 20 2a 70 29 7b 0a 20 20 63 68 61 72  lock *p){.  char
3810: 20 2a 7a 4f 70 4e 61 6d 65 2c 20 2a 7a 54 79 70   *zOpName, *zTyp
3820: 65 3b 0a 20 20 69 6e 74 20 73 3b 0a 20 20 69 6e  e;.  int s;.  in
3830: 74 20 73 61 76 65 64 45 72 72 6e 6f 3b 0a 20 20  t savedErrno;.  
3840: 69 66 28 20 6f 70 3d 3d 46 5f 47 45 54 4c 4b 20  if( op==F_GETLK 
3850: 29 7b 0a 20 20 20 20 7a 4f 70 4e 61 6d 65 20 3d  ){.    zOpName =
3860: 20 22 47 45 54 4c 4b 22 3b 0a 20 20 7d 65 6c 73   "GETLK";.  }els
3870: 65 20 69 66 28 20 6f 70 3d 3d 46 5f 53 45 54 4c  e if( op==F_SETL
3880: 4b 20 29 7b 0a 20 20 20 20 7a 4f 70 4e 61 6d 65  K ){.    zOpName
3890: 20 3d 20 22 53 45 54 4c 4b 22 3b 0a 20 20 7d 65   = "SETLK";.  }e
38a0: 6c 73 65 7b 0a 20 20 20 20 73 20 3d 20 66 63 6e  lse{.    s = fcn
38b0: 74 6c 28 66 64 2c 20 6f 70 2c 20 70 29 3b 0a 20  tl(fd, op, p);. 
38c0: 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50     sqlite3DebugP
38d0: 72 69 6e 74 66 28 22 66 63 6e 74 6c 20 75 6e 6b  rintf("fcntl unk
38e0: 6e 6f 77 6e 20 25 64 20 25 64 20 25 64 5c 6e 22  nown %d %d %d\n"
38f0: 2c 20 66 64 2c 20 6f 70 2c 20 73 29 3b 0a 20 20  , fd, op, s);.  
3900: 20 20 72 65 74 75 72 6e 20 73 3b 0a 20 20 7d 0a    return s;.  }.
3910: 20 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70 65 3d    if( p->l_type=
3920: 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a 20 20 20 20  =F_RDLCK ){.    
3930: 7a 54 79 70 65 20 3d 20 22 52 44 4c 43 4b 22 3b  zType = "RDLCK";
3940: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e  .  }else if( p->
3950: 6c 5f 74 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20  l_type==F_WRLCK 
3960: 29 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d 20 22  ){.    zType = "
3970: 57 52 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73 65 20  WRLCK";.  }else 
3980: 69 66 28 20 70 2d 3e 6c 5f 74 79 70 65 3d 3d 46  if( p->l_type==F
3990: 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20 7a 54  _UNLCK ){.    zT
39a0: 79 70 65 20 3d 20 22 55 4e 4c 43 4b 22 3b 0a 20  ype = "UNLCK";. 
39b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65   }else{.    asse
39c0: 72 74 28 20 30 20 29 3b 0a 20 20 7d 0a 20 20 61  rt( 0 );.  }.  a
39d0: 73 73 65 72 74 28 20 70 2d 3e 6c 5f 77 68 65 6e  ssert( p->l_when
39e0: 63 65 3d 3d 53 45 45 4b 5f 53 45 54 20 29 3b 0a  ce==SEEK_SET );.
39f0: 20 20 73 20 3d 20 66 63 6e 74 6c 28 66 64 2c 20    s = fcntl(fd, 
3a00: 6f 70 2c 20 70 29 3b 0a 20 20 73 61 76 65 64 45  op, p);.  savedE
3a10: 72 72 6e 6f 20 3d 20 65 72 72 6e 6f 3b 0a 20 20  rrno = errno;.  
3a20: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e  sqlite3DebugPrin
3a30: 74 66 28 22 66 63 6e 74 6c 20 25 64 20 25 64 20  tf("fcntl %d %d 
3a40: 25 73 20 25 73 20 25 64 20 25 64 20 25 64 20 25  %s %s %d %d %d %
3a50: 64 5c 6e 22 2c 0a 20 20 20 20 20 74 68 72 65 61  d\n",.     threa
3a60: 64 69 64 2c 20 66 64 2c 20 7a 4f 70 4e 61 6d 65  did, fd, zOpName
3a70: 2c 20 7a 54 79 70 65 2c 20 28 69 6e 74 29 70 2d  , zType, (int)p-
3a80: 3e 6c 5f 73 74 61 72 74 2c 20 28 69 6e 74 29 70  >l_start, (int)p
3a90: 2d 3e 6c 5f 6c 65 6e 2c 0a 20 20 20 20 20 28 69  ->l_len,.     (i
3aa0: 6e 74 29 70 2d 3e 6c 5f 70 69 64 2c 20 73 29 3b  nt)p->l_pid, s);
3ab0: 0a 20 20 69 66 28 20 73 20 26 26 20 6f 70 3d 3d  .  if( s && op==
3ac0: 46 5f 53 45 54 4c 4b 20 26 26 20 28 70 2d 3e 6c  F_SETLK && (p->l
3ad0: 5f 74 79 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 7c  _type==F_RDLCK |
3ae0: 7c 20 70 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 57  | p->l_type==F_W
3af0: 52 4c 43 4b 29 20 29 7b 0a 20 20 20 20 73 74 72  RLCK) ){.    str
3b00: 75 63 74 20 66 6c 6f 63 6b 20 6c 32 3b 0a 20 20  uct flock l2;.  
3b10: 20 20 6c 32 20 3d 20 2a 70 3b 0a 20 20 20 20 66    l2 = *p;.    f
3b20: 63 6e 74 6c 28 66 64 2c 20 46 5f 47 45 54 4c 4b  cntl(fd, F_GETLK
3b30: 2c 20 26 6c 32 29 3b 0a 20 20 20 20 69 66 28 20  , &l2);.    if( 
3b40: 6c 32 2e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c  l2.l_type==F_RDL
3b50: 43 4b 20 29 7b 0a 20 20 20 20 20 20 7a 54 79 70  CK ){.      zTyp
3b60: 65 20 3d 20 22 52 44 4c 43 4b 22 3b 0a 20 20 20  e = "RDLCK";.   
3b70: 20 7d 65 6c 73 65 20 69 66 28 20 6c 32 2e 6c 5f   }else if( l2.l_
3b80: 74 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 20 29 7b  type==F_WRLCK ){
3b90: 0a 20 20 20 20 20 20 7a 54 79 70 65 20 3d 20 22  .      zType = "
3ba0: 57 52 4c 43 4b 22 3b 0a 20 20 20 20 7d 65 6c 73  WRLCK";.    }els
3bb0: 65 20 69 66 28 20 6c 32 2e 6c 5f 74 79 70 65 3d  e if( l2.l_type=
3bc0: 3d 46 5f 55 4e 4c 43 4b 20 29 7b 0a 20 20 20 20  =F_UNLCK ){.    
3bd0: 20 20 7a 54 79 70 65 20 3d 20 22 55 4e 4c 43 4b    zType = "UNLCK
3be0: 22 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  ";.    }else{.  
3bf0: 20 20 20 20 61 73 73 65 72 74 28 20 30 20 29 3b      assert( 0 );
3c00: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
3c10: 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 66  e3DebugPrintf("f
3c20: 63 6e 74 6c 2d 66 61 69 6c 75 72 65 2d 72 65 61  cntl-failure-rea
3c30: 73 6f 6e 3a 20 25 73 20 25 64 20 25 64 20 25 64  son: %s %d %d %d
3c40: 5c 6e 22 2c 0a 20 20 20 20 20 20 20 7a 54 79 70  \n",.       zTyp
3c50: 65 2c 20 28 69 6e 74 29 6c 32 2e 6c 5f 73 74 61  e, (int)l2.l_sta
3c60: 72 74 2c 20 28 69 6e 74 29 6c 32 2e 6c 5f 6c 65  rt, (int)l2.l_le
3c70: 6e 2c 20 28 69 6e 74 29 6c 32 2e 6c 5f 70 69 64  n, (int)l2.l_pid
3c80: 29 3b 0a 20 20 7d 0a 20 20 65 72 72 6e 6f 20 3d  );.  }.  errno =
3c90: 20 73 61 76 65 64 45 72 72 6e 6f 3b 0a 20 20 72   savedErrno;.  r
3ca0: 65 74 75 72 6e 20 73 3b 0a 7d 0a 23 64 65 66 69  eturn s;.}.#defi
3cb0: 6e 65 20 66 63 6e 74 6c 20 6c 6f 63 6b 54 72 61  ne fcntl lockTra
3cc0: 63 65 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  ce.#endif /* SQL
3cd0: 49 54 45 5f 4c 4f 43 4b 5f 54 52 41 43 45 20 2a  ITE_LOCK_TRACE *
3ce0: 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 74 65 73  /../*.** The tes
3cf0: 74 54 68 72 65 61 64 4c 6f 63 6b 69 6e 67 42 65  tThreadLockingBe
3d00: 68 61 76 69 6f 72 28 29 20 72 6f 75 74 69 6e 65  havior() routine
3d10: 20 6c 61 75 6e 63 68 65 73 20 74 77 6f 20 73 65   launches two se
3d20: 70 61 72 61 74 65 0a 2a 2a 20 74 68 72 65 61 64  parate.** thread
3d30: 73 20 6f 6e 20 74 68 69 73 20 72 6f 75 74 69 6e  s on this routin
3d40: 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  e.  This routine
3d50: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6c 6f 63   attempts to loc
3d60: 6b 20 61 20 66 69 6c 65 0a 2a 2a 20 64 65 73 63  k a file.** desc
3d70: 72 69 70 74 6f 72 20 74 68 65 6e 20 72 65 74 75  riptor then retu
3d80: 72 6e 73 2e 20 20 54 68 65 20 73 75 63 63 65 73  rns.  The succes
3d90: 73 20 6f 72 20 66 61 69 6c 75 72 65 20 6f 66 20  s or failure of 
3da0: 74 68 61 74 20 61 74 74 65 6d 70 74 0a 2a 2a 20  that attempt.** 
3db0: 61 6c 6c 6f 77 73 20 74 68 65 20 74 65 73 74 54  allows the testT
3dc0: 68 72 65 61 64 4c 6f 63 6b 69 6e 67 42 65 68 61  hreadLockingBeha
3dd0: 76 69 6f 72 28 29 20 70 72 6f 63 65 64 75 72 65  vior() procedure
3de0: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 0a 2a 2a   to determine.**
3df0: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
3e00: 74 68 72 65 61 64 73 20 63 61 6e 20 6f 76 65 72  threads can over
3e10: 72 69 64 65 20 65 61 63 68 20 6f 74 68 65 72 73  ride each others
3e20: 20 6c 6f 63 6b 73 2e 0a 2a 2f 0a 73 74 61 74 69   locks..*/.stati
3e30: 63 20 76 6f 69 64 20 2a 74 68 72 65 61 64 4c 6f  c void *threadLo
3e40: 63 6b 69 6e 67 54 65 73 74 28 76 6f 69 64 20 2a  ckingTest(void *
3e50: 70 41 72 67 29 7b 0a 20 20 73 74 72 75 63 74 20  pArg){.  struct 
3e60: 74 68 72 65 61 64 54 65 73 74 44 61 74 61 20 2a  threadTestData *
3e70: 70 44 61 74 61 20 3d 20 28 73 74 72 75 63 74 20  pData = (struct 
3e80: 74 68 72 65 61 64 54 65 73 74 44 61 74 61 2a 29  threadTestData*)
3e90: 70 41 72 67 3b 0a 20 20 70 44 61 74 61 2d 3e 72  pArg;.  pData->r
3ea0: 65 73 75 6c 74 20 3d 20 66 63 6e 74 6c 28 70 44  esult = fcntl(pD
3eb0: 61 74 61 2d 3e 66 64 2c 20 46 5f 53 45 54 4c 4b  ata->fd, F_SETLK
3ec0: 2c 20 26 70 44 61 74 61 2d 3e 6c 6f 63 6b 29 3b  , &pData->lock);
3ed0: 0a 20 20 72 65 74 75 72 6e 20 70 41 72 67 3b 0a  .  return pArg;.
3ee0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 70 72  }../*.** This pr
3ef0: 6f 63 65 64 75 72 65 20 61 74 74 65 6d 70 74 73  ocedure attempts
3f00: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68   to determine wh
3f10: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 72  ether or not thr
3f20: 65 61 64 73 0a 2a 2a 20 63 61 6e 20 6f 76 65 72  eads.** can over
3f30: 72 69 64 65 20 65 61 63 68 20 6f 74 68 65 72 73  ride each others
3f40: 20 6c 6f 63 6b 73 20 74 68 65 6e 20 73 65 74 73   locks then sets
3f50: 20 74 68 65 20 0a 2a 2a 20 74 68 72 65 61 64 73   the .** threads
3f60: 4f 76 65 72 72 69 64 65 45 61 63 68 4f 74 68 65  OverrideEachOthe
3f70: 72 73 4c 6f 63 6b 73 20 76 61 72 69 61 62 6c 65  rsLocks variable
3f80: 20 61 70 70 72 6f 70 72 69 61 74 65 6c 79 2e 0a   appropriately..
3f90: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 74  */.static void t
3fa0: 65 73 74 54 68 72 65 61 64 4c 6f 63 6b 69 6e 67  estThreadLocking
3fb0: 42 65 68 61 76 69 6f 72 28 66 64 5f 6f 72 69 67  Behavior(fd_orig
3fc0: 29 7b 0a 20 20 69 6e 74 20 66 64 3b 0a 20 20 73  ){.  int fd;.  s
3fd0: 74 72 75 63 74 20 74 68 72 65 61 64 54 65 73 74  truct threadTest
3fe0: 44 61 74 61 20 64 5b 32 5d 3b 0a 20 20 70 74 68  Data d[2];.  pth
3ff0: 72 65 61 64 5f 74 20 74 5b 32 5d 3b 0a 0a 20 20  read_t t[2];..  
4000: 66 64 20 3d 20 64 75 70 28 66 64 5f 6f 72 69 67  fd = dup(fd_orig
4010: 29 3b 0a 20 20 69 66 28 20 66 64 3c 30 20 29 20  );.  if( fd<0 ) 
4020: 72 65 74 75 72 6e 3b 0a 20 20 6d 65 6d 73 65 74  return;.  memset
4030: 28 64 2c 20 30 2c 20 73 69 7a 65 6f 66 28 64 29  (d, 0, sizeof(d)
4040: 29 3b 0a 20 20 64 5b 30 5d 2e 66 64 20 3d 20 66  );.  d[0].fd = f
4050: 64 3b 0a 20 20 64 5b 30 5d 2e 6c 6f 63 6b 2e 6c  d;.  d[0].lock.l
4060: 5f 74 79 70 65 20 3d 20 46 5f 52 44 4c 43 4b 3b  _type = F_RDLCK;
4070: 0a 20 20 64 5b 30 5d 2e 6c 6f 63 6b 2e 6c 5f 6c  .  d[0].lock.l_l
4080: 65 6e 20 3d 20 31 3b 0a 20 20 64 5b 30 5d 2e 6c  en = 1;.  d[0].l
4090: 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 30 3b  ock.l_start = 0;
40a0: 0a 20 20 64 5b 30 5d 2e 6c 6f 63 6b 2e 6c 5f 77  .  d[0].lock.l_w
40b0: 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54  hence = SEEK_SET
40c0: 3b 0a 20 20 64 5b 31 5d 20 3d 20 64 5b 30 5d 3b  ;.  d[1] = d[0];
40d0: 0a 20 20 64 5b 31 5d 2e 6c 6f 63 6b 2e 6c 5f 74  .  d[1].lock.l_t
40e0: 79 70 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20  ype = F_WRLCK;. 
40f0: 20 70 74 68 72 65 61 64 5f 63 72 65 61 74 65 28   pthread_create(
4100: 26 74 5b 30 5d 2c 20 30 2c 20 74 68 72 65 61 64  &t[0], 0, thread
4110: 4c 6f 63 6b 69 6e 67 54 65 73 74 2c 20 26 64 5b  LockingTest, &d[
4120: 30 5d 29 3b 0a 20 20 70 74 68 72 65 61 64 5f 63  0]);.  pthread_c
4130: 72 65 61 74 65 28 26 74 5b 31 5d 2c 20 30 2c 20  reate(&t[1], 0, 
4140: 74 68 72 65 61 64 4c 6f 63 6b 69 6e 67 54 65 73  threadLockingTes
4150: 74 2c 20 26 64 5b 31 5d 29 3b 0a 20 20 70 74 68  t, &d[1]);.  pth
4160: 72 65 61 64 5f 6a 6f 69 6e 28 74 5b 30 5d 2c 20  read_join(t[0], 
4170: 30 29 3b 0a 20 20 70 74 68 72 65 61 64 5f 6a 6f  0);.  pthread_jo
4180: 69 6e 28 74 5b 31 5d 2c 20 30 29 3b 0a 20 20 63  in(t[1], 0);.  c
4190: 6c 6f 73 65 28 66 64 29 3b 0a 20 20 74 68 72 65  lose(fd);.  thre
41a0: 61 64 73 4f 76 65 72 72 69 64 65 45 61 63 68 4f  adsOverrideEachO
41b0: 74 68 65 72 73 4c 6f 63 6b 73 20 3d 20 20 64 5b  thersLocks =  d[
41c0: 30 5d 2e 72 65 73 75 6c 74 3d 3d 30 20 26 26 20  0].result==0 && 
41d0: 64 5b 31 5d 2e 72 65 73 75 6c 74 3d 3d 30 3b 0a  d[1].result==0;.
41e0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
41f0: 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 20  TE_UNIX_THREADS 
4200: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73  */../*.** Releas
4210: 65 20 61 20 6c 6f 63 6b 49 6e 66 6f 20 73 74 72  e a lockInfo str
4220: 75 63 74 75 72 65 20 70 72 65 76 69 6f 75 73 6c  ucture previousl
4230: 79 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 66  y allocated by f
4240: 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 29 2e 0a 2a  indLockInfo()..*
4250: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65  /.static void re
4260: 6c 65 61 73 65 4c 6f 63 6b 49 6e 66 6f 28 73 74  leaseLockInfo(st
4270: 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70  ruct lockInfo *p
4280: 4c 6f 63 6b 29 7b 0a 20 20 61 73 73 65 72 74 28  Lock){.  assert(
4290: 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65   sqlite3OsInMute
42a0: 78 28 29 20 29 3b 0a 20 20 70 4c 6f 63 6b 2d 3e  x() );.  pLock->
42b0: 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 4c  nRef--;.  if( pL
42c0: 6f 63 6b 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a  ock->nRef==0 ){.
42d0: 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68 49      sqlite3HashI
42e0: 6e 73 65 72 74 28 26 6c 6f 63 6b 48 61 73 68 2c  nsert(&lockHash,
42f0: 20 26 70 4c 6f 63 6b 2d 3e 6b 65 79 2c 20 73 69   &pLock->key, si
4300: 7a 65 6f 66 28 70 4c 6f 63 6b 2d 3e 6b 65 79 29  zeof(pLock->key)
4310: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
4320: 46 72 65 65 28 70 4c 6f 63 6b 29 3b 0a 20 20 7d  Free(pLock);.  }
4330: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73  .}../*.** Releas
4340: 65 20 61 20 6f 70 65 6e 43 6e 74 20 73 74 72 75  e a openCnt stru
4350: 63 74 75 72 65 20 70 72 65 76 69 6f 75 73 6c 79  cture previously
4360: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 66 69   allocated by fi
4370: 6e 64 4c 6f 63 6b 49 6e 66 6f 28 29 2e 0a 2a 2f  ndLockInfo()..*/
4380: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c  .static void rel
4390: 65 61 73 65 4f 70 65 6e 43 6e 74 28 73 74 72 75  easeOpenCnt(stru
43a0: 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 70 65  ct openCnt *pOpe
43b0: 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  n){.  assert( sq
43c0: 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65 78 28 29  lite3OsInMutex()
43d0: 20 29 3b 0a 20 20 70 4f 70 65 6e 2d 3e 6e 52 65   );.  pOpen->nRe
43e0: 66 2d 2d 3b 0a 20 20 69 66 28 20 70 4f 70 65 6e  f--;.  if( pOpen
43f0: 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20  ->nRef==0 ){.   
4400: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 73 65   sqlite3HashInse
4410: 72 74 28 26 6f 70 65 6e 48 61 73 68 2c 20 26 70  rt(&openHash, &p
4420: 4f 70 65 6e 2d 3e 6b 65 79 2c 20 73 69 7a 65 6f  Open->key, sizeo
4430: 66 28 70 4f 70 65 6e 2d 3e 6b 65 79 29 2c 20 30  f(pOpen->key), 0
4440: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65  );.    sqliteFre
4450: 65 28 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e  e(pOpen->aPendin
4460: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72  g);.    sqliteFr
4470: 65 65 28 70 4f 70 65 6e 29 3b 0a 20 20 7d 0a 7d  ee(pOpen);.  }.}
4480: 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20  ../*.** Given a 
4490: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2c  file descriptor,
44a0: 20 6c 6f 63 61 74 65 20 6c 6f 63 6b 49 6e 66 6f   locate lockInfo
44b0: 20 61 6e 64 20 6f 70 65 6e 43 6e 74 20 73 74 72   and openCnt str
44c0: 75 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a 20  uctures that.** 
44d0: 64 65 73 63 72 69 62 65 73 20 74 68 61 74 20 66  describes that f
44e0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 20  ile descriptor. 
44f0: 20 43 72 65 61 74 65 20 6e 65 77 20 6f 6e 65 73   Create new ones
4500: 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 20 20   if necessary.  
4510: 54 68 65 0a 2a 2a 20 72 65 74 75 72 6e 20 76 61  The.** return va
4520: 6c 75 65 73 20 6d 69 67 68 74 20 62 65 20 75 6e  lues might be un
4530: 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 66 20 61  initialized if a
4540: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a  n error occurs..
4550: 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  **.** Return the
4560: 20 6e 75 6d 62 65 72 20 6f 66 20 65 72 72 6f 72   number of error
4570: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  s..*/.static int
4580: 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 0a 20   findLockInfo(. 
4590: 20 69 6e 74 20 66 64 2c 20 20 20 20 20 20 20 20   int fd,        
45a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
45b0: 20 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69   The file descri
45c0: 70 74 6f 72 20 75 73 65 64 20 69 6e 20 74 68 65  ptor used in the
45d0: 20 6b 65 79 20 2a 2f 0a 20 20 73 74 72 75 63 74   key */.  struct
45e0: 20 6c 6f 63 6b 49 6e 66 6f 20 2a 2a 70 70 4c 6f   lockInfo **ppLo
45f0: 63 6b 2c 20 20 20 20 2f 2a 20 52 65 74 75 72 6e  ck,    /* Return
4600: 20 74 68 65 20 6c 6f 63 6b 49 6e 66 6f 20 73 74   the lockInfo st
4610: 72 75 63 74 75 72 65 20 68 65 72 65 20 2a 2f 0a  ructure here */.
4620: 20 20 73 74 72 75 63 74 20 6f 70 65 6e 43 6e 74    struct openCnt
4630: 20 2a 2a 70 70 4f 70 65 6e 20 20 20 20 20 20 2f   **ppOpen      /
4640: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f 70 65  * Return the ope
4650: 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65 20 68  nCnt structure h
4660: 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  ere */.){.  int 
4670: 72 63 3b 0a 20 20 73 74 72 75 63 74 20 6c 6f 63  rc;.  struct loc
4680: 6b 4b 65 79 20 6b 65 79 31 3b 0a 20 20 73 74 72  kKey key1;.  str
4690: 75 63 74 20 6f 70 65 6e 4b 65 79 20 6b 65 79 32  uct openKey key2
46a0: 3b 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 20  ;.  struct stat 
46b0: 73 74 61 74 62 75 66 3b 0a 20 20 73 74 72 75 63  statbuf;.  struc
46c0: 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70 4c 6f 63  t lockInfo *pLoc
46d0: 6b 3b 0a 20 20 73 74 72 75 63 74 20 6f 70 65 6e  k;.  struct open
46e0: 43 6e 74 20 2a 70 4f 70 65 6e 3b 0a 20 20 72 63  Cnt *pOpen;.  rc
46f0: 20 3d 20 66 73 74 61 74 28 66 64 2c 20 26 73 74   = fstat(fd, &st
4700: 61 74 62 75 66 29 3b 0a 20 20 69 66 28 20 72 63  atbuf);.  if( rc
4710: 21 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  !=0 ) return 1;.
4720: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
4730: 65 33 4f 73 49 6e 4d 75 74 65 78 28 29 20 29 3b  e3OsInMutex() );
4740: 0a 20 20 6d 65 6d 73 65 74 28 26 6b 65 79 31 2c  .  memset(&key1,
4750: 20 30 2c 20 73 69 7a 65 6f 66 28 6b 65 79 31 29   0, sizeof(key1)
4760: 29 3b 0a 20 20 6b 65 79 31 2e 64 65 76 20 3d 20  );.  key1.dev = 
4770: 73 74 61 74 62 75 66 2e 73 74 5f 64 65 76 3b 0a  statbuf.st_dev;.
4780: 20 20 6b 65 79 31 2e 69 6e 6f 20 3d 20 73 74 61    key1.ino = sta
4790: 74 62 75 66 2e 73 74 5f 69 6e 6f 3b 0a 23 69 66  tbuf.st_ino;.#if
47a0: 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f  def SQLITE_UNIX_
47b0: 54 48 52 45 41 44 53 0a 20 20 69 66 28 20 74 68  THREADS.  if( th
47c0: 72 65 61 64 73 4f 76 65 72 72 69 64 65 45 61 63  readsOverrideEac
47d0: 68 4f 74 68 65 72 73 4c 6f 63 6b 73 3c 30 20 29  hOthersLocks<0 )
47e0: 7b 0a 20 20 20 20 74 65 73 74 54 68 72 65 61 64  {.    testThread
47f0: 4c 6f 63 6b 69 6e 67 42 65 68 61 76 69 6f 72 28  LockingBehavior(
4800: 66 64 29 3b 0a 20 20 7d 0a 20 20 6b 65 79 31 2e  fd);.  }.  key1.
4810: 74 69 64 20 3d 20 74 68 72 65 61 64 73 4f 76 65  tid = threadsOve
4820: 72 72 69 64 65 45 61 63 68 4f 74 68 65 72 73 4c  rrideEachOthersL
4830: 6f 63 6b 73 20 3f 20 30 20 3a 20 70 74 68 72 65  ocks ? 0 : pthre
4840: 61 64 5f 73 65 6c 66 28 29 3b 0a 23 65 6e 64 69  ad_self();.#endi
4850: 66 0a 20 20 6d 65 6d 73 65 74 28 26 6b 65 79 32  f.  memset(&key2
4860: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6b 65 79 32  , 0, sizeof(key2
4870: 29 29 3b 0a 20 20 6b 65 79 32 2e 64 65 76 20 3d  ));.  key2.dev =
4880: 20 73 74 61 74 62 75 66 2e 73 74 5f 64 65 76 3b   statbuf.st_dev;
4890: 0a 20 20 6b 65 79 32 2e 69 6e 6f 20 3d 20 73 74  .  key2.ino = st
48a0: 61 74 62 75 66 2e 73 74 5f 69 6e 6f 3b 0a 20 20  atbuf.st_ino;.  
48b0: 70 4c 6f 63 6b 20 3d 20 28 73 74 72 75 63 74 20  pLock = (struct 
48c0: 6c 6f 63 6b 49 6e 66 6f 2a 29 73 71 6c 69 74 65  lockInfo*)sqlite
48d0: 33 48 61 73 68 46 69 6e 64 28 26 6c 6f 63 6b 48  3HashFind(&lockH
48e0: 61 73 68 2c 20 26 6b 65 79 31 2c 20 73 69 7a 65  ash, &key1, size
48f0: 6f 66 28 6b 65 79 31 29 29 3b 0a 20 20 69 66 28  of(key1));.  if(
4900: 20 70 4c 6f 63 6b 3d 3d 30 20 29 7b 0a 20 20 20   pLock==0 ){.   
4910: 20 73 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f   struct lockInfo
4920: 20 2a 70 4f 6c 64 3b 0a 20 20 20 20 70 4c 6f 63   *pOld;.    pLoc
4930: 6b 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  k = sqliteMalloc
4940: 52 61 77 28 20 73 69 7a 65 6f 66 28 2a 70 4c 6f  Raw( sizeof(*pLo
4950: 63 6b 29 20 29 3b 0a 20 20 20 20 69 66 28 20 70  ck) );.    if( p
4960: 4c 6f 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 20  Lock==0 ){.     
4970: 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 67   rc = 1;.      g
4980: 6f 74 6f 20 65 78 69 74 5f 66 69 6e 64 6c 6f 63  oto exit_findloc
4990: 6b 69 6e 66 6f 3b 0a 20 20 20 20 7d 0a 20 20 20  kinfo;.    }.   
49a0: 20 70 4c 6f 63 6b 2d 3e 6b 65 79 20 3d 20 6b 65   pLock->key = ke
49b0: 79 31 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 6e  y1;.    pLock->n
49c0: 52 65 66 20 3d 20 31 3b 0a 20 20 20 20 70 4c 6f  Ref = 1;.    pLo
49d0: 63 6b 2d 3e 63 6e 74 20 3d 20 30 3b 0a 20 20 20  ck->cnt = 0;.   
49e0: 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65   pLock->locktype
49f0: 20 3d 20 30 3b 0a 20 20 20 20 70 4f 6c 64 20 3d   = 0;.    pOld =
4a00: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 73 65   sqlite3HashInse
4a10: 72 74 28 26 6c 6f 63 6b 48 61 73 68 2c 20 26 70  rt(&lockHash, &p
4a20: 4c 6f 63 6b 2d 3e 6b 65 79 2c 20 73 69 7a 65 6f  Lock->key, sizeo
4a30: 66 28 6b 65 79 31 29 2c 20 70 4c 6f 63 6b 29 3b  f(key1), pLock);
4a40: 0a 20 20 20 20 69 66 28 20 70 4f 6c 64 21 3d 30  .    if( pOld!=0
4a50: 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74   ){.      assert
4a60: 28 20 70 4f 6c 64 3d 3d 70 4c 6f 63 6b 20 29 3b  ( pOld==pLock );
4a70: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65  .      sqliteFre
4a80: 65 28 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 20 20  e(pLock);.      
4a90: 72 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 67 6f  rc = 1;.      go
4aa0: 74 6f 20 65 78 69 74 5f 66 69 6e 64 6c 6f 63 6b  to exit_findlock
4ab0: 69 6e 66 6f 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  info;.    }.  }e
4ac0: 6c 73 65 7b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e  lse{.    pLock->
4ad0: 6e 52 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70  nRef++;.  }.  *p
4ae0: 70 4c 6f 63 6b 20 3d 20 70 4c 6f 63 6b 3b 0a 20  pLock = pLock;. 
4af0: 20 69 66 28 20 70 70 4f 70 65 6e 21 3d 30 20 29   if( ppOpen!=0 )
4b00: 7b 0a 20 20 20 20 70 4f 70 65 6e 20 3d 20 28 73  {.    pOpen = (s
4b10: 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 2a 29 73  truct openCnt*)s
4b20: 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28 26  qlite3HashFind(&
4b30: 6f 70 65 6e 48 61 73 68 2c 20 26 6b 65 79 32 2c  openHash, &key2,
4b40: 20 73 69 7a 65 6f 66 28 6b 65 79 32 29 29 3b 0a   sizeof(key2));.
4b50: 20 20 20 20 69 66 28 20 70 4f 70 65 6e 3d 3d 30      if( pOpen==0
4b60: 20 29 7b 0a 20 20 20 20 20 20 73 74 72 75 63 74   ){.      struct
4b70: 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 6c 64 3b 0a   openCnt *pOld;.
4b80: 20 20 20 20 20 20 70 4f 70 65 6e 20 3d 20 73 71        pOpen = sq
4b90: 6c 69 74 65 4d 61 6c 6c 6f 63 52 61 77 28 20 73  liteMallocRaw( s
4ba0: 69 7a 65 6f 66 28 2a 70 4f 70 65 6e 29 20 29 3b  izeof(*pOpen) );
4bb0: 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70 65 6e  .      if( pOpen
4bc0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72  ==0 ){.        r
4bd0: 65 6c 65 61 73 65 4c 6f 63 6b 49 6e 66 6f 28 70  eleaseLockInfo(p
4be0: 4c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 20 20 72  Lock);.        r
4bf0: 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 67  c = 1;.        g
4c00: 6f 74 6f 20 65 78 69 74 5f 66 69 6e 64 6c 6f 63  oto exit_findloc
4c10: 6b 69 6e 66 6f 3b 0a 20 20 20 20 20 20 7d 0a 20  kinfo;.      }. 
4c20: 20 20 20 20 20 70 4f 70 65 6e 2d 3e 6b 65 79 20       pOpen->key 
4c30: 3d 20 6b 65 79 32 3b 0a 20 20 20 20 20 20 70 4f  = key2;.      pO
4c40: 70 65 6e 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20  pen->nRef = 1;. 
4c50: 20 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 4c 6f 63       pOpen->nLoc
4c60: 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 4f 70  k = 0;.      pOp
4c70: 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67 20 3d 20 30  en->nPending = 0
4c80: 3b 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e 61  ;.      pOpen->a
4c90: 50 65 6e 64 69 6e 67 20 3d 20 30 3b 0a 20 20 20  Pending = 0;.   
4ca0: 20 20 20 70 4f 6c 64 20 3d 20 73 71 6c 69 74 65     pOld = sqlite
4cb0: 33 48 61 73 68 49 6e 73 65 72 74 28 26 6f 70 65  3HashInsert(&ope
4cc0: 6e 48 61 73 68 2c 20 26 70 4f 70 65 6e 2d 3e 6b  nHash, &pOpen->k
4cd0: 65 79 2c 20 73 69 7a 65 6f 66 28 6b 65 79 32 29  ey, sizeof(key2)
4ce0: 2c 20 70 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20  , pOpen);.      
4cf0: 69 66 28 20 70 4f 6c 64 21 3d 30 20 29 7b 0a 20  if( pOld!=0 ){. 
4d00: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70         assert( p
4d10: 4f 6c 64 3d 3d 70 4f 70 65 6e 20 29 3b 0a 20 20  Old==pOpen );.  
4d20: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
4d30: 28 70 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 20  (pOpen);.       
4d40: 20 72 65 6c 65 61 73 65 4c 6f 63 6b 49 6e 66 6f   releaseLockInfo
4d50: 28 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 20  (pLock);.       
4d60: 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 20   rc = 1;.       
4d70: 20 67 6f 74 6f 20 65 78 69 74 5f 66 69 6e 64 6c   goto exit_findl
4d80: 6f 63 6b 69 6e 66 6f 3b 0a 20 20 20 20 20 20 7d  ockinfo;.      }
4d90: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
4da0: 20 20 70 4f 70 65 6e 2d 3e 6e 52 65 66 2b 2b 3b    pOpen->nRef++;
4db0: 0a 20 20 20 20 7d 0a 20 20 20 20 2a 70 70 4f 70  .    }.    *ppOp
4dc0: 65 6e 20 3d 20 70 4f 70 65 6e 3b 0a 20 20 7d 0a  en = pOpen;.  }.
4dd0: 0a 65 78 69 74 5f 66 69 6e 64 6c 6f 63 6b 69 6e  .exit_findlockin
4de0: 66 6f 3a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  fo:.  return rc;
4df0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77 65 20  .}../*.** If we 
4e00: 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 69 6e  are currently in
4e10: 20 61 20 64 69 66 66 65 72 65 6e 74 20 74 68 72   a different thr
4e20: 65 61 64 20 74 68 61 6e 20 74 68 65 20 74 68 72  ead than the thr
4e30: 65 61 64 20 74 68 61 74 20 74 68 65 0a 2a 2a 20  ead that the.** 
4e40: 75 6e 69 78 46 69 6c 65 20 61 72 67 75 6d 65 6e  unixFile argumen
4e50: 74 20 62 65 6c 6f 6e 67 73 20 74 6f 2c 20 74 68  t belongs to, th
4e60: 65 6e 20 74 72 61 6e 73 66 65 72 20 6f 77 6e 65  en transfer owne
4e70: 72 73 68 69 70 20 6f 66 20 74 68 65 20 75 6e 69  rship of the uni
4e80: 78 46 69 6c 65 0a 2a 2a 20 6f 76 65 72 20 74 6f  xFile.** over to
4e90: 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 72   the current thr
4ea0: 65 61 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 75 6e 69  ead..**.** A uni
4eb0: 78 46 69 6c 65 20 69 73 20 6f 6e 6c 79 20 6f 77  xFile is only ow
4ec0: 6e 65 64 20 62 79 20 61 20 74 68 72 65 61 64 20  ned by a thread 
4ed0: 6f 6e 20 73 79 73 74 65 6d 73 20 77 68 65 72 65  on systems where
4ee0: 20 6f 6e 65 20 74 68 72 65 61 64 20 69 73 0a 2a   one thread is.*
4ef0: 2a 20 75 6e 61 62 6c 65 20 74 6f 20 6f 76 65 72  * unable to over
4f00: 72 69 64 65 20 6c 6f 63 6b 73 20 63 72 65 61 74  ride locks creat
4f10: 65 64 20 62 79 20 61 20 64 69 66 66 65 72 65 6e  ed by a differen
4f20: 74 20 74 68 72 65 61 64 2e 20 20 52 65 64 48 61  t thread.  RedHa
4f30: 74 39 20 69 73 0a 2a 2a 20 61 6e 20 65 78 61 6d  t9 is.** an exam
4f40: 70 6c 65 20 6f 66 20 73 75 63 68 20 61 20 73 79  ple of such a sy
4f50: 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 4f 77 6e 65  stem..**.** Owne
4f60: 72 73 68 69 70 20 74 72 61 6e 73 66 65 72 20 69  rship transfer i
4f70: 73 20 6f 6e 6c 79 20 61 6c 6c 6f 77 65 64 20 69  s only allowed i
4f80: 66 20 74 68 65 20 75 6e 69 78 46 69 6c 65 20 69  f the unixFile i
4f90: 73 20 63 75 72 72 65 6e 74 6c 79 20 75 6e 6c 6f  s currently unlo
4fa0: 63 6b 65 64 2e 0a 2a 2a 20 49 66 20 74 68 65 20  cked..** If the 
4fb0: 75 6e 69 78 46 69 6c 65 20 69 73 20 6c 6f 63 6b  unixFile is lock
4fc0: 65 64 20 61 6e 64 20 61 6e 20 6f 77 6e 65 72 73  ed and an owners
4fd0: 68 69 70 20 69 73 20 77 72 6f 6e 67 2c 20 74 68  hip is wrong, th
4fe0: 65 6e 20 72 65 74 75 72 6e 0a 2a 2a 20 53 51 4c  en return.** SQL
4ff0: 49 54 45 5f 4d 49 53 55 53 45 2e 20 20 4f 74 68  ITE_MISUSE.  Oth
5000: 65 72 77 69 73 65 20 72 65 74 75 72 6e 20 53 51  erwise return SQ
5010: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 23 69 66 64  LITE_OK..*/.#ifd
5020: 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54  ef SQLITE_UNIX_T
5030: 48 52 45 41 44 53 0a 73 74 61 74 69 63 20 69 6e  HREADS.static in
5040: 74 20 74 72 61 6e 73 66 65 72 4f 77 6e 65 72 73  t transferOwners
5050: 68 69 70 28 75 6e 69 78 46 69 6c 65 20 2a 70 46  hip(unixFile *pF
5060: 69 6c 65 29 7b 0a 20 20 70 74 68 72 65 61 64 5f  ile){.  pthread_
5070: 74 20 68 53 65 6c 66 3b 0a 20 20 69 66 28 20 74  t hSelf;.  if( t
5080: 68 72 65 61 64 73 4f 76 65 72 72 69 64 65 45 61  hreadsOverrideEa
5090: 63 68 4f 74 68 65 72 73 4c 6f 63 6b 73 20 29 7b  chOthersLocks ){
50a0: 0a 20 20 20 20 2f 2a 20 4f 77 6e 65 72 73 68 69  .    /* Ownershi
50b0: 70 20 74 72 61 6e 73 66 65 72 73 20 6e 6f 74 20  p transfers not 
50c0: 6e 65 65 64 65 64 20 6f 6e 20 74 68 69 73 20 73  needed on this s
50d0: 79 73 74 65 6d 20 2a 2f 0a 20 20 20 20 72 65 74  ystem */.    ret
50e0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
50f0: 20 7d 0a 20 20 68 53 65 6c 66 20 3d 20 70 74 68   }.  hSelf = pth
5100: 72 65 61 64 5f 73 65 6c 66 28 29 3b 0a 20 20 69  read_self();.  i
5110: 66 28 20 70 74 68 72 65 61 64 5f 65 71 75 61 6c  f( pthread_equal
5120: 28 70 46 69 6c 65 2d 3e 74 69 64 2c 20 68 53 65  (pFile->tid, hSe
5130: 6c 66 29 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65  lf) ){.    /* We
5140: 20 61 72 65 20 73 74 69 6c 6c 20 69 6e 20 74 68   are still in th
5150: 65 20 73 61 6d 65 20 74 68 72 65 61 64 20 2a 2f  e same thread */
5160: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
5170: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28  TE_OK;.  }.  if(
5180: 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65   pFile->locktype
5190: 21 3d 4e 4f 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20  !=NO_LOCK ){.   
51a0: 20 2f 2a 20 57 65 20 63 61 6e 6e 6f 74 20 63 68   /* We cannot ch
51b0: 61 6e 67 65 20 6f 77 6e 65 72 73 68 69 70 20 77  ange ownership w
51c0: 68 69 6c 65 20 77 65 20 61 72 65 20 68 6f 6c 64  hile we are hold
51d0: 69 6e 67 20 61 20 6c 6f 63 6b 21 20 2a 2f 0a 20  ing a lock! */. 
51e0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
51f0: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 70  _MISUSE;.  }.  p
5200: 46 69 6c 65 2d 3e 74 69 64 20 3d 20 68 53 65 6c  File->tid = hSel
5210: 66 3b 0a 20 20 72 65 6c 65 61 73 65 4c 6f 63 6b  f;.  releaseLock
5220: 49 6e 66 6f 28 70 46 69 6c 65 2d 3e 70 4c 6f 63  Info(pFile->pLoc
5230: 6b 29 3b 0a 20 20 72 65 74 75 72 6e 20 66 69 6e  k);.  return fin
5240: 64 4c 6f 63 6b 49 6e 66 6f 28 70 46 69 6c 65 2d  dLockInfo(pFile-
5250: 3e 68 2c 20 26 70 46 69 6c 65 2d 3e 70 4c 6f 63  >h, &pFile->pLoc
5260: 6b 2c 20 30 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23  k, 0);.}.#else.#
5270: 20 64 65 66 69 6e 65 20 74 72 61 6e 73 66 65 72   define transfer
5280: 4f 77 6e 65 72 73 68 69 70 28 58 29 20 53 51 4c  Ownership(X) SQL
5290: 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 2f  ITE_OK.#endif../
52a0: 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 74 68 65 20  *.** Delete the 
52b0: 6e 61 6d 65 64 20 66 69 6c 65 0a 2a 2f 0a 69 6e  named file.*/.in
52c0: 74 20 73 71 6c 69 74 65 33 55 6e 69 78 44 65 6c  t sqlite3UnixDel
52d0: 65 74 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  ete(const char *
52e0: 7a 46 69 6c 65 6e 61 6d 65 29 7b 0a 20 20 75 6e  zFilename){.  un
52f0: 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b  link(zFilename);
5300: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
5310: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  _OK;.}../*.** Re
5320: 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65  turn TRUE if the
5330: 20 6e 61 6d 65 64 20 66 69 6c 65 20 65 78 69 73   named file exis
5340: 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ts..*/.int sqlit
5350: 65 33 55 6e 69 78 46 69 6c 65 45 78 69 73 74 73  e3UnixFileExists
5360: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
5370: 6c 65 6e 61 6d 65 29 7b 0a 20 20 72 65 74 75 72  lename){.  retur
5380: 6e 20 61 63 63 65 73 73 28 7a 46 69 6c 65 6e 61  n access(zFilena
5390: 6d 65 2c 20 30 29 3d 3d 30 3b 0a 7d 0a 0a 2f 2a  me, 0)==0;.}../*
53a0: 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61   Forward declara
53b0: 74 69 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 69  tion */.static i
53c0: 6e 74 20 61 6c 6c 6f 63 61 74 65 55 6e 69 78 46  nt allocateUnixF
53d0: 69 6c 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 49  ile(unixFile *pI
53e0: 6e 69 74 2c 20 4f 73 46 69 6c 65 20 2a 2a 70 49  nit, OsFile **pI
53f0: 64 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  d);../*.** Attem
5400: 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 66 69 6c  pt to open a fil
5410: 65 20 66 6f 72 20 62 6f 74 68 20 72 65 61 64 69  e for both readi
5420: 6e 67 20 61 6e 64 20 77 72 69 74 69 6e 67 2e 20  ng and writing. 
5430: 20 49 66 20 74 68 61 74 0a 2a 2a 20 66 61 69 6c   If that.** fail
5440: 73 2c 20 74 72 79 20 6f 70 65 6e 69 6e 67 20 69  s, try opening i
5450: 74 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 20 49 66  t read-only.  If
5460: 20 74 68 65 20 66 69 6c 65 20 64 6f 65 73 20 6e   the file does n
5470: 6f 74 20 65 78 69 73 74 2c 0a 2a 2a 20 74 72 79  ot exist,.** try
5480: 20 74 6f 20 63 72 65 61 74 65 20 69 74 2e 0a 2a   to create it..*
5490: 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 65 73 73 2c  *.** On success,
54a0: 20 61 20 68 61 6e 64 6c 65 20 66 6f 72 20 74 68   a handle for th
54b0: 65 20 6f 70 65 6e 20 66 69 6c 65 20 69 73 20 77  e open file is w
54c0: 72 69 74 74 65 6e 20 74 6f 20 2a 69 64 0a 2a 2a  ritten to *id.**
54d0: 20 61 6e 64 20 2a 70 52 65 61 64 6f 6e 6c 79 20   and *pReadonly 
54e0: 69 73 20 73 65 74 20 74 6f 20 30 20 69 66 20 74  is set to 0 if t
54f0: 68 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 6e  he file was open
5500: 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 61  ed for reading a
5510: 6e 64 0a 2a 2a 20 77 72 69 74 69 6e 67 20 6f 72  nd.** writing or
5520: 20 31 20 69 66 20 74 68 65 20 66 69 6c 65 20 77   1 if the file w
5530: 61 73 20 6f 70 65 6e 65 64 20 72 65 61 64 2d 6f  as opened read-o
5540: 6e 6c 79 2e 20 20 54 68 65 20 66 75 6e 63 74 69  nly.  The functi
5550: 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 53 51  on returns.** SQ
5560: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 4f  LITE_OK..**.** O
5570: 6e 20 66 61 69 6c 75 72 65 2c 20 74 68 65 20 66  n failure, the f
5580: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20  unction returns 
5590: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20  SQLITE_CANTOPEN 
55a0: 61 6e 64 20 6c 65 61 76 65 73 0a 2a 2a 20 2a 69  and leaves.** *i
55b0: 64 20 61 6e 64 20 2a 70 52 65 61 64 6f 6e 6c 79  d and *pReadonly
55c0: 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69   unchanged..*/.i
55d0: 6e 74 20 73 71 6c 69 74 65 33 55 6e 69 78 4f 70  nt sqlite3UnixOp
55e0: 65 6e 52 65 61 64 57 72 69 74 65 28 0a 20 20 63  enReadWrite(.  c
55f0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
5600: 6e 61 6d 65 2c 0a 20 20 4f 73 46 69 6c 65 20 2a  name,.  OsFile *
5610: 2a 70 49 64 2c 0a 20 20 69 6e 74 20 2a 70 52 65  *pId,.  int *pRe
5620: 61 64 6f 6e 6c 79 0a 29 7b 0a 20 20 69 6e 74 20  adonly.){.  int 
5630: 72 63 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 66  rc;.  unixFile f
5640: 3b 0a 0a 20 20 43 52 41 53 48 5f 54 45 53 54 5f  ;..  CRASH_TEST_
5650: 4f 56 45 52 52 49 44 45 28 73 71 6c 69 74 65 33  OVERRIDE(sqlite3
5660: 43 72 61 73 68 4f 70 65 6e 52 65 61 64 57 72 69  CrashOpenReadWri
5670: 74 65 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 70  te, zFilename, p
5680: 49 64 2c 20 70 52 65 61 64 6f 6e 6c 79 29 3b 0a  Id, pReadonly);.
5690: 20 20 61 73 73 65 72 74 28 20 30 3d 3d 2a 70 49    assert( 0==*pI
56a0: 64 20 29 3b 0a 20 20 66 2e 64 69 72 66 64 20 3d  d );.  f.dirfd =
56b0: 20 2d 31 3b 0a 20 20 53 45 54 5f 54 48 52 45 41   -1;.  SET_THREA
56c0: 44 49 44 28 26 66 29 3b 0a 20 20 66 2e 68 20 3d  DID(&f);.  f.h =
56d0: 20 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c   open(zFilename,
56e0: 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54 7c   O_RDWR|O_CREAT|
56f0: 4f 5f 4c 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49  O_LARGEFILE|O_BI
5700: 4e 41 52 59 2c 0a 20 20 20 20 20 20 20 20 20 20  NARY,.          
5710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5720: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46  SQLITE_DEFAULT_F
5730: 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 29  ILE_PERMISSIONS)
5740: 3b 0a 20 20 69 66 28 20 66 2e 68 3c 30 20 29 7b  ;.  if( f.h<0 ){
5750: 0a 23 69 66 64 65 66 20 45 49 53 44 49 52 0a 20  .#ifdef EISDIR. 
5760: 20 20 20 69 66 28 20 65 72 72 6e 6f 3d 3d 45 49     if( errno==EI
5770: 53 44 49 52 20 29 7b 0a 20 20 20 20 20 20 72 65  SDIR ){.      re
5780: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54  turn SQLITE_CANT
5790: 4f 50 45 4e 3b 0a 20 20 20 20 7d 0a 23 65 6e 64  OPEN;.    }.#end
57a0: 69 66 0a 20 20 20 20 66 2e 68 20 3d 20 6f 70 65  if.    f.h = ope
57b0: 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52  n(zFilename, O_R
57c0: 44 4f 4e 4c 59 7c 4f 5f 4c 41 52 47 45 46 49 4c  DONLY|O_LARGEFIL
57d0: 45 7c 4f 5f 42 49 4e 41 52 59 29 3b 0a 20 20 20  E|O_BINARY);.   
57e0: 20 69 66 28 20 66 2e 68 3c 30 20 29 7b 0a 20 20   if( f.h<0 ){.  
57f0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
5800: 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a 20 20 20  E_CANTOPEN; .   
5810: 20 7d 0a 20 20 20 20 2a 70 52 65 61 64 6f 6e 6c   }.    *pReadonl
5820: 79 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a  y = 1;.  }else{.
5830: 20 20 20 20 2a 70 52 65 61 64 6f 6e 6c 79 20 3d      *pReadonly =
5840: 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65   0;.  }.  sqlite
5850: 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  3OsEnterMutex();
5860: 0a 20 20 72 63 20 3d 20 66 69 6e 64 4c 6f 63 6b  .  rc = findLock
5870: 49 6e 66 6f 28 66 2e 68 2c 20 26 66 2e 70 4c 6f  Info(f.h, &f.pLo
5880: 63 6b 2c 20 26 66 2e 70 4f 70 65 6e 29 3b 0a 20  ck, &f.pOpen);. 
5890: 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d   sqlite3OsLeaveM
58a0: 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20 72 63  utex();.  if( rc
58b0: 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28 66 2e   ){.    close(f.
58c0: 68 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  h);.    return S
58d0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d  QLITE_NOMEM;.  }
58e0: 0a 20 20 66 2e 6c 6f 63 6b 74 79 70 65 20 3d 20  .  f.locktype = 
58f0: 30 3b 0a 20 20 54 52 41 43 45 33 28 22 4f 50 45  0;.  TRACE3("OPE
5900: 4e 20 20 20 20 25 2d 33 64 20 25 73 5c 6e 22 2c  N    %-3d %s\n",
5910: 20 66 2e 68 2c 20 7a 46 69 6c 65 6e 61 6d 65 29   f.h, zFilename)
5920: 3b 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c 6f 63  ;.  return alloc
5930: 61 74 65 55 6e 69 78 46 69 6c 65 28 26 66 2c 20  ateUnixFile(&f, 
5940: 70 49 64 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  pId);.}.../*.** 
5950: 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20  Attempt to open 
5960: 61 20 6e 65 77 20 66 69 6c 65 20 66 6f 72 20 65  a new file for e
5970: 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20  xclusive access 
5980: 62 79 20 74 68 69 73 20 70 72 6f 63 65 73 73 2e  by this process.
5990: 0a 2a 2a 20 54 68 65 20 66 69 6c 65 20 77 69 6c  .** The file wil
59a0: 6c 20 62 65 20 6f 70 65 6e 65 64 20 66 6f 72 20  l be opened for 
59b0: 62 6f 74 68 20 72 65 61 64 69 6e 67 20 61 6e 64  both reading and
59c0: 20 77 72 69 74 69 6e 67 2e 20 20 54 6f 20 61 76   writing.  To av
59d0: 6f 69 64 0a 2a 2a 20 61 20 70 6f 74 65 6e 74 69  oid.** a potenti
59e0: 61 6c 20 73 65 63 75 72 69 74 79 20 70 72 6f 62  al security prob
59f0: 6c 65 6d 2c 20 77 65 20 64 6f 20 6e 6f 74 20 61  lem, we do not a
5a00: 6c 6c 6f 77 20 74 68 65 20 66 69 6c 65 20 74 6f  llow the file to
5a10: 20 68 61 76 65 0a 2a 2a 20 70 72 65 76 69 6f 75   have.** previou
5a20: 73 6c 79 20 65 78 69 73 74 65 64 2e 20 20 4e 6f  sly existed.  No
5a30: 72 20 64 6f 20 77 65 20 61 6c 6c 6f 77 20 74 68  r do we allow th
5a40: 65 20 66 69 6c 65 20 74 6f 20 62 65 20 61 20 73  e file to be a s
5a50: 79 6d 62 6f 6c 69 63 0a 2a 2a 20 6c 69 6e 6b 2e  ymbolic.** link.
5a60: 0a 2a 2a 0a 2a 2a 20 49 66 20 64 65 6c 46 6c 61  .**.** If delFla
5a70: 67 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20  g is true, then 
5a80: 6d 61 6b 65 20 61 72 72 61 6e 67 65 6d 65 6e 74  make arrangement
5a90: 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c  s to automatical
5aa0: 6c 79 20 64 65 6c 65 74 65 0a 2a 2a 20 74 68 65  ly delete.** the
5ab0: 20 66 69 6c 65 20 77 68 65 6e 20 69 74 20 69 73   file when it is
5ac0: 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f   closed..**.** O
5ad0: 6e 20 73 75 63 63 65 73 73 2c 20 77 72 69 74 65  n success, write
5ae0: 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c 65   the file handle
5af0: 20 69 6e 74 6f 20 2a 69 64 20 61 6e 64 20 72 65   into *id and re
5b00: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a  turn SQLITE_OK..
5b10: 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65  **.** On failure
5b20: 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  , return SQLITE_
5b30: 43 41 4e 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74  CANTOPEN..*/.int
5b40: 20 73 71 6c 69 74 65 33 55 6e 69 78 4f 70 65 6e   sqlite3UnixOpen
5b50: 45 78 63 6c 75 73 69 76 65 28 63 6f 6e 73 74 20  Exclusive(const 
5b60: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c  char *zFilename,
5b70: 20 4f 73 46 69 6c 65 20 2a 2a 70 49 64 2c 20 69   OsFile **pId, i
5b80: 6e 74 20 64 65 6c 46 6c 61 67 29 7b 0a 20 20 69  nt delFlag){.  i
5b90: 6e 74 20 72 63 3b 0a 20 20 75 6e 69 78 46 69 6c  nt rc;.  unixFil
5ba0: 65 20 66 3b 0a 0a 20 20 43 52 41 53 48 5f 54 45  e f;..  CRASH_TE
5bb0: 53 54 5f 4f 56 45 52 52 49 44 45 28 73 71 6c 69  ST_OVERRIDE(sqli
5bc0: 74 65 33 43 72 61 73 68 4f 70 65 6e 45 78 63 6c  te3CrashOpenExcl
5bd0: 75 73 69 76 65 2c 20 7a 46 69 6c 65 6e 61 6d 65  usive, zFilename
5be0: 2c 20 70 49 64 2c 20 64 65 6c 46 6c 61 67 29 3b  , pId, delFlag);
5bf0: 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 2a 70  .  assert( 0==*p
5c00: 49 64 20 29 3b 0a 20 20 69 66 28 20 61 63 63 65  Id );.  if( acce
5c10: 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 29  ss(zFilename, 0)
5c20: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
5c30: 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45  n SQLITE_CANTOPE
5c40: 4e 3b 0a 20 20 7d 0a 20 20 53 45 54 5f 54 48 52  N;.  }.  SET_THR
5c50: 45 41 44 49 44 28 26 66 29 3b 0a 20 20 66 2e 64  EADID(&f);.  f.d
5c60: 69 72 66 64 20 3d 20 2d 31 3b 0a 20 20 66 2e 68  irfd = -1;.  f.h
5c70: 20 3d 20 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d   = open(zFilenam
5c80: 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  e,.             
5c90: 20 20 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41     O_RDWR|O_CREA
5ca0: 54 7c 4f 5f 45 58 43 4c 7c 4f 5f 4e 4f 46 4f 4c  T|O_EXCL|O_NOFOL
5cb0: 4c 4f 57 7c 4f 5f 4c 41 52 47 45 46 49 4c 45 7c  LOW|O_LARGEFILE|
5cc0: 4f 5f 42 49 4e 41 52 59 2c 0a 20 20 20 20 20 20  O_BINARY,.      
5cd0: 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45            SQLITE
5ce0: 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45  _DEFAULT_FILE_PE
5cf0: 52 4d 49 53 53 49 4f 4e 53 29 3b 0a 20 20 69 66  RMISSIONS);.  if
5d00: 28 20 66 2e 68 3c 30 20 29 7b 0a 20 20 20 20 72  ( f.h<0 ){.    r
5d10: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e  eturn SQLITE_CAN
5d20: 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20 20 73 71 6c  TOPEN;.  }.  sql
5d30: 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78  ite3OsEnterMutex
5d40: 28 29 3b 0a 20 20 72 63 20 3d 20 66 69 6e 64 4c  ();.  rc = findL
5d50: 6f 63 6b 49 6e 66 6f 28 66 2e 68 2c 20 26 66 2e  ockInfo(f.h, &f.
5d60: 70 4c 6f 63 6b 2c 20 26 66 2e 70 4f 70 65 6e 29  pLock, &f.pOpen)
5d70: 3b 0a 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61  ;.  sqlite3OsLea
5d80: 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28  veMutex();.  if(
5d90: 20 72 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65   rc ){.    close
5da0: 28 66 2e 68 29 3b 0a 20 20 20 20 75 6e 6c 69 6e  (f.h);.    unlin
5db0: 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20  k(zFilename);.  
5dc0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5dd0: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 66 2e 6c  NOMEM;.  }.  f.l
5de0: 6f 63 6b 74 79 70 65 20 3d 20 30 3b 0a 20 20 69  ocktype = 0;.  i
5df0: 66 28 20 64 65 6c 46 6c 61 67 20 29 7b 0a 20 20  f( delFlag ){.  
5e00: 20 20 75 6e 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61    unlink(zFilena
5e10: 6d 65 29 3b 0a 20 20 7d 0a 20 20 54 52 41 43 45  me);.  }.  TRACE
5e20: 33 28 22 4f 50 45 4e 2d 45 58 20 25 2d 33 64 20  3("OPEN-EX %-3d 
5e30: 25 73 5c 6e 22 2c 20 66 2e 68 2c 20 7a 46 69 6c  %s\n", f.h, zFil
5e40: 65 6e 61 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e  ename);.  return
5e50: 20 61 6c 6c 6f 63 61 74 65 55 6e 69 78 46 69 6c   allocateUnixFil
5e60: 65 28 26 66 2c 20 70 49 64 29 3b 0a 7d 0a 0a 2f  e(&f, pId);.}../
5e70: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
5e80: 6f 70 65 6e 20 61 20 6e 65 77 20 66 69 6c 65 20  open a new file 
5e90: 66 6f 72 20 72 65 61 64 2d 6f 6e 6c 79 20 61 63  for read-only ac
5ea0: 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73  cess..**.** On s
5eb0: 75 63 63 65 73 73 2c 20 77 72 69 74 65 20 74 68  uccess, write th
5ec0: 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 69 6e  e file handle in
5ed0: 74 6f 20 2a 69 64 20 61 6e 64 20 72 65 74 75 72  to *id and retur
5ee0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a  n SQLITE_OK..**.
5ef0: 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65 2c 20 72  ** On failure, r
5f00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e  eturn SQLITE_CAN
5f10: 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74 20 73 71  TOPEN..*/.int sq
5f20: 6c 69 74 65 33 55 6e 69 78 4f 70 65 6e 52 65 61  lite3UnixOpenRea
5f30: 64 4f 6e 6c 79 28 63 6f 6e 73 74 20 63 68 61 72  dOnly(const char
5f40: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 73 46   *zFilename, OsF
5f50: 69 6c 65 20 2a 2a 70 49 64 29 7b 0a 20 20 69 6e  ile **pId){.  in
5f60: 74 20 72 63 3b 0a 20 20 75 6e 69 78 46 69 6c 65  t rc;.  unixFile
5f70: 20 66 3b 0a 0a 20 20 43 52 41 53 48 5f 54 45 53   f;..  CRASH_TES
5f80: 54 5f 4f 56 45 52 52 49 44 45 28 73 71 6c 69 74  T_OVERRIDE(sqlit
5f90: 65 33 43 72 61 73 68 4f 70 65 6e 52 65 61 64 4f  e3CrashOpenReadO
5fa0: 6e 6c 79 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20  nly, zFilename, 
5fb0: 70 49 64 2c 20 30 29 3b 0a 20 20 61 73 73 65 72  pId, 0);.  asser
5fc0: 74 28 20 30 3d 3d 2a 70 49 64 20 29 3b 0a 20 20  t( 0==*pId );.  
5fd0: 53 45 54 5f 54 48 52 45 41 44 49 44 28 26 66 29  SET_THREADID(&f)
5fe0: 3b 0a 20 20 66 2e 64 69 72 66 64 20 3d 20 2d 31  ;.  f.dirfd = -1
5ff0: 3b 0a 20 20 66 2e 68 20 3d 20 6f 70 65 6e 28 7a  ;.  f.h = open(z
6000: 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e  Filename, O_RDON
6010: 4c 59 7c 4f 5f 4c 41 52 47 45 46 49 4c 45 7c 4f  LY|O_LARGEFILE|O
6020: 5f 42 49 4e 41 52 59 29 3b 0a 20 20 69 66 28 20  _BINARY);.  if( 
6030: 66 2e 68 3c 30 20 29 7b 0a 20 20 20 20 72 65 74  f.h<0 ){.    ret
6040: 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  urn SQLITE_CANTO
6050: 50 45 4e 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  PEN;.  }.  sqlit
6060: 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29  e3OsEnterMutex()
6070: 3b 0a 20 20 72 63 20 3d 20 66 69 6e 64 4c 6f 63  ;.  rc = findLoc
6080: 6b 49 6e 66 6f 28 66 2e 68 2c 20 26 66 2e 70 4c  kInfo(f.h, &f.pL
6090: 6f 63 6b 2c 20 26 66 2e 70 4f 70 65 6e 29 3b 0a  ock, &f.pOpen);.
60a0: 20 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65    sqlite3OsLeave
60b0: 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20 72  Mutex();.  if( r
60c0: 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28 66  c ){.    close(f
60d0: 2e 68 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  .h);.    return 
60e0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
60f0: 7d 0a 20 20 66 2e 6c 6f 63 6b 74 79 70 65 20 3d  }.  f.locktype =
6100: 20 30 3b 0a 20 20 54 52 41 43 45 33 28 22 4f 50   0;.  TRACE3("OP
6110: 45 4e 2d 52 4f 20 25 2d 33 64 20 25 73 5c 6e 22  EN-RO %-3d %s\n"
6120: 2c 20 66 2e 68 2c 20 7a 46 69 6c 65 6e 61 6d 65  , f.h, zFilename
6130: 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c  );..  return all
6140: 6f 63 61 74 65 55 6e 69 78 46 69 6c 65 28 26 66  ocateUnixFile(&f
6150: 2c 20 70 49 64 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  , pId);.}../*.**
6160: 20 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e   Attempt to open
6170: 20 61 20 66 69 6c 65 20 64 65 73 63 72 69 70 74   a file descript
6180: 6f 72 20 66 6f 72 20 74 68 65 20 64 69 72 65 63  or for the direc
6190: 74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69  tory that contai
61a0: 6e 73 20 61 0a 2a 2a 20 66 69 6c 65 2e 20 20 54  ns a.** file.  T
61b0: 68 69 73 20 66 69 6c 65 20 64 65 73 63 72 69 70  his file descrip
61c0: 74 6f 72 20 63 61 6e 20 62 65 20 75 73 65 64 20  tor can be used 
61d0: 74 6f 20 66 73 79 6e 63 28 29 20 74 68 65 20 64  to fsync() the d
61e0: 69 72 65 63 74 6f 72 79 0a 2a 2a 20 69 6e 20 6f  irectory.** in o
61f0: 72 64 65 72 20 74 6f 20 6d 61 6b 65 20 73 75 72  rder to make sur
6200: 65 20 74 68 65 20 63 72 65 61 74 69 6f 6e 20 6f  e the creation o
6210: 66 20 61 20 6e 65 77 20 66 69 6c 65 20 69 73 20  f a new file is 
6220: 61 63 74 75 61 6c 6c 79 20 77 72 69 74 74 65 6e  actually written
6230: 0a 2a 2a 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a  .** to disk..**.
6240: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
6250: 69 73 20 6f 6e 6c 79 20 6d 65 61 6e 69 6e 67 66  is only meaningf
6260: 75 6c 20 66 6f 72 20 55 6e 69 78 2e 20 20 49 74  ul for Unix.  It
6270: 20 69 73 20 61 20 6e 6f 2d 6f 70 20 75 6e 64 65   is a no-op unde
6280: 72 0a 2a 2a 20 77 69 6e 64 6f 77 73 20 73 69 6e  r.** windows sin
6290: 63 65 20 77 69 6e 64 6f 77 73 20 64 6f 65 73 20  ce windows does 
62a0: 6e 6f 74 20 73 75 70 70 6f 72 74 20 68 61 72 64  not support hard
62b0: 20 6c 69 6e 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4f 6e   links..**.** On
62c0: 20 73 75 63 63 65 73 73 2c 20 61 20 68 61 6e 64   success, a hand
62d0: 6c 65 20 66 6f 72 20 61 20 70 72 65 76 69 6f 75  le for a previou
62e0: 73 6c 79 20 6f 70 65 6e 20 66 69 6c 65 20 61 74  sly open file at
62f0: 20 2a 69 64 20 69 73 0a 2a 2a 20 75 70 64 61 74   *id is.** updat
6300: 65 64 20 77 69 74 68 20 74 68 65 20 6e 65 77 20  ed with the new 
6310: 64 69 72 65 63 74 6f 72 79 20 66 69 6c 65 20 64  directory file d
6320: 65 73 63 72 69 70 74 6f 72 20 61 6e 64 20 53 51  escriptor and SQ
6330: 4c 49 54 45 5f 4f 4b 20 69 73 0a 2a 2a 20 72 65  LITE_OK is.** re
6340: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  turned..**.** On
6350: 20 66 61 69 6c 75 72 65 2c 20 74 68 65 20 66 75   failure, the fu
6360: 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 53  nction returns S
6370: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 61  QLITE_CANTOPEN a
6380: 6e 64 20 6c 65 61 76 65 73 0a 2a 2a 20 2a 69 64  nd leaves.** *id
6390: 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 73   unchanged..*/.s
63a0: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 4f 70  tatic int unixOp
63b0: 65 6e 44 69 72 65 63 74 6f 72 79 28 0a 20 20 4f  enDirectory(.  O
63c0: 73 46 69 6c 65 20 2a 69 64 2c 0a 20 20 63 6f 6e  sFile *id,.  con
63d0: 73 74 20 63 68 61 72 20 2a 7a 44 69 72 6e 61 6d  st char *zDirnam
63e0: 65 0a 29 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20  e.){.  unixFile 
63f0: 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69  *pFile = (unixFi
6400: 6c 65 2a 29 69 64 3b 0a 20 20 69 66 28 20 70 46  le*)id;.  if( pF
6410: 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a  ile==0 ){.    /*
6420: 20 44 6f 20 6e 6f 74 20 6f 70 65 6e 20 74 68 65   Do not open the
6430: 20 64 69 72 65 63 74 6f 72 79 20 69 66 20 74 68   directory if th
6440: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
6450: 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 6c 72 65  file is not alre
6460: 61 64 79 0a 20 20 20 20 2a 2a 20 6f 70 65 6e 2e  ady.    ** open.
6470: 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53   */.    return S
6480: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a  QLITE_CANTOPEN;.
6490: 20 20 7d 0a 20 20 53 45 54 5f 54 48 52 45 41 44    }.  SET_THREAD
64a0: 49 44 28 70 46 69 6c 65 29 3b 0a 20 20 61 73 73  ID(pFile);.  ass
64b0: 65 72 74 28 20 70 46 69 6c 65 2d 3e 64 69 72 66  ert( pFile->dirf
64c0: 64 3c 30 20 29 3b 0a 20 20 70 46 69 6c 65 2d 3e  d<0 );.  pFile->
64d0: 64 69 72 66 64 20 3d 20 6f 70 65 6e 28 7a 44 69  dirfd = open(zDi
64e0: 72 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 7c  rname, O_RDONLY|
64f0: 4f 5f 42 49 4e 41 52 59 2c 20 30 29 3b 0a 20 20  O_BINARY, 0);.  
6500: 69 66 28 20 70 46 69 6c 65 2d 3e 64 69 72 66 64  if( pFile->dirfd
6510: 3c 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  <0 ){.    return
6520: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e   SQLITE_CANTOPEN
6530: 3b 20 0a 20 20 7d 0a 20 20 54 52 41 43 45 33 28  ; .  }.  TRACE3(
6540: 22 4f 50 45 4e 44 49 52 20 25 2d 33 64 20 25 73  "OPENDIR %-3d %s
6550: 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 64 69 72 66  \n", pFile->dirf
6560: 64 2c 20 7a 44 69 72 6e 61 6d 65 29 3b 0a 20 20  d, zDirname);.  
6570: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
6580: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68  ;.}../*.** If th
6590: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62  e following glob
65a0: 61 6c 20 76 61 72 69 61 62 6c 65 20 70 6f 69 6e  al variable poin
65b0: 74 73 20 74 6f 20 61 20 73 74 72 69 6e 67 20 77  ts to a string w
65c0: 68 69 63 68 20 69 73 20 74 68 65 0a 2a 2a 20 6e  hich is the.** n
65d0: 61 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f  ame of a directo
65e0: 72 79 2c 20 74 68 65 6e 20 74 68 61 74 20 64 69  ry, then that di
65f0: 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20  rectory will be 
6600: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a  used to store.**
6610: 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73   temporary files
6620: 2e 0a 2a 2f 0a 63 68 61 72 20 2a 73 71 6c 69 74  ..*/.char *sqlit
6630: 65 33 5f 74 65 6d 70 5f 64 69 72 65 63 74 6f 72  e3_temp_director
6640: 79 20 3d 20 30 3b 0a 0a 2f 2a 0a 2a 2a 20 43 72  y = 0;../*.** Cr
6650: 65 61 74 65 20 61 20 74 65 6d 70 6f 72 61 72 79  eate a temporary
6660: 20 66 69 6c 65 20 6e 61 6d 65 20 69 6e 20 7a 42   file name in zB
6670: 75 66 2e 20 20 7a 42 75 66 20 6d 75 73 74 20 62  uf.  zBuf must b
6680: 65 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f 0a  e big enough to.
6690: 2a 2a 20 68 6f 6c 64 20 61 74 20 6c 65 61 73 74  ** hold at least
66a0: 20 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45   SQLITE_TEMPNAME
66b0: 5f 53 49 5a 45 20 63 68 61 72 61 63 74 65 72 73  _SIZE characters
66c0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
66d0: 55 6e 69 78 54 65 6d 70 46 69 6c 65 4e 61 6d 65  UnixTempFileName
66e0: 28 63 68 61 72 20 2a 7a 42 75 66 29 7b 0a 20 20  (char *zBuf){.  
66f0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61  static const cha
6700: 72 20 2a 61 7a 44 69 72 73 5b 5d 20 3d 20 7b 0a  r *azDirs[] = {.
6710: 20 20 20 20 20 30 2c 0a 20 20 20 20 20 22 2f 76       0,.     "/v
6720: 61 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f  ar/tmp",.     "/
6730: 75 73 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22  usr/tmp",.     "
6740: 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2e 22 2c  /tmp",.     ".",
6750: 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63  .  };.  static c
6760: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
6770: 61 72 20 7a 43 68 61 72 73 5b 5d 20 3d 0a 20 20  ar zChars[] =.  
6780: 20 20 22 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d    "abcdefghijklm
6790: 6e 6f 70 71 72 73 74 75 76 77 78 79 7a 22 0a 20  nopqrstuvwxyz". 
67a0: 20 20 20 22 41 42 43 44 45 46 47 48 49 4a 4b 4c     "ABCDEFGHIJKL
67b0: 4d 4e 4f 50 51 52 53 54 55 56 57 58 59 5a 22 0a  MNOPQRSTUVWXYZ".
67c0: 20 20 20 20 22 30 31 32 33 34 35 36 37 38 39 22      "0123456789"
67d0: 3b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20  ;.  int i, j;.  
67e0: 73 74 72 75 63 74 20 73 74 61 74 20 62 75 66 3b  struct stat buf;
67f0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
6800: 44 69 72 20 3d 20 22 2e 22 3b 0a 20 20 61 7a 44  Dir = ".";.  azD
6810: 69 72 73 5b 30 5d 20 3d 20 73 71 6c 69 74 65 33  irs[0] = sqlite3
6820: 5f 74 65 6d 70 5f 64 69 72 65 63 74 6f 72 79 3b  _temp_directory;
6830: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 73 69  .  for(i=0; i<si
6840: 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f 73 69 7a  zeof(azDirs)/siz
6850: 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d 29 3b 20  eof(azDirs[0]); 
6860: 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 61 7a  i++){.    if( az
6870: 44 69 72 73 5b 69 5d 3d 3d 30 20 29 20 63 6f 6e  Dirs[i]==0 ) con
6880: 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 73  tinue;.    if( s
6890: 74 61 74 28 61 7a 44 69 72 73 5b 69 5d 2c 20 26  tat(azDirs[i], &
68a0: 62 75 66 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b  buf) ) continue;
68b0: 0a 20 20 20 20 69 66 28 20 21 53 5f 49 53 44 49  .    if( !S_ISDI
68c0: 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29 20 29  R(buf.st_mode) )
68d0: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69   continue;.    i
68e0: 66 28 20 61 63 63 65 73 73 28 61 7a 44 69 72 73  f( access(azDirs
68f0: 5b 69 5d 2c 20 30 37 29 20 29 20 63 6f 6e 74 69  [i], 07) ) conti
6900: 6e 75 65 3b 0a 20 20 20 20 7a 44 69 72 20 3d 20  nue;.    zDir = 
6910: 61 7a 44 69 72 73 5b 69 5d 3b 0a 20 20 20 20 62  azDirs[i];.    b
6920: 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 64 6f 7b 0a  reak;.  }.  do{.
6930: 20 20 20 20 73 70 72 69 6e 74 66 28 7a 42 75 66      sprintf(zBuf
6940: 2c 20 22 25 73 2f 22 54 45 4d 50 5f 46 49 4c 45  , "%s/"TEMP_FILE
6950: 5f 50 52 45 46 49 58 2c 20 7a 44 69 72 29 3b 0a  _PREFIX, zDir);.
6960: 20 20 20 20 6a 20 3d 20 73 74 72 6c 65 6e 28 7a      j = strlen(z
6970: 42 75 66 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Buf);.    sqlite
6980: 33 52 61 6e 64 6f 6d 6e 65 73 73 28 31 35 2c 20  3Randomness(15, 
6990: 26 7a 42 75 66 5b 6a 5d 29 3b 0a 20 20 20 20 66  &zBuf[j]);.    f
69a0: 6f 72 28 69 3d 30 3b 20 69 3c 31 35 3b 20 69 2b  or(i=0; i<15; i+
69b0: 2b 2c 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 7a  +, j++){.      z
69c0: 42 75 66 5b 6a 5d 20 3d 20 28 63 68 61 72 29 7a  Buf[j] = (char)z
69d0: 43 68 61 72 73 5b 20 28 28 75 6e 73 69 67 6e 65  Chars[ ((unsigne
69e0: 64 20 63 68 61 72 29 7a 42 75 66 5b 6a 5d 29 25  d char)zBuf[j])%
69f0: 28 73 69 7a 65 6f 66 28 7a 43 68 61 72 73 29 2d  (sizeof(zChars)-
6a00: 31 29 20 5d 3b 0a 20 20 20 20 7d 0a 20 20 20 20  1) ];.    }.    
6a10: 7a 42 75 66 5b 6a 5d 20 3d 20 30 3b 0a 20 20 7d  zBuf[j] = 0;.  }
6a20: 77 68 69 6c 65 28 20 61 63 63 65 73 73 28 7a 42  while( access(zB
6a30: 75 66 2c 30 29 3d 3d 30 20 29 3b 0a 20 20 72 65  uf,0)==0 );.  re
6a40: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 20  turn SQLITE_OK; 
6a50: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20  .}../*.** Check 
6a60: 74 68 61 74 20 61 20 67 69 76 65 6e 20 70 61 74  that a given pat
6a70: 68 6e 61 6d 65 20 69 73 20 61 20 64 69 72 65 63  hname is a direc
6a80: 74 6f 72 79 20 61 6e 64 20 69 73 20 77 72 69 74  tory and is writ
6a90: 61 62 6c 65 20 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20  able .**.*/.int 
6aa0: 73 71 6c 69 74 65 33 55 6e 69 78 49 73 44 69 72  sqlite3UnixIsDir
6ab0: 57 72 69 74 61 62 6c 65 28 63 68 61 72 20 2a 7a  Writable(char *z
6ac0: 42 75 66 29 7b 0a 23 69 66 6e 64 65 66 20 53 51  Buf){.#ifndef SQ
6ad0: 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f  LITE_OMIT_PAGER_
6ae0: 50 52 41 47 4d 41 53 0a 20 20 73 74 72 75 63 74  PRAGMAS.  struct
6af0: 20 73 74 61 74 20 62 75 66 3b 0a 20 20 69 66 28   stat buf;.  if(
6b00: 20 7a 42 75 66 3d 3d 30 20 29 20 72 65 74 75 72   zBuf==0 ) retur
6b10: 6e 20 30 3b 0a 20 20 69 66 28 20 7a 42 75 66 5b  n 0;.  if( zBuf[
6b20: 30 5d 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30  0]==0 ) return 0
6b30: 3b 0a 20 20 69 66 28 20 73 74 61 74 28 7a 42 75  ;.  if( stat(zBu
6b40: 66 2c 20 26 62 75 66 29 20 29 20 72 65 74 75 72  f, &buf) ) retur
6b50: 6e 20 30 3b 0a 20 20 69 66 28 20 21 53 5f 49 53  n 0;.  if( !S_IS
6b60: 44 49 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29  DIR(buf.st_mode)
6b70: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69   ) return 0;.  i
6b80: 66 28 20 61 63 63 65 73 73 28 7a 42 75 66 2c 20  f( access(zBuf, 
6b90: 30 37 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  07) ) return 0;.
6ba0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
6bb0: 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47  _OMIT_PAGER_PRAG
6bc0: 4d 41 53 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20  MAS */.  return 
6bd0: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64  1;.}../*.** Read
6be0: 20 64 61 74 61 20 66 72 6f 6d 20 61 20 66 69 6c   data from a fil
6bf0: 65 20 69 6e 74 6f 20 61 20 62 75 66 66 65 72 2e  e into a buffer.
6c00: 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    Return SQLITE_
6c10: 4f 4b 20 69 66 20 61 6c 6c 0a 2a 2a 20 62 79 74  OK if all.** byt
6c20: 65 73 20 77 65 72 65 20 72 65 61 64 20 73 75 63  es were read suc
6c30: 63 65 73 73 66 75 6c 6c 79 20 61 6e 64 20 53 51  cessfully and SQ
6c40: 4c 49 54 45 5f 49 4f 45 52 52 20 69 66 20 61 6e  LITE_IOERR if an
6c50: 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a 2a 20 77  ything goes.** w
6c60: 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rong..*/.static 
6c70: 69 6e 74 20 75 6e 69 78 52 65 61 64 28 4f 73 46  int unixRead(OsF
6c80: 69 6c 65 20 2a 69 64 2c 20 76 6f 69 64 20 2a 70  ile *id, void *p
6c90: 42 75 66 2c 20 69 6e 74 20 61 6d 74 29 7b 0a 20  Buf, int amt){. 
6ca0: 20 69 6e 74 20 67 6f 74 3b 0a 20 20 61 73 73 65   int got;.  asse
6cb0: 72 74 28 20 69 64 20 29 3b 0a 20 20 53 69 6d 75  rt( id );.  Simu
6cc0: 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51 4c 49  lateIOError(SQLI
6cd0: 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 54 49 4d  TE_IOERR);.  TIM
6ce0: 45 52 5f 53 54 41 52 54 3b 0a 20 20 67 6f 74 20  ER_START;.  got 
6cf0: 3d 20 72 65 61 64 28 28 28 75 6e 69 78 46 69 6c  = read(((unixFil
6d00: 65 2a 29 69 64 29 2d 3e 68 2c 20 70 42 75 66 2c  e*)id)->h, pBuf,
6d10: 20 61 6d 74 29 3b 0a 20 20 54 49 4d 45 52 5f 45   amt);.  TIMER_E
6d20: 4e 44 3b 0a 20 20 54 52 41 43 45 35 28 22 52 45  ND;.  TRACE5("RE
6d30: 41 44 20 20 20 20 25 2d 33 64 20 25 35 64 20 25  AD    %-3d %5d %
6d40: 37 64 20 25 64 5c 6e 22 2c 20 28 28 75 6e 69 78  7d %d\n", ((unix
6d50: 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 67 6f  File*)id)->h, go
6d60: 74 2c 0a 20 20 20 20 20 20 20 20 20 20 6c 61 73  t,.          las
6d70: 74 5f 70 61 67 65 2c 20 54 49 4d 45 52 5f 45 4c  t_page, TIMER_EL
6d80: 41 50 53 45 44 29 3b 0a 20 20 53 45 45 4b 28 30  APSED);.  SEEK(0
6d90: 29 3b 0a 20 20 2f 2a 20 69 66 28 20 67 6f 74 3c  );.  /* if( got<
6da0: 30 20 29 20 67 6f 74 20 3d 20 30 3b 20 2a 2f 0a  0 ) got = 0; */.
6db0: 20 20 69 66 28 20 67 6f 74 3d 3d 61 6d 74 20 29    if( got==amt )
6dc0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
6dd0: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b  ITE_OK;.  }else{
6de0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
6df0: 54 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 7d 0a  TE_IOERR;.  }.}.
6e00: 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 64 61 74  ./*.** Write dat
6e10: 61 20 66 72 6f 6d 20 61 20 62 75 66 66 65 72 20  a from a buffer 
6e20: 69 6e 74 6f 20 61 20 66 69 6c 65 2e 20 20 52 65  into a file.  Re
6e30: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f  turn SQLITE_OK o
6e40: 6e 20 73 75 63 63 65 73 73 0a 2a 2a 20 6f 72 20  n success.** or 
6e50: 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72  some other error
6e60: 20 63 6f 64 65 20 6f 6e 20 66 61 69 6c 75 72 65   code on failure
6e70: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
6e80: 75 6e 69 78 57 72 69 74 65 28 4f 73 46 69 6c 65  unixWrite(OsFile
6e90: 20 2a 69 64 2c 20 63 6f 6e 73 74 20 76 6f 69 64   *id, const void
6ea0: 20 2a 70 42 75 66 2c 20 69 6e 74 20 61 6d 74 29   *pBuf, int amt)
6eb0: 7b 0a 20 20 69 6e 74 20 77 72 6f 74 65 20 3d 20  {.  int wrote = 
6ec0: 30 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 20  0;.  assert( id 
6ed0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 6d 74  );.  assert( amt
6ee0: 3e 30 20 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65  >0 );.  Simulate
6ef0: 49 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49  IOError(SQLITE_I
6f00: 4f 45 52 52 29 3b 0a 20 20 53 69 6d 75 6c 61 74  OERR);.  Simulat
6f10: 65 44 69 73 6b 66 75 6c 6c 45 72 72 6f 72 3b 0a  eDiskfullError;.
6f20: 20 20 54 49 4d 45 52 5f 53 54 41 52 54 3b 0a 20    TIMER_START;. 
6f30: 20 77 68 69 6c 65 28 20 61 6d 74 3e 30 20 26 26   while( amt>0 &&
6f40: 20 28 77 72 6f 74 65 20 3d 20 77 72 69 74 65 28   (wrote = write(
6f50: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
6f60: 3e 68 2c 20 70 42 75 66 2c 20 61 6d 74 29 29 3e  >h, pBuf, amt))>
6f70: 30 20 29 7b 0a 20 20 20 20 61 6d 74 20 2d 3d 20  0 ){.    amt -= 
6f80: 77 72 6f 74 65 3b 0a 20 20 20 20 70 42 75 66 20  wrote;.    pBuf 
6f90: 3d 20 26 28 28 63 68 61 72 2a 29 70 42 75 66 29  = &((char*)pBuf)
6fa0: 5b 77 72 6f 74 65 5d 3b 0a 20 20 7d 0a 20 20 54  [wrote];.  }.  T
6fb0: 49 4d 45 52 5f 45 4e 44 3b 0a 20 20 54 52 41 43  IMER_END;.  TRAC
6fc0: 45 35 28 22 57 52 49 54 45 20 20 20 25 2d 33 64  E5("WRITE   %-3d
6fd0: 20 25 35 64 20 25 37 64 20 25 64 5c 6e 22 2c 20   %5d %7d %d\n", 
6fe0: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
6ff0: 3e 68 2c 20 77 72 6f 74 65 2c 0a 20 20 20 20 20  >h, wrote,.     
7000: 20 20 20 20 20 6c 61 73 74 5f 70 61 67 65 2c 20       last_page, 
7010: 54 49 4d 45 52 5f 45 4c 41 50 53 45 44 29 3b 0a  TIMER_ELAPSED);.
7020: 20 20 53 45 45 4b 28 30 29 3b 0a 20 20 69 66 28    SEEK(0);.  if(
7030: 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 72 65   amt>0 ){.    re
7040: 74 75 72 6e 20 53 51 4c 49 54 45 5f 46 55 4c 4c  turn SQLITE_FULL
7050: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53  ;.  }.  return S
7060: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
7070: 2a 2a 20 4d 6f 76 65 20 74 68 65 20 72 65 61 64  ** Move the read
7080: 2f 77 72 69 74 65 20 70 6f 69 6e 74 65 72 20 69  /write pointer i
7090: 6e 20 61 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61  n a file..*/.sta
70a0: 74 69 63 20 69 6e 74 20 75 6e 69 78 53 65 65 6b  tic int unixSeek
70b0: 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69 36 34  (OsFile *id, i64
70c0: 20 6f 66 66 73 65 74 29 7b 0a 20 20 61 73 73 65   offset){.  asse
70d0: 72 74 28 20 69 64 20 29 3b 0a 20 20 53 45 45 4b  rt( id );.  SEEK
70e0: 28 6f 66 66 73 65 74 2f 31 30 32 34 20 2b 20 31  (offset/1024 + 1
70f0: 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  );.#ifdef SQLITE
7100: 5f 54 45 53 54 0a 20 20 69 66 28 20 6f 66 66 73  _TEST.  if( offs
7110: 65 74 20 29 20 53 69 6d 75 6c 61 74 65 44 69 73  et ) SimulateDis
7120: 6b 66 75 6c 6c 45 72 72 6f 72 0a 23 65 6e 64 69  kfullError.#endi
7130: 66 0a 20 20 6c 73 65 65 6b 28 28 28 75 6e 69 78  f.  lseek(((unix
7140: 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 6f 66  File*)id)->h, of
7150: 66 73 65 74 2c 20 53 45 45 4b 5f 53 45 54 29 3b  fset, SEEK_SET);
7160: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
7170: 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53  _OK;.}..#ifdef S
7180: 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a  QLITE_TEST./*.**
7190: 20 43 6f 75 6e 74 20 74 68 65 20 6e 75 6d 62 65   Count the numbe
71a0: 72 20 6f 66 20 66 75 6c 6c 73 79 6e 63 73 20 61  r of fullsyncs a
71b0: 6e 64 20 6e 6f 72 6d 61 6c 20 73 79 6e 63 73 2e  nd normal syncs.
71c0: 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 74    This is used t
71d0: 6f 20 74 65 73 74 0a 2a 2a 20 74 68 61 74 20 73  o test.** that s
71e0: 79 6e 63 73 20 61 6e 64 20 66 75 6c 6c 73 79 6e  yncs and fullsyn
71f0: 63 73 20 61 72 65 20 6f 63 63 75 72 69 6e 67 20  cs are occuring 
7200: 61 74 20 74 68 65 20 72 69 67 68 74 20 74 69 6d  at the right tim
7210: 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  es..*/.int sqlit
7220: 65 33 5f 73 79 6e 63 5f 63 6f 75 6e 74 20 3d 20  e3_sync_count = 
7230: 30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 66  0;.int sqlite3_f
7240: 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e 74 20 3d 20  ullsync_count = 
7250: 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  0;.#endif../*.**
7260: 20 55 73 65 20 74 68 65 20 66 64 61 74 61 73 79   Use the fdatasy
7270: 6e 63 28 29 20 41 50 49 20 6f 6e 6c 79 20 69 66  nc() API only if
7280: 20 74 68 65 20 48 41 56 45 5f 46 44 41 54 41 53   the HAVE_FDATAS
7290: 59 4e 43 20 6d 61 63 72 6f 20 69 73 20 64 65 66  YNC macro is def
72a0: 69 6e 65 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 69  ined..** Otherwi
72b0: 73 65 20 75 73 65 20 66 73 79 6e 63 28 29 20 69  se use fsync() i
72c0: 6e 20 69 74 73 20 70 6c 61 63 65 2e 0a 2a 2f 0a  n its place..*/.
72d0: 23 69 66 6e 64 65 66 20 48 41 56 45 5f 46 44 41  #ifndef HAVE_FDA
72e0: 54 41 53 59 4e 43 0a 23 20 64 65 66 69 6e 65 20  TASYNC.# define 
72f0: 66 64 61 74 61 73 79 6e 63 20 66 73 79 6e 63 0a  fdatasync fsync.
7300: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54  #endif.../*.** T
7310: 68 65 20 66 73 79 6e 63 28 29 20 73 79 73 74 65  he fsync() syste
7320: 6d 20 63 61 6c 6c 20 64 6f 65 73 20 6e 6f 74 20  m call does not 
7330: 77 6f 72 6b 20 61 73 20 61 64 76 65 72 74 69 73  work as advertis
7340: 65 64 20 6f 6e 20 6d 61 6e 79 0a 2a 2a 20 75 6e  ed on many.** un
7350: 69 78 20 73 79 73 74 65 6d 73 2e 20 20 54 68 65  ix systems.  The
7360: 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 63 65   following proce
7370: 64 75 72 65 20 69 73 20 61 6e 20 61 74 74 65 6d  dure is an attem
7380: 70 74 20 74 6f 20 6d 61 6b 65 0a 2a 2a 20 69 74  pt to make.** it
7390: 20 77 6f 72 6b 20 62 65 74 74 65 72 2e 0a 2a 2a   work better..**
73a0: 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4e  .** The SQLITE_N
73b0: 4f 5f 53 59 4e 43 20 6d 61 63 72 6f 20 64 69 73  O_SYNC macro dis
73c0: 61 62 6c 65 73 20 61 6c 6c 20 66 73 79 6e 63 28  ables all fsync(
73d0: 29 73 2e 20 20 54 68 69 73 20 69 73 20 75 73 65  )s.  This is use
73e0: 66 75 6c 0a 2a 2a 20 66 6f 72 20 74 65 73 74 69  ful.** for testi
73f0: 6e 67 20 77 68 65 6e 20 77 65 20 77 61 6e 74 20  ng when we want 
7400: 74 6f 20 72 75 6e 20 74 68 72 6f 75 67 68 20 74  to run through t
7410: 68 65 20 74 65 73 74 20 73 75 69 74 65 20 71 75  he test suite qu
7420: 69 63 6b 6c 79 2e 0a 2a 2a 20 59 6f 75 20 61 72  ickly..** You ar
7430: 65 20 73 74 72 6f 6e 67 6c 79 20 61 64 76 69 73  e strongly advis
7440: 65 64 20 2a 6e 6f 74 2a 20 74 6f 20 64 65 70 6c  ed *not* to depl
7450: 6f 79 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e  oy with SQLITE_N
7460: 4f 5f 53 59 4e 43 0a 2a 2a 20 65 6e 61 62 6c 65  O_SYNC.** enable
7470: 64 2c 20 68 6f 77 65 76 65 72 2c 20 73 69 6e 63  d, however, sinc
7480: 65 20 77 69 74 68 20 53 51 4c 49 54 45 5f 4e 4f  e with SQLITE_NO
7490: 5f 53 59 4e 43 20 65 6e 61 62 6c 65 64 2c 20 61  _SYNC enabled, a
74a0: 6e 20 4f 53 20 63 72 61 73 68 0a 2a 2a 20 6f 72  n OS crash.** or
74b0: 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 77   power failure w
74c0: 69 6c 6c 20 6c 69 6b 65 6c 79 20 63 6f 72 72 75  ill likely corru
74d0: 70 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20  pt the database 
74e0: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
74f0: 69 6e 74 20 66 75 6c 6c 5f 66 73 79 6e 63 28 69  int full_fsync(i
7500: 6e 74 20 66 64 2c 20 69 6e 74 20 66 75 6c 6c 53  nt fd, int fullS
7510: 79 6e 63 2c 20 69 6e 74 20 64 61 74 61 4f 6e 6c  ync, int dataOnl
7520: 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20  y){.  int rc;.. 
7530: 20 2f 2a 20 52 65 63 6f 72 64 20 74 68 65 20 6e   /* Record the n
7540: 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74  umber of times t
7550: 68 61 74 20 77 65 20 64 6f 20 61 20 6e 6f 72 6d  hat we do a norm
7560: 61 6c 20 66 73 79 6e 63 28 29 20 61 6e 64 20 0a  al fsync() and .
7570: 20 20 2a 2a 20 46 55 4c 4c 53 59 4e 43 2e 20 20    ** FULLSYNC.  
7580: 54 68 69 73 20 69 73 20 75 73 65 64 20 64 75 72  This is used dur
7590: 69 6e 67 20 74 65 73 74 69 6e 67 20 74 6f 20 76  ing testing to v
75a0: 65 72 69 66 79 20 74 68 61 74 20 74 68 69 73 20  erify that this 
75b0: 70 72 6f 63 65 64 75 72 65 0a 20 20 2a 2a 20 67  procedure.  ** g
75c0: 65 74 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20  ets called with 
75d0: 74 68 65 20 63 6f 72 72 65 63 74 20 61 72 67 75  the correct argu
75e0: 6d 65 6e 74 73 2e 0a 20 20 2a 2f 0a 23 69 66 64  ments..  */.#ifd
75f0: 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20  ef SQLITE_TEST. 
7600: 20 69 66 28 20 66 75 6c 6c 53 79 6e 63 20 29 20   if( fullSync ) 
7610: 73 71 6c 69 74 65 33 5f 66 75 6c 6c 73 79 6e 63  sqlite3_fullsync
7620: 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20 73 71 6c 69  _count++;.  sqli
7630: 74 65 33 5f 73 79 6e 63 5f 63 6f 75 6e 74 2b 2b  te3_sync_count++
7640: 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 49  ;.#endif..  /* I
7650: 66 20 77 65 20 63 6f 6d 70 69 6c 65 64 20 77 69  f we compiled wi
7660: 74 68 20 74 68 65 20 53 51 4c 49 54 45 5f 4e 4f  th the SQLITE_NO
7670: 5f 53 59 4e 43 20 66 6c 61 67 2c 20 74 68 65 6e  _SYNC flag, then
7680: 20 73 79 6e 63 69 6e 67 20 69 73 20 61 0a 20 20   syncing is a.  
7690: 2a 2a 20 6e 6f 2d 6f 70 0a 20 20 2a 2f 0a 23 69  ** no-op.  */.#i
76a0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4e 4f 5f 53  fdef SQLITE_NO_S
76b0: 59 4e 43 0a 20 20 72 63 20 3d 20 53 51 4c 49 54  YNC.  rc = SQLIT
76c0: 45 5f 4f 4b 3b 0a 23 65 6c 73 65 0a 0a 23 69 66  E_OK;.#else..#if
76d0: 64 65 66 20 46 5f 46 55 4c 4c 46 53 59 4e 43 0a  def F_FULLFSYNC.
76e0: 20 20 69 66 28 20 66 75 6c 6c 53 79 6e 63 20 29    if( fullSync )
76f0: 7b 0a 20 20 20 20 72 63 20 3d 20 66 63 6e 74 6c  {.    rc = fcntl
7700: 28 66 64 2c 20 46 5f 46 55 4c 4c 46 53 59 4e 43  (fd, F_FULLFSYNC
7710: 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  , 0);.  }else{. 
7720: 20 20 20 72 63 20 3d 20 31 3b 0a 20 20 7d 0a 20     rc = 1;.  }. 
7730: 20 2f 2a 20 49 66 20 74 68 65 20 46 55 4c 4c 53   /* If the FULLS
7740: 59 4e 43 20 66 61 69 6c 65 64 2c 20 74 72 79 20  YNC failed, try 
7750: 74 6f 20 64 6f 20 61 20 6e 6f 72 6d 61 6c 20 66  to do a normal f
7760: 73 79 6e 63 28 29 20 2a 2f 0a 20 20 69 66 28 20  sync() */.  if( 
7770: 72 63 20 29 20 72 63 20 3d 20 66 73 79 6e 63 28  rc ) rc = fsync(
7780: 66 64 29 3b 0a 0a 23 65 6c 73 65 20 2f 2a 20 69  fd);..#else /* i
7790: 66 20 21 64 65 66 69 6e 65 64 28 46 5f 46 55 4c  f !defined(F_FUL
77a0: 4c 53 59 4e 43 29 20 2a 2f 0a 20 20 69 66 28 20  LSYNC) */.  if( 
77b0: 64 61 74 61 4f 6e 6c 79 20 29 7b 0a 20 20 20 20  dataOnly ){.    
77c0: 72 63 20 3d 20 66 64 61 74 61 73 79 6e 63 28 66  rc = fdatasync(f
77d0: 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  d);.  }else{.   
77e0: 20 72 63 20 3d 20 66 73 79 6e 63 28 66 64 29 3b   rc = fsync(fd);
77f0: 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 64  .  }.#endif /* d
7800: 65 66 69 6e 65 64 28 46 5f 46 55 4c 4c 46 53 59  efined(F_FULLFSY
7810: 4e 43 29 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a  NC) */.#endif /*
7820: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f   defined(SQLITE_
7830: 4e 4f 5f 53 59 4e 43 29 20 2a 2f 0a 0a 20 20 72  NO_SYNC) */..  r
7840: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
7850: 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c  ** Make sure all
7860: 20 77 72 69 74 65 73 20 74 6f 20 61 20 70 61 72   writes to a par
7870: 74 69 63 75 6c 61 72 20 66 69 6c 65 20 61 72 65  ticular file are
7880: 20 63 6f 6d 6d 69 74 74 65 64 20 74 6f 20 64 69   committed to di
7890: 73 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 61 74  sk..**.** If dat
78a0: 61 4f 6e 6c 79 3d 3d 30 20 74 68 65 6e 20 62 6f  aOnly==0 then bo
78b0: 74 68 20 74 68 65 20 66 69 6c 65 20 69 74 73 65  th the file itse
78c0: 6c 66 20 61 6e 64 20 69 74 73 20 6d 65 74 61 64  lf and its metad
78d0: 61 74 61 20 28 66 69 6c 65 0a 2a 2a 20 73 69 7a  ata (file.** siz
78e0: 65 2c 20 61 63 63 65 73 73 20 74 69 6d 65 2c 20  e, access time, 
78f0: 65 74 63 29 20 61 72 65 20 73 79 6e 63 65 64 2e  etc) are synced.
7900: 20 20 49 66 20 64 61 74 61 4f 6e 6c 79 21 3d 30    If dataOnly!=0
7910: 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 0a 2a   then only the.*
7920: 2a 20 66 69 6c 65 20 64 61 74 61 20 69 73 20 73  * file data is s
7930: 79 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64  ynced..**.** Und
7940: 65 72 20 55 6e 69 78 2c 20 61 6c 73 6f 20 6d 61  er Unix, also ma
7950: 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65  ke sure that the
7960: 20 64 69 72 65 63 74 6f 72 79 20 65 6e 74 72 79   directory entry
7970: 20 66 6f 72 20 74 68 65 20 66 69 6c 65 0a 2a 2a   for the file.**
7980: 20 68 61 73 20 62 65 65 6e 20 63 72 65 61 74 65   has been create
7990: 64 20 62 79 20 66 73 79 6e 63 2d 69 6e 67 20 74  d by fsync-ing t
79a0: 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 68 61  he directory tha
79b0: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66  t contains the f
79c0: 69 6c 65 2e 0a 2a 2a 20 49 66 20 77 65 20 64 6f  ile..** If we do
79d0: 20 6e 6f 74 20 64 6f 20 74 68 69 73 20 61 6e 64   not do this and
79e0: 20 77 65 20 65 6e 63 6f 75 6e 74 65 72 20 61 20   we encounter a 
79f0: 70 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 74  power failure, t
7a00: 68 65 20 64 69 72 65 63 74 6f 72 79 0a 2a 2a 20  he directory.** 
7a10: 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 6a 6f  entry for the jo
7a20: 75 72 6e 61 6c 20 6d 69 67 68 74 20 6e 6f 74 20  urnal might not 
7a30: 65 78 69 73 74 20 61 66 74 65 72 20 77 65 20 72  exist after we r
7a40: 65 62 6f 6f 74 2e 20 20 54 68 65 20 6e 65 78 74  eboot.  The next
7a50: 0a 2a 2a 20 53 51 4c 69 74 65 20 74 6f 20 61 63  .** SQLite to ac
7a60: 63 65 73 73 20 74 68 65 20 66 69 6c 65 20 77 69  cess the file wi
7a70: 6c 6c 20 6e 6f 74 20 6b 6e 6f 77 20 74 68 61 74  ll not know that
7a80: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 65 78 69   the journal exi
7a90: 73 74 73 20 28 62 65 63 61 75 73 65 0a 2a 2a 20  sts (because.** 
7aa0: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 65 6e  the directory en
7ab0: 74 72 79 20 66 6f 72 20 74 68 65 20 6a 6f 75 72  try for the jour
7ac0: 6e 61 6c 20 77 61 73 20 6e 65 76 65 72 20 63 72  nal was never cr
7ad0: 65 61 74 65 64 29 20 61 6e 64 20 74 68 65 20 74  eated) and the t
7ae0: 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 77 69  ransaction.** wi
7af0: 6c 6c 20 6e 6f 74 20 72 6f 6c 6c 20 62 61 63 6b  ll not roll back
7b00: 20 2d 20 70 6f 73 73 69 62 6c 79 20 6c 65 61 64   - possibly lead
7b10: 69 6e 67 20 74 6f 20 64 61 74 61 62 61 73 65 20  ing to database 
7b20: 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73  corruption..*/.s
7b30: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 53 79  tatic int unixSy
7b40: 6e 63 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69  nc(OsFile *id, i
7b50: 6e 74 20 64 61 74 61 4f 6e 6c 79 29 7b 0a 20 20  nt dataOnly){.  
7b60: 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c 65 20  unixFile *pFile 
7b70: 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 3b  = (unixFile*)id;
7b80: 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65  .  assert( pFile
7b90: 20 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f   );.  SimulateIO
7ba0: 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45  Error(SQLITE_IOE
7bb0: 52 52 29 3b 0a 20 20 54 52 41 43 45 32 28 22 53  RR);.  TRACE2("S
7bc0: 59 4e 43 20 20 20 20 25 2d 33 64 5c 6e 22 2c 20  YNC    %-3d\n", 
7bd0: 70 46 69 6c 65 2d 3e 68 29 3b 0a 20 20 69 66 28  pFile->h);.  if(
7be0: 20 66 75 6c 6c 5f 66 73 79 6e 63 28 70 46 69 6c   full_fsync(pFil
7bf0: 65 2d 3e 68 2c 20 70 46 69 6c 65 2d 3e 66 75 6c  e->h, pFile->ful
7c00: 6c 53 79 6e 63 2c 20 64 61 74 61 4f 6e 6c 79 29  lSync, dataOnly)
7c10: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
7c20: 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20 20 7d  QLITE_IOERR;.  }
7c30: 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 64 69  .  if( pFile->di
7c40: 72 66 64 3e 3d 30 20 29 7b 0a 20 20 20 20 54 52  rfd>=0 ){.    TR
7c50: 41 43 45 32 28 22 44 49 52 53 59 4e 43 20 25 2d  ACE2("DIRSYNC %-
7c60: 33 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 64 69  3d\n", pFile->di
7c70: 72 66 64 29 3b 0a 23 69 66 6e 64 65 66 20 53 51  rfd);.#ifndef SQ
7c80: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 44 49 52  LITE_DISABLE_DIR
7c90: 53 59 4e 43 0a 20 20 20 20 69 66 28 20 66 75 6c  SYNC.    if( ful
7ca0: 6c 5f 66 73 79 6e 63 28 70 46 69 6c 65 2d 3e 64  l_fsync(pFile->d
7cb0: 69 72 66 64 2c 20 70 46 69 6c 65 2d 3e 66 75 6c  irfd, pFile->ful
7cc0: 6c 53 79 6e 63 2c 20 30 29 20 29 7b 0a 20 20 20  lSync, 0) ){.   
7cd0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
7ce0: 54 45 5f 49 4f 45 52 52 3b 0a 20 20 20 20 7d 0a  TE_IOERR;.    }.
7cf0: 23 65 6e 64 69 66 0a 20 20 20 20 63 6c 6f 73 65  #endif.    close
7d00: 28 70 46 69 6c 65 2d 3e 64 69 72 66 64 29 3b 20  (pFile->dirfd); 
7d10: 20 2f 2a 20 4f 6e 6c 79 20 6e 65 65 64 20 74 6f   /* Only need to
7d20: 20 73 79 6e 63 20 6f 6e 63 65 2c 20 73 6f 20 63   sync once, so c
7d30: 6c 6f 73 65 20 74 68 65 20 64 69 72 65 63 74 6f  lose the directo
7d40: 72 79 20 2a 2f 0a 20 20 20 20 70 46 69 6c 65 2d  ry */.    pFile-
7d50: 3e 64 69 72 66 64 20 3d 20 2d 31 3b 20 20 20 20  >dirfd = -1;    
7d60: 2f 2a 20 77 68 65 6e 20 77 65 20 61 72 65 20 64  /* when we are d
7d70: 6f 6e 65 2e 20 2a 2f 0a 20 20 7d 0a 20 20 72 65  one. */.  }.  re
7d80: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
7d90: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 74 68  }../*.** Sync th
7da0: 65 20 64 69 72 65 63 74 6f 72 79 20 7a 44 69 72  e directory zDir
7db0: 6e 61 6d 65 2e 20 54 68 69 73 20 69 73 20 61 20  name. This is a 
7dc0: 6e 6f 2d 6f 70 20 6f 6e 20 6f 70 65 72 61 74 69  no-op on operati
7dd0: 6e 67 20 73 79 73 74 65 6d 73 20 6f 74 68 65 72  ng systems other
7de0: 0a 2a 2a 20 74 68 61 6e 20 55 4e 49 58 2e 0a 2a  .** than UNIX..*
7df0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 75 73 65  *.** This is use
7e00: 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74  d to make sure t
7e10: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
7e20: 6c 20 66 69 6c 65 20 68 61 73 20 74 72 75 65 6c  l file has truel
7e30: 79 20 62 65 65 6e 20 64 65 6c 65 74 65 64 0a 2a  y been deleted.*
7e40: 2a 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e 67 20  * before making 
7e50: 63 68 61 6e 67 65 73 20 74 6f 20 69 6e 64 69 76  changes to indiv
7e60: 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 73 20 6f  idual journals o
7e70: 6e 20 61 20 6d 75 6c 74 69 2d 64 61 74 61 62 61  n a multi-databa
7e80: 73 65 20 63 6f 6d 6d 69 74 2e 0a 2a 2a 20 54 68  se commit..** Th
7e90: 65 20 46 5f 46 55 4c 4c 46 53 59 4e 43 20 6f 70  e F_FULLFSYNC op
7ea0: 74 69 6f 6e 20 69 73 20 6e 6f 74 20 6e 65 65 64  tion is not need
7eb0: 65 64 20 68 65 72 65 2e 0a 2a 2f 0a 69 6e 74 20  ed here..*/.int 
7ec0: 73 71 6c 69 74 65 33 55 6e 69 78 53 79 6e 63 44  sqlite3UnixSyncD
7ed0: 69 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 63  irectory(const c
7ee0: 68 61 72 20 2a 7a 44 69 72 6e 61 6d 65 29 7b 0a  har *zDirname){.
7ef0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49  #ifdef SQLITE_DI
7f00: 53 41 42 4c 45 5f 44 49 52 53 59 4e 43 0a 20 20  SABLE_DIRSYNC.  
7f10: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
7f20: 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 20 66 64  ;.#else.  int fd
7f30: 3b 0a 20 20 69 6e 74 20 72 3b 0a 20 20 53 69 6d  ;.  int r;.  Sim
7f40: 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51 4c  ulateIOError(SQL
7f50: 49 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 66 64  ITE_IOERR);.  fd
7f60: 20 3d 20 6f 70 65 6e 28 7a 44 69 72 6e 61 6d 65   = open(zDirname
7f70: 2c 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f 42 49 4e  , O_RDONLY|O_BIN
7f80: 41 52 59 2c 20 30 29 3b 0a 20 20 54 52 41 43 45  ARY, 0);.  TRACE
7f90: 33 28 22 44 49 52 53 59 4e 43 20 25 2d 33 64 20  3("DIRSYNC %-3d 
7fa0: 28 25 73 29 5c 6e 22 2c 20 66 64 2c 20 7a 44 69  (%s)\n", fd, zDi
7fb0: 72 6e 61 6d 65 29 3b 0a 20 20 69 66 28 20 66 64  rname);.  if( fd
7fc0: 3c 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  <0 ){.    return
7fd0: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e   SQLITE_CANTOPEN
7fe0: 3b 20 0a 20 20 7d 0a 20 20 72 20 3d 20 66 73 79  ; .  }.  r = fsy
7ff0: 6e 63 28 66 64 29 3b 0a 20 20 63 6c 6f 73 65 28  nc(fd);.  close(
8000: 66 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 28  fd);.  return ((
8010: 72 3d 3d 30 29 3f 53 51 4c 49 54 45 5f 4f 4b 3a  r==0)?SQLITE_OK:
8020: 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a 23  SQLITE_IOERR);.#
8030: 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  endif.}../*.** T
8040: 72 75 6e 63 61 74 65 20 61 6e 20 6f 70 65 6e 20  runcate an open 
8050: 66 69 6c 65 20 74 6f 20 61 20 73 70 65 63 69 66  file to a specif
8060: 69 65 64 20 73 69 7a 65 0a 2a 2f 0a 73 74 61 74  ied size.*/.stat
8070: 69 63 20 69 6e 74 20 75 6e 69 78 54 72 75 6e 63  ic int unixTrunc
8080: 61 74 65 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20  ate(OsFile *id, 
8090: 69 36 34 20 6e 42 79 74 65 29 7b 0a 20 20 61 73  i64 nByte){.  as
80a0: 73 65 72 74 28 20 69 64 20 29 3b 0a 20 20 53 69  sert( id );.  Si
80b0: 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51  mulateIOError(SQ
80c0: 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 72  LITE_IOERR);.  r
80d0: 65 74 75 72 6e 20 66 74 72 75 6e 63 61 74 65 28  eturn ftruncate(
80e0: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
80f0: 3e 68 2c 20 6e 42 79 74 65 29 3d 3d 30 20 3f 20  >h, nByte)==0 ? 
8100: 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 4c 49  SQLITE_OK : SQLI
8110: 54 45 5f 49 4f 45 52 52 3b 0a 7d 0a 0a 2f 2a 0a  TE_IOERR;.}../*.
8120: 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68 65  ** Determine the
8130: 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f 66   current size of
8140: 20 61 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73   a file in bytes
8150: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
8160: 6e 69 78 46 69 6c 65 53 69 7a 65 28 4f 73 46 69  nixFileSize(OsFi
8170: 6c 65 20 2a 69 64 2c 20 69 36 34 20 2a 70 53 69  le *id, i64 *pSi
8180: 7a 65 29 7b 0a 20 20 73 74 72 75 63 74 20 73 74  ze){.  struct st
8190: 61 74 20 62 75 66 3b 0a 20 20 61 73 73 65 72 74  at buf;.  assert
81a0: 28 20 69 64 20 29 3b 0a 20 20 53 69 6d 75 6c 61  ( id );.  Simula
81b0: 74 65 49 4f 45 72 72 6f 72 28 53 51 4c 49 54 45  teIOError(SQLITE
81c0: 5f 49 4f 45 52 52 29 3b 0a 20 20 69 66 28 20 66  _IOERR);.  if( f
81d0: 73 74 61 74 28 28 28 75 6e 69 78 46 69 6c 65 2a  stat(((unixFile*
81e0: 29 69 64 29 2d 3e 68 2c 20 26 62 75 66 29 21 3d  )id)->h, &buf)!=
81f0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
8200: 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20 20  SQLITE_IOERR;.  
8210: 7d 0a 20 20 2a 70 53 69 7a 65 20 3d 20 62 75 66  }.  *pSize = buf
8220: 2e 73 74 5f 73 69 7a 65 3b 0a 20 20 72 65 74 75  .st_size;.  retu
8230: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
8240: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
8250: 69 6e 65 20 63 68 65 63 6b 73 20 69 66 20 74 68  ine checks if th
8260: 65 72 65 20 69 73 20 61 20 52 45 53 45 52 56 45  ere is a RESERVE
8270: 44 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 74  D lock held on t
8280: 68 65 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20  he specified.** 
8290: 66 69 6c 65 20 62 79 20 74 68 69 73 20 6f 72 20  file by this or 
82a0: 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73  any other proces
82b0: 73 2e 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63  s. If such a loc
82c0: 6b 20 69 73 20 68 65 6c 64 2c 20 72 65 74 75 72  k is held, retur
82d0: 6e 0a 2a 2a 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 20  n.** non-zero.  
82e0: 49 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 75  If the file is u
82f0: 6e 6c 6f 63 6b 65 64 20 6f 72 20 68 6f 6c 64 73  nlocked or holds
8300: 20 6f 6e 6c 79 20 53 48 41 52 45 44 20 6c 6f 63   only SHARED loc
8310: 6b 73 2c 20 74 68 65 6e 0a 2a 2a 20 72 65 74 75  ks, then.** retu
8320: 72 6e 20 7a 65 72 6f 2e 0a 2a 2f 0a 73 74 61 74  rn zero..*/.stat
8330: 69 63 20 69 6e 74 20 75 6e 69 78 43 68 65 63 6b  ic int unixCheck
8340: 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 4f 73 46  ReservedLock(OsF
8350: 69 6c 65 20 2a 69 64 29 7b 0a 20 20 69 6e 74 20  ile *id){.  int 
8360: 72 20 3d 20 30 3b 0a 20 20 75 6e 69 78 46 69 6c  r = 0;.  unixFil
8370: 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78  e *pFile = (unix
8380: 46 69 6c 65 2a 29 69 64 3b 0a 0a 20 20 61 73 73  File*)id;..  ass
8390: 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20 20  ert( pFile );.  
83a0: 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75  sqlite3OsEnterMu
83b0: 74 65 78 28 29 3b 20 2f 2a 20 42 65 63 61 75 73  tex(); /* Becaus
83c0: 65 20 70 46 69 6c 65 2d 3e 70 4c 6f 63 6b 20 69  e pFile->pLock i
83d0: 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 73 20  s shared across 
83e0: 74 68 72 65 61 64 73 20 2a 2f 0a 0a 20 20 2f 2a  threads */..  /*
83f0: 20 43 68 65 63 6b 20 69 66 20 61 20 74 68 72 65   Check if a thre
8400: 61 64 20 69 6e 20 74 68 69 73 20 70 72 6f 63 65  ad in this proce
8410: 73 73 20 68 6f 6c 64 73 20 73 75 63 68 20 61 20  ss holds such a 
8420: 6c 6f 63 6b 20 2a 2f 0a 20 20 69 66 28 20 70 46  lock */.  if( pF
8430: 69 6c 65 2d 3e 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b  ile->pLock->lock
8440: 74 79 70 65 3e 53 48 41 52 45 44 5f 4c 4f 43 4b  type>SHARED_LOCK
8450: 20 29 7b 0a 20 20 20 20 72 20 3d 20 31 3b 0a 20   ){.    r = 1;. 
8460: 20 7d 0a 0a 20 20 2f 2a 20 4f 74 68 65 72 77 69   }..  /* Otherwi
8470: 73 65 20 73 65 65 20 69 66 20 73 6f 6d 65 20 6f  se see if some o
8480: 74 68 65 72 20 70 72 6f 63 65 73 73 20 68 6f 6c  ther process hol
8490: 64 73 20 69 74 2e 0a 20 20 2a 2f 0a 20 20 69 66  ds it..  */.  if
84a0: 28 20 21 72 20 29 7b 0a 20 20 20 20 73 74 72 75  ( !r ){.    stru
84b0: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20  ct flock lock;. 
84c0: 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65     lock.l_whence
84d0: 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20   = SEEK_SET;.   
84e0: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20   lock.l_start = 
84f0: 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a 20  RESERVED_BYTE;. 
8500: 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20     lock.l_len = 
8510: 31 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79  1;.    lock.l_ty
8520: 70 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20  pe = F_WRLCK;.  
8530: 20 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68    fcntl(pFile->h
8540: 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_GETLK, &lock
8550: 29 3b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 2e  );.    if( lock.
8560: 6c 5f 74 79 70 65 21 3d 46 5f 55 4e 4c 43 4b 20  l_type!=F_UNLCK 
8570: 29 7b 0a 20 20 20 20 20 20 72 20 3d 20 31 3b 0a  ){.      r = 1;.
8580: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 73      }.  }.  .  s
8590: 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74  qlite3OsLeaveMut
85a0: 65 78 28 29 3b 0a 20 20 54 52 41 43 45 33 28 22  ex();.  TRACE3("
85b0: 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20 25 64 20  TEST WR-LOCK %d 
85c0: 25 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c  %d\n", pFile->h,
85d0: 20 72 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 72   r);..  return r
85e0: 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  ;.}..#ifdef SQLI
85f0: 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 48  TE_DEBUG./*.** H
8600: 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 66  elper function f
8610: 6f 72 20 70 72 69 6e 74 69 6e 67 20 6f 75 74 20  or printing out 
8620: 74 72 61 63 65 20 69 6e 66 6f 72 6d 61 74 69 6f  trace informatio
8630: 6e 20 66 72 6f 6d 20 64 65 62 75 67 67 69 6e 67  n from debugging
8640: 0a 2a 2a 20 62 69 6e 61 72 69 65 73 2e 20 54 68  .** binaries. Th
8650: 69 73 20 72 65 74 75 72 6e 73 20 74 68 65 20 73  is returns the s
8660: 74 72 69 6e 67 20 72 65 70 72 65 73 65 74 61 74  tring represetat
8670: 69 6f 6e 20 6f 66 20 74 68 65 20 73 75 70 70 6c  ion of the suppl
8680: 69 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 20 6c  ied.** integer l
8690: 6f 63 6b 2d 74 79 70 65 2e 0a 2a 2f 0a 73 74 61  ock-type..*/.sta
86a0: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  tic const char *
86b0: 6c 6f 63 6b 74 79 70 65 4e 61 6d 65 28 69 6e 74  locktypeName(int
86c0: 20 6c 6f 63 6b 74 79 70 65 29 7b 0a 20 20 73 77   locktype){.  sw
86d0: 69 74 63 68 28 20 6c 6f 63 6b 74 79 70 65 20 29  itch( locktype )
86e0: 7b 0a 20 20 63 61 73 65 20 4e 4f 5f 4c 4f 43 4b  {.  case NO_LOCK
86f0: 3a 20 72 65 74 75 72 6e 20 22 4e 4f 4e 45 22 3b  : return "NONE";
8700: 0a 20 20 63 61 73 65 20 53 48 41 52 45 44 5f 4c  .  case SHARED_L
8710: 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 53 48 41  OCK: return "SHA
8720: 52 45 44 22 3b 0a 20 20 63 61 73 65 20 52 45 53  RED";.  case RES
8730: 45 52 56 45 44 5f 4c 4f 43 4b 3a 20 72 65 74 75  ERVED_LOCK: retu
8740: 72 6e 20 22 52 45 53 45 52 56 45 44 22 3b 0a 20  rn "RESERVED";. 
8750: 20 63 61 73 65 20 50 45 4e 44 49 4e 47 5f 4c 4f   case PENDING_LO
8760: 43 4b 3a 20 72 65 74 75 72 6e 20 22 50 45 4e 44  CK: return "PEND
8770: 49 4e 47 22 3b 0a 20 20 63 61 73 65 20 45 58 43  ING";.  case EXC
8780: 4c 55 53 49 56 45 5f 4c 4f 43 4b 3a 20 72 65 74  LUSIVE_LOCK: ret
8790: 75 72 6e 20 22 45 58 43 4c 55 53 49 56 45 22 3b  urn "EXCLUSIVE";
87a0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 22 45  .  }.  return "E
87b0: 52 52 4f 52 22 3b 0a 7d 0a 23 65 6e 64 69 66 0a  RROR";.}.#endif.
87c0: 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 20  ./*.** Lock the 
87d0: 66 69 6c 65 20 77 69 74 68 20 74 68 65 20 6c 6f  file with the lo
87e0: 63 6b 20 73 70 65 63 69 66 69 65 64 20 62 79 20  ck specified by 
87f0: 70 61 72 61 6d 65 74 65 72 20 6c 6f 63 6b 74 79  parameter lockty
8800: 70 65 20 2d 20 6f 6e 65 0a 2a 2a 20 6f 66 20 74  pe - one.** of t
8810: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a  he following:.**
8820: 0a 2a 2a 20 20 20 20 20 28 31 29 20 53 48 41 52  .**     (1) SHAR
8830: 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20 28  ED_LOCK.**     (
8840: 32 29 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b  2) RESERVED_LOCK
8850: 0a 2a 2a 20 20 20 20 20 28 33 29 20 50 45 4e 44  .**     (3) PEND
8860: 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20 20 20 20  ING_LOCK.**     
8870: 28 34 29 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f  (4) EXCLUSIVE_LO
8880: 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d  CK.**.** Sometim
8890: 65 73 20 77 68 65 6e 20 72 65 71 75 65 73 74 69  es when requesti
88a0: 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73 74 61 74  ng one lock stat
88b0: 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f  e, additional lo
88c0: 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20 61 72 65  ck states.** are
88d0: 20 69 6e 73 65 72 74 65 64 20 69 6e 20 62 65 74   inserted in bet
88e0: 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f 63 6b 69  ween.  The locki
88f0: 6e 67 20 6d 69 67 68 74 20 66 61 69 6c 20 6f 6e  ng might fail on
8900: 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 61 74 65   one of the late
8910: 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73  r.** transitions
8920: 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 6f 63   leaving the loc
8930: 6b 20 73 74 61 74 65 20 64 69 66 66 65 72 65 6e  k state differen
8940: 74 20 66 72 6f 6d 20 77 68 61 74 20 69 74 20 73  t from what it s
8950: 74 61 72 74 65 64 20 62 75 74 0a 2a 2a 20 73 74  tarted but.** st
8960: 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20 69 74 73  ill short of its
8970: 20 67 6f 61 6c 2e 20 20 54 68 65 20 66 6f 6c 6c   goal.  The foll
8980: 6f 77 69 6e 67 20 63 68 61 72 74 20 73 68 6f 77  owing chart show
8990: 73 20 74 68 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a  s the allowed.**
89a0: 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64   transitions and
89b0: 20 74 68 65 20 69 6e 73 65 72 74 65 64 20 69 6e   the inserted in
89c0: 74 65 72 6d 65 64 69 61 74 65 20 73 74 61 74 65  termediate state
89d0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55 4e 4c 4f  s:.**.**    UNLO
89e0: 43 4b 45 44 20 2d 3e 20 53 48 41 52 45 44 0a 2a  CKED -> SHARED.*
89f0: 2a 20 20 20 20 53 48 41 52 45 44 20 2d 3e 20 52  *    SHARED -> R
8a00: 45 53 45 52 56 45 44 0a 2a 2a 20 20 20 20 53 48  ESERVED.**    SH
8a10: 41 52 45 44 20 2d 3e 20 28 50 45 4e 44 49 4e 47  ARED -> (PENDING
8a20: 29 20 2d 3e 20 45 58 43 4c 55 53 49 56 45 0a 2a  ) -> EXCLUSIVE.*
8a30: 2a 20 20 20 20 52 45 53 45 52 56 45 44 20 2d 3e  *    RESERVED ->
8a40: 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e 20 45 58   (PENDING) -> EX
8a50: 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 50 45  CLUSIVE.**    PE
8a60: 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c 55 53 49  NDING -> EXCLUSI
8a70: 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  VE.**.** This ro
8a80: 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e 6c 79 20  utine will only 
8a90: 69 6e 63 72 65 61 73 65 20 61 20 6c 6f 63 6b 2e  increase a lock.
8aa0: 20 20 55 73 65 20 74 68 65 20 73 71 6c 69 74 65    Use the sqlite
8ab0: 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 72  3OsUnlock().** r
8ac0: 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77 65 72 20  outine to lower 
8ad0: 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2e  a locking level.
8ae0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
8af0: 6e 69 78 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a  nixLock(OsFile *
8b00: 69 64 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65  id, int locktype
8b10: 29 7b 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c  ){.  /* The foll
8b20: 6f 77 69 6e 67 20 64 65 73 63 72 69 62 65 73 20  owing describes 
8b30: 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  the implementati
8b40: 6f 6e 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75  on of the variou
8b50: 73 20 6c 6f 63 6b 73 20 61 6e 64 0a 20 20 2a 2a  s locks and.  **
8b60: 20 6c 6f 63 6b 20 74 72 61 6e 73 69 74 69 6f 6e   lock transition
8b70: 73 20 69 6e 20 74 65 72 6d 73 20 6f 66 20 74 68  s in terms of th
8b80: 65 20 50 4f 53 49 58 20 61 64 76 69 73 6f 72 79  e POSIX advisory
8b90: 20 73 68 61 72 65 64 20 61 6e 64 20 65 78 63 6c   shared and excl
8ba0: 75 73 69 76 65 0a 20 20 2a 2a 20 6c 6f 63 6b 20  usive.  ** lock 
8bb0: 70 72 69 6d 69 74 69 76 65 73 20 28 63 61 6c 6c  primitives (call
8bc0: 65 64 20 72 65 61 64 2d 6c 6f 63 6b 73 20 61 6e  ed read-locks an
8bd0: 64 20 77 72 69 74 65 2d 6c 6f 63 6b 73 20 62 65  d write-locks be
8be0: 6c 6f 77 2c 20 74 6f 20 61 76 6f 69 64 0a 20 20  low, to avoid.  
8bf0: 2a 2a 20 63 6f 6e 66 75 73 69 6f 6e 20 77 69 74  ** confusion wit
8c00: 68 20 53 51 4c 69 74 65 20 6c 6f 63 6b 20 6e 61  h SQLite lock na
8c10: 6d 65 73 29 2e 20 54 68 65 20 61 6c 67 6f 72 69  mes). The algori
8c20: 74 68 6d 73 20 61 72 65 20 63 6f 6d 70 6c 69 63  thms are complic
8c30: 61 74 65 64 0a 20 20 2a 2a 20 73 6c 69 67 68 74  ated.  ** slight
8c40: 6c 79 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62  ly in order to b
8c50: 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74  e compatible wit
8c60: 68 20 77 69 6e 64 6f 77 73 20 73 79 73 74 65 6d  h windows system
8c70: 73 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79  s simultaneously
8c80: 0a 20 20 2a 2a 20 61 63 63 65 73 73 69 6e 67 20  .  ** accessing 
8c90: 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73  the same databas
8ca0: 65 20 66 69 6c 65 2c 20 69 6e 20 63 61 73 65 20  e file, in case 
8cb0: 74 68 61 74 20 69 73 20 65 76 65 72 20 72 65 71  that is ever req
8cc0: 75 69 72 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  uired..  **.  **
8cd0: 20 53 79 6d 62 6f 6c 73 20 64 65 66 69 6e 65 64   Symbols defined
8ce0: 20 69 6e 20 6f 73 2e 68 20 69 6e 64 65 6e 74 69   in os.h indenti
8cf0: 66 79 20 74 68 65 20 27 70 65 6e 64 69 6e 67 20  fy the 'pending 
8d00: 62 79 74 65 27 20 61 6e 64 20 74 68 65 20 27 72  byte' and the 'r
8d10: 65 73 65 72 76 65 64 0a 20 20 2a 2a 20 62 79 74  eserved.  ** byt
8d20: 65 27 2c 20 65 61 63 68 20 73 69 6e 67 6c 65 20  e', each single 
8d30: 62 79 74 65 73 20 61 74 20 77 65 6c 6c 20 6b 6e  bytes at well kn
8d40: 6f 77 6e 20 6f 66 66 73 65 74 73 2c 20 61 6e 64  own offsets, and
8d50: 20 74 68 65 20 27 73 68 61 72 65 64 20 62 79 74   the 'shared byt
8d60: 65 0a 20 20 2a 2a 20 72 61 6e 67 65 27 2c 20 61  e.  ** range', a
8d70: 20 72 61 6e 67 65 20 6f 66 20 35 31 30 20 62 79   range of 510 by
8d80: 74 65 73 20 61 74 20 61 20 77 65 6c 6c 20 6b 6e  tes at a well kn
8d90: 6f 77 6e 20 6f 66 66 73 65 74 2e 0a 20 20 2a 2a  own offset..  **
8da0: 0a 20 20 2a 2a 20 54 6f 20 6f 62 74 61 69 6e 20  .  ** To obtain 
8db0: 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20 61  a SHARED lock, a
8dc0: 20 72 65 61 64 2d 6c 6f 63 6b 20 69 73 20 6f 62   read-lock is ob
8dd0: 74 61 69 6e 65 64 20 6f 6e 20 74 68 65 20 27 70  tained on the 'p
8de0: 65 6e 64 69 6e 67 0a 20 20 2a 2a 20 62 79 74 65  ending.  ** byte
8df0: 27 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 73  '.  If this is s
8e00: 75 63 63 65 73 73 66 75 6c 2c 20 61 20 72 61 6e  uccessful, a ran
8e10: 64 6f 6d 20 62 79 74 65 20 66 72 6f 6d 20 74 68  dom byte from th
8e20: 65 20 27 73 68 61 72 65 64 20 62 79 74 65 0a 20  e 'shared byte. 
8e30: 20 2a 2a 20 72 61 6e 67 65 27 20 69 73 20 72 65   ** range' is re
8e40: 61 64 2d 6c 6f 63 6b 65 64 20 61 6e 64 20 74 68  ad-locked and th
8e50: 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 27 70  e lock on the 'p
8e60: 65 6e 64 69 6e 67 20 62 79 74 65 27 20 72 65 6c  ending byte' rel
8e70: 65 61 73 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  eased..  **.  **
8e80: 20 41 20 70 72 6f 63 65 73 73 20 6d 61 79 20 6f   A process may o
8e90: 6e 6c 79 20 6f 62 74 61 69 6e 20 61 20 52 45 53  nly obtain a RES
8ea0: 45 52 56 45 44 20 6c 6f 63 6b 20 61 66 74 65 72  ERVED lock after
8eb0: 20 69 74 20 68 61 73 20 61 20 53 48 41 52 45 44   it has a SHARED
8ec0: 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 41 20 52 45   lock..  ** A RE
8ed0: 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 69  SERVED lock is i
8ee0: 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 67 72  mplemented by gr
8ef0: 61 62 62 69 6e 67 20 61 20 77 72 69 74 65 2d 6c  abbing a write-l
8f00: 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20  ock on the.  ** 
8f10: 27 72 65 73 65 72 76 65 64 20 62 79 74 65 27 2e  'reserved byte'.
8f20: 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 70 72   .  **.  ** A pr
8f30: 6f 63 65 73 73 20 6d 61 79 20 6f 6e 6c 79 20 6f  ocess may only o
8f40: 62 74 61 69 6e 20 61 20 50 45 4e 44 49 4e 47 20  btain a PENDING 
8f50: 6c 6f 63 6b 20 61 66 74 65 72 20 69 74 20 68 61  lock after it ha
8f60: 73 20 6f 62 74 61 69 6e 65 64 20 61 0a 20 20 2a  s obtained a.  *
8f70: 2a 20 53 48 41 52 45 44 20 6c 6f 63 6b 2e 20 41  * SHARED lock. A
8f80: 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 69 73   PENDING lock is
8f90: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20   implemented by 
8fa0: 6f 62 74 61 69 6e 69 6e 67 20 61 20 77 72 69 74  obtaining a writ
8fb0: 65 2d 6c 6f 63 6b 0a 20 20 2a 2a 20 6f 6e 20 74  e-lock.  ** on t
8fc0: 68 65 20 27 70 65 6e 64 69 6e 67 20 62 79 74 65  he 'pending byte
8fd0: 27 2e 20 54 68 69 73 20 65 6e 73 75 72 65 73 20  '. This ensures 
8fe0: 74 68 61 74 20 6e 6f 20 6e 65 77 20 53 48 41 52  that no new SHAR
8ff0: 45 44 20 6c 6f 63 6b 73 20 63 61 6e 20 62 65 0a  ED locks can be.
9000: 20 20 2a 2a 20 6f 62 74 61 69 6e 65 64 2c 20 62    ** obtained, b
9010: 75 74 20 65 78 69 73 74 69 6e 67 20 53 48 41 52  ut existing SHAR
9020: 45 44 20 6c 6f 63 6b 73 20 61 72 65 20 61 6c 6c  ED locks are all
9030: 6f 77 65 64 20 74 6f 20 70 65 72 73 69 73 74 2e  owed to persist.
9040: 20 41 20 70 72 6f 63 65 73 73 0a 20 20 2a 2a 20   A process.  ** 
9050: 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 74 6f  does not have to
9060: 20 6f 62 74 61 69 6e 20 61 20 52 45 53 45 52 56   obtain a RESERV
9070: 45 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 77  ED lock on the w
9080: 61 79 20 74 6f 20 61 20 50 45 4e 44 49 4e 47 20  ay to a PENDING 
9090: 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 54 68 69 73 20  lock..  ** This 
90a0: 70 72 6f 70 65 72 74 79 20 69 73 20 75 73 65 64  property is used
90b0: 20 62 79 20 74 68 65 20 61 6c 67 6f 72 69 74 68   by the algorith
90c0: 6d 20 66 6f 72 20 72 6f 6c 6c 69 6e 67 20 62 61  m for rolling ba
90d0: 63 6b 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ck a journal fil
90e0: 65 0a 20 20 2a 2a 20 61 66 74 65 72 20 61 20 63  e.  ** after a c
90f0: 72 61 73 68 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  rash..  **.  ** 
9100: 41 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63  An EXCLUSIVE loc
9110: 6b 2c 20 6f 62 74 61 69 6e 65 64 20 61 66 74 65  k, obtained afte
9120: 72 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b  r a PENDING lock
9130: 20 69 73 20 68 65 6c 64 2c 20 69 73 0a 20 20 2a   is held, is.  *
9140: 2a 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79  * implemented by
9150: 20 6f 62 74 61 69 6e 69 6e 67 20 61 20 77 72 69   obtaining a wri
9160: 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 65  te-lock on the e
9170: 6e 74 69 72 65 20 27 73 68 61 72 65 64 20 62 79  ntire 'shared by
9180: 74 65 0a 20 20 2a 2a 20 72 61 6e 67 65 27 2e 20  te.  ** range'. 
9190: 53 69 6e 63 65 20 61 6c 6c 20 6f 74 68 65 72 20  Since all other 
91a0: 6c 6f 63 6b 73 20 72 65 71 75 69 72 65 20 61 20  locks require a 
91b0: 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 6f 6e 65  read-lock on one
91c0: 20 6f 66 20 74 68 65 20 62 79 74 65 73 0a 20 20   of the bytes.  
91d0: 2a 2a 20 77 69 74 68 69 6e 20 74 68 69 73 20 72  ** within this r
91e0: 61 6e 67 65 2c 20 74 68 69 73 20 65 6e 73 75 72  ange, this ensur
91f0: 65 73 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 72  es that no other
9200: 20 6c 6f 63 6b 73 20 61 72 65 20 68 65 6c 64 20   locks are held 
9210: 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61  on the.  ** data
9220: 62 61 73 65 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a  base. .  **.  **
9230: 20 54 68 65 20 72 65 61 73 6f 6e 20 61 20 73 69   The reason a si
9240: 6e 67 6c 65 20 62 79 74 65 20 63 61 6e 6e 6f 74  ngle byte cannot
9250: 20 62 65 20 75 73 65 64 20 69 6e 73 74 65 61 64   be used instead
9260: 20 6f 66 20 74 68 65 20 27 73 68 61 72 65 64 20   of the 'shared 
9270: 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e 67 65 27  byte.  ** range'
9280: 20 69 73 20 74 68 61 74 20 73 6f 6d 65 20 76 65   is that some ve
9290: 72 73 69 6f 6e 73 20 6f 66 20 77 69 6e 64 6f 77  rsions of window
92a0: 73 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f 72 74  s do not support
92b0: 20 72 65 61 64 2d 6c 6f 63 6b 73 2e 20 42 79 0a   read-locks. By.
92c0: 20 20 2a 2a 20 6c 6f 63 6b 69 6e 67 20 61 20 72    ** locking a r
92d0: 61 6e 64 6f 6d 20 62 79 74 65 20 66 72 6f 6d 20  andom byte from 
92e0: 61 20 72 61 6e 67 65 2c 20 63 6f 6e 63 75 72 72  a range, concurr
92f0: 65 6e 74 20 53 48 41 52 45 44 20 6c 6f 63 6b 73  ent SHARED locks
9300: 20 6d 61 79 20 65 78 69 73 74 0a 20 20 2a 2a 20   may exist.  ** 
9310: 65 76 65 6e 20 69 66 20 74 68 65 20 6c 6f 63 6b  even if the lock
9320: 69 6e 67 20 70 72 69 6d 69 74 69 76 65 20 75 73  ing primitive us
9330: 65 64 20 69 73 20 61 6c 77 61 79 73 20 61 20 77  ed is always a w
9340: 72 69 74 65 2d 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a  rite-lock..  */.
9350: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
9360: 45 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65  E_OK;.  unixFile
9370: 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e 69 78 46   *pFile = (unixF
9380: 69 6c 65 2a 29 69 64 3b 0a 20 20 73 74 72 75 63  ile*)id;.  struc
9390: 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70 4c 6f 63  t lockInfo *pLoc
93a0: 6b 20 3d 20 70 46 69 6c 65 2d 3e 70 4c 6f 63 6b  k = pFile->pLock
93b0: 3b 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b  ;.  struct flock
93c0: 20 6c 6f 63 6b 3b 0a 20 20 69 6e 74 20 73 3b 0a   lock;.  int s;.
93d0: 0a 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65  .  assert( pFile
93e0: 20 29 3b 0a 20 20 54 52 41 43 45 37 28 22 4c 4f   );.  TRACE7("LO
93f0: 43 4b 20 20 20 20 25 64 20 25 73 20 77 61 73 20  CK    %d %s was 
9400: 25 73 28 25 73 2c 25 64 29 20 70 69 64 3d 25 64  %s(%s,%d) pid=%d
9410: 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20  \n", pFile->h,. 
9420: 20 20 20 20 20 6c 6f 63 6b 74 79 70 65 4e 61 6d       locktypeNam
9430: 65 28 6c 6f 63 6b 74 79 70 65 29 2c 20 6c 6f 63  e(locktype), loc
9440: 6b 74 79 70 65 4e 61 6d 65 28 70 46 69 6c 65 2d  ktypeName(pFile-
9450: 3e 6c 6f 63 6b 74 79 70 65 29 2c 0a 20 20 20 20  >locktype),.    
9460: 20 20 6c 6f 63 6b 74 79 70 65 4e 61 6d 65 28 70    locktypeName(p
9470: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 29 2c  Lock->locktype),
9480: 20 70 4c 6f 63 6b 2d 3e 63 6e 74 20 2c 20 67 65   pLock->cnt , ge
9490: 74 70 69 64 28 29 29 3b 0a 0a 20 20 2f 2a 20 49  tpid());..  /* I
94a0: 66 20 74 68 65 72 65 20 69 73 20 61 6c 72 65 61  f there is alrea
94b0: 64 79 20 61 20 6c 6f 63 6b 20 6f 66 20 74 68 69  dy a lock of thi
94c0: 73 20 74 79 70 65 20 6f 72 20 6d 6f 72 65 20 72  s type or more r
94d0: 65 73 74 72 69 63 74 69 76 65 20 6f 6e 20 74 68  estrictive on th
94e0: 65 0a 20 20 2a 2a 20 4f 73 46 69 6c 65 2c 20 64  e.  ** OsFile, d
94f0: 6f 20 6e 6f 74 68 69 6e 67 2e 20 44 6f 6e 27 74  o nothing. Don't
9500: 20 75 73 65 20 74 68 65 20 65 6e 64 5f 6c 6f 63   use the end_loc
9510: 6b 3a 20 65 78 69 74 20 70 61 74 68 2c 20 61 73  k: exit path, as
9520: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 4f 73 45  .  ** sqlite3OsE
9530: 6e 74 65 72 4d 75 74 65 78 28 29 20 68 61 73 6e  nterMutex() hasn
9540: 27 74 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 79  't been called y
9550: 65 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70  et..  */.  if( p
9560: 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 3e 3d  File->locktype>=
9570: 6c 6f 63 6b 74 79 70 65 20 29 7b 0a 20 20 20 20  locktype ){.    
9580: 54 52 41 43 45 33 28 22 4c 4f 43 4b 20 20 20 20  TRACE3("LOCK    
9590: 25 64 20 25 73 20 6f 6b 20 28 61 6c 72 65 61 64  %d %s ok (alread
95a0: 79 20 68 65 6c 64 29 5c 6e 22 2c 20 70 46 69 6c  y held)\n", pFil
95b0: 65 2d 3e 68 2c 0a 20 20 20 20 20 20 20 20 20 20  e->h,.          
95c0: 20 20 6c 6f 63 6b 74 79 70 65 4e 61 6d 65 28 6c    locktypeName(l
95d0: 6f 63 6b 74 79 70 65 29 29 3b 0a 20 20 20 20 72  ocktype));.    r
95e0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
95f0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20  .  }..  /* Make 
9600: 73 75 72 65 20 74 68 65 20 6c 6f 63 6b 69 6e 67  sure the locking
9610: 20 73 65 71 75 65 6e 63 65 20 69 73 20 63 6f 72   sequence is cor
9620: 72 65 63 74 0a 20 20 2a 2f 0a 20 20 61 73 73 65  rect.  */.  asse
9630: 72 74 28 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74  rt( pFile->lockt
9640: 79 70 65 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20  ype!=NO_LOCK || 
9650: 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44  locktype==SHARED
9660: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72  _LOCK );.  asser
9670: 74 28 20 6c 6f 63 6b 74 79 70 65 21 3d 50 45 4e  t( locktype!=PEN
9680: 44 49 4e 47 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61  DING_LOCK );.  a
9690: 73 73 65 72 74 28 20 6c 6f 63 6b 74 79 70 65 21  ssert( locktype!
96a0: 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c  =RESERVED_LOCK |
96b0: 7c 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70  | pFile->locktyp
96c0: 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29  e==SHARED_LOCK )
96d0: 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 6d 75 74  ;..  /* This mut
96e0: 65 78 20 69 73 20 6e 65 65 64 65 64 20 62 65 63  ex is needed bec
96f0: 61 75 73 65 20 70 46 69 6c 65 2d 3e 70 4c 6f 63  ause pFile->pLoc
9700: 6b 20 69 73 20 73 68 61 72 65 64 20 61 63 72 6f  k is shared acro
9710: 73 73 20 74 68 72 65 61 64 73 0a 20 20 2a 2f 0a  ss threads.  */.
9720: 20 20 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72    sqlite3OsEnter
9730: 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 4d  Mutex();..  /* M
9740: 61 6b 65 20 73 75 72 65 20 74 68 65 20 63 75 72  ake sure the cur
9750: 72 65 6e 74 20 74 68 72 65 61 64 20 6f 77 6e 73  rent thread owns
9760: 20 74 68 65 20 70 46 69 6c 65 2e 0a 20 20 2a 2f   the pFile..  */
9770: 0a 20 20 72 63 20 3d 20 74 72 61 6e 73 66 65 72  .  rc = transfer
9780: 4f 77 6e 65 72 73 68 69 70 28 70 46 69 6c 65 29  Ownership(pFile)
9790: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  ;.  if( rc!=SQLI
97a0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
97b0: 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74 65 78  ite3OsLeaveMutex
97c0: 28 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72  ();.    return r
97d0: 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20  c;.  }..  /* If 
97e0: 73 6f 6d 65 20 74 68 72 65 61 64 20 75 73 69 6e  some thread usin
97f0: 67 20 74 68 69 73 20 50 49 44 20 68 61 73 20 61  g this PID has a
9800: 20 6c 6f 63 6b 20 76 69 61 20 61 20 64 69 66 66   lock via a diff
9810: 65 72 65 6e 74 20 4f 73 46 69 6c 65 2a 0a 20 20  erent OsFile*.  
9820: 2a 2a 20 68 61 6e 64 6c 65 20 74 68 61 74 20 70  ** handle that p
9830: 72 65 63 6c 75 64 65 73 20 74 68 65 20 72 65 71  recludes the req
9840: 75 65 73 74 65 64 20 6c 6f 63 6b 2c 20 72 65 74  uested lock, ret
9850: 75 72 6e 20 42 55 53 59 2e 0a 20 20 2a 2f 0a 20  urn BUSY..  */. 
9860: 20 69 66 28 20 28 70 46 69 6c 65 2d 3e 6c 6f 63   if( (pFile->loc
9870: 6b 74 79 70 65 21 3d 70 4c 6f 63 6b 2d 3e 6c 6f  ktype!=pLock->lo
9880: 63 6b 74 79 70 65 20 26 26 20 0a 20 20 20 20 20  cktype && .     
9890: 20 20 20 20 20 28 70 4c 6f 63 6b 2d 3e 6c 6f 63       (pLock->loc
98a0: 6b 74 79 70 65 3e 3d 50 45 4e 44 49 4e 47 5f 4c  ktype>=PENDING_L
98b0: 4f 43 4b 20 7c 7c 20 6c 6f 63 6b 74 79 70 65 3e  OCK || locktype>
98c0: 53 48 41 52 45 44 5f 4c 4f 43 4b 29 29 0a 20 20  SHARED_LOCK)).  
98d0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
98e0: 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 67 6f 74  TE_BUSY;.    got
98f0: 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a  o end_lock;.  }.
9900: 0a 20 20 2f 2a 20 49 66 20 61 20 53 48 41 52 45  .  /* If a SHARE
9910: 44 20 6c 6f 63 6b 20 69 73 20 72 65 71 75 65 73  D lock is reques
9920: 74 65 64 2c 20 61 6e 64 20 73 6f 6d 65 20 74 68  ted, and some th
9930: 72 65 61 64 20 75 73 69 6e 67 20 74 68 69 73 20  read using this 
9940: 50 49 44 20 61 6c 72 65 61 64 79 0a 20 20 2a 2a  PID already.  **
9950: 20 68 61 73 20 61 20 53 48 41 52 45 44 20 6f 72   has a SHARED or
9960: 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20   RESERVED lock, 
9970: 74 68 65 6e 20 69 6e 63 72 65 6d 65 6e 74 20 72  then increment r
9980: 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 73 20  eference counts 
9990: 61 6e 64 0a 20 20 2a 2a 20 72 65 74 75 72 6e 20  and.  ** return 
99a0: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 20 20 2a 2f 0a  SQLITE_OK..  */.
99b0: 20 20 69 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d    if( locktype==
99c0: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 26 26 20 0a  SHARED_LOCK && .
99d0: 20 20 20 20 20 20 28 70 4c 6f 63 6b 2d 3e 6c 6f        (pLock->lo
99e0: 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c  cktype==SHARED_L
99f0: 4f 43 4b 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 6c 6f  OCK || pLock->lo
9a00: 63 6b 74 79 70 65 3d 3d 52 45 53 45 52 56 45 44  cktype==RESERVED
9a10: 5f 4c 4f 43 4b 29 20 29 7b 0a 20 20 20 20 61 73  _LOCK) ){.    as
9a20: 73 65 72 74 28 20 6c 6f 63 6b 74 79 70 65 3d 3d  sert( locktype==
9a30: 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20  SHARED_LOCK );. 
9a40: 20 20 20 61 73 73 65 72 74 28 20 70 46 69 6c 65     assert( pFile
9a50: 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d 30 20 29 3b  ->locktype==0 );
9a60: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f  .    assert( pLo
9a70: 63 6b 2d 3e 63 6e 74 3e 30 20 29 3b 0a 20 20 20  ck->cnt>0 );.   
9a80: 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65   pFile->locktype
9a90: 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a   = SHARED_LOCK;.
9aa0: 20 20 20 20 70 4c 6f 63 6b 2d 3e 63 6e 74 2b 2b      pLock->cnt++
9ab0: 3b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 70 4f 70  ;.    pFile->pOp
9ac0: 65 6e 2d 3e 6e 4c 6f 63 6b 2b 2b 3b 0a 20 20 20  en->nLock++;.   
9ad0: 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a   goto end_lock;.
9ae0: 20 20 7d 0a 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65    }..  lock.l_le
9af0: 6e 20 3d 20 31 4c 3b 0a 0a 20 20 6c 6f 63 6b 2e  n = 1L;..  lock.
9b00: 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f  l_whence = SEEK_
9b10: 53 45 54 3b 0a 0a 20 20 2f 2a 20 41 20 50 45 4e  SET;..  /* A PEN
9b20: 44 49 4e 47 20 6c 6f 63 6b 20 69 73 20 6e 65 65  DING lock is nee
9b30: 64 65 64 20 62 65 66 6f 72 65 20 61 63 71 75 69  ded before acqui
9b40: 72 69 6e 67 20 61 20 53 48 41 52 45 44 20 6c 6f  ring a SHARED lo
9b50: 63 6b 20 61 6e 64 20 62 65 66 6f 72 65 0a 20 20  ck and before.  
9b60: 2a 2a 20 61 63 71 75 69 72 69 6e 67 20 61 6e 20  ** acquiring an 
9b70: 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20  EXCLUSIVE lock. 
9b80: 20 46 6f 72 20 74 68 65 20 53 48 41 52 45 44 20   For the SHARED 
9b90: 6c 6f 63 6b 2c 20 74 68 65 20 50 45 4e 44 49 4e  lock, the PENDIN
9ba0: 47 20 77 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 72  G will.  ** be r
9bb0: 65 6c 65 61 73 65 64 2e 0a 20 20 2a 2f 0a 20 20  eleased..  */.  
9bc0: 69 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48  if( locktype==SH
9bd0: 41 52 45 44 5f 4c 4f 43 4b 20 0a 20 20 20 20 20  ARED_LOCK .     
9be0: 20 7c 7c 20 28 6c 6f 63 6b 74 79 70 65 3d 3d 45   || (locktype==E
9bf0: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26  XCLUSIVE_LOCK &&
9c00: 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65   pFile->locktype
9c10: 3c 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 29 0a 20  <PENDING_LOCK). 
9c20: 20 29 7b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74   ){.    lock.l_t
9c30: 79 70 65 20 3d 20 28 6c 6f 63 6b 74 79 70 65 3d  ype = (locktype=
9c40: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 3f 46 5f 52  =SHARED_LOCK?F_R
9c50: 44 4c 43 4b 3a 46 5f 57 52 4c 43 4b 29 3b 0a 20  DLCK:F_WRLCK);. 
9c60: 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20     lock.l_start 
9c70: 3d 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a  = PENDING_BYTE;.
9c80: 20 20 20 20 73 20 3d 20 66 63 6e 74 6c 28 70 46      s = fcntl(pF
9c90: 69 6c 65 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c  ile->h, F_SETLK,
9ca0: 20 26 6c 6f 63 6b 29 3b 0a 20 20 20 20 69 66 28   &lock);.    if(
9cb0: 20 73 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d   s ){.      rc =
9cc0: 20 28 65 72 72 6e 6f 3d 3d 45 49 4e 56 41 4c 29   (errno==EINVAL)
9cd0: 20 3f 20 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20   ? SQLITE_NOLFS 
9ce0: 3a 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20  : SQLITE_BUSY;. 
9cf0: 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f       goto end_lo
9d00: 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a  ck;.    }.  }...
9d10: 20 20 2f 2a 20 49 66 20 63 6f 6e 74 72 6f 6c 20    /* If control 
9d20: 67 65 74 73 20 74 6f 20 74 68 69 73 20 70 6f 69  gets to this poi
9d30: 6e 74 2c 20 74 68 65 6e 20 61 63 74 75 61 6c 6c  nt, then actuall
9d40: 79 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20 6d  y go ahead and m
9d50: 61 6b 65 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69  ake.  ** operati
9d60: 6e 67 20 73 79 73 74 65 6d 20 63 61 6c 6c 73 20  ng system calls 
9d70: 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 65  for the specifie
9d80: 64 20 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20 69  d lock..  */.  i
9d90: 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41  f( locktype==SHA
9da0: 52 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20  RED_LOCK ){.    
9db0: 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 63  assert( pLock->c
9dc0: 6e 74 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  nt==0 );.    ass
9dd0: 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b  ert( pLock->lock
9de0: 74 79 70 65 3d 3d 30 20 29 3b 0a 0a 20 20 20 20  type==0 );..    
9df0: 2f 2a 20 4e 6f 77 20 67 65 74 20 74 68 65 20 72  /* Now get the r
9e00: 65 61 64 2d 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20  ead-lock */.    
9e10: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53  lock.l_start = S
9e20: 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20 20 20  HARED_FIRST;.   
9e30: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48   lock.l_len = SH
9e40: 41 52 45 44 5f 53 49 5a 45 3b 0a 20 20 20 20 73  ARED_SIZE;.    s
9e50: 20 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e   = fcntl(pFile->
9e60: 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63  h, F_SETLK, &loc
9e70: 6b 29 3b 0a 0a 20 20 20 20 2f 2a 20 44 72 6f 70  k);..    /* Drop
9e80: 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 50   the temporary P
9e90: 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 2a 2f 0a 20  ENDING lock */. 
9ea0: 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20     lock.l_start 
9eb0: 3d 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a  = PENDING_BYTE;.
9ec0: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d      lock.l_len =
9ed0: 20 31 4c 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f   1L;.    lock.l_
9ee0: 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a  type = F_UNLCK;.
9ef0: 20 20 20 20 69 66 28 20 66 63 6e 74 6c 28 70 46      if( fcntl(pF
9f00: 69 6c 65 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c  ile->h, F_SETLK,
9f10: 20 26 6c 6f 63 6b 29 21 3d 30 20 29 7b 0a 20 20   &lock)!=0 ){.  
9f20: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
9f30: 49 4f 45 52 52 3b 20 20 2f 2a 20 54 68 69 73 20  IOERR;  /* This 
9f40: 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 68 61 70  should never hap
9f50: 70 65 6e 20 2a 2f 0a 20 20 20 20 20 20 67 6f 74  pen */.      got
9f60: 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20  o end_lock;.    
9f70: 7d 0a 20 20 20 20 69 66 28 20 73 20 29 7b 0a 20  }.    if( s ){. 
9f80: 20 20 20 20 20 72 63 20 3d 20 28 65 72 72 6e 6f       rc = (errno
9f90: 3d 3d 45 49 4e 56 41 4c 29 20 3f 20 53 51 4c 49  ==EINVAL) ? SQLI
9fa0: 54 45 5f 4e 4f 4c 46 53 20 3a 20 53 51 4c 49 54  TE_NOLFS : SQLIT
9fb0: 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d 65 6c 73  E_BUSY;.    }els
9fc0: 65 7b 0a 20 20 20 20 20 20 70 46 69 6c 65 2d 3e  e{.      pFile->
9fd0: 6c 6f 63 6b 74 79 70 65 20 3d 20 53 48 41 52 45  locktype = SHARE
9fe0: 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 70 46  D_LOCK;.      pF
9ff0: 69 6c 65 2d 3e 70 4f 70 65 6e 2d 3e 6e 4c 6f 63  ile->pOpen->nLoc
a000: 6b 2b 2b 3b 0a 20 20 20 20 20 20 70 4c 6f 63 6b  k++;.      pLock
a010: 2d 3e 63 6e 74 20 3d 20 31 3b 0a 20 20 20 20 7d  ->cnt = 1;.    }
a020: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63  .  }else if( loc
a030: 6b 74 79 70 65 3d 3d 45 58 43 4c 55 53 49 56 45  ktype==EXCLUSIVE
a040: 5f 4c 4f 43 4b 20 26 26 20 70 4c 6f 63 6b 2d 3e  _LOCK && pLock->
a050: 63 6e 74 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20  cnt>1 ){.    /* 
a060: 57 65 20 61 72 65 20 74 72 79 69 6e 67 20 66 6f  We are trying fo
a070: 72 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c  r an exclusive l
a080: 6f 63 6b 20 62 75 74 20 61 6e 6f 74 68 65 72 20  ock but another 
a090: 74 68 72 65 61 64 20 69 6e 20 74 68 69 73 0a 20  thread in this. 
a0a0: 20 20 20 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65     ** same proce
a0b0: 73 73 20 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64  ss is still hold
a0c0: 69 6e 67 20 61 20 73 68 61 72 65 64 20 6c 6f 63  ing a shared loc
a0d0: 6b 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53  k. */.    rc = S
a0e0: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65  QLITE_BUSY;.  }e
a0f0: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20  lse{.    /* The 
a100: 72 65 71 75 65 73 74 20 77 61 73 20 66 6f 72 20  request was for 
a110: 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58  a RESERVED or EX
a120: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49  CLUSIVE lock.  I
a130: 74 20 69 73 0a 20 20 20 20 2a 2a 20 61 73 73 75  t is.    ** assu
a140: 6d 65 64 20 74 68 61 74 20 74 68 65 72 65 20 69  med that there i
a150: 73 20 61 20 53 48 41 52 45 44 20 6f 72 20 67 72  s a SHARED or gr
a160: 65 61 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68  eater lock on th
a170: 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c  e file.    ** al
a180: 72 65 61 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20  ready..    */.  
a190: 20 20 61 73 73 65 72 74 28 20 30 21 3d 70 46 69    assert( 0!=pFi
a1a0: 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 20 29 3b 0a  le->locktype );.
a1b0: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20      lock.l_type 
a1c0: 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 73  = F_WRLCK;.    s
a1d0: 77 69 74 63 68 28 20 6c 6f 63 6b 74 79 70 65 20  witch( locktype 
a1e0: 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20 52 45  ){.      case RE
a1f0: 53 45 52 56 45 44 5f 4c 4f 43 4b 3a 0a 20 20 20  SERVED_LOCK:.   
a200: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72       lock.l_star
a210: 74 20 3d 20 52 45 53 45 52 56 45 44 5f 42 59 54  t = RESERVED_BYT
a220: 45 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  E;.        break
a230: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 45 58 43  ;.      case EXC
a240: 4c 55 53 49 56 45 5f 4c 4f 43 4b 3a 0a 20 20 20  LUSIVE_LOCK:.   
a250: 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72       lock.l_star
a260: 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53 54  t = SHARED_FIRST
a270: 3b 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c  ;.        lock.l
a280: 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49  _len = SHARED_SI
a290: 5a 45 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61  ZE;.        brea
a2a0: 6b 3b 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74  k;.      default
a2b0: 3a 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74  :.        assert
a2c0: 28 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  (0);.    }.    s
a2d0: 20 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e   = fcntl(pFile->
a2e0: 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63  h, F_SETLK, &loc
a2f0: 6b 29 3b 0a 20 20 20 20 69 66 28 20 73 20 29 7b  k);.    if( s ){
a300: 0a 20 20 20 20 20 20 72 63 20 3d 20 28 65 72 72  .      rc = (err
a310: 6e 6f 3d 3d 45 49 4e 56 41 4c 29 20 3f 20 53 51  no==EINVAL) ? SQ
a320: 4c 49 54 45 5f 4e 4f 4c 46 53 20 3a 20 53 51 4c  LITE_NOLFS : SQL
a330: 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a  ITE_BUSY;.    }.
a340: 20 20 7d 0a 20 20 0a 20 20 69 66 28 20 72 63 3d    }.  .  if( rc=
a350: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
a360: 20 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70    pFile->locktyp
a370: 65 20 3d 20 6c 6f 63 6b 74 79 70 65 3b 0a 20 20  e = locktype;.  
a380: 20 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70    pLock->locktyp
a390: 65 20 3d 20 6c 6f 63 6b 74 79 70 65 3b 0a 20 20  e = locktype;.  
a3a0: 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b 74 79  }else if( lockty
a3b0: 70 65 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f  pe==EXCLUSIVE_LO
a3c0: 43 4b 20 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d  CK ){.    pFile-
a3d0: 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 50 45 4e 44  >locktype = PEND
a3e0: 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 4c  ING_LOCK;.    pL
a3f0: 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20  ock->locktype = 
a400: 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20  PENDING_LOCK;.  
a410: 7d 0a 0a 65 6e 64 5f 6c 6f 63 6b 3a 0a 20 20 73  }..end_lock:.  s
a420: 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74  qlite3OsLeaveMut
a430: 65 78 28 29 3b 0a 20 20 54 52 41 43 45 34 28 22  ex();.  TRACE4("
a440: 4c 4f 43 4b 20 20 20 20 25 64 20 25 73 20 25 73  LOCK    %d %s %s
a450: 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 6c  \n", pFile->h, l
a460: 6f 63 6b 74 79 70 65 4e 61 6d 65 28 6c 6f 63 6b  ocktypeName(lock
a470: 74 79 70 65 29 2c 20 0a 20 20 20 20 20 20 72 63  type), .      rc
a480: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 22 6f  ==SQLITE_OK ? "o
a490: 6b 22 20 3a 20 22 66 61 69 6c 65 64 22 29 3b 0a  k" : "failed");.
a4a0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
a4b0: 2f 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20  /*.** Lower the 
a4c0: 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e  locking level on
a4d0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
a4e0: 20 70 46 69 6c 65 20 74 6f 20 6c 6f 63 6b 74 79   pFile to lockty
a4f0: 70 65 2e 20 20 6c 6f 63 6b 74 79 70 65 0a 2a 2a  pe.  locktype.**
a500: 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20   must be either 
a510: 4e 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45  NO_LOCK or SHARE
a520: 44 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66  D_LOCK..**.** If
a530: 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76   the locking lev
a540: 65 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64  el of the file d
a550: 65 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72  escriptor is alr
a560: 65 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77  eady at or below
a570: 0a 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65  .** the requeste
a580: 64 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c  d locking level,
a590: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   this routine is
a5a0: 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20   a no-op..**.** 
a5b0: 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62  It is not possib
a5c0: 6c 65 20 66 6f 72 20 74 68 69 73 20 72 6f 75 74  le for this rout
a5d0: 69 6e 65 20 74 6f 20 66 61 69 6c 20 69 66 20 74  ine to fail if t
a5e0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
a5f0: 6e 74 0a 2a 2a 20 69 73 20 4e 4f 5f 4c 4f 43 4b  nt.** is NO_LOCK
a600: 2e 20 20 49 66 20 74 68 65 20 73 65 63 6f 6e 64  .  If the second
a610: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 53 48 41   argument is SHA
a620: 52 45 44 5f 4c 4f 43 4b 2c 20 74 68 69 73 20 72  RED_LOCK, this r
a630: 6f 75 74 69 6e 65 0a 2a 2a 20 6d 69 67 68 74 20  outine.** might 
a640: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f  return SQLITE_IO
a650: 45 52 52 20 69 6e 73 74 65 61 64 20 6f 66 20 53  ERR instead of S
a660: 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61  QLITE_OK..*/.sta
a670: 74 69 63 20 69 6e 74 20 75 6e 69 78 55 6e 6c 6f  tic int unixUnlo
a680: 63 6b 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69  ck(OsFile *id, i
a690: 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b 0a 20 20  nt locktype){.  
a6a0: 73 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20  struct lockInfo 
a6b0: 2a 70 4c 6f 63 6b 3b 0a 20 20 73 74 72 75 63 74  *pLock;.  struct
a6c0: 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69   flock lock;.  i
a6d0: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
a6e0: 4b 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70  K;.  unixFile *p
a6f0: 46 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65  File = (unixFile
a700: 2a 29 69 64 3b 0a 0a 20 20 61 73 73 65 72 74 28  *)id;..  assert(
a710: 20 70 46 69 6c 65 20 29 3b 0a 20 20 54 52 41 43   pFile );.  TRAC
a720: 45 37 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25  E7("UNLOCK  %d %
a730: 64 20 77 61 73 20 25 64 28 25 64 2c 25 64 29 20  d was %d(%d,%d) 
a740: 70 69 64 3d 25 64 5c 6e 22 2c 20 70 46 69 6c 65  pid=%d\n", pFile
a750: 2d 3e 68 2c 20 6c 6f 63 6b 74 79 70 65 2c 0a 20  ->h, locktype,. 
a760: 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b       pFile->lock
a770: 74 79 70 65 2c 20 70 46 69 6c 65 2d 3e 70 4c 6f  type, pFile->pLo
a780: 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 2c 20 70 46  ck->locktype, pF
a790: 69 6c 65 2d 3e 70 4c 6f 63 6b 2d 3e 63 6e 74 2c  ile->pLock->cnt,
a7a0: 20 67 65 74 70 69 64 28 29 29 3b 0a 0a 20 20 61   getpid());..  a
a7b0: 73 73 65 72 74 28 20 6c 6f 63 6b 74 79 70 65 3c  ssert( locktype<
a7c0: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a  =SHARED_LOCK );.
a7d0: 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 6c 6f 63    if( pFile->loc
a7e0: 6b 74 79 70 65 3c 3d 6c 6f 63 6b 74 79 70 65 20  ktype<=locktype 
a7f0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
a800: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69  LITE_OK;.  }.  i
a810: 66 28 20 43 48 45 43 4b 5f 54 48 52 45 41 44 49  f( CHECK_THREADI
a820: 44 28 70 46 69 6c 65 29 20 29 20 72 65 74 75 72  D(pFile) ) retur
a830: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
a840: 0a 20 20 73 71 6c 69 74 65 33 4f 73 45 6e 74 65  .  sqlite3OsEnte
a850: 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 4c 6f 63  rMutex();.  pLoc
a860: 6b 20 3d 20 70 46 69 6c 65 2d 3e 70 4c 6f 63 6b  k = pFile->pLock
a870: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63  ;.  assert( pLoc
a880: 6b 2d 3e 63 6e 74 21 3d 30 20 29 3b 0a 20 20 69  k->cnt!=0 );.  i
a890: 66 28 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79  f( pFile->lockty
a8a0: 70 65 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29  pe>SHARED_LOCK )
a8b0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c  {.    assert( pL
a8c0: 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d 70  ock->locktype==p
a8d0: 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 20 29  File->locktype )
a8e0: 3b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 74 79  ;.    if( lockty
a8f0: 70 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20  pe==SHARED_LOCK 
a900: 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f  ){.      lock.l_
a910: 74 79 70 65 20 3d 20 46 5f 52 44 4c 43 4b 3b 0a  type = F_RDLCK;.
a920: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65        lock.l_whe
a930: 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a  nce = SEEK_SET;.
a940: 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61        lock.l_sta
a950: 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52 53  rt = SHARED_FIRS
a960: 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f  T;.      lock.l_
a970: 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a  len = SHARED_SIZ
a980: 45 3b 0a 20 20 20 20 20 20 69 66 28 20 66 63 6e  E;.      if( fcn
a990: 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 46 5f 53  tl(pFile->h, F_S
a9a0: 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 21 3d 30 20  ETLK, &lock)!=0 
a9b0: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68  ){.        /* Th
a9c0: 69 73 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20  is should never 
a9d0: 68 61 70 70 65 6e 20 2a 2f 0a 20 20 20 20 20 20  happen */.      
a9e0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f    rc = SQLITE_IO
a9f0: 45 52 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ERR;.      }.   
aa00: 20 7d 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79   }.    lock.l_ty
aa10: 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20  pe = F_UNLCK;.  
aa20: 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20    lock.l_whence 
aa30: 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20  = SEEK_SET;.    
aa40: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50  lock.l_start = P
aa50: 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20  ENDING_BYTE;.   
aa60: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 32 4c   lock.l_len = 2L
aa70: 3b 20 20 61 73 73 65 72 74 28 20 50 45 4e 44 49  ;  assert( PENDI
aa80: 4e 47 5f 42 59 54 45 2b 31 3d 3d 52 45 53 45 52  NG_BYTE+1==RESER
aa90: 56 45 44 5f 42 59 54 45 20 29 3b 0a 20 20 20 20  VED_BYTE );.    
aaa0: 69 66 28 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d  if( fcntl(pFile-
aab0: 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f  >h, F_SETLK, &lo
aac0: 63 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  ck)==0 ){.      
aad0: 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20  pLock->locktype 
aae0: 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20  = SHARED_LOCK;. 
aaf0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
ab00: 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52  rc = SQLITE_IOER
ab10: 52 3b 20 20 2f 2a 20 54 68 69 73 20 73 68 6f 75  R;  /* This shou
ab20: 6c 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e 20  ld never happen 
ab30: 2a 2f 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69  */.    }.  }.  i
ab40: 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 4e 4f 5f  f( locktype==NO_
ab50: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 73 74 72 75  LOCK ){.    stru
ab60: 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 70 65  ct openCnt *pOpe
ab70: 6e 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65  n;..    /* Decre
ab80: 6d 65 6e 74 20 74 68 65 20 73 68 61 72 65 64 20  ment the shared 
ab90: 6c 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20 20 52  lock counter.  R
aba0: 65 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b 20  elease the lock 
abb0: 75 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a 20  using an.    ** 
abc0: 4f 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77 68 65  OS call only whe
abd0: 6e 20 61 6c 6c 20 74 68 72 65 61 64 73 20 69 6e  n all threads in
abe0: 20 74 68 69 73 20 73 61 6d 65 20 70 72 6f 63 65   this same proce
abf0: 73 73 20 68 61 76 65 20 72 65 6c 65 61 73 65 64  ss have released
ac00: 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63 6b  .    ** the lock
ac10: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4c 6f  ..    */.    pLo
ac20: 63 6b 2d 3e 63 6e 74 2d 2d 3b 0a 20 20 20 20 69  ck->cnt--;.    i
ac30: 66 28 20 70 4c 6f 63 6b 2d 3e 63 6e 74 3d 3d 30  f( pLock->cnt==0
ac40: 20 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c   ){.      lock.l
ac50: 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b  _type = F_UNLCK;
ac60: 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68  .      lock.l_wh
ac70: 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b  ence = SEEK_SET;
ac80: 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74  .      lock.l_st
ac90: 61 72 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e  art = lock.l_len
aca0: 20 3d 20 30 4c 3b 0a 20 20 20 20 20 20 69 66 28   = 0L;.      if(
acb0: 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c   fcntl(pFile->h,
acc0: 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29   F_SETLK, &lock)
acd0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70  ==0 ){.        p
ace0: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d  Lock->locktype =
acf0: 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 20   NO_LOCK;.      
ad00: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 72  }else{.        r
ad10: 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52  c = SQLITE_IOERR
ad20: 3b 20 20 2f 2a 20 54 68 69 73 20 73 68 6f 75 6c  ;  /* This shoul
ad30: 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e 20 2a  d never happen *
ad40: 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  /.      }.    }.
ad50: 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e  .    /* Decremen
ad60: 74 20 74 68 65 20 63 6f 75 6e 74 20 6f 66 20 6c  t the count of l
ad70: 6f 63 6b 73 20 61 67 61 69 6e 73 74 20 74 68 69  ocks against thi
ad80: 73 20 73 61 6d 65 20 66 69 6c 65 2e 20 20 57 68  s same file.  Wh
ad90: 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 6f  en the.    ** co
ada0: 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65 72 6f  unt reaches zero
adb0: 2c 20 63 6c 6f 73 65 20 61 6e 79 20 6f 74 68 65  , close any othe
adc0: 72 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  r file descripto
add0: 72 73 20 77 68 6f 73 65 20 63 6c 6f 73 65 0a 20  rs whose close. 
ade0: 20 20 20 2a 2a 20 77 61 73 20 64 65 66 65 72 72     ** was deferr
adf0: 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 6f 75  ed because of ou
ae00: 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 2e  tstanding locks.
ae10: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4f 70 65  .    */.    pOpe
ae20: 6e 20 3d 20 70 46 69 6c 65 2d 3e 70 4f 70 65 6e  n = pFile->pOpen
ae30: 3b 0a 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 4c 6f  ;.    pOpen->nLo
ae40: 63 6b 2d 2d 3b 0a 20 20 20 20 61 73 73 65 72 74  ck--;.    assert
ae50: 28 20 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b 3e 3d  ( pOpen->nLock>=
ae60: 30 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 70  0 );.    if( pOp
ae70: 65 6e 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 26 26 20  en->nLock==0 && 
ae80: 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67 3e  pOpen->nPending>
ae90: 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69  0 ){.      int i
aea0: 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b  ;.      for(i=0;
aeb0: 20 69 3c 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69   i<pOpen->nPendi
aec0: 6e 67 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  ng; i++){.      
aed0: 20 20 63 6c 6f 73 65 28 70 4f 70 65 6e 2d 3e 61    close(pOpen->a
aee0: 50 65 6e 64 69 6e 67 5b 69 5d 29 3b 0a 20 20 20  Pending[i]);.   
aef0: 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74     }.      sqlit
af00: 65 46 72 65 65 28 70 4f 70 65 6e 2d 3e 61 50 65  eFree(pOpen->aPe
af10: 6e 64 69 6e 67 29 3b 0a 20 20 20 20 20 20 70 4f  nding);.      pO
af20: 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67 20 3d 20  pen->nPending = 
af30: 30 3b 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e  0;.      pOpen->
af40: 61 50 65 6e 64 69 6e 67 20 3d 20 30 3b 0a 20 20  aPending = 0;.  
af50: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65    }.  }.  sqlite
af60: 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b  3OsLeaveMutex();
af70: 0a 20 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79  .  pFile->lockty
af80: 70 65 20 3d 20 6c 6f 63 6b 74 79 70 65 3b 0a 20  pe = locktype;. 
af90: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
afa0: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 66 69 6c  *.** Close a fil
afb0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
afc0: 20 75 6e 69 78 43 6c 6f 73 65 28 4f 73 46 69 6c   unixClose(OsFil
afd0: 65 20 2a 2a 70 49 64 29 7b 0a 20 20 75 6e 69 78  e **pId){.  unix
afe0: 46 69 6c 65 20 2a 69 64 20 3d 20 28 75 6e 69 78  File *id = (unix
aff0: 46 69 6c 65 2a 29 2a 70 49 64 3b 0a 20 20 69 6e  File*)*pId;.  in
b000: 74 20 72 63 3b 0a 0a 20 20 69 66 28 20 21 69 64  t rc;..  if( !id
b010: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45   ) return SQLITE
b020: 5f 4f 4b 3b 0a 20 20 72 63 20 3d 20 75 6e 69 78  _OK;.  rc = unix
b030: 55 6e 6c 6f 63 6b 28 2a 70 49 64 2c 20 4e 4f 5f  Unlock(*pId, NO_
b040: 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 72 63 20  LOCK);.  if( rc 
b050: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 69  ) return rc;.  i
b060: 66 28 20 69 64 2d 3e 64 69 72 66 64 3e 3d 30 20  f( id->dirfd>=0 
b070: 29 20 63 6c 6f 73 65 28 69 64 2d 3e 64 69 72 66  ) close(id->dirf
b080: 64 29 3b 0a 20 20 69 64 2d 3e 64 69 72 66 64 20  d);.  id->dirfd 
b090: 3d 20 2d 31 3b 0a 20 20 73 71 6c 69 74 65 33 4f  = -1;.  sqlite3O
b0a0: 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 0a  sEnterMutex();..
b0b0: 20 20 69 66 28 20 69 64 2d 3e 70 4f 70 65 6e 2d    if( id->pOpen-
b0c0: 3e 6e 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 2f 2a  >nLock ){.    /*
b0d0: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f 75   If there are ou
b0e0: 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 2c  tstanding locks,
b0f0: 20 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79   do not actually
b100: 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20   close the file 
b110: 6a 75 73 74 0a 20 20 20 20 2a 2a 20 79 65 74 20  just.    ** yet 
b120: 62 65 63 61 75 73 65 20 74 68 61 74 20 77 6f 75  because that wou
b130: 6c 64 20 63 6c 65 61 72 20 74 68 6f 73 65 20 6c  ld clear those l
b140: 6f 63 6b 73 2e 20 20 49 6e 73 74 65 61 64 2c 20  ocks.  Instead, 
b150: 61 64 64 20 74 68 65 20 66 69 6c 65 0a 20 20 20  add the file.   
b160: 20 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 74   ** descriptor t
b170: 6f 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e  o pOpen->aPendin
b180: 67 2e 20 20 49 74 20 77 69 6c 6c 20 62 65 20 61  g.  It will be a
b190: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f  utomatically clo
b1a0: 73 65 64 20 77 68 65 6e 0a 20 20 20 20 2a 2a 20  sed when.    ** 
b1b0: 74 68 65 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73  the last lock is
b1c0: 20 63 6c 65 61 72 65 64 2e 0a 20 20 20 20 2a 2f   cleared..    */
b1d0: 0a 20 20 20 20 69 6e 74 20 2a 61 4e 65 77 3b 0a  .    int *aNew;.
b1e0: 20 20 20 20 73 74 72 75 63 74 20 6f 70 65 6e 43      struct openC
b1f0: 6e 74 20 2a 70 4f 70 65 6e 20 3d 20 69 64 2d 3e  nt *pOpen = id->
b200: 70 4f 70 65 6e 3b 0a 20 20 20 20 61 4e 65 77 20  pOpen;.    aNew 
b210: 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28  = sqliteRealloc(
b220: 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e 67   pOpen->aPending
b230: 2c 20 28 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69  , (pOpen->nPendi
b240: 6e 67 2b 31 29 2a 73 69 7a 65 6f 66 28 69 6e 74  ng+1)*sizeof(int
b250: 29 20 29 3b 0a 20 20 20 20 69 66 28 20 61 4e 65  ) );.    if( aNe
b260: 77 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  w==0 ){.      /*
b270: 20 49 66 20 61 20 6d 61 6c 6c 6f 63 20 66 61 69   If a malloc fai
b280: 6c 73 2c 20 6a 75 73 74 20 6c 65 61 6b 20 74 68  ls, just leak th
b290: 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  e file descripto
b2a0: 72 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  r */.    }else{.
b2b0: 20 20 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50 65        pOpen->aPe
b2c0: 6e 64 69 6e 67 20 3d 20 61 4e 65 77 3b 0a 20 20  nding = aNew;.  
b2d0: 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64      pOpen->aPend
b2e0: 69 6e 67 5b 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64  ing[pOpen->nPend
b2f0: 69 6e 67 5d 20 3d 20 69 64 2d 3e 68 3b 0a 20 20  ing] = id->h;.  
b300: 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64      pOpen->nPend
b310: 69 6e 67 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d  ing++;.    }.  }
b320: 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65  else{.    /* The
b330: 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61  re are no outsta
b340: 6e 64 69 6e 67 20 6c 6f 63 6b 73 20 73 6f 20 77  nding locks so w
b350: 65 20 63 61 6e 20 63 6c 6f 73 65 20 74 68 65 20  e can close the 
b360: 66 69 6c 65 20 69 6d 6d 65 64 69 61 74 65 6c 79  file immediately
b370: 20 2a 2f 0a 20 20 20 20 63 6c 6f 73 65 28 69 64   */.    close(id
b380: 2d 3e 68 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65  ->h);.  }.  rele
b390: 61 73 65 4c 6f 63 6b 49 6e 66 6f 28 69 64 2d 3e  aseLockInfo(id->
b3a0: 70 4c 6f 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73  pLock);.  releas
b3b0: 65 4f 70 65 6e 43 6e 74 28 69 64 2d 3e 70 4f 70  eOpenCnt(id->pOp
b3c0: 65 6e 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 4f  en);..  sqlite3O
b3d0: 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20  sLeaveMutex();. 
b3e0: 20 69 64 2d 3e 69 73 4f 70 65 6e 20 3d 20 30 3b   id->isOpen = 0;
b3f0: 0a 20 20 54 52 41 43 45 32 28 22 43 4c 4f 53 45  .  TRACE2("CLOSE
b400: 20 20 20 25 2d 33 64 5c 6e 22 2c 20 69 64 2d 3e     %-3d\n", id->
b410: 68 29 3b 0a 20 20 4f 70 65 6e 43 6f 75 6e 74 65  h);.  OpenCounte
b420: 72 28 2d 31 29 3b 0a 20 20 73 71 6c 69 74 65 46  r(-1);.  sqliteF
b430: 72 65 65 28 69 64 29 3b 0a 20 20 2a 70 49 64 20  ree(id);.  *pId 
b440: 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 0;.  return SQ
b450: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
b460: 2a 20 54 75 72 6e 20 61 20 72 65 6c 61 74 69 76  * Turn a relativ
b470: 65 20 70 61 74 68 6e 61 6d 65 20 69 6e 74 6f 20  e pathname into 
b480: 61 20 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 2e  a full pathname.
b490: 20 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74    Return a point
b4a0: 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 66 75 6c  er.** to the ful
b4b0: 6c 20 70 61 74 68 6e 61 6d 65 20 73 74 6f 72 65  l pathname store
b4c0: 64 20 69 6e 20 73 70 61 63 65 20 6f 62 74 61 69  d in space obtai
b4d0: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
b4e0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 54 68 65 20  alloc()..** The 
b4f0: 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e  calling function
b500: 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20   is responsible 
b510: 66 6f 72 20 66 72 65 65 69 6e 67 20 74 68 69 73  for freeing this
b520: 20 73 70 61 63 65 20 6f 6e 63 65 20 69 74 0a 2a   space once it.*
b530: 2a 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6e  * is no longer n
b540: 65 65 64 65 64 2e 0a 2a 2f 0a 63 68 61 72 20 2a  eeded..*/.char *
b550: 73 71 6c 69 74 65 33 55 6e 69 78 46 75 6c 6c 50  sqlite3UnixFullP
b560: 61 74 68 6e 61 6d 65 28 63 6f 6e 73 74 20 63 68  athname(const ch
b570: 61 72 20 2a 7a 52 65 6c 61 74 69 76 65 29 7b 0a  ar *zRelative){.
b580: 20 20 63 68 61 72 20 2a 7a 46 75 6c 6c 20 3d 20    char *zFull = 
b590: 30 3b 0a 20 20 69 66 28 20 7a 52 65 6c 61 74 69  0;.  if( zRelati
b5a0: 76 65 5b 30 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20  ve[0]=='/' ){.  
b5b0: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
b5c0: 6e 67 28 26 7a 46 75 6c 6c 2c 20 7a 52 65 6c 61  ng(&zFull, zRela
b5d0: 74 69 76 65 2c 20 28 63 68 61 72 2a 29 30 29 3b  tive, (char*)0);
b5e0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63 68  .  }else{.    ch
b5f0: 61 72 20 2a 7a 42 75 66 20 3d 20 73 71 6c 69 74  ar *zBuf = sqlit
b600: 65 4d 61 6c 6c 6f 63 28 35 30 30 30 29 3b 0a 20  eMalloc(5000);. 
b610: 20 20 20 69 66 28 20 7a 42 75 66 3d 3d 30 20 29     if( zBuf==0 )
b620: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 30  {.      return 0
b630: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66  ;.    }.    zBuf
b640: 5b 30 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c  [0] = 0;.    sql
b650: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26 7a  ite3SetString(&z
b660: 46 75 6c 6c 2c 20 67 65 74 63 77 64 28 7a 42 75  Full, getcwd(zBu
b670: 66 2c 20 35 30 30 30 29 2c 20 22 2f 22 2c 20 7a  f, 5000), "/", z
b680: 52 65 6c 61 74 69 76 65 2c 0a 20 20 20 20 20 20  Relative,.      
b690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63                (c
b6a0: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 73 71 6c  har*)0);.    sql
b6b0: 69 74 65 46 72 65 65 28 7a 42 75 66 29 3b 0a 20  iteFree(zBuf);. 
b6c0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 46 75 6c   }.  return zFul
b6d0: 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  l;.}../*.** Chan
b6e0: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
b6f0: 74 68 65 20 66 75 6c 6c 73 79 6e 63 20 66 6c 61  the fullsync fla
b700: 67 20 69 6e 20 74 68 65 20 67 69 76 65 6e 20 66  g in the given f
b710: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 0a  ile descriptor..
b720: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75  */.static void u
b730: 6e 69 78 53 65 74 46 75 6c 6c 53 79 6e 63 28 4f  nixSetFullSync(O
b740: 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 76  sFile *id, int v
b750: 29 7b 0a 20 20 28 28 75 6e 69 78 46 69 6c 65 2a  ){.  ((unixFile*
b760: 29 69 64 29 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d  )id)->fullSync =
b770: 20 76 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74   v;.}../*.** Ret
b780: 75 72 6e 20 74 68 65 20 75 6e 64 65 72 6c 79 69  urn the underlyi
b790: 6e 67 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 66  ng file handle f
b7a0: 6f 72 20 61 6e 20 4f 73 46 69 6c 65 0a 2a 2f 0a  or an OsFile.*/.
b7b0: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 46  static int unixF
b7c0: 69 6c 65 48 61 6e 64 6c 65 28 4f 73 46 69 6c 65  ileHandle(OsFile
b7d0: 20 2a 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20   *id){.  return 
b7e0: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
b7f0: 3e 68 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  >h;.}../*.** Ret
b800: 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 74  urn an integer t
b810: 68 61 74 20 69 6e 64 69 63 65 73 20 74 68 65 20  hat indices the 
b820: 74 79 70 65 20 6f 66 20 6c 6f 63 6b 20 63 75 72  type of lock cur
b830: 72 65 6e 74 6c 79 20 68 65 6c 64 0a 2a 2a 20 62  rently held.** b
b840: 79 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 20 20  y this handle.  
b850: 28 55 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e  (Used for testin
b860: 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f  g and analysis o
b870: 6e 6c 79 2e 29 0a 2a 2f 0a 73 74 61 74 69 63 20  nly.).*/.static 
b880: 69 6e 74 20 75 6e 69 78 4c 6f 63 6b 53 74 61 74  int unixLockStat
b890: 65 28 4f 73 46 69 6c 65 20 2a 69 64 29 7b 0a 20  e(OsFile *id){. 
b8a0: 20 72 65 74 75 72 6e 20 28 28 75 6e 69 78 46 69   return ((unixFi
b8b0: 6c 65 2a 29 69 64 29 2d 3e 6c 6f 63 6b 74 79 70  le*)id)->locktyp
b8c0: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  e;.}../*.** This
b8d0: 20 76 65 63 74 6f 72 20 64 65 66 69 6e 65 73 20   vector defines 
b8e0: 61 6c 6c 20 74 68 65 20 6d 65 74 68 6f 64 73 20  all the methods 
b8f0: 74 68 61 74 20 63 61 6e 20 6f 70 65 72 61 74 65  that can operate
b900: 20 6f 6e 20 61 6e 20 4f 73 46 69 6c 65 0a 2a 2a   on an OsFile.**
b910: 20 66 6f 72 20 75 6e 69 78 2e 0a 2a 2f 0a 73 74   for unix..*/.st
b920: 61 74 69 63 20 63 6f 6e 73 74 20 49 6f 4d 65 74  atic const IoMet
b930: 68 6f 64 20 73 71 6c 69 74 65 33 55 6e 69 78 49  hod sqlite3UnixI
b940: 6f 4d 65 74 68 6f 64 20 3d 20 7b 0a 20 20 75 6e  oMethod = {.  un
b950: 69 78 43 6c 6f 73 65 2c 0a 20 20 75 6e 69 78 4f  ixClose,.  unixO
b960: 70 65 6e 44 69 72 65 63 74 6f 72 79 2c 0a 20 20  penDirectory,.  
b970: 75 6e 69 78 52 65 61 64 2c 0a 20 20 75 6e 69 78  unixRead,.  unix
b980: 57 72 69 74 65 2c 0a 20 20 75 6e 69 78 53 65 65  Write,.  unixSee
b990: 6b 2c 0a 20 20 75 6e 69 78 54 72 75 6e 63 61 74  k,.  unixTruncat
b9a0: 65 2c 0a 20 20 75 6e 69 78 53 79 6e 63 2c 0a 20  e,.  unixSync,. 
b9b0: 20 75 6e 69 78 53 65 74 46 75 6c 6c 53 79 6e 63   unixSetFullSync
b9c0: 2c 0a 20 20 75 6e 69 78 46 69 6c 65 48 61 6e 64  ,.  unixFileHand
b9d0: 6c 65 2c 0a 20 20 75 6e 69 78 46 69 6c 65 53 69  le,.  unixFileSi
b9e0: 7a 65 2c 0a 20 20 75 6e 69 78 4c 6f 63 6b 2c 0a  ze,.  unixLock,.
b9f0: 20 20 75 6e 69 78 55 6e 6c 6f 63 6b 2c 0a 20 20    unixUnlock,.  
ba00: 75 6e 69 78 4c 6f 63 6b 53 74 61 74 65 2c 0a 20  unixLockState,. 
ba10: 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72 76   unixCheckReserv
ba20: 65 64 4c 6f 63 6b 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a  edLock,.};../*.*
ba30: 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72  * Allocate memor
ba40: 79 20 66 6f 72 20 61 20 75 6e 69 78 46 69 6c 65  y for a unixFile
ba50: 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68  .  Initialize th
ba60: 65 20 6e 65 77 20 75 6e 69 78 46 69 6c 65 0a 2a  e new unixFile.*
ba70: 2a 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 67  * to the value g
ba80: 69 76 65 6e 20 69 6e 20 70 49 6e 69 74 20 61 6e  iven in pInit an
ba90: 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  d return a point
baa0: 65 72 20 74 6f 20 74 68 65 20 6e 65 77 0a 2a 2a  er to the new.**
bab0: 20 4f 73 46 69 6c 65 2e 20 20 49 66 20 77 65 20   OsFile.  If we 
bac0: 72 75 6e 20 6f 75 74 20 6f 66 20 6d 65 6d 6f 72  run out of memor
bad0: 79 2c 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c  y, close the fil
bae0: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c  e and return NUL
baf0: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  L..*/.static int
bb00: 20 61 6c 6c 6f 63 61 74 65 55 6e 69 78 46 69 6c   allocateUnixFil
bb10: 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 49 6e 69  e(unixFile *pIni
bb20: 74 2c 20 4f 73 46 69 6c 65 20 2a 2a 70 49 64 29  t, OsFile **pId)
bb30: 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 4e  {.  unixFile *pN
bb40: 65 77 3b 0a 20 20 70 4e 65 77 20 3d 20 73 71 6c  ew;.  pNew = sql
bb50: 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f  iteMalloc( sizeo
bb60: 66 28 75 6e 69 78 46 69 6c 65 29 20 29 3b 0a 20  f(unixFile) );. 
bb70: 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 29 7b 0a   if( pNew==0 ){.
bb80: 20 20 20 20 63 6c 6f 73 65 28 70 49 6e 69 74 2d      close(pInit-
bb90: 3e 68 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  >h);.    sqlite3
bba0: 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a  OsEnterMutex();.
bbb0: 20 20 20 20 72 65 6c 65 61 73 65 4c 6f 63 6b 49      releaseLockI
bbc0: 6e 66 6f 28 70 49 6e 69 74 2d 3e 70 4c 6f 63 6b  nfo(pInit->pLock
bbd0: 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 4f 70  );.    releaseOp
bbe0: 65 6e 43 6e 74 28 70 49 6e 69 74 2d 3e 70 4f 70  enCnt(pInit->pOp
bbf0: 65 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  en);.    sqlite3
bc00: 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a  OsLeaveMutex();.
bc10: 20 20 20 20 2a 70 49 64 20 3d 20 30 3b 0a 20 20      *pId = 0;.  
bc20: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
bc30: 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65 7b 0a  NOMEM;.  }else{.
bc40: 20 20 20 20 2a 70 4e 65 77 20 3d 20 2a 70 49 6e      *pNew = *pIn
bc50: 69 74 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 70 4d  it;.    pNew->pM
bc60: 65 74 68 6f 64 20 3d 20 26 73 71 6c 69 74 65 33  ethod = &sqlite3
bc70: 55 6e 69 78 49 6f 4d 65 74 68 6f 64 3b 0a 20 20  UnixIoMethod;.  
bc80: 20 20 2a 70 49 64 20 3d 20 28 4f 73 46 69 6c 65    *pId = (OsFile
bc90: 2a 29 70 4e 65 77 3b 0a 20 20 20 20 4f 70 65 6e  *)pNew;.    Open
bca0: 43 6f 75 6e 74 65 72 28 2b 31 29 3b 0a 20 20 20  Counter(+1);.   
bcb0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
bcc0: 4b 3b 0a 20 20 7d 0a 7d 0a 0a 0a 23 65 6e 64 69  K;.  }.}...#endi
bcd0: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
bce0: 5f 44 49 53 4b 49 4f 20 2a 2f 0a 2f 2a 2a 2a 2a  _DISKIO */./****
bcf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bd00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bd10: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bd20: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bd30: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 45 76 65 72 79  *******.** Every
bd40: 74 68 69 6e 67 20 61 62 6f 76 65 20 64 65 61 6c  thing above deal
bd50: 73 20 77 69 74 68 20 66 69 6c 65 20 49 2f 4f 2e  s with file I/O.
bd60: 20 20 45 76 65 72 79 74 68 69 6e 67 20 74 68 61    Everything tha
bd70: 74 20 66 6f 6c 6c 6f 77 73 20 64 65 61 6c 73 0a  t follows deals.
bd80: 2a 2a 20 77 69 74 68 20 6f 74 68 65 72 20 6d 69  ** with other mi
bd90: 73 63 65 6c 6c 61 6e 6f 75 73 20 61 73 70 65 63  scellanous aspec
bda0: 74 73 20 6f 66 20 74 68 65 20 6f 70 65 72 61 74  ts of the operat
bdb0: 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65 72  ing system inter
bdc0: 66 61 63 65 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  face.***********
bdd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bde0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
bdf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
be00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
be10: 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 69  */.../*.** Get i
be20: 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 6f 20 73 65  nformation to se
be30: 65 64 20 74 68 65 20 72 61 6e 64 6f 6d 20 6e 75  ed the random nu
be40: 6d 62 65 72 20 67 65 6e 65 72 61 74 6f 72 2e 20  mber generator. 
be50: 20 54 68 65 20 73 65 65 64 0a 2a 2a 20 69 73 20   The seed.** is 
be60: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65  written into the
be70: 20 62 75 66 66 65 72 20 7a 42 75 66 5b 32 35 36   buffer zBuf[256
be80: 5d 2e 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20  ].  The calling 
be90: 66 75 6e 63 74 69 6f 6e 20 6d 75 73 74 0a 2a 2a  function must.**
bea0: 20 73 75 70 70 6c 79 20 61 20 73 75 66 66 69 63   supply a suffic
beb0: 69 65 6e 74 6c 79 20 6c 61 72 67 65 20 62 75 66  iently large buf
bec0: 66 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  fer..*/.int sqli
bed0: 74 65 33 55 6e 69 78 52 61 6e 64 6f 6d 53 65 65  te3UnixRandomSee
bee0: 64 28 63 68 61 72 20 2a 7a 42 75 66 29 7b 0a 20  d(char *zBuf){. 
bef0: 20 2f 2a 20 57 65 20 68 61 76 65 20 74 6f 20 69   /* We have to i
bf00: 6e 69 74 69 61 6c 69 7a 65 20 7a 42 75 66 20 74  nitialize zBuf t
bf10: 6f 20 70 72 65 76 65 6e 74 20 76 61 6c 67 72 69  o prevent valgri
bf20: 6e 64 20 66 72 6f 6d 20 72 65 70 6f 72 74 69 6e  nd from reportin
bf30: 67 0a 20 20 2a 2a 20 65 72 72 6f 72 73 2e 20 20  g.  ** errors.  
bf40: 54 68 65 20 72 65 70 6f 72 74 73 20 69 73 73 75  The reports issu
bf50: 65 64 20 62 79 20 76 61 6c 67 72 69 6e 64 20 61  ed by valgrind a
bf60: 72 65 20 69 6e 63 6f 72 72 65 63 74 20 2d 20 77  re incorrect - w
bf70: 65 20 77 6f 75 6c 64 0a 20 20 2a 2a 20 70 72 65  e would.  ** pre
bf80: 66 65 72 20 74 68 61 74 20 74 68 65 20 72 61 6e  fer that the ran
bf90: 64 6f 6d 6e 65 73 73 20 62 65 20 69 6e 63 72 65  domness be incre
bfa0: 61 73 65 64 20 62 79 20 6d 61 6b 69 6e 67 20 75  ased by making u
bfb0: 73 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 75  se of the.  ** u
bfc0: 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 73 70 61  ninitialized spa
bfd0: 63 65 20 69 6e 20 7a 42 75 66 20 2d 20 62 75 74  ce in zBuf - but
bfe0: 20 76 61 6c 67 72 69 6e 64 20 65 72 72 6f 72 73   valgrind errors
bff0: 20 74 65 6e 64 20 74 6f 20 77 6f 72 72 79 0a 20   tend to worry. 
c000: 20 2a 2a 20 73 6f 6d 65 20 75 73 65 72 73 2e 20   ** some users. 
c010: 20 52 61 74 68 65 72 20 74 68 61 6e 20 61 72 67   Rather than arg
c020: 75 65 2c 20 69 74 20 73 65 65 6d 73 20 65 61 73  ue, it seems eas
c030: 69 65 72 20 6a 75 73 74 20 74 6f 20 69 6e 69 74  ier just to init
c040: 69 61 6c 69 7a 65 0a 20 20 2a 2a 20 74 68 65 20  ialize.  ** the 
c050: 77 68 6f 6c 65 20 61 72 72 61 79 20 61 6e 64 20  whole array and 
c060: 73 69 6c 65 6e 63 65 20 76 61 6c 67 72 69 6e 64  silence valgrind
c070: 2c 20 65 76 65 6e 20 69 66 20 74 68 61 74 20 6d  , even if that m
c080: 65 61 6e 73 20 6c 65 73 73 20 72 61 6e 64 6f 6d  eans less random
c090: 6e 65 73 73 0a 20 20 2a 2a 20 69 6e 20 74 68 65  ness.  ** in the
c0a0: 20 72 61 6e 64 6f 6d 20 73 65 65 64 2e 0a 20 20   random seed..  
c0b0: 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 74 65 73  **.  ** When tes
c0c0: 74 69 6e 67 2c 20 69 6e 69 74 69 61 6c 69 7a 69  ting, initializi
c0d0: 6e 67 20 7a 42 75 66 5b 5d 20 74 6f 20 7a 65 72  ng zBuf[] to zer
c0e0: 6f 20 69 73 20 61 6c 6c 20 77 65 20 64 6f 2e 20  o is all we do. 
c0f0: 20 54 68 61 74 20 6d 65 61 6e 73 0a 20 20 2a 2a   That means.  **
c100: 20 74 68 61 74 20 77 65 20 61 6c 77 61 79 73 20   that we always 
c110: 75 73 65 20 74 68 65 20 73 61 6d 65 20 72 61 6e  use the same ran
c120: 64 6f 6d 20 6e 75 6d 62 65 72 20 73 65 71 75 65  dom number seque
c130: 6e 63 65 2e 2a 20 54 68 69 73 20 6d 61 6b 65 73  nce.* This makes
c140: 20 74 68 65 0a 20 20 2a 2a 20 74 65 73 74 73 20   the.  ** tests 
c150: 72 65 70 65 61 74 61 62 6c 65 2e 0a 20 20 2a 2f  repeatable..  */
c160: 0a 20 20 6d 65 6d 73 65 74 28 7a 42 75 66 2c 20  .  memset(zBuf, 
c170: 30 2c 20 32 35 36 29 3b 0a 23 69 66 20 21 64 65  0, 256);.#if !de
c180: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53  fined(SQLITE_TES
c190: 54 29 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 70  T).  {.    int p
c1a0: 69 64 2c 20 66 64 3b 0a 20 20 20 20 66 64 20 3d  id, fd;.    fd =
c1b0: 20 6f 70 65 6e 28 22 2f 64 65 76 2f 75 72 61 6e   open("/dev/uran
c1c0: 64 6f 6d 22 2c 20 4f 5f 52 44 4f 4e 4c 59 29 3b  dom", O_RDONLY);
c1d0: 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 29 7b  .    if( fd<0 ){
c1e0: 0a 20 20 20 20 20 20 74 69 6d 65 5f 74 20 74 3b  .      time_t t;
c1f0: 0a 20 20 20 20 20 20 74 69 6d 65 28 26 74 29 3b  .      time(&t);
c200: 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a 42  .      memcpy(zB
c210: 75 66 2c 20 26 74 2c 20 73 69 7a 65 6f 66 28 74  uf, &t, sizeof(t
c220: 29 29 3b 0a 20 20 20 20 20 20 70 69 64 20 3d 20  ));.      pid = 
c230: 67 65 74 70 69 64 28 29 3b 0a 20 20 20 20 20 20  getpid();.      
c240: 6d 65 6d 63 70 79 28 26 7a 42 75 66 5b 73 69 7a  memcpy(&zBuf[siz
c250: 65 6f 66 28 74 69 6d 65 5f 74 29 5d 2c 20 26 70  eof(time_t)], &p
c260: 69 64 2c 20 73 69 7a 65 6f 66 28 70 69 64 29 29  id, sizeof(pid))
c270: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
c280: 20 20 20 72 65 61 64 28 66 64 2c 20 7a 42 75 66     read(fd, zBuf
c290: 2c 20 32 35 36 29 3b 0a 20 20 20 20 20 20 63 6c  , 256);.      cl
c2a0: 6f 73 65 28 66 64 29 3b 0a 20 20 20 20 7d 0a 20  ose(fd);.    }. 
c2b0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75   }.#endif.  retu
c2c0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
c2d0: 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f 72  ./*.** Sleep for
c2e0: 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65 2e   a little while.
c2f0: 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d 6f    Return the amo
c300: 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65 70  unt of time slep
c310: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
c320: 33 55 6e 69 78 53 6c 65 65 70 28 69 6e 74 20 6d  3UnixSleep(int m
c330: 73 29 7b 0a 23 69 66 20 64 65 66 69 6e 65 64 28  s){.#if defined(
c340: 48 41 56 45 5f 55 53 4c 45 45 50 29 20 26 26 20  HAVE_USLEEP) && 
c350: 48 41 56 45 5f 55 53 4c 45 45 50 0a 20 20 75 73  HAVE_USLEEP.  us
c360: 6c 65 65 70 28 6d 73 2a 31 30 30 30 29 3b 0a 20  leep(ms*1000);. 
c370: 20 72 65 74 75 72 6e 20 6d 73 3b 0a 23 65 6c 73   return ms;.#els
c380: 65 0a 20 20 73 6c 65 65 70 28 28 6d 73 2b 39 39  e.  sleep((ms+99
c390: 39 29 2f 31 30 30 30 29 3b 0a 20 20 72 65 74 75  9)/1000);.  retu
c3a0: 72 6e 20 31 30 30 30 2a 28 28 6d 73 2b 39 39 39  rn 1000*((ms+999
c3b0: 29 2f 31 30 30 30 29 3b 0a 23 65 6e 64 69 66 0a  )/1000);.#endif.
c3c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 61 74 69 63 20  }../*.** Static 
c3d0: 76 61 72 69 61 62 6c 65 73 20 75 73 65 64 20 66  variables used f
c3e0: 6f 72 20 74 68 72 65 61 64 20 73 79 6e 63 68 72  or thread synchr
c3f0: 6f 6e 69 7a 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61  onization.*/.sta
c400: 74 69 63 20 69 6e 74 20 69 6e 4d 75 74 65 78 20  tic int inMutex 
c410: 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  = 0;.#ifdef SQLI
c420: 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 0a  TE_UNIX_THREADS.
c430: 73 74 61 74 69 63 20 70 74 68 72 65 61 64 5f 6d  static pthread_m
c440: 75 74 65 78 5f 74 20 6d 75 74 65 78 20 3d 20 50  utex_t mutex = P
c450: 54 48 52 45 41 44 5f 4d 55 54 45 58 5f 49 4e 49  THREAD_MUTEX_INI
c460: 54 49 41 4c 49 5a 45 52 3b 0a 23 65 6e 64 69 66  TIALIZER;.#endif
c470: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ../*.** The foll
c480: 6f 77 69 6e 67 20 70 61 69 72 20 6f 66 20 72 6f  owing pair of ro
c490: 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 20  utine implement 
c4a0: 6d 75 74 75 61 6c 20 65 78 63 6c 75 73 69 6f 6e  mutual exclusion
c4b0: 20 66 6f 72 0a 2a 2a 20 6d 75 6c 74 69 2d 74 68   for.** multi-th
c4c0: 72 65 61 64 65 64 20 70 72 6f 63 65 73 73 65 73  readed processes
c4d0: 2e 20 20 4f 6e 6c 79 20 61 20 73 69 6e 67 6c 65  .  Only a single
c4e0: 20 74 68 72 65 61 64 20 69 73 20 61 6c 6c 6f 77   thread is allow
c4f0: 65 64 20 74 6f 0a 2a 2a 20 65 78 65 63 75 74 65  ed to.** execute
c500: 64 20 63 6f 64 65 20 74 68 61 74 20 69 73 20 73  d code that is s
c510: 75 72 72 6f 75 6e 64 65 64 20 62 79 20 45 6e 74  urrounded by Ent
c520: 65 72 4d 75 74 65 78 28 29 20 61 6e 64 20 4c 65  erMutex() and Le
c530: 61 76 65 4d 75 74 65 78 28 29 2e 0a 2a 2a 0a 2a  aveMutex()..**.*
c540: 2a 20 53 51 4c 69 74 65 20 75 73 65 73 20 6f 6e  * SQLite uses on
c550: 6c 79 20 61 20 73 69 6e 67 6c 65 20 4d 75 74 65  ly a single Mute
c560: 78 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 74  x.  There is not
c570: 20 6d 75 63 68 20 63 72 69 74 69 63 61 6c 0a 2a   much critical.*
c580: 2a 20 63 6f 64 65 20 61 6e 64 20 77 68 61 74 20  * code and what 
c590: 6c 69 74 74 6c 65 20 74 68 65 72 65 20 69 73 20  little there is 
c5a0: 65 78 65 63 75 74 65 73 20 71 75 69 63 6b 6c 79  executes quickly
c5b0: 20 61 6e 64 20 77 69 74 68 6f 75 74 20 62 6c 6f   and without blo
c5c0: 63 6b 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73  cking..*/.void s
c5d0: 71 6c 69 74 65 33 55 6e 69 78 45 6e 74 65 72 4d  qlite3UnixEnterM
c5e0: 75 74 65 78 28 29 7b 0a 23 69 66 64 65 66 20 53  utex(){.#ifdef S
c5f0: 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41  QLITE_UNIX_THREA
c600: 44 53 0a 20 20 70 74 68 72 65 61 64 5f 6d 75 74  DS.  pthread_mut
c610: 65 78 5f 6c 6f 63 6b 28 26 6d 75 74 65 78 29 3b  ex_lock(&mutex);
c620: 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 65 72 74  .#endif.  assert
c630: 28 20 21 69 6e 4d 75 74 65 78 20 29 3b 0a 20 20  ( !inMutex );.  
c640: 69 6e 4d 75 74 65 78 20 3d 20 31 3b 0a 7d 0a 76  inMutex = 1;.}.v
c650: 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 69 78 4c  oid sqlite3UnixL
c660: 65 61 76 65 4d 75 74 65 78 28 29 7b 0a 20 20 61  eaveMutex(){.  a
c670: 73 73 65 72 74 28 20 69 6e 4d 75 74 65 78 20 29  ssert( inMutex )
c680: 3b 0a 20 20 69 6e 4d 75 74 65 78 20 3d 20 30 3b  ;.  inMutex = 0;
c690: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55  .#ifdef SQLITE_U
c6a0: 4e 49 58 5f 54 48 52 45 41 44 53 0a 20 20 70 74  NIX_THREADS.  pt
c6b0: 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f  hread_mutex_unlo
c6c0: 63 6b 28 26 6d 75 74 65 78 29 3b 0a 23 65 6e 64  ck(&mutex);.#end
c6d0: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  if.}../*.** Retu
c6e0: 72 6e 20 54 52 55 45 20 69 66 20 77 65 20 61 72  rn TRUE if we ar
c6f0: 65 20 63 75 72 72 65 6e 74 6c 79 20 77 69 74 68  e currently with
c700: 69 6e 20 74 68 65 20 6d 75 74 65 78 20 61 6e 64  in the mutex and
c710: 20 46 41 4c 53 45 20 69 66 20 6e 6f 74 2e 0a 2a   FALSE if not..*
c720: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 6e 69  /.int sqlite3Uni
c730: 78 49 6e 4d 75 74 65 78 28 29 7b 0a 20 20 72 65  xInMutex(){.  re
c740: 74 75 72 6e 20 69 6e 4d 75 74 65 78 3b 0a 7d 0a  turn inMutex;.}.
c750: 0a 2f 2a 0a 2a 2a 20 52 65 6d 65 6d 62 65 72 20  ./*.** Remember 
c760: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68  the number of th
c770: 72 65 61 64 2d 73 70 65 63 69 66 69 63 2d 64 61  read-specific-da
c780: 74 61 20 62 6c 6f 63 6b 73 20 61 6c 6c 6f 63 61  ta blocks alloca
c790: 74 65 64 2e 0a 2a 2a 20 55 73 65 20 74 68 69 73  ted..** Use this
c7a0: 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20   to verify that 
c7b0: 77 65 20 61 72 65 20 6e 6f 74 20 6c 65 61 6b 69  we are not leaki
c7c0: 6e 67 20 74 68 72 65 61 64 2d 73 70 65 63 69 66  ng thread-specif
c7d0: 69 63 2d 64 61 74 61 2e 0a 2a 2a 20 54 69 63 6b  ic-data..** Tick
c7e0: 65 74 20 23 31 36 30 31 0a 2a 2f 0a 23 69 66 64  et #1601.*/.#ifd
c7f0: 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 69  ef SQLITE_TEST.i
c800: 6e 74 20 73 71 6c 69 74 65 33 5f 74 73 64 5f 63  nt sqlite3_tsd_c
c810: 6f 75 6e 74 20 3d 20 30 3b 0a 23 20 69 66 64 65  ount = 0;.# ifde
c820: 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48  f SQLITE_UNIX_TH
c830: 52 45 41 44 53 0a 20 20 20 20 73 74 61 74 69 63  READS.    static
c840: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 74   pthread_mutex_t
c850: 20 74 73 64 5f 63 6f 75 6e 74 65 72 5f 6d 75 74   tsd_counter_mut
c860: 65 78 20 3d 20 50 54 48 52 45 41 44 5f 4d 55 54  ex = PTHREAD_MUT
c870: 45 58 5f 49 4e 49 54 49 41 4c 49 5a 45 52 3b 0a  EX_INITIALIZER;.
c880: 23 20 20 20 64 65 66 69 6e 65 20 54 53 44 5f 43  #   define TSD_C
c890: 4f 55 4e 54 45 52 28 4e 29 20 5c 0a 20 20 20 20  OUNTER(N) \.    
c8a0: 20 20 20 20 20 20 20 20 20 70 74 68 72 65 61 64           pthread
c8b0: 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 74 73 64  _mutex_lock(&tsd
c8c0: 5f 63 6f 75 6e 74 65 72 5f 6d 75 74 65 78 29 3b  _counter_mutex);
c8d0: 20 5c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20   \.             
c8e0: 73 71 6c 69 74 65 33 5f 74 73 64 5f 63 6f 75 6e  sqlite3_tsd_coun
c8f0: 74 20 2b 3d 20 4e 3b 20 5c 0a 20 20 20 20 20 20  t += N; \.      
c900: 20 20 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d         pthread_m
c910: 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 74 73 64  utex_unlock(&tsd
c920: 5f 63 6f 75 6e 74 65 72 5f 6d 75 74 65 78 29 3b  _counter_mutex);
c930: 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69  .# else.#   defi
c940: 6e 65 20 54 53 44 5f 43 4f 55 4e 54 45 52 28 4e  ne TSD_COUNTER(N
c950: 29 20 20 73 71 6c 69 74 65 33 5f 74 73 64 5f 63  )  sqlite3_tsd_c
c960: 6f 75 6e 74 20 2b 3d 20 4e 0a 23 20 65 6e 64 69  ount += N.# endi
c970: 66 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65  f.#else.# define
c980: 20 54 53 44 5f 43 4f 55 4e 54 45 52 28 4e 29 20   TSD_COUNTER(N) 
c990: 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 65 6e   /* no-op */.#en
c9a0: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 63  dif.../*.** If c
c9b0: 61 6c 6c 65 64 20 77 69 74 68 20 61 6c 6c 6f 63  alled with alloc
c9c0: 61 74 65 46 6c 61 67 3e 31 2c 20 74 68 65 6e 20  ateFlag>1, then 
c9d0: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72  return a pointer
c9e0: 20 74 6f 20 74 68 72 65 61 64 0a 2a 2a 20 73 70   to thread.** sp
c9f0: 65 63 69 66 69 63 20 64 61 74 61 20 66 6f 72 20  ecific data for 
ca00: 74 68 65 20 63 75 72 72 65 6e 74 20 74 68 72 65  the current thre
ca10: 61 64 2e 20 20 41 6c 6c 6f 63 61 74 65 20 61 6e  ad.  Allocate an
ca20: 64 20 7a 65 72 6f 20 74 68 65 0a 2a 2a 20 74 68  d zero the.** th
ca30: 72 65 61 64 2d 73 70 65 63 69 66 69 63 20 64 61  read-specific da
ca40: 74 61 20 69 66 20 69 74 20 64 6f 65 73 20 6e 6f  ta if it does no
ca50: 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 20  t already exist 
ca60: 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a 0a 2a 2a  necessary..**.**
ca70: 20 49 66 20 63 61 6c 6c 65 64 20 77 69 74 68 20   If called with 
ca80: 61 6c 6c 6f 63 61 74 65 46 6c 61 67 3d 3d 30 2c  allocateFlag==0,
ca90: 20 74 68 65 6e 20 63 68 65 63 6b 20 74 68 65 20   then check the 
caa0: 63 75 72 72 65 6e 74 20 74 68 72 65 61 64 0a 2a  current thread.*
cab0: 2a 20 73 70 65 63 69 66 69 63 20 64 61 74 61 2e  * specific data.
cac0: 20 20 52 65 74 75 72 6e 20 69 74 20 69 66 20 69    Return it if i
cad0: 74 20 65 78 69 73 74 73 2e 20 20 49 66 20 69 74  t exists.  If it
cae0: 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c   does not exist,
caf0: 0a 2a 2a 20 74 68 65 6e 20 72 65 74 75 72 6e 20  .** then return 
cb00: 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 63  NULL..**.** If c
cb10: 61 6c 6c 65 64 20 77 69 74 68 20 61 6c 6c 6f 63  alled with alloc
cb20: 61 74 65 46 6c 61 67 3c 30 2c 20 63 68 65 63 6b  ateFlag<0, check
cb30: 20 74 6f 20 73 65 65 20 69 66 20 74 68 65 20 74   to see if the t
cb40: 68 72 65 61 64 20 73 70 65 63 69 66 69 63 0a 2a  hread specific.*
cb50: 2a 20 64 61 74 61 20 69 73 20 61 6c 6c 6f 63 61  * data is alloca
cb60: 74 65 64 20 61 6e 64 20 69 73 20 61 6c 6c 20 7a  ted and is all z
cb70: 65 72 6f 2e 20 20 49 66 20 69 74 20 69 73 20 74  ero.  If it is t
cb80: 68 65 6e 20 64 65 61 6c 6c 6f 63 61 74 65 20 69  hen deallocate i
cb90: 74 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70  t..** Return a p
cba0: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 74 68  ointer to the th
cbb0: 72 65 61 64 20 73 70 65 63 69 66 69 63 20 64 61  read specific da
cbc0: 74 61 20 6f 72 20 4e 55 4c 4c 20 69 66 20 69 74  ta or NULL if it
cbd0: 20 69 73 0a 2a 2a 20 75 6e 61 6c 6c 6f 63 61 74   is.** unallocat
cbe0: 65 64 20 6f 72 20 67 65 74 73 20 64 65 61 6c 6c  ed or gets deall
cbf0: 6f 63 61 74 65 64 2e 0a 2a 2f 0a 54 68 72 65 61  ocated..*/.Threa
cc00: 64 44 61 74 61 20 2a 73 71 6c 69 74 65 33 55 6e  dData *sqlite3Un
cc10: 69 78 54 68 72 65 61 64 53 70 65 63 69 66 69 63  ixThreadSpecific
cc20: 44 61 74 61 28 69 6e 74 20 61 6c 6c 6f 63 61 74  Data(int allocat
cc30: 65 46 6c 61 67 29 7b 0a 20 20 73 74 61 74 69 63  eFlag){.  static
cc40: 20 63 6f 6e 73 74 20 54 68 72 65 61 64 44 61 74   const ThreadDat
cc50: 61 20 7a 65 72 6f 44 61 74 61 3b 0a 23 69 66 64  a zeroData;.#ifd
cc60: 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54  ef SQLITE_UNIX_T
cc70: 48 52 45 41 44 53 0a 20 20 73 74 61 74 69 63 20  HREADS.  static 
cc80: 70 74 68 72 65 61 64 5f 6b 65 79 5f 74 20 6b 65  pthread_key_t ke
cc90: 79 3b 0a 20 20 73 74 61 74 69 63 20 69 6e 74 20  y;.  static int 
cca0: 6b 65 79 49 6e 69 74 20 3d 20 30 3b 0a 20 20 54  keyInit = 0;.  T
ccb0: 68 72 65 61 64 44 61 74 61 20 2a 70 54 73 64 3b  hreadData *pTsd;
ccc0: 0a 0a 20 20 69 66 28 20 21 6b 65 79 49 6e 69 74  ..  if( !keyInit
ccd0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f   ){.    sqlite3O
cce0: 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  sEnterMutex();. 
ccf0: 20 20 20 69 66 28 20 21 6b 65 79 49 6e 69 74 20     if( !keyInit 
cd00: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 3b  ){.      int rc;
cd10: 0a 20 20 20 20 20 20 72 63 20 3d 20 70 74 68 72  .      rc = pthr
cd20: 65 61 64 5f 6b 65 79 5f 63 72 65 61 74 65 28 26  ead_key_create(&
cd30: 6b 65 79 2c 20 30 29 3b 0a 20 20 20 20 20 20 69  key, 0);.      i
cd40: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20  f( rc ){.       
cd50: 20 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d   sqlite3OsLeaveM
cd60: 75 74 65 78 28 29 3b 0a 20 20 20 20 20 20 20 20  utex();.        
cd70: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20  return 0;.      
cd80: 7d 0a 20 20 20 20 20 20 6b 65 79 49 6e 69 74 20  }.      keyInit 
cd90: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  = 1;.    }.    s
cda0: 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74  qlite3OsLeaveMut
cdb0: 65 78 28 29 3b 0a 20 20 7d 0a 0a 20 20 70 54 73  ex();.  }..  pTs
cdc0: 64 20 3d 20 70 74 68 72 65 61 64 5f 67 65 74 73  d = pthread_gets
cdd0: 70 65 63 69 66 69 63 28 6b 65 79 29 3b 0a 20 20  pecific(key);.  
cde0: 69 66 28 20 61 6c 6c 6f 63 61 74 65 46 6c 61 67  if( allocateFlag
cdf0: 3e 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 54  >0 ){.    if( pT
ce00: 73 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70  sd==0 ){.      p
ce10: 54 73 64 20 3d 20 73 71 6c 69 74 65 33 4f 73 4d  Tsd = sqlite3OsM
ce20: 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 7a 65 72  alloc(sizeof(zer
ce30: 6f 44 61 74 61 29 29 3b 0a 20 20 20 20 20 20 69  oData));.      i
ce40: 66 28 20 70 54 73 64 20 29 7b 0a 20 20 20 20 20  f( pTsd ){.     
ce50: 20 20 20 2a 70 54 73 64 20 3d 20 7a 65 72 6f 44     *pTsd = zeroD
ce60: 61 74 61 3b 0a 20 20 20 20 20 20 20 20 70 74 68  ata;.        pth
ce70: 72 65 61 64 5f 73 65 74 73 70 65 63 69 66 69 63  read_setspecific
ce80: 28 6b 65 79 2c 20 70 54 73 64 29 3b 0a 20 20 20  (key, pTsd);.   
ce90: 20 20 20 20 20 54 53 44 5f 43 4f 55 4e 54 45 52       TSD_COUNTER
cea0: 28 2b 31 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  (+1);.      }.  
ceb0: 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20    }.  }else if( 
cec0: 70 54 73 64 21 3d 30 20 26 26 20 61 6c 6c 6f 63  pTsd!=0 && alloc
ced0: 61 74 65 46 6c 61 67 3c 30 20 0a 20 20 20 20 20  ateFlag<0 .     
cee0: 20 20 20 20 20 20 20 26 26 20 6d 65 6d 63 6d 70         && memcmp
cef0: 28 70 54 73 64 2c 20 26 7a 65 72 6f 44 61 74 61  (pTsd, &zeroData
cf00: 2c 20 73 69 7a 65 6f 66 28 7a 65 72 6f 44 61 74  , sizeof(zeroDat
cf10: 61 29 29 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71  a))==0 ){.    sq
cf20: 6c 69 74 65 33 4f 73 46 72 65 65 28 70 54 73 64  lite3OsFree(pTsd
cf30: 29 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f 73  );.    pthread_s
cf40: 65 74 73 70 65 63 69 66 69 63 28 6b 65 79 2c 20  etspecific(key, 
cf50: 30 29 3b 0a 20 20 20 20 54 53 44 5f 43 4f 55 4e  0);.    TSD_COUN
cf60: 54 45 52 28 2d 31 29 3b 0a 20 20 20 20 70 54 73  TER(-1);.    pTs
cf70: 64 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74  d = 0;.  }.  ret
cf80: 75 72 6e 20 70 54 73 64 3b 0a 23 65 6c 73 65 0a  urn pTsd;.#else.
cf90: 20 20 73 74 61 74 69 63 20 54 68 72 65 61 64 44    static ThreadD
cfa0: 61 74 61 20 2a 70 54 73 64 20 3d 20 30 3b 0a 20  ata *pTsd = 0;. 
cfb0: 20 69 66 28 20 61 6c 6c 6f 63 61 74 65 46 6c 61   if( allocateFla
cfc0: 67 3e 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70  g>0 ){.    if( p
cfd0: 54 73 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  Tsd==0 ){.      
cfe0: 70 54 73 64 20 3d 20 73 71 6c 69 74 65 33 4f 73  pTsd = sqlite3Os
cff0: 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 7a  Malloc( sizeof(z
d000: 65 72 6f 44 61 74 61 29 20 29 3b 0a 20 20 20 20  eroData) );.    
d010: 20 20 69 66 28 20 70 54 73 64 20 29 7b 0a 20 20    if( pTsd ){.  
d020: 20 20 20 20 20 20 2a 70 54 73 64 20 3d 20 7a 65        *pTsd = ze
d030: 72 6f 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20  roData;.        
d040: 54 53 44 5f 43 4f 55 4e 54 45 52 28 2b 31 29 3b  TSD_COUNTER(+1);
d050: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
d060: 20 7d 65 6c 73 65 20 69 66 28 20 70 54 73 64 21   }else if( pTsd!
d070: 3d 30 20 26 26 20 61 6c 6c 6f 63 61 74 65 46 6c  =0 && allocateFl
d080: 61 67 3c 30 0a 20 20 20 20 20 20 20 20 20 20 20  ag<0.           
d090: 20 26 26 20 6d 65 6d 63 6d 70 28 70 54 73 64 2c   && memcmp(pTsd,
d0a0: 20 26 7a 65 72 6f 44 61 74 61 2c 20 73 69 7a 65   &zeroData, size
d0b0: 6f 66 28 7a 65 72 6f 44 61 74 61 29 29 3d 3d 30  of(zeroData))==0
d0c0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f   ){.    sqlite3O
d0d0: 73 46 72 65 65 28 70 54 73 64 29 3b 0a 20 20 20  sFree(pTsd);.   
d0e0: 20 54 53 44 5f 43 4f 55 4e 54 45 52 28 2d 31 29   TSD_COUNTER(-1)
d0f0: 3b 0a 20 20 20 20 70 54 73 64 20 3d 20 30 3b 0a  ;.    pTsd = 0;.
d100: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 54 73    }.  return pTs
d110: 64 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a  d;.#endif.}../*.
d120: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
d130: 20 76 61 72 69 61 62 6c 65 2c 20 69 66 20 73 65   variable, if se
d140: 74 20 74 6f 20 61 20 6e 6f 6e 2d 7a 65 72 6f 20  t to a non-zero 
d150: 76 61 6c 75 65 2c 20 62 65 63 6f 6d 65 73 20 74  value, becomes t
d160: 68 65 20 72 65 73 75 6c 74 0a 2a 2a 20 72 65 74  he result.** ret
d170: 75 72 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74  urned from sqlit
d180: 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 28  e3OsCurrentTime(
d190: 29 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  ).  This is used
d1a0: 20 66 6f 72 20 74 65 73 74 69 6e 67 2e 0a 2a 2f   for testing..*/
d1b0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54  .#ifdef SQLITE_T
d1c0: 45 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  EST.int sqlite3_
d1d0: 63 75 72 72 65 6e 74 5f 74 69 6d 65 20 3d 20 30  current_time = 0
d1e0: 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  ;.#endif../*.** 
d1f0: 46 69 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74  Find the current
d200: 20 74 69 6d 65 20 28 69 6e 20 55 6e 69 76 65 72   time (in Univer
d210: 73 61 6c 20 43 6f 6f 72 64 69 6e 61 74 65 64 20  sal Coordinated 
d220: 54 69 6d 65 29 2e 20 20 57 72 69 74 65 20 74 68  Time).  Write th
d230: 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 74 69 6d  e.** current tim
d240: 65 20 61 6e 64 20 64 61 74 65 20 61 73 20 61 20  e and date as a 
d250: 4a 75 6c 69 61 6e 20 44 61 79 20 6e 75 6d 62 65  Julian Day numbe
d260: 72 20 69 6e 74 6f 20 2a 70 72 4e 6f 77 20 61 6e  r into *prNow an
d270: 64 0a 2a 2a 20 72 65 74 75 72 6e 20 30 2e 20 20  d.** return 0.  
d280: 52 65 74 75 72 6e 20 31 20 69 66 20 74 68 65 20  Return 1 if the 
d290: 74 69 6d 65 20 61 6e 64 20 64 61 74 65 20 63 61  time and date ca
d2a0: 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2e 0a 2a  nnot be found..*
d2b0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 6e 69  /.int sqlite3Uni
d2c0: 78 43 75 72 72 65 6e 74 54 69 6d 65 28 64 6f 75  xCurrentTime(dou
d2d0: 62 6c 65 20 2a 70 72 4e 6f 77 29 7b 0a 23 69 66  ble *prNow){.#if
d2e0: 64 65 66 20 4e 4f 5f 47 45 54 54 4f 44 0a 20 20  def NO_GETTOD.  
d2f0: 74 69 6d 65 5f 74 20 74 3b 0a 20 20 74 69 6d 65  time_t t;.  time
d300: 28 26 74 29 3b 0a 20 20 2a 70 72 4e 6f 77 20 3d  (&t);.  *prNow =
d310: 20 74 2f 38 36 34 30 30 2e 30 20 2b 20 32 34 34   t/86400.0 + 244
d320: 30 35 38 37 2e 35 3b 0a 23 65 6c 73 65 0a 20 20  0587.5;.#else.  
d330: 73 74 72 75 63 74 20 74 69 6d 65 76 61 6c 20 73  struct timeval s
d340: 4e 6f 77 3b 0a 20 20 73 74 72 75 63 74 20 74 69  Now;.  struct ti
d350: 6d 65 7a 6f 6e 65 20 73 54 7a 3b 20 20 2f 2a 20  mezone sTz;  /* 
d360: 4e 6f 74 20 75 73 65 64 20 2a 2f 0a 20 20 67 65  Not used */.  ge
d370: 74 74 69 6d 65 6f 66 64 61 79 28 26 73 4e 6f 77  ttimeofday(&sNow
d380: 2c 20 26 73 54 7a 29 3b 0a 20 20 2a 70 72 4e 6f  , &sTz);.  *prNo
d390: 77 20 3d 20 32 34 34 30 35 38 37 2e 35 20 2b 20  w = 2440587.5 + 
d3a0: 73 4e 6f 77 2e 74 76 5f 73 65 63 2f 38 36 34 30  sNow.tv_sec/8640
d3b0: 30 2e 30 20 2b 20 73 4e 6f 77 2e 74 76 5f 75 73  0.0 + sNow.tv_us
d3c0: 65 63 2f 38 36 34 30 30 30 30 30 30 30 30 2e 30  ec/86400000000.0
d3d0: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20  ;.#endif.#ifdef 
d3e0: 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 66  SQLITE_TEST.  if
d3f0: 28 20 73 71 6c 69 74 65 33 5f 63 75 72 72 65 6e  ( sqlite3_curren
d400: 74 5f 74 69 6d 65 20 29 7b 0a 20 20 20 20 2a 70  t_time ){.    *p
d410: 72 4e 6f 77 20 3d 20 73 71 6c 69 74 65 33 5f 63  rNow = sqlite3_c
d420: 75 72 72 65 6e 74 5f 74 69 6d 65 2f 38 36 34 30  urrent_time/8640
d430: 30 2e 30 20 2b 20 32 34 34 30 35 38 37 2e 35 3b  0.0 + 2440587.5;
d440: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65  .  }.#endif.  re
d450: 74 75 72 6e 20 30 3b 0a 7d 0a 0a 23 65 6e 64 69  turn 0;.}..#endi
d460: 66 20 2f 2a 20 4f 53 5f 55 4e 49 58 20 2a 2f 0a  f /* OS_UNIX */.