home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / mime64.zip / readme.1st < prev    next >
Text File  |  1994-09-30  |  3KB  |  82 lines
  1.  
  2.                    MIME64 Encoder/Decoder
  3.  
  4. WHAT MIME64 IS:  MIME64 is an encoding described in RFC1341 as MIME base64.
  5. Its purpose is to encode binary files into ASCII so that they may be passed
  6. through e-mail gates.  In this regard, MIME64 is similar to UUENCODE.
  7. Although most binaries these days are transmitted using UUENCODE, I
  8. have seen a few using MIME64, and I have had requests from friends that
  9. I decode MIME64 files that have fallen into their hands.  As long as
  10. some MIME64 continues to exist, a package such as this one is useful
  11. to have.
  12.  
  13.  
  14. WHAT THIS PACKAGE CONTAINS:  This package contains both executable
  15. and ANSI-C source code for a MIME64 encoder/decoder (MIME.EXE and
  16. MIME.C respecively).  It also contains this README file, and a MIME64
  17. encoded file called MIME.64.  The latter will decode to MIME.ZIP if
  18. you issue the DOS command line:
  19.  
  20.    MIME64 MIME.64 MIME.ZIP
  21.  
  22. If you unzip the zip file, you will get an essay by Mark Grand about
  23. MIME.
  24.  
  25.  
  26. HOW TO USE THIS PACKAGE:  To decode a MIME64 file you may type:
  27.  
  28.    MIME64 infile outfile
  29.  
  30. If you leave out the outfile specification, the output file will
  31. overwrite the input file unless there is a filename specifier in
  32. the header of the input file.  If there is a file name specifier
  33. in infile, and no outfile is given, the output file will be
  34. according to the specifier.  An example of a filename specifier
  35. in the header of a base64 MIME file is:
  36.  
  37. Content-Type: text/plain; charset=US-ASCII; name=dork.zip
  38.  
  39. The filename specified here is dork.zip.
  40.  
  41. If the input file has a content transfer encoding of any but base64,
  42. that input will be ignored.  For example, if it had a header line of:
  43.  
  44. Content-transfer-encoding: unusualformat
  45.  
  46. instead of:
  47.  
  48. Content-transfer-encoding: base64
  49.  
  50. there would be no output.  If no content-transfer-encoding line is
  51. given in the file, MIME64 assumes the file to be base64 and decodes
  52. it accordingly.
  53.  
  54. There can be several files encoded into an input file.  If subsequent
  55. encoded files are found in the input file, they will be decoded according
  56. to the name specified in a content-type line.
  57.  
  58. To encode a file into MIME64 format, type:
  59.  
  60.    MIME64 infile outfile -e
  61.  
  62. If you leave off the outfile specification, the output will
  63. overwrite the input.  MIME64 does not permit you to encode more than
  64. one file at a time.  If you wish to combine several base64 files,
  65. you will have to do so with a text editor.
  66.  
  67.  
  68. STATUS OF THIS PACKAGE:  This package is freeware.  As author, I
  69. claim no copyright.  If you change the source code and intend to
  70. propogate that change to other users, please include a comment to
  71. that effect at the top that states:  The date of the change, the
  72. nature of the change, and who made the change.  As a courtesy, I also
  73. ask that you retain the comment that acknowledges me as the original
  74. author.
  75.  
  76.  
  77. SEND QUESTIONS ABOUT THIS PACKAGE TO:  hahn@lds.loral.com
  78.  
  79. Karl Hahn
  80.  
  81.  
  82.