Documentation Source Text

Hex Artifact Content
Login

Artifact 95244df0eb08b10a83e870e031b9c51b035db86b:


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 3c 61 20  ptions..</p>.<a 
0340: 6e 61 6d 65 3d 22 64 65 66 61 75 6c 74 73 22 3e  name="defaults">
0350: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 4f 70 74  </a>.<h2>1.1 Opt
0360: 69 6f 6e 73 20 54 6f 20 53 65 74 20 44 65 66 61  ions To Set Defa
0370: 75 6c 74 20 50 61 72 61 6d 65 74 65 72 20 56 61  ult Parameter Va
0380: 6c 75 65 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e  lues</h2>..<tcl>
0390: 0a 70 72 6f 63 20 43 4f 4d 50 49 4c 45 5f 4f 50  .proc COMPILE_OP
03a0: 54 49 4f 4e 20 7b 6e 61 6d 65 20 74 65 78 74 7d  TION {name text}
03b0: 20 7b 0a 20 20 69 66 20 7b 5b 72 65 67 65 78 70   {.  if {[regexp
03c0: 20 7b 53 51 4c 49 54 45 5f 28 5b 41 2d 5a 30 2d   {SQLITE_([A-Z0-
03d0: 39 5f 5d 2b 29 7d 20 24 6e 61 6d 65 20 61 6c 6c  9_]+)} $name all
03e0: 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20 68   label]} {.    h
03f0: 64 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72 69  d_fragment [stri
0400: 6e 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62 65  ng tolower $labe
0410: 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f 72  l].    hd_keywor
0420: 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 69 66  ds $all.  }.  if
0430: 20 7b 5b 72 65 67 65 78 70 20 7b 5e 59 59 28 5b   {[regexp {^YY([
0440: 41 2d 5a 30 2d 39 5f 5d 2b 29 7d 20 24 6e 61 6d  A-Z0-9_]+)} $nam
0450: 65 20 61 6c 6c 20 6c 61 62 65 6c 5d 7d 20 7b 0a  e all label]} {.
0460: 20 20 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20      hd_fragment 
0470: 5b 73 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72 20  [string tolower 
0480: 24 61 6c 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79  $all].    hd_key
0490: 77 6f 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20  words $all.  }. 
04a0: 20 68 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e 24   hd_puts <p><b>$
04b0: 6e 61 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 72  name</b></p>.  r
04c0: 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c 5c  egsub -all "\n\\
04d0: 73 2a 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f 70  s*\n" $text "</p
04e0: 3e 5c 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a 20  >\n\n<p>" text. 
04f0: 20 68 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c 6f   hd_resolve <blo
0500: 63 6b 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78 74  ckquote><p>$text
0510: 3c 2f 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  </p></blockquote
0520: 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  >.}..COMPILE_OPT
0530: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41  ION {SQLITE_DEFA
0540: 55 4c 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e  ULT_AUTOMATIC_IN
0550: 44 45 58 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20  DEX=<i>&lt;0 or 
0560: 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  1&gt;</i>} {.  T
0570: 68 69 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d  his macro determ
0580: 69 6e 65 73 20 74 68 65 20 69 6e 69 74 69 61 6c  ines the initial
0590: 20 73 65 74 74 69 6e 67 20 66 6f 72 20 5b 50 52   setting for [PR
05a0: 41 47 4d 41 20 61 75 74 6f 6d 61 74 69 63 5f 69  AGMA automatic_i
05b0: 6e 64 65 78 5d 0a 20 20 66 6f 72 20 6e 65 77 6c  ndex].  for newl
05c0: 79 20 6f 70 65 6e 65 64 20 5b 64 61 74 61 62 61  y opened [databa
05d0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 2e  se connections].
05e0: 0a 20 20 46 6f 72 20 61 6c 6c 20 76 65 72 73 69  .  For all versi
05f0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 74 68  ons of SQLite th
0600: 72 6f 75 67 68 20 33 2e 37 2e 31 37 2c 0a 20 20  rough 3.7.17,.  
0610: 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 69 63 65  automatic indice
0620: 73 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 65  s are normally e
0630: 6e 61 62 6c 65 64 20 66 6f 72 20 6e 65 77 20 64  nabled for new d
0640: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
0650: 6f 6e 73 20 69 66 0a 20 20 74 68 69 73 20 63 6f  ons if.  this co
0660: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
0670: 6e 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 20 20  n is omitted..  
0680: 48 6f 77 65 76 65 72 2c 20 74 68 61 74 20 6d 69  However, that mi
0690: 67 68 74 20 63 68 61 6e 67 65 20 69 6e 20 66 75  ght change in fu
06a0: 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 6f 66  ture releases of
06b0: 20 53 51 4c 69 74 65 2e 0a 20 20 3c 70 3e 53 65   SQLite..  <p>Se
06c0: 65 20 61 6c 73 6f 3a 20 5b 53 51 4c 49 54 45 5f  e also: [SQLITE_
06d0: 4f 4d 49 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49  OMIT_AUTOMATIC_I
06e0: 4e 44 45 58 5d 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  NDEX].}..COMPILE
06f0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
0700: 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55  DEFAULT_AUTOVACU
0710: 55 4d 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31  UM=<i>&lt;0 or 1
0720: 20 6f 72 20 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b   or 2&gt;</i>} {
0730: 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64 65  .  This macro de
0740: 74 65 72 6d 69 6e 65 73 20 69 66 20 53 51 4c 69  termines if SQLi
0750: 74 65 20 63 72 65 61 74 65 73 20 64 61 74 61 62  te creates datab
0760: 61 73 65 73 20 77 69 74 68 20 74 68 65 20 0a 20  ases with the . 
0770: 20 5b 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20 66   [auto_vacuum] f
0780: 6c 61 67 20 73 65 74 20 62 79 20 64 65 66 61 75  lag set by defau
0790: 6c 74 20 74 6f 20 4f 46 46 20 28 30 29 2c 20 46  lt to OFF (0), F
07a0: 55 4c 4c 20 28 31 29 2c 20 6f 72 0a 20 20 49 4e  ULL (1), or.  IN
07b0: 43 52 45 4d 45 4e 54 41 4c 20 28 32 29 2e 20 54  CREMENTAL (2). T
07c0: 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65  he default value
07d0: 20 69 73 20 30 20 6d 65 61 6e 69 6e 67 20 74 68   is 0 meaning th
07e0: 61 74 20 64 61 74 61 62 61 73 65 73 0a 20 20 61  at databases.  a
07f0: 72 65 20 63 72 65 61 74 65 64 20 77 69 74 68 20  re created with 
0800: 61 75 74 6f 2d 76 61 63 75 75 6d 20 74 75 72 6e  auto-vacuum turn
0810: 65 64 20 6f 66 66 2e 0a 20 20 49 6e 20 61 6e 79  ed off..  In any
0820: 20 63 61 73 65 20 74 68 65 20 63 6f 6d 70 69 6c   case the compil
0830: 65 2d 74 69 6d 65 20 64 65 66 61 75 6c 74 20 6d  e-time default m
0840: 61 79 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e  ay be overridden
0850: 20 62 79 20 74 68 65 20 0a 20 20 5b 50 52 41 47   by the .  [PRAG
0860: 4d 41 20 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20  MA auto_vacuum] 
0870: 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50  command..}..COMP
0880: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
0890: 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45  TE_DEFAULT_CACHE
08a0: 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 70 61 67  _SIZE=<i>&lt;pag
08b0: 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20  es&gt;</i>} {.  
08c0: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
08d0: 74 68 65 20 64 65 66 61 75 6c 74 20 73 69 7a 65  the default size
08e0: 20 6f 66 20 74 68 65 20 70 61 67 65 2d 63 61 63   of the page-cac
08f0: 68 65 20 66 6f 72 20 65 61 63 68 20 61 74 74 61  he for each atta
0900: 63 68 65 64 0a 20 20 64 61 74 61 62 61 73 65 2c  ched.  database,
0910: 20 69 6e 20 70 61 67 65 73 2e 20 54 68 69 73 20   in pages. This 
0920: 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65  can be overridde
0930: 6e 20 62 79 20 74 68 65 20 0a 20 20 5b 50 52 41  n by the .  [PRA
0940: 47 4d 41 20 63 61 63 68 65 5f 73 69 7a 65 5d 20  GMA cache_size] 
0950: 63 6f 6d 6d 61 6e 64 2e 20 54 68 65 20 64 65 66  command. The def
0960: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 32 30  ault value is 20
0970: 30 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  00..}..COMPILE_O
0980: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
0990: 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41  FAULT_FILE_FORMA
09a0: 54 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 20 34 26  T=<i>&lt;1 or 4&
09b0: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 65  gt;</i>} {.  The
09c0: 20 64 65 66 61 75 6c 74 20 5b 73 63 68 65 6d 61   default [schema
09d0: 20 66 6f 72 6d 61 74 20 6e 75 6d 62 65 72 5d 20   format number] 
09e0: 75 73 65 64 20 62 79 20 53 51 4c 69 74 65 20 77  used by SQLite w
09f0: 68 65 6e 20 63 72 65 61 74 69 6e 67 0a 20 20 6e  hen creating.  n
0a00: 65 77 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ew database file
0a10: 73 20 69 73 20 73 65 74 20 62 79 20 74 68 69 73  s is set by this
0a20: 20 6d 61 63 72 6f 2e 20 20 54 68 65 20 73 63 68   macro.  The sch
0a30: 65 6d 61 20 66 6f 72 6d 61 74 73 20 61 72 65 20  ema formats are 
0a40: 61 6c 6c 0a 20 20 76 65 72 79 20 73 69 6d 69 6c  all.  very simil
0a50: 61 72 2e 20 20 54 68 65 20 64 69 66 66 65 72 65  ar.  The differe
0a60: 6e 63 65 20 62 65 74 77 65 65 6e 20 66 6f 72 6d  nce between form
0a70: 61 74 73 20 31 20 61 6e 64 20 34 20 69 73 20 74  ats 1 and 4 is t
0a80: 68 61 74 20 66 6f 72 6d 61 74 0a 20 20 34 20 75  hat format.  4 u
0a90: 6e 64 65 72 73 74 61 6e 64 73 20 5b 64 65 73 63  nderstands [desc
0aa0: 65 6e 64 69 6e 67 20 69 6e 64 69 63 65 73 5d 20  ending indices] 
0ab0: 61 6e 64 20 68 61 73 20 61 20 74 69 67 68 74 65  and has a tighte
0ac0: 72 20 65 6e 63 6f 64 69 6e 67 20 66 6f 72 0a 20  r encoding for. 
0ad0: 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 73 2e   boolean values.
0ae0: 0a 0a 20 20 41 6c 6c 20 76 65 72 73 69 6f 6e 73  ..  All versions
0af0: 20 6f 66 20 53 51 4c 69 74 65 20 73 69 6e 63 65   of SQLite since
0b00: 20 33 2e 33 2e 30 20 28 32 30 30 36 2d 30 31 2d   3.3.0 (2006-01-
0b10: 31 30 29 0a 20 20 63 61 6e 20 72 65 61 64 20 61  10).  can read a
0b20: 6e 64 20 77 72 69 74 65 20 61 6e 79 20 73 63 68  nd write any sch
0b30: 65 6d 61 20 66 6f 72 6d 61 74 0a 20 20 62 65 74  ema format.  bet
0b40: 77 65 65 6e 20 31 20 61 6e 64 20 34 2e 20 20 42  ween 1 and 4.  B
0b50: 75 74 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e  ut older version
0b60: 73 20 6f 66 20 53 51 4c 69 74 65 20 6d 69 67 68  s of SQLite migh
0b70: 74 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f  t not be able to
0b80: 0a 20 20 72 65 61 64 20 66 6f 72 6d 61 74 73 20  .  read formats 
0b90: 67 72 65 61 74 65 72 20 74 68 61 6e 20 31 2e 20  greater than 1. 
0ba0: 20 53 6f 20 74 68 61 74 20 6f 6c 64 65 72 20 76   So that older v
0bb0: 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74  ersions of SQLit
0bc0: 65 20 77 69 6c 6c 0a 20 20 62 65 20 61 62 6c 65  e will.  be able
0bd0: 20 74 6f 20 72 65 61 64 20 61 6e 64 20 77 72 69   to read and wri
0be0: 74 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  te database file
0bf0: 73 20 63 72 65 61 74 65 64 20 62 79 20 6e 65 77  s created by new
0c00: 65 72 20 76 65 72 73 69 6f 6e 73 0a 20 20 6f 66  er versions.  of
0c10: 20 53 51 4c 69 74 65 2c 20 74 68 65 20 64 65 66   SQLite, the def
0c20: 61 75 6c 74 20 73 63 68 65 6d 61 20 66 6f 72 6d  ault schema form
0c30: 61 74 20 77 61 73 20 73 65 74 20 74 6f 20 31 20  at was set to 1 
0c40: 66 6f 72 20 53 51 4c 69 74 65 20 76 65 72 73 69  for SQLite versi
0c50: 6f 6e 73 0a 20 20 74 68 72 6f 75 67 68 20 33 2e  ons.  through 3.
0c60: 37 2e 39 20 28 32 30 31 31 2d 31 31 2d 30 31 29  7.9 (2011-11-01)
0c70: 2e 20 20 42 65 67 69 6e 6e 69 6e 67 20 77 69 74  .  Beginning wit
0c80: 68 20 76 65 72 73 69 6f 6e 20 33 2e 37 2e 31 30  h version 3.7.10
0c90: 2c 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20  , the default.  
0ca0: 73 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 69 73  schema format is
0cb0: 20 34 2e 0a 0a 20 20 54 68 65 20 73 63 68 65 6d   4...  The schem
0cc0: 61 20 66 6f 72 6d 61 74 20 6e 75 6d 62 65 72 20  a format number 
0cd0: 66 6f 72 20 61 20 6e 65 77 20 64 61 74 61 62 61  for a new databa
0ce0: 73 65 20 63 61 6e 20 62 65 20 73 65 74 20 61 74  se can be set at
0cf0: 20 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 0a 20   runtime using. 
0d00: 20 74 68 65 20 5b 50 52 41 47 4d 41 20 6c 65 67   the [PRAGMA leg
0d10: 61 63 79 5f 66 69 6c 65 5f 66 6f 72 6d 61 74 5d  acy_file_format]
0d20: 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d   command..}..COM
0d30: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
0d40: 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45  ITE_DEFAULT_FILE
0d50: 5f 50 45 52 4d 49 53 53 49 4f 4e 53 3d 3c 69 3e  _PERMISSIONS=<i>
0d60: 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 65 20 64  N</i>} {.  The d
0d70: 65 66 61 75 6c 74 20 6e 75 6d 65 72 69 63 20 66  efault numeric f
0d80: 69 6c 65 20 70 65 72 6d 69 73 73 69 6f 6e 73 20  ile permissions 
0d90: 66 6f 72 20 6e 65 77 6c 79 20 63 72 65 61 74 65  for newly create
0da0: 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  d database files
0db0: 0a 20 20 75 6e 64 65 72 20 75 6e 69 78 2e 20 20  .  under unix.  
0dc0: 49 66 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64  If not specified
0dd0: 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73  , the default is
0de0: 20 30 36 34 34 20 77 68 69 63 68 20 6d 65 61 6e   0644 which mean
0df0: 73 20 74 68 61 74 0a 20 20 74 68 65 20 66 69 6c  s that.  the fil
0e00: 65 73 20 69 73 20 67 6c 6f 62 61 6c 6c 79 20 72  es is globally r
0e10: 65 61 64 61 62 6c 65 20 62 75 74 20 6f 6e 6c 79  eadable but only
0e20: 20 77 72 69 74 61 62 6c 65 20 62 79 20 74 68 65   writable by the
0e30: 20 63 72 65 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d   creator..}..COM
0e40: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
0e50: 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 4f 52 45  ITE_DEFAULT_FORE
0e60: 49 47 4e 5f 4b 45 59 53 3d 3c 69 3e 26 6c 74 3b  IGN_KEYS=<i>&lt;
0e70: 30 20 6f 72 20 31 26 67 74 3b 3c 2f 69 3e 7d 20  0 or 1&gt;</i>} 
0e80: 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 64  {.  This macro d
0e90: 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65  etermines whethe
0ea0: 72 20 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66  r enforcement of
0eb0: 20 0a 20 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79   .  [foreign key
0ec0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 5d 20 69 73   constraints] is
0ed0: 20 65 6e 61 62 6c 65 64 20 6f 72 20 64 69 73 61   enabled or disa
0ee0: 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 20  bled by default 
0ef0: 66 6f 72 0a 20 20 6e 65 77 20 64 61 74 61 62 61  for.  new databa
0f00: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20  se connections. 
0f10: 20 45 61 63 68 20 64 61 74 61 62 61 73 65 20 63   Each database c
0f20: 6f 6e 6e 65 63 74 69 6f 6e 20 63 61 6e 20 61 6c  onnection can al
0f30: 77 61 79 73 20 74 75 72 6e 0a 20 20 65 6e 66 6f  ways turn.  enfo
0f40: 72 63 65 6d 65 6e 74 20 6f 66 20 66 6f 72 65 69  rcement of forei
0f50: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
0f60: 74 73 20 6f 6e 20 61 6e 64 20 6f 66 66 20 61 6e  ts on and off an
0f70: 64 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67  d run-time using
0f80: 0a 20 20 74 68 65 20 5b 66 6f 72 65 69 67 6e 5f  .  the [foreign_
0f90: 6b 65 79 73 20 70 72 61 67 6d 61 5d 2e 20 20 45  keys pragma].  E
0fa0: 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 66 6f  nforcement of fo
0fb0: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
0fc0: 61 69 6e 74 73 0a 20 20 69 73 20 6e 6f 72 6d 61  aints.  is norma
0fd0: 6c 6c 79 20 6f 66 66 20 62 79 20 64 65 66 61 75  lly off by defau
0fe0: 6c 74 2c 20 62 75 74 20 69 66 20 74 68 69 73 20  lt, but if this 
0ff0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 70 61 72  compile-time par
1000: 61 6d 65 74 65 72 20 69 73 0a 20 20 73 65 74 20  ameter is.  set 
1010: 74 6f 20 31 2c 20 65 6e 66 6f 72 63 65 6d 65 6e  to 1, enforcemen
1020: 74 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b 65 79  t of foreign key
1030: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 77 69 6c   constraints wil
1040: 6c 20 62 65 20 6f 6e 20 62 79 20 64 65 66 61 75  l be on by defau
1050: 6c 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  lt..}..COMPILE_O
1060: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
1070: 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 3d  FAULT_MMAP_SIZE=
1080: 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  <i>N</i>} {.  Th
1090: 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68  is macro sets th
10a0: 65 20 64 65 66 61 75 6c 74 20 6c 69 6d 69 74 20  e default limit 
10b0: 6f 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66  on the amount of
10c0: 20 6d 65 6d 6f 72 79 20 74 68 61 74 0a 20 20 77   memory that.  w
10d0: 69 6c 6c 20 62 65 20 75 73 65 64 20 66 6f 72 20  ill be used for 
10e0: 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f  memory-mapped I/
10f0: 4f 0a 20 20 66 6f 72 20 65 61 63 68 20 6f 70 65  O.  for each ope
1100: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  n database file.
1110: 20 20 49 66 20 74 68 65 20 3c 69 3e 4e 3c 2f 69    If the <i>N</i
1120: 3e 0a 20 20 69 73 20 7a 65 72 6f 2c 20 74 68 65  >.  is zero, the
1130: 6e 20 6d 65 6d 6f 72 79 20 6d 61 70 70 65 64 20  n memory mapped 
1140: 49 2f 4f 20 69 73 20 64 69 73 61 62 6c 65 64 20  I/O is disabled 
1150: 62 79 20 64 65 66 61 75 6c 74 2e 20 20 54 68 69  by default.  Thi
1160: 73 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  s.  compile-time
1170: 20 6c 69 6d 69 74 20 61 6e 64 20 74 68 65 20 5b   limit and the [
1180: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f  SQLITE_MAX_MMAP_
1190: 53 49 5a 45 5d 20 63 61 6e 20 62 65 20 6d 6f 64  SIZE] can be mod
11a0: 69 66 69 65 64 20 0a 20 20 61 74 20 73 74 61 72  ified .  at star
11b0: 74 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65  t-time using the
11c0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66  .  [sqlite3_conf
11d0: 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  ig]([SQLITE_CONF
11e0: 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 5d 29 20 63  IG_MMAP_SIZE]) c
11f0: 61 6c 6c 2c 20 6f 72 20 61 74 20 72 75 6e 2d 74  all, or at run-t
1200: 69 6d 65 0a 20 20 75 73 69 6e 67 20 74 68 65 20  ime.  using the 
1210: 5b 6d 6d 61 70 5f 73 69 7a 65 20 70 72 61 67 6d  [mmap_size pragm
1220: 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  a]..}..COMPILE_O
1230: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
1240: 46 41 55 4c 54 5f 4a 4f 55 52 4e 41 4c 5f 53 49  FAULT_JOURNAL_SI
1250: 5a 45 5f 4c 49 4d 49 54 3d 3c 69 3e 26 6c 74 3b  ZE_LIMIT=<i>&lt;
1260: 62 79 74 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b  bytes&gt;</i>} {
1270: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73  .  This option s
1280: 65 74 73 20 74 68 65 20 73 69 7a 65 20 6c 69 6d  ets the size lim
1290: 69 74 20 6f 6e 20 5b 72 6f 6c 6c 62 61 63 6b 20  it on [rollback 
12a0: 6a 6f 75 72 6e 61 6c 5d 20 66 69 6c 65 73 20 69  journal] files i
12b0: 6e 0a 20 20 5b 6a 6f 75 72 6e 61 6c 5f 6d 6f 64  n.  [journal_mod
12c0: 65 20 70 72 61 67 6d 61 20 7c 20 70 65 72 73 69  e pragma | persi
12d0: 73 74 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 6d 6f  stent journal mo
12e0: 64 65 5d 20 61 6e 64 0a 20 20 5b 6c 6f 63 6b 69  de] and.  [locki
12f0: 6e 67 5f 6d 6f 64 65 20 7c 20 65 78 63 6c 75 73  ng_mode | exclus
1300: 69 76 65 20 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65  ive locking mode
1310: 5d 20 61 6e 64 20 6f 6e 20 74 68 65 20 73 69 7a  ] and on the siz
1320: 65 20 6f 66 20 74 68 65 0a 20 20 77 72 69 74 65  e of the.  write
1330: 2d 61 68 65 61 64 20 6c 6f 67 20 66 69 6c 65 20  -ahead log file 
1340: 69 6e 20 5b 57 41 4c 20 6d 6f 64 65 5d 2e 20 57  in [WAL mode]. W
1350: 68 65 6e 20 74 68 69 73 20 0a 20 20 63 6f 6d 70  hen this .  comp
1360: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20  ile-time option 
1370: 69 73 20 6f 6d 69 74 74 65 64 20 74 68 65 72 65  is omitted there
1380: 20 69 73 20 6e 6f 20 75 70 70 65 72 20 62 6f 75   is no upper bou
1390: 6e 64 20 6f 6e 20 74 68 65 0a 20 20 73 69 7a 65  nd on the.  size
13a0: 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b   of the rollback
13b0: 20 6a 6f 75 72 6e 61 6c 73 20 6f 72 20 77 72 69   journals or wri
13c0: 74 65 2d 61 68 65 61 64 20 6c 6f 67 73 2e 20 20  te-ahead logs.  
13d0: 0a 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66  .  The journal f
13e0: 69 6c 65 20 73 69 7a 65 20 6c 69 6d 69 74 0a 20  ile size limit. 
13f0: 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20   can be changed 
1400: 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e  at run-time usin
1410: 67 20 74 68 65 20 5b 6a 6f 75 72 6e 61 6c 5f 73  g the [journal_s
1420: 69 7a 65 5f 6c 69 6d 69 74 20 70 72 61 67 6d 61  ize_limit pragma
1430: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
1440: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
1450: 41 55 4c 54 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44  AULT_LOCKING_MOD
1460: 45 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 20 30 26  E=<i>&lt;1 or 0&
1470: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 49 66 20  gt;</i>} {.  If 
1480: 73 65 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 74  set to 1, then t
1490: 68 65 20 64 65 66 61 75 6c 74 20 5b 6c 6f 63 6b  he default [lock
14a0: 69 6e 67 5f 6d 6f 64 65 5d 20 69 73 20 73 65 74  ing_mode] is set
14b0: 20 74 6f 20 45 58 43 4c 55 53 49 56 45 2e 0a 20   to EXCLUSIVE.. 
14c0: 20 49 66 20 6f 6d 69 74 74 65 64 20 6f 72 20 73   If omitted or s
14d0: 65 74 20 74 6f 20 30 20 74 68 65 6e 20 74 68 65  et to 0 then the
14e0: 20 64 65 66 61 75 6c 74 20 5b 6c 6f 63 6b 69 6e   default [lockin
14f0: 67 5f 6d 6f 64 65 5d 20 69 73 20 4e 4f 52 4d 41  g_mode] is NORMA
1500: 4c 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  L..}..COMPILE_OP
1510: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
1520: 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 3d 3c  AULT_MEMSTATUS=<
1530: 69 3e 26 6c 74 3b 31 20 6f 72 20 30 26 67 74 3b  i>&lt;1 or 0&gt;
1540: 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d  </i>} {.  This m
1550: 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20  acro is used to 
1560: 64 65 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65  determine whethe
1570: 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 66 65 61  r or not the fea
1580: 74 75 72 65 73 20 65 6e 61 62 6c 65 64 20 61 6e  tures enabled an
1590: 64 0a 20 20 64 69 73 61 62 6c 65 64 20 75 73 69  d.  disabled usi
15a0: 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 4f  ng the SQLITE_CO
15b0: 4e 46 49 47 5f 4d 45 4d 53 54 41 54 55 53 20 61  NFIG_MEMSTATUS a
15c0: 72 67 75 6d 65 6e 74 20 74 6f 20 5b 73 71 6c 69  rgument to [sqli
15d0: 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 0a 20 20  te3_config()].  
15e0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79  are available by
15f0: 20 64 65 66 61 75 6c 74 2e 20 54 68 65 20 64 65   default. The de
1600: 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 31  fault value is 1
1610: 20 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47   ([SQLITE_CONFIG
1620: 5f 4d 45 4d 53 54 41 54 55 53 5d 0a 20 20 72 65  _MEMSTATUS].  re
1630: 6c 61 74 65 64 20 66 65 61 74 75 72 65 73 20 65  lated features e
1640: 6e 61 62 6c 65 64 29 2e 0a 7d 0a 0a 43 4f 4d 50  nabled)..}..COMP
1650: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
1660: 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f  TE_DEFAULT_PAGE_
1670: 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 62 79 74 65  SIZE=<i>&lt;byte
1680: 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  s&gt;</i>} {.  T
1690: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65  his macro is use
16a0: 64 20 74 6f 20 73 65 74 20 74 68 65 20 64 65 66  d to set the def
16b0: 61 75 6c 74 20 70 61 67 65 2d 73 69 7a 65 20 75  ault page-size u
16c0: 73 65 64 20 77 68 65 6e 20 61 0a 20 20 64 61 74  sed when a.  dat
16d0: 61 62 61 73 65 20 69 73 20 63 72 65 61 74 65 64  abase is created
16e0: 2e 20 54 68 65 20 76 61 6c 75 65 20 61 73 73 69  . The value assi
16f0: 67 6e 65 64 20 6d 75 73 74 20 62 65 20 61 20 70  gned must be a p
1700: 6f 77 65 72 20 6f 66 20 32 2e 20 54 68 65 0a 20  ower of 2. The. 
1710: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69   default value i
1720: 73 20 31 30 32 34 2e 20 54 68 65 20 63 6f 6d 70  s 1024. The comp
1730: 69 6c 65 2d 74 69 6d 65 20 64 65 66 61 75 6c 74  ile-time default
1740: 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 64   may be overridd
1750: 65 6e 20 61 74 20 0a 20 20 72 75 6e 74 69 6d 65  en at .  runtime
1760: 20 62 79 20 74 68 65 20 5b 50 52 41 47 4d 41 20   by the [PRAGMA 
1770: 70 61 67 65 5f 73 69 7a 65 5d 20 63 6f 6d 6d 61  page_size] comma
1780: 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  nd..}..COMPILE_O
1790: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45  PTION {SQLITE_DE
17a0: 46 41 55 4c 54 5f 54 45 4d 50 5f 43 41 43 48 45  FAULT_TEMP_CACHE
17b0: 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 70 61 67  _SIZE=<i>&lt;pag
17c0: 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20  es&gt;</i>} {.  
17d0: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
17e0: 74 68 65 20 64 65 66 61 75 6c 74 20 73 69 7a 65  the default size
17f0: 20 6f 66 20 74 68 65 20 70 61 67 65 2d 63 61 63   of the page-cac
1800: 68 65 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79  he for temporary
1810: 20 66 69 6c 65 73 0a 20 20 63 72 65 61 74 65 64   files.  created
1820: 20 62 79 20 53 51 4c 69 74 65 20 74 6f 20 73 74   by SQLite to st
1830: 6f 72 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65  ore intermediate
1840: 20 72 65 73 75 6c 74 73 2c 20 69 6e 20 70 61 67   results, in pag
1850: 65 73 2e 20 49 74 20 64 6f 65 73 0a 20 20 6e 6f  es. It does.  no
1860: 74 20 61 66 66 65 63 74 20 74 68 65 20 70 61 67  t affect the pag
1870: 65 2d 63 61 63 68 65 20 66 6f 72 20 74 68 65 20  e-cache for the 
1880: 74 65 6d 70 20 64 61 74 61 62 61 73 65 2c 20 77  temp database, w
1890: 68 65 72 65 20 74 61 62 6c 65 73 20 63 72 65 61  here tables crea
18a0: 74 65 64 0a 20 20 75 73 69 6e 67 20 5b 43 52 45  ted.  using [CRE
18b0: 41 54 45 20 54 41 42 4c 45 20 7c 20 43 52 45 41  ATE TABLE | CREA
18c0: 54 45 20 54 45 4d 50 20 54 41 42 4c 45 5d 20 61  TE TEMP TABLE] a
18d0: 72 65 20 73 74 6f 72 65 64 2e 20 54 68 65 20 64  re stored. The d
18e0: 65 66 61 75 6c 74 20 76 61 6c 75 65 0a 20 20 69  efault value.  i
18f0: 73 20 35 30 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  s 500..}..COMPIL
1900: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
1910: 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f 41 55 54  _DEFAULT_WAL_AUT
1920: 4f 43 48 45 43 4b 50 4f 49 4e 54 3d 3c 69 3e 26  OCHECKPOINT=<i>&
1930: 6c 74 3b 70 61 67 65 73 26 67 74 3b 3c 2f 69 3e  lt;pages&gt;</i>
1940: 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f  } {.  This macro
1950: 20 73 65 74 73 20 74 68 65 20 64 65 66 61 75 6c   sets the defaul
1960: 74 20 70 61 67 65 20 63 6f 75 6e 74 20 66 6f 72  t page count for
1970: 20 74 68 65 20 5b 57 41 4c 5d 0a 20 20 5b 63 68   the [WAL].  [ch
1980: 65 63 6b 70 6f 69 6e 74 69 6e 67 20 7c 20 61 75  eckpointing | au
1990: 74 6f 6d 61 74 69 63 20 63 68 65 63 6b 70 6f 69  tomatic checkpoi
19a0: 6e 74 69 6e 67 5d 20 66 65 61 74 75 72 65 2e 20  nting] feature. 
19b0: 20 49 66 20 75 6e 73 70 65 63 69 66 69 65 64 2c   If unspecified,
19c0: 0a 20 20 74 68 65 20 64 65 66 61 75 6c 74 20 70  .  the default p
19d0: 61 67 65 20 63 6f 75 6e 74 20 69 73 20 31 30 30  age count is 100
19e0: 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  0..}..COMPILE_OP
19f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
1a00: 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45  AULT_WORKER_THRE
1a10: 41 44 53 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a  ADS=<i>N</i>} {.
1a20: 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74    This macro set
1a30: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61  s the default va
1a40: 6c 75 65 20 66 6f 72 0a 20 20 74 68 65 20 5b 53  lue for.  the [S
1a50: 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b  QLITE_LIMIT_WORK
1a60: 45 52 5f 54 48 52 45 41 44 53 5d 20 70 61 72 61  ER_THREADS] para
1a70: 6d 65 74 65 72 2e 20 20 54 68 65 20 5b 53 51 4c  meter.  The [SQL
1a80: 49 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52  ITE_LIMIT_WORKER
1a90: 5f 54 48 52 45 41 44 53 5d 0a 20 20 70 61 72 61  _THREADS].  para
1aa0: 6d 65 74 65 72 20 73 65 74 73 20 74 68 65 20 6d  meter sets the m
1ab0: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
1ac0: 20 61 75 78 69 6c 69 61 72 79 20 74 68 72 65 61   auxiliary threa
1ad0: 64 73 20 74 68 61 74 20 61 20 73 69 6e 67 6c 65  ds that a single
1ae0: 0a 20 20 5b 70 72 65 70 61 72 65 64 20 73 74 61  .  [prepared sta
1af0: 74 65 6d 65 6e 74 5d 20 77 69 6c 6c 20 6c 61 75  tement] will lau
1b00: 6e 63 68 20 74 6f 20 61 73 73 69 73 74 20 69 74  nch to assist it
1b10: 20 77 69 74 68 20 61 20 71 75 65 72 79 2e 20 20   with a query.  
1b20: 49 66 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64  If not specified
1b30: 2c 0a 20 20 74 68 65 20 64 65 66 61 75 6c 74 20  ,.  the default 
1b40: 6d 61 78 69 6d 75 6d 20 69 73 20 30 2e 0a 20 20  maximum is 0..  
1b50: 54 68 65 20 76 61 6c 75 65 20 73 65 74 20 68 65  The value set he
1b60: 72 65 20 63 61 6e 6e 6f 74 20 62 65 20 6d 6f 72  re cannot be mor
1b70: 65 20 74 68 61 6e 20 5b 53 51 4c 49 54 45 5f 4d  e than [SQLITE_M
1b80: 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44  AX_WORKER_THREAD
1b90: 53 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  S]..}..COMPILE_O
1ba0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 46 54  PTION {SQLITE_FT
1bb0: 53 33 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54  S3_MAX_EXPR_DEPT
1bc0: 48 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20  H=<i>N</i>} {.  
1bd0: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
1be0: 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70 74  the maximum dept
1bf0: 68 20 6f 66 20 74 68 65 20 73 65 61 72 63 68 20  h of the search 
1c00: 74 72 65 65 20 74 68 61 74 20 63 6f 72 72 65 73  tree that corres
1c10: 70 6f 6e 64 73 20 74 6f 0a 20 20 74 68 65 20 72  ponds to.  the r
1c20: 69 67 68 74 2d 68 61 6e 64 20 73 69 64 65 20 6f  ight-hand side o
1c30: 66 20 74 68 65 20 4d 41 54 43 48 20 6f 70 65 72  f the MATCH oper
1c40: 61 74 6f 72 20 69 6e 20 61 6e 20 5b 46 54 53 33  ator in an [FTS3
1c50: 5d 20 6f 72 20 5b 46 54 53 34 5d 20 66 75 6c 6c  ] or [FTS4] full
1c60: 2d 74 65 78 74 0a 20 20 69 6e 64 65 78 2e 20 20  -text.  index.  
1c70: 54 68 65 20 66 75 6c 6c 2d 74 65 78 74 20 73 65  The full-text se
1c80: 61 72 63 68 20 75 73 65 73 20 61 20 72 65 63 75  arch uses a recu
1c90: 72 73 69 76 65 20 61 6c 67 6f 72 69 74 68 6d 2c  rsive algorithm,
1ca0: 20 73 6f 20 74 68 65 20 64 65 70 74 68 20 6f 66   so the depth of
1cb0: 0a 20 20 74 68 65 20 74 72 65 65 20 69 73 20 6c  .  the tree is l
1cc0: 69 6d 69 74 65 64 20 74 6f 20 70 72 65 76 65 6e  imited to preven
1cd0: 74 20 75 73 69 6e 67 20 74 6f 6f 20 6d 75 63 68  t using too much
1ce0: 20 73 74 61 63 6b 20 73 70 61 63 65 2e 20 20 54   stack space.  T
1cf0: 68 65 20 64 65 66 61 75 6c 74 0a 20 20 6c 69 6d  he default.  lim
1d00: 69 74 20 69 73 20 31 32 2e 20 20 54 68 69 73 20  it is 12.  This 
1d10: 6c 69 6d 69 74 20 69 73 20 73 75 66 66 69 63 69  limit is suffici
1d20: 65 6e 74 20 66 6f 72 20 75 70 20 74 6f 20 34 30  ent for up to 40
1d30: 39 35 20 73 65 61 72 63 68 20 74 65 72 6d 73 20  95 search terms 
1d40: 6f 6e 20 74 68 65 0a 20 20 72 69 67 68 74 2d 68  on the.  right-h
1d50: 61 6e 64 20 73 69 64 65 20 6f 66 20 74 68 65 20  and side of the 
1d60: 4d 41 54 43 48 20 6f 70 65 72 61 74 6f 72 20 61  MATCH operator a
1d70: 6e 64 20 69 74 20 68 6f 6c 64 73 20 73 74 61 63  nd it holds stac
1d80: 6b 20 73 70 61 63 65 20 75 73 61 67 65 20 74 6f  k space usage to
1d90: 20 0a 20 20 6c 65 73 73 20 74 68 61 6e 20 32 30   .  less than 20
1da0: 30 30 20 62 79 74 65 73 2e 0a 20 20 3c 70 3e 0a  00 bytes..  <p>.
1db0: 20 20 46 6f 72 20 6f 72 64 69 6e 61 72 79 20 46    For ordinary F
1dc0: 54 53 33 2f 46 54 53 34 20 71 75 65 72 69 65 73  TS3/FTS4 queries
1dd0: 2c 20 74 68 65 20 73 65 61 72 63 68 20 74 72 65  , the search tre
1de0: 65 20 64 65 70 74 68 20 69 73 20 61 70 70 72 6f  e depth is appro
1df0: 78 69 6d 61 74 65 6c 79 0a 20 20 74 68 65 20 62  ximately.  the b
1e00: 61 73 65 2d 32 20 6c 6f 67 61 72 69 74 68 6d 20  ase-2 logarithm 
1e10: 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  of the number of
1e20: 20 74 65 72 6d 73 20 69 6e 20 74 68 65 20 72 69   terms in the ri
1e30: 67 68 74 2d 68 61 6e 64 20 73 69 64 65 20 6f 66  ght-hand side of
1e40: 20 74 68 65 0a 20 20 4d 41 54 43 48 20 6f 70 65   the.  MATCH ope
1e50: 72 61 74 6f 72 2e 20 20 48 6f 77 65 76 65 72 2c  rator.  However,
1e60: 20 66 6f 72 20 5b 70 68 72 61 73 65 20 71 75 65   for [phrase que
1e70: 72 69 65 73 5d 20 61 6e 64 20 5b 4e 45 41 52 20  ries] and [NEAR 
1e80: 71 75 65 72 69 65 73 5d 20 74 68 65 0a 20 20 73  queries] the.  s
1e90: 65 61 72 63 68 20 74 72 65 65 20 64 65 70 74 68  earch tree depth
1ea0: 20 69 73 20 6c 69 6e 65 61 72 20 69 6e 20 74 68   is linear in th
1eb0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 69 67 68  e number of righ
1ec0: 74 2d 68 61 6e 64 20 73 69 64 65 20 74 65 72 6d  t-hand side term
1ed0: 73 2e 0a 20 20 53 6f 20 74 68 65 20 64 65 66 61  s..  So the defa
1ee0: 75 6c 74 20 64 65 70 74 68 20 6c 69 6d 69 74 20  ult depth limit 
1ef0: 6f 66 20 31 32 20 69 73 20 73 75 66 66 69 63 69  of 12 is suffici
1f00: 65 6e 74 20 66 6f 72 20 75 70 20 74 6f 20 34 30  ent for up to 40
1f10: 39 35 20 6f 72 64 69 6e 61 72 79 0a 20 20 74 65  95 ordinary.  te
1f20: 72 6d 73 20 6f 6e 20 61 20 4d 41 54 43 48 2c 20  rms on a MATCH, 
1f30: 69 74 20 69 73 20 6f 6e 6c 79 20 73 75 66 66 69  it is only suffi
1f40: 63 69 65 6e 74 20 66 6f 72 20 31 31 20 6f 72 20  cient for 11 or 
1f50: 31 32 20 70 68 72 61 73 65 20 6f 72 20 4e 45 41  12 phrase or NEA
1f60: 52 0a 20 20 74 65 72 6d 73 2e 20 20 45 76 65 6e  R.  terms.  Even
1f70: 20 73 6f 2c 20 74 68 65 20 64 65 66 61 75 6c 74   so, the default
1f80: 20 69 73 20 6d 6f 72 65 20 74 68 61 6e 20 65 6e   is more than en
1f90: 6f 75 67 68 20 66 6f 72 20 6d 6f 73 74 20 61 70  ough for most ap
1fa0: 70 6c 69 63 61 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f  plication..}..CO
1fb0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
1fc0: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49  LITE_MAX_MMAP_SI
1fd0: 5a 45 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20  ZE=<i>N</i>} {. 
1fe0: 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73   This macro sets
1ff0: 20 61 20 68 61 72 64 20 75 70 70 65 72 20 62 6f   a hard upper bo
2000: 75 6e 64 20 6f 6e 20 74 68 65 20 61 6d 6f 75 6e  und on the amoun
2010: 74 20 6f 66 20 61 64 64 72 65 73 73 20 73 70 61  t of address spa
2020: 63 65 20 74 68 61 74 0a 20 20 63 61 6e 20 62 65  ce that.  can be
2030: 20 75 73 65 64 20 62 79 20 61 6e 79 20 73 69 6e   used by any sin
2040: 67 6c 65 20 64 61 74 61 62 61 73 65 20 66 6f 72  gle database for
2050: 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49   memory-mapped I
2060: 2f 4f 2e 0a 20 20 53 65 74 74 69 6e 67 20 74 68  /O..  Setting th
2070: 69 73 20 76 61 6c 75 65 20 74 6f 20 30 20 63 6f  is value to 0 co
2080: 6d 70 6c 65 74 65 6c 79 20 64 69 73 61 62 6c 65  mpletely disable
2090: 73 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20  s memory-mapped 
20a0: 49 2f 4f 20 61 6e 64 0a 20 20 63 61 75 73 65 73  I/O and.  causes
20b0: 20 6c 6f 67 69 63 20 61 73 73 6f 63 69 61 74 65   logic associate
20c0: 64 20 77 69 74 68 20 6d 65 6d 6f 72 79 2d 6d 61  d with memory-ma
20d0: 70 70 65 64 20 49 2f 4f 20 74 6f 20 62 65 20 6f  pped I/O to be o
20e0: 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 0a  mitted from the.
20f0: 20 20 62 75 69 6c 64 2e 20 20 54 68 69 73 20 6f    build.  This o
2100: 70 74 69 6f 6e 20 64 6f 65 73 20 63 68 61 6e 67  ption does chang
2110: 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 6d 65  e the default me
2120: 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20  mory-mapped I/O 
2130: 61 64 64 72 65 73 73 0a 20 20 73 70 61 63 65 20  address.  space 
2140: 73 69 7a 65 20 28 73 65 74 20 62 79 20 5b 53 51  size (set by [SQ
2150: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41  LITE_DEFAULT_MMA
2160: 50 5f 53 49 5a 45 5d 20 6f 72 0a 20 20 73 71 6c  P_SIZE] or.  sql
2170: 69 74 65 33 5f 63 6f 6e 66 69 67 28 5b 53 51 4c  ite3_config([SQL
2180: 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 4d 41 50 5f  ITE_CONFIG_MMAP_
2190: 53 49 5a 45 5d 29 20 6f 72 20 74 68 65 0a 20 20  SIZE]) or the.  
21a0: 72 75 6e 2d 74 69 6d 65 20 6d 65 6d 6f 72 79 2d  run-time memory-
21b0: 6d 61 70 70 65 64 20 49 2f 4f 20 61 64 64 72 65  mapped I/O addre
21c0: 73 73 20 73 70 61 63 65 20 73 69 7a 65 20 28 73  ss space size (s
21d0: 65 74 20 62 79 0a 20 20 73 71 6c 69 74 65 33 5f  et by.  sqlite3_
21e0: 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c 28 5b 53 51  file_control([SQ
21f0: 4c 49 54 45 5f 46 43 4e 54 4c 5f 4d 4d 41 50 5f  LITE_FCNTL_MMAP_
2200: 53 49 5a 45 5d 29 20 6f 72 0a 20 20 5b 50 52 41  SIZE]) or.  [PRA
2210: 47 4d 41 20 6d 6d 61 70 5f 73 69 7a 65 5d 29 20  GMA mmap_size]) 
2220: 61 73 20 6c 6f 6e 67 20 61 73 20 74 68 6f 73 65  as long as those
2230: 20 6f 74 68 65 72 20 73 65 74 74 69 6e 67 73 20   other settings 
2240: 61 72 65 20 6c 65 73 73 20 74 68 61 6e 20 74 68  are less than th
2250: 65 0a 20 20 6d 61 78 69 6d 75 6d 20 76 61 6c 75  e.  maximum valu
2260: 65 20 64 65 66 69 6e 65 64 20 68 65 72 65 2e 0a  e defined here..
2270: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
2280: 4e 20 7b 53 51 4c 49 54 45 5f 4d 41 58 5f 53 43  N {SQLITE_MAX_SC
2290: 48 45 4d 41 5f 52 45 54 52 59 3d 3c 69 3e 4e 3c  HEMA_RETRY=<i>N<
22a0: 2f 69 3e 7d 20 7b 0a 20 20 57 68 65 6e 65 76 65  /i>} {.  Wheneve
22b0: 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73  r the database s
22c0: 63 68 65 6d 61 20 63 68 61 6e 67 65 73 2c 20 70  chema changes, p
22d0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
22e0: 74 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63  ts are automatic
22f0: 61 6c 6c 79 0a 20 20 72 65 70 72 65 70 61 72 65  ally.  reprepare
2300: 64 20 74 6f 20 61 63 63 6f 6d 6d 6f 64 61 74 65  d to accommodate
2310: 20 74 68 65 20 6e 65 77 20 73 63 68 65 6d 61 2e   the new schema.
2320: 20 20 54 68 65 72 65 20 69 73 20 61 20 72 61 63    There is a rac
2330: 65 20 63 6f 6e 64 69 74 69 6f 6e 20 68 65 72 65  e condition here
2340: 0a 20 20 69 6e 20 74 68 61 74 20 69 66 20 6f 6e  .  in that if on
2350: 65 20 74 68 72 65 61 64 20 69 73 20 63 6f 6e 73  e thread is cons
2360: 74 61 6e 74 6c 79 20 63 68 61 6e 67 69 6e 67 20  tantly changing 
2370: 74 68 65 20 73 63 68 65 6d 61 2c 20 61 6e 6f 74  the schema, anot
2380: 68 65 72 20 74 68 72 65 61 64 0a 20 20 6d 69 67  her thread.  mig
2390: 68 74 20 73 70 69 6e 20 6f 6e 20 72 65 70 61 72  ht spin on repar
23a0: 73 65 73 20 61 6e 64 20 72 65 70 72 65 70 61 72  ses and reprepar
23b0: 61 74 69 6f 6e 73 20 6f 66 20 61 20 70 72 65 70  ations of a prep
23c0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61  ared statement a
23d0: 6e 64 0a 20 20 6e 65 76 65 72 20 67 65 74 20 61  nd.  never get a
23e0: 6e 79 20 72 65 61 6c 20 77 6f 72 6b 20 64 6f 6e  ny real work don
23f0: 65 2e 20 20 54 68 69 73 20 70 61 72 61 6d 65 74  e.  This paramet
2400: 65 72 20 70 72 65 76 65 6e 74 73 20 61 6e 20 69  er prevents an i
2410: 6e 66 69 6e 69 74 65 20 6c 6f 6f 70 0a 20 20 62  nfinite loop.  b
2420: 79 20 66 6f 72 63 69 6e 67 20 74 68 65 20 73 70  y forcing the sp
2430: 69 6e 6e 69 6e 67 20 74 68 72 65 61 64 20 74 6f  inning thread to
2440: 20 67 69 76 65 20 75 70 20 61 66 74 65 72 20 61   give up after a
2450: 20 66 69 78 65 64 20 6e 75 6d 62 65 72 20 6f 66   fixed number of
2460: 20 61 74 74 65 6d 70 74 73 0a 20 20 61 74 20 72   attempts.  at r
2470: 65 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 70  ecompiling the p
2480: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
2490: 74 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20  t.  The default 
24a0: 73 65 74 74 69 6e 67 20 69 73 20 35 30 20 77 68  setting is 50 wh
24b0: 69 63 68 20 69 73 0a 20 20 6d 6f 72 65 20 74 68  ich is.  more th
24c0: 61 6e 20 61 64 65 71 75 61 74 65 20 66 6f 72 20  an adequate for 
24d0: 6d 6f 73 74 20 61 70 70 6c 69 63 61 74 69 6f 6e  most application
24e0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
24f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 41 58  TION {SQLITE_MAX
2500: 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3d  _WORKER_THREADS=
2510: 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 53 65  <i>N</i>} {.  Se
2520: 74 20 61 6e 20 75 70 70 65 72 20 62 6f 75 6e 64  t an upper bound
2530: 20 6f 6e 20 74 68 65 20 5b 73 71 6c 69 74 65 33   on the [sqlite3
2540: 5f 6c 69 6d 69 74 5d 28 64 62 2c 5b 53 51 4c 49  _limit](db,[SQLI
2550: 54 45 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f  TE_LIMIT_WORKER_
2560: 54 48 52 45 41 44 53 5d 2c 4e 29 0a 20 20 73 65  THREADS],N).  se
2570: 74 74 69 6e 67 20 74 68 61 74 20 64 65 74 65 72  tting that deter
2580: 6d 69 6e 65 73 20 74 68 65 20 6d 61 78 69 6d 75  mines the maximu
2590: 6d 20 6e 75 6d 62 65 72 20 6f 66 20 61 75 78 69  m number of auxi
25a0: 6c 69 61 72 79 20 74 68 72 65 61 64 73 20 74 68  liary threads th
25b0: 61 74 20 61 20 73 69 6e 67 6c 65 0a 20 20 5b 70  at a single.  [p
25c0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
25d0: 74 5d 20 77 69 6c 6c 20 75 73 65 20 74 6f 20 61  t] will use to a
25e0: 69 64 20 77 69 74 68 20 43 50 55 2d 69 6e 74 65  id with CPU-inte
25f0: 6e 73 69 76 65 20 63 6f 6d 70 75 74 61 74 69 6f  nsive computatio
2600: 6e 73 0a 20 20 28 6d 6f 73 74 6c 79 20 73 6f 72  ns.  (mostly sor
2610: 74 69 6e 67 29 2e 20 20 53 65 65 20 61 6c 73 6f  ting).  See also
2620: 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 44 45 46   the [SQLITE_DEF
2630: 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45  AULT_WORKER_THRE
2640: 41 44 53 5d 20 6f 70 74 69 6f 6e 73 2e 0a 7d 0a  ADS] options..}.
2650: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
2660: 7b 53 51 4c 49 54 45 5f 4d 49 4e 49 4d 55 4d 5f  {SQLITE_MINIMUM_
2670: 46 49 4c 45 5f 44 45 53 43 52 49 50 54 4f 52 3d  FILE_DESCRIPTOR=
2680: 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  <i>N</i>} {.  Th
2690: 65 20 75 6e 69 78 20 5b 56 46 53 5d 20 77 69 6c  e unix [VFS] wil
26a0: 6c 20 6e 65 76 65 72 20 75 73 65 20 61 20 66 69  l never use a fi
26b0: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 6c 65  le descriptor le
26c0: 73 73 20 74 68 61 6e 20 3c 69 3e 4e 3c 2f 69 3e  ss than <i>N</i>
26d0: 2e 20 20 54 68 65 0a 20 20 64 65 66 61 75 6c 74  .  The.  default
26e0: 20 76 61 6c 75 65 20 6f 66 20 3c 69 3e 4e 3c 2f   value of <i>N</
26f0: 69 3e 20 69 73 20 33 2e 0a 20 20 3c 70 3e 0a 20  i> is 3..  <p>. 
2700: 20 41 76 6f 69 64 69 6e 67 20 74 68 65 20 75 73   Avoiding the us
2710: 65 20 6f 66 20 6c 6f 77 2d 6e 75 6d 62 65 72 65  e of low-numbere
2720: 64 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  d file descripto
2730: 72 73 20 69 73 20 61 20 64 65 66 65 6e 73 65 20  rs is a defense 
2740: 61 67 61 69 6e 73 74 0a 20 20 61 63 63 69 64 65  against.  accide
2750: 6e 74 61 6c 20 64 61 74 61 62 61 73 65 20 63 6f  ntal database co
2760: 72 72 75 70 74 69 6f 6e 2e 20 20 49 66 20 61 20  rruption.  If a 
2770: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 61  database file wa
2780: 73 20 6f 70 65 6e 65 64 20 75 73 69 6e 67 0a 20  s opened using. 
2790: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
27a0: 20 32 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c   2, for example,
27b0: 20 61 6e 64 20 74 68 65 6e 20 61 6e 20 61 73 73   and then an ass
27c0: 65 72 74 28 29 20 66 61 69 6c 65 64 20 61 6e 64  ert() failed and
27d0: 20 69 6e 76 6f 6b 65 64 0a 20 20 77 72 69 74 65   invoked.  write
27e0: 28 32 2c 2e 2e 2e 29 2c 20 74 68 61 74 20 77 6f  (2,...), that wo
27f0: 75 6c 64 20 6c 69 6b 65 6c 79 20 63 61 75 73 65  uld likely cause
2800: 20 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 70   database corrup
2810: 74 69 6f 6e 20 62 79 20 6f 76 65 72 77 72 69 74  tion by overwrit
2820: 69 6e 67 0a 20 20 70 61 72 74 20 6f 66 20 74 68  ing.  part of th
2830: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
2840: 77 69 74 68 20 74 68 65 20 61 73 73 65 72 74 69  with the asserti
2850: 6f 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  on error message
2860: 2e 20 20 55 73 69 6e 67 20 6f 6e 6c 79 0a 20 20  .  Using only.  
2870: 68 69 67 68 65 72 2d 76 61 6c 75 65 64 20 66 69  higher-valued fi
2880: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 61  le descriptors a
2890: 76 6f 69 64 73 20 74 68 69 73 20 70 6f 74 65 6e  voids this poten
28a0: 74 69 61 6c 20 70 72 6f 62 6c 65 6d 2e 20 20 54  tial problem.  T
28b0: 68 65 20 0a 20 20 70 72 6f 74 65 63 74 69 6f 6e  he .  protection
28c0: 20 61 67 61 69 6e 73 74 0a 20 20 75 73 69 6e 67   against.  using
28d0: 20 6c 6f 77 2d 6e 75 6d 62 65 72 65 64 20 66 69   low-numbered fi
28e0: 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 63  le descriptors c
28f0: 61 6e 20 62 65 20 64 69 73 61 62 6c 65 64 20 62  an be disabled b
2900: 79 20 73 65 74 74 69 6e 67 20 74 68 69 73 0a 20  y setting this. 
2910: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
2920: 74 69 6f 6e 20 74 6f 20 30 2e 0a 7d 0a 0a 43 4f  tion to 0..}..CO
2930: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
2940: 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f  LITE_POWERSAFE_O
2950: 56 45 52 57 52 49 54 45 3d 3c 69 3e 26 6c 74 3b  VERWRITE=<i>&lt;
2960: 30 20 6f 72 20 31 26 67 74 3b 3c 2f 69 3e 7d 20  0 or 1&gt;</i>} 
2970: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
2980: 63 68 61 6e 67 65 73 20 74 68 65 20 64 65 66 61  changes the defa
2990: 75 6c 74 20 61 73 73 75 6d 70 74 69 6f 6e 20 61  ult assumption a
29a0: 62 6f 75 74 20 5b 70 6f 77 65 72 73 61 66 65 20  bout [powersafe 
29b0: 6f 76 65 72 77 72 69 74 65 5d 0a 20 20 66 6f 72  overwrite].  for
29c0: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20   the underlying 
29d0: 66 69 6c 65 73 79 73 74 65 6d 73 20 66 6f 72 20  filesystems for 
29e0: 74 68 65 20 75 6e 69 78 20 61 6e 64 20 77 69 6e  the unix and win
29f0: 64 6f 77 73 20 5b 56 46 53 65 73 5d 2e 0a 20 20  dows [VFSes]..  
2a00: 53 65 74 74 69 6e 67 20 53 51 4c 49 54 45 5f 50  Setting SQLITE_P
2a10: 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49  OWERSAFE_OVERWRI
2a20: 54 45 20 74 6f 20 31 20 63 61 75 73 65 73 20 53  TE to 1 causes S
2a30: 51 4c 69 74 65 20 74 6f 20 61 73 73 75 6d 65 20  QLite to assume 
2a40: 74 68 61 74 0a 20 20 61 70 70 6c 69 63 61 74 69  that.  applicati
2a50: 6f 6e 2d 6c 65 76 65 6c 20 77 72 69 74 65 73 20  on-level writes 
2a60: 63 61 6e 6e 6f 74 20 63 68 61 6e 67 65 73 20 62  cannot changes b
2a70: 79 74 65 73 20 6f 75 74 73 69 64 65 20 74 68 65  ytes outside the
2a80: 20 72 61 6e 67 65 20 6f 66 0a 20 20 62 79 74 65   range of.  byte
2a90: 73 20 77 72 69 74 74 65 6e 20 65 76 65 6e 20 69  s written even i
2aa0: 66 20 74 68 65 20 77 72 69 74 65 20 6f 63 63 75  f the write occu
2ab0: 72 73 20 6a 75 73 74 20 62 65 66 6f 72 65 20 61  rs just before a
2ac0: 20 70 6f 77 65 72 20 6c 6f 73 73 2e 0a 20 20 57   power loss..  W
2ad0: 69 74 68 20 53 51 4c 49 54 45 5f 50 4f 57 45 52  ith SQLITE_POWER
2ae0: 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 20 73  SAFE_OVERWRITE s
2af0: 65 74 20 74 6f 20 30 2c 20 53 51 4c 69 74 65 20  et to 0, SQLite 
2b00: 61 73 73 75 6d 65 73 20 74 68 61 74 20 6f 74 68  assumes that oth
2b10: 65 72 0a 20 20 62 79 74 65 73 20 69 6e 20 74 68  er.  bytes in th
2b20: 65 20 73 61 6d 65 20 73 65 63 74 6f 72 20 77 69  e same sector wi
2b30: 74 68 20 61 20 77 72 69 74 74 65 6e 20 62 79 74  th a written byt
2b40: 65 20 6d 69 67 68 74 20 62 65 20 63 68 61 6e 67  e might be chang
2b50: 65 64 20 6f 72 20 0a 20 20 64 61 6d 61 67 65 64  ed or .  damaged
2b60: 20 62 79 20 61 20 70 6f 77 65 72 20 6c 6f 73 73   by a power loss
2b70: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
2b80: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 52 45 56 45  ION {SQLITE_REVE
2b90: 52 53 45 5f 55 4e 4f 52 44 45 52 45 44 5f 53 45  RSE_UNORDERED_SE
2ba0: 4c 45 43 54 53 7d 20 7b 0a 20 20 54 68 69 73 20  LECTS} {.  This 
2bb0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68  option causes th
2bc0: 65 20 5b 50 52 41 47 4d 41 20 72 65 76 65 72 73  e [PRAGMA revers
2bd0: 65 5f 75 6e 6f 72 64 65 72 65 64 5f 73 65 6c 65  e_unordered_sele
2be0: 63 74 73 5d 20 73 65 74 74 69 6e 67 20 74 6f 20  cts] setting to 
2bf0: 62 65 0a 20 20 65 6e 61 62 6c 65 64 20 62 79 20  be.  enabled by 
2c00: 64 65 66 61 75 6c 74 2e 20 20 57 68 65 6e 20 65  default.  When e
2c10: 6e 61 62 6c 65 64 2c 20 5b 53 45 4c 45 43 54 5d  nabled, [SELECT]
2c20: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
2c30: 20 6c 61 63 6b 20 61 6e 0a 20 20 4f 52 44 45 52   lack an.  ORDER
2c40: 20 42 59 20 63 6c 61 75 73 65 20 77 69 6c 6c 20   BY clause will 
2c50: 72 75 6e 20 69 6e 20 72 65 76 65 72 73 65 20 6f  run in reverse o
2c60: 72 64 65 72 2e 3c 70 3e 0a 20 20 54 68 69 73 20  rder.<p>.  This 
2c70: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 66 75 6c  option is useful
2c80: 20 66 6f 72 20 64 65 74 65 63 74 69 6e 67 20 77   for detecting w
2c90: 68 65 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  hen applications
2ca0: 20 28 69 6e 63 6f 72 72 65 63 74 6c 79 29 0a 20   (incorrectly). 
2cb0: 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 68 65   assume that the
2cc0: 20 6f 72 64 65 72 20 6f 66 20 72 6f 77 73 20 69   order of rows i
2cd0: 6e 20 61 20 53 45 4c 45 43 54 20 77 69 74 68 6f  n a SELECT witho
2ce0: 75 74 20 61 6e 20 4f 52 44 45 52 20 42 59 20 63  ut an ORDER BY c
2cf0: 6c 61 75 73 65 0a 20 20 77 69 6c 6c 20 61 6c 77  lause.  will alw
2d00: 61 79 73 20 62 65 20 74 68 65 20 73 61 6d 65 2e  ays be the same.
2d10: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
2d20: 4f 4e 20 7b 53 51 4c 49 54 45 5f 53 4f 52 54 45  ON {SQLITE_SORTE
2d30: 52 5f 50 4d 41 53 5a 3d 3c 69 3e 4e 3c 2f 69 3e  R_PMASZ=<i>N</i>
2d40: 7d 20 7b 0a 20 20 49 66 20 6d 75 6c 74 69 2d 74  } {.  If multi-t
2d50: 68 72 65 61 64 65 64 20 70 72 6f 63 65 73 73 69  hreaded processi
2d60: 6e 67 20 69 73 20 65 6e 61 62 6c 65 64 20 76 69  ng is enabled vi
2d70: 61 20 74 68 65 0a 20 20 5b 50 52 41 47 4d 41 20  a the.  [PRAGMA 
2d80: 74 68 72 65 61 64 73 5d 20 73 65 74 74 69 6e 67  threads] setting
2d90: 2c 20 74 68 65 6e 20 73 6f 72 74 20 6f 70 65 72  , then sort oper
2da0: 61 74 69 6f 6e 73 20 77 69 6c 6c 0a 20 20 61 74  ations will.  at
2db0: 74 65 6d 70 74 20 74 6f 20 73 74 61 72 74 20 68  tempt to start h
2dc0: 65 6c 70 65 72 20 74 68 72 65 61 64 73 20 77 68  elper threads wh
2dd0: 65 6e 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66  en the amount of
2de0: 20 63 6f 6e 74 65 6e 74 0a 20 20 74 6f 20 62 65   content.  to be
2df0: 20 73 6f 72 74 65 64 20 65 78 63 65 65 64 73 20   sorted exceeds 
2e00: 74 68 65 20 6d 69 6e 69 6d 75 6d 20 6f 66 20 74  the minimum of t
2e10: 68 65 20 5b 63 61 63 68 65 5f 73 69 7a 65 5d 20  he [cache_size] 
2e20: 61 6e 64 20 74 68 69 73 20 73 65 74 74 69 6e 67  and this setting
2e30: 0a 20 20 74 69 6d 65 73 20 74 68 65 20 70 61 67  .  times the pag
2e40: 65 20 73 69 7a 65 2e 20 20 54 68 65 20 64 65 66  e size.  The def
2e50: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 32 35  ault value is 25
2e60: 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  0..}..COMPILE_OP
2e70: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 57 49 4e  TION {SQLITE_WIN
2e80: 33 32 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20 20 54  32_MALLOC} {.  T
2e90: 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c  his option enabl
2ea0: 65 73 20 74 68 65 20 75 73 65 20 6f 66 20 74 68  es the use of th
2eb0: 65 20 57 69 6e 64 6f 77 73 20 48 65 61 70 20 41  e Windows Heap A
2ec0: 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72  PI functions for
2ed0: 20 6d 65 6d 6f 72 79 0a 20 20 61 6c 6c 6f 63 61   memory.  alloca
2ee0: 74 69 6f 6e 20 69 6e 73 74 65 61 64 20 6f 66 20  tion instead of 
2ef0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 6c 69 62  the standard lib
2f00: 72 61 72 79 20 6d 61 6c 6c 6f 63 28 29 20 61 6e  rary malloc() an
2f10: 64 20 66 72 65 65 28 29 20 72 6f 75 74 69 6e 65  d free() routine
2f20: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
2f30: 54 49 4f 4e 20 7b 59 59 53 54 41 43 4b 44 45 50  TION {YYSTACKDEP
2f40: 54 48 3d 3c 69 3e 26 6c 74 3b 6d 61 78 5f 64 65  TH=<i>&lt;max_de
2f50: 70 74 68 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20  pth&gt;</i>} {. 
2f60: 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73   This macro sets
2f70: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70   the maximum dep
2f80: 74 68 20 6f 66 20 74 68 65 20 4c 41 4c 52 28 31  th of the LALR(1
2f90: 29 20 73 74 61 63 6b 20 75 73 65 64 20 62 79 0a  ) stack used by.
2fa0: 20 20 74 68 65 20 53 51 4c 20 70 61 72 73 65 72    the SQL parser
2fb0: 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 2e 20   within SQLite. 
2fc0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   The default val
2fd0: 75 65 20 69 73 20 31 30 30 2e 20 20 41 20 74 79  ue is 100.  A ty
2fe0: 70 69 63 61 6c 0a 20 20 61 70 70 6c 69 63 61 74  pical.  applicat
2ff0: 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20 6c 65 73  ion will use les
3000: 73 20 74 68 61 6e 20 61 62 6f 75 74 20 32 30 20  s than about 20 
3010: 6c 65 76 65 6c 73 20 6f 66 20 74 68 65 20 73 74  levels of the st
3020: 61 63 6b 2e 0a 20 20 44 65 76 65 6c 6f 70 65 72  ack..  Developer
3030: 73 20 77 68 6f 73 65 20 61 70 70 6c 69 63 61 74  s whose applicat
3040: 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 20 53 51 4c  ions contain SQL
3050: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
3060: 20 0a 20 20 6e 65 65 64 20 6d 6f 72 65 20 74 68   .  need more th
3070: 61 6e 20 31 30 30 20 4c 41 4c 52 28 31 29 20 73  an 100 LALR(1) s
3080: 74 61 63 6b 20 65 6e 74 72 69 65 73 20 73 68 6f  tack entries sho
3090: 75 6c 64 20 73 65 72 69 6f 75 73 6c 79 0a 20 20  uld seriously.  
30a0: 63 6f 6e 73 69 64 65 72 20 72 65 66 61 63 74 6f  consider refacto
30b0: 72 69 6e 67 20 74 68 65 69 72 20 53 51 4c 20 61  ring their SQL a
30c0: 73 20 69 74 20 69 73 20 6c 69 6b 65 6c 79 20 74  s it is likely t
30d0: 6f 20 62 65 20 77 65 6c 6c 20 62 65 79 6f 6e 64  o be well beyond
30e0: 0a 20 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f  .  the ability o
30f0: 66 20 61 6e 79 20 68 75 6d 61 6e 20 74 6f 20 63  f any human to c
3100: 6f 6d 70 72 65 68 65 6e 64 2e 0a 7d 0a 3c 2f 74  omprehend..}.</t
3110: 63 6c 3e 0a 0a 3c 68 32 3e 31 2e 32 20 4f 70 74  cl>..<h2>1.2 Opt
3120: 69 6f 6e 73 20 54 6f 20 53 65 74 20 53 69 7a 65  ions To Set Size
3130: 20 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a 0a 3c 70   Limits</h2>..<p
3140: 3e 54 68 65 72 65 20 61 72 65 20 63 6f 6d 70 69  >There are compi
3150: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le-time options 
3160: 74 68 61 74 20 77 69 6c 6c 20 73 65 74 20 75 70  that will set up
3170: 70 65 72 20 62 6f 75 6e 64 73 0a 6f 6e 20 74 68  per bounds.on th
3180: 65 20 73 69 7a 65 73 20 6f 66 20 76 61 72 69 6f  e sizes of vario
3190: 75 73 20 73 74 72 75 63 74 75 72 65 73 20 69 6e  us structures in
31a0: 20 53 51 4c 69 74 65 2e 20 20 54 68 65 20 63 6f   SQLite.  The co
31b0: 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f  mpile-time.optio
31c0: 6e 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65 74 20  ns normally set 
31d0: 61 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75  a hard upper bou
31e0: 6e 64 20 74 68 61 74 20 63 61 6e 20 62 65 20 63  nd that can be c
31f0: 68 61 6e 67 65 64 0a 61 74 20 72 75 6e 2d 74 69  hanged.at run-ti
3200: 6d 65 20 6f 6e 20 69 6e 64 69 76 69 64 75 61 6c  me on individual
3210: 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65   [database conne
3220: 63 74 69 6f 6e 73 5d 20 75 73 69 6e 67 20 74 68  ctions] using th
3230: 65 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74  e.[sqlite3_limit
3240: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 3c 2f  ()] interface.</
3250: 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d 70 69  p>..<p>The compi
3260: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le-time options 
3270: 66 6f 72 20 73 65 74 74 69 6e 67 20 75 70 70 65  for setting uppe
3280: 72 20 62 6f 75 6e 64 73 20 61 72 65 0a 5b 6c 69  r bounds are.[li
3290: 6d 69 74 73 20 7c 20 64 6f 63 75 6d 65 6e 74 65  mits | documente
32a0: 64 20 73 65 70 61 72 61 74 65 6c 79 5d 2e 20 20  d separately].  
32b0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73  The following is
32c0: 20 61 20 6c 69 73 74 20 6f 66 0a 74 68 65 20 61   a list of.the a
32d0: 76 61 69 6c 61 62 6c 65 20 73 65 74 74 69 6e 67  vailable setting
32e0: 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69  s:</p>..<ul>.<li
32f0: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54  > [SQLITE_MAX_AT
3300: 54 41 43 48 45 44 5d 20 20 3c 2f 6c 69 3e 0a 3c  TACHED]  </li>.<
3310: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f  li> [SQLITE_MAX_
3320: 43 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69 3e 0a 3c  COLUMN]  </li>.<
3330: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f  li> [SQLITE_MAX_
3340: 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 5d  COMPOUND_SELECT]
3350: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51    </li>.<li> [SQ
3360: 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45  LITE_MAX_EXPR_DE
3370: 50 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e  PTH]  </li>.<li>
3380: 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55 4e   [SQLITE_MAX_FUN
3390: 43 54 49 4f 4e 5f 41 52 47 5d 20 20 3c 2f 6c 69  CTION_ARG]  </li
33a0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
33b0: 41 58 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69  AX_LENGTH]  </li
33c0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
33d0: 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e 5f  AX_LIKE_PATTERN_
33e0: 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c  LENGTH]  </li>.<
33f0: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f  li> [SQLITE_MAX_
3400: 50 41 47 45 5f 43 4f 55 4e 54 5d 20 20 3c 2f 6c  PAGE_COUNT]  </l
3410: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
3420: 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d 20  MAX_SQL_LENGTH] 
3430: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c   </li>.<li> [SQL
3440: 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45  ITE_MAX_VARIABLE
3450: 5f 4e 55 4d 42 45 52 5d 20 20 3c 2f 6c 69 3e 0a  _NUMBER]  </li>.
3460: 3c 2f 75 6c 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22  </ul>..<a name="
3470: 63 6f 6e 74 72 6f 6c 66 65 61 74 75 72 65 73 22  controlfeatures"
3480: 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 33 20 4f 70  ></a>.<h2>1.3 Op
3490: 74 69 6f 6e 73 20 54 6f 20 43 6f 6e 74 72 6f 6c  tions To Control
34a0: 20 4f 70 65 72 61 74 69 6e 67 20 43 68 61 72 61   Operating Chara
34b0: 63 74 65 72 69 73 74 69 63 73 3c 2f 68 32 3e 0a  cteristics</h2>.
34c0: 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f  .<tcl>.COMPILE_O
34d0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 34 5f  PTION {SQLITE_4_
34e0: 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c  BYTE_ALIGNED_MAL
34f0: 4c 4f 43 7d 20 7b 0a 20 20 4f 6e 20 6d 6f 73 74  LOC} {.  On most
3500: 20 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 61   systems, the ma
3510: 6c 6c 6f 63 28 29 20 73 79 73 74 65 6d 20 63 61  lloc() system ca
3520: 6c 6c 20 72 65 74 75 72 6e 73 20 61 20 62 75 66  ll returns a buf
3530: 66 65 72 20 74 68 61 74 20 69 73 0a 20 20 61 6c  fer that is.  al
3540: 69 67 6e 65 64 20 74 6f 20 61 6e 20 38 2d 62 79  igned to an 8-by
3550: 74 65 20 62 6f 75 6e 64 61 72 79 2e 20 20 42 75  te boundary.  Bu
3560: 74 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 65 6d  t on some system
3570: 73 20 28 65 78 3a 20 77 69 6e 64 6f 77 73 29 20  s (ex: windows) 
3580: 6d 61 6c 6c 6f 63 28 29 0a 20 20 72 65 74 75 72  malloc().  retur
3590: 6e 73 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65  ns 4-byte aligne
35a0: 64 20 70 6f 69 6e 74 65 72 2e 20 20 54 68 69 73  d pointer.  This
35b0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
35c0: 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 75 73 65  tion must be use
35d0: 64 0a 20 20 6f 6e 20 73 79 73 74 65 6d 73 20 74  d.  on systems t
35e0: 68 61 74 20 72 65 74 75 72 6e 20 34 2d 62 79 74  hat return 4-byt
35f0: 65 20 61 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65  e aligned pointe
3600: 72 73 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28 29  rs from malloc()
3610: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
3620: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 43 41 53 45  ION {SQLITE_CASE
3630: 5f 53 45 4e 53 49 54 49 56 45 5f 4c 49 4b 45 7d  _SENSITIVE_LIKE}
3640: 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74   {.  If this opt
3650: 69 6f 6e 20 69 73 20 70 72 65 73 65 6e 74 2c 20  ion is present, 
3660: 74 68 65 6e 20 74 68 65 20 62 75 69 6c 74 2d 69  then the built-i
3670: 6e 20 5b 4c 49 4b 45 5d 20 6f 70 65 72 61 74 6f  n [LIKE] operato
3680: 72 20 77 69 6c 6c 20 62 65 0a 20 20 63 61 73 65  r will be.  case
3690: 20 73 65 6e 73 69 74 69 76 65 2e 20 20 54 68 69   sensitive.  Thi
36a0: 73 20 73 61 6d 65 20 65 66 66 65 63 74 20 63 61  s same effect ca
36b0: 6e 20 62 65 20 61 63 68 69 65 76 65 64 20 61 74  n be achieved at
36c0: 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 0a   run-time using.
36d0: 20 20 74 68 65 20 5b 63 61 73 65 5f 73 65 6e 73    the [case_sens
36e0: 69 74 69 76 65 5f 6c 69 6b 65 20 70 72 61 67 6d  itive_like pragm
36f0: 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  a]..}..COMPILE_O
3700: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49  PTION {SQLITE_DI
3710: 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45  RECT_OVERFLOW_RE
3720: 41 44 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69  AD} {.  When thi
3730: 73 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73  s option is pres
3740: 65 6e 74 2c 20 63 6f 6e 74 65 6e 74 20 63 6f 6e  ent, content con
3750: 74 61 69 6e 65 64 20 69 6e 0a 20 20 5b 6f 76 65  tained in.  [ove
3760: 72 66 6c 6f 77 20 70 61 67 65 73 5d 20 6f 66 20  rflow pages] of 
3770: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
3780: 65 20 69 73 20 72 65 61 64 20 64 69 72 65 63 74  e is read direct
3790: 6c 79 20 66 72 6f 6d 20 64 69 73 6b 2c 0a 20 20  ly from disk,.  
37a0: 62 79 70 61 73 73 69 6e 67 20 74 68 65 20 5b 70  bypassing the [p
37b0: 61 67 65 20 63 61 63 68 65 5d 2c 20 64 75 72 69  age cache], duri
37c0: 6e 67 20 72 65 61 64 20 74 72 61 6e 73 61 63 74  ng read transact
37d0: 69 6f 6e 73 2e 20 20 49 6e 20 61 70 70 6c 69 63  ions.  In applic
37e0: 61 74 69 6f 6e 73 0a 20 20 74 68 61 74 20 64 6f  ations.  that do
37f0: 20 61 20 6c 6f 74 20 6f 66 20 72 65 61 64 73 20   a lot of reads 
3800: 6f 66 20 6c 61 72 67 65 20 42 4c 4f 42 73 2c 20  of large BLOBs, 
3810: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 69 67 68  this option migh
3820: 74 20 69 6d 70 72 6f 76 65 20 72 65 61 64 0a 20  t improve read. 
3830: 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 7d 0a   performance..}.
3840: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
3850: 7b 53 51 4c 49 54 45 5f 48 41 56 45 5f 49 53 4e  {SQLITE_HAVE_ISN
3860: 41 4e 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  AN} {.  If this 
3870: 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e  option is presen
3880: 74 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 77  t, then SQLite w
3890: 69 6c 6c 20 75 73 65 20 74 68 65 20 69 73 6e 61  ill use the isna
38a0: 6e 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f  n() function fro
38b0: 6d 0a 20 20 74 68 65 20 73 79 73 74 65 6d 20 6d  m.  the system m
38c0: 61 74 68 20 6c 69 62 72 61 72 79 2e 20 20 57 69  ath library.  Wi
38d0: 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6f  thout this optio
38e0: 6e 20 28 74 68 65 20 64 65 66 61 75 6c 74 20 62  n (the default b
38f0: 65 68 61 76 69 6f 72 29 0a 20 20 53 51 4c 69 74  ehavior).  SQLit
3900: 65 20 75 73 65 73 20 69 74 73 20 6f 77 6e 20 69  e uses its own i
3910: 6e 74 65 72 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e  nternal implemen
3920: 74 61 74 69 6f 6e 20 6f 66 20 69 73 6e 61 6e 28  tation of isnan(
3930: 29 2e 20 20 53 51 4c 69 74 65 20 75 73 65 73 0a  ).  SQLite uses.
3940: 20 20 69 74 73 20 6f 77 6e 20 69 6e 74 65 72 6e    its own intern
3950: 61 6c 20 69 73 6e 61 6e 28 29 20 69 6d 70 6c 65  al isnan() imple
3960: 6d 65 6e 74 61 74 69 6f 6e 20 62 79 20 64 65 66  mentation by def
3970: 61 75 6c 74 20 62 65 63 61 75 73 65 20 6f 66 20  ault because of 
3980: 70 61 73 74 0a 20 20 70 72 6f 62 6c 65 6d 73 20  past.  problems 
3990: 77 69 74 68 20 73 79 73 74 65 6d 20 69 73 6e 61  with system isna
39a0: 6e 28 29 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 7d  n() functions..}
39b0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
39c0: 20 7b 53 51 4c 49 54 45 5f 4f 53 5f 4f 54 48 45   {SQLITE_OS_OTHE
39d0: 52 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 26  R=<i>&lt;0 or 1&
39e0: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 65  gt;</i>} {.  The
39f0: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53   option causes S
3a00: 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 69 74  QLite to omit it
3a10: 73 20 62 75 69 6c 74 2d 69 6e 20 6f 70 65 72 61  s built-in opera
3a20: 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65  ting system inte
3a30: 72 66 61 63 65 73 0a 20 20 66 6f 72 20 55 6e 69  rfaces.  for Uni
3a40: 78 2c 20 57 69 6e 64 6f 77 73 2c 20 61 6e 64 20  x, Windows, and 
3a50: 4f 53 2f 32 2e 20 20 54 68 65 20 72 65 73 75 6c  OS/2.  The resul
3a60: 74 69 6e 67 20 6c 69 62 72 61 72 79 20 77 69 6c  ting library wil
3a70: 6c 20 68 61 76 65 20 6e 6f 20 64 65 66 61 75 6c  l have no defaul
3a80: 74 0a 20 20 5b 73 71 6c 69 74 65 33 5f 76 66 73  t.  [sqlite3_vfs
3a90: 20 7c 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73   | operating sys
3aa0: 74 65 6d 20 69 6e 74 65 72 66 61 63 65 5d 2e 20  tem interface]. 
3ab0: 20 41 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75   Applications mu
3ac0: 73 74 20 75 73 65 0a 20 20 5b 73 71 6c 69 74 65  st use.  [sqlite
3ad0: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29  3_vfs_register()
3ae0: 5d 20 74 6f 20 72 65 67 69 73 74 65 72 20 61 6e  ] to register an
3af0: 20 61 70 70 72 6f 70 72 69 61 74 65 20 69 6e 74   appropriate int
3b00: 65 72 66 61 63 65 20 62 65 66 6f 72 65 0a 20 20  erface before.  
3b10: 75 73 69 6e 67 20 53 51 4c 69 74 65 2e 20 20 41  using SQLite.  A
3b20: 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75 73 74  pplications must
3b30: 20 61 6c 73 6f 20 73 75 70 70 6c 79 20 69 6d 70   also supply imp
3b40: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 66 6f 72  lementations for
3b50: 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f   the.  [sqlite3_
3b60: 6f 73 5f 69 6e 69 74 28 29 5d 20 61 6e 64 20 5b  os_init()] and [
3b70: 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 28 29  sqlite3_os_end()
3b80: 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 20 20 54  ] interfaces.  T
3b90: 68 65 20 75 73 75 61 6c 20 70 72 61 63 74 69 63  he usual practic
3ba0: 65 0a 20 20 69 73 20 66 6f 72 20 74 68 65 20 73  e.  is for the s
3bb0: 75 70 70 6c 69 65 64 20 5b 73 71 6c 69 74 65 33  upplied [sqlite3
3bc0: 5f 6f 73 5f 69 6e 69 74 28 29 5d 20 74 6f 20 69  _os_init()] to i
3bd0: 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 76  nvoke [sqlite3_v
3be0: 66 73 5f 72 65 67 69 73 74 65 72 28 29 5d 2e 0a  fs_register()]..
3bf0: 20 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 61 75    SQLite will au
3c00: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f  tomatically invo
3c10: 6b 65 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69  ke [sqlite3_os_i
3c20: 6e 69 74 28 29 5d 20 77 68 65 6e 20 69 74 20 69  nit()] when it i
3c30: 6e 69 74 69 61 6c 69 7a 65 73 2e 0a 0a 20 20 54  nitializes...  T
3c40: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 74 79  his option is ty
3c50: 70 69 63 61 6c 6c 79 20 75 73 65 64 20 77 68 65  pically used whe
3c60: 6e 20 62 75 69 6c 64 69 6e 67 20 53 51 4c 69 74  n building SQLit
3c70: 65 20 66 6f 72 20 61 6e 20 65 6d 62 65 64 64 65  e for an embedde
3c80: 64 0a 20 20 70 6c 61 74 66 6f 72 6d 20 77 69 74  d.  platform wit
3c90: 68 20 61 20 63 75 73 74 6f 6d 20 6f 70 65 72 61  h a custom opera
3ca0: 74 69 6e 67 20 73 79 73 74 65 6d 2e 0a 7d 0a 0a  ting system..}..
3cb0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3cc0: 53 51 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45  SQLITE_SECURE_DE
3cd0: 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 63  LETE} {.  This c
3ce0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
3cf0: 6f 6e 20 63 68 61 6e 67 65 73 20 74 68 65 20 64  on changes the d
3d00: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 6f  efault setting o
3d10: 66 20 74 68 65 0a 20 20 5b 73 65 63 75 72 65 5f  f the.  [secure_
3d20: 64 65 6c 65 74 65 20 70 72 61 67 6d 61 5d 2e 20  delete pragma]. 
3d30: 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f   When this optio
3d40: 6e 20 69 73 20 6e 6f 74 20 75 73 65 64 2c 20 73  n is not used, s
3d50: 65 63 75 72 65 5f 64 65 6c 65 74 65 20 64 65 66  ecure_delete def
3d60: 61 75 6c 74 73 0a 20 20 74 6f 20 6f 66 66 2e 20  aults.  to off. 
3d70: 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f   When this optio
3d80: 6e 20 69 73 20 70 72 65 73 65 6e 74 2c 20 73 65  n is present, se
3d90: 63 75 72 65 5f 64 65 6c 65 74 65 20 64 65 66 61  cure_delete defa
3da0: 75 6c 74 73 20 74 6f 20 6f 6e 2e 0a 0a 20 20 54  ults to on...  T
3db0: 68 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65  he secure_delete
3dc0: 20 73 65 74 74 69 6e 67 20 63 61 75 73 65 73 20   setting causes 
3dd0: 64 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74 20  deleted content 
3de0: 74 6f 20 62 65 20 6f 76 65 72 77 72 69 74 74 65  to be overwritte
3df0: 6e 20 77 69 74 68 0a 20 20 7a 65 72 6f 73 2e 20  n with.  zeros. 
3e00: 20 54 68 65 72 65 20 69 73 20 61 20 73 6d 61 6c   There is a smal
3e10: 6c 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 70 65  l performance pe
3e20: 6e 61 6c 74 79 20 66 6f 72 20 74 68 69 73 20 73  nalty for this s
3e30: 69 6e 63 65 20 61 64 64 69 74 69 6f 6e 61 6c 20  ince additional 
3e40: 49 2f 4f 0a 20 20 6d 75 73 74 20 6f 63 63 75 72  I/O.  must occur
3e50: 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20  .  On the other 
3e60: 68 61 6e 64 2c 20 73 65 63 75 72 65 5f 64 65 6c  hand, secure_del
3e70: 65 74 65 20 63 61 6e 20 70 72 65 76 65 6e 74 20  ete can prevent 
3e80: 73 65 6e 73 69 74 69 76 65 20 0a 20 20 69 6e 66  sensitive .  inf
3e90: 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 6c 69  ormation from li
3ea0: 6e 67 65 72 69 6e 67 20 69 6e 20 75 6e 75 73 65  ngering in unuse
3eb0: 64 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 64  d parts of the d
3ec0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 66 74  atabase file aft
3ed0: 65 72 20 69 74 0a 20 20 68 61 73 20 61 6c 6c 65  er it.  has alle
3ee0: 67 65 64 6c 79 20 62 65 65 6e 20 64 65 6c 65 74  gedly been delet
3ef0: 65 64 2e 20 20 53 65 65 20 74 68 65 20 64 6f 63  ed.  See the doc
3f00: 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 6e 20 74 68  umentation on th
3f10: 65 0a 20 20 5b 73 65 63 75 72 65 5f 64 65 6c 65  e.  [secure_dele
3f20: 74 65 20 70 72 61 67 6d 61 5d 20 66 6f 72 20 61  te pragma] for a
3f30: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
3f40: 61 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  ation..}..COMPIL
3f50: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
3f60: 5f 54 48 52 45 41 44 53 41 46 45 3d 3c 69 3e 26  _THREADSAFE=<i>&
3f70: 6c 74 3b 30 20 6f 72 20 31 20 6f 72 20 32 26 67  lt;0 or 1 or 2&g
3f80: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
3f90: 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73   option controls
3fa0: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
3fb0: 63 6f 64 65 20 69 73 20 69 6e 63 6c 75 64 65 64  code is included
3fc0: 20 69 6e 20 53 51 4c 69 74 65 20 74 6f 0a 20 20   in SQLite to.  
3fd0: 65 6e 61 62 6c 65 20 69 74 20 74 6f 20 6f 70 65  enable it to ope
3fe0: 72 61 74 65 20 73 61 66 65 6c 79 20 69 6e 20 61  rate safely in a
3ff0: 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 65   multithreaded e
4000: 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 54 68 65  nvironment.  The
4010: 0a 20 20 64 65 66 61 75 6c 74 20 69 73 20 53 51  .  default is SQ
4020: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
4030: 31 20 77 68 69 63 68 20 69 73 20 73 61 66 65 20  1 which is safe 
4040: 66 6f 72 20 75 73 65 20 69 6e 20 61 20 6d 75 6c  for use in a mul
4050: 74 69 74 68 72 65 61 64 65 64 0a 20 20 65 6e 76  tithreaded.  env
4060: 69 72 6f 6e 6d 65 6e 74 2e 20 20 57 68 65 6e 20  ironment.  When 
4070: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51  compiled with SQ
4080: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
4090: 30 20 61 6c 6c 20 6d 75 74 65 78 69 6e 67 20 63  0 all mutexing c
40a0: 6f 64 65 0a 20 20 69 73 20 6f 6d 69 74 74 65 64  ode.  is omitted
40b0: 20 61 6e 64 20 69 74 20 69 73 20 75 6e 73 61 66   and it is unsaf
40c0: 65 20 74 6f 20 75 73 65 20 53 51 4c 69 74 65 20  e to use SQLite 
40d0: 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64  in a multithread
40e0: 65 64 20 70 72 6f 67 72 61 6d 2e 0a 20 20 57 68  ed program..  Wh
40f0: 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  en compiled with
4100: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
4110: 46 45 3d 32 2c 20 53 51 4c 69 74 65 20 63 61 6e  FE=2, SQLite can
4120: 20 62 65 20 75 73 65 64 20 69 6e 20 61 20 6d 75   be used in a mu
4130: 6c 74 69 74 68 72 65 61 64 65 64 0a 20 20 70 72  ltithreaded.  pr
4140: 6f 67 72 61 6d 20 73 6f 20 6c 6f 6e 67 20 61 73  ogram so long as
4150: 20 6e 6f 20 74 77 6f 20 74 68 72 65 61 64 73 20   no two threads 
4160: 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74  attempt to use t
4170: 68 65 20 73 61 6d 65 0a 20 20 5b 64 61 74 61 62  he same.  [datab
4180: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 5d 20  ase connection] 
4190: 28 6f 72 20 61 6e 79 20 5b 70 72 65 70 61 72 65  (or any [prepare
41a0: 64 20 73 74 61 74 65 6d 65 6e 74 73 5d 20 64 65  d statements] de
41b0: 72 69 76 65 64 20 66 72 6f 6d 0a 20 20 74 68 61  rived from.  tha
41c0: 74 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  t database conne
41d0: 63 74 69 6f 6e 29 20 61 74 20 74 68 65 20 73 61  ction) at the sa
41e0: 6d 65 20 74 69 6d 65 2e 0a 0a 20 20 54 6f 20 70  me time...  To p
41f0: 75 74 20 69 74 20 61 6e 6f 74 68 65 72 20 77 61  ut it another wa
4200: 79 2c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  y, SQLITE_THREAD
4210: 53 41 46 45 3d 31 20 73 65 74 73 20 74 68 65 20  SAFE=1 sets the 
4220: 64 65 66 61 75 6c 74 0a 20 20 5b 74 68 72 65 61  default.  [threa
4230: 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 53 65  ding mode] to Se
4240: 72 69 61 6c 69 7a 65 64 2e 20 20 53 51 4c 49 54  rialized.  SQLIT
4250: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 32 20 73  E_THREADSAFE=2 s
4260: 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a  ets the default.
4270: 20 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64    [threading mod
4280: 65 5d 20 74 6f 20 4d 75 6c 74 69 2d 74 68 72 65  e] to Multi-thre
4290: 61 64 65 64 2e 20 20 41 6e 64 20 53 51 4c 49 54  aded.  And SQLIT
42a0: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 30 20 73  E_THREADSAFE=0 s
42b0: 65 74 73 20 74 68 65 0a 20 20 5b 74 68 72 65 61  ets the.  [threa
42c0: 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 53 69  ding mode] to Si
42d0: 6e 67 6c 65 2d 74 68 72 65 61 64 65 64 2e 0a 0a  ngle-threaded...
42e0: 20 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 53    The value of S
42f0: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45  QLITE_THREADSAFE
4300: 20 63 61 6e 20 62 65 20 64 65 74 65 72 6d 69 6e   can be determin
4310: 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20  ed at run-time. 
4320: 20 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69   using the [sqli
4330: 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 28 29  te3_threadsafe()
4340: 5d 20 69 6e 74 65 72 66 61 63 65 2e 0a 0a 20 20  ] interface...  
4350: 57 68 65 6e 20 53 51 4c 69 74 65 20 68 61 73 20  When SQLite has 
4360: 62 65 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69  been compiled wi
4370: 74 68 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  th SQLITE_THREAD
4380: 53 41 46 45 3d 31 20 6f 72 0a 20 20 53 51 4c 49  SAFE=1 or.  SQLI
4390: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 32 20  TE_THREADSAFE=2 
43a0: 74 68 65 6e 20 74 68 65 20 5b 74 68 72 65 61 64  then the [thread
43b0: 69 6e 67 20 6d 6f 64 65 5d 0a 20 20 63 61 6e 20  ing mode].  can 
43c0: 62 65 20 61 6c 74 65 72 65 64 20 61 74 20 72 75  be altered at ru
43d0: 6e 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65  n-time using the
43e0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67   [sqlite3_config
43f0: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f  ()] interface to
4400: 67 65 74 68 65 72 0a 20 20 77 69 74 68 20 6f 6e  gether.  with on
4410: 65 20 6f 66 20 74 68 65 73 65 20 76 65 72 62 73  e of these verbs
4420: 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c 6c 69 3e  :..  <ul>.  <li>
4430: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53  [SQLITE_CONFIG_S
4440: 49 4e 47 4c 45 54 48 52 45 41 44 5d 0a 20 20 3c  INGLETHREAD].  <
4450: 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  li>[SQLITE_CONFI
4460: 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 5d 0a 20  G_MULTITHREAD]. 
4470: 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f 4e   <li>[SQLITE_CON
4480: 46 49 47 5f 53 45 52 49 41 4c 49 5a 45 44 5d 0a  FIG_SERIALIZED].
4490: 20 20 3c 2f 75 6c 3e 0a 0a 20 20 54 68 65 20 5b    </ul>..  The [
44a0: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55  SQLITE_OPEN_NOMU
44b0: 54 45 58 5d 20 61 6e 64 0a 20 20 5b 53 51 4c 49  TEX] and.  [SQLI
44c0: 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d 55 54 45  TE_OPEN_FULLMUTE
44d0: 58 5d 20 66 6c 61 67 73 20 74 6f 20 5b 73 71 6c  X] flags to [sql
44e0: 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d 20  ite3_open_v2()] 
44f0: 63 61 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64  can also be used
4500: 0a 20 20 74 6f 20 61 64 6a 75 73 74 20 74 68 65  .  to adjust the
4510: 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65   [threading mode
4520: 5d 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c 20  ] of individual 
4530: 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63  [database connec
4540: 74 69 6f 6e 73 5d 0a 20 20 61 74 20 72 75 6e 2d  tions].  at run-
4550: 74 69 6d 65 2e 0a 0a 20 20 4e 6f 74 65 20 74 68  time...  Note th
4560: 61 74 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69  at when SQLite i
4570: 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20  s compiled with 
4580: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
4590: 45 3d 30 2c 20 74 68 65 20 63 6f 64 65 0a 20 20  E=0, the code.  
45a0: 74 6f 20 6d 61 6b 65 20 53 51 4c 69 74 65 20 74  to make SQLite t
45b0: 68 72 65 61 64 73 61 66 65 20 69 73 20 6f 6d 69  hreadsafe is omi
45c0: 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75  tted from the bu
45d0: 69 6c 64 2e 20 20 57 68 65 6e 20 74 68 69 73 20  ild.  When this 
45e0: 6f 63 63 75 72 73 2c 0a 20 20 69 74 20 69 73 20  occurs,.  it is 
45f0: 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 68  impossible to ch
4600: 61 6e 67 65 20 74 68 65 20 5b 74 68 72 65 61 64  ange the [thread
4610: 69 6e 67 20 6d 6f 64 65 5d 20 61 74 20 73 74 61  ing mode] at sta
4620: 72 74 2d 74 69 6d 65 20 6f 72 20 72 75 6e 2d 74  rt-time or run-t
4630: 69 6d 65 2e 0a 0a 20 20 53 65 65 20 74 68 65 20  ime...  See the 
4640: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
4650: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
4660: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
4670: 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 6f 6e 20 61  formation.  on a
4680: 73 70 65 63 74 73 20 6f 66 20 75 73 69 6e 67 20  spects of using 
4690: 53 51 4c 69 74 65 20 69 6e 20 61 20 6d 75 6c 74  SQLite in a mult
46a0: 69 74 68 72 65 61 64 65 64 20 65 6e 76 69 72 6f  ithreaded enviro
46b0: 6e 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  nment..}..COMPIL
46c0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
46d0: 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3c 69 3e 26  _TEMP_STORE=<i>&
46e0: 6c 74 3b 30 20 74 68 72 6f 75 67 68 20 33 26 67  lt;0 through 3&g
46f0: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
4700: 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73   option controls
4710: 20 77 68 65 74 68 65 72 20 74 65 6d 70 6f 72 61   whether tempora
4720: 72 79 20 66 69 6c 65 73 20 61 72 65 20 73 74 6f  ry files are sto
4730: 72 65 64 20 6f 6e 20 64 69 73 6b 20 6f 72 0a 20  red on disk or. 
4740: 20 69 6e 20 6d 65 6d 6f 72 79 2e 20 20 54 68 65   in memory.  The
4750: 20 6d 65 61 6e 69 6e 67 73 20 66 6f 72 20 76 61   meanings for va
4760: 72 69 6f 75 73 20 73 65 74 74 69 6e 67 73 20 6f  rious settings o
4770: 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74  f this compile-t
4780: 69 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 61 72 65  ime.  option are
4790: 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20   as follows:..  
47a0: 3c 74 61 62 6c 65 20 63 65 6c 6c 70 61 64 64 69  <table cellpaddi
47b0: 6e 67 3d 22 32 22 20 62 6f 72 64 65 72 3d 22 31  ng="2" border="1
47c0: 22 3e 0a 20 20 3c 74 72 3e 3c 74 68 3e 53 51 4c  ">.  <tr><th>SQL
47d0: 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3c 2f  ITE_TEMP_STORE</
47e0: 74 68 3e 3c 74 68 3e 4d 65 61 6e 69 6e 67 3c 2f  th><th>Meaning</
47f0: 74 68 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c  th></tr>.  <tr><
4800: 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72  td align="center
4810: 22 3e 30 3c 2f 74 64 3e 3c 74 64 3e 41 6c 77 61  ">0</td><td>Alwa
4820: 79 73 20 75 73 65 20 74 65 6d 70 6f 72 61 72 79  ys use temporary
4830: 20 66 69 6c 65 73 3c 2f 74 64 3e 3c 2f 74 72 3e   files</td></tr>
4840: 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e  .  <tr><td align
4850: 3d 22 63 65 6e 74 65 72 22 3e 31 3c 2f 74 64 3e  ="center">1</td>
4860: 3c 74 64 3e 55 73 65 20 66 69 6c 65 73 20 62 79  <td>Use files by
4870: 20 64 65 66 61 75 6c 74 20 62 75 74 20 61 6c 6c   default but all
4880: 6f 77 20 74 68 65 0a 20 20 5b 50 52 41 47 4d 41  ow the.  [PRAGMA
4890: 20 74 65 6d 70 5f 73 74 6f 72 65 5d 20 63 6f 6d   temp_store] com
48a0: 6d 61 6e 64 20 74 6f 20 6f 76 65 72 72 69 64 65  mand to override
48b0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72  </td></tr>.  <tr
48c0: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74  ><td align="cent
48d0: 65 72 22 3e 32 3c 2f 74 64 3e 3c 74 64 3e 55 73  er">2</td><td>Us
48e0: 65 20 6d 65 6d 6f 72 79 20 62 79 20 64 65 66 61  e memory by defa
48f0: 75 6c 74 20 62 75 74 20 61 6c 6c 6f 77 20 74 68  ult but allow th
4900: 65 0a 20 20 5b 50 52 41 47 4d 41 20 74 65 6d 70  e.  [PRAGMA temp
4910: 5f 73 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e 64 20  _store] command 
4920: 74 6f 20 6f 76 65 72 72 69 64 65 3c 2f 74 64 3e  to override</td>
4930: 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20  </tr>.  <tr><td 
4940: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 33  align="center">3
4950: 3c 2f 74 64 3e 3c 74 64 3e 41 6c 77 61 79 73 20  </td><td>Always 
4960: 75 73 65 20 6d 65 6d 6f 72 79 3c 2f 74 64 3e 3c  use memory</td><
4970: 2f 74 72 3e 0a 20 20 3c 2f 74 61 62 6c 65 3e 0a  /tr>.  </table>.
4980: 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73  .  The default s
4990: 65 74 74 69 6e 67 20 69 73 20 31 2e 20 20 0a 20  etting is 1.  . 
49a0: 20 41 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   Additional info
49b0: 72 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 66  rmation can be f
49c0: 6f 75 6e 64 20 69 6e 20 5b 74 65 6d 70 73 74 6f  ound in [tempsto
49d0: 72 65 20 7c 20 74 65 6d 70 66 69 6c 65 73 2e 68  re | tempfiles.h
49e0: 74 6d 6c 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tml]..}..COMPILE
49f0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4a00: 54 52 41 43 45 5f 53 49 5a 45 5f 4c 49 4d 49 54  TRACE_SIZE_LIMIT
4a10: 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 49  =<i>N</i>} {.  I
4a20: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20  f this macro is 
4a30: 64 65 66 69 6e 65 64 20 74 6f 20 61 20 70 6f 73  defined to a pos
4a40: 69 74 69 76 65 20 69 6e 74 65 67 65 72 20 3c 69  itive integer <i
4a50: 3e 4e 3c 2f 69 3e 2c 20 74 68 65 6e 20 74 68 65  >N</i>, then the
4a60: 20 6c 65 6e 67 74 68 20 6f 66 0a 20 20 73 74 72   length of.  str
4a70: 69 6e 67 73 20 61 6e 64 20 42 4c 4f 42 20 74 68  ings and BLOB th
4a80: 61 74 20 61 72 65 20 65 78 70 61 6e 64 65 64 20  at are expanded 
4a90: 69 6e 74 6f 20 70 61 72 61 6d 65 74 65 72 73 20  into parameters 
4aa0: 69 6e 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66  in the output of
4ab0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 72 61 63  .  [sqlite3_trac
4ac0: 65 28 29 5d 20 69 73 20 6c 69 6d 69 74 65 64 20  e()] is limited 
4ad0: 74 6f 20 3c 69 3e 4e 3c 2f 69 3e 20 62 79 74 65  to <i>N</i> byte
4ae0: 73 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  s.  .}..COMPILE_
4af0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 55  OPTION {SQLITE_U
4b00: 53 45 5f 55 52 49 7d 20 7b 0a 20 20 54 68 69 73  SE_URI} {.  This
4b10: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74   option causes t
4b20: 68 65 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65  he [URI filename
4b30: 5d 20 70 72 6f 63 65 73 73 20 6c 6f 67 69 63 20  ] process logic 
4b40: 74 6f 20 62 65 20 65 6e 61 62 6c 65 64 20 62 79  to be enabled by
4b50: 20 0a 20 20 64 65 66 61 75 6c 74 2e 20 20 0a 7d   .  default.  .}
4b60: 0a 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d  ..</tcl>..<a nam
4b70: 65 3d 22 65 6e 61 62 6c 65 66 65 61 74 75 72 65  e="enablefeature
4b80: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 34 20  s"></a>.<h2>1.4 
4b90: 4f 70 74 69 6f 6e 73 20 54 6f 20 45 6e 61 62 6c  Options To Enabl
4ba0: 65 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d 61  e Features Norma
4bb0: 6c 6c 79 20 54 75 72 6e 65 64 20 4f 66 66 3c 2f  lly Turned Off</
4bc0: 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49  h2>..<tcl>.COMPI
4bd0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
4be0: 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55 54 48  E_ALLOW_URI_AUTH
4bf0: 4f 52 49 54 59 7d 20 7b 0a 20 20 5b 55 52 49 20  ORITY} {.  [URI 
4c00: 66 69 6c 65 6e 61 6d 65 73 5d 20 6e 6f 72 6d 61  filenames] norma
4c10: 6c 6c 79 20 74 68 72 6f 77 20 61 6e 20 65 72 72  lly throw an err
4c20: 6f 72 20 69 73 20 74 68 65 20 61 75 74 68 6f 72  or is the author
4c30: 69 74 79 20 73 65 63 74 69 6f 6e 20 69 73 0a 20  ity section is. 
4c40: 20 6e 6f 74 20 65 69 74 68 65 72 20 65 6d 70 74   not either empt
4c50: 79 20 6f 72 20 22 6c 6f 63 61 6c 68 6f 73 74 22  y or "localhost"
4c60: 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66 20 53  .  However, if S
4c70: 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65  QLite is compile
4c80: 64 20 77 69 74 68 0a 20 20 74 68 65 20 53 51 4c  d with.  the SQL
4c90: 49 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41 55  ITE_ALLOW_URI_AU
4ca0: 54 48 4f 52 49 54 59 20 63 6f 6d 70 69 6c 65 2d  THORITY compile-
4cb0: 74 69 6d 65 20 6f 70 74 69 6f 6e 2c 20 74 68 65  time option, the
4cc0: 6e 20 74 68 65 20 55 52 49 20 69 73 0a 20 20 63  n the URI is.  c
4cd0: 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20  onverted into a 
4ce0: 55 6e 69 66 6f 72 6d 20 4e 61 6d 69 6e 67 20 43  Uniform Naming C
4cf0: 6f 6e 76 65 6e 74 69 6f 6e 20 28 55 4e 43 29 20  onvention (UNC) 
4d00: 66 69 6c 65 6e 61 6d 65 20 61 6e 64 20 70 61 73  filename and pas
4d10: 73 65 64 0a 20 20 64 6f 77 6e 20 74 6f 20 74 68  sed.  down to th
4d20: 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 65  e underlying ope
4d30: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 74 68  rating system th
4d40: 61 74 20 77 61 79 2e 20 20 0a 20 20 3c 70 3e 0a  at way.  .  <p>.
4d50: 20 20 53 6f 6d 65 20 66 75 74 75 72 65 20 76 65    Some future ve
4d60: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
4d70: 20 6d 61 79 20 63 68 61 6e 67 65 20 74 6f 20 65   may change to e
4d80: 6e 61 62 6c 65 20 74 68 69 73 20 66 65 61 74 75  nable this featu
4d90: 72 65 0a 20 20 62 79 20 64 65 66 61 75 6c 74 2e  re.  by default.
4da0: 0a 7d 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  .}.COMPILE_OPTIO
4db0: 4e 20 7b 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f  N {SQLITE_ALLOW_
4dc0: 43 4f 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53  COVERING_INDEX_S
4dd0: 43 41 4e 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20  CAN=<i>&lt;0 or 
4de0: 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  1&gt;</i>} {.  T
4df0: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
4e00: 20 6d 61 63 72 6f 20 64 65 74 65 72 6d 69 6e 65   macro determine
4e10: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 65  s the default se
4e20: 74 74 69 6e 67 20 6f 66 20 74 68 65 0a 20 20 5b  tting of the.  [
4e30: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f  SQLITE_CONFIG_CO
4e40: 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41  VERING_INDEX_SCA
4e50: 4e 5d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  N] configuration
4e60: 20 73 65 74 74 69 6e 67 2e 20 20 49 74 20 64 65   setting.  It de
4e70: 66 61 75 6c 74 73 0a 20 20 74 6f 20 31 20 28 6f  faults.  to 1 (o
4e80: 6e 29 20 77 68 69 63 68 20 6d 65 61 6e 73 20 74  n) which means t
4e90: 68 61 74 20 63 6f 76 65 72 69 6e 67 20 69 6e 64  hat covering ind
4ea0: 69 63 65 73 20 61 72 65 20 75 73 65 64 20 66 6f  ices are used fo
4eb0: 72 20 66 75 6c 6c 20 74 61 62 6c 65 0a 20 20 73  r full table.  s
4ec0: 63 61 6e 73 20 77 68 65 72 65 20 70 6f 73 73 69  cans where possi
4ed0: 62 6c 65 2c 20 69 6e 20 6f 72 64 65 72 20 74 6f  ble, in order to
4ee0: 20 72 65 64 75 63 65 20 49 2f 4f 20 61 6e 64 20   reduce I/O and 
4ef0: 69 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 6d 61  improve performa
4f00: 6e 63 65 2e 0a 20 20 48 6f 77 65 76 65 72 2c 20  nce..  However, 
4f10: 74 68 65 20 75 73 65 20 6f 66 20 61 20 63 6f 76  the use of a cov
4f20: 65 72 69 6e 67 20 69 6e 64 65 78 20 66 6f 72 20  ering index for 
4f30: 61 20 66 75 6c 6c 20 73 63 61 6e 20 77 69 6c 6c  a full scan will
4f40: 20 63 61 75 73 65 20 72 65 73 75 6c 74 73 0a 20   cause results. 
4f50: 20 74 6f 20 61 70 70 65 61 72 20 69 6e 20 61 20   to appear in a 
4f60: 64 69 66 66 65 72 65 6e 74 20 6f 72 64 65 72 20  different order 
4f70: 66 72 6f 6d 20 6c 65 67 61 63 79 2c 20 77 68 69  from legacy, whi
4f80: 63 68 20 63 6f 75 6c 64 20 63 61 75 73 65 20 73  ch could cause s
4f90: 6f 6d 65 0a 20 20 28 69 6e 63 6f 72 72 65 63 74  ome.  (incorrect
4fa0: 6c 79 2d 63 6f 64 65 64 29 20 6c 65 67 61 63 79  ly-coded) legacy
4fb0: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 6f   applications to
4fc0: 20 62 72 65 61 6b 2e 20 20 48 65 6e 63 65 2c 20   break.  Hence, 
4fd0: 74 68 65 20 63 6f 76 65 72 69 6e 67 0a 20 20 69  the covering.  i
4fe0: 6e 64 65 78 20 73 63 61 6e 20 6f 70 74 69 6f 6e  ndex scan option
4ff0: 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c 65 64   can be disabled
5000: 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65   at compile-time
5010: 20 6f 6e 20 73 79 73 74 65 6d 73 20 74 68 61 74   on systems that
5020: 20 77 68 61 74 0a 20 20 74 6f 20 6d 69 6e 69 6d   what.  to minim
5030: 69 7a 65 20 74 68 65 69 72 20 72 69 73 6b 20 6f  ize their risk o
5040: 66 20 65 78 70 6f 73 69 6e 67 20 65 72 72 6f 72  f exposing error
5050: 73 20 69 6e 20 6c 65 67 61 63 79 20 61 70 70 6c  s in legacy appl
5060: 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d  ications..}..COM
5070: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
5080: 49 54 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e  ITE_ENABLE_8_3_N
5090: 41 4d 45 53 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72  AMES=<i>&lt;1 or
50a0: 20 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20   2&gt;</i>} {.  
50b0: 49 66 20 74 68 69 73 20 43 2d 70 72 65 70 72 6f  If this C-prepro
50c0: 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 73 20  cessor macro is 
50d0: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 65 78  defined, then ex
50e0: 74 72 61 20 63 6f 64 65 20 69 73 0a 20 20 69 6e  tra code is.  in
50f0: 63 6c 75 64 65 64 20 74 68 61 74 20 61 6c 6c 6f  cluded that allo
5100: 77 73 20 53 51 4c 69 74 65 20 74 6f 20 66 75 6e  ws SQLite to fun
5110: 63 74 69 6f 6e 20 6f 6e 20 61 20 66 69 6c 65 73  ction on a files
5120: 79 73 74 65 6d 20 74 68 61 74 0a 20 20 6f 6e 6c  ystem that.  onl
5130: 79 20 73 75 70 70 6f 72 74 20 38 2b 33 20 66 69  y support 8+3 fi
5140: 6c 65 6e 61 6d 65 73 2e 20 20 49 66 20 74 68 65  lenames.  If the
5150: 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 6d   value of this m
5160: 61 63 72 6f 20 69 73 20 31 2c 0a 20 20 74 68 65  acro is 1,.  the
5170: 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 65  n the default be
5180: 68 61 76 69 6f 72 20 69 73 20 74 6f 20 63 6f 6e  havior is to con
5190: 74 69 6e 75 65 20 74 6f 20 75 73 65 20 6c 6f 6e  tinue to use lon
51a0: 67 20 66 69 6c 65 6e 61 6d 65 73 20 61 6e 64 0a  g filenames and.
51b0: 20 20 74 6f 20 6f 6e 6c 79 20 75 73 65 20 38 2b    to only use 8+
51c0: 33 20 66 69 6c 65 6e 61 6d 65 73 20 69 66 20 74  3 filenames if t
51d0: 68 65 20 0a 20 20 64 61 74 61 62 61 73 65 20 63  he .  database c
51e0: 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65  onnection is ope
51f0: 6e 65 64 20 75 73 69 6e 67 20 5b 55 52 49 20 66  ned using [URI f
5200: 69 6c 65 6e 61 6d 65 73 5d 20 77 69 74 68 0a 20  ilenames] with. 
5210: 20 74 68 65 20 22 3c 74 74 3e 38 5f 33 5f 6e 61   the "<tt>8_3_na
5220: 6d 65 73 3d 31 3c 2f 74 74 3e 22 20 71 75 65 72  mes=1</tt>" quer
5230: 79 20 70 61 72 61 6d 65 74 65 72 2e 20 20 49 66  y parameter.  If
5240: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 0a 20 20   the value of.  
5250: 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 32 2c  this macro is 2,
5260: 20 74 68 65 6e 20 74 68 65 20 75 73 65 20 6f 66   then the use of
5270: 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73 20 62   8+3 filenames b
5280: 65 63 6f 6d 65 73 20 74 68 65 20 64 65 66 61 75  ecomes the defau
5290: 6c 74 0a 20 20 62 75 74 20 6d 61 79 20 62 65 20  lt.  but may be 
52a0: 64 69 73 61 62 6c 65 64 20 6f 6e 20 75 73 69 6e  disabled on usin
52b0: 67 20 74 68 65 20 3c 74 74 3e 38 5f 33 5f 6e 61  g the <tt>8_3_na
52c0: 6d 65 73 3d 30 3c 2f 74 74 3e 20 71 75 65 72 79  mes=0</tt> query
52d0: 20 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 53 65   parameter..  Se
52e0: 65 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e .}..COMPILE_OP
52f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
5300: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 7d 20 7b  BLE_API_ARMOR} {
5310: 0a 20 20 57 68 65 6e 20 64 65 66 69 6e 65 64 2c  .  When defined,
5320: 20 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65   this C-preproce
5330: 73 73 6f 72 20 6d 61 63 72 6f 20 61 63 74 69 76  ssor macro activ
5340: 61 74 65 73 20 65 78 74 72 61 20 63 6f 64 65 20  ates extra code 
5350: 74 68 61 74 0a 20 20 61 74 74 65 6d 70 74 73 20  that.  attempts 
5360: 74 6f 20 64 65 74 65 63 74 20 6d 69 73 75 73 65  to detect misuse
5370: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 41   of the SQLite A
5380: 50 49 2c 20 73 75 63 68 20 61 73 20 70 61 73 73  PI, such as pass
5390: 69 6e 67 20 69 6e 20 4e 55 4c 4c 0a 20 20 70 6f  ing in NULL.  po
53a0: 69 6e 74 65 72 73 20 74 6f 20 72 65 71 75 69 72  inters to requir
53b0: 65 64 20 70 61 72 61 6d 65 74 65 72 73 20 6f 72  ed parameters or
53c0: 20 75 73 69 6e 67 20 6f 62 6a 65 63 74 73 20 61   using objects a
53d0: 66 74 65 72 20 74 68 65 79 20 68 61 76 65 20 62  fter they have b
53e0: 65 65 6e 0a 20 20 64 65 73 74 72 6f 79 65 64 2e  een.  destroyed.
53f0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
5400: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
5410: 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 7d 20  E_ATOMIC_WRITE} 
5420: 7b 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72  {.  If this C-pr
5430: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f  eprocessor macro
5440: 20 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20   is defined and 
5450: 69 66 20 74 68 65 0a 20 20 78 44 65 76 69 63 65  if the.  xDevice
5460: 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20  Characteristics 
5470: 6d 65 74 68 6f 64 20 6f 66 20 5b 73 71 6c 69 74  method of [sqlit
5480: 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 5d 20 6f  e3_io_methods] o
5490: 62 6a 65 63 74 20 66 6f 72 0a 20 20 61 20 64 61  bject for.  a da
54a0: 74 61 62 61 73 65 20 66 69 6c 65 20 72 65 70 6f  tabase file repo
54b0: 72 74 73 20 28 76 69 61 20 6f 6e 65 20 6f 66 20  rts (via one of 
54c0: 74 68 65 20 5b 53 51 4c 49 54 45 5f 49 4f 43 41  the [SQLITE_IOCA
54d0: 50 5f 41 54 4f 4d 49 43 5d 20 62 69 74 73 29 0a  P_ATOMIC] bits).
54e0: 20 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 73    that the files
54f0: 79 73 74 65 6d 20 73 75 70 70 6f 72 74 73 20 61  ystem supports a
5500: 74 6f 6d 69 63 20 77 72 69 74 65 73 20 61 6e 64  tomic writes and
5510: 20 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   if a transactio
5520: 6e 0a 20 20 69 6e 76 6f 6c 76 65 73 20 61 20 63  n.  involves a c
5530: 68 61 6e 67 65 20 74 6f 20 6f 6e 6c 79 20 61 20  hange to only a 
5540: 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74  single page of t
5550: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
5560: 2c 0a 20 20 74 68 65 6e 20 74 68 65 20 74 72 61  ,.  then the tra
5570: 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73  nsaction commits
5580: 20 77 69 74 68 20 6a 75 73 74 20 61 20 73 69 6e   with just a sin
5590: 67 6c 65 20 77 72 69 74 65 20 72 65 71 75 65 73  gle write reques
55a0: 74 20 6f 66 0a 20 20 61 20 73 69 6e 67 6c 65 20  t of.  a single 
55b0: 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61  page of the data
55c0: 62 61 73 65 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c  base and no roll
55d0: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 69 73 20  back journal is 
55e0: 63 72 65 61 74 65 64 0a 20 20 6f 72 20 77 72 69  created.  or wri
55f0: 74 74 65 6e 2e 20 20 4f 6e 20 66 69 6c 65 73 79  tten.  On filesy
5600: 73 74 65 6d 73 20 74 68 61 74 20 73 75 70 70 6f  stems that suppo
5610: 72 74 20 61 74 6f 6d 69 63 20 77 72 69 74 65 73  rt atomic writes
5620: 2c 20 74 68 69 73 0a 20 20 6f 70 74 69 6d 69 7a  , this.  optimiz
5630: 61 74 69 6f 6e 20 63 61 6e 20 72 65 73 75 6c 74  ation can result
5640: 20 69 6e 20 73 69 67 6e 69 66 69 63 61 6e 74 20   in significant 
5650: 73 70 65 65 64 20 69 6d 70 72 6f 76 65 6d 65 6e  speed improvemen
5660: 74 73 20 66 6f 72 0a 20 20 73 6d 61 6c 6c 20 75  ts for.  small u
5670: 70 64 61 74 65 73 2e 20 20 48 6f 77 65 76 65 72  pdates.  However
5680: 2c 20 66 65 77 20 66 69 6c 65 73 79 73 74 65 6d  , few filesystem
5690: 73 20 73 75 70 70 6f 72 74 20 74 68 69 73 20 63  s support this c
56a0: 61 70 61 62 69 6c 69 74 79 0a 20 20 61 6e 64 20  apability.  and 
56b0: 74 68 65 20 63 6f 64 65 20 70 61 74 68 73 20 74  the code paths t
56c0: 68 61 74 20 63 68 65 63 6b 20 66 6f 72 20 74 68  hat check for th
56d0: 69 73 20 63 61 70 61 62 69 6c 69 74 79 20 73 6c  is capability sl
56e0: 6f 77 20 64 6f 77 6e 20 77 72 69 74 65 0a 20 20  ow down write.  
56f0: 70 65 72 66 6f 72 6d 61 6e 63 65 20 6f 6e 20 73  performance on s
5700: 79 73 74 65 6d 73 20 74 68 61 74 20 6c 61 63 6b  ystems that lack
5710: 20 61 74 6f 6d 69 63 20 77 72 69 74 65 20 63 61   atomic write ca
5720: 70 61 62 69 6c 69 74 79 2c 20 73 6f 20 74 68 69  pability, so thi
5730: 73 0a 20 20 66 65 61 74 75 72 65 20 69 73 20 64  s.  feature is d
5740: 69 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75  isabled by defau
5750: 6c 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  lt..}..COMPILE_O
5760: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
5770: 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41  ABLE_COLUMN_META
5780: 44 41 54 41 7d 20 7b 0a 20 20 57 68 65 6e 20 74  DATA} {.  When t
5790: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
57a0: 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  or macro is defi
57b0: 6e 65 64 2c 20 53 51 4c 69 74 65 20 69 6e 63 6c  ned, SQLite incl
57c0: 75 64 65 73 20 73 6f 6d 65 0a 20 20 61 64 64 69  udes some.  addi
57d0: 74 69 6f 6e 61 6c 20 41 50 49 73 20 74 68 61 74  tional APIs that
57e0: 20 70 72 6f 76 69 64 65 20 63 6f 6e 76 65 6e 69   provide conveni
57f0: 65 6e 74 20 61 63 63 65 73 73 20 74 6f 20 6d 65  ent access to me
5800: 74 61 2d 64 61 74 61 20 61 62 6f 75 74 0a 20 20  ta-data about.  
5810: 74 61 62 6c 65 73 20 61 6e 64 20 71 75 65 72 69  tables and queri
5820: 65 73 2e 20 20 54 68 65 20 41 50 49 73 20 74 68  es.  The APIs th
5830: 61 74 20 61 72 65 20 65 6e 61 62 6c 65 64 20 62  at are enabled b
5840: 79 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 72  y this option ar
5850: 65 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c 6c 69  e:..  <ul>.  <li
5860: 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  > [sqlite3_colum
5870: 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 28  n_database_name(
5880: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20  )] </li>.  <li> 
5890: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
58a0: 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 28  database_name16(
58b0: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20  )] </li>.  <li> 
58c0: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
58d0: 74 61 62 6c 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f  table_name()] </
58e0: 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69  li>.  <li> [sqli
58f0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65  te3_column_table
5900: 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e  _name16()] </li>
5910: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33  .  <li> [sqlite3
5920: 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e  _column_origin_n
5930: 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c  ame()] </li>.  <
5940: 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c  li> [sqlite3_col
5950: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31  umn_origin_name1
5960: 36 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69  6()] </li>.  <li
5970: 3e 20 5b 73 71 6c 69 74 65 33 5f 74 61 62 6c 65  > [sqlite3_table
5980: 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61  _column_metadata
5990: 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 2f 75 6c  ()] </li>.  </ul
59a0: 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  >.}..COMPILE_OPT
59b0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
59c0: 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45  LE_EXPLAIN_COMME
59d0: 4e 54 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  NTS} {.  This op
59e0: 74 69 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20  tion adds extra 
59f0: 6c 6f 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20  logic to SQLite 
5a00: 74 68 61 74 20 69 6e 73 65 72 74 73 20 63 6f 6d  that inserts com
5a10: 6d 65 6e 74 20 74 65 78 74 20 69 6e 74 6f 20 74  ment text into t
5a20: 68 65 0a 20 20 6f 75 74 70 75 74 20 6f 66 20 5b  he.  output of [
5a30: 45 58 50 4c 41 49 4e 5d 2e 20 20 54 68 65 73 65  EXPLAIN].  These
5a40: 20 65 78 74 72 61 20 63 6f 6d 6d 65 6e 74 73 20   extra comments 
5a50: 75 73 65 20 65 78 74 72 61 20 6d 65 6d 6f 72 79  use extra memory
5a60: 2c 20 74 68 75 73 0a 20 20 6d 61 6b 69 6e 67 20  , thus.  making 
5a70: 5b 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d  [prepared statem
5a80: 65 6e 74 73 5d 20 6c 61 72 67 65 72 20 61 6e 64  ents] larger and
5a90: 20 76 65 72 79 20 73 6c 69 67 68 74 6c 79 20 73   very slightly s
5aa0: 6c 6f 77 65 72 2c 20 61 6e 64 20 73 6f 20 74 68  lower, and so th
5ab0: 65 79 20 61 72 65 0a 20 20 74 75 72 6e 65 64 20  ey are.  turned 
5ac0: 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74 20 61  off by default a
5ad0: 6e 64 20 69 6e 20 6d 6f 73 74 20 61 70 70 6c 69  nd in most appli
5ae0: 63 61 74 69 6f 6e 2e 20 20 42 75 74 20 73 6f 6d  cation.  But som
5af0: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2c 20  e applications, 
5b00: 73 75 63 68 0a 20 20 61 73 20 74 68 65 20 5b 63  such.  as the [c
5b10: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 68 65 6c  ommand-line shel
5b20: 6c 5d 20 66 6f 72 20 53 51 4c 69 74 65 2c 20 76  l] for SQLite, v
5b30: 61 6c 75 65 20 63 6c 61 72 69 74 79 20 6f 66 20  alue clarity of 
5b40: 45 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 0a 20  EXPLAIN output. 
5b50: 20 6f 76 65 72 20 72 61 77 20 70 65 72 66 6f 72   over raw perfor
5b60: 6d 61 6e 63 65 20 61 6e 64 20 73 6f 20 74 68 69  mance and so thi
5b70: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  s compile-time o
5b80: 70 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62  ption is availab
5b90: 6c 65 20 74 6f 20 74 68 65 6d 2e 0a 20 20 54 68  le to them..  Th
5ba0: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  e SQLITE_ENABLE_
5bb0: 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53  EXPLAIN_COMMENTS
5bc0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
5bd0: 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 65 6e 61  tion is also ena
5be0: 62 6c 65 64 0a 20 20 61 75 74 6f 6d 61 74 69 63  bled.  automatic
5bf0: 61 6c 6c 79 20 69 66 20 5b 53 51 4c 49 54 45 5f  ally if [SQLITE_
5c00: 44 45 42 55 47 5d 20 69 73 20 65 6e 61 62 6c 65  DEBUG] is enable
5c10: 64 2e 0a 7d 0a 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  d..}...COMPILE_O
5c20: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
5c30: 41 42 4c 45 5f 46 54 53 33 7d 20 7b 0a 20 20 57  ABLE_FTS3} {.  W
5c40: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
5c50: 69 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68  is defined in th
5c60: 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d  e [amalgamation]
5c70: 2c 20 76 65 72 73 69 6f 6e 20 33 0a 20 20 6f 66  , version 3.  of
5c80: 20 74 68 65 20 66 75 6c 6c 2d 74 65 78 74 20 73   the full-text s
5c90: 65 61 72 63 68 20 65 6e 67 69 6e 65 20 69 73 20  earch engine is 
5ca0: 61 64 64 65 64 20 74 6f 20 74 68 65 20 62 75 69  added to the bui
5cb0: 6c 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ld automatically
5cc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
5cd0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
5ce0: 4c 45 5f 46 54 53 33 5f 50 41 52 45 4e 54 48 45  LE_FTS3_PARENTHE
5cf0: 53 49 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  SIS} {.  This op
5d00: 74 69 6f 6e 20 6d 6f 64 69 66 69 65 73 20 74 68  tion modifies th
5d10: 65 20 71 75 65 72 79 20 70 61 74 74 65 72 6e 20  e query pattern 
5d20: 70 61 72 73 65 72 20 69 6e 20 46 54 53 33 20 73  parser in FTS3 s
5d30: 75 63 68 20 74 68 61 74 20 69 74 0a 20 20 73 75  uch that it.  su
5d40: 70 70 6f 72 74 73 20 6f 70 65 72 61 74 6f 72 73  pports operators
5d50: 20 41 4e 44 20 61 6e 64 20 4e 4f 54 20 28 69 6e   AND and NOT (in
5d60: 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65   addition to the
5d70: 20 75 73 75 61 6c 20 4f 52 20 61 6e 64 20 4e 45   usual OR and NE
5d80: 41 52 29 0a 20 20 61 6e 64 20 61 6c 73 6f 20 61  AR).  and also a
5d90: 6c 6c 6f 77 73 20 71 75 65 72 79 20 65 78 70 72  llows query expr
5da0: 65 73 73 69 6f 6e 73 20 74 6f 20 63 6f 6e 74 61  essions to conta
5db0: 69 6e 20 6e 65 73 74 65 64 20 70 61 72 65 6e 74  in nested parent
5dc0: 68 65 73 69 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  hesis..}..COMPIL
5dd0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
5de0: 5f 45 4e 41 42 4c 45 5f 46 54 53 34 7d 20 7b 0a  _ENABLE_FTS4} {.
5df0: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
5e00: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e  on is defined in
5e10: 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69   the [amalgamati
5e20: 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 73 20 33 20  on], versions 3 
5e30: 61 6e 64 20 34 0a 20 20 6f 66 20 74 68 65 20 66  and 4.  of the f
5e40: 75 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20  ull-text search 
5e50: 65 6e 67 69 6e 65 20 69 73 20 61 64 64 65 64 20  engine is added 
5e60: 74 6f 20 74 68 65 20 62 75 69 6c 64 20 61 75 74  to the build aut
5e70: 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d 0a 0a 43  omatically..}..C
5e80: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
5e90: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 55  QLITE_ENABLE_ICU
5ea0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
5eb0: 6e 20 63 61 75 73 65 73 20 74 68 65 20 0a 20 20  n causes the .  
5ec0: 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 69 63 75 2d  [http://www.icu-
5ed0: 70 72 6f 6a 65 63 74 2e 6f 72 67 2f 20 7c 20 49  project.org/ | I
5ee0: 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 43 6f 6d  nternational Com
5ef0: 70 6f 6e 65 6e 74 73 20 66 6f 72 20 55 6e 69 63  ponents for Unic
5f00: 6f 64 65 5d 0a 20 20 6f 72 20 22 49 43 55 22 20  ode].  or "ICU" 
5f10: 65 78 74 65 6e 73 69 6f 6e 20 74 6f 20 53 51 4c  extension to SQL
5f20: 69 74 65 20 74 6f 20 62 65 20 61 64 64 65 64 20  ite to be added 
5f30: 74 6f 20 74 68 65 20 62 75 69 6c 64 2e 20 20 0a  to the build.  .
5f40: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
5f50: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
5f60: 5f 49 4f 54 52 41 43 45 7d 20 7b 0a 20 20 57 68  _IOTRACE} {.  Wh
5f70: 65 6e 20 62 6f 74 68 20 74 68 65 20 53 51 4c 69  en both the SQLi
5f80: 74 65 20 63 6f 72 65 20 61 6e 64 20 74 68 65 20  te core and the 
5f90: 5b 43 6f 6d 6d 61 6e 64 20 4c 69 6e 65 20 49 6e  [Command Line In
5fa0: 74 65 72 66 61 63 65 5d 20 28 43 4c 49 29 20 61  terface] (CLI) a
5fb0: 72 65 20 62 6f 74 68 20 0a 20 20 63 6f 6d 70 69  re both .  compi
5fc0: 6c 65 64 20 77 69 74 68 20 74 68 69 73 20 6f 70  led with this op
5fd0: 74 69 6f 6e 2c 20 74 68 65 6e 20 74 68 65 20 43  tion, then the C
5fe0: 4c 49 20 70 72 6f 76 69 64 65 73 20 61 6e 20 65  LI provides an e
5ff0: 78 74 72 61 20 63 6f 6d 6d 61 6e 64 0a 20 20 6e  xtra command.  n
6000: 61 6d 65 64 20 22 2e 69 6f 74 72 61 63 65 22 20  amed ".iotrace" 
6010: 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 61 20  that provides a 
6020: 6c 6f 77 2d 6c 65 76 65 6c 20 6c 6f 67 20 6f 66  low-level log of
6030: 20 49 2f 4f 20 61 63 74 69 76 69 74 79 2e 0a 20   I/O activity.. 
6040: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   This option is 
6050: 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e 64  experimental and
6060: 20 6d 61 79 20 62 65 20 64 69 73 63 6f 6e 74 69   may be disconti
6070: 6e 75 65 64 20 69 6e 20 61 20 66 75 74 75 72 65  nued in a future
6080: 20 72 65 6c 65 61 73 65 2e 0a 7d 0a 0a 43 4f 4d   release..}..COM
6090: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
60a0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49  ITE_ENABLE_LOCKI
60b0: 4e 47 5f 53 54 59 4c 45 7d 20 7b 0a 20 20 54 68  NG_STYLE} {.  Th
60c0: 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65  is option enable
60d0: 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67  s additional log
60e0: 69 63 20 69 6e 20 74 68 65 20 4f 53 20 69 6e 74  ic in the OS int
60f0: 65 72 66 61 63 65 20 6c 61 79 65 72 20 66 6f 72  erface layer for
6100: 0a 20 20 4d 61 63 20 4f 53 20 58 2e 20 54 68 65  .  Mac OS X. The
6110: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69   additional logi
6120: 63 20 61 74 74 65 6d 70 74 73 20 74 6f 20 64 65  c attempts to de
6130: 74 65 72 6d 69 6e 65 20 74 68 65 20 74 79 70 65  termine the type
6140: 20 6f 66 20 74 68 65 0a 20 20 75 6e 64 65 72 6c   of the.  underl
6150: 79 69 6e 67 20 66 69 6c 65 73 79 73 74 65 6d 20  ying filesystem 
6160: 61 6e 64 20 63 68 6f 6f 73 65 20 61 6e 64 20 61  and choose and a
6170: 6c 74 65 72 6e 61 74 69 76 65 20 6c 6f 63 6b 69  lternative locki
6180: 6e 67 20 73 74 72 61 74 65 67 79 0a 20 20 74 68  ng strategy.  th
6190: 61 74 20 77 6f 72 6b 73 20 63 6f 72 72 65 63 74  at works correct
61a0: 6c 79 20 66 6f 72 20 74 68 61 74 20 66 69 6c 65  ly for that file
61b0: 73 79 73 74 65 6d 20 74 79 70 65 2e 20 46 69 76  system type. Fiv
61c0: 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74 65  e locking strate
61d0: 67 69 65 73 20 0a 20 20 61 72 65 20 61 76 61 69  gies .  are avai
61e0: 6c 61 62 6c 65 3a 0a 0a 20 20 3c 75 6c 3e 0a 20  lable:..  <ul>. 
61f0: 20 20 20 3c 6c 69 3e 20 50 4f 53 49 58 20 6c 6f     <li> POSIX lo
6200: 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68 69  cking style. Thi
6210: 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74  s is the default
6220: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 61   locking style a
6230: 6e 64 20 74 68 65 0a 20 20 20 20 20 20 20 20 20  nd the.         
6240: 73 74 79 6c 65 20 75 73 65 64 20 62 79 20 6f 74  style used by ot
6250: 68 65 72 20 28 6e 6f 6e 20 4d 61 63 20 4f 53 20  her (non Mac OS 
6260: 58 29 20 55 6e 69 78 65 73 2e 20 4c 6f 63 6b 73  X) Unixes. Locks
6270: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 61 6e   are obtained an
6280: 64 20 0a 20 20 20 20 20 20 20 20 20 72 65 6c 65  d .         rele
6290: 61 73 65 64 20 75 73 69 6e 67 20 74 68 65 20 66  ased using the f
62a0: 63 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63 61  cntl() system ca
62b0: 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 41 46  ll...    <li> AF
62c0: 50 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  P locking style.
62d0: 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74   This locking st
62e0: 79 6c 65 20 69 73 20 75 73 65 64 20 66 6f 72 20  yle is used for 
62f0: 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20 0a 20 20  network file .  
6300: 20 20 20 20 20 20 20 73 79 73 74 65 6d 73 20 74         systems t
6310: 68 61 74 20 75 73 65 20 74 68 65 20 41 46 50 20  hat use the AFP 
6320: 28 41 70 70 6c 65 20 46 69 6c 69 6e 67 20 50 72  (Apple Filing Pr
6330: 6f 74 6f 63 6f 6c 29 20 70 72 6f 74 6f 63 6f 6c  otocol) protocol
6340: 2e 20 4c 6f 63 6b 73 0a 20 20 20 20 20 20 20 20  . Locks.        
6350: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62 79   are obtained by
6360: 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 6c 69 62   calling the lib
6370: 72 61 72 79 20 66 75 6e 63 74 69 6f 6e 20 5f 41  rary function _A
6380: 46 50 46 53 53 65 74 4c 6f 63 6b 28 29 2e 0a 0a  FPFSSetLock()...
6390: 20 20 20 20 3c 6c 69 3e 20 46 6c 6f 63 6b 20 6c      <li> Flock l
63a0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68  ocking style. Th
63b0: 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 66  is is used for f
63c0: 69 6c 65 2d 73 79 73 74 65 6d 73 20 74 68 61 74  ile-systems that
63d0: 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 20 20 20   do not.        
63e0: 20 73 75 70 70 6f 72 74 20 50 4f 53 49 58 20 6c   support POSIX l
63f0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 4c 6f  ocking style. Lo
6400: 63 6b 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64  cks are obtained
6410: 20 61 6e 64 20 72 65 6c 65 61 73 65 64 20 75 73   and released us
6420: 69 6e 67 0a 20 20 20 20 20 20 20 20 20 74 68 65  ing.         the
6430: 20 66 6c 6f 63 6b 28 29 20 73 79 73 74 65 6d 20   flock() system 
6440: 63 61 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20  call...    <li> 
6450: 44 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 69 6e 67  Dot-file locking
6460: 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c 6f 63   style. This loc
6470: 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75 73  king style is us
6480: 65 64 20 77 68 65 6e 20 6e 65 69 74 68 65 72 0a  ed when neither.
6490: 20 20 20 20 20 20 20 20 20 66 6c 6f 63 6b 20 6e           flock n
64a0: 6f 72 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67  or POSIX locking
64b0: 20 73 74 79 6c 65 73 20 61 72 65 20 73 75 70 70   styles are supp
64c0: 6f 72 74 65 64 20 62 79 20 74 68 65 20 66 69 6c  orted by the fil
64d0: 65 20 73 79 73 74 65 6d 2e 0a 20 20 20 20 20 20  e system..      
64e0: 20 20 20 44 61 74 61 62 61 73 65 20 6c 6f 63 6b     Database lock
64f0: 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62  s are obtained b
6500: 79 20 63 72 65 61 74 69 6e 67 20 61 6e 64 20 65  y creating and e
6510: 6e 74 72 79 20 69 6e 20 74 68 65 20 66 69 6c 65  ntry in the file
6520: 2d 73 79 73 74 65 6d 0a 20 20 20 20 20 20 20 20  -system.        
6530: 20 61 74 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e   at a well-known
6540: 20 6c 6f 63 61 74 69 6f 6e 20 72 65 6c 61 74 69   location relati
6550: 76 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  ve to the databa
6560: 73 65 20 66 69 6c 65 20 28 61 20 22 64 6f 74 2d  se file (a "dot-
6570: 66 69 6c 65 22 29 0a 20 20 20 20 20 20 20 20 20  file").         
6580: 61 6e 64 20 72 65 6c 69 6e 71 75 69 73 68 65 64  and relinquished
6590: 20 62 79 20 64 65 6c 65 74 69 6e 67 20 74 68 65   by deleting the
65a0: 20 73 61 6d 65 20 66 69 6c 65 2e 0a 0a 20 20 20   same file...   
65b0: 20 3c 6c 69 3e 20 4e 6f 20 6c 6f 63 6b 69 6e 67   <li> No locking
65c0: 20 73 74 79 6c 65 2e 20 49 66 20 6e 6f 6e 65 20   style. If none 
65d0: 6f 66 20 74 68 65 20 61 62 6f 76 65 20 63 61 6e  of the above can
65e0: 20 62 65 20 73 75 70 70 6f 72 74 65 64 2c 20 74   be supported, t
65f0: 68 69 73 20 0a 20 20 20 20 20 20 20 20 20 6c 6f  his .         lo
6600: 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75  cking style is u
6610: 73 65 64 2e 20 4e 6f 20 64 61 74 61 62 61 73 65  sed. No database
6620: 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69   locking mechani
6630: 73 6d 20 69 73 20 75 73 65 64 2e 20 57 68 65 6e  sm is used. When
6640: 0a 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73  .         this s
6650: 79 73 74 65 6d 20 69 73 20 75 73 65 64 20 69 74  ystem is used it
6660: 20 69 73 20 6e 6f 74 20 73 61 66 65 20 66 6f 72   is not safe for
6670: 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61   a single databa
6680: 73 65 20 74 6f 20 62 65 0a 20 20 20 20 20 20 20  se to be.       
6690: 20 20 61 63 63 65 73 73 65 64 20 62 79 20 6d 75    accessed by mu
66a0: 6c 74 69 70 6c 65 20 63 6c 69 65 6e 74 73 2e 0a  ltiple clients..
66b0: 20 20 3c 2f 75 6c 3e 0a 0a 20 20 41 64 64 69 74    </ul>..  Addit
66c0: 69 6f 6e 61 6c 6c 79 2c 20 66 69 76 65 20 65 78  ionally, five ex
66d0: 74 72 61 20 5b 56 46 53 5d 20 69 6d 70 6c 65 6d  tra [VFS] implem
66e0: 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 70 72  entations are pr
66f0: 6f 76 69 64 65 64 20 61 73 20 77 65 6c 6c 20 61  ovided as well a
6700: 73 20 74 68 65 0a 20 20 64 65 66 61 75 6c 74 2e  s the.  default.
6710: 20 42 79 20 73 70 65 63 69 66 79 69 6e 67 20 6f   By specifying o
6720: 6e 65 20 6f 66 20 74 68 65 20 65 78 74 72 61 20  ne of the extra 
6730: 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  VFS implementati
6740: 6f 6e 73 20 0a 20 20 77 68 65 6e 20 63 61 6c 6c  ons .  when call
6750: 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65  ing [sqlite3_ope
6760: 6e 5f 76 32 28 29 5d 2c 20 61 6e 20 61 70 70 6c  n_v2()], an appl
6770: 69 63 61 74 69 6f 6e 20 6d 61 79 20 62 79 70 61  ication may bypa
6780: 73 73 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74  ss the file-syst
6790: 65 6d 0a 20 20 64 65 74 65 63 74 69 6f 6e 20 6c  em.  detection l
67a0: 6f 67 69 63 20 61 6e 64 20 65 78 70 6c 69 63 69  ogic and explici
67b0: 74 6c 79 20 73 65 6c 65 63 74 20 6f 6e 65 20 6f  tly select one o
67c0: 66 20 74 68 65 20 61 62 6f 76 65 20 6c 6f 63 6b  f the above lock
67d0: 69 6e 67 20 73 74 79 6c 65 73 2e 20 54 68 65 0a  ing styles. The.
67e0: 20 20 66 69 76 65 20 65 78 74 72 61 20 5b 56 46    five extra [VF
67f0: 53 5d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  S] implementatio
6800: 6e 73 20 61 72 65 20 63 61 6c 6c 65 64 20 22 75  ns are called "u
6810: 6e 69 78 2d 70 6f 73 69 78 22 2c 20 22 75 6e 69  nix-posix", "uni
6820: 78 2d 61 66 70 22 2c 0a 20 20 22 75 6e 69 78 2d  x-afp",.  "unix-
6830: 66 6c 6f 63 6b 22 2c 20 22 75 6e 69 78 2d 64 6f  flock", "unix-do
6840: 74 66 69 6c 65 22 20 61 6e 64 20 22 75 6e 69 78  tfile" and "unix
6850: 2d 6e 6f 6e 65 22 2e 0a 7d 0a 0a 43 4f 4d 50 49  -none"..}..COMPI
6860: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
6870: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f  E_ENABLE_MEMORY_
6880: 4d 41 4e 41 47 45 4d 45 4e 54 7d 20 7b 0a 20 20  MANAGEMENT} {.  
6890: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73  This option adds
68a0: 20 65 78 74 72 61 20 6c 6f 67 69 63 20 74 6f 20   extra logic to 
68b0: 53 51 4c 69 74 65 20 74 68 61 74 20 61 6c 6c 6f  SQLite that allo
68c0: 77 73 20 69 74 20 74 6f 20 72 65 6c 65 61 73 65  ws it to release
68d0: 20 75 6e 75 73 65 64 0a 20 20 6d 65 6d 6f 72 79   unused.  memory
68e0: 20 75 70 6f 6e 20 72 65 71 75 65 73 74 2e 20 20   upon request.  
68f0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 75 73 74  This option must
6900: 20 62 65 20 65 6e 61 62 6c 65 64 20 69 6e 20 6f   be enabled in o
6910: 72 64 65 72 20 66 6f 72 20 74 68 65 0a 20 20 5b  rder for the.  [
6920: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f  sqlite3_release_
6930: 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72 66  memory()] interf
6940: 61 63 65 20 74 6f 20 77 6f 72 6b 2e 20 20 49 66  ace to work.  If
6950: 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69   this compile-ti
6960: 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 69 73 20 6e  me.  option is n
6970: 6f 74 20 75 73 65 64 2c 20 74 68 65 20 5b 73 71  ot used, the [sq
6980: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
6990: 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72 66 61 63  mory()] interfac
69a0: 65 20 69 73 20 61 20 0a 20 20 6e 6f 2d 6f 70 2e  e is a .  no-op.
69b0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
69c0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
69d0: 45 5f 4d 45 4d 53 59 53 33 7d 20 7b 0a 20 20 54  E_MEMSYS3} {.  T
69e0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e 63 6c 75  his option inclu
69f0: 64 65 73 20 63 6f 64 65 20 69 6e 20 53 51 4c 69  des code in SQLi
6a00: 74 65 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e  te that implemen
6a10: 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  ts an alternativ
6a20: 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  e.  memory alloc
6a30: 61 74 6f 72 2e 20 20 54 68 69 73 20 61 6c 74 65  ator.  This alte
6a40: 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 61  rnative memory a
6a50: 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f 6e 6c 79  llocator is only
6a60: 20 65 6e 67 61 67 65 64 0a 20 20 77 68 65 6e 20   engaged.  when 
6a70: 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  the [SQLITE_CONF
6a80: 49 47 5f 48 45 41 50 5d 20 6f 70 74 69 6f 6e 20  IG_HEAP] option 
6a90: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66  to [sqlite3_conf
6aa0: 69 67 28 29 5d 20 69 73 20 75 73 65 64 20 74 6f  ig()] is used to
6ab0: 0a 20 20 73 75 70 70 6c 79 20 61 20 6c 61 72 67  .  supply a larg
6ac0: 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72  e chunk of memor
6ad0: 79 20 66 72 6f 6d 20 77 68 69 63 68 20 61 6c 6c  y from which all
6ae0: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69   memory allocati
6af0: 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b 65 6e 2e  ons are.  taken.
6b00: 0a 20 20 54 68 65 20 4d 45 4d 53 59 53 33 20 6d  .  The MEMSYS3 m
6b10: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20  emory allocator 
6b20: 75 73 65 73 20 61 20 68 79 62 72 69 64 20 61 6c  uses a hybrid al
6b30: 6c 6f 63 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74  location algorit
6b40: 68 6d 20 0a 20 20 70 61 74 74 65 72 6e 65 64 20  hm .  patterned 
6b50: 61 66 74 65 72 20 64 6c 6d 61 6c 6c 6f 63 28 29  after dlmalloc()
6b60: 2e 20 20 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20  .   Only one of 
6b70: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
6b80: 4d 53 59 53 33 20 61 6e 64 20 0a 20 20 53 51 4c  MSYS3 and .  SQL
6b90: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59  ITE_ENABLE_MEMSY
6ba0: 53 35 20 6d 61 79 20 62 65 20 65 6e 61 62 6c 65  S5 may be enable
6bb0: 64 20 61 74 20 6f 6e 63 65 2e 0a 7d 0a 0a 43 4f  d at once..}..CO
6bc0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
6bd0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53  LITE_ENABLE_MEMS
6be0: 59 53 35 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  YS5} {.  This op
6bf0: 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f  tion includes co
6c00: 64 65 20 69 6e 20 53 51 4c 69 74 65 20 74 68 61  de in SQLite tha
6c10: 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20  t implements an 
6c20: 61 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 6d 65  alternative.  me
6c30: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20  mory allocator. 
6c40: 20 54 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76   This alternativ
6c50: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  e memory allocat
6c60: 6f 72 20 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67  or is only engag
6c70: 65 64 0a 20 20 77 68 65 6e 20 74 68 65 20 5b 53  ed.  when the [S
6c80: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41  QLITE_CONFIG_HEA
6c90: 50 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71  P] option to [sq
6ca0: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20  lite3_config()] 
6cb0: 69 73 20 75 73 65 64 20 74 6f 0a 20 20 73 75 70  is used to.  sup
6cc0: 70 6c 79 20 61 20 6c 61 72 67 65 20 63 68 75 6e  ply a large chun
6cd0: 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d  k of memory from
6ce0: 20 77 68 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72   which all memor
6cf0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72  y allocations ar
6d00: 65 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65  e.  taken..  The
6d10: 20 4d 45 4d 53 59 53 35 20 6d 6f 64 75 6c 65 20   MEMSYS5 module 
6d20: 72 6f 75 6e 64 73 20 61 6c 6c 20 61 6c 6c 6f 63  rounds all alloc
6d30: 61 74 69 6f 6e 73 20 75 70 20 74 6f 20 74 68 65  ations up to the
6d40: 20 6e 65 78 74 20 70 6f 77 65 72 0a 20 20 6f 66   next power.  of
6d50: 20 74 77 6f 20 61 6e 64 20 75 73 65 73 20 61 20   two and uses a 
6d60: 66 69 72 73 74 2d 66 69 74 2c 20 62 75 64 64 79  first-fit, buddy
6d70: 2d 61 6c 6c 6f 63 61 74 6f 72 20 61 6c 67 6f 72  -allocator algor
6d80: 69 74 68 6d 0a 20 20 74 68 61 74 20 70 72 6f 76  ithm.  that prov
6d90: 69 64 65 73 20 73 74 72 6f 6e 67 20 67 75 61 72  ides strong guar
6da0: 61 6e 74 65 65 73 20 61 67 61 69 6e 73 74 20 66  antees against f
6db0: 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64  ragmentation and
6dc0: 20 62 72 65 61 6b 64 6f 77 6e 0a 20 20 73 75 62   breakdown.  sub
6dd0: 6a 65 63 74 20 74 6f 20 63 65 72 74 61 69 6e 20  ject to certain 
6de0: 6f 70 65 72 61 74 69 6e 67 20 63 6f 6e 73 74 72  operating constr
6df0: 61 69 6e 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  aints..}..COMPIL
6e00: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
6e10: 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 7d 20 7b  _ENABLE_RTREE} {
6e20: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
6e30: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
6e40: 69 6e 63 6c 75 64 65 20 73 75 70 70 6f 72 74 20  include support 
6e50: 66 6f 72 20 74 68 65 0a 20 20 5b 72 74 72 65 65  for the.  [rtree
6e60: 20 7c 20 52 2a 54 72 65 65 20 69 6e 64 65 78 20   | R*Tree index 
6e70: 65 78 74 65 6e 73 69 6f 6e 5d 2e 0a 7d 0a 0a 43  extension]..}..C
6e80: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
6e90: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d  QLITE_ENABLE_STM
6ea0: 54 5f 53 43 41 4e 53 54 41 54 55 53 7d 20 7b 0a  T_SCANSTATUS} {.
6eb0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e    This option en
6ec0: 61 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74  ables the [sqlit
6ed0: 65 33 5f 73 74 6d 74 5f 73 63 61 6e 73 74 61 74  e3_stmt_scanstat
6ee0: 75 73 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e  us()] interface.
6ef0: 20 20 54 68 65 0a 20 20 5b 73 71 6c 69 74 65 33    The.  [sqlite3
6f00: 5f 73 74 6d 74 5f 73 63 61 6e 73 74 61 74 75 73  _stmt_scanstatus
6f10: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 69 73  ()] interface is
6f20: 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6d 69 74 74 65   normally omitte
6f30: 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64  d from the build
6f40: 0a 20 20 62 65 63 61 75 73 65 20 69 74 20 69 6d  .  because it im
6f50: 70 6f 73 65 73 20 61 20 73 6d 61 6c 6c 20 70 65  poses a small pe
6f60: 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e 61 6c 74  rformance penalt
6f70: 79 2c 20 65 76 65 6e 20 6f 6e 20 73 74 61 74 65  y, even on state
6f80: 6d 65 6e 74 73 20 74 68 61 74 0a 20 20 64 6f 20  ments that.  do 
6f90: 6e 6f 74 20 75 73 65 20 74 68 65 20 66 65 61 74  not use the feat
6fa0: 75 72 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ure..}..COMPILE_
6fb0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 52  OPTION {SQLITE_R
6fc0: 54 52 45 45 5f 49 4e 54 5f 4f 4e 4c 59 7d 20 7b  TREE_INT_ONLY} {
6fd0: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
6fe0: 6e 20 69 73 20 75 73 65 64 20 74 6f 67 65 74 68  n is used togeth
6ff0: 65 72 20 77 69 74 68 20 5b 53 51 4c 49 54 45 5f  er with [SQLITE_
7000: 45 4e 41 42 4c 45 5f 52 54 52 45 45 5d 20 74 68  ENABLE_RTREE] th
7010: 65 6e 20 74 68 65 0a 20 20 5b 72 74 72 65 65 20  en the.  [rtree 
7020: 7c 20 52 2a 54 72 65 65 20 65 78 74 65 6e 73 69  | R*Tree extensi
7030: 6f 6e 5d 20 77 69 6c 6c 20 6f 6e 6c 79 20 73 74  on] will only st
7040: 6f 72 65 20 33 32 2d 62 69 74 20 73 69 67 6e 65  ore 32-bit signe
7050: 64 20 69 6e 74 65 67 65 72 0a 20 20 63 6f 6f 72  d integer.  coor
7060: 64 69 6e 61 74 65 73 20 61 6e 64 20 61 6c 6c 20  dinates and all 
7070: 69 6e 74 65 72 6e 61 6c 20 63 6f 6d 70 75 74 61  internal computa
7080: 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 64 6f  tions will be do
7090: 6e 65 20 75 73 69 6e 67 20 69 6e 74 65 67 65 72  ne using integer
70a0: 73 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 66  s.  instead of f
70b0: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75  loating point nu
70c0: 6d 62 65 72 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  mbers..}..COMPIL
70d0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
70e0: 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 7d 20  _ENABLE_SQLLOG} 
70f0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
7100: 65 6e 61 62 6c 65 73 20 65 78 74 72 61 20 63 6f  enables extra co
7110: 64 65 20 28 65 73 70 65 63 69 61 6c 6c 79 20 74  de (especially t
7120: 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  he [SQLITE_CONFI
7130: 47 5f 53 51 4c 4c 4f 47 5d 0a 20 20 6f 70 74 69  G_SQLLOG].  opti
7140: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
7150: 6f 6e 66 69 67 28 29 5d 29 20 74 68 61 74 20 63  onfig()]) that c
7160: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72  an be used to cr
7170: 65 61 74 65 20 6c 6f 67 73 20 6f 66 20 61 6c 6c  eate logs of all
7180: 0a 20 20 53 51 4c 69 74 65 20 70 72 6f 63 65 73  .  SQLite proces
7190: 73 69 6e 67 20 70 65 72 66 6f 72 6d 65 64 20 62  sing performed b
71a0: 79 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  y an application
71b0: 2e 20 20 54 68 65 73 65 20 6c 6f 67 73 20 63 61  .  These logs ca
71c0: 6e 20 62 65 20 75 73 65 66 75 6c 0a 20 20 69 6e  n be useful.  in
71d0: 20 64 6f 69 6e 67 20 6f 66 66 2d 6c 69 6e 65 20   doing off-line 
71e0: 61 6e 61 6c 79 73 69 73 20 6f 66 20 74 68 65 20  analysis of the 
71f0: 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 61  behavior of an a
7200: 70 70 6c 69 63 61 74 69 6f 6e 2c 20 61 6e 64 20  pplication, and 
7210: 65 73 70 65 63 69 61 6c 6c 79 0a 20 20 66 6f 72  especially.  for
7220: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e 61   performance ana
7230: 6c 79 73 69 73 2e 20 20 49 6e 20 6f 72 64 65 72  lysis.  In order
7240: 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f   for the SQLITE_
7250: 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70  ENABLE_SQLLOG op
7260: 74 69 6f 6e 20 74 6f 20 0a 20 20 62 65 20 75 73  tion to .  be us
7270: 65 66 75 6c 2c 20 73 6f 6d 65 20 65 78 74 72 61  eful, some extra
7280: 20 63 6f 64 65 20 69 73 20 72 65 71 75 69 72 65   code is require
7290: 64 2e 20 20 54 68 65 20 0a 20 20 3c 61 20 68 72  d.  The .  <a hr
72a0: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73  ef="http://www.s
72b0: 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 64 6f  qlite.org/src/do
72c0: 63 2f 74 72 75 6e 6b 2f 73 72 63 2f 74 65 73 74  c/trunk/src/test
72d0: 5f 73 71 6c 6c 6f 67 2e 63 22 3e 22 74 65 73 74  _sqllog.c">"test
72e0: 5f 73 71 6c 6c 6f 67 2e 63 22 3c 2f 61 3e 0a 20  _sqllog.c"</a>. 
72f0: 20 73 6f 75 72 63 65 20 63 6f 64 65 0a 20 20 66   source code.  f
7300: 69 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 69 74  ile in the SQLit
7310: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73  e source tree is
7320: 20 61 20 77 6f 72 6b 69 6e 67 20 65 78 61 6d 70   a working examp
7330: 6c 65 20 6f 66 20 74 68 65 20 72 65 71 75 69 72  le of the requir
7340: 65 64 20 65 78 74 72 61 0a 20 20 63 6f 64 65 2e  ed extra.  code.
7350: 20 20 4f 6e 20 75 6e 69 78 20 61 6e 64 20 77 69    On unix and wi
7360: 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 2c 20 61  ndows systems, a
7370: 20 64 65 76 65 6c 6f 70 65 72 20 63 61 6e 20 61   developer can a
7380: 70 70 65 6e 64 20 74 68 65 20 74 65 78 74 20 6f  ppend the text o
7390: 66 20 74 68 65 0a 20 20 22 74 65 73 74 5f 73 71  f the.  "test_sq
73a0: 6c 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65 20 63  llog.c" source c
73b0: 6f 64 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20  ode file to the 
73c0: 65 6e 64 20 6f 66 20 61 6e 20 22 73 71 6c 69 74  end of an "sqlit
73d0: 65 33 2e 63 22 20 61 6d 61 6c 67 61 6d 61 74 69  e3.c" amalgamati
73e0: 6f 6e 2c 0a 20 20 72 65 63 6f 6d 70 69 6c 65 20  on,.  recompile 
73f0: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
7400: 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51 4c 49  using the -DSQLI
7410: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47  TE_ENABLE_SQLLOG
7420: 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 0a 20   option, then . 
7430: 20 63 6f 6e 74 72 6f 6c 20 6c 6f 67 67 69 6e 67   control logging
7440: 20 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65   using environme
7450: 6e 74 20 76 61 72 69 61 62 6c 65 73 2e 20 20 53  nt variables.  S
7460: 65 65 20 74 68 65 20 68 65 61 64 65 72 20 63 6f  ee the header co
7470: 6d 6d 65 6e 74 20 6f 6e 20 0a 20 20 74 68 65 20  mment on .  the 
7480: 22 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63 22 20  "test_sqllog.c" 
7490: 73 6f 75 72 63 65 20 66 69 6c 65 20 66 6f 72 20  source file for 
74a0: 61 64 64 69 74 69 6f 6e 61 6c 20 64 65 74 61 69  additional detai
74b0: 6c 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  l.  .}..COMPILE_
74c0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
74d0: 4e 41 42 4c 45 5f 53 54 41 54 32 7d 20 7b 0a 20  NABLE_STAT2} {. 
74e0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 75 73 65   This option use
74f0: 64 20 74 6f 20 63 61 75 73 65 20 74 68 65 20 5b  d to cause the [
7500: 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64  ANALYZE] command
7510: 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20 69 6e   to collect.  in
7520: 64 65 78 20 68 69 73 74 6f 67 72 61 6d 20 64 61  dex histogram da
7530: 74 61 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c  ta in the <b>sql
7540: 69 74 65 5f 73 74 61 74 32 3c 2f 62 3e 20 74 61  ite_stat2</b> ta
7550: 62 6c 65 2e 20 20 42 75 74 20 74 68 61 74 0a 20  ble.  But that. 
7560: 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 77   functionality w
7570: 61 73 20 73 75 70 65 72 63 65 64 65 64 20 62 79  as superceded by
7580: 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   [SQLITE_ENABLE_
7590: 53 54 41 54 33 5d 20 61 73 20 6f 66 0a 20 20 53  STAT3] as of.  S
75a0: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e  QLite version 3.
75b0: 37 2e 39 2e 20 20 54 68 65 20 53 51 4c 49 54 45  7.9.  The SQLITE
75c0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 32 20 63 6f  _ENABLE_STAT2 co
75d0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
75e0: 6e 0a 20 20 69 73 20 6e 6f 77 20 61 20 6e 6f 2d  n.  is now a no-
75f0: 6f 70 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  op..}..COMPILE_O
7600: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
7610: 41 42 4c 45 5f 53 54 41 54 33 7d 20 7b 0a 20 20  ABLE_STAT3} {.  
7620: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73  This option adds
7630: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69   additional logi
7640: 63 20 74 6f 20 74 68 65 20 5b 41 4e 41 4c 59 5a  c to the [ANALYZ
7650: 45 5d 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74  E] command and t
7660: 6f 0a 20 20 74 68 65 20 5b 71 75 65 72 79 20 70  o.  the [query p
7670: 6c 61 6e 6e 65 72 5d 20 74 68 61 74 20 63 61 6e  lanner] that can
7680: 20 68 65 6c 70 20 53 51 4c 69 74 65 20 74 6f 20   help SQLite to 
7690: 63 68 6f 73 65 20 61 20 62 65 74 74 65 72 20 71  chose a better q
76a0: 75 65 72 79 20 70 6c 61 6e 0a 20 20 75 6e 64 65  uery plan.  unde
76b0: 72 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74  r certain situat
76c0: 69 6f 6e 73 2e 20 20 54 68 65 20 5b 41 4e 41 4c  ions.  The [ANAL
76d0: 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  YZE] command is 
76e0: 65 6e 68 61 6e 63 65 64 20 74 6f 20 63 6f 6c 6c  enhanced to coll
76f0: 65 63 74 0a 20 20 68 69 73 74 6f 67 72 61 6d 20  ect.  histogram 
7700: 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 6c 65  data from the le
7710: 66 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f  ft-most column o
7720: 66 20 65 61 63 68 20 69 6e 64 65 78 20 61 6e 64  f each index and
7730: 20 73 74 6f 72 65 20 74 68 61 74 20 64 61 74 61   store that data
7740: 0a 20 20 69 6e 20 74 68 65 20 5b 73 71 6c 69 74  .  in the [sqlit
7750: 65 5f 73 74 61 74 33 5d 20 74 61 62 6c 65 2e 20  e_stat3] table. 
7760: 20 54 68 65 20 71 75 65 72 79 20 70 6c 61 6e 6e   The query plann
7770: 65 72 20 77 69 6c 6c 20 74 68 65 6e 20 75 73 65  er will then use
7780: 20 74 68 65 0a 20 20 68 69 73 74 6f 67 72 61 6d   the.  histogram
7790: 20 64 61 74 61 20 74 6f 20 68 65 6c 70 20 69 74   data to help it
77a0: 20 6d 61 6b 65 20 62 65 74 74 65 72 20 69 6e 64   make better ind
77b0: 65 78 20 63 68 6f 69 63 65 73 2e 20 20 4e 6f 74  ex choices.  Not
77c0: 65 2c 20 68 6f 77 65 76 65 72 2c 0a 20 20 74 68  e, however,.  th
77d0: 61 74 20 74 68 65 20 75 73 65 20 6f 66 20 68 69  at the use of hi
77e0: 73 74 6f 67 72 61 6d 20 64 61 74 61 20 69 6e 20  stogram data in 
77f0: 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20 76 69  query planner vi
7800: 6f 6c 61 74 65 73 20 74 68 65 0a 20 20 5b 71 75  olates the.  [qu
7810: 65 72 79 20 70 6c 61 6e 6e 65 72 20 73 74 61 62  ery planner stab
7820: 69 6c 69 74 79 20 67 75 61 72 61 6e 74 65 65 5d  ility guarantee]
7830: 20 77 68 69 63 68 20 69 73 20 69 6d 70 6f 72 74   which is import
7840: 61 6e 74 20 74 6f 20 73 6f 6d 65 20 61 70 70 6c  ant to some appl
7850: 69 63 61 74 69 6f 6e 73 2e 0a 20 20 3c 70 3e 0a  ications..  <p>.
7860: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
7870: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
7880: 5f 53 54 41 54 34 7d 20 7b 0a 20 20 54 68 69 73  _STAT4} {.  This
7890: 20 6f 70 74 69 6f 6e 20 61 64 64 73 20 61 64 64   option adds add
78a0: 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 74 6f  itional logic to
78b0: 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63   the [ANALYZE] c
78c0: 6f 6d 6d 61 6e 64 20 61 6e 64 20 74 6f 0a 20 20  ommand and to.  
78d0: 74 68 65 20 5b 71 75 65 72 79 20 70 6c 61 6e 6e  the [query plann
78e0: 65 72 5d 20 74 68 61 74 20 63 61 6e 20 68 65 6c  er] that can hel
78f0: 70 20 53 51 4c 69 74 65 20 74 6f 20 63 68 6f 73  p SQLite to chos
7900: 65 20 61 20 62 65 74 74 65 72 20 71 75 65 72 79  e a better query
7910: 20 70 6c 61 6e 0a 20 20 75 6e 64 65 72 20 63 65   plan.  under ce
7920: 72 74 61 69 6e 20 73 69 74 75 61 74 69 6f 6e 73  rtain situations
7930: 2e 20 20 54 68 65 20 5b 41 4e 41 4c 59 5a 45 5d  .  The [ANALYZE]
7940: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 6e 68 61   command is enha
7950: 6e 63 65 64 20 74 6f 20 63 6f 6c 6c 65 63 74 0a  nced to collect.
7960: 20 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61    histogram data
7970: 20 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e   from all column
7980: 73 20 6f 66 20 65 76 65 72 79 20 69 6e 64 65 78  s of every index
7990: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 61 74 20   and store that 
79a0: 64 61 74 61 0a 20 20 69 6e 20 74 68 65 20 5b 73  data.  in the [s
79b0: 71 6c 69 74 65 5f 73 74 61 74 34 5d 20 74 61 62  qlite_stat4] tab
79c0: 6c 65 2e 20 20 54 68 65 20 71 75 65 72 79 20 70  le.  The query p
79d0: 6c 61 6e 6e 65 72 20 77 69 6c 6c 20 74 68 65 6e  lanner will then
79e0: 20 75 73 65 20 74 68 65 0a 20 20 68 69 73 74 6f   use the.  histo
79f0: 67 72 61 6d 20 64 61 74 61 20 74 6f 20 68 65 6c  gram data to hel
7a00: 70 20 69 74 20 6d 61 6b 65 20 62 65 74 74 65 72  p it make better
7a10: 20 69 6e 64 65 78 20 63 68 6f 69 63 65 73 2e 20   index choices. 
7a20: 20 54 68 65 20 64 6f 77 6e 73 69 64 65 20 6f 66   The downside of
7a30: 0a 20 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d  .  this compile-
7a40: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 74  time option is t
7a50: 68 61 74 20 69 74 20 76 69 6f 6c 61 74 65 73 20  hat it violates 
7a60: 74 68 65 0a 20 20 5b 71 75 65 72 79 20 70 6c 61  the.  [query pla
7a70: 6e 6e 65 72 20 73 74 61 62 69 6c 69 74 79 20 67  nner stability g
7a80: 75 61 72 61 6e 74 65 65 5d 20 6d 61 6b 69 6e 67  uarantee] making
7a90: 20 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75   it more difficu
7aa0: 6c 74 20 74 6f 20 65 6e 73 75 72 65 0a 20 20 63  lt to ensure.  c
7ab0: 6f 6e 73 69 73 74 65 6e 74 20 70 65 72 66 6f 72  onsistent perfor
7ac0: 6d 61 6e 63 65 20 69 6e 20 6d 61 73 73 2d 70 72  mance in mass-pr
7ad0: 6f 64 75 63 65 64 20 61 70 70 6c 69 63 61 74 69  oduced applicati
7ae0: 6f 6e 73 2e 0a 20 20 3c 70 3e 0a 20 20 53 51 4c  ons..  <p>.  SQL
7af0: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34  ITE_ENABLE_STAT4
7b00: 20 69 73 20 61 6e 20 65 6e 68 61 6e 63 65 6d 65   is an enhanceme
7b10: 6e 74 20 6f 66 20 5b 53 51 4c 49 54 45 5f 45 4e  nt of [SQLITE_EN
7b20: 41 42 4c 45 5f 53 54 41 54 33 5d 2e 20 20 53 54  ABLE_STAT3].  ST
7b30: 41 54 33 0a 20 20 6f 6e 6c 79 20 72 65 63 6f 72  AT3.  only recor
7b40: 64 65 64 20 68 69 73 74 6f 67 72 61 6d 20 64 61  ded histogram da
7b50: 74 61 20 66 6f 72 20 74 68 65 20 6c 65 66 74 2d  ta for the left-
7b60: 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 65  most column of e
7b70: 61 63 68 20 69 6e 64 65 78 0a 20 20 77 68 65 72  ach index.  wher
7b80: 65 61 73 20 74 68 65 20 53 54 41 54 34 20 65 6e  eas the STAT4 en
7b90: 68 61 6e 63 65 6d 65 6e 74 20 72 65 63 6f 72 64  hancement record
7ba0: 73 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61  s histogram data
7bb0: 20 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e   from all column
7bc0: 73 0a 20 20 6f 66 20 65 61 63 68 20 69 6e 64 65  s.  of each inde
7bd0: 78 2e 0a 20 20 54 68 65 20 5b 53 51 4c 49 54 45  x..  The [SQLITE
7be0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5d 20 63  _ENABLE_STAT3] c
7bf0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
7c00: 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 61 6e  on is a no-op an
7c10: 64 20 69 73 20 69 67 6e 6f 72 65 64 0a 20 20 69  d is ignored.  i
7c20: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41  f the SQLITE_ENA
7c30: 42 4c 45 5f 53 54 41 54 34 20 63 6f 6d 70 69 6c  BLE_STAT4 compil
7c40: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73  e-time option is
7c50: 20 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c   used..}..COMPIL
7c60: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
7c70: 5f 45 4e 41 42 4c 45 5f 54 52 45 45 5f 45 58 50  _ENABLE_TREE_EXP
7c80: 4c 41 49 4e 7d 20 7b 0a 20 20 54 68 69 73 20 63  LAIN} {.  This c
7c90: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
7ca0: 6f 6e 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20  on is no longer 
7cb0: 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  used..}..COMPILE
7cc0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
7cd0: 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f 44 45  ENABLE_UPDATE_DE
7ce0: 4c 45 54 45 5f 4c 49 4d 49 54 7d 20 7b 0a 20 20  LETE_LIMIT} {.  
7cf0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62  This option enab
7d00: 6c 65 73 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20  les an optional 
7d10: 4f 52 44 45 52 20 42 59 20 61 6e 64 20 4c 49 4d  ORDER BY and LIM
7d20: 49 54 20 63 6c 61 75 73 65 20 6f 6e 20 0a 20 20  IT clause on .  
7d30: 5b 55 50 44 41 54 45 5d 20 61 6e 64 20 5b 44 45  [UPDATE] and [DE
7d40: 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e 74 73  LETE] statements
7d50: 2e 0a 0a 20 20 3c 70 3e 49 66 20 74 68 69 73 20  ...  <p>If this 
7d60: 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65  option is define
7d70: 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74 20  d, then it must 
7d80: 61 6c 73 6f 20 62 65 20 0a 20 20 64 65 66 69 6e  also be .  defin
7d90: 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20 74 68  ed when using th
7da0: 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74  e 'lemon' tool t
7db0: 6f 20 67 65 6e 65 72 61 74 65 20 61 20 70 61 72  o generate a par
7dc0: 73 65 2e 63 0a 20 20 66 69 6c 65 2e 20 42 65 63  se.c.  file. Bec
7dd0: 61 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74 68  ause of this, th
7de0: 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 6f 6e  is option may on
7df0: 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 6e 20  ly be used when 
7e00: 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 62  the library is b
7e10: 75 69 6c 74 0a 20 20 66 72 6f 6d 20 73 6f 75 72  uilt.  from sour
7e20: 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68 65  ce, not from the
7e30: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20   [amalgamation] 
7e40: 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c  or from the coll
7e50: 65 63 74 69 6f 6e 20 6f 66 0a 20 20 70 72 65 2d  ection of.  pre-
7e60: 70 61 63 6b 61 67 65 64 20 43 20 66 69 6c 65 73  packaged C files
7e70: 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 6e 6f   provided for no
7e80: 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70 6c 61 74  n-Unix like plat
7e90: 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20 77 65 62  forms on the web
7ea0: 73 69 74 65 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a  site..  </p>.}..
7eb0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
7ec0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 4e  SQLITE_ENABLE_UN
7ed0: 4c 4f 43 4b 5f 4e 4f 54 49 46 59 7d 20 7b 0a 20  LOCK_NOTIFY} {. 
7ee0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61   This option ena
7ef0: 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65  bles the [sqlite
7f00: 33 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28  3_unlock_notify(
7f10: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 61 6e 64  )] interface and
7f20: 0a 20 20 69 74 73 20 61 73 73 6f 63 69 61 74 65  .  its associate
7f30: 64 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e  d functionality.
7f40: 20 20 53 65 65 20 74 68 65 20 64 6f 63 75 6d 65    See the docume
7f50: 6e 74 61 74 69 6f 6e 20 74 69 74 6c 65 64 0a 20  ntation titled. 
7f60: 20 5b 55 73 69 6e 67 20 74 68 65 20 53 51 4c 69   [Using the SQLi
7f70: 74 65 20 55 6e 6c 6f 63 6b 20 4e 6f 74 69 66 69  te Unlock Notifi
7f80: 63 61 74 69 6f 6e 20 46 65 61 74 75 72 65 5d 20  cation Feature] 
7f90: 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 0a 20  for additional. 
7fa0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a   information..}.
7fb0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
7fc0: 7b 53 51 4c 49 54 45 5f 53 4f 55 4e 44 45 58 7d  {SQLITE_SOUNDEX}
7fd0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
7fe0: 20 65 6e 61 62 6c 65 73 20 74 68 65 20 5b 73 6f   enables the [so
7ff0: 75 6e 64 65 78 28 29 20 53 51 4c 20 66 75 6e 63  undex() SQL func
8000: 74 69 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  tion]..}..COMPIL
8010: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8020: 5f 55 53 45 5f 46 43 4e 54 4c 5f 54 52 41 43 45  _USE_FCNTL_TRACE
8030: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
8040: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
8050: 74 6f 20 69 73 73 75 65 20 65 78 74 72 61 20 5b  to issue extra [
8060: 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 54 52 41  SQLITE_FCNTL_TRA
8070: 43 45 5d 20 66 69 6c 65 20 63 6f 6e 74 72 6f 6c  CE] file control
8080: 73 0a 20 20 74 6f 20 70 72 6f 76 69 64 65 20 73  s.  to provide s
8090: 75 70 70 6c 65 6d 65 6e 74 61 72 79 20 69 6e 66  upplementary inf
80a0: 6f 72 6d 61 74 69 6f 6e 20 74 6f 20 74 68 65 20  ormation to the 
80b0: 56 46 53 2e 20 20 54 68 65 20 22 76 66 73 6c 6f  VFS.  The "vfslo
80c0: 67 2e 63 22 20 65 78 74 65 6e 73 69 6f 6e 0a 20  g.c" extension. 
80d0: 20 6d 61 6b 65 73 20 75 73 65 20 6f 66 20 74 68   makes use of th
80e0: 69 73 20 74 6f 20 70 72 6f 76 69 64 65 20 65 6e  is to provide en
80f0: 68 61 6e 63 65 64 20 6c 6f 67 73 20 6f 66 20 56  hanced logs of V
8100: 46 53 20 61 63 74 69 76 69 74 79 2e 0a 7d 0a 0a  FS activity..}..
8110: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
8120: 59 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b 44  YYTRACKMAXSTACKD
8130: 45 50 54 48 7d 20 7b 0a 20 20 54 68 69 73 20 6f  EPTH} {.  This o
8140: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 65  ption causes the
8150: 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72 20   LALR(1) parser 
8160: 73 74 61 63 6b 20 64 65 70 74 68 20 74 6f 20 62  stack depth to b
8170: 65 20 74 72 61 63 6b 65 64 0a 20 20 61 6e 64 20  e tracked.  and 
8180: 72 65 70 6f 72 74 65 64 20 75 73 69 6e 67 20 74  reported using t
8190: 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 74  he [sqlite3_stat
81a0: 75 73 5d 28 5b 53 51 4c 49 54 45 5f 53 54 41 54  us]([SQLITE_STAT
81b0: 55 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b 5d  US_PARSER_STACK]
81c0: 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65 72 66 61 63  ,...).  interfac
81d0: 65 2e 20 20 53 51 4c 69 74 65 27 73 20 4c 41 4c  e.  SQLite's LAL
81e0: 52 28 31 29 20 70 61 72 73 65 72 20 68 61 73 20  R(1) parser has 
81f0: 61 20 66 69 78 65 64 20 73 74 61 63 6b 20 64 65  a fixed stack de
8200: 70 74 68 0a 20 20 28 64 65 74 65 72 6d 69 6e 65  pth.  (determine
8210: 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  d at compile-tim
8220: 65 20 75 73 69 6e 67 20 74 68 65 20 5b 59 59 53  e using the [YYS
8230: 54 41 43 4b 44 45 50 54 48 5d 20 6f 70 74 69 6f  TACKDEPTH] optio
8240: 6e 73 29 2e 0a 20 20 54 68 69 73 20 6f 70 74 69  ns)..  This opti
8250: 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 74  on can be used t
8260: 6f 20 68 65 6c 70 20 64 65 74 65 72 6d 69 6e 65  o help determine
8270: 20 69 66 20 61 6e 20 61 70 70 6c 69 63 61 74 69   if an applicati
8280: 6f 6e 20 69 73 0a 20 20 67 65 74 74 69 6e 67 20  on is.  getting 
8290: 63 6c 6f 73 65 20 74 6f 20 65 78 63 65 65 64 69  close to exceedi
82a0: 6e 67 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 4c  ng the maximum L
82b0: 41 4c 52 28 31 29 20 73 74 61 63 6b 20 64 65 70  ALR(1) stack dep
82c0: 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61  th..}.</tcl>..<a
82d0: 20 6e 61 6d 65 3d 22 64 69 73 61 62 6c 65 66 65   name="disablefe
82e0: 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32  atures"></a>.<h2
82f0: 3e 31 2e 35 20 4f 70 74 69 6f 6e 73 20 54 6f 20  >1.5 Options To 
8300: 44 69 73 61 62 6c 65 20 46 65 61 74 75 72 65 73  Disable Features
8310: 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65 64   Normally Turned
8320: 20 4f 6e 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a   On</h2>..<tcl>.
8330: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
8340: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c  SQLITE_DISABLE_L
8350: 46 53 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  FS} {.  If this 
8360: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d  C-preprocessor m
8370: 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c  acro is defined,
8380: 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 70   large file supp
8390: 6f 72 74 0a 20 20 69 73 20 64 69 73 61 62 6c 65  ort.  is disable
83a0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
83b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53  TION {SQLITE_DIS
83c0: 41 42 4c 45 5f 44 49 52 53 59 4e 43 7d 20 7b 0a  ABLE_DIRSYNC} {.
83d0: 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65 70    If this C-prep
83e0: 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69  rocessor macro i
83f0: 73 20 64 65 66 69 6e 65 64 2c 20 64 69 72 65 63  s defined, direc
8400: 74 6f 72 79 20 73 79 6e 63 73 0a 20 20 61 72 65  tory syncs.  are
8410: 20 64 69 73 61 62 6c 65 64 2e 20 20 53 51 4c 69   disabled.  SQLi
8420: 74 65 20 74 79 70 69 63 61 6c 6c 79 20 61 74 74  te typically att
8430: 65 6d 70 74 73 20 74 6f 20 73 79 6e 63 20 74 68  empts to sync th
8440: 65 20 70 61 72 65 6e 74 0a 20 20 64 69 72 65 63  e parent.  direc
8450: 74 6f 72 79 20 77 68 65 6e 20 61 20 66 69 6c 65  tory when a file
8460: 20 69 73 20 64 65 6c 65 74 65 64 20 74 6f 20 65   is deleted to e
8470: 6e 73 75 72 65 20 74 68 65 20 64 69 72 65 63 74  nsure the direct
8480: 6f 72 79 0a 20 20 65 6e 74 72 69 65 73 20 61 72  ory.  entries ar
8490: 65 20 75 70 64 61 74 65 64 20 69 6d 6d 65 64 69  e updated immedi
84a0: 61 74 65 6c 79 20 6f 6e 20 64 69 73 6b 2e 0a 7d  ately on disk..}
84b0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
84c0: 20 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45   {SQLITE_DISABLE
84d0: 5f 46 54 53 33 5f 55 4e 49 43 4f 44 45 7d 20 7b  _FTS3_UNICODE} {
84e0: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
84f0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
8500: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
8510: 5b 75 6e 69 63 6f 64 65 36 31 5d 20 74 6f 6b 65  [unicode61] toke
8520: 6e 69 7a 65 72 0a 20 20 69 6e 20 5b 46 54 53 33  nizer.  in [FTS3
8530: 5d 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f  ] is omitted fro
8540: 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64 20  m the build and 
8550: 69 73 20 75 6e 61 76 61 69 6c 61 62 6c 65 20 74  is unavailable t
8560: 6f 20 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e  o .  application
8570: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
8580: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53  TION {SQLITE_DIS
8590: 41 42 4c 45 5f 46 54 53 34 5f 44 45 46 45 52 52  ABLE_FTS4_DEFERR
85a0: 45 44 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  ED} {.  If this 
85b0: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d  C-preprocessor m
85c0: 61 63 72 6f 20 64 69 73 61 62 6c 65 73 20 74 68  acro disables th
85d0: 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b 65  e "deferred toke
85e0: 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a  n" optimization.
85f0: 20 20 69 6e 20 5b 46 54 53 34 5d 2e 20 20 54 68    in [FTS4].  Th
8600: 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b 65  e "deferred toke
8610: 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  n" optimization 
8620: 61 76 6f 69 64 73 20 6c 6f 61 64 69 6e 67 20 6d  avoids loading m
8630: 61 73 73 69 76 65 0a 20 20 70 6f 73 74 69 6e 67  assive.  posting
8640: 20 6c 69 73 74 73 20 66 6f 72 20 74 65 72 6d 73   lists for terms
8650: 20 74 68 61 74 20 61 72 65 20 69 6e 20 6d 6f 73   that are in mos
8660: 74 20 64 6f 63 75 6d 65 6e 74 73 20 6f 66 20 74  t documents of t
8670: 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 0a 20 20  he collection.  
8680: 61 6e 64 20 69 6e 73 74 65 61 64 20 73 69 6d 70  and instead simp
8690: 6c 79 20 73 63 61 6e 73 20 66 6f 72 20 74 68 6f  ly scans for tho
86a0: 73 65 20 74 6f 6b 65 6e 73 20 69 6e 20 74 68 65  se tokens in the
86b0: 20 64 6f 63 75 6d 65 6e 74 20 73 6f 75 72 63 65   document source
86c0: 2e 20 20 5b 46 54 53 34 5d 0a 20 20 73 68 6f 75  .  [FTS4].  shou
86d0: 6c 64 20 67 65 74 20 65 78 61 63 74 6c 79 20 74  ld get exactly t
86e0: 68 65 20 73 61 6d 65 20 61 6e 73 77 65 72 20 62  he same answer b
86f0: 6f 74 68 20 77 69 74 68 20 61 6e 64 20 77 69 74  oth with and wit
8700: 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6d 69  hout this optimi
8710: 7a 61 74 69 6f 6e 2e 0a 7d 0a 3c 2f 74 63 6c 3e  zation..}.</tcl>
8720: 0a 0a 3c 74 63 6c 3e 0a 20 20 68 64 5f 66 72 61  ..<tcl>.  hd_fra
8730: 67 6d 65 6e 74 20 22 6f 6d 69 74 66 65 61 74 75  gment "omitfeatu
8740: 72 65 73 22 0a 20 20 68 64 5f 6b 65 79 77 6f 72  res".  hd_keywor
8750: 64 73 20 22 6f 6d 69 74 66 65 61 74 75 72 65 73  ds "omitfeatures
8760: 22 0a 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 31 2e 36  ".</tcl>.<h2>1.6
8770: 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d 69 74   Options To Omit
8780: 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e 0a 0a   Features</h2>..
8790: 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  <p>The following
87a0: 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 65 20   options can be 
87b0: 75 73 65 64 20 74 6f 20 0a 5b 72 65 6c 66 6f 6f  used to .[relfoo
87c0: 74 70 72 69 6e 74 20 7c 20 72 65 64 75 63 65 20  tprint | reduce 
87d0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
87e0: 63 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72 79  compiled library
87f0: 5d 0a 62 79 20 6f 6d 69 74 74 69 6e 67 20 75 6e  ].by omitting un
8800: 75 73 65 64 20 66 65 61 74 75 72 65 73 2e 20 54  used features. T
8810: 68 69 73 20 69 73 20 70 72 6f 62 61 62 6c 79 20  his is probably 
8820: 6f 6e 6c 79 20 75 73 65 66 75 6c 0a 69 6e 20 65  only useful.in e
8830: 6d 62 65 64 64 65 64 20 73 79 73 74 65 6d 73 20  mbedded systems 
8840: 77 68 65 72 65 20 73 70 61 63 65 20 69 73 20 65  where space is e
8850: 73 70 65 63 69 61 6c 6c 79 20 74 69 67 68 74 2c  specially tight,
8860: 20 61 73 20 65 76 65 6e 20 77 69 74 68 20 61 6c   as even with al
8870: 6c 0a 66 65 61 74 75 72 65 73 20 69 6e 63 6c 75  l.features inclu
8880: 64 65 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c  ded the SQLite l
8890: 69 62 72 61 72 79 20 69 73 20 72 65 6c 61 74 69  ibrary is relati
88a0: 76 65 6c 79 20 73 6d 61 6c 6c 2e 20 44 6f 6e 27  vely small. Don'
88b0: 74 20 66 6f 72 67 65 74 0a 74 6f 20 74 65 6c 6c  t forget.to tell
88c0: 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 74   your compiler t
88d0: 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20 62  o optimize for b
88e0: 69 6e 61 72 79 20 73 69 7a 65 21 20 28 74 68 65  inary size! (the
88f0: 20 2d 4f 73 20 6f 70 74 69 6f 6e 20 69 66 0a 75   -Os option if.u
8900: 73 69 6e 67 20 47 43 43 29 2e 20 20 54 65 6c 6c  sing GCC).  Tell
8910: 69 6e 67 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65  ing your compile
8920: 72 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f  r to optimize fo
8930: 72 20 73 69 7a 65 20 75 73 75 61 6c 6c 79 20 68  r size usually h
8940: 61 73 0a 61 20 6d 75 63 68 20 6c 61 72 67 65 72  as.a much larger
8950: 20 69 6d 70 61 63 74 20 6f 6e 20 6c 69 62 72 61   impact on libra
8960: 72 79 20 66 6f 6f 74 70 72 69 6e 74 20 74 68 61  ry footprint tha
8970: 6e 20 65 6d 70 6c 6f 79 69 6e 67 20 61 6e 79 20  n employing any 
8980: 6f 66 20 74 68 65 73 65 0a 63 6f 6d 70 69 6c 65  of these.compile
8990: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 20 20  -time options.  
89a0: 59 6f 75 20 73 68 6f 75 6c 64 20 61 6c 73 6f 20  You should also 
89b0: 76 65 72 69 66 79 20 74 68 61 74 20 0a 3c 61 20  verify that .<a 
89c0: 68 72 65 66 3d 22 23 64 65 62 75 67 6f 70 74 69  href="#debugopti
89d0: 6f 6e 73 22 3e 64 65 62 75 67 67 69 6e 67 20 6f  ons">debugging o
89e0: 70 74 69 6f 6e 73 3c 2f 61 3e 20 61 72 65 20 64  ptions</a> are d
89f0: 69 73 61 62 6c 65 64 2e 3c 2f 70 3e 0a 0a 3c 70  isabled.</p>..<p
8a00: 3e 54 68 65 20 6d 61 63 72 6f 73 20 69 6e 20 74  >The macros in t
8a10: 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 20 6e  his section do n
8a20: 6f 74 20 72 65 71 75 69 72 65 20 76 61 6c 75 65  ot require value
8a30: 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  s. The following
8a40: 20 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 73 77   .compilation sw
8a50: 69 74 63 68 65 73 20 61 6c 6c 20 68 61 76 65 20  itches all have 
8a60: 74 68 65 20 73 61 6d 65 20 65 66 66 65 63 74 3a  the same effect:
8a70: 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d  <br>.-DSQLITE_OM
8a80: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3c 62 72  IT_ALTERTABLE<br
8a90: 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  >.-DSQLITE_OMIT_
8aa0: 41 4c 54 45 52 54 41 42 4c 45 3d 31 3c 62 72 3e  ALTERTABLE=1<br>
8ab0: 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  .-DSQLITE_OMIT_A
8ac0: 4c 54 45 52 54 41 42 4c 45 3d 30 0a 3c 2f 70 3e  LTERTABLE=0.</p>
8ad0: 0a 0a 3c 70 3e 49 66 20 61 6e 79 20 6f 66 20 74  ..<p>If any of t
8ae0: 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 61 72 65  hese options are
8af0: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74   defined, then t
8b00: 68 65 20 73 61 6d 65 20 73 65 74 20 6f 66 20 53  he same set of S
8b10: 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 0a 6f 70 74  QLITE_OMIT_*.opt
8b20: 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73 6f 20 62  ions must also b
8b30: 65 20 64 65 66 69 6e 65 64 20 77 68 65 6e 20 75  e defined when u
8b40: 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f 6e 27  sing the 'lemon'
8b50: 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72 61 74   tool to generat
8b60: 65 20 74 68 65 0a 70 61 72 73 65 2e 63 20 66 69  e the.parse.c fi
8b70: 6c 65 20 61 6e 64 20 77 68 65 6e 20 63 6f 6d 70  le and when comp
8b80: 69 6c 69 6e 67 20 74 68 65 20 27 6d 6b 6b 65 79  iling the 'mkkey
8b90: 77 6f 72 64 68 61 73 68 27 20 74 6f 6f 6c 20 77  wordhash' tool w
8ba0: 68 69 63 68 20 67 65 6e 65 72 61 74 65 73 20 0a  hich generates .
8bb0: 74 68 65 20 6b 65 79 77 6f 72 64 68 61 73 68 2e  the keywordhash.
8bc0: 68 20 66 69 6c 65 2e 0a 42 65 63 61 75 73 65 20  h file..Because 
8bd0: 6f 66 20 74 68 69 73 2c 20 74 68 65 73 65 20 6f  of this, these o
8be0: 70 74 69 6f 6e 73 20 6d 61 79 20 6f 6e 6c 79 20  ptions may only 
8bf0: 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65  be used when the
8c00: 20 6c 69 62 72 61 72 79 20 69 73 20 62 75 69 6c   library is buil
8c10: 74 0a 66 72 6f 6d 20 63 61 6e 6f 6e 69 63 61 6c  t.from canonical
8c20: 20 73 6f 75 72 63 65 2c 20 6e 6f 74 20 66 72 6f   source, not fro
8c30: 6d 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74  m the [amalgamat
8c40: 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d 20 74 68 65  ion] or from the
8c50: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a 70   collection of.p
8c60: 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20 66 69  re-packaged C fi
8c70: 6c 65 73 20 70 72 6f 76 69 64 65 64 20 66 6f 72  les provided for
8c80: 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70   non-Unix like p
8c90: 6c 61 74 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20  latforms on the 
8ca0: 77 65 62 73 69 74 65 2e 0a 41 6e 79 20 53 51 4c  website..Any SQL
8cb0: 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f  ITE_OMIT_* optio
8cc0: 6e 73 20 77 68 69 63 68 20 63 61 6e 20 62 65 20  ns which can be 
8cd0: 75 73 65 64 20 64 69 72 65 63 74 6c 79 20 77 69  used directly wi
8ce0: 74 68 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61  th the [amalgama
8cf0: 74 69 6f 6e 5d 20 0a 61 72 65 20 6c 69 73 74 65  tion] .are liste
8d00: 64 20 62 65 6c 6f 77 2c 20 68 6f 77 65 76 65 72  d below, however
8d10: 2c 20 74 68 65 20 77 61 72 6e 69 6e 67 73 20 69  , the warnings i
8d20: 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  n the following 
8d30: 70 61 72 61 67 72 61 70 68 20 73 68 6f 75 6c 64  paragraph should
8d40: 20 62 65 20 6e 6f 74 65 64 2e 0a 3c 2f 70 3e 0a   be noted..</p>.
8d50: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 69  .<blockquote>.<i
8d60: 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e 74 20 4e 6f  ><b>Important No
8d70: 74 65 3a 3c 2f 62 3e 20 54 68 65 20 53 51 4c 49  te:</b> The SQLI
8d80: 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e  TE_OMIT_* option
8d90: 73 20 64 6f 20 6e 6f 74 20 77 6f 72 6b 20 77 69  s do not work wi
8da0: 74 68 20 74 68 65 0a 5b 61 6d 61 6c 67 61 6d 61  th the.[amalgama
8db0: 74 69 6f 6e 5d 20 6f 72 20 77 69 74 68 20 70 72  tion] or with pr
8dc0: 65 2d 70 61 63 6b 61 67 65 64 20 43 20 63 6f 64  e-packaged C cod
8dd0: 65 20 66 69 6c 65 73 2e 20 20 53 51 4c 49 54 45  e files.  SQLITE
8de0: 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d  _OMIT_* compile-
8df0: 74 69 6d 65 0a 6f 70 74 69 6f 6e 73 20 6f 6e 6c  time.options onl
8e00: 79 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79  y work correctly
8e10: 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73 20   when SQLite is 
8e20: 62 75 69 6c 74 20 66 72 6f 6d 20 63 61 6e 6f 6e  built from canon
8e30: 69 63 61 6c 20 73 6f 75 72 63 65 20 66 69 6c 65  ical source file
8e40: 73 2e 0a 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71  s..</i>.</blockq
8e50: 75 6f 74 65 3e 0a 0a 0a 3c 70 3e 53 70 65 63 69  uote>...<p>Speci
8e60: 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74  al versions of t
8e70: 68 65 20 53 51 4c 69 74 65 20 61 6d 61 6c 67 61  he SQLite amalga
8e80: 6d 61 74 69 6f 6e 20 74 68 61 74 20 64 6f 20 77  mation that do w
8e90: 6f 72 6b 20 77 69 74 68 20 61 0a 70 72 65 64 65  ork with a.prede
8ea0: 74 65 72 6d 69 6e 65 64 20 73 65 74 20 6f 66 20  termined set of 
8eb0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70  SQLITE_OMIT_* op
8ec0: 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 67 65 6e  tions can be gen
8ed0: 65 72 61 74 65 64 2e 20 20 54 6f 20 64 6f 20 73  erated.  To do s
8ee0: 6f 2c 0a 6d 61 6b 65 20 61 20 63 6f 70 79 20 6f  o,.make a copy o
8ef0: 66 20 74 68 65 20 4d 61 6b 65 66 69 6c 65 2e 6c  f the Makefile.l
8f00: 69 6e 75 78 2d 67 63 63 20 6d 61 6b 65 66 69 6c  inux-gcc makefil
8f10: 65 20 74 65 6d 70 6c 61 74 65 20 69 6e 20 74 68  e template in th
8f20: 65 20 63 61 6e 6f 6e 69 63 61 6c 0a 73 6f 75 72  e canonical.sour
8f30: 63 65 20 63 6f 64 65 20 64 69 73 74 72 69 62 75  ce code distribu
8f40: 74 69 6f 6e 2e 20 20 43 68 61 6e 67 65 20 74 68  tion.  Change th
8f50: 65 20 6e 61 6d 65 20 6f 66 20 79 6f 75 72 20 63  e name of your c
8f60: 6f 70 79 20 74 6f 20 73 69 6d 70 6c 79 20 22 4d  opy to simply "M
8f70: 61 6b 65 66 69 6c 65 22 2e 0a 54 68 65 6e 20 65  akefile"..Then e
8f80: 64 69 74 20 22 4d 61 6b 65 66 69 6c 65 22 20 74  dit "Makefile" t
8f90: 6f 20 73 65 74 20 75 70 20 61 70 70 72 6f 70 72  o set up appropr
8fa0: 69 61 74 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  iate compile-tim
8fb0: 65 20 6f 70 74 69 6f 6e 73 2e 20 20 54 68 65 6e  e options.  Then
8fc0: 0a 74 79 70 65 3a 0a 3c 62 6c 6f 63 6b 71 75 6f  .type:.<blockquo
8fd0: 74 65 3e 3c 74 74 3e 6d 61 6b 65 20 63 6c 65 61  te><tt>make clea
8fe0: 6e 3b 20 6d 61 6b 65 20 73 71 6c 69 74 65 33 2e  n; make sqlite3.
8ff0: 63 3c 2f 74 74 3e 3c 2f 62 6c 6f 63 6b 71 75 6f  c</tt></blockquo
9000: 74 65 3e 0a 54 68 65 20 72 65 73 75 6c 74 69 6e  te>.The resultin
9010: 67 20 22 73 71 6c 69 74 65 33 2e 63 22 20 61 6d  g "sqlite3.c" am
9020: 61 6c 67 61 6d 61 74 69 6f 6e 20 63 6f 64 65 20  algamation code 
9030: 66 69 6c 65 20 28 61 6e 64 20 69 74 73 20 61 73  file (and its as
9040: 73 6f 63 69 61 74 65 64 0a 68 65 61 64 65 72 20  sociated.header 
9050: 66 69 6c 65 20 22 73 71 6c 69 74 65 33 2e 68 22  file "sqlite3.h"
9060: 29 20 63 61 6e 20 74 68 65 6e 20 62 65 20 6d 6f  ) can then be mo
9070: 76 65 64 20 74 6f 20 61 20 6e 6f 6e 2d 75 6e 69  ved to a non-uni
9080: 78 20 70 6c 61 74 66 6f 72 6d 0a 66 6f 72 20 66  x platform.for f
9090: 69 6e 61 6c 20 63 6f 6d 70 69 6c 61 74 69 6f 6e  inal compilation
90a0: 20 75 73 69 6e 67 20 61 20 6e 61 74 69 76 65 20   using a native 
90b0: 63 6f 6d 70 69 6c 65 72 2e 3c 2f 70 3e 0a 0a 3c  compiler.</p>..<
90c0: 70 3e 41 6c 6c 20 6f 66 20 74 68 65 20 53 51 4c  p>All of the SQL
90d0: 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f  ITE_OMIT_* optio
90e0: 6e 73 20 61 72 65 20 75 6e 73 75 70 70 6f 72 74  ns are unsupport
90f0: 65 64 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71  ed.</p>..<blockq
9100: 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e 49 6d 70 6f  uote>.<i><b>Impo
9110: 72 74 61 6e 74 20 4e 6f 74 65 3a 3c 2f 62 3e 0a  rtant Note:</b>.
9120: 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  The SQLITE_OMIT_
9130: 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  * compile-time o
9140: 70 74 69 6f 6e 73 20 61 72 65 20 75 6e 73 75 70  ptions are unsup
9150: 70 6f 72 74 65 64 2e 0a 3c 2f 69 3e 3c 2f 62 6c  ported..</i></bl
9160: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54  ockquote>..<p>.T
9170: 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a  he SQLITE_OMIT_*
9180: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
9190: 74 69 6f 6e 73 20 61 72 65 20 75 73 75 61 6c 6c  tions are usuall
91a0: 79 20 75 6e 74 65 73 74 65 64 20 61 6e 64 0a 61  y untested and.a
91b0: 72 65 20 61 6c 6d 6f 73 74 20 63 65 72 74 61 69  re almost certai
91c0: 6e 6c 79 20 75 6e 74 65 73 74 65 64 20 69 6e 20  nly untested in 
91d0: 63 6f 6d 62 69 6e 61 74 69 6f 6e 2e 0a 41 6e 79  combination..Any
91e0: 20 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 73 65   or all of these
91f0: 20 6f 70 74 69 6f 6e 73 20 6d 61 79 20 62 65 20   options may be 
9200: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65  removed from the
9210: 20 63 6f 64 65 20 69 6e 20 66 75 74 75 72 65 20   code in future 
9220: 72 65 6c 65 61 73 65 73 0a 61 6e 64 20 77 69 74  releases.and wit
9230: 68 6f 75 74 20 77 61 72 6e 69 6e 67 2e 20 20 46  hout warning.  F
9240: 6f 72 20 61 6e 79 20 70 61 72 74 69 63 75 6c 61  or any particula
9250: 72 20 72 65 6c 65 61 73 65 2c 20 73 6f 6d 65 20  r release, some 
9260: 6f 66 20 74 68 65 73 65 0a 6f 70 74 69 6f 6e 73  of these.options
9270: 20 6d 61 79 20 63 61 75 73 65 20 63 6f 6d 70 69   may cause compi
9280: 6c 65 2d 74 69 6d 65 20 6f 72 20 72 75 6e 2d 74  le-time or run-t
9290: 69 6d 65 20 66 61 69 6c 75 72 65 73 2c 20 70 61  ime failures, pa
92a0: 72 74 69 63 75 6c 61 72 6c 79 0a 77 68 65 6e 20  rticularly.when 
92b0: 75 73 65 64 20 69 6e 20 63 6f 6d 62 69 6e 61 74  used in combinat
92c0: 69 6f 6e 20 77 69 74 68 20 6f 74 68 65 72 20 6f  ion with other o
92d0: 70 74 69 6f 6e 73 2e 3c 2f 70 3e 0a 0a 3c 74 63  ptions.</p>..<tc
92e0: 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  l>.COMPILE_OPTIO
92f0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
9300: 4c 54 45 52 54 41 42 4c 45 7d 20 7b 0a 20 20 57  LTERTABLE} {.  W
9310: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
9320: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
9330: 0a 20 20 5b 41 4c 54 45 52 20 54 41 42 4c 45 5d  .  [ALTER TABLE]
9340: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20   command is not 
9350: 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20  included in the 
9360: 0a 20 20 6c 69 62 72 61 72 79 2e 20 45 78 65 63  .  library. Exec
9370: 75 74 69 6e 67 20 61 6e 20 5b 41 4c 54 45 52 20  uting an [ALTER 
9380: 54 41 42 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74  TABLE] statement
9390: 20 63 61 75 73 65 73 20 61 20 70 61 72 73 65 20   causes a parse 
93a0: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
93b0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
93c0: 5f 4f 4d 49 54 5f 41 4e 41 4c 59 5a 45 7d 20 7b  _OMIT_ANALYZE} {
93d0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
93e0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
93f0: 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f  the [ANALYZE] co
9400: 6d 6d 61 6e 64 20 69 73 20 6f 6d 69 74 74 65 64  mmand is omitted
9410: 20 66 72 6f 6d 0a 20 20 74 68 65 20 62 75 69 6c   from.  the buil
9420: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
9430: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
9440: 54 5f 41 54 54 41 43 48 7d 20 7b 0a 20 20 57 68  T_ATTACH} {.  Wh
9450: 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  en this option i
9460: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b  s defined, the [
9470: 41 54 54 41 43 48 5d 20 61 6e 64 20 5b 44 45 54  ATTACH] and [DET
9480: 41 43 48 5d 20 63 6f 6d 6d 61 6e 64 73 20 61 72  ACH] commands ar
9490: 65 0a 20 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d  e.  omitted from
94a0: 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43   the build..}..C
94b0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
94c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f  QLITE_OMIT_AUTHO
94d0: 52 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 44 65  RIZATION} {.  De
94e0: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
94f0: 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 61 75 74  on omits the aut
9500: 68 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62  horization callb
9510: 61 63 6b 20 66 65 61 74 75 72 65 20 66 72 6f 6d  ack feature from
9520: 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20   the.  library. 
9530: 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 65 74  The [sqlite3_set
9540: 5f 61 75 74 68 6f 72 69 7a 65 72 28 29 5d 20 41  _authorizer()] A
9550: 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e  PI function is n
9560: 6f 74 20 70 72 65 73 65 6e 74 0a 20 20 69 6e 20  ot present.  in 
9570: 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a  the library..}..
9580: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9590: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
95a0: 49 4e 43 52 45 4d 45 4e 54 7d 20 7b 0a 20 20 54  INCREMENT} {.  T
95b0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
95c0: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a  ed to omit the .
95d0: 20 20 5b 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54    [AUTOINCREMENT
95e0: 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e  ] functionality.
95f0: 20 57 68 65 6e 20 74 68 69 73 20 0a 20 20 69 73   When this .  is
9600: 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65   macro is define
9610: 64 2c 20 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61  d, columns decla
9620: 72 65 64 20 61 73 20 0a 20 20 22 5b 49 4e 54 45  red as .  "[INTE
9630: 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 5d  GER PRIMARY KEY]
9640: 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 22 0a   AUTOINCREMENT".
9650: 20 20 62 65 68 61 76 65 20 69 6e 20 74 68 65 20    behave in the 
9660: 73 61 6d 65 20 77 61 79 20 61 73 20 63 6f 6c 75  same way as colu
9670: 6d 6e 73 20 64 65 63 6c 61 72 65 64 20 61 73 20  mns declared as 
9680: 22 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52  "[INTEGER PRIMAR
9690: 59 20 4b 45 59 5d 22 20 77 68 65 6e 20 61 20 0a  Y KEY]" when a .
96a0: 20 20 4e 55 4c 4c 20 69 73 20 69 6e 73 65 72 74    NULL is insert
96b0: 65 64 2e 20 54 68 65 20 73 71 6c 69 74 65 5f 73  ed. The sqlite_s
96c0: 65 71 75 65 6e 63 65 20 73 79 73 74 65 6d 20 74  equence system t
96d0: 61 62 6c 65 20 69 73 20 6e 65 69 74 68 65 72 20  able is neither 
96e0: 63 72 65 61 74 65 64 2c 20 6e 6f 72 0a 20 20 72  created, nor.  r
96f0: 65 73 70 65 63 74 65 64 20 69 66 20 69 74 20 61  espected if it a
9700: 6c 72 65 61 64 79 20 65 78 69 73 74 73 2e 0a 7d  lready exists..}
9710: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
9720: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55   {SQLITE_OMIT_AU
9730: 54 4f 49 4e 49 54 7d 20 7b 0a 20 20 46 6f 72 20  TOINIT} {.  For 
9740: 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74  backwards compat
9750: 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c 64  ibility with old
9760: 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53  er versions of S
9770: 51 4c 69 74 65 20 74 68 61 74 20 6c 61 63 6b 0a  QLite that lack.
9780: 20 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 69    the [sqlite3_i
9790: 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 69 6e 74  nitialize()] int
97a0: 65 72 66 61 63 65 2c 20 74 68 65 20 5b 73 71 6c  erface, the [sql
97b0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28  ite3_initialize(
97c0: 29 5d 20 69 6e 74 65 72 66 61 63 65 0a 20 20 69  )] interface.  i
97d0: 73 20 63 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74  s called automat
97e0: 69 63 61 6c 6c 79 20 75 70 6f 6e 20 65 6e 74 72  ically upon entr
97f0: 79 20 74 6f 20 63 65 72 74 61 69 6e 20 6b 65 79  y to certain key
9800: 20 69 6e 74 65 72 66 61 63 65 73 20 73 75 63 68   interfaces such
9810: 20 61 73 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f   as.  [sqlite3_o
9820: 70 65 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33  pen()], [sqlite3
9830: 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 5d  _vfs_register()]
9840: 2c 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6d  , and [sqlite3_m
9850: 70 72 69 6e 74 66 28 29 5d 2e 0a 20 20 54 68 65  printf()]..  The
9860: 20 6f 76 65 72 68 65 61 64 20 6f 66 20 69 6e 76   overhead of inv
9870: 6f 6b 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 69  oking [sqlite3_i
9880: 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 61 75 74  nitialize()] aut
9890: 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 74 68  omatically in th
98a0: 69 73 0a 20 20 77 61 79 20 6d 61 79 20 62 65 20  is.  way may be 
98b0: 6f 6d 69 74 74 65 64 20 62 79 20 62 75 69 6c 64  omitted by build
98c0: 69 6e 67 20 53 51 4c 69 74 65 20 77 69 74 68 20  ing SQLite with 
98d0: 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  the SQLITE_OMIT_
98e0: 41 55 54 4f 49 4e 49 54 0a 20 20 43 2d 70 72 65  AUTOINIT.  C-pre
98f0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e  processor macro.
9900: 20 20 57 68 65 6e 20 62 75 69 6c 74 20 75 73 69    When built usi
9910: 6e 67 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ng SQLITE_OMIT_A
9920: 55 54 4f 49 4e 49 54 2c 20 53 51 4c 69 74 65 0a  UTOINIT, SQLite.
9930: 20 20 77 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 6d    will not autom
9940: 61 74 69 63 61 6c 6c 79 20 69 6e 69 74 69 61 6c  atically initial
9950: 69 7a 65 20 69 74 73 65 6c 66 20 61 6e 64 20 74  ize itself and t
9960: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69  he application i
9970: 73 20 72 65 71 75 69 72 65 64 0a 20 20 74 6f 20  s required.  to 
9980: 69 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f  invoke [sqlite3_
9990: 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 64 69  initialize()] di
99a0: 72 65 63 74 6c 79 20 70 72 69 6f 72 20 74 6f 20  rectly prior to 
99b0: 62 65 67 69 6e 6e 69 6e 67 20 75 73 65 20 6f 66  beginning use of
99c0: 20 74 68 65 0a 20 20 53 51 4c 69 74 65 20 6c 69   the.  SQLite li
99d0: 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  brary..}..COMPIL
99e0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
99f0: 5f 4f 4d 49 54 5f 41 55 54 4f 4d 41 54 49 43 5f  _OMIT_AUTOMATIC_
9a00: 49 4e 44 45 58 7d 20 7b 0a 20 20 54 68 69 73 20  INDEX} {.  This 
9a10: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74  option is used t
9a20: 6f 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b 61  o omit the .  [a
9a30: 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 69 6e  utomatic indexin
9a40: 67 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  g] functionality
9a50: 2e 0a 20 20 53 65 65 20 61 6c 73 6f 3a 20 5b 53  ..  See also: [S
9a60: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55  QLITE_DEFAULT_AU
9a70: 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 5d 2e 0a  TOMATIC_INDEX]..
9a80: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
9a90: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
9aa0: 55 54 4f 52 45 53 45 54 7d 20 7b 0a 20 20 42 79  UTORESET} {.  By
9ab0: 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20 5b 73   default, the [s
9ac0: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 5d 20 69  qlite3_step()] i
9ad0: 6e 74 65 72 66 61 63 65 20 77 69 6c 6c 20 61 75  nterface will au
9ae0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f  tomatically invo
9af0: 6b 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 72 65  ke.  [sqlite3_re
9b00: 73 65 74 28 29 5d 20 74 6f 20 72 65 73 65 74 20  set()] to reset 
9b10: 74 68 65 20 5b 70 72 65 70 61 72 65 64 20 73 74  the [prepared st
9b20: 61 74 65 6d 65 6e 74 5d 20 69 66 20 6e 65 63 65  atement] if nece
9b30: 73 73 61 72 79 2e 20 20 54 68 69 73 0a 20 20 63  ssary.  This.  c
9b40: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
9b50: 6f 6e 20 63 68 61 6e 67 65 73 20 74 68 61 74 20  on changes that 
9b60: 62 65 68 61 76 69 6f 72 20 73 6f 20 74 68 61 74  behavior so that
9b70: 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29   [sqlite3_step()
9b80: 5d 20 77 69 6c 6c 0a 20 20 72 65 74 75 72 6e 20  ] will.  return 
9b90: 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d 20  [SQLITE_MISUSE] 
9ba0: 69 66 20 69 74 20 63 61 6c 6c 65 64 20 61 67 61  if it called aga
9bb0: 69 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e 69  in after returni
9bc0: 6e 67 20 61 6e 79 74 68 69 6e 67 20 6f 74 68 65  ng anything othe
9bd0: 72 0a 20 20 74 68 61 6e 20 5b 53 51 4c 49 54 45  r.  than [SQLITE
9be0: 5f 52 4f 57 5d 2c 20 5b 53 51 4c 49 54 45 5f 42  _ROW], [SQLITE_B
9bf0: 55 53 59 5d 2c 20 6f 72 20 5b 53 51 4c 49 54 45  USY], or [SQLITE
9c00: 5f 4c 4f 43 4b 45 44 5d 20 75 6e 6c 65 73 73 20  _LOCKED] unless 
9c10: 74 68 65 72 65 20 77 61 73 20 61 6e 0a 20 20 69  there was an.  i
9c20: 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c 20  ntervening call 
9c30: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 65  to [sqlite3_rese
9c40: 74 28 29 5d 2e 0a 0a 20 20 49 6e 20 53 51 4c 69  t()]...  In SQLi
9c50: 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e 32  te version 3.6.2
9c60: 33 2e 31 20 61 6e 64 20 65 61 72 6c 69 65 72 2c  3.1 and earlier,
9c70: 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29   [sqlite3_step()
9c80: 5d 20 75 73 65 64 20 74 6f 20 61 6c 77 61 79 73  ] used to always
9c90: 0a 20 20 72 65 74 75 72 6e 20 5b 53 51 4c 49 54  .  return [SQLIT
9ca0: 45 5f 4d 49 53 55 53 45 5d 20 69 66 20 69 74 20  E_MISUSE] if it 
9cb0: 77 61 73 20 69 6e 76 6f 6b 65 64 20 61 67 61 69  was invoked agai
9cc0: 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e 69 6e  n after returnin
9cd0: 67 20 61 6e 79 74 68 69 6e 67 0a 20 20 6f 74 68  g anything.  oth
9ce0: 65 72 20 74 68 61 6e 20 5b 53 51 4c 49 54 45 5f  er than [SQLITE_
9cf0: 52 4f 57 5d 20 77 69 74 68 6f 75 74 20 61 6e 20  ROW] without an 
9d00: 69 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c  intervening call
9d10: 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65 73   to [sqlite3_res
9d20: 65 74 28 29 5d 2e 0a 20 20 54 68 69 73 20 63 61  et()]..  This ca
9d30: 75 73 65 64 20 70 72 6f 62 6c 65 6d 73 20 6f 6e  used problems on
9d40: 20 73 6f 6d 65 20 70 6f 6f 72 6c 79 20 77 72 69   some poorly wri
9d50: 74 74 65 6e 20 73 6d 61 72 74 70 68 6f 6e 65 20  tten smartphone 
9d60: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 77 68 69  applications whi
9d70: 63 68 0a 20 20 64 69 64 20 6e 6f 74 20 63 6f 72  ch.  did not cor
9d80: 72 65 63 74 6c 79 20 68 61 6e 64 6c 65 20 74 68  rectly handle th
9d90: 65 20 5b 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  e [SQLITE_LOCKED
9da0: 5d 20 61 6e 64 20 5b 53 51 4c 49 54 45 5f 42 55  ] and [SQLITE_BU
9db0: 53 59 5d 20 65 72 72 6f 72 20 0a 20 20 72 65 74  SY] error .  ret
9dc0: 75 72 6e 73 2e 20 20 52 61 74 68 65 72 20 74 68  urns.  Rather th
9dd0: 61 6e 20 66 69 78 20 74 68 65 20 6d 61 6e 79 20  an fix the many 
9de0: 64 65 66 65 63 74 69 76 65 20 73 6d 61 72 74 70  defective smartp
9df0: 68 6f 6e 65 20 61 70 70 6c 69 63 61 74 69 6f 6e  hone application
9e00: 73 2c 20 0a 20 20 74 68 65 20 62 65 68 61 76 69  s, .  the behavi
9e10: 6f 72 20 6f 66 20 53 51 4c 69 74 65 20 77 61 73  or of SQLite was
9e20: 20 63 68 61 6e 67 65 64 20 69 6e 20 33 2e 36 2e   changed in 3.6.
9e30: 32 33 2e 32 20 74 6f 20 61 75 74 6f 6d 61 74 69  23.2 to automati
9e40: 63 61 6c 6c 79 20 72 65 73 65 74 0a 20 20 74 68  cally reset.  th
9e50: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  e prepared state
9e60: 6d 65 6e 74 2e 20 20 42 75 74 20 74 68 61 74 20  ment.  But that 
9e70: 63 68 61 6e 67 65 64 20 63 61 75 73 65 64 20 69  changed caused i
9e80: 73 73 75 65 73 20 69 6e 20 6f 74 68 65 72 20 0a  ssues in other .
9e90: 20 20 69 6d 70 72 6f 70 65 72 6c 79 20 69 6d 70    improperly imp
9ea0: 6c 65 6d 65 6e 74 65 64 20 61 70 70 6c 69 63 61  lemented applica
9eb0: 74 69 6f 6e 73 20 74 68 61 74 20 77 65 72 65 20  tions that were 
9ec0: 61 63 74 75 61 6c 6c 79 20 6c 6f 6f 6b 69 6e 67  actually looking
9ed0: 0a 20 20 66 6f 72 20 61 6e 20 5b 53 51 4c 49 54  .  for an [SQLIT
9ee0: 45 5f 4d 49 53 55 53 45 5d 20 72 65 74 75 72 6e  E_MISUSE] return
9ef0: 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 20 74 68   to terminate th
9f00: 65 69 72 20 71 75 65 72 79 20 6c 6f 6f 70 73 2e  eir query loops.
9f10: 20 20 28 41 6e 79 74 69 6d 65 0a 20 20 61 6e 20    (Anytime.  an 
9f20: 61 70 70 6c 69 63 61 74 69 6f 6e 20 67 65 74 73  application gets
9f30: 20 61 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53   an SQLITE_MISUS
9f40: 45 20 65 72 72 6f 72 20 63 6f 64 65 20 66 72 6f  E error code fro
9f50: 6d 20 53 51 4c 69 74 65 2c 20 74 68 61 74 20 6d  m SQLite, that m
9f60: 65 61 6e 73 20 74 68 65 0a 20 20 61 70 70 6c 69  eans the.  appli
9f70: 63 61 74 69 6f 6e 20 69 73 20 6d 69 73 75 73 69  cation is misusi
9f80: 6e 67 20 74 68 65 20 53 51 4c 69 74 65 20 69 6e  ng the SQLite in
9f90: 74 65 72 66 61 63 65 20 61 6e 64 20 69 73 20 74  terface and is t
9fa0: 68 75 73 20 69 6e 63 6f 72 72 65 63 74 6c 79 0a  hus incorrectly.
9fb0: 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2e 29 20    implemented.) 
9fc0: 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54   The SQLITE_OMIT
9fd0: 5f 41 55 54 4f 52 45 53 45 54 20 69 6e 74 65 72  _AUTORESET inter
9fe0: 66 61 63 65 20 77 61 73 20 61 64 64 65 64 20 74  face was added t
9ff0: 6f 20 53 51 4c 69 74 65 0a 20 20 76 65 72 73 69  o SQLite.  versi
a000: 6f 6e 20 33 2e 37 2e 35 20 69 6e 20 61 6e 20 65  on 3.7.5 in an e
a010: 66 66 6f 72 74 20 74 6f 20 67 65 74 20 61 6c 6c  ffort to get all
a020: 20 6f 66 20 74 68 65 20 28 62 72 6f 6b 65 6e 29   of the (broken)
a030: 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  .  applications 
a040: 74 6f 20 77 6f 72 6b 20 61 67 61 69 6e 20 77 69  to work again wi
a050: 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20  thout having to 
a060: 61 63 74 75 61 6c 6c 79 20 66 69 78 20 74 68 65  actually fix the
a070: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d   applications..}
a080: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
a090: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55   {SQLITE_OMIT_AU
a0a0: 54 4f 56 41 43 55 55 4d 7d 20 7b 0a 20 20 49 66  TOVACUUM} {.  If
a0b0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
a0c0: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69 62  defined, the lib
a0d0: 72 61 72 79 20 63 61 6e 6e 6f 74 20 63 72 65 61  rary cannot crea
a0e0: 74 65 20 6f 72 20 77 72 69 74 65 20 74 6f 20 0a  te or write to .
a0f0: 20 20 64 61 74 61 62 61 73 65 73 20 74 68 61 74    databases that
a100: 20 73 75 70 70 6f 72 74 20 5b 61 75 74 6f 5f 76   support [auto_v
a110: 61 63 75 75 6d 5d 2e 0a 20 20 45 78 65 63 75 74  acuum]..  Execut
a120: 69 6e 67 20 61 20 5b 50 52 41 47 4d 41 20 61 75  ing a [PRAGMA au
a130: 74 6f 5f 76 61 63 75 75 6d 5d 20 73 74 61 74 65  to_vacuum] state
a140: 6d 65 6e 74 20 69 73 20 6e 6f 74 20 61 6e 20 65  ment is not an e
a150: 72 72 6f 72 0a 20 20 28 73 69 6e 63 65 20 75 6e  rror.  (since un
a160: 6b 6e 6f 77 6e 20 50 52 41 47 4d 41 73 20 61 72  known PRAGMAs ar
a170: 65 20 73 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72  e silently ignor
a180: 65 64 29 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f  ed), but does no
a190: 74 20 72 65 74 75 72 6e 20 61 20 76 61 6c 75 65  t return a value
a1a0: 0a 20 20 6f 72 20 6d 6f 64 69 66 79 20 74 68 65  .  or modify the
a1b0: 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 66 6c 61   auto-vacuum fla
a1c0: 67 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  g in the databas
a1d0: 65 20 66 69 6c 65 2e 20 49 66 20 61 20 64 61 74  e file. If a dat
a1e0: 61 62 61 73 65 20 74 68 61 74 0a 20 20 73 75 70  abase that.  sup
a1f0: 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 75 75  ports auto-vacuu
a200: 6d 20 69 73 20 6f 70 65 6e 65 64 20 62 79 20 61  m is opened by a
a210: 20 6c 69 62 72 61 72 79 20 63 6f 6d 70 69 6c 65   library compile
a220: 64 20 77 69 74 68 20 74 68 69 73 20 6f 70 74 69  d with this opti
a230: 6f 6e 2c 20 69 74 0a 20 20 69 73 20 61 75 74 6f  on, it.  is auto
a240: 6d 61 74 69 63 61 6c 6c 79 20 6f 70 65 6e 65 64  matically opened
a250: 20 69 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 6f   in read-only mo
a260: 64 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  de..}..COMPILE_O
a270: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a280: 49 54 5f 42 45 54 57 45 45 4e 5f 4f 50 54 49 4d  IT_BETWEEN_OPTIM
a290: 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69  IZATION} {.  Thi
a2a0: 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65  s option disable
a2b0: 73 20 74 68 65 20 75 73 65 20 6f 66 20 69 6e 64  s the use of ind
a2c0: 69 63 65 73 20 77 69 74 68 20 57 48 45 52 45 20  ices with WHERE 
a2d0: 63 6c 61 75 73 65 20 74 65 72 6d 73 0a 20 20 74  clause terms.  t
a2e0: 68 61 74 20 65 6d 70 6c 6f 79 20 74 68 65 20 42  hat employ the B
a2f0: 45 54 57 45 45 4e 20 6f 70 65 72 61 74 6f 72 2e  ETWEEN operator.
a300: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
a310: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
a320: 42 4c 4f 42 5f 4c 49 54 45 52 41 4c 7d 20 7b 0a  BLOB_LITERAL} {.
a330: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
a340: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 69  on is defined, i
a350: 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c  t is not possibl
a360: 65 20 74 6f 20 73 70 65 63 69 66 79 20 61 20 62  e to specify a b
a370: 6c 6f 62 20 69 6e 0a 20 20 61 6e 20 53 51 4c 20  lob in.  an SQL 
a380: 73 74 61 74 65 6d 65 6e 74 20 75 73 69 6e 67 20  statement using 
a390: 74 68 65 20 58 27 41 42 43 44 27 20 73 79 6e 74  the X'ABCD' synt
a3a0: 61 78 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ax..}..COMPILE_O
a3b0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a3c0: 49 54 5f 42 54 52 45 45 43 4f 55 4e 54 7d 20 7b  IT_BTREECOUNT} {
a3d0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
a3e0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
a3f0: 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  an optimization 
a400: 74 68 61 74 20 61 63 63 65 6c 65 72 61 74 65 73  that accelerates
a410: 20 63 6f 75 6e 74 69 6e 67 0a 20 20 61 6c 6c 20   counting.  all 
a420: 65 6e 74 72 69 65 73 20 69 6e 20 61 20 74 61 62  entries in a tab
a430: 6c 65 20 28 69 6e 20 6f 74 68 65 72 20 77 6f 72  le (in other wor
a440: 64 73 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74  ds, an optimizat
a450: 69 6f 6e 20 74 68 61 74 20 68 65 6c 70 73 0a 20  ion that helps. 
a460: 20 22 53 45 4c 45 43 54 20 63 6f 75 6e 74 28 2a   "SELECT count(*
a470: 29 20 46 52 4f 4d 20 74 61 62 6c 65 22 20 72 75  ) FROM table" ru
a480: 6e 20 66 61 73 74 65 72 29 20 69 73 20 6f 6d 69  n faster) is omi
a490: 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tted..}..COMPILE
a4a0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a4b0: 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53  OMIT_BUILTIN_TES
a4c0: 54 7d 20 7b 0a 20 20 41 20 73 74 61 6e 64 61 72  T} {.  A standar
a4d0: 64 20 53 51 4c 69 74 65 20 62 75 69 6c 64 20 69  d SQLite build i
a4e0: 6e 63 6c 75 64 65 73 20 61 20 73 6d 61 6c 6c 20  ncludes a small 
a4f0: 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67 69 63 20  amount of logic 
a500: 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20 62 79 20  controlled.  by 
a510: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 65 73  the [sqlite3_tes
a520: 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d 20 69 6e 74  t_control()] int
a530: 65 72 66 61 63 65 20 74 68 61 74 20 69 73 20 75  erface that is u
a540: 73 65 64 20 74 6f 20 65 78 65 72 63 69 73 65 0a  sed to exercise.
a550: 20 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 53    parts of the S
a560: 51 4c 69 74 65 20 63 6f 72 65 20 74 68 61 74 20  QLite core that 
a570: 61 72 65 20 64 69 66 66 69 63 75 6c 74 20 74 6f  are difficult to
a580: 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20 6d 65 61   control and mea
a590: 73 75 72 65 20 75 73 69 6e 67 0a 20 20 74 68 65  sure using.  the
a5a0: 20 73 74 61 6e 64 61 72 64 20 41 50 49 2e 20 20   standard API.  
a5b0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
a5c0: 73 20 74 68 61 74 20 62 75 69 6c 74 2d 69 6e 20  s that built-in 
a5d0: 74 65 73 74 20 6c 6f 67 69 63 2e 0a 7d 0a 0a 43  test logic..}..C
a5e0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
a5f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 41 53 54 7d  QLITE_OMIT_CAST}
a600: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
a610: 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20 74   causes SQLite t
a620: 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66  o omit support f
a630: 6f 72 20 74 68 65 20 43 41 53 54 20 6f 70 65 72  or the CAST oper
a640: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
a650: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a660: 4f 4d 49 54 5f 43 48 45 43 4b 7d 20 7b 0a 20 20  OMIT_CHECK} {.  
a670: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
a680: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69  es SQLite to omi
a690: 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 43 48  t support for CH
a6a0: 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e  ECK constraints.
a6b0: 0a 20 20 54 68 65 20 70 61 72 73 65 72 20 77 69  .  The parser wi
a6c0: 6c 6c 20 73 74 69 6c 6c 20 61 63 63 65 70 74 20  ll still accept 
a6d0: 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74  CHECK constraint
a6e0: 73 20 69 6e 20 53 51 4c 20 73 74 61 74 65 6d 65  s in SQL stateme
a6f0: 6e 74 73 2c 0a 20 20 74 68 65 79 20 77 69 6c 6c  nts,.  they will
a700: 20 6a 75 73 74 20 6e 6f 74 20 62 65 20 65 6e 66   just not be enf
a710: 6f 72 63 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  orced..}..COMPIL
a720: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a730: 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 54  _OMIT_COMPILEOPT
a740: 49 4f 4e 5f 44 49 41 47 53 7d 20 7b 0a 20 20 54  ION_DIAGS} {.  T
a750: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
a760: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63  ed to omit the c
a770: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
a780: 6f 6e 20 64 69 61 67 6e 6f 73 74 69 63 73 20 61  on diagnostics a
a790: 76 61 69 6c 61 62 6c 65 0a 20 20 69 6e 20 53 51  vailable.  in SQ
a7a0: 4c 69 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20  Lite, including 
a7b0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d  the [sqlite3_com
a7c0: 70 69 6c 65 6f 70 74 69 6f 6e 5f 75 73 65 64 28  pileoption_used(
a7d0: 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65  )] and.  [sqlite
a7e0: 33 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f  3_compileoption_
a7f0: 67 65 74 28 29 5d 20 43 2f 43 2b 2b 20 66 75 6e  get()] C/C++ fun
a800: 63 74 69 6f 6e 73 2c 20 74 68 65 0a 20 20 5b 73  ctions, the.  [s
a810: 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f 70 74  qlite_compileopt
a820: 69 6f 6e 5f 75 73 65 64 28 29 5d 20 61 6e 64 20  ion_used()] and 
a830: 5b 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f  [sqlite_compileo
a840: 70 74 69 6f 6e 5f 67 65 74 28 29 5d 20 53 51 4c  ption_get()] SQL
a850: 20 66 75 6e 63 74 69 6f 6e 73 2c 0a 20 20 61 6e   functions,.  an
a860: 64 20 74 68 65 20 5b 63 6f 6d 70 69 6c 65 5f 6f  d the [compile_o
a870: 70 74 69 6f 6e 73 20 70 72 61 67 6d 61 5d 2e 0a  ptions pragma]..
a880: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
a890: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
a8a0: 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69  OMPLETE} {.  Thi
a8b0: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
a8c0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d  the [sqlite3_com
a8d0: 70 6c 65 74 65 28 29 5d 20 61 6e 64 20 5b 73 71  plete()] and [sq
a8e0: 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31 36  lite3_complete16
a8f0: 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 65 73  ()].  interfaces
a900: 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a   to be omitted..
a910: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
a920: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
a930: 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 7d 20  OMPOUND_SELECT} 
a940: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
a950: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20  is used to omit 
a960: 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 5b 53 45  the compound [SE
a970: 4c 45 43 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c  LECT] functional
a980: 69 74 79 2e 20 0a 20 20 5b 53 45 4c 45 43 54 5d  ity. .  [SELECT]
a990: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
a9a0: 20 75 73 65 20 74 68 65 20 0a 20 20 55 4e 49 4f   use the .  UNIO
a9b0: 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20 49 4e  N, UNION ALL, IN
a9c0: 54 45 52 53 45 43 54 20 6f 72 20 45 58 43 45 50  TERSECT or EXCEP
a9d0: 54 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43  T compound SELEC
a9e0: 54 20 6f 70 65 72 61 74 6f 72 73 20 77 69 6c 6c  T operators will
a9f0: 20 0a 20 20 63 61 75 73 65 20 61 20 70 61 72 73   .  cause a pars
aa00: 65 20 65 72 72 6f 72 2e 0a 0a 20 20 41 6e 20 5b  e error...  An [
aa10: 49 4e 53 45 52 54 5d 20 73 74 61 74 65 6d 65 6e  INSERT] statemen
aa20: 74 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 20  t with multiple 
aa30: 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 56 41  values in the VA
aa40: 4c 55 45 53 20 63 6c 61 75 73 65 20 69 73 0a 20  LUES clause is. 
aa50: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 74   implemented int
aa60: 65 72 6e 61 6c 6c 79 20 61 73 20 61 20 63 6f 6d  ernally as a com
aa70: 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e 20 20 48  pound SELECT.  H
aa80: 65 6e 63 65 2c 20 74 68 69 73 20 6f 70 74 69 6f  ence, this optio
aa90: 6e 20 61 6c 73 6f 0a 20 20 64 69 73 61 62 6c 65  n also.  disable
aaa0: 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f  s the ability to
aab0: 20 69 6e 73 65 72 74 20 6d 6f 72 65 20 74 68 61   insert more tha
aac0: 6e 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 75  n a single row u
aad0: 73 69 6e 67 20 61 6e 0a 20 20 49 4e 53 45 52 54  sing an.  INSERT
aae0: 20 49 4e 54 4f 20 2e 2e 2e 20 56 41 4c 55 45 53   INTO ... VALUES
aaf0: 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2e 0a   ... statement..
ab00: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
ab10: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
ab20: 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  TE} {.  This opt
ab30: 69 6f 6e 20 63 61 75 73 65 73 20 73 75 70 70 6f  ion causes suppo
ab40: 72 74 20 66 6f 72 20 5b 63 6f 6d 6d 6f 6e 20 74  rt for [common t
ab50: 61 62 6c 65 20 65 78 70 72 65 73 73 69 6f 6e 73  able expressions
ab60: 5d 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e  ] to be omitted.
ab70: 0a 7d 0a 0a 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  .}....COMPILE_OP
ab80: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
ab90: 54 5f 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53  T_DATETIME_FUNCS
aba0: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70  } {.  If this op
abb0: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
abc0: 20 53 51 4c 69 74 65 27 73 20 62 75 69 6c 74 2d   SQLite's built-
abd0: 69 6e 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65  in date and time
abe0: 20 6d 61 6e 69 70 75 6c 61 74 69 6f 6e 0a 20 20   manipulation.  
abf0: 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d  functions are om
ac00: 69 74 74 65 64 2e 20 53 70 65 63 69 66 69 63 61  itted. Specifica
ac10: 6c 6c 79 2c 20 74 68 65 20 53 51 4c 20 66 75 6e  lly, the SQL fun
ac20: 63 74 69 6f 6e 73 20 6a 75 6c 69 61 6e 64 61 79  ctions julianday
ac30: 28 29 2c 20 64 61 74 65 28 29 2c 0a 20 20 74 69  (), date(),.  ti
ac40: 6d 65 28 29 2c 20 64 61 74 65 74 69 6d 65 28 29  me(), datetime()
ac50: 20 61 6e 64 20 73 74 72 66 74 69 6d 65 28 29 20   and strftime() 
ac60: 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c  are not availabl
ac70: 65 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 63  e. The default c
ac80: 6f 6c 75 6d 6e 0a 20 20 76 61 6c 75 65 73 20 43  olumn.  values C
ac90: 55 52 52 45 4e 54 5f 54 49 4d 45 2c 20 43 55 52  URRENT_TIME, CUR
aca0: 52 45 4e 54 5f 44 41 54 45 20 61 6e 64 20 43 55  RENT_DATE and CU
acb0: 52 52 45 4e 54 5f 54 49 4d 45 53 54 41 4d 50 20  RRENT_TIMESTAMP 
acc0: 61 72 65 20 73 74 69 6c 6c 20 61 76 61 69 6c 61  are still availa
acd0: 62 6c 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ble..}..COMPILE_
ace0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
acf0: 4d 49 54 5f 44 45 43 4c 54 59 50 45 7d 20 7b 0a  MIT_DECLTYPE} {.
ad00: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
ad10: 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f  uses SQLite to o
ad20: 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20  mit support for 
ad30: 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63  the.  [sqlite3_c
ad40: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 29  olumn_decltype()
ad50: 5d 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 63  ] and [sqlite3_c
ad60: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36  olumn_decltype16
ad70: 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 65 73  ()].  interfaces
ad80: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
ad90: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
ada0: 5f 44 45 50 52 45 43 41 54 45 44 7d 20 7b 0a 20  _DEPRECATED} {. 
adb0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
adc0: 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d  ses SQLite to om
add0: 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 69  it support for i
ade0: 6e 74 65 72 66 61 63 65 73 0a 20 20 6d 61 72 6b  nterfaces.  mark
adf0: 65 64 20 61 73 20 64 65 70 72 65 63 61 74 65 64  ed as deprecated
ae00: 2e 20 20 54 68 69 73 20 69 6e 63 6c 75 64 65 73  .  This includes
ae10: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 61 67 67   .  [sqlite3_agg
ae20: 72 65 67 61 74 65 5f 63 6f 75 6e 74 28 29 5d 2c  regate_count()],
ae30: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 65 78 70 69  .  [sqlite3_expi
ae40: 72 65 64 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74  red()],.  [sqlit
ae50: 65 33 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64  e3_transfer_bind
ae60: 69 6e 67 73 28 29 5d 2c 0a 20 20 5b 73 71 6c 69  ings()],.  [sqli
ae70: 74 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76  te3_global_recov
ae80: 65 72 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65  er()],.  [sqlite
ae90: 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 70  3_thread_cleanup
aea0: 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74  ()] and.  [sqlit
aeb0: 65 33 5f 6d 65 6d 6f 72 79 5f 61 6c 61 72 6d 28  e3_memory_alarm(
aec0: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d  )] interfaces..}
aed0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
aee0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49   {SQLITE_OMIT_DI
aef0: 53 4b 49 4f 7d 20 7b 0a 20 20 54 68 69 73 20 6f  SKIO} {.  This o
af00: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 61 6c 6c 20  ption omits all 
af10: 73 75 70 70 6f 72 74 20 66 6f 72 20 77 72 69 74  support for writ
af20: 69 6e 67 20 74 6f 20 74 68 65 20 64 69 73 6b 20  ing to the disk 
af30: 61 6e 64 20 66 6f 72 63 65 73 0a 20 20 64 61 74  and forces.  dat
af40: 61 62 61 73 65 73 20 74 6f 20 65 78 69 73 74 20  abases to exist 
af50: 69 6e 20 6d 65 6d 6f 72 79 20 6f 6e 6c 79 2e 20  in memory only. 
af60: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73   This option has
af70: 20 6e 6f 74 20 62 65 65 6e 20 0a 20 20 6d 61 69   not been .  mai
af80: 6e 74 61 69 6e 65 64 20 61 6e 64 20 70 72 6f 62  ntained and prob
af90: 61 62 6c 79 20 64 6f 65 73 20 6e 6f 74 20 77 6f  ably does not wo
afa0: 72 6b 20 77 69 74 68 20 6e 65 77 65 72 20 76 65  rk with newer ve
afb0: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
afc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
afd0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
afe0: 5f 45 58 50 4c 41 49 4e 7d 20 7b 0a 20 20 44 65  _EXPLAIN} {.  De
aff0: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
b000: 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20 5b 45  on causes the [E
b010: 58 50 4c 41 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20  XPLAIN] command 
b020: 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72  to be omitted fr
b030: 6f 6d 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79  om the.  library
b040: 2e 20 41 74 74 65 6d 70 74 69 6e 67 20 74 6f 20  . Attempting to 
b050: 65 78 65 63 75 74 65 20 61 6e 20 5b 45 58 50 4c  execute an [EXPL
b060: 41 49 4e 5d 20 73 74 61 74 65 6d 65 6e 74 20 77  AIN] statement w
b070: 69 6c 6c 20 63 61 75 73 65 20 61 20 70 61 72 73  ill cause a pars
b080: 65 0a 20 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  e.  error..}..CO
b090: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
b0a0: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 41 47 5f 50  LITE_OMIT_FLAG_P
b0b0: 52 41 47 4d 41 53 7d 20 7b 0a 20 20 54 68 69 73  RAGMAS} {.  This
b0c0: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75   option omits su
b0d0: 70 70 6f 72 74 20 66 6f 72 20 61 20 73 75 62 73  pport for a subs
b0e0: 65 74 20 6f 66 20 5b 50 52 41 47 4d 41 5d 20 63  et of [PRAGMA] c
b0f0: 6f 6d 6d 61 6e 64 73 20 74 68 61 74 0a 20 20 71  ommands that.  q
b100: 75 65 72 79 20 61 6e 64 20 73 65 74 20 62 6f 6f  uery and set boo
b110: 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 65 73 2e  lean properties.
b120: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b130: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b140: 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 7d 20  FLOATING_POINT} 
b150: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
b160: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20  is used to omit 
b170: 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 20 6e  floating-point n
b180: 75 6d 62 65 72 20 73 75 70 70 6f 72 74 20 66 72  umber support fr
b190: 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 0a 20 20  om the SQLite.  
b1a0: 6c 69 62 72 61 72 79 2e 20 57 68 65 6e 20 73 70  library. When sp
b1b0: 65 63 69 66 69 65 64 2c 20 73 70 65 63 69 66 79  ecified, specify
b1c0: 69 6e 67 20 61 20 66 6c 6f 61 74 69 6e 67 20 70  ing a floating p
b1d0: 6f 69 6e 74 20 6e 75 6d 62 65 72 20 61 73 20 61  oint number as a
b1e0: 20 6c 69 74 65 72 61 6c 20 0a 20 20 28 69 2e 65   literal .  (i.e
b1f0: 2e 20 22 31 2e 30 31 22 29 20 72 65 73 75 6c 74  . "1.01") result
b200: 73 20 69 6e 20 61 20 70 61 72 73 65 20 65 72 72  s in a parse err
b210: 6f 72 2e 0a 0a 20 20 3c 70 3e 49 6e 20 74 68 65  or...  <p>In the
b220: 20 66 75 74 75 72 65 2c 20 74 68 69 73 20 6f 70   future, this op
b230: 74 69 6f 6e 20 6d 61 79 20 61 6c 73 6f 20 64 69  tion may also di
b240: 73 61 62 6c 65 20 6f 74 68 65 72 20 66 6c 6f 61  sable other floa
b250: 74 69 6e 67 20 70 6f 69 6e 74 20 0a 20 20 66 75  ting point .  fu
b260: 6e 63 74 69 6f 6e 61 6c 69 74 79 2c 20 66 6f 72  nctionality, for
b270: 20 65 78 61 6d 70 6c 65 20 74 68 65 20 5b 73 71   example the [sq
b280: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75  lite3_result_dou
b290: 62 6c 65 28 29 5d 2c 20 0a 20 20 5b 73 71 6c 69  ble()], .  [sqli
b2a0: 74 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28  te3_bind_double(
b2b0: 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 76 61 6c  )], [sqlite3_val
b2c0: 75 65 5f 64 6f 75 62 6c 65 28 29 5d 20 61 6e 64  ue_double()] and
b2d0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  .  [sqlite3_colu
b2e0: 6d 6e 5f 64 6f 75 62 6c 65 28 29 5d 20 41 50 49  mn_double()] API
b2f0: 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 20 20 3c 2f   functions..  </
b300: 70 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  p>.}..COMPILE_OP
b310: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
b320: 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 7d 20 7b  T_FOREIGN_KEY} {
b330: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
b340: 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68  n is defined, th
b350: 65 6e 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20  en [foreign key 
b360: 63 6f 6e 73 74 72 61 69 6e 74 5d 20 73 79 6e 74  constraint] synt
b370: 61 78 20 69 73 0a 20 20 6e 6f 74 20 72 65 63 6f  ax is.  not reco
b380: 67 6e 69 7a 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  gnized..}..COMPI
b390: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
b3a0: 45 5f 4f 4d 49 54 5f 47 45 54 5f 54 41 42 4c 45  E_OMIT_GET_TABLE
b3b0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
b3c0: 6e 20 63 61 75 73 65 73 20 73 75 70 70 6f 72 74  n causes support
b3d0: 20 66 6f 72 20 5b 73 71 6c 69 74 65 33 5f 67 65   for [sqlite3_ge
b3e0: 74 5f 74 61 62 6c 65 28 29 5d 20 61 6e 64 0a 20  t_table()] and. 
b3f0: 20 5b 73 71 6c 69 74 65 33 5f 66 72 65 65 5f 74   [sqlite3_free_t
b400: 61 62 6c 65 28 29 5d 20 74 6f 20 62 65 20 6f 6d  able()] to be om
b410: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
b420: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
b430: 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 7d 20  _OMIT_INCRBLOB} 
b440: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
b450: 63 61 75 73 65 73 20 73 75 70 70 6f 72 74 20 66  causes support f
b460: 6f 72 20 5b 73 71 6c 69 74 65 33 5f 62 6c 6f 62  or [sqlite3_blob
b470: 20 7c 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 42   | incremental B
b480: 4c 4f 42 20 49 2f 4f 5d 0a 20 20 74 6f 20 62 65  LOB I/O].  to be
b490: 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d   omitted..}..COM
b4a0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
b4b0: 49 54 45 5f 4f 4d 49 54 5f 49 4e 54 45 47 52 49  ITE_OMIT_INTEGRI
b4c0: 54 59 5f 43 48 45 43 4b 7d 20 7b 0a 20 20 54 68  TY_CHECK} {.  Th
b4d0: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
b4e0: 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20  support for the 
b4f0: 5b 69 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b  [integrity_check
b500: 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d   pragma]..}..COM
b510: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
b520: 49 54 45 5f 4f 4d 49 54 5f 4c 49 4b 45 5f 4f 50  ITE_OMIT_LIKE_OP
b530: 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20  TIMIZATION} {.  
b540: 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61  This option disa
b550: 62 6c 65 73 20 74 68 65 20 61 62 69 6c 69 74 79  bles the ability
b560: 20 6f 66 20 53 51 4c 69 74 65 20 74 6f 20 75 73   of SQLite to us
b570: 65 20 69 6e 64 69 63 65 73 20 74 6f 20 68 65 6c  e indices to hel
b580: 70 0a 20 20 72 65 73 6f 6c 76 65 20 5b 4c 49 4b  p.  resolve [LIK
b590: 45 5d 20 61 6e 64 20 5b 47 4c 4f 42 5d 20 6f 70  E] and [GLOB] op
b5a0: 65 72 61 74 6f 72 73 20 69 6e 20 61 20 57 48 45  erators in a WHE
b5b0: 52 45 20 63 6c 61 75 73 65 2e 0a 7d 0a 0a 43 4f  RE clause..}..CO
b5c0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
b5d0: 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45  LITE_OMIT_LOAD_E
b5e0: 58 54 45 4e 53 49 4f 4e 7d 20 7b 0a 20 20 54 68  XTENSION} {.  Th
b5f0: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
b600: 74 68 65 20 65 6e 74 69 72 65 20 65 78 74 65 6e  the entire exten
b610: 73 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 6d 65 63  sion loading mec
b620: 68 61 6e 69 73 6d 20 66 72 6f 6d 0a 20 20 53 51  hanism from.  SQ
b630: 4c 69 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20  Lite, including 
b640: 5b 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f  [sqlite3_enable_
b650: 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 29  load_extension()
b660: 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33  ] and.  [sqlite3
b670: 5f 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28  _load_extension(
b680: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d  )] interfaces..}
b690: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
b6a0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f   {SQLITE_OMIT_LO
b6b0: 43 41 4c 54 49 4d 45 7d 20 7b 0a 20 20 54 68 69  CALTIME} {.  Thi
b6c0: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74  s option omits t
b6d0: 68 65 20 22 6c 6f 63 61 6c 74 69 6d 65 22 20 6d  he "localtime" m
b6e0: 6f 64 69 66 69 65 72 20 66 72 6f 6d 20 74 68 65  odifier from the
b6f0: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 0a 20   date and time. 
b700: 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 69   functions.  Thi
b710: 73 20 6f 70 74 69 6f 6e 20 69 73 20 73 6f 6d 65  s option is some
b720: 74 69 6d 65 73 20 75 73 65 66 75 6c 20 77 68 65  times useful whe
b730: 6e 20 74 72 79 69 6e 67 20 74 6f 20 63 6f 6d 70  n trying to comp
b740: 69 6c 65 0a 20 20 74 68 65 20 64 61 74 65 20 61  ile.  the date a
b750: 6e 64 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e  nd time function
b760: 73 20 6f 6e 20 61 20 70 6c 61 74 66 6f 72 6d 20  s on a platform 
b770: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75  that does not su
b780: 70 70 6f 72 74 20 74 68 65 0a 20 20 63 6f 6e 63  pport the.  conc
b790: 65 70 74 20 6f 66 20 6c 6f 63 61 6c 20 74 69 6d  ept of local tim
b7a0: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
b7b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
b7c0: 54 5f 4c 4f 4f 4b 41 53 49 44 45 7d 20 7b 0a 20  T_LOOKASIDE} {. 
b7d0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
b7e0: 74 73 20 74 68 65 20 5b 6c 6f 6f 6b 61 73 69 64  ts the [lookasid
b7f0: 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  e memory allocat
b800: 6f 72 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  or]..}..COMPILE_
b810: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
b820: 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 7d 20 7b 0a  MIT_MEMORYDB} {.
b830: 20 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 64    When this is d
b840: 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72  efined, the libr
b850: 61 72 79 20 64 6f 65 73 20 6e 6f 74 20 72 65 73  ary does not res
b860: 70 65 63 74 20 74 68 65 20 73 70 65 63 69 61 6c  pect the special
b870: 20 64 61 74 61 62 61 73 65 0a 20 20 6e 61 6d 65   database.  name
b880: 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 28 6e 6f 72   ":memory:" (nor
b890: 6d 61 6c 6c 79 20 75 73 65 64 20 74 6f 20 63 72  mally used to cr
b8a0: 65 61 74 65 20 61 6e 20 5b 69 6e 2d 6d 65 6d 6f  eate an [in-memo
b8b0: 72 79 20 64 61 74 61 62 61 73 65 5d 29 2e 20 49  ry database]). I
b8c0: 66 20 0a 20 20 22 3a 6d 65 6d 6f 72 79 3a 22 20  f .  ":memory:" 
b8d0: 69 73 20 70 61 73 73 65 64 20 74 6f 20 5b 73 71  is passed to [sq
b8e0: 6c 69 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b  lite3_open()], [
b8f0: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29  sqlite3_open16()
b900: 5d 2c 20 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33  ], or.  [sqlite3
b910: 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c 20 61 20 66  _open_v2()], a f
b920: 69 6c 65 20 77 69 74 68 20 74 68 69 73 20 6e 61  ile with this na
b930: 6d 65 20 77 69 6c 6c 20 62 65 20 0a 20 20 6f 70  me will be .  op
b940: 65 6e 65 64 20 6f 72 20 63 72 65 61 74 65 64 2e  ened or created.
b950: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b960: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b970: 4f 52 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d  OR_OPTIMIZATION}
b980: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
b990: 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 62   disables the ab
b9a0: 69 6c 69 74 79 20 6f 66 20 53 51 4c 69 74 65 20  ility of SQLite 
b9b0: 74 6f 20 75 73 65 20 61 6e 20 69 6e 64 65 78 20  to use an index 
b9c0: 74 6f 67 65 74 68 65 72 0a 20 20 77 69 74 68 20  together.  with 
b9d0: 74 65 72 6d 73 20 6f 66 20 61 20 57 48 45 52 45  terms of a WHERE
b9e0: 20 63 6c 61 75 73 65 20 63 6f 6e 6e 65 63 74 65   clause connecte
b9f0: 64 20 62 79 20 74 68 65 20 4f 52 20 6f 70 65 72  d by the OR oper
ba00: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
ba10: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
ba20: 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d  OMIT_PAGER_PRAGM
ba30: 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67  AS} {.  Defining
ba40: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   this option omi
ba50: 74 73 20 70 72 61 67 6d 61 73 20 72 65 6c 61 74  ts pragmas relat
ba60: 65 64 20 74 6f 20 74 68 65 20 70 61 67 65 72 20  ed to the pager 
ba70: 73 75 62 73 79 73 74 65 6d 20 66 72 6f 6d 20 0a  subsystem from .
ba80: 20 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a    the build..}..
ba90: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
baa0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 41 47  SQLITE_OMIT_PRAG
bab0: 4d 41 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  MA} {.  This opt
bac0: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
bad0: 6d 69 74 20 74 68 65 20 5b 50 52 41 47 4d 41 5d  mit the [PRAGMA]
bae0: 20 63 6f 6d 6d 61 6e 64 0a 20 20 66 72 6f 6d 20   command.  from 
baf0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 4e 6f 74  the library. Not
bb00: 65 20 74 68 61 74 20 69 74 20 69 73 20 75 73 65  e that it is use
bb10: 66 75 6c 20 74 6f 20 64 65 66 69 6e 65 20 74 68  ful to define th
bb20: 65 20 6d 61 63 72 6f 73 20 74 68 61 74 20 6f 6d  e macros that om
bb30: 69 74 0a 20 20 73 70 65 63 69 66 69 63 20 70 72  it.  specific pr
bb40: 61 67 6d 61 73 20 69 6e 20 61 64 64 69 74 69 6f  agmas in additio
bb50: 6e 20 74 6f 20 74 68 69 73 2c 20 61 73 20 74 68  n to this, as th
bb60: 65 79 20 6d 61 79 20 61 6c 73 6f 20 72 65 6d 6f  ey may also remo
bb70: 76 65 20 73 75 70 70 6f 72 74 69 6e 67 20 63 6f  ve supporting co
bb80: 64 65 0a 20 20 69 6e 20 6f 74 68 65 72 20 73 75  de.  in other su
bb90: 62 2d 73 79 73 74 65 6d 73 2e 20 54 68 69 73 20  b-systems. This 
bba0: 6d 61 63 72 6f 20 72 65 6d 6f 76 65 73 20 74 68  macro removes th
bbb0: 65 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61  e [PRAGMA] comma
bbc0: 6e 64 20 6f 6e 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50  nd only..}..COMP
bbd0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
bbe0: 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53  TE_OMIT_PROGRESS
bbf0: 5f 43 41 4c 4c 42 41 43 4b 7d 20 7b 0a 20 20 54  _CALLBACK} {.  T
bc00: 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62  his option may b
bc10: 65 20 64 65 66 69 6e 65 64 20 74 6f 20 6f 6d 69  e defined to omi
bc20: 74 20 74 68 65 20 63 61 70 61 62 69 6c 69 74 79  t the capability
bc30: 20 74 6f 20 69 73 73 75 65 20 22 70 72 6f 67 72   to issue "progr
bc40: 65 73 73 22 20 0a 20 20 63 61 6c 6c 62 61 63 6b  ess" .  callback
bc50: 73 20 64 75 72 69 6e 67 20 6c 6f 6e 67 2d 72 75  s during long-ru
bc60: 6e 6e 69 6e 67 20 53 51 4c 20 73 74 61 74 65 6d  nning SQL statem
bc70: 65 6e 74 73 2e 20 54 68 65 20 0a 20 20 5b 73 71  ents. The .  [sq
bc80: 6c 69 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68  lite3_progress_h
bc90: 61 6e 64 6c 65 72 28 29 5d 0a 20 20 41 50 49 20  andler()].  API 
bca0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20  function is not 
bcb0: 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 6c  present in the l
bcc0: 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  ibrary..}..COMPI
bcd0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
bce0: 45 5f 4f 4d 49 54 5f 51 55 49 43 4b 42 41 4c 41  E_OMIT_QUICKBALA
bcf0: 4e 43 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  NCE} {.  This op
bd00: 74 69 6f 6e 20 6f 6d 69 74 73 20 61 6e 20 61 6c  tion omits an al
bd10: 74 65 72 6e 61 74 69 76 65 2c 20 66 61 73 74 65  ternative, faste
bd20: 72 20 42 2d 54 72 65 65 20 62 61 6c 61 6e 63 69  r B-Tree balanci
bd30: 6e 67 20 72 6f 75 74 69 6e 65 2e 0a 20 20 55 73  ng routine..  Us
bd40: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
bd50: 6d 61 6b 65 73 20 53 51 4c 69 74 65 20 73 6c 69  makes SQLite sli
bd60: 67 68 74 6c 79 20 73 6d 61 6c 6c 65 72 20 61 74  ghtly smaller at
bd70: 20 74 68 65 20 65 78 70 65 6e 73 65 20 6f 66 0a   the expense of.
bd80: 20 20 6d 61 6b 69 6e 67 20 69 74 20 72 75 6e 20    making it run 
bd90: 73 6c 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 2e  slightly slower.
bda0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
bdb0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
bdc0: 52 45 49 4e 44 45 58 7d 20 7b 0a 20 20 57 68 65  REINDEX} {.  Whe
bdd0: 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  n this option is
bde0: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 52   defined, the [R
bdf0: 45 49 4e 44 45 58 5d 0a 20 20 63 6f 6d 6d 61 6e  EINDEX].  comman
be00: 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65  d is not include
be10: 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79  d in the library
be20: 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20 61 20  ..  Executing a 
be30: 5b 52 45 49 4e 44 45 58 5d 20 73 74 61 74 65 6d  [REINDEX] statem
be40: 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20 61 20  ent causes .  a 
be50: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a  parse error..}..
be60: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
be70: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48 45  SQLITE_OMIT_SCHE
be80: 4d 41 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20  MA_PRAGMAS} {.  
be90: 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70  Defining this op
bea0: 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d  tion omits pragm
beb0: 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e 67 20  as for querying 
bec0: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
bed0: 65 6d 61 20 66 72 6f 6d 20 0a 20 20 74 68 65 20  ema from .  the 
bee0: 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  build..}..COMPIL
bef0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
bf00: 5f 4f 4d 49 54 5f 53 43 48 45 4d 41 5f 56 45 52  _OMIT_SCHEMA_VER
bf10: 53 49 4f 4e 5f 50 52 41 47 4d 41 53 7d 20 7b 0a  SION_PRAGMAS} {.
bf20: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
bf30: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61  option omits pra
bf40: 67 6d 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e  gmas for queryin
bf50: 67 20 61 6e 64 20 6d 6f 64 69 66 79 69 6e 67 20  g and modifying 
bf60: 74 68 65 20 0a 20 20 64 61 74 61 62 61 73 65 20  the .  database 
bf70: 73 63 68 65 6d 61 20 76 65 72 73 69 6f 6e 20 61  schema version a
bf80: 6e 64 20 75 73 65 72 20 76 65 72 73 69 6f 6e 20  nd user version 
bf90: 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 20  from the build. 
bfa0: 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68  Specifically, th
bfb0: 65 20 0a 20 20 5b 73 63 68 65 6d 61 5f 76 65 72  e .  [schema_ver
bfc0: 73 69 6f 6e 5d 20 61 6e 64 20 5b 75 73 65 72 5f  sion] and [user_
bfd0: 76 65 72 73 69 6f 6e 5d 20 50 52 41 47 4d 41 73  version] PRAGMAs
bfe0: 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a   are omitted..}.
bff0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
c000: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41  {SQLITE_OMIT_SHA
c010: 52 45 44 5f 43 41 43 48 45 7d 20 7b 0a 20 20 54  RED_CACHE} {.  T
c020: 68 69 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c 64  his option build
c030: 73 20 53 51 4c 69 74 65 20 77 69 74 68 6f 75 74  s SQLite without
c040: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73 68 61   support for sha
c050: 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 65 2e 0a  red-cache mode..
c060: 20 20 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 65    The [sqlite3_e
c070: 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 61 63  nable_shared_cac
c080: 68 65 28 29 5d 20 69 73 20 6f 6d 69 74 74 65 64  he()] is omitted
c090: 20 61 6c 6f 6e 67 20 77 69 74 68 20 61 20 66 61   along with a fa
c0a0: 69 72 0a 20 20 61 6d 6f 75 6e 74 20 6f 66 20 6c  ir.  amount of l
c0b0: 6f 67 69 63 20 77 69 74 68 69 6e 20 74 68 65 20  ogic within the 
c0c0: 42 2d 54 72 65 65 20 73 75 62 73 79 73 74 65 6d  B-Tree subsystem
c0d0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
c0e0: 20 73 68 61 72 65 64 0a 20 20 63 61 63 68 65 20   shared.  cache 
c0f0: 6d 61 6e 61 67 65 6d 65 6e 74 2e 0a 7d 0a 0a 43  management..}..C
c100: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
c110: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55  QLITE_OMIT_SUBQU
c120: 45 52 59 7d 20 7b 0a 20 20 49 66 20 64 65 66 69  ERY} {.  If defi
c130: 6e 65 64 2c 20 73 75 70 70 6f 72 74 20 66 6f 72  ned, support for
c140: 20 73 75 62 2d 73 65 6c 65 63 74 73 20 61 6e 64   sub-selects and
c150: 20 74 68 65 20 49 4e 28 29 20 6f 70 65 72 61 74   the IN() operat
c160: 6f 72 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a  or are omitted..
c170: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c180: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  N {SQLITE_OMIT_T
c190: 43 4c 5f 56 41 52 49 41 42 4c 45 7d 20 7b 0a 20  CL_VARIABLE} {. 
c1a0: 20 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69   If this macro i
c1b0: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20  s defined, then 
c1c0: 74 68 65 20 73 70 65 63 69 61 6c 20 22 24 3c 76  the special "$<v
c1d0: 61 72 69 61 62 6c 65 2d 6e 61 6d 65 3e 22 20 73  ariable-name>" s
c1e0: 79 6e 74 61 78 0a 20 20 75 73 65 64 20 74 6f 20  yntax.  used to 
c1f0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 69  automatically bi
c200: 6e 64 20 53 51 4c 20 76 61 72 69 61 62 6c 65 73  nd SQL variables
c210: 20 74 6f 20 54 43 4c 20 76 61 72 69 61 62 6c 65   to TCL variable
c220: 73 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a  s is omitted..}.
c230: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
c240: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d  {SQLITE_OMIT_TEM
c250: 50 44 42 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  PDB} {.  This op
c260: 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f  tion omits suppo
c270: 72 74 20 66 6f 72 20 54 45 4d 50 20 6f 72 20 54  rt for TEMP or T
c280: 45 4d 50 4f 52 41 52 59 20 74 61 62 6c 65 73 2e  EMPORARY tables.
c290: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
c2a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
c2b0: 54 52 41 43 45 7d 20 7b 0a 20 20 54 68 69 73 20  TRACE} {.  This 
c2c0: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
c2d0: 70 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 73 71  port for the [sq
c2e0: 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 28 29 5d  lite3_profile()]
c2f0: 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f   and.  [sqlite3_
c300: 74 72 61 63 65 28 29 5d 20 69 6e 74 65 72 66 61  trace()] interfa
c310: 63 65 73 20 61 6e 64 20 74 68 65 69 72 20 61 73  ces and their as
c320: 73 6f 63 69 61 74 65 64 20 6c 6f 67 69 63 2e 0a  sociated logic..
c330: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c340: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  N {SQLITE_OMIT_T
c350: 52 49 47 47 45 52 7d 20 7b 0a 20 20 44 65 66 69  RIGGER} {.  Defi
c360: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
c370: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
c380: 6f 72 20 54 52 49 47 47 45 52 20 6f 62 6a 65 63  or TRIGGER objec
c390: 74 73 2e 20 4e 65 69 74 68 65 72 20 74 68 65 20  ts. Neither the 
c3a0: 0a 20 20 5b 43 52 45 41 54 45 20 54 52 49 47 47  .  [CREATE TRIGG
c3b0: 45 52 5d 20 6f 72 20 5b 44 52 4f 50 20 54 52 49  ER] or [DROP TRI
c3c0: 47 47 45 52 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73  GGER].  commands
c3d0: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69   are available i
c3e0: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64  n this case, and
c3f0: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65   attempting to e
c400: 78 65 63 75 74 65 0a 20 20 65 69 74 68 65 72 20  xecute.  either 
c410: 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61  will result in a
c420: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 20 20   parse error..  
c430: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 6c 73 6f  This option also
c440: 20 64 69 73 61 62 6c 65 73 20 65 6e 66 6f 72 63   disables enforc
c450: 65 6d 65 6e 74 20 6f 66 20 5b 66 6f 72 65 69 67  ement of [foreig
c460: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74  n key constraint
c470: 73 5d 2c 0a 20 20 73 69 6e 63 65 20 74 68 65 20  s],.  since the 
c480: 63 6f 64 65 20 74 68 61 74 20 69 6d 70 6c 65 6d  code that implem
c490: 65 6e 74 73 20 74 72 69 67 67 65 72 73 20 61 6e  ents triggers an
c4a0: 64 20 77 68 69 63 68 20 69 73 20 6f 6d 69 74 74  d which is omitt
c4b0: 65 64 20 62 79 20 74 68 69 73 0a 20 20 6f 70 74  ed by this.  opt
c4c0: 69 6f 6e 20 69 73 20 61 6c 73 6f 20 75 73 65 64  ion is also used
c4d0: 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 5b 66   to implement [f
c4e0: 6f 72 65 69 67 6e 20 6b 65 79 20 61 63 74 69 6f  oreign key actio
c4f0: 6e 73 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ns]..}..COMPILE_
c500: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
c510: 4d 49 54 5f 54 52 55 4e 43 41 54 45 5f 4f 50 54  MIT_TRUNCATE_OPT
c520: 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 41  IMIZATION} {.  A
c530: 20 64 65 66 61 75 6c 74 20 62 75 69 6c 64 20 6f   default build o
c540: 66 20 53 51 4c 69 74 65 2c 20 69 66 20 61 20 5b  f SQLite, if a [
c550: 44 45 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e  DELETE] statemen
c560: 74 20 68 61 73 20 6e 6f 20 57 48 45 52 45 20 63  t has no WHERE c
c570: 6c 61 75 73 65 0a 20 20 61 6e 64 20 6f 70 65 72  lause.  and oper
c580: 61 74 65 73 20 6f 6e 20 61 20 74 61 62 6c 65 20  ates on a table 
c590: 77 69 74 68 20 6e 6f 20 74 72 69 67 67 65 72 73  with no triggers
c5a0: 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f  , an optimizatio
c5b0: 6e 20 6f 63 63 75 72 73 20 74 68 61 74 0a 20 20  n occurs that.  
c5c0: 63 61 75 73 65 73 20 74 68 65 20 44 45 4c 45 54  causes the DELET
c5d0: 45 20 74 6f 20 6f 63 63 75 72 20 62 79 20 64 72  E to occur by dr
c5e0: 6f 70 70 69 6e 67 20 61 6e 64 20 72 65 63 72 65  opping and recre
c5f0: 61 74 69 6e 67 20 74 68 65 20 74 61 62 6c 65 2e  ating the table.
c600: 20 20 0a 20 20 44 72 6f 70 70 69 6e 67 20 61 6e    .  Dropping an
c610: 64 20 72 65 63 72 65 61 74 69 6e 67 20 61 20 74  d recreating a t
c620: 61 62 6c 65 20 69 73 20 75 73 75 61 6c 6c 79 20  able is usually 
c630: 6d 75 63 68 20 66 61 73 74 65 72 20 74 68 61 6e  much faster than
c640: 20 64 65 6c 65 74 69 6e 67 0a 20 20 74 68 65 20   deleting.  the 
c650: 74 61 62 6c 65 20 63 6f 6e 74 65 6e 74 20 72 6f  table content ro
c660: 77 20 62 79 20 72 6f 77 2e 20 20 54 68 69 73 20  w by row.  This 
c670: 69 73 20 74 68 65 20 22 74 72 75 6e 63 61 74 65  is the "truncate
c680: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 22 2e 0a   optimization"..
c690: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c6a0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  N {SQLITE_OMIT_U
c6b0: 54 46 31 36 7d 20 7b 0a 20 20 54 68 69 73 20 6d  TF16} {.  This m
c6c0: 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20  acro is used to 
c6d0: 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72  omit support for
c6e0: 20 55 54 46 31 36 20 74 65 78 74 20 65 6e 63 6f   UTF16 text enco
c6f0: 64 69 6e 67 2e 20 57 68 65 6e 20 74 68 69 73 20  ding. When this 
c700: 69 73 0a 20 20 64 65 66 69 6e 65 64 20 61 6c 6c  is.  defined all
c710: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 74   API functions t
c720: 68 61 74 20 72 65 74 75 72 6e 20 6f 72 20 61 63  hat return or ac
c730: 63 65 70 74 20 55 54 46 31 36 20 65 6e 63 6f 64  cept UTF16 encod
c740: 65 64 20 74 65 78 74 20 61 72 65 0a 20 20 75 6e  ed text are.  un
c750: 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65 73 65  available. These
c760: 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 62   functions can b
c770: 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20  e identified by 
c780: 74 68 65 20 66 61 63 74 20 74 68 61 74 20 74 68  the fact that th
c790: 65 79 20 65 6e 64 0a 20 20 77 69 74 68 20 27 31  ey end.  with '1
c7a0: 36 27 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20  6', for example 
c7b0: 5b 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65  [sqlite3_prepare
c7c0: 31 36 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f  16()], [sqlite3_
c7d0: 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 5d  column_text16()]
c7e0: 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f   and.  [sqlite3_
c7f0: 62 69 6e 64 5f 74 65 78 74 31 36 28 29 5d 2e 0a  bind_text16()]..
c800: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c810: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56  N {SQLITE_OMIT_V
c820: 41 43 55 55 4d 7d 20 7b 0a 20 20 57 68 65 6e 20  ACUUM} {.  When 
c830: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
c840: 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 56 41 43  efined, the [VAC
c850: 55 55 4d 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 69  UUM].  command i
c860: 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69  s not included i
c870: 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 20  n the library.. 
c880: 20 45 78 65 63 75 74 69 6e 67 20 61 20 5b 56 41   Executing a [VA
c890: 43 55 55 4d 5d 20 73 74 61 74 65 6d 65 6e 74 20  CUUM] statement 
c8a0: 63 61 75 73 65 73 20 0a 20 20 61 20 70 61 72 73  causes .  a pars
c8b0: 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50  e error..}..COMP
c8c0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
c8d0: 54 45 5f 4f 4d 49 54 5f 56 49 45 57 7d 20 7b 0a  TE_OMIT_VIEW} {.
c8e0: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
c8f0: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
c900: 70 6f 72 74 20 66 6f 72 20 56 49 45 57 20 6f 62  port for VIEW ob
c910: 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20 74  jects. Neither t
c920: 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 56 49  he .  [CREATE VI
c930: 45 57 5d 20 6e 6f 72 20 74 68 65 20 5b 44 52 4f  EW] nor the [DRO
c940: 50 20 56 49 45 57 5d 0a 20 20 63 6f 6d 6d 61 6e  P VIEW].  comman
c950: 64 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65  ds are available
c960: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61   in this case, a
c970: 6e 64 0a 20 20 61 74 74 65 6d 70 74 69 6e 67 20  nd.  attempting 
c980: 74 6f 20 65 78 65 63 75 74 65 20 65 69 74 68 65  to execute eithe
c990: 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e  r will result in
c9a0: 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a   a parse error..
c9b0: 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 66 20 74  .  WARNING: If t
c9c0: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66  his macro is def
c9d0: 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c 20 6e 6f  ined, it will no
c9e0: 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f  t be possible to
c9f0: 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61 73 65   open a database
ca00: 0a 20 20 66 6f 72 20 77 68 69 63 68 20 74 68 65  .  for which the
ca10: 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 73   schema contains
ca20: 20 56 49 45 57 20 6f 62 6a 65 63 74 73 2e 20 0a   VIEW objects. .
ca30: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
ca40: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56  N {SQLITE_OMIT_V
ca50: 49 52 54 55 41 4c 54 41 42 4c 45 7d 20 7b 0a 20  IRTUALTABLE} {. 
ca60: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
ca70: 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74  ts support for t
ca80: 68 65 20 5b 73 71 6c 69 74 65 33 5f 76 74 61 62  he [sqlite3_vtab
ca90: 20 7c 20 56 69 72 74 75 61 6c 20 54 61 62 6c 65   | Virtual Table
caa0: 5d 0a 20 20 6d 65 63 68 61 6e 69 73 6d 20 69 6e  ].  mechanism in
cab0: 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d 50   SQLite..}..COMP
cac0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
cad0: 54 45 5f 4f 4d 49 54 5f 57 41 4c 7d 20 7b 0a 20  TE_OMIT_WAL} {. 
cae0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
caf0: 74 73 20 74 68 65 20 22 5b 77 72 69 74 65 2d 61  ts the "[write-a
cb00: 68 65 61 64 20 6c 6f 67 5d 22 20 28 61 2e 6b 2e  head log]" (a.k.
cb10: 61 2e 20 22 5b 57 41 4c 5d 22 29 20 63 61 70 61  a. "[WAL]") capa
cb20: 62 69 6c 69 74 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  bility..}..COMPI
cb30: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
cb40: 45 5f 4f 4d 49 54 5f 57 53 44 7d 20 7b 0a 20 20  E_OMIT_WSD} {.  
cb50: 54 68 69 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c  This option buil
cb60: 64 73 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 20  ds a version of 
cb70: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
cb80: 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73  ry that contains
cb90: 20 6e 6f 0a 20 20 57 72 69 74 61 62 6c 65 20 53   no.  Writable S
cba0: 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 29  tatic Data (WSD)
cbb0: 2e 20 20 57 53 44 20 69 73 20 67 6c 6f 62 61 6c  .  WSD is global
cbc0: 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 2f 6f   variables and/o
cbd0: 72 20 73 74 61 74 69 63 0a 20 20 76 61 72 69 61  r static.  varia
cbe0: 62 6c 65 73 2e 20 20 53 6f 6d 65 20 70 6c 61 74  bles.  Some plat
cbf0: 66 6f 72 6d 73 20 64 6f 20 6e 6f 74 20 73 75 70  forms do not sup
cc00: 70 6f 72 74 20 57 53 44 2c 20 61 6e 64 20 74 68  port WSD, and th
cc10: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 63  is option is nec
cc20: 65 73 73 61 72 79 0a 20 20 69 6e 20 6f 72 64 65  essary.  in orde
cc30: 72 20 66 6f 72 20 53 51 4c 69 74 65 20 74 6f 20  r for SQLite to 
cc40: 77 6f 72 6b 20 74 68 6f 73 65 20 70 6c 61 74 66  work those platf
cc50: 6f 72 6d 73 2e 20 20 0a 0a 20 20 55 6e 6c 69 6b  orms.  ..  Unlik
cc60: 65 20 6f 74 68 65 72 20 4f 4d 49 54 20 6f 70 74  e other OMIT opt
cc70: 69 6f 6e 73 20 77 68 69 63 68 20 6d 61 6b 65 20  ions which make 
cc80: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
cc90: 72 79 20 73 6d 61 6c 6c 65 72 2c 0a 20 20 74 68  ry smaller,.  th
cca0: 69 73 20 6f 70 74 69 6f 6e 20 61 63 74 75 61 6c  is option actual
ccb0: 6c 79 20 69 6e 63 72 65 61 73 65 73 20 74 68 65  ly increases the
ccc0: 20 73 69 7a 65 20 6f 66 20 53 51 4c 69 74 65 20   size of SQLite 
ccd0: 61 6e 64 20 6d 61 6b 65 73 20 69 74 20 72 75 6e  and makes it run
cce0: 0a 20 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f 77  .  a little slow
ccf0: 65 72 2e 20 20 4f 6e 6c 79 20 75 73 65 20 74 68  er.  Only use th
cd00: 69 73 20 6f 70 74 69 6f 6e 20 69 66 20 53 51 4c  is option if SQL
cd10: 69 74 65 20 69 73 20 62 65 69 6e 67 20 62 75 69  ite is being bui
cd20: 6c 74 20 66 6f 72 20 61 6e 0a 20 20 65 6d 62 65  lt for an.  embe
cd30: 64 64 65 64 20 74 61 72 67 65 74 20 74 68 61 74  dded target that
cd40: 20 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72   does not suppor
cd50: 74 20 57 53 44 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  t WSD..}..COMPIL
cd60: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
cd70: 5f 4f 4d 49 54 5f 58 46 45 52 5f 4f 50 54 7d 20  _OMIT_XFER_OPT} 
cd80: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
cd90: 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f  omits support fo
cda0: 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20  r optimizations 
cdb0: 74 68 61 74 20 68 65 6c 70 20 73 74 61 74 65 6d  that help statem
cdc0: 65 6e 74 73 0a 20 20 6f 66 20 74 68 65 20 66 6f  ents.  of the fo
cdd0: 72 6d 20 22 49 4e 53 45 52 54 20 49 4e 54 4f 20  rm "INSERT INTO 
cde0: 2e 2e 2e 20 53 45 4c 45 43 54 20 2e 2e 2e 22 20  ... SELECT ..." 
cdf0: 72 75 6e 20 66 61 73 74 65 72 2e 0a 7d 0a 0a 43  run faster..}..C
ce00: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
ce10: 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f  QLITE_ZERO_MALLO
ce20: 43 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  C} {.  This opti
ce30: 6f 6e 20 6f 6d 69 74 73 20 62 6f 74 68 20 74 68  on omits both th
ce40: 65 20 5b 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72  e [default memor
ce50: 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 20 61 6e 64  y allocator] and
ce60: 20 74 68 65 0a 20 20 5b 64 65 62 75 67 67 69 6e   the.  [debuggin
ce70: 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  g memory allocat
ce80: 6f 72 5d 20 66 72 6f 6d 20 74 68 65 20 62 75 69  or] from the bui
ce90: 6c 64 20 61 6e 64 20 73 75 62 73 74 69 74 75 74  ld and substitut
cea0: 65 73 20 61 20 73 74 75 62 0a 20 20 6d 65 6d 6f  es a stub.  memo
ceb0: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 74 68 61  ry allocator tha
cec0: 74 20 61 6c 77 61 79 73 20 66 61 69 6c 73 2e 20  t always fails. 
ced0: 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74   SQLite will not
cee0: 20 72 75 6e 20 77 69 74 68 20 74 68 69 73 0a 20   run with this. 
cef0: 20 73 74 75 62 20 6d 65 6d 6f 72 79 20 61 6c 6c   stub memory all
cf00: 6f 63 61 74 6f 72 20 73 69 6e 63 65 20 69 74 20  ocator since it 
cf10: 77 69 6c 6c 20 62 65 20 75 6e 61 62 6c 65 20 74  will be unable t
cf20: 6f 20 61 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72  o allocate memor
cf30: 79 2e 20 20 42 75 74 0a 20 20 74 68 69 73 20 73  y.  But.  this s
cf40: 74 75 62 20 63 61 6e 20 62 65 20 72 65 70 6c 61  tub can be repla
cf50: 63 65 64 20 61 74 20 73 74 61 72 74 2d 74 69 6d  ced at start-tim
cf60: 65 20 75 73 69 6e 67 0a 20 20 5b 73 71 6c 69 74  e using.  [sqlit
cf70: 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 51 4c 49  e3_config]([SQLI
cf80: 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43  TE_CONFIG_MALLOC
cf90: 5d 2c 2e 2e 2e 29 20 6f 72 0a 20 20 5b 73 71 6c  ],...) or.  [sql
cfa0: 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 51  ite3_config]([SQ
cfb0: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50  LITE_CONFIG_HEAP
cfc0: 5d 2c 2e 2e 2e 29 2e 0a 20 20 53 6f 20 74 68 65  ],...)..  So the
cfd0: 20 6e 65 74 20 65 66 66 65 63 74 20 6f 66 20 74   net effect of t
cfe0: 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  his compile-time
cff0: 20 6f 70 74 69 6f 6e 20 69 73 20 74 68 61 74 20   option is that 
d000: 69 74 20 61 6c 6c 6f 77 73 20 53 51 4c 69 74 65  it allows SQLite
d010: 0a 20 20 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65  .  to be compile
d020: 64 20 61 6e 64 20 6c 69 6e 6b 65 64 20 61 67 61  d and linked aga
d030: 69 6e 73 74 20 61 20 73 79 73 74 65 6d 20 6c 69  inst a system li
d040: 62 72 61 72 79 20 74 68 61 74 20 64 6f 65 73 20  brary that does 
d050: 6e 6f 74 20 73 75 70 70 6f 72 74 0a 20 20 6d 61  not support.  ma
d060: 6c 6c 6f 63 28 29 2c 20 66 72 65 65 28 29 2c 20  lloc(), free(), 
d070: 61 6e 64 2f 6f 72 20 72 65 61 6c 6c 6f 63 28 29  and/or realloc()
d080: 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 3c 61 20 6e  ..}..</tcl>.<a n
d090: 61 6d 65 3d 22 64 65 62 75 67 6f 70 74 69 6f 6e  ame="debugoption
d0a0: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 37 20  s"></a>.<h2>1.7 
d0b0: 41 6e 61 6c 79 73 69 73 20 61 6e 64 20 44 65 62  Analysis and Deb
d0c0: 75 67 67 69 6e 67 20 4f 70 74 69 6f 6e 73 3c 2f  ugging Options</
d0d0: 68 32 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50 49  h2>.<tcl>..COMPI
d0e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
d0f0: 45 5f 44 45 42 55 47 7d 20 7b 0a 20 20 54 68 65  E_DEBUG} {.  The
d100: 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63   SQLite source c
d110: 6f 64 65 20 63 6f 6e 74 61 69 6e 73 20 6c 69 74  ode contains lit
d120: 65 72 61 6c 6c 79 20 74 68 6f 75 73 61 6e 64 73  erally thousands
d130: 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 61   of assert() sta
d140: 74 65 6d 65 6e 74 73 0a 20 20 75 73 65 64 20 74  tements.  used t
d150: 6f 20 76 65 72 69 66 79 20 69 6e 74 65 72 6e 61  o verify interna
d160: 6c 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 61 6e  l assumptions an
d170: 64 20 73 75 62 72 6f 75 74 69 6e 65 20 70 72 65  d subroutine pre
d180: 63 6f 6e 64 69 74 69 6f 6e 73 20 61 6e 64 0a 20  conditions and. 
d190: 20 70 6f 73 74 63 6f 6e 64 69 74 69 6f 6e 73 2e   postconditions.
d1a0: 20 20 54 68 65 73 65 20 61 73 73 65 72 74 28 29    These assert()
d1b0: 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20   statements are 
d1c0: 6e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20  normally turned 
d1d0: 6f 66 66 0a 20 20 28 74 68 65 79 20 67 65 6e 65  off.  (they gene
d1e0: 72 61 74 65 20 6e 6f 20 63 6f 64 65 29 20 73 69  rate no code) si
d1f0: 6e 63 65 20 74 75 72 6e 69 6e 67 20 74 68 65 6d  nce turning them
d200: 20 6f 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74 65   on makes SQLite
d210: 20 72 75 6e 20 61 70 70 72 6f 78 69 6d 61 74 65   run approximate
d220: 6c 79 0a 20 20 74 68 72 65 65 20 74 69 6d 65 73  ly.  three times
d230: 20 73 6c 6f 77 65 72 2e 20 20 42 75 74 20 66 6f   slower.  But fo
d240: 72 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61 6e  r testing and an
d250: 61 6c 79 73 69 73 2c 20 69 74 20 69 73 20 75 73  alysis, it is us
d260: 65 66 75 6c 20 74 6f 20 74 75 72 6e 0a 20 20 74  eful to turn.  t
d270: 68 65 20 61 73 73 65 72 74 28 29 20 73 74 61 74  he assert() stat
d280: 65 6d 65 6e 74 73 20 6f 6e 2e 20 20 54 68 65 20  ements on.  The 
d290: 53 51 4c 49 54 45 5f 44 45 42 55 47 20 63 6f 6d  SQLITE_DEBUG com
d2a0: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
d2b0: 20 64 6f 65 73 20 74 68 69 73 2e 0a 20 20 3c 70   does this..  <p
d2c0: 3e 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61 6c  >SQLITE_DEBUG al
d2d0: 73 6f 20 65 6e 61 62 6c 65 73 20 73 6f 6d 65 20  so enables some 
d2e0: 6f 74 68 65 72 20 64 65 62 75 67 67 69 6e 67 20  other debugging 
d2f0: 66 65 61 74 75 72 65 73 2c 20 73 75 63 68 20 61  features, such a
d300: 73 0a 20 20 73 70 65 63 69 61 6c 20 5b 50 52 41  s.  special [PRA
d310: 47 4d 41 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  GMA] statements 
d320: 74 68 61 74 20 74 75 72 6e 20 6f 6e 20 74 72 61  that turn on tra
d330: 63 69 6e 67 20 61 6e 64 20 6c 69 73 74 69 6e 67  cing and listing
d340: 20 66 65 61 74 75 72 65 73 0a 20 20 75 73 65 64   features.  used
d350: 20 66 6f 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f   for troubleshoo
d360: 74 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69  ting and analysi
d370: 73 20 6f 66 20 74 68 65 20 5b 56 44 42 45 5d 20  s of the [VDBE] 
d380: 61 6e 64 20 63 6f 64 65 20 67 65 6e 65 72 61 74  and code generat
d390: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
d3a0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 45  PTION {SQLITE_ME
d3b0: 4d 44 45 42 55 47 7d 20 7b 0a 20 20 54 68 65 20  MDEBUG} {.  The 
d3c0: 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20  SQLITE_MEMDEBUG 
d3d0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 61 6e  option causes an
d3e0: 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20 0a 20   instrumented . 
d3f0: 20 5b 64 65 62 75 67 67 69 6e 67 20 6d 65 6d 6f   [debugging memo
d400: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 0a 20 20  ry allocator].  
d410: 74 6f 20 62 65 20 75 73 65 64 20 61 73 20 74 68  to be used as th
d420: 65 20 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79  e default memory
d430: 20 61 6c 6c 6f 63 61 74 6f 72 20 77 69 74 68 69   allocator withi
d440: 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65 0a 20  n SQLite.  The. 
d450: 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20 6d 65   instrumented me
d460: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 63  mory allocator c
d470: 68 65 63 6b 73 20 66 6f 72 20 6d 69 73 75 73 65  hecks for misuse
d480: 20 6f 66 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20   of dynamically 
d490: 61 6c 6c 6f 63 61 74 65 64 0a 20 20 6d 65 6d 6f  allocated.  memo
d4a0: 72 79 2e 20 20 45 78 61 6d 70 6c 65 73 20 6f 66  ry.  Examples of
d4b0: 20 6d 69 73 75 73 65 20 69 6e 63 6c 75 64 65 20   misuse include 
d4c0: 75 73 69 6e 67 20 6d 65 6d 6f 72 79 20 61 66 74  using memory aft
d4d0: 65 72 20 69 74 20 69 73 20 66 72 65 65 64 2c 0a  er it is freed,.
d4e0: 20 20 77 72 69 74 69 6e 67 20 6f 66 66 20 74 68    writing off th
d4f0: 65 20 65 6e 64 73 20 6f 66 20 61 20 6d 65 6d 6f  e ends of a memo
d500: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 20 66  ry allocation, f
d510: 72 65 65 69 6e 67 20 6d 65 6d 6f 72 79 20 6e 6f  reeing memory no
d520: 74 20 70 72 65 76 69 6f 75 73 6c 79 0a 20 20 6f  t previously.  o
d530: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65  btained from the
d540: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
d550: 72 2c 20 6f 72 20 66 61 69 6c 69 6e 67 20 74 6f  r, or failing to
d560: 20 69 6e 69 74 69 61 6c 69 7a 65 20 6e 65 77 6c   initialize newl
d570: 79 0a 20 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65  y.  allocated me
d580: 6d 6f 72 79 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a  mory..}..</tcl>.
d590: 3c 61 20 6e 61 6d 65 3d 22 77 69 6e 33 32 6f 70  <a name="win32op
d5a0: 74 69 6f 6e 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e  tions"></a>.<h2>
d5b0: 31 2e 38 20 57 69 6e 64 6f 77 73 2d 53 70 65 63  1.8 Windows-Spec
d5c0: 69 66 69 63 20 4f 70 74 69 6f 6e 73 3c 2f 68 32  ific Options</h2
d5d0: 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50 49 4c 45  >.<tcl>..COMPILE
d5e0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
d5f0: 57 49 4e 33 32 5f 48 45 41 50 5f 43 52 45 41 54  WIN32_HEAP_CREAT
d600: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
d610: 6f 6e 20 66 6f 72 63 65 73 20 74 68 65 20 57 69  on forces the Wi
d620: 6e 33 32 20 6e 61 74 69 76 65 20 6d 65 6d 6f 72  n32 native memor
d630: 79 20 61 6c 6c 6f 63 61 74 6f 72 2c 20 77 68 65  y allocator, whe
d640: 6e 20 65 6e 61 62 6c 65 64 2c 20 74 6f 0a 20 20  n enabled, to.  
d650: 63 72 65 61 74 65 20 61 20 70 72 69 76 61 74 65  create a private
d660: 20 68 65 61 70 20 74 6f 20 68 6f 6c 64 20 61 6c   heap to hold al
d670: 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  l memory allocat
d680: 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ions..}..COMPILE
d690: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
d6a0: 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 5f 56 41 4c  WIN32_MALLOC_VAL
d6b0: 49 44 41 54 45 7d 20 7b 0a 20 20 54 68 69 73 20  IDATE} {.  This 
d6c0: 6f 70 74 69 6f 6e 20 66 6f 72 63 65 73 20 74 68  option forces th
d6d0: 65 20 57 69 6e 33 32 20 6e 61 74 69 76 65 20 6d  e Win32 native m
d6e0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2c  emory allocator,
d6f0: 20 77 68 65 6e 20 65 6e 61 62 6c 65 64 2c 20 74   when enabled, t
d700: 6f 0a 20 20 6d 61 6b 65 20 73 74 72 61 74 65 67  o.  make strateg
d710: 69 63 20 63 61 6c 6c 73 20 69 6e 74 6f 20 74 68  ic calls into th
d720: 65 20 48 65 61 70 56 61 6c 69 64 61 74 65 28 29  e HeapValidate()
d730: 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 61 73 73   function if ass
d740: 65 72 74 28 29 20 69 73 20 61 6c 73 6f 0a 20 20  ert() is also.  
d750: 65 6e 61 62 6c 65 64 2e 0a 7d 0a 0a 3c 2f 74 63  enabled..}..</tc
d760: 6c 3e 0a                                         l>.