1 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
3 .\" %%%LICENSE_START(VERBATIM)
4 .\" Permission is granted to make and distribute verbatim copies of this
5 .\" manual provided the copyright notice and this permission notice are
6 .\" preserved on all copies.
8 .\" Permission is granted to copy and distribute modified versions of this
9 .\" manual under the conditions for verbatim copying, provided that the
10 .\" entire resulting derived work is distributed under the terms of a
11 .\" permission notice identical to this one.
13 .\" Since the Linux kernel and libraries are constantly changing, this
14 .\" manual page may be incorrect or out-of-date. The author(s) assume no
15 .\" responsibility for errors or omissions, or for damages resulting from
16 .\" the use of the information contained herein. The author(s) may not
17 .\" have taken the same level of care in the production of this manual,
18 .\" which is licensed free of charge, as they might when working
21 .\" Formatted or processed versions of this manual, if unaccompanied by
22 .\" the source, must acknowledge the copyright and authors of this work.
25 .\" Modified Wed Jul 28 11:12:26 1993 by Rik Faith (faith@cs.unc.edu)
27 .\" FIXME Probably all of the following should be documented:
33 .\" _PC_REC_INCR_XFER_SIZE,
34 .\" _PC_REC_MAX_XFER_SIZE,
35 .\" _PC_REC_MIN_XFER_SIZE,
36 .\" _PC_REC_XFER_ALIGN,
37 .\" _PC_ALLOC_SIZE_MIN,
41 .TH FPATHCONF 3 2014-05-28 "GNU" "Linux Programmer's Manual"
43 fpathconf, pathconf \- get configuration values for files
46 .B #include <unistd.h>
48 .BI "long fpathconf(int " fd ", int " name );
50 .BI "long pathconf(const char *" path ", int " name );
54 gets a value for the configuration option
56 for the open file descriptor
60 gets a value for configuration option
65 The corresponding macros defined in
67 are minimum values; if an application wants to take advantage of values
68 which may change, a call to
72 can be made, which may yield more liberal results.
76 equal to one of the following constants returns the following
77 configuration options:
80 returns the maximum number of links to the file.
85 refer to a directory, then the value applies to the whole directory.
86 The corresponding macro is
90 returns the maximum length of a formatted input line, where
94 must refer to a terminal.
95 The corresponding macro is
96 .BR _POSIX_MAX_CANON .
99 returns the maximum length of an input line, where
103 must refer to a terminal.
104 The corresponding macro is
105 .BR _POSIX_MAX_INPUT .
108 returns the maximum length of a filename in the directory
112 that the process is allowed to create.
113 The corresponding macro is
114 .BR _POSIX_NAME_MAX .
117 returns the maximum length of a relative pathname when
121 is the current working directory.
122 The corresponding macro is
123 .BR _POSIX_PATH_MAX .
126 returns the size of the pipe buffer, where
128 must refer to a pipe or FIFO and
130 must refer to a FIFO.
131 The corresponding macro is
132 .BR _POSIX_PIPE_BUF .
134 .B _PC_CHOWN_RESTRICTED
135 returns nonzero if the
137 call may not be used on this file.
142 refer to a directory, then this applies to all files in that
144 The corresponding macro is
145 .BR _POSIX_CHOWN_RESTRICTED .
148 returns nonzero if accessing filenames longer than
151 The corresponding macro is
152 .BR _POSIX_NO_TRUNC .
155 returns nonzero if special character processing can be disabled, where
159 must refer to a terminal.
161 The limit is returned, if one exists.
162 If the system does not have a
163 limit for the requested resource, \-1 is returned, and
166 If there is an error, \-1 is returned, and
168 is set to reflect the nature of the error.
172 Files with name lengths longer than the value returned for
176 may exist in the given directory.
178 Some returned values may be huge; they are not suitable for allocating
187 This page is part of release 3.79 of the Linux
190 A description of the project,
191 information about reporting bugs,
192 and the latest version of this page,
194 \%http://www.kernel.org/doc/man\-pages/.