Documentation Source Text

Hex Artifact Content
Login

Artifact 5d5329f4f0c510f1304a79df74b7b03e711e952d:


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 0a 3c  QLite</title>..<
0030: 68 31 3e 31 2e 30 20 43 6f 6d 70 69 6c 61 74 69  h1>1.0 Compilati
0040: 6f 6e 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53  on Options For S
0050: 51 4c 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a  QLite</h1>..<p>.
0060: 46 6f 72 20 6d 6f 73 74 20 70 75 72 70 6f 73 65  For most purpose
0070: 73 2c 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65  s, SQLite can be
0080: 20 62 75 69 6c 74 20 6a 75 73 74 20 66 69 6e 65   built just fine
0090: 20 75 73 69 6e 67 20 74 68 65 20 64 65 66 61 75   using the defau
00a0: 6c 74 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  lt.compilation o
00b0: 70 74 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c  ptions. However,
00c0: 20 69 66 20 72 65 71 75 69 72 65 64 2c 20 74 68   if required, th
00d0: 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  e compile-time o
00e0: 70 74 69 6f 6e 73 0a 64 6f 63 75 6d 65 6e 74 65  ptions.documente
00f0: 64 20 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 75  d below can be u
0100: 73 65 64 20 74 6f 20 0a 3c 61 20 68 72 65 66 3d  sed to .<a href=
0110: 22 23 6f 6d 69 74 66 65 61 74 75 72 65 73 22 3e  "#omitfeatures">
0120: 6f 6d 69 74 20 53 51 4c 69 74 65 20 66 65 61 74  omit SQLite feat
0130: 75 72 65 73 3c 2f 61 3e 20 28 72 65 73 75 6c 74  ures</a> (result
0140: 69 6e 67 20 69 6e 0a 61 20 73 6d 61 6c 6c 65 72  ing in.a smaller
0150: 20 63 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72   compiled librar
0160: 79 20 73 69 7a 65 29 20 6f 72 20 74 6f 20 63 68  y size) or to ch
0170: 61 6e 67 65 20 74 68 65 0a 3c 61 20 68 72 65 66  ange the.<a href
0180: 3d 22 23 64 65 66 61 75 6c 74 73 22 3e 64 65 66  ="#defaults">def
0190: 61 75 6c 74 20 76 61 6c 75 65 73 3c 2f 61 3e 20  ault values</a> 
01a0: 6f 66 20 73 6f 6d 65 20 70 61 72 61 6d 65 74 65  of some paramete
01b0: 72 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76  rs..</p>..<p>.Ev
01c0: 65 72 79 20 65 66 66 6f 72 74 20 68 61 73 20 62  ery effort has b
01d0: 65 65 6e 20 6d 61 64 65 20 74 6f 20 65 6e 73 75  een made to ensu
01e0: 72 65 20 74 68 61 74 20 74 68 65 20 76 61 72 69  re that the vari
01f0: 6f 75 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73  ous combinations
0200: 0a 6f 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  .of compilation 
0210: 6f 70 74 69 6f 6e 73 20 77 6f 72 6b 20 68 61 72  options work har
0220: 6d 6f 6e 69 6f 75 73 6c 79 20 61 6e 64 20 70 72  moniously and pr
0230: 6f 64 75 63 65 20 61 20 77 6f 72 6b 69 6e 67 20  oduce a working 
0240: 6c 69 62 72 61 72 79 2e 0a 4e 65 76 65 72 74 68  library..Neverth
0250: 65 6c 65 73 73 2c 20 69 74 20 69 73 20 73 74 72  eless, it is str
0260: 6f 6e 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65  ongly recommende
0270: 64 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74  d that the SQLit
0280: 65 20 74 65 73 74 2d 73 75 69 74 65 0a 62 65 20  e test-suite.be 
0290: 65 78 65 63 75 74 65 64 20 74 6f 20 63 68 65 63  executed to chec
02a0: 6b 20 66 6f 72 20 65 72 72 6f 72 73 20 62 65 66  k for errors bef
02b0: 6f 72 65 20 75 73 69 6e 67 20 61 6e 20 53 51 4c  ore using an SQL
02c0: 69 74 65 20 6c 69 62 72 61 72 79 20 62 75 69 6c  ite library buil
02d0: 74 0a 77 69 74 68 20 6e 6f 6e 2d 73 74 61 6e 64  t.with non-stand
02e0: 61 72 64 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  ard compilation 
02f0: 6f 70 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 3c 61  options..</p>.<a
0300: 20 6e 61 6d 65 3d 22 64 65 66 61 75 6c 74 73 22   name="defaults"
0310: 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 4f 70  ></a>.<h2>1.1 Op
0320: 74 69 6f 6e 73 20 54 6f 20 53 65 74 20 44 65 66  tions To Set Def
0330: 61 75 6c 74 20 50 61 72 61 6d 65 74 65 72 20 56  ault Parameter V
0340: 61 6c 75 65 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c  alues</h2>..<tcl
0350: 3e 0a 70 72 6f 63 20 43 4f 4d 50 49 4c 45 5f 4f  >.proc COMPILE_O
0360: 50 54 49 4f 4e 20 7b 6e 61 6d 65 20 74 65 78 74  PTION {name text
0370: 7d 20 7b 0a 20 20 69 66 20 7b 5b 72 65 67 65 78  } {.  if {[regex
0380: 70 20 7b 53 51 4c 49 54 45 5f 28 5b 41 2d 5a 30  p {SQLITE_([A-Z0
0390: 2d 39 5f 5d 2b 29 7d 20 24 6e 61 6d 65 20 61 6c  -9_]+)} $name al
03a0: 6c 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20  l label]} {.    
03b0: 68 64 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72  hd_fragment [str
03c0: 69 6e 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62  ing tolower $lab
03d0: 65 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f  el].    hd_keywo
03e0: 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 69  rds $all.  }.  i
03f0: 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e 59 59 28  f {[regexp {^YY(
0400: 5b 41 2d 5a 30 2d 39 5f 5d 2b 29 7d 20 24 6e 61  [A-Z0-9_]+)} $na
0410: 6d 65 20 61 6c 6c 20 6c 61 62 65 6c 5d 7d 20 7b  me all label]} {
0420: 0a 20 20 20 20 68 64 5f 66 72 61 67 6d 65 6e 74  .    hd_fragment
0430: 20 5b 73 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72   [string tolower
0440: 20 24 61 6c 6c 5d 0a 20 20 20 20 68 64 5f 6b 65   $all].    hd_ke
0450: 79 77 6f 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a  ywords $all.  }.
0460: 20 20 68 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e    hd_puts <p><b>
0470: 24 6e 61 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20  $name</b></p>.  
0480: 72 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c  regsub -all "\n\
0490: 5c 73 2a 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f  \s*\n" $text "</
04a0: 70 3e 5c 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a  p>\n\n<p>" text.
04b0: 20 20 68 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c    hd_resolve <bl
04c0: 6f 63 6b 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78  ockquote><p>$tex
04d0: 74 3c 2f 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  t</p></blockquot
04e0: 65 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e>.}..COMPILE_OP
04f0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
0500: 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d  AULT_AUTOVACUUM=
0510: 3c 69 3e 26 6c 74 3b 31 20 6f 72 20 30 26 67 74  <i>&lt;1 or 0&gt
0520: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
0530: 6d 61 63 72 6f 20 64 65 74 65 72 6d 69 6e 65 73  macro determines
0540: 20 69 66 20 53 51 4c 69 74 65 20 63 72 65 61 74   if SQLite creat
0550: 65 73 20 64 61 74 61 62 61 73 65 73 20 77 69 74  es databases wit
0560: 68 20 74 68 65 20 0a 20 20 5b 61 75 74 6f 5f 76  h the .  [auto_v
0570: 61 63 75 75 6d 5d 20 66 6c 61 67 20 73 65 74 20  acuum] flag set 
0580: 62 79 20 64 65 66 61 75 6c 74 2e 20 54 68 65 20  by default. The 
0590: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73  default value is
05a0: 20 30 20 0a 20 20 28 64 6f 20 6e 6f 74 20 63 72   0 .  (do not cr
05b0: 65 61 74 65 20 61 75 74 6f 2d 76 61 63 75 75 6d  eate auto-vacuum
05c0: 20 64 61 74 61 62 61 73 65 73 29 2e 20 49 6e 20   databases). In 
05d0: 61 6e 79 20 63 61 73 65 20 74 68 65 0a 20 20 63  any case the.  c
05e0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 64 65 66 61  ompile-time defa
05f0: 75 6c 74 20 6d 61 79 20 62 65 20 6f 76 65 72 72  ult may be overr
0600: 69 64 64 65 6e 20 62 79 20 74 68 65 20 0a 20 20  idden by the .  
0610: 5b 50 52 41 47 4d 41 20 61 75 74 6f 5f 76 61 63  [PRAGMA auto_vac
0620: 75 75 6d 5d 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a  uum] command..}.
0630: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
0640: 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f  {SQLITE_DEFAULT_
0650: 43 41 43 48 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c  CACHE_SIZE=<i>&l
0660: 74 3b 70 61 67 65 73 26 67 74 3b 3c 2f 69 3e 7d  t;pages&gt;</i>}
0670: 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20   {.  This macro 
0680: 73 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74  sets the default
0690: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67   size of the pag
06a0: 65 2d 63 61 63 68 65 20 66 6f 72 20 65 61 63 68  e-cache for each
06b0: 20 61 74 74 61 63 68 65 64 0a 20 20 64 61 74 61   attached.  data
06c0: 62 61 73 65 2c 20 69 6e 20 70 61 67 65 73 2e 20  base, in pages. 
06d0: 54 68 69 73 20 63 61 6e 20 62 65 20 6f 76 65 72  This can be over
06e0: 72 69 64 64 65 6e 20 62 79 20 74 68 65 20 0a 20  ridden by the . 
06f0: 20 5b 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73   [PRAGMA cache_s
0700: 69 7a 65 5d 20 63 6f 6d 61 6d 6e 64 2e 20 54 68  ize] comamnd. Th
0710: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20  e default value 
0720: 69 73 20 32 30 30 30 2e 0a 7d 0a 0a 43 4f 4d 50  is 2000..}..COMP
0730: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
0740: 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f  TE_DEFAULT_FILE_
0750: 46 4f 52 4d 41 54 3d 3c 69 3e 26 6c 74 3b 31 20  FORMAT=<i>&lt;1 
0760: 6f 72 20 34 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  or 4&gt;</i>} {.
0770: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 63    The default sc
0780: 68 65 6d 61 2d 6c 65 76 65 6c 20 66 69 6c 65 20  hema-level file 
0790: 66 6f 72 6d 61 74 20 75 73 65 64 20 62 79 20 53  format used by S
07a0: 51 4c 69 74 65 20 77 68 65 6e 20 63 72 65 61 74  QLite when creat
07b0: 69 6e 67 0a 20 20 6e 65 77 20 64 61 74 61 62 61  ing.  new databa
07c0: 73 65 20 66 69 6c 65 73 20 69 73 20 73 65 74 20  se files is set 
07d0: 62 79 20 74 68 69 73 20 6d 61 63 72 6f 2e 20 20  by this macro.  
07e0: 54 68 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 73  The file formats
07f0: 20 61 72 65 20 61 6c 6c 0a 20 20 76 65 72 79 20   are all.  very 
0800: 73 69 6d 69 6c 61 72 2e 20 20 54 68 65 20 64 69  similar.  The di
0810: 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e  fference between
0820: 20 66 6f 72 6d 61 74 73 20 31 20 61 6e 64 20 34   formats 1 and 4
0830: 20 69 73 20 74 68 61 74 20 66 6f 72 6d 61 74 0a   is that format.
0840: 20 20 34 20 75 6e 64 65 72 73 74 61 6e 64 73 20    4 understands 
0850: 64 65 73 63 65 6e 64 69 6e 67 20 69 6e 64 69 63  descending indic
0860: 65 73 20 61 6e 64 20 68 61 73 20 61 20 74 69 67  es and has a tig
0870: 68 74 65 72 20 65 6e 63 6f 64 69 6e 67 20 66 6f  hter encoding fo
0880: 72 0a 20 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75  r.  boolean valu
0890: 65 73 2e 0a 0a 20 20 53 51 4c 69 74 65 20 28 61  es...  SQLite (a
08a0: 73 20 6f 66 20 5b 76 65 72 73 69 6f 6e 20 33 2e  s of [version 3.
08b0: 36 2e 30 5d 29 20 63 61 6e 20 72 65 61 64 20 61  6.0]) can read a
08c0: 6e 64 20 77 72 69 74 65 20 61 6e 79 20 66 69 6c  nd write any fil
08d0: 65 20 66 6f 72 6d 61 74 0a 20 20 62 65 74 77 65  e format.  betwe
08e0: 65 6e 20 31 20 61 6e 64 20 34 2e 20 20 42 75 74  en 1 and 4.  But
08f0: 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20   older versions 
0900: 6f 66 20 53 51 4c 69 74 65 20 6d 69 67 68 74 20  of SQLite might 
0910: 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 0a 20  not be able to. 
0920: 20 72 65 61 64 20 66 6f 72 6d 61 74 73 20 67 72   read formats gr
0930: 65 61 74 65 72 20 74 68 61 6e 20 31 2e 20 20 53  eater than 1.  S
0940: 6f 20 74 68 61 74 20 6f 6c 64 65 72 20 76 65 72  o that older ver
0950: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20  sions of SQLite 
0960: 77 69 6c 6c 0a 20 20 62 65 20 61 62 6c 65 20 74  will.  be able t
0970: 6f 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65  o read and write
0980: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
0990: 63 72 65 61 74 65 64 20 62 79 20 6e 65 77 65 72  created by newer
09a0: 20 76 65 72 73 69 6f 6e 73 0a 20 20 6f 66 20 53   versions.  of S
09b0: 51 4c 69 74 65 2c 20 74 68 65 20 64 65 66 61 75  QLite, the defau
09c0: 6c 74 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 69  lt file format i
09d0: 73 20 73 65 74 20 74 6f 20 31 20 66 6f 72 20 6d  s set to 1 for m
09e0: 61 78 69 6d 75 6d 0a 20 20 63 6f 6d 70 61 74 61  aximum.  compata
09f0: 62 69 6c 69 74 79 2e 0a 0a 20 20 54 68 65 20 66  bility...  The f
0a00: 69 6c 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 61  ile format for a
0a10: 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 63 61   new database ca
0a20: 6e 20 62 65 20 73 65 74 20 61 74 20 72 75 6e 74  n be set at runt
0a30: 69 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65 20  ime using.  the 
0a40: 5b 50 52 41 47 4d 41 20 6c 65 67 61 63 79 5f 66  [PRAGMA legacy_f
0a50: 69 6c 65 5f 66 6f 72 6d 61 74 5d 20 63 6f 6d 6d  ile_format] comm
0a60: 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  and..}..COMPILE_
0a70: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44  OPTION {SQLITE_D
0a80: 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45  EFAULT_PAGE_SIZE
0a90: 3d 3c 69 3e 26 6c 74 3b 62 79 74 65 73 26 67 74  =<i>&lt;bytes&gt
0aa0: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
0ab0: 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f  macro is used to
0ac0: 20 73 65 74 20 74 68 65 20 64 65 66 61 75 6c 74   set the default
0ad0: 20 70 61 67 65 2d 73 69 7a 65 20 75 73 65 64 20   page-size used 
0ae0: 77 68 65 6e 20 61 0a 20 20 64 61 74 61 62 61 73  when a.  databas
0af0: 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 54 68  e is created. Th
0b00: 65 20 76 61 6c 75 65 20 61 73 73 69 67 6e 65 64  e value assigned
0b10: 20 6d 75 73 74 20 62 65 20 61 20 70 6f 77 65 72   must be a power
0b20: 20 6f 66 20 32 2e 20 54 68 65 0a 20 20 64 65 66   of 2. The.  def
0b30: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 31 30  ault value is 10
0b40: 32 34 2e 20 54 68 65 20 63 6f 6d 70 69 6c 65 2d  24. The compile-
0b50: 74 69 6d 65 20 64 65 66 61 75 6c 74 20 6d 61 79  time default may
0b60: 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 61   be overridden a
0b70: 74 20 0a 20 20 72 75 6e 74 69 6d 65 20 62 79 20  t .  runtime by 
0b80: 74 68 65 20 5b 50 52 41 47 4d 41 20 70 61 67 65  the [PRAGMA page
0b90: 5f 73 69 7a 65 5d 20 63 6f 6d 6d 61 6e 64 2e 0a  _size] command..
0ba0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
0bb0: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
0bc0: 54 5f 54 45 4d 50 5f 43 41 43 48 45 5f 53 49 5a  T_TEMP_CACHE_SIZ
0bd0: 45 3d 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26 67  E=<i>&lt;pages&g
0be0: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
0bf0: 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65 20   macro sets the 
0c00: 64 65 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20  default size of 
0c10: 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 66  the page-cache f
0c20: 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c  or temporary fil
0c30: 65 73 0a 20 20 63 72 65 61 74 65 64 20 62 79 20  es.  created by 
0c40: 53 51 4c 69 74 65 20 74 6f 20 73 74 6f 72 65 20  SQLite to store 
0c50: 69 6e 74 65 72 6d 65 64 69 61 74 65 20 72 65 73  intermediate res
0c60: 75 6c 74 73 2c 20 69 6e 20 70 61 67 65 73 2e 20  ults, in pages. 
0c70: 49 74 20 64 6f 65 73 0a 20 20 6e 6f 74 20 61 66  It does.  not af
0c80: 66 65 63 74 20 74 68 65 20 70 61 67 65 2d 63 61  fect the page-ca
0c90: 63 68 65 20 66 6f 72 20 74 68 65 20 74 65 6d 70  che for the temp
0ca0: 20 64 61 74 61 62 61 73 65 2c 20 77 68 65 72 65   database, where
0cb0: 20 74 61 62 6c 65 73 20 63 72 65 61 74 65 64 0a   tables created.
0cc0: 20 20 75 73 69 6e 67 20 5b 43 52 45 41 54 45 20    using [CREATE 
0cd0: 54 41 42 4c 45 20 7c 20 43 52 45 41 54 45 20 54  TABLE | CREATE T
0ce0: 45 4d 50 20 54 41 42 4c 45 5d 20 61 72 65 20 73  EMP TABLE] are s
0cf0: 74 6f 72 65 64 2e 20 54 68 65 20 64 65 66 61 75  tored. The defau
0d00: 6c 74 20 76 61 6c 75 65 0a 20 20 69 73 20 35 30  lt value.  is 50
0d10: 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  0..}..COMPILE_OP
0d20: 54 49 4f 4e 20 7b 59 59 53 54 41 43 4b 44 45 50  TION {YYSTACKDEP
0d30: 54 48 3d 3c 69 3e 26 6c 74 3b 6d 61 78 5f 64 65  TH=<i>&lt;max_de
0d40: 70 74 68 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20  pth&gt;</i>} {. 
0d50: 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73   This macro sets
0d60: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70   the maximum dep
0d70: 74 68 20 6f 66 20 74 68 65 20 4c 41 4c 52 28 31  th of the LALR(1
0d80: 29 20 73 74 61 63 6b 20 75 73 65 64 20 62 79 0a  ) stack used by.
0d90: 20 20 74 68 65 20 53 51 4c 20 70 61 72 73 65 72    the SQL parser
0da0: 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 2e 20   within SQLite. 
0db0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   The default val
0dc0: 75 65 20 69 73 20 31 30 30 2e 20 20 41 20 74 79  ue is 100.  A ty
0dd0: 70 69 63 61 6c 0a 20 20 61 70 70 6c 69 63 61 74  pical.  applicat
0de0: 69 6f 6e 20 77 69 6c 6c 20 75 73 65 20 6c 65 73  ion will use les
0df0: 73 20 74 68 61 6e 20 61 62 6f 75 74 20 32 30 20  s than about 20 
0e00: 6c 65 76 65 6c 73 20 6f 66 20 74 68 65 20 73 74  levels of the st
0e10: 61 63 6b 2e 0a 20 20 44 65 76 65 6c 6f 70 65 72  ack..  Developer
0e20: 73 20 77 68 6f 73 65 20 61 70 70 6c 69 63 61 74  s whose applicat
0e30: 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 20 53 51 4c  ions contain SQL
0e40: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74   statements that
0e50: 20 0a 20 20 6e 65 65 64 20 6d 6f 72 65 20 74 68   .  need more th
0e60: 61 6e 20 31 30 30 20 4c 41 4c 52 28 31 29 20 73  an 100 LALR(1) s
0e70: 74 61 63 6b 20 65 6e 74 72 69 65 73 20 73 68 6f  tack entries sho
0e80: 75 6c 64 20 73 65 72 69 6f 75 73 6c 79 0a 20 20  uld seriously.  
0e90: 63 6f 6e 73 69 64 65 72 20 72 65 66 61 63 74 6f  consider refacto
0ea0: 72 69 6e 67 20 74 68 65 69 72 20 53 51 4c 20 61  ring their SQL a
0eb0: 73 20 69 74 20 69 73 20 6c 69 6b 65 6c 79 20 74  s it is likely t
0ec0: 6f 20 62 65 20 77 65 6c 6c 20 62 65 79 6f 6e 64  o be well beyond
0ed0: 0a 20 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f  .  the ability o
0ee0: 66 20 61 6e 79 20 68 75 6d 61 6e 20 74 6f 20 63  f any human to c
0ef0: 6f 6d 70 72 65 68 65 6e 64 2e 0a 7d 0a 3c 2f 74  omprehend..}.</t
0f00: 63 6c 3e 0a 0a 3c 68 32 3e 31 2e 32 20 4f 70 74  cl>..<h2>1.2 Opt
0f10: 69 6f 6e 73 20 54 6f 20 53 65 74 20 53 69 7a 65  ions To Set Size
0f20: 20 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a 0a 3c 70   Limits</h2>..<p
0f30: 3e 54 68 65 72 65 20 61 72 65 20 63 6f 6d 70 69  >There are compi
0f40: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le-time options 
0f50: 74 68 61 74 20 77 69 6c 6c 20 73 65 74 20 75 70  that will set up
0f60: 70 65 72 20 62 6f 75 6e 64 73 0a 6f 6e 20 74 68  per bounds.on th
0f70: 65 20 73 69 7a 65 73 20 6f 66 20 76 61 72 69 6f  e sizes of vario
0f80: 75 73 20 73 74 72 75 63 74 75 72 65 73 20 69 6e  us structures in
0f90: 20 53 51 4c 69 74 65 2e 20 20 54 68 65 20 63 6f   SQLite.  The co
0fa0: 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f  mpile-time.optio
0fb0: 6e 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65 74 20  ns normally set 
0fc0: 61 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75  a hard upper bou
0fd0: 6e 64 20 77 68 69 63 68 20 63 61 6e 20 62 65 20  nd which can be 
0fe0: 63 68 61 6e 67 65 64 0a 61 74 20 72 75 6e 2d 74  changed.at run-t
0ff0: 69 6d 65 20 6f 6e 20 69 6e 64 69 76 69 64 75 61  ime on individua
1000: 6c 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  l [database conn
1010: 65 63 74 69 6f 6e 73 5d 20 75 73 69 6e 67 20 74  ections] using t
1020: 68 65 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69  he.[sqlite3_limi
1030: 74 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 3c  t()] interface.<
1040: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d 70  /p>..<p>The comp
1050: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73  ile-time options
1060: 20 66 6f 72 20 73 65 74 74 69 6e 67 20 75 70 70   for setting upp
1070: 65 72 20 62 6f 75 6e 64 73 20 61 72 65 0a 5b 6c  er bounds are.[l
1080: 69 6d 69 74 73 20 7c 20 64 6f 63 75 6d 65 6e 74  imits | document
1090: 65 64 20 73 65 70 61 72 61 74 65 6c 79 5d 2e 20  ed separately]. 
10a0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69   The following i
10b0: 73 20 61 20 6c 69 73 74 20 6f 66 0a 74 68 65 20  s a list of.the 
10c0: 61 76 61 69 6c 61 62 6c 65 20 73 65 74 74 69 6e  available settin
10d0: 67 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c  gs:</p>..<ul>.<l
10e0: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 41  i> [SQLITE_MAX_A
10f0: 54 54 41 43 48 45 44 5d 20 20 3c 2f 6c 69 3e 0a  TTACHED]  </li>.
1100: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
1110: 5f 43 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69 3e 0a  _COLUMN]  </li>.
1120: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
1130: 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54  _COMPOUND_SELECT
1140: 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53  ]  </li>.<li> [S
1150: 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44  QLITE_MAX_EXPR_D
1160: 45 50 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69  EPTH]  </li>.<li
1170: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55  > [SQLITE_MAX_FU
1180: 4e 43 54 49 4f 4e 5f 41 52 47 5d 20 20 3c 2f 6c  NCTION_ARG]  </l
1190: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
11a0: 4d 41 58 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c  MAX_LENGTH]  </l
11b0: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
11c0: 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e  MAX_LIKE_PATTERN
11d0: 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a  _LENGTH]  </li>.
11e0: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
11f0: 5f 50 41 47 45 5f 43 4f 55 4e 54 5d 20 20 3c 2f  _PAGE_COUNT]  </
1200: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45  li>.<li> [SQLITE
1210: 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 5d 20  _MAX_PAGE_SIZE] 
1220: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c   </li>.<li> [SQL
1230: 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47  ITE_MAX_SQL_LENG
1240: 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20  TH]  </li>.<li> 
1250: 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49  [SQLITE_MAX_VARI
1260: 41 42 4c 45 5f 4e 55 4d 42 45 52 5d 20 20 3c 2f  ABLE_NUMBER]  </
1270: 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 61 20 6e 61  li>.</ul>..<a na
1280: 6d 65 3d 22 63 6f 6e 74 72 6f 6c 66 65 61 74 75  me="controlfeatu
1290: 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e  res"></a>.<h2>1.
12a0: 33 20 4f 70 74 69 6f 6e 73 20 54 6f 20 43 6f 6e  3 Options To Con
12b0: 74 72 6f 6c 20 4f 70 65 72 61 74 69 6e 67 20 43  trol Operating C
12c0: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 3c 2f  haracteristics</
12d0: 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49  h2>..<tcl>.COMPI
12e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
12f0: 45 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 7d  E_SECURE_DELETE}
1300: 20 7b 0a 20 20 54 68 69 73 20 63 6f 6d 70 69 6c   {.  This compil
1310: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 63 61  e-time option ca
1320: 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f  uses SQLite to o
1330: 76 65 72 77 72 69 74 65 20 64 65 6c 65 74 65 64  verwrite deleted
1340: 0a 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77  .  information w
1350: 69 74 68 20 7a 65 72 6f 73 20 69 6e 20 61 64 64  ith zeros in add
1360: 69 74 69 6f 6e 20 74 6f 20 6d 61 72 6b 69 6e 67  ition to marking
1370: 20 74 68 65 20 73 70 61 63 65 0a 20 20 61 73 20   the space.  as 
1380: 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65  available for re
1390: 75 73 65 2e 20 20 57 69 74 68 6f 75 74 20 74 68  use.  Without th
13a0: 69 73 20 6f 70 74 69 6f 6e 2c 20 64 65 6c 65 74  is option, delet
13b0: 65 64 20 64 61 74 61 0a 20 20 6d 69 67 68 74 20  ed data.  might 
13c0: 62 65 20 72 65 63 6f 76 65 72 61 62 6c 65 20 66  be recoverable f
13d0: 72 6f 6d 20 61 20 64 61 74 61 62 61 73 65 20 75  rom a database u
13e0: 73 69 6e 67 20 61 20 62 69 6e 61 72 79 20 65 64  sing a binary ed
13f0: 69 74 6f 72 2e 0a 20 20 48 6f 77 65 76 65 72 2c  itor..  However,
1400: 20 74 68 65 72 65 20 69 73 20 61 20 70 65 72 66   there is a perf
1410: 6f 72 6d 61 6e 63 65 20 70 65 6e 61 6c 74 79 20  ormance penalty 
1420: 66 6f 72 20 75 73 69 6e 67 20 74 68 69 73 20 6f  for using this o
1430: 70 74 69 6f 6e 2e 0a 0a 20 20 54 68 69 73 20 6f  ption...  This o
1440: 70 74 69 6f 6e 20 64 6f 65 73 20 3c 75 3e 6e 6f  ption does <u>no
1450: 74 3c 2f 75 3e 20 63 61 75 73 65 20 64 65 6c 65  t</u> cause dele
1460: 74 65 64 20 64 61 74 61 20 69 73 20 73 65 63 75  ted data is secu
1470: 72 65 6c 79 0a 20 20 72 65 6d 6f 76 65 64 20 66  rely.  removed f
1480: 72 6f 6d 20 74 68 65 20 75 6e 64 65 72 6c 79 69  rom the underlyi
1490: 6e 67 20 73 74 6f 72 61 67 65 20 6d 65 64 69 61  ng storage media
14a0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
14b0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 54 48 52 45  ION {SQLITE_THRE
14c0: 41 44 53 41 46 45 3d 3c 69 3e 26 6c 74 3b 30 20  ADSAFE=<i>&lt;0 
14d0: 6f 72 20 31 20 6f 72 20 32 26 67 74 3b 3c 2f 69  or 1 or 2&gt;</i
14e0: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  >} {.  This opti
14f0: 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74  on controls whet
1500: 68 65 72 20 6f 72 20 6e 6f 74 20 63 6f 64 65 20  her or not code 
1510: 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 53  is included in S
1520: 51 4c 69 74 65 20 74 6f 0a 20 20 65 6e 61 62 6c  QLite to.  enabl
1530: 65 20 69 74 20 74 6f 20 6f 70 65 72 61 74 65 20  e it to operate 
1540: 73 61 66 65 6c 79 20 69 6e 20 61 20 6d 75 6c 74  safely in a mult
1550: 69 74 68 72 65 61 64 65 64 20 65 6e 76 69 72 6f  ithreaded enviro
1560: 6e 6d 65 6e 74 2e 20 20 54 68 65 0a 20 20 64 65  nment.  The.  de
1570: 66 61 75 6c 74 20 69 73 20 53 51 4c 49 54 45 5f  fault is SQLITE_
1580: 54 48 52 45 41 44 53 41 46 45 3d 31 20 77 68 69  THREADSAFE=1 whi
1590: 63 68 20 69 73 20 73 61 66 65 20 66 6f 72 20 75  ch is safe for u
15a0: 73 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72  se in a multithr
15b0: 65 61 64 65 64 0a 20 20 65 6e 76 69 72 6f 6e 6d  eaded.  environm
15c0: 65 6e 74 2e 20 20 57 68 65 6e 20 63 6f 6d 70 69  ent.  When compi
15d0: 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f  led with SQLITE_
15e0: 54 48 52 45 41 44 53 41 46 45 3d 30 20 61 6c 6c  THREADSAFE=0 all
15f0: 20 6d 75 74 65 78 69 6e 67 20 63 6f 64 65 0a 20   mutexing code. 
1600: 20 69 73 20 6f 6d 69 74 74 65 64 20 61 6e 64 20   is omitted and 
1610: 69 74 20 69 73 20 75 6e 73 61 66 65 20 74 6f 20  it is unsafe to 
1620: 75 73 65 20 53 51 4c 69 74 65 20 69 6e 20 61 20  use SQLite in a 
1630: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 70 72  multithreaded pr
1640: 6f 67 72 61 6d 2e 0a 20 20 57 68 65 6e 20 63 6f  ogram..  When co
1650: 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49  mpiled with SQLI
1660: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 32 2c  TE_THREADSAFE=2,
1670: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 75   SQLite can be u
1680: 73 65 64 20 69 6e 20 61 20 6d 75 6c 74 69 74 68  sed in a multith
1690: 72 65 61 64 65 64 0a 20 20 70 72 6f 67 72 61 6d  readed.  program
16a0: 20 73 6f 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74   so long as no t
16b0: 77 6f 20 74 68 72 65 61 64 73 20 61 74 74 65 6d  wo threads attem
16c0: 70 74 20 74 6f 20 75 73 65 20 74 68 65 20 73 61  pt to use the sa
16d0: 6d 65 0a 20 20 5b 64 61 74 61 62 61 73 65 20 63  me.  [database c
16e0: 6f 6e 6e 65 63 74 69 6f 6e 5d 20 61 74 20 74 68  onnection] at th
16f0: 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 20 20  e same time...  
1700: 54 68 65 20 76 61 6c 75 65 20 6f 66 20 53 51 4c  The value of SQL
1710: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 63  ITE_THREADSAFE c
1720: 61 6e 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64  an be determined
1730: 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a 20 20 75   at run-time.  u
1740: 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65  sing the [sqlite
1750: 33 5f 74 68 72 65 61 64 73 61 66 65 28 29 5d 20  3_threadsafe()] 
1760: 69 6e 74 65 72 66 61 63 65 2e 0a 0a 20 20 57 68  interface...  Wh
1770: 65 6e 20 53 51 4c 69 74 65 20 68 61 73 20 62 65  en SQLite has be
1780: 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  en compiled with
1790: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
17a0: 46 45 3d 31 20 6f 72 0a 20 20 53 51 4c 49 54 45  FE=1 or.  SQLITE
17b0: 5f 54 48 52 45 41 44 53 41 46 45 3d 32 20 74 68  _THREADSAFE=2 th
17c0: 65 6e 20 74 68 65 20 5b 74 68 72 65 61 64 69 6e  en the [threadin
17d0: 67 20 6d 6f 64 65 5d 0a 20 20 63 61 6e 20 62 65  g mode].  can be
17e0: 20 61 6c 74 65 72 65 64 20 61 74 20 72 75 6e 2d   altered at run-
17f0: 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 20 5b  time using the [
1800: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29  sqlite3_config()
1810: 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 67 65  ] interface toge
1820: 74 68 65 72 0a 20 20 77 69 74 68 20 74 68 65 20  ther.  with the 
1830: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53  [SQLITE_CONFIG_S
1840: 49 4e 47 4c 45 54 48 52 45 41 44 5d 2c 20 5b 53  INGLETHREAD], [S
1850: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c  QLITE_CONFIG_MUL
1860: 54 49 54 48 52 45 41 44 5d 2c 20 61 6e 64 0a 20  TITHREAD], and. 
1870: 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f   [SQLITE_CONFIG_
1880: 53 45 52 49 41 4c 49 5a 45 44 5d 20 76 65 72 62  SERIALIZED] verb
1890: 73 2e 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f  s.  The [SQLITE_
18a0: 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 5d 20 61 6e  OPEN_NOMUTEX] an
18b0: 64 0a 20 20 5b 53 51 4c 49 54 45 5f 4f 50 45 4e  d.  [SQLITE_OPEN
18c0: 5f 46 55 4c 4c 4d 55 54 45 58 5d 20 66 6c 61 67  _FULLMUTEX] flag
18d0: 73 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70  s to [sqlite3_op
18e0: 65 6e 5f 76 32 28 29 5d 20 63 61 6e 20 61 6c 73  en_v2()] can als
18f0: 6f 20 62 65 20 75 73 65 64 0a 20 20 74 6f 20 61  o be used.  to a
1900: 64 6a 75 73 74 20 74 68 65 20 5b 74 68 72 65 61  djust the [threa
1910: 64 69 6e 67 20 6d 6f 64 65 5d 20 6f 66 20 69 6e  ding mode] of in
1920: 64 69 76 69 64 75 61 6c 20 5b 64 61 74 61 62 61  dividual [databa
1930: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 0a  se connections].
1940: 20 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a    at run-time...
1950: 20 20 53 65 65 20 74 68 65 20 5b 74 68 72 65 61    See the [threa
1960: 64 69 6e 67 20 6d 6f 64 65 5d 20 64 6f 63 75 6d  ding mode] docum
1970: 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 64 64  entation for add
1980: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
1990: 69 6f 6e 0a 20 20 6f 6e 20 61 73 70 65 63 74 73  ion.  on aspects
19a0: 20 6f 66 20 75 73 69 6e 67 20 53 51 4c 69 74 65   of using SQLite
19b0: 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61   in a multithrea
19c0: 64 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e  ded environment.
19d0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
19e0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 54 45 4d 50 5f  ON {SQLITE_TEMP_
19f0: 53 54 4f 52 45 3d 3c 69 3e 26 6c 74 3b 30 20 74  STORE=<i>&lt;0 t
1a00: 68 72 6f 75 67 68 20 33 26 67 74 3b 3c 2f 69 3e  hrough 3&gt;</i>
1a10: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
1a20: 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68  n controls wheth
1a30: 65 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c  er temporary fil
1a40: 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 6f 6e  es are stored on
1a50: 20 64 69 73 6b 20 6f 72 0a 20 20 69 6e 20 6d 65   disk or.  in me
1a60: 6d 6f 72 79 2e 20 20 54 68 65 20 6d 65 61 6e 69  mory.  The meani
1a70: 6e 67 73 20 66 6f 72 20 76 61 72 69 6f 75 73 20  ngs for various 
1a80: 73 65 74 74 69 6e 67 73 20 6f 66 20 74 68 69 73  settings of this
1a90: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20   compile-time.  
1aa0: 6f 70 74 69 6f 6e 20 61 72 65 20 61 73 20 66 6f  option are as fo
1ab0: 6c 6c 6f 77 73 3a 0a 0a 20 20 3c 74 61 62 6c 65  llows:..  <table
1ac0: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 32 22   cellpadding="2"
1ad0: 20 62 6f 72 64 65 72 3d 22 31 22 3e 0a 20 20 3c   border="1">.  <
1ae0: 74 72 3e 3c 74 68 3e 53 51 4c 49 54 45 5f 54 45  tr><th>SQLITE_TE
1af0: 4d 50 5f 53 54 4f 52 45 3c 2f 74 68 3e 3c 74 68  MP_STORE</th><th
1b00: 3e 4d 65 61 6e 69 6e 67 3c 2f 74 68 3e 3c 2f 74  >Meaning</th></t
1b10: 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69  r>.  <tr><td ali
1b20: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 30 3c 2f 74  gn="center">0</t
1b30: 64 3e 3c 74 64 3e 41 6c 77 61 79 73 20 75 73 65  d><td>Always use
1b40: 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73   temporary files
1b50: 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72  </td></tr>.  <tr
1b60: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74  ><td align="cent
1b70: 65 72 22 3e 31 3c 2f 74 64 3e 3c 74 64 3e 55 73  er">1</td><td>Us
1b80: 65 20 66 69 6c 65 73 20 62 79 20 64 65 66 61 75  e files by defau
1b90: 6c 74 20 62 75 74 20 61 6c 6c 6f 77 20 74 68 65  lt but allow the
1ba0: 0a 20 20 5b 50 52 41 47 4d 41 20 74 65 6d 70 5f  .  [PRAGMA temp_
1bb0: 73 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e 64 20 74  store] command t
1bc0: 6f 20 6f 76 65 72 72 69 64 65 3c 2f 74 64 3e 3c  o override</td><
1bd0: 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61  /tr>.  <tr><td a
1be0: 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 32 3c  lign="center">2<
1bf0: 2f 74 64 3e 3c 74 64 3e 55 73 65 20 6d 65 6d 6f  /td><td>Use memo
1c00: 72 79 20 62 79 20 64 65 66 61 75 6c 74 20 62 75  ry by default bu
1c10: 74 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20 5b 50  t allow the.  [P
1c20: 52 41 47 4d 41 20 74 65 6d 70 5f 73 74 6f 72 65  RAGMA temp_store
1c30: 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76 65  ] command to ove
1c40: 72 72 69 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a  rride</td></tr>.
1c50: 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d    <tr><td align=
1c60: 22 63 65 6e 74 65 72 22 3e 33 3c 2f 74 64 3e 3c  "center">3</td><
1c70: 74 64 3e 41 6c 77 61 79 73 20 75 73 65 20 6d 65  td>Always use me
1c80: 6d 6f 72 79 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20  mory</td></tr>. 
1c90: 20 3c 2f 74 61 62 6c 65 3e 0a 0a 20 20 54 68 65   </table>..  The
1ca0: 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67   default setting
1cb0: 20 69 73 20 31 2e 20 20 0a 20 20 41 64 64 69 74   is 1.  .  Addit
1cc0: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
1cd0: 6e 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69  n can be found i
1ce0: 6e 20 5b 74 65 6d 70 73 74 6f 72 65 20 7c 20 74  n [tempstore | t
1cf0: 65 6d 70 66 69 6c 65 73 2e 68 74 6d 6c 5d 2e 0a  empfiles.html]..
1d00: 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d  }.</tcl>..<a nam
1d10: 65 3d 22 65 6e 61 62 6c 65 66 65 61 74 75 72 65  e="enablefeature
1d20: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 34 20  s"></a>.<h2>1.4 
1d30: 4f 70 74 69 6f 6e 73 20 54 6f 20 45 6e 61 62 6c  Options To Enabl
1d40: 65 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d 61  e Features Norma
1d50: 6c 6c 79 20 54 75 72 6e 65 64 20 4f 66 66 3c 2f  lly Turned Off</
1d60: 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49  h2>..<tcl>.COMPI
1d70: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
1d80: 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f  E_ENABLE_ATOMIC_
1d90: 57 52 49 54 45 7d 20 7b 0a 20 20 49 66 20 74 68  WRITE} {.  If th
1da0: 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f  is C-preprocesso
1db0: 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  r macro is defin
1dc0: 65 64 20 61 6e 64 20 69 66 20 74 68 65 0a 20 20  ed and if the.  
1dd0: 78 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72  xDeviceCharacter
1de0: 69 73 74 69 63 73 20 6d 65 74 68 6f 64 20 6f 66  istics method of
1df0: 20 5b 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74   [sqlite3_io_met
1e00: 68 6f 64 73 5d 20 6f 62 6a 65 63 74 20 66 6f 72  hods] object for
1e10: 0a 20 20 61 20 64 61 74 61 62 61 73 65 20 66 69  .  a database fi
1e20: 6c 65 20 72 65 70 6f 72 74 73 20 28 76 69 61 20  le reports (via 
1e30: 6f 6e 65 20 6f 66 20 74 68 65 20 5b 53 51 4c 49  one of the [SQLI
1e40: 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 5d  TE_IOCAP_ATOMIC]
1e50: 20 62 69 74 73 29 0a 20 20 74 68 61 74 20 74 68   bits).  that th
1e60: 65 20 66 69 6c 65 73 79 73 74 65 6d 20 73 75 70  e filesystem sup
1e70: 70 6f 72 74 73 20 61 74 6f 6d 69 63 20 77 72 69  ports atomic wri
1e80: 74 65 73 20 61 6e 64 20 69 66 20 61 20 74 72 61  tes and if a tra
1e90: 6e 73 61 63 74 69 6f 6e 0a 20 20 69 6e 76 6f 6c  nsaction.  invol
1ea0: 76 65 73 20 61 20 63 68 61 6e 67 65 20 74 6f 20  ves a change to 
1eb0: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 70 61  only a single pa
1ec0: 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  ge of the databa
1ed0: 73 65 20 66 69 6c 65 2c 0a 20 20 74 68 65 6e 20  se file,.  then 
1ee0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
1ef0: 63 6f 6d 6d 69 74 73 20 77 69 74 68 20 6a 75 73  commits with jus
1f00: 74 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65  t a single write
1f10: 20 72 65 71 75 65 73 74 20 6f 66 0a 20 20 61 20   request of.  a 
1f20: 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74  single page of t
1f30: 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  he database and 
1f40: 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72  no rollback jour
1f50: 6e 61 6c 20 69 73 20 63 72 65 61 74 65 64 0a 20  nal is created. 
1f60: 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 4f 6e   or written.  On
1f70: 20 66 69 6c 65 73 79 73 74 65 6d 73 20 74 68 61   filesystems tha
1f80: 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63  t support atomic
1f90: 20 77 72 69 74 65 73 2c 20 74 68 69 73 0a 20 20   writes, this.  
1fa0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e  optimization can
1fb0: 20 72 65 73 75 6c 74 20 69 6e 20 73 69 67 6e 69   result in signi
1fc0: 66 69 63 61 6e 74 20 73 70 65 65 64 20 69 6d 70  ficant speed imp
1fd0: 72 6f 76 65 6d 65 6e 74 73 20 66 6f 72 0a 20 20  rovements for.  
1fe0: 73 6d 61 6c 6c 20 75 70 64 61 74 65 73 2e 20 20  small updates.  
1ff0: 48 6f 77 65 76 65 72 2c 20 66 65 77 20 66 69 6c  However, few fil
2000: 65 73 79 73 74 65 6d 73 20 73 75 70 70 6f 72 74  esystems support
2010: 20 74 68 69 73 20 63 61 70 61 62 69 6c 69 74 79   this capability
2020: 0a 20 20 61 6e 64 20 74 68 65 20 63 6f 64 65 20  .  and the code 
2030: 70 61 74 68 73 20 74 68 61 74 20 63 68 65 63 6b  paths that check
2040: 20 66 6f 72 20 74 68 69 73 20 63 61 70 61 62 69   for this capabi
2050: 6c 69 74 79 20 73 6c 6f 77 20 64 6f 77 6e 20 77  lity slow down w
2060: 72 69 74 65 0a 20 20 70 65 72 66 6f 72 6d 61 6e  rite.  performan
2070: 63 65 20 6f 6e 20 73 79 73 74 65 6d 73 20 74 68  ce on systems th
2080: 61 74 20 6c 61 63 6b 20 61 74 6f 6d 69 63 20 77  at lack atomic w
2090: 72 69 74 65 20 63 61 70 61 62 69 6c 69 74 79 2c  rite capability,
20a0: 20 73 6f 20 74 68 69 73 0a 20 20 66 65 61 74 75   so this.  featu
20b0: 72 65 20 69 73 20 64 69 73 61 62 6c 65 64 20 62  re is disabled b
20c0: 79 20 64 65 66 61 75 6c 74 2e 0a 7d 0a 0a 43 4f  y default..}..CO
20d0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
20e0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55  LITE_ENABLE_COLU
20f0: 4d 4e 5f 4d 45 54 41 44 41 54 41 7d 20 7b 0a 20  MN_METADATA} {. 
2100: 20 57 68 65 6e 20 74 68 69 73 20 43 2d 70 72 65   When this C-pre
2110: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
2120: 69 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69  is defined, SQLi
2130: 74 65 20 69 6e 63 6c 75 64 65 73 20 73 6f 6d 65  te includes some
2140: 0a 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 41 50  .  additional AP
2150: 49 73 20 74 68 61 74 20 70 72 6f 76 69 64 65 20  Is that provide 
2160: 63 6f 6e 76 65 6e 69 65 6e 74 20 61 63 63 65 73  convenient acces
2170: 73 20 74 6f 20 6d 65 74 61 2d 64 61 74 61 20 61  s to meta-data a
2180: 62 6f 75 74 0a 20 20 74 61 62 6c 65 73 20 61 6e  bout.  tables an
2190: 64 20 71 75 65 72 69 65 73 2e 20 20 54 68 65 20  d queries.  The 
21a0: 41 50 49 73 20 74 68 61 74 20 61 72 65 20 65 6e  APIs that are en
21b0: 61 62 6c 65 64 20 62 79 20 74 68 69 73 20 6f 70  abled by this op
21c0: 74 69 6f 6e 20 61 72 65 3a 0a 0a 20 20 3c 75 6c  tion are:..  <ul
21d0: 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65  >.  <li> [sqlite
21e0: 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73  3_column_databas
21f0: 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a  e_name()] </li>.
2200: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
2210: 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f  column_database_
2220: 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a  name16()] </li>.
2230: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
2240: 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d  column_table_nam
2250: 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69  e()] </li>.  <li
2260: 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  > [sqlite3_colum
2270: 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28 29  n_table_name16()
2280: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
2290: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f  sqlite3_column_o
22a0: 72 69 67 69 6e 5f 6e 61 6d 65 28 29 5d 20 3c 2f  rigin_name()] </
22b0: 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69  li>.  <li> [sqli
22c0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69  te3_column_origi
22d0: 6e 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69  n_name16()] </li
22e0: 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65  >.  <li> [sqlite
22f0: 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d  3_table_column_m
2300: 65 74 61 64 61 74 61 28 29 5d 20 3c 2f 6c 69 3e  etadata()] </li>
2310: 0a 20 20 3c 2f 75 6c 3e 0a 7d 0a 0a 43 4f 4d 50  .  </ul>.}..COMP
2320: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
2330: 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 7d 20  TE_ENABLE_FTS3} 
2340: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
2350: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20  tion is defined 
2360: 69 6e 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61  in the [amalgama
2370: 74 69 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 20 33  tion], version 3
2380: 0a 20 20 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74  .  of the full-t
2390: 65 78 74 20 73 65 61 72 63 68 20 65 6e 67 69 6e  ext search engin
23a0: 65 20 69 73 20 61 64 64 65 64 20 74 6f 20 74 68  e is added to th
23b0: 65 20 62 75 69 6c 64 20 61 75 74 6f 6d 61 74 69  e build automati
23c0: 63 61 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  cally..}..COMPIL
23d0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
23e0: 5f 45 4e 41 42 4c 45 5f 49 43 55 7d 20 7b 0a 20  _ENABLE_ICU} {. 
23f0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
2400: 73 65 73 20 74 68 65 20 0a 20 20 3c 61 20 68 72  ses the .  <a hr
2410: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 69  ef="http://www.i
2420: 63 75 2d 70 72 6f 6a 65 63 74 2e 6f 72 67 2f 22  cu-project.org/"
2430: 3e 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 43  >International C
2440: 6f 6d 70 6f 6e 65 6e 74 73 20 66 6f 72 20 55 6e  omponents for Un
2450: 69 63 6f 64 65 3c 2f 61 3e 0a 20 20 6f 72 20 22  icode</a>.  or "
2460: 49 43 55 22 20 65 78 74 65 6e 73 69 6f 6e 20 74  ICU" extension t
2470: 6f 20 53 51 4c 69 74 65 20 74 6f 20 62 65 20 61  o SQLite to be a
2480: 64 64 65 64 20 74 6f 20 74 68 65 20 62 75 69 6c  dded to the buil
2490: 64 2e 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  d.  .}..COMPILE_
24a0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
24b0: 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 7d 20 7b  NABLE_IOTRACE} {
24c0: 0a 20 20 57 68 65 6e 20 62 6f 74 68 20 74 68 65  .  When both the
24d0: 20 53 51 4c 69 74 65 20 63 6f 72 65 20 61 6e 64   SQLite core and
24e0: 20 74 68 65 20 5b 43 6f 6d 6d 61 6e 64 20 4c 69   the [Command Li
24f0: 6e 65 20 49 6e 74 65 72 66 61 63 65 5d 20 28 43  ne Interface] (C
2500: 4c 49 29 20 61 72 65 20 62 6f 74 68 20 0a 20 20  LI) are both .  
2510: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68  compiled with th
2520: 69 73 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20  is option, then 
2530: 74 68 65 20 43 4c 49 20 70 72 6f 76 69 64 65 73  the CLI provides
2540: 20 61 6e 20 65 78 74 72 61 20 63 6f 6d 6d 61 6e   an extra comman
2550: 64 0a 20 20 6e 61 6d 65 64 20 22 2e 69 6f 74 72  d.  named ".iotr
2560: 61 63 65 22 20 74 68 61 74 20 70 72 6f 76 69 64  ace" that provid
2570: 65 73 20 61 20 6c 6f 77 2d 6c 65 76 65 6c 20 6c  es a low-level l
2580: 6f 67 20 6f 66 20 49 2f 4f 20 61 63 74 69 76 69  og of I/O activi
2590: 74 79 2e 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  ty..  This optio
25a0: 6e 20 69 73 20 65 78 70 65 72 69 6d 65 6e 74 61  n is experimenta
25b0: 6c 20 61 6e 64 20 6d 61 79 20 62 65 20 64 69 73  l and may be dis
25c0: 63 6f 6e 74 69 6e 75 65 64 20 69 6e 20 61 20 66  continued in a f
25d0: 75 74 75 72 65 20 72 65 6c 65 61 73 65 2e 0a 7d  uture release..}
25e0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
25f0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
2600: 4c 4f 43 4b 49 4e 47 5f 53 54 59 4c 45 7d 20 7b  LOCKING_STYLE} {
2610: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65  .  This option e
2620: 6e 61 62 6c 65 73 20 61 64 64 69 74 69 6f 6e 61  nables additiona
2630: 6c 20 6c 6f 67 69 63 20 69 6e 20 74 68 65 20 4f  l logic in the O
2640: 53 20 69 6e 74 65 72 66 61 63 65 20 6c 61 79 65  S interface laye
2650: 72 20 66 6f 72 0a 20 20 4d 61 63 20 4f 53 20 58  r for.  Mac OS X
2660: 2e 20 54 68 65 20 61 64 64 69 74 69 6f 6e 61 6c  . The additional
2670: 20 6c 6f 67 69 63 20 61 74 74 65 6d 70 74 73 20   logic attempts 
2680: 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65  to determine the
2690: 20 74 79 70 65 20 6f 66 20 74 68 65 0a 20 20 75   type of the.  u
26a0: 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65 73 79  nderlying filesy
26b0: 73 74 65 6d 20 61 6e 64 20 63 68 6f 6f 73 65 20  stem and choose 
26c0: 61 6e 64 20 61 6c 74 65 72 6e 61 74 69 76 65 20  and alternative 
26d0: 6c 6f 63 6b 69 6e 67 20 73 74 72 61 74 65 67 79  locking strategy
26e0: 0a 20 20 74 68 61 74 20 77 6f 72 6b 73 20 63 6f  .  that works co
26f0: 72 72 65 63 74 6c 79 20 66 6f 72 20 74 68 61 74  rrectly for that
2700: 20 66 69 6c 65 73 79 73 74 65 6d 20 74 79 70 65   filesystem type
2710: 2e 20 46 69 76 65 20 6c 6f 63 6b 69 6e 67 20 73  . Five locking s
2720: 74 72 61 74 65 67 69 65 73 20 0a 20 20 61 72 65  trategies .  are
2730: 20 61 76 61 69 6c 61 62 6c 65 3a 0a 0a 20 20 3c   available:..  <
2740: 75 6c 3e 0a 20 20 20 20 3c 6c 69 3e 20 50 6f 73  ul>.    <li> Pos
2750: 69 78 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65  ix locking style
2760: 2e 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65  . This is the de
2770: 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 20 73 74  fault locking st
2780: 79 6c 65 20 61 6e 64 20 74 68 65 0a 20 20 20 20  yle and the.    
2790: 20 20 20 20 20 73 74 79 6c 65 20 75 73 65 64 20       style used 
27a0: 62 79 20 6f 74 68 65 72 20 28 6e 6f 6e 20 4f 53  by other (non OS
27b0: 58 29 20 75 6e 69 78 65 73 2e 20 4c 6f 63 6b 73  X) unixes. Locks
27c0: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 61 6e   are obtained an
27d0: 64 20 0a 20 20 20 20 20 20 20 20 20 72 65 6c 65  d .         rele
27e0: 61 73 65 64 20 75 73 69 6e 67 20 74 68 65 20 66  ased using the f
27f0: 63 6e 74 6c 28 29 20 73 79 73 74 65 6d 20 63 61  cntl() system ca
2800: 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 41 46  ll...    <li> AF
2810: 50 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  P locking style.
2820: 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 73 74   This locking st
2830: 79 6c 65 20 69 73 20 75 73 65 64 20 66 6f 72 20  yle is used for 
2840: 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20 0a 20 20  network file .  
2850: 20 20 20 20 20 20 20 73 79 73 74 65 6d 73 20 74         systems t
2860: 68 61 74 20 75 73 65 20 74 68 65 20 41 46 50 20  hat use the AFP 
2870: 28 41 70 70 6c 65 20 46 69 6c 69 6e 67 20 50 72  (Apple Filing Pr
2880: 6f 74 6f 63 6f 6c 29 20 70 72 6f 74 6f 63 6f 6c  otocol) protocol
2890: 2e 20 4c 6f 63 6b 73 0a 20 20 20 20 20 20 20 20  . Locks.        
28a0: 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62 79   are obtained by
28b0: 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 6c 69 62   calling the lib
28c0: 72 61 72 79 20 66 75 6e 63 74 69 6f 6e 20 5f 41  rary function _A
28d0: 46 50 46 53 53 65 74 4c 6f 63 6b 28 29 2e 0a 0a  FPFSSetLock()...
28e0: 20 20 20 20 3c 6c 69 3e 20 46 6c 6f 63 6b 20 6c      <li> Flock l
28f0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68  ocking style. Th
2900: 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 66  is is used for f
2910: 69 6c 65 2d 73 79 73 74 65 6d 73 20 74 68 61 74  ile-systems that
2920: 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 20 20 20   do not.        
2930: 20 73 75 70 70 6f 72 74 20 70 6f 73 69 78 20 6c   support posix l
2940: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20 4c 6f  ocking style. Lo
2950: 63 6b 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64  cks are obtained
2960: 20 61 6e 64 20 72 65 6c 65 61 73 65 64 20 75 73   and released us
2970: 69 6e 67 0a 20 20 20 20 20 20 20 20 20 74 68 65  ing.         the
2980: 20 66 6c 6f 63 6b 28 29 20 73 79 73 74 65 6d 20   flock() system 
2990: 63 61 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20  call...    <li> 
29a0: 44 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b 69 6e 67  Dot-file locking
29b0: 20 73 74 79 6c 65 2e 20 54 68 69 73 20 6c 6f 63   style. This loc
29c0: 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75 73  king style is us
29d0: 65 64 20 77 68 65 6e 20 6e 65 69 74 68 65 72 0a  ed when neither.
29e0: 20 20 20 20 20 20 20 20 20 66 6c 6f 63 6b 20 6e           flock n
29f0: 6f 72 20 70 6f 73 69 78 20 6c 6f 63 6b 69 6e 67  or posix locking
2a00: 20 73 74 79 6c 65 73 20 61 72 65 20 73 75 70 70   styles are supp
2a10: 6f 72 74 65 64 20 62 79 20 74 68 65 20 66 69 6c  orted by the fil
2a20: 65 20 73 79 73 74 65 6d 2e 0a 20 20 20 20 20 20  e system..      
2a30: 20 20 20 44 61 74 61 62 61 73 65 20 6c 6f 63 6b     Database lock
2a40: 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 62  s are obtained b
2a50: 79 20 63 72 65 61 74 69 6e 67 20 61 6e 64 20 65  y creating and e
2a60: 6e 74 72 79 20 69 6e 20 74 68 65 20 66 69 6c 65  ntry in the file
2a70: 2d 73 79 73 74 65 6d 0a 20 20 20 20 20 20 20 20  -system.        
2a80: 20 61 74 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e   at a well-known
2a90: 20 6c 6f 63 61 74 69 6f 6e 20 72 65 6c 61 74 69   location relati
2aa0: 76 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  ve to the databa
2ab0: 73 65 20 66 69 6c 65 20 28 61 20 22 64 6f 74 2d  se file (a "dot-
2ac0: 66 69 6c 65 22 29 0a 20 20 20 20 20 20 20 20 20  file").         
2ad0: 61 6e 64 20 72 65 6c 69 6e 71 75 69 73 68 65 64  and relinquished
2ae0: 20 62 79 20 64 65 6c 65 74 69 6e 67 20 74 68 65   by deleting the
2af0: 20 73 61 6d 65 20 66 69 6c 65 2e 0a 0a 20 20 20   same file...   
2b00: 20 3c 6c 69 3e 20 4e 6f 20 6c 6f 63 6b 69 6e 67   <li> No locking
2b10: 20 73 74 79 6c 65 2e 20 49 66 20 6e 6f 6e 65 20   style. If none 
2b20: 6f 66 20 74 68 65 20 61 62 6f 76 65 20 63 61 6e  of the above can
2b30: 20 62 65 20 73 75 70 70 6f 72 74 65 64 2c 20 74   be supported, t
2b40: 68 69 73 20 0a 20 20 20 20 20 20 20 20 20 6c 6f  his .         lo
2b50: 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73 20 75  cking style is u
2b60: 73 65 64 2e 20 4e 6f 20 64 61 74 61 62 61 73 65  sed. No database
2b70: 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69   locking mechani
2b80: 73 6d 20 69 73 20 75 73 65 64 2e 20 57 68 65 6e  sm is used. When
2b90: 0a 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73  .         this s
2ba0: 79 73 74 65 6d 20 69 73 20 75 73 65 64 20 69 74  ystem is used it
2bb0: 20 69 73 20 6e 6f 74 20 73 61 66 65 20 66 6f 72   is not safe for
2bc0: 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61   a single databa
2bd0: 73 65 20 74 6f 20 62 65 0a 20 20 20 20 20 20 20  se to be.       
2be0: 20 20 61 63 63 65 73 73 65 64 20 62 79 20 6d 75    accessed by mu
2bf0: 6c 74 69 70 6c 65 20 63 6c 69 65 6e 74 73 2e 0a  ltiple clients..
2c00: 20 20 3c 2f 75 6c 3e 0a 0a 20 20 41 64 64 69 74    </ul>..  Addit
2c10: 69 6f 6e 61 6c 6c 79 2c 20 66 69 76 65 20 65 78  ionally, five ex
2c20: 74 72 61 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e  tra VFS implemen
2c30: 74 61 74 69 6f 6e 73 20 61 72 65 20 70 72 6f 76  tations are prov
2c40: 69 64 65 64 20 61 73 20 77 65 6c 6c 20 61 73 20  ided as well as 
2c50: 74 68 65 0a 20 20 64 65 66 61 75 6c 74 2e 20 42  the.  default. B
2c60: 79 20 73 70 65 63 69 66 79 69 6e 67 20 6f 6e 65  y specifying one
2c70: 20 6f 66 20 74 68 65 20 65 78 74 72 61 20 56 46   of the extra VF
2c80: 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  S implementation
2c90: 73 20 0a 20 20 77 68 65 6e 20 63 61 6c 6c 69 6e  s .  when callin
2ca0: 67 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f  g [sqlite3_open_
2cb0: 76 32 28 29 5d 2c 20 61 6e 20 61 70 70 6c 69 63  v2()], an applic
2cc0: 61 74 69 6f 6e 20 6d 61 79 20 62 79 70 61 73 73  ation may bypass
2cd0: 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d   the file-system
2ce0: 0a 20 20 64 65 74 65 63 74 69 6f 6e 20 6c 6f 67  .  detection log
2cf0: 69 63 20 61 6e 64 20 65 78 70 6c 69 63 69 74 6c  ic and explicitl
2d00: 79 20 73 65 6c 65 63 74 20 6f 6e 65 20 6f 66 20  y select one of 
2d10: 74 68 65 20 61 62 6f 76 65 20 6c 6f 63 6b 69 6e  the above lockin
2d20: 67 20 73 74 79 6c 65 73 2e 20 54 68 65 0a 20 20  g styles. The.  
2d30: 66 69 76 65 20 65 78 74 72 61 20 56 46 53 20 69  five extra VFS i
2d40: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 61  mplementations a
2d50: 72 65 20 63 61 6c 6c 65 64 20 22 75 6e 69 78 2d  re called "unix-
2d60: 70 6f 73 69 78 22 2c 20 22 75 6e 69 78 2d 61 66  posix", "unix-af
2d70: 70 22 2c 0a 20 20 22 75 6e 69 78 2d 66 6c 6f 63  p",.  "unix-floc
2d80: 6b 22 2c 20 22 75 6e 69 78 2d 64 6f 74 66 69 6c  k", "unix-dotfil
2d90: 65 22 20 61 6e 64 20 22 75 6e 69 78 2d 6e 6f 6e  e" and "unix-non
2da0: 65 22 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  e"..}..COMPILE_O
2db0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
2dc0: 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41  ABLE_MEMORY_MANA
2dd0: 47 45 4d 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73  GEMENT} {.  This
2de0: 20 6f 70 74 69 6f 6e 20 61 64 64 73 20 65 78 74   option adds ext
2df0: 72 61 20 6c 6f 67 69 63 20 74 6f 20 53 51 4c 69  ra logic to SQLi
2e00: 74 65 20 74 68 61 74 20 61 6c 6c 6f 77 73 20 69  te that allows i
2e10: 74 20 74 6f 20 72 65 6c 65 61 73 65 20 75 6e 75  t to release unu
2e20: 73 65 64 0a 20 20 6d 65 6d 6f 72 79 20 75 70 6f  sed.  memory upo
2e30: 6e 20 72 65 71 75 65 73 74 2e 20 20 54 68 69 73  n request.  This
2e40: 20 6f 70 74 69 6f 6e 20 6d 75 73 74 20 62 65 20   option must be 
2e50: 65 6e 61 62 6c 65 64 20 69 6e 20 6f 72 64 65 72  enabled in order
2e60: 20 66 6f 72 20 74 68 65 0a 20 20 5b 73 71 6c 69   for the.  [sqli
2e70: 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f  te3_release_memo
2e80: 72 79 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20  ry()] interface 
2e90: 74 6f 20 77 6f 72 6b 2e 20 20 49 66 20 74 68 69  to work.  If thi
2ea0: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20  s compile-time. 
2eb0: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 74 20 75   option is not u
2ec0: 73 65 64 2c 20 74 68 65 20 5b 73 71 6c 69 74 65  sed, the [sqlite
2ed0: 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79  3_release_memory
2ee0: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 69 73  ()] interface is
2ef0: 20 61 20 0a 20 20 6e 6f 2d 6f 70 2e 20 20 53 69   a .  no-op.  Si
2f00: 6e 63 65 20 5b 73 71 6c 69 74 65 33 5f 73 6f 66  nce [sqlite3_sof
2f10: 74 5f 68 65 61 70 5f 6c 69 6d 69 74 28 29 5d 20  t_heap_limit()] 
2f20: 64 65 70 65 6e 64 73 20 6f 6e 0a 20 20 5b 73 71  depends on.  [sq
2f30: 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65  lite3_release_me
2f40: 6d 6f 72 79 28 29 5d 2c 20 74 68 69 73 20 6f 70  mory()], this op
2f50: 74 69 6f 6e 20 69 73 20 61 6c 73 6f 20 6e 65 63  tion is also nec
2f60: 65 73 73 61 72 79 20 66 6f 72 0a 20 20 74 68 65  essary for.  the
2f70: 20 63 6f 72 72 65 63 74 20 6f 70 65 72 61 74 69   correct operati
2f80: 6f 6e 20 6f 66 20 5b 73 71 6c 69 74 65 33 5f 73  on of [sqlite3_s
2f90: 6f 66 74 5f 68 65 61 70 5f 6c 69 6d 69 74 28 29  oft_heap_limit()
2fa0: 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  ]..}..COMPILE_OP
2fb0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
2fc0: 42 4c 45 5f 4d 45 4d 53 59 53 33 7d 20 7b 0a 20  BLE_MEMSYS3} {. 
2fd0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e 63   This option inc
2fe0: 6c 75 64 65 73 20 63 6f 64 65 20 69 6e 20 53 51  ludes code in SQ
2ff0: 4c 69 74 65 20 74 68 61 74 20 69 6d 70 6c 65 6d  Lite that implem
3000: 65 6e 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74  ents an alternat
3010: 69 76 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c  ive.  memory all
3020: 6f 63 61 74 6f 72 2e 20 20 54 68 69 73 20 61 6c  ocator.  This al
3030: 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79  ternative memory
3040: 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f 6e   allocator is on
3050: 6c 79 20 65 6e 67 61 67 65 64 0a 20 20 77 68 65  ly engaged.  whe
3060: 6e 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f  n the [SQLITE_CO
3070: 4e 46 49 47 5f 48 45 41 50 5d 20 6f 70 74 69 6f  NFIG_HEAP] optio
3080: 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63 6f  n to [sqlite3_co
3090: 6e 66 69 67 28 29 5d 20 69 73 20 75 73 65 64 20  nfig()] is used 
30a0: 74 6f 0a 20 20 73 75 70 70 6c 79 20 61 20 6c 61  to.  supply a la
30b0: 72 67 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65 6d  rge chunk of mem
30c0: 6f 72 79 20 66 72 6f 6d 20 77 68 69 63 68 20 61  ory from which a
30d0: 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  ll memory alloca
30e0: 74 69 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b 65  tions are.  take
30f0: 6e 2e 0a 20 20 54 68 65 20 4d 45 4d 53 59 53 33  n..  The MEMSYS3
3100: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
3110: 72 20 75 73 65 73 20 61 20 68 79 62 72 69 64 20  r uses a hybrid 
3120: 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 6c 67 6f 72  allocation algor
3130: 69 74 68 6d 20 0a 20 20 70 61 74 74 65 72 6e 65  ithm .  patterne
3140: 64 20 61 66 74 65 72 20 64 6c 6d 61 6c 6c 6f 63  d after dlmalloc
3150: 28 29 2e 20 20 20 4f 6e 6c 79 20 6f 6e 65 20 6f  ().   Only one o
3160: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
3170: 4d 45 4d 53 59 53 33 20 61 6e 64 20 0a 20 20 53  MEMSYS3 and .  S
3180: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d  QLITE_ENABLE_MEM
3190: 53 59 53 35 20 6d 61 79 20 62 65 20 65 6e 61 62  SYS5 may be enab
31a0: 6c 65 64 20 61 74 20 6f 6e 63 65 2e 0a 7d 0a 0a  led at once..}..
31b0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
31c0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
31d0: 4d 53 59 53 35 7d 20 7b 0a 20 20 54 68 69 73 20  MSYS5} {.  This 
31e0: 6f 70 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73 20  option includes 
31f0: 63 6f 64 65 20 69 6e 20 53 51 4c 69 74 65 20 74  code in SQLite t
3200: 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 61  hat implements a
3210: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 20 20  n alternative.  
3220: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
3230: 2e 20 20 54 68 69 73 20 61 6c 74 65 72 6e 61 74  .  This alternat
3240: 69 76 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  ive memory alloc
3250: 61 74 6f 72 20 69 73 20 6f 6e 6c 79 20 65 6e 67  ator is only eng
3260: 61 67 65 64 0a 20 20 77 68 65 6e 20 74 68 65 20  aged.  when the 
3270: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48  [SQLITE_CONFIG_H
3280: 45 41 50 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 5b  EAP] option to [
3290: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29  sqlite3_config()
32a0: 5d 20 69 73 20 75 73 65 64 20 74 6f 0a 20 20 73  ] is used to.  s
32b0: 75 70 70 6c 79 20 61 20 6c 61 72 67 65 20 63 68  upply a large ch
32c0: 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 66 72  unk of memory fr
32d0: 6f 6d 20 77 68 69 63 68 20 61 6c 6c 20 6d 65 6d  om which all mem
32e0: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20  ory allocations 
32f0: 61 72 65 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 54  are.  taken..  T
3300: 68 65 20 4d 45 4d 53 59 53 35 20 6d 6f 64 75 6c  he MEMSYS5 modul
3310: 65 20 72 6f 75 6e 64 73 20 61 6c 6c 20 61 6c 6c  e rounds all all
3320: 6f 63 61 74 69 6f 6e 73 20 75 70 20 74 6f 20 74  ocations up to t
3330: 68 65 20 6e 65 78 74 20 70 6f 77 65 72 0a 20 20  he next power.  
3340: 6f 66 20 74 77 6f 20 61 6e 64 20 75 73 65 73 20  of two and uses 
3350: 61 20 66 69 72 73 74 2d 66 69 74 2c 20 62 75 64  a first-fit, bud
3360: 64 79 2d 61 6c 6c 6f 63 61 74 6f 72 20 61 6c 67  dy-allocator alg
3370: 6f 72 69 74 68 6d 0a 20 20 74 68 61 74 20 70 72  orithm.  that pr
3380: 6f 76 69 64 65 73 20 73 74 72 6f 6e 67 20 67 75  ovides strong gu
3390: 61 72 61 6e 74 65 65 73 20 61 67 61 69 6e 73 74  arantees against
33a0: 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 61   fragmentation a
33b0: 6e 64 20 62 72 65 61 6b 64 6f 77 6e 0a 20 20 73  nd breakdown.  s
33c0: 75 62 6a 65 63 74 20 74 6f 20 63 65 72 74 61 69  ubject to certai
33d0: 6e 20 6f 70 65 72 61 74 69 6e 67 20 63 6f 6e 73  n operating cons
33e0: 74 72 61 69 6e 74 73 2e 0a 7d 0a 0a 43 4f 4d 50  traints..}..COMP
33f0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
3400: 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45 7d  TE_ENABLE_RTREE}
3410: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
3420: 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20 74   causes SQLite t
3430: 6f 20 69 6e 63 6c 75 64 65 20 73 75 70 70 6f 72  o include suppor
3440: 74 20 66 6f 72 20 74 68 65 0a 20 20 5b 72 74 72  t for the.  [rtr
3450: 65 65 20 7c 20 52 2a 54 72 65 65 20 69 6e 64 65  ee | R*Tree inde
3460: 78 20 65 78 74 65 6e 73 69 6f 6e 5d 2e 0a 7d 0a  x extension]..}.
3470: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
3480: 7b 59 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b  {YYTRACKMAXSTACK
3490: 44 45 50 54 48 7d 20 7b 0a 20 20 54 68 69 73 20  DEPTH} {.  This 
34a0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68  option causes th
34b0: 65 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72  e LALR(1) parser
34c0: 20 73 74 61 63 6b 20 64 65 70 74 68 20 74 6f 20   stack depth to 
34d0: 62 65 20 74 72 61 63 6b 65 64 0a 20 20 61 6e 64  be tracked.  and
34e0: 20 72 65 70 6f 72 74 65 64 20 75 73 69 6e 67 20   reported using 
34f0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 61  the [sqlite3_sta
3500: 74 75 73 5d 28 5b 53 51 4c 49 54 45 5f 53 54 41  tus]([SQLITE_STA
3510: 54 55 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b  TUS_PARSER_STACK
3520: 5d 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65 72 66 61  ],...).  interfa
3530: 63 65 2e 20 20 53 51 4c 69 74 65 27 73 20 4c 41  ce.  SQLite's LA
3540: 4c 52 28 31 29 20 70 61 72 73 65 72 20 68 61 73  LR(1) parser has
3550: 20 61 20 66 69 78 65 64 20 73 74 61 63 6b 20 64   a fixed stack d
3560: 65 70 74 68 0a 20 20 28 64 65 74 65 72 6d 69 6e  epth.  (determin
3570: 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69  ed at compile-ti
3580: 6d 65 20 75 73 69 6e 67 20 74 68 65 20 5b 59 59  me using the [YY
3590: 53 54 41 43 4b 44 45 50 54 48 5d 20 6f 70 74 69  STACKDEPTH] opti
35a0: 6f 6e 73 29 2e 0a 20 20 54 68 69 73 20 6f 70 74  ons)..  This opt
35b0: 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20  ion can be used 
35c0: 74 6f 20 68 65 6c 70 20 64 65 74 65 72 6d 69 6e  to help determin
35d0: 65 20 69 66 20 61 6e 20 61 70 70 6c 69 63 61 74  e if an applicat
35e0: 69 6f 6e 20 69 73 0a 20 20 67 65 74 74 69 6e 67  ion is.  getting
35f0: 20 63 6c 6f 73 65 20 74 6f 20 65 78 63 65 65 64   close to exceed
3600: 69 6e 67 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  ing the maximum 
3610: 4c 41 4c 52 28 31 29 20 73 74 61 63 6b 20 64 65  LALR(1) stack de
3620: 70 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c  pth..}.</tcl>..<
3630: 61 20 6e 61 6d 65 3d 22 6f 6d 69 74 66 65 61 74  a name="omitfeat
3640: 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31  ures"></a>.<h2>1
3650: 2e 35 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d  .5 Options To Om
3660: 69 74 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e  it Features</h2>
3670: 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69  ..<p>The followi
3680: 6e 67 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 75  ng options can u
3690: 73 65 64 20 74 6f 20 72 65 64 75 63 65 20 74 68  sed to reduce th
36a0: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63 6f  e size of the co
36b0: 6d 70 69 6c 65 64 0a 6c 69 62 72 61 72 79 20 62  mpiled.library b
36c0: 79 20 6f 6d 69 74 74 69 6e 67 20 6f 70 74 69 6f  y omitting optio
36d0: 6e 61 6c 20 66 65 61 74 75 72 65 73 2e 20 54 68  nal features. Th
36e0: 69 73 20 69 73 20 70 72 6f 62 61 62 6c 79 20 6f  is is probably o
36f0: 6e 6c 79 20 75 73 65 66 75 6c 0a 69 6e 20 65 6d  nly useful.in em
3700: 62 65 64 64 65 64 20 73 79 73 74 65 6d 73 20 77  bedded systems w
3710: 68 65 72 65 20 73 70 61 63 65 20 69 73 20 65 73  here space is es
3720: 70 65 63 69 61 6c 6c 79 20 74 69 67 68 74 2c 20  pecially tight, 
3730: 61 73 20 65 76 65 6e 20 77 69 74 68 20 61 6c 6c  as even with all
3740: 0a 66 65 61 74 75 72 65 73 20 69 6e 63 6c 75 64  .features includ
3750: 65 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69  ed the SQLite li
3760: 62 72 61 72 79 20 69 73 20 72 65 6c 61 74 69 76  brary is relativ
3770: 65 6c 79 20 73 6d 61 6c 6c 2e 20 44 6f 6e 27 74  ely small. Don't
3780: 20 66 6f 72 67 65 74 0a 74 6f 20 74 65 6c 6c 20   forget.to tell 
3790: 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 74 6f  your compiler to
37a0: 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20 62 69   optimize for bi
37b0: 6e 61 72 79 20 73 69 7a 65 21 20 28 74 68 65 20  nary size! (the 
37c0: 2d 4f 73 20 6f 70 74 69 6f 6e 20 69 66 0a 75 73  -Os option if.us
37d0: 69 6e 67 20 47 43 43 29 2e 20 20 54 65 6c 6c 69  ing GCC).  Telli
37e0: 6e 67 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72  ng your compiler
37f0: 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72   to optimize for
3800: 20 73 69 7a 65 20 75 73 75 61 6c 6c 79 20 68 61   size usually ha
3810: 73 0a 61 20 6d 75 63 68 20 6c 61 72 67 65 20 69  s.a much large i
3820: 6d 70 61 63 74 20 6f 6e 20 6c 69 62 72 61 72 79  mpact on library
3830: 20 66 6f 6f 74 70 72 69 6e 74 20 74 68 61 6e 20   footprint than 
3840: 65 6d 70 6c 6f 79 69 6e 67 20 61 6e 79 20 6f 66  employing any of
3850: 20 74 68 65 73 65 0a 63 6f 6d 70 69 6c 65 2d 74   these.compile-t
3860: 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 3c 2f 70 3e  ime options.</p>
3870: 0a 0a 3c 70 3e 54 68 65 20 6d 61 63 72 6f 73 20  ..<p>The macros 
3880: 69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20  in this section 
3890: 64 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 76  do not require v
38a0: 61 6c 75 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f  alues. The follo
38b0: 77 69 6e 67 20 0a 63 6f 6d 70 69 6c 61 74 69 6f  wing .compilatio
38c0: 6e 20 73 77 69 74 63 68 65 73 20 61 6c 6c 20 68  n switches all h
38d0: 61 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 66  ave the same eff
38e0: 65 63 74 3a 3c 62 72 3e 0a 2d 44 53 51 4c 49 54  ect:<br>.-DSQLIT
38f0: 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c  E_OMIT_ALTERTABL
3900: 45 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f  E<br>.-DSQLITE_O
3910: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 31  MIT_ALTERTABLE=1
3920: 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d  <br>.-DSQLITE_OM
3930: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 30 0a  IT_ALTERTABLE=0.
3940: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 6e 79 20  </p>..<p>If any 
3950: 6f 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73  of these options
3960: 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74 68   are defined, th
3970: 65 6e 20 74 68 65 20 73 61 6d 65 20 73 65 74 20  en the same set 
3980: 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 58  of SQLITE_OMIT_X
3990: 58 58 0a 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20  XX.options must 
39a0: 61 6c 73 6f 20 62 65 20 64 65 66 69 6e 65 64 20  also be defined 
39b0: 77 68 65 6e 20 75 73 69 6e 67 20 74 68 65 20 27  when using the '
39c0: 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74 6f 20 67  lemon' tool to g
39d0: 65 6e 65 72 61 74 65 20 61 20 70 61 72 73 65 2e  enerate a parse.
39e0: 63 0a 66 69 6c 65 2e 20 42 65 63 61 75 73 65 20  c.file. Because 
39f0: 6f 66 20 74 68 69 73 2c 20 74 68 65 73 65 20 6f  of this, these o
3a00: 70 74 69 6f 6e 73 20 6d 61 79 20 6f 6e 6c 79 20  ptions may only 
3a10: 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65  be used when the
3a20: 20 6c 69 62 72 61 72 79 20 69 73 20 62 75 69 6c   library is buil
3a30: 74 0a 66 72 6f 6d 20 73 6f 75 72 63 65 2c 20 6e  t.from source, n
3a40: 6f 74 20 66 72 6f 6d 20 74 68 65 20 5b 61 6d 61  ot from the [ama
3a50: 6c 67 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 66 72  lgamation] or fr
3a60: 6f 6d 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f  om the collectio
3a70: 6e 20 6f 66 0a 70 72 65 2d 70 61 63 6b 61 67 65  n of.pre-package
3a80: 64 20 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64  d C files provid
3a90: 65 64 20 66 6f 72 20 6e 6f 6e 2d 55 4e 49 58 20  ed for non-UNIX 
3aa0: 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f  like platforms o
3ab0: 6e 20 74 68 65 20 77 65 62 73 69 74 65 2e 0a 3c  n the website..<
3ac0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 73 65 20 22 4f  /p>..<p>These "O
3ad0: 4d 49 54 22 20 6f 70 74 69 6f 6e 73 20 61 72 65  MIT" options are
3ae0: 20 63 6f 6e 73 69 64 65 72 65 64 20 75 6e 73 75   considered unsu
3af0: 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 20 6f 66  pported.  Any of
3b00: 20 74 68 65 73 65 0a 6f 70 74 69 6f 6e 73 20 6d   these.options m
3b10: 61 79 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72  ay be removed fr
3b20: 6f 6d 20 74 68 65 20 63 6f 64 65 20 69 6e 20 61  om the code in a
3b30: 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 0a   future release.
3b40: 61 6e 64 20 77 69 74 68 6f 75 74 20 77 61 72 6e  and without warn
3b50: 69 6e 67 2e 20 20 46 6f 72 20 61 6e 79 20 70 61  ing.  For any pa
3b60: 72 74 69 63 75 6c 61 72 20 72 65 6c 65 61 73 65  rticular release
3b70: 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 73 65 0a  , some of these.
3b80: 6f 70 74 69 6f 6e 73 20 6d 61 79 20 63 61 75 73  options may caus
3b90: 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  e compile-time o
3ba0: 72 20 72 75 6e 2d 74 69 6d 65 20 66 61 69 6c 75  r run-time failu
3bb0: 72 65 73 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 0a  res.</p>..<tcl>.
3bc0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3bd0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45  SQLITE_OMIT_ALTE
3be0: 52 54 41 42 4c 45 7d 20 7b 0a 20 20 57 68 65 6e  RTABLE} {.  When
3bf0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
3c00: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 0a 20 20  defined, the .  
3c10: 5b 41 4c 54 45 52 20 54 41 42 4c 45 5d 20 63 6f  [ALTER TABLE] co
3c20: 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63  mmand is not inc
3c30: 6c 75 64 65 64 20 69 6e 20 74 68 65 20 0a 20 20  luded in the .  
3c40: 6c 69 62 72 61 72 79 2e 20 45 78 65 63 75 74 69  library. Executi
3c50: 6e 67 20 61 6e 20 5b 41 4c 54 45 52 20 54 41 42  ng an [ALTER TAB
3c60: 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61  LE] statement ca
3c70: 75 73 65 73 20 61 20 70 61 72 73 65 20 65 72 72  uses a parse err
3c80: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
3c90: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
3ca0: 49 54 5f 41 4e 41 4c 59 5a 45 7d 20 7b 0a 20 20  IT_ANALYZE} {.  
3cb0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
3cc0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
3cd0: 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61   [ANALYZE] comma
3ce0: 6e 64 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72  nd is omitted fr
3cf0: 6f 6d 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a  om.  the build..
3d00: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
3d10: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
3d20: 54 54 41 43 48 7d 20 7b 0a 20 20 57 68 65 6e 20  TTACH} {.  When 
3d30: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
3d40: 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 41 54 54  efined, the [ATT
3d50: 41 43 48 5d 20 61 6e 64 20 5b 44 45 54 41 43 48  ACH] and [DETACH
3d60: 5d 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 0a 20  ] commands are. 
3d70: 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68   omitted from th
3d80: 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50  e build..}..COMP
3d90: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
3da0: 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a  TE_OMIT_AUTHORIZ
3db0: 41 54 49 4f 4e 7d 20 7b 0a 20 20 44 65 66 69 6e  ATION} {.  Defin
3dc0: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
3dd0: 6f 6d 69 74 73 20 74 68 65 20 61 75 74 68 6f 72  omits the author
3de0: 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b  ization callback
3df0: 20 66 65 61 74 75 72 65 20 66 72 6f 6d 20 74 68   feature from th
3e00: 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 54 68 65  e.  library. The
3e10: 20 5b 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75   [sqlite3_set_au
3e20: 74 68 6f 72 69 7a 65 72 28 29 5d 20 41 50 49 20  thorizer()] API 
3e30: 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20  function is not 
3e40: 70 72 65 73 65 6e 74 0a 20 20 69 6e 20 74 68 65  present.  in the
3e50: 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d   library..}..COM
3e60: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
3e70: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 43  ITE_OMIT_AUTOINC
3e80: 52 45 4d 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73  REMENT} {.  This
3e90: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20   option is used 
3ea0: 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b  to omit the .  [
3eb0: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 5d 20 66  AUTOINCREMENT] f
3ec0: 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 20 57 68  unctionality. Wh
3ed0: 65 6e 20 74 68 69 73 20 0a 20 20 69 73 20 6d 61  en this .  is ma
3ee0: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20  cro is defined, 
3ef0: 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 64  columns declared
3f00: 20 61 73 20 0a 20 20 22 5b 49 4e 54 45 47 45 52   as .  "[INTEGER
3f10: 20 50 52 49 4d 41 52 59 20 4b 45 59 5d 20 41 55   PRIMARY KEY] AU
3f20: 54 4f 49 4e 43 52 45 4d 45 4e 54 22 0a 20 20 62  TOINCREMENT".  b
3f30: 65 68 61 76 65 20 69 6e 20 74 68 65 20 73 61 6d  ehave in the sam
3f40: 65 20 77 61 79 20 61 73 20 63 6f 6c 75 6d 6e 73  e way as columns
3f50: 20 64 65 63 6c 61 72 65 64 20 61 73 20 22 5b 49   declared as "[I
3f60: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b  NTEGER PRIMARY K
3f70: 45 59 5d 22 20 77 68 65 6e 20 61 20 0a 20 20 4e  EY]" when a .  N
3f80: 55 4c 4c 20 69 73 20 69 6e 73 65 72 74 65 64 2e  ULL is inserted.
3f90: 20 54 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75   The sqlite_sequ
3fa0: 65 6e 63 65 20 73 79 73 74 65 6d 20 74 61 62 6c  ence system tabl
3fb0: 65 20 69 73 20 6e 65 69 74 68 65 72 20 63 72 65  e is neither cre
3fc0: 61 74 65 64 2c 20 6e 6f 72 0a 20 20 72 65 73 70  ated, nor.  resp
3fd0: 65 63 74 65 64 20 69 66 20 69 74 20 61 6c 72 65  ected if it alre
3fe0: 61 64 79 20 65 78 69 73 74 73 2e 0a 7d 0a 0a 43  ady exists..}..C
3ff0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
4000: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49  QLITE_OMIT_AUTOI
4010: 4e 49 54 7d 20 7b 0a 20 20 46 6f 72 20 62 61 63  NIT} {.  For bac
4020: 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69  kwards compatibi
4030: 6c 69 74 79 20 77 69 74 68 20 6f 6c 64 65 72 20  lity with older 
4040: 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69  versions of SQLi
4050: 74 65 20 74 68 61 74 20 6c 61 63 6b 0a 20 20 74  te that lack.  t
4060: 68 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74  he [sqlite3_init
4070: 69 61 6c 69 7a 65 28 29 5d 20 69 6e 74 65 72 66  ialize()] interf
4080: 61 63 65 2c 20 74 68 65 20 5b 73 71 6c 69 74 65  ace, the [sqlite
4090: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20  3_initialize()] 
40a0: 69 6e 74 65 72 66 61 63 65 0a 20 20 69 73 20 63  interface.  is c
40b0: 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61  alled automatica
40c0: 6c 6c 79 20 75 70 6f 6e 20 65 6e 74 72 79 20 74  lly upon entry t
40d0: 6f 20 63 65 72 74 61 69 6e 20 6b 65 79 20 69 6e  o certain key in
40e0: 74 65 72 66 61 63 65 73 20 73 75 63 68 20 61 73  terfaces such as
40f0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  .  [sqlite3_open
4100: 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 76 66  ()], [sqlite3_vf
4110: 73 5f 72 65 67 69 73 74 65 72 28 29 5d 2c 20 61  s_register()], a
4120: 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6d 70 72 69  nd [sqlite3_mpri
4130: 6e 74 66 28 29 5d 2e 0a 20 20 54 68 65 20 6f 76  ntf()]..  The ov
4140: 65 72 68 65 61 64 20 6f 66 20 69 6e 76 6f 6b 69  erhead of invoki
4150: 6e 67 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74  ng [sqlite3_init
4160: 69 61 6c 69 7a 65 28 29 5d 20 61 75 74 6f 6d 61  ialize()] automa
4170: 74 69 63 61 6c 6c 79 20 69 6e 20 74 68 69 73 0a  tically in this.
4180: 20 20 77 61 79 20 6d 61 79 20 62 65 20 6f 6d 69    way may be omi
4190: 74 74 65 64 20 62 79 20 62 75 69 6c 64 69 6e 67  tted by building
41a0: 20 53 51 4c 69 74 65 20 77 69 74 68 20 74 68 65   SQLite with the
41b0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
41c0: 4f 49 4e 49 54 0a 20 20 43 2d 70 72 65 70 72 6f  OINIT.  C-prepro
41d0: 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e 20 20 57  cessor macro.  W
41e0: 68 65 6e 20 62 75 69 6c 74 20 75 73 69 6e 67 20  hen built using 
41f0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
4200: 49 4e 49 54 2c 20 53 51 4c 69 74 65 0a 20 20 77  INIT, SQLite.  w
4210: 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 6d 61 74 69  ill not automati
4220: 63 61 6c 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65  cally initialize
4230: 20 69 74 73 65 6c 66 20 61 6e 64 20 74 68 65 20   itself and the 
4240: 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73 20 72  application is r
4250: 65 71 75 69 72 65 64 0a 20 20 74 6f 20 69 6e 76  equired.  to inv
4260: 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69  oke [sqlite3_ini
4270: 74 69 61 6c 69 7a 65 28 29 5d 20 64 69 72 65 63  tialize()] direc
4280: 74 6c 79 20 70 72 69 6f 72 20 74 6f 20 62 65 67  tly prior to beg
4290: 69 6e 6e 69 6e 67 20 75 73 65 20 6f 66 20 74 68  inning use of th
42a0: 65 0a 20 20 53 51 4c 69 74 65 20 6c 69 62 72 61  e.  SQLite libra
42b0: 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ry..}..COMPILE_O
42c0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
42d0: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 7d 20 7b  IT_AUTOVACUUM} {
42e0: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
42f0: 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68  n is defined, th
4300: 65 20 6c 69 62 72 61 72 79 20 63 61 6e 6e 6f 74  e library cannot
4310: 20 63 72 65 61 74 65 20 6f 72 20 77 72 69 74 65   create or write
4320: 20 74 6f 20 0a 20 20 64 61 74 61 62 61 73 65 73   to .  databases
4330: 20 74 68 61 74 20 73 75 70 70 6f 72 74 20 5b 61   that support [a
4340: 75 74 6f 5f 76 61 63 75 75 6d 5d 2e 0a 20 20 45  uto_vacuum]..  E
4350: 78 65 63 75 74 69 6e 67 20 61 20 5b 50 52 41 47  xecuting a [PRAG
4360: 4d 41 20 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20  MA auto_vacuum] 
4370: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f 74  statement is not
4380: 20 61 6e 20 65 72 72 6f 72 0a 20 20 28 73 69 6e   an error.  (sin
4390: 63 65 20 75 6e 6b 6e 6f 77 6e 20 50 52 41 47 4d  ce unknown PRAGM
43a0: 41 73 20 61 72 65 20 73 69 6c 65 6e 74 6c 79 20  As are silently 
43b0: 69 67 6e 6f 72 65 64 29 2c 20 62 75 74 20 64 6f  ignored), but do
43c0: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 61 20  es not return a 
43d0: 76 61 6c 75 65 0a 20 20 6f 72 20 6d 6f 64 69 66  value.  or modif
43e0: 79 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75  y the auto-vacuu
43f0: 6d 20 66 6c 61 67 20 69 6e 20 74 68 65 20 64 61  m flag in the da
4400: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 20  tabase file. If 
4410: 61 20 64 61 74 61 62 61 73 65 20 74 68 61 74 0a  a database that.
4420: 20 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d    supports auto-
4430: 76 61 63 75 75 6d 20 69 73 20 6f 70 65 6e 65 64  vacuum is opened
4440: 20 62 79 20 61 20 6c 69 62 72 61 72 79 20 63 6f   by a library co
4450: 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 69 73  mpiled with this
4460: 20 6f 70 74 69 6f 6e 2c 20 69 74 0a 20 20 69 73   option, it.  is
4470: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f   automatically o
4480: 70 65 6e 65 64 20 69 6e 20 72 65 61 64 2d 6f 6e  pened in read-on
4490: 6c 79 20 6d 6f 64 65 2e 0a 7d 0a 0a 43 4f 4d 50  ly mode..}..COMP
44a0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
44b0: 54 45 5f 4f 4d 49 54 5f 42 45 54 57 45 45 4e 5f  TE_OMIT_BETWEEN_
44c0: 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a  OPTIMIZATION} {.
44d0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 69    This option di
44e0: 73 61 62 6c 65 73 20 74 68 65 20 75 73 65 20 6f  sables the use o
44f0: 66 20 69 6e 64 69 63 65 73 20 77 69 74 68 20 57  f indices with W
4500: 48 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d  HERE clause term
4510: 73 0a 20 20 74 68 61 74 20 65 6d 70 6c 6f 79 20  s.  that employ 
4520: 74 68 65 20 42 45 54 57 45 45 4e 20 6f 70 65 72  the BETWEEN oper
4530: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
4540: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4550: 4f 4d 49 54 5f 42 4c 4f 42 5f 4c 49 54 45 52 41  OMIT_BLOB_LITERA
4560: 4c 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  L} {.  When this
4570: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
4580: 65 64 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f  ed, it is not po
4590: 73 73 69 62 6c 65 20 74 6f 20 73 70 65 63 69 66  ssible to specif
45a0: 79 20 61 20 62 6c 6f 62 20 69 6e 0a 20 20 61 6e  y a blob in.  an
45b0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 75   SQL statement u
45c0: 73 69 6e 67 20 74 68 65 20 58 27 41 42 43 44 27  sing the X'ABCD'
45d0: 20 73 79 6e 74 61 78 2e 0a 7d 0a 0a 43 4f 4d 50   syntax..}..COMP
45e0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
45f0: 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f  TE_OMIT_BUILTIN_
4600: 54 45 53 54 7d 20 7b 0a 20 20 41 20 73 74 61 6e  TEST} {.  A stan
4610: 64 61 72 64 20 53 51 4c 69 74 65 20 62 75 69 6c  dard SQLite buil
4620: 64 20 69 6e 63 6c 75 64 65 73 20 61 20 73 6d 61  d includes a sma
4630: 6c 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67  ll amount of log
4640: 69 63 20 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20  ic controlled.  
4650: 62 79 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  by the [sqlite3_
4660: 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d 20  test_control()] 
4670: 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20 69  interface that i
4680: 73 20 75 73 65 64 20 74 6f 20 65 78 65 72 63 69  s used to exerci
4690: 73 65 0a 20 20 70 61 72 74 73 20 6f 66 20 74 68  se.  parts of th
46a0: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 74 68  e SQLite core th
46b0: 61 74 20 61 72 65 20 64 69 66 66 69 63 75 6c 74  at are difficult
46c0: 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20   to control and 
46d0: 6d 65 61 73 75 72 65 20 75 73 69 6e 67 0a 20 20  measure using.  
46e0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 41 50 49  the standard API
46f0: 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f  .  This option o
4700: 6d 69 74 73 20 74 68 61 74 20 62 75 69 6c 74 2d  mits that built-
4710: 69 6e 20 74 65 73 74 20 6c 6f 67 69 63 2e 0a 7d  in test logic..}
4720: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
4730: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 41   {SQLITE_OMIT_CA
4740: 53 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  ST} {.  This opt
4750: 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74  ion causes SQLit
4760: 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72  e to omit suppor
4770: 74 20 66 6f 72 20 74 68 65 20 43 41 53 54 20 6f  t for the CAST o
4780: 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50  perator..}..COMP
4790: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
47a0: 54 45 5f 4f 4d 49 54 5f 43 48 45 43 4b 7d 20 7b  TE_OMIT_CHECK} {
47b0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
47c0: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
47d0: 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72  omit support for
47e0: 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e   CHECK constrain
47f0: 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ts..}..COMPILE_O
4800: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
4810: 49 54 5f 43 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20  IT_COMPLETE} {. 
4820: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
4830: 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65 33  ses the [sqlite3
4840: 5f 63 6f 6d 70 6c 65 74 65 28 29 5d 20 61 6e 64  _complete()] and
4850: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65   [sqlite3_comple
4860: 74 65 31 36 28 29 5d 0a 20 20 69 6e 74 65 72 66  te16()].  interf
4870: 61 63 65 73 20 74 6f 20 62 65 20 6f 6d 69 74 74  aces to be omitt
4880: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
4890: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
48a0: 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45  IT_COMPOUND_SELE
48b0: 43 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  CT} {.  This opt
48c0: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
48d0: 6d 69 74 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64  mit the compound
48e0: 20 5b 53 45 4c 45 43 54 5d 20 66 75 6e 63 74 69   [SELECT] functi
48f0: 6f 6e 61 6c 69 74 79 2e 20 0a 20 20 5b 53 45 4c  onality. .  [SEL
4900: 45 43 54 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  ECT] statements 
4910: 74 68 61 74 20 75 73 65 20 74 68 65 20 0a 20 20  that use the .  
4920: 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c  UNION, UNION ALL
4930: 2c 20 49 4e 54 45 52 53 45 43 54 20 6f 72 20 45  , INTERSECT or E
4940: 58 43 45 50 54 20 63 6f 6d 70 6f 75 6e 64 20 53  XCEPT compound S
4950: 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 73 20  ELECT operators 
4960: 77 69 6c 6c 20 0a 20 20 63 61 75 73 65 20 61 20  will .  cause a 
4970: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a  parse error..}..
4980: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4990: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4e 46  SQLITE_OMIT_CONF
49a0: 4c 49 43 54 5f 43 4c 41 55 53 45 7d 20 7b 0a 20  LICT_CLAUSE} {. 
49b0: 20 49 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20   In the future, 
49c0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 77 69 6c 6c  this option will
49d0: 20 62 65 20 75 73 65 64 20 74 6f 20 6f 6d 69 74   be used to omit
49e0: 20 74 68 65 20 0a 20 20 5b 4f 4e 20 43 4f 4e 46   the .  [ON CONF
49f0: 4c 49 43 54 5d 20 63 6c 61 75 73 65 20 66 72 6f  LICT] clause fro
4a00: 6d 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d  m the library..}
4a10: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
4a20: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41   {SQLITE_OMIT_DA
4a30: 54 45 54 49 4d 45 5f 46 55 4e 43 53 7d 20 7b 0a  TETIME_FUNCS} {.
4a40: 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e    If this option
4a50: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c   is defined, SQL
4a60: 69 74 65 27 73 20 62 75 69 6c 74 2d 69 6e 20 64  ite's built-in d
4a70: 61 74 65 20 61 6e 64 20 74 69 6d 65 20 6d 61 6e  ate and time man
4a80: 69 70 75 6c 61 74 69 6f 6e 0a 20 20 66 75 6e 63  ipulation.  func
4a90: 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74 65  tions are omitte
4aa0: 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c  d. Specifically,
4ab0: 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74 69 6f   the SQL functio
4ac0: 6e 73 20 6a 75 6c 69 61 6e 64 61 79 28 29 2c 20  ns julianday(), 
4ad0: 64 61 74 65 28 29 2c 0a 20 20 74 69 6d 65 28 29  date(),.  time()
4ae0: 2c 20 64 61 74 65 74 69 6d 65 28 29 20 61 6e 64  , datetime() and
4af0: 20 73 74 72 66 74 69 6d 65 28 29 20 61 72 65 20   strftime() are 
4b00: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 54  not available. T
4b10: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 75 6d  he default colum
4b20: 6e 0a 20 20 76 61 6c 75 65 73 20 43 55 52 52 45  n.  values CURRE
4b30: 4e 54 5f 54 49 4d 45 2c 20 43 55 52 52 45 4e 54  NT_TIME, CURRENT
4b40: 5f 44 41 54 45 20 61 6e 64 20 43 55 52 52 45 4e  _DATE and CURREN
4b50: 54 5f 44 41 54 45 54 49 4d 45 20 61 72 65 20 73  T_DATETIME are s
4b60: 74 69 6c 6c 20 61 76 61 69 6c 61 62 6c 65 2e 0a  till available..
4b70: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
4b80: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44  N {SQLITE_OMIT_D
4b90: 45 43 4c 54 59 50 45 7d 20 7b 0a 20 20 54 68 69  ECLTYPE} {.  Thi
4ba0: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
4bb0: 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73  SQLite to omit s
4bc0: 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 0a 20  upport for the. 
4bd0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
4be0: 5f 64 65 63 6c 74 79 70 65 28 29 5d 20 61 6e 64  _decltype()] and
4bf0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
4c00: 5f 64 65 63 6c 74 79 70 65 31 36 28 29 5d 0a 20  _decltype16()]. 
4c10: 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a   interfaces..}..
4c20: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4c30: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b  SQLITE_OMIT_DISK
4c40: 49 4f 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  IO} {.  This opt
4c50: 69 6f 6e 20 6f 6d 69 74 73 20 61 6c 6c 20 73 75  ion omits all su
4c60: 70 70 6f 72 74 20 66 6f 72 20 77 72 69 74 69 6e  pport for writin
4c70: 67 20 74 6f 20 74 68 65 20 64 69 73 6b 20 61 6e  g to the disk an
4c80: 64 20 66 6f 72 63 65 73 0a 20 20 64 61 74 61 62  d forces.  datab
4c90: 61 73 65 73 20 74 6f 20 65 78 69 73 74 20 69 6e  ases to exist in
4ca0: 20 6d 65 6d 6f 72 79 20 6f 6e 6c 79 2e 0a 7d 0a   memory only..}.
4cb0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4cc0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50  {SQLITE_OMIT_EXP
4cd0: 4c 41 49 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69  LAIN} {.  Defini
4ce0: 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 63  ng this option c
4cf0: 61 75 73 65 73 20 74 68 65 20 5b 45 58 50 4c 41  auses the [EXPLA
4d00: 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62  IN] command to b
4d10: 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74  e omitted from t
4d20: 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 41 74  he.  library. At
4d30: 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78 65 63  tempting to exec
4d40: 75 74 65 20 61 6e 20 5b 45 58 50 4c 41 49 4e 5d  ute an [EXPLAIN]
4d50: 20 73 74 61 74 65 6d 65 6e 74 20 77 69 6c 6c 20   statement will 
4d60: 63 61 75 73 65 20 61 20 70 61 72 73 65 0a 20 20  cause a parse.  
4d70: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
4d80: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
4d90: 5f 4f 4d 49 54 5f 46 4c 41 47 5f 50 52 41 47 4d  _OMIT_FLAG_PRAGM
4da0: 41 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  AS} {.  This opt
4db0: 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72  ion omits suppor
4dc0: 74 20 66 6f 72 20 61 20 73 75 62 73 65 74 20 6f  t for a subset o
4dd0: 66 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61  f [PRAGMA] comma
4de0: 6e 64 73 20 74 68 61 74 0a 20 20 71 75 65 72 79  nds that.  query
4df0: 20 61 6e 64 20 73 65 74 20 62 6f 6f 6c 65 61 6e   and set boolean
4e00: 20 70 72 6f 70 65 72 74 69 65 73 2e 0a 7d 0a 0a   properties..}..
4e10: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4e20: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41  SQLITE_OMIT_FLOA
4e30: 54 49 4e 47 5f 50 4f 49 4e 54 7d 20 7b 0a 20 20  TING_POINT} {.  
4e40: 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75  This option is u
4e50: 73 65 64 20 74 6f 20 6f 6d 69 74 20 66 6c 6f 61  sed to omit floa
4e60: 74 69 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d 62 65  ting-point numbe
4e70: 72 20 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 74  r support from t
4e80: 68 65 20 53 51 4c 69 74 65 0a 20 20 6c 69 62 72  he SQLite.  libr
4e90: 61 72 79 2e 20 57 68 65 6e 20 73 70 65 63 69 66  ary. When specif
4ea0: 69 65 64 2c 20 73 70 65 63 69 66 79 69 6e 67 20  ied, specifying 
4eb0: 61 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74  a floating point
4ec0: 20 6e 75 6d 62 65 72 20 61 73 20 61 20 6c 69 74   number as a lit
4ed0: 65 72 61 6c 20 0a 20 20 28 69 2e 65 2e 20 22 31  eral .  (i.e. "1
4ee0: 2e 30 31 22 29 20 72 65 73 75 6c 74 73 20 69 6e  .01") results in
4ef0: 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a   a parse error..
4f00: 0a 20 20 3c 70 3e 49 6e 20 74 68 65 20 66 75 74  .  <p>In the fut
4f10: 75 72 65 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e  ure, this option
4f20: 20 6d 61 79 20 61 6c 73 6f 20 64 69 73 61 62 6c   may also disabl
4f30: 65 20 6f 74 68 65 72 20 66 6c 6f 61 74 69 6e 67  e other floating
4f40: 20 70 6f 69 6e 74 20 0a 20 20 66 75 6e 63 74 69   point .  functi
4f50: 6f 6e 61 6c 69 74 79 2c 20 66 6f 72 20 65 78 61  onality, for exa
4f60: 6d 70 6c 65 20 74 68 65 20 5b 73 71 6c 69 74 65  mple the [sqlite
4f70: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
4f80: 29 5d 2c 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f  )], .  [sqlite3_
4f90: 62 69 6e 64 5f 64 6f 75 62 6c 65 28 29 5d 2c 20  bind_double()], 
4fa0: 5b 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64  [sqlite3_value_d
4fb0: 6f 75 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b  ouble()] and.  [
4fc0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
4fd0: 6f 75 62 6c 65 28 29 5d 20 41 50 49 20 66 75 6e  ouble()] API fun
4fe0: 63 74 69 6f 6e 73 2e 0a 20 20 3c 2f 70 3e 0a 7d  ctions..  </p>.}
4ff0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
5000: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f   {SQLITE_OMIT_FO
5010: 52 45 49 47 4e 5f 4b 45 59 7d 20 7b 0a 20 20 49  REIGN_KEY} {.  I
5020: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  f this option is
5030: 20 64 65 66 69 6e 65 64 2c 20 46 4f 52 45 49 47   defined, FOREIG
5040: 4e 20 4b 45 59 20 63 6c 61 75 73 65 73 20 69 6e  N KEY clauses in
5050: 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 61 74   column declarat
5060: 69 6f 6e 73 20 61 72 65 0a 20 20 69 67 6e 6f 72  ions are.  ignor
5070: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
5080: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
5090: 49 54 5f 47 45 54 5f 54 41 42 4c 45 7d 20 7b 0a  IT_GET_TABLE} {.
50a0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
50b0: 75 73 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72  uses support for
50c0: 20 5b 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61   [sqlite3_get_ta
50d0: 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71  ble()] and.  [sq
50e0: 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65  lite3_free_table
50f0: 28 29 5d 20 74 6f 20 62 65 20 6f 6d 69 74 74 65  ()] to be omitte
5100: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
5110: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
5120: 54 5f 49 4e 43 52 42 4c 4f 42 7d 20 7b 0a 20 20  T_INCRBLOB} {.  
5130: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
5140: 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 5b  es support for [
5150: 73 71 6c 69 74 65 33 5f 62 6c 6f 62 20 7c 20 69  sqlite3_blob | i
5160: 6e 63 72 65 6d 65 6e 74 61 6c 20 42 4c 4f 42 20  ncremental BLOB 
5170: 49 2f 4f 5d 0a 20 20 74 6f 20 62 65 20 6f 6d 69  I/O].  to be omi
5180: 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tted..}..COMPILE
5190: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
51a0: 4f 4d 49 54 5f 49 4e 54 45 47 52 49 54 59 5f 43  OMIT_INTEGRITY_C
51b0: 48 45 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f  HECK} {.  This o
51c0: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70  ption omits supp
51d0: 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 69 6e 74  ort for the [int
51e0: 65 67 72 69 74 79 5f 63 68 65 63 6b 20 70 72 61  egrity_check pra
51f0: 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  gma]..}..COMPILE
5200: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
5210: 4f 4d 49 54 5f 4c 49 4b 45 5f 4f 50 54 49 4d 49  OMIT_LIKE_OPTIMI
5220: 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73  ZATION} {.  This
5230: 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 20   option disable 
5240: 74 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53  the ability of S
5250: 51 4c 69 74 65 20 74 6f 20 75 73 65 20 69 6e 64  QLite to use ind
5260: 69 63 65 73 20 74 6f 20 68 65 6c 70 0a 20 20 72  ices to help.  r
5270: 65 73 6f 6c 76 65 20 5b 4c 49 4b 45 5d 20 61 6e  esolve [LIKE] an
5280: 64 20 5b 47 4c 4f 42 5d 20 6f 70 65 72 61 74 6f  d [GLOB] operato
5290: 72 73 20 69 6e 20 61 20 57 48 45 52 45 20 63 6c  rs in a WHERE cl
52a0: 61 75 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ause..}..COMPILE
52b0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
52c0: 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53  OMIT_LOAD_EXTENS
52d0: 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ION} {.  This op
52e0: 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 65  tion omits the e
52f0: 6e 74 69 72 65 20 65 78 74 65 6e 73 69 6f 6e 20  ntire extension 
5300: 6c 6f 61 64 69 6e 67 20 6d 65 63 68 61 6e 69 73  loading mechanis
5310: 6d 20 66 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2c  m from.  SQLite,
5320: 20 69 6e 63 6c 75 64 69 6e 67 20 5b 73 71 6c 69   including [sqli
5330: 74 65 33 5f 65 6e 61 62 6c 65 5f 6c 6f 61 64 5f  te3_enable_load_
5340: 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20 61 6e 64  extension()] and
5350: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6c 6f 61 64  .  [sqlite3_load
5360: 5f 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20 69 6e  _extension()] in
5370: 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d  terfaces..}..COM
5380: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
5390: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 43 41 4c 54 49  ITE_OMIT_LOCALTI
53a0: 4d 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  ME} {.  This opt
53b0: 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 22 6c  ion omits the "l
53c0: 6f 63 61 6c 74 69 6d 65 22 20 6d 6f 64 69 66 69  ocaltime" modifi
53d0: 65 72 20 66 72 6f 6d 20 74 68 65 20 64 61 74 65  er from the date
53e0: 20 61 6e 64 20 74 69 6d 65 0a 20 20 66 75 6e 63   and time.  func
53f0: 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 6f 70 74  tions.  This opt
5400: 69 6f 6e 20 69 73 20 73 6f 6d 65 74 69 6d 65 73  ion is sometimes
5410: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 72 79   useful when try
5420: 69 6e 67 20 74 6f 20 63 6f 6d 70 69 6c 65 0a 20  ing to compile. 
5430: 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69   the date and ti
5440: 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 20  me functions on 
5450: 61 20 70 6c 61 74 66 6f 72 6d 20 74 68 61 74 20  a platform that 
5460: 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74  does not support
5470: 20 74 68 65 0a 20 20 63 6f 6e 63 65 70 74 20 6f   the.  concept o
5480: 66 20 6c 6f 63 61 6c 20 74 69 6d 65 2e 0a 7d 0a  f local time..}.
5490: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
54a0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d  {SQLITE_OMIT_MEM
54b0: 4f 52 59 44 42 7d 20 7b 0a 20 20 57 68 65 6e 20  ORYDB} {.  When 
54c0: 74 68 69 73 20 69 73 20 64 65 66 69 6e 65 64 2c  this is defined,
54d0: 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 6f 65   the library doe
54e0: 73 20 6e 6f 74 20 72 65 73 70 65 63 74 20 74 68  s not respect th
54f0: 65 20 73 70 65 63 69 61 6c 20 64 61 74 61 62 61  e special databa
5500: 73 65 0a 20 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f  se.  name ":memo
5510: 72 79 3a 22 20 28 6e 6f 72 6d 61 6c 6c 79 20 75  ry:" (normally u
5520: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6e  sed to create an
5530: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62   in-memory datab
5540: 61 73 65 29 2e 20 49 66 20 0a 20 20 22 3a 6d 65  ase). If .  ":me
5550: 6d 6f 72 79 3a 22 20 69 73 20 70 61 73 73 65 64  mory:" is passed
5560: 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65   to [sqlite3_ope
5570: 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 6f  n()], [sqlite3_o
5580: 70 65 6e 31 36 28 29 5d 2c 20 6f 72 0a 20 20 5b  pen16()], or.  [
5590: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28  sqlite3_open_v2(
55a0: 29 5d 2c 20 61 20 66 69 6c 65 20 77 69 74 68 20  )], a file with 
55b0: 74 68 69 73 20 6e 61 6d 65 20 77 69 6c 6c 20 62  this name will b
55c0: 65 20 0a 20 20 6f 70 65 6e 65 64 20 6f 72 20 63  e .  opened or c
55d0: 72 65 61 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  reated..}..COMPI
55e0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
55f0: 45 5f 4f 4d 49 54 5f 4f 52 5f 4f 50 54 49 4d 49  E_OMIT_OR_OPTIMI
5600: 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73  ZATION} {.  This
5610: 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73   option disables
5620: 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20   the ability of 
5630: 53 51 4c 69 74 65 20 74 6f 20 75 73 65 20 61 6e  SQLite to use an
5640: 20 69 6e 64 65 78 20 74 6f 67 65 74 68 65 72 0a   index together.
5650: 20 20 77 69 74 68 20 74 65 72 6d 73 20 6f 66 20    with terms of 
5660: 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 63  a WHERE clause c
5670: 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68 65 20  onnected by the 
5680: 4f 52 20 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a  OR operator..}..
5690: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
56a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45  SQLITE_OMIT_PAGE
56b0: 52 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44  R_PRAGMAS} {.  D
56c0: 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74  efining this opt
56d0: 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d 61  ion omits pragma
56e0: 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65  s related to the
56f0: 20 70 61 67 65 72 20 73 75 62 73 79 73 74 65 6d   pager subsystem
5700: 20 66 72 6f 6d 20 0a 20 20 74 68 65 20 62 75 69   from .  the bui
5710: 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ld..}..COMPILE_O
5720: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
5730: 49 54 5f 50 52 41 47 4d 41 7d 20 7b 0a 20 20 54  IT_PRAGMA} {.  T
5740: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
5750: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 5b  ed to omit the [
5760: 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 0a  PRAGMA] command.
5770: 20 20 66 72 6f 6d 20 74 68 65 20 6c 69 62 72 61    from the libra
5780: 72 79 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 74  ry. Note that it
5790: 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20 64 65   is useful to de
57a0: 66 69 6e 65 20 74 68 65 20 6d 61 63 72 6f 73 20  fine the macros 
57b0: 74 68 61 74 20 6f 6d 69 74 0a 20 20 73 70 65 63  that omit.  spec
57c0: 69 66 69 63 20 70 72 61 67 6d 61 73 20 69 6e 20  ific pragmas in 
57d0: 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 69 73  addition to this
57e0: 2c 20 61 73 20 74 68 65 79 20 6d 61 79 20 61 6c  , as they may al
57f0: 73 6f 20 72 65 6d 6f 76 65 20 73 75 70 70 6f 72  so remove suppor
5800: 74 69 6e 67 20 63 6f 64 65 0a 20 20 69 6e 20 6f  ting code.  in o
5810: 74 68 65 72 20 73 75 62 2d 73 79 73 74 65 6d 73  ther sub-systems
5820: 2e 20 54 68 69 73 20 6d 61 63 72 6f 20 72 65 6d  . This macro rem
5830: 6f 76 65 73 20 74 68 65 20 5b 50 52 41 47 4d 41  oves the [PRAGMA
5840: 5d 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 2e 0a  ] command only..
5850: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
5860: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50  N {SQLITE_OMIT_P
5870: 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b  ROGRESS_CALLBACK
5880: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
5890: 6e 20 6d 61 79 20 62 65 20 64 65 66 69 6e 65 64  n may be defined
58a0: 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63 61 70   to omit the cap
58b0: 61 62 69 6c 69 74 79 20 74 6f 20 69 73 73 75 65  ability to issue
58c0: 20 22 70 72 6f 67 72 65 73 73 22 20 0a 20 20 63   "progress" .  c
58d0: 61 6c 6c 62 61 63 6b 73 20 64 75 72 69 6e 67 20  allbacks during 
58e0: 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 53 51 4c  long-running SQL
58f0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 54 68 65   statements. The
5900: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f   .  [sqlite3_pro
5910: 67 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 29 5d  gress_handler()]
5920: 0a 20 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20  .  API function 
5930: 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 69  is not present i
5940: 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d  n the library..}
5950: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
5960: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55   {SQLITE_OMIT_QU
5970: 49 43 4b 42 41 4c 41 4e 43 45 7d 20 7b 0a 20 20  ICKBALANCE} {.  
5980: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
5990: 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  s an alternative
59a0: 2c 20 66 61 73 74 65 72 20 42 2d 54 72 65 65 20  , faster B-Tree 
59b0: 62 61 6c 61 6e 63 69 6e 67 20 72 6f 75 74 69 6e  balancing routin
59c0: 65 2e 0a 20 20 55 73 69 6e 67 20 74 68 69 73 20  e..  Using this 
59d0: 6f 70 74 69 6f 6e 20 6d 61 6b 65 73 20 53 51 4c  option makes SQL
59e0: 69 74 65 20 73 6c 69 67 68 74 6c 79 20 73 6d 61  ite slightly sma
59f0: 6c 6c 65 72 20 61 74 20 74 68 65 20 65 78 70 65  ller at the expe
5a00: 6e 73 65 20 6f 66 0a 20 20 6d 61 6b 69 6e 67 20  nse of.  making 
5a10: 69 74 20 72 75 6e 20 73 6c 69 67 68 74 6c 79 20  it run slightly 
5a20: 73 6c 6f 77 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49  slower..}..COMPI
5a30: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
5a40: 45 5f 4f 4d 49 54 5f 52 45 49 4e 44 45 58 7d 20  E_OMIT_REINDEX} 
5a50: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
5a60: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
5a70: 20 74 68 65 20 5b 52 45 49 4e 44 45 58 5d 0a 20   the [REINDEX]. 
5a80: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20   command is not 
5a90: 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20  included in the 
5aa0: 6c 69 62 72 61 72 79 2e 0a 20 20 45 78 65 63 75  library..  Execu
5ab0: 74 69 6e 67 20 61 20 5b 52 45 49 4e 44 45 58 5d  ting a [REINDEX]
5ac0: 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65   statement cause
5ad0: 73 20 0a 20 20 61 20 70 61 72 73 65 20 65 72 72  s .  a parse err
5ae0: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
5af0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
5b00: 49 54 5f 53 43 48 45 4d 41 5f 50 52 41 47 4d 41  IT_SCHEMA_PRAGMA
5b10: 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  S} {.  Defining 
5b20: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  this option omit
5b30: 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20 71 75  s pragmas for qu
5b40: 65 72 79 69 6e 67 20 74 68 65 20 64 61 74 61 62  erying the datab
5b50: 61 73 65 20 73 63 68 65 6d 61 20 66 72 6f 6d 20  ase schema from 
5b60: 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a  .  the build..}.
5b70: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
5b80: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48  {SQLITE_OMIT_SCH
5b90: 45 4d 41 5f 56 45 52 53 49 4f 4e 5f 50 52 41 47  EMA_VERSION_PRAG
5ba0: 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e  MAS} {.  Definin
5bb0: 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d  g this option om
5bc0: 69 74 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20  its pragmas for 
5bd0: 71 75 65 72 79 69 6e 67 20 61 6e 64 20 6d 6f 64  querying and mod
5be0: 69 66 79 69 6e 67 20 74 68 65 20 0a 20 20 64 61  ifying the .  da
5bf0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 76 65  tabase schema ve
5c00: 72 73 69 6f 6e 20 61 6e 64 20 75 73 65 72 20 76  rsion and user v
5c10: 65 72 73 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20  ersion from the 
5c20: 62 75 69 6c 64 2e 20 53 70 65 63 69 66 69 63 61  build. Specifica
5c30: 6c 6c 79 2c 20 74 68 65 20 0a 20 20 5b 73 63 68  lly, the .  [sch
5c40: 65 6d 61 5f 76 65 72 73 69 6f 6e 5d 20 61 6e 64  ema_version] and
5c50: 20 5b 75 73 65 72 5f 76 65 72 73 69 6f 6e 5d 20   [user_version] 
5c60: 50 52 41 47 4d 41 73 20 61 72 65 20 6f 6d 69 74  PRAGMAs are omit
5c70: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
5c80: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
5c90: 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45  MIT_SHARED_CACHE
5ca0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
5cb0: 6e 20 62 75 69 6c 64 73 20 53 51 4c 69 74 65 20  n builds SQLite 
5cc0: 77 69 74 68 6f 75 74 20 73 75 70 70 6f 72 74 20  without support 
5cd0: 66 6f 72 20 73 68 61 72 65 64 2d 63 61 63 68 65  for shared-cache
5ce0: 20 6d 6f 64 65 2e 0a 20 20 54 68 65 20 5b 73 71   mode..  The [sq
5cf0: 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 73 68 61  lite3_enable_sha
5d00: 72 65 64 5f 63 61 63 68 65 28 29 5d 20 69 73 20  red_cache()] is 
5d10: 6f 6d 69 74 74 65 64 20 61 6c 6f 6e 67 20 77 69  omitted along wi
5d20: 74 68 20 61 20 66 61 69 72 0a 20 20 61 6d 6f 75  th a fair.  amou
5d30: 6e 74 20 6f 66 20 6c 6f 67 69 63 20 77 69 74 68  nt of logic with
5d40: 69 6e 20 74 68 65 20 42 2d 54 72 65 65 20 73 75  in the B-Tree su
5d50: 62 73 79 73 74 65 6d 20 61 73 73 6f 63 69 61 74  bsystem associat
5d60: 65 64 20 77 69 74 68 20 73 68 61 72 65 64 0a 20  ed with shared. 
5d70: 20 63 61 63 68 65 20 6d 61 6e 61 67 65 6d 65 6e   cache managemen
5d80: 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  t..}..COMPILE_OP
5d90: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
5da0: 54 5f 53 55 42 51 55 45 52 59 7d 20 7b 0a 20 20  T_SUBQUERY} {.  
5db0: 49 66 20 64 65 66 69 6e 65 64 2c 20 73 75 70 70  If defined, supp
5dc0: 6f 72 74 20 66 6f 72 20 73 75 62 2d 73 65 6c 65  ort for sub-sele
5dd0: 63 74 73 20 61 6e 64 20 74 68 65 20 49 4e 28 29  cts and the IN()
5de0: 20 6f 70 65 72 61 74 6f 72 20 61 72 65 20 6f 6d   operator are om
5df0: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
5e00: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
5e10: 5f 4f 4d 49 54 5f 54 43 4c 5f 56 41 52 49 41 42  _OMIT_TCL_VARIAB
5e20: 4c 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  LE} {.  If this 
5e30: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
5e40: 2c 20 74 68 65 6e 20 74 68 65 20 73 70 65 63 69  , then the speci
5e50: 61 6c 20 22 24 3c 76 61 72 69 61 62 6c 65 2d 6e  al "$<variable-n
5e60: 61 6d 65 3e 22 20 73 79 6e 74 61 78 0a 20 20 75  ame>" syntax.  u
5e70: 73 65 64 20 74 6f 20 61 75 74 6f 6d 61 74 69 63  sed to automatic
5e80: 61 6c 6c 79 20 62 69 6e 64 20 53 51 4c 20 76 61  ally bind SQL va
5e90: 72 69 61 62 6c 65 73 20 74 6f 20 54 43 4c 20 76  riables to TCL v
5ea0: 61 72 69 61 62 6c 65 73 20 69 73 20 6f 6d 69 74  ariables is omit
5eb0: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
5ec0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
5ed0: 4d 49 54 5f 54 45 4d 50 44 42 7d 20 7b 0a 20 20  MIT_TEMPDB} {.  
5ee0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
5ef0: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 54 45  s support for TE
5f00: 4d 50 20 6f 72 20 54 45 4d 50 4f 52 41 52 59 20  MP or TEMPORARY 
5f10: 74 61 62 6c 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  tables..}..COMPI
5f20: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
5f30: 45 5f 4f 4d 49 54 5f 54 52 41 43 45 7d 20 7b 0a  E_OMIT_TRACE} {.
5f40: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
5f50: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  its support for 
5f60: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f  the [sqlite3_pro
5f70: 66 69 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73  file()] and.  [s
5f80: 71 6c 69 74 65 33 5f 74 72 61 63 65 28 29 5d 20  qlite3_trace()] 
5f90: 69 6e 74 65 72 66 61 63 65 73 20 61 6e 64 20 74  interfaces and t
5fa0: 68 65 69 72 20 61 73 73 6f 63 69 61 74 65 64 20  heir associated 
5fb0: 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  logic..}..COMPIL
5fc0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
5fd0: 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 7d 20 7b  _OMIT_TRIGGER} {
5fe0: 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73  .  Defining this
5ff0: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75   option omits su
6000: 70 70 6f 72 74 20 66 6f 72 20 56 49 45 57 20 6f  pport for VIEW o
6010: 62 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20  bjects. Neither 
6020: 74 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 54  the .  [CREATE T
6030: 52 49 47 47 45 52 5d 20 6f 72 20 5b 44 52 4f 50  RIGGER] or [DROP
6040: 20 54 52 49 47 47 45 52 5d 0a 20 20 63 6f 6d 6d   TRIGGER].  comm
6050: 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c 61 62  ands are availab
6060: 6c 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c  le in this case,
6070: 20 61 6e 64 20 61 74 74 65 6d 70 74 69 6e 67 20   and attempting 
6080: 74 6f 20 65 78 65 63 75 74 65 0a 20 20 65 69 74  to execute.  eit
6090: 68 65 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20  her will result 
60a0: 69 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  in a parse error
60b0: 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 66  ...  WARNING: If
60c0: 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64   this macro is d
60d0: 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c 20  efined, it will 
60e0: 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20  not be possible 
60f0: 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61  to open a databa
6100: 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20 74  se.  for which t
6110: 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 69  he schema contai
6120: 6e 73 20 54 52 49 47 47 45 52 20 6f 62 6a 65 63  ns TRIGGER objec
6130: 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ts. .}..COMPILE_
6140: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
6150: 4d 49 54 5f 55 54 46 31 36 7d 20 7b 0a 20 20 54  MIT_UTF16} {.  T
6160: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65  his macro is use
6170: 64 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72  d to omit suppor
6180: 74 20 66 6f 72 20 55 54 46 31 36 20 74 65 78 74  t for UTF16 text
6190: 20 65 6e 63 6f 64 69 6e 67 2e 20 57 68 65 6e 20   encoding. When 
61a0: 74 68 69 73 20 69 73 0a 20 20 64 65 66 69 6e 65  this is.  define
61b0: 64 20 61 6c 6c 20 41 50 49 20 66 75 6e 63 74 69  d all API functi
61c0: 6f 6e 73 20 74 68 61 74 20 72 65 74 75 72 6e 20  ons that return 
61d0: 6f 72 20 61 63 63 65 70 74 20 55 54 46 31 36 20  or accept UTF16 
61e0: 65 6e 63 6f 64 65 64 20 74 65 78 74 20 61 72 65  encoded text are
61f0: 0a 20 20 75 6e 61 76 61 69 6c 61 62 6c 65 2e 20  .  unavailable. 
6200: 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20  These functions 
6210: 63 61 6e 20 62 65 20 69 64 65 6e 74 69 66 69 65  can be identifie
6220: 64 20 62 79 20 74 68 65 20 66 61 63 74 20 74 68  d by the fact th
6230: 61 74 20 74 68 65 79 20 65 6e 64 0a 20 20 77 69  at they end.  wi
6240: 74 68 20 27 31 36 27 2c 20 66 6f 72 20 65 78 61  th '16', for exa
6250: 6d 70 6c 65 20 5b 73 71 6c 69 74 65 33 5f 70 72  mple [sqlite3_pr
6260: 65 70 61 72 65 31 36 28 29 5d 2c 20 5b 73 71 6c  epare16()], [sql
6270: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74  ite3_column_text
6280: 31 36 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c  16()] and.  [sql
6290: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36  ite3_bind_text16
62a0: 28 29 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ()]..}..COMPILE_
62b0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
62c0: 4d 49 54 5f 56 41 43 55 55 4d 7d 20 7b 0a 20 20  MIT_VACUUM} {.  
62d0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
62e0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
62f0: 20 5b 56 41 43 55 55 4d 5d 0a 20 20 63 6f 6d 6d   [VACUUM].  comm
6300: 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75  and is not inclu
6310: 64 65 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61  ded in the libra
6320: 72 79 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20  ry..  Executing 
6330: 61 20 5b 56 41 43 55 55 4d 5d 20 73 74 61 74 65  a [VACUUM] state
6340: 6d 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20 61  ment causes .  a
6350: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a   parse error..}.
6360: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6370: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 45  {SQLITE_OMIT_VIE
6380: 57 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  W} {.  Defining 
6390: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  this option omit
63a0: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 56 49  s support for VI
63b0: 45 57 20 6f 62 6a 65 63 74 73 2e 20 4e 65 69 74  EW objects. Neit
63c0: 68 65 72 20 74 68 65 20 0a 20 20 5b 43 52 45 41  her the .  [CREA
63d0: 54 45 20 56 49 45 57 5d 20 6e 6f 72 20 74 68 65  TE VIEW] nor the
63e0: 20 5b 44 52 4f 50 20 56 49 45 57 5d 0a 20 20 63   [DROP VIEW].  c
63f0: 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 76 61 69  ommands are avai
6400: 6c 61 62 6c 65 20 69 6e 20 74 68 69 73 20 63 61  lable in this ca
6410: 73 65 2c 20 61 6e 64 0a 20 20 61 74 74 65 6d 70  se, and.  attemp
6420: 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 20  ting to execute 
6430: 65 69 74 68 65 72 20 77 69 6c 6c 20 72 65 73 75  either will resu
6440: 6c 74 20 69 6e 20 61 20 70 61 72 73 65 20 65 72  lt in a parse er
6450: 72 6f 72 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a  ror...  WARNING:
6460: 20 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69   If this macro i
6470: 73 20 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69  s defined, it wi
6480: 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62  ll not be possib
6490: 6c 65 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74  le to open a dat
64a0: 61 62 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63  abase.  for whic
64b0: 68 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e  h the schema con
64c0: 74 61 69 6e 73 20 56 49 45 57 20 6f 62 6a 65 63  tains VIEW objec
64d0: 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ts. .}..COMPILE_
64e0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
64f0: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45  MIT_VIRTUALTABLE
6500: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
6510: 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20  n omits support 
6520: 66 6f 72 20 74 68 65 20 5b 73 71 6c 69 74 65 33  for the [sqlite3
6530: 5f 76 74 61 62 20 7c 20 56 69 72 74 75 61 6c 20  _vtab | Virtual 
6540: 54 61 62 6c 65 5d 0a 20 20 6d 65 63 68 61 6e 69  Table].  mechani
6550: 73 6d 20 69 6e 20 53 51 4c 69 74 65 2e 0a 7d 0a  sm in SQLite..}.
6560: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6570: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44  {SQLITE_OMIT_WSD
6580: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
6590: 6e 73 20 62 75 69 6c 64 73 20 61 20 76 65 72 73  ns builds a vers
65a0: 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69 74  ion of the SQLit
65b0: 65 20 6c 69 62 72 61 72 79 20 74 68 61 74 20 63  e library that c
65c0: 6f 6e 74 61 69 6e 73 20 6e 6f 0a 20 20 57 72 69  ontains no.  Wri
65d0: 74 61 62 6c 65 20 53 74 61 74 69 63 20 44 61 74  table Static Dat
65e0: 61 20 28 57 53 44 29 2e 20 20 57 53 44 20 69 73  a (WSD).  WSD is
65f0: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65   global variable
6600: 73 20 61 6e 64 2f 6f 72 20 73 74 61 74 69 63 0a  s and/or static.
6610: 20 20 76 61 72 69 61 62 6c 65 73 2e 20 20 53 6f    variables.  So
6620: 6d 65 20 70 6c 61 74 66 6f 72 6d 73 20 64 6f 20  me platforms do 
6630: 6e 6f 74 20 73 75 70 70 6f 72 74 20 57 53 44 2c  not support WSD,
6640: 20 61 6e 64 20 74 68 69 73 20 6f 70 74 69 6f 6e   and this option
6650: 20 69 73 20 6e 65 63 65 73 73 61 72 79 0a 20 20   is necessary.  
6660: 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 53 51 4c  in order for SQL
6670: 69 74 65 20 74 6f 20 77 6f 72 6b 20 74 68 6f 73  ite to work thos
6680: 65 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20 0a 0a  e platforms.  ..
6690: 20 20 55 6e 6c 69 6b 65 20 6f 74 68 65 72 20 4f    Unlike other O
66a0: 4d 49 54 20 6f 70 74 69 6f 6e 73 20 77 68 69 63  MIT options whic
66b0: 68 20 6d 61 6b 65 20 74 68 65 20 53 51 4c 69 74  h make the SQLit
66c0: 65 20 6c 69 62 72 61 72 79 20 73 6d 61 6c 6c 65  e library smalle
66d0: 72 2c 0a 20 20 74 68 69 73 20 6f 70 74 69 6f 6e  r,.  this option
66e0: 20 61 63 74 75 61 6c 6c 79 20 69 6e 63 72 65 61   actually increa
66f0: 73 65 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20  ses the size of 
6700: 53 51 4c 69 74 65 20 61 6e 64 20 6d 61 6b 65 73  SQLite and makes
6710: 20 69 74 20 72 75 6e 0a 20 20 61 20 6c 69 74 74   it run.  a litt
6720: 6c 65 20 73 6c 6f 77 65 72 2e 20 20 4f 6e 6c 79  le slower.  Only
6730: 20 75 73 65 20 74 68 69 73 20 6f 70 74 69 6f 6e   use this option
6740: 20 69 66 20 53 51 4c 69 74 65 20 69 73 20 62 65   if SQLite is be
6750: 69 6e 67 20 62 75 69 6c 74 20 66 6f 72 20 61 6e  ing built for an
6760: 0a 20 20 65 6d 62 65 64 64 65 64 20 74 61 72 67  .  embedded targ
6770: 65 74 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74  et that does not
6780: 20 73 75 70 70 6f 72 74 20 57 53 44 2e 0a 7d 0a   support WSD..}.
6790: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
67a0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 58 46 45  {SQLITE_OMIT_XFE
67b0: 52 5f 4f 50 54 7d 20 7b 0a 20 20 54 68 69 73 20  R_OPT} {.  This 
67c0: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
67d0: 70 6f 72 74 20 66 6f 72 20 6f 70 74 69 6d 69 7a  port for optimiz
67e0: 61 74 69 6f 6e 73 20 74 68 61 74 20 68 65 6c 70  ations that help
67f0: 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 6f 66   statements.  of
6800: 20 74 68 65 20 66 6f 72 6d 20 22 49 4e 53 45 52   the form "INSER
6810: 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 43  T INTO ... SELEC
6820: 54 20 2e 2e 2e 22 20 72 75 6e 20 66 61 73 74 65  T ..." run faste
6830: 72 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 3c 61 20  r..}..</tcl>.<a 
6840: 6e 61 6d 65 3d 22 6f 6d 69 74 66 65 61 74 75 72  name="omitfeatur
6850: 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 36  es"></a>.<h2>1.6
6860: 20 41 6e 61 6c 79 73 69 73 20 61 6e 64 20 44 65   Analysis and De
6870: 62 75 67 67 69 6e 67 20 4f 70 74 69 6f 6e 73 3c  bugging Options<
6880: 2f 68 32 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f 4d 50  /h2>.<tcl>..COMP
6890: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
68a0: 54 45 5f 44 45 42 55 47 7d 20 7b 0a 20 20 54 68  TE_DEBUG} {.  Th
68b0: 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20  e SQLite source 
68c0: 63 6f 64 65 20 63 6f 6e 74 61 69 6e 73 20 6c 69  code contains li
68d0: 74 65 72 61 6c 6c 79 20 74 68 6f 75 73 61 6e 64  terally thousand
68e0: 73 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74  s of assert() st
68f0: 61 74 65 6d 65 6e 74 73 0a 20 20 75 73 65 64 20  atements.  used 
6900: 74 6f 20 76 65 72 69 66 79 20 69 6e 74 65 72 6e  to verify intern
6910: 61 6c 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 61  al assumptions a
6920: 6e 64 20 73 75 62 72 6f 75 74 69 6e 65 20 70 72  nd subroutine pr
6930: 65 63 6f 6e 64 69 74 69 6f 6e 73 20 61 6e 64 0a  econditions and.
6940: 20 20 70 6f 73 74 63 6f 6e 64 69 74 69 6f 6e 73    postconditions
6950: 2e 20 20 54 68 65 73 65 20 61 73 73 65 72 74 28  .  These assert(
6960: 29 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65  ) statements are
6970: 20 6e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64   normally turned
6980: 20 6f 66 66 0a 20 20 28 74 68 65 79 20 67 65 6e   off.  (they gen
6990: 65 72 61 74 65 20 6e 6f 20 63 6f 64 65 29 20 73  erate no code) s
69a0: 69 6e 63 65 20 74 75 72 6e 69 6e 67 20 74 68 65  ince turning the
69b0: 6d 20 6f 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74  m on makes SQLit
69c0: 65 20 72 75 6e 20 61 70 70 72 6f 78 69 6d 61 74  e run approximat
69d0: 65 6c 79 0a 20 20 74 68 72 65 65 20 74 69 6d 65  ely.  three time
69e0: 73 20 73 6c 6f 77 65 72 2e 20 20 42 75 74 20 66  s slower.  But f
69f0: 6f 72 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61  or testing and a
6a00: 6e 61 6c 79 73 69 73 2c 20 69 74 20 69 73 20 75  nalysis, it is u
6a10: 73 65 66 75 6c 20 74 6f 20 74 75 72 6e 0a 20 20  seful to turn.  
6a20: 74 68 65 20 61 73 73 65 72 74 28 29 20 73 74 61  the assert() sta
6a30: 74 65 6d 65 6e 74 73 20 6f 6e 2e 20 20 54 68 65  tements on.  The
6a40: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 63 6f   SQLITE_DEBUG co
6a50: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
6a60: 6e 20 64 6f 65 73 20 74 68 69 73 2e 0a 20 20 53  n does this..  S
6a70: 51 4c 49 54 45 5f 44 45 42 55 47 20 61 6c 73 6f  QLITE_DEBUG also
6a80: 20 74 75 72 6e 73 20 6f 6e 20 73 6f 6d 65 20 6f   turns on some o
6a90: 74 68 65 72 20 64 65 62 75 67 67 69 6e 67 20 66  ther debugging f
6aa0: 65 61 74 75 72 65 73 2e 0a 7d 0a 0a 43 4f 4d 50  eatures..}..COMP
6ab0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
6ac0: 54 45 5f 4d 45 4d 44 45 42 55 47 7d 20 7b 0a 20  TE_MEMDEBUG} {. 
6ad0: 20 54 68 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44   The SQLITE_MEMD
6ae0: 45 42 55 47 20 6f 70 74 69 6f 6e 20 63 61 75 73  EBUG option caus
6af0: 65 73 20 61 6e 20 69 6e 73 74 72 75 6d 65 6e 74  es an instrument
6b00: 65 64 20 64 79 6e 61 6d 69 63 20 6d 65 6d 6f 72  ed dynamic memor
6b10: 79 20 61 6c 6c 6f 63 61 74 6f 72 0a 20 20 74 6f  y allocator.  to
6b20: 20 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20   be used as the 
6b30: 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79 20 61  default memory a
6b40: 6c 6c 6f 63 61 74 6f 72 20 77 69 74 68 69 6e 20  llocator within 
6b50: 53 51 4c 69 74 65 2e 20 20 54 68 65 0a 20 20 69  SQLite.  The.  i
6b60: 6e 73 74 72 75 6d 65 6e 74 65 64 20 6d 65 6d 6f  nstrumented memo
6b70: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 63 68 65  ry allocator che
6b80: 63 6b 73 20 66 6f 72 20 6d 69 73 75 73 65 20 6f  cks for misuse o
6b90: 66 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 61 6c  f dynamically al
6ba0: 6c 6f 63 61 74 65 64 0a 20 20 6d 65 6d 6f 72 79  located.  memory
6bb0: 2e 20 20 45 78 61 6d 70 6c 65 73 20 6f 66 20 6d  .  Examples of m
6bc0: 69 73 75 73 65 20 69 6e 63 6c 75 64 65 20 75 73  isuse include us
6bd0: 69 6e 67 20 6d 65 6d 6f 72 79 20 61 66 74 65 72  ing memory after
6be0: 20 69 74 20 69 73 20 66 72 65 65 64 2c 0a 20 20   it is freed,.  
6bf0: 77 72 69 74 69 6e 67 20 6f 66 66 20 74 68 65 20  writing off the 
6c00: 65 6e 64 73 20 6f 66 20 61 20 6d 65 6d 6f 72 79  ends of a memory
6c10: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 20 66 72 65   allocation, fre
6c20: 65 69 6e 67 20 6d 65 6d 6f 72 79 20 6e 6f 74 20  eing memory not 
6c30: 70 72 65 76 69 6f 75 73 6c 79 0a 20 20 6f 62 74  previously.  obt
6c40: 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 6d  ained from the m
6c50: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2c  emory allocator,
6c60: 20 6f 72 20 66 61 69 6c 69 6e 67 20 74 6f 20 69   or failing to i
6c70: 6e 69 74 69 61 6c 69 7a 65 20 6e 65 77 6c 79 0a  nitialize newly.
6c80: 20 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f    allocated memo
6c90: 72 79 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a        ry..}..</tcl>.