Provided by: genisoimage_1.1.11-2ubuntu3_amd64 
NAME
devdump, isoinfo, isovfy, isodump - Utility programs for dumping and verifying iso9660 images.
SYNOPSIS
devdump isoimage
isodump isoimage
isoinfo [ -d ] [ -h ] [ -R ] [ -J ] [ -j charset ] [ -f ] [ -l ] [ -p ] [ -T sector ] [ -N sector ] [ -i
isoimage ] [ -x path ]
isovfy isoimage
DESCRIPTION
devdump is a crude utility to interactively display the contents of device or filesystem images. The
initial screen is a display of the first 256 bytes of the first 2048 byte sector. The commands are the
same as with isodump.
isodump is a crude utility to interactively display the contents of iso9660 images in order to verify
directory integrity. The initial screen is a display of the first part of the root directory, and the
prompt shows you the extent number and offset in the extent.
You can use the 'a' and 'b' commands to move backwards and forwards within the image. The 'g'
command allows you to goto an arbitrary extent, and the 'f' command specifies a search string to
be used. The '+' command searches forward for the next instance of the search string, and the 'q'
command exits devdump or isodump.
isoinfo is a utility to perform directory like listings of iso9660 images.
isovfy is a utility to verify the integrity of an iso9660 image. Most of the tests in isovfy were added
after bugs were discovered in early versions of genisoimage. It isn't all that clear how useful this is
anymore, but it doesn't hurt to have this around.
OPTIONS
The options common to all programs are -help,-h,-version, i=name,dev=name. The isoinfo program has
additional command line options. The options are:
-help
-h print a summary of all options.
-d Print information from the primary volume descriptor (PVD) of the iso9660 image. This includes
information about Rock Ridge, Joliet extensions and Eltorito boot information if present.
-f generate output as if a 'find . -print' command had been run on the iso9660 image. You should not
use the -l image with the -f option.
-i iso_image
Specifies the path of the iso9660 image that we wish to examine. The options -i and dev=target
are mutual exclusive.
dev=target
Sets the SCSI target for the drive, see notes above. A typical device specification is dev=6,0 .
If a filename must be provided together with the numerical target specification, the filename is
implementation specific. The correct filename in this case can be found in the system specific
manuals of the target operating system. On a FreeBSD system without CAM support, you need to use
the control device (e.g. /dev/rcd0.ctl). A correct device specification in this case may be
dev=/dev/rcd0.ctl:@ .
On Linux, drives connected to a parallel port adapter are mapped to a virtual SCSI bus. Different
adapters are mapped to different targets on this virtual SCSI bus.
If no dev option is present, the program will try to get the device from the CDR_DEVICE
environment.
If the argument to the dev= option does not contain the characters ',', '/', '@' or ':', it is
interpreted as an label name that may be found in the file /etc/wodim.conf (see FILES section).
The options -i and dev=target are mutual exclusive.
-l generate output as if a 'ls -lR' command had been run on the iso9660 image. You should not use
the -f image with the -l option.
-N sector
Quick hack to help examine single session disc files that are to be written to a multi-session
disc. The sector number specified is the sector number at which the iso9660 image should be
written when send to the cd-writer. Not used for the first session on the disc.
-p Print path table information.
-R Extract information from Rock Ridge extensions (if present) for permissions, file names and
ownerships.
-J Extract information from Joliet extensions (if present) for file names.
-j charset
Convert Joliet file names (if present) to the supplied charset. See genisoimage(8) for details.
-T sector
Quick hack to help examine multi-session images that have already been burned to a multi-session
disc. The sector number specified is the sector number for the start of the session we wish to
display.
-x pathname
Extract specified file to stdout.
AUTHOR
The author of the original sources (1993 ... 1998) is Eric Youngdale <ericy@gnu.ai.mit.edu> or
<eric@andante.jic.com> is to blame for these shoddy hacks. Joerg Schilling wrote the SCSI transport
library and its adaptation layer to the programs and newer parts (starting from 1999) of the utilities,
this makes them Copyright (C) 1999-2004 Joerg Schilling. Patches to improve general usability would be
gladly accepted.
This manpage describes the program implementation of isoinfo as shipped by the cdrkit distribution. See
http://alioth.debian.org/projects/debburn/ for details. It is a spinoff from the original program
distributed in the cdrtools package [1]. However, the cdrtools developers are not involved in the
development of this spinoff and therefore shall not be made responsible for any problem caused by it. Do
not try to get support for this program by contacting the original author(s).
If you have support questions, send them to
debburn-devel@lists.alioth.debian.org
If you have definitely found a bug, send a mail to this list or to
submit@bugs.debian.org
writing at least a short description into the Subject and "Package: cdrkit" into the first line of the
mail body.
BUGS
The user interface really sucks.
FUTURE IMPROVEMENTS
These utilities are really quick hacks, which are very useful for debugging problems in genisoimage or in
an iso9660 filesystem. In the long run, it would be nice to have a daemon that would NFS export a iso9660
image.
The isoinfo program is probably the program that is of the most use to the general user.
AVAILABILITY
These utilities come with the cdrkit package, and the primary download site is
http://debburn.alioth.debian.org/ and FTP mirrors of distributions. Despite the name, the software is
not beta.
ENVIRONMENT
CDR_DEVICE
This may either hold a device identifier that is suitable to the open call of the SCSI transport
library or a label in the file /etc/wodim.conf.
RSH If the RSH environment is present, the remote connection will not be created via rcmd(3) but by
calling the program pointed to by RSH. Use e.g. RSH=/usr/bin/ssh to create a secure shell
connection.
Note that this forces the program to create a pipe to the rsh(1) program and disallows the program
to directly access the network socket to the remote server. This makes it impossible to set up
performance parameters and slows down the connection compared to a root initiated rcmd(3)
connection.
RSCSI If the RSCSI environment is present, the remote SCSI server will not be the program
/opt/schily/sbin/rscsi but the program pointed to by RSCSI. Note that the remote SCSI server
program name will be ignored if you log in using an account that has been created with a remote
SCSI server program as login shell.
FILES
/etc/wodim.conf
Default values can be set for the following options in /etc/wodim.conf.
CDR_DEVICE
This may either hold a device identifier that is suitable to the open call of the SCSI
transport library or a label in the file /etc/wodim.conf that allows to identify a specific
drive on the system.
Any other label
is an identifier for a specific drive on the system. Such an identifier may not contain
the characters ',', '/', '@' or ':'.
Each line that follows a label contains a TAB separated list of items. Currently, four
items are recognized: the SCSI ID of the drive, the default speed that should be used for
this drive, the default FIFO size that should be used for this drive and drive specific
options. The values for speed and fifosize may be set to -1 to tell the program to use the
global defaults. The value for driveropts may be set to "" if no driveropts are used. A
typical line may look this way:
teac1= 0,5,0 4 8m ""
yamaha= 1,6,0 -1 -1 burnfree
This tells the program that a drive named teac1 is at scsibus 0, target 5, lun 0 and should
be used with speed 4 and a FIFO size of 8 MB. A second drive may be found at scsibus 1,
target 6, lun 0 and uses the default speed and the default FIFO size.
SEE ALSO
genisoimage(1), wodim(1), readcd(1), ssh(1).
SOURCES
[1] Cdrtools 2.01.01a08 from May 2006, http://cdrecord.berlios.de