home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / filutl / ascify13.arc / ASCIFY.DOC < prev   
Text File  |  1988-11-19  |  3KB  |  104 lines
  1.  
  2. ASCIFY.COM by Mark Adler  Pasadena, CA  1987.
  3.  
  4. ASCIFY converts one or more files into a single standard text file with
  5. error checking and optional encryption.  It can also read such a file
  6. and recreate the original files.  It's purpose is to allow the sending
  7. of arbitrary PC binary files over text only links, such as nationwide
  8. mail networks like BITNET and ARPANET.
  9.  
  10. To convert to a single text file, use ASCIFY with two arguments:
  11.  
  12.      ascify *.* util.asc
  13.  
  14. This will create the text file UTIL.ASC which contains all the files in
  15. the current directory.
  16.  
  17. To convert an ASCIFY file back to its original files, use ASCIFY with
  18. just one argument:
  19.  
  20.      ascify util.asc
  21.  
  22. This will recreate the files to the current directory, including the
  23. original date and time stamps.  ASCIFY also checks that the file came
  24. across faithfully using check characters (CRC's) after each 1/2 K.
  25.  
  26. The data can be encrypted as well.  Use a slash followed by a one to
  27. five letter key.  Upper and lower case are significant in the key:
  28.  
  29.      ascify *.* util.enc/zztop
  30.  
  31. and to decode it:
  32.  
  33.      ascify util.enc/zztop
  34.  
  35. If you enter the key "?", then you will be prompted for the key and when
  36. you type it, it will not be echoed.  For example:
  37.  
  38.      ascify util.enc/?
  39.  
  40. and you will be prompted:
  41.  
  42.      Enter key: _
  43.  
  44. If you want help on the ASCIFY command, simply enter it with no
  45. arguments:
  46.  
  47.      ascify
  48.  
  49. Note that ASCIFY is, in a sense, the opposite of compaction utilities
  50. (like Phil Katz's PAK) since its output is larger than its input (about
  51. 30% larger).  It is recommended that you use a compaction utility on the
  52. files to be sent, and then use ASCIFY on the result to reduce the size
  53. of final file to be sent over the network.  For example:
  54.  
  55.      pak a util *.*
  56.      ascify util.arc util.enc/zztop
  57.  
  58. will create a (hopefully) smaller file than "ascify *.* util.asc".  Then
  59. use:
  60.  
  61.      ascify util.enc/zztop
  62.      unpak util.arc
  63.  
  64. to reconstruct the files sent.  Using a compaction utility also improves
  65. the security of encryption.
  66.  
  67. Whoever is getting the file at the other end will need ASCIFY, whatever
  68. compaction utility you used, if any, and the key you used, if any, to
  69. reconstruct the files contained in the text file.  To get ASCIFY over
  70. the network, simply send the ASCIFY.ASM file to your network buddy and
  71. hope that she can find MASM, the Microsoft Macro Assembler, and run it
  72. as follows:
  73.  
  74.      masm ascify;
  75.      link ascify;               (ignore the no stack segment message)
  76.      exe2bin ascify ascify.com
  77.      del ascify.exe
  78.  
  79. Or the Borland Turbo Assembler and use:
  80.  
  81.      tasm ascify
  82.      tlink/t ascify
  83.  
  84. Alternatively, you can mail ASCIFY.COM on a diskette.  Once you get
  85. ASCIFY over, you can use ASCIFY to send the compaction utility you are
  86. using.  If you find the need to use encryption, you should not send the
  87. keys over the network in any way---even in an encrypted file.  Keys are
  88. only secure if sent by another medium, such as the telephone or the U.S.
  89. mail.
  90.  
  91. Version History -
  92.  
  93. 1.0     11 Apr 87       First distrbuted version.
  94. 1.1     14 Apr 87       Write failures caught, encode slightly sped up.
  95. 1.2     16 Apr 87       Archive bit set on output, check DOS version.
  96. 1.3     21 Apr 87       Added hidden key input.
  97.  
  98. Feel free to send any problems with or comments on ASCIFY.COM to:
  99.  
  100.         Mark Adler
  101.         P.O. Box 60998
  102.         Pasadena, CA  91106
  103.  
  104.