##### Search CVSGrab

## Ant usage for cvsgrab task

Reads a CVS repository via its ViewCVS web interface, thus avoiding any firewall problems.

Install the cvsgrab task in Ant by using the following:

<property name="cvsgrab.dir" value="[Your CVSgrab installation directory]" />
<taskdef name="cvsgrab" classname="net.sourceforge.cvsgrab.CVSGrabTask" classpath="${cvsgrab.dir}/lib/cvsgrab.jar"/>

## Parameters

Attribute | Description | Required
--- | --- | ---
url | The url for the ViewCVS repository, copy&pasted from the browser url bar. Example: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/cvsgrab/?only_with_tag=RELEASE_2_2 | If rootUrl and packagePath are omitted.
rootUrl | The root url for the ViewCVS repository. Example: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/ | If url is omitted.
packagePath | The path relative to rootUrl of the package or module to download Example: hotsax/HotSAX | If url is omitted.
projectRoot | The project root, for cvs with multiple repositories. Example: ProjectTools | No.
tag | The version tag of the files to download. Example: BRANCH_3_0 | No.
webInterface | The id for the web interface for the CVS repository to use. If this option is not set, autodetect the web interface. Example: ViewCvs0_9 Call cvsgrab -listWebInterfaces to get a list of valid values for this option. | No.
destDir | The destination directory for the files retrieved from CVS. Default is the current directory | No.
packageDir | The name of the package to use locally, relative to destDir, overrides packagePath Example: HotSAX | No.
cvsRoot | The original cvs root, used to maintain compatibility with a standard CVS client. Example: :pserser:anonymous@cvs.apache.org:/cvsroot/public | No.
pruneEmptyDirs | Prune (remove) the empty directories. Default is false | No.
cleanUpdate | Performs a clean update. Locally modified files are backed-up, and the latest version of the file is downloaded. Default is false | No.
verbose | Verbosity. Default is not verbose. Values are true or false | No.
connections | The number of simultaneous connections to open for downloads. Default is 1 | No.

## Nested Elements

### proxy

Optional. To configure how to use a proxy if you are behind a firewall that uses proxies.
Usually, it solves the 404 and 407 errors you may encounter.

Attribute | Description | Required
--- | --- | ---
host | The host name for the proxy | Yes.
port | The port of the proxy. | Yes.
ntdomain | The NT domain for authentification on MS proxy. | No.
username | The username used to login in the proxy. | No.
password | The password used to login in the proxy. If this option is omitted, then cvsgrab will prompt securely for the password. | No.

### web

Optional. To configure authentification on the web server that hosts the cvs web interface.

Attribute | Description | Required
--- | --- | ---
username | The username used to login in the web server. | No.
password | The password used to login in the web server. If this option is omitted, then cvsgrab will prompt securely for the password. | No.