Annotation of www/cvsup.html, Revision 1.20
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
1.20 ! brian 74: <a href="http://www.XFree86.org/">XFree86-3</a> software project.</li>
! 75: <li><b>xf4</b> - Houses OpenBSD's adaptation of the
! 76: <a href="http://www.XFree86.org/">XFree86-4</a> software project.</li>
1.1 brian 77: </ul>
78:
1.9 naddy 79: <h3><a id="CVS" name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
1.1 brian 80:
81: <p>
82: CVS is the source code control system used to manage the OpenBSD source
1.7 brian 83: tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
1.9 naddy 84: </p>
1.1 brian 85:
1.2 brian 86: <h3>
1.9 naddy 87: <a id="starting" name="starting"><font color="#0000e0">Getting Started Using CVSup</font></a>
1.2 brian 88: </h3>
1.1 brian 89:
90: <p>
91: The latest version of CVSup is available at
1.7 brian 92: <a href="http://www.polstra.com/projects/freeware/CVSup/">
1.1 brian 93: http://www.polstra.com/projects/freeware/CVSup/</a>.
94: </p>
95:
96: <p>
1.9 naddy 97: Building CVSup from the sources is not for the fainthearted since
98: it is written in Modula-3. There is a port of the CVSup client
1.11 wvdputte 99: (<tt>net/cvsup-bin</tt>) which provides John's pre-compiled executables
1.9 naddy 100: for the i386 and sparc architectures that run under FreeBSD and
101: SunOS emulation, respectively, since there is no native port of
102: Modula-3 to OpenBSD yet.
103: </p>
104:
105: <p>
1.1 brian 106: The following configuration file might be used:
107: </p>
108:
109: <pre>
110: # Defaults that apply to all the collections
111: *default release=cvs
112: *default delete use-rel-suffix
113: *default umask=002
114: *default host=cvsup.uk.OpenBSD.org
115: *default base=/cvs
116: *default prefix=/cvs
117:
118: # If your network link is a T1 or faster, comment out the following line.
119: *default compress
120:
121: OpenBSD-all
122: #OpenBSD-src
123: #OpenBSD-www
124: #OpenBSD-ports
125: #OpenBSD-x11
1.20 ! brian 126: #OpenBSD-xf4
1.1 brian 127: </pre>
128:
129: <p>
130: This directs cvsup to refresh all OpenBSD distributions from
131: <b>cvsup.uk.OpenBSD.org</b> with a umask that permits group write
132: permission to the local repository.
133: </p>
134:
135: <p>
136: Assuming this file is saved as <tt>cvs-supfile</tt>, the
137: following command would be used to envoke the cvsup GUI:
1.9 naddy 138: </p>
1.1 brian 139: <pre>
140: cvsup cvs-supfile
141: </pre>
1.9 naddy 142: <p>
1.1 brian 143: whereas for batch mode, the following might be used:
1.9 naddy 144: </p>
1.1 brian 145: <pre>
146: cvsup -g -L 2 cvs-supfile
147: </pre>
148:
1.9 naddy 149: <h3><a id="using" name="using">
1.7 brian 150: <font color="#0000e0">Using CVS to Update Your Source Tree</font>
1.2 brian 151: </a></h3>
1.1 brian 152:
153: <p>
1.7 brian 154: It is now simple to check out any one of the CVSup'ed repositories.
155: For Korn/Bourne shells:
1.9 naddy 156: </p>
1.7 brian 157: <pre>
158: # cd /usr
159: # CVSROOT=/cvs cvs checkout src
160: </pre>
161: <p>
162: For csh and its derivatives:
1.9 naddy 163: </p>
1.7 brian 164: <pre>
165: # cd /usr
166: # setenv CVSROOT /cvs
167: # cvs checkout src
168: </pre>
1.1 brian 169:
170: <p>
1.7 brian 171: The above will check out the most current sources. Many of you will only
1.1 brian 172: want the release sources, especially if you are patching your system. To
173: checkout release sources you must specify a tag along with your command.
174: For example:
175: </p>
1.7 brian 176: <pre>
177: # cd /usr
178: # cvs checkout -rOPENBSD_2_6 src
179: </pre>
180: <p>
181: Or <tt>OPENBSD_2_5</tt> for 2.5, etc.
182: </p>
183:
1.9 naddy 184: <h3><a id="checkout" name="checkout"><font color="#0000e0">Running CVSup in
1.7 brian 185: Checkout Mode</font></a></h3>
1.1 brian 186:
187: <p>
1.7 brian 188: As an alternative to getting the repository and using CVS, you can
189: run CVSup in checkout mode by adding a <tt>tag</tt> or <tt>date</tt>
190: keyword to your supfile, either as a <tt>*default</tt> or as an
191: option to a collection. In particular, you can use this to efficiently
192: update the source and ports trees shipped on the <a
193: href="orders.html">CDROMs</a>.
1.1 brian 194: </p>
1.7 brian 195: <p>
196: The following supfile could be used to update your ports tree:
197: </p>
198: <pre>
199: # Defaults that apply to all the collections
200: *default host=cvsup.uk.openbsd.org
201: *default base=/var
202: *default prefix=/usr
203: *default release=cvs
204: *default delete use-rel-suffix compress
205:
206: # Ports Collection.
207: OpenBSD-ports tag=.
208: </pre>
209: <p>
210: Any CVS symbolic tag can be used. A single period "." means HEAD,
211: i.e. the newest revision of all files in the main branch. Take care
212: to specify an existing tag, as CVSup cannot distinguish valid from
213: invalid tags, and an attempt to synchronize an existing source tree
214: to an invalid tag will remove all files.
215: </p>
216: <p>
217: Alternatively, use the keyword <tt>date=[cc.]yy.mm.dd.hh.mm.ss</tt>
218: to select a revision by date. All 17 or 19 characters must be
219: given as shown. For the years 2000 and beyond, specify the century
220: <var>cc</var>. For earlier years, specify only the last two digits
221: <var>yy</var>. You may also combine the <tt>tag</tt> and <tt>date</tt>
222: keywords.
223: </p>
224:
1.1 brian 225:
1.2 brian 226: <h3>
1.9 naddy 227: <a id="CVSROOT" name="CVSROOT"><font color="#0000e0">Available CVSup Servers</font></a>
1.2 brian 228: </h3>
1.1 brian 229:
1.7 brian 230: <p>The following CVSup servers are available:</p>
231:
1.1 brian 232: <dl>
1.19 brian 233: <a href="http://cvsup.uk.OpenBSD.org"><dt><strong>cvsup.uk.OpenBSD.org</strong></dt></a>
1.7 brian 234: <dd><p>
1.6 deraadt 235: located in Brighton, UK;
1.9 naddy 236: maintained by <a href="mailto:brian@OpenBSD.org">Brian Somers</a>.<br />
1.7 brian 237: updated every 2 hours.
1.9 naddy 238: </p>
1.1 brian 239: <p>
1.7 brian 240: Available collections:
1.9 naddy 241: </p>
1.1 brian 242: <table>
1.9 naddy 243: <tr><td width="20"></td>
244: <td><strong>OpenBSD-src</strong></td>
245: <td>- The <b>src</b> repository</td></tr>
246: <tr><td></td>
247: <td><strong>OpenBSD-ports</strong></td>
248: <td>- The <b>ports</b> repository</td></tr>
249: <tr><td></td>
250: <td><strong>OpenBSD-www</strong></td>
251: <td>- The <b>www</b> repository</td></tr>
252: <tr><td></td>
253: <td><strong>OpenBSD-x11</strong></td>
1.20 ! brian 254: <td>- The <b>XFree86-3</b> repository</td></tr>
! 255: <tr><td></td>
! 256: <td><strong>OpenBSD-xf4</strong></td>
! 257: <td>- The <b>XFree86-4</b> repository</td></tr>
1.9 naddy 258: <tr><td></td>
259: <td><strong>OpenBSD-all</strong></td>
260: <td>- All OpenBSD repositories</td></tr>
1.1 brian 261: </table>
1.7 brian 262: </dd>
263: </dl>
1.1 brian 264:
1.7 brian 265: <dl>
266: <dt><strong>cvsup.de.OpenBSD.org</strong></dt>
267: <dd><p>
268: located near Frankfurt am Main, Germany;
1.9 naddy 269: maintained by <a href="mailto:wosch@FreeBSD.org">Wolfram Schneider</a>.<br />
1.7 brian 270: updated by CTM.
1.9 naddy 271: </p>
1.3 brian 272: <p>
1.7 brian 273: Available collections:
1.9 naddy 274: </p>
1.3 brian 275: <table>
1.9 naddy 276: <tr><td width="20"></td>
1.12 naddy 277: <td><strong>OpenBSD-src</strong></td>
1.9 naddy 278: <td>- The <b>src</b> repository</td></tr>
279: <tr><td></td>
1.12 naddy 280: <td><strong>OpenBSD-ports</strong></td>
1.9 naddy 281: <td>- The <b>ports</b> repository</td></tr>
282: <tr><td></td>
1.12 naddy 283: <td><strong>OpenBSD-www</strong></td>
1.9 naddy 284: <td>- The <b>www</b> repository</td></tr>
285: <tr><td></td>
1.12 naddy 286: <td><strong>OpenBSD-x11</strong></td>
1.20 ! brian 287: <td>- The <b>XFree86-3</b> repository</td></tr>
1.12 naddy 288: <tr><td></td>
289: <td><strong>OpenBSD-all</strong></td>
290: <td>- All OpenBSD repositories</td></tr>
1.3 brian 291: </table>
1.7 brian 292: </dd>
293: </dl>
1.3 brian 294:
1.7 brian 295: <dl>
1.8 brian 296: <dt><strong>cvsup.hu.OpenBSD.org</strong></dt>
1.7 brian 297: <dd><p>
1.6 deraadt 298: located in Hungary;
1.9 naddy 299: maintained by <a href="mailto:mohacsi@hera.ik.bme.hu">Mohacsi Janos</a>.<br />
1.7 brian 300: Updated every 4 hours.
1.9 naddy 301: </p>
1.5 ericj 302: <p>
1.7 brian 303: Available collections:
1.9 naddy 304: </p>
1.5 ericj 305: <table>
1.9 naddy 306: <tr><td width="20"></td>
307: <td><strong>OpenBSD-src</strong></td>
308: <td>- The <b>src</b> repository</td></tr>
309: <tr><td></td>
310: <td><strong>OpenBSD-ports</strong></td>
311: <td>- The <b>ports</b> repository</td></tr>
312: <tr><td></td>
313: <td><strong>OpenBSD-www</strong></td>
314: <td>- The <b>www</b> repository</td></tr>
315: <tr><td></td>
316: <td><strong>OpenBSD-x11</strong></td>
1.20 ! brian 317: <td>- The <b>XFree86-3</b> repository</td></tr>
1.9 naddy 318: <tr><td></td>
319: <td><strong>OpenBSD-all</strong></td>
320: <td>- All OpenBSD repositories</td></tr>
1.5 ericj 321: </table>
1.7 brian 322: </dd>
323: </dl>
1.1 brian 324:
1.7 brian 325: <dl>
1.19 brian 326: <dt><strong>cvsup-openbsd.leo.org</strong></dt>
1.18 beck 327: <dd><p>
328: located in Munich, Germany;
329: maintained by <a href="mailto:dl@leo.org">Daniel Lang</a>.<br />
1.19 brian 330: Updated every 24 hours.
1.18 beck 331: </p>
332: <p>
333: Available collections:
334: </p>
335: <table>
336: <tr><td width="20"></td>
337: <td><strong>OpenBSD-src</strong></td>
338: <td>- The <b>src</b> repository</td></tr>
339: <tr><td></td>
340: <td><strong>OpenBSD-ports</strong></td>
341: <td>- The <b>ports</b> repository</td></tr>
342: <tr><td></td>
343: <td><strong>OpenBSD-www</strong></td>
344: <td>- The <b>www</b> repository</td></tr>
345: <tr><td></td>
1.19 brian 346: <td><strong>OpenBSD-x11</strong></td>
1.20 ! brian 347: <td>- The <b>XFree86-3</b> repository</td></tr>
1.19 brian 348: <tr><td></td>
1.18 beck 349: <td><strong>OpenBSD-all</strong></td>
350: <td>- All OpenBSD repositories</td></tr>
351: </table>
352: </dd>
353: </dl>
354:
355:
356: <dl>
1.7 brian 357: <dt><strong>cvs.bsdfr.org</strong></dt>
358: <dd><p>
1.6 deraadt 359: located in France;
1.9 naddy 360: maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.<br />
1.7 brian 361: Updated every 12 hours.
1.9 naddy 362: </p>
1.6 deraadt 363: <p>
1.7 brian 364: Available collections:
1.9 naddy 365: </p>
1.6 deraadt 366: <table>
1.9 naddy 367: <tr><td width="20"></td>
368: <td><strong>OpenBSD-src</strong></td>
369: <td>- The <b>src</b> repository</td></tr>
370: <tr><td></td>
371: <td><strong>OpenBSD-ports</strong></td>
372: <td>- The <b>ports</b> repository</td></tr>
373: <tr><td></td>
374: <td><strong>OpenBSD-www</strong></td>
375: <td>- The <b>www</b> repository</td></tr>
376: <tr><td></td>
377: <td><strong>OpenBSD-all</strong></td>
378: <td>- All OpenBSD repositories</td></tr>
1.6 deraadt 379: </table>
1.7 brian 380: </dd>
381: </dl>
1.5 ericj 382:
1.14 brian 383: <dl>
1.17 brian 384: <dt><strong>cvsup.usa.OpenBSD.org</strong></dt>
1.14 brian 385: <dd><p>
386: located in West Lafayette, IN, USA;
387: maintained by <a href="mailto:will@csociety.ecn.purdue.edu">Will Andrews</a>.<br />
388: Updated every 2 hours.
389: </p>
390: <p>
391: Available collections:
392: </p>
393: <table>
394: <tr><td width="20"></td>
395: <td><strong>OpenBSD-src</strong></td>
396: <td>- The <b>src</b> repository</td>
397: <tr><td></td>
398: <td><strong>OpenBSD-ports</strong></td>
399: <td>- The <b>ports</b> repository</td></tr>
400: <tr><td></td>
401: <td><strong>OpenBSD-www</strong></td>
402: <td>- The <b>www</b> repository</td></tr>
403: <tr><td></td>
404: <td><strong>OpenBSD-x11</strong></td>
1.20 ! brian 405: <td>- The <b>XFree86-3</b> repository</td></tr>
1.14 brian 406: <tr><td></td>
407: <td><strong>OpenBSD-all</strong></td>
408: <td>- All OpenBSD repositories</td></tr>
409: </table>
410: </dd>
411: </dl>
412:
1.1 brian 413: <p>
1.7 brian 414: <em>Note:</em>, If your server is listed on here with inaccurate or
415: unknown information, please contact <a
1.9 naddy 416: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
417: </p>
1.1 brian 418: <p>
1.7 brian 419: You may want to use "traceroute" to find out which server is nearest you.
1.1 brian 420: Problems with a server should be reported to the <b>maintainer</b> of the
421: server in question.
1.9 naddy 422: </p>
1.1 brian 423: <p>
1.20 ! brian 424: Currently (as of February 15, 2001), the CVS repository sizes are
1.9 naddy 425: </p>
1.4 brian 426: <table>
1.9 naddy 427: <tr><td width="20"></td>
1.20 ! brian 428: <td><strong>OpenBSD-ports</strong></td>
! 429: <td>- <b>45</b>MB</td></tr>
1.9 naddy 430: <tr><td></td>
1.20 ! brian 431: <td><strong>OpenBSD-src</strong></td>
! 432: <td>- <b>701</b>MB</td></tr>
1.9 naddy 433: <tr><td></td>
1.20 ! brian 434: <td><strong>OpenBSD-www</strong></td>
1.15 brian 435: <td>- <b>34</b>MB</td></tr>
1.9 naddy 436: <tr><td></td>
1.20 ! brian 437: <td><strong>OpenBSD-x11</strong></td>
1.15 brian 438: <td>- <b>193</b>MB</td></tr>
1.20 ! brian 439: <tr><td></td>
! 440: <td><strong>OpenBSD-xf4</strong></td>
! 441: <td>- Currently unknown
1.4 brian 442: </table>
443: <p>
1.15 brian 444: There is an additional overhead of <b>33</b>MB for the CVSROOT and sup
445: directories. The overall repository size currently increases at a rate
446: of about <b>170</b>MB per annum.
1.9 naddy 447: </p>
1.4 brian 448: <p>
1.1 brian 449: <strong>IMPORTANT NOTE:</strong>
450: There are a few issues relating to cryptographic software that everyone
451: should be aware of:
1.9 naddy 452: </p>
1.1 brian 453: <ul>
1.9 naddy 454: <li>
455: <p>
456: The OpenBSD sources are from Canada. As
457: <a href="http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html">
458: researched by a Canadian individual</a> and as
459: <a href="http://axion.physics.ubc.ca/ECL.html">
460: described in the Export Control list of Canada</a>,
461: it is legal to export crypto software from Canada to the world.
462: </p>
463: </li>
464: <li>
465: <p>
466: However, if you are outside the USA or Canada, you should not
467: fetch the cryptographic sections of the OpenBSD sources from an
468: AnonCVS server located in the USA. The files in question are...
469: </p>
470: <ul>
471: <li><tt>src/kerberosIV/*</tt></li>
472: <li><tt>src/lib/libdes/*</tt></li>
473: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
474: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
475: <li><tt>src/sys/netinet</tt></li>
476: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
477: <li><tt>X11/xc/lib/Xdmcp/Wraphelp.c</tt></li>
478: </ul>
479: <p>
480: Because of the USA ITAR munitions list,
481: crypto software may only be exported to Canada from the USA.
482: </p>
483: </li>
1.1 brian 484: </ul>
485:
486: <p>
487: The OpenBSD project is looking for more CVSup servers -- if you are
1.7 brian 488: interested, please contact <a href="mailto:brian@OpenBSD.org">Brian Somers</a>
1.1 brian 489: for configuration details.
490: </p>
491:
1.9 naddy 492: <hr />
493: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
1.7 brian 494: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.13 jufi 495: <br />
1.20 ! brian 496: <small>$OpenBSD: cvsup.html,v 1.19 2001/02/14 00:20:05 brian Exp $</small>
1.1 brian 497:
498: </body>
499: </html>