ISOINFO linux command manual

ISOINFO(8)                                                         ISOINFO(8)



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 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
              instance  of  the search string, and the 'q' command exits dev-
              dump 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 mkisofs.  It isn't all that clear how useful this is any-
       more, 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  exam-
              ine.  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
              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 charac-
              ters  ',',  '/', '@' or ':', it is interpreted as an label name
              that may be found in the  file  /etc/cdrecord.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 speci-
              fied  is the sector number at which the iso9660 image should be
              written when send to the cd-writer. Not used for the first ses-
              sion 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 mkisofs(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
        or  is to blame for these
       shoddy  hacks.   Joerg  Schilling wrote the SCSI transport library and
       it's 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.

BUGS
       The user interface really sucks.

FUTURE IMPROVEMENTS
       These  utilities  are  really  quick  hacks, which are very useful for
       debugging problems in mkisofs 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 cdrtools package, and the primary ftp
       site is ftp.berlios.de in /pub/cdrecord and many other  mirror  sites.
       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/cdrecord.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/cdrecord.conf
              Default  values  can  be  set  for  the  following  options  in
              /etc/cdrecord.conf.

              CDR_DEVICE
                     This may either hold a device identifier that  is  suit-
                     able to the open call of the SCSI transport library or a
                     label in the  file  /etc/cdrecord.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
       mkisofs(8), cdrecord(1), readcd(1), scg(7), rcmd(3), ssh(1).



Version 2.0                        04/06/01                        ISOINFO(8)