NAME
cvsd.conf - configuration file for cvsd.
DESCRIPTION
The file cvsd.conf contains the configuration information for running
‘cvsd’ (see cvsd(8) ). The file contains options, one on each line,
specifying the workings of cvsd.
OPTIONS
RootJail path
This specifies the location of the chroot jail cvs should be run
in. This directory should be initialized with the
cvsd-buildroot script so it contains all the proper directories
and binaries. If this option is not present in the
configuration file or a value of ‘none’ (without quotes) is
specified cvsd will run in the normal file system root.
Uid uid
This specifies which user id cvs should be run as. This can be
a numerical id or a symbolic value. If no uid is specified cvsd
will run under the uid it is started with.
Gid gid
This specifies which group id cvs should be run as. This can be
a numerical id or a symbolic value. If no gid is specified cvsd
will run under the gid it is started with.
CvsCommand path
This should be set to the location where the cvs command is
located. Note that if you set up a RootJail this is relative to
that directory, but should still start with a ‘/’. If you do
not define this a default of ‘/bin/cvs’ will be used if a chroot
jail has been configured and otherwise it will be set
‘/usr/bin/cvs’.
CvsArgs arg...
Additional arguments to be passed to the cvs command, in
addition to the default ones. You can pass the -R option to put
cvs in read-only mode. Note that not all options can be used in
pserver mode and error messages are not always very friendly.
Nice num
This specifies the nice value (on most systems ranging from -20
to 20) where the smaller the number (more negative) the higher
the priority. If no value is specified the nice level of the
program will not be altered.
Umask mask
This specifies a umask used by the cvs pserver when creating
files. Specify as an octal value. If no value is specified the
default umask of 027 will be used.
Limit resource value
Limits use of a certain resource to the cvs process. Note that
resource limits will be set on the executed cvs command and not
for the daemon. Resource may be one of:
coredumpsize
maixmum filesize of a coredump
cputime
maximum amount of seconds cputime consumed
datasize
maximum size of program’s data segment
filesize
maximum size of files created
memorylocked
maximum amount of locked memory
openfiles
maximum number of open files (file descriptors)
maxproc
maximam number of processes (per user? max. children?)
memoryuse
maximum size of resident memory
stacksize
maximum stack size
virtmem
maximum amount of virtual memory allocated
pthreads
number of threads that the process may create
Note that not all systems may support all resources specified
here. If no limits are defined no extra limits will be
enforced. If the system already specified limits for processes
it may not be possible to broaden the limits.
A value (resource limit) that is a size can be specified with a
suffix of ‘b’ (bytes), ‘k’ (1024 bytes) or ‘m’ (1024*1024
bytes), where ‘k’ is default.
Plain number values can also have the ‘k’ and ‘m’ suffixes, but
the default is just the plain number.
Time values can be formatted as ‘mm:ss’ or have a ‘m’ or ‘s’
suffix where ‘s’ is default.
PidFile file
This specifies the location the process id of the daemon is
written. If no PidFile is specified the pid will not be
written. /var/run/cvsd.pid is a good location for a pidfile.
Listen address port
This options specifies which addresses and ports cvsd should
listen on for connections. The address value can be ‘*’ (for
binding all addresses) or a symbolic (host name), dotted quad or
ipv6 address. The port value can be a numeric port number or a
well known service (‘cvspserver’). This option can be supplied
multiple times. The address and port fields can be combined in
the usual ways by separating them with a ‘:’ or a ‘.’,
optionally surrounding the address part by square brackets (‘[’
and ‘]’).
Some examples:
# listen on all interfaces and all protocols on port 2401
Listen * 2401
# listen on IPv6 port 100
Listen :: 100
# listen on localhost
Listen localhost cvspserver
# listen on an ipv6 address
Listen [fe80::2a0:d2ff:fea5:e9f5]:2401
MaxConnections num
This specifies the maximum number of connections that can be
handled simultaneously. When the value 0 (the default) is
supplied no limit is used.
Log scheme/file logvelel
This option specifies the way logging is done. As first
argument either none, syslog or a file name beginning with a ‘/’
may be specified. The second argument is optional and specifies
the loglevel. The loglevel may be one of: crit, error, warning,
notice, info (default) or debug. All messages with the
specified loglevel and higher are logged. This option can be
supplied multiple times. If this option is omitted syslog info
is assumed.
Repos path
This option specifies which repositories can be used. The value
is passed as a --allow-root=path parameter to cvs. The path
should be relative to the specified RootJail and should start
with a ‘/’. This option can be supplied multiple times, but
should be specified at least once.
FILES
/etc/cvsd/cvsd.conf - default location for the configuration file
/var/run/cvsd.pid (or other localtion) - the file where the process id
is saved
SEE ALSO
cvsd(8)
AUTHOR
Arthur de Jong <arthur@arthurdejong.org>.