fpathconf(2POSIX)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

fpathconf- get configurable pathname variables

SYNOPSIS

#include <unistd.h>

long fpathconf(int fd, int name);

FEATURES

MSDOSFS, NFS_CLIENT, UFS

DESCRIPTION

fpathconf() provides a method for applications to determine the current value of a configurable system limit or option variable associated with a pathname or file descriptor.

PARAMETERS

fpathconf() takes the parameters described in the list below:

fd

An open file descriptor.

name

A system variable to be queried.

path

A file or directory name. Symbolic constants for each name value are found in the include file <unistd.h>.

name may be one of:

_PC_CHOWN_RESTRICTED

Returns 1 if appropriate privileges are required for the chown system call, otherwise returns 0.

_PC_LINK_MAX

The maximum file link count.

_PC_MAX_CANON

The maximum number of bytes in a terminal canonical input line.

_PC_MAX_INPUT

The maximum number of bytes for which space is available in a terminal input queue.

_PC_NAME_MAX

The maximum number of bytes in a file name.

_PC_NO_TRUNC

Returns 1 if file names longer than KERN_NAME_MAX are truncated.

_PC_PATH_MAX

The maximum number of bytes in a pathname.

_PC_PIPE_BUF

The maximum number of bytes written automatically to a pipe.

_PC_VDISABLE

The terminal character disabling value.

RETURN VALUES

fpathconf() returns the following values:

-1

The call was not successful and errno was set appropriately, or the variable is associated with functionality that does not have a limit in the system and errno was not modified.

other

The current variable value.

ERRORS

If any of the following conditions occur, the fpathconf() function returns -1 and set errno to one of the following error conditions.

[EINVAL]

The value of the name argument is invalid.

[EINVAL]

The implementation does not support an association of the variable name with the associated file.

fpathconf() will fail if:

[EBADF]

fd is not a valid open file descriptor.

[EIO]

An I/O error occurred while reading from or writing to the file system.

EXAMPLES

---

Example 1




---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

sysctl(2POSIX)

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | EXAMPLES | ATTRIBUTES | SEE ALSO