Annotation of www/cvsup.html, Revision 1.18
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>
1.18 ! beck 320: <dt><strong>cvsup.leo.org</strong></dt>
! 321: <dd><p>
! 322: located in Munich, Germany;
! 323: maintained by <a href="mailto:dl@leo.org">Daniel Lang</a>.<br />
! 324: Updated every 12 hours.
! 325: </p>
! 326: <p>
! 327: Available collections:
! 328: </p>
! 329: <table>
! 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>
! 342: </table>
! 343: </dd>
! 344: </dl>
! 345:
! 346:
! 347: <dl>
1.7 brian 348: <dt><strong>cvs.bsdfr.org</strong></dt>
349: <dd><p>
1.6 deraadt 350: located in France;
1.9 naddy 351: maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.<br />
1.7 brian 352: Updated every 12 hours.
1.9 naddy 353: </p>
1.6 deraadt 354: <p>
1.7 brian 355: Available collections:
1.9 naddy 356: </p>
1.6 deraadt 357: <table>
1.9 naddy 358: <tr><td width="20"></td>
359: <td><strong>OpenBSD-src</strong></td>
360: <td>- The <b>src</b> repository</td></tr>
361: <tr><td></td>
362: <td><strong>OpenBSD-ports</strong></td>
363: <td>- The <b>ports</b> repository</td></tr>
364: <tr><td></td>
365: <td><strong>OpenBSD-www</strong></td>
366: <td>- The <b>www</b> repository</td></tr>
367: <tr><td></td>
368: <td><strong>OpenBSD-all</strong></td>
369: <td>- All OpenBSD repositories</td></tr>
1.6 deraadt 370: </table>
1.7 brian 371: </dd>
372: </dl>
1.5 ericj 373:
1.14 brian 374: <dl>
1.17 brian 375: <dt><strong>cvsup.usa.OpenBSD.org</strong></dt>
1.14 brian 376: <dd><p>
377: located in West Lafayette, IN, USA;
378: maintained by <a href="mailto:will@csociety.ecn.purdue.edu">Will Andrews</a>.<br />
379: Updated every 2 hours.
380: </p>
381: <p>
382: Available collections:
383: </p>
384: <table>
385: <tr><td width="20"></td>
386: <td><strong>OpenBSD-src</strong></td>
387: <td>- The <b>src</b> repository</td>
388: <tr><td></td>
389: <td><strong>OpenBSD-ports</strong></td>
390: <td>- The <b>ports</b> repository</td></tr>
391: <tr><td></td>
392: <td><strong>OpenBSD-www</strong></td>
393: <td>- The <b>www</b> repository</td></tr>
394: <tr><td></td>
395: <td><strong>OpenBSD-x11</strong></td>
396: <td>- The <b>x11</b> repository</td></tr>
397: <tr><td></td>
398: <td><strong>OpenBSD-all</strong></td>
399: <td>- All OpenBSD repositories</td></tr>
400: </table>
401: </dd>
402: </dl>
403:
1.1 brian 404: <p>
1.7 brian 405: <em>Note:</em>, If your server is listed on here with inaccurate or
406: unknown information, please contact <a
1.9 naddy 407: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
408: </p>
1.1 brian 409: <p>
1.7 brian 410: You may want to use "traceroute" to find out which server is nearest you.
1.1 brian 411: Problems with a server should be reported to the <b>maintainer</b> of the
412: server in question.
1.9 naddy 413: </p>
1.1 brian 414: <p>
1.15 brian 415: Currently (as of December 6, 2000), the CVS repository sizes are
1.9 naddy 416: </p>
1.4 brian 417: <table>
1.9 naddy 418: <tr><td width="20"></td>
419: <td><strong>ports</strong></td>
1.15 brian 420: <td>- <b>41</b>MB</td></tr>
1.9 naddy 421: <tr><td></td>
422: <td><strong>src</strong></td>
1.15 brian 423: <td>- <b>689</b>MB</td></tr>
1.9 naddy 424: <tr><td></td>
425: <td><strong>www</strong></td>
1.15 brian 426: <td>- <b>34</b>MB</td></tr>
1.9 naddy 427: <tr><td></td>
428: <td><strong>x11</strong></td>
1.15 brian 429: <td>- <b>193</b>MB</td></tr>
1.4 brian 430: </table>
431: <p>
1.15 brian 432: There is an additional overhead of <b>33</b>MB for the CVSROOT and sup
433: directories. The overall repository size currently increases at a rate
434: of about <b>170</b>MB per annum.
1.9 naddy 435: </p>
1.4 brian 436: <p>
1.1 brian 437: <strong>IMPORTANT NOTE:</strong>
438: There are a few issues relating to cryptographic software that everyone
439: should be aware of:
1.9 naddy 440: </p>
1.1 brian 441: <ul>
1.9 naddy 442: <li>
443: <p>
444: The OpenBSD sources are from Canada. As
445: <a href="http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html">
446: researched by a Canadian individual</a> and as
447: <a href="http://axion.physics.ubc.ca/ECL.html">
448: described in the Export Control list of Canada</a>,
449: it is legal to export crypto software from Canada to the world.
450: </p>
451: </li>
452: <li>
453: <p>
454: However, if you are outside the USA or Canada, you should not
455: fetch the cryptographic sections of the OpenBSD sources from an
456: AnonCVS server located in the USA. The files in question are...
457: </p>
458: <ul>
459: <li><tt>src/kerberosIV/*</tt></li>
460: <li><tt>src/lib/libdes/*</tt></li>
461: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
462: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
463: <li><tt>src/sys/netinet</tt></li>
464: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
465: <li><tt>X11/xc/lib/Xdmcp/Wraphelp.c</tt></li>
466: </ul>
467: <p>
468: Because of the USA ITAR munitions list,
469: crypto software may only be exported to Canada from the USA.
470: </p>
471: </li>
1.1 brian 472: </ul>
473:
474: <p>
475: The OpenBSD project is looking for more CVSup servers -- if you are
1.7 brian 476: interested, please contact <a href="mailto:brian@OpenBSD.org">Brian Somers</a>
1.1 brian 477: for configuration details.
478: </p>
479:
1.9 naddy 480: <hr />
481: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
1.7 brian 482: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.13 jufi 483: <br />
1.18 ! beck 484: <small>$OpenBSD: cvsup.html,v 1.17 2001/01/16 23:37:54 brian Exp $</small>
1.1 brian 485:
486: </body>
487: </html>
![[BACK]](/icons/back.gif){kind=icon}
Return to cvsup.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / www