|
|
| |
CVSYNCD(1) |
FreeBSD General Commands Manual |
CVSYNCD(1) |
cvsyncd —
synchronize CVS repositories
cvsyncd |
[-Vfhqv ] [-c
file] [-g
group] [-l
file] [-p
file] [-u
user] [-w
directory] [-z
level] |
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.
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 ’.
The cvsyncd utility exits EXIT_SUCCESS on success, and
EXIT_FAILURE if an error occurs.
Visit the GSP FreeBSD Man Page Interface. Output converted with ManDoc. |