home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / disk / dskspr20.lha / diskspareii / crunchdisk / CrunchDisk.DOC < prev    next >
Encoding:
Text File  |  1994-05-02  |  6.3 KB  |  194 lines
  1.                  CrunchDisk 1.1
  2.  
  3.                 written and © 1993
  4.                 by Klaus Deppisch
  5.                All rights reserved
  6.             
  7.  What is it:
  8.  
  9.     CrunchDisk is a disk-archiver. That means it crunches a whole
  10.     disk or a partition to a single file.
  11.     
  12.     Why one more disk-cruncher? Because 'the others' can't
  13.     crunch disks which are formatted in my disk-format!
  14.     
  15.     With CrunchDisk you may crunch EACH device which works like the
  16.     trackdisk.device, e.g. a harddisk-partition, a Syquest-catridge, 
  17.     a normal disk formatted with ffs, dircache or whatever, 
  18.     a MS-DOS-disk (via mfm.device) OR a disk formatted with 
  19.     diskspare.device (that's it).
  20.     
  21.  What do you need:
  22.     
  23.     Kickstart 2.0 or higher.     (I WON'T do anything for KS1.3!)
  24.     Powerpacker.library V35 or higher.
  25.     Reqtools.library V37 or higher.
  26.     XpkMaster.library V2 or higher. (+ RDCN,BLZW,IMPL,NUKE,SHRI.lib)
  27.  
  28.  How to use:
  29.  
  30.      CrunchDisk is controlled by gadgets. The great reqtools-
  31.      requesters can be controlled by keyboard too. ('ESC' for 
  32.      cancel, 'return' for ok.)
  33.      
  34.  Gadgets:
  35.  
  36.  Mode:    There're two modes.
  37.              
  38.     1. Dev->File (Device to File)
  39.         Transform a disk/partition to a (crunched) file.
  40.      2. File->Dev (File to Device)
  41.         Write a (crunched) file back to disk/partition.
  42.         
  43.  Cr.:    (Crunchmode) three possibilities:
  44.              
  45.     1. None    (without compression)
  46.     2. PP    (with powerpacker.library)
  47.     3. XPK    (with xpk.library)    
  48.              
  49.     Without compression makes sense on disks with only
  50.     lha-archives on it. (they can't be crunched)        
  51.  
  52.  Eff.:    efficiency
  53.      When crunchmode is set to 'none' this gadget is disabled.
  54.         
  55.     Fast        (pp)        RDCN    (xpk)
  56.     Mediocre    (pp)        BLZW    (xpk)
  57.     Good        (pp)        IMPL    (xpk)
  58.     Very Good    (pp)        NUKE    (xpk)
  59.     Best        (pp)        SHRI    (xpk)
  60.     
  61.     There are five modes per lib.
  62.     Where 'best' and 'shri' are the best. It may be that
  63.     'good' (pp) is better than 'very good' (pp) or 'impl'
  64.     is better than 'nuke'. It depends to the data you want
  65.     to crunch. -> Try different modes.
  66.     Only SHRInk is always the best AND slowest mode. (on a
  67.     68020/14M Amiga it's bloody slow. I've not tested it on
  68.     a 68000/7M Amiga !)
  69.     
  70.     In case you've got a sublib for xpk.lib which is better
  71.     than SHRInk please send it to me.
  72.             
  73.  Verify Write:
  74.     With this gadget you can switch on and off the verify option.
  75.     Should be on with new disks. Should always be on!
  76.     
  77.  Password:
  78.     If this gadget is active, a password is saved with the file.
  79.     You can't write back the file without knowing the password.
  80.               
  81.     When crunching a disk you are prompted to enter a password.
  82.     To be sure you typed the right word it is shown to you again.
  83.     
  84.     When writing back a file you must enter the correct password
  85.     (You don't see the word). If you fail three times the 
  86.     procedure is cancelled.
  87.                 
  88.  Device:
  89.     In this list you see all the available devices (e.g. DF0,DF1,
  90.     DH0,...). Choose the one you want to work on with the mouse.
  91.                   
  92.     On the right hand side some device-specific values are displayed.
  93.                   
  94.     Heads        (read/write-heads)
  95.     Sectors        (sectors per track)
  96.     LowCyl        (first cylinder)
  97.     HighCyl        (last cylinder)
  98.     Bytes/S.    (bytes per sector)
  99.     Device        (name of the device)
  100.                   
  101.  About:
  102.     A very interesting (?) text and the amount of free memory 
  103.     are displayed (chip/fast as usual).
  104.            
  105.  Save Configuration:
  106.     The current state of the Mode/CrunchMode/Eff./Device/Verify
  107.     and Password - gadgets are saved to disk. 
  108.     (to S:CrunchDisk.config)
  109.               
  110.  Cancel:    
  111.     While crunching/writing a disk/partition and only then you
  112.     can click on cancel to cancel the operation.
  113.     It may take a few seconds (maybe even some more seconds)
  114.     until it is really canceled.
  115.                     
  116.  Start:
  117.     Start crunching/writing.
  118.                      
  119.     Dev->File: 
  120.     You're prompted to type in a filename (or select an existing
  121.     file). If the file exists you must confirm to overwrite it.
  122.     If there's no disk (or whatever) in the selected drive you're
  123.     prompted to insert one.
  124.     Now the operation starts. It's displayed on which cylinder
  125.     CrunchDisk is working on and how many cylinders are left.
  126.     If there's an error you'll get a requester to choose whether
  127.     CrunchDisk should retry or not.
  128.     At the end it is displayed how many bytes were processed and
  129.     how many bytes were left.
  130.     
  131.           File->Dev:
  132.           You must select a file to write back. If the file was compressed
  133.           from another (different) device, the file-values are displayed.
  134.     If there's no disk (or whatever) in the selected drive you're
  135.     prompted to insert one.          
  136.     Now the operation starts. It's displayed which cylinder is in
  137.     progress and how many cylinders are to go.
  138.     Last not least there'll be a message saying: everything's fine.
  139.                    
  140.  Remarks:
  141.     I've tried to make CrunchDisk as safe as I could. But since
  142.     CrunchDisk doesn't make ANY restrictions to the device you
  143.     are able to (try to) crunch your cd-rom, tape-streamer or
  144.     other stuff. In that case, I can't say what CrunchDisk will
  145.     do with your disk.
  146.  
  147.     I DON'T check if there's enough space on the destination-drive
  148.     because it's impossible to say how large the file may get!
  149.     (You may get a 'disk full' requester that's ALL).
  150.     
  151.  Note:
  152.     CrunchDisk compresses the disk block per block. That means,
  153.     that not only the used blocks but ALL blocks are crunched.
  154.     The advantage of this is that ALL trackdisk compatible devices,
  155.     formatted with ANY filesystem you imagine, can be crunched. 
  156.     The disadvantage is that CrunchDisk may produce a little bit 
  157.     larger files than some other disk-cruncher.
  158.     
  159.     A hint to keep the file small:
  160.     Format the disk (maybe RAD:?) before you copy your files to it.
  161.     Do NOT use the 'quick'-option in order to format all sectors.
  162.     
  163.     P.S.    NOBODY except the competent filesystem or at least a 
  164.         'diskdoctor' should know about the organisation of 
  165.         the data on disk !!!
  166.                
  167.  IMPORTANT:
  168.     This program is FreeWare. You are allowed to distribute 
  169.     it, as long as you don't make ANY profit with it 
  170.         (except, a reasonable copying charge), and you leave the
  171.         doc.file(s) with it.
  172.     You MUSTN'T modify the program itself or this doc.file. 
  173.     Only exception is a translation of this file.
  174.  
  175.  MOST IMPORTANT:
  176.     You are using this software at your OWN RISK!
  177.     
  178.     Under NO CIRCUMSTANCES will the author be liable for any
  179.     direct or indirect damage or data loss resulting from 
  180.     the use or missuse of this software.
  181.     
  182.         All rights are reserved by the author.
  183.     Suggestions and (detailed) bug-reports are welcome.
  184.  
  185.  Author:
  186.     Klaus Deppisch
  187.     Beckenwengert 3
  188.     97246 Eibelstadt
  189.     Germany
  190.     
  191.     Phone: 09303 1579
  192.  
  193.                      
  194.