cd_ptrec(3)cd_ptrec(3)NAME
cd_ptrec, cd_cptrec - reads the Path Table Record from the CD-ROM Path
Table
SYNOPSIS
#include <sys/cdrom.h>
int cd_ptrec(
char *path,
struct iso9660_ptrec *ptrec ); int cd_cptrec(
char *path,
char *addr );
LIBRARY
Rock Ridge and X/Open Extensions to the CDFS library (libcdrom.so,
libcdrom.a)
PARAMETERS
Points to a file or directory within the CD-ROM File System hierarchy.
Points to the iso9660_ptrec structure that holds the contents of the
Path Table Record associated with the file or directory pointed to by
*path. The iso9660_ptrec structure is defined in cdfs/xcdr.h, an
include file that is called into sys/cdrom.h Specifies the address to
which the function cd_cptrec() copies the complete Path Table Record
that is recorded on the CD-ROM.
DESCRIPTION
The cd_ptrec() routine fills the *ptrec structure with the contents of
the Path Table Record associated with the directory that is pointed to
by *path.
The cd_cptrec() function copies the complete Path Table Record that is
recorded on the CD-ROM to the address pointed to by *addr. The user
must allocate {CD_MAXPTRECL} bytes for the Path Table Record. The vari‐
able {CD_MAXPTRECL} is defined in cdfs/xcdr.h, an include file that is
called into sys/cdrom.h.
RETURN VALUES
If successful, the value zero is returned. If unsuccessful, the integer
-1 is returned and errno is set to indicate the error.
ERRORS
Search permission is denied for a directory in *path or read permission
is denied for the named directory. The address of *path or *addr 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 per-process 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.
SEE ALSO
Files: cdfs/xcdr.h, sys/cdrom.h
cd_ptrec(3)