Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (n - r) pathconf(3)
NAME
pathconf - Gets configuration attributes for a file
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series and J-series native Guardian processes: implicit libraries
H-series and J-series OSS processes: implicit libraries
SYNOPSIS
#include <unistd.h>
long int pathconf(
const char *path,
int name);
PARAMETERS
path Specifies the pathname of the file. If the final component of path is a symbolic
link, it will be traversed and filename resolution will continue.
name Specifies the configuration attribute to be queried. If this attribute is not applica-
ble to the file specified by the path parameter, the pathconf( ) function returns -1
and sets errno to indicate an error.
DESCRIPTION
The pathconf( ) function allows an application to determine the characteristics of operations sup-
ported by the file system underlying the file named by the path parameter. Read, write, or exe-
cute permission of the named file is not required, but all directories in the path leading to the file
must be searchable.
The set of system variables from the limits.h or unistd.h header file that are returned by the
pathconf( ) function, and the symbolic constants defined in the unistd.h header file that
correspond to the name parameter, are as follows:
LINK_MAX Is the maximum number of links to the file. If the path parameter refers to a
directory, the value returned applies to the directory itself. This variable is not
available at compile time.
Value of name: _PC_LINK_MAX
MAX_CANON
Is the maximum number of bytes in a canonical input line. This attribute is
applicable only to terminal devices. This variable is not available at compile
time.
Value of name: _PC_MAX_CANON
MAX_INPUT Is the maximum number of bytes an application can require as input before that
input is read. This attribute is applicable only to terminal devices. This variable
is not available at compile time.
Value of name: _PC_MAX_INPUT
NAME_MAX Is the maximum number of bytes in a filename (not including a terminating null).
This number can be as small as 8 but is never larger than 255. This variable is
not available at compile time.
Value of name: _PC_NAME_MAX
527187-017 Hewlett-Packard Company 5−45