Penguin
Recent Changes
Annotated edit history of munpack(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 MUNPACK
2 !!!MUNPACK
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 DECODING MIME
8 ENVIRONMENT
9 FILES
10 ----
11 !!NAME
12
13
14 munpack - unpack messages in MIME or split-uuencode format
15 !!SYNOPSIS
16
17
18 __munpack__ [[ __-f__ ] [[ __-q__ ] [[ __-t__ ] [[
19 __-C__ ''directory'' ] [[ ''filename ...''
20 ]
21 !!DESCRIPTION
22
23
24 The ''munpack'' program reads each RFC-822 message
25 ''filename'' and writes all non-text MIME parts or
26 split-uuencoded files as files. If no filename argument is
27 given, __munpack__ reads from standard
28 input.
29
30
31 If the message suggests a file name to use for the imbedded
32 part, that name is cleaned of potential problem characters
33 and used for the output file. If the suggested filename
34 includes subdirectories, they will be created as necessary.
35 If the message does not suggest a file name, the names
36
37
38 If the imbedded part was preceded with textual information,
39 that information is also written to a file. The file is
40 named the same as the imbedded part, with any filename
41 extension replaced with
42 !!OPTIONS
43
44
45 __-f__
46
47
48 Force overwriting of existing files. If a message suggests a
49 file name of an existing file, the file will be overwritten.
50 Without this flag, __munpack__ appends
51 __
52
53
54 __-q__
55
56
57 Be quiet. Supresses messages about saving partial messages
58 and about messages with no interesting
59 information.
60
61
62 __-t__
63
64
65 Also write the text MIME parts of multipart messages as
66 files. By default, text parts that do not have a filename
67 parameter do not get unpacked. This option effectively
68 disables the
69
70
71 __-C__ ''directory''
72
73
74 Change the current directory to ''directory'' before
75 reading any files. This is useful when invoking
76 __munpack__ from a mail or news reader.
77 !!DECODING MIME
78
79
80 To decode a MIME message, first save it to a text file. If
81 possible, save it with all headers included. ''Munpack''
82 can decode some MIME files when the headers are missing or
83 incomplete, other files it cannot decode without having the
84 information in the headers. In general, messages which have
85 a statement at the beginning that they are in MIME format
86 can be decoded without the headers. Messages which have been
87 split into multiple parts generally require all headers in
88 order to be reassembled and decoded.
89
90
91 Some LAN-based mail systems and some mail providers
92 (including America Online, as of the writing of this
93 document) place the mail headers at the bottom of the
94 message, instead of at the top of the message. If you are
95 having problems decoding a MIME message on such a system,
96 you need to convert the mail back into the standard format
97 by removing the system's nonstandard headers and moving the
98 standard Internet headers at the top of the message
99 (separated from the message body with a blank
100 line).
101
102
103 There must be exactly one message per file. ''Munpack''
104 cannot deal with multiple messages in a single file, to
105 decode things correctly it must know when one message ends
106 and the next one begins.
107
108
109 To decode a message, run the command:
110
111
112 ''munpack'' __file__
113
114
115 where
116 munpack'' will try to decode the message in each file.
117 For more information on ways to run ''munpack'', see the
118 section ''
119 !!ENVIRONMENT
120
121
122 __TMPDIR__
123
124
125 Directory to store temporary files. Default is
126 /var/tmp.
127 !!FILES
128
129
130 __$TMPDIR/m-prts-$USER/__
131
132
133 Directory used to store partial messages awaiting
134 reassembly.
135 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.