pathconf(3P)                                         pathconf(3P)



     NAME
          pathconf, fpathconf - get configurable pathname variables

     SYNOPSIS
          #include <unistd.h>

          long pathconf(path, name)
          char *path;
          int name;

          long fpathconf(fildes, name)
          int fildes, name;

     DESCRIPTION
          pathconf and fpathconf provide a method for an application
          to determine the current value of a configurable limit or
          option that is associated with a file or directory.

          For fpathconf, path points to a pathname of a file or direc-
          tory.  For fpathconf, fildes is an open file descriptor.
          name is the variable to be queried relative to the file or
          directory.  The following variables can be queried:

             _PC_LINK_MAX
             _PC_MAX_CANON
             _PC_MAX_INPUT
             _PC_NAME_MAX
             _PC_PATH_MAX
             _PC_PIPE_BUF
             _PC_CHOWN_RESTRICTED
             _PC_CHOWN_SUP_GRP
             _PC_DIR_DOTS
             _PC_GROUP_PARENT
             _PC_LINK_DIR
             _PC_NO_TRUNC
             _PC_UTIME_OWNER
             _PC_VDISABLE


     RETURN VALUE
          If the named variable is not defined on the system, or if
          name is not a valid variable name, or if the variable cannot
          be associated with the specified file or directory, or if
          the process does not have permission to query the file
          specified by path, or if path does not exist, pathconf re-
          turns -1.

          If the named variable is not defined on the system, or if
          name is not a valid variable name, or if the variable cannot
          be associated with the specified file or directory, fpath-
          conf returns -1.




     April, 1990                                                     1

     pathconf(3P)                                         pathconf(3P)



          If none of the above are true, pathconf and fpathconf return
          the current value associated with the variable for the file
          or directory.

     ERRORS
          pathconf and fpathconf will fail if one or more of the fol-
          lowing are true:

          [ENOTDIR]    A component of the path prefix is not a direc-
                       tory.

          [ENAMETOOLONG]
                       A component of a pathname exceeded NAME_MAX
                       characters, or an entire pathname exceeded
                       PATH_MAX.

          [ELOOP]      Too many symbolic links were encountered in
                       translating a pathname.

          [ENOENT]     The named file does not exist.

          [EACCES]     Search permission is denied for a component of
                       the path prefix.

          [EFAULT]     path points to an invalid address.

          [EINVAL]     The value of the name is invalid, or the vari-
                       able name is not associated with the specified
                       file.

          fpathconf will also fail if the following condition occurs:

          [EBADF]      The open file descriptor, fildes, is not valid.

     SEE ALSO
          sysconf(3P).



















     2                                                     April, 1990