File: [local] / www / Attic / cvsup.html (download) (as text)
Revision 1.15, Wed Dec 6 22:32:35 2000 UTC (23 years, 5 months ago) by brian
Branch: MAIN
Changes since 1.14: +9 -8 lines
Update repository sizes
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>OpenBSD CVSup</title>
<link rev="made" href="mailto:www@openbsd.org" />
<meta name="resource-type" content="document" />
<meta name="description" content="How to get OpenBSD updates via Internet using CVSup" />
<meta name="keywords" content="openbsd,cvsup,updates" />
<meta name="distribution" content="global" />
<meta name="copyright" content="This document copyright 2000 by OpenBSD." />
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#23238E">
<img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" />
<h2><font color="#e00000">CVSup</font></h2>
<hr />
<h3>Table of Contents</h3>
<ul>
<li><a href="#cvsup">What Is CVSup?</a></li>
<li><a href="#starting">Getting Started Using CVSup</a></li>
<li><a href="#using">Using CVS to Update Your Source Tree</a></li>
<li><a href="#checkout">Running CVSup in Checkout Mode</a></li>
<li><a href="#CVSROOT">Available CVSup Servers</a></li>
</ul>
<hr />
<h3><a id="cvsup" name="cvsup"><font color="#0000e0">What Is CVSup?</font></a></h3>
<p>
<b>CVSup</b> is a software package for distributing and updating source
trees from a master CVS repository on a remote server host. The OpenBSD
sources are maintained in a CVS repository on a central development machine
in Canada. With CVSup, OpenBSD users can easily keep their own source trees
up to date.
</p>
<p>
<b>CVSup</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>CVSup</b> client
manually to get an update, or they must set up a cron job to run it
automatically on a regular basis.
</p>
<p>
The term <b>CVSup</b>, capitalized just so, refers to the entire software
package. Its main components are the client <tt>cvsup</tt> which runs on
each user's machine, and the server <tt>cvsupd</tt> which runs at each of
the OpenBSD CVSup mirror sites.
</p>
<p>
<b>CVSup</b> is intended to be both faster and more flexible than
<b>sup</b>, CVSup's predecessor.
</p>
<p>
The OpenBSD Project currently has four 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</a> software project.</li>
</ul>
<h3><a id="CVS" 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>.
</p>
<h3>
<a id="starting" name="starting"><font color="#0000e0">Getting Started Using CVSup</font></a>
</h3>
<p>
The latest version of CVSup is available at
<a href="http://www.polstra.com/projects/freeware/CVSup/">
http://www.polstra.com/projects/freeware/CVSup/</a>.
</p>
<p>
Building CVSup from the sources is not for the fainthearted since
it is written in Modula-3. There is a port of the CVSup client
(<tt>net/cvsup-bin</tt>) which provides John's pre-compiled executables
for the i386 and sparc architectures that run under FreeBSD and
SunOS emulation, respectively, since there is no native port of
Modula-3 to OpenBSD yet.
</p>
<p>
The following configuration file might be used:
</p>
<pre>
# Defaults that apply to all the collections
*default release=cvs
*default delete use-rel-suffix
*default umask=002
*default host=cvsup.uk.OpenBSD.org
*default base=/cvs
*default prefix=/cvs
# If your network link is a T1 or faster, comment out the following line.
*default compress
OpenBSD-all
#OpenBSD-src
#OpenBSD-www
#OpenBSD-ports
#OpenBSD-x11
</pre>
<p>
This directs cvsup to refresh all OpenBSD distributions from
<b>cvsup.uk.OpenBSD.org</b> with a umask that permits group write
permission to the local repository.
</p>
<p>
Assuming this file is saved as <tt>cvs-supfile</tt>, the
following command would be used to envoke the cvsup GUI:
</p>
<pre>
cvsup cvs-supfile
</pre>
<p>
whereas for batch mode, the following might be used:
</p>
<pre>
cvsup -g -L 2 cvs-supfile
</pre>
<h3><a id="using" 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 CVSup'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_2_6 src
</pre>
<p>
Or <tt>OPENBSD_2_5</tt> for 2.5, etc.
</p>
<h3><a id="checkout" name="checkout"><font color="#0000e0">Running CVSup in
Checkout Mode</font></a></h3>
<p>
As an alternative to getting the repository and using CVS, you can
run CVSup in checkout mode by adding a <tt>tag</tt> or <tt>date</tt>
keyword to your supfile, either as a <tt>*default</tt> or as an
option to a collection. In particular, you can use this to efficiently
update the source and ports trees shipped on the <a
href="orders.html">CDROMs</a>.
</p>
<p>
The following supfile could be used to update your ports tree:
</p>
<pre>
# Defaults that apply to all the collections
*default host=cvsup.uk.openbsd.org
*default base=/var
*default prefix=/usr
*default release=cvs
*default delete use-rel-suffix compress
# Ports Collection.
OpenBSD-ports tag=.
</pre>
<p>
Any CVS symbolic tag can be used. A single period "." means HEAD,
i.e. the newest revision of all files in the main branch. Take care
to specify an existing tag, as CVSup cannot distinguish valid from
invalid tags, and an attempt to synchronize an existing source tree
to an invalid tag will remove all files.
</p>
<p>
Alternatively, use the keyword <tt>date=[cc.]yy.mm.dd.hh.mm.ss</tt>
to select a revision by date. All 17 or 19 characters must be
given as shown. For the years 2000 and beyond, specify the century
<var>cc</var>. For earlier years, specify only the last two digits
<var>yy</var>. You may also combine the <tt>tag</tt> and <tt>date</tt>
keywords.
</p>
<h3>
<a id="CVSROOT" name="CVSROOT"><font color="#0000e0">Available CVSup Servers</font></a>
</h3>
<p>The following CVSup servers are available:</p>
<dl>
<dt><strong>cvsup.uk.OpenBSD.org</strong></dt>
<dd><p>
located in Brighton, UK;
maintained by <a href="mailto:brian@OpenBSD.org">Brian Somers</a>.<br />
updated every 2 hours.
</p>
<p>
Available collections:
</p>
<table>
<tr><td width="20"></td>
<td><strong>OpenBSD-src</strong></td>
<td>- The <b>src</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-ports</strong></td>
<td>- The <b>ports</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-www</strong></td>
<td>- The <b>www</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-x11</strong></td>
<td>- The <b>x11</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-all</strong></td>
<td>- All OpenBSD repositories</td></tr>
</table>
</dd>
</dl>
<dl>
<dt><strong>cvsup.de.OpenBSD.org</strong></dt>
<dd><p>
located near Frankfurt am Main, Germany;
maintained by <a href="mailto:wosch@FreeBSD.org">Wolfram Schneider</a>.<br />
updated by CTM.
</p>
<p>
Available collections:
</p>
<table>
<tr><td width="20"></td>
<td><strong>OpenBSD-src</strong></td>
<td>- The <b>src</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-ports</strong></td>
<td>- The <b>ports</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-www</strong></td>
<td>- The <b>www</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-x11</strong></td>
<td>- The <b>x11</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-all</strong></td>
<td>- All OpenBSD repositories</td></tr>
</table>
</dd>
</dl>
<dl>
<dt><strong>cvsup.hu.OpenBSD.org</strong></dt>
<dd><p>
located in Hungary;
maintained by <a href="mailto:mohacsi@hera.ik.bme.hu">Mohacsi Janos</a>.<br />
Updated every 4 hours.
</p>
<p>
Available collections:
</p>
<table>
<tr><td width="20"></td>
<td><strong>OpenBSD-src</strong></td>
<td>- The <b>src</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-ports</strong></td>
<td>- The <b>ports</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-www</strong></td>
<td>- The <b>www</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-x11</strong></td>
<td>- The <b>x11</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-all</strong></td>
<td>- All OpenBSD repositories</td></tr>
</table>
</dd>
</dl>
<dl>
<dt><strong>cvs.bsdfr.org</strong></dt>
<dd><p>
located in France;
maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.<br />
Updated every 12 hours.
</p>
<p>
Available collections:
</p>
<table>
<tr><td width="20"></td>
<td><strong>OpenBSD-src</strong></td>
<td>- The <b>src</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-ports</strong></td>
<td>- The <b>ports</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-www</strong></td>
<td>- The <b>www</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-all</strong></td>
<td>- All OpenBSD repositories</td></tr>
</table>
</dd>
</dl>
<dl>
<dt><strong>sanmateo.ecn.purdue.edu</strong></dt>
<dd><p>
located in West Lafayette, IN, USA;
maintained by <a href="mailto:will@csociety.ecn.purdue.edu">Will Andrews</a>.<br />
Updated every 2 hours.
</p>
<p>
Available collections:
</p>
<table>
<tr><td width="20"></td>
<td><strong>OpenBSD-src</strong></td>
<td>- The <b>src</b> repository</td>
<tr><td></td>
<td><strong>OpenBSD-ports</strong></td>
<td>- The <b>ports</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-www</strong></td>
<td>- The <b>www</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-x11</strong></td>
<td>- The <b>x11</b> repository</td></tr>
<tr><td></td>
<td><strong>OpenBSD-all</strong></td>
<td>- All OpenBSD repositories</td></tr>
</table>
</dd>
</dl>
<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>
</p>
<p>
You may want to use "traceroute" 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 6, 2000), the CVS repository sizes are
</p>
<table>
<tr><td width="20"></td>
<td><strong>ports</strong></td>
<td>- <b>41</b>MB</td></tr>
<tr><td></td>
<td><strong>src</strong></td>
<td>- <b>689</b>MB</td></tr>
<tr><td></td>
<td><strong>www</strong></td>
<td>- <b>34</b>MB</td></tr>
<tr><td></td>
<td><strong>x11</strong></td>
<td>- <b>193</b>MB</td></tr>
</table>
<p>
There is an additional overhead of <b>33</b>MB for the CVSROOT and sup
directories. The overall repository size currently increases at a rate
of about <b>170</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://insight.mcmaster.ca/org/efc/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 an
AnonCVS server located in the USA. The files in question are...
</p>
<ul>
<li><tt>src/kerberosIV/*</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/netinet</tt></li>
<li><tt>src/usr.sbin/afs/src/rxkad/*</tt></li>
<li><tt>X11/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 CVSup servers -- if you are
interested, please contact <a href="mailto:brian@OpenBSD.org">Brian Somers</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: cvsup.html,v 1.15 2000/12/06 22:32:35 brian Exp $</small>
</body>
</html>
![[BACK]](/icons/back.gif){kind=icon}
Return to cvsup.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / www