qconfirm-check - request delivery confirmation under qmail
[-mnbD] [-d dir] [-i bytes] [-t
(perhaps) requests delivery confirmations from the
envelope sender to allow further processing in the .qmail
can operate either sender-based or message-based, see
below for sender mode and message mode.
Messages with an empty envelope sender and the envelope sender <#@> are
allowed by default.
If you create a .qmail
file to enable
, make sure to also add a line specifying delivery to
your normal mailbox.
runs in sender mode, messages from known envelope
senders are accepted without a confirmation, and immediately allowed to be
processed further in the .qmail
defers messages from unknown envelope senders temporarily,
and sends a confirmation request message to the sender. The original message
and all newer messages from the same sender will be deferred temporarily until
a reply to the confirmation request is received. A message bounces if
has expired. New messages from the same sender do not
result in new confirmation requests.
Once an envelope sender has confirmed a delivery, qconfirm-check
this envelope sender as known.
runs in message mode (option -m is set), each single
message needs to be confirmed to be allowed to be processed further in the
A message bounces if queuelifetime
- message mode. qconfirm-check identifies the message by its inode.
Each message must be confirmed before it is allowed to be processed
further in the .qmail file. Without this option
qconfirm-check runs in sender mode.
- no acknowledge. Do not acknowledge the receipt of a reply to a
- bad. Only works in sender mode. After checking if the envelope sender is
currently pending or ok, check if it is matched as bad.
- no domain match. Only takes effect in sender mode. Don't use extended
envelope sender address matching for domains and sub-domains. This applies
for matching senders for ok and bad.
- -d dir
- Override the default qconfirm directory (``~/.qconfirm'') and the
environment variable QCONFIRM_DIR with dir.
- -i bytes
- include the top bytes bytes of the sender's message at the bottom
of a confirmation request or acknowledgement. Default is 8192.
- -t timeout
- Set the timeout for sending confirmation requests as reminders to
timeout seconds. Unaccepted and unconfirmed messages are held in
the queue. Whenever qmail tries to deliver the message,
qconfirm-check checks if timeout or more seconds have
expired since a confirmation request was sent. If so,
qconfirm-check again sends a confirmation request as reminder. If
timeout is zero, only one confirmation request per message or
sender is sent and no reminders. Default is 345586 (ca. four days).
- prog can be omitted or consists of one or more arguments. If
prog is set, qconfirm-check sets the environment variable
QCONFIRM_DIR=dir and runs prog just before requesting a
delivery confirmation. If prog exits zero, qconfirm-check
allows the message to be processed further in the .qmail file
without a confirmation and exits immediately. If prog exits 111,
qconfirm-check exits 111 immediately. In all other cases
qconfirm-check continues and requests a delivery confirmation.
reads its configuration from files in the subdirectory
of the qconfirm directory (normally ``~/.qconfirm/conf/''). Only
the first line of a configuration file is considered.
- The configuration file QCONFIRM_MAILNAME overrides the default
mailname in the from header of confirmation requests and acknowledgements
- The configuration file QCONFIRM_EXT overrides the default extension
used for receiving message confirmations (``qconfirm-'').
- This configuration file must be set if the mail address you run
qconfirm for is controlled through qmail's virtualdomains.
It must be set to the prepend part of the corresponding entry in
/var/qmail/control/virtualdomains plus a dash at the end.
- The configuration file QCONFIRM_HOST if set overrides the
environment variable HOST normally set by
- The configuration file QCONFIRM_ACCEPT overrides the default
invocation of qconfirm-accept(1) in automatically created
.qmail files (``qconfirm-accept'').
- If QCONFIRM_ACCEPT_PROG is set, its value is used as prog
argument to qconfirm-accept(8) in automatically created
- The environment variable QCONFIRM_DIR overrides the default
location of the user's qconfirm directory (``.qconfirm/'').
qconfirm(1), qconfirm-accept(1), qconfirm-conf(1), qconfirm-inject(1),
qconfirm-notice(1), qconfirm-return(1), qconfirm-control(1),
Gerrit Pape <email@example.com>