NAME

     mshow — render messages and extract MIME parts

SYNOPSIS

     mshow [-h headers] [-A mimetypes] [-nqrFHLN] [msgs ...]
     mshow -x msg parts ...
     mshow -O msg parts ...
     mshow -t msgs ...
     mshow -R msg

DESCRIPTION

     mshow renders the specified msgs to the standard output, by default.  (See mmsg(7) for the
     message argument syntax.)  If used interactively and no msgs are specified, mshow displays
     the current message using colorization and a pager.

     The options are as follows:

     -h headers
             Display the headers in the colon-separated list headers, instead of the default
             headers ‘from:subject:to:cc:date:reply-to:’.

     -A mimetypes
             Define ‘mixed/alternative’ preference.  mimetypes is a colon-separated list of MIME
             types which will be preferred, in the order given, when rendering
             ‘mixed/alternative’ parts.  If no MIME type matches, the first MIME part will be
             rendered.

             Defaults to ‘text/plain:text/html’.

     -n      Don't update the current message link.

     -q      Don't render the body, stop after header output.

     -r      Don't render the body, print raw body.  This may be dangerous to use on a tty.

     -F      Don't apply filters to MIME parts.

     -H      Don't decode the headers, print all raw headers.  This may be dangerous to use on a
             tty.

     -L      Don't filter the headers, print all decoded headers.

     -N      Don't show MIME structure markers.

     -x msg  Switch to extraction mode: extract parts from the message msg into files.  parts can
             be specified by number, filename or fnmatch(3) pattern.

     -O msg  Like -x but write to standard output.  This may be dangerous to use on a tty.  When
             used together with -r, the whole part is raw, that is, un-decoded and including MIME
             part headers.

     -t      Switch to list mode: list all MIME parts of each msg.

     -R msg  Render the text parts from msg, suitable for use in a reply.

FILTERS

     mshow, by default, decodes all ‘text/*’, ‘message/rfc822’ and ‘multipart/*’ parts, and re-
     encodes them into UTF-8 if necessary.

     Other filters can be specified in the file ${MBLAZE:-$HOME/.mblaze}/filter, in the format:

           type/subtype: command
     or
           type: command

     mshow will then spawn a pipe to command, write the MIME part and display the output.  The
     environment variable PIPE_CHARSET will be set to the charset declared in the MIME part, if
     known.

     Filters can communicate with mshow using their exit status:
     0         The output is printed as plain text.
     62        The output is printed raw, without escaping.
     63        Behave as if the filter never ran.
     64        The output is an RFC 5322 message that should be rendered again.
     65 to 80  Render the n-64th part of this text/multipart part.
     All other exit statuses are regarded as errors.

ENVIRONMENT

     MBLAZE_PAGER    Any non-empty value of the environment variable MBLAZE_PAGER is used instead
                     of the standard pagination program, specified in PAGER.  When empty or set
                     to ‘cat’, no pager is spawned.

     MBLAZE_NOCOLOR  If non-empty, mshow will not spawn a colorization filter.

EXIT STATUS

     The mshow utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     mmsg(7)

AUTHORS

     Leah Neukirchen <leah@vuxu.org>

LICENSE

     mshow is in the public domain.

     To the extent possible under law, the creator of this work has waived all copyright and
     related or neighboring rights to this work.

     http://creativecommons.org/publicdomain/zero/1.0/