Debian Codegraph @

doc/resources/mimefilters.html

raw
1 <html>
2 <head>
3 <title>MHonArc Resources: MIMEFILTERS</title>
4 <link rel="stylesheet" type="text/css" href="../docstyles.css">
5 </head>
6 <body>
7 <!--x-rc-nav-->
8 <table border=0><tr valign="top">
9 <td align="left" width="50%">[Prev:&nbsp;<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:&nbsp;<a href="mimeincs.html">MIMEINCS</a>]</td></tr></table>
10 <!--/x-rc-nav-->
11 <hr>
12 <h1>MIMEFILTERS</h1>
13 <!--X-TOC-Start-->
14 <ul>
15 <li><a href="#syntax">Syntax</a>
16 <li><a href="#description">Description</a>
17 <ul>
18 <li><small><a href="#defaultfilters">Default Filters</a></small>
19 <li><small><a href="#writefilters">Writing Filters</a></small>
20 </ul>
21 <li><a href="#filters">Available Filters</a>
22 <ul>
23 <li><small><a href="#m2h_external">m2h_external::filter</a></small>
24 <li><small><a href="#m2h_msg_extbody">m2h_msg_extbody::filter</a></small>
25 <li><small><a href="#m2h_text_enriched">m2h_text_enriched::filter</a></small>
26 <li><small><a href="#m2h_text_html">m2h_text_html::filter</a></small>
27 <li><small><a href="#m2h_text_plain">m2h_text_plain::filter</a></small>
28 <li><small><a href="#m2h_text_tsv">m2h_text_tsv::filter</a></small>
29 <li><small><a href="#m2h_null">m2h_null::filter</a></small>
30 </ul>
31 <li><a href="#default">Default Setting</a>
32 <li><a href="#rcvars">Resource Variables</a>
33 <li><a href="#examples">Examples</a>
34 <li><a href="#version">Version</a>
35 <li><a href="#seealso">See Also</a>
36 </ul>
37 <!--X-TOC-End-->
38
39 <!-- *************************************************************** -->
40 <hr>
41 <h2><a name="syntax">Syntax</a></h2>
42
43 <dl>
44
45 <dt><strong>Envariable</strong></dt>
46 <dd><p>N/A
47 </p>
48 </dd>
49
50 <dt><strong>Element</strong></dt>
51 <dd><p>
52 <code>&lt;MIMEFILTERS&gt;</code><br>
53 <var>filter-specification</var><br>
54 <var>...</var><br>
55 <code>&lt;/MIMEFILTERS&gt;</code><br>
56 </p>
57 </dd>
58
59 <dt><strong>Command-line Option</strong></dt>
60 <dd><p>N/A
61 </p>
62 </dd>
63
64 </dl>
65
66 <!-- *************************************************************** -->
67 <hr>
68 <h2><a name="description">Description</a></h2>
69
70 <P>The resource MIMEFILTERS is used to hook in user specifed filters
71 into MHonArc. The MIMEFILTERS resource can only be set via the
72 <CODE>MIMEFILTERS</CODE> element. The syntax for each line of the
73 the <CODE>MIMEFILTERS</CODE> element is as follows: </P>
74
75 <P><var>content-type</var><CODE>;</CODE><var>routine-name</var><CODE>;</CODE><var>file-of-routine</var> </P>
76
77 <P>The definition of each semi-colon-separated value is as follows:
78 </P>
79
80 <DL>
81 <DT><var>content-type</var>
82
83 <DD><P>The MIME content-type the filter processes. An explicit
84 content-type (base/subtype) or a base content-type (base/*)
85 can be specified.
86 </P>
87
88 <DT><var>routine-name</var>
89 <DD><P>The actual routine name of the filter. The name
90 should be fully qualified by the package it is defined in
91 (e.g. "<CODE>mypackage::filter</CODE>"). </P>
92
93 <DT><var>file-of-routine</var>
94 <DD><P>The name of the file that defines
95 <var>routine-name</var>. If the file is not a full
96 pathname, MHonArc finds the file by looking in the
97 standard include paths of Perl, and the paths specified by the
98 <A HREF="perlinc.html">PERLINC</A>
99 resource.
100 </P>
101
102 </DL>
103
104 <P>Whitespace is stripped out for each filter specification.
105 </P>
106
107 <H3><a name="defaultfilters">Default Filters</a></H3>
108
109 <p>MHonArc provides an existing set of filters which should be sufficient
110 for most of your needs. For information about the filters, see
111 the <a href="#filters"><cite>Available Filters</cite></a> section below.
112 </p>
113
114 <H3><a name="writefilters">Writing Filters</a></H3>
115
116 <P>If you want to write your own filter for use in MHonArc,
117 you need to know the Perl programming language. The following
118 information assumes you know Perl.
119 </P>
120
121 <table class="note" width="100%">
122 <tr valign=top>
123 <td><strong>NOTE:</strong></td>
124 <td width="100%"><p>As of v2.5 of MHonArc, the API for filters is different from
125 v2.4.x, and earlier. The following describes the v2.5 API for
126 filters.
127 </p>
128 </td>
129 </tr>
130 </table>
131
132 <H4>Function Interface of Filter</H4>
133
134 <P>MHonArc interfaces with MIME filters by calling a routine
135 with a specific set of arguments. The prototype of the interface
136 routine is as follows: </P>
137
138 <PRE class="code">
139 sub <var>filter</var> {
140 my(<b>$fields_hash_ref</b>, <b>$body_data_ref</b>, <b>$is_decoded</b>, <b>$filter_args</b>) = <!--
141 -->&#64;<!--
142 -->_;
143
144 <var># Filter code here
145
146 # The last statement should be the return value, unless an
147 # explicit return is done. See the following for the format of the
148 # return value.</var>
149 }
150 </PRE>
151
152 <H5>Parameter Descriptions</H5>
153
154 <table cellspacing=1 border=0 cellpadding=4>
155
156 <tr valign=top>
157 <td><strong><code><a name="fields_hash_ref"
158 >$fields_hash_ref</a></code></strong></td>
159 <td><p>A reference to hash of message/part header
160 fields. Keys are field names in lowercase
161 and values are array references containing the
162 field values. For example, to obtain the
163 content-type, if defined, you would do:
164 </p>
165 <pre class="code">
166 $fields_hash_ref-&gt;{'content-type'}[0]</pre>
167 <p>Values for a fields are stored in arrays since
168 duplication of fields are possible. For example,
169 the <tt>Received:</tt> header field is typically repeated
170 multiple times. For fields that only occur once,
171 the array for the field will only contain one
172 item.
173 </p>
174 <p>See <a href="#xmhafields"><cite>Special Variables and Header
175 Fields</a> for more information about this parameter.
176 </p>
177 </td>
178 </tr>
179
180 <tr valign=top>
181 <td><strong><code>$body_data_ref</code></strong></td>
182 <td><p>Reference to body data. The filter can safely
183 modify referenced data.
184 </p>
185 </td>
186 </tr>
187
188 <tr valign=top>
189 <td><strong><code>$is_decoded</code></strong></td>
190 <td><p>Boolean flag if body data has been decoded.
191 This is normally true unless some non-standard
192 content-transfer-encoding is used. See
193 <a href="mimedecoders.html">MIMEDECODERS</a> on how
194 to register decoders for various content-transfer-encodings.
195 </p>
196 </td>
197 </tr>
198
199 <tr valign=top>
200 <td><strong><code>$filter_args</code></strong></td>
201 <td><P>This is an optional argument string that may be used to modify the
202 behavior of the filter. The format of this string is determined by the filter
203 itself. The value of the string is set by the
204 <a href="mimeargs.html">MIMEARGS</a> resource.
205 </P>
206 </td>
207 </tr>
208
209 </table>
210
211 <H5>Return Value</H5>
212
213 <p>The return value is treated as a list. The first item of the list
214 is a string representing the HTML markup to insert in the HTMLized
215 message. An empty string, or <tt>undef</tt> may be returned to tell MHonArc
216 that the routine was unable to filter data.
217 </p>
218 <p>Any other list items are treated as names of any files that were
219 generated by the filter. MHonArc needs to keep track if any
220 extra files that a filter may generate in order for MHonArc to
221 delete those files if the message gets removed from the archive.
222 </p>
223
224 <table class="note" width="100%">
225 <tr valign=top>
226 <td><strong>NOTE:</strong></td>
227 <td width="100%"><p>If you want MHonArc to treat the data as filtered, but not
228 have anything displayed on the page, just return a string with
229 a single space character.
230 </p>
231 </td>
232 </tr>
233 </table>
234 <p> </p>
235 <table class="note" width="100%">
236 <tr valign=top>
237 <td><strong>NOTE:</strong></td>
238 <td width="100%"><p>If the filter creates a subdirectory with files, the filter
239 only needs to return the subdirectory in the return list. If
240 the message gets removed, MHonArc will delete the entire
241 directory.
242 </p>
243 </td>
244 </tr>
245 </table>
246
247 <H4><a name="xmhafields">Special Variables and Header Fields</a></H4>
248
249 <p>The following global variables are made available to filters:
250 </p>
251
252 <table cellspacing=1 border=0 cellpadding=4>
253
254 <tr valign=top>
255 <td><b><tt><nobr>$mhonarc::MHAindex</nobr></tt></b></td>
256 <td><p>Index key of message. Various MHonArc data structures and
257 utility routines require the index key of the message.
258 </p>
259 </td>
260 </tr>
261 <tr valign=top>
262 <td><b><tt><nobr>$mhonarc::MHAmsgid</nobr></tt></b></td>
263 <td><p>Message ID of message.
264 </p>
265 </td>
266 </tr>
267 <tr valign=top>
268 <td><b><tt><nobr>$mhonarc::MHAmsgnum</nobr></tt></b></td>
269 <td><p>Message number. The format of the number will at least
270 be five digits wide, with leading zero padding. For example,
271 if the number for a message is <tt>15</tt>, <tt>$mhonarc::$MHAmsgnum</tt>
272 will be equal to <tt>00015</tt>.
273 </p>
274 </td>
275 </tr>
276 <tr valign=top>
277 <td><b><tt><nobr>$mhonarc::OUTDIR</nobr></tt></b></td>
278 <td><p>Pathname to archive directory. This variable is useful for
279 filters that create derived files.
280 </p>
281 </td>
282 </tr>
283 </table>
284
285 <p>The <code><a href="#fields_hash_ref">$fields_hash_ref</a></code>
286 parameter will have special MHonArc-specific keys defined. Unlike
287 regular header field values, the values are <strong>not</strong> arrays
288 (unless noted). The following special keys are defined:
289 </p>
290
291 <dl>
292
293 <dt><b><tt>x-mha-charset</tt></b></dt>
294 <dd><pre class="code">my $charset = $fields_hash_ref-&gt;{'x-mha-charset'}</pre>
295 <p>Only defined for <tt>text</tt> entities, the value
296 represents the character set encoding of the text entity.
297 </p>
298 <p>If your filter will take character encoding into account, you
299 should use this value vs what is specified in regular entity header
300 fields because <a href="textencode.html">TEXTENCODE</a> may be affect,
301 so the effective character encoding of the data may be different from
302 the original encoding specified in the message.
303 </p>
304 </dd>
305
306 <dt><b><tt>x-mha-content-type</tt></b></dt>
307 <dd><pre class="code">my $content_type = $fields_hash_ref-&gt;{'x-mha-content-type'}</pre>
308 <p>The media type of the entity extracted from content-type entity header.
309 </p>
310 </dd>
311
312 <dt><b><tt>x-mha-part-number</tt></b></dt>
313 <dd><pre class="code">
314 my $part_no = $fields_hash_ref-&gt;{'x-mha-part-number'}
315 my $full_part_no = readmail::gen_full_part_number($fields_hash_ref);</pre>
316 <p>The child number of the entity within a multipart entity. Numbering
317 starts with 1, and if data is not part of a multipart entity, this
318 key may not be defined.
319 </p>
320 </dd>
321
322 <dt><b><tt>x-mha-parent-header</tt></b></dt>
323 <dd><pre class="code">
324 my $parent_header = $fields_hash_ref-&gt;{'x-mha-parent-header'}
325 </pre>
326 <p>The header field hash for the parent entity, if applicable.
327 </p>
328 </dd>
329
330 </dl>
331
332 <H4><a name="cidhash">Accessing Other Parts</a></H4>
333
334 <p>For some media-types, a filter may need to access other entity
335 parts to properly process a given part.
336 For example,
337 <a href="#m2h_text_html">m2h_text_html::filter</a> must access
338 other entity parts when processing MHTML messages.
339 </p>
340
341 <p>When MHonArc parses a multipart message, it fills the
342 <tt><b>%readmail::Cid</b></tt> hash for each entity that defines either
343 a <tt>Content-Id</tt> or <tt>Content-Location</tt>.
344 The <tt>%readmail::Cid</tt> hash is mainly for use by media types,
345 like <tt>multipart/related</tt> where message parts may reference other
346 message parts.
347 </p>
348
349 <p>The keys of the <tt>%readmail::Cid</tt> hash will be the
350 <tt>Content-Id</tt>s and <tt>Content-Location</tt>s and each value
351 will be a reference to an entity hash structure. Code example:
352 </p>
353 <pre class="code">my $entity = $readmail::Cid{$content_id};</pre>
354 <p>The hash structure defines the following fields: </p>
355
356 <dl>
357 <dt><strong><code>body</code></strong></td>
358 <dd><pre class="code">
359 my $entity_body_ref = $readmail::Cid{$content_id}-&gt;{'body'}
360 </pre>
361 <p>Scalar reference to the body of the entity.
362 </p>
363 </dd>
364 </tr>
365 <tr valign=top>
366 <td><strong><code>fields</code></strong></td>
367 <dd><pre class="code">
368 my $entity_header_ref = $readmail::Cid{$content_id}-&gt;{'fields'}
369 </pre>
370 <p>Entity header fields hash reference. The format is the same
371 as described for <code><a href="#fields_hash_ref">$fields_hash_ref</a></code>.
372 </p>
373 </dd>
374 </tr>
375 <tr valign=top>
376 <td><strong><code>filtered</code></strong></td>
377 <dd><pre class="code">
378 my $is_filtered = $readmail::Cid{$content_id}-&gt;{'filtered'}
379 </pre>
380 <p>Boolean if part has already been filtered. This field should
381 be set to a true value by filters that explicitly filters other entity parts.
382 This tells MHonArc to not invoke a filter for the entity.
383 </p>
384 </dd>
385 </tr>
386 <tr valign=top>
387 <td><strong><code>uri</code></strong></td>
388 <dd><pre class="code">
389 my $entity_uri = $readmail::Cid{$content_id}-&gt;{'uri'}
390 </pre>
391 <p>The URI to the filtered version of the entity. This field should
392 be set by filters that explicitly filters other entity parts.
393 </p>
394 </dd>
395 </dl>
396
397 <p>For a detailed example on how <tt>%readmail::Cid</tt> can be used, see
398 the MHonArc library <tt>mhtxthtml.pl</tt>.
399 </p>
400
401 <H4>Utility Routines</H4>
402
403 <p>See <cite><a href="../app-api.html#utilities">Utilities
404 Routines</a></cite> in the appendix for various helper routines that
405 can be used by your filter.
406 </p>
407
408 <H4>Filter Writing Tips</H4>
409
410 <P>The following recommendations/tips are given to help you write
411 filters: </P>
412
413 <UL>
414 <LI><P>Qualify your filter in its own package. This eliminates possible
415 variable/routine conflicts with MHonArc.
416 </P>
417
418 <LI><P>If the filter creates derived files (like the image filters),
419 you may use the variable <strong><CODE>$mhonarc::OUTDIR</CODE></strong>
420 to determine the
421 location of the mail archive.
422 </P>
423 <table class="note" width="100%">
424 <tr valign=top>
425 <td><strong>NOTE:</strong></td>
426 <td width="100%"><p><strong>Do not include</strong>
427 <strong><CODE>$mhonarc::OUTDIR</CODE></strong> as part as the
428 filename that is returned to MHonArc. If the filter
429 does create files, just return the base name.
430 </p>
431 </td>
432 </tr>
433 </table>
434 <p></p>
435
436 <LI><P>Look at the default filters contained in the distribution
437 of MHonArc. You can use these as templates for writing
438 your own. </P>
439
440 <LI><P>Make sure your Perl source file ends with a true statement
441 (like "<CODE>1;</CODE>"). MHonArc just performs a
442 <strong><CODE>require</CODE></strong>
443 on the file, and if the file does not return
444 true, Perl will abort execution. </P>
445
446 <li><p>Test your filter before production use.
447 </p>
448
449 </UL>
450
451 <H4>Using C</H4>
452
453 <P>If a MIME filter requires the utilization of a C program, or
454 other non-Perl executable, a Perl wrapper must be written for the
455 program in-order to interface with MHonArc. The wrapper must
456 follow the conventions described in
457 <a href="#writefilters">Writing Filters</a>.
458 </P>
459
460 <!-- *************************************************************** -->
461 <hr>
462 <h2><a name="filters">Available Filters</a></h2>
463
464 <p>The following is the list of filters available in the standard
465 MHonArc distribution:
466 </p>
467
468 <table class="note" width="100%">
469 <tr valign=top>
470 <td><strong>NOTE:</strong></td>
471 <td width="100%"><p>The filters use a <a href="mimeargs.html">MIMEARGS</a>
472 argument style similiar to HTML attribute values. For example:
473 </p>
474 <pre class="code">
475 <b>&lt;MIMEArgs&gt;</b>
476 m2h_text_plain::filter; attachcheck fancyquote maxwidth=80
477 <b>&lt;/MIMEArgs&gt;</b>
478 </pre>
479 <p>If writing your own filters, you are encouraged to use the same
480 style for consistency.
481 </p>
482 </td>
483 </tr>
484 </table>
485
486 <H3><a name="m2h_external">m2h_external::filter</a></h3>
487
488 <P>The filter extracts the data into a separate file and puts
489 a hyperlink to the file into the HTMLized message. The following
490 is an example how the link is formatted:
491 </P>
492 <dl>
493 <dd><p><strong>Attachment:
494 <a href=""><tt>blueball.gif</tt></a></strong><br>
495 <em>Description:</em> Blue ball GIF icon</p>
496 </dd></dl>
497
498 <p>The description text is retrieved from the <tt>Content-Disposition</tt>
499 message header field, if defined. If not defined, a generic description
500 will be provided based on the specified content-type of the data.
501 </p>
502
503 <p>If the <tt>useicon</tt> filter argument has been specified for the
504 filter, the following format will be used:
505 </p>
506 <dl><dd><p><strong><a href="" ><img src="../monicon.png" align="left" border=0 alt="Attachment:"></a>
507 <a href="" ><tt>blueball.gif</tt></a></strong><br>
508 <em>Description:</em> Blue ball GIF icon</p>
509 </dd></dl>
510
511 <p>The actual icon used is based upon the <a href="icons.html">ICONS</a>
512 resource.
513 </p>
514
515 <P>By default, the filter ignores any filename specification
516 given in the message when writing the data to disk.
517 A unique filename with an extension based upon sub-type is
518 generated.
519 </P>
520
521 <p><strong><tt>m2h_external::filter</tt></strong> can take the
522 following
523 <a href="mimeargs.html">MIMEARGS arguments</a>:
524 </p>
525
526 <table cellspacing=1 border=0 cellpadding=4>
527 <tr valign=top>
528 <td><strong><tt>excludeexts=</tt></strong><var>ext1</var><tt>,</tt>...</td>
529 <td width="100%"><p>A comma separated list of message specified filename extensions
530 to exclude. I.e. If the filename extension matches an extension
531 in excludeexts, the content will not be written. The return markup
532 will contain the name of the attachment, but no link to the data.
533 This option is best used with application/octet-stream to exclude
534 unwanted data that is not tagged with the proper content-type.
535 </p>
536 </td>
537 </tr>
538 <tr valign=top>
539 <td><strong><tt>ext=<var>ext</var></tt></strong></td>
540 <td><p>Use <var>ext</var> as the filename extension.
541 The filter already has a large list of extensions for various
542 content-types. Use this argument if you process a
543 content-type not recognized by the filter.
544 </p></td>
545 </tr>
546 <tr valign=top>
547 <td><strong><tt>forceattach</tt></strong></td>
548 <td><p>Force images to never be displayed inline, overriding any
549 Content-Disposition setting.
550 </p></td>
551 </tr>
552 <tr valign=top>
553 <td><strong><tt>forceinline</tt></strong></td>
554 <td><p>Force images to be displayed inline, overriding any
555 Content-Disposition setting.
556 </p></td>
557 </tr>
558 <tr valign=top>
559 <td><strong><tt>frame</tt></strong></td>
560 <td><p>Draw a border around the attachment link.
561 </p></td>
562 </tr>
563 <tr valign=top>
564 <td><strong><tt>iconurl="<var>url</var>"</tt></strong></td>
565 <td><p>Use "<var>url</var>" as the url for the icon to use
566 if the <strong><tt>useicon</tt></strong> option is set.
567 This option will override any setting defined by the
568 <a href="icons.html">ICONS</a> resource.
569 The double quotes are required.
570 </p></td>
571 </tr>
572 <tr valign=top>
573 <td><strong><tt>inline</tt></strong></td>
574 <td><p>Inline image data by default if content-disposition not defined.
575 </p></td>
576 </tr>
577 <tr valign=top>
578 <td><strong><tt>inlineexts=</tt></strong><var>ext1</var><tt>,</tt>...</td>
579 <td><p>A comma separated list of message specified filename
580 extensions to treat as possible inline data.
581 Applicable when content-type is not <tt>image/</tt><var>*</var> and
582 <b><tt>usename</tt></b> or <b><tt>usenameext</tt></b> is in effect.
583 </p></td>
584 </tr>
585 <tr valign=top>
586 <td><strong><tt>type="<var>description</var>"</tt></strong></td>
587 <td><p>Use "<var>description</var>" as type description of the
588 data. The double quotes are required.
589 The filter already has a large list of descriptions for various
590 content-types. Use this argument if you process a
591 content-type not recognized by the filter.
592 </p></td>
593 </tr>
594 <tr valign=top>
595 <td><strong><tt>subdir</tt></strong></td>
596 <td><p>Place derived file in a subdirectory of the archive.
597 The subdirectory will be called "<tt>msg<var>MSGNUM</var></tt>".
598 This option may be useful if <strong><tt>usename</tt></strong> is
599 specified to minimize security and name conflict problems.
600 </p></td>
601 </tr>
602 <tr valign=top>
603 <td><strong><tt>target=</tt></strong><var>name</var></td>
604 <td><p>Set the TARGET attribute of anchor link to file
605 Default value is undefined (ie. no TARGET attribute will be
606 written).
607 </p></td>
608 </tr>
609 <tr valign=top>
610 <td><strong><tt>useicon</tt></strong></td>
611 <td><p>Include a content-type icon with the hyperlink to
612 the derived file. The icon used is the value of the
613 <strong><tt>iconurl</tt></strong> option or the icon
614 defined by the <a href="icons.html">ICONS</a> resource.
615 </p></td>
616 </tr>
617 <tr valign=top>
618 <td><strong><tt>usename</tt></strong></td>
619 <td><p>Use (file)name attribute for determining name
620 of derived file.
621 </p>
622 <table class="caution" width="100%">
623 <tr valign=top>
624 <td><strong style="color: red;">CAUTION:</strong></td>
625 <td width="100%"><p>
626 Use this option with caution
627 since it can lead to filename conflicts and
628 security problems.
629 </p>
630 </td></tr></table>
631 </td>
632 </tr>
633 <tr valign=top>
634 <td><strong><tt>usenameext</tt></strong></td>
635 <td><p>Use (file)name attribute for determining the extension
636 of derived file.
637 </p>
638 <table class="caution" width="100%">
639 <tr valign=top>
640 <td><strong style="color: red;">CAUTION:</strong></td>
641 <td width="100%"><p>
642 Use this option with caution since it can lead to
643 security problems.
644 </p>
645 </td></tr></table>
646 </td>
647 </tr>
648 </table>
649
650 <p>All arguments should be separated by at least one space.</p>
651
652 <p>The following table shows the default list of content-types with the
653 filename extension used and a short
654 description that <strong><tt>m2h_external::filter</tt></strong>
655 recognizes:
656 </p>
657
658 <center>
659 <!--X-Ext-CType-Start-->
660 <table border=1 cellpadding=1>
661 <tr bgcolor="#C0C0C0">
662 <th align=left>Content-type</th><th align=center>Extension</th><th align=left>Description</th></tr>
663 <tr valign="top">
664 <td align=left><strong>application/astound</strong></td>
665 <td align=center><tt>asd</tt></td>
666 <td>Astound presentation</td></tr>
667 <tr valign="top">
668 <td align=left><strong>application/envoy</strong></td>
669 <td align=center><tt>evy</tt></td>
670 <td>Envoy file</td></tr>
671 <tr valign="top">
672 <td align=left><strong>application/fastman</strong></td>
673 <td align=center><tt>lcc</tt></td>
674 <td>fastman file</td></tr>
675 <tr valign="top">
676 <td align=left><strong>application/fractals</strong></td>
677 <td align=center><tt>fif</tt></td>
678 <td>Fractal Image Format</td></tr>
679 <tr valign="top">
680 <td align=left><strong>application/iges</strong></td>
681 <td align=center><tt>iges</tt></td>
682 <td>IGES file</td></tr>
683 <tr valign="top">
684 <td align=left><strong>application/mac-binhex40</strong></td>
685 <td align=center><tt>hqx</tt></td>
686 <td>Mac BinHex archive</td></tr>
687 <tr valign="top">
688 <td align=left><strong>application/mathematica</strong></td>
689 <td align=center><tt>ma</tt></td>
690 <td>Mathematica Notebook document</td></tr>
691 <tr valign="top">
692 <td align=left><strong>application/mbedlet</strong></td>
693 <td align=center><tt>mbd</tt></td>
694 <td>mbedlet file</td></tr>
695 <tr valign="top">
696 <td align=left><strong>application/ms-excel</strong></td>
697 <td align=center><tt>xls</tt></td>
698 <td>MS-Excel spreadsheet</td></tr>
699 <tr valign="top">
700 <td align=left><strong>application/ms-powerpoint</strong></td>
701 <td align=center><tt>ppt</tt></td>
702 <td>MS-Powerpoint presentation</td></tr>
703 <tr valign="top">
704 <td align=left><strong>application/ms-project</strong></td>
705 <td align=center><tt>mpp</tt></td>
706 <td>MS-Project file</td></tr>
707 <tr valign="top">
708 <td align=left><strong>application/msword</strong></td>
709 <td align=center><tt>doc</tt></td>
710 <td>MS-Word document</td></tr>
711 <tr valign="top">
712 <td align=left><strong>application/octet-stream</strong></td>
713 <td align=center><tt>bin</tt></td>
714 <td>Binary data</td></tr>
715 <tr valign="top">
716 <td align=left><strong>application/oda</strong></td>
717 <td align=center><tt>oda</tt></td>
718 <td>ODA file</td></tr>
719 <tr valign="top">
720 <td align=left><strong>application/pdf</strong></td>
721 <td align=center><tt>pdf</tt></td>
722 <td>Adobe PDF document</td></tr>
723 <tr valign="top">
724 <td align=left><strong>application/pgp</strong></td>
725 <td align=center><tt>pgp</tt></td>
726 <td>PGP message</td></tr>
727 <tr valign="top">
728 <td align=left><strong>application/pgp-signature</strong></td>
729 <td align=center><tt>pgp</tt></td>
730 <td>PGP signature</td></tr>
731 <tr valign="top">
732 <td align=left><strong>application/pkcs7-mime</strong></td>
733 <td align=center><tt>p7m</tt></td>
734 <td>S/MIME encrypted message</td></tr>
735 <tr valign="top">
736 <td align=left><strong>application/pkcs7-signature</strong></td>
737 <td align=center><tt>p7s</tt></td>
738 <td>S/MIME cryptographic signature</td></tr>
739 <tr valign="top">
740 <td align=left><strong>application/postscript</strong></td>
741 <td align=center><tt>ps</tt></td>
742 <td>PostScript document</td></tr>
743 <tr valign="top">
744 <td align=left><strong>application/rtf</strong></td>
745 <td align=center><tt>rtf</tt></td>
746 <td>RTF file</td></tr>
747 <tr valign="top">
748 <td align=left><strong>application/sgml</strong></td>
749 <td align=center><tt>sgml</tt></td>
750 <td>SGML document</td></tr>
751 <tr valign="top">
752 <td align=left><strong>application/studiom</strong></td>
753 <td align=center><tt>smp</tt></td>
754 <td>Studio M file</td></tr>
755 <tr valign="top">
756 <td align=left><strong>application/timbuktu</strong></td>
757 <td align=center><tt>tbt</tt></td>
758 <td>timbuktu file</td></tr>
759 <tr valign="top">
760 <td align=left><strong>application/vis5d</strong></td>
761 <td align=center><tt>v5d</tt></td>
762 <td>Vis5D dataset</td></tr>
763 <tr valign="top">
764 <td align=left><strong>application/vnd.framemaker</strong></td>
765 <td align=center><tt>fm</tt></td>
766 <td>FrameMaker document</td></tr>
767 <tr valign="top">
768 <td align=left><strong>application/vnd.hp-hpgl</strong></td>
769 <td align=center><tt>hpg</tt></td>
770 <td>HPGL file</td></tr>
771 <tr valign="top">
772 <td align=left><strong>application/vnd.lotus-1-2-3</strong></td>
773 <td align=center><tt>123</tt></td>
774 <td>Lotus 1-2-3</td></tr>
775 <tr valign="top">
776 <td align=left><strong>application/vnd.lotus-approach</strong></td>
777 <td align=center><tt>apr</tt></td>
778 <td>Lotus Approach</td></tr>
779 <tr valign="top">
780 <td align=left><strong>application/vnd.lotus-freelance</strong></td>
781 <td align=center><tt>prz</tt></td>
782 <td>Lotus Freelance</td></tr>
783 <tr valign="top">
784 <td align=left><strong>application/vnd.lotus-organizer</strong></td>
785 <td align=center><tt>org</tt></td>
786 <td>Lotus Organizer</td></tr>
787 <tr valign="top">
788 <td align=left><strong>application/vnd.lotus-screencam</strong></td>
789 <td align=center><tt>scm</tt></td>
790 <td>Lotus Screencam</td></tr>
791 <tr valign="top">
792 <td align=left><strong>application/vnd.lotus-wordpro</strong></td>
793 <td align=center><tt>lwp</tt></td>
794 <td>Lotus WordPro</td></tr>
795 <tr valign="top">
796 <td align=left><strong>application/vnd.mif</strong></td>
797 <td align=center><tt>mif</tt></td>
798 <td>Frame MIF document</td></tr>
799 <tr valign="top">
800 <td align=left><strong>application/vnd.ms-excel</strong></td>
801 <td align=center><tt>xls</tt></td>
802 <td>MS-Excel spreadsheet</td></tr>
803 <tr valign="top">
804 <td align=left><strong>application/vnd.ms-powerpoint</strong></td>
805 <td align=center><tt>ppt</tt></td>
806 <td>MS-Powerpoint presentation</td></tr>
807 <tr valign="top">
808 <td align=left><strong>application/vnd.ms-project</strong></td>
809 <td align=center><tt>mpp</tt></td>
810 <td>MS-Project file</td></tr>
811 <tr valign="top">
812 <td align=left><strong>application/vnd.stardivision.calc</strong></td>
813 <td align=center><tt>sdc</tt></td>
814 <td>StarCalc spreadsheet</td></tr>
815 <tr valign="top">
816 <td align=left><strong>application/vnd.stardivision.chart</strong></td>
817 <td align=center><tt>sds</tt></td>
818 <td>StarChart document</td></tr>
819 <tr valign="top">
820 <td align=left><strong>application/vnd.stardivision.draw</strong></td>
821 <td align=center><tt>sda</tt></td>
822 <td>StarDraw document</td></tr>
823 <tr valign="top">
824 <td align=left><strong>application/vnd.stardivision.impress</strong></td>
825 <td align=center><tt>sdd</tt></td>
826 <td>StarImpress presentation</td></tr>
827 <tr valign="top">
828 <td align=left><strong>application/vnd.stardivision.impress-packed</strong></td>
829 <td align=center><tt>sdp</tt></td>
830 <td>StarImpress packed file</td></tr>
831 <tr valign="top">
832 <td align=left><strong>application/vnd.stardivision.mail</strong></td>
833 <td align=center><tt>smd</tt></td>
834 <td>StarMail mail file</td></tr>
835 <tr valign="top">
836 <td align=left><strong>application/vnd.stardivision.math</strong></td>
837 <td align=center><tt>smf</tt></td>
838 <td>StarMath document</td></tr>
839 <tr valign="top">
840 <td align=left><strong>application/vnd.stardivision.writer</strong></td>
841 <td align=center><tt>sdw</tt></td>
842 <td>StarWriter document</td></tr>
843 <tr valign="top">
844 <td align=left><strong>application/vnd.stardivision.writer-global</strong></td>
845 <td align=center><tt>sgl</tt></td>
846 <td>StarWriter global document</td></tr>
847 <tr valign="top">
848 <td align=left><strong>application/vnd.sun.xml.calc</strong></td>
849 <td align=center><tt>sxc</tt></td>
850 <td>OpenOffice Calc spreadsheet</td></tr>
851 <tr valign="top">
852 <td align=left><strong>application/vnd.sun.xml.calc.template</strong></td>
853 <td align=center><tt>stc</tt></td>
854 <td>OpenOffice Calc template</td></tr>
855 <tr valign="top">
856 <td align=left><strong>application/vnd.sun.xml.draw</strong></td>
857 <td align=center><tt>sxd</tt></td>
858 <td>OpenOffice Draw document</td></tr>
859 <tr valign="top">
860 <td align=left><strong>application/vnd.sun.xml.draw.template</strong></td>
861 <td align=center><tt>std</tt></td>
862 <td>OpenOffice Draw Template</td></tr>
863 <tr valign="top">
864 <td align=left><strong>application/vnd.sun.xml.impress</strong></td>
865 <td align=center><tt>sxi</tt></td>
866 <td>OpenOffice Impress presentation</td></tr>
867 <tr valign="top">
868 <td align=left><strong>application/vnd.sun.xml.impress.template</strong></td>
869 <td align=center><tt>sti</tt></td>
870 <td>OpenOffice Impress template</td></tr>
871 <tr valign="top">
872 <td align=left><strong>application/vnd.sun.xml.math</strong></td>
873 <td align=center><tt>sxm</tt></td>
874 <td>OpenOffice Math documents</td></tr>
875 <tr valign="top">
876 <td align=left><strong>application/vnd.sun.xml.writer</strong></td>
877 <td align=center><tt>sxw</tt></td>
878 <td>OpenOffice Writer document</td></tr>
879 <tr valign="top">
880 <td align=left><strong>application/vnd.sun.xml.writer.global</strong></td>
881 <td align=center><tt>sxg</tt></td>
882 <td>OpenOffice Writer global document</td></tr>
883 <tr valign="top">
884 <td align=left><strong>application/vnd.sun.xml.writer.template</strong></td>
885 <td align=center><tt>stw</tt></td>
886 <td>OpenOffice Write template</td></tr>
887 <tr valign="top">
888 <td align=left><strong>application/winhlp</strong></td>
889 <td align=center><tt>hlp</tt></td>
890 <td>WinHelp document</td></tr>
891 <tr valign="top">
892 <td align=left><strong>application/wordperfect5.1</strong></td>
893 <td align=center><tt>wp</tt></td>
894 <td>WordPerfect 5.1 document</td></tr>
895 <tr valign="top">
896 <td align=left><strong>application/x-asap</strong></td>
897 <td align=center><tt>asp</tt></td>
898 <td>asap file</td></tr>
899 <tr valign="top">
900 <td align=left><strong>application/x-bcpio</strong></td>
901 <td align=center><tt>bcpio</tt></td>
902 <td>BCPIO file</td></tr>
903 <tr valign="top">
904 <td align=left><strong>application/x-bzip2</strong></td>
905 <td align=center><tt>bz2</tt></td>
906 <td>BZip2 compressed data</td></tr>
907 <tr valign="top">
908 <td align=left><strong>application/x-compress</strong></td>
909 <td align=center><tt>Z</tt></td>
910 <td>Unix compressed data</td></tr>
911 <tr valign="top">
912 <td align=left><strong>application/x-cpio</strong></td>
913 <td align=center><tt>cpio</tt></td>
914 <td>CPIO file</td></tr>
915 <tr valign="top">
916 <td align=left><strong>application/x-csh</strong></td>
917 <td align=center><tt>csh</tt></td>
918 <td>C-Shell script</td></tr>
919 <tr valign="top">
920 <td align=left><strong>application/x-dot</strong></td>
921 <td align=center><tt>dot</tt></td>
922 <td>dot file</td></tr>
923 <tr valign="top">
924 <td align=left><strong>application/x-dvi</strong></td>
925 <td align=center><tt>dvi</tt></td>
926 <td>TeX dvi file</td></tr>
927 <tr valign="top">
928 <td align=left><strong>application/x-earthtime</strong></td>
929 <td align=center><tt>etc</tt></td>
930 <td>Earthtime file</td></tr>
931 <tr valign="top">
932 <td align=left><strong>application/x-envoy</strong></td>
933 <td align=center><tt>evy</tt></td>
934 <td>Envoy file</td></tr>
935 <tr valign="top">
936 <td align=left><strong>application/x-excel</strong></td>
937 <td align=center><tt>xls</tt></td>
938 <td>MS-Excel spreadsheet</td></tr>
939 <tr valign="top">
940 <td align=left><strong>application/x-gtar</strong></td>
941 <td align=center><tt>gtar</tt></td>
942 <td>GNU Unix tar archive</td></tr>
943 <tr valign="top">
944 <td align=left><strong>application/x-gzip</strong></td>
945 <td align=center><tt>gz</tt></td>
946 <td>GNU Zip compressed data</td></tr>
947 <tr valign="top">
948 <td align=left><strong>application/x-hdf</strong></td>
949 <td align=center><tt>hdf</tt></td>
950 <td>HDF file</td></tr>
951 <tr valign="top">
952 <td align=left><strong>application/x-javascript</strong></td>
953 <td align=center><tt>js</tt></td>
954 <td>JavaScript source</td></tr>
955 <tr valign="top">
956 <td align=left><strong>application/x-ksh</strong></td>
957 <td align=center><tt>ksh</tt></td>
958 <td>Korn Shell script</td></tr>
959 <tr valign="top">
960 <td align=left><strong>application/x-latex</strong></td>
961 <td align=center><tt>latex</tt></td>
962 <td>LaTeX document</td></tr>
963 <tr valign="top">
964 <td align=left><strong>application/x-maker</strong></td>
965 <td align=center><tt>fm</tt></td>
966 <td>FrameMaker document</td></tr>
967 <tr valign="top">
968 <td align=left><strong>application/x-mif</strong></td>
969 <td align=center><tt>mif</tt></td>
970 <td>Frame MIF document</td></tr>
971 <tr valign="top">
972 <td align=left><strong>application/x-mocha</strong></td>
973 <td align=center><tt>moc</tt></td>
974 <td>mocha file</td></tr>
975 <tr valign="top">
976 <td align=left><strong>application/x-msaccess</strong></td>
977 <td align=center><tt>mdb</tt></td>
978 <td>MS-Access database</td></tr>
979 <tr valign="top">
980 <td align=left><strong>application/x-mscardfile</strong></td>
981 <td align=center><tt>crd</tt></td>
982 <td>MS-CardFile</td></tr>
983 <tr valign="top">
984 <td align=left><strong>application/x-msclip</strong></td>
985 <td align=center><tt>clp</tt></td>
986 <td>MS-Clip file</td></tr>
987 <tr valign="top">
988 <td align=left><strong>application/x-msmediaview</strong></td>
989 <td align=center><tt>m14</tt></td>
990 <td>MS-Media View file</td></tr>
991 <tr valign="top">
992 <td align=left><strong>application/x-msmetafile</strong></td>
993 <td align=center><tt>wmf</tt></td>
994 <td>MS-Metafile</td></tr>
995 <tr valign="top">
996 <td align=left><strong>application/x-msmoney</strong></td>
997 <td align=center><tt>mny</tt></td>
998 <td>MS-Money file</td></tr>
999 <tr valign="top">
1000 <td align=left><strong>application/x-mspublisher</strong></td>
1001 <td align=center><tt>pub</tt></td>
1002 <td>MS-Publisher document</td></tr>
1003 <tr valign="top">
1004 <td align=left><strong>application/x-msschedule</strong></td>
1005 <td align=center><tt>scd</tt></td>
1006 <td>MS-Schedule file</td></tr>
1007 <tr valign="top">
1008 <td align=left><strong>application/x-msterminal</strong></td>
1009 <td align=center><tt>trm</tt></td>
1010 <td>MS-Terminal</td></tr>
1011 <tr valign="top">
1012 <td align=left><strong>application/x-mswrite</strong></td>
1013 <td align=center><tt>wri</tt></td>
1014 <td>MS-Write document</td></tr>
1015 <tr valign="top">
1016 <td align=left><strong>application/x-net-install</strong></td>
1017 <td align=center><tt>ins</tt></td>
1018 <td>Net Install file</td></tr>
1019 <tr valign="top">
1020 <td align=left><strong>application/x-netcdf</strong></td>
1021 <td align=center><tt>cdf</tt></td>
1022 <td>Cdf file</td></tr>
1023 <tr valign="top">
1024 <td align=left><strong>application/x-ns-proxy-autoconfig</strong></td>
1025 <td align=center><tt>proxy</tt></td>
1026 <td>Netscape Proxy Auto Config</td></tr>
1027 <tr valign="top">
1028 <td align=left><strong>application/x-patch</strong></td>
1029 <td align=center><tt>patch</tt></td>
1030 <td>Source code patch</td></tr>
1031 <tr valign="top">
1032 <td align=left><strong>application/x-perl</strong></td>
1033 <td align=center><tt>pl</tt></td>
1034 <td>Perl program</td></tr>
1035 <tr valign="top">
1036 <td align=left><strong>application/x-pointplus</strong></td>
1037 <td align=center><tt>css</tt></td>
1038 <td>pointplus file</td></tr>
1039 <tr valign="top">
1040 <td align=left><strong>application/x-salsa</strong></td>
1041 <td align=center><tt>slc</tt></td>
1042 <td>salsa file</td></tr>
1043 <tr valign="top">
1044 <td align=left><strong>application/x-script</strong></td>
1045 <td align=center><tt>script</tt></td>
1046 <td>A script file</td></tr>
1047 <tr valign="top">
1048 <td align=left><strong>application/x-sh</strong></td>
1049 <td align=center><tt>sh</tt></td>
1050 <td>Bourne shell script</td></tr>
1051 <tr valign="top">
1052 <td align=left><strong>application/x-shar</strong></td>
1053 <td align=center><tt>shar</tt></td>
1054 <td>Unix shell archive</td></tr>
1055 <tr valign="top">
1056 <td align=left><strong>application/x-sprite</strong></td>
1057 <td align=center><tt>spr</tt></td>
1058 <td>sprite file</td></tr>
1059 <tr valign="top">
1060 <td align=left><strong>application/x-stuffit</strong></td>
1061 <td align=center><tt>sit</tt></td>
1062 <td>Macintosh archive</td></tr>
1063 <tr valign="top">
1064 <td align=left><strong>application/x-sv4cpio</strong></td>
1065 <td align=center><tt>sv4cpio</tt></td>
1066 <td>SV4Cpio file</td></tr>
1067 <tr valign="top">
1068 <td align=left><strong>application/x-sv4crc</strong></td>
1069 <td align=center><tt>sv4crc</tt></td>
1070 <td>SV4Crc file</td></tr>
1071 <tr valign="top">
1072 <td align=left><strong>application/x-tar</strong></td>
1073 <td align=center><tt>tar</tt></td>
1074 <td>Unix tar archive</td></tr>
1075 <tr valign="top">
1076 <td align=left><strong>application/x-tcl</strong></td>
1077 <td align=center><tt>tcl</tt></td>
1078 <td>Tcl script</td></tr>
1079 <tr valign="top">
1080 <td align=left><strong>application/x-tex</strong></td>
1081 <td align=center><tt>tex</tt></td>
1082 <td>TeX document</td></tr>
1083 <tr valign="top">
1084 <td align=left><strong>application/x-texinfo</strong></td>
1085 <td align=center><tt>texinfo</tt></td>
1086 <td>TeXInfo document</td></tr>
1087 <tr valign="top">
1088 <td align=left><strong>application/x-timbuktu</strong></td>
1089 <td align=center><tt>tbp</tt></td>
1090 <td>timbuktu file</td></tr>
1091 <tr valign="top">
1092 <td align=left><strong>application/x-tkined</strong></td>
1093 <td align=center><tt>tki</tt></td>
1094 <td>tkined file</td></tr>
1095 <tr valign="top">
1096 <td align=left><strong>application/x-troff</strong></td>
1097 <td align=center><tt>roff</tt></td>
1098 <td>Troff document</td></tr>
1099 <tr valign="top">
1100 <td align=left><strong>application/x-troff-man</strong></td>
1101 <td align=center><tt>man</tt></td>
1102 <td>Unix manual page</td></tr>
1103 <tr valign="top">
1104 <td align=left><strong>application/x-troff-me</strong></td>
1105 <td align=center><tt>me</tt></td>
1106 <td>Troff ME-macros document</td></tr>
1107 <tr valign="top">
1108 <td align=left><strong>application/x-troff-ms</strong></td>
1109 <td align=center><tt>ms</tt></td>
1110 <td>Troff MS-macros document</td></tr>
1111 <tr valign="top">
1112 <td align=left><strong>application/x-ustar</strong></td>
1113 <td align=center><tt>ustar</tt></td>
1114 <td>UStar file</td></tr>
1115 <tr valign="top">
1116 <td align=left><strong>application/x-wais-source</strong></td>
1117 <td align=center><tt>src</tt></td>
1118 <td>WAIS Source</td></tr>
1119 <tr valign="top">
1120 <td align=left><strong>application/x-zip-compressed</strong></td>
1121 <td align=center><tt>zip</tt></td>
1122 <td>Zip compressed data</td></tr>
1123 <tr valign="top">
1124 <td align=left><strong>application/xml</strong></td>
1125 <td align=center><tt>xml</tt></td>
1126 <td>XML document</td></tr>
1127 <tr valign="top">
1128 <td align=left><strong>application/zip</strong></td>
1129 <td align=center><tt>zip</tt></td>
1130 <td>Zip archive</td></tr>
1131 <tr valign="top">
1132 <td align=left><strong>audio/basic</strong></td>
1133 <td align=center><tt>snd</tt></td>
1134 <td>Basic audio</td></tr>
1135 <tr valign="top">
1136 <td align=left><strong>audio/echospeech</strong></td>
1137 <td align=center><tt>es</tt></td>
1138 <td>Echospeech audio</td></tr>
1139 <tr valign="top">
1140 <td align=left><strong>audio/microsoft-wav</strong></td>
1141 <td align=center><tt>wav</tt></td>
1142 <td>Wave audio</td></tr>
1143 <tr valign="top">
1144 <td align=left><strong>audio/midi</strong></td>
1145 <td align=center><tt>midi</tt></td>
1146 <td>MIDI audio</td></tr>
1147 <tr valign="top">
1148 <td align=left><strong>audio/wav</strong></td>
1149 <td align=center><tt>wav</tt></td>
1150 <td>Wave audio</td></tr>
1151 <tr valign="top">
1152 <td align=left><strong>audio/x-aiff</strong></td>
1153 <td align=center><tt>aif</tt></td>
1154 <td>AIF audio</td></tr>
1155 <tr valign="top">
1156 <td align=left><strong>audio/x-epac</strong></td>
1157 <td align=center><tt>pae</tt></td>
1158 <td>epac audio</td></tr>
1159 <tr valign="top">
1160 <td align=left><strong>audio/x-midi</strong></td>
1161 <td align=center><tt>midi</tt></td>
1162 <td>MIDI audio</td></tr>
1163 <tr valign="top">
1164 <td align=left><strong>audio/x-mpeg</strong></td>
1165 <td align=center><tt>mp2</tt></td>
1166 <td>MPEG audio</td></tr>
1167 <tr valign="top">
1168 <td align=left><strong>audio/x-pac</strong></td>
1169 <td align=center><tt>pac</tt></td>
1170 <td>pac audio</td></tr>
1171 <tr valign="top">
1172 <td align=left><strong>audio/x-pn-realaudio</strong></td>
1173 <td align=center><tt>ra</tt></td>
1174 <td>PN Realaudio</td></tr>
1175 <tr valign="top">
1176 <td align=left><strong>audio/x-wav</strong></td>
1177 <td align=center><tt>wav</tt></td>
1178 <td>Wave audio</td></tr>
1179 <tr valign="top">
1180 <td align=left><strong>chemical/chem3d</strong></td>
1181 <td align=center><tt>c3d</tt></td>
1182 <td>Chem3d chemical test</td></tr>
1183 <tr valign="top">
1184 <td align=left><strong>chemical/chemdraw</strong></td>
1185 <td align=center><tt>chm</tt></td>
1186 <td>Chemdraw chemical test</td></tr>
1187 <tr valign="top">
1188 <td align=left><strong>chemical/cif</strong></td>
1189 <td align=center><tt>cif</tt></td>
1190 <td>CIF chemical test</td></tr>
1191 <tr valign="top">
1192 <td align=left><strong>chemical/cml</strong></td>
1193 <td align=center><tt>cml</tt></td>
1194 <td>CML chemical test</td></tr>
1195 <tr valign="top">
1196 <td align=left><strong>chemical/cmsl</strong></td>
1197 <td align=center><tt>cml</tt></td>
1198 <td>Chemical Structure Markup</td></tr>
1199 <tr valign="top">
1200 <td align=left><strong>chemical/cxf</strong></td>
1201 <td align=center><tt>cxf</tt></td>
1202 <td>Chemical Exhange Format file</td></tr>
1203 <tr valign="top">
1204 <td align=left><strong>chemical/daylight-smiles</strong></td>
1205 <td align=center><tt>smi</tt></td>
1206 <td>SMILES format file</td></tr>
1207 <tr valign="top">
1208 <td align=left><strong>chemical/embl-dl-nucleotide</strong></td>
1209 <td align=center><tt>emb</tt></td>
1210 <td>EMBL nucleotide format file</td></tr>
1211 <tr valign="top">
1212 <td align=left><strong>chemical/gaussian</strong></td>
1213 <td align=center><tt>gau</tt></td>
1214 <td>Gaussian data</td></tr>
1215 <tr valign="top">
1216 <td align=left><strong>chemical/gaussian-input</strong></td>
1217 <td align=center><tt>gau</tt></td>
1218 <td>Gaussian input data</td></tr>
1219 <tr valign="top">
1220 <td align=left><strong>chemical/gaussian-log</strong></td>
1221 <td align=center><tt>gal</tt></td>
1222 <td>Gaussian log</td></tr>
1223 <tr valign="top">
1224 <td align=left><strong>chemical/gcg8-sequence</strong></td>
1225 <td align=center><tt>gcg</tt></td>
1226 <td>GCG format file</td></tr>
1227 <tr valign="top">
1228 <td align=left><strong>chemical/genbank</strong></td>
1229 <td align=center><tt>gen</tt></td>
1230 <td>GENbank data</td></tr>
1231 <tr valign="top">
1232 <td align=left><strong>chemical/jcamp-dx</strong></td>
1233 <td align=center><tt>jdx</tt></td>
1234 <td>Jcamp chemical spectra test</td></tr>
1235 <tr valign="top">
1236 <td align=left><strong>chemical/kinemage</strong></td>
1237 <td align=center><tt>kin</tt></td>
1238 <td>Kinemage</td></tr>
1239 <tr valign="top">
1240 <td align=left><strong>chemical/macromodel-input</strong></td>
1241 <td align=center><tt>mmd</tt></td>
1242 <td>Macromodel chemical test</td></tr>
1243 <tr valign="top">
1244 <td align=left><strong>chemical/mdl-molfile</strong></td>
1245 <td align=center><tt>mol</tt></td>
1246 <td>MOL mdl chemical test</td></tr>
1247 <tr valign="top">
1248 <td align=left><strong>chemical/mdl-rdf</strong></td>
1249 <td align=center><tt>rdf</tt></td>
1250 <td>RDF chemical test</td></tr>
1251 <tr valign="top">
1252 <td align=left><strong>chemical/mdl-rxn</strong></td>
1253 <td align=center><tt>rxn</tt></td>
1254 <td>RXN chemical test</td></tr>
1255 <tr valign="top">
1256 <td align=left><strong>chemical/mdl-sdf</strong></td>
1257 <td align=center><tt>sdf</tt></td>
1258 <td>SDF chemical test</td></tr>
1259 <tr valign="top">
1260 <td align=left><strong>chemical/mdl-tgf</strong></td>
1261 <td align=center><tt>tgf</tt></td>
1262 <td>TGF chemical test</td></tr>
1263 <tr valign="top">
1264 <td align=left><strong>chemical/mif</strong></td>
1265 <td align=center><tt>mif</tt></td>
1266 <td>MIF chemical test</td></tr>
1267 <tr valign="top">
1268 <td align=left><strong>chemical/mmd</strong></td>
1269 <td align=center><tt>mmd</tt></td>
1270 <td>Macromodel data</td></tr>
1271 <tr valign="top">
1272 <td align=left><strong>chemical/mopac-input</strong></td>
1273 <td align=center><tt>mop</tt></td>
1274 <td>MOPAC data </td></tr>
1275 <tr valign="top">
1276 <td align=left><strong>chemical/ncbi-asn1</strong></td>
1277 <td align=center><tt>asn</tt></td>
1278 <td>NCBI data</td></tr>
1279 <tr valign="top">
1280 <td align=left><strong>chemical/ncbi-asn1-binary</strong></td>
1281 <td align=center><tt>val</tt></td>
1282 <td>NCBI data</td></tr>
1283 <tr valign="top">
1284 <td align=left><strong>chemical/pdb</strong></td>
1285 <td align=center><tt>pdb</tt></td>
1286 <td>Protein Databank data</td></tr>
1287 <tr valign="top">
1288 <td align=left><strong>chemical/rosdal</strong></td>
1289 <td align=center><tt>ros</tt></td>
1290 <td>Rosdal data</td></tr>
1291 <tr valign="top">
1292 <td align=left><strong>chemical/xyz</strong></td>
1293 <td align=center><tt>xyz</tt></td>
1294 <td>Xmol XYZ data</td></tr>
1295 <tr valign="top">
1296 <td align=left><strong>image/bmp</strong></td>
1297 <td align=center><tt>bmp</tt></td>
1298 <td>Windows bitmap</td></tr>
1299 <tr valign="top">
1300 <td align=left><strong>image/cgm</strong></td>
1301 <td align=center><tt>cgm</tt></td>
1302 <td>Computer Graphics Metafile</td></tr>
1303 <tr valign="top">
1304 <td align=left><strong>image/fif</strong></td>
1305 <td align=center><tt>fif</tt></td>
1306 <td>Fractal Image Format image</td></tr>
1307 <tr valign="top">
1308 <td align=left><strong>image/g3fax</strong></td>
1309 <td align=center><tt>g3f</tt></td>
1310 <td>Group III FAX image</td></tr>
1311 <tr valign="top">
1312 <td align=left><strong>image/gif</strong></td>
1313 <td align=center><tt>gif</tt></td>
1314 <td>GIF image</td></tr>
1315 <tr valign="top">
1316 <td align=left><strong>image/ief</strong></td>
1317 <td align=center><tt>ief</tt></td>
1318 <td>IEF image</td></tr>
1319 <tr valign="top">
1320 <td align=left><strong>image/ifs</strong></td>
1321 <td align=center><tt>ifs</tt></td>
1322 <td>IFS image</td></tr>
1323 <tr valign="top">
1324 <td align=left><strong>image/jpeg</strong></td>
1325 <td align=center><tt>jpg</tt></td>
1326 <td>JPEG image</td></tr>
1327 <tr valign="top">
1328 <td align=left><strong>image/pbm</strong></td>
1329 <td align=center><tt>pbm</tt></td>
1330 <td>Portable bitmap</td></tr>
1331 <tr valign="top">
1332 <td align=left><strong>image/pgm</strong></td>
1333 <td align=center><tt>pgm</tt></td>
1334 <td>Portable graymap</td></tr>
1335 <tr valign="top">
1336 <td align=left><strong>image/png</strong></td>
1337 <td align=center><tt>png</tt></td>
1338 <td>PNG image</td></tr>
1339 <tr valign="top">
1340 <td align=left><strong>image/tiff</strong></td>
1341 <td align=center><tt>tif</tt></td>
1342 <td>TIFF image</td></tr>
1343 <tr valign="top">
1344 <td align=left><strong>image/vnd</strong></td>
1345 <td align=center><tt>dwg</tt></td>
1346 <td>VND image</td></tr>
1347 <tr valign="top">
1348 <td align=left><strong>image/wavelet</strong></td>
1349 <td align=center><tt>wi</tt></td>
1350 <td>Wavelet image</td></tr>
1351 <tr valign="top">
1352 <td align=left><strong>image/x-cmu-raster</strong></td>
1353 <td align=center><tt>ras</tt></td>
1354 <td>CMU raster</td></tr>
1355 <tr valign="top">
1356 <td align=left><strong>image/x-pbm</strong></td>
1357 <td align=center><tt>pbm</tt></td>
1358 <td>Portable bitmap</td></tr>
1359 <tr valign="top">
1360 <td align=left><strong>image/x-pcx</strong></td>
1361 <td align=center><tt>pcx</tt></td>
1362 <td>PCX image</td></tr>
1363 <tr valign="top">
1364 <td align=left><strong>image/x-pgm</strong></td>
1365 <td align=center><tt>pgm</tt></td>
1366 <td>Portable graymap</td></tr>
1367 <tr valign="top">
1368 <td align=left><strong>image/x-pict</strong></td>
1369 <td align=center><tt>pict</tt></td>
1370 <td>Mac PICT image</td></tr>
1371 <tr valign="top">
1372 <td align=left><strong>image/x-pnm</strong></td>
1373 <td align=center><tt>pnm</tt></td>
1374 <td>Portable anymap</td></tr>
1375 <tr valign="top">
1376 <td align=left><strong>image/x-portable-anymap</strong></td>
1377 <td align=center><tt>pnm</tt></td>
1378 <td>Portable anymap</td></tr>
1379 <tr valign="top">
1380 <td align=left><strong>image/x-portable-bitmap</strong></td>
1381 <td align=center><tt>pbm</tt></td>
1382 <td>Portable bitmap</td></tr>
1383 <tr valign="top">
1384 <td align=left><strong>image/x-portable-graymap</strong></td>
1385 <td align=center><tt>pgm</tt></td>
1386 <td>Portable graymap</td></tr>
1387 <tr valign="top">
1388 <td align=left><strong>image/x-portable-pixmap</strong></td>
1389 <td align=center><tt>ppm</tt></td>
1390 <td>Portable pixmap</td></tr>
1391 <tr valign="top">
1392 <td align=left><strong>image/x-ppm</strong></td>
1393 <td align=center><tt>ppm</tt></td>
1394 <td>Portable pixmap</td></tr>
1395 <tr valign="top">
1396 <td align=left><strong>image/x-rgb</strong></td>
1397 <td align=center><tt>rgb</tt></td>
1398 <td>RGB image</td></tr>
1399 <tr valign="top">
1400 <td align=left><strong>image/x-xbitmap</strong></td>
1401 <td align=center><tt>xbm</tt></td>
1402 <td>X bitmap</td></tr>
1403 <tr valign="top">
1404 <td align=left><strong>image/x-xbm</strong></td>
1405 <td align=center><tt>xbm</tt></td>
1406 <td>X bitmap</td></tr>
1407 <tr valign="top">
1408 <td align=left><strong>image/x-xpixmap</strong></td>
1409 <td align=center><tt>xpm</tt></td>
1410 <td>X pixmap</td></tr>
1411 <tr valign="top">
1412 <td align=left><strong>image/x-xpm</strong></td>
1413 <td align=center><tt>xpm</tt></td>
1414 <td>X pixmap</td></tr>
1415 <tr valign="top">
1416 <td align=left><strong>image/xwd</strong></td>
1417 <td align=center><tt>xwd</tt></td>
1418 <td>X window dump</td></tr>
1419 <tr valign="top">
1420 <td align=left><strong>image/xwindowdump</strong></td>
1421 <td align=center><tt>xwd</tt></td>
1422 <td>X window dump</td></tr>
1423 <tr valign="top">
1424 <td align=left><strong>message/news</strong></td>
1425 <td align=center><tt>822</tt></td>
1426 <td>News post</td></tr>
1427 <tr valign="top">
1428 <td align=left><strong>message/rfc822</strong></td>
1429 <td align=center><tt>822</tt></td>
1430 <td>Mail message</td></tr>
1431 <tr valign="top">
1432 <td align=left><strong>model/iges</strong></td>
1433 <td align=center><tt>iges</tt></td>
1434 <td>IGES model</td></tr>
1435 <tr valign="top">
1436 <td align=left><strong>model/mesh</strong></td>
1437 <td align=center><tt>mesh</tt></td>
1438 <td>Mesh model</td></tr>
1439 <tr valign="top">
1440 <td align=left><strong>model/vrml</strong></td>
1441 <td align=center><tt>wrl</tt></td>
1442 <td>VRML model</td></tr>
1443 <tr valign="top">
1444 <td align=left><strong>text/enriched</strong></td>
1445 <td align=center><tt>rtx</tt></td>
1446 <td>Text-enriched document</td></tr>
1447 <tr valign="top">
1448 <td align=left><strong>text/html</strong></td>
1449 <td align=center><tt>html</tt></td>
1450 <td>HTML document</td></tr>
1451 <tr valign="top">
1452 <td align=left><strong>text/plain</strong></td>
1453 <td align=center><tt>txt</tt></td>
1454 <td>Text document</td></tr>
1455 <tr valign="top">
1456 <td align=left><strong>text/richtext</strong></td>
1457 <td align=center><tt>rtx</tt></td>
1458 <td>Richtext document</td></tr>
1459 <tr valign="top">
1460 <td align=left><strong>text/setext</strong></td>
1461 <td align=center><tt>stx</tt></td>
1462 <td>Setext document</td></tr>
1463 <tr valign="top">
1464 <td align=left><strong>text/sgml</strong></td>
1465 <td align=center><tt>sgml</tt></td>
1466 <td>SGML document</td></tr>
1467 <tr valign="top">
1468 <td align=left><strong>text/tab-separated-values</strong></td>
1469 <td align=center><tt>tsv</tt></td>
1470 <td>Tab separated values</td></tr>
1471 <tr valign="top">
1472 <td align=left><strong>text/x-speech</strong></td>
1473 <td align=center><tt>talk</tt></td>
1474 <td>Speech document</td></tr>
1475 <tr valign="top">
1476 <td align=left><strong>text/x-vcard</strong></td>
1477 <td align=center><tt>vcf</tt></td>
1478 <td>Vcard</td></tr>
1479 <tr valign="top">
1480 <td align=left><strong>text/xml</strong></td>
1481 <td align=center><tt>xml</tt></td>
1482 <td>XML document</td></tr>
1483 <tr valign="top">
1484 <td align=left><strong>video/isivideo</strong></td>
1485 <td align=center><tt>fvi</tt></td>
1486 <td>isi video</td></tr>
1487 <tr valign="top">
1488 <td align=left><strong>video/mpeg</strong></td>
1489 <td align=center><tt>mpg</tt></td>
1490 <td>MPEG movie</td></tr>
1491 <tr valign="top">
1492 <td align=left><strong>video/msvideo</strong></td>
1493 <td align=center><tt>avi</tt></td>
1494 <td>MS Video</td></tr>
1495 <tr valign="top">
1496 <td align=left><strong>video/quicktime</strong></td>
1497 <td align=center><tt>mov</tt></td>
1498 <td>QuickTime movie</td></tr>
1499 <tr valign="top">
1500 <td align=left><strong>video/vivo</strong></td>
1501 <td align=center><tt>viv</tt></td>
1502 <td>vivo video</td></tr>
1503 <tr valign="top">
1504 <td align=left><strong>video/wavelet</strong></td>
1505 <td align=center><tt>wv</tt></td>
1506 <td>Wavelet video</td></tr>
1507 <tr valign="top">
1508 <td align=left><strong>video/x-sgi-movie</strong></td>
1509 <td align=center><tt>movie</tt></td>
1510 <td>SGI movie</td></tr>
1511 </table>
1512 <!--X-Ext-CType-End-->
1513 </center>
1514
1515 <H3><a name="m2h_msg_extbody">m2h_msg_extbody::filter</a></h3>
1516
1517 <p>This filter is designed to process <tt>message/external-body</tt>
1518 data.
1519 The filter attempts to translate the external-body paramaters
1520 into a linked URL with some descriptive information,
1521 if provided. The following access-types are supported:
1522 ANON-FTP, FTP, TFTP, HTTP, LOCAL-FILE, and URL. Note, LOCAL-FILE is
1523 only supported if the <tt>local-file</tt> option is specified.
1524 </p>
1525
1526 <p><strong><tt>m2h_msg_extbody::filter</tt></strong> can take the
1527 following
1528 <a href="mimeargs.html">MIMEARGS arguments</a>:
1529 </p>
1530
1531 <table cellspacing=1 border=0 cellpadding=4>
1532 <tr valign=top>
1533 <td><strong><tt>local-file</tt></strong></td>
1534 <td><p>Support LOCAL-FILE access-type. This option
1535 is best used for internal local mail archives
1536 where it is known that readers will have
1537 direct access to the file.
1538 </p>
1539 </tr>
1540 </table>
1541
1542
1543 <H3><a name="m2h_text_enriched">m2h_text_enriched::filter</a></h3>
1544
1545 <p>This filter is designed to process text/enriched, or
1546 text/richtext, data. The following table summarizes the
1547 translation of text/enriched commands to HTML tags:
1548 </p>
1549
1550 <center>
1551 <table border=1 cellpadding=2>
1552 <tr valign=top align=left bgcolor="#C0C0C0">
1553 <th>Text/Enriched Command</th><th>HTML Translation</th>
1554 </tr>
1555 <tr valign=top>
1556 <td><strong>&lt;Bold&gt;</strong></td>
1557 <td>&lt;b&gt;</td>
1558 </tr>
1559 <tr valign=top>
1560 <td><strong>&lt;Italic&gt;</strong></td>
1561 <td>&lt;i&gt;</td>
1562 </tr>
1563 <tr valign=top>
1564 <td><strong>&lt;Underline&gt;</strong></td>
1565 <td>&lt;u&gt;</td>
1566 </tr>
1567 <tr valign=top>
1568 <td><strong>&lt;Fixed&gt;</strong></td>
1569 <td>&lt;tt&gt;</td>
1570 </tr>
1571 <tr valign=top>
1572 <td><strong>&lt;Smaller&gt;</strong></td>
1573 <td>&lt;small&gt;</td>
1574 </tr>
1575 <tr valign=top>
1576 <td><strong>&lt;Bigger&gt;</strong></td>
1577 <td>&lt;big&gt;</td>
1578 </tr>
1579 <tr valign=top>
1580 <td><strong>&lt;FontFamily&gt;&lt;Param&gt;<var>family</var>&lt;/Param&gt;</strong></td>
1581 <td>&lt;font face="<var>family</var>"&gt;</td>
1582 </tr>
1583 <tr valign=top>
1584 <td><strong>&lt;Color&gt;&lt;Param&gt;<var>color</var>&lt;/Param&gt;</strong></td>
1585 <td>&lt;font color="<var>color</var>"&gt;</td>
1586 </tr>
1587 <tr valign=top>
1588 <td><strong>&lt;Center></strong></td>
1589 <td>&lt;p align="center"&gt;</td>
1590 </tr>
1591 <tr valign=top>
1592 <td><strong>&lt;FlushLeft&gt;</strong></td>
1593 <td>&lt;p align="left"&gt;</td>
1594 </tr>
1595 <tr valign=top>
1596 <td><strong>&lt;FlushRight&gt;</strong></td>
1597 <td>&lt;p align="right"&gt;</td>
1598 </tr>
1599 <tr valign=top>
1600 <td><strong>&lt;FlushBoth&gt;</strong></td>
1601 <td>&lt;p align="justify"&gt;</td>
1602 </tr>
1603 <tr valign=top>
1604 <td><strong>&lt;ParaIndent&gt;</strong></td>
1605 <td>&lt;blockquote&gt;</td>
1606 </tr>
1607 <tr valign=top>
1608 <td><strong>&lt;Excerpt&gt;</strong></td>
1609 <td>&lt;blockquote&gt;</td>
1610 </tr>
1611 <tr valign=top>
1612 <td><strong>&lt;Lang&gt;&lt;Param&gt;<var>lang</var>&lt;/Param&gt;</strong></td>
1613 <td>&lt;div lang="<var>lang</var>"&gt;</td>
1614 </tr>
1615 </table>
1616 </center>
1617
1618 <p>Character data will be translated as specified by the
1619 <a href="charsetconverters.html">CHARSETCONVERTERS</a> resources.
1620 </p>
1621
1622 <H3><a name="m2h_text_html">m2h_text_html::filter</a></h3>
1623
1624 <table class="caution" width="100%">
1625 <tr valign=top>
1626 <td><strong style="color: red;">CAUTION:</strong></td>
1627 <td width="100%"><p>For
1628 <a href="../faq/security.html#htmldata">security reasons</a>,
1629 it is highly recommended to disable
1630 support of HTML messages in your mail archives. There is no
1631 guarantee this filter is robust enough to eliminate all possible
1632 exploits that can occur with HTML data.
1633 See the following <a href="../faq/faq.html">FAQ</a> questions for more
1634 information:
1635 </p>
1636 <ul>
1637 <li><a href="../faq/security.html#htmldata">Why are HTML messages a security risk?</a></li>
1638 <li><a href="../faq/security.html#htmlexchow">So how can I exclude HTML mail?</a></li>
1639 </ul>
1640 <p> </p>
1641 </td>
1642 </tr>
1643 </table>
1644
1645 <p>This filter is designed to process <tt>text/html</tt>, or
1646 <tt>text/x-html</tt>, data.
1647 The following modifications are done to HTML documents when
1648 processed by MHonArc:
1649 </p>
1650 <ul>
1651 <li><p>The HEAD element is removed. Since some content within the HEAD
1652 element may be relevant to the rest of the document, the following is
1653 done when the HEAD element is removed:</p>
1654 <ul>
1655 <li>The title will be extracted and prepended
1656 to the body data.</li>
1657 <li>Any BASE URL will be propogated to relative URLs in the
1658 document.</li>
1659 </ul>
1660 <p></p>
1661 </li>
1662 <li><p>Any markup related to scripting is removed for security
1663 reasons. Javascript URLs are munged to make them ineffective.
1664 At a minimum, the following tags are stripped:
1665 <tt>&lt;applet&gt;</tt>,
1666 <tt>&lt;base&gt;</tt>,
1667 <tt>&lt;embed&gt;</tt>,
1668 <tt>&lt;form&gt;</tt>,
1669 <tt>&lt;ilayer&gt;</tt>,
1670 <tt>&lt;input&gt;</tt>,
1671 <tt>&lt;layer&gt;</tt>,
1672 <tt>&lt;link&gt;</tt>,
1673 <tt>&lt;meta&gt;</tt>,
1674 <tt>&lt;object&gt;</tt>,
1675 <tt>&lt;option&gt;</tt>,
1676 <tt>&lt;param&gt;</tt>,
1677 <tt>&lt;script&gt;</tt>,
1678 <tt>&lt;select&gt;</tt>,
1679 <tt>&lt;style&gt;</tt>,
1680 <tt>&lt;textarea&gt;</tt>.
1681 At a minimum, the following attributes are removed:
1682 <tt>onload</tt>,
1683 <tt>onunload</tt>,
1684 <tt>onclick</tt>,
1685 <tt>ondblclick</tt>,
1686 <tt>onmousedown</tt>,
1687 <tt>onmouseup</tt>,
1688 <tt>onmouseover</tt>,
1689 <tt>onmousemove</tt>,
1690 <tt>onmouseout</tt>,
1691 <tt>onkeypress</tt>,
1692 <tt>onkeydown</tt>,
1693 <tt>onkeyup</tt>.
1694 The <strong><tt>allowscript</tt></strong> option can be
1695 be used to override this behavior (see below).
1696 </p></li>
1697 <li><p><b><tt>cid:</tt></b> URLs are resolved, if possible. Therefore,
1698 if image data related to the HTML document is included with the message,
1699 the URLs in the HTML will be modified to reference the decoded image
1700 data.
1701 </p>
1702 </li>
1703 </ul>
1704
1705 <p><strong><tt>m2h_text_html::filter</tt></strong> can take the
1706 following
1707 <a href="mimeargs.html">MIMEARGS arguments</a>:
1708 </p>
1709
1710 <table cellspacing=1 border=0 cellpadding=4>
1711 <tr valign=top>
1712 <td><strong><tt>allowcomments</tt></strong></td>
1713 <td><p>Preserve any comment declarations.
1714 By default, comment declarations are munged
1715 to protect against potential exploits, but this option will
1716 disable that behavior.
1717 </p>
1718 <table class="caution" width="100%">
1719 <tr valign=top>
1720 <td><strong style="color: red;">CAUTION:</strong></td>
1721 <td width="100%"><p>
1722 Using this option can open up security vulnerabilies, including the
1723 accessing of server resources. If you have server-side includes
1724 enabled for your site, you SHOULD NOT use this option.
1725 </p>
1726 </td></tr></table>
1727 </td>
1728 </tr>
1729 <tr valign=top>
1730 <td><strong><tt>allownoncidurls</tt></strong></td>
1731 <td><p>Preserve URL-based attributes that are not cid: URLs.
1732 By default, any URL-based attribute -- <tt>href</tt>, <tt>src</tt>,
1733 <tt>background</tt>, <tt>classid</tt>, <tt>data</tt>, <tt>longdesc</tt>
1734 -- will be stripped if it is not a cid URL.
1735 This prevents
1736 malicious URLs from verifying mail addresses, secretly
1737 setting cookies, or gathering statistical data with the
1738 use of elements that cause browsers to automatically fetch data without
1739 user interaction:
1740 <tt>IMG</tt>, <tt>BODY</tt>, <tt>IFRAME</tt>, <tt>FRAME</tt>,
1741 <tt>OBJECT</tt>, <tt>SCRIPT</tt>, <tt>INPUT</tt>.
1742 </p>
1743 <table class="note" width="100%">
1744 <tr valign=top>
1745 <td><strong>NOTE:</strong></td>
1746 <td width="100%"><p><tt>Href</tt> attributes for anchor, <tt>&lt;A&gt;</tt>,
1747 elements are preserved, even if <tt>allownoncidurls</tt> is
1748 not specified. This is so regular hyperlinks will function. Javascript
1749 URLs will still be munged (unless the <tt>allowscript</tt> option is
1750 specified).
1751 </p>
1752 </td></tr></table>
1753 </td>
1754 </tr>
1755 <tr valign=top>
1756 <td><strong><tt>allowscript</tt></strong></td>
1757 <td><p>Preserve any markup associated with scripting.
1758 This includes elements and attributes related to scripting.
1759 </p>
1760 <table class="caution" width="100%">
1761 <tr valign=top>
1762 <td><strong style="color: red;">CAUTION:</strong></td>
1763 <td width="100%"><p>
1764 Use of this option can open up your archives to cross-site scripting (XSS)
1765 attacks. It is highly recommended to NOT use this option, especially
1766 for publicly accessible archives.
1767 </p>
1768 </td></tr></table>
1769 </td>
1770 </tr>
1771 <tr valign=top>
1772 <td><strong><tt>attachcheck</tt></strong></td>
1773 <td><p>Honor attachment disposition. By default,
1774 all text/html data is displayed inline on
1775 the message page. If <tt>attachcheck</tt> is specified
1776 and Content-Disposition specifies the data as
1777 an attachment, the data is saved to a file
1778 with a link to it from the message page.
1779 </p>
1780 <table class="caution" width="100%">
1781 <tr valign=top>
1782 <td><strong style="color: red;">CAUTION:</strong></td>
1783 <td width="100%"><p>
1784 If <tt>attachcheck</tt> is specified, the HTML
1785 data is saved "as-is". For example, no stripping of scripting-based
1786 markup is performed and no resolution of cid URLs are performed, allowing
1787 your archive to be used for cross-site scripting (XSS) exploits.
1788 This option <strong>SHOULD NOT BE USED</strong> for archives unless all mail
1789 from all senders can be trusted.
1790 </p>
1791 </td></tr></table>
1792 </td>
1793 </tr>
1794 <tr valign=top>
1795 <td><strong><tt>disablerelated</tt></strong></td>
1796 <td><p>Disable processing of related parts processing:
1797 cid URLs will not be resolved.
1798 </p></td>
1799 </tr>
1800 <tr valign=top>
1801 <td><strong><tt>nofont</tt></strong></td>
1802 <td><p>Remove font tags and styles, including CSS styles.
1803 </p></td>
1804 </tr>
1805 <tr valign=top>
1806 <td><strong><tt>notitle</tt></strong></td>
1807 <td><p>Do not print extracted title at the beginning of converted
1808 output. By default, the title is printed before the document
1809 body. The <tt>notitle</tt> argument disables this behavior.
1810 </p></td>
1811 <tr valign=top>
1812 <td><strong><tt>subdir</tt></strong></td>
1813 <td><p>Place attachment files in a subdirectory of the archive.
1814 This option is used for MHTML messages that include inline images
1815 are other referenced data.
1816 </p></td>
1817 </tr>
1818 </table>
1819
1820 <H3><a name="m2h_text_plain">m2h_text_plain::filter</a></h3>
1821
1822 <p>This filter is designed to process text/plain messages and
1823 messages with no MIME information. The
1824 filter is also used to process text messages of an unknown
1825 subtype.
1826 </p>
1827
1828 <p>The default behavior of the filter is to wrap the data in
1829 the HTML <tt>PRE</tt> element and escape special characters. It
1830 also converts text that looks like a URL into a hyperlink.
1831 Character data will be translated as specified by the
1832 <a href="charsetconverters.html">CHARSETCONVERTERS</a> resources.
1833 </p>
1834
1835 <p>This filter supports text data donoted with flowed sematics as
1836 defined by <a href="http://www.ietf.org/rfc/rfc2646.txt">RFC 2646</a>.
1837 Quoted text will be wrapped in HTML <tt>BLOCKQUOTE</tt> tags with
1838 inline CSS styles to highlight quoted text with a vertical bar in the
1839 left margin:
1840 </p>
1841 <blockquote style="border-left: #0000FF solid 0.1em; margin-left: 0.0em; padding-left: 1.0em">This is some quoted text.
1842 This is some quoted text.
1843 This is some quoted text.
1844 This is some quoted text.
1845 This is some quoted text.</blockquote>
1846
1847 <p>CSS style customization can be done by using the
1848 <tt>quoteclass</tt> argument described below.
1849 </p>
1850
1851 <p><strong><tt>m2h_text_plain::filter</tt></strong> can take the
1852 following
1853 <a href="mimeargs.html">MIMEARGS arguments</a>:
1854 </p>
1855
1856 <table cellspacing=1 border=0 cellpadding=4>
1857
1858 <tr valign=top>
1859 <td><strong><tt>asis=</tt></strong><var>set1</var><tt>:</tt>...</td>
1860 <td><p>Colon separated lists of charsets to leave as-is.
1861 Only HTML special characters will be converted into entities.
1862 </p>
1863 <table class="note" width="100%">
1864 <tr valign=top>
1865 <td><strong>NOTE:</strong></td>
1866 <td width="100%"><p>The <tt>asis</tt> option is deprecated.
1867 It is recommended to use the
1868 <a href="charsetconverters.html">CHARSETCONVERTERS</a> resource to
1869 control how character data is converted.
1870 </p>
1871 </td></tr></table>
1872 </tr>
1873 <tr valign=top>
1874 <td><strong><tt>attachcheck</tt></strong></td>
1875 <td><p>Honor attachment disposition. By default,
1876 all text/plain data is displayed inline on
1877 the message page. If <tt>attachcheck</tt> is specified
1878 and Content-Disposition specifies the data as
1879 an attachment, the data is saved to a file
1880 with a link to it from the message page.
1881 </p>
1882 </tr>
1883 <tr valign=top>
1884 <td><strong><tt>disableflowed</tt></strong></td>
1885 <td><p>Flowed sematics will be ignored for text denoted with flowed
1886 formatting.
1887 </p>
1888 <table class="note" width="100%">
1889 <tr valign=top>
1890 <td><strong>NOTE:</strong></td>
1891 <td width="100%"><p>
1892 The effects of <tt>fancyquote</tt> and
1893 <tt>quote</tt> will still occur if either option is specified.
1894 </p>
1895 </td></tr></table>
1896 </tr>
1897 <tr valign=top>
1898 <td><strong><tt>fancyquote</tt></strong></td>
1899 <td><p>Highlight quoted message text. Quoted text will be wrapped
1900 in HTML <tt>BLOCKQUOTE</tt> elements. By default, inline CSS style
1901 settings are generated to render a vertical bar in the left margin. The
1902 inline styles are suppressed if the <tt>quoteclass</tt> option is set.
1903 </p>
1904 <p>This option generates similiar rendering of quoted text as is done
1905 for flowed text data, but without the flowed text wrapping sematics.
1906 </p>
1907 <table class="note" width="100%">
1908 <tr valign=top>
1909 <td><strong>NOTE:</strong></td>
1910 <td width="100%"><p>
1911 If message text is denoted as flowed text by
1912 message headers, the text will always be rendered with flowed sematics
1913 unless the <tt>disableflowed</tt> option is specified.
1914 </p>
1915 </td></tr></table>
1916 </tr>
1917 <tr valign=top>
1918 <td><strong><tt>htmlcheck</tt></strong></td>
1919 <td><p>Check if message is actually an HTML message
1920 (to get around abhorrent MUAs). The message
1921 is treated as HTML if the first non-whitespace
1922 data looks like the start of an HTML document.
1923 </p>
1924 <p>If the data looks like HTML, the <a href="#m2h_text_html">HTML filter</a>
1925 will be invoked on it.
1926 </p>
1927 </tr>
1928 <tr valign=top>
1929 <td><strong><tt>inlineexts=</tt></strong><var>ext1</var><tt>,</tt>...</td>
1930 <td><p>A comma separated list of message specified filename
1931 extensions to treat as inline data.
1932 Applicable only when <b><tt>uudecode</tt></b> and
1933 <b><tt>usename</tt></b> are specified.
1934 </p>
1935 </tr>
1936 <tr valign=top>
1937 <td><strong><tt>keepspace</tt></strong></td>
1938 <td><p>Preserve all spaces if the <strong><tt>nonfixed</tt></strong>
1939 option is specified. All spaces and tabs will be translated to the
1940 equivalent number of <strong>&amp;nbsp;</strong> entity references.
1941 </p>
1942 </tr>
1943 <tr valign=top>
1944 <td><strong><a name="tpa_link"><tt>link=</tt></strong><var>scheme1</var><tt>,</tt>...</a></td>
1945 <td><p>A comma separated list of URL schemes denoting which URLs
1946 to convert into hyperlinks. By default, all URLs will be converted
1947 into hyperlinks. This option allows you to restrict the set of
1948 URLs converted.
1949 </p>
1950 <p>Compare this argument with <a href="#tpa_nolink"><tt>nolink</tt></a>.
1951 </p>
1952 </tr>
1953 <tr valign=top>
1954 <td><strong><tt>maxwidth=</tt></strong><var>#</var></td>
1955 <td><p>Force the maximum width of lines to be <var>#</var> characters
1956 in length. Any lines longer than <var>#</var> characters will be
1957 wrapped.
1958 </p>
1959 <table class="note" width="100%">
1960 <tr valign=top>
1961 <td><strong>NOTE:</strong></td>
1962 <td width="100%"><p>A line that contains no whitespace and is longer
1963 than <tt>maxwidth</tt>, will not be wrapped.
1964 </p>
1965 </td></tr></table>
1966 </tr>
1967 <tr valign=top>
1968 <td><strong><a name="tpa_nolink"><tt>nolink=</tt></strong><var>scheme1</var><tt>,</tt>...</a></td>
1969 <td><p>A comma separated list of URL schemes denoting which URLs
1970 to <strong>not</strong> convert into hyperlinks. By default, all
1971 URLs will be converted into hyperlinks.
1972 This option allows you to specify URLs that should never be converted.
1973 </p>
1974 <p>Compare this argument with <a href="#tpa_link"><tt>link</tt></a>.
1975 </p>
1976 </tr>
1977 <tr valign=top>
1978 <td><strong><tt>nonfixed</tt></strong></td>
1979 <td><p>Do not wrap message text in the HTML <tt>PRE</tt> element. This will
1980 cause text to be rendered in the default font (which is normally
1981 proportionally spaced). Each line of the message will have
1982 a <tt>&lt;br&gt;</tt> appended in order to preserve the line representation
1983 of the message.
1984 </p>
1985 </tr>
1986 <tr valign=top>
1987 <td><strong><tt>nourl</tt></strong></td>
1988 <td><p>Do not hyperlink URLs. This option overrides
1989 <tt>link</tt> and <tt>nolink</tt>.
1990 </p>
1991 </tr>
1992 <tr valign=top>
1993 <td><strong><tt>quote</tt></strong></td>
1994 <td><p>Italicize quoted message text. Any quoted lines in the message
1995 will be wrapped in the HTML <tt>I</tt> element.
1996 Compare this option with the <tt>fancyquote</tt> option.
1997 </p>
1998 </tr>
1999 <tr valign=top>
2000 <td><strong><tt>quoteclass=</tt></strong><var>classname</var></td>
2001 <td><p>CSS classname to use for quoted text. This option applies only
2002 for flowed text data or if <tt>fancyquote</tt> is specified. The
2003 <var>classname</var> will be the value of the <tt>CLASS</tt> attbribute
2004 for the <tt>BLOCKQUOTE</tt> elements, and this option suppresses the
2005 generation of inline styles.
2006 </p>
2007 <p>This option is useful if a master stylesheet controls the
2008 appearance of archives. By using this option, the master stylesheet
2009 can be used to control the rendering of quoted text.
2010 </p>
2011 </tr>
2012 <tr valign=top>
2013 <td><strong><tt>subdir</tt></strong></td>
2014 <td><p>Place attachment files in a subdirectory of the archive.
2015 This option is only applicable if <b><tt>uudecode</tt></b> is specified.
2016 </p></td>
2017 </tr>
2018 <tr valign=top>
2019 <td><strong><tt>target=</tt></strong><var>name</var></td>
2020 <td><p>Set the TARGET attribute of anchors generated from
2021 hyperlinking URLs.
2022 </p>
2023 </tr>
2024 <tr valign=top>
2025 <td><strong><tt>usename</tt></strong></td>
2026 <td><p>When decoding uuencoded data, use the full filename specified
2027 in the message instead of the filename extension.
2028 </p>
2029 <table class="caution" width="100%">
2030 <tr valign=top>
2031 <td><strong style="color: red;">CAUTION:</strong></td>
2032 <td width="100%"><p>
2033 Use this option with caution
2034 since it can lead to filename conflicts and
2035 security problems. If you plan on using <tt>usename</tt>, consider
2036 using the <tt>subdir</tt> option with it.
2037 </p>
2038 </td></tr></table>
2039 </td>
2040 </tr>
2041 <tr valign=top>
2042 <td><strong><tt>uudecode</tt></strong></td>
2043 <td><p>Decode any embedded uuencoded data. Including uuencoded data
2044 within messages was a way to transmit binary data
2045 via email before MIME was developed. The inclusion of uuencoded
2046 data is deprecated within email, but is still common in the
2047 USENET (binary) newsgroups.
2048 </p>
2049 <p>Uuencoded data is treated as <tt>application/octet-stream</tt>
2050 for data exclusion purposes: <a href="mimeexcs.html">MIMEEXCS</a>.
2051 If <tt>application/octet-stream</tt> data is listed
2052 in MIMEEXCS, uuencoded data will be excluded.
2053 </p>
2054 <table class="note" width="100%">
2055 <tr valign="baseline">
2056 <td><strong>NOTE:</strong></td>
2057 <td width="100%"><p>Specifying <b><tt>uudecode</tt></b>
2058 adds extra
2059 overhead in the processing of text messages, including messages without
2060 any uuencoded data.
2061 </p>
2062 </td>
2063 </tr>
2064 </table>
2065 </td>
2066 </tr>
2067
2068 </table>
2069
2070 <H3><a name="m2h_text_tsv">m2h_text_tsv::filter</a></h3>
2071
2072 <p>This filter converts text/tab-separated-values to HTML. The
2073 tabular data will be converted into an HTML table.
2074 </p>
2075
2076 <H3><a name="m2h_null">m2h_null::filter</a></h3>
2077
2078 <p>This filter can be used to exclude message content from archives.
2079 You can register this filter to any content-type you do not want
2080 to store in your archives. For example, the following resource setting
2081 excludes all images:
2082 </p>
2083 <pre class="code">
2084 <b>&lt;MIMEFilters&gt;</b>
2085 image/*; m2h_null::filter</a>; mhnull.pl
2086 <b>&lt;/MIMEFilters&gt;</b>
2087 </pre>
2088 <p>The markup returned by this filter displays the one line description
2089 of what was excluded. Examples:
2090 </p>
2091 <pre class="code">
2092 &lt;&lt;attachment: HelloWorld.jpg&gt;&gt;
2093 &lt;&lt;application/postscript&gt;&gt;
2094 &lt;&lt;inline: image/jpg&gt;&gt;
2095 </pre>
2096 <p>If the disposition is available, it will be shown. If a filename
2097 was specified, it will be shown. If there was no filename, the
2098 content-type is shown.
2099 </p>
2100
2101 <table class="note" width="100%">
2102 <tr valign=top>
2103 <td><strong>NOTE:</strong></td>
2104 <td width="100%"><p>The sematics of using the
2105 <a href="mimeexcs.html">MIMEEXCS</a> resource vs this filter are different.
2106 When using this filter, MHonArc considers the data
2107 successfully converted. But with <a href="mimeexcs.html">MIMEEXCS</a>,
2108 MHonArc does not consider the data converted. This is relevant when
2109 MHonArc determines which alternative part to use for an
2110 <tt>multipart/alternative</tt> entity.
2111 </p>
2112 </td>
2113 </tr>
2114 </table>
2115
2116 <!-- *************************************************************** -->
2117 <hr>
2118 <h2><a name="default">Default Setting</a></h2>
2119
2120 <table class="note" width="100%">
2121 <tr valign=top>
2122 <td><strong>NOTE:</strong></td>
2123 <td width="100%"><p>It is important to have an explicit entry for
2124 <b><tt>application/octet-stream</tt></b> for handling unknown
2125 media-types.
2126 </p>
2127 </td>
2128 </tr>
2129 </table>
2130
2131 <PRE class="code">
2132 <b>&lt;MIMEFilters&gt;</b>
2133 application/octet-stream; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2134 application/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2135 application/x-patch; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2136 audio/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2137 chemical/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2138 model/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2139 image/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2140 message/delivery-status; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2141 message/external-body; <a href="#m2h_msg_extbody">m2h_msg_extbody::filter</a>; mhmsgextbody.pl
2142 message/partial; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2143 text/*; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2144 text/enriched; <a href="#m2h_text_enriched">m2h_text_enriched::filter</a>; mhtxtenrich.pl
2145 text/html; <a href="#m2h_text_html">m2h_text_html::filter</a>; mhtxthtml.pl
2146 text/plain; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2147 text/richtext; <a href="#m2h_text_enriched">m2h_text_enriched::filter</a>; mhtxtenrich.pl
2148 text/tab-separated-values; <a href="#m2h_text_tsv">m2h_text_tsv::filter</a>; mhtxttsv.pl
2149 text/x-html; <a href="#m2h_text_html">m2h_text_html::filter</a>; mhtxthtml.pl
2150 video/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl
2151 x-sun-attachment; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl
2152 <b>&lt;/MIMEFilters&gt;</b>
2153 </PRE>
2154
2155
2156 <!-- *************************************************************** -->
2157 <hr>
2158 <h2><a name="rcvars">Resource Variables</a></h2>
2159
2160 <p>N/A
2161 </p>
2162
2163 <!-- *************************************************************** -->
2164 <hr>
2165 <h2><a name="examples">Examples</a></h2>
2166
2167 <p>The following code is an example filter for converting
2168 <tt>text/tab-separated-values</tt> into an HTML table:
2169 </p>
2170 <pre class="code">
2171 package m2h_text_tsv;
2172
2173 sub filter {
2174 my($fields, $data, $isdecode, $args) = <!--
2175 -->&#64;<!--
2176 -->_;
2177 my($field, $line, $ret);
2178 local($_);
2179
2180 $$data =~ s/^\s+//;
2181 $ret = "&lt;table border=1&gt;\n";
2182 foreach $line (split(/\r?\n/, $$data)) {
2183 $ret .= "&lt;tr&gt;";
2184 foreach $field (split(/\t/, $line)) {
2185 $ret .= '&lt;td&gt;' . mhonarc::htmlize($field) . '&lt;/td&gt;';
2186 }
2187 $ret .= "&lt;/tr&gt;\n";
2188 }
2189 $ret .= "&lt;/table&gt;\n";
2190 ($ret);
2191 }
2192
2193 1;
2194 </pre>
2195
2196 <!-- *************************************************************** -->
2197 <hr>
2198 <h2><a name="version">Version</a></h2>
2199
2200 <p>1.0
2201 </p>
2202
2203 <!-- *************************************************************** -->
2204 <hr>
2205 <h2><a name="seealso">See Also</a></h2>
2206
2207 <p>
2208 <a href="charsetconverters.html">CHARSETCONVERTERS</a>,
2209 <a href="mimealtprefs.html">MIMEALTPREFS</a>,
2210 <a href="mimeargs.html">MIMEARGS</a>,
2211 <a href="mimedecoders.html">MIMEDECODERS</a>,
2212 <a href="mimeexcs.html">MIMEEXCS</a>,
2213 <a href="perlinc.html">PERLINC</a>
2214 </p>
2215
2216 <!-- *************************************************************** -->
2217 <hr>
2218 <!--x-rc-nav-->
2219 <table border=0><tr valign="top">
2220 <td align="left" width="50%">[Prev:&nbsp;<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:&nbsp;<a href="mimeincs.html">MIMEINCS</a>]</td></tr></table>
2221 <!--/x-rc-nav-->
2222 <hr>
2223 <address>
2224 $Date: 2010/12/31 20:33:59 $ <br>
2225 <img align="top" src="../monicon.png" alt="">
2226 <a href="http://www.mhonarc.org"><strong>MHonArc</strong></a><br>
2227 Copyright &#169; 1997-2005 <a href="http://www.mhonarc.org/~ehood/">Earl Hood</a>, <a href="mailto:mhonarc&#37;40mhonarc.org">mhonarc<!--
2228 -->&#64;<!--
2229 -->mhonarc.org</a><br>
2230 </address>
2231
2232 </body>
2233 </html>