XORP CVS Access

Anonymous Access | Developer Access | Modules | Examples | Troubleshooting

What is CVS?

Concurrent Versions System (CVS) is a version control system that allows multiple developers to work on files at the same time. The software developed and modified on the XORP project is stored in a CVS repository. Anonymous access to the CVS repository is available to access the current code for the purpose of porting, patching, and testing the software.

The code in the CVS repository may be buggy or non-functional from time to time, so be prepared to encounter problems and report them. This is part of the purpose of making anonymous CVS access available.

Bug reports, code contributions, and comments for applications in the CVS repository should be sent to the appropriate mailing list. If no mailing list exists for that application, then use feedback@xorp.org.

We recommend the use of CVS version 1.9 and later. Links on CVS that may be of interest are:

Concurrent Versions System Home.
CVS Tutorial from Cal Poly.

Anonymous Access to the XORP CVS Repository

Anonymous CVS has read-only access to the repository.

The repository root (CVSROOT) is:
```
:pserver:xorpcvs@anoncvs.xorp.org:/cvs
```
The password for read-only access is empty.

If you see a warning message like this one, just ignore it:

cvs login: warning: failed to open /path/to/home/dir/.cvspass for reading:
No such file or directory

See examples for quick start information.

Anonymous CVS Mirrors

Name	Location
anoncvs1.xorp.org	SpriteLink,Sweden

Developer Access

The access method for developers with full priveleges is through SSH.

SSH Access

For SSH access to the XORP respository you will need an account on the XORP machines at ICIR.

Set environment variable CVS_RSH to ssh and CVSROOT to point to the XORP repository:

setenv CVS_RSH ssh
setenv CVSROOT :ext:<username>@cvs.xorp.org:/usr/local/www/data/cvs

Use ssh-agent to avoid re-typing your passphrase when CVS uses SSH to connect to the server:
- One time actions:
  1. Check if ~/.ssh/id_dsa.pub (or identity.pub in the case of SSH1) exists on local host. If not run ssh-keygen, pick hard to guess passphrase.
  2. Append the contents of ~/.ssh/id_dsa.pub (identity.pub SSH1) to ~/.ssh/authorized_keys2 (authorized_keys SSH1) on remote machine (e.g., the XORP cvs server).
- Login actions:
  1. Start X session or parent shell with ssh-agent, i.e.
```
 % ssh-agent xinit 
```
  2. Run ssh-add, typing passphrase when prompted; ssh-agent will now automatically handle password exchanges each time you connect to remote machine with ssh.

Modules

The repository contains XORP source code. The names and descriptions of the modules are listed in the table below.

module	description
`xorp`	The XORP source tree.
`data`	Optional data. E.g., some of it may be used by the XORP regression tests.
`other`	Utilities and tools found to be useful by the XORP developers.
`www`	The material for XORP WWW pages.
`specs`	RFCs and Internet Drafts.

Examples

UNIX

% setenv CVSROOT :pserver:xorpcvs@anoncvs.xorp.org:/cvs
% cvs login
Logging in to :pserver:xorpcvs@anoncvs.xorp.org:2401/cvs
CVS password: 
cvs login: warning: failed to open /path/to/home/dir/.cvspass for reading:
No such file or directory
% cvs checkout xorp
cvs checkout: Updating xorp
U xorp/.cvsignore
U xorp/BUGS
U xorp/BUILD_NOTES
...
% ls -F xorp
BUGS                    bootstrap*              libxipc/
BUILD_NOTES             cli/                    libxorp/
CVS/                    config/                 mfea/
ERRATA                  config.h.in             mibs/
LICENSE                 configure*              mld6igmp/
Makefile.am             configure.in            mrt/
Makefile.in             contrib/                ospfd/
MakefileRootCheck.am    devnotes/               pim/
MakefileRootCheck.in    docs/                   policy/
README                  etc/                    rib/
RELEASE_NOTES           fea/                    rip/
TODO                    fib2mrib/               rtrmgr/
VERSION                 libcomm/                static_routes/
acconfig.h              libfeaclient/           utils/
bgp/                    libproto/               xrl/

Troubleshooting

Any comments or problems with anonymous cvs access with XORP should be sent to feedback@xorp.org.