Documentation Source Text

Hex Artifact Content
Login

Artifact 367ae208b9c043ee1a1a4e4007ebc9a543d458b0:


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: 57 41 4c 5f 41 55 54 4f 43 48 45 43 4b 50 4f 49  WAL_AUTOCHECKPOI
2740: 4e 54 3d 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26  NT=<i>&lt;pages&
2750: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69  gt;</i>} {.  Thi
2760: 73 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65  s macro sets the
2770: 20 64 65 66 61 75 6c 74 20 70 61 67 65 20 63 6f   default page co
2780: 75 6e 74 20 66 6f 72 20 74 68 65 20 5b 57 41 4c  unt for the [WAL
2790: 5d 0a 20 20 5b 63 68 65 63 6b 70 6f 69 6e 74 69  ].  [checkpointi
27a0: 6e 67 20 7c 20 61 75 74 6f 6d 61 74 69 63 20 63  ng | automatic c
27b0: 68 65 63 6b 70 6f 69 6e 74 69 6e 67 5d 20 66 65  heckpointing] fe
27c0: 61 74 75 72 65 2e 20 20 49 66 20 75 6e 73 70 65  ature.  If unspe
27d0: 63 69 66 69 65 64 2c 0a 20 20 74 68 65 20 64 65  cified,.  the de
27e0: 66 61 75 6c 74 20 70 61 67 65 20 63 6f 75 6e 74  fault page count
27f0: 20 69 73 20 31 30 30 30 2e 0a 7d 0a 0a 43 4f 4d   is 1000..}..COM
2800: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
2810: 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b  ITE_DEFAULT_WORK
2820: 45 52 5f 54 48 52 45 41 44 53 3d 3c 69 3e 4e 3c  ER_THREADS=<i>N<
2830: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61  /i>} {.  This ma
2840: 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65 66  cro sets the def
2850: 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 0a 20  ault value for. 
2860: 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 4c 49 4d   the [SQLITE_LIM
2870: 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44  IT_WORKER_THREAD
2880: 53 5d 20 70 61 72 61 6d 65 74 65 72 2e 20 20 54  S] parameter.  T
2890: 68 65 20 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54  he [SQLITE_LIMIT
28a0: 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 5d  _WORKER_THREADS]
28b0: 0a 20 20 70 61 72 61 6d 65 74 65 72 20 73 65 74  .  parameter set
28c0: 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75  s the maximum nu
28d0: 6d 62 65 72 20 6f 66 20 61 75 78 69 6c 69 61 72  mber of auxiliar
28e0: 79 20 74 68 72 65 61 64 73 20 74 68 61 74 20 61  y threads that a
28f0: 20 73 69 6e 67 6c 65 0a 20 20 5b 70 72 65 70 61   single.  [prepa
2900: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 5d 20 77  red statement] w
2910: 69 6c 6c 20 6c 61 75 6e 63 68 20 74 6f 20 61 73  ill launch to as
2920: 73 69 73 74 20 69 74 20 77 69 74 68 20 61 20 71  sist it with a q
2930: 75 65 72 79 2e 20 20 49 66 20 6e 6f 74 20 73 70  uery.  If not sp
2940: 65 63 69 66 69 65 64 2c 0a 20 20 74 68 65 20 64  ecified,.  the d
2950: 65 66 61 75 6c 74 20 6d 61 78 69 6d 75 6d 20 69  efault maximum i
2960: 73 20 30 2e 0a 20 20 54 68 65 20 76 61 6c 75 65  s 0..  The value
2970: 20 73 65 74 20 68 65 72 65 20 63 61 6e 6e 6f 74   set here cannot
2980: 20 62 65 20 6d 6f 72 65 20 74 68 61 6e 20 5b 53   be more than [S
2990: 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52  QLITE_MAX_WORKER
29a0: 5f 54 48 52 45 41 44 53 5d 2e 0a 7d 0a 0a 43 4f  _THREADS]..}..CO
29b0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
29c0: 4c 49 54 45 5f 46 54 53 33 5f 4d 41 58 5f 45 58  LITE_FTS3_MAX_EX
29d0: 50 52 5f 44 45 50 54 48 3d 3c 69 3e 4e 3c 2f 69  PR_DEPTH=<i>N</i
29e0: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72  >} {.  This macr
29f0: 6f 20 73 65 74 73 20 74 68 65 20 6d 61 78 69 6d  o sets the maxim
2a00: 75 6d 20 64 65 70 74 68 20 6f 66 20 74 68 65 20  um depth of the 
2a10: 73 65 61 72 63 68 20 74 72 65 65 20 74 68 61 74  search tree that
2a20: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 0a   corresponds to.
2a30: 20 20 74 68 65 20 72 69 67 68 74 2d 68 61 6e 64    the right-hand
2a40: 20 73 69 64 65 20 6f 66 20 74 68 65 20 4d 41 54   side of the MAT
2a50: 43 48 20 6f 70 65 72 61 74 6f 72 20 69 6e 20 61  CH operator in a
2a60: 6e 20 5b 46 54 53 33 5d 20 6f 72 20 5b 46 54 53  n [FTS3] or [FTS
2a70: 34 5d 20 66 75 6c 6c 2d 74 65 78 74 0a 20 20 69  4] full-text.  i
2a80: 6e 64 65 78 2e 20 20 54 68 65 20 66 75 6c 6c 2d  ndex.  The full-
2a90: 74 65 78 74 20 73 65 61 72 63 68 20 75 73 65 73  text search uses
2aa0: 20 61 20 72 65 63 75 72 73 69 76 65 20 61 6c 67   a recursive alg
2ab0: 6f 72 69 74 68 6d 2c 20 73 6f 20 74 68 65 20 64  orithm, so the d
2ac0: 65 70 74 68 20 6f 66 0a 20 20 74 68 65 20 74 72  epth of.  the tr
2ad0: 65 65 20 69 73 20 6c 69 6d 69 74 65 64 20 74 6f  ee is limited to
2ae0: 20 70 72 65 76 65 6e 74 20 75 73 69 6e 67 20 74   prevent using t
2af0: 6f 6f 20 6d 75 63 68 20 73 74 61 63 6b 20 73 70  oo much stack sp
2b00: 61 63 65 2e 20 20 54 68 65 20 64 65 66 61 75 6c  ace.  The defaul
2b10: 74 0a 20 20 6c 69 6d 69 74 20 69 73 20 31 32 2e  t.  limit is 12.
2b20: 20 20 54 68 69 73 20 6c 69 6d 69 74 20 69 73 20    This limit is 
2b30: 73 75 66 66 69 63 69 65 6e 74 20 66 6f 72 20 75  sufficient for u
2b40: 70 20 74 6f 20 34 30 39 35 20 73 65 61 72 63 68  p to 4095 search
2b50: 20 74 65 72 6d 73 20 6f 6e 20 74 68 65 0a 20 20   terms on the.  
2b60: 72 69 67 68 74 2d 68 61 6e 64 20 73 69 64 65 20  right-hand side 
2b70: 6f 66 20 74 68 65 20 4d 41 54 43 48 20 6f 70 65  of the MATCH ope
2b80: 72 61 74 6f 72 20 61 6e 64 20 69 74 20 68 6f 6c  rator and it hol
2b90: 64 73 20 73 74 61 63 6b 20 73 70 61 63 65 20 75  ds stack space u
2ba0: 73 61 67 65 20 74 6f 20 0a 20 20 6c 65 73 73 20  sage to .  less 
2bb0: 74 68 61 6e 20 32 30 30 30 20 62 79 74 65 73 2e  than 2000 bytes.
2bc0: 0a 20 20 3c 70 3e 0a 20 20 46 6f 72 20 6f 72 64  .  <p>.  For ord
2bd0: 69 6e 61 72 79 20 46 54 53 33 2f 46 54 53 34 20  inary FTS3/FTS4 
2be0: 71 75 65 72 69 65 73 2c 20 74 68 65 20 73 65 61  queries, the sea
2bf0: 72 63 68 20 74 72 65 65 20 64 65 70 74 68 20 69  rch tree depth i
2c00: 73 20 61 70 70 72 6f 78 69 6d 61 74 65 6c 79 0a  s approximately.
2c10: 20 20 74 68 65 20 62 61 73 65 2d 32 20 6c 6f 67    the base-2 log
2c20: 61 72 69 74 68 6d 20 6f 66 20 74 68 65 20 6e 75  arithm of the nu
2c30: 6d 62 65 72 20 6f 66 20 74 65 72 6d 73 20 69 6e  mber of terms in
2c40: 20 74 68 65 20 72 69 67 68 74 2d 68 61 6e 64 20   the right-hand 
2c50: 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 4d 41  side of the.  MA
2c60: 54 43 48 20 6f 70 65 72 61 74 6f 72 2e 20 20 48  TCH operator.  H
2c70: 6f 77 65 76 65 72 2c 20 66 6f 72 20 5b 70 68 72  owever, for [phr
2c80: 61 73 65 20 71 75 65 72 69 65 73 5d 20 61 6e 64  ase queries] and
2c90: 20 5b 4e 45 41 52 20 71 75 65 72 69 65 73 5d 20   [NEAR queries] 
2ca0: 74 68 65 0a 20 20 73 65 61 72 63 68 20 74 72 65  the.  search tre
2cb0: 65 20 64 65 70 74 68 20 69 73 20 6c 69 6e 65 61  e depth is linea
2cc0: 72 20 69 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  r in the number 
2cd0: 6f 66 20 72 69 67 68 74 2d 68 61 6e 64 20 73 69  of right-hand si
2ce0: 64 65 20 74 65 72 6d 73 2e 0a 20 20 53 6f 20 74  de terms..  So t
2cf0: 68 65 20 64 65 66 61 75 6c 74 20 64 65 70 74 68  he default depth
2d00: 20 6c 69 6d 69 74 20 6f 66 20 31 32 20 69 73 20   limit of 12 is 
2d10: 73 75 66 66 69 63 69 65 6e 74 20 66 6f 72 20 75  sufficient for u
2d20: 70 20 74 6f 20 34 30 39 35 20 6f 72 64 69 6e 61  p to 4095 ordina
2d30: 72 79 0a 20 20 74 65 72 6d 73 20 6f 6e 20 61 20  ry.  terms on a 
2d40: 4d 41 54 43 48 2c 20 69 74 20 69 73 20 6f 6e 6c  MATCH, it is onl
2d50: 79 20 73 75 66 66 69 63 69 65 6e 74 20 66 6f 72  y sufficient for
2d60: 20 31 31 20 6f 72 20 31 32 20 70 68 72 61 73 65   11 or 12 phrase
2d70: 20 6f 72 20 4e 45 41 52 0a 20 20 74 65 72 6d 73   or NEAR.  terms
2d80: 2e 20 20 45 76 65 6e 20 73 6f 2c 20 74 68 65 20  .  Even so, the 
2d90: 64 65 66 61 75 6c 74 20 69 73 20 6d 6f 72 65 20  default is more 
2da0: 74 68 61 6e 20 65 6e 6f 75 67 68 20 66 6f 72 20  than enough for 
2db0: 6d 6f 73 74 20 61 70 70 6c 69 63 61 74 69 6f 6e  most application
2dc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
2dd0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 41 58 5f  ION {SQLITE_MAX_
2de0: 4d 4d 41 50 5f 53 49 5a 45 3d 3c 69 3e 4e 3c 2f  MMAP_SIZE=<i>N</
2df0: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63  i>} {.  This mac
2e00: 72 6f 20 73 65 74 73 20 61 20 68 61 72 64 20 75  ro sets a hard u
2e10: 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68  pper bound on th
2e20: 65 20 61 6d 6f 75 6e 74 20 6f 66 20 61 64 64 72  e amount of addr
2e30: 65 73 73 20 73 70 61 63 65 20 74 68 61 74 0a 20  ess space that. 
2e40: 20 63 61 6e 20 62 65 20 75 73 65 64 20 62 79 20   can be used by 
2e50: 61 6e 79 20 73 69 6e 67 6c 65 20 64 61 74 61 62  any single datab
2e60: 61 73 65 20 66 6f 72 20 6d 65 6d 6f 72 79 2d 6d  ase for memory-m
2e70: 61 70 70 65 64 20 49 2f 4f 2e 0a 20 20 53 65 74  apped I/O..  Set
2e80: 74 69 6e 67 20 74 68 69 73 20 76 61 6c 75 65 20  ting this value 
2e90: 74 6f 20 30 20 63 6f 6d 70 6c 65 74 65 6c 79 20  to 0 completely 
2ea0: 64 69 73 61 62 6c 65 73 20 6d 65 6d 6f 72 79 2d  disables memory-
2eb0: 6d 61 70 70 65 64 20 49 2f 4f 20 61 6e 64 0a 20  mapped I/O and. 
2ec0: 20 63 61 75 73 65 73 20 6c 6f 67 69 63 20 61 73   causes logic as
2ed0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 6d 65  sociated with me
2ee0: 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20  mory-mapped I/O 
2ef0: 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72  to be omitted fr
2f00: 6f 6d 20 74 68 65 0a 20 20 62 75 69 6c 64 2e 20  om the.  build. 
2f10: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 6f 65   This option doe
2f20: 73 20 63 68 61 6e 67 65 20 74 68 65 20 64 65 66  s change the def
2f30: 61 75 6c 74 20 6d 65 6d 6f 72 79 2d 6d 61 70 70  ault memory-mapp
2f40: 65 64 20 49 2f 4f 20 61 64 64 72 65 73 73 0a 20  ed I/O address. 
2f50: 20 73 70 61 63 65 20 73 69 7a 65 20 28 73 65 74   space size (set
2f60: 20 62 79 20 5b 53 51 4c 49 54 45 5f 44 45 46 41   by [SQLITE_DEFA
2f70: 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 5d 20 6f  ULT_MMAP_SIZE] o
2f80: 72 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66  r.  sqlite3_conf
2f90: 69 67 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  ig([SQLITE_CONFI
2fa0: 47 5f 4d 4d 41 50 5f 53 49 5a 45 5d 29 20 6f 72  G_MMAP_SIZE]) or
2fb0: 20 74 68 65 0a 20 20 72 75 6e 2d 74 69 6d 65 20   the.  run-time 
2fc0: 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f  memory-mapped I/
2fd0: 4f 20 61 64 64 72 65 73 73 20 73 70 61 63 65 20  O address space 
2fe0: 73 69 7a 65 20 28 73 65 74 20 62 79 0a 20 20 73  size (set by.  s
2ff0: 71 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74  qlite3_file_cont
3000: 72 6f 6c 28 5b 53 51 4c 49 54 45 5f 46 43 4e 54  rol([SQLITE_FCNT
3010: 4c 5f 4d 4d 41 50 5f 53 49 5a 45 5d 29 20 6f 72  L_MMAP_SIZE]) or
3020: 0a 20 20 5b 50 52 41 47 4d 41 20 6d 6d 61 70 5f  .  [PRAGMA mmap_
3030: 73 69 7a 65 5d 29 20 61 73 20 6c 6f 6e 67 20 61  size]) as long a
3040: 73 20 74 68 6f 73 65 20 6f 74 68 65 72 20 73 65  s those other se
3050: 74 74 69 6e 67 73 20 61 72 65 20 6c 65 73 73 20  ttings are less 
3060: 74 68 61 6e 20 74 68 65 0a 20 20 6d 61 78 69 6d  than the.  maxim
3070: 75 6d 20 76 61 6c 75 65 20 64 65 66 69 6e 65 64  um value defined
3080: 20 68 65 72 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c   here..}..COMPIL
3090: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
30a0: 5f 4d 41 58 5f 53 43 48 45 4d 41 5f 52 45 54 52  _MAX_SCHEMA_RETR
30b0: 59 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20  Y=<i>N</i>} {.  
30c0: 57 68 65 6e 65 76 65 72 20 74 68 65 20 64 61 74  Whenever the dat
30d0: 61 62 61 73 65 20 73 63 68 65 6d 61 20 63 68 61  abase schema cha
30e0: 6e 67 65 73 2c 20 70 72 65 70 61 72 65 64 20 73  nges, prepared s
30f0: 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20 61 75  tatements are au
3100: 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20 20 72 65  tomatically.  re
3110: 70 72 65 70 61 72 65 64 20 74 6f 20 61 63 63 6f  prepared to acco
3120: 6d 6d 6f 64 61 74 65 20 74 68 65 20 6e 65 77 20  mmodate the new 
3130: 73 63 68 65 6d 61 2e 20 20 54 68 65 72 65 20 69  schema.  There i
3140: 73 20 61 20 72 61 63 65 20 63 6f 6e 64 69 74 69  s a race conditi
3150: 6f 6e 20 68 65 72 65 0a 20 20 69 6e 20 74 68 61  on here.  in tha
3160: 74 20 69 66 20 6f 6e 65 20 74 68 72 65 61 64 20  t if one thread 
3170: 69 73 20 63 6f 6e 73 74 61 6e 74 6c 79 20 63 68  is constantly ch
3180: 61 6e 67 69 6e 67 20 74 68 65 20 73 63 68 65 6d  anging the schem
3190: 61 2c 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61  a, another threa
31a0: 64 0a 20 20 6d 69 67 68 74 20 73 70 69 6e 20 6f  d.  might spin o
31b0: 6e 20 72 65 70 61 72 73 65 73 20 61 6e 64 20 72  n reparses and r
31c0: 65 70 72 65 70 61 72 61 74 69 6f 6e 73 20 6f 66  epreparations of
31d0: 20 61 20 70 72 65 70 61 72 65 64 20 73 74 61 74   a prepared stat
31e0: 65 6d 65 6e 74 20 61 6e 64 0a 20 20 6e 65 76 65  ement and.  neve
31f0: 72 20 67 65 74 20 61 6e 79 20 72 65 61 6c 20 77  r get any real w
3200: 6f 72 6b 20 64 6f 6e 65 2e 20 20 54 68 69 73 20  ork done.  This 
3210: 70 61 72 61 6d 65 74 65 72 20 70 72 65 76 65 6e  parameter preven
3220: 74 73 20 61 6e 20 69 6e 66 69 6e 69 74 65 20 6c  ts an infinite l
3230: 6f 6f 70 0a 20 20 62 79 20 66 6f 72 63 69 6e 67  oop.  by forcing
3240: 20 74 68 65 20 73 70 69 6e 6e 69 6e 67 20 74 68   the spinning th
3250: 72 65 61 64 20 74 6f 20 67 69 76 65 20 75 70 20  read to give up 
3260: 61 66 74 65 72 20 61 20 66 69 78 65 64 20 6e 75  after a fixed nu
3270: 6d 62 65 72 20 6f 66 20 61 74 74 65 6d 70 74 73  mber of attempts
3280: 0a 20 20 61 74 20 72 65 63 6f 6d 70 69 6c 69 6e  .  at recompilin
3290: 67 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  g the prepared s
32a0: 74 61 74 65 6d 65 6e 74 2e 20 20 54 68 65 20 64  tatement.  The d
32b0: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 69  efault setting i
32c0: 73 20 35 30 20 77 68 69 63 68 20 69 73 0a 20 20  s 50 which is.  
32d0: 6d 6f 72 65 20 74 68 61 6e 20 61 64 65 71 75 61  more than adequa
32e0: 74 65 20 66 6f 72 20 6d 6f 73 74 20 61 70 70 6c  te for most appl
32f0: 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d  ications..}..COM
3300: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
3310: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54  ITE_MAX_WORKER_T
3320: 48 52 45 41 44 53 3d 3c 69 3e 4e 3c 2f 69 3e 7d  HREADS=<i>N</i>}
3330: 20 7b 0a 20 20 53 65 74 20 61 6e 20 75 70 70 65   {.  Set an uppe
3340: 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 20 5b  r bound on the [
3350: 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74 5d 28 64  sqlite3_limit](d
3360: 62 2c 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f  b,[SQLITE_LIMIT_
3370: 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 5d 2c  WORKER_THREADS],
3380: 4e 29 0a 20 20 73 65 74 74 69 6e 67 20 74 68 61  N).  setting tha
3390: 74 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65  t determines the
33a0: 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20   maximum number 
33b0: 6f 66 20 61 75 78 69 6c 69 61 72 79 20 74 68 72  of auxiliary thr
33c0: 65 61 64 73 20 74 68 61 74 20 61 20 73 69 6e 67  eads that a sing
33d0: 6c 65 0a 20 20 5b 70 72 65 70 61 72 65 64 20 73  le.  [prepared s
33e0: 74 61 74 65 6d 65 6e 74 5d 20 77 69 6c 6c 20 75  tatement] will u
33f0: 73 65 20 74 6f 20 61 69 64 20 77 69 74 68 20 43  se to aid with C
3400: 50 55 2d 69 6e 74 65 6e 73 69 76 65 20 63 6f 6d  PU-intensive com
3410: 70 75 74 61 74 69 6f 6e 73 0a 20 20 28 6d 6f 73  putations.  (mos
3420: 74 6c 79 20 73 6f 72 74 69 6e 67 29 2e 20 20 53  tly sorting).  S
3430: 65 65 20 61 6c 73 6f 20 74 68 65 20 5b 53 51 4c  ee also the [SQL
3440: 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b  ITE_DEFAULT_WORK
3450: 45 52 5f 54 48 52 45 41 44 53 5d 20 6f 70 74 69  ER_THREADS] opti
3460: 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ons..}..COMPILE_
3470: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d  OPTION {SQLITE_M
3480: 49 4e 49 4d 55 4d 5f 46 49 4c 45 5f 44 45 53 43  INIMUM_FILE_DESC
3490: 52 49 50 54 4f 52 3d 3c 69 3e 4e 3c 2f 69 3e 7d  RIPTOR=<i>N</i>}
34a0: 20 7b 0a 20 20 54 68 65 20 75 6e 69 78 20 5b 56   {.  The unix [V
34b0: 46 53 5d 20 77 69 6c 6c 20 6e 65 76 65 72 20 75  FS] will never u
34c0: 73 65 20 61 20 66 69 6c 65 20 64 65 73 63 72 69  se a file descri
34d0: 70 74 6f 72 20 6c 65 73 73 20 74 68 61 6e 20 3c  ptor less than <
34e0: 69 3e 4e 3c 2f 69 3e 2e 20 20 54 68 65 0a 20 20  i>N</i>.  The.  
34f0: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66  default value of
3500: 20 3c 69 3e 4e 3c 2f 69 3e 20 69 73 20 33 2e 0a   <i>N</i> is 3..
3510: 20 20 3c 70 3e 0a 20 20 41 76 6f 69 64 69 6e 67    <p>.  Avoiding
3520: 20 74 68 65 20 75 73 65 20 6f 66 20 6c 6f 77 2d   the use of low-
3530: 6e 75 6d 62 65 72 65 64 20 66 69 6c 65 20 64 65  numbered file de
3540: 73 63 72 69 70 74 6f 72 73 20 69 73 20 61 20 64  scriptors is a d
3550: 65 66 65 6e 73 65 20 61 67 61 69 6e 73 74 0a 20  efense against. 
3560: 20 61 63 63 69 64 65 6e 74 61 6c 20 64 61 74 61   accidental data
3570: 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 2e  base corruption.
3580: 20 20 49 66 20 61 20 64 61 74 61 62 61 73 65 20    If a database 
3590: 66 69 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 20  file was opened 
35a0: 75 73 69 6e 67 0a 20 20 66 69 6c 65 20 64 65 73  using.  file des
35b0: 63 72 69 70 74 6f 72 20 32 2c 20 66 6f 72 20 65  criptor 2, for e
35c0: 78 61 6d 70 6c 65 2c 20 61 6e 64 20 74 68 65 6e  xample, and then
35d0: 20 61 6e 20 61 73 73 65 72 74 28 29 20 66 61 69   an assert() fai
35e0: 6c 65 64 20 61 6e 64 20 69 6e 76 6f 6b 65 64 0a  led and invoked.
35f0: 20 20 77 72 69 74 65 28 32 2c 2e 2e 2e 29 2c 20    write(2,...), 
3600: 74 68 61 74 20 77 6f 75 6c 64 20 6c 69 6b 65 6c  that would likel
3610: 79 20 63 61 75 73 65 20 64 61 74 61 62 61 73 65  y cause database
3620: 20 63 6f 72 72 75 70 74 69 6f 6e 20 62 79 20 6f   corruption by o
3630: 76 65 72 77 72 69 74 69 6e 67 0a 20 20 70 61 72  verwriting.  par
3640: 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  t of the databas
3650: 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 20  e file with the 
3660: 61 73 73 65 72 74 69 6f 6e 20 65 72 72 6f 72 20  assertion error 
3670: 6d 65 73 73 61 67 65 2e 20 20 55 73 69 6e 67 20  message.  Using 
3680: 6f 6e 6c 79 0a 20 20 68 69 67 68 65 72 2d 76 61  only.  higher-va
3690: 6c 75 65 64 20 66 69 6c 65 20 64 65 73 63 72 69  lued file descri
36a0: 70 74 6f 72 73 20 61 76 6f 69 64 73 20 74 68 69  ptors avoids thi
36b0: 73 20 70 6f 74 65 6e 74 69 61 6c 20 70 72 6f 62  s potential prob
36c0: 6c 65 6d 2e 20 20 54 68 65 20 0a 20 20 70 72 6f  lem.  The .  pro
36d0: 74 65 63 74 69 6f 6e 20 61 67 61 69 6e 73 74 0a  tection against.
36e0: 20 20 75 73 69 6e 67 20 6c 6f 77 2d 6e 75 6d 62    using low-numb
36f0: 65 72 65 64 20 66 69 6c 65 20 64 65 73 63 72 69  ered file descri
3700: 70 74 6f 72 73 20 63 61 6e 20 62 65 20 64 69 73  ptors can be dis
3710: 61 62 6c 65 64 20 62 79 20 73 65 74 74 69 6e 67  abled by setting
3720: 20 74 68 69 73 0a 20 20 63 6f 6d 70 69 6c 65 2d   this.  compile-
3730: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 74 6f 20 30  time option to 0
3740: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
3750: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 50 4f 57 45  ION {SQLITE_POWE
3760: 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 3d  RSAFE_OVERWRITE=
3770: 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 26 67 74  <i>&lt;0 or 1&gt
3780: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
3790: 6f 70 74 69 6f 6e 20 63 68 61 6e 67 65 73 20 74  option changes t
37a0: 68 65 20 64 65 66 61 75 6c 74 20 61 73 73 75 6d  he default assum
37b0: 70 74 69 6f 6e 20 61 62 6f 75 74 20 5b 70 6f 77  ption about [pow
37c0: 65 72 73 61 66 65 20 6f 76 65 72 77 72 69 74 65  ersafe overwrite
37d0: 5d 0a 20 20 66 6f 72 20 74 68 65 20 75 6e 64 65  ].  for the unde
37e0: 72 6c 79 69 6e 67 20 66 69 6c 65 73 79 73 74 65  rlying filesyste
37f0: 6d 73 20 66 6f 72 20 74 68 65 20 75 6e 69 78 20  ms for the unix 
3800: 61 6e 64 20 77 69 6e 64 6f 77 73 20 5b 56 46 53  and windows [VFS
3810: 65 73 5d 2e 0a 20 20 53 65 74 74 69 6e 67 20 53  es]..  Setting S
3820: 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f  QLITE_POWERSAFE_
3830: 4f 56 45 52 57 52 49 54 45 20 74 6f 20 31 20 63  OVERWRITE to 1 c
3840: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
3850: 61 73 73 75 6d 65 20 74 68 61 74 0a 20 20 61 70  assume that.  ap
3860: 70 6c 69 63 61 74 69 6f 6e 2d 6c 65 76 65 6c 20  plication-level 
3870: 77 72 69 74 65 73 20 63 61 6e 6e 6f 74 20 63 68  writes cannot ch
3880: 61 6e 67 65 73 20 62 79 74 65 73 20 6f 75 74 73  anges bytes outs
3890: 69 64 65 20 74 68 65 20 72 61 6e 67 65 20 6f 66  ide the range of
38a0: 0a 20 20 62 79 74 65 73 20 77 72 69 74 74 65 6e  .  bytes written
38b0: 20 65 76 65 6e 20 69 66 20 74 68 65 20 77 72 69   even if the wri
38c0: 74 65 20 6f 63 63 75 72 73 20 6a 75 73 74 20 62  te occurs just b
38d0: 65 66 6f 72 65 20 61 20 70 6f 77 65 72 20 6c 6f  efore a power lo
38e0: 73 73 2e 0a 20 20 57 69 74 68 20 53 51 4c 49 54  ss..  With SQLIT
38f0: 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52  E_POWERSAFE_OVER
3900: 57 52 49 54 45 20 73 65 74 20 74 6f 20 30 2c 20  WRITE set to 0, 
3910: 53 51 4c 69 74 65 20 61 73 73 75 6d 65 73 20 74  SQLite assumes t
3920: 68 61 74 20 6f 74 68 65 72 0a 20 20 62 79 74 65  hat other.  byte
3930: 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 73 65  s in the same se
3940: 63 74 6f 72 20 77 69 74 68 20 61 20 77 72 69 74  ctor with a writ
3950: 74 65 6e 20 62 79 74 65 20 6d 69 67 68 74 20 62  ten byte might b
3960: 65 20 63 68 61 6e 67 65 64 20 6f 72 20 0a 20 20  e changed or .  
3970: 64 61 6d 61 67 65 64 20 62 79 20 61 20 70 6f 77  damaged by a pow
3980: 65 72 20 6c 6f 73 73 2e 0a 7d 0a 0a 43 4f 4d 50  er loss..}..COMP
3990: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
39a0: 54 45 5f 52 45 56 45 52 53 45 5f 55 4e 4f 52 44  TE_REVERSE_UNORD
39b0: 45 52 45 44 5f 53 45 4c 45 43 54 53 7d 20 7b 0a  ERED_SELECTS} {.
39c0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
39d0: 75 73 65 73 20 74 68 65 20 5b 50 52 41 47 4d 41  uses the [PRAGMA
39e0: 20 72 65 76 65 72 73 65 5f 75 6e 6f 72 64 65 72   reverse_unorder
39f0: 65 64 5f 73 65 6c 65 63 74 73 5d 20 73 65 74 74  ed_selects] sett
3a00: 69 6e 67 20 74 6f 20 62 65 0a 20 20 65 6e 61 62  ing to be.  enab
3a10: 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 20  led by default. 
3a20: 20 57 68 65 6e 20 65 6e 61 62 6c 65 64 2c 20 5b   When enabled, [
3a30: 53 45 4c 45 43 54 5d 20 73 74 61 74 65 6d 65 6e  SELECT] statemen
3a40: 74 73 20 74 68 61 74 20 6c 61 63 6b 20 61 6e 0a  ts that lack an.
3a50: 20 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73    ORDER BY claus
3a60: 65 20 77 69 6c 6c 20 72 75 6e 20 69 6e 20 72 65  e will run in re
3a70: 76 65 72 73 65 20 6f 72 64 65 72 2e 3c 70 3e 0a  verse order.<p>.
3a80: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73    This option is
3a90: 20 75 73 65 66 75 6c 20 66 6f 72 20 64 65 74 65   useful for dete
3aa0: 63 74 69 6e 67 20 77 68 65 6e 20 61 70 70 6c 69  cting when appli
3ab0: 63 61 74 69 6f 6e 73 20 28 69 6e 63 6f 72 72 65  cations (incorre
3ac0: 63 74 6c 79 29 0a 20 20 61 73 73 75 6d 65 20 74  ctly).  assume t
3ad0: 68 61 74 20 74 68 65 20 6f 72 64 65 72 20 6f 66  hat the order of
3ae0: 20 72 6f 77 73 20 69 6e 20 61 20 53 45 4c 45 43   rows in a SELEC
3af0: 54 20 77 69 74 68 6f 75 74 20 61 6e 20 4f 52 44  T without an ORD
3b00: 45 52 20 42 59 20 63 6c 61 75 73 65 0a 20 20 77  ER BY clause.  w
3b10: 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 74 68  ill always be th
3b20: 65 20 73 61 6d 65 2e 0a 7d 0a 0a 43 4f 4d 50 49  e same..}..COMPI
3b30: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
3b40: 45 5f 53 4f 52 54 45 52 5f 50 4d 41 53 5a 3d 3c  E_SORTER_PMASZ=<
3b50: 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 49 66 20  i>N</i>} {.  If 
3b60: 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 70  multi-threaded p
3b70: 72 6f 63 65 73 73 69 6e 67 20 69 73 20 65 6e 61  rocessing is ena
3b80: 62 6c 65 64 20 76 69 61 20 74 68 65 0a 20 20 5b  bled via the.  [
3b90: 50 52 41 47 4d 41 20 74 68 72 65 61 64 73 5d 20  PRAGMA threads] 
3ba0: 73 65 74 74 69 6e 67 2c 20 74 68 65 6e 20 73 6f  setting, then so
3bb0: 72 74 20 6f 70 65 72 61 74 69 6f 6e 73 20 77 69  rt operations wi
3bc0: 6c 6c 0a 20 20 61 74 74 65 6d 70 74 20 74 6f 20  ll.  attempt to 
3bd0: 73 74 61 72 74 20 68 65 6c 70 65 72 20 74 68 72  start helper thr
3be0: 65 61 64 73 20 77 68 65 6e 20 74 68 65 20 61 6d  eads when the am
3bf0: 6f 75 6e 74 20 6f 66 20 63 6f 6e 74 65 6e 74 0a  ount of content.
3c00: 20 20 74 6f 20 62 65 20 73 6f 72 74 65 64 20 65    to be sorted e
3c10: 78 63 65 65 64 73 20 74 68 65 20 6d 69 6e 69 6d  xceeds the minim
3c20: 75 6d 20 6f 66 20 74 68 65 20 5b 63 61 63 68 65  um of the [cache
3c30: 5f 73 69 7a 65 5d 20 61 6e 64 20 50 4d 41 20 53  _size] and PMA S
3c40: 69 7a 65 0a 20 20 64 65 74 65 72 6d 69 6e 65 64  ize.  determined
3c50: 20 62 79 20 74 68 65 20 5b 53 51 4c 49 54 45 5f   by the [SQLITE_
3c60: 43 4f 4e 46 49 47 5f 50 4d 41 53 5a 5d 20 73 74  CONFIG_PMASZ] st
3c70: 61 72 74 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2e  art-time option.
3c80: 0a 20 20 54 68 69 73 20 63 6f 6d 70 69 6c 65 2d  .  This compile-
3c90: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 73 65 74 73  time option sets
3ca0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   the default val
3cb0: 75 65 20 66 6f 72 20 74 68 65 0a 20 20 5b 53 51  ue for the.  [SQ
3cc0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 4d 41 53  LITE_CONFIG_PMAS
3cd0: 5a 5d 20 73 74 61 72 74 2d 74 69 6d 65 20 6f 70  Z] start-time op
3ce0: 74 69 6f 6e 2e 0a 20 20 54 68 65 20 64 65 66 61  tion..  The defa
3cf0: 75 6c 74 20 76 61 6c 75 65 20 69 73 20 32 35 30  ult value is 250
3d00: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
3d10: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 57 49 4e 33  ION {SQLITE_WIN3
3d20: 32 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20 20 54 68  2_MALLOC} {.  Th
3d30: 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65  is option enable
3d40: 73 20 74 68 65 20 75 73 65 20 6f 66 20 74 68 65  s the use of the
3d50: 20 57 69 6e 64 6f 77 73 20 48 65 61 70 20 41 50   Windows Heap AP
3d60: 49 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20  I functions for 
3d70: 6d 65 6d 6f 72 79 0a 20 20 61 6c 6c 6f 63 61 74  memory.  allocat
3d80: 69 6f 6e 20 69 6e 73 74 65 61 64 20 6f 66 20 74  ion instead of t
3d90: 68 65 20 73 74 61 6e 64 61 72 64 20 6c 69 62 72  he standard libr
3da0: 61 72 79 20 6d 61 6c 6c 6f 63 28 29 20 61 6e 64  ary malloc() and
3db0: 20 66 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73   free() routines
3dc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
3dd0: 49 4f 4e 20 7b 59 59 53 54 41 43 4b 44 45 50 54  ION {YYSTACKDEPT
3de0: 48 3d 3c 69 3e 26 6c 74 3b 6d 61 78 5f 64 65 70  H=<i>&lt;max_dep
3df0: 74 68 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20  th&gt;</i>} {.  
3e00: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
3e10: 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70 74  the maximum dept
3e20: 68 20 6f 66 20 74 68 65 20 4c 41 4c 52 28 31 29  h of the LALR(1)
3e30: 20 73 74 61 63 6b 20 75 73 65 64 20 62 79 0a 20   stack used by. 
3e40: 20 74 68 65 20 53 51 4c 20 70 61 72 73 65 72 20   the SQL parser 
3e50: 77 69 74 68 69 6e 20 53 51 4c 69 74 65 2e 20 20  within SQLite.  
3e60: 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75  The default valu
3e70: 65 20 69 73 20 31 30 30 2e 20 20 41 20 74 79 70  e is 100.  A typ
3e80: 69 63 61 6c 0a 20 20 61 70 70 6c 69 63 61 74 69  ical.  applicati
3e90: 6f 6e 20 77 69 6c 6c 20 75 73 65 20 6c 65 73 73  on will use less
3ea0: 20 74 68 61 6e 20 61 62 6f 75 74 20 32 30 20 6c   than about 20 l
3eb0: 65 76 65 6c 73 20 6f 66 20 74 68 65 20 73 74 61  evels of the sta
3ec0: 63 6b 2e 0a 20 20 44 65 76 65 6c 6f 70 65 72 73  ck..  Developers
3ed0: 20 77 68 6f 73 65 20 61 70 70 6c 69 63 61 74 69   whose applicati
3ee0: 6f 6e 73 20 63 6f 6e 74 61 69 6e 20 53 51 4c 20  ons contain SQL 
3ef0: 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20  statements that 
3f00: 0a 20 20 6e 65 65 64 20 6d 6f 72 65 20 74 68 61  .  need more tha
3f10: 6e 20 31 30 30 20 4c 41 4c 52 28 31 29 20 73 74  n 100 LALR(1) st
3f20: 61 63 6b 20 65 6e 74 72 69 65 73 20 73 68 6f 75  ack entries shou
3f30: 6c 64 20 73 65 72 69 6f 75 73 6c 79 0a 20 20 63  ld seriously.  c
3f40: 6f 6e 73 69 64 65 72 20 72 65 66 61 63 74 6f 72  onsider refactor
3f50: 69 6e 67 20 74 68 65 69 72 20 53 51 4c 20 61 73  ing their SQL as
3f60: 20 69 74 20 69 73 20 6c 69 6b 65 6c 79 20 74 6f   it is likely to
3f70: 20 62 65 20 77 65 6c 6c 20 62 65 79 6f 6e 64 0a   be well beyond.
3f80: 20 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f 66    the ability of
3f90: 20 61 6e 79 20 68 75 6d 61 6e 20 74 6f 20 63 6f   any human to co
3fa0: 6d 70 72 65 68 65 6e 64 2e 0a 7d 0a 3c 2f 74 63  mprehend..}.</tc
3fb0: 6c 3e 0a 0a 3c 68 32 3e 31 2e 33 20 4f 70 74 69  l>..<h2>1.3 Opti
3fc0: 6f 6e 73 20 54 6f 20 53 65 74 20 53 69 7a 65 20  ons To Set Size 
3fd0: 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a 0a 3c 70 3e  Limits</h2>..<p>
3fe0: 54 68 65 72 65 20 61 72 65 20 63 6f 6d 70 69 6c  There are compil
3ff0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20 74  e-time options t
4000: 68 61 74 20 77 69 6c 6c 20 73 65 74 20 75 70 70  hat will set upp
4010: 65 72 20 62 6f 75 6e 64 73 0a 6f 6e 20 74 68 65  er bounds.on the
4020: 20 73 69 7a 65 73 20 6f 66 20 76 61 72 69 6f 75   sizes of variou
4030: 73 20 73 74 72 75 63 74 75 72 65 73 20 69 6e 20  s structures in 
4040: 53 51 4c 69 74 65 2e 20 20 54 68 65 20 63 6f 6d  SQLite.  The com
4050: 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f 6e  pile-time.option
4060: 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65 74 20 61  s normally set a
4070: 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75 6e   hard upper boun
4080: 64 20 74 68 61 74 20 63 61 6e 20 62 65 20 63 68  d that can be ch
4090: 61 6e 67 65 64 0a 61 74 20 72 75 6e 2d 74 69 6d  anged.at run-tim
40a0: 65 20 6f 6e 20 69 6e 64 69 76 69 64 75 61 6c 20  e on individual 
40b0: 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63  [database connec
40c0: 74 69 6f 6e 73 5d 20 75 73 69 6e 67 20 74 68 65  tions] using the
40d0: 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74 28  .[sqlite3_limit(
40e0: 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 3c 2f 70  )] interface.</p
40f0: 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d 70 69 6c  >..<p>The compil
4100: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20 66  e-time options f
4110: 6f 72 20 73 65 74 74 69 6e 67 20 75 70 70 65 72  or setting upper
4120: 20 62 6f 75 6e 64 73 20 61 72 65 0a 5b 6c 69 6d   bounds are.[lim
4130: 69 74 73 20 7c 20 64 6f 63 75 6d 65 6e 74 65 64  its | documented
4140: 20 73 65 70 61 72 61 74 65 6c 79 5d 2e 20 20 54   separately].  T
4150: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20  he following is 
4160: 61 20 6c 69 73 74 20 6f 66 0a 74 68 65 20 61 76  a list of.the av
4170: 61 69 6c 61 62 6c 65 20 73 65 74 74 69 6e 67 73  ailable settings
4180: 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e  :</p>..<ul>.<li>
4190: 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54   [SQLITE_MAX_ATT
41a0: 41 43 48 45 44 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  ACHED]  </li>.<l
41b0: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 43  i> [SQLITE_MAX_C
41c0: 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  OLUMN]  </li>.<l
41d0: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 43  i> [SQLITE_MAX_C
41e0: 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 5d 20  OMPOUND_SELECT] 
41f0: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c   </li>.<li> [SQL
4200: 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50  ITE_MAX_EXPR_DEP
4210: 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20  TH]  </li>.<li> 
4220: 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e 43  [SQLITE_MAX_FUNC
4230: 54 49 4f 4e 5f 41 52 47 5d 20 20 3c 2f 6c 69 3e  TION_ARG]  </li>
4240: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41  .<li> [SQLITE_MA
4250: 58 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e  X_LENGTH]  </li>
4260: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41  .<li> [SQLITE_MA
4270: 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f 4c  X_LIKE_PATTERN_L
4280: 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  ENGTH]  </li>.<l
4290: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 50  i> [SQLITE_MAX_P
42a0: 41 47 45 5f 43 4f 55 4e 54 5d 20 20 3c 2f 6c 69  AGE_COUNT]  </li
42b0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
42c0: 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d 20 20  AX_SQL_LENGTH]  
42d0: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49  </li>.<li> [SQLI
42e0: 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f  TE_MAX_VARIABLE_
42f0: 4e 55 4d 42 45 52 5d 20 20 3c 2f 6c 69 3e 0a 3c  NUMBER]  </li>.<
4300: 2f 75 6c 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 63  /ul>..<a name="c
4310: 6f 6e 74 72 6f 6c 66 65 61 74 75 72 65 73 22 3e  ontrolfeatures">
4320: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 34 20 4f 70 74  </a>.<h2>1.4 Opt
4330: 69 6f 6e 73 20 54 6f 20 43 6f 6e 74 72 6f 6c 20  ions To Control 
4340: 4f 70 65 72 61 74 69 6e 67 20 43 68 61 72 61 63  Operating Charac
4350: 74 65 72 69 73 74 69 63 73 3c 2f 68 32 3e 0a 0a  teristics</h2>..
4360: 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50  <tcl>.COMPILE_OP
4370: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 34 5f 42  TION {SQLITE_4_B
4380: 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c  YTE_ALIGNED_MALL
4390: 4f 43 7d 20 7b 0a 20 20 4f 6e 20 6d 6f 73 74 20  OC} {.  On most 
43a0: 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 61 6c  systems, the mal
43b0: 6c 6f 63 28 29 20 73 79 73 74 65 6d 20 63 61 6c  loc() system cal
43c0: 6c 20 72 65 74 75 72 6e 73 20 61 20 62 75 66 66  l returns a buff
43d0: 65 72 20 74 68 61 74 20 69 73 0a 20 20 61 6c 69  er that is.  ali
43e0: 67 6e 65 64 20 74 6f 20 61 6e 20 38 2d 62 79 74  gned to an 8-byt
43f0: 65 20 62 6f 75 6e 64 61 72 79 2e 20 20 42 75 74  e boundary.  But
4400: 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 65 6d 73   on some systems
4410: 20 28 65 78 3a 20 77 69 6e 64 6f 77 73 29 20 6d   (ex: windows) m
4420: 61 6c 6c 6f 63 28 29 0a 20 20 72 65 74 75 72 6e  alloc().  return
4430: 73 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65 64  s 4-byte aligned
4440: 20 70 6f 69 6e 74 65 72 2e 20 20 54 68 69 73 20   pointer.  This 
4450: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
4460: 69 6f 6e 20 6d 75 73 74 20 62 65 20 75 73 65 64  ion must be used
4470: 0a 20 20 6f 6e 20 73 79 73 74 65 6d 73 20 74 68  .  on systems th
4480: 61 74 20 72 65 74 75 72 6e 20 34 2d 62 79 74 65  at return 4-byte
4490: 20 61 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65 72   aligned pointer
44a0: 73 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28 29 2e  s from malloc().
44b0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
44c0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 43 41 53 45 5f  ON {SQLITE_CASE_
44d0: 53 45 4e 53 49 54 49 56 45 5f 4c 49 4b 45 7d 20  SENSITIVE_LIKE} 
44e0: 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69  {.  If this opti
44f0: 6f 6e 20 69 73 20 70 72 65 73 65 6e 74 2c 20 74  on is present, t
4500: 68 65 6e 20 74 68 65 20 62 75 69 6c 74 2d 69 6e  hen the built-in
4510: 20 5b 4c 49 4b 45 5d 20 6f 70 65 72 61 74 6f 72   [LIKE] operator
4520: 20 77 69 6c 6c 20 62 65 0a 20 20 63 61 73 65 20   will be.  case 
4530: 73 65 6e 73 69 74 69 76 65 2e 20 20 54 68 69 73  sensitive.  This
4540: 20 73 61 6d 65 20 65 66 66 65 63 74 20 63 61 6e   same effect can
4550: 20 62 65 20 61 63 68 69 65 76 65 64 20 61 74 20   be achieved at 
4560: 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 0a 20  run-time using. 
4570: 20 74 68 65 20 5b 63 61 73 65 5f 73 65 6e 73 69   the [case_sensi
4580: 74 69 76 65 5f 6c 69 6b 65 20 70 72 61 67 6d 61  tive_like pragma
4590: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
45a0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 52  TION {SQLITE_DIR
45b0: 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41  ECT_OVERFLOW_REA
45c0: 44 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  D} {.  When this
45d0: 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65   option is prese
45e0: 6e 74 2c 20 63 6f 6e 74 65 6e 74 20 63 6f 6e 74  nt, content cont
45f0: 61 69 6e 65 64 20 69 6e 0a 20 20 5b 6f 76 65 72  ained in.  [over
4600: 66 6c 6f 77 20 70 61 67 65 73 5d 20 6f 66 20 74  flow pages] of t
4610: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
4620: 20 69 73 20 72 65 61 64 20 64 69 72 65 63 74 6c   is read directl
4630: 79 20 66 72 6f 6d 20 64 69 73 6b 2c 0a 20 20 62  y from disk,.  b
4640: 79 70 61 73 73 69 6e 67 20 74 68 65 20 5b 70 61  ypassing the [pa
4650: 67 65 20 63 61 63 68 65 5d 2c 20 64 75 72 69 6e  ge cache], durin
4660: 67 20 72 65 61 64 20 74 72 61 6e 73 61 63 74 69  g read transacti
4670: 6f 6e 73 2e 20 20 49 6e 20 61 70 70 6c 69 63 61  ons.  In applica
4680: 74 69 6f 6e 73 0a 20 20 74 68 61 74 20 64 6f 20  tions.  that do 
4690: 61 20 6c 6f 74 20 6f 66 20 72 65 61 64 73 20 6f  a lot of reads o
46a0: 66 20 6c 61 72 67 65 20 42 4c 4f 42 73 2c 20 74  f large BLOBs, t
46b0: 68 69 73 20 6f 70 74 69 6f 6e 20 6d 69 67 68 74  his option might
46c0: 20 69 6d 70 72 6f 76 65 20 72 65 61 64 0a 20 20   improve read.  
46d0: 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 7d 0a 0a  performance..}..
46e0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
46f0: 53 51 4c 49 54 45 5f 48 41 56 45 5f 49 53 4e 41  SQLITE_HAVE_ISNA
4700: 4e 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f  N} {.  If this o
4710: 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e 74  ption is present
4720: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 77 69  , then SQLite wi
4730: 6c 6c 20 75 73 65 20 74 68 65 20 69 73 6e 61 6e  ll use the isnan
4740: 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f 6d  () function from
4750: 0a 20 20 74 68 65 20 73 79 73 74 65 6d 20 6d 61  .  the system ma
4760: 74 68 20 6c 69 62 72 61 72 79 2e 20 20 54 68 69  th library.  Thi
4770: 73 20 69 73 20 61 6e 20 61 6c 69 61 73 20 66 6f  s is an alias fo
4780: 72 20 74 68 65 20 5b 48 41 56 45 5f 49 53 4e 41  r the [HAVE_ISNA
4790: 4e 5d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  N] configuration
47a0: 0a 20 20 6f 70 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f  .  option..}..CO
47b0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
47c0: 4c 49 54 45 5f 4f 53 5f 4f 54 48 45 52 3d 3c 69  LITE_OS_OTHER=<i
47d0: 3e 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c  >&lt;0 or 1&gt;<
47e0: 2f 69 3e 7d 20 7b 0a 20 20 54 68 65 20 6f 70 74  /i>} {.  The opt
47f0: 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74  ion causes SQLit
4800: 65 20 74 6f 20 6f 6d 69 74 20 69 74 73 20 62 75  e to omit its bu
4810: 69 6c 74 2d 69 6e 20 6f 70 65 72 61 74 69 6e 67  ilt-in operating
4820: 20 73 79 73 74 65 6d 20 69 6e 74 65 72 66 61 63   system interfac
4830: 65 73 0a 20 20 66 6f 72 20 55 6e 69 78 2c 20 57  es.  for Unix, W
4840: 69 6e 64 6f 77 73 2c 20 61 6e 64 20 4f 53 2f 32  indows, and OS/2
4850: 2e 20 20 54 68 65 20 72 65 73 75 6c 74 69 6e 67  .  The resulting
4860: 20 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 68 61   library will ha
4870: 76 65 20 6e 6f 20 64 65 66 61 75 6c 74 0a 20 20  ve no default.  
4880: 5b 73 71 6c 69 74 65 33 5f 76 66 73 20 7c 20 6f  [sqlite3_vfs | o
4890: 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20  perating system 
48a0: 69 6e 74 65 72 66 61 63 65 5d 2e 20 20 41 70 70  interface].  App
48b0: 6c 69 63 61 74 69 6f 6e 73 20 6d 75 73 74 20 75  lications must u
48c0: 73 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 76 66  se.  [sqlite3_vf
48d0: 73 5f 72 65 67 69 73 74 65 72 28 29 5d 20 74 6f  s_register()] to
48e0: 20 72 65 67 69 73 74 65 72 20 61 6e 20 61 70 70   register an app
48f0: 72 6f 70 72 69 61 74 65 20 69 6e 74 65 72 66 61  ropriate interfa
4900: 63 65 20 62 65 66 6f 72 65 0a 20 20 75 73 69 6e  ce before.  usin
4910: 67 20 53 51 4c 69 74 65 2e 20 20 41 70 70 6c 69  g SQLite.  Appli
4920: 63 61 74 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73  cations must als
4930: 6f 20 73 75 70 70 6c 79 20 69 6d 70 6c 65 6d 65  o supply impleme
4940: 6e 74 61 74 69 6f 6e 73 20 66 6f 72 20 74 68 65  ntations for the
4950: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69  .  [sqlite3_os_i
4960: 6e 69 74 28 29 5d 20 61 6e 64 20 5b 73 71 6c 69  nit()] and [sqli
4970: 74 65 33 5f 6f 73 5f 65 6e 64 28 29 5d 20 69 6e  te3_os_end()] in
4980: 74 65 72 66 61 63 65 73 2e 20 20 54 68 65 20 75  terfaces.  The u
4990: 73 75 61 6c 20 70 72 61 63 74 69 63 65 0a 20 20  sual practice.  
49a0: 69 73 20 66 6f 72 20 74 68 65 20 73 75 70 70 6c  is for the suppl
49b0: 69 65 64 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f  ied [sqlite3_os_
49c0: 69 6e 69 74 28 29 5d 20 74 6f 20 69 6e 76 6f 6b  init()] to invok
49d0: 65 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 5f 72  e [sqlite3_vfs_r
49e0: 65 67 69 73 74 65 72 28 29 5d 2e 0a 20 20 53 51  egister()]..  SQ
49f0: 4c 69 74 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61  Lite will automa
4a00: 74 69 63 61 6c 6c 79 20 69 6e 76 6f 6b 65 20 5b  tically invoke [
4a10: 73 71 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28  sqlite3_os_init(
4a20: 29 5d 20 77 68 65 6e 20 69 74 20 69 6e 69 74 69  )] when it initi
4a30: 61 6c 69 7a 65 73 2e 0a 0a 20 20 54 68 69 73 20  alizes...  This 
4a40: 6f 70 74 69 6f 6e 20 69 73 20 74 79 70 69 63 61  option is typica
4a50: 6c 6c 79 20 75 73 65 64 20 77 68 65 6e 20 62 75  lly used when bu
4a60: 69 6c 64 69 6e 67 20 53 51 4c 69 74 65 20 66 6f  ilding SQLite fo
4a70: 72 20 61 6e 20 65 6d 62 65 64 64 65 64 0a 20 20  r an embedded.  
4a80: 70 6c 61 74 66 6f 72 6d 20 77 69 74 68 20 61 20  platform with a 
4a90: 63 75 73 74 6f 6d 20 6f 70 65 72 61 74 69 6e 67  custom operating
4aa0: 20 73 79 73 74 65 6d 2e 0a 7d 0a 0a 43 4f 4d 50   system..}..COMP
4ab0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
4ac0: 54 45 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45  TE_SECURE_DELETE
4ad0: 7d 20 7b 0a 20 20 54 68 69 73 20 63 6f 6d 70 69  } {.  This compi
4ae0: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 63  le-time option c
4af0: 68 61 6e 67 65 73 20 74 68 65 20 64 65 66 61 75  hanges the defau
4b00: 6c 74 20 73 65 74 74 69 6e 67 20 6f 66 20 74 68  lt setting of th
4b10: 65 0a 20 20 5b 73 65 63 75 72 65 5f 64 65 6c 65  e.  [secure_dele
4b20: 74 65 20 70 72 61 67 6d 61 5d 2e 20 20 57 68 65  te pragma].  Whe
4b30: 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  n this option is
4b40: 20 6e 6f 74 20 75 73 65 64 2c 20 73 65 63 75 72   not used, secur
4b50: 65 5f 64 65 6c 65 74 65 20 64 65 66 61 75 6c 74  e_delete default
4b60: 73 0a 20 20 74 6f 20 6f 66 66 2e 20 20 57 68 65  s.  to off.  Whe
4b70: 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  n this option is
4b80: 20 70 72 65 73 65 6e 74 2c 20 73 65 63 75 72 65   present, secure
4b90: 5f 64 65 6c 65 74 65 20 64 65 66 61 75 6c 74 73  _delete defaults
4ba0: 20 74 6f 20 6f 6e 2e 0a 0a 20 20 54 68 65 20 73   to on...  The s
4bb0: 65 63 75 72 65 5f 64 65 6c 65 74 65 20 73 65 74  ecure_delete set
4bc0: 74 69 6e 67 20 63 61 75 73 65 73 20 64 65 6c 65  ting causes dele
4bd0: 74 65 64 20 63 6f 6e 74 65 6e 74 20 74 6f 20 62  ted content to b
4be0: 65 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69  e overwritten wi
4bf0: 74 68 0a 20 20 7a 65 72 6f 73 2e 20 20 54 68 65  th.  zeros.  The
4c00: 72 65 20 69 73 20 61 20 73 6d 61 6c 6c 20 70 65  re is a small pe
4c10: 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e 61 6c 74  rformance penalt
4c20: 79 20 73 69 6e 63 65 20 61 64 64 69 74 69 6f 6e  y since addition
4c30: 61 6c 20 49 2f 4f 0a 20 20 6d 75 73 74 20 6f 63  al I/O.  must oc
4c40: 63 75 72 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68  cur.  On the oth
4c50: 65 72 20 68 61 6e 64 2c 20 73 65 63 75 72 65 5f  er hand, secure_
4c60: 64 65 6c 65 74 65 20 63 61 6e 20 70 72 65 76 65  delete can preve
4c70: 6e 74 20 66 72 61 67 6d 65 6e 74 73 20 6f 66 20  nt fragments of 
4c80: 0a 20 20 73 65 6e 73 69 74 69 76 65 20 69 6e 66  .  sensitive inf
4c90: 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 6c 69  ormation from li
4ca0: 6e 67 65 72 69 6e 67 20 69 6e 20 75 6e 75 73 65  ngering in unuse
4cb0: 64 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 64  d parts of the d
4cc0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 0a 20 20  atabase file .  
4cd0: 61 66 74 65 72 20 69 74 20 68 61 73 20 62 65 65  after it has bee
4ce0: 6e 20 64 65 6c 65 74 65 64 2e 20 20 53 65 65 20  n deleted.  See 
4cf0: 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f  the documentatio
4d00: 6e 20 6f 6e 20 74 68 65 0a 20 20 5b 73 65 63 75  n on the.  [secu
4d10: 72 65 5f 64 65 6c 65 74 65 20 70 72 61 67 6d 61  re_delete pragma
4d20: 5d 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  ] for additional
4d30: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a   information..}.
4d40: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4d50: 7b 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41  {SQLITE_THREADSA
4d60: 46 45 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31  FE=<i>&lt;0 or 1
4d70: 20 6f 72 20 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b   or 2&gt;</i>} {
4d80: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
4d90: 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20  ontrols whether 
4da0: 6f 72 20 6e 6f 74 20 63 6f 64 65 20 69 73 20 69  or not code is i
4db0: 6e 63 6c 75 64 65 64 20 69 6e 20 53 51 4c 69 74  ncluded in SQLit
4dc0: 65 20 74 6f 0a 20 20 65 6e 61 62 6c 65 20 69 74  e to.  enable it
4dd0: 20 74 6f 20 6f 70 65 72 61 74 65 20 73 61 66 65   to operate safe
4de0: 6c 79 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72  ly in a multithr
4df0: 65 61 64 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e  eaded environmen
4e00: 74 2e 20 20 54 68 65 0a 20 20 64 65 66 61 75 6c  t.  The.  defaul
4e10: 74 20 69 73 20 53 51 4c 49 54 45 5f 54 48 52 45  t is SQLITE_THRE
4e20: 41 44 53 41 46 45 3d 31 20 77 68 69 63 68 20 69  ADSAFE=1 which i
4e30: 73 20 73 61 66 65 20 66 6f 72 20 75 73 65 20 69  s safe for use i
4e40: 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65  n a multithreade
4e50: 64 0a 20 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e  d.  environment.
4e60: 20 20 57 68 65 6e 20 63 6f 6d 70 69 6c 65 64 20    When compiled 
4e70: 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52 45  with SQLITE_THRE
4e80: 41 44 53 41 46 45 3d 30 20 61 6c 6c 20 6d 75 74  ADSAFE=0 all mut
4e90: 65 78 69 6e 67 20 63 6f 64 65 0a 20 20 69 73 20  exing code.  is 
4ea0: 6f 6d 69 74 74 65 64 20 61 6e 64 20 69 74 20 69  omitted and it i
4eb0: 73 20 75 6e 73 61 66 65 20 74 6f 20 75 73 65 20  s unsafe to use 
4ec0: 53 51 4c 69 74 65 20 69 6e 20 61 20 6d 75 6c 74  SQLite in a mult
4ed0: 69 74 68 72 65 61 64 65 64 20 70 72 6f 67 72 61  ithreaded progra
4ee0: 6d 2e 0a 20 20 57 68 65 6e 20 63 6f 6d 70 69 6c  m..  When compil
4ef0: 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54  ed with SQLITE_T
4f00: 48 52 45 41 44 53 41 46 45 3d 32 2c 20 53 51 4c  HREADSAFE=2, SQL
4f10: 69 74 65 20 63 61 6e 20 62 65 20 75 73 65 64 20  ite can be used 
4f20: 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64  in a multithread
4f30: 65 64 0a 20 20 70 72 6f 67 72 61 6d 20 73 6f 20  ed.  program so 
4f40: 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20 74  long as no two t
4f50: 68 72 65 61 64 73 20 61 74 74 65 6d 70 74 20 74  hreads attempt t
4f60: 6f 20 75 73 65 20 74 68 65 20 73 61 6d 65 0a 20  o use the same. 
4f70: 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65   [database conne
4f80: 63 74 69 6f 6e 5d 20 28 6f 72 20 61 6e 79 20 5b  ction] (or any [
4f90: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
4fa0: 6e 74 73 5d 20 64 65 72 69 76 65 64 20 66 72 6f  nts] derived fro
4fb0: 6d 0a 20 20 74 68 61 74 20 64 61 74 61 62 61 73  m.  that databas
4fc0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 20 61 74  e connection) at
4fd0: 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a   the same time..
4fe0: 0a 20 20 54 6f 20 70 75 74 20 69 74 20 61 6e 6f  .  To put it ano
4ff0: 74 68 65 72 20 77 61 79 2c 20 53 51 4c 49 54 45  ther way, SQLITE
5000: 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 73 65  _THREADSAFE=1 se
5010: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20  ts the default. 
5020: 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65   [threading mode
5030: 5d 20 74 6f 20 53 65 72 69 61 6c 69 7a 65 64 2e  ] to Serialized.
5040: 20 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53    SQLITE_THREADS
5050: 41 46 45 3d 32 20 73 65 74 73 20 74 68 65 20 64  AFE=2 sets the d
5060: 65 66 61 75 6c 74 0a 20 20 5b 74 68 72 65 61 64  efault.  [thread
5070: 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 4d 75 6c  ing mode] to Mul
5080: 74 69 2d 74 68 72 65 61 64 65 64 2e 20 20 41 6e  ti-threaded.  An
5090: 64 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  d SQLITE_THREADS
50a0: 41 46 45 3d 30 20 73 65 74 73 20 74 68 65 0a 20  AFE=0 sets the. 
50b0: 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65   [threading mode
50c0: 5d 20 74 6f 20 53 69 6e 67 6c 65 2d 74 68 72 65  ] to Single-thre
50d0: 61 64 65 64 2e 0a 0a 20 20 54 68 65 20 76 61 6c  aded...  The val
50e0: 75 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 48 52  ue of SQLITE_THR
50f0: 45 41 44 53 41 46 45 20 63 61 6e 20 62 65 20 64  EADSAFE can be d
5100: 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 75 6e  etermined at run
5110: 2d 74 69 6d 65 0a 20 20 75 73 69 6e 67 20 74 68  -time.  using th
5120: 65 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65 61  e [sqlite3_threa
5130: 64 73 61 66 65 28 29 5d 20 69 6e 74 65 72 66 61  dsafe()] interfa
5140: 63 65 2e 0a 0a 20 20 57 68 65 6e 20 53 51 4c 69  ce...  When SQLi
5150: 74 65 20 68 61 73 20 62 65 65 6e 20 63 6f 6d 70  te has been comp
5160: 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45  iled with SQLITE
5170: 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 6f 72  _THREADSAFE=1 or
5180: 0a 20 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  .  SQLITE_THREAD
5190: 53 41 46 45 3d 32 20 74 68 65 6e 20 74 68 65 20  SAFE=2 then the 
51a0: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
51b0: 0a 20 20 63 61 6e 20 62 65 20 61 6c 74 65 72 65  .  can be altere
51c0: 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73  d at run-time us
51d0: 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33  ing the [sqlite3
51e0: 5f 63 6f 6e 66 69 67 28 29 5d 20 69 6e 74 65 72  _config()] inter
51f0: 66 61 63 65 20 74 6f 67 65 74 68 65 72 0a 20 20  face together.  
5200: 77 69 74 68 20 6f 6e 65 20 6f 66 20 74 68 65 73  with one of thes
5210: 65 20 76 65 72 62 73 3a 0a 0a 20 20 3c 75 6c 3e  e verbs:..  <ul>
5220: 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f 43  .  <li>[SQLITE_C
5230: 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45  ONFIG_SINGLETHRE
5240: 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49 54  AD].  <li>[SQLIT
5250: 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48  E_CONFIG_MULTITH
5260: 52 45 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c  READ].  <li>[SQL
5270: 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 41  ITE_CONFIG_SERIA
5280: 4c 49 5a 45 44 5d 0a 20 20 3c 2f 75 6c 3e 0a 0a  LIZED].  </ul>..
5290: 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f 4f 50    The [SQLITE_OP
52a0: 45 4e 5f 4e 4f 4d 55 54 45 58 5d 20 61 6e 64 0a  EN_NOMUTEX] and.
52b0: 20 20 5b 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46    [SQLITE_OPEN_F
52c0: 55 4c 4c 4d 55 54 45 58 5d 20 66 6c 61 67 73 20  ULLMUTEX] flags 
52d0: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  to [sqlite3_open
52e0: 5f 76 32 28 29 5d 20 63 61 6e 20 61 6c 73 6f 20  _v2()] can also 
52f0: 62 65 20 75 73 65 64 0a 20 20 74 6f 20 61 64 6a  be used.  to adj
5300: 75 73 74 20 74 68 65 20 5b 74 68 72 65 61 64 69  ust the [threadi
5310: 6e 67 20 6d 6f 64 65 5d 20 6f 66 20 69 6e 64 69  ng mode] of indi
5320: 76 69 64 75 61 6c 20 5b 64 61 74 61 62 61 73 65  vidual [database
5330: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 0a 20 20   connections].  
5340: 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a 20 20  at run-time...  
5350: 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 53  Note that when S
5360: 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65  QLite is compile
5370: 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48  d with SQLITE_TH
5380: 52 45 41 44 53 41 46 45 3d 30 2c 20 74 68 65 20  READSAFE=0, the 
5390: 63 6f 64 65 0a 20 20 74 6f 20 6d 61 6b 65 20 53  code.  to make S
53a0: 51 4c 69 74 65 20 74 68 72 65 61 64 73 61 66 65  QLite threadsafe
53b0: 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d   is omitted from
53c0: 20 74 68 65 20 62 75 69 6c 64 2e 20 20 57 68 65   the build.  Whe
53d0: 6e 20 74 68 69 73 20 6f 63 63 75 72 73 2c 0a 20  n this occurs,. 
53e0: 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c   it is impossibl
53f0: 65 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20  e to change the 
5400: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
5410: 20 61 74 20 73 74 61 72 74 2d 74 69 6d 65 20 6f   at start-time o
5420: 72 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a 20 20 53  r run-time...  S
5430: 65 65 20 74 68 65 20 5b 74 68 72 65 61 64 69 6e  ee the [threadin
5440: 67 20 6d 6f 64 65 5d 20 64 6f 63 75 6d 65 6e 74  g mode] document
5450: 61 74 69 6f 6e 20 66 6f 72 20 61 64 64 69 74 69  ation for additi
5460: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
5470: 0a 20 20 6f 6e 20 61 73 70 65 63 74 73 20 6f 66  .  on aspects of
5480: 20 75 73 69 6e 67 20 53 51 4c 69 74 65 20 69 6e   using SQLite in
5490: 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64   a multithreaded
54a0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 0a 7d 0a   environment..}.
54b0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
54c0: 7b 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f  {SQLITE_TEMP_STO
54d0: 52 45 3d 3c 69 3e 26 6c 74 3b 30 20 74 68 72 6f  RE=<i>&lt;0 thro
54e0: 75 67 68 20 33 26 67 74 3b 3c 2f 69 3e 7d 20 7b  ugh 3&gt;</i>} {
54f0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
5500: 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20  ontrols whether 
5510: 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20  temporary files 
5520: 61 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69  are stored on di
5530: 73 6b 20 6f 72 0a 20 20 69 6e 20 6d 65 6d 6f 72  sk or.  in memor
5540: 79 2e 20 20 54 68 65 20 6d 65 61 6e 69 6e 67 73  y.  The meanings
5550: 20 66 6f 72 20 76 61 72 69 6f 75 73 20 73 65 74   for various set
5560: 74 69 6e 67 73 20 6f 66 20 74 68 69 73 20 63 6f  tings of this co
5570: 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70 74  mpile-time.  opt
5580: 69 6f 6e 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f  ion are as follo
5590: 77 73 3a 0a 0a 20 20 3c 74 61 62 6c 65 20 63 65  ws:..  <table ce
55a0: 6c 6c 70 61 64 64 69 6e 67 3d 22 32 22 20 62 6f  llpadding="2" bo
55b0: 72 64 65 72 3d 22 31 22 3e 0a 20 20 3c 74 72 3e  rder="1">.  <tr>
55c0: 3c 74 68 3e 53 51 4c 49 54 45 5f 54 45 4d 50 5f  <th>SQLITE_TEMP_
55d0: 53 54 4f 52 45 3c 2f 74 68 3e 3c 74 68 3e 4d 65  STORE</th><th>Me
55e0: 61 6e 69 6e 67 3c 2f 74 68 3e 3c 2f 74 72 3e 0a  aning</th></tr>.
55f0: 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d    <tr><td align=
5600: 22 63 65 6e 74 65 72 22 3e 30 3c 2f 74 64 3e 3c  "center">0</td><
5610: 74 64 3e 41 6c 77 61 79 73 20 75 73 65 20 74 65  td>Always use te
5620: 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 3c 2f 74  mporary files</t
5630: 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74  d></tr>.  <tr><t
5640: 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22  d align="center"
5650: 3e 31 3c 2f 74 64 3e 3c 74 64 3e 55 73 65 20 66  >1</td><td>Use f
5660: 69 6c 65 73 20 62 79 20 64 65 66 61 75 6c 74 20  iles by default 
5670: 62 75 74 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20  but allow the.  
5680: 5b 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 74 6f  [PRAGMA temp_sto
5690: 72 65 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f  re] command to o
56a0: 76 65 72 72 69 64 65 3c 2f 74 64 3e 3c 2f 74 72  verride</td></tr
56b0: 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67  >.  <tr><td alig
56c0: 6e 3d 22 63 65 6e 74 65 72 22 3e 32 3c 2f 74 64  n="center">2</td
56d0: 3e 3c 74 64 3e 55 73 65 20 6d 65 6d 6f 72 79 20  ><td>Use memory 
56e0: 62 79 20 64 65 66 61 75 6c 74 20 62 75 74 20 61  by default but a
56f0: 6c 6c 6f 77 20 74 68 65 0a 20 20 5b 50 52 41 47  llow the.  [PRAG
5700: 4d 41 20 74 65 6d 70 5f 73 74 6f 72 65 5d 20 63  MA temp_store] c
5710: 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76 65 72 72 69  ommand to overri
5720: 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c  de</td></tr>.  <
5730: 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65  tr><td align="ce
5740: 6e 74 65 72 22 3e 33 3c 2f 74 64 3e 3c 74 64 3e  nter">3</td><td>
5750: 41 6c 77 61 79 73 20 75 73 65 20 6d 65 6d 6f 72  Always use memor
5760: 79 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 2f  y</td></tr>.  </
5770: 74 61 62 6c 65 3e 0a 0a 20 20 54 68 65 20 64 65  table>..  The de
5780: 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 69 73  fault setting is
5790: 20 31 2e 20 20 0a 20 20 41 64 64 69 74 69 6f 6e   1.  .  Addition
57a0: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63  al information c
57b0: 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 5b  an be found in [
57c0: 74 65 6d 70 73 74 6f 72 65 20 7c 20 74 65 6d 70  tempstore | temp
57d0: 66 69 6c 65 73 2e 68 74 6d 6c 5d 2e 0a 7d 0a 0a  files.html]..}..
57e0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
57f0: 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 53 49 5a  SQLITE_TRACE_SIZ
5800: 45 5f 4c 49 4d 49 54 3d 3c 69 3e 4e 3c 2f 69 3e  E_LIMIT=<i>N</i>
5810: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6d 61  } {.  If this ma
5820: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 20 74  cro is defined t
5830: 6f 20 61 20 70 6f 73 69 74 69 76 65 20 69 6e 74  o a positive int
5840: 65 67 65 72 20 3c 69 3e 4e 3c 2f 69 3e 2c 20 74  eger <i>N</i>, t
5850: 68 65 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f  hen the length o
5860: 66 0a 20 20 73 74 72 69 6e 67 73 20 61 6e 64 20  f.  strings and 
5870: 42 4c 4f 42 20 74 68 61 74 20 61 72 65 20 65 78  BLOB that are ex
5880: 70 61 6e 64 65 64 20 69 6e 74 6f 20 70 61 72 61  panded into para
5890: 6d 65 74 65 72 73 20 69 6e 20 74 68 65 20 6f 75  meters in the ou
58a0: 74 70 75 74 20 6f 66 0a 20 20 5b 73 71 6c 69 74  tput of.  [sqlit
58b0: 65 33 5f 74 72 61 63 65 28 29 5d 20 69 73 20 6c  e3_trace()] is l
58c0: 69 6d 69 74 65 64 20 74 6f 20 3c 69 3e 4e 3c 2f  imited to <i>N</
58d0: 69 3e 20 62 79 74 65 73 2e 20 20 0a 7d 0a 0a 43  i> bytes.  .}..C
58e0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
58f0: 51 4c 49 54 45 5f 55 53 45 5f 55 52 49 7d 20 7b  QLITE_USE_URI} {
5900: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
5910: 61 75 73 65 73 20 74 68 65 20 5b 55 52 49 20 66  auses the [URI f
5920: 69 6c 65 6e 61 6d 65 5d 20 70 72 6f 63 65 73 73  ilename] process
5930: 20 6c 6f 67 69 63 20 74 6f 20 62 65 20 65 6e 61   logic to be ena
5940: 62 6c 65 64 20 62 79 20 0a 20 20 64 65 66 61 75  bled by .  defau
5950: 6c 74 2e 20 20 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a  lt.  .}..</tcl>.
5960: 0a 3c 61 20 6e 61 6d 65 3d 22 65 6e 61 62 6c 65  .<a name="enable
5970: 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c  features"></a>.<
5980: 68 32 3e 31 2e 35 20 4f 70 74 69 6f 6e 73 20 54  h2>1.5 Options T
5990: 6f 20 45 6e 61 62 6c 65 20 46 65 61 74 75 72 65  o Enable Feature
59a0: 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65  s Normally Turne
59b0: 64 20 4f 66 66 3c 2f 68 32 3e 0a 0a 3c 74 63 6c  d Off</h2>..<tcl
59c0: 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  >.COMPILE_OPTION
59d0: 20 7b 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55   {SQLITE_ALLOW_U
59e0: 52 49 5f 41 55 54 48 4f 52 49 54 59 7d 20 7b 0a  RI_AUTHORITY} {.
59f0: 20 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65 73    [URI filenames
5a00: 5d 20 6e 6f 72 6d 61 6c 6c 79 20 74 68 72 6f 77  ] normally throw
5a10: 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68  s an error if th
5a20: 65 20 61 75 74 68 6f 72 69 74 79 20 73 65 63 74  e authority sect
5a30: 69 6f 6e 20 69 73 0a 20 20 6e 6f 74 20 65 69 74  ion is.  not eit
5a40: 68 65 72 20 65 6d 70 74 79 20 6f 72 20 22 6c 6f  her empty or "lo
5a50: 63 61 6c 68 6f 73 74 22 2e 20 20 48 6f 77 65 76  calhost".  Howev
5a60: 65 72 2c 20 69 66 20 53 51 4c 69 74 65 20 69 73  er, if SQLite is
5a70: 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 0a 20   compiled with. 
5a80: 20 74 68 65 20 53 51 4c 49 54 45 5f 41 4c 4c 4f   the SQLITE_ALLO
5a90: 57 5f 55 52 49 5f 41 55 54 48 4f 52 49 54 59 20  W_URI_AUTHORITY 
5aa0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
5ab0: 69 6f 6e 2c 20 74 68 65 6e 20 74 68 65 20 55 52  ion, then the UR
5ac0: 49 20 69 73 0a 20 20 63 6f 6e 76 65 72 74 65 64  I is.  converted
5ad0: 20 69 6e 74 6f 20 61 20 55 6e 69 66 6f 72 6d 20   into a Uniform 
5ae0: 4e 61 6d 69 6e 67 20 43 6f 6e 76 65 6e 74 69 6f  Naming Conventio
5af0: 6e 20 28 55 4e 43 29 20 66 69 6c 65 6e 61 6d 65  n (UNC) filename
5b00: 20 61 6e 64 20 70 61 73 73 65 64 0a 20 20 64 6f   and passed.  do
5b10: 77 6e 20 74 6f 20 74 68 65 20 75 6e 64 65 72 6c  wn to the underl
5b20: 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67 20 73  ying operating s
5b30: 79 73 74 65 6d 20 74 68 61 74 20 77 61 79 2e 20  ystem that way. 
5b40: 20 0a 20 20 3c 70 3e 0a 20 20 53 6f 6d 65 20 66   .  <p>.  Some f
5b50: 75 74 75 72 65 20 76 65 72 73 69 6f 6e 73 20 6f  uture versions o
5b60: 66 20 53 51 4c 69 74 65 20 6d 61 79 20 63 68 61  f SQLite may cha
5b70: 6e 67 65 20 74 6f 20 65 6e 61 62 6c 65 20 74 68  nge to enable th
5b80: 69 73 20 66 65 61 74 75 72 65 0a 20 20 62 79 20  is feature.  by 
5b90: 64 65 66 61 75 6c 74 2e 0a 7d 0a 43 4f 4d 50 49  default..}.COMPI
5ba0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
5bb0: 45 5f 41 4c 4c 4f 57 5f 43 4f 56 45 52 49 4e 47  E_ALLOW_COVERING
5bc0: 5f 49 4e 44 45 58 5f 53 43 41 4e 3d 3c 69 3e 26  _INDEX_SCAN=<i>&
5bd0: 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f 69  lt;0 or 1&gt;</i
5be0: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 43 2d 70 72  >} {.  This C-pr
5bf0: 65 70 72 6f 63 65 73 73 20 6d 61 63 72 6f 20 64  eprocess macro d
5c00: 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 64 65  etermines the de
5c10: 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 6f 66  fault setting of
5c20: 20 74 68 65 0a 20 20 5b 53 51 4c 49 54 45 5f 43   the.  [SQLITE_C
5c30: 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f 49  ONFIG_COVERING_I
5c40: 4e 44 45 58 5f 53 43 41 4e 5d 20 63 6f 6e 66 69  NDEX_SCAN] confi
5c50: 67 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67  guration setting
5c60: 2e 20 20 49 74 20 64 65 66 61 75 6c 74 73 0a 20  .  It defaults. 
5c70: 20 74 6f 20 31 20 28 6f 6e 29 20 77 68 69 63 68   to 1 (on) which
5c80: 20 6d 65 61 6e 73 20 74 68 61 74 20 63 6f 76 65   means that cove
5c90: 72 69 6e 67 20 69 6e 64 69 63 65 73 20 61 72 65  ring indices are
5ca0: 20 75 73 65 64 20 66 6f 72 20 66 75 6c 6c 20 74   used for full t
5cb0: 61 62 6c 65 0a 20 20 73 63 61 6e 73 20 77 68 65  able.  scans whe
5cc0: 72 65 20 70 6f 73 73 69 62 6c 65 2c 20 69 6e 20  re possible, in 
5cd0: 6f 72 64 65 72 20 74 6f 20 72 65 64 75 63 65 20  order to reduce 
5ce0: 49 2f 4f 20 61 6e 64 20 69 6d 70 72 6f 76 65 20  I/O and improve 
5cf0: 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 20 20 48  performance..  H
5d00: 6f 77 65 76 65 72 2c 20 74 68 65 20 75 73 65 20  owever, the use 
5d10: 6f 66 20 61 20 63 6f 76 65 72 69 6e 67 20 69 6e  of a covering in
5d20: 64 65 78 20 66 6f 72 20 61 20 66 75 6c 6c 20 73  dex for a full s
5d30: 63 61 6e 20 77 69 6c 6c 20 63 61 75 73 65 20 72  can will cause r
5d40: 65 73 75 6c 74 73 0a 20 20 74 6f 20 61 70 70 65  esults.  to appe
5d50: 61 72 20 69 6e 20 61 20 64 69 66 66 65 72 65 6e  ar in a differen
5d60: 74 20 6f 72 64 65 72 20 66 72 6f 6d 20 6c 65 67  t order from leg
5d70: 61 63 79 2c 20 77 68 69 63 68 20 63 6f 75 6c 64  acy, which could
5d80: 20 63 61 75 73 65 20 73 6f 6d 65 0a 20 20 28 69   cause some.  (i
5d90: 6e 63 6f 72 72 65 63 74 6c 79 2d 63 6f 64 65 64  ncorrectly-coded
5da0: 29 20 6c 65 67 61 63 79 20 61 70 70 6c 69 63 61  ) legacy applica
5db0: 74 69 6f 6e 73 20 74 6f 20 62 72 65 61 6b 2e 20  tions to break. 
5dc0: 20 48 65 6e 63 65 2c 20 74 68 65 20 63 6f 76 65   Hence, the cove
5dd0: 72 69 6e 67 0a 20 20 69 6e 64 65 78 20 73 63 61  ring.  index sca
5de0: 6e 20 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65 20  n option can be 
5df0: 64 69 73 61 62 6c 65 64 20 61 74 20 63 6f 6d 70  disabled at comp
5e00: 69 6c 65 2d 74 69 6d 65 20 6f 6e 20 73 79 73 74  ile-time on syst
5e10: 65 6d 73 20 74 68 61 74 20 77 68 61 74 0a 20 20  ems that what.  
5e20: 74 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 69  to minimize thei
5e30: 72 20 72 69 73 6b 20 6f 66 20 65 78 70 6f 73 69  r risk of exposi
5e40: 6e 67 20 65 72 72 6f 72 73 20 69 6e 20 6c 65 67  ng errors in leg
5e50: 61 63 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  acy applications
5e60: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
5e70: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
5e80: 4c 45 5f 38 5f 33 5f 4e 41 4d 45 53 3d 3c 69 3e  LE_8_3_NAMES=<i>
5e90: 26 6c 74 3b 31 20 6f 72 20 32 26 67 74 3b 3c 2f  &lt;1 or 2&gt;</
5ea0: 69 3e 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  i>} {.  If this 
5eb0: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d  C-preprocessor m
5ec0: 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c  acro is defined,
5ed0: 20 74 68 65 6e 20 65 78 74 72 61 20 63 6f 64 65   then extra code
5ee0: 20 69 73 0a 20 20 69 6e 63 6c 75 64 65 64 20 74   is.  included t
5ef0: 68 61 74 20 61 6c 6c 6f 77 73 20 53 51 4c 69 74  hat allows SQLit
5f00: 65 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 6f 6e  e to function on
5f10: 20 61 20 66 69 6c 65 73 79 73 74 65 6d 20 74 68   a filesystem th
5f20: 61 74 0a 20 20 6f 6e 6c 79 20 73 75 70 70 6f 72  at.  only suppor
5f30: 74 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73 2e  t 8+3 filenames.
5f40: 20 20 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f    If the value o
5f50: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20  f this macro is 
5f60: 31 2c 0a 20 20 74 68 65 6e 20 74 68 65 20 64 65  1,.  then the de
5f70: 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 69  fault behavior i
5f80: 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 74 6f  s to continue to
5f90: 20 75 73 65 20 6c 6f 6e 67 20 66 69 6c 65 6e 61   use long filena
5fa0: 6d 65 73 20 61 6e 64 0a 20 20 74 6f 20 6f 6e 6c  mes and.  to onl
5fb0: 79 20 75 73 65 20 38 2b 33 20 66 69 6c 65 6e 61  y use 8+3 filena
5fc0: 6d 65 73 20 69 66 20 74 68 65 20 0a 20 20 64 61  mes if the .  da
5fd0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
5fe0: 6e 20 69 73 20 6f 70 65 6e 65 64 20 75 73 69 6e  n is opened usin
5ff0: 67 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65 73  g [URI filenames
6000: 5d 20 77 69 74 68 0a 20 20 74 68 65 20 22 3c 74  ] with.  the "<t
6010: 74 3e 38 5f 33 5f 6e 61 6d 65 73 3d 31 3c 2f 74  t>8_3_names=1</t
6020: 74 3e 22 20 71 75 65 72 79 20 70 61 72 61 6d 65  t>" query parame
6030: 74 65 72 2e 20 20 49 66 20 74 68 65 20 76 61 6c  ter.  If the val
6040: 75 65 20 6f 66 0a 20 20 74 68 69 73 20 6d 61 63  ue of.  this mac
6050: 72 6f 20 69 73 20 32 2c 20 74 68 65 6e 20 74 68  ro is 2, then th
6060: 65 20 75 73 65 20 6f 66 20 38 2b 33 20 66 69 6c  e use of 8+3 fil
6070: 65 6e 61 6d 65 73 20 62 65 63 6f 6d 65 73 20 74  enames becomes t
6080: 68 65 20 64 65 66 61 75 6c 74 0a 20 20 62 75 74  he default.  but
6090: 20 6d 61 79 20 62 65 20 64 69 73 61 62 6c 65 64   may be disabled
60a0: 20 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 74   on using the <t
60b0: 74 3e 38 5f 33 5f 6e 61 6d 65 73 3d 30 3c 2f 74  t>8_3_names=0</t
60c0: 74 3e 20 71 75 65 72 79 20 70 61 72 61 6d 65 74  t> query paramet
60d0: 65 72 2e 0a 20 20 53 65 65 20 0a 7d 0a 0a 43 4f  er..  See .}..CO
60e0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
60f0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f  LITE_ENABLE_API_
6100: 41 52 4d 4f 52 7d 20 7b 0a 20 20 57 68 65 6e 20  ARMOR} {.  When 
6110: 64 65 66 69 6e 65 64 2c 20 74 68 69 73 20 43 2d  defined, this C-
6120: 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63  preprocessor mac
6130: 72 6f 20 61 63 74 69 76 61 74 65 73 20 65 78 74  ro activates ext
6140: 72 61 20 63 6f 64 65 20 74 68 61 74 0a 20 20 61  ra code that.  a
6150: 74 74 65 6d 70 74 73 20 74 6f 20 64 65 74 65 63  ttempts to detec
6160: 74 20 6d 69 73 75 73 65 20 6f 66 20 74 68 65 20  t misuse of the 
6170: 53 51 4c 69 74 65 20 41 50 49 2c 20 73 75 63 68  SQLite API, such
6180: 20 61 73 20 70 61 73 73 69 6e 67 20 69 6e 20 4e   as passing in N
6190: 55 4c 4c 0a 20 20 70 6f 69 6e 74 65 72 73 20 74  ULL.  pointers t
61a0: 6f 20 72 65 71 75 69 72 65 64 20 70 61 72 61 6d  o required param
61b0: 65 74 65 72 73 20 6f 72 20 75 73 69 6e 67 20 6f  eters or using o
61c0: 62 6a 65 63 74 73 20 61 66 74 65 72 20 74 68 65  bjects after the
61d0: 79 20 68 61 76 65 20 62 65 65 6e 0a 20 20 64 65  y have been.  de
61e0: 73 74 72 6f 79 65 64 2e 0a 7d 0a 0a 43 4f 4d 50  stroyed..}..COMP
61f0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
6200: 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43  TE_ENABLE_ATOMIC
6210: 5f 57 52 49 54 45 7d 20 7b 0a 20 20 49 66 20 74  _WRITE} {.  If t
6220: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
6230: 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  or macro is defi
6240: 6e 65 64 20 61 6e 64 20 69 66 20 74 68 65 0a 20  ned and if the. 
6250: 20 78 44 65 76 69 63 65 43 68 61 72 61 63 74 65   xDeviceCharacte
6260: 72 69 73 74 69 63 73 20 6d 65 74 68 6f 64 20 6f  ristics method o
6270: 66 20 5b 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65  f [sqlite3_io_me
6280: 74 68 6f 64 73 5d 20 6f 62 6a 65 63 74 20 66 6f  thods] object fo
6290: 72 0a 20 20 61 20 64 61 74 61 62 61 73 65 20 66  r.  a database f
62a0: 69 6c 65 20 72 65 70 6f 72 74 73 20 28 76 69 61  ile reports (via
62b0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 5b 53 51 4c   one of the [SQL
62c0: 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43  ITE_IOCAP_ATOMIC
62d0: 5d 20 62 69 74 73 29 0a 20 20 74 68 61 74 20 74  ] bits).  that t
62e0: 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 73 75  he filesystem su
62f0: 70 70 6f 72 74 73 20 61 74 6f 6d 69 63 20 77 72  pports atomic wr
6300: 69 74 65 73 20 61 6e 64 20 69 66 20 61 20 74 72  ites and if a tr
6310: 61 6e 73 61 63 74 69 6f 6e 0a 20 20 69 6e 76 6f  ansaction.  invo
6320: 6c 76 65 73 20 61 20 63 68 61 6e 67 65 20 74 6f  lves a change to
6330: 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 70   only a single p
6340: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  age of the datab
6350: 61 73 65 20 66 69 6c 65 2c 0a 20 20 74 68 65 6e  ase file,.  then
6360: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
6370: 20 63 6f 6d 6d 69 74 73 20 77 69 74 68 20 6a 75   commits with ju
6380: 73 74 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74  st a single writ
6390: 65 20 72 65 71 75 65 73 74 20 6f 66 0a 20 20 61  e request of.  a
63a0: 20 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20   single page of 
63b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64  the database and
63c0: 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75   no rollback jou
63d0: 72 6e 61 6c 20 69 73 20 63 72 65 61 74 65 64 0a  rnal is created.
63e0: 20 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 4f    or written.  O
63f0: 6e 20 66 69 6c 65 73 79 73 74 65 6d 73 20 74 68  n filesystems th
6400: 61 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69  at support atomi
6410: 63 20 77 72 69 74 65 73 2c 20 74 68 69 73 0a 20  c writes, this. 
6420: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61   optimization ca
6430: 6e 20 72 65 73 75 6c 74 20 69 6e 20 73 69 67 6e  n result in sign
6440: 69 66 69 63 61 6e 74 20 73 70 65 65 64 20 69 6d  ificant speed im
6450: 70 72 6f 76 65 6d 65 6e 74 73 20 66 6f 72 0a 20  provements for. 
6460: 20 73 6d 61 6c 6c 20 75 70 64 61 74 65 73 2e 20   small updates. 
6470: 20 48 6f 77 65 76 65 72 2c 20 66 65 77 20 66 69   However, few fi
6480: 6c 65 73 79 73 74 65 6d 73 20 73 75 70 70 6f 72  lesystems suppor
6490: 74 20 74 68 69 73 20 63 61 70 61 62 69 6c 69 74  t this capabilit
64a0: 79 0a 20 20 61 6e 64 20 74 68 65 20 63 6f 64 65  y.  and the code
64b0: 20 70 61 74 68 73 20 74 68 61 74 20 63 68 65 63   paths that chec
64c0: 6b 20 66 6f 72 20 74 68 69 73 20 63 61 70 61 62  k for this capab
64d0: 69 6c 69 74 79 20 73 6c 6f 77 20 64 6f 77 6e 20  ility slow down 
64e0: 77 72 69 74 65 0a 20 20 70 65 72 66 6f 72 6d 61  write.  performa
64f0: 6e 63 65 20 6f 6e 20 73 79 73 74 65 6d 73 20 74  nce on systems t
6500: 68 61 74 20 6c 61 63 6b 20 61 74 6f 6d 69 63 20  hat lack atomic 
6510: 77 72 69 74 65 20 63 61 70 61 62 69 6c 69 74 79  write capability
6520: 2c 20 73 6f 20 74 68 69 73 0a 20 20 66 65 61 74  , so this.  feat
6530: 75 72 65 20 69 73 20 64 69 73 61 62 6c 65 64 20  ure is disabled 
6540: 62 79 20 64 65 66 61 75 6c 74 2e 0a 7d 0a 0a 43  by default..}..C
6550: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
6560: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c  QLITE_ENABLE_COL
6570: 55 4d 4e 5f 4d 45 54 41 44 41 54 41 7d 20 7b 0a  UMN_METADATA} {.
6580: 20 20 57 68 65 6e 20 74 68 69 73 20 43 2d 70 72    When this C-pr
6590: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f  eprocessor macro
65a0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c   is defined, SQL
65b0: 69 74 65 20 69 6e 63 6c 75 64 65 73 20 73 6f 6d  ite includes som
65c0: 65 0a 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 41  e.  additional A
65d0: 50 49 73 20 74 68 61 74 20 70 72 6f 76 69 64 65  PIs that provide
65e0: 20 63 6f 6e 76 65 6e 69 65 6e 74 20 61 63 63 65   convenient acce
65f0: 73 73 20 74 6f 20 6d 65 74 61 2d 64 61 74 61 20  ss to meta-data 
6600: 61 62 6f 75 74 0a 20 20 74 61 62 6c 65 73 20 61  about.  tables a
6610: 6e 64 20 71 75 65 72 69 65 73 2e 20 20 54 68 65  nd queries.  The
6620: 20 41 50 49 73 20 74 68 61 74 20 61 72 65 20 65   APIs that are e
6630: 6e 61 62 6c 65 64 20 62 79 20 74 68 69 73 20 6f  nabled by this o
6640: 70 74 69 6f 6e 20 61 72 65 3a 0a 0a 20 20 3c 75  ption are:..  <u
6650: 6c 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74  l>.  <li> [sqlit
6660: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61  e3_column_databa
6670: 73 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e  se_name()] </li>
6680: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33  .  <li> [sqlite3
6690: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65  _column_database
66a0: 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e  _name16()] </li>
66b0: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33  .  <li> [sqlite3
66c0: 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61  _column_table_na
66d0: 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c  me()] </li>.  <l
66e0: 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  i> [sqlite3_colu
66f0: 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28  mn_table_name16(
6700: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20  )] </li>.  <li> 
6710: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
6720: 6f 72 69 67 69 6e 5f 6e 61 6d 65 28 29 5d 20 3c  origin_name()] <
6730: 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c  /li>.  <li> [sql
6740: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67  ite3_column_orig
6750: 69 6e 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c  in_name16()] </l
6760: 69 3e 0a 20 20 3c 2f 75 6c 3e 0a 7d 0a 0a 43 4f  i>.  </ul>.}..CO
6770: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
6780: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c  LITE_ENABLE_EXPL
6790: 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 7d 20 7b 0a  AIN_COMMENTS} {.
67a0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64    This option ad
67b0: 64 73 20 65 78 74 72 61 20 6c 6f 67 69 63 20 74  ds extra logic t
67c0: 6f 20 53 51 4c 69 74 65 20 74 68 61 74 20 69 6e  o SQLite that in
67d0: 73 65 72 74 73 20 63 6f 6d 6d 65 6e 74 20 74 65  serts comment te
67e0: 78 74 20 69 6e 74 6f 20 74 68 65 0a 20 20 6f 75  xt into the.  ou
67f0: 74 70 75 74 20 6f 66 20 5b 45 58 50 4c 41 49 4e  tput of [EXPLAIN
6800: 5d 2e 20 20 54 68 65 73 65 20 65 78 74 72 61 20  ].  These extra 
6810: 63 6f 6d 6d 65 6e 74 73 20 75 73 65 20 65 78 74  comments use ext
6820: 72 61 20 6d 65 6d 6f 72 79 2c 20 74 68 75 73 0a  ra memory, thus.
6830: 20 20 6d 61 6b 69 6e 67 20 5b 70 72 65 70 61 72    making [prepar
6840: 65 64 20 73 74 61 74 65 6d 65 6e 74 73 5d 20 6c  ed statements] l
6850: 61 72 67 65 72 20 61 6e 64 20 76 65 72 79 20 73  arger and very s
6860: 6c 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 2c 20  lightly slower, 
6870: 61 6e 64 20 73 6f 20 74 68 65 79 20 61 72 65 0a  and so they are.
6880: 20 20 74 75 72 6e 65 64 20 6f 66 66 20 62 79 20    turned off by 
6890: 64 65 66 61 75 6c 74 20 61 6e 64 20 69 6e 20 6d  default and in m
68a0: 6f 73 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e  ost application.
68b0: 20 20 42 75 74 20 73 6f 6d 65 20 61 70 70 6c 69    But some appli
68c0: 63 61 74 69 6f 6e 73 2c 20 73 75 63 68 0a 20 20  cations, such.  
68d0: 61 73 20 74 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d  as the [command-
68e0: 6c 69 6e 65 20 73 68 65 6c 6c 5d 20 66 6f 72 20  line shell] for 
68f0: 53 51 4c 69 74 65 2c 20 76 61 6c 75 65 20 63 6c  SQLite, value cl
6900: 61 72 69 74 79 20 6f 66 20 45 58 50 4c 41 49 4e  arity of EXPLAIN
6910: 20 6f 75 74 70 75 74 0a 20 20 6f 76 65 72 20 72   output.  over r
6920: 61 77 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61  aw performance a
6930: 6e 64 20 73 6f 20 74 68 69 73 20 63 6f 6d 70 69  nd so this compi
6940: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69  le-time option i
6950: 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 74  s available to t
6960: 68 65 6d 2e 0a 20 20 54 68 65 20 53 51 4c 49 54  hem..  The SQLIT
6970: 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e  E_ENABLE_EXPLAIN
6980: 5f 43 4f 4d 4d 45 4e 54 53 20 63 6f 6d 70 69 6c  _COMMENTS compil
6990: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73  e-time option is
69a0: 20 61 6c 73 6f 20 65 6e 61 62 6c 65 64 0a 20 20   also enabled.  
69b0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 66  automatically if
69c0: 20 5b 53 51 4c 49 54 45 5f 44 45 42 55 47 5d 20   [SQLITE_DEBUG] 
69d0: 69 73 20 65 6e 61 62 6c 65 64 2e 0a 7d 0a 0a 0a  is enabled..}...
69e0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
69f0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54  SQLITE_ENABLE_FT
6a00: 53 33 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69  S3} {.  When thi
6a10: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69  s option is defi
6a20: 6e 65 64 20 69 6e 20 74 68 65 20 5b 61 6d 61 6c  ned in the [amal
6a30: 67 61 6d 61 74 69 6f 6e 5d 2c 20 76 65 72 73 69  gamation], versi
6a40: 6f 6e 20 33 0a 20 20 6f 66 20 74 68 65 20 66 75  on 3.  of the fu
6a50: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 65  ll-text search e
6a60: 6e 67 69 6e 65 20 69 73 20 61 64 64 65 64 20 74  ngine is added t
6a70: 6f 20 74 68 65 20 62 75 69 6c 64 20 61 75 74 6f  o the build auto
6a80: 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d 0a 0a 43 4f  matically..}..CO
6a90: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
6aa0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33  LITE_ENABLE_FTS3
6ab0: 5f 50 41 52 45 4e 54 48 45 53 49 53 7d 20 7b 0a  _PARENTHESIS} {.
6ac0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 6f    This option mo
6ad0: 64 69 66 69 65 73 20 74 68 65 20 71 75 65 72 79  difies the query
6ae0: 20 70 61 74 74 65 72 6e 20 70 61 72 73 65 72 20   pattern parser 
6af0: 69 6e 20 46 54 53 33 20 73 75 63 68 20 74 68 61  in FTS3 such tha
6b00: 74 20 69 74 0a 20 20 73 75 70 70 6f 72 74 73 20  t it.  supports 
6b10: 6f 70 65 72 61 74 6f 72 73 20 41 4e 44 20 61 6e  operators AND an
6b20: 64 20 4e 4f 54 20 28 69 6e 20 61 64 64 69 74 69  d NOT (in additi
6b30: 6f 6e 20 74 6f 20 74 68 65 20 75 73 75 61 6c 20  on to the usual 
6b40: 4f 52 20 61 6e 64 20 4e 45 41 52 29 0a 20 20 61  OR and NEAR).  a
6b50: 6e 64 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 71  nd also allows q
6b60: 75 65 72 79 20 65 78 70 72 65 73 73 69 6f 6e 73  uery expressions
6b70: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 6e 65 73 74   to contain nest
6b80: 65 64 20 70 61 72 65 6e 74 68 65 73 69 73 2e 0a  ed parenthesis..
6b90: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
6ba0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
6bb0: 5f 46 54 53 34 7d 20 7b 0a 20 20 57 68 65 6e 20  _FTS4} {.  When 
6bc0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
6bd0: 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 5b 61  efined in the [a
6be0: 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 2c 20 76 65  malgamation], ve
6bf0: 72 73 69 6f 6e 73 20 33 20 61 6e 64 20 34 0a 20  rsions 3 and 4. 
6c00: 20 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74 65 78   of the full-tex
6c10: 74 20 73 65 61 72 63 68 20 65 6e 67 69 6e 65 20  t search engine 
6c20: 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  is added to the 
6c30: 62 75 69 6c 64 20 61 75 74 6f 6d 61 74 69 63 61  build automatica
6c40: 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  lly..}..COMPILE_
6c50: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
6c60: 4e 41 42 4c 45 5f 49 43 55 7d 20 7b 0a 20 20 54  NABLE_ICU} {.  T
6c70: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
6c80: 73 20 74 68 65 20 0a 20 20 5b 68 74 74 70 3a 2f  s the .  [http:/
6c90: 2f 77 77 77 2e 69 63 75 2d 70 72 6f 6a 65 63 74  /www.icu-project
6ca0: 2e 6f 72 67 2f 20 7c 20 49 6e 74 65 72 6e 61 74  .org/ | Internat
6cb0: 69 6f 6e 61 6c 20 43 6f 6d 70 6f 6e 65 6e 74 73  ional Components
6cc0: 20 66 6f 72 20 55 6e 69 63 6f 64 65 5d 0a 20 20   for Unicode].  
6cd0: 6f 72 20 22 49 43 55 22 20 65 78 74 65 6e 73 69  or "ICU" extensi
6ce0: 6f 6e 20 74 6f 20 53 51 4c 69 74 65 20 74 6f 20  on to SQLite to 
6cf0: 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  be added to the 
6d00: 62 75 69 6c 64 2e 20 20 0a 7d 0a 0a 43 4f 4d 50  build.  .}..COMP
6d10: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
6d20: 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43  TE_ENABLE_IOTRAC
6d30: 45 7d 20 7b 0a 20 20 57 68 65 6e 20 62 6f 74 68  E} {.  When both
6d40: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65   the SQLite core
6d50: 20 61 6e 64 20 74 68 65 20 5b 43 6f 6d 6d 61 6e   and the [Comman
6d60: 64 20 4c 69 6e 65 20 49 6e 74 65 72 66 61 63 65  d Line Interface
6d70: 5d 20 28 43 4c 49 29 20 61 72 65 20 62 6f 74 68  ] (CLI) are both
6d80: 20 0a 20 20 63 6f 6d 70 69 6c 65 64 20 77 69 74   .  compiled wit
6d90: 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 74  h this option, t
6da0: 68 65 6e 20 74 68 65 20 43 4c 49 20 70 72 6f 76  hen the CLI prov
6db0: 69 64 65 73 20 61 6e 20 65 78 74 72 61 20 63 6f  ides an extra co
6dc0: 6d 6d 61 6e 64 0a 20 20 6e 61 6d 65 64 20 22 2e  mmand.  named ".
6dd0: 69 6f 74 72 61 63 65 22 20 74 68 61 74 20 70 72  iotrace" that pr
6de0: 6f 76 69 64 65 73 20 61 20 6c 6f 77 2d 6c 65 76  ovides a low-lev
6df0: 65 6c 20 6c 6f 67 20 6f 66 20 49 2f 4f 20 61 63  el log of I/O ac
6e00: 74 69 76 69 74 79 2e 0a 20 20 54 68 69 73 20 6f  tivity..  This o
6e10: 70 74 69 6f 6e 20 69 73 20 65 78 70 65 72 69 6d  ption is experim
6e20: 65 6e 74 61 6c 20 61 6e 64 20 6d 61 79 20 62 65  ental and may be
6e30: 20 64 69 73 63 6f 6e 74 69 6e 75 65 64 20 69 6e   discontinued in
6e40: 20 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 73   a future releas
6e50: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
6e60: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
6e70: 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c  BLE_LOCKING_STYL
6e80: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
6e90: 6f 6e 20 65 6e 61 62 6c 65 73 20 61 64 64 69 74  on enables addit
6ea0: 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 69 6e 20 74  ional logic in t
6eb0: 68 65 20 4f 53 20 69 6e 74 65 72 66 61 63 65 20  he OS interface 
6ec0: 6c 61 79 65 72 20 66 6f 72 0a 20 20 4d 61 63 20  layer for.  Mac 
6ed0: 4f 53 20 58 2e 20 54 68 65 20 61 64 64 69 74 69  OS X. The additi
6ee0: 6f 6e 61 6c 20 6c 6f 67 69 63 20 61 74 74 65 6d  onal logic attem
6ef0: 70 74 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65  pts to determine
6f00: 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65   the type of the
6f10: 0a 20 20 75 6e 64 65 72 6c 79 69 6e 67 20 66 69  .  underlying fi
6f20: 6c 65 73 79 73 74 65 6d 20 61 6e 64 20 63 68 6f  lesystem and cho
6f30: 6f 73 65 20 61 6e 64 20 61 6c 74 65 72 6e 61 74  ose and alternat
6f40: 69 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61  ive locking stra
6f50: 74 65 67 79 0a 20 20 74 68 61 74 20 77 6f 72 6b  tegy.  that work
6f60: 73 20 63 6f 72 72 65 63 74 6c 79 20 66 6f 72 20  s correctly for 
6f70: 74 68 61 74 20 66 69 6c 65 73 79 73 74 65 6d 20  that filesystem 
6f80: 74 79 70 65 2e 20 46 69 76 65 20 6c 6f 63 6b 69  type. Five locki
6f90: 6e 67 20 73 74 72 61 74 65 67 69 65 73 20 0a 20  ng strategies . 
6fa0: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 3a 0a   are available:.
6fb0: 0a 20 20 3c 75 6c 3e 0a 20 20 20 20 3c 6c 69 3e  .  <ul>.    <li>
6fc0: 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20 73   POSIX locking s
6fd0: 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 74 68  tyle. This is th
6fe0: 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e  e default lockin
6ff0: 67 20 73 74 79 6c 65 20 61 6e 64 20 74 68 65 0a  g style and the.
7000: 20 20 20 20 20 20 20 20 20 73 74 79 6c 65 20 75           style u
7010: 73 65 64 20 62 79 20 6f 74 68 65 72 20 28 6e 6f  sed by other (no
7020: 6e 20 4d 61 63 20 4f 53 20 58 29 20 55 6e 69 78  n Mac OS X) Unix
7030: 65 73 2e 20 4c 6f 63 6b 73 20 61 72 65 20 6f 62  es. Locks are ob
7040: 74 61 69 6e 65 64 20 61 6e 64 20 0a 20 20 20 20  tained and .    
7050: 20 20 20 20 20 72 65 6c 65 61 73 65 64 20 75 73       released us
7060: 69 6e 67 20 74 68 65 20 66 63 6e 74 6c 28 29 20  ing the fcntl() 
7070: 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20  system call...  
7080: 20 20 3c 6c 69 3e 20 41 46 50 20 6c 6f 63 6b 69    <li> AFP locki
7090: 6e 67 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c  ng style. This l
70a0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20  ocking style is 
70b0: 75 73 65 64 20 66 6f 72 20 6e 65 74 77 6f 72 6b  used for network
70c0: 20 66 69 6c 65 20 0a 20 20 20 20 20 20 20 20 20   file .         
70d0: 73 79 73 74 65 6d 73 20 74 68 61 74 20 75 73 65  systems that use
70e0: 20 74 68 65 20 41 46 50 20 28 41 70 70 6c 65 20   the AFP (Apple 
70f0: 46 69 6c 69 6e 67 20 50 72 6f 74 6f 63 6f 6c 29  Filing Protocol)
7100: 20 70 72 6f 74 6f 63 6f 6c 2e 20 4c 6f 63 6b 73   protocol. Locks
7110: 0a 20 20 20 20 20 20 20 20 20 61 72 65 20 6f 62  .         are ob
7120: 74 61 69 6e 65 64 20 62 79 20 63 61 6c 6c 69 6e  tained by callin
7130: 67 20 74 68 65 20 6c 69 62 72 61 72 79 20 66 75  g the library fu
7140: 6e 63 74 69 6f 6e 20 5f 41 46 50 46 53 53 65 74  nction _AFPFSSet
7150: 4c 6f 63 6b 28 29 2e 0a 0a 20 20 20 20 3c 6c 69  Lock()...    <li
7160: 3e 20 46 6c 6f 63 6b 20 6c 6f 63 6b 69 6e 67 20  > Flock locking 
7170: 73 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 75  style. This is u
7180: 73 65 64 20 66 6f 72 20 66 69 6c 65 2d 73 79 73  sed for file-sys
7190: 74 65 6d 73 20 74 68 61 74 20 64 6f 20 6e 6f 74  tems that do not
71a0: 0a 20 20 20 20 20 20 20 20 20 73 75 70 70 6f 72  .         suppor
71b0: 74 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20  t POSIX locking 
71c0: 73 74 79 6c 65 2e 20 4c 6f 63 6b 73 20 61 72 65  style. Locks are
71d0: 20 6f 62 74 61 69 6e 65 64 20 61 6e 64 20 72 65   obtained and re
71e0: 6c 65 61 73 65 64 20 75 73 69 6e 67 0a 20 20 20  leased using.   
71f0: 20 20 20 20 20 20 74 68 65 20 66 6c 6f 63 6b 28        the flock(
7200: 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a  ) system call...
7210: 20 20 20 20 3c 6c 69 3e 20 44 6f 74 2d 66 69 6c      <li> Dot-fil
7220: 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  e locking style.
7230: 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74   This locking st
7240: 79 6c 65 20 69 73 20 75 73 65 64 20 77 68 65 6e  yle is used when
7250: 20 6e 65 69 74 68 65 72 0a 20 20 20 20 20 20 20   neither.       
7260: 20 20 66 6c 6f 63 6b 20 6e 6f 72 20 50 4f 53 49    flock nor POSI
7270: 58 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 73  X locking styles
7280: 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 20 62   are supported b
7290: 79 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65  y the file syste
72a0: 6d 2e 0a 20 20 20 20 20 20 20 20 20 44 61 74 61  m..         Data
72b0: 62 61 73 65 20 6c 6f 63 6b 73 20 61 72 65 20 6f  base locks are o
72c0: 62 74 61 69 6e 65 64 20 62 79 20 63 72 65 61 74  btained by creat
72d0: 69 6e 67 20 61 6e 64 20 65 6e 74 72 79 20 69 6e  ing and entry in
72e0: 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d   the file-system
72f0: 0a 20 20 20 20 20 20 20 20 20 61 74 20 61 20 77  .         at a w
7300: 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c 6f 63 61 74 69  ell-known locati
7310: 6f 6e 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74  on relative to t
7320: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
7330: 20 28 61 20 22 64 6f 74 2d 66 69 6c 65 22 29 0a   (a "dot-file").
7340: 20 20 20 20 20 20 20 20 20 61 6e 64 20 72 65 6c           and rel
7350: 69 6e 71 75 69 73 68 65 64 20 62 79 20 64 65 6c  inquished by del
7360: 65 74 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66  eting the same f
7370: 69 6c 65 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 4e  ile...    <li> N
7380: 6f 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  o locking style.
7390: 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20   If none of the 
73a0: 61 62 6f 76 65 20 63 61 6e 20 62 65 20 73 75 70  above can be sup
73b0: 70 6f 72 74 65 64 2c 20 74 68 69 73 20 0a 20 20  ported, this .  
73c0: 20 20 20 20 20 20 20 6c 6f 63 6b 69 6e 67 20 73         locking s
73d0: 74 79 6c 65 20 69 73 20 75 73 65 64 2e 20 4e 6f  tyle is used. No
73e0: 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e   database lockin
73f0: 67 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 75  g mechanism is u
7400: 73 65 64 2e 20 57 68 65 6e 0a 20 20 20 20 20 20  sed. When.      
7410: 20 20 20 74 68 69 73 20 73 79 73 74 65 6d 20 69     this system i
7420: 73 20 75 73 65 64 20 69 74 20 69 73 20 6e 6f 74  s used it is not
7430: 20 73 61 66 65 20 66 6f 72 20 61 20 73 69 6e 67   safe for a sing
7440: 6c 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 62  le database to b
7450: 65 0a 20 20 20 20 20 20 20 20 20 61 63 63 65 73  e.         acces
7460: 73 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20  sed by multiple 
7470: 63 6c 69 65 6e 74 73 2e 0a 20 20 3c 2f 75 6c 3e  clients..  </ul>
7480: 0a 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79  ..  Additionally
7490: 2c 20 66 69 76 65 20 65 78 74 72 61 20 5b 56 46  , five extra [VF
74a0: 53 5d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  S] implementatio
74b0: 6e 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 20  ns are provided 
74c0: 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 0a 20  as well as the. 
74d0: 20 64 65 66 61 75 6c 74 2e 20 42 79 20 73 70 65   default. By spe
74e0: 63 69 66 79 69 6e 67 20 6f 6e 65 20 6f 66 20 74  cifying one of t
74f0: 68 65 20 65 78 74 72 61 20 56 46 53 20 69 6d 70  he extra VFS imp
7500: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 0a 20 20  lementations .  
7510: 77 68 65 6e 20 63 61 6c 6c 69 6e 67 20 5b 73 71  when calling [sq
7520: 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d  lite3_open_v2()]
7530: 2c 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  , an application
7540: 20 6d 61 79 20 62 79 70 61 73 73 20 74 68 65 20   may bypass the 
7550: 66 69 6c 65 2d 73 79 73 74 65 6d 0a 20 20 64 65  file-system.  de
7560: 74 65 63 74 69 6f 6e 20 6c 6f 67 69 63 20 61 6e  tection logic an
7570: 64 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 6c  d explicitly sel
7580: 65 63 74 20 6f 6e 65 20 6f 66 20 74 68 65 20 61  ect one of the a
7590: 62 6f 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79  bove locking sty
75a0: 6c 65 73 2e 20 54 68 65 0a 20 20 66 69 76 65 20  les. The.  five 
75b0: 65 78 74 72 61 20 5b 56 46 53 5d 20 69 6d 70 6c  extra [VFS] impl
75c0: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20  ementations are 
75d0: 63 61 6c 6c 65 64 20 22 75 6e 69 78 2d 70 6f 73  called "unix-pos
75e0: 69 78 22 2c 20 22 75 6e 69 78 2d 61 66 70 22 2c  ix", "unix-afp",
75f0: 0a 20 20 22 75 6e 69 78 2d 66 6c 6f 63 6b 22 2c  .  "unix-flock",
7600: 20 22 75 6e 69 78 2d 64 6f 74 66 69 6c 65 22 20   "unix-dotfile" 
7610: 61 6e 64 20 22 75 6e 69 78 2d 6e 6f 6e 65 22 2e  and "unix-none".
7620: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
7630: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
7640: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
7650: 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ENT} {.  This op
7660: 74 69 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20  tion adds extra 
7670: 6c 6f 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20  logic to SQLite 
7680: 74 68 61 74 20 61 6c 6c 6f 77 73 20 69 74 20 74  that allows it t
7690: 6f 20 72 65 6c 65 61 73 65 20 75 6e 75 73 65 64  o release unused
76a0: 0a 20 20 6d 65 6d 6f 72 79 20 75 70 6f 6e 20 72  .  memory upon r
76b0: 65 71 75 65 73 74 2e 20 20 54 68 69 73 20 6f 70  equest.  This op
76c0: 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 6e 61  tion must be ena
76d0: 62 6c 65 64 20 69 6e 20 6f 72 64 65 72 20 66 6f  bled in order fo
76e0: 72 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33  r the.  [sqlite3
76f0: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28  _release_memory(
7700: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  )] interface to 
7710: 77 6f 72 6b 2e 20 20 49 66 20 74 68 69 73 20 63  work.  If this c
7720: 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70  ompile-time.  op
7730: 74 69 6f 6e 20 69 73 20 6e 6f 74 20 75 73 65 64  tion is not used
7740: 2c 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72  , the [sqlite3_r
7750: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d  elease_memory()]
7760: 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 61 20   interface is a 
7770: 0a 20 20 6e 6f 2d 6f 70 2e 0a 7d 0a 0a 43 4f 4d  .  no-op..}..COM
7780: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
7790: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59  ITE_ENABLE_MEMSY
77a0: 53 33 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  S3} {.  This opt
77b0: 69 6f 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f 64  ion includes cod
77c0: 65 20 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74  e in SQLite that
77d0: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 61   implements an a
77e0: 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 6d 65 6d  lternative.  mem
77f0: 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20 20  ory allocator.  
7800: 54 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76 65  This alternative
7810: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
7820: 72 20 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67 65  r is only engage
7830: 64 0a 20 20 77 68 65 6e 20 74 68 65 20 5b 53 51  d.  when the [SQ
7840: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50  LITE_CONFIG_HEAP
7850: 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71 6c  ] option to [sql
7860: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69  ite3_config()] i
7870: 73 20 75 73 65 64 20 74 6f 0a 20 20 73 75 70 70  s used to.  supp
7880: 6c 79 20 61 20 6c 61 72 67 65 20 63 68 75 6e 6b  ly a large chunk
7890: 20 6f 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20   of memory from 
78a0: 77 68 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72 79  which all memory
78b0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65   allocations are
78c0: 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65 20  .  taken..  The 
78d0: 4d 45 4d 53 59 53 33 20 6d 65 6d 6f 72 79 20 61  MEMSYS3 memory a
78e0: 6c 6c 6f 63 61 74 6f 72 20 75 73 65 73 20 61 20  llocator uses a 
78f0: 68 79 62 72 69 64 20 61 6c 6c 6f 63 61 74 69 6f  hybrid allocatio
7900: 6e 20 61 6c 67 6f 72 69 74 68 6d 20 0a 20 20 70  n algorithm .  p
7910: 61 74 74 65 72 6e 65 64 20 61 66 74 65 72 20 64  atterned after d
7920: 6c 6d 61 6c 6c 6f 63 28 29 2e 20 20 20 4f 6e 6c  lmalloc().   Onl
7930: 79 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f  y one of SQLITE_
7940: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 20 61  ENABLE_MEMSYS3 a
7950: 6e 64 20 0a 20 20 53 51 4c 49 54 45 5f 45 4e 41  nd .  SQLITE_ENA
7960: 42 4c 45 5f 4d 45 4d 53 59 53 35 20 6d 61 79 20  BLE_MEMSYS5 may 
7970: 62 65 20 65 6e 61 62 6c 65 64 20 61 74 20 6f 6e  be enabled at on
7980: 63 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ce..}..COMPILE_O
7990: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
79a0: 41 42 4c 45 5f 4d 45 4d 53 59 53 35 7d 20 7b 0a  ABLE_MEMSYS5} {.
79b0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e    This option in
79c0: 63 6c 75 64 65 73 20 63 6f 64 65 20 69 6e 20 53  cludes code in S
79d0: 51 4c 69 74 65 20 74 68 61 74 20 69 6d 70 6c 65  QLite that imple
79e0: 6d 65 6e 74 73 20 61 6e 20 61 6c 74 65 72 6e 61  ments an alterna
79f0: 74 69 76 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c  tive.  memory al
7a00: 6c 6f 63 61 74 6f 72 2e 20 20 54 68 69 73 20 61  locator.  This a
7a10: 6c 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72  lternative memor
7a20: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f  y allocator is o
7a30: 6e 6c 79 20 65 6e 67 61 67 65 64 0a 20 20 77 68  nly engaged.  wh
7a40: 65 6e 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43  en the [SQLITE_C
7a50: 4f 4e 46 49 47 5f 48 45 41 50 5d 20 6f 70 74 69  ONFIG_HEAP] opti
7a60: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
7a70: 6f 6e 66 69 67 28 29 5d 20 69 73 20 75 73 65 64  onfig()] is used
7a80: 20 74 6f 0a 20 20 73 75 70 70 6c 79 20 61 20 6c   to.  supply a l
7a90: 61 72 67 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65  arge chunk of me
7aa0: 6d 6f 72 79 20 66 72 6f 6d 20 77 68 69 63 68 20  mory from which 
7ab0: 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  all memory alloc
7ac0: 61 74 69 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b  ations are.  tak
7ad0: 65 6e 2e 0a 20 20 54 68 65 20 4d 45 4d 53 59 53  en..  The MEMSYS
7ae0: 35 20 6d 6f 64 75 6c 65 20 72 6f 75 6e 64 73 20  5 module rounds 
7af0: 61 6c 6c 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20  all allocations 
7b00: 75 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 70  up to the next p
7b10: 6f 77 65 72 0a 20 20 6f 66 20 74 77 6f 20 61 6e  ower.  of two an
7b20: 64 20 75 73 65 73 20 61 20 66 69 72 73 74 2d 66  d uses a first-f
7b30: 69 74 2c 20 62 75 64 64 79 2d 61 6c 6c 6f 63 61  it, buddy-alloca
7b40: 74 6f 72 20 61 6c 67 6f 72 69 74 68 6d 0a 20 20  tor algorithm.  
7b50: 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 73 74  that provides st
7b60: 72 6f 6e 67 20 67 75 61 72 61 6e 74 65 65 73 20  rong guarantees 
7b70: 61 67 61 69 6e 73 74 20 66 72 61 67 6d 65 6e 74  against fragment
7b80: 61 74 69 6f 6e 20 61 6e 64 20 62 72 65 61 6b 64  ation and breakd
7b90: 6f 77 6e 0a 20 20 73 75 62 6a 65 63 74 20 74 6f  own.  subject to
7ba0: 20 63 65 72 74 61 69 6e 20 6f 70 65 72 61 74 69   certain operati
7bb0: 6e 67 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a  ng constraints..
7bc0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
7bd0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
7be0: 5f 52 54 52 45 45 7d 20 7b 0a 20 20 54 68 69 73  _RTREE} {.  This
7bf0: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53   option causes S
7c00: 51 4c 69 74 65 20 74 6f 20 69 6e 63 6c 75 64 65  QLite to include
7c10: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65   support for the
7c20: 0a 20 20 5b 72 74 72 65 65 20 7c 20 52 2a 54 72  .  [rtree | R*Tr
7c30: 65 65 20 69 6e 64 65 78 20 65 78 74 65 6e 73 69  ee index extensi
7c40: 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  on]..}..COMPILE_
7c50: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
7c60: 4e 41 42 4c 45 5f 53 54 4d 54 5f 53 43 41 4e 53  NABLE_STMT_SCANS
7c70: 54 41 54 55 53 7d 20 7b 0a 20 20 54 68 69 73 20  TATUS} {.  This 
7c80: 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 74  option enables t
7c90: 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 6d 74  he [sqlite3_stmt
7ca0: 5f 73 63 61 6e 73 74 61 74 75 73 28 29 5d 20 69  _scanstatus()] i
7cb0: 6e 74 65 72 66 61 63 65 2e 20 20 54 68 65 0a 20  nterface.  The. 
7cc0: 20 5b 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73   [sqlite3_stmt_s
7cd0: 63 61 6e 73 74 61 74 75 73 28 29 5d 20 69 6e 74  canstatus()] int
7ce0: 65 72 66 61 63 65 20 69 73 20 6e 6f 72 6d 61 6c  erface is normal
7cf0: 6c 79 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20  ly omitted from 
7d00: 74 68 65 20 62 75 69 6c 64 0a 20 20 62 65 63 61  the build.  beca
7d10: 75 73 65 20 69 74 20 69 6d 70 6f 73 65 73 20 61  use it imposes a
7d20: 20 73 6d 61 6c 6c 20 70 65 72 66 6f 72 6d 61 6e   small performan
7d30: 63 65 20 70 65 6e 61 6c 74 79 2c 20 65 76 65 6e  ce penalty, even
7d40: 20 6f 6e 20 73 74 61 74 65 6d 65 6e 74 73 20 74   on statements t
7d50: 68 61 74 0a 20 20 64 6f 20 6e 6f 74 20 75 73 65  hat.  do not use
7d60: 20 74 68 65 20 66 65 61 74 75 72 65 2e 0a 7d 0a   the feature..}.
7d70: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
7d80: 7b 53 51 4c 49 54 45 5f 52 54 52 45 45 5f 49 4e  {SQLITE_RTREE_IN
7d90: 54 5f 4f 4e 4c 59 7d 20 7b 0a 20 20 49 66 20 74  T_ONLY} {.  If t
7da0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
7db0: 65 64 20 74 6f 67 65 74 68 65 72 20 77 69 74 68  ed together with
7dc0: 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   [SQLITE_ENABLE_
7dd0: 52 54 52 45 45 5d 20 74 68 65 6e 20 74 68 65 0a  RTREE] then the.
7de0: 20 20 5b 72 74 72 65 65 20 7c 20 52 2a 54 72 65    [rtree | R*Tre
7df0: 65 20 65 78 74 65 6e 73 69 6f 6e 5d 20 77 69 6c  e extension] wil
7e00: 6c 20 6f 6e 6c 79 20 73 74 6f 72 65 20 33 32 2d  l only store 32-
7e10: 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67  bit signed integ
7e20: 65 72 0a 20 20 63 6f 6f 72 64 69 6e 61 74 65 73  er.  coordinates
7e30: 20 61 6e 64 20 61 6c 6c 20 69 6e 74 65 72 6e 61   and all interna
7e40: 6c 20 63 6f 6d 70 75 74 61 74 69 6f 6e 73 20 77  l computations w
7e50: 69 6c 6c 20 62 65 20 64 6f 6e 65 20 75 73 69 6e  ill be done usin
7e60: 67 20 69 6e 74 65 67 65 72 73 0a 20 20 69 6e 73  g integers.  ins
7e70: 74 65 61 64 20 6f 66 20 66 6c 6f 61 74 69 6e 67  tead of floating
7e80: 20 70 6f 69 6e 74 20 6e 75 6d 62 65 72 73 2e 0a   point numbers..
7e90: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
7ea0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
7eb0: 5f 53 51 4c 4c 4f 47 7d 20 7b 0a 20 20 54 68 69  _SQLLOG} {.  Thi
7ec0: 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65 73  s option enables
7ed0: 20 65 78 74 72 61 20 63 6f 64 65 20 28 65 73 70   extra code (esp
7ee0: 65 63 69 61 6c 6c 79 20 74 68 65 20 5b 53 51 4c  ecially the [SQL
7ef0: 49 54 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c 4f  ITE_CONFIG_SQLLO
7f00: 47 5d 0a 20 20 6f 70 74 69 6f 6e 20 74 6f 20 5b  G].  option to [
7f10: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29  sqlite3_config()
7f20: 5d 29 20 74 68 61 74 20 63 61 6e 20 62 65 20 75  ]) that can be u
7f30: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 6c 6f  sed to create lo
7f40: 67 73 20 6f 66 20 61 6c 6c 0a 20 20 53 51 4c 69  gs of all.  SQLi
7f50: 74 65 20 70 72 6f 63 65 73 73 69 6e 67 20 70 65  te processing pe
7f60: 72 66 6f 72 6d 65 64 20 62 79 20 61 6e 20 61 70  rformed by an ap
7f70: 70 6c 69 63 61 74 69 6f 6e 2e 20 20 54 68 65 73  plication.  Thes
7f80: 65 20 6c 6f 67 73 20 63 61 6e 20 62 65 20 75 73  e logs can be us
7f90: 65 66 75 6c 0a 20 20 69 6e 20 64 6f 69 6e 67 20  eful.  in doing 
7fa0: 6f 66 66 2d 6c 69 6e 65 20 61 6e 61 6c 79 73 69  off-line analysi
7fb0: 73 20 6f 66 20 74 68 65 20 62 65 68 61 76 69 6f  s of the behavio
7fc0: 72 20 6f 66 20 61 6e 20 61 70 70 6c 69 63 61 74  r of an applicat
7fd0: 69 6f 6e 2c 20 61 6e 64 20 65 73 70 65 63 69 61  ion, and especia
7fe0: 6c 6c 79 0a 20 20 66 6f 72 20 70 65 72 66 6f 72  lly.  for perfor
7ff0: 6d 61 6e 63 65 20 61 6e 61 6c 79 73 69 73 2e 20  mance analysis. 
8000: 20 49 6e 20 6f 72 64 65 72 20 66 6f 72 20 74 68   In order for th
8010: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  e SQLITE_ENABLE_
8020: 53 51 4c 4c 4f 47 20 6f 70 74 69 6f 6e 20 74 6f  SQLLOG option to
8030: 20 0a 20 20 62 65 20 75 73 65 66 75 6c 2c 20 73   .  be useful, s
8040: 6f 6d 65 20 65 78 74 72 61 20 63 6f 64 65 20 69  ome extra code i
8050: 73 20 72 65 71 75 69 72 65 64 2e 20 20 54 68 65  s required.  The
8060: 20 0a 20 20 3c 61 20 68 72 65 66 3d 22 68 74 74   .  <a href="htt
8070: 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f  p://www.sqlite.o
8080: 72 67 2f 73 72 63 2f 64 6f 63 2f 74 72 75 6e 6b  rg/src/doc/trunk
8090: 2f 73 72 63 2f 74 65 73 74 5f 73 71 6c 6c 6f 67  /src/test_sqllog
80a0: 2e 63 22 3e 22 74 65 73 74 5f 73 71 6c 6c 6f 67  .c">"test_sqllog
80b0: 2e 63 22 3c 2f 61 3e 0a 20 20 73 6f 75 72 63 65  .c"</a>.  source
80c0: 20 63 6f 64 65 0a 20 20 66 69 6c 65 20 69 6e 20   code.  file in 
80d0: 74 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63  the SQLite sourc
80e0: 65 20 74 72 65 65 20 69 73 20 61 20 77 6f 72 6b  e tree is a work
80f0: 69 6e 67 20 65 78 61 6d 70 6c 65 20 6f 66 20 74  ing example of t
8100: 68 65 20 72 65 71 75 69 72 65 64 20 65 78 74 72  he required extr
8110: 61 0a 20 20 63 6f 64 65 2e 20 20 4f 6e 20 75 6e  a.  code.  On un
8120: 69 78 20 61 6e 64 20 77 69 6e 64 6f 77 73 20 73  ix and windows s
8130: 79 73 74 65 6d 73 2c 20 61 20 64 65 76 65 6c 6f  ystems, a develo
8140: 70 65 72 20 63 61 6e 20 61 70 70 65 6e 64 20 74  per can append t
8150: 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 0a 20  he text of the. 
8160: 20 22 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63 22   "test_sqllog.c"
8170: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 69 6c   source code fil
8180: 65 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20  e to the end of 
8190: 61 6e 20 22 73 71 6c 69 74 65 33 2e 63 22 20 61  an "sqlite3.c" a
81a0: 6d 61 6c 67 61 6d 61 74 69 6f 6e 2c 0a 20 20 72  malgamation,.  r
81b0: 65 63 6f 6d 70 69 6c 65 20 74 68 65 20 61 70 70  ecompile the app
81c0: 6c 69 63 61 74 69 6f 6e 20 75 73 69 6e 67 20 74  lication using t
81d0: 68 65 20 2d 44 53 51 4c 49 54 45 5f 45 4e 41 42  he -DSQLITE_ENAB
81e0: 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70 74 69 6f 6e  LE_SQLLOG option
81f0: 2c 20 74 68 65 6e 20 0a 20 20 63 6f 6e 74 72 6f  , then .  contro
8200: 6c 20 6c 6f 67 67 69 6e 67 20 75 73 69 6e 67 20  l logging using 
8210: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69  environment vari
8220: 61 62 6c 65 73 2e 20 20 53 65 65 20 74 68 65 20  ables.  See the 
8230: 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74 20 6f  header comment o
8240: 6e 20 0a 20 20 74 68 65 20 22 74 65 73 74 5f 73  n .  the "test_s
8250: 71 6c 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65 20  qllog.c" source 
8260: 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69 6f  file for additio
8270: 6e 61 6c 20 64 65 74 61 69 6c 2e 20 20 0a 7d 0a  nal detail.  .}.
8280: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
8290: 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53  {SQLITE_ENABLE_S
82a0: 54 41 54 32 7d 20 7b 0a 20 20 54 68 69 73 20 6f  TAT2} {.  This o
82b0: 70 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 63 61  ption used to ca
82c0: 75 73 65 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45  use the [ANALYZE
82d0: 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 6f 6c  ] command to col
82e0: 6c 65 63 74 0a 20 20 69 6e 64 65 78 20 68 69 73  lect.  index his
82f0: 74 6f 67 72 61 6d 20 64 61 74 61 20 69 6e 20 74  togram data in t
8300: 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 73 74 61  he <b>sqlite_sta
8310: 74 32 3c 2f 62 3e 20 74 61 62 6c 65 2e 20 20 42  t2</b> table.  B
8320: 75 74 20 74 68 61 74 0a 20 20 66 75 6e 63 74 69  ut that.  functi
8330: 6f 6e 61 6c 69 74 79 20 77 61 73 20 73 75 70 65  onality was supe
8340: 72 63 65 64 65 64 20 62 79 20 5b 53 51 4c 49 54  rceded by [SQLIT
8350: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5d 20  E_ENABLE_STAT3] 
8360: 61 73 20 6f 66 0a 20 20 53 51 4c 69 74 65 20 76  as of.  SQLite v
8370: 65 72 73 69 6f 6e 20 33 2e 37 2e 39 2e 20 20 54  ersion 3.7.9.  T
8380: 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  he SQLITE_ENABLE
8390: 5f 53 54 41 54 32 20 63 6f 6d 70 69 6c 65 2d 74  _STAT2 compile-t
83a0: 69 6d 65 20 6f 70 74 69 6f 6e 0a 20 20 69 73 20  ime option.  is 
83b0: 6e 6f 77 20 61 20 6e 6f 2d 6f 70 2e 0a 7d 0a 0a  now a no-op..}..
83c0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
83d0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54  SQLITE_ENABLE_ST
83e0: 41 54 33 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  AT3} {.  This op
83f0: 74 69 6f 6e 20 61 64 64 73 20 61 64 64 69 74 69  tion adds additi
8400: 6f 6e 61 6c 20 6c 6f 67 69 63 20 74 6f 20 74 68  onal logic to th
8410: 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d  e [ANALYZE] comm
8420: 61 6e 64 20 61 6e 64 20 74 6f 0a 20 20 74 68 65  and and to.  the
8430: 20 5b 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 5d   [query planner]
8440: 20 74 68 61 74 20 63 61 6e 20 68 65 6c 70 20 53   that can help S
8450: 51 4c 69 74 65 20 74 6f 20 63 68 6f 73 65 20 61  QLite to chose a
8460: 20 62 65 74 74 65 72 20 71 75 65 72 79 20 70 6c   better query pl
8470: 61 6e 0a 20 20 75 6e 64 65 72 20 63 65 72 74 61  an.  under certa
8480: 69 6e 20 73 69 74 75 61 74 69 6f 6e 73 2e 20 20  in situations.  
8490: 54 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f  The [ANALYZE] co
84a0: 6d 6d 61 6e 64 20 69 73 20 65 6e 68 61 6e 63 65  mmand is enhance
84b0: 64 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20 68  d to collect.  h
84c0: 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 66 72  istogram data fr
84d0: 6f 6d 20 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74  om the left-most
84e0: 20 63 6f 6c 75 6d 6e 20 6f 66 20 65 61 63 68 20   column of each 
84f0: 69 6e 64 65 78 20 61 6e 64 20 73 74 6f 72 65 20  index and store 
8500: 74 68 61 74 20 64 61 74 61 0a 20 20 69 6e 20 74  that data.  in t
8510: 68 65 20 5b 73 71 6c 69 74 65 5f 73 74 61 74 33  he [sqlite_stat3
8520: 5d 20 74 61 62 6c 65 2e 20 20 54 68 65 20 71 75  ] table.  The qu
8530: 65 72 79 20 70 6c 61 6e 6e 65 72 20 77 69 6c 6c  ery planner will
8540: 20 74 68 65 6e 20 75 73 65 20 74 68 65 0a 20 20   then use the.  
8550: 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 74  histogram data t
8560: 6f 20 68 65 6c 70 20 69 74 20 6d 61 6b 65 20 62  o help it make b
8570: 65 74 74 65 72 20 69 6e 64 65 78 20 63 68 6f 69  etter index choi
8580: 63 65 73 2e 20 20 4e 6f 74 65 2c 20 68 6f 77 65  ces.  Note, howe
8590: 76 65 72 2c 0a 20 20 74 68 61 74 20 74 68 65 20  ver,.  that the 
85a0: 75 73 65 20 6f 66 20 68 69 73 74 6f 67 72 61 6d  use of histogram
85b0: 20 64 61 74 61 20 69 6e 20 71 75 65 72 79 20 70   data in query p
85c0: 6c 61 6e 6e 65 72 20 76 69 6f 6c 61 74 65 73 20  lanner violates 
85d0: 74 68 65 0a 20 20 5b 71 75 65 72 79 20 70 6c 61  the.  [query pla
85e0: 6e 6e 65 72 20 73 74 61 62 69 6c 69 74 79 20 67  nner stability g
85f0: 75 61 72 61 6e 74 65 65 5d 20 77 68 69 63 68 20  uarantee] which 
8600: 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f 20  is important to 
8610: 73 6f 6d 65 20 61 70 70 6c 69 63 61 74 69 6f 6e  some application
8620: 73 2e 0a 20 20 3c 70 3e 0a 7d 0a 0a 43 4f 4d 50  s..  <p>.}..COMP
8630: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
8640: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 7d  TE_ENABLE_STAT4}
8650: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
8660: 20 61 64 64 73 20 61 64 64 69 74 69 6f 6e 61 6c   adds additional
8670: 20 6c 6f 67 69 63 20 74 6f 20 74 68 65 20 5b 41   logic to the [A
8680: 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20  NALYZE] command 
8690: 61 6e 64 20 74 6f 0a 20 20 74 68 65 20 5b 71 75  and to.  the [qu
86a0: 65 72 79 20 70 6c 61 6e 6e 65 72 5d 20 74 68 61  ery planner] tha
86b0: 74 20 63 61 6e 20 68 65 6c 70 20 53 51 4c 69 74  t can help SQLit
86c0: 65 20 74 6f 20 63 68 6f 73 65 20 61 20 62 65 74  e to chose a bet
86d0: 74 65 72 20 71 75 65 72 79 20 70 6c 61 6e 0a 20  ter query plan. 
86e0: 20 75 6e 64 65 72 20 63 65 72 74 61 69 6e 20 73   under certain s
86f0: 69 74 75 61 74 69 6f 6e 73 2e 20 20 54 68 65 20  ituations.  The 
8700: 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e  [ANALYZE] comman
8710: 64 20 69 73 20 65 6e 68 61 6e 63 65 64 20 74 6f  d is enhanced to
8720: 20 63 6f 6c 6c 65 63 74 0a 20 20 68 69 73 74 6f   collect.  histo
8730: 67 72 61 6d 20 64 61 74 61 20 66 72 6f 6d 20 61  gram data from a
8740: 6c 6c 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 65 76  ll columns of ev
8750: 65 72 79 20 69 6e 64 65 78 20 61 6e 64 20 73 74  ery index and st
8760: 6f 72 65 20 74 68 61 74 20 64 61 74 61 0a 20 20  ore that data.  
8770: 69 6e 20 74 68 65 20 5b 73 71 6c 69 74 65 5f 73  in the [sqlite_s
8780: 74 61 74 34 5d 20 74 61 62 6c 65 2e 20 20 54 68  tat4] table.  Th
8790: 65 20 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20  e query planner 
87a0: 77 69 6c 6c 20 74 68 65 6e 20 75 73 65 20 74 68  will then use th
87b0: 65 0a 20 20 68 69 73 74 6f 67 72 61 6d 20 64 61  e.  histogram da
87c0: 74 61 20 74 6f 20 68 65 6c 70 20 69 74 20 6d 61  ta to help it ma
87d0: 6b 65 20 62 65 74 74 65 72 20 69 6e 64 65 78 20  ke better index 
87e0: 63 68 6f 69 63 65 73 2e 20 20 54 68 65 20 64 6f  choices.  The do
87f0: 77 6e 73 69 64 65 20 6f 66 0a 20 20 74 68 69 73  wnside of.  this
8800: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
8810: 74 69 6f 6e 20 69 73 20 74 68 61 74 20 69 74 20  tion is that it 
8820: 76 69 6f 6c 61 74 65 73 20 74 68 65 0a 20 20 5b  violates the.  [
8830: 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20 73 74  query planner st
8840: 61 62 69 6c 69 74 79 20 67 75 61 72 61 6e 74 65  ability guarante
8850: 65 5d 20 6d 61 6b 69 6e 67 20 69 74 20 6d 6f 72  e] making it mor
8860: 65 20 64 69 66 66 69 63 75 6c 74 20 74 6f 20 65  e difficult to e
8870: 6e 73 75 72 65 0a 20 20 63 6f 6e 73 69 73 74 65  nsure.  consiste
8880: 6e 74 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 69  nt performance i
8890: 6e 20 6d 61 73 73 2d 70 72 6f 64 75 63 65 64 20  n mass-produced 
88a0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 20 20  applications..  
88b0: 3c 70 3e 0a 20 20 53 51 4c 49 54 45 5f 45 4e 41  <p>.  SQLITE_ENA
88c0: 42 4c 45 5f 53 54 41 54 34 20 69 73 20 61 6e 20  BLE_STAT4 is an 
88d0: 65 6e 68 61 6e 63 65 6d 65 6e 74 20 6f 66 20 5b  enhancement of [
88e0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54  SQLITE_ENABLE_ST
88f0: 41 54 33 5d 2e 20 20 53 54 41 54 33 0a 20 20 6f  AT3].  STAT3.  o
8900: 6e 6c 79 20 72 65 63 6f 72 64 65 64 20 68 69 73  nly recorded his
8910: 74 6f 67 72 61 6d 20 64 61 74 61 20 66 6f 72 20  togram data for 
8920: 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 63 6f  the left-most co
8930: 6c 75 6d 6e 20 6f 66 20 65 61 63 68 20 69 6e 64  lumn of each ind
8940: 65 78 0a 20 20 77 68 65 72 65 61 73 20 74 68 65  ex.  whereas the
8950: 20 53 54 41 54 34 20 65 6e 68 61 6e 63 65 6d 65   STAT4 enhanceme
8960: 6e 74 20 72 65 63 6f 72 64 73 20 68 69 73 74 6f  nt records histo
8970: 67 72 61 6d 20 64 61 74 61 20 66 72 6f 6d 20 61  gram data from a
8980: 6c 6c 20 63 6f 6c 75 6d 6e 73 0a 20 20 6f 66 20  ll columns.  of 
8990: 65 61 63 68 20 69 6e 64 65 78 2e 0a 20 20 54 68  each index..  Th
89a0: 65 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  e [SQLITE_ENABLE
89b0: 5f 53 54 41 54 33 5d 20 63 6f 6d 70 69 6c 65 2d  _STAT3] compile-
89c0: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 61  time option is a
89d0: 20 6e 6f 2d 6f 70 20 61 6e 64 20 69 73 20 69 67   no-op and is ig
89e0: 6e 6f 72 65 64 0a 20 20 69 66 20 74 68 65 20 53  nored.  if the S
89f0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41  QLITE_ENABLE_STA
8a00: 54 34 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  T4 compile-time 
8a10: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 0a  option is used..
8a20: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
8a30: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
8a40: 5f 54 52 45 45 5f 45 58 50 4c 41 49 4e 7d 20 7b  _TREE_EXPLAIN} {
8a50: 0a 20 20 54 68 69 73 20 63 6f 6d 70 69 6c 65 2d  .  This compile-
8a60: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 6e  time option is n
8a70: 6f 20 6c 6f 6e 67 65 72 20 75 73 65 64 2e 0a 7d  o longer used..}
8a80: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
8a90: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
8aa0: 55 50 44 41 54 45 5f 44 45 4c 45 54 45 5f 4c 49  UPDATE_DELETE_LI
8ab0: 4d 49 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  MIT} {.  This op
8ac0: 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 61 6e 20  tion enables an 
8ad0: 6f 70 74 69 6f 6e 61 6c 20 4f 52 44 45 52 20 42  optional ORDER B
8ae0: 59 20 61 6e 64 20 4c 49 4d 49 54 20 63 6c 61 75  Y and LIMIT clau
8af0: 73 65 20 6f 6e 20 0a 20 20 5b 55 50 44 41 54 45  se on .  [UPDATE
8b00: 5d 20 61 6e 64 20 5b 44 45 4c 45 54 45 5d 20 73  ] and [DELETE] s
8b10: 74 61 74 65 6d 65 6e 74 73 2e 0a 0a 20 20 3c 70  tatements...  <p
8b20: 3e 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  >If this option 
8b30: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e  is defined, then
8b40: 20 69 74 20 6d 75 73 74 20 61 6c 73 6f 20 62 65   it must also be
8b50: 20 0a 20 20 64 65 66 69 6e 65 64 20 77 68 65 6e   .  defined when
8b60: 20 75 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f   using the 'lemo
8b70: 6e 27 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72  n' tool to gener
8b80: 61 74 65 20 61 20 70 61 72 73 65 2e 63 0a 20 20  ate a parse.c.  
8b90: 66 69 6c 65 2e 20 42 65 63 61 75 73 65 20 6f 66  file. Because of
8ba0: 20 74 68 69 73 2c 20 74 68 69 73 20 6f 70 74 69   this, this opti
8bb0: 6f 6e 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75  on may only be u
8bc0: 73 65 64 20 77 68 65 6e 20 74 68 65 20 6c 69 62  sed when the lib
8bd0: 72 61 72 79 20 69 73 20 62 75 69 6c 74 0a 20 20  rary is built.  
8be0: 66 72 6f 6d 20 73 6f 75 72 63 65 2c 20 6e 6f 74  from source, not
8bf0: 20 66 72 6f 6d 20 74 68 65 20 5b 61 6d 61 6c 67   from the [amalg
8c00: 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d  amation] or from
8c10: 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20   the collection 
8c20: 6f 66 0a 20 20 70 72 65 2d 70 61 63 6b 61 67 65  of.  pre-package
8c30: 64 20 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64  d C files provid
8c40: 65 64 20 66 6f 72 20 6e 6f 6e 2d 55 6e 69 78 20  ed for non-Unix 
8c50: 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f  like platforms o
8c60: 6e 20 74 68 65 20 77 65 62 73 69 74 65 2e 0a 20  n the website.. 
8c70: 20 3c 2f 70 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45   </p>.}..COMPILE
8c80: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
8c90: 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f  ENABLE_UNLOCK_NO
8ca0: 54 49 46 59 7d 20 7b 0a 20 20 54 68 69 73 20 6f  TIFY} {.  This o
8cb0: 70 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 74 68  ption enables th
8cc0: 65 20 5b 73 71 6c 69 74 65 33 5f 75 6e 6c 6f 63  e [sqlite3_unloc
8cd0: 6b 5f 6e 6f 74 69 66 79 28 29 5d 20 69 6e 74 65  k_notify()] inte
8ce0: 72 66 61 63 65 20 61 6e 64 0a 20 20 69 74 73 20  rface and.  its 
8cf0: 61 73 73 6f 63 69 61 74 65 64 20 66 75 6e 63 74  associated funct
8d00: 69 6f 6e 61 6c 69 74 79 2e 20 20 53 65 65 20 74  ionality.  See t
8d10: 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  he documentation
8d20: 20 74 69 74 6c 65 64 0a 20 20 5b 55 73 69 6e 67   titled.  [Using
8d30: 20 74 68 65 20 53 51 4c 69 74 65 20 55 6e 6c 6f   the SQLite Unlo
8d40: 63 6b 20 4e 6f 74 69 66 69 63 61 74 69 6f 6e 20  ck Notification 
8d50: 46 65 61 74 75 72 65 5d 20 66 6f 72 20 61 64 64  Feature] for add
8d60: 69 74 69 6f 6e 61 6c 0a 20 20 69 6e 66 6f 72 6d  itional.  inform
8d70: 61 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  ation..}..COMPIL
8d80: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8d90: 5f 53 4f 55 4e 44 45 58 7d 20 7b 0a 20 20 54 68  _SOUNDEX} {.  Th
8da0: 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65  is option enable
8db0: 73 20 74 68 65 20 5b 73 6f 75 6e 64 65 78 28 29  s the [soundex()
8dc0: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 5d 2e 0a   SQL function]..
8dd0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
8de0: 4e 20 7b 53 51 4c 49 54 45 5f 55 53 45 5f 46 43  N {SQLITE_USE_FC
8df0: 4e 54 4c 5f 54 52 41 43 45 7d 20 7b 0a 20 20 54  NTL_TRACE} {.  T
8e00: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
8e10: 73 20 53 51 4c 69 74 65 20 74 6f 20 69 73 73 75  s SQLite to issu
8e20: 65 20 65 78 74 72 61 20 5b 53 51 4c 49 54 45 5f  e extra [SQLITE_
8e30: 46 43 4e 54 4c 5f 54 52 41 43 45 5d 20 66 69 6c  FCNTL_TRACE] fil
8e40: 65 20 63 6f 6e 74 72 6f 6c 73 0a 20 20 74 6f 20  e controls.  to 
8e50: 70 72 6f 76 69 64 65 20 73 75 70 70 6c 65 6d 65  provide suppleme
8e60: 6e 74 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f  ntary informatio
8e70: 6e 20 74 6f 20 74 68 65 20 56 46 53 2e 20 20 54  n to the VFS.  T
8e80: 68 65 20 22 76 66 73 6c 6f 67 2e 63 22 20 65 78  he "vfslog.c" ex
8e90: 74 65 6e 73 69 6f 6e 0a 20 20 6d 61 6b 65 73 20  tension.  makes 
8ea0: 75 73 65 20 6f 66 20 74 68 69 73 20 74 6f 20 70  use of this to p
8eb0: 72 6f 76 69 64 65 20 65 6e 68 61 6e 63 65 64 20  rovide enhanced 
8ec0: 6c 6f 67 73 20 6f 66 20 56 46 53 20 61 63 74 69  logs of VFS acti
8ed0: 76 69 74 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  vity..}..COMPILE
8ee0: 5f 4f 50 54 49 4f 4e 20 7b 59 59 54 52 41 43 4b  _OPTION {YYTRACK
8ef0: 4d 41 58 53 54 41 43 4b 44 45 50 54 48 7d 20 7b  MAXSTACKDEPTH} {
8f00: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
8f10: 61 75 73 65 73 20 74 68 65 20 4c 41 4c 52 28 31  auses the LALR(1
8f20: 29 20 70 61 72 73 65 72 20 73 74 61 63 6b 20 64  ) parser stack d
8f30: 65 70 74 68 20 74 6f 20 62 65 20 74 72 61 63 6b  epth to be track
8f40: 65 64 0a 20 20 61 6e 64 20 72 65 70 6f 72 74 65  ed.  and reporte
8f50: 64 20 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c  d using the [sql
8f60: 69 74 65 33 5f 73 74 61 74 75 73 5d 28 5b 53 51  ite3_status]([SQ
8f70: 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 52 53  LITE_STATUS_PARS
8f80: 45 52 5f 53 54 41 43 4b 5d 2c 2e 2e 2e 29 0a 20  ER_STACK],...). 
8f90: 20 69 6e 74 65 72 66 61 63 65 2e 20 20 53 51 4c   interface.  SQL
8fa0: 69 74 65 27 73 20 4c 41 4c 52 28 31 29 20 70 61  ite's LALR(1) pa
8fb0: 72 73 65 72 20 68 61 73 20 61 20 66 69 78 65 64  rser has a fixed
8fc0: 20 73 74 61 63 6b 20 64 65 70 74 68 0a 20 20 28   stack depth.  (
8fd0: 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 63 6f  determined at co
8fe0: 6d 70 69 6c 65 2d 74 69 6d 65 20 75 73 69 6e 67  mpile-time using
8ff0: 20 74 68 65 20 5b 59 59 53 54 41 43 4b 44 45 50   the [YYSTACKDEP
9000: 54 48 5d 20 6f 70 74 69 6f 6e 73 29 2e 0a 20 20  TH] options)..  
9010: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 6e 20  This option can 
9020: 62 65 20 75 73 65 64 20 74 6f 20 68 65 6c 70 20  be used to help 
9030: 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 6e 20  determine if an 
9040: 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73 0a 20  application is. 
9050: 20 67 65 74 74 69 6e 67 20 63 6c 6f 73 65 20 74   getting close t
9060: 6f 20 65 78 63 65 65 64 69 6e 67 20 74 68 65 20  o exceeding the 
9070: 6d 61 78 69 6d 75 6d 20 4c 41 4c 52 28 31 29 20  maximum LALR(1) 
9080: 73 74 61 63 6b 20 64 65 70 74 68 2e 0a 7d 0a 3c  stack depth..}.<
9090: 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22  /tcl>..<a name="
90a0: 64 69 73 61 62 6c 65 66 65 61 74 75 72 65 73 22  disablefeatures"
90b0: 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 36 20 4f 70  ></a>.<h2>1.6 Op
90c0: 74 69 6f 6e 73 20 54 6f 20 44 69 73 61 62 6c 65  tions To Disable
90d0: 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d 61 6c   Features Normal
90e0: 6c 79 20 54 75 72 6e 65 64 20 4f 6e 3c 2f 68 32  ly Turned On</h2
90f0: 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45  >..<tcl>.COMPILE
9100: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
9110: 44 49 53 41 42 4c 45 5f 4c 46 53 7d 20 7b 0a 20  DISABLE_LFS} {. 
9120: 20 49 66 20 74 68 69 73 20 43 2d 70 72 65 70 72   If this C-prepr
9130: 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 73  ocessor macro is
9140: 20 64 65 66 69 6e 65 64 2c 20 6c 61 72 67 65 20   defined, large 
9150: 66 69 6c 65 20 73 75 70 70 6f 72 74 0a 20 20 69  file support.  i
9160: 73 20 64 69 73 61 62 6c 65 64 2e 0a 7d 0a 0a 43  s disabled..}..C
9170: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
9180: 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 44 49  QLITE_DISABLE_DI
9190: 52 53 59 4e 43 7d 20 7b 0a 20 20 49 66 20 74 68  RSYNC} {.  If th
91a0: 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f  is C-preprocesso
91b0: 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  r macro is defin
91c0: 65 64 2c 20 64 69 72 65 63 74 6f 72 79 20 73 79  ed, directory sy
91d0: 6e 63 73 0a 20 20 61 72 65 20 64 69 73 61 62 6c  ncs.  are disabl
91e0: 65 64 2e 20 20 53 51 4c 69 74 65 20 74 79 70 69  ed.  SQLite typi
91f0: 63 61 6c 6c 79 20 61 74 74 65 6d 70 74 73 20 74  cally attempts t
9200: 6f 20 73 79 6e 63 20 74 68 65 20 70 61 72 65 6e  o sync the paren
9210: 74 0a 20 20 64 69 72 65 63 74 6f 72 79 20 77 68  t.  directory wh
9220: 65 6e 20 61 20 66 69 6c 65 20 69 73 20 64 65 6c  en a file is del
9230: 65 74 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74  eted to ensure t
9240: 68 65 20 64 69 72 65 63 74 6f 72 79 0a 20 20 65  he directory.  e
9250: 6e 74 72 69 65 73 20 61 72 65 20 75 70 64 61 74  ntries are updat
9260: 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 6f  ed immediately o
9270: 6e 20 64 69 73 6b 2e 0a 7d 0a 0a 43 4f 4d 50 49  n disk..}..COMPI
9280: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
9290: 45 5f 44 49 53 41 42 4c 45 5f 46 54 53 33 5f 55  E_DISABLE_FTS3_U
92a0: 4e 49 43 4f 44 45 7d 20 7b 0a 20 20 49 66 20 74  NICODE} {.  If t
92b0: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
92c0: 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  or macro is defi
92d0: 6e 65 64 2c 20 74 68 65 20 5b 75 6e 69 63 6f 64  ned, the [unicod
92e0: 65 36 31 5d 20 74 6f 6b 65 6e 69 7a 65 72 0a 20  e61] tokenizer. 
92f0: 20 69 6e 20 5b 46 54 53 33 5d 20 69 73 20 6f 6d   in [FTS3] is om
9300: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62  itted from the b
9310: 75 69 6c 64 20 61 6e 64 20 69 73 20 75 6e 61 76  uild and is unav
9320: 61 69 6c 61 62 6c 65 20 74 6f 20 0a 20 20 61 70  ailable to .  ap
9330: 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43  plications..}..C
9340: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
9350: 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 46 54  QLITE_DISABLE_FT
9360: 53 34 5f 44 45 46 45 52 52 45 44 7d 20 7b 0a 20  S4_DEFERRED} {. 
9370: 20 49 66 20 74 68 69 73 20 43 2d 70 72 65 70 72   If this C-prepr
9380: 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 64 69  ocessor macro di
9390: 73 61 62 6c 65 73 20 74 68 65 20 22 64 65 66 65  sables the "defe
93a0: 72 72 65 64 20 74 6f 6b 65 6e 22 20 6f 70 74 69  rred token" opti
93b0: 6d 69 7a 61 74 69 6f 6e 0a 20 20 69 6e 20 5b 46  mization.  in [F
93c0: 54 53 34 5d 2e 20 20 54 68 65 20 22 64 65 66 65  TS4].  The "defe
93d0: 72 72 65 64 20 74 6f 6b 65 6e 22 20 6f 70 74 69  rred token" opti
93e0: 6d 69 7a 61 74 69 6f 6e 20 61 76 6f 69 64 73 20  mization avoids 
93f0: 6c 6f 61 64 69 6e 67 20 6d 61 73 73 69 76 65 0a  loading massive.
9400: 20 20 70 6f 73 74 69 6e 67 20 6c 69 73 74 73 20    posting lists 
9410: 66 6f 72 20 74 65 72 6d 73 20 74 68 61 74 20 61  for terms that a
9420: 72 65 20 69 6e 20 6d 6f 73 74 20 64 6f 63 75 6d  re in most docum
9430: 65 6e 74 73 20 6f 66 20 74 68 65 20 63 6f 6c 6c  ents of the coll
9440: 65 63 74 69 6f 6e 0a 20 20 61 6e 64 20 69 6e 73  ection.  and ins
9450: 74 65 61 64 20 73 69 6d 70 6c 79 20 73 63 61 6e  tead simply scan
9460: 73 20 66 6f 72 20 74 68 6f 73 65 20 74 6f 6b 65  s for those toke
9470: 6e 73 20 69 6e 20 74 68 65 20 64 6f 63 75 6d 65  ns in the docume
9480: 6e 74 20 73 6f 75 72 63 65 2e 20 20 5b 46 54 53  nt source.  [FTS
9490: 34 5d 0a 20 20 73 68 6f 75 6c 64 20 67 65 74 20  4].  should get 
94a0: 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65  exactly the same
94b0: 20 61 6e 73 77 65 72 20 62 6f 74 68 20 77 69 74   answer both wit
94c0: 68 20 61 6e 64 20 77 69 74 68 6f 75 74 20 74 68  h and without th
94d0: 69 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e  is optimization.
94e0: 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 74 63 6c 3e  .}.</tcl>..<tcl>
94f0: 0a 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20 22  .  hd_fragment "
9500: 6f 6d 69 74 66 65 61 74 75 72 65 73 22 0a 20 20  omitfeatures".  
9510: 68 64 5f 6b 65 79 77 6f 72 64 73 20 22 6f 6d 69  hd_keywords "omi
9520: 74 66 65 61 74 75 72 65 73 22 0a 3c 2f 74 63 6c  tfeatures".</tcl
9530: 3e 0a 3c 68 32 3e 31 2e 37 20 4f 70 74 69 6f 6e  >.<h2>1.7 Option
9540: 73 20 54 6f 20 4f 6d 69 74 20 46 65 61 74 75 72  s To Omit Featur
9550: 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20  es</h2>..<p>The 
9560: 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6f 6e  following option
9570: 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  s can be used to
9580: 20 0a 5b 72 65 6c 66 6f 6f 74 70 72 69 6e 74 20   .[relfootprint 
9590: 7c 20 72 65 64 75 63 65 20 74 68 65 20 73 69 7a  | reduce the siz
95a0: 65 20 6f 66 20 74 68 65 20 63 6f 6d 70 69 6c 65  e of the compile
95b0: 64 20 6c 69 62 72 61 72 79 5d 0a 62 79 20 6f 6d  d library].by om
95c0: 69 74 74 69 6e 67 20 75 6e 75 73 65 64 20 66 65  itting unused fe
95d0: 61 74 75 72 65 73 2e 20 54 68 69 73 20 69 73 20  atures. This is 
95e0: 70 72 6f 62 61 62 6c 79 20 6f 6e 6c 79 20 75 73  probably only us
95f0: 65 66 75 6c 0a 69 6e 20 65 6d 62 65 64 64 65 64  eful.in embedded
9600: 20 73 79 73 74 65 6d 73 20 77 68 65 72 65 20 73   systems where s
9610: 70 61 63 65 20 69 73 20 65 73 70 65 63 69 61 6c  pace is especial
9620: 6c 79 20 74 69 67 68 74 2c 20 61 73 20 65 76 65  ly tight, as eve
9630: 6e 20 77 69 74 68 20 61 6c 6c 0a 66 65 61 74 75  n with all.featu
9640: 72 65 73 20 69 6e 63 6c 75 64 65 64 20 74 68 65  res included the
9650: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
9660: 69 73 20 72 65 6c 61 74 69 76 65 6c 79 20 73 6d  is relatively sm
9670: 61 6c 6c 2e 20 44 6f 6e 27 74 20 66 6f 72 67 65  all. Don't forge
9680: 74 0a 74 6f 20 74 65 6c 6c 20 79 6f 75 72 20 63  t.to tell your c
9690: 6f 6d 70 69 6c 65 72 20 74 6f 20 6f 70 74 69 6d  ompiler to optim
96a0: 69 7a 65 20 66 6f 72 20 62 69 6e 61 72 79 20 73  ize for binary s
96b0: 69 7a 65 21 20 28 74 68 65 20 2d 4f 73 20 6f 70  ize! (the -Os op
96c0: 74 69 6f 6e 20 69 66 0a 75 73 69 6e 67 20 47 43  tion if.using GC
96d0: 43 29 2e 20 20 54 65 6c 6c 69 6e 67 20 79 6f 75  C).  Telling you
96e0: 72 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 6f 70  r compiler to op
96f0: 74 69 6d 69 7a 65 20 66 6f 72 20 73 69 7a 65 20  timize for size 
9700: 75 73 75 61 6c 6c 79 20 68 61 73 0a 61 20 6d 75  usually has.a mu
9710: 63 68 20 6c 61 72 67 65 72 20 69 6d 70 61 63 74  ch larger impact
9720: 20 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f 6f 74   on library foot
9730: 70 72 69 6e 74 20 74 68 61 6e 20 65 6d 70 6c 6f  print than emplo
9740: 79 69 6e 67 20 61 6e 79 20 6f 66 20 74 68 65 73  ying any of thes
9750: 65 0a 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  e.compile-time o
9760: 70 74 69 6f 6e 73 2e 20 20 59 6f 75 20 73 68 6f  ptions.  You sho
9770: 75 6c 64 20 61 6c 73 6f 20 76 65 72 69 66 79 20  uld also verify 
9780: 74 68 61 74 20 0a 3c 61 20 68 72 65 66 3d 22 23  that .<a href="#
9790: 64 65 62 75 67 6f 70 74 69 6f 6e 73 22 3e 64 65  debugoptions">de
97a0: 62 75 67 67 69 6e 67 20 6f 70 74 69 6f 6e 73 3c  bugging options<
97b0: 2f 61 3e 20 61 72 65 20 64 69 73 61 62 6c 65 64  /a> are disabled
97c0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6d 61  .</p>..<p>The ma
97d0: 63 72 6f 73 20 69 6e 20 74 68 69 73 20 73 65 63  cros in this sec
97e0: 74 69 6f 6e 20 64 6f 20 6e 6f 74 20 72 65 71 75  tion do not requ
97f0: 69 72 65 20 76 61 6c 75 65 73 2e 20 54 68 65 20  ire values. The 
9800: 66 6f 6c 6c 6f 77 69 6e 67 20 0a 63 6f 6d 70 69  following .compi
9810: 6c 61 74 69 6f 6e 20 73 77 69 74 63 68 65 73 20  lation switches 
9820: 61 6c 6c 20 68 61 76 65 20 74 68 65 20 73 61 6d  all have the sam
9830: 65 20 65 66 66 65 63 74 3a 3c 62 72 3e 0a 2d 44  e effect:<br>.-D
9840: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45  SQLITE_OMIT_ALTE
9850: 52 54 41 42 4c 45 3c 62 72 3e 0a 2d 44 53 51 4c  RTABLE<br>.-DSQL
9860: 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41  ITE_OMIT_ALTERTA
9870: 42 4c 45 3d 31 3c 62 72 3e 0a 2d 44 53 51 4c 49  BLE=1<br>.-DSQLI
9880: 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42  TE_OMIT_ALTERTAB
9890: 4c 45 3d 30 0a 3c 2f 70 3e 0a 0a 3c 70 3e 49 66  LE=0.</p>..<p>If
98a0: 20 61 6e 79 20 6f 66 20 74 68 65 73 65 20 6f 70   any of these op
98b0: 74 69 6f 6e 73 20 61 72 65 20 64 65 66 69 6e 65  tions are define
98c0: 64 2c 20 74 68 65 6e 20 74 68 65 20 73 61 6d 65  d, then the same
98d0: 20 73 65 74 20 6f 66 20 53 51 4c 49 54 45 5f 4f   set of SQLITE_O
98e0: 4d 49 54 5f 2a 0a 6f 70 74 69 6f 6e 73 20 6d 75  MIT_*.options mu
98f0: 73 74 20 61 6c 73 6f 20 62 65 20 64 65 66 69 6e  st also be defin
9900: 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20 74 68  ed when using th
9910: 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74  e 'lemon' tool t
9920: 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 0a 70  o generate the.p
9930: 61 72 73 65 2e 63 20 66 69 6c 65 20 61 6e 64 20  arse.c file and 
9940: 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 74  when compiling t
9950: 68 65 20 27 6d 6b 6b 65 79 77 6f 72 64 68 61 73  he 'mkkeywordhas
9960: 68 27 20 74 6f 6f 6c 20 77 68 69 63 68 20 67 65  h' tool which ge
9970: 6e 65 72 61 74 65 73 20 0a 74 68 65 20 6b 65 79  nerates .the key
9980: 77 6f 72 64 68 61 73 68 2e 68 20 66 69 6c 65 2e  wordhash.h file.
9990: 0a 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73  .Because of this
99a0: 2c 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73 20  , these options 
99b0: 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75 73 65 64  may only be used
99c0: 20 77 68 65 6e 20 74 68 65 20 6c 69 62 72 61 72   when the librar
99d0: 79 20 69 73 20 62 75 69 6c 74 0a 66 72 6f 6d 20  y is built.from 
99e0: 63 61 6e 6f 6e 69 63 61 6c 20 73 6f 75 72 63 65  canonical source
99f0: 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68 65 20 5b  , not from the [
9a00: 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 6f 72  amalgamation] or
9a10: 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c 65 63   from the collec
9a20: 74 69 6f 6e 20 6f 66 0a 70 72 65 2d 70 61 63 6b  tion of.pre-pack
9a30: 61 67 65 64 20 43 20 66 69 6c 65 73 20 70 72 6f  aged C files pro
9a40: 76 69 64 65 64 20 66 6f 72 20 6e 6f 6e 2d 55 6e  vided for non-Un
9a50: 69 78 20 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d  ix like platform
9a60: 73 20 6f 6e 20 74 68 65 20 77 65 62 73 69 74 65  s on the website
9a70: 2e 0a 41 6e 79 20 53 51 4c 49 54 45 5f 4f 4d 49  ..Any SQLITE_OMI
9a80: 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 77 68 69 63  T_* options whic
9a90: 68 20 63 61 6e 20 62 65 20 75 73 65 64 20 64 69  h can be used di
9aa0: 72 65 63 74 6c 79 20 77 69 74 68 20 74 68 65 20  rectly with the 
9ab0: 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 0a  [amalgamation] .
9ac0: 61 72 65 20 6c 69 73 74 65 64 20 62 65 6c 6f 77  are listed below
9ad0: 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 65 20 77  , however, the w
9ae0: 61 72 6e 69 6e 67 73 20 69 6e 20 74 68 65 20 66  arnings in the f
9af0: 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 61 67 72 61  ollowing paragra
9b00: 70 68 20 73 68 6f 75 6c 64 20 62 65 20 6e 6f 74  ph should be not
9b10: 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ed..</p>..<block
9b20: 71 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e 49 6d 70  quote>.<i><b>Imp
9b30: 6f 72 74 61 6e 74 20 4e 6f 74 65 3a 3c 2f 62 3e  ortant Note:</b>
9b40: 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54   The SQLITE_OMIT
9b50: 5f 2a 20 6f 70 74 69 6f 6e 73 20 64 6f 20 6e 6f  _* options do no
9b60: 74 20 77 6f 72 6b 20 77 69 74 68 20 74 68 65 0a  t work with the.
9b70: 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 6f  [amalgamation] o
9b80: 72 20 77 69 74 68 20 70 72 65 2d 70 61 63 6b 61  r with pre-packa
9b90: 67 65 64 20 43 20 63 6f 64 65 20 66 69 6c 65 73  ged C code files
9ba0: 2e 20 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a  .  SQLITE_OMIT_*
9bb0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70   compile-time.op
9bc0: 74 69 6f 6e 73 20 6f 6e 6c 79 20 77 6f 72 6b 20  tions only work 
9bd0: 63 6f 72 72 65 63 74 6c 79 20 77 68 65 6e 20 53  correctly when S
9be0: 51 4c 69 74 65 20 69 73 20 62 75 69 6c 74 20 66  QLite is built f
9bf0: 72 6f 6d 20 63 61 6e 6f 6e 69 63 61 6c 20 73 6f  rom canonical so
9c00: 75 72 63 65 20 66 69 6c 65 73 2e 0a 3c 2f 69 3e  urce files..</i>
9c10: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  .</blockquote>..
9c20: 0a 3c 70 3e 53 70 65 63 69 61 6c 20 76 65 72 73  .<p>Special vers
9c30: 69 6f 6e 73 20 6f 66 20 74 68 65 20 53 51 4c 69  ions of the SQLi
9c40: 74 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 20  te amalgamation 
9c50: 74 68 61 74 20 64 6f 20 77 6f 72 6b 20 77 69 74  that do work wit
9c60: 68 20 61 0a 70 72 65 64 65 74 65 72 6d 69 6e 65  h a.predetermine
9c70: 64 20 73 65 74 20 6f 66 20 53 51 4c 49 54 45 5f  d set of SQLITE_
9c80: 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 63  OMIT_* options c
9c90: 61 6e 20 62 65 20 67 65 6e 65 72 61 74 65 64 2e  an be generated.
9ca0: 20 20 54 6f 20 64 6f 20 73 6f 2c 0a 6d 61 6b 65    To do so,.make
9cb0: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 4d   a copy of the M
9cc0: 61 6b 65 66 69 6c 65 2e 6c 69 6e 75 78 2d 67 63  akefile.linux-gc
9cd0: 63 20 6d 61 6b 65 66 69 6c 65 20 74 65 6d 70 6c  c makefile templ
9ce0: 61 74 65 20 69 6e 20 74 68 65 20 63 61 6e 6f 6e  ate in the canon
9cf0: 69 63 61 6c 0a 73 6f 75 72 63 65 20 63 6f 64 65  ical.source code
9d00: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 2e 20 20   distribution.  
9d10: 43 68 61 6e 67 65 20 74 68 65 20 6e 61 6d 65 20  Change the name 
9d20: 6f 66 20 79 6f 75 72 20 63 6f 70 79 20 74 6f 20  of your copy to 
9d30: 73 69 6d 70 6c 79 20 22 4d 61 6b 65 66 69 6c 65  simply "Makefile
9d40: 22 2e 0a 54 68 65 6e 20 65 64 69 74 20 22 4d 61  "..Then edit "Ma
9d50: 6b 65 66 69 6c 65 22 20 74 6f 20 73 65 74 20 75  kefile" to set u
9d60: 70 20 61 70 70 72 6f 70 72 69 61 74 65 20 63 6f  p appropriate co
9d70: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
9d80: 6e 73 2e 20 20 54 68 65 6e 0a 74 79 70 65 3a 0a  ns.  Then.type:.
9d90: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 74 74 3e  <blockquote><tt>
9da0: 6d 61 6b 65 20 63 6c 65 61 6e 3b 20 6d 61 6b 65  make clean; make
9db0: 20 73 71 6c 69 74 65 33 2e 63 3c 2f 74 74 3e 3c   sqlite3.c</tt><
9dc0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 54 68 65  /blockquote>.The
9dd0: 20 72 65 73 75 6c 74 69 6e 67 20 22 73 71 6c 69   resulting "sqli
9de0: 74 65 33 2e 63 22 20 61 6d 61 6c 67 61 6d 61 74  te3.c" amalgamat
9df0: 69 6f 6e 20 63 6f 64 65 20 66 69 6c 65 20 28 61  ion code file (a
9e00: 6e 64 20 69 74 73 20 61 73 73 6f 63 69 61 74 65  nd its associate
9e10: 64 0a 68 65 61 64 65 72 20 66 69 6c 65 20 22 73  d.header file "s
9e20: 71 6c 69 74 65 33 2e 68 22 29 20 63 61 6e 20 74  qlite3.h") can t
9e30: 68 65 6e 20 62 65 20 6d 6f 76 65 64 20 74 6f 20  hen be moved to 
9e40: 61 20 6e 6f 6e 2d 75 6e 69 78 20 70 6c 61 74 66  a non-unix platf
9e50: 6f 72 6d 0a 66 6f 72 20 66 69 6e 61 6c 20 63 6f  orm.for final co
9e60: 6d 70 69 6c 61 74 69 6f 6e 20 75 73 69 6e 67 20  mpilation using 
9e70: 61 20 6e 61 74 69 76 65 20 63 6f 6d 70 69 6c 65  a native compile
9e80: 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 6c 6c 20 6f  r.</p>..<p>All o
9e90: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49  f the SQLITE_OMI
9ea0: 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 61 72 65 20  T_* options are 
9eb0: 75 6e 73 75 70 70 6f 72 74 65 64 2e 3c 2f 70 3e  unsupported.</p>
9ec0: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c  ..<blockquote>.<
9ed0: 69 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e 74 20 4e  i><b>Important N
9ee0: 6f 74 65 3a 3c 2f 62 3e 0a 54 68 65 20 53 51 4c  ote:</b>.The SQL
9ef0: 49 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69  ITE_OMIT_* compi
9f00: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le-time options 
9f10: 61 72 65 20 75 6e 73 75 70 70 6f 72 74 65 64 2e  are unsupported.
9f20: 0a 3c 2f 69 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .</i></blockquot
9f30: 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49  e>..<p>.The SQLI
9f40: 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c  TE_OMIT_* compil
9f50: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20 61  e-time options a
9f60: 72 65 20 75 73 75 61 6c 6c 79 20 75 6e 74 65 73  re usually untes
9f70: 74 65 64 20 61 6e 64 0a 61 72 65 20 61 6c 6d 6f  ted and.are almo
9f80: 73 74 20 63 65 72 74 61 69 6e 6c 79 20 75 6e 74  st certainly unt
9f90: 65 73 74 65 64 20 69 6e 20 63 6f 6d 62 69 6e 61  ested in combina
9fa0: 74 69 6f 6e 2e 0a 41 6e 79 20 6f 72 20 61 6c 6c  tion..Any or all
9fb0: 20 6f 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e   of these option
9fc0: 73 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 64  s may be removed
9fd0: 20 66 72 6f 6d 20 74 68 65 20 63 6f 64 65 20 69   from the code i
9fe0: 6e 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65  n future release
9ff0: 73 0a 61 6e 64 20 77 69 74 68 6f 75 74 20 77 61  s.and without wa
a000: 72 6e 69 6e 67 2e 20 20 46 6f 72 20 61 6e 79 20  rning.  For any 
a010: 70 61 72 74 69 63 75 6c 61 72 20 72 65 6c 65 61  particular relea
a020: 73 65 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 73  se, some of thes
a030: 65 0a 6f 70 74 69 6f 6e 73 20 6d 61 79 20 63 61  e.options may ca
a040: 75 73 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  use compile-time
a050: 20 6f 72 20 72 75 6e 2d 74 69 6d 65 20 66 61 69   or run-time fai
a060: 6c 75 72 65 73 2c 20 70 61 72 74 69 63 75 6c 61  lures, particula
a070: 72 6c 79 0a 77 68 65 6e 20 75 73 65 64 20 69 6e  rly.when used in
a080: 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 77 69 74   combination wit
a090: 68 20 6f 74 68 65 72 20 6f 70 74 69 6f 6e 73 2e  h other options.
a0a0: 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50  </p>..<tcl>.COMP
a0b0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
a0c0: 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42  TE_OMIT_ALTERTAB
a0d0: 4c 45 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69  LE} {.  When thi
a0e0: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69  s option is defi
a0f0: 6e 65 64 2c 20 74 68 65 20 0a 20 20 5b 41 4c 54  ned, the .  [ALT
a100: 45 52 20 54 41 42 4c 45 5d 20 63 6f 6d 6d 61 6e  ER TABLE] comman
a110: 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65  d is not include
a120: 64 20 69 6e 20 74 68 65 20 0a 20 20 6c 69 62 72  d in the .  libr
a130: 61 72 79 2e 20 45 78 65 63 75 74 69 6e 67 20 61  ary. Executing a
a140: 6e 20 5b 41 4c 54 45 52 20 54 41 42 4c 45 5d 20  n [ALTER TABLE] 
a150: 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65 73  statement causes
a160: 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a   a parse error..
a170: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
a180: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
a190: 4e 41 4c 59 5a 45 7d 20 7b 0a 20 20 57 68 65 6e  NALYZE} {.  When
a1a0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
a1b0: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 41 4e  defined, the [AN
a1c0: 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 69  ALYZE] command i
a1d0: 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 0a 20  s omitted from. 
a1e0: 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43   the build..}..C
a1f0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
a200: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 54 54 41 43  QLITE_OMIT_ATTAC
a210: 48 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  H} {.  When this
a220: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
a230: 65 64 2c 20 74 68 65 20 5b 41 54 54 41 43 48 5d  ed, the [ATTACH]
a240: 20 61 6e 64 20 5b 44 45 54 41 43 48 5d 20 63 6f   and [DETACH] co
a250: 6d 6d 61 6e 64 73 20 61 72 65 0a 20 20 6f 6d 69  mmands are.  omi
a260: 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75  tted from the bu
a270: 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ild..}..COMPILE_
a280: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
a290: 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f  MIT_AUTHORIZATIO
a2a0: 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  N} {.  Defining 
a2b0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  this option omit
a2c0: 73 20 74 68 65 20 61 75 74 68 6f 72 69 7a 61 74  s the authorizat
a2d0: 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 66 65 61  ion callback fea
a2e0: 74 75 72 65 20 66 72 6f 6d 20 74 68 65 0a 20 20  ture from the.  
a2f0: 6c 69 62 72 61 72 79 2e 20 54 68 65 20 5b 73 71  library. The [sq
a300: 6c 69 74 65 33 5f 73 65 74 5f 61 75 74 68 6f 72  lite3_set_author
a310: 69 7a 65 72 28 29 5d 20 41 50 49 20 66 75 6e 63  izer()] API func
a320: 74 69 6f 6e 20 69 73 20 6e 6f 74 20 70 72 65 73  tion is not pres
a330: 65 6e 74 0a 20 20 69 6e 20 74 68 65 20 6c 69 62  ent.  in the lib
a340: 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  rary..}..COMPILE
a350: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a360: 4f 4d 49 54 5f 41 55 54 4f 49 4e 43 52 45 4d 45  OMIT_AUTOINCREME
a370: 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  NT} {.  This opt
a380: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
a390: 6d 69 74 20 74 68 65 20 0a 20 20 5b 41 55 54 4f  mit the .  [AUTO
a3a0: 49 4e 43 52 45 4d 45 4e 54 5d 20 66 75 6e 63 74  INCREMENT] funct
a3b0: 69 6f 6e 61 6c 69 74 79 2e 20 57 68 65 6e 20 74  ionality. When t
a3c0: 68 69 73 20 0a 20 20 69 73 20 6d 61 63 72 6f 20  his .  is macro 
a3d0: 69 73 20 64 65 66 69 6e 65 64 2c 20 63 6f 6c 75  is defined, colu
a3e0: 6d 6e 73 20 64 65 63 6c 61 72 65 64 20 61 73 20  mns declared as 
a3f0: 0a 20 20 22 5b 49 4e 54 45 47 45 52 20 50 52 49  .  "[INTEGER PRI
a400: 4d 41 52 59 20 4b 45 59 5d 20 41 55 54 4f 49 4e  MARY KEY] AUTOIN
a410: 43 52 45 4d 45 4e 54 22 0a 20 20 62 65 68 61 76  CREMENT".  behav
a420: 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 61  e in the same wa
a430: 79 20 61 73 20 63 6f 6c 75 6d 6e 73 20 64 65 63  y as columns dec
a440: 6c 61 72 65 64 20 61 73 20 22 5b 49 4e 54 45 47  lared as "[INTEG
a450: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 5d 22  ER PRIMARY KEY]"
a460: 20 77 68 65 6e 20 61 20 0a 20 20 4e 55 4c 4c 20   when a .  NULL 
a470: 69 73 20 69 6e 73 65 72 74 65 64 2e 20 54 68 65  is inserted. The
a480: 20 73 71 6c 69 74 65 5f 73 65 71 75 65 6e 63 65   sqlite_sequence
a490: 20 73 79 73 74 65 6d 20 74 61 62 6c 65 20 69 73   system table is
a4a0: 20 6e 65 69 74 68 65 72 20 63 72 65 61 74 65 64   neither created
a4b0: 2c 20 6e 6f 72 0a 20 20 72 65 73 70 65 63 74 65  , nor.  respecte
a4c0: 64 20 69 66 20 69 74 20 61 6c 72 65 61 64 79 20  d if it already 
a4d0: 65 78 69 73 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  exists..}..COMPI
a4e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
a4f0: 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 7d  E_OMIT_AUTOINIT}
a500: 20 7b 0a 20 20 46 6f 72 20 62 61 63 6b 77 61 72   {.  For backwar
a510: 64 73 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79  ds compatibility
a520: 20 77 69 74 68 20 6f 6c 64 65 72 20 76 65 72 73   with older vers
a530: 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 74  ions of SQLite t
a540: 68 61 74 20 6c 61 63 6b 0a 20 20 74 68 65 20 5b  hat lack.  the [
a550: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69  sqlite3_initiali
a560: 7a 65 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2c  ze()] interface,
a570: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e   the [sqlite3_in
a580: 69 74 69 61 6c 69 7a 65 28 29 5d 20 69 6e 74 65  itialize()] inte
a590: 72 66 61 63 65 0a 20 20 69 73 20 63 61 6c 6c 65  rface.  is calle
a5a0: 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  d automatically 
a5b0: 75 70 6f 6e 20 65 6e 74 72 79 20 74 6f 20 63 65  upon entry to ce
a5c0: 72 74 61 69 6e 20 6b 65 79 20 69 6e 74 65 72 66  rtain key interf
a5d0: 61 63 65 73 20 73 75 63 68 20 61 73 0a 20 20 5b  aces such as.  [
a5e0: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 5d 2c  sqlite3_open()],
a5f0: 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 5f 72 65   [sqlite3_vfs_re
a600: 67 69 73 74 65 72 28 29 5d 2c 20 61 6e 64 20 5b  gister()], and [
a610: 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
a620: 29 5d 2e 0a 20 20 54 68 65 20 6f 76 65 72 68 65  )]..  The overhe
a630: 61 64 20 6f 66 20 69 6e 76 6f 6b 69 6e 67 20 5b  ad of invoking [
a640: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69  sqlite3_initiali
a650: 7a 65 28 29 5d 20 61 75 74 6f 6d 61 74 69 63 61  ze()] automatica
a660: 6c 6c 79 20 69 6e 20 74 68 69 73 0a 20 20 77 61  lly in this.  wa
a670: 79 20 6d 61 79 20 62 65 20 6f 6d 69 74 74 65 64  y may be omitted
a680: 20 62 79 20 62 75 69 6c 64 69 6e 67 20 53 51 4c   by building SQL
a690: 69 74 65 20 77 69 74 68 20 74 68 65 20 53 51 4c  ite with the SQL
a6a0: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49  ITE_OMIT_AUTOINI
a6b0: 54 0a 20 20 43 2d 70 72 65 70 72 6f 63 65 73 73  T.  C-preprocess
a6c0: 6f 72 20 6d 61 63 72 6f 2e 20 20 57 68 65 6e 20  or macro.  When 
a6d0: 62 75 69 6c 74 20 75 73 69 6e 67 20 53 51 4c 49  built using SQLI
a6e0: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54  TE_OMIT_AUTOINIT
a6f0: 2c 20 53 51 4c 69 74 65 0a 20 20 77 69 6c 6c 20  , SQLite.  will 
a700: 6e 6f 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  not automaticall
a710: 79 20 69 6e 69 74 69 61 6c 69 7a 65 20 69 74 73  y initialize its
a720: 65 6c 66 20 61 6e 64 20 74 68 65 20 61 70 70 6c  elf and the appl
a730: 69 63 61 74 69 6f 6e 20 69 73 20 72 65 71 75 69  ication is requi
a740: 72 65 64 0a 20 20 74 6f 20 69 6e 76 6f 6b 65 20  red.  to invoke 
a750: 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c  [sqlite3_initial
a760: 69 7a 65 28 29 5d 20 64 69 72 65 63 74 6c 79 20  ize()] directly 
a770: 70 72 69 6f 72 20 74 6f 20 62 65 67 69 6e 6e 69  prior to beginni
a780: 6e 67 20 75 73 65 20 6f 66 20 74 68 65 0a 20 20  ng use of the.  
a790: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a  SQLite library..
a7a0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
a7b0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
a7c0: 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 7d 20  UTOMATIC_INDEX} 
a7d0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
a7e0: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20  is used to omit 
a7f0: 74 68 65 20 0a 20 20 5b 61 75 74 6f 6d 61 74 69  the .  [automati
a800: 63 20 69 6e 64 65 78 69 6e 67 5d 20 66 75 6e 63  c indexing] func
a810: 74 69 6f 6e 61 6c 69 74 79 2e 0a 20 20 53 65 65  tionality..  See
a820: 20 61 6c 73 6f 3a 20 5b 53 51 4c 49 54 45 5f 44   also: [SQLITE_D
a830: 45 46 41 55 4c 54 5f 41 55 54 4f 4d 41 54 49 43  EFAULT_AUTOMATIC
a840: 5f 49 4e 44 45 58 5d 2e 0a 7d 0a 0a 43 4f 4d 50  _INDEX]..}..COMP
a850: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
a860: 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 52 45 53 45  TE_OMIT_AUTORESE
a870: 54 7d 20 7b 0a 20 20 42 79 20 64 65 66 61 75 6c  T} {.  By defaul
a880: 74 2c 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  t, the [sqlite3_
a890: 73 74 65 70 28 29 5d 20 69 6e 74 65 72 66 61 63  step()] interfac
a8a0: 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63  e will automatic
a8b0: 61 6c 6c 79 20 69 6e 76 6f 6b 65 0a 20 20 5b 73  ally invoke.  [s
a8c0: 71 6c 69 74 65 33 5f 72 65 73 65 74 28 29 5d 20  qlite3_reset()] 
a8d0: 74 6f 20 72 65 73 65 74 20 74 68 65 20 5b 70 72  to reset the [pr
a8e0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
a8f0: 5d 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 20  ] if necessary. 
a900: 20 54 68 69 73 0a 20 20 63 6f 6d 70 69 6c 65 2d   This.  compile-
a910: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 63 68 61 6e  time option chan
a920: 67 65 73 20 74 68 61 74 20 62 65 68 61 76 69 6f  ges that behavio
a930: 72 20 73 6f 20 74 68 61 74 20 5b 73 71 6c 69 74  r so that [sqlit
a940: 65 33 5f 73 74 65 70 28 29 5d 20 77 69 6c 6c 0a  e3_step()] will.
a950: 20 20 72 65 74 75 72 6e 20 5b 53 51 4c 49 54 45    return [SQLITE
a960: 5f 4d 49 53 55 53 45 5d 20 69 66 20 69 74 20 63  _MISUSE] if it c
a970: 61 6c 6c 65 64 20 61 67 61 69 6e 20 61 66 74 65  alled again afte
a980: 72 20 72 65 74 75 72 6e 69 6e 67 20 61 6e 79 74  r returning anyt
a990: 68 69 6e 67 20 6f 74 68 65 72 0a 20 20 74 68 61  hing other.  tha
a9a0: 6e 20 5b 53 51 4c 49 54 45 5f 52 4f 57 5d 2c 20  n [SQLITE_ROW], 
a9b0: 5b 53 51 4c 49 54 45 5f 42 55 53 59 5d 2c 20 6f  [SQLITE_BUSY], o
a9c0: 72 20 5b 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  r [SQLITE_LOCKED
a9d0: 5d 20 75 6e 6c 65 73 73 20 74 68 65 72 65 20 77  ] unless there w
a9e0: 61 73 20 61 6e 0a 20 20 69 6e 74 65 72 76 65 6e  as an.  interven
a9f0: 69 6e 67 20 63 61 6c 6c 20 74 6f 20 5b 73 71 6c  ing call to [sql
aa00: 69 74 65 33 5f 72 65 73 65 74 28 29 5d 2e 0a 0a  ite3_reset()]...
aa10: 20 20 49 6e 20 53 51 4c 69 74 65 20 76 65 72 73    In SQLite vers
aa20: 69 6f 6e 20 33 2e 36 2e 32 33 2e 31 20 61 6e 64  ion 3.6.23.1 and
aa30: 20 65 61 72 6c 69 65 72 2c 20 5b 73 71 6c 69 74   earlier, [sqlit
aa40: 65 33 5f 73 74 65 70 28 29 5d 20 75 73 65 64 20  e3_step()] used 
aa50: 74 6f 20 61 6c 77 61 79 73 0a 20 20 72 65 74 75  to always.  retu
aa60: 72 6e 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53  rn [SQLITE_MISUS
aa70: 45 5d 20 69 66 20 69 74 20 77 61 73 20 69 6e 76  E] if it was inv
aa80: 6f 6b 65 64 20 61 67 61 69 6e 20 61 66 74 65 72  oked again after
aa90: 20 72 65 74 75 72 6e 69 6e 67 20 61 6e 79 74 68   returning anyth
aaa0: 69 6e 67 0a 20 20 6f 74 68 65 72 20 74 68 61 6e  ing.  other than
aab0: 20 5b 53 51 4c 49 54 45 5f 52 4f 57 5d 20 77 69   [SQLITE_ROW] wi
aac0: 74 68 6f 75 74 20 61 6e 20 69 6e 74 65 72 76 65  thout an interve
aad0: 6e 69 6e 67 20 63 61 6c 6c 20 74 6f 20 5b 73 71  ning call to [sq
aae0: 6c 69 74 65 33 5f 72 65 73 65 74 28 29 5d 2e 0a  lite3_reset()]..
aaf0: 20 20 54 68 69 73 20 63 61 75 73 65 64 20 70 72    This caused pr
ab00: 6f 62 6c 65 6d 73 20 6f 6e 20 73 6f 6d 65 20 70  oblems on some p
ab10: 6f 6f 72 6c 79 20 77 72 69 74 74 65 6e 20 73 6d  oorly written sm
ab20: 61 72 74 70 68 6f 6e 65 20 61 70 70 6c 69 63 61  artphone applica
ab30: 74 69 6f 6e 73 20 77 68 69 63 68 0a 20 20 64 69  tions which.  di
ab40: 64 20 6e 6f 74 20 63 6f 72 72 65 63 74 6c 79 20  d not correctly 
ab50: 68 61 6e 64 6c 65 20 74 68 65 20 5b 53 51 4c 49  handle the [SQLI
ab60: 54 45 5f 4c 4f 43 4b 45 44 5d 20 61 6e 64 20 5b  TE_LOCKED] and [
ab70: 53 51 4c 49 54 45 5f 42 55 53 59 5d 20 65 72 72  SQLITE_BUSY] err
ab80: 6f 72 20 0a 20 20 72 65 74 75 72 6e 73 2e 20 20  or .  returns.  
ab90: 52 61 74 68 65 72 20 74 68 61 6e 20 66 69 78 20  Rather than fix 
aba0: 74 68 65 20 6d 61 6e 79 20 64 65 66 65 63 74 69  the many defecti
abb0: 76 65 20 73 6d 61 72 74 70 68 6f 6e 65 20 61 70  ve smartphone ap
abc0: 70 6c 69 63 61 74 69 6f 6e 73 2c 20 0a 20 20 74  plications, .  t
abd0: 68 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 53  he behavior of S
abe0: 51 4c 69 74 65 20 77 61 73 20 63 68 61 6e 67 65  QLite was change
abf0: 64 20 69 6e 20 33 2e 36 2e 32 33 2e 32 20 74 6f  d in 3.6.23.2 to
ac00: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72   automatically r
ac10: 65 73 65 74 0a 20 20 74 68 65 20 70 72 65 70 61  eset.  the prepa
ac20: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 2e 20 20  red statement.  
ac30: 42 75 74 20 74 68 61 74 20 63 68 61 6e 67 65 64  But that changed
ac40: 20 63 61 75 73 65 64 20 69 73 73 75 65 73 20 69   caused issues i
ac50: 6e 20 6f 74 68 65 72 20 0a 20 20 69 6d 70 72 6f  n other .  impro
ac60: 70 65 72 6c 79 20 69 6d 70 6c 65 6d 65 6e 74 65  perly implemente
ac70: 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74  d applications t
ac80: 68 61 74 20 77 65 72 65 20 61 63 74 75 61 6c 6c  hat were actuall
ac90: 79 20 6c 6f 6f 6b 69 6e 67 0a 20 20 66 6f 72 20  y looking.  for 
aca0: 61 6e 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53  an [SQLITE_MISUS
acb0: 45 5d 20 72 65 74 75 72 6e 20 74 6f 20 74 65 72  E] return to ter
acc0: 6d 69 6e 61 74 65 20 74 68 65 69 72 20 71 75 65  minate their que
acd0: 72 79 20 6c 6f 6f 70 73 2e 20 20 28 41 6e 79 74  ry loops.  (Anyt
ace0: 69 6d 65 0a 20 20 61 6e 20 61 70 70 6c 69 63 61  ime.  an applica
acf0: 74 69 6f 6e 20 67 65 74 73 20 61 6e 20 53 51 4c  tion gets an SQL
ad00: 49 54 45 5f 4d 49 53 55 53 45 20 65 72 72 6f 72  ITE_MISUSE error
ad10: 20 63 6f 64 65 20 66 72 6f 6d 20 53 51 4c 69 74   code from SQLit
ad20: 65 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68  e, that means th
ad30: 65 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  e.  application 
ad40: 69 73 20 6d 69 73 75 73 69 6e 67 20 74 68 65 20  is misusing the 
ad50: 53 51 4c 69 74 65 20 69 6e 74 65 72 66 61 63 65  SQLite interface
ad60: 20 61 6e 64 20 69 73 20 74 68 75 73 20 69 6e 63   and is thus inc
ad70: 6f 72 72 65 63 74 6c 79 0a 20 20 69 6d 70 6c 65  orrectly.  imple
ad80: 6d 65 6e 74 65 64 2e 29 20 20 54 68 65 20 53 51  mented.)  The SQ
ad90: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 52 45  LITE_OMIT_AUTORE
ada0: 53 45 54 20 69 6e 74 65 72 66 61 63 65 20 77 61  SET interface wa
adb0: 73 20 61 64 64 65 64 20 74 6f 20 53 51 4c 69 74  s added to SQLit
adc0: 65 0a 20 20 76 65 72 73 69 6f 6e 20 33 2e 37 2e  e.  version 3.7.
add0: 35 20 69 6e 20 61 6e 20 65 66 66 6f 72 74 20 74  5 in an effort t
ade0: 6f 20 67 65 74 20 61 6c 6c 20 6f 66 20 74 68 65  o get all of the
adf0: 20 28 62 72 6f 6b 65 6e 29 0a 20 20 61 70 70 6c   (broken).  appl
ae00: 69 63 61 74 69 6f 6e 73 20 74 6f 20 77 6f 72 6b  ications to work
ae10: 20 61 67 61 69 6e 20 77 69 74 68 6f 75 74 20 68   again without h
ae20: 61 76 69 6e 67 20 74 6f 20 61 63 74 75 61 6c 6c  aving to actuall
ae30: 79 20 66 69 78 20 74 68 65 20 61 70 70 6c 69 63  y fix the applic
ae40: 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  ations..}..COMPI
ae50: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
ae60: 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55  E_OMIT_AUTOVACUU
ae70: 4d 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f  M} {.  If this o
ae80: 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64  ption is defined
ae90: 2c 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61  , the library ca
aea0: 6e 6e 6f 74 20 63 72 65 61 74 65 20 6f 72 20 77  nnot create or w
aeb0: 72 69 74 65 20 74 6f 20 0a 20 20 64 61 74 61 62  rite to .  datab
aec0: 61 73 65 73 20 74 68 61 74 20 73 75 70 70 6f 72  ases that suppor
aed0: 74 20 5b 61 75 74 6f 5f 76 61 63 75 75 6d 5d 2e  t [auto_vacuum].
aee0: 0a 20 20 45 78 65 63 75 74 69 6e 67 20 61 20 5b  .  Executing a [
aef0: 50 52 41 47 4d 41 20 61 75 74 6f 5f 76 61 63 75  PRAGMA auto_vacu
af00: 75 6d 5d 20 73 74 61 74 65 6d 65 6e 74 20 69 73  um] statement is
af10: 20 6e 6f 74 20 61 6e 20 65 72 72 6f 72 0a 20 20   not an error.  
af20: 28 73 69 6e 63 65 20 75 6e 6b 6e 6f 77 6e 20 50  (since unknown P
af30: 52 41 47 4d 41 73 20 61 72 65 20 73 69 6c 65 6e  RAGMAs are silen
af40: 74 6c 79 20 69 67 6e 6f 72 65 64 29 2c 20 62 75  tly ignored), bu
af50: 74 20 64 6f 65 73 20 6e 6f 74 20 72 65 74 75 72  t does not retur
af60: 6e 20 61 20 76 61 6c 75 65 0a 20 20 6f 72 20 6d  n a value.  or m
af70: 6f 64 69 66 79 20 74 68 65 20 61 75 74 6f 2d 76  odify the auto-v
af80: 61 63 75 75 6d 20 66 6c 61 67 20 69 6e 20 74 68  acuum flag in th
af90: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
afa0: 20 49 66 20 61 20 64 61 74 61 62 61 73 65 20 74   If a database t
afb0: 68 61 74 0a 20 20 73 75 70 70 6f 72 74 73 20 61  hat.  supports a
afc0: 75 74 6f 2d 76 61 63 75 75 6d 20 69 73 20 6f 70  uto-vacuum is op
afd0: 65 6e 65 64 20 62 79 20 61 20 6c 69 62 72 61 72  ened by a librar
afe0: 79 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20  y compiled with 
aff0: 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 69 74 0a  this option, it.
b000: 20 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c    is automatical
b010: 6c 79 20 6f 70 65 6e 65 64 20 69 6e 20 72 65 61  ly opened in rea
b020: 64 2d 6f 6e 6c 79 20 6d 6f 64 65 2e 0a 7d 0a 0a  d-only mode..}..
b030: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
b040: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 45 54 57  SQLITE_OMIT_BETW
b050: 45 45 4e 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e  EEN_OPTIMIZATION
b060: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
b070: 6e 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 75  n disables the u
b080: 73 65 20 6f 66 20 69 6e 64 69 63 65 73 20 77 69  se of indices wi
b090: 74 68 20 57 48 45 52 45 20 63 6c 61 75 73 65 20  th WHERE clause 
b0a0: 74 65 72 6d 73 0a 20 20 74 68 61 74 20 65 6d 70  terms.  that emp
b0b0: 6c 6f 79 20 74 68 65 20 42 45 54 57 45 45 4e 20  loy the BETWEEN 
b0c0: 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d  operator..}..COM
b0d0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
b0e0: 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f 42 5f 4c 49  ITE_OMIT_BLOB_LI
b0f0: 54 45 52 41 4c 7d 20 7b 0a 20 20 57 68 65 6e 20  TERAL} {.  When 
b100: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
b110: 65 66 69 6e 65 64 2c 20 69 74 20 69 73 20 6e 6f  efined, it is no
b120: 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 73 70  t possible to sp
b130: 65 63 69 66 79 20 61 20 62 6c 6f 62 20 69 6e 0a  ecify a blob in.
b140: 20 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65    an SQL stateme
b150: 6e 74 20 75 73 69 6e 67 20 74 68 65 20 58 27 41  nt using the X'A
b160: 42 43 44 27 20 73 79 6e 74 61 78 2e 0a 7d 0a 0a  BCD' syntax..}..
b170: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
b180: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 54 52 45  SQLITE_OMIT_BTRE
b190: 45 43 4f 55 4e 54 7d 20 7b 0a 20 20 57 68 65 6e  ECOUNT} {.  When
b1a0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
b1b0: 64 65 66 69 6e 65 64 2c 20 61 6e 20 6f 70 74 69  defined, an opti
b1c0: 6d 69 7a 61 74 69 6f 6e 20 74 68 61 74 20 61 63  mization that ac
b1d0: 63 65 6c 65 72 61 74 65 73 20 63 6f 75 6e 74 69  celerates counti
b1e0: 6e 67 0a 20 20 61 6c 6c 20 65 6e 74 72 69 65 73  ng.  all entries
b1f0: 20 69 6e 20 61 20 74 61 62 6c 65 20 28 69 6e 20   in a table (in 
b200: 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 61 6e 20  other words, an 
b210: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 74 68 61  optimization tha
b220: 74 20 68 65 6c 70 73 0a 20 20 22 53 45 4c 45 43  t helps.  "SELEC
b230: 54 20 63 6f 75 6e 74 28 2a 29 20 46 52 4f 4d 20  T count(*) FROM 
b240: 74 61 62 6c 65 22 20 72 75 6e 20 66 61 73 74 65  table" run faste
b250: 72 29 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 7d  r) is omitted..}
b260: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
b270: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55   {SQLITE_OMIT_BU
b280: 49 4c 54 49 4e 5f 54 45 53 54 7d 20 7b 0a 20 20  ILTIN_TEST} {.  
b290: 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74  A standard SQLit
b2a0: 65 20 62 75 69 6c 64 20 69 6e 63 6c 75 64 65 73  e build includes
b2b0: 20 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20   a small amount 
b2c0: 6f 66 20 6c 6f 67 69 63 20 63 6f 6e 74 72 6f 6c  of logic control
b2d0: 6c 65 64 0a 20 20 62 79 20 74 68 65 20 5b 73 71  led.  by the [sq
b2e0: 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72  lite3_test_contr
b2f0: 6f 6c 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20  ol()] interface 
b300: 74 68 61 74 20 69 73 20 75 73 65 64 20 74 6f 20  that is used to 
b310: 65 78 65 72 63 69 73 65 0a 20 20 70 61 72 74 73  exercise.  parts
b320: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 63   of the SQLite c
b330: 6f 72 65 20 74 68 61 74 20 61 72 65 20 64 69 66  ore that are dif
b340: 66 69 63 75 6c 74 20 74 6f 20 63 6f 6e 74 72 6f  ficult to contro
b350: 6c 20 61 6e 64 20 6d 65 61 73 75 72 65 20 75 73  l and measure us
b360: 69 6e 67 0a 20 20 74 68 65 20 73 74 61 6e 64 61  ing.  the standa
b370: 72 64 20 41 50 49 2e 20 20 54 68 69 73 20 6f 70  rd API.  This op
b380: 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 61 74 20  tion omits that 
b390: 62 75 69 6c 74 2d 69 6e 20 74 65 73 74 20 6c 6f  built-in test lo
b3a0: 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  gic..}..COMPILE_
b3b0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
b3c0: 4d 49 54 5f 43 41 53 54 7d 20 7b 0a 20 20 54 68  MIT_CAST} {.  Th
b3d0: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73  is option causes
b3e0: 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20   SQLite to omit 
b3f0: 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20  support for the 
b400: 43 41 53 54 20 6f 70 65 72 61 74 6f 72 2e 0a 7d  CAST operator..}
b410: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
b420: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 48   {SQLITE_OMIT_CH
b430: 45 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ECK} {.  This op
b440: 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69  tion causes SQLi
b450: 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f  te to omit suppo
b460: 72 74 20 66 6f 72 20 43 48 45 43 4b 20 63 6f 6e  rt for CHECK con
b470: 73 74 72 61 69 6e 74 73 2e 0a 20 20 54 68 65 20  straints..  The 
b480: 70 61 72 73 65 72 20 77 69 6c 6c 20 73 74 69 6c  parser will stil
b490: 6c 20 61 63 63 65 70 74 20 43 48 45 43 4b 20 63  l accept CHECK c
b4a0: 6f 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 53 51  onstraints in SQ
b4b0: 4c 20 73 74 61 74 65 6d 65 6e 74 73 2c 0a 20 20  L statements,.  
b4c0: 74 68 65 79 20 77 69 6c 6c 20 6a 75 73 74 20 6e  they will just n
b4d0: 6f 74 20 62 65 20 65 6e 66 6f 72 63 65 64 2e 0a  ot be enforced..
b4e0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
b4f0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
b500: 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 49 41  OMPILEOPTION_DIA
b510: 47 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  GS} {.  This opt
b520: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
b530: 6d 69 74 20 74 68 65 20 63 6f 6d 70 69 6c 65 2d  mit the compile-
b540: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 64 69 61 67  time option diag
b550: 6e 6f 73 74 69 63 73 20 61 76 61 69 6c 61 62 6c  nostics availabl
b560: 65 0a 20 20 69 6e 20 53 51 4c 69 74 65 2c 20 69  e.  in SQLite, i
b570: 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 5b 73 71  ncluding the [sq
b580: 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 6f 70 74  lite3_compileopt
b590: 69 6f 6e 5f 75 73 65 64 28 29 5d 20 61 6e 64 0a  ion_used()] and.
b5a0: 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69    [sqlite3_compi
b5b0: 6c 65 6f 70 74 69 6f 6e 5f 67 65 74 28 29 5d 20  leoption_get()] 
b5c0: 43 2f 43 2b 2b 20 66 75 6e 63 74 69 6f 6e 73 2c  C/C++ functions,
b5d0: 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 5f 63   the.  [sqlite_c
b5e0: 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 75 73 65  ompileoption_use
b5f0: 64 28 29 5d 20 61 6e 64 20 5b 73 71 6c 69 74 65  d()] and [sqlite
b600: 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 67  _compileoption_g
b610: 65 74 28 29 5d 20 53 51 4c 20 66 75 6e 63 74 69  et()] SQL functi
b620: 6f 6e 73 2c 0a 20 20 61 6e 64 20 74 68 65 20 5b  ons,.  and the [
b630: 63 6f 6d 70 69 6c 65 5f 6f 70 74 69 6f 6e 73 20  compile_options 
b640: 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50  pragma]..}..COMP
b650: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
b660: 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50 4c 45 54 45  TE_OMIT_COMPLETE
b670: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
b680: 6e 20 63 61 75 73 65 73 20 74 68 65 20 5b 73 71  n causes the [sq
b690: 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 28 29  lite3_complete()
b6a0: 5d 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 63  ] and [sqlite3_c
b6b0: 6f 6d 70 6c 65 74 65 31 36 28 29 5d 0a 20 20 69  omplete16()].  i
b6c0: 6e 74 65 72 66 61 63 65 73 20 74 6f 20 62 65 20  nterfaces to be 
b6d0: 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50  omitted..}..COMP
b6e0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
b6f0: 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50 4f 55 4e 44  TE_OMIT_COMPOUND
b700: 5f 53 45 4c 45 43 54 7d 20 7b 0a 20 20 54 68 69  _SELECT} {.  Thi
b710: 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64  s option is used
b720: 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63 6f 6d   to omit the com
b730: 70 6f 75 6e 64 20 5b 53 45 4c 45 43 54 5d 20 66  pound [SELECT] f
b740: 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 20 0a 20  unctionality. . 
b750: 20 5b 53 45 4c 45 43 54 5d 20 73 74 61 74 65 6d   [SELECT] statem
b760: 65 6e 74 73 20 74 68 61 74 20 75 73 65 20 74 68  ents that use th
b770: 65 20 0a 20 20 55 4e 49 4f 4e 2c 20 55 4e 49 4f  e .  UNION, UNIO
b780: 4e 20 41 4c 4c 2c 20 49 4e 54 45 52 53 45 43 54  N ALL, INTERSECT
b790: 20 6f 72 20 45 58 43 45 50 54 20 63 6f 6d 70 6f   or EXCEPT compo
b7a0: 75 6e 64 20 53 45 4c 45 43 54 20 6f 70 65 72 61  und SELECT opera
b7b0: 74 6f 72 73 20 77 69 6c 6c 20 0a 20 20 63 61 75  tors will .  cau
b7c0: 73 65 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  se a parse error
b7d0: 2e 0a 0a 20 20 41 6e 20 5b 49 4e 53 45 52 54 5d  ...  An [INSERT]
b7e0: 20 73 74 61 74 65 6d 65 6e 74 20 77 69 74 68 20   statement with 
b7f0: 6d 75 6c 74 69 70 6c 65 20 76 61 6c 75 65 73 20  multiple values 
b800: 69 6e 20 74 68 65 20 56 41 4c 55 45 53 20 63 6c  in the VALUES cl
b810: 61 75 73 65 20 69 73 0a 20 20 69 6d 70 6c 65 6d  ause is.  implem
b820: 65 6e 74 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79  ented internally
b830: 20 61 73 20 61 20 63 6f 6d 70 6f 75 6e 64 20 53   as a compound S
b840: 45 4c 45 43 54 2e 20 20 48 65 6e 63 65 2c 20 74  ELECT.  Hence, t
b850: 68 69 73 20 6f 70 74 69 6f 6e 20 61 6c 73 6f 0a  his option also.
b860: 20 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 61    disables the a
b870: 62 69 6c 69 74 79 20 74 6f 20 69 6e 73 65 72 74  bility to insert
b880: 20 6d 6f 72 65 20 74 68 61 6e 20 61 20 73 69 6e   more than a sin
b890: 67 6c 65 20 72 6f 77 20 75 73 69 6e 67 20 61 6e  gle row using an
b8a0: 0a 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e  .  INSERT INTO .
b8b0: 2e 2e 20 56 41 4c 55 45 53 20 2e 2e 2e 20 73 74  .. VALUES ... st
b8c0: 61 74 65 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50  atement..}..COMP
b8d0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
b8e0: 54 45 5f 4f 4d 49 54 5f 43 54 45 7d 20 7b 0a 20  TE_OMIT_CTE} {. 
b8f0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
b900: 73 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  ses support for 
b910: 5b 63 6f 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78  [common table ex
b920: 70 72 65 73 73 69 6f 6e 73 5d 20 74 6f 20 62 65  pressions] to be
b930: 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 0a 0a 43   omitted..}....C
b940: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
b950: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41 54 45 54  QLITE_OMIT_DATET
b960: 49 4d 45 5f 46 55 4e 43 53 7d 20 7b 0a 20 20 49  IME_FUNCS} {.  I
b970: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  f this option is
b980: 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69 74 65   defined, SQLite
b990: 27 73 20 62 75 69 6c 74 2d 69 6e 20 64 61 74 65  's built-in date
b9a0: 20 61 6e 64 20 74 69 6d 65 20 6d 61 6e 69 70 75   and time manipu
b9b0: 6c 61 74 69 6f 6e 0a 20 20 66 75 6e 63 74 69 6f  lation.  functio
b9c0: 6e 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 20  ns are omitted. 
b9d0: 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68  Specifically, th
b9e0: 65 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20  e SQL functions 
b9f0: 6a 75 6c 69 61 6e 64 61 79 28 29 2c 20 64 61 74  julianday(), dat
ba00: 65 28 29 2c 0a 20 20 74 69 6d 65 28 29 2c 20 64  e(),.  time(), d
ba10: 61 74 65 74 69 6d 65 28 29 20 61 6e 64 20 73 74  atetime() and st
ba20: 72 66 74 69 6d 65 28 29 20 61 72 65 20 6e 6f 74  rftime() are not
ba30: 20 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65 20   available. The 
ba40: 64 65 66 61 75 6c 74 20 63 6f 6c 75 6d 6e 0a 20  default column. 
ba50: 20 76 61 6c 75 65 73 20 43 55 52 52 45 4e 54 5f   values CURRENT_
ba60: 54 49 4d 45 2c 20 43 55 52 52 45 4e 54 5f 44 41  TIME, CURRENT_DA
ba70: 54 45 20 61 6e 64 20 43 55 52 52 45 4e 54 5f 54  TE and CURRENT_T
ba80: 49 4d 45 53 54 41 4d 50 20 61 72 65 20 73 74 69  IMESTAMP are sti
ba90: 6c 6c 20 61 76 61 69 6c 61 62 6c 65 2e 0a 7d 0a  ll available..}.
baa0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
bab0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43  {SQLITE_OMIT_DEC
bac0: 4c 54 59 50 45 7d 20 7b 0a 20 20 54 68 69 73 20  LTYPE} {.  This 
bad0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51  option causes SQ
bae0: 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70  Lite to omit sup
baf0: 70 6f 72 74 20 66 6f 72 20 74 68 65 0a 20 20 5b  port for the.  [
bb00: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
bb10: 65 63 6c 74 79 70 65 28 29 5d 20 61 6e 64 20 5b  ecltype()] and [
bb20: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
bb30: 65 63 6c 74 79 70 65 31 36 28 29 5d 0a 20 20 69  ecltype16()].  i
bb40: 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f  nterfaces..}..CO
bb50: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
bb60: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43  LITE_OMIT_DEPREC
bb70: 41 54 45 44 7d 20 7b 0a 20 20 54 68 69 73 20 6f  ATED} {.  This o
bb80: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c  ption causes SQL
bb90: 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70  ite to omit supp
bba0: 6f 72 74 20 66 6f 72 20 69 6e 74 65 72 66 61 63  ort for interfac
bbb0: 65 73 0a 20 20 6d 61 72 6b 65 64 20 61 73 20 64  es.  marked as d
bbc0: 65 70 72 65 63 61 74 65 64 2e 20 20 54 68 69 73  eprecated.  This
bbd0: 20 69 6e 63 6c 75 64 65 73 20 0a 20 20 5b 73 71   includes .  [sq
bbe0: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f  lite3_aggregate_
bbf0: 63 6f 75 6e 74 28 29 5d 2c 0a 20 20 5b 73 71 6c  count()],.  [sql
bc00: 69 74 65 33 5f 65 78 70 69 72 65 64 28 29 5d 2c  ite3_expired()],
bc10: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 72 61 6e  .  [sqlite3_tran
bc20: 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28 29 5d  sfer_bindings()]
bc30: 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f 67 6c 6f  ,.  [sqlite3_glo
bc40: 62 61 6c 5f 72 65 63 6f 76 65 72 28 29 5d 2c 0a  bal_recover()],.
bc50: 20 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65 61    [sqlite3_threa
bc60: 64 5f 63 6c 65 61 6e 75 70 28 29 5d 20 61 6e 64  d_cleanup()] and
bc70: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6d 65 6d 6f  .  [sqlite3_memo
bc80: 72 79 5f 61 6c 61 72 6d 28 29 5d 20 69 6e 74 65  ry_alarm()] inte
bc90: 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  rfaces..}..COMPI
bca0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
bcb0: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 7d 20 7b  E_OMIT_DISKIO} {
bcc0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f  .  This option o
bcd0: 6d 69 74 73 20 61 6c 6c 20 73 75 70 70 6f 72 74  mits all support
bce0: 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 6f 20   for writing to 
bcf0: 74 68 65 20 64 69 73 6b 20 61 6e 64 20 66 6f 72  the disk and for
bd00: 63 65 73 0a 20 20 64 61 74 61 62 61 73 65 73 20  ces.  databases 
bd10: 74 6f 20 65 78 69 73 74 20 69 6e 20 6d 65 6d 6f  to exist in memo
bd20: 72 79 20 6f 6e 6c 79 2e 20 20 54 68 69 73 20 6f  ry only.  This o
bd30: 70 74 69 6f 6e 20 68 61 73 20 6e 6f 74 20 62 65  ption has not be
bd40: 65 6e 20 0a 20 20 6d 61 69 6e 74 61 69 6e 65 64  en .  maintained
bd50: 20 61 6e 64 20 70 72 6f 62 61 62 6c 79 20 64 6f   and probably do
bd60: 65 73 20 6e 6f 74 20 77 6f 72 6b 20 77 69 74 68  es not work with
bd70: 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20   newer versions 
bd80: 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f  of SQLite..}..CO
bd90: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
bda0: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49  LITE_OMIT_EXPLAI
bdb0: 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  N} {.  Defining 
bdc0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  this option caus
bdd0: 65 73 20 74 68 65 20 5b 45 58 50 4c 41 49 4e 5d  es the [EXPLAIN]
bde0: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62 65 20 6f   command to be o
bdf0: 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 0a  mitted from the.
be00: 20 20 6c 69 62 72 61 72 79 2e 20 41 74 74 65 6d    library. Attem
be10: 70 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65  pting to execute
be20: 20 61 6e 20 5b 45 58 50 4c 41 49 4e 5d 20 73 74   an [EXPLAIN] st
be30: 61 74 65 6d 65 6e 74 20 77 69 6c 6c 20 63 61 75  atement will cau
be40: 73 65 20 61 20 70 61 72 73 65 0a 20 20 65 72 72  se a parse.  err
be50: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
be60: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
be70: 49 54 5f 46 4c 41 47 5f 50 52 41 47 4d 41 53 7d  IT_FLAG_PRAGMAS}
be80: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
be90: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
bea0: 6f 72 20 61 20 73 75 62 73 65 74 20 6f 66 20 5b  or a subset of [
beb0: 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 73  PRAGMA] commands
bec0: 20 74 68 61 74 0a 20 20 71 75 65 72 79 20 61 6e   that.  query an
bed0: 64 20 73 65 74 20 62 6f 6f 6c 65 61 6e 20 70 72  d set boolean pr
bee0: 6f 70 65 72 74 69 65 73 2e 0a 7d 0a 0a 43 4f 4d  operties..}..COM
bef0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
bf00: 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e  ITE_OMIT_FLOATIN
bf10: 47 5f 50 4f 49 4e 54 7d 20 7b 0a 20 20 54 68 69  G_POINT} {.  Thi
bf20: 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64  s option is used
bf30: 20 74 6f 20 6f 6d 69 74 20 66 6c 6f 61 74 69 6e   to omit floatin
bf40: 67 2d 70 6f 69 6e 74 20 6e 75 6d 62 65 72 20 73  g-point number s
bf50: 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20  upport from the 
bf60: 53 51 4c 69 74 65 0a 20 20 6c 69 62 72 61 72 79  SQLite.  library
bf70: 2e 20 57 68 65 6e 20 73 70 65 63 69 66 69 65 64  . When specified
bf80: 2c 20 73 70 65 63 69 66 79 69 6e 67 20 61 20 66  , specifying a f
bf90: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75  loating point nu
bfa0: 6d 62 65 72 20 61 73 20 61 20 6c 69 74 65 72 61  mber as a litera
bfb0: 6c 20 0a 20 20 28 69 2e 65 2e 20 22 31 2e 30 31  l .  (i.e. "1.01
bfc0: 22 29 20 72 65 73 75 6c 74 73 20 69 6e 20 61 20  ") results in a 
bfd0: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20  parse error...  
bfe0: 3c 70 3e 49 6e 20 74 68 65 20 66 75 74 75 72 65  <p>In the future
bff0: 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61  , this option ma
c000: 79 20 61 6c 73 6f 20 64 69 73 61 62 6c 65 20 6f  y also disable o
c010: 74 68 65 72 20 66 6c 6f 61 74 69 6e 67 20 70 6f  ther floating po
c020: 69 6e 74 20 0a 20 20 66 75 6e 63 74 69 6f 6e 61  int .  functiona
c030: 6c 69 74 79 2c 20 66 6f 72 20 65 78 61 6d 70 6c  lity, for exampl
c040: 65 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72  e the [sqlite3_r
c050: 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28 29 5d 2c  esult_double()],
c060: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 69 6e   .  [sqlite3_bin
c070: 64 5f 64 6f 75 62 6c 65 28 29 5d 2c 20 5b 73 71  d_double()], [sq
c080: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62  lite3_value_doub
c090: 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c  le()] and.  [sql
c0a0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62  ite3_column_doub
c0b0: 6c 65 28 29 5d 20 41 50 49 20 66 75 6e 63 74 69  le()] API functi
c0c0: 6f 6e 73 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a 43  ons..  </p>.}..C
c0d0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
c0e0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49  QLITE_OMIT_FOREI
c0f0: 47 4e 5f 4b 45 59 7d 20 7b 0a 20 20 49 66 20 74  GN_KEY} {.  If t
c100: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65  his option is de
c110: 66 69 6e 65 64 2c 20 74 68 65 6e 20 5b 66 6f 72  fined, then [for
c120: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
c130: 69 6e 74 5d 20 73 79 6e 74 61 78 20 69 73 0a 20  int] syntax is. 
c140: 20 6e 6f 74 20 72 65 63 6f 67 6e 69 7a 65 64 2e   not recognized.
c150: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
c160: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
c170: 47 45 54 5f 54 41 42 4c 45 7d 20 7b 0a 20 20 54  GET_TABLE} {.  T
c180: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
c190: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 5b 73  s support for [s
c1a0: 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65  qlite3_get_table
c1b0: 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74  ()] and.  [sqlit
c1c0: 65 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 29 5d  e3_free_table()]
c1d0: 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a   to be omitted..
c1e0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c1f0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49  N {SQLITE_OMIT_I
c200: 4e 43 52 42 4c 4f 42 7d 20 7b 0a 20 20 54 68 69  NCRBLOB} {.  Thi
c210: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
c220: 73 75 70 70 6f 72 74 20 66 6f 72 20 5b 73 71 6c  support for [sql
c230: 69 74 65 33 5f 62 6c 6f 62 20 7c 20 69 6e 63 72  ite3_blob | incr
c240: 65 6d 65 6e 74 61 6c 20 42 4c 4f 42 20 49 2f 4f  emental BLOB I/O
c250: 5d 0a 20 20 74 6f 20 62 65 20 6f 6d 69 74 74 65  ].  to be omitte
c260: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
c270: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
c280: 54 5f 49 4e 54 45 47 52 49 54 59 5f 43 48 45 43  T_INTEGRITY_CHEC
c290: 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  K} {.  This opti
c2a0: 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74  on omits support
c2b0: 20 66 6f 72 20 74 68 65 20 5b 69 6e 74 65 67 72   for the [integr
c2c0: 69 74 79 5f 63 68 65 63 6b 20 70 72 61 67 6d 61  ity_check pragma
c2d0: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
c2e0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
c2f0: 54 5f 4c 49 4b 45 5f 4f 50 54 49 4d 49 5a 41 54  T_LIKE_OPTIMIZAT
c300: 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ION} {.  This op
c310: 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 68  tion disables th
c320: 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53 51 4c  e ability of SQL
c330: 69 74 65 20 74 6f 20 75 73 65 20 69 6e 64 69 63  ite to use indic
c340: 65 73 20 74 6f 20 68 65 6c 70 0a 20 20 72 65 73  es to help.  res
c350: 6f 6c 76 65 20 5b 4c 49 4b 45 5d 20 61 6e 64 20  olve [LIKE] and 
c360: 5b 47 4c 4f 42 5d 20 6f 70 65 72 61 74 6f 72 73  [GLOB] operators
c370: 20 69 6e 20 61 20 57 48 45 52 45 20 63 6c 61 75   in a WHERE clau
c380: 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  se..}..COMPILE_O
c390: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
c3a0: 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f  IT_LOAD_EXTENSIO
c3b0: 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  N} {.  This opti
c3c0: 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 65 6e 74  on omits the ent
c3d0: 69 72 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f  ire extension lo
c3e0: 61 64 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d 20  ading mechanism 
c3f0: 66 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2c 20 69  from.  SQLite, i
c400: 6e 63 6c 75 64 69 6e 67 20 5b 73 71 6c 69 74 65  ncluding [sqlite
c410: 33 5f 65 6e 61 62 6c 65 5f 6c 6f 61 64 5f 65 78  3_enable_load_ex
c420: 74 65 6e 73 69 6f 6e 28 29 5d 20 61 6e 64 0a 20  tension()] and. 
c430: 20 5b 73 71 6c 69 74 65 33 5f 6c 6f 61 64 5f 65   [sqlite3_load_e
c440: 78 74 65 6e 73 69 6f 6e 28 29 5d 20 69 6e 74 65  xtension()] inte
c450: 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  rfaces..}..COMPI
c460: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
c470: 45 5f 4f 4d 49 54 5f 4c 4f 43 41 4c 54 49 4d 45  E_OMIT_LOCALTIME
c480: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
c490: 6e 20 6f 6d 69 74 73 20 74 68 65 20 22 6c 6f 63  n omits the "loc
c4a0: 61 6c 74 69 6d 65 22 20 6d 6f 64 69 66 69 65 72  altime" modifier
c4b0: 20 66 72 6f 6d 20 74 68 65 20 64 61 74 65 20 61   from the date a
c4c0: 6e 64 20 74 69 6d 65 0a 20 20 66 75 6e 63 74 69  nd time.  functi
c4d0: 6f 6e 73 2e 20 20 54 68 69 73 20 6f 70 74 69 6f  ons.  This optio
c4e0: 6e 20 69 73 20 73 6f 6d 65 74 69 6d 65 73 20 75  n is sometimes u
c4f0: 73 65 66 75 6c 20 77 68 65 6e 20 74 72 79 69 6e  seful when tryin
c500: 67 20 74 6f 20 63 6f 6d 70 69 6c 65 0a 20 20 74  g to compile.  t
c510: 68 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65  he date and time
c520: 20 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 20 61 20   functions on a 
c530: 70 6c 61 74 66 6f 72 6d 20 74 68 61 74 20 64 6f  platform that do
c540: 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 74  es not support t
c550: 68 65 0a 20 20 63 6f 6e 63 65 70 74 20 6f 66 20  he.  concept of 
c560: 6c 6f 63 61 6c 20 74 69 6d 65 2e 0a 7d 0a 0a 43  local time..}..C
c570: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
c580: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41  QLITE_OMIT_LOOKA
c590: 53 49 44 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f  SIDE} {.  This o
c5a0: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20  ption omits the 
c5b0: 5b 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72  [lookaside memor
c5c0: 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 2e 0a 7d 0a  y allocator]..}.
c5d0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
c5e0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d  {SQLITE_OMIT_MEM
c5f0: 4f 52 59 44 42 7d 20 7b 0a 20 20 57 68 65 6e 20  ORYDB} {.  When 
c600: 74 68 69 73 20 69 73 20 64 65 66 69 6e 65 64 2c  this is defined,
c610: 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 6f 65   the library doe
c620: 73 20 6e 6f 74 20 72 65 73 70 65 63 74 20 74 68  s not respect th
c630: 65 20 73 70 65 63 69 61 6c 20 64 61 74 61 62 61  e special databa
c640: 73 65 0a 20 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f  se.  name ":memo
c650: 72 79 3a 22 20 28 6e 6f 72 6d 61 6c 6c 79 20 75  ry:" (normally u
c660: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6e  sed to create an
c670: 20 5b 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61   [in-memory data
c680: 62 61 73 65 5d 29 2e 20 49 66 20 0a 20 20 22 3a  base]). If .  ":
c690: 6d 65 6d 6f 72 79 3a 22 20 69 73 20 70 61 73 73  memory:" is pass
c6a0: 65 64 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f  ed to [sqlite3_o
c6b0: 70 65 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33  pen()], [sqlite3
c6c0: 5f 6f 70 65 6e 31 36 28 29 5d 2c 20 6f 72 0a 20  _open16()], or. 
c6d0: 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76   [sqlite3_open_v
c6e0: 32 28 29 5d 2c 20 61 20 66 69 6c 65 20 77 69 74  2()], a file wit
c6f0: 68 20 74 68 69 73 20 6e 61 6d 65 20 77 69 6c 6c  h this name will
c700: 20 62 65 20 0a 20 20 6f 70 65 6e 65 64 20 6f 72   be .  opened or
c710: 20 63 72 65 61 74 65 64 2e 0a 7d 0a 0a 43 4f 4d   created..}..COM
c720: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
c730: 49 54 45 5f 4f 4d 49 54 5f 4f 52 5f 4f 50 54 49  ITE_OMIT_OR_OPTI
c740: 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68  MIZATION} {.  Th
c750: 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c  is option disabl
c760: 65 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f  es the ability o
c770: 66 20 53 51 4c 69 74 65 20 74 6f 20 75 73 65 20  f SQLite to use 
c780: 61 6e 20 69 6e 64 65 78 20 74 6f 67 65 74 68 65  an index togethe
c790: 72 0a 20 20 77 69 74 68 20 74 65 72 6d 73 20 6f  r.  with terms o
c7a0: 66 20 61 20 57 48 45 52 45 20 63 6c 61 75 73 65  f a WHERE clause
c7b0: 20 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68   connected by th
c7c0: 65 20 4f 52 20 6f 70 65 72 61 74 6f 72 2e 0a 7d  e OR operator..}
c7d0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
c7e0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41   {SQLITE_OMIT_PA
c7f0: 47 45 52 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20  GER_PRAGMAS} {. 
c800: 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f   Defining this o
c810: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67  ption omits prag
c820: 6d 61 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74  mas related to t
c830: 68 65 20 70 61 67 65 72 20 73 75 62 73 79 73 74  he pager subsyst
c840: 65 6d 20 66 72 6f 6d 20 0a 20 20 74 68 65 20 62  em from .  the b
c850: 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  uild..}..COMPILE
c860: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
c870: 4f 4d 49 54 5f 50 52 41 47 4d 41 7d 20 7b 0a 20  OMIT_PRAGMA} {. 
c880: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   This option is 
c890: 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65  used to omit the
c8a0: 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e   [PRAGMA] comman
c8b0: 64 0a 20 20 66 72 6f 6d 20 74 68 65 20 6c 69 62  d.  from the lib
c8c0: 72 61 72 79 2e 20 4e 6f 74 65 20 74 68 61 74 20  rary. Note that 
c8d0: 69 74 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20  it is useful to 
c8e0: 64 65 66 69 6e 65 20 74 68 65 20 6d 61 63 72 6f  define the macro
c8f0: 73 20 74 68 61 74 20 6f 6d 69 74 0a 20 20 73 70  s that omit.  sp
c900: 65 63 69 66 69 63 20 70 72 61 67 6d 61 73 20 69  ecific pragmas i
c910: 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68  n addition to th
c920: 69 73 2c 20 61 73 20 74 68 65 79 20 6d 61 79 20  is, as they may 
c930: 61 6c 73 6f 20 72 65 6d 6f 76 65 20 73 75 70 70  also remove supp
c940: 6f 72 74 69 6e 67 20 63 6f 64 65 0a 20 20 69 6e  orting code.  in
c950: 20 6f 74 68 65 72 20 73 75 62 2d 73 79 73 74 65   other sub-syste
c960: 6d 73 2e 20 54 68 69 73 20 6d 61 63 72 6f 20 72  ms. This macro r
c970: 65 6d 6f 76 65 73 20 74 68 65 20 5b 50 52 41 47  emoves the [PRAG
c980: 4d 41 5d 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79  MA] command only
c990: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
c9a0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
c9b0: 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41  _PROGRESS_CALLBA
c9c0: 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  CK} {.  This opt
c9d0: 69 6f 6e 20 6d 61 79 20 62 65 20 64 65 66 69 6e  ion may be defin
c9e0: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63  ed to omit the c
c9f0: 61 70 61 62 69 6c 69 74 79 20 74 6f 20 69 73 73  apability to iss
ca00: 75 65 20 22 70 72 6f 67 72 65 73 73 22 20 0a 20  ue "progress" . 
ca10: 20 63 61 6c 6c 62 61 63 6b 73 20 64 75 72 69 6e   callbacks durin
ca20: 67 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 53  g long-running S
ca30: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 54  QL statements. T
ca40: 68 65 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 70  he .  [sqlite3_p
ca50: 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 65 72 28  rogress_handler(
ca60: 29 5d 0a 20 20 41 50 49 20 66 75 6e 63 74 69 6f  )].  API functio
ca70: 6e 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74  n is not present
ca80: 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e   in the library.
ca90: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
caa0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
cab0: 51 55 49 43 4b 42 41 4c 41 4e 43 45 7d 20 7b 0a  QUICKBALANCE} {.
cac0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
cad0: 69 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69  its an alternati
cae0: 76 65 2c 20 66 61 73 74 65 72 20 42 2d 54 72 65  ve, faster B-Tre
caf0: 65 20 62 61 6c 61 6e 63 69 6e 67 20 72 6f 75 74  e balancing rout
cb00: 69 6e 65 2e 0a 20 20 55 73 69 6e 67 20 74 68 69  ine..  Using thi
cb10: 73 20 6f 70 74 69 6f 6e 20 6d 61 6b 65 73 20 53  s option makes S
cb20: 51 4c 69 74 65 20 73 6c 69 67 68 74 6c 79 20 73  QLite slightly s
cb30: 6d 61 6c 6c 65 72 20 61 74 20 74 68 65 20 65 78  maller at the ex
cb40: 70 65 6e 73 65 20 6f 66 0a 20 20 6d 61 6b 69 6e  pense of.  makin
cb50: 67 20 69 74 20 72 75 6e 20 73 6c 69 67 68 74 6c  g it run slightl
cb60: 79 20 73 6c 6f 77 65 72 2e 0a 7d 0a 0a 43 4f 4d  y slower..}..COM
cb70: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
cb80: 49 54 45 5f 4f 4d 49 54 5f 52 45 49 4e 44 45 58  ITE_OMIT_REINDEX
cb90: 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20  } {.  When this 
cba0: 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65  option is define
cbb0: 64 2c 20 74 68 65 20 5b 52 45 49 4e 44 45 58 5d  d, the [REINDEX]
cbc0: 0a 20 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f  .  command is no
cbd0: 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68  t included in th
cbe0: 65 20 6c 69 62 72 61 72 79 2e 0a 20 20 45 78 65  e library..  Exe
cbf0: 63 75 74 69 6e 67 20 61 20 5b 52 45 49 4e 44 45  cuting a [REINDE
cc00: 58 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75  X] statement cau
cc10: 73 65 73 20 0a 20 20 61 20 70 61 72 73 65 20 65  ses .  a parse e
cc20: 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  rror..}..COMPILE
cc30: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
cc40: 4f 4d 49 54 5f 53 43 48 45 4d 41 5f 50 52 41 47  OMIT_SCHEMA_PRAG
cc50: 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e  MAS} {.  Definin
cc60: 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d  g this option om
cc70: 69 74 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20  its pragmas for 
cc80: 71 75 65 72 79 69 6e 67 20 74 68 65 20 64 61 74  querying the dat
cc90: 61 62 61 73 65 20 73 63 68 65 6d 61 20 66 72 6f  abase schema fro
cca0: 6d 20 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a  m .  the build..
ccb0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
ccc0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53  N {SQLITE_OMIT_S
ccd0: 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 5f 50 52  CHEMA_VERSION_PR
cce0: 41 47 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e  AGMAS} {.  Defin
ccf0: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
cd00: 6f 6d 69 74 73 20 70 72 61 67 6d 61 73 20 66 6f  omits pragmas fo
cd10: 72 20 71 75 65 72 79 69 6e 67 20 61 6e 64 20 6d  r querying and m
cd20: 6f 64 69 66 79 69 6e 67 20 74 68 65 20 0a 20 20  odifying the .  
cd30: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
cd40: 76 65 72 73 69 6f 6e 20 61 6e 64 20 75 73 65 72  version and user
cd50: 20 76 65 72 73 69 6f 6e 20 66 72 6f 6d 20 74 68   version from th
cd60: 65 20 62 75 69 6c 64 2e 20 53 70 65 63 69 66 69  e build. Specifi
cd70: 63 61 6c 6c 79 2c 20 74 68 65 20 0a 20 20 5b 73  cally, the .  [s
cd80: 63 68 65 6d 61 5f 76 65 72 73 69 6f 6e 5d 20 61  chema_version] a
cd90: 6e 64 20 5b 75 73 65 72 5f 76 65 72 73 69 6f 6e  nd [user_version
cda0: 5d 20 50 52 41 47 4d 41 73 20 61 72 65 20 6f 6d  ] PRAGMAs are om
cdb0: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
cdc0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
cdd0: 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43  _OMIT_SHARED_CAC
cde0: 48 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  HE} {.  This opt
cdf0: 69 6f 6e 20 62 75 69 6c 64 73 20 53 51 4c 69 74  ion builds SQLit
ce00: 65 20 77 69 74 68 6f 75 74 20 73 75 70 70 6f 72  e without suppor
ce10: 74 20 66 6f 72 20 73 68 61 72 65 64 2d 63 61 63  t for shared-cac
ce20: 68 65 20 6d 6f 64 65 2e 0a 20 20 54 68 65 20 5b  he mode..  The [
ce30: 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 73  sqlite3_enable_s
ce40: 68 61 72 65 64 5f 63 61 63 68 65 28 29 5d 20 69  hared_cache()] i
ce50: 73 20 6f 6d 69 74 74 65 64 20 61 6c 6f 6e 67 20  s omitted along 
ce60: 77 69 74 68 20 61 20 66 61 69 72 0a 20 20 61 6d  with a fair.  am
ce70: 6f 75 6e 74 20 6f 66 20 6c 6f 67 69 63 20 77 69  ount of logic wi
ce80: 74 68 69 6e 20 74 68 65 20 42 2d 54 72 65 65 20  thin the B-Tree 
ce90: 73 75 62 73 79 73 74 65 6d 20 61 73 73 6f 63 69  subsystem associ
cea0: 61 74 65 64 20 77 69 74 68 20 73 68 61 72 65 64  ated with shared
ceb0: 0a 20 20 63 61 63 68 65 20 6d 61 6e 61 67 65 6d  .  cache managem
cec0: 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ent..}..COMPILE_
ced0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
cee0: 4d 49 54 5f 53 55 42 51 55 45 52 59 7d 20 7b 0a  MIT_SUBQUERY} {.
cef0: 20 20 49 66 20 64 65 66 69 6e 65 64 2c 20 73 75    If defined, su
cf00: 70 70 6f 72 74 20 66 6f 72 20 73 75 62 2d 73 65  pport for sub-se
cf10: 6c 65 63 74 73 20 61 6e 64 20 74 68 65 20 49 4e  lects and the IN
cf20: 28 29 20 6f 70 65 72 61 74 6f 72 20 61 72 65 20  () operator are 
cf30: 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50  omitted..}..COMP
cf40: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
cf50: 54 45 5f 4f 4d 49 54 5f 54 43 4c 5f 56 41 52 49  TE_OMIT_TCL_VARI
cf60: 41 42 4c 45 7d 20 7b 0a 20 20 49 66 20 74 68 69  ABLE} {.  If thi
cf70: 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  s macro is defin
cf80: 65 64 2c 20 74 68 65 6e 20 74 68 65 20 73 70 65  ed, then the spe
cf90: 63 69 61 6c 20 22 24 3c 76 61 72 69 61 62 6c 65  cial "$<variable
cfa0: 2d 6e 61 6d 65 3e 22 20 73 79 6e 74 61 78 0a 20  -name>" syntax. 
cfb0: 20 75 73 65 64 20 74 6f 20 61 75 74 6f 6d 61 74   used to automat
cfc0: 69 63 61 6c 6c 79 20 62 69 6e 64 20 53 51 4c 20  ically bind SQL 
cfd0: 76 61 72 69 61 62 6c 65 73 20 74 6f 20 54 43 4c  variables to TCL
cfe0: 20 76 61 72 69 61 62 6c 65 73 20 69 73 20 6f 6d   variables is om
cff0: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
d000: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
d010: 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 7d 20 7b 0a  _OMIT_TEMPDB} {.
d020: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
d030: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  its support for 
d040: 54 45 4d 50 20 6f 72 20 54 45 4d 50 4f 52 41 52  TEMP or TEMPORAR
d050: 59 20 74 61 62 6c 65 73 2e 0a 7d 0a 0a 43 4f 4d  Y tables..}..COM
d060: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
d070: 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 7d 20  ITE_OMIT_TRACE} 
d080: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
d090: 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f  omits support fo
d0a0: 72 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 70  r the [sqlite3_p
d0b0: 72 6f 66 69 6c 65 28 29 5d 20 61 6e 64 0a 20 20  rofile()] and.  
d0c0: 5b 73 71 6c 69 74 65 33 5f 74 72 61 63 65 28 29  [sqlite3_trace()
d0d0: 5d 20 69 6e 74 65 72 66 61 63 65 73 20 61 6e 64  ] interfaces and
d0e0: 20 74 68 65 69 72 20 61 73 73 6f 63 69 61 74 65   their associate
d0f0: 64 20 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50  d logic..}..COMP
d100: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
d110: 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 7d  TE_OMIT_TRIGGER}
d120: 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68   {.  Defining th
d130: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
d140: 73 75 70 70 6f 72 74 20 66 6f 72 20 54 52 49 47  support for TRIG
d150: 47 45 52 20 6f 62 6a 65 63 74 73 2e 20 4e 65 69  GER objects. Nei
d160: 74 68 65 72 20 74 68 65 20 0a 20 20 5b 43 52 45  ther the .  [CRE
d170: 41 54 45 20 54 52 49 47 47 45 52 5d 20 6f 72 20  ATE TRIGGER] or 
d180: 5b 44 52 4f 50 20 54 52 49 47 47 45 52 5d 0a 20  [DROP TRIGGER]. 
d190: 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 76   commands are av
d1a0: 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 69 73 20  ailable in this 
d1b0: 63 61 73 65 2c 20 61 6e 64 20 61 74 74 65 6d 70  case, and attemp
d1c0: 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 0a  ting to execute.
d1d0: 20 20 65 69 74 68 65 72 20 77 69 6c 6c 20 72 65    either will re
d1e0: 73 75 6c 74 20 69 6e 20 61 20 70 61 72 73 65 20  sult in a parse 
d1f0: 65 72 72 6f 72 2e 0a 20 20 54 68 69 73 20 6f 70  error..  This op
d200: 74 69 6f 6e 20 61 6c 73 6f 20 64 69 73 61 62 6c  tion also disabl
d210: 65 73 20 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f  es enforcement o
d220: 66 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  f [foreign key c
d230: 6f 6e 73 74 72 61 69 6e 74 73 5d 2c 0a 20 20 73  onstraints],.  s
d240: 69 6e 63 65 20 74 68 65 20 63 6f 64 65 20 74 68  ince the code th
d250: 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 72  at implements tr
d260: 69 67 67 65 72 73 20 61 6e 64 20 77 68 69 63 68  iggers and which
d270: 20 69 73 20 6f 6d 69 74 74 65 64 20 62 79 20 74   is omitted by t
d280: 68 69 73 0a 20 20 6f 70 74 69 6f 6e 20 69 73 20  his.  option is 
d290: 61 6c 73 6f 20 75 73 65 64 20 74 6f 20 69 6d 70  also used to imp
d2a0: 6c 65 6d 65 6e 74 20 5b 66 6f 72 65 69 67 6e 20  lement [foreign 
d2b0: 6b 65 79 20 61 63 74 69 6f 6e 73 5d 2e 0a 7d 0a  key actions]..}.
d2c0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
d2d0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 55  {SQLITE_OMIT_TRU
d2e0: 4e 43 41 54 45 5f 4f 50 54 49 4d 49 5a 41 54 49  NCATE_OPTIMIZATI
d2f0: 4f 4e 7d 20 7b 0a 20 20 41 20 64 65 66 61 75 6c  ON} {.  A defaul
d300: 74 20 62 75 69 6c 64 20 6f 66 20 53 51 4c 69 74  t build of SQLit
d310: 65 2c 20 69 66 20 61 20 5b 44 45 4c 45 54 45 5d  e, if a [DELETE]
d320: 20 73 74 61 74 65 6d 65 6e 74 20 68 61 73 20 6e   statement has n
d330: 6f 20 57 48 45 52 45 20 63 6c 61 75 73 65 0a 20  o WHERE clause. 
d340: 20 61 6e 64 20 6f 70 65 72 61 74 65 73 20 6f 6e   and operates on
d350: 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 6e 6f   a table with no
d360: 20 74 72 69 67 67 65 72 73 2c 20 61 6e 20 6f 70   triggers, an op
d370: 74 69 6d 69 7a 61 74 69 6f 6e 20 6f 63 63 75 72  timization occur
d380: 73 20 74 68 61 74 0a 20 20 63 61 75 73 65 73 20  s that.  causes 
d390: 74 68 65 20 44 45 4c 45 54 45 20 74 6f 20 6f 63  the DELETE to oc
d3a0: 63 75 72 20 62 79 20 64 72 6f 70 70 69 6e 67 20  cur by dropping 
d3b0: 61 6e 64 20 72 65 63 72 65 61 74 69 6e 67 20 74  and recreating t
d3c0: 68 65 20 74 61 62 6c 65 2e 20 20 0a 20 20 44 72  he table.  .  Dr
d3d0: 6f 70 70 69 6e 67 20 61 6e 64 20 72 65 63 72 65  opping and recre
d3e0: 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 69 73  ating a table is
d3f0: 20 75 73 75 61 6c 6c 79 20 6d 75 63 68 20 66 61   usually much fa
d400: 73 74 65 72 20 74 68 61 6e 20 64 65 6c 65 74 69  ster than deleti
d410: 6e 67 0a 20 20 74 68 65 20 74 61 62 6c 65 20 63  ng.  the table c
d420: 6f 6e 74 65 6e 74 20 72 6f 77 20 62 79 20 72 6f  ontent row by ro
d430: 77 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 20  w.  This is the 
d440: 22 74 72 75 6e 63 61 74 65 20 6f 70 74 69 6d 69  "truncate optimi
d450: 7a 61 74 69 6f 6e 22 2e 0a 7d 0a 0a 43 4f 4d 50  zation"..}..COMP
d460: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
d470: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 7d 20 7b  TE_OMIT_UTF16} {
d480: 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 69 73  .  This macro is
d490: 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 73 75   used to omit su
d4a0: 70 70 6f 72 74 20 66 6f 72 20 55 54 46 31 36 20  pport for UTF16 
d4b0: 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 57  text encoding. W
d4c0: 68 65 6e 20 74 68 69 73 20 69 73 0a 20 20 64 65  hen this is.  de
d4d0: 66 69 6e 65 64 20 61 6c 6c 20 41 50 49 20 66 75  fined all API fu
d4e0: 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 72 65 74  nctions that ret
d4f0: 75 72 6e 20 6f 72 20 61 63 63 65 70 74 20 55 54  urn or accept UT
d500: 46 31 36 20 65 6e 63 6f 64 65 64 20 74 65 78 74  F16 encoded text
d510: 20 61 72 65 0a 20 20 75 6e 61 76 61 69 6c 61 62   are.  unavailab
d520: 6c 65 2e 20 54 68 65 73 65 20 66 75 6e 63 74 69  le. These functi
d530: 6f 6e 73 20 63 61 6e 20 62 65 20 69 64 65 6e 74  ons can be ident
d540: 69 66 69 65 64 20 62 79 20 74 68 65 20 66 61 63  ified by the fac
d550: 74 20 74 68 61 74 20 74 68 65 79 20 65 6e 64 0a  t that they end.
d560: 20 20 77 69 74 68 20 27 31 36 27 2c 20 66 6f 72    with '16', for
d570: 20 65 78 61 6d 70 6c 65 20 5b 73 71 6c 69 74 65   example [sqlite
d580: 33 5f 70 72 65 70 61 72 65 31 36 28 29 5d 2c 20  3_prepare16()], 
d590: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
d5a0: 74 65 78 74 31 36 28 29 5d 20 61 6e 64 0a 20 20  text16()] and.  
d5b0: 5b 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65  [sqlite3_bind_te
d5c0: 78 74 31 36 28 29 5d 2e 0a 7d 0a 0a 43 4f 4d 50  xt16()]..}..COMP
d5d0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
d5e0: 54 45 5f 4f 4d 49 54 5f 56 41 43 55 55 4d 7d 20  TE_OMIT_VACUUM} 
d5f0: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
d600: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
d610: 20 74 68 65 20 5b 56 41 43 55 55 4d 5d 0a 20 20   the [VACUUM].  
d620: 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 69  command is not i
d630: 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6c  ncluded in the l
d640: 69 62 72 61 72 79 2e 0a 20 20 45 78 65 63 75 74  ibrary..  Execut
d650: 69 6e 67 20 61 20 5b 56 41 43 55 55 4d 5d 20 73  ing a [VACUUM] s
d660: 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65 73 20  tatement causes 
d670: 0a 20 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  .  a parse error
d680: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
d690: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
d6a0: 5f 56 49 45 57 7d 20 7b 0a 20 20 44 65 66 69 6e  _VIEW} {.  Defin
d6b0: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
d6c0: 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f  omits support fo
d6d0: 72 20 56 49 45 57 20 6f 62 6a 65 63 74 73 2e 20  r VIEW objects. 
d6e0: 4e 65 69 74 68 65 72 20 74 68 65 20 0a 20 20 5b  Neither the .  [
d6f0: 43 52 45 41 54 45 20 56 49 45 57 5d 20 6e 6f 72  CREATE VIEW] nor
d700: 20 74 68 65 20 5b 44 52 4f 50 20 56 49 45 57 5d   the [DROP VIEW]
d710: 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20  .  commands are 
d720: 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 69  available in thi
d730: 73 20 63 61 73 65 2c 20 61 6e 64 0a 20 20 61 74  s case, and.  at
d740: 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78 65 63  tempting to exec
d750: 75 74 65 20 65 69 74 68 65 72 20 77 69 6c 6c 20  ute either will 
d760: 72 65 73 75 6c 74 20 69 6e 20 61 20 70 61 72 73  result in a pars
d770: 65 20 65 72 72 6f 72 2e 0a 0a 20 20 57 41 52 4e  e error...  WARN
d780: 49 4e 47 3a 20 49 66 20 74 68 69 73 20 6d 61 63  ING: If this mac
d790: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 69  ro is defined, i
d7a0: 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 6f  t will not be po
d7b0: 73 73 69 62 6c 65 20 74 6f 20 6f 70 65 6e 20 61  ssible to open a
d7c0: 20 64 61 74 61 62 61 73 65 0a 20 20 66 6f 72 20   database.  for 
d7d0: 77 68 69 63 68 20 74 68 65 20 73 63 68 65 6d 61  which the schema
d7e0: 20 63 6f 6e 74 61 69 6e 73 20 56 49 45 57 20 6f   contains VIEW o
d7f0: 62 6a 65 63 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50  bjects. .}..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 52 54 55 41 4c 54  TE_OMIT_VIRTUALT
d820: 41 42 4c 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f  ABLE} {.  This o
d830: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70  ption omits supp
d840: 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 73 71 6c  ort for the [sql
d850: 69 74 65 33 5f 76 74 61 62 20 7c 20 56 69 72 74  ite3_vtab | Virt
d860: 75 61 6c 20 54 61 62 6c 65 5d 0a 20 20 6d 65 63  ual Table].  mec
d870: 68 61 6e 69 73 6d 20 69 6e 20 53 51 4c 69 74 65  hanism in SQLite
d880: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
d890: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
d8a0: 5f 57 41 4c 7d 20 7b 0a 20 20 54 68 69 73 20 6f  _WAL} {.  This o
d8b0: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20  ption omits the 
d8c0: 22 5b 77 72 69 74 65 2d 61 68 65 61 64 20 6c 6f  "[write-ahead lo
d8d0: 67 5d 22 20 28 61 2e 6b 2e 61 2e 20 22 5b 57 41  g]" (a.k.a. "[WA
d8e0: 4c 5d 22 29 20 63 61 70 61 62 69 6c 69 74 79 2e  L]") capability.
d8f0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
d900: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
d910: 57 53 44 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  WSD} {.  This op
d920: 74 69 6f 6e 20 62 75 69 6c 64 73 20 61 20 76 65  tion builds a ve
d930: 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c  rsion of the SQL
d940: 69 74 65 20 6c 69 62 72 61 72 79 20 74 68 61 74  ite library that
d950: 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 0a 20 20 57   contains no.  W
d960: 72 69 74 61 62 6c 65 20 53 74 61 74 69 63 20 44  ritable Static D
d970: 61 74 61 20 28 57 53 44 29 2e 20 20 57 53 44 20  ata (WSD).  WSD 
d980: 69 73 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62  is global variab
d990: 6c 65 73 20 61 6e 64 2f 6f 72 20 73 74 61 74 69  les and/or stati
d9a0: 63 0a 20 20 76 61 72 69 61 62 6c 65 73 2e 20 20  c.  variables.  
d9b0: 53 6f 6d 65 20 70 6c 61 74 66 6f 72 6d 73 20 64  Some platforms d
d9c0: 6f 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 57 53  o not support WS
d9d0: 44 2c 20 61 6e 64 20 74 68 69 73 20 6f 70 74 69  D, and this opti
d9e0: 6f 6e 20 69 73 20 6e 65 63 65 73 73 61 72 79 0a  on is necessary.
d9f0: 20 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 53    in order for S
da00: 51 4c 69 74 65 20 74 6f 20 77 6f 72 6b 20 74 68  QLite to work th
da10: 6f 73 65 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20  ose platforms.  
da20: 0a 0a 20 20 55 6e 6c 69 6b 65 20 6f 74 68 65 72  ..  Unlike other
da30: 20 4f 4d 49 54 20 6f 70 74 69 6f 6e 73 20 77 68   OMIT options wh
da40: 69 63 68 20 6d 61 6b 65 20 74 68 65 20 53 51 4c  ich make the SQL
da50: 69 74 65 20 6c 69 62 72 61 72 79 20 73 6d 61 6c  ite library smal
da60: 6c 65 72 2c 0a 20 20 74 68 69 73 20 6f 70 74 69  ler,.  this opti
da70: 6f 6e 20 61 63 74 75 61 6c 6c 79 20 69 6e 63 72  on actually incr
da80: 65 61 73 65 73 20 74 68 65 20 73 69 7a 65 20 6f  eases the size o
da90: 66 20 53 51 4c 69 74 65 20 61 6e 64 20 6d 61 6b  f SQLite and mak
daa0: 65 73 20 69 74 20 72 75 6e 0a 20 20 61 20 6c 69  es it run.  a li
dab0: 74 74 6c 65 20 73 6c 6f 77 65 72 2e 20 20 4f 6e  ttle slower.  On
dac0: 6c 79 20 75 73 65 20 74 68 69 73 20 6f 70 74 69  ly use this opti
dad0: 6f 6e 20 69 66 20 53 51 4c 69 74 65 20 69 73 20  on if SQLite is 
dae0: 62 65 69 6e 67 20 62 75 69 6c 74 20 66 6f 72 20  being built for 
daf0: 61 6e 0a 20 20 65 6d 62 65 64 64 65 64 20 74 61  an.  embedded ta
db00: 72 67 65 74 20 74 68 61 74 20 64 6f 65 73 20 6e  rget that does n
db10: 6f 74 20 73 75 70 70 6f 72 74 20 57 53 44 2e 0a  ot support WSD..
db20: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
db30: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 58  N {SQLITE_OMIT_X
db40: 46 45 52 5f 4f 50 54 7d 20 7b 0a 20 20 54 68 69  FER_OPT} {.  Thi
db50: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73  s option omits s
db60: 75 70 70 6f 72 74 20 66 6f 72 20 6f 70 74 69 6d  upport for optim
db70: 69 7a 61 74 69 6f 6e 73 20 74 68 61 74 20 68 65  izations that he
db80: 6c 70 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20  lp statements.  
db90: 6f 66 20 74 68 65 20 66 6f 72 6d 20 22 49 4e 53  of the form "INS
dba0: 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c  ERT INTO ... SEL
dbb0: 45 43 54 20 2e 2e 2e 22 20 72 75 6e 20 66 61 73  ECT ..." run fas
dbc0: 74 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ter..}..COMPILE_
dbd0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 5a  OPTION {SQLITE_Z
dbe0: 45 52 4f 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20 20  ERO_MALLOC} {.  
dbf0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
dc00: 73 20 62 6f 74 68 20 74 68 65 20 5b 64 65 66 61  s both the [defa
dc10: 75 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  ult memory alloc
dc20: 61 74 6f 72 5d 20 61 6e 64 20 74 68 65 0a 20 20  ator] and the.  
dc30: 5b 64 65 62 75 67 67 69 6e 67 20 6d 65 6d 6f 72  [debugging memor
dc40: 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 20 66 72 6f  y allocator] fro
dc50: 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64 20  m the build and 
dc60: 73 75 62 73 74 69 74 75 74 65 73 20 61 20 73 74  substitutes a st
dc70: 75 62 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  ub.  memory allo
dc80: 63 61 74 6f 72 20 74 68 61 74 20 61 6c 77 61 79  cator that alway
dc90: 73 20 66 61 69 6c 73 2e 20 20 53 51 4c 69 74 65  s fails.  SQLite
dca0: 20 77 69 6c 6c 20 6e 6f 74 20 72 75 6e 20 77 69   will not run wi
dcb0: 74 68 20 74 68 69 73 0a 20 20 73 74 75 62 20 6d  th this.  stub m
dcc0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20  emory allocator 
dcd0: 73 69 6e 63 65 20 69 74 20 77 69 6c 6c 20 62 65  since it will be
dce0: 20 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f 63   unable to alloc
dcf0: 61 74 65 20 6d 65 6d 6f 72 79 2e 20 20 42 75 74  ate memory.  But
dd00: 0a 20 20 74 68 69 73 20 73 74 75 62 20 63 61 6e  .  this stub can
dd10: 20 62 65 20 72 65 70 6c 61 63 65 64 20 61 74 20   be replaced at 
dd20: 73 74 61 72 74 2d 74 69 6d 65 20 75 73 69 6e 67  start-time using
dd30: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66  .  [sqlite3_conf
dd40: 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  ig]([SQLITE_CONF
dd50: 49 47 5f 4d 41 4c 4c 4f 43 5d 2c 2e 2e 2e 29 20  IG_MALLOC],...) 
dd60: 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f  or.  [sqlite3_co
dd70: 6e 66 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43 4f  nfig]([SQLITE_CO
dd80: 4e 46 49 47 5f 48 45 41 50 5d 2c 2e 2e 2e 29 2e  NFIG_HEAP],...).
dd90: 0a 20 20 53 6f 20 74 68 65 20 6e 65 74 20 65 66  .  So the net ef
dda0: 66 65 63 74 20 6f 66 20 74 68 69 73 20 63 6f 6d  fect of this com
ddb0: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
ddc0: 20 69 73 20 74 68 61 74 20 69 74 20 61 6c 6c 6f   is that it allo
ddd0: 77 73 20 53 51 4c 69 74 65 0a 20 20 74 6f 20 62  ws SQLite.  to b
dde0: 65 20 63 6f 6d 70 69 6c 65 64 20 61 6e 64 20 6c  e compiled and l
ddf0: 69 6e 6b 65 64 20 61 67 61 69 6e 73 74 20 61 20  inked against a 
de00: 73 79 73 74 65 6d 20 6c 69 62 72 61 72 79 20 74  system library t
de10: 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75 70  hat does not sup
de20: 70 6f 72 74 0a 20 20 6d 61 6c 6c 6f 63 28 29 2c  port.  malloc(),
de30: 20 66 72 65 65 28 29 2c 20 61 6e 64 2f 6f 72 20   free(), and/or 
de40: 72 65 61 6c 6c 6f 63 28 29 2e 0a 7d 0a 0a 3c 2f  realloc()..}..</
de50: 74 63 6c 3e 0a 3c 61 20 6e 61 6d 65 3d 22 64 65  tcl>.<a name="de
de60: 62 75 67 6f 70 74 69 6f 6e 73 22 3e 3c 2f 61 3e  bugoptions"></a>
de70: 0a 3c 68 32 3e 31 2e 38 20 41 6e 61 6c 79 73 69  .<h2>1.8 Analysi
de80: 73 20 61 6e 64 20 44 65 62 75 67 67 69 6e 67 20  s and Debugging 
de90: 4f 70 74 69 6f 6e 73 3c 2f 68 32 3e 0a 3c 74 63  Options</h2>.<tc
dea0: 6c 3e 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  l>..COMPILE_OPTI
deb0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 42 55 47  ON {SQLITE_DEBUG
dec0: 7d 20 7b 0a 20 20 54 68 65 20 53 51 4c 69 74 65  } {.  The SQLite
ded0: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 63 6f 6e   source code con
dee0: 74 61 69 6e 73 20 6c 69 74 65 72 61 6c 6c 79 20  tains literally 
def0: 74 68 6f 75 73 61 6e 64 73 20 6f 66 20 61 73 73  thousands of ass
df00: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73  ert() statements
df10: 0a 20 20 75 73 65 64 20 74 6f 20 76 65 72 69 66  .  used to verif
df20: 79 20 69 6e 74 65 72 6e 61 6c 20 61 73 73 75 6d  y internal assum
df30: 70 74 69 6f 6e 73 20 61 6e 64 20 73 75 62 72 6f  ptions and subro
df40: 75 74 69 6e 65 20 70 72 65 63 6f 6e 64 69 74 69  utine preconditi
df50: 6f 6e 73 20 61 6e 64 0a 20 20 70 6f 73 74 63 6f  ons and.  postco
df60: 6e 64 69 74 69 6f 6e 73 2e 20 20 54 68 65 73 65  nditions.  These
df70: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d   assert() statem
df80: 65 6e 74 73 20 61 72 65 20 6e 6f 72 6d 61 6c 6c  ents are normall
df90: 79 20 74 75 72 6e 65 64 20 6f 66 66 0a 20 20 28  y turned off.  (
dfa0: 74 68 65 79 20 67 65 6e 65 72 61 74 65 20 6e 6f  they generate no
dfb0: 20 63 6f 64 65 29 20 73 69 6e 63 65 20 74 75 72   code) since tur
dfc0: 6e 69 6e 67 20 74 68 65 6d 20 6f 6e 20 6d 61 6b  ning them on mak
dfd0: 65 73 20 53 51 4c 69 74 65 20 72 75 6e 20 61 70  es SQLite run ap
dfe0: 70 72 6f 78 69 6d 61 74 65 6c 79 0a 20 20 74 68  proximately.  th
dff0: 72 65 65 20 74 69 6d 65 73 20 73 6c 6f 77 65 72  ree times slower
e000: 2e 20 20 42 75 74 20 66 6f 72 20 74 65 73 74 69  .  But for testi
e010: 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 2c  ng and analysis,
e020: 20 69 74 20 69 73 20 75 73 65 66 75 6c 20 74 6f   it is useful to
e030: 20 74 75 72 6e 0a 20 20 74 68 65 20 61 73 73 65   turn.  the asse
e040: 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20  rt() statements 
e050: 6f 6e 2e 20 20 54 68 65 20 53 51 4c 49 54 45 5f  on.  The SQLITE_
e060: 44 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 69  DEBUG compile-ti
e070: 6d 65 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20 74  me option does t
e080: 68 69 73 2e 0a 20 20 3c 70 3e 53 51 4c 49 54 45  his..  <p>SQLITE
e090: 5f 44 45 42 55 47 20 61 6c 73 6f 20 65 6e 61 62  _DEBUG also enab
e0a0: 6c 65 73 20 73 6f 6d 65 20 6f 74 68 65 72 20 64  les some other d
e0b0: 65 62 75 67 67 69 6e 67 20 66 65 61 74 75 72 65  ebugging feature
e0c0: 73 2c 20 73 75 63 68 20 61 73 0a 20 20 73 70 65  s, such as.  spe
e0d0: 63 69 61 6c 20 5b 50 52 41 47 4d 41 5d 20 73 74  cial [PRAGMA] st
e0e0: 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 74 75  atements that tu
e0f0: 72 6e 20 6f 6e 20 74 72 61 63 69 6e 67 20 61 6e  rn on tracing an
e100: 64 20 6c 69 73 74 69 6e 67 20 66 65 61 74 75 72  d listing featur
e110: 65 73 0a 20 20 75 73 65 64 20 66 6f 72 20 74 72  es.  used for tr
e120: 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 20 61 6e  oubleshooting an
e130: 64 20 61 6e 61 6c 79 73 69 73 20 6f 66 20 74 68  d analysis of th
e140: 65 20 5b 56 44 42 45 5d 20 61 6e 64 20 63 6f 64  e [VDBE] and cod
e150: 65 20 67 65 6e 65 72 61 74 6f 72 2e 0a 7d 0a 0a  e generator..}..
e160: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
e170: 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 7d  SQLITE_MEMDEBUG}
e180: 20 7b 0a 20 20 54 68 65 20 53 51 4c 49 54 45 5f   {.  The SQLITE_
e190: 4d 45 4d 44 45 42 55 47 20 6f 70 74 69 6f 6e 20  MEMDEBUG option 
e1a0: 63 61 75 73 65 73 20 61 6e 20 69 6e 73 74 72 75  causes an instru
e1b0: 6d 65 6e 74 65 64 20 0a 20 20 5b 64 65 62 75 67  mented .  [debug
e1c0: 67 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  ging memory allo
e1d0: 63 61 74 6f 72 5d 0a 20 20 74 6f 20 62 65 20 75  cator].  to be u
e1e0: 73 65 64 20 61 73 20 74 68 65 20 64 65 66 61 75  sed as the defau
e1f0: 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  lt memory alloca
e200: 74 6f 72 20 77 69 74 68 69 6e 20 53 51 4c 69 74  tor within SQLit
e210: 65 2e 20 20 54 68 65 0a 20 20 69 6e 73 74 72 75  e.  The.  instru
e220: 6d 65 6e 74 65 64 20 6d 65 6d 6f 72 79 20 61 6c  mented memory al
e230: 6c 6f 63 61 74 6f 72 20 63 68 65 63 6b 73 20 66  locator checks f
e240: 6f 72 20 6d 69 73 75 73 65 20 6f 66 20 64 79 6e  or misuse of dyn
e250: 61 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74  amically allocat
e260: 65 64 0a 20 20 6d 65 6d 6f 72 79 2e 20 20 45 78  ed.  memory.  Ex
e270: 61 6d 70 6c 65 73 20 6f 66 20 6d 69 73 75 73 65  amples of misuse
e280: 20 69 6e 63 6c 75 64 65 20 75 73 69 6e 67 20 6d   include using m
e290: 65 6d 6f 72 79 20 61 66 74 65 72 20 69 74 20 69  emory after it i
e2a0: 73 20 66 72 65 65 64 2c 0a 20 20 77 72 69 74 69  s freed,.  writi
e2b0: 6e 67 20 6f 66 66 20 74 68 65 20 65 6e 64 73 20  ng off the ends 
e2c0: 6f 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  of a memory allo
e2d0: 63 61 74 69 6f 6e 2c 20 66 72 65 65 69 6e 67 20  cation, freeing 
e2e0: 6d 65 6d 6f 72 79 20 6e 6f 74 20 70 72 65 76 69  memory not previ
e2f0: 6f 75 73 6c 79 0a 20 20 6f 62 74 61 69 6e 65 64  ously.  obtained
e300: 20 66 72 6f 6d 20 74 68 65 20 6d 65 6d 6f 72 79   from the memory
e310: 20 61 6c 6c 6f 63 61 74 6f 72 2c 20 6f 72 20 66   allocator, or f
e320: 61 69 6c 69 6e 67 20 74 6f 20 69 6e 69 74 69 61  ailing to initia
e330: 6c 69 7a 65 20 6e 65 77 6c 79 0a 20 20 61 6c 6c  lize newly.  all
e340: 6f 63 61 74 65 64 20 6d 65 6d 6f 72 79 2e 0a 7d  ocated memory..}
e350: 0a 0a 3c 2f 74 63 6c 3e 0a 3c 61 20 6e 61 6d 65  ..</tcl>.<a name
e360: 3d 22 77 69 6e 33 32 6f 70 74 69 6f 6e 73 22 3e  ="win32options">
e370: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 39 20 57 69 6e  </a>.<h2>1.9 Win
e380: 64 6f 77 73 2d 53 70 65 63 69 66 69 63 20 4f 70  dows-Specific Op
e390: 74 69 6f 6e 73 3c 2f 68 32 3e 0a 3c 74 63 6c 3e  tions</h2>.<tcl>
e3a0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
e3b0: 20 7b 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 48   {SQLITE_WIN32_H
e3c0: 45 41 50 5f 43 52 45 41 54 45 7d 20 7b 0a 20 20  EAP_CREATE} {.  
e3d0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 66 6f 72 63  This option forc
e3e0: 65 73 20 74 68 65 20 57 69 6e 33 32 20 6e 61 74  es the Win32 nat
e3f0: 69 76 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  ive memory alloc
e400: 61 74 6f 72 2c 20 77 68 65 6e 20 65 6e 61 62 6c  ator, when enabl
e410: 65 64 2c 20 74 6f 0a 20 20 63 72 65 61 74 65 20  ed, to.  create 
e420: 61 20 70 72 69 76 61 74 65 20 68 65 61 70 20 74  a private heap t
e430: 6f 20 68 6f 6c 64 20 61 6c 6c 20 6d 65 6d 6f 72  o hold all memor
e440: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2e 0a 7d  y allocations..}
e450: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
e460: 20 7b 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d   {SQLITE_WIN32_M
e470: 41 4c 4c 4f 43 5f 56 41 4c 49 44 41 54 45 7d 20  ALLOC_VALIDATE} 
e480: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
e490: 66 6f 72 63 65 73 20 74 68 65 20 57 69 6e 33 32  forces the Win32
e4a0: 20 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 61   native memory a
e4b0: 6c 6c 6f 63 61 74 6f 72 2c 20 77 68 65 6e 20 65  llocator, when e
e4c0: 6e 61 62 6c 65 64 2c 20 74 6f 0a 20 20 6d 61 6b  nabled, to.  mak
e4d0: 65 20 73 74 72 61 74 65 67 69 63 20 63 61 6c 6c  e strategic call
e4e0: 73 20 69 6e 74 6f 20 74 68 65 20 48 65 61 70 56  s into the HeapV
e4f0: 61 6c 69 64 61 74 65 28 29 20 66 75 6e 63 74 69  alidate() functi
e500: 6f 6e 20 69 66 20 61 73 73 65 72 74 28 29 20 69  on if assert() i
e510: 73 20 61 6c 73 6f 0a 20 20 65 6e 61 62 6c 65 64  s also.  enabled
e520: 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a              ..}..</tcl>.