manual/cdrecord/original/man8/isoinfo.8

   1 .\"
   2 .\" @(#)isoinfo.8       1.5 01/04/19 eric
   3 .\"
   4 .\" -*- nroff -*-
   5 .TH ISOINFO 8 "01/04/19" "Version 1.14"
   6 .SH NAME
   7 devdump, isoinfo, isovfy, isodump \- Utility programs for dumping and verifying iso9660
   8 images.
   9 .SH SYNOPSIS
  10 .B devdump
  11 .I isoimage
  12 .PP
  13 .B isodump
  14 .I isoimage
  15 .PP
  16 .B isoinfo
  17 [
  18 .B \-d
  19 ]
  20 [
  21 .B \-h
  22 ]
  23 [
  24 .B \-R
  25 ]
  26 [
  27 .B \-J
  28 ]
  29 [
  30 .B \-j
  31 .I charset
  32 ]
  33 [
  34 .B \-f
  35 ]
  36 [
  37 .B \-l
  38 ]
  39 [
  40 .B \-p
  41 ]
  42 [
  43 .B \-T
  44 .I sector
  45 ]
  46 [
  47 .B \-N
  48 .I sector
  49 ]
  50 [
  51 .B \-i
  52 .I isoimage
  53 ]
  54 [
  55 .B \-x
  56 .I path
  57 ]
  58 .PP
  59 .B isovfy
  60 .I isoimage
  61 .SH DESCRIPTION
  62 .B devdump
  63 is a crude utility to interactively display the contents of device or
  64 filesystem images.
  65 The initial screen is a display of the first 256 bytes of the first 2048 byte
  66 sector.
  67 The commands are the same as with
  68 .BR isodump .
  69 .PP
  70 .B isodump
  71 is a crude utility to interactively display the contents of iso9660 images
  72 in order to verify directory integrity.
  73 The initial screen is a display of the first part of the root directory,
  74 and the prompt shows you the extent number and offset in the extent.
  75 .RS
  76 .PP
  77 You can use the 'a' and 'b'
  78 commands to move backwards and forwards within the image. The 'g' command
  79 allows you to goto an arbitrary extent, and the 'f' command specifies
  80 a search string to be used. The '+' command searches forward for the next
  81 instance of the search string, and the 'q' command exits
  82 .B devdump
  83 or
  84 .BR isodump .
  85 .RE
  86 .PP
  87 .B isoinfo
  88 is a utility to perform directory like listings of iso9660 images.
  89 .PP
  90 .B isovfy
  91 is a utility to verify the integrity of an iso9660 image. Most of the tests
  92 in
  93 .B isovfy
  94 were added after bugs were discovered in early versions of
  95 .B mkisofs.
  96 It isn't all that clear how useful this is anymore, but it doesn't hurt to
  97 have this around.
  98
  99 .SH OPTIONS
 100 Only the
 101 .B isoinfo
 102 program has any command line options. These are:
 103 .TP
 104 .B \-h
 105 print a summary of all options.
 106 .TP
 107 .B \-d
 108 Print information from the primary volume descriptor (PVD) of the iso9660
 109 image. This includes information about Rock Ridge and Joliet extensions
 110 if present.
 111 .TP
 112 .B \-f
 113 generate output as if a 'find . -print' command had been run on the iso9660
 114 image. You should not use the
 115 .B -l
 116 image with the
 117 .B -f
 118 option.
 119 .TP
 120 .B \-i iso_image
 121 Specifies the path of the iso9660 image that we wish to examine.
 122 .TP
 123 .B \-l
 124 generate output as if a 'ls -lR' command had been run on the iso9660 image.
 125 You should not use the
 126 .B -f
 127 image with the
 128 .B -l
 129 option.
 130 .TP
 131 .B \-N sector
 132 Quick hack to help examine single session disc files that are to be written to
 133 a multi-session disc. The sector number specified is the sector number at
 134 which the iso9660 image should be written when send to the cd-writer. Not
 135 used for the first session on the disc.
 136 .TP
 137 .B \-p
 138 Print path table information.
 139 .TP
 140 .B \-R
 141 Extract information from Rock Ridge extensions (if present) for permissions,
 142 file names and ownerships.
 143 .TP
 144 .B \-J
 145 Extract information from Joliet extensions (if present) for file names.
 146 .TP
 147 .B \-j charset
 148 Convert Joliet file names (if present) to the supplied charset. See
 149 .BR mkisofs (8)
 150 for details.
 151 .TP
 152 .B \-T sector
 153 Quick hack to help examine multi-session images that have already been burned
 154 to a multi-session disc. The sector number specified is the sector number for
 155 the start of the session we wish to display.
 156 .TP
 157 .B \-x pathname
 158 Extract specified file to stdout.
 159 .SH AUTHOR
 160 Eric Youngdale <ericy@gnu.ai.mit.edu> or <eric@andante.jic.com> is to blame
 161 for these shoddy hacks. Patches to improve general usability would be
 162 gladly accepted.
 163 .SH BUGS
 164 The user interface really sucks.
 165 .SH FUTURE IMPROVEMENTS
 166 These utilities are really quick hacks, which are very useful for debugging
 167 problems in mkisofs or in an iso9660 filesystem. In the long run, it would
 168 be nice to have a daemon that would NFS export a iso9660 image.
 169 .PP
 170 The isoinfo program is probably the program that is of the most use to
 171 the general user.
 172 .SH AVAILABILITY
 173 These utilities come with the mkisofs package, and the primary ftp site
 174 is tsx-11.mit.edu in /pub/linux/BETA/cdrom/mkisofs and many other mirror
 175 sites. Despite the name, the software is not beta.
 176 .SH SEE ALSO
 177 mkisofs(8)
 178