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

Annotation of www/cvsync.html, Revision 1.139

1.58      sthen       1: <!-- DO NOT EDIT MANUALLY! See comments in www/build/mirrors.dat for details -->
1.37      steven      2:
1.6       naddy       3: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1.1       espie       4: <html>
                      5: <head>
1.125     tj          6: <title>OpenBSD: CVSync</title>
1.6       naddy       7: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
1.133     tj          8: <meta name="copyright" content="This document copyright 2003-2017 by OpenBSD.">
1.121     tb          9: <meta name="viewport" content="width=device-width, initial-scale=1">
                     10: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.128     tb         11: <link rel="canonical" href="https://www.openbsd.org/cvsync.html">
1.131     tb         12: <style type="text/css">
                     13:   h3 { color: #0000e0; }
                     14: </style>
1.1       espie      15: </head>
                     16:
                     17: <body bgcolor="#FFFFFF" text="#000000" link="#23238E">
                     18:
1.121     tb         19: <h2>
1.122     tb         20: <a href="index.html">
1.121     tb         21: <font color="#0000ff"><i>Open</i></font><font color="#000084">BSD</font></a>
1.138     sthen      22: <font color="#e00000">Source repository access: CVSync and rsync</font>
1.121     tb         23: </h2>
1.1       espie      24: <hr>
1.121     tb         25: <p>
1.1       espie      26:
1.138     sthen      27: OpenBSD uses the CVS version control system.
                     28: It is described in more detail <a href="anoncvs.html#CVS">here</a>.
                     29: The <a href="https://man.openbsd.org/cvs">cvs(1)</a> command is used
                     30: to checkout a working tree and perform standard operations (log, diff, etc).
                     31: It can either contact an CVS server (in most cases this will be an OpenBSD
                     32: <a href="anoncvs.html">anoncvs</a> server), or operate against a local
                     33: copy of the repository.
1.1       espie      34:
                     35: <p>
1.138     sthen      36: If you would like to operate a local anoncvs server, use cvs(1) commands
                     37: offline, or simply have faster access, you may use CVSync or rsync to
                     38: fetch a local copy of the repository.
1.1       espie      39:
1.138     sthen      40: <h3 id="CVSync">What Is CVSync?</h3>
1.1       espie      41:
1.138     sthen      42: <b>CVSync</b> is a software package specifically used for distributing
                     43: and updating <a href="https://man.openbsd.org/cvs">cvs(1)</a> repositories.
                     44: As it has knowledge of the file format it can operate more efficiently
                     45: than a general-purpose file synchronization program, however it is not
                     46: bug-free and can have problems updating at times.
1.1       espie      47:
1.138     sthen      48: <p>
                     49: The client <tt>cvsync</tt> runs on each user's machine (typically from
                     50: a <a href="https://man.openbsd.org/cron">cron(8)</a> job), and fetches
                     51: from a server running <tt>cvsyncd</tt>.
1.1       espie      52:
1.131     tb         53: <h3 id="starting">Getting Started Using CVSync</h3>
1.1       espie      54:
1.138     sthen      55: <p>
                     56: CVS is part of OpenBSD's base system.
                     57: CVSync is an entirely different program and can be installed from
                     58: packages:
                     59:
                     60: <pre>
                     61:         <b>pkg_add cvsync</b>
                     62: </pre>
1.1       espie      63:
1.138     sthen      64: Do not build your own copy from unmodified upstream source -
1.116     sthen      65: the port/package has been modified to support commitid which is now
                     66: used in the OpenBSD repository.
1.1       espie      67:
                     68: <p>
                     69: In order to mirror the OpenBSD repository with CVSync,
                     70: the following configuration file might be used:
                     71:
                     72: <pre>
                     73:        config {
1.103     mpi        74:            hostname anoncvs.eu.openbsd.org
1.5       naddy      75:            # If your network link is a T1 or faster, comment out the following line.
1.1       espie      76:            compress
1.4       espie      77:            collection {
1.5       naddy      78:                name openbsd release rcs
1.4       espie      79:                prefix /cvs
1.5       naddy      80:                umask 002
1.4       espie      81:            }
1.1       espie      82:        }
                     83: </pre>
                     84:
                     85: <p>
