/ Hex Artifact Content
Login

Artifact 17fc73165cb7436aa79492d2dff754baec74fcb9:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 36 0a 2a 2a 0a 2a 2a 20 54 68  mber 16.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a  ***********.**.*
0180: 2a 20 54 68 69 73 20 68 65 61 64 65 72 20 66 69  * This header fi
0190: 6c 65 20 28 74 6f 67 65 74 68 65 72 20 77 69 74  le (together wit
01a0: 68 20 69 73 20 63 6f 6d 70 61 6e 69 6f 6e 20 43  h is companion C
01b0: 20 73 6f 75 72 63 65 2d 63 6f 64 65 20 66 69 6c   source-code fil
01c0: 65 0a 2a 2a 20 22 6f 73 2e 63 22 29 20 61 74 74  e.** "os.c") att
01d0: 65 6d 70 74 20 74 6f 20 61 62 73 74 72 61 63 74  empt to abstract
01e0: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20   the underlying 
01f0: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d  operating system
0200: 20 73 6f 20 74 68 61 74 0a 2a 2a 20 74 68 65 20   so that.** the 
0210: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 77  SQLite library w
0220: 69 6c 6c 20 77 6f 72 6b 20 6f 6e 20 62 6f 74 68  ill work on both
0230: 20 50 4f 53 49 58 20 61 6e 64 20 77 69 6e 64 6f   POSIX and windo
0240: 77 73 20 73 79 73 74 65 6d 73 2e 0a 2a 2f 0a 23  ws systems..*/.#
0250: 69 66 6e 64 65 66 20 5f 53 51 4c 49 54 45 5f 4f  ifndef _SQLITE_O
0260: 53 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f 53 51  S_H_.#define _SQ
0270: 4c 49 54 45 5f 4f 53 5f 48 5f 0a 0a 2f 2a 0a 2a  LITE_OS_H_../*.*
0280: 2a 20 46 69 67 75 72 65 20 6f 75 74 20 69 66 20  * Figure out if 
0290: 77 65 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77  we are dealing w
02a0: 69 74 68 20 55 6e 69 78 2c 20 57 69 6e 64 6f 77  ith Unix, Window
02b0: 73 2c 20 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72  s, or some other
02c0: 0a 2a 2a 20 6f 70 65 72 61 74 69 6e 67 20 73 79  .** operating sy
02d0: 73 74 65 6d 2e 0a 2a 2f 0a 23 69 66 20 21 64 65  stem..*/.#if !de
02e0: 66 69 6e 65 64 28 4f 53 5f 55 4e 49 58 29 20 26  fined(OS_UNIX) &
02f0: 26 20 21 64 65 66 69 6e 65 64 28 4f 53 5f 4f 54  & !defined(OS_OT
0300: 48 45 52 29 0a 23 20 64 65 66 69 6e 65 20 4f 53  HER).# define OS
0310: 5f 4f 54 48 45 52 20 30 0a 23 20 69 66 6e 64 65  _OTHER 0.# ifnde
0320: 66 20 4f 53 5f 57 49 4e 0a 23 20 20 20 69 66 20  f OS_WIN.#   if 
0330: 64 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 29 20  defined(_WIN32) 
0340: 7c 7c 20 64 65 66 69 6e 65 64 28 57 49 4e 33 32  || defined(WIN32
0350: 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 43  ) || defined(__C
0360: 59 47 57 49 4e 5f 5f 29 20 7c 7c 20 64 65 66 69  YGWIN__) || defi
0370: 6e 65 64 28 5f 5f 4d 49 4e 47 57 33 32 5f 5f 29  ned(__MINGW32__)
0380: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 42 4f   || defined(__BO
0390: 52 4c 41 4e 44 43 5f 5f 29 0a 23 20 20 20 20 20  RLANDC__).#     
03a0: 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e 20 31 0a  define OS_WIN 1.
03b0: 23 20 20 20 20 20 64 65 66 69 6e 65 20 4f 53 5f  #     define OS_
03c0: 55 4e 49 58 20 30 0a 23 20 20 20 20 20 64 65 66  UNIX 0.#     def
03d0: 69 6e 65 20 4f 53 5f 4f 53 32 20 30 0a 23 20 20  ine OS_OS2 0.#  
03e0: 20 65 6c 69 66 20 64 65 66 69 6e 65 64 28 5f 45   elif defined(_E
03f0: 4d 58 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28  MX_) || defined(
0400: 5f 4f 53 32 29 20 7c 7c 20 64 65 66 69 6e 65 64  _OS2) || defined
0410: 28 4f 53 32 29 20 7c 7c 20 64 65 66 69 6e 65 64  (OS2) || defined
0420: 28 5f 4f 53 32 5f 29 20 7c 7c 20 64 65 66 69 6e  (_OS2_) || defin
0430: 65 64 28 5f 5f 4f 53 32 5f 5f 29 0a 23 20 20 20  ed(__OS2__).#   
0440: 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e 20    define OS_WIN 
0450: 30 0a 23 20 20 20 20 20 64 65 66 69 6e 65 20 4f  0.#     define O
0460: 53 5f 55 4e 49 58 20 30 0a 23 20 20 20 20 20 64  S_UNIX 0.#     d
0470: 65 66 69 6e 65 20 4f 53 5f 4f 53 32 20 31 0a 23  efine OS_OS2 1.#
0480: 20 20 20 65 6c 73 65 0a 23 20 20 20 20 20 64 65     else.#     de
0490: 66 69 6e 65 20 4f 53 5f 57 49 4e 20 30 0a 23 20  fine OS_WIN 0.# 
04a0: 20 20 20 20 64 65 66 69 6e 65 20 4f 53 5f 55 4e      define OS_UN
04b0: 49 58 20 31 0a 23 20 20 20 20 20 64 65 66 69 6e  IX 1.#     defin
04c0: 65 20 4f 53 5f 4f 53 32 20 30 0a 23 20 20 65 6e  e OS_OS2 0.#  en
04d0: 64 69 66 0a 23 20 65 6c 73 65 0a 23 20 20 64 65  dif.# else.#  de
04e0: 66 69 6e 65 20 4f 53 5f 55 4e 49 58 20 30 0a 23  fine OS_UNIX 0.#
04f0: 20 20 64 65 66 69 6e 65 20 4f 53 5f 4f 53 32 20    define OS_OS2 
0500: 30 0a 23 20 65 6e 64 69 66 0a 23 65 6c 73 65 0a  0.# endif.#else.
0510: 23 20 69 66 6e 64 65 66 20 4f 53 5f 57 49 4e 0a  # ifndef OS_WIN.
0520: 23 20 20 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e  #  define OS_WIN
0530: 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69   0.# endif.#endi
0540: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 69 6e 65  f.../*.** Define
0550: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a   the maximum siz
0560: 65 20 6f 66 20 61 20 74 65 6d 70 6f 72 61 72 79  e of a temporary
0570: 20 66 69 6c 65 6e 61 6d 65 0a 2a 2f 0a 23 69 66   filename.*/.#if
0580: 20 4f 53 5f 57 49 4e 0a 23 20 69 6e 63 6c 75 64   OS_WIN.# includ
0590: 65 20 3c 77 69 6e 64 6f 77 73 2e 68 3e 0a 23 20  e <windows.h>.# 
05a0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 45  define SQLITE_TE
05b0: 4d 50 4e 41 4d 45 5f 53 49 5a 45 20 28 4d 41 58  MPNAME_SIZE (MAX
05c0: 5f 50 41 54 48 2b 35 30 29 0a 23 65 6c 69 66 20  _PATH+50).#elif 
05d0: 4f 53 5f 4f 53 32 0a 23 20 64 65 66 69 6e 65 20  OS_OS2.# define 
05e0: 49 4e 43 4c 5f 44 4f 53 44 41 54 45 54 49 4d 45  INCL_DOSDATETIME
05f0: 0a 23 20 64 65 66 69 6e 65 20 49 4e 43 4c 5f 44  .# define INCL_D
0600: 4f 53 46 49 4c 45 4d 47 52 0a 23 20 64 65 66 69  OSFILEMGR.# defi
0610: 6e 65 20 49 4e 43 4c 5f 44 4f 53 45 52 52 4f 52  ne INCL_DOSERROR
0620: 53 0a 23 20 64 65 66 69 6e 65 20 49 4e 43 4c 5f  S.# define INCL_
0630: 44 4f 53 4d 49 53 43 0a 23 20 64 65 66 69 6e 65  DOSMISC.# define
0640: 20 49 4e 43 4c 5f 44 4f 53 50 52 4f 43 45 53 53   INCL_DOSPROCESS
0650: 0a 23 20 69 6e 63 6c 75 64 65 20 3c 6f 73 32 2e  .# include <os2.
0660: 68 3e 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49  h>.# define SQLI
0670: 54 45 5f 54 45 4d 50 4e 41 4d 45 5f 53 49 5a 45  TE_TEMPNAME_SIZE
0680: 20 28 43 43 48 4d 41 58 50 41 54 48 43 4f 4d 50   (CCHMAXPATHCOMP
0690: 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65  ).#else.# define
06a0: 20 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45   SQLITE_TEMPNAME
06b0: 5f 53 49 5a 45 20 32 30 30 0a 23 65 6e 64 69 66  _SIZE 200.#endif
06c0: 0a 0a 2f 2a 20 49 66 20 74 68 65 20 53 45 54 5f  ../* If the SET_
06d0: 46 55 4c 4c 53 59 4e 43 20 6d 61 63 72 6f 20 69  FULLSYNC macro i
06e0: 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 61 62  s not defined ab
06f0: 6f 76 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 69  ove, then make i
0700: 74 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 0a 2a 2f 0a  t.** a no-op.*/.
0710: 23 69 66 6e 64 65 66 20 53 45 54 5f 46 55 4c 4c  #ifndef SET_FULL
0720: 53 59 4e 43 0a 23 20 64 65 66 69 6e 65 20 53 45  SYNC.# define SE
0730: 54 5f 46 55 4c 4c 53 59 4e 43 28 78 2c 79 29 0a  T_FULLSYNC(x,y).
0740: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65  #endif../*.** Te
0750: 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 61 72  mporary files ar
0760: 65 20 6e 61 6d 65 64 20 73 74 61 72 74 69 6e 67  e named starting
0770: 20 77 69 74 68 20 74 68 69 73 20 70 72 65 66 69   with this prefi
0780: 78 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 31 36  x followed by 16
0790: 20 72 61 6e 64 6f 6d 0a 2a 2a 20 61 6c 70 68 61   random.** alpha
07a0: 6e 75 6d 65 72 69 63 20 63 68 61 72 61 63 74 65  numeric characte
07b0: 72 73 2c 20 61 6e 64 20 6e 6f 20 66 69 6c 65 20  rs, and no file 
07c0: 65 78 74 65 6e 73 69 6f 6e 2e 20 54 68 65 79 20  extension. They 
07d0: 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68  are stored in th
07e0: 65 0a 2a 2a 20 4f 53 27 73 20 73 74 61 6e 64 61  e.** OS's standa
07f0: 72 64 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c  rd temporary fil
0800: 65 20 64 69 72 65 63 74 6f 72 79 2c 20 61 6e 64  e directory, and
0810: 20 61 72 65 20 64 65 6c 65 74 65 64 20 70 72 69   are deleted pri
0820: 6f 72 20 74 6f 20 65 78 69 74 2e 0a 2a 2a 20 49  or to exit..** I
0830: 66 20 73 71 6c 69 74 65 20 69 73 20 62 65 69 6e  f sqlite is bein
0840: 67 20 65 6d 62 65 64 64 65 64 20 69 6e 20 61 6e  g embedded in an
0850: 6f 74 68 65 72 20 70 72 6f 67 72 61 6d 2c 20 79  other program, y
0860: 6f 75 20 6d 61 79 20 77 69 73 68 20 74 6f 20 63  ou may wish to c
0870: 68 61 6e 67 65 20 74 68 65 0a 2a 2a 20 70 72 65  hange the.** pre
0880: 66 69 78 20 74 6f 20 72 65 66 6c 65 63 74 20 79  fix to reflect y
0890: 6f 75 72 20 70 72 6f 67 72 61 6d 27 73 20 6e 61  our program's na
08a0: 6d 65 2c 20 73 6f 20 74 68 61 74 20 69 66 20 79  me, so that if y
08b0: 6f 75 72 20 70 72 6f 67 72 61 6d 20 65 78 69 74  our program exit
08c0: 73 0a 2a 2a 20 70 72 65 6d 61 74 75 72 65 6c 79  s.** prematurely
08d0: 2c 20 6f 6c 64 20 74 65 6d 70 6f 72 61 72 79 20  , old temporary 
08e0: 66 69 6c 65 73 20 63 61 6e 20 62 65 20 65 61 73  files can be eas
08f0: 69 6c 79 20 69 64 65 6e 74 69 66 69 65 64 2e 20  ily identified. 
0900: 54 68 69 73 20 63 61 6e 20 62 65 20 64 6f 6e 65  This can be done
0910: 0a 2a 2a 20 75 73 69 6e 67 20 2d 44 54 45 4d 50  .** using -DTEMP
0920: 5f 46 49 4c 45 5f 50 52 45 46 49 58 3d 6d 79 70  _FILE_PREFIX=myp
0930: 72 65 66 69 78 5f 20 6f 6e 20 74 68 65 20 63 6f  refix_ on the co
0940: 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 6e 64 20 6c  mpiler command l
0950: 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 32 30 30 36 2d  ine..**.** 2006-
0960: 31 30 2d 33 31 3a 20 20 54 68 65 20 64 65 66 61  10-31:  The defa
0970: 75 6c 74 20 70 72 65 66 69 78 20 75 73 65 64 20  ult prefix used 
0980: 74 6f 20 62 65 20 22 73 71 6c 69 74 65 5f 22 2e  to be "sqlite_".
0990: 20 20 42 75 74 20 74 68 65 6e 0a 2a 2a 20 4d 63    But then.** Mc
09a0: 61 66 65 65 20 73 74 61 72 74 65 64 20 75 73 69  afee started usi
09b0: 6e 67 20 53 51 4c 69 74 65 20 69 6e 20 74 68 65  ng SQLite in the
09c0: 69 72 20 61 6e 74 69 2d 76 69 72 75 73 20 70 72  ir anti-virus pr
09d0: 6f 64 75 63 74 20 61 6e 64 20 69 74 0a 2a 2a 20  oduct and it.** 
09e0: 73 74 61 72 74 65 64 20 70 75 74 74 69 6e 67 20  started putting 
09f0: 66 69 6c 65 73 20 77 69 74 68 20 74 68 65 20 22  files with the "
0a00: 73 71 6c 69 74 65 22 20 6e 61 6d 65 20 69 6e 20  sqlite" name in 
0a10: 74 68 65 20 63 3a 2f 74 65 6d 70 20 66 6f 6c 64  the c:/temp fold
0a20: 65 72 2e 0a 2a 2a 20 54 68 69 73 20 61 6e 6e 6f  er..** This anno
0a30: 79 65 64 20 6d 61 6e 79 20 77 69 6e 64 6f 77 73  yed many windows
0a40: 20 75 73 65 72 73 2e 20 20 54 68 6f 73 65 20 75   users.  Those u
0a50: 73 65 72 73 20 77 6f 75 6c 64 20 74 68 65 6e 20  sers would then 
0a60: 64 6f 20 61 20 0a 2a 2a 20 47 6f 6f 67 6c 65 20  do a .** Google 
0a70: 73 65 61 72 63 68 20 66 6f 72 20 22 73 71 6c 69  search for "sqli
0a80: 74 65 22 2c 20 66 69 6e 64 20 74 68 65 20 74 65  te", find the te
0a90: 6c 65 70 68 6f 6e 65 20 6e 75 6d 62 65 72 73 20  lephone numbers 
0aa0: 6f 66 20 74 68 65 0a 2a 2a 20 64 65 76 65 6c 6f  of the.** develo
0ab0: 70 65 72 73 20 61 6e 64 20 63 61 6c 6c 20 74 6f  pers and call to
0ac0: 20 77 61 6b 65 20 74 68 65 6d 20 75 70 20 61 74   wake them up at
0ad0: 20 6e 69 67 68 74 20 61 6e 64 20 63 6f 6d 70 6c   night and compl
0ae0: 61 69 6e 2e 0a 2a 2a 20 46 6f 72 20 74 68 69 73  ain..** For this
0af0: 20 72 65 61 73 6f 6e 2c 20 74 68 65 20 64 65 66   reason, the def
0b00: 61 75 6c 74 20 6e 61 6d 65 20 70 72 65 66 69 78  ault name prefix
0b10: 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f 20 62   is changed to b
0b20: 65 20 22 73 71 6c 69 74 65 22 20 0a 2a 2a 20 73  e "sqlite" .** s
0b30: 70 65 6c 6c 65 64 20 62 61 63 6b 77 61 72 64 73  pelled backwards
0b40: 2e 20 20 53 6f 20 74 68 65 20 74 65 6d 70 20 66  .  So the temp f
0b50: 69 6c 65 73 20 61 72 65 20 73 74 69 6c 6c 20 69  iles are still i
0b60: 64 65 6e 74 69 66 69 65 64 2c 20 62 75 74 0a 2a  dentified, but.*
0b70: 2a 20 61 6e 79 62 6f 64 79 20 73 6d 61 72 74 20  * anybody smart 
0b80: 65 6e 6f 75 67 68 20 74 6f 20 66 69 67 75 72 65  enough to figure
0b90: 20 6f 75 74 20 74 68 65 20 63 6f 64 65 20 69 73   out the code is
0ba0: 20 61 6c 73 6f 20 6c 69 6b 65 6c 79 20 73 6d 61   also likely sma
0bb0: 72 74 0a 2a 2a 20 65 6e 6f 75 67 68 20 74 6f 20  rt.** enough to 
0bc0: 6b 6e 6f 77 20 74 68 61 74 20 63 61 6c 6c 69 6e  know that callin
0bd0: 67 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 20  g the developer 
0be0: 77 69 6c 6c 20 6e 6f 74 20 68 65 6c 70 20 67 65  will not help ge
0bf0: 74 20 72 69 64 0a 2a 2a 20 6f 66 20 74 68 65 20  t rid.** of the 
0c00: 66 69 6c 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66  file..*/.#ifndef
0c10: 20 54 45 4d 50 5f 46 49 4c 45 5f 50 52 45 46 49   TEMP_FILE_PREFI
0c20: 58 0a 23 20 64 65 66 69 6e 65 20 54 45 4d 50 5f  X.# define TEMP_
0c30: 46 49 4c 45 5f 50 52 45 46 49 58 20 22 65 74 69  FILE_PREFIX "eti
0c40: 6c 71 73 5f 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a  lqs_".#endif../*
0c50: 0a 2a 2a 20 44 65 66 69 6e 65 20 74 68 65 20 69  .** Define the i
0c60: 6e 74 65 72 66 61 63 65 73 20 66 6f 72 20 55 6e  nterfaces for Un
0c70: 69 78 2c 20 57 69 6e 64 6f 77 73 2c 20 61 6e 64  ix, Windows, and
0c80: 20 4f 53 2f 32 2e 0a 2a 2f 0a 23 69 66 20 4f 53   OS/2..*/.#if OS
0c90: 5f 55 4e 49 58 0a 23 64 65 66 69 6e 65 20 73 71  _UNIX.#define sq
0ca0: 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57  lite3OsOpenReadW
0cb0: 72 69 74 65 20 20 20 20 20 20 73 71 6c 69 74 65  rite      sqlite
0cc0: 33 55 6e 69 78 4f 70 65 6e 52 65 61 64 57 72 69  3UnixOpenReadWri
0cd0: 74 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  te.#define sqlit
0ce0: 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76  e3OsOpenExclusiv
0cf0: 65 20 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e  e      sqlite3Un
0d00: 69 78 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 0a  ixOpenExclusive.
0d10: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
0d20: 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 20 20 20  sOpenReadOnly   
0d30: 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78 4f      sqlite3UnixO
0d40: 70 65 6e 52 65 61 64 4f 6e 6c 79 0a 23 64 65 66  penReadOnly.#def
0d50: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 44 65 6c  ine sqlite3OsDel
0d60: 65 74 65 20 20 20 20 20 20 20 20 20 20 20 20 20  ete             
0d70: 73 71 6c 69 74 65 33 55 6e 69 78 44 65 6c 65 74  sqlite3UnixDelet
0d80: 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  e.#define sqlite
0d90: 33 4f 73 46 69 6c 65 45 78 69 73 74 73 20 20 20  3OsFileExists   
0da0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69        sqlite3Uni
0db0: 78 46 69 6c 65 45 78 69 73 74 73 0a 23 64 65 66  xFileExists.#def
0dc0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46 75 6c  ine sqlite3OsFul
0dd0: 6c 50 61 74 68 6e 61 6d 65 20 20 20 20 20 20 20  lPathname       
0de0: 73 71 6c 69 74 65 33 55 6e 69 78 46 75 6c 6c 50  sqlite3UnixFullP
0df0: 61 74 68 6e 61 6d 65 0a 23 64 65 66 69 6e 65 20  athname.#define 
0e00: 73 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72  sqlite3OsIsDirWr
0e10: 69 74 61 62 6c 65 20 20 20 20 20 20 73 71 6c 69  itable      sqli
0e20: 74 65 33 55 6e 69 78 49 73 44 69 72 57 72 69 74  te3UnixIsDirWrit
0e30: 61 62 6c 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  able.#define sql
0e40: 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74  ite3OsSyncDirect
0e50: 6f 72 79 20 20 20 20 20 20 73 71 6c 69 74 65 33  ory      sqlite3
0e60: 55 6e 69 78 53 79 6e 63 44 69 72 65 63 74 6f 72  UnixSyncDirector
0e70: 79 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  y.#define sqlite
0e80: 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65 20  3OsTempFileName 
0e90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69        sqlite3Uni
0ea0: 78 54 65 6d 70 46 69 6c 65 4e 61 6d 65 0a 23 64  xTempFileName.#d
0eb0: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52  efine sqlite3OsR
0ec0: 61 6e 64 6f 6d 53 65 65 64 20 20 20 20 20 20 20  andomSeed       
0ed0: 20 20 73 71 6c 69 74 65 33 55 6e 69 78 52 61 6e    sqlite3UnixRan
0ee0: 64 6f 6d 53 65 65 64 0a 23 64 65 66 69 6e 65 20  domSeed.#define 
0ef0: 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 20 20  sqlite3OsSleep  
0f00: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
0f10: 74 65 33 55 6e 69 78 53 6c 65 65 70 0a 23 64 65  te3UnixSleep.#de
0f20: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 43 75  fine sqlite3OsCu
0f30: 72 72 65 6e 74 54 69 6d 65 20 20 20 20 20 20 20  rrentTime       
0f40: 20 73 71 6c 69 74 65 33 55 6e 69 78 43 75 72 72   sqlite3UnixCurr
0f50: 65 6e 74 54 69 6d 65 0a 23 64 65 66 69 6e 65 20  entTime.#define 
0f60: 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75  sqlite3OsEnterMu
0f70: 74 65 78 20 20 20 20 20 20 20 20 20 73 71 6c 69  tex         sqli
0f80: 74 65 33 55 6e 69 78 45 6e 74 65 72 4d 75 74 65  te3UnixEnterMute
0f90: 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  x.#define sqlite
0fa0: 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 20 20 20  3OsLeaveMutex   
0fb0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69        sqlite3Uni
0fc0: 78 4c 65 61 76 65 4d 75 74 65 78 0a 23 64 65 66  xLeaveMutex.#def
0fd0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d  ine sqlite3OsInM
0fe0: 75 74 65 78 20 20 20 20 20 20 20 20 20 20 20 20  utex            
0ff0: 73 71 6c 69 74 65 33 55 6e 69 78 49 6e 4d 75 74  sqlite3UnixInMut
1000: 65 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  ex.#define sqlit
1010: 65 33 4f 73 54 68 72 65 61 64 53 70 65 63 69 66  e3OsThreadSpecif
1020: 69 63 44 61 74 61 20 73 71 6c 69 74 65 33 55 6e  icData sqlite3Un
1030: 69 78 54 68 72 65 61 64 53 70 65 63 69 66 69 63  ixThreadSpecific
1040: 44 61 74 61 0a 23 64 65 66 69 6e 65 20 73 71 6c  Data.#define sql
1050: 69 74 65 33 4f 73 4d 61 6c 6c 6f 63 20 20 20 20  ite3OsMalloc    
1060: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
1070: 47 65 6e 65 72 69 63 4d 61 6c 6c 6f 63 0a 23 64  GenericMalloc.#d
1080: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52  efine sqlite3OsR
1090: 65 61 6c 6c 6f 63 20 20 20 20 20 20 20 20 20 20  ealloc          
10a0: 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63    sqlite3Generic
10b0: 52 65 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20  Realloc.#define 
10c0: 73 71 6c 69 74 65 33 4f 73 46 72 65 65 20 20 20  sqlite3OsFree   
10d0: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
10e0: 74 65 33 47 65 6e 65 72 69 63 46 72 65 65 0a 23  te3GenericFree.#
10f0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
1100: 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 20 20  AllocationSize  
1110: 20 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69     sqlite3Generi
1120: 63 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a  cAllocationSize.
1130: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1140: 73 44 6c 6f 70 65 6e 20 20 20 20 20 20 20 20 20  sDlopen         
1150: 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78 44      sqlite3UnixD
1160: 6c 6f 70 65 6e 0a 23 64 65 66 69 6e 65 20 73 71  lopen.#define sq
1170: 6c 69 74 65 33 4f 73 44 6c 73 79 6d 20 20 20 20  lite3OsDlsym    
1180: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
1190: 33 55 6e 69 78 44 6c 73 79 6d 0a 23 64 65 66 69  3UnixDlsym.#defi
11a0: 6e 65 20 73 71 6c 69 74 65 33 4f 73 44 6c 63 6c  ne sqlite3OsDlcl
11b0: 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 20 73  ose            s
11c0: 71 6c 69 74 65 33 55 6e 69 78 44 6c 63 6c 6f 73  qlite3UnixDlclos
11d0: 65 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f  e.#endif.#if OS_
11e0: 57 49 4e 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  WIN.#define sqli
11f0: 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57 72 69  te3OsOpenReadWri
1200: 74 65 20 20 20 20 20 20 73 71 6c 69 74 65 33 57  te      sqlite3W
1210: 69 6e 4f 70 65 6e 52 65 61 64 57 72 69 74 65 0a  inOpenReadWrite.
1220: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1230: 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 20 20  sOpenExclusive  
1240: 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 4f 70      sqlite3WinOp
1250: 65 6e 45 78 63 6c 75 73 69 76 65 0a 23 64 65 66  enExclusive.#def
1260: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4f 70 65  ine sqlite3OsOpe
1270: 6e 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 20 20  nReadOnly       
1280: 73 71 6c 69 74 65 33 57 69 6e 4f 70 65 6e 52 65  sqlite3WinOpenRe
1290: 61 64 4f 6e 6c 79 0a 23 64 65 66 69 6e 65 20 73  adOnly.#define s
12a0: 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 20 20  qlite3OsDelete  
12b0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
12c0: 65 33 57 69 6e 44 65 6c 65 74 65 0a 23 64 65 66  e3WinDelete.#def
12d0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46 69 6c  ine sqlite3OsFil
12e0: 65 45 78 69 73 74 73 20 20 20 20 20 20 20 20 20  eExists         
12f0: 73 71 6c 69 74 65 33 57 69 6e 46 69 6c 65 45 78  sqlite3WinFileEx
1300: 69 73 74 73 0a 23 64 65 66 69 6e 65 20 73 71 6c  ists.#define sql
1310: 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 68 6e 61  ite3OsFullPathna
1320: 6d 65 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  me       sqlite3
1330: 57 69 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 0a  WinFullPathname.
1340: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1350: 73 49 73 44 69 72 57 72 69 74 61 62 6c 65 20 20  sIsDirWritable  
1360: 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 49 73      sqlite3WinIs
1370: 44 69 72 57 72 69 74 61 62 6c 65 0a 23 64 65 66  DirWritable.#def
1380: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 53 79 6e  ine sqlite3OsSyn
1390: 63 44 69 72 65 63 74 6f 72 79 20 20 20 20 20 20  cDirectory      
13a0: 73 71 6c 69 74 65 33 57 69 6e 53 79 6e 63 44 69  sqlite3WinSyncDi
13b0: 72 65 63 74 6f 72 79 0a 23 64 65 66 69 6e 65 20  rectory.#define 
13c0: 73 71 6c 69 74 65 33 4f 73 54 65 6d 70 46 69 6c  sqlite3OsTempFil
13d0: 65 4e 61 6d 65 20 20 20 20 20 20 20 73 71 6c 69  eName       sqli
13e0: 74 65 33 57 69 6e 54 65 6d 70 46 69 6c 65 4e 61  te3WinTempFileNa
13f0: 6d 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  me.#define sqlit
1400: 65 33 4f 73 52 61 6e 64 6f 6d 53 65 65 64 20 20  e3OsRandomSeed  
1410: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 57 69         sqlite3Wi
1420: 6e 52 61 6e 64 6f 6d 53 65 65 64 0a 23 64 65 66  nRandomSeed.#def
1430: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 53 6c 65  ine sqlite3OsSle
1440: 65 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ep              
1450: 73 71 6c 69 74 65 33 57 69 6e 53 6c 65 65 70 0a  sqlite3WinSleep.
1460: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1470: 73 43 75 72 72 65 6e 74 54 69 6d 65 20 20 20 20  sCurrentTime    
1480: 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 43 75      sqlite3WinCu
1490: 72 72 65 6e 74 54 69 6d 65 0a 23 64 65 66 69 6e  rrentTime.#defin
14a0: 65 20 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72  e sqlite3OsEnter
14b0: 4d 75 74 65 78 20 20 20 20 20 20 20 20 20 73 71  Mutex         sq
14c0: 6c 69 74 65 33 57 69 6e 45 6e 74 65 72 4d 75 74  lite3WinEnterMut
14d0: 65 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  ex.#define sqlit
14e0: 65 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 20 20  e3OsLeaveMutex  
14f0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 57 69         sqlite3Wi
1500: 6e 4c 65 61 76 65 4d 75 74 65 78 0a 23 64 65 66  nLeaveMutex.#def
1510: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d  ine sqlite3OsInM
1520: 75 74 65 78 20 20 20 20 20 20 20 20 20 20 20 20  utex            
1530: 73 71 6c 69 74 65 33 57 69 6e 49 6e 4d 75 74 65  sqlite3WinInMute
1540: 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  x.#define sqlite
1550: 33 4f 73 54 68 72 65 61 64 53 70 65 63 69 66 69  3OsThreadSpecifi
1560: 63 44 61 74 61 20 73 71 6c 69 74 65 33 57 69 6e  cData sqlite3Win
1570: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61  ThreadSpecificDa
1580: 74 61 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  ta.#define sqlit
1590: 65 33 4f 73 4d 61 6c 6c 6f 63 20 20 20 20 20 20  e3OsMalloc      
15a0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 65         sqlite3Ge
15b0: 6e 65 72 69 63 4d 61 6c 6c 6f 63 0a 23 64 65 66  nericMalloc.#def
15c0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52 65 61  ine sqlite3OsRea
15d0: 6c 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20 20  lloc            
15e0: 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63 52 65  sqlite3GenericRe
15f0: 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20 73 71  alloc.#define sq
1600: 6c 69 74 65 33 4f 73 46 72 65 65 20 20 20 20 20  lite3OsFree     
1610: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
1620: 33 47 65 6e 65 72 69 63 46 72 65 65 0a 23 64 65  3GenericFree.#de
1630: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 41 6c  fine sqlite3OsAl
1640: 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 20 20 20 20  locationSize    
1650: 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63 41   sqlite3GenericA
1660: 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a 23 64  llocationSize.#d
1670: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 44  efine sqlite3OsD
1680: 6c 6f 70 65 6e 20 20 20 20 20 20 20 20 20 20 20  lopen           
1690: 20 20 73 71 6c 69 74 65 33 57 69 6e 44 6c 6f 70    sqlite3WinDlop
16a0: 65 6e 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  en.#define sqlit
16b0: 65 33 4f 73 44 6c 73 79 6d 20 20 20 20 20 20 20  e3OsDlsym       
16c0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 57 69         sqlite3Wi
16d0: 6e 44 6c 73 79 6d 0a 23 64 65 66 69 6e 65 20 73  nDlsym.#define s
16e0: 71 6c 69 74 65 33 4f 73 44 6c 63 6c 6f 73 65 20  qlite3OsDlclose 
16f0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
1700: 65 33 57 69 6e 44 6c 63 6c 6f 73 65 0a 23 65 6e  e3WinDlclose.#en
1710: 64 69 66 0a 23 69 66 20 4f 53 5f 4f 53 32 0a 23  dif.#if OS_OS2.#
1720: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
1730: 4f 70 65 6e 52 65 61 64 57 72 69 74 65 20 20 20  OpenReadWrite   
1740: 20 20 20 73 71 6c 69 74 65 33 4f 73 32 4f 70 65     sqlite3Os2Ope
1750: 6e 52 65 61 64 57 72 69 74 65 0a 23 64 65 66 69  nReadWrite.#defi
1760: 6e 65 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e  ne sqlite3OsOpen
1770: 45 78 63 6c 75 73 69 76 65 20 20 20 20 20 20 73  Exclusive      s
1780: 71 6c 69 74 65 33 4f 73 32 4f 70 65 6e 45 78 63  qlite3Os2OpenExc
1790: 6c 75 73 69 76 65 0a 23 64 65 66 69 6e 65 20 73  lusive.#define s
17a0: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64  qlite3OsOpenRead
17b0: 4f 6e 6c 79 20 20 20 20 20 20 20 73 71 6c 69 74  Only       sqlit
17c0: 65 33 4f 73 32 4f 70 65 6e 52 65 61 64 4f 6e 6c  e3Os2OpenReadOnl
17d0: 79 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  y.#define sqlite
17e0: 33 4f 73 44 65 6c 65 74 65 20 20 20 20 20 20 20  3OsDelete       
17f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 32        sqlite3Os2
1800: 44 65 6c 65 74 65 0a 23 64 65 66 69 6e 65 20 73  Delete.#define s
1810: 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73  qlite3OsFileExis
1820: 74 73 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  ts         sqlit
1830: 65 33 4f 73 32 46 69 6c 65 45 78 69 73 74 73 0a  e3Os2FileExists.
1840: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1850: 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 20 20  sFullPathname   
1860: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 32 46 75      sqlite3Os2Fu
1870: 6c 6c 50 61 74 68 6e 61 6d 65 0a 23 64 65 66 69  llPathname.#defi
1880: 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 73 44 69  ne sqlite3OsIsDi
1890: 72 57 72 69 74 61 62 6c 65 20 20 20 20 20 20 73  rWritable      s
18a0: 71 6c 69 74 65 33 4f 73 32 49 73 44 69 72 57 72  qlite3Os2IsDirWr
18b0: 69 74 61 62 6c 65 0a 23 64 65 66 69 6e 65 20 73  itable.#define s
18c0: 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65  qlite3OsSyncDire
18d0: 63 74 6f 72 79 20 20 20 20 20 20 73 71 6c 69 74  ctory      sqlit
18e0: 65 33 4f 73 32 53 79 6e 63 44 69 72 65 63 74 6f  e3Os2SyncDirecto
18f0: 72 79 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  ry.#define sqlit
1900: 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65  e3OsTempFileName
1910: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73         sqlite3Os
1920: 32 54 65 6d 70 46 69 6c 65 4e 61 6d 65 0a 23 64  2TempFileName.#d
1930: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52  efine sqlite3OsR
1940: 61 6e 64 6f 6d 53 65 65 64 20 20 20 20 20 20 20  andomSeed       
1950: 20 20 73 71 6c 69 74 65 33 4f 73 32 52 61 6e 64    sqlite3Os2Rand
1960: 6f 6d 53 65 65 64 0a 23 64 65 66 69 6e 65 20 73  omSeed.#define s
1970: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 20 20 20  qlite3OsSleep   
1980: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
1990: 65 33 4f 73 32 53 6c 65 65 70 0a 23 64 65 66 69  e3Os2Sleep.#defi
19a0: 6e 65 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72  ne sqlite3OsCurr
19b0: 65 6e 74 54 69 6d 65 20 20 20 20 20 20 20 20 73  entTime        s
19c0: 71 6c 69 74 65 33 4f 73 32 43 75 72 72 65 6e 74  qlite3Os2Current
19d0: 54 69 6d 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  Time.#define sql
19e0: 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78  ite3OsEnterMutex
19f0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
1a00: 4f 73 32 45 6e 74 65 72 4d 75 74 65 78 0a 23 64  Os2EnterMutex.#d
1a10: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4c  efine sqlite3OsL
1a20: 65 61 76 65 4d 75 74 65 78 20 20 20 20 20 20 20  eaveMutex       
1a30: 20 20 73 71 6c 69 74 65 33 4f 73 32 4c 65 61 76    sqlite3Os2Leav
1a40: 65 4d 75 74 65 78 0a 23 64 65 66 69 6e 65 20 73  eMutex.#define s
1a50: 71 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65 78 20  qlite3OsInMutex 
1a60: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
1a70: 65 33 4f 73 32 49 6e 4d 75 74 65 78 0a 23 64 65  e3Os2InMutex.#de
1a80: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 54 68  fine sqlite3OsTh
1a90: 72 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61  readSpecificData
1aa0: 20 73 71 6c 69 74 65 33 4f 73 32 54 68 72 65 61   sqlite3Os2Threa
1ab0: 64 53 70 65 63 69 66 69 63 44 61 74 61 0a 23 64  dSpecificData.#d
1ac0: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4d  efine sqlite3OsM
1ad0: 61 6c 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20  alloc           
1ae0: 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63    sqlite3Generic
1af0: 4d 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20 73  Malloc.#define s
1b00: 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c 6f 63 20  qlite3OsRealloc 
1b10: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
1b20: 65 33 47 65 6e 65 72 69 63 52 65 61 6c 6c 6f 63  e3GenericRealloc
1b30: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
1b40: 4f 73 46 72 65 65 20 20 20 20 20 20 20 20 20 20  OsFree          
1b50: 20 20 20 20 20 73 71 6c 69 74 65 33 47 65 6e 65       sqlite3Gene
1b60: 72 69 63 46 72 65 65 0a 23 64 65 66 69 6e 65 20  ricFree.#define 
1b70: 73 71 6c 69 74 65 33 4f 73 41 6c 6c 6f 63 61 74  sqlite3OsAllocat
1b80: 69 6f 6e 53 69 7a 65 20 20 20 20 20 73 71 6c 69  ionSize     sqli
1b90: 74 65 33 47 65 6e 65 72 69 63 41 6c 6c 6f 63 61  te3GenericAlloca
1ba0: 74 69 6f 6e 53 69 7a 65 0a 23 64 65 66 69 6e 65  tionSize.#define
1bb0: 20 73 71 6c 69 74 65 33 4f 73 44 6c 6f 70 65 6e   sqlite3OsDlopen
1bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c               sql
1bd0: 69 74 65 33 4f 73 32 44 6c 6f 70 65 6e 0a 23 64  ite3Os2Dlopen.#d
1be0: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 44  efine sqlite3OsD
1bf0: 6c 73 79 6d 20 20 20 20 20 20 20 20 20 20 20 20  lsym            
1c00: 20 20 73 71 6c 69 74 65 33 4f 73 32 44 6c 73 79    sqlite3Os2Dlsy
1c10: 6d 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  m.#define sqlite
1c20: 33 4f 73 44 6c 63 6c 6f 73 65 20 20 20 20 20 20  3OsDlclose      
1c30: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 32        sqlite3Os2
1c40: 44 6c 63 6c 6f 73 65 0a 23 65 6e 64 69 66 0a 0a  Dlclose.#endif..
1c50: 0a 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 75 73 69 6e  .../*.** If usin
1c60: 67 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  g an alternative
1c70: 20 4f 53 20 69 6e 74 65 72 66 61 63 65 2c 20 74   OS interface, t
1c80: 68 65 6e 20 77 65 20 6d 75 73 74 20 68 61 76 65  hen we must have
1c90: 20 61 6e 20 22 6f 73 5f 6f 74 68 65 72 2e 68 22   an "os_other.h"
1ca0: 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20  .** header file 
1cb0: 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 74 68  available for th
1cc0: 61 74 20 69 6e 74 65 72 66 61 63 65 2e 20 20 50  at interface.  P
1cd0: 72 65 73 75 6d 61 62 6c 79 20 74 68 65 20 22 6f  resumably the "o
1ce0: 73 5f 6f 74 68 65 72 2e 68 22 0a 2a 2a 20 68 65  s_other.h".** he
1cf0: 61 64 65 72 20 66 69 6c 65 20 63 6f 6e 74 61 69  ader file contai
1d00: 6e 73 20 23 64 65 66 69 6e 65 73 20 73 69 6d 69  ns #defines simi
1d10: 6c 61 72 20 74 6f 20 74 68 6f 73 65 20 61 62 6f  lar to those abo
1d20: 76 65 2e 0a 2a 2f 0a 23 69 66 20 4f 53 5f 4f 54  ve..*/.#if OS_OT
1d30: 48 45 52 0a 23 20 69 6e 63 6c 75 64 65 20 22 6f  HER.# include "o
1d40: 73 5f 6f 74 68 65 72 2e 68 22 0a 23 65 6e 64 69  s_other.h".#endi
1d50: 66 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 77 61  f..../*.** Forwa
1d60: 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 0a  rd declarations.
1d70: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  */.typedef struc
1d80: 74 20 4f 73 46 69 6c 65 20 4f 73 46 69 6c 65 3b  t OsFile OsFile;
1d90: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
1da0: 49 6f 4d 65 74 68 6f 64 20 49 6f 4d 65 74 68 6f  IoMethod IoMetho
1db0: 64 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73  d;../*.** An ins
1dc0: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c  tance of the fol
1dd0: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65  lowing structure
1de0: 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65   contains pointe
1df0: 72 73 20 74 6f 20 61 6c 6c 0a 2a 2a 20 6d 65 74  rs to all.** met
1e00: 68 6f 64 73 20 6f 6e 20 61 6e 20 4f 73 46 69 6c  hods on an OsFil
1e10: 65 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 72  e object..*/.str
1e20: 75 63 74 20 49 6f 4d 65 74 68 6f 64 20 7b 0a 20  uct IoMethod {. 
1e30: 20 69 6e 74 20 28 2a 78 43 6c 6f 73 65 29 28 4f   int (*xClose)(O
1e40: 73 46 69 6c 65 2a 2a 29 3b 0a 20 20 69 6e 74 20  sFile**);.  int 
1e50: 28 2a 78 4f 70 65 6e 44 69 72 65 63 74 6f 72 79  (*xOpenDirectory
1e60: 29 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e 73 74  )(OsFile*, const
1e70: 20 63 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20 28   char*);.  int (
1e80: 2a 78 52 65 61 64 29 28 4f 73 46 69 6c 65 2a 2c  *xRead)(OsFile*,
1e90: 20 76 6f 69 64 2a 2c 20 69 6e 74 20 61 6d 74 29   void*, int amt)
1ea0: 3b 0a 20 20 69 6e 74 20 28 2a 78 57 72 69 74 65  ;.  int (*xWrite
1eb0: 29 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e 73 74  )(OsFile*, const
1ec0: 20 76 6f 69 64 2a 2c 20 69 6e 74 20 61 6d 74 29   void*, int amt)
1ed0: 3b 0a 20 20 69 6e 74 20 28 2a 78 53 65 65 6b 29  ;.  int (*xSeek)
1ee0: 28 4f 73 46 69 6c 65 2a 2c 20 69 36 34 20 6f 66  (OsFile*, i64 of
1ef0: 66 73 65 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78  fset);.  int (*x
1f00: 54 72 75 6e 63 61 74 65 29 28 4f 73 46 69 6c 65  Truncate)(OsFile
1f10: 2a 2c 20 69 36 34 20 73 69 7a 65 29 3b 0a 20 20  *, i64 size);.  
1f20: 69 6e 74 20 28 2a 78 53 79 6e 63 29 28 4f 73 46  int (*xSync)(OsF
1f30: 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f  ile*, int);.  vo
1f40: 69 64 20 28 2a 78 53 65 74 46 75 6c 6c 53 79 6e  id (*xSetFullSyn
1f50: 63 29 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69  c)(OsFile *id, i
1f60: 6e 74 20 73 65 74 74 69 6e 67 29 3b 0a 20 20 69  nt setting);.  i
1f70: 6e 74 20 28 2a 78 46 69 6c 65 48 61 6e 64 6c 65  nt (*xFileHandle
1f80: 29 28 4f 73 46 69 6c 65 20 2a 69 64 29 3b 0a 20  )(OsFile *id);. 
1f90: 20 69 6e 74 20 28 2a 78 46 69 6c 65 53 69 7a 65   int (*xFileSize
1fa0: 29 28 4f 73 46 69 6c 65 2a 2c 20 69 36 34 20 2a  )(OsFile*, i64 *
1fb0: 70 53 69 7a 65 29 3b 0a 20 20 69 6e 74 20 28 2a  pSize);.  int (*
1fc0: 78 4c 6f 63 6b 29 28 4f 73 46 69 6c 65 2a 2c 20  xLock)(OsFile*, 
1fd0: 69 6e 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78 55  int);.  int (*xU
1fe0: 6e 6c 6f 63 6b 29 28 4f 73 46 69 6c 65 2a 2c 20  nlock)(OsFile*, 
1ff0: 69 6e 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78 4c  int);.  int (*xL
2000: 6f 63 6b 53 74 61 74 65 29 28 4f 73 46 69 6c 65  ockState)(OsFile
2010: 20 2a 69 64 29 3b 0a 20 20 69 6e 74 20 28 2a 78   *id);.  int (*x
2020: 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63  CheckReservedLoc
2030: 6b 29 28 4f 73 46 69 6c 65 20 2a 69 64 29 3b 0a  k)(OsFile *id);.
2040: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 4f 73  };../*.** The Os
2050: 46 69 6c 65 20 6f 62 6a 65 63 74 20 64 65 73 63  File object desc
2060: 72 69 62 65 73 20 61 6e 20 6f 70 65 6e 20 64 69  ribes an open di
2070: 73 6b 20 66 69 6c 65 20 69 6e 20 61 6e 20 4f 53  sk file in an OS
2080: 2d 64 65 70 65 6e 64 65 6e 74 20 77 61 79 2e 0a  -dependent way..
2090: 2a 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f  ** The version o
20a0: 66 20 4f 73 46 69 6c 65 20 64 65 66 69 6e 65 64  f OsFile defined
20b0: 20 68 65 72 65 20 69 73 20 61 20 67 65 6e 65 72   here is a gener
20c0: 69 63 20 76 65 72 73 69 6f 6e 2e 20 20 45 61 63  ic version.  Eac
20d0: 68 20 4f 53 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e  h OS.** implemen
20e0: 74 61 74 69 6f 6e 20 64 65 66 69 6e 65 73 20 69  tation defines i
20f0: 74 73 20 6f 77 6e 20 73 75 62 63 6c 61 73 73 20  ts own subclass 
2100: 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72  of this structur
2110: 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a  e that contains.
2120: 2a 2a 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  ** additional in
2130: 66 6f 72 6d 61 74 69 6f 6e 20 6e 65 65 64 65 64  formation needed
2140: 20 74 6f 20 68 61 6e 64 6c 65 20 66 69 6c 65 20   to handle file 
2150: 49 2f 4f 2e 20 20 42 75 74 20 74 68 65 20 70 4d  I/O.  But the pM
2160: 65 74 68 6f 64 0a 2a 2a 20 65 6e 74 72 79 20 28  ethod.** entry (
2170: 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 65 20  pointing to the 
2180: 76 69 72 74 75 61 6c 20 66 75 6e 63 74 69 6f 6e  virtual function
2190: 20 74 61 62 6c 65 29 20 61 6c 77 61 79 73 20 6f   table) always o
21a0: 63 63 75 72 73 20 66 69 72 73 74 0a 2a 2a 20 73  ccurs first.** s
21b0: 6f 20 74 68 61 74 20 77 65 20 63 61 6e 20 61 6c  o that we can al
21c0: 77 61 79 73 20 66 69 6e 64 20 74 68 65 20 61 70  ways find the ap
21d0: 70 72 6f 70 72 69 61 74 65 20 6d 65 74 68 6f 64  propriate method
21e0: 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4f 73 46  s..*/.struct OsF
21f0: 69 6c 65 20 7b 0a 20 20 49 6f 4d 65 74 68 6f 64  ile {.  IoMethod
2200: 20 63 6f 6e 73 74 20 2a 70 4d 65 74 68 6f 64 3b   const *pMethod;
2210: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66  .};../*.** The f
2220: 6f 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 73 20  ollowing values 
2230: 6d 61 79 20 62 65 20 70 61 73 73 65 64 20 61 73  may be passed as
2240: 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75   the second argu
2250: 6d 65 6e 74 20 74 6f 0a 2a 2a 20 73 71 6c 69 74  ment to.** sqlit
2260: 65 33 4f 73 4c 6f 63 6b 28 29 2e 20 54 68 65 20  e3OsLock(). The 
2270: 76 61 72 69 6f 75 73 20 6c 6f 63 6b 73 20 65 78  various locks ex
2280: 68 69 62 69 74 20 74 68 65 20 66 6f 6c 6c 6f 77  hibit the follow
2290: 69 6e 67 20 73 65 6d 61 6e 74 69 63 73 3a 0a 2a  ing semantics:.*
22a0: 2a 0a 2a 2a 20 53 48 41 52 45 44 3a 20 20 20 20  *.** SHARED:    
22b0: 41 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20 70 72  Any number of pr
22c0: 6f 63 65 73 73 65 73 20 6d 61 79 20 68 6f 6c 64  ocesses may hold
22d0: 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 73   a SHARED lock s
22e0: 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 2e 0a 2a  imultaneously..*
22f0: 2a 20 52 45 53 45 52 56 45 44 3a 20 20 41 20 73  * RESERVED:  A s
2300: 69 6e 67 6c 65 20 70 72 6f 63 65 73 73 20 6d 61  ingle process ma
2310: 79 20 68 6f 6c 64 20 61 20 52 45 53 45 52 56 45  y hold a RESERVE
2320: 44 20 6c 6f 63 6b 20 6f 6e 20 61 20 66 69 6c 65  D lock on a file
2330: 20 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20   at.**          
2340: 20 20 61 6e 79 20 74 69 6d 65 2e 20 4f 74 68 65    any time. Othe
2350: 72 20 70 72 6f 63 65 73 73 65 73 20 6d 61 79 20  r processes may 
2360: 68 6f 6c 64 20 61 6e 64 20 6f 62 74 61 69 6e 20  hold and obtain 
2370: 6e 65 77 20 53 48 41 52 45 44 20 6c 6f 63 6b 73  new SHARED locks
2380: 2e 0a 2a 2a 20 50 45 4e 44 49 4e 47 3a 20 20 20  ..** PENDING:   
2390: 41 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 73 73  A single process
23a0: 20 6d 61 79 20 68 6f 6c 64 20 61 20 50 45 4e 44   may hold a PEND
23b0: 49 4e 47 20 6c 6f 63 6b 20 6f 6e 20 61 20 66 69  ING lock on a fi
23c0: 6c 65 20 61 74 0a 2a 2a 20 20 20 20 20 20 20 20  le at.**        
23d0: 20 20 20 20 61 6e 79 20 6f 6e 65 20 74 69 6d 65      any one time
23e0: 2e 20 45 78 69 73 74 69 6e 67 20 53 48 41 52 45  . Existing SHARE
23f0: 44 20 6c 6f 63 6b 73 20 6d 61 79 20 70 65 72 73  D locks may pers
2400: 69 73 74 2c 20 62 75 74 20 6e 6f 20 6e 65 77 0a  ist, but no new.
2410: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 53 48  **            SH
2420: 41 52 45 44 20 6c 6f 63 6b 73 20 6d 61 79 20 62  ARED locks may b
2430: 65 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6f 74  e obtained by ot
2440: 68 65 72 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a  her processes..*
2450: 2a 20 45 58 43 4c 55 53 49 56 45 3a 20 41 6e 20  * EXCLUSIVE: An 
2460: 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 70  EXCLUSIVE lock p
2470: 72 65 63 6c 75 64 65 73 20 61 6c 6c 20 6f 74 68  recludes all oth
2480: 65 72 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20  er locks..**.** 
2490: 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 6d 61 79  PENDING_LOCK may
24a0: 20 6e 6f 74 20 62 65 20 70 61 73 73 65 64 20 64   not be passed d
24b0: 69 72 65 63 74 6c 79 20 74 6f 20 73 71 6c 69 74  irectly to sqlit
24c0: 65 33 4f 73 4c 6f 63 6b 28 29 2e 20 49 6e 73 74  e3OsLock(). Inst
24d0: 65 61 64 2c 20 61 0a 2a 2a 20 70 72 6f 63 65 73  ead, a.** proces
24e0: 73 20 74 68 61 74 20 72 65 71 75 65 73 74 73 20  s that requests 
24f0: 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63  an EXCLUSIVE loc
2500: 6b 20 6d 61 79 20 61 63 74 75 61 6c 6c 79 20 6f  k may actually o
2510: 62 74 61 69 6e 20 61 20 50 45 4e 44 49 4e 47 0a  btain a PENDING.
2520: 2a 2a 20 6c 6f 63 6b 2e 20 54 68 69 73 20 63 61  ** lock. This ca
2530: 6e 20 62 65 20 75 70 67 72 61 64 65 64 20 74 6f  n be upgraded to
2540: 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f   an EXCLUSIVE lo
2550: 63 6b 20 62 79 20 61 20 73 75 62 73 65 71 75 65  ck by a subseque
2560: 6e 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71  nt call to.** sq
2570: 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 29 2e 0a 2a  lite3OsLock()..*
2580: 2f 0a 23 64 65 66 69 6e 65 20 4e 4f 5f 4c 4f 43  /.#define NO_LOC
2590: 4b 20 20 20 20 20 20 20 20 20 30 0a 23 64 65 66  K         0.#def
25a0: 69 6e 65 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20  ine SHARED_LOCK 
25b0: 20 20 20 20 31 0a 23 64 65 66 69 6e 65 20 52 45      1.#define RE
25c0: 53 45 52 56 45 44 5f 4c 4f 43 4b 20 20 20 32 0a  SERVED_LOCK   2.
25d0: 23 64 65 66 69 6e 65 20 50 45 4e 44 49 4e 47 5f  #define PENDING_
25e0: 4c 4f 43 4b 20 20 20 20 33 0a 23 64 65 66 69 6e  LOCK    3.#defin
25f0: 65 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b  e EXCLUSIVE_LOCK
2600: 20 20 34 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 65 20    4../*.** File 
2610: 4c 6f 63 6b 69 6e 67 20 4e 6f 74 65 73 3a 20 20  Locking Notes:  
2620: 28 4d 6f 73 74 6c 79 20 61 62 6f 75 74 20 77 69  (Mostly about wi
2630: 6e 64 6f 77 73 20 62 75 74 20 61 6c 73 6f 20 73  ndows but also s
2640: 6f 6d 65 20 69 6e 66 6f 20 66 6f 72 20 55 6e 69  ome info for Uni
2650: 78 29 0a 2a 2a 0a 2a 2a 20 57 65 20 63 61 6e 6e  x).**.** We cann
2660: 6f 74 20 75 73 65 20 4c 6f 63 6b 46 69 6c 65 45  ot use LockFileE
2670: 78 28 29 20 6f 72 20 55 6e 6c 6f 63 6b 46 69 6c  x() or UnlockFil
2680: 65 45 78 28 29 20 6f 6e 20 57 69 6e 39 35 2f 39  eEx() on Win95/9
2690: 38 2f 4d 45 20 62 65 63 61 75 73 65 0a 2a 2a 20  8/ME because.** 
26a0: 74 68 6f 73 65 20 66 75 6e 63 74 69 6f 6e 73 20  those functions 
26b0: 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c  are not availabl
26c0: 65 2e 20 20 53 6f 20 77 65 20 75 73 65 20 6f 6e  e.  So we use on
26d0: 6c 79 20 4c 6f 63 6b 46 69 6c 65 28 29 20 61 6e  ly LockFile() an
26e0: 64 0a 2a 2a 20 55 6e 6c 6f 63 6b 46 69 6c 65 28  d.** UnlockFile(
26f0: 29 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63 6b 46 69 6c  )..**.** LockFil
2700: 65 28 29 20 70 72 65 76 65 6e 74 73 20 6e 6f 74  e() prevents not
2710: 20 6a 75 73 74 20 77 72 69 74 69 6e 67 20 62 75   just writing bu
2720: 74 20 61 6c 73 6f 20 72 65 61 64 69 6e 67 20 62  t also reading b
2730: 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65  y other processe
2740: 73 2e 0a 2a 2a 20 41 20 53 48 41 52 45 44 5f 4c  s..** A SHARED_L
2750: 4f 43 4b 20 69 73 20 6f 62 74 61 69 6e 65 64 20  OCK is obtained 
2760: 62 79 20 6c 6f 63 6b 69 6e 67 20 61 20 73 69 6e  by locking a sin
2770: 67 6c 65 20 72 61 6e 64 6f 6d 6c 79 2d 63 68 6f  gle randomly-cho
2780: 73 65 6e 20 0a 2a 2a 20 62 79 74 65 20 6f 75 74  sen .** byte out
2790: 20 6f 66 20 61 20 73 70 65 63 69 66 69 63 20 72   of a specific r
27a0: 61 6e 67 65 20 6f 66 20 62 79 74 65 73 2e 20 54  ange of bytes. T
27b0: 68 65 20 6c 6f 63 6b 20 62 79 74 65 20 69 73 20  he lock byte is 
27c0: 6f 62 74 61 69 6e 65 64 20 61 74 20 0a 2a 2a 20  obtained at .** 
27d0: 72 61 6e 64 6f 6d 20 73 6f 20 74 77 6f 20 73 65  random so two se
27e0: 70 61 72 61 74 65 20 72 65 61 64 65 72 73 20 63  parate readers c
27f0: 61 6e 20 70 72 6f 62 61 62 6c 79 20 61 63 63 65  an probably acce
2800: 73 73 20 74 68 65 20 66 69 6c 65 20 61 74 20 74  ss the file at t
2810: 68 65 20 0a 2a 2a 20 73 61 6d 65 20 74 69 6d 65  he .** same time
2820: 2c 20 75 6e 6c 65 73 73 20 74 68 65 79 20 61 72  , unless they ar
2830: 65 20 75 6e 6c 75 63 6b 79 20 61 6e 64 20 63 68  e unlucky and ch
2840: 6f 6f 73 65 20 74 68 65 20 73 61 6d 65 20 6c 6f  oose the same lo
2850: 63 6b 20 62 79 74 65 2e 0a 2a 2a 20 41 6e 20 45  ck byte..** An E
2860: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 69 73  XCLUSIVE_LOCK is
2870: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63   obtained by loc
2880: 6b 69 6e 67 20 61 6c 6c 20 62 79 74 65 73 20 69  king all bytes i
2890: 6e 20 74 68 65 20 72 61 6e 67 65 2e 0a 2a 2a 20  n the range..** 
28a0: 54 68 65 72 65 20 63 61 6e 20 6f 6e 6c 79 20 62  There can only b
28b0: 65 20 6f 6e 65 20 77 72 69 74 65 72 2e 20 20 41  e one writer.  A
28c0: 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 69   RESERVED_LOCK i
28d0: 73 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f  s obtained by lo
28e0: 63 6b 69 6e 67 0a 2a 2a 20 61 20 73 69 6e 67 6c  cking.** a singl
28f0: 65 20 62 79 74 65 20 6f 66 20 74 68 65 20 66 69  e byte of the fi
2900: 6c 65 20 74 68 61 74 20 69 73 20 64 65 73 69 67  le that is desig
2910: 6e 61 74 65 64 20 61 73 20 74 68 65 20 72 65 73  nated as the res
2920: 65 72 76 65 64 20 6c 6f 63 6b 20 62 79 74 65 2e  erved lock byte.
2930: 0a 2a 2a 20 41 20 50 45 4e 44 49 4e 47 5f 4c 4f  .** A PENDING_LO
2940: 43 4b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 62  CK is obtained b
2950: 79 20 6c 6f 63 6b 69 6e 67 20 61 20 64 65 73 69  y locking a desi
2960: 67 6e 61 74 65 64 20 62 79 74 65 20 64 69 66 66  gnated byte diff
2970: 65 72 65 6e 74 20 66 72 6f 6d 0a 2a 2a 20 74 68  erent from.** th
2980: 65 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20  e RESERVED_LOCK 
2990: 62 79 74 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 57  byte..**.** On W
29a0: 69 6e 4e 54 2f 32 4b 2f 58 50 20 73 79 73 74 65  inNT/2K/XP syste
29b0: 6d 73 2c 20 4c 6f 63 6b 46 69 6c 65 45 78 28 29  ms, LockFileEx()
29c0: 20 61 6e 64 20 55 6e 6c 6f 63 6b 46 69 6c 65 45   and UnlockFileE
29d0: 78 28 29 20 61 72 65 20 61 76 61 69 6c 61 62 6c  x() are availabl
29e0: 65 2c 0a 2a 2a 20 77 68 69 63 68 20 6d 65 61 6e  e,.** which mean
29f0: 73 20 77 65 20 63 61 6e 20 75 73 65 20 72 65 61  s we can use rea
2a00: 64 65 72 2f 77 72 69 74 65 72 20 6c 6f 63 6b 73  der/writer locks
2a10: 2e 20 20 57 68 65 6e 20 72 65 61 64 65 72 2f 77  .  When reader/w
2a20: 72 69 74 65 72 20 6c 6f 63 6b 73 0a 2a 2a 20 61  riter locks.** a
2a30: 72 65 20 75 73 65 64 2c 20 74 68 65 20 6c 6f 63  re used, the loc
2a40: 6b 20 69 73 20 70 6c 61 63 65 64 20 6f 6e 20 74  k is placed on t
2a50: 68 65 20 73 61 6d 65 20 72 61 6e 67 65 20 6f 66  he same range of
2a60: 20 62 79 74 65 73 20 74 68 61 74 20 69 73 20 75   bytes that is u
2a70: 73 65 64 0a 2a 2a 20 66 6f 72 20 70 72 6f 62 61  sed.** for proba
2a80: 62 69 6c 69 73 74 69 63 20 6c 6f 63 6b 69 6e 67  bilistic locking
2a90: 20 69 6e 20 57 69 6e 39 35 2f 39 38 2f 4d 45 2e   in Win95/98/ME.
2aa0: 20 20 48 65 6e 63 65 2c 20 74 68 65 20 6c 6f 63    Hence, the loc
2ab0: 6b 69 6e 67 20 73 63 68 65 6d 65 0a 2a 2a 20 77  king scheme.** w
2ac0: 69 6c 6c 20 73 75 70 70 6f 72 74 20 74 77 6f 20  ill support two 
2ad0: 6f 72 20 6d 6f 72 65 20 57 69 6e 39 35 20 72 65  or more Win95 re
2ae0: 61 64 65 72 73 20 6f 72 20 74 77 6f 20 6f 72 20  aders or two or 
2af0: 6d 6f 72 65 20 57 69 6e 4e 54 20 72 65 61 64 65  more WinNT reade
2b00: 72 73 2e 0a 2a 2a 20 42 75 74 20 61 20 73 69 6e  rs..** But a sin
2b10: 67 6c 65 20 57 69 6e 39 35 20 72 65 61 64 65 72  gle Win95 reader
2b20: 20 77 69 6c 6c 20 6c 6f 63 6b 20 6f 75 74 20 61   will lock out a
2b30: 6c 6c 20 57 69 6e 4e 54 20 72 65 61 64 65 72 73  ll WinNT readers
2b40: 20 61 6e 64 20 61 20 73 69 6e 67 6c 65 0a 2a 2a   and a single.**
2b50: 20 57 69 6e 4e 54 20 72 65 61 64 65 72 20 77 69   WinNT reader wi
2b60: 6c 6c 20 6c 6f 63 6b 20 6f 75 74 20 61 6c 6c 20  ll lock out all 
2b70: 6f 74 68 65 72 20 57 69 6e 39 35 20 72 65 61 64  other Win95 read
2b80: 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66  ers..**.** The f
2b90: 6f 6c 6c 6f 77 69 6e 67 20 23 64 65 66 69 6e 65  ollowing #define
2ba0: 73 20 73 70 65 63 69 66 79 20 74 68 65 20 72 61  s specify the ra
2bb0: 6e 67 65 20 6f 66 20 62 79 74 65 73 20 75 73 65  nge of bytes use
2bc0: 64 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 2e 0a 2a  d for locking..*
2bd0: 2a 20 53 48 41 52 45 44 5f 53 49 5a 45 20 69 73  * SHARED_SIZE is
2be0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
2bf0: 79 74 65 73 20 61 76 61 69 6c 61 62 6c 65 20 69  ytes available i
2c00: 6e 20 74 68 65 20 70 6f 6f 6c 20 66 72 6f 6d 20  n the pool from 
2c10: 77 68 69 63 68 0a 2a 2a 20 61 20 72 61 6e 64 6f  which.** a rando
2c20: 6d 20 62 79 74 65 20 69 73 20 73 65 6c 65 63 74  m byte is select
2c30: 65 64 20 66 6f 72 20 61 20 73 68 61 72 65 64 20  ed for a shared 
2c40: 6c 6f 63 6b 2e 20 20 54 68 65 20 70 6f 6f 6c 20  lock.  The pool 
2c50: 6f 66 20 62 79 74 65 73 20 66 6f 72 0a 2a 2a 20  of bytes for.** 
2c60: 73 68 61 72 65 64 20 6c 6f 63 6b 73 20 62 65 67  shared locks beg
2c70: 69 6e 73 20 61 74 20 53 48 41 52 45 44 5f 46 49  ins at SHARED_FI
2c80: 52 53 54 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 65 73  RST. .**.** Thes
2c90: 65 20 23 64 65 66 69 6e 65 73 20 61 72 65 20 61  e #defines are a
2ca0: 76 61 69 6c 61 62 6c 65 20 69 6e 20 73 71 6c 69  vailable in sqli
2cb0: 74 65 5f 61 75 78 2e 68 20 73 6f 20 74 68 61 74  te_aux.h so that
2cc0: 20 61 64 61 70 74 6f 72 73 20 66 6f 72 0a 2a 2a   adaptors for.**
2cd0: 20 63 6f 6e 6e 65 63 74 69 6e 67 20 53 51 4c 69   connecting SQLi
2ce0: 74 65 20 74 6f 20 6f 74 68 65 72 20 6f 70 65 72  te to other oper
2cf0: 61 74 69 6e 67 20 73 79 73 74 65 6d 73 20 63 61  ating systems ca
2d00: 6e 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 62  n use the same b
2d10: 79 74 65 0a 2a 2a 20 72 61 6e 67 65 73 20 66 6f  yte.** ranges fo
2d20: 72 20 6c 6f 63 6b 69 6e 67 2e 20 20 49 6e 20 70  r locking.  In p
2d30: 61 72 74 69 63 75 6c 61 72 2c 20 74 68 65 20 73  articular, the s
2d40: 61 6d 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61  ame locking stra
2d50: 74 65 67 79 20 61 6e 64 0a 2a 2a 20 62 79 74 65  tegy and.** byte
2d60: 20 72 61 6e 67 65 73 20 61 72 65 20 75 73 65 64   ranges are used
2d70: 20 66 6f 72 20 55 6e 69 78 2e 20 20 54 68 69 73   for Unix.  This
2d80: 20 6c 65 61 76 65 73 20 6f 70 65 6e 20 74 68 65   leaves open the
2d90: 20 70 6f 73 73 69 62 6c 69 74 79 20 6f 66 20 68   possiblity of h
2da0: 61 76 69 6e 67 0a 2a 2a 20 63 6c 69 65 6e 74 73  aving.** clients
2db0: 20 6f 6e 20 77 69 6e 39 35 2c 20 77 69 6e 4e 54   on win95, winNT
2dc0: 2c 20 61 6e 64 20 75 6e 69 78 20 61 6c 6c 20 74  , and unix all t
2dd0: 61 6c 6b 69 6e 67 20 74 6f 20 74 68 65 20 73 61  alking to the sa
2de0: 6d 65 20 73 68 61 72 65 64 20 66 69 6c 65 0a 2a  me shared file.*
2df0: 2a 20 61 6e 64 20 61 6c 6c 20 6c 6f 63 6b 69 6e  * and all lockin
2e00: 67 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 54 6f  g correctly.  To
2e10: 20 64 6f 20 73 6f 20 77 6f 75 6c 64 20 72 65 71   do so would req
2e20: 75 69 72 65 20 74 68 61 74 20 73 61 6d 62 61 20  uire that samba 
2e30: 28 6f 72 20 77 68 61 74 65 76 65 72 0a 2a 2a 20  (or whatever.** 
2e40: 74 6f 6f 6c 20 69 73 20 62 65 69 6e 67 20 75 73  tool is being us
2e50: 65 64 20 66 6f 72 20 66 69 6c 65 20 73 68 61 72  ed for file shar
2e60: 69 6e 67 29 20 69 6d 70 6c 65 6d 65 6e 74 73 20  ing) implements 
2e70: 6c 6f 63 6b 73 20 63 6f 72 72 65 63 74 6c 79 20  locks correctly 
2e80: 62 65 74 77 65 65 6e 0a 2a 2a 20 77 69 6e 64 6f  between.** windo
2e90: 77 73 20 61 6e 64 20 75 6e 69 78 2e 20 20 49 27  ws and unix.  I'
2ea0: 6d 20 67 75 65 73 73 69 6e 67 20 74 68 61 74 20  m guessing that 
2eb0: 69 73 6e 27 74 20 6c 69 6b 65 6c 79 20 74 6f 20  isn't likely to 
2ec0: 68 61 70 70 65 6e 2c 20 62 75 74 20 62 79 0a 2a  happen, but by.*
2ed0: 2a 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65  * using the same
2ee0: 20 6c 6f 63 6b 69 6e 67 20 72 61 6e 67 65 20 77   locking range w
2ef0: 65 20 61 72 65 20 61 74 20 6c 65 61 73 74 20 6f  e are at least o
2f00: 70 65 6e 20 74 6f 20 74 68 65 20 70 6f 73 73 69  pen to the possi
2f10: 62 69 6c 69 74 79 2e 0a 2a 2a 0a 2a 2a 20 4c 6f  bility..**.** Lo
2f20: 63 6b 69 6e 67 20 69 6e 20 77 69 6e 64 6f 77 73  cking in windows
2f30: 20 69 73 20 6d 61 6e 64 69 74 6f 72 79 2e 20 20   is manditory.  
2f40: 46 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c  For this reason,
2f50: 20 77 65 20 63 61 6e 6e 6f 74 20 73 74 6f 72 65   we cannot store
2f60: 0a 2a 2a 20 61 63 74 75 61 6c 20 64 61 74 61 20  .** actual data 
2f70: 69 6e 20 74 68 65 20 62 79 74 65 73 20 75 73 65  in the bytes use
2f80: 64 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 2e 20 20  d for locking.  
2f90: 54 68 65 20 70 61 67 65 72 20 6e 65 76 65 72 20  The pager never 
2fa0: 61 6c 6c 6f 63 61 74 65 73 0a 2a 2a 20 74 68 65  allocates.** the
2fb0: 20 70 61 67 65 73 20 69 6e 76 6f 6c 76 65 64 20   pages involved 
2fc0: 69 6e 20 6c 6f 63 6b 69 6e 67 20 74 68 65 72 65  in locking there
2fd0: 66 6f 72 65 2e 20 20 53 48 41 52 45 44 5f 53 49  fore.  SHARED_SI
2fe0: 5a 45 20 69 73 20 73 65 6c 65 63 74 65 64 20 73  ZE is selected s
2ff0: 6f 0a 2a 2a 20 74 68 61 74 20 61 6c 6c 20 6c 6f  o.** that all lo
3000: 63 6b 73 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20  cks will fit on 
3010: 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 65 76  a single page ev
3020: 65 6e 20 61 74 20 74 68 65 20 6d 69 6e 69 6d 75  en at the minimu
3030: 6d 20 70 61 67 65 20 73 69 7a 65 2e 0a 2a 2a 20  m page size..** 
3040: 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 64 65 66  PENDING_BYTE def
3050: 69 6e 65 73 20 74 68 65 20 62 65 67 69 6e 6e 69  ines the beginni
3060: 6e 67 20 6f 66 20 74 68 65 20 6c 6f 63 6b 73 2e  ng of the locks.
3070: 20 20 42 79 20 64 65 66 61 75 6c 74 20 50 45 4e    By default PEN
3080: 44 49 4e 47 5f 42 59 54 45 0a 2a 2a 20 69 73 20  DING_BYTE.** is 
3090: 73 65 74 20 68 69 67 68 20 73 6f 20 74 68 61 74  set high so that
30a0: 20 77 65 20 64 6f 6e 27 74 20 68 61 76 65 20 74   we don't have t
30b0: 6f 20 61 6c 6c 6f 63 61 74 65 20 61 6e 20 75 6e  o allocate an un
30c0: 75 73 65 64 20 70 61 67 65 20 65 78 63 65 70 74  used page except
30d0: 0a 2a 2a 20 66 6f 72 20 76 65 72 79 20 6c 61 72  .** for very lar
30e0: 67 65 20 64 61 74 61 62 61 73 65 73 2e 20 20 42  ge databases.  B
30f0: 75 74 20 6f 6e 65 20 73 68 6f 75 6c 64 20 74 65  ut one should te
3100: 73 74 20 74 68 65 20 70 61 67 65 20 73 6b 69 70  st the page skip
3110: 70 69 6e 67 20 6c 6f 67 69 63 20 0a 2a 2a 20 62  ping logic .** b
3120: 79 20 73 65 74 74 69 6e 67 20 50 45 4e 44 49 4e  y setting PENDIN
3130: 47 5f 42 59 54 45 20 6c 6f 77 20 61 6e 64 20 72  G_BYTE low and r
3140: 75 6e 6e 69 6e 67 20 74 68 65 20 65 6e 74 69 72  unning the entir
3150: 65 20 72 65 67 72 65 73 73 69 6f 6e 20 73 75 69  e regression sui
3160: 74 65 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69  te..**.** Changi
3170: 6e 67 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ng the value of 
3180: 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 72 65 73  PENDING_BYTE res
3190: 75 6c 74 73 20 69 6e 20 61 20 73 75 62 74 6c 79  ults in a subtly
31a0: 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 0a 2a 2a   incompatible.**
31b0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 20 44   file format.  D
31c0: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 68 6f 77 20  epending on how 
31d0: 69 74 20 69 73 20 63 68 61 6e 67 65 64 2c 20 79  it is changed, y
31e0: 6f 75 20 6d 69 67 68 74 20 6e 6f 74 20 6e 6f 74  ou might not not
31f0: 69 63 65 0a 2a 2a 20 74 68 65 20 69 6e 63 6f 6d  ice.** the incom
3200: 70 61 74 69 62 69 6c 69 74 79 20 72 69 67 68 74  patibility right
3210: 20 61 77 61 79 2c 20 65 76 65 6e 20 72 75 6e 6e   away, even runn
3220: 69 6e 67 20 61 20 66 75 6c 6c 20 72 65 67 72 65  ing a full regre
3230: 73 73 69 6f 6e 20 74 65 73 74 2e 0a 2a 2a 20 54  ssion test..** T
3240: 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 61 74  he default locat
3250: 69 6f 6e 20 6f 66 20 50 45 4e 44 49 4e 47 5f 42  ion of PENDING_B
3260: 59 54 45 20 69 73 20 74 68 65 20 66 69 72 73 74  YTE is the first
3270: 20 62 79 74 65 20 70 61 73 74 20 74 68 65 0a 2a   byte past the.*
3280: 2a 20 31 47 42 20 62 6f 75 6e 64 61 72 79 2e 0a  * 1GB boundary..
3290: 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51  **.*/.#ifndef SQ
32a0: 4c 49 54 45 5f 54 45 53 54 0a 23 64 65 66 69 6e  LITE_TEST.#defin
32b0: 65 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 20  e PENDING_BYTE  
32c0: 20 20 20 20 30 78 34 30 30 30 30 30 30 30 20 20      0x40000000  
32d0: 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 61  /* First byte pa
32e0: 73 74 20 74 68 65 20 31 47 42 20 62 6f 75 6e 64  st the 1GB bound
32f0: 61 72 79 20 2a 2f 0a 23 65 6c 73 65 0a 65 78 74  ary */.#else.ext
3300: 65 72 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  ern unsigned int
3310: 20 73 71 6c 69 74 65 33 5f 70 65 6e 64 69 6e 67   sqlite3_pending
3320: 5f 62 79 74 65 3b 0a 23 64 65 66 69 6e 65 20 50  _byte;.#define P
3330: 45 4e 44 49 4e 47 5f 42 59 54 45 20 73 71 6c 69  ENDING_BYTE sqli
3340: 74 65 33 5f 70 65 6e 64 69 6e 67 5f 62 79 74 65  te3_pending_byte
3350: 0a 23 65 6e 64 69 66 0a 0a 23 64 65 66 69 6e 65  .#endif..#define
3360: 20 52 45 53 45 52 56 45 44 5f 42 59 54 45 20 20   RESERVED_BYTE  
3370: 20 20 20 28 50 45 4e 44 49 4e 47 5f 42 59 54 45     (PENDING_BYTE
3380: 2b 31 29 0a 23 64 65 66 69 6e 65 20 53 48 41 52  +1).#define SHAR
3390: 45 44 5f 46 49 52 53 54 20 20 20 20 20 20 28 50  ED_FIRST      (P
33a0: 45 4e 44 49 4e 47 5f 42 59 54 45 2b 32 29 0a 23  ENDING_BYTE+2).#
33b0: 64 65 66 69 6e 65 20 53 48 41 52 45 44 5f 53 49  define SHARED_SI
33c0: 5a 45 20 20 20 20 20 20 20 35 31 30 0a 0a 2f 2a  ZE       510../*
33d0: 0a 2a 2a 20 50 72 6f 74 6f 74 79 70 65 73 20 66  .** Prototypes f
33e0: 6f 72 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73  or operating sys
33f0: 74 65 6d 20 69 6e 74 65 72 66 61 63 65 20 72 6f  tem interface ro
3400: 75 74 69 6e 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73  utines..*/.int s
3410: 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 4f 73  qlite3OsClose(Os
3420: 46 69 6c 65 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c  File**);.int sql
3430: 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65 63 74  ite3OsOpenDirect
3440: 6f 72 79 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e  ory(OsFile*, con
3450: 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73  st char*);.int s
3460: 71 6c 69 74 65 33 4f 73 52 65 61 64 28 4f 73 46  qlite3OsRead(OsF
3470: 69 6c 65 2a 2c 20 76 6f 69 64 2a 2c 20 69 6e 74  ile*, void*, int
3480: 20 61 6d 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74   amt);.int sqlit
3490: 65 33 4f 73 57 72 69 74 65 28 4f 73 46 69 6c 65  e3OsWrite(OsFile
34a0: 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20  *, const void*, 
34b0: 69 6e 74 20 61 6d 74 29 3b 0a 69 6e 74 20 73 71  int amt);.int sq
34c0: 6c 69 74 65 33 4f 73 53 65 65 6b 28 4f 73 46 69  lite3OsSeek(OsFi
34d0: 6c 65 2a 2c 20 69 36 34 20 6f 66 66 73 65 74 29  le*, i64 offset)
34e0: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 54  ;.int sqlite3OsT
34f0: 72 75 6e 63 61 74 65 28 4f 73 46 69 6c 65 2a 2c  runcate(OsFile*,
3500: 20 69 36 34 20 73 69 7a 65 29 3b 0a 69 6e 74 20   i64 size);.int 
3510: 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 4f 73  sqlite3OsSync(Os
3520: 46 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69  File*, int);.voi
3530: 64 20 73 71 6c 69 74 65 33 4f 73 53 65 74 46 75  d sqlite3OsSetFu
3540: 6c 6c 53 79 6e 63 28 4f 73 46 69 6c 65 20 2a 69  llSync(OsFile *i
3550: 64 2c 20 69 6e 74 20 73 65 74 74 69 6e 67 29 3b  d, int setting);
3560: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 46 69  .int sqlite3OsFi
3570: 6c 65 48 61 6e 64 6c 65 28 4f 73 46 69 6c 65 20  leHandle(OsFile 
3580: 2a 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  *id);.int sqlite
3590: 33 4f 73 46 69 6c 65 53 69 7a 65 28 4f 73 46 69  3OsFileSize(OsFi
35a0: 6c 65 2a 2c 20 69 36 34 20 2a 70 53 69 7a 65 29  le*, i64 *pSize)
35b0: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 4c  ;.int sqlite3OsL
35c0: 6f 63 6b 28 4f 73 46 69 6c 65 2a 2c 20 69 6e 74  ock(OsFile*, int
35d0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73  );.int sqlite3Os
35e0: 55 6e 6c 6f 63 6b 28 4f 73 46 69 6c 65 2a 2c 20  Unlock(OsFile*, 
35f0: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  int);.int sqlite
3600: 33 4f 73 4c 6f 63 6b 53 74 61 74 65 28 4f 73 46  3OsLockState(OsF
3610: 69 6c 65 20 2a 69 64 29 3b 0a 69 6e 74 20 73 71  ile *id);.int sq
3620: 6c 69 74 65 33 4f 73 43 68 65 63 6b 52 65 73 65  lite3OsCheckRese
3630: 72 76 65 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20  rvedLock(OsFile 
3640: 2a 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  *id);.int sqlite
3650: 33 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65  3OsOpenReadWrite
3660: 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73  (const char*, Os
3670: 46 69 6c 65 2a 2a 2c 20 69 6e 74 2a 29 3b 0a 69  File**, int*);.i
3680: 6e 74 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e  nt sqlite3OsOpen
3690: 45 78 63 6c 75 73 69 76 65 28 63 6f 6e 73 74 20  Exclusive(const 
36a0: 63 68 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2a 2c  char*, OsFile**,
36b0: 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74   int);.int sqlit
36c0: 65 33 4f 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79  e3OsOpenReadOnly
36d0: 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73  (const char*, Os
36e0: 46 69 6c 65 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c  File**);.int sql
36f0: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 63 6f 6e  ite3OsDelete(con
3700: 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73  st char*);.int s
3710: 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73  qlite3OsFileExis
3720: 74 73 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b  ts(const char*);
3730: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4f 73  .char *sqlite3Os
3740: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 63 6f 6e  FullPathname(con
3750: 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73  st char*);.int s
3760: 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72 69  qlite3OsIsDirWri
3770: 74 61 62 6c 65 28 63 68 61 72 2a 29 3b 0a 69 6e  table(char*);.in
3780: 74 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44  t sqlite3OsSyncD
3790: 69 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 63  irectory(const c
37a0: 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  har*);.int sqlit
37b0: 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65  e3OsTempFileName
37c0: 28 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c  (char*);.int sql
37d0: 69 74 65 33 4f 73 52 61 6e 64 6f 6d 53 65 65 64  ite3OsRandomSeed
37e0: 28 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c  (char*);.int sql
37f0: 69 74 65 33 4f 73 53 6c 65 65 70 28 69 6e 74 20  ite3OsSleep(int 
3800: 6d 73 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  ms);.int sqlite3
3810: 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 28 64 6f  OsCurrentTime(do
3820: 75 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  uble*);.void sql
3830: 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78  ite3OsEnterMutex
3840: 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c  (void);.void sql
3850: 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74 65 78  ite3OsLeaveMutex
3860: 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69  (void);.int sqli
3870: 74 65 33 4f 73 49 6e 4d 75 74 65 78 28 69 6e 74  te3OsInMutex(int
3880: 29 3b 0a 54 68 72 65 61 64 44 61 74 61 20 2a 73  );.ThreadData *s
3890: 71 6c 69 74 65 33 4f 73 54 68 72 65 61 64 53 70  qlite3OsThreadSp
38a0: 65 63 69 66 69 63 44 61 74 61 28 69 6e 74 29 3b  ecificData(int);
38b0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4f 73  .void *sqlite3Os
38c0: 4d 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69  Malloc(int);.voi
38d0: 64 20 2a 73 71 6c 69 74 65 33 4f 73 52 65 61 6c  d *sqlite3OsReal
38e0: 6c 6f 63 28 76 6f 69 64 20 2a 2c 20 69 6e 74 29  loc(void *, int)
38f0: 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4f 73  ;.void sqlite3Os
3900: 46 72 65 65 28 76 6f 69 64 20 2a 29 3b 0a 69 6e  Free(void *);.in
3910: 74 20 73 71 6c 69 74 65 33 4f 73 41 6c 6c 6f 63  t sqlite3OsAlloc
3920: 61 74 69 6f 6e 53 69 7a 65 28 76 6f 69 64 20 2a  ationSize(void *
3930: 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  );.void *sqlite3
3940: 4f 73 44 6c 6f 70 65 6e 28 63 6f 6e 73 74 20 63  OsDlopen(const c
3950: 68 61 72 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c  har*);.void *sql
3960: 69 74 65 33 4f 73 44 6c 73 79 6d 28 76 6f 69 64  ite3OsDlsym(void
3970: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b  *, const char*);
3980: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 44 6c  .int sqlite3OsDl
3990: 63 6c 6f 73 65 28 76 6f 69 64 2a 29 3b 0a 0a 2f  close(void*);../
39a0: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53 51 4c 49  *.** If the SQLI
39b0: 54 45 5f 45 4e 41 42 4c 45 5f 52 45 44 45 46 5f  TE_ENABLE_REDEF_
39c0: 49 4f 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  IO macro is defi
39d0: 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 20 4f 53  ned, then the OS
39e0: 2d 6c 61 79 65 72 0a 2a 2a 20 69 6e 74 65 72 66  -layer.** interf
39f0: 61 63 65 20 72 6f 75 74 69 6e 65 73 20 61 72 65  ace routines are
3a00: 20 6e 6f 74 20 63 61 6c 6c 65 64 20 64 69 72 65   not called dire
3a10: 63 74 6c 79 20 62 75 74 20 61 72 65 20 69 6e 76  ctly but are inv
3a20: 6f 6b 65 64 20 75 73 69 6e 67 0a 2a 2a 20 70 6f  oked using.** po
3a30: 69 6e 74 65 72 73 20 74 6f 20 66 75 6e 63 74 69  inters to functi
3a40: 6f 6e 73 2e 20 20 54 68 69 73 20 61 6c 6c 6f 77  ons.  This allow
3a50: 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61  s the implementa
3a60: 74 69 6f 6e 20 6f 66 20 76 61 72 69 6f 75 73 0a  tion of various.
3a70: 2a 2a 20 4f 53 2d 6c 61 79 65 72 20 69 6e 74 65  ** OS-layer inte
3a80: 72 66 61 63 65 20 72 6f 75 74 69 6e 65 73 20 74  rface routines t
3a90: 6f 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 74  o be modified at
3aa0: 20 72 75 6e 2d 74 69 6d 65 2e 20 20 54 68 65 72   run-time.  Ther
3ab0: 65 20 61 72 65 0a 2a 2a 20 6f 62 73 63 75 72 65  e are.** obscure
3ac0: 20 62 75 74 20 6c 65 67 69 74 69 6d 61 74 65 20   but legitimate 
3ad0: 72 65 61 73 6f 6e 73 20 66 6f 72 20 77 61 6e 74  reasons for want
3ae0: 69 6e 67 20 74 6f 20 64 6f 20 74 68 69 73 2e 20  ing to do this. 
3af0: 20 42 75 74 20 66 6f 72 0a 2a 2a 20 6d 6f 73 74   But for.** most
3b00: 20 75 73 65 72 73 2c 20 61 20 64 69 72 65 63 74   users, a direct
3b10: 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 75 6e 64   call to the und
3b20: 65 72 6c 79 69 6e 67 20 69 6e 74 65 72 66 61 63  erlying interfac
3b30: 65 20 69 73 20 70 72 65 66 65 72 61 62 6c 65 0a  e is preferable.
3b40: 2a 2a 20 73 6f 20 74 68 65 20 74 68 65 20 72 65  ** so the the re
3b50: 64 65 66 69 6e 61 62 6c 65 20 49 2f 4f 20 69 6e  definable I/O in
3b60: 74 65 72 66 61 63 65 20 69 73 20 74 75 72 6e 65  terface is turne
3b70: 64 20 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74  d off by default
3b80: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49  ..*/.#ifdef SQLI
3b90: 54 45 5f 45 4e 41 42 4c 45 5f 52 45 44 45 46 5f  TE_ENABLE_REDEF_
3ba0: 49 4f 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e 20 72  IO../*.** When r
3bb0: 65 64 65 66 69 6e 61 62 6c 65 20 49 2f 4f 20 69  edefinable I/O i
3bc0: 73 20 65 6e 61 62 6c 65 64 2c 20 61 20 73 69 6e  s enabled, a sin
3bd0: 67 6c 65 20 67 6c 6f 62 61 6c 20 69 6e 73 74 61  gle global insta
3be0: 6e 63 65 20 6f 66 20 74 68 65 0a 2a 2a 20 66 6f  nce of the.** fo
3bf0: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
3c00: 65 20 68 6f 6c 64 73 20 70 6f 69 6e 74 65 72 73  e holds pointers
3c10: 20 74 6f 20 74 68 65 20 72 6f 75 74 69 6e 65 73   to the routines
3c20: 20 74 68 61 74 20 53 51 4c 69 74 65 20 0a 2a 2a   that SQLite .**
3c30: 20 75 73 65 73 20 74 6f 20 74 61 6c 6b 20 77 69   uses to talk wi
3c40: 74 68 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e  th the underlyin
3c50: 67 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  g operating syst
3c60: 65 6d 2e 20 20 4d 6f 64 69 66 79 20 74 68 69 73  em.  Modify this
3c70: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 28 62  .** structure (b
3c80: 65 66 6f 72 65 20 75 73 69 6e 67 20 61 6e 79 20  efore using any 
3c90: 53 51 4c 69 74 65 20 41 50 49 21 29 20 74 6f 20  SQLite API!) to 
3ca0: 61 63 63 6f 6d 6f 64 61 74 65 20 70 65 72 63 75  accomodate percu
3cb0: 6c 69 61 72 0a 2a 2a 20 6f 70 65 72 61 74 69 6e  liar.** operatin
3cc0: 67 20 73 79 73 74 65 6d 20 69 6e 74 65 72 66 61  g system interfa
3cd0: 63 65 73 20 6f 72 20 62 65 68 61 76 69 6f 72 73  ces or behaviors
3ce0: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 71 6c 69  ..*/.struct sqli
3cf0: 74 65 33 4f 73 56 74 62 6c 20 7b 0a 20 20 69 6e  te3OsVtbl {.  in
3d00: 74 20 28 2a 78 4f 70 65 6e 52 65 61 64 57 72 69  t (*xOpenReadWri
3d10: 74 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c  te)(const char*,
3d20: 20 4f 73 46 69 6c 65 2a 2a 2c 20 69 6e 74 2a 29   OsFile**, int*)
3d30: 3b 0a 20 20 69 6e 74 20 28 2a 78 4f 70 65 6e 45  ;.  int (*xOpenE
3d40: 78 63 6c 75 73 69 76 65 29 28 63 6f 6e 73 74 20  xclusive)(const 
3d50: 63 68 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2a 2c  char*, OsFile**,
3d60: 20 69 6e 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78   int);.  int (*x
3d70: 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 29 28 63 6f  OpenReadOnly)(co
3d80: 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73 46 69 6c  nst char*, OsFil
3d90: 65 2a 2a 29 3b 0a 0a 20 20 69 6e 74 20 28 2a 78  e**);..  int (*x
3da0: 44 65 6c 65 74 65 29 28 63 6f 6e 73 74 20 63 68  Delete)(const ch
3db0: 61 72 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78 46  ar*);.  int (*xF
3dc0: 69 6c 65 45 78 69 73 74 73 29 28 63 6f 6e 73 74  ileExists)(const
3dd0: 20 63 68 61 72 2a 29 3b 0a 20 20 63 68 61 72 20   char*);.  char 
3de0: 2a 28 2a 78 46 75 6c 6c 50 61 74 68 6e 61 6d 65  *(*xFullPathname
3df0: 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a  )(const char*);.
3e00: 20 20 69 6e 74 20 28 2a 78 49 73 44 69 72 57 72    int (*xIsDirWr
3e10: 69 74 61 62 6c 65 29 28 63 68 61 72 2a 29 3b 0a  itable)(char*);.
3e20: 20 20 69 6e 74 20 28 2a 78 53 79 6e 63 44 69 72    int (*xSyncDir
3e30: 65 63 74 6f 72 79 29 28 63 6f 6e 73 74 20 63 68  ectory)(const ch
3e40: 61 72 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78 54  ar*);.  int (*xT
3e50: 65 6d 70 46 69 6c 65 4e 61 6d 65 29 28 63 68 61  empFileName)(cha
3e60: 72 2a 29 3b 0a 0a 20 20 69 6e 74 20 28 2a 78 52  r*);..  int (*xR
3e70: 61 6e 64 6f 6d 53 65 65 64 29 28 63 68 61 72 2a  andomSeed)(char*
3e80: 29 3b 0a 20 20 69 6e 74 20 28 2a 78 53 6c 65 65  );.  int (*xSlee
3e90: 70 29 28 69 6e 74 20 6d 73 29 3b 0a 20 20 69 6e  p)(int ms);.  in
3ea0: 74 20 28 2a 78 43 75 72 72 65 6e 74 54 69 6d 65  t (*xCurrentTime
3eb0: 29 28 64 6f 75 62 6c 65 2a 29 3b 0a 0a 20 20 76  )(double*);..  v
3ec0: 6f 69 64 20 28 2a 78 45 6e 74 65 72 4d 75 74 65  oid (*xEnterMute
3ed0: 78 29 28 76 6f 69 64 29 3b 0a 20 20 76 6f 69 64  x)(void);.  void
3ee0: 20 28 2a 78 4c 65 61 76 65 4d 75 74 65 78 29 28   (*xLeaveMutex)(
3ef0: 76 6f 69 64 29 3b 0a 20 20 69 6e 74 20 28 2a 78  void);.  int (*x
3f00: 49 6e 4d 75 74 65 78 29 28 69 6e 74 29 3b 0a 20  InMutex)(int);. 
3f10: 20 54 68 72 65 61 64 44 61 74 61 20 2a 28 2a 78   ThreadData *(*x
3f20: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61  ThreadSpecificDa
3f30: 74 61 29 28 69 6e 74 29 3b 0a 0a 20 20 76 6f 69  ta)(int);..  voi
3f40: 64 20 2a 28 2a 78 4d 61 6c 6c 6f 63 29 28 69 6e  d *(*xMalloc)(in
3f50: 74 29 3b 0a 20 20 76 6f 69 64 20 2a 28 2a 78 52  t);.  void *(*xR
3f60: 65 61 6c 6c 6f 63 29 28 76 6f 69 64 20 2a 2c 20  ealloc)(void *, 
3f70: 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 28 2a 78  int);.  void (*x
3f80: 46 72 65 65 29 28 76 6f 69 64 20 2a 29 3b 0a 20  Free)(void *);. 
3f90: 20 69 6e 74 20 28 2a 78 41 6c 6c 6f 63 61 74 69   int (*xAllocati
3fa0: 6f 6e 53 69 7a 65 29 28 76 6f 69 64 20 2a 29 3b  onSize)(void *);
3fb0: 0a 0a 20 20 76 6f 69 64 20 2a 28 2a 78 44 6c 6f  ..  void *(*xDlo
3fc0: 70 65 6e 29 28 63 6f 6e 73 74 20 63 68 61 72 2a  pen)(const char*
3fd0: 29 3b 0a 20 20 76 6f 69 64 20 2a 28 2a 78 44 6c  );.  void *(*xDl
3fe0: 73 79 6d 29 28 76 6f 69 64 2a 2c 20 63 6f 6e 73  sym)(void*, cons
3ff0: 74 20 63 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20  t char*);.  int 
4000: 28 2a 78 44 6c 63 6c 6f 73 65 29 28 76 6f 69 64  (*xDlclose)(void
4010: 2a 29 3b 0a 7d 3b 0a 0a 2f 2a 20 4d 61 63 72 6f  *);.};../* Macro
4020: 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 65 6e 74   used to comment
4030: 20 6f 75 74 20 72 6f 75 74 69 6e 65 73 20 74 68   out routines th
4040: 61 74 20 64 6f 20 6e 6f 74 20 65 78 69 73 74 73  at do not exists
4050: 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 0a 2a   when there is.*
4060: 2a 20 6e 6f 20 64 69 73 6b 20 49 2f 4f 20 6f 72  * no disk I/O or
4070: 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 69   extension loadi
4080: 6e 67 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c  ng.*/.#ifdef SQL
4090: 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a  ITE_OMIT_DISKIO.
40a0: 23 20 64 65 66 69 6e 65 20 49 46 5f 44 49 53 4b  # define IF_DISK
40b0: 49 4f 28 58 29 20 20 30 0a 23 65 6c 73 65 0a 23  IO(X)  0.#else.#
40c0: 20 64 65 66 69 6e 65 20 49 46 5f 44 49 53 4b 49   define IF_DISKI
40d0: 4f 28 58 29 20 20 58 0a 23 65 6e 64 69 66 0a 23  O(X)  X.#endif.#
40e0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  ifdef SQLITE_OMI
40f0: 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e  T_LOAD_EXTENSION
4100: 0a 23 20 64 65 66 69 6e 65 20 49 46 5f 44 4c 4f  .# define IF_DLO
4110: 50 45 4e 28 58 29 20 20 30 0a 23 65 6c 73 65 0a  PEN(X)  0.#else.
4120: 23 20 64 65 66 69 6e 65 20 49 46 5f 44 4c 4f 50  # define IF_DLOP
4130: 45 4e 28 58 29 20 20 58 0a 23 65 6e 64 69 66 0a  EN(X)  X.#endif.
4140: 0a 0a 23 69 66 64 65 66 20 5f 53 51 4c 49 54 45  ..#ifdef _SQLITE
4150: 5f 4f 53 5f 43 5f 0a 20 20 2f 2a 0a 20 20 2a 2a  _OS_C_.  /*.  **
4160: 20 54 68 65 20 6f 73 2e 63 20 66 69 6c 65 20 69   The os.c file i
4170: 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 67 6c  mplements the gl
4180: 6f 62 61 6c 20 76 69 72 74 75 61 6c 20 66 75 6e  obal virtual fun
4190: 63 74 69 6f 6e 20 74 61 62 6c 65 2e 0a 20 20 2a  ction table..  *
41a0: 2f 0a 20 20 73 74 72 75 63 74 20 73 71 6c 69 74  /.  struct sqlit
41b0: 65 33 4f 73 56 74 62 6c 20 73 71 6c 69 74 65 33  e3OsVtbl sqlite3
41c0: 4f 73 20 3d 20 7b 0a 20 20 20 20 49 46 5f 44 49  Os = {.    IF_DI
41d0: 53 4b 49 4f 28 20 73 71 6c 69 74 65 33 4f 73 4f  SKIO( sqlite3OsO
41e0: 70 65 6e 52 65 61 64 57 72 69 74 65 20 29 2c 0a  penReadWrite ),.
41f0: 20 20 20 20 49 46 5f 44 49 53 4b 49 4f 28 20 73      IF_DISKIO( s
4200: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c  qlite3OsOpenExcl
4210: 75 73 69 76 65 20 29 2c 0a 20 20 20 20 49 46 5f  usive ),.    IF_
4220: 44 49 53 4b 49 4f 28 20 73 71 6c 69 74 65 33 4f  DISKIO( sqlite3O
4230: 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 20 29 2c  sOpenReadOnly ),
4240: 0a 20 20 20 20 49 46 5f 44 49 53 4b 49 4f 28 20  .    IF_DISKIO( 
4250: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 20  sqlite3OsDelete 
4260: 29 2c 0a 20 20 20 20 49 46 5f 44 49 53 4b 49 4f  ),.    IF_DISKIO
4270: 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45  ( sqlite3OsFileE
4280: 78 69 73 74 73 20 29 2c 0a 20 20 20 20 49 46 5f  xists ),.    IF_
4290: 44 49 53 4b 49 4f 28 20 73 71 6c 69 74 65 33 4f  DISKIO( sqlite3O
42a0: 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 2c  sFullPathname ),
42b0: 0a 20 20 20 20 49 46 5f 44 49 53 4b 49 4f 28 20  .    IF_DISKIO( 
42c0: 73 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72  sqlite3OsIsDirWr
42d0: 69 74 61 62 6c 65 20 29 2c 0a 20 20 20 20 49 46  itable ),.    IF
42e0: 5f 44 49 53 4b 49 4f 28 20 73 71 6c 69 74 65 33  _DISKIO( sqlite3
42f0: 4f 73 53 79 6e 63 44 69 72 65 63 74 6f 72 79 20  OsSyncDirectory 
4300: 29 2c 0a 20 20 20 20 49 46 5f 44 49 53 4b 49 4f  ),.    IF_DISKIO
4310: 28 20 73 71 6c 69 74 65 33 4f 73 54 65 6d 70 46  ( sqlite3OsTempF
4320: 69 6c 65 4e 61 6d 65 20 29 2c 0a 20 20 20 20 73  ileName ),.    s
4330: 71 6c 69 74 65 33 4f 73 52 61 6e 64 6f 6d 53 65  qlite3OsRandomSe
4340: 65 64 2c 0a 20 20 20 20 73 71 6c 69 74 65 33 4f  ed,.    sqlite3O
4350: 73 53 6c 65 65 70 2c 0a 20 20 20 20 73 71 6c 69  sSleep,.    sqli
4360: 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d 65  te3OsCurrentTime
4370: 2c 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 45  ,.    sqlite3OsE
4380: 6e 74 65 72 4d 75 74 65 78 2c 0a 20 20 20 20 73  nterMutex,.    s
4390: 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75 74  qlite3OsLeaveMut
43a0: 65 78 2c 0a 20 20 20 20 73 71 6c 69 74 65 33 4f  ex,.    sqlite3O
43b0: 73 49 6e 4d 75 74 65 78 2c 0a 20 20 20 20 73 71  sInMutex,.    sq
43c0: 6c 69 74 65 33 4f 73 54 68 72 65 61 64 53 70 65  lite3OsThreadSpe
43d0: 63 69 66 69 63 44 61 74 61 2c 0a 20 20 20 20 73  cificData,.    s
43e0: 71 6c 69 74 65 33 4f 73 4d 61 6c 6c 6f 63 2c 0a  qlite3OsMalloc,.
43f0: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 52 65 61      sqlite3OsRea
4400: 6c 6c 6f 63 2c 0a 20 20 20 20 73 71 6c 69 74 65  lloc,.    sqlite
4410: 33 4f 73 46 72 65 65 2c 0a 20 20 20 20 73 71 6c  3OsFree,.    sql
4420: 69 74 65 33 4f 73 41 6c 6c 6f 63 61 74 69 6f 6e  ite3OsAllocation
4430: 53 69 7a 65 2c 0a 20 20 20 20 49 46 5f 44 4c 4f  Size,.    IF_DLO
4440: 50 45 4e 28 20 73 71 6c 69 74 65 33 4f 73 44 6c  PEN( sqlite3OsDl
4450: 6f 70 65 6e 20 29 2c 0a 20 20 20 20 49 46 5f 44  open ),.    IF_D
4460: 4c 4f 50 45 4e 28 20 73 71 6c 69 74 65 33 4f 73  LOPEN( sqlite3Os
4470: 44 6c 73 79 6d 20 29 2c 0a 20 20 20 20 49 46 5f  Dlsym ),.    IF_
4480: 44 4c 4f 50 45 4e 28 20 73 71 6c 69 74 65 33 4f  DLOPEN( sqlite3O
4490: 73 44 6c 63 6c 6f 73 65 20 29 2c 0a 20 20 7d 3b  sDlclose ),.  };
44a0: 0a 23 65 6c 73 65 0a 20 20 2f 2a 0a 20 20 2a 2a  .#else.  /*.  **
44b0: 20 46 69 6c 65 73 20 6f 74 68 65 72 20 74 68 61   Files other tha
44c0: 6e 20 6f 73 2e 63 20 6a 75 73 74 20 72 65 66 65  n os.c just refe
44d0: 72 65 6e 63 65 20 74 68 65 20 67 6c 6f 62 61 6c  rence the global
44e0: 20 76 69 72 74 75 61 6c 20 66 75 6e 63 74 69 6f   virtual functio
44f0: 6e 20 74 61 62 6c 65 2e 20 0a 20 20 2a 2f 0a 20  n table. .  */. 
4500: 20 65 78 74 65 72 6e 20 73 74 72 75 63 74 20 73   extern struct s
4510: 71 6c 69 74 65 33 4f 73 56 74 62 6c 20 73 71 6c  qlite3OsVtbl sql
4520: 69 74 65 33 4f 73 3b 0a 23 65 6e 64 69 66 20 2f  ite3Os;.#endif /
4530: 2a 20 5f 53 51 4c 49 54 45 5f 4f 53 5f 43 5f 20  * _SQLITE_OS_C_ 
4540: 2a 2f 0a 0a 0a 2f 2a 20 54 68 69 73 20 61 64 64  */.../* This add
4550: 69 74 69 6f 6e 61 6c 20 41 50 49 20 72 6f 75 74  itional API rout
4560: 69 6e 65 20 69 73 20 61 76 61 69 6c 61 62 6c 65  ine is available
4570: 20 77 69 74 68 20 72 65 64 65 66 69 6e 61 62 6c   with redefinabl
4580: 65 20 49 2f 4f 20 2a 2f 0a 73 74 72 75 63 74 20  e I/O */.struct 
4590: 73 71 6c 69 74 65 33 4f 73 56 74 62 6c 20 2a 73  sqlite3OsVtbl *s
45a0: 71 6c 69 74 65 33 5f 6f 73 5f 73 77 69 74 63 68  qlite3_os_switch
45b0: 28 76 6f 69 64 29 3b 0a 0a 0a 2f 2a 0a 2a 2a 20  (void);.../*.** 
45c0: 52 65 64 65 66 69 6e 65 20 74 68 65 20 4f 53 20  Redefine the OS 
45d0: 69 6e 74 65 72 66 61 63 65 20 74 6f 20 67 6f 20  interface to go 
45e0: 74 68 72 6f 75 67 68 20 74 68 65 20 76 69 72 74  through the virt
45f0: 75 61 6c 20 66 75 6e 63 74 69 6f 6e 20 74 61 62  ual function tab
4600: 6c 65 0a 2a 2a 20 72 61 74 68 65 72 20 74 68 61  le.** rather tha
4610: 6e 20 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e  n calling routin
4620: 65 73 20 64 69 72 65 63 74 6c 79 2e 0a 2a 2f 0a  es directly..*/.
4630: 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73  #undef sqlite3Os
4640: 4f 70 65 6e 52 65 61 64 57 72 69 74 65 0a 23 75  OpenReadWrite.#u
4650: 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73 4f 70  ndef sqlite3OsOp
4660: 65 6e 45 78 63 6c 75 73 69 76 65 0a 23 75 6e 64  enExclusive.#und
4670: 65 66 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e  ef sqlite3OsOpen
4680: 52 65 61 64 4f 6e 6c 79 0a 23 75 6e 64 65 66 20  ReadOnly.#undef 
4690: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 0a  sqlite3OsDelete.
46a0: 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73  #undef sqlite3Os
46b0: 46 69 6c 65 45 78 69 73 74 73 0a 23 75 6e 64 65  FileExists.#unde
46c0: 66 20 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50  f sqlite3OsFullP
46d0: 61 74 68 6e 61 6d 65 0a 23 75 6e 64 65 66 20 73  athname.#undef s
46e0: 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72 69  qlite3OsIsDirWri
46f0: 74 61 62 6c 65 0a 23 75 6e 64 65 66 20 73 71 6c  table.#undef sql
4700: 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74  ite3OsSyncDirect
4710: 6f 72 79 0a 23 75 6e 64 65 66 20 73 71 6c 69 74  ory.#undef sqlit
4720: 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65  e3OsTempFileName
4730: 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f  .#undef sqlite3O
4740: 73 52 61 6e 64 6f 6d 53 65 65 64 0a 23 75 6e 64  sRandomSeed.#und
4750: 65 66 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65  ef sqlite3OsSlee
4760: 70 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33  p.#undef sqlite3
4770: 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 0a 23 75  OsCurrentTime.#u
4780: 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73 45 6e  ndef sqlite3OsEn
4790: 74 65 72 4d 75 74 65 78 0a 23 75 6e 64 65 66 20  terMutex.#undef 
47a0: 73 71 6c 69 74 65 33 4f 73 4c 65 61 76 65 4d 75  sqlite3OsLeaveMu
47b0: 74 65 78 0a 23 75 6e 64 65 66 20 73 71 6c 69 74  tex.#undef sqlit
47c0: 65 33 4f 73 49 6e 4d 75 74 65 78 0a 23 75 6e 64  e3OsInMutex.#und
47d0: 65 66 20 73 71 6c 69 74 65 33 4f 73 54 68 72 65  ef sqlite3OsThre
47e0: 61 64 53 70 65 63 69 66 69 63 44 61 74 61 0a 23  adSpecificData.#
47f0: 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73 4d  undef sqlite3OsM
4800: 61 6c 6c 6f 63 0a 23 75 6e 64 65 66 20 73 71 6c  alloc.#undef sql
4810: 69 74 65 33 4f 73 52 65 61 6c 6c 6f 63 0a 23 75  ite3OsRealloc.#u
4820: 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73 46 72  ndef sqlite3OsFr
4830: 65 65 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65  ee.#undef sqlite
4840: 33 4f 73 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a  3OsAllocationSiz
4850: 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  e.#define sqlite
4860: 33 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65  3OsOpenReadWrite
4870: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e        sqlite3Os.
4880: 78 4f 70 65 6e 52 65 61 64 57 72 69 74 65 0a 23  xOpenReadWrite.#
4890: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
48a0: 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 20 20 20  OpenExclusive   
48b0: 20 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 4f 70     sqlite3Os.xOp
48c0: 65 6e 45 78 63 6c 75 73 69 76 65 0a 23 64 65 66  enExclusive.#def
48d0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4f 70 65  ine sqlite3OsOpe
48e0: 6e 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 20 20  nReadOnly       
48f0: 73 71 6c 69 74 65 33 4f 73 2e 78 4f 70 65 6e 52  sqlite3Os.xOpenR
4900: 65 61 64 4f 6e 6c 79 0a 23 64 65 66 69 6e 65 20  eadOnly.#define 
4910: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 20  sqlite3OsDelete 
4920: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
4930: 74 65 33 4f 73 2e 78 44 65 6c 65 74 65 0a 23 64  te3Os.xDelete.#d
4940: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46  efine sqlite3OsF
4950: 69 6c 65 45 78 69 73 74 73 20 20 20 20 20 20 20  ileExists       
4960: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 46 69 6c    sqlite3Os.xFil
4970: 65 45 78 69 73 74 73 0a 23 64 65 66 69 6e 65 20  eExists.#define 
4980: 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74  sqlite3OsFullPat
4990: 68 6e 61 6d 65 20 20 20 20 20 20 20 73 71 6c 69  hname       sqli
49a0: 74 65 33 4f 73 2e 78 46 75 6c 6c 50 61 74 68 6e  te3Os.xFullPathn
49b0: 61 6d 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  ame.#define sqli
49c0: 74 65 33 4f 73 49 73 44 69 72 57 72 69 74 61 62  te3OsIsDirWritab
49d0: 6c 65 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f  le      sqlite3O
49e0: 73 2e 78 49 73 44 69 72 57 72 69 74 61 62 6c 65  s.xIsDirWritable
49f0: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
4a00: 4f 73 53 79 6e 63 44 69 72 65 63 74 6f 72 79 20  OsSyncDirectory 
4a10: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e 78       sqlite3Os.x
4a20: 53 79 6e 63 44 69 72 65 63 74 6f 72 79 0a 23 64  SyncDirectory.#d
4a30: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 54  efine sqlite3OsT
4a40: 65 6d 70 46 69 6c 65 4e 61 6d 65 20 20 20 20 20  empFileName     
4a50: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 54 65 6d    sqlite3Os.xTem
4a60: 70 46 69 6c 65 4e 61 6d 65 0a 23 64 65 66 69 6e  pFileName.#defin
4a70: 65 20 73 71 6c 69 74 65 33 4f 73 52 61 6e 64 6f  e sqlite3OsRando
4a80: 6d 53 65 65 64 20 20 20 20 20 20 20 20 20 73 71  mSeed         sq
4a90: 6c 69 74 65 33 4f 73 2e 78 52 61 6e 64 6f 6d 53  lite3Os.xRandomS
4aa0: 65 65 64 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  eed.#define sqli
4ab0: 74 65 33 4f 73 53 6c 65 65 70 20 20 20 20 20 20  te3OsSleep      
4ac0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
4ad0: 73 2e 78 53 6c 65 65 70 0a 23 64 65 66 69 6e 65  s.xSleep.#define
4ae0: 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65 6e   sqlite3OsCurren
4af0: 74 54 69 6d 65 20 20 20 20 20 20 20 20 73 71 6c  tTime        sql
4b00: 69 74 65 33 4f 73 2e 78 43 75 72 72 65 6e 74 54  ite3Os.xCurrentT
4b10: 69 6d 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  ime.#define sqli
4b20: 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 20  te3OsEnterMutex 
4b30: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
4b40: 73 2e 78 45 6e 74 65 72 4d 75 74 65 78 0a 23 64  s.xEnterMutex.#d
4b50: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4c  efine sqlite3OsL
4b60: 65 61 76 65 4d 75 74 65 78 20 20 20 20 20 20 20  eaveMutex       
4b70: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 4c 65 61    sqlite3Os.xLea
4b80: 76 65 4d 75 74 65 78 0a 23 64 65 66 69 6e 65 20  veMutex.#define 
4b90: 73 71 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65 78  sqlite3OsInMutex
4ba0: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
4bb0: 74 65 33 4f 73 2e 78 49 6e 4d 75 74 65 78 0a 23  te3Os.xInMutex.#
4bc0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
4bd0: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61  ThreadSpecificDa
4be0: 74 61 20 73 71 6c 69 74 65 33 4f 73 2e 78 54 68  ta sqlite3Os.xTh
4bf0: 72 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61  readSpecificData
4c00: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
4c10: 4f 73 4d 61 6c 6c 6f 63 20 20 20 20 20 20 20 20  OsMalloc        
4c20: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e 78       sqlite3Os.x
4c30: 4d 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20 73  Malloc.#define s
4c40: 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c 6f 63 20  qlite3OsRealloc 
4c50: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
4c60: 65 33 4f 73 2e 78 52 65 61 6c 6c 6f 63 0a 23 64  e3Os.xRealloc.#d
4c70: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46  efine sqlite3OsF
4c80: 72 65 65 20 20 20 20 20 20 20 20 20 20 20 20 20  ree             
4c90: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 46 72 65    sqlite3Os.xFre
4ca0: 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  e.#define sqlite
4cb0: 33 4f 73 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a  3OsAllocationSiz
4cc0: 65 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e  e     sqlite3Os.
4cd0: 78 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a  xAllocationSize.
4ce0: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
4cf0: 45 5f 45 4e 41 42 4c 45 5f 52 45 44 45 46 5f 49  E_ENABLE_REDEF_I
4d00: 4f 20 2a 2f 0a 0a 23 65 6e 64 69 66 20 2f 2a 20  O */..#endif /* 
4d10: 5f 53 51 4c 49 54 45 5f 4f 53 5f 48 5f 20 2a 2f  _SQLITE_OS_H_ */
4d20: 0a                                               .