ISOINFO(1)



ISOINFO(1)                  General Commands Manual                 ISOINFO(1)

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 de-
       vice 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 for-
              wards 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  in-
              stance  of  the search string, and the 'q' command exits devdump
              or isodump.

       isoinfo is a utility to perform directory like listings of iso9660  im-
       ages.

       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 op-
       tions. 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  pro-
              vided  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  sup-
              port,  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  differ-
              ent targets on this virtual SCSI bus.

              If no dev option is present, the program will try to get the de-
              vice from the CDR_DEVICE environment.

              If the argument to the dev= option does not contain the  charac-
              ters  ',',  '/',  '@' or ':', it is interpreted as an label name
              that may be found in the file /etc/wodim.conf  (see  FILES  sec-
              tion).

              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  op-
              tion.

       -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 writ-
              ten 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  al-
              ready  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  ac-
       cepted.

       This manpage describes the program implementation of isoinfo as shipped
       by the cdrkit distribution. See  http://alioth.debian.org/projects/deb-
       burn/  for  details. It is a spinoff from the original program distrib-
       uted 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  de-
       bugging  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 distribu-
       tions.  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 val-
                     ues 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 sc-
                     sibus 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

Version 2.0                        04/06/01                         ISOINFO(1)

Man(1) output converted with man2html
list of all man pages