Penguin
Recent Changes
Annotated edit history of pathconf(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 FPATHCONF
2 !!!FPATHCONF
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 CONFORMING TO
8 NOTES
9 SEE ALSO
10 ----
11 !!NAME
12
13
14 fpathconf, pathconf - get configuration values for files
15 !!SYNOPSIS
16
17
18 __#include
19 __ ''filedes''__, int__ ''name''__);
20 long pathconf(char *__''path''__, int__ ''name''__);
21 __
22 !!DESCRIPTION
23
24
25 __fpathconf()__ gets a value for the configuration option
26 ''name'' for the open file descriptor
27 ''filedes''.
28
29
30 __pathconf()__ gets a value for configuration option
31 ''name'' for the file name ''path''.
32
33
34 The corresponding macros defined in ____
35 are minimum values; if an application wants to take
36 advantage of values which may change, a call to
37 __fpathconf()__ or __pathconf()__ can be made, which
38 may yield more liberal results.
39
40
41 Setting ''name'' equal to one of the following constants
42 returns the following configuration options:
43
44
45 ___PC_LINK_MAX__
46
47
48 returns the maximum number of links to the file. If
49 ''filedes'' or ''path'' refer to a directory, then the
50 value applies to the whole directory. The corresponding
51 macro is ___POSIX_LINK_MAX__.
52
53
54 ___PC_MAX_CANON__
55
56
57 returns the maximum length of a formatted input line, where
58 ''filedes'' or ''path'' must refer to a terminal. The
59 corresponding macro is ___POSIX_MAX_CANON__.
60
61
62 ___PC_MAX_INPUT__
63
64
65 returns the maximum length of an input line, where
66 ''filedes'' or ''path'' must refer to a terminal. The
67 corresponding macro is ___POSIX_MAX_INPUT__.
68
69
70 ___PC_NAME_MAX__
71
72
73 returns the maximum length of a filename in the directory
74 ''path'' or ''filedes''. the process is allowed to
75 create. The corresponding macro is
76 ___POSIX_NAME_MAX__.
77
78
79 ___PC_PATH_MAX__
80
81
82 returns the maximum length of a relative pathname when
83 ''path'' or ''filedes'' is the current working
84 directory. The corresponding macro is
85 ___POSIX_PATH_MAX__.
86
87
88 ___PC_PIPE_BUF__
89
90
91 returns the size of the pipe buffer, where ''filedes''
92 must refer to a pipe or FIFO and ''path'' must refer to a
93 FIFO. The corresponding macro is
94 ___POSIX_PIPE_BUF__.
95
96
97 ___PC_CHOWN_RESTRICTED__
98
99
100 returns nonzero if the chown(2) call may not be used
101 on this file. If ''filedes'' or ''path'' refer to a
102 directory, then this applies to all files in that directory.
103 The corresponding macro is
104 ___POSIX_CHOWN_RESTRICTED__.
105
106
107 ___PC_NO_TRUNC__
108
109
110 returns nonzero if accessing filenames longer than
111 ___POSIX_NAME_MAX__ generates an error. The corresponding
112 macro is ___POSIX_NO_TRUNC__.
113
114
115 ___PC_VDISABLE__
116
117
118 returns nonzero if special character processing can be
119 disabled, where ''filedes'' or ''path'' must refer to
120 a terminal.
121 !!RETURN VALUE
122
123
124 The limit is returned, if one exists. If the system does not
125 have a limit for the requested resource, -1 is returned, and
126 ''errno'' is unchanged. If there is an error, -1 is
127 returned, and ''errno'' is set to reflect the nature of
128 the error.
129 !!CONFORMING TO
130
131
132 POSIX.1
133 !!NOTES
134
135
136 Files with name lengths longer than the value returned for
137 ''name'' equal to ___PC_NAME_MAX__ may exist in the
138 given directory.
139
140
141 Some returned values may be huge; they are not suitable for
142 allocating memory.
143 !!SEE ALSO
144
145
146 getconf(1), statfs(2), open(2),
147 sysconf(3)
148 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.