---

32.9 Using pathconf

When your machine allows different files to have different values for a file system parameter, you can use the functions in this section to find out the value that applies to any particular file.

These functions and the associated constants for the parameter argument are declared in the header file unistd.h.

Function: long int pathconf (const char *filename, int parameter) ¶

Preliminary: | MT-Safe | AS-Unsafe lock heap | AC-Unsafe lock fd mem | See POSIX Safety Concepts.

This function is used to inquire about the limits that apply to the file named filename.

The parameter argument should be one of the ‘_PC_’ constants listed below.

The normal return value from pathconf is the value you requested. A value of -1 is returned both if the implementation does not impose a limit, and in case of an error. In the former case, errno is not set, while in the latter case, errno is set to indicate the cause of the problem. So the only way to use this function robustly is to store 0 into errno just before calling it.

Besides the usual file name errors (see File Name Errors), the following error condition is defined for this function:

EINVAL

The value of parameter is invalid, or the implementation doesn’t support the parameter for the specific file.

Function: long int fpathconf (int filedes, int parameter) ¶

Preliminary: | MT-Safe | AS-Unsafe lock heap | AC-Unsafe lock fd mem | See POSIX Safety Concepts.

This is just like pathconf except that an open file descriptor is used to specify the file for which information is requested, instead of a file name.

The following errno error conditions are defined for this function:

EBADF

The filedes argument is not a valid file descriptor.

EINVAL

The value of parameter is invalid, or the implementation doesn’t support the parameter for the specific file.

Here are the symbolic constants that you can use as the parameter argument to pathconf and fpathconf. The values are all integer constants.

_PC_LINK_MAX ¶

Inquire about the value of LINK_MAX.

_PC_MAX_CANON ¶

Inquire about the value of MAX_CANON.

_PC_MAX_INPUT ¶

Inquire about the value of MAX_INPUT.

_PC_NAME_MAX ¶

Inquire about the value of NAME_MAX.

_PC_PATH_MAX ¶

Inquire about the value of PATH_MAX.

_PC_PIPE_BUF ¶

Inquire about the value of PIPE_BUF.

_PC_CHOWN_RESTRICTED ¶

Inquire about the value of _POSIX_CHOWN_RESTRICTED.

_PC_NO_TRUNC ¶

Inquire about the value of _POSIX_NO_TRUNC.

_PC_VDISABLE ¶

Inquire about the value of _POSIX_VDISABLE.

_PC_SYNC_IO ¶

Inquire about the value of _POSIX_SYNC_IO.

_PC_ASYNC_IO ¶

Inquire about the value of _POSIX_ASYNC_IO.

_PC_PRIO_IO ¶

Inquire about the value of _POSIX_PRIO_IO.

_PC_FILESIZEBITS ¶

Inquire about the availability of large files on the filesystem.

_PC_REC_INCR_XFER_SIZE ¶

Inquire about the value of POSIX_REC_INCR_XFER_SIZE.

_PC_REC_MAX_XFER_SIZE ¶

Inquire about the value of POSIX_REC_MAX_XFER_SIZE.

_PC_REC_MIN_XFER_SIZE ¶

Inquire about the value of POSIX_REC_MIN_XFER_SIZE.

_PC_REC_XFER_ALIGN ¶

Inquire about the value of POSIX_REC_XFER_ALIGN.

Portability Note: On some systems, the GNU C Library does not enforce _PC_NAME_MAX or _PC_PATH_MAX limits.