genisoimage/diag/isoinfo.1

   1 .\"
   2 .\" @(#)isoinfo.8       1.7 04/06/01 joerg
   3 .\"
   4 .\" Modified for cdrkit in 12/2006
   5 .\"
   6 .\" -*- nroff -*-
   7 .if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
   8 .if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
   9 .if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
  10 .if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
  11 .if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
  12 .if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U
  13 .if t .ds s \\(*b
  14 .if t .ds S SS
  15 .if n .ds a ae
  16 .if n .ds o oe
  17 .if n .ds u ue
  18 .if n .ds s sz
  19 .TH ISOINFO 1 "04/06/01" "Version 2.0"
  20 .SH NAME
  21 devdump, isoinfo, isovfy, isodump \- Utility programs for dumping and verifying iso9660
  22 images.
  23 .SH SYNOPSIS
  24 .B devdump
  25 .I isoimage
  26 .PP
  27 .B isodump
  28 .I isoimage
  29 .PP
  30 .B isoinfo
  31 [
  32 .B \-d
  33 ]
  34 [
  35 .B \-h
  36 ]
  37 [
  38 .B \-R
  39 ]
  40 [
  41 .B \-J
  42 ]
  43 [
  44 .B \-j
  45 .I charset
  46 ]
  47 [
  48 .B \-f
  49 ]
  50 [
  51 .B \-l
  52 ]
  53 [
  54 .B \-p
  55 ]
  56 [
  57 .B \-T
  58 .I sector
  59 ]
  60 [
  61 .B \-N
  62 .I sector
  63 ]
  64 [
  65 .B \-i
  66 .I isoimage
  67 ]
  68 [
  69 .B \-x
  70 .I path
  71 ]
  72 .PP
  73 .B isovfy
  74 .I isoimage
  75 .SH DESCRIPTION
  76 .B devdump
  77 is a crude utility to interactively display the contents of device or
  78 filesystem images.
  79 The initial screen is a display of the first 256 bytes of the first 2048 byte
  80 sector.
  81 The commands are the same as with
  82 .BR isodump .
  83 .PP
  84 .B isodump
  85 is a crude utility to interactively display the contents of iso9660 images
  86 in order to verify directory integrity.
  87 The initial screen is a display of the first part of the root directory,
  88 and the prompt shows you the extent number and offset in the extent.
  89 .RS
  90 .PP
  91 You can use the 'a' and 'b'
  92 commands to move backwards and forwards within the image. The 'g' command
  93 allows you to goto an arbitrary extent, and the 'f' command specifies
  94 a search string to be used. The '+' command searches forward for the next
  95 instance of the search string, and the 'q' command exits
  96 .B devdump
  97 or
  98 .BR isodump .
  99 .RE
 100 .PP
 101 .B isoinfo
 102 is a utility to perform directory like listings of iso9660 images.
 103 .PP
 104 .B isovfy
 105 is a utility to verify the integrity of an iso9660 image. Most of the tests
 106 in
 107 .B isovfy
 108 were added after bugs were discovered in early versions of
 109 .B genisoimage.
 110 It isn't all that clear how useful this is anymore, but it doesn't hurt to
 111 have this around.
 112
 113 .SH OPTIONS
 114 The options common to all programs are
 115 .BR \-help , \-h , \-version ,
 116 .BI i =name, dev =name.
 117 The
 118 .B isoinfo
 119 program has additional command line options. The options are:
 120 .TP
 121 .B \-help
 122 .TP
 123 .B \-h
 124 print a summary of all options.
 125 .TP
 126 .B \-d
 127 Print information from the primary volume descriptor (PVD) of the iso9660
 128 image. This includes information about Rock Ridge, Joliet extensions
 129 and Eltorito boot information
 130 if present.
 131 .TP
 132 .B \-f
 133 generate output as if a 'find . -print' command had been run on the iso9660
 134 image. You should not use the
 135 .B -l
 136 image with the
 137 .B -f
 138 option.
 139 .TP
 140 .B \-i iso_image
 141 Specifies the path of the iso9660 image that we wish to examine.
 142 The options
 143 .B \-i
 144 and
 145 .BI dev= target
 146 are mutual exclusive.
 147 .TP
 148 .BI dev= target
 149 Sets the SCSI target for the drive, see notes above.
 150 A typical device specification is
 151 .BI dev= 6,0
 152 \&.
 153 If a filename must be provided together with the numerical target
 154 specification, the filename is implementation specific.
 155 The correct filename in this case can be found in the system specific
 156 manuals of the target operating system.
 157 On a
 158 .I FreeBSD
 159 system without
 160 .I CAM
 161 support, you need to use the control device (e.g.
 162 .IR /dev/rcd0.ctl ).
 163 A correct device specification in this case may be
 164 .BI dev= /dev/rcd0.ctl:@
 165 \&.
 166 .sp
 167 On Linux, drives connected to a parallel port adapter are mapped
 168 to a virtual SCSI bus. Different adapters are mapped to different
 169 targets on this virtual SCSI bus.
 170 .sp
 171 If no
 172 .I dev
 173 option is present, the program
 174 will try to get the device from the
 175 .B CDR_DEVICE
 176 environment.
 177 .sp
 178 If the argument to the
 179 .B dev=
 180 option does not contain the characters ',', '/', '@' or ':',
 181 it is interpreted as an label name that may be found in the file
 182 /etc/wodim.conf (see FILES section).
 183 .sp
 184 The options
 185 .B \-i
 186 and
 187 .BI dev= target
 188 are mutual exclusive.
 189 .TP
 190 .B \-l
 191 generate output as if a 'ls -lR' command had been run on the iso9660 image.
 192 You should not use the
 193 .B -f
 194 image with the
 195 .B -l
 196 option.
 197 .TP
 198 .B \-N sector
 199 Quick hack to help examine single session disc files that are to be written to
 200 a multi-session disc. The sector number specified is the sector number at
 201 which the iso9660 image should be written when send to the cd-writer. Not
 202 used for the first session on the disc.
 203 .TP
 204 .B \-p
 205 Print path table information.
 206 .TP
 207 .B \-R
 208 Extract information from Rock Ridge extensions (if present) for permissions,
 209 file names and ownerships.
 210 .TP
 211 .B \-J
 212 Extract information from Joliet extensions (if present) for file names.
 213 .TP
 214 .B \-j charset
 215 Convert Joliet file names (if present) to the supplied charset. See
 216 .BR genisoimage (8)
 217 for details.
 218 .TP
 219 .B \-T sector
 220 Quick hack to help examine multi-session images that have already been burned
 221 to a multi-session disc. The sector number specified is the sector number for
 222 the start of the session we wish to display.
 223 .TP
 224 .B \-x pathname
 225 Extract specified file to stdout.
 226 .SH AUTHOR
 227 The author of the original sources (1993 .\|.\|. 1998) is
 228 Eric Youngdale <ericy@gnu.ai.mit.edu> or <eric@andante.jic.com> is to blame
 229 for these shoddy hacks.
 230 J\*org Schilling wrote the SCSI transport library and its adaptation layer to
 231 the programs and newer parts (starting from 1999) of the utilities, this makes
 232 them
 233 Copyright (C) 1999-2004 J\*org Schilling.
 234 Patches to improve general usability would be gladly accepted.
 235 .PP
 236 This manpage describes the program implementation of
 237 .B
 238 isoinfo
 239 as shipped by the cdrkit distribution. See
 240 .B
 241 http://alioth.debian.org/projects/debburn/
 242 for details. It is a spinoff from the original program distributed in the
 243 cdrtools package [1]. However, the cdrtools
 244 developers are not involved in the development of this spinoff and therefore
 245 shall not be made responsible for any problem caused by it. Do not try to get
 246 support for this program by contacting the original author(s).
 247 .PP
 248 If you have support questions, send them to
 249 .PP
 250 .B
 251 debburn-devel@lists.alioth.debian.org
 252 .br
 253 .PP
 254 If you have definitely found a bug, send a mail to this list or to
 255 .PP
 256 .B
 257 submit@bugs.debian.org
 258 .br
 259 .PP
 260 writing at least a short description into the Subject and "Package: cdrkit" into the first line of the mail body.
 261 .SH BUGS
 262 The user interface really sucks.
 263 .SH FUTURE IMPROVEMENTS
 264 These utilities are really quick hacks, which are very useful for debugging
 265 problems in genisoimage or in an iso9660 filesystem. In the long run, it would
 266 be nice to have a daemon that would NFS export a iso9660 image.
 267 .PP
 268 The isoinfo program is probably the program that is of the most use to
 269 the general user.
 270 .SH AVAILABILITY
 271 These utilities come with the
 272 .B cdrkit
 273 package, and the primary download site
 274 is http://debburn.alioth.debian.org/ and FTP mirrors of distributions.
 275 Despite the name, the software is not beta.
 276
 277 .SH ENVIRONMENT
 278 .TP
 279 .B CDR_DEVICE
 280 This may either hold a device identifier that is suitable to the open
 281 call of the SCSI transport library or a label in the file /etc/wodim.conf.
 282 .TP
 283 .B RSH
 284 If the
 285 .B RSH
 286 environment is present, the remote connection will not be created via
 287 .BR rcmd (3)
 288 but by calling the program pointed to by
 289 .BR RSH .
 290 Use e.g.
 291 .BR RSH= /usr/bin/ssh
 292 to create a secure shell connection.
 293 .sp
 294 Note that this forces the program
 295 to create a pipe to the
 296 .B rsh(1)
 297 program and disallows the program
 298 to directly access the network socket to the remote server.
 299 This makes it impossible to set up performance parameters and slows down
 300 the connection compared to a
 301 .B root
 302 initiated
 303 .B rcmd(3)
 304 connection.
 305 .TP
 306 .B RSCSI
 307 If the
 308 .B RSCSI
 309 environment is present, the remote SCSI server will not be the program
 310 .B /opt/schily/sbin/rscsi
 311 but the program pointed to by
 312 .BR RSCSI .
 313 Note that the remote SCSI server program name will be ignored if you log in
 314 using an account that has been created with a remote SCSI server program as
 315 login shell.
 316
 317 .SH FILES
 318 .TP
 319 /etc/wodim.conf
 320 Default values can be set for the following options in /etc/wodim.conf.
 321 .RS
 322 .TP
 323 CDR_DEVICE
 324 This may either hold a device identifier that is suitable to the open
 325 call of the SCSI transport library or a label in the file /etc/wodim.conf
 326 that allows to identify a specific drive on the system.
 327 .TP
 328 Any other label
 329 is an identifier for a specific drive on the system.
 330 Such an identifier may not contain the characters ',', '/', '@' or ':'.
 331 .sp
 332 Each line that follows a label contains a TAB separated list of items.
 333 Currently, four items are recognized: the SCSI ID of the drive, the
 334 default speed that should be used for this drive, the default FIFO size
 335 that should be used for this drive and drive specific options. The values for
 336 .I speed
 337 and
 338 .I fifosize
 339 may be set to -1 to tell the program to use the global defaults.
 340 The value for driveropts may be set to "" if no driveropts are used.
 341 A typical line may look this way:
 342 .sp
 343 teac1= 0,5,0    4       8m      ""
 344 .sp
 345 yamaha= 1,6,0   -1      -1      burnfree
 346 .sp
 347 This tells the program
 348 that a drive named
 349 .I teac1
 350 is at scsibus 0, target 5, lun 0 and should be used with speed 4 and
 351 a FIFO size of 8 MB.
 352 A second drive may be found at scsibus 1, target 6, lun 0 and uses the
 353 default speed and the default FIFO size.
 354 .RE
 355 .SH SEE ALSO
 356 .BR genisoimage (1),
 357 .BR wodim (1),
 358 .BR readcd (1),
 359 .BR ssh (1).
 360 .RE
 361 .SH SOURCES
 362 .PP
 363 .br
 364 [1] Cdrtools 2.01.01a08 from May 2006, http://cdrecord.berlios.de
 365