/ Hex Artifact Content
Login

Artifact f11eba69eea2ae2723f5ae1bdad8b1ef12e224b9:


0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32  /*.** 2004 May 2
0010: 32 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  2.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63   file contains c
0190: 6f 64 65 20 74 68 61 74 20 69 73 20 73 70 65 63  ode that is spec
01a0: 69 66 69 63 20 74 6f 20 55 6e 69 78 20 73 79 73  ific to Unix sys
01b0: 74 65 6d 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64  tems..*/.#includ
01c0: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
01d0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a  #include "os.h".
01e0: 23 69 66 20 4f 53 5f 55 4e 49 58 20 20 20 20 20  #if OS_UNIX     
01f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73           /* This
0200: 20 66 69 6c 65 20 69 73 20 75 73 65 64 20 6f 6e   file is used on
0210: 20 75 6e 69 78 20 6f 6e 6c 79 20 2a 2f 0a 2f 2a   unix only */./*
0220: 0a 2a 2a 20 54 68 65 73 65 20 23 64 65 66 69 6e  .** These #defin
0230: 65 73 20 73 68 6f 75 6c 64 20 65 6e 61 62 6c 65  es should enable
0240: 20 3e 32 47 42 20 66 69 6c 65 20 73 75 70 70 6f   >2GB file suppo
0250: 72 74 20 6f 6e 20 50 6f 73 69 78 20 69 66 20 74  rt on Posix if t
0260: 68 65 0a 2a 2a 20 75 6e 64 65 72 6c 79 69 6e 67  he.** underlying
0270: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
0280: 6d 20 73 75 70 70 6f 72 74 73 20 69 74 2e 20 20  m supports it.  
0290: 49 66 20 74 68 65 20 4f 53 20 6c 61 63 6b 73 0a  If the OS lacks.
02a0: 2a 2a 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75  ** large file su
02b0: 70 70 6f 72 74 2c 20 6f 72 20 69 66 20 74 68 65  pport, or if the
02c0: 20 4f 53 20 69 73 20 77 69 6e 64 6f 77 73 2c 20   OS is windows, 
02d0: 74 68 65 73 65 20 73 68 6f 75 6c 64 20 62 65 20  these should be 
02e0: 6e 6f 2d 6f 70 73 2e 0a 2a 2a 0a 2a 2a 20 4c 61  no-ops..**.** La
02f0: 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74  rge file support
0300: 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c 65 64   can be disabled
0310: 20 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51 4c   using the -DSQL
0320: 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 20  ITE_DISABLE_LFS 
0330: 73 77 69 74 63 68 0a 2a 2a 20 6f 6e 20 74 68 65  switch.** on the
0340: 20 63 6f 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 6e   compiler comman
0350: 64 20 6c 69 6e 65 2e 20 20 54 68 69 73 20 69 73  d line.  This is
0360: 20 6e 65 63 65 73 73 61 72 79 20 69 66 20 79 6f   necessary if yo
0370: 75 20 61 72 65 20 63 6f 6d 70 69 6c 69 6e 67 0a  u are compiling.
0380: 2a 2a 20 6f 6e 20 61 20 72 65 63 65 6e 74 20 6d  ** on a recent m
0390: 61 63 68 69 6e 65 20 28 65 78 3a 20 52 65 64 48  achine (ex: RedH
03a0: 61 74 20 37 2e 32 29 20 62 75 74 20 79 6f 75 20  at 7.2) but you 
03b0: 77 61 6e 74 20 79 6f 75 72 20 63 6f 64 65 20 74  want your code t
03c0: 6f 20 77 6f 72 6b 0a 2a 2a 20 6f 6e 20 61 6e 20  o work.** on an 
03d0: 6f 6c 64 65 72 20 6d 61 63 68 69 6e 65 20 28 65  older machine (e
03e0: 78 3a 20 52 65 64 48 61 74 20 36 2e 30 29 2e 20  x: RedHat 6.0). 
03f0: 20 49 66 20 79 6f 75 20 63 6f 6d 70 69 6c 65 20   If you compile 
0400: 6f 6e 20 52 65 64 48 61 74 20 37 2e 32 0a 2a 2a  on RedHat 7.2.**
0410: 20 77 69 74 68 6f 75 74 20 74 68 69 73 20 6f 70   without this op
0420: 74 69 6f 6e 2c 20 4c 46 53 20 69 73 20 65 6e 61  tion, LFS is ena
0430: 62 6c 65 2e 20 20 42 75 74 20 4c 46 53 20 64 6f  ble.  But LFS do
0440: 65 73 20 6e 6f 74 20 65 78 69 73 74 20 69 6e 20  es not exist in 
0450: 74 68 65 20 6b 65 72 6e 65 6c 0a 2a 2a 20 69 6e  the kernel.** in
0460: 20 52 65 64 48 61 74 20 36 2e 30 2c 20 73 6f 20   RedHat 6.0, so 
0470: 74 68 65 20 63 6f 64 65 20 77 6f 6e 27 74 20 77  the code won't w
0480: 6f 72 6b 2e 20 20 48 65 6e 63 65 2c 20 66 6f 72  ork.  Hence, for
0490: 20 6d 61 78 69 6d 75 6d 20 62 69 6e 61 72 79 0a   maximum binary.
04a0: 2a 2a 20 70 6f 72 74 61 62 69 6c 69 74 79 20 79  ** portability y
04b0: 6f 75 20 73 68 6f 75 6c 64 20 6f 6d 69 74 20 4c  ou should omit L
04c0: 46 53 2e 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c 61  FS..**.** Simila
04d0: 72 20 69 73 20 74 72 75 65 20 66 6f 72 20 4d 61  r is true for Ma
04e0: 63 4f 53 2e 20 20 4c 46 53 20 69 73 20 6f 6e 6c  cOS.  LFS is onl
04f0: 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 4d  y supported on M
0500: 61 63 4f 53 20 39 20 61 6e 64 20 6c 61 74 65 72  acOS 9 and later
0510: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c  ..*/.#ifndef SQL
0520: 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 0a  ITE_DISABLE_LFS.
0530: 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45 5f  # define _LARGE_
0540: 46 49 4c 45 20 20 20 20 20 20 20 31 0a 23 20 69  FILE       1.# i
0550: 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f 46 46 53  fndef _FILE_OFFS
0560: 45 54 5f 42 49 54 53 0a 23 20 20 20 64 65 66 69  ET_BITS.#   defi
0570: 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54 5f  ne _FILE_OFFSET_
0580: 42 49 54 53 20 36 34 0a 23 20 65 6e 64 69 66 0a  BITS 64.# endif.
0590: 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 45 46  # define _LARGEF
05a0: 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a 23 65 6e  ILE_SOURCE 1.#en
05b0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 73 74 61 6e 64  dif../*.** stand
05c0: 61 72 64 20 69 6e 63 6c 75 64 65 20 66 69 6c 65  ard include file
05d0: 73 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c  s..*/.#include <
05e0: 73 79 73 2f 74 79 70 65 73 2e 68 3e 0a 23 69 6e  sys/types.h>.#in
05f0: 63 6c 75 64 65 20 3c 73 79 73 2f 73 74 61 74 2e  clude <sys/stat.
0600: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 66 63 6e  h>.#include <fcn
0610: 74 6c 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c  tl.h>.#include <
0620: 75 6e 69 73 74 64 2e 68 3e 0a 23 69 6e 63 6c 75  unistd.h>.#inclu
0630: 64 65 20 3c 74 69 6d 65 2e 68 3e 0a 23 69 6e 63  de <time.h>.#inc
0640: 6c 75 64 65 20 3c 73 79 73 2f 74 69 6d 65 2e 68  lude <sys/time.h
0650: 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 65 72 72 6e  >.#include <errn
0660: 6f 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72  o.h>../*.** Macr
0670: 6f 73 20 75 73 65 64 20 74 6f 20 64 65 74 65 72  os used to deter
0680: 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20  mine whether or 
0690: 6e 6f 74 20 74 6f 20 75 73 65 20 74 68 72 65 61  not to use threa
06a0: 64 73 2e 20 20 54 68 65 0a 2a 2a 20 53 51 4c 49  ds.  The.** SQLI
06b0: 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 20  TE_UNIX_THREADS 
06c0: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
06d0: 20 69 66 20 77 65 20 61 72 65 20 73 79 6e 63 68   if we are synch
06e0: 72 6f 6e 69 7a 69 6e 67 20 66 6f 72 0a 2a 2a 20  ronizing for.** 
06f0: 50 6f 73 69 78 20 74 68 72 65 61 64 73 20 61 6e  Posix threads an
0700: 64 20 53 51 4c 49 54 45 5f 57 33 32 5f 54 48 52  d SQLITE_W32_THR
0710: 45 41 44 53 20 69 73 20 64 65 66 69 6e 65 64 20  EADS is defined 
0720: 69 66 20 77 65 20 61 72 65 0a 2a 2a 20 73 79 6e  if we are.** syn
0730: 63 68 72 6f 6e 69 7a 69 6e 67 20 75 73 69 6e 67  chronizing using
0740: 20 57 69 6e 33 32 20 74 68 72 65 61 64 73 2e 0a   Win32 threads..
0750: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 54  */.#if defined(T
0760: 48 52 45 41 44 53 41 46 45 29 20 26 26 20 54 48  HREADSAFE) && TH
0770: 52 45 41 44 53 41 46 45 0a 23 20 69 6e 63 6c 75  READSAFE.# inclu
0780: 64 65 20 3c 70 74 68 72 65 61 64 2e 68 3e 0a 23  de <pthread.h>.#
0790: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55   define SQLITE_U
07a0: 4e 49 58 5f 54 48 52 45 41 44 53 20 31 0a 23 65  NIX_THREADS 1.#e
07b0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 61  ndif../*.** Defa
07c0: 75 6c 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 20  ult permissions 
07d0: 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20  when creating a 
07e0: 6e 65 77 20 66 69 6c 65 0a 2a 2f 0a 23 69 66 6e  new file.*/.#ifn
07f0: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55  def SQLITE_DEFAU
0800: 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49 53 53 49  LT_FILE_PERMISSI
0810: 4f 4e 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c  ONS.# define SQL
0820: 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45  ITE_DEFAULT_FILE
0830: 5f 50 45 52 4d 49 53 53 49 4f 4e 53 20 30 36 34  _PERMISSIONS 064
0840: 34 0a 23 65 6e 64 69 66 0a 0a 0a 0a 2f 2a 0a 2a  4.#endif..../*.*
0850: 2a 20 54 68 65 20 75 6e 69 78 46 69 6c 65 20 73  * The unixFile s
0860: 74 72 75 63 74 75 72 65 20 69 73 20 73 75 62 63  tructure is subc
0870: 6c 61 73 73 20 6f 66 20 4f 73 46 69 6c 65 20 73  lass of OsFile s
0880: 70 65 63 69 66 69 63 20 66 6f 72 20 74 68 65 20  pecific for the 
0890: 75 6e 69 78 0a 2a 2a 20 70 72 6f 74 61 62 69 6c  unix.** protabil
08a0: 69 74 79 20 6c 61 79 65 72 2e 0a 2a 2f 0a 74 79  ity layer..*/.ty
08b0: 70 65 64 65 66 20 73 74 72 75 63 74 20 75 6e 69  pedef struct uni
08c0: 78 46 69 6c 65 20 75 6e 69 78 46 69 6c 65 3b 0a  xFile unixFile;.
08d0: 73 74 72 75 63 74 20 75 6e 69 78 46 69 6c 65 20  struct unixFile 
08e0: 7b 0a 20 20 49 6f 4d 65 74 68 6f 64 20 63 6f 6e  {.  IoMethod con
08f0: 73 74 20 2a 70 4d 65 74 68 6f 64 3b 20 20 2f 2a  st *pMethod;  /*
0900: 20 41 6c 77 61 79 73 20 74 68 65 20 66 69 72 73   Always the firs
0910: 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 73 74 72  t entry */.  str
0920: 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 70  uct openCnt *pOp
0930: 65 6e 3b 20 20 20 20 2f 2a 20 49 6e 66 6f 20 61  en;    /* Info a
0940: 62 6f 75 74 20 61 6c 6c 20 6f 70 65 6e 20 66 64  bout all open fd
0950: 27 73 20 6f 6e 20 74 68 69 73 20 69 6e 6f 64 65  's on this inode
0960: 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 6c 6f 63   */.  struct loc
0970: 6b 49 6e 66 6f 20 2a 70 4c 6f 63 6b 3b 20 20 20  kInfo *pLock;   
0980: 2f 2a 20 49 6e 66 6f 20 61 62 6f 75 74 20 6c 6f  /* Info about lo
0990: 63 6b 73 20 6f 6e 20 74 68 69 73 20 69 6e 6f 64  cks on this inod
09a0: 65 20 2a 2f 0a 20 20 69 6e 74 20 68 3b 20 20 20  e */.  int h;   
09b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
09c0: 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 64 65 73   /* The file des
09d0: 63 72 69 70 74 6f 72 20 2a 2f 0a 20 20 75 6e 73  criptor */.  uns
09e0: 69 67 6e 65 64 20 63 68 61 72 20 6c 6f 63 6b 74  igned char lockt
09f0: 79 70 65 3b 20 20 20 2f 2a 20 54 68 65 20 74 79  ype;   /* The ty
0a00: 70 65 20 6f 66 20 6c 6f 63 6b 20 68 65 6c 64 20  pe of lock held 
0a10: 6f 6e 20 74 68 69 73 20 66 64 20 2a 2f 0a 20 20  on this fd */.  
0a20: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 69 73  unsigned char is
0a30: 4f 70 65 6e 3b 20 20 20 20 20 2f 2a 20 54 72 75  Open;     /* Tru
0a40: 65 20 69 66 20 6e 65 65 64 73 20 74 6f 20 62 65  e if needs to be
0a50: 20 63 6c 6f 73 65 64 20 2a 2f 0a 20 20 75 6e 73   closed */.  uns
0a60: 69 67 6e 65 64 20 63 68 61 72 20 66 75 6c 6c 53  igned char fullS
0a70: 79 6e 63 3b 20 20 20 2f 2a 20 55 73 65 20 46 5f  ync;   /* Use F_
0a80: 46 55 4c 4c 53 59 4e 43 20 69 66 20 61 76 61 69  FULLSYNC if avai
0a90: 6c 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 64  lable */.  int d
0aa0: 69 72 66 64 3b 20 20 20 20 20 20 20 20 20 20 20  irfd;           
0ab0: 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73       /* File des
0ac0: 63 72 69 70 74 6f 72 20 66 6f 72 20 74 68 65 20  criptor for the 
0ad0: 64 69 72 65 63 74 6f 72 79 20 2a 2f 0a 23 69 66  directory */.#if
0ae0: 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f  def SQLITE_UNIX_
0af0: 54 48 52 45 41 44 53 0a 20 20 70 74 68 72 65 61  THREADS.  pthrea
0b00: 64 5f 74 20 74 69 64 3b 20 20 20 20 20 20 20 20  d_t tid;        
0b10: 20 20 20 20 2f 2a 20 54 68 65 20 74 68 72 65 61      /* The threa
0b20: 64 20 61 75 74 68 6f 72 69 7a 65 64 20 74 6f 20  d authorized to 
0b30: 75 73 65 20 74 68 69 73 20 4f 73 46 69 6c 65 20  use this OsFile 
0b40: 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 0a 2f  */.#endif.};.../
0b50: 2a 0a 2a 2a 20 44 6f 20 6e 6f 74 20 69 6e 63 6c  *.** Do not incl
0b60: 75 64 65 20 61 6e 79 20 6f 66 20 74 68 65 20 46  ude any of the F
0b70: 69 6c 65 20 49 2f 4f 20 69 6e 74 65 72 66 61 63  ile I/O interfac
0b80: 65 20 70 72 6f 63 65 64 75 72 65 73 20 69 66 20  e procedures if 
0b90: 74 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d  the.** SQLITE_OM
0ba0: 49 54 5f 44 49 53 4b 49 4f 20 6d 61 63 72 6f 20  IT_DISKIO macro 
0bb0: 69 73 20 64 65 66 69 6e 65 64 20 28 69 6e 64 69  is defined (indi
0bc0: 63 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 72  cating that ther
0bd0: 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 77 69  e database.** wi
0be0: 6c 6c 20 62 65 20 69 6e 2d 6d 65 6d 6f 72 79 20  ll be in-memory 
0bf0: 6f 6e 6c 79 29 0a 2a 2f 0a 23 69 66 6e 64 65 66  only).*/.#ifndef
0c00: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53   SQLITE_OMIT_DIS
0c10: 4b 49 4f 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 69  KIO.../*.** Defi
0c20: 6e 65 20 76 61 72 69 6f 75 73 20 6d 61 63 72 6f  ne various macro
0c30: 73 20 74 68 61 74 20 61 72 65 20 6d 69 73 73 69  s that are missi
0c40: 6e 67 20 66 72 6f 6d 20 73 6f 6d 65 20 73 79 73  ng from some sys
0c50: 74 65 6d 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66  tems..*/.#ifndef
0c60: 20 4f 5f 4c 41 52 47 45 46 49 4c 45 0a 23 20 64   O_LARGEFILE.# d
0c70: 65 66 69 6e 65 20 4f 5f 4c 41 52 47 45 46 49 4c  efine O_LARGEFIL
0c80: 45 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 64 65  E 0.#endif.#ifde
0c90: 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45  f SQLITE_DISABLE
0ca0: 5f 4c 46 53 0a 23 20 75 6e 64 65 66 20 4f 5f 4c  _LFS.# undef O_L
0cb0: 41 52 47 45 46 49 4c 45 0a 23 20 64 65 66 69 6e  ARGEFILE.# defin
0cc0: 65 20 4f 5f 4c 41 52 47 45 46 49 4c 45 20 30 0a  e O_LARGEFILE 0.
0cd0: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 4f  #endif.#ifndef O
0ce0: 5f 4e 4f 46 4f 4c 4c 4f 57 0a 23 20 64 65 66 69  _NOFOLLOW.# defi
0cf0: 6e 65 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 20 30 0a  ne O_NOFOLLOW 0.
0d00: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 4f  #endif.#ifndef O
0d10: 5f 42 49 4e 41 52 59 0a 23 20 64 65 66 69 6e 65  _BINARY.# define
0d20: 20 4f 5f 42 49 4e 41 52 59 20 30 0a 23 65 6e 64   O_BINARY 0.#end
0d30: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 44 4a  if../*.** The DJ
0d40: 47 50 50 20 63 6f 6d 70 69 6c 65 72 20 65 6e 76  GPP compiler env
0d50: 69 72 6f 6e 6d 65 6e 74 20 6c 6f 6f 6b 73 20 6d  ironment looks m
0d60: 6f 73 74 6c 79 20 6c 69 6b 65 20 55 6e 69 78 2c  ostly like Unix,
0d70: 20 62 75 74 20 69 74 0a 2a 2a 20 6c 61 63 6b 73   but it.** lacks
0d80: 20 74 68 65 20 66 63 6e 74 6c 28 29 20 73 79 73   the fcntl() sys
0d90: 74 65 6d 20 63 61 6c 6c 2e 20 20 53 6f 20 72 65  tem call.  So re
0da0: 64 65 66 69 6e 65 20 66 63 6e 74 6c 28 29 20 74  define fcntl() t
0db0: 6f 20 62 65 20 73 6f 6d 65 74 68 69 6e 67 0a 2a  o be something.*
0dc0: 2a 20 74 68 61 74 20 61 6c 77 61 79 73 20 73 75  * that always su
0dd0: 63 63 65 65 64 73 2e 20 20 54 68 69 73 20 6d 65  cceeds.  This me
0de0: 61 6e 73 20 74 68 61 74 20 6c 6f 63 6b 69 6e 67  ans that locking
0df0: 20 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20   does not occur 
0e00: 75 6e 64 65 72 0a 2a 2a 20 44 4a 47 50 50 2e 20  under.** DJGPP. 
0e10: 20 42 75 74 20 69 74 27 73 20 44 4f 53 20 2d 20   But it's DOS - 
0e20: 77 68 61 74 20 64 69 64 20 79 6f 75 20 65 78 70  what did you exp
0e30: 65 63 74 3f 0a 2a 2f 0a 23 69 66 64 65 66 20 5f  ect?.*/.#ifdef _
0e40: 5f 44 4a 47 50 50 5f 5f 0a 23 20 64 65 66 69 6e  _DJGPP__.# defin
0e50: 65 20 66 63 6e 74 6c 28 41 2c 42 2c 43 29 20 30  e fcntl(A,B,C) 0
0e60: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49  .#endif../*.** I
0e70: 6e 63 6c 75 64 65 20 63 6f 64 65 20 74 68 61 74  nclude code that
0e80: 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c   is common to al
0e90: 6c 20 6f 73 5f 2a 2e 63 20 66 69 6c 65 73 0a 2a  l os_*.c files.*
0ea0: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 5f 63  /.#include "os_c
0eb0: 6f 6d 6d 6f 6e 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20  ommon.h"../*.** 
0ec0: 54 68 65 20 74 68 72 65 61 64 69 64 20 6d 61 63  The threadid mac
0ed0: 72 6f 20 72 65 73 6f 6c 76 65 73 20 74 6f 20 74  ro resolves to t
0ee0: 68 65 20 74 68 72 65 61 64 2d 69 64 20 6f 72 20  he thread-id or 
0ef0: 74 6f 20 30 2e 20 20 55 73 65 64 20 66 6f 72 0a  to 0.  Used for.
0f00: 2a 2a 20 74 65 73 74 69 6e 67 20 61 6e 64 20 64  ** testing and d
0f10: 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a  ebugging only..*
0f20: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
0f30: 55 4e 49 58 5f 54 48 52 45 41 44 53 0a 23 64 65  UNIX_THREADS.#de
0f40: 66 69 6e 65 20 74 68 72 65 61 64 69 64 20 70 74  fine threadid pt
0f50: 68 72 65 61 64 5f 73 65 6c 66 28 29 0a 23 65 6c  hread_self().#el
0f60: 73 65 0a 23 64 65 66 69 6e 65 20 74 68 72 65 61  se.#define threa
0f70: 64 69 64 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a  did 0.#endif../*
0f80: 0a 2a 2a 20 53 65 74 20 6f 72 20 63 68 65 63 6b  .** Set or check
0f90: 20 74 68 65 20 4f 73 46 69 6c 65 2e 74 69 64 20   the OsFile.tid 
0fa0: 66 69 65 6c 64 2e 20 20 54 68 69 73 20 66 69 65  field.  This fie
0fb0: 6c 64 20 69 73 20 73 65 74 20 77 68 65 6e 20 61  ld is set when a
0fc0: 6e 20 4f 73 46 69 6c 65 0a 2a 2a 20 69 73 20 66  n OsFile.** is f
0fd0: 69 72 73 74 20 6f 70 65 6e 65 64 2e 20 20 41 6c  irst opened.  Al
0fe0: 6c 20 73 75 62 73 65 71 75 65 6e 74 20 75 73 65  l subsequent use
0ff0: 73 20 6f 66 20 74 68 65 20 4f 73 46 69 6c 65 20  s of the OsFile 
1000: 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 0a  verify that the.
1010: 2a 2a 20 73 61 6d 65 20 74 68 72 65 61 64 20 69  ** same thread i
1020: 73 20 6f 70 65 72 61 74 69 6e 67 20 6f 6e 20 74  s operating on t
1030: 68 65 20 4f 73 46 69 6c 65 2e 20 20 53 6f 6d 65  he OsFile.  Some
1040: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
1050: 6d 73 20 64 6f 0a 2a 2a 20 6e 6f 74 20 61 6c 6c  ms do.** not all
1060: 6f 77 20 6c 6f 63 6b 73 20 74 6f 20 62 65 20 6f  ow locks to be o
1070: 76 65 72 72 69 64 64 65 6e 20 62 79 20 6f 74 68  verridden by oth
1080: 65 72 20 74 68 72 65 61 64 73 20 61 6e 64 20 74  er threads and t
1090: 68 61 74 20 72 65 73 74 72 69 63 74 69 6f 6e 0a  hat restriction.
10a0: 2a 2a 20 6d 65 61 6e 73 20 74 68 61 74 20 73 71  ** means that sq
10b0: 6c 69 74 65 33 2a 20 64 61 74 61 62 61 73 65 20  lite3* database 
10c0: 68 61 6e 64 6c 65 73 20 63 61 6e 6e 6f 74 20 62  handles cannot b
10d0: 65 20 6d 6f 76 65 64 20 66 72 6f 6d 20 6f 6e 65  e moved from one
10e0: 20 74 68 72 65 61 64 0a 2a 2a 20 74 6f 20 61 6e   thread.** to an
10f0: 6f 74 68 65 72 2e 20 20 54 68 69 73 20 6c 6f 67  other.  This log
1100: 69 63 20 6d 61 6b 65 73 20 73 75 72 65 20 61 20  ic makes sure a 
1110: 75 73 65 72 20 64 6f 65 73 20 6e 6f 74 20 74 72  user does not tr
1120: 79 20 74 6f 20 64 6f 20 74 68 61 74 0a 2a 2a 20  y to do that.** 
1130: 62 79 20 6d 69 73 74 61 6b 65 2e 0a 2a 2f 0a 23  by mistake..*/.#
1140: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54  if defined(SQLIT
1150: 45 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 29 20  E_UNIX_THREADS) 
1160: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49  && !defined(SQLI
1170: 54 45 5f 41 4c 4c 4f 57 5f 58 54 48 52 45 41 44  TE_ALLOW_XTHREAD
1180: 5f 43 4f 4e 4e 45 43 54 49 4f 4e 53 29 0a 23 20  _CONNECTIONS).# 
1190: 64 65 66 69 6e 65 20 53 45 54 5f 54 48 52 45 41  define SET_THREA
11a0: 44 49 44 28 58 29 20 20 20 28 58 29 2d 3e 74 69  DID(X)   (X)->ti
11b0: 64 20 3d 20 70 74 68 72 65 61 64 5f 73 65 6c 66  d = pthread_self
11c0: 28 29 0a 23 20 64 65 66 69 6e 65 20 43 48 45 43  ().# define CHEC
11d0: 4b 5f 54 48 52 45 41 44 49 44 28 58 29 20 28 21  K_THREADID(X) (!
11e0: 70 74 68 72 65 61 64 5f 65 71 75 61 6c 28 28 58  pthread_equal((X
11f0: 29 2d 3e 74 69 64 2c 20 70 74 68 72 65 61 64 5f  )->tid, pthread_
1200: 73 65 6c 66 28 29 29 29 0a 23 65 6c 73 65 0a 23  self())).#else.#
1210: 20 64 65 66 69 6e 65 20 53 45 54 5f 54 48 52 45   define SET_THRE
1220: 41 44 49 44 28 58 29 0a 23 20 64 65 66 69 6e 65  ADID(X).# define
1230: 20 43 48 45 43 4b 5f 54 48 52 45 41 44 49 44 28   CHECK_THREADID(
1240: 58 29 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  X) 0.#endif../*.
1250: 2a 2a 20 48 65 72 65 20 69 73 20 74 68 65 20 64  ** Here is the d
1260: 69 72 74 20 6f 6e 20 50 4f 53 49 58 20 61 64 76  irt on POSIX adv
1270: 69 73 6f 72 79 20 6c 6f 63 6b 73 3a 20 20 41 4e  isory locks:  AN
1280: 53 49 20 53 54 44 20 31 30 30 33 2e 31 20 28 31  SI STD 1003.1 (1
1290: 39 39 36 29 0a 2a 2a 20 73 65 63 74 69 6f 6e 20  996).** section 
12a0: 36 2e 35 2e 32 2e 32 20 6c 69 6e 65 73 20 34 38  6.5.2.2 lines 48
12b0: 33 20 74 68 72 6f 75 67 68 20 34 39 30 20 73 70  3 through 490 sp
12c0: 65 63 69 66 79 20 74 68 61 74 20 77 68 65 6e 20  ecify that when 
12d0: 61 20 70 72 6f 63 65 73 73 0a 2a 2a 20 73 65 74  a process.** set
12e0: 73 20 6f 72 20 63 6c 65 61 72 73 20 61 20 6c 6f  s or clears a lo
12f0: 63 6b 2c 20 74 68 61 74 20 6f 70 65 72 61 74 69  ck, that operati
1300: 6f 6e 20 6f 76 65 72 72 69 64 65 73 20 61 6e 79  on overrides any
1310: 20 70 72 69 6f 72 20 6c 6f 63 6b 73 20 73 65 74   prior locks set
1320: 0a 2a 2a 20 62 79 20 74 68 65 20 73 61 6d 65 20  .** by the same 
1330: 70 72 6f 63 65 73 73 2e 20 20 49 74 20 64 6f 65  process.  It doe
1340: 73 20 6e 6f 74 20 65 78 70 6c 69 63 69 74 6c 79  s not explicitly
1350: 20 73 61 79 20 73 6f 2c 20 62 75 74 20 74 68 69   say so, but thi
1360: 73 20 69 6d 70 6c 69 65 73 0a 2a 2a 20 74 68 61  s implies.** tha
1370: 74 20 69 74 20 6f 76 65 72 72 69 64 65 73 20 6c  t it overrides l
1380: 6f 63 6b 73 20 73 65 74 20 62 79 20 74 68 65 20  ocks set by the 
1390: 73 61 6d 65 20 70 72 6f 63 65 73 73 20 75 73 69  same process usi
13a0: 6e 67 20 61 20 64 69 66 66 65 72 65 6e 74 0a 2a  ng a different.*
13b0: 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  * file descripto
13c0: 72 2e 20 20 43 6f 6e 73 69 64 65 72 20 74 68 69  r.  Consider thi
13d0: 73 20 74 65 73 74 20 63 61 73 65 3a 0a 2a 2a 0a  s test case:.**.
13e0: 2a 2a 20 20 20 20 20 20 20 69 6e 74 20 66 64 31  **       int fd1
13f0: 20 3d 20 6f 70 65 6e 28 22 2e 2f 66 69 6c 65 31   = open("./file1
1400: 22 2c 20 4f 5f 52 44 57 52 7c 4f 5f 43 52 45 41  ", O_RDWR|O_CREA
1410: 54 2c 20 30 36 34 34 29 3b 0a 2a 2a 20 20 20 20  T, 0644);.**    
1420: 20 20 20 69 6e 74 20 66 64 32 20 3d 20 6f 70 65     int fd2 = ope
1430: 6e 28 22 2e 2f 66 69 6c 65 32 22 2c 20 4f 5f 52  n("./file2", O_R
1440: 44 57 52 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34  DWR|O_CREAT, 064
1450: 34 29 3b 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73  4);.**.** Suppos
1460: 65 20 2e 2f 66 69 6c 65 31 20 61 6e 64 20 2e 2f  e ./file1 and ./
1470: 66 69 6c 65 32 20 61 72 65 20 72 65 61 6c 6c 79  file2 are really
1480: 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 28   the same file (
1490: 62 65 63 61 75 73 65 0a 2a 2a 20 6f 6e 65 20 69  because.** one i
14a0: 73 20 61 20 68 61 72 64 20 6f 72 20 73 79 6d 62  s a hard or symb
14b0: 6f 6c 69 63 20 6c 69 6e 6b 20 74 6f 20 74 68 65  olic link to the
14c0: 20 6f 74 68 65 72 29 20 74 68 65 6e 20 69 66 20   other) then if 
14d0: 79 6f 75 20 73 65 74 0a 2a 2a 20 61 6e 20 65 78  you set.** an ex
14e0: 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20  clusive lock on 
14f0: 66 64 31 2c 20 74 68 65 6e 20 74 72 79 20 74 6f  fd1, then try to
1500: 20 67 65 74 20 61 6e 20 65 78 63 6c 75 73 69 76   get an exclusiv
1510: 65 20 6c 6f 63 6b 0a 2a 2a 20 6f 6e 20 66 64 32  e lock.** on fd2
1520: 2c 20 69 74 20 77 6f 72 6b 73 2e 20 20 49 20 77  , it works.  I w
1530: 6f 75 6c 64 20 68 61 76 65 20 65 78 70 65 63 74  ould have expect
1540: 65 64 20 74 68 65 20 73 65 63 6f 6e 64 20 6c 6f  ed the second lo
1550: 63 6b 20 74 6f 0a 2a 2a 20 66 61 69 6c 20 73 69  ck to.** fail si
1560: 6e 63 65 20 74 68 65 72 65 20 77 61 73 20 61 6c  nce there was al
1570: 72 65 61 64 79 20 61 20 6c 6f 63 6b 20 6f 6e 20  ready a lock on 
1580: 74 68 65 20 66 69 6c 65 20 64 75 65 20 74 6f 20  the file due to 
1590: 66 64 31 2e 0a 2a 2a 20 42 75 74 20 6e 6f 74 20  fd1..** But not 
15a0: 73 6f 2e 20 20 53 69 6e 63 65 20 62 6f 74 68 20  so.  Since both 
15b0: 6c 6f 63 6b 73 20 63 61 6d 65 20 66 72 6f 6d 20  locks came from 
15c0: 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73  the same process
15d0: 2c 20 74 68 65 0a 2a 2a 20 73 65 63 6f 6e 64 20  , the.** second 
15e0: 6f 76 65 72 72 69 64 65 73 20 74 68 65 20 66 69  overrides the fi
15f0: 72 73 74 2c 20 65 76 65 6e 20 74 68 6f 75 67 68  rst, even though
1600: 20 74 68 65 79 20 77 65 72 65 20 6f 6e 20 64 69   they were on di
1610: 66 66 65 72 65 6e 74 0a 2a 2a 20 66 69 6c 65 20  fferent.** file 
1620: 64 65 73 63 72 69 70 74 6f 72 73 20 6f 70 65 6e  descriptors open
1630: 65 64 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 20  ed on different 
1640: 66 69 6c 65 20 6e 61 6d 65 73 2e 0a 2a 2a 0a 2a  file names..**.*
1650: 2a 20 42 75 6d 6d 65 72 2e 20 20 49 66 20 79 6f  * Bummer.  If yo
1660: 75 20 61 73 6b 20 6d 65 2c 20 74 68 69 73 20 69  u ask me, this i
1670: 73 20 62 72 6f 6b 65 6e 2e 20 20 42 61 64 6c 79  s broken.  Badly
1680: 20 62 72 6f 6b 65 6e 2e 20 20 49 74 20 6d 65 61   broken.  It mea
1690: 6e 73 0a 2a 2a 20 74 68 61 74 20 77 65 20 63 61  ns.** that we ca
16a0: 6e 6e 6f 74 20 75 73 65 20 50 4f 53 49 58 20 6c  nnot use POSIX l
16b0: 6f 63 6b 73 20 74 6f 20 73 79 6e 63 68 72 6f 6e  ocks to synchron
16c0: 69 7a 65 20 66 69 6c 65 20 61 63 63 65 73 73 20  ize file access 
16d0: 61 6d 6f 6e 67 0a 2a 2a 20 63 6f 6d 70 65 74 69  among.** competi
16e0: 6e 67 20 74 68 72 65 61 64 73 20 6f 66 20 74 68  ng threads of th
16f0: 65 20 73 61 6d 65 20 70 72 6f 63 65 73 73 2e 20  e same process. 
1700: 20 50 4f 53 49 58 20 6c 6f 63 6b 73 20 77 69 6c   POSIX locks wil
1710: 6c 20 77 6f 72 6b 20 66 69 6e 65 0a 2a 2a 20 74  l work fine.** t
1720: 6f 20 73 79 6e 63 68 72 6f 6e 69 7a 65 20 61 63  o synchronize ac
1730: 63 65 73 73 20 66 6f 72 20 74 68 72 65 61 64 73  cess for threads
1740: 20 69 6e 20 73 65 70 61 72 61 74 65 20 70 72 6f   in separate pro
1750: 63 65 73 73 65 73 2c 20 62 75 74 20 6e 6f 74 0a  cesses, but not.
1760: 2a 2a 20 74 68 72 65 61 64 73 20 77 69 74 68 69  ** threads withi
1770: 6e 20 74 68 65 20 73 61 6d 65 20 70 72 6f 63 65  n the same proce
1780: 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72  ss..**.** To wor
1790: 6b 20 61 72 6f 75 6e 64 20 74 68 65 20 70 72 6f  k around the pro
17a0: 62 6c 65 6d 2c 20 53 51 4c 69 74 65 20 68 61 73  blem, SQLite has
17b0: 20 74 6f 20 6d 61 6e 61 67 65 20 66 69 6c 65 20   to manage file 
17c0: 6c 6f 63 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79  locks internally
17d0: 0a 2a 2a 20 6f 6e 20 69 74 73 20 6f 77 6e 2e 20  .** on its own. 
17e0: 20 57 68 65 6e 65 76 65 72 20 61 20 6e 65 77 20   Whenever a new 
17f0: 64 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e  database is open
1800: 65 64 2c 20 77 65 20 68 61 76 65 20 74 6f 20 66  ed, we have to f
1810: 69 6e 64 20 74 68 65 0a 2a 2a 20 73 70 65 63 69  ind the.** speci
1820: 66 69 63 20 69 6e 6f 64 65 20 6f 66 20 74 68 65  fic inode of the
1830: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28   database file (
1840: 74 68 65 20 69 6e 6f 64 65 20 69 73 20 64 65 74  the inode is det
1850: 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 0a 2a  ermined by the.*
1860: 2a 20 73 74 5f 64 65 76 20 61 6e 64 20 73 74 5f  * st_dev and st_
1870: 69 6e 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 68  ino fields of th
1880: 65 20 73 74 61 74 20 73 74 72 75 63 74 75 72 65  e stat structure
1890: 20 74 68 61 74 20 66 73 74 61 74 28 29 20 66 69   that fstat() fi
18a0: 6c 6c 73 20 69 6e 29 0a 2a 2a 20 61 6e 64 20 63  lls in).** and c
18b0: 68 65 63 6b 20 66 6f 72 20 6c 6f 63 6b 73 20 61  heck for locks a
18c0: 6c 72 65 61 64 79 20 65 78 69 73 74 69 6e 67 20  lready existing 
18d0: 6f 6e 20 74 68 61 74 20 69 6e 6f 64 65 2e 20 20  on that inode.  
18e0: 57 68 65 6e 20 6c 6f 63 6b 73 20 61 72 65 0a 2a  When locks are.*
18f0: 2a 20 63 72 65 61 74 65 64 20 6f 72 20 72 65 6d  * created or rem
1900: 6f 76 65 64 2c 20 77 65 20 68 61 76 65 20 74 6f  oved, we have to
1910: 20 6c 6f 6f 6b 20 61 74 20 6f 75 72 20 6f 77 6e   look at our own
1920: 20 69 6e 74 65 72 6e 61 6c 20 72 65 63 6f 72 64   internal record
1930: 20 6f 66 20 74 68 65 0a 2a 2a 20 6c 6f 63 6b 73   of the.** locks
1940: 20 74 6f 20 73 65 65 20 69 66 20 61 6e 6f 74 68   to see if anoth
1950: 65 72 20 74 68 72 65 61 64 20 68 61 73 20 70 72  er thread has pr
1960: 65 76 69 6f 75 73 6c 79 20 73 65 74 20 61 20 6c  eviously set a l
1970: 6f 63 6b 20 6f 6e 20 74 68 61 74 20 73 61 6d 65  ock on that same
1980: 0a 2a 2a 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a  .** inode..**.**
1990: 20 54 68 65 20 4f 73 46 69 6c 65 20 73 74 72 75   The OsFile stru
19a0: 63 74 75 72 65 20 66 6f 72 20 50 4f 53 49 58 20  cture for POSIX 
19b0: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6a 75 73  is no longer jus
19c0: 74 20 61 6e 20 69 6e 74 65 67 65 72 20 66 69 6c  t an integer fil
19d0: 65 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 2e  e.** descriptor.
19e0: 20 20 49 74 20 69 73 20 6e 6f 77 20 61 20 73 74    It is now a st
19f0: 72 75 63 74 75 72 65 20 74 68 61 74 20 68 6f 6c  ructure that hol
1a00: 64 73 20 74 68 65 20 69 6e 74 65 67 65 72 20 66  ds the integer f
1a10: 69 6c 65 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f  ile.** descripto
1a20: 72 20 61 6e 64 20 61 20 70 6f 69 6e 74 65 72 20  r and a pointer 
1a30: 74 6f 20 61 20 73 74 72 75 63 74 75 72 65 20 74  to a structure t
1a40: 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68  hat describes th
1a50: 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 6c 6f  e internal.** lo
1a60: 63 6b 73 20 6f 6e 20 74 68 65 20 63 6f 72 72 65  cks on the corre
1a70: 73 70 6f 6e 64 69 6e 67 20 69 6e 6f 64 65 2e 20  sponding inode. 
1a80: 20 54 68 65 72 65 20 69 73 20 6f 6e 65 20 6c 6f   There is one lo
1a90: 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72 65 0a  cking structure.
1aa0: 2a 2a 20 70 65 72 20 69 6e 6f 64 65 2c 20 73 6f  ** per inode, so
1ab0: 20 69 66 20 74 68 65 20 73 61 6d 65 20 69 6e 6f   if the same ino
1ac0: 64 65 20 69 73 20 6f 70 65 6e 65 64 20 74 77 69  de is opened twi
1ad0: 63 65 2c 20 62 6f 74 68 20 4f 73 46 69 6c 65 20  ce, both OsFile 
1ae0: 73 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 70 6f  structures.** po
1af0: 69 6e 74 20 74 6f 20 74 68 65 20 73 61 6d 65 20  int to the same 
1b00: 6c 6f 63 6b 69 6e 67 20 73 74 72 75 63 74 75 72  locking structur
1b10: 65 2e 20 20 54 68 65 20 6c 6f 63 6b 69 6e 67 20  e.  The locking 
1b20: 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 0a  structure keeps.
1b30: 2a 2a 20 61 20 72 65 66 65 72 65 6e 63 65 20 63  ** a reference c
1b40: 6f 75 6e 74 20 28 73 6f 20 77 65 20 77 69 6c 6c  ount (so we will
1b50: 20 6b 6e 6f 77 20 77 68 65 6e 20 74 6f 20 64 65   know when to de
1b60: 6c 65 74 65 20 69 74 29 20 61 6e 64 20 61 20 22  lete it) and a "
1b70: 63 6e 74 22 0a 2a 2a 20 66 69 65 6c 64 20 74 68  cnt".** field th
1b80: 61 74 20 74 65 6c 6c 73 20 75 73 20 69 74 73 20  at tells us its 
1b90: 69 6e 74 65 72 6e 61 6c 20 6c 6f 63 6b 20 73 74  internal lock st
1ba0: 61 74 75 73 2e 20 20 63 6e 74 3d 3d 30 20 6d 65  atus.  cnt==0 me
1bb0: 61 6e 73 20 74 68 65 0a 2a 2a 20 66 69 6c 65 20  ans the.** file 
1bc0: 69 73 20 75 6e 6c 6f 63 6b 65 64 2e 20 20 63 6e  is unlocked.  cn
1bd0: 74 3d 3d 2d 31 20 6d 65 61 6e 73 20 74 68 65 20  t==-1 means the 
1be0: 66 69 6c 65 20 68 61 73 20 61 6e 20 65 78 63 6c  file has an excl
1bf0: 75 73 69 76 65 20 6c 6f 63 6b 2e 0a 2a 2a 20 63  usive lock..** c
1c00: 6e 74 3e 30 20 6d 65 61 6e 73 20 74 68 65 72 65  nt>0 means there
1c10: 20 61 72 65 20 63 6e 74 20 73 68 61 72 65 64 20   are cnt shared 
1c20: 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 20 66 69 6c  locks on the fil
1c30: 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 79 20 61 74 74  e..**.** Any att
1c40: 65 6d 70 74 20 74 6f 20 6c 6f 63 6b 20 6f 72 20  empt to lock or 
1c50: 75 6e 6c 6f 63 6b 20 61 20 66 69 6c 65 20 66 69  unlock a file fi
1c60: 72 73 74 20 63 68 65 63 6b 73 20 74 68 65 20 6c  rst checks the l
1c70: 6f 63 6b 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74  ocking.** struct
1c80: 75 72 65 2e 20 20 54 68 65 20 66 63 6e 74 6c 28  ure.  The fcntl(
1c90: 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 69 73  ) system call is
1ca0: 20 6f 6e 6c 79 20 69 6e 76 6f 6b 65 64 20 74 6f   only invoked to
1cb0: 20 73 65 74 20 61 20 0a 2a 2a 20 50 4f 53 49 58   set a .** POSIX
1cc0: 20 6c 6f 63 6b 20 69 66 20 74 68 65 20 69 6e 74   lock if the int
1cd0: 65 72 6e 61 6c 20 6c 6f 63 6b 20 73 74 72 75 63  ernal lock struc
1ce0: 74 75 72 65 20 74 72 61 6e 73 69 74 69 6f 6e 73  ture transitions
1cf0: 20 62 65 74 77 65 65 6e 0a 2a 2a 20 61 20 6c 6f   between.** a lo
1d00: 63 6b 65 64 20 61 6e 64 20 61 6e 20 75 6e 6c 6f  cked and an unlo
1d10: 63 6b 65 64 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a  cked state..**.*
1d20: 2a 20 32 30 30 34 2d 4a 61 6e 2d 31 31 3a 0a 2a  * 2004-Jan-11:.*
1d30: 2a 20 4d 6f 72 65 20 72 65 63 65 6e 74 20 64 69  * More recent di
1d40: 73 63 6f 76 65 72 69 65 73 20 61 62 6f 75 74 20  scoveries about 
1d50: 50 4f 53 49 58 20 61 64 76 69 73 6f 72 79 20 6c  POSIX advisory l
1d60: 6f 63 6b 73 2e 20 20 28 54 68 65 20 6d 6f 72 65  ocks.  (The more
1d70: 0a 2a 2a 20 49 20 64 69 73 63 6f 76 65 72 2c 20  .** I discover, 
1d80: 74 68 65 20 6d 6f 72 65 20 49 20 72 65 61 6c 69  the more I reali
1d90: 7a 65 20 74 68 65 20 61 20 50 4f 53 49 58 20 61  ze the a POSIX a
1da0: 64 76 69 73 6f 72 79 20 6c 6f 63 6b 73 20 61 72  dvisory locks ar
1db0: 65 0a 2a 2a 20 61 6e 20 61 62 6f 6d 69 6e 61 74  e.** an abominat
1dc0: 69 6f 6e 2e 29 0a 2a 2a 0a 2a 2a 20 49 66 20 79  ion.).**.** If y
1dd0: 6f 75 20 63 6c 6f 73 65 20 61 20 66 69 6c 65 20  ou close a file 
1de0: 64 65 73 63 72 69 70 74 6f 72 20 74 68 61 74 20  descriptor that 
1df0: 70 6f 69 6e 74 73 20 74 6f 20 61 20 66 69 6c 65  points to a file
1e00: 20 74 68 61 74 20 68 61 73 20 6c 6f 63 6b 73 2c   that has locks,
1e10: 0a 2a 2a 20 61 6c 6c 20 6c 6f 63 6b 73 20 6f 6e  .** all locks on
1e20: 20 74 68 61 74 20 66 69 6c 65 20 74 68 61 74 20   that file that 
1e30: 61 72 65 20 6f 77 6e 65 64 20 62 79 20 74 68 65  are owned by the
1e40: 20 63 75 72 72 65 6e 74 20 70 72 6f 63 65 73 73   current process
1e50: 20 61 72 65 0a 2a 2a 20 72 65 6c 65 61 73 65 64   are.** released
1e60: 2e 20 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e  .  To work aroun
1e70: 64 20 74 68 69 73 20 70 72 6f 62 6c 65 6d 2c 20  d this problem, 
1e80: 65 61 63 68 20 4f 73 46 69 6c 65 20 73 74 72 75  each OsFile stru
1e90: 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 0a 2a  cture contains.*
1ea0: 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  * a pointer to a
1eb0: 6e 20 6f 70 65 6e 43 6e 74 20 73 74 72 75 63 74  n openCnt struct
1ec0: 75 72 65 2e 20 20 54 68 65 72 65 20 69 73 20 6f  ure.  There is o
1ed0: 6e 65 20 6f 70 65 6e 43 6e 74 20 73 74 72 75 63  ne openCnt struc
1ee0: 74 75 72 65 0a 2a 2a 20 70 65 72 20 6f 70 65 6e  ture.** per open
1ef0: 20 69 6e 6f 64 65 2c 20 77 68 69 63 68 20 6d 65   inode, which me
1f00: 61 6e 73 20 74 68 61 74 20 6d 75 6c 74 69 70 6c  ans that multipl
1f10: 65 20 4f 73 46 69 6c 65 73 20 63 61 6e 20 70 6f  e OsFiles can po
1f20: 69 6e 74 20 74 6f 20 61 20 73 69 6e 67 6c 65 0a  int to a single.
1f30: 2a 2a 20 6f 70 65 6e 43 6e 74 2e 20 20 57 68 65  ** openCnt.  Whe
1f40: 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20  n an attempt is 
1f50: 6d 61 64 65 20 74 6f 20 63 6c 6f 73 65 20 61 6e  made to close an
1f60: 20 4f 73 46 69 6c 65 2c 20 69 66 20 74 68 65 72   OsFile, if ther
1f70: 65 20 61 72 65 0a 2a 2a 20 6f 74 68 65 72 20 4f  e are.** other O
1f80: 73 46 69 6c 65 73 20 6f 70 65 6e 20 6f 6e 20 74  sFiles open on t
1f90: 68 65 20 73 61 6d 65 20 69 6e 6f 64 65 20 74 68  he same inode th
1fa0: 61 74 20 61 72 65 20 68 6f 6c 64 69 6e 67 20 6c  at are holding l
1fb0: 6f 63 6b 73 2c 20 74 68 65 20 63 61 6c 6c 0a 2a  ocks, the call.*
1fc0: 2a 20 74 6f 20 63 6c 6f 73 65 28 29 20 74 68 65  * to close() the
1fd0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
1fe0: 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e 74   is deferred unt
1ff0: 69 6c 20 61 6c 6c 20 6f 66 20 74 68 65 20 6c 6f  il all of the lo
2000: 63 6b 73 20 63 6c 65 61 72 2e 0a 2a 2a 20 54 68  cks clear..** Th
2010: 65 20 6f 70 65 6e 43 6e 74 20 73 74 72 75 63 74  e openCnt struct
2020: 75 72 65 20 6b 65 65 70 73 20 61 20 6c 69 73 74  ure keeps a list
2030: 20 6f 66 20 66 69 6c 65 20 64 65 73 63 72 69 70   of file descrip
2040: 74 6f 72 73 20 74 68 61 74 20 6e 65 65 64 20 74  tors that need t
2050: 6f 0a 2a 2a 20 62 65 20 63 6c 6f 73 65 64 20 61  o.** be closed a
2060: 6e 64 20 74 68 61 74 20 6c 69 73 74 20 69 73 20  nd that list is 
2070: 77 61 6c 6b 65 64 20 28 61 6e 64 20 63 6c 65 61  walked (and clea
2080: 72 65 64 29 20 77 68 65 6e 20 74 68 65 20 6c 61  red) when the la
2090: 73 74 20 6c 6f 63 6b 0a 2a 2a 20 63 6c 65 61 72  st lock.** clear
20a0: 73 2e 0a 2a 2a 0a 2a 2a 20 46 69 72 73 74 2c 20  s..**.** First, 
20b0: 75 6e 64 65 72 20 4c 69 6e 75 78 20 74 68 72 65  under Linux thre
20c0: 61 64 73 2c 20 62 65 63 61 75 73 65 20 65 61 63  ads, because eac
20d0: 68 20 74 68 72 65 61 64 20 68 61 73 20 61 20 73  h thread has a s
20e0: 65 70 61 72 61 74 65 0a 2a 2a 20 70 72 6f 63 65  eparate.** proce
20f0: 73 73 20 49 44 2c 20 6c 6f 63 6b 20 6f 70 65 72  ss ID, lock oper
2100: 61 74 69 6f 6e 73 20 69 6e 20 6f 6e 65 20 74 68  ations in one th
2110: 72 65 61 64 20 64 6f 20 6e 6f 74 20 6f 76 65 72  read do not over
2120: 72 69 64 65 20 6c 6f 63 6b 73 0a 2a 2a 20 74 6f  ride locks.** to
2130: 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 69   the same file i
2140: 6e 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 2e  n other threads.
2150: 20 20 4c 69 6e 75 78 20 74 68 72 65 61 64 73 20    Linux threads 
2160: 62 65 68 61 76 65 20 6c 69 6b 65 0a 2a 2a 20 73  behave like.** s
2170: 65 70 61 72 61 74 65 20 70 72 6f 63 65 73 73 65  eparate processe
2180: 73 20 69 6e 20 74 68 69 73 20 72 65 73 70 65 63  s in this respec
2190: 74 2e 20 20 42 75 74 2c 20 69 66 20 79 6f 75 20  t.  But, if you 
21a0: 63 6c 6f 73 65 20 61 20 66 69 6c 65 0a 2a 2a 20  close a file.** 
21b0: 64 65 73 63 72 69 70 74 6f 72 20 69 6e 20 6c 69  descriptor in li
21c0: 6e 75 78 20 74 68 72 65 61 64 73 2c 20 61 6c 6c  nux threads, all
21d0: 20 6c 6f 63 6b 73 20 61 72 65 20 63 6c 65 61 72   locks are clear
21e0: 65 64 2c 20 65 76 65 6e 20 6c 6f 63 6b 73 0a 2a  ed, even locks.*
21f0: 2a 20 6f 6e 20 6f 74 68 65 72 20 74 68 72 65 61  * on other threa
2200: 64 73 20 61 6e 64 20 65 76 65 6e 20 74 68 6f 75  ds and even thou
2210: 67 68 20 74 68 65 20 6f 74 68 65 72 20 74 68 72  gh the other thr
2220: 65 61 64 73 20 68 61 76 65 20 64 69 66 66 65 72  eads have differ
2230: 65 6e 74 0a 2a 2a 20 70 72 6f 63 65 73 73 20 49  ent.** process I
2240: 44 73 2e 20 20 4c 69 6e 75 78 20 74 68 72 65 61  Ds.  Linux threa
2250: 64 73 20 69 73 20 69 6e 63 6f 6e 73 69 73 74 65  ds is inconsiste
2260: 6e 74 20 69 6e 20 74 68 69 73 20 72 65 73 70 65  nt in this respe
2270: 63 74 2e 0a 2a 2a 20 28 49 27 6d 20 62 65 67 69  ct..** (I'm begi
2280: 6e 6e 69 6e 67 20 74 6f 20 74 68 69 6e 6b 20 74  nning to think t
2290: 68 61 74 20 6c 69 6e 75 78 20 74 68 72 65 61 64  hat linux thread
22a0: 73 20 69 73 20 61 6e 20 61 62 6f 6d 69 6e 61 74  s is an abominat
22b0: 69 6f 6e 20 74 6f 6f 2e 29 0a 2a 2a 20 54 68 65  ion too.).** The
22c0: 20 63 6f 6e 73 65 71 75 65 6e 63 65 20 6f 66 20   consequence of 
22d0: 74 68 69 73 20 61 6c 6c 20 69 73 20 74 68 61 74  this all is that
22e0: 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20   the hash table 
22f0: 66 6f 72 20 74 68 65 20 6c 6f 63 6b 49 6e 66 6f  for the lockInfo
2300: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 68 61  .** structure ha
2310: 73 20 74 6f 20 69 6e 63 6c 75 64 65 20 74 68 65  s to include the
2320: 20 70 72 6f 63 65 73 73 20 69 64 20 61 73 20 70   process id as p
2330: 61 72 74 20 6f 66 20 69 74 73 20 6b 65 79 20 62  art of its key b
2340: 65 63 61 75 73 65 0a 2a 2a 20 6c 6f 63 6b 73 20  ecause.** locks 
2350: 69 6e 20 64 69 66 66 65 72 65 6e 74 20 74 68 72  in different thr
2360: 65 61 64 73 20 61 72 65 20 74 72 65 61 74 65 64  eads are treated
2370: 20 61 73 20 64 69 73 74 69 6e 63 74 2e 20 20 42   as distinct.  B
2380: 75 74 20 74 68 65 20 0a 2a 2a 20 6f 70 65 6e 43  ut the .** openC
2390: 6e 74 20 73 74 72 75 63 74 75 72 65 20 73 68 6f  nt structure sho
23a0: 75 6c 64 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20  uld not include 
23b0: 74 68 65 20 70 72 6f 63 65 73 73 20 69 64 20 69  the process id i
23c0: 6e 20 69 74 73 0a 2a 2a 20 6b 65 79 20 62 65 63  n its.** key bec
23d0: 61 75 73 65 20 63 6c 6f 73 65 28 29 20 63 6c 65  ause close() cle
23e0: 61 72 73 20 6c 6f 63 6b 20 6f 6e 20 61 6c 6c 20  ars lock on all 
23f0: 74 68 72 65 61 64 73 2c 20 6e 6f 74 20 6a 75 73  threads, not jus
2400: 74 20 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a  t the current.**
2410: 20 74 68 72 65 61 64 2e 20 20 57 65 72 65 20 69   thread.  Were i
2420: 74 20 6e 6f 74 20 66 6f 72 20 74 68 69 73 20 67  t not for this g
2430: 6f 6f 66 69 6e 65 73 73 20 69 6e 20 6c 69 6e 75  oofiness in linu
2440: 78 20 74 68 72 65 61 64 73 2c 20 77 65 20 63 6f  x threads, we co
2450: 75 6c 64 0a 2a 2a 20 63 6f 6d 62 69 6e 65 20 74  uld.** combine t
2460: 68 65 20 6c 6f 63 6b 49 6e 66 6f 20 61 6e 64 20  he lockInfo and 
2470: 6f 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72  openCnt structur
2480: 65 73 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65  es into a single
2490: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a   structure..**.*
24a0: 2a 20 32 30 30 34 2d 4a 75 6e 2d 32 38 3a 0a 2a  * 2004-Jun-28:.*
24b0: 2a 20 4f 6e 20 73 6f 6d 65 20 76 65 72 73 69 6f  * On some versio
24c0: 6e 73 20 6f 66 20 6c 69 6e 75 78 2c 20 74 68 72  ns of linux, thr
24d0: 65 61 64 73 20 63 61 6e 20 6f 76 65 72 72 69 64  eads can overrid
24e0: 65 20 65 61 63 68 20 6f 74 68 65 72 73 20 6c 6f  e each others lo
24f0: 63 6b 73 2e 0a 2a 2a 20 4f 6e 20 6f 74 68 65 72  cks..** On other
2500: 73 20 6e 6f 74 2e 20 20 53 6f 6d 65 74 69 6d 65  s not.  Sometime
2510: 73 20 79 6f 75 20 63 61 6e 20 63 68 61 6e 67 65  s you can change
2520: 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 6f 6e   the behavior on
2530: 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 73 79 73   the same.** sys
2540: 74 65 6d 20 62 79 20 73 65 74 74 69 6e 67 20 74  tem by setting t
2550: 68 65 20 4c 44 5f 41 53 53 55 4d 45 5f 4b 45 52  he LD_ASSUME_KER
2560: 4e 45 4c 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  NEL environment 
2570: 76 61 72 69 61 62 6c 65 2e 20 20 54 68 65 0a 2a  variable.  The.*
2580: 2a 20 50 4f 53 49 58 20 73 74 61 6e 64 61 72 64  * POSIX standard
2590: 20 69 73 20 73 69 6c 65 6e 74 20 61 73 20 74 6f   is silent as to
25a0: 20 77 68 69 63 68 20 62 65 68 61 76 69 6f 72 20   which behavior 
25b0: 69 73 20 63 6f 72 72 65 63 74 2c 20 61 73 20 66  is correct, as f
25c0: 61 72 0a 2a 2a 20 61 73 20 49 20 63 61 6e 20 74  ar.** as I can t
25d0: 65 6c 6c 2c 20 73 6f 20 6f 74 68 65 72 20 76 65  ell, so other ve
25e0: 72 73 69 6f 6e 73 20 6f 66 20 75 6e 69 78 20 6d  rsions of unix m
25f0: 69 67 68 74 20 73 68 6f 77 20 74 68 65 20 73 61  ight show the sa
2600: 6d 65 0a 2a 2a 20 69 6e 63 6f 6e 73 69 73 74 65  me.** inconsiste
2610: 6e 63 79 2e 20 20 54 68 65 72 65 20 69 73 20 6e  ncy.  There is n
2620: 6f 20 6c 69 74 74 6c 65 20 64 6f 75 62 74 20 69  o little doubt i
2630: 6e 20 6d 79 20 6d 69 6e 64 20 74 68 61 74 20 70  n my mind that p
2640: 6f 73 69 78 0a 2a 2a 20 61 64 76 69 73 6f 72 79  osix.** advisory
2650: 20 6c 6f 63 6b 73 20 61 6e 64 20 6c 69 6e 75 78   locks and linux
2660: 20 74 68 72 65 61 64 73 20 61 72 65 20 70 72 6f   threads are pro
2670: 66 6f 75 6e 64 6c 79 20 62 72 6f 6b 65 6e 2e 0a  foundly broken..
2680: 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b 20 61 72  **.** To work ar
2690: 6f 75 6e 64 20 74 68 65 20 69 6e 63 6f 6e 73 69  ound the inconsi
26a0: 73 74 65 6e 63 69 65 73 2c 20 77 65 20 68 61 76  stencies, we hav
26b0: 65 20 74 6f 20 74 65 73 74 20 61 74 20 72 75 6e  e to test at run
26c0: 74 69 6d 65 20 0a 2a 2a 20 77 68 65 74 68 65 72  time .** whether
26d0: 20 6f 72 20 6e 6f 74 20 74 68 72 65 61 64 73 20   or not threads 
26e0: 63 61 6e 20 6f 76 65 72 72 69 64 65 20 65 61 63  can override eac
26f0: 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73 2e 20  h others locks. 
2700: 20 54 68 69 73 20 74 65 73 74 0a 2a 2a 20 69 73   This test.** is
2710: 20 72 75 6e 20 6f 6e 63 65 2c 20 74 68 65 20 66   run once, the f
2720: 69 72 73 74 20 74 69 6d 65 20 61 6e 79 20 6c 6f  irst time any lo
2730: 63 6b 20 69 73 20 61 74 74 65 6d 70 74 65 64 2e  ck is attempted.
2740: 20 20 41 20 73 74 61 74 69 63 20 0a 2a 2a 20 76    A static .** v
2750: 61 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 74  ariable is set t
2760: 6f 20 72 65 63 6f 72 64 20 74 68 65 20 72 65 73  o record the res
2770: 75 6c 74 73 20 6f 66 20 74 68 69 73 20 74 65 73  ults of this tes
2780: 74 20 66 6f 72 20 66 75 74 75 72 65 0a 2a 2a 20  t for future.** 
2790: 75 73 65 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41  use..*/../*.** A
27a0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68  n instance of th
27b0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  e following stru
27c0: 63 74 75 72 65 20 73 65 72 76 65 73 20 61 73 20  cture serves as 
27d0: 74 68 65 20 6b 65 79 20 75 73 65 64 0a 2a 2a 20  the key used.** 
27e0: 74 6f 20 6c 6f 63 61 74 65 20 61 20 70 61 72 74  to locate a part
27f0: 69 63 75 6c 61 72 20 6c 6f 63 6b 49 6e 66 6f 20  icular lockInfo 
2800: 73 74 72 75 63 74 75 72 65 20 67 69 76 65 6e 20  structure given 
2810: 69 74 73 20 69 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a  its inode..**.**
2820: 20 49 66 20 74 68 72 65 61 64 73 20 63 61 6e 6e   If threads cann
2830: 6f 74 20 6f 76 65 72 72 69 64 65 20 65 61 63 68  ot override each
2840: 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73 2c 20 74   others locks, t
2850: 68 65 6e 20 77 65 20 73 65 74 20 74 68 65 0a 2a  hen we set the.*
2860: 2a 20 6c 6f 63 6b 4b 65 79 2e 74 69 64 20 66 69  * lockKey.tid fi
2870: 65 6c 64 20 74 6f 20 74 68 65 20 74 68 72 65 61  eld to the threa
2880: 64 20 49 44 2e 20 20 49 66 20 74 68 72 65 61 64  d ID.  If thread
2890: 73 20 63 61 6e 20 6f 76 65 72 72 69 64 65 0a 2a  s can override.*
28a0: 2a 20 65 61 63 68 20 6f 74 68 65 72 73 20 6c 6f  * each others lo
28b0: 63 6b 73 20 74 68 65 6e 20 74 69 64 20 69 73 20  cks then tid is 
28c0: 61 6c 77 61 79 73 20 73 65 74 20 74 6f 20 7a 65  always set to ze
28d0: 72 6f 2e 20 20 74 69 64 20 69 73 20 61 6c 73 6f  ro.  tid is also
28e0: 0a 2a 2a 20 73 65 74 20 74 6f 20 7a 65 72 6f 20  .** set to zero 
28f0: 69 66 20 77 65 20 63 6f 6d 70 69 6c 65 20 77 69  if we compile wi
2900: 74 68 6f 75 74 20 74 68 72 65 61 64 69 6e 67 20  thout threading 
2910: 73 75 70 70 6f 72 74 2e 0a 2a 2f 0a 73 74 72 75  support..*/.stru
2920: 63 74 20 6c 6f 63 6b 4b 65 79 20 7b 0a 20 20 64  ct lockKey {.  d
2930: 65 76 5f 74 20 64 65 76 3b 20 20 20 20 20 20 20  ev_t dev;       
2940: 2f 2a 20 44 65 76 69 63 65 20 6e 75 6d 62 65 72  /* Device number
2950: 20 2a 2f 0a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b   */.  ino_t ino;
2960: 20 20 20 20 20 20 20 2f 2a 20 49 6e 6f 64 65 20         /* Inode 
2970: 6e 75 6d 62 65 72 20 2a 2f 0a 23 69 66 64 65 66  number */.#ifdef
2980: 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52   SQLITE_UNIX_THR
2990: 45 41 44 53 0a 20 20 70 74 68 72 65 61 64 5f 74  EADS.  pthread_t
29a0: 20 74 69 64 3b 20 20 20 2f 2a 20 54 68 72 65 61   tid;   /* Threa
29b0: 64 20 49 44 20 6f 72 20 7a 65 72 6f 20 69 66 20  d ID or zero if 
29c0: 74 68 72 65 61 64 73 20 63 61 6e 20 6f 76 65 72  threads can over
29d0: 72 69 64 65 20 65 61 63 68 20 6f 74 68 65 72 20  ride each other 
29e0: 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a  */.#endif.};../*
29f0: 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20  .** An instance 
2a00: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
2a10: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 61 6c   structure is al
2a20: 6c 6f 63 61 74 65 64 20 66 6f 72 20 65 61 63 68  located for each
2a30: 20 6f 70 65 6e 0a 2a 2a 20 69 6e 6f 64 65 20 6f   open.** inode o
2a40: 6e 20 65 61 63 68 20 74 68 72 65 61 64 20 77 69  n each thread wi
2a50: 74 68 20 61 20 64 69 66 66 65 72 65 6e 74 20 70  th a different p
2a60: 72 6f 63 65 73 73 20 49 44 2e 20 20 28 54 68 72  rocess ID.  (Thr
2a70: 65 61 64 73 20 68 61 76 65 0a 2a 2a 20 64 69 66  eads have.** dif
2a80: 66 65 72 65 6e 74 20 70 72 6f 63 65 73 73 20 49  ferent process I
2a90: 44 73 20 6f 6e 20 6c 69 6e 75 78 2c 20 62 75 74  Ds on linux, but
2aa0: 20 6e 6f 74 20 6f 6e 20 6d 6f 73 74 20 6f 74 68   not on most oth
2ab0: 65 72 20 75 6e 69 78 65 73 2e 29 0a 2a 2a 0a 2a  er unixes.).**.*
2ac0: 2a 20 41 20 73 69 6e 67 6c 65 20 69 6e 6f 64 65  * A single inode
2ad0: 20 63 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 70   can have multip
2ae0: 6c 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  le file descript
2af0: 6f 72 73 2c 20 73 6f 20 65 61 63 68 20 4f 73 46  ors, so each OsF
2b00: 69 6c 65 0a 2a 2a 20 73 74 72 75 63 74 75 72 65  ile.** structure
2b10: 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e   contains a poin
2b20: 74 65 72 20 74 6f 20 61 6e 20 69 6e 73 74 61 6e  ter to an instan
2b30: 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63  ce of this objec
2b40: 74 20 61 6e 64 20 74 68 69 73 0a 2a 2a 20 6f 62  t and this.** ob
2b50: 6a 65 63 74 20 6b 65 65 70 73 20 61 20 63 6f 75  ject keeps a cou
2b60: 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72  nt of the number
2b70: 20 6f 66 20 4f 73 46 69 6c 65 73 20 70 6f 69 6e   of OsFiles poin
2b80: 74 69 6e 67 20 74 6f 20 69 74 2e 0a 2a 2f 0a 73  ting to it..*/.s
2b90: 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 7b  truct lockInfo {
2ba0: 0a 20 20 73 74 72 75 63 74 20 6c 6f 63 6b 4b 65  .  struct lockKe
2bb0: 79 20 6b 65 79 3b 20 20 2f 2a 20 54 68 65 20 6c  y key;  /* The l
2bc0: 6f 6f 6b 75 70 20 6b 65 79 20 2a 2f 0a 20 20 69  ookup key */.  i
2bd0: 6e 74 20 63 6e 74 3b 20 20 20 20 20 20 20 20 20  nt cnt;         
2be0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
2bf0: 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 20 68 65   SHARED locks he
2c00: 6c 64 20 2a 2f 0a 20 20 69 6e 74 20 6c 6f 63 6b  ld */.  int lock
2c10: 74 79 70 65 3b 20 20 20 20 20 20 20 20 2f 2a 20  type;        /* 
2c20: 4f 6e 65 20 6f 66 20 53 48 41 52 45 44 5f 4c 4f  One of SHARED_LO
2c30: 43 4b 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f 43  CK, RESERVED_LOC
2c40: 4b 20 65 74 63 2e 20 2a 2f 0a 20 20 69 6e 74 20  K etc. */.  int 
2c50: 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20  nRef;           
2c60: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f   /* Number of po
2c70: 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 20 73  inters to this s
2c80: 74 72 75 63 74 75 72 65 20 2a 2f 0a 7d 3b 0a 0a  tructure */.};..
2c90: 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63  /*.** An instanc
2ca0: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
2cb0: 6e 67 20 73 74 72 75 63 74 75 72 65 20 73 65 72  ng structure ser
2cc0: 76 65 73 20 61 73 20 74 68 65 20 6b 65 79 20 75  ves as the key u
2cd0: 73 65 64 0a 2a 2a 20 74 6f 20 6c 6f 63 61 74 65  sed.** to locate
2ce0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 6f 70   a particular op
2cf0: 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65 20  enCnt structure 
2d00: 67 69 76 65 6e 20 69 74 73 20 69 6e 6f 64 65 2e  given its inode.
2d10: 20 20 54 68 69 73 0a 2a 2a 20 69 73 20 74 68 65    This.** is the
2d20: 20 73 61 6d 65 20 61 73 20 74 68 65 20 6c 6f 63   same as the loc
2d30: 6b 4b 65 79 20 65 78 63 65 70 74 20 74 68 61 74  kKey except that
2d40: 20 74 68 65 20 74 68 72 65 61 64 20 49 44 20 69   the thread ID i
2d50: 73 20 6f 6d 69 74 74 65 64 2e 0a 2a 2f 0a 73 74  s omitted..*/.st
2d60: 72 75 63 74 20 6f 70 65 6e 4b 65 79 20 7b 0a 20  ruct openKey {. 
2d70: 20 64 65 76 5f 74 20 64 65 76 3b 20 20 20 2f 2a   dev_t dev;   /*
2d80: 20 44 65 76 69 63 65 20 6e 75 6d 62 65 72 20 2a   Device number *
2d90: 2f 0a 20 20 69 6e 6f 5f 74 20 69 6e 6f 3b 20 20  /.  ino_t ino;  
2da0: 20 2f 2a 20 49 6e 6f 64 65 20 6e 75 6d 62 65 72   /* Inode number
2db0: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e   */.};../*.** An
2dc0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65   instance of the
2dd0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63   following struc
2de0: 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 61 74 65  ture is allocate
2df0: 64 20 66 6f 72 20 65 61 63 68 20 6f 70 65 6e 0a  d for each open.
2e00: 2a 2a 20 69 6e 6f 64 65 2e 20 20 54 68 69 73 20  ** inode.  This 
2e10: 73 74 72 75 63 74 75 72 65 20 6b 65 65 70 73 20  structure keeps 
2e20: 74 72 61 63 6b 20 6f 66 20 74 68 65 20 6e 75 6d  track of the num
2e30: 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 6f 6e 20  ber of locks on 
2e40: 74 68 61 74 0a 2a 2a 20 69 6e 6f 64 65 2e 20 20  that.** inode.  
2e50: 49 66 20 61 20 63 6c 6f 73 65 20 69 73 20 61 74  If a close is at
2e60: 74 65 6d 70 74 65 64 20 61 67 61 69 6e 73 74 20  tempted against 
2e70: 61 6e 20 69 6e 6f 64 65 20 74 68 61 74 20 69 73  an inode that is
2e80: 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6c 6f 63 6b   holding.** lock
2e90: 73 2c 20 74 68 65 20 63 6c 6f 73 65 20 69 73 20  s, the close is 
2ea0: 64 65 66 65 72 72 65 64 20 75 6e 74 69 6c 20 61  deferred until a
2eb0: 6c 6c 20 6c 6f 63 6b 73 20 63 6c 65 61 72 20 62  ll locks clear b
2ec0: 79 20 61 64 64 69 6e 67 20 74 68 65 0a 2a 2a 20  y adding the.** 
2ed0: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
2ee0: 74 6f 20 62 65 20 63 6c 6f 73 65 64 20 74 6f 20  to be closed to 
2ef0: 74 68 65 20 70 65 6e 64 69 6e 67 20 6c 69 73 74  the pending list
2f00: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 6f 70 65 6e  ..*/.struct open
2f10: 43 6e 74 20 7b 0a 20 20 73 74 72 75 63 74 20 6f  Cnt {.  struct o
2f20: 70 65 6e 4b 65 79 20 6b 65 79 3b 20 20 20 2f 2a  penKey key;   /*
2f30: 20 54 68 65 20 6c 6f 6f 6b 75 70 20 6b 65 79 20   The lookup key 
2f40: 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20  */.  int nRef;  
2f50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
2f60: 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 65 72 73  mber of pointers
2f70: 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75   to this structu
2f80: 72 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 63  re */.  int nLoc
2f90: 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  k;            /*
2fa0: 20 4e 75 6d 62 65 72 20 6f 66 20 6f 75 74 73 74   Number of outst
2fb0: 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 20 2a 2f 0a  anding locks */.
2fc0: 20 20 69 6e 74 20 6e 50 65 6e 64 69 6e 67 3b 20    int nPending; 
2fd0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
2fe0: 72 20 6f 66 20 70 65 6e 64 69 6e 67 20 63 6c 6f  r of pending clo
2ff0: 73 65 28 29 20 6f 70 65 72 61 74 69 6f 6e 73 20  se() operations 
3000: 2a 2f 0a 20 20 69 6e 74 20 2a 61 50 65 6e 64 69  */.  int *aPendi
3010: 6e 67 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 61  ng;        /* Ma
3020: 6c 6c 6f 63 65 64 20 73 70 61 63 65 20 68 6f 6c  lloced space hol
3030: 64 69 6e 67 20 66 64 27 73 20 61 77 61 69 74 69  ding fd's awaiti
3040: 6e 67 20 61 20 63 6c 6f 73 65 28 29 20 2a 2f 0a  ng a close() */.
3050: 7d 3b 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 65 73 65  };../* .** These
3060: 20 68 61 73 68 20 74 61 62 6c 65 20 6d 61 70 73   hash table maps
3070: 20 69 6e 6f 64 65 73 20 61 6e 64 20 70 72 6f 63   inodes and proc
3080: 65 73 73 20 49 44 73 20 69 6e 74 6f 20 6c 6f 63  ess IDs into loc
3090: 6b 49 6e 66 6f 20 61 6e 64 20 6f 70 65 6e 43 6e  kInfo and openCn
30a0: 74 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 73 2e  t.** structures.
30b0: 20 20 41 63 63 65 73 73 20 74 6f 20 74 68 65 73    Access to thes
30c0: 65 20 68 61 73 68 20 74 61 62 6c 65 73 20 6d 75  e hash tables mu
30d0: 73 74 20 62 65 20 70 72 6f 74 65 63 74 65 64 20  st be protected 
30e0: 62 79 20 61 20 6d 75 74 65 78 2e 0a 2a 2f 0a 73  by a mutex..*/.s
30f0: 74 61 74 69 63 20 48 61 73 68 20 6c 6f 63 6b 48  tatic Hash lockH
3100: 61 73 68 20 3d 20 7b 20 53 51 4c 49 54 45 5f 48  ash = { SQLITE_H
3110: 41 53 48 5f 42 49 4e 41 52 59 2c 20 30 2c 20 30  ASH_BINARY, 0, 0
3120: 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 73 74 61  , 0, 0, 0 };.sta
3130: 74 69 63 20 48 61 73 68 20 6f 70 65 6e 48 61 73  tic Hash openHas
3140: 68 20 3d 20 7b 20 53 51 4c 49 54 45 5f 48 41 53  h = { SQLITE_HAS
3150: 48 5f 42 49 4e 41 52 59 2c 20 30 2c 20 30 2c 20  H_BINARY, 0, 0, 
3160: 30 2c 20 30 2c 20 30 20 7d 3b 0a 0a 0a 23 69 66  0, 0, 0 };...#if
3170: 64 65 66 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f  def SQLITE_UNIX_
3180: 54 48 52 45 41 44 53 0a 2f 2a 0a 2a 2a 20 54 68  THREADS./*.** Th
3190: 69 73 20 76 61 72 69 61 62 6c 65 20 72 65 63 6f  is variable reco
31a0: 72 64 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e  rds whether or n
31b0: 6f 74 20 74 68 72 65 61 64 73 20 63 61 6e 20 6f  ot threads can o
31c0: 76 65 72 72 69 64 65 20 65 61 63 68 20 6f 74 68  verride each oth
31d0: 65 72 73 0a 2a 2a 20 6c 6f 63 6b 73 2e 0a 2a 2a  ers.** locks..**
31e0: 0a 2a 2a 20 20 20 20 30 3a 20 20 4e 6f 2e 20 20  .**    0:  No.  
31f0: 54 68 72 65 61 64 73 20 63 61 6e 6e 6f 74 20 6f  Threads cannot o
3200: 76 65 72 72 69 64 65 20 65 61 63 68 20 6f 74 68  verride each oth
3210: 65 72 73 20 6c 6f 63 6b 73 2e 0a 2a 2a 20 20 20  ers locks..**   
3220: 20 31 3a 20 20 59 65 73 2e 20 20 54 68 72 65 61   1:  Yes.  Threa
3230: 64 73 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20  ds can override 
3240: 65 61 63 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b  each others lock
3250: 73 2e 0a 2a 2a 20 20 20 2d 31 3a 20 20 57 65 20  s..**   -1:  We 
3260: 64 6f 6e 27 74 20 6b 6e 6f 77 20 79 65 74 2e 0a  don't know yet..
3270: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74 68  */.static int th
3280: 72 65 61 64 73 4f 76 65 72 72 69 64 65 45 61 63  readsOverrideEac
3290: 68 4f 74 68 65 72 73 4c 6f 63 6b 73 20 3d 20 2d  hOthersLocks = -
32a0: 31 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 73  1;../*.** This s
32b0: 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20 69  tructure holds i
32c0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 70 61 73 73 65  nformation passe
32d0: 64 20 69 6e 74 6f 20 69 6e 64 69 76 69 64 75 61  d into individua
32e0: 6c 20 74 65 73 74 0a 2a 2a 20 74 68 72 65 61 64  l test.** thread
32f0: 73 20 62 79 20 74 68 65 20 74 65 73 74 54 68 72  s by the testThr
3300: 65 61 64 4c 6f 63 6b 69 6e 67 42 65 68 61 76 69  eadLockingBehavi
3310: 6f 72 28 29 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f  or() routine..*/
3320: 0a 73 74 72 75 63 74 20 74 68 72 65 61 64 54 65  .struct threadTe
3330: 73 74 44 61 74 61 20 7b 0a 20 20 69 6e 74 20 66  stData {.  int f
3340: 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d;              
3350: 20 20 2f 2a 20 46 69 6c 65 20 74 6f 20 62 65 20    /* File to be 
3360: 6c 6f 63 6b 65 64 20 2a 2f 0a 20 20 73 74 72 75  locked */.  stru
3370: 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 20 20  ct flock lock;  
3380: 20 20 20 2f 2a 20 54 68 65 20 6c 6f 63 6b 69 6e     /* The lockin
3390: 67 20 6f 70 65 72 61 74 69 6f 6e 20 2a 2f 0a 20  g operation */. 
33a0: 20 69 6e 74 20 72 65 73 75 6c 74 3b 20 20 20 20   int result;    
33b0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c          /* Resul
33c0: 74 20 6f 66 20 74 68 65 20 6c 6f 63 6b 69 6e 67  t of the locking
33d0: 20 6f 70 65 72 61 74 69 6f 6e 20 2a 2f 0a 7d 3b   operation */.};
33e0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
33f0: 4c 4f 43 4b 5f 54 52 41 43 45 0a 2f 2a 0a 2a 2a  LOCK_TRACE./*.**
3400: 20 50 72 69 6e 74 20 6f 75 74 20 69 6e 66 6f 72   Print out infor
3410: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 6c 6c  mation about all
3420: 20 6c 6f 63 6b 69 6e 67 20 6f 70 65 72 61 74 69   locking operati
3430: 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ons..**.** This 
3440: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20  routine is used 
3450: 66 6f 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f 74  for troubleshoot
3460: 69 6e 67 20 6c 6f 63 6b 73 20 6f 6e 20 6d 75 6c  ing locks on mul
3470: 74 69 74 68 72 65 61 64 65 64 0a 2a 2a 20 70 6c  tithreaded.** pl
3480: 61 74 66 6f 72 6d 73 2e 20 20 45 6e 61 62 6c 65  atforms.  Enable
3490: 20 62 79 20 63 6f 6d 70 69 6c 69 6e 67 20 77 69   by compiling wi
34a0: 74 68 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f  th the -DSQLITE_
34b0: 4c 4f 43 4b 5f 54 52 41 43 45 0a 2a 2a 20 63 6f  LOCK_TRACE.** co
34c0: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f  mmand-line optio
34d0: 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65  n on the compile
34e0: 72 2e 20 20 54 68 69 73 20 63 6f 64 65 20 69 73  r.  This code is
34f0: 20 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 74 75 72   normally.** tur
3500: 6e 6e 65 64 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61  nned off..*/.sta
3510: 74 69 63 20 69 6e 74 20 6c 6f 63 6b 54 72 61 63  tic int lockTrac
3520: 65 28 69 6e 74 20 66 64 2c 20 69 6e 74 20 6f 70  e(int fd, int op
3530: 2c 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 2a  , struct flock *
3540: 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a 4f 70 4e  p){.  char *zOpN
3550: 61 6d 65 2c 20 2a 7a 54 79 70 65 3b 0a 20 20 69  ame, *zType;.  i
3560: 6e 74 20 73 3b 0a 20 20 69 6e 74 20 73 61 76 65  nt s;.  int save
3570: 64 45 72 72 6e 6f 3b 0a 20 20 69 66 28 20 6f 70  dErrno;.  if( op
3580: 3d 3d 46 5f 47 45 54 4c 4b 20 29 7b 0a 20 20 20  ==F_GETLK ){.   
3590: 20 7a 4f 70 4e 61 6d 65 20 3d 20 22 47 45 54 4c   zOpName = "GETL
35a0: 4b 22 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  K";.  }else if( 
35b0: 6f 70 3d 3d 46 5f 53 45 54 4c 4b 20 29 7b 0a 20  op==F_SETLK ){. 
35c0: 20 20 20 7a 4f 70 4e 61 6d 65 20 3d 20 22 53 45     zOpName = "SE
35d0: 54 4c 4b 22 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  TLK";.  }else{. 
35e0: 20 20 20 73 20 3d 20 66 63 6e 74 6c 28 66 64 2c     s = fcntl(fd,
35f0: 20 6f 70 2c 20 70 29 3b 0a 20 20 20 20 73 71 6c   op, p);.    sql
3600: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28  ite3DebugPrintf(
3610: 22 66 63 6e 74 6c 20 75 6e 6b 6e 6f 77 6e 20 25  "fcntl unknown %
3620: 64 20 25 64 20 25 64 5c 6e 22 2c 20 66 64 2c 20  d %d %d\n", fd, 
3630: 6f 70 2c 20 73 29 3b 0a 20 20 20 20 72 65 74 75  op, s);.    retu
3640: 72 6e 20 73 3b 0a 20 20 7d 0a 20 20 69 66 28 20  rn s;.  }.  if( 
3650: 70 2d 3e 6c 5f 74 79 70 65 3d 3d 46 5f 52 44 4c  p->l_type==F_RDL
3660: 43 4b 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 20  CK ){.    zType 
3670: 3d 20 22 52 44 4c 43 4b 22 3b 0a 20 20 7d 65 6c  = "RDLCK";.  }el
3680: 73 65 20 69 66 28 20 70 2d 3e 6c 5f 74 79 70 65  se if( p->l_type
3690: 3d 3d 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 20 20  ==F_WRLCK ){.   
36a0: 20 7a 54 79 70 65 20 3d 20 22 57 52 4c 43 4b 22   zType = "WRLCK"
36b0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d  ;.  }else if( p-
36c0: 3e 6c 5f 74 79 70 65 3d 3d 46 5f 55 4e 4c 43 4b  >l_type==F_UNLCK
36d0: 20 29 7b 0a 20 20 20 20 7a 54 79 70 65 20 3d 20   ){.    zType = 
36e0: 22 55 4e 4c 43 4b 22 3b 0a 20 20 7d 65 6c 73 65  "UNLCK";.  }else
36f0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 30 20  {.    assert( 0 
3700: 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  );.  }.  assert(
3710: 20 70 2d 3e 6c 5f 77 68 65 6e 63 65 3d 3d 53 45   p->l_whence==SE
3720: 45 4b 5f 53 45 54 20 29 3b 0a 20 20 73 20 3d 20  EK_SET );.  s = 
3730: 66 63 6e 74 6c 28 66 64 2c 20 6f 70 2c 20 70 29  fcntl(fd, op, p)
3740: 3b 0a 20 20 73 61 76 65 64 45 72 72 6e 6f 20 3d  ;.  savedErrno =
3750: 20 65 72 72 6e 6f 3b 0a 20 20 73 71 6c 69 74 65   errno;.  sqlite
3760: 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 66 63  3DebugPrintf("fc
3770: 6e 74 6c 20 25 64 20 25 64 20 25 73 20 25 73 20  ntl %d %d %s %s 
3780: 25 64 20 25 64 20 25 64 20 25 64 5c 6e 22 2c 0a  %d %d %d %d\n",.
3790: 20 20 20 20 20 74 68 72 65 61 64 69 64 2c 20 66       threadid, f
37a0: 64 2c 20 7a 4f 70 4e 61 6d 65 2c 20 7a 54 79 70  d, zOpName, zTyp
37b0: 65 2c 20 28 69 6e 74 29 70 2d 3e 6c 5f 73 74 61  e, (int)p->l_sta
37c0: 72 74 2c 20 28 69 6e 74 29 70 2d 3e 6c 5f 6c 65  rt, (int)p->l_le
37d0: 6e 2c 0a 20 20 20 20 20 28 69 6e 74 29 70 2d 3e  n,.     (int)p->
37e0: 6c 5f 70 69 64 2c 20 73 29 3b 0a 20 20 69 66 28  l_pid, s);.  if(
37f0: 20 73 20 26 26 20 6f 70 3d 3d 46 5f 53 45 54 4c   s && op==F_SETL
3800: 4b 20 26 26 20 28 70 2d 3e 6c 5f 74 79 70 65 3d  K && (p->l_type=
3810: 3d 46 5f 52 44 4c 43 4b 20 7c 7c 20 70 2d 3e 6c  =F_RDLCK || p->l
3820: 5f 74 79 70 65 3d 3d 46 5f 57 52 4c 43 4b 29 20  _type==F_WRLCK) 
3830: 29 7b 0a 20 20 20 20 73 74 72 75 63 74 20 66 6c  ){.    struct fl
3840: 6f 63 6b 20 6c 32 3b 0a 20 20 20 20 6c 32 20 3d  ock l2;.    l2 =
3850: 20 2a 70 3b 0a 20 20 20 20 66 63 6e 74 6c 28 66   *p;.    fcntl(f
3860: 64 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 32 29  d, F_GETLK, &l2)
3870: 3b 0a 20 20 20 20 69 66 28 20 6c 32 2e 6c 5f 74  ;.    if( l2.l_t
3880: 79 70 65 3d 3d 46 5f 52 44 4c 43 4b 20 29 7b 0a  ype==F_RDLCK ){.
3890: 20 20 20 20 20 20 7a 54 79 70 65 20 3d 20 22 52        zType = "R
38a0: 44 4c 43 4b 22 3b 0a 20 20 20 20 7d 65 6c 73 65  DLCK";.    }else
38b0: 20 69 66 28 20 6c 32 2e 6c 5f 74 79 70 65 3d 3d   if( l2.l_type==
38c0: 46 5f 57 52 4c 43 4b 20 29 7b 0a 20 20 20 20 20  F_WRLCK ){.     
38d0: 20 7a 54 79 70 65 20 3d 20 22 57 52 4c 43 4b 22   zType = "WRLCK"
38e0: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
38f0: 6c 32 2e 6c 5f 74 79 70 65 3d 3d 46 5f 55 4e 4c  l2.l_type==F_UNL
3900: 43 4b 20 29 7b 0a 20 20 20 20 20 20 7a 54 79 70  CK ){.      zTyp
3910: 65 20 3d 20 22 55 4e 4c 43 4b 22 3b 0a 20 20 20  e = "UNLCK";.   
3920: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73   }else{.      as
3930: 73 65 72 74 28 20 30 20 29 3b 0a 20 20 20 20 7d  sert( 0 );.    }
3940: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75  .    sqlite3Debu
3950: 67 50 72 69 6e 74 66 28 22 66 63 6e 74 6c 2d 66  gPrintf("fcntl-f
3960: 61 69 6c 75 72 65 2d 72 65 61 73 6f 6e 3a 20 25  ailure-reason: %
3970: 73 20 25 64 20 25 64 20 25 64 5c 6e 22 2c 0a 20  s %d %d %d\n",. 
3980: 20 20 20 20 20 20 7a 54 79 70 65 2c 20 28 69 6e        zType, (in
3990: 74 29 6c 32 2e 6c 5f 73 74 61 72 74 2c 20 28 69  t)l2.l_start, (i
39a0: 6e 74 29 6c 32 2e 6c 5f 6c 65 6e 2c 20 28 69 6e  nt)l2.l_len, (in
39b0: 74 29 6c 32 2e 6c 5f 70 69 64 29 3b 0a 20 20 7d  t)l2.l_pid);.  }
39c0: 0a 20 20 65 72 72 6e 6f 20 3d 20 73 61 76 65 64  .  errno = saved
39d0: 45 72 72 6e 6f 3b 0a 20 20 72 65 74 75 72 6e 20  Errno;.  return 
39e0: 73 3b 0a 7d 0a 23 64 65 66 69 6e 65 20 66 63 6e  s;.}.#define fcn
39f0: 74 6c 20 6c 6f 63 6b 54 72 61 63 65 0a 23 65 6e  tl lockTrace.#en
3a00: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4c 4f  dif /* SQLITE_LO
3a10: 43 4b 5f 54 52 41 43 45 20 2a 2f 0a 0a 2f 2a 0a  CK_TRACE */../*.
3a20: 2a 2a 20 54 68 65 20 74 65 73 74 54 68 72 65 61  ** The testThrea
3a30: 64 4c 6f 63 6b 69 6e 67 42 65 68 61 76 69 6f 72  dLockingBehavior
3a40: 28 29 20 72 6f 75 74 69 6e 65 20 6c 61 75 6e 63  () routine launc
3a50: 68 65 73 20 74 77 6f 20 73 65 70 61 72 61 74 65  hes two separate
3a60: 0a 2a 2a 20 74 68 72 65 61 64 73 20 6f 6e 20 74  .** threads on t
3a70: 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 54 68  his routine.  Th
3a80: 69 73 20 72 6f 75 74 69 6e 65 20 61 74 74 65 6d  is routine attem
3a90: 70 74 73 20 74 6f 20 6c 6f 63 6b 20 61 20 66 69  pts to lock a fi
3aa0: 6c 65 0a 2a 2a 20 64 65 73 63 72 69 70 74 6f 72  le.** descriptor
3ab0: 20 74 68 65 6e 20 72 65 74 75 72 6e 73 2e 20 20   then returns.  
3ac0: 54 68 65 20 73 75 63 63 65 73 73 20 6f 72 20 66  The success or f
3ad0: 61 69 6c 75 72 65 20 6f 66 20 74 68 61 74 20 61  ailure of that a
3ae0: 74 74 65 6d 70 74 0a 2a 2a 20 61 6c 6c 6f 77 73  ttempt.** allows
3af0: 20 74 68 65 20 74 65 73 74 54 68 72 65 61 64 4c   the testThreadL
3b00: 6f 63 6b 69 6e 67 42 65 68 61 76 69 6f 72 28 29  ockingBehavior()
3b10: 20 70 72 6f 63 65 64 75 72 65 20 74 6f 20 64 65   procedure to de
3b20: 74 65 72 6d 69 6e 65 0a 2a 2a 20 77 68 65 74 68  termine.** wheth
3b30: 65 72 20 6f 72 20 6e 6f 74 20 74 68 72 65 61 64  er or not thread
3b40: 73 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 65  s can override e
3b50: 61 63 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73  ach others locks
3b60: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
3b70: 20 2a 74 68 72 65 61 64 4c 6f 63 6b 69 6e 67 54   *threadLockingT
3b80: 65 73 74 28 76 6f 69 64 20 2a 70 41 72 67 29 7b  est(void *pArg){
3b90: 0a 20 20 73 74 72 75 63 74 20 74 68 72 65 61 64  .  struct thread
3ba0: 54 65 73 74 44 61 74 61 20 2a 70 44 61 74 61 20  TestData *pData 
3bb0: 3d 20 28 73 74 72 75 63 74 20 74 68 72 65 61 64  = (struct thread
3bc0: 54 65 73 74 44 61 74 61 2a 29 70 41 72 67 3b 0a  TestData*)pArg;.
3bd0: 20 20 70 44 61 74 61 2d 3e 72 65 73 75 6c 74 20    pData->result 
3be0: 3d 20 66 63 6e 74 6c 28 70 44 61 74 61 2d 3e 66  = fcntl(pData->f
3bf0: 64 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 70 44 61  d, F_SETLK, &pDa
3c00: 74 61 2d 3e 6c 6f 63 6b 29 3b 0a 20 20 72 65 74  ta->lock);.  ret
3c10: 75 72 6e 20 70 41 72 67 3b 0a 7d 0a 0a 2f 2a 0a  urn pArg;.}../*.
3c20: 2a 2a 20 54 68 69 73 20 70 72 6f 63 65 64 75 72  ** This procedur
3c30: 65 20 61 74 74 65 6d 70 74 73 20 74 6f 20 64 65  e attempts to de
3c40: 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20  termine whether 
3c50: 6f 72 20 6e 6f 74 20 74 68 72 65 61 64 73 0a 2a  or not threads.*
3c60: 2a 20 63 61 6e 20 6f 76 65 72 72 69 64 65 20 65  * can override e
3c70: 61 63 68 20 6f 74 68 65 72 73 20 6c 6f 63 6b 73  ach others locks
3c80: 20 74 68 65 6e 20 73 65 74 73 20 74 68 65 20 0a   then sets the .
3c90: 2a 2a 20 74 68 72 65 61 64 73 4f 76 65 72 72 69  ** threadsOverri
3ca0: 64 65 45 61 63 68 4f 74 68 65 72 73 4c 6f 63 6b  deEachOthersLock
3cb0: 73 20 76 61 72 69 61 62 6c 65 20 61 70 70 72 6f  s variable appro
3cc0: 70 72 69 61 74 65 6c 79 2e 0a 2a 2f 0a 73 74 61  priately..*/.sta
3cd0: 74 69 63 20 76 6f 69 64 20 74 65 73 74 54 68 72  tic void testThr
3ce0: 65 61 64 4c 6f 63 6b 69 6e 67 42 65 68 61 76 69  eadLockingBehavi
3cf0: 6f 72 28 66 64 5f 6f 72 69 67 29 7b 0a 20 20 69  or(fd_orig){.  i
3d00: 6e 74 20 66 64 3b 0a 20 20 73 74 72 75 63 74 20  nt fd;.  struct 
3d10: 74 68 72 65 61 64 54 65 73 74 44 61 74 61 20 64  threadTestData d
3d20: 5b 32 5d 3b 0a 20 20 70 74 68 72 65 61 64 5f 74  [2];.  pthread_t
3d30: 20 74 5b 32 5d 3b 0a 0a 20 20 66 64 20 3d 20 64   t[2];..  fd = d
3d40: 75 70 28 66 64 5f 6f 72 69 67 29 3b 0a 20 20 69  up(fd_orig);.  i
3d50: 66 28 20 66 64 3c 30 20 29 20 72 65 74 75 72 6e  f( fd<0 ) return
3d60: 3b 0a 20 20 6d 65 6d 73 65 74 28 64 2c 20 30 2c  ;.  memset(d, 0,
3d70: 20 73 69 7a 65 6f 66 28 64 29 29 3b 0a 20 20 64   sizeof(d));.  d
3d80: 5b 30 5d 2e 66 64 20 3d 20 66 64 3b 0a 20 20 64  [0].fd = fd;.  d
3d90: 5b 30 5d 2e 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20  [0].lock.l_type 
3da0: 3d 20 46 5f 52 44 4c 43 4b 3b 0a 20 20 64 5b 30  = F_RDLCK;.  d[0
3db0: 5d 2e 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 31  ].lock.l_len = 1
3dc0: 3b 0a 20 20 64 5b 30 5d 2e 6c 6f 63 6b 2e 6c 5f  ;.  d[0].lock.l_
3dd0: 73 74 61 72 74 20 3d 20 30 3b 0a 20 20 64 5b 30  start = 0;.  d[0
3de0: 5d 2e 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65 20  ].lock.l_whence 
3df0: 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 64 5b  = SEEK_SET;.  d[
3e00: 31 5d 20 3d 20 64 5b 30 5d 3b 0a 20 20 64 5b 31  1] = d[0];.  d[1
3e10: 5d 2e 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20  ].lock.l_type = 
3e20: 46 5f 57 52 4c 43 4b 3b 0a 20 20 70 74 68 72 65  F_WRLCK;.  pthre
3e30: 61 64 5f 63 72 65 61 74 65 28 26 74 5b 30 5d 2c  ad_create(&t[0],
3e40: 20 30 2c 20 74 68 72 65 61 64 4c 6f 63 6b 69 6e   0, threadLockin
3e50: 67 54 65 73 74 2c 20 26 64 5b 30 5d 29 3b 0a 20  gTest, &d[0]);. 
3e60: 20 70 74 68 72 65 61 64 5f 63 72 65 61 74 65 28   pthread_create(
3e70: 26 74 5b 31 5d 2c 20 30 2c 20 74 68 72 65 61 64  &t[1], 0, thread
3e80: 4c 6f 63 6b 69 6e 67 54 65 73 74 2c 20 26 64 5b  LockingTest, &d[
3e90: 31 5d 29 3b 0a 20 20 70 74 68 72 65 61 64 5f 6a  1]);.  pthread_j
3ea0: 6f 69 6e 28 74 5b 30 5d 2c 20 30 29 3b 0a 20 20  oin(t[0], 0);.  
3eb0: 70 74 68 72 65 61 64 5f 6a 6f 69 6e 28 74 5b 31  pthread_join(t[1
3ec0: 5d 2c 20 30 29 3b 0a 20 20 63 6c 6f 73 65 28 66  ], 0);.  close(f
3ed0: 64 29 3b 0a 20 20 74 68 72 65 61 64 73 4f 76 65  d);.  threadsOve
3ee0: 72 72 69 64 65 45 61 63 68 4f 74 68 65 72 73 4c  rrideEachOthersL
3ef0: 6f 63 6b 73 20 3d 20 20 64 5b 30 5d 2e 72 65 73  ocks =  d[0].res
3f00: 75 6c 74 3d 3d 30 20 26 26 20 64 5b 31 5d 2e 72  ult==0 && d[1].r
3f10: 65 73 75 6c 74 3d 3d 30 3b 0a 7d 0a 23 65 6e 64  esult==0;.}.#end
3f20: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 55 4e 49  if /* SQLITE_UNI
3f30: 58 5f 54 48 52 45 41 44 53 20 2a 2f 0a 0a 2f 2a  X_THREADS */../*
3f40: 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 6c 6f  .** Release a lo
3f50: 63 6b 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65  ckInfo structure
3f60: 20 70 72 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f   previously allo
3f70: 63 61 74 65 64 20 62 79 20 66 69 6e 64 4c 6f 63  cated by findLoc
3f80: 6b 49 6e 66 6f 28 29 2e 0a 2a 2f 0a 73 74 61 74  kInfo()..*/.stat
3f90: 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 4c  ic void releaseL
3fa0: 6f 63 6b 49 6e 66 6f 28 73 74 72 75 63 74 20 6c  ockInfo(struct l
3fb0: 6f 63 6b 49 6e 66 6f 20 2a 70 4c 6f 63 6b 29 7b  ockInfo *pLock){
3fc0: 0a 20 20 70 4c 6f 63 6b 2d 3e 6e 52 65 66 2d 2d  .  pLock->nRef--
3fd0: 3b 0a 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 6e  ;.  if( pLock->n
3fe0: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71  Ref==0 ){.    sq
3ff0: 6c 69 74 65 33 48 61 73 68 49 6e 73 65 72 74 28  lite3HashInsert(
4000: 26 6c 6f 63 6b 48 61 73 68 2c 20 26 70 4c 6f 63  &lockHash, &pLoc
4010: 6b 2d 3e 6b 65 79 2c 20 73 69 7a 65 6f 66 28 70  k->key, sizeof(p
4020: 4c 6f 63 6b 2d 3e 6b 65 79 29 2c 20 30 29 3b 0a  Lock->key), 0);.
4030: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
4040: 4c 6f 63 6b 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  Lock);.  }.}../*
4050: 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 6f 70  .** Release a op
4060: 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65 20  enCnt structure 
4070: 70 72 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f 63  previously alloc
4080: 61 74 65 64 20 62 79 20 66 69 6e 64 4c 6f 63 6b  ated by findLock
4090: 49 6e 66 6f 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  Info()..*/.stati
40a0: 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 4f 70  c void releaseOp
40b0: 65 6e 43 6e 74 28 73 74 72 75 63 74 20 6f 70 65  enCnt(struct ope
40c0: 6e 43 6e 74 20 2a 70 4f 70 65 6e 29 7b 0a 20 20  nCnt *pOpen){.  
40d0: 70 4f 70 65 6e 2d 3e 6e 52 65 66 2d 2d 3b 0a 20  pOpen->nRef--;. 
40e0: 20 69 66 28 20 70 4f 70 65 6e 2d 3e 6e 52 65 66   if( pOpen->nRef
40f0: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ==0 ){.    sqlit
4100: 65 33 48 61 73 68 49 6e 73 65 72 74 28 26 6f 70  e3HashInsert(&op
4110: 65 6e 48 61 73 68 2c 20 26 70 4f 70 65 6e 2d 3e  enHash, &pOpen->
4120: 6b 65 79 2c 20 73 69 7a 65 6f 66 28 70 4f 70 65  key, sizeof(pOpe
4130: 6e 2d 3e 6b 65 79 29 2c 20 30 29 3b 0a 20 20 20  n->key), 0);.   
4140: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f 70 65   sqliteFree(pOpe
4150: 6e 2d 3e 61 50 65 6e 64 69 6e 67 29 3b 0a 20 20  n->aPending);.  
4160: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f 70    sqliteFree(pOp
4170: 65 6e 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  en);.  }.}../*.*
4180: 2a 20 47 69 76 65 6e 20 61 20 66 69 6c 65 20 64  * Given a file d
4190: 65 73 63 72 69 70 74 6f 72 2c 20 6c 6f 63 61 74  escriptor, locat
41a0: 65 20 6c 6f 63 6b 49 6e 66 6f 20 61 6e 64 20 6f  e lockInfo and o
41b0: 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75 72 65  penCnt structure
41c0: 73 20 74 68 61 74 0a 2a 2a 20 64 65 73 63 72 69  s that.** descri
41d0: 62 65 73 20 74 68 61 74 20 66 69 6c 65 20 64 65  bes that file de
41e0: 73 63 72 69 70 74 6f 72 2e 20 20 43 72 65 61 74  scriptor.  Creat
41f0: 65 20 61 20 6e 65 77 20 6f 6e 65 73 20 69 66 20  e a new ones if 
4200: 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 65 0a  necessary.  The.
4210: 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73  ** return values
4220: 20 6d 69 67 68 74 20 62 65 20 75 6e 73 65 74 20   might be unset 
4230: 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  if an error occu
4240: 72 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e  rs..**.** Return
4250: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65   the number of e
4260: 72 72 6f 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63  rrors..*/.static
4270: 20 69 6e 74 20 66 69 6e 64 4c 6f 63 6b 49 6e 66   int findLockInf
4280: 6f 28 0a 20 20 69 6e 74 20 66 64 2c 20 20 20 20  o(.  int fd,    
4290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
42a0: 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 64 65    /* The file de
42b0: 73 63 72 69 70 74 6f 72 20 75 73 65 64 20 69 6e  scriptor used in
42c0: 20 74 68 65 20 6b 65 79 20 2a 2f 0a 20 20 73 74   the key */.  st
42d0: 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 2a  ruct lockInfo **
42e0: 70 70 4c 6f 63 6b 2c 20 20 20 20 2f 2a 20 52 65  ppLock,    /* Re
42f0: 74 75 72 6e 20 74 68 65 20 6c 6f 63 6b 49 6e 66  turn the lockInf
4300: 6f 20 73 74 72 75 63 74 75 72 65 20 68 65 72 65  o structure here
4310: 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 6f 70 65   */.  struct ope
4320: 6e 43 6e 74 20 2a 2a 70 70 4f 70 65 6e 20 20 20  nCnt **ppOpen   
4330: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65     /* Return the
4340: 20 6f 70 65 6e 43 6e 74 20 73 74 72 75 63 74 75   openCnt structu
4350: 72 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20  re here */.){.  
4360: 69 6e 74 20 72 63 3b 0a 20 20 73 74 72 75 63 74  int rc;.  struct
4370: 20 6c 6f 63 6b 4b 65 79 20 6b 65 79 31 3b 0a 20   lockKey key1;. 
4380: 20 73 74 72 75 63 74 20 6f 70 65 6e 4b 65 79 20   struct openKey 
4390: 6b 65 79 32 3b 0a 20 20 73 74 72 75 63 74 20 73  key2;.  struct s
43a0: 74 61 74 20 73 74 61 74 62 75 66 3b 0a 20 20 73  tat statbuf;.  s
43b0: 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a  truct lockInfo *
43c0: 70 4c 6f 63 6b 3b 0a 20 20 73 74 72 75 63 74 20  pLock;.  struct 
43d0: 6f 70 65 6e 43 6e 74 20 2a 70 4f 70 65 6e 3b 0a  openCnt *pOpen;.
43e0: 20 20 72 63 20 3d 20 66 73 74 61 74 28 66 64 2c    rc = fstat(fd,
43f0: 20 26 73 74 61 74 62 75 66 29 3b 0a 20 20 69 66   &statbuf);.  if
4400: 28 20 72 63 21 3d 30 20 29 20 72 65 74 75 72 6e  ( rc!=0 ) return
4410: 20 31 3b 0a 20 20 6d 65 6d 73 65 74 28 26 6b 65   1;.  memset(&ke
4420: 79 31 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6b 65  y1, 0, sizeof(ke
4430: 79 31 29 29 3b 0a 20 20 6b 65 79 31 2e 64 65 76  y1));.  key1.dev
4440: 20 3d 20 73 74 61 74 62 75 66 2e 73 74 5f 64 65   = statbuf.st_de
4450: 76 3b 0a 20 20 6b 65 79 31 2e 69 6e 6f 20 3d 20  v;.  key1.ino = 
4460: 73 74 61 74 62 75 66 2e 73 74 5f 69 6e 6f 3b 0a  statbuf.st_ino;.
4470: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 4e  #ifdef SQLITE_UN
4480: 49 58 5f 54 48 52 45 41 44 53 0a 20 20 69 66 28  IX_THREADS.  if(
4490: 20 74 68 72 65 61 64 73 4f 76 65 72 72 69 64 65   threadsOverride
44a0: 45 61 63 68 4f 74 68 65 72 73 4c 6f 63 6b 73 3c  EachOthersLocks<
44b0: 30 20 29 7b 0a 20 20 20 20 74 65 73 74 54 68 72  0 ){.    testThr
44c0: 65 61 64 4c 6f 63 6b 69 6e 67 42 65 68 61 76 69  eadLockingBehavi
44d0: 6f 72 28 66 64 29 3b 0a 20 20 7d 0a 20 20 6b 65  or(fd);.  }.  ke
44e0: 79 31 2e 74 69 64 20 3d 20 74 68 72 65 61 64 73  y1.tid = threads
44f0: 4f 76 65 72 72 69 64 65 45 61 63 68 4f 74 68 65  OverrideEachOthe
4500: 72 73 4c 6f 63 6b 73 20 3f 20 30 20 3a 20 70 74  rsLocks ? 0 : pt
4510: 68 72 65 61 64 5f 73 65 6c 66 28 29 3b 0a 23 65  hread_self();.#e
4520: 6e 64 69 66 0a 20 20 6d 65 6d 73 65 74 28 26 6b  ndif.  memset(&k
4530: 65 79 32 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6b  ey2, 0, sizeof(k
4540: 65 79 32 29 29 3b 0a 20 20 6b 65 79 32 2e 64 65  ey2));.  key2.de
4550: 76 20 3d 20 73 74 61 74 62 75 66 2e 73 74 5f 64  v = statbuf.st_d
4560: 65 76 3b 0a 20 20 6b 65 79 32 2e 69 6e 6f 20 3d  ev;.  key2.ino =
4570: 20 73 74 61 74 62 75 66 2e 73 74 5f 69 6e 6f 3b   statbuf.st_ino;
4580: 0a 20 20 70 4c 6f 63 6b 20 3d 20 28 73 74 72 75  .  pLock = (stru
4590: 63 74 20 6c 6f 63 6b 49 6e 66 6f 2a 29 73 71 6c  ct lockInfo*)sql
45a0: 69 74 65 33 48 61 73 68 46 69 6e 64 28 26 6c 6f  ite3HashFind(&lo
45b0: 63 6b 48 61 73 68 2c 20 26 6b 65 79 31 2c 20 73  ckHash, &key1, s
45c0: 69 7a 65 6f 66 28 6b 65 79 31 29 29 3b 0a 20 20  izeof(key1));.  
45d0: 69 66 28 20 70 4c 6f 63 6b 3d 3d 30 20 29 7b 0a  if( pLock==0 ){.
45e0: 20 20 20 20 73 74 72 75 63 74 20 6c 6f 63 6b 49      struct lockI
45f0: 6e 66 6f 20 2a 70 4f 6c 64 3b 0a 20 20 20 20 70  nfo *pOld;.    p
4600: 4c 6f 63 6b 20 3d 20 73 71 6c 69 74 65 4d 61 6c  Lock = sqliteMal
4610: 6c 6f 63 52 61 77 28 20 73 69 7a 65 6f 66 28 2a  locRaw( sizeof(*
4620: 70 4c 6f 63 6b 29 20 29 3b 0a 20 20 20 20 69 66  pLock) );.    if
4630: 28 20 70 4c 6f 63 6b 3d 3d 30 20 29 20 72 65 74  ( pLock==0 ) ret
4640: 75 72 6e 20 31 3b 0a 20 20 20 20 70 4c 6f 63 6b  urn 1;.    pLock
4650: 2d 3e 6b 65 79 20 3d 20 6b 65 79 31 3b 0a 20 20  ->key = key1;.  
4660: 20 20 70 4c 6f 63 6b 2d 3e 6e 52 65 66 20 3d 20    pLock->nRef = 
4670: 31 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 63 6e  1;.    pLock->cn
4680: 74 20 3d 20 30 3b 0a 20 20 20 20 70 4c 6f 63 6b  t = 0;.    pLock
4690: 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 30 3b 0a  ->locktype = 0;.
46a0: 20 20 20 20 70 4f 6c 64 20 3d 20 73 71 6c 69 74      pOld = sqlit
46b0: 65 33 48 61 73 68 49 6e 73 65 72 74 28 26 6c 6f  e3HashInsert(&lo
46c0: 63 6b 48 61 73 68 2c 20 26 70 4c 6f 63 6b 2d 3e  ckHash, &pLock->
46d0: 6b 65 79 2c 20 73 69 7a 65 6f 66 28 6b 65 79 31  key, sizeof(key1
46e0: 29 2c 20 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 69  ), pLock);.    i
46f0: 66 28 20 70 4f 6c 64 21 3d 30 20 29 7b 0a 20 20  f( pOld!=0 ){.  
4700: 20 20 20 20 61 73 73 65 72 74 28 20 70 4f 6c 64      assert( pOld
4710: 3d 3d 70 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 20  ==pLock );.     
4720: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4c 6f 63   sqliteFree(pLoc
4730: 6b 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  k);.      return
4740: 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73   1;.    }.  }els
4750: 65 7b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 6e 52  e{.    pLock->nR
4760: 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 70 4c  ef++;.  }.  *ppL
4770: 6f 63 6b 20 3d 20 70 4c 6f 63 6b 3b 0a 20 20 70  ock = pLock;.  p
4780: 4f 70 65 6e 20 3d 20 28 73 74 72 75 63 74 20 6f  Open = (struct o
4790: 70 65 6e 43 6e 74 2a 29 73 71 6c 69 74 65 33 48  penCnt*)sqlite3H
47a0: 61 73 68 46 69 6e 64 28 26 6f 70 65 6e 48 61 73  ashFind(&openHas
47b0: 68 2c 20 26 6b 65 79 32 2c 20 73 69 7a 65 6f 66  h, &key2, sizeof
47c0: 28 6b 65 79 32 29 29 3b 0a 20 20 69 66 28 20 70  (key2));.  if( p
47d0: 4f 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 73  Open==0 ){.    s
47e0: 74 72 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70  truct openCnt *p
47f0: 4f 6c 64 3b 0a 20 20 20 20 70 4f 70 65 6e 20 3d  Old;.    pOpen =
4800: 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 52 61 77   sqliteMallocRaw
4810: 28 20 73 69 7a 65 6f 66 28 2a 70 4f 70 65 6e 29  ( sizeof(*pOpen)
4820: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 70 65   );.    if( pOpe
4830: 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65  n==0 ){.      re
4840: 6c 65 61 73 65 4c 6f 63 6b 49 6e 66 6f 28 70 4c  leaseLockInfo(pL
4850: 6f 63 6b 29 3b 0a 20 20 20 20 20 20 72 65 74 75  ock);.      retu
4860: 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20  rn 1;.    }.    
4870: 70 4f 70 65 6e 2d 3e 6b 65 79 20 3d 20 6b 65 79  pOpen->key = key
4880: 32 3b 0a 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 52  2;.    pOpen->nR
4890: 65 66 20 3d 20 31 3b 0a 20 20 20 20 70 4f 70 65  ef = 1;.    pOpe
48a0: 6e 2d 3e 6e 4c 6f 63 6b 20 3d 20 30 3b 0a 20 20  n->nLock = 0;.  
48b0: 20 20 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e    pOpen->nPendin
48c0: 67 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 65 6e  g = 0;.    pOpen
48d0: 2d 3e 61 50 65 6e 64 69 6e 67 20 3d 20 30 3b 0a  ->aPending = 0;.
48e0: 20 20 20 20 70 4f 6c 64 20 3d 20 73 71 6c 69 74      pOld = sqlit
48f0: 65 33 48 61 73 68 49 6e 73 65 72 74 28 26 6f 70  e3HashInsert(&op
4900: 65 6e 48 61 73 68 2c 20 26 70 4f 70 65 6e 2d 3e  enHash, &pOpen->
4910: 6b 65 79 2c 20 73 69 7a 65 6f 66 28 6b 65 79 32  key, sizeof(key2
4920: 29 2c 20 70 4f 70 65 6e 29 3b 0a 20 20 20 20 69  ), pOpen);.    i
4930: 66 28 20 70 4f 6c 64 21 3d 30 20 29 7b 0a 20 20  f( pOld!=0 ){.  
4940: 20 20 20 20 61 73 73 65 72 74 28 20 70 4f 6c 64      assert( pOld
4950: 3d 3d 70 4f 70 65 6e 20 29 3b 0a 20 20 20 20 20  ==pOpen );.     
4960: 20 73 71 6c 69 74 65 46 72 65 65 28 70 4f 70 65   sqliteFree(pOpe
4970: 6e 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73  n);.      releas
4980: 65 4c 6f 63 6b 49 6e 66 6f 28 70 4c 6f 63 6b 29  eLockInfo(pLock)
4990: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 31  ;.      return 1
49a0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
49b0: 0a 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 52 65 66  .    pOpen->nRef
49c0: 2b 2b 3b 0a 20 20 7d 0a 20 20 2a 70 70 4f 70 65  ++;.  }.  *ppOpe
49d0: 6e 20 3d 20 70 4f 70 65 6e 3b 0a 20 20 72 65 74  n = pOpen;.  ret
49e0: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
49f0: 44 65 6c 65 74 65 20 74 68 65 20 6e 61 6d 65 64  Delete the named
4a00: 20 66 69 6c 65 0a 2a 2f 0a 73 74 61 74 69 63 20   file.*/.static 
4a10: 69 6e 74 20 75 6e 69 78 44 65 6c 65 74 65 28 63  int unixDelete(c
4a20: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
4a30: 6e 61 6d 65 29 7b 0a 20 20 75 6e 6c 69 6e 6b 28  name){.  unlink(
4a40: 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 72 65  zFilename);.  re
4a50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
4a60: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
4a70: 54 52 55 45 20 69 66 20 74 68 65 20 6e 61 6d 65  TRUE if the name
4a80: 64 20 66 69 6c 65 20 65 78 69 73 74 73 2e 0a 2a  d file exists..*
4a90: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
4aa0: 78 46 69 6c 65 45 78 69 73 74 73 28 63 6f 6e 73  xFileExists(cons
4ab0: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d  t char *zFilenam
4ac0: 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 61 63 63  e){.  return acc
4ad0: 65 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 30  ess(zFilename, 0
4ae0: 29 3d 3d 30 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 77  )==0;.}../* Forw
4af0: 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20  ard declaration 
4b00: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 6c  */.static int al
4b10: 6c 6f 63 61 74 65 55 6e 69 78 46 69 6c 65 28 75  locateUnixFile(u
4b20: 6e 69 78 46 69 6c 65 20 2a 70 49 6e 69 74 2c 20  nixFile *pInit, 
4b30: 4f 73 46 69 6c 65 20 2a 2a 70 49 64 29 3b 0a 0a  OsFile **pId);..
4b40: 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f  /*.** Attempt to
4b50: 20 6f 70 65 6e 20 61 20 66 69 6c 65 20 66 6f 72   open a file for
4b60: 20 62 6f 74 68 20 72 65 61 64 69 6e 67 20 61 6e   both reading an
4b70: 64 20 77 72 69 74 69 6e 67 2e 20 20 49 66 20 74  d writing.  If t
4b80: 68 61 74 0a 2a 2a 20 66 61 69 6c 73 2c 20 74 72  hat.** fails, tr
4b90: 79 20 6f 70 65 6e 69 6e 67 20 69 74 20 72 65 61  y opening it rea
4ba0: 64 2d 6f 6e 6c 79 2e 20 20 49 66 20 74 68 65 20  d-only.  If the 
4bb0: 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 78  file does not ex
4bc0: 69 73 74 2c 0a 2a 2a 20 74 72 79 20 74 6f 20 63  ist,.** try to c
4bd0: 72 65 61 74 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20  reate it..**.** 
4be0: 4f 6e 20 73 75 63 63 65 73 73 2c 20 61 20 68 61  On success, a ha
4bf0: 6e 64 6c 65 20 66 6f 72 20 74 68 65 20 6f 70 65  ndle for the ope
4c00: 6e 20 66 69 6c 65 20 69 73 20 77 72 69 74 74 65  n file is writte
4c10: 6e 20 74 6f 20 2a 69 64 0a 2a 2a 20 61 6e 64 20  n to *id.** and 
4c20: 2a 70 52 65 61 64 6f 6e 6c 79 20 69 73 20 73 65  *pReadonly is se
4c30: 74 20 74 6f 20 30 20 69 66 20 74 68 65 20 66 69  t to 0 if the fi
4c40: 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 20 66 6f  le was opened fo
4c50: 72 20 72 65 61 64 69 6e 67 20 61 6e 64 0a 2a 2a  r reading and.**
4c60: 20 77 72 69 74 69 6e 67 20 6f 72 20 31 20 69 66   writing or 1 if
4c70: 20 74 68 65 20 66 69 6c 65 20 77 61 73 20 6f 70   the file was op
4c80: 65 6e 65 64 20 72 65 61 64 2d 6f 6e 6c 79 2e 20  ened read-only. 
4c90: 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65   The function re
4ca0: 74 75 72 6e 73 0a 2a 2a 20 53 51 4c 49 54 45 5f  turns.** SQLITE_
4cb0: 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69  OK..**.** On fai
4cc0: 6c 75 72 65 2c 20 74 68 65 20 66 75 6e 63 74 69  lure, the functi
4cd0: 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54  on returns SQLIT
4ce0: 45 5f 43 41 4e 54 4f 50 45 4e 20 61 6e 64 20 6c  E_CANTOPEN and l
4cf0: 65 61 76 65 73 0a 2a 2a 20 2a 69 64 20 61 6e 64  eaves.** *id and
4d00: 20 2a 70 52 65 61 64 6f 6e 6c 79 20 75 6e 63 68   *pReadonly unch
4d10: 61 6e 67 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  anged..*/.static
4d20: 20 69 6e 74 20 75 6e 69 78 4f 70 65 6e 52 65 61   int unixOpenRea
4d30: 64 57 72 69 74 65 28 0a 20 20 63 6f 6e 73 74 20  dWrite(.  const 
4d40: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c  char *zFilename,
4d50: 0a 20 20 4f 73 46 69 6c 65 20 2a 2a 70 49 64 2c  .  OsFile **pId,
4d60: 0a 20 20 69 6e 74 20 2a 70 52 65 61 64 6f 6e 6c  .  int *pReadonl
4d70: 79 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  y.){.  int rc;. 
4d80: 20 75 6e 69 78 46 69 6c 65 20 66 3b 0a 0a 20 20   unixFile f;..  
4d90: 61 73 73 65 72 74 28 20 30 3d 3d 2a 70 49 64 20  assert( 0==*pId 
4da0: 29 3b 0a 20 20 66 2e 64 69 72 66 64 20 3d 20 2d  );.  f.dirfd = -
4db0: 31 3b 0a 20 20 53 45 54 5f 54 48 52 45 41 44 49  1;.  SET_THREADI
4dc0: 44 28 26 66 29 3b 0a 20 20 66 2e 68 20 3d 20 6f  D(&f);.  f.h = o
4dd0: 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f  pen(zFilename, O
4de0: 5f 52 44 57 52 7c 4f 5f 43 52 45 41 54 7c 4f 5f  _RDWR|O_CREAT|O_
4df0: 4c 41 52 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41  LARGEFILE|O_BINA
4e00: 52 59 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  RY,.            
4e10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51                SQ
4e20: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c  LITE_DEFAULT_FIL
4e30: 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53 29 3b 0a  E_PERMISSIONS);.
4e40: 20 20 69 66 28 20 66 2e 68 3c 30 20 29 7b 0a 23    if( f.h<0 ){.#
4e50: 69 66 64 65 66 20 45 49 53 44 49 52 0a 20 20 20  ifdef EISDIR.   
4e60: 20 69 66 28 20 65 72 72 6e 6f 3d 3d 45 49 53 44   if( errno==EISD
4e70: 49 52 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  IR ){.      retu
4e80: 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50  rn SQLITE_CANTOP
4e90: 45 4e 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66  EN;.    }.#endif
4ea0: 0a 20 20 20 20 66 2e 68 20 3d 20 6f 70 65 6e 28  .    f.h = open(
4eb0: 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44 4f  zFilename, O_RDO
4ec0: 4e 4c 59 7c 4f 5f 4c 41 52 47 45 46 49 4c 45 7c  NLY|O_LARGEFILE|
4ed0: 4f 5f 42 49 4e 41 52 59 29 3b 0a 20 20 20 20 69  O_BINARY);.    i
4ee0: 66 28 20 66 2e 68 3c 30 20 29 7b 0a 20 20 20 20  f( f.h<0 ){.    
4ef0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
4f00: 43 41 4e 54 4f 50 45 4e 3b 20 0a 20 20 20 20 7d  CANTOPEN; .    }
4f10: 0a 20 20 20 20 2a 70 52 65 61 64 6f 6e 6c 79 20  .    *pReadonly 
4f20: 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = 1;.  }else{.  
4f30: 20 20 2a 70 52 65 61 64 6f 6e 6c 79 20 3d 20 30    *pReadonly = 0
4f40: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 4f  ;.  }.  sqlite3O
4f50: 73 2e 78 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  s.xEnterMutex();
4f60: 0a 20 20 72 63 20 3d 20 66 69 6e 64 4c 6f 63 6b  .  rc = findLock
4f70: 49 6e 66 6f 28 66 2e 68 2c 20 26 66 2e 70 4c 6f  Info(f.h, &f.pLo
4f80: 63 6b 2c 20 26 66 2e 70 4f 70 65 6e 29 3b 0a 20  ck, &f.pOpen);. 
4f90: 20 73 71 6c 69 74 65 33 4f 73 2e 78 4c 65 61 76   sqlite3Os.xLeav
4fa0: 65 4d 75 74 65 78 28 29 3b 0a 20 20 69 66 28 20  eMutex();.  if( 
4fb0: 72 63 20 29 7b 0a 20 20 20 20 63 6c 6f 73 65 28  rc ){.    close(
4fc0: 66 2e 68 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  f.h);.    return
4fd0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
4fe0: 20 7d 0a 20 20 66 2e 6c 6f 63 6b 74 79 70 65 20   }.  f.locktype 
4ff0: 3d 20 30 3b 0a 20 20 54 52 41 43 45 33 28 22 4f  = 0;.  TRACE3("O
5000: 50 45 4e 20 20 20 20 25 2d 33 64 20 25 73 5c 6e  PEN    %-3d %s\n
5010: 22 2c 20 66 2e 68 2c 20 7a 46 69 6c 65 6e 61 6d  ", f.h, zFilenam
5020: 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c  e);.  return all
5030: 6f 63 61 74 65 55 6e 69 78 46 69 6c 65 28 26 66  ocateUnixFile(&f
5040: 2c 20 70 49 64 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a  , pId);.}.../*.*
5050: 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 65  * Attempt to ope
5060: 6e 20 61 20 6e 65 77 20 66 69 6c 65 20 66 6f 72  n a new file for
5070: 20 65 78 63 6c 75 73 69 76 65 20 61 63 63 65 73   exclusive acces
5080: 73 20 62 79 20 74 68 69 73 20 70 72 6f 63 65 73  s by this proces
5090: 73 2e 0a 2a 2a 20 54 68 65 20 66 69 6c 65 20 77  s..** The file w
50a0: 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 20 66 6f  ill be opened fo
50b0: 72 20 62 6f 74 68 20 72 65 61 64 69 6e 67 20 61  r both reading a
50c0: 6e 64 20 77 72 69 74 69 6e 67 2e 20 20 54 6f 20  nd writing.  To 
50d0: 61 76 6f 69 64 0a 2a 2a 20 61 20 70 6f 74 65 6e  avoid.** a poten
50e0: 74 69 61 6c 20 73 65 63 75 72 69 74 79 20 70 72  tial security pr
50f0: 6f 62 6c 65 6d 2c 20 77 65 20 64 6f 20 6e 6f 74  oblem, we do not
5100: 20 61 6c 6c 6f 77 20 74 68 65 20 66 69 6c 65 20   allow the file 
5110: 74 6f 20 68 61 76 65 0a 2a 2a 20 70 72 65 76 69  to have.** previ
5120: 6f 75 73 6c 79 20 65 78 69 73 74 65 64 2e 20 20  ously existed.  
5130: 4e 6f 72 20 64 6f 20 77 65 20 61 6c 6c 6f 77 20  Nor do we allow 
5140: 74 68 65 20 66 69 6c 65 20 74 6f 20 62 65 20 61  the file to be a
5150: 20 73 79 6d 62 6f 6c 69 63 0a 2a 2a 20 6c 69 6e   symbolic.** lin
5160: 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 65 6c 46  k..**.** If delF
5170: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65  lag is true, the
5180: 6e 20 6d 61 6b 65 20 61 72 72 61 6e 67 65 6d 65  n make arrangeme
5190: 6e 74 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63  nts to automatic
51a0: 61 6c 6c 79 20 64 65 6c 65 74 65 0a 2a 2a 20 74  ally delete.** t
51b0: 68 65 20 66 69 6c 65 20 77 68 65 6e 20 69 74 20  he file when it 
51c0: 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a  is closed..**.**
51d0: 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 77 72 69   On success, wri
51e0: 74 65 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64  te the file hand
51f0: 6c 65 20 69 6e 74 6f 20 2a 69 64 20 61 6e 64 20  le into *id and 
5200: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
5210: 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75  ..**.** On failu
5220: 72 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54  re, return SQLIT
5230: 45 5f 43 41 4e 54 4f 50 45 4e 2e 0a 2a 2f 0a 73  E_CANTOPEN..*/.s
5240: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 4f 70  tatic int unixOp
5250: 65 6e 45 78 63 6c 75 73 69 76 65 28 63 6f 6e 73  enExclusive(cons
5260: 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d  t char *zFilenam
5270: 65 2c 20 4f 73 46 69 6c 65 20 2a 2a 70 49 64 2c  e, OsFile **pId,
5280: 20 69 6e 74 20 64 65 6c 46 6c 61 67 29 7b 0a 20   int delFlag){. 
5290: 20 69 6e 74 20 72 63 3b 0a 20 20 75 6e 69 78 46   int rc;.  unixF
52a0: 69 6c 65 20 66 3b 0a 0a 20 20 61 73 73 65 72 74  ile f;..  assert
52b0: 28 20 30 3d 3d 2a 70 49 64 20 29 3b 0a 20 20 69  ( 0==*pId );.  i
52c0: 66 28 20 61 63 63 65 73 73 28 7a 46 69 6c 65 6e  f( access(zFilen
52d0: 61 6d 65 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20  ame, 0)==0 ){.  
52e0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
52f0: 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20 20  CANTOPEN;.  }.  
5300: 53 45 54 5f 54 48 52 45 41 44 49 44 28 26 66 29  SET_THREADID(&f)
5310: 3b 0a 20 20 66 2e 64 69 72 66 64 20 3d 20 2d 31  ;.  f.dirfd = -1
5320: 3b 0a 20 20 66 2e 68 20 3d 20 6f 70 65 6e 28 7a  ;.  f.h = open(z
5330: 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20  Filename,.      
5340: 20 20 20 20 20 20 20 20 20 20 4f 5f 52 44 57 52            O_RDWR
5350: 7c 4f 5f 43 52 45 41 54 7c 4f 5f 45 58 43 4c 7c  |O_CREAT|O_EXCL|
5360: 4f 5f 4e 4f 46 4f 4c 4c 4f 57 7c 4f 5f 4c 41 52  O_NOFOLLOW|O_LAR
5370: 47 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52 59 2c  GEFILE|O_BINARY,
5380: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
5390: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f   SQLITE_DEFAULT_
53a0: 46 49 4c 45 5f 50 45 52 4d 49 53 53 49 4f 4e 53  FILE_PERMISSIONS
53b0: 29 3b 0a 20 20 69 66 28 20 66 2e 68 3c 30 20 29  );.  if( f.h<0 )
53c0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
53d0: 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20  ITE_CANTOPEN;.  
53e0: 7d 0a 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 45  }.  sqlite3Os.xE
53f0: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 72  nterMutex();.  r
5400: 63 20 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f  c = findLockInfo
5410: 28 66 2e 68 2c 20 26 66 2e 70 4c 6f 63 6b 2c 20  (f.h, &f.pLock, 
5420: 26 66 2e 70 4f 70 65 6e 29 3b 0a 20 20 73 71 6c  &f.pOpen);.  sql
5430: 69 74 65 33 4f 73 2e 78 4c 65 61 76 65 4d 75 74  ite3Os.xLeaveMut
5440: 65 78 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29  ex();.  if( rc )
5450: 7b 0a 20 20 20 20 63 6c 6f 73 65 28 66 2e 68 29  {.    close(f.h)
5460: 3b 0a 20 20 20 20 75 6e 6c 69 6e 6b 28 7a 46 69  ;.    unlink(zFi
5470: 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 72 65 74  lename);.    ret
5480: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
5490: 3b 0a 20 20 7d 0a 20 20 66 2e 6c 6f 63 6b 74 79  ;.  }.  f.lockty
54a0: 70 65 20 3d 20 30 3b 0a 20 20 69 66 28 20 64 65  pe = 0;.  if( de
54b0: 6c 46 6c 61 67 20 29 7b 0a 20 20 20 20 75 6e 6c  lFlag ){.    unl
54c0: 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a  ink(zFilename);.
54d0: 20 20 7d 0a 20 20 54 52 41 43 45 33 28 22 4f 50    }.  TRACE3("OP
54e0: 45 4e 2d 45 58 20 25 2d 33 64 20 25 73 5c 6e 22  EN-EX %-3d %s\n"
54f0: 2c 20 66 2e 68 2c 20 7a 46 69 6c 65 6e 61 6d 65  , f.h, zFilename
5500: 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 6c 6c 6f  );.  return allo
5510: 63 61 74 65 55 6e 69 78 46 69 6c 65 28 26 66 2c  cateUnixFile(&f,
5520: 20 70 49 64 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   pId);.}../*.** 
5530: 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20  Attempt to open 
5540: 61 20 6e 65 77 20 66 69 6c 65 20 66 6f 72 20 72  a new file for r
5550: 65 61 64 2d 6f 6e 6c 79 20 61 63 63 65 73 73 2e  ead-only access.
5560: 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 65 73  .**.** On succes
5570: 73 2c 20 77 72 69 74 65 20 74 68 65 20 66 69 6c  s, write the fil
5580: 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f 20 2a 69  e handle into *i
5590: 64 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c  d and return SQL
55a0: 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e  ITE_OK..**.** On
55b0: 20 66 61 69 6c 75 72 65 2c 20 72 65 74 75 72 6e   failure, return
55c0: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e   SQLITE_CANTOPEN
55d0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
55e0: 75 6e 69 78 4f 70 65 6e 52 65 61 64 4f 6e 6c 79  unixOpenReadOnly
55f0: 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69  (const char *zFi
5600: 6c 65 6e 61 6d 65 2c 20 4f 73 46 69 6c 65 20 2a  lename, OsFile *
5610: 2a 70 49 64 29 7b 0a 20 20 69 6e 74 20 72 63 3b  *pId){.  int rc;
5620: 0a 20 20 75 6e 69 78 46 69 6c 65 20 66 3b 0a 0a  .  unixFile f;..
5630: 20 20 61 73 73 65 72 74 28 20 30 3d 3d 2a 70 49    assert( 0==*pI
5640: 64 20 29 3b 0a 20 20 53 45 54 5f 54 48 52 45 41  d );.  SET_THREA
5650: 44 49 44 28 26 66 29 3b 0a 20 20 66 2e 64 69 72  DID(&f);.  f.dir
5660: 66 64 20 3d 20 2d 31 3b 0a 20 20 66 2e 68 20 3d  fd = -1;.  f.h =
5670: 20 6f 70 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c   open(zFilename,
5680: 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f 4c 41 52 47   O_RDONLY|O_LARG
5690: 45 46 49 4c 45 7c 4f 5f 42 49 4e 41 52 59 29 3b  EFILE|O_BINARY);
56a0: 0a 20 20 69 66 28 20 66 2e 68 3c 30 20 29 7b 0a  .  if( f.h<0 ){.
56b0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
56c0: 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a  E_CANTOPEN;.  }.
56d0: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 45 6e 74    sqlite3Os.xEnt
56e0: 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 72 63 20  erMutex();.  rc 
56f0: 3d 20 66 69 6e 64 4c 6f 63 6b 49 6e 66 6f 28 66  = findLockInfo(f
5700: 2e 68 2c 20 26 66 2e 70 4c 6f 63 6b 2c 20 26 66  .h, &f.pLock, &f
5710: 2e 70 4f 70 65 6e 29 3b 0a 20 20 73 71 6c 69 74  .pOpen);.  sqlit
5720: 65 33 4f 73 2e 78 4c 65 61 76 65 4d 75 74 65 78  e3Os.xLeaveMutex
5730: 28 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a  ();.  if( rc ){.
5740: 20 20 20 20 63 6c 6f 73 65 28 66 2e 68 29 3b 0a      close(f.h);.
5750: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
5760: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 66  E_NOMEM;.  }.  f
5770: 2e 6c 6f 63 6b 74 79 70 65 20 3d 20 30 3b 0a 20  .locktype = 0;. 
5780: 20 54 52 41 43 45 33 28 22 4f 50 45 4e 2d 52 4f   TRACE3("OPEN-RO
5790: 20 25 2d 33 64 20 25 73 5c 6e 22 2c 20 66 2e 68   %-3d %s\n", f.h
57a0: 2c 20 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 0a 20  , zFilename);.. 
57b0: 20 72 65 74 75 72 6e 20 61 6c 6c 6f 63 61 74 65   return allocate
57c0: 55 6e 69 78 46 69 6c 65 28 26 66 2c 20 70 49 64  UnixFile(&f, pId
57d0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65  );.}../*.** Atte
57e0: 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 66 69  mpt to open a fi
57f0: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 6f  le descriptor fo
5800: 72 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20  r the directory 
5810: 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 0a  that contains a.
5820: 2a 2a 20 66 69 6c 65 2e 20 20 54 68 69 73 20 66  ** file.  This f
5830: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 63  ile descriptor c
5840: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 66 73  an be used to fs
5850: 79 6e 63 28 29 20 74 68 65 20 64 69 72 65 63 74  ync() the direct
5860: 6f 72 79 0a 2a 2a 20 69 6e 20 6f 72 64 65 72 20  ory.** in order 
5870: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65  to make sure the
5880: 20 63 72 65 61 74 69 6f 6e 20 6f 66 20 61 20 6e   creation of a n
5890: 65 77 20 66 69 6c 65 20 69 73 20 61 63 74 75 61  ew file is actua
58a0: 6c 6c 79 20 77 72 69 74 74 65 6e 0a 2a 2a 20 74  lly written.** t
58b0: 6f 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68  o disk..**.** Th
58c0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6f 6e  is routine is on
58d0: 6c 79 20 6d 65 61 6e 69 6e 67 66 75 6c 20 66 6f  ly meaningful fo
58e0: 72 20 55 6e 69 78 2e 20 20 49 74 20 69 73 20 61  r Unix.  It is a
58f0: 20 6e 6f 2d 6f 70 20 75 6e 64 65 72 0a 2a 2a 20   no-op under.** 
5900: 77 69 6e 64 6f 77 73 20 73 69 6e 63 65 20 77 69  windows since wi
5910: 6e 64 6f 77 73 20 64 6f 65 73 20 6e 6f 74 20 73  ndows does not s
5920: 75 70 70 6f 72 74 20 68 61 72 64 20 6c 69 6e 6b  upport hard link
5930: 73 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63  s..**.** On succ
5940: 65 73 73 2c 20 61 20 68 61 6e 64 6c 65 20 66 6f  ess, a handle fo
5950: 72 20 61 20 70 72 65 76 69 6f 75 73 6c 79 20 6f  r a previously o
5960: 70 65 6e 20 66 69 6c 65 20 61 74 20 2a 69 64 20  pen file at *id 
5970: 69 73 0a 2a 2a 20 75 70 64 61 74 65 64 20 77 69  is.** updated wi
5980: 74 68 20 74 68 65 20 6e 65 77 20 64 69 72 65 63  th the new direc
5990: 74 6f 72 79 20 66 69 6c 65 20 64 65 73 63 72 69  tory file descri
59a0: 70 74 6f 72 20 61 6e 64 20 53 51 4c 49 54 45 5f  ptor and SQLITE_
59b0: 4f 4b 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65  OK is.** returne
59c0: 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c  d..**.** On fail
59d0: 75 72 65 2c 20 74 68 65 20 66 75 6e 63 74 69 6f  ure, the functio
59e0: 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45  n returns SQLITE
59f0: 5f 43 41 4e 54 4f 50 45 4e 20 61 6e 64 20 6c 65  _CANTOPEN and le
5a00: 61 76 65 73 0a 2a 2a 20 2a 69 64 20 75 6e 63 68  aves.** *id unch
5a10: 61 6e 67 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  anged..*/.static
5a20: 20 69 6e 74 20 75 6e 69 78 4f 70 65 6e 44 69 72   int unixOpenDir
5a30: 65 63 74 6f 72 79 28 0a 20 20 4f 73 46 69 6c 65  ectory(.  OsFile
5a40: 20 2a 69 64 2c 0a 20 20 63 6f 6e 73 74 20 63 68   *id,.  const ch
5a50: 61 72 20 2a 7a 44 69 72 6e 61 6d 65 0a 29 7b 0a  ar *zDirname.){.
5a60: 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46 69 6c    unixFile *pFil
5a70: 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a 29 69  e = (unixFile*)i
5a80: 64 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 3d 3d  d;.  if( pFile==
5a90: 30 20 29 7b 0a 20 20 20 20 2f 2a 20 44 6f 20 6e  0 ){.    /* Do n
5aa0: 6f 74 20 6f 70 65 6e 20 74 68 65 20 64 69 72 65  ot open the dire
5ab0: 63 74 6f 72 79 20 69 66 20 74 68 65 20 63 6f 72  ctory if the cor
5ac0: 72 65 73 70 6f 6e 64 69 6e 67 20 66 69 6c 65 20  responding file 
5ad0: 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 0a 20  is not already. 
5ae0: 20 20 20 2a 2a 20 6f 70 65 6e 2e 20 2a 2f 0a 20     ** open. */. 
5af0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
5b00: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20  _CANTOPEN;.  }. 
5b10: 20 53 45 54 5f 54 48 52 45 41 44 49 44 28 70 46   SET_THREADID(pF
5b20: 69 6c 65 29 3b 0a 20 20 61 73 73 65 72 74 28 20  ile);.  assert( 
5b30: 70 46 69 6c 65 2d 3e 64 69 72 66 64 3c 30 20 29  pFile->dirfd<0 )
5b40: 3b 0a 20 20 70 46 69 6c 65 2d 3e 64 69 72 66 64  ;.  pFile->dirfd
5b50: 20 3d 20 6f 70 65 6e 28 7a 44 69 72 6e 61 6d 65   = open(zDirname
5b60: 2c 20 4f 5f 52 44 4f 4e 4c 59 7c 4f 5f 42 49 4e  , O_RDONLY|O_BIN
5b70: 41 52 59 2c 20 30 29 3b 0a 20 20 69 66 28 20 70  ARY, 0);.  if( p
5b80: 46 69 6c 65 2d 3e 64 69 72 66 64 3c 30 20 29 7b  File->dirfd<0 ){
5b90: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
5ba0: 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a 20 20  TE_CANTOPEN; .  
5bb0: 7d 0a 20 20 54 52 41 43 45 33 28 22 4f 50 45 4e  }.  TRACE3("OPEN
5bc0: 44 49 52 20 25 2d 33 64 20 25 73 5c 6e 22 2c 20  DIR %-3d %s\n", 
5bd0: 70 46 69 6c 65 2d 3e 64 69 72 66 64 2c 20 7a 44  pFile->dirfd, zD
5be0: 69 72 6e 61 6d 65 29 3b 0a 20 20 72 65 74 75 72  irname);.  retur
5bf0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a  n SQLITE_OK;.}..
5c00: 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 6f 6c  /*.** If the fol
5c10: 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 61  lowing global va
5c20: 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 74 6f  riable points to
5c30: 20 61 20 73 74 72 69 6e 67 20 77 68 69 63 68 20   a string which 
5c40: 69 73 20 74 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f  is the.** name o
5c50: 66 20 61 20 64 69 72 65 63 74 6f 72 79 2c 20 74  f a directory, t
5c60: 68 65 6e 20 74 68 61 74 20 64 69 72 65 63 74 6f  hen that directo
5c70: 72 79 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20  ry will be used 
5c80: 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 65 6d 70  to store.** temp
5c90: 6f 72 61 72 79 20 66 69 6c 65 73 2e 0a 2a 2f 0a  orary files..*/.
5ca0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 74 65  char *sqlite3_te
5cb0: 6d 70 5f 64 69 72 65 63 74 6f 72 79 20 3d 20 30  mp_directory = 0
5cc0: 3b 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20  ;../*.** Create 
5cd0: 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65  a temporary file
5ce0: 20 6e 61 6d 65 20 69 6e 20 7a 42 75 66 2e 20 20   name in zBuf.  
5cf0: 7a 42 75 66 20 6d 75 73 74 20 62 65 20 62 69 67  zBuf must be big
5d00: 20 65 6e 6f 75 67 68 20 74 6f 0a 2a 2a 20 68 6f   enough to.** ho
5d10: 6c 64 20 61 74 20 6c 65 61 73 74 20 53 51 4c 49  ld at least SQLI
5d20: 54 45 5f 54 45 4d 50 4e 41 4d 45 5f 53 49 5a 45  TE_TEMPNAME_SIZE
5d30: 20 63 68 61 72 61 63 74 65 72 73 2e 0a 2a 2f 0a   characters..*/.
5d40: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 54  static int unixT
5d50: 65 6d 70 46 69 6c 65 4e 61 6d 65 28 63 68 61 72  empFileName(char
5d60: 20 2a 7a 42 75 66 29 7b 0a 20 20 73 74 61 74 69   *zBuf){.  stati
5d70: 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 61 7a  c const char *az
5d80: 44 69 72 73 5b 5d 20 3d 20 7b 0a 20 20 20 20 20  Dirs[] = {.     
5d90: 30 2c 0a 20 20 20 20 20 22 2f 76 61 72 2f 74 6d  0,.     "/var/tm
5da0: 70 22 2c 0a 20 20 20 20 20 22 2f 75 73 72 2f 74  p",.     "/usr/t
5db0: 6d 70 22 2c 0a 20 20 20 20 20 22 2f 74 6d 70 22  mp",.     "/tmp"
5dc0: 2c 0a 20 20 20 20 20 22 2e 22 2c 0a 20 20 7d 3b  ,.     ".",.  };
5dd0: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
5de0: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 7a 43  unsigned char zC
5df0: 68 61 72 73 5b 5d 20 3d 0a 20 20 20 20 22 61 62  hars[] =.    "ab
5e00: 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f 70 71 72  cdefghijklmnopqr
5e10: 73 74 75 76 77 78 79 7a 22 0a 20 20 20 20 22 41  stuvwxyz".    "A
5e20: 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f 50 51  BCDEFGHIJKLMNOPQ
5e30: 52 53 54 55 56 57 58 59 5a 22 0a 20 20 20 20 22  RSTUVWXYZ".    "
5e40: 30 31 32 33 34 35 36 37 38 39 22 3b 0a 20 20 69  0123456789";.  i
5e50: 6e 74 20 69 2c 20 6a 3b 0a 20 20 73 74 72 75 63  nt i, j;.  struc
5e60: 74 20 73 74 61 74 20 62 75 66 3b 0a 20 20 63 6f  t stat buf;.  co
5e70: 6e 73 74 20 63 68 61 72 20 2a 7a 44 69 72 20 3d  nst char *zDir =
5e80: 20 22 2e 22 3b 0a 20 20 61 7a 44 69 72 73 5b 30   ".";.  azDirs[0
5e90: 5d 20 3d 20 73 71 6c 69 74 65 33 5f 74 65 6d 70  ] = sqlite3_temp
5ea0: 5f 64 69 72 65 63 74 6f 72 79 3b 0a 20 20 66 6f  _directory;.  fo
5eb0: 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28  r(i=0; i<sizeof(
5ec0: 61 7a 44 69 72 73 29 2f 73 69 7a 65 6f 66 28 61  azDirs)/sizeof(a
5ed0: 7a 44 69 72 73 5b 30 5d 29 3b 20 69 2b 2b 29 7b  zDirs[0]); i++){
5ee0: 0a 20 20 20 20 69 66 28 20 61 7a 44 69 72 73 5b  .    if( azDirs[
5ef0: 69 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65  i]==0 ) continue
5f00: 3b 0a 20 20 20 20 69 66 28 20 73 74 61 74 28 61  ;.    if( stat(a
5f10: 7a 44 69 72 73 5b 69 5d 2c 20 26 62 75 66 29 20  zDirs[i], &buf) 
5f20: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20  ) continue;.    
5f30: 69 66 28 20 21 53 5f 49 53 44 49 52 28 62 75 66  if( !S_ISDIR(buf
5f40: 2e 73 74 5f 6d 6f 64 65 29 20 29 20 63 6f 6e 74  .st_mode) ) cont
5f50: 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 61 63  inue;.    if( ac
5f60: 63 65 73 73 28 61 7a 44 69 72 73 5b 69 5d 2c 20  cess(azDirs[i], 
5f70: 30 37 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  07) ) continue;.
5f80: 20 20 20 20 7a 44 69 72 20 3d 20 61 7a 44 69 72      zDir = azDir
5f90: 73 5b 69 5d 3b 0a 20 20 20 20 62 72 65 61 6b 3b  s[i];.    break;
5fa0: 0a 20 20 7d 0a 20 20 64 6f 7b 0a 20 20 20 20 73  .  }.  do{.    s
5fb0: 70 72 69 6e 74 66 28 7a 42 75 66 2c 20 22 25 73  printf(zBuf, "%s
5fc0: 2f 22 54 45 4d 50 5f 46 49 4c 45 5f 50 52 45 46  /"TEMP_FILE_PREF
5fd0: 49 58 2c 20 7a 44 69 72 29 3b 0a 20 20 20 20 6a  IX, zDir);.    j
5fe0: 20 3d 20 73 74 72 6c 65 6e 28 7a 42 75 66 29 3b   = strlen(zBuf);
5ff0: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 61 6e 64  .    sqlite3Rand
6000: 6f 6d 6e 65 73 73 28 31 35 2c 20 26 7a 42 75 66  omness(15, &zBuf
6010: 5b 6a 5d 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d  [j]);.    for(i=
6020: 30 3b 20 69 3c 31 35 3b 20 69 2b 2b 2c 20 6a 2b  0; i<15; i++, j+
6030: 2b 29 7b 0a 20 20 20 20 20 20 7a 42 75 66 5b 6a  +){.      zBuf[j
6040: 5d 20 3d 20 28 63 68 61 72 29 7a 43 68 61 72 73  ] = (char)zChars
6050: 5b 20 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61  [ ((unsigned cha
6060: 72 29 7a 42 75 66 5b 6a 5d 29 25 28 73 69 7a 65  r)zBuf[j])%(size
6070: 6f 66 28 7a 43 68 61 72 73 29 2d 31 29 20 5d 3b  of(zChars)-1) ];
6080: 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66 5b  .    }.    zBuf[
6090: 6a 5d 20 3d 20 30 3b 0a 20 20 7d 77 68 69 6c 65  j] = 0;.  }while
60a0: 28 20 61 63 63 65 73 73 28 7a 42 75 66 2c 30 29  ( access(zBuf,0)
60b0: 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  ==0 );.  return 
60c0: 53 51 4c 49 54 45 5f 4f 4b 3b 20 0a 7d 0a 0a 2f  SQLITE_OK; .}../
60d0: 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68 61 74 20  *.** Check that 
60e0: 61 20 67 69 76 65 6e 20 70 61 74 68 6e 61 6d 65  a given pathname
60f0: 20 69 73 20 61 20 64 69 72 65 63 74 6f 72 79 20   is a directory 
6100: 61 6e 64 20 69 73 20 77 72 69 74 61 62 6c 65 20  and is writable 
6110: 0a 2a 2a 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  .**.*/.static in
6120: 74 20 75 6e 69 78 49 73 44 69 72 57 72 69 74 61  t unixIsDirWrita
6130: 62 6c 65 28 63 68 61 72 20 2a 7a 42 75 66 29 7b  ble(char *zBuf){
6140: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
6150: 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d  OMIT_PAGER_PRAGM
6160: 41 53 0a 20 20 73 74 72 75 63 74 20 73 74 61 74  AS.  struct stat
6170: 20 62 75 66 3b 0a 20 20 69 66 28 20 7a 42 75 66   buf;.  if( zBuf
6180: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  ==0 ) return 0;.
6190: 20 20 69 66 28 20 7a 42 75 66 5b 30 5d 3d 3d 30    if( zBuf[0]==0
61a0: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69   ) return 0;.  i
61b0: 66 28 20 73 74 61 74 28 7a 42 75 66 2c 20 26 62  f( stat(zBuf, &b
61c0: 75 66 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  uf) ) return 0;.
61d0: 20 20 69 66 28 20 21 53 5f 49 53 44 49 52 28 62    if( !S_ISDIR(b
61e0: 75 66 2e 73 74 5f 6d 6f 64 65 29 20 29 20 72 65  uf.st_mode) ) re
61f0: 74 75 72 6e 20 30 3b 0a 20 20 69 66 28 20 61 63  turn 0;.  if( ac
6200: 63 65 73 73 28 7a 42 75 66 2c 20 30 37 29 20 29  cess(zBuf, 07) )
6210: 20 72 65 74 75 72 6e 20 30 3b 0a 23 65 6e 64 69   return 0;.#endi
6220: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
6230: 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 20 2a  _PAGER_PRAGMAS *
6240: 2f 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a  /.  return 1;.}.
6250: 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 64 61 74 61  ./*.** Read data
6260: 20 66 72 6f 6d 20 61 20 66 69 6c 65 20 69 6e 74   from a file int
6270: 6f 20 61 20 62 75 66 66 65 72 2e 20 20 52 65 74  o a buffer.  Ret
6280: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66  urn SQLITE_OK if
6290: 20 61 6c 6c 0a 2a 2a 20 62 79 74 65 73 20 77 65   all.** bytes we
62a0: 72 65 20 72 65 61 64 20 73 75 63 63 65 73 73 66  re read successf
62b0: 75 6c 6c 79 20 61 6e 64 20 53 51 4c 49 54 45 5f  ully and SQLITE_
62c0: 49 4f 45 52 52 20 69 66 20 61 6e 79 74 68 69 6e  IOERR if anythin
62d0: 67 20 67 6f 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e  g goes.** wrong.
62e0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
62f0: 6e 69 78 52 65 61 64 28 4f 73 46 69 6c 65 20 2a  nixRead(OsFile *
6300: 69 64 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c 20  id, void *pBuf, 
6310: 69 6e 74 20 61 6d 74 29 7b 0a 20 20 69 6e 74 20  int amt){.  int 
6320: 67 6f 74 3b 0a 20 20 61 73 73 65 72 74 28 20 69  got;.  assert( i
6330: 64 20 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49  d );.  SimulateI
6340: 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f  OError(SQLITE_IO
6350: 45 52 52 29 3b 0a 20 20 54 49 4d 45 52 5f 53 54  ERR);.  TIMER_ST
6360: 41 52 54 3b 0a 20 20 67 6f 74 20 3d 20 72 65 61  ART;.  got = rea
6370: 64 28 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64  d(((unixFile*)id
6380: 29 2d 3e 68 2c 20 70 42 75 66 2c 20 61 6d 74 29  )->h, pBuf, amt)
6390: 3b 0a 20 20 54 49 4d 45 52 5f 45 4e 44 3b 0a 20  ;.  TIMER_END;. 
63a0: 20 54 52 41 43 45 35 28 22 52 45 41 44 20 20 20   TRACE5("READ   
63b0: 20 25 2d 33 64 20 25 35 64 20 25 37 64 20 25 64   %-3d %5d %7d %d
63c0: 5c 6e 22 2c 20 28 28 75 6e 69 78 46 69 6c 65 2a  \n", ((unixFile*
63d0: 29 69 64 29 2d 3e 68 2c 20 67 6f 74 2c 0a 20 20  )id)->h, got,.  
63e0: 20 20 20 20 20 20 20 20 6c 61 73 74 5f 70 61 67          last_pag
63f0: 65 2c 20 54 49 4d 45 52 5f 45 4c 41 50 53 45 44  e, TIMER_ELAPSED
6400: 29 3b 0a 20 20 53 45 45 4b 28 30 29 3b 0a 20 20  );.  SEEK(0);.  
6410: 2f 2a 20 69 66 28 20 67 6f 74 3c 30 20 29 20 67  /* if( got<0 ) g
6420: 6f 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 69 66 28  ot = 0; */.  if(
6430: 20 67 6f 74 3d 3d 61 6d 74 20 29 7b 0a 20 20 20   got==amt ){.   
6440: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
6450: 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  K;.  }else{.    
6460: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f  return SQLITE_IO
6470: 45 52 52 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  ERR;.  }.}../*.*
6480: 2a 20 57 72 69 74 65 20 64 61 74 61 20 66 72 6f  * Write data fro
6490: 6d 20 61 20 62 75 66 66 65 72 20 69 6e 74 6f 20  m a buffer into 
64a0: 61 20 66 69 6c 65 2e 20 20 52 65 74 75 72 6e 20  a file.  Return 
64b0: 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63  SQLITE_OK on suc
64c0: 63 65 73 73 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20  cess.** or some 
64d0: 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65  other error code
64e0: 20 6f 6e 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a   on failure..*/.
64f0: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 57  static int unixW
6500: 72 69 74 65 28 4f 73 46 69 6c 65 20 2a 69 64 2c  rite(OsFile *id,
6510: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 42 75   const void *pBu
6520: 66 2c 20 69 6e 74 20 61 6d 74 29 7b 0a 20 20 69  f, int amt){.  i
6530: 6e 74 20 77 72 6f 74 65 20 3d 20 30 3b 0a 20 20  nt wrote = 0;.  
6540: 61 73 73 65 72 74 28 20 69 64 20 29 3b 0a 20 20  assert( id );.  
6550: 61 73 73 65 72 74 28 20 61 6d 74 3e 30 20 29 3b  assert( amt>0 );
6560: 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72  .  SimulateIOErr
6570: 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29  or(SQLITE_IOERR)
6580: 3b 0a 20 20 53 69 6d 75 6c 61 74 65 44 69 73 6b  ;.  SimulateDisk
6590: 66 75 6c 6c 45 72 72 6f 72 3b 0a 20 20 54 49 4d  fullError;.  TIM
65a0: 45 52 5f 53 54 41 52 54 3b 0a 20 20 77 68 69 6c  ER_START;.  whil
65b0: 65 28 20 61 6d 74 3e 30 20 26 26 20 28 77 72 6f  e( amt>0 && (wro
65c0: 74 65 20 3d 20 77 72 69 74 65 28 28 28 75 6e 69  te = write(((uni
65d0: 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 70  xFile*)id)->h, p
65e0: 42 75 66 2c 20 61 6d 74 29 29 3e 30 20 29 7b 0a  Buf, amt))>0 ){.
65f0: 20 20 20 20 61 6d 74 20 2d 3d 20 77 72 6f 74 65      amt -= wrote
6600: 3b 0a 20 20 20 20 70 42 75 66 20 3d 20 26 28 28  ;.    pBuf = &((
6610: 63 68 61 72 2a 29 70 42 75 66 29 5b 77 72 6f 74  char*)pBuf)[wrot
6620: 65 5d 3b 0a 20 20 7d 0a 20 20 54 49 4d 45 52 5f  e];.  }.  TIMER_
6630: 45 4e 44 3b 0a 20 20 54 52 41 43 45 35 28 22 57  END;.  TRACE5("W
6640: 52 49 54 45 20 20 20 25 2d 33 64 20 25 35 64 20  RITE   %-3d %5d 
6650: 25 37 64 20 25 64 5c 6e 22 2c 20 28 28 75 6e 69  %7d %d\n", ((uni
6660: 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 77  xFile*)id)->h, w
6670: 72 6f 74 65 2c 0a 20 20 20 20 20 20 20 20 20 20  rote,.          
6680: 6c 61 73 74 5f 70 61 67 65 2c 20 54 49 4d 45 52  last_page, TIMER
6690: 5f 45 4c 41 50 53 45 44 29 3b 0a 20 20 53 45 45  _ELAPSED);.  SEE
66a0: 4b 28 30 29 3b 0a 20 20 69 66 28 20 61 6d 74 3e  K(0);.  if( amt>
66b0: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
66c0: 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 7d  SQLITE_FULL;.  }
66d0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
66e0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f  _OK;.}../*.** Mo
66f0: 76 65 20 74 68 65 20 72 65 61 64 2f 77 72 69 74  ve the read/writ
6700: 65 20 70 6f 69 6e 74 65 72 20 69 6e 20 61 20 66  e pointer in a f
6710: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
6720: 6e 74 20 75 6e 69 78 53 65 65 6b 28 4f 73 46 69  nt unixSeek(OsFi
6730: 6c 65 20 2a 69 64 2c 20 69 36 34 20 6f 66 66 73  le *id, i64 offs
6740: 65 74 29 7b 0a 20 20 61 73 73 65 72 74 28 20 69  et){.  assert( i
6750: 64 20 29 3b 0a 20 20 53 45 45 4b 28 6f 66 66 73  d );.  SEEK(offs
6760: 65 74 2f 31 30 32 34 20 2b 20 31 29 3b 0a 23 69  et/1024 + 1);.#i
6770: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
6780: 0a 20 20 69 66 28 20 6f 66 66 73 65 74 20 29 20  .  if( offset ) 
6790: 53 69 6d 75 6c 61 74 65 44 69 73 6b 66 75 6c 6c  SimulateDiskfull
67a0: 45 72 72 6f 72 0a 23 65 6e 64 69 66 0a 20 20 6c  Error.#endif.  l
67b0: 73 65 65 6b 28 28 28 75 6e 69 78 46 69 6c 65 2a  seek(((unixFile*
67c0: 29 69 64 29 2d 3e 68 2c 20 6f 66 66 73 65 74 2c  )id)->h, offset,
67d0: 20 53 45 45 4b 5f 53 45 54 29 3b 0a 20 20 72 65   SEEK_SET);.  re
67e0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
67f0: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
6800: 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 43 6f 75 6e  _TEST./*.** Coun
6810: 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  t the number of 
6820: 66 75 6c 6c 73 79 6e 63 73 20 61 6e 64 20 6e 6f  fullsyncs and no
6830: 72 6d 61 6c 20 73 79 6e 63 73 2e 20 20 54 68 69  rmal syncs.  Thi
6840: 73 20 69 73 20 75 73 65 64 20 74 6f 20 74 65 73  s is used to tes
6850: 74 0a 2a 2a 20 74 68 61 74 20 73 79 6e 63 73 20  t.** that syncs 
6860: 61 6e 64 20 66 75 6c 6c 73 79 6e 63 73 20 61 72  and fullsyncs ar
6870: 65 20 6f 63 63 75 72 69 6e 67 20 61 74 20 74 68  e occuring at th
6880: 65 20 72 69 67 68 74 20 74 69 6d 65 73 2e 0a 2a  e right times..*
6890: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 79  /.int sqlite3_sy
68a0: 6e 63 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 69 6e  nc_count = 0;.in
68b0: 74 20 73 71 6c 69 74 65 33 5f 66 75 6c 6c 73 79  t sqlite3_fullsy
68c0: 6e 63 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 23 65  nc_count = 0;.#e
68d0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 55 73 65 20  ndif../*.** Use 
68e0: 74 68 65 20 66 64 61 74 61 73 79 6e 63 28 29 20  the fdatasync() 
68f0: 41 50 49 20 6f 6e 6c 79 20 69 66 20 74 68 65 20  API only if the 
6900: 48 41 56 45 5f 46 44 41 54 41 53 59 4e 43 20 6d  HAVE_FDATASYNC m
6910: 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2e  acro is defined.
6920: 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 20 75 73  .** Otherwise us
6930: 65 20 66 73 79 6e 63 28 29 20 69 6e 20 69 74 73  e fsync() in its
6940: 20 70 6c 61 63 65 2e 0a 2a 2f 0a 23 69 66 6e 64   place..*/.#ifnd
6950: 65 66 20 48 41 56 45 5f 46 44 41 54 41 53 59 4e  ef HAVE_FDATASYN
6960: 43 0a 23 20 64 65 66 69 6e 65 20 66 64 61 74 61  C.# define fdata
6970: 73 79 6e 63 20 66 73 79 6e 63 0a 23 65 6e 64 69  sync fsync.#endi
6980: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 73  f.../*.** The fs
6990: 79 6e 63 28 29 20 73 79 73 74 65 6d 20 63 61 6c  ync() system cal
69a0: 6c 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20  l does not work 
69b0: 61 73 20 61 64 76 65 72 74 69 73 65 64 20 6f 6e  as advertised on
69c0: 20 6d 61 6e 79 0a 2a 2a 20 75 6e 69 78 20 73 79   many.** unix sy
69d0: 73 74 65 6d 73 2e 20 20 54 68 65 20 66 6f 6c 6c  stems.  The foll
69e0: 6f 77 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20  owing procedure 
69f0: 69 73 20 61 6e 20 61 74 74 65 6d 70 74 20 74 6f  is an attempt to
6a00: 20 6d 61 6b 65 0a 2a 2a 20 69 74 20 77 6f 72 6b   make.** it work
6a10: 20 62 65 74 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54   better..**.** T
6a20: 68 65 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e  he SQLITE_NO_SYN
6a30: 43 20 6d 61 63 72 6f 20 64 69 73 61 62 6c 65 73  C macro disables
6a40: 20 61 6c 6c 20 66 73 79 6e 63 28 29 73 2e 20 20   all fsync()s.  
6a50: 54 68 69 73 20 69 73 20 75 73 65 66 75 6c 0a 2a  This is useful.*
6a60: 2a 20 66 6f 72 20 74 65 73 74 69 6e 67 20 77 68  * for testing wh
6a70: 65 6e 20 77 65 20 77 61 6e 74 20 74 6f 20 72 75  en we want to ru
6a80: 6e 20 74 68 72 6f 75 67 68 20 74 68 65 20 74 65  n through the te
6a90: 73 74 20 73 75 69 74 65 20 71 75 69 63 6b 6c 79  st suite quickly
6aa0: 2e 0a 2a 2a 20 59 6f 75 20 61 72 65 20 73 74 72  ..** You are str
6ab0: 6f 6e 67 6c 79 20 61 64 76 69 73 65 64 20 2a 6e  ongly advised *n
6ac0: 6f 74 2a 20 74 6f 20 64 65 70 6c 6f 79 20 77 69  ot* to deploy wi
6ad0: 74 68 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e  th SQLITE_NO_SYN
6ae0: 43 0a 2a 2a 20 65 6e 61 62 6c 65 64 2c 20 68 6f  C.** enabled, ho
6af0: 77 65 76 65 72 2c 20 73 69 6e 63 65 20 77 69 74  wever, since wit
6b00: 68 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43  h SQLITE_NO_SYNC
6b10: 20 65 6e 61 62 6c 65 64 2c 20 61 6e 20 4f 53 20   enabled, an OS 
6b20: 63 72 61 73 68 0a 2a 2a 20 6f 72 20 70 6f 77 65  crash.** or powe
6b30: 72 20 66 61 69 6c 75 72 65 20 77 69 6c 6c 20 6c  r failure will l
6b40: 69 6b 65 6c 79 20 63 6f 72 72 75 70 74 20 74 68  ikely corrupt th
6b50: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
6b60: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66  .*/.static int f
6b70: 75 6c 6c 5f 66 73 79 6e 63 28 69 6e 74 20 66 64  ull_fsync(int fd
6b80: 2c 20 69 6e 74 20 66 75 6c 6c 53 79 6e 63 2c 20  , int fullSync, 
6b90: 69 6e 74 20 64 61 74 61 4f 6e 6c 79 29 7b 0a 20  int dataOnly){. 
6ba0: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 20 52   int rc;..  /* R
6bb0: 65 63 6f 72 64 20 74 68 65 20 6e 75 6d 62 65 72  ecord the number
6bc0: 20 6f 66 20 74 69 6d 65 73 20 74 68 61 74 20 77   of times that w
6bd0: 65 20 64 6f 20 61 20 6e 6f 72 6d 61 6c 20 66 73  e do a normal fs
6be0: 79 6e 63 28 29 20 61 6e 64 20 0a 20 20 2a 2a 20  ync() and .  ** 
6bf0: 46 55 4c 4c 53 59 4e 43 2e 20 20 54 68 69 73 20  FULLSYNC.  This 
6c00: 69 73 20 75 73 65 64 20 64 75 72 69 6e 67 20 74  is used during t
6c10: 65 73 74 69 6e 67 20 74 6f 20 76 65 72 69 66 79  esting to verify
6c20: 20 74 68 61 74 20 74 68 69 73 20 70 72 6f 63 65   that this proce
6c30: 64 75 72 65 0a 20 20 2a 2a 20 67 65 74 73 20 63  dure.  ** gets c
6c40: 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 63  alled with the c
6c50: 6f 72 72 65 63 74 20 61 72 67 75 6d 65 6e 74 73  orrect arguments
6c60: 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51  ..  */.#ifdef SQ
6c70: 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 66 28 20  LITE_TEST.  if( 
6c80: 66 75 6c 6c 53 79 6e 63 20 29 20 73 71 6c 69 74  fullSync ) sqlit
6c90: 65 33 5f 66 75 6c 6c 73 79 6e 63 5f 63 6f 75 6e  e3_fullsync_coun
6ca0: 74 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73  t++;.  sqlite3_s
6cb0: 79 6e 63 5f 63 6f 75 6e 74 2b 2b 3b 0a 23 65 6e  ync_count++;.#en
6cc0: 64 69 66 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20  dif..  /* If we 
6cd0: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68  compiled with th
6ce0: 65 20 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43  e SQLITE_NO_SYNC
6cf0: 20 66 6c 61 67 2c 20 74 68 65 6e 20 73 79 6e 63   flag, then sync
6d00: 69 6e 67 20 69 73 20 61 0a 20 20 2a 2a 20 6e 6f  ing is a.  ** no
6d10: 2d 6f 70 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20  -op.  */.#ifdef 
6d20: 53 51 4c 49 54 45 5f 4e 4f 5f 53 59 4e 43 0a 20  SQLITE_NO_SYNC. 
6d30: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
6d40: 0a 23 65 6c 73 65 0a 0a 23 69 66 64 65 66 20 46  .#else..#ifdef F
6d50: 5f 46 55 4c 4c 46 53 59 4e 43 0a 20 20 69 66 28  _FULLFSYNC.  if(
6d60: 20 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 20   fullSync ){.   
6d70: 20 72 63 20 3d 20 66 63 6e 74 6c 28 66 64 2c 20   rc = fcntl(fd, 
6d80: 46 5f 46 55 4c 4c 46 53 59 4e 43 2c 20 30 29 3b  F_FULLFSYNC, 0);
6d90: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63  .  }else{.    rc
6da0: 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 2f 2a 20 49   = 1;.  }.  /* I
6db0: 66 20 74 68 65 20 46 55 4c 4c 53 59 4e 43 20 66  f the FULLSYNC f
6dc0: 61 69 6c 65 64 2c 20 74 72 79 20 74 6f 20 64 6f  ailed, try to do
6dd0: 20 61 20 6e 6f 72 6d 61 6c 20 66 73 79 6e 63 28   a normal fsync(
6de0: 29 20 2a 2f 0a 20 20 69 66 28 20 72 63 20 29 20  ) */.  if( rc ) 
6df0: 72 63 20 3d 20 66 73 79 6e 63 28 66 64 29 3b 0a  rc = fsync(fd);.
6e00: 0a 23 65 6c 73 65 20 2f 2a 20 69 66 20 21 64 65  .#else /* if !de
6e10: 66 69 6e 65 64 28 46 5f 46 55 4c 4c 53 59 4e 43  fined(F_FULLSYNC
6e20: 29 20 2a 2f 0a 20 20 69 66 28 20 64 61 74 61 4f  ) */.  if( dataO
6e30: 6e 6c 79 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  nly ){.    rc = 
6e40: 66 64 61 74 61 73 79 6e 63 28 66 64 29 3b 0a 20  fdatasync(fd);. 
6e50: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
6e60: 20 66 73 79 6e 63 28 66 64 29 3b 0a 20 20 7d 0a   fsync(fd);.  }.
6e70: 23 65 6e 64 69 66 20 2f 2a 20 64 65 66 69 6e 65  #endif /* define
6e80: 64 28 46 5f 46 55 4c 4c 46 53 59 4e 43 29 20 2a  d(F_FULLFSYNC) *
6e90: 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 64 65 66 69  /.#endif /* defi
6ea0: 6e 65 64 28 53 51 4c 49 54 45 5f 4e 4f 5f 53 59  ned(SQLITE_NO_SY
6eb0: 4e 43 29 20 2a 2f 0a 0a 20 20 72 65 74 75 72 6e  NC) */..  return
6ec0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61   rc;.}../*.** Ma
6ed0: 6b 65 20 73 75 72 65 20 61 6c 6c 20 77 72 69 74  ke sure all writ
6ee0: 65 73 20 74 6f 20 61 20 70 61 72 74 69 63 75 6c  es to a particul
6ef0: 61 72 20 66 69 6c 65 20 61 72 65 20 63 6f 6d 6d  ar file are comm
6f00: 69 74 74 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a  itted to disk..*
6f10: 2a 0a 2a 2a 20 49 66 20 64 61 74 61 4f 6e 6c 79  *.** If dataOnly
6f20: 3d 3d 30 20 74 68 65 6e 20 62 6f 74 68 20 74 68  ==0 then both th
6f30: 65 20 66 69 6c 65 20 69 74 73 65 6c 66 20 61 6e  e file itself an
6f40: 64 20 69 74 73 20 6d 65 74 61 64 61 74 61 20 28  d its metadata (
6f50: 66 69 6c 65 0a 2a 2a 20 73 69 7a 65 2c 20 61 63  file.** size, ac
6f60: 63 65 73 73 20 74 69 6d 65 2c 20 65 74 63 29 20  cess time, etc) 
6f70: 61 72 65 20 73 79 6e 63 65 64 2e 20 20 49 66 20  are synced.  If 
6f80: 64 61 74 61 4f 6e 6c 79 21 3d 30 20 74 68 65 6e  dataOnly!=0 then
6f90: 20 6f 6e 6c 79 20 74 68 65 0a 2a 2a 20 66 69 6c   only the.** fil
6fa0: 65 20 64 61 74 61 20 69 73 20 73 79 6e 63 65 64  e data is synced
6fb0: 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64 65 72 20 55 6e  ..**.** Under Un
6fc0: 69 78 2c 20 61 6c 73 6f 20 6d 61 6b 65 20 73 75  ix, also make su
6fd0: 72 65 20 74 68 61 74 20 74 68 65 20 64 69 72 65  re that the dire
6fe0: 63 74 6f 72 79 20 65 6e 74 72 79 20 66 6f 72 20  ctory entry for 
6ff0: 74 68 65 20 66 69 6c 65 0a 2a 2a 20 68 61 73 20  the file.** has 
7000: 62 65 65 6e 20 63 72 65 61 74 65 64 20 62 79 20  been created by 
7010: 66 73 79 6e 63 2d 69 6e 67 20 74 68 65 20 64 69  fsync-ing the di
7020: 72 65 63 74 6f 72 79 20 74 68 61 74 20 63 6f 6e  rectory that con
7030: 74 61 69 6e 73 20 74 68 65 20 66 69 6c 65 2e 0a  tains the file..
7040: 2a 2a 20 49 66 20 77 65 20 64 6f 20 6e 6f 74 20  ** If we do not 
7050: 64 6f 20 74 68 69 73 20 61 6e 64 20 77 65 20 65  do this and we e
7060: 6e 63 6f 75 6e 74 65 72 20 61 20 70 6f 77 65 72  ncounter a power
7070: 20 66 61 69 6c 75 72 65 2c 20 74 68 65 20 64 69   failure, the di
7080: 72 65 63 74 6f 72 79 0a 2a 2a 20 65 6e 74 72 79  rectory.** entry
7090: 20 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c   for the journal
70a0: 20 6d 69 67 68 74 20 6e 6f 74 20 65 78 69 73 74   might not exist
70b0: 20 61 66 74 65 72 20 77 65 20 72 65 62 6f 6f 74   after we reboot
70c0: 2e 20 20 54 68 65 20 6e 65 78 74 0a 2a 2a 20 53  .  The next.** S
70d0: 51 4c 69 74 65 20 74 6f 20 61 63 63 65 73 73 20  QLite to access 
70e0: 74 68 65 20 66 69 6c 65 20 77 69 6c 6c 20 6e 6f  the file will no
70f0: 74 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 20  t know that the 
7100: 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 20 28  journal exists (
7110: 62 65 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 64  because.** the d
7120: 69 72 65 63 74 6f 72 79 20 65 6e 74 72 79 20 66  irectory entry f
7130: 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77  or the journal w
7140: 61 73 20 6e 65 76 65 72 20 63 72 65 61 74 65 64  as never created
7150: 29 20 61 6e 64 20 74 68 65 20 74 72 61 6e 73 61  ) and the transa
7160: 63 74 69 6f 6e 0a 2a 2a 20 77 69 6c 6c 20 6e 6f  ction.** will no
7170: 74 20 72 6f 6c 6c 20 62 61 63 6b 20 2d 20 70 6f  t roll back - po
7180: 73 73 69 62 6c 79 20 6c 65 61 64 69 6e 67 20 74  ssibly leading t
7190: 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72 72 75  o database corru
71a0: 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63  ption..*/.static
71b0: 20 69 6e 74 20 75 6e 69 78 53 79 6e 63 28 4f 73   int unixSync(Os
71c0: 46 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 64 61  File *id, int da
71d0: 74 61 4f 6e 6c 79 29 7b 0a 20 20 75 6e 69 78 46  taOnly){.  unixF
71e0: 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e  ile *pFile = (un
71f0: 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 61 73  ixFile*)id;.  as
7200: 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20  sert( pFile );. 
7210: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
7220: 28 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3b 0a  (SQLITE_IOERR);.
7230: 20 20 54 52 41 43 45 32 28 22 53 59 4e 43 20 20    TRACE2("SYNC  
7240: 20 20 25 2d 33 64 5c 6e 22 2c 20 70 46 69 6c 65    %-3d\n", pFile
7250: 2d 3e 68 29 3b 0a 20 20 69 66 28 20 66 75 6c 6c  ->h);.  if( full
7260: 5f 66 73 79 6e 63 28 70 46 69 6c 65 2d 3e 68 2c  _fsync(pFile->h,
7270: 20 70 46 69 6c 65 2d 3e 66 75 6c 6c 53 79 6e 63   pFile->fullSync
7280: 2c 20 64 61 74 61 4f 6e 6c 79 29 20 29 7b 0a 20  , dataOnly) ){. 
7290: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
72a0: 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 20 20 69 66  _IOERR;.  }.  if
72b0: 28 20 70 46 69 6c 65 2d 3e 64 69 72 66 64 3e 3d  ( pFile->dirfd>=
72c0: 30 20 29 7b 0a 20 20 20 20 54 52 41 43 45 32 28  0 ){.    TRACE2(
72d0: 22 44 49 52 53 59 4e 43 20 25 2d 33 64 5c 6e 22  "DIRSYNC %-3d\n"
72e0: 2c 20 70 46 69 6c 65 2d 3e 64 69 72 66 64 29 3b  , pFile->dirfd);
72f0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
7300: 44 49 53 41 42 4c 45 5f 44 49 52 53 59 4e 43 0a  DISABLE_DIRSYNC.
7310: 20 20 20 20 69 66 28 20 66 75 6c 6c 5f 66 73 79      if( full_fsy
7320: 6e 63 28 70 46 69 6c 65 2d 3e 64 69 72 66 64 2c  nc(pFile->dirfd,
7330: 20 70 46 69 6c 65 2d 3e 66 75 6c 6c 53 79 6e 63   pFile->fullSync
7340: 2c 20 30 29 20 29 7b 0a 20 20 20 20 20 20 20 20  , 0) ){.        
7350: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f  return SQLITE_IO
7360: 45 52 52 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  ERR;.    }.#endi
7370: 66 0a 20 20 20 20 63 6c 6f 73 65 28 70 46 69 6c  f.    close(pFil
7380: 65 2d 3e 64 69 72 66 64 29 3b 20 20 2f 2a 20 4f  e->dirfd);  /* O
7390: 6e 6c 79 20 6e 65 65 64 20 74 6f 20 73 79 6e 63  nly need to sync
73a0: 20 6f 6e 63 65 2c 20 73 6f 20 63 6c 6f 73 65 20   once, so close 
73b0: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 2a 2f  the directory */
73c0: 0a 20 20 20 20 70 46 69 6c 65 2d 3e 64 69 72 66  .    pFile->dirf
73d0: 64 20 3d 20 2d 31 3b 20 20 20 20 2f 2a 20 77 68  d = -1;    /* wh
73e0: 65 6e 20 77 65 20 61 72 65 20 64 6f 6e 65 2e 20  en we are done. 
73f0: 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  */.  }.  return 
7400: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
7410: 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20 64 69 72  .** Sync the dir
7420: 65 63 74 6f 72 79 20 7a 44 69 72 6e 61 6d 65 2e  ectory zDirname.
7430: 20 54 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70   This is a no-op
7440: 20 6f 6e 20 6f 70 65 72 61 74 69 6e 67 20 73 79   on operating sy
7450: 73 74 65 6d 73 20 6f 74 68 65 72 0a 2a 2a 20 74  stems other.** t
7460: 68 61 6e 20 55 4e 49 58 2e 0a 2a 2a 0a 2a 2a 20  han UNIX..**.** 
7470: 54 68 69 73 20 69 73 20 75 73 65 64 20 74 6f 20  This is used to 
7480: 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6d 61  make sure the ma
7490: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
74a0: 65 20 68 61 73 20 74 72 75 65 6c 79 20 62 65 65  e has truely bee
74b0: 6e 20 64 65 6c 65 74 65 64 0a 2a 2a 20 62 65 66  n deleted.** bef
74c0: 6f 72 65 20 6d 61 6b 69 6e 67 20 63 68 61 6e 67  ore making chang
74d0: 65 73 20 74 6f 20 69 6e 64 69 76 69 64 75 61 6c  es to individual
74e0: 20 6a 6f 75 72 6e 61 6c 73 20 6f 6e 20 61 20 6d   journals on a m
74f0: 75 6c 74 69 2d 64 61 74 61 62 61 73 65 20 63 6f  ulti-database co
7500: 6d 6d 69 74 2e 0a 2a 2a 20 54 68 65 20 46 5f 46  mmit..** The F_F
7510: 55 4c 4c 46 53 59 4e 43 20 6f 70 74 69 6f 6e 20  ULLFSYNC option 
7520: 69 73 20 6e 6f 74 20 6e 65 65 64 65 64 20 68 65  is not needed he
7530: 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  re..*/.static in
7540: 74 20 75 6e 69 78 53 79 6e 63 44 69 72 65 63 74  t unixSyncDirect
7550: 6f 72 79 28 63 6f 6e 73 74 20 63 68 61 72 20 2a  ory(const char *
7560: 7a 44 69 72 6e 61 6d 65 29 7b 0a 23 69 66 64 65  zDirname){.#ifde
7570: 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45  f SQLITE_DISABLE
7580: 5f 44 49 52 53 59 4e 43 0a 20 20 72 65 74 75 72  _DIRSYNC.  retur
7590: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6c  n SQLITE_OK;.#el
75a0: 73 65 0a 20 20 69 6e 74 20 66 64 3b 0a 20 20 69  se.  int fd;.  i
75b0: 6e 74 20 72 3b 0a 20 20 53 69 6d 75 6c 61 74 65  nt r;.  Simulate
75c0: 49 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f 49  IOError(SQLITE_I
75d0: 4f 45 52 52 29 3b 0a 20 20 66 64 20 3d 20 6f 70  OERR);.  fd = op
75e0: 65 6e 28 7a 44 69 72 6e 61 6d 65 2c 20 4f 5f 52  en(zDirname, O_R
75f0: 44 4f 4e 4c 59 7c 4f 5f 42 49 4e 41 52 59 2c 20  DONLY|O_BINARY, 
7600: 30 29 3b 0a 20 20 54 52 41 43 45 33 28 22 44 49  0);.  TRACE3("DI
7610: 52 53 59 4e 43 20 25 2d 33 64 20 28 25 73 29 5c  RSYNC %-3d (%s)\
7620: 6e 22 2c 20 66 64 2c 20 7a 44 69 72 6e 61 6d 65  n", fd, zDirname
7630: 29 3b 0a 20 20 69 66 28 20 66 64 3c 30 20 29 7b  );.  if( fd<0 ){
7640: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
7650: 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a 20 20  TE_CANTOPEN; .  
7660: 7d 0a 20 20 72 20 3d 20 66 73 79 6e 63 28 66 64  }.  r = fsync(fd
7670: 29 3b 0a 20 20 63 6c 6f 73 65 28 66 64 29 3b 0a  );.  close(fd);.
7680: 20 20 72 65 74 75 72 6e 20 28 28 72 3d 3d 30 29    return ((r==0)
7690: 3f 53 51 4c 49 54 45 5f 4f 4b 3a 53 51 4c 49 54  ?SQLITE_OK:SQLIT
76a0: 45 5f 49 4f 45 52 52 29 3b 0a 23 65 6e 64 69 66  E_IOERR);.#endif
76b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61  .}../*.** Trunca
76c0: 74 65 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20  te an open file 
76d0: 74 6f 20 61 20 73 70 65 63 69 66 69 65 64 20 73  to a specified s
76e0: 69 7a 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ize.*/.static in
76f0: 74 20 75 6e 69 78 54 72 75 6e 63 61 74 65 28 4f  t unixTruncate(O
7700: 73 46 69 6c 65 20 2a 69 64 2c 20 69 36 34 20 6e  sFile *id, i64 n
7710: 42 79 74 65 29 7b 0a 20 20 61 73 73 65 72 74 28  Byte){.  assert(
7720: 20 69 64 20 29 3b 0a 20 20 53 69 6d 75 6c 61 74   id );.  Simulat
7730: 65 49 4f 45 72 72 6f 72 28 53 51 4c 49 54 45 5f  eIOError(SQLITE_
7740: 49 4f 45 52 52 29 3b 0a 20 20 72 65 74 75 72 6e  IOERR);.  return
7750: 20 66 74 72 75 6e 63 61 74 65 28 28 28 75 6e 69   ftruncate(((uni
7760: 78 46 69 6c 65 2a 29 69 64 29 2d 3e 68 2c 20 6e  xFile*)id)->h, n
7770: 42 79 74 65 29 3d 3d 30 20 3f 20 53 51 4c 49 54  Byte)==0 ? SQLIT
7780: 45 5f 4f 4b 20 3a 20 53 51 4c 49 54 45 5f 49 4f  E_OK : SQLITE_IO
7790: 45 52 52 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65  ERR;.}../*.** De
77a0: 74 65 72 6d 69 6e 65 20 74 68 65 20 63 75 72 72  termine the curr
77b0: 65 6e 74 20 73 69 7a 65 20 6f 66 20 61 20 66 69  ent size of a fi
77c0: 6c 65 20 69 6e 20 62 79 74 65 73 0a 2a 2f 0a 73  le in bytes.*/.s
77d0: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 46 69  tatic int unixFi
77e0: 6c 65 53 69 7a 65 28 4f 73 46 69 6c 65 20 2a 69  leSize(OsFile *i
77f0: 64 2c 20 69 36 34 20 2a 70 53 69 7a 65 29 7b 0a  d, i64 *pSize){.
7800: 20 20 73 74 72 75 63 74 20 73 74 61 74 20 62 75    struct stat bu
7810: 66 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 20  f;.  assert( id 
7820: 29 3b 0a 20 20 53 69 6d 75 6c 61 74 65 49 4f 45  );.  SimulateIOE
7830: 72 72 6f 72 28 53 51 4c 49 54 45 5f 49 4f 45 52  rror(SQLITE_IOER
7840: 52 29 3b 0a 20 20 69 66 28 20 66 73 74 61 74 28  R);.  if( fstat(
7850: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
7860: 3e 68 2c 20 26 62 75 66 29 21 3d 30 20 29 7b 0a  >h, &buf)!=0 ){.
7870: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
7880: 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a 20 20 2a  E_IOERR;.  }.  *
7890: 70 53 69 7a 65 20 3d 20 62 75 66 2e 73 74 5f 73  pSize = buf.st_s
78a0: 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  ize;.  return SQ
78b0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
78c0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63  * This routine c
78d0: 68 65 63 6b 73 20 69 66 20 74 68 65 72 65 20 69  hecks if there i
78e0: 73 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63  s a RESERVED loc
78f0: 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 73 70  k held on the sp
7900: 65 63 69 66 69 65 64 0a 2a 2a 20 66 69 6c 65 20  ecified.** file 
7910: 62 79 20 74 68 69 73 20 6f 72 20 61 6e 79 20 6f  by this or any o
7920: 74 68 65 72 20 70 72 6f 63 65 73 73 2e 20 49 66  ther process. If
7930: 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 73 20   such a lock is 
7940: 68 65 6c 64 2c 20 72 65 74 75 72 6e 0a 2a 2a 20  held, return.** 
7950: 6e 6f 6e 2d 7a 65 72 6f 2e 20 20 49 66 20 74 68  non-zero.  If th
7960: 65 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b  e file is unlock
7970: 65 64 20 6f 72 20 68 6f 6c 64 73 20 6f 6e 6c 79  ed or holds only
7980: 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 2c 20 74   SHARED locks, t
7990: 68 65 6e 0a 2a 2a 20 72 65 74 75 72 6e 20 7a 65  hen.** return ze
79a0: 72 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ro..*/.static in
79b0: 74 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72  t unixCheckReser
79c0: 76 65 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a  vedLock(OsFile *
79d0: 69 64 29 7b 0a 20 20 69 6e 74 20 72 20 3d 20 30  id){.  int r = 0
79e0: 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46  ;.  unixFile *pF
79f0: 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a  ile = (unixFile*
7a00: 29 69 64 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  )id;..  assert( 
7a10: 70 46 69 6c 65 20 29 3b 0a 20 20 69 66 28 20 43  pFile );.  if( C
7a20: 48 45 43 4b 5f 54 48 52 45 41 44 49 44 28 70 46  HECK_THREADID(pF
7a30: 69 6c 65 29 20 29 20 72 65 74 75 72 6e 20 53 51  ile) ) return SQ
7a40: 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 73  LITE_MISUSE;.  s
7a50: 71 6c 69 74 65 33 4f 73 2e 78 45 6e 74 65 72 4d  qlite3Os.xEnterM
7a60: 75 74 65 78 28 29 3b 20 2f 2a 20 42 65 63 61 75  utex(); /* Becau
7a70: 73 65 20 70 46 69 6c 65 2d 3e 70 4c 6f 63 6b 20  se pFile->pLock 
7a80: 69 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 73  is shared across
7a90: 20 74 68 72 65 61 64 73 20 2a 2f 0a 0a 20 20 2f   threads */..  /
7aa0: 2a 20 43 68 65 63 6b 20 69 66 20 61 20 74 68 72  * Check if a thr
7ab0: 65 61 64 20 69 6e 20 74 68 69 73 20 70 72 6f 63  ead in this proc
7ac0: 65 73 73 20 68 6f 6c 64 73 20 73 75 63 68 20 61  ess holds such a
7ad0: 20 6c 6f 63 6b 20 2a 2f 0a 20 20 69 66 28 20 70   lock */.  if( p
7ae0: 46 69 6c 65 2d 3e 70 4c 6f 63 6b 2d 3e 6c 6f 63  File->pLock->loc
7af0: 6b 74 79 70 65 3e 53 48 41 52 45 44 5f 4c 4f 43  ktype>SHARED_LOC
7b00: 4b 20 29 7b 0a 20 20 20 20 72 20 3d 20 31 3b 0a  K ){.    r = 1;.
7b10: 20 20 7d 0a 0a 20 20 2f 2a 20 4f 74 68 65 72 77    }..  /* Otherw
7b20: 69 73 65 20 73 65 65 20 69 66 20 73 6f 6d 65 20  ise see if some 
7b30: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 68 6f  other process ho
7b40: 6c 64 73 20 69 74 2e 0a 20 20 2a 2f 0a 20 20 69  lds it..  */.  i
7b50: 66 28 20 21 72 20 29 7b 0a 20 20 20 20 73 74 72  f( !r ){.    str
7b60: 75 63 74 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a  uct flock lock;.
7b70: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63      lock.l_whenc
7b80: 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20  e = SEEK_SET;.  
7b90: 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d    lock.l_start =
7ba0: 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a   RESERVED_BYTE;.
7bb0: 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d      lock.l_len =
7bc0: 20 31 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74   1;.    lock.l_t
7bd0: 79 70 65 20 3d 20 46 5f 57 52 4c 43 4b 3b 0a 20  ype = F_WRLCK;. 
7be0: 20 20 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e     fcntl(pFile->
7bf0: 68 2c 20 46 5f 47 45 54 4c 4b 2c 20 26 6c 6f 63  h, F_GETLK, &loc
7c00: 6b 29 3b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b  k);.    if( lock
7c10: 2e 6c 5f 74 79 70 65 21 3d 46 5f 55 4e 4c 43 4b  .l_type!=F_UNLCK
7c20: 20 29 7b 0a 20 20 20 20 20 20 72 20 3d 20 31 3b   ){.      r = 1;
7c30: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20  .    }.  }.  .  
7c40: 73 71 6c 69 74 65 33 4f 73 2e 78 4c 65 61 76 65  sqlite3Os.xLeave
7c50: 4d 75 74 65 78 28 29 3b 0a 20 20 54 52 41 43 45  Mutex();.  TRACE
7c60: 33 28 22 54 45 53 54 20 57 52 2d 4c 4f 43 4b 20  3("TEST WR-LOCK 
7c70: 25 64 20 25 64 5c 6e 22 2c 20 70 46 69 6c 65 2d  %d %d\n", pFile-
7c80: 3e 68 2c 20 72 29 3b 0a 0a 20 20 72 65 74 75 72  >h, r);..  retur
7c90: 6e 20 72 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53  n r;.}..#ifdef S
7ca0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a  QLITE_DEBUG./*.*
7cb0: 2a 20 48 65 6c 70 65 72 20 66 75 6e 63 74 69 6f  * Helper functio
7cc0: 6e 20 66 6f 72 20 70 72 69 6e 74 69 6e 67 20 6f  n for printing o
7cd0: 75 74 20 74 72 61 63 65 20 69 6e 66 6f 72 6d 61  ut trace informa
7ce0: 74 69 6f 6e 20 66 72 6f 6d 20 64 65 62 75 67 67  tion from debugg
7cf0: 69 6e 67 0a 2a 2a 20 62 69 6e 61 72 69 65 73 2e  ing.** binaries.
7d00: 20 54 68 69 73 20 72 65 74 75 72 6e 73 20 74 68   This returns th
7d10: 65 20 73 74 72 69 6e 67 20 72 65 70 72 65 73 65  e string represe
7d20: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 75  tation of the su
7d30: 70 70 6c 69 65 64 0a 2a 2a 20 69 6e 74 65 67 65  pplied.** intege
7d40: 72 20 6c 6f 63 6b 2d 74 79 70 65 2e 0a 2a 2f 0a  r lock-type..*/.
7d50: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61  static const cha
7d60: 72 20 2a 6c 6f 63 6b 74 79 70 65 4e 61 6d 65 28  r *locktypeName(
7d70: 69 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b 0a 20  int locktype){. 
7d80: 20 73 77 69 74 63 68 28 20 6c 6f 63 6b 74 79 70   switch( locktyp
7d90: 65 20 29 7b 0a 20 20 63 61 73 65 20 4e 4f 5f 4c  e ){.  case NO_L
7da0: 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 4e 4f 4e  OCK: return "NON
7db0: 45 22 3b 0a 20 20 63 61 73 65 20 53 48 41 52 45  E";.  case SHARE
7dc0: 44 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22  D_LOCK: return "
7dd0: 53 48 41 52 45 44 22 3b 0a 20 20 63 61 73 65 20  SHARED";.  case 
7de0: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 3a 20 72  RESERVED_LOCK: r
7df0: 65 74 75 72 6e 20 22 52 45 53 45 52 56 45 44 22  eturn "RESERVED"
7e00: 3b 0a 20 20 63 61 73 65 20 50 45 4e 44 49 4e 47  ;.  case PENDING
7e10: 5f 4c 4f 43 4b 3a 20 72 65 74 75 72 6e 20 22 50  _LOCK: return "P
7e20: 45 4e 44 49 4e 47 22 3b 0a 20 20 63 61 73 65 20  ENDING";.  case 
7e30: 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 3a 20  EXCLUSIVE_LOCK: 
7e40: 72 65 74 75 72 6e 20 22 45 58 43 4c 55 53 49 56  return "EXCLUSIV
7e50: 45 22 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  E";.  }.  return
7e60: 20 22 45 52 52 4f 52 22 3b 0a 7d 0a 23 65 6e 64   "ERROR";.}.#end
7e70: 69 66 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74  if../*.** Lock t
7e80: 68 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 65  he file with the
7e90: 20 6c 6f 63 6b 20 73 70 65 63 69 66 69 65 64 20   lock specified 
7ea0: 62 79 20 70 61 72 61 6d 65 74 65 72 20 6c 6f 63  by parameter loc
7eb0: 6b 74 79 70 65 20 2d 20 6f 6e 65 0a 2a 2a 20 6f  ktype - one.** o
7ec0: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a  f the following:
7ed0: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 53  .**.**     (1) S
7ee0: 48 41 52 45 44 5f 4c 4f 43 4b 0a 2a 2a 20 20 20  HARED_LOCK.**   
7ef0: 20 20 28 32 29 20 52 45 53 45 52 56 45 44 5f 4c    (2) RESERVED_L
7f00: 4f 43 4b 0a 2a 2a 20 20 20 20 20 28 33 29 20 50  OCK.**     (3) P
7f10: 45 4e 44 49 4e 47 5f 4c 4f 43 4b 0a 2a 2a 20 20  ENDING_LOCK.**  
7f20: 20 20 20 28 34 29 20 45 58 43 4c 55 53 49 56 45     (4) EXCLUSIVE
7f30: 5f 4c 4f 43 4b 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65  _LOCK.**.** Some
7f40: 74 69 6d 65 73 20 77 68 65 6e 20 72 65 71 75 65  times when reque
7f50: 73 74 69 6e 67 20 6f 6e 65 20 6c 6f 63 6b 20 73  sting one lock s
7f60: 74 61 74 65 2c 20 61 64 64 69 74 69 6f 6e 61 6c  tate, additional
7f70: 20 6c 6f 63 6b 20 73 74 61 74 65 73 0a 2a 2a 20   lock states.** 
7f80: 61 72 65 20 69 6e 73 65 72 74 65 64 20 69 6e 20  are inserted in 
7f90: 62 65 74 77 65 65 6e 2e 20 20 54 68 65 20 6c 6f  between.  The lo
7fa0: 63 6b 69 6e 67 20 6d 69 67 68 74 20 66 61 69 6c  cking might fail
7fb0: 20 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c   on one of the l
7fc0: 61 74 65 72 0a 2a 2a 20 74 72 61 6e 73 69 74 69  ater.** transiti
7fd0: 6f 6e 73 20 6c 65 61 76 69 6e 67 20 74 68 65 20  ons leaving the 
7fe0: 6c 6f 63 6b 20 73 74 61 74 65 20 64 69 66 66 65  lock state diffe
7ff0: 72 65 6e 74 20 66 72 6f 6d 20 77 68 61 74 20 69  rent from what i
8000: 74 20 73 74 61 72 74 65 64 20 62 75 74 0a 2a 2a  t started but.**
8010: 20 73 74 69 6c 6c 20 73 68 6f 72 74 20 6f 66 20   still short of 
8020: 69 74 73 20 67 6f 61 6c 2e 20 20 54 68 65 20 66  its goal.  The f
8030: 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 74 20 73  ollowing chart s
8040: 68 6f 77 73 20 74 68 65 20 61 6c 6c 6f 77 65 64  hows the allowed
8050: 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 73 20  .** transitions 
8060: 61 6e 64 20 74 68 65 20 69 6e 73 65 72 74 65 64  and the inserted
8070: 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 73 74   intermediate st
8080: 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 55  ates:.**.**    U
8090: 4e 4c 4f 43 4b 45 44 20 2d 3e 20 53 48 41 52 45  NLOCKED -> SHARE
80a0: 44 0a 2a 2a 20 20 20 20 53 48 41 52 45 44 20 2d  D.**    SHARED -
80b0: 3e 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 20 20  > RESERVED.**   
80c0: 20 53 48 41 52 45 44 20 2d 3e 20 28 50 45 4e 44   SHARED -> (PEND
80d0: 49 4e 47 29 20 2d 3e 20 45 58 43 4c 55 53 49 56  ING) -> EXCLUSIV
80e0: 45 0a 2a 2a 20 20 20 20 52 45 53 45 52 56 45 44  E.**    RESERVED
80f0: 20 2d 3e 20 28 50 45 4e 44 49 4e 47 29 20 2d 3e   -> (PENDING) ->
8100: 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20   EXCLUSIVE.**   
8110: 20 50 45 4e 44 49 4e 47 20 2d 3e 20 45 58 43 4c   PENDING -> EXCL
8120: 55 53 49 56 45 0a 2a 2a 0a 2a 2a 20 54 68 69 73  USIVE.**.** This
8130: 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 6e   routine will on
8140: 6c 79 20 69 6e 63 72 65 61 73 65 20 61 20 6c 6f  ly increase a lo
8150: 63 6b 2e 20 20 55 73 65 20 74 68 65 20 73 71 6c  ck.  Use the sql
8160: 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 0a 2a  ite3OsUnlock().*
8170: 2a 20 72 6f 75 74 69 6e 65 20 74 6f 20 6c 6f 77  * routine to low
8180: 65 72 20 61 20 6c 6f 63 6b 69 6e 67 20 6c 65 76  er a locking lev
8190: 65 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  el..*/.static in
81a0: 74 20 75 6e 69 78 4c 6f 63 6b 28 4f 73 46 69 6c  t unixLock(OsFil
81b0: 65 20 2a 69 64 2c 20 69 6e 74 20 6c 6f 63 6b 74  e *id, int lockt
81c0: 79 70 65 29 7b 0a 20 20 2f 2a 20 54 68 65 20 66  ype){.  /* The f
81d0: 6f 6c 6c 6f 77 69 6e 67 20 64 65 73 63 72 69 62  ollowing describ
81e0: 65 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  es the implement
81f0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 61 72  ation of the var
8200: 69 6f 75 73 20 6c 6f 63 6b 73 20 61 6e 64 0a 20  ious locks and. 
8210: 20 2a 2a 20 6c 6f 63 6b 20 74 72 61 6e 73 69 74   ** lock transit
8220: 69 6f 6e 73 20 69 6e 20 74 65 72 6d 73 20 6f 66  ions in terms of
8230: 20 74 68 65 20 50 4f 53 49 58 20 61 64 76 69 73   the POSIX advis
8240: 6f 72 79 20 73 68 61 72 65 64 20 61 6e 64 20 65  ory shared and e
8250: 78 63 6c 75 73 69 76 65 0a 20 20 2a 2a 20 6c 6f  xclusive.  ** lo
8260: 63 6b 20 70 72 69 6d 69 74 69 76 65 73 20 28 63  ck primitives (c
8270: 61 6c 6c 65 64 20 72 65 61 64 2d 6c 6f 63 6b 73  alled read-locks
8280: 20 61 6e 64 20 77 72 69 74 65 2d 6c 6f 63 6b 73   and write-locks
8290: 20 62 65 6c 6f 77 2c 20 74 6f 20 61 76 6f 69 64   below, to avoid
82a0: 0a 20 20 2a 2a 20 63 6f 6e 66 75 73 69 6f 6e 20  .  ** confusion 
82b0: 77 69 74 68 20 53 51 4c 69 74 65 20 6c 6f 63 6b  with SQLite lock
82c0: 20 6e 61 6d 65 73 29 2e 20 54 68 65 20 61 6c 67   names). The alg
82d0: 6f 72 69 74 68 6d 73 20 61 72 65 20 63 6f 6d 70  orithms are comp
82e0: 6c 69 63 61 74 65 64 0a 20 20 2a 2a 20 73 6c 69  licated.  ** sli
82f0: 67 68 74 6c 79 20 69 6e 20 6f 72 64 65 72 20 74  ghtly in order t
8300: 6f 20 62 65 20 63 6f 6d 70 61 74 69 62 6c 65 20  o be compatible 
8310: 77 69 74 68 20 77 69 6e 64 6f 77 73 20 73 79 73  with windows sys
8320: 74 65 6d 73 20 73 69 6d 75 6c 74 61 6e 65 6f 75  tems simultaneou
8330: 73 6c 79 0a 20 20 2a 2a 20 61 63 63 65 73 73 69  sly.  ** accessi
8340: 6e 67 20 74 68 65 20 73 61 6d 65 20 64 61 74 61  ng the same data
8350: 62 61 73 65 20 66 69 6c 65 2c 20 69 6e 20 63 61  base file, in ca
8360: 73 65 20 74 68 61 74 20 69 73 20 65 76 65 72 20  se that is ever 
8370: 72 65 71 75 69 72 65 64 2e 0a 20 20 2a 2a 0a 20  required..  **. 
8380: 20 2a 2a 20 53 79 6d 62 6f 6c 73 20 64 65 66 69   ** Symbols defi
8390: 6e 65 64 20 69 6e 20 6f 73 2e 68 20 69 6e 64 65  ned in os.h inde
83a0: 6e 74 69 66 79 20 74 68 65 20 27 70 65 6e 64 69  ntify the 'pendi
83b0: 6e 67 20 62 79 74 65 27 20 61 6e 64 20 74 68 65  ng byte' and the
83c0: 20 27 72 65 73 65 72 76 65 64 0a 20 20 2a 2a 20   'reserved.  ** 
83d0: 62 79 74 65 27 2c 20 65 61 63 68 20 73 69 6e 67  byte', each sing
83e0: 6c 65 20 62 79 74 65 73 20 61 74 20 77 65 6c 6c  le bytes at well
83f0: 20 6b 6e 6f 77 6e 20 6f 66 66 73 65 74 73 2c 20   known offsets, 
8400: 61 6e 64 20 74 68 65 20 27 73 68 61 72 65 64 20  and the 'shared 
8410: 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e 67 65 27  byte.  ** range'
8420: 2c 20 61 20 72 61 6e 67 65 20 6f 66 20 35 31 30  , a range of 510
8430: 20 62 79 74 65 73 20 61 74 20 61 20 77 65 6c 6c   bytes at a well
8440: 20 6b 6e 6f 77 6e 20 6f 66 66 73 65 74 2e 0a 20   known offset.. 
8450: 20 2a 2a 0a 20 20 2a 2a 20 54 6f 20 6f 62 74 61   **.  ** To obta
8460: 69 6e 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b  in a SHARED lock
8470: 2c 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 69 73  , a read-lock is
8480: 20 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 68 65   obtained on the
8490: 20 27 70 65 6e 64 69 6e 67 0a 20 20 2a 2a 20 62   'pending.  ** b
84a0: 79 74 65 27 2e 20 20 49 66 20 74 68 69 73 20 69  yte'.  If this i
84b0: 73 20 73 75 63 63 65 73 73 66 75 6c 2c 20 61 20  s successful, a 
84c0: 72 61 6e 64 6f 6d 20 62 79 74 65 20 66 72 6f 6d  random byte from
84d0: 20 74 68 65 20 27 73 68 61 72 65 64 20 62 79 74   the 'shared byt
84e0: 65 0a 20 20 2a 2a 20 72 61 6e 67 65 27 20 69 73  e.  ** range' is
84f0: 20 72 65 61 64 2d 6c 6f 63 6b 65 64 20 61 6e 64   read-locked and
8500: 20 74 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65   the lock on the
8510: 20 27 70 65 6e 64 69 6e 67 20 62 79 74 65 27 20   'pending byte' 
8520: 72 65 6c 65 61 73 65 64 2e 0a 20 20 2a 2a 0a 20  released..  **. 
8530: 20 2a 2a 20 41 20 70 72 6f 63 65 73 73 20 6d 61   ** A process ma
8540: 79 20 6f 6e 6c 79 20 6f 62 74 61 69 6e 20 61 20  y only obtain a 
8550: 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 61 66  RESERVED lock af
8560: 74 65 72 20 69 74 20 68 61 73 20 61 20 53 48 41  ter it has a SHA
8570: 52 45 44 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 41  RED lock..  ** A
8580: 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69   RESERVED lock i
8590: 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79  s implemented by
85a0: 20 67 72 61 62 62 69 6e 67 20 61 20 77 72 69 74   grabbing a writ
85b0: 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20  e-lock on the.  
85c0: 2a 2a 20 27 72 65 73 65 72 76 65 64 20 62 79 74  ** 'reserved byt
85d0: 65 27 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41  e'. .  **.  ** A
85e0: 20 70 72 6f 63 65 73 73 20 6d 61 79 20 6f 6e 6c   process may onl
85f0: 79 20 6f 62 74 61 69 6e 20 61 20 50 45 4e 44 49  y obtain a PENDI
8600: 4e 47 20 6c 6f 63 6b 20 61 66 74 65 72 20 69 74  NG lock after it
8610: 20 68 61 73 20 6f 62 74 61 69 6e 65 64 20 61 0a   has obtained a.
8620: 20 20 2a 2a 20 53 48 41 52 45 44 20 6c 6f 63 6b    ** SHARED lock
8630: 2e 20 41 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b  . A PENDING lock
8640: 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20   is implemented 
8650: 62 79 20 6f 62 74 61 69 6e 69 6e 67 20 61 20 77  by obtaining a w
8660: 72 69 74 65 2d 6c 6f 63 6b 0a 20 20 2a 2a 20 6f  rite-lock.  ** o
8670: 6e 20 74 68 65 20 27 70 65 6e 64 69 6e 67 20 62  n the 'pending b
8680: 79 74 65 27 2e 20 54 68 69 73 20 65 6e 73 75 72  yte'. This ensur
8690: 65 73 20 74 68 61 74 20 6e 6f 20 6e 65 77 20 53  es that no new S
86a0: 48 41 52 45 44 20 6c 6f 63 6b 73 20 63 61 6e 20  HARED locks can 
86b0: 62 65 0a 20 20 2a 2a 20 6f 62 74 61 69 6e 65 64  be.  ** obtained
86c0: 2c 20 62 75 74 20 65 78 69 73 74 69 6e 67 20 53  , but existing S
86d0: 48 41 52 45 44 20 6c 6f 63 6b 73 20 61 72 65 20  HARED locks are 
86e0: 61 6c 6c 6f 77 65 64 20 74 6f 20 70 65 72 73 69  allowed to persi
86f0: 73 74 2e 20 41 20 70 72 6f 63 65 73 73 0a 20 20  st. A process.  
8700: 2a 2a 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65  ** does not have
8710: 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 52 45 53   to obtain a RES
8720: 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e 20 74 68  ERVED lock on th
8730: 65 20 77 61 79 20 74 6f 20 61 20 50 45 4e 44 49  e way to a PENDI
8740: 4e 47 20 6c 6f 63 6b 2e 0a 20 20 2a 2a 20 54 68  NG lock..  ** Th
8750: 69 73 20 70 72 6f 70 65 72 74 79 20 69 73 20 75  is property is u
8760: 73 65 64 20 62 79 20 74 68 65 20 61 6c 67 6f 72  sed by the algor
8770: 69 74 68 6d 20 66 6f 72 20 72 6f 6c 6c 69 6e 67  ithm for rolling
8780: 20 62 61 63 6b 20 61 20 6a 6f 75 72 6e 61 6c 20   back a journal 
8790: 66 69 6c 65 0a 20 20 2a 2a 20 61 66 74 65 72 20  file.  ** after 
87a0: 61 20 63 72 61 73 68 2e 0a 20 20 2a 2a 0a 20 20  a crash..  **.  
87b0: 2a 2a 20 41 6e 20 45 58 43 4c 55 53 49 56 45 20  ** An EXCLUSIVE 
87c0: 6c 6f 63 6b 2c 20 6f 62 74 61 69 6e 65 64 20 61  lock, obtained a
87d0: 66 74 65 72 20 61 20 50 45 4e 44 49 4e 47 20 6c  fter a PENDING l
87e0: 6f 63 6b 20 69 73 20 68 65 6c 64 2c 20 69 73 0a  ock is held, is.
87f0: 20 20 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 65 64    ** implemented
8800: 20 62 79 20 6f 62 74 61 69 6e 69 6e 67 20 61 20   by obtaining a 
8810: 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68  write-lock on th
8820: 65 20 65 6e 74 69 72 65 20 27 73 68 61 72 65 64  e entire 'shared
8830: 20 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e 67 65   byte.  ** range
8840: 27 2e 20 53 69 6e 63 65 20 61 6c 6c 20 6f 74 68  '. Since all oth
8850: 65 72 20 6c 6f 63 6b 73 20 72 65 71 75 69 72 65  er locks require
8860: 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20   a read-lock on 
8870: 6f 6e 65 20 6f 66 20 74 68 65 20 62 79 74 65 73  one of the bytes
8880: 0a 20 20 2a 2a 20 77 69 74 68 69 6e 20 74 68 69  .  ** within thi
8890: 73 20 72 61 6e 67 65 2c 20 74 68 69 73 20 65 6e  s range, this en
88a0: 73 75 72 65 73 20 74 68 61 74 20 6e 6f 20 6f 74  sures that no ot
88b0: 68 65 72 20 6c 6f 63 6b 73 20 61 72 65 20 68 65  her locks are he
88c0: 6c 64 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 64  ld on the.  ** d
88d0: 61 74 61 62 61 73 65 2e 20 0a 20 20 2a 2a 0a 20  atabase. .  **. 
88e0: 20 2a 2a 20 54 68 65 20 72 65 61 73 6f 6e 20 61   ** The reason a
88f0: 20 73 69 6e 67 6c 65 20 62 79 74 65 20 63 61 6e   single byte can
8900: 6e 6f 74 20 62 65 20 75 73 65 64 20 69 6e 73 74  not be used inst
8910: 65 61 64 20 6f 66 20 74 68 65 20 27 73 68 61 72  ead of the 'shar
8920: 65 64 20 62 79 74 65 0a 20 20 2a 2a 20 72 61 6e  ed byte.  ** ran
8930: 67 65 27 20 69 73 20 74 68 61 74 20 73 6f 6d 65  ge' is that some
8940: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 77 69 6e   versions of win
8950: 64 6f 77 73 20 64 6f 20 6e 6f 74 20 73 75 70 70  dows do not supp
8960: 6f 72 74 20 72 65 61 64 2d 6c 6f 63 6b 73 2e 20  ort read-locks. 
8970: 42 79 0a 20 20 2a 2a 20 6c 6f 63 6b 69 6e 67 20  By.  ** locking 
8980: 61 20 72 61 6e 64 6f 6d 20 62 79 74 65 20 66 72  a random byte fr
8990: 6f 6d 20 61 20 72 61 6e 67 65 2c 20 63 6f 6e 63  om a range, conc
89a0: 75 72 72 65 6e 74 20 53 48 41 52 45 44 20 6c 6f  urrent SHARED lo
89b0: 63 6b 73 20 6d 61 79 20 65 78 69 73 74 0a 20 20  cks may exist.  
89c0: 2a 2a 20 65 76 65 6e 20 69 66 20 74 68 65 20 6c  ** even if the l
89d0: 6f 63 6b 69 6e 67 20 70 72 69 6d 69 74 69 76 65  ocking primitive
89e0: 20 75 73 65 64 20 69 73 20 61 6c 77 61 79 73 20   used is always 
89f0: 61 20 77 72 69 74 65 2d 6c 6f 63 6b 2e 0a 20 20  a write-lock..  
8a00: 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  */.  int rc = SQ
8a10: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 6e 69 78 46  LITE_OK;.  unixF
8a20: 69 6c 65 20 2a 70 46 69 6c 65 20 3d 20 28 75 6e  ile *pFile = (un
8a30: 69 78 46 69 6c 65 2a 29 69 64 3b 0a 20 20 73 74  ixFile*)id;.  st
8a40: 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a 70  ruct lockInfo *p
8a50: 4c 6f 63 6b 20 3d 20 70 46 69 6c 65 2d 3e 70 4c  Lock = pFile->pL
8a60: 6f 63 6b 3b 0a 20 20 73 74 72 75 63 74 20 66 6c  ock;.  struct fl
8a70: 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69 6e 74 20  ock lock;.  int 
8a80: 73 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 46  s;..  assert( pF
8a90: 69 6c 65 20 29 3b 0a 20 20 54 52 41 43 45 37 28  ile );.  TRACE7(
8aa0: 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 73 20 77  "LOCK    %d %s w
8ab0: 61 73 20 25 73 28 25 73 2c 25 64 29 20 70 69 64  as %s(%s,%d) pid
8ac0: 3d 25 64 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68  =%d\n", pFile->h
8ad0: 2c 0a 20 20 20 20 20 20 6c 6f 63 6b 74 79 70 65  ,.      locktype
8ae0: 4e 61 6d 65 28 6c 6f 63 6b 74 79 70 65 29 2c 20  Name(locktype), 
8af0: 6c 6f 63 6b 74 79 70 65 4e 61 6d 65 28 70 46 69  locktypeName(pFi
8b00: 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 29 2c 0a 20  le->locktype),. 
8b10: 20 20 20 20 20 6c 6f 63 6b 74 79 70 65 4e 61 6d       locktypeNam
8b20: 65 28 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70  e(pLock->locktyp
8b30: 65 29 2c 20 70 4c 6f 63 6b 2d 3e 63 6e 74 20 2c  e), pLock->cnt ,
8b40: 20 67 65 74 70 69 64 28 29 29 3b 0a 20 20 69 66   getpid());.  if
8b50: 28 20 43 48 45 43 4b 5f 54 48 52 45 41 44 49 44  ( CHECK_THREADID
8b60: 28 70 46 69 6c 65 29 20 29 20 72 65 74 75 72 6e  (pFile) ) return
8b70: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
8b80: 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69  .  /* If there i
8b90: 73 20 61 6c 72 65 61 64 79 20 61 20 6c 6f 63 6b  s already a lock
8ba0: 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 6f 72   of this type or
8bb0: 20 6d 6f 72 65 20 72 65 73 74 72 69 63 74 69 76   more restrictiv
8bc0: 65 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 4f 73  e on the.  ** Os
8bd0: 46 69 6c 65 2c 20 64 6f 20 6e 6f 74 68 69 6e 67  File, do nothing
8be0: 2e 20 44 6f 6e 27 74 20 75 73 65 20 74 68 65 20  . Don't use the 
8bf0: 65 6e 64 5f 6c 6f 63 6b 3a 20 65 78 69 74 20 70  end_lock: exit p
8c00: 61 74 68 2c 20 61 73 0a 20 20 2a 2a 20 73 71 6c  ath, as.  ** sql
8c10: 69 74 65 33 4f 73 2e 78 45 6e 74 65 72 4d 75 74  ite3Os.xEnterMut
8c20: 65 78 28 29 20 68 61 73 6e 27 74 20 62 65 65 6e  ex() hasn't been
8c30: 20 63 61 6c 6c 65 64 20 79 65 74 2e 0a 20 20 2a   called yet..  *
8c40: 2f 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e 6c  /.  if( pFile->l
8c50: 6f 63 6b 74 79 70 65 3e 3d 6c 6f 63 6b 74 79 70  ocktype>=locktyp
8c60: 65 20 29 7b 0a 20 20 20 20 54 52 41 43 45 33 28  e ){.    TRACE3(
8c70: 22 4c 4f 43 4b 20 20 20 20 25 64 20 25 73 20 6f  "LOCK    %d %s o
8c80: 6b 20 28 61 6c 72 65 61 64 79 20 68 65 6c 64 29  k (already held)
8c90: 5c 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 0a 20  \n", pFile->h,. 
8ca0: 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 74             lockt
8cb0: 79 70 65 4e 61 6d 65 28 6c 6f 63 6b 74 79 70 65  ypeName(locktype
8cc0: 29 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  ));.    return S
8cd0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20  QLITE_OK;.  }.. 
8ce0: 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68   /* Make sure th
8cf0: 65 20 6c 6f 63 6b 69 6e 67 20 73 65 71 75 65 6e  e locking sequen
8d00: 63 65 20 69 73 20 63 6f 72 72 65 63 74 0a 20 20  ce is correct.  
8d10: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 46 69  */.  assert( pFi
8d20: 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 21 3d 4e 4f  le->locktype!=NO
8d30: 5f 4c 4f 43 4b 20 7c 7c 20 6c 6f 63 6b 74 79 70  _LOCK || locktyp
8d40: 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29  e==SHARED_LOCK )
8d50: 3b 0a 20 20 61 73 73 65 72 74 28 20 6c 6f 63 6b  ;.  assert( lock
8d60: 74 79 70 65 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f  type!=PENDING_LO
8d70: 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  CK );.  assert( 
8d80: 6c 6f 63 6b 74 79 70 65 21 3d 52 45 53 45 52 56  locktype!=RESERV
8d90: 45 44 5f 4c 4f 43 4b 20 7c 7c 20 70 46 69 6c 65  ED_LOCK || pFile
8da0: 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52  ->locktype==SHAR
8db0: 45 44 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f 2a  ED_LOCK );..  /*
8dc0: 20 54 68 69 73 20 6d 75 74 65 78 20 69 73 20 6e   This mutex is n
8dd0: 65 65 64 65 64 20 62 65 63 61 75 73 65 20 70 46  eeded because pF
8de0: 69 6c 65 2d 3e 70 4c 6f 63 6b 20 69 73 20 73 68  ile->pLock is sh
8df0: 61 72 65 64 20 61 63 72 6f 73 73 20 74 68 72 65  ared across thre
8e00: 61 64 73 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74  ads.  */.  sqlit
8e10: 65 33 4f 73 2e 78 45 6e 74 65 72 4d 75 74 65 78  e3Os.xEnterMutex
8e20: 28 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 73 6f 6d  ();..  /* If som
8e30: 65 20 74 68 72 65 61 64 20 75 73 69 6e 67 20 74  e thread using t
8e40: 68 69 73 20 50 49 44 20 68 61 73 20 61 20 6c 6f  his PID has a lo
8e50: 63 6b 20 76 69 61 20 61 20 64 69 66 66 65 72 65  ck via a differe
8e60: 6e 74 20 4f 73 46 69 6c 65 2a 0a 20 20 2a 2a 20  nt OsFile*.  ** 
8e70: 68 61 6e 64 6c 65 20 74 68 61 74 20 70 72 65 63  handle that prec
8e80: 6c 75 64 65 73 20 74 68 65 20 72 65 71 75 65 73  ludes the reques
8e90: 74 65 64 20 6c 6f 63 6b 2c 20 72 65 74 75 72 6e  ted lock, return
8ea0: 20 42 55 53 59 2e 0a 20 20 2a 2f 0a 20 20 69 66   BUSY..  */.  if
8eb0: 28 20 28 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79  ( (pFile->lockty
8ec0: 70 65 21 3d 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74  pe!=pLock->lockt
8ed0: 79 70 65 20 26 26 20 0a 20 20 20 20 20 20 20 20  ype && .        
8ee0: 20 20 28 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79    (pLock->lockty
8ef0: 70 65 3e 3d 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b  pe>=PENDING_LOCK
8f00: 20 7c 7c 20 6c 6f 63 6b 74 79 70 65 3e 53 48 41   || locktype>SHA
8f10: 52 45 44 5f 4c 4f 43 4b 29 29 0a 20 20 29 7b 0a  RED_LOCK)).  ){.
8f20: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
8f30: 42 55 53 59 3b 0a 20 20 20 20 67 6f 74 6f 20 65  BUSY;.    goto e
8f40: 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20  nd_lock;.  }..  
8f50: 2f 2a 20 49 66 20 61 20 53 48 41 52 45 44 20 6c  /* If a SHARED l
8f60: 6f 63 6b 20 69 73 20 72 65 71 75 65 73 74 65 64  ock is requested
8f70: 2c 20 61 6e 64 20 73 6f 6d 65 20 74 68 72 65 61  , and some threa
8f80: 64 20 75 73 69 6e 67 20 74 68 69 73 20 50 49 44  d using this PID
8f90: 20 61 6c 72 65 61 64 79 0a 20 20 2a 2a 20 68 61   already.  ** ha
8fa0: 73 20 61 20 53 48 41 52 45 44 20 6f 72 20 52 45  s a SHARED or RE
8fb0: 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 74 68 65  SERVED lock, the
8fc0: 6e 20 69 6e 63 72 65 6d 65 6e 74 20 72 65 66 65  n increment refe
8fd0: 72 65 6e 63 65 20 63 6f 75 6e 74 73 20 61 6e 64  rence counts and
8fe0: 0a 20 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c  .  ** return SQL
8ff0: 49 54 45 5f 4f 4b 2e 0a 20 20 2a 2f 0a 20 20 69  ITE_OK..  */.  i
9000: 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41  f( locktype==SHA
9010: 52 45 44 5f 4c 4f 43 4b 20 26 26 20 0a 20 20 20  RED_LOCK && .   
9020: 20 20 20 28 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74     (pLock->lockt
9030: 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b  ype==SHARED_LOCK
9040: 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74   || pLock->lockt
9050: 79 70 65 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f  ype==RESERVED_LO
9060: 43 4b 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72  CK) ){.    asser
9070: 74 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41  t( locktype==SHA
9080: 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20  RED_LOCK );.    
9090: 61 73 73 65 72 74 28 20 70 46 69 6c 65 2d 3e 6c  assert( pFile->l
90a0: 6f 63 6b 74 79 70 65 3d 3d 30 20 29 3b 0a 20 20  ocktype==0 );.  
90b0: 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d    assert( pLock-
90c0: 3e 63 6e 74 3e 30 20 29 3b 0a 20 20 20 20 70 46  >cnt>0 );.    pF
90d0: 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20  ile->locktype = 
90e0: 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a 20 20 20  SHARED_LOCK;.   
90f0: 20 70 4c 6f 63 6b 2d 3e 63 6e 74 2b 2b 3b 0a 20   pLock->cnt++;. 
9100: 20 20 20 70 46 69 6c 65 2d 3e 70 4f 70 65 6e 2d     pFile->pOpen-
9110: 3e 6e 4c 6f 63 6b 2b 2b 3b 0a 20 20 20 20 67 6f  >nLock++;.    go
9120: 74 6f 20 65 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 7d  to end_lock;.  }
9130: 0a 0a 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d  ..  lock.l_len =
9140: 20 31 4c 3b 0a 0a 20 20 6c 6f 63 6b 2e 6c 5f 77   1L;..  lock.l_w
9150: 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54  hence = SEEK_SET
9160: 3b 0a 0a 20 20 2f 2a 20 41 20 50 45 4e 44 49 4e  ;..  /* A PENDIN
9170: 47 20 6c 6f 63 6b 20 69 73 20 6e 65 65 64 65 64  G lock is needed
9180: 20 62 65 66 6f 72 65 20 61 63 71 75 69 72 69 6e   before acquirin
9190: 67 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20  g a SHARED lock 
91a0: 61 6e 64 20 62 65 66 6f 72 65 0a 20 20 2a 2a 20  and before.  ** 
91b0: 61 63 71 75 69 72 69 6e 67 20 61 6e 20 45 58 43  acquiring an EXC
91c0: 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 20 46 6f  LUSIVE lock.  Fo
91d0: 72 20 74 68 65 20 53 48 41 52 45 44 20 6c 6f 63  r the SHARED loc
91e0: 6b 2c 20 74 68 65 20 50 45 4e 44 49 4e 47 20 77  k, the PENDING w
91f0: 69 6c 6c 0a 20 20 2a 2a 20 62 65 20 72 65 6c 65  ill.  ** be rele
9200: 61 73 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  ased..  */.  if(
9210: 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 45   locktype==SHARE
9220: 44 5f 4c 4f 43 4b 20 0a 20 20 20 20 20 20 7c 7c  D_LOCK .      ||
9230: 20 28 6c 6f 63 6b 74 79 70 65 3d 3d 45 58 43 4c   (locktype==EXCL
9240: 55 53 49 56 45 5f 4c 4f 43 4b 20 26 26 20 70 46  USIVE_LOCK && pF
9250: 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 3c 50 45  ile->locktype<PE
9260: 4e 44 49 4e 47 5f 4c 4f 43 4b 29 0a 20 20 29 7b  NDING_LOCK).  ){
9270: 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65  .    lock.l_type
9280: 20 3d 20 28 6c 6f 63 6b 74 79 70 65 3d 3d 53 48   = (locktype==SH
9290: 41 52 45 44 5f 4c 4f 43 4b 3f 46 5f 52 44 4c 43  ARED_LOCK?F_RDLC
92a0: 4b 3a 46 5f 57 52 4c 43 4b 29 3b 0a 20 20 20 20  K:F_WRLCK);.    
92b0: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50  lock.l_start = P
92c0: 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20  ENDING_BYTE;.   
92d0: 20 73 20 3d 20 66 63 6e 74 6c 28 70 46 69 6c 65   s = fcntl(pFile
92e0: 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c  ->h, F_SETLK, &l
92f0: 6f 63 6b 29 3b 0a 20 20 20 20 69 66 28 20 73 20  ock);.    if( s 
9300: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 28 65  ){.      rc = (e
9310: 72 72 6e 6f 3d 3d 45 49 4e 56 41 4c 29 20 3f 20  rrno==EINVAL) ? 
9320: 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 3a 20 53  SQLITE_NOLFS : S
9330: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20  QLITE_BUSY;.    
9340: 20 20 67 6f 74 6f 20 65 6e 64 5f 6c 6f 63 6b 3b    goto end_lock;
9350: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 20 20 2f  .    }.  }...  /
9360: 2a 20 49 66 20 63 6f 6e 74 72 6f 6c 20 67 65 74  * If control get
9370: 73 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c  s to this point,
9380: 20 74 68 65 6e 20 61 63 74 75 61 6c 6c 79 20 67   then actually g
9390: 6f 20 61 68 65 61 64 20 61 6e 64 20 6d 61 6b 65  o ahead and make
93a0: 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 6e 67 20  .  ** operating 
93b0: 73 79 73 74 65 6d 20 63 61 6c 6c 73 20 66 6f 72  system calls for
93c0: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6c   the specified l
93d0: 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ock..  */.  if( 
93e0: 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 44  locktype==SHARED
93f0: 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 61 73 73  _LOCK ){.    ass
9400: 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 63 6e 74 3d  ert( pLock->cnt=
9410: 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74  =0 );.    assert
9420: 28 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70  ( pLock->locktyp
9430: 65 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 2f 2a 20  e==0 );..    /* 
9440: 4e 6f 77 20 67 65 74 20 74 68 65 20 72 65 61 64  Now get the read
9450: 2d 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 6c 6f 63  -lock */.    loc
9460: 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 53 48 41 52  k.l_start = SHAR
9470: 45 44 5f 46 49 52 53 54 3b 0a 20 20 20 20 6c 6f  ED_FIRST;.    lo
9480: 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 53 48 41 52 45  ck.l_len = SHARE
9490: 44 5f 53 49 5a 45 3b 0a 20 20 20 20 73 20 3d 20  D_SIZE;.    s = 
94a0: 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20  fcntl(pFile->h, 
94b0: 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b  F_SETLK, &lock);
94c0: 0a 0a 20 20 20 20 2f 2a 20 44 72 6f 70 20 74 68  ..    /* Drop th
94d0: 65 20 74 65 6d 70 6f 72 61 72 79 20 50 45 4e 44  e temporary PEND
94e0: 49 4e 47 20 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20  ING lock */.    
94f0: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 50  lock.l_start = P
9500: 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20 20  ENDING_BYTE;.   
9510: 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 31 4c   lock.l_len = 1L
9520: 3b 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74 79 70  ;.    lock.l_typ
9530: 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20 20 20  e = F_UNLCK;.   
9540: 20 69 66 28 20 66 63 6e 74 6c 28 70 46 69 6c 65   if( fcntl(pFile
9550: 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c  ->h, F_SETLK, &l
9560: 6f 63 6b 29 21 3d 30 20 29 7b 0a 20 20 20 20 20  ock)!=0 ){.     
9570: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45   rc = SQLITE_IOE
9580: 52 52 3b 20 20 2f 2a 20 54 68 69 73 20 73 68 6f  RR;  /* This sho
9590: 75 6c 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e  uld never happen
95a0: 20 2a 2f 0a 20 20 20 20 20 20 67 6f 74 6f 20 65   */.      goto e
95b0: 6e 64 5f 6c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20  nd_lock;.    }. 
95c0: 20 20 20 69 66 28 20 73 20 29 7b 0a 20 20 20 20     if( s ){.    
95d0: 20 20 72 63 20 3d 20 28 65 72 72 6e 6f 3d 3d 45    rc = (errno==E
95e0: 49 4e 56 41 4c 29 20 3f 20 53 51 4c 49 54 45 5f  INVAL) ? SQLITE_
95f0: 4e 4f 4c 46 53 20 3a 20 53 51 4c 49 54 45 5f 42  NOLFS : SQLITE_B
9600: 55 53 59 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  USY;.    }else{.
9610: 20 20 20 20 20 20 70 46 69 6c 65 2d 3e 6c 6f 63        pFile->loc
9620: 6b 74 79 70 65 20 3d 20 53 48 41 52 45 44 5f 4c  ktype = SHARED_L
9630: 4f 43 4b 3b 0a 20 20 20 20 20 20 70 46 69 6c 65  OCK;.      pFile
9640: 2d 3e 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b 2b 2b  ->pOpen->nLock++
9650: 3b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 2d 3e 63  ;.      pLock->c
9660: 6e 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20  nt = 1;.    }.  
9670: 7d 65 6c 73 65 20 69 66 28 20 6c 6f 63 6b 74 79  }else if( lockty
9680: 70 65 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f  pe==EXCLUSIVE_LO
9690: 43 4b 20 26 26 20 70 4c 6f 63 6b 2d 3e 63 6e 74  CK && pLock->cnt
96a0: 3e 31 20 29 7b 0a 20 20 20 20 2f 2a 20 57 65 20  >1 ){.    /* We 
96b0: 61 72 65 20 74 72 79 69 6e 67 20 66 6f 72 20 61  are trying for a
96c0: 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b  n exclusive lock
96d0: 20 62 75 74 20 61 6e 6f 74 68 65 72 20 74 68 72   but another thr
96e0: 65 61 64 20 69 6e 20 74 68 69 73 0a 20 20 20 20  ead in this.    
96f0: 2a 2a 20 73 61 6d 65 20 70 72 6f 63 65 73 73 20  ** same process 
9700: 69 73 20 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67  is still holding
9710: 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20   a shared lock. 
9720: 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  */.    rc = SQLI
9730: 54 45 5f 42 55 53 59 3b 0a 20 20 7d 65 6c 73 65  TE_BUSY;.  }else
9740: 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71  {.    /* The req
9750: 75 65 73 74 20 77 61 73 20 66 6f 72 20 61 20 52  uest was for a R
9760: 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55  ESERVED or EXCLU
9770: 53 49 56 45 20 6c 6f 63 6b 2e 20 20 49 74 20 69  SIVE lock.  It i
9780: 73 0a 20 20 20 20 2a 2a 20 61 73 73 75 6d 65 64  s.    ** assumed
9790: 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 61   that there is a
97a0: 20 53 48 41 52 45 44 20 6f 72 20 67 72 65 61 74   SHARED or great
97b0: 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66  er lock on the f
97c0: 69 6c 65 0a 20 20 20 20 2a 2a 20 61 6c 72 65 61  ile.    ** alrea
97d0: 64 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61  dy..    */.    a
97e0: 73 73 65 72 74 28 20 30 21 3d 70 46 69 6c 65 2d  ssert( 0!=pFile-
97f0: 3e 6c 6f 63 6b 74 79 70 65 20 29 3b 0a 20 20 20  >locktype );.   
9800: 20 6c 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46   lock.l_type = F
9810: 5f 57 52 4c 43 4b 3b 0a 20 20 20 20 73 77 69 74  _WRLCK;.    swit
9820: 63 68 28 20 6c 6f 63 6b 74 79 70 65 20 29 7b 0a  ch( locktype ){.
9830: 20 20 20 20 20 20 63 61 73 65 20 52 45 53 45 52        case RESER
9840: 56 45 44 5f 4c 4f 43 4b 3a 0a 20 20 20 20 20 20  VED_LOCK:.      
9850: 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d    lock.l_start =
9860: 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 3b 0a   RESERVED_BYTE;.
9870: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
9880: 20 20 20 20 20 63 61 73 65 20 45 58 43 4c 55 53       case EXCLUS
9890: 49 56 45 5f 4c 4f 43 4b 3a 0a 20 20 20 20 20 20  IVE_LOCK:.      
98a0: 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d    lock.l_start =
98b0: 20 53 48 41 52 45 44 5f 46 49 52 53 54 3b 0a 20   SHARED_FIRST;. 
98c0: 20 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 6c 65         lock.l_le
98d0: 6e 20 3d 20 53 48 41 52 45 44 5f 53 49 5a 45 3b  n = SHARED_SIZE;
98e0: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
98f0: 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0a 20        default:. 
9900: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 30 29         assert(0)
9910: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 20 3d 20  ;.    }.    s = 
9920: 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20  fcntl(pFile->h, 
9930: 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 3b  F_SETLK, &lock);
9940: 0a 20 20 20 20 69 66 28 20 73 20 29 7b 0a 20 20  .    if( s ){.  
9950: 20 20 20 20 72 63 20 3d 20 28 65 72 72 6e 6f 3d      rc = (errno=
9960: 3d 45 49 4e 56 41 4c 29 20 3f 20 53 51 4c 49 54  =EINVAL) ? SQLIT
9970: 45 5f 4e 4f 4c 46 53 20 3a 20 53 51 4c 49 54 45  E_NOLFS : SQLITE
9980: 5f 42 55 53 59 3b 0a 20 20 20 20 7d 0a 20 20 7d  _BUSY;.    }.  }
9990: 0a 20 20 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  .  .  if( rc==SQ
99a0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70  LITE_OK ){.    p
99b0: 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d  File->locktype =
99c0: 20 6c 6f 63 6b 74 79 70 65 3b 0a 20 20 20 20 70   locktype;.    p
99d0: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d  Lock->locktype =
99e0: 20 6c 6f 63 6b 74 79 70 65 3b 0a 20 20 7d 65 6c   locktype;.  }el
99f0: 73 65 20 69 66 28 20 6c 6f 63 6b 74 79 70 65 3d  se if( locktype=
9a00: 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20  =EXCLUSIVE_LOCK 
9a10: 29 7b 0a 20 20 20 20 70 46 69 6c 65 2d 3e 6c 6f  ){.    pFile->lo
9a20: 63 6b 74 79 70 65 20 3d 20 50 45 4e 44 49 4e 47  cktype = PENDING
9a30: 5f 4c 4f 43 4b 3b 0a 20 20 20 20 70 4c 6f 63 6b  _LOCK;.    pLock
9a40: 2d 3e 6c 6f 63 6b 74 79 70 65 20 3d 20 50 45 4e  ->locktype = PEN
9a50: 44 49 4e 47 5f 4c 4f 43 4b 3b 0a 20 20 7d 0a 0a  DING_LOCK;.  }..
9a60: 65 6e 64 5f 6c 6f 63 6b 3a 0a 20 20 73 71 6c 69  end_lock:.  sqli
9a70: 74 65 33 4f 73 2e 78 4c 65 61 76 65 4d 75 74 65  te3Os.xLeaveMute
9a80: 78 28 29 3b 0a 20 20 54 52 41 43 45 34 28 22 4c  x();.  TRACE4("L
9a90: 4f 43 4b 20 20 20 20 25 64 20 25 73 20 25 73 5c  OCK    %d %s %s\
9aa0: 6e 22 2c 20 70 46 69 6c 65 2d 3e 68 2c 20 6c 6f  n", pFile->h, lo
9ab0: 63 6b 74 79 70 65 4e 61 6d 65 28 6c 6f 63 6b 74  cktypeName(lockt
9ac0: 79 70 65 29 2c 20 0a 20 20 20 20 20 20 72 63 3d  ype), .      rc=
9ad0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 3f 20 22 6f 6b  =SQLITE_OK ? "ok
9ae0: 22 20 3a 20 22 66 61 69 6c 65 64 22 29 3b 0a 20  " : "failed");. 
9af0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
9b00: 2a 0a 2a 2a 20 4c 6f 77 65 72 20 74 68 65 20 6c  *.** Lower the l
9b10: 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 20 6f 6e 20  ocking level on 
9b20: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
9b30: 70 46 69 6c 65 20 74 6f 20 6c 6f 63 6b 74 79 70  pFile to locktyp
9b40: 65 2e 20 20 6c 6f 63 6b 74 79 70 65 0a 2a 2a 20  e.  locktype.** 
9b50: 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 4e  must be either N
9b60: 4f 5f 4c 4f 43 4b 20 6f 72 20 53 48 41 52 45 44  O_LOCK or SHARED
9b70: 5f 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  _LOCK..**.** If 
9b80: 74 68 65 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65  the locking leve
9b90: 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 20 64 65  l of the file de
9ba0: 73 63 72 69 70 74 6f 72 20 69 73 20 61 6c 72 65  scriptor is alre
9bb0: 61 64 79 20 61 74 20 6f 72 20 62 65 6c 6f 77 0a  ady at or below.
9bc0: 2a 2a 20 74 68 65 20 72 65 71 75 65 73 74 65 64  ** the requested
9bd0: 20 6c 6f 63 6b 69 6e 67 20 6c 65 76 65 6c 2c 20   locking level, 
9be0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
9bf0: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 49  a no-op..**.** I
9c00: 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c  t is not possibl
9c10: 65 20 66 6f 72 20 74 68 69 73 20 72 6f 75 74 69  e for this routi
9c20: 6e 65 20 74 6f 20 66 61 69 6c 20 69 66 20 74 68  ne to fail if th
9c30: 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e  e second argumen
9c40: 74 0a 2a 2a 20 69 73 20 4e 4f 5f 4c 4f 43 4b 2e  t.** is NO_LOCK.
9c50: 20 20 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20    If the second 
9c60: 61 72 67 75 6d 65 6e 74 20 69 73 20 53 48 41 52  argument is SHAR
9c70: 45 44 5f 4c 4f 43 4b 2c 20 74 68 69 73 20 72 6f  ED_LOCK, this ro
9c80: 75 74 69 6e 65 0a 2a 2a 20 6d 69 67 68 74 20 72  utine.** might r
9c90: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45  eturn SQLITE_IOE
9ca0: 52 52 20 69 6e 73 74 65 61 64 20 6f 66 20 53 51  RR instead of SQ
9cb0: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74  LITE_OK..*/.stat
9cc0: 69 63 20 69 6e 74 20 75 6e 69 78 55 6e 6c 6f 63  ic int unixUnloc
9cd0: 6b 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e  k(OsFile *id, in
9ce0: 74 20 6c 6f 63 6b 74 79 70 65 29 7b 0a 20 20 73  t locktype){.  s
9cf0: 74 72 75 63 74 20 6c 6f 63 6b 49 6e 66 6f 20 2a  truct lockInfo *
9d00: 70 4c 6f 63 6b 3b 0a 20 20 73 74 72 75 63 74 20  pLock;.  struct 
9d10: 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 69 6e  flock lock;.  in
9d20: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
9d30: 3b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 46  ;.  unixFile *pF
9d40: 69 6c 65 20 3d 20 28 75 6e 69 78 46 69 6c 65 2a  ile = (unixFile*
9d50: 29 69 64 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  )id;..  assert( 
9d60: 70 46 69 6c 65 20 29 3b 0a 20 20 54 52 41 43 45  pFile );.  TRACE
9d70: 37 28 22 55 4e 4c 4f 43 4b 20 20 25 64 20 25 64  7("UNLOCK  %d %d
9d80: 20 77 61 73 20 25 64 28 25 64 2c 25 64 29 20 70   was %d(%d,%d) p
9d90: 69 64 3d 25 64 5c 6e 22 2c 20 70 46 69 6c 65 2d  id=%d\n", pFile-
9da0: 3e 68 2c 20 6c 6f 63 6b 74 79 70 65 2c 0a 20 20  >h, locktype,.  
9db0: 20 20 20 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74      pFile->lockt
9dc0: 79 70 65 2c 20 70 46 69 6c 65 2d 3e 70 4c 6f 63  ype, pFile->pLoc
9dd0: 6b 2d 3e 6c 6f 63 6b 74 79 70 65 2c 20 70 46 69  k->locktype, pFi
9de0: 6c 65 2d 3e 70 4c 6f 63 6b 2d 3e 63 6e 74 2c 20  le->pLock->cnt, 
9df0: 67 65 74 70 69 64 28 29 29 3b 0a 20 20 69 66 28  getpid());.  if(
9e00: 20 43 48 45 43 4b 5f 54 48 52 45 41 44 49 44 28   CHECK_THREADID(
9e10: 70 46 69 6c 65 29 20 29 20 72 65 74 75 72 6e 20  pFile) ) return 
9e20: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 0a  SQLITE_MISUSE;..
9e30: 20 20 61 73 73 65 72 74 28 20 6c 6f 63 6b 74 79    assert( lockty
9e40: 70 65 3c 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20  pe<=SHARED_LOCK 
9e50: 29 3b 0a 20 20 69 66 28 20 70 46 69 6c 65 2d 3e  );.  if( pFile->
9e60: 6c 6f 63 6b 74 79 70 65 3c 3d 6c 6f 63 6b 74 79  locktype<=lockty
9e70: 70 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  pe ){.    return
9e80: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
9e90: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 45 6e 74    sqlite3Os.xEnt
9ea0: 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 4c 6f  erMutex();.  pLo
9eb0: 63 6b 20 3d 20 70 46 69 6c 65 2d 3e 70 4c 6f 63  ck = pFile->pLoc
9ec0: 6b 3b 0a 20 20 61 73 73 65 72 74 28 20 70 4c 6f  k;.  assert( pLo
9ed0: 63 6b 2d 3e 63 6e 74 21 3d 30 20 29 3b 0a 20 20  ck->cnt!=0 );.  
9ee0: 69 66 28 20 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74  if( pFile->lockt
9ef0: 79 70 65 3e 53 48 41 52 45 44 5f 4c 4f 43 4b 20  ype>SHARED_LOCK 
9f00: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  ){.    assert( p
9f10: 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 3d 3d  Lock->locktype==
9f20: 70 46 69 6c 65 2d 3e 6c 6f 63 6b 74 79 70 65 20  pFile->locktype 
9f30: 29 3b 0a 20 20 20 20 69 66 28 20 6c 6f 63 6b 74  );.    if( lockt
9f40: 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b  ype==SHARED_LOCK
9f50: 20 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c   ){.      lock.l
9f60: 5f 74 79 70 65 20 3d 20 46 5f 52 44 4c 43 4b 3b  _type = F_RDLCK;
9f70: 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68  .      lock.l_wh
9f80: 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b  ence = SEEK_SET;
9f90: 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73 74  .      lock.l_st
9fa0: 61 72 74 20 3d 20 53 48 41 52 45 44 5f 46 49 52  art = SHARED_FIR
9fb0: 53 54 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c  ST;.      lock.l
9fc0: 5f 6c 65 6e 20 3d 20 53 48 41 52 45 44 5f 53 49  _len = SHARED_SI
9fd0: 5a 45 3b 0a 20 20 20 20 20 20 69 66 28 20 66 63  ZE;.      if( fc
9fe0: 6e 74 6c 28 70 46 69 6c 65 2d 3e 68 2c 20 46 5f  ntl(pFile->h, F_
9ff0: 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 21 3d 30  SETLK, &lock)!=0
a000: 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54   ){.        /* T
a010: 68 69 73 20 73 68 6f 75 6c 64 20 6e 65 76 65 72  his should never
a020: 20 68 61 70 70 65 6e 20 2a 2f 0a 20 20 20 20 20   happen */.     
a030: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49     rc = SQLITE_I
a040: 4f 45 52 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20  OERR;.      }.  
a050: 20 20 7d 0a 20 20 20 20 6c 6f 63 6b 2e 6c 5f 74    }.    lock.l_t
a060: 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b 3b 0a 20  ype = F_UNLCK;. 
a070: 20 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 65     lock.l_whence
a080: 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 20   = SEEK_SET;.   
a090: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20   lock.l_start = 
a0a0: 50 45 4e 44 49 4e 47 5f 42 59 54 45 3b 0a 20 20  PENDING_BYTE;.  
a0b0: 20 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 32    lock.l_len = 2
a0c0: 4c 3b 20 20 61 73 73 65 72 74 28 20 50 45 4e 44  L;  assert( PEND
a0d0: 49 4e 47 5f 42 59 54 45 2b 31 3d 3d 52 45 53 45  ING_BYTE+1==RESE
a0e0: 52 56 45 44 5f 42 59 54 45 20 29 3b 0a 20 20 20  RVED_BYTE );.   
a0f0: 20 69 66 28 20 66 63 6e 74 6c 28 70 46 69 6c 65   if( fcntl(pFile
a100: 2d 3e 68 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c  ->h, F_SETLK, &l
a110: 6f 63 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  ock)==0 ){.     
a120: 20 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65   pLock->locktype
a130: 20 3d 20 53 48 41 52 45 44 5f 4c 4f 43 4b 3b 0a   = SHARED_LOCK;.
a140: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
a150: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45   rc = SQLITE_IOE
a160: 52 52 3b 20 20 2f 2a 20 54 68 69 73 20 73 68 6f  RR;  /* This sho
a170: 75 6c 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e  uld never happen
a180: 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   */.    }.  }.  
a190: 69 66 28 20 6c 6f 63 6b 74 79 70 65 3d 3d 4e 4f  if( locktype==NO
a1a0: 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 73 74 72  _LOCK ){.    str
a1b0: 75 63 74 20 6f 70 65 6e 43 6e 74 20 2a 70 4f 70  uct openCnt *pOp
a1c0: 65 6e 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72  en;..    /* Decr
a1d0: 65 6d 65 6e 74 20 74 68 65 20 73 68 61 72 65 64  ement the shared
a1e0: 20 6c 6f 63 6b 20 63 6f 75 6e 74 65 72 2e 20 20   lock counter.  
a1f0: 52 65 6c 65 61 73 65 20 74 68 65 20 6c 6f 63 6b  Release the lock
a200: 20 75 73 69 6e 67 20 61 6e 0a 20 20 20 20 2a 2a   using an.    **
a210: 20 4f 53 20 63 61 6c 6c 20 6f 6e 6c 79 20 77 68   OS call only wh
a220: 65 6e 20 61 6c 6c 20 74 68 72 65 61 64 73 20 69  en all threads i
a230: 6e 20 74 68 69 73 20 73 61 6d 65 20 70 72 6f 63  n this same proc
a240: 65 73 73 20 68 61 76 65 20 72 65 6c 65 61 73 65  ess have release
a250: 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 63  d.    ** the loc
a260: 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4c  k..    */.    pL
a270: 6f 63 6b 2d 3e 63 6e 74 2d 2d 3b 0a 20 20 20 20  ock->cnt--;.    
a280: 69 66 28 20 70 4c 6f 63 6b 2d 3e 63 6e 74 3d 3d  if( pLock->cnt==
a290: 30 20 29 7b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e  0 ){.      lock.
a2a0: 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43 4b  l_type = F_UNLCK
a2b0: 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 77  ;.      lock.l_w
a2c0: 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54  hence = SEEK_SET
a2d0: 3b 0a 20 20 20 20 20 20 6c 6f 63 6b 2e 6c 5f 73  ;.      lock.l_s
a2e0: 74 61 72 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65  tart = lock.l_le
a2f0: 6e 20 3d 20 30 4c 3b 0a 20 20 20 20 20 20 69 66  n = 0L;.      if
a300: 28 20 66 63 6e 74 6c 28 70 46 69 6c 65 2d 3e 68  ( fcntl(pFile->h
a310: 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_SETLK, &lock
a320: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  )==0 ){.        
a330: 70 4c 6f 63 6b 2d 3e 6c 6f 63 6b 74 79 70 65 20  pLock->locktype 
a340: 3d 20 4e 4f 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20  = NO_LOCK;.     
a350: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
a360: 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52  rc = SQLITE_IOER
a370: 52 3b 20 20 2f 2a 20 54 68 69 73 20 73 68 6f 75  R;  /* This shou
a380: 6c 64 20 6e 65 76 65 72 20 68 61 70 70 65 6e 20  ld never happen 
a390: 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  */.      }.    }
a3a0: 0a 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65  ..    /* Decreme
a3b0: 6e 74 20 74 68 65 20 63 6f 75 6e 74 20 6f 66 20  nt the count of 
a3c0: 6c 6f 63 6b 73 20 61 67 61 69 6e 73 74 20 74 68  locks against th
a3d0: 69 73 20 73 61 6d 65 20 66 69 6c 65 2e 20 20 57  is same file.  W
a3e0: 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 63  hen the.    ** c
a3f0: 6f 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65 72  ount reaches zer
a400: 6f 2c 20 63 6c 6f 73 65 20 61 6e 79 20 6f 74 68  o, close any oth
a410: 65 72 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  er file descript
a420: 6f 72 73 20 77 68 6f 73 65 20 63 6c 6f 73 65 0a  ors whose close.
a430: 20 20 20 20 2a 2a 20 77 61 73 20 64 65 66 65 72      ** was defer
a440: 72 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 6f  red because of o
a450: 75 74 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73  utstanding locks
a460: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 4f 70  ..    */.    pOp
a470: 65 6e 20 3d 20 70 46 69 6c 65 2d 3e 70 4f 70 65  en = pFile->pOpe
a480: 6e 3b 0a 20 20 20 20 70 4f 70 65 6e 2d 3e 6e 4c  n;.    pOpen->nL
a490: 6f 63 6b 2d 2d 3b 0a 20 20 20 20 61 73 73 65 72  ock--;.    asser
a4a0: 74 28 20 70 4f 70 65 6e 2d 3e 6e 4c 6f 63 6b 3e  t( pOpen->nLock>
a4b0: 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 70 4f  =0 );.    if( pO
a4c0: 70 65 6e 2d 3e 6e 4c 6f 63 6b 3d 3d 30 20 26 26  pen->nLock==0 &&
a4d0: 20 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67   pOpen->nPending
a4e0: 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20  >0 ){.      int 
a4f0: 69 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30  i;.      for(i=0
a500: 3b 20 69 3c 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64  ; i<pOpen->nPend
a510: 69 6e 67 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  ing; i++){.     
a520: 20 20 20 63 6c 6f 73 65 28 70 4f 70 65 6e 2d 3e     close(pOpen->
a530: 61 50 65 6e 64 69 6e 67 5b 69 5d 29 3b 0a 20 20  aPending[i]);.  
a540: 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69      }.      sqli
a550: 74 65 46 72 65 65 28 70 4f 70 65 6e 2d 3e 61 50  teFree(pOpen->aP
a560: 65 6e 64 69 6e 67 29 3b 0a 20 20 20 20 20 20 70  ending);.      p
a570: 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e 67 20 3d  Open->nPending =
a580: 20 30 3b 0a 20 20 20 20 20 20 70 4f 70 65 6e 2d   0;.      pOpen-
a590: 3e 61 50 65 6e 64 69 6e 67 20 3d 20 30 3b 0a 20  >aPending = 0;. 
a5a0: 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74     }.  }.  sqlit
a5b0: 65 33 4f 73 2e 78 4c 65 61 76 65 4d 75 74 65 78  e3Os.xLeaveMutex
a5c0: 28 29 3b 0a 20 20 70 46 69 6c 65 2d 3e 6c 6f 63  ();.  pFile->loc
a5d0: 6b 74 79 70 65 20 3d 20 6c 6f 63 6b 74 79 70 65  ktype = locktype
a5e0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
a5f0: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20  ../*.** Close a 
a600: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
a610: 69 6e 74 20 75 6e 69 78 43 6c 6f 73 65 28 4f 73  int unixClose(Os
a620: 46 69 6c 65 20 2a 2a 70 49 64 29 7b 0a 20 20 75  File **pId){.  u
a630: 6e 69 78 46 69 6c 65 20 2a 69 64 20 3d 20 28 75  nixFile *id = (u
a640: 6e 69 78 46 69 6c 65 2a 29 2a 70 49 64 3b 0a 20  nixFile*)*pId;. 
a650: 20 69 66 28 20 21 69 64 20 29 20 72 65 74 75 72   if( !id ) retur
a660: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  n SQLITE_OK;.  i
a670: 66 28 20 43 48 45 43 4b 5f 54 48 52 45 41 44 49  f( CHECK_THREADI
a680: 44 28 69 64 29 20 29 20 72 65 74 75 72 6e 20 53  D(id) ) return S
a690: 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20  QLITE_MISUSE;.  
a6a0: 75 6e 69 78 55 6e 6c 6f 63 6b 28 2a 70 49 64 2c  unixUnlock(*pId,
a6b0: 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28   NO_LOCK);.  if(
a6c0: 20 69 64 2d 3e 64 69 72 66 64 3e 3d 30 20 29 20   id->dirfd>=0 ) 
a6d0: 63 6c 6f 73 65 28 69 64 2d 3e 64 69 72 66 64 29  close(id->dirfd)
a6e0: 3b 0a 20 20 69 64 2d 3e 64 69 72 66 64 20 3d 20  ;.  id->dirfd = 
a6f0: 2d 31 3b 0a 20 20 73 71 6c 69 74 65 33 4f 73 2e  -1;.  sqlite3Os.
a700: 78 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  xEnterMutex();. 
a710: 20 69 66 28 20 69 64 2d 3e 70 4f 70 65 6e 2d 3e   if( id->pOpen->
a720: 6e 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 2f 2a 20  nLock ){.    /* 
a730: 49 66 20 74 68 65 72 65 20 61 72 65 20 6f 75 74  If there are out
a740: 73 74 61 6e 64 69 6e 67 20 6c 6f 63 6b 73 2c 20  standing locks, 
a750: 64 6f 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20  do not actually 
a760: 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 20 6a  close the file j
a770: 75 73 74 0a 20 20 20 20 2a 2a 20 79 65 74 20 62  ust.    ** yet b
a780: 65 63 61 75 73 65 20 74 68 61 74 20 77 6f 75 6c  ecause that woul
a790: 64 20 63 6c 65 61 72 20 74 68 6f 73 65 20 6c 6f  d clear those lo
a7a0: 63 6b 73 2e 20 20 49 6e 73 74 65 61 64 2c 20 61  cks.  Instead, a
a7b0: 64 64 20 74 68 65 20 66 69 6c 65 0a 20 20 20 20  dd the file.    
a7c0: 2a 2a 20 64 65 73 63 72 69 70 74 6f 72 20 74 6f  ** descriptor to
a7d0: 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e 67   pOpen->aPending
a7e0: 2e 20 20 49 74 20 77 69 6c 6c 20 62 65 20 61 75  .  It will be au
a7f0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73  tomatically clos
a800: 65 64 20 77 68 65 6e 0a 20 20 20 20 2a 2a 20 74  ed when.    ** t
a810: 68 65 20 6c 61 73 74 20 6c 6f 63 6b 20 69 73 20  he last lock is 
a820: 63 6c 65 61 72 65 64 2e 0a 20 20 20 20 2a 2f 0a  cleared..    */.
a830: 20 20 20 20 69 6e 74 20 2a 61 4e 65 77 3b 0a 20      int *aNew;. 
a840: 20 20 20 73 74 72 75 63 74 20 6f 70 65 6e 43 6e     struct openCn
a850: 74 20 2a 70 4f 70 65 6e 20 3d 20 69 64 2d 3e 70  t *pOpen = id->p
a860: 4f 70 65 6e 3b 0a 20 20 20 20 61 4e 65 77 20 3d  Open;.    aNew =
a870: 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 28 20   sqliteRealloc( 
a880: 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69 6e 67 2c  pOpen->aPending,
a890: 20 28 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69 6e   (pOpen->nPendin
a8a0: 67 2b 31 29 2a 73 69 7a 65 6f 66 28 69 6e 74 29  g+1)*sizeof(int)
a8b0: 20 29 3b 0a 20 20 20 20 69 66 28 20 61 4e 65 77   );.    if( aNew
a8c0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ==0 ){.      /* 
a8d0: 49 66 20 61 20 6d 61 6c 6c 6f 63 20 66 61 69 6c  If a malloc fail
a8e0: 73 2c 20 6a 75 73 74 20 6c 65 61 6b 20 74 68 65  s, just leak the
a8f0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
a900: 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20   */.    }else{. 
a910: 20 20 20 20 20 70 4f 70 65 6e 2d 3e 61 50 65 6e       pOpen->aPen
a920: 64 69 6e 67 20 3d 20 61 4e 65 77 3b 0a 20 20 20  ding = aNew;.   
a930: 20 20 20 70 4f 70 65 6e 2d 3e 61 50 65 6e 64 69     pOpen->aPendi
a940: 6e 67 5b 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69  ng[pOpen->nPendi
a950: 6e 67 5d 20 3d 20 69 64 2d 3e 68 3b 0a 20 20 20  ng] = id->h;.   
a960: 20 20 20 70 4f 70 65 6e 2d 3e 6e 50 65 6e 64 69     pOpen->nPendi
a970: 6e 67 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  ng++;.    }.  }e
a980: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72  lse{.    /* Ther
a990: 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e  e are no outstan
a9a0: 64 69 6e 67 20 6c 6f 63 6b 73 20 73 6f 20 77 65  ding locks so we
a9b0: 20 63 61 6e 20 63 6c 6f 73 65 20 74 68 65 20 66   can close the f
a9c0: 69 6c 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 20  ile immediately 
a9d0: 2a 2f 0a 20 20 20 20 63 6c 6f 73 65 28 69 64 2d  */.    close(id-
a9e0: 3e 68 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61  >h);.  }.  relea
a9f0: 73 65 4c 6f 63 6b 49 6e 66 6f 28 69 64 2d 3e 70  seLockInfo(id->p
aa00: 4c 6f 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65  Lock);.  release
aa10: 4f 70 65 6e 43 6e 74 28 69 64 2d 3e 70 4f 70 65  OpenCnt(id->pOpe
aa20: 6e 29 3b 0a 20 20 73 71 6c 69 74 65 33 4f 73 2e  n);.  sqlite3Os.
aa30: 78 4c 65 61 76 65 4d 75 74 65 78 28 29 3b 0a 20  xLeaveMutex();. 
aa40: 20 69 64 2d 3e 69 73 4f 70 65 6e 20 3d 20 30 3b   id->isOpen = 0;
aa50: 0a 20 20 54 52 41 43 45 32 28 22 43 4c 4f 53 45  .  TRACE2("CLOSE
aa60: 20 20 20 25 2d 33 64 5c 6e 22 2c 20 69 64 2d 3e     %-3d\n", id->
aa70: 68 29 3b 0a 20 20 4f 70 65 6e 43 6f 75 6e 74 65  h);.  OpenCounte
aa80: 72 28 2d 31 29 3b 0a 20 20 73 71 6c 69 74 65 46  r(-1);.  sqliteF
aa90: 72 65 65 28 69 64 29 3b 0a 20 20 2a 70 49 64 20  ree(id);.  *pId 
aaa0: 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 0;.  return SQ
aab0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
aac0: 2a 20 54 75 72 6e 20 61 20 72 65 6c 61 74 69 76  * Turn a relativ
aad0: 65 20 70 61 74 68 6e 61 6d 65 20 69 6e 74 6f 20  e pathname into 
aae0: 61 20 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 2e  a full pathname.
aaf0: 20 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74    Return a point
ab00: 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 66 75 6c  er.** to the ful
ab10: 6c 20 70 61 74 68 6e 61 6d 65 20 73 74 6f 72 65  l pathname store
ab20: 64 20 69 6e 20 73 70 61 63 65 20 6f 62 74 61 69  d in space obtai
ab30: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
ab40: 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20 54 68 65 20  alloc()..** The 
ab50: 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e  calling function
ab60: 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20   is responsible 
ab70: 66 6f 72 20 66 72 65 65 69 6e 67 20 74 68 69 73  for freeing this
ab80: 20 73 70 61 63 65 20 6f 6e 63 65 20 69 74 0a 2a   space once it.*
ab90: 2a 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6e  * is no longer n
aba0: 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  eeded..*/.static
abb0: 20 63 68 61 72 20 2a 75 6e 69 78 46 75 6c 6c 50   char *unixFullP
abc0: 61 74 68 6e 61 6d 65 28 63 6f 6e 73 74 20 63 68  athname(const ch
abd0: 61 72 20 2a 7a 52 65 6c 61 74 69 76 65 29 7b 0a  ar *zRelative){.
abe0: 20 20 63 68 61 72 20 2a 7a 46 75 6c 6c 20 3d 20    char *zFull = 
abf0: 30 3b 0a 20 20 69 66 28 20 7a 52 65 6c 61 74 69  0;.  if( zRelati
ac00: 76 65 5b 30 5d 3d 3d 27 2f 27 20 29 7b 0a 20 20  ve[0]=='/' ){.  
ac10: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
ac20: 6e 67 28 26 7a 46 75 6c 6c 2c 20 7a 52 65 6c 61  ng(&zFull, zRela
ac30: 74 69 76 65 2c 20 28 63 68 61 72 2a 29 30 29 3b  tive, (char*)0);
ac40: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63 68  .  }else{.    ch
ac50: 61 72 20 2a 7a 42 75 66 20 3d 20 73 71 6c 69 74  ar *zBuf = sqlit
ac60: 65 4d 61 6c 6c 6f 63 28 35 30 30 30 29 3b 0a 20  eMalloc(5000);. 
ac70: 20 20 20 69 66 28 20 7a 42 75 66 3d 3d 30 20 29     if( zBuf==0 )
ac80: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 30  {.      return 0
ac90: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66  ;.    }.    zBuf
aca0: 5b 30 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c  [0] = 0;.    sql
acb0: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26 7a  ite3SetString(&z
acc0: 46 75 6c 6c 2c 20 67 65 74 63 77 64 28 7a 42 75  Full, getcwd(zBu
acd0: 66 2c 20 35 30 30 30 29 2c 20 22 2f 22 2c 20 7a  f, 5000), "/", z
ace0: 52 65 6c 61 74 69 76 65 2c 0a 20 20 20 20 20 20  Relative,.      
acf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 63                (c
ad00: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 73 71 6c  har*)0);.    sql
ad10: 69 74 65 46 72 65 65 28 7a 42 75 66 29 3b 0a 20  iteFree(zBuf);. 
ad20: 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 46 75 6c   }.  return zFul
ad30: 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  l;.}../*.** Chan
ad40: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
ad50: 74 68 65 20 66 75 6c 6c 73 79 6e 63 20 66 6c 61  the fullsync fla
ad60: 67 20 69 6e 20 74 68 65 20 67 69 76 65 6e 20 66  g in the given f
ad70: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 0a  ile descriptor..
ad80: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75  */.static void u
ad90: 6e 69 78 53 65 74 46 75 6c 6c 53 79 6e 63 28 4f  nixSetFullSync(O
ada0: 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e 74 20 76  sFile *id, int v
adb0: 29 7b 0a 20 20 28 28 75 6e 69 78 46 69 6c 65 2a  ){.  ((unixFile*
adc0: 29 69 64 29 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d  )id)->fullSync =
add0: 20 76 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74   v;.}../*.** Ret
ade0: 75 72 6e 20 74 68 65 20 75 6e 64 65 72 6c 79 69  urn the underlyi
adf0: 6e 67 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 66  ng file handle f
ae00: 6f 72 20 61 6e 20 4f 73 46 69 6c 65 0a 2a 2f 0a  or an OsFile.*/.
ae10: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 46  static int unixF
ae20: 69 6c 65 48 61 6e 64 6c 65 28 4f 73 46 69 6c 65  ileHandle(OsFile
ae30: 20 2a 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20   *id){.  return 
ae40: 28 28 75 6e 69 78 46 69 6c 65 2a 29 69 64 29 2d  ((unixFile*)id)-
ae50: 3e 68 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  >h;.}../*.** Ret
ae60: 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 74  urn an integer t
ae70: 68 61 74 20 69 6e 64 69 63 65 73 20 74 68 65 20  hat indices the 
ae80: 74 79 70 65 20 6f 66 20 6c 6f 63 6b 20 63 75 72  type of lock cur
ae90: 72 65 6e 74 6c 79 20 68 65 6c 64 0a 2a 2a 20 62  rently held.** b
aea0: 79 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 20 20  y this handle.  
aeb0: 28 55 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e  (Used for testin
aec0: 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f  g and analysis o
aed0: 6e 6c 79 2e 29 0a 2a 2f 0a 73 74 61 74 69 63 20  nly.).*/.static 
aee0: 69 6e 74 20 75 6e 69 78 4c 6f 63 6b 53 74 61 74  int unixLockStat
aef0: 65 28 4f 73 46 69 6c 65 20 2a 69 64 29 7b 0a 20  e(OsFile *id){. 
af00: 20 72 65 74 75 72 6e 20 28 28 75 6e 69 78 46 69   return ((unixFi
af10: 6c 65 2a 29 69 64 29 2d 3e 6c 6f 63 6b 74 79 70  le*)id)->locktyp
af20: 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  e;.}../*.** This
af30: 20 76 65 63 74 6f 72 20 64 65 66 69 6e 65 73 20   vector defines 
af40: 61 6c 6c 20 74 68 65 20 6d 65 74 68 6f 64 73 20  all the methods 
af50: 74 68 61 74 20 63 61 6e 20 6f 70 65 72 61 74 65  that can operate
af60: 20 6f 6e 20 61 6e 20 4f 73 46 69 6c 65 0a 2a 2a   on an OsFile.**
af70: 20 66 6f 72 20 75 6e 69 78 2e 0a 2a 2f 0a 73 74   for unix..*/.st
af80: 61 74 69 63 20 63 6f 6e 73 74 20 49 6f 4d 65 74  atic const IoMet
af90: 68 6f 64 20 73 71 6c 69 74 65 33 55 6e 69 78 49  hod sqlite3UnixI
afa0: 6f 4d 65 74 68 6f 64 20 3d 20 7b 0a 20 20 75 6e  oMethod = {.  un
afb0: 69 78 43 6c 6f 73 65 2c 0a 20 20 75 6e 69 78 4f  ixClose,.  unixO
afc0: 70 65 6e 44 69 72 65 63 74 6f 72 79 2c 0a 20 20  penDirectory,.  
afd0: 75 6e 69 78 52 65 61 64 2c 0a 20 20 75 6e 69 78  unixRead,.  unix
afe0: 57 72 69 74 65 2c 0a 20 20 75 6e 69 78 53 65 65  Write,.  unixSee
aff0: 6b 2c 0a 20 20 75 6e 69 78 54 72 75 6e 63 61 74  k,.  unixTruncat
b000: 65 2c 0a 20 20 75 6e 69 78 53 79 6e 63 2c 0a 20  e,.  unixSync,. 
b010: 20 75 6e 69 78 53 65 74 46 75 6c 6c 53 79 6e 63   unixSetFullSync
b020: 2c 0a 20 20 75 6e 69 78 46 69 6c 65 48 61 6e 64  ,.  unixFileHand
b030: 6c 65 2c 0a 20 20 75 6e 69 78 46 69 6c 65 53 69  le,.  unixFileSi
b040: 7a 65 2c 0a 20 20 75 6e 69 78 4c 6f 63 6b 2c 0a  ze,.  unixLock,.
b050: 20 20 75 6e 69 78 55 6e 6c 6f 63 6b 2c 0a 20 20    unixUnlock,.  
b060: 75 6e 69 78 4c 6f 63 6b 53 74 61 74 65 2c 0a 20  unixLockState,. 
b070: 20 75 6e 69 78 43 68 65 63 6b 52 65 73 65 72 76   unixCheckReserv
b080: 65 64 4c 6f 63 6b 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a  edLock,.};../*.*
b090: 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72  * Allocate memor
b0a0: 79 20 66 6f 72 20 61 20 75 6e 69 78 46 69 6c 65  y for a unixFile
b0b0: 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68  .  Initialize th
b0c0: 65 20 6e 65 77 20 75 6e 69 78 46 69 6c 65 0a 2a  e new unixFile.*
b0d0: 2a 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 67  * to the value g
b0e0: 69 76 65 6e 20 69 6e 20 70 49 6e 69 74 20 61 6e  iven in pInit an
b0f0: 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  d return a point
b100: 65 72 20 74 6f 20 74 68 65 20 6e 65 77 0a 2a 2a  er to the new.**
b110: 20 4f 73 46 69 6c 65 2e 20 20 49 66 20 77 65 20   OsFile.  If we 
b120: 72 75 6e 20 6f 75 74 20 6f 66 20 6d 65 6d 6f 72  run out of memor
b130: 79 2c 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c  y, close the fil
b140: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c  e and return NUL
b150: 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  L..*/.static int
b160: 20 61 6c 6c 6f 63 61 74 65 55 6e 69 78 46 69 6c   allocateUnixFil
b170: 65 28 75 6e 69 78 46 69 6c 65 20 2a 70 49 6e 69  e(unixFile *pIni
b180: 74 2c 20 4f 73 46 69 6c 65 20 2a 2a 70 49 64 29  t, OsFile **pId)
b190: 7b 0a 20 20 75 6e 69 78 46 69 6c 65 20 2a 70 4e  {.  unixFile *pN
b1a0: 65 77 3b 0a 20 20 70 4e 65 77 20 3d 20 73 71 6c  ew;.  pNew = sql
b1b0: 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f  iteMalloc( sizeo
b1c0: 66 28 75 6e 69 78 46 69 6c 65 29 20 29 3b 0a 20  f(unixFile) );. 
b1d0: 20 69 66 28 20 70 4e 65 77 3d 3d 30 20 29 7b 0a   if( pNew==0 ){.
b1e0: 20 20 20 20 63 6c 6f 73 65 28 70 49 6e 69 74 2d      close(pInit-
b1f0: 3e 68 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 65  >h);.    release
b200: 4c 6f 63 6b 49 6e 66 6f 28 70 49 6e 69 74 2d 3e  LockInfo(pInit->
b210: 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 72 65 6c 65  pLock);.    rele
b220: 61 73 65 4f 70 65 6e 43 6e 74 28 70 49 6e 69 74  aseOpenCnt(pInit
b230: 2d 3e 70 4f 70 65 6e 29 3b 0a 20 20 20 20 2a 70  ->pOpen);.    *p
b240: 49 64 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 75  Id = 0;.    retu
b250: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
b260: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70  .  }else{.    *p
b270: 4e 65 77 20 3d 20 2a 70 49 6e 69 74 3b 0a 20 20  New = *pInit;.  
b280: 20 20 70 4e 65 77 2d 3e 70 4d 65 74 68 6f 64 20    pNew->pMethod 
b290: 3d 20 26 73 71 6c 69 74 65 33 55 6e 69 78 49 6f  = &sqlite3UnixIo
b2a0: 4d 65 74 68 6f 64 3b 0a 20 20 20 20 2a 70 49 64  Method;.    *pId
b2b0: 20 3d 20 28 4f 73 46 69 6c 65 2a 29 70 4e 65 77   = (OsFile*)pNew
b2c0: 3b 0a 20 20 20 20 4f 70 65 6e 43 6f 75 6e 74 65  ;.    OpenCounte
b2d0: 72 28 2b 31 29 3b 0a 20 20 20 20 72 65 74 75 72  r(+1);.    retur
b2e0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
b2f0: 0a 7d 0a 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53  .}...#endif /* S
b300: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49  QLITE_OMIT_DISKI
b310: 4f 20 2a 2f 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  O */./**********
b320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b350: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b360: 2a 0a 2a 2a 20 45 76 65 72 79 74 68 69 6e 67 20  *.** Everything 
b370: 61 62 6f 76 65 20 64 65 61 6c 73 20 77 69 74 68  above deals with
b380: 20 66 69 6c 65 20 49 2f 4f 2e 20 20 45 76 65 72   file I/O.  Ever
b390: 79 74 68 69 6e 67 20 74 68 61 74 20 66 6f 6c 6c  ything that foll
b3a0: 6f 77 73 20 64 65 61 6c 73 0a 2a 2a 20 77 69 74  ows deals.** wit
b3b0: 68 20 6f 74 68 65 72 20 6d 69 73 63 65 6c 6c 61  h other miscella
b3c0: 6e 6f 75 73 20 61 73 70 65 63 74 73 20 6f 66 20  nous aspects of 
b3d0: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79  the operating sy
b3e0: 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65 0a 2a  stem interface.*
b3f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b400: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b410: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b420: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
b430: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 0a 2f  ***********/.../
b440: 2a 0a 2a 2a 20 47 65 74 20 69 6e 66 6f 72 6d 61  *.** Get informa
b450: 74 69 6f 6e 20 74 6f 20 73 65 65 64 20 74 68 65  tion to seed the
b460: 20 72 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 67   random number g
b470: 65 6e 65 72 61 74 6f 72 2e 20 20 54 68 65 20 73  enerator.  The s
b480: 65 65 64 0a 2a 2a 20 69 73 20 77 72 69 74 74 65  eed.** is writte
b490: 6e 20 69 6e 74 6f 20 74 68 65 20 62 75 66 66 65  n into the buffe
b4a0: 72 20 7a 42 75 66 5b 32 35 36 5d 2e 20 20 54 68  r zBuf[256].  Th
b4b0: 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69  e calling functi
b4c0: 6f 6e 20 6d 75 73 74 0a 2a 2a 20 73 75 70 70 6c  on must.** suppl
b4d0: 79 20 61 20 73 75 66 66 69 63 69 65 6e 74 6c 79  y a sufficiently
b4e0: 20 6c 61 72 67 65 20 62 75 66 66 65 72 2e 0a 2a   large buffer..*
b4f0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
b500: 78 52 61 6e 64 6f 6d 53 65 65 64 28 63 68 61 72  xRandomSeed(char
b510: 20 2a 7a 42 75 66 29 7b 0a 20 20 2f 2a 20 57 65   *zBuf){.  /* We
b520: 20 68 61 76 65 20 74 6f 20 69 6e 69 74 69 61 6c   have to initial
b530: 69 7a 65 20 7a 42 75 66 20 74 6f 20 70 72 65 76  ize zBuf to prev
b540: 65 6e 74 20 76 61 6c 67 72 69 6e 64 20 66 72 6f  ent valgrind fro
b550: 6d 20 72 65 70 6f 72 74 69 6e 67 0a 20 20 2a 2a  m reporting.  **
b560: 20 65 72 72 6f 72 73 2e 20 20 54 68 65 20 72 65   errors.  The re
b570: 70 6f 72 74 73 20 69 73 73 75 65 64 20 62 79 20  ports issued by 
b580: 76 61 6c 67 72 69 6e 64 20 61 72 65 20 69 6e 63  valgrind are inc
b590: 6f 72 72 65 63 74 20 2d 20 77 65 20 77 6f 75 6c  orrect - we woul
b5a0: 64 0a 20 20 2a 2a 20 70 72 65 66 65 72 20 74 68  d.  ** prefer th
b5b0: 61 74 20 74 68 65 20 72 61 6e 64 6f 6d 6e 65 73  at the randomnes
b5c0: 73 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 62  s be increased b
b5d0: 79 20 6d 61 6b 69 6e 67 20 75 73 65 20 6f 66 20  y making use of 
b5e0: 74 68 65 0a 20 20 2a 2a 20 75 6e 69 6e 69 74 69  the.  ** uniniti
b5f0: 61 6c 69 7a 65 64 20 73 70 61 63 65 20 69 6e 20  alized space in 
b600: 7a 42 75 66 20 2d 20 62 75 74 20 76 61 6c 67 72  zBuf - but valgr
b610: 69 6e 64 20 65 72 72 6f 72 73 20 74 65 6e 64 20  ind errors tend 
b620: 74 6f 20 77 6f 72 72 79 0a 20 20 2a 2a 20 73 6f  to worry.  ** so
b630: 6d 65 20 75 73 65 72 73 2e 20 20 52 61 74 68 65  me users.  Rathe
b640: 72 20 74 68 61 6e 20 61 72 67 75 65 2c 20 69 74  r than argue, it
b650: 20 73 65 65 6d 73 20 65 61 73 69 65 72 20 6a 75   seems easier ju
b660: 73 74 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65  st to initialize
b670: 0a 20 20 2a 2a 20 74 68 65 20 77 68 6f 6c 65 20  .  ** the whole 
b680: 61 72 72 61 79 20 61 6e 64 20 73 69 6c 65 6e 63  array and silenc
b690: 65 20 76 61 6c 67 72 69 6e 64 2c 20 65 76 65 6e  e valgrind, even
b6a0: 20 69 66 20 74 68 61 74 20 6d 65 61 6e 73 20 6c   if that means l
b6b0: 65 73 73 20 72 61 6e 64 6f 6d 6e 65 73 73 0a 20  ess randomness. 
b6c0: 20 2a 2a 20 69 6e 20 74 68 65 20 72 61 6e 64 6f   ** in the rando
b6d0: 6d 20 73 65 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a  m seed..  **.  *
b6e0: 2a 20 57 68 65 6e 20 74 65 73 74 69 6e 67 2c 20  * When testing, 
b6f0: 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 7a 42 75  initializing zBu
b700: 66 5b 5d 20 74 6f 20 7a 65 72 6f 20 69 73 20 61  f[] to zero is a
b710: 6c 6c 20 77 65 20 64 6f 2e 20 20 54 68 61 74 20  ll we do.  That 
b720: 6d 65 61 6e 73 0a 20 20 2a 2a 20 74 68 61 74 20  means.  ** that 
b730: 77 65 20 61 6c 77 61 79 73 20 75 73 65 20 74 68  we always use th
b740: 65 20 73 61 6d 65 20 72 61 6e 64 6f 6d 20 6e 75  e same random nu
b750: 6d 62 65 72 20 73 65 71 75 65 6e 63 65 2e 2a 20  mber sequence.* 
b760: 54 68 69 73 20 6d 61 6b 65 73 20 74 68 65 0a 20  This makes the. 
b770: 20 2a 2a 20 74 65 73 74 73 20 72 65 70 65 61 74   ** tests repeat
b780: 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 6d 65 6d  able..  */.  mem
b790: 73 65 74 28 7a 42 75 66 2c 20 30 2c 20 32 35 36  set(zBuf, 0, 256
b7a0: 29 3b 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28  );.#if !defined(
b7b0: 53 51 4c 49 54 45 5f 54 45 53 54 29 0a 20 20 7b  SQLITE_TEST).  {
b7c0: 0a 20 20 20 20 69 6e 74 20 70 69 64 2c 20 66 64  .    int pid, fd
b7d0: 3b 0a 20 20 20 20 66 64 20 3d 20 6f 70 65 6e 28  ;.    fd = open(
b7e0: 22 2f 64 65 76 2f 75 72 61 6e 64 6f 6d 22 2c 20  "/dev/urandom", 
b7f0: 4f 5f 52 44 4f 4e 4c 59 29 3b 0a 20 20 20 20 69  O_RDONLY);.    i
b800: 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 20 20  f( fd<0 ){.     
b810: 20 74 69 6d 65 28 28 74 69 6d 65 5f 74 2a 29 7a   time((time_t*)z
b820: 42 75 66 29 3b 0a 20 20 20 20 20 20 70 69 64 20  Buf);.      pid 
b830: 3d 20 67 65 74 70 69 64 28 29 3b 0a 20 20 20 20  = getpid();.    
b840: 20 20 6d 65 6d 63 70 79 28 26 7a 42 75 66 5b 73    memcpy(&zBuf[s
b850: 69 7a 65 6f 66 28 74 69 6d 65 5f 74 29 5d 2c 20  izeof(time_t)], 
b860: 26 70 69 64 2c 20 73 69 7a 65 6f 66 28 70 69 64  &pid, sizeof(pid
b870: 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ));.    }else{. 
b880: 20 20 20 20 20 72 65 61 64 28 66 64 2c 20 7a 42       read(fd, zB
b890: 75 66 2c 20 32 35 36 29 3b 0a 20 20 20 20 20 20  uf, 256);.      
b8a0: 63 6c 6f 73 65 28 66 64 29 3b 0a 20 20 20 20 7d  close(fd);.    }
b8b0: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65  .  }.#endif.  re
b8c0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
b8d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6c 65 65 70 20 66  }../*.** Sleep f
b8e0: 6f 72 20 61 20 6c 69 74 74 6c 65 20 77 68 69 6c  or a little whil
b8f0: 65 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 61  e.  Return the a
b900: 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 73 6c  mount of time sl
b910: 65 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ept..*/.static i
b920: 6e 74 20 75 6e 69 78 53 6c 65 65 70 28 69 6e 74  nt unixSleep(int
b930: 20 6d 73 29 7b 0a 23 69 66 20 64 65 66 69 6e 65   ms){.#if define
b940: 64 28 48 41 56 45 5f 55 53 4c 45 45 50 29 20 26  d(HAVE_USLEEP) &
b950: 26 20 48 41 56 45 5f 55 53 4c 45 45 50 0a 20 20  & HAVE_USLEEP.  
b960: 75 73 6c 65 65 70 28 6d 73 2a 31 30 30 30 29 3b  usleep(ms*1000);
b970: 0a 20 20 72 65 74 75 72 6e 20 6d 73 3b 0a 23 65  .  return ms;.#e
b980: 6c 73 65 0a 20 20 73 6c 65 65 70 28 28 6d 73 2b  lse.  sleep((ms+
b990: 39 39 39 29 2f 31 30 30 30 29 3b 0a 20 20 72 65  999)/1000);.  re
b9a0: 74 75 72 6e 20 31 30 30 30 2a 28 28 6d 73 2b 39  turn 1000*((ms+9
b9b0: 39 39 29 2f 31 30 30 30 29 3b 0a 23 65 6e 64 69  99)/1000);.#endi
b9c0: 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 61 74 69  f.}../*.** Stati
b9d0: 63 20 76 61 72 69 61 62 6c 65 73 20 75 73 65 64  c variables used
b9e0: 20 66 6f 72 20 74 68 72 65 61 64 20 73 79 6e 63   for thread sync
b9f0: 68 72 6f 6e 69 7a 61 74 69 6f 6e 0a 2a 2f 0a 73  hronization.*/.s
ba00: 74 61 74 69 63 20 69 6e 74 20 69 6e 4d 75 74 65  tatic int inMute
ba10: 78 20 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51  x = 0;.#ifdef SQ
ba20: 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52 45 41 44  LITE_UNIX_THREAD
ba30: 53 0a 73 74 61 74 69 63 20 70 74 68 72 65 61 64  S.static pthread
ba40: 5f 6d 75 74 65 78 5f 74 20 6d 75 74 65 78 20 3d  _mutex_t mutex =
ba50: 20 50 54 48 52 45 41 44 5f 4d 55 54 45 58 5f 49   PTHREAD_MUTEX_I
ba60: 4e 49 54 49 41 4c 49 5a 45 52 3b 0a 23 65 6e 64  NITIALIZER;.#end
ba70: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  if../*.** The fo
ba80: 6c 6c 6f 77 69 6e 67 20 70 61 69 72 20 6f 66 20  llowing pair of 
ba90: 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 6e  routine implemen
baa0: 74 20 6d 75 74 75 61 6c 20 65 78 63 6c 75 73 69  t mutual exclusi
bab0: 6f 6e 20 66 6f 72 0a 2a 2a 20 6d 75 6c 74 69 2d  on for.** multi-
bac0: 74 68 72 65 61 64 65 64 20 70 72 6f 63 65 73 73  threaded process
bad0: 65 73 2e 20 20 4f 6e 6c 79 20 61 20 73 69 6e 67  es.  Only a sing
bae0: 6c 65 20 74 68 72 65 61 64 20 69 73 20 61 6c 6c  le thread is all
baf0: 6f 77 65 64 20 74 6f 0a 2a 2a 20 65 78 65 63 75  owed to.** execu
bb00: 74 65 64 20 63 6f 64 65 20 74 68 61 74 20 69 73  ted code that is
bb10: 20 73 75 72 72 6f 75 6e 64 65 64 20 62 79 20 45   surrounded by E
bb20: 6e 74 65 72 4d 75 74 65 78 28 29 20 61 6e 64 20  nterMutex() and 
bb30: 4c 65 61 76 65 4d 75 74 65 78 28 29 2e 0a 2a 2a  LeaveMutex()..**
bb40: 0a 2a 2a 20 53 51 4c 69 74 65 20 75 73 65 73 20  .** SQLite uses 
bb50: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 4d 75  only a single Mu
bb60: 74 65 78 2e 20 20 54 68 65 72 65 20 69 73 20 6e  tex.  There is n
bb70: 6f 74 20 6d 75 63 68 20 63 72 69 74 69 63 61 6c  ot much critical
bb80: 0a 2a 2a 20 63 6f 64 65 20 61 6e 64 20 77 68 61  .** code and wha
bb90: 74 20 6c 69 74 74 6c 65 20 74 68 65 72 65 20 69  t little there i
bba0: 73 20 65 78 65 63 75 74 65 73 20 71 75 69 63 6b  s executes quick
bbb0: 6c 79 20 61 6e 64 20 77 69 74 68 6f 75 74 20 62  ly and without b
bbc0: 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74  locking..*/.stat
bbd0: 69 63 20 76 6f 69 64 20 75 6e 69 78 45 6e 74 65  ic void unixEnte
bbe0: 72 4d 75 74 65 78 28 29 7b 0a 23 69 66 64 65 66  rMutex(){.#ifdef
bbf0: 20 53 51 4c 49 54 45 5f 55 4e 49 58 5f 54 48 52   SQLITE_UNIX_THR
bc00: 45 41 44 53 0a 20 20 70 74 68 72 65 61 64 5f 6d  EADS.  pthread_m
bc10: 75 74 65 78 5f 6c 6f 63 6b 28 26 6d 75 74 65 78  utex_lock(&mutex
bc20: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 65  );.#endif.  asse
bc30: 72 74 28 20 21 69 6e 4d 75 74 65 78 20 29 3b 0a  rt( !inMutex );.
bc40: 20 20 69 6e 4d 75 74 65 78 20 3d 20 31 3b 0a 7d    inMutex = 1;.}
bc50: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69  .static void uni
bc60: 78 4c 65 61 76 65 4d 75 74 65 78 28 29 7b 0a 20  xLeaveMutex(){. 
bc70: 20 61 73 73 65 72 74 28 20 69 6e 4d 75 74 65 78   assert( inMutex
bc80: 20 29 3b 0a 20 20 69 6e 4d 75 74 65 78 20 3d 20   );.  inMutex = 
bc90: 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  0;.#ifdef SQLITE
bca0: 5f 55 4e 49 58 5f 54 48 52 45 41 44 53 0a 20 20  _UNIX_THREADS.  
bcb0: 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e  pthread_mutex_un
bcc0: 6c 6f 63 6b 28 26 6d 75 74 65 78 29 3b 0a 23 65  lock(&mutex);.#e
bcd0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  ndif.}../*.** Th
bce0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69  e following vari
bcf0: 61 62 6c 65 2c 20 69 66 20 73 65 74 20 74 6f 20  able, if set to 
bd00: 61 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65  a non-zero value
bd10: 2c 20 62 65 63 6f 6d 65 73 20 74 68 65 20 72 65  , becomes the re
bd20: 73 75 6c 74 0a 2a 2a 20 72 65 74 75 72 6e 65 64  sult.** returned
bd30: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 4f 73 2e   from sqlite3Os.
bd40: 78 43 75 72 72 65 6e 74 54 69 6d 65 28 29 2e 20  xCurrentTime(). 
bd50: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 66 6f   This is used fo
bd60: 72 20 74 65 73 74 69 6e 67 2e 0a 2a 2f 0a 23 69  r testing..*/.#i
bd70: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
bd80: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 75 72  .int sqlite3_cur
bd90: 72 65 6e 74 5f 74 69 6d 65 20 3d 20 30 3b 0a 23  rent_time = 0;.#
bda0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e  endif../*.** Fin
bdb0: 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 69  d the current ti
bdc0: 6d 65 20 28 69 6e 20 55 6e 69 76 65 72 73 61 6c  me (in Universal
bdd0: 20 43 6f 6f 72 64 69 6e 61 74 65 64 20 54 69 6d   Coordinated Tim
bde0: 65 29 2e 20 20 57 72 69 74 65 20 74 68 65 0a 2a  e).  Write the.*
bdf0: 2a 20 63 75 72 72 65 6e 74 20 74 69 6d 65 20 61  * current time a
be00: 6e 64 20 64 61 74 65 20 61 73 20 61 20 4a 75 6c  nd date as a Jul
be10: 69 61 6e 20 44 61 79 20 6e 75 6d 62 65 72 20 69  ian Day number i
be20: 6e 74 6f 20 2a 70 72 4e 6f 77 20 61 6e 64 0a 2a  nto *prNow and.*
be30: 2a 20 72 65 74 75 72 6e 20 30 2e 20 20 52 65 74  * return 0.  Ret
be40: 75 72 6e 20 31 20 69 66 20 74 68 65 20 74 69 6d  urn 1 if the tim
be50: 65 20 61 6e 64 20 64 61 74 65 20 63 61 6e 6e 6f  e and date canno
be60: 74 20 62 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73  t be found..*/.s
be70: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 78 43 75  tatic int unixCu
be80: 72 72 65 6e 74 54 69 6d 65 28 64 6f 75 62 6c 65  rrentTime(double
be90: 20 2a 70 72 4e 6f 77 29 7b 0a 23 69 66 64 65 66   *prNow){.#ifdef
bea0: 20 4e 4f 5f 47 45 54 54 4f 44 0a 20 20 74 69 6d   NO_GETTOD.  tim
beb0: 65 5f 74 20 74 3b 0a 20 20 74 69 6d 65 28 26 74  e_t t;.  time(&t
bec0: 29 3b 0a 20 20 2a 70 72 4e 6f 77 20 3d 20 74 2f  );.  *prNow = t/
bed0: 38 36 34 30 30 2e 30 20 2b 20 32 34 34 30 35 38  86400.0 + 244058
bee0: 37 2e 35 3b 0a 23 65 6c 73 65 0a 20 20 73 74 72  7.5;.#else.  str
bef0: 75 63 74 20 74 69 6d 65 76 61 6c 20 73 4e 6f 77  uct timeval sNow
bf00: 3b 0a 20 20 73 74 72 75 63 74 20 74 69 6d 65 7a  ;.  struct timez
bf10: 6f 6e 65 20 73 54 7a 3b 20 20 2f 2a 20 4e 6f 74  one sTz;  /* Not
bf20: 20 75 73 65 64 20 2a 2f 0a 20 20 67 65 74 74 69   used */.  getti
bf30: 6d 65 6f 66 64 61 79 28 26 73 4e 6f 77 2c 20 26  meofday(&sNow, &
bf40: 73 54 7a 29 3b 0a 20 20 2a 70 72 4e 6f 77 20 3d  sTz);.  *prNow =
bf50: 20 32 34 34 30 35 38 37 2e 35 20 2b 20 73 4e 6f   2440587.5 + sNo
bf60: 77 2e 74 76 5f 73 65 63 2f 38 36 34 30 30 2e 30  w.tv_sec/86400.0
bf70: 20 2b 20 73 4e 6f 77 2e 74 76 5f 75 73 65 63 2f   + sNow.tv_usec/
bf80: 38 36 34 30 30 30 30 30 30 30 30 2e 30 3b 0a 23  86400000000.0;.#
bf90: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c  endif.#ifdef SQL
bfa0: 49 54 45 5f 54 45 53 54 0a 20 20 69 66 28 20 73  ITE_TEST.  if( s
bfb0: 71 6c 69 74 65 33 5f 63 75 72 72 65 6e 74 5f 74  qlite3_current_t
bfc0: 69 6d 65 20 29 7b 0a 20 20 20 20 2a 70 72 4e 6f  ime ){.    *prNo
bfd0: 77 20 3d 20 73 71 6c 69 74 65 33 5f 63 75 72 72  w = sqlite3_curr
bfe0: 65 6e 74 5f 74 69 6d 65 2f 38 36 34 30 30 2e 30  ent_time/86400.0
bff0: 20 2b 20 32 34 34 30 35 38 37 2e 35 3b 0a 20 20   + 2440587.5;.  
c000: 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72  }.#endif.  retur
c010: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 20 4d 61 63 72 6f  n 0;.}../* Macro
c020: 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 65 6e 74   used to comment
c030: 20 6f 75 74 20 72 6f 75 74 69 6e 65 73 20 74 68   out routines th
c040: 61 74 20 64 6f 20 6e 6f 74 20 65 78 69 73 74 73  at do not exists
c050: 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 0a 2a   when there is.*
c060: 2a 20 6e 6f 20 64 69 73 6b 20 49 2f 4f 20 2a 2f  * no disk I/O */
c070: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f  .#ifdef SQLITE_O
c080: 4d 49 54 5f 44 49 53 4b 49 4f 0a 23 20 64 65 66  MIT_DISKIO.# def
c090: 69 6e 65 20 49 46 5f 44 49 53 4b 49 4f 28 58 29  ine IF_DISKIO(X)
c0a0: 20 20 30 0a 23 65 6c 73 65 0a 23 20 64 65 66 69    0.#else.# defi
c0b0: 6e 65 20 49 46 5f 44 49 53 4b 49 4f 28 58 29 20  ne IF_DISKIO(X) 
c0c0: 20 58 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a   X.#endif../*.**
c0d0: 20 54 68 69 73 20 69 73 20 74 68 65 20 73 74 72   This is the str
c0e0: 75 63 74 75 72 65 20 74 68 61 74 20 64 65 66 69  ucture that defi
c0f0: 6e 65 73 20 61 6c 6c 20 6f 66 20 74 68 65 20 49  nes all of the I
c100: 2f 4f 20 72 6f 75 74 69 6e 65 73 2e 0a 2a 2f 0a  /O routines..*/.
c110: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 4f 73  struct sqlite3Os
c120: 56 74 62 6c 20 73 71 6c 69 74 65 33 4f 73 20 3d  Vtbl sqlite3Os =
c130: 20 7b 0a 20 20 49 46 5f 44 49 53 4b 49 4f 28 20   {.  IF_DISKIO( 
c140: 75 6e 69 78 4f 70 65 6e 52 65 61 64 57 72 69 74  unixOpenReadWrit
c150: 65 20 29 2c 0a 20 20 49 46 5f 44 49 53 4b 49 4f  e ),.  IF_DISKIO
c160: 28 20 75 6e 69 78 4f 70 65 6e 45 78 63 6c 75 73  ( unixOpenExclus
c170: 69 76 65 20 29 2c 0a 20 20 49 46 5f 44 49 53 4b  ive ),.  IF_DISK
c180: 49 4f 28 20 75 6e 69 78 4f 70 65 6e 52 65 61 64  IO( unixOpenRead
c190: 4f 6e 6c 79 20 29 2c 0a 20 20 49 46 5f 44 49 53  Only ),.  IF_DIS
c1a0: 4b 49 4f 28 20 75 6e 69 78 44 65 6c 65 74 65 20  KIO( unixDelete 
c1b0: 29 2c 0a 20 20 49 46 5f 44 49 53 4b 49 4f 28 20  ),.  IF_DISKIO( 
c1c0: 75 6e 69 78 46 69 6c 65 45 78 69 73 74 73 20 29  unixFileExists )
c1d0: 2c 0a 20 20 49 46 5f 44 49 53 4b 49 4f 28 20 75  ,.  IF_DISKIO( u
c1e0: 6e 69 78 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20  nixFullPathname 
c1f0: 29 2c 0a 20 20 49 46 5f 44 49 53 4b 49 4f 28 20  ),.  IF_DISKIO( 
c200: 75 6e 69 78 49 73 44 69 72 57 72 69 74 61 62 6c  unixIsDirWritabl
c210: 65 20 29 2c 0a 20 20 49 46 5f 44 49 53 4b 49 4f  e ),.  IF_DISKIO
c220: 28 20 75 6e 69 78 53 79 6e 63 44 69 72 65 63 74  ( unixSyncDirect
c230: 6f 72 79 20 29 2c 0a 20 20 49 46 5f 44 49 53 4b  ory ),.  IF_DISK
c240: 49 4f 28 20 75 6e 69 78 54 65 6d 70 46 69 6c 65  IO( unixTempFile
c250: 4e 61 6d 65 20 29 2c 0a 20 20 75 6e 69 78 52 61  Name ),.  unixRa
c260: 6e 64 6f 6d 53 65 65 64 2c 0a 20 20 75 6e 69 78  ndomSeed,.  unix
c270: 53 6c 65 65 70 2c 0a 20 20 75 6e 69 78 43 75 72  Sleep,.  unixCur
c280: 72 65 6e 74 54 69 6d 65 2c 0a 20 20 75 6e 69 78  rentTime,.  unix
c290: 45 6e 74 65 72 4d 75 74 65 78 2c 0a 20 20 75 6e  EnterMutex,.  un
c2a0: 69 78 4c 65 61 76 65 4d 75 74 65 78 2c 0a 7d 3b  ixLeaveMutex,.};
c2b0: 0a 0a 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 4f 53  ....#endif /* OS
c2c0: 5f 55 4e 49 58 20 2a 2f 0a                       _UNIX */.