<TITLE>pathconf</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>FPATHCONF(3)        Linux Programmer's Manual        FPATHCONF(3)
</h3>

<h3>NAME
</h3>       fpathconf, pathconf - get configuration values for files

<h3>SYNOPSIS
</h3>       #include &lt;unistd.h&gt;

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

<h3>DESCRIPTION
</h3>       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 &lt;unistd.h&gt; minimum
       values; if an application wants to take advantage of  val-
       ues  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 configuration 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 termi-
              nal.  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 cor-
              responding 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.  _POSIX_MAX_.

       _PC_PATH_MAX
              returns  the  maximum length of a relative pathname
              when path or filedes is the current working  direc-
              tory.   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.



<h3>GNU                       April 4, 1993                         1
</h3>




<h3>FPATHCONF(3)        Linux Programmer's Manual        FPATHCONF(3)
</h3>

       _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  corre-
              sponding 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.

<h3>RETURN VALUE
</h3>       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.

<h3>CONFORMS TO
</h3>       POSIX.1  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.

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=getconf.htm>getconf</a>, 
<a href=statfs.htm>statfs</a>, 
<a href=open.htm>open</a>, 
<a href=sysconf.htm>sysconf</a>, 
<pre>























<h3>GNU                       April 4, 1993                         2
</h3>


</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>