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, and a server program cvsyncd, and a supplemental tool cvscan and cvsup2cvsync.

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 /opt/local/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. ‘sha1’ and any other types are optional. The default value is ‘sha1’ if available, otherwise ‘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)