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ü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>