1 |
edhill |
1.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 |
edhill |
1.2 |
more junk |
21 |
edhill |
1.1 |
|
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 |
|
|
|