aboutsummaryrefslogtreecommitdiffstats
path: root/mime64/README
blob: f87e9d5200523421274602465d99ed80d6e0379b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
                   MIME64 Encoder/Decoder

WHAT MIME64 IS:  MIME64 is an encoding described in RFC1341 as MIME base64.
Its purpose is to encode binary files into ASCII so that they may be passed
through e-mail gates.  In this regard, MIME64 is similar to UUENCODE.
Although most binaries these days are transmitted using UUENCODE, I
have seen a few using MIME64, and I have had requests from friends that
I decode MIME64 files that have fallen into their hands.  As long as
some MIME64 continues to exist, a package such as this one is useful
to have.


WHAT THIS PACKAGE CONTAINS:  This package contains both executable
and ANSI-C source code for a MIME64 encoder/decoder (MIME.EXE and
MIME.C respecively).  It also contains this README file, and a MIME64
encoded file called MIME.64.  The latter will decode to MIME.ZIP if
you issue the DOS command line:

   MIME64 MIME.64 MIME.ZIP

If you unzip the zip file, you will get an essay by Mark Grand about
MIME.


HOW TO USE THIS PACKAGE:  To decode a MIME64 file you may type:

   MIME64 infile outfile

If you leave out the outfile specification, the output file will
overwrite the input file unless there is a filename specifier in
the header of the input file.  If there is a file name specifier
in infile, and no outfile is given, the output file will be
according to the specifier.  An example of a filename specifier
in the header of a base64 MIME file is:

Content-Type: text/plain; charset=US-ASCII; name=dork.zip

The filename specified here is dork.zip.

If the input file has a content transfer encoding of any but base64,
that input will be ignored.  For example, if it had a header line of:

Content-transfer-encoding: unusualformat

instead of:

Content-transfer-encoding: base64

there would be no output.  If no content-transfer-encoding line is
given in the file, MIME64 assumes the file to be base64 and decodes
it accordingly.

There can be several files encoded into an input file.  If subsequent
encoded files are found in the input file, they will be decoded according
to the name specified in a content-type line.

To encode a file into MIME64 format, type:

   MIME64 infile outfile -e

If you leave off the outfile specification, the output will
overwrite the input.  MIME64 does not permit you to encode more than
one file at a time.  If you wish to combine several base64 files,
you will have to do so with a text editor.


STATUS OF THIS PACKAGE:  This package is freeware.  As author, I
claim no copyright.  If you change the source code and intend to
propogate that change to other users, please include a comment to
that effect at the top that states:  The date of the change, the
nature of the change, and who made the change.  As a courtesy, I also
ask that you retain the comment that acknowledges me as the original
author.


SEND QUESTIONS ABOUT THIS PACKAGE TO:  hahn@lds.loral.com

Karl Hahn
il file anymore or to standard output any more, and using an MDA for delivery is discouraged. If you throw those options away, fetchmail will now forward your mail into your system's normal Internet-mail delivery path. Actually, using an MDA is now almost always the wrong thing; the MDA facility has been retained only for people who can't or won't run a sendmail-like SMTP listener on port 25. The default, SMTP forwarding to port 25, is better for at least two major reasons. One: it feeds retrieved POP and IMAP mail into your system's normal delivery path along with local mail and normal Internet mail. Two: because the port 25 listener returns a positive acknowledge, fetchmail can be sure you're not going to lose mail to a disk-full or some other resource-exhaustion problem. If you used to use -mda "procmail -d <you>" or something similar, forward to port 25 and do "| procmail -d <you>" in your ~/.forward file. 5. TEST I strongly recommend that your first fetchmail run use the -v and -k options, in case there is something not quite right with your server, your local delivery configuration or your port 25 listener. Also, beware of aliases that direct your local mail back to the server host! This software is known to work with the qpop/popper series of freeware POP3 servers; also with the IMAP2bis and IMAP4 servers that are distributed with Pine from the University of Washington. A couple of users have reported that some recent (post-2.7.2) versions of gcc seem to have an optimizer bug that affects fetchmail. If your fetchmail core dumps (especially near startup) try recompiling without -O. Alternatively, you can drop back to gcc 2.7.2 or below. 6. REPORTING BUGS You should read the FAQ file before reporting a bug. 7. USE IT Enjoy!