What is CVS?

CVS (Concurrent Versions System) is a Source Code Management (SCM), a tool for software developers which supports collaborative development of software within a team, and the tracking of changes to software source code over time.

CVS is used by developers, and advanced users who need the very latest changes to the software (before releases occur). Software users generally do not need CVS; typically they will download official file releases made available by the project instead.

Developers should familiarize themselves with CVS by reading Open Source Development with CVS, 3rd Edition and the Ximbiot - CVS Wiki.

Features

SourceForge.net provides the following features in its CVS offering:

• All standard features of CVS 1.11.x are supported.

FIXME - need a better link for CVS Features

• Developer (read-write) access is provided via CVS over SSH.
• Anonymous (read-only) access is provided via CVS pserver.
• A number of CVS clients are supported, including:
  • TortoiseCVS (MS Windows), which can be used in conjunction with PuTTY
  • The official CVS client (Mac OS X, Linux, BSD), which can be used in conjunction with OpenSSH
  • CVSNT? (MS Windows)
  • Cygwin CVS? (MS Windows)
  • WinCvs (MS Windows), which can be used in conjunction with PuTTY.
  • MacCvs? (OS X)
• Repositories may be viewed via web browser via ViewVC.
• Commit notifications may be made by email using CVS syncmail.
• Pre-commit and post-commit scripts are supported in several languages.
• Permissions may be managed as follows:
  • Repository access may be granted or revoked from a developer using the Project Admin interface.
  • Fine-grained access controls may be implemented using cvs_acls.
• Administrators may manage the repository at a filesystem level using our Interactive shell service.
• Existing repositories may be imported using our Interactive shell service.
• Repository backups and mirroring may be performed using rsync.
• Commit and checkout events are counted in the statistics system.
• Service usage is not restricted by quotas.

Management

Enabling CVS repository

CVS service may be enabled for your project as follows:

1. Login as a project administrator and go to the Project Summary page for your project.
2. Select the CVS option under the Admin menu.
3. Under the "Enable CVS" heading, check the "The following box should be checked to enable CVS" checkbox and click the Update button. Your repository will be created within a few minutes.

Authentication

No username and password will be requested when performing read operations.

When performing write operations, you will be prompted for your SourceForge.net username and password. To perform write operations, your project administrator must have granted you write access to the repository.

Access

The standard way to modify the contents of your repository is using a CVS client. CVS admins may also directly modify the repository contents via the interactive shell service.

• The adminrepo command line tool is used to manage CVS repositories; see adminrepo --help from within a project shell for more information on how to use adminrepo.

ViewVC

Project CVS repositories can be browsed via the ViewVC web interface (replace PROJECTNAME with the UNIX group name of the project):

• http://PROJECTNAME.cvs.sourceforge.net/PROJECTNAME/

Backups

SourceForge.net performs routine backups for all of our servers and will restore from these backups in the event of catastrophic server failure. We encourage projects to make their own backups of CVS data as that data restore can be performed by the project in the event of accidental data destruction by a member of the project team.

Backups of a CVS repository may be made using rsync.

Example (replace PROJECTNAME with the UNIX group name of your project):

rsync -av rsync://PROJECTNAME.cvs.sourceforge.net/cvsroot/PROJECTNAME/* .

Getting Help

• Support
• Request an enhancement

EXPANDME

Follow the flow of the Subversion doc. Use subpages for each feature line item.