Annotation of www/cvsync.html, Revision 1.145
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: <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ü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>
1.145 ! sthen 198: Updated hourly.<br>
1.77 sthen 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>