home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff295.lzh / Lhwarp / Lhwarp.doc < prev    next >
Text File  |  1989-12-27  |  5KB  |  137 lines
  1.                                    LHWARP 1.03
  2.  
  3.                            A disk tracker for the Amiga
  4.  
  5.                             Written by Jonathan Forbes
  6.  
  7.    What is Lhwarp?
  8.  
  9.    (Pronounced L-H-WARP)
  10.  
  11.    Lhwarp is a program which will read tracks directly from your floppy disk,
  12. compress them, and output them to a file.  The advantages of using Lhwarp are:
  13.  
  14.    o The disk structure (including boot block) is preserved
  15.    o Lhwarp Will probably produce a smaller output file than ARC or ZOO
  16.    o Less hassle than archiving each and every file individually
  17.  
  18.    Lhwarp will produce files much smaller than those produced by Warp, due to
  19. the fact that Lhwarp uses a more efficient compression algorithm (Adaptive
  20. Huffman Encoding); the same algorithm used in Lharc.  Typically, an Lhwarp
  21. file will be 80% of the size of an equivalent Warp file, resulting in quite
  22. reasonable hard drive space savings.
  23.  
  24.    Lhwarp's main (and perhaps only) disadvantage is that compression time is
  25. very large; it can take from 20 to 25 minutes to compress an entire disk
  26. (80 tracks.)  There is not too much which can be done about this; you have to
  27. pay a price for the extra power.
  28.  
  29.    However, this is not as bad as it may seem; a disk only has to be Lhwarp'd
  30. once; after Lhwarp'ing, the output file will be transferred over the phone,
  31. from BBS to BBS.  Because the file will be that much smaller than the
  32. equivalent file produced by Warp, the file will take less time to transfer,
  33. resulting in a lower phone bill.  And, as mentioned before, it will occopy
  34. less space on the destination system.
  35.  
  36.  
  37.    More Information
  38.  
  39.    Lhwarp output files have the suffix ".LHW".  If the filename you give
  40. Lhwarp does not end in ".LHW", Lhwarp will append ".LHW" to it.  Please leave
  41. the suffix alone, and don't change it to ".WRP".
  42.  
  43.    The Adaptive Huffman Encoding algorithm was originally coded by Haruyasu
  44. Yoshizaki.
  45.  
  46.    Lhwarp was compiled and optimised under Lattice C 5.04.  Many thanks to
  47. Lattice for producing the best C compiler for the Amiga.  The algorithms, when
  48. compiled under Lattice C 5.04, are almost 10% faster than those in the Amiga
  49. version of Lharc, which was compiled under Manx.
  50.  
  51.  
  52.    Parameters
  53.  
  54.    To view Lhwarp's parameters, type "Lhwarp"; they are included within the
  55. program.  You will be presented with:
  56.  
  57. Usage: LHWARP <Read|Write> <Unit> <Filename> <StartTrack> <EndTrack> <TFile>
  58.  
  59. <Unit>       - Drive number (0 for internal, 1 ... 3 for external)
  60. <Filename>   - Output|Input filename
  61. <StartTrack> - Track number (0 ... 79) [valid only in read mode]
  62. <EndTrack>   - Track number (0 ... 79) [valid only in read mode]
  63. <TFile>      - Append text in <TextFile> to output file [optional]
  64.  
  65.    Examples are:
  66.  
  67.    a) Lhwarp read 0 mydisk 0 79
  68.  
  69.       This will read tracks 0 to 79 of the disk in drive 0 (i.e. the entire
  70. disk), and will output the result to "mydisk.lhw"
  71.  
  72.  
  73.    b) Lhwarp read 0 mydisk 0 79 mytext
  74.  
  75.       This will read tracks 0 to 79 of the disk in drive 0 (i.e. the entire
  76. disk), and will output the result to "mydisk.lhw".  The text from the file
  77. "mytext" will be imported to the output file.  Any text stored in the output
  78. file will be displayed when the disk is unarchived.
  79.  
  80.  
  81.    c) Lhwarp write 1 mydisk
  82.  
  83.       This will output all tracks stored in mydisk.lhw to drive 1.  If any
  84. text was in the output file, it will be displayed.
  85.  
  86.  
  87.    Virus protection
  88.  
  89.    Some people have complained about Warp in that it aids the spread of
  90. boot block viruses.  It is for this reason that Lhwarp will display the
  91. bootblock of any disk it reads or writes, so that one can see what is being
  92. Lhwarp'd.  Any non-standard looking bootblock should be viewed with suspicion.
  93.  
  94.    If you see a non-standard bootblock in read mode, this means that the disk
  95. you are reading from might possibly contain a virus.  If you see this in write
  96. mode, it means that the file you are writing out to your disk may contain a
  97. virus.  In either case, you should load a virus checker, to make sure (such as
  98. VirusX 4.0)
  99.  
  100.  
  101.    Specifications
  102.  
  103.    Lhwarp uses ETD_READ and ETD_FORMAT to read/write directly from/to the
  104. trackdisk.device.  The 16 bytes of label information for each sector are saved
  105. in the output file.  A 32-bit checksum protects data integrity.
  106.  
  107.  
  108.    Future Possibilities
  109.  
  110.    o Support for raw track reads and writes
  111.    o Other compression algorithms
  112.  
  113.  
  114.    This Program
  115.  
  116.    Lhwarp is a freely distributable, copyrighted piece of software.  You do
  117. not have to pay money to use it, and may upload it wherever you choose, but
  118. you are not allowed to sell Lhwarp for profit, or include Lhwarp on a disk
  119. which is sold for profit, without the author's (Jonathan Forbes) permission.
  120.  
  121.    I can be contacted at 416-927-7844 (voice) or 416-921-6638 (data.)
  122.  
  123.  
  124.    Disclaimer
  125.  
  126.    I am in no way responsible for anything this program does; you are using
  127. it entirely at your own risk, so if you are kidnapped and held hostage by
  128. Libyan terrorists, don't blame me!
  129.  
  130.  
  131.    Lhwarp vs. Warp:
  132.  
  133.                                    File size
  134.                                 Lhwarp      Warp    % Size   Diff
  135.    NewTek Dynamic HAM Disk:     670342     796665    84%    126323
  136.  
  137.