home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / utility / archiver / hpack / readme.txt < prev   
Text File  |  1994-04-10  |  10KB  |  232 lines
  1.       *   *  *****  *****  *****  *   *
  2.      *   *  *   *  *   *  *      *  *
  3.     *****  *****  *****  *      ***
  4.    *   *  *      *   *  *      *   *
  5.   *   *  *      *   *  *****  *     *  multi system archiver
  6.  
  7. This is the README for the Atari version of HPACK.
  8.  
  9. 0. General
  10. ----------
  11.  
  12. This version of HPACK is complete, just about every and all feauture
  13. should behave just like it does on all the other systems HPACK runs
  14. on. That means that the original docs for HPACK supplied in this
  15. distribution are valid and SHOULD be read.
  16.  
  17. This README just mentions the few details that differ from other
  18. HPACK versions and gives some hints on how to use features that may
  19. seem "esoteric" to a standard Atari user (i.e. someone that doesn't
  20. know the UNIX operating system).
  21.  
  22. 1. Why using HPACK?
  23. -------------------
  24.  
  25. There are a bunch of archivers available for the Atari, so there may
  26. arise the question of why we need an other one.
  27.  
  28. Well, I don't see HPACK as a direct opponent to archivers as ZIP or
  29. LHarc, at least not on the Atari. I am aware that many users will find 
  30. the speed of HPACK annoying.
  31.  
  32. But there are still some very good reasons to use HPACK. The following
  33. list shows some of them.
  34.  
  35.   - HPACK is available for virtually every system of some importance,
  36.     and all versions are REALLY compatible.
  37.   - HPACK uses powerful unix-style wildcard matching.
  38.   - HPACK allows large archives to be split over several disks.
  39.   - HPACK uses powerful public-key encryption ("military grade")
  40.   - HPACK allows archives to be secured with a "fingerprint" that
  41.     ensures that an archive is not tampered with.
  42.   - HPACK offers "unified" compression.
  43.  
  44. The following chapters give some hints on how to exploit these
  45. advantages.
  46.  
  47. 2. Other versions
  48. -----------------
  49.  
  50. HPACK is available for nearly all systems of a minimum significance.
  51. Unlike with many other archivers, all HPACK versions should behave
  52. just the same - it doesn't make a difference if you use HPACK on
  53. an Atari or a Sun Unix box. It is also no problem to archive the
  54. files on that Sun box and then extract them on your Atari again.
  55. I have seen HPACK binaries for DOS and Mac on the FTP server
  56. src.doc.ic.ac.uk for example.
  57.  
  58. 3. Wildcard matching
  59. --------------------
  60.  
  61. HPACK uses unix-style wildcard matching. You probabely know the
  62. significance of the characters * and ? in a filename. * stands
  63. for a whole sequence of characters, while ? replaces one character.
  64. HPACK also introduces other wildcards like []. To learn more about
  65. them, refer to the full documentation.
  66.  
  67. A fact that may bewilder Atari users at first is that HPACK uses /
  68. as directory delimiter and not \ as it is normal on Ataris.
  69. This means you must use "folder/file" instead of "folder\file".
  70. A second difference is that "*.*" doesn't match ALL the files,
  71. but only files containing a dot. If you want all files, use "*"
  72. instead. So, "folder\files\*.*" will get "folder/files/*".
  73.  
  74. After you got used to this new style file matching, you'll certainly
  75. discover that it is much more flexible and well worth to learn.
  76.  
  77. 4. Multi volume archives
  78. ------------------------
  79.  
  80. HPACK allows large archives to be split in multiple parts if they
  81. don't fit onto your floppy disk (or removable HD media or whatever).
  82. The parts will be fitted together again when you extract the archive.
  83. What makes HPACK interesting, is that this works on all systems
  84. HPACK runs on - that means you can transfer a 10MB file from a Mac
  85. to your Atari by archiving it as a multi volume archive on your
  86. Mac and then extracting it on the Atari - even if you have only
  87. floppy disks for transfer.
  88. If you think HPACK is too slow or if you want to transfer large,
  89. already compressed picture files, try to use HPACK with disabled
  90. compression. HPACK will split the file at lightning speed and
  91. the archive is protected with a CRC checksum all the same, ensuring
  92. that everything will be fitted together nicely again.
  93. This is my way to transfer large files between different computer
  94. systems.
  95.  
  96. 5. Public key encryption
  97. ------------------------
  98.  
  99. Public key encryption (called PKE from here on) is a very powerful
  100. way to protect your data from being abused. HPACK uses the same
  101. algorithms as the well-known PGP to protect your data. In fact,
  102. HPACK communicates with PGP perfectly.
  103. To use PKE on your Atari you'll have to get a copy of PGP first.
  104. At time of this writing, PGP 2.3a is current for Ataris. It can
  105. be found on the FTP server "ftp.tu-clausthal.de" for example.
  106. Now generate your public key/secret key pair with PGP. Refer to the
  107. PGP documentation on how to do so. Note that the passphrase for your
  108. secret key must be at least 8 characters long, otherwise HPACK won't
  109. accept it (while PGP does).
  110. The secret key needs conversion to use it with HPACK. For this,
  111. a little program called KEYCVT is supplied with HPACK.
  112. Start KEYCVT with "YourPath\SECRING.PGP YourPath\SECRING.PGP" as
  113. parameters. I have encountered some problems when using KEYCVT
  114. directly after PGP, my machine hangs after KEYCVT has finished.
  115. This does not occur when I do a reboot after I used PGP. The whole
  116. thing is a mystery to me, I cannot say what program is guilty of
  117. that. The conversion will be completed correctly in any case. If
  118. you need to reboot after KEYCVT, sorry for the inconvenience. By
  119. far the biggest part of the users only use KEYCVT once anyway.
  120. Now copy PUBRING.PGP, SECRING.PGP and RANDSEED.BIN from the PGP
  121. directory to the HPACK directory.
  122. Then rename RANDSEED.BIN to HPACKSEED.BIN.
  123. That's all for the setup. You can now add new public keys to your
  124. PUBRING using PGP, to do PKE with a public key from someone called
  125. "Joe", do "HPACK a -cpaJoe archive file".
  126. The security of such archives is very high, in fact it is "state-
  127. of-the-art" and "military grade". Learn more about this in the
  128. extended HPACK documentation supplied.
  129.  
  130. 6. Data authenticity
  131. --------------------
  132.  
  133. Data authenticity (DA) ensures that the receiver of your archive
  134. can be sure that no third person played with it. For this, the
  135. person you want to send the archive to first needs your public key.
  136. You then create the archive with "HPACK -lJack archive file" if
  137. Jack happens to be your name.
  138. Note that you need to do the whole setup as described in the chapter
  139. above, i.e. generate your public/secret key and so on.
  140.  
  141. 7. Unified compression
  142. ----------------------
  143.  
  144. HPACK has a mode that uses compression buffers of files already
  145. compressed for the following files. If you compress many files of
  146. very similar structure (i.e. 20 text files or 15 C source codes),
  147. you should try to do so with the "-u" switch given. This may yield
  148. to spectacularily shorter archives in such cases.
  149. Note that if the files differ very much, compressing the files
  150. with unified compression turned on may result in a longer archive.
  151.  
  152. 8. Atari specific stuff
  153. -----------------------
  154.  
  155. I have added an option to the Atari version that forces HPACK to
  156. wait for a keypress before quitting. Use this if you can't read
  157. HPACK's screen output because the desktop is redrawn everytime
  158. HPACK has finished its work.
  159. The option for this is "+hold".
  160.  
  161. So, use "HPACK v +hold archive" to view a listing of the files in
  162. an archive for example.
  163.  
  164. The Atari version comes in two flavours: If you have a TT, Falcon
  165. or an ST you upgraded to a 68030 CPU, use HPACK030.TTP.
  166. If you have a standard ST/STE/Mega ST/Mega STE, use HPACK.TTP.
  167.  
  168. 9. Distribution
  169. ---------------
  170.  
  171. HPACK may only be distributed as a complete package, containing
  172. all the following files:
  173.  
  174.   HPACK.TTP         -- The executable for STs
  175.   HPACK030.TTP      -- The executable for TTs and Falcons
  176.   KEYCVT.TTP        -- The key converter
  177.   LANGUAGE.DAT      -- The language file
  178.   MYKEY.ASC         -- A file containing my public key
  179.   DOCS\HPACK.DOC    -- The HPACK documentation
  180.   DOCS\HPACKEXT.DOC -- The extended HPACK documentation
  181.   DOCS\README.1ST   -- The original HPACK readme
  182.   DOCS\REGISTER.DOC -- The registration form
  183.  
  184. 10. Disclaimer
  185. --------------
  186.  
  187. HPACK comes with absolutely no warranty of any kind, expressed
  188. or implied. Use HPACK only at your own risk. Neither the author
  189. of this Atari port (Martin Braschler) nor the author of the
  190. original HPACK version (Peter Gutmann) will accept responsability
  191. for any damages or unforseen consequences of the usage of HPACK.
  192.  
  193. 11. Credits
  194. -----------
  195.  
  196. HPACK is written by Peter Gutmann (pgut1@cs.aukuni.ac.nz)
  197. - if you use his great program a lot, then think of him. HPACK is
  198.   Shareware, but you are not forced to register - a very nice move
  199.   of him. If you use HPACK regularily, however, you should really
  200.   consider to send him some money. You'll find the necessary
  201.   information in REGISTER.DOC.
  202.  
  203. This Atari port was done by Martin Braschler. My thanks go to Peter,
  204. who helped me a lot. And apart from that, he's just a cool guy.
  205.  
  206. I want to thank Manfred Becker, Matthias Rauhut and Dirk Allard
  207. for testing the program.
  208.  
  209. 12. Closing
  210. -----------
  211.  
  212. You best contact me by email if that is possible for you. In the past,
  213. some mails have been lost. I hope this does not happen again. But
  214. if you didn't here anything from me within a week, maybe just try
  215. to send a second mail. I try to reply to all mails I get.
  216.  
  217. Send them to: mbraschl@iiic.ethz.ch
  218.  
  219. If you don't have access to email, you can try to contact me via
  220. regular mail. This is of course much slower. Please include a SAE
  221. and enough postage, otherwise I won't reply. I hope you understand
  222. this.
  223.  
  224. Send your letters to:
  225. Martin Braschler
  226. Brunngasse 16
  227. CH-4124 Schoenenbuch
  228. Switzerland
  229.  
  230. Have fun with HPACK!
  231.  
  232. All typos (c) 1994 Martin Braschler.