mdw@git.distorted.org.uk Git - misc/blob - unfwd.1

   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
  37 Mark Wooding <mdw@distorted.org.uk>
  38