Annotation of www/cvsup.html, Revision 1.1
1.1 ! brian 1: <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
! 2: <html>
! 3: <head>
! 4: <title>OpenBSD CVSup</title>
! 5: <link rev=made href=mailto:www@openbsd.org>
! 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:
! 13: <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#23238E">
! 14:
! 15: <img alt="[OpenBSD]" height=30 width=141 SRC="images/smalltitle.gif">
! 16: <p>
! 17: <h2><font color=#e00000>CVSup</font><hr></h2>
! 18:
! 19: <p>
! 20: <ul><h3>Table Of Contents</h3>
! 21: <li><a href="#cvsup">What is CVSup?</a>
! 22: <li><a href="#starting">Getting Started Using CVSup.</a>
! 23: <li><a href="#using">Using CVS to Update your Source Tree.</a>
! 24: <li><a href="#CVSROOT">Available CVSup Servers.</a>
! 25: </ul>
! 26: </p>
! 27: <hr>
! 28:
! 29:
! 30: <a name="cvsup"></a>
! 31: <h3><font color=#0000e0>What is CVSup?</font></h3>
! 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:
! 75: <a name="CVS"></a>
! 76: <h3><font color=#0000e0>What is CVS?</font></h3>
! 77:
! 78: <p>
! 79: CVS is the source code control system used to manage the OpenBSD source
! 80: tree.</a> It is described in more detail <a href=anoncvs.html#CVS>here</a>.
! 81:
! 82: <a name="starting"></a>
! 83: <h3><font color=#0000e0>Getting Started Using CVSup.</font></h3>
! 84:
! 85: <p>
! 86: The latest version of CVSup is available at
! 87: <a href=http://www.polstra.com/projects/freeware/CVSup/>
! 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:
! 131: <a name="using"></a>
! 132: <h3><font color=#0000e0>Using CVS(1) to update your source tree.</font></h3>
! 133:
! 134: <p>
! 135: It is now simple to checkout any one of the CVSup'd repositories:
! 136:
! 137: <ul>
! 138: <li> For Korn/Bourne shells.
! 139: <ul><pre>
! 140: # <b>cd /usr</b>
! 141: # <b>CVSROOT=/cvs cvs checkout src</b>
! 142: </pre></ul>
! 143: <li> For CSH based shells.
! 144: <ul><pre>
! 145: # <b>cd /usr</b>
! 146: # <b>setenv CVSROOT /cvs</b>
! 147: # <b>cvs checkout src</b>
! 148: </pre></ul>
! 149: </ul>
! 150:
! 151: <p>
! 152: The above will checkout the most current sources. Many of you will only
! 153: want the release sources, especially if you are patching your system. To
! 154: checkout release sources you must specify a tag along with your command.
! 155: For example:
! 156: </p>
! 157:
! 158: <p>
! 159: <ul><pre>
! 160: # <b>cd /usr</b>
! 161: # <b>cvs checkout -rOPENBSD_2_6 src</b>
! 162: </pre></ul>
! 163: Or OPENBSD_2_5 for 2.5, etc.
! 164: </p>
! 165:
! 166: <a name="CVSROOT"></a>
! 167: <h3><font color=#0000e0>Available CVSup Servers.</font></h3>
! 168:
! 169: <dl>
! 170: <dt><strong>The following CVSup servers are available:</strong>
! 171: <dd>
! 172:
! 173: <p>
! 174: <li><strong>cvsup.uk.OpenBSD.org</strong><br>
! 175: located in Brighton, UK.<br>
! 176: maintained by <a href=mailto:brian@OpenBSD.org>Brian Somers</a>.<br>
! 177: updated every 2 hours.<br>
! 178: <p>
! 179: <b>Available collections</b>:
! 180: <table>
! 181: <tr><td width=20><td><strong>OpenBSD-src</strong><td>- The <b>src</b> repository
! 182: <tr><td><td><strong>OpenBSD-ports</strong><td>- The <b>ports</b> repository
! 183: <tr><td><td><strong>OpenBSD-www</strong><td>- The <b>www</b> repository
! 184: <tr><td><td><strong>OpenBSD-x11</strong><td>- The <b>x11</b> repository
! 185: <tr><td><td><strong>OpenBSD-all</strong><td>- All OpenBSD repositories
! 186: </table>
! 187: </p>
! 188:
! 189: </ul>
! 190:
! 191:
! 192: <p>
! 193: <EM>Note:</EM>, If your server is listed on here with inaccurate or
! 194: unknown information, please contact <A
! 195: HREF="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></A>
! 196: <p>
! 197: You may want to use `traceroute' to find out which server is nearest you.
! 198: Problems with a server should be reported to the <b>maintainer</b> of the
! 199: server in question.
! 200: </dl>
! 201: <p>
! 202: <strong>IMPORTANT NOTE:</strong>
! 203: There are a few issues relating to cryptographic software that everyone
! 204: should be aware of:
! 205: <ul>
! 206: <li>The OpenBSD sources are from Canada.
! 207: As
! 208: <a href=http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html>
! 209: researched by a Canadian individual</a>
! 210: and as
! 211: <a href=http://axion.physics.ubc.ca/ECL.html>
! 212: described in the Export Control list of Canada</a>
! 213: is legal to export crypto software from Canada to the world.
! 214: <p>
! 215: <li>However, if you are outside the USA or Canada, you should not
! 216: fetch the cryptographic sections of the OpenBSD sources from an
! 217: anoncvs server located in the USA. The files in question are...
! 218: <ul>
! 219: <li>src/kerberosIV/*
! 220: <li>src/lib/libdes/*
! 221: <li>src/lib/libc/crypt/crypt.c
! 222: <li>src/lib/libc/crypt/morecrypt.c
! 223: <li>src/sys/netinet
! 224: <li>src/usr.sbin/afs/src/rxkad/*
! 225: <li>X11/xc/lib/Xdmcp/Wraphelp.c
! 226: </ul>
! 227: Because of the USA ITAR munitions list,
! 228: crypto software may only be exported to Canada from the USA.
! 229: </ul>
! 230:
! 231: <p>
! 232: The OpenBSD project is looking for more CVSup servers -- if you are
! 233: interested, please contact <a href=mailto:brian@OpenBSD.org>Brian Somers</a>
! 234: for configuration details.
! 235: </p>
! 236:
! 237: <hr>
! 238: <a href=index.html><img height=24 width=24 src=back.gif border=0 alt=OpenBSD></a>
! 239: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
! 240: <br><small>$OpenBSD$</small>
! 241:
! 242: </body>
! 243: </html>