libfossil  Hex Artifact Content

Artifact 75b84a985137ca5dae1948f81603b2cc7218c518:

Wiki page [building] by stephan 2014-02-26 17:12:27.
0000: 44 20 32 30 31 34 2d 30 32 2d 32 36 54 31 37 3a  D 2014-02-26T17:
0010: 31 32 3a 32 37 2e 34 30 33 0a 4c 20 62 75 69 6c  12:27.403.L buil
0020: 64 69 6e 67 0a 50 20 66 63 66 62 33 35 33 65 33  ding.P fcfb353e3
0030: 65 36 37 34 34 34 62 36 33 39 37 32 31 61 38 63  e67444b639721a8c
0040: 36 30 30 33 66 38 61 31 32 30 64 62 66 33 31 0a  6003f8a120dbf31.
0050: 55 20 73 74 65 70 68 61 6e 0a 57 20 33 39 39 36  U stephan.W 3996
0060: 0a 3c 68 31 3e 42 75 69 6c 64 69 6e 67 20 6c 69  .<h1>Building li
0070: 62 66 6f 73 73 69 6c 3c 2f 68 31 3e 0d 0a 0d 0a  bfossil</h1>....
0080: 53 65 65 20 61 6c 73 6f 3a 20 5b 41 6d 61 6c 67  See also: [Amalg
0090: 61 6d 61 74 69 6f 6e 42 75 69 6c 64 5d 0d 0a 0d  amationBuild]...
00a0: 0a 6c 69 62 66 6f 73 73 69 6c 27 73 20 63 61 6e  .libfossil's can
00b0: 6f 6e 69 63 61 6c 20 62 75 69 6c 64 20 73 79 73  onical build sys
00c0: 74 65 6d 20 69 73 20 63 75 72 72 65 6e 74 6c 79  tem is currently
00d0: 20 61 69 6d 65 64 20 61 74 20 70 6c 61 74 66 6f   aimed at platfo
00e0: 72 6d 73 20 68 6f 73 74 69 6e 67 20 47 4e 55 20  rms hosting GNU 
00f0: 4d 61 6b 65 20 33 2e 38 31 20 6f 72 20 6e 65 77  Make 3.81 or new
0100: 65 72 20 28 6d 6f 73 74 20 72 65 6c 61 74 69 76  er (most relativ
0110: 65 6c 79 20 72 65 63 65 6e 74 20 70 6c 61 74 66  ely recent platf
0120: 6f 72 6d 73 20 68 61 76 65 20 33 2e 38 31 2c 20  orms have 3.81, 
0130: 74 68 6f 75 67 68 20 73 6f 6d 65 20 6e 61 6d 65  though some name
0140: 20 69 74 20 27 67 6d 61 6b 65 27 20 69 6e 73 74   it 'gmake' inst
0150: 65 61 64 20 6f 66 20 27 6d 61 6b 65 27 29 2e 0d  ead of 'make')..
0160: 0a 0d 0a 3c 73 74 72 6f 6e 67 3e 50 72 65 72 65  ...<strong>Prere
0170: 71 75 69 73 69 74 65 73 3a 3c 2f 73 74 72 6f 6e  quisites:</stron
0180: 67 3e 20 6c 69 62 66 6f 73 73 69 6c 20 72 65 71  g> libfossil req
0190: 75 69 72 65 73 20 74 68 61 74 20 3c 74 74 3e 7a  uires that <tt>z
01a0: 6c 69 62 3c 2f 74 74 3e 2c 20 62 6f 74 68 20 74  lib</tt>, both t
01b0: 68 65 20 6c 69 62 72 61 72 79 20 61 6e 64 20 68  he library and h
01c0: 65 61 64 65 72 73 2c 20 62 65 20 69 6e 73 74 61  eaders, be insta
01d0: 6c 6c 65 64 20 61 74 20 74 68 65 20 73 79 73 74  lled at the syst
01e0: 65 6d 20 6c 65 76 65 6c 20 28 77 68 65 72 65 20  em level (where 
01f0: 74 68 65 79 20 6e 6f 72 6d 61 6c 6c 79 20 61 72  they normally ar
0200: 65 29 2e 0d 0a 0d 0a 54 68 65 20 66 69 72 73 74  e).....The first
0210: 20 73 74 65 70 20 69 73 20 74 6f 20 63 6f 6e 66   step is to conf
0220: 69 67 75 72 65 20 74 68 65 20 62 75 69 6c 64 20  igure the build 
0230: 74 72 65 65 2c 20 77 68 69 63 68 20 67 65 6e 65  tree, which gene
0240: 72 61 74 65 73 20 73 6f 6d 65 20 63 6f 6e 66 69  rates some confi
0250: 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6d 61 6b  guration and mak
0260: 65 66 69 6c 65 73 3a 0d 0a 0d 0a 3c 6e 6f 77 69  efiles:....<nowi
0270: 6b 69 3e 3c 70 72 65 3e 0d 0a 24 20 2e 2f 63 6f  ki><pre>..$ ./co
0280: 6e 66 69 67 75 72 65 0d 0a 3c 2f 70 72 65 3e 3c  nfigure..</pre><
0290: 2f 6e 6f 77 69 6b 69 3e 0d 0a 0d 0a 50 61 73 73  /nowiki>....Pass
02a0: 20 69 74 20 74 68 65 20 3c 74 74 3e 2d 2d 68 65   it the <tt>--he
02b0: 6c 70 3c 2f 74 74 3e 20 6f 70 74 69 6f 6e 20 66  lp</tt> option f
02c0: 6f 72 20 74 68 65 20 6c 69 73 74 20 6f 66 20 6f  or the list of o
02d0: 70 74 69 6f 6e 73 2c 20 62 75 74 20 6e 6f 6e 65  ptions, but none
02e0: 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 6e 65   are normally ne
02f0: 65 64 65 64 2e 0d 0a 0d 0a 54 6f 20 63 68 61 6e  eded.....To chan
0300: 67 65 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 2c  ge the compiler,
0310: 20 70 61 73 73 20 3c 74 74 3e 43 43 3d 63 6f 6d   pass <tt>CC=com
0320: 70 69 6c 65 72 2d 6e 61 6d 65 3c 2f 74 74 3e 20  piler-name</tt> 
0330: 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61  to the configura
0340: 74 69 6f 6e 20 73 63 72 69 70 74 2e 20 49 74 20  tion script. It 
0350: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 6b 6e 6f  is currently kno
0360: 77 6e 20 74 6f 20 62 75 69 6c 64 20 63 6c 65 61  wn to build clea
0370: 6e 6c 79 20 77 69 74 68 20 67 63 63 2c 20 63 6c  nly with gcc, cl
0380: 61 6e 67 2c 20 61 6e 64 20 74 63 63 20 6f 6e 20  ang, and tcc on 
0390: 78 36 34 20 61 6e 64 20 69 33 38 36 20 4c 69 6e  x64 and i386 Lin
03a0: 75 78 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 68  ux. Note that th
03b0: 65 20 6d 61 6b 65 66 69 6c 65 73 20 74 77 65 61  e makefiles twea
03c0: 6b 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 66  k the compiler f
03d0: 6c 61 67 73 20 66 6f 72 20 74 68 6f 73 65 20 70  lags for those p
03e0: 61 72 74 69 63 75 6c 61 72 20 63 6f 6d 70 69 6c  articular compil
03f0: 65 72 73 2c 20 61 6e 64 20 6d 61 79 20 6e 65 65  ers, and may nee
0400: 64 20 73 69 6d 69 6c 61 72 20 74 77 65 61 6b 73  d similar tweaks
0410: 20 66 6f 72 20 6f 74 68 65 72 20 63 6f 6d 70 69   for other compi
0420: 6c 65 72 73 20 20 28 73 65 65 20 3c 74 74 3e 63  lers  (see <tt>c
0430: 6f 6e 66 69 67 2e 6d 61 6b 65 2e 69 6e 3c 2f 74  onfig.make.in</t
0440: 74 3e 29 2e 20 57 68 65 6e 20 75 73 69 6e 67 20  t>). When using 
0450: 63 6c 61 6e 67 20 69 74 20 6d 69 67 68 74 20 62  clang it might b
0460: 65 20 75 73 65 66 75 6c 20 74 6f 20 70 61 73 73  e useful to pass
0470: 20 3c 74 74 3e 43 43 3d 27 63 6c 61 6e 67 20 2d   <tt>CC='clang -
0480: 66 6e 6f 2d 63 6f 6c 6f 72 2d 64 69 61 67 6e 6f  fno-color-diagno
0490: 73 74 69 63 73 27 3c 2f 74 74 3e 20 74 6f 20 64  stics'</tt> to d
04a0: 69 73 61 62 6c 65 20 63 6f 6c 6f 72 20 6f 75 74  isable color out
04b0: 70 75 74 2e 20 4e 6f 72 6d 61 6c 6c 79 20 63 6c  put. Normally cl
04c0: 61 6e 67 20 64 65 74 65 63 74 73 20 74 68 61 74  ang detects that
04d0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2c 20   automatically, 
04e0: 62 75 74 20 69 74 20 6d 69 73 2d 64 65 74 65 63  but it mis-detec
04f0: 74 73 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e  ts when compilin
0500: 67 20 66 72 6f 6d 20 78 65 6d 61 63 73 20 61 6e  g from xemacs an
0510: 64 20 74 68 65 20 63 6f 6c 6f 72 20 63 6f 64 65  d the color code
0520: 73 20 62 72 65 61 6b 20 78 65 6d 61 63 73 27 20  s break xemacs' 
0530: 75 6e 64 65 72 73 74 61 6e 64 69 6e 67 20 6f 66  understanding of
0540: 20 74 68 65 20 6f 75 74 70 75 74 2e 0d 0a 0d 0a   the output.....
0550: 54 6f 20 62 75 69 6c 64 20 69 74 3a 0d 0a 0d 0a  To build it:....
0560: 3c 6e 6f 77 69 6b 69 3e 3c 70 72 65 3e 0d 0a 24  <nowiki><pre>..$
0570: 20 6d 61 6b 65 20 23 20 6f 72 20 67 6d 61 6b 65   make # or gmake
0580: 0d 0a 3c 2f 70 72 65 3e 3c 2f 6e 6f 77 69 6b 69  ..</pre></nowiki
0590: 3e 0d 0a 0d 0a 54 68 61 74 20 77 69 6c 6c 20 63  >....That will c
05a0: 6f 6d 70 69 6c 65 20 74 68 65 20 6c 69 62 72 61  ompile the libra
05b0: 72 79 20 61 6e 64 20 5b 66 2d 74 6f 6f 6c 73 20  ry and [f-tools 
05c0: 7c 20 61 20 66 65 77 20 73 61 6d 70 6c 65 2f 74  | a few sample/t
05d0: 65 73 74 2f 64 65 6d 6f 20 61 70 70 6c 69 63 61  est/demo applica
05e0: 74 69 6f 6e 73 5d 2e 20 42 65 20 63 61 72 65 66  tions]. Be caref
05f0: 75 6c 20 77 69 74 68 20 74 68 65 6d 20 2d 20 73  ul with them - s
0600: 6f 6d 65 20 6d 6f 64 69 66 79 20 74 68 65 20 72  ome modify the r
0610: 65 70 6f 73 69 74 6f 72 79 20 28 62 75 74 20 6e  epository (but n
0620: 65 76 65 72 20 77 69 74 68 6f 75 74 20 62 65 69  ever without bei
0630: 6e 67 20 74 6f 6c 64 20 74 6f 29 2e 0d 0a 0d 0a  ng told to).....
0640: 3c 68 32 3e 52 75 6e 6e 69 6e 67 20 54 65 73 74  <h2>Running Test
0650: 73 3c 2f 68 32 3e 0d 0a 0d 0a 54 68 65 20 6d 61  s</h2>....The ma
0660: 6a 6f 72 69 74 79 20 6f 66 20 74 68 65 20 6c 69  jority of the li
0670: 62 72 61 72 79 27 73 20 66 75 6e 63 74 69 6f 6e  brary's function
0680: 61 6c 69 74 79 20 69 73 20 65 69 74 68 65 72 20  ality is either 
0690: 63 6f 76 65 72 65 64 20 62 79 20 75 6e 69 74 20  covered by unit 
06a0: 74 65 73 74 73 20 6f 72 20 74 65 73 74 65 64 20  tests or tested 
06b0: 69 6e 64 69 72 65 63 74 6c 79 20 76 69 61 20 75  indirectly via u
06c0: 6e 69 74 20 74 65 73 74 73 2e 20 54 68 65 20 72  nit tests. The r
06d0: 65 6d 61 69 6e 69 6e 67 20 66 75 6e 63 74 69 6f  emaining functio
06e0: 6e 61 6c 69 74 79 20 28 77 68 69 63 68 20 63 61  nality (which ca
06f0: 6e 6e 6f 74 20 62 65 20 65 61 73 69 6c 79 20 74  nnot be easily t
0700: 65 73 74 65 64 20 77 69 74 68 6f 75 74 20 6d 6f  ested without mo
0710: 64 69 66 79 69 6e 67 20 74 68 65 20 72 65 70 6f  difying the repo
0720: 29 20 69 73 20 74 65 73 74 65 64 20 76 69 61 20  ) is tested via 
0730: 5b 66 2d 74 6f 6f 6c 73 7c 76 61 72 69 6f 75 73  [f-tools|various
0740: 20 61 70 70 73 5d 2e 0d 0a 0d 0a 54 68 65 20 6d   apps].....The m
0750: 6f 73 74 20 66 75 6e 64 61 6d 65 6e 74 61 6c 20  ost fundamental 
0760: 6f 66 20 74 68 65 20 73 61 6e 69 74 79 20 74 65  of the sanity te
0770: 73 74 73 20 69 73 20 74 68 65 20 61 70 74 6c 79  sts is the aptly
0780: 2d 6e 61 6d 65 64 20 3c 74 74 3e 66 2d 73 61 6e  -named <tt>f-san
0790: 69 74 79 3c 2f 74 74 3e 2c 20 77 68 69 63 68 20  ity</tt>, which 
07a0: 63 61 6e 20 62 65 20 75 73 65 64 20 6c 69 6b 65  can be used like
07b0: 20 74 68 69 73 3a 0d 0a 0d 0a 3c 6e 6f 77 69 6b   this:....<nowik
07c0: 69 3e 3c 70 72 65 3e 0d 0a 24 20 63 64 20 66 2d  i><pre>..$ cd f-
07d0: 61 70 70 73 0d 0a 24 20 6d 61 6b 65 20 23 20 6f  apps..$ make # o
07e0: 72 20 67 6d 61 6b 65 0d 0a 24 20 2e 2f 66 2d 73  r gmake..$ ./f-s
07f0: 61 6e 69 74 79 0d 0a 3c 2f 70 72 65 3e 3c 2f 6e  anity..</pre></n
0800: 6f 77 69 6b 69 3e 0d 0a 0d 0a 49 66 20 74 68 61  owiki>....If tha
0810: 74 20 72 75 6e 73 20 74 6f 20 63 6f 6d 70 6c 65  t runs to comple
0820: 74 69 6f 6e 2c 20 77 69 74 68 6f 75 74 20 74 72  tion, without tr
0830: 69 67 67 65 72 69 6e 67 20 61 6e 20 65 78 63 65  iggering an exce
0840: 70 74 69 6f 6e 2c 20 74 68 65 20 62 61 73 69 63  ption, the basic
0850: 20 73 61 6e 69 74 79 20 74 65 73 74 20 6c 6f 6f   sanity test loo
0860: 6b 73 20 67 6f 6f 64 2e 20 54 6f 20 62 65 20 73  ks good. To be s
0870: 75 72 65 2c 20 74 68 6f 75 67 68 2c 20 69 74 20  ure, though, it 
0880: 61 6c 73 6f 20 73 68 6f 75 6c 64 20 62 65 20 72  also should be r
0890: 75 6e 20 74 68 72 6f 75 67 68 20 76 61 6c 67 72  un through valgr
08a0: 69 6e 64 3a 0d 0a 0d 0a 3c 6e 6f 77 69 6b 69 3e  ind:....<nowiki>
08b0: 3c 70 72 65 3e 0d 0a 24 20 76 61 6c 67 72 69 6e  <pre>..$ valgrin
08c0: 64 20 2d 2d 6c 65 61 6b 2d 63 68 65 63 6b 3d 66  d --leak-check=f
08d0: 75 6c 6c 20 2d 76 20 2d 2d 73 68 6f 77 2d 72 65  ull -v --show-re
08e0: 61 63 68 61 62 6c 65 3d 79 65 73 20 2d 2d 74 72  achable=yes --tr
08f0: 61 63 6b 2d 6f 72 69 67 69 6e 73 3d 79 65 73 20  ack-origins=yes 
0900: 2e 2f 66 2d 73 61 6e 69 74 79 0d 0a 3c 2f 70 72  ./f-sanity..</pr
0910: 65 3e 3c 2f 6e 6f 77 69 6b 69 3e 0d 0a 0d 0a 49  e></nowiki>....I
0920: 66 20 62 6f 74 68 20 6f 66 20 74 68 6f 73 65 20  f both of those 
0930: 72 75 6e 20 74 6f 20 63 6f 6d 70 6c 65 74 69 6f  run to completio
0940: 6e 20 77 69 74 68 6f 75 74 20 74 72 69 67 67 65  n without trigge
0950: 72 69 6e 67 20 61 6e 20 65 78 63 65 70 74 69 6f  ring an exceptio
0960: 6e 2c 20 6c 65 61 6b 2c 20 6f 72 20 6d 65 6d 6f  n, leak, or memo
0970: 72 79 20 75 73 61 67 65 20 76 69 6f 6c 61 74 69  ry usage violati
0980: 6f 6e 2c 20 22 74 68 65 20 77 6f 72 6c 64 20 69  on, "the world i
0990: 73 20 72 6f 75 6e 64 2e 22 20 4e 6f 74 65 20 74  s round." Note t
09a0: 68 61 74 20 69 66 20 61 6e 20 61 73 73 65 72 74  hat if an assert
09b0: 69 6f 6e 20 69 73 20 74 72 69 67 67 65 72 65 64  ion is triggered
09c0: 2c 20 76 61 6c 67 72 69 6e 64 20 3c 65 6d 3e 77  , valgrind <em>w
09d0: 69 6c 6c 3c 2f 65 6d 3e 20 72 65 70 6f 72 74 20  ill</em> report 
09e0: 6d 61 6e 79 20 6c 65 61 6b 73 20 61 73 20 61 20  many leaks as a 
09f0: 73 69 64 65 2d 65 66 66 65 63 74 2c 20 73 6f 20  side-effect, so 
0a00: 66 69 72 73 74 20 6d 61 6b 65 20 73 75 72 65 20  first make sure 
0a10: 69 74 20 72 75 6e 73 20 61 73 73 65 72 74 69 6f  it runs assertio
0a20: 6e 2d 66 72 65 65 20 77 69 74 68 6f 75 74 20 76  n-free without v
0a30: 61 6c 67 72 69 6e 64 2e 0d 0a 0d 0a 4f 6e 20 55  algrind.....On U
0a40: 6e 69 78 2d 6c 69 6b 65 20 73 79 73 74 65 6d 73  nix-like systems
0a50: 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 70 6f   it should be po
0a60: 73 73 69 62 6c 65 20 74 6f 20 62 75 69 6c 64 20  ssible to build 
0a70: 74 68 65 20 5b 74 68 31 69 73 68 7c 74 68 31 69  the [th1ish|th1i
0a80: 73 68 20 73 63 72 69 70 74 20 62 69 6e 64 69 6e  sh script bindin
0a90: 67 73 5d 20 61 6e 64 20 72 75 6e 20 74 68 6f 73  gs] and run thos
0aa0: 65 20 75 6e 69 74 20 74 65 73 74 73 3a 0d 0a 0d  e unit tests:...
0ab0: 0a 3c 6e 6f 77 69 6b 69 3e 3c 70 72 65 3e 0d 0a  .<nowiki><pre>..
0ac0: 24 20 63 64 20 74 68 31 69 73 68 0d 0a 24 20 6d  $ cd th1ish..$ m
0ad0: 61 6b 65 20 23 20 6f 72 20 67 6d 61 6b 65 0d 0a  ake # or gmake..
0ae0: 24 20 6d 61 6b 65 20 75 6e 69 74 20 23 20 72 75  $ make unit # ru
0af0: 6e 73 20 74 68 65 20 75 6e 69 74 20 74 65 73 74  ns the unit test
0b00: 73 0d 0a 24 20 6d 61 6b 65 20 76 67 20 23 20 72  s..$ make vg # r
0b10: 75 6e 73 20 74 68 65 20 75 6e 69 74 20 74 65 73  uns the unit tes
0b20: 74 73 20 74 68 72 6f 75 67 68 20 76 61 6c 67 72  ts through valgr
0b30: 69 6e 64 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  ind,..          
0b40: 23 20 63 6f 6d 70 6c 61 69 6e 69 6e 67 20 69 66  # complaining if
0b50: 20 69 74 20 66 69 6e 64 73 20 70 72 6f 62 6c 65   it finds proble
0b60: 6d 73 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 23  ms...          #
0b70: 20 41 6c 73 6f 20 63 6f 6c 6c 65 63 74 73 20 6d   Also collects m
0b80: 65 6d 6f 72 79 20 73 74 61 74 73 20 74 6f 20 61  emory stats to a
0b90: 20 43 53 56 20 66 69 6c 65 2e 0d 0a 3c 2f 70 72   CSV file...</pr
0ba0: 65 3e 3c 2f 6e 6f 77 69 6b 69 3e 0d 0a 0d 0a 41  e></nowiki>....A
0bb0: 67 61 69 6e 2c 20 69 66 20 74 68 6f 73 65 20 64  gain, if those d
0bc0: 6f 6e 27 74 20 63 6f 6d 70 6c 61 69 6e 20 74 68  on't complain th
0bd0: 65 6e 20 74 68 65 20 77 6f 72 6c 64 20 69 73 20  en the world is 
0be0: 28 73 74 69 6c 6c 29 20 72 6f 75 6e 64 2e 20 49  (still) round. I
0bf0: 66 20 79 6f 75 20 3c 65 6d 3e 72 65 61 6c 6c 79  f you <em>really
0c00: 3c 2f 65 6d 3e 20 77 61 6e 74 20 74 6f 20 73 74  </em> want to st
0c10: 72 65 73 73 2d 74 65 73 74 20 74 68 65 20 63 6f  ress-test the co
0c20: 72 65 20 63 77 61 6c 2f 74 68 31 69 73 68 20 65  re cwal/th1ish e
0c30: 6e 67 69 6e 65 2c 20 74 72 79 20 72 75 6e 6e 69  ngine, try runni
0c40: 6e 67 20 74 68 65 20 3c 74 74 3e 76 67 73 3c 2f  ng the <tt>vgs</
0c50: 74 74 3e 2c 20 3c 74 74 3e 76 67 72 3c 2f 74 74  tt>, <tt>vgr</tt
0c60: 3e 2c 20 3c 74 74 3e 76 67 74 3c 2f 74 74 3e 2c  >, <tt>vgt</tt>,
0c70: 20 61 6e 64 20 3c 74 74 3e 76 67 72 73 74 3c 2f   and <tt>vgrst</
0c80: 74 74 3e 20 74 61 72 67 65 74 73 2c 20 61 6c 6c  tt> targets, all
0c90: 20 6f 66 20 77 68 69 63 68 20 64 6f 20 74 68 65   of which do the
0ca0: 20 73 61 6d 65 20 61 73 20 3c 74 74 3e 76 67 3c   same as <tt>vg<
0cb0: 2f 74 74 3e 20 62 75 74 20 64 69 73 61 62 6c 65  /tt> but disable
0cc0: 20 64 69 66 66 65 72 65 6e 74 20 72 65 63 79 63   different recyc
0cd0: 6c 69 6e 67 20 6f 70 74 69 6f 6e 73 2f 6f 70 74  ling options/opt
0ce0: 69 6d 69 7a 61 74 69 6f 6e 73 20 69 6e 20 74 68  imizations in th
0cf0: 31 69 73 68 2f 63 77 61 6c 2e 20 54 68 65 20 3c  1ish/cwal. The <
0d00: 74 74 3e 76 67 72 73 74 3c 2f 74 74 3e 20 62 75  tt>vgrst</tt> bu
0d10: 69 6c 64 20 64 69 73 61 62 6c 65 73 20 61 6c 6d  ild disables alm
0d20: 6f 73 74 20 65 76 65 72 79 20 6d 65 6d 6f 72 79  ost every memory
0d30: 2d 72 65 6c 61 74 65 64 20 6f 70 74 69 6d 69 7a  -related optimiz
0d40: 61 74 69 6f 6e 20 74 68 65 72 65 20 69 73 2c 20  ation there is, 
0d50: 61 6e 64 20 77 69 6c 6c 20 72 65 70 6f 72 74 20  and will report 
0d60: 3c 65 6d 3e 6d 75 63 68 3c 2f 65 6d 3e 20 68 69  <em>much</em> hi
0d70: 67 68 65 72 20 74 6f 74 61 6c 20 61 6c 6c 6f 63  gher total alloc
0d80: 61 74 69 6f 6e 73 20 61 6e 64 20 6d 65 6d 6f 72  ations and memor
0d90: 79 20 63 6f 73 74 73 20 66 6f 72 20 61 6c 6c 20  y costs for all 
0da0: 62 75 74 20 74 68 65 20 6d 6f 73 74 20 62 61 73  but the most bas
0db0: 69 63 20 73 63 72 69 70 74 73 2e 20 45 61 63 68  ic scripts. Each
0dc0: 20 6f 66 20 74 68 6f 73 65 20 74 61 72 67 65 74   of those target
0dd0: 73 20 67 65 6e 65 72 61 74 65 73 20 61 20 73 65  s generates a se
0de0: 70 61 72 61 74 65 20 43 53 56 20 72 65 70 6f 72  parate CSV repor
0df0: 74 20 77 68 69 63 68 20 63 61 6e 20 74 68 65 6e  t which can then
0e00: 20 62 65 20 70 65 72 75 73 65 64 20 61 6e 64 20   be perused and 
0e10: 73 70 65 63 75 6c 61 74 65 64 20 75 70 6f 6e 20  speculated upon 
0e20: 61 74 20 6f 6e 65 27 73 20 6c 65 69 73 75 72 65  at one's leisure
0e30: 20 28 22 27 69 27 20 62 65 66 6f 72 65 20 27 65   ("'i' before 'e
0e40: 27 2c 20 65 78 63 65 70 74 20 61 66 74 65 72 20  ', except after 
0e50: 27 63 27 2c 20 61 6e 64 20 77 68 65 6e 20 73 6f  'c', and when so
0e60: 75 6e 64 69 6e 67 20 6c 69 6b 65 20 27 61 27 20  unding like 'a' 
0e70: 69 6e 20 27 6e 65 69 67 68 62 6f 72 27 20 61 6e  in 'neighbor' an
0e80: 64 20 27 77 65 69 67 68 27 2e 2e 2e 22 20 61 6e  d 'weigh'..." an
0e90: 64 20 6c 65 69 73 75 72 65 2c 20 61 70 70 61 72  d leisure, appar
0ea0: 65 6e 74 6c 79 29 2e 0d 0a 0d 0a 0d 0a 3c 68 32  ently).......<h2
0eb0: 3e 53 79 73 74 65 6d 20 76 73 2e 20 4c 6f 63 61  >System vs. Loca
0ec0: 6c 20 73 71 6c 69 74 65 33 3c 2f 68 32 3e 0d 0a  l sqlite3</h2>..
0ed0: 0d 0a 42 65 63 61 75 73 65 20 6c 69 62 66 6f 73  ..Because libfos
0ee0: 73 69 6c 20 75 73 65 73 20 62 6c 65 65 64 69 6e  sil uses bleedin
0ef0: 67 2d 65 64 67 65 20 66 65 61 74 75 72 65 73 20  g-edge features 
0f00: 6f 66 20 73 71 6c 69 74 65 33 20 28 6e 61 6d 65  of sqlite3 (name
0f10: 6c 79 20 72 65 63 75 72 73 69 76 65 20 71 75 65  ly recursive que
0f20: 72 69 65 73 29 2c 20 69 74 20 69 6e 63 6c 75 64  ries), it includ
0f30: 65 73 20 69 74 73 20 6f 77 6e 20 63 6f 70 79 20  es its own copy 
0f40: 6f 66 20 73 71 6c 69 74 65 33 20 61 6d 61 6c 67  of sqlite3 amalg
0f50: 61 6d 61 74 69 6f 6e 2e 20 4f 6e 63 65 20 74 68  amation. Once th
0f60: 6f 73 65 20 66 65 61 74 75 72 65 73 20 61 72 65  ose features are
0f70: 20 77 69 64 65 6c 79 20 6f 75 74 20 61 6e 64 20   widely out and 
0f80: 61 62 6f 75 74 20 69 6e 20 74 68 65 20 77 69 6c  about in the wil
0f90: 64 2c 20 77 65 20 63 61 6e 20 72 65 76 65 72 74  d, we can revert
0fa0: 20 74 68 65 20 62 75 69 6c 64 20 70 72 6f 63 65   the build proce
0fb0: 73 73 20 74 6f 20 75 73 65 20 61 20 73 79 73 74  ss to use a syst
0fc0: 65 6d 2d 6c 65 76 65 6c 20 73 71 6c 69 74 65 33  em-level sqlite3
0fd0: 2e 20 41 73 20 6f 66 20 32 30 31 34 30 32 30 31  . As of 20140201
0fe0: 2c 20 69 74 20 72 65 71 75 69 72 65 73 20 73 71  , it requires sq
0ff0: 6c 69 74 65 33 20 33 2e 38 2e 33 2b 2e 0a 5a 20  lite3 3.8.3+..Z 
1000: 33 65 30 39 38 62 36 32 34 65 30 64 35 32 37 64  3e098b624e0d527d
1010: 64 63 61 34 33 62 64 33 61 30 33 37 61 38 65 33  dca43bd3a037a8e3
1020: 0a                                               .