home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d108 / zoo.lha / Zoo / fiz.zoo / fiz.man < prev    next >
Text File  |  1987-06-28  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. FIZ(1)              **IX Programmer's Manual               FIZ(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      fiz - recover data from damaged Zoo archives
  10.  
  11. SYNOPSIS
  12.      fiz archive[.zoo]
  13.  
  14. DESCRIPTION
  15.      Fiz, the fix zoo utility, helps extract data from damaged
  16.      archives.  When invoked on a zoo archive, fiz searches the
  17.      archive for directory entries.  For each directory entry
  18.      found, it prints the position of the directory entry within
  19.      the archive (a decimal number), the associated path prefix
  20.      if any, the short filename, and the long filename if any.
  21.      The first directory entry listed (with a meaningless
  22.      filename) is usually the archive header and should be
  23.      ignored.  The last directory entry listed (with null direc-
  24.      tory and file names) is the trailing null directory entry
  25.      that every zoo archive contains and this too should be
  26.      ignored.
  27.  
  28.      Fiz converts any unprintable characters encountered in a
  29.      filename to printable equivalents before printing them.
  30.      Control characters are converted to corresponding digraphs
  31.      (e.g. control A becomes "^A") and characters with the eighth
  32.      bit set are printed preceded by a tilde ("~").  If fiz
  33.      detects a corrupted directory entry CRC (not the file data
  34.      CRC), it indicates so.
  35.  
  36.      Make a record of Fiz's output by redirecting it to a file.
  37.      Then list the undamaged files using Zoo version 1.41 or
  38.      later as follows:
  39.  
  40.           zoo l@n archive [.zoo]
  41.  
  42.      where n is a position within the damaged zoo archive,
  43.      obtained from the output of fiz. If n is properly chosen,
  44.      the damaged portion of the zoo archive will be ignored and
  45.      all remaining undamaged filenames will be listed.  To
  46.      extract undamaged files use the command:
  47.  
  48.           zoo x@n archive[.zoo]
  49.  
  50.      where n is a decimal integer obtained from fiz.
  51.  
  52.      The @n option may be used in combination with all other
  53.      legal options for zoo.
  54.  
  55. SEE ALSO
  56.      zoo(1)
  57.  
  58. BUGS
  59.  
  60.  
  61.  
  62.  
  63. Printed 2/6/87          February 6, 1987                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FIZ(1)              **IX Programmer's Manual               FIZ(1)
  71.  
  72.  
  73.  
  74. DIAGNOSTICS
  75.      If fiz detects a CRC error in a directory entry it so indi-
  76.      cates.  This simply serves as a warning and does not neces-
  77.      sarily imply that the file data are corrupted.
  78.  
  79. FUTURE DIRECTIONS
  80.      Currently fiz does not look for the file data, but only
  81.      locates undamaged directory entries.  A future version will
  82.      also search for the leader that precedes each archived file
  83.      and permit extraction even if the corresponding directory
  84.      entry is damaged.
  85.  
  86. AUTHOR
  87.      Rahul Dhesi
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Printed 2/6/87          February 6, 1987                        2
  130.  
  131.  
  132.  
  133.