OpenBSD

CVS Access:

CVS is used to manage the OpenBSD source tree. This allows developers to work on a local source tree and commit their changes when ready. Also anyone can edit source files on their local machines, and automatically track and merge in any changes made in the OpenBSD CVS repository. Additionally they can easily see the logs of, check out, or "diff" the source files in the OpenBSD source tree.

Most importantly, the anoncvs service does NOT delete the changes you make in your local copy of the source tree -- read on for more details!

The latest version of CVS is available at Cyclic. Versions earlier than 1.6 are not recommended, and may not work. If you already have OpenBSD installed, CVS is included.

There are two levels of source tree access:

Read-write access for developers:
Developers who need to commit changes to the source tree must have an account on the OpenBSD machines. Getting this access will be a natural result of working on the sources with other OpenBSD developers. If someone does some good work and shows they can work with the team, they will get an account.
Read-only access for everyone:
Anyone can access the read-only CVS repositories. These copies of the read-write CVS repository are mirrored often. To use one, set your CVSROOT environment variable to one of the following values:

You may want to use `traceroute' to find out which server is nearest you.

IMPORTANT NOTE: There are a few issues relating to cryptographic software that everyone should be aware of:

A sample use of an anoncvs CVS server would be:

% setenv CVSROOT anoncvs@anoncvs.usa.openbsd.org:/cvs
% cd /tmp
% cvs get src/sys/arch/sparc
[copies the files from the repository to your machine]
% cvs log src/sys/arch/sparc/sparc/locore.s
[shows the commit log for the chosen file ]
% cvs diff -bc -r1.1 -r1.5 src/sys/arch/sparc/sparc/locore.s
[shows the changes between revisions 1.1 and rev 1.5]

Here is how someone using anoncvs regularily would update his source tree:

# setenv CVSROOT anoncvs@anoncvs.usa.openbsd.org:/cvs
# cd /usr
# cvs -q get -PA src
or similarily later on he might try
# cd /usr/src
# cvs -q up -PAd
Everytime you ran this it would syncronize your /usr/src tree. It would not destroy any of your local changes, rather it would attempt to merge changes in. If you use obj directories (not obj symbolic links) you may wish to append "-I obj" to the cvs command line, this will keep cvs from spitting out a warning about all the obj directories it is going to encounter which are not in the repository.

The CVS man page (included with the CVS sources) has much more information about how CVS can be used.

The anoncvs service gives fledgling developers a chance to learn CVS operation and get thoroughly involved in the development process before getting "commit" access -- as a result of showing useful skills and high quality results they will naturally later be given developer access. As well, people providing patches can create their "diff"s relative to the CVS tree, which will ease integration.

The CVS client uses rsh to talk to the CVS server. If some local security measure like a firewall (or imperfect protocol emulators like slirp) prevents you from using rsh, you may be able to use ssh instead. In this case, one sets the environment variable CVS_RSH to point to ssh (typically /usr/local/bin/ssh). To reduce the performance hit the anoncvs server would take it is recommended (and requested) that you disable encryption. If your local site prevents you from connecting out to port 22 (which ssh defaults to using) use port 2022.

Do not be tempted to turn on compression since CVS already compresses. Use something like the following in your $HOME/.ssh/config file.

	Host anoncvs.usa.openbsd.org
	    Cipher none
	    Port 2022

CVS is a little noisy starting up; to quiet it a bit you may want to do this:

setenv CVS_CLIENT_PORT -1

If you wish to be a new anoncvs mirror site, please contact the anoncvs maintainer. Anoncvs mirrors require about 300MB of disk, and use up to 4MB of swap per anoncvs user (assuming the user does a large operation; while smaller operations use fewer resources, anoncvs still makes much more of an impact than ftp or sup). Such anoncvs machines should have excellent network connectivity for the area they are expected to serve. A document which describes the setup of anoncvs servers is available.


OpenBSD www@openbsd.org
$OpenBSD: anoncvs.html,v 1.4 1996/09/25 05:28:38 deraadt Exp $