NAME

cvsyncd — synchronize CVS repositories

SYNOPSIS

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)