<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML//EN">
<title>MHonArc Resources: MIMEFILTERS
</title>
<table border=
0><tr valign=
"top">
<td align=
"left" width=
"50%">[Prev:
<a href=
"mimeexcs.html">MIMEEXCS
</a>]
</td><td><nobr>[
<a href=
"../resources.html#mimefilters">Resources
</a>][
<a href=
"../mhonarc.html">TOC
</a>]
</nobr></td><td align=
"right" width=
"50%">[Next:
<a href=
"modtime.html">MODTIME
</a>]
</td></tr></table>
<!-- *************************************************************** -->
<dt><strong>Envariable
</strong></dt>
<dt><strong>Element
</strong></dt>
<code><MIMEFILTERS
></code><br>
<var>filter-specification
</var><br>
<code></MIMEFILTERS
></code><br>
<dt><strong>Command-line Option
</strong></dt>
<!-- *************************************************************** -->
<P>The resource MIMEFILTERS is used to hook in user specifed filters
into MHonArc. The MIMEFILTERS resource can only be set via the
<CODE>MIMEFILTERS
</CODE> element. The syntax for each line of the
the
<CODE>MIMEFILTERS
</CODE> element is as follows:
</P><P><var>content-type
</var><CODE>;
</CODE><var>routine-name
</var><CODE>;
</CODE><var>file-of-routine
</var> </P>
<P>The definition of each semi-colon-separated value is as follows:
<DT><var>content-type
</var>
<DD><P>The MIME content-type the filter processes. An explicit
content-type (base/subtype) or a base content-type (base/*)
<DT><var>routine-name
</var>
<DD><P>The actual routine name of the filter. The name
should be fully qualified by the package it is defined in
(e.g.
"<CODE>mypackage::filter</CODE>").
</P><DT><var>file-of-routine
</var>
<DD><P>The name of the file that defines
<var>routine-name
</var>. If the file is not a full
pathname, MHonArc finds the file by looking in the
standard include paths of Perl, and the paths specified by the
<A HREF=
"perlinc.html">PERLINC
</A>
<P>Whitespace is stripped out for each filter specification.
<H3><a name=
"writefilters">Writing Filters
</a></H3>
<P>If you want to write your own filter for use in MHonArc,
you need to know the Perl programming language. The following
information assumes you know Perl.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>As of v2.5 of MHonArc, the API for filters is different from
v2.4.x, and earlier. The following describes the v2.5 API for
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>The default filters provided by MHonArc are described
in the
<strong>Default Settings
</strong> section.
<H4>Function Interface of Filter
</H4>
<P>MHonArc interfaces with MIME filters by calling a routine
with a specific set of arguments. The prototype of the interface
routine is as follows:
</P> my(
<b>$fields_hash_ref
</b>,
<b>$body_data_ref
</b>,
<b>$is_decoded
</b>,
<b>$filter_args
</b>) = @_;
# The last statement should be the return value, unless an
# explicit return is done. See the following for the format of the
<H5>Parameter Descriptions
</H5>
<table cellspacing=
1 border=
0 cellpadding=
4>
<td><strong><code>$fields_hash_ref
</code></strong></td>
<td><p>A reference to hash of message/part header
fields. Keys are field names in lowercase
and values are array references containing the
field values. For example, to obtain the
content-type, if defined, you would do:
$fields_hash_ref-
>{'content-type'}[
0]
</pre><p>Values for a fields are stored in arrays since
duplication of fields are possible. For example,
the
<tt>Received:
</tt> header field is typically repeated
multiple times. For fields that only occur once,
then array for the field will only contain one
<td><strong><code>$body_data_ref
</code></strong></td>
<td><p>Reference to body data. It is okay for the
filter to modify the text in-place.
<td><strong><code>$is_decoded
</code></strong></td>
<td><p>Boolean flag if body data has been decoded.
This is normally true unless some non-standard
content-transfer-encoding is used. See
<a href=
"mimedecoders.html">MIMEDECODERS
</a> on how
to register decoders for various content-transfer-encodings.
<td><strong><code>$filter_args
</code></strong></td>
<td><P>This is an optional argument string that may be used to modify the
behavior of the filter. The format of this string is determined by the filter
itself. The value of the string is set by the
<a href=
"mimeargs.html">MIMEARGS
</a> resource.
<p>The return value is treated as a list. The first item of the list
is a string representing the HTML markup to insert in the HTMLized
message. An empty string, or
<tt>undef
</tt> may be returned to tell MHonArc
that the routine was unable to filter data.
<p>Any other list items are treated as names of any files that were
generated by the filter. MHonArc needs to keep track if any
extra files that a filter may generate in order for MHonArc to
delete those files if the message gets removed from the archive.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>If you want MHonArc to treat the data as filtered, but not
have anything displayed on the page, just return a string with
a single space character.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>If the filter creates a subdirectory with files, the filter
only needs to return the subdirectory in the return list. If
the message gets removed, MHonArc will delete the entire
<H4>Filter Writing Tips
</H4>
<P>The following recommendations/tips are given to help you write
<LI><P>Qualify your filter in its own package. This eliminates possible
variable/routine conflicts with MHonArc.
<LI><P>If the filter creates derived files (like the image filters),
you may use the variable
<strong><CODE>$mhonarc::OUTDIR
</CODE></strong>location of the mail archive.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p><strong>Do not include
</strong>
<strong><CODE>$mhonarc::OUTDIR
</CODE></strong> as part as the
filename that is returned to MHonArc. If the filter
does create files, just return the base name.
<LI><P>Look at the default filters contained in the distribution
of MHonArc. You can use these as templates for writing
<LI><P>Make sure your Perl source file ends with a true statement
(like
"<CODE>1;</CODE>"). MHonArc just performs a
<strong><CODE>require
</CODE></strong>
on the file, and if the file does not return
true, Perl will abort execution.
</P><li><p>Test your filter before production use.
<P>If a MIME filter requires the utilization of a C program, or
other non-Perl executable, a Perl wrapper must be written for the
program in-order to interface with MHonArc. The wrapper must
follow the conventions described in
<a href=
"#writefilters">Writing Filters
</a>.
<!-- *************************************************************** -->
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>It is important to have an explicit entry for
<b><tt>application/octet-stream
</tt></b> for handling unknown
<b><MIMEFilters
></b>
application/octet-stream;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
application/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
application/x-patch;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
audio/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
chemical/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
model/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
image/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
message/delivery-status;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
message/external-body;
<a href=
"#m2h_msg_extbody">m2h_msg_extbody::filter
</a>; mhmsgextbody.pl
message/partial;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
text/*;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
text/enriched;
<a href=
"#m2h_text_enriched">m2h_text_enriched::filter
</a>; mhtxtenrich.pl
text/html;
<a href=
"#m2h_text_html">m2h_text_html::filter
</a>; mhtxthtml.pl
text/plain;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
text/richtext;
<a href=
"#m2h_text_enriched">m2h_text_enriched::filter
</a>; mhtxtenrich.pl
text/setext;
<a href=
"#m2h_text_setext">m2h_text_setext::filter
</a>; mhtxtsetext.pl
text/tab-separated-values;
<a href=
"#m2h_text_tsv">m2h_text_tsv::filter
</a>; mhtxttsv.pl
text/x-html;
<a href=
"#m2h_text_html">m2h_text_html::filter
</a>; mhtxthtml.pl
text/x-setext;
<a href=
"#m2h_text_setext">m2h_text_setext::filter
</a>; mhtxtsetext.pl
video/*;
<a href=
"#m2h_external">m2h_external::filter
</a>; mhexternal.pl
x-sun-attachment;
<a href=
"#m2h_text_plain">m2h_text_plain::filter
</a>; mhtxtplain.pl
<b></MIMEFilters
></b>
<p>The following describes the behavior of each filter.
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_external">m2h_external::filter
</a></h3>
<P>The filter extracts the data into a separate file and puts
a hyperlink to the file into the HTMLized message. The following
is an example how the link is formatted:
<dd><p><strong>Attachment:
<a href=
""><tt>blueball.gif
</tt></a></strong><br>
<em>Description:
</em> Blue ball GIF icon
</p>
<p>The description text is retrieved from the
<tt>Content-Disposition
</tt>
message header field, if defined. If not defined, a generic description
will be provided based on the specified content-type of the data.
<p>If the
<tt>useicon
</tt> filter argument has been specified for the
filter, the following format will be used:
<dl><dd><p><strong><a href=
"" ><img src=
"../monicon.png" align=
"left" border=
0 alt=
"Attachment:"></a>
<a href=
"" ><tt>blueball.gif
</tt></a></strong><br>
<em>Description:
</em> Blue ball GIF icon
</p>
<p>The actual icon used is based upon the
<a href=
"icons.html">ICONS
</a>
<P>By default, the filter ignores any filename specification
given in the message when writing the data to disk.
A unique filename with an extenstion based upon sub-type is
<p><strong><tt>m2h_external::filter
</tt></strong> can take the
<a href=
"mimeargs.html">arguments
</a>:
<table cellspacing=
1 border=
0 cellpadding=
4>
<td><strong><tt>excludeexts=
</tt></strong><var>ext1
</var><tt>,
</tt>...
</td>
<td><p>A comma separated list of message specified filename extensions
to exclude. I.e. If the filename extension matches an extension
in excludeexts, the content will not be written. The return markup
will contain the name of the attachment, but no link to the data.
This option is best used with application/octet-stream to exclude
unwanted data that is not tagged with the proper content-type. The
<a href=
"#m2h_null"><tt>m2h_null::filter
</tt></a> can be used to
exclude content by content-type.
<td><strong><tt>ext=
<var>ext
</var></tt></strong></td>
<td><p>Use
<var>ext
</var> as the filename extension.
The filter already has a large list of extensions for various
content-types. Use this argument if you process a
content-type not recognized by the filter.
<td><strong><tt>forceattach
</tt></strong></td>
<td><p>Force images to never be displayed inline, overriding any
Content-Disposition setting.
<td><strong><tt>forceinline
</tt></strong></td>
<td><p>Force images to be displayed inline, overriding any
Content-Disposition setting.
<td><strong><tt>frame
</tt></strong></td>
<td><p>Draw a frame around the attachment link.
<td><strong><tt>iconurl=
"<var>url</var>"</tt></strong></td>
<td><p>Use
"<var>url</var>" as the url for the icon to use
if the
<strong><tt>useicon
</tt></strong> option is set.
This option will override any setting defined by the
<a href=
"icons.html">ICONS
</a> resource.
The double quotes are required.
<td><strong><tt>inline
</tt></strong></td>
<td><p>Inline image data by default if content-disposition not defined.
<td><strong><tt>inlineexts=
</tt></strong><var>ext1
</var><tt>,
</tt>...
</td>
<td><p>A comma separated list of message specified filename
extensions to treat as possible inline data.
Applicable when content-type is not
<tt>image/
</tt><var>*
</var> and
<b><tt>usename
</tt></b> or
<b><tt>usenameext
</tt></b> is in effect.
<td><strong><tt>type=
"<var>description</var>"</tt></strong></td>
<td><p>Use
"<var>description</var>" as type description of the
data. The double quotes are required.
The filter already has a large list of descriptions for various
content-types. Use this argument if you process a
content-type not recognized by the filter.
<td><strong><tt>subdir
</tt></strong></td>
<td><p>Place derived file in a subdirectory of the archive.
The subdirectory will be called
"<tt>msg<var>MSGNUM</var></tt>".
This option may be useful if
<strong><tt>usename
</tt></strong> is
specified to avoid security and name conflict problems.
<td><strong><tt>target=
</tt></strong><var>name
</var></td>
<td><p>Set the TARGET attribute of anchor link to file
Default value is undefined (ie. no TARGET attribute will be
<td><strong><tt>useicon
</tt></strong></td>
<td><p>Include a content-type icon with the hyperlink to
the derived file. The icon used is the value of the
<strong><tt>iconurl
</tt></strong> option or the icon
defined by the
<a href=
"icons.html">ICONS
</a> resource.
<td><strong><tt>usename
</tt></strong></td>
<td><p>Use (file)name attribute for determining name
of derived file. Use this option with caution
since it can lead to filename conflicts and
security problems (however, see the
<strong><tt>subdir
</tt></strong><td><strong><tt>usenameext
</tt></strong></td>
<td><p>Use (file)name attribute for determining the extension
of derived file. Use this option with caution
security problems (however, see the
<strong><tt>subdir
</tt></strong><p>All arguments should be separated by at least one space.
</p>
<p>The following table shows the default list of content-types with the
filename extension used and a short
description that
<strong><tt>m2h_external::filter
</tt></strong><table border=
1 cellpadding=
1>
<th align=left
>Content-type
</th><th align=center
>Extension
</th><th align=left
>Description
</th></tr>
<td align=left
><strong>application/astound
</strong></td>
<td align=center
><tt>asd
</tt></td>
<td>Astound presentation
</td></tr>
<td align=left
><strong>application/envoy
</strong></td>
<td align=center
><tt>evy
</tt></td>
<td align=left
><strong>application/fastman
</strong></td>
<td align=center
><tt>lcc
</tt></td>
<td>fastman file
</td></tr>
<td align=left
><strong>application/fractals
</strong></td>
<td align=center
><tt>fif
</tt></td>
<td>Fractal Image Format
</td></tr>
<td align=left
><strong>application/iges
</strong></td>
<td align=center
><tt>iges
</tt></td>
<td align=left
><strong>application/mac-binhex40
</strong></td>
<td align=center
><tt>hqx
</tt></td>
<td>Mac BinHex archive
</td></tr>
<td align=left
><strong>application/mathematica
</strong></td>
<td align=center
><tt>ma
</tt></td>
<td>Mathematica Notebook document
</td></tr>
<td align=left
><strong>application/mbedlet
</strong></td>
<td align=center
><tt>mbd
</tt></td>
<td>mbedlet file
</td></tr>
<td align=left
><strong>application/ms-excel
</strong></td>
<td align=center
><tt>xls
</tt></td>
<td>MS-Excel spreadsheet
</td></tr>
<td align=left
><strong>application/ms-powerpoint
</strong></td>
<td align=center
><tt>ppt
</tt></td>
<td>MS-Powerpoint presentation
</td></tr>
<td align=left
><strong>application/ms-project
</strong></td>
<td align=center
><tt>mpp
</tt></td>
<td>MS-Project file
</td></tr>
<td align=left
><strong>application/msword
</strong></td>
<td align=center
><tt>doc
</tt></td>
<td>MS-Word document
</td></tr>
<td align=left
><strong>application/octet-stream
</strong></td>
<td align=center
><tt>bin
</tt></td>
<td>Binary data
</td></tr>
<td align=left
><strong>application/oda
</strong></td>
<td align=center
><tt>oda
</tt></td>
<td align=left
><strong>application/pdf
</strong></td>
<td align=center
><tt>pdf
</tt></td>
<td>Adobe PDF document
</td></tr>
<td align=left
><strong>application/pgp
</strong></td>
<td align=center
><tt>pgp
</tt></td>
<td>PGP message
</td></tr>
<td align=left
><strong>application/pgp-signature
</strong></td>
<td align=center
><tt>pgp
</tt></td>
<td>PGP signature
</td></tr>
<td align=left
><strong>application/postscript
</strong></td>
<td align=center
><tt>ps
</tt></td>
<td>PostScript document
</td></tr>
<td align=left
><strong>application/rtf
</strong></td>
<td align=center
><tt>rtf
</tt></td>
<td align=left
><strong>application/sgml
</strong></td>
<td align=center
><tt>sgml
</tt></td>
<td>SGML document
</td></tr>
<td align=left
><strong>application/studiom
</strong></td>
<td align=center
><tt>smp
</tt></td>
<td>Studio M file
</td></tr>
<td align=left
><strong>application/timbuktu
</strong></td>
<td align=center
><tt>tbt
</tt></td>
<td>timbuktu file
</td></tr>
<td align=left
><strong>application/vis5d
</strong></td>
<td align=center
><tt>v5d
</tt></td>
<td>Vis5D dataset
</td></tr>
<td align=left
><strong>application/vnd.framemaker
</strong></td>
<td align=center
><tt>fm
</tt></td>
<td>FrameMaker document
</td></tr>
<td align=left
><strong>application/vnd.hp-hpgl
</strong></td>
<td align=center
><tt>hpg
</tt></td>
<td align=left
><strong>application/vnd.lotus-
1-
2-
3</strong></td>
<td align=center
><tt>123</tt></td>
<td>Lotus
1-
2-
3</td></tr>
<td align=left
><strong>application/vnd.lotus-approach
</strong></td>
<td align=center
><tt>apr
</tt></td>
<td>Lotus Approach
</td></tr>
<td align=left
><strong>application/vnd.lotus-freelance
</strong></td>
<td align=center
><tt>prz
</tt></td>
<td>Lotus Freelance
</td></tr>
<td align=left
><strong>application/vnd.lotus-organizer
</strong></td>
<td align=center
><tt>org
</tt></td>
<td>Lotus Organizer
</td></tr>
<td align=left
><strong>application/vnd.lotus-screencam
</strong></td>
<td align=center
><tt>scm
</tt></td>
<td>Lotus Screencam
</td></tr>
<td align=left
><strong>application/vnd.lotus-wordpro
</strong></td>
<td align=center
><tt>lwp
</tt></td>
<td>Lotus WordPro
</td></tr>
<td align=left
><strong>application/vnd.mif
</strong></td>
<td align=center
><tt>mif
</tt></td>
<td>Frame MIF document
</td></tr>
<td align=left
><strong>application/vnd.ms-excel
</strong></td>
<td align=center
><tt>xls
</tt></td>
<td>MS-Excel spreadsheet
</td></tr>
<td align=left
><strong>application/vnd.ms-powerpoint
</strong></td>
<td align=center
><tt>ppt
</tt></td>
<td>MS-Powerpoint presentation
</td></tr>
<td align=left
><strong>application/vnd.ms-project
</strong></td>
<td align=center
><tt>mpp
</tt></td>
<td>MS-Project file
</td></tr>
<td align=left
><strong>application/vnd.stardivision.calc
</strong></td>
<td align=center
><tt>sdc
</tt></td>
<td>StarCalc spreadsheet
</td></tr>
<td align=left
><strong>application/vnd.stardivision.chart
</strong></td>
<td align=center
><tt>sds
</tt></td>
<td>StarChart document
</td></tr>
<td align=left
><strong>application/vnd.stardivision.draw
</strong></td>
<td align=center
><tt>sda
</tt></td>
<td>StarDraw document
</td></tr>
<td align=left
><strong>application/vnd.stardivision.impress
</strong></td>
<td align=center
><tt>sdd
</tt></td>
<td>StarImpress presentation
</td></tr>
<td align=left
><strong>application/vnd.stardivision.impress-packed
</strong></td>
<td align=center
><tt>sdp
</tt></td>
<td>StarImpress packed file
</td></tr>
<td align=left
><strong>application/vnd.stardivision.mail
</strong></td>
<td align=center
><tt>smd
</tt></td>
<td>StarMail mail file
</td></tr>
<td align=left
><strong>application/vnd.stardivision.math
</strong></td>
<td align=center
><tt>smf
</tt></td>
<td>StarMath document
</td></tr>
<td align=left
><strong>application/vnd.stardivision.writer
</strong></td>
<td align=center
><tt>sdw
</tt></td>
<td>StarWriter document
</td></tr>
<td align=left
><strong>application/vnd.stardivision.writer-global
</strong></td>
<td align=center
><tt>sgl
</tt></td>
<td>StarWriter global document
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.calc
</strong></td>
<td align=center
><tt>sxc
</tt></td>
<td>OpenOffice Calc spreadsheet
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.calc.template
</strong></td>
<td align=center
><tt>stc
</tt></td>
<td>OpenOffice Calc template
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.draw
</strong></td>
<td align=center
><tt>sxd
</tt></td>
<td>OpenOffice Draw document
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.draw.template
</strong></td>
<td align=center
><tt>std
</tt></td>
<td>OpenOffice Draw Template
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.impress
</strong></td>
<td align=center
><tt>sxi
</tt></td>
<td>OpenOffice Impress presentation
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.impress.template
</strong></td>
<td align=center
><tt>sti
</tt></td>
<td>OpenOffice Impress template
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.math
</strong></td>
<td align=center
><tt>sxm
</tt></td>
<td>OpenOffice Math documents
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.writer
</strong></td>
<td align=center
><tt>sxw
</tt></td>
<td>OpenOffice Writer document
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.writer.global
</strong></td>
<td align=center
><tt>sxg
</tt></td>
<td>OpenOffice Writer global document
</td></tr>
<td align=left
><strong>application/vnd.sun.xml.writer.template
</strong></td>
<td align=center
><tt>stw
</tt></td>
<td>OpenOffice Write template
</td></tr>
<td align=left
><strong>application/winhlp
</strong></td>
<td align=center
><tt>hlp
</tt></td>
<td>WinHelp document
</td></tr>
<td align=left
><strong>application/wordperfect5.1
</strong></td>
<td align=center
><tt>wp
</tt></td>
<td>WordPerfect
5.1 document
</td></tr>
<td align=left
><strong>application/x-asap
</strong></td>
<td align=center
><tt>asp
</tt></td>
<td align=left
><strong>application/x-bcpio
</strong></td>
<td align=center
><tt>bcpio
</tt></td>
<td align=left
><strong>application/x-bzip2
</strong></td>
<td align=center
><tt>bz2
</tt></td>
<td>BZip2 compressed data
</td></tr>
<td align=left
><strong>application/x-compress
</strong></td>
<td align=center
><tt>Z
</tt></td>
<td>Unix compressed data
</td></tr>
<td align=left
><strong>application/x-cpio
</strong></td>
<td align=center
><tt>cpio
</tt></td>
<td align=left
><strong>application/x-csh
</strong></td>
<td align=center
><tt>csh
</tt></td>
<td>C-Shell script
</td></tr>
<td align=left
><strong>application/x-dot
</strong></td>
<td align=center
><tt>dot
</tt></td>
<td align=left
><strong>application/x-dvi
</strong></td>
<td align=center
><tt>dvi
</tt></td>
<td>TeX dvi file
</td></tr>
<td align=left
><strong>application/x-earthtime
</strong></td>
<td align=center
><tt>etc
</tt></td>
<td>Earthtime file
</td></tr>
<td align=left
><strong>application/x-envoy
</strong></td>
<td align=center
><tt>evy
</tt></td>
<td align=left
><strong>application/x-excel
</strong></td>
<td align=center
><tt>xls
</tt></td>
<td>MS-Excel spreadsheet
</td></tr>
<td align=left
><strong>application/x-gtar
</strong></td>
<td align=center
><tt>gtar
</tt></td>
<td>GNU Unix tar archive
</td></tr>
<td align=left
><strong>application/x-gzip
</strong></td>
<td align=center
><tt>gz
</tt></td>
<td>GNU Zip compressed data
</td></tr>
<td align=left
><strong>application/x-hdf
</strong></td>
<td align=center
><tt>hdf
</tt></td>
<td align=left
><strong>application/x-javascript
</strong></td>
<td align=center
><tt>js
</tt></td>
<td>JavaScript source
</td></tr>
<td align=left
><strong>application/x-ksh
</strong></td>
<td align=center
><tt>ksh
</tt></td>
<td>Korn Shell script
</td></tr>
<td align=left
><strong>application/x-latex
</strong></td>
<td align=center
><tt>latex
</tt></td>
<td>LaTeX document
</td></tr>
<td align=left
><strong>application/x-maker
</strong></td>
<td align=center
><tt>fm
</tt></td>
<td>FrameMaker document
</td></tr>
<td align=left
><strong>application/x-mif
</strong></td>
<td align=center
><tt>mif
</tt></td>
<td>Frame MIF document
</td></tr>
<td align=left
><strong>application/x-mocha
</strong></td>
<td align=center
><tt>moc
</tt></td>
<td align=left
><strong>application/x-msaccess
</strong></td>
<td align=center
><tt>mdb
</tt></td>
<td>MS-Access database
</td></tr>
<td align=left
><strong>application/x-mscardfile
</strong></td>
<td align=center
><tt>crd
</tt></td>
<td>MS-CardFile
</td></tr>
<td align=left
><strong>application/x-msclip
</strong></td>
<td align=center
><tt>clp
</tt></td>
<td>MS-Clip file
</td></tr>
<td align=left
><strong>application/x-msmediaview
</strong></td>
<td align=center
><tt>m14
</tt></td>
<td>MS-Media View file
</td></tr>
<td align=left
><strong>application/x-msmetafile
</strong></td>
<td align=center
><tt>wmf
</tt></td>
<td>MS-Metafile
</td></tr>
<td align=left
><strong>application/x-msmoney
</strong></td>
<td align=center
><tt>mny
</tt></td>
<td>MS-Money file
</td></tr>
<td align=left
><strong>application/x-mspublisher
</strong></td>
<td align=center
><tt>pub
</tt></td>
<td>MS-Publisher document
</td></tr>
<td align=left
><strong>application/x-msschedule
</strong></td>
<td align=center
><tt>scd
</tt></td>
<td>MS-Schedule file
</td></tr>
<td align=left
><strong>application/x-msterminal
</strong></td>
<td align=center
><tt>trm
</tt></td>
<td>MS-Terminal
</td></tr>
<td align=left
><strong>application/x-mswrite
</strong></td>
<td align=center
><tt>wri
</tt></td>
<td>MS-Write document
</td></tr>
<td align=left
><strong>application/x-net-install
</strong></td>
<td align=center
><tt>ins
</tt></td>
<td>Net Install file
</td></tr>
<td align=left
><strong>application/x-netcdf
</strong></td>
<td align=center
><tt>cdf
</tt></td>
<td align=left
><strong>application/x-ns-proxy-autoconfig
</strong></td>
<td align=center
><tt>proxy
</tt></td>
<td>Netscape Proxy Auto Config
</td></tr>
<td align=left
><strong>application/x-patch
</strong></td>
<td align=center
><tt>patch
</tt></td>
<td>Source code patch
</td></tr>
<td align=left
><strong>application/x-perl
</strong></td>
<td align=center
><tt>pl
</tt></td>
<td>Perl program
</td></tr>
<td align=left
><strong>application/x-pointplus
</strong></td>
<td align=center
><tt>css
</tt></td>
<td>pointplus file
</td></tr>
<td align=left
><strong>application/x-salsa
</strong></td>
<td align=center
><tt>slc
</tt></td>
<td align=left
><strong>application/x-script
</strong></td>
<td align=center
><tt>script
</tt></td>
<td>A script file
</td></tr>
<td align=left
><strong>application/x-sh
</strong></td>
<td align=center
><tt>sh
</tt></td>
<td>Bourne shell script
</td></tr>
<td align=left
><strong>application/x-shar
</strong></td>
<td align=center
><tt>shar
</tt></td>
<td>Unix shell archive
</td></tr>
<td align=left
><strong>application/x-sprite
</strong></td>
<td align=center
><tt>spr
</tt></td>
<td>sprite file
</td></tr>
<td align=left
><strong>application/x-stuffit
</strong></td>
<td align=center
><tt>sit
</tt></td>
<td>Macintosh archive
</td></tr>
<td align=left
><strong>application/x-sv4cpio
</strong></td>
<td align=center
><tt>sv4cpio
</tt></td>
<td>SV4Cpio file
</td></tr>
<td align=left
><strong>application/x-sv4crc
</strong></td>
<td align=center
><tt>sv4crc
</tt></td>
<td>SV4Crc file
</td></tr>
<td align=left
><strong>application/x-tar
</strong></td>
<td align=center
><tt>tar
</tt></td>
<td>Unix tar archive
</td></tr>
<td align=left
><strong>application/x-tcl
</strong></td>
<td align=center
><tt>tcl
</tt></td>
<td align=left
><strong>application/x-tex
</strong></td>
<td align=center
><tt>tex
</tt></td>
<td>TeX document
</td></tr>
<td align=left
><strong>application/x-texinfo
</strong></td>
<td align=center
><tt>texinfo
</tt></td>
<td>TeXInfo document
</td></tr>
<td align=left
><strong>application/x-timbuktu
</strong></td>
<td align=center
><tt>tbp
</tt></td>
<td>timbuktu file
</td></tr>
<td align=left
><strong>application/x-tkined
</strong></td>
<td align=center
><tt>tki
</tt></td>
<td>tkined file
</td></tr>
<td align=left
><strong>application/x-troff
</strong></td>
<td align=center
><tt>roff
</tt></td>
<td>Troff document
</td></tr>
<td align=left
><strong>application/x-troff-man
</strong></td>
<td align=center
><tt>man
</tt></td>
<td>Unix manual page
</td></tr>
<td align=left
><strong>application/x-troff-me
</strong></td>
<td align=center
><tt>me
</tt></td>
<td>Troff ME-macros document
</td></tr>
<td align=left
><strong>application/x-troff-ms
</strong></td>
<td align=center
><tt>ms
</tt></td>
<td>Troff MS-macros document
</td></tr>
<td align=left
><strong>application/x-ustar
</strong></td>
<td align=center
><tt>ustar
</tt></td>
<td align=left
><strong>application/x-wais-source
</strong></td>
<td align=center
><tt>src
</tt></td>
<td>WAIS Source
</td></tr>
<td align=left
><strong>application/x-zip-compressed
</strong></td>
<td align=center
><tt>zip
</tt></td>
<td>Zip compressed data
</td></tr>
<td align=left
><strong>application/zip
</strong></td>
<td align=center
><tt>zip
</tt></td>
<td>Zip archive
</td></tr>
<td align=left
><strong>audio/basic
</strong></td>
<td align=center
><tt>snd
</tt></td>
<td>Basic audio
</td></tr>
<td align=left
><strong>audio/echospeech
</strong></td>
<td align=center
><tt>es
</tt></td>
<td>Echospeech audio
</td></tr>
<td align=left
><strong>audio/microsoft-wav
</strong></td>
<td align=center
><tt>wav
</tt></td>
<td align=left
><strong>audio/midi
</strong></td>
<td align=center
><tt>midi
</tt></td>
<td align=left
><strong>audio/wav
</strong></td>
<td align=center
><tt>wav
</tt></td>
<td align=left
><strong>audio/x-aiff
</strong></td>
<td align=center
><tt>aif
</tt></td>
<td align=left
><strong>audio/x-epac
</strong></td>
<td align=center
><tt>pae
</tt></td>
<td align=left
><strong>audio/x-midi
</strong></td>
<td align=center
><tt>midi
</tt></td>
<td align=left
><strong>audio/x-mpeg
</strong></td>
<td align=center
><tt>mp2
</tt></td>
<td align=left
><strong>audio/x-pac
</strong></td>
<td align=center
><tt>pac
</tt></td>
<td align=left
><strong>audio/x-pn-realaudio
</strong></td>
<td align=center
><tt>ra
</tt></td>
<td>PN Realaudio
</td></tr>
<td align=left
><strong>audio/x-wav
</strong></td>
<td align=center
><tt>wav
</tt></td>
<td align=left
><strong>chemical/chem3d
</strong></td>
<td align=center
><tt>c3d
</tt></td>
<td>Chem3d chemical test
</td></tr>
<td align=left
><strong>chemical/chemdraw
</strong></td>
<td align=center
><tt>chm
</tt></td>
<td>Chemdraw chemical test
</td></tr>
<td align=left
><strong>chemical/cif
</strong></td>
<td align=center
><tt>cif
</tt></td>
<td>CIF chemical test
</td></tr>
<td align=left
><strong>chemical/cml
</strong></td>
<td align=center
><tt>cml
</tt></td>
<td>CML chemical test
</td></tr>
<td align=left
><strong>chemical/cmsl
</strong></td>
<td align=center
><tt>cml
</tt></td>
<td>Chemical Structure Markup
</td></tr>
<td align=left
><strong>chemical/cxf
</strong></td>
<td align=center
><tt>cxf
</tt></td>
<td>Chemical Exhange Format file
</td></tr>
<td align=left
><strong>chemical/daylight-smiles
</strong></td>
<td align=center
><tt>smi
</tt></td>
<td>SMILES format file
</td></tr>
<td align=left
><strong>chemical/embl-dl-nucleotide
</strong></td>
<td align=center
><tt>emb
</tt></td>
<td>EMBL nucleotide format file
</td></tr>
<td align=left
><strong>chemical/gaussian
</strong></td>
<td align=center
><tt>gau
</tt></td>
<td>Gaussian data
</td></tr>
<td align=left
><strong>chemical/gaussian-input
</strong></td>
<td align=center
><tt>gau
</tt></td>
<td>Gaussian input data
</td></tr>
<td align=left
><strong>chemical/gaussian-log
</strong></td>
<td align=center
><tt>gal
</tt></td>
<td>Gaussian log
</td></tr>
<td align=left
><strong>chemical/gcg8-sequence
</strong></td>
<td align=center
><tt>gcg
</tt></td>
<td>GCG format file
</td></tr>
<td align=left
><strong>chemical/genbank
</strong></td>
<td align=center
><tt>gen
</tt></td>
<td>GENbank data
</td></tr>
<td align=left
><strong>chemical/jcamp-dx
</strong></td>
<td align=center
><tt>jdx
</tt></td>
<td>Jcamp chemical spectra test
</td></tr>
<td align=left
><strong>chemical/kinemage
</strong></td>
<td align=center
><tt>kin
</tt></td>
<td align=left
><strong>chemical/macromodel-input
</strong></td>
<td align=center
><tt>mmd
</tt></td>
<td>Macromodel chemical test
</td></tr>
<td align=left
><strong>chemical/mdl-molfile
</strong></td>
<td align=center
><tt>mol
</tt></td>
<td>MOL mdl chemical test
</td></tr>
<td align=left
><strong>chemical/mdl-rdf
</strong></td>
<td align=center
><tt>rdf
</tt></td>
<td>RDF chemical test
</td></tr>
<td align=left
><strong>chemical/mdl-rxn
</strong></td>
<td align=center
><tt>rxn
</tt></td>
<td>RXN chemical test
</td></tr>
<td align=left
><strong>chemical/mdl-sdf
</strong></td>
<td align=center
><tt>sdf
</tt></td>
<td>SDF chemical test
</td></tr>
<td align=left
><strong>chemical/mdl-tgf
</strong></td>
<td align=center
><tt>tgf
</tt></td>
<td>TGF chemical test
</td></tr>
<td align=left
><strong>chemical/mif
</strong></td>
<td align=center
><tt>mif
</tt></td>
<td>MIF chemical test
</td></tr>
<td align=left
><strong>chemical/mmd
</strong></td>
<td align=center
><tt>mmd
</tt></td>
<td>Macromodel data
</td></tr>
<td align=left
><strong>chemical/mopac-input
</strong></td>
<td align=center
><tt>mop
</tt></td>
<td>MOPAC data
</td></tr>
<td align=left
><strong>chemical/ncbi-asn1
</strong></td>
<td align=center
><tt>asn
</tt></td>
<td align=left
><strong>chemical/pdb
</strong></td>
<td align=center
><tt>pdb
</tt></td>
<td>Protein Databank data
</td></tr>
<td align=left
><strong>chemical/rosdal
</strong></td>
<td align=center
><tt>ros
</tt></td>
<td>Rosdal data
</td></tr>
<td align=left
><strong>chemical/xyz
</strong></td>
<td align=center
><tt>xyz
</tt></td>
<td>Xmol XYZ data
</td></tr>
<td align=left
><strong>image/bmp
</strong></td>
<td align=center
><tt>bmp
</tt></td>
<td>Windows bitmap
</td></tr>
<td align=left
><strong>image/cgm
</strong></td>
<td align=center
><tt>cgm
</tt></td>
<td>Computer Graphics Metafile
</td></tr>
<td align=left
><strong>image/fif
</strong></td>
<td align=center
><tt>fif
</tt></td>
<td>Fractal Image Format image
</td></tr>
<td align=left
><strong>image/g3fax
</strong></td>
<td align=center
><tt>g3f
</tt></td>
<td>Group III FAX image
</td></tr>
<td align=left
><strong>image/gif
</strong></td>
<td align=center
><tt>gif
</tt></td>
<td align=left
><strong>image/ief
</strong></td>
<td align=center
><tt>ief
</tt></td>
<td align=left
><strong>image/ifs
</strong></td>
<td align=center
><tt>ifs
</tt></td>
<td align=left
><strong>image/jpeg
</strong></td>
<td align=center
><tt>jpg
</tt></td>
<td align=left
><strong>image/pbm
</strong></td>
<td align=center
><tt>pbm
</tt></td>
<td>Portable bitmap
</td></tr>
<td align=left
><strong>image/pgm
</strong></td>
<td align=center
><tt>pgm
</tt></td>
<td>Portable graymap
</td></tr>
<td align=left
><strong>image/png
</strong></td>
<td align=center
><tt>png
</tt></td>
<td align=left
><strong>image/tiff
</strong></td>
<td align=center
><tt>tif
</tt></td>
<td align=left
><strong>image/vnd
</strong></td>
<td align=center
><tt>dwg
</tt></td>
<td align=left
><strong>image/wavelet
</strong></td>
<td align=center
><tt>wi
</tt></td>
<td>Wavelet image
</td></tr>
<td align=left
><strong>image/x-cmu-raster
</strong></td>
<td align=center
><tt>ras
</tt></td>
<td align=left
><strong>image/x-pbm
</strong></td>
<td align=center
><tt>pbm
</tt></td>
<td>Portable bitmap
</td></tr>
<td align=left
><strong>image/x-pcx
</strong></td>
<td align=center
><tt>pcx
</tt></td>
<td align=left
><strong>image/x-pgm
</strong></td>
<td align=center
><tt>pgm
</tt></td>
<td>Portable graymap
</td></tr>
<td align=left
><strong>image/x-pict
</strong></td>
<td align=center
><tt>pict
</tt></td>
<td>Mac PICT image
</td></tr>
<td align=left
><strong>image/x-pnm
</strong></td>
<td align=center
><tt>pnm
</tt></td>
<td>Portable anymap
</td></tr>
<td align=left
><strong>image/x-portable-anymap
</strong></td>
<td align=center
><tt>pnm
</tt></td>
<td>Portable anymap
</td></tr>
<td align=left
><strong>image/x-portable-bitmap
</strong></td>
<td align=center
><tt>pbm
</tt></td>
<td>Portable bitmap
</td></tr>
<td align=left
><strong>image/x-portable-graymap
</strong></td>
<td align=center
><tt>pgm
</tt></td>
<td>Portable graymap
</td></tr>
<td align=left
><strong>image/x-portable-pixmap
</strong></td>
<td align=center
><tt>ppm
</tt></td>
<td>Portable pixmap
</td></tr>
<td align=left
><strong>image/x-ppm
</strong></td>
<td align=center
><tt>ppm
</tt></td>
<td>Portable pixmap
</td></tr>
<td align=left
><strong>image/x-rgb
</strong></td>
<td align=center
><tt>rgb
</tt></td>
<td align=left
><strong>image/x-xbitmap
</strong></td>
<td align=center
><tt>xbm
</tt></td>
<td align=left
><strong>image/x-xbm
</strong></td>
<td align=center
><tt>xbm
</tt></td>
<td align=left
><strong>image/x-xpixmap
</strong></td>
<td align=center
><tt>xpm
</tt></td>
<td align=left
><strong>image/x-xpm
</strong></td>
<td align=center
><tt>xpm
</tt></td>
<td align=left
><strong>image/x-xwd
</strong></td>
<td align=center
><tt>xwd
</tt></td>
<td>X window dump
</td></tr>
<td align=left
><strong>image/x-xwindowdump
</strong></td>
<td align=center
><tt>xwd
</tt></td>
<td>X window dump
</td></tr>
<td align=left
><strong>message/news
</strong></td>
<td align=center
><tt>822</tt></td>
<td align=left
><strong>message/rfc822
</strong></td>
<td align=center
><tt>822</tt></td>
<td>Mail message
</td></tr>
<td align=left
><strong>model/iges
</strong></td>
<td align=center
><tt>iges
</tt></td>
<td align=left
><strong>model/mesh
</strong></td>
<td align=center
><tt>mesh
</tt></td>
<td align=left
><strong>model/vrml
</strong></td>
<td align=center
><tt>wrl
</tt></td>
<td align=left
><strong>text/enriched
</strong></td>
<td align=center
><tt>rtx
</tt></td>
<td>Text-enriched document
</td></tr>
<td align=left
><strong>text/html
</strong></td>
<td align=center
><tt>html
</tt></td>
<td>HTML document
</td></tr>
<td align=left
><strong>text/plain
</strong></td>
<td align=center
><tt>txt
</tt></td>
<td>Text document
</td></tr>
<td align=left
><strong>text/richtext
</strong></td>
<td align=center
><tt>rtx
</tt></td>
<td>Richtext document
</td></tr>
<td align=left
><strong>text/setext
</strong></td>
<td align=center
><tt>stx
</tt></td>
<td>Setext document
</td></tr>
<td align=left
><strong>text/sgml
</strong></td>
<td align=center
><tt>sgml
</tt></td>
<td>SGML document
</td></tr>
<td align=left
><strong>text/tab-separated-values
</strong></td>
<td align=center
><tt>tsv
</tt></td>
<td>Tab separated values
</td></tr>
<td align=left
><strong>text/x-speech
</strong></td>
<td align=center
><tt>talk
</tt></td>
<td>Speech document
</td></tr>
<td align=left
><strong>video/isivideo
</strong></td>
<td align=center
><tt>fvi
</tt></td>
<td align=left
><strong>video/mpeg
</strong></td>
<td align=center
><tt>mpg
</tt></td>
<td align=left
><strong>video/msvideo
</strong></td>
<td align=center
><tt>avi
</tt></td>
<td align=left
><strong>video/quicktime
</strong></td>
<td align=center
><tt>mov
</tt></td>
<td>QuickTime movie
</td></tr>
<td align=left
><strong>video/vivo
</strong></td>
<td align=center
><tt>viv
</tt></td>
<td align=left
><strong>video/wavelet
</strong></td>
<td align=center
><tt>wv
</tt></td>
<td>Wavelet video
</td></tr>
<td align=left
><strong>video/x-sgi-movie
</strong></td>
<td align=center
><tt>movie
</tt></td>
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_msg_extbody">m2h_msg_extbody::filter
</a></h3>
<p>This filter is designed to process
<tt>message/external-body
</tt>
The filter attempts to translate the external-body paramaters
into a linked URL with some descriptive information,
if provided. The following access-types are supported:
ANON-FTP, FTP, TFTP, LOCAL-FILE, and URL. Note, LOCAL-FILE is
only supported if the
<tt>local-file
</tt> option is specified.
<p><strong><tt>m2h_msg_extbody::filter
</tt></strong> can take the
<a href=
"mimeargs.html">arguments
</a>:
<table cellspacing=
1 border=
0 cellpadding=
4>
<td><strong><tt>local-file
</tt></strong></td>
<td><p>Support LOCAL-FILE access-type. This option
is best used for internal local mail archives
where it is known that readers will have
direct access to the file.
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_text_enriched">m2h_text_enriched::filter
</a></h3>
<p>This filter is designed to process text/enriched, or
text/richtext, data. The following table summarizes the
translation of text/enriched commands to HTML tags:
<table border=
1 cellpadding=
2>
<tr valign=top align=left
bgcolor=
"#C0C0C0">
<th>Text/Enriched Command
</th><th>HTML Translation
</th>
<td><strong><Bold
></strong></td>
<td><strong><Italic
></strong></td>
<td><strong><Underline
></strong></td>
<td><strong><Fixed
></strong></td>
<td><strong><Smaller
></strong></td>
<td><strong><Bigger
></strong></td>
<td><strong><FontFamily
><Param
><var>family
</var></Param
></strong></td>
<td><FONT
face=
"<var>family</var>"></td>
<td><strong><Color
><Param
><var>color
</var></Param
></strong></td>
<td><FONT
color=
"<var>color</var>"></td>
<td><strong><Center
></strong></td>
<td><P
align=
"center"></td>
<td><strong><FlushLeft
></strong></td>
<td><P
align=
"left"></td>
<td><strong><FlushRight
></strong></td>
<td><P
align=
"right"></td>
<td><strong><FlushBoth
></strong></td>
<td><P
align=
"both"> <em>(not supported in HTML)
</em></td>
<td><strong><ParaIndent
></strong></td>
<td><BLOCKQUOTE
></td>
<td><strong><Excerpt
></strong></td>
<td><BLOCKQUOTE
></td>
<td><strong><Lang
></strong></td>
<td><em>Stripped
</em></td>
<p>If the text/enriched contains non-ASCII character, the filter will
convert the characters to the appropriate entity references.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>Only the ISO-
8859-[
1-
10] character sets are recognized.
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_text_html">m2h_text_html::filter
</a></h3>
<table border=
0 cellpadding=
4>
<td><strong><font color=
"red">CAUTION
</font></strong></td>
If you are worried about security, it is recommended that you disable
support of text/html messages in your mail archives. There is no
guarantee that this filter is robust enough to eliminate all possible
exploits that can occur with HTML data.
<p>This filter is designed to process
<tt>text/html
</tt>, or
<tt>text/x-html
</tt>, data.
The filter modifies HTML documents so they can be
included into the message pages without causing invalid markup
to occur. The following modification are done to HTML documents when
<li><p>The HEAD element is removed. Since some elements within the HEAD
element may be relevant to the rest of the document, the following is
done when removing the HEAD element:
</p> <li>The title will be extracted and prepended
<li>Any BASE URL will be propogated to any relative URLs in the
<li><p>Any markup related to scripting is removed for security
reasons. The following tags are removed:
<tt><textarea
></tt>.
The following attributes are removed:
The
<strong><tt>allowscript
</tt></strong> option can be
be used to override this behavior (see below).
<li><p><b><tt>cid:
</tt></b> URLs are resolved, if possible. Therefore,
if image data related to the HTML document is included with the message,
the URLs will be modified to the filenames of the images that were
<p><strong><tt>m2h_text_html::filter
</tt></strong> can take the
<a href=
"mimeargs.html">arguments
</a>:
<table cellspacing=
1 border=
0 cellpadding=
4>
<td><strong><tt>allowcomments
</tt></strong></td>
<td><p>Preserve any comment declarations. Comment declarations
are sometimes used to contain executable commands, like for
server-side includes. Normally, comment declarations are munged
to protect against potential exploits, but this option will
disable that behavior. Use this options with
<strong>EXTREME
</strong><td><strong><tt>allownoncidurls
</tt></strong></td>
<td><p>Preserve URL-based attributes that are not cid: URLs.
Normally, any URL-based attribute --
<tt>href
</tt>,
<tt>src
</tt>,
<tt>background
</tt>,
<tt>classid
</tt>,
<tt>data
</tt>,
<tt>longdesc
</tt>
-- will be stripped if it is not a cid: URL. This is to prevent
malicious URLs that verify mail addresses for spam purposes, secretly
set cookies, or gather some statistical data automatically with the
use of elements that cause browsers to automatically fetch data:
<tt>IMG
</tt>,
<tt>BODY
</tt>,
<tt>IFRAME
</tt>,
<tt>FRAME
</tt>,
<tt>OBJECT
</tt>,
<tt>SCRIPT
</tt>,
<tt>INPUT
</tt>.
<td><strong><tt>allowscript
</tt></strong></td>
<td><p>Preserve any markup associated with scripting.
This includes elements and attributes related to scripting. This option
can cause security problems for your archive since someone can introduce
foreign client-side code. Use this options with
<strong>EXTREME
</strong><td><strong><tt>attachcheck
</tt></strong></td>
<td><p>Honor attachment disposition. By default,
all text/html data is displayed inline on
the message page. If
<tt>attachcheck
</tt> is specified
and Content-Disposition specifies the data as
an attachment, the data is saved to a file
with a link to it from the message page.
<p><b>CAUTION:
</b> If
<tt>attachcheck
</tt> is specified, the HTML
data is saved
"as-is". For example, no stripping of scripting-based
markup is performed and no resolution of cid URLs are performed.
<td><strong><tt>nofont
</tt></strong></td>
<td><strong><tt>notitle
</tt></strong></td>
<td><p>Do not print extracted title at the beginning of converted
output. Since this filter strips out HEAD markup so the document
can be included into the message page, this filter will extract
the title and print the title of the document before the document
body. The
<tt>notitle
</tt> argument disables this behavior.
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_text_plain">m2h_text_plain::filter
</a></h3>
<p>This filter is designed to process text/plain messages and
messages with no MIME information. The
filter is also used to process text messages of an unknown
<p>The default behavior of the filter is wrap the data in
the HTML PRE element and escape special characters. It will
also convert text that looks like a URL into a hyperlink.
If the data contains non-ASCII character, the filter will
convert the characters to the appropriate entity reference.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>The functions registered via the
<a href=
"charsetconverters.html">CHARSETCONVERTERS
</a> are used
to handle character set processing.
<p><strong><tt>m2h_text_plain::filter
</tt></strong> can take the
<a href=
"mimeargs.html">arguments
</a>:
<table cellspacing=
1 border=
0 cellpadding=
4>
<td><strong><tt>asis=
</tt></strong><var>set1
</var><tt>:
</tt>...
</td>
<td><p>Colon separated lists of charsets to leave as-is.
Only HTML special characters will be converted into entities.
The default is
"<tt>us-ascii:iso-8859-1</tt>".
<td><strong><tt>attachcheck
</tt></strong></td>
<td><p>Honor attachment disposition. By default,
all text/plain data is displayed inline on
the message page. If
<tt>attachcheck
</tt> is specified
and Content-Disposition specifies the data as
an attachment, the data is saved to a file
with a link to it from the message page.
<td><strong><tt>default=
</tt></strong><var>charset
</var></td>
<td><p>Character set to use as the default if no character set
is defined for the message. If option not specified,
"<tt>us-ascii</tt>" is used.
<td><strong><tt>inlineexts=
</tt></strong><var>ext1
</var><tt>,
</tt>...
</td>
<td><p>A comma separated list of message specified filename
extensions to treat as inline data.
Applicable only when
<b><tt>uudecode
</tt></b> is specified.
<td><strong><tt>htmlcheck
</tt></strong></td>
<td><p>Check if message is actually an HTML message
(to get around abhorrent MUAs). The message
is treated as HTML if the first non-whitespace
data looks like the start of an HTML document.
<td><strong><tt>keepspace
</tt></strong></td>
<td><p>Preserve all spaces if the
<strong><tt>nonfixed
</tt></strong>
option is specified. All spaces and tabs will be translated to the
equivalent number of
<strong>&nbsp;
</strong> entity references.
<td><strong><tt>maxwidth=
</tt></strong><var>#
</var></td>
<td><p>Force the maximum width of lines to be
<var>#
</var> characters
in length. Any lines longer than
<var>#
</var> characters will be
<td><strong><tt>nonfixed
</tt></strong></td>
<td><p>Do not wrap message text in the HTML PRE element. This will
cause text to be rendered in the default font (which is normally
proportionally spaced). Each line of the message will have
a
<tt><BR
></tt> appended in order to preserve the line representation
<td><strong><tt>nourl
</tt></strong></td>
<td><p>Do not hyperlink URLs.
<td><strong><tt>quote
</tt></strong></td>
<td><p>Italicize quoted message text.
<td><strong><tt>target=
</tt></strong><var>name
</var></td>
<td><p>Set the TARGET attribute of an anchor links generated from
<td><strong><tt>usename
</tt></strong></td>
<td><p>When decoding uuencoded data, use the full filename specified
when write the data to disk instead of just the filename extension.
<b>Note:
</b> Be aware that there are potential security problems when
<td><strong><tt>uudecode
</tt></strong></td>
<td><p>Decode any embedded uuencoded data. Including uuencoded data
within messages was a way to trasmit binary data
via email before MIME was developed. The inclusion of uuencoded
data is deprecated within email, but is still common in the
USENET (binary) newsgroups. Note, specifying
<b><tt>uudecode
</tt></b>overhead in the processing of text messages, including messages without
<p>Uuencoded data is treated as
<tt>application/octet-stream
</tt>
data for purposes of checking if the data should be excluded when
checked against the
<a href=
"mimeexcs.html">MIMEEXCS
</a> resource.
Therefore, if
<tt>application/octet-stream
</tt> data is listed
in MIMEEXCS, uuencoded data will be excluded.
<p>All arguments should be separated by at least one space.
</p>
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_text_setext">m2h_text_setext::filter
</a></h3>
<p>This filter converts text/setext and text/x-setext messages
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_text_tsv">m2h_text_tsv::filter
</a></h3>
<p>This filter converts text/tab-separated-values to HTML. The
tabular data will be converted into an HTML table.
<hr size=
0 noshade
width=
"50%">
<H3><a name=
"m2h_null">m2h_null::filter
</a></h3>
<p>This filter can be used to exclude message content from archives.
You can register this filter to any content-type you do not want
to store in your archives. For example, the following resource setting
<b><MIMEFilters
></b>
image/*; m2h_null::filter
</a>; mhnull.pl
<b></MIMEFilters
></b>
<p>The markup returned by this filter displays the a one line description
of what was excluded. Examples:
<<attachment: HelloWorld.jpg
>>
<<application/postscript
>>
<<inline: image/jpg
>>
<p>If the disposition is available, it will be shown. If a filename
was specified, it will be shown. If there was no filename, the
<!-- *************************************************************** -->
<h2>Resource Variables
</h2>
<!-- *************************************************************** -->
<p>The following code is an example filter for converting
<tt>text/tab-separated-values
</tt> into an HTML table:
my($fields, $data, $isdecode, $args) = @_;
$ret =
"<table border=1>\n";
foreach $line (split(/\r?\n/, $$data)) {
foreach $field (split(/\t/, $line)) {
$ret .=
"<td>$field</td>";
$ret .=
"</table>\n";
<!-- *************************************************************** -->
<!-- *************************************************************** -->
<a href=
"charsetconverters.html">CHARSETCONVERTERS
</a>,
<a href=
"mimeargs.html">MIMEARGS
</a>,
<a href=
"mimedecoders.html">MIMEDECODERS
</a>,
<a href=
"mimeexcs.html">MIMEEXCS
</a>,
<a href=
"perlinc.html">PERLINC
</a>
<!-- *************************************************************** -->
<table border=
0><tr valign=
"top">
<td align=
"left" width=
"50%">[Prev:
<a href=
"mimeexcs.html">MIMEEXCS
</a>]
</td><td><nobr>[
<a href=
"../resources.html#mimefilters">Resources
</a>][
<a href=
"../mhonarc.html">TOC
</a>]
</nobr></td><td align=
"right" width=
"50%">[Next:
<a href=
"modtime.html">MODTIME
</a>]
</td></tr></table>
$Date:
2002/
10/
21 16:
55:
19 $
<br><img align=
"top" src=
"../monicon.png" alt=
"">
<a href=
"http://www.mhonarc.org"><strong>MHonArc
</strong></a><br>
Copyright
© 1997-
2001 <a href=
"http://www.mhonarc.org/~ehood/">Earl Hood
</a>,
<a href=
"mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org
</a><br>
projects / OpenSPARC-T2-DV / blob