[BACK]Return to anoncvs.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/anoncvs.html, Revision 1.10

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