Annotation of www/cvsync.html, Revision 1.41
1.37 steven 1: <!-- DO NOT EDIT MANUALLY! This is generated from www/build/mirrors.pl -->
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>
7: <link rev="made" href="mailto:www@openbsd.org">
8: <meta name="resource-type" content="document">
1.6 naddy 9: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
1.1 espie 10: <meta name="description" content="How to get OpenBSD updates via Internet using CVSync">
11: <meta name="keywords" content="openbsd,cvsync,updates">
12: <meta name="distribution" content="global">
1.36 steven 13: <meta name="copyright" content="This document copyright 2003-2006 by OpenBSD.">
1.1 espie 14: </head>
15:
16: <body bgcolor="#FFFFFF" text="#000000" link="#23238E">
17:
18: <a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
19:
20: <h2><font color="#e00000">CVSync</font></h2>
21: <hr>
22:
23: <h3>Table of Contents</h3>
24: <ul>
25: <li><a href="#CVSync">What Is CVSync?</a></li>
1.10 naddy 26: <li><a href="#CVS">What Is CVS?</a></li>
1.1 espie 27: <li><a href="#starting">Getting Started Using CVSync</a></li>
28: <li><a href="#using">Using CVS to Update Your Source Tree</a></li>
29: <li><a href="#CVSROOT">Available CVSync Servers</a></li>
30: </ul>
31:
32: <hr>
33:
34:
35: <h3><a name="CVSync"><font color="#0000e0">What Is CVSync?</font></a></h3>
36:
37: <p>
38: <b>CVSync</b> is a software package for distributing and updating source
39: trees from a master <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1">cvs(1)</a> repository on a remote server host. The OpenBSD
40: sources are maintained in a CVS repository on a central development machine
41: in Canada. With CVSync, OpenBSD users can easily keep their own source trees
1.10 naddy 42: up to date.
1.1 espie 43: </p>
44:
45: <p>
46: <b>CVSync</b> uses the so-called pull model of updating. Under the pull
47: model, each client asks the server for updates, if and when they are
48: wanted. The server waits passively for update requests from its clients.
49: Thus all updates are instigated by the client. The server never sends
50: unsolicited updates. Users must either run the <b>CVSync</b> client
51: manually to get an update, or they must set up a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cron&sektion=8">cron(8)</a> job to run it
1.10 naddy 52: automatically on a regular basis.
1.1 espie 53: </p>
54:
55: <p>
56: The term <b>CVSync</b>, capitalized just so, refers to the entire software
57: package. Its main components are the client <tt>cvsync</tt> which runs on
58: each user's machine, and the server <tt>cvsyncd</tt> which runs at each of
1.10 naddy 59: the OpenBSD CVSync mirror sites.
1.1 espie 60: </p>
61:
62: <p>
1.23 nick 63: <b>CVSync</b> is intended to be both faster and more flexible than
64: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sup&sektion=1&format=html">sup(1)</a>
65: and <a href="cvsup.html">CVSup</a>.
1.10 naddy 66: </p>
1.1 espie 67:
68: <p>
69: The OpenBSD Project currently has five main source repositories:
70: </p>
71:
72: <ul>
73: <li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
74: <li><b>ports</b> - Houses the <a href="./ports.html">OpenBSD Ports</a>.</li>
1.10 naddy 75: <li><b>www</b> - Houses all OpenBSD web pages (including this one).</li>
1.26 matthieu 76: <li><b>X11</b> - Houses OpenBSD's adaptation of the
77: <a href="http://www.XFree86.org/">XFree86-3</a> software project.
78: This is here just for historical purposes, most users will have no
79: reason to use this tree, it is no longer being used.
80: <li><b>XF4</b> - Houses OpenBSD's active X source tree.
1.1 espie 81: </ul>
82:
83: <h3><a name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
84:
85: <p>
86: CVS is the source code control system used to manage the OpenBSD source
87: tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
88: Note that CVS and CVSync are entirely different programs. Although
89: CVS can be used for remote file access, it is not optimized for
90: wholesale source tree distribution over the net, and CVSync can be
91: easily an order of magnitude more efficient for this task.
92: </p>
93:
94: <h3>
95: <a name="starting"><font color="#0000e0">Getting Started Using CVSync</font></a>
96: </h3>
97:
98: <p>
99: If you only care about running CVSync, it is recommended that you
100: download the cvsync package from the <a href="ftp.html">ftp mirror
101: sites</a> instead of building your own from the <tt>net/cvsync</tt>
1.10 naddy 102: port.
1.1 espie 103: </p>
104:
105: <p>
106: For further information about CVSync, see the
107: <a href="http://www.cvsync.org/">project homepage</a>.
108: </p>
109:
110: <p>
111: In order to mirror the OpenBSD repository with CVSync,
112: the following configuration file might be used:
113: </p>
114:
115: <pre>
116: config {
1.40 grunk 117: hostname cvsync.de.openbsd.org
1.5 naddy 118: # If your network link is a T1 or faster, comment out the following line.
1.1 espie 119: compress
1.4 espie 120: collection {
1.5 naddy 121: name openbsd release rcs
1.4 espie 122: prefix /cvs
1.5 naddy 123: umask 002
1.4 espie 124: }
1.1 espie 125: }
126: </pre>
127:
128: <p>
129: This directs cvsync to refresh all OpenBSD distributions from
1.40 grunk 130: <b>cvsync.de.openbsd.org</b> with a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=umask&sektion=2">umask(2)</a> that permits group write
1.1 espie 131: permission to the local repository.
132: </p>
133:
134: <p>
135: Assuming this file is saved as <tt>cvs-syncfile</tt>, the
136: following command would be used to invoke cvsync
137: </p>
138: <pre>
139: cvsync -c cvs-syncfile
140: </pre>
141:
142: <h3><a name="using">
143: <font color="#0000e0">Using CVS to Update Your Source Tree</font>
144: </a></h3>
145:
146: <p>
1.32 ray 147: It is now simple to check out any one of the CVSync'ed repositories:
1.1 espie 148: </p>
149: <pre>
150: # cd /usr
1.32 ray 151: # cvs -d /cvs checkout src
1.1 espie 152: </pre>
153:
154: <p>
155: The above will check out the most current sources. Many of you will only
156: want the release sources, especially if you are patching your system. To
157: checkout release sources you must specify a tag along with your command.
158: For example:
159: </p>
160: <pre>
161: # cd /usr
1.32 ray 162: # cvs -d /cvs checkout -rOPENBSD_3_5 src
1.1 espie 163: </pre>
164: <p>
1.17 david 165: Or <tt>OPENBSD_3_4</tt> for 3.4, etc.
1.1 espie 166: </p>
167:
168: <h3>
169: <a name="CVSROOT"><font color="#0000e0">Available CVSync Servers</font></a>
170: </h3>
171:
172: <p>The following CVSync servers are available:</p>
173:
1.3 naddy 174: <p>
1.6 naddy 175: <ul>
1.38 grunk 176: <li><strong>cvsync.de.openbsd.org</strong><br>
177: Location: University of Erlangen-Nuremberg, Erlangen, Germany.<br>
178: Maintained by <a href="mailto:grunk@pestilenz.org">Alexander von Gernler</a>.<br>
179: Updated every 2 hours.<br>
180: <p>
1.14 millert 181: <li><strong>anoncvs1.usa.openbsd.org</strong><br>
1.37 steven 182: Host also known as <strong>anoncvs.usa.openbsd.org, anoncvs4.usa.openbsd.org</strong>.<br>
183: Location: Redwood City, CA, USA.<br>
184: Maintained by <a href="mailto:millert@openbsd.org">Todd Miller</a>.<br>
1.14 millert 185: Updated every 2 hours.<br>
186: <p>
1.15 millert 187: <li><strong>anoncvs3.usa.openbsd.org</strong><br>
1.37 steven 188: Location: National Center for Atmospheric Research, Boulder, CO, USA.<br>
189: Maintained by <a href="mailto:millert@openbsd.org">Todd Miller</a>.<br>
1.14 millert 190: Updated every 2 hours.<br>
1.37 steven 191: <p>
1.6 naddy 192: <li><a href="http://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
1.37 steven 193: Location: Nürnberg, Germany.<br>
194: Maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.<br>
1.20 naddy 195: Updated every 4 hours from anoncvs1.usa.openbsd.org.<br>
1.1 espie 196: <p>
1.37 steven 197: <li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
198: Location: Tokyo, Japan.<br>
199: Maintained by <a href="mailto:hrs@allbsd.org">Hiroki Sato</a>.<br>
200: <p>
201: <li><strong>cvsync.openbsd.nu</strong><br>
202: Location: Stockholm, Sweden.<br>
203: Maintained by <a href="mailto:kent@openbsd.nu">Kent Riboe</a>.<br>
204: Updated every 3 hours from cvsync.de.openbsd.org.<br>
1.21 naddy 205: <p>
206: <li><strong>openbsd.cc.ntu.edu.tw</strong><br>
1.37 steven 207: Location: NTU, Taipei, Taiwan.<br>
208: Maintained by <a href="mailto:lkchu@ntuee.net">Liang-Kai Chu</a>.<br>
1.21 naddy 209: Updated every 2 hours.<br>
1.24 naddy 210: <p>
211: <li><a href="http://mirror.sg.depaul.edu/"><strong>mirror.sg.depaul.edu</strong></a><br>
1.37 steven 212: Location: DePaul University, Chicago, IL, USA.<br>
213: Maintained by <a href="mailto:mirror-admin@sg.depaul.edu">Eric Pancer</a>.<br>
1.24 naddy 214: Updated every 2 hours.<br>
1.25 nick 215: <p>
1.37 steven 216: <li><a href="http://csociety.org/cvsup.html"><strong>cvsync.csociety.org</strong></a><br>
217: Location: Purdue University, West Lafayette, IN, USA.<br>
218: Maintained by <a href="mailto:will@csociety.purdue.edu">Will Andrews</a>.<br>
219: <p>
1.29 grunk 220:
1.12 sturm 221: </ul>
222:
223: <p>
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
226: href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
227: or <a href="mailto:naddy@openbsd.org"><tt>naddy@openbsd.org</tt></a>
228: </p>
229: <p>
230: You may want to use <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute&sektion=8">traceroute(8)</a>
231: to find out which server is nearest you.
232: Problems with a server should be reported to the <b>maintainer</b> of the
233: server in question.
234: </p>
235: <p>
1.36 steven 236: As of August 21, 2006, the CVS repository sizes are
1.1 espie 237: </p>
238: <table>
239: <tr><td width="20"></td>
240: <td><strong>openbsd-ports</strong></td>
1.36 steven 241: <td>- <b>222</b>MB</td></tr>
1.1 espie 242: <tr><td></td>
243: <td><strong>openbsd-src</strong></td>
1.36 steven 244: <td>- <b>1396</b>MB</td></tr>
1.1 espie 245: <tr><td></td>
246: <td><strong>openbsd-www</strong></td>
1.36 steven 247: <td>- <b>247</b>MB</td></tr>
1.1 espie 248: <tr><td></td>
249: <td><strong>openbsd-x11</strong></td>
250: <td>- <b>200</b>MB</td></tr>
251: <tr><td></td>
252: <td><strong>openbsd-xf4</strong></td>
1.36 steven 253: <td>- <b>562</b>MB</td></tr>
1.1 espie 254: <tr><td></td>
255: <td><strong>openbsd-cvsroot</strong></td>
1.36 steven 256: <td>- <b>408</b>MB</td></tr>
1.1 espie 257: </table>
258: <p>
259: The overall repository size currently increases at a rate
1.22 nick 260: of about <b>400</b>MB per annum.
1.1 espie 261: </p>
262: <p>
263: <strong>IMPORTANT NOTE:</strong>
264: There are a few issues relating to cryptographic software that everyone
265: should be aware of:
266: </p>
267: <ul>
268: <li>
269: <p>
270: The OpenBSD sources are from Canada. As
271: <a href="http://www.efc.ca/pages/doc/crypto-export.html">
272: researched by a Canadian individual</a> and as
273: <a href="http://axion.physics.ubc.ca/ECL.html">
274: described in the Export Control list of Canada</a>,
275: it is legal to export crypto software from Canada to the world.
276: </p>
277: </li>
278: <li>
279: <p>
280: However, if you are outside the USA or Canada, you should not
1.8 naddy 281: fetch the cryptographic sections of the OpenBSD sources from a
282: CVSync server located in the USA. The files in question are...
1.1 espie 283: </p>
284: <ul>
285: <li><tt>src/kerberosIV/*</tt></li>
286: <li><tt>src/kerberosV/*</tt></li>
287: <li><tt>src/lib/libdes/*</tt></li>
288: <li><tt>src/lib/libc/crypt/crypt.c</tt></li>
289: <li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
290: <li><tt>src/sys/crypto</tt></li>
291: <li><tt>src/sys/netinet</tt></li>
292: <li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
293: <li><tt>XF4/xc-mit/lib/Xdmcp/Wraphelp.c</tt></li>
294: <li><tt>XF4/xc-old/lib/Xdmcp/Wraphelp.c</tt></li>
295: <li><tt>XF4/xc/lib/Xdmcp/Wraphelp.c</tt></li>
296: </ul>
297: <p>
298: Because of the USA ITAR munitions list,
299: crypto software may only be exported to Canada from the USA.
300: </p>
301: </li>
302: </ul>
303:
304: <p>
305: The OpenBSD project is looking for more CVSync servers -- if you are
306: interested, please contact <a href="mailto:naddy@openbsd.org">Christian Weisgerber</a>
307: for configuration details.
308: </p>
309:
310: <hr>
311: <a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD"></a>
312: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.37 steven 313: <br><small>$OpenBSD: cvsync.html.end,v 1.1 2006/08/23 07:39:34 steven Exp $</small>
1.1 espie 314:
315: </body>
316: </html>
![[BACK]](/icons/back.gif){kind=icon}
Return to cvsync.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / www