NAME
  cvsupadm -- (D)CVSup administration support of DCVS and DCCS

SYNOPSIS
  cvsupadm <options> <cmd> <subcmd> <arg>*

OPTIONS
    -b <base directory>            // absolute pathname
    -c <collection directory>      // relative pathname
    -m <dcvs configuration file>   // dcvs configuration filename
    -f                             // force action
    -o <output file name>          // define output file  (-  for
stdout)
    -d                             // debug

DESCRIPTION
  cvsupadm offers the following commands and subcommands:

  <cmd> <subcmd>:
    create  cvscoll <collection id> <repository path> <collection
path>
      Create a standard (D)CVS collection description suitable to
      replicate a (D)CVS module between repository servers.
      If  -f  is specified, overwrite existing specifications; if
not,
      do not touch them.

    create dcvscoll
      Create standard DCVS collection descriptions for  all  col-
lections
      specified in the DCVS configuration file.
      If  a  default collection declaration is found, create col-
lections
      for all top-level DCVS modules in the repository.
      If -f is specified, overwrite existing  specifications;  if
not,
      do not touch them.

    create dcvsupfiles | create supfiles
      Create default cvsupfiles for use in a DCVS network setup
      based on information from the dcvs configuration file.
      If  a  default collection declaration is found, add collec-
tions
      for all top-level DCVS modules in the specified repository.
      Settings  for  the local host will be commented out. If the
option
      -o is not given, dcvsupfile will be used as the base of the
output
      filename.  The  server id will be added as a suffix to this
name.
      To list the generated text on standard output, use -o -.

    edit coll <collection id>
      Edit the releases and list files of an existing collection.
      Use the environment variables VISUAL and EDITOR; default to
vi.

    edit dcvs
      Edit the DCVS configuration file.
      Use the environment variables VISUAL and EDITOR; default to
vi.

    lock repo <collection id>+
      Lock the repository in which the named DCVS collections are
located,
      so that user changes via DCVS are disabled.  As  the  locks
only hold
      while  the  process exists, the shell given by the environ-
ment
      variable SHELL is executed; the  locks  are  removed  after
termination.

    lock all
      Lock all DCVS repositories, so that no user changes via
      DCVS are possible. As the locks only hold while the process
      exists, the shell given by the environment  variable  SHELL
is
      executed; the locks are removed after termination.

FILES
  Unless  overriden with -b, the default server base directory is
searched at

    /usr/local/dcvs/etc/dcvsup
    /var/lib/dcvsup
    /var/db/dcvsup

  in this order. The first existing directory is used.

  Unless overriden with -c, the default collection directory is

    sup

  Unless overriden, the default DCVS configuration is searched at

    <server base>/dcvsupd.servers
    <server base>/dcvs_config
    /etc/dcvs_config
    /etc/dcvs/dcvs_config
    /usr/local/etc/dcvs_config
    /usr/local/etc/dcvs/dcvs_config
    /opt/etc/dcvs_config
    /usr/local/etc/dcvsup/dcvsupd.servers
    /usr/etc/dcvsup/dcvsupd.servers
    /opt/etc/dcvsup/dcvsupd.servers

ENVIRONMENT VARIABLES
  DCVS_CONFIG  overrides  the  location of the DCVS configuration
file
  from the process environment.

SEE ALSO
  dcvsupd(8), dcvsup(1)
  http://www.elegosoft.com/dcvs

AUTHORS
  cvsupadm was written by Olaf Wagner as part of the DCVS project
of
  elego  Software  Solutions  GmbH.  It  is also part of the DCCS
project,
  which includes DCVS.