cd_drec(3X)

cd_drec, cd_cdrec -- read Directory Record from CD-ROM directory

Synopsis

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

   int cd_drec(const char *path, int fsec, struct iso9660_drec *drec);
   

   int cd_cdrec(const char *path, int fsec, char *drec);

Description

cd_drec fills the drec structure with the contents of the Directory Record associated with a file or directory referred to by path.

cd_cdrec copies the complete Directory Record on the CD-ROM to the address drec.

CD_MAXDRECL defines the size of the Directory Record.

path: File or directory in the CD-ROM file system.
fsec: Specifies the File Section of the named file. The numbering starts with one. The number -1 denotes the last File Section of the named file, or the only File Section of the named directory.
drec: Pointer to structure or character array where Directory Record is to be copied. The character array must contain at least CD_MAXDRECL bytes.

Return values

On success, cd_drec returns a value of zero. On failure, cd_drec returns a value of -1 and sets errno to identify the error as follows:

EACCES: Read permission is denied on the directory or file that path points to, or search permission is denied for a component of path
EFAULT: Invalid address for drec or path.
EINTR: Signal caught during the execution of one of the functions.
EINVAL: The value of fsec is invalid, or path points to directory or file outside of the CD-ROM file hierarchy.
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: A component of path is not a directory.
ENXIO: A read error or the CD-ROM is not in the drive.

References

cddrec(1M)