Path: news1.ucsd.edu!ihnp4.ucsd.edu!swrinde!howland.reston.ans.net!math.ohio-state.edu!usc!news.cerf.net!nntp.irvine.com!jsweet
From: mime-faq@ics.uci.edu (MIME FAQ maintainer)
Newsgroups: comp.mail.mime,comp.answers,news.answers
Subject: comp.mail.mime meta-FAQ: Help for MIME problems
Supersedes: <mime-faq0_834216316@irvine.com>
Followup-To: comp.mail.mime
Date: 8 Jul 1996 08:42:09 GMT
Organization: Irvine Compiler Corporation - Irvine, CA, USA
Lines: 394
Approved: news-answers-request@MIT.Edu
Expires: 31 Aug 1996 09:41:20 GMT
Message-ID: <mime-faq0_836818880@irvine.com>
Reply-To: mime-faq@ics.uci.edu (MIME FAQ maintainer)
NNTP-Posting-Host: flash.irvine.com
Summary: This posting contains help for those who have trouble reading
         MIME messages in general, and the comp.mail.mime FAQ in 
         particular.  Of course, this message is in utterly plain text 
         format.  No MIME.
Originator: jsweet@flash.irvine.com
Xref: news1.ucsd.edu comp.mail.mime:7570 comp.answers:15619 news.answers:62327

Archive-Name: mail/mime-faq/mime0
Version: $Id: mime0,v 1.7 1996/07/02 02:01:07 jsweet Rel $
Posting-Frequency: monthly
X-Comment: since this is a meta-FAQ, and not part of the FAQ, 
   the archive-name is in a separate name space (mime0 instead of
   part0).

--
=======================
comp.mail.mime meta-FAQ
=======================
Help for MIME problems
~~~~~~
--

Contents
~~~~~~~~
  1)  Explanation
  2)  About the MIME FAQ
  3)  Conventions
  4)  Sample Problem Scenarios
  5)  Where else to find the MIME FAQ

--

1) Explanation
--------------
This is the comp.mail.mime meta-FAQ.  It's for those who have
unusually bad problems in dealing with MIME, and thus are unable to
read the comp.mail.mime FAQ articles, even though they're essentially
plain text.

This meta-FAQ also offers some general help for those who have 
various kinds of problems reading MIME messages.

Please note:
  
    Questions about mail systems, how to decode MIME parts on your
    computer, and other such issues, if not already answered in the
    FAQ, should be posted to comp.mail.mime or to the info-mime mailing
    list.

    Correspondence sent to the MIME FAQ maintainer primarily should 
    address information in the MIME FAQ---corrections, additions, or
    suggestions for improvement.
  
Also: neither the MIME meta-FAQ nor the MIME FAQ are intended to solve
every possible problem that you might have with your mail system.  If
you have general difficulties with your mail system, difficulties that
are _not_ specific to MIME, you should consider the possibility that a
more correct forum for your questions lies elsewhere, such as any of
these newsgroups:

     comp.mail.elm                     comp.mail.pine
     comp.mail.eudora.mac               comp.mail.sendmail
     comp.mail.eudora.ms-windows        comp.mail.zmail
     comp.mail.mh                
     comp.mail.misc                 
     comp.mail.mush

--

2) About the MIME FAQ
---------------------
The comp.mail.mime FAQ itself, aka the MIME FAQ, attempts to answer
frequently asked questions about MIME, the multipurpose and
multi-media standard for Internet mail.

The MIME FAQ is divided into three parts, using the MIME type
"message/partial".  That usually means nothing to MIME-challenged news
readers and mail user agents, which is usually just fine.  The MIME
FAQ is really just like an ordinary multipart FAQ---it uses plain
US-ASCII text and can be read like any other ordinary USENET article.

So ordinarily, the MIME FAQ is rendered as ordinary plain-text news or
mail, which is fine.  However, with mis-installed, incomplete, or
broken software, there are sometimes special problems encountered with
MIME messages.  While this meta-FAQ can't deal with all possible
problems, this meta-FAQ does enumerate some general scenarios that may
help you to understand whatever difficulties you're having.

