qconfirm-return(1)

NAME
qconfirm-return - handles bounces from qconfirm-check(1)

SYNOPSIS

in .qmail:
    |qconfirm-return [-n limit] [dir]

DESCRIPTION
qconfirm-return expects QSBMF (qmail-send bounce message format) bounce messages and processes them. It tries to extract the recipient address that caused the bounce from the failure paragraph and the unique key that qconfirm-check(8) has created for delivery confirmation for messages from this address from the original message (the included qconfirm-check(8)'s confirmation request message).

If qconfirm-return fails to do so, or the key in the original message does not match the key qconfirm-check(8) has created for this address, or the envelope sender is not empty, it prints a warning and exits 0.

Otherwise qconfirm-return notices that this address bounces. If qconfirm-return sees that this address already has bounced before, it tells qconfirm-check(8) to silently drop the message from this sender address the next time qmail tries to deliver it (exception: see the -n option).

If qconfirm-return was able to successfully parse and notice the bounce message, it exits 99, and so tells qmail-local(8) to ignore all further delivery instructions.

qconfirm-return exits 111 on error.

OPTIONS

-n limit
    Limit. limit must be an integer; if this option is given, qconfirm-return notices addresses that bounce limit more times before telling qconfirm-check(8) to silently drop the message from the sender address. Default is 0.

dir qconfirm directory. qconfirm-return uses the qconfirm directory dir for checking pending addresses and noticing bouncing addresses. Default is .qconfirm.

FILES
 ~/.qconfirm/pending/
 ~/.qconfirm/return/

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

 http://smarden.org/qconfirm/
 http://cr.yp.to/proto/qsbmf.txt

AUTHOR
Gerrit Pape <pape@smarden.org>