Annotation of www/cvsup.html, Revision 1.9
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
! 97: (<tt>misc/cvsup-bin</tt>) which provides John's pre-compiled executables
! 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.9 ! naddy 421: <br /><small>$OpenBSD: cvsup.html,v 1.8 2000/06/09 18:21:35 brian Exp $</small>
1.1 brian 422:
423: </body>
424: </html>