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