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), qconfirm-conf(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>