Once again, for emphasis: the MIME FAQ is really just plain US-ASCII
text.  You should be able to read it one way or another.  The best
way, of course, is to get yourself some _working_ MIME-capable
software.  The MIME FAQ is a good source of information for finding
such software---assuming that you're able to read the MIME FAQ!

If not, read on...
--

3) Conventions
--------------
In this note, pointers to resources available via the Internet, such
as references to FTPable goodies, appear in WWW URL format.  URLs
beginning with "ftp:" refer to FTP sites.  For example:

ftp://domain.name/path/to/package

Those with FTP access, but without WWW access, may treat such
references as follows:

1. Log into host domain.name using anonymous FTP
2. Look for /path/to/package

An FTP reference usually lists only the distribution site; please
try your nearest FTP archive first.  Archie may be of some help
here.

URLs beginning with "http:" refer to WWW servers.  URLs beginning
with "gopher:" refer to gopher servers.

Internet browsing tools, such as Mosaic, know about URLs.
--

4) Sample Problem Scenarios
---------------------------
If you have problems reading a message in MIME format, it might be for
any of the reasons presented in the scenarios below.  In the case of
the MIME FAQ in particular, Scenario 7 may be especially meaningful.


Scenario 1:

You have mis-installed, incomplete, or broken software, and it
absolutely refuses to deal properly with a MIME message of any sort.

You're not necessarily entirely out of luck.  Your choices are to fix
or to replace your software.  There are many options available for
doing this, some of which are covered in the scenarios that follow.

To overcome the immediate problem, you might try to bypass your
software entirely, and look at the message in its "raw" state.

To read a raw message, save the message to a text file any way you
can, and use your favorite text editor (emacs, vi, or whatever) to
read the text file.


Scenario 2:

Your mail system outsmarted itself--it can handle some MIME stuff,
but not whatever it is you received.  

For this, you'll either need a smarter mail system, or you'll need to
tell the mail system how to handle whatever's in the message, or
you'll need to defeat the mail system entirely, and look at the
message in its "raw" state, as described in Scenario 1.  Scenario 4,
below, may offer some help too.


Scenario 3:

You received a "MIME-like" message that's almost, but not quite,
entirely unlike a real MIME message.  It looks similar enough to a
real MIME message that it breaks your mail software.  The SunOS
"mailtool" is notorious for sending such MIME-like messages.  Early
versions of Netscape (1.0? --aka "Mozilla") are also thought to be
guilty of this.

Conversion tools do exist for certain situations, e.g. sun2mime or
sun-to-mime.  Some work, some don't.  Whatever you find, it's probably
worth a try.  Otherwise, you'll either have to read the message with
the same mail program that generated such a thing, or content yourself
with the raw message.

    [ Steinar Bang <sb@metis.no> 2-Feb-1996 ]

    Q: How to make the Solaris [>=2.4?] OW Mailtool send attachments
       using MIME?
    
    A: Set "send rfc" in your .mailrc.


Scenario 4:

Your mail system doesn't understand MIME stuff at all.  

For this, you must either content yourself with the "raw" message, or
you can try to track down some tools to help you.  From John Gardiner
Myers <jgm+@CMU.EDU>, we have this advice:

    A minimalist MIME-reading program, munpack, is available from
    this URL:
  
      ftp://ftp.andrew.cmu.edu/pub/mpack/
  
    (i.e. use anonymous FTP to site ftp.andrew.cmu.edu, and look
    in the directory /pub/mpack.)
  
    The munpack program reads MIME messages and writes the decoded
    parts out to files.  Versions are available for Unix, MS-DOS,
    Macintosh, and Amiga platforms.

    In short, munpack is the MIME equivalent of uudecode/binhex.  See
    part 2 of the MIME FAQ for additional information about the mpack
    tool suite.

    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 to 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.

See also Scenario 7, below.


Scenario 5:

You don't have all the necessary equipment to listen to an audio part,
or to view a graphical part, or to read text written in a foreign
character set.  

You're out of luck here; you can handle a lot of MIME stuff on a plain
old 24x80 ASCII terminal, but let's face it: if you're stuck with
something like that, YOU LOSE.  If someone asks you how to listen to
an audio message on a 24x80 ASCII terminal, cruel laughter may help to
enlighten the penitent.  ;-)


Scenario 6:

