home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / disk / misc / diskspare3.0 / crunchdisk / doc < prev    next >
Text File  |  1994-11-13  |  8KB  |  221 lines
  1.                  CrunchDisk 1.2
  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, PFS 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.
  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.     Powerpacker.library and reqtools.library are both copyright
  29.     by Nico Francois.
  30.     
  31.     XPK libraries are copyright by Urban Dominik Mueller and others.
  32.  
  33.  How to use:
  34.  
  35.      CrunchDisk is controlled by gadgets. The great reqtools-
  36.      requesters can be controlled by keyboard too. ('ESC' for 
  37.      cancel, 'return' for ok.)
  38.      
  39.  New for v1.2:
  40.      You may call CrunchDisk with a commandline now. Usage:
  41.      'CrunchDisk filename devicename' where filename is the name
  42.      of the file (whole path!) you wish to write back to a device.
  43.      Example: 'CrunchDisk dh0:test DF1:' The ':' behind the device-
  44.      name isn't needed. The commandline works ONLY for write back,
  45.      AND the verify option CAN'T be disabled !
  46.      
  47.  Gadgets:
  48.  
  49.  Mode:    There're two modes.
  50.              
  51.     1. Dev->File (Device to File)
  52.         Transform a disk/partition to a (crunched) file.
  53.      2. File->Dev (File to Device)
  54.         Write a (crunched) file back to disk/partition.
  55.         
  56.  Cr.:    (Crunchmode) three possibilities:
  57.              
  58.     1. None    (without compression)
  59.     2. PP    (with powerpacker.library)
  60.     3. XPK    (with xpk.library)    
  61.              
  62.     Without compression makes sense on disks with only
  63.     lha-archives on it. (they can be crunched with shrink only)        
  64.  
  65.  Eff.:    efficiency
  66.      When crunchmode is set to 'none' this gadget is disabled.
  67.         
  68.     Fast        (pp)        RDCN    (xpk)
  69.     Mediocre    (pp)        BLZW    (xpk)
  70.     Good        (pp)        IMPL    (xpk)
  71.     Very Good    (pp)        NUKE    (xpk)
  72.     Best        (pp)        SHRI    (xpk)
  73.     
  74.     There are five modes per lib.
  75.     Where 'best' and 'shri' are the best. It may be that
  76.     'good' (pp) is better than 'very good' (pp) or 'impl'
  77.     is better than 'nuke'. It depends to the data you want
  78.     to crunch. -> Try different modes.
  79.     Only SHRInk is always the best AND slowest mode. (on a
  80.     68020/14M Amiga it's bloody slow. I've not tested it on
  81.     a 68000/7M Amiga !)
  82.     
  83.     In case you've got a sublib for xpk.lib which is better
  84.     than SHRInk please send it to me.
  85.             
  86.  Verify Write:
  87.     With this gadget you can switch on and off the verify option.
  88.     Should be on with new disks. Should always be on!
  89.     
  90.  Password:
  91.     If this gadget is active, a password is saved with the file.
  92.     You can't write back the file without knowing the password.
  93.               
  94.     When crunching a disk you are prompted to enter a password.
  95.     To be sure you typed the right word it is shown to you again.
  96.     
  97.     When writing back a file you must enter the correct password
  98.     (You don't see the word). If you fail three times the 
  99.     procedure is cancelled.
  100.                 
  101.  Device:
  102.     In this list you see all the available devices (e.g. DF0,DF1,
  103.     DH0,...). Choose the one you want to work on with the mouse.
  104.                   
  105.     On the right hand side some device-specific values are displayed.
  106.                   
  107.     Heads        (read/write-heads)
  108.     Sectors        (sectors per track)
  109.     LowCyl        (first cylinder)
  110.     HighCyl        (last cylinder)
  111.     Bytes/S.    (bytes per sector)
  112.     Device        (name of the device)
  113.  
  114.  ReRead List:
  115.      With this Gadget you can cause CrunchDisk to reread the complete
  116.      devicelist. This will be necessary for HD floppies or other devices
  117.      which are able to change the capacity during operation.
  118.                   
  119.  About:
  120.     A very interesting (?) text and the amount of free memory 
  121.     are displayed (chip/fast as usual).
  122.            
  123.  Save Configuration:
  124.     The current state of the Mode/CrunchMode/Eff./Device/Verify
  125.     and Password - gadgets are saved to disk. 
  126.     (to S:CrunchDisk.config)
  127.               
  128.  Cancel:    
  129.     While crunching/writing a disk/partition and only then you
  130.     can click on cancel to cancel the operation.
  131.     It may take a few seconds (maybe even some more seconds)
  132.     until it is really canceled.
  133.                     
  134.  Start:
  135.     Start crunching/writing.
  136.                      
  137.     Dev->File: 
  138.     You're prompted to type in a filename (or select an existing
  139.     file). If the file exists you must confirm to overwrite it.
  140.     If there's no disk (or whatever) in the selected drive you're
  141.     prompted to insert one.
  142.     Now the operation starts. It's displayed on which cylinder
  143.     CrunchDisk is working on and how many cylinders are left.
  144.     If there's an error you'll get a requester to choose whether
  145.     CrunchDisk should retry or not.
  146.     At the end it is displayed how many bytes were processed and
  147.     how many bytes were left.
  148.     
  149.           File->Dev:
  150.           You must select a file to write back. If the file was compressed
  151.           from another (different) device, the file-values are displayed.
  152.     If there's no disk (or whatever) in the selected drive you're
  153.     prompted to insert one.          
  154.     Now the operation starts. It's displayed which cylinder is in
  155.     progress and how many cylinders are to go.
  156.     Last not least there'll be a message saying: everything's fine.
  157.                    
  158.  Remarks:
  159.     I've tried to make CrunchDisk as safe as I could. But since
  160.     CrunchDisk doesn't make ANY restrictions to the device you
  161.     are able to (try to) crunch your cd-rom, tape-streamer or
  162.     other stuff. In that case, I can't say what CrunchDisk will
  163.     do with your disk.
  164.  
  165.     I DON'T check if there's enough space on the destination-drive
  166.     because it's impossible to say how large the file may get!
  167.     (You may get a 'disk full' requester that's ALL).
  168.     
  169.     The HD floppy problem:
  170.     If you've got a HD drive and want to decrunch a file onto,
  171.     you may get a 'Drive Type Error'-Requester when there is no
  172.     disk in the drive. This is caused by both the trackdisk and
  173.     my device, which hold the type of the last disk until a new
  174.     disk is inserted. To fix the problem is very easy. Simply
  175.     insert the disk BEFORE you start CrunchDisk or reread the
  176.     device-list.
  177.     
  178.  Note:
  179.     CrunchDisk compresses the disk block per block. That means,
  180.     that not only the used blocks but ALL blocks are crunched.
  181.     The advantage of this is that ALL trackdisk compatible devices,
  182.     formatted with ANY filesystem you imagine, can be crunched. 
  183.     The disadvantage is that CrunchDisk may produce a little bit 
  184.     larger files than some other disk-cruncher.
  185.     
  186.     A hint to keep the file small:
  187.     Format the disk (maybe RAD:?) before you copy your files to it.
  188.     Do NOT use the 'quick'-option in order to format all sectors.
  189.     
  190.     P.S.    NOBODY except the competent filesystem or at least a 
  191.         'diskdoctor' should know about the organisation of 
  192.         the data on disk !!!
  193.                
  194.  IMPORTANT:
  195.     This program is FreeWare. You are allowed to distribute 
  196.     it, as long as you don't make ANY profit with it 
  197.         (except, a reasonable copying charge), and you leave the
  198.         doc.file(s) with it.
  199.     You MUSTN'T modify the program itself or this doc.file. 
  200.     Only exception is a translation of this file.
  201.  
  202.  MOST IMPORTANT:
  203.     You are using this software at your OWN RISK!
  204.     
  205.     Under NO CIRCUMSTANCES will the author be liable for any
  206.     direct or indirect damage or data loss resulting from 
  207.     the use or missuse of this software.
  208.     
  209.         All rights are reserved by the author.
  210.     Suggestions and (detailed) bug-reports are welcome.
  211.  
  212.  Author:
  213.     Klaus Deppisch
  214.     Beckenwengert 3
  215.     97246 Eibelstadt
  216.     Germany
  217.     
  218.     Phone: 09303 1579
  219.  
  220.                      
  221.