NAME

       munpack - unpack messages in MIME or split-uuencode format

SYNOPSIS

       munpack [ -f ] [ -q ] [ -t ] [ -r character ] [ -C directory ] [ filename ...  ]

DESCRIPTION

       The munpack program reads each RFC-822 message filename and writes all non-text MIME parts
       or split-uuencoded files as files.  If no filename argument is given, munpack  reads  from
       standard input.

       If  the message suggests a file name to use for the imbedded part, that name is cleaned of
       potential problem characters and used for the output  file.   If  the  suggested  filename
       includes  subdirectories,  they  will  be  created  as necessary.  If the message does not
       suggest a file name, the names "part1", "part2", etc are used in sequence.

       If the imbedded part was preceded with  textual  information,  that  information  is  also
       written  to  a  file.   The file is named the same as the imbedded part, with any filename
       extension replaced with ".desc".

OPTIONS

       -f     Force overwriting of existing files.  If a message  suggests  a  file  name  of  an
              existing  file,  the  file will be overwritten.  Without this flag, munpack appends
              ".1", ".2", etc to find a nonexistent file.

       -q     Be quiet.  Suppresses messages about saving partial  messages  and  about  messages
              with no interesting information.

       -t     Also  write  the  text MIME parts of multipart messages as files.  By default, text
              parts that do not have a filename parameter  do  not  get  unpacked.   This  option
              effectively disables the ".desc" file feature for MIME messages.

       -r character
              If  the suggested filename contains invalid characters, they are replaced with this
              character. The default replacement character is "X".

       -C directory
              Change the current directory to directory before reading any files.  This is useful
              when invoking munpack from a mail or news reader.

DECODING MIME

       To  decode  a  MIME  message, first save it to a text file.  If possible, save it with all
       headers included.  Munpack can decode some MIME files when  the  headers  are  missing  or
       incomplete,  other  files  it cannot decode without having the information in the headers.
       In general, messages which have a statement at the beginning that they are in MIME  format
       can  be  decoded  without the headers.  Messages which have been split into multiple parts
       generally require all headers in order to be reassembled and decoded.

       Some LAN-based mail systems and some mail providers (including America Online, as  of  the
       writing  of this document) place the mail headers at the bottom of the message, instead of
       at the top of the message.  If you are having problems decoding a MIME message on  such  a
       system,  you  need  to  convert  the  mail  back  into the standard format by removing the
       system's nonstandard headers and moving the standard Internet headers at the  top  of  the
       message (separated from the message body with a blank line).

       There must be exactly one message per file.  Munpack cannot deal with multiple messages in
       a single file, to decode things correctly it must know when one message ends and the  next
       one begins.

       To decode a message, run the command:

              munpack file

       where  "file"  is the name of the file containing the message.  More than one filename may
       be specified, munpack will try to decode the message in each file.  For  more  information
       on ways to run munpack, see the section "OPTIONS" above.

ENVIRONMENT

       TMPDIR Directory to store temporary files.  Default is /tmp.

FILES

       $TMPDIR/m-prts-$USER/
              Directory used to store partial messages awaiting reassembly.

REPORTING BUGS

       Send all bug reports to mpack-bugs@andrew.cmu.edu.

                                                                                       MUNPACK(1)