www/cvsup.html - diff

Return to cvsup.html CVS log

Up to [local] / www

Diff for /www/Attic/cvsup.html between version 1.73 and 1.74

version 1.73, 2004/01/06 02:26:15

version 1.74, 2004/02/09 08:55:32

Line 1

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

"http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<title>OpenBSD CVSup</title>

</head>

<a href="index.html"><img alt="[OpenBSD]" height="30" width="141"

src="images/smalltitle.gif" border="0"></a>

<h2>CVSup</h2>

<hr>

Line 37

Line 40

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.

CVSup uses the so-called pull model of updating. Under the pull

Line 47

Line 49

unsolicited updates. Users must either run the CVSup 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.

The term CVSup, 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.

CVSup is intended to be both faster and more flexible than

<a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sup&sektion=1&format=html">sup(1)</a>, CVSup's predecessor.

The OpenBSD Project currently has five main source repositories:

<ul>

<li>src - Houses all source code for the OpenBSD Operating System.</li>

Line 84

Line 82

CVS can be used for remote file access, it is not optimized for

wholesale source tree distribution over the net, and CVSup can be

easily an order of magnitude more efficient for this task.

<h3>

<a name="starting">Getting Started Using CVSup</a>

Line 100

Line 97

sites</a> instead of building your own from the <tt>net/cvsup</tt>

port. Currently the OpenBSD ports of Ezm3 and consequently CVSup

are only available on the i386 platform.

For further information about CVSup, see the author's

<a href="http://www.polstra.com/projects/freeware/CVSup/">project

homepage</a>.

In order to mirror the OpenBSD repository with CVSup,

the following configuration file might be used:

<pre>

# Defaults that apply to all the collections

Line 137

Line 131

This directs cvsup to refresh all OpenBSD distributions from

cvsup.uk.openbsd.org 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.

Assuming this file is saved as <tt>cvs-supfile</tt>, the

following command would be used to invoke the cvsup GUI:

<pre>

cvsup cvs-supfile

</pre>

whereas for batch mode, the following might be used:

<pre>

cvsup -g -L 2 cvs-supfile

</pre>

Line 160

Line 151

It is now simple to check out any one of the CVSup'ed repositories.

For Korn/Bourne shells:

<pre>

# cd /usr

# CVSROOT=/cvs cvs checkout src

</pre>

For csh and its derivatives:

<pre>

# cd /usr

# setenv CVSROOT /cvs

Line 179

Line 168

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:

<pre>

# cd /usr

# cvs checkout -rOPENBSD_2_9 src

</pre>

Or <tt>OPENBSD_2_8</tt> for 2.8, etc.

<h3><a name="checkout">Running CVSup in

Checkout Mode</a></h3>

Line 198

Line 185

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

The following supfile could be used to update your ports tree:

<pre>

# Defaults that apply to all the collections

*default host=cvsup.uk.openbsd.org

Line 219

Line 204

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.

Alternatively, use the keyword <tt>date=[cc.]yy.mm.dd.hh.mm.ss</tt>

to select a revision by date. All 17 or 20 characters must be

Line 227

Line 211

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

<h3>

<a name="CVSROOT">Available CVSup Servers</a>

</h3>

The following CVSup servers are available:

The following CVSup servers are available:

<dl>

<dt><a href="http://cvsup.uk.openbsd.org">cvsup.uk.openbsd.org</a></dt>

Line 242

Line 225

located in Brighton, UK;

maintained by <a href="mailto:brian@openbsd.org">Brian Somers</a>.

Updated every 2 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 275

Line 256

located near Frankfurt am Main, Germany;

maintained by <a href="mailto:wosch@FreeBSD.org">Wolfram Schneider</a>.

Updated every 12 hours from cvsup.uk.openbsd.org.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 305

Line 284

located in Munich, Germany;

maintained by <a href="mailto:dl@leo.org">Daniel Lang</a>.

Updated every 24 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 338

Line 315

located in Hungary;

