DragonFly On-Line Manual Pages

Search: Section:  


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

Search: Section: