Documentation Source Text

Hex Artifact Content
Login

Artifact 545003d048a5be3a7c769f5d28dbb8ef89755357:


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 4d 49 4e 49  ION {SQLITE_MINI
2350: 4d 55 4d 5f 46 49 4c 45 5f 44 45 53 43 52 49 50  MUM_FILE_DESCRIP
2360: 54 4f 52 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a  TOR=<i>N</i>} {.
2370: 20 20 54 68 65 20 75 6e 69 78 20 5b 56 46 53 5d    The unix [VFS]
2380: 20 77 69 6c 6c 20 6e 65 76 65 72 20 75 73 65 20   will never use 
2390: 61 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  a file descripto
23a0: 72 20 6c 65 73 73 20 74 68 61 6e 20 3c 69 3e 4e  r less than <i>N
23b0: 3c 2f 69 3e 2e 20 20 54 68 65 0a 20 20 64 65 66  </i>.  The.  def
23c0: 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 3c 69  ault value of <i
23d0: 3e 4e 3c 2f 69 3e 20 69 73 20 33 2e 0a 20 20 3c  >N</i> is 3..  <
23e0: 70 3e 0a 20 20 41 76 6f 69 64 69 6e 67 20 74 68  p>.  Avoiding th
23f0: 65 20 75 73 65 20 6f 66 20 6c 6f 77 2d 6e 75 6d  e use of low-num
2400: 62 65 72 65 64 20 66 69 6c 65 20 64 65 73 63 72  bered file descr
2410: 69 70 74 6f 72 73 20 69 73 20 61 20 64 65 66 65  iptors is a defe
2420: 6e 73 65 20 61 67 61 69 6e 73 74 0a 20 20 61 63  nse against.  ac
2430: 63 69 64 65 6e 74 61 6c 20 64 61 74 61 62 61 73  cidental databas
2440: 65 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 49  e corruption.  I
2450: 66 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c  f a database fil
2460: 65 20 77 61 73 20 6f 70 65 6e 65 64 20 75 73 69  e was opened usi
2470: 6e 67 0a 20 20 66 69 6c 65 20 64 65 73 63 72 69  ng.  file descri
2480: 70 74 6f 72 20 32 2c 20 66 6f 72 20 65 78 61 6d  ptor 2, for exam
2490: 70 6c 65 2c 20 61 6e 64 20 74 68 65 6e 20 61 6e  ple, and then an
24a0: 20 61 73 73 65 72 74 28 29 20 66 61 69 6c 65 64   assert() failed
24b0: 20 61 6e 64 20 69 6e 76 6f 6b 65 64 0a 20 20 77   and invoked.  w
24c0: 72 69 74 65 28 32 2c 2e 2e 2e 29 2c 20 74 68 61  rite(2,...), tha
24d0: 74 20 77 6f 75 6c 64 20 6c 69 6b 65 6c 79 20 63  t would likely c
24e0: 61 75 73 65 20 64 61 74 61 62 61 73 65 20 63 6f  ause database co
24f0: 72 72 75 70 74 69 6f 6e 20 62 79 20 6f 76 65 72  rruption by over
2500: 77 72 69 74 69 6e 67 0a 20 20 70 61 72 74 20 6f  writing.  part o
2510: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
2520: 69 6c 65 20 77 69 74 68 20 74 68 65 20 61 73 73  ile with the ass
2530: 65 72 74 69 6f 6e 20 65 72 72 6f 72 20 6d 65 73  ertion error mes
2540: 73 61 67 65 2e 20 20 55 73 69 6e 67 20 6f 6e 6c  sage.  Using onl
2550: 79 0a 20 20 68 69 67 68 65 72 2d 76 61 6c 75 65  y.  higher-value
2560: 64 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  d file descripto
2570: 72 73 20 61 76 6f 69 64 73 20 74 68 69 73 20 70  rs avoids this p
2580: 6f 74 65 6e 74 69 61 6c 20 70 72 6f 62 6c 65 6d  otential problem
2590: 2e 20 20 54 68 65 20 0a 20 20 70 72 6f 74 65 63  .  The .  protec
25a0: 74 69 6f 6e 20 61 67 61 69 6e 73 74 0a 20 20 75  tion against.  u
25b0: 73 69 6e 67 20 6c 6f 77 2d 6e 75 6d 62 65 72 65  sing low-numbere
25c0: 64 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  d file descripto
25d0: 72 73 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c  rs can be disabl
25e0: 65 64 20 62 79 20 73 65 74 74 69 6e 67 20 74 68  ed by setting th
25f0: 69 73 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  is.  compile-tim
2600: 65 20 6f 70 74 69 6f 6e 20 74 6f 20 30 2e 0a 7d  e option to 0..}
2610: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
2620: 20 7b 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41   {SQLITE_POWERSA
2630: 46 45 5f 4f 56 45 52 57 52 49 54 45 3d 3c 69 3e  FE_OVERWRITE=<i>
2640: 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f  &lt;0 or 1&gt;</
2650: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  i>} {.  This opt
2660: 69 6f 6e 20 63 68 61 6e 67 65 73 20 74 68 65 20  ion changes the 
2670: 64 65 66 61 75 6c 74 20 61 73 73 75 6d 70 74 69  default assumpti
2680: 6f 6e 20 61 62 6f 75 74 20 5b 70 6f 77 65 72 73  on about [powers
2690: 61 66 65 20 6f 76 65 72 77 72 69 74 65 5d 0a 20  afe overwrite]. 
26a0: 20 66 6f 72 20 74 68 65 20 75 6e 64 65 72 6c 79   for the underly
26b0: 69 6e 67 20 66 69 6c 65 73 79 73 74 65 6d 73 20  ing filesystems 
26c0: 66 6f 72 20 74 68 65 20 75 6e 69 78 20 61 6e 64  for the unix and
26d0: 20 77 69 6e 64 6f 77 73 20 5b 56 46 53 65 73 5d   windows [VFSes]
26e0: 2e 0a 20 20 53 65 74 74 69 6e 67 20 53 51 4c 49  ..  Setting SQLI
26f0: 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45  TE_POWERSAFE_OVE
2700: 52 57 52 49 54 45 20 74 6f 20 31 20 63 61 75 73  RWRITE to 1 caus
2710: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 61 73 73  es SQLite to ass
2720: 75 6d 65 20 74 68 61 74 0a 20 20 61 70 70 6c 69  ume that.  appli
2730: 63 61 74 69 6f 6e 2d 6c 65 76 65 6c 20 77 72 69  cation-level wri
2740: 74 65 73 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67  tes cannot chang
2750: 65 73 20 62 79 74 65 73 20 6f 75 74 73 69 64 65  es bytes outside
2760: 20 74 68 65 20 72 61 6e 67 65 20 6f 66 0a 20 20   the range of.  
2770: 62 79 74 65 73 20 77 72 69 74 74 65 6e 20 65 76  bytes written ev
2780: 65 6e 20 69 66 20 74 68 65 20 77 72 69 74 65 20  en if the write 
2790: 6f 63 63 75 72 73 20 6a 75 73 74 20 62 65 66 6f  occurs just befo
27a0: 72 65 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 2e  re a power loss.
27b0: 0a 20 20 57 69 74 68 20 53 51 4c 49 54 45 5f 50  .  With SQLITE_P
27c0: 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49  OWERSAFE_OVERWRI
27d0: 54 45 20 73 65 74 20 74 6f 20 30 2c 20 53 51 4c  TE set to 0, SQL
27e0: 69 74 65 20 61 73 73 75 6d 65 73 20 74 68 61 74  ite assumes that
27f0: 20 6f 74 68 65 72 0a 20 20 62 79 74 65 73 20 69   other.  bytes i
2800: 6e 20 74 68 65 20 73 61 6d 65 20 73 65 63 74 6f  n the same secto
2810: 72 20 77 69 74 68 20 61 20 77 72 69 74 74 65 6e  r with a written
2820: 20 62 79 74 65 20 6d 69 67 68 74 20 62 65 20 63   byte might be c
2830: 68 61 6e 67 65 64 20 6f 72 20 0a 20 20 64 61 6d  hanged or .  dam
2840: 61 67 65 64 20 62 79 20 61 20 70 6f 77 65 72 20  aged by a power 
2850: 6c 6f 73 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  loss..}..COMPILE
2860: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
2870: 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a  WIN32_MALLOC} {.
2880: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e    This option en
2890: 61 62 6c 65 73 20 74 68 65 20 75 73 65 20 6f 66  ables the use of
28a0: 20 74 68 65 20 57 69 6e 64 6f 77 73 20 48 65 61   the Windows Hea
28b0: 70 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20  p API functions 
28c0: 66 6f 72 20 6d 65 6d 6f 72 79 0a 20 20 61 6c 6c  for memory.  all
28d0: 6f 63 61 74 69 6f 6e 20 69 6e 73 74 65 61 64 20  ocation instead 
28e0: 6f 66 20 74 68 65 20 73 74 61 6e 64 61 72 64 20  of the standard 
28f0: 6c 69 62 72 61 72 79 20 6d 61 6c 6c 6f 63 28 29  library malloc()
2900: 20 61 6e 64 20 66 72 65 65 28 29 20 72 6f 75 74   and free() rout
2910: 69 6e 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ines..}..COMPILE
2920: 5f 4f 50 54 49 4f 4e 20 7b 59 59 53 54 41 43 4b  _OPTION {YYSTACK
2930: 44 45 50 54 48 3d 3c 69 3e 26 6c 74 3b 6d 61 78  DEPTH=<i>&lt;max
2940: 5f 64 65 70 74 68 26 67 74 3b 3c 2f 69 3e 7d 20  _depth&gt;</i>} 
2950: 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73  {.  This macro s
2960: 65 74 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  ets the maximum 
2970: 64 65 70 74 68 20 6f 66 20 74 68 65 20 4c 41 4c  depth of the LAL
2980: 52 28 31 29 20 73 74 61 63 6b 20 75 73 65 64 20  R(1) stack used 
2990: 62 79 0a 20 20 74 68 65 20 53 51 4c 20 70 61 72  by.  the SQL par
29a0: 73 65 72 20 77 69 74 68 69 6e 20 53 51 4c 69 74  ser within SQLit
29b0: 65 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20  e.  The default 
29c0: 76 61 6c 75 65 20 69 73 20 31 30 30 2e 20 20 41  value is 100.  A
29d0: 20 74 79 70 69 63 61 6c 0a 20 20 61 70 70 6c 69   typical.  appli
29e0: 63 61 74 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20  cation will use 
29f0: 6c 65 73 73 20 74 68 61 6e 20 61 62 6f 75 74 20  less than about 
2a00: 32 30 20 6c 65 76 65 6c 73 20 6f 66 20 74 68 65  20 levels of the
2a10: 20 73 74 61 63 6b 2e 0a 20 20 44 65 76 65 6c 6f   stack..  Develo
2a20: 70 65 72 73 20 77 68 6f 73 65 20 61 70 70 6c 69  pers whose appli
2a30: 63 61 74 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 20  cations contain 
2a40: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 74  SQL statements t
2a50: 68 61 74 20 0a 20 20 6e 65 65 64 20 6d 6f 72 65  hat .  need more
2a60: 20 74 68 61 6e 20 31 30 30 20 4c 41 4c 52 28 31   than 100 LALR(1
2a70: 29 20 73 74 61 63 6b 20 65 6e 74 72 69 65 73 20  ) stack entries 
2a80: 73 68 6f 75 6c 64 20 73 65 72 69 6f 75 73 6c 79  should seriously
2a90: 0a 20 20 63 6f 6e 73 69 64 65 72 20 72 65 66 61  .  consider refa
2aa0: 63 74 6f 72 69 6e 67 20 74 68 65 69 72 20 53 51  ctoring their SQ
2ab0: 4c 20 61 73 20 69 74 20 69 73 20 6c 69 6b 65 6c  L as it is likel
2ac0: 79 20 74 6f 20 62 65 20 77 65 6c 6c 20 62 65 79  y to be well bey
2ad0: 6f 6e 64 0a 20 20 74 68 65 20 61 62 69 6c 69 74  ond.  the abilit
2ae0: 79 20 6f 66 20 61 6e 79 20 68 75 6d 61 6e 20 74  y of any human t
2af0: 6f 20 63 6f 6d 70 72 65 68 65 6e 64 2e 0a 7d 0a  o comprehend..}.
2b00: 3c 2f 74 63 6c 3e 0a 0a 3c 68 32 3e 31 2e 32 20  </tcl>..<h2>1.2 
2b10: 4f 70 74 69 6f 6e 73 20 54 6f 20 53 65 74 20 53  Options To Set S
2b20: 69 7a 65 20 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a  ize Limits</h2>.
2b30: 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20 63 6f  .<p>There are co
2b40: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
2b50: 6e 73 20 74 68 61 74 20 77 69 6c 6c 20 73 65 74  ns that will set
2b60: 20 75 70 70 65 72 20 62 6f 75 6e 64 73 0a 6f 6e   upper bounds.on
2b70: 20 74 68 65 20 73 69 7a 65 73 20 6f 66 20 76 61   the sizes of va
2b80: 72 69 6f 75 73 20 73 74 72 75 63 74 75 72 65 73  rious structures
2b90: 20 69 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65   in SQLite.  The
2ba0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70   compile-time.op
2bb0: 74 69 6f 6e 73 20 6e 6f 72 6d 61 6c 6c 79 20 73  tions normally s
2bc0: 65 74 20 61 20 68 61 72 64 20 75 70 70 65 72 20  et a hard upper 
2bd0: 62 6f 75 6e 64 20 74 68 61 74 20 63 61 6e 20 62  bound that can b
2be0: 65 20 63 68 61 6e 67 65 64 0a 61 74 20 72 75 6e  e changed.at run
2bf0: 2d 74 69 6d 65 20 6f 6e 20 69 6e 64 69 76 69 64  -time on individ
2c00: 75 61 6c 20 5b 64 61 74 61 62 61 73 65 20 63 6f  ual [database co
2c10: 6e 6e 65 63 74 69 6f 6e 73 5d 20 75 73 69 6e 67  nnections] using
2c20: 20 74 68 65 0a 5b 73 71 6c 69 74 65 33 5f 6c 69   the.[sqlite3_li
2c30: 6d 69 74 28 29 5d 20 69 6e 74 65 72 66 61 63 65  mit()] interface
2c40: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f  .</p>..<p>The co
2c50: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
2c60: 6e 73 20 66 6f 72 20 73 65 74 74 69 6e 67 20 75  ns for setting u
2c70: 70 70 65 72 20 62 6f 75 6e 64 73 20 61 72 65 0a  pper bounds are.
2c80: 5b 6c 69 6d 69 74 73 20 7c 20 64 6f 63 75 6d 65  [limits | docume
2c90: 6e 74 65 64 20 73 65 70 61 72 61 74 65 6c 79 5d  nted separately]
2ca0: 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  .  The following
2cb0: 20 69 73 20 61 20 6c 69 73 74 20 6f 66 0a 74 68   is a list of.th
2cc0: 65 20 61 76 61 69 6c 61 62 6c 65 20 73 65 74 74  e available sett
2cd0: 69 6e 67 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a  ings:</p>..<ul>.
2ce0: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
2cf0: 5f 41 54 54 41 43 48 45 44 5d 20 20 3c 2f 6c 69  _ATTACHED]  </li
2d00: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
2d10: 41 58 5f 43 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69  AX_COLUMN]  </li
2d20: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
2d30: 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45  AX_COMPOUND_SELE
2d40: 43 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20  CT]  </li>.<li> 
2d50: 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52  [SQLITE_MAX_EXPR
2d60: 5f 44 45 50 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c  _DEPTH]  </li>.<
2d70: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f  li> [SQLITE_MAX_
2d80: 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d 20 20 3c  FUNCTION_ARG]  <
2d90: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
2da0: 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 5d 20 20 3c  E_MAX_LENGTH]  <
2db0: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
2dc0: 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45  E_MAX_LIKE_PATTE
2dd0: 52 4e 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69  RN_LENGTH]  </li
2de0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
2df0: 41 58 5f 50 41 47 45 5f 43 4f 55 4e 54 5d 20 20  AX_PAGE_COUNT]  
2e00: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49  </li>.<li> [SQLI
2e10: 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47 54  TE_MAX_SQL_LENGT
2e20: 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b  H]  </li>.<li> [
2e30: 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41  SQLITE_MAX_VARIA
2e40: 42 4c 45 5f 4e 55 4d 42 45 52 5d 20 20 3c 2f 6c  BLE_NUMBER]  </l
2e50: 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 61 20 6e 61 6d  i>.</ul>..<a nam
2e60: 65 3d 22 63 6f 6e 74 72 6f 6c 66 65 61 74 75 72  e="controlfeatur
2e70: 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 33  es"></a>.<h2>1.3
2e80: 20 4f 70 74 69 6f 6e 73 20 54 6f 20 43 6f 6e 74   Options To Cont
2e90: 72 6f 6c 20 4f 70 65 72 61 74 69 6e 67 20 43 68  rol Operating Ch
2ea0: 61 72 61 63 74 65 72 69 73 74 69 63 73 3c 2f 68  aracteristics</h
2eb0: 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c  2>..<tcl>.COMPIL
2ec0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
2ed0: 5f 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f  _4_BYTE_ALIGNED_
2ee0: 4d 41 4c 4c 4f 43 7d 20 7b 0a 20 20 4f 6e 20 6d  MALLOC} {.  On m
2ef0: 6f 73 74 20 73 79 73 74 65 6d 73 2c 20 74 68 65  ost systems, the
2f00: 20 6d 61 6c 6c 6f 63 28 29 20 73 79 73 74 65 6d   malloc() system
2f10: 20 63 61 6c 6c 20 72 65 74 75 72 6e 73 20 61 20   call returns a 
2f20: 62 75 66 66 65 72 20 74 68 61 74 20 69 73 0a 20  buffer that is. 
2f30: 20 61 6c 69 67 6e 65 64 20 74 6f 20 61 6e 20 38   aligned to an 8
2f40: 2d 62 79 74 65 20 62 6f 75 6e 64 61 72 79 2e 20  -byte boundary. 
2f50: 20 42 75 74 20 6f 6e 20 73 6f 6d 65 20 73 79 73   But on some sys
2f60: 74 65 6d 73 20 28 65 78 3a 20 77 69 6e 64 6f 77  tems (ex: window
2f70: 73 29 20 6d 61 6c 6c 6f 63 28 29 0a 20 20 72 65  s) malloc().  re
2f80: 74 75 72 6e 73 20 34 2d 62 79 74 65 20 61 6c 69  turns 4-byte ali
2f90: 67 6e 65 64 20 70 6f 69 6e 74 65 72 2e 20 20 54  gned pointer.  T
2fa0: 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  his compile-time
2fb0: 20 6f 70 74 69 6f 6e 20 6d 75 73 74 20 62 65 20   option must be 
2fc0: 75 73 65 64 0a 20 20 6f 6e 20 73 79 73 74 65 6d  used.  on system
2fd0: 73 20 74 68 61 74 20 72 65 74 75 72 6e 20 34 2d  s that return 4-
2fe0: 62 79 74 65 20 61 6c 69 67 6e 65 64 20 70 6f 69  byte aligned poi
2ff0: 6e 74 65 72 73 20 66 72 6f 6d 20 6d 61 6c 6c 6f  nters from mallo
3000: 63 28 29 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  c()..}..COMPILE_
3010: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 43  OPTION {SQLITE_C
3020: 41 53 45 5f 53 45 4e 53 49 54 49 56 45 5f 4c 49  ASE_SENSITIVE_LI
3030: 4b 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  KE} {.  If this 
3040: 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e  option is presen
3050: 74 2c 20 74 68 65 6e 20 74 68 65 20 62 75 69 6c  t, then the buil
3060: 74 2d 69 6e 20 5b 4c 49 4b 45 5d 20 6f 70 65 72  t-in [LIKE] oper
3070: 61 74 6f 72 20 77 69 6c 6c 20 62 65 0a 20 20 63  ator will be.  c
3080: 61 73 65 20 73 65 6e 73 69 74 69 76 65 2e 20 20  ase sensitive.  
3090: 54 68 69 73 20 73 61 6d 65 20 65 66 66 65 63 74  This same effect
30a0: 20 63 61 6e 20 62 65 20 61 63 68 69 65 76 65 64   can be achieved
30b0: 20 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69   at run-time usi
30c0: 6e 67 0a 20 20 74 68 65 20 5b 63 61 73 65 5f 73  ng.  the [case_s
30d0: 65 6e 73 69 74 69 76 65 5f 6c 69 6b 65 20 70 72  ensitive_like pr
30e0: 61 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  agma]..}..COMPIL
30f0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
3100: 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57  _DIRECT_OVERFLOW
3110: 5f 52 45 41 44 7d 20 7b 0a 20 20 57 68 65 6e 20  _READ} {.  When 
3120: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 70  this option is p
3130: 72 65 73 65 6e 74 2c 20 63 6f 6e 74 65 6e 74 20  resent, content 
3140: 63 6f 6e 74 61 69 6e 65 64 20 69 6e 0a 20 20 5b  contained in.  [
3150: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 5d 20  overflow pages] 
3160: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  of the database 
3170: 66 69 6c 65 20 69 73 20 72 65 61 64 20 64 69 72  file is read dir
3180: 65 63 74 6c 79 20 66 72 6f 6d 20 64 69 73 6b 2c  ectly from disk,
3190: 0a 20 20 62 79 70 61 73 73 69 6e 67 20 74 68 65  .  bypassing the
31a0: 20 5b 70 61 67 65 20 63 61 63 68 65 5d 2c 20 64   [page cache], d
31b0: 75 72 69 6e 67 20 72 65 61 64 20 74 72 61 6e 73  uring read trans
31c0: 61 63 74 69 6f 6e 73 2e 20 20 49 6e 20 61 70 70  actions.  In app
31d0: 6c 69 63 61 74 69 6f 6e 73 0a 20 20 74 68 61 74  lications.  that
31e0: 20 64 6f 20 61 20 6c 6f 74 20 6f 66 20 72 65 61   do a lot of rea
31f0: 64 73 20 6f 66 20 6c 61 72 67 65 20 42 4c 4f 42  ds of large BLOB
3200: 73 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d  s, this option m
3210: 69 67 68 74 20 69 6d 70 72 6f 76 65 20 72 65 61  ight improve rea
3220: 64 0a 20 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e  d.  performance.
3230: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
3240: 4f 4e 20 7b 53 51 4c 49 54 45 5f 48 41 56 45 5f  ON {SQLITE_HAVE_
3250: 49 53 4e 41 4e 7d 20 7b 0a 20 20 49 66 20 74 68  ISNAN} {.  If th
3260: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 70 72 65  is option is pre
3270: 73 65 6e 74 2c 20 74 68 65 6e 20 53 51 4c 69 74  sent, then SQLit
3280: 65 20 77 69 6c 6c 20 75 73 65 20 74 68 65 20 69  e will use the i
3290: 73 6e 61 6e 28 29 20 66 75 6e 63 74 69 6f 6e 20  snan() function 
32a0: 66 72 6f 6d 0a 20 20 74 68 65 20 73 79 73 74 65  from.  the syste
32b0: 6d 20 6d 61 74 68 20 6c 69 62 72 61 72 79 2e 20  m math library. 
32c0: 20 57 69 74 68 6f 75 74 20 74 68 69 73 20 6f 70   Without this op
32d0: 74 69 6f 6e 20 28 74 68 65 20 64 65 66 61 75 6c  tion (the defaul
32e0: 74 20 62 65 68 61 76 69 6f 72 29 0a 20 20 53 51  t behavior).  SQ
32f0: 4c 69 74 65 20 75 73 65 73 20 69 74 73 20 6f 77  Lite uses its ow
3300: 6e 20 69 6e 74 65 72 6e 61 6c 20 69 6d 70 6c 65  n internal imple
3310: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 69 73 6e  mentation of isn
3320: 61 6e 28 29 2e 20 20 53 51 4c 69 74 65 20 75 73  an().  SQLite us
3330: 65 73 0a 20 20 69 74 73 20 6f 77 6e 20 69 6e 74  es.  its own int
3340: 65 72 6e 61 6c 20 69 73 6e 61 6e 28 29 20 69 6d  ernal isnan() im
3350: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 62 79 20  plementation by 
3360: 64 65 66 61 75 6c 74 20 62 65 63 61 75 73 65 20  default because 
3370: 6f 66 20 70 61 73 74 0a 20 20 70 72 6f 62 6c 65  of past.  proble
3380: 6d 73 20 77 69 74 68 20 73 79 73 74 65 6d 20 69  ms with system i
3390: 73 6e 61 6e 28 29 20 66 75 6e 63 74 69 6f 6e 73  snan() functions
33a0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
33b0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 53 5f 4f  ION {SQLITE_OS_O
33c0: 54 48 45 52 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72  THER=<i>&lt;0 or
33d0: 20 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20   1&gt;</i>} {.  
33e0: 54 68 65 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  The option cause
33f0: 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74  s SQLite to omit
3400: 20 69 74 73 20 62 75 69 6c 74 2d 69 6e 20 6f 70   its built-in op
3410: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69  erating system i
3420: 6e 74 65 72 66 61 63 65 73 0a 20 20 66 6f 72 20  nterfaces.  for 
3430: 55 6e 69 78 2c 20 57 69 6e 64 6f 77 73 2c 20 61  Unix, Windows, a
3440: 6e 64 20 4f 53 2f 32 2e 20 20 54 68 65 20 72 65  nd OS/2.  The re
3450: 73 75 6c 74 69 6e 67 20 6c 69 62 72 61 72 79 20  sulting library 
3460: 77 69 6c 6c 20 68 61 76 65 20 6e 6f 20 64 65 66  will have no def
3470: 61 75 6c 74 0a 20 20 5b 73 71 6c 69 74 65 33 5f  ault.  [sqlite3_
3480: 76 66 73 20 7c 20 6f 70 65 72 61 74 69 6e 67 20  vfs | operating 
3490: 73 79 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65  system interface
34a0: 5d 2e 20 20 41 70 70 6c 69 63 61 74 69 6f 6e 73  ].  Applications
34b0: 20 6d 75 73 74 20 75 73 65 0a 20 20 5b 73 71 6c   must use.  [sql
34c0: 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 65  ite3_vfs_registe
34d0: 72 28 29 5d 20 74 6f 20 72 65 67 69 73 74 65 72  r()] to register
34e0: 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20   an appropriate 
34f0: 69 6e 74 65 72 66 61 63 65 20 62 65 66 6f 72 65  interface before
3500: 0a 20 20 75 73 69 6e 67 20 53 51 4c 69 74 65 2e  .  using SQLite.
3510: 20 20 41 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d    Applications m
3520: 75 73 74 20 61 6c 73 6f 20 73 75 70 70 6c 79 20  ust also supply 
3530: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20  implementations 
3540: 66 6f 72 20 74 68 65 0a 20 20 5b 73 71 6c 69 74  for the.  [sqlit
3550: 65 33 5f 6f 73 5f 69 6e 69 74 28 29 5d 20 61 6e  e3_os_init()] an
3560: 64 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e  d [sqlite3_os_en
3570: 64 28 29 5d 20 69 6e 74 65 72 66 61 63 65 73 2e  d()] interfaces.
3580: 20 20 54 68 65 20 75 73 75 61 6c 20 70 72 61 63    The usual prac
3590: 74 69 63 65 0a 20 20 69 73 20 66 6f 72 20 74 68  tice.  is for th
35a0: 65 20 73 75 70 70 6c 69 65 64 20 5b 73 71 6c 69  e supplied [sqli
35b0: 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29 5d 20 74  te3_os_init()] t
35c0: 6f 20 69 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65  o invoke [sqlite
35d0: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29  3_vfs_register()
35e0: 5d 2e 0a 20 20 53 51 4c 69 74 65 20 77 69 6c 6c  ]..  SQLite will
35f0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69   automatically i
3600: 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 6f  nvoke [sqlite3_o
3610: 73 5f 69 6e 69 74 28 29 5d 20 77 68 65 6e 20 69  s_init()] when i
3620: 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 2e 0a 0a  t initializes...
3630: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73    This option is
3640: 20 74 79 70 69 63 61 6c 6c 79 20 75 73 65 64 20   typically used 
3650: 77 68 65 6e 20 62 75 69 6c 64 69 6e 67 20 53 51  when building SQ
3660: 4c 69 74 65 20 66 6f 72 20 61 6e 20 65 6d 62 65  Lite for an embe
3670: 64 64 65 64 0a 20 20 70 6c 61 74 66 6f 72 6d 20  dded.  platform 
3680: 77 69 74 68 20 61 20 63 75 73 74 6f 6d 20 6f 70  with a custom op
3690: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 2e 0a  erating system..
36a0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
36b0: 4e 20 7b 53 51 4c 49 54 45 5f 53 45 43 55 52 45  N {SQLITE_SECURE
36c0: 5f 44 45 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69  _DELETE} {.  Thi
36d0: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  s compile-time o
36e0: 70 74 69 6f 6e 20 63 68 61 6e 67 65 73 20 74 68  ption changes th
36f0: 65 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e  e default settin
3700: 67 20 6f 66 20 74 68 65 0a 20 20 5b 73 65 63 75  g of the.  [secu
3710: 72 65 5f 64 65 6c 65 74 65 20 70 72 61 67 6d 61  re_delete pragma
3720: 5d 2e 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  ].  When this op
3730: 74 69 6f 6e 20 69 73 20 6e 6f 74 20 75 73 65 64  tion is not used
3740: 2c 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20  , secure_delete 
3750: 64 65 66 61 75 6c 74 73 0a 20 20 74 6f 20 6f 66  defaults.  to of
3760: 66 2e 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  f.  When this op
3770: 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e 74 2c  tion is present,
3780: 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20 64   secure_delete d
3790: 65 66 61 75 6c 74 73 20 74 6f 20 6f 6e 2e 0a 0a  efaults to on...
37a0: 20 20 54 68 65 20 73 65 63 75 72 65 5f 64 65 6c    The secure_del
37b0: 65 74 65 20 73 65 74 74 69 6e 67 20 63 61 75 73  ete setting caus
37c0: 65 73 20 64 65 6c 65 74 65 64 20 63 6f 6e 74 65  es deleted conte
37d0: 6e 74 20 74 6f 20 62 65 20 6f 76 65 72 77 72 69  nt to be overwri
37e0: 74 74 65 6e 20 77 69 74 68 0a 20 20 7a 65 72 6f  tten with.  zero
37f0: 73 2e 20 20 54 68 65 72 65 20 69 73 20 61 20 73  s.  There is a s
3800: 6d 61 6c 6c 20 70 65 72 66 6f 72 6d 61 6e 63 65  mall performance
3810: 20 70 65 6e 61 6c 74 79 20 66 6f 72 20 74 68 69   penalty for thi
3820: 73 20 73 69 6e 63 65 20 61 64 64 69 74 69 6f 6e  s since addition
3830: 61 6c 20 49 2f 4f 0a 20 20 6d 75 73 74 20 6f 63  al I/O.  must oc
3840: 63 75 72 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68  cur.  On the oth
3850: 65 72 20 68 61 6e 64 2c 20 73 65 63 75 72 65 5f  er hand, secure_
3860: 64 65 6c 65 74 65 20 63 61 6e 20 70 72 65 76 65  delete can preve
3870: 6e 74 20 73 65 6e 73 69 74 69 76 65 20 0a 20 20  nt sensitive .  
3880: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d  information from
3890: 20 6c 69 6e 67 65 72 69 6e 67 20 69 6e 20 75 6e   lingering in un
38a0: 75 73 65 64 20 70 61 72 74 73 20 6f 66 20 74 68  used parts of th
38b0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
38c0: 61 66 74 65 72 20 69 74 0a 20 20 68 61 73 20 61  after it.  has a
38d0: 6c 6c 65 67 65 64 6c 79 20 62 65 65 6e 20 64 65  llegedly been de
38e0: 6c 65 74 65 64 2e 20 20 53 65 65 20 74 68 65 20  leted.  See the 
38f0: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 6e  documentation on
3900: 20 74 68 65 0a 20 20 5b 73 65 63 75 72 65 5f 64   the.  [secure_d
3910: 65 6c 65 74 65 20 70 72 61 67 6d 61 5d 20 66 6f  elete pragma] fo
3920: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
3930: 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a 0a 43 4f 4d  ormation..}..COM
3940: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
3950: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3c  ITE_THREADSAFE=<
3960: 69 3e 26 6c 74 3b 30 20 6f 72 20 31 20 6f 72 20  i>&lt;0 or 1 or 
3970: 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  2&gt;</i>} {.  T
3980: 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72  his option contr
3990: 6f 6c 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e  ols whether or n
39a0: 6f 74 20 63 6f 64 65 20 69 73 20 69 6e 63 6c 75  ot code is inclu
39b0: 64 65 64 20 69 6e 20 53 51 4c 69 74 65 20 74 6f  ded in SQLite to
39c0: 0a 20 20 65 6e 61 62 6c 65 20 69 74 20 74 6f 20  .  enable it to 
39d0: 6f 70 65 72 61 74 65 20 73 61 66 65 6c 79 20 69  operate safely i
39e0: 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 65  n a multithreade
39f0: 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20  d environment.  
3a00: 54 68 65 0a 20 20 64 65 66 61 75 6c 74 20 69 73  The.  default is
3a10: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
3a20: 46 45 3d 31 20 77 68 69 63 68 20 69 73 20 73 61  FE=1 which is sa
3a30: 66 65 20 66 6f 72 20 75 73 65 20 69 6e 20 61 20  fe for use in a 
3a40: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 0a 20 20  multithreaded.  
3a50: 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 57 68  environment.  Wh
3a60: 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  en compiled with
3a70: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
3a80: 46 45 3d 30 20 61 6c 6c 20 6d 75 74 65 78 69 6e  FE=0 all mutexin
3a90: 67 20 63 6f 64 65 0a 20 20 69 73 20 6f 6d 69 74  g code.  is omit
3aa0: 74 65 64 20 61 6e 64 20 69 74 20 69 73 20 75 6e  ted and it is un
3ab0: 73 61 66 65 20 74 6f 20 75 73 65 20 53 51 4c 69  safe to use SQLi
3ac0: 74 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72  te in a multithr
3ad0: 65 61 64 65 64 20 70 72 6f 67 72 61 6d 2e 0a 20  eaded program.. 
3ae0: 20 57 68 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77   When compiled w
3af0: 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52 45 41  ith SQLITE_THREA
3b00: 44 53 41 46 45 3d 32 2c 20 53 51 4c 69 74 65 20  DSAFE=2, SQLite 
3b10: 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 61  can be used in a
3b20: 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 0a 20   multithreaded. 
3b30: 20 70 72 6f 67 72 61 6d 20 73 6f 20 6c 6f 6e 67   program so long
3b40: 20 61 73 20 6e 6f 20 74 77 6f 20 74 68 72 65 61   as no two threa
3b50: 64 73 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73  ds attempt to us
3b60: 65 20 74 68 65 20 73 61 6d 65 0a 20 20 5b 64 61  e the same.  [da
3b70: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
3b80: 6e 5d 20 28 6f 72 20 61 6e 79 20 5b 70 72 65 70  n] (or any [prep
3b90: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 5d  ared statements]
3ba0: 20 64 65 72 69 76 65 64 20 66 72 6f 6d 0a 20 20   derived from.  
3bb0: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 63 6f  that database co
3bc0: 6e 6e 65 63 74 69 6f 6e 29 20 61 74 20 74 68 65  nnection) at the
3bd0: 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 20 20 54   same time...  T
3be0: 6f 20 70 75 74 20 69 74 20 61 6e 6f 74 68 65 72  o put it another
3bf0: 20 77 61 79 2c 20 53 51 4c 49 54 45 5f 54 48 52   way, SQLITE_THR
3c00: 45 41 44 53 41 46 45 3d 31 20 73 65 74 73 20 74  EADSAFE=1 sets t
3c10: 68 65 20 64 65 66 61 75 6c 74 0a 20 20 5b 74 68  he default.  [th
3c20: 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f  reading mode] to
3c30: 20 53 65 72 69 61 6c 69 7a 65 64 2e 20 20 53 51   Serialized.  SQ
3c40: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
3c50: 32 20 73 65 74 73 20 74 68 65 20 64 65 66 61 75  2 sets the defau
3c60: 6c 74 0a 20 20 5b 74 68 72 65 61 64 69 6e 67 20  lt.  [threading 
3c70: 6d 6f 64 65 5d 20 74 6f 20 4d 75 6c 74 69 2d 74  mode] to Multi-t
3c80: 68 72 65 61 64 65 64 2e 20 20 41 6e 64 20 53 51  hreaded.  And SQ
3c90: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
3ca0: 30 20 73 65 74 73 20 74 68 65 0a 20 20 5b 74 68  0 sets the.  [th
3cb0: 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f  reading mode] to
3cc0: 20 53 69 6e 67 6c 65 2d 74 68 72 65 61 64 65 64   Single-threaded
3cd0: 2e 0a 0a 20 20 54 68 65 20 76 61 6c 75 65 20 6f  ...  The value o
3ce0: 66 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  f SQLITE_THREADS
3cf0: 41 46 45 20 63 61 6e 20 62 65 20 64 65 74 65 72  AFE can be deter
3d00: 6d 69 6e 65 64 20 61 74 20 72 75 6e 2d 74 69 6d  mined at run-tim
3d10: 65 0a 20 20 75 73 69 6e 67 20 74 68 65 20 5b 73  e.  using the [s
3d20: 71 6c 69 74 65 33 5f 74 68 72 65 61 64 73 61 66  qlite3_threadsaf
3d30: 65 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 0a  e()] interface..
3d40: 0a 20 20 57 68 65 6e 20 53 51 4c 69 74 65 20 68  .  When SQLite h
3d50: 61 73 20 62 65 65 6e 20 63 6f 6d 70 69 6c 65 64  as been compiled
3d60: 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52   with SQLITE_THR
3d70: 45 41 44 53 41 46 45 3d 31 20 6f 72 0a 20 20 53  EADSAFE=1 or.  S
3d80: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45  QLITE_THREADSAFE
3d90: 3d 32 20 74 68 65 6e 20 74 68 65 20 5b 74 68 72  =2 then the [thr
3da0: 65 61 64 69 6e 67 20 6d 6f 64 65 5d 0a 20 20 63  eading mode].  c
3db0: 61 6e 20 62 65 20 61 6c 74 65 72 65 64 20 61 74  an be altered at
3dc0: 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 20   run-time using 
3dd0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e  the [sqlite3_con
3de0: 66 69 67 28 29 5d 20 69 6e 74 65 72 66 61 63 65  fig()] interface
3df0: 20 74 6f 67 65 74 68 65 72 0a 20 20 77 69 74 68   together.  with
3e00: 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 76 65   one of these ve
3e10: 72 62 73 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c  rbs:..  <ul>.  <
3e20: 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  li>[SQLITE_CONFI
3e30: 47 5f 53 49 4e 47 4c 45 54 48 52 45 41 44 5d 0a  G_SINGLETHREAD].
3e40: 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f 43 4f    <li>[SQLITE_CO
3e50: 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44  NFIG_MULTITHREAD
3e60: 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 5f  ].  <li>[SQLITE_
3e70: 43 4f 4e 46 49 47 5f 53 45 52 49 41 4c 49 5a 45  CONFIG_SERIALIZE
3e80: 44 5d 0a 20 20 3c 2f 75 6c 3e 0a 0a 20 20 54 68  D].  </ul>..  Th
3e90: 65 20 5b 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4e  e [SQLITE_OPEN_N
3ea0: 4f 4d 55 54 45 58 5d 20 61 6e 64 0a 20 20 5b 53  OMUTEX] and.  [S
3eb0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d  QLITE_OPEN_FULLM
3ec0: 55 54 45 58 5d 20 66 6c 61 67 73 20 74 6f 20 5b  UTEX] flags to [
3ed0: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28  sqlite3_open_v2(
3ee0: 29 5d 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 75  )] can also be u
3ef0: 73 65 64 0a 20 20 74 6f 20 61 64 6a 75 73 74 20  sed.  to adjust 
3f00: 74 68 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d  the [threading m
3f10: 6f 64 65 5d 20 6f 66 20 69 6e 64 69 76 69 64 75  ode] of individu
3f20: 61 6c 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e  al [database con
3f30: 6e 65 63 74 69 6f 6e 73 5d 0a 20 20 61 74 20 72  nections].  at r
3f40: 75 6e 2d 74 69 6d 65 2e 0a 0a 20 20 4e 6f 74 65  un-time...  Note
3f50: 20 74 68 61 74 20 77 68 65 6e 20 53 51 4c 69 74   that when SQLit
3f60: 65 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77 69  e is compiled wi
3f70: 74 68 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  th SQLITE_THREAD
3f80: 53 41 46 45 3d 30 2c 20 74 68 65 20 63 6f 64 65  SAFE=0, the code
3f90: 0a 20 20 74 6f 20 6d 61 6b 65 20 53 51 4c 69 74  .  to make SQLit
3fa0: 65 20 74 68 72 65 61 64 73 61 66 65 20 69 73 20  e threadsafe is 
3fb0: 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65  omitted from the
3fc0: 20 62 75 69 6c 64 2e 20 20 57 68 65 6e 20 74 68   build.  When th
3fd0: 69 73 20 6f 63 63 75 72 73 2c 0a 20 20 69 74 20  is occurs,.  it 
3fe0: 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f  is impossible to
3ff0: 20 63 68 61 6e 67 65 20 74 68 65 20 5b 74 68 72   change the [thr
4000: 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20 61 74 20  eading mode] at 
4010: 73 74 61 72 74 2d 74 69 6d 65 20 6f 72 20 72 75  start-time or ru
4020: 6e 2d 74 69 6d 65 2e 0a 0a 20 20 53 65 65 20 74  n-time...  See t
4030: 68 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f  he [threading mo
4040: 64 65 5d 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f  de] documentatio
4050: 6e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  n for additional
4060: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 6f   information.  o
4070: 6e 20 61 73 70 65 63 74 73 20 6f 66 20 75 73 69  n aspects of usi
4080: 6e 67 20 53 51 4c 69 74 65 20 69 6e 20 61 20 6d  ng SQLite in a m
4090: 75 6c 74 69 74 68 72 65 61 64 65 64 20 65 6e 76  ultithreaded env
40a0: 69 72 6f 6e 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d  ironment..}..COM
40b0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
40c0: 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3c  ITE_TEMP_STORE=<
40d0: 69 3e 26 6c 74 3b 30 20 74 68 72 6f 75 67 68 20  i>&lt;0 through 
40e0: 33 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  3&gt;</i>} {.  T
40f0: 68 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72  his option contr
4100: 6f 6c 73 20 77 68 65 74 68 65 72 20 74 65 6d 70  ols whether temp
4110: 6f 72 61 72 79 20 66 69 6c 65 73 20 61 72 65 20  orary files are 
4120: 73 74 6f 72 65 64 20 6f 6e 20 64 69 73 6b 20 6f  stored on disk o
4130: 72 0a 20 20 69 6e 20 6d 65 6d 6f 72 79 2e 20 20  r.  in memory.  
4140: 54 68 65 20 6d 65 61 6e 69 6e 67 73 20 66 6f 72  The meanings for
4150: 20 76 61 72 69 6f 75 73 20 73 65 74 74 69 6e 67   various setting
4160: 73 20 6f 66 20 74 68 69 73 20 63 6f 6d 70 69 6c  s of this compil
4170: 65 2d 74 69 6d 65 0a 20 20 6f 70 74 69 6f 6e 20  e-time.  option 
4180: 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a  are as follows:.
4190: 0a 20 20 3c 74 61 62 6c 65 20 63 65 6c 6c 70 61  .  <table cellpa
41a0: 64 64 69 6e 67 3d 22 32 22 20 62 6f 72 64 65 72  dding="2" border
41b0: 3d 22 31 22 3e 0a 20 20 3c 74 72 3e 3c 74 68 3e  ="1">.  <tr><th>
41c0: 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52  SQLITE_TEMP_STOR
41d0: 45 3c 2f 74 68 3e 3c 74 68 3e 4d 65 61 6e 69 6e  E</th><th>Meanin
41e0: 67 3c 2f 74 68 3e 3c 2f 74 72 3e 0a 20 20 3c 74  g</th></tr>.  <t
41f0: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e  r><td align="cen
4200: 74 65 72 22 3e 30 3c 2f 74 64 3e 3c 74 64 3e 41  ter">0</td><td>A
4210: 6c 77 61 79 73 20 75 73 65 20 74 65 6d 70 6f 72  lways use tempor
4220: 61 72 79 20 66 69 6c 65 73 3c 2f 74 64 3e 3c 2f  ary files</td></
4230: 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c  tr>.  <tr><td al
4240: 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 31 3c 2f  ign="center">1</
4250: 74 64 3e 3c 74 64 3e 55 73 65 20 66 69 6c 65 73  td><td>Use files
4260: 20 62 79 20 64 65 66 61 75 6c 74 20 62 75 74 20   by default but 
4270: 61 6c 6c 6f 77 20 74 68 65 0a 20 20 5b 50 52 41  allow the.  [PRA
4280: 47 4d 41 20 74 65 6d 70 5f 73 74 6f 72 65 5d 20  GMA temp_store] 
4290: 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76 65 72 72  command to overr
42a0: 69 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20  ide</td></tr>.  
42b0: 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63  <tr><td align="c
42c0: 65 6e 74 65 72 22 3e 32 3c 2f 74 64 3e 3c 74 64  enter">2</td><td
42d0: 3e 55 73 65 20 6d 65 6d 6f 72 79 20 62 79 20 64  >Use memory by d
42e0: 65 66 61 75 6c 74 20 62 75 74 20 61 6c 6c 6f 77  efault but allow
42f0: 20 74 68 65 0a 20 20 5b 50 52 41 47 4d 41 20 74   the.  [PRAGMA t
4300: 65 6d 70 5f 73 74 6f 72 65 5d 20 63 6f 6d 6d 61  emp_store] comma
4310: 6e 64 20 74 6f 20 6f 76 65 72 72 69 64 65 3c 2f  nd to override</
4320: 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c  td></tr>.  <tr><
4330: 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72  td align="center
4340: 22 3e 33 3c 2f 74 64 3e 3c 74 64 3e 41 6c 77 61  ">3</td><td>Alwa
4350: 79 73 20 75 73 65 20 6d 65 6d 6f 72 79 3c 2f 74  ys use memory</t
4360: 64 3e 3c 2f 74 72 3e 0a 20 20 3c 2f 74 61 62 6c  d></tr>.  </tabl
4370: 65 3e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c  e>..  The defaul
4380: 74 20 73 65 74 74 69 6e 67 20 69 73 20 31 2e 20  t setting is 1. 
4390: 20 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 20 69   .  Additional i
43a0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e 20 62  nformation can b
43b0: 65 20 66 6f 75 6e 64 20 69 6e 20 5b 74 65 6d 70  e found in [temp
43c0: 73 74 6f 72 65 20 7c 20 74 65 6d 70 66 69 6c 65  store | tempfile
43d0: 73 2e 68 74 6d 6c 5d 2e 0a 7d 0a 0a 43 4f 4d 50  s.html]..}..COMP
43e0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
43f0: 54 45 5f 54 52 41 43 45 5f 53 49 5a 45 5f 4c 49  TE_TRACE_SIZE_LI
4400: 4d 49 54 3d 3c 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a  MIT=<i>N</i>} {.
4410: 20 20 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20    If this macro 
4420: 69 73 20 64 65 66 69 6e 65 64 20 74 6f 20 61 20  is defined to a 
4430: 70 6f 73 69 74 69 76 65 20 69 6e 74 65 67 65 72  positive integer
4440: 20 3c 69 3e 4e 3c 2f 69 3e 2c 20 74 68 65 6e 20   <i>N</i>, then 
4450: 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 0a 20 20  the length of.  
4460: 73 74 72 69 6e 67 73 20 61 6e 64 20 42 4c 4f 42  strings and BLOB
4470: 20 74 68 61 74 20 61 72 65 20 65 78 70 61 6e 64   that are expand
4480: 65 64 20 69 6e 74 6f 20 70 61 72 61 6d 65 74 65  ed into paramete
4490: 72 73 20 69 6e 20 74 68 65 20 6f 75 74 70 75 74  rs in the output
44a0: 20 6f 66 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74   of.  [sqlite3_t
44b0: 72 61 63 65 28 29 5d 20 69 73 20 6c 69 6d 69 74  race()] is limit
44c0: 65 64 20 74 6f 20 3c 69 3e 4e 3c 2f 69 3e 20 62  ed to <i>N</i> b
44d0: 79 74 65 73 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49  ytes.  .}..COMPI
44e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
44f0: 45 5f 55 53 45 5f 55 52 49 7d 20 7b 0a 20 20 54  E_USE_URI} {.  T
4500: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65  his option cause
4510: 73 20 74 68 65 20 5b 55 52 49 20 66 69 6c 65 6e  s the [URI filen
4520: 61 6d 65 5d 20 70 72 6f 63 65 73 73 20 6c 6f 67  ame] process log
4530: 69 63 20 74 6f 20 62 65 20 65 6e 61 62 6c 65 64  ic to be enabled
4540: 20 62 79 20 0a 20 20 64 65 66 61 75 6c 74 2e 20   by .  default. 
4550: 20 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20   .}..</tcl>..<a 
4560: 6e 61 6d 65 3d 22 65 6e 61 62 6c 65 66 65 61 74  name="enablefeat
4570: 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31  ures"></a>.<h2>1
4580: 2e 34 20 4f 70 74 69 6f 6e 73 20 54 6f 20 45 6e  .4 Options To En
4590: 61 62 6c 65 20 46 65 61 74 75 72 65 73 20 4e 6f  able Features No
45a0: 72 6d 61 6c 6c 79 20 54 75 72 6e 65 64 20 4f 66  rmally Turned Of
45b0: 66 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f  f</h2>..<tcl>.CO
45c0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
45d0: 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55 52 49 5f 41  LITE_ALLOW_URI_A
45e0: 55 54 48 4f 52 49 54 59 7d 20 7b 0a 20 20 5b 55  UTHORITY} {.  [U
45f0: 52 49 20 66 69 6c 65 6e 61 6d 65 73 5d 20 6e 6f  RI filenames] no
4600: 72 6d 61 6c 6c 79 20 74 68 72 6f 77 20 61 6e 20  rmally throw an 
4610: 65 72 72 6f 72 20 69 73 20 74 68 65 20 61 75 74  error is the aut
4620: 68 6f 72 69 74 79 20 73 65 63 74 69 6f 6e 20 69  hority section i
4630: 73 0a 20 20 6e 6f 74 20 65 69 74 68 65 72 20 65  s.  not either e
4640: 6d 70 74 79 20 6f 72 20 22 6c 6f 63 61 6c 68 6f  mpty or "localho
4650: 73 74 22 2e 20 20 48 6f 77 65 76 65 72 2c 20 69  st".  However, i
4660: 66 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70  f SQLite is comp
4670: 69 6c 65 64 20 77 69 74 68 0a 20 20 74 68 65 20  iled with.  the 
4680: 53 51 4c 49 54 45 5f 41 4c 4c 4f 57 5f 55 52 49  SQLITE_ALLOW_URI
4690: 5f 41 55 54 48 4f 52 49 54 59 20 63 6f 6d 70 69  _AUTHORITY compi
46a0: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2c 20  le-time option, 
46b0: 74 68 65 6e 20 74 68 65 20 55 52 49 20 69 73 0a  then the URI is.
46c0: 20 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69    is converted i
46d0: 6e 74 6f 20 61 20 55 6e 69 66 6f 72 6d 20 4e 61  nto a Uniform Na
46e0: 6d 69 6e 67 20 43 6f 6e 76 65 6e 74 69 6f 6e 20  ming Convention 
46f0: 28 55 4e 43 29 20 66 69 6c 65 6e 61 6d 65 20 61  (UNC) filename a
4700: 6e 64 20 70 61 73 73 65 64 0a 20 20 64 6f 77 6e  nd passed.  down
4710: 20 74 6f 20 74 68 65 20 75 6e 64 65 72 6c 79 69   to the underlyi
4720: 6e 67 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73  ng operating sys
4730: 74 65 6d 20 74 68 61 74 20 77 61 79 2e 20 20 0a  tem that way.  .
4740: 20 20 3c 70 3e 0a 20 20 53 6f 6d 65 20 66 75 74    <p>.  Some fut
4750: 75 72 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  ure versions of 
4760: 53 51 4c 69 74 65 20 6d 61 79 20 63 68 61 6e 67  SQLite may chang
4770: 65 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 69 73  e to enable this
4780: 20 66 65 61 74 75 72 65 0a 20 20 62 79 20 64 65   feature.  by de
4790: 66 61 75 6c 74 2e 0a 7d 0a 43 4f 4d 50 49 4c 45  fault..}.COMPILE
47a0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
47b0: 41 4c 4c 4f 57 5f 43 4f 56 45 52 49 4e 47 5f 49  ALLOW_COVERING_I
47c0: 4e 44 45 58 5f 53 43 41 4e 3d 3c 69 3e 26 6c 74  NDEX_SCAN=<i>&lt
47d0: 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f 69 3e 7d  ;0 or 1&gt;</i>}
47e0: 20 7b 0a 20 20 54 68 69 73 20 43 2d 70 72 65 70   {.  This C-prep
47f0: 72 6f 63 65 73 73 20 6d 61 63 72 6f 20 64 65 74  rocess macro det
4800: 65 72 6d 69 6e 65 73 20 74 68 65 20 64 65 66 61  ermines the defa
4810: 75 6c 74 20 73 65 74 74 69 6e 67 20 6f 66 20 74  ult setting of t
4820: 68 65 0a 20 20 5b 53 51 4c 49 54 45 5f 43 4f 4e  he.  [SQLITE_CON
4830: 46 49 47 5f 43 4f 56 45 52 49 4e 47 5f 49 4e 44  FIG_COVERING_IND
4840: 45 58 5f 53 43 41 4e 5d 20 63 6f 6e 66 69 67 75  EX_SCAN] configu
4850: 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67 2e 20  ration setting. 
4860: 20 49 74 20 64 65 66 61 75 6c 74 73 0a 20 20 74   It defaults.  t
4870: 6f 20 31 20 28 6f 6e 29 20 77 68 69 63 68 20 6d  o 1 (on) which m
4880: 65 61 6e 73 20 74 68 61 74 20 63 6f 76 65 72 69  eans that coveri
4890: 6e 67 20 69 6e 64 69 63 65 73 20 61 72 65 20 75  ng indices are u
48a0: 73 65 64 20 66 6f 72 20 66 75 6c 6c 20 74 61 62  sed for full tab
48b0: 6c 65 0a 20 20 73 63 61 6e 73 20 77 68 65 72 65  le.  scans where
48c0: 20 70 6f 73 73 69 62 6c 65 2c 20 69 6e 20 6f 72   possible, in or
48d0: 64 65 72 20 74 6f 20 72 65 64 75 63 65 20 49 2f  der to reduce I/
48e0: 4f 20 61 6e 64 20 69 6d 70 72 6f 76 65 20 70 65  O and improve pe
48f0: 72 66 6f 72 6d 61 6e 63 65 2e 0a 20 20 48 6f 77  rformance..  How
4900: 65 76 65 72 2c 20 74 68 65 20 75 73 65 20 6f 66  ever, the use of
4910: 20 61 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 65   a covering inde
4920: 78 20 66 6f 72 20 61 20 66 75 6c 6c 20 73 63 61  x for a full sca
4930: 6e 20 77 69 6c 6c 20 63 61 75 73 65 20 72 65 73  n will cause res
4940: 75 6c 74 73 0a 20 20 74 6f 20 61 70 70 65 61 72  ults.  to appear
4950: 20 69 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20   in a different 
4960: 6f 72 64 65 72 20 66 72 6f 6d 20 6c 65 67 61 63  order from legac
4970: 79 2c 20 77 68 69 63 68 20 63 6f 75 6c 64 20 63  y, which could c
4980: 61 75 73 65 20 73 6f 6d 65 0a 20 20 28 69 6e 63  ause some.  (inc
4990: 6f 72 72 65 63 74 6c 79 2d 63 6f 64 65 64 29 20  orrectly-coded) 
49a0: 6c 65 67 61 63 79 20 61 70 70 6c 69 63 61 74 69  legacy applicati
49b0: 6f 6e 73 20 74 6f 20 62 72 65 61 6b 2e 20 20 48  ons to break.  H
49c0: 65 6e 63 65 2c 20 74 68 65 20 63 6f 76 65 72 69  ence, the coveri
49d0: 6e 67 0a 20 20 69 6e 64 65 78 20 73 63 61 6e 20  ng.  index scan 
49e0: 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65 20 64 69  option can be di
49f0: 73 61 62 6c 65 64 20 61 74 20 63 6f 6d 70 69 6c  sabled at compil
4a00: 65 2d 74 69 6d 65 20 6f 6e 20 73 79 73 74 65 6d  e-time on system
4a10: 73 20 74 68 61 74 20 77 68 61 74 0a 20 20 74 6f  s that what.  to
4a20: 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 69 72 20   minimize their 
4a30: 72 69 73 6b 20 6f 66 20 65 78 70 6f 73 69 6e 67  risk of exposing
4a40: 20 65 72 72 6f 72 73 20 69 6e 20 6c 65 67 61 63   errors in legac
4a50: 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a  y applications..
4a60: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
4a70: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
4a80: 5f 38 5f 33 5f 4e 41 4d 45 53 3d 3c 69 3e 26 6c  _8_3_NAMES=<i>&l
4a90: 74 3b 31 20 6f 72 20 32 26 67 74 3b 3c 2f 69 3e  t;1 or 2&gt;</i>
4aa0: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 43 2d  } {.  If this C-
4ab0: 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63  preprocessor mac
4ac0: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74  ro is defined, t
4ad0: 68 65 6e 20 65 78 74 72 61 20 63 6f 64 65 20 69  hen extra code i
4ae0: 73 0a 20 20 69 6e 63 6c 75 64 65 64 20 74 68 61  s.  included tha
4af0: 74 20 61 6c 6c 6f 77 73 20 53 51 4c 69 74 65 20  t allows SQLite 
4b00: 74 6f 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 61  to function on a
4b10: 20 66 69 6c 65 73 79 73 74 65 6d 20 74 68 61 74   filesystem that
4b20: 0a 20 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 20  .  only support 
4b30: 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73 2e 20 20  8+3 filenames.  
4b40: 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  If the value of 
4b50: 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 31 2c  this macro is 1,
4b60: 0a 20 20 74 68 65 6e 20 74 68 65 20 64 65 66 61  .  then the defa
4b70: 75 6c 74 20 62 65 68 61 76 69 6f 72 20 69 73 20  ult behavior is 
4b80: 74 6f 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 75  to continue to u
4b90: 73 65 20 6c 6f 6e 67 20 66 69 6c 65 6e 61 6d 65  se long filename
4ba0: 73 20 61 6e 64 0a 20 20 74 6f 20 6f 6e 6c 79 20  s and.  to only 
4bb0: 75 73 65 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65  use 8+3 filename
4bc0: 73 20 69 66 20 74 68 65 20 0a 20 20 64 61 74 61  s if the .  data
4bd0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
4be0: 69 73 20 6f 70 65 6e 65 64 20 75 73 69 6e 67 20  is opened using 
4bf0: 5b 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 5d 20  [URI filenames] 
4c00: 77 69 74 68 0a 20 20 74 68 65 20 22 3c 74 74 3e  with.  the "<tt>
4c10: 38 5f 33 5f 6e 61 6d 65 73 3d 31 3c 2f 74 74 3e  8_3_names=1</tt>
4c20: 22 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65  " query paramete
4c30: 72 2e 20 20 49 66 20 74 68 65 20 76 61 6c 75 65  r.  If the value
4c40: 20 6f 66 0a 20 20 74 68 69 73 20 6d 61 63 72 6f   of.  this macro
4c50: 20 69 73 20 32 2c 20 74 68 65 6e 20 74 68 65 20   is 2, then the 
4c60: 75 73 65 20 6f 66 20 38 2b 33 20 66 69 6c 65 6e  use of 8+3 filen
4c70: 61 6d 65 73 20 62 65 63 6f 6d 65 73 20 74 68 65  ames becomes the
4c80: 20 64 65 66 61 75 6c 74 0a 20 20 62 75 74 20 6d   default.  but m
4c90: 61 79 20 62 65 20 64 69 73 61 62 6c 65 64 20 6f  ay be disabled o
4ca0: 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 74 74 3e  n using the <tt>
4cb0: 38 5f 33 5f 6e 61 6d 65 73 3d 30 3c 2f 74 74 3e  8_3_names=0</tt>
4cc0: 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72   query parameter
4cd0: 2e 0a 20 20 53 65 65 20 0a 7d 0a 0a 43 4f 4d 50  ..  See .}..COMP
4ce0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
4cf0: 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43  TE_ENABLE_ATOMIC
4d00: 5f 57 52 49 54 45 7d 20 7b 0a 20 20 49 66 20 74  _WRITE} {.  If t
4d10: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
4d20: 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  or macro is defi
4d30: 6e 65 64 20 61 6e 64 20 69 66 20 74 68 65 0a 20  ned and if the. 
4d40: 20 78 44 65 76 69 63 65 43 68 61 72 61 63 74 65   xDeviceCharacte
4d50: 72 69 73 74 69 63 73 20 6d 65 74 68 6f 64 20 6f  ristics method o
4d60: 66 20 5b 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65  f [sqlite3_io_me
4d70: 74 68 6f 64 73 5d 20 6f 62 6a 65 63 74 20 66 6f  thods] object fo
4d80: 72 0a 20 20 61 20 64 61 74 61 62 61 73 65 20 66  r.  a database f
4d90: 69 6c 65 20 72 65 70 6f 72 74 73 20 28 76 69 61  ile reports (via
4da0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 5b 53 51 4c   one of the [SQL
4db0: 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43  ITE_IOCAP_ATOMIC
4dc0: 5d 20 62 69 74 73 29 0a 20 20 74 68 61 74 20 74  ] bits).  that t
4dd0: 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 73 75  he filesystem su
4de0: 70 70 6f 72 74 73 20 61 74 6f 6d 69 63 20 77 72  pports atomic wr
4df0: 69 74 65 73 20 61 6e 64 20 69 66 20 61 20 74 72  ites and if a tr
4e00: 61 6e 73 61 63 74 69 6f 6e 0a 20 20 69 6e 76 6f  ansaction.  invo
4e10: 6c 76 65 73 20 61 20 63 68 61 6e 67 65 20 74 6f  lves a change to
4e20: 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 70   only a single p
4e30: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  age of the datab
4e40: 61 73 65 20 66 69 6c 65 2c 0a 20 20 74 68 65 6e  ase file,.  then
4e50: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
4e60: 20 63 6f 6d 6d 69 74 73 20 77 69 74 68 20 6a 75   commits with ju
4e70: 73 74 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74  st a single writ
4e80: 65 20 72 65 71 75 65 73 74 20 6f 66 0a 20 20 61  e request of.  a
4e90: 20 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20   single page of 
4ea0: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64  the database and
4eb0: 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75   no rollback jou
4ec0: 72 6e 61 6c 20 69 73 20 63 72 65 61 74 65 64 0a  rnal is created.
4ed0: 20 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 4f    or written.  O
4ee0: 6e 20 66 69 6c 65 73 79 73 74 65 6d 73 20 74 68  n filesystems th
4ef0: 61 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69  at support atomi
4f00: 63 20 77 72 69 74 65 73 2c 20 74 68 69 73 0a 20  c writes, this. 
4f10: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61   optimization ca
4f20: 6e 20 72 65 73 75 6c 74 20 69 6e 20 73 69 67 6e  n result in sign
4f30: 69 66 69 63 61 6e 74 20 73 70 65 65 64 20 69 6d  ificant speed im
4f40: 70 72 6f 76 65 6d 65 6e 74 73 20 66 6f 72 0a 20  provements for. 
4f50: 20 73 6d 61 6c 6c 20 75 70 64 61 74 65 73 2e 20   small updates. 
4f60: 20 48 6f 77 65 76 65 72 2c 20 66 65 77 20 66 69   However, few fi
4f70: 6c 65 73 79 73 74 65 6d 73 20 73 75 70 70 6f 72  lesystems suppor
4f80: 74 20 74 68 69 73 20 63 61 70 61 62 69 6c 69 74  t this capabilit
4f90: 79 0a 20 20 61 6e 64 20 74 68 65 20 63 6f 64 65  y.  and the code
4fa0: 20 70 61 74 68 73 20 74 68 61 74 20 63 68 65 63   paths that chec
4fb0: 6b 20 66 6f 72 20 74 68 69 73 20 63 61 70 61 62  k for this capab
4fc0: 69 6c 69 74 79 20 73 6c 6f 77 20 64 6f 77 6e 20  ility slow down 
4fd0: 77 72 69 74 65 0a 20 20 70 65 72 66 6f 72 6d 61  write.  performa
4fe0: 6e 63 65 20 6f 6e 20 73 79 73 74 65 6d 73 20 74  nce on systems t
4ff0: 68 61 74 20 6c 61 63 6b 20 61 74 6f 6d 69 63 20  hat lack atomic 
5000: 77 72 69 74 65 20 63 61 70 61 62 69 6c 69 74 79  write capability
5010: 2c 20 73 6f 20 74 68 69 73 0a 20 20 66 65 61 74  , so this.  feat
5020: 75 72 65 20 69 73 20 64 69 73 61 62 6c 65 64 20  ure is disabled 
5030: 62 79 20 64 65 66 61 75 6c 74 2e 0a 7d 0a 0a 43  by default..}..C
5040: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
5050: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c  QLITE_ENABLE_COL
5060: 55 4d 4e 5f 4d 45 54 41 44 41 54 41 7d 20 7b 0a  UMN_METADATA} {.
5070: 20 20 57 68 65 6e 20 74 68 69 73 20 43 2d 70 72    When this C-pr
5080: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f  eprocessor macro
5090: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c   is defined, SQL
50a0: 69 74 65 20 69 6e 63 6c 75 64 65 73 20 73 6f 6d  ite includes som
50b0: 65 0a 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 41  e.  additional A
50c0: 50 49 73 20 74 68 61 74 20 70 72 6f 76 69 64 65  PIs that provide
50d0: 20 63 6f 6e 76 65 6e 69 65 6e 74 20 61 63 63 65   convenient acce
50e0: 73 73 20 74 6f 20 6d 65 74 61 2d 64 61 74 61 20  ss to meta-data 
50f0: 61 62 6f 75 74 0a 20 20 74 61 62 6c 65 73 20 61  about.  tables a
5100: 6e 64 20 71 75 65 72 69 65 73 2e 20 20 54 68 65  nd queries.  The
5110: 20 41 50 49 73 20 74 68 61 74 20 61 72 65 20 65   APIs that are e
5120: 6e 61 62 6c 65 64 20 62 79 20 74 68 69 73 20 6f  nabled by this o
5130: 70 74 69 6f 6e 20 61 72 65 3a 0a 0a 20 20 3c 75  ption are:..  <u
5140: 6c 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74  l>.  <li> [sqlit
5150: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61  e3_column_databa
5160: 73 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e  se_name()] </li>
5170: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33  .  <li> [sqlite3
5180: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65  _column_database
5190: 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e  _name16()] </li>
51a0: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33  .  <li> [sqlite3
51b0: 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61  _column_table_na
51c0: 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c  me()] </li>.  <l
51d0: 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  i> [sqlite3_colu
51e0: 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28  mn_table_name16(
51f0: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20  )] </li>.  <li> 
5200: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
5210: 6f 72 69 67 69 6e 5f 6e 61 6d 65 28 29 5d 20 3c  origin_name()] <
5220: 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c  /li>.  <li> [sql
5230: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67  ite3_column_orig
5240: 69 6e 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c  in_name16()] </l
5250: 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74  i>.  <li> [sqlit
5260: 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f  e3_table_column_
5270: 6d 65 74 61 64 61 74 61 28 29 5d 20 3c 2f 6c 69  metadata()] </li
5280: 3e 0a 20 20 3c 2f 75 6c 3e 0a 7d 0a 0a 43 4f 4d  >.  </ul>.}..COM
5290: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
52a0: 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41  ITE_ENABLE_EXPLA
52b0: 49 4e 5f 43 4f 4d 4d 45 4e 54 53 7d 20 7b 0a 20  IN_COMMENTS} {. 
52c0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64   This option add
52d0: 73 20 65 78 74 72 61 20 6c 6f 67 69 63 20 74 6f  s extra logic to
52e0: 20 53 51 4c 69 74 65 20 74 68 61 74 20 69 6e 73   SQLite that ins
52f0: 65 72 74 73 20 63 6f 6d 6d 65 6e 74 20 74 65 78  erts comment tex
5300: 74 20 69 6e 74 6f 20 74 68 65 0a 20 20 6f 75 74  t into the.  out
5310: 70 75 74 20 6f 66 20 5b 45 58 50 4c 41 49 4e 5d  put of [EXPLAIN]
5320: 2e 20 20 54 68 65 73 65 20 65 78 74 72 61 20 63  .  These extra c
5330: 6f 6d 6d 65 6e 74 73 20 75 73 65 20 65 78 74 72  omments use extr
5340: 61 20 6d 65 6d 6f 72 79 2c 20 74 68 75 73 0a 20  a memory, thus. 
5350: 20 6d 61 6b 69 6e 67 20 5b 70 72 65 70 61 72 65   making [prepare
5360: 64 20 73 74 61 74 65 6d 65 6e 74 73 5d 20 6c 61  d statements] la
5370: 72 67 65 72 20 61 6e 64 20 76 65 72 79 20 73 6c  rger and very sl
5380: 69 67 68 74 6c 79 20 73 6c 6f 77 65 72 2c 20 61  ightly slower, a
5390: 6e 64 20 73 6f 20 74 68 65 79 20 61 72 65 0a 20  nd so they are. 
53a0: 20 74 75 72 6e 65 64 20 6f 66 66 20 62 79 20 64   turned off by d
53b0: 65 66 61 75 6c 74 20 61 6e 64 20 69 6e 20 6d 6f  efault and in mo
53c0: 73 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 20  st application. 
53d0: 20 42 75 74 20 73 6f 6d 65 20 61 70 70 6c 69 63   But some applic
53e0: 61 74 69 6f 6e 73 2c 20 73 75 63 68 0a 20 20 61  ations, such.  a
53f0: 73 20 74 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d 6c  s the [command-l
5400: 69 6e 65 20 73 68 65 6c 6c 5d 20 66 6f 72 20 53  ine shell] for S
5410: 51 4c 69 74 65 2c 20 76 61 6c 75 65 20 63 6c 61  QLite, value cla
5420: 72 69 74 79 20 6f 66 20 45 58 50 4c 41 49 4e 20  rity of EXPLAIN 
5430: 6f 75 74 70 75 74 0a 20 20 6f 76 65 72 20 72 61  output.  over ra
5440: 77 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e  w performance an
5450: 64 20 73 6f 20 74 68 69 73 20 63 6f 6d 70 69 6c  d so this compil
5460: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73  e-time option is
5470: 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 74 68   available to th
5480: 65 6d 2e 0a 20 20 54 68 65 20 53 51 4c 49 54 45  em..  The SQLITE
5490: 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e 5f  _ENABLE_EXPLAIN_
54a0: 43 4f 4d 4d 45 4e 54 53 20 63 6f 6d 70 69 6c 65  COMMENTS compile
54b0: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20  -time option is 
54c0: 61 6c 73 6f 20 65 6e 61 62 6c 65 64 0a 20 20 61  also enabled.  a
54d0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 66 20  utomatically if 
54e0: 5b 53 51 4c 49 54 45 5f 44 45 42 55 47 5d 20 69  [SQLITE_DEBUG] i
54f0: 73 20 65 6e 61 62 6c 65 64 2e 0a 7d 0a 0a 0a 43  s enabled..}...C
5500: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
5510: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53  QLITE_ENABLE_FTS
5520: 33 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  3} {.  When this
5530: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
5540: 65 64 20 69 6e 20 74 68 65 20 5b 61 6d 61 6c 67  ed in the [amalg
5550: 61 6d 61 74 69 6f 6e 5d 2c 20 76 65 72 73 69 6f  amation], versio
5560: 6e 20 33 0a 20 20 6f 66 20 74 68 65 20 66 75 6c  n 3.  of the ful
5570: 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 65 6e  l-text search en
5580: 67 69 6e 65 20 69 73 20 61 64 64 65 64 20 74 6f  gine is added to
5590: 20 74 68 65 20 62 75 69 6c 64 20 61 75 74 6f 6d   the build autom
55a0: 61 74 69 63 61 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d  atically..}..COM
55b0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
55c0: 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 5f  ITE_ENABLE_FTS3_
55d0: 50 41 52 45 4e 54 48 45 53 49 53 7d 20 7b 0a 20  PARENTHESIS} {. 
55e0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d 6f 64   This option mod
55f0: 69 66 69 65 73 20 74 68 65 20 71 75 65 72 79 20  ifies the query 
5600: 70 61 74 74 65 72 6e 20 70 61 72 73 65 72 20 69  pattern parser i
5610: 6e 20 46 54 53 33 20 73 75 63 68 20 74 68 61 74  n FTS3 such that
5620: 20 69 74 0a 20 20 73 75 70 70 6f 72 74 73 20 6f   it.  supports o
5630: 70 65 72 61 74 6f 72 73 20 41 4e 44 20 61 6e 64  perators AND and
5640: 20 4e 4f 54 20 28 69 6e 20 61 64 64 69 74 69 6f   NOT (in additio
5650: 6e 20 74 6f 20 74 68 65 20 75 73 75 61 6c 20 4f  n to the usual O
5660: 52 20 61 6e 64 20 4e 45 41 52 29 0a 20 20 61 6e  R and NEAR).  an
5670: 64 20 61 6c 73 6f 20 61 6c 6c 6f 77 73 20 71 75  d also allows qu
5680: 65 72 79 20 65 78 70 72 65 73 73 69 6f 6e 73 20  ery expressions 
5690: 74 6f 20 63 6f 6e 74 61 69 6e 20 6e 65 73 74 65  to contain neste
56a0: 64 20 70 61 72 65 6e 74 68 65 73 69 73 2e 0a 7d  d parenthesis..}
56b0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
56c0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
56d0: 46 54 53 34 7d 20 7b 0a 20 20 57 68 65 6e 20 74  FTS4} {.  When t
56e0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65  his option is de
56f0: 66 69 6e 65 64 20 69 6e 20 74 68 65 20 5b 61 6d  fined in the [am
5700: 61 6c 67 61 6d 61 74 69 6f 6e 5d 2c 20 76 65 72  algamation], ver
5710: 73 69 6f 6e 73 20 33 20 61 6e 64 20 34 0a 20 20  sions 3 and 4.  
5720: 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74 65 78 74  of the full-text
5730: 20 73 65 61 72 63 68 20 65 6e 67 69 6e 65 20 69   search engine i
5740: 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 62  s added to the b
5750: 75 69 6c 64 20 61 75 74 6f 6d 61 74 69 63 61 6c  uild automatical
5760: 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ly..}..COMPILE_O
5770: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
5780: 41 42 4c 45 5f 49 43 55 7d 20 7b 0a 20 20 54 68  ABLE_ICU} {.  Th
5790: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73  is option causes
57a0: 20 74 68 65 20 0a 20 20 5b 68 74 74 70 3a 2f 2f   the .  [http://
57b0: 77 77 77 2e 69 63 75 2d 70 72 6f 6a 65 63 74 2e  www.icu-project.
57c0: 6f 72 67 2f 20 7c 20 49 6e 74 65 72 6e 61 74 69  org/ | Internati
57d0: 6f 6e 61 6c 20 43 6f 6d 70 6f 6e 65 6e 74 73 20  onal Components 
57e0: 66 6f 72 20 55 6e 69 63 6f 64 65 5d 0a 20 20 6f  for Unicode].  o
57f0: 72 20 22 49 43 55 22 20 65 78 74 65 6e 73 69 6f  r "ICU" extensio
5800: 6e 20 74 6f 20 53 51 4c 69 74 65 20 74 6f 20 62  n to SQLite to b
5810: 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 62  e added to the b
5820: 75 69 6c 64 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49  uild.  .}..COMPI
5830: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
5840: 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45  E_ENABLE_IOTRACE
5850: 7d 20 7b 0a 20 20 57 68 65 6e 20 62 6f 74 68 20  } {.  When both 
5860: 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20  the SQLite core 
5870: 61 6e 64 20 74 68 65 20 5b 43 6f 6d 6d 61 6e 64  and the [Command
5880: 20 4c 69 6e 65 20 49 6e 74 65 72 66 61 63 65 5d   Line Interface]
5890: 20 28 43 4c 49 29 20 61 72 65 20 62 6f 74 68 20   (CLI) are both 
58a0: 0a 20 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  .  compiled with
58b0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 74 68   this option, th
58c0: 65 6e 20 74 68 65 20 43 4c 49 20 70 72 6f 76 69  en the CLI provi
58d0: 64 65 73 20 61 6e 20 65 78 74 72 61 20 63 6f 6d  des an extra com
58e0: 6d 61 6e 64 0a 20 20 6e 61 6d 65 64 20 22 2e 69  mand.  named ".i
58f0: 6f 74 72 61 63 65 22 20 74 68 61 74 20 70 72 6f  otrace" that pro
5900: 76 69 64 65 73 20 61 20 6c 6f 77 2d 6c 65 76 65  vides a low-leve
5910: 6c 20 6c 6f 67 20 6f 66 20 49 2f 4f 20 61 63 74  l log of I/O act
5920: 69 76 69 74 79 2e 0a 20 20 54 68 69 73 20 6f 70  ivity..  This op
5930: 74 69 6f 6e 20 69 73 20 65 78 70 65 72 69 6d 65  tion is experime
5940: 6e 74 61 6c 20 61 6e 64 20 6d 61 79 20 62 65 20  ntal and may be 
5950: 64 69 73 63 6f 6e 74 69 6e 75 65 64 20 69 6e 20  discontinued in 
5960: 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65  a future release
5970: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
5980: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42  ION {SQLITE_ENAB
5990: 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45  LE_LOCKING_STYLE
59a0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
59b0: 6e 20 65 6e 61 62 6c 65 73 20 61 64 64 69 74 69  n enables additi
59c0: 6f 6e 61 6c 20 6c 6f 67 69 63 20 69 6e 20 74 68  onal logic in th
59d0: 65 20 4f 53 20 69 6e 74 65 72 66 61 63 65 20 6c  e OS interface l
59e0: 61 79 65 72 20 66 6f 72 0a 20 20 4d 61 63 20 4f  ayer for.  Mac O
59f0: 53 20 58 2e 20 54 68 65 20 61 64 64 69 74 69 6f  S X. The additio
5a00: 6e 61 6c 20 6c 6f 67 69 63 20 61 74 74 65 6d 70  nal logic attemp
5a10: 74 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  ts to determine 
5a20: 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 0a  the type of the.
5a30: 20 20 75 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c    underlying fil
5a40: 65 73 79 73 74 65 6d 20 61 6e 64 20 63 68 6f 6f  esystem and choo
5a50: 73 65 20 61 6e 64 20 61 6c 74 65 72 6e 61 74 69  se and alternati
5a60: 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74  ve locking strat
5a70: 65 67 79 0a 20 20 74 68 61 74 20 77 6f 72 6b 73  egy.  that works
5a80: 20 63 6f 72 72 65 63 74 6c 79 20 66 6f 72 20 74   correctly for t
5a90: 68 61 74 20 66 69 6c 65 73 79 73 74 65 6d 20 74  hat filesystem t
5aa0: 79 70 65 2e 20 46 69 76 65 20 6c 6f 63 6b 69 6e  ype. Five lockin
5ab0: 67 20 73 74 72 61 74 65 67 69 65 73 20 0a 20 20  g strategies .  
5ac0: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 3a 0a 0a  are available:..
5ad0: 20 20 3c 75 6c 3e 0a 20 20 20 20 3c 6c 69 3e 20    <ul>.    <li> 
5ae0: 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20 73 74  POSIX locking st
5af0: 79 6c 65 2e 20 54 68 69 73 20 69 73 20 74 68 65  yle. This is the
5b00: 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67   default locking
5b10: 20 73 74 79 6c 65 20 61 6e 64 20 74 68 65 0a 20   style and the. 
5b20: 20 20 20 20 20 20 20 20 73 74 79 6c 65 20 75 73          style us
5b30: 65 64 20 62 79 20 6f 74 68 65 72 20 28 6e 6f 6e  ed by other (non
5b40: 20 4d 61 63 20 4f 53 20 58 29 20 55 6e 69 78 65   Mac OS X) Unixe
5b50: 73 2e 20 4c 6f 63 6b 73 20 61 72 65 20 6f 62 74  s. Locks are obt
5b60: 61 69 6e 65 64 20 61 6e 64 20 0a 20 20 20 20 20  ained and .     
5b70: 20 20 20 20 72 65 6c 65 61 73 65 64 20 75 73 69      released usi
5b80: 6e 67 20 74 68 65 20 66 63 6e 74 6c 28 29 20 73  ng the fcntl() s
5b90: 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20 20  ystem call...   
5ba0: 20 3c 6c 69 3e 20 41 46 50 20 6c 6f 63 6b 69 6e   <li> AFP lockin
5bb0: 67 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c 6f  g style. This lo
5bc0: 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75  cking style is u
5bd0: 73 65 64 20 66 6f 72 20 6e 65 74 77 6f 72 6b 20  sed for network 
5be0: 66 69 6c 65 20 0a 20 20 20 20 20 20 20 20 20 73  file .         s
5bf0: 79 73 74 65 6d 73 20 74 68 61 74 20 75 73 65 20  ystems that use 
5c00: 74 68 65 20 41 46 50 20 28 41 70 70 6c 65 20 46  the AFP (Apple F
5c10: 69 6c 69 6e 67 20 50 72 6f 74 6f 63 6f 6c 29 20  iling Protocol) 
5c20: 70 72 6f 74 6f 63 6f 6c 2e 20 4c 6f 63 6b 73 0a  protocol. Locks.
5c30: 20 20 20 20 20 20 20 20 20 61 72 65 20 6f 62 74           are obt
5c40: 61 69 6e 65 64 20 62 79 20 63 61 6c 6c 69 6e 67  ained by calling
5c50: 20 74 68 65 20 6c 69 62 72 61 72 79 20 66 75 6e   the library fun
5c60: 63 74 69 6f 6e 20 5f 41 46 50 46 53 53 65 74 4c  ction _AFPFSSetL
5c70: 6f 63 6b 28 29 2e 0a 0a 20 20 20 20 3c 6c 69 3e  ock()...    <li>
5c80: 20 46 6c 6f 63 6b 20 6c 6f 63 6b 69 6e 67 20 73   Flock locking s
5c90: 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 75 73  tyle. This is us
5ca0: 65 64 20 66 6f 72 20 66 69 6c 65 2d 73 79 73 74  ed for file-syst
5cb0: 65 6d 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 0a  ems that do not.
5cc0: 20 20 20 20 20 20 20 20 20 73 75 70 70 6f 72 74           support
5cd0: 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 20 73   POSIX locking s
5ce0: 74 79 6c 65 2e 20 4c 6f 63 6b 73 20 61 72 65 20  tyle. Locks are 
5cf0: 6f 62 74 61 69 6e 65 64 20 61 6e 64 20 72 65 6c  obtained and rel
5d00: 65 61 73 65 64 20 75 73 69 6e 67 0a 20 20 20 20  eased using.    
5d10: 20 20 20 20 20 74 68 65 20 66 6c 6f 63 6b 28 29       the flock()
5d20: 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20   system call... 
5d30: 20 20 20 3c 6c 69 3e 20 44 6f 74 2d 66 69 6c 65     <li> Dot-file
5d40: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20   locking style. 
5d50: 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74 79  This locking sty
5d60: 6c 65 20 69 73 20 75 73 65 64 20 77 68 65 6e 20  le is used when 
5d70: 6e 65 69 74 68 65 72 0a 20 20 20 20 20 20 20 20  neither.        
5d80: 20 66 6c 6f 63 6b 20 6e 6f 72 20 50 4f 53 49 58   flock nor POSIX
5d90: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 73 20   locking styles 
5da0: 61 72 65 20 73 75 70 70 6f 72 74 65 64 20 62 79  are supported by
5db0: 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d   the file system
5dc0: 2e 0a 20 20 20 20 20 20 20 20 20 44 61 74 61 62  ..         Datab
5dd0: 61 73 65 20 6c 6f 63 6b 73 20 61 72 65 20 6f 62  ase locks are ob
5de0: 74 61 69 6e 65 64 20 62 79 20 63 72 65 61 74 69  tained by creati
5df0: 6e 67 20 61 6e 64 20 65 6e 74 72 79 20 69 6e 20  ng and entry in 
5e00: 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 0a  the file-system.
5e10: 20 20 20 20 20 20 20 20 20 61 74 20 61 20 77 65           at a we
5e20: 6c 6c 2d 6b 6e 6f 77 6e 20 6c 6f 63 61 74 69 6f  ll-known locatio
5e30: 6e 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74 68  n relative to th
5e40: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
5e50: 28 61 20 22 64 6f 74 2d 66 69 6c 65 22 29 0a 20  (a "dot-file"). 
5e60: 20 20 20 20 20 20 20 20 61 6e 64 20 72 65 6c 69          and reli
5e70: 6e 71 75 69 73 68 65 64 20 62 79 20 64 65 6c 65  nquished by dele
5e80: 74 69 6e 67 20 74 68 65 20 73 61 6d 65 20 66 69  ting the same fi
5e90: 6c 65 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 4e 6f  le...    <li> No
5ea0: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20   locking style. 
5eb0: 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 61  If none of the a
5ec0: 62 6f 76 65 20 63 61 6e 20 62 65 20 73 75 70 70  bove can be supp
5ed0: 6f 72 74 65 64 2c 20 74 68 69 73 20 0a 20 20 20  orted, this .   
5ee0: 20 20 20 20 20 20 6c 6f 63 6b 69 6e 67 20 73 74        locking st
5ef0: 79 6c 65 20 69 73 20 75 73 65 64 2e 20 4e 6f 20  yle is used. No 
5f00: 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 69 6e 67  database locking
5f10: 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 75 73   mechanism is us
5f20: 65 64 2e 20 57 68 65 6e 0a 20 20 20 20 20 20 20  ed. When.       
5f30: 20 20 74 68 69 73 20 73 79 73 74 65 6d 20 69 73    this system is
5f40: 20 75 73 65 64 20 69 74 20 69 73 20 6e 6f 74 20   used it is not 
5f50: 73 61 66 65 20 66 6f 72 20 61 20 73 69 6e 67 6c  safe for a singl
5f60: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 62 65  e database to be
5f70: 0a 20 20 20 20 20 20 20 20 20 61 63 63 65 73 73  .         access
5f80: 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20 63  ed by multiple c
5f90: 6c 69 65 6e 74 73 2e 0a 20 20 3c 2f 75 6c 3e 0a  lients..  </ul>.
5fa0: 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c  .  Additionally,
5fb0: 20 66 69 76 65 20 65 78 74 72 61 20 5b 56 46 53   five extra [VFS
5fc0: 5d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  ] implementation
5fd0: 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 20 61  s are provided a
5fe0: 73 20 77 65 6c 6c 20 61 73 20 74 68 65 0a 20 20  s well as the.  
5ff0: 64 65 66 61 75 6c 74 2e 20 42 79 20 73 70 65 63  default. By spec
6000: 69 66 79 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68  ifying one of th
6010: 65 20 65 78 74 72 61 20 56 46 53 20 69 6d 70 6c  e extra VFS impl
6020: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 0a 20 20 77  ementations .  w
6030: 68 65 6e 20 63 61 6c 6c 69 6e 67 20 5b 73 71 6c  hen calling [sql
6040: 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c  ite3_open_v2()],
6050: 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20   an application 
6060: 6d 61 79 20 62 79 70 61 73 73 20 74 68 65 20 66  may bypass the f
6070: 69 6c 65 2d 73 79 73 74 65 6d 0a 20 20 64 65 74  ile-system.  det
6080: 65 63 74 69 6f 6e 20 6c 6f 67 69 63 20 61 6e 64  ection logic and
6090: 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 6c 65   explicitly sele
60a0: 63 74 20 6f 6e 65 20 6f 66 20 74 68 65 20 61 62  ct one of the ab
60b0: 6f 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c  ove locking styl
60c0: 65 73 2e 20 54 68 65 0a 20 20 66 69 76 65 20 65  es. The.  five e
60d0: 78 74 72 61 20 5b 56 46 53 5d 20 69 6d 70 6c 65  xtra [VFS] imple
60e0: 6d 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 63  mentations are c
60f0: 61 6c 6c 65 64 20 22 75 6e 69 78 2d 70 6f 73 69  alled "unix-posi
6100: 78 22 2c 20 22 75 6e 69 78 2d 61 66 70 22 2c 0a  x", "unix-afp",.
6110: 20 20 22 75 6e 69 78 2d 66 6c 6f 63 6b 22 2c 20    "unix-flock", 
6120: 22 75 6e 69 78 2d 64 6f 74 66 69 6c 65 22 20 61  "unix-dotfile" a
6130: 6e 64 20 22 75 6e 69 78 2d 6e 6f 6e 65 22 2e 0a  nd "unix-none"..
6140: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
6150: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
6160: 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45  _MEMORY_MANAGEME
6170: 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  NT} {.  This opt
6180: 69 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20 6c  ion adds extra l
6190: 6f 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20 74  ogic to SQLite t
61a0: 68 61 74 20 61 6c 6c 6f 77 73 20 69 74 20 74 6f  hat allows it to
61b0: 20 72 65 6c 65 61 73 65 20 75 6e 75 73 65 64 0a   release unused.
61c0: 20 20 6d 65 6d 6f 72 79 20 75 70 6f 6e 20 72 65    memory upon re
61d0: 71 75 65 73 74 2e 20 20 54 68 69 73 20 6f 70 74  quest.  This opt
61e0: 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 6e 61 62  ion must be enab
61f0: 6c 65 64 20 69 6e 20 6f 72 64 65 72 20 66 6f 72  led in order for
6200: 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f   the.  [sqlite3_
6210: 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29  release_memory()
6220: 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 77  ] interface to w
6230: 6f 72 6b 2e 20 20 49 66 20 74 68 69 73 20 63 6f  ork.  If this co
6240: 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70 74  mpile-time.  opt
6250: 69 6f 6e 20 69 73 20 6e 6f 74 20 75 73 65 64 2c  ion is not used,
6260: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72 65   the [sqlite3_re
6270: 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d 20  lease_memory()] 
6280: 69 6e 74 65 72 66 61 63 65 20 69 73 20 61 20 0a  interface is a .
6290: 20 20 6e 6f 2d 6f 70 2e 0a 7d 0a 0a 43 4f 4d 50    no-op..}..COMP
62a0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
62b0: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53  TE_ENABLE_MEMSYS
62c0: 33 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  3} {.  This opti
62d0: 6f 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f 64 65  on includes code
62e0: 20 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74 20   in SQLite that 
62f0: 69 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 61 6c  implements an al
6300: 74 65 72 6e 61 74 69 76 65 0a 20 20 6d 65 6d 6f  ternative.  memo
6310: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20 20 54  ry allocator.  T
6320: 68 69 73 20 61 6c 74 65 72 6e 61 74 69 76 65 20  his alternative 
6330: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
6340: 20 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67 65 64   is only engaged
6350: 0a 20 20 77 68 65 6e 20 74 68 65 20 5b 53 51 4c  .  when the [SQL
6360: 49 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 5d  ITE_CONFIG_HEAP]
6370: 20 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71 6c 69   option to [sqli
6380: 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69 73  te3_config()] is
6390: 20 75 73 65 64 20 74 6f 0a 20 20 73 75 70 70 6c   used to.  suppl
63a0: 79 20 61 20 6c 61 72 67 65 20 63 68 75 6e 6b 20  y a large chunk 
63b0: 6f 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 77  of memory from w
63c0: 68 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72 79 20  hich all memory 
63d0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 0a  allocations are.
63e0: 20 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65 20 4d    taken..  The M
63f0: 45 4d 53 59 53 33 20 6d 65 6d 6f 72 79 20 61 6c  EMSYS3 memory al
6400: 6c 6f 63 61 74 6f 72 20 75 73 65 73 20 61 20 68  locator uses a h
6410: 79 62 72 69 64 20 61 6c 6c 6f 63 61 74 69 6f 6e  ybrid allocation
6420: 20 61 6c 67 6f 72 69 74 68 6d 20 0a 20 20 70 61   algorithm .  pa
6430: 74 74 65 72 6e 65 64 20 61 66 74 65 72 20 64 6c  tterned after dl
6440: 6d 61 6c 6c 6f 63 28 29 2e 20 20 20 4f 6e 6c 79  malloc().   Only
6450: 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 45   one of SQLITE_E
6460: 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 20 61 6e  NABLE_MEMSYS3 an
6470: 64 20 0a 20 20 53 51 4c 49 54 45 5f 45 4e 41 42  d .  SQLITE_ENAB
6480: 4c 45 5f 4d 45 4d 53 59 53 35 20 6d 61 79 20 62  LE_MEMSYS5 may b
6490: 65 20 65 6e 61 62 6c 65 64 20 61 74 20 6f 6e 63  e enabled at onc
64a0: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
64b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
64c0: 42 4c 45 5f 4d 45 4d 53 59 53 35 7d 20 7b 0a 20  BLE_MEMSYS5} {. 
64d0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e 63   This option inc
64e0: 6c 75 64 65 73 20 63 6f 64 65 20 69 6e 20 53 51  ludes code in SQ
64f0: 4c 69 74 65 20 74 68 61 74 20 69 6d 70 6c 65 6d  Lite that implem
6500: 65 6e 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74  ents an alternat
6510: 69 76 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c  ive.  memory all
6520: 6f 63 61 74 6f 72 2e 20 20 54 68 69 73 20 61 6c  ocator.  This al
6530: 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79  ternative memory
6540: 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f 6e   allocator is on
6550: 6c 79 20 65 6e 67 61 67 65 64 0a 20 20 77 68 65  ly engaged.  whe
6560: 6e 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f  n the [SQLITE_CO
6570: 4e 46 49 47 5f 48 45 41 50 5d 20 6f 70 74 69 6f  NFIG_HEAP] optio
6580: 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f  n to [sqlite3_co
6590: 6e 66 69 67 28 29 5d 20 69 73 20 75 73 65 64 20  nfig()] is used 
65a0: 74 6f 0a 20 20 73 75 70 70 6c 79 20 61 20 6c 61  to.  supply a la
65b0: 72 67 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65 6d  rge chunk of mem
65c0: 6f 72 79 20 66 72 6f 6d 20 77 68 69 63 68 20 61  ory from which a
65d0: 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  ll memory alloca
65e0: 74 69 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b 65  tions are.  take
65f0: 6e 2e 0a 20 20 54 68 65 20 4d 45 4d 53 59 53 35  n..  The MEMSYS5
6600: 20 6d 6f 64 75 6c 65 20 72 6f 75 6e 64 73 20 61   module rounds a
6610: 6c 6c 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 75  ll allocations u
6620: 70 20 74 6f 20 74 68 65 20 6e 65 78 74 20 70 6f  p to the next po
6630: 77 65 72 0a 20 20 6f 66 20 74 77 6f 20 61 6e 64  wer.  of two and
6640: 20 75 73 65 73 20 61 20 66 69 72 73 74 2d 66 69   uses a first-fi
6650: 74 2c 20 62 75 64 64 79 2d 61 6c 6c 6f 63 61 74  t, buddy-allocat
6660: 6f 72 20 61 6c 67 6f 72 69 74 68 6d 0a 20 20 74  or algorithm.  t
6670: 68 61 74 20 70 72 6f 76 69 64 65 73 20 73 74 72  hat provides str
6680: 6f 6e 67 20 67 75 61 72 61 6e 74 65 65 73 20 61  ong guarantees a
6690: 67 61 69 6e 73 74 20 66 72 61 67 6d 65 6e 74 61  gainst fragmenta
66a0: 74 69 6f 6e 20 61 6e 64 20 62 72 65 61 6b 64 6f  tion and breakdo
66b0: 77 6e 0a 20 20 73 75 62 6a 65 63 74 20 74 6f 20  wn.  subject to 
66c0: 63 65 72 74 61 69 6e 20 6f 70 65 72 61 74 69 6e  certain operatin
66d0: 67 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 7d  g constraints..}
66e0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
66f0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
6700: 52 54 52 45 45 7d 20 7b 0a 20 20 54 68 69 73 20  RTREE} {.  This 
6710: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51  option causes SQ
6720: 4c 69 74 65 20 74 6f 20 69 6e 63 6c 75 64 65 20  Lite to include 
6730: 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 0a  support for the.
6740: 20 20 5b 72 74 72 65 65 20 7c 20 52 2a 54 72 65    [rtree | R*Tre
6750: 65 20 69 6e 64 65 78 20 65 78 74 65 6e 73 69 6f  e index extensio
6760: 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  n]..}..COMPILE_O
6770: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 52 54  PTION {SQLITE_RT
6780: 52 45 45 5f 49 4e 54 5f 4f 4e 4c 59 7d 20 7b 0a  REE_INT_ONLY} {.
6790: 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e    If this option
67a0: 20 69 73 20 75 73 65 64 20 74 6f 67 65 74 68 65   is used togethe
67b0: 72 20 77 69 74 68 20 5b 53 51 4c 49 54 45 5f 45  r with [SQLITE_E
67c0: 4e 41 42 4c 45 5f 52 54 52 45 45 5d 20 74 68 65  NABLE_RTREE] the
67d0: 6e 20 74 68 65 0a 20 20 5b 72 74 72 65 65 20 7c  n the.  [rtree |
67e0: 20 52 2a 54 72 65 65 20 65 78 74 65 6e 73 69 6f   R*Tree extensio
67f0: 6e 5d 20 77 69 6c 6c 20 6f 6e 6c 79 20 73 74 6f  n] will only sto
6800: 72 65 20 33 32 2d 62 69 74 20 73 69 67 6e 65 64  re 32-bit signed
6810: 20 69 6e 74 65 67 65 72 0a 20 20 63 6f 6f 72 64   integer.  coord
6820: 69 6e 61 74 65 73 20 61 6e 64 20 61 6c 6c 20 69  inates and all i
6830: 6e 74 65 72 6e 61 6c 20 63 6f 6d 70 75 74 61 74  nternal computat
6840: 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 64 6f 6e  ions will be don
6850: 65 20 75 73 69 6e 67 20 69 6e 74 65 67 65 72 73  e using integers
6860: 0a 20 20 69 6e 73 74 65 61 64 20 6f 66 20 66 6c  .  instead of fl
6870: 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75 6d  oating point num
6880: 62 65 72 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  bers..}..COMPILE
6890: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
68a0: 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 7d 20 7b  ENABLE_SQLLOG} {
68b0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65  .  This option e
68c0: 6e 61 62 6c 65 73 20 65 78 74 72 61 20 63 6f 64  nables extra cod
68d0: 65 20 28 65 73 70 65 63 69 61 6c 6c 79 20 74 68  e (especially th
68e0: 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  e [SQLITE_CONFIG
68f0: 5f 53 51 4c 4c 4f 47 5d 0a 20 20 6f 70 74 69 6f  _SQLLOG].  optio
6900: 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f  n to [sqlite3_co
6910: 6e 66 69 67 28 29 5d 29 20 74 68 61 74 20 63 61  nfig()]) that ca
6920: 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72 65  n be used to cre
6930: 61 74 65 20 6c 6f 67 73 20 6f 66 20 61 6c 6c 0a  ate logs of all.
6940: 20 20 53 51 4c 69 74 65 20 70 72 6f 63 65 73 73    SQLite process
6950: 69 6e 67 20 70 65 72 66 6f 72 6d 65 64 20 62 79  ing performed by
6960: 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e   an application.
6970: 20 20 54 68 65 73 65 20 6c 6f 67 73 20 63 61 6e    These logs can
6980: 20 62 65 20 75 73 65 66 75 6c 0a 20 20 69 6e 20   be useful.  in 
6990: 64 6f 69 6e 67 20 6f 66 66 2d 6c 69 6e 65 20 61  doing off-line a
69a0: 6e 61 6c 79 73 69 73 20 6f 66 20 74 68 65 20 62  nalysis of the b
69b0: 65 68 61 76 69 6f 72 20 6f 66 20 61 6e 20 61 70  ehavior of an ap
69c0: 70 6c 69 63 61 74 69 6f 6e 2c 20 61 6e 64 20 65  plication, and e
69d0: 73 70 65 63 69 61 6c 6c 79 0a 20 20 66 6f 72 20  specially.  for 
69e0: 70 65 72 66 6f 72 6d 61 6e 63 65 20 61 6e 61 6c  performance anal
69f0: 79 73 69 73 2e 20 20 49 6e 20 6f 72 64 65 72 20  ysis.  In order 
6a00: 66 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f 45  for the SQLITE_E
6a10: 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70 74  NABLE_SQLLOG opt
6a20: 69 6f 6e 20 74 6f 20 0a 20 20 62 65 20 75 73 65  ion to .  be use
6a30: 66 75 6c 2c 20 73 6f 6d 65 20 65 78 74 72 61 20  ful, some extra 
6a40: 63 6f 64 65 20 69 73 20 72 65 71 75 69 72 65 64  code is required
6a50: 2e 20 20 54 68 65 20 0a 20 20 3c 61 20 68 72 65  .  The .  <a hre
6a60: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71  f="http://www.sq
6a70: 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 64 6f 63  lite.org/src/doc
6a80: 2f 74 72 75 6e 6b 2f 73 72 63 2f 74 65 73 74 5f  /trunk/src/test_
6a90: 73 71 6c 6c 6f 67 2e 63 22 3e 22 74 65 73 74 5f  sqllog.c">"test_
6aa0: 73 71 6c 6c 6f 67 2e 63 22 3c 2f 61 3e 0a 20 20  sqllog.c"</a>.  
6ab0: 73 6f 75 72 63 65 20 63 6f 64 65 0a 20 20 66 69  source code.  fi
6ac0: 6c 65 20 69 6e 20 74 68 65 20 53 51 4c 69 74 65  le in the SQLite
6ad0: 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 20   source tree is 
6ae0: 61 20 77 6f 72 6b 69 6e 67 20 65 78 61 6d 70 6c  a working exampl
6af0: 65 20 6f 66 20 74 68 65 20 72 65 71 75 69 72 65  e of the require
6b00: 64 20 65 78 74 72 61 0a 20 20 63 6f 64 65 2e 20  d extra.  code. 
6b10: 20 4f 6e 20 75 6e 69 78 20 61 6e 64 20 77 69 6e   On unix and win
6b20: 64 6f 77 73 20 73 79 73 74 65 6d 73 2c 20 61 20  dows systems, a 
6b30: 64 65 76 65 6c 6f 70 65 72 20 63 61 6e 20 61 70  developer can ap
6b40: 70 65 6e 64 20 74 68 65 20 74 65 78 74 20 6f 66  pend the text of
6b50: 20 74 68 65 0a 20 20 22 74 65 73 74 5f 73 71 6c   the.  "test_sql
6b60: 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65 20 63 6f  log.c" source co
6b70: 64 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20 65  de file to the e
6b80: 6e 64 20 6f 66 20 61 6e 20 22 73 71 6c 69 74 65  nd of an "sqlite
6b90: 33 2e 63 22 20 61 6d 61 6c 67 61 6d 61 74 69 6f  3.c" amalgamatio
6ba0: 6e 2c 0a 20 20 72 65 63 6f 6d 70 69 6c 65 20 74  n,.  recompile t
6bb0: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 75  he application u
6bc0: 73 69 6e 67 20 74 68 65 20 2d 44 53 51 4c 49 54  sing the -DSQLIT
6bd0: 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 20  E_ENABLE_SQLLOG 
6be0: 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 0a 20 20  option, then .  
6bf0: 63 6f 6e 74 72 6f 6c 20 6c 6f 67 67 69 6e 67 20  control logging 
6c00: 75 73 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65 6e  using environmen
6c10: 74 20 76 61 72 69 61 62 6c 65 73 2e 20 20 53 65  t variables.  Se
6c20: 65 20 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d  e the header com
6c30: 6d 65 6e 74 20 6f 6e 20 0a 20 20 74 68 65 20 22  ment on .  the "
6c40: 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63 22 20 73  test_sqllog.c" s
6c50: 6f 75 72 63 65 20 66 69 6c 65 20 66 6f 72 20 61  ource file for a
6c60: 64 64 69 74 69 6f 6e 61 6c 20 64 65 74 61 69 6c  dditional detail
6c70: 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  .  .}..COMPILE_O
6c80: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
6c90: 41 42 4c 45 5f 53 54 41 54 32 7d 20 7b 0a 20 20  ABLE_STAT2} {.  
6ca0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 75 73 65 64  This option used
6cb0: 20 74 6f 20 63 61 75 73 65 20 74 68 65 20 5b 41   to cause the [A
6cc0: 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20  NALYZE] command 
6cd0: 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20 69 6e 64  to collect.  ind
6ce0: 65 78 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74  ex histogram dat
6cf0: 61 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c 69  a in the <b>sqli
6d00: 74 65 5f 73 74 61 74 32 3c 2f 62 3e 20 74 61 62  te_stat2</b> tab
6d10: 6c 65 2e 20 20 42 75 74 20 74 68 61 74 0a 20 20  le.  But that.  
6d20: 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 77 61  functionality wa
6d30: 73 20 73 75 70 65 72 63 65 64 65 64 20 62 79 20  s superceded by 
6d40: 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53  [SQLITE_ENABLE_S
6d50: 54 41 54 33 5d 20 61 73 20 6f 66 0a 20 20 53 51  TAT3] as of.  SQ
6d60: 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 37  Lite version 3.7
6d70: 2e 39 2e 20 20 54 68 65 20 53 51 4c 49 54 45 5f  .9.  The SQLITE_
6d80: 45 4e 41 42 4c 45 5f 53 54 41 54 32 20 63 6f 6d  ENABLE_STAT2 com
6d90: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
6da0: 0a 20 20 69 73 20 6e 6f 77 20 61 20 6e 6f 2d 6f  .  is now a no-o
6db0: 70 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  p..}..COMPILE_OP
6dc0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
6dd0: 42 4c 45 5f 53 54 41 54 33 7d 20 7b 0a 20 20 54  BLE_STAT3} {.  T
6de0: 68 69 73 20 6f 70 74 69 6f 6e 20 61 64 64 73 20  his option adds 
6df0: 61 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63  additional logic
6e00: 20 74 6f 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45   to the [ANALYZE
6e10: 5d 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74 6f  ] command and to
6e20: 0a 20 20 74 68 65 20 5b 71 75 65 72 79 20 70 6c  .  the [query pl
6e30: 61 6e 6e 65 72 5d 20 74 68 61 74 20 63 61 6e 20  anner] that can 
6e40: 68 65 6c 70 20 53 51 4c 69 74 65 20 74 6f 20 63  help SQLite to c
6e50: 68 6f 73 65 20 61 20 62 65 74 74 65 72 20 71 75  hose a better qu
6e60: 65 72 79 20 70 6c 61 6e 0a 20 20 75 6e 64 65 72  ery plan.  under
6e70: 20 63 65 72 74 61 69 6e 20 73 69 74 75 61 74 69   certain situati
6e80: 6f 6e 73 2e 20 20 54 68 65 20 5b 41 4e 41 4c 59  ons.  The [ANALY
6e90: 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65  ZE] command is e
6ea0: 6e 68 61 6e 63 65 64 20 74 6f 20 63 6f 6c 6c 65  nhanced to colle
6eb0: 63 74 0a 20 20 68 69 73 74 6f 67 72 61 6d 20 64  ct.  histogram d
6ec0: 61 74 61 20 66 72 6f 6d 20 74 68 65 20 6c 65 66  ata from the lef
6ed0: 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f 66  t-most column of
6ee0: 20 65 61 63 68 20 69 6e 64 65 78 20 61 6e 64 20   each index and 
6ef0: 73 74 6f 72 65 20 74 68 61 74 20 64 61 74 61 0a  store that data.
6f00: 20 20 69 6e 20 74 68 65 20 5b 73 71 6c 69 74 65    in the [sqlite
6f10: 5f 73 74 61 74 33 5d 20 74 61 62 6c 65 2e 20 20  _stat3] table.  
6f20: 54 68 65 20 71 75 65 72 79 20 70 6c 61 6e 6e 65  The query planne
6f30: 72 20 77 69 6c 6c 20 74 68 65 6e 20 75 73 65 20  r will then use 
6f40: 74 68 65 0a 20 20 68 69 73 74 6f 67 72 61 6d 20  the.  histogram 
6f50: 64 61 74 61 20 74 6f 20 68 65 6c 70 20 69 74 20  data to help it 
6f60: 6d 61 6b 65 20 62 65 74 74 65 72 20 69 6e 64 65  make better inde
6f70: 78 20 63 68 6f 69 63 65 73 2e 20 20 4e 6f 74 65  x choices.  Note
6f80: 2c 20 68 6f 77 65 76 65 72 2c 0a 20 20 74 68 61  , however,.  tha
6f90: 74 20 74 68 65 20 75 73 65 20 6f 66 20 68 69 73  t the use of his
6fa0: 74 6f 67 72 61 6d 20 64 61 74 61 20 69 6e 20 71  togram data in q
6fb0: 75 65 72 79 20 70 6c 61 6e 6e 65 72 20 76 69 6f  uery planner vio
6fc0: 6c 61 74 65 73 20 74 68 65 0a 20 20 5b 71 75 65  lates the.  [que
6fd0: 72 79 20 70 6c 61 6e 6e 65 72 20 73 74 61 62 69  ry planner stabi
6fe0: 6c 69 74 79 20 67 75 61 72 61 6e 74 65 65 5d 20  lity guarantee] 
6ff0: 77 68 69 63 68 20 69 73 20 69 6d 70 6f 72 74 61  which is importa
7000: 6e 74 20 74 6f 20 73 6f 6d 65 20 61 70 70 6c 69  nt to some appli
7010: 63 61 74 69 6f 6e 73 2e 0a 20 20 3c 70 3e 0a 7d  cations..  <p>.}
7020: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
7030: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
7040: 53 54 41 54 34 7d 20 7b 0a 20 20 54 68 69 73 20  STAT4} {.  This 
7050: 6f 70 74 69 6f 6e 20 61 64 64 73 20 61 64 64 69  option adds addi
7060: 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 74 6f 20  tional logic to 
7070: 74 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f  the [ANALYZE] co
7080: 6d 6d 61 6e 64 20 61 6e 64 20 74 6f 0a 20 20 74  mmand and to.  t
7090: 68 65 20 5b 71 75 65 72 79 20 70 6c 61 6e 6e 65  he [query planne
70a0: 72 5d 20 74 68 61 74 20 63 61 6e 20 68 65 6c 70  r] that can help
70b0: 20 53 51 4c 69 74 65 20 74 6f 20 63 68 6f 73 65   SQLite to chose
70c0: 20 61 20 62 65 74 74 65 72 20 71 75 65 72 79 20   a better query 
70d0: 70 6c 61 6e 0a 20 20 75 6e 64 65 72 20 63 65 72  plan.  under cer
70e0: 74 61 69 6e 20 73 69 74 75 61 74 69 6f 6e 73 2e  tain situations.
70f0: 20 20 54 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20    The [ANALYZE] 
7100: 63 6f 6d 6d 61 6e 64 20 69 73 20 65 6e 68 61 6e  command is enhan
7110: 63 65 64 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20  ced to collect. 
7120: 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20   histogram data 
7130: 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73  from all columns
7140: 20 6f 66 20 65 76 65 72 79 20 69 6e 64 65 78 20   of every index 
7150: 61 6e 64 20 73 74 6f 72 65 20 74 68 61 74 20 64  and store that d
7160: 61 74 61 0a 20 20 69 6e 20 74 68 65 20 5b 73 71  ata.  in the [sq
7170: 6c 69 74 65 5f 73 74 61 74 34 5d 20 74 61 62 6c  lite_stat4] tabl
7180: 65 2e 20 20 54 68 65 20 71 75 65 72 79 20 70 6c  e.  The query pl
7190: 61 6e 6e 65 72 20 77 69 6c 6c 20 74 68 65 6e 20  anner will then 
71a0: 75 73 65 20 74 68 65 0a 20 20 68 69 73 74 6f 67  use the.  histog
71b0: 72 61 6d 20 64 61 74 61 20 74 6f 20 68 65 6c 70  ram data to help
71c0: 20 69 74 20 6d 61 6b 65 20 62 65 74 74 65 72 20   it make better 
71d0: 69 6e 64 65 78 20 63 68 6f 69 63 65 73 2e 20 20  index choices.  
71e0: 54 68 65 20 64 6f 77 6e 73 69 64 65 20 6f 66 0a  The downside of.
71f0: 20 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74    this compile-t
7200: 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 74 68  ime option is th
7210: 61 74 20 69 74 20 76 69 6f 6c 61 74 65 73 20 74  at it violates t
7220: 68 65 0a 20 20 5b 71 75 65 72 79 20 70 6c 61 6e  he.  [query plan
7230: 6e 65 72 20 73 74 61 62 69 6c 69 74 79 20 67 75  ner stability gu
7240: 61 72 61 6e 74 65 65 5d 20 6d 61 6b 69 6e 67 20  arantee] making 
7250: 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75 6c  it more difficul
7260: 74 20 74 6f 20 65 6e 73 75 72 65 0a 20 20 63 6f  t to ensure.  co
7270: 6e 73 69 73 74 65 6e 74 20 70 65 72 66 6f 72 6d  nsistent perform
7280: 61 6e 63 65 20 69 6e 20 6d 61 73 73 2d 70 72 6f  ance in mass-pro
7290: 64 75 63 65 64 20 61 70 70 6c 69 63 61 74 69 6f  duced applicatio
72a0: 6e 73 2e 0a 20 20 3c 70 3e 0a 20 20 53 51 4c 49  ns..  <p>.  SQLI
72b0: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 20  TE_ENABLE_STAT4 
72c0: 69 73 20 61 6e 20 65 6e 68 61 6e 63 65 6d 65 6e  is an enhancemen
72d0: 74 20 6f 66 20 5b 53 51 4c 49 54 45 5f 45 4e 41  t of [SQLITE_ENA
72e0: 42 4c 45 5f 53 54 41 54 33 5d 2e 20 20 53 54 41  BLE_STAT3].  STA
72f0: 54 33 0a 20 20 6f 6e 6c 79 20 72 65 63 6f 72 64  T3.  only record
7300: 65 64 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74  ed histogram dat
7310: 61 20 66 6f 72 20 74 68 65 20 6c 65 66 74 2d 6d  a for the left-m
7320: 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 65 61  ost column of ea
7330: 63 68 20 69 6e 64 65 78 0a 20 20 77 68 65 72 65  ch index.  where
7340: 61 73 20 74 68 65 20 53 54 41 54 34 20 65 6e 68  as the STAT4 enh
7350: 61 6e 63 65 6d 65 6e 74 20 72 65 63 6f 72 64 73  ancement records
7360: 20 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20   histogram data 
7370: 66 72 6f 6d 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73  from all columns
7380: 0a 20 20 6f 66 20 65 61 63 68 20 69 6e 64 65 78  .  of each index
7390: 2e 0a 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f  ..  The [SQLITE_
73a0: 45 4e 41 42 4c 45 5f 53 54 41 54 33 5d 20 63 6f  ENABLE_STAT3] co
73b0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
73c0: 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 61 6e 64  n is a no-op and
73d0: 20 69 73 20 69 67 6e 6f 72 65 64 0a 20 20 69 66   is ignored.  if
73e0: 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42   the SQLITE_ENAB
73f0: 4c 45 5f 53 54 41 54 34 20 63 6f 6d 70 69 6c 65  LE_STAT4 compile
7400: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20  -time option is 
7410: 75 73 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  used..}..COMPILE
7420: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
7430: 45 4e 41 42 4c 45 5f 54 52 45 45 5f 45 58 50 4c  ENABLE_TREE_EXPL
7440: 41 49 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  AIN} {.  This op
7450: 74 69 6f 6e 20 61 64 64 73 20 73 75 70 70 6f 72  tion adds suppor
7460: 74 20 66 6f 72 20 74 68 65 20 5b 53 51 4c 49 54  t for the [SQLIT
7470: 45 5f 54 45 53 54 43 54 52 4c 5f 45 58 50 4c 41  E_TESTCTRL_EXPLA
7480: 49 4e 5f 53 54 4d 54 5d 20 74 65 73 74 2d 63 6f  IN_STMT] test-co
7490: 6e 74 72 6f 6c 0a 20 20 69 6e 20 74 68 65 20 53  ntrol.  in the S
74a0: 51 4c 69 74 65 20 63 6f 72 65 2e 20 20 57 68 65  QLite core.  Whe
74b0: 6e 20 74 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d 6c  n the [command-l
74c0: 69 6e 65 20 73 68 65 6c 6c 5d 20 69 73 20 61 6c  ine shell] is al
74d0: 73 6f 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  so compiled with
74e0: 0a 20 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20  .  this option, 
74f0: 74 68 65 20 22 2e 65 78 70 6c 61 69 6e 22 20 64  the ".explain" d
7500: 6f 74 2d 63 6f 6d 6d 61 6e 64 20 65 6e 61 62 6c  ot-command enabl
7510: 65 73 20 61 20 6d 6f 64 65 20 74 68 61 74 20 75  es a mode that u
7520: 73 65 73 20 74 68 65 0a 20 20 5b 53 51 4c 49 54  ses the.  [SQLIT
7530: 45 5f 54 45 53 54 43 54 52 4c 5f 45 58 50 4c 41  E_TESTCTRL_EXPLA
7540: 49 4e 5f 53 54 4d 54 5d 20 69 6e 74 65 72 66 61  IN_STMT] interfa
7550: 63 65 20 74 6f 20 64 69 73 70 6c 61 79 20 61 6e  ce to display an
7560: 20 41 53 43 49 49 2d 61 72 74 20 64 69 61 67 72   ASCII-art diagr
7570: 61 6d 0a 20 20 6f 66 20 74 68 65 20 70 61 72 73  am.  of the pars
7580: 65 20 74 72 65 65 20 66 6f 72 20 65 61 63 68 20  e tree for each 
7590: 53 51 4c 20 71 75 65 72 79 20 73 74 61 74 65 6d  SQL query statem
75a0: 65 6e 74 20 74 68 61 74 20 69 73 20 72 75 6e 20  ent that is run 
75b0: 69 6e 20 74 68 65 20 73 68 65 6c 6c 2e 0a 20 20  in the shell..  
75c0: 54 68 69 73 20 6d 65 63 68 61 6e 69 73 6d 20 69  This mechanism i
75d0: 73 20 75 73 65 66 75 6c 20 66 6f 72 20 64 65 62  s useful for deb
75e0: 75 67 67 69 6e 67 20 74 68 65 20 53 51 4c 69 74  ugging the SQLit
75f0: 65 20 70 61 72 73 65 72 20 61 6e 64 20 63 6f 64  e parser and cod
7600: 65 0a 20 20 67 65 6e 65 72 61 74 6f 72 2e 20 20  e.  generator.  
7610: 54 68 69 73 20 77 68 6f 6c 65 20 6d 65 63 68 61  This whole mecha
7620: 6e 69 73 6d 20 69 73 20 68 69 67 68 6c 79 20 65  nism is highly e
7630: 78 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20  xperimental and 
7640: 63 6f 75 6c 64 20 63 68 61 6e 67 65 0a 20 20 64  could change.  d
7650: 72 61 73 74 69 63 61 6c 6c 79 20 6f 72 20 62 65  rastically or be
7660: 20 65 6c 69 6d 69 6e 61 74 65 64 20 69 6e 20 66   eliminated in f
7670: 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 6f  uture releases o
7680: 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d  f SQLite..}..COM
7690: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
76a0: 49 54 45 5f 45 4e 41 42 4c 45 5f 55 50 44 41 54  ITE_ENABLE_UPDAT
76b0: 45 5f 44 45 4c 45 54 45 5f 4c 49 4d 49 54 7d 20  E_DELETE_LIMIT} 
76c0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
76d0: 65 6e 61 62 6c 65 73 20 61 6e 20 6f 70 74 69 6f  enables an optio
76e0: 6e 61 6c 20 4f 52 44 45 52 20 42 59 20 61 6e 64  nal ORDER BY and
76f0: 20 4c 49 4d 49 54 20 63 6c 61 75 73 65 20 6f 6e   LIMIT clause on
7700: 20 0a 20 20 5b 55 50 44 41 54 45 5d 20 61 6e 64   .  [UPDATE] and
7710: 20 5b 44 45 4c 45 54 45 5d 20 73 74 61 74 65 6d   [DELETE] statem
7720: 65 6e 74 73 2e 0a 0a 20 20 3c 70 3e 49 66 20 74  ents...  <p>If t
7730: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65  his option is de
7740: 66 69 6e 65 64 2c 20 74 68 65 6e 20 69 74 20 6d  fined, then it m
7750: 75 73 74 20 61 6c 73 6f 20 62 65 20 0a 20 20 64  ust also be .  d
7760: 65 66 69 6e 65 64 20 77 68 65 6e 20 75 73 69 6e  efined when usin
7770: 67 20 74 68 65 20 27 6c 65 6d 6f 6e 27 20 74 6f  g the 'lemon' to
7780: 6f 6c 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61  ol to generate a
7790: 20 70 61 72 73 65 2e 63 0a 20 20 66 69 6c 65 2e   parse.c.  file.
77a0: 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73   Because of this
77b0: 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61  , this option ma
77c0: 79 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 77  y only be used w
77d0: 68 65 6e 20 74 68 65 20 6c 69 62 72 61 72 79 20  hen the library 
77e0: 69 73 20 62 75 69 6c 74 0a 20 20 66 72 6f 6d 20  is built.  from 
77f0: 73 6f 75 72 63 65 2c 20 6e 6f 74 20 66 72 6f 6d  source, not from
7800: 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69   the [amalgamati
7810: 6f 6e 5d 20 6f 72 20 66 72 6f 6d 20 74 68 65 20  on] or from the 
7820: 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a 20 20  collection of.  
7830: 70 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20 66  pre-packaged C f
7840: 69 6c 65 73 20 70 72 6f 76 69 64 65 64 20 66 6f  iles provided fo
7850: 72 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69 6b 65 20  r non-Unix like 
7860: 70 6c 61 74 66 6f 72 6d 73 20 6f 6e 20 74 68 65  platforms on the
7870: 20 77 65 62 73 69 74 65 2e 0a 20 20 3c 2f 70 3e   website..  </p>
7880: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
7890: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
78a0: 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 7d  E_UNLOCK_NOTIFY}
78b0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
78c0: 20 65 6e 61 62 6c 65 73 20 74 68 65 20 5b 73 71   enables the [sq
78d0: 6c 69 74 65 33 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74  lite3_unlock_not
78e0: 69 66 79 28 29 5d 20 69 6e 74 65 72 66 61 63 65  ify()] interface
78f0: 20 61 6e 64 0a 20 20 69 74 73 20 61 73 73 6f 63   and.  its assoc
7900: 69 61 74 65 64 20 66 75 6e 63 74 69 6f 6e 61 6c  iated functional
7910: 69 74 79 2e 20 20 53 65 65 20 74 68 65 20 64 6f  ity.  See the do
7920: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 69 74 6c  cumentation titl
7930: 65 64 0a 20 20 5b 55 73 69 6e 67 20 74 68 65 20  ed.  [Using the 
7940: 53 51 4c 69 74 65 20 55 6e 6c 6f 63 6b 20 4e 6f  SQLite Unlock No
7950: 74 69 66 69 63 61 74 69 6f 6e 20 46 65 61 74 75  tification Featu
7960: 72 65 5d 20 66 6f 72 20 61 64 64 69 74 69 6f 6e  re] for addition
7970: 61 6c 0a 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  al.  information
7980: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
7990: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 53 4f 55 4e  ION {SQLITE_SOUN
79a0: 44 45 58 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  DEX} {.  This op
79b0: 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 74 68 65  tion enables the
79c0: 20 5b 73 6f 75 6e 64 65 78 28 29 20 53 51 4c 20   [soundex() SQL 
79d0: 66 75 6e 63 74 69 6f 6e 5d 2e 0a 7d 0a 0a 43 4f  function]..}..CO
79e0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
79f0: 4c 49 54 45 5f 55 53 45 5f 46 43 4e 54 4c 5f 54  LITE_USE_FCNTL_T
7a00: 52 41 43 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f  RACE} {.  This o
7a10: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c  ption causes SQL
7a20: 69 74 65 20 74 6f 20 69 73 73 75 65 20 65 78 74  ite to issue ext
7a30: 72 61 20 5b 53 51 4c 49 54 45 5f 46 43 4e 54 4c  ra [SQLITE_FCNTL
7a40: 5f 54 52 41 43 45 5d 20 66 69 6c 65 20 63 6f 6e  _TRACE] file con
7a50: 74 72 6f 6c 73 0a 20 20 74 6f 20 70 72 6f 76 69  trols.  to provi
7a60: 64 65 20 73 75 70 70 6c 65 6d 65 6e 74 61 72 79  de supplementary
7a70: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 6f 20   information to 
7a80: 74 68 65 20 56 46 53 2e 20 20 54 68 65 20 22 76  the VFS.  The "v
7a90: 66 73 6c 6f 67 2e 63 22 20 65 78 74 65 6e 73 69  fslog.c" extensi
7aa0: 6f 6e 0a 20 20 6d 61 6b 65 73 20 75 73 65 20 6f  on.  makes use o
7ab0: 66 20 74 68 69 73 20 74 6f 20 70 72 6f 76 69 64  f this to provid
7ac0: 65 20 65 6e 68 61 6e 63 65 64 20 6c 6f 67 73 20  e enhanced logs 
7ad0: 6f 66 20 56 46 53 20 61 63 74 69 76 69 74 79 2e  of VFS activity.
7ae0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
7af0: 4f 4e 20 7b 59 59 54 52 41 43 4b 4d 41 58 53 54  ON {YYTRACKMAXST
7b00: 41 43 4b 44 45 50 54 48 7d 20 7b 0a 20 20 54 68  ACKDEPTH} {.  Th
7b10: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73  is option causes
7b20: 20 74 68 65 20 4c 41 4c 52 28 31 29 20 70 61 72   the LALR(1) par
7b30: 73 65 72 20 73 74 61 63 6b 20 64 65 70 74 68 20  ser stack depth 
7b40: 74 6f 20 62 65 20 74 72 61 63 6b 65 64 0a 20 20  to be tracked.  
7b50: 61 6e 64 20 72 65 70 6f 72 74 65 64 20 75 73 69  and reported usi
7b60: 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  ng the [sqlite3_
7b70: 73 74 61 74 75 73 5d 28 5b 53 51 4c 49 54 45 5f  status]([SQLITE_
7b80: 53 54 41 54 55 53 5f 50 41 52 53 45 52 5f 53 54  STATUS_PARSER_ST
7b90: 41 43 4b 5d 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65  ACK],...).  inte
7ba0: 72 66 61 63 65 2e 20 20 53 51 4c 69 74 65 27 73  rface.  SQLite's
7bb0: 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72 20   LALR(1) parser 
7bc0: 68 61 73 20 61 20 66 69 78 65 64 20 73 74 61 63  has a fixed stac
7bd0: 6b 20 64 65 70 74 68 0a 20 20 28 64 65 74 65 72  k depth.  (deter
7be0: 6d 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 6c 65  mined at compile
7bf0: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 20  -time using the 
7c00: 5b 59 59 53 54 41 43 4b 44 45 50 54 48 5d 20 6f  [YYSTACKDEPTH] o
7c10: 70 74 69 6f 6e 73 29 2e 0a 20 20 54 68 69 73 20  ptions)..  This 
7c20: 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73  option can be us
7c30: 65 64 20 74 6f 20 68 65 6c 70 20 64 65 74 65 72  ed to help deter
7c40: 6d 69 6e 65 20 69 66 20 61 6e 20 61 70 70 6c 69  mine if an appli
7c50: 63 61 74 69 6f 6e 20 69 73 0a 20 20 67 65 74 74  cation is.  gett
7c60: 69 6e 67 20 63 6c 6f 73 65 20 74 6f 20 65 78 63  ing close to exc
7c70: 65 65 64 69 6e 67 20 74 68 65 20 6d 61 78 69 6d  eeding the maxim
7c80: 75 6d 20 4c 41 4c 52 28 31 29 20 73 74 61 63 6b  um LALR(1) stack
7c90: 20 64 65 70 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e   depth..}.</tcl>
7ca0: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 64 69 73 61 62  ..<a name="disab
7cb0: 6c 65 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e  lefeatures"></a>
7cc0: 0a 3c 68 32 3e 31 2e 35 20 4f 70 74 69 6f 6e 73  .<h2>1.5 Options
7cd0: 20 54 6f 20 44 69 73 61 62 6c 65 20 46 65 61 74   To Disable Feat
7ce0: 75 72 65 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75  ures Normally Tu
7cf0: 72 6e 65 64 20 4f 6e 3c 2f 68 32 3e 0a 0a 3c 74  rned On</h2>..<t
7d00: 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  cl>.COMPILE_OPTI
7d10: 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53 41 42  ON {SQLITE_DISAB
7d20: 4c 45 5f 4c 46 53 7d 20 7b 0a 20 20 49 66 20 74  LE_LFS} {.  If t
7d30: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
7d40: 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  or macro is defi
7d50: 6e 65 64 2c 20 6c 61 72 67 65 20 66 69 6c 65 20  ned, large file 
7d60: 73 75 70 70 6f 72 74 0a 20 20 69 73 20 64 69 73  support.  is dis
7d70: 61 62 6c 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  abled..}..COMPIL
7d80: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
7d90: 5f 44 49 53 41 42 4c 45 5f 44 49 52 53 59 4e 43  _DISABLE_DIRSYNC
7da0: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 43 2d  } {.  If this C-
7db0: 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63  preprocessor mac
7dc0: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 64  ro is defined, d
7dd0: 69 72 65 63 74 6f 72 79 20 73 79 6e 63 73 0a 20  irectory syncs. 
7de0: 20 61 72 65 20 64 69 73 61 62 6c 65 64 2e 20 20   are disabled.  
7df0: 53 51 4c 69 74 65 20 74 79 70 69 63 61 6c 6c 79  SQLite typically
7e00: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 73 79 6e   attempts to syn
7e10: 63 20 74 68 65 20 70 61 72 65 6e 74 0a 20 20 64  c the parent.  d
7e20: 69 72 65 63 74 6f 72 79 20 77 68 65 6e 20 61 20  irectory when a 
7e30: 66 69 6c 65 20 69 73 20 64 65 6c 65 74 65 64 20  file is deleted 
7e40: 74 6f 20 65 6e 73 75 72 65 20 74 68 65 20 64 69  to ensure the di
7e50: 72 65 63 74 6f 72 79 0a 20 20 65 6e 74 72 69 65  rectory.  entrie
7e60: 73 20 61 72 65 20 75 70 64 61 74 65 64 20 69 6d  s are updated im
7e70: 6d 65 64 69 61 74 65 6c 79 20 6f 6e 20 64 69 73  mediately on dis
7e80: 6b 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  k..}..COMPILE_OP
7e90: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 53  TION {SQLITE_DIS
7ea0: 41 42 4c 45 5f 46 54 53 33 5f 55 4e 49 43 4f 44  ABLE_FTS3_UNICOD
7eb0: 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 43  E} {.  If this C
7ec0: 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61  -preprocessor ma
7ed0: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20  cro is defined, 
7ee0: 74 68 65 20 5b 75 6e 69 63 6f 64 65 36 31 5d 20  the [unicode61] 
7ef0: 74 6f 6b 65 6e 69 7a 65 72 0a 20 20 69 6e 20 5b  tokenizer.  in [
7f00: 46 54 53 33 5d 20 69 73 20 6f 6d 69 74 74 65 64  FTS3] is omitted
7f10: 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 20   from the build 
7f20: 61 6e 64 20 69 73 20 75 6e 61 76 61 69 6c 61 62  and is unavailab
7f30: 6c 65 20 74 6f 20 0a 20 20 61 70 70 6c 69 63 61  le to .  applica
7f40: 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  tions..}..COMPIL
7f50: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
7f60: 5f 44 49 53 41 42 4c 45 5f 46 54 53 34 5f 44 45  _DISABLE_FTS4_DE
7f70: 46 45 52 52 45 44 7d 20 7b 0a 20 20 49 66 20 74  FERRED} {.  If t
7f80: 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73  his C-preprocess
7f90: 6f 72 20 6d 61 63 72 6f 20 64 69 73 61 62 6c 65  or macro disable
7fa0: 73 20 74 68 65 20 22 64 65 66 65 72 72 65 64 20  s the "deferred 
7fb0: 74 6f 6b 65 6e 22 20 6f 70 74 69 6d 69 7a 61 74  token" optimizat
7fc0: 69 6f 6e 0a 20 20 69 6e 20 5b 46 54 53 34 5d 2e  ion.  in [FTS4].
7fd0: 20 20 54 68 65 20 22 64 65 66 65 72 72 65 64 20    The "deferred 
7fe0: 74 6f 6b 65 6e 22 20 6f 70 74 69 6d 69 7a 61 74  token" optimizat
7ff0: 69 6f 6e 20 61 76 6f 69 64 73 20 6c 6f 61 64 69  ion avoids loadi
8000: 6e 67 20 6d 61 73 73 69 76 65 0a 20 20 70 6f 73  ng massive.  pos
8010: 74 69 6e 67 20 6c 69 73 74 73 20 66 6f 72 20 74  ting lists for t
8020: 65 72 6d 73 20 74 68 61 74 20 61 72 65 20 69 6e  erms that are in
8030: 20 6d 6f 73 74 20 64 6f 63 75 6d 65 6e 74 73 20   most documents 
8040: 6f 66 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f  of the collectio
8050: 6e 0a 20 20 61 6e 64 20 69 6e 73 74 65 61 64 20  n.  and instead 
8060: 73 69 6d 70 6c 79 20 73 63 61 6e 73 20 66 6f 72  simply scans for
8070: 20 74 68 6f 73 65 20 74 6f 6b 65 6e 73 20 69 6e   those tokens in
8080: 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 20 73 6f   the document so
8090: 75 72 63 65 2e 20 20 5b 46 54 53 34 5d 0a 20 20  urce.  [FTS4].  
80a0: 73 68 6f 75 6c 64 20 67 65 74 20 65 78 61 63 74  should get exact
80b0: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 6e 73 77  ly the same answ
80c0: 65 72 20 62 6f 74 68 20 77 69 74 68 20 61 6e 64  er both with and
80d0: 20 77 69 74 68 6f 75 74 20 74 68 69 73 20 6f 70   without this op
80e0: 74 69 6d 69 7a 61 74 69 6f 6e 2e 0a 7d 0a 3c 2f  timization..}.</
80f0: 74 63 6c 3e 0a 0a 3c 74 63 6c 3e 0a 20 20 68 64  tcl>..<tcl>.  hd
8100: 5f 66 72 61 67 6d 65 6e 74 20 22 6f 6d 69 74 66  _fragment "omitf
8110: 65 61 74 75 72 65 73 22 0a 20 20 68 64 5f 6b 65  eatures".  hd_ke
8120: 79 77 6f 72 64 73 20 22 6f 6d 69 74 66 65 61 74  ywords "omitfeat
8130: 75 72 65 73 22 0a 3c 2f 74 63 6c 3e 0a 3c 68 32  ures".</tcl>.<h2
8140: 3e 31 2e 36 20 4f 70 74 69 6f 6e 73 20 54 6f 20  >1.6 Options To 
8150: 4f 6d 69 74 20 46 65 61 74 75 72 65 73 3c 2f 68  Omit Features</h
8160: 32 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f  2>..<p>The follo
8170: 77 69 6e 67 20 6f 70 74 69 6f 6e 73 20 63 61 6e  wing options can
8180: 20 62 65 20 75 73 65 64 20 74 6f 20 0a 5b 72 65   be used to .[re
8190: 6c 66 6f 6f 74 70 72 69 6e 74 20 7c 20 72 65 64  lfootprint | red
81a0: 75 63 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20  uce the size of 
81b0: 74 68 65 20 63 6f 6d 70 69 6c 65 64 20 6c 69 62  the compiled lib
81c0: 72 61 72 79 5d 0a 62 79 20 6f 6d 69 74 74 69 6e  rary].by omittin
81d0: 67 20 75 6e 75 73 65 64 20 66 65 61 74 75 72 65  g unused feature
81e0: 73 2e 20 54 68 69 73 20 69 73 20 70 72 6f 62 61  s. This is proba
81f0: 62 6c 79 20 6f 6e 6c 79 20 75 73 65 66 75 6c 0a  bly only useful.
8200: 69 6e 20 65 6d 62 65 64 64 65 64 20 73 79 73 74  in embedded syst
8210: 65 6d 73 20 77 68 65 72 65 20 73 70 61 63 65 20  ems where space 
8220: 69 73 20 65 73 70 65 63 69 61 6c 6c 79 20 74 69  is especially ti
8230: 67 68 74 2c 20 61 73 20 65 76 65 6e 20 77 69 74  ght, as even wit
8240: 68 20 61 6c 6c 0a 66 65 61 74 75 72 65 73 20 69  h all.features i
8250: 6e 63 6c 75 64 65 64 20 74 68 65 20 53 51 4c 69  ncluded the SQLi
8260: 74 65 20 6c 69 62 72 61 72 79 20 69 73 20 72 65  te library is re
8270: 6c 61 74 69 76 65 6c 79 20 73 6d 61 6c 6c 2e 20  latively small. 
8280: 44 6f 6e 27 74 20 66 6f 72 67 65 74 0a 74 6f 20  Don't forget.to 
8290: 74 65 6c 6c 20 79 6f 75 72 20 63 6f 6d 70 69 6c  tell your compil
82a0: 65 72 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66  er to optimize f
82b0: 6f 72 20 62 69 6e 61 72 79 20 73 69 7a 65 21 20  or binary size! 
82c0: 28 74 68 65 20 2d 4f 73 20 6f 70 74 69 6f 6e 20  (the -Os option 
82d0: 69 66 0a 75 73 69 6e 67 20 47 43 43 29 2e 20 20  if.using GCC).  
82e0: 54 65 6c 6c 69 6e 67 20 79 6f 75 72 20 63 6f 6d  Telling your com
82f0: 70 69 6c 65 72 20 74 6f 20 6f 70 74 69 6d 69 7a  piler to optimiz
8300: 65 20 66 6f 72 20 73 69 7a 65 20 75 73 75 61 6c  e for size usual
8310: 6c 79 20 68 61 73 0a 61 20 6d 75 63 68 20 6c 61  ly has.a much la
8320: 72 67 65 72 20 69 6d 70 61 63 74 20 6f 6e 20 6c  rger impact on l
8330: 69 62 72 61 72 79 20 66 6f 6f 74 70 72 69 6e 74  ibrary footprint
8340: 20 74 68 61 6e 20 65 6d 70 6c 6f 79 69 6e 67 20   than employing 
8350: 61 6e 79 20 6f 66 20 74 68 65 73 65 0a 63 6f 6d  any of these.com
8360: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
8370: 73 2e 20 20 59 6f 75 20 73 68 6f 75 6c 64 20 61  s.  You should a
8380: 6c 73 6f 20 76 65 72 69 66 79 20 74 68 61 74 20  lso verify that 
8390: 0a 3c 61 20 68 72 65 66 3d 22 23 64 65 62 75 67  .<a href="#debug
83a0: 6f 70 74 69 6f 6e 73 22 3e 64 65 62 75 67 67 69  options">debuggi
83b0: 6e 67 20 6f 70 74 69 6f 6e 73 3c 2f 61 3e 20 61  ng options</a> a
83c0: 72 65 20 64 69 73 61 62 6c 65 64 2e 3c 2f 70 3e  re disabled.</p>
83d0: 0a 0a 3c 70 3e 54 68 65 20 6d 61 63 72 6f 73 20  ..<p>The macros 
83e0: 69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20  in this section 
83f0: 64 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 76  do not require v
8400: 61 6c 75 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f  alues. The follo
8410: 77 69 6e 67 20 0a 63 6f 6d 70 69 6c 61 74 69 6f  wing .compilatio
8420: 6e 20 73 77 69 74 63 68 65 73 20 61 6c 6c 20 68  n switches all h
8430: 61 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 66  ave the same eff
8440: 65 63 74 3a 3c 62 72 3e 0a 2d 44 53 51 4c 49 54  ect:<br>.-DSQLIT
8450: 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c  E_OMIT_ALTERTABL
8460: 45 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f  E<br>.-DSQLITE_O
8470: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 31  MIT_ALTERTABLE=1
8480: 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d  <br>.-DSQLITE_OM
8490: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 30 0a  IT_ALTERTABLE=0.
84a0: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 6e 79 20  </p>..<p>If any 
84b0: 6f 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73  of these options
84c0: 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74 68   are defined, th
84d0: 65 6e 20 74 68 65 20 73 61 6d 65 20 73 65 74 20  en the same set 
84e0: 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a  of SQLITE_OMIT_*
84f0: 0a 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20 61 6c  .options must al
8500: 73 6f 20 62 65 20 64 65 66 69 6e 65 64 20 77 68  so be defined wh
8510: 65 6e 20 75 73 69 6e 67 20 74 68 65 20 27 6c 65  en using the 'le
8520: 6d 6f 6e 27 20 74 6f 6f 6c 20 74 6f 20 67 65 6e  mon' tool to gen
8530: 65 72 61 74 65 20 74 68 65 0a 70 61 72 73 65 2e  erate the.parse.
8540: 63 20 66 69 6c 65 20 61 6e 64 20 77 68 65 6e 20  c file and when 
8550: 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 27 6d  compiling the 'm
8560: 6b 6b 65 79 77 6f 72 64 68 61 73 68 27 20 74 6f  kkeywordhash' to
8570: 6f 6c 20 77 68 69 63 68 20 67 65 6e 65 72 61 74  ol which generat
8580: 65 73 20 0a 74 68 65 20 6b 65 79 77 6f 72 64 68  es .the keywordh
8590: 61 73 68 2e 68 20 66 69 6c 65 2e 0a 42 65 63 61  ash.h file..Beca
85a0: 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74 68 65  use of this, the
85b0: 73 65 20 6f 70 74 69 6f 6e 73 20 6d 61 79 20 6f  se options may o
85c0: 6e 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 6e  nly be used when
85d0: 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20   the library is 
85e0: 62 75 69 6c 74 0a 66 72 6f 6d 20 63 61 6e 6f 6e  built.from canon
85f0: 69 63 61 6c 20 73 6f 75 72 63 65 2c 20 6e 6f 74  ical source, not
8600: 20 66 72 6f 6d 20 74 68 65 20 5b 61 6d 61 6c 67   from the [amalg
8610: 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 66 72 6f 6d  amation] or from
8620: 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20   the collection 
8630: 6f 66 0a 70 72 65 2d 70 61 63 6b 61 67 65 64 20  of.pre-packaged 
8640: 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64 65 64  C files provided
8650: 20 66 6f 72 20 6e 6f 6e 2d 55 6e 69 78 20 6c 69   for non-Unix li
8660: 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f 6e 20  ke platforms on 
8670: 74 68 65 20 77 65 62 73 69 74 65 2e 0a 41 6e 79  the website..Any
8680: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f   SQLITE_OMIT_* o
8690: 70 74 69 6f 6e 73 20 77 68 69 63 68 20 63 61 6e  ptions which can
86a0: 20 62 65 20 75 73 65 64 20 64 69 72 65 63 74 6c   be used directl
86b0: 79 20 77 69 74 68 20 74 68 65 20 5b 61 6d 61 6c  y with the [amal
86c0: 67 61 6d 61 74 69 6f 6e 5d 20 0a 61 72 65 20 6c  gamation] .are l
86d0: 69 73 74 65 64 20 62 65 6c 6f 77 2c 20 68 6f 77  isted below, how
86e0: 65 76 65 72 2c 20 74 68 65 20 77 61 72 6e 69 6e  ever, the warnin
86f0: 67 73 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77  gs in the follow
8700: 69 6e 67 20 70 61 72 61 67 72 61 70 68 20 73 68  ing paragraph sh
8710: 6f 75 6c 64 20 62 65 20 6e 6f 74 65 64 2e 0a 3c  ould be noted..<
8720: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65  /p>..<blockquote
8730: 3e 0a 3c 69 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e  >.<i><b>Importan
8740: 74 20 4e 6f 74 65 3a 3c 2f 62 3e 20 54 68 65 20  t Note:</b> The 
8750: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f 70  SQLITE_OMIT_* op
8760: 74 69 6f 6e 73 20 64 6f 20 6e 6f 74 20 77 6f 72  tions do not wor
8770: 6b 20 77 69 74 68 20 74 68 65 0a 5b 61 6d 61 6c  k with the.[amal
8780: 67 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 77 69 74  gamation] or wit
8790: 68 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20 43  h pre-packaged C
87a0: 20 63 6f 64 65 20 66 69 6c 65 73 2e 20 20 53 51   code files.  SQ
87b0: 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70  LITE_OMIT_* comp
87c0: 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f 6e 73  ile-time.options
87d0: 20 6f 6e 6c 79 20 77 6f 72 6b 20 63 6f 72 72 65   only work corre
87e0: 63 74 6c 79 20 77 68 65 6e 20 53 51 4c 69 74 65  ctly when SQLite
87f0: 20 69 73 20 62 75 69 6c 74 20 66 72 6f 6d 20 63   is built from c
8800: 61 6e 6f 6e 69 63 61 6c 20 73 6f 75 72 63 65 20  anonical source 
8810: 66 69 6c 65 73 2e 0a 3c 2f 69 3e 0a 3c 2f 62 6c  files..</i>.</bl
8820: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 0a 3c 70 3e 53  ockquote>...<p>S
8830: 70 65 63 69 61 6c 20 76 65 72 73 69 6f 6e 73 20  pecial versions 
8840: 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 61 6d  of the SQLite am
8850: 61 6c 67 61 6d 61 74 69 6f 6e 20 74 68 61 74 20  algamation that 
8860: 64 6f 20 77 6f 72 6b 20 77 69 74 68 20 61 0a 70  do work with a.p
8870: 72 65 64 65 74 65 72 6d 69 6e 65 64 20 73 65 74  redetermined set
8880: 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   of SQLITE_OMIT_
8890: 2a 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 65  * options can be
88a0: 20 67 65 6e 65 72 61 74 65 64 2e 20 20 54 6f 20   generated.  To 
88b0: 64 6f 20 73 6f 2c 0a 6d 61 6b 65 20 61 20 63 6f  do so,.make a co
88c0: 70 79 20 6f 66 20 74 68 65 20 4d 61 6b 65 66 69  py of the Makefi
88d0: 6c 65 2e 6c 69 6e 75 78 2d 67 63 63 20 6d 61 6b  le.linux-gcc mak
88e0: 65 66 69 6c 65 20 74 65 6d 70 6c 61 74 65 20 69  efile template i
88f0: 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 0a  n the canonical.
8900: 73 6f 75 72 63 65 20 63 6f 64 65 20 64 69 73 74  source code dist
8910: 72 69 62 75 74 69 6f 6e 2e 20 20 43 68 61 6e 67  ribution.  Chang
8920: 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 79 6f  e the name of yo
8930: 75 72 20 63 6f 70 79 20 74 6f 20 73 69 6d 70 6c  ur copy to simpl
8940: 79 20 22 4d 61 6b 65 66 69 6c 65 22 2e 0a 54 68  y "Makefile"..Th
8950: 65 6e 20 65 64 69 74 20 22 4d 61 6b 65 66 69 6c  en edit "Makefil
8960: 65 22 20 74 6f 20 73 65 74 20 75 70 20 61 70 70  e" to set up app
8970: 72 6f 70 72 69 61 74 65 20 63 6f 6d 70 69 6c 65  ropriate compile
8980: 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 20 20  -time options.  
8990: 54 68 65 6e 0a 74 79 70 65 3a 0a 3c 62 6c 6f 63  Then.type:.<bloc
89a0: 6b 71 75 6f 74 65 3e 3c 74 74 3e 6d 61 6b 65 20  kquote><tt>make 
89b0: 63 6c 65 61 6e 3b 20 6d 61 6b 65 20 73 71 6c 69  clean; make sqli
89c0: 74 65 33 2e 63 3c 2f 74 74 3e 3c 2f 62 6c 6f 63  te3.c</tt></bloc
89d0: 6b 71 75 6f 74 65 3e 0a 54 68 65 20 72 65 73 75  kquote>.The resu
89e0: 6c 74 69 6e 67 20 22 73 71 6c 69 74 65 33 2e 63  lting "sqlite3.c
89f0: 22 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 63  " amalgamation c
8a00: 6f 64 65 20 66 69 6c 65 20 28 61 6e 64 20 69 74  ode file (and it
8a10: 73 20 61 73 73 6f 63 69 61 74 65 64 0a 68 65 61  s associated.hea
8a20: 64 65 72 20 66 69 6c 65 20 22 73 71 6c 69 74 65  der file "sqlite
8a30: 33 2e 68 22 29 20 63 61 6e 20 74 68 65 6e 20 62  3.h") can then b
8a40: 65 20 6d 6f 76 65 64 20 74 6f 20 61 20 6e 6f 6e  e moved to a non
8a50: 2d 75 6e 69 78 20 70 6c 61 74 66 6f 72 6d 0a 66  -unix platform.f
8a60: 6f 72 20 66 69 6e 61 6c 20 63 6f 6d 70 69 6c 61  or final compila
8a70: 74 69 6f 6e 20 75 73 69 6e 67 20 61 20 6e 61 74  tion using a nat
8a80: 69 76 65 20 63 6f 6d 70 69 6c 65 72 2e 3c 2f 70  ive compiler.</p
8a90: 3e 0a 0a 3c 70 3e 41 6c 6c 20 6f 66 20 74 68 65  >..<p>All of the
8aa0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f   SQLITE_OMIT_* o
8ab0: 70 74 69 6f 6e 73 20 61 72 65 20 75 6e 73 75 70  ptions are unsup
8ac0: 70 6f 72 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 62 6c  ported.</p>..<bl
8ad0: 6f 63 6b 71 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e  ockquote>.<i><b>
8ae0: 49 6d 70 6f 72 74 61 6e 74 20 4e 6f 74 65 3a 3c  Important Note:<
8af0: 2f 62 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 4f  /b>.The SQLITE_O
8b00: 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 69  MIT_* compile-ti
8b10: 6d 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 75  me options are u
8b20: 6e 73 75 70 70 6f 72 74 65 64 2e 0a 3c 2f 69 3e  nsupported..</i>
8b30: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c  </blockquote>..<
8b40: 70 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d  p>.The SQLITE_OM
8b50: 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  IT_* compile-tim
8b60: 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 75 73  e options are us
8b70: 75 61 6c 6c 79 20 75 6e 74 65 73 74 65 64 20 61  ually untested a
8b80: 6e 64 0a 61 72 65 20 61 6c 6d 6f 73 74 20 63 65  nd.are almost ce
8b90: 72 74 61 69 6e 6c 79 20 75 6e 74 65 73 74 65 64  rtainly untested
8ba0: 20 69 6e 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 2e   in combination.
8bb0: 0a 41 6e 79 20 6f 72 20 61 6c 6c 20 6f 66 20 74  .Any or all of t
8bc0: 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 6d 61 79  hese options may
8bd0: 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d   be removed from
8be0: 20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 75 74   the code in fut
8bf0: 75 72 65 20 72 65 6c 65 61 73 65 73 0a 61 6e 64  ure releases.and
8c00: 20 77 69 74 68 6f 75 74 20 77 61 72 6e 69 6e 67   without warning
8c10: 2e 20 20 46 6f 72 20 61 6e 79 20 70 61 72 74 69  .  For any parti
8c20: 63 75 6c 61 72 20 72 65 6c 65 61 73 65 2c 20 73  cular release, s
8c30: 6f 6d 65 20 6f 66 20 74 68 65 73 65 0a 6f 70 74  ome of these.opt
8c40: 69 6f 6e 73 20 6d 61 79 20 63 61 75 73 65 20 63  ions may cause c
8c50: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 72 20 72  ompile-time or r
8c60: 75 6e 2d 74 69 6d 65 20 66 61 69 6c 75 72 65 73  un-time failures
8c70: 2c 20 70 61 72 74 69 63 75 6c 61 72 6c 79 0a 77  , particularly.w
8c80: 68 65 6e 20 75 73 65 64 20 69 6e 20 63 6f 6d 62  hen used in comb
8c90: 69 6e 61 74 69 6f 6e 20 77 69 74 68 20 6f 74 68  ination with oth
8ca0: 65 72 20 6f 70 74 69 6f 6e 73 2e 3c 2f 70 3e 0a  er options.</p>.
8cb0: 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f  .<tcl>.COMPILE_O
8cc0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
8cd0: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 7d 20 7b  IT_ALTERTABLE} {
8ce0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
8cf0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
8d00: 74 68 65 20 0a 20 20 5b 41 4c 54 45 52 20 54 41  the .  [ALTER TA
8d10: 42 4c 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  BLE] command is 
8d20: 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20  not included in 
8d30: 74 68 65 20 0a 20 20 6c 69 62 72 61 72 79 2e 20  the .  library. 
8d40: 45 78 65 63 75 74 69 6e 67 20 61 6e 20 5b 41 4c  Executing an [AL
8d50: 54 45 52 20 54 41 42 4c 45 5d 20 73 74 61 74 65  TER TABLE] state
8d60: 6d 65 6e 74 20 63 61 75 73 65 73 20 61 20 70 61  ment causes a pa
8d70: 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  rse error..}..CO
8d80: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
8d90: 4c 49 54 45 5f 4f 4d 49 54 5f 41 4e 41 4c 59 5a  LITE_OMIT_ANALYZ
8da0: 45 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  E} {.  When this
8db0: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
8dc0: 65 64 2c 20 74 68 65 20 5b 41 4e 41 4c 59 5a 45  ed, the [ANALYZE
8dd0: 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6f 6d 69  ] command is omi
8de0: 74 74 65 64 20 66 72 6f 6d 0a 20 20 74 68 65 20  tted from.  the 
8df0: 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  build..}..COMPIL
8e00: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
8e10: 5f 4f 4d 49 54 5f 41 54 54 41 43 48 7d 20 7b 0a  _OMIT_ATTACH} {.
8e20: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
8e30: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74  on is defined, t
8e40: 68 65 20 5b 41 54 54 41 43 48 5d 20 61 6e 64 20  he [ATTACH] and 
8e50: 5b 44 45 54 41 43 48 5d 20 63 6f 6d 6d 61 6e 64  [DETACH] command
8e60: 73 20 61 72 65 0a 20 20 6f 6d 69 74 74 65 64 20  s are.  omitted 
8e70: 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 0a  from the build..
8e80: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
8e90: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
8ea0: 55 54 48 4f 52 49 5a 41 54 49 4f 4e 7d 20 7b 0a  UTHORIZATION} {.
8eb0: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
8ec0: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65  option omits the
8ed0: 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 63   authorization c
8ee0: 61 6c 6c 62 61 63 6b 20 66 65 61 74 75 72 65 20  allback feature 
8ef0: 66 72 6f 6d 20 74 68 65 0a 20 20 6c 69 62 72 61  from the.  libra
8f00: 72 79 2e 20 54 68 65 20 5b 73 71 6c 69 74 65 33  ry. The [sqlite3
8f10: 5f 73 65 74 5f 61 75 74 68 6f 72 69 7a 65 72 28  _set_authorizer(
8f20: 29 5d 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20  )] API function 
8f30: 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 0a 20  is not present. 
8f40: 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e   in the library.
8f50: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
8f60: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
8f70: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 7d 20 7b  AUTOINCREMENT} {
8f80: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69  .  This option i
8f90: 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74  s used to omit t
8fa0: 68 65 20 0a 20 20 5b 41 55 54 4f 49 4e 43 52 45  he .  [AUTOINCRE
8fb0: 4d 45 4e 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c  MENT] functional
8fc0: 69 74 79 2e 20 57 68 65 6e 20 74 68 69 73 20 0a  ity. When this .
8fd0: 20 20 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65    is macro is de
8fe0: 66 69 6e 65 64 2c 20 63 6f 6c 75 6d 6e 73 20 64  fined, columns d
8ff0: 65 63 6c 61 72 65 64 20 61 73 20 0a 20 20 22 5b  eclared as .  "[
9000: 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20  INTEGER PRIMARY 
9010: 4b 45 59 5d 20 41 55 54 4f 49 4e 43 52 45 4d 45  KEY] AUTOINCREME
9020: 4e 54 22 0a 20 20 62 65 68 61 76 65 20 69 6e 20  NT".  behave in 
9030: 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20  the same way as 
9040: 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 64  columns declared
9050: 20 61 73 20 22 5b 49 4e 54 45 47 45 52 20 50 52   as "[INTEGER PR
9060: 49 4d 41 52 59 20 4b 45 59 5d 22 20 77 68 65 6e  IMARY KEY]" when
9070: 20 61 20 0a 20 20 4e 55 4c 4c 20 69 73 20 69 6e   a .  NULL is in
9080: 73 65 72 74 65 64 2e 20 54 68 65 20 73 71 6c 69  serted. The sqli
9090: 74 65 5f 73 65 71 75 65 6e 63 65 20 73 79 73 74  te_sequence syst
90a0: 65 6d 20 74 61 62 6c 65 20 69 73 20 6e 65 69 74  em table is neit
90b0: 68 65 72 20 63 72 65 61 74 65 64 2c 20 6e 6f 72  her created, nor
90c0: 0a 20 20 72 65 73 70 65 63 74 65 64 20 69 66 20  .  respected if 
90d0: 69 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 74  it already exist
90e0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
90f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
9100: 54 5f 41 55 54 4f 49 4e 49 54 7d 20 7b 0a 20 20  T_AUTOINIT} {.  
9110: 46 6f 72 20 62 61 63 6b 77 61 72 64 73 20 63 6f  For backwards co
9120: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68  mpatibility with
9130: 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20   older versions 
9140: 6f 66 20 53 51 4c 69 74 65 20 74 68 61 74 20 6c  of SQLite that l
9150: 61 63 6b 0a 20 20 74 68 65 20 5b 73 71 6c 69 74  ack.  the [sqlit
9160: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d  e3_initialize()]
9170: 20 69 6e 74 65 72 66 61 63 65 2c 20 74 68 65 20   interface, the 
9180: 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c  [sqlite3_initial
9190: 69 7a 65 28 29 5d 20 69 6e 74 65 72 66 61 63 65  ize()] interface
91a0: 0a 20 20 69 73 20 63 61 6c 6c 65 64 20 61 75 74  .  is called aut
91b0: 6f 6d 61 74 69 63 61 6c 6c 79 20 75 70 6f 6e 20  omatically upon 
91c0: 65 6e 74 72 79 20 74 6f 20 63 65 72 74 61 69 6e  entry to certain
91d0: 20 6b 65 79 20 69 6e 74 65 72 66 61 63 65 73 20   key interfaces 
91e0: 73 75 63 68 20 61 73 0a 20 20 5b 73 71 6c 69 74  such as.  [sqlit
91f0: 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b 73 71 6c  e3_open()], [sql
9200: 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 65  ite3_vfs_registe
9210: 72 28 29 5d 2c 20 61 6e 64 20 5b 73 71 6c 69 74  r()], and [sqlit
9220: 65 33 5f 6d 70 72 69 6e 74 66 28 29 5d 2e 0a 20  e3_mprintf()].. 
9230: 20 54 68 65 20 6f 76 65 72 68 65 61 64 20 6f 66   The overhead of
9240: 20 69 6e 76 6f 6b 69 6e 67 20 5b 73 71 6c 69 74   invoking [sqlit
9250: 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d  e3_initialize()]
9260: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69   automatically i
9270: 6e 20 74 68 69 73 0a 20 20 77 61 79 20 6d 61 79  n this.  way may
9280: 20 62 65 20 6f 6d 69 74 74 65 64 20 62 79 20 62   be omitted by b
9290: 75 69 6c 64 69 6e 67 20 53 51 4c 69 74 65 20 77  uilding SQLite w
92a0: 69 74 68 20 74 68 65 20 53 51 4c 49 54 45 5f 4f  ith the SQLITE_O
92b0: 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 43  MIT_AUTOINIT.  C
92c0: 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61  -preprocessor ma
92d0: 63 72 6f 2e 20 20 57 68 65 6e 20 62 75 69 6c 74  cro.  When built
92e0: 20 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 4f 4d   using SQLITE_OM
92f0: 49 54 5f 41 55 54 4f 49 4e 49 54 2c 20 53 51 4c  IT_AUTOINIT, SQL
9300: 69 74 65 0a 20 20 77 69 6c 6c 20 6e 6f 74 20 61  ite.  will not a
9310: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 69  utomatically ini
9320: 74 69 61 6c 69 7a 65 20 69 74 73 65 6c 66 20 61  tialize itself a
9330: 6e 64 20 74 68 65 20 61 70 70 6c 69 63 61 74 69  nd the applicati
9340: 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 0a 20  on is required. 
9350: 20 74 6f 20 69 6e 76 6f 6b 65 20 5b 73 71 6c 69   to invoke [sqli
9360: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29  te3_initialize()
9370: 5d 20 64 69 72 65 63 74 6c 79 20 70 72 69 6f 72  ] directly prior
9380: 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 75 73   to beginning us
9390: 65 20 6f 66 20 74 68 65 0a 20 20 53 51 4c 69 74  e of the.  SQLit
93a0: 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f  e library..}..CO
93b0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
93c0: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 4d 41  LITE_OMIT_AUTOMA
93d0: 54 49 43 5f 49 4e 44 45 58 7d 20 7b 0a 20 20 54  TIC_INDEX} {.  T
93e0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
93f0: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a  ed to omit the .
9400: 20 20 5b 61 75 74 6f 6d 61 74 69 63 20 69 6e 64    [automatic ind
9410: 65 78 69 6e 67 5d 20 66 75 6e 63 74 69 6f 6e 61  exing] functiona
9420: 6c 69 74 79 2e 0a 20 20 53 65 65 20 61 6c 73 6f  lity..  See also
9430: 3a 20 5b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  : [SQLITE_DEFAUL
9440: 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45  T_AUTOMATIC_INDE
9450: 58 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  X]..}..COMPILE_O
9460: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
9470: 49 54 5f 41 55 54 4f 52 45 53 45 54 7d 20 7b 0a  IT_AUTORESET} {.
9480: 20 20 42 79 20 64 65 66 61 75 6c 74 2c 20 74 68    By default, th
9490: 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28  e [sqlite3_step(
94a0: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 77 69 6c  )] interface wil
94b0: 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  l automatically 
94c0: 69 6e 76 6f 6b 65 0a 20 20 5b 73 71 6c 69 74 65  invoke.  [sqlite
94d0: 33 5f 72 65 73 65 74 28 29 5d 20 74 6f 20 72 65  3_reset()] to re
94e0: 73 65 74 20 74 68 65 20 5b 70 72 65 70 61 72 65  set the [prepare
94f0: 64 20 73 74 61 74 65 6d 65 6e 74 5d 20 69 66 20  d statement] if 
9500: 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 69 73  necessary.  This
9510: 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  .  compile-time 
9520: 6f 70 74 69 6f 6e 20 63 68 61 6e 67 65 73 20 74  option changes t
9530: 68 61 74 20 62 65 68 61 76 69 6f 72 20 73 6f 20  hat behavior so 
9540: 74 68 61 74 20 5b 73 71 6c 69 74 65 33 5f 73 74  that [sqlite3_st
9550: 65 70 28 29 5d 20 77 69 6c 6c 0a 20 20 72 65 74  ep()] will.  ret
9560: 75 72 6e 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55  urn [SQLITE_MISU
9570: 53 45 5d 20 69 66 20 69 74 20 63 61 6c 6c 65 64  SE] if it called
9580: 20 61 67 61 69 6e 20 61 66 74 65 72 20 72 65 74   again after ret
9590: 75 72 6e 69 6e 67 20 61 6e 79 74 68 69 6e 67 20  urning anything 
95a0: 6f 74 68 65 72 0a 20 20 74 68 61 6e 20 5b 53 51  other.  than [SQ
95b0: 4c 49 54 45 5f 52 4f 57 5d 2c 20 5b 53 51 4c 49  LITE_ROW], [SQLI
95c0: 54 45 5f 42 55 53 59 5d 2c 20 6f 72 20 5b 53 51  TE_BUSY], or [SQ
95d0: 4c 49 54 45 5f 4c 4f 43 4b 45 44 5d 20 75 6e 6c  LITE_LOCKED] unl
95e0: 65 73 73 20 74 68 65 72 65 20 77 61 73 20 61 6e  ess there was an
95f0: 0a 20 20 69 6e 74 65 72 76 65 6e 69 6e 67 20 63  .  intervening c
9600: 61 6c 6c 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f  all to [sqlite3_
9610: 72 65 73 65 74 28 29 5d 2e 0a 0a 20 20 49 6e 20  reset()]...  In 
9620: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
9630: 2e 36 2e 32 33 2e 31 20 61 6e 64 20 65 61 72 6c  .6.23.1 and earl
9640: 69 65 72 2c 20 5b 73 71 6c 69 74 65 33 5f 73 74  ier, [sqlite3_st
9650: 65 70 28 29 5d 20 75 73 65 64 20 74 6f 20 61 6c  ep()] used to al
9660: 77 61 79 73 0a 20 20 72 65 74 75 72 6e 20 5b 53  ways.  return [S
9670: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d 20 69 66  QLITE_MISUSE] if
9680: 20 69 74 20 77 61 73 20 69 6e 76 6f 6b 65 64 20   it was invoked 
9690: 61 67 61 69 6e 20 61 66 74 65 72 20 72 65 74 75  again after retu
96a0: 72 6e 69 6e 67 20 61 6e 79 74 68 69 6e 67 0a 20  rning anything. 
96b0: 20 6f 74 68 65 72 20 74 68 61 6e 20 5b 53 51 4c   other than [SQL
96c0: 49 54 45 5f 52 4f 57 5d 20 77 69 74 68 6f 75 74  ITE_ROW] without
96d0: 20 61 6e 20 69 6e 74 65 72 76 65 6e 69 6e 67 20   an intervening 
96e0: 63 61 6c 6c 20 74 6f 20 5b 73 71 6c 69 74 65 33  call to [sqlite3
96f0: 5f 72 65 73 65 74 28 29 5d 2e 0a 20 20 54 68 69  _reset()]..  Thi
9700: 73 20 63 61 75 73 65 64 20 70 72 6f 62 6c 65 6d  s caused problem
9710: 73 20 6f 6e 20 73 6f 6d 65 20 70 6f 6f 72 6c 79  s on some poorly
9720: 20 77 72 69 74 74 65 6e 20 73 6d 61 72 74 70 68   written smartph
9730: 6f 6e 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  one applications
9740: 20 77 68 69 63 68 0a 20 20 64 69 64 20 6e 6f 74   which.  did not
9750: 20 63 6f 72 72 65 63 74 6c 79 20 68 61 6e 64 6c   correctly handl
9760: 65 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 4c 4f  e the [SQLITE_LO
9770: 43 4b 45 44 5d 20 61 6e 64 20 5b 53 51 4c 49 54  CKED] and [SQLIT
9780: 45 5f 42 55 53 59 5d 20 65 72 72 6f 72 20 0a 20  E_BUSY] error . 
9790: 20 72 65 74 75 72 6e 73 2e 20 20 52 61 74 68 65   returns.  Rathe
97a0: 72 20 74 68 61 6e 20 66 69 78 20 74 68 65 20 6d  r than fix the m
97b0: 61 6e 79 20 64 65 66 65 63 74 69 76 65 20 73 6d  any defective sm
97c0: 61 72 74 70 68 6f 6e 65 20 61 70 70 6c 69 63 61  artphone applica
97d0: 74 69 6f 6e 73 2c 20 0a 20 20 74 68 65 20 62 65  tions, .  the be
97e0: 68 61 76 69 6f 72 20 6f 66 20 53 51 4c 69 74 65  havior of SQLite
97f0: 20 77 61 73 20 63 68 61 6e 67 65 64 20 69 6e 20   was changed in 
9800: 33 2e 36 2e 32 33 2e 32 20 74 6f 20 61 75 74 6f  3.6.23.2 to auto
9810: 6d 61 74 69 63 61 6c 6c 79 20 72 65 73 65 74 0a  matically reset.
9820: 20 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73    the prepared s
9830: 74 61 74 65 6d 65 6e 74 2e 20 20 42 75 74 20 74  tatement.  But t
9840: 68 61 74 20 63 68 61 6e 67 65 64 20 63 61 75 73  hat changed caus
9850: 65 64 20 69 73 73 75 65 73 20 69 6e 20 6f 74 68  ed issues in oth
9860: 65 72 20 0a 20 20 69 6d 70 72 6f 70 65 72 6c 79  er .  improperly
9870: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 70 70   implemented app
9880: 6c 69 63 61 74 69 6f 6e 73 20 74 68 61 74 20 77  lications that w
9890: 65 72 65 20 61 63 74 75 61 6c 6c 79 20 6c 6f 6f  ere actually loo
98a0: 6b 69 6e 67 0a 20 20 66 6f 72 20 61 6e 20 5b 53  king.  for an [S
98b0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d 20 72 65  QLITE_MISUSE] re
98c0: 74 75 72 6e 20 74 6f 20 74 65 72 6d 69 6e 61 74  turn to terminat
98d0: 65 20 74 68 65 69 72 20 71 75 65 72 79 20 6c 6f  e their query lo
98e0: 6f 70 73 2e 20 20 28 41 6e 79 74 69 6d 65 0a 20  ops.  (Anytime. 
98f0: 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20   an application 
9900: 67 65 74 73 20 61 6e 20 53 51 4c 49 54 45 5f 4d  gets an SQLITE_M
9910: 49 53 55 53 45 20 65 72 72 6f 72 20 63 6f 64 65  ISUSE error code
9920: 20 66 72 6f 6d 20 53 51 4c 69 74 65 2c 20 74 68   from SQLite, th
9930: 61 74 20 6d 65 61 6e 73 20 74 68 65 0a 20 20 61  at means the.  a
9940: 70 70 6c 69 63 61 74 69 6f 6e 20 69 73 20 6d 69  pplication is mi
9950: 73 75 73 69 6e 67 20 74 68 65 20 53 51 4c 69 74  susing the SQLit
9960: 65 20 69 6e 74 65 72 66 61 63 65 20 61 6e 64 20  e interface and 
9970: 69 73 20 74 68 75 73 20 69 6e 63 6f 72 72 65 63  is thus incorrec
9980: 74 6c 79 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 65  tly.  implemente
9990: 64 2e 29 20 20 54 68 65 20 53 51 4c 49 54 45 5f  d.)  The SQLITE_
99a0: 4f 4d 49 54 5f 41 55 54 4f 52 45 53 45 54 20 69  OMIT_AUTORESET i
99b0: 6e 74 65 72 66 61 63 65 20 77 61 73 20 61 64 64  nterface was add
99c0: 65 64 20 74 6f 20 53 51 4c 69 74 65 0a 20 20 76  ed to SQLite.  v
99d0: 65 72 73 69 6f 6e 20 33 2e 37 2e 35 20 69 6e 20  ersion 3.7.5 in 
99e0: 61 6e 20 65 66 66 6f 72 74 20 74 6f 20 67 65 74  an effort to get
99f0: 20 61 6c 6c 20 6f 66 20 74 68 65 20 28 62 72 6f   all of the (bro
9a00: 6b 65 6e 29 0a 20 20 61 70 70 6c 69 63 61 74 69  ken).  applicati
9a10: 6f 6e 73 20 74 6f 20 77 6f 72 6b 20 61 67 61 69  ons to work agai
9a20: 6e 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67  n without having
9a30: 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 66 69 78   to actually fix
9a40: 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e   the application
9a50: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
9a60: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
9a70: 54 5f 41 55 54 4f 56 41 43 55 55 4d 7d 20 7b 0a  T_AUTOVACUUM} {.
9a80: 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e    If this option
9a90: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
9aa0: 20 6c 69 62 72 61 72 79 20 63 61 6e 6e 6f 74 20   library cannot 
9ab0: 63 72 65 61 74 65 20 6f 72 20 77 72 69 74 65 20  create or write 
9ac0: 74 6f 20 0a 20 20 64 61 74 61 62 61 73 65 73 20  to .  databases 
9ad0: 74 68 61 74 20 73 75 70 70 6f 72 74 20 5b 61 75  that support [au
9ae0: 74 6f 5f 76 61 63 75 75 6d 5d 2e 0a 20 20 45 78  to_vacuum]..  Ex
9af0: 65 63 75 74 69 6e 67 20 61 20 5b 50 52 41 47 4d  ecuting a [PRAGM
9b00: 41 20 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20 73  A auto_vacuum] s
9b10: 74 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f 74 20  tatement is not 
9b20: 61 6e 20 65 72 72 6f 72 0a 20 20 28 73 69 6e 63  an error.  (sinc
9b30: 65 20 75 6e 6b 6e 6f 77 6e 20 50 52 41 47 4d 41  e unknown PRAGMA
9b40: 73 20 61 72 65 20 73 69 6c 65 6e 74 6c 79 20 69  s are silently i
9b50: 67 6e 6f 72 65 64 29 2c 20 62 75 74 20 64 6f 65  gnored), but doe
9b60: 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 61 20 76  s not return a v
9b70: 61 6c 75 65 0a 20 20 6f 72 20 6d 6f 64 69 66 79  alue.  or modify
9b80: 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d   the auto-vacuum
9b90: 20 66 6c 61 67 20 69 6e 20 74 68 65 20 64 61 74   flag in the dat
9ba0: 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 20 61  abase file. If a
9bb0: 20 64 61 74 61 62 61 73 65 20 74 68 61 74 0a 20   database that. 
9bc0: 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d 76   supports auto-v
9bd0: 61 63 75 75 6d 20 69 73 20 6f 70 65 6e 65 64 20  acuum is opened 
9be0: 62 79 20 61 20 6c 69 62 72 61 72 79 20 63 6f 6d  by a library com
9bf0: 70 69 6c 65 64 20 77 69 74 68 20 74 68 69 73 20  piled with this 
9c00: 6f 70 74 69 6f 6e 2c 20 69 74 0a 20 20 69 73 20  option, it.  is 
9c10: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 70  automatically op
9c20: 65 6e 65 64 20 69 6e 20 72 65 61 64 2d 6f 6e 6c  ened in read-onl
9c30: 79 20 6d 6f 64 65 2e 0a 7d 0a 0a 43 4f 4d 50 49  y mode..}..COMPI
9c40: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
9c50: 45 5f 4f 4d 49 54 5f 42 45 54 57 45 45 4e 5f 4f  E_OMIT_BETWEEN_O
9c60: 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20  PTIMIZATION} {. 
9c70: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 69 73   This option dis
9c80: 61 62 6c 65 73 20 74 68 65 20 75 73 65 20 6f 66  ables the use of
9c90: 20 69 6e 64 69 63 65 73 20 77 69 74 68 20 57 48   indices with WH
9ca0: 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d 73  ERE clause terms
9cb0: 0a 20 20 74 68 61 74 20 65 6d 70 6c 6f 79 20 74  .  that employ t
9cc0: 68 65 20 42 45 54 57 45 45 4e 20 6f 70 65 72 61  he BETWEEN opera
9cd0: 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  tor..}..COMPILE_
9ce0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
9cf0: 4d 49 54 5f 42 4c 4f 42 5f 4c 49 54 45 52 41 4c  MIT_BLOB_LITERAL
9d00: 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20  } {.  When this 
9d10: 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65  option is define
9d20: 64 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73  d, it is not pos
9d30: 73 69 62 6c 65 20 74 6f 20 73 70 65 63 69 66 79  sible to specify
9d40: 20 61 20 62 6c 6f 62 20 69 6e 0a 20 20 61 6e 20   a blob in.  an 
9d50: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 75 73  SQL statement us
9d60: 69 6e 67 20 74 68 65 20 58 27 41 42 43 44 27 20  ing the X'ABCD' 
9d70: 73 79 6e 74 61 78 2e 0a 7d 0a 0a 43 4f 4d 50 49  syntax..}..COMPI
9d80: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
9d90: 45 5f 4f 4d 49 54 5f 42 54 52 45 45 43 4f 55 4e  E_OMIT_BTREECOUN
9da0: 54 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  T} {.  When this
9db0: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
9dc0: 65 64 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74  ed, an optimizat
9dd0: 69 6f 6e 20 74 68 61 74 20 61 63 63 65 6c 65 72  ion that acceler
9de0: 61 74 65 73 20 63 6f 75 6e 74 69 6e 67 0a 20 20  ates counting.  
9df0: 61 6c 6c 20 65 6e 74 72 69 65 73 20 69 6e 20 61  all entries in a
9e00: 20 74 61 62 6c 65 20 28 69 6e 20 6f 74 68 65 72   table (in other
9e10: 20 77 6f 72 64 73 2c 20 61 6e 20 6f 70 74 69 6d   words, an optim
9e20: 69 7a 61 74 69 6f 6e 20 74 68 61 74 20 68 65 6c  ization that hel
9e30: 70 73 0a 20 20 22 53 45 4c 45 43 54 20 63 6f 75  ps.  "SELECT cou
9e40: 6e 74 28 2a 29 20 46 52 4f 4d 20 74 61 62 6c 65  nt(*) FROM table
9e50: 22 20 72 75 6e 20 66 61 73 74 65 72 29 20 69 73  " run faster) is
9e60: 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d   omitted..}..COM
9e70: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
9e80: 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e  ITE_OMIT_BUILTIN
9e90: 5f 54 45 53 54 7d 20 7b 0a 20 20 41 20 73 74 61  _TEST} {.  A sta
9ea0: 6e 64 61 72 64 20 53 51 4c 69 74 65 20 62 75 69  ndard SQLite bui
9eb0: 6c 64 20 69 6e 63 6c 75 64 65 73 20 61 20 73 6d  ld includes a sm
9ec0: 61 6c 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f  all amount of lo
9ed0: 67 69 63 20 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20  gic controlled. 
9ee0: 20 62 79 20 74 68 65 20 5b 73 71 6c 69 74 65 33   by the [sqlite3
9ef0: 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d  _test_control()]
9f00: 20 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20   interface that 
9f10: 69 73 20 75 73 65 64 20 74 6f 20 65 78 65 72 63  is used to exerc
9f20: 69 73 65 0a 20 20 70 61 72 74 73 20 6f 66 20 74  ise.  parts of t
9f30: 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 74  he SQLite core t
9f40: 68 61 74 20 61 72 65 20 64 69 66 66 69 63 75 6c  hat are difficul
9f50: 74 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e 64  t to control and
9f60: 20 6d 65 61 73 75 72 65 20 75 73 69 6e 67 0a 20   measure using. 
9f70: 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 41 50   the standard AP
9f80: 49 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  I.  This option 
9f90: 6f 6d 69 74 73 20 74 68 61 74 20 62 75 69 6c 74  omits that built
9fa0: 2d 69 6e 20 74 65 73 74 20 6c 6f 67 69 63 2e 0a  -in test logic..
9fb0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
9fc0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43  N {SQLITE_OMIT_C
9fd0: 41 53 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  AST} {.  This op
9fe0: 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69  tion causes SQLi
9ff0: 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f  te to omit suppo
a000: 72 74 20 66 6f 72 20 74 68 65 20 43 41 53 54 20  rt for the CAST 
a010: 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d  operator..}..COM
a020: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
a030: 49 54 45 5f 4f 4d 49 54 5f 43 48 45 43 4b 7d 20  ITE_OMIT_CHECK} 
a040: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
a050: 63 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f  causes SQLite to
a060: 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f   omit support fo
a070: 72 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69  r CHECK constrai
a080: 6e 74 73 2e 0a 20 20 54 68 65 20 70 61 72 73 65  nts..  The parse
a090: 72 20 77 69 6c 6c 20 73 74 69 6c 6c 20 61 63 63  r will still acc
a0a0: 65 70 74 20 43 48 45 43 4b 20 63 6f 6e 73 74 72  ept CHECK constr
a0b0: 61 69 6e 74 73 20 69 6e 20 53 51 4c 20 73 74 61  aints in SQL sta
a0c0: 74 65 6d 65 6e 74 73 2c 0a 20 20 74 68 65 79 20  tements,.  they 
a0d0: 77 69 6c 6c 20 6a 75 73 74 20 6e 6f 74 20 62 65  will just not be
a0e0: 20 65 6e 66 6f 72 63 65 64 2e 0a 7d 0a 0a 43 4f   enforced..}..CO
a0f0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
a100: 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c  LITE_OMIT_COMPIL
a110: 45 4f 50 54 49 4f 4e 5f 44 49 41 47 53 7d 20 7b  EOPTION_DIAGS} {
a120: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69  .  This option i
a130: 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74  s used to omit t
a140: 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  he compile-time 
a150: 6f 70 74 69 6f 6e 20 64 69 61 67 6e 6f 73 74 69  option diagnosti
a160: 63 73 20 61 76 61 69 6c 61 62 6c 65 0a 20 20 69  cs available.  i
a170: 6e 20 53 51 4c 69 74 65 2c 20 69 6e 63 6c 75 64  n SQLite, includ
a180: 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33  ing the [sqlite3
a190: 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 75  _compileoption_u
a1a0: 73 65 64 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71  sed()] and.  [sq
a1b0: 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 6f 70 74  lite3_compileopt
a1c0: 69 6f 6e 5f 67 65 74 28 29 5d 20 43 2f 43 2b 2b  ion_get()] C/C++
a1d0: 20 66 75 6e 63 74 69 6f 6e 73 2c 20 74 68 65 0a   functions, the.
a1e0: 20 20 5b 73 71 6c 69 74 65 5f 63 6f 6d 70 69 6c    [sqlite_compil
a1f0: 65 6f 70 74 69 6f 6e 5f 75 73 65 64 28 29 5d 20  eoption_used()] 
a200: 61 6e 64 20 5b 73 71 6c 69 74 65 5f 63 6f 6d 70  and [sqlite_comp
a210: 69 6c 65 6f 70 74 69 6f 6e 5f 67 65 74 28 29 5d  ileoption_get()]
a220: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 2c 0a   SQL functions,.
a230: 20 20 61 6e 64 20 74 68 65 20 5b 63 6f 6d 70 69    and the [compi
a240: 6c 65 5f 6f 70 74 69 6f 6e 73 20 70 72 61 67 6d  le_options pragm
a250: 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  a]..}..COMPILE_O
a260: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a270: 49 54 5f 43 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20  IT_COMPLETE} {. 
a280: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
a290: 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65 33  ses the [sqlite3
a2a0: 5f 63 6f 6d 70 6c 65 74 65 28 29 5d 20 61 6e 64  _complete()] and
a2b0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65   [sqlite3_comple
a2c0: 74 65 31 36 28 29 5d 0a 20 20 69 6e 74 65 72 66  te16()].  interf
a2d0: 61 63 65 73 20 74 6f 20 62 65 20 6f 6d 69 74 74  aces to be omitt
a2e0: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
a2f0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a300: 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45  IT_COMPOUND_SELE
a310: 43 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  CT} {.  This opt
a320: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
a330: 6d 69 74 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64  mit the compound
a340: 20 5b 53 45 4c 45 43 54 5d 20 66 75 6e 63 74 69   [SELECT] functi
a350: 6f 6e 61 6c 69 74 79 2e 20 0a 20 20 5b 53 45 4c  onality. .  [SEL
a360: 45 43 54 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  ECT] statements 
a370: 74 68 61 74 20 75 73 65 20 74 68 65 20 0a 20 20  that use the .  
a380: 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c  UNION, UNION ALL
a390: 2c 20 49 4e 54 45 52 53 45 43 54 20 6f 72 20 45  , INTERSECT or E
a3a0: 58 43 45 50 54 20 63 6f 6d 70 6f 75 6e 64 20 53  XCEPT compound S
a3b0: 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 73 20  ELECT operators 
a3c0: 77 69 6c 6c 20 0a 20 20 63 61 75 73 65 20 61 20  will .  cause a 
a3d0: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20  parse error...  
a3e0: 41 6e 20 5b 49 4e 53 45 52 54 5d 20 73 74 61 74  An [INSERT] stat
a3f0: 65 6d 65 6e 74 20 77 69 74 68 20 6d 75 6c 74 69  ement with multi
a400: 70 6c 65 20 76 61 6c 75 65 73 20 69 6e 20 74 68  ple values in th
a410: 65 20 56 41 4c 55 45 53 20 63 6c 61 75 73 65 20  e VALUES clause 
a420: 69 73 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64  is.  implemented
a430: 20 69 6e 74 65 72 6e 61 6c 6c 79 20 61 73 20 61   internally as a
a440: 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54   compound SELECT
a450: 2e 20 20 48 65 6e 63 65 2c 20 74 68 69 73 20 6f  .  Hence, this o
a460: 70 74 69 6f 6e 20 61 6c 73 6f 0a 20 20 64 69 73  ption also.  dis
a470: 61 62 6c 65 73 20 74 68 65 20 61 62 69 6c 69 74  ables the abilit
a480: 79 20 74 6f 20 69 6e 73 65 72 74 20 6d 6f 72 65  y to insert more
a490: 20 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 72   than a single r
a4a0: 6f 77 20 75 73 69 6e 67 20 61 6e 0a 20 20 49 4e  ow using an.  IN
a4b0: 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 56 41  SERT INTO ... VA
a4c0: 4c 55 45 53 20 2e 2e 2e 20 73 74 61 74 65 6d 65  LUES ... stateme
a4d0: 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  nt..}..COMPILE_O
a4e0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
a4f0: 49 54 5f 43 54 45 7d 20 7b 0a 20 20 54 68 69 73  IT_CTE} {.  This
a500: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 73   option causes s
a510: 75 70 70 6f 72 74 20 66 6f 72 20 5b 63 6f 6d 6d  upport for [comm
a520: 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 73 73  on table express
a530: 69 6f 6e 73 5d 20 74 6f 20 62 65 20 6f 6d 69 74  ions] to be omit
a540: 74 65 64 2e 0a 7d 0a 0a 0a 0a 43 4f 4d 50 49 4c  ted..}....COMPIL
a550: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a560: 5f 4f 4d 49 54 5f 44 41 54 45 54 49 4d 45 5f 46  _OMIT_DATETIME_F
a570: 55 4e 43 53 7d 20 7b 0a 20 20 49 66 20 74 68 69  UNCS} {.  If thi
a580: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69  s option is defi
a590: 6e 65 64 2c 20 53 51 4c 69 74 65 27 73 20 62 75  ned, SQLite's bu
a5a0: 69 6c 74 2d 69 6e 20 64 61 74 65 20 61 6e 64 20  ilt-in date and 
a5b0: 74 69 6d 65 20 6d 61 6e 69 70 75 6c 61 74 69 6f  time manipulatio
a5c0: 6e 0a 20 20 66 75 6e 63 74 69 6f 6e 73 20 61 72  n.  functions ar
a5d0: 65 20 6f 6d 69 74 74 65 64 2e 20 53 70 65 63 69  e omitted. Speci
a5e0: 66 69 63 61 6c 6c 79 2c 20 74 68 65 20 53 51 4c  fically, the SQL
a5f0: 20 66 75 6e 63 74 69 6f 6e 73 20 6a 75 6c 69 61   functions julia
a600: 6e 64 61 79 28 29 2c 20 64 61 74 65 28 29 2c 0a  nday(), date(),.
a610: 20 20 74 69 6d 65 28 29 2c 20 64 61 74 65 74 69    time(), dateti
a620: 6d 65 28 29 20 61 6e 64 20 73 74 72 66 74 69 6d  me() and strftim
a630: 65 28 29 20 61 72 65 20 6e 6f 74 20 61 76 61 69  e() are not avai
a640: 6c 61 62 6c 65 2e 20 54 68 65 20 64 65 66 61 75  lable. The defau
a650: 6c 74 20 63 6f 6c 75 6d 6e 0a 20 20 76 61 6c 75  lt column.  valu
a660: 65 73 20 43 55 52 52 45 4e 54 5f 54 49 4d 45 2c  es CURRENT_TIME,
a670: 20 43 55 52 52 45 4e 54 5f 44 41 54 45 20 61 6e   CURRENT_DATE an
a680: 64 20 43 55 52 52 45 4e 54 5f 54 49 4d 45 53 54  d CURRENT_TIMEST
a690: 41 4d 50 20 61 72 65 20 73 74 69 6c 6c 20 61 76  AMP are still av
a6a0: 61 69 6c 61 62 6c 65 2e 0a 7d 0a 0a 43 4f 4d 50  ailable..}..COMP
a6b0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
a6c0: 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45  TE_OMIT_DECLTYPE
a6d0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
a6e0: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
a6f0: 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20  to omit support 
a700: 66 6f 72 20 74 68 65 0a 20 20 5b 73 71 6c 69 74  for the.  [sqlit
a710: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79  e3_column_declty
a720: 70 65 28 29 5d 20 61 6e 64 20 5b 73 71 6c 69 74  pe()] and [sqlit
a730: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79  e3_column_declty
a740: 70 65 31 36 28 29 5d 0a 20 20 69 6e 74 65 72 66  pe16()].  interf
a750: 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  aces..}..COMPILE
a760: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a770: 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 7d  OMIT_DEPRECATED}
a780: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
a790: 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20 74   causes SQLite t
a7a0: 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66  o omit support f
a7b0: 6f 72 20 69 6e 74 65 72 66 61 63 65 73 0a 20 20  or interfaces.  
a7c0: 6d 61 72 6b 65 64 20 61 73 20 64 65 70 72 65 63  marked as deprec
a7d0: 61 74 65 64 2e 20 20 54 68 69 73 20 69 6e 63 6c  ated.  This incl
a7e0: 75 64 65 73 20 0a 20 20 5b 73 71 6c 69 74 65 33  udes .  [sqlite3
a7f0: 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 75 6e 74  _aggregate_count
a800: 28 29 5d 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f  ()],.  [sqlite3_
a810: 65 78 70 69 72 65 64 28 29 5d 2c 0a 20 20 5b 73  expired()],.  [s
a820: 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72 5f  qlite3_transfer_
a830: 62 69 6e 64 69 6e 67 73 28 29 5d 2c 0a 20 20 5b  bindings()],.  [
a840: 73 71 6c 69 74 65 33 5f 67 6c 6f 62 61 6c 5f 72  sqlite3_global_r
a850: 65 63 6f 76 65 72 28 29 5d 2c 0a 20 20 5b 73 71  ecover()],.  [sq
a860: 6c 69 74 65 33 5f 74 68 72 65 61 64 5f 63 6c 65  lite3_thread_cle
a870: 61 6e 75 70 28 29 5d 20 61 6e 64 0a 20 20 5b 73  anup()] and.  [s
a880: 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 61 6c  qlite3_memory_al
a890: 61 72 6d 28 29 5d 20 69 6e 74 65 72 66 61 63 65  arm()] interface
a8a0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
a8b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
a8c0: 54 5f 44 49 53 4b 49 4f 7d 20 7b 0a 20 20 54 68  T_DISKIO} {.  Th
a8d0: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
a8e0: 61 6c 6c 20 73 75 70 70 6f 72 74 20 66 6f 72 20  all support for 
a8f0: 77 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64  writing to the d
a900: 69 73 6b 20 61 6e 64 20 66 6f 72 63 65 73 0a 20  isk and forces. 
a910: 20 64 61 74 61 62 61 73 65 73 20 74 6f 20 65 78   databases to ex
a920: 69 73 74 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 6e  ist in memory on
a930: 6c 79 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e  ly.  This option
a940: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 0a 20   has not been . 
a950: 20 6d 61 69 6e 74 61 69 6e 65 64 20 61 6e 64 20   maintained and 
a960: 70 72 6f 62 61 62 6c 79 20 64 6f 65 73 20 6e 6f  probably does no
a970: 74 20 77 6f 72 6b 20 77 69 74 68 20 6e 65 77 65  t work with newe
a980: 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51  r versions of SQ
a990: 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  Lite..}..COMPILE
a9a0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a9b0: 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 7d 20 7b 0a  OMIT_EXPLAIN} {.
a9c0: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
a9d0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68  option causes th
a9e0: 65 20 5b 45 58 50 4c 41 49 4e 5d 20 63 6f 6d 6d  e [EXPLAIN] comm
a9f0: 61 6e 64 20 74 6f 20 62 65 20 6f 6d 69 74 74 65  and to be omitte
aa00: 64 20 66 72 6f 6d 20 74 68 65 0a 20 20 6c 69 62  d from the.  lib
aa10: 72 61 72 79 2e 20 41 74 74 65 6d 70 74 69 6e 67  rary. Attempting
aa20: 20 74 6f 20 65 78 65 63 75 74 65 20 61 6e 20 5b   to execute an [
aa30: 45 58 50 4c 41 49 4e 5d 20 73 74 61 74 65 6d 65  EXPLAIN] stateme
aa40: 6e 74 20 77 69 6c 6c 20 63 61 75 73 65 20 61 20  nt will cause a 
aa50: 70 61 72 73 65 0a 20 20 65 72 72 6f 72 2e 0a 7d  parse.  error..}
aa60: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
aa70: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c   {SQLITE_OMIT_FL
aa80: 41 47 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20  AG_PRAGMAS} {.  
aa90: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
aaa0: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 61 20  s support for a 
aab0: 73 75 62 73 65 74 20 6f 66 20 5b 50 52 41 47 4d  subset of [PRAGM
aac0: 41 5d 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74  A] commands that
aad0: 0a 20 20 71 75 65 72 79 20 61 6e 64 20 73 65 74  .  query and set
aae0: 20 62 6f 6f 6c 65 61 6e 20 70 72 6f 70 65 72 74   boolean propert
aaf0: 69 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ies..}..COMPILE_
ab00: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
ab10: 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49  MIT_FLOATING_POI
ab20: 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  NT} {.  This opt
ab30: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
ab40: 6d 69 74 20 66 6c 6f 61 74 69 6e 67 2d 70 6f 69  mit floating-poi
ab50: 6e 74 20 6e 75 6d 62 65 72 20 73 75 70 70 6f 72  nt number suppor
ab60: 74 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 69 74  t from the SQLit
ab70: 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 57 68 65  e.  library. Whe
ab80: 6e 20 73 70 65 63 69 66 69 65 64 2c 20 73 70 65  n specified, spe
ab90: 63 69 66 79 69 6e 67 20 61 20 66 6c 6f 61 74 69  cifying a floati
aba0: 6e 67 20 70 6f 69 6e 74 20 6e 75 6d 62 65 72 20  ng point number 
abb0: 61 73 20 61 20 6c 69 74 65 72 61 6c 20 0a 20 20  as a literal .  
abc0: 28 69 2e 65 2e 20 22 31 2e 30 31 22 29 20 72 65  (i.e. "1.01") re
abd0: 73 75 6c 74 73 20 69 6e 20 61 20 70 61 72 73 65  sults in a parse
abe0: 20 65 72 72 6f 72 2e 0a 0a 20 20 3c 70 3e 49 6e   error...  <p>In
abf0: 20 74 68 65 20 66 75 74 75 72 65 2c 20 74 68 69   the future, thi
ac00: 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 61 6c 73  s option may als
ac10: 6f 20 64 69 73 61 62 6c 65 20 6f 74 68 65 72 20  o disable other 
ac20: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 0a  floating point .
ac30: 20 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2c    functionality,
ac40: 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65   for example the
ac50: 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74   [sqlite3_result
ac60: 5f 64 6f 75 62 6c 65 28 29 5d 2c 20 0a 20 20 5b  _double()], .  [
ac70: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75  sqlite3_bind_dou
ac80: 62 6c 65 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33  ble()], [sqlite3
ac90: 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 28 29 5d  _value_double()]
aca0: 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f   and.  [sqlite3_
acb0: 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c 65 28 29 5d  column_double()]
acc0: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 2e 0a   API functions..
acd0: 20 20 3c 2f 70 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c    </p>.}..COMPIL
ace0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
acf0: 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45  _OMIT_FOREIGN_KE
ad00: 59 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6f  Y} {.  If this o
ad10: 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64  ption is defined
ad20: 2c 20 74 68 65 6e 20 5b 66 6f 72 65 69 67 6e 20  , then [foreign 
ad30: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 5d 20  key constraint] 
ad40: 73 79 6e 74 61 78 20 69 73 0a 20 20 6e 6f 74 20  syntax is.  not 
ad50: 72 65 63 6f 67 6e 69 7a 65 64 2e 0a 7d 0a 0a 43  recognized..}..C
ad60: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
ad70: 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 45 54 5f 54  QLITE_OMIT_GET_T
ad80: 41 42 4c 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f  ABLE} {.  This o
ad90: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 73 75 70  ption causes sup
ada0: 70 6f 72 74 20 66 6f 72 20 5b 73 71 6c 69 74 65  port for [sqlite
adb0: 33 5f 67 65 74 5f 74 61 62 6c 65 28 29 5d 20 61  3_get_table()] a
adc0: 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 66 72  nd.  [sqlite3_fr
add0: 65 65 5f 74 61 62 6c 65 28 29 5d 20 74 6f 20 62  ee_table()] to b
ade0: 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f  e omitted..}..CO
adf0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
ae00: 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c  LITE_OMIT_INCRBL
ae10: 4f 42 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  OB} {.  This opt
ae20: 69 6f 6e 20 63 61 75 73 65 73 20 73 75 70 70 6f  ion causes suppo
ae30: 72 74 20 66 6f 72 20 5b 73 71 6c 69 74 65 33 5f  rt for [sqlite3_
ae40: 62 6c 6f 62 20 7c 20 69 6e 63 72 65 6d 65 6e 74  blob | increment
ae50: 61 6c 20 42 4c 4f 42 20 49 2f 4f 5d 0a 20 20 74  al BLOB I/O].  t
ae60: 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a  o be omitted..}.
ae70: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
ae80: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 54  {SQLITE_OMIT_INT
ae90: 45 47 52 49 54 59 5f 43 48 45 43 4b 7d 20 7b 0a  EGRITY_CHECK} {.
aea0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
aeb0: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  its support for 
aec0: 74 68 65 20 5b 69 6e 74 65 67 72 69 74 79 5f 63  the [integrity_c
aed0: 68 65 63 6b 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a  heck pragma]..}.
aee0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
aef0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 49 4b  {SQLITE_OMIT_LIK
af00: 45 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20  E_OPTIMIZATION} 
af10: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
af20: 64 69 73 61 62 6c 65 73 20 74 68 65 20 61 62 69  disables the abi
af30: 6c 69 74 79 20 6f 66 20 53 51 4c 69 74 65 20 74  lity of SQLite t
af40: 6f 20 75 73 65 20 69 6e 64 69 63 65 73 20 74 6f  o use indices to
af50: 20 68 65 6c 70 0a 20 20 72 65 73 6f 6c 76 65 20   help.  resolve 
af60: 5b 4c 49 4b 45 5d 20 61 6e 64 20 5b 47 4c 4f 42  [LIKE] and [GLOB
af70: 5d 20 6f 70 65 72 61 74 6f 72 73 20 69 6e 20 61  ] operators in a
af80: 20 57 48 45 52 45 20 63 6c 61 75 73 65 2e 0a 7d   WHERE clause..}
af90: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
afa0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f   {SQLITE_OMIT_LO
afb0: 41 44 5f 45 58 54 45 4e 53 49 4f 4e 7d 20 7b 0a  AD_EXTENSION} {.
afc0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
afd0: 69 74 73 20 74 68 65 20 65 6e 74 69 72 65 20 65  its the entire e
afe0: 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 69 6e 67  xtension loading
aff0: 20 6d 65 63 68 61 6e 69 73 6d 20 66 72 6f 6d 0a   mechanism from.
b000: 20 20 53 51 4c 69 74 65 2c 20 69 6e 63 6c 75 64    SQLite, includ
b010: 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 65 6e 61  ing [sqlite3_ena
b020: 62 6c 65 5f 6c 6f 61 64 5f 65 78 74 65 6e 73 69  ble_load_extensi
b030: 6f 6e 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c  on()] and.  [sql
b040: 69 74 65 33 5f 6c 6f 61 64 5f 65 78 74 65 6e 73  ite3_load_extens
b050: 69 6f 6e 28 29 5d 20 69 6e 74 65 72 66 61 63 65  ion()] interface
b060: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
b070: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
b080: 54 5f 4c 4f 43 41 4c 54 49 4d 45 7d 20 7b 0a 20  T_LOCALTIME} {. 
b090: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
b0a0: 74 73 20 74 68 65 20 22 6c 6f 63 61 6c 74 69 6d  ts the "localtim
b0b0: 65 22 20 6d 6f 64 69 66 69 65 72 20 66 72 6f 6d  e" modifier from
b0c0: 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69   the date and ti
b0d0: 6d 65 0a 20 20 66 75 6e 63 74 69 6f 6e 73 2e 20  me.  functions. 
b0e0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   This option is 
b0f0: 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 66 75 6c  sometimes useful
b100: 20 77 68 65 6e 20 74 72 79 69 6e 67 20 74 6f 20   when trying to 
b110: 63 6f 6d 70 69 6c 65 0a 20 20 74 68 65 20 64 61  compile.  the da
b120: 74 65 20 61 6e 64 20 74 69 6d 65 20 66 75 6e 63  te and time func
b130: 74 69 6f 6e 73 20 6f 6e 20 61 20 70 6c 61 74 66  tions on a platf
b140: 6f 72 6d 20 74 68 61 74 20 64 6f 65 73 20 6e 6f  orm that does no
b150: 74 20 73 75 70 70 6f 72 74 20 74 68 65 0a 20 20  t support the.  
b160: 63 6f 6e 63 65 70 74 20 6f 66 20 6c 6f 63 61 6c  concept of local
b170: 20 74 69 6d 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c   time..}..COMPIL
b180: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
b190: 5f 4f 4d 49 54 5f 4c 4f 4f 4b 41 53 49 44 45 7d  _OMIT_LOOKASIDE}
b1a0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
b1b0: 20 6f 6d 69 74 73 20 74 68 65 20 5b 6c 6f 6f 6b   omits the [look
b1c0: 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  aside memory all
b1d0: 6f 63 61 74 6f 72 5d 2e 0a 7d 0a 0a 43 4f 4d 50  ocator]..}..COMP
b1e0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
b1f0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42  TE_OMIT_MEMORYDB
b200: 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20  } {.  When this 
b210: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
b220: 6c 69 62 72 61 72 79 20 64 6f 65 73 20 6e 6f 74  library does not
b230: 20 72 65 73 70 65 63 74 20 74 68 65 20 73 70 65   respect the spe
b240: 63 69 61 6c 20 64 61 74 61 62 61 73 65 0a 20 20  cial database.  
b250: 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20  name ":memory:" 
b260: 28 6e 6f 72 6d 61 6c 6c 79 20 75 73 65 64 20 74  (normally used t
b270: 6f 20 63 72 65 61 74 65 20 61 6e 20 5b 69 6e 2d  o create an [in-
b280: 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 5d  memory database]
b290: 29 2e 20 49 66 20 0a 20 20 22 3a 6d 65 6d 6f 72  ). If .  ":memor
b2a0: 79 3a 22 20 69 73 20 70 61 73 73 65 64 20 74 6f  y:" is passed to
b2b0: 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29   [sqlite3_open()
b2c0: 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  ], [sqlite3_open
b2d0: 31 36 28 29 5d 2c 20 6f 72 0a 20 20 5b 73 71 6c  16()], or.  [sql
b2e0: 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c  ite3_open_v2()],
b2f0: 20 61 20 66 69 6c 65 20 77 69 74 68 20 74 68 69   a file with thi
b300: 73 20 6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 0a  s name will be .
b310: 20 20 6f 70 65 6e 65 64 20 6f 72 20 63 72 65 61    opened or crea
b320: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
b330: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
b340: 4d 49 54 5f 4f 52 5f 4f 50 54 49 4d 49 5a 41 54  MIT_OR_OPTIMIZAT
b350: 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ION} {.  This op
b360: 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 68  tion disables th
b370: 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53 51 4c  e ability of SQL
b380: 69 74 65 20 74 6f 20 75 73 65 20 61 6e 20 69 6e  ite to use an in
b390: 64 65 78 20 74 6f 67 65 74 68 65 72 0a 20 20 77  dex together.  w
b3a0: 69 74 68 20 74 65 72 6d 73 20 6f 66 20 61 20 57  ith terms of a W
b3b0: 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f 6e 6e  HERE clause conn
b3c0: 65 63 74 65 64 20 62 79 20 74 68 65 20 4f 52 20  ected by the OR 
b3d0: 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d  operator..}..COM
b3e0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
b3f0: 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50  ITE_OMIT_PAGER_P
b400: 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69  RAGMAS} {.  Defi
b410: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
b420: 20 6f 6d 69 74 73 20 70 72 61 67 6d 61 73 20 72   omits pragmas r
b430: 65 6c 61 74 65 64 20 74 6f 20 74 68 65 20 70 61  elated to the pa
b440: 67 65 72 20 73 75 62 73 79 73 74 65 6d 20 66 72  ger subsystem fr
b450: 6f 6d 20 0a 20 20 74 68 65 20 62 75 69 6c 64 2e  om .  the build.
b460: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b470: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b480: 50 52 41 47 4d 41 7d 20 7b 0a 20 20 54 68 69 73  PRAGMA} {.  This
b490: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20   option is used 
b4a0: 74 6f 20 6f 6d 69 74 20 74 68 65 20 5b 50 52 41  to omit the [PRA
b4b0: 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 0a 20 20 66  GMA] command.  f
b4c0: 72 6f 6d 20 74 68 65 20 6c 69 62 72 61 72 79 2e  rom the library.
b4d0: 20 4e 6f 74 65 20 74 68 61 74 20 69 74 20 69 73   Note that it is
b4e0: 20 75 73 65 66 75 6c 20 74 6f 20 64 65 66 69 6e   useful to defin
b4f0: 65 20 74 68 65 20 6d 61 63 72 6f 73 20 74 68 61  e the macros tha
b500: 74 20 6f 6d 69 74 0a 20 20 73 70 65 63 69 66 69  t omit.  specifi
b510: 63 20 70 72 61 67 6d 61 73 20 69 6e 20 61 64 64  c pragmas in add
b520: 69 74 69 6f 6e 20 74 6f 20 74 68 69 73 2c 20 61  ition to this, a
b530: 73 20 74 68 65 79 20 6d 61 79 20 61 6c 73 6f 20  s they may also 
b540: 72 65 6d 6f 76 65 20 73 75 70 70 6f 72 74 69 6e  remove supportin
b550: 67 20 63 6f 64 65 0a 20 20 69 6e 20 6f 74 68 65  g code.  in othe
b560: 72 20 73 75 62 2d 73 79 73 74 65 6d 73 2e 20 54  r sub-systems. T
b570: 68 69 73 20 6d 61 63 72 6f 20 72 65 6d 6f 76 65  his macro remove
b580: 73 20 74 68 65 20 5b 50 52 41 47 4d 41 5d 20 63  s the [PRAGMA] c
b590: 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 2e 0a 7d 0a 0a  ommand only..}..
b5a0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
b5b0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47  SQLITE_OMIT_PROG
b5c0: 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 7d 20 7b  RESS_CALLBACK} {
b5d0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d  .  This option m
b5e0: 61 79 20 62 65 20 64 65 66 69 6e 65 64 20 74 6f  ay be defined to
b5f0: 20 6f 6d 69 74 20 74 68 65 20 63 61 70 61 62 69   omit the capabi
b600: 6c 69 74 79 20 74 6f 20 69 73 73 75 65 20 22 70  lity to issue "p
b610: 72 6f 67 72 65 73 73 22 20 0a 20 20 63 61 6c 6c  rogress" .  call
b620: 62 61 63 6b 73 20 64 75 72 69 6e 67 20 6c 6f 6e  backs during lon
b630: 67 2d 72 75 6e 6e 69 6e 67 20 53 51 4c 20 73 74  g-running SQL st
b640: 61 74 65 6d 65 6e 74 73 2e 20 54 68 65 20 0a 20  atements. The . 
b650: 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65   [sqlite3_progre
b660: 73 73 5f 68 61 6e 64 6c 65 72 28 29 5d 0a 20 20  ss_handler()].  
b670: 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  API function is 
b680: 6e 6f 74 20 70 72 65 73 65 6e 74 20 69 6e 20 74  not present in t
b690: 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43  he library..}..C
b6a0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
b6b0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55 49 43 4b  QLITE_OMIT_QUICK
b6c0: 42 41 4c 41 4e 43 45 7d 20 7b 0a 20 20 54 68 69  BALANCE} {.  Thi
b6d0: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 61  s option omits a
b6e0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 2c 20 66  n alternative, f
b6f0: 61 73 74 65 72 20 42 2d 54 72 65 65 20 62 61 6c  aster B-Tree bal
b700: 61 6e 63 69 6e 67 20 72 6f 75 74 69 6e 65 2e 0a  ancing routine..
b710: 20 20 55 73 69 6e 67 20 74 68 69 73 20 6f 70 74    Using this opt
b720: 69 6f 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74 65  ion makes SQLite
b730: 20 73 6c 69 67 68 74 6c 79 20 73 6d 61 6c 6c 65   slightly smalle
b740: 72 20 61 74 20 74 68 65 20 65 78 70 65 6e 73 65  r at the expense
b750: 20 6f 66 0a 20 20 6d 61 6b 69 6e 67 20 69 74 20   of.  making it 
b760: 72 75 6e 20 73 6c 69 67 68 74 6c 79 20 73 6c 6f  run slightly slo
b770: 77 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  wer..}..COMPILE_
b780: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
b790: 4d 49 54 5f 52 45 49 4e 44 45 58 7d 20 7b 0a 20  MIT_REINDEX} {. 
b7a0: 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f   When this optio
b7b0: 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68  n is defined, th
b7c0: 65 20 5b 52 45 49 4e 44 45 58 5d 0a 20 20 63 6f  e [REINDEX].  co
b7d0: 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63  mmand is not inc
b7e0: 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6c 69 62  luded in the lib
b7f0: 72 61 72 79 2e 0a 20 20 45 78 65 63 75 74 69 6e  rary..  Executin
b800: 67 20 61 20 5b 52 45 49 4e 44 45 58 5d 20 73 74  g a [REINDEX] st
b810: 61 74 65 6d 65 6e 74 20 63 61 75 73 65 73 20 0a  atement causes .
b820: 20 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e    a parse error.
b830: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b840: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b850: 53 43 48 45 4d 41 5f 50 52 41 47 4d 41 53 7d 20  SCHEMA_PRAGMAS} 
b860: 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69  {.  Defining thi
b870: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70  s option omits p
b880: 72 61 67 6d 61 73 20 66 6f 72 20 71 75 65 72 79  ragmas for query
b890: 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65  ing the database
b8a0: 20 73 63 68 65 6d 61 20 66 72 6f 6d 20 0a 20 20   schema from .  
b8b0: 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f  the build..}..CO
b8c0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
b8d0: 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48 45 4d 41  LITE_OMIT_SCHEMA
b8e0: 5f 56 45 52 53 49 4f 4e 5f 50 52 41 47 4d 41 53  _VERSION_PRAGMAS
b8f0: 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74  } {.  Defining t
b900: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
b910: 20 70 72 61 67 6d 61 73 20 66 6f 72 20 71 75 65   pragmas for que
b920: 72 79 69 6e 67 20 61 6e 64 20 6d 6f 64 69 66 79  rying and modify
b930: 69 6e 67 20 74 68 65 20 0a 20 20 64 61 74 61 62  ing the .  datab
b940: 61 73 65 20 73 63 68 65 6d 61 20 76 65 72 73 69  ase schema versi
b950: 6f 6e 20 61 6e 64 20 75 73 65 72 20 76 65 72 73  on and user vers
b960: 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 62 75 69  ion from the bui
b970: 6c 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c 79  ld. Specifically
b980: 2c 20 74 68 65 20 0a 20 20 5b 73 63 68 65 6d 61  , the .  [schema
b990: 5f 76 65 72 73 69 6f 6e 5d 20 61 6e 64 20 5b 75  _version] and [u
b9a0: 73 65 72 5f 76 65 72 73 69 6f 6e 5d 20 50 52 41  ser_version] PRA
b9b0: 47 4d 41 73 20 61 72 65 20 6f 6d 69 74 74 65 64  GMAs are omitted
b9c0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
b9d0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
b9e0: 5f 53 48 41 52 45 44 5f 43 41 43 48 45 7d 20 7b  _SHARED_CACHE} {
b9f0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 62  .  This option b
ba00: 75 69 6c 64 73 20 53 51 4c 69 74 65 20 77 69 74  uilds SQLite wit
ba10: 68 6f 75 74 20 73 75 70 70 6f 72 74 20 66 6f 72  hout support for
ba20: 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d 6f   shared-cache mo
ba30: 64 65 2e 0a 20 20 54 68 65 20 5b 73 71 6c 69 74  de..  The [sqlit
ba40: 65 33 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64  e3_enable_shared
ba50: 5f 63 61 63 68 65 28 29 5d 20 69 73 20 6f 6d 69  _cache()] is omi
ba60: 74 74 65 64 20 61 6c 6f 6e 67 20 77 69 74 68 20  tted along with 
ba70: 61 20 66 61 69 72 0a 20 20 61 6d 6f 75 6e 74 20  a fair.  amount 
ba80: 6f 66 20 6c 6f 67 69 63 20 77 69 74 68 69 6e 20  of logic within 
ba90: 74 68 65 20 42 2d 54 72 65 65 20 73 75 62 73 79  the B-Tree subsy
baa0: 73 74 65 6d 20 61 73 73 6f 63 69 61 74 65 64 20  stem associated 
bab0: 77 69 74 68 20 73 68 61 72 65 64 0a 20 20 63 61  with shared.  ca
bac0: 63 68 65 20 6d 61 6e 61 67 65 6d 65 6e 74 2e 0a  che management..
bad0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
bae0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53  N {SQLITE_OMIT_S
baf0: 55 42 51 55 45 52 59 7d 20 7b 0a 20 20 49 66 20  UBQUERY} {.  If 
bb00: 64 65 66 69 6e 65 64 2c 20 73 75 70 70 6f 72 74  defined, support
bb10: 20 66 6f 72 20 73 75 62 2d 73 65 6c 65 63 74 73   for sub-selects
bb20: 20 61 6e 64 20 74 68 65 20 49 4e 28 29 20 6f 70   and the IN() op
bb30: 65 72 61 74 6f 72 20 61 72 65 20 6f 6d 69 74 74  erator are omitt
bb40: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
bb50: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
bb60: 49 54 5f 54 43 4c 5f 56 41 52 49 41 42 4c 45 7d  IT_TCL_VARIABLE}
bb70: 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6d 61 63   {.  If this mac
bb80: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74  ro is defined, t
bb90: 68 65 6e 20 74 68 65 20 73 70 65 63 69 61 6c 20  hen the special 
bba0: 22 24 3c 76 61 72 69 61 62 6c 65 2d 6e 61 6d 65  "$<variable-name
bbb0: 3e 22 20 73 79 6e 74 61 78 0a 20 20 75 73 65 64  >" syntax.  used
bbc0: 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   to automaticall
bbd0: 79 20 62 69 6e 64 20 53 51 4c 20 76 61 72 69 61  y bind SQL varia
bbe0: 62 6c 65 73 20 74 6f 20 54 43 4c 20 76 61 72 69  bles to TCL vari
bbf0: 61 62 6c 65 73 20 69 73 20 6f 6d 69 74 74 65 64  ables is omitted
bc00: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
bc10: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
bc20: 5f 54 45 4d 50 44 42 7d 20 7b 0a 20 20 54 68 69  _TEMPDB} {.  Thi
bc30: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73  s option omits s
bc40: 75 70 70 6f 72 74 20 66 6f 72 20 54 45 4d 50 20  upport for TEMP 
bc50: 6f 72 20 54 45 4d 50 4f 52 41 52 59 20 74 61 62  or TEMPORARY tab
bc60: 6c 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  les..}..COMPILE_
bc70: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
bc80: 4d 49 54 5f 54 52 41 43 45 7d 20 7b 0a 20 20 54  MIT_TRACE} {.  T
bc90: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
bca0: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65   support for the
bcb0: 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 6c   [sqlite3_profil
bcc0: 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69  e()] and.  [sqli
bcd0: 74 65 33 5f 74 72 61 63 65 28 29 5d 20 69 6e 74  te3_trace()] int
bce0: 65 72 66 61 63 65 73 20 61 6e 64 20 74 68 65 69  erfaces and thei
bcf0: 72 20 61 73 73 6f 63 69 61 74 65 64 20 6c 6f 67  r associated log
bd00: 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ic..}..COMPILE_O
bd10: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
bd20: 49 54 5f 54 52 49 47 47 45 52 7d 20 7b 0a 20 20  IT_TRIGGER} {.  
bd30: 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70  Defining this op
bd40: 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f  tion omits suppo
bd50: 72 74 20 66 6f 72 20 54 52 49 47 47 45 52 20 6f  rt for TRIGGER o
bd60: 62 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20  bjects. Neither 
bd70: 74 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 54  the .  [CREATE T
bd80: 52 49 47 47 45 52 5d 20 6f 72 20 5b 44 52 4f 50  RIGGER] or [DROP
bd90: 20 54 52 49 47 47 45 52 5d 0a 20 20 63 6f 6d 6d   TRIGGER].  comm
bda0: 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c 61 62  ands are availab
bdb0: 6c 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c  le in this case,
bdc0: 20 61 6e 64 20 61 74 74 65 6d 70 74 69 6e 67 20   and attempting 
bdd0: 74 6f 20 65 78 65 63 75 74 65 0a 20 20 65 69 74  to execute.  eit
bde0: 68 65 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20  her will result 
bdf0: 69 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  in a parse error
be00: 2e 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  ..  This option 
be10: 61 6c 73 6f 20 64 69 73 61 62 6c 65 73 20 65 6e  also disables en
be20: 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 5b 66 6f  forcement of [fo
be30: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
be40: 61 69 6e 74 73 5d 2c 0a 20 20 73 69 6e 63 65 20  aints],.  since 
be50: 74 68 65 20 63 6f 64 65 20 74 68 61 74 20 69 6d  the code that im
be60: 70 6c 65 6d 65 6e 74 73 20 74 72 69 67 67 65 72  plements trigger
be70: 73 20 61 6e 64 20 77 68 69 63 68 20 69 73 20 6f  s and which is o
be80: 6d 69 74 74 65 64 20 62 79 20 74 68 69 73 0a 20  mitted by this. 
be90: 20 6f 70 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20   option is also 
bea0: 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e  used to implemen
beb0: 74 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20 61  t [foreign key a
bec0: 63 74 69 6f 6e 73 5d 2e 0a 7d 0a 0a 43 4f 4d 50  ctions]..}..COMP
bed0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
bee0: 54 45 5f 4f 4d 49 54 5f 54 52 55 4e 43 41 54 45  TE_OMIT_TRUNCATE
bef0: 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b  _OPTIMIZATION} {
bf00: 0a 20 20 41 20 64 65 66 61 75 6c 74 20 62 75 69  .  A default bui
bf10: 6c 64 20 6f 66 20 53 51 4c 69 74 65 2c 20 69 66  ld of SQLite, if
bf20: 20 61 20 5b 44 45 4c 45 54 45 5d 20 73 74 61 74   a [DELETE] stat
bf30: 65 6d 65 6e 74 20 68 61 73 20 6e 6f 20 57 48 45  ement has no WHE
bf40: 52 45 20 63 6c 61 75 73 65 0a 20 20 61 6e 64 20  RE clause.  and 
bf50: 6f 70 65 72 61 74 65 73 20 6f 6e 20 61 20 74 61  operates on a ta
bf60: 62 6c 65 20 77 69 74 68 20 6e 6f 20 74 72 69 67  ble with no trig
bf70: 67 65 72 73 2c 20 61 6e 20 6f 70 74 69 6d 69 7a  gers, an optimiz
bf80: 61 74 69 6f 6e 20 6f 63 63 75 72 73 20 74 68 61  ation occurs tha
bf90: 74 0a 20 20 63 61 75 73 65 73 20 74 68 65 20 44  t.  causes the D
bfa0: 45 4c 45 54 45 20 74 6f 20 6f 63 63 75 72 20 62  ELETE to occur b
bfb0: 79 20 64 72 6f 70 70 69 6e 67 20 61 6e 64 20 72  y dropping and r
bfc0: 65 63 72 65 61 74 69 6e 67 20 74 68 65 20 74 61  ecreating the ta
bfd0: 62 6c 65 2e 20 20 0a 20 20 44 72 6f 70 70 69 6e  ble.  .  Droppin
bfe0: 67 20 61 6e 64 20 72 65 63 72 65 61 74 69 6e 67  g and recreating
bff0: 20 61 20 74 61 62 6c 65 20 69 73 20 75 73 75 61   a table is usua
c000: 6c 6c 79 20 6d 75 63 68 20 66 61 73 74 65 72 20  lly much faster 
c010: 74 68 61 6e 20 64 65 6c 65 74 69 6e 67 0a 20 20  than deleting.  
c020: 74 68 65 20 74 61 62 6c 65 20 63 6f 6e 74 65 6e  the table conten
c030: 74 20 72 6f 77 20 62 79 20 72 6f 77 2e 20 20 54  t row by row.  T
c040: 68 69 73 20 69 73 20 74 68 65 20 22 74 72 75 6e  his is the "trun
c050: 63 61 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f  cate optimizatio
c060: 6e 22 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  n"..}..COMPILE_O
c070: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
c080: 49 54 5f 55 54 46 31 36 7d 20 7b 0a 20 20 54 68  IT_UTF16} {.  Th
c090: 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64  is macro is used
c0a0: 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72 74   to omit support
c0b0: 20 66 6f 72 20 55 54 46 31 36 20 74 65 78 74 20   for UTF16 text 
c0c0: 65 6e 63 6f 64 69 6e 67 2e 20 57 68 65 6e 20 74  encoding. When t
c0d0: 68 69 73 20 69 73 0a 20 20 64 65 66 69 6e 65 64  his is.  defined
c0e0: 20 61 6c 6c 20 41 50 49 20 66 75 6e 63 74 69 6f   all API functio
c0f0: 6e 73 20 74 68 61 74 20 72 65 74 75 72 6e 20 6f  ns that return o
c100: 72 20 61 63 63 65 70 74 20 55 54 46 31 36 20 65  r accept UTF16 e
c110: 6e 63 6f 64 65 64 20 74 65 78 74 20 61 72 65 0a  ncoded text are.
c120: 20 20 75 6e 61 76 61 69 6c 61 62 6c 65 2e 20 54    unavailable. T
c130: 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 63  hese functions c
c140: 61 6e 20 62 65 20 69 64 65 6e 74 69 66 69 65 64  an be identified
c150: 20 62 79 20 74 68 65 20 66 61 63 74 20 74 68 61   by the fact tha
c160: 74 20 74 68 65 79 20 65 6e 64 0a 20 20 77 69 74  t they end.  wit
c170: 68 20 27 31 36 27 2c 20 66 6f 72 20 65 78 61 6d  h '16', for exam
c180: 70 6c 65 20 5b 73 71 6c 69 74 65 33 5f 70 72 65  ple [sqlite3_pre
c190: 70 61 72 65 31 36 28 29 5d 2c 20 5b 73 71 6c 69  pare16()], [sqli
c1a0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
c1b0: 36 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69  6()] and.  [sqli
c1c0: 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36 28  te3_bind_text16(
c1d0: 29 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  )]..}..COMPILE_O
c1e0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
c1f0: 49 54 5f 56 41 43 55 55 4d 7d 20 7b 0a 20 20 57  IT_VACUUM} {.  W
c200: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
c210: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
c220: 5b 56 41 43 55 55 4d 5d 0a 20 20 63 6f 6d 6d 61  [VACUUM].  comma
c230: 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64  nd is not includ
c240: 65 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72  ed in the librar
c250: 79 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20 61  y..  Executing a
c260: 20 5b 56 41 43 55 55 4d 5d 20 73 74 61 74 65 6d   [VACUUM] statem
c270: 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20 61 20  ent causes .  a 
c280: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a  parse error..}..
c290: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
c2a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 45 57  SQLITE_OMIT_VIEW
c2b0: 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74  } {.  Defining t
c2c0: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
c2d0: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 56 49 45   support for VIE
c2e0: 57 20 6f 62 6a 65 63 74 73 2e 20 4e 65 69 74 68  W objects. Neith
c2f0: 65 72 20 74 68 65 20 0a 20 20 5b 43 52 45 41 54  er the .  [CREAT
c300: 45 20 56 49 45 57 5d 20 6e 6f 72 20 74 68 65 20  E VIEW] nor the 
c310: 5b 44 52 4f 50 20 56 49 45 57 5d 0a 20 20 63 6f  [DROP VIEW].  co
c320: 6d 6d 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c  mmands are avail
c330: 61 62 6c 65 20 69 6e 20 74 68 69 73 20 63 61 73  able in this cas
c340: 65 2c 20 61 6e 64 0a 20 20 61 74 74 65 6d 70 74  e, and.  attempt
c350: 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 20 65  ing to execute e
c360: 69 74 68 65 72 20 77 69 6c 6c 20 72 65 73 75 6c  ither will resul
c370: 74 20 69 6e 20 61 20 70 61 72 73 65 20 65 72 72  t in a parse err
c380: 6f 72 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a 20  or...  WARNING: 
c390: 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73  If this macro is
c3a0: 20 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c   defined, it wil
c3b0: 6c 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c  l not be possibl
c3c0: 65 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61  e to open a data
c3d0: 62 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68  base.  for which
c3e0: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74   the schema cont
c3f0: 61 69 6e 73 20 56 49 45 57 20 6f 62 6a 65 63 74  ains VIEW object
c400: 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  s. .}..COMPILE_O
c410: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
c420: 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 7d  IT_VIRTUALTABLE}
c430: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
c440: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
c450: 6f 72 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  or the [sqlite3_
c460: 76 74 61 62 20 7c 20 56 69 72 74 75 61 6c 20 54  vtab | Virtual T
c470: 61 62 6c 65 5d 0a 20 20 6d 65 63 68 61 6e 69 73  able].  mechanis
c480: 6d 20 69 6e 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a  m in SQLite..}..
c490: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
c4a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 7d  SQLITE_OMIT_WAL}
c4b0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
c4c0: 20 6f 6d 69 74 73 20 74 68 65 20 22 5b 77 72 69   omits the "[wri
c4d0: 74 65 2d 61 68 65 61 64 20 6c 6f 67 5d 22 20 28  te-ahead log]" (
c4e0: 61 2e 6b 2e 61 2e 20 22 5b 57 41 4c 5d 22 29 20  a.k.a. "[WAL]") 
c4f0: 63 61 70 61 62 69 6c 69 74 79 2e 0a 7d 0a 0a 43  capability..}..C
c500: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
c510: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 7d 20  QLITE_OMIT_WSD} 
c520: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
c530: 62 75 69 6c 64 73 20 61 20 76 65 72 73 69 6f 6e  builds a version
c540: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c   of the SQLite l
c550: 69 62 72 61 72 79 20 74 68 61 74 20 63 6f 6e 74  ibrary that cont
c560: 61 69 6e 73 20 6e 6f 0a 20 20 57 72 69 74 61 62  ains no.  Writab
c570: 6c 65 20 53 74 61 74 69 63 20 44 61 74 61 20 28  le Static Data (
c580: 57 53 44 29 2e 20 20 57 53 44 20 69 73 20 67 6c  WSD).  WSD is gl
c590: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61  obal variables a
c5a0: 6e 64 2f 6f 72 20 73 74 61 74 69 63 0a 20 20 76  nd/or static.  v
c5b0: 61 72 69 61 62 6c 65 73 2e 20 20 53 6f 6d 65 20  ariables.  Some 
c5c0: 70 6c 61 74 66 6f 72 6d 73 20 64 6f 20 6e 6f 74  platforms do not
c5d0: 20 73 75 70 70 6f 72 74 20 57 53 44 2c 20 61 6e   support WSD, an
c5e0: 64 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  d this option is
c5f0: 20 6e 65 63 65 73 73 61 72 79 0a 20 20 69 6e 20   necessary.  in 
c600: 6f 72 64 65 72 20 66 6f 72 20 53 51 4c 69 74 65  order for SQLite
c610: 20 74 6f 20 77 6f 72 6b 20 74 68 6f 73 65 20 70   to work those p
c620: 6c 61 74 66 6f 72 6d 73 2e 20 20 0a 0a 20 20 55  latforms.  ..  U
c630: 6e 6c 69 6b 65 20 6f 74 68 65 72 20 4f 4d 49 54  nlike other OMIT
c640: 20 6f 70 74 69 6f 6e 73 20 77 68 69 63 68 20 6d   options which m
c650: 61 6b 65 20 74 68 65 20 53 51 4c 69 74 65 20 6c  ake the SQLite l
c660: 69 62 72 61 72 79 20 73 6d 61 6c 6c 65 72 2c 0a  ibrary smaller,.
c670: 20 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 63    this option ac
c680: 74 75 61 6c 6c 79 20 69 6e 63 72 65 61 73 65 73  tually increases
c690: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 53 51 4c   the size of SQL
c6a0: 69 74 65 20 61 6e 64 20 6d 61 6b 65 73 20 69 74  ite and makes it
c6b0: 20 72 75 6e 0a 20 20 61 20 6c 69 74 74 6c 65 20   run.  a little 
c6c0: 73 6c 6f 77 65 72 2e 20 20 4f 6e 6c 79 20 75 73  slower.  Only us
c6d0: 65 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 66  e this option if
c6e0: 20 53 51 4c 69 74 65 20 69 73 20 62 65 69 6e 67   SQLite is being
c6f0: 20 62 75 69 6c 74 20 66 6f 72 20 61 6e 0a 20 20   built for an.  
c700: 65 6d 62 65 64 64 65 64 20 74 61 72 67 65 74 20  embedded target 
c710: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75  that does not su
c720: 70 70 6f 72 74 20 57 53 44 2e 0a 7d 0a 0a 43 4f  pport WSD..}..CO
c730: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
c740: 4c 49 54 45 5f 4f 4d 49 54 5f 58 46 45 52 5f 4f  LITE_OMIT_XFER_O
c750: 50 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  PT} {.  This opt
c760: 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72  ion omits suppor
c770: 74 20 66 6f 72 20 6f 70 74 69 6d 69 7a 61 74 69  t for optimizati
c780: 6f 6e 73 20 74 68 61 74 20 68 65 6c 70 20 73 74  ons that help st
c790: 61 74 65 6d 65 6e 74 73 0a 20 20 6f 66 20 74 68  atements.  of th
c7a0: 65 20 66 6f 72 6d 20 22 49 4e 53 45 52 54 20 49  e form "INSERT I
c7b0: 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 43 54 20 2e  NTO ... SELECT .
c7c0: 2e 2e 22 20 72 75 6e 20 66 61 73 74 65 72 2e 0a  .." run faster..
c7d0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
c7e0: 4e 20 7b 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d  N {SQLITE_ZERO_M
c7f0: 41 4c 4c 4f 43 7d 20 7b 0a 20 20 54 68 69 73 20  ALLOC} {.  This 
c800: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 62 6f 74  option omits bot
c810: 68 20 74 68 65 20 5b 64 65 66 61 75 6c 74 20 6d  h the [default m
c820: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d  emory allocator]
c830: 20 61 6e 64 20 74 68 65 0a 20 20 5b 64 65 62 75   and the.  [debu
c840: 67 67 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c  gging memory all
c850: 6f 63 61 74 6f 72 5d 20 66 72 6f 6d 20 74 68 65  ocator] from the
c860: 20 62 75 69 6c 64 20 61 6e 64 20 73 75 62 73 74   build and subst
c870: 69 74 75 74 65 73 20 61 20 73 74 75 62 0a 20 20  itutes a stub.  
c880: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
c890: 20 74 68 61 74 20 61 6c 77 61 79 73 20 66 61 69   that always fai
c8a0: 6c 73 2e 20 20 53 51 4c 69 74 65 20 77 69 6c 6c  ls.  SQLite will
c8b0: 20 6e 6f 74 20 72 75 6e 20 77 69 74 68 20 74 68   not run with th
c8c0: 69 73 0a 20 20 73 74 75 62 20 6d 65 6d 6f 72 79  is.  stub memory
c8d0: 20 61 6c 6c 6f 63 61 74 6f 72 20 73 69 6e 63 65   allocator since
c8e0: 20 69 74 20 77 69 6c 6c 20 62 65 20 75 6e 61 62   it will be unab
c8f0: 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 6d  le to allocate m
c900: 65 6d 6f 72 79 2e 20 20 42 75 74 0a 20 20 74 68  emory.  But.  th
c910: 69 73 20 73 74 75 62 20 63 61 6e 20 62 65 20 72  is stub can be r
c920: 65 70 6c 61 63 65 64 20 61 74 20 73 74 61 72 74  eplaced at start
c930: 2d 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 5b 73  -time using.  [s
c940: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 5b  qlite3_config]([
c950: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 41  SQLITE_CONFIG_MA
c960: 4c 4c 4f 43 5d 2c 2e 2e 2e 29 20 6f 72 0a 20 20  LLOC],...) or.  
c970: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d  [sqlite3_config]
c980: 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f  ([SQLITE_CONFIG_
c990: 48 45 41 50 5d 2c 2e 2e 2e 29 2e 0a 20 20 53 6f  HEAP],...)..  So
c9a0: 20 74 68 65 20 6e 65 74 20 65 66 66 65 63 74 20   the net effect 
c9b0: 6f 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d  of this compile-
c9c0: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 74  time option is t
c9d0: 68 61 74 20 69 74 20 61 6c 6c 6f 77 73 20 53 51  hat it allows SQ
c9e0: 4c 69 74 65 0a 20 20 74 6f 20 62 65 20 63 6f 6d  Lite.  to be com
c9f0: 70 69 6c 65 64 20 61 6e 64 20 6c 69 6e 6b 65 64  piled and linked
ca00: 20 61 67 61 69 6e 73 74 20 61 20 73 79 73 74 65   against a syste
ca10: 6d 20 6c 69 62 72 61 72 79 20 74 68 61 74 20 64  m library that d
ca20: 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 0a  oes not support.
ca30: 20 20 6d 61 6c 6c 6f 63 28 29 2c 20 66 72 65 65    malloc(), free
ca40: 28 29 2c 20 61 6e 64 2f 6f 72 20 72 65 61 6c 6c  (), and/or reall
ca50: 6f 63 28 29 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a  oc()..}..</tcl>.
ca60: 3c 61 20 6e 61 6d 65 3d 22 64 65 62 75 67 6f 70  <a name="debugop
ca70: 74 69 6f 6e 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e  tions"></a>.<h2>
ca80: 31 2e 37 20 41 6e 61 6c 79 73 69 73 20 61 6e 64  1.7 Analysis and
ca90: 20 44 65 62 75 67 67 69 6e 67 20 4f 70 74 69 6f   Debugging Optio
caa0: 6e 73 3c 2f 68 32 3e 0a 3c 74 63 6c 3e 0a 0a 43  ns</h2>.<tcl>..C
cab0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
cac0: 51 4c 49 54 45 5f 44 45 42 55 47 7d 20 7b 0a 20  QLITE_DEBUG} {. 
cad0: 20 54 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72   The SQLite sour
cae0: 63 65 20 63 6f 64 65 20 63 6f 6e 74 61 69 6e 73  ce code contains
caf0: 20 6c 69 74 65 72 61 6c 6c 79 20 74 68 6f 75 73   literally thous
cb00: 61 6e 64 73 20 6f 66 20 61 73 73 65 72 74 28 29  ands of assert()
cb10: 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 75 73   statements.  us
cb20: 65 64 20 74 6f 20 76 65 72 69 66 79 20 69 6e 74  ed to verify int
cb30: 65 72 6e 61 6c 20 61 73 73 75 6d 70 74 69 6f 6e  ernal assumption
cb40: 73 20 61 6e 64 20 73 75 62 72 6f 75 74 69 6e 65  s and subroutine
cb50: 20 70 72 65 63 6f 6e 64 69 74 69 6f 6e 73 20 61   preconditions a
cb60: 6e 64 0a 20 20 70 6f 73 74 63 6f 6e 64 69 74 69  nd.  postconditi
cb70: 6f 6e 73 2e 20 20 54 68 65 73 65 20 61 73 73 65  ons.  These asse
cb80: 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20  rt() statements 
cb90: 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 74 75 72  are normally tur
cba0: 6e 65 64 20 6f 66 66 0a 20 20 28 74 68 65 79 20  ned off.  (they 
cbb0: 67 65 6e 65 72 61 74 65 20 6e 6f 20 63 6f 64 65  generate no code
cbc0: 29 20 73 69 6e 63 65 20 74 75 72 6e 69 6e 67 20  ) since turning 
cbd0: 74 68 65 6d 20 6f 6e 20 6d 61 6b 65 73 20 53 51  them on makes SQ
cbe0: 4c 69 74 65 20 72 75 6e 20 61 70 70 72 6f 78 69  Lite run approxi
cbf0: 6d 61 74 65 6c 79 0a 20 20 74 68 72 65 65 20 74  mately.  three t
cc00: 69 6d 65 73 20 73 6c 6f 77 65 72 2e 20 20 42 75  imes slower.  Bu
cc10: 74 20 66 6f 72 20 74 65 73 74 69 6e 67 20 61 6e  t for testing an
cc20: 64 20 61 6e 61 6c 79 73 69 73 2c 20 69 74 20 69  d analysis, it i
cc30: 73 20 75 73 65 66 75 6c 20 74 6f 20 74 75 72 6e  s useful to turn
cc40: 0a 20 20 74 68 65 20 61 73 73 65 72 74 28 29 20  .  the assert() 
cc50: 73 74 61 74 65 6d 65 6e 74 73 20 6f 6e 2e 20 20  statements on.  
cc60: 54 68 65 20 53 51 4c 49 54 45 5f 44 45 42 55 47  The SQLITE_DEBUG
cc70: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
cc80: 74 69 6f 6e 20 64 6f 65 73 20 74 68 69 73 2e 0a  tion does this..
cc90: 20 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61    SQLITE_DEBUG a
cca0: 6c 73 6f 20 74 75 72 6e 73 20 6f 6e 20 73 6f 6d  lso turns on som
ccb0: 65 20 6f 74 68 65 72 20 64 65 62 75 67 67 69 6e  e other debuggin
ccc0: 67 20 66 65 61 74 75 72 65 73 2e 0a 7d 0a 0a 43  g features..}..C
ccd0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
cce0: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 7d 20  QLITE_MEMDEBUG} 
ccf0: 7b 0a 20 20 54 68 65 20 53 51 4c 49 54 45 5f 4d  {.  The SQLITE_M
cd00: 45 4d 44 45 42 55 47 20 6f 70 74 69 6f 6e 20 63  EMDEBUG option c
cd10: 61 75 73 65 73 20 61 6e 20 69 6e 73 74 72 75 6d  auses an instrum
cd20: 65 6e 74 65 64 20 0a 20 20 5b 64 65 62 75 67 67  ented .  [debugg
cd30: 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  ing memory alloc
cd40: 61 74 6f 72 5d 0a 20 20 74 6f 20 62 65 20 75 73  ator].  to be us
cd50: 65 64 20 61 73 20 74 68 65 20 64 65 66 61 75 6c  ed as the defaul
cd60: 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  t memory allocat
cd70: 6f 72 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65  or within SQLite
cd80: 2e 20 20 54 68 65 0a 20 20 69 6e 73 74 72 75 6d  .  The.  instrum
cd90: 65 6e 74 65 64 20 6d 65 6d 6f 72 79 20 61 6c 6c  ented memory all
cda0: 6f 63 61 74 6f 72 20 63 68 65 63 6b 73 20 66 6f  ocator checks fo
cdb0: 72 20 6d 69 73 75 73 65 20 6f 66 20 64 79 6e 61  r misuse of dyna
cdc0: 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65  mically allocate
cdd0: 64 0a 20 20 6d 65 6d 6f 72 79 2e 20 20 45 78 61  d.  memory.  Exa
cde0: 6d 70 6c 65 73 20 6f 66 20 6d 69 73 75 73 65 20  mples of misuse 
cdf0: 69 6e 63 6c 75 64 65 20 75 73 69 6e 67 20 6d 65  include using me
ce00: 6d 6f 72 79 20 61 66 74 65 72 20 69 74 20 69 73  mory after it is
ce10: 20 66 72 65 65 64 2c 0a 20 20 77 72 69 74 69 6e   freed,.  writin
ce20: 67 20 6f 66 66 20 74 68 65 20 65 6e 64 73 20 6f  g off the ends o
ce30: 66 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  f a memory alloc
ce40: 61 74 69 6f 6e 2c 20 66 72 65 65 69 6e 67 20 6d  ation, freeing m
ce50: 65 6d 6f 72 79 20 6e 6f 74 20 70 72 65 76 69 6f  emory not previo
ce60: 75 73 6c 79 0a 20 20 6f 62 74 61 69 6e 65 64 20  usly.  obtained 
ce70: 66 72 6f 6d 20 74 68 65 20 6d 65 6d 6f 72 79 20  from the memory 
ce80: 61 6c 6c 6f 63 61 74 6f 72 2c 20 6f 72 20 66 61  allocator, or fa
ce90: 69 6c 69 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c  iling to initial
cea0: 69 7a 65 20 6e 65 77 6c 79 0a 20 20 61 6c 6c 6f  ize newly.  allo
ceb0: 63 61 74 65 64 20 6d 65 6d 6f 72 79 2e 0a 7d 0a  cated memory..}.
cec0: 0a 3c 2f 74 63 6c 3e 0a                          .</tcl>.