Documentation Source Text

Hex Artifact Content
Login

Artifact c41c056e4297b5f8a8f484a6ed3c2e60c0fdeda3:


0000: 3c 74 69 74 6c 65 3e 43 6f 6d 70 69 6c 61 74 69  <title>Compilati
0010: 6f 6e 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53  on Options For S
0020: 51 4c 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 3c 74  QLite</title>.<t
0030: 63 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b  cl>hd_keywords {
0040: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
0050: 69 6f 6e 73 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 31  ions}</tcl>..<h1
0060: 3e 31 2e 30 20 43 6f 6d 70 69 6c 61 74 69 6f 6e  >1.0 Compilation
0070: 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53 51 4c   Options For SQL
0080: 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a 46 6f  ite</h1>..<p>.Fo
0090: 72 20 6d 6f 73 74 20 70 75 72 70 6f 73 65 73 2c  r most purposes,
00a0: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 62   SQLite can be b
00b0: 75 69 6c 74 20 6a 75 73 74 20 66 69 6e 65 20 75  uilt just fine u
00c0: 73 69 6e 67 20 74 68 65 20 64 65 66 61 75 6c 74  sing the default
00d0: 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74  .compilation opt
00e0: 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69  ions. However, i
00f0: 66 20 72 65 71 75 69 72 65 64 2c 20 74 68 65 20  f required, the 
0100: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
0110: 69 6f 6e 73 0a 64 6f 63 75 6d 65 6e 74 65 64 20  ions.documented 
0120: 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 75 73 65  below can be use
0130: 64 20 74 6f 20 0a 3c 61 20 68 72 65 66 3d 22 23  d to .<a href="#
0140: 6f 6d 69 74 66 65 61 74 75 72 65 73 22 3e 6f 6d  omitfeatures">om
0150: 69 74 20 53 51 4c 69 74 65 20 66 65 61 74 75 72  it SQLite featur
0160: 65 73 3c 2f 61 3e 20 28 72 65 73 75 6c 74 69 6e  es</a> (resultin
0170: 67 20 69 6e 0a 61 20 5b 72 65 6c 66 6f 6f 74 70  g in.a [relfootp
0180: 72 69 6e 74 20 7c 20 73 6d 61 6c 6c 65 72 20 63  rint | smaller c
0190: 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72 79 20  ompiled library 
01a0: 73 69 7a 65 5d 29 20 6f 72 20 74 6f 20 63 68 61  size]) or to cha
01b0: 6e 67 65 20 74 68 65 0a 3c 61 20 68 72 65 66 3d  nge the.<a href=
01c0: 22 23 64 65 66 61 75 6c 74 73 22 3e 64 65 66 61  "#defaults">defa
01d0: 75 6c 74 20 76 61 6c 75 65 73 3c 2f 61 3e 20 6f  ult values</a> o
01e0: 66 20 73 6f 6d 65 20 70 61 72 61 6d 65 74 65 72  f some parameter
01f0: 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76 65  s..</p>..<p>.Eve
0200: 72 79 20 65 66 66 6f 72 74 20 68 61 73 20 62 65  ry effort has be
0210: 65 6e 20 6d 61 64 65 20 74 6f 20 65 6e 73 75 72  en made to ensur
0220: 65 20 74 68 61 74 20 74 68 65 20 76 61 72 69 6f  e that the vario
0230: 75 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 0a  us combinations.
0240: 6f 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  of compilation o
0250: 70 74 69 6f 6e 73 20 77 6f 72 6b 20 68 61 72 6d  ptions work harm
0260: 6f 6e 69 6f 75 73 6c 79 20 61 6e 64 20 70 72 6f  oniously and pro
0270: 64 75 63 65 20 61 20 77 6f 72 6b 69 6e 67 20 6c  duce a working l
0280: 69 62 72 61 72 79 2e 0a 4e 65 76 65 72 74 68 65  ibrary..Neverthe
0290: 6c 65 73 73 2c 20 69 74 20 69 73 20 73 74 72 6f  less, it is stro
02a0: 6e 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64  ngly recommended
02b0: 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65   that the SQLite
02c0: 20 74 65 73 74 2d 73 75 69 74 65 0a 62 65 20 65   test-suite.be e
02d0: 78 65 63 75 74 65 64 20 74 6f 20 63 68 65 63 6b  xecuted to check
02e0: 20 66 6f 72 20 65 72 72 6f 72 73 20 62 65 66 6f   for errors befo
02f0: 72 65 20 75 73 69 6e 67 20 61 6e 20 53 51 4c 69  re using an SQLi
0300: 74 65 20 6c 69 62 72 61 72 79 20 62 75 69 6c 74  te library built
0310: 0a 77 69 74 68 20 6e 6f 6e 2d 73 74 61 6e 64 61  .with non-standa
0320: 72 64 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  rd compilation o
0330: 70 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 0a 3c 74  ptions..</p>..<t
0340: 63 6c 3e 0a 70 72 6f 63 20 43 4f 4d 50 49 4c 45  cl>.proc COMPILE
0350: 5f 4f 50 54 49 4f 4e 20 7b 6e 61 6d 65 20 74 65  _OPTION {name te
0360: 78 74 7d 20 7b 0a 20 20 69 66 20 7b 5b 72 65 67  xt} {.  if {[reg
0370: 65 78 70 20 7b 28 53 51 4c 49 54 45 7c 48 41 56  exp {(SQLITE|HAV
0380: 45 29 5f 28 5b 41 2d 5a 30 2d 39 5f 5d 2b 29 7d  E)_([A-Z0-9_]+)}
0390: 20 24 6e 61 6d 65 20 61 6c 6c 20 70 72 65 66 69   $name all prefi
03a0: 78 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20  x label]} {.    
03b0: 68 64 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72  hd_fragment [str
03c0: 69 6e 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62  ing tolower $lab
03d0: 65 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f  el].    hd_keywo
03e0: 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 69  rds $all.  }.  i
03f0: 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e 59 59 28  f {[regexp {^YY(
0400: 5b 41 2d 5a 30 2d 39 5f 5d 2b 29 7d 20 24 6e 61  [A-Z0-9_]+)} $na
0410: 6d 65 20 61 6c 6c 20 6c 61 62 65 6c 5d 7d 20 7b  me all label]} {
0420: 0a 20 20 20 20 68 64 5f 66 72 61 67 6d 65 6e 74  .    hd_fragment
0430: 20 5b 73 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72   [string tolower
0440: 20 24 61 6c 6c 5d 0a 20 20 20 20 68 64 5f 6b 65   $all].    hd_ke
0450: 79 77 6f 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a  ywords $all.  }.
0460: 20 20 68 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e    hd_puts <p><b>
0470: 24 6e 61 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20  $name</b></p>.  
0480: 72 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c  regsub -all "\n\
0490: 5c 73 2a 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f  \s*\n" $text "</
04a0: 70 3e 5c 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a  p>\n\n<p>" text.
04b0: 20 20 68 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c    hd_resolve <bl
04c0: 6f 63 6b 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78  ockquote><p>$tex
04d0: 74 3c 2f 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  t</p></blockquot
04e0: 65 3e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20  e>.}.</tcl>..<a 
04f0: 6e 61 6d 65 3d 22 6f 73 63 6f 6e 66 69 67 22 3e  name="osconfig">
0500: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 50 6c 61  </a>.<h2>1.1 Pla
0510: 74 66 6f 72 6d 20 43 6f 6e 66 69 67 75 72 61 74  tform Configurat
0520: 69 6f 6e 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a  ion</h2>..<tcl>.
0530: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
0540: 5f 48 41 56 45 5f 53 51 4c 49 54 45 5f 43 4f 4e  _HAVE_SQLITE_CON
0550: 46 49 47 5f 48 7d 20 7b 0a 20 20 49 66 20 74 68  FIG_H} {.  If th
0560: 65 20 5f 48 41 56 45 5f 53 51 4c 49 54 45 5f 43  e _HAVE_SQLITE_C
0570: 4f 4e 46 49 47 5f 48 20 6d 61 63 72 6f 20 69 73  ONFIG_H macro is
0580: 20 64 65 66 69 6e 65 64 0a 20 20 74 68 65 6e 20   defined.  then 
0590: 74 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63  the SQLite sourc
05a0: 65 20 63 6f 64 65 20 77 69 6c 6c 20 61 74 74 65  e code will atte
05b0: 6d 70 74 20 74 6f 20 23 69 6e 63 6c 75 64 65 20  mpt to #include 
05c0: 61 20 66 69 6c 65 20 6e 61 6d 65 64 20 22 63 6f  a file named "co
05d0: 6e 66 69 67 2e 68 22 2e 0a 20 20 54 68 65 20 22  nfig.h"..  The "
05e0: 63 6f 6e 66 69 67 2e 68 22 20 66 69 6c 65 20 75  config.h" file u
05f0: 73 75 61 6c 6c 79 20 63 6f 6e 74 61 69 6e 73 20  sually contains 
0600: 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74  other configurat
0610: 69 6f 6e 20 6f 70 74 69 6f 6e 73 2c 20 65 73 70  ion options, esp
0620: 65 63 69 61 6c 6c 79 0a 20 20 22 48 41 56 45 5f  ecially.  "HAVE_
0630: 3c 69 3e 49 4e 54 45 52 46 41 43 45 3c 2f 69 3e  <i>INTERFACE</i>
0640: 22 20 74 79 70 65 20 6f 70 74 69 6f 6e 73 20 67  " type options g
0650: 65 6e 65 72 61 74 65 64 20 62 79 20 61 75 74 6f  enerated by auto
0660: 63 6f 6e 66 20 73 63 72 69 70 74 73 2e 0a 7d 0a  conf scripts..}.
0670: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
0680: 7b 48 41 56 45 5f 46 44 41 54 41 53 59 4e 43 7d  {HAVE_FDATASYNC}
0690: 20 7b 0a 20 20 49 66 20 74 68 65 20 48 41 56 45   {.  If the HAVE
06a0: 5f 46 44 41 54 41 53 59 4e 43 20 63 6f 6d 70 69  _FDATASYNC compi
06b0: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69  le-time option i
06c0: 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65  s true, then the
06d0: 20 64 65 66 61 75 6c 74 20 5b 56 46 53 5d 0a 20   default [VFS]. 
06e0: 20 66 6f 72 20 75 6e 69 78 20 73 79 73 74 65 6d   for unix system
06f0: 73 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 74  s will attempt t
0700: 6f 20 75 73 65 20 66 64 61 74 61 73 79 6e 63 28  o use fdatasync(
0710: 29 20 69 6e 73 74 65 61 64 20 6f 66 20 66 73 79  ) instead of fsy
0720: 6e 63 28 29 20 77 68 65 72 65 0a 20 20 61 70 70  nc() where.  app
0730: 72 6f 70 72 69 61 74 65 2e 20 20 49 66 20 74 68  ropriate.  If th
0740: 69 73 20 66 6c 61 67 20 69 73 20 6d 69 73 73 69  is flag is missi
0750: 6e 67 20 6f 72 20 66 61 6c 73 65 2c 20 74 68 65  ng or false, the
0760: 6e 20 66 73 79 6e 63 28 29 20 69 73 20 61 6c 77  n fsync() is alw
0770: 61 79 73 20 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d  ays used..}..COM
0780: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 48 41 56  PILE_OPTION {HAV
0790: 45 5f 47 4d 54 49 4d 45 5f 52 7d 20 7b 0a 20 20  E_GMTIME_R} {.  
07a0: 49 66 20 74 68 65 20 48 41 56 45 5f 47 4d 54 49  If the HAVE_GMTI
07b0: 4d 45 5f 52 20 6f 70 74 69 6f 6e 20 69 73 20 74  ME_R option is t
07c0: 72 75 65 20 61 6e 64 20 69 66 20 5b 53 51 4c 49  rue and if [SQLI
07d0: 54 45 5f 4f 4d 49 54 5f 44 41 54 45 54 49 4d 45  TE_OMIT_DATETIME
07e0: 5f 46 55 4e 43 53 5d 20 69 73 20 74 72 75 65 2c  _FUNCS] is true,
07f0: 0a 20 20 74 68 65 6e 20 74 68 65 20 43 55 52 52  .  then the CURR
0800: 45 4e 54 5f 54 49 4d 45 2c 20 43 55 52 52 45 4e  ENT_TIME, CURREN
0810: 54 5f 44 41 54 45 2c 20 61 6e 64 20 43 55 52 52  T_DATE, and CURR
0820: 45 4e 54 5f 54 49 4d 45 53 54 41 4d 50 20 6b 65  ENT_TIMESTAMP ke
0830: 79 77 6f 72 64 73 20 77 69 6c 6c 20 75 73 65 0a  ywords will use.
0840: 20 20 74 68 65 20 74 68 72 65 61 64 73 61 66 65    the threadsafe
0850: 20 22 67 6d 74 69 6d 65 5f 72 28 29 22 20 69 6e   "gmtime_r()" in
0860: 74 65 72 66 61 63 65 20 72 61 74 68 65 72 20 74  terface rather t
0870: 68 61 6e 20 22 67 6d 74 69 6d 65 28 29 22 2e 20  han "gmtime()". 
0880: 20 49 6e 20 74 68 65 20 75 73 75 61 6c 20 63 61   In the usual ca
0890: 73 65 0a 20 20 77 68 65 72 65 20 5b 53 51 4c 49  se.  where [SQLI
08a0: 54 45 5f 4f 4d 49 54 5f 44 41 54 45 54 49 4d 45  TE_OMIT_DATETIME
08b0: 5f 46 55 4e 43 53 5d 20 69 73 20 6e 6f 74 20 64  _FUNCS] is not d
08c0: 65 66 69 6e 65 64 20 6f 72 20 69 73 20 66 61 6c  efined or is fal
08d0: 73 65 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 62  se, then the.  b
08e0: 75 69 6c 74 2d 69 6e 20 5b 64 61 74 65 20 61 6e  uilt-in [date an
08f0: 64 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73  d time functions
0900: 5d 20 61 72 65 20 75 73 65 64 20 74 6f 20 69 6d  ] are used to im
0910: 70 6c 65 6d 65 6e 74 20 74 68 65 20 43 55 52 52  plement the CURR
0920: 45 4e 54 5f 54 49 4d 45 2c 0a 20 20 43 55 52 52  ENT_TIME,.  CURR
0930: 45 4e 54 5f 44 41 54 45 2c 20 61 6e 64 20 43 55  ENT_DATE, and CU
0940: 52 52 45 4e 54 5f 54 49 4d 45 53 54 41 4d 50 20  RRENT_TIMESTAMP 
0950: 6b 65 79 77 6f 72 64 73 20 61 6e 64 20 6e 65 69  keywords and nei
0960: 74 68 65 72 20 67 6d 74 69 6d 65 5f 72 28 29 20  ther gmtime_r() 
0970: 6e 6f 72 0a 20 20 67 6d 74 69 6d 65 28 29 20 69  nor.  gmtime() i
0980: 73 20 65 76 65 72 20 63 61 6c 6c 65 64 2e 0a 7d  s ever called..}
0990: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
09a0: 20 7b 48 41 56 45 5f 49 53 4e 41 4e 7d 20 7b 0a   {HAVE_ISNAN} {.
09b0: 20 20 49 66 20 74 68 65 20 48 41 56 45 5f 49 53    If the HAVE_IS
09c0: 4e 41 4e 20 6f 70 74 69 6f 6e 20 69 73 20 74 72  NAN option is tr
09d0: 75 65 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20  ue, then SQLite 
09e0: 69 6e 76 6f 6b 65 73 20 74 68 65 20 73 79 73 74  invokes the syst
09f0: 65 6d 20 6c 69 62 72 61 72 79 20 69 73 6e 61 6e  em library isnan
0a00: 28 29 0a 20 20 66 75 6e 63 74 69 6f 6e 20 74 6f  ().  function to
0a10: 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 20   determine if a 
0a20: 64 6f 75 62 6c 65 2d 70 72 65 63 69 73 69 6f 6e  double-precision
0a30: 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20   floating point 
0a40: 76 61 6c 75 65 20 69 73 20 61 20 4e 61 4e 2e 0a  value is a NaN..
0a50: 20 20 49 66 20 48 41 56 45 5f 49 53 4e 41 4e 20    If HAVE_ISNAN 
0a60: 69 73 20 75 6e 64 65 66 69 6e 65 64 20 6f 72 20  is undefined or 
0a70: 66 61 6c 73 65 2c 20 74 68 65 6e 20 53 51 4c 69  false, then SQLi
0a80: 74 65 20 73 75 62 73 74 69 74 75 74 65 73 20 69  te substitutes i
0a90: 74 73 20 6f 77 6e 20 68 6f 6d 65 2d 67 72 6f 77  ts own home-grow
0aa0: 6e 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  n.  implementati
0ab0: 6f 6e 20 6f 66 20 69 73 6e 61 6e 28 29 2e 0a 7d  on of isnan()..}
0ac0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
0ad0: 20 7b 48 41 56 45 5f 4c 4f 43 41 4c 54 49 4d 45   {HAVE_LOCALTIME
0ae0: 5f 52 7d 20 7b 0a 20 20 49 66 20 74 68 65 20 48  _R} {.  If the H
0af0: 41 56 45 5f 4c 4f 43 41 4c 54 49 4d 45 5f 52 20  AVE_LOCALTIME_R 
0b00: 6f 70 74 69 6f 6e 20 69 73 20 74 72 75 65 2c 20  option is true, 
0b10: 74 68 65 6e 20 53 51 4c 69 74 65 20 75 73 65 73  then SQLite uses
0b20: 20 74 68 65 20 74 68 72 65 61 64 73 61 66 65 0a   the threadsafe.
0b30: 20 20 6c 6f 63 61 6c 74 69 6d 65 5f 72 28 29 20    localtime_r() 
0b40: 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 20  library routine 
0b50: 69 6e 73 74 65 61 64 20 6f 66 20 6c 6f 63 61 6c  instead of local
0b60: 74 69 6d 65 28 29 0a 20 20 74 6f 20 68 65 6c 70  time().  to help
0b70: 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 5b   implement the [
0b80: 6c 6f 63 61 6c 74 69 6d 65 20 6d 6f 64 69 66 69  localtime modifi
0b90: 65 72 5d 0a 20 20 74 6f 20 74 68 65 20 62 75 69  er].  to the bui
0ba0: 6c 74 2d 69 6e 20 5b 64 61 74 65 20 61 6e 64 20  lt-in [date and 
0bb0: 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73 5d 2e  time functions].
0bc0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
0bd0: 4f 4e 20 7b 48 41 56 45 5f 4c 4f 43 41 4c 54 49  ON {HAVE_LOCALTI
0be0: 4d 45 5f 53 7d 20 7b 0a 20 20 49 66 20 74 68 65  ME_S} {.  If the
0bf0: 20 48 41 56 45 5f 4c 4f 43 41 4c 54 49 4d 45 5f   HAVE_LOCALTIME_
0c00: 53 20 6f 70 74 69 6f 6e 20 69 73 20 74 72 75 65  S option is true
0c10: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 75 73  , then SQLite us
0c20: 65 73 20 74 68 65 20 74 68 72 65 61 64 73 61 66  es the threadsaf
0c30: 65 0a 20 20 6c 6f 63 61 6c 74 69 6d 65 5f 73 28  e.  localtime_s(
0c40: 29 20 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e  ) library routin
0c50: 65 20 69 6e 73 74 65 61 64 20 6f 66 20 6c 6f 63  e instead of loc
0c60: 61 6c 74 69 6d 65 28 29 0a 20 20 74 6f 20 68 65  altime().  to he
0c70: 6c 70 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65  lp implement the
0c80: 20 5b 6c 6f 63 61 6c 74 69 6d 65 20 6d 6f 64 69   [localtime modi
0c90: 66 69 65 72 5d 0a 20 20 74 6f 20 74 68 65 20 62  fier].  to the b
0ca0: 75 69 6c 74 2d 69 6e 20 5b 64 61 74 65 20 61 6e  uilt-in [date an
0cb0: 64 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73  d time functions
0cc0: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
0cd0: 54 49 4f 4e 20 7b 48 41 56 45 5f 4d 41 4c 4c 4f  TION {HAVE_MALLO
0ce0: 43 5f 55 53 41 42 4c 45 5f 53 49 5a 45 7d 20 7b  C_USABLE_SIZE} {
0cf0: 0a 20 20 49 66 20 74 68 65 20 48 41 56 45 5f 4d  .  If the HAVE_M
0d00: 41 4c 4c 4f 43 5f 55 53 41 42 4c 45 5f 53 49 5a  ALLOC_USABLE_SIZ
0d10: 45 20 6f 70 74 69 6f 6e 20 69 73 20 74 72 75 65  E option is true
0d20: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 74 72  , then SQLite tr
0d30: 69 65 73 20 75 73 65 73 20 74 68 65 0a 20 20 6d  ies uses the.  m
0d40: 61 6c 6c 6f 63 5f 75 73 61 62 6c 65 5f 73 69 7a  alloc_usable_siz
0d50: 65 28 29 20 69 6e 74 65 72 66 61 63 65 20 74 6f  e() interface to
0d60: 20 66 69 6e 64 20 74 68 65 20 73 69 7a 65 20 6f   find the size o
0d70: 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  f a memory alloc
0d80: 61 74 69 6f 6e 20 6f 62 74 61 69 6e 65 64 0a 20  ation obtained. 
0d90: 20 66 72 6f 6d 20 74 68 65 20 73 74 61 6e 64 61   from the standa
0da0: 72 64 2d 6c 69 62 72 61 72 79 20 6d 61 6c 6c 6f  rd-library mallo
0db0: 63 28 29 20 6f 72 20 72 65 61 6c 6c 6f 63 28 29  c() or realloc()
0dc0: 20 72 6f 75 74 69 6e 65 73 2e 20 20 54 68 69 73   routines.  This
0dd0: 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 0a   option is only.
0de0: 20 20 61 70 70 6c 69 63 61 62 6c 65 20 69 66 20    applicable if 
0df0: 74 68 65 20 73 74 61 6e 64 61 72 64 2d 6c 69 62  the standard-lib
0e00: 72 61 72 79 20 6d 61 6c 6c 6f 63 28 29 20 69 73  rary malloc() is
0e10: 20 75 73 65 64 2e 20 20 4f 6e 20 41 70 70 6c 79   used.  On Apply
0e20: 20 73 79 73 74 65 6d 73 2c 0a 20 20 22 7a 6f 6e   systems,.  "zon
0e30: 65 20 6d 61 6c 6c 6f 63 22 20 69 73 20 75 73 65  e malloc" is use
0e40: 64 20 69 6e 73 74 65 61 64 2c 20 61 6e 64 20 73  d instead, and s
0e50: 6f 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  o this option is
0e60: 20 6e 6f 74 20 61 70 70 6c 69 63 61 62 6c 65 2e   not applicable.
0e70: 20 20 41 6e 64 2c 20 6f 66 0a 20 20 63 6f 75 72    And, of.  cour
0e80: 73 65 2c 20 69 66 20 74 68 65 20 61 70 70 6c 69  se, if the appli
0e90: 63 61 74 69 6f 6e 20 73 75 70 70 6c 69 65 73 20  cation supplies 
0ea0: 69 74 73 20 6f 77 6e 20 6d 61 6c 6c 6f 63 20 69  its own malloc i
0eb0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 75 73  mplementation us
0ec0: 69 6e 67 0a 20 20 5b 53 51 4c 49 54 45 5f 43 4f  ing.  [SQLITE_CO
0ed0: 4e 46 49 47 5f 4d 41 4c 4c 4f 43 5d 20 74 68 65  NFIG_MALLOC] the
0ee0: 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 68 61  n this option ha
0ef0: 73 20 6e 6f 20 65 66 66 65 63 74 2e 0a 20 20 3c  s no effect..  <
0f00: 70 3e 0a 20 20 49 66 20 74 68 65 20 48 41 56 45  p>.  If the HAVE
0f10: 5f 4d 41 4c 4c 4f 43 5f 55 53 41 42 4c 45 5f 53  _MALLOC_USABLE_S
0f20: 49 5a 45 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6d  IZE option is om
0f30: 69 74 74 65 64 20 6f 72 20 69 73 20 66 61 6c 73  itted or is fals
0f40: 65 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 0a  e, then SQLite .
0f50: 20 20 75 73 65 73 20 61 20 77 72 61 70 70 65 72    uses a wrapper
0f60: 20 61 72 6f 75 6e 64 20 73 79 73 74 65 6d 20 6d   around system m
0f70: 61 6c 6c 6f 63 28 29 20 61 6e 64 20 72 65 61 6c  alloc() and real
0f80: 6c 6f 63 28 29 20 74 68 61 74 20 65 6e 6c 61 72  loc() that enlar
0f90: 67 65 73 20 65 61 63 68 20 61 6c 6c 6f 63 61 74  ges each allocat
0fa0: 69 6f 6e 0a 20 20 62 79 20 38 20 62 79 74 65 73  ion.  by 8 bytes
0fb0: 20 61 6e 64 20 77 72 69 74 65 73 20 74 68 65 20   and writes the 
0fc0: 73 69 7a 65 20 6f 66 20 74 68 65 20 61 6c 6c 6f  size of the allo
0fd0: 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 69 6e  cation in the in
0fe0: 69 74 69 61 6c 20 38 20 62 79 74 65 73 2c 20 61  itial 8 bytes, a
0ff0: 6e 64 0a 20 20 74 68 65 6e 20 53 51 4c 69 74 65  nd.  then SQLite
1000: 20 61 6c 73 6f 20 69 6d 70 6c 65 6d 65 6e 74 73   also implements
1010: 20 69 74 73 20 6f 77 6e 20 68 6f 6d 65 2d 67 72   its own home-gr
1020: 6f 77 6e 20 76 65 72 73 69 6f 6e 20 6f 66 20 6d  own version of m
1030: 61 6c 6c 6f 63 5f 75 73 61 62 6c 65 5f 73 69 7a  alloc_usable_siz
1040: 65 28 29 0a 20 20 74 68 61 74 20 63 6f 6e 73 75  e().  that consu
1050: 6c 74 73 20 74 68 61 74 20 38 2d 62 79 74 65 20  lts that 8-byte 
1060: 70 72 65 66 69 78 20 74 6f 20 66 69 6e 64 20 74  prefix to find t
1070: 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 69  he allocation si
1080: 7a 65 2e 20 20 54 68 69 73 20 61 70 70 72 6f 61  ze.  This approa
1090: 63 68 0a 20 20 77 6f 72 6b 73 20 62 75 74 20 69  ch.  works but i
10a0: 74 20 69 73 20 73 75 62 6f 70 74 69 6d 61 6c 2e  t is suboptimal.
10b0: 20 20 41 70 70 6c 69 63 61 74 69 6f 6e 73 20 61    Applications a
10c0: 72 65 20 65 6e 63 6f 75 72 61 67 65 64 20 74 6f  re encouraged to
10d0: 20 75 73 65 0a 20 20 48 41 56 45 5f 4d 41 4c 4c   use.  HAVE_MALL
10e0: 4f 43 5f 55 53 41 42 4c 45 5f 53 49 5a 45 20 77  OC_USABLE_SIZE w
10f0: 68 65 6e 65 76 65 72 20 70 6f 73 73 69 62 6c 65  henever possible
1100: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
1110: 49 4f 4e 20 7b 48 41 56 45 5f 53 54 52 43 48 52  ION {HAVE_STRCHR
1120: 4e 55 4c 7d 20 7b 0a 20 20 49 66 20 74 68 65 20  NUL} {.  If the 
1130: 48 41 56 45 5f 53 54 52 43 48 52 4e 55 4c 20 6f  HAVE_STRCHRNUL o
1140: 70 74 69 6f 6e 20 69 73 20 74 72 75 65 2c 20 74  ption is true, t
1150: 68 65 6e 20 53 51 4c 69 74 65 20 75 73 65 73 20  hen SQLite uses 
1160: 74 68 65 20 73 74 72 63 68 72 6e 75 6c 28 29 20  the strchrnul() 
1170: 6c 69 62 72 61 72 79 0a 20 20 66 75 6e 63 74 69  library.  functi
1180: 6f 6e 2e 20 20 49 66 20 74 68 69 73 20 6f 70 74  on.  If this opt
1190: 69 6f 6e 20 69 73 20 6d 69 73 73 69 6e 67 20 6f  ion is missing o
11a0: 72 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 53 51  r false, then SQ
11b0: 4c 69 74 65 20 73 75 62 73 74 69 74 75 74 65 73  Lite substitutes
11c0: 20 69 74 73 20 6f 77 6e 0a 20 20 68 6f 6d 65 2d   its own.  home-
11d0: 67 72 6f 77 6e 20 69 6d 70 6c 65 6d 65 6e 74 61  grown implementa
11e0: 74 69 6f 6e 20 6f 66 20 73 74 72 63 68 72 6e 75  tion of strchrnu
11f0: 6c 28 29 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  l()..}..COMPILE_
1200: 4f 50 54 49 4f 4e 20 7b 48 41 56 45 5f 55 53 4c  OPTION {HAVE_USL
1210: 45 45 50 7d 20 7b 0a 20 20 49 66 20 74 68 65 20  EEP} {.  If the 
1220: 48 41 56 45 5f 55 53 4c 45 45 50 20 6f 70 74 69  HAVE_USLEEP opti
1230: 6f 6e 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e  on is true, then
1240: 20 74 68 65 20 64 65 66 61 75 6c 74 20 75 6e 69   the default uni
1250: 78 20 56 46 53 20 75 73 65 73 20 74 68 65 0a 20  x VFS uses the. 
1260: 20 75 73 6c 65 65 70 28 29 20 73 79 73 74 65 6d   usleep() system
1270: 20 63 61 6c 6c 20 74 6f 20 69 6d 70 6c 65 6d 65   call to impleme
1280: 6e 74 20 74 68 65 20 78 53 6c 65 65 70 20 6d 65  nt the xSleep me
1290: 74 68 6f 64 2e 20 20 49 66 20 74 68 69 73 20 6f  thod.  If this o
12a0: 70 74 69 6f 6e 20 69 73 0a 20 20 75 6e 64 65 66  ption is.  undef
12b0: 69 6e 65 64 20 6f 72 20 66 61 6c 73 65 2c 20 74  ined or false, t
12c0: 68 65 6e 20 78 53 6c 65 65 70 20 6f 6e 20 75 6e  hen xSleep on un
12d0: 69 78 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65  ix is implemente
12e0: 64 20 75 73 69 6e 67 20 73 6c 65 65 70 28 29 20  d using sleep() 
12f0: 77 68 69 63 68 0a 20 20 6d 65 61 6e 73 20 74 68  which.  means th
1300: 61 74 20 5b 73 71 6c 69 74 65 33 5f 73 6c 65 65  at [sqlite3_slee
1310: 70 28 29 5d 20 77 69 6c 6c 20 68 61 76 65 20 61  p()] will have a
1320: 20 6d 69 6e 69 6d 75 6d 20 77 61 69 74 20 69 6e   minimum wait in
1330: 74 65 72 76 61 6c 20 6f 66 20 31 30 30 30 0a 20  terval of 1000. 
1340: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 72 65   milliseconds re
1350: 67 61 72 64 6c 65 73 73 20 6f 66 20 69 74 73 20  gardless of its 
1360: 61 72 67 75 6d 65 6e 74 2e 20 20 0a 7d 0a 0a 43  argument.  .}..C
1370: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 48  OMPILE_OPTION {H
1380: 41 56 45 5f 55 54 49 4d 45 7d 20 7b 0a 20 20 49  AVE_UTIME} {.  I
1390: 66 20 74 68 65 20 48 41 56 45 5f 55 54 49 4d 45  f the HAVE_UTIME
13a0: 20 6f 70 74 69 6f 6e 20 69 73 20 74 72 75 65 2c   option is true,
13b0: 20 74 68 65 6e 20 74 68 65 20 62 75 69 6c 74 2d   then the built-
13c0: 69 6e 20 62 75 74 20 6e 6f 6e 2d 73 74 61 6e 64  in but non-stand
13d0: 61 72 64 0a 20 20 22 75 6e 69 78 2d 64 6f 74 66  ard.  "unix-dotf
13e0: 69 6c 65 22 20 56 46 53 20 77 69 6c 6c 20 75 73  ile" VFS will us
13f0: 65 20 74 68 65 20 75 74 69 6d 65 28 29 20 73 79  e the utime() sy
1400: 73 74 65 6d 20 63 61 6c 6c 2c 20 69 6e 73 74 65  stem call, inste
1410: 61 64 20 6f 66 20 75 74 69 6d 65 73 28 29 2c 0a  ad of utimes(),.
1420: 20 20 74 6f 20 73 65 74 20 74 68 65 20 6c 61 73    to set the las
1430: 74 20 61 63 63 65 73 73 20 74 69 6d 65 20 6f 6e  t access time on
1440: 20 74 68 65 20 6c 6f 63 6b 20 66 69 6c 65 2e 0a   the lock file..
1450: 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d  }.</tcl>..<a nam
1460: 65 3d 22 64 65 66 61 75 6c 74 73 22 3e 3c 2f 61  e="defaults"></a
1470: 3e 0a 3c 68 32 3e 31 2e 32 20 4f 70 74 69 6f 6e  >.<h2>1.2 Option
1480: 73 20 54 6f 20 53 65 74 20 44 65 66 61 75 6c 74  s To Set Default
1490: 20 50 61 72 61 6d 65 74 65 72 20 56 61 6c 75 65   Parameter Value
14a0: 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 0a 43  s</h2>..<tcl>..C
14b0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
14c0: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55  QLITE_DEFAULT_AU
14d0: 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 3d 3c 69  TOMATIC_INDEX=<i
14e0: 3e 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c  >&lt;0 or 1&gt;<
14f0: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61  /i>} {.  This ma
1500: 63 72 6f 20 64 65 74 65 72 6d 69 6e 65 73 20 74  cro determines t
1510: 68 65 20 69 6e 69 74 69 61 6c 20 73 65 74 74 69  he initial setti
1520: 6e 67 20 66 6f 72 20 5b 50 52 41 47 4d 41 20 61  ng for [PRAGMA a
1530: 75 74 6f 6d 61 74 69 63 5f 69 6e 64 65 78 5d 0a  utomatic_index].
1540: 20 20 66 6f 72 20 6e 65 77 6c 79 20 6f 70 65 6e    for newly open
1550: 65 64 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e  ed [database con
1560: 6e 65 63 74 69 6f 6e 73 5d 2e 0a 20 20 46 6f 72  nections]..  For
1570: 20 61 6c 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66   all versions of
1580: 20 53 51 4c 69 74 65 20 74 68 72 6f 75 67 68 20   SQLite through 
1590: 33 2e 37 2e 31 37 2c 0a 20 20 61 75 74 6f 6d 61  3.7.17,.  automa
15a0: 74 69 63 20 69 6e 64 69 63 65 73 20 61 72 65 20  tic indices are 
15b0: 6e 6f 72 6d 61 6c 6c 79 20 65 6e 61 62 6c 65 64  normally enabled
15c0: 20 66 6f 72 20 6e 65 77 20 64 61 74 61 62 61 73   for new databas
15d0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 69 66  e connections if
15e0: 0a 20 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d  .  this compile-
15f0: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 6f  time option is o
1600: 6d 69 74 74 65 64 2e 0a 20 20 48 6f 77 65 76 65  mitted..  Howeve
1610: 72 2c 20 74 68 61 74 20 6d 69 67 68 74 20 63 68  r, that might ch
1620: 61 6e 67 65 20 69 6e 20 66 75 74 75 72 65 20 72  ange in future r
1630: 65 6c 65 61 73 65 73 20 6f 66 20 53 51 4c 69 74  eleases of SQLit
1640: 65 2e 0a 20 20 3c 70 3e 53 65 65 20 61 6c 73 6f  e..  <p>See also
1650: 3a 20 5b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  : [SQLITE_OMIT_A
1660: 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 5d 0a  UTOMATIC_INDEX].
1670: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
1680: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
1690: 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d 3c 69 3e  T_AUTOVACUUM=<i>
16a0: 26 6c 74 3b 30 20 6f 72 20 31 20 6f 72 20 32 26  &lt;0 or 1 or 2&
16b0: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69  gt;</i>} {.  Thi
16c0: 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d 69 6e  s macro determin
16d0: 65 73 20 69 66 20 53 51 4c 69 74 65 20 63 72 65  es if SQLite cre
16e0: 61 74 65 73 20 64 61 74 61 62 61 73 65 73 20 77  ates databases w
16f0: 69 74 68 20 74 68 65 20 0a 20 20 5b 61 75 74 6f  ith the .  [auto
1700: 5f 76 61 63 75 75 6d 5d 20 66 6c 61 67 20 73 65  _vacuum] flag se
1710: 74 20 62 79 20 64 65 66 61 75 6c 74 20 74 6f 20  t by default to 
1720: 4f 46 46 20 28 30 29 2c 20 46 55 4c 4c 20 28 31  OFF (0), FULL (1
1730: 29 2c 20 6f 72 0a 20 20 49 4e 43 52 45 4d 45 4e  ), or.  INCREMEN
1740: 54 41 4c 20 28 32 29 2e 20 54 68 65 20 64 65 66  TAL (2). The def
1750: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 30 20  ault value is 0 
1760: 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 64 61 74  meaning that dat
1770: 61 62 61 73 65 73 0a 20 20 61 72 65 20 63 72 65  abases.  are cre
1780: 61 74 65 64 20 77 69 74 68 20 61 75 74 6f 2d 76  ated with auto-v
1790: 61 63 75 75 6d 20 74 75 72 6e 65 64 20 6f 66 66  acuum turned off
17a0: 2e 0a 20 20 49 6e 20 61 6e 79 20 63 61 73 65 20  ..  In any case 
17b0: 74 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  the compile-time
17c0: 20 64 65 66 61 75 6c 74 20 6d 61 79 20 62 65 20   default may be 
17d0: 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 74 68  overridden by th
17e0: 65 20 0a 20 20 5b 50 52 41 47 4d 41 20 61 75 74  e .  [PRAGMA aut
17f0: 6f 5f 76 61 63 75 75 6d 5d 20 63 6f 6d 6d 61 6e  o_vacuum] comman
1800: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
1810: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
1820: 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 3d  AULT_CACHE_SIZE=
1830: 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26 67 74 3b  <i>&lt;pages&gt;
1840: 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d  </i>} {.  This m
1850: 61 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65  acro sets the de
1860: 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20 74 68  fault size of th
1870: 65 20 70 61 67 65 2d 63 61 63 68 65 20 66 6f 72  e page-cache for
1880: 20 65 61 63 68 20 61 74 74 61 63 68 65 64 0a 20   each attached. 
1890: 20 64 61 74 61 62 61 73 65 2c 20 69 6e 20 70 61   database, in pa
18a0: 67 65 73 2e 20 54 68 69 73 20 63 61 6e 20 62 65  ges. This can be
18b0: 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 74   overridden by t
18c0: 68 65 20 0a 20 20 5b 50 52 41 47 4d 41 20 63 61  he .  [PRAGMA ca
18d0: 63 68 65 5f 73 69 7a 65 5d 20 63 6f 6d 6d 61 6e  che_size] comman
18e0: 64 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 76  d. The default v
18f0: 61 6c 75 65 20 69 73 20 32 30 30 30 2e 0a 7d 0a  alue is 2000..}.
1900: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
1910: 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f  {SQLITE_DEFAULT_
1920: 46 49 4c 45 5f 46 4f 52 4d 41 54 3d 3c 69 3e 26  FILE_FORMAT=<i>&
1930: 6c 74 3b 31 20 6f 72 20 34 26 67 74 3b 3c 2f 69  lt;1 or 4&gt;</i
1940: 3e 7d 20 7b 0a 20 20 54 68 65 20 64 65 66 61 75  >} {.  The defau
1950: 6c 74 20 5b 73 63 68 65 6d 61 20 66 6f 72 6d 61  lt [schema forma
1960: 74 20 6e 75 6d 62 65 72 5d 20 75 73 65 64 20 62  t number] used b
1970: 79 20 53 51 4c 69 74 65 20 77 68 65 6e 20 63 72  y SQLite when cr
1980: 65 61 74 69 6e 67 0a 20 20 6e 65 77 20 64 61 74  eating.  new dat
1990: 61 62 61 73 65 20 66 69 6c 65 73 20 69 73 20 73  abase files is s
19a0: 65 74 20 62 79 20 74 68 69 73 20 6d 61 63 72 6f  et by this macro
19b0: 2e 20 20 54 68 65 20 73 63 68 65 6d 61 20 66 6f  .  The schema fo
19c0: 72 6d 61 74 73 20 61 72 65 20 61 6c 6c 0a 20 20  rmats are all.  
19d0: 76 65 72 79 20 73 69 6d 69 6c 61 72 2e 20 20 54  very similar.  T
19e0: 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65  he difference be
19f0: 74 77 65 65 6e 20 66 6f 72 6d 61 74 73 20 31 20  tween formats 1 
1a00: 61 6e 64 20 34 20 69 73 20 74 68 61 74 20 66 6f  and 4 is that fo
1a10: 72 6d 61 74 0a 20 20 34 20 75 6e 64 65 72 73 74  rmat.  4 underst
1a20: 61 6e 64 73 20 5b 64 65 73 63 65 6e 64 69 6e 67  ands [descending
1a30: 20 69 6e 64 69 63 65 73 5d 20 61 6e 64 20 68 61   indices] and ha
1a40: 73 20 61 20 74 69 67 68 74 65 72 20 65 6e 63 6f  s a tighter enco
1a50: 64 69 6e 67 20 66 6f 72 0a 20 20 62 6f 6f 6c 65  ding for.  boole
1a60: 61 6e 20 76 61 6c 75 65 73 2e 0a 0a 20 20 41 6c  an values...  Al
1a70: 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51  l versions of SQ
1a80: 4c 69 74 65 20 73 69 6e 63 65 20 33 2e 33 2e 30  Lite since 3.3.0
1a90: 20 28 32 30 30 36 2d 30 31 2d 31 30 29 0a 20 20   (2006-01-10).  
1aa0: 63 61 6e 20 72 65 61 64 20 61 6e 64 20 77 72 69  can read and wri
1ab0: 74 65 20 61 6e 79 20 73 63 68 65 6d 61 20 66 6f  te any schema fo
1ac0: 72 6d 61 74 0a 20 20 62 65 74 77 65 65 6e 20 31  rmat.  between 1
1ad0: 20 61 6e 64 20 34 2e 20 20 42 75 74 20 6f 6c 64   and 4.  But old
1ae0: 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53  er versions of S
1af0: 51 4c 69 74 65 20 6d 69 67 68 74 20 6e 6f 74 20  QLite might not 
1b00: 62 65 20 61 62 6c 65 20 74 6f 0a 20 20 72 65 61  be able to.  rea
1b10: 64 20 66 6f 72 6d 61 74 73 20 67 72 65 61 74 65  d formats greate
1b20: 72 20 74 68 61 6e 20 31 2e 20 20 53 6f 20 74 68  r than 1.  So th
1b30: 61 74 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e  at older version
1b40: 73 20 6f 66 20 53 51 4c 69 74 65 20 77 69 6c 6c  s of SQLite will
1b50: 0a 20 20 62 65 20 61 62 6c 65 20 74 6f 20 72 65  .  be able to re
1b60: 61 64 20 61 6e 64 20 77 72 69 74 65 20 64 61 74  ad and write dat
1b70: 61 62 61 73 65 20 66 69 6c 65 73 20 63 72 65 61  abase files crea
1b80: 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 65 72  ted by newer ver
1b90: 73 69 6f 6e 73 0a 20 20 6f 66 20 53 51 4c 69 74  sions.  of SQLit
1ba0: 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 73  e, the default s
1bb0: 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 77 61 73  chema format was
1bc0: 20 73 65 74 20 74 6f 20 31 20 66 6f 72 20 53 51   set to 1 for SQ
1bd0: 4c 69 74 65 20 76 65 72 73 69 6f 6e 73 0a 20 20  Lite versions.  
1be0: 74 68 72 6f 75 67 68 20 33 2e 37 2e 39 20 28 32  through 3.7.9 (2
1bf0: 30 31 31 2d 31 31 2d 30 31 29 2e 20 20 42 65 67  011-11-01).  Beg
1c00: 69 6e 6e 69 6e 67 20 77 69 74 68 20 76 65 72 73  inning with vers
1c10: 69 6f 6e 20 33 2e 37 2e 31 30 2c 20 74 68 65 20  ion 3.7.10, the 
1c20: 64 65 66 61 75 6c 74 0a 20 20 73 63 68 65 6d 61  default.  schema
1c30: 20 66 6f 72 6d 61 74 20 69 73 20 34 2e 0a 0a 20   format is 4... 
1c40: 20 54 68 65 20 73 63 68 65 6d 61 20 66 6f 72 6d   The schema form
1c50: 61 74 20 6e 75 6d 62 65 72 20 66 6f 72 20 61 20  at number for a 
1c60: 6e 65 77 20 64 61 74 61 62 61 73 65 20 63 61 6e  new database can
1c70: 20 62 65 20 73 65 74 20 61 74 20 72 75 6e 74 69   be set at runti
1c80: 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65 20 5b  me using.  the [
1c90: 50 52 41 47 4d 41 20 6c 65 67 61 63 79 5f 66 69  PRAGMA legacy_fi
1ca0: 6c 65 5f 66 6f 72 6d 61 74 5d 20 63 6f 6d 6d 61  le_format] comma
1cb0: 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  nd..}..COMPILE_O
1cc0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
1cd0: 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52 4d 49  FAULT_FILE_PERMI
1ce0: 53 53 49 4f 4e 53 3d 3c 69 3e 4e 3c 2f 69 3e 7d  SSIONS=<i>N</i>}
1cf0: 20 7b 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74   {.  The default
1d00: 20 6e 75 6d 65 72 69 63 20 66 69 6c 65 20 70 65   numeric file pe
1d10: 72 6d 69 73 73 69 6f 6e 73 20 66 6f 72 20 6e 65  rmissions for ne
1d20: 77 6c 79 20 63 72 65 61 74 65 64 20 64 61 74 61  wly created data
1d30: 62 61 73 65 20 66 69 6c 65 73 0a 20 20 75 6e 64  base files.  und
1d40: 65 72 20 75 6e 69 78 2e 20 20 49 66 20 6e 6f 74  er unix.  If not
1d50: 20 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 20   specified, the 
1d60: 64 65 66 61 75 6c 74 20 69 73 20 30 36 34 34 20  default is 0644 
1d70: 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61 74  which means that
1d80: 0a 20 20 74 68 65 20 66 69 6c 65 73 20 69 73 20  .  the files is 
1d90: 67 6c 6f 62 61 6c 6c 79 20 72 65 61 64 61 62 6c  globally readabl
1da0: 65 20 62 75 74 20 6f 6e 6c 79 20 77 72 69 74 61  e but only writa
1db0: 62 6c 65 20 62 79 20 74 68 65 20 63 72 65 61 74  ble by the creat
1dc0: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
1dd0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
1de0: 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45  FAULT_FOREIGN_KE
1df0: 59 53 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31  YS=<i>&lt;0 or 1
1e00: 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  &gt;</i>} {.  Th
1e10: 69 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d 69  is macro determi
1e20: 6e 65 73 20 77 68 65 74 68 65 72 20 65 6e 66 6f  nes whether enfo
1e30: 72 63 65 6d 65 6e 74 20 6f 66 20 0a 20 20 5b 66  rcement of .  [f
1e40: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
1e50: 72 61 69 6e 74 73 5d 20 69 73 20 65 6e 61 62 6c  raints] is enabl
1e60: 65 64 20 6f 72 20 64 69 73 61 62 6c 65 64 20 62  ed or disabled b
1e70: 79 20 64 65 66 61 75 6c 74 20 66 6f 72 0a 20 20  y default for.  
1e80: 6e 65 77 20 64 61 74 61 62 61 73 65 20 63 6f 6e  new database con
1e90: 6e 65 63 74 69 6f 6e 73 2e 20 20 45 61 63 68 20  nections.  Each 
1ea0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
1eb0: 69 6f 6e 20 63 61 6e 20 61 6c 77 61 79 73 20 74  ion can always t
1ec0: 75 72 6e 0a 20 20 65 6e 66 6f 72 63 65 6d 65 6e  urn.  enforcemen
1ed0: 74 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b 65 79  t of foreign key
1ee0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f 6e 20   constraints on 
1ef0: 61 6e 64 20 6f 66 66 20 61 6e 64 20 72 75 6e 2d  and off and run-
1f00: 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65  time using.  the
1f10: 20 5b 66 6f 72 65 69 67 6e 5f 6b 65 79 73 20 70   [foreign_keys p
1f20: 72 61 67 6d 61 5d 2e 20 20 45 6e 66 6f 72 63 65  ragma].  Enforce
1f30: 6d 65 6e 74 20 6f 66 20 66 6f 72 65 69 67 6e 20  ment of foreign 
1f40: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 0a  key constraints.
1f50: 20 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 6f 66    is normally of
1f60: 66 20 62 79 20 64 65 66 61 75 6c 74 2c 20 62 75  f by default, bu
1f70: 74 20 69 66 20 74 68 69 73 20 63 6f 6d 70 69 6c  t if this compil
1f80: 65 2d 74 69 6d 65 20 70 61 72 61 6d 65 74 65 72  e-time parameter
1f90: 20 69 73 0a 20 20 73 65 74 20 74 6f 20 31 2c 20   is.  set to 1, 
1fa0: 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 66  enforcement of f
1fb0: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
1fc0: 72 61 69 6e 74 73 20 77 69 6c 6c 20 62 65 20 6f  raints will be o
1fd0: 6e 20 62 79 20 64 65 66 61 75 6c 74 2e 0a 7d 0a  n by default..}.
1fe0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
1ff0: 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f  {SQLITE_DEFAULT_
2000: 4d 4d 41 50 5f 53 49 5a 45 3d 3c 69 3e 4e 3c 2f  MMAP_SIZE=<i>N</
2010: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63  i>} {.  This mac
2020: 72 6f 20 73 65 74 73 20 74 68 65 20 64 65 66 61  ro sets the defa
2030: 75 6c 74 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65  ult limit on the
2040: 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72   amount of memor
2050: 79 20 74 68 61 74 0a 20 20 77 69 6c 6c 20 62 65  y that.  will be
2060: 20 75 73 65 64 20 66 6f 72 20 6d 65 6d 6f 72 79   used for memory
2070: 2d 6d 61 70 70 65 64 20 49 2f 4f 0a 20 20 66 6f  -mapped I/O.  fo
2080: 72 20 65 61 63 68 20 6f 70 65 6e 20 64 61 74 61  r each open data
2090: 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 74  base file.  If t
20a0: 68 65 20 3c 69 3e 4e 3c 2f 69 3e 0a 20 20 69 73  he <i>N</i>.  is
20b0: 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6d 65 6d 6f   zero, then memo
20c0: 72 79 20 6d 61 70 70 65 64 20 49 2f 4f 20 69 73  ry mapped I/O is
20d0: 20 64 69 73 61 62 6c 65 64 20 62 79 20 64 65 66   disabled by def
20e0: 61 75 6c 74 2e 20 20 54 68 69 73 0a 20 20 63 6f  ault.  This.  co
20f0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6c 69 6d 69 74  mpile-time limit
2100: 20 61 6e 64 20 74 68 65 20 5b 53 51 4c 49 54 45   and the [SQLITE
2110: 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 5d 20  _MAX_MMAP_SIZE] 
2120: 63 61 6e 20 62 65 20 6d 6f 64 69 66 69 65 64 20  can be modified 
2130: 0a 20 20 61 74 20 73 74 61 72 74 2d 74 69 6d 65  .  at start-time
2140: 20 75 73 69 6e 67 20 74 68 65 0a 20 20 5b 73 71   using the.  [sq
2150: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53  lite3_config]([S
2160: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 4d 41  QLITE_CONFIG_MMA
2170: 50 5f 53 49 5a 45 5d 29 20 63 61 6c 6c 2c 20 6f  P_SIZE]) call, o
2180: 72 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 20  r at run-time.  
2190: 75 73 69 6e 67 20 74 68 65 20 5b 6d 6d 61 70 5f  using the [mmap_
21a0: 73 69 7a 65 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a  size pragma]..}.
21b0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
21c0: 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f  {SQLITE_DEFAULT_
21d0: 4a 4f 55 52 4e 41 4c 5f 53 49 5a 45 5f 4c 49 4d  JOURNAL_SIZE_LIM
21e0: 49 54 3d 3c 69 3e 26 6c 74 3b 62 79 74 65 73 26  IT=<i>&lt;bytes&
21f0: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69  gt;</i>} {.  Thi
2200: 73 20 6f 70 74 69 6f 6e 20 73 65 74 73 20 74 68  s option sets th
2210: 65 20 73 69 7a 65 20 6c 69 6d 69 74 20 6f 6e 20  e size limit on 
2220: 5b 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61  [rollback journa
2230: 6c 5d 20 66 69 6c 65 73 20 69 6e 0a 20 20 5b 6a  l] files in.  [j
2240: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 70 72 61 67  ournal_mode prag
2250: 6d 61 20 7c 20 70 65 72 73 69 73 74 65 6e 74 20  ma | persistent 
2260: 6a 6f 75 72 6e 61 6c 20 6d 6f 64 65 5d 20 61 6e  journal mode] an
2270: 64 0a 20 20 5b 6c 6f 63 6b 69 6e 67 5f 6d 6f 64  d.  [locking_mod
2280: 65 20 7c 20 65 78 63 6c 75 73 69 76 65 20 6c 6f  e | exclusive lo
2290: 63 6b 69 6e 67 20 6d 6f 64 65 5d 20 61 6e 64 20  cking mode] and 
22a0: 6f 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74  on the size of t
22b0: 68 65 0a 20 20 77 72 69 74 65 2d 61 68 65 61 64  he.  write-ahead
22c0: 20 6c 6f 67 20 66 69 6c 65 20 69 6e 20 5b 57 41   log file in [WA
22d0: 4c 20 6d 6f 64 65 5d 2e 20 57 68 65 6e 20 74 68  L mode]. When th
22e0: 69 73 20 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69  is .  compile-ti
22f0: 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 6f 6d 69  me option is omi
2300: 74 74 65 64 20 74 68 65 72 65 20 69 73 20 6e 6f  tted there is no
2310: 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20   upper bound on 
2320: 74 68 65 0a 20 20 73 69 7a 65 20 6f 66 20 74 68  the.  size of th
2330: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e  e rollback journ
2340: 61 6c 73 20 6f 72 20 77 72 69 74 65 2d 61 68 65  als or write-ahe
2350: 61 64 20 6c 6f 67 73 2e 20 20 0a 20 20 54 68 65  ad logs.  .  The
2360: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 69   journal file si
2370: 7a 65 20 6c 69 6d 69 74 0a 20 20 63 61 6e 20 62  ze limit.  can b
2380: 65 20 63 68 61 6e 67 65 64 20 61 74 20 72 75 6e  e changed at run
2390: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 20  -time using the 
23a0: 5b 6a 6f 75 72 6e 61 6c 5f 73 69 7a 65 5f 6c 69  [journal_size_li
23b0: 6d 69 74 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a  mit pragma]..}..
23c0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
23d0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4c  SQLITE_DEFAULT_L
23e0: 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 3c 69 3e 26  OCKING_MODE=<i>&
23f0: 6c 74 3b 31 20 6f 72 20 30 26 67 74 3b 3c 2f 69  lt;1 or 0&gt;</i
2400: 3e 7d 20 7b 0a 20 20 49 66 20 73 65 74 20 74 6f  >} {.  If set to
2410: 20 31 2c 20 74 68 65 6e 20 74 68 65 20 64 65 66   1, then the def
2420: 61 75 6c 74 20 5b 6c 6f 63 6b 69 6e 67 5f 6d 6f  ault [locking_mo
2430: 64 65 5d 20 69 73 20 73 65 74 20 74 6f 20 45 58  de] is set to EX
2440: 43 4c 55 53 49 56 45 2e 0a 20 20 49 66 20 6f 6d  CLUSIVE..  If om
2450: 69 74 74 65 64 20 6f 72 20 73 65 74 20 74 6f 20  itted or set to 
2460: 30 20 74 68 65 6e 20 74 68 65 20 64 65 66 61 75  0 then the defau
2470: 6c 74 20 5b 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65  lt [locking_mode
2480: 5d 20 69 73 20 4e 4f 52 4d 41 4c 2e 0a 7d 0a 0a  ] is NORMAL..}..
2490: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
24a0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d  SQLITE_DEFAULT_M
24b0: 45 4d 53 54 41 54 55 53 3d 3c 69 3e 26 6c 74 3b  EMSTATUS=<i>&lt;
24c0: 31 20 6f 72 20 30 26 67 74 3b 3c 2f 69 3e 7d 20  1 or 0&gt;</i>} 
24d0: 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 69  {.  This macro i
24e0: 73 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d  s used to determ
24f0: 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e  ine whether or n
2500: 6f 74 20 74 68 65 20 66 65 61 74 75 72 65 73 20  ot the features 
2510: 65 6e 61 62 6c 65 64 20 61 6e 64 0a 20 20 64 69  enabled and.  di
2520: 73 61 62 6c 65 64 20 75 73 69 6e 67 20 74 68 65  sabled using the
2530: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d   SQLITE_CONFIG_M
2540: 45 4d 53 54 41 54 55 53 20 61 72 67 75 6d 65 6e  EMSTATUS argumen
2550: 74 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f  t to [sqlite3_co
2560: 6e 66 69 67 28 29 5d 0a 20 20 61 72 65 20 61 76  nfig()].  are av
2570: 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66 61 75  ailable by defau
2580: 6c 74 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20  lt. The default 
2590: 76 61 6c 75 65 20 69 73 20 31 20 28 5b 53 51 4c  value is 1 ([SQL
25a0: 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d 53 54  ITE_CONFIG_MEMST
25b0: 41 54 55 53 5d 0a 20 20 72 65 6c 61 74 65 64 20  ATUS].  related 
25c0: 66 65 61 74 75 72 65 73 20 65 6e 61 62 6c 65 64  features enabled
25d0: 29 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  )..}..COMPILE_OP
25e0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
25f0: 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3d 3c  AULT_PAGE_SIZE=<
2600: 69 3e 26 6c 74 3b 62 79 74 65 73 26 67 74 3b 3c  i>&lt;bytes&gt;<
2610: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61  /i>} {.  This ma
2620: 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20 73  cro is used to s
2630: 65 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 70  et the default p
2640: 61 67 65 2d 73 69 7a 65 20 75 73 65 64 20 77 68  age-size used wh
2650: 65 6e 20 61 0a 20 20 64 61 74 61 62 61 73 65 20  en a.  database 
2660: 69 73 20 63 72 65 61 74 65 64 2e 20 54 68 65 20  is created. The 
2670: 76 61 6c 75 65 20 61 73 73 69 67 6e 65 64 20 6d  value assigned m
2680: 75 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 6f  ust be a power o
2690: 66 20 32 2e 20 54 68 65 0a 20 20 64 65 66 61 75  f 2. The.  defau
26a0: 6c 74 20 76 61 6c 75 65 20 69 73 20 31 30 32 34  lt value is 1024
26b0: 2e 20 54 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69  . The compile-ti
26c0: 6d 65 20 64 65 66 61 75 6c 74 20 6d 61 79 20 62  me default may b
26d0: 65 20 6f 76 65 72 72 69 64 64 65 6e 20 61 74 20  e overridden at 
26e0: 0a 20 20 72 75 6e 74 69 6d 65 20 62 79 20 74 68  .  runtime by th
26f0: 65 20 5b 50 52 41 47 4d 41 20 70 61 67 65 5f 73  e [PRAGMA page_s
2700: 69 7a 65 5d 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a  ize] command..}.
2710: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
2720: 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f  {SQLITE_DEFAULT_
2730: 54 45 4d 50 5f 43 41 43 48 45 5f 53 49 5a 45 3d  TEMP_CACHE_SIZE=
2740: 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26 67 74 3b  <i>&lt;pages&gt;
2750: 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d  </i>} {.  This m
2760: 61 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65  acro sets the de
2770: 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20 74 68  fault size of th
2780: 65 20 70 61 67 65 2d 63 61 63 68 65 20 66 6f 72  e page-cache for
2790: 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73   temporary files
27a0: 0a 20 20 63 72 65 61 74 65 64 20 62 79 20 53 51  .  created by SQ
27b0: 4c 69 74 65 20 74 6f 20 73 74 6f 72 65 20 69 6e  Lite to store in
27c0: 74 65 72 6d 65 64 69 61 74 65 20 72 65 73 75 6c  termediate resul
27d0: 74 73 2c 20 69 6e 20 70 61 67 65 73 2e 20 49 74  ts, in pages. It
27e0: 20 64 6f 65 73 0a 20 20 6e 6f 74 20 61 66 66 65   does.  not affe
27f0: 63 74 20 74 68 65 20 70 61 67 65 2d 63 61 63 68  ct the page-cach
2800: 65 20 66 6f 72 20 74 68 65 20 74 65 6d 70 20 64  e for the temp d
2810: 61 74 61 62 61 73 65 2c 20 77 68 65 72 65 20 74  atabase, where t
2820: 61 62 6c 65 73 20 63 72 65 61 74 65 64 0a 20 20  ables created.  
2830: 75 73 69 6e 67 20 5b 43 52 45 41 54 45 20 54 41  using [CREATE TA
2840: 42 4c 45 20 7c 20 43 52 45 41 54 45 20 54 45 4d  BLE | CREATE TEM
2850: 50 20 54 41 42 4c 45 5d 20 61 72 65 20 73 74 6f  P TABLE] are sto
2860: 72 65 64 2e 20 54 68 65 20 64 65 66 61 75 6c 74  red. The default
2870: 20 76 61 6c 75 65 0a 20 20 69 73 20 35 30 30 2e   value.  is 500.
2880: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
2890: 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55  ON {SQLITE_DEFAU
28a0: 4c 54 5f 57 41 4c 5f 41 55 54 4f 43 48 45 43 4b  LT_WAL_AUTOCHECK
28b0: 50 4f 49 4e 54 3d 3c 69 3e 26 6c 74 3b 70 61 67  POINT=<i>&lt;pag
28c0: 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20  es&gt;</i>} {.  
28d0: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
28e0: 74 68 65 20 64 65 66 61 75 6c 74 20 70 61 67 65  the default page
28f0: 20 63 6f 75 6e 74 20 66 6f 72 20 74 68 65 20 5b   count for the [
2900: 57 41 4c 5d 0a 20 20 5b 63 68 65 63 6b 70 6f 69  WAL].  [checkpoi
2910: 6e 74 69 6e 67 20 7c 20 61 75 74 6f 6d 61 74 69  nting | automati
2920: 63 20 63 68 65 63 6b 70 6f 69 6e 74 69 6e 67 5d  c checkpointing]
2930: 20 66 65 61 74 75 72 65 2e 20 20 49 66 20 75 6e   feature.  If un
2940: 73 70 65 63 69 66 69 65 64 2c 0a 20 20 74 68 65  specified,.  the
2950: 20 64 65 66 61 75 6c 74 20 70 61 67 65 20 63 6f   default page co
2960: 75 6e 74 20 69 73 20 31 30 30 30 2e 0a 7d 0a 0a  unt is 1000..}..
2970: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2980: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57  SQLITE_DEFAULT_W
2990: 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3d 3c 69  ORKER_THREADS=<i
29a0: 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  >N</i>} {.  This
29b0: 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65 20   macro sets the 
29c0: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 6f  default value fo
29d0: 72 0a 20 20 74 68 65 20 5b 53 51 4c 49 54 45 5f  r.  the [SQLITE_
29e0: 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52  LIMIT_WORKER_THR
29f0: 45 41 44 53 5d 20 70 61 72 61 6d 65 74 65 72 2e  EADS] parameter.
2a00: 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f 4c 49    The [SQLITE_LI
2a10: 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41  MIT_WORKER_THREA
2a20: 44 53 5d 0a 20 20 70 61 72 61 6d 65 74 65 72 20  DS].  parameter 
2a30: 73 65 74 73 20 74 68 65 20 6d 61 78 69 6d 75 6d  sets the maximum
2a40: 20 6e 75 6d 62 65 72 20 6f 66 20 61 75 78 69 6c   number of auxil
2a50: 69 61 72 79 20 74 68 72 65 61 64 73 20 74 68 61  iary threads tha
2a60: 74 20 61 20 73 69 6e 67 6c 65 0a 20 20 5b 70 72  t a single.  [pr
2a70: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
2a80: 5d 20 77 69 6c 6c 20 6c 61 75 6e 63 68 20 74 6f  ] will launch to
2a90: 20 61 73 73 69 73 74 20 69 74 20 77 69 74 68 20   assist it with 
2aa0: 61 20 71 75 65 72 79 2e 20 20 49 66 20 6e 6f 74  a query.  If not
2ab0: 20 73 70 65 63 69 66 69 65 64 2c 0a 20 20 74 68   specified,.  th
2ac0: 65 20 64 65 66 61 75 6c 74 20 6d 61 78 69 6d 75  e default maximu
2ad0: 6d 20 69 73 20 30 2e 0a 20 20 54 68 65 20 76 61  m is 0..  The va
2ae0: 6c 75 65 20 73 65 74 20 68 65 72 65 20 63 61 6e  lue set here can
2af0: 6e 6f 74 20 62 65 20 6d 6f 72 65 20 74 68 61 6e  not be more than
2b00: 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52   [SQLITE_MAX_WOR
2b10: 4b 45 52 5f 54 48 52 45 41 44 53 5d 2e 0a 7d 0a  KER_THREADS]..}.
2b20: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
2b30: 7b 53 51 4c 49 54 45 5f 46 54 53 33 5f 4d 41 58  {SQLITE_FTS3_MAX
2b40: 5f 45 58 50 52 5f 44 45 50 54 48 3d 3c 69 3e 4e  _EXPR_DEPTH=<i>N
2b50: 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d  </i>} {.  This m
2b60: 61 63 72 6f 20 73 65 74 73 20 74 68 65 20 6d 61  acro sets the ma
2b70: 78 69 6d 75 6d 20 64 65 70 74 68 20 6f 66 20 74  ximum depth of t
2b80: 68 65 20 73 65 61 72 63 68 20 74 72 65 65 20 74  he search tree t
2b90: 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20  hat corresponds 
2ba0: 74 6f 0a 20 20 74 68 65 20 72 69 67 68 74 2d 68  to.  the right-h
2bb0: 61 6e 64 20 73 69 64 65 20 6f 66 20 74 68 65 20  and side of the 
2bc0: 4d 41 54 43 48 20 6f 70 65 72 61 74 6f 72 20 69  MATCH operator i
2bd0: 6e 20 61 6e 20 5b 46 54 53 33 5d 20 6f 72 20 5b  n an [FTS3] or [
2be0: 46 54 53 34 5d 20 66 75 6c 6c 2d 74 65 78 74 0a  FTS4] full-text.
2bf0: 20 20 69 6e 64 65 78 2e 20 20 54 68 65 20 66 75    index.  The fu
2c00: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 75  ll-text search u
2c10: 73 65 73 20 61 20 72 65 63 75 72 73 69 76 65 20  ses a recursive 
2c20: 61 6c 67 6f 72 69 74 68 6d 2c 20 73 6f 20 74 68  algorithm, so th
2c30: 65 20 64 65 70 74 68 20 6f 66 0a 20 20 74 68 65  e depth of.  the
2c40: 20 74 72 65 65 20 69 73 20 6c 69 6d 69 74 65 64   tree is limited
2c50: 20 74 6f 20 70 72 65 76 65 6e 74 20 75 73 69 6e   to prevent usin
2c60: 67 20 74 6f 6f 20 6d 75 63 68 20 73 74 61 63 6b  g too much stack
2c70: 20 73 70 61 63 65 2e 20 20 54 68 65 20 64 65 66   space.  The def
2c80: 61 75 6c 74 0a 20 20 6c 69 6d 69 74 20 69 73 20  ault.  limit is 
2c90: 31 32 2e 20 20 54 68 69 73 20 6c 69 6d 69 74 20  12.  This limit 
2ca0: 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 66 6f  is sufficient fo
2cb0: 72 20 75 70 20 74 6f 20 34 30 39 35 20 73 65 61  r up to 4095 sea
2cc0: 72 63 68 20 74 65 72 6d 73 20 6f 6e 20 74 68 65  rch terms on the
2cd0: 0a 20 20 72 69 67 68 74 2d 68 61 6e 64 20 73 69  .  right-hand si
2ce0: 64 65 20 6f 66 20 74 68 65 20 4d 41 54 43 48 20  de of the MATCH 
2cf0: 6f 70 65 72 61 74 6f 72 20 61 6e 64 20 69 74 20  operator and it 
2d00: 68 6f 6c 64 73 20 73 74 61 63 6b 20 73 70 61 63  holds stack spac
2d10: 65 20 75 73 61 67 65 20 74 6f 20 0a 20 20 6c 65  e usage to .  le
2d20: 73 73 20 74 68 61 6e 20 32 30 30 30 20 62 79 74  ss than 2000 byt
2d30: 65 73 2e 0a 20 20 3c 70 3e 0a 20 20 46 6f 72 20  es..  <p>.  For 
2d40: 6f 72 64 69 6e 61 72 79 20 46 54 53 33 2f 46 54  ordinary FTS3/FT
2d50: 53 34 20 71 75 65 72 69 65 73 2c 20 74 68 65 20  S4 queries, the 
2d60: 73 65 61 72 63 68 20 74 72 65 65 20 64 65 70 74  search tree dept
2d70: 68 20 69 73 20 61 70 70 72 6f 78 69 6d 61 74 65  h is approximate
2d80: 6c 79 0a 20 20 74 68 65 20 62 61 73 65 2d 32 20  ly.  the base-2 
2d90: 6c 6f 67 61 72 69 74 68 6d 20 6f 66 20 74 68 65  logarithm of the
2da0: 20 6e 75 6d 62 65 72 20 6f 66 20 74 65 72 6d 73   number of terms
2db0: 20 69 6e 20 74 68 65 20 72 69 67 68 74 2d 68 61   in the right-ha
2dc0: 6e 64 20 73 69 64 65 20 6f 66 20 74 68 65 0a 20  nd side of the. 
2dd0: 20 4d 41 54 43 48 20 6f 70 65 72 61 74 6f 72 2e   MATCH operator.
2de0: 20 20 48 6f 77 65 76 65 72 2c 20 66 6f 72 20 5b    However, for [
2df0: 70 68 72 61 73 65 20 71 75 65 72 69 65 73 5d 20  phrase queries] 
2e00: 61 6e 64 20 5b 4e 45 41 52 20 71 75 65 72 69 65  and [NEAR querie
2e10: 73 5d 20 74 68 65 0a 20 20 73 65 61 72 63 68 20  s] the.  search 
2e20: 74 72 65 65 20 64 65 70 74 68 20 69 73 20 6c 69  tree depth is li
2e30: 6e 65 61 72 20 69 6e 20 74 68 65 20 6e 75 6d 62  near in the numb
2e40: 65 72 20 6f 66 20 72 69 67 68 74 2d 68 61 6e 64  er of right-hand
2e50: 20 73 69 64 65 20 74 65 72 6d 73 2e 0a 20 20 53   side terms..  S
2e60: 6f 20 74 68 65 20 64 65 66 61 75 6c 74 20 64 65  o the default de
2e70: 70 74 68 20 6c 69 6d 69 74 20 6f 66 20 31 32 20  pth limit of 12 
2e80: 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 66 6f  is sufficient fo
2e90: 72 20 75 70 20 74 6f 20 34 30 39 35 20 6f 72 64  r up to 4095 ord
2ea0: 69 6e 61 72 79 0a 20 20 74 65 72 6d 73 20 6f 6e  inary.  terms on
2eb0: 20 61 20 4d 41 54 43 48 2c 20 69 74 20 69 73 20   a MATCH, it is 
2ec0: 6f 6e 6c 79 20 73 75 66 66 69 63 69 65 6e 74 20  only sufficient 
2ed0: 66 6f 72 20 31 31 20 6f 72 20 31 32 20 70 68 72  for 11 or 12 phr
2ee0: 61 73 65 20 6f 72 20 4e 45 41 52 0a 20 20 74 65  ase or NEAR.  te
2ef0: 72 6d 73 2e 20 20 45 76 65 6e 20 73 6f 2c 20 74  rms.  Even so, t
2f00: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 6d 6f  he default is mo
2f10: 72 65 20 74 68 61 6e 20 65 6e 6f 75 67 68 20 66  re than enough f
2f20: 6f 72 20 6d 6f 73 74 20 61 70 70 6c 69 63 61 74  or most applicat
2f30: 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ion..}..COMPILE_
2f40: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d  OPTION {SQLITE_M
2f50: 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3d 3c 69 3e  AX_MMAP_SIZE=<i>
2f60: 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  N</i>} {.  This 
2f70: 6d 61 63 72 6f 20 73 65 74 73 20 61 20 68 61 72  macro sets a har
2f80: 64 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e  d upper bound on
2f90: 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 61   the amount of a
2fa0: 64 64 72 65 73 73 20 73 70 61 63 65 20 74 68 61  ddress space tha
2fb0: 74 0a 20 20 63 61 6e 20 62 65 20 75 73 65 64 20  t.  can be used 
2fc0: 62 79 20 61 6e 79 20 73 69 6e 67 6c 65 20 64 61  by any single da
2fd0: 74 61 62 61 73 65 20 66 6f 72 20 6d 65 6d 6f 72  tabase for memor
2fe0: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 2e 0a 20 20  y-mapped I/O..  
2ff0: 53 65 74 74 69 6e 67 20 74 68 69 73 20 76 61 6c  Setting this val
3000: 75 65 20 74 6f 20 30 20 63 6f 6d 70 6c 65 74 65  ue to 0 complete
3010: 6c 79 20 64 69 73 61 62 6c 65 73 20 6d 65 6d 6f  ly disables memo
3020: 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 61 6e  ry-mapped I/O an
3030: 64 0a 20 20 63 61 75 73 65 73 20 6c 6f 67 69 63  d.  causes logic
3040: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
3050: 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49   memory-mapped I
3060: 2f 4f 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64  /O to be omitted
3070: 20 66 72 6f 6d 20 74 68 65 0a 20 20 62 75 69 6c   from the.  buil
3080: 64 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  d.  This option 
3090: 64 6f 65 73 20 63 68 61 6e 67 65 20 74 68 65 20  does change the 
30a0: 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79 2d 6d  default memory-m
30b0: 61 70 70 65 64 20 49 2f 4f 20 61 64 64 72 65 73  apped I/O addres
30c0: 73 0a 20 20 73 70 61 63 65 20 73 69 7a 65 20 28  s.  space size (
30d0: 73 65 74 20 62 79 20 5b 53 51 4c 49 54 45 5f 44  set by [SQLITE_D
30e0: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45  EFAULT_MMAP_SIZE
30f0: 5d 20 6f 72 0a 20 20 73 71 6c 69 74 65 33 5f 63  ] or.  sqlite3_c
3100: 6f 6e 66 69 67 28 5b 53 51 4c 49 54 45 5f 43 4f  onfig([SQLITE_CO
3110: 4e 46 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 5d 29  NFIG_MMAP_SIZE])
3120: 20 6f 72 20 74 68 65 0a 20 20 72 75 6e 2d 74 69   or the.  run-ti
3130: 6d 65 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64  me memory-mapped
3140: 20 49 2f 4f 20 61 64 64 72 65 73 73 20 73 70 61   I/O address spa
3150: 63 65 20 73 69 7a 65 20 28 73 65 74 20 62 79 0a  ce size (set by.
3160: 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63    sqlite3_file_c
3170: 6f 6e 74 72 6f 6c 28 5b 53 51 4c 49 54 45 5f 46  ontrol([SQLITE_F
3180: 43 4e 54 4c 5f 4d 4d 41 50 5f 53 49 5a 45 5d 29  CNTL_MMAP_SIZE])
3190: 20 6f 72 0a 20 20 5b 50 52 41 47 4d 41 20 6d 6d   or.  [PRAGMA mm
31a0: 61 70 5f 73 69 7a 65 5d 29 20 61 73 20 6c 6f 6e  ap_size]) as lon
31b0: 67 20 61 73 20 74 68 6f 73 65 20 6f 74 68 65 72  g as those other
31c0: 20 73 65 74 74 69 6e 67 73 20 61 72 65 20 6c 65   settings are le
31d0: 73 73 20 74 68 61 6e 20 74 68 65 0a 20 20 6d 61  ss than the.  ma
31e0: 78 69 6d 75 6d 20 76 61 6c 75 65 20 64 65 66 69  ximum value defi
31f0: 6e 65 64 20 68 65 72 65 2e 0a 7d 0a 0a 43 4f 4d  ned here..}..COM
3200: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
3210: 49 54 45 5f 4d 41 58 5f 53 43 48 45 4d 41 5f 52  ITE_MAX_SCHEMA_R
3220: 45 54 52 59 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b  ETRY=<i>N</i>} {
3230: 0a 20 20 57 68 65 6e 65 76 65 72 20 74 68 65 20  .  Whenever the 
3240: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
3250: 63 68 61 6e 67 65 73 2c 20 70 72 65 70 61 72 65  changes, prepare
3260: 64 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65  d statements are
3270: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20   automatically. 
3280: 20 72 65 70 72 65 70 61 72 65 64 20 74 6f 20 61   reprepared to a
3290: 63 63 6f 6d 6d 6f 64 61 74 65 20 74 68 65 20 6e  ccommodate the n
32a0: 65 77 20 73 63 68 65 6d 61 2e 20 20 54 68 65 72  ew schema.  Ther
32b0: 65 20 69 73 20 61 20 72 61 63 65 20 63 6f 6e 64  e is a race cond
32c0: 69 74 69 6f 6e 20 68 65 72 65 0a 20 20 69 6e 20  ition here.  in 
32d0: 74 68 61 74 20 69 66 20 6f 6e 65 20 74 68 72 65  that if one thre
32e0: 61 64 20 69 73 20 63 6f 6e 73 74 61 6e 74 6c 79  ad is constantly
32f0: 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 73 63   changing the sc
3300: 68 65 6d 61 2c 20 61 6e 6f 74 68 65 72 20 74 68  hema, another th
3310: 72 65 61 64 0a 20 20 6d 69 67 68 74 20 73 70 69  read.  might spi
3320: 6e 20 6f 6e 20 72 65 70 61 72 73 65 73 20 61 6e  n on reparses an
3330: 64 20 72 65 70 72 65 70 61 72 61 74 69 6f 6e 73  d repreparations
3340: 20 6f 66 20 61 20 70 72 65 70 61 72 65 64 20 73   of a prepared s
3350: 74 61 74 65 6d 65 6e 74 20 61 6e 64 0a 20 20 6e  tatement and.  n
3360: 65 76 65 72 20 67 65 74 20 61 6e 79 20 72 65 61  ever get any rea
3370: 6c 20 77 6f 72 6b 20 64 6f 6e 65 2e 20 20 54 68  l work done.  Th
3380: 69 73 20 70 61 72 61 6d 65 74 65 72 20 70 72 65  is parameter pre
3390: 76 65 6e 74 73 20 61 6e 20 69 6e 66 69 6e 69 74  vents an infinit
33a0: 65 20 6c 6f 6f 70 0a 20 20 62 79 20 66 6f 72 63  e loop.  by forc
33b0: 69 6e 67 20 74 68 65 20 73 70 69 6e 6e 69 6e 67  ing the spinning
33c0: 20 74 68 72 65 61 64 20 74 6f 20 67 69 76 65 20   thread to give 
33d0: 75 70 20 61 66 74 65 72 20 61 20 66 69 78 65 64  up after a fixed
33e0: 20 6e 75 6d 62 65 72 20 6f 66 20 61 74 74 65 6d   number of attem
33f0: 70 74 73 0a 20 20 61 74 20 72 65 63 6f 6d 70 69  pts.  at recompi
3400: 6c 69 6e 67 20 74 68 65 20 70 72 65 70 61 72 65  ling the prepare
3410: 64 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 68  d statement.  Th
3420: 65 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e  e default settin
3430: 67 20 69 73 20 35 30 20 77 68 69 63 68 20 69 73  g is 50 which is
3440: 0a 20 20 6d 6f 72 65 20 74 68 61 6e 20 61 64 65  .  more than ade
3450: 71 75 61 74 65 20 66 6f 72 20 6d 6f 73 74 20 61  quate for most a
3460: 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a  pplications..}..
3470: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3480: 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45  SQLITE_MAX_WORKE
3490: 52 5f 54 48 52 45 41 44 53 3d 3c 69 3e 4e 3c 2f  R_THREADS=<i>N</
34a0: 69 3e 7d 20 7b 0a 20 20 53 65 74 20 61 6e 20 75  i>} {.  Set an u
34b0: 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68  pper bound on th
34c0: 65 20 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74  e [sqlite3_limit
34d0: 5d 28 64 62 2c 5b 53 51 4c 49 54 45 5f 4c 49 4d  ](db,[SQLITE_LIM
34e0: 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44  IT_WORKER_THREAD
34f0: 53 5d 2c 4e 29 0a 20 20 73 65 74 74 69 6e 67 20  S],N).  setting 
3500: 74 68 61 74 20 64 65 74 65 72 6d 69 6e 65 73 20  that determines 
3510: 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62  the maximum numb
3520: 65 72 20 6f 66 20 61 75 78 69 6c 69 61 72 79 20  er of auxiliary 
3530: 74 68 72 65 61 64 73 20 74 68 61 74 20 61 20 73  threads that a s
3540: 69 6e 67 6c 65 0a 20 20 5b 70 72 65 70 61 72 65  ingle.  [prepare
3550: 64 20 73 74 61 74 65 6d 65 6e 74 5d 20 77 69 6c  d statement] wil
3560: 6c 20 75 73 65 20 74 6f 20 61 69 64 20 77 69 74  l use to aid wit
3570: 68 20 43 50 55 2d 69 6e 74 65 6e 73 69 76 65 20  h CPU-intensive 
3580: 63 6f 6d 70 75 74 61 74 69 6f 6e 73 0a 20 20 28  computations.  (
3590: 6d 6f 73 74 6c 79 20 73 6f 72 74 69 6e 67 29 2e  mostly sorting).
35a0: 20 20 53 65 65 20 61 6c 73 6f 20 74 68 65 20 5b    See also the [
35b0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57  SQLITE_DEFAULT_W
35c0: 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 5d 20 6f  ORKER_THREADS] o
35d0: 70 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  ptions..}..COMPI
35e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
35f0: 45 5f 4d 49 4e 49 4d 55 4d 5f 46 49 4c 45 5f 44  E_MINIMUM_FILE_D
3600: 45 53 43 52 49 50 54 4f 52 3d 3c 69 3e 4e 3c 2f  ESCRIPTOR=<i>N</
3610: 69 3e 7d 20 7b 0a 20 20 54 68 65 20 75 6e 69 78  i>} {.  The unix
3620: 20 5b 56 46 53 5d 20 77 69 6c 6c 20 6e 65 76 65   [VFS] will neve
3630: 72 20 75 73 65 20 61 20 66 69 6c 65 20 64 65 73  r use a file des
3640: 63 72 69 70 74 6f 72 20 6c 65 73 73 20 74 68 61  criptor less tha
3650: 6e 20 3c 69 3e 4e 3c 2f 69 3e 2e 20 20 54 68 65  n <i>N</i>.  The
3660: 0a 20 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65  .  default value
3670: 20 6f 66 20 3c 69 3e 4e 3c 2f 69 3e 20 69 73 20   of <i>N</i> is 
3680: 33 2e 0a 20 20 3c 70 3e 0a 20 20 41 76 6f 69 64  3..  <p>.  Avoid
3690: 69 6e 67 20 74 68 65 20 75 73 65 20 6f 66 20 6c  ing the use of l
36a0: 6f 77 2d 6e 75 6d 62 65 72 65 64 20 66 69 6c 65  ow-numbered file
36b0: 20 64 65 73 63 72 69 70 74 6f 72 73 20 69 73 20   descriptors is 
36c0: 61 20 64 65 66 65 6e 73 65 20 61 67 61 69 6e 73  a defense agains
36d0: 74 0a 20 20 61 63 63 69 64 65 6e 74 61 6c 20 64  t.  accidental d
36e0: 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69  atabase corrupti
36f0: 6f 6e 2e 20 20 49 66 20 61 20 64 61 74 61 62 61  on.  If a databa
3700: 73 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 6e  se file was open
3710: 65 64 20 75 73 69 6e 67 0a 20 20 66 69 6c 65 20  ed using.  file 
3720: 64 65 73 63 72 69 70 74 6f 72 20 32 2c 20 66 6f  descriptor 2, fo
3730: 72 20 65 78 61 6d 70 6c 65 2c 20 61 6e 64 20 74  r example, and t
3740: 68 65 6e 20 61 6e 20 61 73 73 65 72 74 28 29 20  hen an assert() 
3750: 66 61 69 6c 65 64 20 61 6e 64 20 69 6e 76 6f 6b  failed and invok
3760: 65 64 0a 20 20 77 72 69 74 65 28 32 2c 2e 2e 2e  ed.  write(2,...
3770: 29 2c 20 74 68 61 74 20 77 6f 75 6c 64 20 6c 69  ), that would li
3780: 6b 65 6c 79 20 63 61 75 73 65 20 64 61 74 61 62  kely cause datab
3790: 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 62  ase corruption b
37a0: 79 20 6f 76 65 72 77 72 69 74 69 6e 67 0a 20 20  y overwriting.  
37b0: 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 61  part of the data
37c0: 62 61 73 65 20 66 69 6c 65 20 77 69 74 68 20 74  base file with t
37d0: 68 65 20 61 73 73 65 72 74 69 6f 6e 20 65 72 72  he assertion err
37e0: 6f 72 20 6d 65 73 73 61 67 65 2e 20 20 55 73 69  or message.  Usi
37f0: 6e 67 20 6f 6e 6c 79 0a 20 20 68 69 67 68 65 72  ng only.  higher
3800: 2d 76 61 6c 75 65 64 20 66 69 6c 65 20 64 65 73  -valued file des
3810: 63 72 69 70 74 6f 72 73 20 61 76 6f 69 64 73 20  criptors avoids 
3820: 74 68 69 73 20 70 6f 74 65 6e 74 69 61 6c 20 70  this potential p
3830: 72 6f 62 6c 65 6d 2e 20 20 54 68 65 20 0a 20 20  roblem.  The .  
3840: 70 72 6f 74 65 63 74 69 6f 6e 20 61 67 61 69 6e  protection again
3850: 73 74 0a 20 20 75 73 69 6e 67 20 6c 6f 77 2d 6e  st.  using low-n
3860: 75 6d 62 65 72 65 64 20 66 69 6c 65 20 64 65 73  umbered file des
3870: 63 72 69 70 74 6f 72 73 20 63 61 6e 20 62 65 20  criptors can be 
3880: 64 69 73 61 62 6c 65 64 20 62 79 20 73 65 74 74  disabled by sett
3890: 69 6e 67 20 74 68 69 73 0a 20 20 63 6f 6d 70 69  ing this.  compi
38a0: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 74  le-time option t
38b0: 6f 20 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  o 0..}..COMPILE_
38c0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 50  OPTION {SQLITE_P
38d0: 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49  OWERSAFE_OVERWRI
38e0: 54 45 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31  TE=<i>&lt;0 or 1
38f0: 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  &gt;</i>} {.  Th
3900: 69 73 20 6f 70 74 69 6f 6e 20 63 68 61 6e 67 65  is option change
3910: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 73  s the default as
3920: 73 75 6d 70 74 69 6f 6e 20 61 62 6f 75 74 20 5b  sumption about [
3930: 70 6f 77 65 72 73 61 66 65 20 6f 76 65 72 77 72  powersafe overwr
3940: 69 74 65 5d 0a 20 20 66 6f 72 20 74 68 65 20 75  ite].  for the u
3950: 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65 73 79  nderlying filesy
3960: 73 74 65 6d 73 20 66 6f 72 20 74 68 65 20 75 6e  stems for the un
3970: 69 78 20 61 6e 64 20 77 69 6e 64 6f 77 73 20 5b  ix and windows [
3980: 56 46 53 65 73 5d 2e 0a 20 20 53 65 74 74 69 6e  VFSes]..  Settin
3990: 67 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41  g SQLITE_POWERSA
39a0: 46 45 5f 4f 56 45 52 57 52 49 54 45 20 74 6f 20  FE_OVERWRITE to 
39b0: 31 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  1 causes SQLite 
39c0: 74 6f 20 61 73 73 75 6d 65 20 74 68 61 74 0a 20  to assume that. 
39d0: 20 61 70 70 6c 69 63 61 74 69 6f 6e 2d 6c 65 76   application-lev
39e0: 65 6c 20 77 72 69 74 65 73 20 63 61 6e 6e 6f 74  el writes cannot
39f0: 20 63 68 61 6e 67 65 73 20 62 79 74 65 73 20 6f   changes bytes o
3a00: 75 74 73 69 64 65 20 74 68 65 20 72 61 6e 67 65  utside the range
3a10: 20 6f 66 0a 20 20 62 79 74 65 73 20 77 72 69 74   of.  bytes writ
3a20: 74 65 6e 20 65 76 65 6e 20 69 66 20 74 68 65 20  ten even if the 
3a30: 77 72 69 74 65 20 6f 63 63 75 72 73 20 6a 75 73  write occurs jus
3a40: 74 20 62 65 66 6f 72 65 20 61 20 70 6f 77 65 72  t before a power
3a50: 20 6c 6f 73 73 2e 0a 20 20 57 69 74 68 20 53 51   loss..  With SQ
3a60: 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f  LITE_POWERSAFE_O
3a70: 56 45 52 57 52 49 54 45 20 73 65 74 20 74 6f 20  VERWRITE set to 
3a80: 30 2c 20 53 51 4c 69 74 65 20 61 73 73 75 6d 65  0, SQLite assume
3a90: 73 20 74 68 61 74 20 6f 74 68 65 72 0a 20 20 62  s that other.  b
3aa0: 79 74 65 73 20 69 6e 20 74 68 65 20 73 61 6d 65  ytes in the same
3ab0: 20 73 65 63 74 6f 72 20 77 69 74 68 20 61 20 77   sector with a w
3ac0: 72 69 74 74 65 6e 20 62 79 74 65 20 6d 69 67 68  ritten byte migh
3ad0: 74 20 62 65 20 63 68 61 6e 67 65 64 20 6f 72 20  t be changed or 
3ae0: 0a 20 20 64 61 6d 61 67 65 64 20 62 79 20 61 20  .  damaged by a 
3af0: 70 6f 77 65 72 20 6c 6f 73 73 2e 0a 7d 0a 0a 43  power loss..}..C
3b00: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
3b10: 51 4c 49 54 45 5f 52 45 56 45 52 53 45 5f 55 4e  QLITE_REVERSE_UN
3b20: 4f 52 44 45 52 45 44 5f 53 45 4c 45 43 54 53 7d  ORDERED_SELECTS}
3b30: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
3b40: 20 63 61 75 73 65 73 20 74 68 65 20 5b 50 52 41   causes the [PRA
3b50: 47 4d 41 20 72 65 76 65 72 73 65 5f 75 6e 6f 72  GMA reverse_unor
3b60: 64 65 72 65 64 5f 73 65 6c 65 63 74 73 5d 20 73  dered_selects] s
3b70: 65 74 74 69 6e 67 20 74 6f 20 62 65 0a 20 20 65  etting to be.  e
3b80: 6e 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c  nabled by defaul
3b90: 74 2e 20 20 57 68 65 6e 20 65 6e 61 62 6c 65 64  t.  When enabled
3ba0: 2c 20 5b 53 45 4c 45 43 54 5d 20 73 74 61 74 65  , [SELECT] state
3bb0: 6d 65 6e 74 73 20 74 68 61 74 20 6c 61 63 6b 20  ments that lack 
3bc0: 61 6e 0a 20 20 4f 52 44 45 52 20 42 59 20 63 6c  an.  ORDER BY cl
3bd0: 61 75 73 65 20 77 69 6c 6c 20 72 75 6e 20 69 6e  ause will run in
3be0: 20 72 65 76 65 72 73 65 20 6f 72 64 65 72 2e 3c   reverse order.<
3bf0: 70 3e 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e  p>.  This option
3c00: 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 64   is useful for d
3c10: 65 74 65 63 74 69 6e 67 20 77 68 65 6e 20 61 70  etecting when ap
3c20: 70 6c 69 63 61 74 69 6f 6e 73 20 28 69 6e 63 6f  plications (inco
3c30: 72 72 65 63 74 6c 79 29 0a 20 20 61 73 73 75 6d  rrectly).  assum
3c40: 65 20 74 68 61 74 20 74 68 65 20 6f 72 64 65 72  e that the order
3c50: 20 6f 66 20 72 6f 77 73 20 69 6e 20 61 20 53 45   of rows in a SE
3c60: 4c 45 43 54 20 77 69 74 68 6f 75 74 20 61 6e 20  LECT without an 
3c70: 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 0a  ORDER BY clause.
3c80: 20 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65    will always be
3c90: 20 74 68 65 20 73 61 6d 65 2e 0a 7d 0a 0a 43 4f   the same..}..CO
3ca0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
3cb0: 4c 49 54 45 5f 53 4f 52 54 45 52 5f 50 4d 41 53  LITE_SORTER_PMAS
3cc0: 5a 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20  Z=<i>N</i>} {.  
3cd0: 49 66 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65  If multi-threade
3ce0: 64 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20  d processing is 
3cf0: 65 6e 61 62 6c 65 64 20 76 69 61 20 74 68 65 0a  enabled via the.
3d00: 20 20 5b 50 52 41 47 4d 41 20 74 68 72 65 61 64    [PRAGMA thread
3d10: 73 5d 20 73 65 74 74 69 6e 67 2c 20 74 68 65 6e  s] setting, then
3d20: 20 73 6f 72 74 20 6f 70 65 72 61 74 69 6f 6e 73   sort operations
3d30: 20 77 69 6c 6c 0a 20 20 61 74 74 65 6d 70 74 20   will.  attempt 
3d40: 74 6f 20 73 74 61 72 74 20 68 65 6c 70 65 72 20  to start helper 
3d50: 74 68 72 65 61 64 73 20 77 68 65 6e 20 74 68 65  threads when the
3d60: 20 61 6d 6f 75 6e 74 20 6f 66 20 63 6f 6e 74 65   amount of conte
3d70: 6e 74 0a 20 20 74 6f 20 62 65 20 73 6f 72 74 65  nt.  to be sorte
3d80: 64 20 65 78 63 65 65 64 73 20 74 68 65 20 6d 69  d exceeds the mi
3d90: 6e 69 6d 75 6d 20 6f 66 20 74 68 65 20 5b 63 61  nimum of the [ca
3da0: 63 68 65 5f 73 69 7a 65 5d 20 61 6e 64 20 50 4d  che_size] and PM
3db0: 41 20 53 69 7a 65 0a 20 20 64 65 74 65 72 6d 69  A Size.  determi
3dc0: 6e 65 64 20 62 79 20 74 68 65 20 5b 53 51 4c 49  ned by the [SQLI
3dd0: 54 45 5f 43 4f 4e 46 49 47 5f 50 4d 41 53 5a 5d  TE_CONFIG_PMASZ]
3de0: 20 73 74 61 72 74 2d 74 69 6d 65 20 6f 70 74 69   start-time opti
3df0: 6f 6e 2e 0a 20 20 54 68 69 73 20 63 6f 6d 70 69  on..  This compi
3e00: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 73  le-time option s
3e10: 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20  ets the default 
3e20: 76 61 6c 75 65 20 66 6f 72 20 74 68 65 0a 20 20  value for the.  
3e30: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50  [SQLITE_CONFIG_P
3e40: 4d 41 53 5a 5d 20 73 74 61 72 74 2d 74 69 6d 65  MASZ] start-time
3e50: 20 6f 70 74 69 6f 6e 2e 0a 20 20 54 68 65 20 64   option..  The d
3e60: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20  efault value is 
3e70: 32 35 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  250..}..COMPILE_
3e80: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 57  OPTION {SQLITE_W
3e90: 49 4e 33 32 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20  IN32_MALLOC} {. 
3ea0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61   This option ena
3eb0: 62 6c 65 73 20 74 68 65 20 75 73 65 20 6f 66 20  bles the use of 
3ec0: 74 68 65 20 57 69 6e 64 6f 77 73 20 48 65 61 70  the Windows Heap
3ed0: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 66   API functions f
3ee0: 6f 72 20 6d 65 6d 6f 72 79 0a 20 20 61 6c 6c 6f  or memory.  allo
3ef0: 63 61 74 69 6f 6e 20 69 6e 73 74 65 61 64 20 6f  cation instead o
3f00: 66 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6c  f the standard l
3f10: 69 62 72 61 72 79 20 6d 61 6c 6c 6f 63 28 29 20  ibrary malloc() 
3f20: 61 6e 64 20 66 72 65 65 28 29 20 72 6f 75 74 69  and free() routi
3f30: 6e 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  nes..}..COMPILE_
3f40: 4f 50 54 49 4f 4e 20 7b 59 59 53 54 41 43 4b 44  OPTION {YYSTACKD
3f50: 45 50 54 48 3d 3c 69 3e 26 6c 74 3b 6d 61 78 5f  EPTH=<i>&lt;max_
3f60: 64 65 70 74 68 26 67 74 3b 3c 2f 69 3e 7d 20 7b  depth&gt;</i>} {
3f70: 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65  .  This macro se
3f80: 74 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64  ts the maximum d
3f90: 65 70 74 68 20 6f 66 20 74 68 65 20 4c 41 4c 52  epth of the LALR
3fa0: 28 31 29 20 73 74 61 63 6b 20 75 73 65 64 20 62  (1) stack used b
3fb0: 79 0a 20 20 74 68 65 20 53 51 4c 20 70 61 72 73  y.  the SQL pars
3fc0: 65 72 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65  er within SQLite
3fd0: 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 76  .  The default v
3fe0: 61 6c 75 65 20 69 73 20 31 30 30 2e 20 20 41 20  alue is 100.  A 
3ff0: 74 79 70 69 63 61 6c 0a 20 20 61 70 70 6c 69 63  typical.  applic
4000: 61 74 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20 6c  ation will use l
4010: 65 73 73 20 74 68 61 6e 20 61 62 6f 75 74 20 32  ess than about 2
4020: 30 20 6c 65 76 65 6c 73 20 6f 66 20 74 68 65 20  0 levels of the 
4030: 73 74 61 63 6b 2e 0a 20 20 44 65 76 65 6c 6f 70  stack..  Develop
4040: 65 72 73 20 77 68 6f 73 65 20 61 70 70 6c 69 63  ers whose applic
4050: 61 74 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 20 53  ations contain S
4060: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68  QL statements th
4070: 61 74 20 0a 20 20 6e 65 65 64 20 6d 6f 72 65 20  at .  need more 
4080: 74 68 61 6e 20 31 30 30 20 4c 41 4c 52 28 31 29  than 100 LALR(1)
4090: 20 73 74 61 63 6b 20 65 6e 74 72 69 65 73 20 73   stack entries s
40a0: 68 6f 75 6c 64 20 73 65 72 69 6f 75 73 6c 79 0a  hould seriously.
40b0: 20 20 63 6f 6e 73 69 64 65 72 20 72 65 66 61 63    consider refac
40c0: 74 6f 72 69 6e 67 20 74 68 65 69 72 20 53 51 4c  toring their SQL
40d0: 20 61 73 20 69 74 20 69 73 20 6c 69 6b 65 6c 79   as it is likely
40e0: 20 74 6f 20 62 65 20 77 65 6c 6c 20 62 65 79 6f   to be well beyo
40f0: 6e 64 0a 20 20 74 68 65 20 61 62 69 6c 69 74 79  nd.  the ability
4100: 20 6f 66 20 61 6e 79 20 68 75 6d 61 6e 20 74 6f   of any human to
4110: 20 63 6f 6d 70 72 65 68 65 6e 64 2e 0a 7d 0a 3c   comprehend..}.<
4120: 2f 74 63 6c 3e 0a 0a 3c 68 32 3e 31 2e 33 20 4f  /tcl>..<h2>1.3 O
4130: 70 74 69 6f 6e 73 20 54 6f 20 53 65 74 20 53 69  ptions To Set Si
4140: 7a 65 20 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a 0a  ze Limits</h2>..
4150: 3c 70 3e 54 68 65 72 65 20 61 72 65 20 63 6f 6d  <p>There are com
4160: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
4170: 73 20 74 68 61 74 20 77 69 6c 6c 20 73 65 74 20  s that will set 
4180: 75 70 70 65 72 20 62 6f 75 6e 64 73 0a 6f 6e 20  upper bounds.on 
4190: 74 68 65 20 73 69 7a 65 73 20 6f 66 20 76 61 72  the sizes of var
41a0: 69 6f 75 73 20 73 74 72 75 63 74 75 72 65 73 20  ious structures 
41b0: 69 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65 20  in SQLite.  The 
41c0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74  compile-time.opt
41d0: 69 6f 6e 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65  ions normally se
41e0: 74 20 61 20 68 61 72 64 20 75 70 70 65 72 20 62  t a hard upper b
41f0: 6f 75 6e 64 20 74 68 61 74 20 63 61 6e 20 62 65  ound that can be
4200: 20 63 68 61 6e 67 65 64 0a 61 74 20 72 75 6e 2d   changed.at run-
4210: 74 69 6d 65 20 6f 6e 20 69 6e 64 69 76 69 64 75  time on individu
4220: 61 6c 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e  al [database con
4230: 6e 65 63 74 69 6f 6e 73 5d 20 75 73 69 6e 67 20  nections] using 
4240: 74 68 65 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d  the.[sqlite3_lim
4250: 69 74 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e  it()] interface.
4260: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d  </p>..<p>The com
4270: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
4280: 73 20 66 6f 72 20 73 65 74 74 69 6e 67 20 75 70  s for setting up
4290: 70 65 72 20 62 6f 75 6e 64 73 20 61 72 65 0a 5b  per bounds are.[
42a0: 6c 69 6d 69 74 73 20 7c 20 64 6f 63 75 6d 65 6e  limits | documen
42b0: 74 65 64 20 73 65 70 61 72 61 74 65 6c 79 5d 2e  ted separately].
42c0: 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20    The following 
42d0: 69 73 20 61 20 6c 69 73 74 20 6f 66 0a 74 68 65  is a list of.the
42e0: 20 61 76 61 69 6c 61 62 6c 65 20 73 65 74 74 69   available setti
42f0: 6e 67 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c  ngs:</p>..<ul>.<
4300: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f  li> [SQLITE_MAX_
4310: 41 54 54 41 43 48 45 44 5d 20 20 3c 2f 6c 69 3e  ATTACHED]  </li>
4320: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41  .<li> [SQLITE_MA
4330: 58 5f 43 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69 3e  X_COLUMN]  </li>
4340: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41  .<li> [SQLITE_MA
4350: 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43  X_COMPOUND_SELEC
4360: 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b  T]  </li>.<li> [
4370: 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f  SQLITE_MAX_EXPR_
4380: 44 45 50 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  DEPTH]  </li>.<l
4390: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 46  i> [SQLITE_MAX_F
43a0: 55 4e 43 54 49 4f 4e 5f 41 52 47 5d 20 20 3c 2f  UNCTION_ARG]  </
43b0: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45  li>.<li> [SQLITE
43c0: 5f 4d 41 58 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f  _MAX_LENGTH]  </
43d0: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45  li>.<li> [SQLITE
43e0: 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52  _MAX_LIKE_PATTER
43f0: 4e 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e  N_LENGTH]  </li>
4400: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41  .<li> [SQLITE_MA
4410: 58 5f 50 41 47 45 5f 43 4f 55 4e 54 5d 20 20 3c  X_PAGE_COUNT]  <
4420: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
4430: 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48  E_MAX_SQL_LENGTH
4440: 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53  ]  </li>.<li> [S
4450: 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42  QLITE_MAX_VARIAB
4460: 4c 45 5f 4e 55 4d 42 45 52 5d 20 20 3c 2f 6c 69  LE_NUMBER]  </li
4470: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 61 20 6e 61 6d 65  >.</ul>..<a name
4480: 3d 22 63 6f 6e 74 72 6f 6c 66 65 61 74 75 72 65  ="controlfeature
4490: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 34 20  s"></a>.<h2>1.4 
44a0: 4f 70 74 69 6f 6e 73 20 54 6f 20 43 6f 6e 74 72  Options To Contr
44b0: 6f 6c 20 4f 70 65 72 61 74 69 6e 67 20 43 68 61  ol Operating Cha
44c0: 72 61 63 74 65 72 69 73 74 69 63 73 3c 2f 68 32  racteristics</h2
44d0: 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45  >..<tcl>.COMPILE
44e0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
44f0: 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d  4_BYTE_ALIGNED_M
4500: 41 4c 4c 4f 43 7d 20 7b 0a 20 20 4f 6e 20 6d 6f  ALLOC} {.  On mo
4510: 73 74 20 73 79 73 74 65 6d 73 2c 20 74 68 65 20  st systems, the 
4520: 6d 61 6c 6c 6f 63 28 29 20 73 79 73 74 65 6d 20  malloc() system 
4530: 63 61 6c 6c 20 72 65 74 75 72 6e 73 20 61 20 62  call returns a b
4540: 75 66 66 65 72 20 74 68 61 74 20 69 73 0a 20 20  uffer that is.  
4550: 61 6c 69 67 6e 65 64 20 74 6f 20 61 6e 20 38 2d  aligned to an 8-
4560: 62 79 74 65 20 62 6f 75 6e 64 61 72 79 2e 20 20  byte boundary.  
4570: 42 75 74 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74  But on some syst
4580: 65 6d 73 20 28 65 78 3a 20 77 69 6e 64 6f 77 73  ems (ex: windows
4590: 29 20 6d 61 6c 6c 6f 63 28 29 0a 20 20 72 65 74  ) malloc().  ret
45a0: 75 72 6e 73 20 34 2d 62 79 74 65 20 61 6c 69 67  urns 4-byte alig
45b0: 6e 65 64 20 70 6f 69 6e 74 65 72 2e 20 20 54 68  ned pointer.  Th
45c0: 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  is compile-time 
45d0: 6f 70 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 75  option must be u
45e0: 73 65 64 0a 20 20 6f 6e 20 73 79 73 74 65 6d 73  sed.  on systems
45f0: 20 74 68 61 74 20 72 65 74 75 72 6e 20 34 2d 62   that return 4-b
4600: 79 74 65 20 61 6c 69 67 6e 65 64 20 70 6f 69 6e  yte aligned poin
4610: 74 65 72 73 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63  ters from malloc
4620: 28 29 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ()..}..COMPILE_O
4630: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 43 41  PTION {SQLITE_CA
4640: 53 45 5f 53 45 4e 53 49 54 49 56 45 5f 4c 49 4b  SE_SENSITIVE_LIK
4650: 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f  E} {.  If this o
4660: 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e 74  ption is present
4670: 2c 20 74 68 65 6e 20 74 68 65 20 62 75 69 6c 74  , then the built
4680: 2d 69 6e 20 5b 4c 49 4b 45 5d 20 6f 70 65 72 61  -in [LIKE] opera
4690: 74 6f 72 20 77 69 6c 6c 20 62 65 0a 20 20 63 61  tor will be.  ca
46a0: 73 65 20 73 65 6e 73 69 74 69 76 65 2e 20 20 54  se sensitive.  T
46b0: 68 69 73 20 73 61 6d 65 20 65 66 66 65 63 74 20  his same effect 
46c0: 63 61 6e 20 62 65 20 61 63 68 69 65 76 65 64 20  can be achieved 
46d0: 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e  at run-time usin
46e0: 67 0a 20 20 74 68 65 20 5b 63 61 73 65 5f 73 65  g.  the [case_se
46f0: 6e 73 69 74 69 76 65 5f 6c 69 6b 65 20 70 72 61  nsitive_like pra
4700: 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  gma]..}..COMPILE
4710: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4720: 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f  DIRECT_OVERFLOW_
4730: 52 45 41 44 7d 20 7b 0a 20 20 57 68 65 6e 20 74  READ} {.  When t
4740: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 70 72  his option is pr
4750: 65 73 65 6e 74 2c 20 63 6f 6e 74 65 6e 74 20 63  esent, content c
4760: 6f 6e 74 61 69 6e 65 64 20 69 6e 0a 20 20 5b 6f  ontained in.  [o
4770: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 5d 20 6f  verflow pages] o
4780: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
4790: 69 6c 65 20 69 73 20 72 65 61 64 20 64 69 72 65  ile is read dire
47a0: 63 74 6c 79 20 66 72 6f 6d 20 64 69 73 6b 2c 0a  ctly from disk,.
47b0: 20 20 62 79 70 61 73 73 69 6e 67 20 74 68 65 20    bypassing the 
47c0: 5b 70 61 67 65 20 63 61 63 68 65 5d 2c 20 64 75  [page cache], du
47d0: 72 69 6e 67 20 72 65 61 64 20 74 72 61 6e 73 61  ring read transa
47e0: 63 74 69 6f 6e 73 2e 20 20 49 6e 20 61 70 70 6c  ctions.  In appl
47f0: 69 63 61 74 69 6f 6e 73 0a 20 20 74 68 61 74 20  ications.  that 
4800: 64 6f 20 61 20 6c 6f 74 20 6f 66 20 72 65 61 64  do a lot of read
4810: 73 20 6f 66 20 6c 61 72 67 65 20 42 4c 4f 42 73  s of large BLOBs
4820: 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 69  , this option mi
4830: 67 68 74 20 69 6d 70 72 6f 76 65 20 72 65 61 64  ght improve read
4840: 0a 20 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a  .  performance..
4850: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
4860: 4e 20 7b 53 51 4c 49 54 45 5f 48 41 56 45 5f 49  N {SQLITE_HAVE_I
4870: 53 4e 41 4e 7d 20 7b 0a 20 20 49 66 20 74 68 69  SNAN} {.  If thi
4880: 73 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73  s option is pres
4890: 65 6e 74 2c 20 74 68 65 6e 20 53 51 4c 69 74 65  ent, then SQLite
48a0: 20 77 69 6c 6c 20 75 73 65 20 74 68 65 20 69 73   will use the is
48b0: 6e 61 6e 28 29 20 66 75 6e 63 74 69 6f 6e 20 66  nan() function f
48c0: 72 6f 6d 0a 20 20 74 68 65 20 73 79 73 74 65 6d  rom.  the system
48d0: 20 6d 61 74 68 20 6c 69 62 72 61 72 79 2e 20 20   math library.  
48e0: 54 68 69 73 20 69 73 20 61 6e 20 61 6c 69 61 73  This is an alias
48f0: 20 66 6f 72 20 74 68 65 20 5b 48 41 56 45 5f 49   for the [HAVE_I
4900: 53 4e 41 4e 5d 20 63 6f 6e 66 69 67 75 72 61 74  SNAN] configurat
4910: 69 6f 6e 0a 20 20 6f 70 74 69 6f 6e 2e 0a 7d 0a  ion.  option..}.
4920: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4930: 7b 53 51 4c 49 54 45 5f 4f 53 5f 4f 54 48 45 52  {SQLITE_OS_OTHER
4940: 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 26 67  =<i>&lt;0 or 1&g
4950: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 65 20  t;</i>} {.  The 
4960: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51  option causes SQ
4970: 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 69 74 73  Lite to omit its
4980: 20 62 75 69 6c 74 2d 69 6e 20 6f 70 65 72 61 74   built-in operat
4990: 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65 72  ing system inter
49a0: 66 61 63 65 73 0a 20 20 66 6f 72 20 55 6e 69 78  faces.  for Unix
49b0: 2c 20 57 69 6e 64 6f 77 73 2c 20 61 6e 64 20 4f  , Windows, and O
49c0: 53 2f 32 2e 20 20 54 68 65 20 72 65 73 75 6c 74  S/2.  The result
49d0: 69 6e 67 20 6c 69 62 72 61 72 79 20 77 69 6c 6c  ing library will
49e0: 20 68 61 76 65 20 6e 6f 20 64 65 66 61 75 6c 74   have no default
49f0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 20  .  [sqlite3_vfs 
4a00: 7c 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  | operating syst
4a10: 65 6d 20 69 6e 74 65 72 66 61 63 65 5d 2e 20 20  em interface].  
4a20: 41 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75 73  Applications mus
4a30: 74 20 75 73 65 0a 20 20 5b 73 71 6c 69 74 65 33  t use.  [sqlite3
4a40: 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 5d  _vfs_register()]
4a50: 20 74 6f 20 72 65 67 69 73 74 65 72 20 61 6e 20   to register an 
4a60: 61 70 70 72 6f 70 72 69 61 74 65 20 69 6e 74 65  appropriate inte
4a70: 72 66 61 63 65 20 62 65 66 6f 72 65 0a 20 20 75  rface before.  u
4a80: 73 69 6e 67 20 53 51 4c 69 74 65 2e 20 20 41 70  sing SQLite.  Ap
4a90: 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75 73 74 20  plications must 
4aa0: 61 6c 73 6f 20 73 75 70 70 6c 79 20 69 6d 70 6c  also supply impl
4ab0: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 66 6f 72 20  ementations for 
4ac0: 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f  the.  [sqlite3_o
4ad0: 73 5f 69 6e 69 74 28 29 5d 20 61 6e 64 20 5b 73  s_init()] and [s
4ae0: 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 28 29 5d  qlite3_os_end()]
4af0: 20 69 6e 74 65 72 66 61 63 65 73 2e 20 20 54 68   interfaces.  Th
4b00: 65 20 75 73 75 61 6c 20 70 72 61 63 74 69 63 65  e usual practice
4b10: 0a 20 20 69 73 20 66 6f 72 20 74 68 65 20 73 75  .  is for the su
4b20: 70 70 6c 69 65 64 20 5b 73 71 6c 69 74 65 33 5f  pplied [sqlite3_
4b30: 6f 73 5f 69 6e 69 74 28 29 5d 20 74 6f 20 69 6e  os_init()] to in
4b40: 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 76 66  voke [sqlite3_vf
4b50: 73 5f 72 65 67 69 73 74 65 72 28 29 5d 2e 0a 20  s_register()].. 
4b60: 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 61 75 74   SQLite will aut
4b70: 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f 6b  omatically invok
4b80: 65 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69 6e  e [sqlite3_os_in
4b90: 69 74 28 29 5d 20 77 68 65 6e 20 69 74 20 69 6e  it()] when it in
4ba0: 69 74 69 61 6c 69 7a 65 73 2e 0a 0a 20 20 54 68  itializes...  Th
4bb0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 74 79 70  is option is typ
4bc0: 69 63 61 6c 6c 79 20 75 73 65 64 20 77 68 65 6e  ically used when
4bd0: 20 62 75 69 6c 64 69 6e 67 20 53 51 4c 69 74 65   building SQLite
4be0: 20 66 6f 72 20 61 6e 20 65 6d 62 65 64 64 65 64   for an embedded
4bf0: 0a 20 20 70 6c 61 74 66 6f 72 6d 20 77 69 74 68  .  platform with
4c00: 20 61 20 63 75 73 74 6f 6d 20 6f 70 65 72 61 74   a custom operat
4c10: 69 6e 67 20 73 79 73 74 65 6d 2e 0a 7d 0a 0a 43  ing system..}..C
4c20: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
4c30: 51 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45 4c  QLITE_SECURE_DEL
4c40: 45 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 63 6f  ETE} {.  This co
4c50: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
4c60: 6e 20 63 68 61 6e 67 65 73 20 74 68 65 20 64 65  n changes the de
4c70: 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 6f 66  fault setting of
4c80: 20 74 68 65 0a 20 20 5b 73 65 63 75 72 65 5f 64   the.  [secure_d
4c90: 65 6c 65 74 65 20 70 72 61 67 6d 61 5d 2e 20 20  elete pragma].  
4ca0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
4cb0: 20 69 73 20 6e 6f 74 20 75 73 65 64 2c 20 73 65   is not used, se
4cc0: 63 75 72 65 5f 64 65 6c 65 74 65 20 64 65 66 61  cure_delete defa
4cd0: 75 6c 74 73 0a 20 20 74 6f 20 6f 66 66 2e 20 20  ults.  to off.  
4ce0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
4cf0: 20 69 73 20 70 72 65 73 65 6e 74 2c 20 73 65 63   is present, sec
4d00: 75 72 65 5f 64 65 6c 65 74 65 20 64 65 66 61 75  ure_delete defau
4d10: 6c 74 73 20 74 6f 20 6f 6e 2e 0a 0a 20 20 54 68  lts to on...  Th
4d20: 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20  e secure_delete 
4d30: 73 65 74 74 69 6e 67 20 63 61 75 73 65 73 20 64  setting causes d
4d40: 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74 20 74  eleted content t
4d50: 6f 20 62 65 20 6f 76 65 72 77 72 69 74 74 65 6e  o be overwritten
4d60: 20 77 69 74 68 0a 20 20 7a 65 72 6f 73 2e 20 20   with.  zeros.  
4d70: 54 68 65 72 65 20 69 73 20 61 20 73 6d 61 6c 6c  There is a small
4d80: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e   performance pen
4d90: 61 6c 74 79 20 66 6f 72 20 74 68 69 73 20 73 69  alty for this si
4da0: 6e 63 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 49  nce additional I
4db0: 2f 4f 0a 20 20 6d 75 73 74 20 6f 63 63 75 72 2e  /O.  must occur.
4dc0: 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68    On the other h
4dd0: 61 6e 64 2c 20 73 65 63 75 72 65 5f 64 65 6c 65  and, secure_dele
4de0: 74 65 20 63 61 6e 20 70 72 65 76 65 6e 74 20 73  te can prevent s
4df0: 65 6e 73 69 74 69 76 65 20 0a 20 20 69 6e 66 6f  ensitive .  info
4e00: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 6c 69 6e  rmation from lin
4e10: 67 65 72 69 6e 67 20 69 6e 20 75 6e 75 73 65 64  gering in unused
4e20: 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 64 61   parts of the da
4e30: 74 61 62 61 73 65 20 66 69 6c 65 20 61 66 74 65  tabase file afte
4e40: 72 20 69 74 0a 20 20 68 61 73 20 61 6c 6c 65 67  r it.  has alleg
4e50: 65 64 6c 79 20 62 65 65 6e 20 64 65 6c 65 74 65  edly been delete
4e60: 64 2e 20 20 53 65 65 20 74 68 65 20 64 6f 63 75  d.  See the docu
4e70: 6d 65 6e 74 61 74 69 6f 6e 20 6f 6e 20 74 68 65  mentation on the
4e80: 0a 20 20 5b 73 65 63 75 72 65 5f 64 65 6c 65 74  .  [secure_delet
4e90: 65 20 70 72 61 67 6d 61 5d 20 66 6f 72 20 61 64  e pragma] for ad
4ea0: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
4eb0: 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tion..}..COMPILE
4ec0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4ed0: 54 48 52 45 41 44 53 41 46 45 3d 3c 69 3e 26 6c  THREADSAFE=<i>&l
4ee0: 74 3b 30 20 6f 72 20 31 20 6f 72 20 32 26 67 74  t;0 or 1 or 2&gt
4ef0: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
4f00: 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20  option controls 
4f10: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 63  whether or not c
4f20: 6f 64 65 20 69 73 20 69 6e 63 6c 75 64 65 64 20  ode is included 
4f30: 69 6e 20 53 51 4c 69 74 65 20 74 6f 0a 20 20 65  in SQLite to.  e
4f40: 6e 61 62 6c 65 20 69 74 20 74 6f 20 6f 70 65 72  nable it to oper
4f50: 61 74 65 20 73 61 66 65 6c 79 20 69 6e 20 61 20  ate safely in a 
4f60: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 65 6e  multithreaded en
4f70: 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 54 68 65 0a  vironment.  The.
4f80: 20 20 64 65 66 61 75 6c 74 20 69 73 20 53 51 4c    default is SQL
4f90: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 31  ITE_THREADSAFE=1
4fa0: 20 77 68 69 63 68 20 69 73 20 73 61 66 65 20 66   which is safe f
4fb0: 6f 72 20 75 73 65 20 69 6e 20 61 20 6d 75 6c 74  or use in a mult
4fc0: 69 74 68 72 65 61 64 65 64 0a 20 20 65 6e 76 69  ithreaded.  envi
4fd0: 72 6f 6e 6d 65 6e 74 2e 20 20 57 68 65 6e 20 63  ronment.  When c
4fe0: 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c  ompiled with SQL
4ff0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 30  ITE_THREADSAFE=0
5000: 20 61 6c 6c 20 6d 75 74 65 78 69 6e 67 20 63 6f   all mutexing co
5010: 64 65 0a 20 20 69 73 20 6f 6d 69 74 74 65 64 20  de.  is omitted 
5020: 61 6e 64 20 69 74 20 69 73 20 75 6e 73 61 66 65  and it is unsafe
5030: 20 74 6f 20 75 73 65 20 53 51 4c 69 74 65 20 69   to use SQLite i
5040: 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65  n a multithreade
5050: 64 20 70 72 6f 67 72 61 6d 2e 0a 20 20 57 68 65  d program..  Whe
5060: 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20  n compiled with 
5070: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
5080: 45 3d 32 2c 20 53 51 4c 69 74 65 20 63 61 6e 20  E=2, SQLite can 
5090: 62 65 20 75 73 65 64 20 69 6e 20 61 20 6d 75 6c  be used in a mul
50a0: 74 69 74 68 72 65 61 64 65 64 0a 20 20 70 72 6f  tithreaded.  pro
50b0: 67 72 61 6d 20 73 6f 20 6c 6f 6e 67 20 61 73 20  gram so long as 
50c0: 6e 6f 20 74 77 6f 20 74 68 72 65 61 64 73 20 61  no two threads a
50d0: 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74 68  ttempt to use th
50e0: 65 20 73 61 6d 65 0a 20 20 5b 64 61 74 61 62 61  e same.  [databa
50f0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 5d 20 28  se connection] (
5100: 6f 72 20 61 6e 79 20 5b 70 72 65 70 61 72 65 64  or any [prepared
5110: 20 73 74 61 74 65 6d 65 6e 74 73 5d 20 64 65 72   statements] der
5120: 69 76 65 64 20 66 72 6f 6d 0a 20 20 74 68 61 74  ived from.  that
5130: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
5140: 74 69 6f 6e 29 20 61 74 20 74 68 65 20 73 61 6d  tion) at the sam
5150: 65 20 74 69 6d 65 2e 0a 0a 20 20 54 6f 20 70 75  e time...  To pu
5160: 74 20 69 74 20 61 6e 6f 74 68 65 72 20 77 61 79  t it another way
5170: 2c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  , SQLITE_THREADS
5180: 41 46 45 3d 31 20 73 65 74 73 20 74 68 65 20 64  AFE=1 sets the d
5190: 65 66 61 75 6c 74 0a 20 20 5b 74 68 72 65 61 64  efault.  [thread
51a0: 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 53 65 72  ing mode] to Ser
51b0: 69 61 6c 69 7a 65 64 2e 20 20 53 51 4c 49 54 45  ialized.  SQLITE
51c0: 5f 54 48 52 45 41 44 53 41 46 45 3d 32 20 73 65  _THREADSAFE=2 se
51d0: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20  ts the default. 
51e0: 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65   [threading mode
51f0: 5d 20 74 6f 20 4d 75 6c 74 69 2d 74 68 72 65 61  ] to Multi-threa
5200: 64 65 64 2e 20 20 41 6e 64 20 53 51 4c 49 54 45  ded.  And SQLITE
5210: 5f 54 48 52 45 41 44 53 41 46 45 3d 30 20 73 65  _THREADSAFE=0 se
5220: 74 73 20 74 68 65 0a 20 20 5b 74 68 72 65 61 64  ts the.  [thread
5230: 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 53 69 6e  ing mode] to Sin
5240: 67 6c 65 2d 74 68 72 65 61 64 65 64 2e 0a 0a 20  gle-threaded... 
5250: 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 53 51   The value of SQ
5260: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20  LITE_THREADSAFE 
5270: 63 61 6e 20 62 65 20 64 65 74 65 72 6d 69 6e 65  can be determine
5280: 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 20  d at run-time.  
5290: 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74  using the [sqlit
52a0: 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 29 5d  e3_threadsafe()]
52b0: 20 69 6e 74 65 72 66 61 63 65 2e 0a 0a 20 20 57   interface...  W
52c0: 68 65 6e 20 53 51 4c 69 74 65 20 68 61 73 20 62  hen SQLite has b
52d0: 65 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74  een compiled wit
52e0: 68 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  h SQLITE_THREADS
52f0: 41 46 45 3d 31 20 6f 72 0a 20 20 53 51 4c 49 54  AFE=1 or.  SQLIT
5300: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 32 20 74  E_THREADSAFE=2 t
5310: 68 65 6e 20 74 68 65 20 5b 74 68 72 65 61 64 69  hen the [threadi
5320: 6e 67 20 6d 6f 64 65 5d 0a 20 20 63 61 6e 20 62  ng mode].  can b
5330: 65 20 61 6c 74 65 72 65 64 20 61 74 20 72 75 6e  e altered at run
5340: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 20  -time using the 
5350: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28  [sqlite3_config(
5360: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 67  )] interface tog
5370: 65 74 68 65 72 0a 20 20 77 69 74 68 20 6f 6e 65  ether.  with one
5380: 20 6f 66 20 74 68 65 73 65 20 76 65 72 62 73 3a   of these verbs:
5390: 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c 6c 69 3e 5b  ..  <ul>.  <li>[
53a0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 49  SQLITE_CONFIG_SI
53b0: 4e 47 4c 45 54 48 52 45 41 44 5d 0a 20 20 3c 6c  NGLETHREAD].  <l
53c0: 69 3e 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  i>[SQLITE_CONFIG
53d0: 5f 4d 55 4c 54 49 54 48 52 45 41 44 5d 0a 20 20  _MULTITHREAD].  
53e0: 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  <li>[SQLITE_CONF
53f0: 49 47 5f 53 45 52 49 41 4c 49 5a 45 44 5d 0a 20  IG_SERIALIZED]. 
5400: 20 3c 2f 75 6c 3e 0a 0a 20 20 54 68 65 20 5b 53   </ul>..  The [S
5410: 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54  QLITE_OPEN_NOMUT
5420: 45 58 5d 20 61 6e 64 0a 20 20 5b 53 51 4c 49 54  EX] and.  [SQLIT
5430: 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45 58  E_OPEN_FULLMUTEX
5440: 5d 20 66 6c 61 67 73 20 74 6f 20 5b 73 71 6c 69  ] flags to [sqli
5450: 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d 20 63  te3_open_v2()] c
5460: 61 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64 0a  an also be used.
5470: 20 20 74 6f 20 61 64 6a 75 73 74 20 74 68 65 20    to adjust the 
5480: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
5490: 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c 20 5b   of individual [
54a0: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
54b0: 69 6f 6e 73 5d 0a 20 20 61 74 20 72 75 6e 2d 74  ions].  at run-t
54c0: 69 6d 65 2e 0a 0a 20 20 4e 6f 74 65 20 74 68 61  ime...  Note tha
54d0: 74 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73  t when SQLite is
54e0: 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53   compiled with S
54f0: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45  QLITE_THREADSAFE
5500: 3d 30 2c 20 74 68 65 20 63 6f 64 65 0a 20 20 74  =0, the code.  t
5510: 6f 20 6d 61 6b 65 20 53 51 4c 69 74 65 20 74 68  o make SQLite th
5520: 72 65 61 64 73 61 66 65 20 69 73 20 6f 6d 69 74  readsafe is omit
5530: 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69  ted from the bui
5540: 6c 64 2e 20 20 57 68 65 6e 20 74 68 69 73 20 6f  ld.  When this o
5550: 63 63 75 72 73 2c 0a 20 20 69 74 20 69 73 20 69  ccurs,.  it is i
5560: 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 68 61  mpossible to cha
5570: 6e 67 65 20 74 68 65 20 5b 74 68 72 65 61 64 69  nge the [threadi
5580: 6e 67 20 6d 6f 64 65 5d 20 61 74 20 73 74 61 72  ng mode] at star
5590: 74 2d 74 69 6d 65 20 6f 72 20 72 75 6e 2d 74 69  t-time or run-ti
55a0: 6d 65 2e 0a 0a 20 20 53 65 65 20 74 68 65 20 5b  me...  See the [
55b0: 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20  threading mode] 
55c0: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f  documentation fo
55d0: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
55e0: 6f 72 6d 61 74 69 6f 6e 0a 20 20 6f 6e 20 61 73  ormation.  on as
55f0: 70 65 63 74 73 20 6f 66 20 75 73 69 6e 67 20 53  pects of using S
5600: 51 4c 69 74 65 20 69 6e 20 61 20 6d 75 6c 74 69  QLite in a multi
5610: 74 68 72 65 61 64 65 64 20 65 6e 76 69 72 6f 6e  threaded environ
5620: 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ment..}..COMPILE
5630: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
5640: 54 45 4d 50 5f 53 54 4f 52 45 3d 3c 69 3e 26 6c  TEMP_STORE=<i>&l
5650: 74 3b 30 20 74 68 72 6f 75 67 68 20 33 26 67 74  t;0 through 3&gt
5660: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
5670: 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20  option controls 
5680: 77 68 65 74 68 65 72 20 74 65 6d 70 6f 72 61 72  whether temporar
5690: 79 20 66 69 6c 65 73 20 61 72 65 20 73 74 6f 72  y files are stor
56a0: 65 64 20 6f 6e 20 64 69 73 6b 20 6f 72 0a 20 20  ed on disk or.  
56b0: 69 6e 20 6d 65 6d 6f 72 79 2e 20 20 54 68 65 20  in memory.  The 
56c0: 6d 65 61 6e 69 6e 67 73 20 66 6f 72 20 76 61 72  meanings for var
56d0: 69 6f 75 73 20 73 65 74 74 69 6e 67 73 20 6f 66  ious settings of
56e0: 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69   this compile-ti
56f0: 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 61 72 65 20  me.  option are 
5700: 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 3c  as follows:..  <
5710: 74 61 62 6c 65 20 63 65 6c 6c 70 61 64 64 69 6e  table cellpaddin
5720: 67 3d 22 32 22 20 62 6f 72 64 65 72 3d 22 31 22  g="2" border="1"
5730: 3e 0a 20 20 3c 74 72 3e 3c 74 68 3e 53 51 4c 49  >.  <tr><th>SQLI
5740: 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3c 2f 74  TE_TEMP_STORE</t
5750: 68 3e 3c 74 68 3e 4d 65 61 6e 69 6e 67 3c 2f 74  h><th>Meaning</t
5760: 68 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74  h></tr>.  <tr><t
5770: 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22  d align="center"
5780: 3e 30 3c 2f 74 64 3e 3c 74 64 3e 41 6c 77 61 79  >0</td><td>Alway
5790: 73 20 75 73 65 20 74 65 6d 70 6f 72 61 72 79 20  s use temporary 
57a0: 66 69 6c 65 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0a  files</td></tr>.
57b0: 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d    <tr><td align=
57c0: 22 63 65 6e 74 65 72 22 3e 31 3c 2f 74 64 3e 3c  "center">1</td><
57d0: 74 64 3e 55 73 65 20 66 69 6c 65 73 20 62 79 20  td>Use files by 
57e0: 64 65 66 61 75 6c 74 20 62 75 74 20 61 6c 6c 6f  default but allo
57f0: 77 20 74 68 65 0a 20 20 5b 50 52 41 47 4d 41 20  w the.  [PRAGMA 
5800: 74 65 6d 70 5f 73 74 6f 72 65 5d 20 63 6f 6d 6d  temp_store] comm
5810: 61 6e 64 20 74 6f 20 6f 76 65 72 72 69 64 65 3c  and to override<
5820: 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e  /td></tr>.  <tr>
5830: 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65  <td align="cente
5840: 72 22 3e 32 3c 2f 74 64 3e 3c 74 64 3e 55 73 65  r">2</td><td>Use
5850: 20 6d 65 6d 6f 72 79 20 62 79 20 64 65 66 61 75   memory by defau
5860: 6c 74 20 62 75 74 20 61 6c 6c 6f 77 20 74 68 65  lt but allow the
5870: 0a 20 20 5b 50 52 41 47 4d 41 20 74 65 6d 70 5f  .  [PRAGMA temp_
5880: 73 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e 64 20 74  store] command t
5890: 6f 20 6f 76 65 72 72 69 64 65 3c 2f 74 64 3e 3c  o override</td><
58a0: 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61  /tr>.  <tr><td a
58b0: 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 33 3c  lign="center">3<
58c0: 2f 74 64 3e 3c 74 64 3e 41 6c 77 61 79 73 20 75  /td><td>Always u
58d0: 73 65 20 6d 65 6d 6f 72 79 3c 2f 74 64 3e 3c 2f  se memory</td></
58e0: 74 72 3e 0a 20 20 3c 2f 74 61 62 6c 65 3e 0a 0a  tr>.  </table>..
58f0: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 65    The default se
5900: 74 74 69 6e 67 20 69 73 20 31 2e 20 20 0a 20 20  tting is 1.  .  
5910: 41 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72  Additional infor
5920: 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 66 6f  mation can be fo
5930: 75 6e 64 20 69 6e 20 5b 74 65 6d 70 73 74 6f 72  und in [tempstor
5940: 65 20 7c 20 74 65 6d 70 66 69 6c 65 73 2e 68 74  e | tempfiles.ht
5950: 6d 6c 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ml]..}..COMPILE_
5960: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 54  OPTION {SQLITE_T
5970: 52 41 43 45 5f 53 49 5a 45 5f 4c 49 4d 49 54 3d  RACE_SIZE_LIMIT=
5980: 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 49 66  <i>N</i>} {.  If
5990: 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64   this macro is d
59a0: 65 66 69 6e 65 64 20 74 6f 20 61 20 70 6f 73 69  efined to a posi
59b0: 74 69 76 65 20 69 6e 74 65 67 65 72 20 3c 69 3e  tive integer <i>
59c0: 4e 3c 2f 69 3e 2c 20 74 68 65 6e 20 74 68 65 20  N</i>, then the 
59d0: 6c 65 6e 67 74 68 20 6f 66 0a 20 20 73 74 72 69  length of.  stri
59e0: 6e 67 73 20 61 6e 64 20 42 4c 4f 42 20 74 68 61  ngs and BLOB tha
59f0: 74 20 61 72 65 20 65 78 70 61 6e 64 65 64 20 69  t are expanded i
5a00: 6e 74 6f 20 70 61 72 61 6d 65 74 65 72 73 20 69  nto parameters i
5a10: 6e 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66 0a  n the output of.
5a20: 20 20 5b 73 71 6c 69 74 65 33 5f 74 72 61 63 65    [sqlite3_trace
5a30: 28 29 5d 20 69 73 20 6c 69 6d 69 74 65 64 20 74  ()] is limited t
5a40: 6f 20 3c 69 3e 4e 3c 2f 69 3e 20 62 79 74 65 73  o <i>N</i> bytes
5a50: 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  .  .}..COMPILE_O
5a60: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 55 53  PTION {SQLITE_US
5a70: 45 5f 55 52 49 7d 20 7b 0a 20 20 54 68 69 73 20  E_URI} {.  This 
5a80: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68  option causes th
5a90: 65 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65 5d  e [URI filename]
5aa0: 20 70 72 6f 63 65 73 73 20 6c 6f 67 69 63 20 74   process logic t
5ab0: 6f 20 62 65 20 65 6e 61 62 6c 65 64 20 62 79 20  o be enabled by 
5ac0: 0a 20 20 64 65 66 61 75 6c 74 2e 20 20 0a 7d 0a  .  default.  .}.
5ad0: 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d 65  .</tcl>..<a name
5ae0: 3d 22 65 6e 61 62 6c 65 66 65 61 74 75 72 65 73  ="enablefeatures
5af0: 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 35 20 4f  "></a>.<h2>1.5 O
5b00: 70 74 69 6f 6e 73 20 54 6f 20 45 6e 61 62 6c 65  ptions To Enable
5b10: 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d 61 6c   Features Normal
5b20: 6c 79 20 54 75 72 6e 65 64 20 4f 66 66 3c 2f 68  ly Turned Off</h
5b30: 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c  2>..<tcl>.COMPIL
5b40: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
5b50: 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54 48 4f  _ALLOW_URI_AUTHO
5b60: 52 49 54 59 7d 20 7b 0a 20 20 5b 55 52 49 20 66  RITY} {.  [URI f
5b70: 69 6c 65 6e 61 6d 65 73 5d 20 6e 6f 72 6d 61 6c  ilenames] normal
5b80: 6c 79 20 74 68 72 6f 77 20 61 6e 20 65 72 72 6f  ly throw an erro
5b90: 72 20 69 73 20 74 68 65 20 61 75 74 68 6f 72 69  r is the authori
5ba0: 74 79 20 73 65 63 74 69 6f 6e 20 69 73 0a 20 20  ty section is.  
5bb0: 6e 6f 74 20 65 69 74 68 65 72 20 65 6d 70 74 79  not either empty
5bc0: 20 6f 72 20 22 6c 6f 63 61 6c 68 6f 73 74 22 2e   or "localhost".
5bd0: 20 20 48 6f 77 65 76 65 72 2c 20 69 66 20 53 51    However, if SQ
5be0: 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64  Lite is compiled
5bf0: 20 77 69 74 68 0a 20 20 74 68 65 20 53 51 4c 49   with.  the SQLI
5c00: 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54  TE_ALLOW_URI_AUT
5c10: 48 4f 52 49 54 59 20 63 6f 6d 70 69 6c 65 2d 74  HORITY compile-t
5c20: 69 6d 65 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e  ime option, then
5c30: 20 74 68 65 20 55 52 49 20 69 73 0a 20 20 63 6f   the URI is.  co
5c40: 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 55  nverted into a U
5c50: 6e 69 66 6f 72 6d 20 4e 61 6d 69 6e 67 20 43 6f  niform Naming Co
5c60: 6e 76 65 6e 74 69 6f 6e 20 28 55 4e 43 29 20 66  nvention (UNC) f
5c70: 69 6c 65 6e 61 6d 65 20 61 6e 64 20 70 61 73 73  ilename and pass
5c80: 65 64 0a 20 20 64 6f 77 6e 20 74 6f 20 74 68 65  ed.  down to the
5c90: 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 65 72   underlying oper
5ca0: 61 74 69 6e 67 20 73 79 73 74 65 6d 20 74 68 61  ating system tha
5cb0: 74 20 77 61 79 2e 20 20 0a 20 20 3c 70 3e 0a 20  t way.  .  <p>. 
5cc0: 20 53 6f 6d 65 20 66 75 74 75 72 65 20 76 65 72   Some future ver
5cd0: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20  sions of SQLite 
5ce0: 6d 61 79 20 63 68 61 6e 67 65 20 74 6f 20 65 6e  may change to en
5cf0: 61 62 6c 65 20 74 68 69 73 20 66 65 61 74 75 72  able this featur
5d00: 65 0a 20 20 62 79 20 64 65 66 61 75 6c 74 2e 0a  e.  by default..
5d10: 7d 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  }.COMPILE_OPTION
5d20: 20 7b 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f 43   {SQLITE_ALLOW_C
5d30: 4f 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43  OVERING_INDEX_SC
5d40: 41 4e 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31  AN=<i>&lt;0 or 1
5d50: 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  &gt;</i>} {.  Th
5d60: 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 20  is C-preprocess 
5d70: 6d 61 63 72 6f 20 64 65 74 65 72 6d 69 6e 65 73  macro determines
5d80: 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 65 74   the default set
5d90: 74 69 6e 67 20 6f 66 20 74 68 65 0a 20 20 5b 53  ting of the.  [S
5da0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56  QLITE_CONFIG_COV
5db0: 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e  ERING_INDEX_SCAN
5dc0: 5d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20  ] configuration 
5dd0: 73 65 74 74 69 6e 67 2e 20 20 49 74 20 64 65 66  setting.  It def
5de0: 61 75 6c 74 73 0a 20 20 74 6f 20 31 20 28 6f 6e  aults.  to 1 (on
5df0: 29 20 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68  ) which means th
5e00: 61 74 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69  at covering indi
5e10: 63 65 73 20 61 72 65 20 75 73 65 64 20 66 6f 72  ces are used for
5e20: 20 66 75 6c 6c 20 74 61 62 6c 65 0a 20 20 73 63   full table.  sc
5e30: 61 6e 73 20 77 68 65 72 65 20 70 6f 73 73 69 62  ans where possib
5e40: 6c 65 2c 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  le, in order to 
5e50: 72 65 64 75 63 65 20 49 2f 4f 20 61 6e 64 20 69  reduce I/O and i
5e60: 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61 6e  mprove performan
5e70: 63 65 2e 0a 20 20 48 6f 77 65 76 65 72 2c 20 74  ce..  However, t
5e80: 68 65 20 75 73 65 20 6f 66 20 61 20 63 6f 76 65  he use of a cove
5e90: 72 69 6e 67 20 69 6e 64 65 78 20 66 6f 72 20 61  ring index for a
5ea0: 20 66 75 6c 6c 20 73 63 61 6e 20 77 69 6c 6c 20   full scan will 
5eb0: 63 61 75 73 65 20 72 65 73 75 6c 74 73 0a 20 20  cause results.  
5ec0: 74 6f 20 61 70 70 65 61 72 20 69 6e 20 61 20 64  to appear in a d
5ed0: 69 66 66 65 72 65 6e 74 20 6f 72 64 65 72 20 66  ifferent order f
5ee0: 72 6f 6d 20 6c 65 67 61 63 79 2c 20 77 68 69 63  rom legacy, whic
5ef0: 68 20 63 6f 75 6c 64 20 63 61 75 73 65 20 73 6f  h could cause so
5f00: 6d 65 0a 20 20 28 69 6e 63 6f 72 72 65 63 74 6c  me.  (incorrectl
5f10: 79 2d 63 6f 64 65 64 29 20 6c 65 67 61 63 79 20  y-coded) legacy 
5f20: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 6f 20  applications to 
5f30: 62 72 65 61 6b 2e 20 20 48 65 6e 63 65 2c 20 74  break.  Hence, t
5f40: 68 65 20 63 6f 76 65 72 69 6e 67 0a 20 20 69 6e  he covering.  in
5f50: 64 65 78 20 73 63 61 6e 20 6f 70 74 69 6f 6e 20  dex scan option 
5f60: 63 61 6e 20 62 65 20 64 69 73 61 62 6c 65 64 20  can be disabled 
5f70: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  at compile-time 
5f80: 6f 6e 20 73 79 73 74 65 6d 73 20 74 68 61 74 20  on systems that 
5f90: 77 68 61 74 0a 20 20 74 6f 20 6d 69 6e 69 6d 69  what.  to minimi
5fa0: 7a 65 20 74 68 65 69 72 20 72 69 73 6b 20 6f 66  ze their risk of
5fb0: 20 65 78 70 6f 73 69 6e 67 20 65 72 72 6f 72 73   exposing errors
5fc0: 20 69 6e 20 6c 65 67 61 63 79 20 61 70 70 6c 69   in legacy appli
5fd0: 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50  cations..}..COMP
5fe0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
5ff0: 54 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e 41  TE_ENABLE_8_3_NA
6000: 4d 45 53 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 20  MES=<i>&lt;1 or 
6010: 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 49  2&gt;</i>} {.  I
6020: 66 20 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63  f this C-preproc
6030: 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 73 20 64  essor macro is d
6040: 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 65 78 74  efined, then ext
6050: 72 61 20 63 6f 64 65 20 69 73 0a 20 20 69 6e 63  ra code is.  inc
6060: 6c 75 64 65 64 20 74 68 61 74 20 61 6c 6c 6f 77  luded that allow
6070: 73 20 53 51 4c 69 74 65 20 74 6f 20 66 75 6e 63  s SQLite to func
6080: 74 69 6f 6e 20 6f 6e 20 61 20 66 69 6c 65 73 79  tion on a filesy
6090: 73 74 65 6d 20 74 68 61 74 0a 20 20 6f 6e 6c 79  stem that.  only
60a0: 20 73 75 70 70 6f 72 74 20 38 2b 33 20 66 69 6c   support 8+3 fil
60b0: 65 6e 61 6d 65 73 2e 20 20 49 66 20 74 68 65 20  enames.  If the 
60c0: 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6d 61  value of this ma
60d0: 63 72 6f 20 69 73 20 31 2c 0a 20 20 74 68 65 6e  cro is 1,.  then
60e0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 65 68   the default beh
60f0: 61 76 69 6f 72 20 69 73 20 74 6f 20 63 6f 6e 74  avior is to cont
6100: 69 6e 75 65 20 74 6f 20 75 73 65 20 6c 6f 6e 67  inue to use long
6110: 20 66 69 6c 65 6e 61 6d 65 73 20 61 6e 64 0a 20   filenames and. 
6120: 20 74 6f 20 6f 6e 6c 79 20 75 73 65 20 38 2b 33   to only use 8+3
6130: 20 66 69 6c 65 6e 61 6d 65 73 20 69 66 20 74 68   filenames if th
6140: 65 20 0a 20 20 64 61 74 61 62 61 73 65 20 63 6f  e .  database co
6150: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e  nnection is open
6160: 65 64 20 75 73 69 6e 67 20 5b 55 52 49 20 66 69  ed using [URI fi
6170: 6c 65 6e 61 6d 65 73 5d 20 77 69 74 68 0a 20 20  lenames] with.  
6180: 74 68 65 20 22 3c 74 74 3e 38 5f 33 5f 6e 61 6d  the "<tt>8_3_nam
6190: 65 73 3d 31 3c 2f 74 74 3e 22 20 71 75 65 72 79  es=1</tt>" query
61a0: 20 70 61 72 61 6d 65 74 65 72 2e 20 20 49 66 20   parameter.  If 
61b0: 74 68 65 20 76 61 6c 75 65 20 6f 66 0a 20 20 74  the value of.  t
61c0: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 32 2c 20  his macro is 2, 
61d0: 74 68 65 6e 20 74 68 65 20 75 73 65 20 6f 66 20  then the use of 
61e0: 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73 20 62 65  8+3 filenames be
61f0: 63 6f 6d 65 73 20 74 68 65 20 64 65 66 61 75 6c  comes the defaul
6200: 74 0a 20 20 62 75 74 20 6d 61 79 20 62 65 20 64  t.  but may be d
6210: 69 73 61 62 6c 65 64 20 6f 6e 20 75 73 69 6e 67  isabled on using
6220: 20 74 68 65 20 3c 74 74 3e 38 5f 33 5f 6e 61 6d   the <tt>8_3_nam
6230: 65 73 3d 30 3c 2f 74 74 3e 20 71 75 65 72 79 20  es=0</tt> query 
6240: 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 53 65 65  parameter..  See
6250: 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54   .}..COMPILE_OPT
6260: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
6270: 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 7d 20 7b 0a  LE_API_ARMOR} {.
6280: 20 20 57 68 65 6e 20 64 65 66 69 6e 65 64 2c 20    When defined, 
6290: 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73  this C-preproces
62a0: 73 6f 72 20 6d 61 63 72 6f 20 61 63 74 69 76 61  sor macro activa
62b0: 74 65 73 20 65 78 74 72 61 20 63 6f 64 65 20 74  tes extra code t
62c0: 68 61 74 0a 20 20 61 74 74 65 6d 70 74 73 20 74  hat.  attempts t
62d0: 6f 20 64 65 74 65 63 74 20 6d 69 73 75 73 65 20  o detect misuse 
62e0: 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 41 50  of the SQLite AP
62f0: 49 2c 20 73 75 63 68 20 61 73 20 70 61 73 73 69  I, such as passi
6300: 6e 67 20 69 6e 20 4e 55 4c 4c 0a 20 20 70 6f 69  ng in NULL.  poi
6310: 6e 74 65 72 73 20 74 6f 20 72 65 71 75 69 72 65  nters to require
6320: 64 20 70 61 72 61 6d 65 74 65 72 73 20 6f 72 20  d parameters or 
6330: 75 73 69 6e 67 20 6f 62 6a 65 63 74 73 20 61 66  using objects af
6340: 74 65 72 20 74 68 65 79 20 68 61 76 65 20 62 65  ter they have be
6350: 65 6e 0a 20 20 64 65 73 74 72 6f 79 65 64 2e 0a  en.  destroyed..
6360: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
6370: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
6380: 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 7d 20 7b  _ATOMIC_WRITE} {
6390: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
63a0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
63b0: 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20 69  is defined and i
63c0: 66 20 74 68 65 0a 20 20 78 44 65 76 69 63 65 43  f the.  xDeviceC
63d0: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 6d  haracteristics m
63e0: 65 74 68 6f 64 20 6f 66 20 5b 73 71 6c 69 74 65  ethod of [sqlite
63f0: 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 5d 20 6f 62  3_io_methods] ob
6400: 6a 65 63 74 20 66 6f 72 0a 20 20 61 20 64 61 74  ject for.  a dat
6410: 61 62 61 73 65 20 66 69 6c 65 20 72 65 70 6f 72  abase file repor
6420: 74 73 20 28 76 69 61 20 6f 6e 65 20 6f 66 20 74  ts (via one of t
6430: 68 65 20 5b 53 51 4c 49 54 45 5f 49 4f 43 41 50  he [SQLITE_IOCAP
6440: 5f 41 54 4f 4d 49 43 5d 20 62 69 74 73 29 0a 20  _ATOMIC] bits). 
6450: 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 73 79   that the filesy
6460: 73 74 65 6d 20 73 75 70 70 6f 72 74 73 20 61 74  stem supports at
6470: 6f 6d 69 63 20 77 72 69 74 65 73 20 61 6e 64 20  omic writes and 
6480: 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  if a transaction
6490: 0a 20 20 69 6e 76 6f 6c 76 65 73 20 61 20 63 68  .  involves a ch
64a0: 61 6e 67 65 20 74 6f 20 6f 6e 6c 79 20 61 20 73  ange to only a s
64b0: 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74 68  ingle page of th
64c0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
64d0: 0a 20 20 74 68 65 6e 20 74 68 65 20 74 72 61 6e  .  then the tran
64e0: 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20  saction commits 
64f0: 77 69 74 68 20 6a 75 73 74 20 61 20 73 69 6e 67  with just a sing
6500: 6c 65 20 77 72 69 74 65 20 72 65 71 75 65 73 74  le write request
6510: 20 6f 66 0a 20 20 61 20 73 69 6e 67 6c 65 20 70   of.  a single p
6520: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  age of the datab
6530: 61 73 65 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c 62  ase and no rollb
6540: 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 69 73 20 63  ack journal is c
6550: 72 65 61 74 65 64 0a 20 20 6f 72 20 77 72 69 74  reated.  or writ
6560: 74 65 6e 2e 20 20 4f 6e 20 66 69 6c 65 73 79 73  ten.  On filesys
6570: 74 65 6d 73 20 74 68 61 74 20 73 75 70 70 6f 72  tems that suppor
6580: 74 20 61 74 6f 6d 69 63 20 77 72 69 74 65 73 2c  t atomic writes,
6590: 20 74 68 69 73 0a 20 20 6f 70 74 69 6d 69 7a 61   this.  optimiza
65a0: 74 69 6f 6e 20 63 61 6e 20 72 65 73 75 6c 74 20  tion can result 
65b0: 69 6e 20 73 69 67 6e 69 66 69 63 61 6e 74 20 73  in significant s
65c0: 70 65 65 64 20 69 6d 70 72 6f 76 65 6d 65 6e 74  peed improvement
65d0: 73 20 66 6f 72 0a 20 20 73 6d 61 6c 6c 20 75 70  s for.  small up
65e0: 64 61 74 65 73 2e 20 20 48 6f 77 65 76 65 72 2c  dates.  However,
65f0: 20 66 65 77 20 66 69 6c 65 73 79 73 74 65 6d 73   few filesystems
6600: 20 73 75 70 70 6f 72 74 20 74 68 69 73 20 63 61   support this ca
6610: 70 61 62 69 6c 69 74 79 0a 20 20 61 6e 64 20 74  pability.  and t
6620: 68 65 20 63 6f 64 65 20 70 61 74 68 73 20 74 68  he code paths th
6630: 61 74 20 63 68 65 63 6b 20 66 6f 72 20 74 68 69  at check for thi
6640: 73 20 63 61 70 61 62 69 6c 69 74 79 20 73 6c 6f  s capability slo
6650: 77 20 64 6f 77 6e 20 77 72 69 74 65 0a 20 20 70  w down write.  p
6660: 65 72 66 6f 72 6d 61 6e 63 65 20 6f 6e 20 73 79  erformance on sy
6670: 73 74 65 6d 73 20 74 68 61 74 20 6c 61 63 6b 20  stems that lack 
6680: 61 74 6f 6d 69 63 20 77 72 69 74 65 20 63 61 70  atomic write cap
6690: 61 62 69 6c 69 74 79 2c 20 73 6f 20 74 68 69 73  ability, so this
66a0: 0a 20 20 66 65 61 74 75 72 65 20 69 73 20 64 69  .  feature is di
66b0: 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c  sabled by defaul
66c0: 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  t..}..COMPILE_OP
66d0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
66e0: 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44  BLE_COLUMN_METAD
66f0: 41 54 41 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68  ATA} {.  When th
6700: 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f  is C-preprocesso
6710: 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  r macro is defin
6720: 65 64 2c 20 53 51 4c 69 74 65 20 69 6e 63 6c 75  ed, SQLite inclu
6730: 64 65 73 20 73 6f 6d 65 0a 20 20 61 64 64 69 74  des some.  addit
6740: 69 6f 6e 61 6c 20 41 50 49 73 20 74 68 61 74 20  ional APIs that 
6750: 70 72 6f 76 69 64 65 20 63 6f 6e 76 65 6e 69 65  provide convenie
6760: 6e 74 20 61 63 63 65 73 73 20 74 6f 20 6d 65 74  nt access to met
6770: 61 2d 64 61 74 61 20 61 62 6f 75 74 0a 20 20 74  a-data about.  t
6780: 61 62 6c 65 73 20 61 6e 64 20 71 75 65 72 69 65  ables and querie
6790: 73 2e 20 20 54 68 65 20 41 50 49 73 20 74 68 61  s.  The APIs tha
67a0: 74 20 61 72 65 20 65 6e 61 62 6c 65 64 20 62 79  t are enabled by
67b0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 72 65   this option are
67c0: 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c 6c 69 3e  :..  <ul>.  <li>
67d0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
67e0: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 28 29  _database_name()
67f0: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
6800: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
6810: 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 28 29  atabase_name16()
6820: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
6830: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74  sqlite3_column_t
6840: 61 62 6c 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c  able_name()] </l
6850: 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74  i>.  <li> [sqlit
6860: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
6870: 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a  name16()] </li>.
6880: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
6890: 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61  column_origin_na
68a0: 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c  me()] </li>.  <l
68b0: 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  i> [sqlite3_colu
68c0: 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 36  mn_origin_name16
68d0: 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 2f 75 6c  ()] </li>.  </ul
68e0: 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  >.}..COMPILE_OPT
68f0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
6900: 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45  LE_EXPLAIN_COMME
6910: 4e 54 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  NTS} {.  This op
6920: 74 69 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20  tion adds extra 
6930: 6c 6f 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20  logic to SQLite 
6940: 74 68 61 74 20 69 6e 73 65 72 74 73 20 63 6f 6d  that inserts com
6950: 6d 65 6e 74 20 74 65 78 74 20 69 6e 74 6f 20 74  ment text into t
6960: 68 65 0a 20 20 6f 75 74 70 75 74 20 6f 66 20 5b  he.  output of [
6970: 45 58 50 4c 41 49 4e 5d 2e 20 20 54 68 65 73 65  EXPLAIN].  These
6980: 20 65 78 74 72 61 20 63 6f 6d 6d 65 6e 74 73 20   extra comments 
6990: 75 73 65 20 65 78 74 72 61 20 6d 65 6d 6f 72 79  use extra memory
69a0: 2c 20 74 68 75 73 0a 20 20 6d 61 6b 69 6e 67 20  , thus.  making 
69b0: 5b 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d  [prepared statem
69c0: 65 6e 74 73 5d 20 6c 61 72 67 65 72 20 61 6e 64  ents] larger and
69d0: 20 76 65 72 79 20 73 6c 69 67 68 74 6c 79 20 73   very slightly s
69e0: 6c 6f 77 65 72 2c 20 61 6e 64 20 73 6f 20 74 68  lower, and so th
69f0: 65 79 20 61 72 65 0a 20 20 74 75 72 6e 65 64 20  ey are.  turned 
6a00: 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74 20 61  off by default a
6a10: 6e 64 20 69 6e 20 6d 6f 73 74 20 61 70 70 6c 69  nd in most appli
6a20: 63 61 74 69 6f 6e 2e 20 20 42 75 74 20 73 6f 6d  cation.  But som
6a30: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2c 20  e applications, 
6a40: 73 75 63 68 0a 20 20 61 73 20 74 68 65 20 5b 63  such.  as the [c
6a50: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 68 65 6c  ommand-line shel
6a60: 6c 5d 20 66 6f 72 20 53 51 4c 69 74 65 2c 20 76  l] for SQLite, v
6a70: 61 6c 75 65 20 63 6c 61 72 69 74 79 20 6f 66 20  alue clarity of 
6a80: 45 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 0a 20  EXPLAIN output. 
6a90: 20 6f 76 65 72 20 72 61 77 20 70 65 72 66 6f 72   over raw perfor
6aa0: 6d 61 6e 63 65 20 61 6e 64 20 73 6f 20 74 68 69  mance and so thi
6ab0: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  s compile-time o
6ac0: 70 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62  ption is availab
6ad0: 6c 65 20 74 6f 20 74 68 65 6d 2e 0a 20 20 54 68  le to them..  Th
6ae0: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  e SQLITE_ENABLE_
6af0: 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53  EXPLAIN_COMMENTS
6b00: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
6b10: 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 65 6e 61  tion is also ena
6b20: 62 6c 65 64 0a 20 20 61 75 74 6f 6d 61 74 69 63  bled.  automatic
6b30: 61 6c 6c 79 20 69 66 20 5b 53 51 4c 49 54 45 5f  ally if [SQLITE_
6b40: 44 45 42 55 47 5d 20 69 73 20 65 6e 61 62 6c 65  DEBUG] is enable
6b50: 64 2e 0a 7d 0a 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  d..}...COMPILE_O
6b60: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
6b70: 41 42 4c 45 5f 46 54 53 33 7d 20 7b 0a 20 20 57  ABLE_FTS3} {.  W
6b80: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
6b90: 69 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68  is defined in th
6ba0: 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d  e [amalgamation]
6bb0: 2c 20 76 65 72 73 69 6f 6e 20 33 0a 20 20 6f 66  , version 3.  of
6bc0: 20 74 68 65 20 66 75 6c 6c 2d 74 65 78 74 20 73   the full-text s
6bd0: 65 61 72 63 68 20 65 6e 67 69 6e 65 20 69 73 20  earch engine is 
6be0: 61 64 64 65 64 20 74 6f 20 74 68 65 20 62 75 69  added to the bui
6bf0: 6c 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ld automatically
6c00: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
6c10: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
6c20: 4c 45 5f 46 54 53 33 5f 50 41 52 45 4e 54 48 45  LE_FTS3_PARENTHE
6c30: 53 49 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  SIS} {.  This op
6c40: 74 69 6f 6e 20 6d 6f 64 69 66 69 65 73 20 74 68  tion modifies th
6c50: 65 20 71 75 65 72 79 20 70 61 74 74 65 72 6e 20  e query pattern 
6c60: 70 61 72 73 65 72 20 69 6e 20 46 54 53 33 20 73  parser in FTS3 s
6c70: 75 63 68 20 74 68 61 74 20 69 74 0a 20 20 73 75  uch that it.  su
6c80: 70 70 6f 72 74 73 20 6f 70 65 72 61 74 6f 72 73  pports operators
6c90: 20 41 4e 44 20 61 6e 64 20 4e 4f 54 20 28 69 6e   AND and NOT (in
6ca0: 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65   addition to the
6cb0: 20 75 73 75 61 6c 20 4f 52 20 61 6e 64 20 4e 45   usual OR and NE
6cc0: 41 52 29 0a 20 20 61 6e 64 20 61 6c 73 6f 20 61  AR).  and also a
6cd0: 6c 6c 6f 77 73 20 71 75 65 72 79 20 65 78 70 72  llows query expr
6ce0: 65 73 73 69 6f 6e 73 20 74 6f 20 63 6f 6e 74 61  essions to conta
6cf0: 69 6e 20 6e 65 73 74 65 64 20 70 61 72 65 6e 74  in nested parent
6d00: 68 65 73 69 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  hesis..}..COMPIL
6d10: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
6d20: 5f 45 4e 41 42 4c 45 5f 46 54 53 34 7d 20 7b 0a  _ENABLE_FTS4} {.
6d30: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
6d40: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e  on is defined in
6d50: 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69   the [amalgamati
6d60: 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 73 20 33 20  on], versions 3 
6d70: 61 6e 64 20 34 0a 20 20 6f 66 20 74 68 65 20 66  and 4.  of the f
6d80: 75 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20  ull-text search 
6d90: 65 6e 67 69 6e 65 20 69 73 20 61 64 64 65 64 20  engine is added 
6da0: 74 6f 20 74 68 65 20 62 75 69 6c 64 20 61 75 74  to the build aut
6db0: 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d 0a 0a 43  omatically..}..C
6dc0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
6dd0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 55  QLITE_ENABLE_ICU
6de0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
6df0: 6e 20 63 61 75 73 65 73 20 74 68 65 20 0a 20 20  n causes the .  
6e00: 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 69 63 75 2d  [http://www.icu-
6e10: 70 72 6f 6a 65 63 74 2e 6f 72 67 2f 20 7c 20 49  project.org/ | I
6e20: 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 43 6f 6d  nternational Com
6e30: 70 6f 6e 65 6e 74 73 20 66 6f 72 20 55 6e 69 63  ponents for Unic
6e40: 6f 64 65 5d 0a 20 20 6f 72 20 22 49 43 55 22 20  ode].  or "ICU" 
6e50: 65 78 74 65 6e 73 69 6f 6e 20 74 6f 20 53 51 4c  extension to SQL
6e60: 69 74 65 20 74 6f 20 62 65 20 61 64 64 65 64 20  ite to be added 
6e70: 74 6f 20 74 68 65 20 62 75 69 6c 64 2e 20 20 0a  to the build.  .
6e80: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
6e90: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
6ea0: 5f 49 4f 54 52 41 43 45 7d 20 7b 0a 20 20 57 68  _IOTRACE} {.  Wh
6eb0: 65 6e 20 62 6f 74 68 20 74 68 65 20 53 51 4c 69  en both the SQLi
6ec0: 74 65 20 63 6f 72 65 20 61 6e 64 20 74 68 65 20  te core and the 
6ed0: 5b 43 6f 6d 6d 61 6e 64 20 4c 69 6e 65 20 49 6e  [Command Line In
6ee0: 74 65 72 66 61 63 65 5d 20 28 43 4c 49 29 20 61  terface] (CLI) a
6ef0: 72 65 20 62 6f 74 68 20 0a 20 20 63 6f 6d 70 69  re both .  compi
6f00: 6c 65 64 20 77 69 74 68 20 74 68 69 73 20 6f 70  led with this op
6f10: 74 69 6f 6e 2c 20 74 68 65 6e 20 74 68 65 20 43  tion, then the C
6f20: 4c 49 20 70 72 6f 76 69 64 65 73 20 61 6e 20 65  LI provides an e
6f30: 78 74 72 61 20 63 6f 6d 6d 61 6e 64 0a 20 20 6e  xtra command.  n
6f40: 61 6d 65 64 20 22 2e 69 6f 74 72 61 63 65 22 20  amed ".iotrace" 
6f50: 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 61 20  that provides a 
6f60: 6c 6f 77 2d 6c 65 76 65 6c 20 6c 6f 67 20 6f 66  low-level log of
6f70: 20 49 2f 4f 20 61 63 74 69 76 69 74 79 2e 0a 20   I/O activity.. 
6f80: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   This option is 
6f90: 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e 64  experimental and
6fa0: 20 6d 61 79 20 62 65 20 64 69 73 63 6f 6e 74 69   may be disconti
6fb0: 6e 75 65 64 20 69 6e 20 61 20 66 75 74 75 72 65  nued in a future
6fc0: 20 72 65 6c 65 61 73 65 2e 0a 7d 0a 0a 43 4f 4d   release..}..COM
6fd0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
6fe0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
6ff0: 4e 47 5f 53 54 59 4c 45 7d 20 7b 0a 20 20 54 68  NG_STYLE} {.  Th
7000: 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65  is option enable
7010: 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67  s additional log
7020: 69 63 20 69 6e 20 74 68 65 20 4f 53 20 69 6e 74  ic in the OS int
7030: 65 72 66 61 63 65 20 6c 61 79 65 72 20 66 6f 72  erface layer for
7040: 0a 20 20 4d 61 63 20 4f 53 20 58 2e 20 54 68 65  .  Mac OS X. The
7050: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69   additional logi
7060: 63 20 61 74 74 65 6d 70 74 73 20 74 6f 20 64 65  c attempts to de
7070: 74 65 72 6d 69 6e 65 20 74 68 65 20 74 79 70 65  termine the type
7080: 20 6f 66 20 74 68 65 0a 20 20 75 6e 64 65 72 6c   of the.  underl
7090: 79 69 6e 67 20 66 69 6c 65 73 79 73 74 65 6d 20  ying filesystem 
70a0: 61 6e 64 20 63 68 6f 6f 73 65 20 61 6e 64 20 61  and choose and a
70b0: 6c 74 65 72 6e 61 74 69 76 65 20 6c 6f 63 6b 69  lternative locki
70c0: 6e 67 20 73 74 72 61 74 65 67 79 0a 20 20 74 68  ng strategy.  th
70d0: 61 74 20 77 6f 72 6b 73 20 63 6f 72 72 65 63 74  at works correct
70e0: 6c 79 20 66 6f 72 20 74 68 61 74 20 66 69 6c 65  ly for that file
70f0: 73 79 73 74 65 6d 20 74 79 70 65 2e 20 46 69 76  system type. Fiv
7100: 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74 65  e locking strate
7110: 67 69 65 73 20 0a 20 20 61 72 65 20 61 76 61 69  gies .  are avai
7120: 6c 61 62 6c 65 3a 0a 0a 20 20 3c 75 6c 3e 0a 20  lable:..  <ul>. 
7130: 20 20 20 3c 6c 69 3e 20 50 4f 53 49 58 20 6c 6f     <li> POSIX lo
7140: 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68 69  cking style. Thi
7150: 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74  s is the default
7160: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 61   locking style a
7170: 6e 64 20 74 68 65 0a 20 20 20 20 20 20 20 20 20  nd the.         
7180: 73 74 79 6c 65 20 75 73 65 64 20 62 79 20 6f 74  style used by ot
7190: 68 65 72 20 28 6e 6f 6e 20 4d 61 63 20 4f 53 20  her (non Mac OS 
71a0: 58 29 20 55 6e 69 78 65 73 2e 20 4c 6f 63 6b 73  X) Unixes. Locks
71b0: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 61 6e   are obtained an
71c0: 64 20 0a 20 20 20 20 20 20 20 20 20 72 65 6c 65  d .         rele
71d0: 61 73 65 64 20 75 73 69 6e 67 20 74 68 65 20 66  ased using the f
71e0: 63 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63 61  cntl() system ca
71f0: 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 41 46  ll...    <li> AF
7200: 50 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  P locking style.
7210: 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74   This locking st
7220: 79 6c 65 20 69 73 20 75 73 65 64 20 66 6f 72 20  yle is used for 
7230: 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20 0a 20 20  network file .  
7240: 20 20 20 20 20 20 20 73 79 73 74 65 6d 73 20 74         systems t
7250: 68 61 74 20 75 73 65 20 74 68 65 20 41 46 50 20  hat use the AFP 
7260: 28 41 70 70 6c 65 20 46 69 6c 69 6e 67 20 50 72  (Apple Filing Pr
7270: 6f 74 6f 63 6f 6c 29 20 70 72 6f 74 6f 63 6f 6c  otocol) protocol
7280: 2e 20 4c 6f 63 6b 73 0a 20 20 20 20 20 20 20 20  . Locks.        
7290: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62 79   are obtained by
72a0: 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 6c 69 62   calling the lib
72b0: 72 61 72 79 20 66 75 6e 63 74 69 6f 6e 20 5f 41  rary function _A
72c0: 46 50 46 53 53 65 74 4c 6f 63 6b 28 29 2e 0a 0a  FPFSSetLock()...
72d0: 20 20 20 20 3c 6c 69 3e 20 46 6c 6f 63 6b 20 6c      <li> Flock l
72e0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68  ocking style. Th
72f0: 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 66  is is used for f
7300: 69 6c 65 2d 73 79 73 74 65 6d 73 20 74 68 61 74  ile-systems that
7310: 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 20 20 20   do not.        
7320: 20 73 75 70 70 6f 72 74 20 50 4f 53 49 58 20 6c   support POSIX l
7330: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 4c 6f  ocking style. Lo
7340: 63 6b 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64  cks are obtained
7350: 20 61 6e 64 20 72 65 6c 65 61 73 65 64 20 75 73   and released us
7360: 69 6e 67 0a 20 20 20 20 20 20 20 20 20 74 68 65  ing.         the
7370: 20 66 6c 6f 63 6b 28 29 20 73 79 73 74 65 6d 20   flock() system 
7380: 63 61 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20  call...    <li> 
7390: 44 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 69 6e 67  Dot-file locking
73a0: 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c 6f 63   style. This loc
73b0: 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75 73  king style is us
73c0: 65 64 20 77 68 65 6e 20 6e 65 69 74 68 65 72 0a  ed when neither.
73d0: 20 20 20 20 20 20 20 20 20 66 6c 6f 63 6b 20 6e           flock n
73e0: 6f 72 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67  or POSIX locking
73f0: 20 73 74 79 6c 65 73 20 61 72 65 20 73 75 70 70   styles are supp
7400: 6f 72 74 65 64 20 62 79 20 74 68 65 20 66 69 6c  orted by the fil
7410: 65 20 73 79 73 74 65 6d 2e 0a 20 20 20 20 20 20  e system..      
7420: 20 20 20 44 61 74 61 62 61 73 65 20 6c 6f 63 6b     Database lock
7430: 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62  s are obtained b
7440: 79 20 63 72 65 61 74 69 6e 67 20 61 6e 64 20 65  y creating and e
7450: 6e 74 72 79 20 69 6e 20 74 68 65 20 66 69 6c 65  ntry in the file
7460: 2d 73 79 73 74 65 6d 0a 20 20 20 20 20 20 20 20  -system.        
7470: 20 61 74 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e   at a well-known
7480: 20 6c 6f 63 61 74 69 6f 6e 20 72 65 6c 61 74 69   location relati
7490: 76 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  ve to the databa
74a0: 73 65 20 66 69 6c 65 20 28 61 20 22 64 6f 74 2d  se file (a "dot-
74b0: 66 69 6c 65 22 29 0a 20 20 20 20 20 20 20 20 20  file").         
74c0: 61 6e 64 20 72 65 6c 69 6e 71 75 69 73 68 65 64  and relinquished
74d0: 20 62 79 20 64 65 6c 65 74 69 6e 67 20 74 68 65   by deleting the
74e0: 20 73 61 6d 65 20 66 69 6c 65 2e 0a 0a 20 20 20   same file...   
74f0: 20 3c 6c 69 3e 20 4e 6f 20 6c 6f 63 6b 69 6e 67   <li> No locking
7500: 20 73 74 79 6c 65 2e 20 49 66 20 6e 6f 6e 65 20   style. If none 
7510: 6f 66 20 74 68 65 20 61 62 6f 76 65 20 63 61 6e  of the above can
7520: 20 62 65 20 73 75 70 70 6f 72 74 65 64 2c 20 74   be supported, t
7530: 68 69 73 20 0a 20 20 20 20 20 20 20 20 20 6c 6f  his .         lo
7540: 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75  cking style is u
7550: 73 65 64 2e 20 4e 6f 20 64 61 74 61 62 61 73 65  sed. No database
7560: 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69   locking mechani
7570: 73 6d 20 69 73 20 75 73 65 64 2e 20 57 68 65 6e  sm is used. When
7580: 0a 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73  .         this s
7590: 79 73 74 65 6d 20 69 73 20 75 73 65 64 20 69 74  ystem is used it
75a0: 20 69 73 20 6e 6f 74 20 73 61 66 65 20 66 6f 72   is not safe for
75b0: 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61   a single databa
75c0: 73 65 20 74 6f 20 62 65 0a 20 20 20 20 20 20 20  se to be.       
75d0: 20 20 61 63 63 65 73 73 65 64 20 62 79 20 6d 75    accessed by mu
75e0: 6c 74 69 70 6c 65 20 63 6c 69 65 6e 74 73 2e 0a  ltiple clients..
75f0: 20 20 3c 2f 75 6c 3e 0a 0a 20 20 41 64 64 69 74    </ul>..  Addit
7600: 69 6f 6e 61 6c 6c 79 2c 20 66 69 76 65 20 65 78  ionally, five ex
7610: 74 72 61 20 5b 56 46 53 5d 20 69 6d 70 6c 65 6d  tra [VFS] implem
7620: 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 70 72  entations are pr
7630: 6f 76 69 64 65 64 20 61 73 20 77 65 6c 6c 20 61  ovided as well a
7640: 73 20 74 68 65 0a 20 20 64 65 66 61 75 6c 74 2e  s the.  default.
7650: 20 42 79 20 73 70 65 63 69 66 79 69 6e 67 20 6f   By specifying o
7660: 6e 65 20 6f 66 20 74 68 65 20 65 78 74 72 61 20  ne of the extra 
7670: 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  VFS implementati
7680: 6f 6e 73 20 0a 20 20 77 68 65 6e 20 63 61 6c 6c  ons .  when call
7690: 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65  ing [sqlite3_ope
76a0: 6e 5f 76 32 28 29 5d 2c 20 61 6e 20 61 70 70 6c  n_v2()], an appl
76b0: 69 63 61 74 69 6f 6e 20 6d 61 79 20 62 79 70 61  ication may bypa
76c0: 73 73 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74  ss the file-syst
76d0: 65 6d 0a 20 20 64 65 74 65 63 74 69 6f 6e 20 6c  em.  detection l
76e0: 6f 67 69 63 20 61 6e 64 20 65 78 70 6c 69 63 69  ogic and explici
76f0: 74 6c 79 20 73 65 6c 65 63 74 20 6f 6e 65 20 6f  tly select one o
7700: 66 20 74 68 65 20 61 62 6f 76 65 20 6c 6f 63 6b  f the above lock
7710: 69 6e 67 20 73 74 79 6c 65 73 2e 20 54 68 65 0a  ing styles. The.
7720: 20 20 66 69 76 65 20 65 78 74 72 61 20 5b 56 46    five extra [VF
7730: 53 5d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  S] implementatio
7740: 6e 73 20 61 72 65 20 63 61 6c 6c 65 64 20 22 75  ns are called "u
7750: 6e 69 78 2d 70 6f 73 69 78 22 2c 20 22 75 6e 69  nix-posix", "uni
7760: 78 2d 61 66 70 22 2c 0a 20 20 22 75 6e 69 78 2d  x-afp",.  "unix-
7770: 66 6c 6f 63 6b 22 2c 20 22 75 6e 69 78 2d 64 6f  flock", "unix-do
7780: 74 66 69 6c 65 22 20 61 6e 64 20 22 75 6e 69 78  tfile" and "unix
7790: 2d 6e 6f 6e 65 22 2e 0a 7d 0a 0a 43 4f 4d 50 49  -none"..}..COMPI
77a0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
77b0: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
77c0: 4d 41 4e 41 47 45 4d 45 4e 54 7d 20 7b 0a 20 20  MANAGEMENT} {.  
77d0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73  This option adds
77e0: 20 65 78 74 72 61 20 6c 6f 67 69 63 20 74 6f 20   extra logic to 
77f0: 53 51 4c 69 74 65 20 74 68 61 74 20 61 6c 6c 6f  SQLite that allo
7800: 77 73 20 69 74 20 74 6f 20 72 65 6c 65 61 73 65  ws it to release
7810: 20 75 6e 75 73 65 64 0a 20 20 6d 65 6d 6f 72 79   unused.  memory
7820: 20 75 70 6f 6e 20 72 65 71 75 65 73 74 2e 20 20   upon request.  
7830: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 75 73 74  This option must
7840: 20 62 65 20 65 6e 61 62 6c 65 64 20 69 6e 20 6f   be enabled in o
7850: 72 64 65 72 20 66 6f 72 20 74 68 65 0a 20 20 5b  rder for the.  [
7860: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f  sqlite3_release_
7870: 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72 66  memory()] interf
7880: 61 63 65 20 74 6f 20 77 6f 72 6b 2e 20 20 49 66  ace to work.  If
7890: 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69   this compile-ti
78a0: 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 69 73 20 6e  me.  option is n
78b0: 6f 74 20 75 73 65 64 2c 20 74 68 65 20 5b 73 71  ot used, the [sq
78c0: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
78d0: 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72 66 61 63  mory()] interfac
78e0: 65 20 69 73 20 61 20 0a 20 20 6e 6f 2d 6f 70 2e  e is a .  no-op.
78f0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
7900: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
7910: 45 5f 4d 45 4d 53 59 53 33 7d 20 7b 0a 20 20 54  E_MEMSYS3} {.  T
7920: 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e 63 6c 75  his option inclu
7930: 64 65 73 20 63 6f 64 65 20 69 6e 20 53 51 4c 69  des code in SQLi
7940: 74 65 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e  te that implemen
7950: 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  ts an alternativ
7960: 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  e.  memory alloc
7970: 61 74 6f 72 2e 20 20 54 68 69 73 20 61 6c 74 65  ator.  This alte
7980: 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 61  rnative memory a
7990: 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f 6e 6c 79  llocator is only
79a0: 20 65 6e 67 61 67 65 64 0a 20 20 77 68 65 6e 20   engaged.  when 
79b0: 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  the [SQLITE_CONF
79c0: 49 47 5f 48 45 41 50 5d 20 6f 70 74 69 6f 6e 20  IG_HEAP] option 
79d0: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66  to [sqlite3_conf
79e0: 69 67 28 29 5d 20 69 73 20 75 73 65 64 20 74 6f  ig()] is used to
79f0: 0a 20 20 73 75 70 70 6c 79 20 61 20 6c 61 72 67  .  supply a larg
7a00: 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72  e chunk of memor
7a10: 79 20 66 72 6f 6d 20 77 68 69 63 68 20 61 6c 6c  y from which all
7a20: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69   memory allocati
7a30: 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b 65 6e 2e  ons are.  taken.
7a40: 0a 20 20 54 68 65 20 4d 45 4d 53 59 53 33 20 6d  .  The MEMSYS3 m
7a50: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20  emory allocator 
7a60: 75 73 65 73 20 61 20 68 79 62 72 69 64 20 61 6c  uses a hybrid al
7a70: 6c 6f 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74  location algorit
7a80: 68 6d 20 0a 20 20 70 61 74 74 65 72 6e 65 64 20  hm .  patterned 
7a90: 61 66 74 65 72 20 64 6c 6d 61 6c 6c 6f 63 28 29  after dlmalloc()
7aa0: 2e 20 20 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20  .   Only one of 
7ab0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
7ac0: 4d 53 59 53 33 20 61 6e 64 20 0a 20 20 53 51 4c  MSYS3 and .  SQL
7ad0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59  ITE_ENABLE_MEMSY
7ae0: 53 35 20 6d 61 79 20 62 65 20 65 6e 61 62 6c 65  S5 may be enable
7af0: 64 20 61 74 20 6f 6e 63 65 2e 0a 7d 0a 0a 43 4f  d at once..}..CO
7b00: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
7b10: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53  LITE_ENABLE_MEMS
7b20: 59 53 35 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  YS5} {.  This op
7b30: 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f  tion includes co
7b40: 64 65 20 69 6e 20 53 51 4c 69 74 65 20 74 68 61  de in SQLite tha
7b50: 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20  t implements an 
7b60: 61 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 6d 65  alternative.  me
7b70: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20  mory allocator. 
7b80: 20 54 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76   This alternativ
7b90: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  e memory allocat
7ba0: 6f 72 20 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67  or is only engag
7bb0: 65 64 0a 20 20 77 68 65 6e 20 74 68 65 20 5b 53  ed.  when the [S
7bc0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41  QLITE_CONFIG_HEA
7bd0: 50 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71  P] option to [sq
7be0: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20  lite3_config()] 
7bf0: 69 73 20 75 73 65 64 20 74 6f 0a 20 20 73 75 70  is used to.  sup
7c00: 70 6c 79 20 61 20 6c 61 72 67 65 20 63 68 75 6e  ply a large chun
7c10: 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d  k of memory from
7c20: 20 77 68 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72   which all memor
7c30: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72  y allocations ar
7c40: 65 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65  e.  taken..  The
7c50: 20 4d 45 4d 53 59 53 35 20 6d 6f 64 75 6c 65 20   MEMSYS5 module 
7c60: 72 6f 75 6e 64 73 20 61 6c 6c 20 61 6c 6c 6f 63  rounds all alloc
7c70: 61 74 69 6f 6e 73 20 75 70 20 74 6f 20 74 68 65  ations up to the
7c80: 20 6e 65 78 74 20 70 6f 77 65 72 0a 20 20 6f 66   next power.  of
7c90: 20 74 77 6f 20 61 6e 64 20 75 73 65 73 20 61 20   two and uses a 
7ca0: 66 69 72 73 74 2d 66 69 74 2c 20 62 75 64 64 79  first-fit, buddy
7cb0: 2d 61 6c 6c 6f 63 61 74 6f 72 20 61 6c 67 6f 72  -allocator algor
7cc0: 69 74 68 6d 0a 20 20 74 68 61 74 20 70 72 6f 76  ithm.  that prov
7cd0: 69 64 65 73 20 73 74 72 6f 6e 67 20 67 75 61 72  ides strong guar
7ce0: 61 6e 74 65 65 73 20 61 67 61 69 6e 73 74 20 66  antees against f
7cf0: 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64  ragmentation and
7d00: 20 62 72 65 61 6b 64 6f 77 6e 0a 20 20 73 75 62   breakdown.  sub
7d10: 6a 65 63 74 20 74 6f 20 63 65 72 74 61 69 6e 20  ject to certain 
7d20: 6f 70 65 72 61 74 69 6e 67 20 63 6f 6e 73 74 72  operating constr
7d30: 61 69 6e 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  aints..}..COMPIL
7d40: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
7d50: 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 7d 20 7b  _ENABLE_RTREE} {
7d60: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
7d70: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
7d80: 69 6e 63 6c 75 64 65 20 73 75 70 70 6f 72 74 20  include support 
7d90: 66 6f 72 20 74 68 65 0a 20 20 5b 72 74 72 65 65  for the.  [rtree
7da0: 20 7c 20 52 2a 54 72 65 65 20 69 6e 64 65 78 20   | R*Tree index 
7db0: 65 78 74 65 6e 73 69 6f 6e 5d 2e 0a 7d 0a 0a 43  extension]..}..C
7dc0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
7dd0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d  QLITE_ENABLE_STM
7de0: 54 5f 53 43 41 4e 53 54 41 54 55 53 7d 20 7b 0a  T_SCANSTATUS} {.
7df0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e    This option en
7e00: 61 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74  ables the [sqlit
7e10: 65 33 5f 73 74 6d 74 5f 73 63 61 6e 73 74 61 74  e3_stmt_scanstat
7e20: 75 73 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e  us()] interface.
7e30: 20 20 54 68 65 0a 20 20 5b 73 71 6c 69 74 65 33    The.  [sqlite3
7e40: 5f 73 74 6d 74 5f 73 63 61 6e 73 74 61 74 75 73  _stmt_scanstatus
7e50: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 69 73  ()] interface is
7e60: 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6d 69 74 74 65   normally omitte
7e70: 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64  d from the build
7e80: 0a 20 20 62 65 63 61 75 73 65 20 69 74 20 69 6d  .  because it im
7e90: 70 6f 73 65 73 20 61 20 73 6d 61 6c 6c 20 70 65  poses a small pe
7ea0: 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e 61 6c 74  rformance penalt
7eb0: 79 2c 20 65 76 65 6e 20 6f 6e 20 73 74 61 74 65  y, even on state
7ec0: 6d 65 6e 74 73 20 74 68 61 74 0a 20 20 64 6f 20  ments that.  do 
7ed0: 6e 6f 74 20 75 73 65 20 74 68 65 20 66 65 61 74  not use the feat
7ee0: 75 72 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ure..}..COMPILE_
7ef0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 52  OPTION {SQLITE_R
7f00: 54 52 45 45 5f 49 4e 54 5f 4f 4e 4c 59 7d 20 7b  TREE_INT_ONLY} {
7f10: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
7f20: 6e 20 69 73 20 75 73 65 64 20 74 6f 67 65 74 68  n is used togeth
7f30: 65 72 20 77 69 74 68 20 5b 53 51 4c 49 54 45 5f  er with [SQLITE_
7f40: 45 4e 41 42 4c 45 5f 52 54 52 45 45 5d 20 74 68  ENABLE_RTREE] th
7f50: 65 6e 20 74 68 65 0a 20 20 5b 72 74 72 65 65 20  en the.  [rtree 
7f60: 7c 20 52 2a 54 72 65 65 20 65 78 74 65 6e 73 69  | R*Tree extensi
7f70: 6f 6e 5d 20 77 69 6c 6c 20 6f 6e 6c 79 20 73 74  on] will only st
7f80: 6f 72 65 20 33 32 2d 62 69 74 20 73 69 67 6e 65  ore 32-bit signe
7f90: 64 20 69 6e 74 65 67 65 72 0a 20 20 63 6f 6f 72  d integer.  coor
7fa0: 64 69 6e 61 74 65 73 20 61 6e 64 20 61 6c 6c 20  dinates and all 
7fb0: 69 6e 74 65 72 6e 61 6c 20 63 6f 6d 70 75 74 61  internal computa
7fc0: 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 64 6f  tions will be do
7fd0: 6e 65 20 75 73 69 6e 67 20 69 6e 74 65 67 65 72  ne using integer
7fe0: 73 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 66  s.  instead of f
7ff0: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75  loating point nu
8000: 6d 62 65 72 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  mbers..}..COMPIL
8010: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8020: 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 7d 20  _ENABLE_SQLLOG} 
8030: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
8040: 65 6e 61 62 6c 65 73 20 65 78 74 72 61 20 63 6f  enables extra co
8050: 64 65 20 28 65 73 70 65 63 69 61 6c 6c 79 20 74  de (especially t
8060: 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  he [SQLITE_CONFI
8070: 47 5f 53 51 4c 4c 4f 47 5d 0a 20 20 6f 70 74 69  G_SQLLOG].  opti
8080: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
8090: 6f 6e 66 69 67 28 29 5d 29 20 74 68 61 74 20 63  onfig()]) that c
80a0: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72  an be used to cr
80b0: 65 61 74 65 20 6c 6f 67 73 20 6f 66 20 61 6c 6c  eate logs of all
80c0: 0a 20 20 53 51 4c 69 74 65 20 70 72 6f 63 65 73  .  SQLite proces
80d0: 73 69 6e 67 20 70 65 72 66 6f 72 6d 65 64 20 62  sing performed b
80e0: 79 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  y an application
80f0: 2e 20 20 54 68 65 73 65 20 6c 6f 67 73 20 63 61  .  These logs ca
8100: 6e 20 62 65 20 75 73 65 66 75 6c 0a 20 20 69 6e  n be useful.  in
8110: 20 64 6f 69 6e 67 20 6f 66 66 2d 6c 69 6e 65 20   doing off-line 
8120: 61 6e 61 6c 79 73 69 73 20 6f 66 20 74 68 65 20  analysis of the 
8130: 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 61  behavior of an a
8140: 70 70 6c 69 63 61 74 69 6f 6e 2c 20 61 6e 64 20  pplication, and 
8150: 65 73 70 65 63 69 61 6c 6c 79 0a 20 20 66 6f 72  especially.  for
8160: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e 61   performance ana
8170: 6c 79 73 69 73 2e 20 20 49 6e 20 6f 72 64 65 72  lysis.  In order
8180: 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f   for the SQLITE_
8190: 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70  ENABLE_SQLLOG op
81a0: 74 69 6f 6e 20 74 6f 20 0a 20 20 62 65 20 75 73  tion to .  be us
81b0: 65 66 75 6c 2c 20 73 6f 6d 65 20 65 78 74 72 61  eful, some extra
81c0: 20 63 6f 64 65 20 69 73 20 72 65 71 75 69 72 65   code is require
81d0: 64 2e 20 20 54 68 65 20 0a 20 20 3c 61 20 68 72  d.  The .  <a hr
81e0: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73  ef="http://www.s
81f0: 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 64 6f  qlite.org/src/do
8200: 63 2f 74 72 75 6e 6b 2f 73 72 63 2f 74 65 73 74  c/trunk/src/test
8210: 5f 73 71 6c 6c 6f 67 2e 63 22 3e 22 74 65 73 74  _sqllog.c">"test
8220: 5f 73 71 6c 6c 6f 67 2e 63 22 3c 2f 61 3e 0a 20  _sqllog.c"</a>. 
8230: 20 73 6f 75 72 63 65 20 63 6f 64 65 0a 20 20 66   source code.  f
8240: 69 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 69 74  ile in the SQLit
8250: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73  e source tree is
8260: 20 61 20 77 6f 72 6b 69 6e 67 20 65 78 61 6d 70   a working examp
8270: 6c 65 20 6f 66 20 74 68 65 20 72 65 71 75 69 72  le of the requir
8280: 65 64 20 65 78 74 72 61 0a 20 20 63 6f 64 65 2e  ed extra.  code.
8290: 20 20 4f 6e 20 75 6e 69 78 20 61 6e 64 20 77 69    On unix and wi
82a0: 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 2c 20 61  ndows systems, a
82b0: 20 64 65 76 65 6c 6f 70 65 72 20 63 61 6e 20 61   developer can a
82c0: 70 70 65 6e 64 20 74 68 65 20 74 65 78 74 20 6f  ppend the text o
82d0: 66 20 74 68 65 0a 20 20 22 74 65 73 74 5f 73 71  f the.  "test_sq
82e0: 6c 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65 20 63  llog.c" source c
82f0: 6f 64 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20  ode file to the 
8300: 65 6e 64 20 6f 66 20 61 6e 20 22 73 71 6c 69 74  end of an "sqlit
8310: 65 33 2e 63 22 20 61 6d 61 6c 67 61 6d 61 74 69  e3.c" amalgamati
8320: 6f 6e 2c 0a 20 20 72 65 63 6f 6d 70 69 6c 65 20  on,.  recompile 
8330: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
8340: 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51 4c 49  using the -DSQLI
8350: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47  TE_ENABLE_SQLLOG
8360: 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 0a 20   option, then . 
8370: 20 63 6f 6e 74 72 6f 6c 20 6c 6f 67 67 69 6e 67   control logging
8380: 20 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65   using environme
8390: 6e 74 20 76 61 72 69 61 62 6c 65 73 2e 20 20 53  nt variables.  S
83a0: 65 65 20 74 68 65 20 68 65 61 64 65 72 20 63 6f  ee the header co
83b0: 6d 6d 65 6e 74 20 6f 6e 20 0a 20 20 74 68 65 20  mment on .  the 
83c0: 22 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63 22 20  "test_sqllog.c" 
83d0: 73 6f 75 72 63 65 20 66 69 6c 65 20 66 6f 72 20  source file for 
83e0: 61 64 64 69 74 69 6f 6e 61 6c 20 64 65 74 61 69  additional detai
83f0: 6c 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  l.  .}..COMPILE_
8400: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
8410: 4e 41 42 4c 45 5f 53 54 41 54 32 7d 20 7b 0a 20  NABLE_STAT2} {. 
8420: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 75 73 65   This option use
8430: 64 20 74 6f 20 63 61 75 73 65 20 74 68 65 20 5b  d to cause the [
8440: 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64  ANALYZE] command
8450: 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20 69 6e   to collect.  in
8460: 64 65 78 20 68 69 73 74 6f 67 72 61 6d 20 64 61  dex histogram da
8470: 74 61 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c  ta in the <b>sql
8480: 69 74 65 5f 73 74 61 74 32 3c 2f 62 3e 20 74 61  ite_stat2</b> ta
8490: 62 6c 65 2e 20 20 42 75 74 20 74 68 61 74 0a 20  ble.  But that. 
84a0: 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 77   functionality w
84b0: 61 73 20 73 75 70 65 72 63 65 64 65 64 20 62 79  as superceded by
84c0: 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   [SQLITE_ENABLE_
84d0: 53 54 41 54 33 5d 20 61 73 20 6f 66 0a 20 20 53  STAT3] as of.  S
84e0: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e  QLite version 3.
84f0: 37 2e 39 2e 20 20 54 68 65 20 53 51 4c 49 54 45  7.9.  The SQLITE
8500: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 32 20 63 6f  _ENABLE_STAT2 co
8510: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
8520: 6e 0a 20 20 69 73 20 6e 6f 77 20 61 20 6e 6f 2d  n.  is now a no-
8530: 6f 70 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  op..}..COMPILE_O
8540: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
8550: 41 42 4c 45 5f 53 54 41 54 33 7d 20 7b 0a 20 20  ABLE_STAT3} {.  
8560: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73  This option adds
8570: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69   additional logi
8580: 63 20 74 6f 20 74 68 65 20 5b 41 4e 41 4c 59 5a  c to the [ANALYZ
8590: 45 5d 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74  E] command and t
85a0: 6f 0a 20 20 74 68 65 20 5b 71 75 65 72 79 20 70  o.  the [query p
85b0: 6c 61 6e 6e 65 72 5d 20 74 68 61 74 20 63 61 6e  lanner] that can
85c0: 20 68 65 6c 70 20 53 51 4c 69 74 65 20 74 6f 20   help SQLite to 
85d0: 63 68 6f 73 65 20 61 20 62 65 74 74 65 72 20 71  chose a better q
85e0: 75 65 72 79 20 70 6c 61 6e 0a 20 20 75 6e 64 65  uery plan.  unde
85f0: 72 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74  r certain situat
8600: 69 6f 6e 73 2e 20 20 54 68 65 20 5b 41 4e 41 4c  ions.  The [ANAL
8610: 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  YZE] command is 
8620: 65 6e 68 61 6e 63 65 64 20 74 6f 20 63 6f 6c 6c  enhanced to coll
8630: 65 63 74 0a 20 20 68 69 73 74 6f 67 72 61 6d 20  ect.  histogram 
8640: 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 6c 65  data from the le
8650: 66 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f  ft-most column o
8660: 66 20 65 61 63 68 20 69 6e 64 65 78 20 61 6e 64  f each index and
8670: 20 73 74 6f 72 65 20 74 68 61 74 20 64 61 74 61   store that data
8680: 0a 20 20 69 6e 20 74 68 65 20 5b 73 71 6c 69 74  .  in the [sqlit
8690: 65 5f 73 74 61 74 33 5d 20 74 61 62 6c 65 2e 20  e_stat3] table. 
86a0: 20 54 68 65 20 71 75 65 72 79 20 70 6c 61 6e 6e   The query plann
86b0: 65 72 20 77 69 6c 6c 20 74 68 65 6e 20 75 73 65  er will then use
86c0: 20 74 68 65 0a 20 20 68 69 73 74 6f 67 72 61 6d   the.  histogram
86d0: 20 64 61 74 61 20 74 6f 20 68 65 6c 70 20 69 74   data to help it
86e0: 20 6d 61 6b 65 20 62 65 74 74 65 72 20 69 6e 64   make better ind
86f0: 65 78 20 63 68 6f 69 63 65 73 2e 20 20 4e 6f 74  ex choices.  Not
8700: 65 2c 20 68 6f 77 65 76 65 72 2c 0a 20 20 74 68  e, however,.  th
8710: 61 74 20 74 68 65 20 75 73 65 20 6f 66 20 68 69  at the use of hi
8720: 73 74 6f 67 72 61 6d 20 64 61 74 61 20 69 6e 20  stogram data in 
8730: 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20 76 69  query planner vi
8740: 6f 6c 61 74 65 73 20 74 68 65 0a 20 20 5b 71 75  olates the.  [qu
8750: 65 72 79 20 70 6c 61 6e 6e 65 72 20 73 74 61 62  ery planner stab
8760: 69 6c 69 74 79 20 67 75 61 72 61 6e 74 65 65 5d  ility guarantee]
8770: 20 77 68 69 63 68 20 69 73 20 69 6d 70 6f 72 74   which is import
8780: 61 6e 74 20 74 6f 20 73 6f 6d 65 20 61 70 70 6c  ant to some appl
8790: 69 63 61 74 69 6f 6e 73 2e 0a 20 20 3c 70 3e 0a  ications..  <p>.
87a0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
87b0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
87c0: 5f 53 54 41 54 34 7d 20 7b 0a 20 20 54 68 69 73  _STAT4} {.  This
87d0: 20 6f 70 74 69 6f 6e 20 61 64 64 73 20 61 64 64   option adds add
87e0: 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 74 6f  itional logic to
87f0: 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63   the [ANALYZE] c
8800: 6f 6d 6d 61 6e 64 20 61 6e 64 20 74 6f 0a 20 20  ommand and to.  
8810: 74 68 65 20 5b 71 75 65 72 79 20 70 6c 61 6e 6e  the [query plann
8820: 65 72 5d 20 74 68 61 74 20 63 61 6e 20 68 65 6c  er] that can hel
8830: 70 20 53 51 4c 69 74 65 20 74 6f 20 63 68 6f 73  p SQLite to chos
8840: 65 20 61 20 62 65 74 74 65 72 20 71 75 65 72 79  e a better query
8850: 20 70 6c 61 6e 0a 20 20 75 6e 64 65 72 20 63 65   plan.  under ce
8860: 72 74 61 69 6e 20 73 69 74 75 61 74 69 6f 6e 73  rtain situations
8870: 2e 20 20 54 68 65 20 5b 41 4e 41 4c 59 5a 45 5d  .  The [ANALYZE]
8880: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 6e 68 61   command is enha
8890: 6e 63 65 64 20 74 6f 20 63 6f 6c 6c 65 63 74 0a  nced to collect.
88a0: 20 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61    histogram data
88b0: 20 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e   from all column
88c0: 73 20 6f 66 20 65 76 65 72 79 20 69 6e 64 65 78  s of every index
88d0: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 61 74 20   and store that 
88e0: 64 61 74 61 0a 20 20 69 6e 20 74 68 65 20 5b 73  data.  in the [s
88f0: 71 6c 69 74 65 5f 73 74 61 74 34 5d 20 74 61 62  qlite_stat4] tab
8900: 6c 65 2e 20 20 54 68 65 20 71 75 65 72 79 20 70  le.  The query p
8910: 6c 61 6e 6e 65 72 20 77 69 6c 6c 20 74 68 65 6e  lanner will then
8920: 20 75 73 65 20 74 68 65 0a 20 20 68 69 73 74 6f   use the.  histo
8930: 67 72 61 6d 20 64 61 74 61 20 74 6f 20 68 65 6c  gram data to hel
8940: 70 20 69 74 20 6d 61 6b 65 20 62 65 74 74 65 72  p it make better
8950: 20 69 6e 64 65 78 20 63 68 6f 69 63 65 73 2e 20   index choices. 
8960: 20 54 68 65 20 64 6f 77 6e 73 69 64 65 20 6f 66   The downside of
8970: 0a 20 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d  .  this compile-
8980: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 74  time option is t
8990: 68 61 74 20 69 74 20 76 69 6f 6c 61 74 65 73 20  hat it violates 
89a0: 74 68 65 0a 20 20 5b 71 75 65 72 79 20 70 6c 61  the.  [query pla
89b0: 6e 6e 65 72 20 73 74 61 62 69 6c 69 74 79 20 67  nner stability g
89c0: 75 61 72 61 6e 74 65 65 5d 20 6d 61 6b 69 6e 67  uarantee] making
89d0: 20 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75   it more difficu
89e0: 6c 74 20 74 6f 20 65 6e 73 75 72 65 0a 20 20 63  lt to ensure.  c
89f0: 6f 6e 73 69 73 74 65 6e 74 20 70 65 72 66 6f 72  onsistent perfor
8a00: 6d 61 6e 63 65 20 69 6e 20 6d 61 73 73 2d 70 72  mance in mass-pr
8a10: 6f 64 75 63 65 64 20 61 70 70 6c 69 63 61 74 69  oduced applicati
8a20: 6f 6e 73 2e 0a 20 20 3c 70 3e 0a 20 20 53 51 4c  ons..  <p>.  SQL
8a30: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34  ITE_ENABLE_STAT4
8a40: 20 69 73 20 61 6e 20 65 6e 68 61 6e 63 65 6d 65   is an enhanceme
8a50: 6e 74 20 6f 66 20 5b 53 51 4c 49 54 45 5f 45 4e  nt of [SQLITE_EN
8a60: 41 42 4c 45 5f 53 54 41 54 33 5d 2e 20 20 53 54  ABLE_STAT3].  ST
8a70: 41 54 33 0a 20 20 6f 6e 6c 79 20 72 65 63 6f 72  AT3.  only recor
8a80: 64 65 64 20 68 69 73 74 6f 67 72 61 6d 20 64 61  ded histogram da
8a90: 74 61 20 66 6f 72 20 74 68 65 20 6c 65 66 74 2d  ta for the left-
8aa0: 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 65  most column of e
8ab0: 61 63 68 20 69 6e 64 65 78 0a 20 20 77 68 65 72  ach index.  wher
8ac0: 65 61 73 20 74 68 65 20 53 54 41 54 34 20 65 6e  eas the STAT4 en
8ad0: 68 61 6e 63 65 6d 65 6e 74 20 72 65 63 6f 72 64  hancement record
8ae0: 73 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61  s histogram data
8af0: 20 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e   from all column
8b00: 73 0a 20 20 6f 66 20 65 61 63 68 20 69 6e 64 65  s.  of each inde
8b10: 78 2e 0a 20 20 54 68 65 20 5b 53 51 4c 49 54 45  x..  The [SQLITE
8b20: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5d 20 63  _ENABLE_STAT3] c
8b30: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
8b40: 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 61 6e  on is a no-op an
8b50: 64 20 69 73 20 69 67 6e 6f 72 65 64 0a 20 20 69  d is ignored.  i
8b60: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41  f the SQLITE_ENA
8b70: 42 4c 45 5f 53 54 41 54 34 20 63 6f 6d 70 69 6c  BLE_STAT4 compil
8b80: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73  e-time option is
8b90: 20 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c   used..}..COMPIL
8ba0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8bb0: 5f 45 4e 41 42 4c 45 5f 54 52 45 45 5f 45 58 50  _ENABLE_TREE_EXP
8bc0: 4c 41 49 4e 7d 20 7b 0a 20 20 54 68 69 73 20 63  LAIN} {.  This c
8bd0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
8be0: 6f 6e 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20  on is no longer 
8bf0: 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  used..}..COMPILE
8c00: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
8c10: 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f 44 45  ENABLE_UPDATE_DE
8c20: 4c 45 54 45 5f 4c 49 4d 49 54 7d 20 7b 0a 20 20  LETE_LIMIT} {.  
8c30: 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62  This option enab
8c40: 6c 65 73 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20  les an optional 
8c50: 4f 52 44 45 52 20 42 59 20 61 6e 64 20 4c 49 4d  ORDER BY and LIM
8c60: 49 54 20 63 6c 61 75 73 65 20 6f 6e 20 0a 20 20  IT clause on .  
8c70: 5b 55 50 44 41 54 45 5d 20 61 6e 64 20 5b 44 45  [UPDATE] and [DE
8c80: 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e 74 73  LETE] statements
8c90: 2e 0a 0a 20 20 3c 70 3e 49 66 20 74 68 69 73 20  ...  <p>If this 
8ca0: 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65  option is define
8cb0: 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74 20  d, then it must 
8cc0: 61 6c 73 6f 20 62 65 20 0a 20 20 64 65 66 69 6e  also be .  defin
8cd0: 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20 74 68  ed when using th
8ce0: 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74  e 'lemon' tool t
8cf0: 6f 20 67 65 6e 65 72 61 74 65 20 61 20 70 61 72  o generate a par
8d00: 73 65 2e 63 0a 20 20 66 69 6c 65 2e 20 42 65 63  se.c.  file. Bec
8d10: 61 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74 68  ause of this, th
8d20: 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 6f 6e  is option may on
8d30: 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 6e 20  ly be used when 
8d40: 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 62  the library is b
8d50: 75 69 6c 74 0a 20 20 66 72 6f 6d 20 73 6f 75 72  uilt.  from sour
8d60: 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68 65  ce, not from the
8d70: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20   [amalgamation] 
8d80: 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c  or from the coll
8d90: 65 63 74 69 6f 6e 20 6f 66 0a 20 20 70 72 65 2d  ection of.  pre-
8da0: 70 61 63 6b 61 67 65 64 20 43 20 66 69 6c 65 73  packaged C files
8db0: 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 6e 6f   provided for no
8dc0: 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70 6c 61 74  n-Unix like plat
8dd0: 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20 77 65 62  forms on the web
8de0: 73 69 74 65 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a  site..  </p>.}..
8df0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
8e00: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 4e  SQLITE_ENABLE_UN
8e10: 4c 4f 43 4b 5f 4e 4f 54 49 46 59 7d 20 7b 0a 20  LOCK_NOTIFY} {. 
8e20: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61   This option ena
8e30: 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65  bles the [sqlite
8e40: 33 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28  3_unlock_notify(
8e50: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 61 6e 64  )] interface and
8e60: 0a 20 20 69 74 73 20 61 73 73 6f 63 69 61 74 65  .  its associate
8e70: 64 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e  d functionality.
8e80: 20 20 53 65 65 20 74 68 65 20 64 6f 63 75 6d 65    See the docume
8e90: 6e 74 61 74 69 6f 6e 20 74 69 74 6c 65 64 0a 20  ntation titled. 
8ea0: 20 5b 55 73 69 6e 67 20 74 68 65 20 53 51 4c 69   [Using the SQLi
8eb0: 74 65 20 55 6e 6c 6f 63 6b 20 4e 6f 74 69 66 69  te Unlock Notifi
8ec0: 63 61 74 69 6f 6e 20 46 65 61 74 75 72 65 5d 20  cation Feature] 
8ed0: 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 0a 20  for additional. 
8ee0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a   information..}.
8ef0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
8f00: 7b 53 51 4c 49 54 45 5f 53 4f 55 4e 44 45 58 7d  {SQLITE_SOUNDEX}
8f10: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
8f20: 20 65 6e 61 62 6c 65 73 20 74 68 65 20 5b 73 6f   enables the [so
8f30: 75 6e 64 65 78 28 29 20 53 51 4c 20 66 75 6e 63  undex() SQL func
8f40: 74 69 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  tion]..}..COMPIL
8f50: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8f60: 5f 55 53 45 5f 46 43 4e 54 4c 5f 54 52 41 43 45  _USE_FCNTL_TRACE
8f70: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
8f80: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
8f90: 74 6f 20 69 73 73 75 65 20 65 78 74 72 61 20 5b  to issue extra [
8fa0: 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 54 52 41  SQLITE_FCNTL_TRA
8fb0: 43 45 5d 20 66 69 6c 65 20 63 6f 6e 74 72 6f 6c  CE] file control
8fc0: 73 0a 20 20 74 6f 20 70 72 6f 76 69 64 65 20 73  s.  to provide s
8fd0: 75 70 70 6c 65 6d 65 6e 74 61 72 79 20 69 6e 66  upplementary inf
8fe0: 6f 72 6d 61 74 69 6f 6e 20 74 6f 20 74 68 65 20  ormation to the 
8ff0: 56 46 53 2e 20 20 54 68 65 20 22 76 66 73 6c 6f  VFS.  The "vfslo
9000: 67 2e 63 22 20 65 78 74 65 6e 73 69 6f 6e 0a 20  g.c" extension. 
9010: 20 6d 61 6b 65 73 20 75 73 65 20 6f 66 20 74 68   makes use of th
9020: 69 73 20 74 6f 20 70 72 6f 76 69 64 65 20 65 6e  is to provide en
9030: 68 61 6e 63 65 64 20 6c 6f 67 73 20 6f 66 20 56  hanced logs of V
9040: 46 53 20 61 63 74 69 76 69 74 79 2e 0a 7d 0a 0a  FS activity..}..
9050: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9060: 59 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b 44  YYTRACKMAXSTACKD
9070: 45 50 54 48 7d 20 7b 0a 20 20 54 68 69 73 20 6f  EPTH} {.  This o
9080: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 65  ption causes the
9090: 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72 20   LALR(1) parser 
90a0: 73 74 61 63 6b 20 64 65 70 74 68 20 74 6f 20 62  stack depth to b
90b0: 65 20 74 72 61 63 6b 65 64 0a 20 20 61 6e 64 20  e tracked.  and 
90c0: 72 65 70 6f 72 74 65 64 20 75 73 69 6e 67 20 74  reported using t
90d0: 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74  he [sqlite3_stat
90e0: 75 73 5d 28 5b 53 51 4c 49 54 45 5f 53 54 41 54  us]([SQLITE_STAT
90f0: 55 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b 5d  US_PARSER_STACK]
9100: 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65 72 66 61 63  ,...).  interfac
9110: 65 2e 20 20 53 51 4c 69 74 65 27 73 20 4c 41 4c  e.  SQLite's LAL
9120: 52 28 31 29 20 70 61 72 73 65 72 20 68 61 73 20  R(1) parser has 
9130: 61 20 66 69 78 65 64 20 73 74 61 63 6b 20 64 65  a fixed stack de
9140: 70 74 68 0a 20 20 28 64 65 74 65 72 6d 69 6e 65  pth.  (determine
9150: 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  d at compile-tim
9160: 65 20 75 73 69 6e 67 20 74 68 65 20 5b 59 59 53  e using the [YYS
9170: 54 41 43 4b 44 45 50 54 48 5d 20 6f 70 74 69 6f  TACKDEPTH] optio
9180: 6e 73 29 2e 0a 20 20 54 68 69 73 20 6f 70 74 69  ns)..  This opti
9190: 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 74  on can be used t
91a0: 6f 20 68 65 6c 70 20 64 65 74 65 72 6d 69 6e 65  o help determine
91b0: 20 69 66 20 61 6e 20 61 70 70 6c 69 63 61 74 69   if an applicati
91c0: 6f 6e 20 69 73 0a 20 20 67 65 74 74 69 6e 67 20  on is.  getting 
91d0: 63 6c 6f 73 65 20 74 6f 20 65 78 63 65 65 64 69  close to exceedi
91e0: 6e 67 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 4c  ng the maximum L
91f0: 41 4c 52 28 31 29 20 73 74 61 63 6b 20 64 65 70  ALR(1) stack dep
9200: 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61  th..}.</tcl>..<a
9210: 20 6e 61 6d 65 3d 22 64 69 73 61 62 6c 65 66 65   name="disablefe
9220: 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32  atures"></a>.<h2
9230: 3e 31 2e 36 20 4f 70 74 69 6f 6e 73 20 54 6f 20  >1.6 Options To 
9240: 44 69 73 61 62 6c 65 20 46 65 61 74 75 72 65 73  Disable Features
9250: 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65 64   Normally Turned
9260: 20 4f 6e 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a   On</h2>..<tcl>.
9270: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9280: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c  SQLITE_DISABLE_L
9290: 46 53 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  FS} {.  If this 
92a0: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d  C-preprocessor m
92b0: 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c  acro is defined,
92c0: 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 70   large file supp
92d0: 6f 72 74 0a 20 20 69 73 20 64 69 73 61 62 6c 65  ort.  is disable
92e0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
92f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53  TION {SQLITE_DIS
9300: 41 42 4c 45 5f 44 49 52 53 59 4e 43 7d 20 7b 0a  ABLE_DIRSYNC} {.
9310: 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65 70    If this C-prep
9320: 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69  rocessor macro i
9330: 73 20 64 65 66 69 6e 65 64 2c 20 64 69 72 65 63  s defined, direc
9340: 74 6f 72 79 20 73 79 6e 63 73 0a 20 20 61 72 65  tory syncs.  are
9350: 20 64 69 73 61 62 6c 65 64 2e 20 20 53 51 4c 69   disabled.  SQLi
9360: 74 65 20 74 79 70 69 63 61 6c 6c 79 20 61 74 74  te typically att
9370: 65 6d 70 74 73 20 74 6f 20 73 79 6e 63 20 74 68  empts to sync th
9380: 65 20 70 61 72 65 6e 74 0a 20 20 64 69 72 65 63  e parent.  direc
9390: 74 6f 72 79 20 77 68 65 6e 20 61 20 66 69 6c 65  tory when a file
93a0: 20 69 73 20 64 65 6c 65 74 65 64 20 74 6f 20 65   is deleted to e
93b0: 6e 73 75 72 65 20 74 68 65 20 64 69 72 65 63 74  nsure the direct
93c0: 6f 72 79 0a 20 20 65 6e 74 72 69 65 73 20 61 72  ory.  entries ar
93d0: 65 20 75 70 64 61 74 65 64 20 69 6d 6d 65 64 69  e updated immedi
93e0: 61 74 65 6c 79 20 6f 6e 20 64 69 73 6b 2e 0a 7d  ately on disk..}
93f0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
9400: 20 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45   {SQLITE_DISABLE
9410: 5f 46 54 53 33 5f 55 4e 49 43 4f 44 45 7d 20 7b  _FTS3_UNICODE} {
9420: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
9430: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
9440: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
9450: 5b 75 6e 69 63 6f 64 65 36 31 5d 20 74 6f 6b 65  [unicode61] toke
9460: 6e 69 7a 65 72 0a 20 20 69 6e 20 5b 46 54 53 33  nizer.  in [FTS3
9470: 5d 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f  ] is omitted fro
9480: 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64 20  m the build and 
9490: 69 73 20 75 6e 61 76 61 69 6c 61 62 6c 65 20 74  is unavailable t
94a0: 6f 20 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e  o .  application
94b0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
94c0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53  TION {SQLITE_DIS
94d0: 41 42 4c 45 5f 46 54 53 34 5f 44 45 46 45 52 52  ABLE_FTS4_DEFERR
94e0: 45 44 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  ED} {.  If this 
94f0: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d  C-preprocessor m
9500: 61 63 72 6f 20 64 69 73 61 62 6c 65 73 20 74 68  acro disables th
9510: 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b 65  e "deferred toke
9520: 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a  n" optimization.
9530: 20 20 69 6e 20 5b 46 54 53 34 5d 2e 20 20 54 68    in [FTS4].  Th
9540: 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b 65  e "deferred toke
9550: 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  n" optimization 
9560: 61 76 6f 69 64 73 20 6c 6f 61 64 69 6e 67 20 6d  avoids loading m
9570: 61 73 73 69 76 65 0a 20 20 70 6f 73 74 69 6e 67  assive.  posting
9580: 20 6c 69 73 74 73 20 66 6f 72 20 74 65 72 6d 73   lists for terms
9590: 20 74 68 61 74 20 61 72 65 20 69 6e 20 6d 6f 73   that are in mos
95a0: 74 20 64 6f 63 75 6d 65 6e 74 73 20 6f 66 20 74  t documents of t
95b0: 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 0a 20 20  he collection.  
95c0: 61 6e 64 20 69 6e 73 74 65 61 64 20 73 69 6d 70  and instead simp
95d0: 6c 79 20 73 63 61 6e 73 20 66 6f 72 20 74 68 6f  ly scans for tho
95e0: 73 65 20 74 6f 6b 65 6e 73 20 69 6e 20 74 68 65  se tokens in the
95f0: 20 64 6f 63 75 6d 65 6e 74 20 73 6f 75 72 63 65   document source
9600: 2e 20 20 5b 46 54 53 34 5d 0a 20 20 73 68 6f 75  .  [FTS4].  shou
9610: 6c 64 20 67 65 74 20 65 78 61 63 74 6c 79 20 74  ld get exactly t
9620: 68 65 20 73 61 6d 65 20 61 6e 73 77 65 72 20 62  he same answer b
9630: 6f 74 68 20 77 69 74 68 20 61 6e 64 20 77 69 74  oth with and wit
9640: 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6d 69  hout this optimi
9650: 7a 61 74 69 6f 6e 2e 0a 7d 0a 3c 2f 74 63 6c 3e  zation..}.</tcl>
9660: 0a 0a 3c 74 63 6c 3e 0a 20 20 68 64 5f 66 72 61  ..<tcl>.  hd_fra
9670: 67 6d 65 6e 74 20 22 6f 6d 69 74 66 65 61 74 75  gment "omitfeatu
9680: 72 65 73 22 0a 20 20 68 64 5f 6b 65 79 77 6f 72  res".  hd_keywor
9690: 64 73 20 22 6f 6d 69 74 66 65 61 74 75 72 65 73  ds "omitfeatures
96a0: 22 0a 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 31 2e 37  ".</tcl>.<h2>1.7
96b0: 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d 69 74   Options To Omit
96c0: 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e 0a 0a   Features</h2>..
96d0: 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  <p>The following
96e0: 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 65 20   options can be 
96f0: 75 73 65 64 20 74 6f 20 0a 5b 72 65 6c 66 6f 6f  used to .[relfoo
9700: 74 70 72 69 6e 74 20 7c 20 72 65 64 75 63 65 20  tprint | reduce 
9710: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
9720: 63 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72 79  compiled library
9730: 5d 0a 62 79 20 6f 6d 69 74 74 69 6e 67 20 75 6e  ].by omitting un
9740: 75 73 65 64 20 66 65 61 74 75 72 65 73 2e 20 54  used features. T
9750: 68 69 73 20 69 73 20 70 72 6f 62 61 62 6c 79 20  his is probably 
9760: 6f 6e 6c 79 20 75 73 65 66 75 6c 0a 69 6e 20 65  only useful.in e
9770: 6d 62 65 64 64 65 64 20 73 79 73 74 65 6d 73 20  mbedded systems 
9780: 77 68 65 72 65 20 73 70 61 63 65 20 69 73 20 65  where space is e
9790: 73 70 65 63 69 61 6c 6c 79 20 74 69 67 68 74 2c  specially tight,
97a0: 20 61 73 20 65 76 65 6e 20 77 69 74 68 20 61 6c   as even with al
97b0: 6c 0a 66 65 61 74 75 72 65 73 20 69 6e 63 6c 75  l.features inclu
97c0: 64 65 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c  ded the SQLite l
97d0: 69 62 72 61 72 79 20 69 73 20 72 65 6c 61 74 69  ibrary is relati
97e0: 76 65 6c 79 20 73 6d 61 6c 6c 2e 20 44 6f 6e 27  vely small. Don'
97f0: 74 20 66 6f 72 67 65 74 0a 74 6f 20 74 65 6c 6c  t forget.to tell
9800: 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 74   your compiler t
9810: 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20 62  o optimize for b
9820: 69 6e 61 72 79 20 73 69 7a 65 21 20 28 74 68 65  inary size! (the
9830: 20 2d 4f 73 20 6f 70 74 69 6f 6e 20 69 66 0a 75   -Os option if.u
9840: 73 69 6e 67 20 47 43 43 29 2e 20 20 54 65 6c 6c  sing GCC).  Tell
9850: 69 6e 67 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65  ing your compile
9860: 72 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f  r to optimize fo
9870: 72 20 73 69 7a 65 20 75 73 75 61 6c 6c 79 20 68  r size usually h
9880: 61 73 0a 61 20 6d 75 63 68 20 6c 61 72 67 65 72  as.a much larger
9890: 20 69 6d 70 61 63 74 20 6f 6e 20 6c 69 62 72 61   impact on libra
98a0: 72 79 20 66 6f 6f 74 70 72 69 6e 74 20 74 68 61  ry footprint tha
98b0: 6e 20 65 6d 70 6c 6f 79 69 6e 67 20 61 6e 79 20  n employing any 
98c0: 6f 66 20 74 68 65 73 65 0a 63 6f 6d 70 69 6c 65  of these.compile
98d0: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 20 20  -time options.  
98e0: 59 6f 75 20 73 68 6f 75 6c 64 20 61 6c 73 6f 20  You should also 
98f0: 76 65 72 69 66 79 20 74 68 61 74 20 0a 3c 61 20  verify that .<a 
9900: 68 72 65 66 3d 22 23 64 65 62 75 67 6f 70 74 69  href="#debugopti
9910: 6f 6e 73 22 3e 64 65 62 75 67 67 69 6e 67 20 6f  ons">debugging o
9920: 70 74 69 6f 6e 73 3c 2f 61 3e 20 61 72 65 20 64  ptions</a> are d
9930: 69 73 61 62 6c 65 64 2e 3c 2f 70 3e 0a 0a 3c 70  isabled.</p>..<p
9940: 3e 54 68 65 20 6d 61 63 72 6f 73 20 69 6e 20 74  >The macros in t
9950: 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 20 6e  his section do n
9960: 6f 74 20 72 65 71 75 69 72 65 20 76 61 6c 75 65  ot require value
9970: 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  s. The following
9980: 20 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 73 77   .compilation sw
9990: 69 74 63 68 65 73 20 61 6c 6c 20 68 61 76 65 20  itches all have 
99a0: 74 68 65 20 73 61 6d 65 20 65 66 66 65 63 74 3a  the same effect:
99b0: 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d  <br>.-DSQLITE_OM
99c0: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3c 62 72  IT_ALTERTABLE<br
99d0: 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  >.-DSQLITE_OMIT_
99e0: 41 4c 54 45 52 54 41 42 4c 45 3d 31 3c 62 72 3e  ALTERTABLE=1<br>
99f0: 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  .-DSQLITE_OMIT_A
9a00: 4c 54 45 52 54 41 42 4c 45 3d 30 0a 3c 2f 70 3e  LTERTABLE=0.</p>
9a10: 0a 0a 3c 70 3e 49 66 20 61 6e 79 20 6f 66 20 74  ..<p>If any of t
9a20: 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 61 72 65  hese options are
9a30: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74   defined, then t
9a40: 68 65 20 73 61 6d 65 20 73 65 74 20 6f 66 20 53  he same set of S
9a50: 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 0a 6f 70 74  QLITE_OMIT_*.opt
9a60: 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73 6f 20 62  ions must also b
9a70: 65 20 64 65 66 69 6e 65 64 20 77 68 65 6e 20 75  e defined when u
9a80: 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f 6e 27  sing the 'lemon'
9a90: 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72 61 74   tool to generat
9aa0: 65 20 74 68 65 0a 70 61 72 73 65 2e 63 20 66 69  e the.parse.c fi
9ab0: 6c 65 20 61 6e 64 20 77 68 65 6e 20 63 6f 6d 70  le and when comp
9ac0: 69 6c 69 6e 67 20 74 68 65 20 27 6d 6b 6b 65 79  iling the 'mkkey
9ad0: 77 6f 72 64 68 61 73 68 27 20 74 6f 6f 6c 20 77  wordhash' tool w
9ae0: 68 69 63 68 20 67 65 6e 65 72 61 74 65 73 20 0a  hich generates .
9af0: 74 68 65 20 6b 65 79 77 6f 72 64 68 61 73 68 2e  the keywordhash.
9b00: 68 20 66 69 6c 65 2e 0a 42 65 63 61 75 73 65 20  h file..Because 
9b10: 6f 66 20 74 68 69 73 2c 20 74 68 65 73 65 20 6f  of this, these o
9b20: 70 74 69 6f 6e 73 20 6d 61 79 20 6f 6e 6c 79 20  ptions may only 
9b30: 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65  be used when the
9b40: 20 6c 69 62 72 61 72 79 20 69 73 20 62 75 69 6c   library is buil
9b50: 74 0a 66 72 6f 6d 20 63 61 6e 6f 6e 69 63 61 6c  t.from canonical
9b60: 20 73 6f 75 72 63 65 2c 20 6e 6f 74 20 66 72 6f   source, not fro
9b70: 6d 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74  m the [amalgamat
9b80: 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d 20 74 68 65  ion] or from the
9b90: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a 70   collection of.p
9ba0: 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20 66 69  re-packaged C fi
9bb0: 6c 65 73 20 70 72 6f 76 69 64 65 64 20 66 6f 72  les provided for
9bc0: 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70   non-Unix like p
9bd0: 6c 61 74 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20  latforms on the 
9be0: 77 65 62 73 69 74 65 2e 0a 41 6e 79 20 53 51 4c  website..Any SQL
9bf0: 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f  ITE_OMIT_* optio
9c00: 6e 73 20 77 68 69 63 68 20 63 61 6e 20 62 65 20  ns which can be 
9c10: 75 73 65 64 20 64 69 72 65 63 74 6c 79 20 77 69  used directly wi
9c20: 74 68 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61  th the [amalgama
9c30: 74 69 6f 6e 5d 20 0a 61 72 65 20 6c 69 73 74 65  tion] .are liste
9c40: 64 20 62 65 6c 6f 77 2c 20 68 6f 77 65 76 65 72  d below, however
9c50: 2c 20 74 68 65 20 77 61 72 6e 69 6e 67 73 20 69  , the warnings i
9c60: 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  n the following 
9c70: 70 61 72 61 67 72 61 70 68 20 73 68 6f 75 6c 64  paragraph should
9c80: 20 62 65 20 6e 6f 74 65 64 2e 0a 3c 2f 70 3e 0a   be noted..</p>.
9c90: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 69  .<blockquote>.<i
9ca0: 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e 74 20 4e 6f  ><b>Important No
9cb0: 74 65 3a 3c 2f 62 3e 20 54 68 65 20 53 51 4c 49  te:</b> The SQLI
9cc0: 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e  TE_OMIT_* option
9cd0: 73 20 64 6f 20 6e 6f 74 20 77 6f 72 6b 20 77 69  s do not work wi
9ce0: 74 68 20 74 68 65 0a 5b 61 6d 61 6c 67 61 6d 61  th the.[amalgama
9cf0: 74 69 6f 6e 5d 20 6f 72 20 77 69 74 68 20 70 72  tion] or with pr
9d00: 65 2d 70 61 63 6b 61 67 65 64 20 43 20 63 6f 64  e-packaged C cod
9d10: 65 20 66 69 6c 65 73 2e 20 20 53 51 4c 49 54 45  e files.  SQLITE
9d20: 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d  _OMIT_* compile-
9d30: 74 69 6d 65 0a 6f 70 74 69 6f 6e 73 20 6f 6e 6c  time.options onl
9d40: 79 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79  y work correctly
9d50: 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73 20   when SQLite is 
9d60: 62 75 69 6c 74 20 66 72 6f 6d 20 63 61 6e 6f 6e  built from canon
9d70: 69 63 61 6c 20 73 6f 75 72 63 65 20 66 69 6c 65  ical source file
9d80: 73 2e 0a 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71  s..</i>.</blockq
9d90: 75 6f 74 65 3e 0a 0a 0a 3c 70 3e 53 70 65 63 69  uote>...<p>Speci
9da0: 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74  al versions of t
9db0: 68 65 20 53 51 4c 69 74 65 20 61 6d 61 6c 67 61  he SQLite amalga
9dc0: 6d 61 74 69 6f 6e 20 74 68 61 74 20 64 6f 20 77  mation that do w
9dd0: 6f 72 6b 20 77 69 74 68 20 61 0a 70 72 65 64 65  ork with a.prede
9de0: 74 65 72 6d 69 6e 65 64 20 73 65 74 20 6f 66 20  termined set of 
9df0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70  SQLITE_OMIT_* op
9e00: 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 67 65 6e  tions can be gen
9e10: 65 72 61 74 65 64 2e 20 20 54 6f 20 64 6f 20 73  erated.  To do s
9e20: 6f 2c 0a 6d 61 6b 65 20 61 20 63 6f 70 79 20 6f  o,.make a copy o
9e30: 66 20 74 68 65 20 4d 61 6b 65 66 69 6c 65 2e 6c  f the Makefile.l
9e40: 69 6e 75 78 2d 67 63 63 20 6d 61 6b 65 66 69 6c  inux-gcc makefil
9e50: 65 20 74 65 6d 70 6c 61 74 65 20 69 6e 20 74 68  e template in th
9e60: 65 20 63 61 6e 6f 6e 69 63 61 6c 0a 73 6f 75 72  e canonical.sour
9e70: 63 65 20 63 6f 64 65 20 64 69 73 74 72 69 62 75  ce code distribu
9e80: 74 69 6f 6e 2e 20 20 43 68 61 6e 67 65 20 74 68  tion.  Change th
9e90: 65 20 6e 61 6d 65 20 6f 66 20 79 6f 75 72 20 63  e name of your c
9ea0: 6f 70 79 20 74 6f 20 73 69 6d 70 6c 79 20 22 4d  opy to simply "M
9eb0: 61 6b 65 66 69 6c 65 22 2e 0a 54 68 65 6e 20 65  akefile"..Then e
9ec0: 64 69 74 20 22 4d 61 6b 65 66 69 6c 65 22 20 74  dit "Makefile" t
9ed0: 6f 20 73 65 74 20 75 70 20 61 70 70 72 6f 70 72  o set up appropr
9ee0: 69 61 74 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  iate compile-tim
9ef0: 65 20 6f 70 74 69 6f 6e 73 2e 20 20 54 68 65 6e  e options.  Then
9f00: 0a 74 79 70 65 3a 0a 3c 62 6c 6f 63 6b 71 75 6f  .type:.<blockquo
9f10: 74 65 3e 3c 74 74 3e 6d 61 6b 65 20 63 6c 65 61  te><tt>make clea
9f20: 6e 3b 20 6d 61 6b 65 20 73 71 6c 69 74 65 33 2e  n; make sqlite3.
9f30: 63 3c 2f 74 74 3e 3c 2f 62 6c 6f 63 6b 71 75 6f  c</tt></blockquo
9f40: 74 65 3e 0a 54 68 65 20 72 65 73 75 6c 74 69 6e  te>.The resultin
9f50: 67 20 22 73 71 6c 69 74 65 33 2e 63 22 20 61 6d  g "sqlite3.c" am
9f60: 61 6c 67 61 6d 61 74 69 6f 6e 20 63 6f 64 65 20  algamation code 
9f70: 66 69 6c 65 20 28 61 6e 64 20 69 74 73 20 61 73  file (and its as
9f80: 73 6f 63 69 61 74 65 64 0a 68 65 61 64 65 72 20  sociated.header 
9f90: 66 69 6c 65 20 22 73 71 6c 69 74 65 33 2e 68 22  file "sqlite3.h"
9fa0: 29 20 63 61 6e 20 74 68 65 6e 20 62 65 20 6d 6f  ) can then be mo
9fb0: 76 65 64 20 74 6f 20 61 20 6e 6f 6e 2d 75 6e 69  ved to a non-uni
9fc0: 78 20 70 6c 61 74 66 6f 72 6d 0a 66 6f 72 20 66  x platform.for f
9fd0: 69 6e 61 6c 20 63 6f 6d 70 69 6c 61 74 69 6f 6e  inal compilation
9fe0: 20 75 73 69 6e 67 20 61 20 6e 61 74 69 76 65 20   using a native 
9ff0: 63 6f 6d 70 69 6c 65 72 2e 3c 2f 70 3e 0a 0a 3c  compiler.</p>..<
a000: 70 3e 41 6c 6c 20 6f 66 20 74 68 65 20 53 51 4c  p>All of the SQL
a010: 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f  ITE_OMIT_* optio
a020: 6e 73 20 61 72 65 20 75 6e 73 75 70 70 6f 72 74  ns are unsupport
a030: 65 64 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71  ed.</p>..<blockq
a040: 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e 49 6d 70 6f  uote>.<i><b>Impo
a050: 72 74 61 6e 74 20 4e 6f 74 65 3a 3c 2f 62 3e 0a  rtant Note:</b>.
a060: 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  The SQLITE_OMIT_
a070: 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  * compile-time o
a080: 70 74 69 6f 6e 73 20 61 72 65 20 75 6e 73 75 70  ptions are unsup
a090: 70 6f 72 74 65 64 2e 0a 3c 2f 69 3e 3c 2f 62 6c  ported..</i></bl
a0a0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54  ockquote>..<p>.T
a0b0: 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a  he SQLITE_OMIT_*
a0c0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
a0d0: 74 69 6f 6e 73 20 61 72 65 20 75 73 75 61 6c 6c  tions are usuall
a0e0: 79 20 75 6e 74 65 73 74 65 64 20 61 6e 64 0a 61  y untested and.a
a0f0: 72 65 20 61 6c 6d 6f 73 74 20 63 65 72 74 61 69  re almost certai
a100: 6e 6c 79 20 75 6e 74 65 73 74 65 64 20 69 6e 20  nly untested in 
a110: 63 6f 6d 62 69 6e 61 74 69 6f 6e 2e 0a 41 6e 79  combination..Any
a120: 20 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 73 65   or all of these
a130: 20 6f 70 74 69 6f 6e 73 20 6d 61 79 20 62 65 20   options may be 
a140: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65  removed from the
a150: 20 63 6f 64 65 20 69 6e 20 66 75 74 75 72 65 20   code in future 
a160: 72 65 6c 65 61 73 65 73 0a 61 6e 64 20 77 69 74  releases.and wit
a170: 68 6f 75 74 20 77 61 72 6e 69 6e 67 2e 20 20 46  hout warning.  F
a180: 6f 72 20 61 6e 79 20 70 61 72 74 69 63 75 6c 61  or any particula
a190: 72 20 72 65 6c 65 61 73 65 2c 20 73 6f 6d 65 20  r release, some 
a1a0: 6f 66 20 74 68 65 73 65 0a 6f 70 74 69 6f 6e 73  of these.options
a1b0: 20 6d 61 79 20 63 61 75 73 65 20 63 6f 6d 70 69   may cause compi
a1c0: 6c 65 2d 74 69 6d 65 20 6f 72 20 72 75 6e 2d 74  le-time or run-t
a1d0: 69 6d 65 20 66 61 69 6c 75 72 65 73 2c 20 70 61  ime failures, pa
a1e0: 72 74 69 63 75 6c 61 72 6c 79 0a 77 68 65 6e 20  rticularly.when 
a1f0: 75 73 65 64 20 69 6e 20 63 6f 6d 62 69 6e 61 74  used in combinat
a200: 69 6f 6e 20 77 69 74 68 20 6f 74 68 65 72 20 6f  ion with other o
a210: 70 74 69 6f 6e 73 2e 3c 2f 70 3e 0a 0a 3c 74 63  ptions.</p>..<tc
a220: 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  l>.COMPILE_OPTIO
a230: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
a240: 4c 54 45 52 54 41 42 4c 45 7d 20 7b 0a 20 20 57  LTERTABLE} {.  W
a250: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
a260: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
a270: 0a 20 20 5b 41 4c 54 45 52 20 54 41 42 4c 45 5d  .  [ALTER TABLE]
a280: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20   command is not 
a290: 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20  included in the 
a2a0: 0a 20 20 6c 69 62 72 61 72 79 2e 20 45 78 65 63  .  library. Exec
a2b0: 75 74 69 6e 67 20 61 6e 20 5b 41 4c 54 45 52 20  uting an [ALTER 
a2c0: 54 41 42 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74  TABLE] statement
a2d0: 20 63 61 75 73 65 73 20 61 20 70 61 72 73 65 20   causes a parse 
a2e0: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
a2f0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a300: 5f 4f 4d 49 54 5f 41 4e 41 4c 59 5a 45 7d 20 7b  _OMIT_ANALYZE} {
a310: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
a320: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
a330: 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f  the [ANALYZE] co
a340: 6d 6d 61 6e 64 20 69 73 20 6f 6d 69 74 74 65 64  mmand is omitted
a350: 20 66 72 6f 6d 0a 20 20 74 68 65 20 62 75 69 6c   from.  the buil
a360: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
a370: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
a380: 54 5f 41 54 54 41 43 48 7d 20 7b 0a 20 20 57 68  T_ATTACH} {.  Wh
a390: 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  en this option i
a3a0: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b  s defined, the [
a3b0: 41 54 54 41 43 48 5d 20 61 6e 64 20 5b 44 45 54  ATTACH] and [DET
a3c0: 41 43 48 5d 20 63 6f 6d 6d 61 6e 64 73 20 61 72  ACH] commands ar
a3d0: 65 0a 20 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d  e.  omitted from
a3e0: 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43   the build..}..C
a3f0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
a400: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f  QLITE_OMIT_AUTHO
a410: 52 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 44 65  RIZATION} {.  De
a420: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
a430: 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 61 75 74  on omits the aut
a440: 68 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62  horization callb
a450: 61 63 6b 20 66 65 61 74 75 72 65 20 66 72 6f 6d  ack feature from
a460: 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20   the.  library. 
a470: 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 65 74  The [sqlite3_set
a480: 5f 61 75 74 68 6f 72 69 7a 65 72 28 29 5d 20 41  _authorizer()] A
a490: 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e  PI function is n
a4a0: 6f 74 20 70 72 65 73 65 6e 74 0a 20 20 69 6e 20  ot present.  in 
a4b0: 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a  the library..}..
a4c0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
a4d0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
a4e0: 49 4e 43 52 45 4d 45 4e 54 7d 20 7b 0a 20 20 54  INCREMENT} {.  T
a4f0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
a500: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a  ed to omit the .
a510: 20 20 5b 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54    [AUTOINCREMENT
a520: 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e  ] functionality.
a530: 20 57 68 65 6e 20 74 68 69 73 20 0a 20 20 69 73   When this .  is
a540: 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65   macro is define
a550: 64 2c 20 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61  d, columns decla
a560: 72 65 64 20 61 73 20 0a 20 20 22 5b 49 4e 54 45  red as .  "[INTE
a570: 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 5d  GER PRIMARY KEY]
a580: 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 22 0a   AUTOINCREMENT".
a590: 20 20 62 65 68 61 76 65 20 69 6e 20 74 68 65 20    behave in the 
a5a0: 73 61 6d 65 20 77 61 79 20 61 73 20 63 6f 6c 75  same way as colu
a5b0: 6d 6e 73 20 64 65 63 6c 61 72 65 64 20 61 73 20  mns declared as 
a5c0: 22 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52  "[INTEGER PRIMAR
a5d0: 59 20 4b 45 59 5d 22 20 77 68 65 6e 20 61 20 0a  Y KEY]" when a .
a5e0: 20 20 4e 55 4c 4c 20 69 73 20 69 6e 73 65 72 74    NULL is insert
a5f0: 65 64 2e 20 54 68 65 20 73 71 6c 69 74 65 5f 73  ed. The sqlite_s
a600: 65 71 75 65 6e 63 65 20 73 79 73 74 65 6d 20 74  equence system t
a610: 61 62 6c 65 20 69 73 20 6e 65 69 74 68 65 72 20  able is neither 
a620: 63 72 65 61 74 65 64 2c 20 6e 6f 72 0a 20 20 72  created, nor.  r
a630: 65 73 70 65 63 74 65 64 20 69 66 20 69 74 20 61  espected if it a
a640: 6c 72 65 61 64 79 20 65 78 69 73 74 73 2e 0a 7d  lready exists..}
a650: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
a660: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55   {SQLITE_OMIT_AU
a670: 54 4f 49 4e 49 54 7d 20 7b 0a 20 20 46 6f 72 20  TOINIT} {.  For 
a680: 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74  backwards compat
a690: 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c 64  ibility with old
a6a0: 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53  er versions of S
a6b0: 51 4c 69 74 65 20 74 68 61 74 20 6c 61 63 6b 0a  QLite that lack.
a6c0: 20 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 69    the [sqlite3_i
a6d0: 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 69 6e 74  nitialize()] int
a6e0: 65 72 66 61 63 65 2c 20 74 68 65 20 5b 73 71 6c  erface, the [sql
a6f0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
a700: 29 5d 20 69 6e 74 65 72 66 61 63 65 0a 20 20 69  )] interface.  i
a710: 73 20 63 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74  s called automat
a720: 69 63 61 6c 6c 79 20 75 70 6f 6e 20 65 6e 74 72  ically upon entr
a730: 79 20 74 6f 20 63 65 72 74 61 69 6e 20 6b 65 79  y to certain key
a740: 20 69 6e 74 65 72 66 61 63 65 73 20 73 75 63 68   interfaces such
a750: 20 61 73 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f   as.  [sqlite3_o
a760: 70 65 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33  pen()], [sqlite3
a770: 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 5d  _vfs_register()]
a780: 2c 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6d  , and [sqlite3_m
a790: 70 72 69 6e 74 66 28 29 5d 2e 0a 20 20 54 68 65  printf()]..  The
a7a0: 20 6f 76 65 72 68 65 61 64 20 6f 66 20 69 6e 76   overhead of inv
a7b0: 6f 6b 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 69  oking [sqlite3_i
a7c0: 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 61 75 74  nitialize()] aut
a7d0: 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 74 68  omatically in th
a7e0: 69 73 0a 20 20 77 61 79 20 6d 61 79 20 62 65 20  is.  way may be 
a7f0: 6f 6d 69 74 74 65 64 20 62 79 20 62 75 69 6c 64  omitted by build
a800: 69 6e 67 20 53 51 4c 69 74 65 20 77 69 74 68 20  ing SQLite with 
a810: 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  the SQLITE_OMIT_
a820: 41 55 54 4f 49 4e 49 54 0a 20 20 43 2d 70 72 65  AUTOINIT.  C-pre
a830: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e  processor macro.
a840: 20 20 57 68 65 6e 20 62 75 69 6c 74 20 75 73 69    When built usi
a850: 6e 67 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ng SQLITE_OMIT_A
a860: 55 54 4f 49 4e 49 54 2c 20 53 51 4c 69 74 65 0a  UTOINIT, SQLite.
a870: 20 20 77 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 6d    will not autom
a880: 61 74 69 63 61 6c 6c 79 20 69 6e 69 74 69 61 6c  atically initial
a890: 69 7a 65 20 69 74 73 65 6c 66 20 61 6e 64 20 74  ize itself and t
a8a0: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69  he application i
a8b0: 73 20 72 65 71 75 69 72 65 64 0a 20 20 74 6f 20  s required.  to 
a8c0: 69 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f  invoke [sqlite3_
a8d0: 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 64 69  initialize()] di
a8e0: 72 65 63 74 6c 79 20 70 72 69 6f 72 20 74 6f 20  rectly prior to 
a8f0: 62 65 67 69 6e 6e 69 6e 67 20 75 73 65 20 6f 66  beginning use of
a900: 20 74 68 65 0a 20 20 53 51 4c 69 74 65 20 6c 69   the.  SQLite li
a910: 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  brary..}..COMPIL
a920: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a930: 5f 4f 4d 49 54 5f 41 55 54 4f 4d 41 54 49 43 5f  _OMIT_AUTOMATIC_
a940: 49 4e 44 45 58 7d 20 7b 0a 20 20 54 68 69 73 20  INDEX} {.  This 
a950: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74  option is used t
a960: 6f 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b 61  o omit the .  [a
a970: 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 69 6e  utomatic indexin
a980: 67 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  g] functionality
a990: 2e 0a 20 20 53 65 65 20 61 6c 73 6f 3a 20 5b 53  ..  See also: [S
a9a0: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55  QLITE_DEFAULT_AU
a9b0: 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 5d 2e 0a  TOMATIC_INDEX]..
a9c0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
a9d0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
a9e0: 55 54 4f 52 45 53 45 54 7d 20 7b 0a 20 20 42 79  UTORESET} {.  By
a9f0: 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20 5b 73   default, the [s
aa00: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 5d 20 69  qlite3_step()] i
aa10: 6e 74 65 72 66 61 63 65 20 77 69 6c 6c 20 61 75  nterface will au
aa20: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f  tomatically invo
aa30: 6b 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 72 65  ke.  [sqlite3_re
aa40: 73 65 74 28 29 5d 20 74 6f 20 72 65 73 65 74 20  set()] to reset 
aa50: 74 68 65 20 5b 70 72 65 70 61 72 65 64 20 73 74  the [prepared st
aa60: 61 74 65 6d 65 6e 74 5d 20 69 66 20 6e 65 63 65  atement] if nece
aa70: 73 73 61 72 79 2e 20 20 54 68 69 73 0a 20 20 63  ssary.  This.  c
aa80: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
aa90: 6f 6e 20 63 68 61 6e 67 65 73 20 74 68 61 74 20  on changes that 
aaa0: 62 65 68 61 76 69 6f 72 20 73 6f 20 74 68 61 74  behavior so that
aab0: 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29   [sqlite3_step()
aac0: 5d 20 77 69 6c 6c 0a 20 20 72 65 74 75 72 6e 20  ] will.  return 
aad0: 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d 20  [SQLITE_MISUSE] 
aae0: 69 66 20 69 74 20 63 61 6c 6c 65 64 20 61 67 61  if it called aga
aaf0: 69 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e 69  in after returni
ab00: 6e 67 20 61 6e 79 74 68 69 6e 67 20 6f 74 68 65  ng anything othe
ab10: 72 0a 20 20 74 68 61 6e 20 5b 53 51 4c 49 54 45  r.  than [SQLITE
ab20: 5f 52 4f 57 5d 2c 20 5b 53 51 4c 49 54 45 5f 42  _ROW], [SQLITE_B
ab30: 55 53 59 5d 2c 20 6f 72 20 5b 53 51 4c 49 54 45  USY], or [SQLITE
ab40: 5f 4c 4f 43 4b 45 44 5d 20 75 6e 6c 65 73 73 20  _LOCKED] unless 
ab50: 74 68 65 72 65 20 77 61 73 20 61 6e 0a 20 20 69  there was an.  i
ab60: 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c 20  ntervening call 
ab70: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 65  to [sqlite3_rese
ab80: 74 28 29 5d 2e 0a 0a 20 20 49 6e 20 53 51 4c 69  t()]...  In SQLi
ab90: 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e 32  te version 3.6.2
aba0: 33 2e 31 20 61 6e 64 20 65 61 72 6c 69 65 72 2c  3.1 and earlier,
abb0: 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29   [sqlite3_step()
abc0: 5d 20 75 73 65 64 20 74 6f 20 61 6c 77 61 79 73  ] used to always
abd0: 0a 20 20 72 65 74 75 72 6e 20 5b 53 51 4c 49 54  .  return [SQLIT
abe0: 45 5f 4d 49 53 55 53 45 5d 20 69 66 20 69 74 20  E_MISUSE] if it 
abf0: 77 61 73 20 69 6e 76 6f 6b 65 64 20 61 67 61 69  was invoked agai
ac00: 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e 69 6e  n after returnin
ac10: 67 20 61 6e 79 74 68 69 6e 67 0a 20 20 6f 74 68  g anything.  oth
ac20: 65 72 20 74 68 61 6e 20 5b 53 51 4c 49 54 45 5f  er than [SQLITE_
ac30: 52 4f 57 5d 20 77 69 74 68 6f 75 74 20 61 6e 20  ROW] without an 
ac40: 69 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c  intervening call
ac50: 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65 73   to [sqlite3_res
ac60: 65 74 28 29 5d 2e 0a 20 20 54 68 69 73 20 63 61  et()]..  This ca
ac70: 75 73 65 64 20 70 72 6f 62 6c 65 6d 73 20 6f 6e  used problems on
ac80: 20 73 6f 6d 65 20 70 6f 6f 72 6c 79 20 77 72 69   some poorly wri
ac90: 74 74 65 6e 20 73 6d 61 72 74 70 68 6f 6e 65 20  tten smartphone 
aca0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 77 68 69  applications whi
acb0: 63 68 0a 20 20 64 69 64 20 6e 6f 74 20 63 6f 72  ch.  did not cor
acc0: 72 65 63 74 6c 79 20 68 61 6e 64 6c 65 20 74 68  rectly handle th
acd0: 65 20 5b 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  e [SQLITE_LOCKED
ace0: 5d 20 61 6e 64 20 5b 53 51 4c 49 54 45 5f 42 55  ] and [SQLITE_BU
acf0: 53 59 5d 20 65 72 72 6f 72 20 0a 20 20 72 65 74  SY] error .  ret
ad00: 75 72 6e 73 2e 20 20 52 61 74 68 65 72 20 74 68  urns.  Rather th
ad10: 61 6e 20 66 69 78 20 74 68 65 20 6d 61 6e 79 20  an fix the many 
ad20: 64 65 66 65 63 74 69 76 65 20 73 6d 61 72 74 70  defective smartp
ad30: 68 6f 6e 65 20 61 70 70 6c 69 63 61 74 69 6f 6e  hone application
ad40: 73 2c 20 0a 20 20 74 68 65 20 62 65 68 61 76 69  s, .  the behavi
ad50: 6f 72 20 6f 66 20 53 51 4c 69 74 65 20 77 61 73  or of SQLite was
ad60: 20 63 68 61 6e 67 65 64 20 69 6e 20 33 2e 36 2e   changed in 3.6.
ad70: 32 33 2e 32 20 74 6f 20 61 75 74 6f 6d 61 74 69  23.2 to automati
ad80: 63 61 6c 6c 79 20 72 65 73 65 74 0a 20 20 74 68  cally reset.  th
ad90: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  e prepared state
ada0: 6d 65 6e 74 2e 20 20 42 75 74 20 74 68 61 74 20  ment.  But that 
adb0: 63 68 61 6e 67 65 64 20 63 61 75 73 65 64 20 69  changed caused i
adc0: 73 73 75 65 73 20 69 6e 20 6f 74 68 65 72 20 0a  ssues in other .
add0: 20 20 69 6d 70 72 6f 70 65 72 6c 79 20 69 6d 70    improperly imp
ade0: 6c 65 6d 65 6e 74 65 64 20 61 70 70 6c 69 63 61  lemented applica
adf0: 74 69 6f 6e 73 20 74 68 61 74 20 77 65 72 65 20  tions that were 
ae00: 61 63 74 75 61 6c 6c 79 20 6c 6f 6f 6b 69 6e 67  actually looking
ae10: 0a 20 20 66 6f 72 20 61 6e 20 5b 53 51 4c 49 54  .  for an [SQLIT
ae20: 45 5f 4d 49 53 55 53 45 5d 20 72 65 74 75 72 6e  E_MISUSE] return
ae30: 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 20 74 68   to terminate th
ae40: 65 69 72 20 71 75 65 72 79 20 6c 6f 6f 70 73 2e  eir query loops.
ae50: 20 20 28 41 6e 79 74 69 6d 65 0a 20 20 61 6e 20    (Anytime.  an 
ae60: 61 70 70 6c 69 63 61 74 69 6f 6e 20 67 65 74 73  application gets
ae70: 20 61 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53   an SQLITE_MISUS
ae80: 45 20 65 72 72 6f 72 20 63 6f 64 65 20 66 72 6f  E error code fro
ae90: 6d 20 53 51 4c 69 74 65 2c 20 74 68 61 74 20 6d  m SQLite, that m
aea0: 65 61 6e 73 20 74 68 65 0a 20 20 61 70 70 6c 69  eans the.  appli
aeb0: 63 61 74 69 6f 6e 20 69 73 20 6d 69 73 75 73 69  cation is misusi
aec0: 6e 67 20 74 68 65 20 53 51 4c 69 74 65 20 69 6e  ng the SQLite in
aed0: 74 65 72 66 61 63 65 20 61 6e 64 20 69 73 20 74  terface and is t
aee0: 68 75 73 20 69 6e 63 6f 72 72 65 63 74 6c 79 0a  hus incorrectly.
aef0: 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2e 29 20    implemented.) 
af00: 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54   The SQLITE_OMIT
af10: 5f 41 55 54 4f 52 45 53 45 54 20 69 6e 74 65 72  _AUTORESET inter
af20: 66 61 63 65 20 77 61 73 20 61 64 64 65 64 20 74  face was added t
af30: 6f 20 53 51 4c 69 74 65 0a 20 20 76 65 72 73 69  o SQLite.  versi
af40: 6f 6e 20 33 2e 37 2e 35 20 69 6e 20 61 6e 20 65  on 3.7.5 in an e
af50: 66 66 6f 72 74 20 74 6f 20 67 65 74 20 61 6c 6c  ffort to get all
af60: 20 6f 66 20 74 68 65 20 28 62 72 6f 6b 65 6e 29   of the (broken)
af70: 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  .  applications 
af80: 74 6f 20 77 6f 72 6b 20 61 67 61 69 6e 20 77 69  to work again wi
af90: 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20  thout having to 
afa0: 61 63 74 75 61 6c 6c 79 20 66 69 78 20 74 68 65  actually fix the
afb0: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d   applications..}
afc0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
afd0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55   {SQLITE_OMIT_AU
afe0: 54 4f 56 41 43 55 55 4d 7d 20 7b 0a 20 20 49 66  TOVACUUM} {.  If
aff0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
b000: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69 62  defined, the lib
b010: 72 61 72 79 20 63 61 6e 6e 6f 74 20 63 72 65 61  rary cannot crea
b020: 74 65 20 6f 72 20 77 72 69 74 65 20 74 6f 20 0a  te or write to .
b030: 20 20 64 61 74 61 62 61 73 65 73 20 74 68 61 74    databases that
b040: 20 73 75 70 70 6f 72 74 20 5b 61 75 74 6f 5f 76   support [auto_v
b050: 61 63 75 75 6d 5d 2e 0a 20 20 45 78 65 63 75 74  acuum]..  Execut
b060: 69 6e 67 20 61 20 5b 50 52 41 47 4d 41 20 61 75  ing a [PRAGMA au
b070: 74 6f 5f 76 61 63 75 75 6d 5d 20 73 74 61 74 65  to_vacuum] state
b080: 6d 65 6e 74 20 69 73 20 6e 6f 74 20 61 6e 20 65  ment is not an e
b090: 72 72 6f 72 0a 20 20 28 73 69 6e 63 65 20 75 6e  rror.  (since un
b0a0: 6b 6e 6f 77 6e 20 50 52 41 47 4d 41 73 20 61 72  known PRAGMAs ar
b0b0: 65 20 73 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72  e silently ignor
b0c0: 65 64 29 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f  ed), but does no
b0d0: 74 20 72 65 74 75 72 6e 20 61 20 76 61 6c 75 65  t return a value
b0e0: 0a 20 20 6f 72 20 6d 6f 64 69 66 79 20 74 68 65  .  or modify the
b0f0: 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 66 6c 61   auto-vacuum fla
b100: 67 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  g in the databas
b110: 65 20 66 69 6c 65 2e 20 49 66 20 61 20 64 61 74  e file. If a dat
b120: 61 62 61 73 65 20 74 68 61 74 0a 20 20 73 75 70  abase that.  sup
b130: 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 75 75  ports auto-vacuu
b140: 6d 20 69 73 20 6f 70 65 6e 65 64 20 62 79 20 61  m is opened by a
b150: 20 6c 69 62 72 61 72 79 20 63 6f 6d 70 69 6c 65   library compile
b160: 64 20 77 69 74 68 20 74 68 69 73 20 6f 70 74 69  d with this opti
b170: 6f 6e 2c 20 69 74 0a 20 20 69 73 20 61 75 74 6f  on, it.  is auto
b180: 6d 61 74 69 63 61 6c 6c 79 20 6f 70 65 6e 65 64  matically opened
b190: 20 69 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 6f   in read-only mo
b1a0: 64 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  de..}..COMPILE_O
b1b0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
b1c0: 49 54 5f 42 45 54 57 45 45 4e 5f 4f 50 54 49 4d  IT_BETWEEN_OPTIM
b1d0: 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69  IZATION} {.  Thi
b1e0: 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65  s option disable
b1f0: 73 20 74 68 65 20 75 73 65 20 6f 66 20 69 6e 64  s the use of ind
b200: 69 63 65 73 20 77 69 74 68 20 57 48 45 52 45 20  ices with WHERE 
b210: 63 6c 61 75 73 65 20 74 65 72 6d 73 0a 20 20 74  clause terms.  t
b220: 68 61 74 20 65 6d 70 6c 6f 79 20 74 68 65 20 42  hat employ the B
b230: 45 54 57 45 45 4e 20 6f 70 65 72 61 74 6f 72 2e  ETWEEN operator.
b240: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b250: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b260: 42 4c 4f 42 5f 4c 49 54 45 52 41 4c 7d 20 7b 0a  BLOB_LITERAL} {.
b270: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
b280: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 69  on is defined, i
b290: 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c  t is not possibl
b2a0: 65 20 74 6f 20 73 70 65 63 69 66 79 20 61 20 62  e to specify a b
b2b0: 6c 6f 62 20 69 6e 0a 20 20 61 6e 20 53 51 4c 20  lob in.  an SQL 
b2c0: 73 74 61 74 65 6d 65 6e 74 20 75 73 69 6e 67 20  statement using 
b2d0: 74 68 65 20 58 27 41 42 43 44 27 20 73 79 6e 74  the X'ABCD' synt
b2e0: 61 78 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ax..}..COMPILE_O
b2f0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
b300: 49 54 5f 42 54 52 45 45 43 4f 55 4e 54 7d 20 7b  IT_BTREECOUNT} {
b310: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
b320: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
b330: 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  an optimization 
b340: 74 68 61 74 20 61 63 63 65 6c 65 72 61 74 65 73  that accelerates
b350: 20 63 6f 75 6e 74 69 6e 67 0a 20 20 61 6c 6c 20   counting.  all 
b360: 65 6e 74 72 69 65 73 20 69 6e 20 61 20 74 61 62  entries in a tab
b370: 6c 65 20 28 69 6e 20 6f 74 68 65 72 20 77 6f 72  le (in other wor
b380: 64 73 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74  ds, an optimizat
b390: 69 6f 6e 20 74 68 61 74 20 68 65 6c 70 73 0a 20  ion that helps. 
b3a0: 20 22 53 45 4c 45 43 54 20 63 6f 75 6e 74 28 2a   "SELECT count(*
b3b0: 29 20 46 52 4f 4d 20 74 61 62 6c 65 22 20 72 75  ) FROM table" ru
b3c0: 6e 20 66 61 73 74 65 72 29 20 69 73 20 6f 6d 69  n faster) is omi
b3d0: 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tted..}..COMPILE
b3e0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
b3f0: 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53  OMIT_BUILTIN_TES
b400: 54 7d 20 7b 0a 20 20 41 20 73 74 61 6e 64 61 72  T} {.  A standar
b410: 64 20 53 51 4c 69 74 65 20 62 75 69 6c 64 20 69  d SQLite build i
b420: 6e 63 6c 75 64 65 73 20 61 20 73 6d 61 6c 6c 20  ncludes a small 
b430: 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67 69 63 20  amount of logic 
b440: 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20 62 79 20  controlled.  by 
b450: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 65 73  the [sqlite3_tes
b460: 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d 20 69 6e 74  t_control()] int
b470: 65 72 66 61 63 65 20 74 68 61 74 20 69 73 20 75  erface that is u
b480: 73 65 64 20 74 6f 20 65 78 65 72 63 69 73 65 0a  sed to exercise.
b490: 20 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 53    parts of the S
b4a0: 51 4c 69 74 65 20 63 6f 72 65 20 74 68 61 74 20  QLite core that 
b4b0: 61 72 65 20 64 69 66 66 69 63 75 6c 74 20 74 6f  are difficult to
b4c0: 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20 6d 65 61   control and mea
b4d0: 73 75 72 65 20 75 73 69 6e 67 0a 20 20 74 68 65  sure using.  the
b4e0: 20 73 74 61 6e 64 61 72 64 20 41 50 49 2e 20 20   standard API.  
b4f0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
b500: 73 20 74 68 61 74 20 62 75 69 6c 74 2d 69 6e 20  s that built-in 
b510: 74 65 73 74 20 6c 6f 67 69 63 2e 0a 7d 0a 0a 43  test logic..}..C
b520: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
b530: 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 41 53 54 7d  QLITE_OMIT_CAST}
b540: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
b550: 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20 74   causes SQLite t
b560: 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66  o omit support f
b570: 6f 72 20 74 68 65 20 43 41 53 54 20 6f 70 65 72  or the CAST oper
b580: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
b590: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
b5a0: 4f 4d 49 54 5f 43 48 45 43 4b 7d 20 7b 0a 20 20  OMIT_CHECK} {.  
b5b0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
b5c0: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69  es SQLite to omi
b5d0: 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 43 48  t support for CH
b5e0: 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e  ECK constraints.
b5f0: 0a 20 20 54 68 65 20 70 61 72 73 65 72 20 77 69  .  The parser wi
b600: 6c 6c 20 73 74 69 6c 6c 20 61 63 63 65 70 74 20  ll still accept 
b610: 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74  CHECK constraint
b620: 73 20 69 6e 20 53 51 4c 20 73 74 61 74 65 6d 65  s in SQL stateme
b630: 6e 74 73 2c 0a 20 20 74 68 65 79 20 77 69 6c 6c  nts,.  they will
b640: 20 6a 75 73 74 20 6e 6f 74 20 62 65 20 65 6e 66   just not be enf
b650: 6f 72 63 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  orced..}..COMPIL
b660: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
b670: 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 54  _OMIT_COMPILEOPT
b680: 49 4f 4e 5f 44 49 41 47 53 7d 20 7b 0a 20 20 54  ION_DIAGS} {.  T
b690: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
b6a0: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63  ed to omit the c
b6b0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
b6c0: 6f 6e 20 64 69 61 67 6e 6f 73 74 69 63 73 20 61  on diagnostics a
b6d0: 76 61 69 6c 61 62 6c 65 0a 20 20 69 6e 20 53 51  vailable.  in SQ
b6e0: 4c 69 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20  Lite, including 
b6f0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d  the [sqlite3_com
b700: 70 69 6c 65 6f 70 74 69 6f 6e 5f 75 73 65 64 28  pileoption_used(
b710: 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65  )] and.  [sqlite
b720: 33 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f  3_compileoption_
b730: 67 65 74 28 29 5d 20 43 2f 43 2b 2b 20 66 75 6e  get()] C/C++ fun
b740: 63 74 69 6f 6e 73 2c 20 74 68 65 0a 20 20 5b 73  ctions, the.  [s
b750: 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f 70 74  qlite_compileopt
b760: 69 6f 6e 5f 75 73 65 64 28 29 5d 20 61 6e 64 20  ion_used()] and 
b770: 5b 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f  [sqlite_compileo
b780: 70 74 69 6f 6e 5f 67 65 74 28 29 5d 20 53 51 4c  ption_get()] SQL
b790: 20 66 75 6e 63 74 69 6f 6e 73 2c 0a 20 20 61 6e   functions,.  an
b7a0: 64 20 74 68 65 20 5b 63 6f 6d 70 69 6c 65 5f 6f  d the [compile_o
b7b0: 70 74 69 6f 6e 73 20 70 72 61 67 6d 61 5d 2e 0a  ptions pragma]..
b7c0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
b7d0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
b7e0: 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69  OMPLETE} {.  Thi
b7f0: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
b800: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d  the [sqlite3_com
b810: 70 6c 65 74 65 28 29 5d 20 61 6e 64 20 5b 73 71  plete()] and [sq
b820: 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31 36  lite3_complete16
b830: 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 65 73  ()].  interfaces
b840: 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a   to be omitted..
b850: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
b860: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
b870: 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 7d 20  OMPOUND_SELECT} 
b880: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
b890: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20  is used to omit 
b8a0: 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 5b 53 45  the compound [SE
b8b0: 4c 45 43 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c  LECT] functional
b8c0: 69 74 79 2e 20 0a 20 20 5b 53 45 4c 45 43 54 5d  ity. .  [SELECT]
b8d0: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
b8e0: 20 75 73 65 20 74 68 65 20 0a 20 20 55 4e 49 4f   use the .  UNIO
b8f0: 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20 49 4e  N, UNION ALL, IN
b900: 54 45 52 53 45 43 54 20 6f 72 20 45 58 43 45 50  TERSECT or EXCEP
b910: 54 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43  T compound SELEC
b920: 54 20 6f 70 65 72 61 74 6f 72 73 20 77 69 6c 6c  T operators will
b930: 20 0a 20 20 63 61 75 73 65 20 61 20 70 61 72 73   .  cause a pars
b940: 65 20 65 72 72 6f 72 2e 0a 0a 20 20 41 6e 20 5b  e error...  An [
b950: 49 4e 53 45 52 54 5d 20 73 74 61 74 65 6d 65 6e  INSERT] statemen
b960: 74 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 20  t with multiple 
b970: 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 56 41  values in the VA
b980: 4c 55 45 53 20 63 6c 61 75 73 65 20 69 73 0a 20  LUES clause is. 
b990: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 74   implemented int
b9a0: 65 72 6e 61 6c 6c 79 20 61 73 20 61 20 63 6f 6d  ernally as a com
b9b0: 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e 20 20 48  pound SELECT.  H
b9c0: 65 6e 63 65 2c 20 74 68 69 73 20 6f 70 74 69 6f  ence, this optio
b9d0: 6e 20 61 6c 73 6f 0a 20 20 64 69 73 61 62 6c 65  n also.  disable
b9e0: 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f  s the ability to
b9f0: 20 69 6e 73 65 72 74 20 6d 6f 72 65 20 74 68 61   insert more tha
ba00: 6e 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 75  n a single row u
ba10: 73 69 6e 67 20 61 6e 0a 20 20 49 4e 53 45 52 54  sing an.  INSERT
ba20: 20 49 4e 54 4f 20 2e 2e 2e 20 56 41 4c 55 45 53   INTO ... VALUES
ba30: 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2e 0a   ... statement..
ba40: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
ba50: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
ba60: 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  TE} {.  This opt
ba70: 69 6f 6e 20 63 61 75 73 65 73 20 73 75 70 70 6f  ion causes suppo
ba80: 72 74 20 66 6f 72 20 5b 63 6f 6d 6d 6f 6e 20 74  rt for [common t
ba90: 61 62 6c 65 20 65 78 70 72 65 73 73 69 6f 6e 73  able expressions
baa0: 5d 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e  ] to be omitted.
bab0: 0a 7d 0a 0a 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  .}....COMPILE_OP
bac0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
bad0: 54 5f 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53  T_DATETIME_FUNCS
bae0: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70  } {.  If this op
baf0: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
bb00: 20 53 51 4c 69 74 65 27 73 20 62 75 69 6c 74 2d   SQLite's built-
bb10: 69 6e 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65  in date and time
bb20: 20 6d 61 6e 69 70 75 6c 61 74 69 6f 6e 0a 20 20   manipulation.  
bb30: 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d  functions are om
bb40: 69 74 74 65 64 2e 20 53 70 65 63 69 66 69 63 61  itted. Specifica
bb50: 6c 6c 79 2c 20 74 68 65 20 53 51 4c 20 66 75 6e  lly, the SQL fun
bb60: 63 74 69 6f 6e 73 20 6a 75 6c 69 61 6e 64 61 79  ctions julianday
bb70: 28 29 2c 20 64 61 74 65 28 29 2c 0a 20 20 74 69  (), date(),.  ti
bb80: 6d 65 28 29 2c 20 64 61 74 65 74 69 6d 65 28 29  me(), datetime()
bb90: 20 61 6e 64 20 73 74 72 66 74 69 6d 65 28 29 20   and strftime() 
bba0: 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c  are not availabl
bbb0: 65 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 63  e. The default c
bbc0: 6f 6c 75 6d 6e 0a 20 20 76 61 6c 75 65 73 20 43  olumn.  values C
bbd0: 55 52 52 45 4e 54 5f 54 49 4d 45 2c 20 43 55 52  URRENT_TIME, CUR
bbe0: 52 45 4e 54 5f 44 41 54 45 20 61 6e 64 20 43 55  RENT_DATE and CU
bbf0: 52 52 45 4e 54 5f 54 49 4d 45 53 54 41 4d 50 20  RRENT_TIMESTAMP 
bc00: 61 72 65 20 73 74 69 6c 6c 20 61 76 61 69 6c 61  are still availa
bc10: 62 6c 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ble..}..COMPILE_
bc20: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
bc30: 4d 49 54 5f 44 45 43 4c 54 59 50 45 7d 20 7b 0a  MIT_DECLTYPE} {.
bc40: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
bc50: 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f  uses SQLite to o
bc60: 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20  mit support for 
bc70: 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63  the.  [sqlite3_c
bc80: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 29  olumn_decltype()
bc90: 5d 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 63  ] and [sqlite3_c
bca0: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36  olumn_decltype16
bcb0: 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 65 73  ()].  interfaces
bcc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
bcd0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
bce0: 5f 44 45 50 52 45 43 41 54 45 44 7d 20 7b 0a 20  _DEPRECATED} {. 
bcf0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
bd00: 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d  ses SQLite to om
bd10: 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 69  it support for i
bd20: 6e 74 65 72 66 61 63 65 73 0a 20 20 6d 61 72 6b  nterfaces.  mark
bd30: 65 64 20 61 73 20 64 65 70 72 65 63 61 74 65 64  ed as deprecated
bd40: 2e 20 20 54 68 69 73 20 69 6e 63 6c 75 64 65 73  .  This includes
bd50: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 61 67 67   .  [sqlite3_agg
bd60: 72 65 67 61 74 65 5f 63 6f 75 6e 74 28 29 5d 2c  regate_count()],
bd70: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 65 78 70 69  .  [sqlite3_expi
bd80: 72 65 64 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74  red()],.  [sqlit
bd90: 65 33 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64  e3_transfer_bind
bda0: 69 6e 67 73 28 29 5d 2c 0a 20 20 5b 73 71 6c 69  ings()],.  [sqli
bdb0: 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76  te3_global_recov
bdc0: 65 72 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65  er()],.  [sqlite
bdd0: 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 70  3_thread_cleanup
bde0: 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74  ()] and.  [sqlit
bdf0: 65 33 5f 6d 65 6d 6f 72 79 5f 61 6c 61 72 6d 28  e3_memory_alarm(
be00: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d  )] interfaces..}
be10: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
be20: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49   {SQLITE_OMIT_DI
be30: 53 4b 49 4f 7d 20 7b 0a 20 20 54 68 69 73 20 6f  SKIO} {.  This o
be40: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 61 6c 6c 20  ption omits all 
be50: 73 75 70 70 6f 72 74 20 66 6f 72 20 77 72 69 74  support for writ
be60: 69 6e 67 20 74 6f 20 74 68 65 20 64 69 73 6b 20  ing to the disk 
be70: 61 6e 64 20 66 6f 72 63 65 73 0a 20 20 64 61 74  and forces.  dat
be80: 61 62 61 73 65 73 20 74 6f 20 65 78 69 73 74 20  abases to exist 
be90: 69 6e 20 6d 65 6d 6f 72 79 20 6f 6e 6c 79 2e 20  in memory only. 
bea0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73   This option has
beb0: 20 6e 6f 74 20 62 65 65 6e 20 0a 20 20 6d 61 69   not been .  mai
bec0: 6e 74 61 69 6e 65 64 20 61 6e 64 20 70 72 6f 62  ntained and prob
bed0: 61 62 6c 79 20 64 6f 65 73 20 6e 6f 74 20 77 6f  ably does not wo
bee0: 72 6b 20 77 69 74 68 20 6e 65 77 65 72 20 76 65  rk with newer ve
bef0: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
bf00: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
bf10: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
bf20: 5f 45 58 50 4c 41 49 4e 7d 20 7b 0a 20 20 44 65  _EXPLAIN} {.  De
bf30: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
bf40: 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20 5b 45  on causes the [E
bf50: 58 50 4c 41 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20  XPLAIN] command 
bf60: 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72  to be omitted fr
bf70: 6f 6d 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79  om the.  library
bf80: 2e 20 41 74 74 65 6d 70 74 69 6e 67 20 74 6f 20  . Attempting to 
bf90: 65 78 65 63 75 74 65 20 61 6e 20 5b 45 58 50 4c  execute an [EXPL
bfa0: 41 49 4e 5d 20 73 74 61 74 65 6d 65 6e 74 20 77  AIN] statement w
bfb0: 69 6c 6c 20 63 61 75 73 65 20 61 20 70 61 72 73  ill cause a pars
bfc0: 65 0a 20 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  e.  error..}..CO
bfd0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
bfe0: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 41 47 5f 50  LITE_OMIT_FLAG_P
bff0: 52 41 47 4d 41 53 7d 20 7b 0a 20 20 54 68 69 73  RAGMAS} {.  This
c000: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75   option omits su
c010: 70 70 6f 72 74 20 66 6f 72 20 61 20 73 75 62 73  pport for a subs
c020: 65 74 20 6f 66 20 5b 50 52 41 47 4d 41 5d 20 63  et of [PRAGMA] c
c030: 6f 6d 6d 61 6e 64 73 20 74 68 61 74 0a 20 20 71  ommands that.  q
c040: 75 65 72 79 20 61 6e 64 20 73 65 74 20 62 6f 6f  uery and set boo
c050: 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 65 73 2e  lean properties.
c060: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
c070: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
c080: 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 7d 20  FLOATING_POINT} 
c090: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
c0a0: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20  is used to omit 
c0b0: 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 20 6e  floating-point n
c0c0: 75 6d 62 65 72 20 73 75 70 70 6f 72 74 20 66 72  umber support fr
c0d0: 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 0a 20 20  om the SQLite.  
c0e0: 6c 69 62 72 61 72 79 2e 20 57 68 65 6e 20 73 70  library. When sp
c0f0: 65 63 69 66 69 65 64 2c 20 73 70 65 63 69 66 79  ecified, specify
c100: 69 6e 67 20 61 20 66 6c 6f 61 74 69 6e 67 20 70  ing a floating p
c110: 6f 69 6e 74 20 6e 75 6d 62 65 72 20 61 73 20 61  oint number as a
c120: 20 6c 69 74 65 72 61 6c 20 0a 20 20 28 69 2e 65   literal .  (i.e
c130: 2e 20 22 31 2e 30 31 22 29 20 72 65 73 75 6c 74  . "1.01") result
c140: 73 20 69 6e 20 61 20 70 61 72 73 65 20 65 72 72  s in a parse err
c150: 6f 72 2e 0a 0a 20 20 3c 70 3e 49 6e 20 74 68 65  or...  <p>In the
c160: 20 66 75 74 75 72 65 2c 20 74 68 69 73 20 6f 70   future, this op
c170: 74 69 6f 6e 20 6d 61 79 20 61 6c 73 6f 20 64 69  tion may also di
c180: 73 61 62 6c 65 20 6f 74 68 65 72 20 66 6c 6f 61  sable other floa
c190: 74 69 6e 67 20 70 6f 69 6e 74 20 0a 20 20 66 75  ting point .  fu
c1a0: 6e 63 74 69 6f 6e 61 6c 69 74 79 2c 20 66 6f 72  nctionality, for
c1b0: 20 65 78 61 6d 70 6c 65 20 74 68 65 20 5b 73 71   example the [sq
c1c0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75  lite3_result_dou
c1d0: 62 6c 65 28 29 5d 2c 20 0a 20 20 5b 73 71 6c 69  ble()], .  [sqli
c1e0: 74 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28  te3_bind_double(
c1f0: 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 76 61 6c  )], [sqlite3_val
c200: 75 65 5f 64 6f 75 62 6c 65 28 29 5d 20 61 6e 64  ue_double()] and
c210: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  .  [sqlite3_colu
c220: 6d 6e 5f 64 6f 75 62 6c 65 28 29 5d 20 41 50 49  mn_double()] API
c230: 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 20 20 3c 2f   functions..  </
c240: 70 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  p>.}..COMPILE_OP
c250: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
c260: 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 7d 20 7b  T_FOREIGN_KEY} {
c270: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
c280: 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68  n is defined, th
c290: 65 6e 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20  en [foreign key 
c2a0: 63 6f 6e 73 74 72 61 69 6e 74 5d 20 73 79 6e 74  constraint] synt
c2b0: 61 78 20 69 73 0a 20 20 6e 6f 74 20 72 65 63 6f  ax is.  not reco
c2c0: 67 6e 69 7a 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  gnized..}..COMPI
c2d0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
c2e0: 45 5f 4f 4d 49 54 5f 47 45 54 5f 54 41 42 4c 45  E_OMIT_GET_TABLE
c2f0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
c300: 6e 20 63 61 75 73 65 73 20 73 75 70 70 6f 72 74  n causes support
c310: 20 66 6f 72 20 5b 73 71 6c 69 74 65 33 5f 67 65   for [sqlite3_ge
c320: 74 5f 74 61 62 6c 65 28 29 5d 20 61 6e 64 0a 20  t_table()] and. 
c330: 20 5b 73 71 6c 69 74 65 33 5f 66 72 65 65 5f 74   [sqlite3_free_t
c340: 61 62 6c 65 28 29 5d 20 74 6f 20 62 65 20 6f 6d  able()] to be om
c350: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
c360: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
c370: 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 7d 20  _OMIT_INCRBLOB} 
c380: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
c390: 63 61 75 73 65 73 20 73 75 70 70 6f 72 74 20 66  causes support f
c3a0: 6f 72 20 5b 73 71 6c 69 74 65 33 5f 62 6c 6f 62  or [sqlite3_blob
c3b0: 20 7c 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 42   | incremental B
c3c0: 4c 4f 42 20 49 2f 4f 5d 0a 20 20 74 6f 20 62 65  LOB I/O].  to be
c3d0: 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d   omitted..}..COM
c3e0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
c3f0: 49 54 45 5f 4f 4d 49 54 5f 49 4e 54 45 47 52 49  ITE_OMIT_INTEGRI
c400: 54 59 5f 43 48 45 43 4b 7d 20 7b 0a 20 20 54 68  TY_CHECK} {.  Th
c410: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
c420: 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20  support for the 
c430: 5b 69 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b  [integrity_check
c440: 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d   pragma]..}..COM
c450: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
c460: 49 54 45 5f 4f 4d 49 54 5f 4c 49 4b 45 5f 4f 50  ITE_OMIT_LIKE_OP
c470: 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20  TIMIZATION} {.  
c480: 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61  This option disa
c490: 62 6c 65 73 20 74 68 65 20 61 62 69 6c 69 74 79  bles the ability
c4a0: 20 6f 66 20 53 51 4c 69 74 65 20 74 6f 20 75 73   of SQLite to us
c4b0: 65 20 69 6e 64 69 63 65 73 20 74 6f 20 68 65 6c  e indices to hel
c4c0: 70 0a 20 20 72 65 73 6f 6c 76 65 20 5b 4c 49 4b  p.  resolve [LIK
c4d0: 45 5d 20 61 6e 64 20 5b 47 4c 4f 42 5d 20 6f 70  E] and [GLOB] op
c4e0: 65 72 61 74 6f 72 73 20 69 6e 20 61 20 57 48 45  erators in a WHE
c4f0: 52 45 20 63 6c 61 75 73 65 2e 0a 7d 0a 0a 43 4f  RE clause..}..CO
c500: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
c510: 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45  LITE_OMIT_LOAD_E
c520: 58 54 45 4e 53 49 4f 4e 7d 20 7b 0a 20 20 54 68  XTENSION} {.  Th
c530: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
c540: 74 68 65 20 65 6e 74 69 72 65 20 65 78 74 65 6e  the entire exten
c550: 73 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 6d 65 63  sion loading mec
c560: 68 61 6e 69 73 6d 20 66 72 6f 6d 0a 20 20 53 51  hanism from.  SQ
c570: 4c 69 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20  Lite, including 
c580: 5b 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f  [sqlite3_enable_
c590: 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 29  load_extension()
c5a0: 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33  ] and.  [sqlite3
c5b0: 5f 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28  _load_extension(
c5c0: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d  )] interfaces..}
c5d0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
c5e0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f   {SQLITE_OMIT_LO
c5f0: 43 41 4c 54 49 4d 45 7d 20 7b 0a 20 20 54 68 69  CALTIME} {.  Thi
c600: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74  s option omits t
c610: 68 65 20 22 6c 6f 63 61 6c 74 69 6d 65 22 20 6d  he "localtime" m
c620: 6f 64 69 66 69 65 72 20 66 72 6f 6d 20 74 68 65  odifier from the
c630: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 0a 20   date and time. 
c640: 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 69   functions.  Thi
c650: 73 20 6f 70 74 69 6f 6e 20 69 73 20 73 6f 6d 65  s option is some
c660: 74 69 6d 65 73 20 75 73 65 66 75 6c 20 77 68 65  times useful whe
c670: 6e 20 74 72 79 69 6e 67 20 74 6f 20 63 6f 6d 70  n trying to comp
c680: 69 6c 65 0a 20 20 74 68 65 20 64 61 74 65 20 61  ile.  the date a
c690: 6e 64 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e  nd time function
c6a0: 73 20 6f 6e 20 61 20 70 6c 61 74 66 6f 72 6d 20  s on a platform 
c6b0: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75  that does not su
c6c0: 70 70 6f 72 74 20 74 68 65 0a 20 20 63 6f 6e 63  pport the.  conc
c6d0: 65 70 74 20 6f 66 20 6c 6f 63 61 6c 20 74 69 6d  ept of local tim
c6e0: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
c6f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
c700: 54 5f 4c 4f 4f 4b 41 53 49 44 45 7d 20 7b 0a 20  T_LOOKASIDE} {. 
c710: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
c720: 74 73 20 74 68 65 20 5b 6c 6f 6f 6b 61 73 69 64  ts the [lookasid
c730: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  e memory allocat
c740: 6f 72 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  or]..}..COMPILE_
c750: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
c760: 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 7d 20 7b 0a  MIT_MEMORYDB} {.
c770: 20 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 64    When this is d
c780: 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72  efined, the libr
c790: 61 72 79 20 64 6f 65 73 20 6e 6f 74 20 72 65 73  ary does not res
c7a0: 70 65 63 74 20 74 68 65 20 73 70 65 63 69 61 6c  pect the special
c7b0: 20 64 61 74 61 62 61 73 65 0a 20 20 6e 61 6d 65   database.  name
c7c0: 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 28 6e 6f 72   ":memory:" (nor
c7d0: 6d 61 6c 6c 79 20 75 73 65 64 20 74 6f 20 63 72  mally used to cr
c7e0: 65 61 74 65 20 61 6e 20 5b 69 6e 2d 6d 65 6d 6f  eate an [in-memo
c7f0: 72 79 20 64 61 74 61 62 61 73 65 5d 29 2e 20 49  ry database]). I
c800: 66 20 0a 20 20 22 3a 6d 65 6d 6f 72 79 3a 22 20  f .  ":memory:" 
c810: 69 73 20 70 61 73 73 65 64 20 74 6f 20 5b 73 71  is passed to [sq
c820: 6c 69 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b  lite3_open()], [
c830: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29  sqlite3_open16()
c840: 5d 2c 20 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33  ], or.  [sqlite3
c850: 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c 20 61 20 66  _open_v2()], a f
c860: 69 6c 65 20 77 69 74 68 20 74 68 69 73 20 6e 61  ile with this na
c870: 6d 65 20 77 69 6c 6c 20 62 65 20 0a 20 20 6f 70  me will be .  op
c880: 65 6e 65 64 20 6f 72 20 63 72 65 61 74 65 64 2e  ened or created.
c890: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
c8a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
c8b0: 4f 52 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d  OR_OPTIMIZATION}
c8c0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
c8d0: 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 62   disables the ab
c8e0: 69 6c 69 74 79 20 6f 66 20 53 51 4c 69 74 65 20  ility of SQLite 
c8f0: 74 6f 20 75 73 65 20 61 6e 20 69 6e 64 65 78 20  to use an index 
c900: 74 6f 67 65 74 68 65 72 0a 20 20 77 69 74 68 20  together.  with 
c910: 74 65 72 6d 73 20 6f 66 20 61 20 57 48 45 52 45  terms of a WHERE
c920: 20 63 6c 61 75 73 65 20 63 6f 6e 6e 65 63 74 65   clause connecte
c930: 64 20 62 79 20 74 68 65 20 4f 52 20 6f 70 65 72  d by the OR oper
c940: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
c950: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
c960: 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d  OMIT_PAGER_PRAGM
c970: 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67  AS} {.  Defining
c980: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   this option omi
c990: 74 73 20 70 72 61 67 6d 61 73 20 72 65 6c 61 74  ts pragmas relat
c9a0: 65 64 20 74 6f 20 74 68 65 20 70 61 67 65 72 20  ed to the pager 
c9b0: 73 75 62 73 79 73 74 65 6d 20 66 72 6f 6d 20 0a  subsystem from .
c9c0: 20 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a    the build..}..
c9d0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
c9e0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 41 47  SQLITE_OMIT_PRAG
c9f0: 4d 41 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  MA} {.  This opt
ca00: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
ca10: 6d 69 74 20 74 68 65 20 5b 50 52 41 47 4d 41 5d  mit the [PRAGMA]
ca20: 20 63 6f 6d 6d 61 6e 64 0a 20 20 66 72 6f 6d 20   command.  from 
ca30: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 4e 6f 74  the library. Not
ca40: 65 20 74 68 61 74 20 69 74 20 69 73 20 75 73 65  e that it is use
ca50: 66 75 6c 20 74 6f 20 64 65 66 69 6e 65 20 74 68  ful to define th
ca60: 65 20 6d 61 63 72 6f 73 20 74 68 61 74 20 6f 6d  e macros that om
ca70: 69 74 0a 20 20 73 70 65 63 69 66 69 63 20 70 72  it.  specific pr
ca80: 61 67 6d 61 73 20 69 6e 20 61 64 64 69 74 69 6f  agmas in additio
ca90: 6e 20 74 6f 20 74 68 69 73 2c 20 61 73 20 74 68  n to this, as th
caa0: 65 79 20 6d 61 79 20 61 6c 73 6f 20 72 65 6d 6f  ey may also remo
cab0: 76 65 20 73 75 70 70 6f 72 74 69 6e 67 20 63 6f  ve supporting co
cac0: 64 65 0a 20 20 69 6e 20 6f 74 68 65 72 20 73 75  de.  in other su
cad0: 62 2d 73 79 73 74 65 6d 73 2e 20 54 68 69 73 20  b-systems. This 
cae0: 6d 61 63 72 6f 20 72 65 6d 6f 76 65 73 20 74 68  macro removes th
caf0: 65 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61  e [PRAGMA] comma
cb00: 6e 64 20 6f 6e 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50  nd only..}..COMP
cb10: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
cb20: 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53  TE_OMIT_PROGRESS
cb30: 5f 43 41 4c 4c 42 41 43 4b 7d 20 7b 0a 20 20 54  _CALLBACK} {.  T
cb40: 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62  his option may b
cb50: 65 20 64 65 66 69 6e 65 64 20 74 6f 20 6f 6d 69  e defined to omi
cb60: 74 20 74 68 65 20 63 61 70 61 62 69 6c 69 74 79  t the capability
cb70: 20 74 6f 20 69 73 73 75 65 20 22 70 72 6f 67 72   to issue "progr
cb80: 65 73 73 22 20 0a 20 20 63 61 6c 6c 62 61 63 6b  ess" .  callback
cb90: 73 20 64 75 72 69 6e 67 20 6c 6f 6e 67 2d 72 75  s during long-ru
cba0: 6e 6e 69 6e 67 20 53 51 4c 20 73 74 61 74 65 6d  nning SQL statem
cbb0: 65 6e 74 73 2e 20 54 68 65 20 0a 20 20 5b 73 71  ents. The .  [sq
cbc0: 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68  lite3_progress_h
cbd0: 61 6e 64 6c 65 72 28 29 5d 0a 20 20 41 50 49 20  andler()].  API 
cbe0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20  function is not 
cbf0: 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 6c  present in the l
cc00: 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  ibrary..}..COMPI
cc10: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
cc20: 45 5f 4f 4d 49 54 5f 51 55 49 43 4b 42 41 4c 41  E_OMIT_QUICKBALA
cc30: 4e 43 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  NCE} {.  This op
cc40: 74 69 6f 6e 20 6f 6d 69 74 73 20 61 6e 20 61 6c  tion omits an al
cc50: 74 65 72 6e 61 74 69 76 65 2c 20 66 61 73 74 65  ternative, faste
cc60: 72 20 42 2d 54 72 65 65 20 62 61 6c 61 6e 63 69  r B-Tree balanci
cc70: 6e 67 20 72 6f 75 74 69 6e 65 2e 0a 20 20 55 73  ng routine..  Us
cc80: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
cc90: 6d 61 6b 65 73 20 53 51 4c 69 74 65 20 73 6c 69  makes SQLite sli
cca0: 67 68 74 6c 79 20 73 6d 61 6c 6c 65 72 20 61 74  ghtly smaller at
ccb0: 20 74 68 65 20 65 78 70 65 6e 73 65 20 6f 66 0a   the expense of.
ccc0: 20 20 6d 61 6b 69 6e 67 20 69 74 20 72 75 6e 20    making it run 
ccd0: 73 6c 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 2e  slightly slower.
cce0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
ccf0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
cd00: 52 45 49 4e 44 45 58 7d 20 7b 0a 20 20 57 68 65  REINDEX} {.  Whe
cd10: 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  n this option is
cd20: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 52   defined, the [R
cd30: 45 49 4e 44 45 58 5d 0a 20 20 63 6f 6d 6d 61 6e  EINDEX].  comman
cd40: 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65  d is not include
cd50: 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79  d in the library
cd60: 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20 61 20  ..  Executing a 
cd70: 5b 52 45 49 4e 44 45 58 5d 20 73 74 61 74 65 6d  [REINDEX] statem
cd80: 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20 61 20  ent causes .  a 
cd90: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a  parse error..}..
cda0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
cdb0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48 45  SQLITE_OMIT_SCHE
cdc0: 4d 41 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20  MA_PRAGMAS} {.  
cdd0: 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70  Defining this op
cde0: 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d  tion omits pragm
cdf0: 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e 67 20  as for querying 
ce00: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
ce10: 65 6d 61 20 66 72 6f 6d 20 0a 20 20 74 68 65 20  ema from .  the 
ce20: 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  build..}..COMPIL
ce30: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
ce40: 5f 4f 4d 49 54 5f 53 43 48 45 4d 41 5f 56 45 52  _OMIT_SCHEMA_VER
ce50: 53 49 4f 4e 5f 50 52 41 47 4d 41 53 7d 20 7b 0a  SION_PRAGMAS} {.
ce60: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
ce70: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61  option omits pra
ce80: 67 6d 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e  gmas for queryin
ce90: 67 20 61 6e 64 20 6d 6f 64 69 66 79 69 6e 67 20  g and modifying 
cea0: 74 68 65 20 0a 20 20 64 61 74 61 62 61 73 65 20  the .  database 
ceb0: 73 63 68 65 6d 61 20 76 65 72 73 69 6f 6e 20 61  schema version a
cec0: 6e 64 20 75 73 65 72 20 76 65 72 73 69 6f 6e 20  nd user version 
ced0: 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 20  from the build. 
cee0: 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68  Specifically, th
cef0: 65 20 0a 20 20 5b 73 63 68 65 6d 61 5f 76 65 72  e .  [schema_ver
cf00: 73 69 6f 6e 5d 20 61 6e 64 20 5b 75 73 65 72 5f  sion] and [user_
cf10: 76 65 72 73 69 6f 6e 5d 20 50 52 41 47 4d 41 73  version] PRAGMAs
cf20: 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a   are omitted..}.
cf30: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
cf40: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41  {SQLITE_OMIT_SHA
cf50: 52 45 44 5f 43 41 43 48 45 7d 20 7b 0a 20 20 54  RED_CACHE} {.  T
cf60: 68 69 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c 64  his option build
cf70: 73 20 53 51 4c 69 74 65 20 77 69 74 68 6f 75 74  s SQLite without
cf80: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73 68 61   support for sha
cf90: 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 65 2e 0a  red-cache mode..
cfa0: 20 20 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 65    The [sqlite3_e
cfb0: 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 61 63  nable_shared_cac
cfc0: 68 65 28 29 5d 20 69 73 20 6f 6d 69 74 74 65 64  he()] is omitted
cfd0: 20 61 6c 6f 6e 67 20 77 69 74 68 20 61 20 66 61   along with a fa
cfe0: 69 72 0a 20 20 61 6d 6f 75 6e 74 20 6f 66 20 6c  ir.  amount of l
cff0: 6f 67 69 63 20 77 69 74 68 69 6e 20 74 68 65 20  ogic within the 
d000: 42 2d 54 72 65 65 20 73 75 62 73 79 73 74 65 6d  B-Tree subsystem
d010: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
d020: 20 73 68 61 72 65 64 0a 20 20 63 61 63 68 65 20   shared.  cache 
d030: 6d 61 6e 61 67 65 6d 65 6e 74 2e 0a 7d 0a 0a 43  management..}..C
d040: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
d050: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55  QLITE_OMIT_SUBQU
d060: 45 52 59 7d 20 7b 0a 20 20 49 66 20 64 65 66 69  ERY} {.  If defi
d070: 6e 65 64 2c 20 73 75 70 70 6f 72 74 20 66 6f 72  ned, support for
d080: 20 73 75 62 2d 73 65 6c 65 63 74 73 20 61 6e 64   sub-selects and
d090: 20 74 68 65 20 49 4e 28 29 20 6f 70 65 72 61 74   the IN() operat
d0a0: 6f 72 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a  or are omitted..
d0b0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
d0c0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  N {SQLITE_OMIT_T
d0d0: 43 4c 5f 56 41 52 49 41 42 4c 45 7d 20 7b 0a 20  CL_VARIABLE} {. 
d0e0: 20 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69   If this macro i
d0f0: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20  s defined, then 
d100: 74 68 65 20 73 70 65 63 69 61 6c 20 22 24 3c 76  the special "$<v
d110: 61 72 69 61 62 6c 65 2d 6e 61 6d 65 3e 22 20 73  ariable-name>" s
d120: 79 6e 74 61 78 0a 20 20 75 73 65 64 20 74 6f 20  yntax.  used to 
d130: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 69  automatically bi
d140: 6e 64 20 53 51 4c 20 76 61 72 69 61 62 6c 65 73  nd SQL variables
d150: 20 74 6f 20 54 43 4c 20 76 61 72 69 61 62 6c 65   to TCL variable
d160: 73 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a  s is omitted..}.
d170: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
d180: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d  {SQLITE_OMIT_TEM
d190: 50 44 42 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  PDB} {.  This op
d1a0: 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f  tion omits suppo
d1b0: 72 74 20 66 6f 72 20 54 45 4d 50 20 6f 72 20 54  rt for TEMP or T
d1c0: 45 4d 50 4f 52 41 52 59 20 74 61 62 6c 65 73 2e  EMPORARY tables.
d1d0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
d1e0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
d1f0: 54 52 41 43 45 7d 20 7b 0a 20 20 54 68 69 73 20  TRACE} {.  This 
d200: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
d210: 70 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 73 71  port for the [sq
d220: 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 29 5d  lite3_profile()]
d230: 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f   and.  [sqlite3_
d240: 74 72 61 63 65 28 29 5d 20 69 6e 74 65 72 66 61  trace()] interfa
d250: 63 65 73 20 61 6e 64 20 74 68 65 69 72 20 61 73  ces and their as
d260: 73 6f 63 69 61 74 65 64 20 6c 6f 67 69 63 2e 0a  sociated logic..
d270: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
d280: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  N {SQLITE_OMIT_T
d290: 52 49 47 47 45 52 7d 20 7b 0a 20 20 44 65 66 69  RIGGER} {.  Defi
d2a0: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
d2b0: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
d2c0: 6f 72 20 54 52 49 47 47 45 52 20 6f 62 6a 65 63  or TRIGGER objec
d2d0: 74 73 2e 20 4e 65 69 74 68 65 72 20 74 68 65 20  ts. Neither the 
d2e0: 0a 20 20 5b 43 52 45 41 54 45 20 54 52 49 47 47  .  [CREATE TRIGG
d2f0: 45 52 5d 20 6f 72 20 5b 44 52 4f 50 20 54 52 49  ER] or [DROP TRI
d300: 47 47 45 52 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73  GGER].  commands
d310: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69   are available i
d320: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64  n this case, and
d330: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65   attempting to e
d340: 78 65 63 75 74 65 0a 20 20 65 69 74 68 65 72 20  xecute.  either 
d350: 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61  will result in a
d360: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 20 20   parse error..  
d370: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 6c 73 6f  This option also
d380: 20 64 69 73 61 62 6c 65 73 20 65 6e 66 6f 72 63   disables enforc
d390: 65 6d 65 6e 74 20 6f 66 20 5b 66 6f 72 65 69 67  ement of [foreig
d3a0: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74  n key constraint
d3b0: 73 5d 2c 0a 20 20 73 69 6e 63 65 20 74 68 65 20  s],.  since the 
d3c0: 63 6f 64 65 20 74 68 61 74 20 69 6d 70 6c 65 6d  code that implem
d3d0: 65 6e 74 73 20 74 72 69 67 67 65 72 73 20 61 6e  ents triggers an
d3e0: 64 20 77 68 69 63 68 20 69 73 20 6f 6d 69 74 74  d which is omitt
d3f0: 65 64 20 62 79 20 74 68 69 73 0a 20 20 6f 70 74  ed by this.  opt
d400: 69 6f 6e 20 69 73 20 61 6c 73 6f 20 75 73 65 64  ion is also used
d410: 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 5b 66   to implement [f
d420: 6f 72 65 69 67 6e 20 6b 65 79 20 61 63 74 69 6f  oreign key actio
d430: 6e 73 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ns]..}..COMPILE_
d440: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
d450: 4d 49 54 5f 54 52 55 4e 43 41 54 45 5f 4f 50 54  MIT_TRUNCATE_OPT
d460: 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 41  IMIZATION} {.  A
d470: 20 64 65 66 61 75 6c 74 20 62 75 69 6c 64 20 6f   default build o
d480: 66 20 53 51 4c 69 74 65 2c 20 69 66 20 61 20 5b  f SQLite, if a [
d490: 44 45 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e  DELETE] statemen
d4a0: 74 20 68 61 73 20 6e 6f 20 57 48 45 52 45 20 63  t has no WHERE c
d4b0: 6c 61 75 73 65 0a 20 20 61 6e 64 20 6f 70 65 72  lause.  and oper
d4c0: 61 74 65 73 20 6f 6e 20 61 20 74 61 62 6c 65 20  ates on a table 
d4d0: 77 69 74 68 20 6e 6f 20 74 72 69 67 67 65 72 73  with no triggers
d4e0: 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f  , an optimizatio
d4f0: 6e 20 6f 63 63 75 72 73 20 74 68 61 74 0a 20 20  n occurs that.  
d500: 63 61 75 73 65 73 20 74 68 65 20 44 45 4c 45 54  causes the DELET
d510: 45 20 74 6f 20 6f 63 63 75 72 20 62 79 20 64 72  E to occur by dr
d520: 6f 70 70 69 6e 67 20 61 6e 64 20 72 65 63 72 65  opping and recre
d530: 61 74 69 6e 67 20 74 68 65 20 74 61 62 6c 65 2e  ating the table.
d540: 20 20 0a 20 20 44 72 6f 70 70 69 6e 67 20 61 6e    .  Dropping an
d550: 64 20 72 65 63 72 65 61 74 69 6e 67 20 61 20 74  d recreating a t
d560: 61 62 6c 65 20 69 73 20 75 73 75 61 6c 6c 79 20  able is usually 
d570: 6d 75 63 68 20 66 61 73 74 65 72 20 74 68 61 6e  much faster than
d580: 20 64 65 6c 65 74 69 6e 67 0a 20 20 74 68 65 20   deleting.  the 
d590: 74 61 62 6c 65 20 63 6f 6e 74 65 6e 74 20 72 6f  table content ro
d5a0: 77 20 62 79 20 72 6f 77 2e 20 20 54 68 69 73 20  w by row.  This 
d5b0: 69 73 20 74 68 65 20 22 74 72 75 6e 63 61 74 65  is the "truncate
d5c0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 22 2e 0a   optimization"..
d5d0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
d5e0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  N {SQLITE_OMIT_U
d5f0: 54 46 31 36 7d 20 7b 0a 20 20 54 68 69 73 20 6d  TF16} {.  This m
d600: 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20  acro is used to 
d610: 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72  omit support for
d620: 20 55 54 46 31 36 20 74 65 78 74 20 65 6e 63 6f   UTF16 text enco
d630: 64 69 6e 67 2e 20 57 68 65 6e 20 74 68 69 73 20  ding. When this 
d640: 69 73 0a 20 20 64 65 66 69 6e 65 64 20 61 6c 6c  is.  defined all
d650: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 74   API functions t
d660: 68 61 74 20 72 65 74 75 72 6e 20 6f 72 20 61 63  hat return or ac
d670: 63 65 70 74 20 55 54 46 31 36 20 65 6e 63 6f 64  cept UTF16 encod
d680: 65 64 20 74 65 78 74 20 61 72 65 0a 20 20 75 6e  ed text are.  un
d690: 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65 73 65  available. These
d6a0: 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 62   functions can b
d6b0: 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20  e identified by 
d6c0: 74 68 65 20 66 61 63 74 20 74 68 61 74 20 74 68  the fact that th
d6d0: 65 79 20 65 6e 64 0a 20 20 77 69 74 68 20 27 31  ey end.  with '1
d6e0: 36 27 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20  6', for example 
d6f0: 5b 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65  [sqlite3_prepare
d700: 31 36 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f  16()], [sqlite3_
d710: 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 5d  column_text16()]
d720: 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f   and.  [sqlite3_
d730: 62 69 6e 64 5f 74 65 78 74 31 36 28 29 5d 2e 0a  bind_text16()]..
d740: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
d750: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56  N {SQLITE_OMIT_V
d760: 41 43 55 55 4d 7d 20 7b 0a 20 20 57 68 65 6e 20  ACUUM} {.  When 
d770: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
d780: 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 56 41 43  efined, the [VAC
d790: 55 55 4d 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 69  UUM].  command i
d7a0: 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69  s not included i
d7b0: 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 20  n the library.. 
d7c0: 20 45 78 65 63 75 74 69 6e 67 20 61 20 5b 56 41   Executing a [VA
d7d0: 43 55 55 4d 5d 20 73 74 61 74 65 6d 65 6e 74 20  CUUM] statement 
d7e0: 63 61 75 73 65 73 20 0a 20 20 61 20 70 61 72 73  causes .  a pars
d7f0: 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50  e error..}..COMP
d800: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
d810: 54 45 5f 4f 4d 49 54 5f 56 49 45 57 7d 20 7b 0a  TE_OMIT_VIEW} {.
d820: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
d830: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
d840: 70 6f 72 74 20 66 6f 72 20 56 49 45 57 20 6f 62  port for VIEW ob
d850: 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20 74  jects. Neither t
d860: 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 56 49  he .  [CREATE VI
d870: 45 57 5d 20 6e 6f 72 20 74 68 65 20 5b 44 52 4f  EW] nor the [DRO
d880: 50 20 56 49 45 57 5d 0a 20 20 63 6f 6d 6d 61 6e  P VIEW].  comman
d890: 64 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65  ds are available
d8a0: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61   in this case, a
d8b0: 6e 64 0a 20 20 61 74 74 65 6d 70 74 69 6e 67 20  nd.  attempting 
d8c0: 74 6f 20 65 78 65 63 75 74 65 20 65 69 74 68 65  to execute eithe
d8d0: 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e  r will result in
d8e0: 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a   a parse error..
d8f0: 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 66 20 74  .  WARNING: If t
d900: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66  his macro is def
d910: 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c 20 6e 6f  ined, it will no
d920: 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f  t be possible to
d930: 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61 73 65   open a database
d940: 0a 20 20 66 6f 72 20 77 68 69 63 68 20 74 68 65  .  for which the
d950: 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 73   schema contains
d960: 20 56 49 45 57 20 6f 62 6a 65 63 74 73 2e 20 0a   VIEW objects. .
d970: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
d980: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56  N {SQLITE_OMIT_V
d990: 49 52 54 55 41 4c 54 41 42 4c 45 7d 20 7b 0a 20  IRTUALTABLE} {. 
d9a0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
d9b0: 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74  ts support for t
d9c0: 68 65 20 5b 73 71 6c 69 74 65 33 5f 76 74 61 62  he [sqlite3_vtab
d9d0: 20 7c 20 56 69 72 74 75 61 6c 20 54 61 62 6c 65   | Virtual Table
d9e0: 5d 0a 20 20 6d 65 63 68 61 6e 69 73 6d 20 69 6e  ].  mechanism in
d9f0: 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d 50   SQLite..}..COMP
da00: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
da10: 54 45 5f 4f 4d 49 54 5f 57 41 4c 7d 20 7b 0a 20  TE_OMIT_WAL} {. 
da20: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
da30: 74 73 20 74 68 65 20 22 5b 77 72 69 74 65 2d 61  ts the "[write-a
da40: 68 65 61 64 20 6c 6f 67 5d 22 20 28 61 2e 6b 2e  head log]" (a.k.
da50: 61 2e 20 22 5b 57 41 4c 5d 22 29 20 63 61 70 61  a. "[WAL]") capa
da60: 62 69 6c 69 74 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  bility..}..COMPI
da70: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
da80: 45 5f 4f 4d 49 54 5f 57 53 44 7d 20 7b 0a 20 20  E_OMIT_WSD} {.  
da90: 54 68 69 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c  This option buil
daa0: 64 73 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 20  ds a version of 
dab0: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
dac0: 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73  ry that contains
dad0: 20 6e 6f 0a 20 20 57 72 69 74 61 62 6c 65 20 53   no.  Writable S
dae0: 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 29  tatic Data (WSD)
daf0: 2e 20 20 57 53 44 20 69 73 20 67 6c 6f 62 61 6c  .  WSD is global
db00: 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 2f 6f   variables and/o
db10: 72 20 73 74 61 74 69 63 0a 20 20 76 61 72 69 61  r static.  varia
db20: 62 6c 65 73 2e 20 20 53 6f 6d 65 20 70 6c 61 74  bles.  Some plat
db30: 66 6f 72 6d 73 20 64 6f 20 6e 6f 74 20 73 75 70  forms do not sup
db40: 70 6f 72 74 20 57 53 44 2c 20 61 6e 64 20 74 68  port WSD, and th
db50: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 63  is option is nec
db60: 65 73 73 61 72 79 0a 20 20 69 6e 20 6f 72 64 65  essary.  in orde
db70: 72 20 66 6f 72 20 53 51 4c 69 74 65 20 74 6f 20  r for SQLite to 
db80: 77 6f 72 6b 20 74 68 6f 73 65 20 70 6c 61 74 66  work those platf
db90: 6f 72 6d 73 2e 20 20 0a 0a 20 20 55 6e 6c 69 6b  orms.  ..  Unlik
dba0: 65 20 6f 74 68 65 72 20 4f 4d 49 54 20 6f 70 74  e other OMIT opt
dbb0: 69 6f 6e 73 20 77 68 69 63 68 20 6d 61 6b 65 20  ions which make 
dbc0: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
dbd0: 72 79 20 73 6d 61 6c 6c 65 72 2c 0a 20 20 74 68  ry smaller,.  th
dbe0: 69 73 20 6f 70 74 69 6f 6e 20 61 63 74 75 61 6c  is option actual
dbf0: 6c 79 20 69 6e 63 72 65 61 73 65 73 20 74 68 65  ly increases the
dc00: 20 73 69 7a 65 20 6f 66 20 53 51 4c 69 74 65 20   size of SQLite 
dc10: 61 6e 64 20 6d 61 6b 65 73 20 69 74 20 72 75 6e  and makes it run
dc20: 0a 20 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f 77  .  a little slow
dc30: 65 72 2e 20 20 4f 6e 6c 79 20 75 73 65 20 74 68  er.  Only use th
dc40: 69 73 20 6f 70 74 69 6f 6e 20 69 66 20 53 51 4c  is option if SQL
dc50: 69 74 65 20 69 73 20 62 65 69 6e 67 20 62 75 69  ite is being bui
dc60: 6c 74 20 66 6f 72 20 61 6e 0a 20 20 65 6d 62 65  lt for an.  embe
dc70: 64 64 65 64 20 74 61 72 67 65 74 20 74 68 61 74  dded target that
dc80: 20 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72   does not suppor
dc90: 74 20 57 53 44 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  t WSD..}..COMPIL
dca0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
dcb0: 5f 4f 4d 49 54 5f 58 46 45 52 5f 4f 50 54 7d 20  _OMIT_XFER_OPT} 
dcc0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
dcd0: 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f  omits support fo
dce0: 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20  r optimizations 
dcf0: 74 68 61 74 20 68 65 6c 70 20 73 74 61 74 65 6d  that help statem
dd00: 65 6e 74 73 0a 20 20 6f 66 20 74 68 65 20 66 6f  ents.  of the fo
dd10: 72 6d 20 22 49 4e 53 45 52 54 20 49 4e 54 4f 20  rm "INSERT INTO 
dd20: 2e 2e 2e 20 53 45 4c 45 43 54 20 2e 2e 2e 22 20  ... SELECT ..." 
dd30: 72 75 6e 20 66 61 73 74 65 72 2e 0a 7d 0a 0a 43  run faster..}..C
dd40: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
dd50: 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f  QLITE_ZERO_MALLO
dd60: 43 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  C} {.  This opti
dd70: 6f 6e 20 6f 6d 69 74 73 20 62 6f 74 68 20 74 68  on omits both th
dd80: 65 20 5b 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72  e [default memor
dd90: 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 20 61 6e 64  y allocator] and
dda0: 20 74 68 65 0a 20 20 5b 64 65 62 75 67 67 69 6e   the.  [debuggin
ddb0: 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  g memory allocat
ddc0: 6f 72 5d 20 66 72 6f 6d 20 74 68 65 20 62 75 69  or] from the bui
ddd0: 6c 64 20 61 6e 64 20 73 75 62 73 74 69 74 75 74  ld and substitut
dde0: 65 73 20 61 20 73 74 75 62 0a 20 20 6d 65 6d 6f  es a stub.  memo
ddf0: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 74 68 61  ry allocator tha
de00: 74 20 61 6c 77 61 79 73 20 66 61 69 6c 73 2e 20  t always fails. 
de10: 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74   SQLite will not
de20: 20 72 75 6e 20 77 69 74 68 20 74 68 69 73 0a 20   run with this. 
de30: 20 73 74 75 62 20 6d 65 6d 6f 72 79 20 61 6c 6c   stub memory all
de40: 6f 63 61 74 6f 72 20 73 69 6e 63 65 20 69 74 20  ocator since it 
de50: 77 69 6c 6c 20 62 65 20 75 6e 61 62 6c 65 20 74  will be unable t
de60: 6f 20 61 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72  o allocate memor
de70: 79 2e 20 20 42 75 74 0a 20 20 74 68 69 73 20 73  y.  But.  this s
de80: 74 75 62 20 63 61 6e 20 62 65 20 72 65 70 6c 61  tub can be repla
de90: 63 65 64 20 61 74 20 73 74 61 72 74 2d 74 69 6d  ced at start-tim
dea0: 65 20 75 73 69 6e 67 0a 20 20 5b 73 71 6c 69 74  e using.  [sqlit
deb0: 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 51 4c 49  e3_config]([SQLI
dec0: 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43  TE_CONFIG_MALLOC
ded0: 5d 2c 2e 2e 2e 29 20 6f 72 0a 20 20 5b 73 71 6c  ],...) or.  [sql
dee0: 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 51  ite3_config]([SQ
def0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50  LITE_CONFIG_HEAP
df00: 5d 2c 2e 2e 2e 29 2e 0a 20 20 53 6f 20 74 68 65  ],...)..  So the
df10: 20 6e 65 74 20 65 66 66 65 63 74 20 6f 66 20 74   net effect of t
df20: 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  his compile-time
df30: 20 6f 70 74 69 6f 6e 20 69 73 20 74 68 61 74 20   option is that 
df40: 69 74 20 61 6c 6c 6f 77 73 20 53 51 4c 69 74 65  it allows SQLite
df50: 0a 20 20 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65  .  to be compile
df60: 64 20 61 6e 64 20 6c 69 6e 6b 65 64 20 61 67 61  d and linked aga
df70: 69 6e 73 74 20 61 20 73 79 73 74 65 6d 20 6c 69  inst a system li
df80: 62 72 61 72 79 20 74 68 61 74 20 64 6f 65 73 20  brary that does 
df90: 6e 6f 74 20 73 75 70 70 6f 72 74 0a 20 20 6d 61  not support.  ma
dfa0: 6c 6c 6f 63 28 29 2c 20 66 72 65 65 28 29 2c 20  lloc(), free(), 
dfb0: 61 6e 64 2f 6f 72 20 72 65 61 6c 6c 6f 63 28 29  and/or realloc()
dfc0: 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 3c 61 20 6e  ..}..</tcl>.<a n
dfd0: 61 6d 65 3d 22 64 65 62 75 67 6f 70 74 69 6f 6e  ame="debugoption
dfe0: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 38 20  s"></a>.<h2>1.8 
dff0: 41 6e 61 6c 79 73 69 73 20 61 6e 64 20 44 65 62  Analysis and Deb
e000: 75 67 67 69 6e 67 20 4f 70 74 69 6f 6e 73 3c 2f  ugging Options</
e010: 68 32 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50 49  h2>.<tcl>..COMPI
e020: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
e030: 45 5f 44 45 42 55 47 7d 20 7b 0a 20 20 54 68 65  E_DEBUG} {.  The
e040: 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63   SQLite source c
e050: 6f 64 65 20 63 6f 6e 74 61 69 6e 73 20 6c 69 74  ode contains lit
e060: 65 72 61 6c 6c 79 20 74 68 6f 75 73 61 6e 64 73  erally thousands
e070: 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 61   of assert() sta
e080: 74 65 6d 65 6e 74 73 0a 20 20 75 73 65 64 20 74  tements.  used t
e090: 6f 20 76 65 72 69 66 79 20 69 6e 74 65 72 6e 61  o verify interna
e0a0: 6c 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 61 6e  l assumptions an
e0b0: 64 20 73 75 62 72 6f 75 74 69 6e 65 20 70 72 65  d subroutine pre
e0c0: 63 6f 6e 64 69 74 69 6f 6e 73 20 61 6e 64 0a 20  conditions and. 
e0d0: 20 70 6f 73 74 63 6f 6e 64 69 74 69 6f 6e 73 2e   postconditions.
e0e0: 20 20 54 68 65 73 65 20 61 73 73 65 72 74 28 29    These assert()
e0f0: 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20   statements are 
e100: 6e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20  normally turned 
e110: 6f 66 66 0a 20 20 28 74 68 65 79 20 67 65 6e 65  off.  (they gene
e120: 72 61 74 65 20 6e 6f 20 63 6f 64 65 29 20 73 69  rate no code) si
e130: 6e 63 65 20 74 75 72 6e 69 6e 67 20 74 68 65 6d  nce turning them
e140: 20 6f 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74 65   on makes SQLite
e150: 20 72 75 6e 20 61 70 70 72 6f 78 69 6d 61 74 65   run approximate
e160: 6c 79 0a 20 20 74 68 72 65 65 20 74 69 6d 65 73  ly.  three times
e170: 20 73 6c 6f 77 65 72 2e 20 20 42 75 74 20 66 6f   slower.  But fo
e180: 72 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61 6e  r testing and an
e190: 61 6c 79 73 69 73 2c 20 69 74 20 69 73 20 75 73  alysis, it is us
e1a0: 65 66 75 6c 20 74 6f 20 74 75 72 6e 0a 20 20 74  eful to turn.  t
e1b0: 68 65 20 61 73 73 65 72 74 28 29 20 73 74 61 74  he assert() stat
e1c0: 65 6d 65 6e 74 73 20 6f 6e 2e 20 20 54 68 65 20  ements on.  The 
e1d0: 53 51 4c 49 54 45 5f 44 45 42 55 47 20 63 6f 6d  SQLITE_DEBUG com
e1e0: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
e1f0: 20 64 6f 65 73 20 74 68 69 73 2e 0a 20 20 3c 70   does this..  <p
e200: 3e 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61 6c  >SQLITE_DEBUG al
e210: 73 6f 20 65 6e 61 62 6c 65 73 20 73 6f 6d 65 20  so enables some 
e220: 6f 74 68 65 72 20 64 65 62 75 67 67 69 6e 67 20  other debugging 
e230: 66 65 61 74 75 72 65 73 2c 20 73 75 63 68 20 61  features, such a
e240: 73 0a 20 20 73 70 65 63 69 61 6c 20 5b 50 52 41  s.  special [PRA
e250: 47 4d 41 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  GMA] statements 
e260: 74 68 61 74 20 74 75 72 6e 20 6f 6e 20 74 72 61  that turn on tra
e270: 63 69 6e 67 20 61 6e 64 20 6c 69 73 74 69 6e 67  cing and listing
e280: 20 66 65 61 74 75 72 65 73 0a 20 20 75 73 65 64   features.  used
e290: 20 66 6f 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f   for troubleshoo
e2a0: 74 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69  ting and analysi
e2b0: 73 20 6f 66 20 74 68 65 20 5b 56 44 42 45 5d 20  s of the [VDBE] 
e2c0: 61 6e 64 20 63 6f 64 65 20 67 65 6e 65 72 61 74  and code generat
e2d0: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
e2e0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 45  PTION {SQLITE_ME
e2f0: 4d 44 45 42 55 47 7d 20 7b 0a 20 20 54 68 65 20  MDEBUG} {.  The 
e300: 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20  SQLITE_MEMDEBUG 
e310: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 61 6e  option causes an
e320: 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20 0a 20   instrumented . 
e330: 20 5b 64 65 62 75 67 67 69 6e 67 20 6d 65 6d 6f   [debugging memo
e340: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 0a 20 20  ry allocator].  
e350: 74 6f 20 62 65 20 75 73 65 64 20 61 73 20 74 68  to be used as th
e360: 65 20 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79  e default memory
e370: 20 61 6c 6c 6f 63 61 74 6f 72 20 77 69 74 68 69   allocator withi
e380: 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65 0a 20  n SQLite.  The. 
e390: 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20 6d 65   instrumented me
e3a0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 63  mory allocator c
e3b0: 68 65 63 6b 73 20 66 6f 72 20 6d 69 73 75 73 65  hecks for misuse
e3c0: 20 6f 66 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20   of dynamically 
e3d0: 61 6c 6c 6f 63 61 74 65 64 0a 20 20 6d 65 6d 6f  allocated.  memo
e3e0: 72 79 2e 20 20 45 78 61 6d 70 6c 65 73 20 6f 66  ry.  Examples of
e3f0: 20 6d 69 73 75 73 65 20 69 6e 63 6c 75 64 65 20   misuse include 
e400: 75 73 69 6e 67 20 6d 65 6d 6f 72 79 20 61 66 74  using memory aft
e410: 65 72 20 69 74 20 69 73 20 66 72 65 65 64 2c 0a  er it is freed,.
e420: 20 20 77 72 69 74 69 6e 67 20 6f 66 66 20 74 68    writing off th
e430: 65 20 65 6e 64 73 20 6f 66 20 61 20 6d 65 6d 6f  e ends of a memo
e440: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 20 66  ry allocation, f
e450: 72 65 65 69 6e 67 20 6d 65 6d 6f 72 79 20 6e 6f  reeing memory no
e460: 74 20 70 72 65 76 69 6f 75 73 6c 79 0a 20 20 6f  t previously.  o
e470: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65  btained from the
e480: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
e490: 72 2c 20 6f 72 20 66 61 69 6c 69 6e 67 20 74 6f  r, or failing to
e4a0: 20 69 6e 69 74 69 61 6c 69 7a 65 20 6e 65 77 6c   initialize newl
e4b0: 79 0a 20 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65  y.  allocated me
e4c0: 6d 6f 72 79 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a  mory..}..</tcl>.
e4d0: 3c 61 20 6e 61 6d 65 3d 22 77 69 6e 33 32 6f 70  <a name="win32op
e4e0: 74 69 6f 6e 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e  tions"></a>.<h2>
e4f0: 31 2e 39 20 57 69 6e 64 6f 77 73 2d 53 70 65 63  1.9 Windows-Spec
e500: 69 66 69 63 20 4f 70 74 69 6f 6e 73 3c 2f 68 32  ific Options</h2
e510: 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50 49 4c 45  >.<tcl>..COMPILE
e520: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
e530: 57 49 4e 33 32 5f 48 45 41 50 5f 43 52 45 41 54  WIN32_HEAP_CREAT
e540: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
e550: 6f 6e 20 66 6f 72 63 65 73 20 74 68 65 20 57 69  on forces the Wi
e560: 6e 33 32 20 6e 61 74 69 76 65 20 6d 65 6d 6f 72  n32 native memor
e570: 79 20 61 6c 6c 6f 63 61 74 6f 72 2c 20 77 68 65  y allocator, whe
e580: 6e 20 65 6e 61 62 6c 65 64 2c 20 74 6f 0a 20 20  n enabled, to.  
e590: 63 72 65 61 74 65 20 61 20 70 72 69 76 61 74 65  create a private
e5a0: 20 68 65 61 70 20 74 6f 20 68 6f 6c 64 20 61 6c   heap to hold al
e5b0: 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  l memory allocat
e5c0: 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ions..}..COMPILE
e5d0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
e5e0: 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 5f 56 41 4c  WIN32_MALLOC_VAL
e5f0: 49 44 41 54 45 7d 20 7b 0a 20 20 54 68 69 73 20  IDATE} {.  This 
e600: 6f 70 74 69 6f 6e 20 66 6f 72 63 65 73 20 74 68  option forces th
e610: 65 20 57 69 6e 33 32 20 6e 61 74 69 76 65 20 6d  e Win32 native m
e620: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2c  emory allocator,
e630: 20 77 68 65 6e 20 65 6e 61 62 6c 65 64 2c 20 74   when enabled, t
e640: 6f 0a 20 20 6d 61 6b 65 20 73 74 72 61 74 65 67  o.  make strateg
e650: 69 63 20 63 61 6c 6c 73 20 69 6e 74 6f 20 74 68  ic calls into th
e660: 65 20 48 65 61 70 56 61 6c 69 64 61 74 65 28 29  e HeapValidate()
e670: 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 61 73 73   function if ass
e680: 65 72 74 28 29 20 69 73 20 61 6c 73 6f 0a 20 20  ert() is also.  
e690: 65 6e 61 62 6c 65 64 2e 0a 7d 0a 0a 3c 2f 74 63  enabled..}..</tc
e6a0: 6c 3e 0a                                         l>.