Annotation of www/cvsup.html, Revision 1.17
1.9 naddy 1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2: "http://http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
1.1 brian 4: <head>
5: <title>OpenBSD CVSup</title>
1.9 naddy 6: <link rev="made" href="mailto:www@openbsd.org" />
7: <meta name="resource-type" content="document" />
8: <meta name="description" content="How to get OpenBSD updates via Internet using CVSup" />
9: <meta name="keywords" content="openbsd,cvsup,updates" />
10: <meta name="distribution" content="global" />
11: <meta name="copyright" content="This document copyright 2000 by OpenBSD." />
1.1 brian 12: </head>
13:
1.7 brian 14: <body bgcolor="#FFFFFF" text="#000000" link="#23238E">
1.1 brian 15:
1.9 naddy 16: <img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" />
1.7 brian 17:
18: <h2><font color="#e00000">CVSup</font></h2>
1.9 naddy 19: <hr />
1.1 brian 20:
1.7 brian 21: <h3>Table of Contents</h3>
22: <ul>
23: <li><a href="#cvsup">What Is CVSup?</a></li>
24: <li><a href="#starting">Getting Started Using CVSup</a></li>
25: <li><a href="#using">Using CVS to Update Your Source Tree</a></li>
26: <li><a href="#checkout">Running CVSup in Checkout Mode</a></li>
27: <li><a href="#CVSROOT">Available CVSup Servers</a></li>
1.1 brian 28: </ul>
29:
1.9 naddy 30: <hr />
1.1 brian 31:
1.9 naddy 32:
33: <h3><a id="cvsup" name="cvsup"><font color="#0000e0">What Is CVSup?</font></a></h3>
1.1 brian 34:
35: <p>
36: <b>CVSup</b> is a software package for distributing and updating source
37: trees from a master CVS repository on a remote server host. The OpenBSD
38: sources are maintained in a CVS repository on a central development machine
39: in Canada. With CVSup, OpenBSD users can easily keep their own source trees
40: up to date.
41: </p>
42:
43: <p>
44: <b>CVSup</b> uses the so-called pull model of updating. Under the pull
45: model, each client asks the server for updates, if and when they are
46: wanted. The server waits passively for update requests from its clients.
47: Thus all updates are instigated by the client. The server never sends
48: unsolicited updates. Users must either run the <b>CVSup</b> client
49: manually to get an update, or they must set up a cron job to run it
50: automatically on a regular basis.
51: </p>
52:
53: <p>
54: The term <b>CVSup</b>, capitalized just so, refers to the entire software
55: package. Its main components are the client <tt>cvsup</tt> which runs on
56: each user's machine, and the server <tt>cvsupd</tt> which runs at each of
57: the OpenBSD CVSup mirror sites.
58: </p>
59:
60: <p>
61: <b>CVSup</b> is intended to be both faster and more flexible than
62: <b>sup</b>, CVSup's predecessor.
63: </p>
64:
65: <p>
66: The OpenBSD Project currently has four main source repositories:
67: </p>
68:
69: <ul>
1.9 naddy 70: <li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
71: <li><b>ports</b> - Houses the <a href="./ports.html">OpenBSD Ports</a>.</li>
72: <li><b>www</b> - Houses all OpenBSD web pages. (Including this one).</li>
73: <li><b>x11</b> - Houses OpenBSD's adaptation of the
74: <a href="http://www.XFree86.org/">XFree86</a> software project.</li>
1.1 brian 75: </ul>
76:
1.9 naddy 77: <h3><a id="CVS" name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
1.1 brian 78:
79: <p>
80: CVS is the source code control system used to manage the OpenBSD source
1.7 brian 81: tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
1.9 naddy 82: </p>
1.1 brian 83:
1.2 brian 84: <h3>
1.9 naddy 85: <a id="starting" name="starting"><font color="#0000e0">Getting Started Using CVSup</font></a>
1.2 brian 86: </h3>
1.1 brian 87:
88: <p>
89: The latest version of CVSup is available at
1.7 brian 90: <a href="http://www.polstra.com/projects/freeware/CVSup/">
1.1 brian 91: http://www.polstra.com/projects/freeware/CVSup/</a>.
92: </p>
93:
94: <p>
1.9 naddy 95: Building CVSup from the sources is not for the fainthearted since
96: it is written in Modula-3. There is a port of the CVSup client
1.11 wvdputte 97: (<tt>net/cvsup-bin</tt>) which provides John's pre-compiled executables
1.9 naddy 98: for the i386 and sparc architectures that run under FreeBSD and
99: SunOS emulation, respectively, since there is no native port of
100: Modula-3 to OpenBSD yet.
101: </p>
102:
103: <p>
1.1 brian 104: The following configuration file might be used:
105: </p>
106:
107: <pre>
108: # Defaults that apply to all the collections
109: *default release=cvs
110: *default delete use-rel-suffix
111: *default umask=002
112: *default host=cvsup.uk.OpenBSD.org
113: *default base=/cvs
114: *default prefix=/cvs
115:
116: # If your network link is a T1 or faster, comment out the following line.
117: *default compress
118:
119: OpenBSD-all
120: #OpenBSD-src
121: #OpenBSD-www
122: #OpenBSD-ports
123: #OpenBSD-x11
124: </pre>
125:
126: <p>
127: This directs cvsup to refresh all OpenBSD distributions from
128: <b>cvsup.uk.OpenBSD.org</b> with a umask that permits group write
129: permission to the local repository.
130: </p>
131:
132: <p>
133: Assuming this file is saved as <tt>cvs-supfile</tt>, the
134: following command would be used to envoke the cvsup GUI:
1.9 naddy 135: </p>
1.1 brian 136: <pre>
137: cvsup cvs-supfile
138: </pre>
1.9 naddy 139: <p>
1.1 brian 140: whereas for batch mode, the following might be used:
1.9 naddy 141: </p>
1.1 brian 142: <pre>
143: cvsup -g -L 2 cvs-supfile
144: </pre>
145:
1.9 naddy 146: <h3><a id="using" name="using">
1.7 brian 147: <font color="#0000e0">Using CVS to Update Your Source Tree</font>
1.2 brian 148: </a></h3>
1.1 brian 149:
150: <p>
1.7 brian 151: It is now simple to check out any one of the CVSup'ed repositories.
152: For Korn/Bourne shells:
1.9 naddy 153: </p>
1.7 brian 154: <pre>
155: # cd /usr
156: # CVSROOT=/cvs cvs checkout src
157: </pre>
158: <p>
159: For csh and its derivatives:
1.9 naddy 160: </p>
1.7 brian 161: <pre>
162: # cd /usr
163: # setenv CVSROOT /cvs
164: # cvs checkout src
165: </pre>
1.1 brian 166:
167: <p>
1.7 brian 168: The above will check out the most current sources. Many of you will only
1.1 brian 169: want the release sources, especially if you are patching your system. To
170: checkout release sources you must specify a tag along with your command.
171: For example:
172: </p>
1.7 brian 173: <pre>
174: # cd /usr
175: # cvs checkout -rOPENBSD_2_6 src
176: </pre>
177: <p>
178: Or <tt>OPENBSD_2_5</tt> for 2.5, etc.
179: </p>
180:
1.9 naddy 181: <h3><a id="checkout" name="checkout"><font color="#0000e0">Running CVSup in
1.7 brian 182: Checkout Mode</font></a></h3>
1.1 brian 183:
184: <p>
1.7 brian 185: As an alternative to getting the repository and using CVS, you can
186: run CVSup in checkout mode by adding a <tt>tag</tt> or <tt>date</tt>
187: keyword to your supfile, either as a <tt>*default</tt> or as an
188: option to a collection. In particular, you can use this to efficiently
189: update the source and ports trees shipped on the <a
190: href="orders.html">CDROMs</a>.
1.1 brian 191: </p>
1.7 brian 192: <p>
193: The following supfile could be used to update your ports tree:
194: </p>
195: <pre>
196: # Defaults that apply to all the collections
197: *default host=cvsup.uk.openbsd.org
198: *default base=/var
199: *default prefix=/usr
200: *default release=cvs
201: *default delete use-rel-suffix compress
202:
203: # Ports Collection.
204: OpenBSD-ports tag=.
205: </pre>
206: <p>
207: Any CVS symbolic tag can be used. A single period "." means HEAD,
208: i.e. the newest revision of all files in the main branch. Take care
209: to specify an existing tag, as CVSup cannot distinguish valid from
210: invalid tags, and an attempt to synchronize an existing source tree
211: to an invalid tag will remove all files.
212: </p>
213: <p>
214: Alternatively, use the keyword <tt>date=[cc.]yy.mm.dd.hh.mm.ss</tt>
215: to select a revision by date. All 17 or 19 characters must be
216: given as shown. For the years 2000 and beyond, specify the century
217: <var>cc</var>. For earlier years, specify only the last two digits
218: <var>yy</var>. You may also combine the <tt>tag</tt> and <tt>date</tt>
219: keywords.
220: </p>
221:
1.1 brian 222:
1.2 brian 223: <h3>
1.9 naddy 224: <a id="CVSROOT" name="CVSROOT"><font color="#0000e0">Available CVSup Servers</font></a>
1.2 brian 225: </h3>
1.1 brian 226:
1.7 brian 227: <p>The following CVSup servers are available:</p>
228:
1.1 brian 229: <dl>
1.7 brian 230: <dt><strong>cvsup.uk.OpenBSD.org</strong></dt>
231: <dd><p>
1.6 deraadt 232: located in Brighton, UK;
1.9 naddy 233: maintained by <a href="mailto:brian@OpenBSD.org">Brian Somers</a>.<br />
1.7 brian 234: updated every 2 hours.
1.9 naddy 235: </p>
1.1 brian 236: <p>
1.7 brian 237: Available collections:
1.9 naddy 238: </p>
1.1 brian 239: <table>
1.9 naddy 240: <tr><td width="20"></td>
241: <td><strong>OpenBSD-src</strong></td>
242: <td>- The <b>src</b> repository</td></tr>
243: <tr><td></td>
244: <td><strong>OpenBSD-ports</strong></td>
245: <td>- The <b>ports</b> repository</td></tr>
246: <tr><td></td>
247: <td><strong>OpenBSD-www</strong></td>
248: <td>- The <b>www</b> repository</td></tr>
249: <tr><td></td>
250: <td><strong>OpenBSD-x11</strong></td>
251: <td>- The <b>x11</b> repository</td></tr>
252: <tr><td></td>
253: <td><strong>OpenBSD-all</strong></td>
254: <td>- All OpenBSD repositories</td></tr>
1.1 brian 255: </table>
1.7 brian 256: </dd>
257: </dl>
1.1 brian 258:
1.7 brian 259: <dl>
260: <dt><strong>cvsup.de.OpenBSD.org</strong></dt>
261: <dd><p>
262: located near Frankfurt am Main, Germany;
1.9 naddy 263: maintained by <a href="mailto:wosch@FreeBSD.org">Wolfram Schneider</a>.<br />
1.7 brian 264: updated by CTM.
1.9 naddy 265: </p>
1.3 brian 266: <p>
1.7 brian 267: Available collections:
1.9 naddy 268: </p>
1.3 brian 269: <table>
1.9 naddy 270: <tr><td width="20"></td>
1.12 naddy 271: <td><strong>OpenBSD-src</strong></td>
1.9 naddy 272: <td>- The <b>src</b> repository</td></tr>
273: <tr><td></td>
1.12 naddy 274: <td><strong>OpenBSD-ports</strong></td>
1.9 naddy 275: <td>- The <b>ports</b> repository</td></tr>
276: <tr><td></td>
1.12 naddy 277: <td><strong>OpenBSD-www</strong></td>
1.9 naddy 278: <td>- The <b>www</b> repository</td></tr>
279: <tr><td></td>
1.12 naddy 280: <td><strong>OpenBSD-x11</strong></td>
281: <td>- The <b>x11</b> repository</td></tr>
282: <tr><td></td>
283: <td><strong>OpenBSD-all</strong></td>
284: <td>- All OpenBSD repositories</td></tr>
1.3 brian 285: </table>
1.7 brian 286: </dd>
287: </dl>
1.3 brian 288:
1.7 brian 289: <dl>
1.8 brian 290: <dt><strong>cvsup.hu.OpenBSD.org</strong></dt>
1.7 brian 291: <dd><p>
1.6 deraadt 292: located in Hungary;
1.9 naddy 293: maintained by <a href="mailto:mohacsi@hera.ik.bme.hu">Mohacsi Janos</a>.<br />
1.7 brian 294: Updated every 4 hours.
1.9 naddy 295: </p>
1.5 ericj 296: <p>
1.7 brian 297: Available collections:
1.9 naddy 298: </p>
1.5 ericj 299: <table>
1.9 naddy 300: <tr><td width="20"></td>
301: <td><strong>OpenBSD-src</strong></td>
302: <td>- The <b>src</b> repository</td></tr>
303: <tr><td></td>
304: <td><strong>OpenBSD-ports</strong></td>
305: <td>- The <b>ports</b> repository</td></tr>
306: <tr><td></td>
307: <td><strong>OpenBSD-www</strong></td>
308: <td>- The <b>www</b> repository</td></tr>
309: <tr><td></td>
310: <td><strong>OpenBSD-x11</strong></td>
311: <td>- The <b>x11</b> repository</td></tr>
312: <tr><td></td>
313: <td><strong>OpenBSD-all</strong></td>
314: <td>- All OpenBSD repositories</td></tr>
1.5 ericj 315: </table>
1.7 brian 316: </dd>
317: </dl>
1.1 brian 318:
1.7 brian 319: <dl>
320: <dt><strong>cvs.bsdfr.org</strong></dt>
321: <dd><p>
1.6 deraadt 322: located in France;
1.9 naddy 323: maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.<br />
1.7 brian 324: Updated every 12 hours.
1.9 naddy 325: </p>
1.6 deraadt 326: <p>
1.7 brian 327: Available collections:
1.9 naddy 328: </p>
1.6 deraadt 329: <table>
1.9 naddy 330: <tr><td width="20"></td>
331: <td><strong>OpenBSD-src</strong></td>
332: <td>- The <b>src</b> repository</td></tr>
333: <tr><td></td>
334: <td><strong>OpenBSD-ports</strong></td>
335: <td>- The <b>ports</b> repository</td></tr>
336: <tr><td></td>
337: <td><strong>OpenBSD-www</strong></td>
338: <td>- The <b>www</b> repository</td></tr>
339: <tr><td></td>
340: <td><strong>OpenBSD-all</strong></td>
341: <td>- All OpenBSD repositories</td></tr>
1.6 deraadt 342: </table>
1.7 brian 343: </dd>
344: </dl>
1.5 ericj 345:
1.14 brian 346: <dl>
1.17 ! brian 347: <dt><strong>cvsup.usa.OpenBSD.org</strong></dt>
1.14 brian 348: <dd><p>
349: located in West Lafayette, IN, USA;
350: maintained by <a href="mailto:will@csociety.ecn.purdue.edu">Will Andrews</a>.<br />
351: Updated every 2 hours.
352: </p>
353: <p>
354: Available collections:
355: </p>
356: <table>
357: <tr><td width="20"></td>
358: <td><strong>OpenBSD-src</strong></td>
359: <td>- The <b>src</b> repository</td>
360: <tr><td></td>
361: <td><strong>OpenBSD-ports</strong></td>
362: <td>- The <b>ports</b> repository</td></tr>
363: <tr><td></td>
364: <td><strong>OpenBSD-www</strong></td>
365: <td>- The <b>www</b> repository</td></tr>
366: <tr><td></td>
367: <td><strong>OpenBSD-x11</strong></td>
368: <td>- The <b>x11</b> repository</td></tr>
369: <tr><td></td>
370: <td><strong>OpenBSD-all</strong></td>
371: <td>- All OpenBSD repositories</td></tr>
372: </table>
373: </dd>
374: </dl>
375:
1.1 brian 376: <p>
1.7 brian 377: <em>Note:</em>, If your server is listed on here with inaccurate or
378: unknown information, please contact <a
1.9 naddy 379: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
380: </p>
1.1 brian 381: <p>
1.7 brian 382: You may want to use "traceroute" to find out which server is nearest you.
1.1 brian 383: Problems with a server should be reported to the <b>maintainer</b> of the
384: server in question.
1.9 naddy 385: </p>
1.1 brian 386: <p>
1.15 brian 387: Currently (as of December 6, 2000), the CVS repository sizes are
1.9 naddy 388: </p>
1.4 brian 389: <table>
1.9 naddy 390: <tr><td width="20"></td>
391: <td><strong>ports</strong></td>
1.15 brian 392: <td>- <b>41</b>MB</td></tr>
1.9 naddy 393: <tr><td></td>
394: <td><strong>src</strong></td>
1.15 brian 395: <td>- <b>689</b>MB</td></tr>
1.9 naddy 396: <tr><td></td>
397: <td><strong>www</strong></td>
1.15 brian 398: <td>- <b>34</b>MB</td></tr>
1.9 naddy 399: <tr><td></td>
400: <td><strong>x11</strong></td>
1.15 brian 401: <td>- <b>193</b>MB</td></tr>
1.4 brian 402: </table>
403: <p>
1.15 brian 404: There is an additional overhead of <b>33</b>MB for the CVSROOT and sup
405: directories. The overall repository size currently increases at a rate
406: of about <b>170</b>MB per annum.
1.9 naddy 407: </p>
1.4 brian 408: <p>
1.1 brian 409: <strong>IMPORTANT NOTE:</strong>
410: There are a few issues relating to cryptographic software that everyone
411: should be aware of:
1.9 naddy 412: </p>
1.1 brian 413: <ul>
1.9 naddy 414: <li>
415: <p>
416: The OpenBSD sources are from Canada. As
417: <a href="http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html">
418: researched by a Canadian individual</a> and as
419: <a href="http://axion.physics.ubc.ca/ECL.html">
420: described in the Export Control list of Canada</a>,
421: it is legal to export crypto software from Canada to the world.
422: </p>
423: </li>
424: <li>
425: <p>
426: However, if you are outside the USA or Canada, you should not
427: fetch the cryptographic sections of the OpenBSD sources from an
428: AnonCVS server located in the USA. The files in question are...
429: </p>
430: <ul>
431: <li><tt>src/kerberosIV/*</tt></li>
432: <li><tt>src/lib/libdes/*</tt></li>
433: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
434: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
435: <li><tt>src/sys/netinet</tt></li>
436: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
437: <li><tt>X11/xc/lib/Xdmcp/Wraphelp.c</tt></li>
438: </ul>
439: <p>
440: Because of the USA ITAR munitions list,
441: crypto software may only be exported to Canada from the USA.
442: </p>
443: </li>
1.1 brian 444: </ul>
445:
446: <p>
447: The OpenBSD project is looking for more CVSup servers -- if you are
1.7 brian 448: interested, please contact <a href="mailto:brian@OpenBSD.org">Brian Somers</a>
1.1 brian 449: for configuration details.
450: </p>
451:
1.9 naddy 452: <hr />
453: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
1.7 brian 454: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.13 jufi 455: <br />
1.17 ! brian 456: <small>$OpenBSD: cvsup.html,v 1.16 2001/01/16 22:39:52 brian Exp $</small>
1.1 brian 457:
458: </body>
459: </html>