Annotation of www/cvsync.html, Revision 1.84
1.58 sthen 1: <!-- DO NOT EDIT MANUALLY! See comments in www/build/mirrors.dat for details -->
1.37 steven 2:
1.6 naddy 3: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1.1 espie 4: <html>
5: <head>
6: <title>OpenBSD CVSync</title>
7: <link rev="made" href="mailto:www@openbsd.org">
8: <meta name="resource-type" content="document">
1.6 naddy 9: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
1.1 espie 10: <meta name="description" content="How to get OpenBSD updates via Internet using CVSync">
11: <meta name="keywords" content="openbsd,cvsync,updates">
12: <meta name="distribution" content="global">
1.79 sthen 13: <meta name="copyright" content="This document copyright 2003-2010 by OpenBSD.">
1.1 espie 14: </head>
15:
16: <body bgcolor="#FFFFFF" text="#000000" link="#23238E">
17:
18: <a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
19:
20: <h2><font color="#e00000">CVSync</font></h2>
21: <hr>
22:
23: <h3>Table of Contents</h3>
24: <ul>
25: <li><a href="#CVSync">What Is CVSync?</a></li>
1.10 naddy 26: <li><a href="#CVS">What Is CVS?</a></li>
1.1 espie 27: <li><a href="#starting">Getting Started Using CVSync</a></li>
1.49 nick 28: <li><a href="#using">Using CVS to Work With Your Repository</a></li>
1.1 espie 29: <li><a href="#CVSROOT">Available CVSync Servers</a></li>
30: </ul>
31:
32: <hr>
33:
34:
35: <h3><a name="CVSync"><font color="#0000e0">What Is CVSync?</font></a></h3>
36:
37: <p>
38: <b>CVSync</b> is a software package for distributing and updating source
39: trees from a master <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1">cvs(1)</a> repository on a remote server host. The OpenBSD
40: sources are maintained in a CVS repository on a central development machine
41: in Canada. With CVSync, OpenBSD users can easily keep their own source trees
1.10 naddy 42: up to date.
1.1 espie 43: </p>
44:
45: <p>
46: <b>CVSync</b> uses the so-called pull model of updating. Under the pull
47: model, each client asks the server for updates, if and when they are
48: wanted. The server waits passively for update requests from its clients.
49: Thus all updates are instigated by the client. The server never sends
50: unsolicited updates. Users must either run the <b>CVSync</b> client
51: manually to get an update, or they must set up a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cron&sektion=8">cron(8)</a> job to run it
1.10 naddy 52: automatically on a regular basis.
1.1 espie 53: </p>
54:
55: <p>
56: The term <b>CVSync</b>, capitalized just so, refers to the entire software
57: package. Its main components are the client <tt>cvsync</tt> which runs on
58: each user's machine, and the server <tt>cvsyncd</tt> which runs at each of
1.10 naddy 59: the OpenBSD CVSync mirror sites.
1.1 espie 60: </p>
61:
62: <p>
1.23 nick 63: <b>CVSync</b> is intended to be both faster and more flexible than
64: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sup&sektion=1&format=html">sup(1)</a>
65: and <a href="cvsup.html">CVSup</a>.
1.10 naddy 66: </p>
1.1 espie 67:
68: <p>
1.42 nick 69: The OpenBSD Project currently has six main source repositories:
1.1 espie 70: </p>
71:
72: <ul>
73: <li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
1.78 steven 74: <li><b>ports</b> - Houses the <a href="faq/ports/index.html">OpenBSD Ports</a>.</li>
1.10 naddy 75: <li><b>www</b> - Houses all OpenBSD web pages (including this one).</li>
1.26 matthieu 76: <li><b>X11</b> - Houses OpenBSD's adaptation of the
77: <a href="http://www.XFree86.org/">XFree86-3</a> software project.
1.51 deraadt 78: <li><b>XF4</b> - Houses OpenBSD's adaptation of the XFree86-4 source tree.
79: <li><b>xenocara</b> - Houses OpenBSD's active X.org v7 source tree.
1.1 espie 80: </ul>
81:
1.84 ! jasper 82: The <b>X11</b> and <b>XF4</b> repositories are here just for historical
! 83: purposes, most users will have no reason to use those trees, it is no longer
! 84: being used.
! 85:
1.1 espie 86: <h3><a name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
87:
88: <p>
89: CVS is the source code control system used to manage the OpenBSD source
90: tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
91: Note that CVS and CVSync are entirely different programs. Although
92: CVS can be used for remote file access, it is not optimized for
93: wholesale source tree distribution over the net, and CVSync can be
94: easily an order of magnitude more efficient for this task.
95: </p>
96:
97: <h3>
98: <a name="starting"><font color="#0000e0">Getting Started Using CVSync</font></a>
99: </h3>
100:
101: <p>
102: If you only care about running CVSync, it is recommended that you
103: download the cvsync package from the <a href="ftp.html">ftp mirror
104: sites</a> instead of building your own from the <tt>net/cvsync</tt>
1.10 naddy 105: port.
1.1 espie 106: </p>
107:
108: <p>
109: For further information about CVSync, see the
110: <a href="http://www.cvsync.org/">project homepage</a>.
111: </p>
112:
113: <p>
114: In order to mirror the OpenBSD repository with CVSync,
115: the following configuration file might be used:
116: </p>
117:
118: <pre>
119: config {
1.62 sthen 120: hostname cvsync.de.openbsd.org
1.5 naddy 121: # If your network link is a T1 or faster, comment out the following line.
1.1 espie 122: compress
1.4 espie 123: collection {
1.5 naddy 124: name openbsd release rcs
1.4 espie 125: prefix /cvs
1.5 naddy 126: umask 002
1.4 espie 127: }
1.1 espie 128: }
129: </pre>
130:
131: <p>
132: This directs cvsync to refresh all OpenBSD distributions from
1.62 sthen 133: <b>cvsync.de.openbsd.org</b> with a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=umask&sektion=2">umask(2)</a> that permits group write
1.1 espie 134: permission to the local repository.
135: </p>
136:
137: <p>
138: Assuming this file is saved as <tt>cvs-syncfile</tt>, the
139: following command would be used to invoke cvsync
140: </p>
141: <pre>
142: cvsync -c cvs-syncfile
143: </pre>
144:
145: <h3><a name="using">
1.48 nick 146: <font color="#0000e0">Using CVS to Work With Your Repository</font>
1.1 espie 147: </a></h3>
148:
149: <p>
1.48 nick 150: Now that you have a local copy of the CVS repository, it is now simple
151: to check out, update, or do any of the other CVS operations you would
152: normally do against a remote repository, locally.
1.50 nick 153: For example:
1.1 espie 154: <pre>
1.48 nick 155: cvs -d/cvs checkout src -P
156: cvs -d/cvs up -Pd
157: cvs -d/cvs diff -u file.c
1.1 espie 158: </pre>
1.48 nick 159: More details on CVS operation can be found in
160: <a href="faq/faq5.html#BldGetSrc">FAQ5, Fetching appropriate source
161: code</a> and in the
162: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1">cvs(1)</a>
163: man page.
1.1 espie 164:
165: <h3>
166: <a name="CVSROOT"><font color="#0000e0">Available CVSync Servers</font></a>
167: </h3>
168:
169: <p>The following CVSync servers are available:</p>
170:
1.3 naddy 171: <p>
1.6 naddy 172: <ul>
1.72 sthen 173: <li><strong>ftp5.eu.openbsd.org</strong><br>
174: Host also known as <strong>anga.funkfeuer.at</strong>.<br>
1.44 martin 175: Location: Vienna, Austria.<br>
176: Maintained by <a href="mailto:martin@openbsd.org">Martin Reindl</a>.<br>
1.46 martin 177: Updated every 2 hours from anoncvs1.usa.openbsd.org.<br>
1.44 martin 178: <p>
1.56 naddy 179: <li><strong>anoncvs.comstyle.com</strong><br>
180: Location: Toronto, Canada.<br>
1.57 sthen 181: Maintained by <a href="mailto:brad@comstyle.com">Brad Smith</a>.<br>
1.65 sthen 182: Updated hourly.<br>
1.56 naddy 183: <p>
1.53 sthen 184: <li><strong>anoncvs.estpak.ee</strong><br>
185: Location: Elion, Tallinn, Estonia.<br>
186: Maintained by <a href="mailto:rix@estpak.ee">Rivo Nurges</a>.<br>
1.54 tobias 187: Updated every 2 hours from cvsync.de.openbsd.org.<br>
1.53 sthen 188: <p>
1.6 naddy 189: <li><a href="http://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
1.37 steven 190: Location: Nürnberg, Germany.<br>
191: Maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.<br>
1.62 sthen 192: Updated every 3 hours.<br>
1.1 espie 193: <p>
1.37 steven 194: <li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
195: Location: Tokyo, Japan.<br>
196: Maintained by <a href="mailto:hrs@allbsd.org">Hiroki Sato</a>.<br>
1.69 sthen 197: <p>
1.77 sthen 198: <li><strong>anoncvs.eu.openbsd.org</strong><br>
199: Location: Stockholm University, Stockholm, Sweden.<br>
200: Maintained by <a href="mailto:jj@openbsd.org">Janne Johansson</a>.<br>
201: Updated every 2 hours.<br>
202: <p>
203: <li><strong>anoncvs.spacehopper.org</strong><br>
204: Location: London, United Kingdom.<br>
205: Maintained by <a href="mailto:sthen@openbsd.org">Stuart Henderson</a>.<br>
206: Updated hourly from anoncvs.ca.openbsd.org.<br>
207: <p>
208: <li><strong>anoncvs1.usa.openbsd.org</strong><br>
209: Host also known as <strong>anoncvs.usa.openbsd.org, anoncvs4.usa.openbsd.org</strong>.<br>
210: Location: Internet Software Consortium, Redwood City, CA, USA.<br>
211: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
212: Updated every 2 hours.<br>
213: <p>
214: <li><strong>anoncvs3.usa.openbsd.org</strong><br>
215: Location: National Center for Atmospheric Research, Boulder, CO, USA.<br>
216: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
217: Updated every 2 hours.<br>
218: <p>
1.37 steven 219: <li><a href="http://csociety.org/cvsup.html"><strong>cvsync.csociety.org</strong></a><br>
220: Location: Purdue University, West Lafayette, IN, USA.<br>
221: Maintained by <a href="mailto:will@csociety.purdue.edu">Will Andrews</a>.<br>
1.77 sthen 222: <p>
223: <li><strong>obsd.cec.mtu.edu</strong><br>
224: Location: Michigan Technological University, Houghton, Michigan, USA.<br>
225: Maintained by <a href="mailto:celinn@mtu.edu">Chris Linn</a>.<br>
226: Updated every 2 hours.<br>
1.37 steven 227: <p>
1.29 grunk 228:
1.12 sturm 229: </ul>
230:
231: <p>
1.2 naddy 232: <em>Note:</em> If your server is listed on here with inaccurate or
1.1 espie 233: unknown information, please contact <a
234: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
235: </p>
236: <p>
237: You may want to use <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute&sektion=8">traceroute(8)</a>
238: to find out which server is nearest you.
239: Problems with a server should be reported to the <b>maintainer</b> of the
240: server in question.
241: </p>
242: <p>
1.68 matthieu 243: As of April, 2010, the CVS repository sizes are
1.1 espie 244: </p>
245: <table>
246: <tr><td width="20"></td>
247: <td><strong>openbsd-ports</strong></td>
1.68 matthieu 248: <td>- <b>425</b>MB</td></tr>
1.1 espie 249: <tr><td></td>
250: <td><strong>openbsd-src</strong></td>
1.68 matthieu 251: <td>- <b>1684</b>MB</td></tr>
1.1 espie 252: <tr><td></td>
253: <td><strong>openbsd-www</strong></td>
1.68 matthieu 254: <td>- <b>401</b>MB</td></tr>
1.48 nick 255: <tr><td></td>
256: <td><strong>openbsd-xenocara</strong></td>
1.68 matthieu 257: <td>- <b>723</b>MB</td></tr>
1.1 espie 258: <tr><td></td>
259: <td><strong>openbsd-x11</strong></td>
260: <td>- <b>200</b>MB</td></tr>
261: <tr><td></td>
262: <td><strong>openbsd-xf4</strong></td>
1.48 nick 263: <td>- <b>564</b>MB</td></tr>
1.1 espie 264: <tr><td></td>
265: <td><strong>openbsd-cvsroot</strong></td>
1.69 sthen 266: <td>- <b>745</b>MB</td></tr>
1.1 espie 267: </table>
268: <p>
269: The overall repository size currently increases at a rate
1.22 nick 270: of about <b>400</b>MB per annum.
1.1 espie 271: </p>
272: <p>
273: <strong>IMPORTANT NOTE:</strong>
274: There are a few issues relating to cryptographic software that everyone
275: should be aware of:
276: </p>
277: <ul>
278: <li>
279: <p>
280: The OpenBSD sources are from Canada. As
281: <a href="http://www.efc.ca/pages/doc/crypto-export.html">
282: researched by a Canadian individual</a> and as
283: <a href="http://axion.physics.ubc.ca/ECL.html">
284: described in the Export Control list of Canada</a>,
285: it is legal to export crypto software from Canada to the world.
286: </p>
287: </li>
288: <li>
289: <p>
290: However, if you are outside the USA or Canada, you should not
1.8 naddy 291: fetch the cryptographic sections of the OpenBSD sources from a
292: CVSync server located in the USA. The files in question are...
1.1 espie 293: </p>
294: <ul>
295: <li><tt>src/kerberosIV/*</tt></li>
296: <li><tt>src/kerberosV/*</tt></li>
297: <li><tt>src/lib/libdes/*</tt></li>
298: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
299: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
300: <li><tt>src/sys/crypto</tt></li>
301: <li><tt>src/sys/netinet</tt></li>
302: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
303: <li><tt>XF4/xc-mit/lib/Xdmcp/Wraphelp.c</tt></li>
304: <li><tt>XF4/xc-old/lib/Xdmcp/Wraphelp.c</tt></li>
305: <li><tt>XF4/xc/lib/Xdmcp/Wraphelp.c</tt></li>
306: </ul>
307: <p>
308: Because of the USA ITAR munitions list,
309: crypto software may only be exported to Canada from the USA.
310: </p>
311: </li>
312: </ul>
313:
314: <hr>
315: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD"></a>
316: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.84 ! jasper 317: <br><small>$OpenBSD: cvsync.html.end,v 1.4 2011/03/26 15:48:52 naddy Exp $</small>
1.1 espie 318:
319: </body>
320: </html>