home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 331.lha / Lhwarp_v1.11 / Lhwarp.doc.pp / Lhwarp.doc
Encoding:
Text File  |  1990-01-08  |  7.0 KB  |  185 lines
  1.  
  2.                                    LHWARP 1.11
  3.                                 2nd January, 1990
  4.  
  5.                            A disk tracker for the Amiga
  6.  
  7.                             Written by Jonathan Forbes
  8.  
  9.    What is Lhwarp?
  10.  
  11.    (Pronounced L-H-WARP)
  12.  
  13.    Lhwarp is a program which will read tracks directly from your floppy disk,
  14. compress them, and output them to a file.  The advantages of using Lhwarp are:
  15.  
  16.    o The entire disk structure, including the boot block, is preserved.
  17.  
  18.    o Lhwarp will always produce a smaller output file than ARC, ZOO or WARP.
  19.  
  20.    o Lhwarp will only archive sectors which contain data, by using the disk's
  21.         bitmap (however, Lhwarp will gladly compress every single sector on
  22.         the disk, if you wish.)
  23.  
  24.    o Using Lhwarp is much less hassle than archiving each and every file
  25.         individually.
  26.  
  27.    o The bootblock of any disk being either read or written is displayed, so
  28.         that bootblock viruses can easily be found.
  29.  
  30.    Lhwarp will produce files much smaller than those produced by Warp, due to
  31. the fact that Lhwarp uses a more efficient compression algorithm (Adaptive
  32. Huffman Encoding); the same algorithm used in Lharc.  Typically, an Lhwarp
  33. file will be 80% of the size of an equivalent Warp file, resulting in quite
  34. reasonable hard drive space savings.
  35.  
  36.    In addition, Lhwarp will only archive sectors which contain data; deleted
  37. information is not archived (unless you explicity request this to be done.)
  38. When compressing or decompressing data, sectors which contain data are marked
  39. with a '.' character, while sectors which do not contain data are marked with
  40. a '_' character.  If the NOMAP option is specified, all sectors will be marked
  41. with '.' automatically.
  42.  
  43.    Lhwarp's main (and perhaps only) disadvantage is that compression time is
  44. very large; it can take from 20 to 25 minutes to compress an entire disk
  45. (80 tracks.)  There is not too much which can be done about this; you have to
  46. pay a price for the extra power.
  47.  
  48.    However, this is not as bad as it may seem; a disk only has to be Lhwarp'd
  49. once; after Lhwarp'ing, the output file will be transferred via a modem,  from
  50. BBS to BBS.  Because the file will be that much smaller than an equivalent
  51. file produced by Warp, the file will take less time to transfer, resulting in a
  52. lower phone bill.  And, as mentioned before, it will occopy less space on the
  53. destination system.
  54.  
  55.  
  56.    More Information
  57.  
  58.    Lhwarp output files have the suffix ".LHW".  If the filename you give
  59. Lhwarp does not end in ".LHW", Lhwarp will append ".LHW" to it.  Please leave
  60. the suffix alone, and don't change it to ".WRP".
  61.  
  62.    The Adaptive Huffman Encoding algorithm was originally coded by Haruyasu
  63. Yoshizaki.
  64.  
  65.    Lhwarp was compiled and very heavily optimised under Lattice C 5.04.  Even
  66. though Lattice produces very fast code, Lhwarp needs all the speed it can get.
  67. I have rewritten a few of Lhwarp's compression functions in assembly language,
  68. and performance has improved significantly.
  69.  
  70.    Nevertheless, the Lzhuf routines, which are now a mixture of Lattice C 5.04
  71. code and assembly language, are much faster than those in either Amiga Lharc,
  72. or the previous versions of Lhwarp.  When compressing an arbitrary 40k file:
  73.  
  74.                        Encode time(s)        Decode time(s)
  75.    Lharc                    60                    15
  76.    Lhwarp 1.03              55                    13
  77.    Lhwarp 1.10              47                    11
  78.    Lhwarp 1.11              39                    11
  79.  
  80.  
  81.    Parameters
  82.  
  83.    To view Lhwarp's parameters, type "Lhwarp"; they are included within the
  84. program.  You will be presented with:
  85.  
  86. Usage: LHWARP <Command> <Unit> <Filename> <StartTrack> <EndTrack> <TFile>
  87.  
  88. <Command>    - Read, NoMap, or Write
  89. <Unit>       - Drive number (0 for internal, 1 ... 3 for external)
  90. <Filename>   - Output|Input filename
  91. <StartTrack> - Track number (0 ... 79) [valid only in read mode]
  92. <EndTrack>   - Track number (0 ... 79) [valid only in read mode]
  93. <TFile>      - Append text in <TextFile> to output file [optional]
  94.  
  95.    Examples are:
  96.  
  97.    a) Lhwarp READ 0 mydisk 0 79
  98.  
  99.       This will read tracks 0 to 79 of the disk in drive 0 (i.e. the entire
  100. disk), and will output the result to "mydisk.lhw"  Only sectors which contain
  101. data will be archived.
  102.  
  103.  
  104.    b) Lhwarp READ 0 mydisk 0 79 mytext
  105.  
  106.       This will read tracks 0 to 79 of the disk in drive 0 (i.e. the entire
  107. disk), and will output the result to "mydisk.lhw".  Only sectors which contain
  108. data will be archived.  The text from the file "mytext" will be imported to
  109. the output file.  Any text stored in the output file will be displayed when
  110. the disk is unarchived.
  111.  
  112.  
  113.    c) Lhwarp NOMAP 0 mydisk 0 79
  114.  
  115.       This will read tracks 0 to 79 of the disk in drive 0 (i.e. the entire
  116. disk), and will output the result to "mydisk.lhw".  All sectors will be
  117. archived, regardless of whether or not they contain data; the disk's bitmap
  118. is ignored with the 'nomap' option.
  119.  
  120.  
  121.    d) Lhwarp WRITE 1 mydisk
  122.  
  123.       This will output all tracks stored in mydisk.lhw to drive 1.  If any
  124. text was in the output file, it will be displayed.
  125.  
  126.  
  127.    Virus detection
  128.  
  129.    Some people have complained about Warp in that it aids the spreading of
  130. boot block viruses.  It is for this reason that Lhwarp will display the
  131. bootblock of any disk it reads or writes, so that one can see what is being
  132. Lhwarp'd.  Any non-standard looking bootblock should be viewed with suspicion.
  133.  
  134.    If you see a non-standard bootblock in read mode, this means that the disk
  135. you are reading from might possibly contain a virus.  If you see this in write
  136. mode, it means that the file you are writing out to your disk may contain a
  137. virus.  In either case, you should load a virus checker to make sure (such as
  138. VirusX 4.0)
  139.  
  140.  
  141.    Specifications
  142.  
  143.    Lhwarp uses ETD_READ and ETD_FORMAT to read/write directly from/to the
  144. trackdisk.device.  The 16 bytes of label information for each sector are saved
  145. in the output file.  A 32-bit CRC protects data integrity.
  146.  
  147.  
  148.    Future Possibilities
  149.  
  150.    o Support for raw track reads and writes
  151.    o Merging output files
  152.    o Preview tracks/sectors
  153.    o Mix raw/normal tracks in a single file
  154.  
  155.  
  156.    Acknowledgements
  157.  
  158.    Huffman routines   - Haruyasu Yoshizaki (lzhuf.c, v1.13c)
  159.    Bitmap information - Leo Schwab (diskmap2.c)
  160.  
  161.  
  162.    This Program
  163.  
  164.    Lhwarp is a freely distributable, copyrighted piece of software.  You do
  165. not have to pay money to use it, and may upload it wherever you choose, but
  166. you are not allowed to sell Lhwarp for profit, or include Lhwarp on a disk
  167. which is sold for profit, without the author's (Jonathan Forbes) permission.
  168.  
  169.    I can be contacted at 416-927-7844 (voice) or 416-921-6638 (data.)
  170.  
  171.  
  172.    Disclaimer
  173.  
  174.    I am in no way responsible for anything this program does; you are using
  175. it entirely at your own risk, so if you are kidnapped and held hostage by
  176. Libyan terrorists, don't blame me!
  177.  
  178.  
  179.    Lhwarp vs. Warp:
  180.  
  181.                                File size
  182.                              v1.03    Warp    % Size   Diff
  183.    NewTek Dynamic HAM Disk:  670342   796665    84%    126323
  184.  
  185.