CVSYNCD(1)              NetBSD 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 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 FILE
     cvsyncd 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 ALSO
     cvscan(1), cvsup2cvsync(1), cvsync(1), cvsync2cvsup(1), fnmatch(3)

NetBSD 2.0                       Jun 23, 2005                       NetBSD 2.0