NAME

       mime-tool - a simple program to construct MIME messages with attached files

SYNOPSIS

       mime  [  -dDvV  ]  [  -S  subject ] [ -F from-address ] [ -T to-address ] [ -C carbon-copy
       address ] [ -P prolog-text ] [ -E epiplogue-text ] [ -B boundary ] [ -O  overall  content-
       type ] { [ -78abiquxopm ] [ -t content-type ] filename }

DESCRIPTION

       The  mime  program  constructs MIME messages with attached files. The user can specify the
       content type (application/octet-stream, text/plain or a user specified type), content type
       encoding  (7bit,  8bit,  binary, base64 and auto-detect), content disposition (attached or
       inline) and the content boundary string.  The user can  also  specify  some  mail  related
       options:  subject,  from-address, to-address, carbon-copy address, prolog-text and epilog-
       text.

       The output of the MIME-tool program can be sent directly to the mail,  mailx  or  sendmail
       commands (or any other command that accepts RFC-822 formatted messages).

       NOTE:  Specifying  7-bit  encoding for an attachment that contains 8-bit data will convert
       any data bytes whose high-bit is set to question marks.

OPTIONS

       -7     7-bit ASCII encoding

       -8     8-bit ASCII encoding

       -a     application/octet-stream content type

       -b     binary encoding

       -d     low detail debugging

       -D     high detail debugging

       -s     write a subpart

       -i     disposition: inline (instead of attachment)

       -q     quoted-printable encoding

       -c content-type
              explicit content type

       -t     text/plain content type

       -o     omit disposition line

       -u     unknown encoding, auto-detect

       -v     verbose messages

       -V     very verbose messages

       -x     base64 encoding

       -p     copy existing MIME part

       -o     omit content-disposition

       -m     omit content-transfer-encoding

       -n filename
              override the filename in the disposition header

       -N     don't add a filename parameter in the disposition header

       -0     no-op

EXAMPLES

       Using MIME-tool to write a mail message to a file:

              mime -S "test message" -F me@foo.net -T someone@somewhere.net file1 > test.msg

       Using MIME-tool with the mail command:

              mime -S "test message" -F me@foo.net file1 | mail someone@somewhere.net

       Using MIME-tool with the mailx command:

              mime -S "test message" -F me@foo.net file1 | mailx someone@somewhere.net

       Using MIME-tool with the sendmail command:

              mime -S "test message" -F me@foo.net file1 | sendmail someone@somewhere.net

VERSION

       This is version 1.5.topal3 from June 2009.

KNOWN BUGS

       Most of the header values are not properly quoted or folded, so long or complex values for
       these headers may cause problems. Specifically, the from-address, to-address, carbon-copy-
       address and content-type headers may not be properly quoted or folded.

       For some reason, certain e-mail clients (espcially from a large software  company  located
       in  Redmond,  Washington)  don't  seem  to  recognize file attachments as attachments, but
       instead displays them as inline attachments.  (maybe this  isn't  MIME-tool's  fault,  but
       I've gotten a few e-mails about it, so I'm mentioning it here)

AUTHOR

       mime is written by Jeffrey Dutky <dutky@bellatlantic.net>

       Oscar Esteban spotted an off-by-one error in the base64 encoding function.

       Sergey Lapin spotted a bug in the filename header construction.

       Chris  Hemphill  noticed  that  the  documentation  (this manual page and the README file)
       didn't include any examples of how to call the program with common mail commands.

       Some additional fixes and additions by Phil Brooke to support Topal.

AVAILABILITY

       The   original   MIME-tool   package   can   be   downloaded   from   my   web   page   at
       http://members.bellatlantic.net/~dutky

       This modified version is distributed with Topal:

       http://homepage.ntlworld.com/phil.brooke/topal/