qconfirm-inject(1)

NAME
qconfirm-inject - set Message-ID and VERP and send a mail message

SYNOPSIS
qconfirm-inject [-v] [-nN] recip ...

DESCRIPTION
qconfirm-inject runs qmail-inject(8) to preprocess and send a message it reads from standard input. qconfirm-inject tells qmail-inject(8) to set a Message-ID and variable envelope return path (VERP), according to the configuration in the qconfirm directory, so that delivery notifications are handled through qconfirm-notice(1), and followups can be detected by qconfirm-check-mid(1).

qconfirm-inject also keeps track of Message-IDs of mail messages it injects to enable qconfirm-notice(1) to reliably validate delivery notifications and delivery confirmation request messages.

OPTIONS

-v  verbose. Print verbose messages to standard error.

-n -N
    These options are passed to qmail-inject(8).

CONFIGURATION
qconfirm-inject 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.

QNOTICE_USER
    The configuration file QNOTICE_USER sets the local part (without extension) of the mail address that handles delivery notifications. If QNOTICE_USER is not set, qconfirm-inject checks the environment variables USER and LOGNAME, in this order. If none of these is set, qconfirm-inject refuses to run. QNOTICE_USER must be set to the user's login name.

QNOTICE_HOST
    The configuration file QNOTICE_HOST sets the host part of the mail address that handles delivery notifications. Normally QNOTICE_HOST is the host part of the mail address qconfirm is configured for.

QNOTICE_EXT
    The configuration file QNOTICE_EXT overrides the default extension to be used to receive delivery notifications (``qnotice-'').

QCONFIRM_MID
    The configuration file QCONFIRM_MID sets the host part of the Message-ID to be used when sending mail messages. Only the first mid of the space-separated list is considered. If QCONFIRM_MID is not set, qconfirm-inject refuses to run.

QCONFIRM_MID_TIMEOUT
    The configuration file QCONFIRM_MID_TIMEOUT sets the timeout for expiration of Message-IDs in seconds. Default is 3628800.

QNOTICE_QMAIL_INJECT
    The configuration file QNOTICE_QMAIL_INJECT overrides the default path to the qmail-inject program (``qmail-inject'').

ENVIRONMENT

QCONFIRM_DIR
    The environment variable QCONFIRM_DIR overrides the default location of the user's qconfirm directory (``~/.qconfirm/'').

FILES
 ~/.qconfirm/.qnotice-key
 ~/.qconfirm/conf/
 ~/.qconfirm/notice/

SEE ALSO
qconfirm(1), qconfirm-inject(1), qconfirm-check(1), qconfirm-conf(1), qconfirm-accept(1), qconfirm-control(1), qconfirm-cdb-check(1), qconfirm-cdb-update(1), qconfirm-return(1)

http://smarden.org/qconfirm/

AUTHOR
Gerrit Pape <pape@smarden.org>