cd_ptrec(3X)

cd_ptrec, cd_cptrec -- read CD-ROM Path Table Record

Synopsis

   cc [flag . . . ] file . . . -lcdfs -lgen [library] . . .
   
   #include <sys/cdrom.h>
   

   int cd_ptrec(const char *path, struct iso9660_ptrec *ptrec);
   

   int cd_cptrec(const char *path, char *ptrec);

Description

cd_ptrec fills the ptrec structure with the contents of the Path Table Record associated with a directory which is referred to by the path argument.

cd_cptrec copies the complete Path Table Record as recorded on the CD-ROM to the address ptrec.

path: Points to a directory within the CD-ROM file hierarchy.
ptrec: Pointer to structure or character array where Path Table Record is to be copied. The characters must contain at least CD_MAXPTRECL bytes.

Return values

On success, the functions return a value of zero. On failure, the functions return -1 and set errno to identify the error as follows:

EACCES: Read permission is denied on the mount point, or search permission is denied on a component of path.
EFAULT: Invalid address of ptrec or path.
EINTR: A signal was caught during the execution of one of the functions.
EINVAL: path points to a directory that is outside the CD-ROM file system.
EMFILE: The maximum number of file descriptors are open.
ENAMETOOLONG: The size of path exceeds MAXPATHLEN, or the component of a path name is longer than MAXNAMELEN while _POSIX_NO_TRUNC is in effect.
ENFILE: The system file table is full.
ENOENT: path does not exist or the path argument points to an empty string.
ENOTDIR: path is not a directory.
ENXIO: Either a read error occurred, or the CD-ROM is not in the drive.

REFERENCES

cdptrec(1M)