CDVD(1)                         Domain/OS BSD                          CDVD(1)



NAME
     cdvd - read Volume descriptor from CDROM

SYNTAX
     cdvd [-b] file

DESCRIPTION
     This command is used to read the Primary Volume Descriptor from a CD-ROM
     and to list the contents on standard output.

OPTIONS
     The following options are available:
     -b      With this option the entirety of the Primary Volume
             Descriptor is copied from CD-ROM to standard output
             in binary format.

OPERANDS
     The operand file is either a file or directory within the CD-ROM file
     hierarchy of the mounted CD-ROM file system or the name of a block
     special file for a CD-ROM file system.

STDIN
     Not used.

INPUT FILES
     None.

ENVIRONMENT VARIABLES
     LC_TIME determines the format and contents of date and time strings. If
     LC_TIME is not set in the environment or is set to the empty string, the
     value of LANG will be used as a default. If LANG is not set or is set to
     the empty string, the corresponding value from the implementation-
     specific default locale will be used. If LC_TIME or LANG contain an
     invalid setting, the utility will behave as if none of the variables had
     been defined.

STDOUT
     The output is formatted in the form of a table which contains the name of
     each field of the Primary Volume Descriptor and the corresponding
     contents of the entry as recorded on the CD-ROM. The Application Use
     field is not listed.  If the option -b is applied, the contents of the
     Primary Volume Descriptor is copied to standard output in binary format
     as it is on the CD-ROM. This includes the Application Use field.

STDERR
     Used only for diagnostic messages.

OUTPUT FILES
     None.

EXIT STATUS
     The following exit values are returned:

     0       successful completion

     1       file not found, file is not within a CD-ROM file
             hierarchy, or file is not a block special file for a
             CD-ROM file system or access permission denied.

     2       file is a block special file and a read error
             occurred or the CD-ROM is not recorded according

             to the ISO 9660 standard.


CONSEQUENCES OF ERRORS
     None.

APPLICATION USAGE
     The user must have read permission for file to execute the command
     successfully.

FUTURE DIRECTIONS
     This command may be extended for further types of Volume Descriptors
     (e.g., Supplementary Volume Descriptor, Volume Partition Descriptor). For
     this purpose additional options will be introduced.

SEE ALSO
     cdxar(1), cddrec(1), cdptrec(1)