Manpage of FPATHCONF

FPATHCONF

Section: Linux Programmer's Manual (3)
Updated: 2015-08-08
Index
 

NAME

fpathconf, pathconf - get configuration values for files  

SYNOPSIS

#include <unistd.h>long fpathconf(int fd, int name);
long pathconf(const char *path, int name);
 

DESCRIPTION

fpathconf() gets a value for the configuration option namefor the open file descriptor fd.

pathconf() gets a value for configuration option namefor the filename path.

The corresponding macros defined in <unistd.h>are minimum values; if an application wants to take advantage of values which may change, a call to fpathconf() or pathconf() can be made, which may yield more liberal results.

Setting nameequal to one of the following constants returns the following configuration options:

_PC_LINK_MAX
returns the maximum number of links to the file. If fdor pathrefer to a directory, then the value applies to the whole directory. The corresponding macro is _POSIX_LINK_MAX.
_PC_MAX_CANON
returns the maximum length of a formatted input line, where fdor pathmust refer to a terminal. The corresponding macro is _POSIX_MAX_CANON.
_PC_MAX_INPUT
returns the maximum length of an input line, where fdor pathmust refer to a terminal. The corresponding macro is _POSIX_MAX_INPUT.
_PC_NAME_MAX
returns the maximum length of a filename in the directory pathor fdthat the process is allowed to create. The corresponding macro is _POSIX_NAME_MAX.
_PC_PATH_MAX
returns the maximum length of a relative pathname when pathor fdis the current working directory. The corresponding macro is _POSIX_PATH_MAX.
_PC_PIPE_BUF
returns the size of the pipe buffer, where fdmust refer to a pipe or FIFO and pathmust refer to a FIFO. The corresponding macro is _POSIX_PIPE_BUF.
_PC_CHOWN_RESTRICTED
returns nonzero if the chown(2) call may not be used on this file. If fdor pathrefer to a directory, then this applies to all files in that directory. The corresponding macro is _POSIX_CHOWN_RESTRICTED.
_PC_NO_TRUNC
returns nonzero if accessing filenames longer than _POSIX_NAME_MAXgenerates an error. The corresponding macro is _POSIX_NO_TRUNC.
_PC_VDISABLE
returns nonzero if special character processing can be disabled, where fdor pathmust refer to a terminal.
 

RETURN VALUE

The limit is returned, if one exists. If the system does not have a limit for the requested resource, -1 is returned, and errnois unchanged. If there is an error, -1 is returned, and errnois set to reflect the nature of the error.  

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).
InterfaceAttributeValue
fpathconf(), pathconf() Thread safetyMT-Safe

 

CONFORMING TO

POSIX.1-2001, POSIX.1-2008.  

NOTES

Files with name lengths longer than the value returned for nameequal to _PC_NAME_MAXmay exist in the given directory.

Some returned values may be huge; they are not suitable for allocating memory.  

SEE ALSO

getconf(1), open(2), statfs(2), confstr(3), sysconf(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ATTRIBUTES
CONFORMING TO
NOTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 16:30:12 GMT, October 09, 2016 Click Here!