home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / beos / utils / mkisofs-1.000 / mkisofs-1.11-beos / diag / README < prev   
Text File  |  1997-04-09  |  3KB  |  78 lines
  1. #
  2. # $Id: README,v 1.1 1997/02/23 16:14:56 eric Rel $
  3. #
  4.     I am enclosing 3 test programs that I use to verify the
  5. integrity of an iso9660 disc.  The first one (isodump) is pretty
  6. simple - it dumps to the screen the contents of the various
  7. directories.  The second one (isovfy) goes through and looks for
  8. problems of one kind or another.
  9.  
  10.     To use, type something like "./isodump /dev/ramdisk" or
  11. "./isodump /dev/scd0", depending upon where the iso9660 disc is.  It
  12. starts by displaying the files in the first sector of the root
  13. directory.  It has some pretty simple one letter commands that you
  14. can use to traverse the directory tree.
  15.  
  16.     a - move back one sector.
  17.     b - move forward one sector.
  18.     g - go to new logical sector.
  19.     q - quit
  20.  
  21. The a and b commands do not try and stop you from going past the
  22. beginning or end of a sector, and the g command does not have any way
  23. of knowing whether the sector you request is actually a directory or
  24. not.
  25.  
  26.     The output is displayed in several columns.  The first column
  27. is the total length of the directory record for the file.  The second
  28. column (in [] brackets) is the volume number.  Next comes the starting
  29. extent number (in hex), and then comes the file size in bytes.  Then
  30. cones the filename (not the Rock Ridge version), and this is preceeded
  31. by an "*" if the file is a directory.  After this is a summary of the
  32. Rock Ridge fields present along with a display of the translation of
  33. the symbolic link name if the SL Rock Ridge record is present.
  34.  
  35.     I tailored this program for debugging some of the problems
  36. that I was having earlier.  The idea is that you can tailor it
  37. to test for problems that you might be having, so it is not intended
  38. as a be-all and end-all dump program.
  39.  
  40.     If you move to a sector that does not contain directory
  41. information, the results are unpredictable.
  42.  
  43.     The second program, isovfy, is run in the same way as isodump,
  44. except that you do not have to do much except let it run.  I have it
  45. written to verify all kinds of different things, and as people find
  46. other sorts of problems other tests could be added.
  47.  
  48.     The third program, dump.c, basically does a hexdump of the cd.
  49. This is screen oriented, and there are some simple commands:
  50.  
  51.     a - move back one sector.
  52.     b - move forward one sector.
  53.     f - enter new search string.
  54.     + - search forward for search string.
  55.     g - go to new logical sector.
  56.     q - quit
  57.  
  58.  
  59.     Note that with the 'g' command, sectors are always given in
  60. hex, and represent 2048 byte sectors (as on the cdrom).  If you know
  61. how to decode a raw iso9660 directory, you can pick out the starting
  62. extent number from the hexdump and know where to go from there.  The
  63. starting extent appears something like 30 bytes prior to the start of
  64. the iso9660 (not Rock Ridge) filename, and it appears in a 7.3.3
  65. format (meaning that it occupies 8 bytes, 4 in little endian format,
  66. and 4 in big endian format).  Thus you should see a mirror image of
  67. the bytes when looking at the extent number.
  68.  
  69.     The isovfy program can also dump the contents of the path
  70. tables, but this capability is commented out right now.  Feel free
  71. to enable this to see what is in the tables.  Ultimately I may fix
  72. it so that this checks the integrity of the tables as well.
  73.  
  74.     The isovfy program gives warnings about things like files that
  75. have a size of 0 but have an extent number assigned.  The mkisofs program
  76. should never do this, but the YM software does leave these around.
  77. I think it is probably harmless in the YM case.~
  78.