Annotation of www/anoncvs.html, Revision 1.1
1.1 ! deraadt 1: <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
! 2: <html>
! 3: <head>
! 4: <title>OpenBSD</title>
! 5: <link rev=made href=mailto:www@openbsd.org>
! 6: <meta name="resource-type" content="document">
! 7: <meta name="description" content="the main OpenBSD page">
! 8: <meta name="keywords" content="openbsd,main">
! 9: <meta name="distribution" content="global">
! 10: <meta name="copyright" content="This document copyright 1996 by OpenBSD, Inc.">
! 11: </head>
! 12:
! 13: <body>
! 14:
! 15: <h1>OpenBSD</h1>
! 16: <h3>CVS Access:</h3>
! 17: CVS is used to manage the OpenBSD source tree. This allows
! 18: developers to work on a local source tree and commit their changes when
! 19: ready. Also <strong>anyone</strong> can edit source files on their
! 20: local machines, and automatically track and merge in any changes made
! 21: in the OpenBSD CVS repository. Additionally they can easily see the
! 22: logs of, check out, or "diff" the source files in the OpenBSD source
! 23: tree.
! 24: </p>
! 25:
! 26: <p>
! 27: Most importantly, the <strong>anoncvs</strong> service does NOT
! 28: delete the changes you make in your local copy of the source tree --
! 29: read on for more details!
! 30: </p>
! 31:
! 32: <p>
! 33: The latest version of CVS is available at
! 34: <a href=ftp://ftp.cyclic.com/pub/cvs/>Cyclic</a>.
! 35: Versions earlier than 1.6 are not recommended, and may not work.
! 36: If you already have OpenBSD installed, CVS is included.
! 37: </p>
! 38:
! 39: <p>
! 40: There are two levels of source tree access:
! 41: </p>
! 42:
! 43: <dl>
! 44: <dt><strong>Read-write access for developers:</strong>
! 45: <dd>Developers who need to commit changes to the source tree must have
! 46: an account on the OpenBSD machines. Getting this access will be a
! 47: natural result of working on the sources with other OpenBSD developers.
! 48: If someone does some good work and shows they can work with the team,
! 49: they will get an account.
! 50: </dl>
! 51:
! 52: <dl>
! 53: <dt><strong>Read-only access for everyone:</strong>
! 54: <dd>Anyone can access the read-only CVS repositories. These copies
! 55: of the read-write CVS repository are mirrored often. To use one,
! 56: set your <strong>CVSROOT</strong> environment variable to one of
! 57: the following values:
! 58: <ul>
! 59: <p>
! 60: <li><strong>CVSROOT=anoncvs@anoncvs.usa.openbsd.org:/cvs</strong><br>
! 61: Host also known as <strong>anoncvs.openbsd.org</strong> and
! 62: <strong>eap.ccrc.wustl.edu</strong>.<br>
! 63: located at Washington University, St. Louis, mid-west USA.<br>
! 64: maintained by <a href=mailto:chuck@maria.wustl.edu>Chuck Cranor</a>.<br>
! 65: protocols: rsh, ssh, ssh port 2022.<br>
! 66: updated every 4 hours.<br>
! 67: <p>
! 68: <li><strong>CVSROOT=anoncvs@anoncvs2.usa.openbsd.org:/cvs</strong><br>
! 69: Host also known as <strong>hal.heuris.com</strong>.<br>
! 70: located in MO, mid-west USA.<br>
! 71: maintained by <a href=mailto:johns@heuris.com>John Stone</a>.<br>
! 72: protocols: rsh, ssh, ssh port 2022.<br>
! 73: updated every 12 hours.<br>
! 74: <p>
! 75: <li><strong>CVSROOT=anoncvs@anoncvs3.usa.openbsd.org:/cvs</strong><br>
! 76: Host also known as <strong>freestuff.cs.colorado.edu</strong>.<br>
! 77: located at the University of Colorado, Boulder, western USA.<br>
! 78: maintained by <a href=mailto:Todd.Miller@cs.colorado.edu>Todd Miller</a>.<br>
! 79: protocols: ssh, ssh port 2022.<br>
! 80: updated every 6 hours.<br>
! 81: <p>
! 82: <li><strong>CVSROOT=anoncvs@anoncvs.uk.openbsd.org:/cvs</strong><br>
! 83: Host also known as <strong>dumpty.wonderland.org</strong>.<br>
! 84: located in London, UK.<br>
! 85: maintained by <a href=mailto:peter@wonderland.org>Peter Galbavy</a>.<br>
! 86: protocols: rsh.<br>
! 87: updated every 12 hours.<br>
! 88: <p>
! 89: <li><strong>CVSROOT=anoncvs@anoncvs.tw.openbsd.org:/cvs</strong><br>
! 90: Host also known as <strong>hercules.secc.fju.edu.tw</strong>.<br>
! 91: located in Taipei, Taiwan.<br>
! 92: maintained by <a href=mailto:shawn@openbsd.org>Shawn Hsiao</a>.<br>
! 93: protocols: rsh, ssh, ssh port 2022.<br>
! 94: updated every 12 hours.<br>
! 95: <p>
! 96: <li><strong>CVSROOT=anoncvs@anoncvs.no.openbsd.org:/cvs</strong><br>
! 97: located in Norway.<br>
! 98: maintained by <a href=mailto:micheals@openbsd.org>Michael Shuldman</a>.<br>
! 99: protocols: rsh, ssh, ssh port 2022.<br>
! 100: updated every 4 hours.<br>
! 101: </ul>
! 102: <p>
! 103: You may want to use `traceroute' to find out which server is nearest you.
! 104: </dl>
! 105: </p>
! 106:
! 107: <p>
! 108: <strong>IMPORTANT NOTE:</strong>
! 109: There are a few issues relating to cryptographic software that everyone
! 110: should be aware of:
! 111: <ul>
! 112: <li>The OpenBSD sources are from Canada.
! 113: <a href=http://insight.mcmaster.ca/org/efc/pages/doc/crypto-export.html>It
! 114: is legal to export crypto software from Canada to the world.</a>
! 115: <p>
! 116: <li>However, if you are outside the USA or Canada, you should not
! 117: fetch the cryptographic sections of the OpenBSD sources from an
! 118: anoncvs server located in the USA. The files in question are...
! 119: <ul>
! 120: <li>src/kerberosIV/*
! 121: <li>src/lib/libc/crypt/crypt.c
! 122: <li>src/lib/libc/crypt/morecrypt.c
! 123: </ul>
! 124: Because of the USA ITAR munitions list,
! 125: crypto software may only be exported to Canada from the USA.
! 126: <p>
! 127: <li>The OpenBSD project is looking for more anoncvs servers -- read
! 128: on to find out how you can help.
! 129: </ul>
! 130: </p>
! 131:
! 132: <p>
! 133: A sample use of an anoncvs CVS server would be:
! 134: <pre>
! 135: % setenv CVSROOT anoncvs@anoncvs.usa.openbsd.org:/cvs
! 136: % cd /tmp
! 137: % cvs get src/sys/arch/sparc
! 138: [copies the files from the repository to your machine]
! 139: % cvs log src/sys/arch/sparc/sparc/locore.s
! 140: [shows the commit log for the chosen file ]
! 141: % cvs diff -bc -r1.1 -r1.5 src/sys/arch/sparc/sparc/locore.s
! 142: [shows the changes between revisions 1.1 and rev 1.5]
! 143: </pre>
! 144: </p>
! 145:
! 146: <p>
! 147: Here is how someone using anoncvs regularily would update his
! 148: source tree:
! 149: <pre>
! 150: # setenv CVSROOT anoncvs@anoncvs.usa.openbsd.org:/cvs
! 151: # cd /usr
! 152: # cvs -q get -PA src
! 153: </pre>
! 154: or similarily later on he might try
! 155: <pre>
! 156: # cd /usr/src
! 157: # cvs -q up -PAd
! 158: </pre>
! 159: Everytime you ran this it would syncronize your /usr/src tree. It would
! 160: not destroy any of your local changes, rather it would attempt to merge
! 161: changes in. If you use obj directories (not obj symbolic links) you may
! 162: wish to append "-I obj" to the cvs command line, this will keep cvs from
! 163: spitting out a warning about all the obj directories it is going to
! 164: encounter which are not in the repository.
! 165: </p>
! 166:
! 167: <p>
! 168: The CVS man page (included with the CVS sources) has much more
! 169: information about how CVS can be used.
! 170: </p>
! 171:
! 172: <p>
! 173: The anoncvs service gives fledgling developers a chance to learn CVS
! 174: operation and get thoroughly involved in the development process
! 175: before getting "commit" access -- as a result of showing useful
! 176: skills and high quality results they will naturally later be given
! 177: developer access. As well, people providing patches can create
! 178: their "diff"s relative to the CVS tree, which will ease integration.
! 179: </p>
! 180:
! 181: <p>
! 182: The CVS client uses rsh to talk to the CVS server. If some local
! 183: security measure like a firewall (or imperfect protocol emulators
! 184: like slirp) prevents you from using rsh, you may be able to use
! 185: <a href=http://www.cs.hut.fi/ssh>ssh</a> instead. In this case,
! 186: one sets the environment variable <strong>CVS_RSH</strong> to point
! 187: to ssh (typically <strong>/usr/local/bin/ssh</strong>). To reduce the
! 188: performance hit the anoncvs server would take it is recommended (and
! 189: requested) that you disable encryption. If your local site prevents
! 190: you from connecting out to port 22 (which ssh defaults to using) use
! 191: port 2022.
! 192: </p>
! 193:
! 194: <p>
! 195: Do not be tempted to turn on compression since CVS already compresses.
! 196: Use something like the following in your <strong>$HOME/.ssh/config</strong>
! 197: file.
! 198: </p>
! 199: <pre>
! 200: Host anoncvs.usa.openbsd.org
! 201: Cipher none
! 202: Port 2022
! 203: </pre>
! 204:
! 205: <p>
! 206: CVS is a little noisy starting up; to quiet it a bit you may want to
! 207: do this:
! 208: <pre>
! 209: setenv CVS_CLIENT_PORT -1
! 210: </pre>
! 211: </p>
! 212:
! 213: <p>
! 214: If you wish to be a new anoncvs mirror site, please contact the anoncvs
! 215: <a href=mailto:deraadt@theos.com>maintainer</a>.
! 216: Anoncvs mirrors require about 300MB of disk, and use up to 4MB of swap
! 217: per anoncvs user (assuming the user does a large operation; while smaller
! 218: operations use fewer resources, anoncvs still makes much more of an
! 219: impact than ftp or sup). Such anoncvs machines should have excellent
! 220: network connectivity for the area they are expected to serve. A
! 221: <a href=anoncvs.shar>document</a>
! 222: which describes the setup of anoncvs servers is available.
! 223: </p>
! 224:
! 225: </dl>
! 226:
! 227: <hr>
! 228: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
! 229: <br><small>$OpenBSD: index.html,v 1.90 1996/09/01 01:21:10 deraadt Exp $</small>
! 230:
! 231: </body>
! 232: </html>