PXFFPATHCONF

POSIX Subroutine: Gets the value for a configuration option of an opened file.

Module

USE IFPOSIX

CALL PXFFPATHCONF (ifildes,name,ival,ierror)

ifildes	(Input) INTEGER(4). The file descriptor of the opened file.
name	(Input) INTEGER(4). The configurable option.
ival	(Output) INTEGER(4). The value of the configurable option.
ierror	(Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFFPATHCONF subroutine gets a value for the configuration option named for the opened file with descriptor ifildes.

The configuration option, defined in name, can be obtained by using PXFCONST or IPXFCONST with one of the following constant names:

Constant	Action
_PC_LINK_MAX	Returns the maximum number of links to the file. If `ifildes` refers to a directory, then the value applies to the whole directory.
_PC_MAX_CANON¹	Returns the maximum length of a formatted input line; the file descriptor `ifildes` must refer to a terminal.
_PC_MAX_INPUT¹	Returns the maximum length of an input line; the file descriptor `ifildes` must refer to a terminal.
_PC_NAME_MAX	Returns the maximum length of a filename in `ifildes` that the process is allowed to create.
_PC_PATH_MAX	Returns the maximum length of a relative pathname when `ifildes` is the current working directory.
_PC_PIPE_BUF	Returns the size of the pipe buffer; the file descriptor `ifildes` must refer to a pipe or FIFO.
_PC_CHOWN_RESTRICTED¹	Returns nonzero if PXFCHOWN may not be used on this file. If `ifildes` refers to a directory, then this applies to all files in that directory.
_PC_NO_TRUNC¹	Returns nonzero if accessing filenames longer than _POSIX_NAME_MAX will generate an error.
_PC_VDISABLE¹	Returns nonzero if special character processing can be disabled; the file descriptor `ifildes` must refer to a terminal.
¹LX, MX

On Linux* and OS X* systems, the corresponding macros are defined in <unistd.h>. The values for name can be obtained by using PXFCONST or IPXFCONST when passing the string names of predefined macros in <unistd.h>. The following table shows the corresponding macro names for the above constants:

Constant	Corresponding Macro
_PC_LINK_MAX	_POSIX_LINK_MAX
_PC_MAX_CANON	_POSIX_MAX_CANON
_PC_MAX_INPUT	_POSIX_MAX_INPUT
_PC_NAME_MAX	_POSIX_NAME_MAX
_PC_PATH_MAX	_POSIX_PATH_MAX
_PC_PIPE_BUF	_POSIX_PIPE_BUF
_PC_CHOWN_RESTRICTED	_POSIX_CHOWN_RESTRICTED
_PC_NO_TRUNC	_POSIX_NO_TRUNC
_PC_VDISABLE	_POSIX_VDISABLE

PXFFPATHCONF

Module

See Also