qconfirm(1)qconfirm(1)NAMEqconfirm - manage addresses/ids in a qconfirm directory
SYNOPSISqconfirm [-iC] [-d dir] [-c cdb] list [pending|ok|return|bad]
qconfirm [-iCD] [-d dir] [-c cdb] arg addresses
DESCRIPTIONqconfirm 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 qcon‐
firm directory. The state can be either known, unknown, pend‐
ing, 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 con‐
firmed 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 cur‐
rently 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 cur‐
rently 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 cur‐
rently 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 tempo‐
rary 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 perma‐
nently 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.
CONFIGURATIONqconfirm 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 qcon‐
firm directory.
SEE ALSOqconfirm-check(1), qconfirm-conf(1), qconfirm-inject(1), qconfirm-
notice(1), qconfirm-accept(1), qconfirm-return(1), qconfirm-control(1),
qconfirm-cdb-check(1), qconfirm-cdb-update(1)
http://smarden.org/qconfirm/
AUTHOR
Gerrit Pape <pape@smarden.org>
qconfirm(1)
