[misc] / unfwd.1

.\" -*-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>
Commit	Line	Data
f342fce2	1	.\" --nroff--
	2	.TH unfwd 1 "9 October 2003" "Straylight/Edgeware"
	3	.SH NAME
	4	unfwd \- extract a MIME-formatted forwarded mesage
	5	.SH SYNOPSIS
	6	.B unfwd
	7	.I program
	8	.IR args ...
	9	.SH DESCRIPTION
	10	Reads a MIME-formatted email message from standard input. For each part
	11	of content-type
	12	.BR message/822 ,
	13	run
	14	.I program
	15	and feed the enclosed message to it on its standard input. For each
	16	part of content-type
	17	.BR multipart/digest ,
	18	pick the digest apart and feed each message in turn to
	19	.I program
	20	on standard input.
	21	.PP
	22	If all went well,
	23	.B unfwd
	24	exits 0. If
	25	.I program
	26	exits nonzero, or the original message didn't contain any MIME forwarded
	27	messages, then a message is printed to standard error and
	28	.B unfwd
	29	exits 100, which causes
	30	.B qmail-local
	31	to bounce the mail. If something else went wrong,
	32	.B unfwd
	33	returns 111, indicating a temporary failure.
	34	.SH BUGS
	35	None known.
	36	.SH AUTHOR
71d8432e	37	Mark Wooding <mdw@distorted.org.uk>
f342fce2	38