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/

AUTHOR