1.138     sthen      86: This directs cvsync to fetch or refresh all OpenBSD distributions from
1.124     tb         87: <b>anoncvs.eu.openbsd.org</b> with a
1.137     tb         88: <a href="https://man.openbsd.org/umask">umask(2)</a> that permits group write
1.1       espie      89: permission to the local repository.
1.138     sthen      90: The local copy of the files are stored in <tt>/cvs</tt>.
1.1       espie      91:
                     92: <p>
                     93: Assuming this file is saved as <tt>cvs-syncfile</tt>, the
                     94: following command would be used to invoke cvsync
1.124     tb         95:
1.1       espie      96: <pre>
1.91      nick       97:         <b>cvsync -c cvs-syncfile</b>
1.1       espie      98: </pre>
                     99:
1.138     sthen     100: <h3 id="rsync">Getting Started Using Rsync</h3>
                    101:
                    102: Some repository mirrors offer access via rsync, a general-purpose
                    103: file synchronization program.
                    104: Again this should be installed from packages.
                    105: Two flavours are available:
                    106:
                    107: <pre>
                    108:        <b># pkg_add rsync</b>
                    109:        Ambiguous: choose package for rsync
                    110:        a       0: <None>
                    111:                1: rsync-3.1.2p0
                    112:                2: rsync-3.1.2p0-iconv
                    113:        Your choice:
                    114: </pre>
                    115:
                    116: Unless you have other requirements, simply install the standard version
                    117: (option 1 on the list above).
                    118: You can select the flavour on the command-line to avoid
                    119: <a href="//man.openbsd.org/pkg_add">pkg_add(1)</a> prompting for the
                    120: version like so:
                    121: <pre>
                    122:        <b>pkg_add rsync--</b>
                    123: </pre>
                    124:
                    125: In order to mirror the OpenBSD repository with rsync,
                    126: the following command line might be used:
                    127:
                    128: <pre>
                    129:        <b>rsync -avz --delete rsync://obsdacvs.cs.toronto.edu/obsdcvs/ /cvs/</b>
                    130: </pre>
                    131:
1.131     tb        132: <h3 id="using">Using CVS to Work With Your Repository</h3>
1.1       espie     133:
1.48      nick      134: Now that you have a local copy of the CVS repository, it is now simple
                    135: to check out, update, or do any of the other CVS operations you would
                    136: normally do against a remote repository, locally.
1.50      nick      137: For example:
1.1       espie     138: <pre>
1.91      nick      139:         <b>cvs -d/cvs checkout -P src</b>
                    140:         <b>cvs -d/cvs up -Pd</b>
                    141:         <b>cvs -d/cvs diff -u file.c</b>
1.1       espie     142: </pre>
1.48      nick      143: More details on CVS operation can be found in
                    144: <a href="faq/faq5.html#BldGetSrc">FAQ5, Fetching appropriate source
                    145: code</a> and in the
1.137     tb        146: <a href="https://man.openbsd.org/cvs">cvs(1)</a>
1.48      nick      147: man page.
1.1       espie     148:
1.138     sthen     149: <h3 id="CVSROOT">Available Repository Servers</h3>
1.1       espie     150:
1.138     sthen     151: The following CVSync and rsync repository servers are available:
1.1       espie     152:
1.6       naddy     153: <ul>
1.107     brad      154: <li><strong>anoncvs.comstyle.com</strong><br>
                    155: Location: Toronto, Canada.<br>
                    156: Maintained by <a href="mailto:brad@comstyle.com">Brad Smith</a>.<br>
                    157: Updated hourly.<br>
                    158: <p>
