DragonFly On-Line Manual Pages

qconfirm-return(1)     DragonFly General Commands Manual    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), qconfirmcdb-check(1)
       , qconfirm-cdb-update(1)

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

AUTHOR
       Gerrit Pape <pape@smarden.org>

                                                            qconfirm-return(1)