Artifact f5f93db90a0856b07674507f1f503cd50377b7ea:
File www/pop.html part of check-in [852dbbb65d] - Update homepage with links to competing projects. by drh on 2008-02-13 12:39:19. Also file www/pop.html part of check-in [588bb7cd73] - Merged to ed26056bb5. by aku on 2008-02-24 18:50:35.
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 2d 20 50 72 itle>Fossil - Pr 0020: 69 6e 63 69 70 6c 65 73 20 6f 66 20 4f 70 65 72 inciples of Oper 0030: 61 74 69 6f 6e 3c 2f 74 69 74 6c 65 3e 0a 3c 2f ation</title>.</ 0040: 68 65 61 64 3e 0a 3c 62 6f 64 79 20 62 67 63 6f head>.<body bgco 0050: 6c 6f 72 3d 22 77 68 69 74 65 22 3e 0a 3c 70 3e lor="white">.<p> 0060: 5b 20 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78 [ <a href="index 0070: 2e 68 74 6d 6c 22 3e 49 6e 64 65 78 3c 2f 61 3e .html">Index</a> 0080: 20 5d 3c 2f 70 3e 0a 3c 68 72 3e 0a 3c 68 31 3e ]</p>.<hr>.<h1> 0090: 50 72 69 6e 63 69 70 6c 65 73 20 4f 66 20 4f 70 Principles Of Op 00a0: 65 72 61 74 69 6f 6e 3c 2f 68 31 3e 0a 0a 3c 70 eration</h1>..<p 00b0: 3e 0a 54 68 69 73 20 70 61 67 65 20 61 74 74 65 >.This page atte 00c0: 6d 70 74 73 20 74 6f 20 64 65 66 69 6e 65 20 74 mpts to define t 00d0: 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e 61 6c 20 he foundational 00e0: 70 72 69 6e 63 69 70 61 6c 73 20 75 70 6f 6e 0a principals upon. 00f0: 77 68 69 63 68 20 46 6f 73 73 69 6c 20 69 73 20 which Fossil is 0100: 62 75 69 6c 74 2e 0a 3c 2f 70 3e 0a 0a 3c 75 6c built..</p>..<ul 0110: 3e 0a 3c 6c 69 3e 3c 70 3e 41 20 70 72 6f 6a 65 >.<li><p>A proje 0120: 63 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 73 ct consists of s 0130: 6f 75 72 63 65 20 66 69 6c 65 73 2c 20 77 69 6b ource files, wik 0140: 69 20 70 61 67 65 73 2c 20 61 6e 64 20 0a 74 72 i pages, and .tr 0150: 6f 75 62 6c 65 20 74 69 63 6b 65 74 73 2c 20 61 ouble tickets, a 0160: 6e 64 20 63 6f 6e 74 72 6f 6c 20 66 69 6c 65 73 nd control files 0170: 20 28 63 6f 6c 6c 65 63 74 69 76 65 6c 79 20 22 (collectively " 0180: 61 72 74 69 66 61 63 74 73 22 29 2e 0a 41 6c 6c artifacts")..All 0190: 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 70 69 historical copi 01a0: 65 73 20 6f 66 20 61 6c 6c 20 61 72 74 69 66 61 es of all artifa 01b0: 63 74 73 0a 61 72 65 20 73 61 76 65 64 2e 20 20 cts.are saved. 01c0: 54 68 65 20 70 72 6f 6a 65 63 74 20 6d 61 69 6e The project main 01d0: 74 61 69 6e 73 20 61 6e 20 61 75 64 69 74 0a 74 tains an audit.t 01e0: 72 61 69 6c 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a rail.</p></li>.. 01f0: 3c 6c 69 3e 3c 70 3e 41 20 70 72 6f 6a 65 63 74 <li><p>A project 0200: 20 72 65 73 69 64 65 73 20 69 6e 20 6f 6e 65 20 resides in one 0210: 6f 72 20 6d 6f 72 65 20 72 65 70 6f 73 69 74 6f or more reposito 0220: 72 69 65 73 2e 20 20 45 61 63 68 0a 72 65 70 6f ries. Each.repo 0230: 73 69 74 6f 72 79 20 69 73 20 61 64 6d 69 6e 69 sitory is admini 0240: 73 74 65 72 65 64 20 61 6e 64 20 6f 70 65 72 61 stered and opera 0250: 74 65 73 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c tes independentl 0260: 79 20 0a 6f 66 20 74 68 65 20 6f 74 68 65 72 73 y .of the others 0270: 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li> 0280: 3c 70 3e 45 61 63 68 20 72 65 70 6f 73 69 74 6f <p>Each reposito 0290: 72 79 20 68 61 73 20 62 6f 74 68 20 67 6c 6f 62 ry has both glob 02a0: 61 6c 20 61 6e 64 20 6c 6f 63 61 6c 20 73 74 61 al and local sta 02b0: 74 65 2e 20 20 54 68 65 0a 67 6c 6f 62 61 6c 20 te. The.global 02c0: 73 74 61 74 65 20 69 73 20 63 6f 6d 6d 6f 6e 20 state is common 02d0: 74 6f 20 61 6c 6c 20 72 65 70 6f 73 69 74 6f 72 to all repositor 02e0: 69 65 73 20 28 6f 72 20 61 74 20 6c 65 61 73 74 ies (or at least 02f0: 0a 68 61 73 20 74 68 65 20 70 6f 74 65 6e 74 69 .has the potenti 0300: 61 6c 20 74 6f 20 62 65 20 73 68 61 72 65 64 20 al to be shared 0310: 69 6e 20 63 6f 6d 6d 6f 6e 20 77 68 65 6e 20 74 in common when t 0320: 68 65 0a 72 65 70 6f 73 69 74 6f 72 69 65 73 20 he.repositories 0330: 61 72 65 20 66 75 6c 6c 79 20 73 79 6e 63 68 72 are fully synchr 0340: 6f 6e 69 7a 65 64 29 2e 20 20 54 68 65 20 6c 6f onized). The lo 0350: 63 61 6c 20 73 74 61 74 65 0a 66 6f 72 20 65 61 cal state.for ea 0360: 63 68 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 ch repository is 0370: 20 70 72 69 76 61 74 65 20 74 6f 20 74 68 61 74 private to that 0380: 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 54 68 65 repository..The 0390: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 72 65 global state re 03a0: 70 72 65 73 65 6e 74 73 20 74 68 65 20 63 6f 6e presents the con 03b0: 74 65 6e 74 20 6f 66 20 74 68 65 20 70 72 6f 6a tent of the proj 03c0: 65 63 74 2e 0a 54 68 65 20 6c 6f 63 61 6c 20 73 ect..The local s 03d0: 74 61 74 65 20 69 64 65 6e 74 69 66 69 65 73 20 tate identifies 03e0: 74 68 65 20 61 75 74 68 6f 72 69 7a 65 64 20 75 the authorized u 03f0: 73 65 72 73 20 61 6e 64 0a 61 63 63 65 73 73 20 sers and.access 0400: 70 6f 6c 69 63 69 65 73 20 66 6f 72 20 61 20 70 policies for a p 0410: 61 72 74 69 63 75 6c 61 72 20 72 65 70 6f 73 69 articular reposi 0420: 74 6f 72 79 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a tory.</p></li>.. 0430: 3c 6c 69 3e 3c 70 3e 54 68 65 20 67 6c 6f 62 61 <li><p>The globa 0440: 6c 20 73 74 61 74 65 20 6f 66 20 61 20 72 65 70 l state of a rep 0450: 6f 73 69 74 6f 72 79 20 69 73 20 61 6e 20 75 6e ository is an un 0460: 6f 72 64 65 72 65 64 0a 63 6f 6c 6c 65 63 74 69 ordered.collecti 0470: 6f 6e 20 6f 66 20 61 72 74 69 66 61 63 74 73 2e on of artifacts. 0480: 20 20 45 61 63 68 20 61 72 74 69 66 61 63 74 20 Each artifact 0490: 69 73 20 6e 61 6d 65 64 20 62 79 20 0a 69 74 73 is named by .its 04a0: 20 53 48 41 31 20 68 61 73 68 20 65 6e 63 6f 64 SHA1 hash encod 04b0: 65 64 20 69 6e 20 6c 6f 77 65 72 63 61 73 65 20 ed in lowercase 04c0: 68 65 78 61 64 65 63 69 6d 61 6c 2e 0a 49 6e 20 hexadecimal..In 04d0: 6d 61 6e 79 20 63 6f 6e 74 65 78 74 73 2c 20 74 many contexts, t 04e0: 68 65 20 6e 61 6d 65 20 63 61 6e 20 62 65 0a 61 he name can be.a 04f0: 62 62 72 65 76 69 61 74 65 64 20 74 6f 20 61 20 bbreviated to a 0500: 75 6e 69 71 75 65 20 70 72 65 66 69 78 2e 20 20 unique prefix. 0510: 41 20 66 69 76 65 2d 20 6f 72 20 73 69 78 2d 63 A five- or six-c 0520: 68 61 72 61 63 74 65 72 0a 70 72 65 66 69 78 20 haracter.prefix 0530: 75 73 75 61 6c 6c 79 20 73 75 66 66 69 63 65 73 usually suffices 0540: 20 74 6f 20 75 6e 69 71 75 65 6c 79 20 69 64 65 to uniquely ide 0550: 6e 74 69 66 79 20 61 20 66 69 6c 65 2e 3c 2f 70 ntify a file.</p 0560: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 42 ></li>..<li><p>B 0570: 65 63 61 75 73 65 20 61 72 74 69 66 61 63 74 73 ecause artifacts 0580: 20 61 72 65 20 6e 61 6d 65 64 20 62 79 20 74 68 are named by th 0590: 65 69 72 20 53 48 41 31 20 68 61 73 68 2c 20 61 eir SHA1 hash, a 05a0: 6c 6c 20 61 72 74 69 66 61 63 74 73 0a 61 72 65 ll artifacts.are 05b0: 20 69 6d 6d 75 74 61 62 6c 65 2e 20 20 41 6e 79 immutable. Any 05c0: 20 63 68 61 6e 67 65 20 74 6f 20 74 68 65 20 63 change to the c 05d0: 6f 6e 74 65 6e 74 20 6f 66 20 61 20 61 72 74 69 ontent of a arti 05e0: 66 61 63 74 20 61 6c 73 6f 20 0a 63 68 61 6e 67 fact also .chang 05f0: 65 73 20 74 68 65 20 68 61 73 68 20 74 68 61 74 es the hash that 0600: 20 66 6f 72 6d 73 20 74 68 65 20 61 72 74 69 66 forms the artif 0610: 61 63 74 73 20 6e 61 6d 65 2c 20 74 68 75 73 0a acts name, thus. 0620: 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 61 creating a new a 0630: 72 74 69 66 61 63 74 2e 20 20 42 6f 74 68 20 74 rtifact. Both t 0640: 68 65 20 6f 6c 64 20 6f 72 69 67 69 6e 61 6c 20 he old original 0650: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 0a 61 version of the.a 0660: 72 74 69 66 61 63 74 20 61 6e 64 20 74 68 65 20 rtifact and the 0670: 6e 65 77 20 63 68 61 6e 67 65 20 61 72 65 20 70 new change are p 0680: 72 65 73 65 72 76 65 64 20 75 6e 64 65 72 20 64 reserved under d 0690: 69 66 66 65 72 65 6e 74 20 6e 61 6d 65 73 2e 3c ifferent names.< 06a0: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 /p></li>..<li><p 06b0: 3e 49 74 20 69 73 20 74 68 65 6f 72 65 74 69 63 >It is theoretic 06c0: 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 66 6f ally possible fo 06d0: 72 20 74 77 6f 20 61 72 74 69 66 61 63 74 73 20 r two artifacts 06e0: 77 69 74 68 20 64 69 66 66 65 72 65 6e 74 0a 63 with different.c 06f0: 6f 6e 74 65 6e 74 20 74 6f 20 73 68 61 72 65 20 ontent to share 0700: 74 68 65 20 73 61 6d 65 20 68 61 73 68 2e 20 20 the same hash. 0710: 42 75 74 20 66 69 6e 64 69 6e 67 20 74 77 6f 20 But finding two 0720: 73 75 63 68 0a 61 72 74 69 66 61 63 74 73 20 69 such.artifacts i 0730: 73 20 73 6f 20 69 6e 63 72 65 64 69 62 6c 79 20 s so incredibly 0740: 64 69 66 66 69 63 75 6c 74 20 61 6e 64 20 75 6e difficult and un 0750: 6c 69 6b 65 6c 79 20 74 68 61 74 20 77 65 0a 63 likely that we.c 0760: 6f 6e 73 69 64 65 72 20 69 74 20 74 6f 20 62 65 onsider it to be 0770: 20 61 6e 20 69 6d 70 6f 73 73 69 62 69 6c 69 74 an impossibilit 0780: 79 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 y.</p></li>..<li 0790: 3e 3c 70 3e 54 68 65 20 73 69 67 6e 61 74 75 72 ><p>The signatur 07a0: 65 20 6f 66 20 61 6e 20 61 72 74 69 66 61 63 74 e of an artifact 07b0: 20 69 73 20 74 68 65 20 53 48 41 31 20 68 61 73 is the SHA1 has 07c0: 68 20 6f 66 20 74 68 65 20 0a 61 72 74 69 66 61 h of the .artifa 07d0: 63 74 20 69 74 73 65 6c 66 2c 20 65 78 61 63 74 ct itself, exact 07e0: 6c 79 20 61 73 20 69 74 20 77 6f 75 6c 64 20 61 ly as it would a 07f0: 70 70 65 61 72 20 69 6e 20 61 20 64 69 73 6b 20 ppear in a disk 0800: 66 69 6c 65 2e 20 20 4e 6f 20 70 72 65 66 69 78 file. No prefix 0810: 0a 6f 72 20 6d 65 74 61 2d 69 6e 66 6f 72 6d 61 .or meta-informa 0820: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 61 tion about the a 0830: 72 74 69 66 61 63 74 20 69 73 20 61 64 64 65 64 rtifact is added 0840: 20 62 65 66 6f 72 65 20 63 6f 6d 70 75 74 69 6e before computin 0850: 67 0a 74 68 65 20 68 61 73 68 2e 20 20 53 6f 20 g.the hash. So 0860: 79 6f 75 20 63 61 6e 0a 61 6c 77 61 79 73 20 66 you can.always f 0870: 69 6e 64 20 74 68 65 20 53 48 41 31 20 73 69 67 ind the SHA1 sig 0880: 6e 61 74 75 72 65 20 6f 66 20 61 20 66 69 6c 65 nature of a file 0890: 20 62 79 20 75 73 69 6e 67 20 74 68 65 0a 22 73 by using the."s 08a0: 68 61 31 73 75 6d 22 20 63 6f 6d 6d 61 6e 64 2d ha1sum" command- 08b0: 6c 69 6e 65 20 75 74 69 6c 69 74 79 2e 3c 2f 70 line utility.</p 08c0: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 ></li>..<li><p>T 08d0: 68 65 20 61 72 74 69 66 61 63 74 73 20 74 68 61 he artifacts tha 08e0: 74 20 63 6f 6d 70 72 69 73 65 20 74 68 65 20 67 t comprise the g 08f0: 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f 66 20 61 lobal state of a 0900: 20 72 65 70 6f 73 69 74 6f 72 79 0a 61 72 65 20 repository.are 0910: 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 67 6c 6f the complete glo 0920: 62 61 6c 20 73 74 61 74 65 20 6f 66 20 74 68 61 bal state of tha 0930: 74 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 54 t repository. T 0940: 68 65 20 53 51 4c 69 74 65 0a 64 61 74 61 62 61 he SQLite.databa 0950: 73 65 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68 se that holds th 0960: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 63 6f 6e e repository con 0970: 74 61 69 6e 73 20 61 64 64 69 74 69 6f 6e 61 6c tains additional 0980: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 61 62 6f information.abo 0990: 75 74 20 6c 69 6e 6b 61 67 65 73 20 62 65 74 77 ut linkages betw 09a0: 65 65 6e 20 61 72 74 69 66 61 63 74 73 2c 20 62 een artifacts, b 09b0: 75 74 20 61 6c 6c 20 6f 66 20 74 68 61 74 20 61 ut all of that a 09c0: 64 64 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e dded information 09d0: 0a 63 61 6e 20 62 65 20 64 69 73 63 61 72 64 65 .can be discarde 09e0: 64 20 61 6e 64 20 72 65 63 6f 6e 73 74 72 75 63 d and reconstruc 09f0: 74 65 64 20 62 79 20 72 65 73 63 61 6e 6e 69 6e ted by rescannin 0a00: 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 61 72 g the content.ar 0a10: 74 69 66 61 63 74 73 2e 3c 2f 70 3e 3c 2f 6c 69 tifacts.</p></li 0a20: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 77 6f 20 72 65 >..<li><p>Two re 0a30: 70 6f 73 69 74 6f 72 69 65 73 20 66 6f 72 20 74 positories for t 0a40: 68 65 20 73 61 6d 65 20 70 72 6f 6a 65 63 74 20 he same project 0a50: 63 61 6e 20 73 79 6e 63 68 72 6f 6e 69 7a 65 0a can synchronize. 0a60: 74 68 65 69 72 20 67 6c 6f 62 61 6c 20 73 74 61 their global sta 0a70: 74 65 73 20 73 69 6d 70 6c 79 20 62 79 20 73 68 tes simply by sh 0a80: 61 72 69 6e 67 20 61 72 74 69 66 61 63 74 73 2e aring artifacts. 0a90: 20 20 54 68 65 20 6c 6f 63 61 6c 0a 73 74 61 74 The local.stat 0aa0: 65 20 6f 66 20 72 65 70 6f 73 69 74 6f 72 69 65 e of repositorie 0ab0: 73 20 69 73 20 6e 6f 74 20 6e 6f 72 6d 61 6c 6c s is not normall 0ac0: 79 20 73 79 6e 63 68 72 6f 6e 69 7a 65 64 20 6f y synchronized o 0ad0: 72 0a 73 68 61 72 65 64 2e 3c 2f 70 3e 3c 2f 6c r.shared.</p></l 0ae0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 45 76 65 72 79 i>..<li><p>Every 0af0: 20 62 61 73 65 6c 69 6e 65 20 68 61 73 20 61 20 baseline has a 0b00: 73 70 65 63 69 61 6c 20 66 69 6c 65 20 61 74 20 special file at 0b10: 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 0a 6e 61 the top-level.na 0b20: 6d 65 64 20 22 6d 61 6e 69 66 65 73 74 22 20 77 med "manifest" w 0b30: 68 69 63 68 20 69 73 20 61 6e 20 69 6e 64 65 78 hich is an index 0b40: 20 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 69 of all other fi 0b50: 6c 65 73 20 69 6e 0a 74 68 61 74 20 62 61 73 65 les in.that base 0b60: 6c 69 6e 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 line. The manif 0b70: 65 73 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 est is automatic 0b80: 61 6c 6c 79 20 63 72 65 61 74 65 64 20 61 6e 64 ally created and 0b90: 0a 6d 61 69 6e 74 61 69 6e 65 64 20 62 79 20 74 .maintained by t 0ba0: 68 65 20 73 79 73 74 65 6d 2e 3c 2f 70 3e 3c 2f he system.</p></ 0bb0: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 li>..<li><p>The 0bc0: 3c 61 20 68 72 65 66 3d 22 66 69 6c 65 66 6f 72 <a href="filefor 0bd0: 6d 61 74 2e 68 74 6d 6c 22 3e 66 69 6c 65 20 66 mat.html">file f 0be0: 6f 72 6d 61 74 73 3c 2f 61 3e 0a 75 73 65 64 20 ormats</a>.used 0bf0: 62 79 20 46 6f 73 73 69 6c 20 61 72 65 20 61 6c by Fossil are al 0c00: 6c 20 76 65 72 79 20 73 69 6d 70 6c 65 20 73 6f l very simple so 0c10: 20 74 68 61 74 20 77 69 74 68 20 61 63 63 65 73 that with acces 0c20: 73 0a 74 6f 20 74 68 65 20 6f 72 69 67 69 6e 61 s.to the origina 0c30: 6c 20 63 6f 6e 74 65 6e 74 20 66 69 6c 65 73 2c l content files, 0c40: 20 6f 6e 65 20 63 61 6e 20 65 61 73 69 6c 79 20 one can easily 0c50: 72 65 63 6f 6e 73 74 72 75 63 74 0a 74 68 65 20 reconstruct.the 0c60: 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 62 61 73 content of a bas 0c70: 65 6c 69 6e 65 20 77 69 74 68 6f 75 74 20 74 68 eline without th 0c80: 65 20 6e 65 65 64 20 66 6f 72 20 61 6e 79 0a 73 e need for any.s 0c90: 70 65 63 69 61 6c 20 74 6f 6f 6c 73 20 6f 72 20 pecial tools or 0ca0: 73 6f 66 74 77 61 72 65 2e 3c 2f 70 3e 3c 2f 6c software.</p></l 0cb0: 69 3e 0a 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 i>..</body>.</ht 0cc0: 6d 6c 3e 0a ml>.