Plug-in Documentation

CVS

Overview

Overview

This plugin allows the checking out/exporting of code from CVS so that it can then build the code. It can also create CVS branches.

Compatibility

The steps in this plug-in run on all supported platforms.

Installation

No special steps are required for installation. See Installing plug-ins in UrbanCode Build.

Steps

Process steps in the CVS plug-in

CVS Changelog

Perform a CVS changelog and publish the results.

Input properties for the
CVS Changelog step
Name Type Description Required
Changes URL String No
Command Flags String Optional command line arguments No
End Date String End changelog at this date (yyyy-MM-dd HH:mm:ss z OR
E MMM dd HH:mm:ss zzz yyyy OR milliseconds since Unix Epoch)
No
Global Flags String Options global flags. Ex: -z7 No
Source Config No
Start Date String Start changelog at this date (yyyy-MM-dd HH:mm:ss z OR
E MMM dd HH:mm:ss zzz yyyy OR milliseconds since Unix Epoch)
No

CVS Checkout

Perform a CVS checkout, export, or workspace update

Input properties for the
CVS Checkout step
Name Type Description Required
Clean Workspace Boolean Clean the workspace before performing the checkout No
Command Flags String Optional command line arguments No
Date String String Specify a date that will be used to populate the workspace.
Format is: yyyy-MM-dd HH:mm:ss z. You can use a script here.
No
Do Export Boolean Perform a CVS export instead of a checkout No
Global Flags String Options global flags. Ex: -z7 No
Source Config No
Update Workspace Boolean Update the current workspace No

CVS Cleanup

Perform a cleanup of the subversion working directory

Input properties for the
CVS Cleanup step
Name Type Description Required
Source Config No

CVS Quiet Period

Perform a Subversion changelog for quiet period detection and publish the results.

Input properties for the
CVS Quiet Period step
Name Type Description Required
Command Flags String Optional command line arguments No
End Date String End changelog at this date (yyyy-MM-dd HH:mm:ss z OR
E MMM dd HH:mm:ss zzz yyyy OR milliseconds since Unix Epoch)
No
Global Flags String Options global flags. Ex: -z7 No
Source Config No
Start Date String Start changelog at this date (yyyy-MM-dd HH:mm:ss z OR
E MMM dd HH:mm:ss zzz yyyy OR milliseconds since Unix Epoch)
No

CVS Tag

Create a branch or tag in CVS

Input properties for the
CVS Tag step
Name Type Description Required
Branch Boolean Check if you want to make this tag a branch tag No
Command Flags String Optional command line arguments No
Global Flags String Options global flags. Ex: -z7 No
Source Config No
Tag String The name of the tag you are creating No

Roles in the CVS plug-in

The plug-in adds these roles automatically to resources. You cannot add these roles
manually.

CVS Repository

A CVS repository configuration.

Properties for the
CVS Repository role
Name Type Description
CVS Password Password The password for the user identified in the CVSROOT
CVS Password Script String Use a parameterized value that will resolve to the password.
Use this if the CVS password will be stored in a secure property.
CVSNT Boolean Select here if you are using a CVSNT repository
CVSROOT String The CVSROOT of the repository
CVS_RSH String The remote shell that should be used to connect to the repository
Command Path String The location of the CVS command if not on the system PATH
Date Format String The date format to use when parsing changelogs. The default
is yyyy/MM/dd HH:mm:ss. Newer versions of CVS use yyyy-MM-dd HH:mm:ss
Use in CVSROOT Boolean Select to add the password in the CVSROOT. The password will
be hidden in all log files. This is a workaround if CVS is unable to read
the .cvspass file in certain scenarios. This is required if using CVSNT

CVS Source Config

Properties for the
CVS Source Config role
Name Type Description
Branch String The name of the CVS branch to be retrieved
Directory Offset String The sub-directory where this module will be placed within the
working directory. Leaving this blank will assume the default CVS behavior
which is to create a directory with the module name in the working directory.
Use a . to override the default behavior and check out to the current
working directory.
Exclude Filters String Exclude this list of usernames
File Filters String Restrict changelog to files matching these patterns. Lines start with + to include
and to exclude. Wildcards *, **, and ? are allowed.
Local Folder Only Boolean Only get the files in the specified folder. Select to not
check out recursively.
Module Name String The name of the module to be retrieved.
Prune Empty Dirs Boolean Prune empty directories
Repository The repository to use
Tag String The tag/label to use for checkout. This may include variables
passed to the workflow via $(property:Name} format.