Documentation Source Text

Hex Artifact Content
Login

Artifact d932992f4157c143a69ce019266029e8879a1ef1:


0000: 3c 74 69 74 6c 65 3e 43 6f 6d 70 69 6c 61 74 69  <title>Compilati
0010: 6f 6e 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53  on Options For S
0020: 51 4c 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 3c 74  QLite</title>.<t
0030: 63 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b  cl>hd_keywords {
0040: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
0050: 69 6f 6e 73 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 31  ions}</tcl>..<h1
0060: 3e 31 2e 30 20 43 6f 6d 70 69 6c 61 74 69 6f 6e  >1.0 Compilation
0070: 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53 51 4c   Options For SQL
0080: 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a 46 6f  ite</h1>..<p>.Fo
0090: 72 20 6d 6f 73 74 20 70 75 72 70 6f 73 65 73 2c  r most purposes,
00a0: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 62   SQLite can be b
00b0: 75 69 6c 74 20 6a 75 73 74 20 66 69 6e 65 20 75  uilt just fine u
00c0: 73 69 6e 67 20 74 68 65 20 64 65 66 61 75 6c 74  sing the default
00d0: 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74  .compilation opt
00e0: 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69  ions. However, i
00f0: 66 20 72 65 71 75 69 72 65 64 2c 20 74 68 65 20  f required, the 
0100: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
0110: 69 6f 6e 73 0a 64 6f 63 75 6d 65 6e 74 65 64 20  ions.documented 
0120: 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 75 73 65  below can be use
0130: 64 20 74 6f 20 0a 3c 61 20 68 72 65 66 3d 22 23  d to .<a href="#
0140: 6f 6d 69 74 66 65 61 74 75 72 65 73 22 3e 6f 6d  omitfeatures">om
0150: 69 74 20 53 51 4c 69 74 65 20 66 65 61 74 75 72  it SQLite featur
0160: 65 73 3c 2f 61 3e 20 28 72 65 73 75 6c 74 69 6e  es</a> (resultin
0170: 67 20 69 6e 0a 61 20 5b 72 65 6c 66 6f 6f 74 70  g in.a [relfootp
0180: 72 69 6e 74 20 7c 20 73 6d 61 6c 6c 65 72 20 63  rint | smaller c
0190: 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72 79 20  ompiled library 
01a0: 73 69 7a 65 5d 29 20 6f 72 20 74 6f 20 63 68 61  size]) or to cha
01b0: 6e 67 65 20 74 68 65 0a 3c 61 20 68 72 65 66 3d  nge the.<a href=
01c0: 22 23 64 65 66 61 75 6c 74 73 22 3e 64 65 66 61  "#defaults">defa
01d0: 75 6c 74 20 76 61 6c 75 65 73 3c 2f 61 3e 20 6f  ult values</a> o
01e0: 66 20 73 6f 6d 65 20 70 61 72 61 6d 65 74 65 72  f some parameter
01f0: 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76 65  s..</p>..<p>.Eve
0200: 72 79 20 65 66 66 6f 72 74 20 68 61 73 20 62 65  ry effort has be
0210: 65 6e 20 6d 61 64 65 20 74 6f 20 65 6e 73 75 72  en made to ensur
0220: 65 20 74 68 61 74 20 74 68 65 20 76 61 72 69 6f  e that the vario
0230: 75 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 0a  us combinations.
0240: 6f 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  of compilation o
0250: 70 74 69 6f 6e 73 20 77 6f 72 6b 20 68 61 72 6d  ptions work harm
0260: 6f 6e 69 6f 75 73 6c 79 20 61 6e 64 20 70 72 6f  oniously and pro
0270: 64 75 63 65 20 61 20 77 6f 72 6b 69 6e 67 20 6c  duce a working l
0280: 69 62 72 61 72 79 2e 0a 4e 65 76 65 72 74 68 65  ibrary..Neverthe
0290: 6c 65 73 73 2c 20 69 74 20 69 73 20 73 74 72 6f  less, it is stro
02a0: 6e 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64  ngly recommended
02b0: 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65   that the SQLite
02c0: 20 74 65 73 74 2d 73 75 69 74 65 0a 62 65 20 65   test-suite.be e
02d0: 78 65 63 75 74 65 64 20 74 6f 20 63 68 65 63 6b  xecuted to check
02e0: 20 66 6f 72 20 65 72 72 6f 72 73 20 62 65 66 6f   for errors befo
02f0: 72 65 20 75 73 69 6e 67 20 61 6e 20 53 51 4c 69  re using an SQLi
0300: 74 65 20 6c 69 62 72 61 72 79 20 62 75 69 6c 74  te library built
0310: 0a 77 69 74 68 20 6e 6f 6e 2d 73 74 61 6e 64 61  .with non-standa
0320: 72 64 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  rd compilation o
0330: 70 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 3c 61 20  ptions..</p>.<a 
0340: 6e 61 6d 65 3d 22 64 65 66 61 75 6c 74 73 22 3e  name="defaults">
0350: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 4f 70 74  </a>.<h2>1.1 Opt
0360: 69 6f 6e 73 20 54 6f 20 53 65 74 20 44 65 66 61  ions To Set Defa
0370: 75 6c 74 20 50 61 72 61 6d 65 74 65 72 20 56 61  ult Parameter Va
0380: 6c 75 65 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e  lues</h2>..<tcl>
0390: 0a 70 72 6f 63 20 43 4f 4d 50 49 4c 45 5f 4f 50  .proc COMPILE_OP
03a0: 54 49 4f 4e 20 7b 6e 61 6d 65 20 74 65 78 74 7d  TION {name text}
03b0: 20 7b 0a 20 20 69 66 20 7b 5b 72 65 67 65 78 70   {.  if {[regexp
03c0: 20 7b 53 51 4c 49 54 45 5f 28 5b 41 2d 5a 30 2d   {SQLITE_([A-Z0-
03d0: 39 5f 5d 2b 29 7d 20 24 6e 61 6d 65 20 61 6c 6c  9_]+)} $name all
03e0: 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20 68   label]} {.    h
03f0: 64 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72 69  d_fragment [stri
0400: 6e 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62 65  ng tolower $labe
0410: 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f 72  l].    hd_keywor
0420: 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 69 66  ds $all.  }.  if
0430: 20 7b 5b 72 65 67 65 78 70 20 7b 5e 59 59 28 5b   {[regexp {^YY([
0440: 41 2d 5a 30 2d 39 5f 5d 2b 29 7d 20 24 6e 61 6d  A-Z0-9_]+)} $nam
0450: 65 20 61 6c 6c 20 6c 61 62 65 6c 5d 7d 20 7b 0a  e all label]} {.
0460: 20 20 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20      hd_fragment 
0470: 5b 73 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72 20  [string tolower 
0480: 24 61 6c 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79  $all].    hd_key
0490: 77 6f 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20  words $all.  }. 
04a0: 20 68 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e 24   hd_puts <p><b>$
04b0: 6e 61 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 72  name</b></p>.  r
04c0: 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c 5c  egsub -all "\n\\
04d0: 73 2a 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f 70  s*\n" $text "</p
04e0: 3e 5c 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a 20  >\n\n<p>" text. 
04f0: 20 68 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c 6f   hd_resolve <blo
0500: 63 6b 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78 74  ckquote><p>$text
0510: 3c 2f 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  </p></blockquote
0520: 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  >.}..COMPILE_OPT
0530: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41  ION {SQLITE_DEFA
0540: 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d 3c  ULT_AUTOVACUUM=<
0550: 69 3e 26 6c 74 3b 30 20 6f 72 20 31 20 6f 72 20  i>&lt;0 or 1 or 
0560: 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  2&gt;</i>} {.  T
0570: 68 69 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d  his macro determ
0580: 69 6e 65 73 20 69 66 20 53 51 4c 69 74 65 20 63  ines if SQLite c
0590: 72 65 61 74 65 73 20 64 61 74 61 62 61 73 65 73  reates databases
05a0: 20 77 69 74 68 20 74 68 65 20 0a 20 20 5b 61 75   with the .  [au
05b0: 74 6f 5f 76 61 63 75 75 6d 5d 20 66 6c 61 67 20  to_vacuum] flag 
05c0: 73 65 74 20 62 79 20 64 65 66 61 75 6c 74 20 74  set by default t
05d0: 6f 20 4f 46 46 20 28 30 29 2c 20 46 55 4c 4c 20  o OFF (0), FULL 
05e0: 28 31 29 2c 20 6f 72 0a 20 20 49 4e 43 52 45 4d  (1), or.  INCREM
05f0: 45 4e 54 41 4c 20 28 32 29 2e 20 54 68 65 20 64  ENTAL (2). The d
0600: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20  efault value is 
0610: 30 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 64  0 meaning that d
0620: 61 74 61 62 61 73 65 73 0a 20 20 61 72 65 20 63  atabases.  are c
0630: 72 65 61 74 65 64 20 77 69 74 68 20 61 75 74 6f  reated with auto
0640: 2d 76 61 63 75 75 6d 20 74 75 72 6e 65 64 20 6f  -vacuum turned o
0650: 66 66 2e 0a 20 20 49 6e 20 61 6e 79 20 63 61 73  ff..  In any cas
0660: 65 20 74 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69  e the compile-ti
0670: 6d 65 20 64 65 66 61 75 6c 74 20 6d 61 79 20 62  me default may b
0680: 65 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20  e overridden by 
0690: 74 68 65 20 0a 20 20 5b 50 52 41 47 4d 41 20 61  the .  [PRAGMA a
06a0: 75 74 6f 5f 76 61 63 75 75 6d 5d 20 63 6f 6d 6d  uto_vacuum] comm
06b0: 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  and..}..COMPILE_
06c0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44  OPTION {SQLITE_D
06d0: 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a  EFAULT_CACHE_SIZ
06e0: 45 3d 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26 67  E=<i>&lt;pages&g
06f0: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
0700: 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65 20   macro sets the 
0710: 64 65 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20  default size of 
0720: 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 66  the page-cache f
0730: 6f 72 20 65 61 63 68 20 61 74 74 61 63 68 65 64  or each attached
0740: 0a 20 20 64 61 74 61 62 61 73 65 2c 20 69 6e 20  .  database, in 
0750: 70 61 67 65 73 2e 20 54 68 69 73 20 63 61 6e 20  pages. This can 
0760: 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 62 79  be overridden by
0770: 20 74 68 65 20 0a 20 20 5b 50 52 41 47 4d 41 20   the .  [PRAGMA 
0780: 63 61 63 68 65 5f 73 69 7a 65 5d 20 63 6f 6d 6d  cache_size] comm
0790: 61 6e 64 2e 20 54 68 65 20 64 65 66 61 75 6c 74  and. The default
07a0: 20 76 61 6c 75 65 20 69 73 20 32 30 30 30 2e 0a   value is 2000..
07b0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
07c0: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
07d0: 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 3d 3c 69  T_FILE_FORMAT=<i
07e0: 3e 26 6c 74 3b 31 20 6f 72 20 34 26 67 74 3b 3c  >&lt;1 or 4&gt;<
07f0: 2f 69 3e 7d 20 7b 0a 20 20 54 68 65 20 64 65 66  /i>} {.  The def
0800: 61 75 6c 74 20 5b 73 63 68 65 6d 61 20 66 6f 72  ault [schema for
0810: 6d 61 74 20 6e 75 6d 62 65 72 5d 20 75 73 65 64  mat number] used
0820: 20 62 79 20 53 51 4c 69 74 65 20 77 68 65 6e 20   by SQLite when 
0830: 63 72 65 61 74 69 6e 67 0a 20 20 6e 65 77 20 64  creating.  new d
0840: 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 69 73  atabase files is
0850: 20 73 65 74 20 62 79 20 74 68 69 73 20 6d 61 63   set by this mac
0860: 72 6f 2e 20 20 54 68 65 20 73 63 68 65 6d 61 20  ro.  The schema 
0870: 66 6f 72 6d 61 74 73 20 61 72 65 20 61 6c 6c 0a  formats are all.
0880: 20 20 76 65 72 79 20 73 69 6d 69 6c 61 72 2e 20    very similar. 
0890: 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20   The difference 
08a0: 62 65 74 77 65 65 6e 20 66 6f 72 6d 61 74 73 20  between formats 
08b0: 31 20 61 6e 64 20 34 20 69 73 20 74 68 61 74 20  1 and 4 is that 
08c0: 66 6f 72 6d 61 74 0a 20 20 34 20 75 6e 64 65 72  format.  4 under
08d0: 73 74 61 6e 64 73 20 5b 64 65 73 63 65 6e 64 69  stands [descendi
08e0: 6e 67 20 69 6e 64 69 63 65 73 5d 20 61 6e 64 20  ng indices] and 
08f0: 68 61 73 20 61 20 74 69 67 68 74 65 72 20 65 6e  has a tighter en
0900: 63 6f 64 69 6e 67 20 66 6f 72 0a 20 20 62 6f 6f  coding for.  boo
0910: 6c 65 61 6e 20 76 61 6c 75 65 73 2e 0a 0a 20 20  lean values...  
0920: 41 6c 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  All versions of 
0930: 53 51 4c 69 74 65 20 73 69 6e 63 65 20 33 2e 33  SQLite since 3.3
0940: 2e 30 20 28 32 30 30 36 2d 30 31 2d 31 30 29 0a  .0 (2006-01-10).
0950: 20 20 63 61 6e 20 72 65 61 64 20 61 6e 64 20 77    can read and w
0960: 72 69 74 65 20 61 6e 79 20 73 63 68 65 6d 61 20  rite any schema 
0970: 66 6f 72 6d 61 74 0a 20 20 62 65 74 77 65 65 6e  format.  between
0980: 20 31 20 61 6e 64 20 34 2e 20 20 42 75 74 20 6f   1 and 4.  But o
0990: 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66  lder versions of
09a0: 20 53 51 4c 69 74 65 20 6d 69 67 68 74 20 6e 6f   SQLite might no
09b0: 74 20 62 65 20 61 62 6c 65 20 74 6f 0a 20 20 72  t be able to.  r
09c0: 65 61 64 20 66 6f 72 6d 61 74 73 20 67 72 65 61  ead formats grea
09d0: 74 65 72 20 74 68 61 6e 20 31 2e 20 20 53 6f 20  ter than 1.  So 
09e0: 74 68 61 74 20 6f 6c 64 65 72 20 76 65 72 73 69  that older versi
09f0: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 77 69  ons of SQLite wi
0a00: 6c 6c 0a 20 20 62 65 20 61 62 6c 65 20 74 6f 20  ll.  be able to 
0a10: 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 64  read and write d
0a20: 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 63 72  atabase files cr
0a30: 65 61 74 65 64 20 62 79 20 6e 65 77 65 72 20 76  eated by newer v
0a40: 65 72 73 69 6f 6e 73 0a 20 20 6f 66 20 53 51 4c  ersions.  of SQL
0a50: 69 74 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74  ite, the default
0a60: 20 73 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 77   schema format w
0a70: 61 73 20 73 65 74 20 74 6f 20 31 20 66 6f 72 20  as set to 1 for 
0a80: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 73 0a  SQLite versions.
0a90: 20 20 74 68 72 6f 75 67 68 20 33 2e 37 2e 39 20    through 3.7.9 
0aa0: 28 32 30 31 31 2d 31 31 2d 30 31 29 2e 20 20 42  (2011-11-01).  B
0ab0: 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 76 65  eginning with ve
0ac0: 72 73 69 6f 6e 20 33 2e 37 2e 31 30 2c 20 74 68  rsion 3.7.10, th
0ad0: 65 20 64 65 66 61 75 6c 74 0a 20 20 73 63 68 65  e default.  sche
0ae0: 6d 61 20 66 6f 72 6d 61 74 20 69 73 20 34 2e 0a  ma format is 4..
0af0: 0a 20 20 54 68 65 20 73 63 68 65 6d 61 20 66 6f  .  The schema fo
0b00: 72 6d 61 74 20 6e 75 6d 62 65 72 20 66 6f 72 20  rmat number for 
0b10: 61 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 63  a new database c
0b20: 61 6e 20 62 65 20 73 65 74 20 61 74 20 72 75 6e  an be set at run
0b30: 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65  time using.  the
0b40: 20 5b 50 52 41 47 4d 41 20 6c 65 67 61 63 79 5f   [PRAGMA legacy_
0b50: 66 69 6c 65 5f 66 6f 72 6d 61 74 5d 20 63 6f 6d  file_format] com
0b60: 6d 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  mand..}..COMPILE
0b70: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
0b80: 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 50 45 52  DEFAULT_FILE_PER
0b90: 4d 49 53 53 49 4f 4e 53 3d 3c 69 3e 4e 3c 2f 69  MISSIONS=<i>N</i
0ba0: 3e 7d 20 7b 0a 20 20 54 68 65 20 64 65 66 61 75  >} {.  The defau
0bb0: 6c 74 20 6e 75 6d 65 72 69 63 20 66 69 6c 65 20  lt numeric file 
0bc0: 70 65 72 6d 69 73 73 69 6f 6e 73 20 66 6f 72 20  permissions for 
0bd0: 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 64 61  newly created da
0be0: 74 61 62 61 73 65 20 66 69 6c 65 73 0a 20 20 75  tabase files.  u
0bf0: 6e 64 65 72 20 75 6e 69 78 2e 20 20 49 66 20 6e  nder unix.  If n
0c00: 6f 74 20 73 70 65 63 69 66 69 65 64 2c 20 74 68  ot specified, th
0c10: 65 20 64 65 66 61 75 6c 74 20 69 73 20 30 36 34  e default is 064
0c20: 34 20 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68  4 which means th
0c30: 61 74 0a 20 20 74 68 65 20 66 69 6c 65 73 20 69  at.  the files i
0c40: 73 20 67 6c 6f 62 61 6c 6c 79 20 72 65 61 64 61  s globally reada
0c50: 62 6c 65 20 62 75 74 20 6f 6e 6c 79 20 77 72 69  ble but only wri
0c60: 74 61 62 6c 65 20 62 79 20 74 68 65 20 63 72 65  table by the cre
0c70: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
0c80: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
0c90: 44 45 46 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f  DEFAULT_FOREIGN_
0ca0: 4b 45 59 53 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72  KEYS=<i>&lt;0 or
0cb0: 20 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20   1&gt;</i>} {.  
0cc0: 54 68 69 73 20 6d 61 63 72 6f 20 64 65 74 65 72  This macro deter
0cd0: 6d 69 6e 65 73 20 77 68 65 74 68 65 72 20 65 6e  mines whether en
0ce0: 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 0a 20 20  forcement of .  
0cf0: 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e  [foreign key con
0d00: 73 74 72 61 69 6e 74 73 5d 20 69 73 20 65 6e 61  straints] is ena
0d10: 62 6c 65 64 20 6f 72 20 64 69 73 61 62 6c 65 64  bled or disabled
0d20: 20 62 79 20 64 65 66 61 75 6c 74 20 66 6f 72 0a   by default for.
0d30: 20 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 63    new database c
0d40: 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 20 45 61 63  onnections.  Eac
0d50: 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  h database conne
0d60: 63 74 69 6f 6e 20 63 61 6e 20 61 6c 77 61 79 73  ction can always
0d70: 20 74 75 72 6e 0a 20 20 65 6e 66 6f 72 63 65 6d   turn.  enforcem
0d80: 65 6e 74 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b  ent of foreign k
0d90: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f  ey constraints o
0da0: 6e 20 61 6e 64 20 6f 66 66 20 61 6e 64 20 72 75  n and off and ru
0db0: 6e 2d 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 74  n-time using.  t
0dc0: 68 65 20 5b 66 6f 72 65 69 67 6e 5f 6b 65 79 73  he [foreign_keys
0dd0: 20 70 72 61 67 6d 61 5d 2e 20 20 45 6e 66 6f 72   pragma].  Enfor
0de0: 63 65 6d 65 6e 74 20 6f 66 20 66 6f 72 65 69 67  cement of foreig
0df0: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74  n key constraint
0e00: 73 0a 20 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20  s.  is normally 
0e10: 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74 2c 20  off by default, 
0e20: 62 75 74 20 69 66 20 74 68 69 73 20 63 6f 6d 70  but if this comp
0e30: 69 6c 65 2d 74 69 6d 65 20 70 61 72 61 6d 65 74  ile-time paramet
0e40: 65 72 20 69 73 0a 20 20 73 65 74 20 74 6f 20 31  er is.  set to 1
0e50: 2c 20 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66  , enforcement of
0e60: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e   foreign key con
0e70: 73 74 72 61 69 6e 74 73 20 77 69 6c 6c 20 62 65  straints will be
0e80: 20 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2e 0a   on by default..
0e90: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
0ea0: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
0eb0: 54 5f 4d 4d 41 50 5f 53 49 5a 45 3d 3c 69 3e 4e  T_MMAP_SIZE=<i>N
0ec0: 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d  </i>} {.  This m
0ed0: 61 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65  acro sets the de
0ee0: 66 61 75 6c 74 20 6c 69 6d 69 74 20 6f 6e 20 74  fault limit on t
0ef0: 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d  he amount of mem
0f00: 6f 72 79 20 74 68 61 74 0a 20 20 77 69 6c 6c 20  ory that.  will 
0f10: 62 65 20 75 73 65 64 20 66 6f 72 20 6d 65 6d 6f  be used for memo
0f20: 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 0a 20 20  ry-mapped I/O.  
0f30: 66 6f 72 20 65 61 63 68 20 6f 70 65 6e 20 64 61  for each open da
0f40: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66  tabase file.  If
0f50: 20 74 68 65 20 3c 69 3e 4e 3c 2f 69 3e 0a 20 20   the <i>N</i>.  
0f60: 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6d 65  is zero, then me
0f70: 6d 6f 72 79 20 6d 61 70 70 65 64 20 49 2f 4f 20  mory mapped I/O 
0f80: 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 20 64  is disabled by d
0f90: 65 66 61 75 6c 74 2e 20 20 54 68 69 73 0a 20 20  efault.  This.  
0fa0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6c 69 6d  compile-time lim
0fb0: 69 74 20 61 6e 64 20 74 68 65 20 5b 53 51 4c 49  it and the [SQLI
0fc0: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45  TE_MAX_MMAP_SIZE
0fd0: 5d 20 63 61 6e 20 62 65 20 6d 6f 64 69 66 69 65  ] can be modifie
0fe0: 64 20 0a 20 20 61 74 20 73 74 61 72 74 2d 74 69  d .  at start-ti
0ff0: 6d 65 20 75 73 69 6e 67 20 74 68 65 0a 20 20 5b  me using the.  [
1000: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28  sqlite3_config](
1010: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d  [SQLITE_CONFIG_M
1020: 4d 41 50 5f 53 49 5a 45 5d 29 20 63 61 6c 6c 2c  MAP_SIZE]) call,
1030: 20 6f 72 20 61 74 20 72 75 6e 2d 74 69 6d 65 0a   or at run-time.
1040: 20 20 75 73 69 6e 67 20 74 68 65 20 5b 6d 6d 61    using the [mma
1050: 70 5f 73 69 7a 65 20 70 72 61 67 6d 61 5d 2e 0a  p_size pragma]..
1060: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
1070: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
1080: 54 5f 4a 4f 55 52 4e 41 4c 5f 53 49 5a 45 5f 4c  T_JOURNAL_SIZE_L
1090: 49 4d 49 54 3d 3c 69 3e 26 6c 74 3b 62 79 74 65  IMIT=<i>&lt;byte
10a0: 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  s&gt;</i>} {.  T
10b0: 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 74 73 20  his option sets 
10c0: 74 68 65 20 73 69 7a 65 20 6c 69 6d 69 74 20 6f  the size limit o
10d0: 6e 20 5b 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72  n [rollback jour
10e0: 6e 61 6c 5d 20 66 69 6c 65 73 20 69 6e 0a 20 20  nal] files in.  
10f0: 5b 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 70 72  [journal_mode pr
1100: 61 67 6d 61 20 7c 20 70 65 72 73 69 73 74 65 6e  agma | persisten
1110: 74 20 6a 6f 75 72 6e 61 6c 20 6d 6f 64 65 5d 20  t journal mode] 
1120: 61 6e 64 0a 20 20 5b 6c 6f 63 6b 69 6e 67 5f 6d  and.  [locking_m
1130: 6f 64 65 20 7c 20 65 78 63 6c 75 73 69 76 65 20  ode | exclusive 
1140: 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65 5d 20 61 6e  locking mode] an
1150: 64 20 6f 6e 20 74 68 65 20 73 69 7a 65 20 6f 66  d on the size of
1160: 20 74 68 65 0a 20 20 77 72 69 74 65 2d 61 68 65   the.  write-ahe
1170: 61 64 20 6c 6f 67 20 66 69 6c 65 20 69 6e 20 5b  ad log file in [
1180: 57 41 4c 20 6d 6f 64 65 5d 2e 20 57 68 65 6e 20  WAL mode]. When 
1190: 74 68 69 73 20 0a 20 20 63 6f 6d 70 69 6c 65 2d  this .  compile-
11a0: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 6f  time option is o
11b0: 6d 69 74 74 65 64 20 74 68 65 72 65 20 69 73 20  mitted there is 
11c0: 6e 6f 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f  no upper bound o
11d0: 6e 20 74 68 65 0a 20 20 73 69 7a 65 20 6f 66 20  n the.  size of 
11e0: 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75  the rollback jou
11f0: 72 6e 61 6c 73 20 6f 72 20 77 72 69 74 65 2d 61  rnals or write-a
1200: 68 65 61 64 20 6c 6f 67 73 2e 20 20 0a 20 20 54  head logs.  .  T
1210: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  he journal file 
1220: 73 69 7a 65 20 6c 69 6d 69 74 0a 20 20 63 61 6e  size limit.  can
1230: 20 62 65 20 63 68 61 6e 67 65 64 20 61 74 20 72   be changed at r
1240: 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68  un-time using th
1250: 65 20 5b 6a 6f 75 72 6e 61 6c 5f 73 69 7a 65 5f  e [journal_size_
1260: 6c 69 6d 69 74 20 70 72 61 67 6d 61 5d 2e 0a 7d  limit pragma]..}
1270: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
1280: 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54   {SQLITE_DEFAULT
1290: 5f 4c 4f 43 4b 49 4e 47 5f 4d 4f 44 45 3d 3c 69  _LOCKING_MODE=<i
12a0: 3e 26 6c 74 3b 31 20 6f 72 20 30 26 67 74 3b 3c  >&lt;1 or 0&gt;<
12b0: 2f 69 3e 7d 20 7b 0a 20 20 49 66 20 73 65 74 20  /i>} {.  If set 
12c0: 74 6f 20 31 2c 20 74 68 65 6e 20 74 68 65 20 64  to 1, then the d
12d0: 65 66 61 75 6c 74 20 5b 6c 6f 63 6b 69 6e 67 5f  efault [locking_
12e0: 6d 6f 64 65 5d 20 69 73 20 73 65 74 20 74 6f 20  mode] is set to 
12f0: 45 58 43 4c 55 53 49 56 45 2e 0a 20 20 49 66 20  EXCLUSIVE..  If 
1300: 6f 6d 69 74 74 65 64 20 6f 72 20 73 65 74 20 74  omitted or set t
1310: 6f 20 30 20 74 68 65 6e 20 74 68 65 20 64 65 66  o 0 then the def
1320: 61 75 6c 74 20 5b 6c 6f 63 6b 69 6e 67 5f 6d 6f  ault [locking_mo
1330: 64 65 5d 20 69 73 20 4e 4f 52 4d 41 4c 2e 0a 7d  de] is NORMAL..}
1340: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
1350: 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54   {SQLITE_DEFAULT
1360: 5f 4d 45 4d 53 54 41 54 55 53 3d 3c 69 3e 26 6c  _MEMSTATUS=<i>&l
1370: 74 3b 31 20 6f 72 20 30 26 67 74 3b 3c 2f 69 3e  t;1 or 0&gt;</i>
1380: 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f  } {.  This macro
1390: 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 74 65   is used to dete
13a0: 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72  rmine whether or
13b0: 20 6e 6f 74 20 74 68 65 20 66 65 61 74 75 72 65   not the feature
13c0: 73 20 65 6e 61 62 6c 65 64 20 61 6e 64 0a 20 20  s enabled and.  
13d0: 64 69 73 61 62 6c 65 64 20 75 73 69 6e 67 20 74  disabled using t
13e0: 68 65 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  he SQLITE_CONFIG
13f0: 5f 4d 45 4d 53 54 41 54 55 53 20 61 72 67 75 6d  _MEMSTATUS argum
1400: 65 6e 74 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f  ent to [sqlite3_
1410: 63 6f 6e 66 69 67 28 29 5d 0a 20 20 61 72 65 20  config()].  are 
1420: 61 76 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66  available by def
1430: 61 75 6c 74 2e 20 54 68 65 20 64 65 66 61 75 6c  ault. The defaul
1440: 74 20 76 61 6c 75 65 20 69 73 20 31 20 28 5b 53  t value is 1 ([S
1450: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d  QLITE_CONFIG_MEM
1460: 53 54 41 54 55 53 5d 0a 20 20 72 65 6c 61 74 65  STATUS].  relate
1470: 64 20 66 65 61 74 75 72 65 73 20 65 6e 61 62 6c  d features enabl
1480: 65 64 29 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ed)..}..COMPILE_
1490: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44  OPTION {SQLITE_D
14a0: 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45  EFAULT_PAGE_SIZE
14b0: 3d 3c 69 3e 26 6c 74 3b 62 79 74 65 73 26 67 74  =<i>&lt;bytes&gt
14c0: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20  ;</i>} {.  This 
14d0: 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f  macro is used to
14e0: 20 73 65 74 20 74 68 65 20 64 65 66 61 75 6c 74   set the default
14f0: 20 70 61 67 65 2d 73 69 7a 65 20 75 73 65 64 20   page-size used 
1500: 77 68 65 6e 20 61 0a 20 20 64 61 74 61 62 61 73  when a.  databas
1510: 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 54 68  e is created. Th
1520: 65 20 76 61 6c 75 65 20 61 73 73 69 67 6e 65 64  e value assigned
1530: 20 6d 75 73 74 20 62 65 20 61 20 70 6f 77 65 72   must be a power
1540: 20 6f 66 20 32 2e 20 54 68 65 0a 20 20 64 65 66   of 2. The.  def
1550: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 31 30  ault value is 10
1560: 32 34 2e 20 54 68 65 20 63 6f 6d 70 69 6c 65 2d  24. The compile-
1570: 74 69 6d 65 20 64 65 66 61 75 6c 74 20 6d 61 79  time default may
1580: 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 61   be overridden a
1590: 74 20 0a 20 20 72 75 6e 74 69 6d 65 20 62 79 20  t .  runtime by 
15a0: 74 68 65 20 5b 50 52 41 47 4d 41 20 70 61 67 65  the [PRAGMA page
15b0: 5f 73 69 7a 65 5d 20 63 6f 6d 6d 61 6e 64 2e 0a  _size] command..
15c0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
15d0: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
15e0: 54 5f 54 45 4d 50 5f 43 41 43 48 45 5f 53 49 5a  T_TEMP_CACHE_SIZ
15f0: 45 3d 3c 69 3e 26 6c 74 3b 70 61 67 65 73 26 67  E=<i>&lt;pages&g
1600: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
1610: 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65 20   macro sets the 
1620: 64 65 66 61 75 6c 74 20 73 69 7a 65 20 6f 66 20  default size of 
1630: 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 66  the page-cache f
1640: 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c  or temporary fil
1650: 65 73 0a 20 20 63 72 65 61 74 65 64 20 62 79 20  es.  created by 
1660: 53 51 4c 69 74 65 20 74 6f 20 73 74 6f 72 65 20  SQLite to store 
1670: 69 6e 74 65 72 6d 65 64 69 61 74 65 20 72 65 73  intermediate res
1680: 75 6c 74 73 2c 20 69 6e 20 70 61 67 65 73 2e 20  ults, in pages. 
1690: 49 74 20 64 6f 65 73 0a 20 20 6e 6f 74 20 61 66  It does.  not af
16a0: 66 65 63 74 20 74 68 65 20 70 61 67 65 2d 63 61  fect the page-ca
16b0: 63 68 65 20 66 6f 72 20 74 68 65 20 74 65 6d 70  che for the temp
16c0: 20 64 61 74 61 62 61 73 65 2c 20 77 68 65 72 65   database, where
16d0: 20 74 61 62 6c 65 73 20 63 72 65 61 74 65 64 0a   tables created.
16e0: 20 20 75 73 69 6e 67 20 5b 43 52 45 41 54 45 20    using [CREATE 
16f0: 54 41 42 4c 45 20 7c 20 43 52 45 41 54 45 20 54  TABLE | CREATE T
1700: 45 4d 50 20 54 41 42 4c 45 5d 20 61 72 65 20 73  EMP TABLE] are s
1710: 74 6f 72 65 64 2e 20 54 68 65 20 64 65 66 61 75  tored. The defau
1720: 6c 74 20 76 61 6c 75 65 0a 20 20 69 73 20 35 30  lt value.  is 50
1730: 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  0..}..COMPILE_OP
1740: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46  TION {SQLITE_DEF
1750: 41 55 4c 54 5f 57 41 4c 5f 41 55 54 4f 43 48 45  AULT_WAL_AUTOCHE
1760: 43 4b 50 4f 49 4e 54 3d 3c 69 3e 26 6c 74 3b 70  CKPOINT=<i>&lt;p
1770: 61 67 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  ages&gt;</i>} {.
1780: 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74    This macro set
1790: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61  s the default pa
17a0: 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 74 68 65  ge count for the
17b0: 20 5b 57 41 4c 5d 0a 20 20 5b 63 68 65 63 6b 70   [WAL].  [checkp
17c0: 6f 69 6e 74 69 6e 67 20 7c 20 61 75 74 6f 6d 61  ointing | automa
17d0: 74 69 63 20 63 68 65 63 6b 70 6f 69 6e 74 69 6e  tic checkpointin
17e0: 67 5d 20 66 65 61 74 75 72 65 2e 20 20 49 66 20  g] feature.  If 
17f0: 75 6e 73 70 65 63 69 66 69 65 64 2c 0a 20 20 74  unspecified,.  t
1800: 68 65 20 64 65 66 61 75 6c 74 20 70 61 67 65 20  he default page 
1810: 63 6f 75 6e 74 20 69 73 20 31 30 30 30 2e 0a 7d  count is 1000..}
1820: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
1830: 20 7b 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41   {SQLITE_MAX_MMA
1840: 50 5f 53 49 5a 45 3d 3c 69 3e 4e 3c 2f 69 3e 7d  P_SIZE=<i>N</i>}
1850: 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20   {.  This macro 
1860: 73 65 74 73 20 61 20 68 61 72 64 20 75 70 70 65  sets a hard uppe
1870: 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 20 61  r bound on the a
1880: 6d 6f 75 6e 74 20 6f 66 20 61 64 64 72 65 73 73  mount of address
1890: 20 73 70 61 63 65 20 74 68 61 74 0a 20 20 63 61   space that.  ca
18a0: 6e 20 62 65 20 75 73 65 64 20 62 79 20 61 6e 79  n be used by any
18b0: 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65   single database
18c0: 20 66 6f 72 20 6d 65 6d 6f 72 79 2d 6d 61 70 70   for memory-mapp
18d0: 65 64 20 49 2f 4f 2e 0a 20 20 53 65 74 74 69 6e  ed I/O..  Settin
18e0: 67 20 74 68 69 73 20 76 61 6c 75 65 20 74 6f 20  g this value to 
18f0: 30 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 73  0 completely dis
1900: 61 62 6c 65 73 20 6d 65 6d 6f 72 79 2d 6d 61 70  ables memory-map
1910: 70 65 64 20 49 2f 4f 20 61 6e 64 0a 20 20 63 61  ped I/O and.  ca
1920: 75 73 65 73 20 6c 6f 67 69 63 20 61 73 73 6f 63  uses logic assoc
1930: 69 61 74 65 64 20 77 69 74 68 20 6d 65 6d 6f 72  iated with memor
1940: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 74 6f 20  y-mapped I/O to 
1950: 62 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20  be omitted from 
1960: 74 68 65 0a 20 20 62 75 69 6c 64 2e 20 20 54 68  the.  build.  Th
1970: 69 73 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20 63  is option does c
1980: 68 61 6e 67 65 20 74 68 65 20 64 65 66 61 75 6c  hange the defaul
1990: 74 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20  t memory-mapped 
19a0: 49 2f 4f 20 61 64 64 72 65 73 73 0a 20 20 73 70  I/O address.  sp
19b0: 61 63 65 20 73 69 7a 65 20 28 73 65 74 20 62 79  ace size (set by
19c0: 20 5b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54   [SQLITE_DEFAULT
19d0: 5f 4d 4d 41 50 5f 53 49 5a 45 5d 20 6f 72 0a 20  _MMAP_SIZE] or. 
19e0: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28   sqlite3_config(
19f0: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d  [SQLITE_CONFIG_M
1a00: 4d 41 50 5f 53 49 5a 45 5d 29 20 6f 72 20 74 68  MAP_SIZE]) or th
1a10: 65 0a 20 20 72 75 6e 2d 74 69 6d 65 20 6d 65 6d  e.  run-time mem
1a20: 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 61  ory-mapped I/O a
1a30: 64 64 72 65 73 73 20 73 70 61 63 65 20 73 69 7a  ddress space siz
1a40: 65 20 28 73 65 74 20 62 79 0a 20 20 73 71 6c 69  e (set by.  sqli
1a50: 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 6f 6c  te3_file_control
1a60: 28 5b 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4d  ([SQLITE_FCNTL_M
1a70: 4d 41 50 5f 53 49 5a 45 5d 29 20 6f 72 0a 20 20  MAP_SIZE]) or.  
1a80: 5b 50 52 41 47 4d 41 20 6d 6d 61 70 5f 73 69 7a  [PRAGMA mmap_siz
1a90: 65 5d 29 20 61 73 20 6c 6f 6e 67 20 61 73 20 74  e]) as long as t
1aa0: 68 6f 73 65 20 6f 74 68 65 72 20 73 65 74 74 69  hose other setti
1ab0: 6e 67 73 20 61 72 65 20 6c 65 73 73 20 74 68 61  ngs are less tha
1ac0: 6e 20 74 68 65 0a 20 20 6d 61 78 69 6d 75 6d 20  n the.  maximum 
1ad0: 76 61 6c 75 65 20 64 65 66 69 6e 65 64 20 68 65  value defined he
1ae0: 72 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  re..}..COMPILE_O
1af0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 41  PTION {SQLITE_MA
1b00: 58 5f 53 43 48 45 4d 41 5f 52 45 54 52 59 3d 3c  X_SCHEMA_RETRY=<
1b10: 69 3e 4e 3c 2f 69 3e 7d 20 7b 0a 20 20 57 68 65  i>N</i>} {.  Whe
1b20: 6e 65 76 65 72 20 74 68 65 20 64 61 74 61 62 61  never the databa
1b30: 73 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  se schema change
1b40: 73 2c 20 70 72 65 70 61 72 65 64 20 73 74 61 74  s, prepared stat
1b50: 65 6d 65 6e 74 73 20 61 72 65 20 61 75 74 6f 6d  ements are autom
1b60: 61 74 69 63 61 6c 6c 79 0a 20 20 72 65 70 72 65  atically.  repre
1b70: 70 61 72 65 64 20 74 6f 20 61 63 63 6f 6d 6d 6f  pared to accommo
1b80: 64 61 74 65 20 74 68 65 20 6e 65 77 20 73 63 68  date the new sch
1b90: 65 6d 61 2e 20 20 54 68 65 72 65 20 69 73 20 61  ema.  There is a
1ba0: 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 20   race condition 
1bb0: 68 65 72 65 0a 20 20 69 6e 20 74 68 61 74 20 69  here.  in that i
1bc0: 66 20 6f 6e 65 20 74 68 72 65 61 64 20 69 73 20  f one thread is 
1bd0: 63 6f 6e 73 74 61 6e 74 6c 79 20 63 68 61 6e 67  constantly chang
1be0: 69 6e 67 20 74 68 65 20 73 63 68 65 6d 61 2c 20  ing the schema, 
1bf0: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 0a 20  another thread. 
1c00: 20 6d 69 67 68 74 20 73 70 69 6e 20 6f 6e 20 72   might spin on r
1c10: 65 70 61 72 73 65 73 20 61 6e 64 20 72 65 70 72  eparses and repr
1c20: 65 70 61 72 61 74 69 6f 6e 73 20 6f 66 20 61 20  eparations of a 
1c30: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
1c40: 6e 74 20 61 6e 64 0a 20 20 6e 65 76 65 72 20 67  nt and.  never g
1c50: 65 74 20 61 6e 79 20 72 65 61 6c 20 77 6f 72 6b  et any real work
1c60: 20 64 6f 6e 65 2e 20 20 54 68 69 73 20 70 61 72   done.  This par
1c70: 61 6d 65 74 65 72 20 70 72 65 76 65 6e 74 73 20  ameter prevents 
1c80: 61 6e 20 69 6e 66 69 6e 69 74 65 20 6c 6f 6f 70  an infinite loop
1c90: 0a 20 20 62 79 20 66 6f 72 63 69 6e 67 20 74 68  .  by forcing th
1ca0: 65 20 73 70 69 6e 6e 69 6e 67 20 74 68 72 65 61  e spinning threa
1cb0: 64 20 74 6f 20 67 69 76 65 20 75 70 20 61 66 74  d to give up aft
1cc0: 65 72 20 61 20 66 69 78 65 64 20 6e 75 6d 62 65  er a fixed numbe
1cd0: 72 20 6f 66 20 61 74 74 65 6d 70 74 73 0a 20 20  r of attempts.  
1ce0: 61 74 20 72 65 63 6f 6d 70 69 6c 69 6e 67 20 74  at recompiling t
1cf0: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
1d00: 65 6d 65 6e 74 2e 20 20 54 68 65 20 64 65 66 61  ement.  The defa
1d10: 75 6c 74 20 73 65 74 74 69 6e 67 20 69 73 20 35  ult setting is 5
1d20: 30 20 77 68 69 63 68 20 69 73 0a 20 20 6d 6f 72  0 which is.  mor
1d30: 65 20 74 68 61 6e 20 61 64 65 71 75 61 74 65 20  e than adequate 
1d40: 66 6f 72 20 6d 6f 73 74 20 61 70 70 6c 69 63 61  for most applica
1d50: 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  tions..}..COMPIL
1d60: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
1d70: 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57  _POWERSAFE_OVERW
1d80: 52 49 54 45 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72  RITE=<i>&lt;0 or
1d90: 20 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20   1&gt;</i>} {.  
1da0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 68 61 6e  This option chan
1db0: 67 65 73 20 74 68 65 20 64 65 66 61 75 6c 74 20  ges the default 
1dc0: 61 73 73 75 6d 70 74 69 6f 6e 20 61 62 6f 75 74  assumption about
1dd0: 20 5b 70 6f 77 65 72 73 61 66 65 20 6f 76 65 72   [powersafe over
1de0: 77 72 69 74 65 5d 0a 20 20 66 6f 72 20 74 68 65  write].  for the
1df0: 20 75 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65   underlying file
1e00: 73 79 73 74 65 6d 73 20 66 6f 72 20 74 68 65 20  systems for the 
1e10: 75 6e 69 78 20 61 6e 64 20 77 69 6e 64 6f 77 73  unix and windows
1e20: 20 5b 56 46 53 65 73 5d 2e 0a 20 20 53 65 74 74   [VFSes]..  Sett
1e30: 69 6e 67 20 53 51 4c 49 54 45 5f 50 4f 57 45 52  ing SQLITE_POWER
1e40: 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 20 74  SAFE_OVERWRITE t
1e50: 6f 20 31 20 63 61 75 73 65 73 20 53 51 4c 69 74  o 1 causes SQLit
1e60: 65 20 74 6f 20 61 73 73 75 6d 65 20 74 68 61 74  e to assume that
1e70: 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 2d 6c  .  application-l
1e80: 65 76 65 6c 20 77 72 69 74 65 73 20 63 61 6e 6e  evel writes cann
1e90: 6f 74 20 63 68 61 6e 67 65 73 20 62 79 74 65 73  ot changes bytes
1ea0: 20 6f 75 74 73 69 64 65 20 74 68 65 20 72 61 6e   outside the ran
1eb0: 67 65 20 6f 66 0a 20 20 62 79 74 65 73 20 77 72  ge of.  bytes wr
1ec0: 69 74 74 65 6e 20 65 76 65 6e 20 69 66 20 74 68  itten even if th
1ed0: 65 20 77 72 69 74 65 20 6f 63 63 75 72 73 20 6a  e write occurs j
1ee0: 75 73 74 20 62 65 66 6f 72 65 20 61 20 70 6f 77  ust before a pow
1ef0: 65 72 20 6c 6f 73 73 2e 0a 20 20 57 69 74 68 20  er loss..  With 
1f00: 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45  SQLITE_POWERSAFE
1f10: 5f 4f 56 45 52 57 52 49 54 45 20 73 65 74 20 74  _OVERWRITE set t
1f20: 6f 20 30 2c 20 53 51 4c 69 74 65 20 61 73 73 75  o 0, SQLite assu
1f30: 6d 65 73 20 74 68 61 74 20 6f 74 68 65 72 0a 20  mes that other. 
1f40: 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 73 61   bytes in the sa
1f50: 6d 65 20 73 65 63 74 6f 72 20 77 69 74 68 20 61  me sector with a
1f60: 20 77 72 69 74 74 65 6e 20 62 79 74 65 20 6d 69   written byte mi
1f70: 67 68 74 20 62 65 20 63 68 61 6e 67 65 64 20 6f  ght be changed o
1f80: 72 20 0a 20 20 64 61 6d 61 67 65 64 20 62 79 20  r .  damaged by 
1f90: 61 20 70 6f 77 65 72 20 6c 6f 73 73 2e 0a 7d 0a  a power loss..}.
1fa0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
1fb0: 7b 59 59 53 54 41 43 4b 44 45 50 54 48 3d 3c 69  {YYSTACKDEPTH=<i
1fc0: 3e 26 6c 74 3b 6d 61 78 5f 64 65 70 74 68 26 67  >&lt;max_depth&g
1fd0: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73  t;</i>} {.  This
1fe0: 20 6d 61 63 72 6f 20 73 65 74 73 20 74 68 65 20   macro sets the 
1ff0: 6d 61 78 69 6d 75 6d 20 64 65 70 74 68 20 6f 66  maximum depth of
2000: 20 74 68 65 20 4c 41 4c 52 28 31 29 20 73 74 61   the LALR(1) sta
2010: 63 6b 20 75 73 65 64 20 62 79 0a 20 20 74 68 65  ck used by.  the
2020: 20 53 51 4c 20 70 61 72 73 65 72 20 77 69 74 68   SQL parser with
2030: 69 6e 20 53 51 4c 69 74 65 2e 20 20 54 68 65 20  in SQLite.  The 
2040: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73  default value is
2050: 20 31 30 30 2e 20 20 41 20 74 79 70 69 63 61 6c   100.  A typical
2060: 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 77  .  application w
2070: 69 6c 6c 20 75 73 65 20 6c 65 73 73 20 74 68 61  ill use less tha
2080: 6e 20 61 62 6f 75 74 20 32 30 20 6c 65 76 65 6c  n about 20 level
2090: 73 20 6f 66 20 74 68 65 20 73 74 61 63 6b 2e 0a  s of the stack..
20a0: 20 20 44 65 76 65 6c 6f 70 65 72 73 20 77 68 6f    Developers who
20b0: 73 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  se applications 
20c0: 63 6f 6e 74 61 69 6e 20 53 51 4c 20 73 74 61 74  contain SQL stat
20d0: 65 6d 65 6e 74 73 20 74 68 61 74 20 0a 20 20 6e  ements that .  n
20e0: 65 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 31 30  eed more than 10
20f0: 30 20 4c 41 4c 52 28 31 29 20 73 74 61 63 6b 20  0 LALR(1) stack 
2100: 65 6e 74 72 69 65 73 20 73 68 6f 75 6c 64 20 73  entries should s
2110: 65 72 69 6f 75 73 6c 79 0a 20 20 63 6f 6e 73 69  eriously.  consi
2120: 64 65 72 20 72 65 66 61 63 74 6f 72 69 6e 67 20  der refactoring 
2130: 74 68 65 69 72 20 53 51 4c 20 61 73 20 69 74 20  their SQL as it 
2140: 69 73 20 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20  is likely to be 
2150: 77 65 6c 6c 20 62 65 79 6f 6e 64 0a 20 20 74 68  well beyond.  th
2160: 65 20 61 62 69 6c 69 74 79 20 6f 66 20 61 6e 79  e ability of any
2170: 20 68 75 6d 61 6e 20 74 6f 20 63 6f 6d 70 72 65   human to compre
2180: 68 65 6e 64 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a  hend..}.</tcl>..
2190: 3c 68 32 3e 31 2e 32 20 4f 70 74 69 6f 6e 73 20  <h2>1.2 Options 
21a0: 54 6f 20 53 65 74 20 53 69 7a 65 20 4c 69 6d 69  To Set Size Limi
21b0: 74 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 72  ts</h2>..<p>Ther
21c0: 65 20 61 72 65 20 63 6f 6d 70 69 6c 65 2d 74 69  e are compile-ti
21d0: 6d 65 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20  me options that 
21e0: 77 69 6c 6c 20 73 65 74 20 75 70 70 65 72 20 62  will set upper b
21f0: 6f 75 6e 64 73 0a 6f 6e 20 74 68 65 20 73 69 7a  ounds.on the siz
2200: 65 73 20 6f 66 20 76 61 72 69 6f 75 73 20 73 74  es of various st
2210: 72 75 63 74 75 72 65 73 20 69 6e 20 53 51 4c 69  ructures in SQLi
2220: 74 65 2e 20 20 54 68 65 20 63 6f 6d 70 69 6c 65  te.  The compile
2230: 2d 74 69 6d 65 0a 6f 70 74 69 6f 6e 73 20 6e 6f  -time.options no
2240: 72 6d 61 6c 6c 79 20 73 65 74 20 61 20 68 61 72  rmally set a har
2250: 64 20 75 70 70 65 72 20 62 6f 75 6e 64 20 74 68  d upper bound th
2260: 61 74 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65  at can be change
2270: 64 0a 61 74 20 72 75 6e 2d 74 69 6d 65 20 6f 6e  d.at run-time on
2280: 20 69 6e 64 69 76 69 64 75 61 6c 20 5b 64 61 74   individual [dat
2290: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
22a0: 73 5d 20 75 73 69 6e 67 20 74 68 65 0a 5b 73 71  s] using the.[sq
22b0: 6c 69 74 65 33 5f 6c 69 6d 69 74 28 29 5d 20 69  lite3_limit()] i
22c0: 6e 74 65 72 66 61 63 65 2e 3c 2f 70 3e 0a 0a 3c  nterface.</p>..<
22d0: 70 3e 54 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69  p>The compile-ti
22e0: 6d 65 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 73  me options for s
22f0: 65 74 74 69 6e 67 20 75 70 70 65 72 20 62 6f 75  etting upper bou
2300: 6e 64 73 20 61 72 65 0a 5b 6c 69 6d 69 74 73 20  nds are.[limits 
2310: 7c 20 64 6f 63 75 6d 65 6e 74 65 64 20 73 65 70  | documented sep
2320: 61 72 61 74 65 6c 79 5d 2e 20 20 54 68 65 20 66  arately].  The f
2330: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 6c 69  ollowing is a li
2340: 73 74 20 6f 66 0a 74 68 65 20 61 76 61 69 6c 61  st of.the availa
2350: 62 6c 65 20 73 65 74 74 69 6e 67 73 3a 3c 2f 70  ble settings:</p
2360: 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 20 5b 53 51  >..<ul>.<li> [SQ
2370: 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45  LITE_MAX_ATTACHE
2380: 44 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b  D]  </li>.<li> [
2390: 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4c 55 4d  SQLITE_MAX_COLUM
23a0: 4e 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b  N]  </li>.<li> [
23b0: 53 51 4c 49 54 45 5f 4d 41 58 5f 43 4f 4d 50 4f  SQLITE_MAX_COMPO
23c0: 55 4e 44 5f 53 45 4c 45 43 54 5d 20 20 3c 2f 6c  UND_SELECT]  </l
23d0: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
23e0: 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 5d 20  MAX_EXPR_DEPTH] 
23f0: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c   </li>.<li> [SQL
2400: 49 54 45 5f 4d 41 58 5f 46 55 4e 43 54 49 4f 4e  ITE_MAX_FUNCTION
2410: 5f 41 52 47 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69  _ARG]  </li>.<li
2420: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 45  > [SQLITE_MAX_LE
2430: 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69  NGTH]  </li>.<li
2440: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 4c 49  > [SQLITE_MAX_LI
2450: 4b 45 5f 50 41 54 54 45 52 4e 5f 4c 45 4e 47 54  KE_PATTERN_LENGT
2460: 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b  H]  </li>.<li> [
2470: 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f  SQLITE_MAX_PAGE_
2480: 43 4f 55 4e 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  COUNT]  </li>.<l
2490: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 53  i> [SQLITE_MAX_S
24a0: 51 4c 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69  QL_LENGTH]  </li
24b0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
24c0: 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42  AX_VARIABLE_NUMB
24d0: 45 52 5d 20 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e  ER]  </li>.</ul>
24e0: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 63 6f 6e 74 72  ..<a name="contr
24f0: 6f 6c 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e  olfeatures"></a>
2500: 0a 3c 68 32 3e 31 2e 33 20 4f 70 74 69 6f 6e 73  .<h2>1.3 Options
2510: 20 54 6f 20 43 6f 6e 74 72 6f 6c 20 4f 70 65 72   To Control Oper
2520: 61 74 69 6e 67 20 43 68 61 72 61 63 74 65 72 69  ating Characteri
2530: 73 74 69 63 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c  stics</h2>..<tcl
2540: 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  >.COMPILE_OPTION
2550: 20 7b 53 51 4c 49 54 45 5f 34 5f 42 59 54 45 5f   {SQLITE_4_BYTE_
2560: 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f 43 7d 20  ALIGNED_MALLOC} 
2570: 7b 0a 20 20 4f 6e 20 6d 6f 73 74 20 73 79 73 74  {.  On most syst
2580: 65 6d 73 2c 20 74 68 65 20 6d 61 6c 6c 6f 63 28  ems, the malloc(
2590: 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 72 65  ) system call re
25a0: 74 75 72 6e 73 20 61 20 62 75 66 66 65 72 20 74  turns a buffer t
25b0: 68 61 74 20 69 73 0a 20 20 61 6c 69 67 6e 65 64  hat is.  aligned
25c0: 20 74 6f 20 61 6e 20 38 2d 62 79 74 65 20 62 6f   to an 8-byte bo
25d0: 75 6e 64 61 72 79 2e 20 20 42 75 74 20 6f 6e 20  undary.  But on 
25e0: 73 6f 6d 65 20 73 79 73 74 65 6d 73 20 28 65 78  some systems (ex
25f0: 3a 20 77 69 6e 64 6f 77 73 29 20 6d 61 6c 6c 6f  : windows) mallo
2600: 63 28 29 0a 20 20 72 65 74 75 72 6e 73 20 34 2d  c().  returns 4-
2610: 62 79 74 65 20 61 6c 69 67 6e 65 64 20 70 6f 69  byte aligned poi
2620: 6e 74 65 72 2e 20 20 54 68 69 73 20 63 6f 6d 70  nter.  This comp
2630: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20  ile-time option 
2640: 6d 75 73 74 20 62 65 20 75 73 65 64 0a 20 20 6f  must be used.  o
2650: 6e 20 73 79 73 74 65 6d 73 20 74 68 61 74 20 72  n systems that r
2660: 65 74 75 72 6e 20 34 2d 62 79 74 65 20 61 6c 69  eturn 4-byte ali
2670: 67 6e 65 64 20 70 6f 69 6e 74 65 72 73 20 66 72  gned pointers fr
2680: 6f 6d 20 6d 61 6c 6c 6f 63 28 29 2e 0a 7d 0a 0a  om malloc()..}..
2690: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
26a0: 53 51 4c 49 54 45 5f 43 41 53 45 5f 53 45 4e 53  SQLITE_CASE_SENS
26b0: 49 54 49 56 45 5f 4c 49 4b 45 7d 20 7b 0a 20 20  ITIVE_LIKE} {.  
26c0: 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  If this option i
26d0: 73 20 70 72 65 73 65 6e 74 2c 20 74 68 65 6e 20  s present, then 
26e0: 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 5b 4c 49  the built-in [LI
26f0: 4b 45 5d 20 6f 70 65 72 61 74 6f 72 20 77 69 6c  KE] operator wil
2700: 6c 20 62 65 0a 20 20 63 61 73 65 20 73 65 6e 73  l be.  case sens
2710: 69 74 69 76 65 2e 20 20 54 68 69 73 20 73 61 6d  itive.  This sam
2720: 65 20 65 66 66 65 63 74 20 63 61 6e 20 62 65 20  e effect can be 
2730: 61 63 68 69 65 76 65 64 20 61 74 20 72 75 6e 2d  achieved at run-
2740: 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65  time using.  the
2750: 20 5b 63 61 73 65 5f 73 65 6e 73 69 74 69 76 65   [case_sensitive
2760: 5f 6c 69 6b 65 20 70 72 61 67 6d 61 5d 2e 0a 7d  _like pragma]..}
2770: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
2780: 20 7b 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f   {SQLITE_DIRECT_
2790: 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 7d 20 7b  OVERFLOW_READ} {
27a0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
27b0: 69 6f 6e 20 69 73 20 70 72 65 73 65 6e 74 2c 20  ion is present, 
27c0: 63 6f 6e 74 65 6e 74 20 63 6f 6e 74 61 69 6e 65  content containe
27d0: 64 20 69 6e 0a 20 20 5b 6f 76 65 72 66 6c 6f 77  d in.  [overflow
27e0: 20 70 61 67 65 73 5d 20 6f 66 20 74 68 65 20 64   pages] of the d
27f0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20  atabase file is 
2800: 72 65 61 64 20 64 69 72 65 63 74 6c 79 20 66 72  read directly fr
2810: 6f 6d 20 64 69 73 6b 2c 0a 20 20 62 79 70 61 73  om disk,.  bypas
2820: 73 69 6e 67 20 74 68 65 20 5b 70 61 67 65 20 63  sing the [page c
2830: 61 63 68 65 5d 2c 20 64 75 72 69 6e 67 20 72 65  ache], during re
2840: 61 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e  ad transactions.
2850: 20 20 49 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e    In application
2860: 73 0a 20 20 74 68 61 74 20 64 6f 20 61 20 6c 6f  s.  that do a lo
2870: 74 20 6f 66 20 72 65 61 64 73 20 6f 66 20 6c 61  t of reads of la
2880: 72 67 65 20 42 4c 4f 42 73 2c 20 74 68 69 73 20  rge BLOBs, this 
2890: 6f 70 74 69 6f 6e 20 6d 69 67 68 74 20 69 6d 70  option might imp
28a0: 72 6f 76 65 20 72 65 61 64 0a 20 20 70 65 72 66  rove read.  perf
28b0: 6f 72 6d 61 6e 63 65 2e 0a 7d 0a 0a 43 4f 4d 50  ormance..}..COMP
28c0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
28d0: 54 45 5f 48 41 56 45 5f 49 53 4e 41 4e 7d 20 7b  TE_HAVE_ISNAN} {
28e0: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
28f0: 6e 20 69 73 20 70 72 65 73 65 6e 74 2c 20 74 68  n is present, th
2900: 65 6e 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 75  en SQLite will u
2910: 73 65 20 74 68 65 20 69 73 6e 61 6e 28 29 20 66  se the isnan() f
2920: 75 6e 63 74 69 6f 6e 20 66 72 6f 6d 0a 20 20 74  unction from.  t
2930: 68 65 20 73 79 73 74 65 6d 20 6d 61 74 68 20 6c  he system math l
2940: 69 62 72 61 72 79 2e 20 20 57 69 74 68 6f 75 74  ibrary.  Without
2950: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 28 74 68   this option (th
2960: 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69  e default behavi
2970: 6f 72 29 0a 20 20 53 51 4c 69 74 65 20 75 73 65  or).  SQLite use
2980: 73 20 69 74 73 20 6f 77 6e 20 69 6e 74 65 72 6e  s its own intern
2990: 61 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  al implementatio
29a0: 6e 20 6f 66 20 69 73 6e 61 6e 28 29 2e 20 20 53  n of isnan().  S
29b0: 51 4c 69 74 65 20 75 73 65 73 0a 20 20 69 74 73  QLite uses.  its
29c0: 20 6f 77 6e 20 69 6e 74 65 72 6e 61 6c 20 69 73   own internal is
29d0: 6e 61 6e 28 29 20 69 6d 70 6c 65 6d 65 6e 74 61  nan() implementa
29e0: 74 69 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 20  tion by default 
29f0: 62 65 63 61 75 73 65 20 6f 66 20 70 61 73 74 0a  because of past.
2a00: 20 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 20    problems with 
2a10: 73 79 73 74 65 6d 20 69 73 6e 61 6e 28 29 20 66  system isnan() f
2a20: 75 6e 63 74 69 6f 6e 73 2e 0a 7d 0a 0a 43 4f 4d  unctions..}..COM
2a30: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
2a40: 49 54 45 5f 4f 53 5f 4f 54 48 45 52 3d 3c 69 3e  ITE_OS_OTHER=<i>
2a50: 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f  &lt;0 or 1&gt;</
2a60: 69 3e 7d 20 7b 0a 20 20 54 68 65 20 6f 70 74 69  i>} {.  The opti
2a70: 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65  on causes SQLite
2a80: 20 74 6f 20 6f 6d 69 74 20 69 74 73 20 62 75 69   to omit its bui
2a90: 6c 74 2d 69 6e 20 6f 70 65 72 61 74 69 6e 67 20  lt-in operating 
2aa0: 73 79 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65  system interface
2ab0: 73 0a 20 20 66 6f 72 20 55 6e 69 78 2c 20 57 69  s.  for Unix, Wi
2ac0: 6e 64 6f 77 73 2c 20 61 6e 64 20 4f 53 2f 32 2e  ndows, and OS/2.
2ad0: 20 20 54 68 65 20 72 65 73 75 6c 74 69 6e 67 20    The resulting 
2ae0: 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 68 61 76  library will hav
2af0: 65 20 6e 6f 20 64 65 66 61 75 6c 74 0a 20 20 5b  e no default.  [
2b00: 73 71 6c 69 74 65 33 5f 76 66 73 20 7c 20 6f 70  sqlite3_vfs | op
2b10: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69  erating system i
2b20: 6e 74 65 72 66 61 63 65 5d 2e 20 20 41 70 70 6c  nterface].  Appl
2b30: 69 63 61 74 69 6f 6e 73 20 6d 75 73 74 20 75 73  ications must us
2b40: 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 76 66 73  e.  [sqlite3_vfs
2b50: 5f 72 65 67 69 73 74 65 72 28 29 5d 20 74 6f 20  _register()] to 
2b60: 72 65 67 69 73 74 65 72 20 61 6e 20 61 70 70 72  register an appr
2b70: 6f 70 72 69 61 74 65 20 69 6e 74 65 72 66 61 63  opriate interfac
2b80: 65 20 62 65 66 6f 72 65 0a 20 20 75 73 69 6e 67  e before.  using
2b90: 20 53 51 4c 69 74 65 2e 20 20 41 70 70 6c 69 63   SQLite.  Applic
2ba0: 61 74 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73 6f  ations must also
2bb0: 20 73 75 70 70 6c 79 20 69 6d 70 6c 65 6d 65 6e   supply implemen
2bc0: 74 61 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 0a  tations for the.
2bd0: 20 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69 6e    [sqlite3_os_in
2be0: 69 74 28 29 5d 20 61 6e 64 20 5b 73 71 6c 69 74  it()] and [sqlit
2bf0: 65 33 5f 6f 73 5f 65 6e 64 28 29 5d 20 69 6e 74  e3_os_end()] int
2c00: 65 72 66 61 63 65 73 2e 20 20 54 68 65 20 75 73  erfaces.  The us
2c10: 75 61 6c 20 70 72 61 63 74 69 63 65 0a 20 20 69  ual practice.  i
2c20: 73 20 66 6f 72 20 74 68 65 20 73 75 70 70 6c 69  s for the suppli
2c30: 65 64 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69  ed [sqlite3_os_i
2c40: 6e 69 74 28 29 5d 20 74 6f 20 69 6e 76 6f 6b 65  nit()] to invoke
2c50: 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 5f 72 65   [sqlite3_vfs_re
2c60: 67 69 73 74 65 72 28 29 5d 2e 0a 20 20 53 51 4c  gister()]..  SQL
2c70: 69 74 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74  ite will automat
2c80: 69 63 61 6c 6c 79 20 69 6e 76 6f 6b 65 20 5b 73  ically invoke [s
2c90: 71 6c 69 74 65 33 5f 6f 73 5f 69 6e 69 74 28 29  qlite3_os_init()
2ca0: 5d 20 77 68 65 6e 20 69 74 20 69 6e 69 74 69 61  ] when it initia
2cb0: 6c 69 7a 65 73 2e 0a 0a 20 20 54 68 69 73 20 6f  lizes...  This o
2cc0: 70 74 69 6f 6e 20 69 73 20 74 79 70 69 63 61 6c  ption is typical
2cd0: 6c 79 20 75 73 65 64 20 77 68 65 6e 20 62 75 69  ly used when bui
2ce0: 6c 64 69 6e 67 20 53 51 4c 69 74 65 20 66 6f 72  lding SQLite for
2cf0: 20 61 6e 20 65 6d 62 65 64 64 65 64 0a 20 20 70   an embedded.  p
2d00: 6c 61 74 66 6f 72 6d 20 77 69 74 68 20 61 20 63  latform with a c
2d10: 75 73 74 6f 6d 20 6f 70 65 72 61 74 69 6e 67 20  ustom operating 
2d20: 73 79 73 74 65 6d 2e 0a 7d 0a 0a 43 4f 4d 50 49  system..}..COMPI
2d30: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
2d40: 45 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 7d  E_SECURE_DELETE}
2d50: 20 7b 0a 20 20 54 68 69 73 20 63 6f 6d 70 69 6c   {.  This compil
2d60: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20 63 68  e-time option ch
2d70: 61 6e 67 65 73 20 74 68 65 20 64 65 66 61 75 6c  anges the defaul
2d80: 74 20 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65  t setting of the
2d90: 0a 20 20 5b 73 65 63 75 72 65 5f 64 65 6c 65 74  .  [secure_delet
2da0: 65 20 70 72 61 67 6d 61 5d 2e 20 20 57 68 65 6e  e pragma].  When
2db0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
2dc0: 6e 6f 74 20 75 73 65 64 2c 20 73 65 63 75 72 65  not used, secure
2dd0: 5f 64 65 6c 65 74 65 20 64 65 66 61 75 6c 74 73  _delete defaults
2de0: 0a 20 20 74 6f 20 6f 66 66 2e 20 20 57 68 65 6e  .  to off.  When
2df0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
2e00: 70 72 65 73 65 6e 74 2c 20 73 65 63 75 72 65 5f  present, secure_
2e10: 64 65 6c 65 74 65 20 64 65 66 61 75 6c 74 73 20  delete defaults 
2e20: 74 6f 20 6f 6e 2e 0a 0a 20 20 54 68 65 20 73 65  to on...  The se
2e30: 63 75 72 65 5f 64 65 6c 65 74 65 20 73 65 74 74  cure_delete sett
2e40: 69 6e 67 20 63 61 75 73 65 73 20 64 65 6c 65 74  ing causes delet
2e50: 65 64 20 63 6f 6e 74 65 6e 74 20 74 6f 20 62 65  ed content to be
2e60: 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 74   overwritten wit
2e70: 68 0a 20 20 7a 65 72 6f 73 2e 20 20 54 68 65 72  h.  zeros.  Ther
2e80: 65 20 69 73 20 61 20 73 6d 61 6c 6c 20 70 65 72  e is a small per
2e90: 66 6f 72 6d 61 6e 63 65 20 70 65 6e 61 6c 74 79  formance penalty
2ea0: 20 66 6f 72 20 74 68 69 73 20 73 69 6e 63 65 20   for this since 
2eb0: 61 64 64 69 74 69 6f 6e 61 6c 20 49 2f 4f 0a 20  additional I/O. 
2ec0: 20 6d 75 73 74 20 6f 63 63 75 72 2e 20 20 4f 6e   must occur.  On
2ed0: 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c   the other hand,
2ee0: 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20 63   secure_delete c
2ef0: 61 6e 20 70 72 65 76 65 6e 74 20 73 65 6e 73 69  an prevent sensi
2f00: 74 69 76 65 20 0a 20 20 69 6e 66 6f 72 6d 61 74  tive .  informat
2f10: 69 6f 6e 20 66 72 6f 6d 20 6c 69 6e 67 65 72 69  ion from lingeri
2f20: 6e 67 20 69 6e 20 75 6e 75 73 65 64 20 70 61 72  ng in unused par
2f30: 74 73 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  ts of the databa
2f40: 73 65 20 66 69 6c 65 20 61 66 74 65 72 20 69 74  se file after it
2f50: 0a 20 20 68 61 73 20 61 6c 6c 65 67 65 64 6c 79  .  has allegedly
2f60: 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2e 20 20   been deleted.  
2f70: 53 65 65 20 74 68 65 20 64 6f 63 75 6d 65 6e 74  See the document
2f80: 61 74 69 6f 6e 20 6f 6e 20 74 68 65 0a 20 20 5b  ation on the.  [
2f90: 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20 70 72  secure_delete pr
2fa0: 61 67 6d 61 5d 20 66 6f 72 20 61 64 64 69 74 69  agma] for additi
2fb0: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
2fc0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
2fd0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 54 48 52 45  ION {SQLITE_THRE
2fe0: 41 44 53 41 46 45 3d 3c 69 3e 26 6c 74 3b 30 20  ADSAFE=<i>&lt;0 
2ff0: 6f 72 20 31 20 6f 72 20 32 26 67 74 3b 3c 2f 69  or 1 or 2&gt;</i
3000: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  >} {.  This opti
3010: 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74  on controls whet
3020: 68 65 72 20 6f 72 20 6e 6f 74 20 63 6f 64 65 20  her or not code 
3030: 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 53  is included in S
3040: 51 4c 69 74 65 20 74 6f 0a 20 20 65 6e 61 62 6c  QLite to.  enabl
3050: 65 20 69 74 20 74 6f 20 6f 70 65 72 61 74 65 20  e it to operate 
3060: 73 61 66 65 6c 79 20 69 6e 20 61 20 6d 75 6c 74  safely in a mult
3070: 69 74 68 72 65 61 64 65 64 20 65 6e 76 69 72 6f  ithreaded enviro
3080: 6e 6d 65 6e 74 2e 20 20 54 68 65 0a 20 20 64 65  nment.  The.  de
3090: 66 61 75 6c 74 20 69 73 20 53 51 4c 49 54 45 5f  fault is SQLITE_
30a0: 54 48 52 45 41 44 53 41 46 45 3d 31 20 77 68 69  THREADSAFE=1 whi
30b0: 63 68 20 69 73 20 73 61 66 65 20 66 6f 72 20 75  ch is safe for u
30c0: 73 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72  se in a multithr
30d0: 65 61 64 65 64 0a 20 20 65 6e 76 69 72 6f 6e 6d  eaded.  environm
30e0: 65 6e 74 2e 20 20 57 68 65 6e 20 63 6f 6d 70 69  ent.  When compi
30f0: 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f  led with SQLITE_
3100: 54 48 52 45 41 44 53 41 46 45 3d 30 20 61 6c 6c  THREADSAFE=0 all
3110: 20 6d 75 74 65 78 69 6e 67 20 63 6f 64 65 0a 20   mutexing code. 
3120: 20 69 73 20 6f 6d 69 74 74 65 64 20 61 6e 64 20   is omitted and 
3130: 69 74 20 69 73 20 75 6e 73 61 66 65 20 74 6f 20  it is unsafe to 
3140: 75 73 65 20 53 51 4c 69 74 65 20 69 6e 20 61 20  use SQLite in a 
3150: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 70 72  multithreaded pr
3160: 6f 67 72 61 6d 2e 0a 20 20 57 68 65 6e 20 63 6f  ogram..  When co
3170: 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49  mpiled with SQLI
3180: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 32 2c  TE_THREADSAFE=2,
3190: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 75   SQLite can be u
31a0: 73 65 64 20 69 6e 20 61 20 6d 75 6c 74 69 74 68  sed in a multith
31b0: 72 65 61 64 65 64 0a 20 20 70 72 6f 67 72 61 6d  readed.  program
31c0: 20 73 6f 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74   so long as no t
31d0: 77 6f 20 74 68 72 65 61 64 73 20 61 74 74 65 6d  wo threads attem
31e0: 70 74 20 74 6f 20 75 73 65 20 74 68 65 20 73 61  pt to use the sa
31f0: 6d 65 0a 20 20 5b 64 61 74 61 62 61 73 65 20 63  me.  [database c
3200: 6f 6e 6e 65 63 74 69 6f 6e 5d 20 28 6f 72 20 61  onnection] (or a
3210: 6e 79 20 5b 70 72 65 70 61 72 65 64 20 73 74 61  ny [prepared sta
3220: 74 65 6d 65 6e 74 73 5d 20 64 65 72 69 76 65 64  tements] derived
3230: 20 66 72 6f 6d 0a 20 20 74 68 61 74 20 64 61 74   from.  that dat
3240: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
3250: 29 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69  ) at the same ti
3260: 6d 65 2e 0a 0a 20 20 54 6f 20 70 75 74 20 69 74  me...  To put it
3270: 20 61 6e 6f 74 68 65 72 20 77 61 79 2c 20 53 51   another way, SQ
3280: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
3290: 31 20 73 65 74 73 20 74 68 65 20 64 65 66 61 75  1 sets the defau
32a0: 6c 74 0a 20 20 5b 74 68 72 65 61 64 69 6e 67 20  lt.  [threading 
32b0: 6d 6f 64 65 5d 20 74 6f 20 53 65 72 69 61 6c 69  mode] to Seriali
32c0: 7a 65 64 2e 20 20 53 51 4c 49 54 45 5f 54 48 52  zed.  SQLITE_THR
32d0: 45 41 44 53 41 46 45 3d 32 20 73 65 74 73 20 74  EADSAFE=2 sets t
32e0: 68 65 20 64 65 66 61 75 6c 74 0a 20 20 5b 74 68  he default.  [th
32f0: 72 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f  reading mode] to
3300: 20 4d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 2e   Multi-threaded.
3310: 20 20 41 6e 64 20 53 51 4c 49 54 45 5f 54 48 52    And SQLITE_THR
3320: 45 41 44 53 41 46 45 3d 30 20 73 65 74 73 20 74  EADSAFE=0 sets t
3330: 68 65 0a 20 20 5b 74 68 72 65 61 64 69 6e 67 20  he.  [threading 
3340: 6d 6f 64 65 5d 20 74 6f 20 53 69 6e 67 6c 65 2d  mode] to Single-
3350: 74 68 72 65 61 64 65 64 2e 0a 0a 20 20 54 68 65  threaded...  The
3360: 20 76 61 6c 75 65 20 6f 66 20 53 51 4c 49 54 45   value of SQLITE
3370: 5f 54 48 52 45 41 44 53 41 46 45 20 63 61 6e 20  _THREADSAFE can 
3380: 62 65 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74  be determined at
3390: 20 72 75 6e 2d 74 69 6d 65 0a 20 20 75 73 69 6e   run-time.  usin
33a0: 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74  g the [sqlite3_t
33b0: 68 72 65 61 64 73 61 66 65 28 29 5d 20 69 6e 74  hreadsafe()] int
33c0: 65 72 66 61 63 65 2e 0a 0a 20 20 57 68 65 6e 20  erface...  When 
33d0: 53 51 4c 69 74 65 20 68 61 73 20 62 65 65 6e 20  SQLite has been 
33e0: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51  compiled with SQ
33f0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
3400: 31 20 6f 72 0a 20 20 53 51 4c 49 54 45 5f 54 48  1 or.  SQLITE_TH
3410: 52 45 41 44 53 41 46 45 3d 32 20 74 68 65 6e 20  READSAFE=2 then 
3420: 74 68 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d  the [threading m
3430: 6f 64 65 5d 0a 20 20 63 61 6e 20 62 65 20 61 6c  ode].  can be al
3440: 74 65 72 65 64 20 61 74 20 72 75 6e 2d 74 69 6d  tered at run-tim
3450: 65 20 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c  e using the [sql
3460: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69  ite3_config()] i
3470: 6e 74 65 72 66 61 63 65 20 74 6f 67 65 74 68 65  nterface togethe
3480: 72 0a 20 20 77 69 74 68 20 6f 6e 65 20 6f 66 20  r.  with one of 
3490: 74 68 65 73 65 20 76 65 72 62 73 3a 0a 0a 20 20  these verbs:..  
34a0: 3c 75 6c 3e 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49  <ul>.  <li>[SQLI
34b0: 54 45 5f 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45  TE_CONFIG_SINGLE
34c0: 54 48 52 45 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53  THREAD].  <li>[S
34d0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c  QLITE_CONFIG_MUL
34e0: 54 49 54 48 52 45 41 44 5d 0a 20 20 3c 6c 69 3e  TITHREAD].  <li>
34f0: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53  [SQLITE_CONFIG_S
3500: 45 52 49 41 4c 49 5a 45 44 5d 0a 20 20 3c 2f 75  ERIALIZED].  </u
3510: 6c 3e 0a 0a 20 20 54 68 65 20 5b 53 51 4c 49 54  l>..  The [SQLIT
3520: 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 5d 20  E_OPEN_NOMUTEX] 
3530: 61 6e 64 0a 20 20 5b 53 51 4c 49 54 45 5f 4f 50  and.  [SQLITE_OP
3540: 45 4e 5f 46 55 4c 4c 4d 55 54 45 58 5d 20 66 6c  EN_FULLMUTEX] fl
3550: 61 67 73 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f  ags to [sqlite3_
3560: 6f 70 65 6e 5f 76 32 28 29 5d 20 63 61 6e 20 61  open_v2()] can a
3570: 6c 73 6f 20 62 65 20 75 73 65 64 0a 20 20 74 6f  lso be used.  to
3580: 20 61 64 6a 75 73 74 20 74 68 65 20 5b 74 68 72   adjust the [thr
3590: 65 61 64 69 6e 67 20 6d 6f 64 65 5d 20 6f 66 20  eading mode] of 
35a0: 69 6e 64 69 76 69 64 75 61 6c 20 5b 64 61 74 61  individual [data
35b0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73  base connections
35c0: 5d 0a 20 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e  ].  at run-time.
35d0: 0a 0a 20 20 4e 6f 74 65 20 74 68 61 74 20 77 68  ..  Note that wh
35e0: 65 6e 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6d  en SQLite is com
35f0: 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54  piled with SQLIT
3600: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 30 2c 20  E_THREADSAFE=0, 
3610: 74 68 65 20 63 6f 64 65 0a 20 20 74 6f 20 6d 61  the code.  to ma
3620: 6b 65 20 53 51 4c 69 74 65 20 74 68 72 65 61 64  ke SQLite thread
3630: 73 61 66 65 20 69 73 20 6f 6d 69 74 74 65 64 20  safe is omitted 
3640: 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 20  from the build. 
3650: 20 57 68 65 6e 20 74 68 69 73 20 6f 63 63 75 72   When this occur
3660: 73 2c 0a 20 20 69 74 20 69 73 20 69 6d 70 6f 73  s,.  it is impos
3670: 73 69 62 6c 65 20 74 6f 20 63 68 61 6e 67 65 20  sible to change 
3680: 74 68 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d  the [threading m
3690: 6f 64 65 5d 20 61 74 20 73 74 61 72 74 2d 74 69  ode] at start-ti
36a0: 6d 65 20 6f 72 20 72 75 6e 2d 74 69 6d 65 2e 0a  me or run-time..
36b0: 0a 20 20 53 65 65 20 74 68 65 20 5b 74 68 72 65  .  See the [thre
36c0: 61 64 69 6e 67 20 6d 6f 64 65 5d 20 64 6f 63 75  ading mode] docu
36d0: 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 64  mentation for ad
36e0: 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
36f0: 74 69 6f 6e 0a 20 20 6f 6e 20 61 73 70 65 63 74  tion.  on aspect
3700: 73 20 6f 66 20 75 73 69 6e 67 20 53 51 4c 69 74  s of using SQLit
3710: 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65  e in a multithre
3720: 61 64 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74  aded environment
3730: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
3740: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 54 45 4d 50  ION {SQLITE_TEMP
3750: 5f 53 54 4f 52 45 3d 3c 69 3e 26 6c 74 3b 30 20  _STORE=<i>&lt;0 
3760: 74 68 72 6f 75 67 68 20 33 26 67 74 3b 3c 2f 69  through 3&gt;</i
3770: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  >} {.  This opti
3780: 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74  on controls whet
3790: 68 65 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69  her temporary fi
37a0: 6c 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 6f  les are stored o
37b0: 6e 20 64 69 73 6b 20 6f 72 0a 20 20 69 6e 20 6d  n disk or.  in m
37c0: 65 6d 6f 72 79 2e 20 20 54 68 65 20 6d 65 61 6e  emory.  The mean
37d0: 69 6e 67 73 20 66 6f 72 20 76 61 72 69 6f 75 73  ings for various
37e0: 20 73 65 74 74 69 6e 67 73 20 6f 66 20 74 68 69   settings of thi
37f0: 73 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20  s compile-time. 
3800: 20 6f 70 74 69 6f 6e 20 61 72 65 20 61 73 20 66   option are as f
3810: 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 3c 74 61 62 6c  ollows:..  <tabl
3820: 65 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 32  e cellpadding="2
3830: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0a 20 20  " border="1">.  
3840: 3c 74 72 3e 3c 74 68 3e 53 51 4c 49 54 45 5f 54  <tr><th>SQLITE_T
3850: 45 4d 50 5f 53 54 4f 52 45 3c 2f 74 68 3e 3c 74  EMP_STORE</th><t
3860: 68 3e 4d 65 61 6e 69 6e 67 3c 2f 74 68 3e 3c 2f  h>Meaning</th></
3870: 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c  tr>.  <tr><td al
3880: 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 30 3c 2f  ign="center">0</
3890: 74 64 3e 3c 74 64 3e 41 6c 77 61 79 73 20 75 73  td><td>Always us
38a0: 65 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65  e temporary file
38b0: 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74  s</td></tr>.  <t
38c0: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e  r><td align="cen
38d0: 74 65 72 22 3e 31 3c 2f 74 64 3e 3c 74 64 3e 55  ter">1</td><td>U
38e0: 73 65 20 66 69 6c 65 73 20 62 79 20 64 65 66 61  se files by defa
38f0: 75 6c 74 20 62 75 74 20 61 6c 6c 6f 77 20 74 68  ult but allow th
3900: 65 0a 20 20 5b 50 52 41 47 4d 41 20 74 65 6d 70  e.  [PRAGMA temp
3910: 5f 73 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e 64 20  _store] command 
3920: 74 6f 20 6f 76 65 72 72 69 64 65 3c 2f 74 64 3e  to override</td>
3930: 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20  </tr>.  <tr><td 
3940: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 32  align="center">2
3950: 3c 2f 74 64 3e 3c 74 64 3e 55 73 65 20 6d 65 6d  </td><td>Use mem
3960: 6f 72 79 20 62 79 20 64 65 66 61 75 6c 74 20 62  ory by default b
3970: 75 74 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20 5b  ut allow the.  [
3980: 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 74 6f 72  PRAGMA temp_stor
3990: 65 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76  e] command to ov
39a0: 65 72 72 69 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e  erride</td></tr>
39b0: 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e  .  <tr><td align
39c0: 3d 22 63 65 6e 74 65 72 22 3e 33 3c 2f 74 64 3e  ="center">3</td>
39d0: 3c 74 64 3e 41 6c 77 61 79 73 20 75 73 65 20 6d  <td>Always use m
39e0: 65 6d 6f 72 79 3c 2f 74 64 3e 3c 2f 74 72 3e 0a  emory</td></tr>.
39f0: 20 20 3c 2f 74 61 62 6c 65 3e 0a 0a 20 20 54 68    </table>..  Th
3a00: 65 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e  e default settin
3a10: 67 20 69 73 20 31 2e 20 20 0a 20 20 41 64 64 69  g is 1.  .  Addi
3a20: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
3a30: 6f 6e 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20  on can be found 
3a40: 69 6e 20 5b 74 65 6d 70 73 74 6f 72 65 20 7c 20  in [tempstore | 
3a50: 74 65 6d 70 66 69 6c 65 73 2e 68 74 6d 6c 5d 2e  tempfiles.html].
3a60: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
3a70: 4f 4e 20 7b 53 51 4c 49 54 45 5f 54 52 41 43 45  ON {SQLITE_TRACE
3a80: 5f 53 49 5a 45 5f 4c 49 4d 49 54 3d 3c 69 3e 4e  _SIZE_LIMIT=<i>N
3a90: 3c 2f 69 3e 7d 20 7b 0a 20 20 49 66 20 74 68 69  </i>} {.  If thi
3aa0: 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  s macro is defin
3ab0: 65 64 20 74 6f 20 61 20 70 6f 73 69 74 69 76 65  ed to a positive
3ac0: 20 69 6e 74 65 67 65 72 20 3c 69 3e 4e 3c 2f 69   integer <i>N</i
3ad0: 3e 2c 20 74 68 65 6e 20 74 68 65 20 6c 65 6e 67  >, then the leng
3ae0: 74 68 20 6f 66 0a 20 20 73 74 72 69 6e 67 73 20  th of.  strings 
3af0: 61 6e 64 20 42 4c 4f 42 20 74 68 61 74 20 61 72  and BLOB that ar
3b00: 65 20 65 78 70 61 6e 64 65 64 20 69 6e 74 6f 20  e expanded into 
3b10: 70 61 72 61 6d 65 74 65 72 73 20 69 6e 20 74 68  parameters in th
3b20: 65 20 6f 75 74 70 75 74 20 6f 66 0a 20 20 5b 73  e output of.  [s
3b30: 71 6c 69 74 65 33 5f 74 72 61 63 65 28 29 5d 20  qlite3_trace()] 
3b40: 69 73 20 6c 69 6d 69 74 65 64 20 74 6f 20 3c 69  is limited to <i
3b50: 3e 4e 3c 2f 69 3e 20 62 79 74 65 73 2e 20 20 0a  >N</i> bytes.  .
3b60: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
3b70: 4e 20 7b 53 51 4c 49 54 45 5f 55 53 45 5f 55 52  N {SQLITE_USE_UR
3b80: 49 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  I} {.  This opti
3b90: 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20 5b 55  on causes the [U
3ba0: 52 49 20 66 69 6c 65 6e 61 6d 65 5d 20 70 72 6f  RI filename] pro
3bb0: 63 65 73 73 20 6c 6f 67 69 63 20 74 6f 20 62 65  cess logic to be
3bc0: 20 65 6e 61 62 6c 65 64 20 62 79 20 0a 20 20 64   enabled by .  d
3bd0: 65 66 61 75 6c 74 2e 20 20 0a 7d 0a 0a 3c 2f 74  efault.  .}..</t
3be0: 63 6c 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 65 6e  cl>..<a name="en
3bf0: 61 62 6c 65 66 65 61 74 75 72 65 73 22 3e 3c 2f  ablefeatures"></
3c00: 61 3e 0a 3c 68 32 3e 31 2e 34 20 4f 70 74 69 6f  a>.<h2>1.4 Optio
3c10: 6e 73 20 54 6f 20 45 6e 61 62 6c 65 20 46 65 61  ns To Enable Fea
3c20: 74 75 72 65 73 20 4e 6f 72 6d 61 6c 6c 79 20 54  tures Normally T
3c30: 75 72 6e 65 64 20 4f 66 66 3c 2f 68 32 3e 0a 0a  urned Off</h2>..
3c40: 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50  <tcl>.COMPILE_OP
3c50: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 41 4c 4c  TION {SQLITE_ALL
3c60: 4f 57 5f 43 4f 56 45 52 49 4e 47 5f 49 4e 44 45  OW_COVERING_INDE
3c70: 58 5f 53 43 41 4e 3d 3c 69 3e 26 6c 74 3b 30 20  X_SCAN=<i>&lt;0 
3c80: 6f 72 20 31 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  or 1&gt;</i>} {.
3c90: 20 20 54 68 69 73 20 43 2d 70 72 65 70 72 6f 63    This C-preproc
3ca0: 65 73 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d  ess macro determ
3cb0: 69 6e 65 73 20 74 68 65 20 64 65 66 61 75 6c 74  ines the default
3cc0: 20 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65 0a   setting of the.
3cd0: 20 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47    [SQLITE_CONFIG
3ce0: 5f 43 4f 56 45 52 49 4e 47 5f 49 4e 44 45 58 5f  _COVERING_INDEX_
3cf0: 53 43 41 4e 5d 20 63 6f 6e 66 69 67 75 72 61 74  SCAN] configurat
3d00: 69 6f 6e 20 73 65 74 74 69 6e 67 2e 20 20 49 74  ion setting.  It
3d10: 20 64 65 66 61 75 6c 74 73 0a 20 20 74 6f 20 31   defaults.  to 1
3d20: 20 28 6f 6e 29 20 77 68 69 63 68 20 6d 65 61 6e   (on) which mean
3d30: 73 20 74 68 61 74 20 63 6f 76 65 72 69 6e 67 20  s that covering 
3d40: 69 6e 64 69 63 65 73 20 61 72 65 20 75 73 65 64  indices are used
3d50: 20 66 6f 72 20 66 75 6c 6c 20 74 61 62 6c 65 0a   for full table.
3d60: 20 20 73 63 61 6e 73 20 77 68 65 72 65 20 70 6f    scans where po
3d70: 73 73 69 62 6c 65 2c 20 69 6e 20 6f 72 64 65 72  ssible, in order
3d80: 20 74 6f 20 72 65 64 75 63 65 20 49 2f 4f 20 61   to reduce I/O a
3d90: 6e 64 20 69 6d 70 72 6f 76 65 20 70 65 72 66 6f  nd improve perfo
3da0: 72 6d 61 6e 63 65 2e 0a 20 20 48 6f 77 65 76 65  rmance..  Howeve
3db0: 72 2c 20 74 68 65 20 75 73 65 20 6f 66 20 61 20  r, the use of a 
3dc0: 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 20 66  covering index f
3dd0: 6f 72 20 61 20 66 75 6c 6c 20 73 63 61 6e 20 77  or a full scan w
3de0: 69 6c 6c 20 63 61 75 73 65 20 72 65 73 75 6c 74  ill cause result
3df0: 73 0a 20 20 74 6f 20 61 70 70 65 61 72 20 69 6e  s.  to appear in
3e00: 20 61 20 64 69 66 66 65 72 65 6e 74 20 6f 72 64   a different ord
3e10: 65 72 20 66 72 6f 6d 20 6c 65 67 61 63 79 2c 20  er from legacy, 
3e20: 77 68 69 63 68 20 63 6f 75 6c 64 20 63 61 75 73  which could caus
3e30: 65 20 73 6f 6d 65 0a 20 20 28 69 6e 63 6f 72 72  e some.  (incorr
3e40: 65 63 74 6c 79 2d 63 6f 64 65 64 29 20 6c 65 67  ectly-coded) leg
3e50: 61 63 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  acy applications
3e60: 20 74 6f 20 62 72 65 61 6b 2e 20 20 48 65 6e 63   to break.  Henc
3e70: 65 2c 20 74 68 65 20 63 6f 76 65 72 69 6e 67 0a  e, the covering.
3e80: 20 20 69 6e 64 65 78 20 73 63 61 6e 20 6f 70 74    index scan opt
3e90: 69 6f 6e 20 63 61 6e 20 62 65 20 64 69 73 61 62  ion can be disab
3ea0: 6c 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74  led at compile-t
3eb0: 69 6d 65 20 6f 6e 20 73 79 73 74 65 6d 73 20 74  ime on systems t
3ec0: 68 61 74 20 77 68 61 74 0a 20 20 74 6f 20 6d 69  hat what.  to mi
3ed0: 6e 69 6d 69 7a 65 20 74 68 65 69 72 20 72 69 73  nimize their ris
3ee0: 6b 20 6f 66 20 65 78 70 6f 73 69 6e 67 20 65 72  k of exposing er
3ef0: 72 6f 72 73 20 69 6e 20 6c 65 67 61 63 79 20 61  rors in legacy a
3f00: 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a  pplications..}..
3f10: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3f20: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 38 5f  SQLITE_ENABLE_8_
3f30: 33 5f 4e 41 4d 45 53 3d 3c 69 3e 26 6c 74 3b 31  3_NAMES=<i>&lt;1
3f40: 20 6f 72 20 32 26 67 74 3b 3c 2f 69 3e 7d 20 7b   or 2&gt;</i>} {
3f50: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
3f60: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
3f70: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e  is defined, then
3f80: 20 65 78 74 72 61 20 63 6f 64 65 20 69 73 0a 20   extra code is. 
3f90: 20 69 6e 63 6c 75 64 65 64 20 74 68 61 74 20 61   included that a
3fa0: 6c 6c 6f 77 73 20 53 51 4c 69 74 65 20 74 6f 20  llows SQLite to 
3fb0: 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 61 20 66 69  function on a fi
3fc0: 6c 65 73 79 73 74 65 6d 20 74 68 61 74 0a 20 20  lesystem that.  
3fd0: 6f 6e 6c 79 20 73 75 70 70 6f 72 74 20 38 2b 33  only support 8+3
3fe0: 20 66 69 6c 65 6e 61 6d 65 73 2e 20 20 49 66 20   filenames.  If 
3ff0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 69  the value of thi
4000: 73 20 6d 61 63 72 6f 20 69 73 20 31 2c 0a 20 20  s macro is 1,.  
4010: 74 68 65 6e 20 74 68 65 20 64 65 66 61 75 6c 74  then the default
4020: 20 62 65 68 61 76 69 6f 72 20 69 73 20 74 6f 20   behavior is to 
4030: 63 6f 6e 74 69 6e 75 65 20 74 6f 20 75 73 65 20  continue to use 
4040: 6c 6f 6e 67 20 66 69 6c 65 6e 61 6d 65 73 20 61  long filenames a
4050: 6e 64 0a 20 20 74 6f 20 6f 6e 6c 79 20 75 73 65  nd.  to only use
4060: 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65 73 20 69   8+3 filenames i
4070: 66 20 74 68 65 20 0a 20 20 64 61 74 61 62 61 73  f the .  databas
4080: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20  e connection is 
4090: 6f 70 65 6e 65 64 20 75 73 69 6e 67 20 5b 55 52  opened using [UR
40a0: 49 20 66 69 6c 65 6e 61 6d 65 73 5d 20 77 69 74  I filenames] wit
40b0: 68 0a 20 20 74 68 65 20 22 3c 74 74 3e 38 5f 33  h.  the "<tt>8_3
40c0: 5f 6e 61 6d 65 73 3d 31 3c 2f 74 74 3e 22 20 71  _names=1</tt>" q
40d0: 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 20  uery parameter. 
40e0: 20 49 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66   If the value of
40f0: 0a 20 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73  .  this macro is
4100: 20 32 2c 20 74 68 65 6e 20 74 68 65 20 75 73 65   2, then the use
4110: 20 6f 66 20 38 2b 33 20 66 69 6c 65 6e 61 6d 65   of 8+3 filename
4120: 73 20 62 65 63 6f 6d 65 73 20 74 68 65 20 64 65  s becomes the de
4130: 66 61 75 6c 74 0a 20 20 62 75 74 20 6d 61 79 20  fault.  but may 
4140: 62 65 20 64 69 73 61 62 6c 65 64 20 6f 6e 20 75  be disabled on u
4150: 73 69 6e 67 20 74 68 65 20 3c 74 74 3e 38 5f 33  sing the <tt>8_3
4160: 5f 6e 61 6d 65 73 3d 30 3c 2f 74 74 3e 20 71 75  _names=0</tt> qu
4170: 65 72 79 20 70 61 72 61 6d 65 74 65 72 2e 0a 20  ery parameter.. 
4180: 20 53 65 65 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45   See .}..COMPILE
4190: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
41a0: 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52  ENABLE_ATOMIC_WR
41b0: 49 54 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73  ITE} {.  If this
41c0: 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20   C-preprocessor 
41d0: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
41e0: 20 61 6e 64 20 69 66 20 74 68 65 0a 20 20 78 44   and if the.  xD
41f0: 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73  eviceCharacteris
4200: 74 69 63 73 20 6d 65 74 68 6f 64 20 6f 66 20 5b  tics method of [
4210: 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f  sqlite3_io_metho
4220: 64 73 5d 20 6f 62 6a 65 63 74 20 66 6f 72 0a 20  ds] object for. 
4230: 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65   a database file
4240: 20 72 65 70 6f 72 74 73 20 28 76 69 61 20 6f 6e   reports (via on
4250: 65 20 6f 66 20 74 68 65 20 5b 53 51 4c 49 54 45  e of the [SQLITE
4260: 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 5d 20 62  _IOCAP_ATOMIC] b
4270: 69 74 73 29 0a 20 20 74 68 61 74 20 74 68 65 20  its).  that the 
4280: 66 69 6c 65 73 79 73 74 65 6d 20 73 75 70 70 6f  filesystem suppo
4290: 72 74 73 20 61 74 6f 6d 69 63 20 77 72 69 74 65  rts atomic write
42a0: 73 20 61 6e 64 20 69 66 20 61 20 74 72 61 6e 73  s and if a trans
42b0: 61 63 74 69 6f 6e 0a 20 20 69 6e 76 6f 6c 76 65  action.  involve
42c0: 73 20 61 20 63 68 61 6e 67 65 20 74 6f 20 6f 6e  s a change to on
42d0: 6c 79 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65  ly a single page
42e0: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65   of the database
42f0: 20 66 69 6c 65 2c 0a 20 20 74 68 65 6e 20 74 68   file,.  then th
4300: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f  e transaction co
4310: 6d 6d 69 74 73 20 77 69 74 68 20 6a 75 73 74 20  mmits with just 
4320: 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65 20 72  a single write r
4330: 65 71 75 65 73 74 20 6f 66 0a 20 20 61 20 73 69  equest of.  a si
4340: 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74 68 65  ngle page of the
4350: 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 6e 6f   database and no
4360: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61   rollback journa
4370: 6c 20 69 73 20 63 72 65 61 74 65 64 0a 20 20 6f  l is created.  o
4380: 72 20 77 72 69 74 74 65 6e 2e 20 20 4f 6e 20 66  r written.  On f
4390: 69 6c 65 73 79 73 74 65 6d 73 20 74 68 61 74 20  ilesystems that 
43a0: 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63 20 77  support atomic w
43b0: 72 69 74 65 73 2c 20 74 68 69 73 0a 20 20 6f 70  rites, this.  op
43c0: 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 20 72  timization can r
43d0: 65 73 75 6c 74 20 69 6e 20 73 69 67 6e 69 66 69  esult in signifi
43e0: 63 61 6e 74 20 73 70 65 65 64 20 69 6d 70 72 6f  cant speed impro
43f0: 76 65 6d 65 6e 74 73 20 66 6f 72 0a 20 20 73 6d  vements for.  sm
4400: 61 6c 6c 20 75 70 64 61 74 65 73 2e 20 20 48 6f  all updates.  Ho
4410: 77 65 76 65 72 2c 20 66 65 77 20 66 69 6c 65 73  wever, few files
4420: 79 73 74 65 6d 73 20 73 75 70 70 6f 72 74 20 74  ystems support t
4430: 68 69 73 20 63 61 70 61 62 69 6c 69 74 79 0a 20  his capability. 
4440: 20 61 6e 64 20 74 68 65 20 63 6f 64 65 20 70 61   and the code pa
4450: 74 68 73 20 74 68 61 74 20 63 68 65 63 6b 20 66  ths that check f
4460: 6f 72 20 74 68 69 73 20 63 61 70 61 62 69 6c 69  or this capabili
4470: 74 79 20 73 6c 6f 77 20 64 6f 77 6e 20 77 72 69  ty slow down wri
4480: 74 65 0a 20 20 70 65 72 66 6f 72 6d 61 6e 63 65  te.  performance
4490: 20 6f 6e 20 73 79 73 74 65 6d 73 20 74 68 61 74   on systems that
44a0: 20 6c 61 63 6b 20 61 74 6f 6d 69 63 20 77 72 69   lack atomic wri
44b0: 74 65 20 63 61 70 61 62 69 6c 69 74 79 2c 20 73  te capability, s
44c0: 6f 20 74 68 69 73 0a 20 20 66 65 61 74 75 72 65  o this.  feature
44d0: 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 20   is disabled by 
44e0: 64 65 66 61 75 6c 74 2e 0a 7d 0a 0a 43 4f 4d 50  default..}..COMP
44f0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
4500: 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e  TE_ENABLE_COLUMN
4510: 5f 4d 45 54 41 44 41 54 41 7d 20 7b 0a 20 20 57  _METADATA} {.  W
4520: 68 65 6e 20 74 68 69 73 20 43 2d 70 72 65 70 72  hen this C-prepr
4530: 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 73  ocessor macro is
4540: 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69 74 65   defined, SQLite
4550: 20 69 6e 63 6c 75 64 65 73 20 73 6f 6d 65 0a 20   includes some. 
4560: 20 61 64 64 69 74 69 6f 6e 61 6c 20 41 50 49 73   additional APIs
4570: 20 74 68 61 74 20 70 72 6f 76 69 64 65 20 63 6f   that provide co
4580: 6e 76 65 6e 69 65 6e 74 20 61 63 63 65 73 73 20  nvenient access 
4590: 74 6f 20 6d 65 74 61 2d 64 61 74 61 20 61 62 6f  to meta-data abo
45a0: 75 74 0a 20 20 74 61 62 6c 65 73 20 61 6e 64 20  ut.  tables and 
45b0: 71 75 65 72 69 65 73 2e 20 20 54 68 65 20 41 50  queries.  The AP
45c0: 49 73 20 74 68 61 74 20 61 72 65 20 65 6e 61 62  Is that are enab
45d0: 6c 65 64 20 62 79 20 74 68 69 73 20 6f 70 74 69  led by this opti
45e0: 6f 6e 20 61 72 65 3a 0a 0a 20 20 3c 75 6c 3e 0a  on are:..  <ul>.
45f0: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
4600: 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f  column_database_
4610: 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20  name()] </li>.  
4620: 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f  <li> [sqlite3_co
4630: 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61  lumn_database_na
4640: 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20  me16()] </li>.  
4650: 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f  <li> [sqlite3_co
4660: 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28  lumn_table_name(
4670: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20  )] </li>.  <li> 
4680: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
4690: 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28 29 5d 20  table_name16()] 
46a0: 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71  </li>.  <li> [sq
46b0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69  lite3_column_ori
46c0: 67 69 6e 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69  gin_name()] </li
46d0: 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65  >.  <li> [sqlite
46e0: 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f  3_column_origin_
46f0: 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a  name16()] </li>.
4700: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
4710: 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74  table_column_met
4720: 61 64 61 74 61 28 29 5d 20 3c 2f 6c 69 3e 0a 20  adata()] </li>. 
4730: 20 3c 2f 75 6c 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c   </ul>.}..COMPIL
4740: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
4750: 5f 45 4e 41 42 4c 45 5f 46 54 53 33 7d 20 7b 0a  _ENABLE_FTS3} {.
4760: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69    When this opti
4770: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e  on is defined in
4780: 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69   the [amalgamati
4790: 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 20 33 0a 20  on], version 3. 
47a0: 20 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74 65 78   of the full-tex
47b0: 74 20 73 65 61 72 63 68 20 65 6e 67 69 6e 65 20  t search engine 
47c0: 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  is added to the 
47d0: 62 75 69 6c 64 20 61 75 74 6f 6d 61 74 69 63 61  build automatica
47e0: 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  lly..}..COMPILE_
47f0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45  OPTION {SQLITE_E
4800: 4e 41 42 4c 45 5f 46 54 53 33 5f 50 41 52 45 4e  NABLE_FTS3_PAREN
4810: 54 48 45 53 49 53 7d 20 7b 0a 20 20 54 68 69 73  THESIS} {.  This
4820: 20 6f 70 74 69 6f 6e 20 6d 6f 64 69 66 69 65 73   option modifies
4830: 20 74 68 65 20 71 75 65 72 79 20 70 61 74 74 65   the query patte
4840: 72 6e 20 70 61 72 73 65 72 20 69 6e 20 46 54 53  rn parser in FTS
4850: 33 20 73 75 63 68 20 74 68 61 74 20 69 74 0a 20  3 such that it. 
4860: 20 73 75 70 70 6f 72 74 73 20 6f 70 65 72 61 74   supports operat
4870: 6f 72 73 20 41 4e 44 20 61 6e 64 20 4e 4f 54 20  ors AND and NOT 
4880: 28 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20  (in addition to 
4890: 74 68 65 20 75 73 75 61 6c 20 4f 52 20 61 6e 64  the usual OR and
48a0: 20 4e 45 41 52 29 0a 20 20 61 6e 64 20 61 6c 73   NEAR).  and als
48b0: 6f 20 61 6c 6c 6f 77 73 20 71 75 65 72 79 20 65  o allows query e
48c0: 78 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 63 6f  xpressions to co
48d0: 6e 74 61 69 6e 20 6e 65 73 74 65 64 20 70 61 72  ntain nested par
48e0: 65 6e 74 68 65 73 69 73 2e 0a 7d 0a 0a 43 4f 4d  enthesis..}..COM
48f0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
4900: 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 7d  ITE_ENABLE_FTS4}
4910: 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f   {.  When this o
4920: 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64  ption is defined
4930: 20 69 6e 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d   in the [amalgam
4940: 61 74 69 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 73  ation], versions
4950: 20 33 20 61 6e 64 20 34 0a 20 20 6f 66 20 74 68   3 and 4.  of th
4960: 65 20 66 75 6c 6c 2d 74 65 78 74 20 73 65 61 72  e full-text sear
4970: 63 68 20 65 6e 67 69 6e 65 20 69 73 20 61 64 64  ch engine is add
4980: 65 64 20 74 6f 20 74 68 65 20 62 75 69 6c 64 20  ed to the build 
4990: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d  automatically..}
49a0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
49b0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
49c0: 49 43 55 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ICU} {.  This op
49d0: 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20  tion causes the 
49e0: 0a 20 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 69  .  [http://www.i
49f0: 63 75 2d 70 72 6f 6a 65 63 74 2e 6f 72 67 2f 20  cu-project.org/ 
4a00: 7c 20 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20  | International 
4a10: 43 6f 6d 70 6f 6e 65 6e 74 73 20 66 6f 72 20 55  Components for U
4a20: 6e 69 63 6f 64 65 5d 0a 20 20 6f 72 20 22 49 43  nicode].  or "IC
4a30: 55 22 20 65 78 74 65 6e 73 69 6f 6e 20 74 6f 20  U" extension to 
4a40: 53 51 4c 69 74 65 20 74 6f 20 62 65 20 61 64 64  SQLite to be add
4a50: 65 64 20 74 6f 20 74 68 65 20 62 75 69 6c 64 2e  ed to the build.
4a60: 20 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50    .}..COMPILE_OP
4a70: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
4a80: 42 4c 45 5f 49 4f 54 52 41 43 45 7d 20 7b 0a 20  BLE_IOTRACE} {. 
4a90: 20 57 68 65 6e 20 62 6f 74 68 20 74 68 65 20 53   When both the S
4aa0: 51 4c 69 74 65 20 63 6f 72 65 20 61 6e 64 20 74  QLite core and t
4ab0: 68 65 20 5b 43 6f 6d 6d 61 6e 64 20 4c 69 6e 65  he [Command Line
4ac0: 20 49 6e 74 65 72 66 61 63 65 5d 20 28 43 4c 49   Interface] (CLI
4ad0: 29 20 61 72 65 20 62 6f 74 68 20 0a 20 20 63 6f  ) are both .  co
4ae0: 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 69 73  mpiled with this
4af0: 20 6f 70 74 69 6f 6e 2c 20 74 68 65 6e 20 74 68   option, then th
4b00: 65 20 43 4c 49 20 70 72 6f 76 69 64 65 73 20 61  e CLI provides a
4b10: 6e 20 65 78 74 72 61 20 63 6f 6d 6d 61 6e 64 0a  n extra command.
4b20: 20 20 6e 61 6d 65 64 20 22 2e 69 6f 74 72 61 63    named ".iotrac
4b30: 65 22 20 74 68 61 74 20 70 72 6f 76 69 64 65 73  e" that provides
4b40: 20 61 20 6c 6f 77 2d 6c 65 76 65 6c 20 6c 6f 67   a low-level log
4b50: 20 6f 66 20 49 2f 4f 20 61 63 74 69 76 69 74 79   of I/O activity
4b60: 2e 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  ..  This option 
4b70: 69 73 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20  is experimental 
4b80: 61 6e 64 20 6d 61 79 20 62 65 20 64 69 73 63 6f  and may be disco
4b90: 6e 74 69 6e 75 65 64 20 69 6e 20 61 20 66 75 74  ntinued in a fut
4ba0: 75 72 65 20 72 65 6c 65 61 73 65 2e 0a 7d 0a 0a  ure release..}..
4bb0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4bc0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4c 4f  SQLITE_ENABLE_LO
4bd0: 43 4b 49 4e 47 5f 53 54 59 4c 45 7d 20 7b 0a 20  CKING_STYLE} {. 
4be0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61   This option ena
4bf0: 62 6c 65 73 20 61 64 64 69 74 69 6f 6e 61 6c 20  bles additional 
4c00: 6c 6f 67 69 63 20 69 6e 20 74 68 65 20 4f 53 20  logic in the OS 
4c10: 69 6e 74 65 72 66 61 63 65 20 6c 61 79 65 72 20  interface layer 
4c20: 66 6f 72 0a 20 20 4d 61 63 20 4f 53 20 58 2e 20  for.  Mac OS X. 
4c30: 54 68 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 6c  The additional l
4c40: 6f 67 69 63 20 61 74 74 65 6d 70 74 73 20 74 6f  ogic attempts to
4c50: 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 74   determine the t
4c60: 79 70 65 20 6f 66 20 74 68 65 0a 20 20 75 6e 64  ype of the.  und
4c70: 65 72 6c 79 69 6e 67 20 66 69 6c 65 73 79 73 74  erlying filesyst
4c80: 65 6d 20 61 6e 64 20 63 68 6f 6f 73 65 20 61 6e  em and choose an
4c90: 64 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6c 6f  d alternative lo
4ca0: 63 6b 69 6e 67 20 73 74 72 61 74 65 67 79 0a 20  cking strategy. 
4cb0: 20 74 68 61 74 20 77 6f 72 6b 73 20 63 6f 72 72   that works corr
4cc0: 65 63 74 6c 79 20 66 6f 72 20 74 68 61 74 20 66  ectly for that f
4cd0: 69 6c 65 73 79 73 74 65 6d 20 74 79 70 65 2e 20  ilesystem type. 
4ce0: 46 69 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 72  Five locking str
4cf0: 61 74 65 67 69 65 73 20 0a 20 20 61 72 65 20 61  ategies .  are a
4d00: 76 61 69 6c 61 62 6c 65 3a 0a 0a 20 20 3c 75 6c  vailable:..  <ul
4d10: 3e 0a 20 20 20 20 3c 6c 69 3e 20 50 4f 53 49 58  >.    <li> POSIX
4d20: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e 20   locking style. 
4d30: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61  This is the defa
4d40: 75 6c 74 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c  ult locking styl
4d50: 65 20 61 6e 64 20 74 68 65 0a 20 20 20 20 20 20  e and the.      
4d60: 20 20 20 73 74 79 6c 65 20 75 73 65 64 20 62 79     style used by
4d70: 20 6f 74 68 65 72 20 28 6e 6f 6e 20 4d 61 63 20   other (non Mac 
4d80: 4f 53 20 58 29 20 55 6e 69 78 65 73 2e 20 4c 6f  OS X) Unixes. Lo
4d90: 63 6b 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64  cks are obtained
4da0: 20 61 6e 64 20 0a 20 20 20 20 20 20 20 20 20 72   and .         r
4db0: 65 6c 65 61 73 65 64 20 75 73 69 6e 67 20 74 68  eleased using th
4dc0: 65 20 66 63 6e 74 6c 28 29 20 73 79 73 74 65 6d  e fcntl() system
4dd0: 20 63 61 6c 6c 2e 0a 0a 20 20 20 20 3c 6c 69 3e   call...    <li>
4de0: 20 41 46 50 20 6c 6f 63 6b 69 6e 67 20 73 74 79   AFP locking sty
4df0: 6c 65 2e 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67  le. This locking
4e00: 20 73 74 79 6c 65 20 69 73 20 75 73 65 64 20 66   style is used f
4e10: 6f 72 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20  or network file 
4e20: 0a 20 20 20 20 20 20 20 20 20 73 79 73 74 65 6d  .         system
4e30: 73 20 74 68 61 74 20 75 73 65 20 74 68 65 20 41  s that use the A
4e40: 46 50 20 28 41 70 70 6c 65 20 46 69 6c 69 6e 67  FP (Apple Filing
4e50: 20 50 72 6f 74 6f 63 6f 6c 29 20 70 72 6f 74 6f   Protocol) proto
4e60: 63 6f 6c 2e 20 4c 6f 63 6b 73 0a 20 20 20 20 20  col. Locks.     
4e70: 20 20 20 20 61 72 65 20 6f 62 74 61 69 6e 65 64      are obtained
4e80: 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20   by calling the 
4e90: 6c 69 62 72 61 72 79 20 66 75 6e 63 74 69 6f 6e  library function
4ea0: 20 5f 41 46 50 46 53 53 65 74 4c 6f 63 6b 28 29   _AFPFSSetLock()
4eb0: 2e 0a 0a 20 20 20 20 3c 6c 69 3e 20 46 6c 6f 63  ...    <li> Floc
4ec0: 6b 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  k locking style.
4ed0: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 66 6f   This is used fo
4ee0: 72 20 66 69 6c 65 2d 73 79 73 74 65 6d 73 20 74  r file-systems t
4ef0: 68 61 74 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20  hat do not.     
4f00: 20 20 20 20 73 75 70 70 6f 72 74 20 50 4f 53 49      support POSI
4f10: 58 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 2e  X locking style.
4f20: 20 4c 6f 63 6b 73 20 61 72 65 20 6f 62 74 61 69   Locks are obtai
4f30: 6e 65 64 20 61 6e 64 20 72 65 6c 65 61 73 65 64  ned and released
4f40: 20 75 73 69 6e 67 0a 20 20 20 20 20 20 20 20 20   using.         
4f50: 74 68 65 20 66 6c 6f 63 6b 28 29 20 73 79 73 74  the flock() syst
4f60: 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20 20 20 3c 6c  em call...    <l
4f70: 69 3e 20 44 6f 74 2d 66 69 6c 65 20 6c 6f 63 6b  i> Dot-file lock
4f80: 69 6e 67 20 73 74 79 6c 65 2e 20 54 68 69 73 20  ing style. This 
4f90: 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 73  locking style is
4fa0: 20 75 73 65 64 20 77 68 65 6e 20 6e 65 69 74 68   used when neith
4fb0: 65 72 0a 20 20 20 20 20 20 20 20 20 66 6c 6f 63  er.         floc
4fc0: 6b 20 6e 6f 72 20 50 4f 53 49 58 20 6c 6f 63 6b  k nor POSIX lock
4fd0: 69 6e 67 20 73 74 79 6c 65 73 20 61 72 65 20 73  ing styles are s
4fe0: 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 65 20  upported by the 
4ff0: 66 69 6c 65 20 73 79 73 74 65 6d 2e 0a 20 20 20  file system..   
5000: 20 20 20 20 20 20 44 61 74 61 62 61 73 65 20 6c        Database l
5010: 6f 63 6b 73 20 61 72 65 20 6f 62 74 61 69 6e 65  ocks are obtaine
5020: 64 20 62 79 20 63 72 65 61 74 69 6e 67 20 61 6e  d by creating an
5030: 64 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 66  d entry in the f
5040: 69 6c 65 2d 73 79 73 74 65 6d 0a 20 20 20 20 20  ile-system.     
5050: 20 20 20 20 61 74 20 61 20 77 65 6c 6c 2d 6b 6e      at a well-kn
5060: 6f 77 6e 20 6c 6f 63 61 74 69 6f 6e 20 72 65 6c  own location rel
5070: 61 74 69 76 65 20 74 6f 20 74 68 65 20 64 61 74  ative to the dat
5080: 61 62 61 73 65 20 66 69 6c 65 20 28 61 20 22 64  abase file (a "d
5090: 6f 74 2d 66 69 6c 65 22 29 0a 20 20 20 20 20 20  ot-file").      
50a0: 20 20 20 61 6e 64 20 72 65 6c 69 6e 71 75 69 73     and relinquis
50b0: 68 65 64 20 62 79 20 64 65 6c 65 74 69 6e 67 20  hed by deleting 
50c0: 74 68 65 20 73 61 6d 65 20 66 69 6c 65 2e 0a 0a  the same file...
50d0: 20 20 20 20 3c 6c 69 3e 20 4e 6f 20 6c 6f 63 6b      <li> No lock
50e0: 69 6e 67 20 73 74 79 6c 65 2e 20 49 66 20 6e 6f  ing style. If no
50f0: 6e 65 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20  ne of the above 
5100: 63 61 6e 20 62 65 20 73 75 70 70 6f 72 74 65 64  can be supported
5110: 2c 20 74 68 69 73 20 0a 20 20 20 20 20 20 20 20  , this .        
5120: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 69   locking style i
5130: 73 20 75 73 65 64 2e 20 4e 6f 20 64 61 74 61 62  s used. No datab
5140: 61 73 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68  ase locking mech
5150: 61 6e 69 73 6d 20 69 73 20 75 73 65 64 2e 20 57  anism is used. W
5160: 68 65 6e 0a 20 20 20 20 20 20 20 20 20 74 68 69  hen.         thi
5170: 73 20 73 79 73 74 65 6d 20 69 73 20 75 73 65 64  s system is used
5180: 20 69 74 20 69 73 20 6e 6f 74 20 73 61 66 65 20   it is not safe 
5190: 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 61 74  for a single dat
51a0: 61 62 61 73 65 20 74 6f 20 62 65 0a 20 20 20 20  abase to be.    
51b0: 20 20 20 20 20 61 63 63 65 73 73 65 64 20 62 79       accessed by
51c0: 20 6d 75 6c 74 69 70 6c 65 20 63 6c 69 65 6e 74   multiple client
51d0: 73 2e 0a 20 20 3c 2f 75 6c 3e 0a 0a 20 20 41 64  s..  </ul>..  Ad
51e0: 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 66 69 76 65  ditionally, five
51f0: 20 65 78 74 72 61 20 5b 56 46 53 5d 20 69 6d 70   extra [VFS] imp
5200: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 61 72 65  lementations are
5210: 20 70 72 6f 76 69 64 65 64 20 61 73 20 77 65 6c   provided as wel
5220: 6c 20 61 73 20 74 68 65 0a 20 20 64 65 66 61 75  l as the.  defau
5230: 6c 74 2e 20 42 79 20 73 70 65 63 69 66 79 69 6e  lt. By specifyin
5240: 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 74  g one of the ext
5250: 72 61 20 56 46 53 20 69 6d 70 6c 65 6d 65 6e 74  ra VFS implement
5260: 61 74 69 6f 6e 73 20 0a 20 20 77 68 65 6e 20 63  ations .  when c
5270: 61 6c 6c 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f  alling [sqlite3_
5280: 6f 70 65 6e 5f 76 32 28 29 5d 2c 20 61 6e 20 61  open_v2()], an a
5290: 70 70 6c 69 63 61 74 69 6f 6e 20 6d 61 79 20 62  pplication may b
52a0: 79 70 61 73 73 20 74 68 65 20 66 69 6c 65 2d 73  ypass the file-s
52b0: 79 73 74 65 6d 0a 20 20 64 65 74 65 63 74 69 6f  ystem.  detectio
52c0: 6e 20 6c 6f 67 69 63 20 61 6e 64 20 65 78 70 6c  n logic and expl
52d0: 69 63 69 74 6c 79 20 73 65 6c 65 63 74 20 6f 6e  icitly select on
52e0: 65 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20 6c  e of the above l
52f0: 6f 63 6b 69 6e 67 20 73 74 79 6c 65 73 2e 20 54  ocking styles. T
5300: 68 65 0a 20 20 66 69 76 65 20 65 78 74 72 61 20  he.  five extra 
5310: 5b 56 46 53 5d 20 69 6d 70 6c 65 6d 65 6e 74 61  [VFS] implementa
5320: 74 69 6f 6e 73 20 61 72 65 20 63 61 6c 6c 65 64  tions are called
5330: 20 22 75 6e 69 78 2d 70 6f 73 69 78 22 2c 20 22   "unix-posix", "
5340: 75 6e 69 78 2d 61 66 70 22 2c 0a 20 20 22 75 6e  unix-afp",.  "un
5350: 69 78 2d 66 6c 6f 63 6b 22 2c 20 22 75 6e 69 78  ix-flock", "unix
5360: 2d 64 6f 74 66 69 6c 65 22 20 61 6e 64 20 22 75  -dotfile" and "u
5370: 6e 69 78 2d 6e 6f 6e 65 22 2e 0a 7d 0a 0a 43 4f  nix-none"..}..CO
5380: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
5390: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
53a0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 7d 20 7b  RY_MANAGEMENT} {
53b0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 61  .  This option a
53c0: 64 64 73 20 65 78 74 72 61 20 6c 6f 67 69 63 20  dds extra logic 
53d0: 74 6f 20 53 51 4c 69 74 65 20 74 68 61 74 20 61  to SQLite that a
53e0: 6c 6c 6f 77 73 20 69 74 20 74 6f 20 72 65 6c 65  llows it to rele
53f0: 61 73 65 20 75 6e 75 73 65 64 0a 20 20 6d 65 6d  ase unused.  mem
5400: 6f 72 79 20 75 70 6f 6e 20 72 65 71 75 65 73 74  ory upon request
5410: 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d  .  This option m
5420: 75 73 74 20 62 65 20 65 6e 61 62 6c 65 64 20 69  ust be enabled i
5430: 6e 20 6f 72 64 65 72 20 66 6f 72 20 74 68 65 0a  n order for the.
5440: 20 20 5b 73 71 6c 69 74 65 33 5f 72 65 6c 65 61    [sqlite3_relea
5450: 73 65 5f 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74  se_memory()] int
5460: 65 72 66 61 63 65 20 74 6f 20 77 6f 72 6b 2e 20  erface to work. 
5470: 20 49 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65   If this compile
5480: 2d 74 69 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 69  -time.  option i
5490: 73 20 6e 6f 74 20 75 73 65 64 2c 20 74 68 65 20  s not used, the 
54a0: 5b 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65  [sqlite3_release
54b0: 5f 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72  _memory()] inter
54c0: 66 61 63 65 20 69 73 20 61 20 0a 20 20 6e 6f 2d  face is a .  no-
54d0: 6f 70 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  op..}..COMPILE_O
54e0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e  PTION {SQLITE_EN
54f0: 41 42 4c 45 5f 4d 45 4d 53 59 53 33 7d 20 7b 0a  ABLE_MEMSYS3} {.
5500: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 6e    This option in
5510: 63 6c 75 64 65 73 20 63 6f 64 65 20 69 6e 20 53  cludes code in S
5520: 51 4c 69 74 65 20 74 68 61 74 20 69 6d 70 6c 65  QLite that imple
5530: 6d 65 6e 74 73 20 61 6e 20 61 6c 74 65 72 6e 61  ments an alterna
5540: 74 69 76 65 0a 20 20 6d 65 6d 6f 72 79 20 61 6c  tive.  memory al
5550: 6c 6f 63 61 74 6f 72 2e 20 20 54 68 69 73 20 61  locator.  This a
5560: 6c 74 65 72 6e 61 74 69 76 65 20 6d 65 6d 6f 72  lternative memor
5570: 79 20 61 6c 6c 6f 63 61 74 6f 72 20 69 73 20 6f  y allocator is o
5580: 6e 6c 79 20 65 6e 67 61 67 65 64 0a 20 20 77 68  nly engaged.  wh
5590: 65 6e 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43  en the [SQLITE_C
55a0: 4f 4e 46 49 47 5f 48 45 41 50 5d 20 6f 70 74 69  ONFIG_HEAP] opti
55b0: 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 63  on to [sqlite3_c
55c0: 6f 6e 66 69 67 28 29 5d 20 69 73 20 75 73 65 64  onfig()] is used
55d0: 20 74 6f 0a 20 20 73 75 70 70 6c 79 20 61 20 6c   to.  supply a l
55e0: 61 72 67 65 20 63 68 75 6e 6b 20 6f 66 20 6d 65  arge chunk of me
55f0: 6d 6f 72 79 20 66 72 6f 6d 20 77 68 69 63 68 20  mory from which 
5600: 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63  all memory alloc
5610: 61 74 69 6f 6e 73 20 61 72 65 0a 20 20 74 61 6b  ations are.  tak
5620: 65 6e 2e 0a 20 20 54 68 65 20 4d 45 4d 53 59 53  en..  The MEMSYS
5630: 33 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  3 memory allocat
5640: 6f 72 20 75 73 65 73 20 61 20 68 79 62 72 69 64  or uses a hybrid
5650: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 6c 67 6f   allocation algo
5660: 72 69 74 68 6d 20 0a 20 20 70 61 74 74 65 72 6e  rithm .  pattern
5670: 65 64 20 61 66 74 65 72 20 64 6c 6d 61 6c 6c 6f  ed after dlmallo
5680: 63 28 29 2e 20 20 20 4f 6e 6c 79 20 6f 6e 65 20  c().   Only one 
5690: 6f 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  of SQLITE_ENABLE
56a0: 5f 4d 45 4d 53 59 53 33 20 61 6e 64 20 0a 20 20  _MEMSYS3 and .  
56b0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
56c0: 4d 53 59 53 35 20 6d 61 79 20 62 65 20 65 6e 61  MSYS5 may be ena
56d0: 62 6c 65 64 20 61 74 20 6f 6e 63 65 2e 0a 7d 0a  bled at once..}.
56e0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
56f0: 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d  {SQLITE_ENABLE_M
5700: 45 4d 53 59 53 35 7d 20 7b 0a 20 20 54 68 69 73  EMSYS5} {.  This
5710: 20 6f 70 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73   option includes
5720: 20 63 6f 64 65 20 69 6e 20 53 51 4c 69 74 65 20   code in SQLite 
5730: 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20  that implements 
5740: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 20  an alternative. 
5750: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f   memory allocato
5760: 72 2e 20 20 54 68 69 73 20 61 6c 74 65 72 6e 61  r.  This alterna
5770: 74 69 76 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  tive memory allo
5780: 63 61 74 6f 72 20 69 73 20 6f 6e 6c 79 20 65 6e  cator is only en
5790: 67 61 67 65 64 0a 20 20 77 68 65 6e 20 74 68 65  gaged.  when the
57a0: 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f   [SQLITE_CONFIG_
57b0: 48 45 41 50 5d 20 6f 70 74 69 6f 6e 20 74 6f 20  HEAP] option to 
57c0: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28  [sqlite3_config(
57d0: 29 5d 20 69 73 20 75 73 65 64 20 74 6f 0a 20 20  )] is used to.  
57e0: 73 75 70 70 6c 79 20 61 20 6c 61 72 67 65 20 63  supply a large c
57f0: 68 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 66  hunk of memory f
5800: 72 6f 6d 20 77 68 69 63 68 20 61 6c 6c 20 6d 65  rom which all me
5810: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73  mory allocations
5820: 20 61 72 65 0a 20 20 74 61 6b 65 6e 2e 0a 20 20   are.  taken..  
5830: 54 68 65 20 4d 45 4d 53 59 53 35 20 6d 6f 64 75  The MEMSYS5 modu
5840: 6c 65 20 72 6f 75 6e 64 73 20 61 6c 6c 20 61 6c  le rounds all al
5850: 6c 6f 63 61 74 69 6f 6e 73 20 75 70 20 74 6f 20  locations up to 
5860: 74 68 65 20 6e 65 78 74 20 70 6f 77 65 72 0a 20  the next power. 
5870: 20 6f 66 20 74 77 6f 20 61 6e 64 20 75 73 65 73   of two and uses
5880: 20 61 20 66 69 72 73 74 2d 66 69 74 2c 20 62 75   a first-fit, bu
5890: 64 64 79 2d 61 6c 6c 6f 63 61 74 6f 72 20 61 6c  ddy-allocator al
58a0: 67 6f 72 69 74 68 6d 0a 20 20 74 68 61 74 20 70  gorithm.  that p
58b0: 72 6f 76 69 64 65 73 20 73 74 72 6f 6e 67 20 67  rovides strong g
58c0: 75 61 72 61 6e 74 65 65 73 20 61 67 61 69 6e 73  uarantees agains
58d0: 74 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20  t fragmentation 
58e0: 61 6e 64 20 62 72 65 61 6b 64 6f 77 6e 0a 20 20  and breakdown.  
58f0: 73 75 62 6a 65 63 74 20 74 6f 20 63 65 72 74 61  subject to certa
5900: 69 6e 20 6f 70 65 72 61 74 69 6e 67 20 63 6f 6e  in operating con
5910: 73 74 72 61 69 6e 74 73 2e 0a 7d 0a 0a 43 4f 4d  straints..}..COM
5920: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
5930: 49 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45  ITE_ENABLE_RTREE
5940: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
5950: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
5960: 74 6f 20 69 6e 63 6c 75 64 65 20 73 75 70 70 6f  to include suppo
5970: 72 74 20 66 6f 72 20 74 68 65 0a 20 20 5b 72 74  rt for the.  [rt
5980: 72 65 65 20 7c 20 52 2a 54 72 65 65 20 69 6e 64  ree | R*Tree ind
5990: 65 78 20 65 78 74 65 6e 73 69 6f 6e 5d 2e 0a 7d  ex extension]..}
59a0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
59b0: 20 7b 53 51 4c 49 54 45 5f 52 54 52 45 45 5f 49   {SQLITE_RTREE_I
59c0: 4e 54 5f 4f 4e 4c 59 7d 20 7b 0a 20 20 49 66 20  NT_ONLY} {.  If 
59d0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75  this option is u
59e0: 73 65 64 20 74 6f 67 65 74 68 65 72 20 77 69 74  sed together wit
59f0: 68 20 5b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  h [SQLITE_ENABLE
5a00: 5f 52 54 52 45 45 5d 20 74 68 65 6e 20 74 68 65  _RTREE] then the
5a10: 0a 20 20 5b 72 74 72 65 65 20 7c 20 52 2a 54 72  .  [rtree | R*Tr
5a20: 65 65 20 65 78 74 65 6e 73 69 6f 6e 5d 20 77 69  ee extension] wi
5a30: 6c 6c 20 6f 6e 6c 79 20 73 74 6f 72 65 20 33 32  ll only store 32
5a40: 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65  -bit signed inte
5a50: 67 65 72 0a 20 20 63 6f 6f 72 64 69 6e 61 74 65  ger.  coordinate
5a60: 73 20 61 6e 64 20 61 6c 6c 20 69 6e 74 65 72 6e  s and all intern
5a70: 61 6c 20 63 6f 6d 70 75 74 61 74 69 6f 6e 73 20  al computations 
5a80: 77 69 6c 6c 20 62 65 20 64 6f 6e 65 20 75 73 69  will be done usi
5a90: 6e 67 20 69 6e 74 65 67 65 72 73 0a 20 20 69 6e  ng integers.  in
5aa0: 73 74 65 61 64 20 6f 66 20 66 6c 6f 61 74 69 6e  stead of floatin
5ab0: 67 20 70 6f 69 6e 74 20 6e 75 6d 62 65 72 73 2e  g point numbers.
5ac0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
5ad0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
5ae0: 45 5f 53 51 4c 4c 4f 47 7d 20 7b 0a 20 20 54 68  E_SQLLOG} {.  Th
5af0: 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65  is option enable
5b00: 73 20 65 78 74 72 61 20 63 6f 64 65 20 28 65 73  s extra code (es
5b10: 70 65 63 69 61 6c 6c 79 20 74 68 65 20 5b 53 51  pecially the [SQ
5b20: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 51 4c 4c  LITE_CONFIG_SQLL
5b30: 4f 47 5d 0a 20 20 6f 70 74 69 6f 6e 20 74 6f 20  OG].  option to 
5b40: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28  [sqlite3_config(
5b50: 29 5d 29 20 74 68 61 74 20 63 61 6e 20 62 65 20  )]) that can be 
5b60: 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 6c  used to create l
5b70: 6f 67 73 20 6f 66 20 61 6c 6c 0a 20 20 53 51 4c  ogs of all.  SQL
5b80: 69 74 65 20 70 72 6f 63 65 73 73 69 6e 67 20 70  ite processing p
5b90: 65 72 66 6f 72 6d 65 64 20 62 79 20 61 6e 20 61  erformed by an a
5ba0: 70 70 6c 69 63 61 74 69 6f 6e 2e 20 20 54 68 65  pplication.  The
5bb0: 73 65 20 6c 6f 67 73 20 63 61 6e 20 62 65 20 75  se logs can be u
5bc0: 73 65 66 75 6c 0a 20 20 69 6e 20 64 6f 69 6e 67  seful.  in doing
5bd0: 20 6f 66 66 2d 6c 69 6e 65 20 61 6e 61 6c 79 73   off-line analys
5be0: 69 73 20 6f 66 20 74 68 65 20 62 65 68 61 76 69  is of the behavi
5bf0: 6f 72 20 6f 66 20 61 6e 20 61 70 70 6c 69 63 61  or of an applica
5c00: 74 69 6f 6e 2c 20 61 6e 64 20 65 73 70 65 63 69  tion, and especi
5c10: 61 6c 6c 79 0a 20 20 66 6f 72 20 70 65 72 66 6f  ally.  for perfo
5c20: 72 6d 61 6e 63 65 20 61 6e 61 6c 79 73 69 73 2e  rmance analysis.
5c30: 20 20 49 6e 20 6f 72 64 65 72 20 66 6f 72 20 74    In order for t
5c40: 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  he SQLITE_ENABLE
5c50: 5f 53 51 4c 4c 4f 47 20 6f 70 74 69 6f 6e 20 74  _SQLLOG option t
5c60: 6f 20 0a 20 20 62 65 20 75 73 65 66 75 6c 2c 20  o .  be useful, 
5c70: 73 6f 6d 65 20 65 78 74 72 61 20 63 6f 64 65 20  some extra code 
5c80: 69 73 20 72 65 71 75 69 72 65 64 2e 20 20 54 68  is required.  Th
5c90: 65 20 0a 20 20 3c 61 20 68 72 65 66 3d 22 68 74  e .  <a href="ht
5ca0: 74 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e  tp://www.sqlite.
5cb0: 6f 72 67 2f 73 72 63 2f 64 6f 63 2f 74 72 75 6e  org/src/doc/trun
5cc0: 6b 2f 73 72 63 2f 74 65 73 74 5f 73 71 6c 6c 6f  k/src/test_sqllo
5cd0: 67 2e 63 22 3e 22 74 65 73 74 5f 73 71 6c 6c 6f  g.c">"test_sqllo
5ce0: 67 2e 63 22 3c 2f 61 3e 0a 20 20 73 6f 75 72 63  g.c"</a>.  sourc
5cf0: 65 20 63 6f 64 65 0a 20 20 66 69 6c 65 20 69 6e  e code.  file in
5d00: 20 74 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72   the SQLite sour
5d10: 63 65 20 74 72 65 65 20 69 73 20 61 20 77 6f 72  ce tree is a wor
5d20: 6b 69 6e 67 20 65 78 61 6d 70 6c 65 20 6f 66 20  king example of 
5d30: 74 68 65 20 72 65 71 75 69 72 65 64 20 65 78 74  the required ext
5d40: 72 61 0a 20 20 63 6f 64 65 2e 20 20 4f 6e 20 75  ra.  code.  On u
5d50: 6e 69 78 20 61 6e 64 20 77 69 6e 64 6f 77 73 20  nix and windows 
5d60: 73 79 73 74 65 6d 73 2c 20 61 20 64 65 76 65 6c  systems, a devel
5d70: 6f 70 65 72 20 63 61 6e 20 61 70 70 65 6e 64 20  oper can append 
5d80: 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 0a  the text of the.
5d90: 20 20 22 74 65 73 74 5f 73 71 6c 6c 6f 67 2e 63    "test_sqllog.c
5da0: 22 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 69  " source code fi
5db0: 6c 65 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66  le to the end of
5dc0: 20 61 6e 20 22 73 71 6c 69 74 65 33 2e 63 22 20   an "sqlite3.c" 
5dd0: 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 2c 0a 20 20  amalgamation,.  
5de0: 72 65 63 6f 6d 70 69 6c 65 20 74 68 65 20 61 70  recompile the ap
5df0: 70 6c 69 63 61 74 69 6f 6e 20 75 73 69 6e 67 20  plication using 
5e00: 74 68 65 20 2d 44 53 51 4c 49 54 45 5f 45 4e 41  the -DSQLITE_ENA
5e10: 42 4c 45 5f 53 51 4c 4c 4f 47 20 6f 70 74 69 6f  BLE_SQLLOG optio
5e20: 6e 2c 20 74 68 65 6e 20 0a 20 20 63 6f 6e 74 72  n, then .  contr
5e30: 6f 6c 20 6c 6f 67 67 69 6e 67 20 75 73 69 6e 67  ol logging using
5e40: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
5e50: 69 61 62 6c 65 73 2e 20 20 53 65 65 20 74 68 65  iables.  See the
5e60: 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74 20   header comment 
5e70: 6f 6e 20 0a 20 20 74 68 65 20 22 74 65 73 74 5f  on .  the "test_
5e80: 73 71 6c 6c 6f 67 2e 63 22 20 73 6f 75 72 63 65  sqllog.c" source
5e90: 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69   file for additi
5ea0: 6f 6e 61 6c 20 64 65 74 61 69 6c 2e 20 20 0a 7d  onal detail.  .}
5eb0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
5ec0: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
5ed0: 53 54 41 54 32 7d 20 7b 0a 20 20 54 68 69 73 20  STAT2} {.  This 
5ee0: 6f 70 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 63  option used to c
5ef0: 61 75 73 65 20 74 68 65 20 5b 41 4e 41 4c 59 5a  ause the [ANALYZ
5f00: 45 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 6f  E] command to co
5f10: 6c 6c 65 63 74 0a 20 20 69 6e 64 65 78 20 68 69  llect.  index hi
5f20: 73 74 6f 67 72 61 6d 20 64 61 74 61 20 69 6e 20  stogram data in 
5f30: 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 73 74  the <b>sqlite_st
5f40: 61 74 32 3c 2f 62 3e 20 74 61 62 6c 65 2e 20 20  at2</b> table.  
5f50: 42 75 74 20 74 68 61 74 0a 20 20 66 75 6e 63 74  But that.  funct
5f60: 69 6f 6e 61 6c 69 74 79 20 77 61 73 20 73 75 70  ionality was sup
5f70: 65 72 63 65 64 65 64 20 62 79 20 5b 53 51 4c 49  erceded by [SQLI
5f80: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5d  TE_ENABLE_STAT3]
5f90: 20 61 73 20 6f 66 0a 20 20 53 51 4c 69 74 65 20   as of.  SQLite 
5fa0: 76 65 72 73 69 6f 6e 20 33 2e 37 2e 39 2e 20 20  version 3.7.9.  
5fb0: 54 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  The SQLITE_ENABL
5fc0: 45 5f 53 54 41 54 32 20 63 6f 6d 70 69 6c 65 2d  E_STAT2 compile-
5fd0: 74 69 6d 65 20 6f 70 74 69 6f 6e 0a 20 20 69 73  time option.  is
5fe0: 20 6e 6f 77 20 61 20 6e 6f 2d 6f 70 2e 0a 7d 0a   now a no-op..}.
5ff0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6000: 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53  {SQLITE_ENABLE_S
6010: 54 41 54 33 7d 20 7b 0a 20 20 54 68 69 73 20 6f  TAT3} {.  This o
6020: 70 74 69 6f 6e 20 61 64 64 73 20 61 64 64 69 74  ption adds addit
6030: 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 74 6f 20 74  ional logic to t
6040: 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d  he [ANALYZE] com
6050: 6d 61 6e 64 20 61 6e 64 20 74 6f 0a 20 20 74 68  mand and to.  th
6060: 65 20 5b 71 75 65 72 79 20 70 6c 61 6e 6e 65 72  e [query planner
6070: 5d 20 74 68 61 74 20 63 61 6e 20 68 65 6c 70 20  ] that can help 
6080: 53 51 4c 69 74 65 20 74 6f 20 63 68 6f 73 65 20  SQLite to chose 
6090: 61 20 62 65 74 74 65 72 20 71 75 65 72 79 20 70  a better query p
60a0: 6c 61 6e 0a 20 20 75 6e 64 65 72 20 63 65 72 74  lan.  under cert
60b0: 61 69 6e 20 73 69 74 75 61 74 69 6f 6e 73 2e 20  ain situations. 
60c0: 20 54 68 65 20 5b 41 4e 41 4c 59 5a 45 5d 20 63   The [ANALYZE] c
60d0: 6f 6d 6d 61 6e 64 20 69 73 20 65 6e 68 61 6e 63  ommand is enhanc
60e0: 65 64 20 74 6f 20 63 6f 6c 6c 65 63 74 0a 20 20  ed to collect.  
60f0: 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 66  histogram data f
6100: 72 6f 6d 20 65 61 63 68 20 69 6e 64 65 78 20 61  rom each index a
6110: 6e 64 20 73 74 6f 72 65 20 74 68 61 74 20 64 61  nd store that da
6120: 74 61 0a 20 20 69 6e 20 74 68 65 20 3c 62 3e 73  ta.  in the <b>s
6130: 71 6c 69 74 65 5f 73 74 61 74 33 3c 2f 62 3e 20  qlite_stat3</b> 
6140: 74 61 62 6c 65 2e 20 20 54 68 65 20 71 75 65 72  table.  The quer
6150: 79 20 70 6c 61 6e 6e 65 72 20 77 69 6c 6c 20 74  y planner will t
6160: 68 65 6e 20 75 73 65 20 74 68 65 0a 20 20 68 69  hen use the.  hi
6170: 73 74 6f 67 72 61 6d 20 64 61 74 61 20 74 6f 20  stogram data to 
6180: 68 65 6c 70 20 69 74 20 6d 61 6b 65 20 62 65 74  help it make bet
6190: 74 65 72 20 69 6e 64 65 78 20 63 68 6f 69 63 65  ter index choice
61a0: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
61b0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
61c0: 42 4c 45 5f 54 52 45 45 5f 45 58 50 4c 41 49 4e  BLE_TREE_EXPLAIN
61d0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
61e0: 6e 20 61 64 64 73 20 73 75 70 70 6f 72 74 20 66  n adds support f
61f0: 6f 72 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 54  or the [SQLITE_T
6200: 45 53 54 43 54 52 4c 5f 45 58 50 4c 41 49 4e 5f  ESTCTRL_EXPLAIN_
6210: 53 54 4d 54 5d 20 74 65 73 74 2d 63 6f 6e 74 72  STMT] test-contr
6220: 6f 6c 0a 20 20 69 6e 20 74 68 65 20 53 51 4c 69  ol.  in the SQLi
6230: 74 65 20 63 6f 72 65 2e 20 20 57 68 65 6e 20 74  te core.  When t
6240: 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65  he [command-line
6250: 20 73 68 65 6c 6c 5d 20 69 73 20 61 6c 73 6f 20   shell] is also 
6260: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 0a 20 20  compiled with.  
6270: 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 74 68 65  this option, the
6280: 20 22 2e 65 78 70 6c 61 69 6e 22 20 64 6f 74 2d   ".explain" dot-
6290: 63 6f 6d 6d 61 6e 64 20 65 6e 61 62 6c 65 73 20  command enables 
62a0: 61 20 6d 6f 64 65 20 74 68 61 74 20 75 73 65 73  a mode that uses
62b0: 20 74 68 65 0a 20 20 5b 53 51 4c 49 54 45 5f 54   the.  [SQLITE_T
62c0: 45 53 54 43 54 52 4c 5f 45 58 50 4c 41 49 4e 5f  ESTCTRL_EXPLAIN_
62d0: 53 54 4d 54 5d 20 69 6e 74 65 72 66 61 63 65 20  STMT] interface 
62e0: 74 6f 20 64 69 73 70 6c 61 79 20 61 6e 20 41 53  to display an AS
62f0: 43 49 49 2d 61 72 74 20 64 69 61 67 72 61 6d 0a  CII-art diagram.
6300: 20 20 6f 66 20 74 68 65 20 70 61 72 73 65 20 74    of the parse t
6310: 72 65 65 20 66 6f 72 20 65 61 63 68 20 53 51 4c  ree for each SQL
6320: 20 71 75 65 72 79 20 73 74 61 74 65 6d 65 6e 74   query statement
6330: 20 74 68 61 74 20 69 73 20 72 75 6e 20 69 6e 20   that is run in 
6340: 74 68 65 20 73 68 65 6c 6c 2e 0a 20 20 54 68 69  the shell..  Thi
6350: 73 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 20 75  s mechanism is u
6360: 73 65 66 75 6c 20 66 6f 72 20 64 65 62 75 67 67  seful for debugg
6370: 69 6e 67 20 74 68 65 20 53 51 4c 69 74 65 20 70  ing the SQLite p
6380: 61 72 73 65 72 20 61 6e 64 20 63 6f 64 65 0a 20  arser and code. 
6390: 20 67 65 6e 65 72 61 74 6f 72 2e 20 20 54 68 69   generator.  Thi
63a0: 73 20 77 68 6f 6c 65 20 6d 65 63 68 61 6e 69 73  s whole mechanis
63b0: 6d 20 69 73 20 68 69 67 68 6c 79 20 65 78 70 65  m is highly expe
63c0: 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20 63 6f 75  rimental and cou
63d0: 6c 64 20 63 68 61 6e 67 65 0a 20 20 64 72 61 73  ld change.  dras
63e0: 74 69 63 61 6c 6c 79 20 6f 72 20 62 65 20 65 6c  tically or be el
63f0: 69 6d 69 6e 61 74 65 64 20 69 6e 20 66 75 74 75  iminated in futu
6400: 72 65 20 72 65 6c 65 61 73 65 73 20 6f 66 20 53  re releases of S
6410: 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  QLite..}..COMPIL
6420: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
6430: 5f 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f 44  _ENABLE_UPDATE_D
6440: 45 4c 45 54 45 5f 4c 49 4d 49 54 7d 20 7b 0a 20  ELETE_LIMIT} {. 
6450: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61   This option ena
6460: 62 6c 65 73 20 61 6e 20 6f 70 74 69 6f 6e 61 6c  bles an optional
6470: 20 4f 52 44 45 52 20 42 59 20 61 6e 64 20 4c 49   ORDER BY and LI
6480: 4d 49 54 20 63 6c 61 75 73 65 20 6f 6e 20 0a 20  MIT clause on . 
6490: 20 5b 55 50 44 41 54 45 5d 20 61 6e 64 20 5b 44   [UPDATE] and [D
64a0: 45 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e 74  ELETE] statement
64b0: 73 2e 0a 0a 20 20 3c 70 3e 49 66 20 74 68 69 73  s...  <p>If this
64c0: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
64d0: 65 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74  ed, then it must
64e0: 20 61 6c 73 6f 20 62 65 20 0a 20 20 64 65 66 69   also be .  defi
64f0: 6e 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20 74  ned when using t
6500: 68 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20  he 'lemon' tool 
6510: 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20 70 61  to generate a pa
6520: 72 73 65 2e 63 0a 20 20 66 69 6c 65 2e 20 42 65  rse.c.  file. Be
6530: 63 61 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74  cause of this, t
6540: 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 6f  his option may o
6550: 6e 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 6e  nly be used when
6560: 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20   the library is 
6570: 62 75 69 6c 74 0a 20 20 66 72 6f 6d 20 73 6f 75  built.  from sou
6580: 72 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68  rce, not from th
6590: 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d  e [amalgamation]
65a0: 20 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c   or from the col
65b0: 6c 65 63 74 69 6f 6e 20 6f 66 0a 20 20 70 72 65  lection of.  pre
65c0: 2d 70 61 63 6b 61 67 65 64 20 43 20 66 69 6c 65  -packaged C file
65d0: 73 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 6e  s provided for n
65e0: 6f 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70 6c 61  on-Unix like pla
65f0: 74 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20 77 65  tforms on the we
6600: 62 73 69 74 65 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a  bsite..  </p>.}.
6610: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6620: 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55  {SQLITE_ENABLE_U
6630: 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 7d 20 7b 0a  NLOCK_NOTIFY} {.
6640: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e    This option en
6650: 61 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74  ables the [sqlit
6660: 65 33 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79  e3_unlock_notify
6670: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 61 6e  ()] interface an
6680: 64 0a 20 20 69 74 73 20 61 73 73 6f 63 69 61 74  d.  its associat
6690: 65 64 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  ed functionality
66a0: 2e 20 20 53 65 65 20 74 68 65 20 64 6f 63 75 6d  .  See the docum
66b0: 65 6e 74 61 74 69 6f 6e 20 74 69 74 6c 65 64 0a  entation titled.
66c0: 20 20 5b 55 73 69 6e 67 20 74 68 65 20 53 51 4c    [Using the SQL
66d0: 69 74 65 20 55 6e 6c 6f 63 6b 20 4e 6f 74 69 66  ite Unlock Notif
66e0: 69 63 61 74 69 6f 6e 20 46 65 61 74 75 72 65 5d  ication Feature]
66f0: 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 0a   for additional.
6700: 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d    information..}
6710: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
6720: 20 7b 53 51 4c 49 54 45 5f 53 4f 55 4e 44 45 58   {SQLITE_SOUNDEX
6730: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
6740: 6e 20 65 6e 61 62 6c 65 73 20 74 68 65 20 5b 73  n enables the [s
6750: 6f 75 6e 64 65 78 28 29 20 53 51 4c 20 66 75 6e  oundex() SQL fun
6760: 63 74 69 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49  ction]..}..COMPI
6770: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 59 59 54 52 41  LE_OPTION {YYTRA
6780: 43 4b 4d 41 58 53 54 41 43 4b 44 45 50 54 48 7d  CKMAXSTACKDEPTH}
6790: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
67a0: 20 63 61 75 73 65 73 20 74 68 65 20 4c 41 4c 52   causes the LALR
67b0: 28 31 29 20 70 61 72 73 65 72 20 73 74 61 63 6b  (1) parser stack
67c0: 20 64 65 70 74 68 20 74 6f 20 62 65 20 74 72 61   depth to be tra
67d0: 63 6b 65 64 0a 20 20 61 6e 64 20 72 65 70 6f 72  cked.  and repor
67e0: 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 5b 73  ted using the [s
67f0: 71 6c 69 74 65 33 5f 73 74 61 74 75 73 5d 28 5b  qlite3_status]([
6800: 53 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41  SQLITE_STATUS_PA
6810: 52 53 45 52 5f 53 54 41 43 4b 5d 2c 2e 2e 2e 29  RSER_STACK],...)
6820: 0a 20 20 69 6e 74 65 72 66 61 63 65 2e 20 20 53  .  interface.  S
6830: 51 4c 69 74 65 27 73 20 4c 41 4c 52 28 31 29 20  QLite's LALR(1) 
6840: 70 61 72 73 65 72 20 68 61 73 20 61 20 66 69 78  parser has a fix
6850: 65 64 20 73 74 61 63 6b 20 64 65 70 74 68 0a 20  ed stack depth. 
6860: 20 28 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20   (determined at 
6870: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 75 73 69  compile-time usi
6880: 6e 67 20 74 68 65 20 5b 59 59 53 54 41 43 4b 44  ng the [YYSTACKD
6890: 45 50 54 48 5d 20 6f 70 74 69 6f 6e 73 29 2e 0a  EPTH] options)..
68a0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
68b0: 6e 20 62 65 20 75 73 65 64 20 74 6f 20 68 65 6c  n be used to hel
68c0: 70 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61  p determine if a
68d0: 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73  n application is
68e0: 0a 20 20 67 65 74 74 69 6e 67 20 63 6c 6f 73 65  .  getting close
68f0: 20 74 6f 20 65 78 63 65 65 64 69 6e 67 20 74 68   to exceeding th
6900: 65 20 6d 61 78 69 6d 75 6d 20 4c 41 4c 52 28 31  e maximum LALR(1
6910: 29 20 73 74 61 63 6b 20 64 65 70 74 68 2e 0a 7d  ) stack depth..}
6920: 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d 65  .</tcl>..<a name
6930: 3d 22 64 69 73 61 62 6c 65 66 65 61 74 75 72 65  ="disablefeature
6940: 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 35 20  s"></a>.<h2>1.5 
6950: 4f 70 74 69 6f 6e 73 20 54 6f 20 44 69 73 61 62  Options To Disab
6960: 6c 65 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d  le Features Norm
6970: 61 6c 6c 79 20 54 75 72 6e 65 64 20 4f 6e 3c 2f  ally Turned On</
6980: 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49  h2>..<tcl>.COMPI
6990: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
69a0: 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 7d 20 7b  E_DISABLE_LFS} {
69b0: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
69c0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
69d0: 69 73 20 64 65 66 69 6e 65 64 2c 20 6c 61 72 67  is defined, larg
69e0: 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 0a 20  e file support. 
69f0: 20 69 73 20 64 69 73 61 62 6c 65 64 2e 0a 7d 0a   is disabled..}.
6a00: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6a10: 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f  {SQLITE_DISABLE_
6a20: 44 49 52 53 59 4e 43 7d 20 7b 0a 20 20 49 66 20  DIRSYNC} {.  If 
6a30: 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73  this C-preproces
6a40: 73 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66  sor macro is def
6a50: 69 6e 65 64 2c 20 64 69 72 65 63 74 6f 72 79 20  ined, directory 
6a60: 73 79 6e 63 73 0a 20 20 61 72 65 20 64 69 73 61  syncs.  are disa
6a70: 62 6c 65 64 2e 20 20 53 51 4c 69 74 65 20 74 79  bled.  SQLite ty
6a80: 70 69 63 61 6c 6c 79 20 61 74 74 65 6d 70 74 73  pically attempts
6a90: 20 74 6f 20 73 79 6e 63 20 74 68 65 20 70 61 72   to sync the par
6aa0: 65 6e 74 0a 20 20 64 69 72 65 63 74 6f 72 79 20  ent.  directory 
6ab0: 77 68 65 6e 20 61 20 66 69 6c 65 20 69 73 20 64  when a file is d
6ac0: 65 6c 65 74 65 64 20 74 6f 20 65 6e 73 75 72 65  eleted to ensure
6ad0: 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a 20   the directory. 
6ae0: 20 65 6e 74 72 69 65 73 20 61 72 65 20 75 70 64   entries are upd
6af0: 61 74 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79  ated immediately
6b00: 20 6f 6e 20 64 69 73 6b 2e 0a 7d 0a 0a 43 4f 4d   on disk..}..COM
6b10: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
6b20: 49 54 45 5f 44 49 53 41 42 4c 45 5f 46 54 53 33  ITE_DISABLE_FTS3
6b30: 5f 55 4e 49 43 4f 44 45 7d 20 7b 0a 20 20 49 66  _UNICODE} {.  If
6b40: 20 74 68 69 73 20 43 2d 70 72 65 70 72 6f 63 65   this C-preproce
6b50: 73 73 6f 72 20 6d 61 63 72 6f 20 69 73 20 64 65  ssor macro is de
6b60: 66 69 6e 65 64 2c 20 74 68 65 20 5b 75 6e 69 63  fined, the [unic
6b70: 6f 64 65 36 31 5d 20 74 6f 6b 65 6e 69 7a 65 72  ode61] tokenizer
6b80: 0a 20 20 69 6e 20 5b 46 54 53 33 5d 20 69 73 20  .  in [FTS3] is 
6b90: 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65  omitted from the
6ba0: 20 62 75 69 6c 64 20 61 6e 64 20 69 73 20 75 6e   build and is un
6bb0: 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 0a 20 20  available to .  
6bc0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a  applications..}.
6bd0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
6be0: 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f  {SQLITE_DISABLE_
6bf0: 46 54 53 34 5f 44 45 46 45 52 52 45 44 7d 20 7b  FTS4_DEFERRED} {
6c00: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
6c10: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
6c20: 64 69 73 61 62 6c 65 73 20 74 68 65 20 22 64 65  disables the "de
6c30: 66 65 72 72 65 64 20 74 6f 6b 65 6e 22 20 6f 70  ferred token" op
6c40: 74 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 69 6e 20  timization.  in 
6c50: 5b 46 54 53 34 5d 2e 20 20 54 68 65 20 22 64 65  [FTS4].  The "de
6c60: 66 65 72 72 65 64 20 74 6f 6b 65 6e 22 20 6f 70  ferred token" op
6c70: 74 69 6d 69 7a 61 74 69 6f 6e 20 61 76 6f 69 64  timization avoid
6c80: 73 20 6c 6f 61 64 69 6e 67 20 6d 61 73 73 69 76  s loading massiv
6c90: 65 0a 20 20 70 6f 73 74 69 6e 67 20 6c 69 73 74  e.  posting list
6ca0: 73 20 66 6f 72 20 74 65 72 6d 73 20 74 68 61 74  s for terms that
6cb0: 20 61 72 65 20 69 6e 20 6d 6f 73 74 20 64 6f 63   are in most doc
6cc0: 75 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 63 6f  uments of the co
6cd0: 6c 6c 65 63 74 69 6f 6e 0a 20 20 61 6e 64 20 69  llection.  and i
6ce0: 6e 73 74 65 61 64 20 73 69 6d 70 6c 79 20 73 63  nstead simply sc
6cf0: 61 6e 73 20 66 6f 72 20 74 68 6f 73 65 20 74 6f  ans for those to
6d00: 6b 65 6e 73 20 69 6e 20 74 68 65 20 64 6f 63 75  kens in the docu
6d10: 6d 65 6e 74 20 73 6f 75 72 63 65 2e 20 20 5b 46  ment source.  [F
6d20: 54 53 34 5d 0a 20 20 73 68 6f 75 6c 64 20 67 65  TS4].  should ge
6d30: 74 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 61  t exactly the sa
6d40: 6d 65 20 61 6e 73 77 65 72 20 62 6f 74 68 20 77  me answer both w
6d50: 69 74 68 20 61 6e 64 20 77 69 74 68 6f 75 74 20  ith and without 
6d60: 74 68 69 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f  this optimizatio
6d70: 6e 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 74 63  n..}.</tcl>..<tc
6d80: 6c 3e 0a 20 20 68 64 5f 66 72 61 67 6d 65 6e 74  l>.  hd_fragment
6d90: 20 22 6f 6d 69 74 66 65 61 74 75 72 65 73 22 0a   "omitfeatures".
6da0: 20 20 68 64 5f 6b 65 79 77 6f 72 64 73 20 22 6f    hd_keywords "o
6db0: 6d 69 74 66 65 61 74 75 72 65 73 22 0a 3c 2f 74  mitfeatures".</t
6dc0: 63 6c 3e 0a 3c 68 32 3e 31 2e 36 20 4f 70 74 69  cl>.<h2>1.6 Opti
6dd0: 6f 6e 73 20 54 6f 20 4f 6d 69 74 20 46 65 61 74  ons To Omit Feat
6de0: 75 72 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68  ures</h2>..<p>Th
6df0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69  e following opti
6e00: 6f 6e 73 20 63 61 6e 20 62 65 20 75 73 65 64 20  ons can be used 
6e10: 74 6f 20 0a 5b 72 65 6c 66 6f 6f 74 70 72 69 6e  to .[relfootprin
6e20: 74 20 7c 20 72 65 64 75 63 65 20 74 68 65 20 73  t | reduce the s
6e30: 69 7a 65 20 6f 66 20 74 68 65 20 63 6f 6d 70 69  ize of the compi
6e40: 6c 65 64 20 6c 69 62 72 61 72 79 5d 0a 62 79 20  led library].by 
6e50: 6f 6d 69 74 74 69 6e 67 20 75 6e 75 73 65 64 20  omitting unused 
6e60: 66 65 61 74 75 72 65 73 2e 20 54 68 69 73 20 69  features. This i
6e70: 73 20 70 72 6f 62 61 62 6c 79 20 6f 6e 6c 79 20  s probably only 
6e80: 75 73 65 66 75 6c 0a 69 6e 20 65 6d 62 65 64 64  useful.in embedd
6e90: 65 64 20 73 79 73 74 65 6d 73 20 77 68 65 72 65  ed systems where
6ea0: 20 73 70 61 63 65 20 69 73 20 65 73 70 65 63 69   space is especi
6eb0: 61 6c 6c 79 20 74 69 67 68 74 2c 20 61 73 20 65  ally tight, as e
6ec0: 76 65 6e 20 77 69 74 68 20 61 6c 6c 0a 66 65 61  ven with all.fea
6ed0: 74 75 72 65 73 20 69 6e 63 6c 75 64 65 64 20 74  tures included t
6ee0: 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72  he SQLite librar
6ef0: 79 20 69 73 20 72 65 6c 61 74 69 76 65 6c 79 20  y is relatively 
6f00: 73 6d 61 6c 6c 2e 20 44 6f 6e 27 74 20 66 6f 72  small. Don't for
6f10: 67 65 74 0a 74 6f 20 74 65 6c 6c 20 79 6f 75 72  get.to tell your
6f20: 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 6f 70 74   compiler to opt
6f30: 69 6d 69 7a 65 20 66 6f 72 20 62 69 6e 61 72 79  imize for binary
6f40: 20 73 69 7a 65 21 20 28 74 68 65 20 2d 4f 73 20   size! (the -Os 
6f50: 6f 70 74 69 6f 6e 20 69 66 0a 75 73 69 6e 67 20  option if.using 
6f60: 47 43 43 29 2e 20 20 54 65 6c 6c 69 6e 67 20 79  GCC).  Telling y
6f70: 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20  our compiler to 
6f80: 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20 73 69 7a  optimize for siz
6f90: 65 20 75 73 75 61 6c 6c 79 20 68 61 73 0a 61 20  e usually has.a 
6fa0: 6d 75 63 68 20 6c 61 72 67 65 72 20 69 6d 70 61  much larger impa
6fb0: 63 74 20 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f  ct on library fo
6fc0: 6f 74 70 72 69 6e 74 20 74 68 61 6e 20 65 6d 70  otprint than emp
6fd0: 6c 6f 79 69 6e 67 20 61 6e 79 20 6f 66 20 74 68  loying any of th
6fe0: 65 73 65 0a 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  ese.compile-time
6ff0: 20 6f 70 74 69 6f 6e 73 2e 20 20 59 6f 75 20 73   options.  You s
7000: 68 6f 75 6c 64 20 61 6c 73 6f 20 76 65 72 69 66  hould also verif
7010: 79 20 74 68 61 74 20 0a 3c 61 20 68 72 65 66 3d  y that .<a href=
7020: 22 23 64 65 62 75 67 6f 70 74 69 6f 6e 73 22 3e  "#debugoptions">
7030: 64 65 62 75 67 67 69 6e 67 20 6f 70 74 69 6f 6e  debugging option
7040: 73 3c 2f 61 3e 20 61 72 65 20 64 69 73 61 62 6c  s</a> are disabl
7050: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  ed.</p>..<p>The 
7060: 6d 61 63 72 6f 73 20 69 6e 20 74 68 69 73 20 73  macros in this s
7070: 65 63 74 69 6f 6e 20 64 6f 20 6e 6f 74 20 72 65  ection do not re
7080: 71 75 69 72 65 20 76 61 6c 75 65 73 2e 20 54 68  quire values. Th
7090: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 63 6f 6d  e following .com
70a0: 70 69 6c 61 74 69 6f 6e 20 73 77 69 74 63 68 65  pilation switche
70b0: 73 20 61 6c 6c 20 68 61 76 65 20 74 68 65 20 73  s all have the s
70c0: 61 6d 65 20 65 66 66 65 63 74 3a 3c 62 72 3e 0a  ame effect:<br>.
70d0: 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c  -DSQLITE_OMIT_AL
70e0: 54 45 52 54 41 42 4c 45 3c 62 72 3e 0a 2d 44 53  TERTABLE<br>.-DS
70f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52  QLITE_OMIT_ALTER
7100: 54 41 42 4c 45 3d 31 3c 62 72 3e 0a 2d 44 53 51  TABLE=1<br>.-DSQ
7110: 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54  LITE_OMIT_ALTERT
7120: 41 42 4c 45 3d 30 0a 3c 2f 70 3e 0a 0a 3c 70 3e  ABLE=0.</p>..<p>
7130: 49 66 20 61 6e 79 20 6f 66 20 74 68 65 73 65 20  If any of these 
7140: 6f 70 74 69 6f 6e 73 20 61 72 65 20 64 65 66 69  options are defi
7150: 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 20 73 61  ned, then the sa
7160: 6d 65 20 73 65 74 20 6f 66 20 53 51 4c 49 54 45  me set of SQLITE
7170: 5f 4f 4d 49 54 5f 2a 0a 6f 70 74 69 6f 6e 73 20  _OMIT_*.options 
7180: 6d 75 73 74 20 61 6c 73 6f 20 62 65 20 64 65 66  must also be def
7190: 69 6e 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20  ined when using 
71a0: 74 68 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c  the 'lemon' tool
71b0: 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65   to generate the
71c0: 0a 70 61 72 73 65 2e 63 20 66 69 6c 65 20 61 6e  .parse.c file an
71d0: 64 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67  d when compiling
71e0: 20 74 68 65 20 27 6d 6b 6b 65 79 77 6f 72 64 68   the 'mkkeywordh
71f0: 61 73 68 27 20 74 6f 6f 6c 20 77 68 69 63 68 20  ash' tool which 
7200: 67 65 6e 65 72 61 74 65 73 20 0a 74 68 65 20 6b  generates .the k
7210: 65 79 77 6f 72 64 68 61 73 68 2e 68 20 66 69 6c  eywordhash.h fil
7220: 65 2e 0a 42 65 63 61 75 73 65 20 6f 66 20 74 68  e..Because of th
7230: 69 73 2c 20 74 68 65 73 65 20 6f 70 74 69 6f 6e  is, these option
7240: 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75 73  s may only be us
7250: 65 64 20 77 68 65 6e 20 74 68 65 20 6c 69 62 72  ed when the libr
7260: 61 72 79 20 69 73 20 62 75 69 6c 74 0a 66 72 6f  ary is built.fro
7270: 6d 20 63 61 6e 6f 6e 69 63 61 6c 20 73 6f 75 72  m canonical sour
7280: 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68 65  ce, not from the
7290: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20   [amalgamation] 
72a0: 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c  or from the coll
72b0: 65 63 74 69 6f 6e 20 6f 66 0a 70 72 65 2d 70 61  ection of.pre-pa
72c0: 63 6b 61 67 65 64 20 43 20 66 69 6c 65 73 20 70  ckaged C files p
72d0: 72 6f 76 69 64 65 64 20 66 6f 72 20 6e 6f 6e 2d  rovided for non-
72e0: 55 6e 69 78 20 6c 69 6b 65 20 70 6c 61 74 66 6f  Unix like platfo
72f0: 72 6d 73 20 6f 6e 20 74 68 65 20 77 65 62 73 69  rms on the websi
7300: 74 65 2e 0a 41 6e 79 20 53 51 4c 49 54 45 5f 4f  te..Any SQLITE_O
7310: 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 77 68  MIT_* options wh
7320: 69 63 68 20 63 61 6e 20 62 65 20 75 73 65 64 20  ich can be used 
7330: 64 69 72 65 63 74 6c 79 20 77 69 74 68 20 74 68  directly with th
7340: 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d  e [amalgamation]
7350: 20 0a 61 72 65 20 6c 69 73 74 65 64 20 62 65 6c   .are listed bel
7360: 6f 77 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 65  ow, however, the
7370: 20 77 61 72 6e 69 6e 67 73 20 69 6e 20 74 68 65   warnings in the
7380: 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 61 67   following parag
7390: 72 61 70 68 20 73 68 6f 75 6c 64 20 62 65 20 6e  raph should be n
73a0: 6f 74 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f  oted..</p>..<blo
73b0: 63 6b 71 75 6f 74 65 3e 0a 3c 69 3e 3c 62 3e 49  ckquote>.<i><b>I
73c0: 6d 70 6f 72 74 61 6e 74 20 4e 6f 74 65 3a 3c 2f  mportant Note:</
73d0: 62 3e 20 54 68 65 20 53 51 4c 49 54 45 5f 4f 4d  b> The SQLITE_OM
73e0: 49 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 64 6f 20  IT_* options do 
73f0: 6e 6f 74 20 77 6f 72 6b 20 77 69 74 68 20 74 68  not work with th
7400: 65 0a 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d  e.[amalgamation]
7410: 20 6f 72 20 77 69 74 68 20 70 72 65 2d 70 61 63   or with pre-pac
7420: 6b 61 67 65 64 20 43 20 63 6f 64 65 20 66 69 6c  kaged C code fil
7430: 65 73 2e 20 20 53 51 4c 49 54 45 5f 4f 4d 49 54  es.  SQLITE_OMIT
7440: 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a  _* compile-time.
7450: 6f 70 74 69 6f 6e 73 20 6f 6e 6c 79 20 77 6f 72  options only wor
7460: 6b 20 63 6f 72 72 65 63 74 6c 79 20 77 68 65 6e  k correctly when
7470: 20 53 51 4c 69 74 65 20 69 73 20 62 75 69 6c 74   SQLite is built
7480: 20 66 72 6f 6d 20 63 61 6e 6f 6e 69 63 61 6c 20   from canonical 
7490: 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 3c 2f  source files..</
74a0: 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  i>.</blockquote>
74b0: 0a 0a 0a 3c 70 3e 53 70 65 63 69 61 6c 20 76 65  ...<p>Special ve
74c0: 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 53 51  rsions of the SQ
74d0: 4c 69 74 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f  Lite amalgamatio
74e0: 6e 20 74 68 61 74 20 64 6f 20 77 6f 72 6b 20 77  n that do work w
74f0: 69 74 68 20 61 0a 70 72 65 64 65 74 65 72 6d 69  ith a.predetermi
7500: 6e 65 64 20 73 65 74 20 6f 66 20 53 51 4c 49 54  ned set of SQLIT
7510: 45 5f 4f 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e 73  E_OMIT_* options
7520: 20 63 61 6e 20 62 65 20 67 65 6e 65 72 61 74 65   can be generate
7530: 64 2e 20 20 54 6f 20 64 6f 20 73 6f 2c 0a 6d 61  d.  To do so,.ma
7540: 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65  ke a copy of the
7550: 20 4d 61 6b 65 66 69 6c 65 2e 6c 69 6e 75 78 2d   Makefile.linux-
7560: 67 63 63 20 6d 61 6b 65 66 69 6c 65 20 74 65 6d  gcc makefile tem
7570: 70 6c 61 74 65 20 69 6e 20 74 68 65 20 63 61 6e  plate in the can
7580: 6f 6e 69 63 61 6c 0a 73 6f 75 72 63 65 20 63 6f  onical.source co
7590: 64 65 20 64 69 73 74 72 69 62 75 74 69 6f 6e 2e  de distribution.
75a0: 20 20 43 68 61 6e 67 65 20 74 68 65 20 6e 61 6d    Change the nam
75b0: 65 20 6f 66 20 79 6f 75 72 20 63 6f 70 79 20 74  e of your copy t
75c0: 6f 20 73 69 6d 70 6c 79 20 22 4d 61 6b 65 66 69  o simply "Makefi
75d0: 6c 65 22 2e 0a 54 68 65 6e 20 65 64 69 74 20 22  le"..Then edit "
75e0: 4d 61 6b 65 66 69 6c 65 22 20 74 6f 20 73 65 74  Makefile" to set
75f0: 20 75 70 20 61 70 70 72 6f 70 72 69 61 74 65 20   up appropriate 
7600: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
7610: 69 6f 6e 73 2e 20 20 54 68 65 6e 0a 74 79 70 65  ions.  Then.type
7620: 3a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 74  :.<blockquote><t
7630: 74 3e 6d 61 6b 65 20 63 6c 65 61 6e 3b 20 6d 61  t>make clean; ma
7640: 6b 65 20 73 71 6c 69 74 65 33 2e 63 3c 2f 74 74  ke sqlite3.c</tt
7650: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 54  ></blockquote>.T
7660: 68 65 20 72 65 73 75 6c 74 69 6e 67 20 22 73 71  he resulting "sq
7670: 6c 69 74 65 33 2e 63 22 20 61 6d 61 6c 67 61 6d  lite3.c" amalgam
7680: 61 74 69 6f 6e 20 63 6f 64 65 20 66 69 6c 65 20  ation code file 
7690: 28 61 6e 64 20 69 74 73 20 61 73 73 6f 63 69 61  (and its associa
76a0: 74 65 64 0a 68 65 61 64 65 72 20 66 69 6c 65 20  ted.header file 
76b0: 22 73 71 6c 69 74 65 33 2e 68 22 29 20 63 61 6e  "sqlite3.h") can
76c0: 20 74 68 65 6e 20 62 65 20 6d 6f 76 65 64 20 74   then be moved t
76d0: 6f 20 61 20 6e 6f 6e 2d 75 6e 69 78 20 70 6c 61  o a non-unix pla
76e0: 74 66 6f 72 6d 0a 66 6f 72 20 66 69 6e 61 6c 20  tform.for final 
76f0: 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 75 73 69 6e  compilation usin
7700: 67 20 61 20 6e 61 74 69 76 65 20 63 6f 6d 70 69  g a native compi
7710: 6c 65 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 6c 6c  ler.</p>..<p>All
7720: 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 4f   of the SQLITE_O
7730: 4d 49 54 5f 2a 20 6f 70 74 69 6f 6e 73 20 61 72  MIT_* options ar
7740: 65 20 75 6e 73 75 70 70 6f 72 74 65 64 2e 3c 2f  e unsupported.</
7750: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  p>..<blockquote>
7760: 0a 3c 69 3e 3c 62 3e 49 6d 70 6f 72 74 61 6e 74  .<i><b>Important
7770: 20 4e 6f 74 65 3a 3c 2f 62 3e 0a 54 68 65 20 53   Note:</b>.The S
7780: 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d  QLITE_OMIT_* com
7790: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e  pile-time option
77a0: 73 20 61 72 65 20 75 6e 73 75 70 70 6f 72 74 65  s are unsupporte
77b0: 64 2e 0a 3c 2f 69 3e 3c 2f 62 6c 6f 63 6b 71 75  d..</i></blockqu
77c0: 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 53 51  ote>..<p>.The SQ
77d0: 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d 70  LITE_OMIT_* comp
77e0: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73  ile-time options
77f0: 20 61 72 65 20 75 73 75 61 6c 6c 79 20 75 6e 74   are usually unt
7800: 65 73 74 65 64 20 61 6e 64 0a 61 72 65 20 61 6c  ested and.are al
7810: 6d 6f 73 74 20 63 65 72 74 61 69 6e 6c 79 20 75  most certainly u
7820: 6e 74 65 73 74 65 64 20 69 6e 20 63 6f 6d 62 69  ntested in combi
7830: 6e 61 74 69 6f 6e 2e 0a 41 6e 79 20 6f 72 20 61  nation..Any or a
7840: 6c 6c 20 6f 66 20 74 68 65 73 65 20 6f 70 74 69  ll of these opti
7850: 6f 6e 73 20 6d 61 79 20 62 65 20 72 65 6d 6f 76  ons may be remov
7860: 65 64 20 66 72 6f 6d 20 74 68 65 20 63 6f 64 65  ed from the code
7870: 20 69 6e 20 66 75 74 75 72 65 20 72 65 6c 65 61   in future relea
7880: 73 65 73 0a 61 6e 64 20 77 69 74 68 6f 75 74 20  ses.and without 
7890: 77 61 72 6e 69 6e 67 2e 20 20 46 6f 72 20 61 6e  warning.  For an
78a0: 79 20 70 61 72 74 69 63 75 6c 61 72 20 72 65 6c  y particular rel
78b0: 65 61 73 65 2c 20 73 6f 6d 65 20 6f 66 20 74 68  ease, some of th
78c0: 65 73 65 0a 6f 70 74 69 6f 6e 73 20 6d 61 79 20  ese.options may 
78d0: 63 61 75 73 65 20 63 6f 6d 70 69 6c 65 2d 74 69  cause compile-ti
78e0: 6d 65 20 6f 72 20 72 75 6e 2d 74 69 6d 65 20 66  me or run-time f
78f0: 61 69 6c 75 72 65 73 2c 20 70 61 72 74 69 63 75  ailures, particu
7900: 6c 61 72 6c 79 0a 77 68 65 6e 20 75 73 65 64 20  larly.when used 
7910: 69 6e 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 77  in combination w
7920: 69 74 68 20 6f 74 68 65 72 20 6f 70 74 69 6f 6e  ith other option
7930: 73 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f  s.</p>..<tcl>.CO
7940: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
7950: 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54  LITE_OMIT_ALTERT
7960: 41 42 4c 45 7d 20 7b 0a 20 20 57 68 65 6e 20 74  ABLE} {.  When t
7970: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65  his option is de
7980: 66 69 6e 65 64 2c 20 74 68 65 20 0a 20 20 5b 41  fined, the .  [A
7990: 4c 54 45 52 20 54 41 42 4c 45 5d 20 63 6f 6d 6d  LTER TABLE] comm
79a0: 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75  and is not inclu
79b0: 64 65 64 20 69 6e 20 74 68 65 20 0a 20 20 6c 69  ded in the .  li
79c0: 62 72 61 72 79 2e 20 45 78 65 63 75 74 69 6e 67  brary. Executing
79d0: 20 61 6e 20 5b 41 4c 54 45 52 20 54 41 42 4c 45   an [ALTER TABLE
79e0: 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73  ] statement caus
79f0: 65 73 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  es a parse error
7a00: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
7a10: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
7a20: 5f 41 4e 41 4c 59 5a 45 7d 20 7b 0a 20 20 57 68  _ANALYZE} {.  Wh
7a30: 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  en this option i
7a40: 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b  s defined, the [
7a50: 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64  ANALYZE] command
7a60: 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d   is omitted from
7a70: 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a  .  the build..}.
7a80: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
7a90: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 54 54  {SQLITE_OMIT_ATT
7aa0: 41 43 48 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68  ACH} {.  When th
7ab0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66  is option is def
7ac0: 69 6e 65 64 2c 20 74 68 65 20 5b 41 54 54 41 43  ined, the [ATTAC
7ad0: 48 5d 20 61 6e 64 20 5b 44 45 54 41 43 48 5d 20  H] and [DETACH] 
7ae0: 63 6f 6d 6d 61 6e 64 73 20 61 72 65 0a 20 20 6f  commands are.  o
7af0: 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20  mitted from the 
7b00: 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  build..}..COMPIL
7b10: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
7b20: 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54  _OMIT_AUTHORIZAT
7b30: 49 4f 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e  ION} {.  Definin
7b40: 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d  g this option om
7b50: 69 74 73 20 74 68 65 20 61 75 74 68 6f 72 69 7a  its the authoriz
7b60: 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 66  ation callback f
7b70: 65 61 74 75 72 65 20 66 72 6f 6d 20 74 68 65 0a  eature from the.
7b80: 20 20 6c 69 62 72 61 72 79 2e 20 54 68 65 20 5b    library. The [
7b90: 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 74 68  sqlite3_set_auth
7ba0: 6f 72 69 7a 65 72 28 29 5d 20 41 50 49 20 66 75  orizer()] API fu
7bb0: 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 70 72  nction is not pr
7bc0: 65 73 65 6e 74 0a 20 20 69 6e 20 74 68 65 20 6c  esent.  in the l
7bd0: 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49  ibrary..}..COMPI
7be0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
7bf0: 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 43 52 45  E_OMIT_AUTOINCRE
7c00: 4d 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f  MENT} {.  This o
7c10: 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f  ption is used to
7c20: 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b 41 55   omit the .  [AU
7c30: 54 4f 49 4e 43 52 45 4d 45 4e 54 5d 20 66 75 6e  TOINCREMENT] fun
7c40: 63 74 69 6f 6e 61 6c 69 74 79 2e 20 57 68 65 6e  ctionality. When
7c50: 20 74 68 69 73 20 0a 20 20 69 73 20 6d 61 63 72   this .  is macr
7c60: 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 63 6f  o is defined, co
7c70: 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 64 20 61  lumns declared a
7c80: 73 20 0a 20 20 22 5b 49 4e 54 45 47 45 52 20 50  s .  "[INTEGER P
7c90: 52 49 4d 41 52 59 20 4b 45 59 5d 20 41 55 54 4f  RIMARY KEY] AUTO
7ca0: 49 4e 43 52 45 4d 45 4e 54 22 0a 20 20 62 65 68  INCREMENT".  beh
7cb0: 61 76 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20  ave in the same 
7cc0: 77 61 79 20 61 73 20 63 6f 6c 75 6d 6e 73 20 64  way as columns d
7cd0: 65 63 6c 61 72 65 64 20 61 73 20 22 5b 49 4e 54  eclared as "[INT
7ce0: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
7cf0: 5d 22 20 77 68 65 6e 20 61 20 0a 20 20 4e 55 4c  ]" when a .  NUL
7d00: 4c 20 69 73 20 69 6e 73 65 72 74 65 64 2e 20 54  L is inserted. T
7d10: 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75 65 6e  he sqlite_sequen
7d20: 63 65 20 73 79 73 74 65 6d 20 74 61 62 6c 65 20  ce system table 
7d30: 69 73 20 6e 65 69 74 68 65 72 20 63 72 65 61 74  is neither creat
7d40: 65 64 2c 20 6e 6f 72 0a 20 20 72 65 73 70 65 63  ed, nor.  respec
7d50: 74 65 64 20 69 66 20 69 74 20 61 6c 72 65 61 64  ted if it alread
7d60: 79 20 65 78 69 73 74 73 2e 0a 7d 0a 0a 43 4f 4d  y exists..}..COM
7d70: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
7d80: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 49  ITE_OMIT_AUTOINI
7d90: 54 7d 20 7b 0a 20 20 46 6f 72 20 62 61 63 6b 77  T} {.  For backw
7da0: 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 6c 69  ards compatibili
7db0: 74 79 20 77 69 74 68 20 6f 6c 64 65 72 20 76 65  ty with older ve
7dc0: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
7dd0: 20 74 68 61 74 20 6c 61 63 6b 0a 20 20 74 68 65   that lack.  the
7de0: 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61   [sqlite3_initia
7df0: 6c 69 7a 65 28 29 5d 20 69 6e 74 65 72 66 61 63  lize()] interfac
7e00: 65 2c 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  e, the [sqlite3_
7e10: 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20 69 6e  initialize()] in
7e20: 74 65 72 66 61 63 65 0a 20 20 69 73 20 63 61 6c  terface.  is cal
7e30: 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  led automaticall
7e40: 79 20 75 70 6f 6e 20 65 6e 74 72 79 20 74 6f 20  y upon entry to 
7e50: 63 65 72 74 61 69 6e 20 6b 65 79 20 69 6e 74 65  certain key inte
7e60: 72 66 61 63 65 73 20 73 75 63 68 20 61 73 0a 20  rfaces such as. 
7e70: 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29   [sqlite3_open()
7e80: 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 5f  ], [sqlite3_vfs_
7e90: 72 65 67 69 73 74 65 72 28 29 5d 2c 20 61 6e 64  register()], and
7ea0: 20 5b 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74   [sqlite3_mprint
7eb0: 66 28 29 5d 2e 0a 20 20 54 68 65 20 6f 76 65 72  f()]..  The over
7ec0: 68 65 61 64 20 6f 66 20 69 6e 76 6f 6b 69 6e 67  head of invoking
7ed0: 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61   [sqlite3_initia
7ee0: 6c 69 7a 65 28 29 5d 20 61 75 74 6f 6d 61 74 69  lize()] automati
7ef0: 63 61 6c 6c 79 20 69 6e 20 74 68 69 73 0a 20 20  cally in this.  
7f00: 77 61 79 20 6d 61 79 20 62 65 20 6f 6d 69 74 74  way may be omitt
7f10: 65 64 20 62 79 20 62 75 69 6c 64 69 6e 67 20 53  ed by building S
7f20: 51 4c 69 74 65 20 77 69 74 68 20 74 68 65 20 53  QLite with the S
7f30: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49  QLITE_OMIT_AUTOI
7f40: 4e 49 54 0a 20 20 43 2d 70 72 65 70 72 6f 63 65  NIT.  C-preproce
7f50: 73 73 6f 72 20 6d 61 63 72 6f 2e 20 20 57 68 65  ssor macro.  Whe
7f60: 6e 20 62 75 69 6c 74 20 75 73 69 6e 67 20 53 51  n built using SQ
7f70: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e  LITE_OMIT_AUTOIN
7f80: 49 54 2c 20 53 51 4c 69 74 65 0a 20 20 77 69 6c  IT, SQLite.  wil
7f90: 6c 20 6e 6f 74 20 61 75 74 6f 6d 61 74 69 63 61  l not automatica
7fa0: 6c 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65 20 69  lly initialize i
7fb0: 74 73 65 6c 66 20 61 6e 64 20 74 68 65 20 61 70  tself and the ap
7fc0: 70 6c 69 63 61 74 69 6f 6e 20 69 73 20 72 65 71  plication is req
7fd0: 75 69 72 65 64 0a 20 20 74 6f 20 69 6e 76 6f 6b  uired.  to invok
7fe0: 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69  e [sqlite3_initi
7ff0: 61 6c 69 7a 65 28 29 5d 20 64 69 72 65 63 74 6c  alize()] directl
8000: 79 20 70 72 69 6f 72 20 74 6f 20 62 65 67 69 6e  y prior to begin
8010: 6e 69 6e 67 20 75 73 65 20 6f 66 20 74 68 65 0a  ning use of the.
8020: 20 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79    SQLite library
8030: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
8040: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
8050: 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58  _AUTOMATIC_INDEX
8060: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
8070: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69  n is used to omi
8080: 74 20 74 68 65 20 0a 20 20 5b 61 75 74 6f 6d 61  t the .  [automa
8090: 74 69 63 20 69 6e 64 65 78 69 6e 67 5d 20 66 75  tic indexing] fu
80a0: 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 0a 7d 0a 0a  nctionality..}..
80b0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
80c0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
80d0: 52 45 53 45 54 7d 20 7b 0a 20 20 42 79 20 64 65  RESET} {.  By de
80e0: 66 61 75 6c 74 2c 20 74 68 65 20 5b 73 71 6c 69  fault, the [sqli
80f0: 74 65 33 5f 73 74 65 70 28 29 5d 20 69 6e 74 65  te3_step()] inte
8100: 72 66 61 63 65 20 77 69 6c 6c 20 61 75 74 6f 6d  rface will autom
8110: 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f 6b 65 0a  atically invoke.
8120: 20 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 65 74    [sqlite3_reset
8130: 28 29 5d 20 74 6f 20 72 65 73 65 74 20 74 68 65  ()] to reset the
8140: 20 5b 70 72 65 70 61 72 65 64 20 73 74 61 74 65   [prepared state
8150: 6d 65 6e 74 5d 20 69 66 20 6e 65 63 65 73 73 61  ment] if necessa
8160: 72 79 2e 20 20 54 68 69 73 0a 20 20 63 6f 6d 70  ry.  This.  comp
8170: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20  ile-time option 
8180: 63 68 61 6e 67 65 73 20 74 68 61 74 20 62 65 68  changes that beh
8190: 61 76 69 6f 72 20 73 6f 20 74 68 61 74 20 5b 73  avior so that [s
81a0: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 5d 20 77  qlite3_step()] w
81b0: 69 6c 6c 0a 20 20 72 65 74 75 72 6e 20 5b 53 51  ill.  return [SQ
81c0: 4c 49 54 45 5f 4d 49 53 55 53 45 5d 20 69 66 20  LITE_MISUSE] if 
81d0: 69 74 20 63 61 6c 6c 65 64 20 61 67 61 69 6e 20  it called again 
81e0: 61 66 74 65 72 20 72 65 74 75 72 6e 69 6e 67 20  after returning 
81f0: 61 6e 79 74 68 69 6e 67 20 6f 74 68 65 72 0a 20  anything other. 
8200: 20 74 68 61 6e 20 5b 53 51 4c 49 54 45 5f 52 4f   than [SQLITE_RO
8210: 57 5d 2c 20 5b 53 51 4c 49 54 45 5f 42 55 53 59  W], [SQLITE_BUSY
8220: 5d 2c 20 6f 72 20 5b 53 51 4c 49 54 45 5f 4c 4f  ], or [SQLITE_LO
8230: 43 4b 45 44 5d 20 75 6e 6c 65 73 73 20 74 68 65  CKED] unless the
8240: 72 65 20 77 61 73 20 61 6e 0a 20 20 69 6e 74 65  re was an.  inte
8250: 72 76 65 6e 69 6e 67 20 63 61 6c 6c 20 74 6f 20  rvening call to 
8260: 5b 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28 29  [sqlite3_reset()
8270: 5d 2e 0a 0a 20 20 49 6e 20 53 51 4c 69 74 65 20  ]...  In SQLite 
8280: 76 65 72 73 69 6f 6e 20 33 2e 36 2e 32 33 2e 31  version 3.6.23.1
8290: 20 61 6e 64 20 65 61 72 6c 69 65 72 2c 20 5b 73   and earlier, [s
82a0: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 5d 20 75  qlite3_step()] u
82b0: 73 65 64 20 74 6f 20 61 6c 77 61 79 73 0a 20 20  sed to always.  
82c0: 72 65 74 75 72 6e 20 5b 53 51 4c 49 54 45 5f 4d  return [SQLITE_M
82d0: 49 53 55 53 45 5d 20 69 66 20 69 74 20 77 61 73  ISUSE] if it was
82e0: 20 69 6e 76 6f 6b 65 64 20 61 67 61 69 6e 20 61   invoked again a
82f0: 66 74 65 72 20 72 65 74 75 72 6e 69 6e 67 20 61  fter returning a
8300: 6e 79 74 68 69 6e 67 0a 20 20 6f 74 68 65 72 20  nything.  other 
8310: 74 68 61 6e 20 5b 53 51 4c 49 54 45 5f 52 4f 57  than [SQLITE_ROW
8320: 5d 20 77 69 74 68 6f 75 74 20 61 6e 20 69 6e 74  ] without an int
8330: 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c 20 74 6f  ervening call to
8340: 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28   [sqlite3_reset(
8350: 29 5d 2e 0a 20 20 54 68 69 73 20 63 61 75 73 65  )]..  This cause
8360: 64 20 70 72 6f 62 6c 65 6d 73 20 6f 6e 20 73 6f  d problems on so
8370: 6d 65 20 70 6f 6f 72 6c 79 20 77 72 69 74 74 65  me poorly writte
8380: 6e 20 73 6d 61 72 74 70 68 6f 6e 65 20 61 70 70  n smartphone app
8390: 6c 69 63 61 74 69 6f 6e 73 20 77 68 69 63 68 0a  lications which.
83a0: 20 20 64 69 64 20 6e 6f 74 20 63 6f 72 72 65 63    did not correc
83b0: 74 6c 79 20 68 61 6e 64 6c 65 20 74 68 65 20 5b  tly handle the [
83c0: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5d 20 61  SQLITE_LOCKED] a
83d0: 6e 64 20 5b 53 51 4c 49 54 45 5f 42 55 53 59 5d  nd [SQLITE_BUSY]
83e0: 20 65 72 72 6f 72 20 0a 20 20 72 65 74 75 72 6e   error .  return
83f0: 73 2e 20 20 52 61 74 68 65 72 20 74 68 61 6e 20  s.  Rather than 
8400: 66 69 78 20 74 68 65 20 6d 61 6e 79 20 64 65 66  fix the many def
8410: 65 63 74 69 76 65 20 73 6d 61 72 74 70 68 6f 6e  ective smartphon
8420: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2c 20  e applications, 
8430: 0a 20 20 74 68 65 20 62 65 68 61 76 69 6f 72 20  .  the behavior 
8440: 6f 66 20 53 51 4c 69 74 65 20 77 61 73 20 63 68  of SQLite was ch
8450: 61 6e 67 65 64 20 69 6e 20 33 2e 36 2e 32 33 2e  anged in 3.6.23.
8460: 32 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c  2 to automatical
8470: 6c 79 20 72 65 73 65 74 0a 20 20 74 68 65 20 70  ly reset.  the p
8480: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
8490: 74 2e 20 20 42 75 74 20 74 68 61 74 20 63 68 61  t.  But that cha
84a0: 6e 67 65 64 20 63 61 75 73 65 64 20 69 73 73 75  nged caused issu
84b0: 65 73 20 69 6e 20 6f 74 68 65 72 20 0a 20 20 69  es in other .  i
84c0: 6d 70 72 6f 70 65 72 6c 79 20 69 6d 70 6c 65 6d  mproperly implem
84d0: 65 6e 74 65 64 20 61 70 70 6c 69 63 61 74 69 6f  ented applicatio
84e0: 6e 73 20 74 68 61 74 20 77 65 72 65 20 61 63 74  ns that were act
84f0: 75 61 6c 6c 79 20 6c 6f 6f 6b 69 6e 67 0a 20 20  ually looking.  
8500: 66 6f 72 20 61 6e 20 5b 53 51 4c 49 54 45 5f 4d  for an [SQLITE_M
8510: 49 53 55 53 45 5d 20 72 65 74 75 72 6e 20 74 6f  ISUSE] return to
8520: 20 74 65 72 6d 69 6e 61 74 65 20 74 68 65 69 72   terminate their
8530: 20 71 75 65 72 79 20 6c 6f 6f 70 73 2e 20 20 28   query loops.  (
8540: 41 6e 79 74 69 6d 65 0a 20 20 61 6e 20 61 70 70  Anytime.  an app
8550: 6c 69 63 61 74 69 6f 6e 20 67 65 74 73 20 61 6e  lication gets an
8560: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 65   SQLITE_MISUSE e
8570: 72 72 6f 72 20 63 6f 64 65 20 66 72 6f 6d 20 53  rror code from S
8580: 51 4c 69 74 65 2c 20 74 68 61 74 20 6d 65 61 6e  QLite, that mean
8590: 73 20 74 68 65 0a 20 20 61 70 70 6c 69 63 61 74  s the.  applicat
85a0: 69 6f 6e 20 69 73 20 6d 69 73 75 73 69 6e 67 20  ion is misusing 
85b0: 74 68 65 20 53 51 4c 69 74 65 20 69 6e 74 65 72  the SQLite inter
85c0: 66 61 63 65 20 61 6e 64 20 69 73 20 74 68 75 73  face and is thus
85d0: 20 69 6e 63 6f 72 72 65 63 74 6c 79 0a 20 20 69   incorrectly.  i
85e0: 6d 70 6c 65 6d 65 6e 74 65 64 2e 29 20 20 54 68  mplemented.)  Th
85f0: 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55  e SQLITE_OMIT_AU
8600: 54 4f 52 45 53 45 54 20 69 6e 74 65 72 66 61 63  TORESET interfac
8610: 65 20 77 61 73 20 61 64 64 65 64 20 74 6f 20 53  e was added to S
8620: 51 4c 69 74 65 0a 20 20 76 65 72 73 69 6f 6e 20  QLite.  version 
8630: 33 2e 37 2e 35 20 69 6e 20 61 6e 20 65 66 66 6f  3.7.5 in an effo
8640: 72 74 20 74 6f 20 67 65 74 20 61 6c 6c 20 6f 66  rt to get all of
8650: 20 74 68 65 20 28 62 72 6f 6b 65 6e 29 0a 20 20   the (broken).  
8660: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 6f 20  applications to 
8670: 77 6f 72 6b 20 61 67 61 69 6e 20 77 69 74 68 6f  work again witho
8680: 75 74 20 68 61 76 69 6e 67 20 74 6f 20 61 63 74  ut having to act
8690: 75 61 6c 6c 79 20 66 69 78 20 74 68 65 20 61 70  ually fix the ap
86a0: 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a 0a 43  plications..}..C
86b0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
86c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56  QLITE_OMIT_AUTOV
86d0: 41 43 55 55 4d 7d 20 7b 0a 20 20 49 66 20 74 68  ACUUM} {.  If th
86e0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66  is option is def
86f0: 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72 61 72  ined, the librar
8700: 79 20 63 61 6e 6e 6f 74 20 63 72 65 61 74 65 20  y cannot create 
8710: 6f 72 20 77 72 69 74 65 20 74 6f 20 0a 20 20 64  or write to .  d
8720: 61 74 61 62 61 73 65 73 20 74 68 61 74 20 73 75  atabases that su
8730: 70 70 6f 72 74 20 5b 61 75 74 6f 5f 76 61 63 75  pport [auto_vacu
8740: 75 6d 5d 2e 0a 20 20 45 78 65 63 75 74 69 6e 67  um]..  Executing
8750: 20 61 20 5b 50 52 41 47 4d 41 20 61 75 74 6f 5f   a [PRAGMA auto_
8760: 76 61 63 75 75 6d 5d 20 73 74 61 74 65 6d 65 6e  vacuum] statemen
8770: 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72 72 6f  t is not an erro
8780: 72 0a 20 20 28 73 69 6e 63 65 20 75 6e 6b 6e 6f  r.  (since unkno
8790: 77 6e 20 50 52 41 47 4d 41 73 20 61 72 65 20 73  wn PRAGMAs are s
87a0: 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72 65 64 29  ilently ignored)
87b0: 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 20 72  , but does not r
87c0: 65 74 75 72 6e 20 61 20 76 61 6c 75 65 0a 20 20  eturn a value.  
87d0: 6f 72 20 6d 6f 64 69 66 79 20 74 68 65 20 61 75  or modify the au
87e0: 74 6f 2d 76 61 63 75 75 6d 20 66 6c 61 67 20 69  to-vacuum flag i
87f0: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  n the database f
8800: 69 6c 65 2e 20 49 66 20 61 20 64 61 74 61 62 61  ile. If a databa
8810: 73 65 20 74 68 61 74 0a 20 20 73 75 70 70 6f 72  se that.  suppor
8820: 74 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 69  ts auto-vacuum i
8830: 73 20 6f 70 65 6e 65 64 20 62 79 20 61 20 6c 69  s opened by a li
8840: 62 72 61 72 79 20 63 6f 6d 70 69 6c 65 64 20 77  brary compiled w
8850: 69 74 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c  ith this option,
8860: 20 69 74 0a 20 20 69 73 20 61 75 74 6f 6d 61 74   it.  is automat
8870: 69 63 61 6c 6c 79 20 6f 70 65 6e 65 64 20 69 6e  ically opened in
8880: 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 6f 64 65 2e   read-only mode.
8890: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
88a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
88b0: 42 45 54 57 45 45 4e 5f 4f 50 54 49 4d 49 5a 41  BETWEEN_OPTIMIZA
88c0: 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f  TION} {.  This o
88d0: 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74  ption disables t
88e0: 68 65 20 75 73 65 20 6f 66 20 69 6e 64 69 63 65  he use of indice
88f0: 73 20 77 69 74 68 20 57 48 45 52 45 20 63 6c 61  s with WHERE cla
8900: 75 73 65 20 74 65 72 6d 73 0a 20 20 74 68 61 74  use terms.  that
8910: 20 65 6d 70 6c 6f 79 20 74 68 65 20 42 45 54 57   employ the BETW
8920: 45 45 4e 20 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a  EEN operator..}.
8930: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
8940: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f  {SQLITE_OMIT_BLO
8950: 42 5f 4c 49 54 45 52 41 4c 7d 20 7b 0a 20 20 57  B_LITERAL} {.  W
8960: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
8970: 69 73 20 64 65 66 69 6e 65 64 2c 20 69 74 20 69  is defined, it i
8980: 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74  s not possible t
8990: 6f 20 73 70 65 63 69 66 79 20 61 20 62 6c 6f 62  o specify a blob
89a0: 20 69 6e 0a 20 20 61 6e 20 53 51 4c 20 73 74 61   in.  an SQL sta
89b0: 74 65 6d 65 6e 74 20 75 73 69 6e 67 20 74 68 65  tement using the
89c0: 20 58 27 41 42 43 44 27 20 73 79 6e 74 61 78 2e   X'ABCD' syntax.
89d0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
89e0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
89f0: 42 54 52 45 45 43 4f 55 4e 54 7d 20 7b 0a 20 20  BTREECOUNT} {.  
8a00: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
8a10: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 6e 20   is defined, an 
8a20: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 74 68 61  optimization tha
8a30: 74 20 61 63 63 65 6c 65 72 61 74 65 73 20 63 6f  t accelerates co
8a40: 75 6e 74 69 6e 67 0a 20 20 61 6c 6c 20 65 6e 74  unting.  all ent
8a50: 72 69 65 73 20 69 6e 20 61 20 74 61 62 6c 65 20  ries in a table 
8a60: 28 69 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c  (in other words,
8a70: 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e   an optimization
8a80: 20 74 68 61 74 20 68 65 6c 70 73 0a 20 20 22 53   that helps.  "S
8a90: 45 4c 45 43 54 20 63 6f 75 6e 74 28 2a 29 20 46  ELECT count(*) F
8aa0: 52 4f 4d 20 74 61 62 6c 65 22 20 72 75 6e 20 66  ROM table" run f
8ab0: 61 73 74 65 72 29 20 69 73 20 6f 6d 69 74 74 65  aster) is omitte
8ac0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
8ad0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
8ae0: 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 7d 20  T_BUILTIN_TEST} 
8af0: 7b 0a 20 20 41 20 73 74 61 6e 64 61 72 64 20 53  {.  A standard S
8b00: 51 4c 69 74 65 20 62 75 69 6c 64 20 69 6e 63 6c  QLite build incl
8b10: 75 64 65 73 20 61 20 73 6d 61 6c 6c 20 61 6d 6f  udes a small amo
8b20: 75 6e 74 20 6f 66 20 6c 6f 67 69 63 20 63 6f 6e  unt of logic con
8b30: 74 72 6f 6c 6c 65 64 0a 20 20 62 79 20 74 68 65  trolled.  by the
8b40: 20 5b 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63   [sqlite3_test_c
8b50: 6f 6e 74 72 6f 6c 28 29 5d 20 69 6e 74 65 72 66  ontrol()] interf
8b60: 61 63 65 20 74 68 61 74 20 69 73 20 75 73 65 64  ace that is used
8b70: 20 74 6f 20 65 78 65 72 63 69 73 65 0a 20 20 70   to exercise.  p
8b80: 61 72 74 73 20 6f 66 20 74 68 65 20 53 51 4c 69  arts of the SQLi
8b90: 74 65 20 63 6f 72 65 20 74 68 61 74 20 61 72 65  te core that are
8ba0: 20 64 69 66 66 69 63 75 6c 74 20 74 6f 20 63 6f   difficult to co
8bb0: 6e 74 72 6f 6c 20 61 6e 64 20 6d 65 61 73 75 72  ntrol and measur
8bc0: 65 20 75 73 69 6e 67 0a 20 20 74 68 65 20 73 74  e using.  the st
8bd0: 61 6e 64 61 72 64 20 41 50 49 2e 20 20 54 68 69  andard API.  Thi
8be0: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74  s option omits t
8bf0: 68 61 74 20 62 75 69 6c 74 2d 69 6e 20 74 65 73  hat built-in tes
8c00: 74 20 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50  t logic..}..COMP
8c10: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
8c20: 54 45 5f 4f 4d 49 54 5f 43 41 53 54 7d 20 7b 0a  TE_OMIT_CAST} {.
8c30: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
8c40: 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f  uses SQLite to o
8c50: 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20  mit support for 
8c60: 74 68 65 20 43 41 53 54 20 6f 70 65 72 61 74 6f  the CAST operato
8c70: 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  r..}..COMPILE_OP
8c80: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
8c90: 54 5f 43 48 45 43 4b 7d 20 7b 0a 20 20 54 68 69  T_CHECK} {.  Thi
8ca0: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
8cb0: 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73  SQLite to omit s
8cc0: 75 70 70 6f 72 74 20 66 6f 72 20 43 48 45 43 4b  upport for CHECK
8cd0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 20 20   constraints..  
8ce0: 54 68 65 20 70 61 72 73 65 72 20 77 69 6c 6c 20  The parser will 
8cf0: 73 74 69 6c 6c 20 61 63 63 65 70 74 20 43 48 45  still accept CHE
8d00: 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69  CK constraints i
8d10: 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73  n SQL statements
8d20: 2c 0a 20 20 74 68 65 79 20 77 69 6c 6c 20 6a 75  ,.  they will ju
8d30: 73 74 20 6e 6f 74 20 62 65 20 65 6e 66 6f 72 63  st not be enforc
8d40: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
8d50: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
8d60: 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e  IT_COMPILEOPTION
8d70: 5f 44 49 41 47 53 7d 20 7b 0a 20 20 54 68 69 73  _DIAGS} {.  This
8d80: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20   option is used 
8d90: 74 6f 20 6f 6d 69 74 20 74 68 65 20 63 6f 6d 70  to omit the comp
8da0: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 20  ile-time option 
8db0: 64 69 61 67 6e 6f 73 74 69 63 73 20 61 76 61 69  diagnostics avai
8dc0: 6c 61 62 6c 65 0a 20 20 69 6e 20 53 51 4c 69 74  lable.  in SQLit
8dd0: 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65  e, including the
8de0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c   [sqlite3_compil
8df0: 65 6f 70 74 69 6f 6e 5f 75 73 65 64 28 29 5d 20  eoption_used()] 
8e00: 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63  and.  [sqlite3_c
8e10: 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e 5f 67 65 74  ompileoption_get
8e20: 28 29 5d 20 43 2f 43 2b 2b 20 66 75 6e 63 74 69  ()] C/C++ functi
8e30: 6f 6e 73 2c 20 74 68 65 0a 20 20 5b 73 71 6c 69  ons, the.  [sqli
8e40: 74 65 5f 63 6f 6d 70 69 6c 65 6f 70 74 69 6f 6e  te_compileoption
8e50: 5f 75 73 65 64 28 29 5d 20 61 6e 64 20 5b 73 71  _used()] and [sq
8e60: 6c 69 74 65 5f 63 6f 6d 70 69 6c 65 6f 70 74 69  lite_compileopti
8e70: 6f 6e 5f 67 65 74 28 29 5d 20 53 51 4c 20 66 75  on_get()] SQL fu
8e80: 6e 63 74 69 6f 6e 73 2c 0a 20 20 61 6e 64 20 74  nctions,.  and t
8e90: 68 65 20 5b 63 6f 6d 70 69 6c 65 5f 6f 70 74 69  he [compile_opti
8ea0: 6f 6e 73 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a 0a  ons pragma]..}..
8eb0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
8ec0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50  SQLITE_OMIT_COMP
8ed0: 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f  LETE} {.  This o
8ee0: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 65  ption causes the
8ef0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65   [sqlite3_comple
8f00: 74 65 28 29 5d 20 61 6e 64 20 5b 73 71 6c 69 74  te()] and [sqlit
8f10: 65 33 5f 63 6f 6d 70 6c 65 74 65 31 36 28 29 5d  e3_complete16()]
8f20: 0a 20 20 69 6e 74 65 72 66 61 63 65 73 20 74 6f  .  interfaces to
8f30: 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a   be omitted..}..
8f40: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
8f50: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50  SQLITE_OMIT_COMP
8f60: 4f 55 4e 44 5f 53 45 4c 45 43 54 7d 20 7b 0a 20  OUND_SELECT} {. 
8f70: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   This option is 
8f80: 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65  used to omit the
8f90: 20 63 6f 6d 70 6f 75 6e 64 20 5b 53 45 4c 45 43   compound [SELEC
8fa0: 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79  T] functionality
8fb0: 2e 20 0a 20 20 5b 53 45 4c 45 43 54 5d 20 73 74  . .  [SELECT] st
8fc0: 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 75 73  atements that us
8fd0: 65 20 74 68 65 20 0a 20 20 55 4e 49 4f 4e 2c 20  e the .  UNION, 
8fe0: 55 4e 49 4f 4e 20 41 4c 4c 2c 20 49 4e 54 45 52  UNION ALL, INTER
8ff0: 53 45 43 54 20 6f 72 20 45 58 43 45 50 54 20 63  SECT or EXCEPT c
9000: 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 20 6f  ompound SELECT o
9010: 70 65 72 61 74 6f 72 73 20 77 69 6c 6c 20 0a 20  perators will . 
9020: 20 63 61 75 73 65 20 61 20 70 61 72 73 65 20 65   cause a parse e
9030: 72 72 6f 72 2e 0a 0a 20 20 41 6e 20 5b 49 4e 53  rror...  An [INS
9040: 45 52 54 5d 20 73 74 61 74 65 6d 65 6e 74 20 77  ERT] statement w
9050: 69 74 68 20 6d 75 6c 74 69 70 6c 65 20 76 61 6c  ith multiple val
9060: 75 65 73 20 69 6e 20 74 68 65 20 56 41 4c 55 45  ues in the VALUE
9070: 53 20 63 6c 61 75 73 65 20 69 73 0a 20 20 69 6d  S clause is.  im
9080: 70 6c 65 6d 65 6e 74 65 64 20 69 6e 74 65 72 6e  plemented intern
9090: 61 6c 6c 79 20 61 73 20 61 20 63 6f 6d 70 6f 75  ally as a compou
90a0: 6e 64 20 53 45 4c 45 43 54 2e 20 20 48 65 6e 63  nd SELECT.  Henc
90b0: 65 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61  e, this option a
90c0: 6c 73 6f 0a 20 20 64 69 73 61 62 6c 65 73 20 74  lso.  disables t
90d0: 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 69 6e  he ability to in
90e0: 73 65 72 74 20 6d 6f 72 65 20 74 68 61 6e 20 61  sert more than a
90f0: 20 73 69 6e 67 6c 65 20 72 6f 77 20 75 73 69 6e   single row usin
9100: 67 20 61 6e 0a 20 20 49 4e 53 45 52 54 20 49 4e  g an.  INSERT IN
9110: 54 4f 20 2e 2e 2e 20 56 41 4c 55 45 53 20 2e 2e  TO ... VALUES ..
9120: 2e 20 73 74 61 74 65 6d 65 6e 74 2e 0a 7d 0a 0a  . statement..}..
9130: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9140: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41 54 45  SQLITE_OMIT_DATE
9150: 54 49 4d 45 5f 46 55 4e 43 53 7d 20 7b 0a 20 20  TIME_FUNCS} {.  
9160: 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69  If this option i
9170: 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69 74  s defined, SQLit
9180: 65 27 73 20 62 75 69 6c 74 2d 69 6e 20 64 61 74  e's built-in dat
9190: 65 20 61 6e 64 20 74 69 6d 65 20 6d 61 6e 69 70  e and time manip
91a0: 75 6c 61 74 69 6f 6e 0a 20 20 66 75 6e 63 74 69  ulation.  functi
91b0: 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2e  ons are omitted.
91c0: 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74   Specifically, t
91d0: 68 65 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73  he SQL functions
91e0: 20 6a 75 6c 69 61 6e 64 61 79 28 29 2c 20 64 61   julianday(), da
91f0: 74 65 28 29 2c 0a 20 20 74 69 6d 65 28 29 2c 20  te(),.  time(), 
9200: 64 61 74 65 74 69 6d 65 28 29 20 61 6e 64 20 73  datetime() and s
9210: 74 72 66 74 69 6d 65 28 29 20 61 72 65 20 6e 6f  trftime() are no
9220: 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65  t available. The
9230: 20 64 65 66 61 75 6c 74 20 63 6f 6c 75 6d 6e 0a   default column.
9240: 20 20 76 61 6c 75 65 73 20 43 55 52 52 45 4e 54    values CURRENT
9250: 5f 54 49 4d 45 2c 20 43 55 52 52 45 4e 54 5f 44  _TIME, CURRENT_D
9260: 41 54 45 20 61 6e 64 20 43 55 52 52 45 4e 54 5f  ATE and CURRENT_
9270: 54 49 4d 45 53 54 41 4d 50 20 61 72 65 20 73 74  TIMESTAMP are st
9280: 69 6c 6c 20 61 76 61 69 6c 61 62 6c 65 2e 0a 7d  ill available..}
9290: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
92a0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45   {SQLITE_OMIT_DE
92b0: 43 4c 54 59 50 45 7d 20 7b 0a 20 20 54 68 69 73  CLTYPE} {.  This
92c0: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53   option causes S
92d0: 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75  QLite to omit su
92e0: 70 70 6f 72 74 20 66 6f 72 20 74 68 65 0a 20 20  pport for the.  
92f0: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
9300: 64 65 63 6c 74 79 70 65 28 29 5d 20 61 6e 64 20  decltype()] and 
9310: 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  [sqlite3_column_
9320: 64 65 63 6c 74 79 70 65 31 36 28 29 5d 0a 20 20  decltype16()].  
9330: 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43  interfaces..}..C
9340: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
9350: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45  QLITE_OMIT_DEPRE
9360: 43 41 54 45 44 7d 20 7b 0a 20 20 54 68 69 73 20  CATED} {.  This 
9370: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51  option causes SQ
9380: 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70  Lite to omit sup
9390: 70 6f 72 74 20 66 6f 72 20 69 6e 74 65 72 66 61  port for interfa
93a0: 63 65 73 0a 20 20 6d 61 72 6b 65 64 20 61 73 20  ces.  marked as 
93b0: 64 65 70 72 65 63 61 74 65 64 2e 20 20 54 68 69  deprecated.  Thi
93c0: 73 20 69 6e 63 6c 75 64 65 73 20 0a 20 20 5b 73  s includes .  [s
93d0: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
93e0: 5f 63 6f 75 6e 74 28 29 5d 2c 0a 20 20 5b 73 71  _count()],.  [sq
93f0: 6c 69 74 65 33 5f 65 78 70 69 72 65 64 28 29 5d  lite3_expired()]
9400: 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 72 61  ,.  [sqlite3_tra
9410: 6e 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28 29  nsfer_bindings()
9420: 5d 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f 67 6c  ],.  [sqlite3_gl
9430: 6f 62 61 6c 5f 72 65 63 6f 76 65 72 28 29 5d 2c  obal_recover()],
9440: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65  .  [sqlite3_thre
9450: 61 64 5f 63 6c 65 61 6e 75 70 28 29 5d 20 61 6e  ad_cleanup()] an
9460: 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6d 65 6d  d.  [sqlite3_mem
9470: 6f 72 79 5f 61 6c 61 72 6d 28 29 5d 20 69 6e 74  ory_alarm()] int
9480: 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50  erfaces..}..COMP
9490: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
94a0: 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 7d 20  TE_OMIT_DISKIO} 
94b0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20  {.  This option 
94c0: 6f 6d 69 74 73 20 61 6c 6c 20 73 75 70 70 6f 72  omits all suppor
94d0: 74 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 6f  t for writing to
94e0: 20 74 68 65 20 64 69 73 6b 20 61 6e 64 20 66 6f   the disk and fo
94f0: 72 63 65 73 0a 20 20 64 61 74 61 62 61 73 65 73  rces.  databases
9500: 20 74 6f 20 65 78 69 73 74 20 69 6e 20 6d 65 6d   to exist in mem
9510: 6f 72 79 20 6f 6e 6c 79 2e 20 20 54 68 69 73 20  ory only.  This 
9520: 6f 70 74 69 6f 6e 20 68 61 73 20 6e 6f 74 20 62  option has not b
9530: 65 65 6e 20 0a 20 20 6d 61 69 6e 74 61 69 6e 65  een .  maintaine
9540: 64 20 61 6e 64 20 70 72 6f 62 61 62 6c 79 20 64  d and probably d
9550: 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 77 69 74  oes not work wit
9560: 68 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 73  h newer versions
9570: 20 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43   of SQLite..}..C
9580: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
9590: 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41  QLITE_OMIT_EXPLA
95a0: 49 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67  IN} {.  Defining
95b0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   this option cau
95c0: 73 65 73 20 74 68 65 20 5b 45 58 50 4c 41 49 4e  ses the [EXPLAIN
95d0: 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62 65 20  ] command to be 
95e0: 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65  omitted from the
95f0: 0a 20 20 6c 69 62 72 61 72 79 2e 20 41 74 74 65  .  library. Atte
9600: 6d 70 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74  mpting to execut
9610: 65 20 61 6e 20 5b 45 58 50 4c 41 49 4e 5d 20 73  e an [EXPLAIN] s
9620: 74 61 74 65 6d 65 6e 74 20 77 69 6c 6c 20 63 61  tatement will ca
9630: 75 73 65 20 61 20 70 61 72 73 65 0a 20 20 65 72  use a parse.  er
9640: 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ror..}..COMPILE_
9650: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
9660: 4d 49 54 5f 46 4c 41 47 5f 50 52 41 47 4d 41 53  MIT_FLAG_PRAGMAS
9670: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
9680: 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20  n omits support 
9690: 66 6f 72 20 61 20 73 75 62 73 65 74 20 6f 66 20  for a subset of 
96a0: 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64  [PRAGMA] command
96b0: 73 20 74 68 61 74 0a 20 20 71 75 65 72 79 20 61  s that.  query a
96c0: 6e 64 20 73 65 74 20 62 6f 6f 6c 65 61 6e 20 70  nd set boolean p
96d0: 72 6f 70 65 72 74 69 65 73 2e 0a 7d 0a 0a 43 4f  roperties..}..CO
96e0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
96f0: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49  LITE_OMIT_FLOATI
9700: 4e 47 5f 50 4f 49 4e 54 7d 20 7b 0a 20 20 54 68  NG_POINT} {.  Th
9710: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65  is option is use
9720: 64 20 74 6f 20 6f 6d 69 74 20 66 6c 6f 61 74 69  d to omit floati
9730: 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d 62 65 72 20  ng-point number 
9740: 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65  support from the
9750: 20 53 51 4c 69 74 65 0a 20 20 6c 69 62 72 61 72   SQLite.  librar
9760: 79 2e 20 57 68 65 6e 20 73 70 65 63 69 66 69 65  y. When specifie
9770: 64 2c 20 73 70 65 63 69 66 79 69 6e 67 20 61 20  d, specifying a 
9780: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e  floating point n
9790: 75 6d 62 65 72 20 61 73 20 61 20 6c 69 74 65 72  umber as a liter
97a0: 61 6c 20 0a 20 20 28 69 2e 65 2e 20 22 31 2e 30  al .  (i.e. "1.0
97b0: 31 22 29 20 72 65 73 75 6c 74 73 20 69 6e 20 61  1") results in a
97c0: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20   parse error... 
97d0: 20 3c 70 3e 49 6e 20 74 68 65 20 66 75 74 75 72   <p>In the futur
97e0: 65 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d  e, this option m
97f0: 61 79 20 61 6c 73 6f 20 64 69 73 61 62 6c 65 20  ay also disable 
9800: 6f 74 68 65 72 20 66 6c 6f 61 74 69 6e 67 20 70  other floating p
9810: 6f 69 6e 74 20 0a 20 20 66 75 6e 63 74 69 6f 6e  oint .  function
9820: 61 6c 69 74 79 2c 20 66 6f 72 20 65 78 61 6d 70  ality, for examp
9830: 6c 65 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  le the [sqlite3_
9840: 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28 29 5d  result_double()]
9850: 2c 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 69  , .  [sqlite3_bi
9860: 6e 64 5f 64 6f 75 62 6c 65 28 29 5d 2c 20 5b 73  nd_double()], [s
9870: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75  qlite3_value_dou
9880: 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71  ble()] and.  [sq
9890: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75  lite3_column_dou
98a0: 62 6c 65 28 29 5d 20 41 50 49 20 66 75 6e 63 74  ble()] API funct
98b0: 69 6f 6e 73 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a  ions..  </p>.}..
98c0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
98d0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45  SQLITE_OMIT_FORE
98e0: 49 47 4e 5f 4b 45 59 7d 20 7b 0a 20 20 49 66 20  IGN_KEY} {.  If 
98f0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
9900: 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 5b 66 6f  efined, then [fo
9910: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
9920: 61 69 6e 74 5d 20 73 79 6e 74 61 78 20 69 73 0a  aint] syntax is.
9930: 20 20 6e 6f 74 20 72 65 63 6f 67 6e 69 7a 65 64    not recognized
9940: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
9950: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
9960: 5f 47 45 54 5f 54 41 42 4c 45 7d 20 7b 0a 20 20  _GET_TABLE} {.  
9970: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
9980: 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 5b  es support for [
9990: 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 6c  sqlite3_get_tabl
99a0: 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69  e()] and.  [sqli
99b0: 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 29  te3_free_table()
99c0: 5d 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e  ] to be omitted.
99d0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
99e0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
99f0: 49 4e 43 52 42 4c 4f 42 7d 20 7b 0a 20 20 54 68  INCRBLOB} {.  Th
9a00: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73  is option causes
9a10: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 5b 73 71   support for [sq
9a20: 6c 69 74 65 33 5f 62 6c 6f 62 20 7c 20 69 6e 63  lite3_blob | inc
9a30: 72 65 6d 65 6e 74 61 6c 20 42 4c 4f 42 20 49 2f  remental BLOB I/
9a40: 4f 5d 0a 20 20 74 6f 20 62 65 20 6f 6d 69 74 74  O].  to be omitt
9a50: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
9a60: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
9a70: 49 54 5f 49 4e 54 45 47 52 49 54 59 5f 43 48 45  IT_INTEGRITY_CHE
9a80: 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  CK} {.  This opt
9a90: 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72  ion omits suppor
9aa0: 74 20 66 6f 72 20 74 68 65 20 5b 69 6e 74 65 67  t for the [integ
9ab0: 72 69 74 79 5f 63 68 65 63 6b 20 70 72 61 67 6d  rity_check pragm
9ac0: 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  a]..}..COMPILE_O
9ad0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
9ae0: 49 54 5f 4c 49 4b 45 5f 4f 50 54 49 4d 49 5a 41  IT_LIKE_OPTIMIZA
9af0: 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f  TION} {.  This o
9b00: 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74  ption disables t
9b10: 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53 51  he ability of SQ
9b20: 4c 69 74 65 20 74 6f 20 75 73 65 20 69 6e 64 69  Lite to use indi
9b30: 63 65 73 20 74 6f 20 68 65 6c 70 0a 20 20 72 65  ces to help.  re
9b40: 73 6f 6c 76 65 20 5b 4c 49 4b 45 5d 20 61 6e 64  solve [LIKE] and
9b50: 20 5b 47 4c 4f 42 5d 20 6f 70 65 72 61 74 6f 72   [GLOB] operator
9b60: 73 20 69 6e 20 61 20 57 48 45 52 45 20 63 6c 61  s in a WHERE cla
9b70: 75 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  use..}..COMPILE_
9b80: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
9b90: 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49  MIT_LOAD_EXTENSI
9ba0: 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  ON} {.  This opt
9bb0: 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 65 6e  ion omits the en
9bc0: 74 69 72 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c  tire extension l
9bd0: 6f 61 64 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d  oading mechanism
9be0: 20 66 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2c 20   from.  SQLite, 
9bf0: 69 6e 63 6c 75 64 69 6e 67 20 5b 73 71 6c 69 74  including [sqlit
9c00: 65 33 5f 65 6e 61 62 6c 65 5f 6c 6f 61 64 5f 65  e3_enable_load_e
9c10: 78 74 65 6e 73 69 6f 6e 28 29 5d 20 61 6e 64 0a  xtension()] and.
9c20: 20 20 5b 73 71 6c 69 74 65 33 5f 6c 6f 61 64 5f    [sqlite3_load_
9c30: 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20 69 6e 74  extension()] int
9c40: 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50  erfaces..}..COMP
9c50: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
9c60: 54 45 5f 4f 4d 49 54 5f 4c 4f 43 41 4c 54 49 4d  TE_OMIT_LOCALTIM
9c70: 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  E} {.  This opti
9c80: 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 22 6c 6f  on omits the "lo
9c90: 63 61 6c 74 69 6d 65 22 20 6d 6f 64 69 66 69 65  caltime" modifie
9ca0: 72 20 66 72 6f 6d 20 74 68 65 20 64 61 74 65 20  r from the date 
9cb0: 61 6e 64 20 74 69 6d 65 0a 20 20 66 75 6e 63 74  and time.  funct
9cc0: 69 6f 6e 73 2e 20 20 54 68 69 73 20 6f 70 74 69  ions.  This opti
9cd0: 6f 6e 20 69 73 20 73 6f 6d 65 74 69 6d 65 73 20  on is sometimes 
9ce0: 75 73 65 66 75 6c 20 77 68 65 6e 20 74 72 79 69  useful when tryi
9cf0: 6e 67 20 74 6f 20 63 6f 6d 70 69 6c 65 0a 20 20  ng to compile.  
9d00: 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d  the date and tim
9d10: 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 20 61  e functions on a
9d20: 20 70 6c 61 74 66 6f 72 6d 20 74 68 61 74 20 64   platform that d
9d30: 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20  oes not support 
9d40: 74 68 65 0a 20 20 63 6f 6e 63 65 70 74 20 6f 66  the.  concept of
9d50: 20 6c 6f 63 61 6c 20 74 69 6d 65 2e 0a 7d 0a 0a   local time..}..
9d60: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
9d70: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 4f 4b  SQLITE_OMIT_LOOK
9d80: 41 53 49 44 45 7d 20 7b 0a 20 20 54 68 69 73 20  ASIDE} {.  This 
9d90: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65  option omits the
9da0: 20 5b 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f   [lookaside memo
9db0: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 2e 0a 7d  ry allocator]..}
9dc0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
9dd0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45   {SQLITE_OMIT_ME
9de0: 4d 4f 52 59 44 42 7d 20 7b 0a 20 20 57 68 65 6e  MORYDB} {.  When
9df0: 20 74 68 69 73 20 69 73 20 64 65 66 69 6e 65 64   this is defined
9e00: 2c 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 6f  , the library do
9e10: 65 73 20 6e 6f 74 20 72 65 73 70 65 63 74 20 74  es not respect t
9e20: 68 65 20 73 70 65 63 69 61 6c 20 64 61 74 61 62  he special datab
9e30: 61 73 65 0a 20 20 6e 61 6d 65 20 22 3a 6d 65 6d  ase.  name ":mem
9e40: 6f 72 79 3a 22 20 28 6e 6f 72 6d 61 6c 6c 79 20  ory:" (normally 
9e50: 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61  used to create a
9e60: 6e 20 5b 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74  n [in-memory dat
9e70: 61 62 61 73 65 5d 29 2e 20 49 66 20 0a 20 20 22  abase]). If .  "
9e80: 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 20 70 61 73  :memory:" is pas
9e90: 73 65 64 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f  sed to [sqlite3_
9ea0: 6f 70 65 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65  open()], [sqlite
9eb0: 33 5f 6f 70 65 6e 31 36 28 29 5d 2c 20 6f 72 0a  3_open16()], or.
9ec0: 20 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f    [sqlite3_open_
9ed0: 76 32 28 29 5d 2c 20 61 20 66 69 6c 65 20 77 69  v2()], a file wi
9ee0: 74 68 20 74 68 69 73 20 6e 61 6d 65 20 77 69 6c  th this name wil
9ef0: 6c 20 62 65 20 0a 20 20 6f 70 65 6e 65 64 20 6f  l be .  opened o
9f00: 72 20 63 72 65 61 74 65 64 2e 0a 7d 0a 0a 43 4f  r created..}..CO
9f10: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
9f20: 4c 49 54 45 5f 4f 4d 49 54 5f 4f 52 5f 4f 50 54  LITE_OMIT_OR_OPT
9f30: 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54  IMIZATION} {.  T
9f40: 68 69 73 20 6f 70 74 69 6f 6e 20 64 69 73 61 62  his option disab
9f50: 6c 65 73 20 74 68 65 20 61 62 69 6c 69 74 79 20  les the ability 
9f60: 6f 66 20 53 51 4c 69 74 65 20 74 6f 20 75 73 65  of SQLite to use
9f70: 20 61 6e 20 69 6e 64 65 78 20 74 6f 67 65 74 68   an index togeth
9f80: 65 72 0a 20 20 77 69 74 68 20 74 65 72 6d 73 20  er.  with terms 
9f90: 6f 66 20 61 20 57 48 45 52 45 20 63 6c 61 75 73  of a WHERE claus
9fa0: 65 20 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74  e connected by t
9fb0: 68 65 20 4f 52 20 6f 70 65 72 61 74 6f 72 2e 0a  he OR operator..
9fc0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
9fd0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50  N {SQLITE_OMIT_P
9fe0: 41 47 45 52 5f 50 52 41 47 4d 41 53 7d 20 7b 0a  AGER_PRAGMAS} {.
9ff0: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
a000: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61  option omits pra
a010: 67 6d 61 73 20 72 65 6c 61 74 65 64 20 74 6f 20  gmas related to 
a020: 74 68 65 20 70 61 67 65 72 20 73 75 62 73 79 73  the pager subsys
a030: 74 65 6d 20 66 72 6f 6d 20 0a 20 20 74 68 65 20  tem from .  the 
a040: 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  build..}..COMPIL
a050: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a060: 5f 4f 4d 49 54 5f 50 52 41 47 4d 41 7d 20 7b 0a  _OMIT_PRAGMA} {.
a070: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73    This option is
a080: 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 68   used to omit th
a090: 65 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61  e [PRAGMA] comma
a0a0: 6e 64 0a 20 20 66 72 6f 6d 20 74 68 65 20 6c 69  nd.  from the li
a0b0: 62 72 61 72 79 2e 20 4e 6f 74 65 20 74 68 61 74  brary. Note that
a0c0: 20 69 74 20 69 73 20 75 73 65 66 75 6c 20 74 6f   it is useful to
a0d0: 20 64 65 66 69 6e 65 20 74 68 65 20 6d 61 63 72   define the macr
a0e0: 6f 73 20 74 68 61 74 20 6f 6d 69 74 0a 20 20 73  os that omit.  s
a0f0: 70 65 63 69 66 69 63 20 70 72 61 67 6d 61 73 20  pecific pragmas 
a100: 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74  in addition to t
a110: 68 69 73 2c 20 61 73 20 74 68 65 79 20 6d 61 79  his, as they may
a120: 20 61 6c 73 6f 20 72 65 6d 6f 76 65 20 73 75 70   also remove sup
a130: 70 6f 72 74 69 6e 67 20 63 6f 64 65 0a 20 20 69  porting code.  i
a140: 6e 20 6f 74 68 65 72 20 73 75 62 2d 73 79 73 74  n other sub-syst
a150: 65 6d 73 2e 20 54 68 69 73 20 6d 61 63 72 6f 20  ems. This macro 
a160: 72 65 6d 6f 76 65 73 20 74 68 65 20 5b 50 52 41  removes the [PRA
a170: 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c  GMA] command onl
a180: 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  y..}..COMPILE_OP
a190: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
a1a0: 54 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42  T_PROGRESS_CALLB
a1b0: 41 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ACK} {.  This op
a1c0: 74 69 6f 6e 20 6d 61 79 20 62 65 20 64 65 66 69  tion may be defi
a1d0: 6e 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20  ned to omit the 
a1e0: 63 61 70 61 62 69 6c 69 74 79 20 74 6f 20 69 73  capability to is
a1f0: 73 75 65 20 22 70 72 6f 67 72 65 73 73 22 20 0a  sue "progress" .
a200: 20 20 63 61 6c 6c 62 61 63 6b 73 20 64 75 72 69    callbacks duri
a210: 6e 67 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20  ng long-running 
a220: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 20  SQL statements. 
a230: 54 68 65 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f  The .  [sqlite3_
a240: 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 65 72  progress_handler
a250: 28 29 5d 0a 20 20 41 50 49 20 66 75 6e 63 74 69  ()].  API functi
a260: 6f 6e 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e  on is not presen
a270: 74 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79  t in the library
a280: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
a290: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
a2a0: 5f 51 55 49 43 4b 42 41 4c 41 4e 43 45 7d 20 7b  _QUICKBALANCE} {
a2b0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f  .  This option o
a2c0: 6d 69 74 73 20 61 6e 20 61 6c 74 65 72 6e 61 74  mits an alternat
a2d0: 69 76 65 2c 20 66 61 73 74 65 72 20 42 2d 54 72  ive, faster B-Tr
a2e0: 65 65 20 62 61 6c 61 6e 63 69 6e 67 20 72 6f 75  ee balancing rou
a2f0: 74 69 6e 65 2e 0a 20 20 55 73 69 6e 67 20 74 68  tine..  Using th
a300: 69 73 20 6f 70 74 69 6f 6e 20 6d 61 6b 65 73 20  is option makes 
a310: 53 51 4c 69 74 65 20 73 6c 69 67 68 74 6c 79 20  SQLite slightly 
a320: 73 6d 61 6c 6c 65 72 20 61 74 20 74 68 65 20 65  smaller at the e
a330: 78 70 65 6e 73 65 20 6f 66 0a 20 20 6d 61 6b 69  xpense of.  maki
a340: 6e 67 20 69 74 20 72 75 6e 20 73 6c 69 67 68 74  ng it run slight
a350: 6c 79 20 73 6c 6f 77 65 72 2e 0a 7d 0a 0a 43 4f  ly slower..}..CO
a360: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
a370: 4c 49 54 45 5f 4f 4d 49 54 5f 52 45 49 4e 44 45  LITE_OMIT_REINDE
a380: 58 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  X} {.  When this
a390: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
a3a0: 65 64 2c 20 74 68 65 20 5b 52 45 49 4e 44 45 58  ed, the [REINDEX
a3b0: 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e  ].  command is n
a3c0: 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74  ot included in t
a3d0: 68 65 20 6c 69 62 72 61 72 79 2e 0a 20 20 45 78  he library..  Ex
a3e0: 65 63 75 74 69 6e 67 20 61 20 5b 52 45 49 4e 44  ecuting a [REIND
a3f0: 45 58 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61  EX] statement ca
a400: 75 73 65 73 20 0a 20 20 61 20 70 61 72 73 65 20  uses .  a parse 
a410: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
a420: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
a430: 5f 4f 4d 49 54 5f 53 43 48 45 4d 41 5f 50 52 41  _OMIT_SCHEMA_PRA
a440: 47 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69  GMAS} {.  Defini
a450: 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f  ng this option o
a460: 6d 69 74 73 20 70 72 61 67 6d 61 73 20 66 6f 72  mits pragmas for
a470: 20 71 75 65 72 79 69 6e 67 20 74 68 65 20 64 61   querying the da
a480: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 66 72  tabase schema fr
a490: 6f 6d 20 0a 20 20 74 68 65 20 62 75 69 6c 64 2e  om .  the build.
a4a0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
a4b0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
a4c0: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 5f 50  SCHEMA_VERSION_P
a4d0: 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69  RAGMAS} {.  Defi
a4e0: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
a4f0: 20 6f 6d 69 74 73 20 70 72 61 67 6d 61 73 20 66   omits pragmas f
a500: 6f 72 20 71 75 65 72 79 69 6e 67 20 61 6e 64 20  or querying and 
a510: 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 0a 20  modifying the . 
a520: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61   database schema
a530: 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 75 73 65   version and use
a540: 72 20 76 65 72 73 69 6f 6e 20 66 72 6f 6d 20 74  r version from t
a550: 68 65 20 62 75 69 6c 64 2e 20 53 70 65 63 69 66  he build. Specif
a560: 69 63 61 6c 6c 79 2c 20 74 68 65 20 0a 20 20 5b  ically, the .  [
a570: 73 63 68 65 6d 61 5f 76 65 72 73 69 6f 6e 5d 20  schema_version] 
a580: 61 6e 64 20 5b 75 73 65 72 5f 76 65 72 73 69 6f  and [user_versio
a590: 6e 5d 20 50 52 41 47 4d 41 73 20 61 72 65 20 6f  n] PRAGMAs are o
a5a0: 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  mitted..}..COMPI
a5b0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
a5c0: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41  E_OMIT_SHARED_CA
a5d0: 43 48 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  CHE} {.  This op
a5e0: 74 69 6f 6e 20 62 75 69 6c 64 73 20 53 51 4c 69  tion builds SQLi
a5f0: 74 65 20 77 69 74 68 6f 75 74 20 73 75 70 70 6f  te without suppo
a600: 72 74 20 66 6f 72 20 73 68 61 72 65 64 2d 63 61  rt for shared-ca
a610: 63 68 65 20 6d 6f 64 65 2e 0a 20 20 54 68 65 20  che mode..  The 
a620: 5b 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f  [sqlite3_enable_
a630: 73 68 61 72 65 64 5f 63 61 63 68 65 28 29 5d 20  shared_cache()] 
a640: 69 73 20 6f 6d 69 74 74 65 64 20 61 6c 6f 6e 67  is omitted along
a650: 20 77 69 74 68 20 61 20 66 61 69 72 0a 20 20 61   with a fair.  a
a660: 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67 69 63 20 77  mount of logic w
a670: 69 74 68 69 6e 20 74 68 65 20 42 2d 54 72 65 65  ithin the B-Tree
a680: 20 73 75 62 73 79 73 74 65 6d 20 61 73 73 6f 63   subsystem assoc
a690: 69 61 74 65 64 20 77 69 74 68 20 73 68 61 72 65  iated with share
a6a0: 64 0a 20 20 63 61 63 68 65 20 6d 61 6e 61 67 65  d.  cache manage
a6b0: 6d 65 6e 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ment..}..COMPILE
a6c0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
a6d0: 4f 4d 49 54 5f 53 55 42 51 55 45 52 59 7d 20 7b  OMIT_SUBQUERY} {
a6e0: 0a 20 20 49 66 20 64 65 66 69 6e 65 64 2c 20 73  .  If defined, s
a6f0: 75 70 70 6f 72 74 20 66 6f 72 20 73 75 62 2d 73  upport for sub-s
a700: 65 6c 65 63 74 73 20 61 6e 64 20 74 68 65 20 49  elects and the I
a710: 4e 28 29 20 6f 70 65 72 61 74 6f 72 20 61 72 65  N() operator are
a720: 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d   omitted..}..COM
a730: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
a740: 49 54 45 5f 4f 4d 49 54 5f 54 43 4c 5f 56 41 52  ITE_OMIT_TCL_VAR
a750: 49 41 42 4c 45 7d 20 7b 0a 20 20 49 66 20 74 68  IABLE} {.  If th
a760: 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69  is macro is defi
a770: 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 20 73 70  ned, then the sp
a780: 65 63 69 61 6c 20 22 24 3c 76 61 72 69 61 62 6c  ecial "$<variabl
a790: 65 2d 6e 61 6d 65 3e 22 20 73 79 6e 74 61 78 0a  e-name>" syntax.
a7a0: 20 20 75 73 65 64 20 74 6f 20 61 75 74 6f 6d 61    used to automa
a7b0: 74 69 63 61 6c 6c 79 20 62 69 6e 64 20 53 51 4c  tically bind SQL
a7c0: 20 76 61 72 69 61 62 6c 65 73 20 74 6f 20 54 43   variables to TC
a7d0: 4c 20 76 61 72 69 61 62 6c 65 73 20 69 73 20 6f  L variables is o
a7e0: 6d 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  mitted..}..COMPI
a7f0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
a800: 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 7d 20 7b  E_OMIT_TEMPDB} {
a810: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f  .  This option o
a820: 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72  mits support for
a830: 20 54 45 4d 50 20 6f 72 20 54 45 4d 50 4f 52 41   TEMP or TEMPORA
a840: 52 59 20 74 61 62 6c 65 73 2e 0a 7d 0a 0a 43 4f  RY tables..}..CO
a850: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
a860: 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 7d  LITE_OMIT_TRACE}
a870: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e   {.  This option
a880: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
a890: 6f 72 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  or the [sqlite3_
a8a0: 70 72 6f 66 69 6c 65 28 29 5d 20 61 6e 64 0a 20  profile()] and. 
a8b0: 20 5b 73 71 6c 69 74 65 33 5f 74 72 61 63 65 28   [sqlite3_trace(
a8c0: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 20 61 6e  )] interfaces an
a8d0: 64 20 74 68 65 69 72 20 61 73 73 6f 63 69 61 74  d their associat
a8e0: 65 64 20 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d  ed logic..}..COM
a8f0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
a900: 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52  ITE_OMIT_TRIGGER
a910: 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74  } {.  Defining t
a920: 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73  his option omits
a930: 20 73 75 70 70 6f 72 74 20 66 6f 72 20 54 52 49   support for TRI
a940: 47 47 45 52 20 6f 62 6a 65 63 74 73 2e 20 4e 65  GGER objects. Ne
a950: 69 74 68 65 72 20 74 68 65 20 0a 20 20 5b 43 52  ither the .  [CR
a960: 45 41 54 45 20 54 52 49 47 47 45 52 5d 20 6f 72  EATE TRIGGER] or
a970: 20 5b 44 52 4f 50 20 54 52 49 47 47 45 52 5d 0a   [DROP TRIGGER].
a980: 20 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61    commands are a
a990: 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 69 73  vailable in this
a9a0: 20 63 61 73 65 2c 20 61 6e 64 20 61 74 74 65 6d   case, and attem
a9b0: 70 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65  pting to execute
a9c0: 0a 20 20 65 69 74 68 65 72 20 77 69 6c 6c 20 72  .  either will r
a9d0: 65 73 75 6c 74 20 69 6e 20 61 20 70 61 72 73 65  esult in a parse
a9e0: 20 65 72 72 6f 72 2e 0a 20 20 54 68 69 73 20 6f   error..  This o
a9f0: 70 74 69 6f 6e 20 61 6c 73 6f 20 64 69 73 61 62  ption also disab
aa00: 6c 65 73 20 65 6e 66 6f 72 63 65 6d 65 6e 74 20  les enforcement 
aa10: 6f 66 20 5b 66 6f 72 65 69 67 6e 20 6b 65 79 20  of [foreign key 
aa20: 63 6f 6e 73 74 72 61 69 6e 74 73 5d 2c 0a 20 20  constraints],.  
aa30: 73 69 6e 63 65 20 74 68 65 20 63 6f 64 65 20 74  since the code t
aa40: 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74  hat implements t
aa50: 72 69 67 67 65 72 73 20 61 6e 64 20 77 68 69 63  riggers and whic
aa60: 68 20 69 73 20 6f 6d 69 74 74 65 64 20 62 79 20  h is omitted by 
aa70: 74 68 69 73 0a 20 20 6f 70 74 69 6f 6e 20 69 73  this.  option is
aa80: 20 61 6c 73 6f 20 75 73 65 64 20 74 6f 20 69 6d   also used to im
aa90: 70 6c 65 6d 65 6e 74 20 5b 66 6f 72 65 69 67 6e  plement [foreign
aaa0: 20 6b 65 79 20 61 63 74 69 6f 6e 73 5d 2e 0a 7d   key actions]..}
aab0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
aac0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52   {SQLITE_OMIT_TR
aad0: 55 4e 43 41 54 45 5f 4f 50 54 49 4d 49 5a 41 54  UNCATE_OPTIMIZAT
aae0: 49 4f 4e 7d 20 7b 0a 20 20 41 20 64 65 66 61 75  ION} {.  A defau
aaf0: 6c 74 20 62 75 69 6c 64 20 6f 66 20 53 51 4c 69  lt build of SQLi
ab00: 74 65 2c 20 69 66 20 61 20 5b 44 45 4c 45 54 45  te, if a [DELETE
ab10: 5d 20 73 74 61 74 65 6d 65 6e 74 20 68 61 73 20  ] statement has 
ab20: 6e 6f 20 57 48 45 52 45 20 63 6c 61 75 73 65 0a  no WHERE clause.
ab30: 20 20 61 6e 64 20 6f 70 65 72 61 74 65 73 20 6f    and operates o
ab40: 6e 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 6e  n a table with n
ab50: 6f 20 74 72 69 67 67 65 72 73 2c 20 61 6e 20 6f  o triggers, an o
ab60: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 6f 63 63 75  ptimization occu
ab70: 72 73 20 74 68 61 74 0a 20 20 63 61 75 73 65 73  rs that.  causes
ab80: 20 74 68 65 20 44 45 4c 45 54 45 20 74 6f 20 6f   the DELETE to o
ab90: 63 63 75 72 20 62 79 20 64 72 6f 70 70 69 6e 67  ccur by dropping
aba0: 20 61 6e 64 20 72 65 63 72 65 61 74 69 6e 67 20   and recreating 
abb0: 74 68 65 20 74 61 62 6c 65 2e 20 20 0a 20 20 44  the table.  .  D
abc0: 72 6f 70 70 69 6e 67 20 61 6e 64 20 72 65 63 72  ropping and recr
abd0: 65 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 69  eating a table i
abe0: 73 20 75 73 75 61 6c 6c 79 20 6d 75 63 68 20 66  s usually much f
abf0: 61 73 74 65 72 20 74 68 61 6e 20 64 65 6c 65 74  aster than delet
ac00: 69 6e 67 0a 20 20 74 68 65 20 74 61 62 6c 65 20  ing.  the table 
ac10: 63 6f 6e 74 65 6e 74 20 72 6f 77 20 62 79 20 72  content row by r
ac20: 6f 77 2e 20 20 54 68 69 73 20 69 73 20 74 68 65  ow.  This is the
ac30: 20 22 74 72 75 6e 63 61 74 65 20 6f 70 74 69 6d   "truncate optim
ac40: 69 7a 61 74 69 6f 6e 22 2e 0a 7d 0a 0a 43 4f 4d  ization"..}..COM
ac50: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
ac60: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 7d 20  ITE_OMIT_UTF16} 
ac70: 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 69  {.  This macro i
ac80: 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 73  s used to omit s
ac90: 75 70 70 6f 72 74 20 66 6f 72 20 55 54 46 31 36  upport for UTF16
aca0: 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20   text encoding. 
acb0: 57 68 65 6e 20 74 68 69 73 20 69 73 0a 20 20 64  When this is.  d
acc0: 65 66 69 6e 65 64 20 61 6c 6c 20 41 50 49 20 66  efined all API f
acd0: 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 72 65  unctions that re
ace0: 74 75 72 6e 20 6f 72 20 61 63 63 65 70 74 20 55  turn or accept U
acf0: 54 46 31 36 20 65 6e 63 6f 64 65 64 20 74 65 78  TF16 encoded tex
ad00: 74 20 61 72 65 0a 20 20 75 6e 61 76 61 69 6c 61  t are.  unavaila
ad10: 62 6c 65 2e 20 54 68 65 73 65 20 66 75 6e 63 74  ble. These funct
ad20: 69 6f 6e 73 20 63 61 6e 20 62 65 20 69 64 65 6e  ions can be iden
ad30: 74 69 66 69 65 64 20 62 79 20 74 68 65 20 66 61  tified by the fa
ad40: 63 74 20 74 68 61 74 20 74 68 65 79 20 65 6e 64  ct that they end
ad50: 0a 20 20 77 69 74 68 20 27 31 36 27 2c 20 66 6f  .  with '16', fo
ad60: 72 20 65 78 61 6d 70 6c 65 20 5b 73 71 6c 69 74  r example [sqlit
ad70: 65 33 5f 70 72 65 70 61 72 65 31 36 28 29 5d 2c  e3_prepare16()],
ad80: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
ad90: 5f 74 65 78 74 31 36 28 29 5d 20 61 6e 64 0a 20  _text16()] and. 
ada0: 20 5b 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74   [sqlite3_bind_t
adb0: 65 78 74 31 36 28 29 5d 2e 0a 7d 0a 0a 43 4f 4d  ext16()]..}..COM
adc0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
add0: 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55 55 4d 7d  ITE_OMIT_VACUUM}
ade0: 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f   {.  When this o
adf0: 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64  ption is defined
ae00: 2c 20 74 68 65 20 5b 56 41 43 55 55 4d 5d 0a 20  , the [VACUUM]. 
ae10: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20   command is not 
ae20: 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20  included in the 
ae30: 6c 69 62 72 61 72 79 2e 0a 20 20 45 78 65 63 75  library..  Execu
ae40: 74 69 6e 67 20 61 20 5b 56 41 43 55 55 4d 5d 20  ting a [VACUUM] 
ae50: 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65 73  statement causes
ae60: 20 0a 20 20 61 20 70 61 72 73 65 20 65 72 72 6f   .  a parse erro
ae70: 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  r..}..COMPILE_OP
ae80: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
ae90: 54 5f 56 49 45 57 7d 20 7b 0a 20 20 44 65 66 69  T_VIEW} {.  Defi
aea0: 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e  ning this option
aeb0: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66   omits support f
aec0: 6f 72 20 56 49 45 57 20 6f 62 6a 65 63 74 73 2e  or VIEW objects.
aed0: 20 4e 65 69 74 68 65 72 20 74 68 65 20 0a 20 20   Neither the .  
aee0: 5b 43 52 45 41 54 45 20 56 49 45 57 5d 20 6e 6f  [CREATE VIEW] no
aef0: 72 20 74 68 65 20 5b 44 52 4f 50 20 56 49 45 57  r the [DROP VIEW
af00: 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65  ].  commands are
af10: 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68   available in th
af20: 69 73 20 63 61 73 65 2c 20 61 6e 64 0a 20 20 61  is case, and.  a
af30: 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78 65  ttempting to exe
af40: 63 75 74 65 20 65 69 74 68 65 72 20 77 69 6c 6c  cute either will
af50: 20 72 65 73 75 6c 74 20 69 6e 20 61 20 70 61 72   result in a par
af60: 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20 57 41 52  se error...  WAR
af70: 4e 49 4e 47 3a 20 49 66 20 74 68 69 73 20 6d 61  NING: If this ma
af80: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20  cro is defined, 
af90: 69 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70  it will not be p
afa0: 6f 73 73 69 62 6c 65 20 74 6f 20 6f 70 65 6e 20  ossible to open 
afb0: 61 20 64 61 74 61 62 61 73 65 0a 20 20 66 6f 72  a database.  for
afc0: 20 77 68 69 63 68 20 74 68 65 20 73 63 68 65 6d   which the schem
afd0: 61 20 63 6f 6e 74 61 69 6e 73 20 56 49 45 57 20  a contains VIEW 
afe0: 6f 62 6a 65 63 74 73 2e 20 0a 7d 0a 0a 43 4f 4d  objects. .}..COM
aff0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
b000: 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c  ITE_OMIT_VIRTUAL
b010: 54 41 42 4c 45 7d 20 7b 0a 20 20 54 68 69 73 20  TABLE} {.  This 
b020: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
b030: 70 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 73 71  port for the [sq
b040: 6c 69 74 65 33 5f 76 74 61 62 20 7c 20 56 69 72  lite3_vtab | Vir
b050: 74 75 61 6c 20 54 61 62 6c 65 5d 0a 20 20 6d 65  tual Table].  me
b060: 63 68 61 6e 69 73 6d 20 69 6e 20 53 51 4c 69 74  chanism in SQLit
b070: 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  e..}..COMPILE_OP
b080: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
b090: 54 5f 57 41 4c 7d 20 7b 0a 20 20 54 68 69 73 20  T_WAL} {.  This 
b0a0: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65  option omits the
b0b0: 20 22 5b 77 72 69 74 65 2d 61 68 65 61 64 20 6c   "[write-ahead l
b0c0: 6f 67 5d 22 20 28 61 2e 6b 2e 61 2e 20 22 5b 57  og]" (a.k.a. "[W
b0d0: 41 4c 5d 22 29 20 63 61 70 61 62 69 6c 69 74 79  AL]") capability
b0e0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
b0f0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
b100: 5f 57 53 44 7d 20 7b 0a 20 20 54 68 69 73 20 6f  _WSD} {.  This o
b110: 70 74 69 6f 6e 20 62 75 69 6c 64 73 20 61 20 76  ption builds a v
b120: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 53 51  ersion of the SQ
b130: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 74 68 61  Lite library tha
b140: 74 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 0a 20 20  t contains no.  
b150: 57 72 69 74 61 62 6c 65 20 53 74 61 74 69 63 20  Writable Static 
b160: 44 61 74 61 20 28 57 53 44 29 2e 20 20 57 53 44  Data (WSD).  WSD
b170: 20 69 73 20 67 6c 6f 62 61 6c 20 76 61 72 69 61   is global varia
b180: 62 6c 65 73 20 61 6e 64 2f 6f 72 20 73 74 61 74  bles and/or stat
b190: 69 63 0a 20 20 76 61 72 69 61 62 6c 65 73 2e 20  ic.  variables. 
b1a0: 20 53 6f 6d 65 20 70 6c 61 74 66 6f 72 6d 73 20   Some platforms 
b1b0: 64 6f 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 57  do not support W
b1c0: 53 44 2c 20 61 6e 64 20 74 68 69 73 20 6f 70 74  SD, and this opt
b1d0: 69 6f 6e 20 69 73 20 6e 65 63 65 73 73 61 72 79  ion is necessary
b1e0: 0a 20 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 20  .  in order for 
b1f0: 53 51 4c 69 74 65 20 74 6f 20 77 6f 72 6b 20 74  SQLite to work t
b200: 68 6f 73 65 20 70 6c 61 74 66 6f 72 6d 73 2e 20  hose platforms. 
b210: 20 0a 0a 20 20 55 6e 6c 69 6b 65 20 6f 74 68 65   ..  Unlike othe
b220: 72 20 4f 4d 49 54 20 6f 70 74 69 6f 6e 73 20 77  r OMIT options w
b230: 68 69 63 68 20 6d 61 6b 65 20 74 68 65 20 53 51  hich make the SQ
b240: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 73 6d 61  Lite library sma
b250: 6c 6c 65 72 2c 0a 20 20 74 68 69 73 20 6f 70 74  ller,.  this opt
b260: 69 6f 6e 20 61 63 74 75 61 6c 6c 79 20 69 6e 63  ion actually inc
b270: 72 65 61 73 65 73 20 74 68 65 20 73 69 7a 65 20  reases the size 
b280: 6f 66 20 53 51 4c 69 74 65 20 61 6e 64 20 6d 61  of SQLite and ma
b290: 6b 65 73 20 69 74 20 72 75 6e 0a 20 20 61 20 6c  kes it run.  a l
b2a0: 69 74 74 6c 65 20 73 6c 6f 77 65 72 2e 20 20 4f  ittle slower.  O
b2b0: 6e 6c 79 20 75 73 65 20 74 68 69 73 20 6f 70 74  nly use this opt
b2c0: 69 6f 6e 20 69 66 20 53 51 4c 69 74 65 20 69 73  ion if SQLite is
b2d0: 20 62 65 69 6e 67 20 62 75 69 6c 74 20 66 6f 72   being built for
b2e0: 20 61 6e 0a 20 20 65 6d 62 65 64 64 65 64 20 74   an.  embedded t
b2f0: 61 72 67 65 74 20 74 68 61 74 20 64 6f 65 73 20  arget that does 
b300: 6e 6f 74 20 73 75 70 70 6f 72 74 20 57 53 44 2e  not support WSD.
b310: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
b320: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
b330: 58 46 45 52 5f 4f 50 54 7d 20 7b 0a 20 20 54 68  XFER_OPT} {.  Th
b340: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20  is option omits 
b350: 73 75 70 70 6f 72 74 20 66 6f 72 20 6f 70 74 69  support for opti
b360: 6d 69 7a 61 74 69 6f 6e 73 20 74 68 61 74 20 68  mizations that h
b370: 65 6c 70 20 73 74 61 74 65 6d 65 6e 74 73 0a 20  elp statements. 
b380: 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 22 49 4e   of the form "IN
b390: 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45  SERT INTO ... SE
b3a0: 4c 45 43 54 20 2e 2e 2e 22 20 72 75 6e 20 66 61  LECT ..." run fa
b3b0: 73 74 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ster..}..COMPILE
b3c0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
b3d0: 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 7d 20 7b 0a 20  ZERO_MALLOC} {. 
b3e0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69   This option omi
b3f0: 74 73 20 62 6f 74 68 20 74 68 65 20 5b 64 65 66  ts both the [def
b400: 61 75 6c 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  ault memory allo
b410: 63 61 74 6f 72 5d 20 61 6e 64 20 74 68 65 0a 20  cator] and the. 
b420: 20 5b 64 65 62 75 67 67 69 6e 67 20 6d 65 6d 6f   [debugging memo
b430: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 20 66 72  ry allocator] fr
b440: 6f 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64  om the build and
b450: 20 73 75 62 73 74 69 74 75 74 65 73 20 61 20 73   substitutes a s
b460: 74 75 62 0a 20 20 6d 65 6d 6f 72 79 20 61 6c 6c  tub.  memory all
b470: 6f 63 61 74 6f 72 20 74 68 61 74 20 61 6c 77 61  ocator that alwa
b480: 79 73 20 66 61 69 6c 73 2e 20 20 53 51 4c 69 74  ys fails.  SQLit
b490: 65 20 77 69 6c 6c 20 6e 6f 74 20 72 75 6e 20 77  e will not run w
b4a0: 69 74 68 20 74 68 69 73 0a 20 20 73 74 75 62 20  ith this.  stub 
b4b0: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72  memory allocator
b4c0: 20 73 69 6e 63 65 20 69 74 20 77 69 6c 6c 20 62   since it will b
b4d0: 65 20 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f  e unable to allo
b4e0: 63 61 74 65 20 6d 65 6d 6f 72 79 2e 20 20 42 75  cate memory.  Bu
b4f0: 74 0a 20 20 74 68 69 73 20 73 74 75 62 20 63 61  t.  this stub ca
b500: 6e 20 62 65 20 72 65 70 6c 61 63 65 64 20 61 74  n be replaced at
b510: 20 73 74 61 72 74 2d 74 69 6d 65 20 75 73 69 6e   start-time usin
b520: 67 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e  g.  [sqlite3_con
b530: 66 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43 4f 4e  fig]([SQLITE_CON
b540: 46 49 47 5f 4d 41 4c 4c 4f 43 5d 2c 2e 2e 2e 29  FIG_MALLOC],...)
b550: 20 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33 5f 63   or.  [sqlite3_c
b560: 6f 6e 66 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43  onfig]([SQLITE_C
b570: 4f 4e 46 49 47 5f 48 45 41 50 5d 2c 2e 2e 2e 29  ONFIG_HEAP],...)
b580: 2e 0a 20 20 53 6f 20 74 68 65 20 6e 65 74 20 65  ..  So the net e
b590: 66 66 65 63 74 20 6f 66 20 74 68 69 73 20 63 6f  ffect of this co
b5a0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
b5b0: 6e 20 69 73 20 74 68 61 74 20 69 74 20 61 6c 6c  n is that it all
b5c0: 6f 77 73 20 53 51 4c 69 74 65 0a 20 20 74 6f 20  ows SQLite.  to 
b5d0: 62 65 20 63 6f 6d 70 69 6c 65 64 20 61 6e 64 20  be compiled and 
b5e0: 6c 69 6e 6b 65 64 20 61 67 61 69 6e 73 74 20 61  linked against a
b5f0: 20 73 79 73 74 65 6d 20 6c 69 62 72 61 72 79 20   system library 
b600: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75  that does not su
b610: 70 70 6f 72 74 0a 20 20 6d 61 6c 6c 6f 63 28 29  pport.  malloc()
b620: 2c 20 66 72 65 65 28 29 2c 20 61 6e 64 2f 6f 72  , free(), and/or
b630: 20 72 65 61 6c 6c 6f 63 28 29 2e 0a 7d 0a 0a 3c   realloc()..}..<
b640: 2f 74 63 6c 3e 0a 3c 61 20 6e 61 6d 65 3d 22 64  /tcl>.<a name="d
b650: 65 62 75 67 6f 70 74 69 6f 6e 73 22 3e 3c 2f 61  ebugoptions"></a
b660: 3e 0a 3c 68 32 3e 31 2e 37 20 41 6e 61 6c 79 73  >.<h2>1.7 Analys
b670: 69 73 20 61 6e 64 20 44 65 62 75 67 67 69 6e 67  is and Debugging
b680: 20 4f 70 74 69 6f 6e 73 3c 2f 68 32 3e 0a 3c 74   Options</h2>.<t
b690: 63 6c 3e 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  cl>..COMPILE_OPT
b6a0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 42 55  ION {SQLITE_DEBU
b6b0: 47 7d 20 7b 0a 20 20 54 68 65 20 53 51 4c 69 74  G} {.  The SQLit
b6c0: 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 63 6f  e source code co
b6d0: 6e 74 61 69 6e 73 20 6c 69 74 65 72 61 6c 6c 79  ntains literally
b6e0: 20 74 68 6f 75 73 61 6e 64 73 20 6f 66 20 61 73   thousands of as
b6f0: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74  sert() statement
b700: 73 0a 20 20 75 73 65 64 20 74 6f 20 76 65 72 69  s.  used to veri
b710: 66 79 20 69 6e 74 65 72 6e 61 6c 20 61 73 73 75  fy internal assu
b720: 6d 70 74 69 6f 6e 73 20 61 6e 64 20 73 75 62 72  mptions and subr
b730: 6f 75 74 69 6e 65 20 70 72 65 63 6f 6e 64 69 74  outine precondit
b740: 69 6f 6e 73 20 61 6e 64 0a 20 20 70 6f 73 74 63  ions and.  postc
b750: 6f 6e 64 69 74 69 6f 6e 73 2e 20 20 54 68 65 73  onditions.  Thes
b760: 65 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65  e assert() state
b770: 6d 65 6e 74 73 20 61 72 65 20 6e 6f 72 6d 61 6c  ments are normal
b780: 6c 79 20 74 75 72 6e 65 64 20 6f 66 66 0a 20 20  ly turned off.  
b790: 28 74 68 65 79 20 67 65 6e 65 72 61 74 65 20 6e  (they generate n
b7a0: 6f 20 63 6f 64 65 29 20 73 69 6e 63 65 20 74 75  o code) since tu
b7b0: 72 6e 69 6e 67 20 74 68 65 6d 20 6f 6e 20 6d 61  rning them on ma
b7c0: 6b 65 73 20 53 51 4c 69 74 65 20 72 75 6e 20 61  kes SQLite run a
b7d0: 70 70 72 6f 78 69 6d 61 74 65 6c 79 0a 20 20 74  pproximately.  t
b7e0: 68 72 65 65 20 74 69 6d 65 73 20 73 6c 6f 77 65  hree times slowe
b7f0: 72 2e 20 20 42 75 74 20 66 6f 72 20 74 65 73 74  r.  But for test
b800: 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73  ing and analysis
b810: 2c 20 69 74 20 69 73 20 75 73 65 66 75 6c 20 74  , it is useful t
b820: 6f 20 74 75 72 6e 0a 20 20 74 68 65 20 61 73 73  o turn.  the ass
b830: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73  ert() statements
b840: 20 6f 6e 2e 20 20 54 68 65 20 53 51 4c 49 54 45   on.  The SQLITE
b850: 5f 44 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74  _DEBUG compile-t
b860: 69 6d 65 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20  ime option does 
b870: 74 68 69 73 2e 0a 20 20 53 51 4c 49 54 45 5f 44  this..  SQLITE_D
b880: 45 42 55 47 20 61 6c 73 6f 20 74 75 72 6e 73 20  EBUG also turns 
b890: 6f 6e 20 73 6f 6d 65 20 6f 74 68 65 72 20 64 65  on some other de
b8a0: 62 75 67 67 69 6e 67 20 66 65 61 74 75 72 65 73  bugging features
b8b0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
b8c0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4d 45 4d 44  ION {SQLITE_MEMD
b8d0: 45 42 55 47 7d 20 7b 0a 20 20 54 68 65 20 53 51  EBUG} {.  The SQ
b8e0: 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 6f 70  LITE_MEMDEBUG op
b8f0: 74 69 6f 6e 20 63 61 75 73 65 73 20 61 6e 20 69  tion causes an i
b900: 6e 73 74 72 75 6d 65 6e 74 65 64 20 0a 20 20 5b  nstrumented .  [
b910: 64 65 62 75 67 67 69 6e 67 20 6d 65 6d 6f 72 79  debugging memory
b920: 20 61 6c 6c 6f 63 61 74 6f 72 5d 0a 20 20 74 6f   allocator].  to
b930: 20 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20   be used as the 
b940: 64 65 66 61 75 6c 74 20 6d 65 6d 6f 72 79 20 61  default memory a
b950: 6c 6c 6f 63 61 74 6f 72 20 77 69 74 68 69 6e 20  llocator within 
b960: 53 51 4c 69 74 65 2e 20 20 54 68 65 0a 20 20 69  SQLite.  The.  i
b970: 6e 73 74 72 75 6d 65 6e 74 65 64 20 6d 65 6d 6f  nstrumented memo
b980: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 63 68 65  ry allocator che
b990: 63 6b 73 20 66 6f 72 20 6d 69 73 75 73 65 20 6f  cks for misuse o
b9a0: 66 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 61 6c  f dynamically al
b9b0: 6c 6f 63 61 74 65 64 0a 20 20 6d 65 6d 6f 72 79  located.  memory
b9c0: 2e 20 20 45 78 61 6d 70 6c 65 73 20 6f 66 20 6d  .  Examples of m
b9d0: 69 73 75 73 65 20 69 6e 63 6c 75 64 65 20 75 73  isuse include us
b9e0: 69 6e 67 20 6d 65 6d 6f 72 79 20 61 66 74 65 72  ing memory after
b9f0: 20 69 74 20 69 73 20 66 72 65 65 64 2c 0a 20 20   it is freed,.  
ba00: 77 72 69 74 69 6e 67 20 6f 66 66 20 74 68 65 20  writing off the 
ba10: 65 6e 64 73 20 6f 66 20 61 20 6d 65 6d 6f 72 79  ends of a memory
ba20: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 20 66 72 65   allocation, fre
ba30: 65 69 6e 67 20 6d 65 6d 6f 72 79 20 6e 6f 74 20  eing memory not 
ba40: 70 72 65 76 69 6f 75 73 6c 79 0a 20 20 6f 62 74  previously.  obt
ba50: 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 6d  ained from the m
ba60: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 2c  emory allocator,
ba70: 20 6f 72 20 66 61 69 6c 69 6e 67 20 74 6f 20 69   or failing to i
ba80: 6e 69 74 69 61 6c 69 7a 65 20 6e 65 77 6c 79 0a  nitialize newly.
ba90: 20 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f    allocated memo
baa0: 72 79 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a        ry..}..</tcl>.