Hex Artifact Content
Not logged in

Artifact 4de2807375002a0483a23064a85fd2556fd312f7:

File www/selfcheck.html part of check-in [6458f020fc] - Change the spelling of "descendant" to use the -ant suffix everywhere, including in the filename "descendant.c". The adjective form can be spelled either -ant or -ent, but the noun form requires -ant, or so says American Heritage. by drh on 2008-05-14 02:03:45.

0000: 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a 3c 74  <html>.<head>.<t
0010: 69 74 6c 65 3e 46 6f 73 73 69 6c 20 52 65 70 6f  itle>Fossil Repo
0020: 73 69 74 6f 72 79 20 49 6e 74 65 67 72 69 74 79  sitory Integrity
0030: 20 53 65 6c 66 2d 43 68 65 63 6b 73 3c 2f 74 69   Self-Checks</ti
0040: 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f  tle>.</head>.<bo
0050: 64 79 20 62 67 63 6f 6c 6f 72 3d 22 77 68 69 74  dy bgcolor="whit
0060: 65 22 3e 0a 3c 70 3e 5b 20 3c 61 20 68 72 65 66  e">.<p>[ <a href
0070: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 49 6e  ="index.html">In
0080: 64 65 78 3c 2f 61 3e 20 5d 3c 2f 70 3e 0a 3c 68  dex</a> ]</p>.<h
0090: 72 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65  r>.<h1 align="ce
00a0: 6e 74 65 72 22 3e 0a 46 6f 73 73 69 6c 20 52 65  nter">.Fossil Re
00b0: 70 6f 73 69 74 6f 72 79 20 49 6e 74 65 67 72 69  pository Integri
00c0: 74 79 20 53 65 6c 66 2d 43 68 65 63 6b 73 0a 3c  ty Self-Checks.<
00d0: 2f 68 31 3e 0a 0a 3c 70 3e 0a 45 76 65 6e 20 74  /h1>..<p>.Even t
00e0: 68 6f 75 67 68 20 66 6f 73 73 69 6c 20 69 73 20  hough fossil is 
00f0: 61 20 72 65 6c 61 74 69 76 65 6c 79 20 6e 65 77  a relatively new
0100: 20 70 72 6f 6a 65 63 74 20 61 6e 64 20 73 74 69   project and sti
0110: 6c 6c 20 63 6f 6e 74 61 69 6e 73 0a 6d 61 6e 79  ll contains.many
0120: 20 62 75 67 73 2c 20 69 74 20 69 73 20 64 65 73   bugs, it is des
0130: 69 67 6e 65 64 20 77 69 74 68 20 66 65 61 74 75  igned with featu
0140: 72 65 73 20 74 6f 20 67 69 76 65 20 69 74 20 61  res to give it a
0150: 20 68 69 67 68 20 6c 65 76 65 6c 0a 6f 66 20 69   high level.of i
0160: 6e 74 65 67 72 69 74 79 20 73 6f 20 74 68 61 74  ntegrity so that
0170: 20 79 6f 75 20 63 61 6e 20 68 61 76 65 20 63 6f   you can have co
0180: 6e 66 69 64 65 6e 63 65 20 74 68 61 74 20 79 6f  nfidence that yo
0190: 75 20 77 69 6c 6c 20 6e 6f 74 0a 6c 6f 73 65 20  u will not.lose 
01a0: 79 6f 75 72 20 66 69 6c 65 73 2e 20 20 54 68 69  your files.  Thi
01b0: 73 20 6e 6f 74 65 20 64 65 73 63 72 69 62 65 73  s note describes
01c0: 20 74 68 65 20 64 65 66 65 6e 73 69 76 65 20 6d   the defensive m
01d0: 65 61 73 75 72 65 73 20 74 68 61 74 0a 66 6f 73  easures that.fos
01e0: 73 69 6c 20 75 73 65 73 20 74 6f 20 68 65 6c 70  sil uses to help
01f0: 20 70 72 65 76 65 6e 74 20 66 69 6c 65 20 6c 6f   prevent file lo
0200: 73 73 20 64 75 65 20 74 6f 20 62 75 67 73 2e 0a  ss due to bugs..
0210: 3c 2f 70 3e 0a 0a 3c 70 3e 3c 69 3e 46 6f 6c 6c  </p>..<p><i>Foll
0220: 6f 77 2d 75 70 20 61 73 20 6f 66 20 32 30 30 37  ow-up as of 2007
0230: 2d 31 31 2d 32 34 3a 3c 2f 69 3e 0a 46 6f 73 73  -11-24:</i>.Foss
0240: 69 6c 20 68 61 73 20 62 65 65 6e 20 68 6f 73 74  il has been host
0250: 69 6e 67 20 69 74 73 65 6c 66 20 61 6e 64 20 73  ing itself and s
0260: 65 76 65 72 61 6c 20 6f 74 68 65 72 20 70 72 6f  everal other pro
0270: 6a 65 63 74 73 20 66 6f 72 0a 6d 6f 6e 74 68 73  jects for.months
0280: 20 6e 6f 77 2e 20 20 4d 61 6e 79 20 62 75 67 73   now.  Many bugs
0290: 20 68 61 76 65 20 62 65 65 6e 20 65 6e 63 6f 75   have been encou
02a0: 6e 74 65 72 65 64 2e 20 20 42 75 74 2c 20 74 68  ntered.  But, th
02b0: 61 6e 6b 73 20 69 6e 20 6c 61 72 67 65 0a 70 61  anks in large.pa
02c0: 72 74 20 74 6f 20 74 68 65 20 64 65 66 65 6e 73  rt to the defens
02d0: 69 76 65 20 6d 65 61 73 75 72 65 73 20 64 65 73  ive measures des
02e0: 63 72 69 62 65 64 20 68 65 72 65 2c 20 6e 6f 20  cribed here, no 
02f0: 64 61 74 61 20 68 61 73 20 62 65 65 6e 0a 6c 6f  data has been.lo
0300: 73 74 2e 20 20 54 68 65 20 69 6e 74 65 67 72 69  st.  The integri
0310: 74 79 20 63 68 65 63 6b 73 20 61 72 65 20 64 6f  ty checks are do
0320: 69 6e 67 20 74 68 65 69 72 20 6a 6f 62 20 77 65  ing their job we
0330: 6c 6c 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 41 74 6f  ll.</p>..<h2>Ato
0340: 6d 69 63 20 43 68 65 63 6b 2d 69 6e 73 20 57 69  mic Check-ins Wi
0350: 74 68 20 52 6f 6c 6c 62 61 63 6b 3c 2f 68 32 3e  th Rollback</h2>
0360: 0a 0a 3c 70 3e 0a 54 68 65 20 66 6f 73 73 69 6c  ..<p>.The fossil
0370: 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 61   repository is a
0380: 6e 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a  n.<a href="http:
0390: 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 67  //www.sqlite.org
03a0: 2f 22 3e 53 51 4c 69 74 65 20 76 65 72 73 69 6f  /">SQLite versio
03b0: 6e 20 33 3c 2f 61 3e 20 64 61 74 61 62 61 73 65  n 3</a> database
03c0: 20 66 69 6c 65 2e 20 20 0a 53 51 4c 69 74 65 20   file.  .SQLite 
03d0: 69 73 20 76 65 72 79 20 6d 61 74 75 72 65 20 61  is very mature a
03e0: 6e 64 20 73 74 61 62 6c 65 20 61 6e 64 20 68 61  nd stable and ha
03f0: 73 20 62 65 65 6e 20 69 6e 20 77 69 64 65 2d 73  s been in wide-s
0400: 70 72 65 61 64 20 75 73 65 20 66 6f 72 20 6d 61  pread use for ma
0410: 6e 79 0a 79 65 61 72 73 2c 20 73 6f 20 77 65 20  ny.years, so we 
0420: 68 61 76 65 20 6c 69 74 74 6c 65 20 77 6f 72 72  have little worr
0430: 69 65 73 20 74 68 61 74 20 69 74 20 6d 69 67 68  ies that it migh
0440: 74 20 63 61 75 73 65 20 72 65 70 6f 73 69 74 6f  t cause reposito
0450: 72 79 0a 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20  ry.corruption.  
0460: 53 51 4c 69 74 65 0a 64 61 74 61 62 61 73 65 73  SQLite.databases
0470: 20 64 6f 20 6e 6f 74 20 63 6f 72 72 75 70 74 20   do not corrupt 
0480: 65 76 65 6e 20 69 66 20 61 20 70 72 6f 67 72 61  even if a progra
0490: 6d 20 6f 72 20 73 79 73 74 65 6d 20 63 72 61 73  m or system cras
04a0: 68 20 6f 72 20 70 6f 77 65 72 0a 66 61 69 6c 75  h or power.failu
04b0: 72 65 20 6f 63 63 75 72 73 20 69 6e 20 74 68 65  re occurs in the
04c0: 20 6d 69 64 64 6c 65 20 6f 66 20 74 68 65 20 75   middle of the u
04d0: 70 64 61 74 65 2e 20 20 49 66 20 73 6f 6d 65 20  pdate.  If some 
04e0: 6b 69 6e 64 20 6f 66 20 63 72 61 73 68 0a 64 6f  kind of crash.do
04f0: 65 73 20 6f 63 63 75 72 20 69 6e 20 74 68 65 20  es occur in the 
0500: 6d 69 64 64 6c 65 20 6f 66 20 61 20 63 68 61 6e  middle of a chan
0510: 67 65 2c 20 74 68 65 6e 20 61 6c 6c 20 74 68 65  ge, then all the
0520: 20 63 68 61 6e 67 65 73 20 61 72 65 20 72 6f 6c   changes are rol
0530: 6c 65 64 0a 62 61 63 6b 20 74 68 65 20 6e 65 78  led.back the nex
0540: 74 20 74 69 6d 65 20 74 68 61 74 20 74 68 65 20  t time that the 
0550: 64 61 74 61 62 61 73 65 20 69 73 20 61 63 63 65  database is acce
0560: 73 73 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  ssed..</p>..<p>.
0570: 41 20 63 68 65 63 6b 2d 69 6e 20 6f 70 65 72 61  A check-in opera
0580: 74 69 6f 6e 20 69 6e 20 66 6f 73 73 69 6c 20 6d  tion in fossil m
0590: 61 6b 65 73 20 6d 61 6e 79 20 63 68 61 6e 67 65  akes many change
05a0: 73 20 74 6f 20 74 68 65 20 72 65 70 6f 73 69 74  s to the reposit
05b0: 6f 72 79 0a 64 61 74 61 62 61 73 65 2e 20 20 42  ory.database.  B
05c0: 75 74 20 61 6c 6c 20 74 68 65 73 65 20 63 68 61  ut all these cha
05d0: 6e 67 65 73 20 68 61 70 70 65 6e 20 77 69 74 68  nges happen with
05e0: 69 6e 20 61 20 73 69 6e 67 6c 65 20 74 72 61 6e  in a single tran
05f0: 73 61 63 74 69 6f 6e 2e 0a 49 66 20 73 6f 6d 65  saction..If some
0600: 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67  thing goes wrong
0610: 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f   in the middle o
0620: 66 20 74 68 65 20 63 6f 6d 6d 69 74 2c 20 74 68  f the commit, th
0630: 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69  en the transacti
0640: 6f 6e 0a 69 73 20 72 6f 6c 6c 65 64 20 62 61 63  on.is rolled bac
0650: 6b 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61  k and the databa
0660: 73 65 20 69 73 20 75 6e 63 68 61 6e 67 65 64 2e  se is unchanged.
0670: 0a 3c 2f 70 3e 0a 0a 3c 68 32 3e 56 65 72 69 66  .</p>..<h2>Verif
0680: 69 63 61 74 69 6f 6e 20 4f 66 20 44 65 6c 74 61  ication Of Delta
0690: 20 45 6e 63 6f 64 69 6e 67 73 20 50 72 69 6f 72   Encodings Prior
06a0: 20 54 6f 20 54 72 61 6e 73 61 63 74 69 6f 6e 20   To Transaction 
06b0: 43 6f 6d 6d 69 74 3c 2f 68 32 3e 0a 0a 3c 70 3e  Commit</h2>..<p>
06c0: 0a 54 68 65 20 63 6f 6e 74 65 6e 74 20 66 69 6c  .The content fil
06d0: 65 73 20 74 68 61 74 20 63 6f 6d 70 72 69 73 65  es that comprise
06e0: 20 74 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 74   the global stat
06f0: 65 20 6f 66 20 61 20 66 6f 73 73 69 6c 20 72 65  e of a fossil re
0700: 73 70 6f 73 69 74 6f 72 79 0a 61 72 65 20 73 74  spository.are st
0710: 6f 72 65 64 20 69 6e 20 74 68 65 20 72 65 70 6f  ored in the repo
0720: 73 69 74 6f 72 79 20 61 73 20 61 20 74 72 65 65  sitory as a tree
0730: 2e 20 20 54 68 65 20 6c 65 61 76 65 73 20 6f 66  .  The leaves of
0740: 20 74 68 65 20 74 72 65 65 20 61 72 65 0a 73 74   the tree are.st
0750: 6f 72 65 64 20 61 73 20 7a 6c 69 62 2d 63 6f 6d  ored as zlib-com
0760: 70 72 65 73 73 65 64 20 42 4c 4f 42 73 2e 20 20  pressed BLOBs.  
0770: 49 6e 74 65 72 69 6f 72 20 6e 6f 64 65 73 20 61  Interior nodes a
0780: 72 65 20 64 65 6c 74 61 73 20 66 72 6f 6d 20 74  re deltas from t
0790: 68 65 69 72 0a 64 65 63 65 6e 64 61 6e 74 73 2e  heir.decendants.
07a0: 20 20 41 20 6c 6f 74 20 6f 66 20 65 6e 63 6f 64    A lot of encod
07b0: 69 6e 67 20 69 73 20 67 6f 69 6e 67 20 6f 6e 2e  ing is going on.
07c0: 20 20 54 68 65 72 65 20 69 73 0a 7a 6c 69 62 2d    There is.zlib-
07d0: 63 6f 6d 70 72 65 73 73 69 6f 6e 20 77 68 69 63  compression whic
07e0: 68 20 69 73 20 72 65 6c 61 74 69 76 65 6c 79 20  h is relatively 
07f0: 77 65 6c 6c 2d 74 65 73 74 65 64 20 62 75 74 20  well-tested but 
0800: 73 74 69 6c 6c 20 6d 69 67 68 74 0a 63 61 75 73  still might.caus
0810: 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 66 20  e corruption if 
0820: 75 73 65 64 20 69 6d 70 72 6f 70 65 72 6c 79 2e  used improperly.
0830: 20 20 41 6e 64 20 74 68 65 72 65 20 69 73 20 74    And there is t
0840: 68 65 20 72 65 6c 61 74 69 76 65 6c 79 0a 6e 65  he relatively.ne
0850: 77 20 64 65 6c 74 61 2d 65 6e 63 6f 64 69 6e 67  w delta-encoding
0860: 20 6d 65 63 68 61 6e 69 73 6d 20 64 65 73 69 67   mechanism desig
0870: 6e 65 64 20 65 78 70 72 65 73 73 6c 79 20 66 6f  ned expressly fo
0880: 72 20 66 6f 73 73 69 6c 2e 20 20 57 65 20 77 61  r fossil.  We wa
0890: 6e 74 0a 74 6f 20 6d 61 6b 65 20 73 75 72 65 20  nt.to make sure 
08a0: 74 68 61 74 20 62 75 67 73 20 69 6e 20 74 68 65  that bugs in the
08b0: 73 65 20 65 6e 63 6f 64 69 6e 67 20 6d 65 63 68  se encoding mech
08c0: 61 6e 69 73 6d 73 20 64 6f 20 6e 6f 74 20 6c 65  anisms do not le
08d0: 61 64 20 74 6f 0a 6c 6f 73 73 20 6f 66 20 64 61  ad to.loss of da
08e0: 74 61 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 6f  ta..</p>..<p>.To
08f0: 20 69 6e 63 72 65 61 73 65 20 6f 75 72 20 63 6f   increase our co
0900: 6e 66 69 64 65 6e 63 65 20 74 68 61 74 20 65 76  nfidence that ev
0910: 65 72 79 74 68 69 6e 67 20 69 6e 20 74 68 65 20  erything in the 
0920: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 0a 72 65  repository is.re
0930: 63 6f 76 65 72 61 62 6c 65 2c 20 66 6f 73 73 69  coverable, fossi
0940: 6c 20 6d 61 6b 65 73 20 73 75 72 65 20 69 74 20  l makes sure it 
0950: 63 61 6e 20 65 78 74 72 61 63 74 20 61 6e 20 65  can extract an e
0960: 78 61 63 74 20 72 65 70 6c 69 63 61 74 65 0a 6f  xact replicate.o
0970: 66 20 65 76 65 72 79 20 63 6f 6e 74 65 6e 74 20  f every content 
0980: 66 69 6c 65 20 74 68 61 74 20 69 74 20 63 68 61  file that it cha
0990: 6e 67 65 73 20 6a 75 73 74 20 70 72 69 6f 72 20  nges just prior 
09a0: 74 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 63  to transaction.c
09b0: 6f 6d 6d 69 74 2e 20 20 53 6f 20 64 75 72 69 6e  ommit.  So durin
09c0: 67 20 74 68 65 20 63 6f 75 72 73 65 20 6f 66 20  g the course of 
09d0: 63 68 65 63 6b 2d 69 6e 20 28 6f 72 20 6f 74 68  check-in (or oth
09e0: 65 72 20 72 65 70 6f 73 69 74 6f 72 79 0a 6f 70  er repository.op
09f0: 65 72 61 74 69 6f 6e 29 20 6d 61 6e 79 20 64 69  eration) many di
0a00: 66 66 65 72 65 6e 74 20 66 69 6c 65 73 0a 69 6e  fferent files.in
0a10: 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20   the repository 
0a20: 6d 69 67 68 74 20 62 65 20 6d 6f 64 69 66 69 65  might be modifie
0a30: 64 2e 20 20 53 6f 6d 65 20 66 69 6c 65 73 20 61  d.  Some files a
0a40: 72 65 20 73 69 6d 70 6c 79 0a 63 6f 6d 70 72 65  re simply.compre
0a50: 73 73 65 64 2e 20 20 4f 74 68 65 72 20 66 69 6c  ssed.  Other fil
0a60: 65 73 20 61 72 65 20 64 65 6c 74 61 20 65 6e 63  es are delta enc
0a70: 6f 64 65 64 20 61 6e 64 20 74 68 65 6e 20 63 6f  oded and then co
0a80: 6d 70 72 65 73 73 65 64 2e 0a 57 68 69 6c 65 20  mpressed..While 
0a90: 61 6c 6c 20 74 68 69 73 20 69 73 20 67 6f 69 6e  all this is goin
0aa0: 67 20 6f 6e 2c 20 66 6f 73 73 69 6c 20 6d 61 6b  g on, fossil mak
0ab0: 65 73 20 61 20 72 65 63 6f 72 64 20 6f 66 20 65  es a record of e
0ac0: 76 65 72 79 20 66 69 6c 65 0a 74 68 61 74 20 69  very file.that i
0ad0: 73 20 65 6e 63 6f 64 65 64 20 61 6e 64 20 74 68  s encoded and th
0ae0: 65 20 53 48 41 31 20 68 61 73 68 20 6f 66 20 74  e SHA1 hash of t
0af0: 68 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 74  he original cont
0b00: 65 6e 74 20 6f 66 20 74 68 61 74 0a 66 69 6c 65  ent of that.file
0b10: 2e 20 20 54 68 65 6e 20 6a 75 73 74 20 62 65 66  .  Then just bef
0b20: 6f 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  ore transaction 
0b30: 63 6f 6d 6d 69 74 2c 20 66 6f 73 73 69 6c 20 72  commit, fossil r
0b40: 65 2d 65 78 74 72 61 63 74 73 0a 74 68 65 20 6f  e-extracts.the o
0b50: 72 69 67 69 6e 61 6c 20 63 6f 6e 74 65 6e 74 20  riginal content 
0b60: 6f 66 20 61 6c 6c 20 66 69 6c 65 73 20 74 68 61  of all files tha
0b70: 74 20 77 65 72 65 20 77 72 69 74 74 65 6e 2c 20  t were written, 
0b80: 63 6f 6d 70 75 74 65 73 0a 74 68 65 20 53 48 41  computes.the SHA
0b90: 31 20 63 68 65 63 6b 73 75 6d 20 61 67 61 69 6e  1 checksum again
0ba0: 2c 20 61 6e 64 20 76 65 72 69 66 69 65 73 20 74  , and verifies t
0bb0: 68 61 74 20 74 68 65 20 63 68 65 63 6b 73 75 6d  hat the checksum
0bc0: 73 20 6d 61 74 63 68 2e 0a 49 66 20 61 6e 79 74  s match..If anyt
0bd0: 68 69 6e 67 20 64 6f 65 73 20 6e 6f 74 20 6d 61  hing does not ma
0be0: 74 63 68 20 75 70 2c 20 61 6e 20 65 72 72 6f 72  tch up, an error
0bf0: 0a 6d 65 73 73 61 67 65 20 69 73 20 70 72 69 6e  .message is prin
0c00: 74 65 64 20 61 6e 64 20 74 68 65 20 74 72 61 6e  ted and the tran
0c10: 73 61 63 74 69 6f 6e 20 72 6f 6c 6c 73 20 62 61  saction rolls ba
0c20: 63 6b 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 6f  ck..</p>..<p>.So
0c30: 2c 20 69 6e 20 6f 74 68 65 72 20 77 6f 72 64 73  , in other words
0c40: 2c 20 66 6f 73 73 69 6c 20 61 6c 77 61 79 73 20  , fossil always 
0c50: 63 68 65 63 6b 73 20 74 6f 20 6d 61 6b 65 20 73  checks to make s
0c60: 75 72 65 20 69 74 20 63 61 6e 0a 72 65 2d 65 78  ure it can.re-ex
0c70: 74 72 61 63 74 20 61 20 66 69 6c 65 20 62 65 66  tract a file bef
0c80: 6f 72 65 20 69 74 20 63 6f 6d 6d 69 74 73 20 61  ore it commits a
0c90: 20 63 68 61 6e 67 65 20 74 6f 20 74 68 61 74 20   change to that 
0ca0: 66 69 6c 65 2e 0a 48 65 6e 63 65 20 62 75 67 73  file..Hence bugs
0cb0: 20 69 6e 20 66 6f 73 73 69 6c 20 61 72 65 20 75   in fossil are u
0cc0: 6e 6c 69 6b 65 6c 79 20 74 6f 20 63 6f 72 72 75  nlikely to corru
0cd0: 70 74 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72  pt the repositor
0ce0: 79 20 69 6e 0a 61 20 77 61 79 20 74 68 61 74 20  y in.a way that 
0cf0: 70 72 65 76 65 6e 74 73 20 75 73 20 66 72 6f 6d  prevents us from
0d00: 20 65 78 74 72 61 63 74 69 6e 67 20 68 69 73 74   extracting hist
0d10: 6f 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20  orical versions 
0d20: 6f 66 20 0a 66 69 6c 65 73 2e 0a 3c 2f 70 3e 0a  of .files..</p>.
0d30: 0a 3c 68 32 3e 43 68 65 63 6b 73 75 6d 20 4f 76  .<h2>Checksum Ov
0d40: 65 72 20 41 6c 6c 20 46 69 6c 65 73 20 49 6e 20  er All Files In 
0d50: 41 20 42 61 73 65 6c 69 6e 65 3c 2f 68 32 3e 0a  A Baseline</h2>.
0d60: 0a 3c 70 3e 0a 4d 61 6e 69 66 65 73 74 20 61 72  .<p>.Manifest ar
0d70: 74 69 66 61 63 74 73 20 74 68 61 74 20 64 65 66  tifacts that def
0d80: 69 6e 65 20 61 20 62 61 73 65 6c 69 6e 65 20 68  ine a baseline h
0d90: 61 76 65 20 74 77 6f 20 66 69 65 6c 64 73 20 28  ave two fields (
0da0: 74 68 65 0a 52 2d 63 61 72 64 20 61 6e 64 20 5a  the.R-card and Z
0db0: 2d 63 61 72 64 29 20 74 68 61 74 20 72 65 63 6f  -card) that reco
0dc0: 72 64 20 4d 44 35 20 68 61 73 68 73 20 6f 66 20  rd MD5 hashs of 
0dd0: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 69 74 73  the manifest its
0de0: 65 6c 66 0a 61 6e 64 20 6f 66 20 61 6c 6c 20 6f  elf.and of all o
0df0: 74 68 65 72 20 66 69 6c 65 73 20 69 6e 20 74 68  ther files in th
0e00: 65 20 6d 61 6e 69 66 65 73 74 2e 20 20 50 72 69  e manifest.  Pri
0e10: 6f 72 20 74 6f 20 61 6e 79 20 63 68 65 63 6b 2d  or to any check-
0e20: 69 6e 0a 63 6f 6d 6d 69 74 2c 20 74 68 65 73 65  in.commit, these
0e30: 20 63 68 65 63 6b 73 75 6d 73 20 61 72 65 20 76   checksums are v
0e40: 65 72 69 66 69 65 64 20 74 6f 20 65 6e 73 75 72  erified to ensur
0e50: 65 20 74 68 61 74 20 74 68 65 20 62 61 73 65 6c  e that the basel
0e60: 69 6e 65 0a 63 68 65 63 6b 65 64 20 69 6e 20 61  ine.checked in a
0e70: 67 72 65 65 73 20 65 78 61 63 74 6c 79 20 77 69  grees exactly wi
0e80: 74 68 20 77 68 61 74 20 69 73 20 6f 6e 20 64 69  th what is on di
0e90: 73 6b 2e 20 20 53 69 6d 69 6c 61 72 6c 79 2c 0a  sk.  Similarly,.
0ea0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 63  the repository c
0eb0: 68 65 63 6b 73 75 6d 20 69 73 20 76 65 72 69 66  hecksum is verif
0ec0: 69 65 64 20 61 66 74 65 72 20 61 20 63 68 65 63  ied after a chec
0ed0: 6b 6f 75 74 20 74 6f 20 6d 61 6b 65 0a 73 75 72  kout to make.sur
0ee0: 65 20 74 68 61 74 20 74 68 65 20 65 6e 74 69 72  e that the entir
0ef0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 77 61 73  e repository was
0f00: 20 63 68 65 63 6b 65 64 20 6f 75 74 20 63 6f 72   checked out cor
0f10: 72 65 63 74 6c 79 2e 0a 4e 6f 74 65 20 74 68 61  rectly..Note tha
0f20: 74 20 74 68 65 73 65 20 61 64 64 65 64 20 63 68  t these added ch
0f30: 65 63 6b 73 20 75 73 65 20 61 20 64 69 66 66 65  ecks use a diffe
0f40: 72 65 6e 74 20 68 61 73 68 20 28 4d 44 35 20 69  rent hash (MD5 i
0f50: 6e 73 74 65 61 64 0a 6f 66 20 53 48 41 31 29 20  nstead.of SHA1) 
0f60: 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 76 6f 69  in order to avoi
0f70: 64 20 63 6f 6d 6d 6f 6e 2d 6d 6f 64 65 20 66 61  d common-mode fa
0f80: 69 6c 75 72 65 73 20 69 6e 20 74 68 65 20 68 61  ilures in the ha
0f90: 73 68 0a 61 6c 67 6f 72 69 74 68 6d 20 69 6d 70  sh.algorithm imp
0fa0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 3c 2f 70  lementation..</p
0fb0: 3e 0a                                            >.