CVSync Command Manual


CVSYNCD(1)

NAME

cvsyncd — synchronize CVS repositories

SYNOPSIS

cvsyncd [-Vfhqv] [-c file] [-g group] [-l file] [-p file] [-u user] [-w directory] [-z level]

DESCRIPTION

cvsync is a fast, portable, IPv6 capable CVS repository synchronization utility. cvsync consists of a client program cvsync, a server program cvsyncd, a supplemental tool cvscan, cvsup2cvsync, and, cvsync2cvsup.

NOT YET

The following options are available:

-V

Print the version number of cvsyncd to standard error.

-c file

Specifies the file to store collections.

-f

Run in foreground mode.

-g group

Specifies the group the server should run as after it initializes.

-h

Print the default configuration file, the protocol number, the usage and the version number of cvsyncd to standard error.

-l file

Specifies the file to write the system log.

-p file

Specifies the file to store a pid number.

-q

Be silent mode.

-u user

Specifies the user the server should run as after it initializes.

-v

Be verbose mode.

-w directory

Specifies the prefix for -c and -p. If a path name given by -c or -p is the absolute path, this prefix is not appended to them.

-z level

Sets the compression level to level. The compression level must be between 0 and 9. 0 means no compression. 1 indicates the fastest, but less compression. 9 indicates the slowest, but best compression. The default value is 1.

CONFIGURATION FILE

cvsyncd uses a configuration file which specifies collections to distribute CVS repositories. Basically it is a free format plain text file whose keywords are separated by white space(s) and/or carriage return(s). Comments begin with `#' and extend to the end of the line.

The following options are available:

access file

NOT YET

It must be an absolute path. This keyword is valid in `config'.

base directory

Specifies a prefix used for relative pathnames in all of the keyword `distfile' and `scanfile'. It must be an absolute path. This keyword is valid in `config'.

base-prefix directory

Specifies a prefix used for relative pathnames in all of the keyword `prefix'. It must be an absolute path. This keyword is valid in `config'.

collection { ... }

NOT YET

comment string

Describes the information about the collection. This is available from the remote host by using the release type `list'. This keyword is valid in `collection'.

config { ... }

NOT YET

distfile file

NOT YET

It must be an absolute path. This keyword is valid in `collection'.

errormode mode

Specifies the behavior when any potential errors/conflicts are found in local distributions.

The following modes are available:

abort

Disconnect the client immediately.

fixup

Recover errors/conflicts and keep running.

ignore

Ignore any errors/conflicts.

The default value is `abort'. This keyword is valid in `collection'.

haltfile file

Specifies the file to exit gracefully. If this file is created or modified when a server is running, the server try to exit gracefully. The default value is /var/run/cvsyncd.HALT. This keyword is valid in `config'.

hash type

Specifies the hash type to validate the distributed files and deltas. `md5' shall be supported in any environments. `ripemd160', `sha1', `tiger192' and, any other types are optional. The default value is `md5'. This keyword is valid in `config'.

listen address

Specifies the listen address. This keyword is valid in `config'.

loose

Obsoleted. Same to set `errormode' to `ignore'.

maxclients number

Specifies the maximum of connections from the remote hosts. The default value is 16. This keyword is valid in `config'.

nofollow

Doesn't follow a symbolic link and handle it as is. By default, cvsyncd follows a symbolic link. This keyword is valid in `collection'.

pidfile file

Specifies the file to store a pid number. It must be an absolute path. This keyword is valid in `config'.

port number

Specifies the listen port number. The default value is 7777. This keyword is valid in `config'.

prefix directory

Specifies the directory where the distribution files are stored. This keyword is valid in `collection'.

release type

Specifies a type of collections which are distributed from the server. When most of files in a collection have a specific format such as rcsfile(5), cvsyncd can use optimized algorithms to transfer such files. However, it needs that `release type' is specified properly.

Using `release type', you can specify transfer a file tree itself in a collection or a partial information of the tree such as a specific revision in rcsfile(5). This is the reason why cvsyncd does not decide the collection type automatically.

The following types are available:

rcs

NOT YET

This keyword is valid in `collection'.

scanfile file

Specifies the scanfile that the information about a directory structure is stored. When a scanfile is specified, cvsyncd does not scan a directory structure and use the information from the scanfile instead. This allows to reduce disk i/o load radically. This file must be generated by using cvscan. It must be an absolute path. This keyword is valid in `collection'.

super name

NOT YET

umask number

Forces cvsyncd to use a umask value of number. The default value is 022. This keyword is valid in `collection'.

EXIT STATUS

The cvsyncd utility exits EXIT_SUCCESS on success, and EXIT_FAILURE if an error occurs.

SEE ALSO

cvscan(1), cvsup2cvsync(1), cvsync(1), cvsync2cvsup(1), fnmatch(3)

Jun 23, 2005


Top