CD_CVD Domain/OS CD_CVD
NAME
cd_cvd - read Descriptor from CD-ROM
SYNTAX
#include <sys/cdrom.h>
int cd_cvd(path, nvd, vd)
char *path;
long nvd;
char *vd;
DESCRIPTION
The function cd_cvd() copies a complete Volume Descriptor as recorded on
the CD-ROM to the address vd. The argument nvd specifies which Volume
Descriptor to return. Possible values are 0 through 15 to access any of
the 16 possible Volume Descriptors. The user must allocate CD_PVDLEN
bytes for the Volume Descriptor. CD_PVDLEN is contained in <sys/cdrom.h>.
RETURN VALUE
Upon successful completion the function returns a value of zero. In case
of an error, -1 is returned and errno is set to indicate the error.
ERRORS
The function will fail if one or more of the following is true:
[EACCESS]
Search permission is denied for a component of the path
prefix. Read permission for the file or directory pointed
to by path or read permission for the block special file
pointed to by path is denied.
[ENAMETOOLONG]
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.
[ENOENT]
A component of path does not exist or the path
argument points to an empty string.
[EINVAL]
The named file is a block special file and the CD-ROM is not
recorded according to the ISO 9660 or the High Sierra Group
standards.
The value of nvd is outside of the range 0 through 15.
[ENOTDIR]
A component of the path prefix is not a directory.
[ENXIO]
The named file is a block special file and the device associated
with the special file does not exist.
The CD-ROM is not in the drive or a read error occured.
[EFAULT]
The address of vd or path is invalid.
[EINTR]
A signal was caught during one of the functions.
[EMFILE]
{OPEN_MAX} file descriptors are currently open in the
calling process.
[ENFILE]
The system file table is full.