/ Hex Artifact Content
Login

Artifact 3fd6a022bafd620fdfd779a51dccb42f31c97f75:


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 2f 0a 23 69 66 6e 64 65 66 20  ine..*/.#ifndef 
0960: 54 45 4d 50 5f 46 49 4c 45 5f 50 52 45 46 49 58  TEMP_FILE_PREFIX
0970: 0a 23 20 64 65 66 69 6e 65 20 54 45 4d 50 5f 46  .# define TEMP_F
0980: 49 4c 45 5f 50 52 45 46 49 58 20 22 73 71 6c 69  ILE_PREFIX "sqli
0990: 74 65 5f 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  te_".#endif../*.
09a0: 2a 2a 20 44 65 66 69 6e 65 20 74 68 65 20 69 6e  ** Define the in
09b0: 74 65 72 66 61 63 65 73 20 66 6f 72 20 55 6e 69  terfaces for Uni
09c0: 78 2c 20 57 69 6e 64 6f 77 73 2c 20 61 6e 64 20  x, Windows, and 
09d0: 4f 53 2f 32 2e 0a 2a 2f 0a 23 69 66 20 4f 53 5f  OS/2..*/.#if OS_
09e0: 55 4e 49 58 0a 23 64 65 66 69 6e 65 20 73 71 6c  UNIX.#define sql
09f0: 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57 72  ite3OsOpenReadWr
0a00: 69 74 65 20 20 20 20 20 20 73 71 6c 69 74 65 33  ite      sqlite3
0a10: 55 6e 69 78 4f 70 65 6e 52 65 61 64 57 72 69 74  UnixOpenReadWrit
0a20: 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  e.#define sqlite
0a30: 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65  3OsOpenExclusive
0a40: 20 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69        sqlite3Uni
0a50: 78 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 0a 23  xOpenExclusive.#
0a60: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
0a70: 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 20 20 20 20  OpenReadOnly    
0a80: 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78 4f 70     sqlite3UnixOp
0a90: 65 6e 52 65 61 64 4f 6e 6c 79 0a 23 64 65 66 69  enReadOnly.#defi
0aa0: 6e 65 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65  ne sqlite3OsDele
0ab0: 74 65 20 20 20 20 20 20 20 20 20 20 20 20 20 73  te             s
0ac0: 71 6c 69 74 65 33 55 6e 69 78 44 65 6c 65 74 65  qlite3UnixDelete
0ad0: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
0ae0: 4f 73 46 69 6c 65 45 78 69 73 74 73 20 20 20 20  OsFileExists    
0af0: 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78       sqlite3Unix
0b00: 46 69 6c 65 45 78 69 73 74 73 0a 23 64 65 66 69  FileExists.#defi
0b10: 6e 65 20 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c  ne sqlite3OsFull
0b20: 50 61 74 68 6e 61 6d 65 20 20 20 20 20 20 20 73  Pathname       s
0b30: 71 6c 69 74 65 33 55 6e 69 78 46 75 6c 6c 50 61  qlite3UnixFullPa
0b40: 74 68 6e 61 6d 65 0a 23 64 65 66 69 6e 65 20 73  thname.#define s
0b50: 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72 69  qlite3OsIsDirWri
0b60: 74 61 62 6c 65 20 20 20 20 20 20 73 71 6c 69 74  table      sqlit
0b70: 65 33 55 6e 69 78 49 73 44 69 72 57 72 69 74 61  e3UnixIsDirWrita
0b80: 62 6c 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  ble.#define sqli
0b90: 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74 6f  te3OsSyncDirecto
0ba0: 72 79 20 20 20 20 20 20 73 71 6c 69 74 65 33 55  ry      sqlite3U
0bb0: 6e 69 78 53 79 6e 63 44 69 72 65 63 74 6f 72 79  nixSyncDirectory
0bc0: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
0bd0: 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65 20 20  OsTempFileName  
0be0: 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78       sqlite3Unix
0bf0: 54 65 6d 70 46 69 6c 65 4e 61 6d 65 0a 23 64 65  TempFileName.#de
0c00: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52 61  fine sqlite3OsRa
0c10: 6e 64 6f 6d 53 65 65 64 20 20 20 20 20 20 20 20  ndomSeed        
0c20: 20 73 71 6c 69 74 65 33 55 6e 69 78 52 61 6e 64   sqlite3UnixRand
0c30: 6f 6d 53 65 65 64 0a 23 64 65 66 69 6e 65 20 73  omSeed.#define s
0c40: 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 20 20 20  qlite3OsSleep   
0c50: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
0c60: 65 33 55 6e 69 78 53 6c 65 65 70 0a 23 64 65 66  e3UnixSleep.#def
0c70: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 43 75 72  ine sqlite3OsCur
0c80: 72 65 6e 74 54 69 6d 65 20 20 20 20 20 20 20 20  rentTime        
0c90: 73 71 6c 69 74 65 33 55 6e 69 78 43 75 72 72 65  sqlite3UnixCurre
0ca0: 6e 74 54 69 6d 65 0a 23 64 65 66 69 6e 65 20 73  ntTime.#define s
0cb0: 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 74  qlite3OsEnterMut
0cc0: 65 78 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  ex         sqlit
0cd0: 65 33 55 6e 69 78 45 6e 74 65 72 4d 75 74 65 78  e3UnixEnterMutex
0ce0: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
0cf0: 4f 73 4c 65 61 76 65 4d 75 74 65 78 20 20 20 20  OsLeaveMutex    
0d00: 20 20 20 20 20 73 71 6c 69 74 65 33 55 6e 69 78       sqlite3Unix
0d10: 4c 65 61 76 65 4d 75 74 65 78 0a 23 64 65 66 69  LeaveMutex.#defi
0d20: 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d 75  ne sqlite3OsInMu
0d30: 74 65 78 20 20 20 20 20 20 20 20 20 20 20 20 73  tex            s
0d40: 71 6c 69 74 65 33 55 6e 69 78 49 6e 4d 75 74 65  qlite3UnixInMute
0d50: 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  x.#define sqlite
0d60: 33 4f 73 54 68 72 65 61 64 53 70 65 63 69 66 69  3OsThreadSpecifi
0d70: 63 44 61 74 61 20 73 71 6c 69 74 65 33 55 6e 69  cData sqlite3Uni
0d80: 78 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44  xThreadSpecificD
0d90: 61 74 61 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  ata.#define sqli
0da0: 74 65 33 4f 73 4d 61 6c 6c 6f 63 20 20 20 20 20  te3OsMalloc     
0db0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47          sqlite3G
0dc0: 65 6e 65 72 69 63 4d 61 6c 6c 6f 63 0a 23 64 65  enericMalloc.#de
0dd0: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52 65  fine sqlite3OsRe
0de0: 61 6c 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20  alloc           
0df0: 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63 52   sqlite3GenericR
0e00: 65 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20 73  ealloc.#define s
0e10: 71 6c 69 74 65 33 4f 73 46 72 65 65 20 20 20 20  qlite3OsFree    
0e20: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
0e30: 65 33 47 65 6e 65 72 69 63 46 72 65 65 0a 23 64  e3GenericFree.#d
0e40: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 41  efine sqlite3OsA
0e50: 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 20 20 20  llocationSize   
0e60: 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63    sqlite3Generic
0e70: 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a 23  AllocationSize.#
0e80: 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e  endif.#if OS_WIN
0e90: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
0ea0: 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65 20  OsOpenReadWrite 
0eb0: 20 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 4f       sqlite3WinO
0ec0: 70 65 6e 52 65 61 64 57 72 69 74 65 0a 23 64 65  penReadWrite.#de
0ed0: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4f 70  fine sqlite3OsOp
0ee0: 65 6e 45 78 63 6c 75 73 69 76 65 20 20 20 20 20  enExclusive     
0ef0: 20 73 71 6c 69 74 65 33 57 69 6e 4f 70 65 6e 45   sqlite3WinOpenE
0f00: 78 63 6c 75 73 69 76 65 0a 23 64 65 66 69 6e 65  xclusive.#define
0f10: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65   sqlite3OsOpenRe
0f20: 61 64 4f 6e 6c 79 20 20 20 20 20 20 20 73 71 6c  adOnly       sql
0f30: 69 74 65 33 57 69 6e 4f 70 65 6e 52 65 61 64 4f  ite3WinOpenReadO
0f40: 6e 6c 79 0a 23 64 65 66 69 6e 65 20 73 71 6c 69  nly.#define sqli
0f50: 74 65 33 4f 73 44 65 6c 65 74 65 20 20 20 20 20  te3OsDelete     
0f60: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 57          sqlite3W
0f70: 69 6e 44 65 6c 65 74 65 0a 23 64 65 66 69 6e 65  inDelete.#define
0f80: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78   sqlite3OsFileEx
0f90: 69 73 74 73 20 20 20 20 20 20 20 20 20 73 71 6c  ists         sql
0fa0: 69 74 65 33 57 69 6e 46 69 6c 65 45 78 69 73 74  ite3WinFileExist
0fb0: 73 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  s.#define sqlite
0fc0: 33 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20  3OsFullPathname 
0fd0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e        sqlite3Win
0fe0: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 0a 23 64 65  FullPathname.#de
0ff0: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 73  fine sqlite3OsIs
1000: 44 69 72 57 72 69 74 61 62 6c 65 20 20 20 20 20  DirWritable     
1010: 20 73 71 6c 69 74 65 33 57 69 6e 49 73 44 69 72   sqlite3WinIsDir
1020: 57 72 69 74 61 62 6c 65 0a 23 64 65 66 69 6e 65  Writable.#define
1030: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69   sqlite3OsSyncDi
1040: 72 65 63 74 6f 72 79 20 20 20 20 20 20 73 71 6c  rectory      sql
1050: 69 74 65 33 57 69 6e 53 79 6e 63 44 69 72 65 63  ite3WinSyncDirec
1060: 74 6f 72 79 0a 23 64 65 66 69 6e 65 20 73 71 6c  tory.#define sql
1070: 69 74 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61  ite3OsTempFileNa
1080: 6d 65 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  me       sqlite3
1090: 57 69 6e 54 65 6d 70 46 69 6c 65 4e 61 6d 65 0a  WinTempFileName.
10a0: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
10b0: 73 52 61 6e 64 6f 6d 53 65 65 64 20 20 20 20 20  sRandomSeed     
10c0: 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 52 61      sqlite3WinRa
10d0: 6e 64 6f 6d 53 65 65 64 0a 23 64 65 66 69 6e 65  ndomSeed.#define
10e0: 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 20   sqlite3OsSleep 
10f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c               sql
1100: 69 74 65 33 57 69 6e 53 6c 65 65 70 0a 23 64 65  ite3WinSleep.#de
1110: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 43 75  fine sqlite3OsCu
1120: 72 72 65 6e 74 54 69 6d 65 20 20 20 20 20 20 20  rrentTime       
1130: 20 73 71 6c 69 74 65 33 57 69 6e 43 75 72 72 65   sqlite3WinCurre
1140: 6e 74 54 69 6d 65 0a 23 64 65 66 69 6e 65 20 73  ntTime.#define s
1150: 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75 74  qlite3OsEnterMut
1160: 65 78 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  ex         sqlit
1170: 65 33 57 69 6e 45 6e 74 65 72 4d 75 74 65 78 0a  e3WinEnterMutex.
1180: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1190: 73 4c 65 61 76 65 4d 75 74 65 78 20 20 20 20 20  sLeaveMutex     
11a0: 20 20 20 20 73 71 6c 69 74 65 33 57 69 6e 4c 65      sqlite3WinLe
11b0: 61 76 65 4d 75 74 65 78 0a 23 64 65 66 69 6e 65  aveMutex.#define
11c0: 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65   sqlite3OsInMute
11d0: 78 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c  x            sql
11e0: 69 74 65 33 57 69 6e 49 6e 4d 75 74 65 78 0a 23  ite3WinInMutex.#
11f0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
1200: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61  ThreadSpecificDa
1210: 74 61 20 73 71 6c 69 74 65 33 57 69 6e 54 68 72  ta sqlite3WinThr
1220: 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 0a  eadSpecificData.
1230: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
1240: 73 4d 61 6c 6c 6f 63 20 20 20 20 20 20 20 20 20  sMalloc         
1250: 20 20 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72      sqlite3Gener
1260: 69 63 4d 61 6c 6c 6f 63 0a 23 64 65 66 69 6e 65  icMalloc.#define
1270: 20 73 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c 6f   sqlite3OsReallo
1280: 63 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c  c            sql
1290: 69 74 65 33 47 65 6e 65 72 69 63 52 65 61 6c 6c  ite3GenericReall
12a0: 6f 63 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  oc.#define sqlit
12b0: 65 33 4f 73 46 72 65 65 20 20 20 20 20 20 20 20  e3OsFree        
12c0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 47 65         sqlite3Ge
12d0: 6e 65 72 69 63 46 72 65 65 0a 23 64 65 66 69 6e  nericFree.#defin
12e0: 65 20 73 71 6c 69 74 65 33 4f 73 41 6c 6c 6f 63  e sqlite3OsAlloc
12f0: 61 74 69 6f 6e 53 69 7a 65 20 20 20 20 20 73 71  ationSize     sq
1300: 6c 69 74 65 33 47 65 6e 65 72 69 63 41 6c 6c 6f  lite3GenericAllo
1310: 63 61 74 69 6f 6e 53 69 7a 65 0a 23 65 6e 64 69  cationSize.#endi
1320: 66 0a 23 69 66 20 4f 53 5f 4f 53 32 0a 23 64 65  f.#if OS_OS2.#de
1330: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4f 70  fine sqlite3OsOp
1340: 65 6e 52 65 61 64 57 72 69 74 65 20 20 20 20 20  enReadWrite     
1350: 20 73 71 6c 69 74 65 33 4f 73 32 4f 70 65 6e 52   sqlite3Os2OpenR
1360: 65 61 64 57 72 69 74 65 0a 23 64 65 66 69 6e 65  eadWrite.#define
1370: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78   sqlite3OsOpenEx
1380: 63 6c 75 73 69 76 65 20 20 20 20 20 20 73 71 6c  clusive      sql
1390: 69 74 65 33 4f 73 32 4f 70 65 6e 45 78 63 6c 75  ite3Os2OpenExclu
13a0: 73 69 76 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  sive.#define sql
13b0: 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 4f 6e  ite3OsOpenReadOn
13c0: 6c 79 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  ly       sqlite3
13d0: 4f 73 32 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 0a  Os2OpenReadOnly.
13e0: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
13f0: 73 44 65 6c 65 74 65 20 20 20 20 20 20 20 20 20  sDelete         
1400: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 32 44 65      sqlite3Os2De
1410: 6c 65 74 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  lete.#define sql
1420: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
1430: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
1440: 4f 73 32 46 69 6c 65 45 78 69 73 74 73 0a 23 64  Os2FileExists.#d
1450: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46  efine sqlite3OsF
1460: 75 6c 6c 50 61 74 68 6e 61 6d 65 20 20 20 20 20  ullPathname     
1470: 20 20 73 71 6c 69 74 65 33 4f 73 32 46 75 6c 6c    sqlite3Os2Full
1480: 50 61 74 68 6e 61 6d 65 0a 23 64 65 66 69 6e 65  Pathname.#define
1490: 20 73 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57   sqlite3OsIsDirW
14a0: 72 69 74 61 62 6c 65 20 20 20 20 20 20 73 71 6c  ritable      sql
14b0: 69 74 65 33 4f 73 32 49 73 44 69 72 57 72 69 74  ite3Os2IsDirWrit
14c0: 61 62 6c 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  able.#define sql
14d0: 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74  ite3OsSyncDirect
14e0: 6f 72 79 20 20 20 20 20 20 73 71 6c 69 74 65 33  ory      sqlite3
14f0: 4f 73 32 53 79 6e 63 44 69 72 65 63 74 6f 72 79  Os2SyncDirectory
1500: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
1510: 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65 20 20  OsTempFileName  
1520: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 32 54       sqlite3Os2T
1530: 65 6d 70 46 69 6c 65 4e 61 6d 65 0a 23 64 65 66  empFileName.#def
1540: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52 61 6e  ine sqlite3OsRan
1550: 64 6f 6d 53 65 65 64 20 20 20 20 20 20 20 20 20  domSeed         
1560: 73 71 6c 69 74 65 33 4f 73 32 52 61 6e 64 6f 6d  sqlite3Os2Random
1570: 53 65 65 64 0a 23 64 65 66 69 6e 65 20 73 71 6c  Seed.#define sql
1580: 69 74 65 33 4f 73 53 6c 65 65 70 20 20 20 20 20  ite3OsSleep     
1590: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
15a0: 4f 73 32 53 6c 65 65 70 0a 23 64 65 66 69 6e 65  Os2Sleep.#define
15b0: 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72 65 6e   sqlite3OsCurren
15c0: 74 54 69 6d 65 20 20 20 20 20 20 20 20 73 71 6c  tTime        sql
15d0: 69 74 65 33 4f 73 32 43 75 72 72 65 6e 74 54 69  ite3Os2CurrentTi
15e0: 6d 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  me.#define sqlit
15f0: 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 20 20  e3OsEnterMutex  
1600: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73         sqlite3Os
1610: 32 45 6e 74 65 72 4d 75 74 65 78 0a 23 64 65 66  2EnterMutex.#def
1620: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4c 65 61  ine sqlite3OsLea
1630: 76 65 4d 75 74 65 78 20 20 20 20 20 20 20 20 20  veMutex         
1640: 73 71 6c 69 74 65 33 4f 73 32 4c 65 61 76 65 4d  sqlite3Os2LeaveM
1650: 75 74 65 78 0a 23 64 65 66 69 6e 65 20 73 71 6c  utex.#define sql
1660: 69 74 65 33 4f 73 49 6e 4d 75 74 65 78 20 20 20  ite3OsInMutex   
1670: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
1680: 4f 73 32 49 6e 4d 75 74 65 78 0a 23 64 65 66 69  Os2InMutex.#defi
1690: 6e 65 20 73 71 6c 69 74 65 33 4f 73 54 68 72 65  ne sqlite3OsThre
16a0: 61 64 53 70 65 63 69 66 69 63 44 61 74 61 20 73  adSpecificData s
16b0: 71 6c 69 74 65 33 4f 73 32 54 68 72 65 61 64 53  qlite3Os2ThreadS
16c0: 70 65 63 69 66 69 63 44 61 74 61 0a 23 64 65 66  pecificData.#def
16d0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 4d 61 6c  ine sqlite3OsMal
16e0: 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20 20 20  loc             
16f0: 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63 4d 61  sqlite3GenericMa
1700: 6c 6c 6f 63 0a 23 64 65 66 69 6e 65 20 73 71 6c  lloc.#define sql
1710: 69 74 65 33 4f 73 52 65 61 6c 6c 6f 63 20 20 20  ite3OsRealloc   
1720: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
1730: 47 65 6e 65 72 69 63 52 65 61 6c 6c 6f 63 0a 23  GenericRealloc.#
1740: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73  define sqlite3Os
1750: 46 72 65 65 20 20 20 20 20 20 20 20 20 20 20 20  Free            
1760: 20 20 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69     sqlite3Generi
1770: 63 46 72 65 65 0a 23 64 65 66 69 6e 65 20 73 71  cFree.#define sq
1780: 6c 69 74 65 33 4f 73 41 6c 6c 6f 63 61 74 69 6f  lite3OsAllocatio
1790: 6e 53 69 7a 65 20 20 20 20 20 73 71 6c 69 74 65  nSize     sqlite
17a0: 33 47 65 6e 65 72 69 63 41 6c 6c 6f 63 61 74 69  3GenericAllocati
17b0: 6f 6e 53 69 7a 65 0a 23 65 6e 64 69 66 0a 0a 0a  onSize.#endif...
17c0: 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 75 73 69 6e 67  ../*.** If using
17d0: 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20   an alternative 
17e0: 4f 53 20 69 6e 74 65 72 66 61 63 65 2c 20 74 68  OS interface, th
17f0: 65 6e 20 77 65 20 6d 75 73 74 20 68 61 76 65 20  en we must have 
1800: 61 6e 20 22 6f 73 5f 6f 74 68 65 72 2e 68 22 0a  an "os_other.h".
1810: 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20 61  ** header file a
1820: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 61  vailable for tha
1830: 74 20 69 6e 74 65 72 66 61 63 65 2e 20 20 50 72  t interface.  Pr
1840: 65 73 75 6d 61 62 6c 79 20 74 68 65 20 22 6f 73  esumably the "os
1850: 5f 6f 74 68 65 72 2e 68 22 0a 2a 2a 20 68 65 61  _other.h".** hea
1860: 64 65 72 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e  der file contain
1870: 73 20 23 64 65 66 69 6e 65 73 20 73 69 6d 69 6c  s #defines simil
1880: 61 72 20 74 6f 20 74 68 6f 73 65 20 61 62 6f 76  ar to those abov
1890: 65 2e 0a 2a 2f 0a 23 69 66 20 4f 53 5f 4f 54 48  e..*/.#if OS_OTH
18a0: 45 52 0a 23 20 69 6e 63 6c 75 64 65 20 22 6f 73  ER.# include "os
18b0: 5f 6f 74 68 65 72 2e 68 22 0a 23 65 6e 64 69 66  _other.h".#endif
18c0: 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 77 61 72  ..../*.** Forwar
18d0: 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 0a 2a  d declarations.*
18e0: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
18f0: 20 4f 73 46 69 6c 65 20 4f 73 46 69 6c 65 3b 0a   OsFile OsFile;.
1900: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 49  typedef struct I
1910: 6f 4d 65 74 68 6f 64 20 49 6f 4d 65 74 68 6f 64  oMethod IoMethod
1920: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74  ;../*.** An inst
1930: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c  ance of the foll
1940: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20  owing structure 
1950: 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72  contains pointer
1960: 73 20 74 6f 20 61 6c 6c 0a 2a 2a 20 6d 65 74 68  s to all.** meth
1970: 6f 64 73 20 6f 6e 20 61 6e 20 4f 73 46 69 6c 65  ods on an OsFile
1980: 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 72 75   object..*/.stru
1990: 63 74 20 49 6f 4d 65 74 68 6f 64 20 7b 0a 20 20  ct IoMethod {.  
19a0: 69 6e 74 20 28 2a 78 43 6c 6f 73 65 29 28 4f 73  int (*xClose)(Os
19b0: 46 69 6c 65 2a 2a 29 3b 0a 20 20 69 6e 74 20 28  File**);.  int (
19c0: 2a 78 4f 70 65 6e 44 69 72 65 63 74 6f 72 79 29  *xOpenDirectory)
19d0: 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e 73 74 20  (OsFile*, const 
19e0: 63 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20 28 2a  char*);.  int (*
19f0: 78 52 65 61 64 29 28 4f 73 46 69 6c 65 2a 2c 20  xRead)(OsFile*, 
1a00: 76 6f 69 64 2a 2c 20 69 6e 74 20 61 6d 74 29 3b  void*, int amt);
1a10: 0a 20 20 69 6e 74 20 28 2a 78 57 72 69 74 65 29  .  int (*xWrite)
1a20: 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e 73 74 20  (OsFile*, const 
1a30: 76 6f 69 64 2a 2c 20 69 6e 74 20 61 6d 74 29 3b  void*, int amt);
1a40: 0a 20 20 69 6e 74 20 28 2a 78 53 65 65 6b 29 28  .  int (*xSeek)(
1a50: 4f 73 46 69 6c 65 2a 2c 20 69 36 34 20 6f 66 66  OsFile*, i64 off
1a60: 73 65 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78 54  set);.  int (*xT
1a70: 72 75 6e 63 61 74 65 29 28 4f 73 46 69 6c 65 2a  runcate)(OsFile*
1a80: 2c 20 69 36 34 20 73 69 7a 65 29 3b 0a 20 20 69  , i64 size);.  i
1a90: 6e 74 20 28 2a 78 53 79 6e 63 29 28 4f 73 46 69  nt (*xSync)(OsFi
1aa0: 6c 65 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69  le*, int);.  voi
1ab0: 64 20 28 2a 78 53 65 74 46 75 6c 6c 53 79 6e 63  d (*xSetFullSync
1ac0: 29 28 4f 73 46 69 6c 65 20 2a 69 64 2c 20 69 6e  )(OsFile *id, in
1ad0: 74 20 73 65 74 74 69 6e 67 29 3b 0a 20 20 69 6e  t setting);.  in
1ae0: 74 20 28 2a 78 46 69 6c 65 48 61 6e 64 6c 65 29  t (*xFileHandle)
1af0: 28 4f 73 46 69 6c 65 20 2a 69 64 29 3b 0a 20 20  (OsFile *id);.  
1b00: 69 6e 74 20 28 2a 78 46 69 6c 65 53 69 7a 65 29  int (*xFileSize)
1b10: 28 4f 73 46 69 6c 65 2a 2c 20 69 36 34 20 2a 70  (OsFile*, i64 *p
1b20: 53 69 7a 65 29 3b 0a 20 20 69 6e 74 20 28 2a 78  Size);.  int (*x
1b30: 4c 6f 63 6b 29 28 4f 73 46 69 6c 65 2a 2c 20 69  Lock)(OsFile*, i
1b40: 6e 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78 55 6e  nt);.  int (*xUn
1b50: 6c 6f 63 6b 29 28 4f 73 46 69 6c 65 2a 2c 20 69  lock)(OsFile*, i
1b60: 6e 74 29 3b 0a 20 20 69 6e 74 20 28 2a 78 4c 6f  nt);.  int (*xLo
1b70: 63 6b 53 74 61 74 65 29 28 4f 73 46 69 6c 65 20  ckState)(OsFile 
1b80: 2a 69 64 29 3b 0a 20 20 69 6e 74 20 28 2a 78 43  *id);.  int (*xC
1b90: 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
1ba0: 29 28 4f 73 46 69 6c 65 20 2a 69 64 29 3b 0a 7d  )(OsFile *id);.}
1bb0: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 4f 73 46  ;../*.** The OsF
1bc0: 69 6c 65 20 6f 62 6a 65 63 74 20 64 65 73 63 72  ile object descr
1bd0: 69 62 65 73 20 61 6e 20 6f 70 65 6e 20 64 69 73  ibes an open dis
1be0: 6b 20 66 69 6c 65 20 69 6e 20 61 6e 20 4f 53 2d  k file in an OS-
1bf0: 64 65 70 65 6e 64 65 6e 74 20 77 61 79 2e 0a 2a  dependent way..*
1c00: 2a 20 54 68 65 20 76 65 72 73 69 6f 6e 20 6f 66  * The version of
1c10: 20 4f 73 46 69 6c 65 20 64 65 66 69 6e 65 64 20   OsFile defined 
1c20: 68 65 72 65 20 69 73 20 61 20 67 65 6e 65 72 69  here is a generi
1c30: 63 20 76 65 72 73 69 6f 6e 2e 20 20 45 61 63 68  c version.  Each
1c40: 20 4f 53 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74   OS.** implement
1c50: 61 74 69 6f 6e 20 64 65 66 69 6e 65 73 20 69 74  ation defines it
1c60: 73 20 6f 77 6e 20 73 75 62 63 6c 61 73 73 20 6f  s own subclass o
1c70: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65  f this structure
1c80: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a 2a   that contains.*
1c90: 2a 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  * additional inf
1ca0: 6f 72 6d 61 74 69 6f 6e 20 6e 65 65 64 65 64 20  ormation needed 
1cb0: 74 6f 20 68 61 6e 64 6c 65 20 66 69 6c 65 20 49  to handle file I
1cc0: 2f 4f 2e 20 20 42 75 74 20 74 68 65 20 70 4d 65  /O.  But the pMe
1cd0: 74 68 6f 64 0a 2a 2a 20 65 6e 74 72 79 20 28 70  thod.** entry (p
1ce0: 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 76  ointing to the v
1cf0: 69 72 74 75 61 6c 20 66 75 6e 63 74 69 6f 6e 20  irtual function 
1d00: 74 61 62 6c 65 29 20 61 6c 77 61 79 73 20 6f 63  table) always oc
1d10: 63 75 72 73 20 66 69 72 73 74 0a 2a 2a 20 73 6f  curs first.** so
1d20: 20 74 68 61 74 20 77 65 20 63 61 6e 20 61 6c 77   that we can alw
1d30: 61 79 73 20 66 69 6e 64 20 74 68 65 20 61 70 70  ays find the app
1d40: 72 6f 70 72 69 61 74 65 20 6d 65 74 68 6f 64 73  ropriate methods
1d50: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4f 73 46 69  ..*/.struct OsFi
1d60: 6c 65 20 7b 0a 20 20 49 6f 4d 65 74 68 6f 64 20  le {.  IoMethod 
1d70: 63 6f 6e 73 74 20 2a 70 4d 65 74 68 6f 64 3b 0a  const *pMethod;.
1d80: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  };../*.** The fo
1d90: 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 73 20 6d  llowing values m
1da0: 61 79 20 62 65 20 70 61 73 73 65 64 20 61 73 20  ay be passed as 
1db0: 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d  the second argum
1dc0: 65 6e 74 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65  ent to.** sqlite
1dd0: 33 4f 73 4c 6f 63 6b 28 29 2e 20 54 68 65 20 76  3OsLock(). The v
1de0: 61 72 69 6f 75 73 20 6c 6f 63 6b 73 20 65 78 68  arious locks exh
1df0: 69 62 69 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69  ibit the followi
1e00: 6e 67 20 73 65 6d 61 6e 74 69 63 73 3a 0a 2a 2a  ng semantics:.**
1e10: 0a 2a 2a 20 53 48 41 52 45 44 3a 20 20 20 20 41  .** SHARED:    A
1e20: 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20 70 72 6f  ny number of pro
1e30: 63 65 73 73 65 73 20 6d 61 79 20 68 6f 6c 64 20  cesses may hold 
1e40: 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 73 69  a SHARED lock si
1e50: 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 2e 0a 2a 2a  multaneously..**
1e60: 20 52 45 53 45 52 56 45 44 3a 20 20 41 20 73 69   RESERVED:  A si
1e70: 6e 67 6c 65 20 70 72 6f 63 65 73 73 20 6d 61 79  ngle process may
1e80: 20 68 6f 6c 64 20 61 20 52 45 53 45 52 56 45 44   hold a RESERVED
1e90: 20 6c 6f 63 6b 20 6f 6e 20 61 20 66 69 6c 65 20   lock on a file 
1ea0: 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  at.**           
1eb0: 20 61 6e 79 20 74 69 6d 65 2e 20 4f 74 68 65 72   any time. Other
1ec0: 20 70 72 6f 63 65 73 73 65 73 20 6d 61 79 20 68   processes may h
1ed0: 6f 6c 64 20 61 6e 64 20 6f 62 74 61 69 6e 20 6e  old and obtain n
1ee0: 65 77 20 53 48 41 52 45 44 20 6c 6f 63 6b 73 2e  ew SHARED locks.
1ef0: 0a 2a 2a 20 50 45 4e 44 49 4e 47 3a 20 20 20 41  .** PENDING:   A
1f00: 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 73 73 20   single process 
1f10: 6d 61 79 20 68 6f 6c 64 20 61 20 50 45 4e 44 49  may hold a PENDI
1f20: 4e 47 20 6c 6f 63 6b 20 6f 6e 20 61 20 66 69 6c  NG lock on a fil
1f30: 65 20 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20  e at.**         
1f40: 20 20 20 61 6e 79 20 6f 6e 65 20 74 69 6d 65 2e     any one time.
1f50: 20 45 78 69 73 74 69 6e 67 20 53 48 41 52 45 44   Existing SHARED
1f60: 20 6c 6f 63 6b 73 20 6d 61 79 20 70 65 72 73 69   locks may persi
1f70: 73 74 2c 20 62 75 74 20 6e 6f 20 6e 65 77 0a 2a  st, but no new.*
1f80: 2a 20 20 20 20 20 20 20 20 20 20 20 20 53 48 41  *            SHA
1f90: 52 45 44 20 6c 6f 63 6b 73 20 6d 61 79 20 62 65  RED locks may be
1fa0: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6f 74 68   obtained by oth
1fb0: 65 72 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a 2a  er processes..**
1fc0: 20 45 58 43 4c 55 53 49 56 45 3a 20 41 6e 20 45   EXCLUSIVE: An E
1fd0: 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 70 72  XCLUSIVE lock pr
1fe0: 65 63 6c 75 64 65 73 20 61 6c 6c 20 6f 74 68 65  ecludes all othe
1ff0: 72 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 50  r locks..**.** P
2000: 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 6d 61 79 20  ENDING_LOCK may 
2010: 6e 6f 74 20 62 65 20 70 61 73 73 65 64 20 64 69  not be passed di
2020: 72 65 63 74 6c 79 20 74 6f 20 73 71 6c 69 74 65  rectly to sqlite
2030: 33 4f 73 4c 6f 63 6b 28 29 2e 20 49 6e 73 74 65  3OsLock(). Inste
2040: 61 64 2c 20 61 0a 2a 2a 20 70 72 6f 63 65 73 73  ad, a.** process
2050: 20 74 68 61 74 20 72 65 71 75 65 73 74 73 20 61   that requests a
2060: 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b  n EXCLUSIVE lock
2070: 20 6d 61 79 20 61 63 74 75 61 6c 6c 79 20 6f 62   may actually ob
2080: 74 61 69 6e 20 61 20 50 45 4e 44 49 4e 47 0a 2a  tain a PENDING.*
2090: 2a 20 6c 6f 63 6b 2e 20 54 68 69 73 20 63 61 6e  * lock. This can
20a0: 20 62 65 20 75 70 67 72 61 64 65 64 20 74 6f 20   be upgraded to 
20b0: 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63  an EXCLUSIVE loc
20c0: 6b 20 62 79 20 61 20 73 75 62 73 65 71 75 65 6e  k by a subsequen
20d0: 74 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c  t call to.** sql
20e0: 69 74 65 33 4f 73 4c 6f 63 6b 28 29 2e 0a 2a 2f  ite3OsLock()..*/
20f0: 0a 23 64 65 66 69 6e 65 20 4e 4f 5f 4c 4f 43 4b  .#define NO_LOCK
2100: 20 20 20 20 20 20 20 20 20 30 0a 23 64 65 66 69           0.#defi
2110: 6e 65 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 20  ne SHARED_LOCK  
2120: 20 20 20 31 0a 23 64 65 66 69 6e 65 20 52 45 53     1.#define RES
2130: 45 52 56 45 44 5f 4c 4f 43 4b 20 20 20 32 0a 23  ERVED_LOCK   2.#
2140: 64 65 66 69 6e 65 20 50 45 4e 44 49 4e 47 5f 4c  define PENDING_L
2150: 4f 43 4b 20 20 20 20 33 0a 23 64 65 66 69 6e 65  OCK    3.#define
2160: 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20   EXCLUSIVE_LOCK 
2170: 20 34 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 65 20 4c   4../*.** File L
2180: 6f 63 6b 69 6e 67 20 4e 6f 74 65 73 3a 20 20 28  ocking Notes:  (
2190: 4d 6f 73 74 6c 79 20 61 62 6f 75 74 20 77 69 6e  Mostly about win
21a0: 64 6f 77 73 20 62 75 74 20 61 6c 73 6f 20 73 6f  dows but also so
21b0: 6d 65 20 69 6e 66 6f 20 66 6f 72 20 55 6e 69 78  me info for Unix
21c0: 29 0a 2a 2a 0a 2a 2a 20 57 65 20 63 61 6e 6e 6f  ).**.** We canno
21d0: 74 20 75 73 65 20 4c 6f 63 6b 46 69 6c 65 45 78  t use LockFileEx
21e0: 28 29 20 6f 72 20 55 6e 6c 6f 63 6b 46 69 6c 65  () or UnlockFile
21f0: 45 78 28 29 20 6f 6e 20 57 69 6e 39 35 2f 39 38  Ex() on Win95/98
2200: 2f 4d 45 20 62 65 63 61 75 73 65 0a 2a 2a 20 74  /ME because.** t
2210: 68 6f 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 61  hose functions a
2220: 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65  re not available
2230: 2e 20 20 53 6f 20 77 65 20 75 73 65 20 6f 6e 6c  .  So we use onl
2240: 79 20 4c 6f 63 6b 46 69 6c 65 28 29 20 61 6e 64  y LockFile() and
2250: 0a 2a 2a 20 55 6e 6c 6f 63 6b 46 69 6c 65 28 29  .** UnlockFile()
2260: 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63 6b 46 69 6c 65  ..**.** LockFile
2270: 28 29 20 70 72 65 76 65 6e 74 73 20 6e 6f 74 20  () prevents not 
2280: 6a 75 73 74 20 77 72 69 74 69 6e 67 20 62 75 74  just writing but
2290: 20 61 6c 73 6f 20 72 65 61 64 69 6e 67 20 62 79   also reading by
22a0: 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73   other processes
22b0: 2e 0a 2a 2a 20 41 20 53 48 41 52 45 44 5f 4c 4f  ..** A SHARED_LO
22c0: 43 4b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 62  CK is obtained b
22d0: 79 20 6c 6f 63 6b 69 6e 67 20 61 20 73 69 6e 67  y locking a sing
22e0: 6c 65 20 72 61 6e 64 6f 6d 6c 79 2d 63 68 6f 73  le randomly-chos
22f0: 65 6e 20 0a 2a 2a 20 62 79 74 65 20 6f 75 74 20  en .** byte out 
2300: 6f 66 20 61 20 73 70 65 63 69 66 69 63 20 72 61  of a specific ra
2310: 6e 67 65 20 6f 66 20 62 79 74 65 73 2e 20 54 68  nge of bytes. Th
2320: 65 20 6c 6f 63 6b 20 62 79 74 65 20 69 73 20 6f  e lock byte is o
2330: 62 74 61 69 6e 65 64 20 61 74 20 0a 2a 2a 20 72  btained at .** r
2340: 61 6e 64 6f 6d 20 73 6f 20 74 77 6f 20 73 65 70  andom so two sep
2350: 61 72 61 74 65 20 72 65 61 64 65 72 73 20 63 61  arate readers ca
2360: 6e 20 70 72 6f 62 61 62 6c 79 20 61 63 63 65 73  n probably acces
2370: 73 20 74 68 65 20 66 69 6c 65 20 61 74 20 74 68  s the file at th
2380: 65 20 0a 2a 2a 20 73 61 6d 65 20 74 69 6d 65 2c  e .** same time,
2390: 20 75 6e 6c 65 73 73 20 74 68 65 79 20 61 72 65   unless they are
23a0: 20 75 6e 6c 75 63 6b 79 20 61 6e 64 20 63 68 6f   unlucky and cho
23b0: 6f 73 65 20 74 68 65 20 73 61 6d 65 20 6c 6f 63  ose the same loc
23c0: 6b 20 62 79 74 65 2e 0a 2a 2a 20 41 6e 20 45 58  k byte..** An EX
23d0: 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 69 73 20  CLUSIVE_LOCK is 
23e0: 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63 6b  obtained by lock
23f0: 69 6e 67 20 61 6c 6c 20 62 79 74 65 73 20 69 6e  ing all bytes in
2400: 20 74 68 65 20 72 61 6e 67 65 2e 0a 2a 2a 20 54   the range..** T
2410: 68 65 72 65 20 63 61 6e 20 6f 6e 6c 79 20 62 65  here can only be
2420: 20 6f 6e 65 20 77 72 69 74 65 72 2e 20 20 41 20   one writer.  A 
2430: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 69 73  RESERVED_LOCK is
2440: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63   obtained by loc
2450: 6b 69 6e 67 0a 2a 2a 20 61 20 73 69 6e 67 6c 65  king.** a single
2460: 20 62 79 74 65 20 6f 66 20 74 68 65 20 66 69 6c   byte of the fil
2470: 65 20 74 68 61 74 20 69 73 20 64 65 73 69 67 6e  e that is design
2480: 61 74 65 64 20 61 73 20 74 68 65 20 72 65 73 65  ated as the rese
2490: 72 76 65 64 20 6c 6f 63 6b 20 62 79 74 65 2e 0a  rved lock byte..
24a0: 2a 2a 20 41 20 50 45 4e 44 49 4e 47 5f 4c 4f 43  ** A PENDING_LOC
24b0: 4b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 62 79  K is obtained by
24c0: 20 6c 6f 63 6b 69 6e 67 20 61 20 64 65 73 69 67   locking a desig
24d0: 6e 61 74 65 64 20 62 79 74 65 20 64 69 66 66 65  nated byte diffe
24e0: 72 65 6e 74 20 66 72 6f 6d 0a 2a 2a 20 74 68 65  rent from.** the
24f0: 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 62   RESERVED_LOCK b
2500: 79 74 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 57 69  yte..**.** On Wi
2510: 6e 4e 54 2f 32 4b 2f 58 50 20 73 79 73 74 65 6d  nNT/2K/XP system
2520: 73 2c 20 4c 6f 63 6b 46 69 6c 65 45 78 28 29 20  s, LockFileEx() 
2530: 61 6e 64 20 55 6e 6c 6f 63 6b 46 69 6c 65 45 78  and UnlockFileEx
2540: 28 29 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65  () are available
2550: 2c 0a 2a 2a 20 77 68 69 63 68 20 6d 65 61 6e 73  ,.** which means
2560: 20 77 65 20 63 61 6e 20 75 73 65 20 72 65 61 64   we can use read
2570: 65 72 2f 77 72 69 74 65 72 20 6c 6f 63 6b 73 2e  er/writer locks.
2580: 20 20 57 68 65 6e 20 72 65 61 64 65 72 2f 77 72    When reader/wr
2590: 69 74 65 72 20 6c 6f 63 6b 73 0a 2a 2a 20 61 72  iter locks.** ar
25a0: 65 20 75 73 65 64 2c 20 74 68 65 20 6c 6f 63 6b  e used, the lock
25b0: 20 69 73 20 70 6c 61 63 65 64 20 6f 6e 20 74 68   is placed on th
25c0: 65 20 73 61 6d 65 20 72 61 6e 67 65 20 6f 66 20  e same range of 
25d0: 62 79 74 65 73 20 74 68 61 74 20 69 73 20 75 73  bytes that is us
25e0: 65 64 0a 2a 2a 20 66 6f 72 20 70 72 6f 62 61 62  ed.** for probab
25f0: 69 6c 69 73 74 69 63 20 6c 6f 63 6b 69 6e 67 20  ilistic locking 
2600: 69 6e 20 57 69 6e 39 35 2f 39 38 2f 4d 45 2e 20  in Win95/98/ME. 
2610: 20 48 65 6e 63 65 2c 20 74 68 65 20 6c 6f 63 6b   Hence, the lock
2620: 69 6e 67 20 73 63 68 65 6d 65 0a 2a 2a 20 77 69  ing scheme.** wi
2630: 6c 6c 20 73 75 70 70 6f 72 74 20 74 77 6f 20 6f  ll support two o
2640: 72 20 6d 6f 72 65 20 57 69 6e 39 35 20 72 65 61  r more Win95 rea
2650: 64 65 72 73 20 6f 72 20 74 77 6f 20 6f 72 20 6d  ders or two or m
2660: 6f 72 65 20 57 69 6e 4e 54 20 72 65 61 64 65 72  ore WinNT reader
2670: 73 2e 0a 2a 2a 20 42 75 74 20 61 20 73 69 6e 67  s..** But a sing
2680: 6c 65 20 57 69 6e 39 35 20 72 65 61 64 65 72 20  le Win95 reader 
2690: 77 69 6c 6c 20 6c 6f 63 6b 20 6f 75 74 20 61 6c  will lock out al
26a0: 6c 20 57 69 6e 4e 54 20 72 65 61 64 65 72 73 20  l WinNT readers 
26b0: 61 6e 64 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20  and a single.** 
26c0: 57 69 6e 4e 54 20 72 65 61 64 65 72 20 77 69 6c  WinNT reader wil
26d0: 6c 20 6c 6f 63 6b 20 6f 75 74 20 61 6c 6c 20 6f  l lock out all o
26e0: 74 68 65 72 20 57 69 6e 39 35 20 72 65 61 64 65  ther Win95 reade
26f0: 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f  rs..**.** The fo
2700: 6c 6c 6f 77 69 6e 67 20 23 64 65 66 69 6e 65 73  llowing #defines
2710: 20 73 70 65 63 69 66 79 20 74 68 65 20 72 61 6e   specify the ran
2720: 67 65 20 6f 66 20 62 79 74 65 73 20 75 73 65 64  ge of bytes used
2730: 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2a   for locking..**
2740: 20 53 48 41 52 45 44 5f 53 49 5a 45 20 69 73 20   SHARED_SIZE is 
2750: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
2760: 74 65 73 20 61 76 61 69 6c 61 62 6c 65 20 69 6e  tes available in
2770: 20 74 68 65 20 70 6f 6f 6c 20 66 72 6f 6d 20 77   the pool from w
2780: 68 69 63 68 0a 2a 2a 20 61 20 72 61 6e 64 6f 6d  hich.** a random
2790: 20 62 79 74 65 20 69 73 20 73 65 6c 65 63 74 65   byte is selecte
27a0: 64 20 66 6f 72 20 61 20 73 68 61 72 65 64 20 6c  d for a shared l
27b0: 6f 63 6b 2e 20 20 54 68 65 20 70 6f 6f 6c 20 6f  ock.  The pool o
27c0: 66 20 62 79 74 65 73 20 66 6f 72 0a 2a 2a 20 73  f bytes for.** s
27d0: 68 61 72 65 64 20 6c 6f 63 6b 73 20 62 65 67 69  hared locks begi
27e0: 6e 73 20 61 74 20 53 48 41 52 45 44 5f 46 49 52  ns at SHARED_FIR
27f0: 53 54 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65  ST. .**.** These
2800: 20 23 64 65 66 69 6e 65 73 20 61 72 65 20 61 76   #defines are av
2810: 61 69 6c 61 62 6c 65 20 69 6e 20 73 71 6c 69 74  ailable in sqlit
2820: 65 5f 61 75 78 2e 68 20 73 6f 20 74 68 61 74 20  e_aux.h so that 
2830: 61 64 61 70 74 6f 72 73 20 66 6f 72 0a 2a 2a 20  adaptors for.** 
2840: 63 6f 6e 6e 65 63 74 69 6e 67 20 53 51 4c 69 74  connecting SQLit
2850: 65 20 74 6f 20 6f 74 68 65 72 20 6f 70 65 72 61  e to other opera
2860: 74 69 6e 67 20 73 79 73 74 65 6d 73 20 63 61 6e  ting systems can
2870: 20 75 73 65 20 74 68 65 20 73 61 6d 65 20 62 79   use the same by
2880: 74 65 0a 2a 2a 20 72 61 6e 67 65 73 20 66 6f 72  te.** ranges for
2890: 20 6c 6f 63 6b 69 6e 67 2e 20 20 49 6e 20 70 61   locking.  In pa
28a0: 72 74 69 63 75 6c 61 72 2c 20 74 68 65 20 73 61  rticular, the sa
28b0: 6d 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74  me locking strat
28c0: 65 67 79 20 61 6e 64 0a 2a 2a 20 62 79 74 65 20  egy and.** byte 
28d0: 72 61 6e 67 65 73 20 61 72 65 20 75 73 65 64 20  ranges are used 
28e0: 66 6f 72 20 55 6e 69 78 2e 20 20 54 68 69 73 20  for Unix.  This 
28f0: 6c 65 61 76 65 73 20 6f 70 65 6e 20 74 68 65 20  leaves open the 
2900: 70 6f 73 73 69 62 6c 69 74 79 20 6f 66 20 68 61  possiblity of ha
2910: 76 69 6e 67 0a 2a 2a 20 63 6c 69 65 6e 74 73 20  ving.** clients 
2920: 6f 6e 20 77 69 6e 39 35 2c 20 77 69 6e 4e 54 2c  on win95, winNT,
2930: 20 61 6e 64 20 75 6e 69 78 20 61 6c 6c 20 74 61   and unix all ta
2940: 6c 6b 69 6e 67 20 74 6f 20 74 68 65 20 73 61 6d  lking to the sam
2950: 65 20 73 68 61 72 65 64 20 66 69 6c 65 0a 2a 2a  e shared file.**
2960: 20 61 6e 64 20 61 6c 6c 20 6c 6f 63 6b 69 6e 67   and all locking
2970: 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 54 6f 20   correctly.  To 
2980: 64 6f 20 73 6f 20 77 6f 75 6c 64 20 72 65 71 75  do so would requ
2990: 69 72 65 20 74 68 61 74 20 73 61 6d 62 61 20 28  ire that samba (
29a0: 6f 72 20 77 68 61 74 65 76 65 72 0a 2a 2a 20 74  or whatever.** t
29b0: 6f 6f 6c 20 69 73 20 62 65 69 6e 67 20 75 73 65  ool is being use
29c0: 64 20 66 6f 72 20 66 69 6c 65 20 73 68 61 72 69  d for file shari
29d0: 6e 67 29 20 69 6d 70 6c 65 6d 65 6e 74 73 20 6c  ng) implements l
29e0: 6f 63 6b 73 20 63 6f 72 72 65 63 74 6c 79 20 62  ocks correctly b
29f0: 65 74 77 65 65 6e 0a 2a 2a 20 77 69 6e 64 6f 77  etween.** window
2a00: 73 20 61 6e 64 20 75 6e 69 78 2e 20 20 49 27 6d  s and unix.  I'm
2a10: 20 67 75 65 73 73 69 6e 67 20 74 68 61 74 20 69   guessing that i
2a20: 73 6e 27 74 20 6c 69 6b 65 6c 79 20 74 6f 20 68  sn't likely to h
2a30: 61 70 70 65 6e 2c 20 62 75 74 20 62 79 0a 2a 2a  appen, but by.**
2a40: 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20   using the same 
2a50: 6c 6f 63 6b 69 6e 67 20 72 61 6e 67 65 20 77 65  locking range we
2a60: 20 61 72 65 20 61 74 20 6c 65 61 73 74 20 6f 70   are at least op
2a70: 65 6e 20 74 6f 20 74 68 65 20 70 6f 73 73 69 62  en to the possib
2a80: 69 6c 69 74 79 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63  ility..**.** Loc
2a90: 6b 69 6e 67 20 69 6e 20 77 69 6e 64 6f 77 73 20  king in windows 
2aa0: 69 73 20 6d 61 6e 64 69 74 6f 72 79 2e 20 20 46  is manditory.  F
2ab0: 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c 20  or this reason, 
2ac0: 77 65 20 63 61 6e 6e 6f 74 20 73 74 6f 72 65 0a  we cannot store.
2ad0: 2a 2a 20 61 63 74 75 61 6c 20 64 61 74 61 20 69  ** actual data i
2ae0: 6e 20 74 68 65 20 62 79 74 65 73 20 75 73 65 64  n the bytes used
2af0: 20 66 6f 72 20 6c 6f 63 6b 69 6e 67 2e 20 20 54   for locking.  T
2b00: 68 65 20 70 61 67 65 72 20 6e 65 76 65 72 20 61  he pager never a
2b10: 6c 6c 6f 63 61 74 65 73 0a 2a 2a 20 74 68 65 20  llocates.** the 
2b20: 70 61 67 65 73 20 69 6e 76 6f 6c 76 65 64 20 69  pages involved i
2b30: 6e 20 6c 6f 63 6b 69 6e 67 20 74 68 65 72 65 66  n locking theref
2b40: 6f 72 65 2e 20 20 53 48 41 52 45 44 5f 53 49 5a  ore.  SHARED_SIZ
2b50: 45 20 69 73 20 73 65 6c 65 63 74 65 64 20 73 6f  E is selected so
2b60: 0a 2a 2a 20 74 68 61 74 20 61 6c 6c 20 6c 6f 63  .** that all loc
2b70: 6b 73 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 61  ks will fit on a
2b80: 20 73 69 6e 67 6c 65 20 70 61 67 65 20 65 76 65   single page eve
2b90: 6e 20 61 74 20 74 68 65 20 6d 69 6e 69 6d 75 6d  n at the minimum
2ba0: 20 70 61 67 65 20 73 69 7a 65 2e 0a 2a 2a 20 50   page size..** P
2bb0: 45 4e 44 49 4e 47 5f 42 59 54 45 20 64 65 66 69  ENDING_BYTE defi
2bc0: 6e 65 73 20 74 68 65 20 62 65 67 69 6e 6e 69 6e  nes the beginnin
2bd0: 67 20 6f 66 20 74 68 65 20 6c 6f 63 6b 73 2e 20  g of the locks. 
2be0: 20 42 79 20 64 65 66 61 75 6c 74 20 50 45 4e 44   By default PEND
2bf0: 49 4e 47 5f 42 59 54 45 0a 2a 2a 20 69 73 20 73  ING_BYTE.** is s
2c00: 65 74 20 68 69 67 68 20 73 6f 20 74 68 61 74 20  et high so that 
2c10: 77 65 20 64 6f 6e 27 74 20 68 61 76 65 20 74 6f  we don't have to
2c20: 20 61 6c 6c 6f 63 61 74 65 20 61 6e 20 75 6e 75   allocate an unu
2c30: 73 65 64 20 70 61 67 65 20 65 78 63 65 70 74 0a  sed page except.
2c40: 2a 2a 20 66 6f 72 20 76 65 72 79 20 6c 61 72 67  ** for very larg
2c50: 65 20 64 61 74 61 62 61 73 65 73 2e 20 20 42 75  e databases.  Bu
2c60: 74 20 6f 6e 65 20 73 68 6f 75 6c 64 20 74 65 73  t one should tes
2c70: 74 20 74 68 65 20 70 61 67 65 20 73 6b 69 70 70  t the page skipp
2c80: 69 6e 67 20 6c 6f 67 69 63 20 0a 2a 2a 20 62 79  ing logic .** by
2c90: 20 73 65 74 74 69 6e 67 20 50 45 4e 44 49 4e 47   setting PENDING
2ca0: 5f 42 59 54 45 20 6c 6f 77 20 61 6e 64 20 72 75  _BYTE low and ru
2cb0: 6e 6e 69 6e 67 20 74 68 65 20 65 6e 74 69 72 65  nning the entire
2cc0: 20 72 65 67 72 65 73 73 69 6f 6e 20 73 75 69 74   regression suit
2cd0: 65 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e  e..**.** Changin
2ce0: 67 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 50  g the value of P
2cf0: 45 4e 44 49 4e 47 5f 42 59 54 45 20 72 65 73 75  ENDING_BYTE resu
2d00: 6c 74 73 20 69 6e 20 61 20 73 75 62 74 6c 79 20  lts in a subtly 
2d10: 69 6e 63 6f 6d 70 61 74 69 62 6c 65 0a 2a 2a 20  incompatible.** 
2d20: 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 20 44 65  file format.  De
2d30: 70 65 6e 64 69 6e 67 20 6f 6e 20 68 6f 77 20 69  pending on how i
2d40: 74 20 69 73 20 63 68 61 6e 67 65 64 2c 20 79 6f  t is changed, yo
2d50: 75 20 6d 69 67 68 74 20 6e 6f 74 20 6e 6f 74 69  u might not noti
2d60: 63 65 0a 2a 2a 20 74 68 65 20 69 6e 63 6f 6d 70  ce.** the incomp
2d70: 61 74 69 62 69 6c 69 74 79 20 72 69 67 68 74 20  atibility right 
2d80: 61 77 61 79 2c 20 65 76 65 6e 20 72 75 6e 6e 69  away, even runni
2d90: 6e 67 20 61 20 66 75 6c 6c 20 72 65 67 72 65 73  ng a full regres
2da0: 73 69 6f 6e 20 74 65 73 74 2e 0a 2a 2a 20 54 68  sion test..** Th
2db0: 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 61 74 69  e default locati
2dc0: 6f 6e 20 6f 66 20 50 45 4e 44 49 4e 47 5f 42 59  on of PENDING_BY
2dd0: 54 45 20 69 73 20 74 68 65 20 66 69 72 73 74 20  TE is the first 
2de0: 62 79 74 65 20 70 61 73 74 20 74 68 65 0a 2a 2a  byte past the.**
2df0: 20 31 47 42 20 62 6f 75 6e 64 61 72 79 2e 0a 2a   1GB boundary..*
2e00: 2a 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c  *.*/.#ifndef SQL
2e10: 49 54 45 5f 54 45 53 54 0a 23 64 65 66 69 6e 65  ITE_TEST.#define
2e20: 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 20 20   PENDING_BYTE   
2e30: 20 20 20 30 78 34 30 30 30 30 30 30 30 20 20 2f     0x40000000  /
2e40: 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 61 73  * First byte pas
2e50: 74 20 74 68 65 20 31 47 42 20 62 6f 75 6e 64 61  t the 1GB bounda
2e60: 72 79 20 2a 2f 0a 23 65 6c 73 65 0a 65 78 74 65  ry */.#else.exte
2e70: 72 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  rn unsigned int 
2e80: 73 71 6c 69 74 65 33 5f 70 65 6e 64 69 6e 67 5f  sqlite3_pending_
2e90: 62 79 74 65 3b 0a 23 64 65 66 69 6e 65 20 50 45  byte;.#define PE
2ea0: 4e 44 49 4e 47 5f 42 59 54 45 20 73 71 6c 69 74  NDING_BYTE sqlit
2eb0: 65 33 5f 70 65 6e 64 69 6e 67 5f 62 79 74 65 0a  e3_pending_byte.
2ec0: 23 65 6e 64 69 66 0a 0a 23 64 65 66 69 6e 65 20  #endif..#define 
2ed0: 52 45 53 45 52 56 45 44 5f 42 59 54 45 20 20 20  RESERVED_BYTE   
2ee0: 20 20 28 50 45 4e 44 49 4e 47 5f 42 59 54 45 2b    (PENDING_BYTE+
2ef0: 31 29 0a 23 64 65 66 69 6e 65 20 53 48 41 52 45  1).#define SHARE
2f00: 44 5f 46 49 52 53 54 20 20 20 20 20 20 28 50 45  D_FIRST      (PE
2f10: 4e 44 49 4e 47 5f 42 59 54 45 2b 32 29 0a 23 64  NDING_BYTE+2).#d
2f20: 65 66 69 6e 65 20 53 48 41 52 45 44 5f 53 49 5a  efine SHARED_SIZ
2f30: 45 20 20 20 20 20 20 20 35 31 30 0a 0a 2f 2a 0a  E       510../*.
2f40: 2a 2a 20 50 72 6f 74 6f 74 79 70 65 73 20 66 6f  ** Prototypes fo
2f50: 72 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  r operating syst
2f60: 65 6d 20 69 6e 74 65 72 66 61 63 65 20 72 6f 75  em interface rou
2f70: 74 69 6e 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  tines..*/.int sq
2f80: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 4f 73 46  lite3OsClose(OsF
2f90: 69 6c 65 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  ile**);.int sqli
2fa0: 74 65 33 4f 73 4f 70 65 6e 44 69 72 65 63 74 6f  te3OsOpenDirecto
2fb0: 72 79 28 4f 73 46 69 6c 65 2a 2c 20 63 6f 6e 73  ry(OsFile*, cons
2fc0: 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71  t char*);.int sq
2fd0: 6c 69 74 65 33 4f 73 52 65 61 64 28 4f 73 46 69  lite3OsRead(OsFi
2fe0: 6c 65 2a 2c 20 76 6f 69 64 2a 2c 20 69 6e 74 20  le*, void*, int 
2ff0: 61 6d 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  amt);.int sqlite
3000: 33 4f 73 57 72 69 74 65 28 4f 73 46 69 6c 65 2a  3OsWrite(OsFile*
3010: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 69  , const void*, i
3020: 6e 74 20 61 6d 74 29 3b 0a 69 6e 74 20 73 71 6c  nt amt);.int sql
3030: 69 74 65 33 4f 73 53 65 65 6b 28 4f 73 46 69 6c  ite3OsSeek(OsFil
3040: 65 2a 2c 20 69 36 34 20 6f 66 66 73 65 74 29 3b  e*, i64 offset);
3050: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 54 72  .int sqlite3OsTr
3060: 75 6e 63 61 74 65 28 4f 73 46 69 6c 65 2a 2c 20  uncate(OsFile*, 
3070: 69 36 34 20 73 69 7a 65 29 3b 0a 69 6e 74 20 73  i64 size);.int s
3080: 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 4f 73 46  qlite3OsSync(OsF
3090: 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64  ile*, int);.void
30a0: 20 73 71 6c 69 74 65 33 4f 73 53 65 74 46 75 6c   sqlite3OsSetFul
30b0: 6c 53 79 6e 63 28 4f 73 46 69 6c 65 20 2a 69 64  lSync(OsFile *id
30c0: 2c 20 69 6e 74 20 73 65 74 74 69 6e 67 29 3b 0a  , int setting);.
30d0: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 46 69 6c  int sqlite3OsFil
30e0: 65 48 61 6e 64 6c 65 28 4f 73 46 69 6c 65 20 2a  eHandle(OsFile *
30f0: 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  id);.int sqlite3
3100: 4f 73 46 69 6c 65 53 69 7a 65 28 4f 73 46 69 6c  OsFileSize(OsFil
3110: 65 2a 2c 20 69 36 34 20 2a 70 53 69 7a 65 29 3b  e*, i64 *pSize);
3120: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 4c 6f  .int sqlite3OsLo
3130: 63 6b 28 4f 73 46 69 6c 65 2a 2c 20 69 6e 74 29  ck(OsFile*, int)
3140: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 55  ;.int sqlite3OsU
3150: 6e 6c 6f 63 6b 28 4f 73 46 69 6c 65 2a 2c 20 69  nlock(OsFile*, i
3160: 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  nt);.int sqlite3
3170: 4f 73 4c 6f 63 6b 53 74 61 74 65 28 4f 73 46 69  OsLockState(OsFi
3180: 6c 65 20 2a 69 64 29 3b 0a 69 6e 74 20 73 71 6c  le *id);.int sql
3190: 69 74 65 33 4f 73 43 68 65 63 6b 52 65 73 65 72  ite3OsCheckReser
31a0: 76 65 64 4c 6f 63 6b 28 4f 73 46 69 6c 65 20 2a  vedLock(OsFile *
31b0: 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  id);.int sqlite3
31c0: 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65 28  OsOpenReadWrite(
31d0: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73 46  const char*, OsF
31e0: 69 6c 65 2a 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e  ile**, int*);.in
31f0: 74 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45  t sqlite3OsOpenE
3200: 78 63 6c 75 73 69 76 65 28 63 6f 6e 73 74 20 63  xclusive(const c
3210: 68 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2a 2c 20  har*, OsFile**, 
3220: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  int);.int sqlite
3230: 33 4f 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 28  3OsOpenReadOnly(
3240: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73 46  const char*, OsF
3250: 69 6c 65 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  ile**);.int sqli
3260: 74 65 33 4f 73 44 65 6c 65 74 65 28 63 6f 6e 73  te3OsDelete(cons
3270: 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71  t char*);.int sq
3280: 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74  lite3OsFileExist
3290: 73 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a  s(const char*);.
32a0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4f 73 46  char *sqlite3OsF
32b0: 75 6c 6c 50 61 74 68 6e 61 6d 65 28 63 6f 6e 73  ullPathname(cons
32c0: 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71  t char*);.int sq
32d0: 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72 69 74  lite3OsIsDirWrit
32e0: 61 62 6c 65 28 63 68 61 72 2a 29 3b 0a 69 6e 74  able(char*);.int
32f0: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69   sqlite3OsSyncDi
3300: 72 65 63 74 6f 72 79 28 63 6f 6e 73 74 20 63 68  rectory(const ch
3310: 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  ar*);.int sqlite
3320: 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65 28  3OsTempFileName(
3330: 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  char*);.int sqli
3340: 74 65 33 4f 73 52 61 6e 64 6f 6d 53 65 65 64 28  te3OsRandomSeed(
3350: 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  char*);.int sqli
3360: 74 65 33 4f 73 53 6c 65 65 70 28 69 6e 74 20 6d  te3OsSleep(int m
3370: 73 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f  s);.int sqlite3O
3380: 73 43 75 72 72 65 6e 74 54 69 6d 65 28 64 6f 75  sCurrentTime(dou
3390: 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69  ble*);.void sqli
33a0: 74 65 33 4f 73 45 6e 74 65 72 4d 75 74 65 78 28  te3OsEnterMutex(
33b0: 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69  void);.void sqli
33c0: 74 65 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 28  te3OsLeaveMutex(
33d0: 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74  void);.int sqlit
33e0: 65 33 4f 73 49 6e 4d 75 74 65 78 28 69 6e 74 29  e3OsInMutex(int)
33f0: 3b 0a 54 68 72 65 61 64 44 61 74 61 20 2a 73 71  ;.ThreadData *sq
3400: 6c 69 74 65 33 4f 73 54 68 72 65 61 64 53 70 65  lite3OsThreadSpe
3410: 63 69 66 69 63 44 61 74 61 28 69 6e 74 29 3b 0a  cificData(int);.
3420: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4f 73 4d  void *sqlite3OsM
3430: 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64  alloc(int);.void
3440: 20 2a 73 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c   *sqlite3OsReall
3450: 6f 63 28 76 6f 69 64 20 2a 2c 20 69 6e 74 29 3b  oc(void *, int);
3460: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4f 73 46  .void sqlite3OsF
3470: 72 65 65 28 76 6f 69 64 20 2a 29 3b 0a 69 6e 74  ree(void *);.int
3480: 20 73 71 6c 69 74 65 33 4f 73 41 6c 6c 6f 63 61   sqlite3OsAlloca
3490: 74 69 6f 6e 53 69 7a 65 28 76 6f 69 64 20 2a 29  tionSize(void *)
34a0: 3b 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20  ;../*.** If the 
34b0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 52 45  SQLITE_ENABLE_RE
34c0: 44 45 46 5f 49 4f 20 6d 61 63 72 6f 20 69 73 20  DEF_IO macro is 
34d0: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
34e0: 65 20 4f 53 2d 6c 61 79 65 72 0a 2a 2a 20 69 6e  e OS-layer.** in
34f0: 74 65 72 66 61 63 65 20 72 6f 75 74 69 6e 65 73  terface routines
3500: 20 61 72 65 20 6e 6f 74 20 63 61 6c 6c 65 64 20   are not called 
3510: 64 69 72 65 63 74 6c 79 20 62 75 74 20 61 72 65  directly but are
3520: 20 69 6e 76 6f 6b 65 64 20 75 73 69 6e 67 0a 2a   invoked using.*
3530: 2a 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 66 75  * pointers to fu
3540: 6e 63 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 61  nctions.  This a
3550: 6c 6c 6f 77 73 20 74 68 65 20 69 6d 70 6c 65 6d  llows the implem
3560: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 76 61 72 69  entation of vari
3570: 6f 75 73 0a 2a 2a 20 4f 53 2d 6c 61 79 65 72 20  ous.** OS-layer 
3580: 69 6e 74 65 72 66 61 63 65 20 72 6f 75 74 69 6e  interface routin
3590: 65 73 20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65  es to be modifie
35a0: 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 20 20  d at run-time.  
35b0: 54 68 65 72 65 20 61 72 65 0a 2a 2a 20 6f 62 73  There are.** obs
35c0: 63 75 72 65 20 62 75 74 20 6c 65 67 69 74 69 6d  cure but legitim
35d0: 61 74 65 20 72 65 61 73 6f 6e 73 20 66 6f 72 20  ate reasons for 
35e0: 77 61 6e 74 69 6e 67 20 74 6f 20 64 6f 20 74 68  wanting to do th
35f0: 69 73 2e 20 20 42 75 74 20 66 6f 72 0a 2a 2a 20  is.  But for.** 
3600: 6d 6f 73 74 20 75 73 65 72 73 2c 20 61 20 64 69  most users, a di
3610: 72 65 63 74 20 63 61 6c 6c 20 74 6f 20 74 68 65  rect call to the
3620: 20 75 6e 64 65 72 6c 79 69 6e 67 20 69 6e 74 65   underlying inte
3630: 72 66 61 63 65 20 69 73 20 70 72 65 66 65 72 61  rface is prefera
3640: 62 6c 65 0a 2a 2a 20 73 6f 20 74 68 65 20 74 68  ble.** so the th
3650: 65 20 72 65 64 65 66 69 6e 61 62 6c 65 20 49 2f  e redefinable I/
3660: 4f 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74  O interface is t
3670: 75 72 6e 65 64 20 6f 66 66 20 62 79 20 64 65 66  urned off by def
3680: 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20  ault..*/.#ifdef 
3690: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 52 45  SQLITE_ENABLE_RE
36a0: 44 45 46 5f 49 4f 0a 0a 2f 2a 0a 2a 2a 20 57 68  DEF_IO../*.** Wh
36b0: 65 6e 20 72 65 64 65 66 69 6e 61 62 6c 65 20 49  en redefinable I
36c0: 2f 4f 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 61  /O is enabled, a
36d0: 20 73 69 6e 67 6c 65 20 67 6c 6f 62 61 6c 20 69   single global i
36e0: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 0a 2a  nstance of the.*
36f0: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75  * following stru
3700: 63 74 75 72 65 20 68 6f 6c 64 73 20 70 6f 69 6e  cture holds poin
3710: 74 65 72 73 20 74 6f 20 74 68 65 20 72 6f 75 74  ters to the rout
3720: 69 6e 65 73 20 74 68 61 74 20 53 51 4c 69 74 65  ines that SQLite
3730: 20 0a 2a 2a 20 75 73 65 73 20 74 6f 20 74 61 6c   .** uses to tal
3740: 6b 20 77 69 74 68 20 74 68 65 20 75 6e 64 65 72  k with the under
3750: 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67 20  lying operating 
3760: 73 79 73 74 65 6d 2e 20 20 4d 6f 64 69 66 79 20  system.  Modify 
3770: 74 68 69 73 0a 2a 2a 20 73 74 72 75 63 74 75 72  this.** structur
3780: 65 20 28 62 65 66 6f 72 65 20 75 73 69 6e 67 20  e (before using 
3790: 61 6e 79 20 53 51 4c 69 74 65 20 41 50 49 21 29  any SQLite API!)
37a0: 20 74 6f 20 61 63 63 6f 6d 6f 64 61 74 65 20 70   to accomodate p
37b0: 65 72 63 75 6c 69 61 72 0a 2a 2a 20 6f 70 65 72  erculiar.** oper
37c0: 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74  ating system int
37d0: 65 72 66 61 63 65 73 20 6f 72 20 62 65 68 61 76  erfaces or behav
37e0: 69 6f 72 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20  iors..*/.struct 
37f0: 73 71 6c 69 74 65 33 4f 73 56 74 62 6c 20 7b 0a  sqlite3OsVtbl {.
3800: 20 20 69 6e 74 20 28 2a 78 4f 70 65 6e 52 65 61    int (*xOpenRea
3810: 64 57 72 69 74 65 29 28 63 6f 6e 73 74 20 63 68  dWrite)(const ch
3820: 61 72 2a 2c 20 4f 73 46 69 6c 65 2a 2a 2c 20 69  ar*, OsFile**, i
3830: 6e 74 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78 4f  nt*);.  int (*xO
3840: 70 65 6e 45 78 63 6c 75 73 69 76 65 29 28 63 6f  penExclusive)(co
3850: 6e 73 74 20 63 68 61 72 2a 2c 20 4f 73 46 69 6c  nst char*, OsFil
3860: 65 2a 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 6e 74  e**, int);.  int
3870: 20 28 2a 78 4f 70 65 6e 52 65 61 64 4f 6e 6c 79   (*xOpenReadOnly
3880: 29 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 4f  )(const char*, O
3890: 73 46 69 6c 65 2a 2a 29 3b 0a 0a 20 20 69 6e 74  sFile**);..  int
38a0: 20 28 2a 78 44 65 6c 65 74 65 29 28 63 6f 6e 73   (*xDelete)(cons
38b0: 74 20 63 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20  t char*);.  int 
38c0: 28 2a 78 46 69 6c 65 45 78 69 73 74 73 29 28 63  (*xFileExists)(c
38d0: 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 63  onst char*);.  c
38e0: 68 61 72 20 2a 28 2a 78 46 75 6c 6c 50 61 74 68  har *(*xFullPath
38f0: 6e 61 6d 65 29 28 63 6f 6e 73 74 20 63 68 61 72  name)(const char
3900: 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78 49 73 44  *);.  int (*xIsD
3910: 69 72 57 72 69 74 61 62 6c 65 29 28 63 68 61 72  irWritable)(char
3920: 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78 53 79 6e  *);.  int (*xSyn
3930: 63 44 69 72 65 63 74 6f 72 79 29 28 63 6f 6e 73  cDirectory)(cons
3940: 74 20 63 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20  t char*);.  int 
3950: 28 2a 78 54 65 6d 70 46 69 6c 65 4e 61 6d 65 29  (*xTempFileName)
3960: 28 63 68 61 72 2a 29 3b 0a 0a 20 20 69 6e 74 20  (char*);..  int 
3970: 28 2a 78 52 61 6e 64 6f 6d 53 65 65 64 29 28 63  (*xRandomSeed)(c
3980: 68 61 72 2a 29 3b 0a 20 20 69 6e 74 20 28 2a 78  har*);.  int (*x
3990: 53 6c 65 65 70 29 28 69 6e 74 20 6d 73 29 3b 0a  Sleep)(int ms);.
39a0: 20 20 69 6e 74 20 28 2a 78 43 75 72 72 65 6e 74    int (*xCurrent
39b0: 54 69 6d 65 29 28 64 6f 75 62 6c 65 2a 29 3b 0a  Time)(double*);.
39c0: 0a 20 20 76 6f 69 64 20 28 2a 78 45 6e 74 65 72  .  void (*xEnter
39d0: 4d 75 74 65 78 29 28 76 6f 69 64 29 3b 0a 20 20  Mutex)(void);.  
39e0: 76 6f 69 64 20 28 2a 78 4c 65 61 76 65 4d 75 74  void (*xLeaveMut
39f0: 65 78 29 28 76 6f 69 64 29 3b 0a 20 20 69 6e 74  ex)(void);.  int
3a00: 20 28 2a 78 49 6e 4d 75 74 65 78 29 28 69 6e 74   (*xInMutex)(int
3a10: 29 3b 0a 20 20 54 68 72 65 61 64 44 61 74 61 20  );.  ThreadData 
3a20: 2a 28 2a 78 54 68 72 65 61 64 53 70 65 63 69 66  *(*xThreadSpecif
3a30: 69 63 44 61 74 61 29 28 69 6e 74 29 3b 0a 0a 20  icData)(int);.. 
3a40: 20 76 6f 69 64 20 2a 28 2a 78 4d 61 6c 6c 6f 63   void *(*xMalloc
3a50: 29 28 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 2a  )(int);.  void *
3a60: 28 2a 78 52 65 61 6c 6c 6f 63 29 28 76 6f 69 64  (*xRealloc)(void
3a70: 20 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64   *, int);.  void
3a80: 20 28 2a 78 46 72 65 65 29 28 76 6f 69 64 20 2a   (*xFree)(void *
3a90: 29 3b 0a 20 20 69 6e 74 20 28 2a 78 41 6c 6c 6f  );.  int (*xAllo
3aa0: 63 61 74 69 6f 6e 53 69 7a 65 29 28 76 6f 69 64  cationSize)(void
3ab0: 20 2a 29 3b 0a 7d 3b 0a 0a 2f 2a 20 4d 61 63 72   *);.};../* Macr
3ac0: 6f 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 65 6e  o used to commen
3ad0: 74 20 6f 75 74 20 72 6f 75 74 69 6e 65 73 20 74  t out routines t
3ae0: 68 61 74 20 64 6f 20 6e 6f 74 20 65 78 69 73 74  hat do not exist
3af0: 73 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 0a  s when there is.
3b00: 2a 2a 20 6e 6f 20 64 69 73 6b 20 49 2f 4f 20 0a  ** no disk I/O .
3b10: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
3b20: 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 23 20 64  _OMIT_DISKIO.# d
3b30: 65 66 69 6e 65 20 49 46 5f 44 49 53 4b 49 4f 28  efine IF_DISKIO(
3b40: 58 29 20 20 30 0a 23 65 6c 73 65 0a 23 20 64 65  X)  0.#else.# de
3b50: 66 69 6e 65 20 49 46 5f 44 49 53 4b 49 4f 28 58  fine IF_DISKIO(X
3b60: 29 20 20 58 0a 23 65 6e 64 69 66 0a 0a 23 69 66  )  X.#endif..#if
3b70: 64 65 66 20 5f 53 51 4c 49 54 45 5f 4f 53 5f 43  def _SQLITE_OS_C
3b80: 5f 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20  _.  /*.  ** The 
3b90: 6f 73 2e 63 20 66 69 6c 65 20 69 6d 70 6c 65 6d  os.c file implem
3ba0: 65 6e 74 73 20 74 68 65 20 67 6c 6f 62 61 6c 20  ents the global 
3bb0: 76 69 72 74 75 61 6c 20 66 75 6e 63 74 69 6f 6e  virtual function
3bc0: 20 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 73   table..  */.  s
3bd0: 74 72 75 63 74 20 73 71 6c 69 74 65 33 4f 73 56  truct sqlite3OsV
3be0: 74 62 6c 20 73 71 6c 69 74 65 33 4f 73 20 3d 20  tbl sqlite3Os = 
3bf0: 7b 0a 20 20 20 20 49 46 5f 44 49 53 4b 49 4f 28  {.    IF_DISKIO(
3c00: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65   sqlite3OsOpenRe
3c10: 61 64 57 72 69 74 65 20 29 2c 0a 20 20 20 20 49  adWrite ),.    I
3c20: 46 5f 44 49 53 4b 49 4f 28 20 73 71 6c 69 74 65  F_DISKIO( sqlite
3c30: 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65  3OsOpenExclusive
3c40: 20 29 2c 0a 20 20 20 20 49 46 5f 44 49 53 4b 49   ),.    IF_DISKI
3c50: 4f 28 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e  O( sqlite3OsOpen
3c60: 52 65 61 64 4f 6e 6c 79 20 29 2c 0a 20 20 20 20  ReadOnly ),.    
3c70: 49 46 5f 44 49 53 4b 49 4f 28 20 73 71 6c 69 74  IF_DISKIO( sqlit
3c80: 65 33 4f 73 44 65 6c 65 74 65 20 29 2c 0a 20 20  e3OsDelete ),.  
3c90: 20 20 49 46 5f 44 49 53 4b 49 4f 28 20 73 71 6c    IF_DISKIO( sql
3ca0: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
3cb0: 20 29 2c 0a 20 20 20 20 49 46 5f 44 49 53 4b 49   ),.    IF_DISKI
3cc0: 4f 28 20 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c  O( sqlite3OsFull
3cd0: 50 61 74 68 6e 61 6d 65 20 29 2c 0a 20 20 20 20  Pathname ),.    
3ce0: 49 46 5f 44 49 53 4b 49 4f 28 20 73 71 6c 69 74  IF_DISKIO( sqlit
3cf0: 65 33 4f 73 49 73 44 69 72 57 72 69 74 61 62 6c  e3OsIsDirWritabl
3d00: 65 20 29 2c 0a 20 20 20 20 49 46 5f 44 49 53 4b  e ),.    IF_DISK
3d10: 49 4f 28 20 73 71 6c 69 74 65 33 4f 73 53 79 6e  IO( sqlite3OsSyn
3d20: 63 44 69 72 65 63 74 6f 72 79 20 29 2c 0a 20 20  cDirectory ),.  
3d30: 20 20 49 46 5f 44 49 53 4b 49 4f 28 20 73 71 6c    IF_DISKIO( sql
3d40: 69 74 65 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61  ite3OsTempFileNa
3d50: 6d 65 20 29 2c 0a 20 20 20 20 73 71 6c 69 74 65  me ),.    sqlite
3d60: 33 4f 73 52 61 6e 64 6f 6d 53 65 65 64 2c 0a 20  3OsRandomSeed,. 
3d70: 20 20 20 73 71 6c 69 74 65 33 4f 73 53 6c 65 65     sqlite3OsSlee
3d80: 70 2c 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73  p,.    sqlite3Os
3d90: 43 75 72 72 65 6e 74 54 69 6d 65 2c 0a 20 20 20  CurrentTime,.   
3da0: 20 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d   sqlite3OsEnterM
3db0: 75 74 65 78 2c 0a 20 20 20 20 73 71 6c 69 74 65  utex,.    sqlite
3dc0: 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 2c 0a 20  3OsLeaveMutex,. 
3dd0: 20 20 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d 75     sqlite3OsInMu
3de0: 74 65 78 2c 0a 20 20 20 20 73 71 6c 69 74 65 33  tex,.    sqlite3
3df0: 4f 73 54 68 72 65 61 64 53 70 65 63 69 66 69 63  OsThreadSpecific
3e00: 44 61 74 61 2c 0a 20 20 20 20 73 71 6c 69 74 65  Data,.    sqlite
3e10: 33 4f 73 4d 61 6c 6c 6f 63 2c 0a 20 20 20 20 73  3OsMalloc,.    s
3e20: 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c 6f 63 2c  qlite3OsRealloc,
3e30: 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 46 72  .    sqlite3OsFr
3e40: 65 65 2c 0a 20 20 20 20 73 71 6c 69 74 65 33 4f  ee,.    sqlite3O
3e50: 73 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a  sAllocationSize.
3e60: 20 20 7d 3b 0a 23 65 6c 73 65 0a 20 20 2f 2a 0a    };.#else.  /*.
3e70: 20 20 2a 2a 20 46 69 6c 65 73 20 6f 74 68 65 72    ** Files other
3e80: 20 74 68 61 6e 20 6f 73 2e 63 20 6a 75 73 74 20   than os.c just 
3e90: 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 67 6c  reference the gl
3ea0: 6f 62 61 6c 20 76 69 72 74 75 61 6c 20 66 75 6e  obal virtual fun
3eb0: 63 74 69 6f 6e 20 74 61 62 6c 65 2e 20 0a 20 20  ction table. .  
3ec0: 2a 2f 0a 20 20 65 78 74 65 72 6e 20 73 74 72 75  */.  extern stru
3ed0: 63 74 20 73 71 6c 69 74 65 33 4f 73 56 74 62 6c  ct sqlite3OsVtbl
3ee0: 20 73 71 6c 69 74 65 33 4f 73 3b 0a 23 65 6e 64   sqlite3Os;.#end
3ef0: 69 66 20 2f 2a 20 5f 53 51 4c 49 54 45 5f 4f 53  if /* _SQLITE_OS
3f00: 5f 43 5f 20 2a 2f 0a 0a 0a 2f 2a 20 54 68 69 73  _C_ */.../* This
3f10: 20 61 64 64 69 74 69 6f 6e 61 6c 20 41 50 49 20   additional API 
3f20: 72 6f 75 74 69 6e 65 20 69 73 20 61 76 61 69 6c  routine is avail
3f30: 61 62 6c 65 20 77 69 74 68 20 72 65 64 65 66 69  able with redefi
3f40: 6e 61 62 6c 65 20 49 2f 4f 20 2a 2f 0a 73 74 72  nable I/O */.str
3f50: 75 63 74 20 73 71 6c 69 74 65 33 4f 73 56 74 62  uct sqlite3OsVtb
3f60: 6c 20 2a 73 71 6c 69 74 65 33 5f 6f 73 5f 73 77  l *sqlite3_os_sw
3f70: 69 74 63 68 28 76 6f 69 64 29 3b 0a 0a 0a 2f 2a  itch(void);.../*
3f80: 0a 2a 2a 20 52 65 64 65 66 69 6e 65 20 74 68 65  .** Redefine the
3f90: 20 4f 53 20 69 6e 74 65 72 66 61 63 65 20 74 6f   OS interface to
3fa0: 20 67 6f 20 74 68 72 6f 75 67 68 20 74 68 65 20   go through the 
3fb0: 76 69 72 74 75 61 6c 20 66 75 6e 63 74 69 6f 6e  virtual function
3fc0: 20 74 61 62 6c 65 0a 2a 2a 20 72 61 74 68 65 72   table.** rather
3fd0: 20 74 68 61 6e 20 63 61 6c 6c 69 6e 67 20 72 6f   than calling ro
3fe0: 75 74 69 6e 65 73 20 64 69 72 65 63 74 6c 79 2e  utines directly.
3ff0: 0a 2a 2f 0a 23 75 6e 64 65 66 20 73 71 6c 69 74  .*/.#undef sqlit
4000: 65 33 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74  e3OsOpenReadWrit
4010: 65 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33  e.#undef sqlite3
4020: 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 0a  OsOpenExclusive.
4030: 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73  #undef sqlite3Os
4040: 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 0a 23 75 6e  OpenReadOnly.#un
4050: 64 65 66 20 73 71 6c 69 74 65 33 4f 73 44 65 6c  def sqlite3OsDel
4060: 65 74 65 0a 23 75 6e 64 65 66 20 73 71 6c 69 74  ete.#undef sqlit
4070: 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73 0a 23  e3OsFileExists.#
4080: 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73 46  undef sqlite3OsF
4090: 75 6c 6c 50 61 74 68 6e 61 6d 65 0a 23 75 6e 64  ullPathname.#und
40a0: 65 66 20 73 71 6c 69 74 65 33 4f 73 49 73 44 69  ef sqlite3OsIsDi
40b0: 72 57 72 69 74 61 62 6c 65 0a 23 75 6e 64 65 66  rWritable.#undef
40c0: 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69   sqlite3OsSyncDi
40d0: 72 65 63 74 6f 72 79 0a 23 75 6e 64 65 66 20 73  rectory.#undef s
40e0: 71 6c 69 74 65 33 4f 73 54 65 6d 70 46 69 6c 65  qlite3OsTempFile
40f0: 4e 61 6d 65 0a 23 75 6e 64 65 66 20 73 71 6c 69  Name.#undef sqli
4100: 74 65 33 4f 73 52 61 6e 64 6f 6d 53 65 65 64 0a  te3OsRandomSeed.
4110: 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73  #undef sqlite3Os
4120: 53 6c 65 65 70 0a 23 75 6e 64 65 66 20 73 71 6c  Sleep.#undef sql
4130: 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d  ite3OsCurrentTim
4140: 65 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33  e.#undef sqlite3
4150: 4f 73 45 6e 74 65 72 4d 75 74 65 78 0a 23 75 6e  OsEnterMutex.#un
4160: 64 65 66 20 73 71 6c 69 74 65 33 4f 73 4c 65 61  def sqlite3OsLea
4170: 76 65 4d 75 74 65 78 0a 23 75 6e 64 65 66 20 73  veMutex.#undef s
4180: 71 6c 69 74 65 33 4f 73 49 6e 4d 75 74 65 78 0a  qlite3OsInMutex.
4190: 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33 4f 73  #undef sqlite3Os
41a0: 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61  ThreadSpecificDa
41b0: 74 61 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65  ta.#undef sqlite
41c0: 33 4f 73 4d 61 6c 6c 6f 63 0a 23 75 6e 64 65 66  3OsMalloc.#undef
41d0: 20 73 71 6c 69 74 65 33 4f 73 52 65 61 6c 6c 6f   sqlite3OsReallo
41e0: 63 0a 23 75 6e 64 65 66 20 73 71 6c 69 74 65 33  c.#undef sqlite3
41f0: 4f 73 46 72 65 65 0a 23 75 6e 64 65 66 20 73 71  OsFree.#undef sq
4200: 6c 69 74 65 33 4f 73 41 6c 6c 6f 63 61 74 69 6f  lite3OsAllocatio
4210: 6e 53 69 7a 65 0a 23 64 65 66 69 6e 65 20 73 71  nSize.#define sq
4220: 6c 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57  lite3OsOpenReadW
4230: 72 69 74 65 20 20 20 20 20 20 73 71 6c 69 74 65  rite      sqlite
4240: 33 4f 73 2e 78 4f 70 65 6e 52 65 61 64 57 72 69  3Os.xOpenReadWri
4250: 74 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  te.#define sqlit
4260: 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76  e3OsOpenExclusiv
4270: 65 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73  e      sqlite3Os
4280: 2e 78 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 0a  .xOpenExclusive.
4290: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f  #define sqlite3O
42a0: 73 4f 70 65 6e 52 65 61 64 4f 6e 6c 79 20 20 20  sOpenReadOnly   
42b0: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 4f      sqlite3Os.xO
42c0: 70 65 6e 52 65 61 64 4f 6e 6c 79 0a 23 64 65 66  penReadOnly.#def
42d0: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 44 65 6c  ine sqlite3OsDel
42e0: 65 74 65 20 20 20 20 20 20 20 20 20 20 20 20 20  ete             
42f0: 73 71 6c 69 74 65 33 4f 73 2e 78 44 65 6c 65 74  sqlite3Os.xDelet
4300: 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  e.#define sqlite
4310: 33 4f 73 46 69 6c 65 45 78 69 73 74 73 20 20 20  3OsFileExists   
4320: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e        sqlite3Os.
4330: 78 46 69 6c 65 45 78 69 73 74 73 0a 23 64 65 66  xFileExists.#def
4340: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 46 75 6c  ine sqlite3OsFul
4350: 6c 50 61 74 68 6e 61 6d 65 20 20 20 20 20 20 20  lPathname       
4360: 73 71 6c 69 74 65 33 4f 73 2e 78 46 75 6c 6c 50  sqlite3Os.xFullP
4370: 61 74 68 6e 61 6d 65 0a 23 64 65 66 69 6e 65 20  athname.#define 
4380: 73 71 6c 69 74 65 33 4f 73 49 73 44 69 72 57 72  sqlite3OsIsDirWr
4390: 69 74 61 62 6c 65 20 20 20 20 20 20 73 71 6c 69  itable      sqli
43a0: 74 65 33 4f 73 2e 78 49 73 44 69 72 57 72 69 74  te3Os.xIsDirWrit
43b0: 61 62 6c 65 0a 23 64 65 66 69 6e 65 20 73 71 6c  able.#define sql
43c0: 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74  ite3OsSyncDirect
43d0: 6f 72 79 20 20 20 20 20 20 73 71 6c 69 74 65 33  ory      sqlite3
43e0: 4f 73 2e 78 53 79 6e 63 44 69 72 65 63 74 6f 72  Os.xSyncDirector
43f0: 79 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  y.#define sqlite
4400: 33 4f 73 54 65 6d 70 46 69 6c 65 4e 61 6d 65 20  3OsTempFileName 
4410: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e        sqlite3Os.
4420: 78 54 65 6d 70 46 69 6c 65 4e 61 6d 65 0a 23 64  xTempFileName.#d
4430: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 52  efine sqlite3OsR
4440: 61 6e 64 6f 6d 53 65 65 64 20 20 20 20 20 20 20  andomSeed       
4450: 20 20 73 71 6c 69 74 65 33 4f 73 2e 78 52 61 6e    sqlite3Os.xRan
4460: 64 6f 6d 53 65 65 64 0a 23 64 65 66 69 6e 65 20  domSeed.#define 
4470: 73 71 6c 69 74 65 33 4f 73 53 6c 65 65 70 20 20  sqlite3OsSleep  
4480: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
4490: 74 65 33 4f 73 2e 78 53 6c 65 65 70 0a 23 64 65  te3Os.xSleep.#de
44a0: 66 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 43 75  fine sqlite3OsCu
44b0: 72 72 65 6e 74 54 69 6d 65 20 20 20 20 20 20 20  rrentTime       
44c0: 20 73 71 6c 69 74 65 33 4f 73 2e 78 43 75 72 72   sqlite3Os.xCurr
44d0: 65 6e 74 54 69 6d 65 0a 23 64 65 66 69 6e 65 20  entTime.#define 
44e0: 73 71 6c 69 74 65 33 4f 73 45 6e 74 65 72 4d 75  sqlite3OsEnterMu
44f0: 74 65 78 20 20 20 20 20 20 20 20 20 73 71 6c 69  tex         sqli
4500: 74 65 33 4f 73 2e 78 45 6e 74 65 72 4d 75 74 65  te3Os.xEnterMute
4510: 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  x.#define sqlite
4520: 33 4f 73 4c 65 61 76 65 4d 75 74 65 78 20 20 20  3OsLeaveMutex   
4530: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e        sqlite3Os.
4540: 78 4c 65 61 76 65 4d 75 74 65 78 0a 23 64 65 66  xLeaveMutex.#def
4550: 69 6e 65 20 73 71 6c 69 74 65 33 4f 73 49 6e 4d  ine sqlite3OsInM
4560: 75 74 65 78 20 20 20 20 20 20 20 20 20 20 20 20  utex            
4570: 73 71 6c 69 74 65 33 4f 73 2e 78 49 6e 4d 75 74  sqlite3Os.xInMut
4580: 65 78 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74  ex.#define sqlit
4590: 65 33 4f 73 54 68 72 65 61 64 53 70 65 63 69 66  e3OsThreadSpecif
45a0: 69 63 44 61 74 61 20 73 71 6c 69 74 65 33 4f 73  icData sqlite3Os
45b0: 2e 78 54 68 72 65 61 64 53 70 65 63 69 66 69 63  .xThreadSpecific
45c0: 44 61 74 61 0a 23 64 65 66 69 6e 65 20 73 71 6c  Data.#define sql
45d0: 69 74 65 33 4f 73 4d 61 6c 6c 6f 63 20 20 20 20  ite3OsMalloc    
45e0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
45f0: 4f 73 2e 78 4d 61 6c 6c 6f 63 0a 23 64 65 66 69  Os.xMalloc.#defi
4600: 6e 65 20 73 71 6c 69 74 65 33 4f 73 52 65 61 6c  ne sqlite3OsReal
4610: 6c 6f 63 20 20 20 20 20 20 20 20 20 20 20 20 73  loc            s
4620: 71 6c 69 74 65 33 4f 73 2e 78 52 65 61 6c 6c 6f  qlite3Os.xReallo
4630: 63 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  c.#define sqlite
4640: 33 4f 73 46 72 65 65 20 20 20 20 20 20 20 20 20  3OsFree         
4650: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 2e        sqlite3Os.
4660: 78 46 72 65 65 0a 23 64 65 66 69 6e 65 20 73 71  xFree.#define sq
4670: 6c 69 74 65 33 4f 73 41 6c 6c 6f 63 61 74 69 6f  lite3OsAllocatio
4680: 6e 53 69 7a 65 20 20 20 20 20 73 71 6c 69 74 65  nSize     sqlite
4690: 33 4f 73 2e 78 41 6c 6c 6f 63 61 74 69 6f 6e 53  3Os.xAllocationS
46a0: 69 7a 65 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53  ize..#endif /* S
46b0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 52 45 44  QLITE_ENABLE_RED
46c0: 45 46 5f 49 4f 20 2a 2f 0a 0a 23 65 6e 64 69 66  EF_IO */..#endif
46d0: 20 2f 2a 20 5f 53 51 4c 49 54 45 5f 4f 53 5f 48   /* _SQLITE_OS_H
46e0: 5f 20 2a 2f 0a                                   _ */.