Lots of stuff.

[misc] / unfwd.1

diff --git a/unfwd.1 b/unfwd.1
new file mode 100644 (file)
index 0000000..7a88f05
--- /dev/null
+++ b/unfwd.1
@@ -0,0 +1,38 @@
+.\" -*-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@nsict.org>
+