/ Hex Artifact Content
Login

Artifact 091a89297bf80927cde146cd1dbf89c908864f3a:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 36 0a 2a 2a 0a 2a 2a 20 54 68  mber 16.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
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 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a  ***********.**.*
0180: 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f 6e 74  * This file cont
0190: 61 69 6e 73 20 63 6f 64 65 20 74 68 61 74 20 69  ains code that i
01a0: 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 70 61  s specific to pa
01b0: 72 74 69 63 75 6c 61 72 20 6f 70 65 72 61 74 69  rticular operati
01c0: 6e 67 0a 2a 2a 20 73 79 73 74 65 6d 73 2e 20 20  ng.** systems.  
01d0: 54 68 65 20 70 75 72 70 6f 73 65 20 6f 66 20 74  The purpose of t
01e0: 68 69 73 20 66 69 6c 65 20 69 73 20 74 6f 20 70  his file is to p
01f0: 72 6f 76 69 64 65 20 61 20 75 6e 69 66 6f 72 6d  rovide a uniform
0200: 20 61 62 73 74 72 61 63 74 69 6f 6e 0a 2a 2a 20   abstraction.** 
0210: 6f 6e 20 77 68 69 63 68 20 74 68 65 20 72 65 73  on which the res
0220: 74 20 6f 66 20 53 51 4c 69 74 65 20 63 61 6e 20  t of SQLite can 
0230: 6f 70 65 72 61 74 65 2e 0a 2a 2f 0a 23 69 6e 63  operate..*/.#inc
0240: 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e  lude "sqliteInt.
0250: 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e  h".#include "os.
0260: 68 22 0a 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a  h"..#if OS_UNIX.
0270: 23 20 69 6e 63 6c 75 64 65 20 3c 75 6e 69 73 74  # include <unist
0280: 64 2e 68 3e 0a 23 20 69 6e 63 6c 75 64 65 20 3c  d.h>.# include <
0290: 66 63 6e 74 6c 2e 68 3e 0a 23 20 69 6e 63 6c 75  fcntl.h>.# inclu
02a0: 64 65 20 3c 73 79 73 2f 73 74 61 74 2e 68 3e 0a  de <sys/stat.h>.
02b0: 23 20 69 6e 63 6c 75 64 65 20 3c 74 69 6d 65 2e  # include <time.
02c0: 68 3e 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53  h>.#endif.#if OS
02d0: 5f 57 49 4e 0a 23 20 69 6e 63 6c 75 64 65 20 3c  _WIN.# include <
02e0: 77 69 6e 62 61 73 65 2e 68 3e 0a 23 65 6e 64 69  winbase.h>.#endi
02f0: 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20  f../*.** Macros 
0300: 66 6f 72 20 70 65 72 66 6f 72 6d 61 6e 63 65 20  for performance 
0310: 74 72 61 63 69 6e 67 2e 20 20 4e 6f 72 6d 61 6c  tracing.  Normal
0320: 6c 79 20 74 75 72 6e 65 64 20 6f 66 66 0a 2a 2f  ly turned off.*/
0330: 0a 23 69 66 20 30 0a 73 74 61 74 69 63 20 69 6e  .#if 0.static in
0340: 74 20 6c 61 73 74 5f 70 61 67 65 20 3d 20 30 3b  t last_page = 0;
0350: 0a 23 64 65 66 69 6e 65 20 53 45 45 4b 28 58 29  .#define SEEK(X)
0360: 20 20 20 20 20 6c 61 73 74 5f 70 61 67 65 3d 28       last_page=(
0370: 58 29 0a 23 64 65 66 69 6e 65 20 54 52 41 43 45  X).#define TRACE
0380: 31 28 58 29 20 20 20 66 70 72 69 6e 74 66 28 73  1(X)   fprintf(s
0390: 74 64 65 72 72 2c 58 29 0a 23 64 65 66 69 6e 65  tderr,X).#define
03a0: 20 54 52 41 43 45 32 28 58 2c 59 29 20 66 70 72   TRACE2(X,Y) fpr
03b0: 69 6e 74 66 28 73 74 64 65 72 72 2c 58 2c 59 29  intf(stderr,X,Y)
03c0: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 53  .#else.#define S
03d0: 45 45 4b 28 58 29 0a 23 64 65 66 69 6e 65 20 54  EEK(X).#define T
03e0: 52 41 43 45 31 28 58 29 0a 23 64 65 66 69 6e 65  RACE1(X).#define
03f0: 20 54 52 41 43 45 32 28 58 2c 59 29 0a 23 65 6e   TRACE2(X,Y).#en
0400: 64 69 66 0a 0a 0a 23 69 66 20 4f 53 5f 55 4e 49  dif...#if OS_UNI
0410: 58 0a 2f 2a 0a 2a 2a 20 48 65 72 65 20 69 73 20  X./*.** Here is 
0420: 74 68 65 20 64 69 72 74 20 6f 6e 20 50 4f 53 49  the dirt on POSI
0430: 58 20 61 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73  X advisory locks
0440: 3a 20 20 41 4e 53 49 20 53 54 44 20 31 30 30 33  :  ANSI STD 1003
0450: 2e 31 20 28 31 39 39 36 29 0a 2a 2a 20 73 65 63  .1 (1996).** sec
0460: 74 69 6f 6e 20 36 2e 35 2e 32 2e 32 20 6c 69 6e  tion 6.5.2.2 lin
0470: 65 73 20 34 38 33 20 74 68 72 6f 75 67 68 20 34  es 483 through 4
0480: 39 30 20 73 70 65 63 69 66 79 20 74 68 61 74 20  90 specify that 
0490: 77 68 65 6e 20 61 20 70 72 6f 63 65 73 73 0a 2a  when a process.*
04a0: 2a 20 73 65 74 73 20 6f 72 20 63 6c 65 61 72 73  * sets or clears
04b0: 20 61 20 6c 6f 63 6b 2c 20 74 68 61 74 20 6f 70   a lock, that op
04c0: 65 72 61 74 69 6f 6e 20 6f 76 65 72 72 69 64 65  eration override
04d0: 73 20 61 6e 79 20 70 72 69 6f 72 20 6c 6f 63 6b  s any prior lock
04e0: 73 20 73 65 74 0a 2a 2a 20 62 79 20 74 68 65 20  s set.** by the 
04f0: 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20 20 49  same process.  I
0500: 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 70 6c 69  t does not expli
0510: 63 69 74 6c 79 20 73 61 79 20 73 6f 2c 20 62 75  citly say so, bu
0520: 74 20 74 68 69 73 20 69 6d 70 6c 69 65 73 0a 2a  t this implies.*
0530: 2a 20 74 68 61 74 20 69 74 20 6f 76 65 72 72 69  * that it overri
0540: 64 65 73 20 6c 6f 63 6b 73 20 73 65 74 20 62 79  des locks set by
0550: 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73   the same proces
0560: 73 20 75 73 69 6e 67 20 61 20 64 69 66 66 65 72  s using a differ
0570: 65 6e 74 0a 2a 2a 20 66 69 6c 65 20 64 65 73 63  ent.** file desc
0580: 72 69 70 74 6f 72 2e 20 20 43 6f 6e 73 69 64 65  riptor.  Conside
0590: 72 20 74 68 69 73 20 74 65 73 74 20 63 61 73 65  r this test case
05a0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 69 6e  :.**.**       in
05b0: 74 20 66 64 31 20 3d 20 6f 70 65 6e 28 22 2e 2f  t fd1 = open("./
05c0: 66 69 6c 65 31 22 2c 20 4f 5f 52 44 57 52 7c 4f  file1", O_RDWR|O
05d0: 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b 0a 2a  _CREAT, 0644);.*
05e0: 2a 20 20 20 20 20 20 20 69 6e 74 20 66 64 32 20  *       int fd2 
05f0: 3d 20 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 32 22  = open("./file2"
0600: 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54  , O_RDWR|O_CREAT
0610: 2c 20 30 36 34 34 29 3b 0a 2a 2a 0a 2a 2a 20 53  , 0644);.**.** S
0620: 75 70 70 6f 73 65 20 2e 2f 66 69 6c 65 31 20 61  uppose ./file1 a
0630: 6e 64 20 2e 2f 66 69 6c 65 32 20 61 72 65 20 72  nd ./file2 are r
0640: 65 61 6c 6c 79 20 62 65 20 74 68 65 20 73 61 6d  eally be the sam
0650: 65 20 66 69 6c 65 20 28 62 65 63 61 75 73 65 0a  e file (because.
0660: 2a 2a 20 6f 6e 65 20 69 73 20 61 20 68 61 72 64  ** one is a hard
0670: 20 6f 72 20 73 79 6d 62 6f 6c 69 63 20 6c 69 6e   or symbolic lin
0680: 6b 20 74 6f 20 74 68 65 20 6f 74 68 65 72 29 20  k to the other) 
0690: 74 68 65 6e 20 69 66 20 79 6f 75 20 73 65 74 0a  then if you set.
06a0: 2a 2a 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20  ** an exclusive 
06b0: 6c 6f 63 6b 20 6f 6e 20 66 64 31 2c 20 74 68 65  lock on fd1, the
06c0: 6e 20 74 72 79 20 74 6f 20 67 65 74 20 61 6e 20  n try to get an 
06d0: 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 0a 2a  exclusive lock.*
06e0: 2a 20 6f 6e 20 66 64 32 2c 20 69 74 20 77 6f 72  * on fd2, it wor
06f0: 6b 73 2e 20 20 49 20 77 6f 75 6c 64 20 68 61 76  ks.  I would hav
0700: 65 20 65 78 70 65 63 74 65 64 20 74 68 65 20 73  e expected the s
0710: 65 63 6f 6e 64 20 6c 6f 63 6b 20 74 6f 0a 2a 2a  econd lock to.**
0720: 20 66 61 69 6c 20 73 69 6e 63 65 20 74 68 65 72   fail since ther
0730: 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 61 20  e was already a 
0740: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65  lock on the file
0750: 20 64 75 65 20 74 6f 20 66 64 31 2e 0a 2a 2a 20   due to fd1..** 
0760: 42 75 74 20 6e 6f 74 20 73 6f 2e 20 20 53 69 6e  But not so.  Sin
0770: 63 65 20 62 6f 74 68 20 6c 6f 63 6b 73 20 63 61  ce both locks ca
0780: 6d 65 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65  me from the same
0790: 20 70 72 6f 63 65 73 73 2c 20 74 68 65 0a 2a 2a   process, the.**
07a0: 20 73 65 63 6f 6e 64 20 6f 76 65 72 72 69 64 65   second override
07b0: 73 20 74 68 65 20 66 69 72 73 74 2c 20 65 76 65  s the first, eve
07c0: 6e 20 74 68 6f 75 67 68 20 74 68 65 79 20 77 65  n though they we
07d0: 72 65 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 0a  re on different.
07e0: 2a 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  ** file descript
07f0: 6f 72 73 20 6f 70 65 6e 65 64 20 6f 6e 20 64 69  ors opened on di
0800: 66 66 65 72 65 6e 74 20 66 69 6c 65 20 6e 61 6d  fferent file nam
0810: 65 73 2e 0a 2a 2a 0a 2a 2a 20 42 75 6d 6d 65 72  es..**.** Bummer
0820: 2e 20 20 49 66 20 79 6f 75 20 61 73 6b 20 6d 65  .  If you ask me
0830: 2c 20 74 68 69 73 20 69 73 20 62 72 6f 6b 65 6e  , this is broken
0840: 2e 20 20 42 61 64 6c 79 20 62 72 6f 6b 65 6e 2e  .  Badly broken.
0850: 20 20 49 74 20 6d 65 61 6e 73 0a 2a 2a 20 74 68    It means.** th
0860: 61 74 20 77 65 20 63 61 6e 6e 6f 74 20 75 73 65  at we cannot use
0870: 20 50 4f 53 49 58 20 6c 6f 63 6b 73 20 74 6f 20   POSIX locks to 
0880: 73 79 6e 63 68 72 6f 6e 69 7a 65 20 66 69 6c 65  synchronize file
0890: 20 61 63 63 65 73 73 20 61 6d 6f 6e 67 0a 2a 2a   access among.**
08a0: 20 63 6f 6d 70 65 74 69 6e 67 20 74 68 72 65 61   competing threa
08b0: 64 73 20 6f 66 20 74 68 65 20 73 61 6d 65 20 70  ds of the same p
08c0: 72 6f 63 65 73 73 2e 20 20 50 4f 53 49 58 20 6c  rocess.  POSIX l
08d0: 6f 63 6b 73 20 77 69 6c 6c 20 77 6f 72 6b 20 66  ocks will work f
08e0: 69 6e 65 0a 2a 2a 20 74 6f 20 73 79 6e 63 68 72  ine.** to synchr
08f0: 6f 6e 69 7a 65 20 61 63 63 65 73 73 20 66 6f 72  onize access for
0900: 20 74 68 72 65 61 64 73 20 69 6e 20 73 65 70 61   threads in sepa
0910: 72 61 74 65 20 70 72 6f 63 65 73 73 65 73 2c 20  rate processes, 
0920: 62 75 74 20 6e 6f 74 0a 2a 2a 20 74 68 72 65 61  but not.** threa
0930: 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 61  ds within the sa
0940: 6d 65 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a  me process..**.*
0950: 2a 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64  * To work around
0960: 20 74 68 65 20 70 72 6f 62 6c 65 6d 2c 20 53 51   the problem, SQ
0970: 4c 69 74 65 20 68 61 73 20 74 6f 20 6d 61 6e 61  Lite has to mana
0980: 67 65 20 66 69 6c 65 20 6c 6f 63 6b 73 20 69 6e  ge file locks in
0990: 74 65 72 6e 61 6c 6c 79 0a 2a 2a 20 6f 6e 20 69  ternally.** on i
09a0: 74 73 20 6f 77 6e 2e 20 20 57 68 65 6e 65 76 65  ts own.  Wheneve
09b0: 72 20 61 20 6e 65 77 20 64 61 74 61 62 61 73 65  r a new database
09c0: 20 69 73 20 6f 70 65 6e 65 64 2c 20 77 65 20 68   is opened, we h
09d0: 61 76 65 20 74 6f 20 66 69 6e 64 20 74 68 65 0a  ave to find the.
09e0: 2a 2a 20 73 70 65 63 69 66 69 63 20 69 6e 6f 64  ** specific inod
09f0: 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  e of the databas
0a00: 65 20 66 69 6c 65 20 28 74 68 65 20 69 6e 6f 64  e file (the inod
0a10: 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20  e is determined 
0a20: 62 79 20 74 68 65 0a 2a 2a 20 73 74 5f 64 65 76  by the.** st_dev
0a30: 20 61 6e 64 20 73 74 5f 69 6e 6f 20 66 69 65 6c   and st_ino fiel
0a40: 64 73 20 6f 66 20 74 68 65 20 73 74 61 74 20 73  ds of the stat s
0a50: 74 72 75 63 74 75 72 65 20 74 68 61 74 20 66 73  tructure that fs
0a60: 74 61 74 28 29 20 66 69 6c 6c 73 20 69 6e 29 0a  tat() fills in).
0a70: 2a 2a 20 61 6e 64 20 63 68 65 63 6b 20 66 6f 72  ** and check for
0a80: 20 6c 6f 63 6b 73 20 61 6c 72 65 61 64 79 20 65   locks already e
0a90: 78 69 73 74 69 6e 67 20 6f 6e 20 74 68 61 74 20  xisting on that 
0aa0: 69 6e 6f 64 65 2e 20 20 57 68 65 6e 20 6c 6f 63  inode.  When loc
0ab0: 6b 73 20 61 72 65 0a 2a 2a 20 63 72 65 61 74 65  ks are.** create
0ac0: 64 20 6f 72 20 72 65 6d 6f 76 65 64 2c 20 77 65  d or removed, we
0ad0: 20 68 61 76 65 20 74 6f 20 6c 6f 6f 6b 20 61 74   have to look at
0ae0: 20 6f 75 72 20 6f 77 6e 20 69 6e 74 65 72 6e 61   our own interna
0af0: 6c 20 72 65 63 6f 72 64 20 6f 66 20 74 68 65 0a  l record of the.
0b00: 2a 2a 20 6c 6f 63 6b 73 20 74 6f 20 73 65 65 20  ** locks to see 
0b10: 69 66 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61  if another threa
0b20: 64 20 68 61 73 20 70 72 65 76 69 6f 75 73 6c 79  d has previously
0b30: 20 73 65 74 20 61 20 6c 6f 63 6b 20 6f 6e 20 74   set a lock on t
0b40: 68 61 74 20 73 61 6d 65 0a 2a 2a 20 69 6e 6f 64  hat same.** inod
0b50: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4f 73 46  e..**.** The OsF
0b60: 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 66 6f  ile structure fo
0b70: 72 20 50 4f 53 49 58 20 69 73 20 6e 6f 20 6c 6f  r POSIX is no lo
0b80: 6e 67 65 72 20 6a 75 73 74 20 61 6e 20 69 6e 74  nger just an int
0b90: 65 67 65 72 20 66 69 6c 65 0a 2a 2a 20 64 65 73  eger file.** des
0ba0: 63 72 69 70 74 6f 72 2e 20 20 49 74 20 69 73 20  criptor.  It is 
0bb0: 6e 6f 77 20 61 20 73 74 72 75 63 74 75 72 65 20  now a structure 
0bc0: 74 68 61 74 20 68 6f 6c 64 73 20 74 68 65 20 69  that holds the i
0bd0: 6e 74 65 67 65 72 20 66 69 6c 65 0a 2a 2a 20 64  nteger file.** d
0be0: 65 73 63 72 69 70 74 6f 72 20 61 6e 64 20 61 20  escriptor and a 
0bf0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 73 74 72  pointer to a str
0c00: 75 63 74 75 72 65 20 74 68 61 74 20 64 65 73 63  ucture that desc
0c10: 72 69 62 65 73 20 74 68 65 20 69 6e 74 65 72 6e  ribes the intern
0c20: 61 6c 0a 2a 2a 20 6c 6f 63 6b 73 20 6f 6e 20 74  al.** locks on t
0c30: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
0c40: 20 69 6e 6f 64 65 2e 20 20 54 68 65 72 65 20 69   inode.  There i
0c50: 73 20 6f 6e 65 20 6c 6f 63 6b 69 6e 67 20 73 74  s one locking st
0c60: 72 75 63 74 75 72 65 0a 2a 2a 20 70 65 72 20 69  ructure.** per i
0c70: 6e 6f 64 65 2c 20 73 6f 20 69 66 20 74 68 65 20  node, so if the 
0c80: 73 61 6d 65 20 69 6e 6f 64 65 20 69 73 20 6f 70  same inode is op
0c90: 65 6e 65 64 20 74 77 69 63 65 2c 20 62 6f 74 68  ened twice, both
0ca0: 20 4f 73 46 69 6c 65 20 73 74 72 75 63 74 75 72   OsFile structur
0cb0: 65 73 0a 2a 2a 20 70 6f 69 6e 74 20 74 6f 20 74  es.** point to t
0cc0: 68 65 20 73 61 6d 65 20 6c 6f 63 6b 69 6e 67 20  he same locking 
0cd0: 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 20  structure.  The 
0ce0: 6c 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72  locking structur
0cf0: 65 20 6b 65 65 70 73 0a 2a 2a 20 61 20 72 65 66  e keeps.** a ref
0d00: 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 28 73 6f  erence count (so
0d10: 20 77 65 20 77 69 6c 6c 20 6b 6e 6f 77 20 77 68   we will know wh
0d20: 65 6e 20 74 6f 20 64 65 6c 65 74 65 20 69 74 29  en to delete it)
0d30: 20 61 6e 64 20 61 20 22 63 6e 74 22 0a 2a 2a 20   and a "cnt".** 
0d40: 66 69 65 6c 64 20 74 68 61 74 20 74 65 6c 6c 73  field that tells
0d50: 20 75 73 20 69 74 73 20 69 6e 74 65 72 6e 61 6c   us its internal
0d60: 20 6c 6f 63 6b 20 73 74 61 74 75 73 2e 20 20 63   lock status.  c
0d70: 6e 74 3d 3d 30 20 6d 65 61 6e 73 20 74 68 65 0a  nt==0 means the.
0d80: 2a 2a 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63  ** file is unloc
0d90: 6b 65 64 2e 20 20 63 6e 74 3d 3d 2d 31 20 6d 65  ked.  cnt==-1 me
0da0: 61 6e 73 20 74 68 65 20 66 69 6c 65 20 68 61 73  ans the file has
0db0: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f   an exclusive lo
0dc0: 63 6b 2e 0a 2a 2a 20 63 6e 74 3e 30 20 6d 65 61  ck..** cnt>0 mea
0dd0: 6e 73 20 74 68 65 72 65 20 61 72 65 20 63 6e 74  ns there are cnt
0de0: 20 73 68 61 72 65 64 20 6c 6f 63 6b 73 20 6f 6e   shared locks on
0df0: 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a   the file..**.**
0e00: 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20   Any attempt to 
0e10: 6c 6f 63 6b 20 6f 72 20 75 6e 6c 6f 63 6b 20 61  lock or unlock a
0e20: 20 66 69 6c 65 20 66 69 72 73 74 20 63 68 65 63   file first chec
0e30: 6b 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 0a 2a  ks the locking.*
0e40: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68  * structure.  Th
0e50: 65 20 66 63 6e 74 6c 28 29 20 73 79 73 74 65 6d  e fcntl() system
0e60: 20 63 61 6c 6c 20 69 73 20 6f 6e 6c 79 20 69 6e   call is only in
0e70: 76 6f 6b 65 64 20 74 6f 20 73 65 74 20 61 20 0a  voked to set a .
0e80: 2a 2a 20 50 4f 53 49 58 20 6c 6f 63 6b 20 69 66  ** POSIX lock if
0e90: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 6c 6f   the internal lo
0ea0: 63 6b 20 73 74 72 75 63 74 75 72 65 20 74 72 61  ck structure tra
0eb0: 6e 73 69 74 69 6f 6e 73 20 62 65 74 77 65 65 6e  nsitions between
0ec0: 0a 2a 2a 20 61 20 6c 6f 63 6b 65 64 20 61 6e 64  .** a locked and
0ed0: 20 61 6e 20 75 6e 6c 6f 63 6b 65 64 20 73 74 61   an unlocked sta
0ee0: 74 65 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e  te..*/../*.** An
0ef0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65   instance of the
0f00: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63   following struc
0f10: 74 75 72 65 20 73 65 72 76 65 73 20 61 73 20 74  ture serves as t
0f20: 68 65 20 6b 65 79 20 75 73 65 64 0a 2a 2a 20 74  he key used.** t
0f30: 6f 20 6c 6f 63 61 74 65 20 61 20 70 61 72 74 69  o locate a parti
0f40: 63 75 6c 61 72 20 6c 6f 63 6b 49 6e 66 6f 20 73  cular lockInfo s
0f50: 74 72 75 63 74 75 72 65 20 67 69 76 65 6e 20 69  tructure given i
0f60: 74 73 20 69 6e 6f 64 65 2e 20 0a 2a 2f 0a 73 74  ts inode. .*/.st
0f70: 72 75 63 74 20 69 6e 6f 64 65 4b 65 79 20 7b 0a  ruct inodeKey {.
0f80: 20 20 64 65 76 5f 74 20 64 65 76 3b 20 20 20 2f    dev_t dev;   /
0f90: 2a 20 44 65 76 69 63 65 20 6e 75 6d 62 65 72 20  * Device number 
0fa0: 2a 2f 0a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20  */.  ino_t ino; 
0fb0: 20 20 2f 2a 20 49 6e 6f 64 65 20 6e 75 6d 62 65    /* Inode numbe
0fc0: 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41  r */.};../*.** A
0fd0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
0fe0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  e following stru
0ff0: 63 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 61 74  cture is allocat
1000: 65 64 20 66 6f 72 20 65 61 63 68 20 69 6e 6f 64  ed for each inod
1010: 65 2e 0a 2a 2a 20 41 20 73 69 6e 67 6c 65 20 69  e..** A single i
1020: 6e 6f 64 65 20 63 61 6e 20 68 61 76 65 20 6d 75  node can have mu
1030: 6c 74 69 70 6c 65 20 66 69 6c 65 20 64 65 73 63  ltiple file desc
1040: 72 69 70 74 6f 72 73 2c 20 73 6f 20 65 61 63 68  riptors, so each
1050: 20 4f 73 46 69 6c 65 0a 2a 2a 20 73 74 72 75 63   OsFile.** struc
1060: 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 61 20  ture contains a 
1070: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 6e  pointer to an in
1080: 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f  stance of this o
1090: 62 6a 65 63 74 20 61 6e 64 20 74 68 69 73 0a 2a  bject and this.*
10a0: 2a 20 6f 62 6a 65 63 74 20 6b 65 65 70 73 20 61  * object keeps a
10b0: 20 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 6e 75   count of the nu
10c0: 6d 62 65 72 20 6f 66 20 4f 73 46 69 6c 65 73 20  mber of OsFiles 
10d0: 70 6f 69 6e 74 69 6e 67 20 74 6f 20 69 74 2e 0a  pointing to it..
10e0: 2a 2f 0a 73 74 72 75 63 74 20 6c 6f 63 6b 49 6e  */.struct lockIn
10f0: 66 6f 20 7b 0a 20 20 73 74 72 75 63 74 20 69 6e  fo {.  struct in
1100: 6f 64 65 4b 65 79 20 6b 65 79 3b 20 20 2f 2a 20  odeKey key;  /* 
1110: 54 68 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20 2a  The lookup key *
1120: 2f 0a 20 20 69 6e 74 20 63 6e 74 3b 20 20 20 20  /.  int cnt;    
1130: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30 3a 20            /* 0: 
1140: 75 6e 6c 6f 63 6b 65 64 2e 20 20 2d 31 3a 20 77  unlocked.  -1: w
1150: 72 69 74 65 20 6c 6f 63 6b 2e 20 20 31 2e 2e 2e  rite lock.  1...
1160: 3a 20 72 65 61 64 20 6c 6f 63 6b 2e 20 2a 2f 0a  : read lock. */.
1170: 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20    int nRef;     
1180: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
1190: 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f  r of pointers to
11a0: 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20   this structure 
11b0: 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 0a 2a 2a 20 54 68  */.};../* .** Th
11c0: 69 73 20 68 61 73 68 20 74 61 62 6c 65 20 6d 61  is hash table ma
11d0: 70 73 20 69 6e 6f 64 65 73 20 28 69 6e 20 74 68  ps inodes (in th
11e0: 65 20 66 6f 72 6d 20 6f 66 20 69 6e 6f 64 65 4b  e form of inodeK
11f0: 65 79 20 73 74 72 75 63 74 75 72 65 73 29 20 69  ey structures) i
1200: 6e 74 6f 0a 2a 2a 20 70 6f 69 6e 74 65 72 73 20  nto.** pointers 
1210: 74 6f 20 6c 6f 63 6b 49 6e 66 6f 20 73 74 72 75  to lockInfo stru
1220: 63 74 75 72 65 73 2e 0a 2a 2f 0a 73 74 61 74 69  ctures..*/.stati
1230: 63 20 48 61 73 68 20 6c 6f 63 6b 48 61 73 68 20  c Hash lockHash 
1240: 3d 20 7b 20 53 51 4c 49 54 45 5f 48 41 53 48 5f  = { SQLITE_HASH_
1250: 42 49 4e 41 52 59 2c 20 30 2c 20 30 2c 20 30 2c  BINARY, 0, 0, 0,
1260: 20 30 2c 20 30 20 7d 3b 0a 0a 2f 2a 0a 2a 2a 20   0, 0 };../*.** 
1270: 47 69 76 65 6e 20 61 20 66 69 6c 65 20 64 65 73  Given a file des
1280: 63 72 69 70 74 6f 72 2c 20 6c 6f 63 61 74 65 20  criptor, locate 
1290: 61 20 6c 6f 63 6b 49 6e 66 6f 20 73 74 72 75 63  a lockInfo struc
12a0: 74 75 72 65 20 74 68 61 74 20 64 65 73 63 72 69  ture that descri
12b0: 62 65 73 0a 2a 2a 20 74 68 61 74 20 66 69 6c 65  bes.** that file
12c0: 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 43 72   descriptor.  Cr
12d0: 65 61 74 65 20 61 20 6e 65 77 20 6f 6e 65 20 69  eate a new one i
12e0: 66 20 6e 65 63 65 73 73 61 72 79 2e 20 20 4e 55  f necessary.  NU
12f0: 4c 4c 20 6d 69 67 68 74 0a 2a 2a 20 62 65 20 72  LL might.** be r
1300: 65 74 75 72 6e 65 64 20 69 66 20 6d 61 6c 6c 6f  eturned if mallo
1310: 63 28 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74  c() fails..*/.st
1320: 61 74 69 63 20 73 74 72 75 63 74 20 6c 6f 63 6b  atic struct lock
1330: 49 6e 66 6f 20 2a 66 69 6e 64 4c 6f 63 6b 49 6e  Info *findLockIn
1340: 66 6f 28 69 6e 74 20 66 64 29 7b 0a 20 20 69 6e  fo(int fd){.  in
1350: 74 20 72 63 3b 0a 20 20 73 74 72 75 63 74 20 69  t rc;.  struct i
1360: 6e 6f 64 65 4b 65 79 20 6b 65 79 3b 0a 20 20 73  nodeKey key;.  s
1370: 74 72 75 63 74 20 73 74 61 74 20 73 74 61 74 62  truct stat statb
1380: 75 66 3b 0a 20 20 73 74 72 75 63 74 20 6c 6f 63  uf;.  struct loc
1390: 6b 49 6e 66 6f 20 2a 70 49 6e 66 6f 3b 0a 20 20  kInfo *pInfo;.  
13a0: 72 63 20 3d 20 66 73 74 61 74 28 66 64 2c 20 26  rc = fstat(fd, &
13b0: 73 74 61 74 62 75 66 29 3b 0a 20 20 69 66 28 20  statbuf);.  if( 
13c0: 72 63 21 3d 30 20 29 20 72 65 74 75 72 6e 20 30  rc!=0 ) return 0
13d0: 3b 0a 20 20 6d 65 6d 73 65 74 28 26 6b 65 79 2c  ;.  memset(&key,
13e0: 20 30 2c 20 73 69 7a 65 6f 66 28 6b 65 79 29 29   0, sizeof(key))
13f0: 3b 0a 20 20 6b 65 79 2e 64 65 76 20 3d 20 73 74  ;.  key.dev = st
1400: 61 74 62 75 66 2e 73 74 5f 64 65 76 3b 0a 20 20  atbuf.st_dev;.  
1410: 6b 65 79 2e 69 6e 6f 20 3d 20 73 74 61 74 62 75  key.ino = statbu
1420: 66 2e 73 74 5f 69 6e 6f 3b 0a 20 20 70 49 6e 66  f.st_ino;.  pInf
1430: 6f 20 3d 20 28 73 74 72 75 63 74 20 6c 6f 63 6b  o = (struct lock
1440: 49 6e 66 6f 2a 29 73 71 6c 69 74 65 48 61 73 68  Info*)sqliteHash
1450: 46 69 6e 64 28 26 6c 6f 63 6b 48 61 73 68 2c 20  Find(&lockHash, 
1460: 26 6b 65 79 2c 20 73 69 7a 65 6f 66 28 6b 65 79  &key, sizeof(key
1470: 29 29 3b 0a 20 20 69 66 28 20 70 49 6e 66 6f 3d  ));.  if( pInfo=
1480: 3d 30 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74  =0 ){.    struct
1490: 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70 4f 6c 64 3b   lockInfo *pOld;
14a0: 0a 20 20 20 20 70 49 6e 66 6f 20 3d 20 73 71 6c  .    pInfo = sql
14b0: 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f  iteMalloc( sizeo
14c0: 66 28 2a 70 49 6e 66 6f 29 20 29 3b 0a 20 20 20  f(*pInfo) );.   
14d0: 20 69 66 28 20 70 49 6e 66 6f 3d 3d 30 20 29 20   if( pInfo==0 ) 
14e0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 70 49  return 0;.    pI
14f0: 6e 66 6f 2d 3e 6b 65 79 20 3d 20 6b 65 79 3b 0a  nfo->key = key;.
1500: 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 52 65 66 20      pInfo->nRef 
1510: 3d 20 31 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e  = 1;.    pInfo->
1520: 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 70 4f 6c  cnt = 0;.    pOl
1530: 64 20 3d 20 73 71 6c 69 74 65 48 61 73 68 49 6e  d = sqliteHashIn
1540: 73 65 72 74 28 26 6c 6f 63 6b 48 61 73 68 2c 20  sert(&lockHash, 
1550: 26 70 49 6e 66 6f 2d 3e 6b 65 79 2c 20 73 69 7a  &pInfo->key, siz
1560: 65 6f 66 28 6b 65 79 29 2c 20 70 49 6e 66 6f 29  eof(key), pInfo)
1570: 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64 21 3d  ;.    if( pOld!=
1580: 30 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72  0 ){.      asser
1590: 74 28 20 70 4f 6c 64 3d 3d 70 49 6e 66 6f 20 29  t( pOld==pInfo )
15a0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72  ;.      sqliteFr
15b0: 65 65 28 70 49 6e 66 6f 29 3b 0a 20 20 20 20 20  ee(pInfo);.     
15c0: 20 70 49 6e 66 6f 20 3d 20 30 3b 0a 20 20 20 20   pInfo = 0;.    
15d0: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70  }.  }else{.    p
15e0: 49 6e 66 6f 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20  Info->nRef++;.  
15f0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 49 6e 66 6f  }.  return pInfo
1600: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61  ;.}../*.** Relea
1610: 73 65 20 61 20 6c 6f 63 6b 49 6e 66 6f 20 73 74  se a lockInfo st
1620: 72 75 63 74 75 72 65 20 70 72 65 76 69 6f 75 73  ructure previous
1630: 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20  ly allocated by 
1640: 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 29 2e 0a  findLockInfo()..
1650: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  */.static void r
1660: 65 6c 65 61 73 65 4c 6f 63 6b 49 6e 66 6f 28 73  eleaseLockInfo(s
1670: 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a  truct lockInfo *
1680: 70 49 6e 66 6f 29 7b 0a 20 20 70 49 6e 66 6f 2d  pInfo){.  pInfo-
1690: 3e 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70  >nRef--;.  if( p
16a0: 49 6e 66 6f 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b  Info->nRef==0 ){
16b0: 0a 20 20 20 20 73 71 6c 69 74 65 48 61 73 68 49  .    sqliteHashI
16c0: 6e 73 65 72 74 28 26 6c 6f 63 6b 48 61 73 68 2c  nsert(&lockHash,
16d0: 20 26 70 49 6e 66 6f 2d 3e 6b 65 79 2c 20 73 69   &pInfo->key, si
16e0: 7a 65 6f 66 28 70 49 6e 66 6f 2d 3e 6b 65 79 29  zeof(pInfo->key)
16f0: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
1700: 46 72 65 65 28 70 49 6e 66 6f 29 3b 0a 20 20 7d  Free(pInfo);.  }
1710: 0a 7d 0a 23 65 6e 64 69 66 20 20 2f 2a 2a 20 50  .}.#endif  /** P
1720: 4f 53 49 58 20 61 64 76 69 73 6f 72 79 20 6c 6f  OSIX advisory lo
1730: 63 6b 20 77 6f 72 6b 2d 61 72 6f 75 6e 64 20 2a  ck work-around *
1740: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77 65 20  */../*.** If we 
1750: 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 74 68 65  compile with the
1760: 20 53 51 4c 49 54 45 5f 54 45 53 54 20 6d 61 63   SQLITE_TEST mac
1770: 72 6f 20 73 65 74 2c 20 74 68 65 6e 20 74 68 65  ro set, then the
1780: 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b   following block
1790: 0a 2a 2a 20 6f 66 20 63 6f 64 65 20 77 69 6c 6c  .** of code will
17a0: 20 67 69 76 65 20 75 73 20 74 68 65 20 61 62 69   give us the abi
17b0: 6c 69 74 79 20 74 6f 20 73 69 6d 75 6c 61 74 65  lity to simulate
17c0: 20 61 20 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f   a disk I/O erro
17d0: 72 2e 20 20 54 68 69 73 0a 2a 2a 20 69 73 20 75  r.  This.** is u
17e0: 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67 20  sed for testing 
17f0: 74 68 65 20 49 2f 4f 20 72 65 63 6f 76 65 72 79  the I/O recovery
1800: 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 23 69 66 64 65   logic..*/.#ifde
1810: 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 69 6e  f SQLITE_TEST.in
1820: 74 20 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72 6f  t sqlite_io_erro
1830: 72 5f 70 65 6e 64 69 6e 67 20 3d 20 30 3b 0a 23  r_pending = 0;.#
1840: 64 65 66 69 6e 65 20 53 69 6d 75 6c 61 74 65 49  define SimulateI
1850: 4f 45 72 72 6f 72 28 41 29 20 20 5c 0a 20 20 20  OError(A)  \.   
1860: 69 66 28 20 73 71 6c 69 74 65 5f 69 6f 5f 65 72  if( sqlite_io_er
1870: 72 6f 72 5f 70 65 6e 64 69 6e 67 20 29 20 5c 0a  ror_pending ) \.
1880: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 5f       if( sqlite_
1890: 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67  io_error_pending
18a0: 2d 2d 20 3d 3d 20 31 20 29 7b 20 6c 6f 63 61 6c  -- == 1 ){ local
18b0: 5f 69 6f 65 72 72 28 29 3b 20 72 65 74 75 72 6e  _ioerr(); return
18c0: 20 41 3b 20 7d 0a 73 74 61 74 69 63 20 76 6f 69   A; }.static voi
18d0: 64 20 6c 6f 63 61 6c 5f 69 6f 65 72 72 28 29 7b  d local_ioerr(){
18e0: 0a 20 20 73 71 6c 69 74 65 5f 69 6f 5f 65 72 72  .  sqlite_io_err
18f0: 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 30 3b 20  or_pending = 0; 
1900: 20 2f 2a 20 52 65 61 6c 6c 79 20 6a 75 73 74 20   /* Really just 
1910: 61 20 70 6c 61 63 65 20 74 6f 20 73 65 74 20 61  a place to set a
1920: 20 62 72 65 61 6b 70 6f 69 6e 74 20 2a 2f 0a 7d   breakpoint */.}
1930: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 53  .#else.#define S
1940: 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 41  imulateIOError(A
1950: 29 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a  ).#endif.../*.**
1960: 20 44 65 6c 65 74 65 20 74 68 65 20 6e 61 6d 65   Delete the name
1970: 64 20 66 69 6c 65 0a 2a 2f 0a 69 6e 74 20 73 71  d file.*/.int sq
1980: 6c 69 74 65 4f 73 44 65 6c 65 74 65 28 63 6f 6e  liteOsDelete(con
1990: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
19a0: 6d 65 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58  me){.#if OS_UNIX
19b0: 0a 20 20 75 6e 6c 69 6e 6b 28 7a 46 69 6c 65 6e  .  unlink(zFilen
19c0: 61 6d 65 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66  ame);.#endif.#if
19d0: 20 4f 53 5f 57 49 4e 0a 20 20 44 65 6c 65 74 65   OS_WIN.  Delete
19e0: 46 69 6c 65 28 7a 46 69 6c 65 6e 61 6d 65 29 3b  File(zFilename);
19f0: 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e  .#endif.  return
1a00: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
1a10: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45  *.** Return TRUE
1a20: 20 69 66 20 74 68 65 20 6e 61 6d 65 64 20 66 69   if the named fi
1a30: 6c 65 20 65 78 69 73 74 73 2e 0a 2a 2f 0a 69 6e  le exists..*/.in
1a40: 74 20 73 71 6c 69 74 65 4f 73 46 69 6c 65 45 78  t sqliteOsFileEx
1a50: 69 73 74 73 28 63 6f 6e 73 74 20 63 68 61 72 20  ists(const char 
1a60: 2a 7a 46 69 6c 65 6e 61 6d 65 29 7b 0a 23 69 66  *zFilename){.#if
1a70: 20 4f 53 5f 55 4e 49 58 0a 20 20 72 65 74 75 72   OS_UNIX.  retur
1a80: 6e 20 61 63 63 65 73 73 28 7a 46 69 6c 65 6e 61  n access(zFilena
1a90: 6d 65 2c 20 30 29 3d 3d 30 3b 0a 23 65 6e 64 69  me, 0)==0;.#endi
1aa0: 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 72  f.#if OS_WIN.  r
1ab0: 65 74 75 72 6e 20 47 65 74 46 69 6c 65 41 74 74  eturn GetFileAtt
1ac0: 72 69 62 75 74 65 73 28 7a 46 69 6c 65 6e 61 6d  ributes(zFilenam
1ad0: 65 29 20 21 3d 20 30 78 66 66 66 66 66 66 66 66  e) != 0xffffffff
1ae0: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a  ;.#endif.}.../*.
1af0: 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f 70  ** Attempt to op
1b00: 65 6e 20 61 20 66 69 6c 65 20 66 6f 72 20 62 6f  en a file for bo
1b10: 74 68 20 72 65 61 64 69 6e 67 20 61 6e 64 20 77  th reading and w
1b20: 72 69 74 69 6e 67 2e 20 20 49 66 20 74 68 61 74  riting.  If that
1b30: 0a 2a 2a 20 66 61 69 6c 73 2c 20 74 72 79 20 6f  .** fails, try o
1b40: 70 65 6e 69 6e 67 20 69 74 20 72 65 61 64 2d 6f  pening it read-o
1b50: 6e 6c 79 2e 20 20 49 66 20 74 68 65 20 66 69 6c  nly.  If the fil
1b60: 65 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74  e does not exist
1b70: 2c 0a 2a 2a 20 74 72 79 20 74 6f 20 63 72 65 61  ,.** try to crea
1b80: 74 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20  te it..**.** On 
1b90: 73 75 63 63 65 73 73 2c 20 61 20 68 61 6e 64 6c  success, a handl
1ba0: 65 20 66 6f 72 20 74 68 65 20 6f 70 65 6e 20 66  e for the open f
1bb0: 69 6c 65 20 69 73 20 77 72 69 74 74 65 6e 20 74  ile is written t
1bc0: 6f 20 2a 69 64 0a 2a 2a 20 61 6e 64 20 2a 70 52  o *id.** and *pR
1bd0: 65 61 64 6f 6e 6c 79 20 69 73 20 73 65 74 20 74  eadonly is set t
1be0: 6f 20 30 20 69 66 20 74 68 65 20 66 69 6c 65 20  o 0 if the file 
1bf0: 77 61 73 20 6f 70 65 6e 65 64 20 66 6f 72 20 72  was opened for r
1c00: 65 61 64 69 6e 67 20 61 6e 64 0a 2a 2a 20 77 72  eading and.** wr
1c10: 69 74 69 6e 67 20 6f 72 20 31 20 69 66 20 74 68  iting or 1 if th
1c20: 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 6e 65  e file was opene
1c30: 64 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 20 54 68  d read-only.  Th
1c40: 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  e function retur
1c50: 6e 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e  ns.** SQLITE_OK.
1c60: 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75 72  .**.** On failur
1c70: 65 2c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20  e, the function 
1c80: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 43  returns SQLITE_C
1c90: 41 4e 54 4f 50 45 4e 20 61 6e 64 20 6c 65 61 76  ANTOPEN and leav
1ca0: 65 73 0a 2a 2a 20 2a 70 52 65 73 75 6c 73 74 20  es.** *pResulst 
1cb0: 61 6e 64 20 2a 70 52 65 61 64 6f 6e 6c 79 20 75  and *pReadonly u
1cc0: 6e 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74  nchanged..*/.int
1cd0: 20 73 71 6c 69 74 65 4f 73 4f 70 65 6e 52 65 61   sqliteOsOpenRea
1ce0: 64 57 72 69 74 65 28 0a 20 20 63 6f 6e 73 74 20  dWrite(.  const 
1cf0: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c  char *zFilename,
1d00: 0a 20 20 4f 73 46 69 6c 65 20 2a 69 64 2c 0a 20  .  OsFile *id,. 
1d10: 20 69 6e 74 20 2a 70 52 65 61 64 6f 6e 6c 79 0a   int *pReadonly.
1d20: 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20  ){.#if OS_UNIX. 
1d30: 20 69 64 2d 3e 66 64 20 3d 20 6f 70 65 6e 28 7a   id->fd = open(z
1d40: 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44 57 52  Filename, O_RDWR
1d50: 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b  |O_CREAT, 0644);
1d60: 0a 20 20 69 66 28 20 69 64 2d 3e 66 64 3c 30 20  .  if( id->fd<0 
1d70: 29 7b 0a 20 20 20 20 69 64 2d 3e 66 64 20 3d 20  ){.    id->fd = 
1d80: 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20  open(zFilename, 
1d90: 4f 5f 52 44 4f 4e 4c 59 29 3b 0a 20 20 20 20 69  O_RDONLY);.    i
1da0: 66 28 20 69 64 2d 3e 66 64 3c 30 20 29 7b 0a 20  f( id->fd<0 ){. 
1db0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
1dc0: 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a 20 20  TE_CANTOPEN; .  
1dd0: 20 20 7d 0a 20 20 20 20 2a 70 52 65 61 64 6f 6e    }.    *pReadon
1de0: 6c 79 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b  ly = 1;.  }else{
1df0: 0a 20 20 20 20 2a 70 52 65 61 64 6f 6e 6c 79 20  .    *pReadonly 
1e00: 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  = 0;.  }.  sqlit
1e10: 65 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  eOsEnterMutex();
1e20: 0a 20 20 69 64 2d 3e 70 4c 6f 63 6b 20 3d 20 66  .  id->pLock = f
1e30: 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 69 64 2d 3e  indLockInfo(id->
1e40: 66 64 29 3b 0a 20 20 73 71 6c 69 74 65 4f 73 4c  fd);.  sqliteOsL
1e50: 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 69  eaveMutex();.  i
1e60: 66 28 20 69 64 2d 3e 70 4c 6f 63 6b 3d 3d 30 20  f( id->pLock==0 
1e70: 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28 69 64 2d  ){.    close(id-
1e80: 3e 66 64 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  >fd);.    return
1e90: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
1ea0: 20 7d 0a 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20   }.  id->locked 
1eb0: 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 0;.  return SQ
1ec0: 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a  LITE_OK;.#endif.
1ed0: 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 48 41 4e  #if OS_WIN.  HAN
1ee0: 44 4c 45 20 68 20 3d 20 43 72 65 61 74 65 46 69  DLE h = CreateFi
1ef0: 6c 65 28 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20  le(zFilename,.  
1f00: 20 20 20 47 45 4e 45 52 49 43 5f 52 45 41 44 20     GENERIC_READ 
1f10: 7c 20 47 45 4e 45 52 49 43 5f 57 52 49 54 45 2c  | GENERIC_WRITE,
1f20: 0a 20 20 20 20 20 46 49 4c 45 5f 53 48 41 52 45  .     FILE_SHARE
1f30: 5f 52 45 41 44 20 7c 20 46 49 4c 45 5f 53 48 41  _READ | FILE_SHA
1f40: 52 45 5f 57 52 49 54 45 2c 0a 20 20 20 20 20 4e  RE_WRITE,.     N
1f50: 55 4c 4c 2c 0a 20 20 20 20 20 4f 50 45 4e 5f 41  ULL,.     OPEN_A
1f60: 4c 57 41 59 53 2c 0a 20 20 20 20 20 46 49 4c 45  LWAYS,.     FILE
1f70: 5f 41 54 54 52 49 42 55 54 45 5f 4e 4f 52 4d 41  _ATTRIBUTE_NORMA
1f80: 4c 20 7c 20 46 49 4c 45 5f 46 4c 41 47 5f 52 41  L | FILE_FLAG_RA
1f90: 4e 44 4f 4d 5f 41 43 43 45 53 53 2c 0a 20 20 20  NDOM_ACCESS,.   
1fa0: 20 20 4e 55 4c 4c 0a 20 20 29 3b 0a 20 20 69 66    NULL.  );.  if
1fb0: 28 20 68 3d 3d 49 4e 56 41 4c 49 44 5f 48 41 4e  ( h==INVALID_HAN
1fc0: 44 4c 45 5f 56 41 4c 55 45 20 29 7b 0a 20 20 20  DLE_VALUE ){.   
1fd0: 20 68 20 3d 20 43 72 65 61 74 65 46 69 6c 65 28   h = CreateFile(
1fe0: 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20  zFilename,.     
1ff0: 20 20 47 45 4e 45 52 49 43 5f 52 45 41 44 2c 0a    GENERIC_READ,.
2000: 20 20 20 20 20 20 20 46 49 4c 45 5f 53 48 41 52         FILE_SHAR
2010: 45 5f 52 45 41 44 2c 0a 20 20 20 20 20 20 20 4e  E_READ,.       N
2020: 55 4c 4c 2c 0a 20 20 20 20 20 20 20 4f 50 45 4e  ULL,.       OPEN
2030: 5f 41 4c 57 41 59 53 2c 0a 20 20 20 20 20 20 20  _ALWAYS,.       
2040: 46 49 4c 45 5f 41 54 54 52 49 42 55 54 45 5f 4e  FILE_ATTRIBUTE_N
2050: 4f 52 4d 41 4c 20 7c 20 46 49 4c 45 5f 46 4c 41  ORMAL | FILE_FLA
2060: 47 5f 52 41 4e 44 4f 4d 5f 41 43 43 45 53 53 2c  G_RANDOM_ACCESS,
2070: 0a 20 20 20 20 20 20 20 4e 55 4c 4c 0a 20 20 20  .       NULL.   
2080: 20 29 3b 0a 20 20 20 20 69 66 28 20 68 3d 3d 49   );.    if( h==I
2090: 4e 56 41 4c 49 44 5f 48 41 4e 44 4c 45 5f 56 41  NVALID_HANDLE_VA
20a0: 4c 55 45 20 29 7b 0a 20 20 20 20 20 20 72 65 74  LUE ){.      ret
20b0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  urn SQLITE_CANTO
20c0: 50 45 4e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2a  PEN;.    }.    *
20d0: 70 52 65 61 64 6f 6e 6c 79 20 3d 20 31 3b 0a 20  pReadonly = 1;. 
20e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 52 65   }else{.    *pRe
20f0: 61 64 6f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d 0a  adonly = 0;.  }.
2100: 20 20 69 64 2d 3e 68 20 3d 20 68 3b 0a 20 20 69    id->h = h;.  i
2110: 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 30 3b 0a 20  d->locked = 0;. 
2120: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
2130: 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a  K;.#endif.}.../*
2140: 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f  .** Attempt to o
2150: 70 65 6e 20 61 20 6e 65 77 20 66 69 6c 65 20 66  pen a new file f
2160: 6f 72 20 65 78 63 6c 75 73 69 76 65 20 61 63 63  or exclusive acc
2170: 65 73 73 20 62 79 20 74 68 69 73 20 70 72 6f 63  ess by this proc
2180: 65 73 73 2e 0a 2a 2a 20 54 68 65 20 66 69 6c 65  ess..** The file
2190: 20 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 20   will be opened 
21a0: 66 6f 72 20 62 6f 74 68 20 72 65 61 64 69 6e 67  for both reading
21b0: 20 61 6e 64 20 77 72 69 74 69 6e 67 2e 20 20 54   and writing.  T
21c0: 6f 20 61 76 6f 69 64 0a 2a 2a 20 61 20 70 6f 74  o avoid.** a pot
21d0: 65 6e 74 69 61 6c 20 73 65 63 75 72 69 74 79 20  ential security 
21e0: 70 72 6f 62 6c 65 6d 2c 20 77 65 20 64 6f 20 6e  problem, we do n
21f0: 6f 74 20 61 6c 6c 6f 77 20 74 68 65 20 66 69 6c  ot allow the fil
2200: 65 20 74 6f 20 68 61 76 65 0a 2a 2a 20 70 72 65  e to have.** pre
2210: 76 69 6f 75 73 6c 79 20 65 78 69 73 74 65 64 2e  viously existed.
2220: 20 20 4e 6f 72 20 64 6f 20 77 65 20 61 6c 6c 6f    Nor do we allo
2230: 77 20 74 68 65 20 66 69 6c 65 20 74 6f 20 62 65  w the file to be
2240: 20 61 20 73 79 6d 62 6f 6c 69 63 0a 2a 2a 20 6c   a symbolic.** l
2250: 69 6e 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 65  ink..**.** If de
2260: 6c 46 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74  lFlag is true, t
2270: 68 65 6e 20 6d 61 6b 65 20 61 72 72 61 6e 67 65  hen make arrange
2280: 6d 65 6e 74 73 20 74 6f 20 61 75 74 6f 6d 61 74  ments to automat
2290: 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 0a 2a 2a  ically delete.**
22a0: 20 74 68 65 20 66 69 6c 65 20 77 68 65 6e 20 69   the file when i
22b0: 74 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a  t is closed..**.
22c0: 2a 2a 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 77  ** On success, w
22d0: 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 68 61  rite the file ha
22e0: 6e 64 6c 65 20 69 6e 74 6f 20 2a 69 64 20 61 6e  ndle into *id an
22f0: 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  d return SQLITE_
2300: 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69  OK..**.** On fai
2310: 6c 75 72 65 2c 20 72 65 74 75 72 6e 20 53 51 4c  lure, return SQL
2320: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 2e 0a 2a 2f  ITE_CANTOPEN..*/
2330: 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 4f 70 65  .int sqliteOsOpe
2340: 6e 45 78 63 6c 75 73 69 76 65 28 63 6f 6e 73 74  nExclusive(const
2350: 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65   char *zFilename
2360: 2c 20 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e  , OsFile *id, in
2370: 74 20 64 65 6c 46 6c 61 67 29 7b 0a 23 69 66 20  t delFlag){.#if 
2380: 4f 53 5f 55 4e 49 58 0a 20 20 69 66 28 20 61 63  OS_UNIX.  if( ac
2390: 63 65 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c 20  cess(zFilename, 
23a0: 30 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74  0)==0 ){.    ret
23b0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f  urn SQLITE_CANTO
23c0: 50 45 4e 3b 0a 20 20 7d 0a 23 69 66 6e 64 65 66  PEN;.  }.#ifndef
23d0: 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 0a 23 20 64 65   O_NOFOLLOW.# de
23e0: 66 69 6e 65 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 20  fine O_NOFOLLOW 
23f0: 30 0a 23 65 6e 64 69 66 0a 20 20 69 64 2d 3e 66  0.#endif.  id->f
2400: 64 20 3d 20 6f 70 65 6e 28 7a 46 69 6c 65 6e 61  d = open(zFilena
2410: 6d 65 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45  me, O_RDWR|O_CRE
2420: 41 54 7c 4f 5f 45 58 43 4c 7c 4f 5f 4e 4f 46 4f  AT|O_EXCL|O_NOFO
2430: 4c 4c 4f 57 2c 20 30 36 30 30 29 3b 0a 20 20 69  LLOW, 0600);.  i
2440: 66 28 20 69 64 2d 3e 66 64 3c 30 20 29 7b 0a 20  f( id->fd<0 ){. 
2450: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
2460: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20  _CANTOPEN;.  }. 
2470: 20 73 71 6c 69 74 65 4f 73 45 6e 74 65 72 4d 75   sqliteOsEnterMu
2480: 74 65 78 28 29 3b 0a 20 20 69 64 2d 3e 70 4c 6f  tex();.  id->pLo
2490: 63 6b 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66  ck = findLockInf
24a0: 6f 28 69 64 2d 3e 66 64 29 3b 0a 20 20 73 71 6c  o(id->fd);.  sql
24b0: 69 74 65 4f 73 4c 65 61 76 65 4d 75 74 65 78 28  iteOsLeaveMutex(
24c0: 29 3b 0a 20 20 69 66 28 20 69 64 2d 3e 70 4c 6f  );.  if( id->pLo
24d0: 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 63 6c 6f  ck==0 ){.    clo
24e0: 73 65 28 69 64 2d 3e 66 64 29 3b 0a 20 20 20 20  se(id->fd);.    
24f0: 75 6e 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65  unlink(zFilename
2500: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
2510: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
2520: 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 30    id->locked = 0
2530: 3b 0a 20 20 69 66 28 20 64 65 6c 46 6c 61 67 20  ;.  if( delFlag 
2540: 29 7b 0a 20 20 20 20 75 6e 6c 69 6e 6b 28 7a 46  ){.    unlink(zF
2550: 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 7d 0a 20 20  ilename);.  }.  
2560: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2570: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f  ;.#endif.#if OS_
2580: 57 49 4e 0a 20 20 48 41 4e 44 4c 45 20 68 3b 0a  WIN.  HANDLE h;.
2590: 20 20 69 6e 74 20 66 69 6c 65 66 6c 61 67 73 3b    int fileflags;
25a0: 0a 20 20 69 66 28 20 64 65 6c 46 6c 61 67 20 29  .  if( delFlag )
25b0: 7b 0a 20 20 20 20 66 69 6c 65 66 6c 61 67 73 20  {.    fileflags 
25c0: 3d 20 46 49 4c 45 5f 41 54 54 52 49 42 55 54 45  = FILE_ATTRIBUTE
25d0: 5f 54 45 4d 50 4f 52 41 52 59 20 7c 20 46 49 4c  _TEMPORARY | FIL
25e0: 45 5f 46 4c 41 47 5f 52 41 4e 44 4f 4d 5f 41 43  E_FLAG_RANDOM_AC
25f0: 43 45 53 53 20 0a 20 20 20 20 20 20 20 20 20 20  CESS .          
2600: 20 20 20 20 20 20 20 20 20 20 20 7c 20 46 49 4c             | FIL
2610: 45 5f 46 4c 41 47 5f 44 45 4c 45 54 45 5f 4f 4e  E_FLAG_DELETE_ON
2620: 5f 43 4c 4f 53 45 3b 0a 20 20 7d 65 6c 73 65 7b  _CLOSE;.  }else{
2630: 0a 20 20 20 20 66 69 6c 65 66 6c 61 67 73 20 3d  .    fileflags =
2640: 20 46 49 4c 45 5f 46 4c 41 47 5f 52 41 4e 44 4f   FILE_FLAG_RANDO
2650: 4d 5f 41 43 43 45 53 53 3b 0a 20 20 7d 0a 20 20  M_ACCESS;.  }.  
2660: 68 20 3d 20 43 72 65 61 74 65 46 69 6c 65 28 7a  h = CreateFile(z
2670: 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 47  Filename,.     G
2680: 45 4e 45 52 49 43 5f 52 45 41 44 20 7c 20 47 45  ENERIC_READ | GE
2690: 4e 45 52 49 43 5f 57 52 49 54 45 2c 0a 20 20 20  NERIC_WRITE,.   
26a0: 20 20 30 2c 0a 20 20 20 20 20 4e 55 4c 4c 2c 0a    0,.     NULL,.
26b0: 20 20 20 20 20 43 52 45 41 54 45 5f 41 4c 57 41       CREATE_ALWA
26c0: 59 53 2c 0a 20 20 20 20 20 66 69 6c 65 66 6c 61  YS,.     filefla
26d0: 67 73 2c 0a 20 20 20 20 20 4e 55 4c 4c 0a 20 20  gs,.     NULL.  
26e0: 29 3b 0a 20 20 69 66 28 20 68 3d 3d 49 4e 56 41  );.  if( h==INVA
26f0: 4c 49 44 5f 48 41 4e 44 4c 45 5f 56 41 4c 55 45  LID_HANDLE_VALUE
2700: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
2710: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a  QLITE_CANTOPEN;.
2720: 20 20 7d 0a 20 20 69 64 2d 3e 68 20 3d 20 68 3b    }.  id->h = h;
2730: 0a 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20  .  id->locked = 
2740: 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  0;.  return SQLI
2750: 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a  TE_OK;.#endif.}.
2760: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74  ./*.** Attempt t
2770: 6f 20 6f 70 65 6e 20 61 20 6e 65 77 20 66 69 6c  o open a new fil
2780: 65 20 66 6f 72 20 72 65 61 64 2d 6f 6e 6c 79 20  e for read-only 
2790: 61 63 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  access..**.** On
27a0: 20 73 75 63 63 65 73 73 2c 20 77 72 69 74 65 20   success, write 
27b0: 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 20  the file handle 
27c0: 69 6e 74 6f 20 2a 69 64 20 61 6e 64 20 72 65 74  into *id and ret
27d0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a  urn SQLITE_OK..*
27e0: 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65 2c  *.** On failure,
27f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43   return SQLITE_C
2800: 41 4e 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74 20  ANTOPEN..*/.int 
2810: 73 71 6c 69 74 65 4f 73 4f 70 65 6e 52 65 61 64  sqliteOsOpenRead
2820: 4f 6e 6c 79 28 63 6f 6e 73 74 20 63 68 61 72 20  Only(const char 
2830: 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 73 46 69  *zFilename, OsFi
2840: 6c 65 20 2a 69 64 29 7b 0a 23 69 66 20 4f 53 5f  le *id){.#if OS_
2850: 55 4e 49 58 0a 20 20 69 64 2d 3e 66 64 20 3d 20  UNIX.  id->fd = 
2860: 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20  open(zFilename, 
2870: 4f 5f 52 44 4f 4e 4c 59 29 3b 0a 20 20 69 66 28  O_RDONLY);.  if(
2880: 20 69 64 2d 3e 66 64 3c 30 20 29 7b 0a 20 20 20   id->fd<0 ){.   
2890: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43   return SQLITE_C
28a0: 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20 20 73  ANTOPEN;.  }.  s
28b0: 71 6c 69 74 65 4f 73 45 6e 74 65 72 4d 75 74 65  qliteOsEnterMute
28c0: 78 28 29 3b 0a 20 20 69 64 2d 3e 70 4c 6f 63 6b  x();.  id->pLock
28d0: 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28   = findLockInfo(
28e0: 69 64 2d 3e 66 64 29 3b 0a 20 20 73 71 6c 69 74  id->fd);.  sqlit
28f0: 65 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 3b  eOsLeaveMutex();
2900: 0a 20 20 69 66 28 20 69 64 2d 3e 70 4c 6f 63 6b  .  if( id->pLock
2910: 3d 3d 30 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65  ==0 ){.    close
2920: 28 69 64 2d 3e 66 64 29 3b 0a 20 20 20 20 72 65  (id->fd);.    re
2930: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  turn SQLITE_NOME
2940: 4d 3b 0a 20 20 7d 0a 20 20 69 64 2d 3e 6c 6f 63  M;.  }.  id->loc
2950: 6b 65 64 20 3d 20 30 3b 0a 20 20 72 65 74 75 72  ked = 0;.  retur
2960: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e  n SQLITE_OK;.#en
2970: 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20  dif.#if OS_WIN. 
2980: 20 48 41 4e 44 4c 45 20 68 20 3d 20 43 72 65 61   HANDLE h = Crea
2990: 74 65 46 69 6c 65 28 7a 46 69 6c 65 6e 61 6d 65  teFile(zFilename
29a0: 2c 0a 20 20 20 20 20 47 45 4e 45 52 49 43 5f 52  ,.     GENERIC_R
29b0: 45 41 44 2c 0a 20 20 20 20 20 30 2c 0a 20 20 20  EAD,.     0,.   
29c0: 20 20 4e 55 4c 4c 2c 0a 20 20 20 20 20 4f 50 45    NULL,.     OPE
29d0: 4e 5f 45 58 49 53 54 49 4e 47 2c 0a 20 20 20 20  N_EXISTING,.    
29e0: 20 46 49 4c 45 5f 41 54 54 52 49 42 55 54 45 5f   FILE_ATTRIBUTE_
29f0: 4e 4f 52 4d 41 4c 20 7c 20 46 49 4c 45 5f 46 4c  NORMAL | FILE_FL
2a00: 41 47 5f 52 41 4e 44 4f 4d 5f 41 43 43 45 53 53  AG_RANDOM_ACCESS
2a10: 2c 0a 20 20 20 20 20 4e 55 4c 4c 0a 20 20 29 3b  ,.     NULL.  );
2a20: 0a 20 20 69 66 28 20 68 3d 3d 49 4e 56 41 4c 49  .  if( h==INVALI
2a30: 44 5f 48 41 4e 44 4c 45 5f 56 41 4c 55 45 20 29  D_HANDLE_VALUE )
2a40: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
2a50: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20  ITE_CANTOPEN;.  
2a60: 7d 0a 20 20 69 64 2d 3e 68 20 3d 20 68 3b 0a 20  }.  id->h = h;. 
2a70: 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 30 3b   id->locked = 0;
2a80: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
2a90: 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  _OK;.#endif.}../
2aa0: 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 74 65  *.** Create a te
2ab0: 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 6e 61 6d  mporary file nam
2ac0: 65 20 69 6e 20 7a 42 75 66 2e 20 20 7a 42 75 66  e in zBuf.  zBuf
2ad0: 20 6d 75 73 74 20 62 65 20 62 69 67 20 65 6e 6f   must be big eno
2ae0: 75 67 68 20 74 6f 0a 2a 2a 20 68 6f 6c 64 20 61  ugh to.** hold a
2af0: 74 20 6c 65 61 73 74 20 53 51 4c 49 54 45 5f 54  t least SQLITE_T
2b00: 45 4d 50 4e 41 4d 45 5f 53 49 5a 45 20 63 68 61  EMPNAME_SIZE cha
2b10: 72 61 63 74 65 72 73 2e 0a 2a 2f 0a 69 6e 74 20  racters..*/.int 
2b20: 73 71 6c 69 74 65 4f 73 54 65 6d 70 46 69 6c 65  sqliteOsTempFile
2b30: 4e 61 6d 65 28 63 68 61 72 20 2a 7a 42 75 66 29  Name(char *zBuf)
2b40: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20  {.#if OS_UNIX.  
2b50: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61  static const cha
2b60: 72 20 2a 61 7a 44 69 72 73 5b 5d 20 3d 20 7b 0a  r *azDirs[] = {.
2b70: 20 20 20 20 20 22 2f 76 61 72 2f 74 6d 70 22 2c       "/var/tmp",
2b80: 0a 20 20 20 20 20 22 2f 75 73 72 2f 74 6d 70 22  .     "/usr/tmp"
2b90: 2c 0a 20 20 20 20 20 22 2f 74 6d 70 22 2c 0a 20  ,.     "/tmp",. 
2ba0: 20 20 20 20 22 2e 22 2c 0a 20 20 7d 3b 0a 20 20      ".",.  };.  
2bb0: 73 74 61 74 69 63 20 63 68 61 72 20 7a 43 68 61  static char zCha
2bc0: 72 73 5b 5d 20 3d 0a 20 20 20 20 22 61 62 63 64  rs[] =.    "abcd
2bd0: 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72 73 74  efghijklmnopqrst
2be0: 75 76 77 78 79 7a 22 0a 20 20 20 20 22 41 42 43  uvwxyz".    "ABC
2bf0: 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f 50 51 52 53  DEFGHIJKLMNOPQRS
2c00: 54 55 56 57 58 59 5a 22 0a 20 20 20 20 22 30 31  TUVWXYZ".    "01
2c10: 32 33 34 35 36 37 38 39 22 3b 0a 20 20 69 6e 74  23456789";.  int
2c20: 20 69 2c 20 6a 3b 0a 20 20 73 74 72 75 63 74 20   i, j;.  struct 
2c30: 73 74 61 74 20 62 75 66 3b 0a 20 20 63 6f 6e 73  stat buf;.  cons
2c40: 74 20 63 68 61 72 20 2a 7a 44 69 72 20 3d 20 22  t char *zDir = "
2c50: 2e 22 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69  .";.  for(i=0; i
2c60: 3c 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f  <sizeof(azDirs)/
2c70: 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d  sizeof(azDirs[0]
2c80: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  ); i++){.    if(
2c90: 20 73 74 61 74 28 61 7a 44 69 72 73 5b 69 5d 2c   stat(azDirs[i],
2ca0: 20 26 62 75 66 29 20 29 20 63 6f 6e 74 69 6e 75   &buf) ) continu
2cb0: 65 3b 0a 20 20 20 20 69 66 28 20 21 53 5f 49 53  e;.    if( !S_IS
2cc0: 44 49 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29  DIR(buf.st_mode)
2cd0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
2ce0: 20 69 66 28 20 61 63 63 65 73 73 28 61 7a 44 69   if( access(azDi
2cf0: 72 73 5b 69 5d 2c 20 30 37 29 20 29 20 63 6f 6e  rs[i], 07) ) con
2d00: 74 69 6e 75 65 3b 0a 20 20 20 20 7a 44 69 72 20  tinue;.    zDir 
2d10: 3d 20 61 7a 44 69 72 73 5b 69 5d 3b 0a 20 20 20  = azDirs[i];.   
2d20: 20 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 64 6f   break;.  }.  do
2d30: 7b 0a 20 20 20 20 73 70 72 69 6e 74 66 28 7a 42  {.    sprintf(zB
2d40: 75 66 2c 20 22 25 73 2f 73 71 6c 69 74 65 5f 22  uf, "%s/sqlite_"
2d50: 2c 20 7a 44 69 72 29 3b 0a 20 20 20 20 6a 20 3d  , zDir);.    j =
2d60: 20 73 74 72 6c 65 6e 28 7a 42 75 66 29 3b 0a 20   strlen(zBuf);. 
2d70: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 31 35     for(i=0; i<15
2d80: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 6e  ; i++){.      in
2d90: 74 20 6e 20 3d 20 73 71 6c 69 74 65 52 61 6e 64  t n = sqliteRand
2da0: 6f 6d 42 79 74 65 28 29 20 25 20 28 73 69 7a 65  omByte() % (size
2db0: 6f 66 28 7a 43 68 61 72 73 29 2d 31 29 3b 0a 20  of(zChars)-1);. 
2dc0: 20 20 20 20 20 7a 42 75 66 5b 6a 2b 2b 5d 20 3d       zBuf[j++] =
2dd0: 20 7a 43 68 61 72 73 5b 6e 5d 3b 0a 20 20 20 20   zChars[n];.    
2de0: 7d 0a 20 20 20 20 7a 42 75 66 5b 6a 5d 20 3d 20  }.    zBuf[j] = 
2df0: 30 3b 0a 20 20 7d 77 68 69 6c 65 28 20 61 63 63  0;.  }while( acc
2e00: 65 73 73 28 7a 42 75 66 2c 30 29 3d 3d 30 20 29  ess(zBuf,0)==0 )
2e10: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f  ;.#endif.#if OS_
2e20: 57 49 4e 0a 20 20 73 74 61 74 69 63 20 63 68 61  WIN.  static cha
2e30: 72 20 7a 43 68 61 72 73 5b 5d 20 3d 0a 20 20 20  r zChars[] =.   
2e40: 20 22 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e   "abcdefghijklmn
2e50: 6f 70 71 72 73 74 75 76 77 78 79 7a 22 0a 20 20  opqrstuvwxyz".  
2e60: 20 20 22 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d    "ABCDEFGHIJKLM
2e70: 4e 4f 50 51 52 53 54 55 56 57 58 59 5a 22 0a 20  NOPQRSTUVWXYZ". 
2e80: 20 20 20 22 30 31 32 33 34 35 36 37 38 39 22 3b     "0123456789";
2e90: 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 63  .  int i, j;.  c
2ea0: 68 61 72 20 7a 54 65 6d 70 50 61 74 68 5b 53 51  har zTempPath[SQ
2eb0: 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45 5f 53 49  LITE_TEMPNAME_SI
2ec0: 5a 45 5d 3b 0a 20 20 47 65 74 54 65 6d 70 50 61  ZE];.  GetTempPa
2ed0: 74 68 28 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41  th(SQLITE_TEMPNA
2ee0: 4d 45 5f 53 49 5a 45 2d 33 30 2c 20 7a 54 65 6d  ME_SIZE-30, zTem
2ef0: 70 50 61 74 68 29 3b 0a 20 20 66 6f 72 28 69 3d  pPath);.  for(i=
2f00: 73 74 72 6c 65 6e 28 7a 54 65 6d 70 50 61 74 68  strlen(zTempPath
2f10: 29 3b 20 69 3e 30 20 26 26 20 7a 54 65 6d 70 50  ); i>0 && zTempP
2f20: 61 74 68 5b 69 2d 31 5d 3d 3d 27 5c 5c 27 3b 20  ath[i-1]=='\\'; 
2f30: 69 2d 2d 29 7b 7d 0a 20 20 7a 54 65 6d 70 50 61  i--){}.  zTempPa
2f40: 74 68 5b 69 5d 20 3d 20 30 3b 0a 20 20 66 6f 72  th[i] = 0;.  for
2f50: 28 3b 3b 29 7b 0a 20 20 20 20 73 70 72 69 6e 74  (;;){.    sprint
2f60: 66 28 7a 42 75 66 2c 20 22 25 73 5c 5c 73 71 6c  f(zBuf, "%s\\sql
2f70: 69 74 65 5f 22 2c 20 7a 54 65 6d 70 50 61 74 68  ite_", zTempPath
2f80: 29 3b 0a 20 20 20 20 6a 20 3d 20 73 74 72 6c 65  );.    j = strle
2f90: 6e 28 7a 42 75 66 29 3b 0a 20 20 20 20 66 6f 72  n(zBuf);.    for
2fa0: 28 69 3d 30 3b 20 69 3c 31 35 3b 20 69 2b 2b 29  (i=0; i<15; i++)
2fb0: 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20  {.      int n = 
2fc0: 73 71 6c 69 74 65 52 61 6e 64 6f 6d 42 79 74 65  sqliteRandomByte
2fd0: 28 29 20 25 20 73 69 7a 65 6f 66 28 7a 43 68 61  () % sizeof(zCha
2fe0: 72 73 29 3b 0a 20 20 20 20 20 20 7a 42 75 66 5b  rs);.      zBuf[
2ff0: 6a 2b 2b 5d 20 3d 20 7a 43 68 61 72 73 5b 6e 5d  j++] = zChars[n]
3000: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66  ;.    }.    zBuf
3010: 5b 6a 5d 20 3d 20 30 3b 0a 20 20 20 20 69 66 28  [j] = 0;.    if(
3020: 20 21 73 71 6c 69 74 65 4f 73 46 69 6c 65 45 78   !sqliteOsFileEx
3030: 69 73 74 73 28 7a 42 75 66 29 20 29 20 62 72 65  ists(zBuf) ) bre
3040: 61 6b 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ak;.  }.#endif. 
3050: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
3060: 4b 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f  K; .}../*.** Clo
3070: 73 65 20 61 20 66 69 6c 65 0a 2a 2f 0a 69 6e 74  se a file.*/.int
3080: 20 73 71 6c 69 74 65 4f 73 43 6c 6f 73 65 28 4f   sqliteOsClose(O
3090: 73 46 69 6c 65 20 2a 69 64 29 7b 0a 23 69 66 20  sFile *id){.#if 
30a0: 4f 53 5f 55 4e 49 58 0a 20 20 63 6c 6f 73 65 28  OS_UNIX.  close(
30b0: 69 64 2d 3e 66 64 29 3b 0a 20 20 73 71 6c 69 74  id->fd);.  sqlit
30c0: 65 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  eOsEnterMutex();
30d0: 0a 20 20 72 65 6c 65 61 73 65 4c 6f 63 6b 49 6e  .  releaseLockIn
30e0: 66 6f 28 69 64 2d 3e 70 4c 6f 63 6b 29 3b 0a 20  fo(id->pLock);. 
30f0: 20 73 71 6c 69 74 65 4f 73 4c 65 61 76 65 4d 75   sqliteOsLeaveMu
3100: 74 65 78 28 29 3b 0a 20 20 72 65 74 75 72 6e 20  tex();.  return 
3110: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69  SQLITE_OK;.#endi
3120: 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 43  f.#if OS_WIN.  C
3130: 6c 6f 73 65 48 61 6e 64 6c 65 28 69 64 2d 3e 68  loseHandle(id->h
3140: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
3150: 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a  TE_OK;.#endif.}.
3160: 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 64 61 74 61  ./*.** Read data
3170: 20 66 72 6f 6d 20 61 20 66 69 6c 65 20 69 6e 74   from a file int
3180: 6f 20 61 20 62 75 66 66 65 72 2e 20 20 52 65 74  o a buffer.  Ret
3190: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66  urn SQLITE_OK if
31a0: 20 61 6c 6c 0a 2a 2a 20 62 79 74 65 73 20 77 65   all.** bytes we
31b0: 72 65 20 72 65 61 64 20 73 75 63 63 65 73 73 66  re read successf
31c0: 75 6c 6c 79 20 61 6e 64 20 53 51 4c 49 54 45 5f  ully and SQLITE_
31d0: 49 4f 45 52 52 20 69 66 20 61 6e 79 74 68 69 6e  IOERR if anythin
31e0: 67 20 67 6f 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e  g goes.** wrong.
31f0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73  .*/.int sqliteOs
3200: 52 65 61 64 28 4f 73 46 69 6c 65 20 2a 69 64 2c  Read(OsFile *id,
3210: 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74   void *pBuf, int
3220: 20 61 6d 74 29 7b 0a 23 69 66 20 4f 53 5f 55 4e   amt){.#if OS_UN
3230: 49 58 0a 20 20 69 6e 74 20 67 6f 74 3b 0a 20 20  IX.  int got;.  
3240: 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28  SimulateIOError(
3250: 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a 20  SQLITE_IOERR);. 
3260: 20 54 52 41 43 45 32 28 22 52 45 41 44 20 25 64   TRACE2("READ %d
3270: 5c 6e 22 2c 20 6c 61 73 74 5f 70 61 67 65 29 3b  \n", last_page);
3280: 0a 20 20 67 6f 74 20 3d 20 72 65 61 64 28 69 64  .  got = read(id
3290: 2d 3e 66 64 2c 20 70 42 75 66 2c 20 61 6d 74 29  ->fd, pBuf, amt)
32a0: 3b 0a 20 20 2f 2a 20 69 66 28 20 67 6f 74 3c 30  ;.  /* if( got<0
32b0: 20 29 20 67 6f 74 20 3d 20 30 3b 20 2a 2f 0a 20   ) got = 0; */. 
32c0: 20 69 66 28 20 67 6f 74 3d 3d 61 6d 74 20 29 7b   if( got==amt ){
32d0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
32e0: 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a  TE_OK;.  }else{.
32f0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
3300: 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 23 65 6e  E_IOERR;.  }.#en
3310: 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20  dif.#if OS_WIN. 
3320: 20 44 57 4f 52 44 20 67 6f 74 3b 0a 20 20 53 69   DWORD got;.  Si
3330: 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 53 51  mulateIOError(SQ
3340: 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a 20 20 69  LITE_IOERR);.  i
3350: 66 28 20 21 52 65 61 64 46 69 6c 65 28 69 64 2d  f( !ReadFile(id-
3360: 3e 68 2c 20 70 42 75 66 2c 20 61 6d 74 2c 20 26  >h, pBuf, amt, &
3370: 67 6f 74 2c 20 30 29 20 29 7b 0a 20 20 20 20 67  got, 0) ){.    g
3380: 6f 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66  ot = 0;.  }.  if
3390: 28 20 67 6f 74 3d 3d 61 6d 74 20 29 7b 0a 20 20  ( got==amt ){.  
33a0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
33b0: 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  OK;.  }else{.   
33c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49   return SQLITE_I
33d0: 4f 45 52 52 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  OERR;.  }.#endif
33e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20  .}../*.** Write 
33f0: 64 61 74 61 20 66 72 6f 6d 20 61 20 62 75 66 66  data from a buff
3400: 65 72 20 69 6e 74 6f 20 61 20 66 69 6c 65 2e 20  er into a file. 
3410: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   Return SQLITE_O
3420: 4b 20 6f 6e 20 73 75 63 63 65 73 73 0a 2a 2a 20  K on success.** 
3430: 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72 20 65 72  or some other er
3440: 72 6f 72 20 63 6f 64 65 20 6f 6e 20 66 61 69 6c  ror code on fail
3450: 75 72 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ure..*/.int sqli
3460: 74 65 4f 73 57 72 69 74 65 28 4f 73 46 69 6c 65  teOsWrite(OsFile
3470: 20 2a 69 64 2c 20 63 6f 6e 73 74 20 76 6f 69 64   *id, const void
3480: 20 2a 70 42 75 66 2c 20 69 6e 74 20 61 6d 74 29   *pBuf, int amt)
3490: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20  {.#if OS_UNIX.  
34a0: 69 6e 74 20 77 72 6f 74 65 20 3d 20 30 3b 0a 20  int wrote = 0;. 
34b0: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
34c0: 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a  (SQLITE_IOERR);.
34d0: 20 20 54 52 41 43 45 32 28 22 57 52 49 54 45 20    TRACE2("WRITE 
34e0: 25 64 5c 6e 22 2c 20 6c 61 73 74 5f 70 61 67 65  %d\n", last_page
34f0: 29 3b 0a 20 20 77 68 69 6c 65 28 20 61 6d 74 3e  );.  while( amt>
3500: 30 20 26 26 20 28 77 72 6f 74 65 20 3d 20 77 72  0 && (wrote = wr
3510: 69 74 65 28 69 64 2d 3e 66 64 2c 20 70 42 75 66  ite(id->fd, pBuf
3520: 2c 20 61 6d 74 29 29 3e 30 20 29 7b 0a 20 20 20  , amt))>0 ){.   
3530: 20 61 6d 74 20 2d 3d 20 77 72 6f 74 65 3b 0a 20   amt -= wrote;. 
3540: 20 20 20 70 42 75 66 20 3d 20 26 28 28 63 68 61     pBuf = &((cha
3550: 72 2a 29 70 42 75 66 29 5b 77 72 6f 74 65 5d 3b  r*)pBuf)[wrote];
3560: 0a 20 20 7d 0a 20 20 69 66 28 20 61 6d 74 3e 30  .  }.  if( amt>0
3570: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
3580: 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 7d 0a  QLITE_FULL;.  }.
3590: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
35a0: 4f 4b 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f  OK;.#endif.#if O
35b0: 53 5f 57 49 4e 0a 20 20 69 6e 74 20 72 63 3b 0a  S_WIN.  int rc;.
35c0: 20 20 44 57 4f 52 44 20 77 72 6f 74 65 3b 0a 20    DWORD wrote;. 
35d0: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
35e0: 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a  (SQLITE_IOERR);.
35f0: 20 20 77 68 69 6c 65 28 20 61 6d 74 3e 30 20 26    while( amt>0 &
3600: 26 20 28 72 63 20 3d 20 57 72 69 74 65 46 69 6c  & (rc = WriteFil
3610: 65 28 69 64 2d 3e 68 2c 20 70 42 75 66 2c 20 61  e(id->h, pBuf, a
3620: 6d 74 2c 20 26 77 72 6f 74 65 2c 20 30 29 29 21  mt, &wrote, 0))!
3630: 3d 30 20 26 26 20 77 72 6f 74 65 3e 30 20 29 7b  =0 && wrote>0 ){
3640: 0a 20 20 20 20 61 6d 74 20 2d 3d 20 77 72 6f 74  .    amt -= wrot
3650: 65 3b 0a 20 20 20 20 70 42 75 66 20 3d 20 26 28  e;.    pBuf = &(
3660: 28 63 68 61 72 2a 29 70 42 75 66 29 5b 77 72 6f  (char*)pBuf)[wro
3670: 74 65 5d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21  te];.  }.  if( !
3680: 72 63 20 7c 7c 20 61 6d 74 3e 28 69 6e 74 29 77  rc || amt>(int)w
3690: 72 6f 74 65 20 29 7b 0a 20 20 20 20 72 65 74 75  rote ){.    retu
36a0: 72 6e 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a  rn SQLITE_FULL;.
36b0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c    }.  return SQL
36c0: 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d  ITE_OK;.#endif.}
36d0: 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65  ../*.** Move the
36e0: 20 72 65 61 64 2f 77 72 69 74 65 20 70 6f 69 6e   read/write poin
36f0: 74 65 72 20 69 6e 20 61 20 66 69 6c 65 2e 0a 2a  ter in a file..*
3700: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 53 65  /.int sqliteOsSe
3710: 65 6b 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69  ek(OsFile *id, i
3720: 6e 74 20 6f 66 66 73 65 74 29 7b 0a 20 20 53 45  nt offset){.  SE
3730: 45 4b 28 6f 66 66 73 65 74 2f 31 30 32 34 20 2b  EK(offset/1024 +
3740: 20 31 29 3b 0a 23 69 66 20 4f 53 5f 55 4e 49 58   1);.#if OS_UNIX
3750: 0a 20 20 6c 73 65 65 6b 28 69 64 2d 3e 66 64 2c  .  lseek(id->fd,
3760: 20 6f 66 66 73 65 74 2c 20 53 45 45 4b 5f 53 45   offset, SEEK_SE
3770: 54 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  T);.  return SQL
3780: 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 23  ITE_OK;.#endif.#
3790: 69 66 20 4f 53 5f 57 49 4e 0a 20 20 53 65 74 46  if OS_WIN.  SetF
37a0: 69 6c 65 50 6f 69 6e 74 65 72 28 69 64 2d 3e 68  ilePointer(id->h
37b0: 2c 20 6f 66 66 73 65 74 2c 20 30 2c 20 46 49 4c  , offset, 0, FIL
37c0: 45 5f 42 45 47 49 4e 29 3b 0a 20 20 72 65 74 75  E_BEGIN);.  retu
37d0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65  rn SQLITE_OK;.#e
37e0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61  ndif.}../*.** Ma
37f0: 6b 65 20 73 75 72 65 20 61 6c 6c 20 77 72 69 74  ke sure all writ
3800: 65 73 20 74 6f 20 61 20 70 61 72 74 69 63 75 6c  es to a particul
3810: 61 72 20 66 69 6c 65 20 61 72 65 20 63 6f 6d 6d  ar file are comm
3820: 69 74 74 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a  itted to disk..*
3830: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 53 79  /.int sqliteOsSy
3840: 6e 63 28 4f 73 46 69 6c 65 20 2a 69 64 29 7b 0a  nc(OsFile *id){.
3850: 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f    SimulateIOErro
3860: 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b  r(SQLITE_IOERR);
3870: 0a 20 20 54 52 41 43 45 31 28 22 53 59 4e 43 5c  .  TRACE1("SYNC\
3880: 6e 22 29 3b 0a 23 69 66 20 4f 53 5f 55 4e 49 58  n");.#if OS_UNIX
3890: 0a 20 20 69 66 28 20 66 73 79 6e 63 28 69 64 2d  .  if( fsync(id-
38a0: 3e 66 64 29 20 29 7b 0a 20 20 20 20 72 65 74 75  >fd) ){.    retu
38b0: 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b  rn SQLITE_IOERR;
38c0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65  .  }else{.    re
38d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
38e0: 20 20 7d 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f    }.#endif.#if O
38f0: 53 5f 57 49 4e 0a 20 20 69 66 28 20 46 6c 75 73  S_WIN.  if( Flus
3900: 68 46 69 6c 65 42 75 66 66 65 72 73 28 69 64 2d  hFileBuffers(id-
3910: 3e 68 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  >h) ){.    retur
3920: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
3930: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e  else{.    return
3940: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20   SQLITE_IOERR;. 
3950: 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a   }.#endif.}../*.
3960: 2a 2a 20 54 72 75 6e 63 61 74 65 20 61 6e 20 6f  ** Truncate an o
3970: 70 65 6e 20 66 69 6c 65 20 74 6f 20 61 20 73 70  pen file to a sp
3980: 65 63 69 66 69 65 64 20 73 69 7a 65 0a 2a 2f 0a  ecified size.*/.
3990: 69 6e 74 20 73 71 6c 69 74 65 4f 73 54 72 75 6e  int sqliteOsTrun
39a0: 63 61 74 65 28 4f 73 46 69 6c 65 20 2a 69 64 2c  cate(OsFile *id,
39b0: 20 69 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20 53   int nByte){.  S
39c0: 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 53  imulateIOError(S
39d0: 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a 23 69  QLITE_IOERR);.#i
39e0: 66 20 4f 53 5f 55 4e 49 58 0a 20 20 72 65 74 75  f OS_UNIX.  retu
39f0: 72 6e 20 66 74 72 75 6e 63 61 74 65 28 69 64 2d  rn ftruncate(id-
3a00: 3e 66 64 2c 20 6e 42 79 74 65 29 3d 3d 30 20 3f  >fd, nByte)==0 ?
3a10: 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 4c   SQLITE_OK : SQL
3a20: 49 54 45 5f 49 4f 45 52 52 3b 0a 23 65 6e 64 69  ITE_IOERR;.#endi
3a30: 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 53  f.#if OS_WIN.  S
3a40: 65 74 46 69 6c 65 50 6f 69 6e 74 65 72 28 69 64  etFilePointer(id
3a50: 2d 3e 68 2c 20 6e 42 79 74 65 2c 20 30 2c 20 46  ->h, nByte, 0, F
3a60: 49 4c 45 5f 42 45 47 49 4e 29 3b 0a 20 20 53 65  ILE_BEGIN);.  Se
3a70: 74 45 6e 64 4f 66 46 69 6c 65 28 69 64 2d 3e 68  tEndOfFile(id->h
3a80: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
3a90: 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a  TE_OK;.#endif.}.
3aa0: 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 6e 65  ./*.** Determine
3ab0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 69 7a   the current siz
3ac0: 65 20 6f 66 20 61 20 66 69 6c 65 20 69 6e 20 62  e of a file in b
3ad0: 79 74 65 73 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ytes.*/.int sqli
3ae0: 74 65 4f 73 46 69 6c 65 53 69 7a 65 28 4f 73 46  teOsFileSize(OsF
3af0: 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 2a 70 53  ile *id, int *pS
3b00: 69 7a 65 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49  ize){.#if OS_UNI
3b10: 58 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 20  X.  struct stat 
3b20: 62 75 66 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49  buf;.  SimulateI
3b30: 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f  OError(SQLITE_IO
3b40: 45 52 52 29 3b 0a 20 20 69 66 28 20 66 73 74 61  ERR);.  if( fsta
3b50: 74 28 69 64 2d 3e 66 64 2c 20 26 62 75 66 29 21  t(id->fd, &buf)!
3b60: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
3b70: 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20   SQLITE_IOERR;. 
3b80: 20 7d 0a 20 20 2a 70 53 69 7a 65 20 3d 20 62 75   }.  *pSize = bu
3b90: 66 2e 73 74 5f 73 69 7a 65 3b 0a 20 20 72 65 74  f.st_size;.  ret
3ba0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23  urn SQLITE_OK;.#
3bb0: 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e  endif.#if OS_WIN
3bc0: 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72  .  SimulateIOErr
3bd0: 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29  or(SQLITE_IOERR)
3be0: 3b 0a 20 20 2a 70 53 69 7a 65 20 3d 20 47 65 74  ;.  *pSize = Get
3bf0: 46 69 6c 65 53 69 7a 65 28 69 64 2d 3e 68 2c 20  FileSize(id->h, 
3c00: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  0);.  return SQL
3c10: 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d  ITE_OK;.#endif.}
3c20: 0a 0a 2f 2a 0a 2a 2a 20 57 69 6e 64 6f 77 73 20  ../*.** Windows 
3c30: 66 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 6e 6f 74  file locking not
3c40: 65 73 3a 0a 2a 2a 0a 2a 2a 20 57 65 20 63 61 6e  es:.**.** We can
3c50: 6e 6f 74 20 75 73 65 20 4c 6f 63 6b 46 69 6c 65  not use LockFile
3c60: 45 78 28 29 20 6f 72 20 55 6e 6c 6f 63 6b 46 69  Ex() or UnlockFi
3c70: 6c 65 45 78 28 29 20 62 65 63 61 75 73 65 20 74  leEx() because t
3c80: 68 6f 73 65 20 66 75 6e 63 74 69 6f 6e 73 0a 2a  hose functions.*
3c90: 2a 20 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61  * are not availa
3ca0: 62 6c 65 20 75 6e 64 65 72 20 57 69 6e 39 35 2f  ble under Win95/
3cb0: 39 38 2f 4d 45 2e 20 20 53 6f 20 77 65 20 75 73  98/ME.  So we us
3cc0: 65 20 6f 6e 6c 79 20 4c 6f 63 6b 46 69 6c 65 28  e only LockFile(
3cd0: 29 20 61 6e 64 0a 2a 2a 20 55 6e 6c 6f 63 6b 46  ) and.** UnlockF
3ce0: 69 6c 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 41 20 72  ile()..**.** A r
3cf0: 65 61 64 20 6c 6f 63 6b 20 69 73 20 6f 62 74 61  ead lock is obta
3d00: 69 6e 65 64 20 62 79 20 6c 6f 63 6b 69 6e 67 20  ined by locking 
3d10: 61 20 73 69 6e 67 6c 65 20 72 61 6e 64 6f 6d 20  a single random 
3d20: 62 79 74 65 20 69 6e 20 74 68 65 0a 2a 2a 20 72  byte in the.** r
3d30: 61 6e 67 65 20 6f 66 20 31 20 74 6f 20 4d 58 5f  ange of 1 to MX_
3d40: 4c 4f 43 4b 42 59 54 45 2e 20 20 54 68 65 20 6c  LOCKBYTE.  The l
3d50: 6f 63 6b 20 62 79 74 65 20 69 73 20 6f 62 74 61  ock byte is obta
3d60: 69 6e 65 64 20 61 74 20 72 61 6e 64 6f 6d 20 73  ined at random s
3d70: 6f 0a 2a 2a 20 74 77 6f 20 73 65 70 61 72 61 74  o.** two separat
3d80: 65 20 72 65 61 64 65 72 73 20 63 61 6e 20 70 72  e readers can pr
3d90: 6f 62 61 62 6c 79 20 61 63 63 65 73 73 20 74 68  obably access th
3da0: 65 20 66 69 6c 65 20 61 74 20 74 68 65 20 73 61  e file at the sa
3db0: 6d 65 20 74 69 6d 65 2c 0a 2a 2a 20 75 6e 6c 65  me time,.** unle
3dc0: 73 73 20 74 68 65 79 20 61 72 65 20 75 6e 6c 75  ss they are unlu
3dd0: 63 6b 79 20 61 6e 64 20 63 68 6f 6f 73 65 20 74  cky and choose t
3de0: 68 65 20 73 61 6d 65 20 6c 6f 63 6b 20 62 79 74  he same lock byt
3df0: 65 2e 20 20 41 20 77 72 69 74 65 20 6c 6f 63 6b  e.  A write lock
3e00: 0a 2a 2a 20 69 73 20 6f 62 74 61 69 6e 65 64 20  .** is obtained 
3e10: 62 79 20 6c 6f 63 6b 69 6e 67 20 61 6c 6c 20 62  by locking all b
3e20: 79 74 65 73 20 69 6e 20 74 68 65 20 72 61 6e 67  ytes in the rang
3e30: 65 20 6f 66 20 31 20 74 6f 20 4d 58 5f 4c 4f 43  e of 1 to MX_LOC
3e40: 4b 42 59 54 45 2e 0a 2a 2a 20 54 68 65 72 65 20  KBYTE..** There 
3e50: 63 61 6e 20 6f 6e 6c 79 20 62 65 20 6f 6e 65 20  can only be one 
3e60: 77 72 69 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 41 20  writer..**.** A 
3e70: 6c 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64  lock is obtained
3e80: 20 6f 6e 20 62 79 74 65 20 30 20 62 65 66 6f 72   on byte 0 befor
3e90: 65 20 61 63 71 75 69 72 69 6e 67 20 65 69 74 68  e acquiring eith
3ea0: 65 72 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 6f  er a read lock o
3eb0: 72 0a 2a 2a 20 61 20 77 72 69 74 65 20 6c 6f 63  r.** a write loc
3ec0: 6b 2e 20 20 54 68 69 73 20 70 72 65 76 65 6e 74  k.  This prevent
3ed0: 73 20 74 77 6f 20 70 72 6f 63 65 73 73 65 73 20  s two processes 
3ee0: 66 72 6f 6d 20 61 74 74 65 6d 70 74 69 6e 67 20  from attempting 
3ef0: 74 6f 20 67 65 74 20 61 0a 2a 2a 20 6c 6f 63 6b  to get a.** lock
3f00: 20 61 74 20 61 20 73 61 6d 65 20 74 69 6d 65 2e   at a same time.
3f10: 20 20 54 68 65 20 73 65 6d 61 6e 74 69 63 73 20    The semantics 
3f20: 6f 66 20 73 71 6c 69 74 65 4f 73 52 65 61 64 4c  of sqliteOsReadL
3f30: 6f 63 6b 28 29 20 72 65 71 75 69 72 65 20 74 68  ock() require th
3f40: 61 74 0a 2a 2a 20 69 66 20 74 68 65 72 65 20 69  at.** if there i
3f50: 73 20 61 6c 72 65 61 64 79 20 61 20 77 72 69 74  s already a writ
3f60: 65 20 6c 6f 63 6b 2c 20 74 68 61 74 20 6c 6f 63  e lock, that loc
3f70: 6b 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69  k is converted i
3f80: 6e 74 6f 20 61 20 72 65 61 64 0a 2a 2a 20 6c 6f  nto a read.** lo
3f90: 63 6b 20 61 74 6f 6d 69 63 61 6c 6c 79 2e 20 20  ck atomically.  
3fa0: 54 68 65 20 6c 6f 63 6b 20 6f 6e 20 62 79 74 65  The lock on byte
3fb0: 20 30 20 61 6c 6c 6f 77 73 20 75 73 20 74 6f 20   0 allows us to 
3fc0: 64 72 6f 70 20 74 68 65 20 6f 6c 64 20 77 72 69  drop the old wri
3fd0: 74 65 0a 2a 2a 20 6c 6f 63 6b 20 61 6e 64 20 67  te.** lock and g
3fe0: 65 74 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b  et the read lock
3ff0: 20 77 69 74 68 6f 75 74 20 61 6e 6f 74 68 65 72   without another
4000: 20 70 72 6f 63 65 73 73 20 6a 75 6d 70 69 6e 67   process jumping
4010: 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 6d 69 64   into the.** mid
4020: 64 6c 65 20 61 6e 64 20 6d 65 73 73 69 6e 67 20  dle and messing 
4030: 75 73 20 75 70 2e 20 20 54 68 65 20 73 61 6d 65  us up.  The same
4040: 20 61 72 67 75 6d 65 6e 74 20 61 70 70 6c 69 65   argument applie
4050: 73 20 74 6f 20 73 71 6c 69 74 65 4f 73 57 72 69  s to sqliteOsWri
4060: 74 65 4c 6f 63 6b 28 29 2e 0a 2a 2a 0a 2a 2a 20  teLock()..**.** 
4070: 54 68 65 72 65 20 61 72 65 20 61 20 66 69 6e 69  There are a fini
4080: 74 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 61  te number of rea
4090: 64 20 6c 6f 63 6b 73 20 75 6e 64 65 72 20 77 69  d locks under wi
40a0: 6e 64 6f 77 73 2e 20 20 54 68 61 74 20 6e 75 6d  ndows.  That num
40b0: 62 65 72 0a 2a 2a 20 69 73 20 64 65 74 65 72 6d  ber.** is determ
40c0: 69 6e 65 64 20 62 79 20 74 68 65 20 66 6f 6c 6c  ined by the foll
40d0: 6f 77 69 6e 67 20 76 61 72 69 61 62 6c 65 3a 0a  owing variable:.
40e0: 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 58 5f 4c 4f  */.#define MX_LO
40f0: 43 4b 42 59 54 45 20 31 30 32 34 30 0a 0a 2f 2a  CKBYTE 10240../*
4100: 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 73  .** Change the s
4110: 74 61 74 75 73 20 6f 66 20 74 68 65 20 6c 6f 63  tatus of the loc
4120: 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 22 69  k on the file "i
4130: 64 22 20 74 6f 20 62 65 20 61 20 72 65 61 64 6c  d" to be a readl
4140: 6f 63 6b 2e 0a 2a 2a 20 49 66 20 74 68 65 20 66  ock..** If the f
4150: 69 6c 65 20 77 61 73 20 77 72 69 74 65 20 6c 6f  ile was write lo
4160: 63 6b 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20  cked, then this 
4170: 72 65 64 75 63 65 73 20 74 68 65 20 6c 6f 63 6b  reduces the lock
4180: 20 74 6f 20 61 20 72 65 61 64 2e 0a 2a 2a 20 49   to a read..** I
4190: 66 20 74 68 65 20 66 69 6c 65 20 77 61 73 20 72  f the file was r
41a0: 65 61 64 20 6c 6f 63 6b 65 64 2c 20 74 68 65 6e  ead locked, then
41b0: 20 74 68 69 73 20 61 63 71 75 69 72 65 73 20 61   this acquires a
41c0: 20 6e 65 77 20 72 65 61 64 20 6c 6f 63 6b 2e 0a   new read lock..
41d0: 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c  **.** Return SQL
41e0: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73  ITE_OK on succes
41f0: 73 20 61 6e 64 20 53 51 4c 49 54 45 5f 42 55 53  s and SQLITE_BUS
4200: 59 20 6f 6e 20 66 61 69 6c 75 72 65 2e 0a 2a 2f  Y on failure..*/
4210: 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 52 65 61  .int sqliteOsRea
4220: 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a 69 64  dLock(OsFile *id
4230: 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20  ){.#if OS_UNIX. 
4240: 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74   int rc;.  sqlit
4250: 65 4f 73 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  eOsEnterMutex();
4260: 0a 20 20 69 66 28 20 69 64 2d 3e 70 4c 6f 63 6b  .  if( id->pLock
4270: 2d 3e 63 6e 74 3e 30 20 29 7b 0a 20 20 20 20 69  ->cnt>0 ){.    i
4280: 66 28 20 21 69 64 2d 3e 6c 6f 63 6b 65 64 20 29  f( !id->locked )
4290: 7b 0a 20 20 20 20 20 20 69 64 2d 3e 70 4c 6f 63  {.      id->pLoc
42a0: 6b 2d 3e 63 6e 74 2b 2b 3b 0a 20 20 20 20 20 20  k->cnt++;.      
42b0: 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 31 3b 0a  id->locked = 1;.
42c0: 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 53      }.    rc = S
42d0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73  QLITE_OK;.  }els
42e0: 65 20 69 66 28 20 69 64 2d 3e 6c 6f 63 6b 65 64  e if( id->locked
42f0: 20 7c 7c 20 69 64 2d 3e 70 4c 6f 63 6b 2d 3e 63   || id->pLock->c
4300: 6e 74 3d 3d 30 20 29 7b 0a 20 20 20 20 73 74 72  nt==0 ){.    str
4310: 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a  uct flock lock;.
4320: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20      lock.l_type 
4330: 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 20 20 6c  = F_RDLCK;.    l
4340: 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53  ock.l_whence = S
4350: 45 45 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f 63  EEK_SET;.    loc
4360: 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 6c 6f 63 6b  k.l_start = lock
4370: 2e 6c 5f 6c 65 6e 20 3d 20 30 4c 3b 0a 20 20 20  .l_len = 0L;.   
4380: 20 69 66 28 20 66 63 6e 74 6c 28 69 64 2d 3e 66   if( fcntl(id->f
4390: 64 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63  d, F_SETLK, &loc
43a0: 6b 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 72  k)!=0 ){.      r
43b0: 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b  c = SQLITE_BUSY;
43c0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
43d0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
43e0: 3b 0a 20 20 20 20 20 20 69 64 2d 3e 70 4c 6f 63  ;.      id->pLoc
43f0: 6b 2d 3e 63 6e 74 20 3d 20 31 3b 0a 20 20 20 20  k->cnt = 1;.    
4400: 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 31    id->locked = 1
4410: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
4420: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
4430: 5f 42 55 53 59 3b 0a 20 20 7d 0a 20 20 73 71 6c  _BUSY;.  }.  sql
4440: 69 74 65 4f 73 4c 65 61 76 65 4d 75 74 65 78 28  iteOsLeaveMutex(
4450: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
4460: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49  #endif.#if OS_WI
4470: 4e 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66  N.  int rc;.  if
4480: 28 20 69 64 2d 3e 6c 6f 63 6b 65 64 3e 30 20 29  ( id->locked>0 )
4490: 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
44a0: 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  E_OK;.  }else{. 
44b0: 20 20 20 69 6e 74 20 6c 6b 20 3d 20 28 73 71 6c     int lk = (sql
44c0: 69 74 65 52 61 6e 64 6f 6d 49 6e 74 65 67 65 72  iteRandomInteger
44d0: 28 29 20 26 20 30 78 37 66 66 66 66 66 66 29 25  () & 0x7ffffff)%
44e0: 4d 58 5f 4c 4f 43 4b 42 59 54 45 20 2b 20 31 3b  MX_LOCKBYTE + 1;
44f0: 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20  .    int res;.  
4500: 20 20 69 66 28 20 28 72 65 73 20 3d 20 4c 6f 63    if( (res = Loc
4510: 6b 46 69 6c 65 28 69 64 2d 3e 68 2c 20 30 2c 20  kFile(id->h, 0, 
4520: 30 2c 20 31 2c 20 30 29 29 21 3d 30 20 29 7b 0a  0, 1, 0))!=0 ){.
4530: 20 20 20 20 20 20 55 6e 6c 6f 63 6b 46 69 6c 65        UnlockFile
4540: 28 69 64 2d 3e 68 2c 20 31 2c 20 30 2c 20 4d 58  (id->h, 1, 0, MX
4550: 5f 4c 4f 43 4b 42 59 54 45 2c 20 30 29 3b 0a 20  _LOCKBYTE, 0);. 
4560: 20 20 20 20 20 72 65 73 20 3d 20 4c 6f 63 6b 46       res = LockF
4570: 69 6c 65 28 69 64 2d 3e 68 2c 20 6c 6b 2c 20 30  ile(id->h, lk, 0
4580: 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 55  , 1, 0);.      U
4590: 6e 6c 6f 63 6b 46 69 6c 65 28 69 64 2d 3e 68 2c  nlockFile(id->h,
45a0: 20 30 2c 20 30 2c 20 31 2c 20 30 29 3b 0a 20 20   0, 0, 1, 0);.  
45b0: 20 20 7d 0a 20 20 20 20 69 66 28 20 72 65 73 20    }.    if( res 
45c0: 29 7b 0a 20 20 20 20 20 20 69 64 2d 3e 6c 6f 63  ){.      id->loc
45d0: 6b 65 64 20 3d 20 6c 6b 3b 0a 20 20 20 20 20 20  ked = lk;.      
45e0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
45f0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
4600: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53   rc = SQLITE_BUS
4610: 59 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  Y;.    }.  }.  r
4620: 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 69 66  eturn rc;.#endif
4630: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65  .}../*.** Change
4640: 20 74 68 65 20 6c 6f 63 6b 20 73 74 61 74 75 73   the lock status
4650: 20 74 6f 20 62 65 20 61 6e 20 65 78 63 6c 75 73   to be an exclus
4660: 69 76 65 20 6f 72 20 77 72 69 74 65 20 6c 6f 63  ive or write loc
4670: 6b 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 53 51  k.  Return.** SQ
4680: 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65  LITE_OK on succe
4690: 73 73 20 61 6e 64 20 53 51 4c 49 54 45 5f 42 55  ss and SQLITE_BU
46a0: 53 59 20 6f 6e 20 61 20 66 61 69 6c 75 72 65 2e  SY on a failure.
46b0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73  .*/.int sqliteOs
46c0: 57 72 69 74 65 4c 6f 63 6b 28 4f 73 46 69 6c 65  WriteLock(OsFile
46d0: 20 2a 69 64 29 7b 0a 23 69 66 20 4f 53 5f 55 4e   *id){.#if OS_UN
46e0: 49 58 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73  IX.  int rc;.  s
46f0: 71 6c 69 74 65 4f 73 45 6e 74 65 72 4d 75 74 65  qliteOsEnterMute
4700: 78 28 29 3b 0a 20 20 69 66 28 20 69 64 2d 3e 70  x();.  if( id->p
4710: 4c 6f 63 6b 2d 3e 63 6e 74 3d 3d 30 20 7c 7c 20  Lock->cnt==0 || 
4720: 28 69 64 2d 3e 70 4c 6f 63 6b 2d 3e 63 6e 74 3d  (id->pLock->cnt=
4730: 3d 31 20 26 26 20 69 64 2d 3e 6c 6f 63 6b 65 64  =1 && id->locked
4740: 3d 3d 31 29 20 29 7b 0a 20 20 20 20 73 74 72 75  ==1) ){.    stru
4750: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20  ct flock lock;. 
4760: 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d     lock.l_type =
4770: 20 46 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 6c 6f   F_WRLCK;.    lo
4780: 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45  ck.l_whence = SE
4790: 45 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f 63 6b  EK_SET;.    lock
47a0: 2e 6c 5f 73 74 61 72 74 20 3d 20 6c 6f 63 6b 2e  .l_start = lock.
47b0: 6c 5f 6c 65 6e 20 3d 20 30 4c 3b 0a 20 20 20 20  l_len = 0L;.    
47c0: 69 66 28 20 66 63 6e 74 6c 28 69 64 2d 3e 66 64  if( fcntl(id->fd
47d0: 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_SETLK, &lock
47e0: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63  )!=0 ){.      rc
47f0: 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a   = SQLITE_BUSY;.
4800: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
4810: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4820: 0a 20 20 20 20 20 20 69 64 2d 3e 70 4c 6f 63 6b  .      id->pLock
4830: 2d 3e 63 6e 74 20 3d 20 2d 31 3b 0a 20 20 20 20  ->cnt = -1;.    
4840: 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 31    id->locked = 1
4850: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
4860: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
4870: 5f 42 55 53 59 3b 0a 20 20 7d 0a 20 20 73 71 6c  _BUSY;.  }.  sql
4880: 69 74 65 4f 73 4c 65 61 76 65 4d 75 74 65 78 28  iteOsLeaveMutex(
4890: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
48a0: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49  #endif.#if OS_WI
48b0: 4e 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66  N.  int rc;.  if
48c0: 28 20 69 64 2d 3e 6c 6f 63 6b 65 64 3c 30 20 29  ( id->locked<0 )
48d0: 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
48e0: 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  E_OK;.  }else{. 
48f0: 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 20 20     int res;.    
4900: 69 66 28 20 28 72 65 73 20 3d 20 4c 6f 63 6b 46  if( (res = LockF
4910: 69 6c 65 28 69 64 2d 3e 68 2c 20 30 2c 20 30 2c  ile(id->h, 0, 0,
4920: 20 31 2c 20 30 29 29 21 3d 30 20 29 7b 0a 20 20   1, 0))!=0 ){.  
4930: 20 20 20 20 69 66 28 20 69 64 2d 3e 6c 6f 63 6b      if( id->lock
4940: 65 64 3d 3d 30 20 7c 7c 20 55 6e 6c 6f 63 6b 46  ed==0 || UnlockF
4950: 69 6c 65 28 69 64 2d 3e 68 2c 20 69 64 2d 3e 6c  ile(id->h, id->l
4960: 6f 63 6b 65 64 2c 20 30 2c 20 31 2c 20 30 29 20  ocked, 0, 1, 0) 
4970: 29 7b 0a 20 20 20 20 20 20 20 20 72 65 73 20 3d  ){.        res =
4980: 20 4c 6f 63 6b 46 69 6c 65 28 69 64 2d 3e 68 2c   LockFile(id->h,
4990: 20 31 2c 20 30 2c 20 4d 58 5f 4c 4f 43 4b 42 59   1, 0, MX_LOCKBY
49a0: 54 45 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 65  TE, 0);.      }e
49b0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 72 65 73  lse{.        res
49c0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20   = 0;.      }.  
49d0: 20 20 20 20 55 6e 6c 6f 63 6b 46 69 6c 65 28 69      UnlockFile(i
49e0: 64 2d 3e 68 2c 20 30 2c 20 30 2c 20 31 2c 20 30  d->h, 0, 0, 1, 0
49f0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
4a00: 20 72 65 73 20 29 7b 0a 20 20 20 20 20 20 69 64   res ){.      id
4a10: 2d 3e 6c 6f 63 6b 65 64 20 3d 20 2d 31 3b 0a 20  ->locked = -1;. 
4a20: 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45       rc = SQLITE
4a30: 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  _OK;.    }else{.
4a40: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54        rc = SQLIT
4a50: 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20  E_BUSY;.    }.  
4a60: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23  }.  return rc;.#
4a70: 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55  endif.}../*.** U
4a80: 6e 6c 6f 63 6b 20 74 68 65 20 67 69 76 65 6e 20  nlock the given 
4a90: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e  file descriptor.
4aa0: 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 64 65    If the file de
4ab0: 73 63 72 69 70 74 6f 72 20 77 61 73 0a 2a 2a 20  scriptor was.** 
4ac0: 6e 6f 74 20 70 72 65 76 69 6f 75 73 6c 79 20 6c  not previously l
4ad0: 6f 63 6b 65 64 2c 20 74 68 65 6e 20 74 68 69 73  ocked, then this
4ae0: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f   routine is a no
4af0: 2d 6f 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  -op..*/.int sqli
4b00: 74 65 4f 73 55 6e 6c 6f 63 6b 28 4f 73 46 69 6c  teOsUnlock(OsFil
4b10: 65 20 2a 69 64 29 7b 0a 23 69 66 20 4f 53 5f 55  e *id){.#if OS_U
4b20: 4e 49 58 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  NIX.  int rc;.  
4b30: 69 66 28 20 21 69 64 2d 3e 6c 6f 63 6b 65 64 20  if( !id->locked 
4b40: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
4b50: 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 4f 73 45 6e  OK;.  sqliteOsEn
4b60: 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 61 73  terMutex();.  as
4b70: 73 65 72 74 28 20 69 64 2d 3e 70 4c 6f 63 6b 2d  sert( id->pLock-
4b80: 3e 63 6e 74 21 3d 30 20 29 3b 0a 20 20 69 66 28  >cnt!=0 );.  if(
4b90: 20 69 64 2d 3e 70 4c 6f 63 6b 2d 3e 63 6e 74 3e   id->pLock->cnt>
4ba0: 31 20 29 7b 0a 20 20 20 20 69 64 2d 3e 70 4c 6f  1 ){.    id->pLo
4bb0: 63 6b 2d 3e 63 6e 74 2d 2d 3b 0a 20 20 20 20 72  ck->cnt--;.    r
4bc0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
4bd0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 72 75   }else{.    stru
4be0: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20  ct flock lock;. 
4bf0: 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d     lock.l_type =
4c00: 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20 20 6c 6f   F_UNLCK;.    lo
4c10: 63 6b 2e 6c 5f 77 68 65 6e 63 65 20 3d 20 53 45  ck.l_whence = SE
4c20: 45 4b 5f 53 45 54 3b 0a 20 20 20 20 6c 6f 63 6b  EK_SET;.    lock
4c30: 2e 6c 5f 73 74 61 72 74 20 3d 20 6c 6f 63 6b 2e  .l_start = lock.
4c40: 6c 5f 6c 65 6e 20 3d 20 30 4c 3b 0a 20 20 20 20  l_len = 0L;.    
4c50: 69 66 28 20 66 63 6e 74 6c 28 69 64 2d 3e 66 64  if( fcntl(id->fd
4c60: 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_SETLK, &lock
4c70: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63  )!=0 ){.      rc
4c80: 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a   = SQLITE_BUSY;.
4c90: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
4ca0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4cb0: 0a 20 20 20 20 20 20 69 64 2d 3e 70 4c 6f 63 6b  .      id->pLock
4cc0: 2d 3e 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 7d  ->cnt = 0;.    }
4cd0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 4c  .  }.  sqliteOsL
4ce0: 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20 20 69  eaveMutex();.  i
4cf0: 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 30 3b 0a 20  d->locked = 0;. 
4d00: 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64   return rc;.#end
4d10: 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20  if.#if OS_WIN.  
4d20: 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 69 64  int rc;.  if( id
4d30: 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 7b 0a 20  ->locked==0 ){. 
4d40: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
4d50: 4b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69  K;.  }else if( i
4d60: 64 2d 3e 6c 6f 63 6b 65 64 3c 30 20 29 7b 0a 20  d->locked<0 ){. 
4d70: 20 20 20 55 6e 6c 6f 63 6b 46 69 6c 65 28 69 64     UnlockFile(id
4d80: 2d 3e 68 2c 20 31 2c 20 30 2c 20 4d 58 5f 4c 4f  ->h, 1, 0, MX_LO
4d90: 43 4b 42 59 54 45 2c 20 30 29 3b 0a 20 20 20 20  CKBYTE, 0);.    
4da0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
4db0: 20 20 20 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d      id->locked =
4dc0: 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20   0;.  }else{.   
4dd0: 20 55 6e 6c 6f 63 6b 46 69 6c 65 28 69 64 2d 3e   UnlockFile(id->
4de0: 68 2c 20 69 64 2d 3e 6c 6f 63 6b 65 64 2c 20 30  h, id->locked, 0
4df0: 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 72 63 20  , 1, 0);.    rc 
4e00: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20  = SQLITE_OK;.   
4e10: 20 69 64 2d 3e 6c 6f 63 6b 65 64 20 3d 20 30 3b   id->locked = 0;
4e20: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
4e30: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a  ;.#endif.}../*.*
4e40: 2a 20 47 65 74 20 69 6e 66 6f 72 6d 61 74 69 6f  * Get informatio
4e50: 6e 20 74 6f 20 73 65 65 64 20 74 68 65 20 72 61  n to seed the ra
4e60: 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 67 65 6e 65  ndom number gene
4e70: 72 61 74 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71  rator..*/.int sq
4e80: 6c 69 74 65 4f 73 52 61 6e 64 6f 6d 53 65 65 64  liteOsRandomSeed
4e90: 28 63 68 61 72 20 2a 7a 42 75 66 29 7b 0a 20 20  (char *zBuf){.  
4ea0: 73 74 61 74 69 63 20 69 6e 74 20 6f 6e 63 65 20  static int once 
4eb0: 3d 20 31 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  = 1;.#ifdef SQLI
4ec0: 54 45 5f 54 45 53 54 0a 20 20 2f 2a 20 57 68 65  TE_TEST.  /* Whe
4ed0: 6e 20 74 65 73 74 69 6e 67 2c 20 61 6c 77 61 79  n testing, alway
4ee0: 73 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 72  s use the same r
4ef0: 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 73 65 71  andom number seq
4f00: 75 65 6e 63 65 2e 0a 20 20 2a 2a 20 54 68 69 73  uence..  ** This
4f10: 20 6d 61 6b 65 73 20 74 68 65 20 74 65 73 74 73   makes the tests
4f20: 20 72 65 70 65 61 74 61 62 6c 65 2e 0a 20 20 2a   repeatable..  *
4f30: 2f 0a 20 20 6d 65 6d 73 65 74 28 7a 42 75 66 2c  /.  memset(zBuf,
4f40: 20 30 2c 20 32 35 36 29 3b 0a 23 65 6e 64 69 66   0, 256);.#endif
4f50: 0a 23 69 66 20 4f 53 5f 55 4e 49 58 20 26 26 20  .#if OS_UNIX && 
4f60: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f  !defined(SQLITE_
4f70: 54 45 53 54 29 0a 20 20 69 6e 74 20 70 69 64 3b  TEST).  int pid;
4f80: 0a 20 20 74 69 6d 65 28 28 74 69 6d 65 5f 74 2a  .  time((time_t*
4f90: 29 7a 42 75 66 29 3b 0a 20 20 70 69 64 20 3d 20  )zBuf);.  pid = 
4fa0: 67 65 74 70 69 64 28 29 3b 0a 20 20 6d 65 6d 63  getpid();.  memc
4fb0: 70 79 28 26 7a 42 75 66 5b 73 69 7a 65 6f 66 28  py(&zBuf[sizeof(
4fc0: 74 69 6d 65 5f 74 29 5d 2c 20 26 70 69 64 2c 20  time_t)], &pid, 
4fd0: 73 69 7a 65 6f 66 28 70 69 64 29 29 3b 0a 23 65  sizeof(pid));.#e
4fe0: 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 20  ndif.#if OS_WIN 
4ff0: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49  && !defined(SQLI
5000: 54 45 5f 54 45 53 54 29 0a 20 20 47 65 74 53 79  TE_TEST).  GetSy
5010: 73 74 65 6d 54 69 6d 65 28 28 4c 50 53 59 53 54  stemTime((LPSYST
5020: 45 4d 54 49 4d 45 29 7a 42 75 66 29 3b 0a 23 65  EMTIME)zBuf);.#e
5030: 6e 64 69 66 0a 20 20 69 66 28 20 6f 6e 63 65 20  ndif.  if( once 
5040: 29 7b 0a 20 20 20 20 69 6e 74 20 73 65 65 64 3b  ){.    int seed;
5050: 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 73 65 65  .    memcpy(&see
5060: 64 2c 20 7a 42 75 66 2c 20 73 69 7a 65 6f 66 28  d, zBuf, sizeof(
5070: 73 65 65 64 29 29 3b 0a 20 20 20 20 73 72 61 6e  seed));.    sran
5080: 64 28 73 65 65 64 29 3b 0a 20 20 20 20 6f 6e 63  d(seed);.    onc
5090: 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74  e = 0;.  }.  ret
50a0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
50b0: 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66 6f  ../*.** Sleep fo
50c0: 72 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c 65  r a little while
50d0: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61 6d  .  Return the am
50e0: 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c 65  ount of time sle
50f0: 70 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  pt..*/.int sqlit
5100: 65 4f 73 53 6c 65 65 70 28 69 6e 74 20 6d 73 29  eOsSleep(int ms)
5110: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 23 69  {.#if OS_UNIX.#i
5120: 66 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f 55  f defined(HAVE_U
5130: 53 4c 45 45 50 29 20 26 26 20 48 41 56 45 5f 55  SLEEP) && HAVE_U
5140: 53 4c 45 45 50 0a 20 20 75 73 6c 65 65 70 28 6d  SLEEP.  usleep(m
5150: 73 2a 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72  s*1000);.  retur
5160: 6e 20 6d 73 3b 0a 23 65 6c 73 65 0a 20 20 73 6c  n ms;.#else.  sl
5170: 65 65 70 28 28 6d 73 2b 39 39 39 29 2f 31 30 30  eep((ms+999)/100
5180: 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 30 30  0);.  return 100
5190: 30 2a 28 28 6d 73 2b 39 39 39 29 2f 31 30 30 30  0*((ms+999)/1000
51a0: 29 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 69 66  );.#endif.#endif
51b0: 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 53 6c  .#if OS_WIN.  Sl
51c0: 65 65 70 28 6d 73 29 3b 0a 20 20 72 65 74 75 72  eep(ms);.  retur
51d0: 6e 20 6d 73 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a  n ms;.#endif.}..
51e0: 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 75 73 65  /*.** Macros use
51f0: 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77  d to determine w
5200: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 6f  hether or not to
5210: 20 75 73 65 20 74 68 72 65 61 64 73 2e 20 20 54   use threads.  T
5220: 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 55 4e 49  he.** SQLITE_UNI
5230: 58 5f 54 48 52 45 41 44 53 20 6d 61 63 72 6f 20  X_THREADS macro 
5240: 69 73 20 64 65 66 69 6e 65 64 20 69 66 20 77 65  is defined if we
5250: 20 61 72 65 20 73 79 6e 63 68 72 6f 6e 69 7a 69   are synchronizi
5260: 6e 67 20 66 6f 72 0a 2a 2a 20 50 6f 73 69 78 20  ng for.** Posix 
5270: 74 68 72 65 61 64 73 20 61 6e 64 20 53 51 4c 49  threads and SQLI
5280: 54 45 5f 57 33 32 5f 54 48 52 45 41 44 53 20 69  TE_W32_THREADS i
5290: 73 20 64 65 66 69 6e 65 64 20 69 66 20 77 65 20  s defined if we 
52a0: 61 72 65 0a 2a 2a 20 73 79 6e 63 68 72 6f 6e 69  are.** synchroni
52b0: 7a 69 6e 67 20 75 73 69 6e 67 20 57 69 6e 33 32  zing using Win32
52c0: 20 74 68 72 65 61 64 73 2e 0a 2a 2f 0a 23 69 66   threads..*/.#if
52d0: 20 4f 53 5f 55 4e 49 58 20 26 26 20 64 65 66 69   OS_UNIX && defi
52e0: 6e 65 64 28 54 48 52 45 41 44 53 41 46 45 29 20  ned(THREADSAFE) 
52f0: 26 26 20 54 48 52 45 41 44 53 41 46 45 0a 23 20  && THREADSAFE.# 
5300: 69 6e 63 6c 75 64 65 20 3c 70 74 68 72 65 61 64  include <pthread
5310: 2e 68 3e 0a 23 20 64 65 66 69 6e 65 20 53 51 4c  .h>.# define SQL
5320: 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53  ITE_UNIX_THREADS
5330: 20 31 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53   1.#endif.#if OS
5340: 5f 57 49 4e 20 26 26 20 64 65 66 69 6e 65 64 28  _WIN && defined(
5350: 54 48 52 45 41 44 53 41 46 45 29 20 26 26 20 54  THREADSAFE) && T
5360: 48 52 45 41 44 53 41 46 45 0a 23 20 64 65 66 69  HREADSAFE.# defi
5370: 6e 65 20 53 51 4c 49 54 45 5f 57 33 32 5f 54 48  ne SQLITE_W32_TH
5380: 52 45 41 44 53 20 31 0a 23 65 6e 64 69 66 0a 0a  READS 1.#endif..
5390: 2f 2a 0a 2a 2a 20 53 74 61 74 69 63 20 76 61 72  /*.** Static var
53a0: 69 61 62 6c 65 73 20 75 73 65 64 20 66 6f 72 20  iables used for 
53b0: 74 68 72 65 61 64 20 73 79 6e 63 68 72 6f 6e 69  thread synchroni
53c0: 7a 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63  zation.*/.static
53d0: 20 69 6e 74 20 69 6e 4d 75 74 65 78 20 3d 20 30   int inMutex = 0
53e0: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
53f0: 55 4e 49 58 5f 54 48 52 45 41 44 53 0a 20 20 73  UNIX_THREADS.  s
5400: 74 61 74 69 63 20 70 74 68 72 65 61 64 5f 6d 75  tatic pthread_mu
5410: 74 65 78 5f 74 20 6d 75 74 65 78 20 3d 20 50 54  tex_t mutex = PT
5420: 48 52 45 41 44 5f 4d 55 54 45 58 5f 49 4e 49 54  HREAD_MUTEX_INIT
5430: 49 41 4c 49 5a 45 52 3b 0a 23 65 6e 64 69 66 0a  IALIZER;.#endif.
5440: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 57 33  #ifdef SQLITE_W3
5450: 32 5f 54 48 52 45 41 44 53 0a 20 20 73 74 61 74  2_THREADS.  stat
5460: 69 63 20 43 52 49 54 49 43 41 4c 5f 53 45 43 54  ic CRITICAL_SECT
5470: 49 4f 4e 20 63 73 3b 0a 23 65 6e 64 69 66 0a 0a  ION cs;.#endif..
5480: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  /*.** The follow
5490: 69 6e 67 20 70 61 69 72 20 6f 66 20 72 6f 75 74  ing pair of rout
54a0: 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 20 6d 75  ine implement mu
54b0: 74 75 61 6c 20 65 78 63 6c 75 73 69 6f 6e 20 66  tual exclusion f
54c0: 6f 72 0a 2a 2a 20 6d 75 6c 74 69 2d 74 68 72 65  or.** multi-thre
54d0: 61 64 65 64 20 70 72 6f 63 65 73 73 65 73 2e 20  aded processes. 
54e0: 20 4f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 74   Only a single t
54f0: 68 72 65 61 64 20 69 73 20 61 6c 6c 6f 77 65 64  hread is allowed
5500: 20 74 6f 0a 2a 2a 20 65 78 65 63 75 74 65 64 20   to.** executed 
5510: 63 6f 64 65 20 74 68 61 74 20 69 73 20 73 75 72  code that is sur
5520: 72 6f 75 6e 64 65 64 20 62 79 20 45 6e 74 65 72  rounded by Enter
5530: 4d 75 74 65 78 28 29 20 61 6e 64 20 4c 65 61 76  Mutex() and Leav
5540: 65 4d 75 74 65 78 28 29 2e 0a 2a 2a 0a 2a 2a 20  eMutex()..**.** 
5550: 53 51 4c 69 74 65 20 75 73 65 73 20 6f 6e 6c 79  SQLite uses only
5560: 20 61 20 73 69 6e 67 6c 65 20 4d 75 74 65 78 2e   a single Mutex.
5570: 20 20 54 68 65 72 65 20 69 73 20 6e 6f 74 20 6d    There is not m
5580: 75 63 68 20 63 72 69 74 69 63 61 6c 0a 2a 2a 20  uch critical.** 
5590: 63 6f 64 65 20 61 6e 64 20 77 68 61 74 20 6c 69  code and what li
55a0: 74 74 6c 65 20 74 68 65 72 65 20 69 73 20 65 78  ttle there is ex
55b0: 65 63 75 74 65 73 20 71 75 69 63 6b 6c 79 20 61  ecutes quickly a
55c0: 6e 64 20 77 69 74 68 6f 75 74 20 62 6c 6f 63 6b  nd without block
55d0: 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ing..*/.void sql
55e0: 69 74 65 4f 73 45 6e 74 65 72 4d 75 74 65 78 28  iteOsEnterMutex(
55f0: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  ){.#ifdef SQLITE
5600: 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 0a 20 20  _UNIX_THREADS.  
5610: 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f  pthread_mutex_lo
5620: 63 6b 28 26 6d 75 74 65 78 29 3b 0a 23 65 6e 64  ck(&mutex);.#end
5630: 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  if.#ifdef SQLITE
5640: 5f 57 33 32 5f 54 48 52 45 41 44 53 0a 20 20 73  _W32_THREADS.  s
5650: 74 61 74 69 63 20 69 6e 74 20 69 73 49 6e 69 74  tatic int isInit
5660: 20 3d 20 30 3b 0a 20 20 77 68 69 6c 65 28 20 21   = 0;.  while( !
5670: 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 20 73 74  isInit ){.    st
5680: 61 74 69 63 20 6c 6f 6e 67 20 6c 6f 63 6b 20 3d  atic long lock =
5690: 20 30 3b 0a 20 20 20 20 69 66 28 20 49 6e 74 65   0;.    if( Inte
56a0: 72 6c 6f 63 6b 65 64 49 6e 63 72 65 6d 65 6e 74  rlockedIncrement
56b0: 28 26 6c 6f 63 6b 29 3d 3d 31 20 29 7b 0a 20 20  (&lock)==1 ){.  
56c0: 20 20 20 20 49 6e 69 74 69 61 6c 69 7a 65 43 72      InitializeCr
56d0: 69 74 69 63 61 6c 53 65 63 74 69 6f 6e 28 26 63  iticalSection(&c
56e0: 73 29 3b 0a 20 20 20 20 20 20 69 73 49 6e 69 74  s);.      isInit
56f0: 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b   = 1;.    }else{
5700: 0a 20 20 20 20 20 20 53 6c 65 65 70 28 31 29 3b  .      Sleep(1);
5710: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 45 6e 74  .    }.  }.  Ent
5720: 65 72 43 72 69 74 69 63 61 6c 53 65 63 74 69 6f  erCriticalSectio
5730: 6e 28 26 63 73 29 3b 0a 23 65 6e 64 69 66 0a 20  n(&cs);.#endif. 
5740: 20 61 73 73 65 72 74 28 20 21 69 6e 4d 75 74 65   assert( !inMute
5750: 78 20 29 3b 0a 20 20 69 6e 4d 75 74 65 78 20 3d  x );.  inMutex =
5760: 20 31 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74   1;.}.void sqlit
5770: 65 4f 73 4c 65 61 76 65 4d 75 74 65 78 28 29 7b  eOsLeaveMutex(){
5780: 0a 20 20 61 73 73 65 72 74 28 20 69 6e 4d 75 74  .  assert( inMut
5790: 65 78 20 29 3b 0a 20 20 69 6e 4d 75 74 65 78 20  ex );.  inMutex 
57a0: 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  = 0;.#ifdef SQLI
57b0: 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 0a  TE_UNIX_THREADS.
57c0: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
57d0: 75 6e 6c 6f 63 6b 28 26 6d 75 74 65 78 29 3b 0a  unlock(&mutex);.
57e0: 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51  #endif.#ifdef SQ
57f0: 4c 49 54 45 5f 57 33 32 5f 54 48 52 45 41 44 53  LITE_W32_THREADS
5800: 0a 20 20 4c 65 61 76 65 43 72 69 74 69 63 61 6c  .  LeaveCritical
5810: 53 65 63 74 69 6f 6e 28 26 63 73 29 3b 0a 23 65  Section(&cs);.#e
5820: 6e 64 69 66 0a 7d 0a                             ndif.}.