bionic (5) cvsd.conf.5.gz

Provided by: cvsd_1.0.24_amd64 bug

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>.