You _do_ have the necessary equipment to listen to an audio part, or
to view a graphical part, such as an audio capable workstation or an
X terminal, but your software doesn't know how to deal with whatever
those kinds of MIME contents are.

You may need additional software, such as xv, or audiotool, or
whatever.  If that software came with neither your hardware nor your
MIME-capable mail user agent or news reader, then you need to go
treasure hunting on the Internet, or get it from some commercial
source.  After finding and installing that software, you may also have
to do some additional configuration of your mail system or news
readers so that they know where to find these additional programs and
how to invoke them.

Note: the MIME FAQ itself has no graphics or audio in it; it's really
just plain text.


Scenario 7:

Your mail system doesn't want to show a "message/partial" (like the
comp.mail.mime FAQ articles).  

For this, you may need to assemble all the parts of the message
together.  Here is specific advice for various types of mailers:


Metamail and other mailcap-based mail user agents:

  The mailcap file needs an entry for message/partial.  One entry,
  contributed by Tim Goodwin, is this:

      message/partial; showpartial %s %{id} %{number} %{total}

  The showpartial command is part of the metamail distribution.
  Metamail is available from these URLs:

  ftp://ftp.bellcore.com/pub/nsb/mm2.7.tar.Z
        [The core metamail software]

  ftp://ftp.bellcore.com/pub/nsb/contrib2.7.tar.Z
        [Contributed software]

  ftp://ftp.bellcore.com/pub/nsb/mm2.7.dos.zip
        [MS-DOS binaries]


MH:

  You can assemble the message together using this command:

    mhn -store cur:3

  Alternatively, you can view the "raw" message by using this
  MH command:

    show -noshowproc


{ Brief advice for other specific mail systems is welcome. }


Scenario 8:

You've saved some MIME messages into files, and you have no idea
how to read them.

Here is specific advice for various types of mailers:

Metamail:

    [ Susan Gruber <sgruber@netcom.com> 13-Dec-1994 ]
  
    This is the command that I used to read my files:

      metamail -y filename

MH:

  mhn -show -file filename

Pine:

    [ "Mark H. Wood" <MWOOD@indyvax.iupui.edu> 18-Mar-1996 ]

    pine -F file


{ Brief advice for other specific mail systems welcome. }



Scenario 9:

Your mail system has automatically introduced MIME constructs that
your recipient cannot handle.

This is a tough problem.  Ned Freed correctly points out that some
kind of transformation of your message may be required in order to get
the message delivered at all.  This may occur because the message
contains 8-bit characters, which won't necessarily get through an
arbitrary mail system.  For another example, your message may have
been too large and had to be fragmented into smaller messages.

Other possibilities:

  - Your message went through a misdesigned or misconfigured mail
    system somewhere along the way. For example, Microsoft Exchange's
    SMTP component incorrectly uses quoted-printable encoding in an
    attempt to control message formatting.

  - MIME may not be involved at all; the message may be a "MIME-like"
    message (see Scenario 3, above) that is produced by a broken
    mail user agent.

It may be the case that you and your recipient cannot find a way to
exchange data via e-mail at all.  This is the kind of interoperability
problem that MIME can help to solve, but of course, compatible tools
are required on both ends.

Some individuals may try to fall back on uuencode, and that may work
in some cases, but there are many cases in which uuencode simply won't
work (see the MIME FAQ for details).

The best solution is for both parties to use correctly implemented
MIME-aware mail systems, or for both parties to have interoperating
tools for encoding and decoding data that use base64 or some other
format that will survive transport through problematic mail gateways.
The MIME FAQ contains references to many such tools.

--


5) Where else to find the MIME FAQ
----------------------------------

 - Many sites archive news.answers postings, including these:
   
   ftp://ftp.uu.net/usenet/news.answers/mail/mime-faq/
   ftp://rtfm.mit.edu/pub/usenet-by-group/news.answers/mail/mime-faq/
   
   If possible, please try to find a closer site; for example, by
   asking archie for "mime-faq".
   
 
 - Some sites make HTML versions of the MIME FAQ available:
 
   http://www.cs.ruu.nl/wais/html/na-dir/mail/mime-faq/.html
   http://www.cis.ohio-state.edu/text/faq/usenet/mail/mime-faq/top.html

 
========================================================================

[ end of MIME meta-FAQ ]