/ Hex Artifact Content
Login

Artifact ef8abeb9afc694b82dbd169a91c9b7e26db3c892:


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 2a 0a 2a  ws systems..**.*
0250: 2a 20 54 68 69 73 20 68 65 61 64 65 72 20 66 69  * This header fi
0260: 6c 65 20 69 73 20 23 69 6e 63 6c 75 64 65 2d 65  le is #include-e
0270: 64 20 62 79 20 73 71 6c 69 74 65 49 6e 74 2e 68  d by sqliteInt.h
0280: 20 61 6e 64 20 74 68 75 73 20 65 6e 64 73 20 75   and thus ends u
0290: 70 0a 2a 2a 20 62 65 69 6e 67 20 69 6e 63 6c 75  p.** being inclu
02a0: 64 65 64 20 62 79 20 65 76 65 72 79 20 73 6f 75  ded by every sou
02b0: 72 63 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20  rce file..**.** 
02c0: 24 49 64 3a 20 6f 73 2e 68 2c 76 20 31 2e 31 30  $Id: os.h,v 1.10
02d0: 35 20 32 30 30 38 2f 30 36 2f 32 36 20 31 30 3a  5 2008/06/26 10:
02e0: 34 31 3a 31 39 20 64 61 6e 69 65 6c 6b 31 39 37  41:19 danielk197
02f0: 37 20 45 78 70 20 24 0a 2a 2f 0a 23 69 66 6e 64  7 Exp $.*/.#ifnd
0300: 65 66 20 5f 53 51 4c 49 54 45 5f 4f 53 5f 48 5f  ef _SQLITE_OS_H_
0310: 0a 23 64 65 66 69 6e 65 20 5f 53 51 4c 49 54 45  .#define _SQLITE
0320: 5f 4f 53 5f 48 5f 0a 0a 2f 2a 0a 2a 2a 20 46 69  _OS_H_../*.** Fi
0330: 67 75 72 65 20 6f 75 74 20 69 66 20 77 65 20 61  gure out if we a
0340: 72 65 20 64 65 61 6c 69 6e 67 20 77 69 74 68 20  re dealing with 
0350: 55 6e 69 78 2c 20 57 69 6e 64 6f 77 73 2c 20 6f  Unix, Windows, o
0360: 72 20 73 6f 6d 65 20 6f 74 68 65 72 0a 2a 2a 20  r some other.** 
0370: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d  operating system
0380: 2e 20 20 41 66 74 65 72 20 74 68 65 20 66 6f 6c  .  After the fol
0390: 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6f 66 20  lowing block of 
03a0: 70 72 65 70 72 6f 63 65 73 73 20 6d 61 63 72 6f  preprocess macro
03b0: 73 2c 0a 2a 2a 20 61 6c 6c 20 6f 66 20 53 51 4c  s,.** all of SQL
03c0: 49 54 45 5f 4f 53 5f 55 4e 49 58 2c 20 53 51 4c  ITE_OS_UNIX, SQL
03d0: 49 54 45 5f 4f 53 5f 57 49 4e 2c 20 53 51 4c 49  ITE_OS_WIN, SQLI
03e0: 54 45 5f 4f 53 5f 4f 53 32 2c 20 61 6e 64 20 53  TE_OS_OS2, and S
03f0: 51 4c 49 54 45 5f 4f 53 5f 4f 54 48 45 52 20 0a  QLITE_OS_OTHER .
0400: 2a 2a 20 77 69 6c 6c 20 64 65 66 69 6e 65 64 20  ** will defined 
0410: 74 6f 20 65 69 74 68 65 72 20 31 20 6f 72 20 30  to either 1 or 0
0420: 2e 20 20 4f 6e 65 20 6f 66 20 74 68 65 20 66 6f  .  One of the fo
0430: 75 72 20 77 69 6c 6c 20 62 65 20 31 2e 20 20 54  ur will be 1.  T
0440: 68 65 20 6f 74 68 65 72 20 0a 2a 2a 20 74 68 72  he other .** thr
0450: 65 65 20 77 69 6c 6c 20 62 65 20 30 2e 0a 2a 2f  ee will be 0..*/
0460: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c  .#if defined(SQL
0470: 49 54 45 5f 4f 53 5f 4f 54 48 45 52 29 0a 23 20  ITE_OS_OTHER).# 
0480: 69 66 20 53 51 4c 49 54 45 5f 4f 53 5f 4f 54 48  if SQLITE_OS_OTH
0490: 45 52 3d 3d 31 0a 23 20 20 20 75 6e 64 65 66 20  ER==1.#   undef 
04a0: 53 51 4c 49 54 45 5f 4f 53 5f 55 4e 49 58 0a 23  SQLITE_OS_UNIX.#
04b0: 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45     define SQLITE
04c0: 5f 4f 53 5f 55 4e 49 58 20 30 0a 23 20 20 20 75  _OS_UNIX 0.#   u
04d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 53 5f 57  ndef SQLITE_OS_W
04e0: 49 4e 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51  IN.#   define SQ
04f0: 4c 49 54 45 5f 4f 53 5f 57 49 4e 20 30 0a 23 20  LITE_OS_WIN 0.# 
0500: 20 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f    undef SQLITE_O
0510: 53 5f 4f 53 32 0a 23 20 20 20 64 65 66 69 6e 65  S_OS2.#   define
0520: 20 53 51 4c 49 54 45 5f 4f 53 5f 4f 53 32 20 30   SQLITE_OS_OS2 0
0530: 0a 23 20 65 6c 73 65 0a 23 20 20 20 75 6e 64 65  .# else.#   unde
0540: 66 20 53 51 4c 49 54 45 5f 4f 53 5f 4f 54 48 45  f SQLITE_OS_OTHE
0550: 52 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66  R.# endif.#endif
0560: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51  .#if !defined(SQ
0570: 4c 49 54 45 5f 4f 53 5f 55 4e 49 58 29 20 26 26  LITE_OS_UNIX) &&
0580: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45   !defined(SQLITE
0590: 5f 4f 53 5f 4f 54 48 45 52 29 0a 23 20 64 65 66  _OS_OTHER).# def
05a0: 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f 4f 54  ine SQLITE_OS_OT
05b0: 48 45 52 20 30 0a 23 20 69 66 6e 64 65 66 20 53  HER 0.# ifndef S
05c0: 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 0a 23 20 20  QLITE_OS_WIN.#  
05d0: 20 69 66 20 64 65 66 69 6e 65 64 28 5f 57 49 4e   if defined(_WIN
05e0: 33 32 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 57  32) || defined(W
05f0: 49 4e 33 32 29 20 7c 7c 20 64 65 66 69 6e 65 64  IN32) || defined
0600: 28 5f 5f 43 59 47 57 49 4e 5f 5f 29 20 7c 7c 20  (__CYGWIN__) || 
0610: 64 65 66 69 6e 65 64 28 5f 5f 4d 49 4e 47 57 33  defined(__MINGW3
0620: 32 5f 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28  2__) || defined(
0630: 5f 5f 42 4f 52 4c 41 4e 44 43 5f 5f 29 0a 23 20  __BORLANDC__).# 
0640: 20 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54      define SQLIT
0650: 45 5f 4f 53 5f 57 49 4e 20 31 0a 23 20 20 20 20  E_OS_WIN 1.#    
0660: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f   define SQLITE_O
0670: 53 5f 55 4e 49 58 20 30 0a 23 20 20 20 20 20 64  S_UNIX 0.#     d
0680: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f  efine SQLITE_OS_
0690: 4f 53 32 20 30 0a 23 20 20 20 65 6c 69 66 20 64  OS2 0.#   elif d
06a0: 65 66 69 6e 65 64 28 5f 5f 45 4d 58 5f 5f 29 20  efined(__EMX__) 
06b0: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4f 53 32 29  || defined(_OS2)
06c0: 20 7c 7c 20 64 65 66 69 6e 65 64 28 4f 53 32 29   || defined(OS2)
06d0: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4f 53 32   || defined(_OS2
06e0: 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f  _) || defined(__
06f0: 4f 53 32 5f 5f 29 0a 23 20 20 20 20 20 64 65 66  OS2__).#     def
0700: 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49  ine SQLITE_OS_WI
0710: 4e 20 30 0a 23 20 20 20 20 20 64 65 66 69 6e 65  N 0.#     define
0720: 20 53 51 4c 49 54 45 5f 4f 53 5f 55 4e 49 58 20   SQLITE_OS_UNIX 
0730: 30 0a 23 20 20 20 20 20 64 65 66 69 6e 65 20 53  0.#     define S
0740: 51 4c 49 54 45 5f 4f 53 5f 4f 53 32 20 31 0a 23  QLITE_OS_OS2 1.#
0750: 20 20 20 65 6c 73 65 0a 23 20 20 20 20 20 64 65     else.#     de
0760: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f 57  fine SQLITE_OS_W
0770: 49 4e 20 30 0a 23 20 20 20 20 20 64 65 66 69 6e  IN 0.#     defin
0780: 65 20 53 51 4c 49 54 45 5f 4f 53 5f 55 4e 49 58  e SQLITE_OS_UNIX
0790: 20 31 0a 23 20 20 20 20 20 64 65 66 69 6e 65 20   1.#     define 
07a0: 53 51 4c 49 54 45 5f 4f 53 5f 4f 53 32 20 30 0a  SQLITE_OS_OS2 0.
07b0: 23 20 20 65 6e 64 69 66 0a 23 20 65 6c 73 65 0a  #  endif.# else.
07c0: 23 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45  #  define SQLITE
07d0: 5f 4f 53 5f 55 4e 49 58 20 30 0a 23 20 20 64 65  _OS_UNIX 0.#  de
07e0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f 4f  fine SQLITE_OS_O
07f0: 53 32 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6c  S2 0.# endif.#el
0800: 73 65 0a 23 20 69 66 6e 64 65 66 20 53 51 4c 49  se.# ifndef SQLI
0810: 54 45 5f 4f 53 5f 57 49 4e 0a 23 20 20 64 65 66  TE_OS_WIN.#  def
0820: 69 6e 65 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49  ine SQLITE_OS_WI
0830: 4e 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64  N 0.# endif.#end
0840: 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d  if../*.** Determ
0850: 69 6e 65 20 69 66 20 77 65 20 61 72 65 20 64 65  ine if we are de
0860: 61 6c 69 6e 67 20 77 69 74 68 20 57 69 6e 64 6f  aling with Windo
0870: 77 73 43 45 20 2d 20 77 68 69 63 68 20 68 61 73  wsCE - which has
0880: 20 61 20 6d 75 63 68 0a 2a 2a 20 72 65 64 75 63   a much.** reduc
0890: 65 64 20 41 50 49 2e 0a 2a 2f 0a 23 69 66 20 64  ed API..*/.#if d
08a0: 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 5f 57 43  efined(_WIN32_WC
08b0: 45 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49  E).# define SQLI
08c0: 54 45 5f 4f 53 5f 57 49 4e 43 45 20 31 0a 23 65  TE_OS_WINCE 1.#e
08d0: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 51 4c  lse.# define SQL
08e0: 49 54 45 5f 4f 53 5f 57 49 4e 43 45 20 30 0a 23  ITE_OS_WINCE 0.#
08f0: 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65  endif.../*.** De
0900: 66 69 6e 65 20 74 68 65 20 6d 61 78 69 6d 75 6d  fine the maximum
0910: 20 73 69 7a 65 20 6f 66 20 61 20 74 65 6d 70 6f   size of a tempo
0920: 72 61 72 79 20 66 69 6c 65 6e 61 6d 65 0a 2a 2f  rary filename.*/
0930: 0a 23 69 66 20 53 51 4c 49 54 45 5f 4f 53 5f 57  .#if SQLITE_OS_W
0940: 49 4e 0a 23 20 69 6e 63 6c 75 64 65 20 3c 77 69  IN.# include <wi
0950: 6e 64 6f 77 73 2e 68 3e 0a 23 20 64 65 66 69 6e  ndows.h>.# defin
0960: 65 20 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d  e SQLITE_TEMPNAM
0970: 45 5f 53 49 5a 45 20 28 4d 41 58 5f 50 41 54 48  E_SIZE (MAX_PATH
0980: 2b 35 30 29 0a 23 65 6c 69 66 20 53 51 4c 49 54  +50).#elif SQLIT
0990: 45 5f 4f 53 5f 4f 53 32 0a 23 20 69 66 20 28 5f  E_OS_OS2.# if (_
09a0: 5f 47 4e 55 43 5f 5f 20 3e 20 33 20 7c 7c 20 5f  _GNUC__ > 3 || _
09b0: 5f 47 4e 55 43 5f 5f 20 3d 3d 20 33 20 26 26 20  _GNUC__ == 3 && 
09c0: 5f 5f 47 4e 55 43 5f 4d 49 4e 4f 52 5f 5f 20 3e  __GNUC_MINOR__ >
09d0: 3d 20 33 29 20 26 26 20 64 65 66 69 6e 65 64 28  = 3) && defined(
09e0: 4f 53 32 5f 48 49 47 48 5f 4d 45 4d 4f 52 59 29  OS2_HIGH_MEMORY)
09f0: 0a 23 20 20 69 6e 63 6c 75 64 65 20 3c 6f 73 32  .#  include <os2
0a00: 73 61 66 65 2e 68 3e 20 2f 2a 20 68 61 73 20 74  safe.h> /* has t
0a10: 6f 20 62 65 20 69 6e 63 6c 75 64 65 64 20 62 65  o be included be
0a20: 66 6f 72 65 20 6f 73 32 2e 68 20 66 6f 72 20 6c  fore os2.h for l
0a30: 69 6e 6b 69 6e 67 20 74 6f 20 77 6f 72 6b 20 2a  inking to work *
0a40: 2f 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 66 69  /.# endif.# defi
0a50: 6e 65 20 49 4e 43 4c 5f 44 4f 53 44 41 54 45 54  ne INCL_DOSDATET
0a60: 49 4d 45 0a 23 20 64 65 66 69 6e 65 20 49 4e 43  IME.# define INC
0a70: 4c 5f 44 4f 53 46 49 4c 45 4d 47 52 0a 23 20 64  L_DOSFILEMGR.# d
0a80: 65 66 69 6e 65 20 49 4e 43 4c 5f 44 4f 53 45 52  efine INCL_DOSER
0a90: 52 4f 52 53 0a 23 20 64 65 66 69 6e 65 20 49 4e  RORS.# define IN
0aa0: 43 4c 5f 44 4f 53 4d 49 53 43 0a 23 20 64 65 66  CL_DOSMISC.# def
0ab0: 69 6e 65 20 49 4e 43 4c 5f 44 4f 53 50 52 4f 43  ine INCL_DOSPROC
0ac0: 45 53 53 0a 23 20 64 65 66 69 6e 65 20 49 4e 43  ESS.# define INC
0ad0: 4c 5f 44 4f 53 4d 4f 44 55 4c 45 4d 47 52 0a 23  L_DOSMODULEMGR.#
0ae0: 20 64 65 66 69 6e 65 20 49 4e 43 4c 5f 44 4f 53   define INCL_DOS
0af0: 53 45 4d 41 50 48 4f 52 45 53 0a 23 20 69 6e 63  SEMAPHORES.# inc
0b00: 6c 75 64 65 20 3c 6f 73 32 2e 68 3e 0a 23 20 69  lude <os2.h>.# i
0b10: 6e 63 6c 75 64 65 20 3c 75 63 6f 6e 76 2e 68 3e  nclude <uconv.h>
0b20: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45  .# define SQLITE
0b30: 5f 54 45 4d 50 4e 41 4d 45 5f 53 49 5a 45 20 28  _TEMPNAME_SIZE (
0b40: 43 43 48 4d 41 58 50 41 54 48 43 4f 4d 50 29 0a  CCHMAXPATHCOMP).
0b50: 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53  #else.# define S
0b60: 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45 5f 53  QLITE_TEMPNAME_S
0b70: 49 5a 45 20 32 30 30 0a 23 65 6e 64 69 66 0a 0a  IZE 200.#endif..
0b80: 2f 2a 20 49 66 20 74 68 65 20 53 45 54 5f 46 55  /* If the SET_FU
0b90: 4c 4c 53 59 4e 43 20 6d 61 63 72 6f 20 69 73 20  LLSYNC macro is 
0ba0: 6e 6f 74 20 64 65 66 69 6e 65 64 20 61 62 6f 76  not defined abov
0bb0: 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 69 74 0a  e, then make it.
0bc0: 2a 2a 20 61 20 6e 6f 2d 6f 70 0a 2a 2f 0a 23 69  ** a no-op.*/.#i
0bd0: 66 6e 64 65 66 20 53 45 54 5f 46 55 4c 4c 53 59  fndef SET_FULLSY
0be0: 4e 43 0a 23 20 64 65 66 69 6e 65 20 53 45 54 5f  NC.# define SET_
0bf0: 46 55 4c 4c 53 59 4e 43 28 78 2c 79 29 0a 23 65  FULLSYNC(x,y).#e
0c00: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  ndif../*.** The 
0c10: 64 65 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20  default size of 
0c20: 61 20 64 69 73 6b 20 73 65 63 74 6f 72 0a 2a 2f  a disk sector.*/
0c30: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
0c40: 44 45 46 41 55 4c 54 5f 53 45 43 54 4f 52 5f 53  DEFAULT_SECTOR_S
0c50: 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c  IZE.# define SQL
0c60: 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 45 43 54  ITE_DEFAULT_SECT
0c70: 4f 52 5f 53 49 5a 45 20 35 31 32 0a 23 65 6e 64  OR_SIZE 512.#end
0c80: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 65 6d 70 6f 72  if../*.** Tempor
0c90: 61 72 79 20 66 69 6c 65 73 20 61 72 65 20 6e 61  ary files are na
0ca0: 6d 65 64 20 73 74 61 72 74 69 6e 67 20 77 69 74  med starting wit
0cb0: 68 20 74 68 69 73 20 70 72 65 66 69 78 20 66 6f  h this prefix fo
0cc0: 6c 6c 6f 77 65 64 20 62 79 20 31 36 20 72 61 6e  llowed by 16 ran
0cd0: 64 6f 6d 0a 2a 2a 20 61 6c 70 68 61 6e 75 6d 65  dom.** alphanume
0ce0: 72 69 63 20 63 68 61 72 61 63 74 65 72 73 2c 20  ric characters, 
0cf0: 61 6e 64 20 6e 6f 20 66 69 6c 65 20 65 78 74 65  and no file exte
0d00: 6e 73 69 6f 6e 2e 20 54 68 65 79 20 61 72 65 20  nsion. They are 
0d10: 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 2a 2a  stored in the.**
0d20: 20 4f 53 27 73 20 73 74 61 6e 64 61 72 64 20 74   OS's standard t
0d30: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 64 69  emporary file di
0d40: 72 65 63 74 6f 72 79 2c 20 61 6e 64 20 61 72 65  rectory, and are
0d50: 20 64 65 6c 65 74 65 64 20 70 72 69 6f 72 20 74   deleted prior t
0d60: 6f 20 65 78 69 74 2e 0a 2a 2a 20 49 66 20 73 71  o exit..** If sq
0d70: 6c 69 74 65 20 69 73 20 62 65 69 6e 67 20 65 6d  lite is being em
0d80: 62 65 64 64 65 64 20 69 6e 20 61 6e 6f 74 68 65  bedded in anothe
0d90: 72 20 70 72 6f 67 72 61 6d 2c 20 79 6f 75 20 6d  r program, you m
0da0: 61 79 20 77 69 73 68 20 74 6f 20 63 68 61 6e 67  ay wish to chang
0db0: 65 20 74 68 65 0a 2a 2a 20 70 72 65 66 69 78 20  e the.** prefix 
0dc0: 74 6f 20 72 65 66 6c 65 63 74 20 79 6f 75 72 20  to reflect your 
0dd0: 70 72 6f 67 72 61 6d 27 73 20 6e 61 6d 65 2c 20  program's name, 
0de0: 73 6f 20 74 68 61 74 20 69 66 20 79 6f 75 72 20  so that if your 
0df0: 70 72 6f 67 72 61 6d 20 65 78 69 74 73 0a 2a 2a  program exits.**
0e00: 20 70 72 65 6d 61 74 75 72 65 6c 79 2c 20 6f 6c   prematurely, ol
0e10: 64 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65  d temporary file
0e20: 73 20 63 61 6e 20 62 65 20 65 61 73 69 6c 79 20  s can be easily 
0e30: 69 64 65 6e 74 69 66 69 65 64 2e 20 54 68 69 73  identified. This
0e40: 20 63 61 6e 20 62 65 20 64 6f 6e 65 0a 2a 2a 20   can be done.** 
0e50: 75 73 69 6e 67 20 2d 44 53 51 4c 49 54 45 5f 54  using -DSQLITE_T
0e60: 45 4d 50 5f 46 49 4c 45 5f 50 52 45 46 49 58 3d  EMP_FILE_PREFIX=
0e70: 6d 79 70 72 65 66 69 78 5f 20 6f 6e 20 74 68 65  myprefix_ on the
0e80: 20 63 6f 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 6e   compiler comman
0e90: 64 20 6c 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 32 30  d line..**.** 20
0ea0: 30 36 2d 31 30 2d 33 31 3a 20 20 54 68 65 20 64  06-10-31:  The d
0eb0: 65 66 61 75 6c 74 20 70 72 65 66 69 78 20 75 73  efault prefix us
0ec0: 65 64 20 74 6f 20 62 65 20 22 73 71 6c 69 74 65  ed to be "sqlite
0ed0: 5f 22 2e 20 20 42 75 74 20 74 68 65 6e 0a 2a 2a  _".  But then.**
0ee0: 20 4d 63 61 66 65 65 20 73 74 61 72 74 65 64 20   Mcafee started 
0ef0: 75 73 69 6e 67 20 53 51 4c 69 74 65 20 69 6e 20  using SQLite in 
0f00: 74 68 65 69 72 20 61 6e 74 69 2d 76 69 72 75 73  their anti-virus
0f10: 20 70 72 6f 64 75 63 74 20 61 6e 64 20 69 74 0a   product and it.
0f20: 2a 2a 20 73 74 61 72 74 65 64 20 70 75 74 74 69  ** started putti
0f30: 6e 67 20 66 69 6c 65 73 20 77 69 74 68 20 74 68  ng files with th
0f40: 65 20 22 73 71 6c 69 74 65 22 20 6e 61 6d 65 20  e "sqlite" name 
0f50: 69 6e 20 74 68 65 20 63 3a 2f 74 65 6d 70 20 66  in the c:/temp f
0f60: 6f 6c 64 65 72 2e 0a 2a 2a 20 54 68 69 73 20 61  older..** This a
0f70: 6e 6e 6f 79 65 64 20 6d 61 6e 79 20 77 69 6e 64  nnoyed many wind
0f80: 6f 77 73 20 75 73 65 72 73 2e 20 20 54 68 6f 73  ows users.  Thos
0f90: 65 20 75 73 65 72 73 20 77 6f 75 6c 64 20 74 68  e users would th
0fa0: 65 6e 20 64 6f 20 61 20 0a 2a 2a 20 47 6f 6f 67  en do a .** Goog
0fb0: 6c 65 20 73 65 61 72 63 68 20 66 6f 72 20 22 73  le search for "s
0fc0: 71 6c 69 74 65 22 2c 20 66 69 6e 64 20 74 68 65  qlite", find the
0fd0: 20 74 65 6c 65 70 68 6f 6e 65 20 6e 75 6d 62 65   telephone numbe
0fe0: 72 73 20 6f 66 20 74 68 65 0a 2a 2a 20 64 65 76  rs of the.** dev
0ff0: 65 6c 6f 70 65 72 73 20 61 6e 64 20 63 61 6c 6c  elopers and call
1000: 20 74 6f 20 77 61 6b 65 20 74 68 65 6d 20 75 70   to wake them up
1010: 20 61 74 20 6e 69 67 68 74 20 61 6e 64 20 63 6f   at night and co
1020: 6d 70 6c 61 69 6e 2e 0a 2a 2a 20 46 6f 72 20 74  mplain..** For t
1030: 68 69 73 20 72 65 61 73 6f 6e 2c 20 74 68 65 20  his reason, the 
1040: 64 65 66 61 75 6c 74 20 6e 61 6d 65 20 70 72 65  default name pre
1050: 66 69 78 20 69 73 20 63 68 61 6e 67 65 64 20 74  fix is changed t
1060: 6f 20 62 65 20 22 73 71 6c 69 74 65 22 20 0a 2a  o be "sqlite" .*
1070: 2a 20 73 70 65 6c 6c 65 64 20 62 61 63 6b 77 61  * spelled backwa
1080: 72 64 73 2e 20 20 53 6f 20 74 68 65 20 74 65 6d  rds.  So the tem
1090: 70 20 66 69 6c 65 73 20 61 72 65 20 73 74 69 6c  p files are stil
10a0: 6c 20 69 64 65 6e 74 69 66 69 65 64 2c 20 62 75  l identified, bu
10b0: 74 0a 2a 2a 20 61 6e 79 62 6f 64 79 20 73 6d 61  t.** anybody sma
10c0: 72 74 20 65 6e 6f 75 67 68 20 74 6f 20 66 69 67  rt enough to fig
10d0: 75 72 65 20 6f 75 74 20 74 68 65 20 63 6f 64 65  ure out the code
10e0: 20 69 73 20 61 6c 73 6f 20 6c 69 6b 65 6c 79 20   is also likely 
10f0: 73 6d 61 72 74 0a 2a 2a 20 65 6e 6f 75 67 68 20  smart.** enough 
1100: 74 6f 20 6b 6e 6f 77 20 74 68 61 74 20 63 61 6c  to know that cal
1110: 6c 69 6e 67 20 74 68 65 20 64 65 76 65 6c 6f 70  ling the develop
1120: 65 72 20 77 69 6c 6c 20 6e 6f 74 20 68 65 6c 70  er will not help
1130: 20 67 65 74 20 72 69 64 0a 2a 2a 20 6f 66 20 74   get rid.** of t
1140: 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 23 69 66 6e  he file..*/.#ifn
1150: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f  def SQLITE_TEMP_
1160: 46 49 4c 45 5f 50 52 45 46 49 58 0a 23 20 64 65  FILE_PREFIX.# de
1170: 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 45 4d 50  fine SQLITE_TEMP
1180: 5f 46 49 4c 45 5f 50 52 45 46 49 58 20 22 65 74  _FILE_PREFIX "et
1190: 69 6c 71 73 5f 22 0a 23 65 6e 64 69 66 0a 0a 2f  ilqs_".#endif../
11a0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
11b0: 6e 67 20 76 61 6c 75 65 73 20 6d 61 79 20 62 65  ng values may be
11c0: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73   passed as the s
11d0: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74  econd argument t
11e0: 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 4f 73 4c 6f  o.** sqlite3OsLo
11f0: 63 6b 28 29 2e 20 54 68 65 20 76 61 72 69 6f 75  ck(). The variou
1200: 73 20 6c 6f 63 6b 73 20 65 78 68 69 62 69 74 20  s locks exhibit 
1210: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65  the following se
1220: 6d 61 6e 74 69 63 73 3a 0a 2a 2a 0a 2a 2a 20 53  mantics:.**.** S
1230: 48 41 52 45 44 3a 20 20 20 20 41 6e 79 20 6e 75  HARED:    Any nu
1240: 6d 62 65 72 20 6f 66 20 70 72 6f 63 65 73 73 65  mber of processe
1250: 73 20 6d 61 79 20 68 6f 6c 64 20 61 20 53 48 41  s may hold a SHA
1260: 52 45 44 20 6c 6f 63 6b 20 73 69 6d 75 6c 74 61  RED lock simulta
1270: 6e 65 6f 75 73 6c 79 2e 0a 2a 2a 20 52 45 53 45  neously..** RESE
1280: 52 56 45 44 3a 20 20 41 20 73 69 6e 67 6c 65 20  RVED:  A single 
1290: 70 72 6f 63 65 73 73 20 6d 61 79 20 68 6f 6c 64  process may hold
12a0: 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b   a RESERVED lock
12b0: 20 6f 6e 20 61 20 66 69 6c 65 20 61 74 0a 2a 2a   on a file at.**
12c0: 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 79 20              any 
12d0: 74 69 6d 65 2e 20 4f 74 68 65 72 20 70 72 6f 63  time. Other proc
12e0: 65 73 73 65 73 20 6d 61 79 20 68 6f 6c 64 20 61  esses may hold a
12f0: 6e 64 20 6f 62 74 61 69 6e 20 6e 65 77 20 53 48  nd obtain new SH
1300: 41 52 45 44 20 6c 6f 63 6b 73 2e 0a 2a 2a 20 50  ARED locks..** P
1310: 45 4e 44 49 4e 47 3a 20 20 20 41 20 73 69 6e 67  ENDING:   A sing
1320: 6c 65 20 70 72 6f 63 65 73 73 20 6d 61 79 20 68  le process may h
1330: 6f 6c 64 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f  old a PENDING lo
1340: 63 6b 20 6f 6e 20 61 20 66 69 6c 65 20 61 74 0a  ck on a file at.
1350: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 61 6e  **            an
1360: 79 20 6f 6e 65 20 74 69 6d 65 2e 20 45 78 69 73  y one time. Exis
1370: 74 69 6e 67 20 53 48 41 52 45 44 20 6c 6f 63 6b  ting SHARED lock
1380: 73 20 6d 61 79 20 70 65 72 73 69 73 74 2c 20 62  s may persist, b
1390: 75 74 20 6e 6f 20 6e 65 77 0a 2a 2a 20 20 20 20  ut no new.**    
13a0: 20 20 20 20 20 20 20 20 53 48 41 52 45 44 20 6c          SHARED l
13b0: 6f 63 6b 73 20 6d 61 79 20 62 65 20 6f 62 74 61  ocks may be obta
13c0: 69 6e 65 64 20 62 79 20 6f 74 68 65 72 20 70 72  ined by other pr
13d0: 6f 63 65 73 73 65 73 2e 0a 2a 2a 20 45 58 43 4c  ocesses..** EXCL
13e0: 55 53 49 56 45 3a 20 41 6e 20 45 58 43 4c 55 53  USIVE: An EXCLUS
13f0: 49 56 45 20 6c 6f 63 6b 20 70 72 65 63 6c 75 64  IVE lock preclud
1400: 65 73 20 61 6c 6c 20 6f 74 68 65 72 20 6c 6f 63  es all other loc
1410: 6b 73 2e 0a 2a 2a 0a 2a 2a 20 50 45 4e 44 49 4e  ks..**.** PENDIN
1420: 47 5f 4c 4f 43 4b 20 6d 61 79 20 6e 6f 74 20 62  G_LOCK may not b
1430: 65 20 70 61 73 73 65 64 20 64 69 72 65 63 74 6c  e passed directl
1440: 79 20 74 6f 20 73 71 6c 69 74 65 33 4f 73 4c 6f  y to sqlite3OsLo
1450: 63 6b 28 29 2e 20 49 6e 73 74 65 61 64 2c 20 61  ck(). Instead, a
1460: 0a 2a 2a 20 70 72 6f 63 65 73 73 20 74 68 61 74  .** process that
1470: 20 72 65 71 75 65 73 74 73 20 61 6e 20 45 58 43   requests an EXC
1480: 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6d 61 79 20  LUSIVE lock may 
1490: 61 63 74 75 61 6c 6c 79 20 6f 62 74 61 69 6e 20  actually obtain 
14a0: 61 20 50 45 4e 44 49 4e 47 0a 2a 2a 20 6c 6f 63  a PENDING.** loc
14b0: 6b 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 75  k. This can be u
14c0: 70 67 72 61 64 65 64 20 74 6f 20 61 6e 20 45 58  pgraded to an EX
14d0: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 62 79 20  CLUSIVE lock by 
14e0: 61 20 73 75 62 73 65 71 75 65 6e 74 20 63 61 6c  a subsequent cal
14f0: 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 4f  l to.** sqlite3O
1500: 73 4c 6f 63 6b 28 29 2e 0a 2a 2f 0a 23 64 65 66  sLock()..*/.#def
1510: 69 6e 65 20 4e 4f 5f 4c 4f 43 4b 20 20 20 20 20  ine NO_LOCK     
1520: 20 20 20 20 30 0a 23 64 65 66 69 6e 65 20 53 48      0.#define SH
1530: 41 52 45 44 5f 4c 4f 43 4b 20 20 20 20 20 31 0a  ARED_LOCK     1.
1540: 23 64 65 66 69 6e 65 20 52 45 53 45 52 56 45 44  #define RESERVED
1550: 5f 4c 4f 43 4b 20 20 20 32 0a 23 64 65 66 69 6e  _LOCK   2.#defin
1560: 65 20 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 20  e PENDING_LOCK  
1570: 20 20 33 0a 23 64 65 66 69 6e 65 20 45 58 43 4c    3.#define EXCL
1580: 55 53 49 56 45 5f 4c 4f 43 4b 20 20 34 0a 0a 2f  USIVE_LOCK  4../
1590: 2a 0a 2a 2a 20 46 69 6c 65 20 4c 6f 63 6b 69 6e  *.** File Lockin
15a0: 67 20 4e 6f 74 65 73 3a 20 20 28 4d 6f 73 74 6c  g Notes:  (Mostl
15b0: 79 20 61 62 6f 75 74 20 77 69 6e 64 6f 77 73 20  y about windows 
15c0: 62 75 74 20 61 6c 73 6f 20 73 6f 6d 65 20 69 6e  but also some in
15d0: 66 6f 20 66 6f 72 20 55 6e 69 78 29 0a 2a 2a 0a  fo for Unix).**.
15e0: 2a 2a 20 57 65 20 63 61 6e 6e 6f 74 20 75 73 65  ** We cannot use
15f0: 20 4c 6f 63 6b 46 69 6c 65 45 78 28 29 20 6f 72   LockFileEx() or
1600: 20 55 6e 6c 6f 63 6b 46 69 6c 65 45 78 28 29 20   UnlockFileEx() 
1610: 6f 6e 20 57 69 6e 39 35 2f 39 38 2f 4d 45 20 62  on Win95/98/ME b
1620: 65 63 61 75 73 65 0a 2a 2a 20 74 68 6f 73 65 20  ecause.** those 
1630: 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f  functions are no
1640: 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 53 6f  t available.  So
1650: 20 77 65 20 75 73 65 20 6f 6e 6c 79 20 4c 6f 63   we use only Loc
1660: 6b 46 69 6c 65 28 29 20 61 6e 64 0a 2a 2a 20 55  kFile() and.** U
1670: 6e 6c 6f 63 6b 46 69 6c 65 28 29 2e 0a 2a 2a 0a  nlockFile()..**.
1680: 2a 2a 20 4c 6f 63 6b 46 69 6c 65 28 29 20 70 72  ** LockFile() pr
1690: 65 76 65 6e 74 73 20 6e 6f 74 20 6a 75 73 74 20  events not just 
16a0: 77 72 69 74 69 6e 67 20 62 75 74 20 61 6c 73 6f  writing but also
16b0: 20 72 65 61 64 69 6e 67 20 62 79 20 6f 74 68 65   reading by othe
16c0: 72 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a 2a 20  r processes..** 
16d0: 41 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 69 73  A SHARED_LOCK is
16e0: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63   obtained by loc
16f0: 6b 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 72 61  king a single ra
1700: 6e 64 6f 6d 6c 79 2d 63 68 6f 73 65 6e 20 0a 2a  ndomly-chosen .*
1710: 2a 20 62 79 74 65 20 6f 75 74 20 6f 66 20 61 20  * byte out of a 
1720: 73 70 65 63 69 66 69 63 20 72 61 6e 67 65 20 6f  specific range o
1730: 66 20 62 79 74 65 73 2e 20 54 68 65 20 6c 6f 63  f bytes. The loc
1740: 6b 20 62 79 74 65 20 69 73 20 6f 62 74 61 69 6e  k byte is obtain
1750: 65 64 20 61 74 20 0a 2a 2a 20 72 61 6e 64 6f 6d  ed at .** random
1760: 20 73 6f 20 74 77 6f 20 73 65 70 61 72 61 74 65   so two separate
1770: 20 72 65 61 64 65 72 73 20 63 61 6e 20 70 72 6f   readers can pro
1780: 62 61 62 6c 79 20 61 63 63 65 73 73 20 74 68 65  bably access the
1790: 20 66 69 6c 65 20 61 74 20 74 68 65 20 0a 2a 2a   file at the .**
17a0: 20 73 61 6d 65 20 74 69 6d 65 2c 20 75 6e 6c 65   same time, unle
17b0: 73 73 20 74 68 65 79 20 61 72 65 20 75 6e 6c 75  ss they are unlu
17c0: 63 6b 79 20 61 6e 64 20 63 68 6f 6f 73 65 20 74  cky and choose t
17d0: 68 65 20 73 61 6d 65 20 6c 6f 63 6b 20 62 79 74  he same lock byt
17e0: 65 2e 0a 2a 2a 20 41 6e 20 45 58 43 4c 55 53 49  e..** An EXCLUSI
17f0: 56 45 5f 4c 4f 43 4b 20 69 73 20 6f 62 74 61 69  VE_LOCK is obtai
1800: 6e 65 64 20 62 79 20 6c 6f 63 6b 69 6e 67 20 61  ned by locking a
1810: 6c 6c 20 62 79 74 65 73 20 69 6e 20 74 68 65 20  ll bytes in the 
1820: 72 61 6e 67 65 2e 0a 2a 2a 20 54 68 65 72 65 20  range..** There 
1830: 63 61 6e 20 6f 6e 6c 79 20 62 65 20 6f 6e 65 20  can only be one 
1840: 77 72 69 74 65 72 2e 20 20 41 20 52 45 53 45 52  writer.  A RESER
1850: 56 45 44 5f 4c 4f 43 4b 20 69 73 20 6f 62 74 61  VED_LOCK is obta
1860: 69 6e 65 64 20 62 79 20 6c 6f 63 6b 69 6e 67 0a  ined by locking.
1870: 2a 2a 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65  ** a single byte
1880: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 68 61   of the file tha
1890: 74 20 69 73 20 64 65 73 69 67 6e 61 74 65 64 20  t is designated 
18a0: 61 73 20 74 68 65 20 72 65 73 65 72 76 65 64 20  as the reserved 
18b0: 6c 6f 63 6b 20 62 79 74 65 2e 0a 2a 2a 20 41 20  lock byte..** A 
18c0: 50 45 4e 44 49 4e 47 5f 4c 4f 43 4b 20 69 73 20  PENDING_LOCK is 
18d0: 6f 62 74 61 69 6e 65 64 20 62 79 20 6c 6f 63 6b  obtained by lock
18e0: 69 6e 67 20 61 20 64 65 73 69 67 6e 61 74 65 64  ing a designated
18f0: 20 62 79 74 65 20 64 69 66 66 65 72 65 6e 74 20   byte different 
1900: 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 52 45 53 45  from.** the RESE
1910: 52 56 45 44 5f 4c 4f 43 4b 20 62 79 74 65 2e 0a  RVED_LOCK byte..
1920: 2a 2a 0a 2a 2a 20 4f 6e 20 57 69 6e 4e 54 2f 32  **.** On WinNT/2
1930: 4b 2f 58 50 20 73 79 73 74 65 6d 73 2c 20 4c 6f  K/XP systems, Lo
1940: 63 6b 46 69 6c 65 45 78 28 29 20 61 6e 64 20 55  ckFileEx() and U
1950: 6e 6c 6f 63 6b 46 69 6c 65 45 78 28 29 20 61 72  nlockFileEx() ar
1960: 65 20 61 76 61 69 6c 61 62 6c 65 2c 0a 2a 2a 20  e available,.** 
1970: 77 68 69 63 68 20 6d 65 61 6e 73 20 77 65 20 63  which means we c
1980: 61 6e 20 75 73 65 20 72 65 61 64 65 72 2f 77 72  an use reader/wr
1990: 69 74 65 72 20 6c 6f 63 6b 73 2e 20 20 57 68 65  iter locks.  Whe
19a0: 6e 20 72 65 61 64 65 72 2f 77 72 69 74 65 72 20  n reader/writer 
19b0: 6c 6f 63 6b 73 0a 2a 2a 20 61 72 65 20 75 73 65  locks.** are use
19c0: 64 2c 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 70  d, the lock is p
19d0: 6c 61 63 65 64 20 6f 6e 20 74 68 65 20 73 61 6d  laced on the sam
19e0: 65 20 72 61 6e 67 65 20 6f 66 20 62 79 74 65 73  e range of bytes
19f0: 20 74 68 61 74 20 69 73 20 75 73 65 64 0a 2a 2a   that is used.**
1a00: 20 66 6f 72 20 70 72 6f 62 61 62 69 6c 69 73 74   for probabilist
1a10: 69 63 20 6c 6f 63 6b 69 6e 67 20 69 6e 20 57 69  ic locking in Wi
1a20: 6e 39 35 2f 39 38 2f 4d 45 2e 20 20 48 65 6e 63  n95/98/ME.  Henc
1a30: 65 2c 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 73  e, the locking s
1a40: 63 68 65 6d 65 0a 2a 2a 20 77 69 6c 6c 20 73 75  cheme.** will su
1a50: 70 70 6f 72 74 20 74 77 6f 20 6f 72 20 6d 6f 72  pport two or mor
1a60: 65 20 57 69 6e 39 35 20 72 65 61 64 65 72 73 20  e Win95 readers 
1a70: 6f 72 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 57  or two or more W
1a80: 69 6e 4e 54 20 72 65 61 64 65 72 73 2e 0a 2a 2a  inNT readers..**
1a90: 20 42 75 74 20 61 20 73 69 6e 67 6c 65 20 57 69   But a single Wi
1aa0: 6e 39 35 20 72 65 61 64 65 72 20 77 69 6c 6c 20  n95 reader will 
1ab0: 6c 6f 63 6b 20 6f 75 74 20 61 6c 6c 20 57 69 6e  lock out all Win
1ac0: 4e 54 20 72 65 61 64 65 72 73 20 61 6e 64 20 61  NT readers and a
1ad0: 20 73 69 6e 67 6c 65 0a 2a 2a 20 57 69 6e 4e 54   single.** WinNT
1ae0: 20 72 65 61 64 65 72 20 77 69 6c 6c 20 6c 6f 63   reader will loc
1af0: 6b 20 6f 75 74 20 61 6c 6c 20 6f 74 68 65 72 20  k out all other 
1b00: 57 69 6e 39 35 20 72 65 61 64 65 72 73 2e 0a 2a  Win95 readers..*
1b10: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
1b20: 6e 67 20 23 64 65 66 69 6e 65 73 20 73 70 65 63  ng #defines spec
1b30: 69 66 79 20 74 68 65 20 72 61 6e 67 65 20 6f 66  ify the range of
1b40: 20 62 79 74 65 73 20 75 73 65 64 20 66 6f 72 20   bytes used for 
1b50: 6c 6f 63 6b 69 6e 67 2e 0a 2a 2a 20 53 48 41 52  locking..** SHAR
1b60: 45 44 5f 53 49 5a 45 20 69 73 20 74 68 65 20 6e  ED_SIZE is the n
1b70: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 61  umber of bytes a
1b80: 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20  vailable in the 
1b90: 70 6f 6f 6c 20 66 72 6f 6d 20 77 68 69 63 68 0a  pool from which.
1ba0: 2a 2a 20 61 20 72 61 6e 64 6f 6d 20 62 79 74 65  ** a random byte
1bb0: 20 69 73 20 73 65 6c 65 63 74 65 64 20 66 6f 72   is selected for
1bc0: 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b 2e 20   a shared lock. 
1bd0: 20 54 68 65 20 70 6f 6f 6c 20 6f 66 20 62 79 74   The pool of byt
1be0: 65 73 20 66 6f 72 0a 2a 2a 20 73 68 61 72 65 64  es for.** shared
1bf0: 20 6c 6f 63 6b 73 20 62 65 67 69 6e 73 20 61 74   locks begins at
1c00: 20 53 48 41 52 45 44 5f 46 49 52 53 54 2e 20 0a   SHARED_FIRST. .
1c10: 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 23 64 65 66  **.** These #def
1c20: 69 6e 65 73 20 61 72 65 20 61 76 61 69 6c 61 62  ines are availab
1c30: 6c 65 20 69 6e 20 73 71 6c 69 74 65 5f 61 75 78  le in sqlite_aux
1c40: 2e 68 20 73 6f 20 74 68 61 74 20 61 64 61 70 74  .h so that adapt
1c50: 6f 72 73 20 66 6f 72 0a 2a 2a 20 63 6f 6e 6e 65  ors for.** conne
1c60: 63 74 69 6e 67 20 53 51 4c 69 74 65 20 74 6f 20  cting SQLite to 
1c70: 6f 74 68 65 72 20 6f 70 65 72 61 74 69 6e 67 20  other operating 
1c80: 73 79 73 74 65 6d 73 20 63 61 6e 20 75 73 65 20  systems can use 
1c90: 74 68 65 20 73 61 6d 65 20 62 79 74 65 0a 2a 2a  the same byte.**
1ca0: 20 72 61 6e 67 65 73 20 66 6f 72 20 6c 6f 63 6b   ranges for lock
1cb0: 69 6e 67 2e 20 20 49 6e 20 70 61 72 74 69 63 75  ing.  In particu
1cc0: 6c 61 72 2c 20 74 68 65 20 73 61 6d 65 20 6c 6f  lar, the same lo
1cd0: 63 6b 69 6e 67 20 73 74 72 61 74 65 67 79 20 61  cking strategy a
1ce0: 6e 64 0a 2a 2a 20 62 79 74 65 20 72 61 6e 67 65  nd.** byte range
1cf0: 73 20 61 72 65 20 75 73 65 64 20 66 6f 72 20 55  s are used for U
1d00: 6e 69 78 2e 20 20 54 68 69 73 20 6c 65 61 76 65  nix.  This leave
1d10: 73 20 6f 70 65 6e 20 74 68 65 20 70 6f 73 73 69  s open the possi
1d20: 62 6c 69 74 79 20 6f 66 20 68 61 76 69 6e 67 0a  blity of having.
1d30: 2a 2a 20 63 6c 69 65 6e 74 73 20 6f 6e 20 77 69  ** clients on wi
1d40: 6e 39 35 2c 20 77 69 6e 4e 54 2c 20 61 6e 64 20  n95, winNT, and 
1d50: 75 6e 69 78 20 61 6c 6c 20 74 61 6c 6b 69 6e 67  unix all talking
1d60: 20 74 6f 20 74 68 65 20 73 61 6d 65 20 73 68 61   to the same sha
1d70: 72 65 64 20 66 69 6c 65 0a 2a 2a 20 61 6e 64 20  red file.** and 
1d80: 61 6c 6c 20 6c 6f 63 6b 69 6e 67 20 63 6f 72 72  all locking corr
1d90: 65 63 74 6c 79 2e 20 20 54 6f 20 64 6f 20 73 6f  ectly.  To do so
1da0: 20 77 6f 75 6c 64 20 72 65 71 75 69 72 65 20 74   would require t
1db0: 68 61 74 20 73 61 6d 62 61 20 28 6f 72 20 77 68  hat samba (or wh
1dc0: 61 74 65 76 65 72 0a 2a 2a 20 74 6f 6f 6c 20 69  atever.** tool i
1dd0: 73 20 62 65 69 6e 67 20 75 73 65 64 20 66 6f 72  s being used for
1de0: 20 66 69 6c 65 20 73 68 61 72 69 6e 67 29 20 69   file sharing) i
1df0: 6d 70 6c 65 6d 65 6e 74 73 20 6c 6f 63 6b 73 20  mplements locks 
1e00: 63 6f 72 72 65 63 74 6c 79 20 62 65 74 77 65 65  correctly betwee
1e10: 6e 0a 2a 2a 20 77 69 6e 64 6f 77 73 20 61 6e 64  n.** windows and
1e20: 20 75 6e 69 78 2e 20 20 49 27 6d 20 67 75 65 73   unix.  I'm gues
1e30: 73 69 6e 67 20 74 68 61 74 20 69 73 6e 27 74 20  sing that isn't 
1e40: 6c 69 6b 65 6c 79 20 74 6f 20 68 61 70 70 65 6e  likely to happen
1e50: 2c 20 62 75 74 20 62 79 0a 2a 2a 20 75 73 69 6e  , but by.** usin
1e60: 67 20 74 68 65 20 73 61 6d 65 20 6c 6f 63 6b 69  g the same locki
1e70: 6e 67 20 72 61 6e 67 65 20 77 65 20 61 72 65 20  ng range we are 
1e80: 61 74 20 6c 65 61 73 74 20 6f 70 65 6e 20 74 6f  at least open to
1e90: 20 74 68 65 20 70 6f 73 73 69 62 69 6c 69 74 79   the possibility
1ea0: 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 63 6b 69 6e 67 20  ..**.** Locking 
1eb0: 69 6e 20 77 69 6e 64 6f 77 73 20 69 73 20 6d 61  in windows is ma
1ec0: 6e 64 69 74 6f 72 79 2e 20 20 46 6f 72 20 74 68  nditory.  For th
1ed0: 69 73 20 72 65 61 73 6f 6e 2c 20 77 65 20 63 61  is reason, we ca
1ee0: 6e 6e 6f 74 20 73 74 6f 72 65 0a 2a 2a 20 61 63  nnot store.** ac
1ef0: 74 75 61 6c 20 64 61 74 61 20 69 6e 20 74 68 65  tual data in the
1f00: 20 62 79 74 65 73 20 75 73 65 64 20 66 6f 72 20   bytes used for 
1f10: 6c 6f 63 6b 69 6e 67 2e 20 20 54 68 65 20 70 61  locking.  The pa
1f20: 67 65 72 20 6e 65 76 65 72 20 61 6c 6c 6f 63 61  ger never alloca
1f30: 74 65 73 0a 2a 2a 20 74 68 65 20 70 61 67 65 73  tes.** the pages
1f40: 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 6c 6f 63   involved in loc
1f50: 6b 69 6e 67 20 74 68 65 72 65 66 6f 72 65 2e 20  king therefore. 
1f60: 20 53 48 41 52 45 44 5f 53 49 5a 45 20 69 73 20   SHARED_SIZE is 
1f70: 73 65 6c 65 63 74 65 64 20 73 6f 0a 2a 2a 20 74  selected so.** t
1f80: 68 61 74 20 61 6c 6c 20 6c 6f 63 6b 73 20 77 69  hat all locks wi
1f90: 6c 6c 20 66 69 74 20 6f 6e 20 61 20 73 69 6e 67  ll fit on a sing
1fa0: 6c 65 20 70 61 67 65 20 65 76 65 6e 20 61 74 20  le page even at 
1fb0: 74 68 65 20 6d 69 6e 69 6d 75 6d 20 70 61 67 65  the minimum page
1fc0: 20 73 69 7a 65 2e 0a 2a 2a 20 50 45 4e 44 49 4e   size..** PENDIN
1fd0: 47 5f 42 59 54 45 20 64 65 66 69 6e 65 73 20 74  G_BYTE defines t
1fe0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20  he beginning of 
1ff0: 74 68 65 20 6c 6f 63 6b 73 2e 20 20 42 79 20 64  the locks.  By d
2000: 65 66 61 75 6c 74 20 50 45 4e 44 49 4e 47 5f 42  efault PENDING_B
2010: 59 54 45 0a 2a 2a 20 69 73 20 73 65 74 20 68 69  YTE.** is set hi
2020: 67 68 20 73 6f 20 74 68 61 74 20 77 65 20 64 6f  gh so that we do
2030: 6e 27 74 20 68 61 76 65 20 74 6f 20 61 6c 6c 6f  n't have to allo
2040: 63 61 74 65 20 61 6e 20 75 6e 75 73 65 64 20 70  cate an unused p
2050: 61 67 65 20 65 78 63 65 70 74 0a 2a 2a 20 66 6f  age except.** fo
2060: 72 20 76 65 72 79 20 6c 61 72 67 65 20 64 61 74  r very large dat
2070: 61 62 61 73 65 73 2e 20 20 42 75 74 20 6f 6e 65  abases.  But one
2080: 20 73 68 6f 75 6c 64 20 74 65 73 74 20 74 68 65   should test the
2090: 20 70 61 67 65 20 73 6b 69 70 70 69 6e 67 20 6c   page skipping l
20a0: 6f 67 69 63 20 0a 2a 2a 20 62 79 20 73 65 74 74  ogic .** by sett
20b0: 69 6e 67 20 50 45 4e 44 49 4e 47 5f 42 59 54 45  ing PENDING_BYTE
20c0: 20 6c 6f 77 20 61 6e 64 20 72 75 6e 6e 69 6e 67   low and running
20d0: 20 74 68 65 20 65 6e 74 69 72 65 20 72 65 67 72   the entire regr
20e0: 65 73 73 69 6f 6e 20 73 75 69 74 65 2e 0a 2a 2a  ession suite..**
20f0: 0a 2a 2a 20 43 68 61 6e 67 69 6e 67 20 74 68 65  .** Changing the
2100: 20 76 61 6c 75 65 20 6f 66 20 50 45 4e 44 49 4e   value of PENDIN
2110: 47 5f 42 59 54 45 20 72 65 73 75 6c 74 73 20 69  G_BYTE results i
2120: 6e 20 61 20 73 75 62 74 6c 79 20 69 6e 63 6f 6d  n a subtly incom
2130: 70 61 74 69 62 6c 65 0a 2a 2a 20 66 69 6c 65 20  patible.** file 
2140: 66 6f 72 6d 61 74 2e 20 20 44 65 70 65 6e 64 69  format.  Dependi
2150: 6e 67 20 6f 6e 20 68 6f 77 20 69 74 20 69 73 20  ng on how it is 
2160: 63 68 61 6e 67 65 64 2c 20 79 6f 75 20 6d 69 67  changed, you mig
2170: 68 74 20 6e 6f 74 20 6e 6f 74 69 63 65 0a 2a 2a  ht not notice.**
2180: 20 74 68 65 20 69 6e 63 6f 6d 70 61 74 69 62 69   the incompatibi
2190: 6c 69 74 79 20 72 69 67 68 74 20 61 77 61 79 2c  lity right away,
21a0: 20 65 76 65 6e 20 72 75 6e 6e 69 6e 67 20 61 20   even running a 
21b0: 66 75 6c 6c 20 72 65 67 72 65 73 73 69 6f 6e 20  full regression 
21c0: 74 65 73 74 2e 0a 2a 2a 20 54 68 65 20 64 65 66  test..** The def
21d0: 61 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 20 6f 66  ault location of
21e0: 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 69 73   PENDING_BYTE is
21f0: 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 20   the first byte 
2200: 70 61 73 74 20 74 68 65 0a 2a 2a 20 31 47 42 20  past the.** 1GB 
2210: 62 6f 75 6e 64 61 72 79 2e 0a 2a 2a 0a 2a 2f 0a  boundary..**.*/.
2220: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 54  #ifndef SQLITE_T
2230: 45 53 54 0a 23 64 65 66 69 6e 65 20 50 45 4e 44  EST.#define PEND
2240: 49 4e 47 5f 42 59 54 45 20 20 20 20 20 20 30 78  ING_BYTE      0x
2250: 34 30 30 30 30 30 30 30 20 20 2f 2a 20 46 69 72  40000000  /* Fir
2260: 73 74 20 62 79 74 65 20 70 61 73 74 20 74 68 65  st byte past the
2270: 20 31 47 42 20 62 6f 75 6e 64 61 72 79 20 2a 2f   1GB boundary */
2280: 0a 23 65 6c 73 65 0a 65 78 74 65 72 6e 20 75 6e  .#else.extern un
2290: 73 69 67 6e 65 64 20 69 6e 74 20 73 71 6c 69 74  signed int sqlit
22a0: 65 33 5f 70 65 6e 64 69 6e 67 5f 62 79 74 65 3b  e3_pending_byte;
22b0: 0a 23 64 65 66 69 6e 65 20 50 45 4e 44 49 4e 47  .#define PENDING
22c0: 5f 42 59 54 45 20 73 71 6c 69 74 65 33 5f 70 65  _BYTE sqlite3_pe
22d0: 6e 64 69 6e 67 5f 62 79 74 65 0a 23 65 6e 64 69  nding_byte.#endi
22e0: 66 0a 0a 23 64 65 66 69 6e 65 20 52 45 53 45 52  f..#define RESER
22f0: 56 45 44 5f 42 59 54 45 20 20 20 20 20 28 50 45  VED_BYTE     (PE
2300: 4e 44 49 4e 47 5f 42 59 54 45 2b 31 29 0a 23 64  NDING_BYTE+1).#d
2310: 65 66 69 6e 65 20 53 48 41 52 45 44 5f 46 49 52  efine SHARED_FIR
2320: 53 54 20 20 20 20 20 20 28 50 45 4e 44 49 4e 47  ST      (PENDING
2330: 5f 42 59 54 45 2b 32 29 0a 23 64 65 66 69 6e 65  _BYTE+2).#define
2340: 20 53 48 41 52 45 44 5f 53 49 5a 45 20 20 20 20   SHARED_SIZE    
2350: 20 20 20 35 31 30 0a 0a 2f 2a 20 0a 2a 2a 20 46     510../* .** F
2360: 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 61 63 63  unctions for acc
2370: 65 73 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 66  essing sqlite3_f
2380: 69 6c 65 20 6d 65 74 68 6f 64 73 20 0a 2a 2f 0a  ile methods .*/.
2390: 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f  int sqlite3OsClo
23a0: 73 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a  se(sqlite3_file*
23b0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73  );.int sqlite3Os
23c0: 52 65 61 64 28 73 71 6c 69 74 65 33 5f 66 69 6c  Read(sqlite3_fil
23d0: 65 2a 2c 20 76 6f 69 64 2a 2c 20 69 6e 74 20 61  e*, void*, int a
23e0: 6d 74 2c 20 69 36 34 20 6f 66 66 73 65 74 29 3b  mt, i64 offset);
23f0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 57 72  .int sqlite3OsWr
2400: 69 74 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65  ite(sqlite3_file
2410: 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20  *, const void*, 
2420: 69 6e 74 20 61 6d 74 2c 20 69 36 34 20 6f 66 66  int amt, i64 off
2430: 73 65 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  set);.int sqlite
2440: 33 4f 73 54 72 75 6e 63 61 74 65 28 73 71 6c 69  3OsTruncate(sqli
2450: 74 65 33 5f 66 69 6c 65 2a 2c 20 69 36 34 20 73  te3_file*, i64 s
2460: 69 7a 65 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  ize);.int sqlite
2470: 33 4f 73 53 79 6e 63 28 73 71 6c 69 74 65 33 5f  3OsSync(sqlite3_
2480: 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74  file*, int);.int
2490: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69   sqlite3OsFileSi
24a0: 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a  ze(sqlite3_file*
24b0: 2c 20 69 36 34 20 2a 70 53 69 7a 65 29 3b 0a 69  , i64 *pSize);.i
24c0: 6e 74 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b  nt sqlite3OsLock
24d0: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 2c 20  (sqlite3_file*, 
24e0: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  int);.int sqlite
24f0: 33 4f 73 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65  3OsUnlock(sqlite
2500: 33 5f 66 69 6c 65 2a 2c 20 69 6e 74 29 3b 0a 69  3_file*, int);.i
2510: 6e 74 20 73 71 6c 69 74 65 33 4f 73 43 68 65 63  nt sqlite3OsChec
2520: 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 73 71  kReservedLock(sq
2530: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64 2c 20  lite3_file *id, 
2540: 69 6e 74 20 2a 70 52 65 73 4f 75 74 29 3b 0a 69  int *pResOut);.i
2550: 6e 74 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65  nt sqlite3OsFile
2560: 43 6f 6e 74 72 6f 6c 28 73 71 6c 69 74 65 33 5f  Control(sqlite3_
2570: 66 69 6c 65 2a 2c 69 6e 74 2c 76 6f 69 64 2a 29  file*,int,void*)
2580: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 53  ;.int sqlite3OsS
2590: 65 63 74 6f 72 53 69 7a 65 28 73 71 6c 69 74 65  ectorSize(sqlite
25a0: 33 5f 66 69 6c 65 20 2a 69 64 29 3b 0a 69 6e 74  3_file *id);.int
25b0: 20 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65   sqlite3OsDevice
25c0: 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28  Characteristics(
25d0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69 64  sqlite3_file *id
25e0: 29 3b 0a 0a 2f 2a 20 0a 2a 2a 20 46 75 6e 63 74  );../* .** Funct
25f0: 69 6f 6e 73 20 66 6f 72 20 61 63 63 65 73 73 69  ions for accessi
2600: 6e 67 20 73 71 6c 69 74 65 33 5f 76 66 73 20 6d  ng sqlite3_vfs m
2610: 65 74 68 6f 64 73 20 0a 2a 2f 0a 69 6e 74 20 73  ethods .*/.int s
2620: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 73 71 6c  qlite3OsOpen(sql
2630: 69 74 65 33 5f 76 66 73 20 2a 2c 20 63 6f 6e 73  ite3_vfs *, cons
2640: 74 20 63 68 61 72 20 2a 2c 20 73 71 6c 69 74 65  t char *, sqlite
2650: 33 5f 66 69 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e  3_file*, int, in
2660: 74 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  t *);.int sqlite
2670: 33 4f 73 44 65 6c 65 74 65 28 73 71 6c 69 74 65  3OsDelete(sqlite
2680: 33 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 74 20 63  3_vfs *, const c
2690: 68 61 72 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74  har *, int);.int
26a0: 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73   sqlite3OsAccess
26b0: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2c 20  (sqlite3_vfs *, 
26c0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 6e  const char *, in
26d0: 74 2c 20 69 6e 74 20 2a 70 52 65 73 4f 75 74 29  t, int *pResOut)
26e0: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 46  ;.int sqlite3OsF
26f0: 75 6c 6c 50 61 74 68 6e 61 6d 65 28 73 71 6c 69  ullPathname(sqli
2700: 74 65 33 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 74  te3_vfs *, const
2710: 20 63 68 61 72 20 2a 2c 20 69 6e 74 2c 20 63 68   char *, int, ch
2720: 61 72 20 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53  ar *);.#ifndef S
2730: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f  QLITE_OMIT_LOAD_
2740: 45 58 54 45 4e 53 49 4f 4e 0a 76 6f 69 64 20 2a  EXTENSION.void *
2750: 73 71 6c 69 74 65 33 4f 73 44 6c 4f 70 65 6e 28  sqlite3OsDlOpen(
2760: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2c 20 63  sqlite3_vfs *, c
2770: 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 76 6f  onst char *);.vo
2780: 69 64 20 73 71 6c 69 74 65 33 4f 73 44 6c 45 72  id sqlite3OsDlEr
2790: 72 6f 72 28 73 71 6c 69 74 65 33 5f 76 66 73 20  ror(sqlite3_vfs 
27a0: 2a 2c 20 69 6e 74 2c 20 63 68 61 72 20 2a 29 3b  *, int, char *);
27b0: 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4f 73  .void *sqlite3Os
27c0: 44 6c 53 79 6d 28 73 71 6c 69 74 65 33 5f 76 66  DlSym(sqlite3_vf
27d0: 73 20 2a 2c 20 76 6f 69 64 20 2a 2c 20 63 6f 6e  s *, void *, con
27e0: 73 74 20 63 68 61 72 20 2a 29 3b 0a 76 6f 69 64  st char *);.void
27f0: 20 73 71 6c 69 74 65 33 4f 73 44 6c 43 6c 6f 73   sqlite3OsDlClos
2800: 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2c  e(sqlite3_vfs *,
2810: 20 76 6f 69 64 20 2a 29 3b 0a 23 65 6e 64 69 66   void *);.#endif
2820: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
2830: 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e 20 2a  LOAD_EXTENSION *
2840: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f 73 52  /.int sqlite3OsR
2850: 61 6e 64 6f 6d 6e 65 73 73 28 73 71 6c 69 74 65  andomness(sqlite
2860: 33 5f 76 66 73 20 2a 2c 20 69 6e 74 2c 20 63 68  3_vfs *, int, ch
2870: 61 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  ar *);.int sqlit
2880: 65 33 4f 73 53 6c 65 65 70 28 73 71 6c 69 74 65  e3OsSleep(sqlite
2890: 33 5f 76 66 73 20 2a 2c 20 69 6e 74 29 3b 0a 69  3_vfs *, int);.i
28a0: 6e 74 20 73 71 6c 69 74 65 33 4f 73 43 75 72 72  nt sqlite3OsCurr
28b0: 65 6e 74 54 69 6d 65 28 73 71 6c 69 74 65 33 5f  entTime(sqlite3_
28c0: 76 66 73 20 2a 2c 20 64 6f 75 62 6c 65 2a 29 3b  vfs *, double*);
28d0: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 6e 69 65  ../*.** Convenie
28e0: 6e 63 65 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f  nce functions fo
28f0: 72 20 6f 70 65 6e 69 6e 67 20 61 6e 64 20 63 6c  r opening and cl
2900: 6f 73 69 6e 67 20 66 69 6c 65 73 20 75 73 69 6e  osing files usin
2910: 67 20 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61  g .** sqlite3_ma
2920: 6c 6c 6f 63 28 29 20 74 6f 20 6f 62 74 61 69 6e  lloc() to obtain
2930: 20 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 66   space for the f
2940: 69 6c 65 2d 68 61 6e 64 6c 65 20 73 74 72 75 63  ile-handle struc
2950: 74 75 72 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ture..*/.int sql
2960: 69 74 65 33 4f 73 4f 70 65 6e 4d 61 6c 6c 6f 63  ite3OsOpenMalloc
2970: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 2c 20  (sqlite3_vfs *, 
2980: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 73 71  const char *, sq
2990: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 2a 2c 20 69  lite3_file **, i
29a0: 6e 74 2c 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71  nt,int*);.int sq
29b0: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 46 72 65 65  lite3OsCloseFree
29c0: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29  (sqlite3_file *)
29d0: 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 53 51  ;..#endif /* _SQ
29e0: 4c 49 54 45 5f 4f 53 5f 48 5f 20 2a 2f 0a        LITE_OS_H_ */.