NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <unistd.h>long pathconf(const char * path, int name);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
MSDOSFS, NFS_CLIENT, UFS
The pathconf() and fpathconf() functions provide a method for applications to determine the current value of a configurable system limit or option variable associated with a pathname or file descriptor.
pathconf() and fpathconf() take the following parameters:
The name of a file or directory (for pathconf() ).
An open file descriptor (for fpathconf() ).
A system variable to be queried. Symbolic constants for each name value are found in the include file <unistd.h> .
name may be one of:
Returns 1 if appropriate privileges are required for the chown(2POSIX) system call. Otherwise, returns 0 .
The maximum file link count.
The maximum number of bytes in a canonical terminal input line.
The maximum number of bytes for which space is available in a terminal input queue.
The maximum number of bytes in a file name.
Returns
1
if file names longer than
KERN_NAME_MAX
are truncated.
The maximum number of bytes in a path name.
The maximum number of bytes that will be written atomically to a pipe.
Returns the terminal character disabling value.
If the call to pathconf() or fpathconf() is not successful, -1 is returned and errno is set appropriately.
Otherwise, if the variable is associated with a functionality that does not have a limit in the system, -1 is returned and errno is not modified.
In other cases, the current variable value is returned.
If any of the following conditions occur, the pathconf() and fpathconf() functions return -1 and set errno to one of the following error codes:
The value of the name argument is invalid.
The implementation does not support an association of the variable name with the associated file.
pathconf() will fail if:
A component of the path parameter is not a directory.
A component of a pathname exceeds 255 characters, or an entire pathname exceeds 1023 characters.
The named file does not exist.
Search permission is denied for a component of the path parameter.
Too many symbolic links were encountered in translating the pathname.
An I/O error occurred while reading from or writing to the file system.
fpathconf() will fail if:
fd is not a valid open file descriptor.
An I/O error occurred while reading from or writing to the file system.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
MT-Level | Async-Signal-Safe |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO