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

Annotation of www/cvsync.html, Revision 1.144

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