Documentation Source Text

Hex Artifact Content
Login

Artifact fea060b6237e1dc98f8b0314dca66a1322ea164e:


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 46 54 53  TION {SQLITE_FTS
1a00: 33 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48  3_MAX_EXPR_DEPTH
1a10: 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 54  =<i>N</i>} {.  T
1a20: 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20 74  his macro sets t
1a30: 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70 74 68  he maximum depth
1a40: 20 6f 66 20 74 68 65 20 73 65 61 72 63 68 20 74   of the search t
1a50: 72 65 65 20 74 68 61 74 20 63 6f 72 72 65 73 70  ree that corresp
1a60: 6f 6e 64 73 20 74 6f 0a 20 20 74 68 65 20 72 69  onds to.  the ri
1a70: 67 68 74 2d 68 61 6e 64 20 73 69 64 65 20 6f 66  ght-hand side of
1a80: 20 74 68 65 20 4d 41 54 43 48 20 6f 70 65 72 61   the MATCH opera
1a90: 74 6f 72 20 69 6e 20 61 6e 20 5b 46 54 53 33 5d  tor in an [FTS3]
1aa0: 20 6f 72 20 5b 46 54 53 34 5d 20 66 75 6c 6c 2d   or [FTS4] full-
1ab0: 74 65 78 74 0a 20 20 69 6e 64 65 78 2e 20 20 54  text.  index.  T
1ac0: 68 65 20 66 75 6c 6c 2d 74 65 78 74 20 73 65 61  he full-text sea
1ad0: 72 63 68 20 75 73 65 73 20 61 20 72 65 63 75 72  rch uses a recur
1ae0: 73 69 76 65 20 61 6c 67 6f 72 69 74 68 6d 2c 20  sive algorithm, 
1af0: 73 6f 20 74 68 65 20 64 65 70 74 68 20 6f 66 0a  so the depth of.
1b00: 20 20 74 68 65 20 74 72 65 65 20 69 73 20 6c 69    the tree is li
1b10: 6d 69 74 65 64 20 74 6f 20 70 72 65 76 65 6e 74  mited to prevent
1b20: 20 75 73 69 6e 67 20 74 6f 6f 20 6d 75 63 68 20   using too much 
1b30: 73 74 61 63 6b 20 73 70 61 63 65 2e 20 20 54 68  stack space.  Th
1b40: 65 20 64 65 66 61 75 6c 74 0a 20 20 6c 69 6d 69  e default.  limi
1b50: 74 20 69 73 20 31 32 2e 20 20 54 68 69 73 20 6c  t is 12.  This l
1b60: 69 6d 69 74 20 69 73 20 73 75 66 66 69 63 69 65  imit is sufficie
1b70: 6e 74 20 66 6f 72 20 75 70 20 74 6f 20 34 30 39  nt for up to 409
1b80: 35 20 73 65 61 72 63 68 20 74 65 72 6d 73 20 6f  5 search terms o
1b90: 6e 20 74 68 65 0a 20 20 72 69 67 68 74 2d 68 61  n the.  right-ha
1ba0: 6e 64 20 73 69 64 65 20 6f 66 20 74 68 65 20 4d  nd side of the M
1bb0: 41 54 43 48 20 6f 70 65 72 61 74 6f 72 20 61 6e  ATCH operator an
1bc0: 64 20 69 74 20 68 6f 6c 64 73 20 73 74 61 63 6b  d it holds stack
1bd0: 20 73 70 61 63 65 20 75 73 61 67 65 20 74 6f 20   space usage to 
1be0: 0a 20 20 6c 65 73 73 20 74 68 61 6e 20 32 30 30  .  less than 200
1bf0: 30 20 62 79 74 65 73 2e 0a 20 20 3c 70 3e 0a 20  0 bytes..  <p>. 
1c00: 20 46 6f 72 20 6f 72 64 69 6e 61 72 79 20 46 54   For ordinary FT
1c10: 53 33 2f 46 54 53 34 20 71 75 65 72 69 65 73 2c  S3/FTS4 queries,
1c20: 20 74 68 65 20 73 65 61 72 63 68 20 74 72 65 65   the search tree
1c30: 20 64 65 70 74 68 20 69 73 20 61 70 70 72 6f 78   depth is approx
1c40: 69 6d 61 74 65 6c 79 0a 20 20 74 68 65 20 62 61  imately.  the ba
1c50: 73 65 2d 32 20 6c 6f 67 61 72 69 74 68 6d 20 6f  se-2 logarithm o
1c60: 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  f the number of 
1c70: 74 65 72 6d 73 20 69 6e 20 74 68 65 20 72 69 67  terms in the rig
1c80: 68 74 2d 68 61 6e 64 20 73 69 64 65 20 6f 66 20  ht-hand side of 
1c90: 74 68 65 0a 20 20 4d 41 54 43 48 20 6f 70 65 72  the.  MATCH oper
1ca0: 61 74 6f 72 2e 20 20 48 6f 77 65 76 65 72 2c 20  ator.  However, 
1cb0: 66 6f 72 20 5b 70 68 72 61 73 65 20 71 75 65 72  for [phrase quer
1cc0: 69 65 73 5d 20 61 6e 64 20 5b 4e 45 41 52 20 71  ies] and [NEAR q
1cd0: 75 65 72 69 65 73 5d 20 74 68 65 0a 20 20 73 65  ueries] the.  se
1ce0: 61 72 63 68 20 74 72 65 65 20 64 65 70 74 68 20  arch tree depth 
1cf0: 69 73 20 6c 69 6e 65 61 72 20 69 6e 20 74 68 65  is linear in the
1d00: 20 6e 75 6d 62 65 72 20 6f 66 20 72 69 67 68 74   number of right
1d10: 2d 68 61 6e 64 20 73 69 64 65 20 74 65 72 6d 73  -hand side terms
1d20: 2e 0a 20 20 53 6f 20 74 68 65 20 64 65 66 61 75  ..  So the defau
1d30: 6c 74 20 64 65 70 74 68 20 6c 69 6d 69 74 20 6f  lt depth limit o
1d40: 66 20 31 32 20 69 73 20 73 75 66 66 69 63 69 65  f 12 is sufficie
1d50: 6e 74 20 66 6f 72 20 75 70 20 74 6f 20 34 30 39  nt for up to 409
1d60: 35 20 6f 72 64 69 6e 61 72 79 0a 20 20 74 65 72  5 ordinary.  ter
1d70: 6d 73 20 6f 6e 20 61 20 4d 41 54 43 48 2c 20 69  ms on a MATCH, i
1d80: 74 20 69 73 20 6f 6e 6c 79 20 73 75 66 66 69 63  t is only suffic
1d90: 69 65 6e 74 20 66 6f 72 20 31 31 20 6f 72 20 31  ient for 11 or 1
1da0: 32 20 70 68 72 61 73 65 20 6f 72 20 4e 45 41 52  2 phrase or NEAR
1db0: 0a 20 20 74 65 72 6d 73 2e 20 20 45 76 65 6e 20  .  terms.  Even 
1dc0: 73 6f 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20  so, the default 
1dd0: 69 73 20 6d 6f 72 65 20 74 68 61 6e 20 65 6e 6f  is more than eno
1de0: 75 67 68 20 66 6f 72 20 6d 6f 73 74 20 61 70 70  ugh for most app
1df0: 6c 69 63 61 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d  lication..}..COM
1e00: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
1e10: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a  ITE_MAX_MMAP_SIZ
1e20: 45 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20  E=<i>N</i>} {.  
1e30: 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 20  This macro sets 
1e40: 61 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75  a hard upper bou
1e50: 6e 64 20 6f 6e 20 74 68 65 20 61 6d 6f 75 6e 74  nd on the amount
1e60: 20 6f 66 20 61 64 64 72 65 73 73 20 73 70 61 63   of address spac
1e70: 65 20 74 68 61 74 0a 20 20 63 61 6e 20 62 65 20  e that.  can be 
1e80: 75 73 65 64 20 62 79 20 61 6e 79 20 73 69 6e 67  used by any sing
1e90: 6c 65 20 64 61 74 61 62 61 73 65 20 66 6f 72 20  le database for 
1ea0: 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f  memory-mapped I/
1eb0: 4f 2e 0a 20 20 53 65 74 74 69 6e 67 20 74 68 69  O..  Setting thi
1ec0: 73 20 76 61 6c 75 65 20 74 6f 20 30 20 63 6f 6d  s value to 0 com
1ed0: 70 6c 65 74 65 6c 79 20 64 69 73 61 62 6c 65 73  pletely disables
1ee0: 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49   memory-mapped I
1ef0: 2f 4f 20 61 6e 64 0a 20 20 63 61 75 73 65 73 20  /O and.  causes 
1f00: 6c 6f 67 69 63 20 61 73 73 6f 63 69 61 74 65 64  logic associated
1f10: 20 77 69 74 68 20 6d 65 6d 6f 72 79 2d 6d 61 70   with memory-map
1f20: 70 65 64 20 49 2f 4f 20 74 6f 20 62 65 20 6f 6d  ped I/O to be om
1f30: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 0a 20  itted from the. 
1f40: 20 62 75 69 6c 64 2e 20 20 54 68 69 73 20 6f 70   build.  This op
1f50: 74 69 6f 6e 20 64 6f 65 73 20 63 68 61 6e 67 65  tion does change
1f60: 20 74 68 65 20 64 65 66 61 75 6c 74 20 6d 65 6d   the default mem
1f70: 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 61  ory-mapped I/O a
1f80: 64 64 72 65 73 73 0a 20 20 73 70 61 63 65 20 73  ddress.  space s
1f90: 69 7a 65 20 28 73 65 74 20 62 79 20 5b 53 51 4c  ize (set by [SQL
1fa0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50  ITE_DEFAULT_MMAP
1fb0: 5f 53 49 5a 45 5d 20 6f 72 0a 20 20 73 71 6c 69  _SIZE] or.  sqli
1fc0: 74 65 33 5f 63 6f 6e 66 69 67 28 5b 53 51 4c 49  te3_config([SQLI
1fd0: 54 45 5f 43 4f 4e 46 49 47 5f 4d 4d 41 50 5f 53  TE_CONFIG_MMAP_S
1fe0: 49 5a 45 5d 29 20 6f 72 20 74 68 65 0a 20 20 72  IZE]) or the.  r
1ff0: 75 6e 2d 74 69 6d 65 20 6d 65 6d 6f 72 79 2d 6d  un-time memory-m
2000: 61 70 70 65 64 20 49 2f 4f 20 61 64 64 72 65 73  apped I/O addres
2010: 73 20 73 70 61 63 65 20 73 69 7a 65 20 28 73 65  s space size (se
2020: 74 20 62 79 0a 20 20 73 71 6c 69 74 65 33 5f 66  t by.  sqlite3_f
2030: 69 6c 65 5f 63 6f 6e 74 72 6f 6c 28 5b 53 51 4c  ile_control([SQL
2040: 49 54 45 5f 46 43 4e 54 4c 5f 4d 4d 41 50 5f 53  ITE_FCNTL_MMAP_S
2050: 49 5a 45 5d 29 20 6f 72 0a 20 20 5b 50 52 41 47  IZE]) or.  [PRAG
2060: 4d 41 20 6d 6d 61 70 5f 73 69 7a 65 5d 29 20 61  MA mmap_size]) a
2070: 73 20 6c 6f 6e 67 20 61 73 20 74 68 6f 73 65 20  s long as those 
2080: 6f 74 68 65 72 20 73 65 74 74 69 6e 67 73 20 61  other settings a
2090: 72 65 20 6c 65 73 73 20 74 68 61 6e 20 74 68 65  re less than the
20a0: 0a 20 20 6d 61 78 69 6d 75 6d 20 76 61 6c 75 65  .  maximum value
20b0: 20 64 65 66 69 6e 65 64 20 68 65 72 65 2e 0a 7d   defined here..}
20c0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
20d0: 20 7b 53 51 4c 49 54 45 5f 4d 41 58 5f 53 43 48   {SQLITE_MAX_SCH
20e0: 45 4d 41 5f 52 45 54 52 59 3d 3c 69 3e 4e 3c 2f  EMA_RETRY=<i>N</
20f0: 69 3e 7d 20 7b 0a 20 20 57 68 65 6e 65 76 65 72  i>} {.  Whenever
2100: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63   the database sc
2110: 68 65 6d 61 20 63 68 61 6e 67 65 73 2c 20 70 72  hema changes, pr
2120: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
2130: 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61  s are automatica
2140: 6c 6c 79 0a 20 20 72 65 70 72 65 70 61 72 65 64  lly.  reprepared
2150: 20 74 6f 20 61 63 63 6f 6d 6d 6f 64 61 74 65 20   to accommodate 
2160: 74 68 65 20 6e 65 77 20 73 63 68 65 6d 61 2e 20  the new schema. 
2170: 20 54 68 65 72 65 20 69 73 20 61 20 72 61 63 65   There is a race
2180: 20 63 6f 6e 64 69 74 69 6f 6e 20 68 65 72 65 0a   condition here.
2190: 20 20 69 6e 20 74 68 61 74 20 69 66 20 6f 6e 65    in that if one
21a0: 20 74 68 72 65 61 64 20 69 73 20 63 6f 6e 73 74   thread is const
21b0: 61 6e 74 6c 79 20 63 68 61 6e 67 69 6e 67 20 74  antly changing t
21c0: 68 65 20 73 63 68 65 6d 61 2c 20 61 6e 6f 74 68  he schema, anoth
21d0: 65 72 20 74 68 72 65 61 64 0a 20 20 6d 69 67 68  er thread.  migh
21e0: 74 20 73 70 69 6e 20 6f 6e 20 72 65 70 61 72 73  t spin on repars
21f0: 65 73 20 61 6e 64 20 72 65 70 72 65 70 61 72 61  es and reprepara
2200: 74 69 6f 6e 73 20 6f 66 20 61 20 70 72 65 70 61  tions of a prepa
2210: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 6e  red statement an
2220: 64 0a 20 20 6e 65 76 65 72 20 67 65 74 20 61 6e  d.  never get an
2230: 79 20 72 65 61 6c 20 77 6f 72 6b 20 64 6f 6e 65  y real work done
2240: 2e 20 20 54 68 69 73 20 70 61 72 61 6d 65 74 65  .  This paramete
2250: 72 20 70 72 65 76 65 6e 74 73 20 61 6e 20 69 6e  r prevents an in
2260: 66 69 6e 69 74 65 20 6c 6f 6f 70 0a 20 20 62 79  finite loop.  by
2270: 20 66 6f 72 63 69 6e 67 20 74 68 65 20 73 70 69   forcing the spi
2280: 6e 6e 69 6e 67 20 74 68 72 65 61 64 20 74 6f 20  nning thread to 
2290: 67 69 76 65 20 75 70 20 61 66 74 65 72 20 61 20  give up after a 
22a0: 66 69 78 65 64 20 6e 75 6d 62 65 72 20 6f 66 20  fixed number of 
22b0: 61 74 74 65 6d 70 74 73 0a 20 20 61 74 20 72 65  attempts.  at re
22c0: 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 70 72  compiling the pr
22d0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
22e0: 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73  .  The default s
22f0: 65 74 74 69 6e 67 20 69 73 20 35 30 20 77 68 69  etting is 50 whi
2300: 63 68 20 69 73 0a 20 20 6d 6f 72 65 20 74 68 61  ch is.  more tha
2310: 6e 20 61 64 65 71 75 61 74 65 20 66 6f 72 20 6d  n adequate for m
2320: 6f 73 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  ost applications
2330: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
2340: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 50 4f 57 45  ION {SQLITE_POWE
2350: 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 3d  RSAFE_OVERWRITE=
2360: 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 26 67 74  <i>&lt;0 or 1&gt
2370: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
2380: 6f 70 74 69 6f 6e 20 63 68 61 6e 67 65 73 20 74  option changes t
2390: 68 65 20 64 65 66 61 75 6c 74 20 61 73 73 75 6d  he default assum
23a0: 70 74 69 6f 6e 20 61 62 6f 75 74 20 5b 70 6f 77  ption about [pow
23b0: 65 72 73 61 66 65 20 6f 76 65 72 77 72 69 74 65  ersafe overwrite
23c0: 5d 0a 20 20 66 6f 72 20 74 68 65 20 75 6e 64 65  ].  for the unde
23d0: 72 6c 79 69 6e 67 20 66 69 6c 65 73 79 73 74 65  rlying filesyste
23e0: 6d 73 20 66 6f 72 20 74 68 65 20 75 6e 69 78 20  ms for the unix 
23f0: 61 6e 64 20 77 69 6e 64 6f 77 73 20 5b 56 46 53  and windows [VFS
2400: 65 73 5d 2e 0a 20 20 53 65 74 74 69 6e 67 20 53  es]..  Setting S
2410: 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f  QLITE_POWERSAFE_
2420: 4f 56 45 52 57 52 49 54 45 20 74 6f 20 31 20 63  OVERWRITE to 1 c
2430: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
2440: 61 73 73 75 6d 65 20 74 68 61 74 0a 20 20 61 70  assume that.  ap
2450: 70 6c 69 63 61 74 69 6f 6e 2d 6c 65 76 65 6c 20  plication-level 
2460: 77 72 69 74 65 73 20 63 61 6e 6e 6f 74 20 63 68  writes cannot ch
2470: 61 6e 67 65 73 20 62 79 74 65 73 20 6f 75 74 73  anges bytes outs
2480: 69 64 65 20 74 68 65 20 72 61 6e 67 65 20 6f 66  ide the range of
2490: 0a 20 20 62 79 74 65 73 20 77 72 69 74 74 65 6e  .  bytes written
24a0: 20 65 76 65 6e 20 69 66 20 74 68 65 20 77 72 69   even if the wri
24b0: 74 65 20 6f 63 63 75 72 73 20 6a 75 73 74 20 62  te occurs just b
24c0: 65 66 6f 72 65 20 61 20 70 6f 77 65 72 20 6c 6f  efore a power lo
24d0: 73 73 2e 0a 20 20 57 69 74 68 20 53 51 4c 49 54  ss..  With SQLIT
24e0: 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52  E_POWERSAFE_OVER
24f0: 57 52 49 54 45 20 73 65 74 20 74 6f 20 30 2c 20  WRITE set to 0, 
2500: 53 51 4c 69 74 65 20 61 73 73 75 6d 65 73 20 74  SQLite assumes t
2510: 68 61 74 20 6f 74 68 65 72 0a 20 20 62 79 74 65  hat other.  byte
2520: 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 73 65  s in the same se
2530: 63 74 6f 72 20 77 69 74 68 20 61 20 77 72 69 74  ctor with a writ
2540: 74 65 6e 20 62 79 74 65 20 6d 69 67 68 74 20 62  ten byte might b
2550: 65 20 63 68 61 6e 67 65 64 20 6f 72 20 0a 20 20  e changed or .  
2560: 64 61 6d 61 67 65 64 20 62 79 20 61 20 70 6f 77  damaged by a pow
2570: 65 72 20 6c 6f 73 73 2e 0a 7d 0a 0a 43 4f 4d 50  er loss..}..COMP
2580: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 59 59 53 54  ILE_OPTION {YYST
2590: 41 43 4b 44 45 50 54 48 3d 3c 69 3e 26 6c 74 3b  ACKDEPTH=<i>&lt;
25a0: 6d 61 78 5f 64 65 70 74 68 26 67 74 3b 3c 2f 69  max_depth&gt;</i
25b0: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72  >} {.  This macr
25c0: 6f 20 73 65 74 73 20 74 68 65 20 6d 61 78 69 6d  o sets the maxim
25d0: 75 6d 20 64 65 70 74 68 20 6f 66 20 74 68 65 20  um depth of the 
25e0: 4c 41 4c 52 28 31 29 20 73 74 61 63 6b 20 75 73  LALR(1) stack us
25f0: 65 64 20 62 79 0a 20 20 74 68 65 20 53 51 4c 20  ed by.  the SQL 
2600: 70 61 72 73 65 72 20 77 69 74 68 69 6e 20 53 51  parser within SQ
2610: 4c 69 74 65 2e 20 20 54 68 65 20 64 65 66 61 75  Lite.  The defau
2620: 6c 74 20 76 61 6c 75 65 20 69 73 20 31 30 30 2e  lt value is 100.
2630: 20 20 41 20 74 79 70 69 63 61 6c 0a 20 20 61 70    A typical.  ap
2640: 70 6c 69 63 61 74 69 6f 6e 20 77 69 6c 6c 20 75  plication will u
2650: 73 65 20 6c 65 73 73 20 74 68 61 6e 20 61 62 6f  se less than abo
2660: 75 74 20 32 30 20 6c 65 76 65 6c 73 20 6f 66 20  ut 20 levels of 
2670: 74 68 65 20 73 74 61 63 6b 2e 0a 20 20 44 65 76  the stack..  Dev
2680: 65 6c 6f 70 65 72 73 20 77 68 6f 73 65 20 61 70  elopers whose ap
2690: 70 6c 69 63 61 74 69 6f 6e 73 20 63 6f 6e 74 61  plications conta
26a0: 69 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  in SQL statement
26b0: 73 20 74 68 61 74 20 0a 20 20 6e 65 65 64 20 6d  s that .  need m
26c0: 6f 72 65 20 74 68 61 6e 20 31 30 30 20 4c 41 4c  ore than 100 LAL
26d0: 52 28 31 29 20 73 74 61 63 6b 20 65 6e 74 72 69  R(1) stack entri
26e0: 65 73 20 73 68 6f 75 6c 64 20 73 65 72 69 6f 75  es should seriou
26f0: 73 6c 79 0a 20 20 63 6f 6e 73 69 64 65 72 20 72  sly.  consider r
2700: 65 66 61 63 74 6f 72 69 6e 67 20 74 68 65 69 72  efactoring their
2710: 20 53 51 4c 20 61 73 20 69 74 20 69 73 20 6c 69   SQL as it is li
2720: 6b 65 6c 79 20 74 6f 20 62 65 20 77 65 6c 6c 20  kely to be well 
2730: 62 65 79 6f 6e 64 0a 20 20 74 68 65 20 61 62 69  beyond.  the abi
2740: 6c 69 74 79 20 6f 66 20 61 6e 79 20 68 75 6d 61  lity of any huma
2750: 6e 20 74 6f 20 63 6f 6d 70 72 65 68 65 6e 64 2e  n to comprehend.
2760: 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 68 32 3e 31  .}.</tcl>..<h2>1
2770: 2e 32 20 4f 70 74 69 6f 6e 73 20 54 6f 20 53 65  .2 Options To Se
2780: 74 20 53 69 7a 65 20 4c 69 6d 69 74 73 3c 2f 68  t Size Limits</h
2790: 32 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65  2>..<p>There are
27a0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
27b0: 74 69 6f 6e 73 20 74 68 61 74 20 77 69 6c 6c 20  tions that will 
27c0: 73 65 74 20 75 70 70 65 72 20 62 6f 75 6e 64 73  set upper bounds
27d0: 0a 6f 6e 20 74 68 65 20 73 69 7a 65 73 20 6f 66  .on the sizes of
27e0: 20 76 61 72 69 6f 75 73 20 73 74 72 75 63 74 75   various structu
27f0: 72 65 73 20 69 6e 20 53 51 4c 69 74 65 2e 20 20  res in SQLite.  
2800: 54 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  The compile-time
2810: 0a 6f 70 74 69 6f 6e 73 20 6e 6f 72 6d 61 6c 6c  .options normall
2820: 79 20 73 65 74 20 61 20 68 61 72 64 20 75 70 70  y set a hard upp
2830: 65 72 20 62 6f 75 6e 64 20 74 68 61 74 20 63 61  er bound that ca
2840: 6e 20 62 65 20 63 68 61 6e 67 65 64 0a 61 74 20  n be changed.at 
2850: 72 75 6e 2d 74 69 6d 65 20 6f 6e 20 69 6e 64 69  run-time on indi
2860: 76 69 64 75 61 6c 20 5b 64 61 74 61 62 61 73 65  vidual [database
2870: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 20 75 73   connections] us
2880: 69 6e 67 20 74 68 65 0a 5b 73 71 6c 69 74 65 33  ing the.[sqlite3
2890: 5f 6c 69 6d 69 74 28 29 5d 20 69 6e 74 65 72 66  _limit()] interf
28a0: 61 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ace.</p>..<p>The
28b0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
28c0: 74 69 6f 6e 73 20 66 6f 72 20 73 65 74 74 69 6e  tions for settin
28d0: 67 20 75 70 70 65 72 20 62 6f 75 6e 64 73 20 61  g upper bounds a
28e0: 72 65 0a 5b 6c 69 6d 69 74 73 20 7c 20 64 6f 63  re.[limits | doc
28f0: 75 6d 65 6e 74 65 64 20 73 65 70 61 72 61 74 65  umented separate
2900: 6c 79 5d 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77  ly].  The follow
2910: 69 6e 67 20 69 73 20 61 20 6c 69 73 74 20 6f 66  ing is a list of
2920: 0a 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 73  .the available s
2930: 65 74 74 69 6e 67 73 3a 3c 2f 70 3e 0a 0a 3c 75  ettings:</p>..<u
2940: 6c 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  l>.<li> [SQLITE_
2950: 4d 41 58 5f 41 54 54 41 43 48 45 44 5d 20 20 3c  MAX_ATTACHED]  <
2960: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
2970: 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 5d 20 20 3c  E_MAX_COLUMN]  <
2980: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
2990: 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53  E_MAX_COMPOUND_S
29a0: 45 4c 45 43 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  ELECT]  </li>.<l
29b0: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 45  i> [SQLITE_MAX_E
29c0: 58 50 52 5f 44 45 50 54 48 5d 20 20 3c 2f 6c 69  XPR_DEPTH]  </li
29d0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
29e0: 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d  AX_FUNCTION_ARG]
29f0: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51    </li>.<li> [SQ
2a00: 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 5d  LITE_MAX_LENGTH]
2a10: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51    </li>.<li> [SQ
2a20: 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41  LITE_MAX_LIKE_PA
2a30: 54 54 45 52 4e 5f 4c 45 4e 47 54 48 5d 20 20 3c  TTERN_LENGTH]  <
2a40: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
2a50: 45 5f 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e 54  E_MAX_PAGE_COUNT
2a60: 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53  ]  </li>.<li> [S
2a70: 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45  QLITE_MAX_SQL_LE
2a80: 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69  NGTH]  </li>.<li
2a90: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41  > [SQLITE_MAX_VA
2aa0: 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 5d 20 20  RIABLE_NUMBER]  
2ab0: 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 61 20  </li>.</ul>..<a 
2ac0: 6e 61 6d 65 3d 22 63 6f 6e 74 72 6f 6c 66 65 61  name="controlfea
2ad0: 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e  tures"></a>.<h2>
2ae0: 31 2e 33 20 4f 70 74 69 6f 6e 73 20 54 6f 20 43  1.3 Options To C
2af0: 6f 6e 74 72 6f 6c 20 4f 70 65 72 61 74 69 6e 67  ontrol Operating
2b00: 20 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73   Characteristics
2b10: 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d  </h2>..<tcl>.COM
2b20: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
2b30: 49 54 45 5f 34 5f 42 59 54 45 5f 41 4c 49 47 4e  ITE_4_BYTE_ALIGN
2b40: 45 44 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20 20 4f  ED_MALLOC} {.  O
2b50: 6e 20 6d 6f 73 74 20 73 79 73 74 65 6d 73 2c 20  n most systems, 
2b60: 74 68 65 20 6d 61 6c 6c 6f 63 28 29 20 73 79 73  the malloc() sys
2b70: 74 65 6d 20 63 61 6c 6c 20 72 65 74 75 72 6e 73  tem call returns
2b80: 20 61 20 62 75 66 66 65 72 20 74 68 61 74 20 69   a buffer that i
2b90: 73 0a 20 20 61 6c 69 67 6e 65 64 20 74 6f 20 61  s.  aligned to a
2ba0: 6e 20 38 2d 62 79 74 65 20 62 6f 75 6e 64 61 72  n 8-byte boundar
2bb0: 79 2e 20 20 42 75 74 20 6f 6e 20 73 6f 6d 65 20  y.  But on some 
2bc0: 73 79 73 74 65 6d 73 20 28 65 78 3a 20 77 69 6e  systems (ex: win
2bd0: 64 6f 77 73 29 20 6d 61 6c 6c 6f 63 28 29 0a 20  dows) malloc(). 
2be0: 20 72 65 74 75 72 6e 73 20 34 2d 62 79 74 65 20   returns 4-byte 
2bf0: 61 6c 69 67 6e 65 64 20 70 6f 69 6e 74 65 72 2e  aligned pointer.
2c00: 20 20 54 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74    This compile-t
2c10: 69 6d 65 20 6f 70 74 69 6f 6e 20 6d 75 73 74 20  ime option must 
2c20: 62 65 20 75 73 65 64 0a 20 20 6f 6e 20 73 79 73  be used.  on sys
2c30: 74 65 6d 73 20 74 68 61 74 20 72 65 74 75 72 6e  tems that return
2c40: 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 20   4-byte aligned 
2c50: 70 6f 69 6e 74 65 72 73 20 66 72 6f 6d 20 6d 61  pointers from ma
2c60: 6c 6c 6f 63 28 29 2e 0a 7d 0a 0a 43 4f 4d 50 49  lloc()..}..COMPI
2c70: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
2c80: 45 5f 43 41 53 45 5f 53 45 4e 53 49 54 49 56 45  E_CASE_SENSITIVE
2c90: 5f 4c 49 4b 45 7d 20 7b 0a 20 20 49 66 20 74 68  _LIKE} {.  If th
2ca0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65  is option is pre
2cb0: 73 65 6e 74 2c 20 74 68 65 6e 20 74 68 65 20 62  sent, then the b
2cc0: 75 69 6c 74 2d 69 6e 20 5b 4c 49 4b 45 5d 20 6f  uilt-in [LIKE] o
2cd0: 70 65 72 61 74 6f 72 20 77 69 6c 6c 20 62 65 0a  perator will be.
2ce0: 20 20 63 61 73 65 20 73 65 6e 73 69 74 69 76 65    case sensitive
2cf0: 2e 20 20 54 68 69 73 20 73 61 6d 65 20 65 66 66  .  This same eff
2d00: 65 63 74 20 63 61 6e 20 62 65 20 61 63 68 69 65  ect can be achie
2d10: 76 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 20  ved at run-time 
2d20: 75 73 69 6e 67 0a 20 20 74 68 65 20 5b 63 61 73  using.  the [cas
2d30: 65 5f 73 65 6e 73 69 74 69 76 65 5f 6c 69 6b 65  e_sensitive_like
2d40: 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d   pragma]..}..COM
2d50: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
2d60: 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46  ITE_DIRECT_OVERF
2d70: 4c 4f 57 5f 52 45 41 44 7d 20 7b 0a 20 20 57 68  LOW_READ} {.  Wh
2d80: 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  en this option i
2d90: 73 20 70 72 65 73 65 6e 74 2c 20 63 6f 6e 74 65  s present, conte
2da0: 6e 74 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 0a  nt contained in.
2db0: 20 20 5b 6f 76 65 72 66 6c 6f 77 20 70 61 67 65    [overflow page
2dc0: 73 5d 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  s] of the databa
2dd0: 73 65 20 66 69 6c 65 20 69 73 20 72 65 61 64 20  se file is read 
2de0: 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 64 69  directly from di
2df0: 73 6b 2c 0a 20 20 62 79 70 61 73 73 69 6e 67 20  sk,.  bypassing 
2e00: 74 68 65 20 5b 70 61 67 65 20 63 61 63 68 65 5d  the [page cache]
2e10: 2c 20 64 75 72 69 6e 67 20 72 65 61 64 20 74 72  , during read tr
2e20: 61 6e 73 61 63 74 69 6f 6e 73 2e 20 20 49 6e 20  ansactions.  In 
2e30: 61 70 70 6c 69 63 61 74 69 6f 6e 73 0a 20 20 74  applications.  t
2e40: 68 61 74 20 64 6f 20 61 20 6c 6f 74 20 6f 66 20  hat do a lot of 
2e50: 72 65 61 64 73 20 6f 66 20 6c 61 72 67 65 20 42  reads of large B
2e60: 4c 4f 42 73 2c 20 74 68 69 73 20 6f 70 74 69 6f  LOBs, this optio
2e70: 6e 20 6d 69 67 68 74 20 69 6d 70 72 6f 76 65 20  n might improve 
2e80: 72 65 61 64 0a 20 20 70 65 72 66 6f 72 6d 61 6e  read.  performan
2e90: 63 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ce..}..COMPILE_O
2ea0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 48 41  PTION {SQLITE_HA
2eb0: 56 45 5f 49 53 4e 41 4e 7d 20 7b 0a 20 20 49 66  VE_ISNAN} {.  If
2ec0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
2ed0: 70 72 65 73 65 6e 74 2c 20 74 68 65 6e 20 53 51  present, then SQ
2ee0: 4c 69 74 65 20 77 69 6c 6c 20 75 73 65 20 74 68  Lite will use th
2ef0: 65 20 69 73 6e 61 6e 28 29 20 66 75 6e 63 74 69  e isnan() functi
2f00: 6f 6e 20 66 72 6f 6d 0a 20 20 74 68 65 20 73 79  on from.  the sy
2f10: 73 74 65 6d 20 6d 61 74 68 20 6c 69 62 72 61 72  stem math librar
2f20: 79 2e 20 20 57 69 74 68 6f 75 74 20 74 68 69 73  y.  Without this
2f30: 20 6f 70 74 69 6f 6e 20 28 74 68 65 20 64 65 66   option (the def
2f40: 61 75 6c 74 20 62 65 68 61 76 69 6f 72 29 0a 20  ault behavior). 
2f50: 20 53 51 4c 69 74 65 20 75 73 65 73 20 69 74 73   SQLite uses its
2f60: 20 6f 77 6e 20 69 6e 74 65 72 6e 61 6c 20 69 6d   own internal im
2f70: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
2f80: 69 73 6e 61 6e 28 29 2e 20 20 53 51 4c 69 74 65  isnan().  SQLite
2f90: 20 75 73 65 73 0a 20 20 69 74 73 20 6f 77 6e 20   uses.  its own 
2fa0: 69 6e 74 65 72 6e 61 6c 20 69 73 6e 61 6e 28 29  internal isnan()
2fb0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
2fc0: 62 79 20 64 65 66 61 75 6c 74 20 62 65 63 61 75  by default becau
2fd0: 73 65 20 6f 66 20 70 61 73 74 0a 20 20 70 72 6f  se of past.  pro
2fe0: 62 6c 65 6d 73 20 77 69 74 68 20 73 79 73 74 65  blems with syste
2ff0: 6d 20 69 73 6e 61 6e 28 29 20 66 75 6e 63 74 69  m isnan() functi
3000: 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ons..}..COMPILE_
3010: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
3020: 53 5f 4f 54 48 45 52 3d 3c 69 3e 26 6c 74 3b 30  S_OTHER=<i>&lt;0
3030: 20 6f 72 20 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b   or 1&gt;</i>} {
3040: 0a 20 20 54 68 65 20 6f 70 74 69 6f 6e 20 63 61  .  The option ca
3050: 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f  uses SQLite to o
3060: 6d 69 74 20 69 74 73 20 62 75 69 6c 74 2d 69 6e  mit its built-in
3070: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
3080: 6d 20 69 6e 74 65 72 66 61 63 65 73 0a 20 20 66  m interfaces.  f
3090: 6f 72 20 55 6e 69 78 2c 20 57 69 6e 64 6f 77 73  or Unix, Windows
30a0: 2c 20 61 6e 64 20 4f 53 2f 32 2e 20 20 54 68 65  , and OS/2.  The
30b0: 20 72 65 73 75 6c 74 69 6e 67 20 6c 69 62 72 61   resulting libra
30c0: 72 79 20 77 69 6c 6c 20 68 61 76 65 20 6e 6f 20  ry will have no 
30d0: 64 65 66 61 75 6c 74 0a 20 20 5b 73 71 6c 69 74  default.  [sqlit
30e0: 65 33 5f 76 66 73 20 7c 20 6f 70 65 72 61 74 69  e3_vfs | operati
30f0: 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65 72 66  ng system interf
3100: 61 63 65 5d 2e 20 20 41 70 70 6c 69 63 61 74 69  ace].  Applicati
3110: 6f 6e 73 20 6d 75 73 74 20 75 73 65 0a 20 20 5b  ons must use.  [
3120: 73 71 6c 69 74 65 33 5f 76 66 73 5f 72 65 67 69  sqlite3_vfs_regi
3130: 73 74 65 72 28 29 5d 20 74 6f 20 72 65 67 69 73  ster()] to regis
3140: 74 65 72 20 61 6e 20 61 70 70 72 6f 70 72 69 61  ter an appropria
3150: 74 65 20 69 6e 74 65 72 66 61 63 65 20 62 65 66  te interface bef
3160: 6f 72 65 0a 20 20 75 73 69 6e 67 20 53 51 4c 69  ore.  using SQLi
3170: 74 65 2e 20 20 41 70 70 6c 69 63 61 74 69 6f 6e  te.  Application
3180: 73 20 6d 75 73 74 20 61 6c 73 6f 20 73 75 70 70  s must also supp
3190: 6c 79 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ly implementatio
31a0: 6e 73 20 66 6f 72 20 74 68 65 0a 20 20 5b 73 71  ns for the.  [sq
31b0: 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29 5d  lite3_os_init()]
31c0: 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6f 73   and [sqlite3_os
31d0: 5f 65 6e 64 28 29 5d 20 69 6e 74 65 72 66 61 63  _end()] interfac
31e0: 65 73 2e 20 20 54 68 65 20 75 73 75 61 6c 20 70  es.  The usual p
31f0: 72 61 63 74 69 63 65 0a 20 20 69 73 20 66 6f 72  ractice.  is for
3200: 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 5b 73   the supplied [s
3210: 71 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29  qlite3_os_init()
3220: 5d 20 74 6f 20 69 6e 76 6f 6b 65 20 5b 73 71 6c  ] to invoke [sql
3230: 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 65  ite3_vfs_registe
3240: 72 28 29 5d 2e 0a 20 20 53 51 4c 69 74 65 20 77  r()]..  SQLite w
3250: 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ill automaticall
3260: 79 20 69 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65  y invoke [sqlite
3270: 33 5f 6f 73 5f 69 6e 69 74 28 29 5d 20 77 68 65  3_os_init()] whe
3280: 6e 20 69 74 20 69 6e 69 74 69 61 6c 69 7a 65 73  n it initializes
3290: 2e 0a 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e  ...  This option
32a0: 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 75 73   is typically us
32b0: 65 64 20 77 68 65 6e 20 62 75 69 6c 64 69 6e 67  ed when building
32c0: 20 53 51 4c 69 74 65 20 66 6f 72 20 61 6e 20 65   SQLite for an e
32d0: 6d 62 65 64 64 65 64 0a 20 20 70 6c 61 74 66 6f  mbedded.  platfo
32e0: 72 6d 20 77 69 74 68 20 61 20 63 75 73 74 6f 6d  rm with a custom
32f0: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
3300: 6d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  m..}..COMPILE_OP
3310: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 53 45 43  TION {SQLITE_SEC
3320: 55 52 45 5f 44 45 4c 45 54 45 7d 20 7b 0a 20 20  URE_DELETE} {.  
3330: 54 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  This compile-tim
3340: 65 20 6f 70 74 69 6f 6e 20 63 68 61 6e 67 65 73  e option changes
3350: 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 65 74   the default set
3360: 74 69 6e 67 20 6f 66 20 74 68 65 0a 20 20 5b 73  ting of the.  [s
3370: 65 63 75 72 65 5f 64 65 6c 65 74 65 20 70 72 61  ecure_delete pra
3380: 67 6d 61 5d 2e 20 20 57 68 65 6e 20 74 68 69 73  gma].  When this
3390: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 74 20 75   option is not u
33a0: 73 65 64 2c 20 73 65 63 75 72 65 5f 64 65 6c 65  sed, secure_dele
33b0: 74 65 20 64 65 66 61 75 6c 74 73 0a 20 20 74 6f  te defaults.  to
33c0: 20 6f 66 66 2e 20 20 57 68 65 6e 20 74 68 69 73   off.  When this
33d0: 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65   option is prese
33e0: 6e 74 2c 20 73 65 63 75 72 65 5f 64 65 6c 65 74  nt, secure_delet
33f0: 65 20 64 65 66 61 75 6c 74 73 20 74 6f 20 6f 6e  e defaults to on
3400: 2e 0a 0a 20 20 54 68 65 20 73 65 63 75 72 65 5f  ...  The secure_
3410: 64 65 6c 65 74 65 20 73 65 74 74 69 6e 67 20 63  delete setting c
3420: 61 75 73 65 73 20 64 65 6c 65 74 65 64 20 63 6f  auses deleted co
3430: 6e 74 65 6e 74 20 74 6f 20 62 65 20 6f 76 65 72  ntent to be over
3440: 77 72 69 74 74 65 6e 20 77 69 74 68 0a 20 20 7a  written with.  z
3450: 65 72 6f 73 2e 20 20 54 68 65 72 65 20 69 73 20  eros.  There is 
3460: 61 20 73 6d 61 6c 6c 20 70 65 72 66 6f 72 6d 61  a small performa
3470: 6e 63 65 20 70 65 6e 61 6c 74 79 20 66 6f 72 20  nce penalty for 
3480: 74 68 69 73 20 73 69 6e 63 65 20 61 64 64 69 74  this since addit
3490: 69 6f 6e 61 6c 20 49 2f 4f 0a 20 20 6d 75 73 74  ional I/O.  must
34a0: 20 6f 63 63 75 72 2e 20 20 4f 6e 20 74 68 65 20   occur.  On the 
34b0: 6f 74 68 65 72 20 68 61 6e 64 2c 20 73 65 63 75  other hand, secu
34c0: 72 65 5f 64 65 6c 65 74 65 20 63 61 6e 20 70 72  re_delete can pr
34d0: 65 76 65 6e 74 20 73 65 6e 73 69 74 69 76 65 20  event sensitive 
34e0: 0a 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66  .  information f
34f0: 72 6f 6d 20 6c 69 6e 67 65 72 69 6e 67 20 69 6e  rom lingering in
3500: 20 75 6e 75 73 65 64 20 70 61 72 74 73 20 6f 66   unused parts of
3510: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
3520: 6c 65 20 61 66 74 65 72 20 69 74 0a 20 20 68 61  le after it.  ha
3530: 73 20 61 6c 6c 65 67 65 64 6c 79 20 62 65 65 6e  s allegedly been
3540: 20 64 65 6c 65 74 65 64 2e 20 20 53 65 65 20 74   deleted.  See t
3550: 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  he documentation
3560: 20 6f 6e 20 74 68 65 0a 20 20 5b 73 65 63 75 72   on the.  [secur
3570: 65 5f 64 65 6c 65 74 65 20 70 72 61 67 6d 61 5d  e_delete pragma]
3580: 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20   for additional 
3590: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a 0a  information..}..
35a0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
35b0: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
35c0: 45 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 20  E=<i>&lt;0 or 1 
35d0: 6f 72 20 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  or 2&gt;</i>} {.
35e0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f    This option co
35f0: 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 6f  ntrols whether o
3600: 72 20 6e 6f 74 20 63 6f 64 65 20 69 73 20 69 6e  r not code is in
3610: 63 6c 75 64 65 64 20 69 6e 20 53 51 4c 69 74 65  cluded in SQLite
3620: 20 74 6f 0a 20 20 65 6e 61 62 6c 65 20 69 74 20   to.  enable it 
3630: 74 6f 20 6f 70 65 72 61 74 65 20 73 61 66 65 6c  to operate safel
3640: 79 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65  y in a multithre
3650: 61 64 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74  aded environment
3660: 2e 20 20 54 68 65 0a 20 20 64 65 66 61 75 6c 74  .  The.  default
3670: 20 69 73 20 53 51 4c 49 54 45 5f 54 48 52 45 41   is SQLITE_THREA
3680: 44 53 41 46 45 3d 31 20 77 68 69 63 68 20 69 73  DSAFE=1 which is
3690: 20 73 61 66 65 20 66 6f 72 20 75 73 65 20 69 6e   safe for use in
36a0: 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64   a multithreaded
36b0: 0a 20 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20  .  environment. 
36c0: 20 57 68 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77   When compiled w
36d0: 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52 45 41  ith SQLITE_THREA
36e0: 44 53 41 46 45 3d 30 20 61 6c 6c 20 6d 75 74 65  DSAFE=0 all mute
36f0: 78 69 6e 67 20 63 6f 64 65 0a 20 20 69 73 20 6f  xing code.  is o
3700: 6d 69 74 74 65 64 20 61 6e 64 20 69 74 20 69 73  mitted and it is
3710: 20 75 6e 73 61 66 65 20 74 6f 20 75 73 65 20 53   unsafe to use S
3720: 51 4c 69 74 65 20 69 6e 20 61 20 6d 75 6c 74 69  QLite in a multi
3730: 74 68 72 65 61 64 65 64 20 70 72 6f 67 72 61 6d  threaded program
3740: 2e 0a 20 20 57 68 65 6e 20 63 6f 6d 70 69 6c 65  ..  When compile
3750: 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48  d with SQLITE_TH
3760: 52 45 41 44 53 41 46 45 3d 32 2c 20 53 51 4c 69  READSAFE=2, SQLi
3770: 74 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 69  te can be used i
3780: 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65  n a multithreade
3790: 64 0a 20 20 70 72 6f 67 72 61 6d 20 73 6f 20 6c  d.  program so l
37a0: 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20 74 68  ong as no two th
37b0: 72 65 61 64 73 20 61 74 74 65 6d 70 74 20 74 6f  reads attempt to
37c0: 20 75 73 65 20 74 68 65 20 73 61 6d 65 0a 20 20   use the same.  
37d0: 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63  [database connec
37e0: 74 69 6f 6e 5d 20 28 6f 72 20 61 6e 79 20 5b 70  tion] (or any [p
37f0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
3800: 74 73 5d 20 64 65 72 69 76 65 64 20 66 72 6f 6d  ts] derived from
3810: 0a 20 20 74 68 61 74 20 64 61 74 61 62 61 73 65  .  that database
3820: 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 20 61 74 20   connection) at 
3830: 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a  the same time...
3840: 20 20 54 6f 20 70 75 74 20 69 74 20 61 6e 6f 74    To put it anot
3850: 68 65 72 20 77 61 79 2c 20 53 51 4c 49 54 45 5f  her way, SQLITE_
3860: 54 48 52 45 41 44 53 41 46 45 3d 31 20 73 65 74  THREADSAFE=1 set
3870: 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20  s the default.  
3880: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
3890: 20 74 6f 20 53 65 72 69 61 6c 69 7a 65 64 2e 20   to Serialized. 
38a0: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
38b0: 46 45 3d 32 20 73 65 74 73 20 74 68 65 20 64 65  FE=2 sets the de
38c0: 66 61 75 6c 74 0a 20 20 5b 74 68 72 65 61 64 69  fault.  [threadi
38d0: 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 4d 75 6c 74  ng mode] to Mult
38e0: 69 2d 74 68 72 65 61 64 65 64 2e 20 20 41 6e 64  i-threaded.  And
38f0: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
3900: 46 45 3d 30 20 73 65 74 73 20 74 68 65 0a 20 20  FE=0 sets the.  
3910: 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d  [threading mode]
3920: 20 74 6f 20 53 69 6e 67 6c 65 2d 74 68 72 65 61   to Single-threa
3930: 64 65 64 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75  ded...  The valu
3940: 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 48 52 45  e of SQLITE_THRE
3950: 41 44 53 41 46 45 20 63 61 6e 20 62 65 20 64 65  ADSAFE can be de
3960: 74 65 72 6d 69 6e 65 64 20 61 74 20 72 75 6e 2d  termined at run-
3970: 74 69 6d 65 0a 20 20 75 73 69 6e 67 20 74 68 65  time.  using the
3980: 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65 61 64   [sqlite3_thread
3990: 73 61 66 65 28 29 5d 20 69 6e 74 65 72 66 61 63  safe()] interfac
39a0: 65 2e 0a 0a 20 20 57 68 65 6e 20 53 51 4c 69 74  e...  When SQLit
39b0: 65 20 68 61 73 20 62 65 65 6e 20 63 6f 6d 70 69  e has been compi
39c0: 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f  led with SQLITE_
39d0: 54 48 52 45 41 44 53 41 46 45 3d 31 20 6f 72 0a  THREADSAFE=1 or.
39e0: 20 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53    SQLITE_THREADS
39f0: 41 46 45 3d 32 20 74 68 65 6e 20 74 68 65 20 5b  AFE=2 then the [
3a00: 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 0a  threading mode].
3a10: 20 20 63 61 6e 20 62 65 20 61 6c 74 65 72 65 64    can be altered
3a20: 20 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69   at run-time usi
3a30: 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  ng the [sqlite3_
3a40: 63 6f 6e 66 69 67 28 29 5d 20 69 6e 74 65 72 66  config()] interf
3a50: 61 63 65 20 74 6f 67 65 74 68 65 72 0a 20 20 77  ace together.  w
3a60: 69 74 68 20 6f 6e 65 20 6f 66 20 74 68 65 73 65  ith one of these
3a70: 20 76 65 72 62 73 3a 0a 0a 20 20 3c 75 6c 3e 0a   verbs:..  <ul>.
3a80: 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f    <li>[SQLITE_CO
3a90: 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 41  NFIG_SINGLETHREA
3aa0: 44 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45  D].  <li>[SQLITE
3ab0: 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52  _CONFIG_MULTITHR
3ac0: 45 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49  EAD].  <li>[SQLI
3ad0: 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49 41 4c  TE_CONFIG_SERIAL
3ae0: 49 5a 45 44 5d 0a 20 20 3c 2f 75 6c 3e 0a 0a 20  IZED].  </ul>.. 
3af0: 20 54 68 65 20 5b 53 51 4c 49 54 45 5f 4f 50 45   The [SQLITE_OPE
3b00: 4e 5f 4e 4f 4d 55 54 45 58 5d 20 61 6e 64 0a 20  N_NOMUTEX] and. 
3b10: 20 5b 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55   [SQLITE_OPEN_FU
3b20: 4c 4c 4d 55 54 45 58 5d 20 66 6c 61 67 73 20 74  LLMUTEX] flags t
3b30: 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f  o [sqlite3_open_
3b40: 76 32 28 29 5d 20 63 61 6e 20 61 6c 73 6f 20 62  v2()] can also b
3b50: 65 20 75 73 65 64 0a 20 20 74 6f 20 61 64 6a 75  e used.  to adju
3b60: 73 74 20 74 68 65 20 5b 74 68 72 65 61 64 69 6e  st the [threadin
3b70: 67 20 6d 6f 64 65 5d 20 6f 66 20 69 6e 64 69 76  g mode] of indiv
3b80: 69 64 75 61 6c 20 5b 64 61 74 61 62 61 73 65 20  idual [database 
3b90: 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 0a 20 20 61  connections].  a
3ba0: 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a 20 20 4e  t run-time...  N
3bb0: 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 53 51  ote that when SQ
3bc0: 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64  Lite is compiled
3bd0: 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52   with SQLITE_THR
3be0: 45 41 44 53 41 46 45 3d 30 2c 20 74 68 65 20 63  EADSAFE=0, the c
3bf0: 6f 64 65 0a 20 20 74 6f 20 6d 61 6b 65 20 53 51  ode.  to make SQ
3c00: 4c 69 74 65 20 74 68 72 65 61 64 73 61 66 65 20  Lite threadsafe 
3c10: 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20  is omitted from 
3c20: 74 68 65 20 62 75 69 6c 64 2e 20 20 57 68 65 6e  the build.  When
3c30: 20 74 68 69 73 20 6f 63 63 75 72 73 2c 0a 20 20   this occurs,.  
3c40: 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65  it is impossible
3c50: 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 5b   to change the [
3c60: 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20  threading mode] 
3c70: 61 74 20 73 74 61 72 74 2d 74 69 6d 65 20 6f 72  at start-time or
3c80: 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a 20 20 53 65   run-time...  Se
3c90: 65 20 74 68 65 20 5b 74 68 72 65 61 64 69 6e 67  e the [threading
3ca0: 20 6d 6f 64 65 5d 20 64 6f 63 75 6d 65 6e 74 61   mode] documenta
3cb0: 74 69 6f 6e 20 66 6f 72 20 61 64 64 69 74 69 6f  tion for additio
3cc0: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a  nal information.
3cd0: 20 20 6f 6e 20 61 73 70 65 63 74 73 20 6f 66 20    on aspects of 
3ce0: 75 73 69 6e 67 20 53 51 4c 69 74 65 20 69 6e 20  using SQLite in 
3cf0: 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20  a multithreaded 
3d00: 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 0a 7d 0a 0a  environment..}..
3d10: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3d20: 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52  SQLITE_TEMP_STOR
3d30: 45 3d 3c 69 3e 26 6c 74 3b 30 20 74 68 72 6f 75  E=<i>&lt;0 throu
3d40: 67 68 20 33 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  gh 3&gt;</i>} {.
3d50: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f    This option co
3d60: 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 72 20 74  ntrols whether t
3d70: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 61  emporary files a
3d80: 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69 73  re stored on dis
3d90: 6b 20 6f 72 0a 20 20 69 6e 20 6d 65 6d 6f 72 79  k or.  in memory
3da0: 2e 20 20 54 68 65 20 6d 65 61 6e 69 6e 67 73 20  .  The meanings 
3db0: 66 6f 72 20 76 61 72 69 6f 75 73 20 73 65 74 74  for various sett
3dc0: 69 6e 67 73 20 6f 66 20 74 68 69 73 20 63 6f 6d  ings of this com
3dd0: 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70 74 69  pile-time.  opti
3de0: 6f 6e 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77  on are as follow
3df0: 73 3a 0a 0a 20 20 3c 74 61 62 6c 65 20 63 65 6c  s:..  <table cel
3e00: 6c 70 61 64 64 69 6e 67 3d 22 32 22 20 62 6f 72  lpadding="2" bor
3e10: 64 65 72 3d 22 31 22 3e 0a 20 20 3c 74 72 3e 3c  der="1">.  <tr><
3e20: 74 68 3e 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53  th>SQLITE_TEMP_S
3e30: 54 4f 52 45 3c 2f 74 68 3e 3c 74 68 3e 4d 65 61  TORE</th><th>Mea
3e40: 6e 69 6e 67 3c 2f 74 68 3e 3c 2f 74 72 3e 0a 20  ning</th></tr>. 
3e50: 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22   <tr><td align="
3e60: 63 65 6e 74 65 72 22 3e 30 3c 2f 74 64 3e 3c 74  center">0</td><t
3e70: 64 3e 41 6c 77 61 79 73 20 75 73 65 20 74 65 6d  d>Always use tem
3e80: 70 6f 72 61 72 79 20 66 69 6c 65 73 3c 2f 74 64  porary files</td
3e90: 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64  ></tr>.  <tr><td
3ea0: 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e   align="center">
3eb0: 31 3c 2f 74 64 3e 3c 74 64 3e 55 73 65 20 66 69  1</td><td>Use fi
3ec0: 6c 65 73 20 62 79 20 64 65 66 61 75 6c 74 20 62  les by default b
3ed0: 75 74 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20 5b  ut allow the.  [
3ee0: 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 74 6f 72  PRAGMA temp_stor
3ef0: 65 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76  e] command to ov
3f00: 65 72 72 69 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e  erride</td></tr>
3f10: 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e  .  <tr><td align
3f20: 3d 22 63 65 6e 74 65 72 22 3e 32 3c 2f 74 64 3e  ="center">2</td>
3f30: 3c 74 64 3e 55 73 65 20 6d 65 6d 6f 72 79 20 62  <td>Use memory b
3f40: 79 20 64 65 66 61 75 6c 74 20 62 75 74 20 61 6c  y default but al
3f50: 6c 6f 77 20 74 68 65 0a 20 20 5b 50 52 41 47 4d  low the.  [PRAGM
3f60: 41 20 74 65 6d 70 5f 73 74 6f 72 65 5d 20 63 6f  A temp_store] co
3f70: 6d 6d 61 6e 64 20 74 6f 20 6f 76 65 72 72 69 64  mmand to overrid
3f80: 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74  e</td></tr>.  <t
3f90: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e  r><td align="cen
3fa0: 74 65 72 22 3e 33 3c 2f 74 64 3e 3c 74 64 3e 41  ter">3</td><td>A
3fb0: 6c 77 61 79 73 20 75 73 65 20 6d 65 6d 6f 72 79  lways use memory
3fc0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 2f 74  </td></tr>.  </t
3fd0: 61 62 6c 65 3e 0a 0a 20 20 54 68 65 20 64 65 66  able>..  The def
3fe0: 61 75 6c 74 20 73 65 74 74 69 6e 67 20 69 73 20  ault setting is 
3ff0: 31 2e 20 20 0a 20 20 41 64 64 69 74 69 6f 6e 61  1.  .  Additiona
4000: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61  l information ca
4010: 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 5b 74  n be found in [t
4020: 65 6d 70 73 74 6f 72 65 20 7c 20 74 65 6d 70 66  empstore | tempf
4030: 69 6c 65 73 2e 68 74 6d 6c 5d 2e 0a 7d 0a 0a 43  iles.html]..}..C
4040: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
4050: 51 4c 49 54 45 5f 54 52 41 43 45 5f 53 49 5a 45  QLITE_TRACE_SIZE
4060: 5f 4c 49 4d 49 54 3d 3c 69 3e 4e 3c 2f 69 3e 7d  _LIMIT=<i>N</i>}
4070: 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6d 61 63   {.  If this mac
4080: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 20 74 6f  ro is defined to
4090: 20 61 20 70 6f 73 69 74 69 76 65 20 69 6e 74 65   a positive inte
40a0: 67 65 72 20 3c 69 3e 4e 3c 2f 69 3e 2c 20 74 68  ger <i>N</i>, th
40b0: 65 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66  en the length of
40c0: 0a 20 20 73 74 72 69 6e 67 73 20 61 6e 64 20 42  .  strings and B
40d0: 4c 4f 42 20 74 68 61 74 20 61 72 65 20 65 78 70  LOB that are exp
40e0: 61 6e 64 65 64 20 69 6e 74 6f 20 70 61 72 61 6d  anded into param
40f0: 65 74 65 72 73 20 69 6e 20 74 68 65 20 6f 75 74  eters in the out
4100: 70 75 74 20 6f 66 0a 20 20 5b 73 71 6c 69 74 65  put of.  [sqlite
4110: 33 5f 74 72 61 63 65 28 29 5d 20 69 73 20 6c 69  3_trace()] is li
4120: 6d 69 74 65 64 20 74 6f 20 3c 69 3e 4e 3c 2f 69  mited to <i>N</i
4130: 3e 20 62 79 74 65 73 2e 20 20 0a 7d 0a 0a 43 4f  > bytes.  .}..CO
4140: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
4150: 4c 49 54 45 5f 55 53 45 5f 55 52 49 7d 20 7b 0a  LITE_USE_URI} {.
4160: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
4170: 75 73 65 73 20 74 68 65 20 5b 55 52 49 20 66 69  uses the [URI fi
4180: 6c 65 6e 61 6d 65 5d 20 70 72 6f 63 65 73 73 20  lename] process 
4190: 6c 6f 67 69 63 20 74 6f 20 62 65 20 65 6e 61 62  logic to be enab
41a0: 6c 65 64 20 62 79 20 0a 20 20 64 65 66 61 75 6c  led by .  defaul
41b0: 74 2e 20 20 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 0a  t.  .}..</tcl>..
41c0: 3c 61 20 6e 61 6d 65 3d 22 65 6e 61 62 6c 65 66  <a name="enablef
41d0: 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68  eatures"></a>.<h
41e0: 32 3e 31 2e 34 20 4f 70 74 69 6f 6e 73 20 54 6f  2>1.4 Options To
41f0: 20 45 6e 61 62 6c 65 20 46 65 61 74 75 72 65 73   Enable Features
4200: 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65 64   Normally Turned
4210: 20 4f 66 66 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e   Off</h2>..<tcl>
4220: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4230: 7b 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55 52  {SQLITE_ALLOW_UR
4240: 49 5f 41 55 54 48 4f 52 49 54 59 7d 20 7b 0a 20  I_AUTHORITY} {. 
4250: 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 5d   [URI filenames]
4260: 20 6e 6f 72 6d 61 6c 6c 79 20 74 68 72 6f 77 20   normally throw 
4270: 61 6e 20 65 72 72 6f 72 20 69 73 20 74 68 65 20  an error is the 
4280: 61 75 74 68 6f 72 69 74 79 20 73 65 63 74 69 6f  authority sectio
4290: 6e 20 69 73 0a 20 20 6e 6f 74 20 65 69 74 68 65  n is.  not eithe
42a0: 72 20 65 6d 70 74 79 20 6f 72 20 22 6c 6f 63 61  r empty or "loca
42b0: 6c 68 6f 73 74 22 2e 20 20 48 6f 77 65 76 65 72  lhost".  However
42c0: 2c 20 69 66 20 53 51 4c 69 74 65 20 69 73 20 63  , if SQLite is c
42d0: 6f 6d 70 69 6c 65 64 20 77 69 74 68 0a 20 20 74  ompiled with.  t
42e0: 68 65 20 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f  he SQLITE_ALLOW_
42f0: 55 52 49 5f 41 55 54 48 4f 52 49 54 59 20 63 6f  URI_AUTHORITY co
4300: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
4310: 6e 2c 20 74 68 65 6e 20 74 68 65 20 55 52 49 20  n, then the URI 
4320: 69 73 0a 20 20 69 73 20 63 6f 6e 76 65 72 74 65  is.  is converte
4330: 64 20 69 6e 74 6f 20 61 20 55 6e 69 66 6f 72 6d  d into a Uniform
4340: 20 4e 61 6d 69 6e 67 20 43 6f 6e 76 65 6e 74 69   Naming Conventi
4350: 6f 6e 20 28 55 4e 43 29 20 66 69 6c 65 6e 61 6d  on (UNC) filenam
4360: 65 20 61 6e 64 20 70 61 73 73 65 64 0a 20 20 64  e and passed.  d
4370: 6f 77 6e 20 74 6f 20 74 68 65 20 75 6e 64 65 72  own to the under
4380: 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67 20  lying operating 
4390: 73 79 73 74 65 6d 20 74 68 61 74 20 77 61 79 2e  system that way.
43a0: 20 20 0a 20 20 3c 70 3e 0a 20 20 53 6f 6d 65 20    .  <p>.  Some 
43b0: 66 75 74 75 72 65 20 76 65 72 73 69 6f 6e 73 20  future versions 
43c0: 6f 66 20 53 51 4c 69 74 65 20 6d 61 79 20 63 68  of SQLite may ch
43d0: 61 6e 67 65 20 74 6f 20 65 6e 61 62 6c 65 20 74  ange to enable t
43e0: 68 69 73 20 66 65 61 74 75 72 65 0a 20 20 62 79  his feature.  by
43f0: 20 64 65 66 61 75 6c 74 2e 0a 7d 0a 43 4f 4d 50   default..}.COMP
4400: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
4410: 54 45 5f 41 4c 4c 4f 57 5f 43 4f 56 45 52 49 4e  TE_ALLOW_COVERIN
4420: 47 5f 49 4e 44 45 58 5f 53 43 41 4e 3d 3c 69 3e  G_INDEX_SCAN=<i>
4430: 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f  &lt;0 or 1&gt;</
4440: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 43 2d 70  i>} {.  This C-p
4450: 72 65 70 72 6f 63 65 73 73 20 6d 61 63 72 6f 20  reprocess macro 
4460: 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 64  determines the d
4470: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 6f  efault setting o
4480: 66 20 74 68 65 0a 20 20 5b 53 51 4c 49 54 45 5f  f the.  [SQLITE_
4490: 43 4f 4e 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f  CONFIG_COVERING_
44a0: 49 4e 44 45 58 5f 53 43 41 4e 5d 20 63 6f 6e 66  INDEX_SCAN] conf
44b0: 69 67 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e  iguration settin
44c0: 67 2e 20 20 49 74 20 64 65 66 61 75 6c 74 73 0a  g.  It defaults.
44d0: 20 20 74 6f 20 31 20 28 6f 6e 29 20 77 68 69 63    to 1 (on) whic
44e0: 68 20 6d 65 61 6e 73 20 74 68 61 74 20 63 6f 76  h means that cov
44f0: 65 72 69 6e 67 20 69 6e 64 69 63 65 73 20 61 72  ering indices ar
4500: 65 20 75 73 65 64 20 66 6f 72 20 66 75 6c 6c 20  e used for full 
4510: 74 61 62 6c 65 0a 20 20 73 63 61 6e 73 20 77 68  table.  scans wh
4520: 65 72 65 20 70 6f 73 73 69 62 6c 65 2c 20 69 6e  ere possible, in
4530: 20 6f 72 64 65 72 20 74 6f 20 72 65 64 75 63 65   order to reduce
4540: 20 49 2f 4f 20 61 6e 64 20 69 6d 70 72 6f 76 65   I/O and improve
4550: 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 20 20   performance..  
4560: 48 6f 77 65 76 65 72 2c 20 74 68 65 20 75 73 65  However, the use
4570: 20 6f 66 20 61 20 63 6f 76 65 72 69 6e 67 20 69   of a covering i
4580: 6e 64 65 78 20 66 6f 72 20 61 20 66 75 6c 6c 20  ndex for a full 
4590: 73 63 61 6e 20 77 69 6c 6c 20 63 61 75 73 65 20  scan will cause 
45a0: 72 65 73 75 6c 74 73 0a 20 20 74 6f 20 61 70 70  results.  to app
45b0: 65 61 72 20 69 6e 20 61 20 64 69 66 66 65 72 65  ear in a differe
45c0: 6e 74 20 6f 72 64 65 72 20 66 72 6f 6d 20 6c 65  nt order from le
45d0: 67 61 63 79 2c 20 77 68 69 63 68 20 63 6f 75 6c  gacy, which coul
45e0: 64 20 63 61 75 73 65 20 73 6f 6d 65 0a 20 20 28  d cause some.  (
45f0: 69 6e 63 6f 72 72 65 63 74 6c 79 2d 63 6f 64 65  incorrectly-code
4600: 64 29 20 6c 65 67 61 63 79 20 61 70 70 6c 69 63  d) legacy applic
4610: 61 74 69 6f 6e 73 20 74 6f 20 62 72 65 61 6b 2e  ations to break.
4620: 20 20 48 65 6e 63 65 2c 20 74 68 65 20 63 6f 76    Hence, the cov
4630: 65 72 69 6e 67 0a 20 20 69 6e 64 65 78 20 73 63  ering.  index sc
4640: 61 6e 20 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65  an option can be
4650: 20 64 69 73 61 62 6c 65 64 20 61 74 20 63 6f 6d   disabled at com
4660: 70 69 6c 65 2d 74 69 6d 65 20 6f 6e 20 73 79 73  pile-time on sys
4670: 74 65 6d 73 20 74 68 61 74 20 77 68 61 74 0a 20  tems that what. 
4680: 20 74 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65   to minimize the
4690: 69 72 20 72 69 73 6b 20 6f 66 20 65 78 70 6f 73  ir risk of expos
46a0: 69 6e 67 20 65 72 72 6f 72 73 20 69 6e 20 6c 65  ing errors in le
46b0: 67 61 63 79 20 61 70 70 6c 69 63 61 74 69 6f 6e  gacy application
46c0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
46d0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
46e0: 42 4c 45 5f 38 5f 33 5f 4e 41 4d 45 53 3d 3c 69  BLE_8_3_NAMES=<i
46f0: 3e 26 6c 74 3b 31 20 6f 72 20 32 26 67 74 3b 3c  >&lt;1 or 2&gt;<
4700: 2f 69 3e 7d 20 7b 0a 20 20 49 66 20 74 68 69 73  /i>} {.  If this
4710: 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20   C-preprocessor 
4720: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
4730: 2c 20 74 68 65 6e 20 65 78 74 72 61 20 63 6f 64  , then extra cod
4740: 65 20 69 73 0a 20 20 69 6e 63 6c 75 64 65 64 20  e is.  included 
4750: 74 68 61 74 20 61 6c 6c 6f 77 73 20 53 51 4c 69  that allows SQLi
4760: 74 65 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 6f  te to function o
4770: 6e 20 61 20 66 69 6c 65 73 79 73 74 65 6d 20 74  n a filesystem t
4780: 68 61 74 0a 20 20 6f 6e 6c 79 20 73 75 70 70 6f  hat.  only suppo
4790: 72 74 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73  rt 8+3 filenames
47a0: 2e 20 20 49 66 20 74 68 65 20 76 61 6c 75 65 20  .  If the value 
47b0: 6f 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73  of this macro is
47c0: 20 31 2c 0a 20 20 74 68 65 6e 20 74 68 65 20 64   1,.  then the d
47d0: 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20  efault behavior 
47e0: 69 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 74  is to continue t
47f0: 6f 20 75 73 65 20 6c 6f 6e 67 20 66 69 6c 65 6e  o use long filen
4800: 61 6d 65 73 20 61 6e 64 0a 20 20 74 6f 20 6f 6e  ames and.  to on
4810: 6c 79 20 75 73 65 20 38 2b 33 20 66 69 6c 65 6e  ly use 8+3 filen
4820: 61 6d 65 73 20 69 66 20 74 68 65 20 0a 20 20 64  ames if the .  d
4830: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
4840: 6f 6e 20 69 73 20 6f 70 65 6e 65 64 20 75 73 69  on is opened usi
4850: 6e 67 20 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65  ng [URI filename
4860: 73 5d 20 77 69 74 68 0a 20 20 74 68 65 20 22 3c  s] with.  the "<
4870: 74 74 3e 38 5f 33 5f 6e 61 6d 65 73 3d 31 3c 2f  tt>8_3_names=1</
4880: 74 74 3e 22 20 71 75 65 72 79 20 70 61 72 61 6d  tt>" query param
4890: 65 74 65 72 2e 20 20 49 66 20 74 68 65 20 76 61  eter.  If the va
48a0: 6c 75 65 20 6f 66 0a 20 20 74 68 69 73 20 6d 61  lue of.  this ma
48b0: 63 72 6f 20 69 73 20 32 2c 20 74 68 65 6e 20 74  cro is 2, then t
48c0: 68 65 20 75 73 65 20 6f 66 20 38 2b 33 20 66 69  he use of 8+3 fi
48d0: 6c 65 6e 61 6d 65 73 20 62 65 63 6f 6d 65 73 20  lenames becomes 
48e0: 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 62 75  the default.  bu
48f0: 74 20 6d 61 79 20 62 65 20 64 69 73 61 62 6c 65  t may be disable
4900: 64 20 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 3c  d on using the <
4910: 74 74 3e 38 5f 33 5f 6e 61 6d 65 73 3d 30 3c 2f  tt>8_3_names=0</
4920: 74 74 3e 20 71 75 65 72 79 20 70 61 72 61 6d 65  tt> query parame
4930: 74 65 72 2e 0a 20 20 53 65 65 20 0a 7d 0a 0a 43  ter..  See .}..C
4940: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
4950: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f  QLITE_ENABLE_ATO
4960: 4d 49 43 5f 57 52 49 54 45 7d 20 7b 0a 20 20 49  MIC_WRITE} {.  I
4970: 66 20 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63  f this C-preproc
4980: 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 73 20 64  essor macro is d
4990: 65 66 69 6e 65 64 20 61 6e 64 20 69 66 20 74 68  efined and if th
49a0: 65 0a 20 20 78 44 65 76 69 63 65 43 68 61 72 61  e.  xDeviceChara
49b0: 63 74 65 72 69 73 74 69 63 73 20 6d 65 74 68 6f  cteristics metho
49c0: 64 20 6f 66 20 5b 73 71 6c 69 74 65 33 5f 69 6f  d of [sqlite3_io
49d0: 5f 6d 65 74 68 6f 64 73 5d 20 6f 62 6a 65 63 74  _methods] object
49e0: 20 66 6f 72 0a 20 20 61 20 64 61 74 61 62 61 73   for.  a databas
49f0: 65 20 66 69 6c 65 20 72 65 70 6f 72 74 73 20 28  e file reports (
4a00: 76 69 61 20 6f 6e 65 20 6f 66 20 74 68 65 20 5b  via one of the [
4a10: 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f  SQLITE_IOCAP_ATO
4a20: 4d 49 43 5d 20 62 69 74 73 29 0a 20 20 74 68 61  MIC] bits).  tha
4a30: 74 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d  t the filesystem
4a40: 20 73 75 70 70 6f 72 74 73 20 61 74 6f 6d 69 63   supports atomic
4a50: 20 77 72 69 74 65 73 20 61 6e 64 20 69 66 20 61   writes and if a
4a60: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 69   transaction.  i
4a70: 6e 76 6f 6c 76 65 73 20 61 20 63 68 61 6e 67 65  nvolves a change
4a80: 20 74 6f 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c   to only a singl
4a90: 65 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61  e page of the da
4aa0: 74 61 62 61 73 65 20 66 69 6c 65 2c 0a 20 20 74  tabase file,.  t
4ab0: 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74  hen the transact
4ac0: 69 6f 6e 20 63 6f 6d 6d 69 74 73 20 77 69 74 68  ion commits with
4ad0: 20 6a 75 73 74 20 61 20 73 69 6e 67 6c 65 20 77   just a single w
4ae0: 72 69 74 65 20 72 65 71 75 65 73 74 20 6f 66 0a  rite request of.
4af0: 20 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20    a single page 
4b00: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  of the database 
4b10: 61 6e 64 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20  and no rollback 
4b20: 6a 6f 75 72 6e 61 6c 20 69 73 20 63 72 65 61 74  journal is creat
4b30: 65 64 0a 20 20 6f 72 20 77 72 69 74 74 65 6e 2e  ed.  or written.
4b40: 20 20 4f 6e 20 66 69 6c 65 73 79 73 74 65 6d 73    On filesystems
4b50: 20 74 68 61 74 20 73 75 70 70 6f 72 74 20 61 74   that support at
4b60: 6f 6d 69 63 20 77 72 69 74 65 73 2c 20 74 68 69  omic writes, thi
4b70: 73 0a 20 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e  s.  optimization
4b80: 20 63 61 6e 20 72 65 73 75 6c 74 20 69 6e 20 73   can result in s
4b90: 69 67 6e 69 66 69 63 61 6e 74 20 73 70 65 65 64  ignificant speed
4ba0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 66 6f   improvements fo
4bb0: 72 0a 20 20 73 6d 61 6c 6c 20 75 70 64 61 74 65  r.  small update
4bc0: 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 66 65 77  s.  However, few
4bd0: 20 66 69 6c 65 73 79 73 74 65 6d 73 20 73 75 70   filesystems sup
4be0: 70 6f 72 74 20 74 68 69 73 20 63 61 70 61 62 69  port this capabi
4bf0: 6c 69 74 79 0a 20 20 61 6e 64 20 74 68 65 20 63  lity.  and the c
4c00: 6f 64 65 20 70 61 74 68 73 20 74 68 61 74 20 63  ode paths that c
4c10: 68 65 63 6b 20 66 6f 72 20 74 68 69 73 20 63 61  heck for this ca
4c20: 70 61 62 69 6c 69 74 79 20 73 6c 6f 77 20 64 6f  pability slow do
4c30: 77 6e 20 77 72 69 74 65 0a 20 20 70 65 72 66 6f  wn write.  perfo
4c40: 72 6d 61 6e 63 65 20 6f 6e 20 73 79 73 74 65 6d  rmance on system
4c50: 73 20 74 68 61 74 20 6c 61 63 6b 20 61 74 6f 6d  s that lack atom
4c60: 69 63 20 77 72 69 74 65 20 63 61 70 61 62 69 6c  ic write capabil
4c70: 69 74 79 2c 20 73 6f 20 74 68 69 73 0a 20 20 66  ity, so this.  f
4c80: 65 61 74 75 72 65 20 69 73 20 64 69 73 61 62 6c  eature is disabl
4c90: 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 0a 7d  ed by default..}
4ca0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
4cb0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
4cc0: 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 7d  COLUMN_METADATA}
4cd0: 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 43   {.  When this C
4ce0: 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61  -preprocessor ma
4cf0: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20  cro is defined, 
4d00: 53 51 4c 69 74 65 20 69 6e 63 6c 75 64 65 73 20  SQLite includes 
4d10: 73 6f 6d 65 0a 20 20 61 64 64 69 74 69 6f 6e 61  some.  additiona
4d20: 6c 20 41 50 49 73 20 74 68 61 74 20 70 72 6f 76  l APIs that prov
4d30: 69 64 65 20 63 6f 6e 76 65 6e 69 65 6e 74 20 61  ide convenient a
4d40: 63 63 65 73 73 20 74 6f 20 6d 65 74 61 2d 64 61  ccess to meta-da
4d50: 74 61 20 61 62 6f 75 74 0a 20 20 74 61 62 6c 65  ta about.  table
4d60: 73 20 61 6e 64 20 71 75 65 72 69 65 73 2e 20 20  s and queries.  
4d70: 54 68 65 20 41 50 49 73 20 74 68 61 74 20 61 72  The APIs that ar
4d80: 65 20 65 6e 61 62 6c 65 64 20 62 79 20 74 68 69  e enabled by thi
4d90: 73 20 6f 70 74 69 6f 6e 20 61 72 65 3a 0a 0a 20  s option are:.. 
4da0: 20 3c 75 6c 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71   <ul>.  <li> [sq
4db0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74  lite3_column_dat
4dc0: 61 62 61 73 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f  abase_name()] </
4dd0: 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69  li>.  <li> [sqli
4de0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62  te3_column_datab
4df0: 61 73 65 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f  ase_name16()] </
4e00: 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69  li>.  <li> [sqli
4e10: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65  te3_column_table
4e20: 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20  _name()] </li>. 
4e30: 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63   <li> [sqlite3_c
4e40: 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65  olumn_table_name
4e50: 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c  16()] </li>.  <l
4e60: 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  i> [sqlite3_colu
4e70: 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 28 29  mn_origin_name()
4e80: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
4e90: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f  sqlite3_column_o
4ea0: 72 69 67 69 6e 5f 6e 61 6d 65 31 36 28 29 5d 20  rigin_name16()] 
4eb0: 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71  </li>.  <li> [sq
4ec0: 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75  lite3_table_colu
4ed0: 6d 6e 5f 6d 65 74 61 64 61 74 61 28 29 5d 20 3c  mn_metadata()] <
4ee0: 2f 6c 69 3e 0a 20 20 3c 2f 75 6c 3e 0a 7d 0a 0a  /li>.  </ul>.}..
4ef0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4f00: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54  SQLITE_ENABLE_FT
4f10: 53 33 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69  S3} {.  When thi
4f20: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69  s option is defi
4f30: 6e 65 64 20 69 6e 20 74 68 65 20 5b 61 6d 61 6c  ned in the [amal
4f40: 67 61 6d 61 74 69 6f 6e 5d 2c 20 76 65 72 73 69  gamation], versi
4f50: 6f 6e 20 33 0a 20 20 6f 66 20 74 68 65 20 66 75  on 3.  of the fu
4f60: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 65  ll-text search e
4f70: 6e 67 69 6e 65 20 69 73 20 61 64 64 65 64 20 74  ngine is added t
4f80: 6f 20 74 68 65 20 62 75 69 6c 64 20 61 75 74 6f  o the build auto
4f90: 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d 0a 0a 43 4f  matically..}..CO
4fa0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
4fb0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33  LITE_ENABLE_FTS3
4fc0: 5f 50 41 52 45 4e 54 48 45 53 49 53 7d 20 7b 0a  _PARENTHESIS} {.
4fd0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 6f    This option mo
4fe0: 64 69 66 69 65 73 20 74 68 65 20 71 75 65 72 79  difies the query
4ff0: 20 70 61 74 74 65 72 6e 20 70 61 72 73 65 72 20   pattern parser 
5000: 69 6e 20 46 54 53 33 20 73 75 63 68 20 74 68 61  in FTS3 such tha
5010: 74 20 69 74 0a 20 20 73 75 70 70 6f 72 74 73 20  t it.  supports 
5020: 6f 70 65 72 61 74 6f 72 73 20 41 4e 44 20 61 6e  operators AND an
5030: 64 20 4e 4f 54 20 28 69 6e 20 61 64 64 69 74 69  d NOT (in additi
5040: 6f 6e 20 74 6f 20 74 68 65 20 75 73 75 61 6c 20  on to the usual 
5050: 4f 52 20 61 6e 64 20 4e 45 41 52 29 0a 20 20 61  OR and NEAR).  a
5060: 6e 64 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 71  nd also allows q
5070: 75 65 72 79 20 65 78 70 72 65 73 73 69 6f 6e 73  uery expressions
5080: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 6e 65 73 74   to contain nest
5090: 65 64 20 70 61 72 65 6e 74 68 65 73 69 73 2e 0a  ed parenthesis..
50a0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
50b0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
50c0: 5f 46 54 53 34 7d 20 7b 0a 20 20 57 68 65 6e 20  _FTS4} {.  When 
50d0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
50e0: 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 5b 61  efined in the [a
50f0: 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 2c 20 76 65  malgamation], ve
5100: 72 73 69 6f 6e 73 20 33 20 61 6e 64 20 34 0a 20  rsions 3 and 4. 
5110: 20 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74 65 78   of the full-tex
5120: 74 20 73 65 61 72 63 68 20 65 6e 67 69 6e 65 20  t search engine 
5130: 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  is added to the 
5140: 62 75 69 6c 64 20 61 75 74 6f 6d 61 74 69 63 61  build automatica
5150: 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  lly..}..COMPILE_
5160: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
5170: 4e 41 42 4c 45 5f 49 43 55 7d 20 7b 0a 20 20 54  NABLE_ICU} {.  T
5180: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
5190: 73 20 74 68 65 20 0a 20 20 5b 68 74 74 70 3a 2f  s the .  [http:/
51a0: 2f 77 77 77 2e 69 63 75 2d 70 72 6f 6a 65 63 74  /www.icu-project
51b0: 2e 6f 72 67 2f 20 7c 20 49 6e 74 65 72 6e 61 74  .org/ | Internat
51c0: 69 6f 6e 61 6c 20 43 6f 6d 70 6f 6e 65 6e 74 73  ional Components
51d0: 20 66 6f 72 20 55 6e 69 63 6f 64 65 5d 0a 20 20   for Unicode].  
51e0: 6f 72 20 22 49 43 55 22 20 65 78 74 65 6e 73 69  or "ICU" extensi
51f0: 6f 6e 20 74 6f 20 53 51 4c 69 74 65 20 74 6f 20  on to SQLite to 
5200: 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  be added to the 
5210: 62 75 69 6c 64 2e 20 20 0a 7d 0a 0a 43 4f 4d 50  build.  .}..COMP
5220: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
5230: 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43  TE_ENABLE_IOTRAC
5240: 45 7d 20 7b 0a 20 20 57 68 65 6e 20 62 6f 74 68  E} {.  When both
5250: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65   the SQLite core
5260: 20 61 6e 64 20 74 68 65 20 5b 43 6f 6d 6d 61 6e   and the [Comman
5270: 64 20 4c 69 6e 65 20 49 6e 74 65 72 66 61 63 65  d Line Interface
5280: 5d 20 28 43 4c 49 29 20 61 72 65 20 62 6f 74 68  ] (CLI) are both
5290: 20 0a 20 20 63 6f 6d 70 69 6c 65 64 20 77 69 74   .  compiled wit
52a0: 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 74  h this option, t
52b0: 68 65 6e 20 74 68 65 20 43 4c 49 20 70 72 6f 76  hen the CLI prov
52c0: 69 64 65 73 20 61 6e 20 65 78 74 72 61 20 63 6f  ides an extra co
52d0: 6d 6d 61 6e 64 0a 20 20 6e 61 6d 65 64 20 22 2e  mmand.  named ".
52e0: 69 6f 74 72 61 63 65 22 20 74 68 61 74 20 70 72  iotrace" that pr
52f0: 6f 76 69 64 65 73 20 61 20 6c 6f 77 2d 6c 65 76  ovides a low-lev
5300: 65 6c 20 6c 6f 67 20 6f 66 20 49 2f 4f 20 61 63  el log of I/O ac
5310: 74 69 76 69 74 79 2e 0a 20 20 54 68 69 73 20 6f  tivity..  This o
5320: 70 74 69 6f 6e 20 69 73 20 65 78 70 65 72 69 6d  ption is experim
5330: 65 6e 74 61 6c 20 61 6e 64 20 6d 61 79 20 62 65  ental and may be
5340: 20 64 69 73 63 6f 6e 74 69 6e 75 65 64 20 69 6e   discontinued in
5350: 20 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 73   a future releas
5360: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
5370: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
5380: 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c  BLE_LOCKING_STYL
5390: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
53a0: 6f 6e 20 65 6e 61 62 6c 65 73 20 61 64 64 69 74  on enables addit
53b0: 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 69 6e 20 74  ional logic in t
53c0: 68 65 20 4f 53 20 69 6e 74 65 72 66 61 63 65 20  he OS interface 
53d0: 6c 61 79 65 72 20 66 6f 72 0a 20 20 4d 61 63 20  layer for.  Mac 
53e0: 4f 53 20 58 2e 20 54 68 65 20 61 64 64 69 74 69  OS X. The additi
53f0: 6f 6e 61 6c 20 6c 6f 67 69 63 20 61 74 74 65 6d  onal logic attem
5400: 70 74 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65  pts to determine
5410: 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65   the type of the
5420: 0a 20 20 75 6e 64 65 72 6c 79 69 6e 67 20 66 69  .  underlying fi
5430: 6c 65 73 79 73 74 65 6d 20 61 6e 64 20 63 68 6f  lesystem and cho
5440: 6f 73 65 20 61 6e 64 20 61 6c 74 65 72 6e 61 74  ose and alternat
5450: 69 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61  ive locking stra
5460: 74 65 67 79 0a 20 20 74 68 61 74 20 77 6f 72 6b  tegy.  that work
5470: 73 20 63 6f 72 72 65 63 74 6c 79 20 66 6f 72 20  s correctly for 
5480: 74 68 61 74 20 66 69 6c 65 73 79 73 74 65 6d 20  that filesystem 
5490: 74 79 70 65 2e 20 46 69 76 65 20 6c 6f 63 6b 69  type. Five locki
54a0: 6e 67 20 73 74 72 61 74 65 67 69 65 73 20 0a 20  ng strategies . 
54b0: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 3a 0a   are available:.
54c0: 0a 20 20 3c 75 6c 3e 0a 20 20 20 20 3c 6c 69 3e  .  <ul>.    <li>
54d0: 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20 73   POSIX locking s
54e0: 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 74 68  tyle. This is th
54f0: 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e  e default lockin
5500: 67 20 73 74 79 6c 65 20 61 6e 64 20 74 68 65 0a  g style and the.
5510: 20 20 20 20 20 20 20 20 20 73 74 79 6c 65 20 75           style u
5520: 73 65 64 20 62 79 20 6f 74 68 65 72 20 28 6e 6f  sed by other (no
5530: 6e 20 4d 61 63 20 4f 53 20 58 29 20 55 6e 69 78  n Mac OS X) Unix
5540: 65 73 2e 20 4c 6f 63 6b 73 20 61 72 65 20 6f 62  es. Locks are ob
5550: 74 61 69 6e 65 64 20 61 6e 64 20 0a 20 20 20 20  tained and .    
5560: 20 20 20 20 20 72 65 6c 65 61 73 65 64 20 75 73       released us
5570: 69 6e 67 20 74 68 65 20 66 63 6e 74 6c 28 29 20  ing the fcntl() 
5580: 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20  system call...  
5590: 20 20 3c 6c 69 3e 20 41 46 50 20 6c 6f 63 6b 69    <li> AFP locki
55a0: 6e 67 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c  ng style. This l
55b0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20  ocking style is 
55c0: 75 73 65 64 20 66 6f 72 20 6e 65 74 77 6f 72 6b  used for network
55d0: 20 66 69 6c 65 20 0a 20 20 20 20 20 20 20 20 20   file .         
55e0: 73 79 73 74 65 6d 73 20 74 68 61 74 20 75 73 65  systems that use
55f0: 20 74 68 65 20 41 46 50 20 28 41 70 70 6c 65 20   the AFP (Apple 
5600: 46 69 6c 69 6e 67 20 50 72 6f 74 6f 63 6f 6c 29  Filing Protocol)
5610: 20 70 72 6f 74 6f 63 6f 6c 2e 20 4c 6f 63 6b 73   protocol. Locks
5620: 0a 20 20 20 20 20 20 20 20 20 61 72 65 20 6f 62  .         are ob
5630: 74 61 69 6e 65 64 20 62 79 20 63 61 6c 6c 69 6e  tained by callin
5640: 67 20 74 68 65 20 6c 69 62 72 61 72 79 20 66 75  g the library fu
5650: 6e 63 74 69 6f 6e 20 5f 41 46 50 46 53 53 65 74  nction _AFPFSSet
5660: 4c 6f 63 6b 28 29 2e 0a 0a 20 20 20 20 3c 6c 69  Lock()...    <li
5670: 3e 20 46 6c 6f 63 6b 20 6c 6f 63 6b 69 6e 67 20  > Flock locking 
5680: 73 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 75  style. This is u
5690: 73 65 64 20 66 6f 72 20 66 69 6c 65 2d 73 79 73  sed for file-sys
56a0: 74 65 6d 73 20 74 68 61 74 20 64 6f 20 6e 6f 74  tems that do not
56b0: 0a 20 20 20 20 20 20 20 20 20 73 75 70 70 6f 72  .         suppor
56c0: 74 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20  t POSIX locking 
56d0: 73 74 79 6c 65 2e 20 4c 6f 63 6b 73 20 61 72 65  style. Locks are
56e0: 20 6f 62 74 61 69 6e 65 64 20 61 6e 64 20 72 65   obtained and re
56f0: 6c 65 61 73 65 64 20 75 73 69 6e 67 0a 20 20 20  leased using.   
5700: 20 20 20 20 20 20 74 68 65 20 66 6c 6f 63 6b 28        the flock(
5710: 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a  ) system call...
5720: 20 20 20 20 3c 6c 69 3e 20 44 6f 74 2d 66 69 6c      <li> Dot-fil
5730: 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  e locking style.
5740: 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74   This locking st
5750: 79 6c 65 20 69 73 20 75 73 65 64 20 77 68 65 6e  yle is used when
5760: 20 6e 65 69 74 68 65 72 0a 20 20 20 20 20 20 20   neither.       
5770: 20 20 66 6c 6f 63 6b 20 6e 6f 72 20 50 4f 53 49    flock nor POSI
5780: 58 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 73  X locking styles
5790: 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 20 62   are supported b
57a0: 79 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65  y the file syste
57b0: 6d 2e 0a 20 20 20 20 20 20 20 20 20 44 61 74 61  m..         Data
57c0: 62 61 73 65 20 6c 6f 63 6b 73 20 61 72 65 20 6f  base locks are o
57d0: 62 74 61 69 6e 65 64 20 62 79 20 63 72 65 61 74  btained by creat
57e0: 69 6e 67 20 61 6e 64 20 65 6e 74 72 79 20 69 6e  ing and entry in
57f0: 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d   the file-system
5800: 0a 20 20 20 20 20 20 20 20 20 61 74 20 61 20 77  .         at a w
5810: 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c 6f 63 61 74 69  ell-known locati
5820: 6f 6e 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74  on relative to t
5830: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
5840: 20 28 61 20 22 64 6f 74 2d 66 69 6c 65 22 29 0a   (a "dot-file").
5850: 20 20 20 20 20 20 20 20 20 61 6e 64 20 72 65 6c           and rel
5860: 69 6e 71 75 69 73 68 65 64 20 62 79 20 64 65 6c  inquished by del
5870: 65 74 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66  eting the same f
5880: 69 6c 65 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 4e  ile...    <li> N
5890: 6f 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  o locking style.
58a0: 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20   If none of the 
58b0: 61 62 6f 76 65 20 63 61 6e 20 62 65 20 73 75 70  above can be sup
58c0: 70 6f 72 74 65 64 2c 20 74 68 69 73 20 0a 20 20  ported, this .  
58d0: 20 20 20 20 20 20 20 6c 6f 63 6b 69 6e 67 20 73         locking s
58e0: 74 79 6c 65 20 69 73 20 75 73 65 64 2e 20 4e 6f  tyle is used. No
58f0: 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e   database lockin
5900: 67 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 75  g mechanism is u
5910: 73 65 64 2e 20 57 68 65 6e 0a 20 20 20 20 20 20  sed. When.      
5920: 20 20 20 74 68 69 73 20 73 79 73 74 65 6d 20 69     this system i
5930: 73 20 75 73 65 64 20 69 74 20 69 73 20 6e 6f 74  s used it is not
5940: 20 73 61 66 65 20 66 6f 72 20 61 20 73 69 6e 67   safe for a sing
5950: 6c 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 62  le database to b
5960: 65 0a 20 20 20 20 20 20 20 20 20 61 63 63 65 73  e.         acces
5970: 73 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20  sed by multiple 
5980: 63 6c 69 65 6e 74 73 2e 0a 20 20 3c 2f 75 6c 3e  clients..  </ul>
5990: 0a 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79  ..  Additionally
59a0: 2c 20 66 69 76 65 20 65 78 74 72 61 20 5b 56 46  , five extra [VF
59b0: 53 5d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  S] implementatio
59c0: 6e 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 20  ns are provided 
59d0: 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 0a 20  as well as the. 
59e0: 20 64 65 66 61 75 6c 74 2e 20 42 79 20 73 70 65   default. By spe
59f0: 63 69 66 79 69 6e 67 20 6f 6e 65 20 6f 66 20 74  cifying one of t
5a00: 68 65 20 65 78 74 72 61 20 56 46 53 20 69 6d 70  he extra VFS imp
5a10: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 0a 20 20  lementations .  
5a20: 77 68 65 6e 20 63 61 6c 6c 69 6e 67 20 5b 73 71  when calling [sq
5a30: 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d  lite3_open_v2()]
5a40: 2c 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  , an application
5a50: 20 6d 61 79 20 62 79 70 61 73 73 20 74 68 65 20   may bypass the 
5a60: 66 69 6c 65 2d 73 79 73 74 65 6d 0a 20 20 64 65  file-system.  de
5a70: 74 65 63 74 69 6f 6e 20 6c 6f 67 69 63 20 61 6e  tection logic an
5a80: 64 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 6c  d explicitly sel
5a90: 65 63 74 20 6f 6e 65 20 6f 66 20 74 68 65 20 61  ect one of the a
5aa0: 62 6f 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79  bove locking sty
5ab0: 6c 65 73 2e 20 54 68 65 0a 20 20 66 69 76 65 20  les. The.  five 
5ac0: 65 78 74 72 61 20 5b 56 46 53 5d 20 69 6d 70 6c  extra [VFS] impl
5ad0: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20  ementations are 
5ae0: 63 61 6c 6c 65 64 20 22 75 6e 69 78 2d 70 6f 73  called "unix-pos
5af0: 69 78 22 2c 20 22 75 6e 69 78 2d 61 66 70 22 2c  ix", "unix-afp",
5b00: 0a 20 20 22 75 6e 69 78 2d 66 6c 6f 63 6b 22 2c  .  "unix-flock",
5b10: 20 22 75 6e 69 78 2d 64 6f 74 66 69 6c 65 22 20   "unix-dotfile" 
5b20: 61 6e 64 20 22 75 6e 69 78 2d 6e 6f 6e 65 22 2e  and "unix-none".
5b30: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
5b40: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
5b50: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
5b60: 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ENT} {.  This op
5b70: 74 69 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20  tion adds extra 
5b80: 6c 6f 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20  logic to SQLite 
5b90: 74 68 61 74 20 61 6c 6c 6f 77 73 20 69 74 20 74  that allows it t
5ba0: 6f 20 72 65 6c 65 61 73 65 20 75 6e 75 73 65 64  o release unused
5bb0: 0a 20 20 6d 65 6d 6f 72 79 20 75 70 6f 6e 20 72  .  memory upon r
5bc0: 65 71 75 65 73 74 2e 20 20 54 68 69 73 20 6f 70  equest.  This op
5bd0: 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 6e 61  tion must be ena
5be0: 62 6c 65 64 20 69 6e 20 6f 72 64 65 72 20 66 6f  bled in order fo
5bf0: 72 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33  r the.  [sqlite3
5c00: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28  _release_memory(
5c10: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20  )] interface to 
5c20: 77 6f 72 6b 2e 20 20 49 66 20 74 68 69 73 20 63  work.  If this c
5c30: 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70  ompile-time.  op
5c40: 74 69 6f 6e 20 69 73 20 6e 6f 74 20 75 73 65 64  tion is not used
5c50: 2c 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72  , the [sqlite3_r
5c60: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d  elease_memory()]
5c70: 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 61 20   interface is a 
5c80: 0a 20 20 6e 6f 2d 6f 70 2e 0a 7d 0a 0a 43 4f 4d  .  no-op..}..COM
5c90: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
5ca0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59  ITE_ENABLE_MEMSY
5cb0: 53 33 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  S3} {.  This opt
5cc0: 69 6f 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f 64  ion includes cod
5cd0: 65 20 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74  e in SQLite that
5ce0: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 61   implements an a
5cf0: 6c 74 65 72 6e 61 74 69 76 65 0a 20 20 6d 65 6d  lternative.  mem
5d00: 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20 20  ory allocator.  
5d10: 54 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76 65  This alternative
5d20: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
5d30: 72 20 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67 65  r is only engage
5d40: 64 0a 20 20 77 68 65 6e 20 74 68 65 20 5b 53 51  d.  when the [SQ
5d50: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50  LITE_CONFIG_HEAP
5d60: 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71 6c  ] option to [sql
5d70: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69  ite3_config()] i
5d80: 73 20 75 73 65 64 20 74 6f 0a 20 20 73 75 70 70  s used to.  supp
5d90: 6c 79 20 61 20 6c 61 72 67 65 20 63 68 75 6e 6b  ly a large chunk
5da0: 20 6f 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20   of memory from 
5db0: 77 68 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72 79  which all memory
5dc0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65   allocations are
5dd0: 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65 20  .  taken..  The 
5de0: 4d 45 4d 53 59 53 33 20 6d 65 6d 6f 72 79 20 61  MEMSYS3 memory a
5df0: 6c 6c 6f 63 61 74 6f 72 20 75 73 65 73 20 61 20  llocator uses a 
5e00: 68 79 62 72 69 64 20 61 6c 6c 6f 63 61 74 69 6f  hybrid allocatio
5e10: 6e 20 61 6c 67 6f 72 69 74 68 6d 20 0a 20 20 70  n algorithm .  p
5e20: 61 74 74 65 72 6e 65 64 20 61 66 74 65 72 20 64  atterned after d
5e30: 6c 6d 61 6c 6c 6f 63 28 29 2e 20 20 20 4f 6e 6c  lmalloc().   Onl
5e40: 79 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f  y one of SQLITE_
5e50: 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 20 61  ENABLE_MEMSYS3 a
5e60: 6e 64 20 0a 20 20 53 51 4c 49 54 45 5f 45 4e 41  nd .  SQLITE_ENA
5e70: 42 4c 45 5f 4d 45 4d 53 59 53 35 20 6d 61 79 20  BLE_MEMSYS5 may 
5e80: 62 65 20 65 6e 61 62 6c 65 64 20 61 74 20 6f 6e  be enabled at on
5e90: 63 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ce..}..COMPILE_O
5ea0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
5eb0: 41 42 4c 45 5f 4d 45 4d 53 59 53 35 7d 20 7b 0a  ABLE_MEMSYS5} {.
5ec0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e    This option in
5ed0: 63 6c 75 64 65 73 20 63 6f 64 65 20 69 6e 20 53  cludes code in S
5ee0: 51 4c 69 74 65 20 74 68 61 74 20 69 6d 70 6c 65  QLite that imple
5ef0: 6d 65 6e 74 73 20 61 6e 20 61 6c 74 65 72 6e 61  ments an alterna
5f00: 74 69 76 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c  tive.  memory al
5f10: 6c 6f 63 61 74 6f 72 2e 20 20 54 68 69 73 20 61  locator.  This a
5f20: 6c 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72  lternative memor
5f30: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f  y allocator is o
5f40: 6e 6c 79 20 65 6e 67 61 67 65 64 0a 20 20 77 68  nly engaged.  wh
5f50: 65 6e 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43  en the [SQLITE_C
5f60: 4f 4e 46 49 47 5f 48 45 41 50 5d 20 6f 70 74 69  ONFIG_HEAP] opti
5f70: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
5f80: 6f 6e 66 69 67 28 29 5d 20 69 73 20 75 73 65 64  onfig()] is used
5f90: 20 74 6f 0a 20 20 73 75 70 70 6c 79 20 61 20 6c   to.  supply a l
5fa0: 61 72 67 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65  arge chunk of me
5fb0: 6d 6f 72 79 20 66 72 6f 6d 20 77 68 69 63 68 20  mory from which 
5fc0: 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  all memory alloc
5fd0: 61 74 69 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b  ations are.  tak
5fe0: 65 6e 2e 0a 20 20 54 68 65 20 4d 45 4d 53 59 53  en..  The MEMSYS
5ff0: 35 20 6d 6f 64 75 6c 65 20 72 6f 75 6e 64 73 20  5 module rounds 
6000: 61 6c 6c 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20  all allocations 
6010: 75 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 70  up to the next p
6020: 6f 77 65 72 0a 20 20 6f 66 20 74 77 6f 20 61 6e  ower.  of two an
6030: 64 20 75 73 65 73 20 61 20 66 69 72 73 74 2d 66  d uses a first-f
6040: 69 74 2c 20 62 75 64 64 79 2d 61 6c 6c 6f 63 61  it, buddy-alloca
6050: 74 6f 72 20 61 6c 67 6f 72 69 74 68 6d 0a 20 20  tor algorithm.  
6060: 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 73 74  that provides st
6070: 72 6f 6e 67 20 67 75 61 72 61 6e 74 65 65 73 20  rong guarantees 
6080: 61 67 61 69 6e 73 74 20 66 72 61 67 6d 65 6e 74  against fragment
6090: 61 74 69 6f 6e 20 61 6e 64 20 62 72 65 61 6b 64  ation and breakd
60a0: 6f 77 6e 0a 20 20 73 75 62 6a 65 63 74 20 74 6f  own.  subject to
60b0: 20 63 65 72 74 61 69 6e 20 6f 70 65 72 61 74 69   certain operati
60c0: 6e 67 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a  ng constraints..
60d0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
60e0: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
60f0: 5f 52 54 52 45 45 7d 20 7b 0a 20 20 54 68 69 73  _RTREE} {.  This
6100: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53   option causes S
6110: 51 4c 69 74 65 20 74 6f 20 69 6e 63 6c 75 64 65  QLite to include
6120: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65   support for the
6130: 0a 20 20 5b 72 74 72 65 65 20 7c 20 52 2a 54 72  .  [rtree | R*Tr
6140: 65 65 20 69 6e 64 65 78 20 65 78 74 65 6e 73 69  ee index extensi
6150: 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  on]..}..COMPILE_
6160: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 52  OPTION {SQLITE_R
6170: 54 52 45 45 5f 49 4e 54 5f 4f 4e 4c 59 7d 20 7b  TREE_INT_ONLY} {
6180: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
6190: 6e 20 69 73 20 75 73 65 64 20 74 6f 67 65 74 68  n is used togeth
61a0: 65 72 20 77 69 74 68 20 5b 53 51 4c 49 54 45 5f  er with [SQLITE_
61b0: 45 4e 41 42 4c 45 5f 52 54 52 45 45 5d 20 74 68  ENABLE_RTREE] th
61c0: 65 6e 20 74 68 65 0a 20 20 5b 72 74 72 65 65 20  en the.  [rtree 
61d0: 7c 20 52 2a 54 72 65 65 20 65 78 74 65 6e 73 69  | R*Tree extensi
61e0: 6f 6e 5d 20 77 69 6c 6c 20 6f 6e 6c 79 20 73 74  on] will only st
61f0: 6f 72 65 20 33 32 2d 62 69 74 20 73 69 67 6e 65  ore 32-bit signe
6200: 64 20 69 6e 74 65 67 65 72 0a 20 20 63 6f 6f 72  d integer.  coor
6210: 64 69 6e 61 74 65 73 20 61 6e 64 20 61 6c 6c 20  dinates and all 
6220: 69 6e 74 65 72 6e 61 6c 20 63 6f 6d 70 75 74 61  internal computa
6230: 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 64 6f  tions will be do
6240: 6e 65 20 75 73 69 6e 67 20 69 6e 74 65 67 65 72  ne using integer
6250: 73 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 66  s.  instead of f
6260: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75  loating point nu
6270: 6d 62 65 72 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  mbers..}..COMPIL
6280: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
6290: 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 7d 20  _ENABLE_SQLLOG} 
62a0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
62b0: 65 6e 61 62 6c 65 73 20 65 78 74 72 61 20 63 6f  enables extra co
62c0: 64 65 20 28 65 73 70 65 63 69 61 6c 6c 79 20 74  de (especially t
62d0: 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  he [SQLITE_CONFI
62e0: 47 5f 53 51 4c 4c 4f 47 5d 0a 20 20 6f 70 74 69  G_SQLLOG].  opti
62f0: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
6300: 6f 6e 66 69 67 28 29 5d 29 20 74 68 61 74 20 63  onfig()]) that c
6310: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72  an be used to cr
6320: 65 61 74 65 20 6c 6f 67 73 20 6f 66 20 61 6c 6c  eate logs of all
6330: 0a 20 20 53 51 4c 69 74 65 20 70 72 6f 63 65 73  .  SQLite proces
6340: 73 69 6e 67 20 70 65 72 66 6f 72 6d 65 64 20 62  sing performed b
6350: 79 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  y an application
6360: 2e 20 20 54 68 65 73 65 20 6c 6f 67 73 20 63 61  .  These logs ca
6370: 6e 20 62 65 20 75 73 65 66 75 6c 0a 20 20 69 6e  n be useful.  in
6380: 20 64 6f 69 6e 67 20 6f 66 66 2d 6c 69 6e 65 20   doing off-line 
6390: 61 6e 61 6c 79 73 69 73 20 6f 66 20 74 68 65 20  analysis of the 
63a0: 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 61  behavior of an a
63b0: 70 70 6c 69 63 61 74 69 6f 6e 2c 20 61 6e 64 20  pplication, and 
63c0: 65 73 70 65 63 69 61 6c 6c 79 0a 20 20 66 6f 72  especially.  for
63d0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e 61   performance ana
63e0: 6c 79 73 69 73 2e 20 20 49 6e 20 6f 72 64 65 72  lysis.  In order
63f0: 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f   for the SQLITE_
6400: 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70  ENABLE_SQLLOG op
6410: 74 69 6f 6e 20 74 6f 20 0a 20 20 62 65 20 75 73  tion to .  be us
6420: 65 66 75 6c 2c 20 73 6f 6d 65 20 65 78 74 72 61  eful, some extra
6430: 20 63 6f 64 65 20 69 73 20 72 65 71 75 69 72 65   code is require
6440: 64 2e 20 20 54 68 65 20 0a 20 20 3c 61 20 68 72  d.  The .  <a hr
6450: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73  ef="http://www.s
6460: 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 64 6f  qlite.org/src/do
6470: 63 2f 74 72 75 6e 6b 2f 73 72 63 2f 74 65 73 74  c/trunk/src/test
6480: 5f 73 71 6c 6c 6f 67 2e 63 22 3e 22 74 65 73 74  _sqllog.c">"test
6490: 5f 73 71 6c 6c 6f 67 2e 63 22 3c 2f 61 3e 0a 20  _sqllog.c"</a>. 
64a0: 20 73 6f 75 72 63 65 20 63 6f 64 65 0a 20 20 66   source code.  f
64b0: 69 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 69 74  ile in the SQLit
64c0: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73  e source tree is
64d0: 20 61 20 77 6f 72 6b 69 6e 67 20 65 78 61 6d 70   a working examp
64e0: 6c 65 20 6f 66 20 74 68 65 20 72 65 71 75 69 72  le of the requir
64f0: 65 64 20 65 78 74 72 61 0a 20 20 63 6f 64 65 2e  ed extra.  code.
6500: 20 20 4f 6e 20 75 6e 69 78 20 61 6e 64 20 77 69    On unix and wi
6510: 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 2c 20 61  ndows systems, a
6520: 20 64 65 76 65 6c 6f 70 65 72 20 63 61 6e 20 61   developer can a
6530: 70 70 65 6e 64 20 74 68 65 20 74 65 78 74 20 6f  ppend the text o
6540: 66 20 74 68 65 0a 20 20 22 74 65 73 74 5f 73 71  f the.  "test_sq
6550: 6c 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65 20 63  llog.c" source c
6560: 6f 64 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20  ode file to the 
6570: 65 6e 64 20 6f 66 20 61 6e 20 22 73 71 6c 69 74  end of an "sqlit
6580: 65 33 2e 63 22 20 61 6d 61 6c 67 61 6d 61 74 69  e3.c" amalgamati
6590: 6f 6e 2c 0a 20 20 72 65 63 6f 6d 70 69 6c 65 20  on,.  recompile 
65a0: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
65b0: 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51 4c 49  using the -DSQLI
65c0: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47  TE_ENABLE_SQLLOG
65d0: 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 0a 20   option, then . 
65e0: 20 63 6f 6e 74 72 6f 6c 20 6c 6f 67 67 69 6e 67   control logging
65f0: 20 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65   using environme
6600: 6e 74 20 76 61 72 69 61 62 6c 65 73 2e 20 20 53  nt variables.  S
6610: 65 65 20 74 68 65 20 68 65 61 64 65 72 20 63 6f  ee the header co
6620: 6d 6d 65 6e 74 20 6f 6e 20 0a 20 20 74 68 65 20  mment on .  the 
6630: 22 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63 22 20  "test_sqllog.c" 
6640: 73 6f 75 72 63 65 20 66 69 6c 65 20 66 6f 72 20  source file for 
6650: 61 64 64 69 74 69 6f 6e 61 6c 20 64 65 74 61 69  additional detai
6660: 6c 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  l.  .}..COMPILE_
6670: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
6680: 4e 41 42 4c 45 5f 53 54 41 54 32 7d 20 7b 0a 20  NABLE_STAT2} {. 
6690: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 75 73 65   This option use
66a0: 64 20 74 6f 20 63 61 75 73 65 20 74 68 65 20 5b  d to cause the [
66b0: 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64  ANALYZE] command
66c0: 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20 69 6e   to collect.  in
66d0: 64 65 78 20 68 69 73 74 6f 67 72 61 6d 20 64 61  dex histogram da
66e0: 74 61 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c  ta in the <b>sql
66f0: 69 74 65 5f 73 74 61 74 32 3c 2f 62 3e 20 74 61  ite_stat2</b> ta
6700: 62 6c 65 2e 20 20 42 75 74 20 74 68 61 74 0a 20  ble.  But that. 
6710: 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 77   functionality w
6720: 61 73 20 73 75 70 65 72 63 65 64 65 64 20 62 79  as superceded by
6730: 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   [SQLITE_ENABLE_
6740: 53 54 41 54 33 5d 20 61 73 20 6f 66 0a 20 20 53  STAT3] as of.  S
6750: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e  QLite version 3.
6760: 37 2e 39 2e 20 20 54 68 65 20 53 51 4c 49 54 45  7.9.  The SQLITE
6770: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 32 20 63 6f  _ENABLE_STAT2 co
6780: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
6790: 6e 0a 20 20 69 73 20 6e 6f 77 20 61 20 6e 6f 2d  n.  is now a no-
67a0: 6f 70 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  op..}..COMPILE_O
67b0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
67c0: 41 42 4c 45 5f 53 54 41 54 33 7d 20 7b 0a 20 20  ABLE_STAT3} {.  
67d0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73  This option adds
67e0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69   additional logi
67f0: 63 20 74 6f 20 74 68 65 20 5b 41 4e 41 4c 59 5a  c to the [ANALYZ
6800: 45 5d 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74  E] command and t
6810: 6f 0a 20 20 74 68 65 20 5b 71 75 65 72 79 20 70  o.  the [query p
6820: 6c 61 6e 6e 65 72 5d 20 74 68 61 74 20 63 61 6e  lanner] that can
6830: 20 68 65 6c 70 20 53 51 4c 69 74 65 20 74 6f 20   help SQLite to 
6840: 63 68 6f 73 65 20 61 20 62 65 74 74 65 72 20 71  chose a better q
6850: 75 65 72 79 20 70 6c 61 6e 0a 20 20 75 6e 64 65  uery plan.  unde
6860: 72 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74  r certain situat
6870: 69 6f 6e 73 2e 20 20 54 68 65 20 5b 41 4e 41 4c  ions.  The [ANAL
6880: 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  YZE] command is 
6890: 65 6e 68 61 6e 63 65 64 20 74 6f 20 63 6f 6c 6c  enhanced to coll
68a0: 65 63 74 0a 20 20 68 69 73 74 6f 67 72 61 6d 20  ect.  histogram 
68b0: 64 61 74 61 20 66 72 6f 6d 20 65 61 63 68 20 69  data from each i
68c0: 6e 64 65 78 20 61 6e 64 20 73 74 6f 72 65 20 74  ndex and store t
68d0: 68 61 74 20 64 61 74 61 0a 20 20 69 6e 20 74 68  hat data.  in th
68e0: 65 20 3c 62 3e 73 71 6c 69 74 65 5f 73 74 61 74  e <b>sqlite_stat
68f0: 33 3c 2f 62 3e 20 74 61 62 6c 65 2e 20 20 54 68  3</b> table.  Th
6900: 65 20 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20  e query planner 
6910: 77 69 6c 6c 20 74 68 65 6e 20 75 73 65 20 74 68  will then use th
6920: 65 0a 20 20 68 69 73 74 6f 67 72 61 6d 20 64 61  e.  histogram da
6930: 74 61 20 74 6f 20 68 65 6c 70 20 69 74 20 6d 61  ta to help it ma
6940: 6b 65 20 62 65 74 74 65 72 20 69 6e 64 65 78 20  ke better index 
6950: 63 68 6f 69 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50  choices..}..COMP
6960: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
6970: 54 45 5f 45 4e 41 42 4c 45 5f 54 52 45 45 5f 45  TE_ENABLE_TREE_E
6980: 58 50 4c 41 49 4e 7d 20 7b 0a 20 20 54 68 69 73  XPLAIN} {.  This
6990: 20 6f 70 74 69 6f 6e 20 61 64 64 73 20 73 75 70   option adds sup
69a0: 70 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 53 51  port for the [SQ
69b0: 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 45 58  LITE_TESTCTRL_EX
69c0: 50 4c 41 49 4e 5f 53 54 4d 54 5d 20 74 65 73 74  PLAIN_STMT] test
69d0: 2d 63 6f 6e 74 72 6f 6c 0a 20 20 69 6e 20 74 68  -control.  in th
69e0: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 2e 20 20  e SQLite core.  
69f0: 57 68 65 6e 20 74 68 65 20 5b 63 6f 6d 6d 61 6e  When the [comman
6a00: 64 2d 6c 69 6e 65 20 73 68 65 6c 6c 5d 20 69 73  d-line shell] is
6a10: 20 61 6c 73 6f 20 63 6f 6d 70 69 6c 65 64 20 77   also compiled w
6a20: 69 74 68 0a 20 20 74 68 69 73 20 6f 70 74 69 6f  ith.  this optio
6a30: 6e 2c 20 74 68 65 20 22 2e 65 78 70 6c 61 69 6e  n, the ".explain
6a40: 22 20 64 6f 74 2d 63 6f 6d 6d 61 6e 64 20 65 6e  " dot-command en
6a50: 61 62 6c 65 73 20 61 20 6d 6f 64 65 20 74 68 61  ables a mode tha
6a60: 74 20 75 73 65 73 20 74 68 65 0a 20 20 5b 53 51  t uses the.  [SQ
6a70: 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 45 58  LITE_TESTCTRL_EX
6a80: 50 4c 41 49 4e 5f 53 54 4d 54 5d 20 69 6e 74 65  PLAIN_STMT] inte
6a90: 72 66 61 63 65 20 74 6f 20 64 69 73 70 6c 61 79  rface to display
6aa0: 20 61 6e 20 41 53 43 49 49 2d 61 72 74 20 64 69   an ASCII-art di
6ab0: 61 67 72 61 6d 0a 20 20 6f 66 20 74 68 65 20 70  agram.  of the p
6ac0: 61 72 73 65 20 74 72 65 65 20 66 6f 72 20 65 61  arse tree for ea
6ad0: 63 68 20 53 51 4c 20 71 75 65 72 79 20 73 74 61  ch SQL query sta
6ae0: 74 65 6d 65 6e 74 20 74 68 61 74 20 69 73 20 72  tement that is r
6af0: 75 6e 20 69 6e 20 74 68 65 20 73 68 65 6c 6c 2e  un in the shell.
6b00: 0a 20 20 54 68 69 73 20 6d 65 63 68 61 6e 69 73  .  This mechanis
6b10: 6d 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20  m is useful for 
6b20: 64 65 62 75 67 67 69 6e 67 20 74 68 65 20 53 51  debugging the SQ
6b30: 4c 69 74 65 20 70 61 72 73 65 72 20 61 6e 64 20  Lite parser and 
6b40: 63 6f 64 65 0a 20 20 67 65 6e 65 72 61 74 6f 72  code.  generator
6b50: 2e 20 20 54 68 69 73 20 77 68 6f 6c 65 20 6d 65  .  This whole me
6b60: 63 68 61 6e 69 73 6d 20 69 73 20 68 69 67 68 6c  chanism is highl
6b70: 79 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 61  y experimental a
6b80: 6e 64 20 63 6f 75 6c 64 20 63 68 61 6e 67 65 0a  nd could change.
6b90: 20 20 64 72 61 73 74 69 63 61 6c 6c 79 20 6f 72    drastically or
6ba0: 20 62 65 20 65 6c 69 6d 69 6e 61 74 65 64 20 69   be eliminated i
6bb0: 6e 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65  n future release
6bc0: 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a  s of SQLite..}..
6bd0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
6be0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 50  SQLITE_ENABLE_UP
6bf0: 44 41 54 45 5f 44 45 4c 45 54 45 5f 4c 49 4d 49  DATE_DELETE_LIMI
6c00: 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  T} {.  This opti
6c10: 6f 6e 20 65 6e 61 62 6c 65 73 20 61 6e 20 6f 70  on enables an op
6c20: 74 69 6f 6e 61 6c 20 4f 52 44 45 52 20 42 59 20  tional ORDER BY 
6c30: 61 6e 64 20 4c 49 4d 49 54 20 63 6c 61 75 73 65  and LIMIT clause
6c40: 20 6f 6e 20 0a 20 20 5b 55 50 44 41 54 45 5d 20   on .  [UPDATE] 
6c50: 61 6e 64 20 5b 44 45 4c 45 54 45 5d 20 73 74 61  and [DELETE] sta
6c60: 74 65 6d 65 6e 74 73 2e 0a 0a 20 20 3c 70 3e 49  tements...  <p>I
6c70: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  f this option is
6c80: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 69   defined, then i
6c90: 74 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 20 0a  t must also be .
6ca0: 20 20 64 65 66 69 6e 65 64 20 77 68 65 6e 20 75    defined when u
6cb0: 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f 6e 27  sing the 'lemon'
6cc0: 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72 61 74   tool to generat
6cd0: 65 20 61 20 70 61 72 73 65 2e 63 0a 20 20 66 69  e a parse.c.  fi
6ce0: 6c 65 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74  le. Because of t
6cf0: 68 69 73 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e  his, this option
6d00: 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75 73 65   may only be use
6d10: 64 20 77 68 65 6e 20 74 68 65 20 6c 69 62 72 61  d when the libra
6d20: 72 79 20 69 73 20 62 75 69 6c 74 0a 20 20 66 72  ry is built.  fr
6d30: 6f 6d 20 73 6f 75 72 63 65 2c 20 6e 6f 74 20 66  om source, not f
6d40: 72 6f 6d 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d  rom the [amalgam
6d50: 61 74 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d 20 74  ation] or from t
6d60: 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66  he collection of
6d70: 0a 20 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20  .  pre-packaged 
6d80: 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64 65 64  C files provided
6d90: 20 66 6f 72 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69   for non-Unix li
6da0: 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f 6e 20  ke platforms on 
6db0: 74 68 65 20 77 65 62 73 69 74 65 2e 0a 20 20 3c  the website..  <
6dc0: 2f 70 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  /p>.}..COMPILE_O
6dd0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
6de0: 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49  ABLE_UNLOCK_NOTI
6df0: 46 59 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  FY} {.  This opt
6e00: 69 6f 6e 20 65 6e 61 62 6c 65 73 20 74 68 65 20  ion enables the 
6e10: 5b 73 71 6c 69 74 65 33 5f 75 6e 6c 6f 63 6b 5f  [sqlite3_unlock_
6e20: 6e 6f 74 69 66 79 28 29 5d 20 69 6e 74 65 72 66  notify()] interf
6e30: 61 63 65 20 61 6e 64 0a 20 20 69 74 73 20 61 73  ace and.  its as
6e40: 73 6f 63 69 61 74 65 64 20 66 75 6e 63 74 69 6f  sociated functio
6e50: 6e 61 6c 69 74 79 2e 20 20 53 65 65 20 74 68 65  nality.  See the
6e60: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74   documentation t
6e70: 69 74 6c 65 64 0a 20 20 5b 55 73 69 6e 67 20 74  itled.  [Using t
6e80: 68 65 20 53 51 4c 69 74 65 20 55 6e 6c 6f 63 6b  he SQLite Unlock
6e90: 20 4e 6f 74 69 66 69 63 61 74 69 6f 6e 20 46 65   Notification Fe
6ea0: 61 74 75 72 65 5d 20 66 6f 72 20 61 64 64 69 74  ature] for addit
6eb0: 69 6f 6e 61 6c 0a 20 20 69 6e 66 6f 72 6d 61 74  ional.  informat
6ec0: 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ion..}..COMPILE_
6ed0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 53  OPTION {SQLITE_S
6ee0: 4f 55 4e 44 45 58 7d 20 7b 0a 20 20 54 68 69 73  OUNDEX} {.  This
6ef0: 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20   option enables 
6f00: 74 68 65 20 5b 73 6f 75 6e 64 65 78 28 29 20 53  the [soundex() S
6f10: 51 4c 20 66 75 6e 63 74 69 6f 6e 5d 2e 0a 7d 0a  QL function]..}.
6f20: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6f30: 7b 59 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b  {YYTRACKMAXSTACK
6f40: 44 45 50 54 48 7d 20 7b 0a 20 20 54 68 69 73 20  DEPTH} {.  This 
6f50: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68  option causes th
6f60: 65 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72  e LALR(1) parser
6f70: 20 73 74 61 63 6b 20 64 65 70 74 68 20 74 6f 20   stack depth to 
6f80: 62 65 20 74 72 61 63 6b 65 64 0a 20 20 61 6e 64  be tracked.  and
6f90: 20 72 65 70 6f 72 74 65 64 20 75 73 69 6e 67 20   reported using 
6fa0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 61  the [sqlite3_sta
6fb0: 74 75 73 5d 28 5b 53 51 4c 49 54 45 5f 53 54 41  tus]([SQLITE_STA
6fc0: 54 55 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b  TUS_PARSER_STACK
6fd0: 5d 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65 72 66 61  ],...).  interfa
6fe0: 63 65 2e 20 20 53 51 4c 69 74 65 27 73 20 4c 41  ce.  SQLite's LA
6ff0: 4c 52 28 31 29 20 70 61 72 73 65 72 20 68 61 73  LR(1) parser has
7000: 20 61 20 66 69 78 65 64 20 73 74 61 63 6b 20 64   a fixed stack d
7010: 65 70 74 68 0a 20 20 28 64 65 74 65 72 6d 69 6e  epth.  (determin
7020: 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69  ed at compile-ti
7030: 6d 65 20 75 73 69 6e 67 20 74 68 65 20 5b 59 59  me using the [YY
7040: 53 54 41 43 4b 44 45 50 54 48 5d 20 6f 70 74 69  STACKDEPTH] opti
7050: 6f 6e 73 29 2e 0a 20 20 54 68 69 73 20 6f 70 74  ons)..  This opt
7060: 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20  ion can be used 
7070: 74 6f 20 68 65 6c 70 20 64 65 74 65 72 6d 69 6e  to help determin
7080: 65 20 69 66 20 61 6e 20 61 70 70 6c 69 63 61 74  e if an applicat
7090: 69 6f 6e 20 69 73 0a 20 20 67 65 74 74 69 6e 67  ion is.  getting
70a0: 20 63 6c 6f 73 65 20 74 6f 20 65 78 63 65 65 64   close to exceed
70b0: 69 6e 67 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  ing the maximum 
70c0: 4c 41 4c 52 28 31 29 20 73 74 61 63 6b 20 64 65  LALR(1) stack de
70d0: 70 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c  pth..}.</tcl>..<
70e0: 61 20 6e 61 6d 65 3d 22 64 69 73 61 62 6c 65 66  a name="disablef
70f0: 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68  eatures"></a>.<h
7100: 32 3e 31 2e 35 20 4f 70 74 69 6f 6e 73 20 54 6f  2>1.5 Options To
7110: 20 44 69 73 61 62 6c 65 20 46 65 61 74 75 72 65   Disable Feature
7120: 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65  s Normally Turne
7130: 64 20 4f 6e 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e  d On</h2>..<tcl>
7140: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
7150: 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f  {SQLITE_DISABLE_
7160: 4c 46 53 7d 20 7b 0a 20 20 49 66 20 74 68 69 73  LFS} {.  If this
7170: 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20   C-preprocessor 
7180: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
7190: 2c 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70  , large file sup
71a0: 70 6f 72 74 0a 20 20 69 73 20 64 69 73 61 62 6c  port.  is disabl
71b0: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
71c0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49  PTION {SQLITE_DI
71d0: 53 41 42 4c 45 5f 44 49 52 53 59 4e 43 7d 20 7b  SABLE_DIRSYNC} {
71e0: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
71f0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
7200: 69 73 20 64 65 66 69 6e 65 64 2c 20 64 69 72 65  is defined, dire
7210: 63 74 6f 72 79 20 73 79 6e 63 73 0a 20 20 61 72  ctory syncs.  ar
7220: 65 20 64 69 73 61 62 6c 65 64 2e 20 20 53 51 4c  e disabled.  SQL
7230: 69 74 65 20 74 79 70 69 63 61 6c 6c 79 20 61 74  ite typically at
7240: 74 65 6d 70 74 73 20 74 6f 20 73 79 6e 63 20 74  tempts to sync t
7250: 68 65 20 70 61 72 65 6e 74 0a 20 20 64 69 72 65  he parent.  dire
7260: 63 74 6f 72 79 20 77 68 65 6e 20 61 20 66 69 6c  ctory when a fil
7270: 65 20 69 73 20 64 65 6c 65 74 65 64 20 74 6f 20  e is deleted to 
7280: 65 6e 73 75 72 65 20 74 68 65 20 64 69 72 65 63  ensure the direc
7290: 74 6f 72 79 0a 20 20 65 6e 74 72 69 65 73 20 61  tory.  entries a
72a0: 72 65 20 75 70 64 61 74 65 64 20 69 6d 6d 65 64  re updated immed
72b0: 69 61 74 65 6c 79 20 6f 6e 20 64 69 73 6b 2e 0a  iately on disk..
72c0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
72d0: 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c  N {SQLITE_DISABL
72e0: 45 5f 46 54 53 33 5f 55 4e 49 43 4f 44 45 7d 20  E_FTS3_UNICODE} 
72f0: 7b 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72  {.  If this C-pr
7300: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f  eprocessor macro
7310: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
7320: 20 5b 75 6e 69 63 6f 64 65 36 31 5d 20 74 6f 6b   [unicode61] tok
7330: 65 6e 69 7a 65 72 0a 20 20 69 6e 20 5b 46 54 53  enizer.  in [FTS
7340: 33 5d 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72  3] is omitted fr
7350: 6f 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64  om the build and
7360: 20 69 73 20 75 6e 61 76 61 69 6c 61 62 6c 65 20   is unavailable 
7370: 74 6f 20 0a 20 20 61 70 70 6c 69 63 61 74 69 6f  to .  applicatio
7380: 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ns..}..COMPILE_O
7390: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49  PTION {SQLITE_DI
73a0: 53 41 42 4c 45 5f 46 54 53 34 5f 44 45 46 45 52  SABLE_FTS4_DEFER
73b0: 52 45 44 7d 20 7b 0a 20 20 49 66 20 74 68 69 73  RED} {.  If this
73c0: 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20   C-preprocessor 
73d0: 6d 61 63 72 6f 20 64 69 73 61 62 6c 65 73 20 74  macro disables t
73e0: 68 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b  he "deferred tok
73f0: 65 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e  en" optimization
7400: 0a 20 20 69 6e 20 5b 46 54 53 34 5d 2e 20 20 54  .  in [FTS4].  T
7410: 68 65 20 22 64 65 66 65 72 72 65 64 20 74 6f 6b  he "deferred tok
7420: 65 6e 22 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e  en" optimization
7430: 20 61 76 6f 69 64 73 20 6c 6f 61 64 69 6e 67 20   avoids loading 
7440: 6d 61 73 73 69 76 65 0a 20 20 70 6f 73 74 69 6e  massive.  postin
7450: 67 20 6c 69 73 74 73 20 66 6f 72 20 74 65 72 6d  g lists for term
7460: 73 20 74 68 61 74 20 61 72 65 20 69 6e 20 6d 6f  s that are in mo
7470: 73 74 20 64 6f 63 75 6d 65 6e 74 73 20 6f 66 20  st documents of 
7480: 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 0a 20  the collection. 
7490: 20 61 6e 64 20 69 6e 73 74 65 61 64 20 73 69 6d   and instead sim
74a0: 70 6c 79 20 73 63 61 6e 73 20 66 6f 72 20 74 68  ply scans for th
74b0: 6f 73 65 20 74 6f 6b 65 6e 73 20 69 6e 20 74 68  ose tokens in th
74c0: 65 20 64 6f 63 75 6d 65 6e 74 20 73 6f 75 72 63  e document sourc
74d0: 65 2e 20 20 5b 46 54 53 34 5d 0a 20 20 73 68 6f  e.  [FTS4].  sho
74e0: 75 6c 64 20 67 65 74 20 65 78 61 63 74 6c 79 20  uld get exactly 
74f0: 74 68 65 20 73 61 6d 65 20 61 6e 73 77 65 72 20  the same answer 
7500: 62 6f 74 68 20 77 69 74 68 20 61 6e 64 20 77 69  both with and wi
7510: 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6d  thout this optim
7520: 69 7a 61 74 69 6f 6e 2e 0a 7d 0a 3c 2f 74 63 6c  ization..}.</tcl
7530: 3e 0a 0a 3c 74 63 6c 3e 0a 20 20 68 64 5f 66 72  >..<tcl>.  hd_fr
7540: 61 67 6d 65 6e 74 20 22 6f 6d 69 74 66 65 61 74  agment "omitfeat
7550: 75 72 65 73 22 0a 20 20 68 64 5f 6b 65 79 77 6f  ures".  hd_keywo
7560: 72 64 73 20 22 6f 6d 69 74 66 65 61 74 75 72 65  rds "omitfeature
7570: 73 22 0a 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 31 2e  s".</tcl>.<h2>1.
7580: 36 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d 69  6 Options To Omi
7590: 74 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e 0a  t Features</h2>.
75a0: 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .<p>The followin
75b0: 67 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 65  g options can be
75c0: 20 75 73 65 64 20 74 6f 20 0a 5b 72 65 6c 66 6f   used to .[relfo
75d0: 6f 74 70 72 69 6e 74 20 7c 20 72 65 64 75 63 65  otprint | reduce
75e0: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65   the size of the
75f0: 20 63 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72   compiled librar
7600: 79 5d 0a 62 79 20 6f 6d 69 74 74 69 6e 67 20 75  y].by omitting u
7610: 6e 75 73 65 64 20 66 65 61 74 75 72 65 73 2e 20  nused features. 
7620: 54 68 69 73 20 69 73 20 70 72 6f 62 61 62 6c 79  This is probably
7630: 20 6f 6e 6c 79 20 75 73 65 66 75 6c 0a 69 6e 20   only useful.in 
7640: 65 6d 62 65 64 64 65 64 20 73 79 73 74 65 6d 73  embedded systems
7650: 20 77 68 65 72 65 20 73 70 61 63 65 20 69 73 20   where space is 
7660: 65 73 70 65 63 69 61 6c 6c 79 20 74 69 67 68 74  especially tight
7670: 2c 20 61 73 20 65 76 65 6e 20 77 69 74 68 20 61  , as even with a
7680: 6c 6c 0a 66 65 61 74 75 72 65 73 20 69 6e 63 6c  ll.features incl
7690: 75 64 65 64 20 74 68 65 20 53 51 4c 69 74 65 20  uded the SQLite 
76a0: 6c 69 62 72 61 72 79 20 69 73 20 72 65 6c 61 74  library is relat
76b0: 69 76 65 6c 79 20 73 6d 61 6c 6c 2e 20 44 6f 6e  ively small. Don
76c0: 27 74 20 66 6f 72 67 65 74 0a 74 6f 20 74 65 6c  't forget.to tel
76d0: 6c 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20  l your compiler 
76e0: 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20  to optimize for 
76f0: 62 69 6e 61 72 79 20 73 69 7a 65 21 20 28 74 68  binary size! (th
7700: 65 20 2d 4f 73 20 6f 70 74 69 6f 6e 20 69 66 0a  e -Os option if.
7710: 75 73 69 6e 67 20 47 43 43 29 2e 20 20 54 65 6c  using GCC).  Tel
7720: 6c 69 6e 67 20 79 6f 75 72 20 63 6f 6d 70 69 6c  ling your compil
7730: 65 72 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66  er to optimize f
7740: 6f 72 20 73 69 7a 65 20 75 73 75 61 6c 6c 79 20  or size usually 
7750: 68 61 73 0a 61 20 6d 75 63 68 20 6c 61 72 67 65  has.a much large
7760: 72 20 69 6d 70 61 63 74 20 6f 6e 20 6c 69 62 72  r impact on libr
7770: 61 72 79 20 66 6f 6f 74 70 72 69 6e 74 20 74 68  ary footprint th
7780: 61 6e 20 65 6d 70 6c 6f 79 69 6e 67 20 61 6e 79  an employing any
7790: 20 6f 66 20 74 68 65 73 65 0a 63 6f 6d 70 69 6c   of these.compil
77a0: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 20  e-time options. 
77b0: 20 59 6f 75 20 73 68 6f 75 6c 64 20 61 6c 73 6f   You should also
77c0: 20 76 65 72 69 66 79 20 74 68 61 74 20 0a 3c 61   verify that .<a
77d0: 20 68 72 65 66 3d 22 23 64 65 62 75 67 6f 70 74   href="#debugopt
77e0: 69 6f 6e 73 22 3e 64 65 62 75 67 67 69 6e 67 20  ions">debugging 
77f0: 6f 70 74 69 6f 6e 73 3c 2f 61 3e 20 61 72 65 20  options</a> are 
7800: 64 69 73 61 62 6c 65 64 2e 3c 2f 70 3e 0a 0a 3c  disabled.</p>..<
7810: 70 3e 54 68 65 20 6d 61 63 72 6f 73 20 69 6e 20  p>The macros in 
7820: 74 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 20  this section do 
7830: 6e 6f 74 20 72 65 71 75 69 72 65 20 76 61 6c 75  not require valu
7840: 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  es. The followin
7850: 67 20 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 73  g .compilation s
7860: 77 69 74 63 68 65 73 20 61 6c 6c 20 68 61 76 65  witches all have
7870: 20 74 68 65 20 73 61 6d 65 20 65 66 66 65 63 74   the same effect
7880: 3a 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f  :<br>.-DSQLITE_O
7890: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3c 62  MIT_ALTERTABLE<b
78a0: 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54  r>.-DSQLITE_OMIT
78b0: 5f 41 4c 54 45 52 54 41 42 4c 45 3d 31 3c 62 72  _ALTERTABLE=1<br
78c0: 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  >.-DSQLITE_OMIT_
78d0: 41 4c 54 45 52 54 41 42 4c 45 3d 30 0a 3c 2f 70  ALTERTABLE=0.</p
78e0: 3e 0a 0a 3c 70 3e 49 66 20 61 6e 79 20 6f 66 20  >..<p>If any of 
78f0: 74 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 61 72  these options ar
7900: 65 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20  e defined, then 
7910: 74 68 65 20 73 61 6d 65 20 73 65 74 20 6f 66 20  the same set of 
7920: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 0a 6f 70  SQLITE_OMIT_*.op
7930: 74 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73 6f 20  tions must also 
7940: 62 65 20 64 65 66 69 6e 65 64 20 77 68 65 6e 20  be defined when 
7950: 75 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f 6e  using the 'lemon
7960: 27 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72 61  ' tool to genera
7970: 74 65 20 74 68 65 0a 70 61 72 73 65 2e 63 20 66  te the.parse.c f
7980: 69 6c 65 20 61 6e 64 20 77 68 65 6e 20 63 6f 6d  ile and when com
7990: 70 69 6c 69 6e 67 20 74 68 65 20 27 6d 6b 6b 65  piling the 'mkke
79a0: 79 77 6f 72 64 68 61 73 68 27 20 74 6f 6f 6c 20  ywordhash' tool 
79b0: 77 68 69 63 68 20 67 65 6e 65 72 61 74 65 73 20  which generates 
79c0: 0a 74 68 65 20 6b 65 79 77 6f 72 64 68 61 73 68  .the keywordhash
79d0: 2e 68 20 66 69 6c 65 2e 0a 42 65 63 61 75 73 65  .h file..Because
79e0: 20 6f 66 20 74 68 69 73 2c 20 74 68 65 73 65 20   of this, these 
79f0: 6f 70 74 69 6f 6e 73 20 6d 61 79 20 6f 6e 6c 79  options may only
7a00: 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68   be used when th
7a10: 65 20 6c 69 62 72 61 72 79 20 69 73 20 62 75 69  e library is bui
7a20: 6c 74 0a 66 72 6f 6d 20 63 61 6e 6f 6e 69 63 61  lt.from canonica
7a30: 6c 20 73 6f 75 72 63 65 2c 20 6e 6f 74 20 66 72  l source, not fr
7a40: 6f 6d 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61  om the [amalgama
7a50: 74 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d 20 74 68  tion] or from th
7a60: 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a  e collection of.
7a70: 70 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20 66  pre-packaged C f
7a80: 69 6c 65 73 20 70 72 6f 76 69 64 65 64 20 66 6f  iles provided fo
7a90: 72 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69 6b 65 20  r non-Unix like 
7aa0: 70 6c 61 74 66 6f 72 6d 73 20 6f 6e 20 74 68 65  platforms on the
7ab0: 20 77 65 62 73 69 74 65 2e 0a 41 6e 79 20 53 51   website..Any SQ
7ac0: 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69  LITE_OMIT_* opti
7ad0: 6f 6e 73 20 77 68 69 63 68 20 63 61 6e 20 62 65  ons which can be
7ae0: 20 75 73 65 64 20 64 69 72 65 63 74 6c 79 20 77   used directly w
7af0: 69 74 68 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d  ith the [amalgam
7b00: 61 74 69 6f 6e 5d 20 0a 61 72 65 20 6c 69 73 74  ation] .are list
7b10: 65 64 20 62 65 6c 6f 77 2c 20 68 6f 77 65 76 65  ed below, howeve
7b20: 72 2c 20 74 68 65 20 77 61 72 6e 69 6e 67 73 20  r, the warnings 
7b30: 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  in the following
7b40: 20 70 61 72 61 67 72 61 70 68 20 73 68 6f 75 6c   paragraph shoul
7b50: 64 20 62 65 20 6e 6f 74 65 64 2e 0a 3c 2f 70 3e  d be noted..</p>
7b60: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c  ..<blockquote>.<
7b70: 69 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e 74 20 4e  i><b>Important N
7b80: 6f 74 65 3a 3c 2f 62 3e 20 54 68 65 20 53 51 4c  ote:</b> The SQL
7b90: 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f  ITE_OMIT_* optio
7ba0: 6e 73 20 64 6f 20 6e 6f 74 20 77 6f 72 6b 20 77  ns do not work w
7bb0: 69 74 68 20 74 68 65 0a 5b 61 6d 61 6c 67 61 6d  ith the.[amalgam
7bc0: 61 74 69 6f 6e 5d 20 6f 72 20 77 69 74 68 20 70  ation] or with p
7bd0: 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20 63 6f  re-packaged C co
7be0: 64 65 20 66 69 6c 65 73 2e 20 20 53 51 4c 49 54  de files.  SQLIT
7bf0: 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65  E_OMIT_* compile
7c00: 2d 74 69 6d 65 0a 6f 70 74 69 6f 6e 73 20 6f 6e  -time.options on
7c10: 6c 79 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c  ly work correctl
7c20: 79 20 77 68 65 6e 20 53 51 4c 69 74 65 20 69 73  y when SQLite is
7c30: 20 62 75 69 6c 74 20 66 72 6f 6d 20 63 61 6e 6f   built from cano
7c40: 6e 69 63 61 6c 20 73 6f 75 72 63 65 20 66 69 6c  nical source fil
7c50: 65 73 2e 0a 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b  es..</i>.</block
7c60: 71 75 6f 74 65 3e 0a 0a 0a 3c 70 3e 53 70 65 63  quote>...<p>Spec
7c70: 69 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  ial versions of 
7c80: 74 68 65 20 53 51 4c 69 74 65 20 61 6d 61 6c 67  the SQLite amalg
7c90: 61 6d 61 74 69 6f 6e 20 74 68 61 74 20 64 6f 20  amation that do 
7ca0: 77 6f 72 6b 20 77 69 74 68 20 61 0a 70 72 65 64  work with a.pred
7cb0: 65 74 65 72 6d 69 6e 65 64 20 73 65 74 20 6f 66  etermined set of
7cc0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f   SQLITE_OMIT_* o
7cd0: 70 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 67 65  ptions can be ge
7ce0: 6e 65 72 61 74 65 64 2e 20 20 54 6f 20 64 6f 20  nerated.  To do 
7cf0: 73 6f 2c 0a 6d 61 6b 65 20 61 20 63 6f 70 79 20  so,.make a copy 
7d00: 6f 66 20 74 68 65 20 4d 61 6b 65 66 69 6c 65 2e  of the Makefile.
7d10: 6c 69 6e 75 78 2d 67 63 63 20 6d 61 6b 65 66 69  linux-gcc makefi
7d20: 6c 65 20 74 65 6d 70 6c 61 74 65 20 69 6e 20 74  le template in t
7d30: 68 65 20 63 61 6e 6f 6e 69 63 61 6c 0a 73 6f 75  he canonical.sou
7d40: 72 63 65 20 63 6f 64 65 20 64 69 73 74 72 69 62  rce code distrib
7d50: 75 74 69 6f 6e 2e 20 20 43 68 61 6e 67 65 20 74  ution.  Change t
7d60: 68 65 20 6e 61 6d 65 20 6f 66 20 79 6f 75 72 20  he name of your 
7d70: 63 6f 70 79 20 74 6f 20 73 69 6d 70 6c 79 20 22  copy to simply "
7d80: 4d 61 6b 65 66 69 6c 65 22 2e 0a 54 68 65 6e 20  Makefile"..Then 
7d90: 65 64 69 74 20 22 4d 61 6b 65 66 69 6c 65 22 20  edit "Makefile" 
7da0: 74 6f 20 73 65 74 20 75 70 20 61 70 70 72 6f 70  to set up approp
7db0: 72 69 61 74 65 20 63 6f 6d 70 69 6c 65 2d 74 69  riate compile-ti
7dc0: 6d 65 20 6f 70 74 69 6f 6e 73 2e 20 20 54 68 65  me options.  The
7dd0: 6e 0a 74 79 70 65 3a 0a 3c 62 6c 6f 63 6b 71 75  n.type:.<blockqu
7de0: 6f 74 65 3e 3c 74 74 3e 6d 61 6b 65 20 63 6c 65  ote><tt>make cle
7df0: 61 6e 3b 20 6d 61 6b 65 20 73 71 6c 69 74 65 33  an; make sqlite3
7e00: 2e 63 3c 2f 74 74 3e 3c 2f 62 6c 6f 63 6b 71 75  .c</tt></blockqu
7e10: 6f 74 65 3e 0a 54 68 65 20 72 65 73 75 6c 74 69  ote>.The resulti
7e20: 6e 67 20 22 73 71 6c 69 74 65 33 2e 63 22 20 61  ng "sqlite3.c" a
7e30: 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 63 6f 64 65  malgamation code
7e40: 20 66 69 6c 65 20 28 61 6e 64 20 69 74 73 20 61   file (and its a
7e50: 73 73 6f 63 69 61 74 65 64 0a 68 65 61 64 65 72  ssociated.header
7e60: 20 66 69 6c 65 20 22 73 71 6c 69 74 65 33 2e 68   file "sqlite3.h
7e70: 22 29 20 63 61 6e 20 74 68 65 6e 20 62 65 20 6d  ") can then be m
7e80: 6f 76 65 64 20 74 6f 20 61 20 6e 6f 6e 2d 75 6e  oved to a non-un
7e90: 69 78 20 70 6c 61 74 66 6f 72 6d 0a 66 6f 72 20  ix platform.for 
7ea0: 66 69 6e 61 6c 20 63 6f 6d 70 69 6c 61 74 69 6f  final compilatio
7eb0: 6e 20 75 73 69 6e 67 20 61 20 6e 61 74 69 76 65  n using a native
7ec0: 20 63 6f 6d 70 69 6c 65 72 2e 3c 2f 70 3e 0a 0a   compiler.</p>..
7ed0: 3c 70 3e 41 6c 6c 20 6f 66 20 74 68 65 20 53 51  <p>All of the SQ
7ee0: 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69  LITE_OMIT_* opti
7ef0: 6f 6e 73 20 61 72 65 20 75 6e 73 75 70 70 6f 72  ons are unsuppor
7f00: 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ted.</p>..<block
7f10: 71 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e 49 6d 70  quote>.<i><b>Imp
7f20: 6f 72 74 61 6e 74 20 4e 6f 74 65 3a 3c 2f 62 3e  ortant Note:</b>
7f30: 0a 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54  .The SQLITE_OMIT
7f40: 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  _* compile-time 
7f50: 6f 70 74 69 6f 6e 73 20 61 72 65 20 75 6e 73 75  options are unsu
7f60: 70 70 6f 72 74 65 64 2e 0a 3c 2f 69 3e 3c 2f 62  pported..</i></b
7f70: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a  lockquote>..<p>.
7f80: 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  The SQLITE_OMIT_
7f90: 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  * compile-time o
7fa0: 70 74 69 6f 6e 73 20 61 72 65 20 75 73 75 61 6c  ptions are usual
7fb0: 6c 79 20 75 6e 74 65 73 74 65 64 20 61 6e 64 0a  ly untested and.
7fc0: 61 72 65 20 61 6c 6d 6f 73 74 20 63 65 72 74 61  are almost certa
7fd0: 69 6e 6c 79 20 75 6e 74 65 73 74 65 64 20 69 6e  inly untested in
7fe0: 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 2e 0a 41 6e   combination..An
7ff0: 79 20 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 73  y or all of thes
8000: 65 20 6f 70 74 69 6f 6e 73 20 6d 61 79 20 62 65  e options may be
8010: 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68   removed from th
8020: 65 20 63 6f 64 65 20 69 6e 20 66 75 74 75 72 65  e code in future
8030: 20 72 65 6c 65 61 73 65 73 0a 61 6e 64 20 77 69   releases.and wi
8040: 74 68 6f 75 74 20 77 61 72 6e 69 6e 67 2e 20 20  thout warning.  
8050: 46 6f 72 20 61 6e 79 20 70 61 72 74 69 63 75 6c  For any particul
8060: 61 72 20 72 65 6c 65 61 73 65 2c 20 73 6f 6d 65  ar release, some
8070: 20 6f 66 20 74 68 65 73 65 0a 6f 70 74 69 6f 6e   of these.option
8080: 73 20 6d 61 79 20 63 61 75 73 65 20 63 6f 6d 70  s may cause comp
8090: 69 6c 65 2d 74 69 6d 65 20 6f 72 20 72 75 6e 2d  ile-time or run-
80a0: 74 69 6d 65 20 66 61 69 6c 75 72 65 73 2c 20 70  time failures, p
80b0: 61 72 74 69 63 75 6c 61 72 6c 79 0a 77 68 65 6e  articularly.when
80c0: 20 75 73 65 64 20 69 6e 20 63 6f 6d 62 69 6e 61   used in combina
80d0: 74 69 6f 6e 20 77 69 74 68 20 6f 74 68 65 72 20  tion with other 
80e0: 6f 70 74 69 6f 6e 73 2e 3c 2f 70 3e 0a 0a 3c 74  options.</p>..<t
80f0: 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  cl>.COMPILE_OPTI
8100: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
8110: 41 4c 54 45 52 54 41 42 4c 45 7d 20 7b 0a 20 20  ALTERTABLE} {.  
8120: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
8130: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
8140: 20 0a 20 20 5b 41 4c 54 45 52 20 54 41 42 4c 45   .  [ALTER TABLE
8150: 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74  ] command is not
8160: 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65   included in the
8170: 20 0a 20 20 6c 69 62 72 61 72 79 2e 20 45 78 65   .  library. Exe
8180: 63 75 74 69 6e 67 20 61 6e 20 5b 41 4c 54 45 52  cuting an [ALTER
8190: 20 54 41 42 4c 45 5d 20 73 74 61 74 65 6d 65 6e   TABLE] statemen
81a0: 74 20 63 61 75 73 65 73 20 61 20 70 61 72 73 65  t causes a parse
81b0: 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49   error..}..COMPI
81c0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
81d0: 45 5f 4f 4d 49 54 5f 41 4e 41 4c 59 5a 45 7d 20  E_OMIT_ANALYZE} 
81e0: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
81f0: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
8200: 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63   the [ANALYZE] c
8210: 6f 6d 6d 61 6e 64 20 69 73 20 6f 6d 69 74 74 65  ommand is omitte
8220: 64 20 66 72 6f 6d 0a 20 20 74 68 65 20 62 75 69  d from.  the bui
8230: 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ld..}..COMPILE_O
8240: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
8250: 49 54 5f 41 54 54 41 43 48 7d 20 7b 0a 20 20 57  IT_ATTACH} {.  W
8260: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
8270: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
8280: 5b 41 54 54 41 43 48 5d 20 61 6e 64 20 5b 44 45  [ATTACH] and [DE
8290: 54 41 43 48 5d 20 63 6f 6d 6d 61 6e 64 73 20 61  TACH] commands a
82a0: 72 65 0a 20 20 6f 6d 69 74 74 65 64 20 66 72 6f  re.  omitted fro
82b0: 6d 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a  m the build..}..
82c0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
82d0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48  SQLITE_OMIT_AUTH
82e0: 4f 52 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 44  ORIZATION} {.  D
82f0: 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74  efining this opt
8300: 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 61 75  ion omits the au
8310: 74 68 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c  thorization call
8320: 62 61 63 6b 20 66 65 61 74 75 72 65 20 66 72 6f  back feature fro
8330: 6d 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79 2e  m the.  library.
8340: 20 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 65   The [sqlite3_se
8350: 74 5f 61 75 74 68 6f 72 69 7a 65 72 28 29 5d 20  t_authorizer()] 
8360: 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  API function is 
8370: 6e 6f 74 20 70 72 65 73 65 6e 74 0a 20 20 69 6e  not present.  in
8380: 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a   the library..}.
8390: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
83a0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54  {SQLITE_OMIT_AUT
83b0: 4f 49 4e 43 52 45 4d 45 4e 54 7d 20 7b 0a 20 20  OINCREMENT} {.  
83c0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75  This option is u
83d0: 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20  sed to omit the 
83e0: 0a 20 20 5b 41 55 54 4f 49 4e 43 52 45 4d 45 4e  .  [AUTOINCREMEN
83f0: 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  T] functionality
8400: 2e 20 57 68 65 6e 20 74 68 69 73 20 0a 20 20 69  . When this .  i
8410: 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  s macro is defin
8420: 65 64 2c 20 63 6f 6c 75 6d 6e 73 20 64 65 63 6c  ed, columns decl
8430: 61 72 65 64 20 61 73 20 0a 20 20 22 5b 49 4e 54  ared as .  "[INT
8440: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
8450: 5d 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 22  ] AUTOINCREMENT"
8460: 0a 20 20 62 65 68 61 76 65 20 69 6e 20 74 68 65  .  behave in the
8470: 20 73 61 6d 65 20 77 61 79 20 61 73 20 63 6f 6c   same way as col
8480: 75 6d 6e 73 20 64 65 63 6c 61 72 65 64 20 61 73  umns declared as
8490: 20 22 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41   "[INTEGER PRIMA
84a0: 52 59 20 4b 45 59 5d 22 20 77 68 65 6e 20 61 20  RY KEY]" when a 
84b0: 0a 20 20 4e 55 4c 4c 20 69 73 20 69 6e 73 65 72  .  NULL is inser
84c0: 74 65 64 2e 20 54 68 65 20 73 71 6c 69 74 65 5f  ted. The sqlite_
84d0: 73 65 71 75 65 6e 63 65 20 73 79 73 74 65 6d 20  sequence system 
84e0: 74 61 62 6c 65 20 69 73 20 6e 65 69 74 68 65 72  table is neither
84f0: 20 63 72 65 61 74 65 64 2c 20 6e 6f 72 0a 20 20   created, nor.  
8500: 72 65 73 70 65 63 74 65 64 20 69 66 20 69 74 20  respected if it 
8510: 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 2e 0a  already exists..
8520: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
8530: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
8540: 55 54 4f 49 4e 49 54 7d 20 7b 0a 20 20 46 6f 72  UTOINIT} {.  For
8550: 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61   backwards compa
8560: 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c  tibility with ol
8570: 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  der versions of 
8580: 53 51 4c 69 74 65 20 74 68 61 74 20 6c 61 63 6b  SQLite that lack
8590: 0a 20 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  .  the [sqlite3_
85a0: 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 69 6e  initialize()] in
85b0: 74 65 72 66 61 63 65 2c 20 74 68 65 20 5b 73 71  terface, the [sq
85c0: 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65  lite3_initialize
85d0: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 0a 20 20  ()] interface.  
85e0: 69 73 20 63 61 6c 6c 65 64 20 61 75 74 6f 6d 61  is called automa
85f0: 74 69 63 61 6c 6c 79 20 75 70 6f 6e 20 65 6e 74  tically upon ent
8600: 72 79 20 74 6f 20 63 65 72 74 61 69 6e 20 6b 65  ry to certain ke
8610: 79 20 69 6e 74 65 72 66 61 63 65 73 20 73 75 63  y interfaces suc
8620: 68 20 61 73 0a 20 20 5b 73 71 6c 69 74 65 33 5f  h as.  [sqlite3_
8630: 6f 70 65 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65  open()], [sqlite
8640: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29  3_vfs_register()
8650: 5d 2c 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f  ], and [sqlite3_
8660: 6d 70 72 69 6e 74 66 28 29 5d 2e 0a 20 20 54 68  mprintf()]..  Th
8670: 65 20 6f 76 65 72 68 65 61 64 20 6f 66 20 69 6e  e overhead of in
8680: 76 6f 6b 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f  voking [sqlite3_
8690: 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 61 75  initialize()] au
86a0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 74  tomatically in t
86b0: 68 69 73 0a 20 20 77 61 79 20 6d 61 79 20 62 65  his.  way may be
86c0: 20 6f 6d 69 74 74 65 64 20 62 79 20 62 75 69 6c   omitted by buil
86d0: 64 69 6e 67 20 53 51 4c 69 74 65 20 77 69 74 68  ding SQLite with
86e0: 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54   the SQLITE_OMIT
86f0: 5f 41 55 54 4f 49 4e 49 54 0a 20 20 43 2d 70 72  _AUTOINIT.  C-pr
8700: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f  eprocessor macro
8710: 2e 20 20 57 68 65 6e 20 62 75 69 6c 74 20 75 73  .  When built us
8720: 69 6e 67 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ing SQLITE_OMIT_
8730: 41 55 54 4f 49 4e 49 54 2c 20 53 51 4c 69 74 65  AUTOINIT, SQLite
8740: 0a 20 20 77 69 6c 6c 20 6e 6f 74 20 61 75 74 6f  .  will not auto
8750: 6d 61 74 69 63 61 6c 6c 79 20 69 6e 69 74 69 61  matically initia
8760: 6c 69 7a 65 20 69 74 73 65 6c 66 20 61 6e 64 20  lize itself and 
8770: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
8780: 69 73 20 72 65 71 75 69 72 65 64 0a 20 20 74 6f  is required.  to
8790: 20 69 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33   invoke [sqlite3
87a0: 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 64  _initialize()] d
87b0: 69 72 65 63 74 6c 79 20 70 72 69 6f 72 20 74 6f  irectly prior to
87c0: 20 62 65 67 69 6e 6e 69 6e 67 20 75 73 65 20 6f   beginning use o
87d0: 66 20 74 68 65 0a 20 20 53 51 4c 69 74 65 20 6c  f the.  SQLite l
87e0: 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  ibrary..}..COMPI
87f0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
8800: 45 5f 4f 4d 49 54 5f 41 55 54 4f 4d 41 54 49 43  E_OMIT_AUTOMATIC
8810: 5f 49 4e 44 45 58 7d 20 7b 0a 20 20 54 68 69 73  _INDEX} {.  This
8820: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20   option is used 
8830: 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b  to omit the .  [
8840: 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 69  automatic indexi
8850: 6e 67 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74  ng] functionalit
8860: 79 2e 0a 20 20 53 65 65 20 61 6c 73 6f 3a 20 5b  y..  See also: [
8870: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41  SQLITE_DEFAULT_A
8880: 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 5d 2e  UTOMATIC_INDEX].
8890: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
88a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
88b0: 41 55 54 4f 52 45 53 45 54 7d 20 7b 0a 20 20 42  AUTORESET} {.  B
88c0: 79 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20 5b  y default, the [
88d0: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 5d 20  sqlite3_step()] 
88e0: 69 6e 74 65 72 66 61 63 65 20 77 69 6c 6c 20 61  interface will a
88f0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76  utomatically inv
8900: 6f 6b 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 72  oke.  [sqlite3_r
8910: 65 73 65 74 28 29 5d 20 74 6f 20 72 65 73 65 74  eset()] to reset
8920: 20 74 68 65 20 5b 70 72 65 70 61 72 65 64 20 73   the [prepared s
8930: 74 61 74 65 6d 65 6e 74 5d 20 69 66 20 6e 65 63  tatement] if nec
8940: 65 73 73 61 72 79 2e 20 20 54 68 69 73 0a 20 20  essary.  This.  
8950: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
8960: 69 6f 6e 20 63 68 61 6e 67 65 73 20 74 68 61 74  ion changes that
8970: 20 62 65 68 61 76 69 6f 72 20 73 6f 20 74 68 61   behavior so tha
8980: 74 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28  t [sqlite3_step(
8990: 29 5d 20 77 69 6c 6c 0a 20 20 72 65 74 75 72 6e  )] will.  return
89a0: 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d   [SQLITE_MISUSE]
89b0: 20 69 66 20 69 74 20 63 61 6c 6c 65 64 20 61 67   if it called ag
89c0: 61 69 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e  ain after return
89d0: 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 6f 74 68  ing anything oth
89e0: 65 72 0a 20 20 74 68 61 6e 20 5b 53 51 4c 49 54  er.  than [SQLIT
89f0: 45 5f 52 4f 57 5d 2c 20 5b 53 51 4c 49 54 45 5f  E_ROW], [SQLITE_
8a00: 42 55 53 59 5d 2c 20 6f 72 20 5b 53 51 4c 49 54  BUSY], or [SQLIT
8a10: 45 5f 4c 4f 43 4b 45 44 5d 20 75 6e 6c 65 73 73  E_LOCKED] unless
8a20: 20 74 68 65 72 65 20 77 61 73 20 61 6e 0a 20 20   there was an.  
8a30: 69 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c  intervening call
8a40: 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65 73   to [sqlite3_res
8a50: 65 74 28 29 5d 2e 0a 0a 20 20 49 6e 20 53 51 4c  et()]...  In SQL
8a60: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e  ite version 3.6.
8a70: 32 33 2e 31 20 61 6e 64 20 65 61 72 6c 69 65 72  23.1 and earlier
8a80: 2c 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28  , [sqlite3_step(
8a90: 29 5d 20 75 73 65 64 20 74 6f 20 61 6c 77 61 79  )] used to alway
8aa0: 73 0a 20 20 72 65 74 75 72 6e 20 5b 53 51 4c 49  s.  return [SQLI
8ab0: 54 45 5f 4d 49 53 55 53 45 5d 20 69 66 20 69 74  TE_MISUSE] if it
8ac0: 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 61 67 61   was invoked aga
8ad0: 69 6e 20 61 66 74 65 72 20 72 65 74 75 72 6e 69  in after returni
8ae0: 6e 67 20 61 6e 79 74 68 69 6e 67 0a 20 20 6f 74  ng anything.  ot
8af0: 68 65 72 20 74 68 61 6e 20 5b 53 51 4c 49 54 45  her than [SQLITE
8b00: 5f 52 4f 57 5d 20 77 69 74 68 6f 75 74 20 61 6e  _ROW] without an
8b10: 20 69 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c   intervening cal
8b20: 6c 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 72 65  l to [sqlite3_re
8b30: 73 65 74 28 29 5d 2e 0a 20 20 54 68 69 73 20 63  set()]..  This c
8b40: 61 75 73 65 64 20 70 72 6f 62 6c 65 6d 73 20 6f  aused problems o
8b50: 6e 20 73 6f 6d 65 20 70 6f 6f 72 6c 79 20 77 72  n some poorly wr
8b60: 69 74 74 65 6e 20 73 6d 61 72 74 70 68 6f 6e 65  itten smartphone
8b70: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 77 68   applications wh
8b80: 69 63 68 0a 20 20 64 69 64 20 6e 6f 74 20 63 6f  ich.  did not co
8b90: 72 72 65 63 74 6c 79 20 68 61 6e 64 6c 65 20 74  rrectly handle t
8ba0: 68 65 20 5b 53 51 4c 49 54 45 5f 4c 4f 43 4b 45  he [SQLITE_LOCKE
8bb0: 44 5d 20 61 6e 64 20 5b 53 51 4c 49 54 45 5f 42  D] and [SQLITE_B
8bc0: 55 53 59 5d 20 65 72 72 6f 72 20 0a 20 20 72 65  USY] error .  re
8bd0: 74 75 72 6e 73 2e 20 20 52 61 74 68 65 72 20 74  turns.  Rather t
8be0: 68 61 6e 20 66 69 78 20 74 68 65 20 6d 61 6e 79  han fix the many
8bf0: 20 64 65 66 65 63 74 69 76 65 20 73 6d 61 72 74   defective smart
8c00: 70 68 6f 6e 65 20 61 70 70 6c 69 63 61 74 69 6f  phone applicatio
8c10: 6e 73 2c 20 0a 20 20 74 68 65 20 62 65 68 61 76  ns, .  the behav
8c20: 69 6f 72 20 6f 66 20 53 51 4c 69 74 65 20 77 61  ior of SQLite wa
8c30: 73 20 63 68 61 6e 67 65 64 20 69 6e 20 33 2e 36  s changed in 3.6
8c40: 2e 32 33 2e 32 20 74 6f 20 61 75 74 6f 6d 61 74  .23.2 to automat
8c50: 69 63 61 6c 6c 79 20 72 65 73 65 74 0a 20 20 74  ically reset.  t
8c60: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
8c70: 65 6d 65 6e 74 2e 20 20 42 75 74 20 74 68 61 74  ement.  But that
8c80: 20 63 68 61 6e 67 65 64 20 63 61 75 73 65 64 20   changed caused 
8c90: 69 73 73 75 65 73 20 69 6e 20 6f 74 68 65 72 20  issues in other 
8ca0: 0a 20 20 69 6d 70 72 6f 70 65 72 6c 79 20 69 6d  .  improperly im
8cb0: 70 6c 65 6d 65 6e 74 65 64 20 61 70 70 6c 69 63  plemented applic
8cc0: 61 74 69 6f 6e 73 20 74 68 61 74 20 77 65 72 65  ations that were
8cd0: 20 61 63 74 75 61 6c 6c 79 20 6c 6f 6f 6b 69 6e   actually lookin
8ce0: 67 0a 20 20 66 6f 72 20 61 6e 20 5b 53 51 4c 49  g.  for an [SQLI
8cf0: 54 45 5f 4d 49 53 55 53 45 5d 20 72 65 74 75 72  TE_MISUSE] retur
8d00: 6e 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 20 74  n to terminate t
8d10: 68 65 69 72 20 71 75 65 72 79 20 6c 6f 6f 70 73  heir query loops
8d20: 2e 20 20 28 41 6e 79 74 69 6d 65 0a 20 20 61 6e  .  (Anytime.  an
8d30: 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 67 65 74   application get
8d40: 73 20 61 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55  s an SQLITE_MISU
8d50: 53 45 20 65 72 72 6f 72 20 63 6f 64 65 20 66 72  SE error code fr
8d60: 6f 6d 20 53 51 4c 69 74 65 2c 20 74 68 61 74 20  om SQLite, that 
8d70: 6d 65 61 6e 73 20 74 68 65 0a 20 20 61 70 70 6c  means the.  appl
8d80: 69 63 61 74 69 6f 6e 20 69 73 20 6d 69 73 75 73  ication is misus
8d90: 69 6e 67 20 74 68 65 20 53 51 4c 69 74 65 20 69  ing the SQLite i
8da0: 6e 74 65 72 66 61 63 65 20 61 6e 64 20 69 73 20  nterface and is 
8db0: 74 68 75 73 20 69 6e 63 6f 72 72 65 63 74 6c 79  thus incorrectly
8dc0: 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2e 29  .  implemented.)
8dd0: 20 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49    The SQLITE_OMI
8de0: 54 5f 41 55 54 4f 52 45 53 45 54 20 69 6e 74 65  T_AUTORESET inte
8df0: 72 66 61 63 65 20 77 61 73 20 61 64 64 65 64 20  rface was added 
8e00: 74 6f 20 53 51 4c 69 74 65 0a 20 20 76 65 72 73  to SQLite.  vers
8e10: 69 6f 6e 20 33 2e 37 2e 35 20 69 6e 20 61 6e 20  ion 3.7.5 in an 
8e20: 65 66 66 6f 72 74 20 74 6f 20 67 65 74 20 61 6c  effort to get al
8e30: 6c 20 6f 66 20 74 68 65 20 28 62 72 6f 6b 65 6e  l of the (broken
8e40: 29 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  ).  applications
8e50: 20 74 6f 20 77 6f 72 6b 20 61 67 61 69 6e 20 77   to work again w
8e60: 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f  ithout having to
8e70: 20 61 63 74 75 61 6c 6c 79 20 66 69 78 20 74 68   actually fix th
8e80: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a  e applications..
8e90: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
8ea0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
8eb0: 55 54 4f 56 41 43 55 55 4d 7d 20 7b 0a 20 20 49  UTOVACUUM} {.  I
8ec0: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  f this option is
8ed0: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69   defined, the li
8ee0: 62 72 61 72 79 20 63 61 6e 6e 6f 74 20 63 72 65  brary cannot cre
8ef0: 61 74 65 20 6f 72 20 77 72 69 74 65 20 74 6f 20  ate or write to 
8f00: 0a 20 20 64 61 74 61 62 61 73 65 73 20 74 68 61  .  databases tha
8f10: 74 20 73 75 70 70 6f 72 74 20 5b 61 75 74 6f 5f  t support [auto_
8f20: 76 61 63 75 75 6d 5d 2e 0a 20 20 45 78 65 63 75  vacuum]..  Execu
8f30: 74 69 6e 67 20 61 20 5b 50 52 41 47 4d 41 20 61  ting a [PRAGMA a
8f40: 75 74 6f 5f 76 61 63 75 75 6d 5d 20 73 74 61 74  uto_vacuum] stat
8f50: 65 6d 65 6e 74 20 69 73 20 6e 6f 74 20 61 6e 20  ement is not an 
8f60: 65 72 72 6f 72 0a 20 20 28 73 69 6e 63 65 20 75  error.  (since u
8f70: 6e 6b 6e 6f 77 6e 20 50 52 41 47 4d 41 73 20 61  nknown PRAGMAs a
8f80: 72 65 20 73 69 6c 65 6e 74 6c 79 20 69 67 6e 6f  re silently igno
8f90: 72 65 64 29 2c 20 62 75 74 20 64 6f 65 73 20 6e  red), but does n
8fa0: 6f 74 20 72 65 74 75 72 6e 20 61 20 76 61 6c 75  ot return a valu
8fb0: 65 0a 20 20 6f 72 20 6d 6f 64 69 66 79 20 74 68  e.  or modify th
8fc0: 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 66 6c  e auto-vacuum fl
8fd0: 61 67 20 69 6e 20 74 68 65 20 64 61 74 61 62 61  ag in the databa
8fe0: 73 65 20 66 69 6c 65 2e 20 49 66 20 61 20 64 61  se file. If a da
8ff0: 74 61 62 61 73 65 20 74 68 61 74 0a 20 20 73 75  tabase that.  su
9000: 70 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 75  pports auto-vacu
9010: 75 6d 20 69 73 20 6f 70 65 6e 65 64 20 62 79 20  um is opened by 
9020: 61 20 6c 69 62 72 61 72 79 20 63 6f 6d 70 69 6c  a library compil
9030: 65 64 20 77 69 74 68 20 74 68 69 73 20 6f 70 74  ed with this opt
9040: 69 6f 6e 2c 20 69 74 0a 20 20 69 73 20 61 75 74  ion, it.  is aut
9050: 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 70 65 6e 65  omatically opene
9060: 64 20 69 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d  d in read-only m
9070: 6f 64 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ode..}..COMPILE_
9080: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
9090: 4d 49 54 5f 42 45 54 57 45 45 4e 5f 4f 50 54 49  MIT_BETWEEN_OPTI
90a0: 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68  MIZATION} {.  Th
90b0: 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c  is option disabl
90c0: 65 73 20 74 68 65 20 75 73 65 20 6f 66 20 69 6e  es the use of in
90d0: 64 69 63 65 73 20 77 69 74 68 20 57 48 45 52 45  dices with WHERE
90e0: 20 63 6c 61 75 73 65 20 74 65 72 6d 73 0a 20 20   clause terms.  
90f0: 74 68 61 74 20 65 6d 70 6c 6f 79 20 74 68 65 20  that employ the 
9100: 42 45 54 57 45 45 4e 20 6f 70 65 72 61 74 6f 72  BETWEEN operator
9110: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
9120: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
9130: 5f 42 4c 4f 42 5f 4c 49 54 45 52 41 4c 7d 20 7b  _BLOB_LITERAL} {
9140: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
9150: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
9160: 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62  it is not possib
9170: 6c 65 20 74 6f 20 73 70 65 63 69 66 79 20 61 20  le to specify a 
9180: 62 6c 6f 62 20 69 6e 0a 20 20 61 6e 20 53 51 4c  blob in.  an SQL
9190: 20 73 74 61 74 65 6d 65 6e 74 20 75 73 69 6e 67   statement using
91a0: 20 74 68 65 20 58 27 41 42 43 44 27 20 73 79 6e   the X'ABCD' syn
91b0: 74 61 78 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  tax..}..COMPILE_
91c0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
91d0: 4d 49 54 5f 42 54 52 45 45 43 4f 55 4e 54 7d 20  MIT_BTREECOUNT} 
91e0: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
91f0: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
9200: 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e   an optimization
9210: 20 74 68 61 74 20 61 63 63 65 6c 65 72 61 74 65   that accelerate
9220: 73 20 63 6f 75 6e 74 69 6e 67 0a 20 20 61 6c 6c  s counting.  all
9230: 20 65 6e 74 72 69 65 73 20 69 6e 20 61 20 74 61   entries in a ta
9240: 62 6c 65 20 28 69 6e 20 6f 74 68 65 72 20 77 6f  ble (in other wo
9250: 72 64 73 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61  rds, an optimiza
9260: 74 69 6f 6e 20 74 68 61 74 20 68 65 6c 70 73 0a  tion that helps.
9270: 20 20 22 53 45 4c 45 43 54 20 63 6f 75 6e 74 28    "SELECT count(
9280: 2a 29 20 46 52 4f 4d 20 74 61 62 6c 65 22 20 72  *) FROM table" r
9290: 75 6e 20 66 61 73 74 65 72 29 20 69 73 20 6f 6d  un faster) is om
92a0: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
92b0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
92c0: 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45  _OMIT_BUILTIN_TE
92d0: 53 54 7d 20 7b 0a 20 20 41 20 73 74 61 6e 64 61  ST} {.  A standa
92e0: 72 64 20 53 51 4c 69 74 65 20 62 75 69 6c 64 20  rd SQLite build 
92f0: 69 6e 63 6c 75 64 65 73 20 61 20 73 6d 61 6c 6c  includes a small
9300: 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67 69 63   amount of logic
9310: 20 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20 62 79   controlled.  by
9320: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 65   the [sqlite3_te
9330: 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d 20 69 6e  st_control()] in
9340: 74 65 72 66 61 63 65 20 74 68 61 74 20 69 73 20  terface that is 
9350: 75 73 65 64 20 74 6f 20 65 78 65 72 63 69 73 65  used to exercise
9360: 0a 20 20 70 61 72 74 73 20 6f 66 20 74 68 65 20  .  parts of the 
9370: 53 51 4c 69 74 65 20 63 6f 72 65 20 74 68 61 74  SQLite core that
9380: 20 61 72 65 20 64 69 66 66 69 63 75 6c 74 20 74   are difficult t
9390: 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20 6d 65  o control and me
93a0: 61 73 75 72 65 20 75 73 69 6e 67 0a 20 20 74 68  asure using.  th
93b0: 65 20 73 74 61 6e 64 61 72 64 20 41 50 49 2e 20  e standard API. 
93c0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
93d0: 74 73 20 74 68 61 74 20 62 75 69 6c 74 2d 69 6e  ts that built-in
93e0: 20 74 65 73 74 20 6c 6f 67 69 63 2e 0a 7d 0a 0a   test logic..}..
93f0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9400: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 41 53 54  SQLITE_OMIT_CAST
9410: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
9420: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
9430: 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20  to omit support 
9440: 66 6f 72 20 74 68 65 20 43 41 53 54 20 6f 70 65  for the CAST ope
9450: 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  rator..}..COMPIL
9460: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
9470: 5f 4f 4d 49 54 5f 43 48 45 43 4b 7d 20 7b 0a 20  _OMIT_CHECK} {. 
9480: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
9490: 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d  ses SQLite to om
94a0: 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 43  it support for C
94b0: 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73  HECK constraints
94c0: 2e 0a 20 20 54 68 65 20 70 61 72 73 65 72 20 77  ..  The parser w
94d0: 69 6c 6c 20 73 74 69 6c 6c 20 61 63 63 65 70 74  ill still accept
94e0: 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e   CHECK constrain
94f0: 74 73 20 69 6e 20 53 51 4c 20 73 74 61 74 65 6d  ts in SQL statem
9500: 65 6e 74 73 2c 0a 20 20 74 68 65 79 20 77 69 6c  ents,.  they wil
9510: 6c 20 6a 75 73 74 20 6e 6f 74 20 62 65 20 65 6e  l just not be en
9520: 66 6f 72 63 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  forced..}..COMPI
9530: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
9540: 45 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50  E_OMIT_COMPILEOP
9550: 54 49 4f 4e 5f 44 49 41 47 53 7d 20 7b 0a 20 20  TION_DIAGS} {.  
9560: 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75  This option is u
9570: 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20  sed to omit the 
9580: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
9590: 69 6f 6e 20 64 69 61 67 6e 6f 73 74 69 63 73 20  ion diagnostics 
95a0: 61 76 61 69 6c 61 62 6c 65 0a 20 20 69 6e 20 53  available.  in S
95b0: 51 4c 69 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67  QLite, including
95c0: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f   the [sqlite3_co
95d0: 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 75 73 65 64  mpileoption_used
95e0: 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74  ()] and.  [sqlit
95f0: 65 33 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e  e3_compileoption
9600: 5f 67 65 74 28 29 5d 20 43 2f 43 2b 2b 20 66 75  _get()] C/C++ fu
9610: 6e 63 74 69 6f 6e 73 2c 20 74 68 65 0a 20 20 5b  nctions, the.  [
9620: 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f 70  sqlite_compileop
9630: 74 69 6f 6e 5f 75 73 65 64 28 29 5d 20 61 6e 64  tion_used()] and
9640: 20 5b 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c 65   [sqlite_compile
9650: 6f 70 74 69 6f 6e 5f 67 65 74 28 29 5d 20 53 51  option_get()] SQ
9660: 4c 20 66 75 6e 63 74 69 6f 6e 73 2c 0a 20 20 61  L functions,.  a
9670: 6e 64 20 74 68 65 20 5b 63 6f 6d 70 69 6c 65 5f  nd the [compile_
9680: 6f 70 74 69 6f 6e 73 20 70 72 61 67 6d 61 5d 2e  options pragma].
9690: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
96a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
96b0: 43 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20 20 54 68  COMPLETE} {.  Th
96c0: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73  is option causes
96d0: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f   the [sqlite3_co
96e0: 6d 70 6c 65 74 65 28 29 5d 20 61 6e 64 20 5b 73  mplete()] and [s
96f0: 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31  qlite3_complete1
9700: 36 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 65  6()].  interface
9710: 73 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e  s to be omitted.
9720: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
9730: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
9740: 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 7d  COMPOUND_SELECT}
9750: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
9760: 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74   is used to omit
9770: 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 5b 53   the compound [S
9780: 45 4c 45 43 54 5d 20 66 75 6e 63 74 69 6f 6e 61  ELECT] functiona
9790: 6c 69 74 79 2e 20 0a 20 20 5b 53 45 4c 45 43 54  lity. .  [SELECT
97a0: 5d 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61  ] statements tha
97b0: 74 20 75 73 65 20 74 68 65 20 0a 20 20 55 4e 49  t use the .  UNI
97c0: 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20 49  ON, UNION ALL, I
97d0: 4e 54 45 52 53 45 43 54 20 6f 72 20 45 58 43 45  NTERSECT or EXCE
97e0: 50 54 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45  PT compound SELE
97f0: 43 54 20 6f 70 65 72 61 74 6f 72 73 20 77 69 6c  CT operators wil
9800: 6c 20 0a 20 20 63 61 75 73 65 20 61 20 70 61 72  l .  cause a par
9810: 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20 41 6e 20  se error...  An 
9820: 5b 49 4e 53 45 52 54 5d 20 73 74 61 74 65 6d 65  [INSERT] stateme
9830: 6e 74 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65  nt with multiple
9840: 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 56   values in the V
9850: 41 4c 55 45 53 20 63 6c 61 75 73 65 20 69 73 0a  ALUES clause is.
9860: 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e    implemented in
9870: 74 65 72 6e 61 6c 6c 79 20 61 73 20 61 20 63 6f  ternally as a co
9880: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e 20 20  mpound SELECT.  
9890: 48 65 6e 63 65 2c 20 74 68 69 73 20 6f 70 74 69  Hence, this opti
98a0: 6f 6e 20 61 6c 73 6f 0a 20 20 64 69 73 61 62 6c  on also.  disabl
98b0: 65 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74  es the ability t
98c0: 6f 20 69 6e 73 65 72 74 20 6d 6f 72 65 20 74 68  o insert more th
98d0: 61 6e 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20  an a single row 
98e0: 75 73 69 6e 67 20 61 6e 0a 20 20 49 4e 53 45 52  using an.  INSER
98f0: 54 20 49 4e 54 4f 20 2e 2e 2e 20 56 41 4c 55 45  T INTO ... VALUE
9900: 53 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2e  S ... statement.
9910: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
9920: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
9930: 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53 7d 20  DATETIME_FUNCS} 
9940: 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69  {.  If this opti
9950: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53  on is defined, S
9960: 51 4c 69 74 65 27 73 20 62 75 69 6c 74 2d 69 6e  QLite's built-in
9970: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 6d   date and time m
9980: 61 6e 69 70 75 6c 61 74 69 6f 6e 0a 20 20 66 75  anipulation.  fu
9990: 6e 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69 74  nctions are omit
99a0: 74 65 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c  ted. Specificall
99b0: 79 2c 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74  y, the SQL funct
99c0: 69 6f 6e 73 20 6a 75 6c 69 61 6e 64 61 79 28 29  ions julianday()
99d0: 2c 20 64 61 74 65 28 29 2c 0a 20 20 74 69 6d 65  , date(),.  time
99e0: 28 29 2c 20 64 61 74 65 74 69 6d 65 28 29 20 61  (), datetime() a
99f0: 6e 64 20 73 74 72 66 74 69 6d 65 28 29 20 61 72  nd strftime() ar
9a00: 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e  e not available.
9a10: 20 54 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c   The default col
9a20: 75 6d 6e 0a 20 20 76 61 6c 75 65 73 20 43 55 52  umn.  values CUR
9a30: 52 45 4e 54 5f 54 49 4d 45 2c 20 43 55 52 52 45  RENT_TIME, CURRE
9a40: 4e 54 5f 44 41 54 45 20 61 6e 64 20 43 55 52 52  NT_DATE and CURR
9a50: 45 4e 54 5f 54 49 4d 45 53 54 41 4d 50 20 61 72  ENT_TIMESTAMP ar
9a60: 65 20 73 74 69 6c 6c 20 61 76 61 69 6c 61 62 6c  e still availabl
9a70: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
9a80: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
9a90: 54 5f 44 45 43 4c 54 59 50 45 7d 20 7b 0a 20 20  T_DECLTYPE} {.  
9aa0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
9ab0: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69  es SQLite to omi
9ac0: 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68  t support for th
9ad0: 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c  e.  [sqlite3_col
9ae0: 75 6d 6e 5f 64 65 63 6c 74 79 70 65 28 29 5d 20  umn_decltype()] 
9af0: 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c  and [sqlite3_col
9b00: 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 29  umn_decltype16()
9b10: 5d 0a 20 20 69 6e 74 65 72 66 61 63 65 73 2e 0a  ].  interfaces..
9b20: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
9b30: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44  N {SQLITE_OMIT_D
9b40: 45 50 52 45 43 41 54 45 44 7d 20 7b 0a 20 20 54  EPRECATED} {.  T
9b50: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
9b60: 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74  s SQLite to omit
9b70: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 69 6e 74   support for int
9b80: 65 72 66 61 63 65 73 0a 20 20 6d 61 72 6b 65 64  erfaces.  marked
9b90: 20 61 73 20 64 65 70 72 65 63 61 74 65 64 2e 20   as deprecated. 
9ba0: 20 54 68 69 73 20 69 6e 63 6c 75 64 65 73 20 0a   This includes .
9bb0: 20 20 5b 73 71 6c 69 74 65 33 5f 61 67 67 72 65    [sqlite3_aggre
9bc0: 67 61 74 65 5f 63 6f 75 6e 74 28 29 5d 2c 0a 20  gate_count()],. 
9bd0: 20 5b 73 71 6c 69 74 65 33 5f 65 78 70 69 72 65   [sqlite3_expire
9be0: 64 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65 33  d()],.  [sqlite3
9bf0: 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64 69 6e  _transfer_bindin
9c00: 67 73 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65  gs()],.  [sqlite
9c10: 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76 65 72  3_global_recover
9c20: 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f  ()],.  [sqlite3_
9c30: 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 70 28 29  thread_cleanup()
9c40: 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33  ] and.  [sqlite3
9c50: 5f 6d 65 6d 6f 72 79 5f 61 6c 61 72 6d 28 29 5d  _memory_alarm()]
9c60: 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a   interfaces..}..
9c70: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9c80: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b  SQLITE_OMIT_DISK
9c90: 49 4f 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  IO} {.  This opt
9ca0: 69 6f 6e 20 6f 6d 69 74 73 20 61 6c 6c 20 73 75  ion omits all su
9cb0: 70 70 6f 72 74 20 66 6f 72 20 77 72 69 74 69 6e  pport for writin
9cc0: 67 20 74 6f 20 74 68 65 20 64 69 73 6b 20 61 6e  g to the disk an
9cd0: 64 20 66 6f 72 63 65 73 0a 20 20 64 61 74 61 62  d forces.  datab
9ce0: 61 73 65 73 20 74 6f 20 65 78 69 73 74 20 69 6e  ases to exist in
9cf0: 20 6d 65 6d 6f 72 79 20 6f 6e 6c 79 2e 20 20 54   memory only.  T
9d00: 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73 20 6e  his option has n
9d10: 6f 74 20 62 65 65 6e 20 0a 20 20 6d 61 69 6e 74  ot been .  maint
9d20: 61 69 6e 65 64 20 61 6e 64 20 70 72 6f 62 61 62  ained and probab
9d30: 6c 79 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b  ly does not work
9d40: 20 77 69 74 68 20 6e 65 77 65 72 20 76 65 72 73   with newer vers
9d50: 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a  ions of SQLite..
9d60: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
9d70: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45  N {SQLITE_OMIT_E
9d80: 58 50 4c 41 49 4e 7d 20 7b 0a 20 20 44 65 66 69  XPLAIN} {.  Defi
9d90: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
9da0: 20 63 61 75 73 65 73 20 74 68 65 20 5b 45 58 50   causes the [EXP
9db0: 4c 41 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f  LAIN] command to
9dc0: 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d   be omitted from
9dd0: 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20   the.  library. 
9de0: 41 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78  Attempting to ex
9df0: 65 63 75 74 65 20 61 6e 20 5b 45 58 50 4c 41 49  ecute an [EXPLAI
9e00: 4e 5d 20 73 74 61 74 65 6d 65 6e 74 20 77 69 6c  N] statement wil
9e10: 6c 20 63 61 75 73 65 20 61 20 70 61 72 73 65 0a  l cause a parse.
9e20: 20 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50    error..}..COMP
9e30: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
9e40: 54 45 5f 4f 4d 49 54 5f 46 4c 41 47 5f 50 52 41  TE_OMIT_FLAG_PRA
9e50: 47 4d 41 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f  GMAS} {.  This o
9e60: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70  ption omits supp
9e70: 6f 72 74 20 66 6f 72 20 61 20 73 75 62 73 65 74  ort for a subset
9e80: 20 6f 66 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d   of [PRAGMA] com
9e90: 6d 61 6e 64 73 20 74 68 61 74 0a 20 20 71 75 65  mands that.  que
9ea0: 72 79 20 61 6e 64 20 73 65 74 20 62 6f 6f 6c 65  ry and set boole
9eb0: 61 6e 20 70 72 6f 70 65 72 74 69 65 73 2e 0a 7d  an properties..}
9ec0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
9ed0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c   {SQLITE_OMIT_FL
9ee0: 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 7d 20 7b 0a  OATING_POINT} {.
9ef0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73    This option is
9f00: 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 66 6c   used to omit fl
9f10: 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d  oating-point num
9f20: 62 65 72 20 73 75 70 70 6f 72 74 20 66 72 6f 6d  ber support from
9f30: 20 74 68 65 20 53 51 4c 69 74 65 0a 20 20 6c 69   the SQLite.  li
9f40: 62 72 61 72 79 2e 20 57 68 65 6e 20 73 70 65 63  brary. When spec
9f50: 69 66 69 65 64 2c 20 73 70 65 63 69 66 79 69 6e  ified, specifyin
9f60: 67 20 61 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69  g a floating poi
9f70: 6e 74 20 6e 75 6d 62 65 72 20 61 73 20 61 20 6c  nt number as a l
9f80: 69 74 65 72 61 6c 20 0a 20 20 28 69 2e 65 2e 20  iteral .  (i.e. 
9f90: 22 31 2e 30 31 22 29 20 72 65 73 75 6c 74 73 20  "1.01") results 
9fa0: 69 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  in a parse error
9fb0: 2e 0a 0a 20 20 3c 70 3e 49 6e 20 74 68 65 20 66  ...  <p>In the f
9fc0: 75 74 75 72 65 2c 20 74 68 69 73 20 6f 70 74 69  uture, this opti
9fd0: 6f 6e 20 6d 61 79 20 61 6c 73 6f 20 64 69 73 61  on may also disa
9fe0: 62 6c 65 20 6f 74 68 65 72 20 66 6c 6f 61 74 69  ble other floati
9ff0: 6e 67 20 70 6f 69 6e 74 20 0a 20 20 66 75 6e 63  ng point .  func
a000: 74 69 6f 6e 61 6c 69 74 79 2c 20 66 6f 72 20 65  tionality, for e
a010: 78 61 6d 70 6c 65 20 74 68 65 20 5b 73 71 6c 69  xample the [sqli
a020: 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c  te3_result_doubl
a030: 65 28 29 5d 2c 20 0a 20 20 5b 73 71 6c 69 74 65  e()], .  [sqlite
a040: 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 29 5d  3_bind_double()]
a050: 2c 20 5b 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  , [sqlite3_value
a060: 5f 64 6f 75 62 6c 65 28 29 5d 20 61 6e 64 0a 20  _double()] and. 
a070: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
a080: 5f 64 6f 75 62 6c 65 28 29 5d 20 41 50 49 20 66  _double()] API f
a090: 75 6e 63 74 69 6f 6e 73 2e 0a 20 20 3c 2f 70 3e  unctions..  </p>
a0a0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
a0b0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
a0c0: 46 4f 52 45 49 47 4e 5f 4b 45 59 7d 20 7b 0a 20  FOREIGN_KEY} {. 
a0d0: 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20   If this option 
a0e0: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e  is defined, then
a0f0: 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f   [foreign key co
a100: 6e 73 74 72 61 69 6e 74 5d 20 73 79 6e 74 61 78  nstraint] syntax
a110: 20 69 73 0a 20 20 6e 6f 74 20 72 65 63 6f 67 6e   is.  not recogn
a120: 69 7a 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ized..}..COMPILE
a130: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a140: 4f 4d 49 54 5f 47 45 54 5f 54 41 42 4c 45 7d 20  OMIT_GET_TABLE} 
a150: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
a160: 63 61 75 73 65 73 20 73 75 70 70 6f 72 74 20 66  causes support f
a170: 6f 72 20 5b 73 71 6c 69 74 65 33 5f 67 65 74 5f  or [sqlite3_get_
a180: 74 61 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b  table()] and.  [
a190: 73 71 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62  sqlite3_free_tab
a1a0: 6c 65 28 29 5d 20 74 6f 20 62 65 20 6f 6d 69 74  le()] to be omit
a1b0: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
a1c0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
a1d0: 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 7d 20 7b 0a  MIT_INCRBLOB} {.
a1e0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
a1f0: 75 73 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72  uses support for
a200: 20 5b 73 71 6c 69 74 65 33 5f 62 6c 6f 62 20 7c   [sqlite3_blob |
a210: 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 42 4c 4f   incremental BLO
a220: 42 20 49 2f 4f 5d 0a 20 20 74 6f 20 62 65 20 6f  B I/O].  to be o
a230: 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  mitted..}..COMPI
a240: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
a250: 45 5f 4f 4d 49 54 5f 49 4e 54 45 47 52 49 54 59  E_OMIT_INTEGRITY
a260: 5f 43 48 45 43 4b 7d 20 7b 0a 20 20 54 68 69 73  _CHECK} {.  This
a270: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75   option omits su
a280: 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 69  pport for the [i
a290: 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b 20 70  ntegrity_check p
a2a0: 72 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49  ragma]..}..COMPI
a2b0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
a2c0: 45 5f 4f 4d 49 54 5f 4c 49 4b 45 5f 4f 50 54 49  E_OMIT_LIKE_OPTI
a2d0: 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68  MIZATION} {.  Th
a2e0: 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c  is option disabl
a2f0: 65 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f  es the ability o
a300: 66 20 53 51 4c 69 74 65 20 74 6f 20 75 73 65 20  f SQLite to use 
a310: 69 6e 64 69 63 65 73 20 74 6f 20 68 65 6c 70 0a  indices to help.
a320: 20 20 72 65 73 6f 6c 76 65 20 5b 4c 49 4b 45 5d    resolve [LIKE]
a330: 20 61 6e 64 20 5b 47 4c 4f 42 5d 20 6f 70 65 72   and [GLOB] oper
a340: 61 74 6f 72 73 20 69 6e 20 61 20 57 48 45 52 45  ators in a WHERE
a350: 20 63 6c 61 75 73 65 2e 0a 7d 0a 0a 43 4f 4d 50   clause..}..COMP
a360: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
a370: 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54  TE_OMIT_LOAD_EXT
a380: 45 4e 53 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73  ENSION} {.  This
a390: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68   option omits th
a3a0: 65 20 65 6e 74 69 72 65 20 65 78 74 65 6e 73 69  e entire extensi
a3b0: 6f 6e 20 6c 6f 61 64 69 6e 67 20 6d 65 63 68 61  on loading mecha
a3c0: 6e 69 73 6d 20 66 72 6f 6d 0a 20 20 53 51 4c 69  nism from.  SQLi
a3d0: 74 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20 5b 73  te, including [s
a3e0: 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 6c 6f  qlite3_enable_lo
a3f0: 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20  ad_extension()] 
a400: 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6c  and.  [sqlite3_l
a410: 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 29 5d  oad_extension()]
a420: 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a   interfaces..}..
a430: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
a440: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 43 41  SQLITE_OMIT_LOCA
a450: 4c 54 49 4d 45 7d 20 7b 0a 20 20 54 68 69 73 20  LTIME} {.  This 
a460: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65  option omits the
a470: 20 22 6c 6f 63 61 6c 74 69 6d 65 22 20 6d 6f 64   "localtime" mod
a480: 69 66 69 65 72 20 66 72 6f 6d 20 74 68 65 20 64  ifier from the d
a490: 61 74 65 20 61 6e 64 20 74 69 6d 65 0a 20 20 66  ate and time.  f
a4a0: 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 69 73 20  unctions.  This 
a4b0: 6f 70 74 69 6f 6e 20 69 73 20 73 6f 6d 65 74 69  option is someti
a4c0: 6d 65 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20  mes useful when 
a4d0: 74 72 79 69 6e 67 20 74 6f 20 63 6f 6d 70 69 6c  trying to compil
a4e0: 65 0a 20 20 74 68 65 20 64 61 74 65 20 61 6e 64  e.  the date and
a4f0: 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20   time functions 
a500: 6f 6e 20 61 20 70 6c 61 74 66 6f 72 6d 20 74 68  on a platform th
a510: 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75 70 70  at does not supp
a520: 6f 72 74 20 74 68 65 0a 20 20 63 6f 6e 63 65 70  ort the.  concep
a530: 74 20 6f 66 20 6c 6f 63 61 6c 20 74 69 6d 65 2e  t of local time.
a540: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
a550: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
a560: 4c 4f 4f 4b 41 53 49 44 45 7d 20 7b 0a 20 20 54  LOOKASIDE} {.  T
a570: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
a580: 20 74 68 65 20 5b 6c 6f 6f 6b 61 73 69 64 65 20   the [lookaside 
a590: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
a5a0: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
a5b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
a5c0: 54 5f 4d 45 4d 4f 52 59 44 42 7d 20 7b 0a 20 20  T_MEMORYDB} {.  
a5d0: 57 68 65 6e 20 74 68 69 73 20 69 73 20 64 65 66  When this is def
a5e0: 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72 61 72  ined, the librar
a5f0: 79 20 64 6f 65 73 20 6e 6f 74 20 72 65 73 70 65  y does not respe
a600: 63 74 20 74 68 65 20 73 70 65 63 69 61 6c 20 64  ct the special d
a610: 61 74 61 62 61 73 65 0a 20 20 6e 61 6d 65 20 22  atabase.  name "
a620: 3a 6d 65 6d 6f 72 79 3a 22 20 28 6e 6f 72 6d 61  :memory:" (norma
a630: 6c 6c 79 20 75 73 65 64 20 74 6f 20 63 72 65 61  lly used to crea
a640: 74 65 20 61 6e 20 5b 69 6e 2d 6d 65 6d 6f 72 79  te an [in-memory
a650: 20 64 61 74 61 62 61 73 65 5d 29 2e 20 49 66 20   database]). If 
a660: 0a 20 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73  .  ":memory:" is
a670: 20 70 61 73 73 65 64 20 74 6f 20 5b 73 71 6c 69   passed to [sqli
a680: 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b 73 71  te3_open()], [sq
a690: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 5d 2c  lite3_open16()],
a6a0: 20 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f   or.  [sqlite3_o
a6b0: 70 65 6e 5f 76 32 28 29 5d 2c 20 61 20 66 69 6c  pen_v2()], a fil
a6c0: 65 20 77 69 74 68 20 74 68 69 73 20 6e 61 6d 65  e with this name
a6d0: 20 77 69 6c 6c 20 62 65 20 0a 20 20 6f 70 65 6e   will be .  open
a6e0: 65 64 20 6f 72 20 63 72 65 61 74 65 64 2e 0a 7d  ed or created..}
a6f0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
a700: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52   {SQLITE_OMIT_OR
a710: 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b  _OPTIMIZATION} {
a720: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 64  .  This option d
a730: 69 73 61 62 6c 65 73 20 74 68 65 20 61 62 69 6c  isables the abil
a740: 69 74 79 20 6f 66 20 53 51 4c 69 74 65 20 74 6f  ity of SQLite to
a750: 20 75 73 65 20 61 6e 20 69 6e 64 65 78 20 74 6f   use an index to
a760: 67 65 74 68 65 72 0a 20 20 77 69 74 68 20 74 65  gether.  with te
a770: 72 6d 73 20 6f 66 20 61 20 57 48 45 52 45 20 63  rms of a WHERE c
a780: 6c 61 75 73 65 20 63 6f 6e 6e 65 63 74 65 64 20  lause connected 
a790: 62 79 20 74 68 65 20 4f 52 20 6f 70 65 72 61 74  by the OR operat
a7a0: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
a7b0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a7c0: 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53  IT_PAGER_PRAGMAS
a7d0: 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74  } {.  Defining t
a7e0: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
a7f0: 20 70 72 61 67 6d 61 73 20 72 65 6c 61 74 65 64   pragmas related
a800: 20 74 6f 20 74 68 65 20 70 61 67 65 72 20 73 75   to the pager su
a810: 62 73 79 73 74 65 6d 20 66 72 6f 6d 20 0a 20 20  bsystem from .  
a820: 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f  the build..}..CO
a830: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
a840: 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 41 47 4d 41  LITE_OMIT_PRAGMA
a850: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
a860: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69  n is used to omi
a870: 74 20 74 68 65 20 5b 50 52 41 47 4d 41 5d 20 63  t the [PRAGMA] c
a880: 6f 6d 6d 61 6e 64 0a 20 20 66 72 6f 6d 20 74 68  ommand.  from th
a890: 65 20 6c 69 62 72 61 72 79 2e 20 4e 6f 74 65 20  e library. Note 
a8a0: 74 68 61 74 20 69 74 20 69 73 20 75 73 65 66 75  that it is usefu
a8b0: 6c 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20  l to define the 
a8c0: 6d 61 63 72 6f 73 20 74 68 61 74 20 6f 6d 69 74  macros that omit
a8d0: 0a 20 20 73 70 65 63 69 66 69 63 20 70 72 61 67  .  specific prag
a8e0: 6d 61 73 20 69 6e 20 61 64 64 69 74 69 6f 6e 20  mas in addition 
a8f0: 74 6f 20 74 68 69 73 2c 20 61 73 20 74 68 65 79  to this, as they
a900: 20 6d 61 79 20 61 6c 73 6f 20 72 65 6d 6f 76 65   may also remove
a910: 20 73 75 70 70 6f 72 74 69 6e 67 20 63 6f 64 65   supporting code
a920: 0a 20 20 69 6e 20 6f 74 68 65 72 20 73 75 62 2d  .  in other sub-
a930: 73 79 73 74 65 6d 73 2e 20 54 68 69 73 20 6d 61  systems. This ma
a940: 63 72 6f 20 72 65 6d 6f 76 65 73 20 74 68 65 20  cro removes the 
a950: 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64  [PRAGMA] command
a960: 20 6f 6e 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c   only..}..COMPIL
a970: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a980: 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f 43  _OMIT_PROGRESS_C
a990: 41 4c 4c 42 41 43 4b 7d 20 7b 0a 20 20 54 68 69  ALLBACK} {.  Thi
a9a0: 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 62 65 20  s option may be 
a9b0: 64 65 66 69 6e 65 64 20 74 6f 20 6f 6d 69 74 20  defined to omit 
a9c0: 74 68 65 20 63 61 70 61 62 69 6c 69 74 79 20 74  the capability t
a9d0: 6f 20 69 73 73 75 65 20 22 70 72 6f 67 72 65 73  o issue "progres
a9e0: 73 22 20 0a 20 20 63 61 6c 6c 62 61 63 6b 73 20  s" .  callbacks 
a9f0: 64 75 72 69 6e 67 20 6c 6f 6e 67 2d 72 75 6e 6e  during long-runn
aa00: 69 6e 67 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ing SQL statemen
aa10: 74 73 2e 20 54 68 65 20 0a 20 20 5b 73 71 6c 69  ts. The .  [sqli
aa20: 74 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e  te3_progress_han
aa30: 64 6c 65 72 28 29 5d 0a 20 20 41 50 49 20 66 75  dler()].  API fu
aa40: 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 70 72  nction is not pr
aa50: 65 73 65 6e 74 20 69 6e 20 74 68 65 20 6c 69 62  esent in the lib
aa60: 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  rary..}..COMPILE
aa70: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
aa80: 4f 4d 49 54 5f 51 55 49 43 4b 42 41 4c 41 4e 43  OMIT_QUICKBALANC
aa90: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
aaa0: 6f 6e 20 6f 6d 69 74 73 20 61 6e 20 61 6c 74 65  on omits an alte
aab0: 72 6e 61 74 69 76 65 2c 20 66 61 73 74 65 72 20  rnative, faster 
aac0: 42 2d 54 72 65 65 20 62 61 6c 61 6e 63 69 6e 67  B-Tree balancing
aad0: 20 72 6f 75 74 69 6e 65 2e 0a 20 20 55 73 69 6e   routine..  Usin
aae0: 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61  g this option ma
aaf0: 6b 65 73 20 53 51 4c 69 74 65 20 73 6c 69 67 68  kes SQLite sligh
ab00: 74 6c 79 20 73 6d 61 6c 6c 65 72 20 61 74 20 74  tly smaller at t
ab10: 68 65 20 65 78 70 65 6e 73 65 20 6f 66 0a 20 20  he expense of.  
ab20: 6d 61 6b 69 6e 67 20 69 74 20 72 75 6e 20 73 6c  making it run sl
ab30: 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 2e 0a 7d  ightly slower..}
ab40: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
ab50: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 52 45   {SQLITE_OMIT_RE
ab60: 49 4e 44 45 58 7d 20 7b 0a 20 20 57 68 65 6e 20  INDEX} {.  When 
ab70: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
ab80: 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 52 45 49  efined, the [REI
ab90: 4e 44 45 58 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20  NDEX].  command 
aba0: 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20  is not included 
abb0: 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a  in the library..
abc0: 20 20 45 78 65 63 75 74 69 6e 67 20 61 20 5b 52    Executing a [R
abd0: 45 49 4e 44 45 58 5d 20 73 74 61 74 65 6d 65 6e  EINDEX] statemen
abe0: 74 20 63 61 75 73 65 73 20 0a 20 20 61 20 70 61  t causes .  a pa
abf0: 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  rse error..}..CO
ac00: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
ac10: 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48 45 4d 41  LITE_OMIT_SCHEMA
ac20: 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44 65  _PRAGMAS} {.  De
ac30: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
ac40: 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d 61 73  on omits pragmas
ac50: 20 66 6f 72 20 71 75 65 72 79 69 6e 67 20 74 68   for querying th
ac60: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  e database schem
ac70: 61 20 66 72 6f 6d 20 0a 20 20 74 68 65 20 62 75  a from .  the bu
ac80: 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ild..}..COMPILE_
ac90: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
aca0: 4d 49 54 5f 53 43 48 45 4d 41 5f 56 45 52 53 49  MIT_SCHEMA_VERSI
acb0: 4f 4e 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20  ON_PRAGMAS} {.  
acc0: 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70  Defining this op
acd0: 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d  tion omits pragm
ace0: 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e 67 20  as for querying 
acf0: 61 6e 64 20 6d 6f 64 69 66 79 69 6e 67 20 74 68  and modifying th
ad00: 65 20 0a 20 20 64 61 74 61 62 61 73 65 20 73 63  e .  database sc
ad10: 68 65 6d 61 20 76 65 72 73 69 6f 6e 20 61 6e 64  hema version and
ad20: 20 75 73 65 72 20 76 65 72 73 69 6f 6e 20 66 72   user version fr
ad30: 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 20 53 70  om the build. Sp
ad40: 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 65 20  ecifically, the 
ad50: 0a 20 20 5b 73 63 68 65 6d 61 5f 76 65 72 73 69  .  [schema_versi
ad60: 6f 6e 5d 20 61 6e 64 20 5b 75 73 65 72 5f 76 65  on] and [user_ve
ad70: 72 73 69 6f 6e 5d 20 50 52 41 47 4d 41 73 20 61  rsion] PRAGMAs a
ad80: 72 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43  re omitted..}..C
ad90: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
ada0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45  QLITE_OMIT_SHARE
adb0: 44 5f 43 41 43 48 45 7d 20 7b 0a 20 20 54 68 69  D_CACHE} {.  Thi
adc0: 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c 64 73 20  s option builds 
add0: 53 51 4c 69 74 65 20 77 69 74 68 6f 75 74 20 73  SQLite without s
ade0: 75 70 70 6f 72 74 20 66 6f 72 20 73 68 61 72 65  upport for share
adf0: 64 2d 63 61 63 68 65 20 6d 6f 64 65 2e 0a 20 20  d-cache mode..  
ae00: 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 65 6e 61  The [sqlite3_ena
ae10: 62 6c 65 5f 73 68 61 72 65 64 5f 63 61 63 68 65  ble_shared_cache
ae20: 28 29 5d 20 69 73 20 6f 6d 69 74 74 65 64 20 61  ()] is omitted a
ae30: 6c 6f 6e 67 20 77 69 74 68 20 61 20 66 61 69 72  long with a fair
ae40: 0a 20 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67  .  amount of log
ae50: 69 63 20 77 69 74 68 69 6e 20 74 68 65 20 42 2d  ic within the B-
ae60: 54 72 65 65 20 73 75 62 73 79 73 74 65 6d 20 61  Tree subsystem a
ae70: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 73  ssociated with s
ae80: 68 61 72 65 64 0a 20 20 63 61 63 68 65 20 6d 61  hared.  cache ma
ae90: 6e 61 67 65 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d  nagement..}..COM
aea0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
aeb0: 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 45 52  ITE_OMIT_SUBQUER
aec0: 59 7d 20 7b 0a 20 20 49 66 20 64 65 66 69 6e 65  Y} {.  If define
aed0: 64 2c 20 73 75 70 70 6f 72 74 20 66 6f 72 20 73  d, support for s
aee0: 75 62 2d 73 65 6c 65 63 74 73 20 61 6e 64 20 74  ub-selects and t
aef0: 68 65 20 49 4e 28 29 20 6f 70 65 72 61 74 6f 72  he IN() operator
af00: 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a   are omitted..}.
af10: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
af20: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 43 4c  {SQLITE_OMIT_TCL
af30: 5f 56 41 52 49 41 42 4c 45 7d 20 7b 0a 20 20 49  _VARIABLE} {.  I
af40: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20  f this macro is 
af50: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68  defined, then th
af60: 65 20 73 70 65 63 69 61 6c 20 22 24 3c 76 61 72  e special "$<var
af70: 69 61 62 6c 65 2d 6e 61 6d 65 3e 22 20 73 79 6e  iable-name>" syn
af80: 74 61 78 0a 20 20 75 73 65 64 20 74 6f 20 61 75  tax.  used to au
af90: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 69 6e 64  tomatically bind
afa0: 20 53 51 4c 20 76 61 72 69 61 62 6c 65 73 20 74   SQL variables t
afb0: 6f 20 54 43 4c 20 76 61 72 69 61 62 6c 65 73 20  o TCL variables 
afc0: 69 73 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43  is omitted..}..C
afd0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
afe0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44  QLITE_OMIT_TEMPD
aff0: 42 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  B} {.  This opti
b000: 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74  on omits support
b010: 20 66 6f 72 20 54 45 4d 50 20 6f 72 20 54 45 4d   for TEMP or TEM
b020: 50 4f 52 41 52 59 20 74 61 62 6c 65 73 2e 0a 7d  PORARY tables..}
b030: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
b040: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52   {SQLITE_OMIT_TR
b050: 41 43 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ACE} {.  This op
b060: 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f  tion omits suppo
b070: 72 74 20 66 6f 72 20 74 68 65 20 5b 73 71 6c 69  rt for the [sqli
b080: 74 65 33 5f 70 72 6f 66 69 6c 65 28 29 5d 20 61  te3_profile()] a
b090: 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 72  nd.  [sqlite3_tr
b0a0: 61 63 65 28 29 5d 20 69 6e 74 65 72 66 61 63 65  ace()] interface
b0b0: 73 20 61 6e 64 20 74 68 65 69 72 20 61 73 73 6f  s and their asso
b0c0: 63 69 61 74 65 64 20 6c 6f 67 69 63 2e 0a 7d 0a  ciated logic..}.
b0d0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
b0e0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49  {SQLITE_OMIT_TRI
b0f0: 47 47 45 52 7d 20 7b 0a 20 20 44 65 66 69 6e 69  GGER} {.  Defini
b100: 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f  ng this option o
b110: 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72  mits support for
b120: 20 54 52 49 47 47 45 52 20 6f 62 6a 65 63 74 73   TRIGGER objects
b130: 2e 20 4e 65 69 74 68 65 72 20 74 68 65 20 0a 20  . Neither the . 
b140: 20 5b 43 52 45 41 54 45 20 54 52 49 47 47 45 52   [CREATE TRIGGER
b150: 5d 20 6f 72 20 5b 44 52 4f 50 20 54 52 49 47 47  ] or [DROP TRIGG
b160: 45 52 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61  ER].  commands a
b170: 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20  re available in 
b180: 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64 20 61  this case, and a
b190: 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78 65  ttempting to exe
b1a0: 63 75 74 65 0a 20 20 65 69 74 68 65 72 20 77 69  cute.  either wi
b1b0: 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20 70  ll result in a p
b1c0: 61 72 73 65 20 65 72 72 6f 72 2e 0a 20 20 54 68  arse error..  Th
b1d0: 69 73 20 6f 70 74 69 6f 6e 20 61 6c 73 6f 20 64  is option also d
b1e0: 69 73 61 62 6c 65 73 20 65 6e 66 6f 72 63 65 6d  isables enforcem
b1f0: 65 6e 74 20 6f 66 20 5b 66 6f 72 65 69 67 6e 20  ent of [foreign 
b200: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 5d  key constraints]
b210: 2c 0a 20 20 73 69 6e 63 65 20 74 68 65 20 63 6f  ,.  since the co
b220: 64 65 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e  de that implemen
b230: 74 73 20 74 72 69 67 67 65 72 73 20 61 6e 64 20  ts triggers and 
b240: 77 68 69 63 68 20 69 73 20 6f 6d 69 74 74 65 64  which is omitted
b250: 20 62 79 20 74 68 69 73 0a 20 20 6f 70 74 69 6f   by this.  optio
b260: 6e 20 69 73 20 61 6c 73 6f 20 75 73 65 64 20 74  n is also used t
b270: 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 5b 66 6f 72  o implement [for
b280: 65 69 67 6e 20 6b 65 79 20 61 63 74 69 6f 6e 73  eign key actions
b290: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
b2a0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
b2b0: 54 5f 54 52 55 4e 43 41 54 45 5f 4f 50 54 49 4d  T_TRUNCATE_OPTIM
b2c0: 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 41 20 64  IZATION} {.  A d
b2d0: 65 66 61 75 6c 74 20 62 75 69 6c 64 20 6f 66 20  efault build of 
b2e0: 53 51 4c 69 74 65 2c 20 69 66 20 61 20 5b 44 45  SQLite, if a [DE
b2f0: 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e 74 20  LETE] statement 
b300: 68 61 73 20 6e 6f 20 57 48 45 52 45 20 63 6c 61  has no WHERE cla
b310: 75 73 65 0a 20 20 61 6e 64 20 6f 70 65 72 61 74  use.  and operat
b320: 65 73 20 6f 6e 20 61 20 74 61 62 6c 65 20 77 69  es on a table wi
b330: 74 68 20 6e 6f 20 74 72 69 67 67 65 72 73 2c 20  th no triggers, 
b340: 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  an optimization 
b350: 6f 63 63 75 72 73 20 74 68 61 74 0a 20 20 63 61  occurs that.  ca
b360: 75 73 65 73 20 74 68 65 20 44 45 4c 45 54 45 20  uses the DELETE 
b370: 74 6f 20 6f 63 63 75 72 20 62 79 20 64 72 6f 70  to occur by drop
b380: 70 69 6e 67 20 61 6e 64 20 72 65 63 72 65 61 74  ping and recreat
b390: 69 6e 67 20 74 68 65 20 74 61 62 6c 65 2e 20 20  ing the table.  
b3a0: 0a 20 20 44 72 6f 70 70 69 6e 67 20 61 6e 64 20  .  Dropping and 
b3b0: 72 65 63 72 65 61 74 69 6e 67 20 61 20 74 61 62  recreating a tab
b3c0: 6c 65 20 69 73 20 75 73 75 61 6c 6c 79 20 6d 75  le is usually mu
b3d0: 63 68 20 66 61 73 74 65 72 20 74 68 61 6e 20 64  ch faster than d
b3e0: 65 6c 65 74 69 6e 67 0a 20 20 74 68 65 20 74 61  eleting.  the ta
b3f0: 62 6c 65 20 63 6f 6e 74 65 6e 74 20 72 6f 77 20  ble content row 
b400: 62 79 20 72 6f 77 2e 20 20 54 68 69 73 20 69 73  by row.  This is
b410: 20 74 68 65 20 22 74 72 75 6e 63 61 74 65 20 6f   the "truncate o
b420: 70 74 69 6d 69 7a 61 74 69 6f 6e 22 2e 0a 7d 0a  ptimization"..}.
b430: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
b440: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46  {SQLITE_OMIT_UTF
b450: 31 36 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63  16} {.  This mac
b460: 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d  ro is used to om
b470: 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 55  it support for U
b480: 54 46 31 36 20 74 65 78 74 20 65 6e 63 6f 64 69  TF16 text encodi
b490: 6e 67 2e 20 57 68 65 6e 20 74 68 69 73 20 69 73  ng. When this is
b4a0: 0a 20 20 64 65 66 69 6e 65 64 20 61 6c 6c 20 41  .  defined all A
b4b0: 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61  PI functions tha
b4c0: 74 20 72 65 74 75 72 6e 20 6f 72 20 61 63 63 65  t return or acce
b4d0: 70 74 20 55 54 46 31 36 20 65 6e 63 6f 64 65 64  pt UTF16 encoded
b4e0: 20 74 65 78 74 20 61 72 65 0a 20 20 75 6e 61 76   text are.  unav
b4f0: 61 69 6c 61 62 6c 65 2e 20 54 68 65 73 65 20 66  ailable. These f
b500: 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 62 65 20  unctions can be 
b510: 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68  identified by th
b520: 65 20 66 61 63 74 20 74 68 61 74 20 74 68 65 79  e fact that they
b530: 20 65 6e 64 0a 20 20 77 69 74 68 20 27 31 36 27   end.  with '16'
b540: 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 5b 73  , for example [s
b550: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 31 36  qlite3_prepare16
b560: 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 63 6f  ()], [sqlite3_co
b570: 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 5d 20 61  lumn_text16()] a
b580: 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 69  nd.  [sqlite3_bi
b590: 6e 64 5f 74 65 78 74 31 36 28 29 5d 2e 0a 7d 0a  nd_text16()]..}.
b5a0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
b5b0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43  {SQLITE_OMIT_VAC
b5c0: 55 55 4d 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68  UUM} {.  When th
b5d0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66  is option is def
b5e0: 69 6e 65 64 2c 20 74 68 65 20 5b 56 41 43 55 55  ined, the [VACUU
b5f0: 4d 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 69 73 20  M].  command is 
b600: 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20  not included in 
b610: 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 20 20 45  the library..  E
b620: 78 65 63 75 74 69 6e 67 20 61 20 5b 56 41 43 55  xecuting a [VACU
b630: 55 4d 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61  UM] statement ca
b640: 75 73 65 73 20 0a 20 20 61 20 70 61 72 73 65 20  uses .  a parse 
b650: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
b660: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
b670: 5f 4f 4d 49 54 5f 56 49 45 57 7d 20 7b 0a 20 20  _OMIT_VIEW} {.  
b680: 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70  Defining this op
b690: 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f  tion omits suppo
b6a0: 72 74 20 66 6f 72 20 56 49 45 57 20 6f 62 6a 65  rt for VIEW obje
b6b0: 63 74 73 2e 20 4e 65 69 74 68 65 72 20 74 68 65  cts. Neither the
b6c0: 20 0a 20 20 5b 43 52 45 41 54 45 20 56 49 45 57   .  [CREATE VIEW
b6d0: 5d 20 6e 6f 72 20 74 68 65 20 5b 44 52 4f 50 20  ] nor the [DROP 
b6e0: 56 49 45 57 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73  VIEW].  commands
b6f0: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69   are available i
b700: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64  n this case, and
b710: 0a 20 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f  .  attempting to
b720: 20 65 78 65 63 75 74 65 20 65 69 74 68 65 72 20   execute either 
b730: 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61  will result in a
b740: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20   parse error... 
b750: 20 57 41 52 4e 49 4e 47 3a 20 49 66 20 74 68 69   WARNING: If thi
b760: 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  s macro is defin
b770: 65 64 2c 20 69 74 20 77 69 6c 6c 20 6e 6f 74 20  ed, it will not 
b780: 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6f  be possible to o
b790: 70 65 6e 20 61 20 64 61 74 61 62 61 73 65 0a 20  pen a database. 
b7a0: 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 73   for which the s
b7b0: 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 73 20 56  chema contains V
b7c0: 49 45 57 20 6f 62 6a 65 63 74 73 2e 20 0a 7d 0a  IEW objects. .}.
b7d0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
b7e0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52  {SQLITE_OMIT_VIR
b7f0: 54 55 41 4c 54 41 42 4c 45 7d 20 7b 0a 20 20 54  TUALTABLE} {.  T
b800: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
b810: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65   support for the
b820: 20 5b 73 71 6c 69 74 65 33 5f 76 74 61 62 20 7c   [sqlite3_vtab |
b830: 20 56 69 72 74 75 61 6c 20 54 61 62 6c 65 5d 0a   Virtual Table].
b840: 20 20 6d 65 63 68 61 6e 69 73 6d 20 69 6e 20 53    mechanism in S
b850: 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  QLite..}..COMPIL
b860: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
b870: 5f 4f 4d 49 54 5f 57 41 4c 7d 20 7b 0a 20 20 54  _OMIT_WAL} {.  T
b880: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
b890: 20 74 68 65 20 22 5b 77 72 69 74 65 2d 61 68 65   the "[write-ahe
b8a0: 61 64 20 6c 6f 67 5d 22 20 28 61 2e 6b 2e 61 2e  ad log]" (a.k.a.
b8b0: 20 22 5b 57 41 4c 5d 22 29 20 63 61 70 61 62 69   "[WAL]") capabi
b8c0: 6c 69 74 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  lity..}..COMPILE
b8d0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
b8e0: 4f 4d 49 54 5f 57 53 44 7d 20 7b 0a 20 20 54 68  OMIT_WSD} {.  Th
b8f0: 69 73 20 6f 70 74 69 6f 6e 20 62 75 69 6c 64 73  is option builds
b900: 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68   a version of th
b910: 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79  e SQLite library
b920: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 6e   that contains n
b930: 6f 0a 20 20 57 72 69 74 61 62 6c 65 20 53 74 61  o.  Writable Sta
b940: 74 69 63 20 44 61 74 61 20 28 57 53 44 29 2e 20  tic Data (WSD). 
b950: 20 57 53 44 20 69 73 20 67 6c 6f 62 61 6c 20 76   WSD is global v
b960: 61 72 69 61 62 6c 65 73 20 61 6e 64 2f 6f 72 20  ariables and/or 
b970: 73 74 61 74 69 63 0a 20 20 76 61 72 69 61 62 6c  static.  variabl
b980: 65 73 2e 20 20 53 6f 6d 65 20 70 6c 61 74 66 6f  es.  Some platfo
b990: 72 6d 73 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f  rms do not suppo
b9a0: 72 74 20 57 53 44 2c 20 61 6e 64 20 74 68 69 73  rt WSD, and this
b9b0: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 63 65 73   option is neces
b9c0: 73 61 72 79 0a 20 20 69 6e 20 6f 72 64 65 72 20  sary.  in order 
b9d0: 66 6f 72 20 53 51 4c 69 74 65 20 74 6f 20 77 6f  for SQLite to wo
b9e0: 72 6b 20 74 68 6f 73 65 20 70 6c 61 74 66 6f 72  rk those platfor
b9f0: 6d 73 2e 20 20 0a 0a 20 20 55 6e 6c 69 6b 65 20  ms.  ..  Unlike 
ba00: 6f 74 68 65 72 20 4f 4d 49 54 20 6f 70 74 69 6f  other OMIT optio
ba10: 6e 73 20 77 68 69 63 68 20 6d 61 6b 65 20 74 68  ns which make th
ba20: 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79  e SQLite library
ba30: 20 73 6d 61 6c 6c 65 72 2c 0a 20 20 74 68 69 73   smaller,.  this
ba40: 20 6f 70 74 69 6f 6e 20 61 63 74 75 61 6c 6c 79   option actually
ba50: 20 69 6e 63 72 65 61 73 65 73 20 74 68 65 20 73   increases the s
ba60: 69 7a 65 20 6f 66 20 53 51 4c 69 74 65 20 61 6e  ize of SQLite an
ba70: 64 20 6d 61 6b 65 73 20 69 74 20 72 75 6e 0a 20  d makes it run. 
ba80: 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f 77 65 72   a little slower
ba90: 2e 20 20 4f 6e 6c 79 20 75 73 65 20 74 68 69 73  .  Only use this
baa0: 20 6f 70 74 69 6f 6e 20 69 66 20 53 51 4c 69 74   option if SQLit
bab0: 65 20 69 73 20 62 65 69 6e 67 20 62 75 69 6c 74  e is being built
bac0: 20 66 6f 72 20 61 6e 0a 20 20 65 6d 62 65 64 64   for an.  embedd
bad0: 65 64 20 74 61 72 67 65 74 20 74 68 61 74 20 64  ed target that d
bae0: 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20  oes not support 
baf0: 57 53 44 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  WSD..}..COMPILE_
bb00: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
bb10: 4d 49 54 5f 58 46 45 52 5f 4f 50 54 7d 20 7b 0a  MIT_XFER_OPT} {.
bb20: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
bb30: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  its support for 
bb40: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 74 68  optimizations th
bb50: 61 74 20 68 65 6c 70 20 73 74 61 74 65 6d 65 6e  at help statemen
bb60: 74 73 0a 20 20 6f 66 20 74 68 65 20 66 6f 72 6d  ts.  of the form
bb70: 20 22 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e   "INSERT INTO ..
bb80: 2e 20 53 45 4c 45 43 54 20 2e 2e 2e 22 20 72 75  . SELECT ..." ru
bb90: 6e 20 66 61 73 74 65 72 2e 0a 7d 0a 0a 43 4f 4d  n faster..}..COM
bba0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
bbb0: 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 7d  ITE_ZERO_MALLOC}
bbc0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
bbd0: 20 6f 6d 69 74 73 20 62 6f 74 68 20 74 68 65 20   omits both the 
bbe0: 5b 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79 20  [default memory 
bbf0: 61 6c 6c 6f 63 61 74 6f 72 5d 20 61 6e 64 20 74  allocator] and t
bc00: 68 65 0a 20 20 5b 64 65 62 75 67 67 69 6e 67 20  he.  [debugging 
bc10: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
bc20: 5d 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64  ] from the build
bc30: 20 61 6e 64 20 73 75 62 73 74 69 74 75 74 65 73   and substitutes
bc40: 20 61 20 73 74 75 62 0a 20 20 6d 65 6d 6f 72 79   a stub.  memory
bc50: 20 61 6c 6c 6f 63 61 74 6f 72 20 74 68 61 74 20   allocator that 
bc60: 61 6c 77 61 79 73 20 66 61 69 6c 73 2e 20 20 53  always fails.  S
bc70: 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74 20 72  QLite will not r
bc80: 75 6e 20 77 69 74 68 20 74 68 69 73 0a 20 20 73  un with this.  s
bc90: 74 75 62 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  tub memory alloc
bca0: 61 74 6f 72 20 73 69 6e 63 65 20 69 74 20 77 69  ator since it wi
bcb0: 6c 6c 20 62 65 20 75 6e 61 62 6c 65 20 74 6f 20  ll be unable to 
bcc0: 61 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 2e  allocate memory.
bcd0: 20 20 42 75 74 0a 20 20 74 68 69 73 20 73 74 75    But.  this stu
bce0: 62 20 63 61 6e 20 62 65 20 72 65 70 6c 61 63 65  b can be replace
bcf0: 64 20 61 74 20 73 74 61 72 74 2d 74 69 6d 65 20  d at start-time 
bd00: 75 73 69 6e 67 0a 20 20 5b 73 71 6c 69 74 65 33  using.  [sqlite3
bd10: 5f 63 6f 6e 66 69 67 5d 28 5b 53 51 4c 49 54 45  _config]([SQLITE
bd20: 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 5d 2c  _CONFIG_MALLOC],
bd30: 2e 2e 2e 29 20 6f 72 0a 20 20 5b 73 71 6c 69 74  ...) or.  [sqlit
bd40: 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 51 4c 49  e3_config]([SQLI
bd50: 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 5d 2c  TE_CONFIG_HEAP],
bd60: 2e 2e 2e 29 2e 0a 20 20 53 6f 20 74 68 65 20 6e  ...)..  So the n
bd70: 65 74 20 65 66 66 65 63 74 20 6f 66 20 74 68 69  et effect of thi
bd80: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  s compile-time o
bd90: 70 74 69 6f 6e 20 69 73 20 74 68 61 74 20 69 74  ption is that it
bda0: 20 61 6c 6c 6f 77 73 20 53 51 4c 69 74 65 0a 20   allows SQLite. 
bdb0: 20 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65 64 20   to be compiled 
bdc0: 61 6e 64 20 6c 69 6e 6b 65 64 20 61 67 61 69 6e  and linked again
bdd0: 73 74 20 61 20 73 79 73 74 65 6d 20 6c 69 62 72  st a system libr
bde0: 61 72 79 20 74 68 61 74 20 64 6f 65 73 20 6e 6f  ary that does no
bdf0: 74 20 73 75 70 70 6f 72 74 0a 20 20 6d 61 6c 6c  t support.  mall
be00: 6f 63 28 29 2c 20 66 72 65 65 28 29 2c 20 61 6e  oc(), free(), an
be10: 64 2f 6f 72 20 72 65 61 6c 6c 6f 63 28 29 2e 0a  d/or realloc()..
be20: 7d 0a 0a 3c 2f 74 63 6c 3e 0a 3c 61 20 6e 61 6d  }..</tcl>.<a nam
be30: 65 3d 22 64 65 62 75 67 6f 70 74 69 6f 6e 73 22  e="debugoptions"
be40: 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 37 20 41 6e  ></a>.<h2>1.7 An
be50: 61 6c 79 73 69 73 20 61 6e 64 20 44 65 62 75 67  alysis and Debug
be60: 67 69 6e 67 20 4f 70 74 69 6f 6e 73 3c 2f 68 32  ging Options</h2
be70: 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50 49 4c 45  >.<tcl>..COMPILE
be80: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
be90: 44 45 42 55 47 7d 20 7b 0a 20 20 54 68 65 20 53  DEBUG} {.  The S
bea0: 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64  QLite source cod
beb0: 65 20 63 6f 6e 74 61 69 6e 73 20 6c 69 74 65 72  e contains liter
bec0: 61 6c 6c 79 20 74 68 6f 75 73 61 6e 64 73 20 6f  ally thousands o
bed0: 66 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65  f assert() state
bee0: 6d 65 6e 74 73 0a 20 20 75 73 65 64 20 74 6f 20  ments.  used to 
bef0: 76 65 72 69 66 79 20 69 6e 74 65 72 6e 61 6c 20  verify internal 
bf00: 61 73 73 75 6d 70 74 69 6f 6e 73 20 61 6e 64 20  assumptions and 
bf10: 73 75 62 72 6f 75 74 69 6e 65 20 70 72 65 63 6f  subroutine preco
bf20: 6e 64 69 74 69 6f 6e 73 20 61 6e 64 0a 20 20 70  nditions and.  p
bf30: 6f 73 74 63 6f 6e 64 69 74 69 6f 6e 73 2e 20 20  ostconditions.  
bf40: 54 68 65 73 65 20 61 73 73 65 72 74 28 29 20 73  These assert() s
bf50: 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20 6e 6f  tatements are no
bf60: 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20 6f 66  rmally turned of
bf70: 66 0a 20 20 28 74 68 65 79 20 67 65 6e 65 72 61  f.  (they genera
bf80: 74 65 20 6e 6f 20 63 6f 64 65 29 20 73 69 6e 63  te no code) sinc
bf90: 65 20 74 75 72 6e 69 6e 67 20 74 68 65 6d 20 6f  e turning them o
bfa0: 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74 65 20 72  n makes SQLite r
bfb0: 75 6e 20 61 70 70 72 6f 78 69 6d 61 74 65 6c 79  un approximately
bfc0: 0a 20 20 74 68 72 65 65 20 74 69 6d 65 73 20 73  .  three times s
bfd0: 6c 6f 77 65 72 2e 20 20 42 75 74 20 66 6f 72 20  lower.  But for 
bfe0: 74 65 73 74 69 6e 67 20 61 6e 64 20 61 6e 61 6c  testing and anal
bff0: 79 73 69 73 2c 20 69 74 20 69 73 20 75 73 65 66  ysis, it is usef
c000: 75 6c 20 74 6f 20 74 75 72 6e 0a 20 20 74 68 65  ul to turn.  the
c010: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d   assert() statem
c020: 65 6e 74 73 20 6f 6e 2e 20 20 54 68 65 20 53 51  ents on.  The SQ
c030: 4c 49 54 45 5f 44 45 42 55 47 20 63 6f 6d 70 69  LITE_DEBUG compi
c040: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 64  le-time option d
c050: 6f 65 73 20 74 68 69 73 2e 0a 20 20 53 51 4c 49  oes this..  SQLI
c060: 54 45 5f 44 45 42 55 47 20 61 6c 73 6f 20 74 75  TE_DEBUG also tu
c070: 72 6e 73 20 6f 6e 20 73 6f 6d 65 20 6f 74 68 65  rns on some othe
c080: 72 20 64 65 62 75 67 67 69 6e 67 20 66 65 61 74  r debugging feat
c090: 75 72 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ures..}..COMPILE
c0a0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
c0b0: 4d 45 4d 44 45 42 55 47 7d 20 7b 0a 20 20 54 68  MEMDEBUG} {.  Th
c0c0: 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55  e SQLITE_MEMDEBU
c0d0: 47 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  G option causes 
c0e0: 61 6e 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20  an instrumented 
c0f0: 0a 20 20 5b 64 65 62 75 67 67 69 6e 67 20 6d 65  .  [debugging me
c100: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 0a  mory allocator].
c110: 20 20 74 6f 20 62 65 20 75 73 65 64 20 61 73 20    to be used as 
c120: 74 68 65 20 64 65 66 61 75 6c 74 20 6d 65 6d 6f  the default memo
c130: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 77 69 74  ry allocator wit
c140: 68 69 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65  hin SQLite.  The
c150: 0a 20 20 69 6e 73 74 72 75 6d 65 6e 74 65 64 20  .  instrumented 
c160: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
c170: 20 63 68 65 63 6b 73 20 66 6f 72 20 6d 69 73 75   checks for misu
c180: 73 65 20 6f 66 20 64 79 6e 61 6d 69 63 61 6c 6c  se of dynamicall
c190: 79 20 61 6c 6c 6f 63 61 74 65 64 0a 20 20 6d 65  y allocated.  me
c1a0: 6d 6f 72 79 2e 20 20 45 78 61 6d 70 6c 65 73 20  mory.  Examples 
c1b0: 6f 66 20 6d 69 73 75 73 65 20 69 6e 63 6c 75 64  of misuse includ
c1c0: 65 20 75 73 69 6e 67 20 6d 65 6d 6f 72 79 20 61  e using memory a
c1d0: 66 74 65 72 20 69 74 20 69 73 20 66 72 65 65 64  fter it is freed
c1e0: 2c 0a 20 20 77 72 69 74 69 6e 67 20 6f 66 66 20  ,.  writing off 
c1f0: 74 68 65 20 65 6e 64 73 20 6f 66 20 61 20 6d 65  the ends of a me
c200: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c  mory allocation,
c210: 20 66 72 65 65 69 6e 67 20 6d 65 6d 6f 72 79 20   freeing memory 
c220: 6e 6f 74 20 70 72 65 76 69 6f 75 73 6c 79 0a 20  not previously. 
c230: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74   obtained from t
c240: 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  he memory alloca
c250: 74 6f 72 2c 20 6f 72 20 66 61 69 6c 69 6e 67 20  tor, or failing 
c260: 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 6e 65  to initialize ne
c270: 77 6c 79 0a 20 20 61 6c 6c 6f 63 61 74 65 64 20  wly.  allocated 
c280: 6d 65 6d 6f 72 79 2e 0a 7d 0a 0a 3c 2f 74 63 6c  memory..}..</tcl
c290: 3e 0a                                            >.