NAME

qconfirm - manage addresses/ids in a qconfirm directory

SYNOPSIS

qconfirm [-iC] [-d dir] [-c cdb] list [pending|ok|return|bad]

qconfirm [-iCD] [-d dir] [-c cdb] arg addresses

DESCRIPTION

qconfirm either lists pending, known, bouncing, or bad addresses in a qconfirm directory, or alters their states to tell qconfirm-check(1) what to do with mails from these addresses.

arg is either check, accept, drop, bounce, sneak, pending, remove, or bad. addresses consists of one or more mail addresses or qconfirm ids.

ARGS

list: lists all ids in the pending/, ok/, return/, or bad/ directory as mail addresses, one per line. Each address is preceded with a time-stamp indicating when the last confirmation request was sent (pending/), when the last message from this address was accepted (ok/), when the most recent bounce was received (return/), or when the id was created (bad/). If neither the pending, ok, return, or bad option is given, qconfirm lists the pending directory and appends to each address its current state.
check: check for each mail address in addresses its state in the qconfirm directory. The state can be either known, unknown, pending, or bad.
accept: alter the state for each mail address in addresses to known. If the state of the mail address is pending, this address is confirmed manually. The next time qmail tries to deliver a message from this address, the message is accepted and the state is changed to known.
drop: check for each mail address in addresses if the address currently is pending. If yes, tell qconfirm-check(1) to silently drop the message the next time qmail tries to deliver a message from this address.
bounce: check for each mail address in addresses if the address currently is pending. If yes, tell qconfirm-check(1) to bounce the message the next time qmail tries to deliver a message from this address.
sneak: check for each mail address in addresses if the address currently is pending. If yes, tell qconfirm-check(1) to forward a preview of a message from this address to $QCONTROL_OWNER. After the preview is sent, qconfirm-check(1) switches the state back to pending.
pending: switch the state of each mail address back to pending.
remove: check for each mail address in addresses if the address is known. If yes, change its state to unknown. Note: If qconfirm updates the constant database cdb, it creates cdb.tmp as temporary file. If cdb.tmp exists, it will be destroyed.
bad: check for each mail address in addresses if the address is unknown or pending. If yes, tell qconfirm-check(1) to permanently bounce messages from this address.

OPTIONS

-i: id. Force all addresses to be interpreted as qconfirm ids, not mail addresses, and output qconfirm ids instead of mail addresses.
-C: cdb. Additionally to the qconfirm directory, check the default constant database for known ids (``~/.qconfirm/ok.cdb'').
-d dir: Override the default qconfirm directory (``~/.qconfirm'') and the environment variable QCONFIRM_DIR with dir.
-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. If cdb doesn't start with a slash, it is searched in the user's qconfirm directory. This option implies the -C option.
-D: Don't use extended envelope sender domain matching when checking ids.

CONFIGURATION

qconfirm 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. If QCONFIRM_OKCDB doesn't start with a slash, it is searched in the user's qconfirm directory.

AUTHOR

Gerrit Pape <pape@smarden.org>