CVSYNCD(1) BSD General Commands Manual CVSYNCD(1)NAMEcvsyncd — synchronize CVS repositories
SYNOPSIScvsyncd [-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 initial‐
izes.
-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 FILEcvsyncd uses a configuration file which specifies collections to distrib‐
ute 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 key‐
word ‘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 key‐
word ‘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 avail‐
able 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 for‐
mat 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 abso‐
lute 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 ALSOcvscan(1), cvsup2cvsync(1), cvsync(1), cvsync2cvsup(1), fnmatch(3)BSD Jun 23, 2005 BSD