Test -mime utility

Test a message&#x27;s MIME structure.

Syntax
imsimta test -mime &#x5b;input-file &#x5b;output-file&#x5d;&#x5d;

Restrictions
None.

Parameter specifying the name of the input message file.

Optional parameter specifying a file to which to write the utility&#x27;s output. If no output file is specified, the output is written to the terminal.

Description
may be used to test and analyze, or convert, a message&#x27;s MIME structure. When used with   or , the utility&#x27;s output is  respectively the result of converting, or constructing an archive  version of, the message. When used with  and  , the utility runs the specified  Sieve filter  and/or channel configured spam/virus filtering. Otherwise, the output is an analyzed (and, depending on the switches specified, optionally  somewhat annotated) copy of the original message.

,   (default)
(New in MS 6.3.)  cannot be used with    or. The default is. Specifying    causes the MTA to  write an archive file per the configuration of the specified archive  channel.

,  (default)
(New in 7.0.5)  The   switch may be used when    is used; it must be used if it is desired to engage  spam/virus filter package scanning. If  is  specified without an argument, then the channel defaults to the setting  of the   MTA option, or the  local channel if   is  not set. Note that spam/virus filter package scanning is only engaged if   is explicitly specified.

,  (default)
cannot be used with  or.

,
only matters when  has been  specified. Setting  overrides any setting of    or  : depending upon  whether the specified new charset is one known to the MTA the describe  flag is either set, or cleared, respectively. In the absence of , setting either   or    will force the describe flag to be set. When the describe flag is set, due either to one of the above-mentioned override  effects, or otherwise via explicit   switch use,  then a Content-transfer-encoding: header line and a Content-MD5: header  line can be added to message parts.

,
Specifying  sets the  "eight always" handling;  specifying   sets the  "seven only" handling. Note that the default behavior corresponds to neither keyword, corresponding instead to  "eight negotiate" handling.

The default is. Valid values for the encoding keyword are: ,  ,   ,  ,  ,   ,  ,  ,   ,  ,  ,   ,  ,  ,   , or.

cannot be used unless  is used. When  is used, the default is. The valid keyword arguments for   are: ,  ,   ,  ,  , and.

(default),
New in MS 6.3. The default is, which means  to interpret (decode) message content whose encoding is described by  the non-standard Encoding: header line. Specifying   means to ignore any such Encoding: header  line; that is, not perform decoding. These switches are thus analogues of the channel options    and.

(default),
New in MS 6.3. The default is, which means  to interpret (decode) encodings of MIME message parts; note that such  encodings are illegal, but may sometimes be encountered in messages  from incompliant software. Specifying  means  to ignore any such Content-transfer-encoding: illegally present on a  message part. These switches are thus analogues of the channel options   and.

(default),
New in MS 6.3. The default is, which  means to interpret (decode) encodings of MIME multiparts; note that  such encodings are illegal, but may sometimes be encountered in  messages from incompliant software. Specifying   means to ignore any such  Content-transfer-encoding: illegally present on a multipart. These switches are thus analogues of the channel options     and.

,  (default)
cannot be used with  or.

Valid arguments for  are:  ,  ,   or   ,  , or. The default is.

Valid arguments for  are: ,   ,  ,   ,  ,   ,  ,   ,  ,  ,   ,  ,   ,  ,. means.

(default),
The  switch is ignored when used with    or. When used with   (or with none of ,   , or  ), it tells the utility  to output initial table heading lines prior to its output analyzing the  message structure. Combined with,    causes table heading lines of: Line # ? -- - Or if none of,  , or    is specified, then   causes  table heading lines of: Line # Level Count ? -- - - - Note that  is the default; specifying    disables this table heading output.

,  (default)
is equivalent to.

(New in MS 6.0) Specify a maximum allowed length for the NAME parameter and for the FILENAME parameter on the Content-type: and  Content-disposition: MIME header lines, respectively; longer parameters  will be truncated. This switch is thus an analogue of the    channel option. The default is 128.

Note that other, general parameters on the Content-type: and Content-disposition: MIME header  lines are controlled instead via the   switch. (The reason why such lengths are of interest, and why these switches exist, is due to the history in certain popular e-mail clients of  security problems involving buffer overruns.)

(default),
Specifying  turns off the display of line numbers  in the output. is the default.

The default is 0.

(New in MS 6.0) Specify a maximum allowed length for general parameters on Content-type: and Content-disposition: MIME header lines;  longer parameters will be truncated. This switch is thus an analogue of the    channel option. The default is 1024.

