Man Linux: Main Page and Category List

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