DragonFly On-Line Manual Pages
CVSYNCD(1) DragonFly General Commands 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)
DragonFly 6.5-DEVELOPMENT June 23, 2005 DragonFly 6.5-DEVELOPMENT