4 .TH MHLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 mhlist \- list information about MIME messages
21 .RB [ \-headers " | " \-noheaders ]
22 .RB [ \-verbose " | " \-noverbose ]
29 command allows you to list information (essentially
30 a table of contents) about the various parts of a collection of
31 MIME (multi-media) messages.
34 manipulates MIME (multi-media messages) as specified
35 in RFC\-2045 thru RFC\-2049 (See
40 switch indicates that a one-line banner should be
41 displayed above the listing.
43 \*(lqnative\*(rq (decoded) format of each content is evaluated.
44 This provides an accurate count at the expense of a small delay.
47 switch is present, then the listing will show
48 any \*(lqextra\*(rq information that is present in the message,
49 such as comments in the \*(lqContent-Type\*(rq header.
57 file as the source message, rather than a message from a folder.
58 If you specify this file as \*(lq-\*(rq, then
61 accept the source message on the standard input. Note that the
62 file, or input from standard input should be a validly formatted
63 message, just like any other
67 be in mail drop format (to convert a file in mail drop format to
75 will list information about the entire
76 message (all of its parts). By using the
80 switches, you may limit the scope of this command to particular
81 subparts (of a multipart content) and/or particular content types.
83 A part specification consists of a series of numbers separated by dots.
84 For example, in a multipart content containing three parts, these
85 would be named as 1, 2, and 3, respectively. If part 2 was also a
86 multipart content containing two parts, these would be named as 2.1 and
87 2.2, respectively. Note that the
89 switch is effective for only
90 messages containing a multipart content. If a message has some other
91 kind of content, or if the part is itself another multipart content, the
93 switch will not prevent the content from being acted upon.
95 A content specification consists of a content type and a subtype.
96 The initial list of \*(lqstandard\*(rq content types and subtypes can
97 be found in RFC\-2046.
99 A list of commonly used contents is briefly reproduced here:
103 .ta \w'application 'u
107 multipart mixed, alternative, digest, parallel
108 message rfc822, partial, external-body
109 application octet-stream, postscript
116 A legal MIME message must contain a subtype specification.
118 To specify a content, regardless of its subtype, just use the
119 name of the content, e.g., \*(lqaudio\*(rq. To specify a specific
120 subtype, separate the two with a slash, e.g., \*(lqaudio/basic\*(rq.
121 Note that regardless of the values given to the
124 multipart content (of any subtype listed above) is always acted upon.
129 .ta \w'%etcdir%/ExtraBigFileName 'u
130 ^$HOME/.mmh/profile~^The user profile
133 .SH "PROFILE COMPONENTS"
137 .ta \w'ExtraBigProfileName 'u
138 ^Path:~^To determine the user's mail storage
139 ^Current\-Folder:~^To find the default current folder
143 mhbuild(1), show(1), mhstore(1), sendfiles(1)
147 .RB ` +folder "' defaults to the current folder"
148 .RB ` msgs "' defaults to cur"
154 If a folder is given, it will become the current folder. The last
155 message selected will become the current message.