Annotation of www/cvsup.html, Revision 1.11
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>
271: <td><strong>openbsd-src-all</strong></td>
272: <td>- The <b>src</b> repository</td></tr>
273: <tr><td></td>
274: <td><strong>openbsd-ports-all</strong></td>
275: <td>- The <b>ports</b> repository</td></tr>
276: <tr><td></td>
277: <td><strong>openbsd-www-all</strong></td>
278: <td>- The <b>www</b> repository</td></tr>
279: <tr><td></td>
280: <td><strong>openbsd-cvs-all</strong></td>
281: <td>- All OpenBSD repositories except for x11</td></tr>
1.3 brian 282: </table>
1.7 brian 283: </dd>
284: </dl>
1.3 brian 285:
1.7 brian 286: <dl>
1.8 brian 287: <dt><strong>cvsup.hu.OpenBSD.org</strong></dt>
1.7 brian 288: <dd><p>
1.6 deraadt 289: located in Hungary;
1.9 naddy 290: maintained by <a href="mailto:mohacsi@hera.ik.bme.hu">Mohacsi Janos</a>.<br />
1.7 brian 291: Updated every 4 hours.
1.9 naddy 292: </p>
1.5 ericj 293: <p>
1.7 brian 294: Available collections:
1.9 naddy 295: </p>
1.5 ericj 296: <table>
1.9 naddy 297: <tr><td width="20"></td>
298: <td><strong>OpenBSD-src</strong></td>
299: <td>- The <b>src</b> repository</td></tr>
300: <tr><td></td>
301: <td><strong>OpenBSD-ports</strong></td>
302: <td>- The <b>ports</b> repository</td></tr>
303: <tr><td></td>
304: <td><strong>OpenBSD-www</strong></td>
305: <td>- The <b>www</b> repository</td></tr>
306: <tr><td></td>
307: <td><strong>OpenBSD-x11</strong></td>
308: <td>- The <b>x11</b> repository</td></tr>
309: <tr><td></td>
310: <td><strong>OpenBSD-all</strong></td>
311: <td>- All OpenBSD repositories</td></tr>
1.5 ericj 312: </table>
1.7 brian 313: </dd>
314: </dl>
1.1 brian 315:
1.7 brian 316: <dl>
317: <dt><strong>cvs.bsdfr.org</strong></dt>
318: <dd><p>
1.6 deraadt 319: located in France;
1.9 naddy 320: maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.<br />
1.7 brian 321: Updated every 12 hours.
1.9 naddy 322: </p>
1.6 deraadt 323: <p>
1.7 brian 324: Available collections:
1.9 naddy 325: </p>
1.6 deraadt 326: <table>
1.9 naddy 327: <tr><td width="20"></td>
328: <td><strong>OpenBSD-src</strong></td>
329: <td>- The <b>src</b> repository</td></tr>
330: <tr><td></td>
331: <td><strong>OpenBSD-ports</strong></td>
332: <td>- The <b>ports</b> repository</td></tr>
333: <tr><td></td>
334: <td><strong>OpenBSD-www</strong></td>
335: <td>- The <b>www</b> repository</td></tr>
336: <tr><td></td>
337: <td><strong>OpenBSD-all</strong></td>
338: <td>- All OpenBSD repositories</td></tr>
1.6 deraadt 339: </table>
1.7 brian 340: </dd>
341: </dl>
1.5 ericj 342:
1.1 brian 343: <p>
1.7 brian 344: <em>Note:</em>, If your server is listed on here with inaccurate or
345: unknown information, please contact <a
1.9 naddy 346: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
347: </p>
1.1 brian 348: <p>
1.7 brian 349: You may want to use "traceroute" to find out which server is nearest you.
1.1 brian 350: Problems with a server should be reported to the <b>maintainer</b> of the
351: server in question.
1.9 naddy 352: </p>
1.1 brian 353: <p>
1.9 naddy 354: Currently (as of June 1, 2000), the CVS repository sizes are
355: </p>
1.4 brian 356: <table>
1.9 naddy 357: <tr><td width="20"></td>
358: <td><strong>ports</strong></td>
359: <td>- <b>31</b>MB</td></tr>
360: <tr><td></td>
361: <td><strong>src</strong></td>
362: <td>- <b>648</b>MB</td></tr>
363: <tr><td></td>
364: <td><strong>www</strong></td>
365: <td>- <b>23</b>MB</td></tr>
366: <tr><td></td>
367: <td><strong>x11</strong></td>
368: <td>- <b>192</b>MB</td></tr>
1.4 brian 369: </table>
370: <p>
1.7 brian 371: There is an additional overhead of <b>25</b>MB for the CVSROOT and sup
1.4 brian 372: directories
1.9 naddy 373: </p>
1.4 brian 374: <p>
1.1 brian 375: <strong>IMPORTANT NOTE:</strong>
376: There are a few issues relating to cryptographic software that everyone
377: should be aware of:
1.9 naddy 378: </p>
1.1 brian 379: <ul>
1.9 naddy 380: <li>
381: <p>
382: The OpenBSD sources are from Canada. As
383: <a href="http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html">
384: researched by a Canadian individual</a> and as
385: <a href="http://axion.physics.ubc.ca/ECL.html">
386: described in the Export Control list of Canada</a>,
387: it is legal to export crypto software from Canada to the world.
388: </p>
389: </li>
390: <li>
391: <p>
392: However, if you are outside the USA or Canada, you should not
393: fetch the cryptographic sections of the OpenBSD sources from an
394: AnonCVS server located in the USA. The files in question are...
395: </p>
396: <ul>
397: <li><tt>src/kerberosIV/*</tt></li>
398: <li><tt>src/lib/libdes/*</tt></li>
399: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
400: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
401: <li><tt>src/sys/netinet</tt></li>
402: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
403: <li><tt>X11/xc/lib/Xdmcp/Wraphelp.c</tt></li>
404: </ul>
405: <p>
406: Because of the USA ITAR munitions list,
407: crypto software may only be exported to Canada from the USA.
408: </p>
409: </li>
1.1 brian 410: </ul>
411:
412: <p>
413: The OpenBSD project is looking for more CVSup servers -- if you are
1.7 brian 414: interested, please contact <a href="mailto:brian@OpenBSD.org">Brian Somers</a>
1.1 brian 415: for configuration details.
416: </p>
417:
1.9 naddy 418: <hr />
419: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD" /></a>
1.7 brian 420: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.11 ! wvdputte 421: <br><small>$OpenBSD: cvsup.html,v 1.10 2000/06/16 16:14:05 wvdputte Exp $</small>
1.1 brian 422:
423: </body>
424: </html>