1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2013-03-26 16:48+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man2/faccessat.2:25
26 #: build/C/man2/faccessat.2:25 build/C/man2/fchownat.2:25 build/C/man2/fstatat.2:25 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:25 build/C/man2/mknodat.2:25 build/C/man2/openat.2:25 build/C/man2/readlinkat.2:25 build/C/man2/renameat.2:25 build/C/man2/symlinkat.2:25 build/C/man2/unlinkat.2:25
32 #: build/C/man2/faccessat.2:25 build/C/man2/fchmodat.2:25 build/C/man2/fchownat.2:25 build/C/man2/fstatat.2:25 build/C/man2/futimesat.2:25 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:25 build/C/man3/mkfifoat.3:26 build/C/man2/mknodat.2:25 build/C/man2/openat.2:25 build/C/man2/readlinkat.2:25 build/C/man2/renameat.2:25 build/C/man2/symlinkat.2:25 build/C/man2/unlinkat.2:25
38 #: build/C/man2/faccessat.2:25 build/C/man2/fchmodat.2:25 build/C/man2/fchownat.2:25 build/C/man2/fstatat.2:25 build/C/man2/futimesat.2:25 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:25 build/C/man3/mkfifoat.3:26 build/C/man2/mknodat.2:25 build/C/man2/openat.2:25 build/C/man2/readlinkat.2:25 build/C/man2/renameat.2:25 build/C/man2/symlinkat.2:25 build/C/man2/unlinkat.2:25
40 msgid "Linux Programmer's Manual"
44 #: build/C/man2/faccessat.2:26 build/C/man2/fchmodat.2:26 build/C/man2/fchownat.2:26 build/C/man2/fstatat.2:26 build/C/man2/futimesat.2:26 build/C/man2/linkat.2:28 build/C/man2/mkdirat.2:26 build/C/man3/mkfifoat.3:27 build/C/man2/mknodat.2:26 build/C/man2/openat.2:26 build/C/man2/readlinkat.2:26 build/C/man2/renameat.2:26 build/C/man2/symlinkat.2:26 build/C/man2/unlinkat.2:26
50 #: build/C/man2/faccessat.2:29
52 "faccessat - check user's permissions of a file relative to a directory file "
57 #: build/C/man2/faccessat.2:29 build/C/man2/fchmodat.2:29 build/C/man2/fchownat.2:29 build/C/man2/fstatat.2:28 build/C/man2/futimesat.2:29 build/C/man2/linkat.2:30 build/C/man2/mkdirat.2:28 build/C/man3/mkfifoat.3:29 build/C/man2/mknodat.2:29 build/C/man2/openat.2:28 build/C/man2/readlinkat.2:29 build/C/man2/renameat.2:28 build/C/man2/symlinkat.2:28 build/C/man2/unlinkat.2:28
63 #: build/C/man2/faccessat.2:33 build/C/man2/fchownat.2:33 build/C/man2/linkat.2:34 build/C/man2/readlinkat.2:33 build/C/man2/symlinkat.2:32 build/C/man2/unlinkat.2:32
66 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
67 "B<#include E<lt>unistd.hE<gt>>\n"
71 #: build/C/man2/faccessat.2:36
74 "B<int faccessat(int >I<dirfd>B<, const char *>I<pathname>B<, int >I<mode>B<, "
75 "int >I<flags>B<);>\n"
79 #: build/C/man2/faccessat.2:41 build/C/man2/fchmodat.2:41 build/C/man2/fchownat.2:41 build/C/man2/fstatat.2:41 build/C/man2/futimesat.2:41 build/C/man2/linkat.2:42 build/C/man2/mkdirat.2:39 build/C/man3/mkfifoat.3:40 build/C/man2/mknodat.2:41 build/C/man2/openat.2:40 build/C/man2/readlinkat.2:41 build/C/man2/renameat.2:40 build/C/man2/symlinkat.2:40 build/C/man2/unlinkat.2:39
80 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
84 #: build/C/man2/faccessat.2:44
85 msgid "B<faccessat>():"
89 #: build/C/man2/faccessat.2:47 build/C/man2/fchmodat.2:47 build/C/man2/fchownat.2:47 build/C/man2/fstatat.2:47 build/C/man2/linkat.2:48 build/C/man2/mkdirat.2:45 build/C/man3/mkfifoat.3:46 build/C/man2/mknodat.2:47 build/C/man2/openat.2:46 build/C/man2/readlinkat.2:47 build/C/man2/renameat.2:46 build/C/man2/symlinkat.2:46 build/C/man2/unlinkat.2:45
91 msgid "Since glibc 2.10:"
95 #: build/C/man2/faccessat.2:50 build/C/man2/fchmodat.2:50 build/C/man2/fchownat.2:50 build/C/man2/fstatat.2:50 build/C/man2/linkat.2:51 build/C/man2/mkdirat.2:48 build/C/man3/mkfifoat.3:49 build/C/man2/openat.2:49 build/C/man2/readlinkat.2:50 build/C/man2/renameat.2:49 build/C/man2/symlinkat.2:49 build/C/man2/unlinkat.2:48
96 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
100 #: build/C/man2/faccessat.2:50 build/C/man2/fchmodat.2:50 build/C/man2/fchownat.2:50 build/C/man2/fstatat.2:50 build/C/man2/linkat.2:51 build/C/man2/mkdirat.2:48 build/C/man3/mkfifoat.3:49 build/C/man2/mknodat.2:52 build/C/man2/openat.2:49 build/C/man2/readlinkat.2:50 build/C/man2/renameat.2:49 build/C/man2/symlinkat.2:49 build/C/man2/unlinkat.2:48
102 msgid "Before glibc 2.10:"
106 #: build/C/man2/faccessat.2:53 build/C/man2/fchmodat.2:53 build/C/man2/fchownat.2:53 build/C/man2/fstatat.2:53 build/C/man2/linkat.2:54 build/C/man2/mkdirat.2:51 build/C/man3/mkfifoat.3:52 build/C/man2/mknodat.2:55 build/C/man2/openat.2:52 build/C/man2/readlinkat.2:53 build/C/man2/renameat.2:52 build/C/man2/symlinkat.2:52 build/C/man2/unlinkat.2:51
107 msgid "_ATFILE_SOURCE"
111 #: build/C/man2/faccessat.2:56 build/C/man2/fchmodat.2:56 build/C/man2/fchownat.2:56 build/C/man2/fstatat.2:56 build/C/man2/futimesat.2:45 build/C/man2/linkat.2:57 build/C/man2/mkdirat.2:54 build/C/man3/mkfifoat.3:55 build/C/man2/mknodat.2:58 build/C/man2/openat.2:55 build/C/man2/readlinkat.2:56 build/C/man2/renameat.2:55 build/C/man2/symlinkat.2:55 build/C/man2/unlinkat.2:54
117 #: build/C/man2/faccessat.2:62
119 "The B<faccessat>() system call operates in exactly the same way as "
120 "B<access>(2), except for the differences described in this manual page."
124 #: build/C/man2/faccessat.2:72
126 "If the pathname given in I<pathname> is relative, then it is interpreted "
127 "relative to the directory referred to by the file descriptor I<dirfd> "
128 "(rather than relative to the current working directory of the calling "
129 "process, as is done by B<access>(2) for a relative pathname)."
133 #: build/C/man2/faccessat.2:84
135 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
136 "then I<pathname> is interpreted relative to the current working directory of "
137 "the calling process (like B<access>(2))."
141 #: build/C/man2/faccessat.2:90 build/C/man2/fchmodat.2:90 build/C/man2/fchownat.2:90 build/C/man2/fstatat.2:90 build/C/man2/futimesat.2:84 build/C/man2/mkdirat.2:88 build/C/man3/mkfifoat.3:89 build/C/man2/mknodat.2:92 build/C/man2/openat.2:89 build/C/man2/readlinkat.2:90
142 msgid "If I<pathname> is absolute, then I<dirfd> is ignored."
146 #: build/C/man2/faccessat.2:93
148 "I<flags> is constructed by ORing together zero or more of the following "
153 #: build/C/man2/faccessat.2:93
155 msgid "B<AT_EACCESS>"
159 #: build/C/man2/faccessat.2:100
161 "Perform access checks using the effective user and group IDs. By default, "
162 "B<faccessat>() uses the real IDs (like B<access>(2))."
166 #: build/C/man2/faccessat.2:100 build/C/man2/fchmodat.2:93 build/C/man2/fchownat.2:93 build/C/man2/fstatat.2:105
168 msgid "B<AT_SYMLINK_NOFOLLOW>"
172 #: build/C/man2/faccessat.2:106
174 "If I<pathname> is a symbolic link, do not dereference it: instead return "
175 "information about the link itself."
179 #: build/C/man2/faccessat.2:106 build/C/man2/fchmodat.2:100 build/C/man2/fchownat.2:104 build/C/man2/fstatat.2:116 build/C/man2/futimesat.2:84 build/C/man2/linkat.2:116 build/C/man2/mkdirat.2:88 build/C/man3/mkfifoat.3:89 build/C/man2/mknodat.2:92 build/C/man2/openat.2:89 build/C/man2/readlinkat.2:90 build/C/man2/renameat.2:97 build/C/man2/symlinkat.2:89 build/C/man2/unlinkat.2:120
185 #: build/C/man2/faccessat.2:113
187 "On success, (all requested permissions granted) B<faccessat>() returns 0. "
188 "On error, -1 is returned and I<errno> is set to indicate the error."
192 #: build/C/man2/faccessat.2:113 build/C/man2/fchmodat.2:107 build/C/man2/fchownat.2:111 build/C/man2/fstatat.2:123 build/C/man2/futimesat.2:91 build/C/man2/linkat.2:123 build/C/man2/mkdirat.2:95 build/C/man3/mkfifoat.3:96 build/C/man2/mknodat.2:99 build/C/man2/openat.2:96 build/C/man2/readlinkat.2:98 build/C/man2/renameat.2:104 build/C/man2/symlinkat.2:96 build/C/man2/unlinkat.2:127
198 #: build/C/man2/faccessat.2:120
200 "The same errors that occur for B<access>(2) can also occur for "
201 "B<faccessat>(). The following additional errors can occur for "
206 #: build/C/man2/faccessat.2:120 build/C/man2/fchmodat.2:114 build/C/man2/fchownat.2:118 build/C/man2/fstatat.2:130 build/C/man2/futimesat.2:98 build/C/man2/linkat.2:130 build/C/man2/mkdirat.2:102 build/C/man3/mkfifoat.3:103 build/C/man2/mknodat.2:106 build/C/man2/openat.2:103 build/C/man2/readlinkat.2:105 build/C/man2/renameat.2:111 build/C/man2/symlinkat.2:103 build/C/man2/unlinkat.2:136
212 #: build/C/man2/faccessat.2:124 build/C/man2/fchmodat.2:118 build/C/man2/fchownat.2:122 build/C/man2/fstatat.2:134 build/C/man2/futimesat.2:102 build/C/man2/mkdirat.2:106 build/C/man3/mkfifoat.3:107 build/C/man2/mknodat.2:110 build/C/man2/openat.2:107 build/C/man2/readlinkat.2:109 build/C/man2/unlinkat.2:140
213 msgid "I<dirfd> is not a valid file descriptor."
217 #: build/C/man2/faccessat.2:124 build/C/man2/fchmodat.2:118 build/C/man2/fchownat.2:122 build/C/man2/fstatat.2:134 build/C/man2/unlinkat.2:140
223 #: build/C/man2/faccessat.2:128 build/C/man2/fchmodat.2:122 build/C/man2/fchownat.2:126 build/C/man2/fstatat.2:138
224 msgid "Invalid flag specified in I<flags>."
228 #: build/C/man2/faccessat.2:128 build/C/man2/fchmodat.2:122 build/C/man2/fchownat.2:126 build/C/man2/fstatat.2:138 build/C/man2/futimesat.2:102 build/C/man2/linkat.2:136 build/C/man2/mkdirat.2:106 build/C/man3/mkfifoat.3:107 build/C/man2/mknodat.2:110 build/C/man2/openat.2:107 build/C/man2/readlinkat.2:109 build/C/man2/renameat.2:117 build/C/man2/symlinkat.2:107 build/C/man2/unlinkat.2:144
234 #: build/C/man2/faccessat.2:134 build/C/man2/fchmodat.2:128 build/C/man2/fchownat.2:132 build/C/man2/fstatat.2:144 build/C/man2/futimesat.2:108 build/C/man2/mkdirat.2:112 build/C/man2/mknodat.2:116 build/C/man2/openat.2:113 build/C/man2/readlinkat.2:115 build/C/man2/unlinkat.2:150
236 "I<pathname> is relative and I<dirfd> is a file descriptor referring to a "
237 "file other than a directory."
241 #: build/C/man2/faccessat.2:134 build/C/man2/fchmodat.2:134 build/C/man2/fchownat.2:132 build/C/man2/fstatat.2:144 build/C/man2/futimesat.2:108 build/C/man2/linkat.2:146 build/C/man2/mkdirat.2:112 build/C/man3/mkfifoat.3:113 build/C/man2/mknodat.2:116 build/C/man2/openat.2:113 build/C/man2/readlinkat.2:115 build/C/man2/renameat.2:127 build/C/man2/symlinkat.2:113 build/C/man2/unlinkat.2:150
247 #: build/C/man2/faccessat.2:138
249 "B<faccessat>() was added to Linux in kernel 2.6.16; library support was "
250 "added to glibc in version 2.4."
254 #: build/C/man2/faccessat.2:138 build/C/man2/fchmodat.2:138 build/C/man2/fchownat.2:136 build/C/man2/fstatat.2:148 build/C/man2/futimesat.2:112 build/C/man2/linkat.2:150 build/C/man2/mkdirat.2:116 build/C/man3/mkfifoat.3:119 build/C/man2/mknodat.2:120 build/C/man2/openat.2:117 build/C/man2/readlinkat.2:119 build/C/man2/renameat.2:131 build/C/man2/symlinkat.2:117 build/C/man2/unlinkat.2:154
256 msgid "CONFORMING TO"
260 #: build/C/man2/faccessat.2:140 build/C/man2/fchmodat.2:140 build/C/man2/linkat.2:152 build/C/man2/mkdirat.2:118 build/C/man3/mkfifoat.3:121 build/C/man2/mknodat.2:122 build/C/man2/readlinkat.2:121 build/C/man2/renameat.2:133 build/C/man2/symlinkat.2:119
261 msgid "POSIX.1-2008."
265 #: build/C/man2/faccessat.2:140 build/C/man2/fchmodat.2:140 build/C/man2/fchownat.2:139 build/C/man2/fstatat.2:151 build/C/man2/futimesat.2:119 build/C/man2/linkat.2:152 build/C/man2/mkdirat.2:118 build/C/man3/mkfifoat.3:121 build/C/man2/mknodat.2:122 build/C/man2/openat.2:132 build/C/man2/readlinkat.2:121 build/C/man2/renameat.2:133 build/C/man2/symlinkat.2:119 build/C/man2/unlinkat.2:157
271 #: build/C/man2/faccessat.2:145
272 msgid "See B<openat>(2) for an explanation of the need for B<faccessat>()."
276 #: build/C/man2/faccessat.2:152
278 "I<Warning>: B<faccessat>() is subject to the same kinds of races as "
279 "B<access>(2) and B<euidaccess>(3)."
283 #: build/C/man2/faccessat.2:152 build/C/man2/futimesat.2:120
289 #: build/C/man2/faccessat.2:162
291 "The B<AT_EACCESS> and B<AT_SYMLINK_NOFOLLOW> flags are actually implemented "
292 "within the glibc wrapper function for B<faccessat>(). If either of these "
293 "flags are specified, then the wrapper function employs B<fstatat>(2) to "
294 "determine access permissions."
298 #: build/C/man2/faccessat.2:162 build/C/man2/fchmodat.2:153 build/C/man2/fchownat.2:144 build/C/man2/fstatat.2:161 build/C/man2/futimesat.2:128 build/C/man2/linkat.2:157 build/C/man2/mkdirat.2:123 build/C/man3/mkfifoat.3:126 build/C/man2/mknodat.2:127 build/C/man2/openat.2:163 build/C/man2/readlinkat.2:126 build/C/man2/renameat.2:138 build/C/man2/symlinkat.2:124 build/C/man2/unlinkat.2:162
304 #: build/C/man2/faccessat.2:169
306 "B<access>(2), B<openat>(2), B<euidaccess>(3), B<credentials>(7), "
307 "B<path_resolution>(7), B<symlink>(7)"
311 #: build/C/man2/faccessat.2:169 build/C/man2/fchmodat.2:158 build/C/man2/fchownat.2:149 build/C/man2/fstatat.2:166 build/C/man2/futimesat.2:134 build/C/man2/linkat.2:162 build/C/man2/mkdirat.2:127 build/C/man3/mkfifoat.3:130 build/C/man2/mknodat.2:131 build/C/man2/openat.2:180 build/C/man2/readlinkat.2:130 build/C/man2/renameat.2:142 build/C/man2/symlinkat.2:129 build/C/man2/unlinkat.2:167
317 #: build/C/man2/faccessat.2:176 build/C/man2/fchmodat.2:165 build/C/man2/fchownat.2:156 build/C/man2/fstatat.2:173 build/C/man2/futimesat.2:141 build/C/man2/linkat.2:169 build/C/man2/mkdirat.2:134 build/C/man3/mkfifoat.3:137 build/C/man2/mknodat.2:138 build/C/man2/openat.2:187 build/C/man2/readlinkat.2:137 build/C/man2/renameat.2:149 build/C/man2/symlinkat.2:136 build/C/man2/unlinkat.2:174
319 "This page is part of release 3.50 of the Linux I<man-pages> project. A "
320 "description of the project, and information about reporting bugs, can be "
321 "found at http://www.kernel.org/doc/man-pages/."
325 #: build/C/man2/fchmodat.2:25
331 #: build/C/man2/fchmodat.2:25
337 #: build/C/man2/fchmodat.2:29
339 "fchmodat - change permissions of a file relative to a directory file "
344 #: build/C/man2/fchmodat.2:33
347 "B<#include E<lt>fcntl.hE<gt>> /* Definition of AT_* constants */\n"
348 "B<#include E<lt>sys/stat.hE<gt>>\n"
352 #: build/C/man2/fchmodat.2:36
355 "B<int fchmodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
356 ">I<mode>B<, int >I<flags>B<);>\n"
360 #: build/C/man2/fchmodat.2:44
361 msgid "B<fchmodat>():"
365 #: build/C/man2/fchmodat.2:62
367 "The B<fchmodat>() system call operates in exactly the same way as "
368 "B<chmod>(2), except for the differences described in this manual page."
372 #: build/C/man2/fchmodat.2:72
374 "If the pathname given in I<pathname> is relative, then it is interpreted "
375 "relative to the directory referred to by the file descriptor I<dirfd> "
376 "(rather than relative to the current working directory of the calling "
377 "process, as is done by B<chmod>(2) for a relative pathname)."
381 #: build/C/man2/fchmodat.2:84
383 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
384 "then I<pathname> is interpreted relative to the current working directory of "
385 "the calling process (like B<chmod>(2))."
389 #: build/C/man2/fchmodat.2:93 build/C/man2/fchownat.2:93
390 msgid "I<flags> can either be 0, or include the following flag:"
394 #: build/C/man2/fchmodat.2:100
396 "If I<pathname> is a symbolic link, do not dereference it: instead operate on "
397 "the link itself. This flag is not currently implemented."
401 #: build/C/man2/fchmodat.2:107
403 "On success, B<fchmodat>() returns 0. On error, -1 is returned and I<errno> "
404 "is set to indicate the error."
408 #: build/C/man2/fchmodat.2:114
410 "The same errors that occur for B<chmod>(2) can also occur for "
411 "B<fchmodat>(). The following additional errors can occur for B<fchmodat>():"
415 #: build/C/man2/fchmodat.2:128
421 #: build/C/man2/fchmodat.2:134
422 msgid "I<flags> specified B<AT_SYMLINK_NOFOLLOW>, which is not supported."
426 #: build/C/man2/fchmodat.2:138
428 "B<fchmodat>() was added to Linux in kernel 2.6.16; library support was "
429 "added to glibc in version 2.4."
433 #: build/C/man2/fchmodat.2:145
434 msgid "See B<openat>(2) for an explanation of the need for B<fchmodat>()."
438 #: build/C/man2/fchmodat.2:153
440 "The GNU C library wrapper function implements the POSIX-specified interface "
441 "described in this page. This interface differs from the underlying Linux "
442 "system call, which does I<not> have a I<flags> argument."
446 #: build/C/man2/fchmodat.2:158
447 msgid "B<chmod>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
451 #: build/C/man2/fchownat.2:25
457 #: build/C/man2/fchownat.2:29
459 "fchownat - change ownership of a file relative to a directory file "
464 #: build/C/man2/fchownat.2:36
467 "B<int fchownat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
468 "B< uid_t >I<owner>B<, gid_t >I<group>B<, int >I<flags>B<);>\n"
472 #: build/C/man2/fchownat.2:44
473 msgid "B<fchownat>():"
477 #: build/C/man2/fchownat.2:62
479 "The B<fchownat>() system call operates in exactly the same way as "
480 "B<chown>(2), except for the differences described in this manual page."
484 #: build/C/man2/fchownat.2:72
486 "If the pathname given in I<pathname> is relative, then it is interpreted "
487 "relative to the directory referred to by the file descriptor I<dirfd> "
488 "(rather than relative to the current working directory of the calling "
489 "process, as is done by B<chown>(2) for a relative pathname)."
493 #: build/C/man2/fchownat.2:84
495 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
496 "then I<pathname> is interpreted relative to the current working directory of "
497 "the calling process (like B<chown>(2))."
501 #: build/C/man2/fchownat.2:104
503 "If I<pathname> is a symbolic link, do not dereference it: instead operate on "
504 "the link itself, like B<lchown>(2). (By default, B<fchownat>() "
505 "dereferences symbolic links, like B<chown>(2).)"
509 #: build/C/man2/fchownat.2:111
511 "On success, B<fchownat>() returns 0. On error, -1 is returned and I<errno> "
512 "is set to indicate the error."
516 #: build/C/man2/fchownat.2:118
518 "The same errors that occur for B<chown>(2) can also occur for "
519 "B<fchownat>(). The following additional errors can occur for B<fchownat>():"
523 #: build/C/man2/fchownat.2:136
525 "B<fchownat>() was added to Linux in kernel 2.6.16; library support was "
526 "added to glibc in version 2.4."
530 #: build/C/man2/fchownat.2:139 build/C/man2/fstatat.2:151 build/C/man2/openat.2:132 build/C/man2/unlinkat.2:157
531 msgid "POSIX.1-2008. A similar system call exists on Solaris."
535 #: build/C/man2/fchownat.2:144
536 msgid "See B<openat>(2) for an explanation of the need for B<fchownat>()."
540 #: build/C/man2/fchownat.2:149
541 msgid "B<chown>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
545 #: build/C/man2/fstatat.2:25
551 #: build/C/man2/fstatat.2:28
552 msgid "fstatat - get file status relative to a directory file descriptor"
556 #: build/C/man2/fstatat.2:32 build/C/man2/mkdirat.2:32 build/C/man3/mkfifoat.3:33 build/C/man2/mknodat.2:33
559 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
560 "B<#include E<lt>sys/stat.hE<gt>>\n"
564 #: build/C/man2/fstatat.2:36
567 "B<int fstatat(int >I<dirfd>B<, const char *>I<pathname>B<, struct stat "
569 "B< int >I<flags>B<);>\n"
573 #: build/C/man2/fstatat.2:44
574 msgid "B<fstatat>():"
578 #: build/C/man2/fstatat.2:62
580 "The B<fstatat>() system call operates in exactly the same way as "
581 "B<stat>(2), except for the differences described in this manual page."
585 #: build/C/man2/fstatat.2:72
587 "If the pathname given in I<pathname> is relative, then it is interpreted "
588 "relative to the directory referred to by the file descriptor I<dirfd> "
589 "(rather than relative to the current working directory of the calling "
590 "process, as is done by B<stat>(2) for a relative pathname)."
594 #: build/C/man2/fstatat.2:84
596 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
597 "then I<pathname> is interpreted relative to the current working directory of "
598 "the calling process (like B<stat>(2))."
602 #: build/C/man2/fstatat.2:93
604 "I<flags> can either be 0, or include one or more of the following flags "
609 #: build/C/man2/fstatat.2:93
611 msgid "B<AT_NO_AUTOMOUNT> (since Linux 2.6.38)"
615 #: build/C/man2/fstatat.2:105
617 "Don't automount the terminal (\"basename\") component of I<pathname> if it "
618 "is a directory that is an automount point. This allows the caller to gather "
619 "attributes of an automount point (rather than the location it would mount). "
620 "This flag can be used in tools that scan directories to prevent "
621 "mass-automounting of a directory of automount points. The "
622 "B<AT_NO_AUTOMOUNT> flag has no effect if the mount point has already been "
627 #: build/C/man2/fstatat.2:116
629 "If I<pathname> is a symbolic link, do not dereference it: instead return "
630 "information about the link itself, like B<lstat>(2). (By default, "
631 "B<fstatat>() dereferences symbolic links, like B<stat>(2).)"
635 #: build/C/man2/fstatat.2:123
637 "On success, B<fstatat>() returns 0. On error, -1 is returned and I<errno> "
638 "is set to indicate the error."
642 #: build/C/man2/fstatat.2:130
644 "The same errors that occur for B<stat>(2) can also occur for B<fstatat>(). "
645 "The following additional errors can occur for B<fstatat>():"
649 #: build/C/man2/fstatat.2:148
651 "B<fstatat>() was added to Linux in kernel 2.6.16; library support was added "
652 "to glibc in version 2.4."
656 #: build/C/man2/fstatat.2:156
657 msgid "See B<openat>(2) for an explanation of the need for B<fstatat>()."
661 #: build/C/man2/fstatat.2:161
663 "The underlying system call employed by the glibc B<fstatat>() wrapper "
664 "function is actually called B<fstatat64>()."
668 #: build/C/man2/fstatat.2:166
669 msgid "B<openat>(2), B<stat>(2), B<path_resolution>(7), B<symlink>(7)"
673 #: build/C/man2/futimesat.2:25
679 #: build/C/man2/futimesat.2:25
685 #: build/C/man2/futimesat.2:29
687 "futimesat - change timestamps of a file relative to a directory file "
692 #: build/C/man2/futimesat.2:33
695 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
696 "B<#include E<lt>sys/time.hE<gt>>\n"
700 #: build/C/man2/futimesat.2:36
703 "B<int futimesat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
704 "B< const struct timeval >I<times>B<[2]);>\n"
708 #: build/C/man2/futimesat.2:45
709 msgid "B<futimesat>(): _GNU_SOURCE"
713 #: build/C/man2/futimesat.2:50
714 msgid "This system call is obsolete. Use B<utimensat>(2) instead."
718 #: build/C/man2/futimesat.2:56
720 "The B<futimesat>() system call operates in exactly the same way as "
721 "B<utimes>(2), except for the differences described in this manual page."
725 #: build/C/man2/futimesat.2:66
727 "If the pathname given in I<pathname> is relative, then it is interpreted "
728 "relative to the directory referred to by the file descriptor I<dirfd> "
729 "(rather than relative to the current working directory of the calling "
730 "process, as is done by B<utimes>(2) for a relative pathname)."
734 #: build/C/man2/futimesat.2:78
736 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
737 "then I<pathname> is interpreted relative to the current working directory of "
738 "the calling process (like B<utimes>(2))."
742 #: build/C/man2/futimesat.2:91
744 "On success, B<futimesat>() returns a 0. On error, -1 is returned and "
745 "I<errno> is set to indicate the error."
749 #: build/C/man2/futimesat.2:98
751 "The same errors that occur for B<utimes>(2) can also occur for "
752 "B<futimesat>(). The following additional errors can occur for "
757 #: build/C/man2/futimesat.2:112
759 "B<futimesat>() was added to Linux in kernel 2.6.16; library support was "
760 "added to glibc in version 2.4."
764 #: build/C/man2/futimesat.2:117
766 "This system call is nonstandard. It was implemented from a specification "
767 "that was proposed for POSIX.1, but that specification was replaced by the "
768 "one for B<utimensat>(2)."
772 #: build/C/man2/futimesat.2:119
773 msgid "A similar system call exists on Solaris."
776 #. The Solaris futimesat() also has this strangeness.
778 #: build/C/man2/futimesat.2:128
780 "If I<pathname> is NULL, then the glibc B<futimesat>() wrapper function "
781 "updates the times for the file referred to by I<dirfd>."
785 #: build/C/man2/futimesat.2:134
787 "B<stat>(2), B<utimensat>(2), B<utimes>(2), B<futimes>(3), "
788 "B<path_resolution>(7)"
792 #: build/C/man2/linkat.2:27
798 #: build/C/man2/linkat.2:30
799 msgid "linkat - create a file link relative to directory file descriptors"
803 #: build/C/man2/linkat.2:37
806 "B<int linkat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
807 "B< int >I<newdirfd>B<, const char *>I<newpath>B<, int "
812 #: build/C/man2/linkat.2:45
817 #: build/C/man2/linkat.2:63
819 "The B<linkat>() system call operates in exactly the same way as B<link>(2), "
820 "except for the differences described in this manual page."
824 #: build/C/man2/linkat.2:73
826 "If the pathname given in I<oldpath> is relative, then it is interpreted "
827 "relative to the directory referred to by the file descriptor I<olddirfd> "
828 "(rather than relative to the current working directory of the calling "
829 "process, as is done by B<link>(2) for a relative pathname)."
833 #: build/C/man2/linkat.2:85
835 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
836 "then I<oldpath> is interpreted relative to the current working directory of "
837 "the calling process (like B<link>(2))."
841 #: build/C/man2/linkat.2:91 build/C/man2/renameat.2:89
842 msgid "If I<oldpath> is absolute, then I<olddirfd> is ignored."
846 #: build/C/man2/linkat.2:99 build/C/man2/renameat.2:97
848 "The interpretation of I<newpath> is as for I<oldpath>, except that a "
849 "relative pathname is interpreted relative to the directory referred to by "
850 "the file descriptor I<newdirfd>."
854 #: build/C/man2/linkat.2:116
856 "By default, B<linkat>(), does not dereference I<oldpath> if it is a symbolic "
857 "link (like B<link>(2)). Since Linux 2.6.18, the flag B<AT_SYMLINK_FOLLOW> "
858 "can be specified in I<flags> to cause I<oldpath> to be dereferenced if it is "
859 "a symbolic link. Before kernel 2.6.18, the I<flags> argument was unused, "
860 "and had to be specified as 0."
864 #: build/C/man2/linkat.2:123
866 "On success, B<linkat>() returns 0. On error, -1 is returned and I<errno> "
867 "is set to indicate the error."
871 #: build/C/man2/linkat.2:130
873 "The same errors that occur for B<link>(2) can also occur for B<linkat>(). "
874 "The following additional errors can occur for B<linkat>():"
878 #: build/C/man2/linkat.2:136 build/C/man2/renameat.2:117
879 msgid "I<olddirfd> or I<newdirfd> is not a valid file descriptor."
883 #: build/C/man2/linkat.2:146 build/C/man2/renameat.2:127
885 "I<oldpath> is relative and I<olddirfd> is a file descriptor referring to a "
886 "file other than a directory; or similar for I<newpath> and I<newdirfd>"
890 #: build/C/man2/linkat.2:150
892 "B<linkat>() was added to Linux in kernel 2.6.16; library support was added "
893 "to glibc in version 2.4."
897 #: build/C/man2/linkat.2:157
898 msgid "See B<openat>(2) for an explanation of the need for B<linkat>()."
902 #: build/C/man2/linkat.2:162
903 msgid "B<link>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
907 #: build/C/man2/mkdirat.2:25
913 #: build/C/man2/mkdirat.2:28
914 msgid "mkdirat - create a directory relative to a directory file descriptor"
918 #: build/C/man2/mkdirat.2:34
921 "B<int mkdirat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
926 #: build/C/man2/mkdirat.2:42
927 msgid "B<mkdirat>():"
931 #: build/C/man2/mkdirat.2:60
933 "The B<mkdirat>() system call operates in exactly the same way as "
934 "B<mkdir>(2), except for the differences described in this manual page."
938 #: build/C/man2/mkdirat.2:70
940 "If the pathname given in I<pathname> is relative, then it is interpreted "
941 "relative to the directory referred to by the file descriptor I<dirfd> "
942 "(rather than relative to the current working directory of the calling "
943 "process, as is done by B<mkdir>(2) for a relative pathname)."
947 #: build/C/man2/mkdirat.2:82
949 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
950 "then I<pathname> is interpreted relative to the current working directory of "
951 "the calling process (like B<mkdir>(2))."
955 #: build/C/man2/mkdirat.2:95
957 "On success, B<mkdirat>() returns 0. On error, -1 is returned and I<errno> "
958 "is set to indicate the error."
962 #: build/C/man2/mkdirat.2:102
964 "The same errors that occur for B<mkdir>(2) can also occur for "
965 "B<mkdirat>(). The following additional errors can occur for B<mkdirat>():"
969 #: build/C/man2/mkdirat.2:116
971 "B<mkdirat>() was added to Linux in kernel 2.6.16; library support was added "
972 "to glibc in version 2.4."
976 #: build/C/man2/mkdirat.2:123
977 msgid "See B<openat>(2) for an explanation of the need for B<mkdirat>()."
981 #: build/C/man2/mkdirat.2:127
982 msgid "B<mkdir>(2), B<openat>(2), B<path_resolution>(7)"
986 #: build/C/man3/mkfifoat.3:26
992 #: build/C/man3/mkfifoat.3:26
998 #: build/C/man3/mkfifoat.3:29
999 msgid "mkfifoat - make a FIFO (named pipe) relative to a directory file descriptor"
1003 #: build/C/man3/mkfifoat.3:35
1006 "B<int mkfifoat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
1011 #: build/C/man3/mkfifoat.3:43
1012 msgid "B<mkfifoat>():"
1016 #: build/C/man3/mkfifoat.3:61
1018 "The B<mkfifoat>() system call operates in exactly the same way as "
1019 "B<mkfifo>(3), except for the differences described in this manual page."
1023 #: build/C/man3/mkfifoat.3:71
1025 "If the pathname given in I<pathname> is relative, then it is interpreted "
1026 "relative to the directory referred to by the file descriptor I<dirfd> "
1027 "(rather than relative to the current working directory of the calling "
1028 "process, as is done by B<mkfifo>(3) for a relative pathname)."
1032 #: build/C/man3/mkfifoat.3:83
1034 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1035 "then I<pathname> is interpreted relative to the current working directory of "
1036 "the calling process (like B<mkfifo>(3))."
1040 #: build/C/man3/mkfifoat.3:96
1042 "On success, B<mkfifoat>() returns 0. On error, -1 is returned and I<errno> "
1043 "is set to indicate the error."
1047 #: build/C/man3/mkfifoat.3:103
1049 "The same errors that occur for B<mkfifo>(3) can also occur for "
1050 "B<mkfifoat>(). The following additional errors can occur for B<mkfifoat>():"
1054 #: build/C/man3/mkfifoat.3:113
1056 "I<pathname> is a relative path and I<dirfd> is a file descriptor referring "
1057 "to a file other than a directory."
1061 #: build/C/man3/mkfifoat.3:119
1063 "B<mkfifoat>() was added to glibc in version 2.4. It is implemented using "
1064 "B<mknod>(2), available on Linux since kernel 2.6.16."
1068 #: build/C/man3/mkfifoat.3:126
1069 msgid "See B<openat>(2) for an explanation of the need for B<mkfifoat>()."
1073 #: build/C/man3/mkfifoat.3:130
1074 msgid "B<openat>(2), B<mkfifo>(3), B<path_resolution>(7)"
1078 #: build/C/man2/mknodat.2:25
1084 #: build/C/man2/mknodat.2:29
1086 "mknodat - create a special or ordinary file relative to a directory file "
1091 #: build/C/man2/mknodat.2:36
1094 "B<int mknodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
1095 ">I<mode>B<, dev_t >I<dev>B<);>\n"
1099 #: build/C/man2/mknodat.2:44
1100 msgid "B<mknodat>():"
1103 #. Other FTM combinations will also expose mknodat(), but this function was
1104 #. added in SUSv4, marked XSI, so we'll just document what the standard says.
1106 #: build/C/man2/mknodat.2:52
1108 msgid " _XOPEN_SOURCE\\ E<gt>=\\ 700\n"
1112 #: build/C/man2/mknodat.2:64
1114 "The B<mknodat>() system call operates in exactly the same way as "
1115 "B<mknod>(2), except for the differences described in this manual page."
1119 #: build/C/man2/mknodat.2:74
1121 "If the pathname given in I<pathname> is relative, then it is interpreted "
1122 "relative to the directory referred to by the file descriptor I<dirfd> "
1123 "(rather than relative to the current working directory of the calling "
1124 "process, as is done by B<mknod>(2) for a relative pathname)."
1128 #: build/C/man2/mknodat.2:86
1130 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1131 "then I<pathname> is interpreted relative to the current working directory of "
1132 "the calling process (like B<mknod>(2))."
1136 #: build/C/man2/mknodat.2:99
1138 "On success, B<mknodat>() returns 0. On error, -1 is returned and I<errno> "
1139 "is set to indicate the error."
1143 #: build/C/man2/mknodat.2:106
1145 "The same errors that occur for B<mknod>(2) can also occur for "
1146 "B<mknodat>(). The following additional errors can occur for B<mknodat>():"
1150 #: build/C/man2/mknodat.2:120
1152 "B<mknodat>() was added to Linux in kernel 2.6.16; library support was added "
1153 "to glibc in version 2.4."
1157 #: build/C/man2/mknodat.2:127
1158 msgid "See B<openat>(2) for an explanation of the need for B<mknodat>()."
1162 #: build/C/man2/mknodat.2:131
1163 msgid "B<mknod>(2), B<openat>(2), B<path_resolution>(7)"
1167 #: build/C/man2/openat.2:25
1173 #: build/C/man2/openat.2:28
1174 msgid "openat - open a file relative to a directory file descriptor"
1178 #: build/C/man2/openat.2:31
1180 msgid "B<#include E<lt>fcntl.hE<gt>>\n"
1184 #: build/C/man2/openat.2:35
1187 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1189 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int >I<flags>B<, "
1190 "mode_t >I<mode>B<);>\n"
1194 #: build/C/man2/openat.2:43
1195 msgid "B<openat>():"
1199 #: build/C/man2/openat.2:61
1201 "The B<openat>() system call operates in exactly the same way as B<open>(2), "
1202 "except for the differences described in this manual page."
1206 #: build/C/man2/openat.2:71
1208 "If the pathname given in I<pathname> is relative, then it is interpreted "
1209 "relative to the directory referred to by the file descriptor I<dirfd> "
1210 "(rather than relative to the current working directory of the calling "
1211 "process, as is done by B<open>(2) for a relative pathname)."
1215 #: build/C/man2/openat.2:83
1217 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1218 "then I<pathname> is interpreted relative to the current working directory of "
1219 "the calling process (like B<open>(2))."
1223 #: build/C/man2/openat.2:96
1225 "On success, B<openat>() returns a new file descriptor. On error, -1 is "
1226 "returned and I<errno> is set to indicate the error."
1230 #: build/C/man2/openat.2:103
1232 "The same errors that occur for B<open>(2) can also occur for B<openat>(). "
1233 "The following additional errors can occur for B<openat>():"
1237 #: build/C/man2/openat.2:117
1239 "B<openat>() was added to Linux in kernel 2.6.16; library support was added "
1240 "to glibc in version 2.4."
1244 #: build/C/man2/openat.2:136
1246 "B<openat>() and other similar system calls suffixed \"at\" are supported "
1251 #: build/C/man2/openat.2:154
1253 "First, B<openat>() allows an application to avoid race conditions that "
1254 "could occur when using B<open>(2) to open files in directories other than "
1255 "the current working directory. These race conditions result from the fact "
1256 "that some component of the directory prefix given to B<open>(2) could be "
1257 "changed in parallel with the call to B<open>(2). Such races can be avoided "
1258 "by opening a file descriptor for the target directory, and then specifying "
1259 "that file descriptor as the I<dirfd> argument of B<openat>()."
1263 #: build/C/man2/openat.2:163
1265 "Second, B<openat>() allows the implementation of a per-thread \"current "
1266 "working directory\", via file descriptor(s) maintained by the application. "
1267 "(This functionality can also be obtained by tricks based on the use of "
1268 "I</proc/self/fd/>dirfd, but less efficiently.)"
1272 #: build/C/man2/openat.2:180
1274 "B<faccessat>(2), B<fchmodat>(2), B<fchownat>(2), B<fstatat>(2), "
1275 "B<futimesat>(2), B<linkat>(2), B<mkdirat>(2), B<mknodat>(2), B<open>(2), "
1276 "B<readlinkat>(2), B<renameat>(2), B<symlinkat>(2), B<unlinkat>(2), "
1277 "B<utimensat>(2), B<mkfifoat>(3), B<path_resolution>(7)"
1281 #: build/C/man2/readlinkat.2:25
1287 #: build/C/man2/readlinkat.2:29
1289 "readlinkat - read value of a symbolic link relative to a directory file "
1294 #: build/C/man2/readlinkat.2:36
1297 "B<int readlinkat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
1298 "B< char *>I<buf>B<, size_t >I<bufsiz>B<);>\n"
1302 #: build/C/man2/readlinkat.2:44
1303 msgid "B<readlinkat>():"
1307 #: build/C/man2/readlinkat.2:62
1309 "The B<readlinkat>() system call operates in exactly the same way as "
1310 "B<readlink>(2), except for the differences described in this manual page."
1314 #: build/C/man2/readlinkat.2:72
1316 "If the pathname given in I<pathname> is relative, then it is interpreted "
1317 "relative to the directory referred to by the file descriptor I<dirfd> "
1318 "(rather than relative to the current working directory of the calling "
1319 "process, as is done by B<readlink>(2) for a relative pathname)."
1323 #: build/C/man2/readlinkat.2:84
1325 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1326 "then I<pathname> is interpreted relative to the current working directory of "
1327 "the calling process (like B<readlink>(2))."
1331 #: build/C/man2/readlinkat.2:98
1333 "On success, B<readlinkat>() returns the number of bytes placed in I<buf>. "
1334 "On error, -1 is returned and I<errno> is set to indicate the error."
1338 #: build/C/man2/readlinkat.2:105
1340 "The same errors that occur for B<readlink>(2) can also occur for "
1341 "B<readlinkat>(). The following additional errors can occur for "
1346 #: build/C/man2/readlinkat.2:119
1348 "B<readlinkat>() was added to Linux in kernel 2.6.16; library support was "
1349 "added to glibc in version 2.4."
1353 #: build/C/man2/readlinkat.2:126
1354 msgid "See B<openat>(2) for an explanation of the need for B<readlinkat>()."
1358 #: build/C/man2/readlinkat.2:130
1359 msgid "B<openat>(2), B<readlink>(2), B<path_resolution>(7)"
1363 #: build/C/man2/renameat.2:25
1369 #: build/C/man2/renameat.2:28
1370 msgid "renameat - rename a file relative to directory file descriptors"
1374 #: build/C/man2/renameat.2:32
1377 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
1378 "B<#include E<lt>stdio.hE<gt>>\n"
1382 #: build/C/man2/renameat.2:35
1385 "B<int renameat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
1386 "B< int >I<newdirfd>B<, const char *>I<newpath>B<);>\n"
1390 #: build/C/man2/renameat.2:43
1391 msgid "B<renameat>():"
1395 #: build/C/man2/renameat.2:61
1397 "The B<renameat>() system call operates in exactly the same way as "
1398 "B<rename>(2), except for the differences described in this manual page."
1402 #: build/C/man2/renameat.2:71
1404 "If the pathname given in I<oldpath> is relative, then it is interpreted "
1405 "relative to the directory referred to by the file descriptor I<olddirfd> "
1406 "(rather than relative to the current working directory of the calling "
1407 "process, as is done by B<rename>(2) for a relative pathname)."
1411 #: build/C/man2/renameat.2:83
1413 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
1414 "then I<oldpath> is interpreted relative to the current working directory of "
1415 "the calling process (like B<rename>(2))."
1419 #: build/C/man2/renameat.2:104
1421 "On success, B<renameat>() returns 0. On error, -1 is returned and I<errno> "
1422 "is set to indicate the error."
1426 #: build/C/man2/renameat.2:111
1428 "The same errors that occur for B<rename>(2) can also occur for "
1429 "B<renameat>(). The following additional errors can occur for B<renameat>():"
1433 #: build/C/man2/renameat.2:131
1435 "B<renameat>() was added to Linux in kernel 2.6.16; library support was "
1436 "added to glibc in version 2.4."
1440 #: build/C/man2/renameat.2:138
1441 msgid "See B<openat>(2) for an explanation of the need for B<renameat>()."
1445 #: build/C/man2/renameat.2:142
1446 msgid "B<openat>(2), B<rename>(2), B<path_resolution>(7)"
1450 #: build/C/man2/symlinkat.2:25
1456 #: build/C/man2/symlinkat.2:28
1457 msgid "symlinkat - create a symbolic link relative to a directory file descriptor"
1461 #: build/C/man2/symlinkat.2:35
1464 "B<int symlinkat(const char *>I<oldpath>B<, int >I<newdirfd>B<, const char "
1465 "*>I<newpath>B<);>\n"
1469 #: build/C/man2/symlinkat.2:43
1470 msgid "B<symlinkat>():"
1474 #: build/C/man2/symlinkat.2:61
1476 "The B<symlinkat>() system call operates in exactly the same way as "
1477 "B<symlink>(2), except for the differences described in this manual page."
1481 #: build/C/man2/symlinkat.2:71
1483 "If the pathname given in I<newpath> is relative, then it is interpreted "
1484 "relative to the directory referred to by the file descriptor I<newdirfd> "
1485 "(rather than relative to the current working directory of the calling "
1486 "process, as is done by B<symlink>(2) for a relative pathname)."
1490 #: build/C/man2/symlinkat.2:83
1492 "If I<newpath> is relative and I<newdirfd> is the special value B<AT_FDCWD>, "
1493 "then I<newpath> is interpreted relative to the current working directory of "
1494 "the calling process (like B<symlink>(2))."
1498 #: build/C/man2/symlinkat.2:89
1499 msgid "If I<newpath> is absolute, then I<newdirfd> is ignored."
1503 #: build/C/man2/symlinkat.2:96
1505 "On success, B<symlinkat>() returns 0. On error, -1 is returned and "
1506 "I<errno> is set to indicate the error."
1510 #: build/C/man2/symlinkat.2:103
1512 "The same errors that occur for B<symlink>(2) can also occur for "
1513 "B<symlinkat>(). The following additional errors can occur for "
1518 #: build/C/man2/symlinkat.2:107
1519 msgid "I<newdirfd> is not a valid file descriptor."
1523 #: build/C/man2/symlinkat.2:113
1525 "I<newpath> is relative and I<newdirfd> is a file descriptor referring to a "
1526 "file other than a directory."
1530 #: build/C/man2/symlinkat.2:117
1532 "B<symlinkat>() was added to Linux in kernel 2.6.16; library support was "
1533 "added to glibc in version 2.4."
1537 #: build/C/man2/symlinkat.2:124
1538 msgid "See B<openat>(2) for an explanation of the need for B<symlinkat>()."
1542 #: build/C/man2/symlinkat.2:129
1543 msgid "B<openat>(2), B<symlink>(2), B<path_resolution>(7), B<symlink>(7)"
1547 #: build/C/man2/unlinkat.2:25
1553 #: build/C/man2/unlinkat.2:28
1554 msgid "unlinkat - remove a directory entry relative to a directory file descriptor"
1558 #: build/C/man2/unlinkat.2:34
1561 "B<int unlinkat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1566 #: build/C/man2/unlinkat.2:42
1567 msgid "B<unlinkat>():"
1571 #: build/C/man2/unlinkat.2:67
1573 "The B<unlinkat>() system call operates in exactly the same way as either "
1574 "B<unlink>(2) or B<rmdir>(2) (depending on whether or not I<flags> includes "
1575 "the B<AT_REMOVEDIR> flag) except for the differences described in this "
1580 #: build/C/man2/unlinkat.2:79
1582 "If the pathname given in I<pathname> is relative, then it is interpreted "
1583 "relative to the directory referred to by the file descriptor I<dirfd> "
1584 "(rather than relative to the current working directory of the calling "
1585 "process, as is done by B<unlink>(2) and B<rmdir>(2) for a relative "
1590 #: build/C/man2/unlinkat.2:93
1592 "If the pathname given in I<pathname> is relative and I<dirfd> is the special "
1593 "value B<AT_FDCWD>, then I<pathname> is interpreted relative to the current "
1594 "working directory of the calling process (like B<unlink>(2) and "
1599 #: build/C/man2/unlinkat.2:99
1600 msgid "If the pathname given in I<pathname> is absolute, then I<dirfd> is ignored."
1604 #: build/C/man2/unlinkat.2:105
1606 "I<flags> is a bit mask that can either be specified as 0, or by ORing "
1607 "together flag values that control the operation of B<unlinkat>(). Currently "
1608 "only one such flags is defined:"
1612 #: build/C/man2/unlinkat.2:105
1614 msgid "B<AT_REMOVEDIR>"
1618 #: build/C/man2/unlinkat.2:120
1620 "By default, B<unlinkat>() performs the equivalent of B<unlink>(2) on "
1621 "I<pathname>. If the B<AT_REMOVEDIR> flag is specified, then performs the "
1622 "equivalent of B<rmdir>(2) on I<pathname>."
1626 #: build/C/man2/unlinkat.2:127
1628 "On success, B<unlinkat>() returns 0. On error, -1 is returned and I<errno> "
1629 "is set to indicate the error."
1633 #: build/C/man2/unlinkat.2:136
1635 "The same errors that occur for B<unlink>(2) and B<rmdir>(2) can also occur "
1636 "for B<unlinkat>(). The following additional errors can occur for "
1641 #: build/C/man2/unlinkat.2:144
1642 msgid "An invalid flag value was specified in I<flags>."
1646 #: build/C/man2/unlinkat.2:154
1648 "B<unlinkat>() was added to Linux in kernel 2.6.16; library support was "
1649 "added to glibc in version 2.4."
1653 #: build/C/man2/unlinkat.2:162
1654 msgid "See B<openat>(2) for an explanation of the need for B<unlinkat>()."
1658 #: build/C/man2/unlinkat.2:167
1659 msgid "B<openat>(2), B<rmdir>(2), B<unlink>(2), B<path_resolution>(7)"