Artifact e172dfa50fe58e59e1ee71792d732baefcb3d8f4:

File www/stats.wiki part of check-in [522824b26a] - Documentation updates, including a big rework of the homepage. by drh on 2009-08-28 16:05:03.

0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 50 65  <title>Fossil Pe
0010: 72 66 6f 72 6d 61 6e 63 65 3c 2f 74 69 74 6c 65  rformance</title
0020: 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e  >.<h1 align="cen
0030: 74 65 72 22 3e 50 65 72 66 6f 72 6d 61 6e 63 65  ter">Performance
0040: 20 53 74 61 74 69 73 74 69 63 73 3c 2f 68 31 3e   Statistics</h1>
0050: 0a 0a 54 68 65 20 71 75 65 73 74 69 6f 6e 73 20  ..The questions 
0060: 77 69 6c 6c 20 69 6e 65 76 69 74 61 62 6c 79 20  will inevitably 
0070: 61 72 69 73 65 3a 20 20 48 6f 77 20 64 6f 65 73  arise:  How does
0080: 20 46 6f 73 73 69 6c 20 70 65 72 66 6f 72 6d 3f   Fossil perform?
0090: 20 0a 44 6f 65 73 20 69 74 20 75 73 65 20 61 20   .Does it use a 
00a0: 6c 6f 74 20 6f 66 20 64 69 73 6b 20 73 70 61 63  lot of disk spac
00b0: 65 20 6f 72 20 62 61 6e 64 77 69 64 74 68 3f 20  e or bandwidth? 
00c0: 20 49 73 20 69 74 20 73 63 61 6c 61 62 6c 65 3f   Is it scalable?
00d0: 0a 0a 49 6e 20 61 6e 20 61 74 74 65 6d 70 74 20  ..In an attempt 
00e0: 74 6f 20 61 6e 73 77 65 72 73 20 74 68 65 73 65  to answers these
00f0: 20 71 75 65 73 74 69 6f 6e 73 2c 20 74 68 69 73   questions, this
0100: 20 72 65 70 6f 72 74 20 6c 6f 6f 6b 73 20 61 74   report looks at
0110: 20 66 69 76 65 0a 70 72 6f 6a 65 63 74 73 20 74   five.projects t
0120: 68 61 74 20 75 73 65 20 66 6f 73 73 69 6c 20 66  hat use fossil f
0130: 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  or configuration
0140: 20 6d 61 6e 61 67 65 6d 65 6e 74 20 61 6e 64 20   management and 
0150: 65 78 61 6d 69 6e 65 73 20 68 6f 77 0a 77 65 6c  examines how.wel
0160: 6c 20 74 68 65 79 20 61 72 65 20 77 6f 72 6b 69  l they are worki
0170: 6e 67 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69  ng.  The followi
0180: 6e 67 20 74 61 62 6c 65 20 69 73 20 61 20 73 75  ng table is a su
0190: 6d 6d 61 72 79 20 6f 66 20 74 68 65 20 72 65 73  mmary of the res
01a0: 75 6c 74 73 2e 0a 45 78 70 6c 61 6e 61 74 69 6f  ults..Explanatio
01b0: 6e 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 66  n and analysis f
01c0: 6f 6c 6c 6f 77 73 20 74 68 65 20 74 61 62 6c 65  ollows the table
01d0: 2e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64 65 72  ...<table border
01e0: 3d 31 3e 0a 3c 74 72 3e 0a 3c 74 68 3e 50 72 6f  =1>.<tr>.<th>Pro
01f0: 6a 65 63 74 3c 2f 74 68 3e 0a 3c 74 68 3e 4e 75  ject</th>.<th>Nu
0200: 6d 62 65 72 20 4f 66 20 41 72 74 69 66 61 63 74  mber Of Artifact
0210: 73 3c 2f 74 68 3e 0a 3c 74 68 3e 4e 75 6d 62 65  s</th>.<th>Numbe
0220: 72 20 4f 66 20 43 68 65 63 6b 2d 69 6e 73 3c 2f  r Of Check-ins</
0230: 74 68 3e 0a 3c 74 68 3e 50 72 6f 6a 65 63 74 26  th>.<th>Project&
0240: 6e 62 73 70 3b 44 75 72 61 74 69 6f 6e 3c 62 72  nbsp;Duration<br
0250: 3e 28 61 73 20 6f 66 20 32 30 30 39 2d 30 38 2d  >(as of 2009-08-
0260: 32 33 29 3c 2f 74 68 3e 0a 3c 74 68 3e 41 76 65  23)</th>.<th>Ave
0270: 72 61 67 65 20 43 68 65 63 6b 2d 69 6e 73 20 50  rage Check-ins P
0280: 65 72 20 44 61 79 3c 2f 74 68 3e 0a 3c 74 68 3e  er Day</th>.<th>
0290: 55 6e 63 6f 6d 70 72 65 73 73 65 64 20 53 69 7a  Uncompressed Siz
02a0: 65 3c 2f 74 68 3e 0a 3c 74 68 3e 52 65 70 6f 73  e</th>.<th>Repos
02b0: 69 74 6f 72 79 20 53 69 7a 65 3c 2f 74 68 3e 0a  itory Size</th>.
02c0: 3c 74 68 3e 43 6f 6d 70 72 65 73 73 69 6f 6e 20  <th>Compression 
02d0: 52 61 74 69 6f 3c 2f 74 68 3e 0a 3c 74 68 3e 43  Ratio</th>.<th>C
02e0: 6c 6f 6e 65 20 42 61 6e 64 77 69 64 74 68 3c 2f  lone Bandwidth</
02f0: 74 68 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 20 61  th>.</tr>..<tr a
0300: 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 0a 3c  lign="center">.<
0310: 74 64 3e 53 51 4c 69 74 65 0a 3c 74 64 3e 32 38  td>SQLite.<td>28
0320: 36 34 33 0a 3c 74 64 3e 36 37 35 35 0a 3c 74 64  643.<td>6755.<td
0330: 3e 33 33 37 33 26 6e 62 73 70 3b 64 61 79 73 3c  >3373&nbsp;days<
0340: 62 72 3e 39 2e 32 34 26 6e 62 73 70 3b 79 72 73  br>9.24&nbsp;yrs
0350: 0a 3c 74 64 3e 32 2e 30 30 0a 3c 74 64 3e 31 2e  .<td>2.00.<td>1.
0360: 32 37 26 6e 62 73 70 3b 47 42 0a 3c 74 64 3e 33  27&nbsp;GB.<td>3
0370: 35 2e 34 26 6e 62 73 70 3b 4d 42 0a 3c 74 64 3e  5.4&nbsp;MB.<td>
0380: 33 35 3a 31 0a 3c 74 64 3e 39 38 32 26 6e 62 73  35:1.<td>982&nbs
0390: 70 3b 4b 42 26 6e 62 73 70 3b 75 70 3c 62 72 3e  p;KB&nbsp;up<br>
03a0: 31 32 2e 34 26 6e 62 73 70 3b 4d 42 26 6e 62 73  12.4&nbsp;MB&nbs
03b0: 70 3b 64 6f 77 6e 0a 3c 2f 74 72 3e 0a 0a 3c 74  p;down.</tr>..<t
03c0: 72 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22  r align="center"
03d0: 3e 0a 3c 74 64 3e 46 6f 73 73 69 6c 0a 3c 74 64  >.<td>Fossil.<td
03e0: 3e 34 39 38 31 0a 3c 74 64 3e 31 32 37 32 0a 3c  >4981.<td>1272.<
03f0: 74 64 3e 37 36 34 26 6e 62 73 70 3b 64 61 79 73  td>764&nbsp;days
0400: 3c 62 72 3e 32 2e 31 26 6e 62 73 70 3b 79 72 73  <br>2.1&nbsp;yrs
0410: 0a 3c 74 64 3e 31 2e 36 36 0a 3c 74 64 3e 31 34  .<td>1.66.<td>14
0420: 34 26 6e 62 73 70 3b 4d 42 0a 3c 74 64 3e 38 2e  4&nbsp;MB.<td>8.
0430: 37 34 26 6e 62 73 70 3b 4d 42 0a 3c 74 64 3e 31  74&nbsp;MB.<td>1
0440: 36 3a 31 0a 3c 74 64 3e 31 32 38 26 6e 62 73 70  6:1.<td>128&nbsp
0450: 3b 4b 42 26 6e 62 73 70 3b 75 70 3c 62 72 3e 34  ;KB&nbsp;up<br>4
0460: 2e 34 39 26 6e 62 73 70 3b 4d 42 26 6e 62 73 70  .49&nbsp;MB&nbsp
0470: 3b 64 6f 77 6e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72  ;down.</tr>..<tr
0480: 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e   align="center">
0490: 0a 3c 74 64 3e 53 4c 54 0a 3c 74 64 3e 32 30 36  .<td>SLT.<td>206
04a0: 32 0a 3c 74 64 3e 36 37 0a 3c 74 64 3e 32 36 36  2.<td>67.<td>266
04b0: 26 6e 62 73 70 3b 64 61 79 73 0a 3c 74 64 3e 30  &nbsp;days.<td>0
04c0: 2e 32 35 0a 3c 74 64 3e 31 2e 37 36 26 6e 62 73  .25.<td>1.76&nbs
04d0: 70 3b 47 42 0a 3c 74 64 3e 31 34 37 26 6e 62 73  p;GB.<td>147&nbs
04e0: 70 3b 4d 42 0a 3c 74 64 3e 31 31 3a 31 0a 3c 74  p;MB.<td>11:1.<t
04f0: 64 3e 31 2e 31 26 6e 62 73 70 3b 4d 42 26 6e 62  d>1.1&nbsp;MB&nb
0500: 73 70 3b 75 70 3c 62 72 3e 31 34 31 26 6e 62 73  sp;up<br>141&nbs
0510: 70 3b 4d 42 26 6e 62 73 70 3b 64 6f 77 6e 0a 3c  p;MB&nbsp;down.<
0520: 2f 74 72 3e 0a 0a 3c 74 72 20 61 6c 69 67 6e 3d  /tr>..<tr align=
0530: 22 63 65 6e 74 65 72 22 3e 0a 3c 74 64 3e 54 48  "center">.<td>TH
0540: 33 0a 3c 74 64 3e 31 39 39 39 0a 3c 74 64 3e 34  3.<td>1999.<td>4
0550: 32 39 0a 3c 74 64 3e 33 33 31 26 6e 62 73 70 3b  29.<td>331&nbsp;
0560: 64 61 79 73 0a 3c 74 64 3e 31 2e 33 30 0a 3c 74  days.<td>1.30.<t
0570: 64 3e 37 30 2e 35 26 6e 62 73 70 3b 4d 42 0a 3c  d>70.5&nbsp;MB.<
0580: 74 64 3e 36 2e 33 26 6e 62 73 70 3b 4d 42 0a 3c  td>6.3&nbsp;MB.<
0590: 74 64 3e 31 31 3a 31 0a 3c 74 64 3e 35 35 26 6e  td>11:1.<td>55&n
05a0: 62 73 70 3b 4b 42 26 6e 62 73 70 3b 75 70 3c 62  bsp;KB&nbsp;up<b
05b0: 72 3e 34 2e 36 36 26 6e 62 73 70 3b 4d 42 26 6e  r>4.66&nbsp;MB&n
05c0: 62 73 70 3b 64 6f 77 6e 0a 3c 2f 74 72 3e 0a 0a  bsp;down.</tr>..
05d0: 3c 74 72 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65  <tr align="cente
05e0: 72 22 3e 0a 3c 74 64 3e 53 51 4c 69 74 65 20 44  r">.<td>SQLite D
05f0: 6f 63 73 0a 3c 74 64 3e 31 37 38 37 0a 3c 74 64  ocs.<td>1787.<td
0600: 3e 34 34 34 0a 3c 74 64 3e 36 35 30 26 6e 62 73  >444.<td>650&nbs
0610: 70 3b 64 61 79 73 3c 62 72 3e 31 2e 37 38 26 6e  p;days<br>1.78&n
0620: 62 73 70 3b 79 72 73 0a 3c 74 64 3e 30 2e 36 38  bsp;yrs.<td>0.68
0630: 0a 3c 74 64 3e 34 33 26 6e 62 73 70 3b 4d 42 0a  .<td>43&nbsp;MB.
0640: 3c 74 64 3e 34 2e 39 26 6e 62 73 70 3b 4d 42 0a  <td>4.9&nbsp;MB.
0650: 3c 74 64 3e 38 3a 31 0a 3c 74 64 3e 34 36 26 6e  <td>8:1.<td>46&n
0660: 62 73 70 3b 4b 42 26 6e 62 73 70 3b 75 70 3c 62  bsp;KB&nbsp;up<b
0670: 72 3e 33 2e 33 35 26 6e 62 73 70 3b 4d 42 26 6e  r>3.35&nbsp;MB&n
0680: 62 73 70 3b 64 6f 77 6e 0a 3c 2f 74 72 3e 0a 0a  bsp;down.</tr>..
0690: 3c 2f 74 61 62 6c 65 3e 0a 0a 3c 68 32 3e 54 68  </table>..<h2>Th
06a0: 65 20 46 69 76 65 20 50 72 6f 6a 65 63 74 73 3c  e Five Projects<
06b0: 2f 68 32 3e 0a 0a 54 68 65 20 66 69 76 65 20 70  /h2>..The five p
06c0: 72 6f 6a 65 63 74 73 20 6c 69 73 74 65 64 20 61  rojects listed a
06d0: 62 6f 76 65 20 77 65 72 65 20 63 68 6f 73 65 6e  bove were chosen
06e0: 20 62 65 63 61 75 73 65 20 74 68 65 79 20 68 61   because they ha
06f0: 76 65 20 62 65 65 6e 20 69 6e 0a 65 78 69 73 74  ve been in.exist
0700: 61 6e 63 65 20 66 6f 72 20 61 20 6c 6f 6e 67 20  ance for a long 
0710: 74 69 6d 65 20 28 72 65 6c 61 74 69 76 65 20 74  time (relative t
0720: 6f 20 74 68 65 20 61 67 65 20 6f 66 20 66 6f 73  o the age of fos
0730: 73 69 6c 29 20 6f 72 20 62 65 63 61 75 73 65 0a  sil) or because.
0740: 74 68 65 79 20 68 61 76 65 20 6c 61 72 67 65 73  they have larges
0750: 20 61 6d 6f 75 6e 74 73 20 6f 66 20 63 6f 6e 74   amounts of cont
0760: 65 6e 74 2e 20 20 54 68 65 20 6d 6f 73 74 20 69  ent.  The most i
0770: 6d 70 6f 72 74 61 6e 74 20 70 72 6f 6a 65 63 74  mportant project
0780: 20 75 73 69 6e 67 0a 66 6f 73 73 69 6c 20 69 73   using.fossil is
0790: 20 53 51 4c 69 74 65 2e 20 20 46 6f 73 73 69 6c   SQLite.  Fossil
07a0: 20 69 74 73 65 6c 66 0a 69 73 20 62 75 69 6c 74   itself.is built
07b0: 20 6f 6e 20 74 6f 70 20 6f 66 20 53 51 4c 69 74   on top of SQLit
07c0: 65 20 61 6e 64 20 73 6f 20 6f 62 76 69 6f 75 73  e and so obvious
07d0: 6c 79 20 53 51 4c 69 74 65 20 68 61 73 20 74 6f  ly SQLite has to
07e0: 20 70 72 65 64 61 74 65 20 66 6f 73 73 69 6c 2e   predate fossil.
07f0: 0a 53 51 4c 69 74 65 20 77 61 73 20 6f 72 69 67  .SQLite was orig
0800: 69 6e 61 6c 6c 79 20 76 65 72 73 69 6f 6e 65 64  inally versioned
0810: 20 75 73 69 6e 67 20 43 56 53 2c 20 62 75 74 20   using CVS, but 
0820: 72 65 63 65 6e 74 6c 79 20 74 68 65 20 65 6e 74  recently the ent
0830: 69 72 65 20 39 2d 79 65 61 72 0a 61 6e 64 20 33  ire 9-year.and 3
0840: 32 30 2d 4d 42 20 43 56 53 20 68 69 73 74 6f 72  20-MB CVS histor
0850: 79 20 6f 66 20 53 51 4c 69 74 65 20 77 61 73 20  y of SQLite was 
0860: 63 6f 6e 76 65 72 74 65 64 20 6f 76 65 72 20 74  converted over t
0870: 6f 20 46 6f 73 73 69 6c 2e 20 20 54 68 69 73 20  o Fossil.  This 
0880: 69 73 0a 61 6e 20 69 6d 70 6f 72 74 61 6e 74 20  is.an important 
0890: 64 61 74 61 70 6f 69 6e 74 20 62 65 63 61 75 73  datapoint becaus
08a0: 65 20 69 74 20 64 65 6d 6f 6e 73 74 72 61 74 65  e it demonstrate
08b0: 73 20 66 6f 73 73 69 6c 27 73 20 61 62 69 6c 69  s fossil's abili
08c0: 74 79 20 74 6f 20 6d 61 6e 61 67 65 0a 61 20 73  ty to manage.a s
08d0: 69 67 6e 69 66 69 63 61 6e 74 20 61 6e 64 20 6c  ignificant and l
08e0: 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 70 72 6f 6a  ong-running proj
08f0: 65 63 74 2e 0a 54 68 65 20 6e 65 78 74 2d 6c 6f  ect..The next-lo
0900: 6e 67 65 73 74 20 72 75 6e 6e 69 6e 67 20 66 6f  ngest running fo
0910: 73 73 69 6c 20 70 72 6f 6a 65 63 74 20 69 73 20  ssil project is 
0920: 66 6f 73 73 69 6c 20 69 74 73 65 6c 66 2c 20 61  fossil itself, a
0930: 74 20 32 2e 31 20 79 65 61 72 73 2e 0a 54 68 65  t 2.1 years..The
0940: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
0950: 6f 72 20 53 51 4c 69 74 65 0a 28 69 64 65 6e 74  or SQLite.(ident
0960: 69 66 69 65 64 20 61 62 6f 76 65 20 61 73 20 22  ified above as "
0970: 53 51 4c 69 74 65 20 44 6f 63 73 22 29 20 77 61  SQLite Docs") wa
0980: 73 20 73 70 6c 69 74 20 6f 66 66 20 6f 66 20 74  s split off of t
0990: 68 65 20 6d 61 69 6e 20 53 51 4c 69 74 65 20 0a  he main SQLite .
09a0: 73 6f 75 72 63 65 20 74 72 65 65 20 61 6e 64 20  source tree and 
09b0: 69 6e 74 6f 20 69 74 73 20 6f 77 6e 20 66 6f 73  into its own fos
09c0: 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 61  sil repository a
09d0: 62 6f 75 74 20 31 2e 37 35 20 79 65 61 72 73 20  bout 1.75 years 
09e0: 61 67 6f 2e 0a 54 68 65 20 22 53 51 4c 20 4c 6f  ago..The "SQL Lo
09f0: 67 69 63 20 54 65 73 74 22 20 6f 72 20 22 53 4c  gic Test" or "SL
0a00: 54 22 20 70 72 6f 6a 65 63 74 20 69 73 20 61 20  T" project is a 
0a10: 6d 61 73 73 69 76 65 0a 63 6f 6c 6c 65 63 74 69  massive.collecti
0a20: 6f 6e 20 6f 66 20 53 51 4c 20 73 74 61 74 65 6d  on of SQL statem
0a30: 65 6e 74 73 20 61 6e 64 20 74 68 65 69 72 20 6f  ents and their o
0a40: 75 74 70 75 74 20 75 73 65 64 20 74 6f 20 63 6f  utput used to co
0a50: 6d 70 61 72 65 20 74 68 65 20 0a 70 72 6f 63 65  mpare the .proce
0a60: 73 73 69 6e 67 20 6f 66 20 53 51 4c 69 74 65 20  ssing of SQLite 
0a70: 61 67 61 69 6e 73 74 20 4d 79 53 51 4c 2c 20 50  against MySQL, P
0a80: 6f 73 74 67 72 65 53 51 4c 2c 20 4d 69 63 72 6f  ostgreSQL, Micro
0a90: 73 6f 66 74 20 53 51 4c 20 53 65 72 76 65 72 2c  soft SQL Server,
0aa0: 0a 61 6e 64 20 4f 72 61 63 6c 65 2e 20 20 0a 46  .and Oracle.  .F
0ab0: 69 6e 61 6c 6c 79 20 22 54 48 33 22 20 69 73 20  inally "TH3" is 
0ac0: 61 20 70 72 6f 70 72 69 65 74 61 72 79 20 73 65  a proprietary se
0ad0: 74 20 6f 66 20 74 65 73 74 20 63 61 73 65 73 20  t of test cases 
0ae0: 66 6f 72 20 53 51 4c 69 74 65 20 75 73 65 64 20  for SQLite used 
0af0: 74 6f 20 67 69 76 65 0a 31 30 30 25 20 62 72 61  to give.100% bra
0b00: 6e 63 68 20 74 65 73 74 20 63 6f 76 65 72 61 67  nch test coverag
0b10: 65 20 6f 66 20 53 51 4c 69 74 65 20 6f 6e 20 65  e of SQLite on e
0b20: 6d 62 65 64 64 65 64 20 70 6c 61 74 66 6f 72 6d  mbedded platform
0b30: 73 2e 20 20 41 6c 6c 20 70 72 6f 6a 65 63 74 73  s.  All projects
0b40: 0a 65 78 63 65 70 74 20 66 6f 72 20 54 48 33 20  .except for TH3 
0b50: 61 72 65 20 6f 70 65 6e 2d 73 6f 75 72 63 65 2e  are open-source.
0b60: 0a 0a 3c 68 32 3e 4d 65 61 73 75 72 65 64 20 41  ..<h2>Measured A
0b70: 74 74 72 69 62 75 74 65 73 3c 2f 68 32 3e 0a 0a  ttributes</h2>..
0b80: 49 6e 20 66 6f 73 73 69 6c 2c 20 65 76 65 72 79  In fossil, every
0b90: 20 76 65 72 73 69 6f 6e 20 6f 66 20 65 76 65 72   version of ever
0ba0: 79 20 66 69 6c 65 2c 20 65 76 65 72 79 20 77 69  y file, every wi
0bb0: 6b 69 20 70 61 67 65 2c 20 65 76 65 72 79 20 63  ki page, every c
0bc0: 68 61 6e 67 65 20 74 6f 0a 65 76 65 72 79 20 74  hange to.every t
0bd0: 69 63 6b 65 74 2c 20 61 6e 64 20 65 76 65 72 79  icket, and every
0be0: 20 63 68 65 63 6b 2d 69 6e 20 69 73 20 61 20 73   check-in is a s
0bf0: 65 70 61 72 61 74 65 20 22 61 72 74 69 66 61 63  eparate "artifac
0c00: 74 22 2e 20 20 4f 6e 65 20 77 61 79 20 74 6f 0a  t".  One way to.
0c10: 74 68 69 6e 6b 20 6f 66 20 61 20 66 6f 73 73 69  think of a fossi
0c20: 6c 20 70 72 6f 6a 65 63 74 20 69 73 20 61 73 20  l project is as 
0c30: 61 20 62 61 67 20 6f 66 20 61 72 74 69 66 61 63  a bag of artifac
0c40: 74 73 2e 20 20 4f 66 20 63 6f 75 72 73 65 2c 20  ts.  Of course, 
0c50: 74 68 65 72 65 20 69 73 0a 61 20 6c 6f 74 20 6d  there is.a lot m
0c60: 6f 72 65 20 74 68 61 6e 20 74 68 69 73 20 67 6f  ore than this go
0c70: 69 6e 67 20 6f 6e 20 69 6e 20 66 6f 73 73 69 6c  ing on in fossil
0c80: 2e 20 20 4d 61 6e 79 20 6f 66 20 74 68 65 20 61  .  Many of the a
0c90: 72 74 69 66 61 63 74 73 20 68 61 76 65 20 6d 65  rtifacts have me
0ca0: 61 6e 69 6e 67 0a 61 6e 64 20 61 72 65 20 72 65  aning.and are re
0cb0: 6c 61 74 65 64 20 74 6f 20 6f 74 68 65 72 20 61  lated to other a
0cc0: 72 74 69 66 61 63 74 73 2e 20 20 42 75 74 20 61  rtifacts.  But a
0cd0: 74 20 61 20 6c 6f 77 20 6c 65 76 65 6c 20 28 66  t a low level (f
0ce0: 6f 72 20 65 78 61 6d 70 6c 65 20 77 68 65 6e 0a  or example when.
0cf0: 73 79 6e 63 68 72 6f 6e 69 7a 69 6e 67 20 74 77  synchronizing tw
0d00: 6f 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 74  o instances of t
0d10: 68 65 20 73 61 6d 65 20 70 72 6f 6a 65 63 74 29  he same project)
0d20: 20 74 68 65 20 6f 6e 6c 79 20 74 68 69 6e 67 20   the only thing 
0d30: 74 68 61 74 20 6d 61 74 74 65 72 73 0a 69 73 20  that matters.is 
0d40: 74 68 65 20 75 6e 6f 72 64 65 72 65 64 20 63 6f  the unordered co
0d50: 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 61 72 74 69  llection of arti
0d60: 66 61 63 74 73 2e 20 20 49 6e 20 66 61 63 74 2c  facts.  In fact,
0d70: 20 6f 6e 65 20 6f 66 20 74 68 65 20 6b 65 79 20   one of the key 
0d80: 0a 63 68 61 72 61 63 74 65 72 69 73 74 69 63 73  .characteristics
0d90: 20 6f 66 20 66 6f 73 73 69 6c 20 69 73 20 74 68   of fossil is th
0da0: 61 74 20 74 68 65 20 65 6e 74 69 72 65 20 70 72  at the entire pr
0db0: 6f 6a 65 63 74 20 68 69 73 74 6f 72 79 20 63 61  oject history ca
0dc0: 6e 20 62 65 0a 72 65 63 6f 6e 73 74 72 75 63 74  n be.reconstruct
0dd0: 65 64 20 73 69 6d 70 6c 79 20 62 79 20 73 63 61  ed simply by sca
0de0: 6e 6e 69 6e 67 20 74 68 65 20 61 72 74 69 66 61  nning the artifa
0df0: 63 74 73 20 69 6e 20 61 6e 20 61 72 62 69 74 72  cts in an arbitr
0e00: 61 72 79 20 6f 72 64 65 72 2e 0a 0a 54 68 65 20  ary order...The 
0e10: 6e 75 6d 62 65 72 20 6f 66 20 63 68 65 63 6b 2d  number of check-
0e20: 69 6e 73 20 69 73 20 74 68 65 20 6e 75 6d 62 65  ins is the numbe
0e30: 72 20 6f 66 20 74 69 6d 65 73 20 74 68 61 74 20  r of times that 
0e40: 74 68 65 20 22 63 6f 6d 6d 69 74 22 20 63 6f 6d  the "commit" com
0e50: 6d 61 6e 64 0a 68 61 73 20 62 65 65 6e 20 72 75  mand.has been ru
0e60: 6e 2e 20 20 41 20 73 69 6e 67 6c 65 20 63 68 65  n.  A single che
0e70: 63 6b 2d 69 6e 20 6d 69 67 68 74 20 63 68 61 6e  ck-in might chan
0e80: 67 65 20 61 20 33 20 6f 72 20 34 20 66 69 6c 65  ge a 3 or 4 file
0e90: 73 2c 20 6f 72 20 69 74 20 6d 69 67 68 74 0a 63  s, or it might.c
0ea0: 68 61 6e 67 65 20 73 65 76 65 72 61 6c 20 64 6f  hange several do
0eb0: 7a 65 6e 20 64 69 66 66 65 72 65 6e 74 20 66 69  zen different fi
0ec0: 6c 65 73 2e 20 20 52 65 67 61 72 64 6c 65 73 73  les.  Regardless
0ed0: 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   of the number o
0ee0: 66 20 66 69 6c 65 73 0a 63 68 61 6e 67 65 64 2c  f files.changed,
0ef0: 20 69 74 20 73 74 69 6c 6c 20 6f 6e 6c 79 20 63   it still only c
0f00: 6f 75 6e 74 73 20 61 73 20 6f 6e 65 20 63 68 65  ounts as one che
0f10: 63 6b 2d 69 6e 2e 0a 0a 54 68 65 20 22 55 6e 63  ck-in...The "Unc
0f20: 6f 6d 70 72 65 73 73 65 64 20 53 69 7a 65 22 20  ompressed Size" 
0f30: 69 73 20 74 68 65 20 74 6f 74 61 6c 20 73 69 7a  is the total siz
0f40: 65 20 6f 66 20 61 6c 6c 20 74 68 65 20 61 72 74  e of all the art
0f50: 69 66 61 63 74 73 20 77 69 74 68 69 6e 0a 74 68  ifacts within.th
0f60: 65 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74  e fossil reposit
0f70: 6f 72 79 20 61 73 73 75 6d 69 6e 67 20 74 68 65  ory assuming the
0f80: 79 20 77 65 72 65 20 61 6c 6c 20 75 6e 63 6f 6d  y were all uncom
0f90: 70 72 65 73 73 65 64 20 61 6e 64 20 73 74 6f 72  pressed and stor
0fa0: 65 64 20 0a 73 65 70 61 72 61 74 65 6c 79 20 6f  ed .separately o
0fb0: 6e 20 74 68 65 20 64 69 73 6b 2e 20 20 46 6f 73  n the disk.  Fos
0fc0: 73 69 6c 20 6d 61 6b 65 73 20 75 73 65 20 6f 66  sil makes use of
0fd0: 20 64 65 6c 74 61 20 63 6f 6d 70 72 65 73 73 20   delta compress 
0fe0: 62 65 74 77 65 65 6e 20 72 65 6c 61 74 65 64 0a  between related.
0ff0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20  versions of the 
1000: 73 61 6d 65 20 66 69 6c 65 2c 20 61 6e 64 20 74  same file, and t
1010: 68 65 6e 20 75 73 69 6e 67 20 7a 6c 69 62 20 63  hen using zlib c
1020: 6f 6d 70 72 65 73 73 69 6f 6e 20 6f 6e 20 74 68  ompression on th
1030: 65 20 72 65 73 75 6c 74 69 6e 67 0a 64 65 6c 74  e resulting.delt
1040: 61 73 2e 20 20 54 68 65 20 74 6f 74 61 6c 20 72  as.  The total r
1050: 65 73 75 6c 74 69 6e 67 20 72 65 70 6f 73 69 74  esulting reposit
1060: 6f 72 79 20 73 69 7a 65 20 69 73 20 73 68 6f 77  ory size is show
1070: 6e 20 61 66 74 65 72 20 74 68 65 20 75 6e 63 6f  n after the unco
1080: 6d 70 72 65 73 73 65 64 0a 73 69 7a 65 2e 20 20  mpressed.size.  
1090: 0a 0a 4f 6e 20 74 68 65 20 72 69 67 68 74 20 65  ..On the right e
10a0: 6e 64 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2c  nd of the table,
10b0: 20 77 65 20 73 68 6f 77 20 74 68 65 20 22 43 6c   we show the "Cl
10c0: 6f 6e 65 20 42 61 6e 64 77 69 64 74 68 22 2e 20  one Bandwidth". 
10d0: 20 54 68 69 73 20 69 73 20 74 68 65 0a 74 6f 74   This is the.tot
10e0: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74  al number of byt
10f0: 65 73 20 73 65 6e 74 20 66 72 6f 6d 20 63 6c 69  es sent from cli
1100: 65 6e 74 20 74 6f 20 73 65 72 76 65 72 20 28 22  ent to server ("
1110: 75 70 6c 69 6e 6b 22 29 20 61 6e 64 20 66 72 6f  uplink") and fro
1120: 6d 20 73 65 72 76 65 72 0a 62 61 63 6b 20 74 6f  m server.back to
1130: 20 63 6c 69 65 6e 74 20 28 22 64 6f 77 6e 6c 69   client ("downli
1140: 6e 6b 22 29 20 69 6e 20 6f 72 64 65 72 20 74 6f  nk") in order to
1150: 20 63 6c 6f 6e 65 20 61 20 72 65 70 6f 73 69 74   clone a reposit
1160: 6f 72 79 2e 20 20 54 68 65 73 65 20 62 79 74 65  ory.  These byte
1170: 20 63 6f 75 6e 74 73 0a 69 6e 63 6c 75 64 65 20   counts.include 
1180: 61 6c 6c 20 6f 66 20 74 68 65 20 48 54 54 50 20  all of the HTTP 
1190: 70 72 6f 74 6f 63 6f 6c 20 6f 76 65 72 68 65 61  protocol overhea
11a0: 64 2e 0a 0a 49 6e 20 74 68 65 20 74 61 62 6c 65  d...In the table
11b0: 20 61 6e 64 20 74 68 72 6f 75 67 68 6f 75 74 20   and throughout 
11c0: 74 68 69 73 20 61 72 74 69 63 6c 65 2c 0a 22 47  this article,."G
11d0: 42 22 20 6d 65 61 6e 73 20 67 69 67 61 62 79 74  B" means gigabyt
11e0: 65 73 20 28 31 30 3c 73 75 70 3e 3c 73 6d 61 6c  es (10<sup><smal
11f0: 6c 3e 39 3c 2f 73 6d 61 6c 6c 3e 3c 2f 73 75 70  l>9</small></sup
1200: 3e 20 62 79 74 65 73 29 0a 6e 6f 74 20 3c 61 20  > bytes).not <a 
1210: 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e  href="http://en.
1220: 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69  wikipedia.org/wi
1230: 6b 69 2f 47 69 62 69 62 79 74 65 22 3e 67 69 62  ki/Gibibyte">gib
1240: 69 62 79 74 65 73 3c 2f 61 3e 0a 28 32 3c 73 75  ibytes</a>.(2<su
1250: 70 3e 3c 73 6d 61 6c 6c 3e 33 30 3c 2f 73 6d 61  p><small>30</sma
1260: 6c 6c 3e 3c 2f 73 75 70 3e 20 62 79 74 65 73 29  ll></sup> bytes)
1270: 2e 20 20 53 69 6d 69 6c 61 72 6c 79 2c 20 22 4d  .  Similarly, "M
1280: 42 22 20 61 6e 64 20 22 4b 42 22 0a 6d 65 61 6e  B" and "KB".mean
1290: 73 20 6d 65 67 61 62 79 74 65 73 20 61 6e 64 20  s megabytes and 
12a0: 6b 69 6c 6f 62 79 74 65 73 2c 20 6e 6f 74 20 6d  kilobytes, not m
12b0: 65 62 69 62 79 74 65 73 20 61 6e 64 20 6b 69 62  ebibytes and kib
12c0: 69 62 79 74 65 73 2e 0a 0a 3c 68 32 3e 41 6e 61  ibytes...<h2>Ana
12d0: 6c 79 73 69 73 20 41 6e 64 20 53 75 70 70 6c 69  lysis And Suppli
12e0: 6d 65 6e 74 61 6c 20 44 61 74 61 3c 2f 68 32 3e  mental Data</h2>
12f0: 0a 0a 50 65 72 68 61 70 73 20 74 68 65 20 74 77  ..Perhaps the tw
1300: 6f 20 6d 6f 73 74 20 69 6e 74 65 72 65 73 74 69  o most interesti
1310: 6e 67 20 64 61 74 61 70 6f 69 6e 74 73 20 69 6e  ng datapoints in
1320: 20 74 68 65 20 61 62 6f 76 65 20 74 61 62 6c 65   the above table
1330: 20 61 72 65 20 53 51 4c 69 74 65 0a 61 6e 64 20   are SQLite.and 
1340: 53 4c 54 2e 20 20 53 51 4c 69 74 65 20 69 73 20  SLT.  SQLite is 
1350: 61 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 70  a long-running p
1360: 72 6f 6a 65 63 74 20 77 69 74 68 20 6c 6f 6e 67  roject with long
1370: 20 72 65 76 69 73 69 6f 6e 20 63 68 61 69 6e 73   revision chains
1380: 2e 0a 53 6f 6d 65 20 6f 66 20 74 68 65 20 66 69  ..Some of the fi
1390: 6c 65 73 20 69 6e 20 53 51 4c 69 74 65 20 68 61  les in SQLite ha
13a0: 76 65 20 62 65 65 6e 20 65 64 69 74 65 64 20 63  ve been edited c
13b0: 6c 6f 73 65 20 74 6f 20 61 20 74 68 6f 75 73 61  lose to a thousa
13c0: 6e 64 20 74 69 6d 65 73 2e 0a 45 61 63 68 20 6f  nd times..Each o
13d0: 66 20 74 68 65 73 65 20 65 64 69 74 73 20 69 73  f these edits is
13e0: 20 73 74 6f 72 65 64 20 61 73 20 61 20 64 65 6c   stored as a del
13f0: 74 61 2c 20 61 6e 64 20 68 65 6e 63 65 20 74 68  ta, and hence th
1400: 65 20 53 51 4c 69 74 65 20 70 72 6f 6a 65 63 74  e SQLite project
1410: 0a 67 65 74 73 20 65 78 63 65 6c 6c 65 6e 74 20  .gets excellent 
1420: 33 35 3a 31 20 63 6f 6d 70 72 65 73 73 69 6f 6e  35:1 compression
1430: 2e 20 20 53 4c 54 2c 20 6f 6e 20 74 68 65 20 6f  .  SLT, on the o
1440: 74 68 65 72 20 68 61 6e 64 2c 20 63 6f 6e 73 69  ther hand, consi
1450: 73 74 73 20 6f 66 0a 6d 61 6e 79 20 6c 61 72 67  sts of.many larg
1460: 65 20 28 6d 65 67 61 62 79 74 65 2d 73 69 7a 65  e (megabyte-size
1470: 64 29 20 53 51 4c 20 73 63 72 69 70 74 73 20 74  d) SQL scripts t
1480: 68 61 74 20 68 61 76 65 20 6f 6e 65 20 6f 72 20  hat have one or 
1490: 6d 61 79 62 65 20 74 77 6f 0a 76 65 72 73 69 6f  maybe two.versio
14a0: 6e 73 2e 20 20 54 68 65 72 65 20 69 73 20 76 65  ns.  There is ve
14b0: 72 79 20 6c 69 74 74 6c 65 20 64 65 6c 74 61 20  ry little delta 
14c0: 63 6f 6d 70 72 65 73 73 69 6f 6e 20 6f 63 63 75  compression occu
14d0: 72 72 69 6e 67 20 61 6e 64 20 73 6f 20 74 68 65  rring and so the
14e0: 0a 6f 76 65 72 61 6c 6c 20 72 65 70 6f 73 69 74  .overall reposit
14f0: 6f 72 79 20 63 6f 6d 70 72 65 73 73 69 6f 6e 20  ory compression 
1500: 72 61 74 69 6f 20 69 73 20 6d 75 63 68 20 6c 6f  ratio is much lo
1510: 77 65 72 2e 20 20 4e 6f 74 65 20 61 6c 73 6f 20  wer.  Note also 
1520: 74 68 61 74 0a 71 75 69 74 65 20 61 20 62 69 74  that.quite a bit
1530: 20 6d 6f 72 65 20 62 61 6e 64 77 69 64 74 68 20   more bandwidth 
1540: 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 63  is required to c
1550: 6c 6f 6e 65 20 53 4c 54 20 74 68 61 6e 20 53 51  lone SLT than SQ
1560: 4c 69 74 65 2e 0a 0a 46 6f 72 20 74 68 65 20 66  Lite...For the f
1570: 69 72 73 74 20 6e 69 6e 65 20 79 65 61 72 73 20  irst nine years 
1580: 6f 66 20 69 74 73 20 64 65 76 65 6c 6f 70 6d 65  of its developme
1590: 6e 74 2c 20 53 51 4c 69 74 65 20 77 61 73 20 76  nt, SQLite was v
15a0: 65 72 73 69 6f 6e 65 64 20 62 79 20 43 56 53 2e  ersioned by CVS.
15b0: 0a 54 68 65 20 72 65 73 75 6c 74 69 6e 67 20 43  .The resulting C
15c0: 56 53 20 72 65 70 6f 73 69 74 6f 72 79 20 6d 65  VS repository me
15d0: 61 73 75 72 65 64 20 6f 76 65 72 20 33 32 30 4d  asured over 320M
15e0: 42 20 69 6e 20 73 69 7a 65 2e 20 20 53 6f 2c 20  B in size.  So, 
15f0: 74 68 65 0a 64 65 76 65 6c 6f 70 65 72 73 20 77  the.developers w
1600: 65 72 65 0a 70 6c 65 61 73 65 6e 74 6c 79 20 73  ere.pleasently s
1610: 75 72 70 72 69 73 65 64 20 74 6f 20 73 65 65 20  urprised to see 
1620: 74 68 61 74 20 74 68 69 73 20 65 6e 74 69 72 65  that this entire
1630: 20 70 72 6f 6a 65 63 74 20 63 6f 75 6c 64 20 62   project could b
1640: 65 20 63 6c 6f 6e 65 64 20 69 6e 0a 66 6f 73 73  e cloned in.foss
1650: 69 6c 20 75 73 69 6e 67 20 6f 6e 6c 79 20 61 62  il using only ab
1660: 6f 75 74 20 31 33 4d 42 20 6f 66 20 6e 65 74 77  out 13MB of netw
1670: 6f 72 6b 20 74 72 61 66 66 69 63 2e 20 20 54 68  ork traffic.  Th
1680: 65 20 22 73 79 6e 63 22 20 70 72 6f 74 6f 63 6f  e "sync" protoco
1690: 6c 0a 75 73 65 64 20 62 79 20 66 6f 73 73 69 6c  l.used by fossil
16a0: 20 68 61 73 20 74 75 72 6e 65 64 20 6f 75 74 20   has turned out 
16b0: 74 6f 20 62 65 20 73 75 72 70 72 69 73 69 6e 67  to be surprising
16c0: 6c 79 20 65 66 66 69 63 69 65 6e 74 2e 20 20 41  ly efficient.  A
16d0: 20 74 79 70 69 63 61 6c 0a 63 68 65 63 6b 2d 69   typical.check-i
16e0: 6e 20 6f 6e 20 53 51 4c 69 74 65 20 6d 69 67 68  n on SQLite migh
16f0: 74 20 75 73 65 20 33 20 6f 72 20 34 4b 42 20 6f  t use 3 or 4KB o
1700: 66 20 6e 65 74 77 6f 72 6b 20 62 61 6e 64 77 69  f network bandwi
1710: 64 74 68 20 74 6f 74 61 6c 2e 20 20 48 61 72 64  dth total.  Hard
1720: 6c 79 0a 77 6f 72 74 68 20 6d 65 61 73 75 72 69  ly.worth measuri
1730: 6e 67 2e 20 20 54 68 65 20 73 79 6e 63 20 70 72  ng.  The sync pr
1740: 6f 74 6f 63 6f 6c 20 69 73 20 65 66 66 69 63 69  otocol is effici
1750: 65 6e 74 20 65 6e 6f 75 67 68 20 74 68 61 74 2c  ent enough that,
1760: 20 6f 6e 63 65 20 63 6c 6f 6e 65 64 2c 0a 66 6f   once cloned,.fo
1770: 73 73 69 6c 20 63 6f 75 6c 64 20 65 61 73 69 6c  ssil could easil
1780: 79 20 62 65 20 75 73 65 64 20 6f 76 65 72 20 61  y be used over a
1790: 20 64 69 61 6c 2d 75 70 20 63 6f 6e 6e 65 63 74   dial-up connect
17a0: 69 6f 6e 2e 0a                                   ion..