DragonFly On-Line Manual Pages

qconfirm-cdb-update(1)                       DragonFly General Commands Manual

NAME
       qconfirm-cdb-update - maintain a constant database for the use with
       qconfirm-cdb-check(1)

SYNOPSIS
       qconfirm-cdb-update [-vrf] [-c cdb] [-t sec] [-m min] [-l limit] [-s
       state]

DESCRIPTION
       qconfirm-cdb-check conditionally transfers known envelope sender
       address ids from the qconfirm directory into the constant database cdb.

       By default, qconfirm-cdb-update scans the directory ~/.qconfirm/ok for
       empty files created by qconfirm-check(1).  It ignores file names
       starting with a dot, and files without the user's write permission set.
       If qconfirm-cdb-update finds a minimum number of new files, it adds the
       corresponding ids to the constant database ~/.qconfirm/ok.cdb, and
       removes the files.

       While manipulating ~/.qconfirm/ok.cdb, qconfirm-cdb-update removes ids
       with time-stamps that are more than sec seconds older than the current
       time.

OPTIONS
       -c cdb The filename of the constant database to be updated.  Default is
              ``ok.cdb'' (in the qconfirm directory).  This option also
              overrides the environment variable QCONFIRM_OKCDB, and the
              configuration file QCONFIRM_OKCDB.  Note: If qconfirm-cdb-check
              updates cdb, it creates cdb.tmp as temporary file.  If cdb.tmp
              exists, it will be destroyed.

       -t sec Set the timeout for removing ids from the constant database to
              sec seconds.  Default is 15724786.  If sec is 0,
              qconfirm-cdb-update does not remove any ids from cdb.

       -m min Set the minimum number of new id files to be added to the
              constant database to min.  Default is 100.  If min is 0,
              qconfirm-cdb-update always updates cdb.

       -l limit
              Set the maximum number of new ids to be added to the constant
              database to limit.  limit must be between 1 and 1000.  Default
              is 300.

       -s state
              The directory to be scanned for new ids.  Default is ``ok'' (in
              the qconfirm directory).

       -r     remove.  Remove id files from the qconfirm directory that are
              also in cdb.  Normally qconfirm-cdb-update ignores these files.

       -f     force.  Process all id files in the qconfirm directory.
              Normally qconfirm-cdb-update skips id files that were added or
              modified within the last 24 hours.  Note that using this option
              may prevent currently pending ids from be confirmed manually
              under certain conditions.

       -v     verbose.  Print verbose messages to standard output.

CONFIGURATION
       qconfirm-cdb-update reads its configuration from files in the
       subdirectory conf/ of the qconfirm directory (normally
       ``~/.qconfirm/conf/'').  Only the first line of a configuration file is
       considered.

       QCONFIRM_OKCDB
              The configuration file QCONFIRM_OKCDB overrides the default name
              of the user's constant database for known ids (``ok.cdb'').

ENVIRONMENT
       QCONFIRM_DIR
              The environment variable QCONFIRM_DIR overrides the default
              location of the user's qconfirm directory (``.qconfirm'').

       QCONFIRM_OKCDB
              The environment variable QCONFIRM_OKCDB overrides the default
              name of the user's constant database for known ids (``ok.cdb''),
              and the configuration file QCONFIRM_OKCDB.

SEE ALSO
       qconfirm-cdb-check(1), qconfirm(1), qconfirm-check(1), qconfirmconf(1)
       , qconfirm-inject(1), qconfirm-notice(1), qconfirm-accept(1),
       qconfirm-return(1), qconfirm-control(1)

       http://smarden.org/qconfirm/

AUTHOR
       Gerrit Pape <pape@smarden.org>

                                                        qconfirm-cdb-update(1)