summaryrefslogtreecommitdiff
path: root/reference/C/MAN/fpathconf.htm
blob: c10bda2842643deb0afff01210e332932b3e1df8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
<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>