FPATHCONF - phpMan

FPATHCONF(3)               Linux Programmer’s Manual              FPATHCONF(3)



NAME
       fpathconf, pathconf - get configuration values for files

SYNOPSIS
       #include <unistd.h>

       long fpathconf(int filedes, int name);
       long pathconf(char *path, int name);

DESCRIPTION
       fpathconf()  gets  a  value  for  the  configuration  option name for the open file
       descriptor filedes.

       pathconf() gets a value for configuration option name for the file name path.

       The corresponding macros defined in <unistd.h> are minimum values; if  an  applica-
       tion  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 name equal to one of the following constants returns the following configu-
       ration options:

       _PC_LINK_MAX
              returns  the  maximum number of links to the file.  If filedes or path refer
              to a directory, then the value applies to the whole directory.   The  corre-
              sponding macro is _POSIX_LINK_MAX.

       _PC_MAX_CANON
              returns  the maximum length of a formatted input line, where filedes or path
              must refer to a terminal.  The corresponding macro is _POSIX_MAX_CANON.

       _PC_MAX_INPUT
              returns the maximum length of an input line,  where  filedes  or  path  must
              refer to a terminal.  The corresponding macro is _POSIX_MAX_INPUT.

       _PC_NAME_MAX
              returns  the  maximum length of a filename in the directory path or filedes.
              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 path or filedes is
              the current working directory.  The corresponding macro is  _POSIX_PATH_MAX.

       _PC_PIPE_BUF
              returns  the  size of the pipe buffer, where filedes must refer to a pipe or
              FIFO  and  path  must  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
              filedes or path refer 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_MAX generates
              an error.  The corresponding macro is _POSIX_NO_TRUNC.

       _PC_VDISABLE
              returns nonzero if special  character  processing  can  be  disabled,  where
              filedes or path must 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 errno is unchanged.  If there is an  error,
       -1 is returned, and errno is set to reflect the nature of the error.

CONFORMING TO
       POSIX.1

NOTES
       Files  with  name  lengths  longer  than  the  value  returned  for  name  equal to
       _PC_NAME_MAX may exist in the given directory.

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

SEE ALSO
       getconf(1), statfs(2), open(2), sysconf(3)



GNU                               1993-04-04                      FPATHCONF(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 05:04 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)