1 |
mpack/munpack version 1.5 for mac |
2 |
|
3 |
Mpack and munpack are utilities for encoding and decoding |
4 |
(respectively) binary files in MIME (Multipurpose Internet Mail |
5 |
Extensions) format mail messages. For compatibility with older forms |
6 |
of transferring binary files, the munpack program can also decode |
7 |
messages in split-uuencoded format. The Macintosh version can also |
8 |
decode messages in split-BinHex format. |
9 |
|
10 |
The canonical FTP site for this software is ftp.andrew.cmu.edu:pub/mpack/ |
11 |
Binaries are no longer provided. The pc, os2, amiga and archimedes ports |
12 |
have been removed. The mac version probably doesn't compile anymore, but |
13 |
is still included (MacOS X users can use the unix version...) |
14 |
|
15 |
This MIME implementation is intended to be as simple and portable as |
16 |
possible. For a slightly more sophisticated MIME implementation, see |
17 |
the program MetaMail, available via anonymous FTP to |
18 |
thumper.bellcore.com, in directory pub/nsb |
19 |
|
20 |
more junk |
21 |
|
22 |
Decoding MIME messages: |
23 |
|
24 |
To decode a MIME message, first save it to a text file. If possible, |
25 |
save it with all headers included. Mpack can decode some MIME files |
26 |
when the headers are missing or incomplete, other files it cannot |
27 |
decode without having the information in the headers. In general, |
28 |
messages which have a statement at the beginning that they are in MIME |
29 |
format can be decoded without the headers. Messages which have been |
30 |
split into multiple parts generally require all headers in order to be |
31 |
reassembled and decoded. |
32 |
|
33 |
Some LAN-based mail systems and some mail providers (including America |
34 |
Online, as of the writing of this document) place the mail headers at |
35 |
the bottom of the message, instead of at the top of the message. If |
36 |
you are having problems decoding a MIME message on such a system, you |
37 |
need to convert the mail back into the standard format by removing the |
38 |
system's nonstandard headers and moving the standard Internet headers |
39 |
to the top of the message (separated from the message body with a |
40 |
blank line). |
41 |
|
42 |
There must be exactly one message per file. Mpack cannot deal with |
43 |
multiple messages in a single file, to decode things correctly it must |
44 |
know when one message ends and the next one begins. |
45 |
|
46 |
The Macintosh version of mpack/munpack is a single standalone |
47 |
application. A text file may be decoded either by drag & drop, or by |
48 |
choosing the "Decode Files..." item from the application's File menu. |
49 |
Non-text files may be encoded either by drag & drop, or by choosing |
50 |
the "Encode Files..." item from the application's File menu. |
51 |
|
52 |
The Macintosh version of mpack/munpack supports the new MacMIME |
53 |
standard (RFC 1740). This allows cross-platform transport of |
54 |
Macintosh files to any MIME-capable machine, and also preserves |
55 |
Macintosh specific file attributes between two Macintoshes. Mpack |
56 |
will use MacMIME for any unrecognized Macintosh file, and regular MIME |
57 |
for standard MIME types. |
58 |
|
59 |
For more details and descriptions of the preferences, see the "Help |
60 |
Using Mpack..." menu item in mpack which can be found under the help |
61 |
menu in systems 7 and above, and under the apple menu in older |
62 |
systems. |
63 |
|
64 |
Reporting bugs: |
65 |
|
66 |
Bugs and comments should be reported to mpack-bugs@andrew.cmu.edu. |
67 |
When reporting bugs or other problems, please include the following |
68 |
information: |
69 |
|
70 |
* The version number of Mpack |
71 |
* The platform (Unix, PC, OS/2, Mac, Amiga, Archimedes) |
72 |
* The EXACT output of any unsuccessful attempts. |
73 |
* If having a problem decoding, the first couple of lines |
74 |
of the input file. |
75 |
|
76 |
|
77 |
Compilation: |
78 |
|
79 |
Mpack was compiled with THINK C 6.0 with the 4-byte int option turned |
80 |
on (and the ANSI-small library compiled with the 4-byte int option) |
81 |
and prototype enforcement turned off. Included with this distribution |
82 |
should be the files "macproj.hqx" which is a BinHex4 version of the |
83 |
THINK C 6.0 project file, and "macrsrc.hqx" which is a BinHex4 version |
84 |
of the resources file. |
85 |
|
86 |
Mpack checks for the existence of "Internet Config", and if it is |
87 |
available, mpack uses it to translate MIME types to and from Macintosh |
88 |
type/creator codes. Included is the file "macICglue.hqx" which is a |
89 |
BinHex4 version of Internet Config's MPW object file library. This |
90 |
needs to be linked with the application. |
91 |
|
92 |
Using mpack: |
93 |
|
94 |
See the "Help Using Mpack..." menu item in the application. |
95 |
|
96 |
|
97 |
Acknowledgements: |
98 |
|
99 |
Written by John G. Myers, jgm+@cmu.edu |
100 |
|
101 |
The mac version was written by Christopher J. Newman, chrisn+@cmu.edu |
102 |
|
103 |
Send all bug reports to mpack-bugs@andrew.cmu.edu |
104 |
|
105 |
Thanks to Nathaniel Borenstein for testing early versions of mpack and |
106 |
for making many helpful suggestions. |
107 |
|
108 |
|
109 |
PGP signature: |
110 |
|
111 |
The mpack 1.6 distribution is not pgp signed. |
112 |
|
113 |
Legalese: |
114 |
|
115 |
(C) Copyright 1993,1994 by Carnegie Mellon University |
116 |
All Rights Reserved. |
117 |
|
118 |
Permission to use, copy, modify, distribute, and sell this software |
119 |
and its documentation for any purpose is hereby granted without fee, |
120 |
provided that the above copyright notice appear in all copies and that |
121 |
both that copyright notice and this permission notice appear in |
122 |
supporting documentation, and that the name of Carnegie Mellon |
123 |
University not be used in advertising or publicity pertaining to |
124 |
distribution of the software without specific, written prior |
125 |
permission. Carnegie Mellon University makes no representations about |
126 |
the suitability of this software for any purpose. It is provided "as |
127 |
is" without express or implied warranty. |
128 |
|
129 |
CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO |
130 |
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY |
131 |
AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE |
132 |
FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
133 |
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN |
134 |
AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING |
135 |
OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS |
136 |
SOFTWARE. |
137 |
|
138 |
Portions of this software are derived from code written by Bell |
139 |
Communications Research, Inc. (Bellcore) and by RSA Data Security, |
140 |
Inc. and bear similar copyrights and disclaimers of warranty. |
141 |
|