Annotation of www/cvsync.html, Revision 1.124
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>
6: <title>OpenBSD CVSync</title>
1.6 naddy 7: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
1.1 espie 8: <meta name="description" content="How to get OpenBSD updates via Internet using CVSync">
1.121 tb 9: <meta name="copyright" content="This document copyright 2003-2016 by OpenBSD.">
10: <meta name="viewport" content="width=device-width, initial-scale=1">
11: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.114 sthen 12: <link rel="canonical" href="http://www.openbsd.org/cvsync.html">
1.1 espie 13: </head>
14:
15: <body bgcolor="#FFFFFF" text="#000000" link="#23238E">
16:
1.121 tb 17: <h2>
1.122 tb 18: <a href="index.html">
1.121 tb 19: <font color="#0000ff"><i>Open</i></font><font color="#000084">BSD</font></a>
20: <font color="#e00000">CVSync</font>
21: </h2>
1.1 espie 22: <hr>
1.121 tb 23: <p>
1.1 espie 24:
1.124 ! tb 25: <h3 id="CVSync"><font color="#0000e0">What Is CVSync?</font></h3>
1.1 espie 26:
27: <b>CVSync</b> is a software package for distributing and updating source
1.124 ! tb 28: trees from a master <a href="http://man.openbsd.org/cvs">cvs(1)</a>
! 29: repository on a remote server host.
! 30: The OpenBSD sources are maintained in a CVS repository on a central
! 31: development machine in Canada.
! 32: With CVSync, OpenBSD users can easily keep their own source trees up to date.
1.1 espie 33:
34: <p>
35: <b>CVSync</b> uses the so-called pull model of updating. Under the pull
36: model, each client asks the server for updates, if and when they are
37: wanted. The server waits passively for update requests from its clients.
38: Thus all updates are instigated by the client. The server never sends
39: unsolicited updates. Users must either run the <b>CVSync</b> client
1.124 ! tb 40: manually to get an update, or they must set up a
! 41: <a href="http://man.openbsd.org/cron">cron(8)</a> job to run it
1.10 naddy 42: automatically on a regular basis.
1.1 espie 43:
44: <p>
45: The term <b>CVSync</b>, capitalized just so, refers to the entire software
46: package. Its main components are the client <tt>cvsync</tt> which runs on
47: each user's machine, and the server <tt>cvsyncd</tt> which runs at each of
1.10 naddy 48: the OpenBSD CVSync mirror sites.
1.1 espie 49:
50: <p>
1.23 nick 51: <b>CVSync</b> is intended to be both faster and more flexible than
1.97 tedu 52: sup and CVSup.
1.1 espie 53:
54: <p>
1.42 nick 55: The OpenBSD Project currently has six main source repositories:
1.1 espie 56:
57: <ul>
58: <li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
1.78 steven 59: <li><b>ports</b> - Houses the <a href="faq/ports/index.html">OpenBSD Ports</a>.</li>
1.10 naddy 60: <li><b>www</b> - Houses all OpenBSD web pages (including this one).</li>
1.26 matthieu 61: <li><b>X11</b> - Houses OpenBSD's adaptation of the
62: <a href="http://www.XFree86.org/">XFree86-3</a> software project.
1.51 deraadt 63: <li><b>XF4</b> - Houses OpenBSD's adaptation of the XFree86-4 source tree.
64: <li><b>xenocara</b> - Houses OpenBSD's active X.org v7 source tree.
1.1 espie 65: </ul>
66:
1.84 jasper 67: The <b>X11</b> and <b>XF4</b> repositories are here just for historical
1.97 tedu 68: purposes, most users will have no reason to use those trees, they are no longer
1.84 jasper 69: being used.
70:
1.124 ! tb 71: <h3 id="CVS"><font color="#0000e0">What Is CVS?</font></h3>
1.1 espie 72:
73: <p>
74: CVS is the source code control system used to manage the OpenBSD source
75: tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
76: Note that CVS and CVSync are entirely different programs. Although
77: CVS can be used for remote file access, it is not optimized for
78: wholesale source tree distribution over the net, and CVSync can be
79: easily an order of magnitude more efficient for this task.
80:
1.124 ! tb 81: <h3 id="starting"><font color="#0000e0">Getting Started Using CVSync</font></h3>
1.1 espie 82:
83: If you only care about running CVSync, it is recommended that you
84: download the cvsync package from the <a href="ftp.html">ftp mirror
85: sites</a> instead of building your own from the <tt>net/cvsync</tt>
1.10 naddy 86: port.
1.1 espie 87:
88: <p>
89: For further information about CVSync, see the
90: <a href="http://www.cvsync.org/">project homepage</a>.
1.116 sthen 91: However, don't build your own copy from unmodified upstream source -
92: the port/package has been modified to support commitid which is now
93: used in the OpenBSD repository.
1.1 espie 94:
95: <p>
96: In order to mirror the OpenBSD repository with CVSync,
97: the following configuration file might be used:
98:
99: <pre>
100: config {
1.103 mpi 101: hostname anoncvs.eu.openbsd.org
1.5 naddy 102: # If your network link is a T1 or faster, comment out the following line.
1.1 espie 103: compress
1.4 espie 104: collection {
1.5 naddy 105: name openbsd release rcs
1.4 espie 106: prefix /cvs
1.5 naddy 107: umask 002
1.4 espie 108: }
1.1 espie 109: }
110: </pre>
111:
112: <p>
113: This directs cvsync to refresh all OpenBSD distributions from
1.124 ! tb 114: <b>anoncvs.eu.openbsd.org</b> with a
! 115: <a href="http://man.openbsd.org/umask">umask(2)</a> that permits group write
1.1 espie 116: permission to the local repository.
117:
118: <p>
119: Assuming this file is saved as <tt>cvs-syncfile</tt>, the
120: following command would be used to invoke cvsync
1.124 ! tb 121:
1.1 espie 122: <pre>
1.91 nick 123: <b>cvsync -c cvs-syncfile</b>
1.1 espie 124: </pre>
125:
1.124 ! tb 126: <h3 id="using"><font color="#0000e0">Using CVS to Work With Your Repository
! 127: </font></h3>
1.1 espie 128:
1.48 nick 129: Now that you have a local copy of the CVS repository, it is now simple
130: to check out, update, or do any of the other CVS operations you would
131: normally do against a remote repository, locally.
1.50 nick 132: For example:
1.1 espie 133: <pre>
1.91 nick 134: <b>cvs -d/cvs checkout -P src</b>
135: <b>cvs -d/cvs up -Pd</b>
136: <b>cvs -d/cvs diff -u file.c</b>
1.1 espie 137: </pre>
1.48 nick 138: More details on CVS operation can be found in
139: <a href="faq/faq5.html#BldGetSrc">FAQ5, Fetching appropriate source
140: code</a> and in the
1.124 ! tb 141: <a href="http://man.openbsd.org/cvs">cvs(1)</a>
1.48 nick 142: man page.
1.1 espie 143:
1.124 ! tb 144: <h3 id="CVSROOT"><font color="#0000e0">Available CVSync Servers</font></h3>
1.1 espie 145:
1.124 ! tb 146: The following CVSync servers are available:
1.1 espie 147:
1.6 naddy 148: <ul>
1.72 sthen 149: <li><strong>ftp5.eu.openbsd.org</strong><br>
150: Host also known as <strong>anga.funkfeuer.at</strong>.<br>
1.44 martin 151: Location: Vienna, Austria.<br>
1.104 naddy 152: Maintained by <a href="mailto:martin@catai.org">Martin Reindl</a>.<br>
153: Updated hourly.<br>
1.44 martin 154: <p>
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.110 nick 160: <li><strong>openbsd.cs.toronto.edu</strong><br>
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>
166: Location: Paris, France.<br>
1.117 sthen 167: Maintained by <a href="mailto:openbsd-mirror@bsdfrog.org">Landry Breuil, Antoine Jacoutot</a>.<br>
1.88 sthen 168: Updated every 2 hours from anoncvs1.ca.openbsd.org.<br>
169: <p>
1.90 sthen 170: <li><a href="http://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
1.37 steven 171: Location: Nürnberg, Germany.<br>
172: Maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.<br>
1.62 sthen 173: Updated every 3 hours.<br>
1.1 espie 174: <p>
1.112 florian 175: <li><strong>ftp.hostserver.de</strong><br>
176: Location: Frankfurt, Germany.<br>
177: Maintained by <a href="mailto:mirror@hostserver.de">Sebastian Benoit, Florian Obser</a>.<br>
178: Updated hourly from anoncvs1.ca.openbsd.org.<br>
179: <p>
1.90 sthen 180: <li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
1.37 steven 181: Location: Tokyo, Japan.<br>
182: Maintained by <a href="mailto:hrs@allbsd.org">Hiroki Sato</a>.<br>
1.69 sthen 183: <p>
1.77 sthen 184: <li><strong>anoncvs.eu.openbsd.org</strong><br>
185: Location: Stockholm University, Stockholm, Sweden.<br>
1.93 sthen 186: Maintained by <a href="mailto:jj@openbsd.org, ftp@it.su.se">Janne Johansson</a>.<br>
1.77 sthen 187: Updated every 2 hours.<br>
188: <p>
189: <li><strong>anoncvs.spacehopper.org</strong><br>
190: Location: London, United Kingdom.<br>
191: Maintained by <a href="mailto:sthen@openbsd.org">Stuart Henderson</a>.<br>
192: Updated hourly from anoncvs.ca.openbsd.org.<br>
193: <p>
1.118 sthen 194: <li><strong>anoncvs3.usa.openbsd.org</strong><br>
195: Location: National Center for Atmospheric Research, Boulder, CO, USA.<br>
196: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
197: Updated hourly.<br>
198: <p>
199: <li><strong>anoncvs2.usa.openbsd.org</strong><br>
200: Host also known as <strong>anoncvs2.usa.openbsd.org</strong>.<br>
201: Location: Rochester Institute of Technology, Rochester, NY, USA.<br>
202: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
203: Updated hourly.<br>
204: <p>
1.77 sthen 205: <li><strong>anoncvs1.usa.openbsd.org</strong><br>
206: Host also known as <strong>anoncvs.usa.openbsd.org, anoncvs4.usa.openbsd.org</strong>.<br>
1.118 sthen 207: Location: Network Media, LLC, Bend, OR, USA.<br>
1.77 sthen 208: Maintained by <a href="mailto:millert@openbsd.org">Todd C. Miller</a>.<br>
1.118 sthen 209: Updated hourly.<br>
1.77 sthen 210: <p>
1.29 grunk 211:
1.12 sturm 212: </ul>
213:
1.2 naddy 214: <em>Note:</em> If your server is listed on here with inaccurate or
1.1 espie 215: unknown information, please contact <a
216: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
1.124 ! tb 217:
1.1 espie 218: <p>
1.124 ! tb 219: You may want to use <a href="http://man.openbsd.org/traceroute">traceroute(8)</a>
1.1 espie 220: to find out which server is nearest you.
221: Problems with a server should be reported to the <b>maintainer</b> of the
222: server in question.
1.124 ! tb 223:
1.1 espie 224: <p>
1.123 sthen 225: As of March 2016, the CVS repository sizes are
1.124 ! tb 226:
! 227: <p>
1.1 espie 228: <table>
229: <tr><td width="20"></td>
230: <td><strong>openbsd-ports</strong></td>
1.123 sthen 231: <td>- <b>857</b>MB</td></tr>
1.1 espie 232: <tr><td></td>
233: <td><strong>openbsd-src</strong></td>
1.123 sthen 234: <td>- <b>2201</b>MB</td></tr>
1.1 espie 235: <tr><td></td>
236: <td><strong>openbsd-www</strong></td>
1.123 sthen 237: <td>- <b>598</b>MB</td></tr>
1.48 nick 238: <tr><td></td>
239: <td><strong>openbsd-xenocara</strong></td>
1.123 sthen 240: <td>- <b>1426</b>MB</td></tr>
1.1 espie 241: <tr><td></td>
242: <td><strong>openbsd-x11</strong></td>
243: <td>- <b>200</b>MB</td></tr>
244: <tr><td></td>
245: <td><strong>openbsd-xf4</strong></td>
1.48 nick 246: <td>- <b>564</b>MB</td></tr>
1.1 espie 247: <tr><td></td>
248: <td><strong>openbsd-cvsroot</strong></td>
1.123 sthen 249: <td>- <b>1248</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: <li>
273: <p>
274: However, if you are outside the USA or Canada, you should not
1.8 naddy 275: fetch the cryptographic sections of the OpenBSD sources from a
276: CVSync server located in the USA. The files in question are...
1.1 espie 277: <ul>
278: <li><tt>src/kerberosIV/*</tt></li>
279: <li><tt>src/kerberosV/*</tt></li>
280: <li><tt>src/lib/libdes/*</tt></li>
281: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
282: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
283: <li><tt>src/sys/crypto</tt></li>
284: <li><tt>src/sys/netinet</tt></li>
285: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
286: <li><tt>XF4/xc-mit/lib/Xdmcp/Wraphelp.c</tt></li>
287: <li><tt>XF4/xc-old/lib/Xdmcp/Wraphelp.c</tt></li>
288: <li><tt>XF4/xc/lib/Xdmcp/Wraphelp.c</tt></li>
289: </ul>
290: <p>
291: Because of the USA ITAR munitions list,
292: crypto software may only be exported to Canada from the USA.
293: </li>
294: </ul>
295:
296: </body>
297: </html>