NAME    [Toc]    [Back]

       cd_type - determines the type of file system recorded on a
       CD-ROM

SYNOPSIS    [Toc]    [Back]

       #include <sys/cdrom.h>

       int cd_type(
               char *path );

LIBRARY    [Toc]    [Back]

       Rock Ridge and  X/Open  Extensions  to  the  CDFS  library
       (libcdrom.so, libcdrom.a)

PARAMETERS    [Toc]    [Back]

       Points to a pathname naming a file or directory within the
       CD-ROM File System hierarchy, or to a pathname naming  the
       block special file for the CD-ROM File System.

DESCRIPTION    [Toc]    [Back]

       The  cd_type()  routine determines the type of file system
       recorded on the CD-ROM pointed to by *path.

RETURN VALUES    [Toc]    [Back]

       If successful, the cd_type() function returns one  of  the
       following  values,  which  are  defined in cdfs/xcdr.h, an
       include file that is called into sys/cdrom.h:

       {CD_ISO9660} -- CD-ROM is recorded according to ISO  9660.

       {CD_HSG}  --  CD-ROM  is recorded according to High Sierra
       Group.

       {CD_RRIP} -- CD-ROM is recorded according to ISO 9660 with
       the Rock Ridge Extension.

       If  unsuccessful,  the integer -1 is returned and errno is
       set to indicate the error.

ERRORS    [Toc]    [Back]

       The function will fail if: Search permission is denied for
       a  directory  in  *path or read and execute permission are
       denied for the named file, or read permission is denied on
       the  block  special file pointed to by *path.  The address
       of *path is invalid.  A signal was caught during execution
       of  the  function.  The argument *path points to a file or
       directory that is not within the  CD-ROM  file  hierarchy.
       {OPEN_MAX}  file  descriptors  are  currently  open in the
       calling process.

              [Tru64 UNIX]  Either the OPEN_MAX value or the perprocess
  soft  descriptor  limit  is  checked.  The
              length of the *path string exceeds {PATH_MAX}, or a
              pathname  component is longer than {NAME_MAX} while
              {_POSIX_NO_TRUNC} is in effect.   The  system  file
              table is full.  A component of *path does not exist
              or the *path argument points to an empty string.  A
              component  of  the *path prefix is not a directory.
              The CD-ROM is not in the  drive  or  a  read  error
              occurred.

              The  named  file  is  a  block special file and the
              device associated with the special  file  does  not
              exist.

SEE ALSO    [Toc]    [Back]

       Files: cdfs/xcdr.h, sys/cdrom.h



                                                       cd_type(3)