home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / archivrs / amiga / bin / fiz.man < prev    next >
Text File  |  1991-07-21  |  5KB  |  99 lines
  1.  
  2.  
  3.  
  4.      FIZ(1)                         (Jan 31, 1988))                    FIZ(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           fiz - analyze damaged zoo archive for data revovery
  10.  
  11.      SYNOPSIS
  12.           fiz archive[.zoo]
  13.  
  14.      DESCRIPTION
  15.           Fiz is used to analyze damaged zoo archives and locate
  16.           directory entries and file data in them.  The current
  17.           version of fiz is 2.0 and it is meant to be used in
  18.           conjunction with zoo version 2.0.  Fiz makes no assumptions
  19.           about archive structure.  Instead, it simply searches the
  20.           entire subject archive for tag values that mark the
  21.           locations of directory entries and file data.  In a zoo
  22.           archive, a directory entry contains information about a
  23.           stored file such as its name, whether compressed or not, and
  24.           its timestamp.  The file data are the actual data for the
  25.           archived file, and may be either the original data, or the
  26.           result of compressing the file.
  27.  
  28.           For each directory entry found, fiz prints where in the
  29.           archive it is located, the directory path and filename(s)
  30.           found in it, whether the directory entry appears to be
  31.           corrupted (indicated by [*CRC Error*]), and the value of the
  32.           pointer to the file data that is found in the directory
  33.           entry.  For each block of file data found in the archive,
  34.           fiz prints where in the archive the block begins.  In the
  35.           case of an undamaged archive, the pointer to file data found
  36.           in a directory entry will correspond to where fiz actually
  37.           locates the data.  Here is some sample output from fiz:
  38.  
  39.           ****************
  40.               2526: DIR         [changes] ==>         95
  41.               2587: DATA
  42.           ****************
  43.               3909: DIR         [copyrite] ==>        1478
  44.               3970: DATA
  45.               4769: DATA
  46.           ****************
  47.  
  48.           In such output, DIR indicates where fiz found a directory
  49.           entry in the archive, and DATA indicates where fiz found
  50.           file data in the archive.  Filenames located by fiz are
  51.           enclosed in square brackets, and the notation "==>   95"
  52.           indicates that the directory entry found by fiz at position
  53.           2526 has a file data pointer to position 95. In actuality,
  54.           fiz found file data at positions 2587, 3970, and 4769.
  55.           Since fiz found only two directory entries, and each
  56.           directory entry corresponds to one file, one of the file
  57.           data positions is an artifact.
  58.  
  59.           Once the locations of directory entries and file data are
  60.           found, the @ modifier to zoo's archive list and extract
  61.           commands can be used and the archive contents selectively
  62.           listed or extracted, skipping the damaged portion.  This is
  63.           further described in the documentation for zoo(1).
  64.  
  65.           In the above case, commands to try giving to zoo might be
  66.           x@2526,2587 (extract beginning at position 2526, and get
  67.           file data from position 2587), x@3090,3970 (extract at 3090,
  68.           get data from 3970) and x@3909,4769 (extract at 3909, get
  69.           data from 4769).  Once a correctly-matched directory
  70.           entry/file data pair is found, zoo will in most cases
  71.           synchronize with and correctly extract all files
  72.           subsequently found in the archive.  Trial and error should
  73.           allow all undamaged files to be extracted.  Also note that
  74.           self-extracting archives created using sez (the Self-
  75.           Extracting Zoo utility for MS-DOS), which are normally
  76.           executed on an MS-DOS system for extraction, can be
  77.           extracted on non-MSDOS systems in a similar way.
  78.  
  79.      SEE ALSO
  80.           zoo(1)
  81.  
  82.      BUGS
  83.           Random byte patterns can occasionally be incorrectly
  84.           recognized as tag values.  This occurs very rarely, however,
  85.           and trial and error will usually permit all undamaged data
  86.           to be extracted.
  87.  
  88.      DIAGNOSTICS
  89.           Fiz always exits with a status code of 0.
  90.  
  91.      FUTURE DIRECTIONS
  92.           Automation of data recovery from a damaged archive is
  93.           potentially achievable.  However, since damaged archives
  94.           occur only rarely, fiz as it currently stands is unlikely to
  95.           change much in the near future.
  96.  
  97.      AUTHOR
  98.           Rahul Dhesi
  99.