File: [local] / www / Attic / cvsync.html (download) (as text)
Revision 1.14, Mon Mar 22 21:17:29 2004 UTC (20 years, 2 months ago) by millert
Branch: MAIN
Changes since 1.13: +9 -3 lines
anoncvs1.usa.openbsd.org now supports cvsync
anoncvs.usa.openbsd.org updates every 2 hours, not 3
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>OpenBSD CVSync</title>
<link rev="made" href="mailto:www@openbsd.org">
<meta name="resource-type" content="document">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="description" content="How to get OpenBSD updates via Internet using CVSync">
<meta name="keywords" content="openbsd,cvsync,updates">
<meta name="distribution" content="global">
<meta name="copyright" content="This document copyright 2003-2004 by OpenBSD.">
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#23238E">
<a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
<h2><font color="#e00000">CVSync</font></h2>
<hr>
<h3>Table of Contents</h3>
<ul>
<li><a href="#CVSync">What Is CVSync?</a></li>
<li><a href="#CVS">What Is CVS?</a></li>
<li><a href="#starting">Getting Started Using CVSync</a></li>
<li><a href="#using">Using CVS to Update Your Source Tree</a></li>
<li><a href="#CVSROOT">Available CVSync Servers</a></li>
</ul>
<hr>
<h3><a name="CVSync"><font color="#0000e0">What Is CVSync?</font></a></h3>
<p>
<b>CVSync</b> is a software package for distributing and updating source
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
sources are maintained in a CVS repository on a central development machine
in Canada. With CVSync, OpenBSD users can easily keep their own source trees
up to date.
</p>
<p>
<b>CVSync</b> uses the so-called pull model of updating. Under the pull
model, each client asks the server for updates, if and when they are
wanted. The server waits passively for update requests from its clients.
Thus all updates are instigated by the client. The server never sends
unsolicited updates. Users must either run the <b>CVSync</b> client
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
automatically on a regular basis.
</p>
<p>
The term <b>CVSync</b>, capitalized just so, refers to the entire software
package. Its main components are the client <tt>cvsync</tt> which runs on
each user's machine, and the server <tt>cvsyncd</tt> which runs at each of
the OpenBSD CVSync mirror sites.
</p>
<p>
<b>CVSync</b> is intended to be both faster and flexible than
<a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sup&sektion=1&format=html">sup(1)</a> and CVSup.
</p>
<p>
The OpenBSD Project currently has five main source repositories:
</p>
<ul>
<li><b>src</b> - Houses all source code for the OpenBSD Operating System.</li>
<li><b>ports</b> - Houses the <a href="./ports.html">OpenBSD Ports</a>.</li>
<li><b>www</b> - Houses all OpenBSD web pages (including this one).</li>
<li><b>x11</b> - Houses OpenBSD's adaptation of the
<a href="http://www.XFree86.org/">XFree86-3</a> software project.</li>
<li><b>xf4</b> - Houses OpenBSD's adaptation of the
<a href="http://www.XFree86.org/">XFree86-4</a> software project.</li>
</ul>
<h3><a name="CVS"><font color="#0000e0">What Is CVS?</font></a></h3>
<p>
CVS is the source code control system used to manage the OpenBSD source
tree. It is described in more detail <a href="anoncvs.html#CVS">here</a>.
Note that CVS and CVSync are entirely different programs. Although
CVS can be used for remote file access, it is not optimized for
wholesale source tree distribution over the net, and CVSync can be
easily an order of magnitude more efficient for this task.
</p>
<h3>
<a name="starting"><font color="#0000e0">Getting Started Using CVSync</font></a>
</h3>
<p>
If you only care about running CVSync, it is recommended that you
download the cvsync package from the <a href="ftp.html">ftp mirror
sites</a> instead of building your own from the <tt>net/cvsync</tt>
port.
</p>
<p>
For further information about CVSync, see the
<a href="http://www.cvsync.org/">project homepage</a>.
</p>
<p>
In order to mirror the OpenBSD repository with CVSync,
the following configuration file might be used:
</p>
<pre>
config {
hostname anoncvs.de.openbsd.org
# If your network link is a T1 or faster, comment out the following line.
compress
collection {
name openbsd release rcs
prefix /cvs
umask 002
}
}
</pre>
<p>
This directs cvsync to refresh all OpenBSD distributions from
<b>anoncvs.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
permission to the local repository.
</p>
<p>
Assuming this file is saved as <tt>cvs-syncfile</tt>, the
following command would be used to invoke cvsync
</p>
<pre>
cvsync -c cvs-syncfile
</pre>
<h3><a name="using">
<font color="#0000e0">Using CVS to Update Your Source Tree</font>
</a></h3>
<p>
It is now simple to check out any one of the CVSync'ed repositories.
For Korn/Bourne shells:
</p>
<pre>
# cd /usr
# CVSROOT=/cvs cvs checkout src
</pre>
<p>
For csh and its derivatives:
</p>
<pre>
# cd /usr
# setenv CVSROOT /cvs
# cvs checkout src
</pre>
<p>
The above will check out the most current sources. Many of you will only
want the release sources, especially if you are patching your system. To
checkout release sources you must specify a tag along with your command.
For example:
</p>
<pre>
# cd /usr
# cvs checkout -rOPENBSD_3_4 src
</pre>
<p>
Or <tt>OPENBSD_3_3</tt> for 3.3, etc.
</p>
<h3>
<a name="CVSROOT"><font color="#0000e0">Available CVSync Servers</font></a>
</h3>
<p>The following CVSync servers are available:</p>
<p>
<ul>
<li><strong>anoncvs1.usa.openbsd.org</strong><br>
located at the University of Colorado, Boulder, western USA;<br>
maintained by <a href="mailto:millert@openbsd.org">Todd Miller</a>.<br>
Updated every 2 hours.<br>
<p>
<li><strong>anoncvs.usa.openbsd.org</strong><br>
located in Redwood City, California, western USA;<br>
maintained by <a href="mailto:millert@openbsd.org">Todd Miller</a>.<br>
Updated every 2 hours.<br>
<p>
<li><a href="http://anoncvs.de.openbsd.org/"><strong>anoncvs.de.openbsd.org</strong></a><br>
Host also known as <strong>grappa.unix-ag.uni-kl.de</strong>,<br>
located at the University of Kaiserslautern, Germany;<br>
maintained by <a href="mailto:naddy@openbsd.org">Christian Weisgerber</a>.<br>
Updated every 6 hours from anoncvs.usa.openbsd.org.<br>
<p>
<li><a href="http://www.allbsd.org/"><strong>cvsync.allbsd.org</strong></a><br>
located in Tokyo, Japan;<br>
maintained by <a href="mailto:hrs@allbsd.org">Hiroki Sato</a>.<br>
<p>
<li><a href="http://csociety.org/cvsup.html"><strong>cvsync.csociety.org</strong></a><br>
located at Purdue University, Indiana, USA;<br>
maintained by <a href="mailto:will@csociety.purdue.edu">Will Andrews</a>.<br>
<p>
<li><strong>cvsync.linux.org.tr</strong><br>
located at ULAKBIM, Ankara, Bilkent, Turkey;<br>
maintained by <a href="mailto:bdd@mindcast.org">Berk D. Demir</a>.<br>
Updated every 2 hours from anoncvs.usa.openbsd.org.<br>
<p>
<li><a href="http://mirror.osn.de/"><strong>mirror.osn.de</strong></a><br>
located in Nürnberg, Germany;<br>
maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.<br>
Updated every 4 hours from cvsup.uk.openbsd.org.<br>
<p>
<li><a href="http://anoncvs.erisiandiscord.de/"><strong>anoncvs.erisiandiscord.de</strong></a><br>
located in Darmstadt, Germany;<br>
maintained by <a href="mailto:sturm@openbsd.org">Nikolay Sturm</a>.<br>
Updated every 3 hours from cvsup.uk.openbsd.org.<br>
</ul>
<p>
<em>Note:</em> If your server is listed on here with inaccurate or
unknown information, please contact <a
href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>
or <a href="mailto:naddy@openbsd.org"><tt>naddy@openbsd.org</tt></a>
</p>
<p>
You may want to use <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute&sektion=8">traceroute(8)</a>
to find out which server is nearest you.
Problems with a server should be reported to the <b>maintainer</b> of the
server in question.
</p>
<p>
Currently (as of December 17, 2003), the CVS repository sizes are
</p>
<table>
<tr><td width="20"></td>
<td><strong>openbsd-ports</strong></td>
<td>- <b>140</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-src</strong></td>
<td>- <b>1140</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-www</strong></td>
<td>- <b>104</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-x11</strong></td>
<td>- <b>200</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-xf4</strong></td>
<td>- <b>442</b>MB</td></tr>
<tr><td></td>
<td><strong>openbsd-cvsroot</strong></td>
<td>- <b>257</b>MB</td></tr>
</table>
<p>
The overall repository size currently increases at a rate
of about <b>225</b>MB per annum.
</p>
<p>
<strong>IMPORTANT NOTE:</strong>
There are a few issues relating to cryptographic software that everyone
should be aware of:
</p>
<ul>
<li>
<p>
The OpenBSD sources are from Canada. As
<a href="http://www.efc.ca/pages/doc/crypto-export.html">
researched by a Canadian individual</a> and as
<a href="http://axion.physics.ubc.ca/ECL.html">
described in the Export Control list of Canada</a>,
it is legal to export crypto software from Canada to the world.
</p>
</li>
<li>
<p>
However, if you are outside the USA or Canada, you should not
fetch the cryptographic sections of the OpenBSD sources from a
CVSync server located in the USA. The files in question are...
</p>
<ul>
<li><tt>src/kerberosIV/*</tt></li>
<li><tt>src/kerberosV/*</tt></li>
<li><tt>src/lib/libdes/*</tt></li>
<li><tt>src/lib/libc/crypt/crypt.c</tt></li>
<li><tt>src/lib/libc/crypt/morecrypt.c</tt></li>
<li><tt>src/sys/crypto</tt></li>
<li><tt>src/sys/netinet</tt></li>
<li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
<li><tt>XF4/xc-mit/lib/Xdmcp/Wraphelp.c</tt></li>
<li><tt>XF4/xc-old/lib/Xdmcp/Wraphelp.c</tt></li>
<li><tt>XF4/xc/lib/Xdmcp/Wraphelp.c</tt></li>
</ul>
<p>
Because of the USA ITAR munitions list,
crypto software may only be exported to Canada from the USA.
</p>
</li>
</ul>
<p>
The OpenBSD project is looking for more CVSync servers -- if you are
interested, please contact <a href="mailto:naddy@openbsd.org">Christian Weisgerber</a>
for configuration details.
</p>
<hr>
<a href="index.html"><img height="24" width="24" src="back.gif" border="0" alt="OpenBSD"></a>
<a href="mailto:www@openbsd.org">www@openbsd.org</a>
<br><small>$OpenBSD: cvsync.html,v 1.14 2004/03/22 21:17:29 millert Exp $</small>
</body>
</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