Note that the Content-type: NAME parameter and Content-disposition: FILENAME parameter maximum  length are controlled separately via the   switch. (The reason why such lengths of interest, and these switches exist, is due to the history in certain popular e-mail clients of security  problems involving buffer overruns.)

,  (default)
(New in MS 7.0.5)  The   switch specifies a  Sieve expression  to apply to the input message. This emulates   message scanning. If   is specified, then  spam/virus filter package scanning  can be engaged also. If  is not  specified, then spam/virus filter package scanning is not engaged, and  the channel value (when relevant) defaults to the value of the    MTA option.

,  (default)
Specifying  causes the MTA to perform  "sniffing" of non-MIME message bodies for UUENCODE or BINHEX  "blobs" (akin to application of  the   channel option), and to pull such "blobs" out into MIME  attachments instead.

Examples
% imsimta test -mime not-zz.00 Line # Level Count ? -- - - -      1     0     1 H Received: from localhost by elvira.innosoft.com (PMDF V6.0-24 #43970) 2    0     1 H  with ESMTP id &#x3c;0G8P00B01ZFNUV@elvira.innosoft.com&#x3e; for 3    0     1 H  kristin@elvira.innosoft.com (ORCPT kristin@elvira.innosoft.com); Tue, 4    0     1 H  13 Feb 2001 15:47:47 -0800 (PST) 5    0     1 H Date: Tue, 13 Feb 2001 15:47:47 -0800 (PST) 6    0     1 H From: System Privileged Account &#x3c;root@elvira.innosoft.com&#x3e; 7    0     1 H Subject: test of relaying 8    0     1 H To: kristin hubner &#x3c;kristin@elvira.innosoft.com&#x3e; 9    0     1 H Message-id: &#x3c;Pine.SOL.4.21L.0102131547360.15366-100000@elvira.innosoft.com&#x3e; 10    0     1 H MIME-version: 1.0 11    0     1 H Content-type: TEXT/PLAIN; charset=US-ASCII 12    0     1 D ctype: TEXT 13    0     1 D csubtype: PLAIN 14    0     1 D cparameters: 15    0     1 D charset=US-ASCII 16    0     1 B test 17    0     1 B  % imsimta test -mime -line not-zz.00 Line # ? -- -      1 Received: from localhost by elvira.innosoft.com (PMDF V6.0-24 #43970) 2 with ESMTP id &#x3c;0G8P00B01ZFNUV@elvira.innosoft.com&#x3e; for 3 kristin@elvira.innosoft.com (ORCPT kristin@elvira.innosoft.com); Tue, 4 13 Feb 2001 15:47:47 -0800 (PST) 5 Date: Tue, 13 Feb 2001 15:47:47 -0800 (PST) 6 From: System Privileged Account &#x3c;root@elvira.innosoft.com&#x3e; 7 Subject: test of relaying 8 To: kristin hubner &#x3c;kristin@elvira.innosoft.com&#x3e; 9 Message-id: &#x3c;Pine.SOL.4.21L.0102131547360.15366-100000@elvira.innosoft.com&#x3e; 10 MIME-version: 1.0 11 Content-type: TEXT/PLAIN; charset=US-ASCII 12     13 test 14 In the above UNIX example, the  message file  contains: Received: from localhost by elvira.innosoft.com (PMDF V6.0-24 #43970) with ESMTP id &#x3c;0G8P00B01ZFNUV@elvira.innosoft.com&#x3e; for kristin@elvira.innosoft.com (ORCPT kristin@elvira.innosoft.com); Tue, 13 Feb 2001 15:47:47 -0800 (PST) Date: Tue, 13 Feb 2001 15:47:47 -0800 (PST) From: System Privileged Account &#x3c;root@elvira.innosoft.com&#x3e; Subject: test of relaying To: kristin hubner &#x3c;kristin@elvira.innosoft.com&#x3e; Message-id: &#x3c;Pine.SOL.4.21L.0102131547360.15366-100000@elvira.innosoft.com&#x3e; MIME-version: 1.0 Content-type: TEXT/PLAIN; charset=US-ASCII test

See also:
 * scan_channel MTA Option
 * Archiving messages
 * Spam and virus filtering
 * Local channel
 * eightbit Option
 * sevenbit Option
 * eightnegotiate Option
 * ignoreencoding Option
 * interpretencoding Option
 * ignoremessageencoding Option
 * interpretmessageencoding Option
 * ignoremultipartencoding Option
 * interpretmultipartencoding Option
 * nameparameterlengthlimit Option
 * parameterlengthlimit Option
 * expiresieve Store Option
 * thurman Option
 * MTA command line utilities