DragonFly On-Line Manual Pages

Search: Section:  

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


NAME

       qconfirm-cdb-check - match a mail address against a constant database


SYNOPSIS

       qconfirm-cdb-check [-vD] [-c cdb] [-t sec]


DESCRIPTION

       Normally qconfirm-cdb-check is run by qconfirm-check(1) before
       requesting a delivery confirmation for mail from an envelope sender
       mail address.  If qconfirm-cdb-check exits 0, qconfirm-check(1) doesn't
       request a delivery confirmation from this sender.

       qconfirm-cdb-check assumes the environment variable SENDER to be set to
       the envelope sender mail address.  It creates an id based on $SENDER,
       and matches the id against entries in the constant database
       ~/.qconfirm/ok.cdb.  ok.cdb normally is created and maintained by
       qconfirm-cdb-update(1).

       If qconfirm-cdb-check successfully matches $SENDER, it reads the time-
       stamp of the id that matches $SENDER in ok.cdb, updates the time-stamp
       if it is older than sec seconds, and exits 0.


OPTIONS

       -c cdb Set the filename of the constant database to be checked to cdb.
              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 interval for updating time-stamps of ids in cdb to sec
              seconds.  Default is 2419200 (four weeks).

       -D     no domain match.  Don't use extended envelope sender addresses
              matching for domains and sub-domains.

       -v     verbose.  Print verbose messages to standard output.


CONFIGURATION

       qconfirm-cdb-check 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

       SENDER qconfirm-cdb-check assumes the environment variable SENDER to be
              set to the envelope sender mail address.  If $SENDER is not set,
              qconfirm-cdb-check complains and exits 100.

       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-update(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-check(1)

Search: Section: