home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d653 / hardblocks.lha / HardBlocks / ReadMe < prev    next >
Text File  |  1992-05-14  |  4KB  |  90 lines
  1.         Hardblocks Library v1.1 + HBtool v1.1
  2.         =====================================
  3.  
  4. Copyright:
  5. ----------
  6.  
  7.       © Copyright 1992, Freeware, All rights reserved
  8.  
  9.    Distribution EXCLUSIVELY permitted to Fred Fish for his PD software
  10.    library. Other forms of distribution need the permission of the author.
  11.  
  12.    No guarantee of any kind is made that this program is 100% reliable.
  13.    You use it on your own risk.
  14.  
  15. Notes:
  16. ------
  17.  
  18. This package contains a shared library with support routines for
  19. Commodore's hardblock standard and a small tool which demonstrates use of
  20. this library.
  21.  
  22. Usage of HBtool:
  23. ----------------
  24.  
  25. · HBtool needs the Arp library v39+
  26. · to get the command line template use `hbtool ?', for additional help
  27.   informations type `?' after the colon of the template
  28. · command line template:
  29.      Device,Unit,FILE/k,LOAD/s,RESTORE/s,DEFAULT/s,SHOW/s,OUTPUT/k,SAVE/s,
  30.      BACKUP/s,REMOVE/s
  31. · extra help:
  32.      Usage: HBtool [Device] [Unit] [FILE name] [LOAD] [RESTORE] [DEFAULT]
  33.            [SHOW] [OUTPUT file] [SAVE] [BACKUP] [REMOVE]
  34.         [Device]      = device name (default: scsi.device)
  35.         [Unit]        = device unit num (default 0)
  36.         [FILE name]   = file to restore/save hardblocks
  37.         [LOAD]        = load hardblocks from device (default)
  38.         [RESTORE]     = restore hardblocks from file
  39.         [DEFAULT]     = create standard rigid disk block
  40.         [SHOW]        = show currently loaded hardblocks (default)
  41.         [OUTPUT file] = output file for show (default: NULL -> stdout)
  42.         [SAVE]        = save currently loaded hardblocks to device
  43.         [BACKUP]      = backup currently loaded hardblocks to file
  44.         [REMOVE]      = delete rigid disk block from device
  45. · before any changing of hardblocks on selected device are performed, a
  46.   safety check must be passed - enter `YES' (case sensitive!!!), anything
  47.   other aborts the changing operation
  48. · with LOAD, RESTORE & DEFAULT the hardblocks are only load into memory,
  49.   now they can displayed (SHOW -> on screen, SHOW OUTPUT prt: -> on
  50.   printer), stored in data files (BACKUP) or used as new hardblocks for
  51.   selected device (SAVE), eg. to use hardblocks out a file you type
  52.     hbtool my.device 0 restore file my.hardblocks save
  53. · with REMOVE only the rigid disk block is deleted from device
  54. · error codes returned by hardblocks library are only reported as numbers,
  55.   you have to use hardblocks.h to decode them
  56.  
  57. Some technical details:
  58. -----------------------
  59.  
  60. · hardblocks library use HD_SCSI_CMDs, so only SCSI devices are supported
  61. · the library only supports all hardblocks defined by Commodore
  62.   (devices/hardblocks.h); all other block types (some SCSI controller
  63.   vendors use custom hardblocks for internal purposes, eg. TrumpCard ->
  64.   'IVS\0') are ignored
  65. · also all reserved block list headers of rigid disk block are not supported
  66. · BadBlockBlocks and LoadSegBlocks (FileSysHeaderBlock & DriveInit) are
  67.   summarized to ONE custom hardblock called DataBlock (see hardblocks.h)
  68. · all block numbers (block list heads in rigid disk block, xxx_Next,
  69.   fhb_SegListBlocks, ...) are replaced by memory pointers (read and restore)
  70.   or offsets into data file (save)
  71. · an additional error code is returned in pr_Result2 of process structure,
  72.   use the dos call IoErr() to get this value
  73. · currently hardblocks library produces some debugging messages via
  74.   FarPrint (from Olaf Barthel, see fish disk #??), so if an error occured
  75.   FarPrint (started first) can be used to check the internal state of the
  76.   library
  77.  
  78. Author:
  79. -------
  80.  
  81.    Torsten Jürgeleit
  82.    Am Sandberg 4
  83.    W-5270 Gummersbach
  84.    Germany
  85.    Phone: ++49 2261 27400
  86.  
  87.    Bug reports, flames, donations etc. are welcome !
  88.    I may be reached via eMail: mike@miba.obb.sub.org
  89.    Since this is a neighbour, it may take some time to answer :)
  90.