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)