1.136     krw       159: <li><strong>obsdacvs.cs.toronto.edu</strong><br>
1.138     sthen     160: <strong>rsync://obsdacvs.cs.toronto.edu/obsdcvs/</strong><br>
1.110     nick      161: Location: University of Toronto, Toronto, ON, Canada.<br>
                    162: Maintained by <a href="mailto:nick@holland-consulting.net">Nick Holland</a>.<br>
                    163: Updated every 2 hours.<br>
                    164: <p>
1.88      sthen     165: <li><strong>anoncvs.fr.openbsd.org</strong><br>
1.138     sthen     166: <strong>rsync://anoncvs.fr.openbsd.org/openbsd-cvs/</strong><br>
1.88      sthen     167: Location: Paris, France.<br>
1.117     sthen     168: Maintained by <a href="mailto:openbsd-mirror@bsdfrog.org">Landry Breuil, Antoine Jacoutot</a>.<br>
1.88      sthen     169: Updated every 2 hours from anoncvs1.ca.openbsd.org.<br>
                    170: <p>
1.138     sthen     171: <li><a href="https://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
                    172: <strong>rsync://mirror.osn.de/openbsd-all/</strong><br>
1.37      steven    173: Location: N&uuml;rnberg, Germany.<br>
                    174: Maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.<br>
1.62      sthen     175: Updated every 3 hours.<br>
1.1       espie     176: <p>
1.112     florian   177: <li><strong>ftp.hostserver.de</strong><br>
1.138     sthen     178: <strong>rsync://ftp.hostserver.de/cvsync/</strong><br>
1.112     florian   179: Location: Frankfurt, Germany.<br>
1.130     tb        180: Maintained by <a href="mailto:mirror@hostserver.de">Sebastian Benoit, Peter Hessler</a>.<br>
1.112     florian   181: Updated hourly from anoncvs1.ca.openbsd.org.<br>
                    182: <p>
1.90      sthen     183: <li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
1.37      steven    184: Location: Tokyo, Japan.<br>
                    185: Maintained by <a href="mailto:hrs@allbsd.org">Hiroki Sato</a>.<br>
1.69      sthen     186: <p>
1.77      sthen     187: <li><strong>anoncvs.eu.openbsd.org</strong><br>
1.138     sthen     188: <strong>rsync://anoncvs.eu.openbsd.org/OpenBSD-cvs/</strong><br>
1.77      sthen     189: Location: Stockholm University, Stockholm, Sweden.<br>
1.138     sthen     190: Maintained by <a href="mailto:jj@deadzoft.org">Janne Johansson</a>.<br>
1.77      sthen     191: Updated every 2 hours.<br>
                    192: <p>
                    193: <li><strong>anoncvs.spacehopper.org</strong><br>
1.138     sthen     194: <strong>rsync://anoncvs.spacehopper.org/OpenBSD-CVS/</strong><br>
1.77      sthen     195: Location: London, United Kingdom.<br>
                    196: Maintained by <a href="mailto:sthen@openbsd.org">Stuart Henderson</a>.<br>
                    197: Updated hourly from anoncvs.ca.openbsd.org.<br>
                    198: <p>
1.118     sthen     199: <li><strong>anoncvs3.usa.openbsd.org</strong><br>
                    200: Location: National Center for Atmospheric Research, Boulder, CO, USA.<br>
                    201: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
                    202: Updated hourly.<br>
                    203: <p>
1.127     millert   204: <li><strong>anoncvs4.usa.openbsd.org</strong><br>
                    205: Location: New York Internet, New York, NY, USA.<br>
                    206: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
                    207: Updated hourly.<br>
                    208: <p>
1.118     sthen     209: <li><strong>anoncvs2.usa.openbsd.org</strong><br>
1.138     sthen     210: Host also known as <strong>openbsd.se.rit.edu</strong>.<br>
1.118     sthen     211: Location: Rochester Institute of Technology, Rochester, NY, USA.<br>
                    212: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
                    213: Updated hourly.<br>
                    214: <p>
