Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ cd_cptrec(3X) — UnixWare 2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought






       cd_ptrec(3X)                                            cd_ptrec(3X)


       NAME
             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.

          Errors
             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.


                           Copyright 1994 Novell, Inc.               Page 1













      cd_ptrec(3X)                                            cd_ptrec(3X)


            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)




































                          Copyright 1994 Novell, Inc.               Page 2








Typewritten Software • bear@typewritten.org • Edmonds, WA 98026