.\" -*-nroff-*-
.TH unfwd 1 "9 October 2003" "Straylight/Edgeware"
.SH NAME
unfwd \- extract a MIME-formatted forwarded mesage
.SH SYNOPSIS
.B unfwd
.I program
.IR args ...
.SH DESCRIPTION
Reads a MIME-formatted email message from standard input.  For each part
of content-type
.BR message/822 ,
run
.I program
and feed the enclosed message to it on its standard input.  For each
part of content-type
.BR multipart/digest ,
pick the digest apart and feed each message in turn to
.I program
on standard input.
.PP
If all went well,
.B unfwd
exits 0.  If
.I program
exits nonzero, or the original message didn't contain any MIME forwarded
messages, then a message is printed to standard error and
.B unfwd
exits 100, which causes
.B qmail-local
to bounce the mail.  If something else went wrong,
.B unfwd
returns 111, indicating a temporary failure.
.SH BUGS
None known.
.SH AUTHOR
Mark Wooding <mdw@distorted.org.uk>