1.77      sthen     215: <li><strong>anoncvs1.usa.openbsd.org</strong><br>
1.138     sthen     216: Host also known as <strong>anoncvs.usa.openbsd.org</strong>.<br>
1.118     sthen     217: Location: Network Media, LLC, Bend, OR, USA.<br>
1.77      sthen     218: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
1.118     sthen     219: Updated hourly.<br>
1.77      sthen     220: <p>
1.29      grunk     221:
1.12      sturm     222: </ul>
                    223:
1.2       naddy     224: <em>Note:</em> If your server is listed on here with inaccurate or
1.1       espie     225: unknown information, please contact <a
1.138     sthen     226: href="mailto:mirrors-discuss@openbsd.org"><tt>mirrors-discuss@openbsd.org</tt></a>
1.124     tb        227:
1.1       espie     228: <p>
1.137     tb        229: You may want to use <a href="https://man.openbsd.org/traceroute">traceroute(8)</a>
1.1       espie     230: to find out which server is nearest you.
                    231: Problems with a server should be reported to the <b>maintainer</b> of the
                    232: server in question.
1.124     tb        233:
1.1       espie     234: <p>
1.139   ! nayden    235: As of December 2017, the CVS repository sizes are:
1.124     tb        236:
                    237: <p>
1.1       espie     238: <table>
                    239: <tr><td width="20"></td>
                    240:     <td><strong>openbsd-ports</strong></td>
1.139   ! nayden    241:     <td>- <b>1220</b>MB</td></tr>
1.1       espie     242: <tr><td></td>
                    243:     <td><strong>openbsd-src</strong></td>
1.139   ! nayden    244:     <td>- <b>2865</b>MB</td></tr>
1.1       espie     245: <tr><td></td>
                    246:     <td><strong>openbsd-www</strong></td>
1.139   ! nayden    247:     <td>- <b>704</b>MB</td></tr>
1.48      nick      248: <tr><td></td>
                    249:     <td><strong>openbsd-xenocara</strong></td>
1.139   ! nayden    250:     <td>- <b>1658</b>MB</td></tr>
1.1       espie     251: <tr><td></td>
                    252:     <td><strong>openbsd-cvsroot</strong></td>
1.139   ! nayden    253:     <td>- <b>158</b>MB</td></tr>
1.1       espie     254: </table>
1.124     tb        255:
1.1       espie     256: <p>
                    257: The overall repository size currently increases at a rate
1.95      tedu      258: of about <b>400</b>MB per annum. The src repository increases by about
                    259: <b>150</b>MB.
1.124     tb        260:
1.1       espie     261: <p>
                    262: <strong>IMPORTANT NOTE:</strong>
                    263: There are a few issues relating to cryptographic software that everyone
                    264: should be aware of:
1.124     tb        265:
1.1       espie     266: <ul>
                    267:   <li>
                    268:     <p>
                    269:     The OpenBSD sources are from Canada. As
                    270:     <a href="http://www.efc.ca/pages/doc/crypto-export.html">
                    271:     researched by a Canadian individual</a> and as
                    272:     <a href="http://axion.physics.ubc.ca/ECL.html">
                    273:     described in the Export Control list of Canada</a>,
                    274:     it is legal to export crypto software from Canada to the world.
                    275:   </li>
                    276:   <li>
                    277:     <p>
                    278:     However, if you are outside the USA or Canada, you should not
1.8       naddy     279:     fetch the cryptographic sections of the OpenBSD sources from a
                    280:     CVSync server located in the USA. The files in question are...
1.1       espie     281:     <ul>
                    282:       <li><tt>src/kerberosIV/*</tt></li>
                    283:       <li><tt>src/kerberosV/*</tt></li>
                    284:       <li><tt>src/lib/libdes/*</tt></li>
                    285:       <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
                    286:       <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
                    287:       <li><tt>src/sys/crypto</tt></li>
                    288:       <li><tt>src/sys/netinet</tt></li>
                    289:       <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
                    290:     </ul>
                    291:     <p>
                    292:     Because of the USA ITAR munitions list,
                    293:     crypto software may only be exported to Canada from the USA.
                    294:   </li>
                    295: </ul>
                    296:
                    297: </body>
                    298: </html>