maintained by <a href="mailto:mohacsi@hera.ik.bme.hu">Mohacsi Janos</a>.

Updated every 4 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 368

Line 343

located in France;

maintained by <a href="mailto:jch@oleane.net">Jean-Claude Christophe</a>.

Updated every 12 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 395

Line 368

located in West Lafayette, Indiana, USA;

maintained by <a href="mailto:will@csociety.ecn.purdue.edu">Will Andrews</a>.

Updated every 2 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 428

Line 399

located in Seoul, Korea;

maintained by <a href="mailto:redjade@atropos.snu.ac.kr">Kim Kyung-Hwan</a>.

Updated every 2 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 461

Line 430

located in Oslo, Norway;

maintained by <a href="mailto:anders@fix.no">Anders Nordby</a>.

Updated every 3 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 494

Line 461

located at the University of Coimbra, Portugal;

maintained by <a href="mailto:jpedras@webvolution.net">João Pedras</a>.

Updated every 3 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 528

Line 493

located at the University of Kaiserslautern, Germany;

maintained by <a href="mailto:naddy@openbsd.org">Christian Weisgerber</a>.

Updated every 6 hours from anoncvs.usa.openbsd.org.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 561

Line 524

located at Lake in the Hills, Illinois, USA;

maintained by <a href="mailto:jcs@rt.fm">Joshua Stein</a>.

Updated every 2 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 594

Line 555

located in St. Petersburg State University, St. Petersburg, Russia;

maintained by <a href="mailto:kab00m@lich.phys.spbu.ru">Dima Veselov</a>.

Updated every 4 hours.

Available collections:

<table>

<td>OpenBSD-ports</td>

Line 612

Line 571

located at Otemachi, Tokyo, Japan;

maintained by <a href="mailto:cvsupadm@openbsd.bsdlab.org">CVSup Administrator</a>.

Updated every 3 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 645

Line 602

located at National Chiao-Tung University, Taiwan;

maintained by <a href="mailto:ijliao@FreeBSD.org">Ying-Chieh Liao</a>.

Updated every 2 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 678

Line 633

located in Sydney Australia;

maintained by <a href="mailto:gbayley@ausmac.net">Grant Bayley</a>.

Updated every 6 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 711

Line 664

located in Germany

maintained by <a href="mailto:aw@osn.de">Armin Wolfermann</a>.

Updated every 4 hours.

Available collections:

<table>

<td>OpenBSD-src</td>

Line 744

Line 695

located at the University of Erlangen, Germany;

maintained by <a href="mailto:Alexander.Gernler@informatik.stud.uni-erlangen.de">Alexander von Gernler</a>.

Updated every 2 hours from cvsup.uk.openbsd.org

Available collections:

<table>

<td>OpenBSD-src</td>

Line 776

Line 725

unknown information, please contact <a

href="mailto:beck@openbsd.org"><tt>beck@openbsd.org</tt></a>

or <a href="mailto:brian@openbsd.org"><tt>brian@openbsd.org</tt></a>

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 maintainer of the

server in question.

Currently (as of April 7, 2003), the CVS repository sizes are

<table>

<td>OpenBSD-ports</td>

Line 807

Line 753

There is an additional overhead of 41MB for the CVSROOT

directory. The overall repository size currently increases at a rate

of about 225MB per annum.

IMPORTANT NOTE:

There are a few issues relating to cryptographic software that everyone

should be aware of:

<ul>

<li>

Line 822

Line 766

described in the Export Control list of Canada</a>,

it is legal to export crypto software from Canada to the world.

</li>

<li>

However, if you are outside the USA or Canada, you should not

fetch the cryptographic sections of the OpenBSD sources from a

CVSup server located in the USA. The files in question are...

<ul>

<li><tt>src/kerberosIV/*</tt></li>

<li><tt>src/kerberosV/*</tt></li>

Line 846

Line 788

Because of the USA ITAR munitions list,

crypto software may only be exported to Canada from the USA.

</li>

</ul>

Line 854

Line 795

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.

<hr>