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: 2012-04-23 07:52+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:26
26 #: build/C/man2/faccessat.2:26
32 #: build/C/man2/faccessat.2:26 build/C/man2/fchmodat.2:26 build/C/man2/fchownat.2:26 build/C/man2/fstatat.2:25 build/C/man2/futimesat.2:26 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:26 build/C/man3/mkfifoat.3:26 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
38 #: build/C/man2/faccessat.2:26 build/C/man2/fchmodat.2:26 build/C/man2/fchownat.2:26 build/C/man2/fstatat.2:25 build/C/man2/futimesat.2:26 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:26 build/C/man3/mkfifoat.3:26 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
40 msgid "Linux Programmer's Manual"
44 #: build/C/man2/faccessat.2:27 build/C/man2/fchmodat.2:27 build/C/man2/fchownat.2:27 build/C/man2/fstatat.2:26 build/C/man2/futimesat.2:27 build/C/man2/linkat.2:28 build/C/man2/mkdirat.2:27 build/C/man3/mkfifoat.3:27 build/C/man2/mknodat.2:27 build/C/man2/openat.2:27 build/C/man2/readlinkat.2:27 build/C/man2/renameat.2:27 build/C/man2/symlinkat.2:27 build/C/man2/unlinkat.2:27
50 #: build/C/man2/faccessat.2:30
52 "faccessat - check user's permissions of a file relative to a directory file "
57 #: build/C/man2/faccessat.2:30 build/C/man2/fchmodat.2:30 build/C/man2/fchownat.2:30 build/C/man2/fstatat.2:28 build/C/man2/futimesat.2:30 build/C/man2/linkat.2:30 build/C/man2/mkdirat.2:29 build/C/man3/mkfifoat.3:29 build/C/man2/mknodat.2:30 build/C/man2/openat.2:29 build/C/man2/readlinkat.2:30 build/C/man2/renameat.2:29 build/C/man2/symlinkat.2:29 build/C/man2/unlinkat.2:29
63 #: build/C/man2/faccessat.2:34 build/C/man2/fchownat.2:34 build/C/man2/linkat.2:34 build/C/man2/readlinkat.2:34 build/C/man2/symlinkat.2:33 build/C/man2/unlinkat.2:33
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:37
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:42 build/C/man2/fchmodat.2:42 build/C/man2/fchownat.2:42 build/C/man2/fstatat.2:41 build/C/man2/futimesat.2:42 build/C/man2/linkat.2:42 build/C/man2/mkdirat.2:40 build/C/man3/mkfifoat.3:40 build/C/man2/mknodat.2:42 build/C/man2/openat.2:41 build/C/man2/readlinkat.2:42 build/C/man2/renameat.2:41 build/C/man2/symlinkat.2:41 build/C/man2/unlinkat.2:40
80 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
84 #: build/C/man2/faccessat.2:45
85 msgid "B<faccessat>():"
89 #: build/C/man2/faccessat.2:48 build/C/man2/fchmodat.2:48 build/C/man2/fchownat.2:48 build/C/man2/fstatat.2:47 build/C/man2/linkat.2:48 build/C/man2/mkdirat.2:46 build/C/man3/mkfifoat.3:46 build/C/man2/mknodat.2:48 build/C/man2/openat.2:47 build/C/man2/readlinkat.2:48 build/C/man2/renameat.2:47 build/C/man2/symlinkat.2:47 build/C/man2/unlinkat.2:46
91 msgid "Since glibc 2.10:"
95 #: build/C/man2/faccessat.2:51 build/C/man2/fchmodat.2:51 build/C/man2/fchownat.2:51 build/C/man2/fstatat.2:50 build/C/man2/linkat.2:51 build/C/man2/mkdirat.2:49 build/C/man3/mkfifoat.3:49 build/C/man2/openat.2:50 build/C/man2/readlinkat.2:51 build/C/man2/renameat.2:50 build/C/man2/symlinkat.2:50 build/C/man2/unlinkat.2:49
96 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
100 #: build/C/man2/faccessat.2:51 build/C/man2/fchmodat.2:51 build/C/man2/fchownat.2:51 build/C/man2/fstatat.2:50 build/C/man2/linkat.2:51 build/C/man2/mkdirat.2:49 build/C/man3/mkfifoat.3:49 build/C/man2/mknodat.2:53 build/C/man2/openat.2:50 build/C/man2/readlinkat.2:51 build/C/man2/renameat.2:50 build/C/man2/symlinkat.2:50 build/C/man2/unlinkat.2:49
102 msgid "Before glibc 2.10:"
106 #: build/C/man2/faccessat.2:54 build/C/man2/fchmodat.2:54 build/C/man2/fchownat.2:54 build/C/man2/fstatat.2:53 build/C/man2/linkat.2:54 build/C/man2/mkdirat.2:52 build/C/man3/mkfifoat.3:52 build/C/man2/mknodat.2:56 build/C/man2/openat.2:53 build/C/man2/readlinkat.2:54 build/C/man2/renameat.2:53 build/C/man2/symlinkat.2:53 build/C/man2/unlinkat.2:52
107 msgid "_ATFILE_SOURCE"
111 #: build/C/man2/faccessat.2:57 build/C/man2/fchmodat.2:57 build/C/man2/fchownat.2:57 build/C/man2/fstatat.2:56 build/C/man2/futimesat.2:46 build/C/man2/linkat.2:57 build/C/man2/mkdirat.2:55 build/C/man3/mkfifoat.3:55 build/C/man2/mknodat.2:59 build/C/man2/openat.2:56 build/C/man2/readlinkat.2:57 build/C/man2/renameat.2:56 build/C/man2/symlinkat.2:56 build/C/man2/unlinkat.2:55
117 #: build/C/man2/faccessat.2:63
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:73
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:85
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:91 build/C/man2/fchmodat.2:91 build/C/man2/fchownat.2:91 build/C/man2/fstatat.2:90 build/C/man2/futimesat.2:85 build/C/man2/mkdirat.2:89 build/C/man3/mkfifoat.3:89 build/C/man2/mknodat.2:93 build/C/man2/openat.2:90 build/C/man2/readlinkat.2:91
142 msgid "If I<pathname> is absolute, then I<dirfd> is ignored."
146 #: build/C/man2/faccessat.2:94
148 "I<flags> is constructed by ORing together zero or more of the following "
153 #: build/C/man2/faccessat.2:94
155 msgid "B<AT_EACCESS>"
159 #: build/C/man2/faccessat.2:101
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:101 build/C/man2/fchmodat.2:94 build/C/man2/fchownat.2:94 build/C/man2/fstatat.2:105
168 msgid "B<AT_SYMLINK_NOFOLLOW>"
172 #: build/C/man2/faccessat.2:107
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:107 build/C/man2/fchmodat.2:101 build/C/man2/fchownat.2:105 build/C/man2/fstatat.2:116 build/C/man2/futimesat.2:85 build/C/man2/linkat.2:116 build/C/man2/mkdirat.2:89 build/C/man3/mkfifoat.3:89 build/C/man2/mknodat.2:93 build/C/man2/openat.2:90 build/C/man2/readlinkat.2:91 build/C/man2/renameat.2:98 build/C/man2/symlinkat.2:90 build/C/man2/unlinkat.2:121
185 #: build/C/man2/faccessat.2:114
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:114 build/C/man2/fchmodat.2:108 build/C/man2/fchownat.2:112 build/C/man2/fstatat.2:123 build/C/man2/futimesat.2:92 build/C/man2/linkat.2:123 build/C/man2/mkdirat.2:96 build/C/man3/mkfifoat.3:96 build/C/man2/mknodat.2:100 build/C/man2/openat.2:97 build/C/man2/readlinkat.2:99 build/C/man2/renameat.2:105 build/C/man2/symlinkat.2:97 build/C/man2/unlinkat.2:128
198 #: build/C/man2/faccessat.2:121
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:121 build/C/man2/fchmodat.2:115 build/C/man2/fchownat.2:119 build/C/man2/fstatat.2:130 build/C/man2/futimesat.2:99 build/C/man2/linkat.2:130 build/C/man2/mkdirat.2:103 build/C/man3/mkfifoat.3:103 build/C/man2/mknodat.2:107 build/C/man2/openat.2:104 build/C/man2/readlinkat.2:106 build/C/man2/renameat.2:112 build/C/man2/symlinkat.2:104 build/C/man2/unlinkat.2:137
212 #: build/C/man2/faccessat.2:125 build/C/man2/fchmodat.2:119 build/C/man2/fchownat.2:123 build/C/man2/fstatat.2:134 build/C/man2/futimesat.2:103 build/C/man2/mkdirat.2:107 build/C/man3/mkfifoat.3:107 build/C/man2/mknodat.2:111 build/C/man2/openat.2:108 build/C/man2/readlinkat.2:110 build/C/man2/unlinkat.2:141
213 msgid "I<dirfd> is not a valid file descriptor."
217 #: build/C/man2/faccessat.2:125 build/C/man2/fchmodat.2:119 build/C/man2/fchownat.2:123 build/C/man2/fstatat.2:134 build/C/man2/unlinkat.2:141
223 #: build/C/man2/faccessat.2:129 build/C/man2/fchmodat.2:123 build/C/man2/fchownat.2:127 build/C/man2/fstatat.2:138
224 msgid "Invalid flag specified in I<flags>."
228 #: build/C/man2/faccessat.2:129 build/C/man2/fchmodat.2:123 build/C/man2/fchownat.2:127 build/C/man2/fstatat.2:138 build/C/man2/futimesat.2:103 build/C/man2/linkat.2:136 build/C/man2/mkdirat.2:107 build/C/man3/mkfifoat.3:107 build/C/man2/mknodat.2:111 build/C/man2/openat.2:108 build/C/man2/readlinkat.2:110 build/C/man2/renameat.2:118 build/C/man2/symlinkat.2:108 build/C/man2/unlinkat.2:145
234 #: build/C/man2/faccessat.2:135 build/C/man2/fchmodat.2:129 build/C/man2/fchownat.2:133 build/C/man2/fstatat.2:144 build/C/man2/futimesat.2:109 build/C/man2/mkdirat.2:113 build/C/man2/mknodat.2:117 build/C/man2/openat.2:114 build/C/man2/readlinkat.2:116 build/C/man2/unlinkat.2:151
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:135 build/C/man2/fchmodat.2:135 build/C/man2/fchownat.2:133 build/C/man2/fstatat.2:144 build/C/man2/futimesat.2:109 build/C/man2/linkat.2:146 build/C/man2/mkdirat.2:113 build/C/man3/mkfifoat.3:113 build/C/man2/mknodat.2:117 build/C/man2/openat.2:114 build/C/man2/readlinkat.2:116 build/C/man2/renameat.2:128 build/C/man2/symlinkat.2:114 build/C/man2/unlinkat.2:151
247 #: build/C/man2/faccessat.2:138
248 msgid "B<faccessat>() was added to Linux in kernel 2.6.16."
252 #: build/C/man2/faccessat.2:138 build/C/man2/fchmodat.2:138 build/C/man2/fchownat.2:136 build/C/man2/fstatat.2:147 build/C/man2/futimesat.2:112 build/C/man2/linkat.2:149 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
254 msgid "CONFORMING TO"
258 #: build/C/man2/faccessat.2:140 build/C/man2/fchmodat.2:140 build/C/man2/linkat.2:151 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
259 msgid "POSIX.1-2008."
263 #: build/C/man2/faccessat.2:140 build/C/man2/fchmodat.2:140 build/C/man2/fchownat.2:139 build/C/man2/fstatat.2:150 build/C/man2/futimesat.2:119 build/C/man2/linkat.2:151 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
269 #: build/C/man2/faccessat.2:145
270 msgid "See B<openat>(2) for an explanation of the need for B<faccessat>()."
274 #: build/C/man2/faccessat.2:152
276 "I<Warning>: B<faccessat>() is subject to the same kinds of races as "
277 "B<access>(2) and B<euidaccess>(3)."
281 #: build/C/man2/faccessat.2:152 build/C/man2/futimesat.2:120
287 #: build/C/man2/faccessat.2:162
289 "The B<AT_EACCESS> and B<AT_SYMLINK_NOFOLLOW> flags are actually implemented "
290 "within the glibc wrapper function for B<faccessat>(). If either of these "
291 "flags are specified, then the wrapper function employs B<fstatat>(2) to "
292 "determine access permissions."
296 #: build/C/man2/faccessat.2:162 build/C/man2/fchmodat.2:145 build/C/man2/fchownat.2:144 build/C/man2/fstatat.2:160 build/C/man2/futimesat.2:128 build/C/man2/linkat.2:156 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
302 #: build/C/man2/faccessat.2:169
304 "B<access>(2), B<openat>(2), B<euidaccess>(3), B<credentials>(7), "
305 "B<path_resolution>(7), B<symlink>(7)"
309 #: build/C/man2/faccessat.2:169 build/C/man2/fchmodat.2:150 build/C/man2/fchownat.2:149 build/C/man2/fstatat.2:165 build/C/man2/futimesat.2:134 build/C/man2/linkat.2:161 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
315 #: build/C/man2/faccessat.2:176 build/C/man2/fchmodat.2:157 build/C/man2/fchownat.2:156 build/C/man2/fstatat.2:172 build/C/man2/futimesat.2:141 build/C/man2/linkat.2:168 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
317 "This page is part of release 3.38 of the Linux I<man-pages> project. A "
318 "description of the project, and information about reporting bugs, can be "
319 "found at http://www.kernel.org/doc/man-pages/."
323 #: build/C/man2/fchmodat.2:26
329 #: build/C/man2/fchmodat.2:26 build/C/man2/fchownat.2:26 build/C/man2/linkat.2:27 build/C/man2/mkdirat.2:26 build/C/man3/mkfifoat.3:26 build/C/man2/openat.2:26 build/C/man2/readlinkat.2:26 build/C/man2/renameat.2:26
335 #: build/C/man2/fchmodat.2:30
337 "fchmodat - change permissions of a file relative to a directory file "
342 #: build/C/man2/fchmodat.2:34 build/C/man2/fstatat.2:32 build/C/man2/mkdirat.2:33 build/C/man3/mkfifoat.3:33 build/C/man2/mknodat.2:34
345 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
346 "B<#include E<lt>sys/stat.hE<gt>>\n"
350 #: build/C/man2/fchmodat.2:37
353 "B<int fchmodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
354 ">I<mode>B<, int >I<flags>B<);>\n"
358 #: build/C/man2/fchmodat.2:45
359 msgid "B<fchmodat>():"
363 #: build/C/man2/fchmodat.2:63
365 "The B<fchmodat>() system call operates in exactly the same way as "
366 "B<chmod>(2), except for the differences described in this manual page."
370 #: build/C/man2/fchmodat.2:73
372 "If the pathname given in I<pathname> is relative, then it is interpreted "
373 "relative to the directory referred to by the file descriptor I<dirfd> "
374 "(rather than relative to the current working directory of the calling "
375 "process, as is done by B<chmod>(2) for a relative pathname)."
379 #: build/C/man2/fchmodat.2:85
381 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
382 "then I<pathname> is interpreted relative to the current working directory of "
383 "the calling process (like B<chmod>(2))."
387 #: build/C/man2/fchmodat.2:94 build/C/man2/fchownat.2:94
388 msgid "I<flags> can either be 0, or include the following flag:"
392 #: build/C/man2/fchmodat.2:101
394 "If I<pathname> is a symbolic link, do not dereference it: instead operate on "
395 "the link itself. This flag is not currently implemented."
399 #: build/C/man2/fchmodat.2:108
401 "On success, B<fchmodat>() returns 0. On error, -1 is returned and I<errno> "
402 "is set to indicate the error."
406 #: build/C/man2/fchmodat.2:115
408 "The same errors that occur for B<chmod>(2) can also occur for "
409 "B<fchmodat>(). The following additional errors can occur for B<fchmodat>():"
413 #: build/C/man2/fchmodat.2:129
419 #: build/C/man2/fchmodat.2:135
420 msgid "I<flags> specified B<AT_SYMLINK_NOFOLLOW>, which is not supported."
424 #: build/C/man2/fchmodat.2:138
425 msgid "B<fchmodat>() was added to Linux in kernel 2.6.16."
429 #: build/C/man2/fchmodat.2:145
430 msgid "See B<openat>(2) for an explanation of the need for B<fchmodat>()."
434 #: build/C/man2/fchmodat.2:150
435 msgid "B<chmod>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
439 #: build/C/man2/fchownat.2:26
445 #: build/C/man2/fchownat.2:30
447 "fchownat - change ownership of a file relative to a directory file "
452 #: build/C/man2/fchownat.2:37
455 "B<int fchownat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
456 "B< uid_t >I<owner>B<, gid_t >I<group>B<, int >I<flags>B<);>\n"
460 #: build/C/man2/fchownat.2:45
461 msgid "B<fchownat>():"
465 #: build/C/man2/fchownat.2:63
467 "The B<fchownat>() system call operates in exactly the same way as "
468 "B<chown>(2), except for the differences described in this manual page."
472 #: build/C/man2/fchownat.2:73
474 "If the pathname given in I<pathname> is relative, then it is interpreted "
475 "relative to the directory referred to by the file descriptor I<dirfd> "
476 "(rather than relative to the current working directory of the calling "
477 "process, as is done by B<chown>(2) for a relative pathname)."
481 #: build/C/man2/fchownat.2:85
483 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
484 "then I<pathname> is interpreted relative to the current working directory of "
485 "the calling process (like B<chown>(2))."
489 #: build/C/man2/fchownat.2:105
491 "If I<pathname> is a symbolic link, do not dereference it: instead operate on "
492 "the link itself, like B<lchown>(2). (By default, B<fchownat>() "
493 "dereferences symbolic links, like B<chown>(2).)"
497 #: build/C/man2/fchownat.2:112
499 "On success, B<fchownat>() returns 0. On error, -1 is returned and I<errno> "
500 "is set to indicate the error."
504 #: build/C/man2/fchownat.2:119
506 "The same errors that occur for B<chown>(2) can also occur for "
507 "B<fchownat>(). The following additional errors can occur for B<fchownat>():"
511 #: build/C/man2/fchownat.2:136
512 msgid "B<fchownat>() was added to Linux in kernel 2.6.16."
516 #: build/C/man2/fchownat.2:139 build/C/man2/fstatat.2:150 build/C/man2/openat.2:132 build/C/man2/unlinkat.2:157
517 msgid "POSIX.1-2008. A similar system call exists on Solaris."
521 #: build/C/man2/fchownat.2:144
522 msgid "See B<openat>(2) for an explanation of the need for B<fchownat>()."
526 #: build/C/man2/fchownat.2:149
527 msgid "B<chown>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
531 #: build/C/man2/fstatat.2:25
537 #: build/C/man2/fstatat.2:25
543 #: build/C/man2/fstatat.2:28
544 msgid "fstatat - get file status relative to a directory file descriptor"
548 #: build/C/man2/fstatat.2:36
551 "B<int fstatat(int >I<dirfd>B<, const char *>I<pathname>B<, struct stat "
553 "B< int >I<flags>B<);>\n"
557 #: build/C/man2/fstatat.2:44
558 msgid "B<fstatat>():"
562 #: build/C/man2/fstatat.2:62
564 "The B<fstatat>() system call operates in exactly the same way as "
565 "B<stat>(2), except for the differences described in this manual page."
569 #: build/C/man2/fstatat.2:72
571 "If the pathname given in I<pathname> is relative, then it is interpreted "
572 "relative to the directory referred to by the file descriptor I<dirfd> "
573 "(rather than relative to the current working directory of the calling "
574 "process, as is done by B<stat>(2) for a relative pathname)."
578 #: build/C/man2/fstatat.2:84
580 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
581 "then I<pathname> is interpreted relative to the current working directory of "
582 "the calling process (like B<stat>(2))."
586 #: build/C/man2/fstatat.2:93
588 "I<flags> can either be 0, or include one or more of the following flags "
593 #: build/C/man2/fstatat.2:93
595 msgid "B<AT_NO_AUTOMOUNT> (since Linux 2.6.38)"
599 #: build/C/man2/fstatat.2:105
601 "Don't automount the terminal (\"basename\") component of I<pathname> if it "
602 "is a directory that is an automount point. This allows the caller to gather "
603 "attributes of an automount point (rather than the location it would mount). "
604 "This flag can be used in tools that scan directories to prevent "
605 "mass-automounting of a directory of automount points. The "
606 "B<AT_NO_AUTOMOUNT> flag has no effect if the mount point has already been "
611 #: build/C/man2/fstatat.2:116
613 "If I<pathname> is a symbolic link, do not dereference it: instead return "
614 "information about the link itself, like B<lstat>(2). (By default, "
615 "B<fstatat>() dereferences symbolic links, like B<stat>(2).)"
619 #: build/C/man2/fstatat.2:123
621 "On success, B<fstatat>() returns 0. On error, -1 is returned and I<errno> "
622 "is set to indicate the error."
626 #: build/C/man2/fstatat.2:130
628 "The same errors that occur for B<stat>(2) can also occur for B<fstatat>(). "
629 "The following additional errors can occur for B<fstatat>():"
633 #: build/C/man2/fstatat.2:147
634 msgid "B<fstatat>() was added to Linux in kernel 2.6.16."
638 #: build/C/man2/fstatat.2:155
639 msgid "See B<openat>(2) for an explanation of the need for B<fstatat>()."
643 #: build/C/man2/fstatat.2:160
645 "The underlying system call employed by the glibc B<fstatat>() wrapper "
646 "function is actually called B<fstatat64>()."
650 #: build/C/man2/fstatat.2:165
651 msgid "B<openat>(2), B<stat>(2), B<path_resolution>(7), B<symlink>(7)"
655 #: build/C/man2/futimesat.2:26
661 #: build/C/man2/futimesat.2:26 build/C/man2/symlinkat.2:26 build/C/man2/unlinkat.2:26
667 #: build/C/man2/futimesat.2:30
669 "futimesat - change timestamps of a file relative to a directory file "
674 #: build/C/man2/futimesat.2:34
677 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
678 "B<#include E<lt>sys/time.hE<gt>>\n"
682 #: build/C/man2/futimesat.2:37
685 "B<int futimesat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
686 "B< const struct timeval >I<times>B<[2]);>\n"
690 #: build/C/man2/futimesat.2:46
691 msgid "B<futimesat>(): _GNU_SOURCE"
695 #: build/C/man2/futimesat.2:51
696 msgid "This system call is obsolete. Use B<utimensat>(2) instead."
700 #: build/C/man2/futimesat.2:57
702 "The B<futimesat>() system call operates in exactly the same way as "
703 "B<utimes>(2), except for the differences described in this manual page."
707 #: build/C/man2/futimesat.2:67
709 "If the pathname given in I<pathname> is relative, then it is interpreted "
710 "relative to the directory referred to by the file descriptor I<dirfd> "
711 "(rather than relative to the current working directory of the calling "
712 "process, as is done by B<utimes>(2) for a relative pathname)."
716 #: build/C/man2/futimesat.2:79
718 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
719 "then I<pathname> is interpreted relative to the current working directory of "
720 "the calling process (like B<utimes>(2))."
724 #: build/C/man2/futimesat.2:92
726 "On success, B<futimesat>() returns a 0. On error, -1 is returned and "
727 "I<errno> is set to indicate the error."
731 #: build/C/man2/futimesat.2:99
733 "The same errors that occur for B<utimes>(2) can also occur for "
734 "B<futimesat>(). The following additional errors can occur for "
739 #: build/C/man2/futimesat.2:112
740 msgid "B<futimesat>() was added to Linux in kernel 2.6.16."
744 #: build/C/man2/futimesat.2:117
746 "This system call is nonstandard. It was implemented from a specification "
747 "that was proposed for POSIX.1, but that specification was replaced by the "
748 "one for B<utimensat>(2)."
752 #: build/C/man2/futimesat.2:119
753 msgid "A similar system call exists on Solaris."
756 #. The Solaris futimesat() also has this strangeness.
758 #: build/C/man2/futimesat.2:128
760 "If I<pathname> is NULL, then the glibc B<futimesat>() wrapper function "
761 "updates the times for the file referred to by I<dirfd>."
765 #: build/C/man2/futimesat.2:134
767 "B<stat>(2), B<utimensat>(2), B<utimes>(2), B<futimes>(3), "
768 "B<path_resolution>(7)"
772 #: build/C/man2/linkat.2:27
778 #: build/C/man2/linkat.2:30
779 msgid "linkat - create a file link relative to directory file descriptors"
783 #: build/C/man2/linkat.2:37
786 "B<int linkat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
787 "B< int >I<newdirfd>B<, const char *>I<newpath>B<, int "
792 #: build/C/man2/linkat.2:45
797 #: build/C/man2/linkat.2:63
799 "The B<linkat>() system call operates in exactly the same way as B<link>(2), "
800 "except for the differences described in this manual page."
804 #: build/C/man2/linkat.2:73
806 "If the pathname given in I<oldpath> is relative, then it is interpreted "
807 "relative to the directory referred to by the file descriptor I<olddirfd> "
808 "(rather than relative to the current working directory of the calling "
809 "process, as is done by B<link>(2) for a relative pathname)."
813 #: build/C/man2/linkat.2:85
815 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
816 "then I<oldpath> is interpreted relative to the current working directory of "
817 "the calling process (like B<link>(2))."
821 #: build/C/man2/linkat.2:91 build/C/man2/renameat.2:90
822 msgid "If I<oldpath> is absolute, then I<olddirfd> is ignored."
826 #: build/C/man2/linkat.2:99 build/C/man2/renameat.2:98
828 "The interpretation of I<newpath> is as for I<oldpath>, except that a "
829 "relative pathname is interpreted relative to the directory referred to by "
830 "the file descriptor I<newdirfd>."
834 #: build/C/man2/linkat.2:116
836 "By default, B<linkat>(), does not dereference I<oldpath> if it is a symbolic "
837 "link (like B<link>(2)). Since Linux 2.6.18, the flag B<AT_SYMLINK_FOLLOW> "
838 "can be specified in I<flags> to cause I<oldpath> to be dereferenced if it is "
839 "a symbolic link. Before kernel 2.6.18, the I<flags> argument was unused, "
840 "and had to be specified as 0."
844 #: build/C/man2/linkat.2:123
846 "On success, B<linkat>() returns 0. On error, -1 is returned and I<errno> "
847 "is set to indicate the error."
851 #: build/C/man2/linkat.2:130
853 "The same errors that occur for B<link>(2) can also occur for B<linkat>(). "
854 "The following additional errors can occur for B<linkat>():"
858 #: build/C/man2/linkat.2:136 build/C/man2/renameat.2:118
859 msgid "I<olddirfd> or I<newdirfd> is not a valid file descriptor."
863 #: build/C/man2/linkat.2:146 build/C/man2/renameat.2:128
865 "I<oldpath> is relative and I<olddirfd> is a file descriptor referring to a "
866 "file other than a directory; or similar for I<newpath> and I<newdirfd>"
870 #: build/C/man2/linkat.2:149
871 msgid "B<linkat>() was added to Linux in kernel 2.6.16."
875 #: build/C/man2/linkat.2:156
876 msgid "See B<openat>(2) for an explanation of the need for B<linkat>()."
880 #: build/C/man2/linkat.2:161
881 msgid "B<link>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
885 #: build/C/man2/mkdirat.2:26
891 #: build/C/man2/mkdirat.2:29
892 msgid "mkdirat - create a directory relative to a directory file descriptor"
896 #: build/C/man2/mkdirat.2:35
899 "B<int mkdirat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
904 #: build/C/man2/mkdirat.2:43
905 msgid "B<mkdirat>():"
909 #: build/C/man2/mkdirat.2:61
911 "The B<mkdirat>() system call operates in exactly the same way as "
912 "B<mkdir>(2), except for the differences described in this manual page."
916 #: build/C/man2/mkdirat.2:71
918 "If the pathname given in I<pathname> is relative, then it is interpreted "
919 "relative to the directory referred to by the file descriptor I<dirfd> "
920 "(rather than relative to the current working directory of the calling "
921 "process, as is done by B<mkdir>(2) for a relative pathname)."
925 #: build/C/man2/mkdirat.2:83
927 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
928 "then I<pathname> is interpreted relative to the current working directory of "
929 "the calling process (like B<mkdir>(2))."
933 #: build/C/man2/mkdirat.2:96
935 "On success, B<mkdirat>() returns 0. On error, -1 is returned and I<errno> "
936 "is set to indicate the error."
940 #: build/C/man2/mkdirat.2:103
942 "The same errors that occur for B<mkdir>(2) can also occur for "
943 "B<mkdirat>(). The following additional errors can occur for B<mkdirat>():"
947 #: build/C/man2/mkdirat.2:116
948 msgid "B<mkdirat>() was added to Linux in kernel 2.6.16."
952 #: build/C/man2/mkdirat.2:123
953 msgid "See B<openat>(2) for an explanation of the need for B<mkdirat>()."
957 #: build/C/man2/mkdirat.2:127
958 msgid "B<mkdir>(2), B<openat>(2), B<path_resolution>(7)"
962 #: build/C/man3/mkfifoat.3:26
968 #: build/C/man3/mkfifoat.3:29
969 msgid "mkfifoat - make a FIFO (named pipe) relative to a directory file descriptor"
973 #: build/C/man3/mkfifoat.3:35
976 "B<int mkfifoat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
981 #: build/C/man3/mkfifoat.3:43
982 msgid "B<mkfifoat>():"
986 #: build/C/man3/mkfifoat.3:61
988 "The B<mkfifoat>() system call operates in exactly the same way as "
989 "B<mkfifo>(3), except for the differences described in this manual page."
993 #: build/C/man3/mkfifoat.3:71
995 "If the pathname given in I<pathname> is relative, then it is interpreted "
996 "relative to the directory referred to by the file descriptor I<dirfd> "
997 "(rather than relative to the current working directory of the calling "
998 "process, as is done by B<mkfifo>(3) for a relative pathname)."
1002 #: build/C/man3/mkfifoat.3:83
1004 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1005 "then I<pathname> is interpreted relative to the current working directory of "
1006 "the calling process (like B<mkfifo>(3))."
1010 #: build/C/man3/mkfifoat.3:96
1012 "On success, B<mkfifoat>() returns 0. On error, -1 is returned and I<errno> "
1013 "is set to indicate the error."
1017 #: build/C/man3/mkfifoat.3:103
1019 "The same errors that occur for B<mkfifo>(3) can also occur for "
1020 "B<mkfifoat>(). The following additional errors can occur for B<mkfifoat>():"
1024 #: build/C/man3/mkfifoat.3:113
1026 "I<pathname> is a relative path and I<dirfd> is a file descriptor referring "
1027 "to a file other than a directory."
1031 #: build/C/man3/mkfifoat.3:119
1033 "B<mkfifoat>() was added to glibc in version 2.4. It is implemented using "
1034 "B<mknod>(2), available on Linux since kernel 2.6.16."
1038 #: build/C/man3/mkfifoat.3:126
1039 msgid "See B<openat>(2) for an explanation of the need for B<mkfifoat>()."
1043 #: build/C/man3/mkfifoat.3:130
1044 msgid "B<openat>(2), B<mkfifo>(3), B<path_resolution>(7)"
1048 #: build/C/man2/mknodat.2:26
1054 #: build/C/man2/mknodat.2:26
1060 #: build/C/man2/mknodat.2:30
1062 "mknodat - create a special or ordinary file relative to a directory file "
1067 #: build/C/man2/mknodat.2:37
1070 "B<int mknodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
1071 ">I<mode>B<, dev_t >I<dev>B<);>\n"
1075 #: build/C/man2/mknodat.2:45
1076 msgid "B<mknodat>():"
1079 #. Other FTM combinations will also expose mknodat(), but this function was
1080 #. added in SUSv4, marked XSI, so we'll just document what the standard says.
1082 #: build/C/man2/mknodat.2:53
1084 msgid " _XOPEN_SOURCE\\ E<gt>=\\ 700\n"
1088 #: build/C/man2/mknodat.2:65
1090 "The B<mknodat>() system call operates in exactly the same way as "
1091 "B<mknod>(2), except for the differences described in this manual page."
1095 #: build/C/man2/mknodat.2:75
1097 "If the pathname given in I<pathname> is relative, then it is interpreted "
1098 "relative to the directory referred to by the file descriptor I<dirfd> "
1099 "(rather than relative to the current working directory of the calling "
1100 "process, as is done by B<mknod>(2) for a relative pathname)."
1104 #: build/C/man2/mknodat.2:87
1106 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1107 "then I<pathname> is interpreted relative to the current working directory of "
1108 "the calling process (like B<mknod>(2))."
1112 #: build/C/man2/mknodat.2:100
1114 "On success, B<mknodat>() returns 0. On error, -1 is returned and I<errno> "
1115 "is set to indicate the error."
1119 #: build/C/man2/mknodat.2:107
1121 "The same errors that occur for B<mknod>(2) can also occur for "
1122 "B<mknodat>(). The following additional errors can occur for B<mknodat>():"
1126 #: build/C/man2/mknodat.2:120
1127 msgid "B<mknodat>() was added to Linux in kernel 2.6.16."
1131 #: build/C/man2/mknodat.2:127
1132 msgid "See B<openat>(2) for an explanation of the need for B<mknodat>()."
1136 #: build/C/man2/mknodat.2:131
1137 msgid "B<mknod>(2), B<openat>(2), B<path_resolution>(7)"
1141 #: build/C/man2/openat.2:26
1147 #: build/C/man2/openat.2:29
1148 msgid "openat - open a file relative to a directory file descriptor"
1152 #: build/C/man2/openat.2:32
1154 msgid "B<#include E<lt>fcntl.hE<gt>>\n"
1158 #: build/C/man2/openat.2:36
1161 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1163 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int >I<flags>B<, "
1164 "mode_t >I<mode>B<);>\n"
1168 #: build/C/man2/openat.2:44
1169 msgid "B<openat>():"
1173 #: build/C/man2/openat.2:62
1175 "The B<openat>() system call operates in exactly the same way as B<open>(2), "
1176 "except for the differences described in this manual page."
1180 #: build/C/man2/openat.2:72
1182 "If the pathname given in I<pathname> is relative, then it is interpreted "
1183 "relative to the directory referred to by the file descriptor I<dirfd> "
1184 "(rather than relative to the current working directory of the calling "
1185 "process, as is done by B<open>(2) for a relative pathname)."
1189 #: build/C/man2/openat.2:84
1191 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1192 "then I<pathname> is interpreted relative to the current working directory of "
1193 "the calling process (like B<open>(2))."
1197 #: build/C/man2/openat.2:97
1199 "On success, B<openat>() returns a new file descriptor. On error, -1 is "
1200 "returned and I<errno> is set to indicate the error."
1204 #: build/C/man2/openat.2:104
1206 "The same errors that occur for B<open>(2) can also occur for B<openat>(). "
1207 "The following additional errors can occur for B<openat>():"
1211 #: build/C/man2/openat.2:117
1212 msgid "B<openat>() was added to Linux in kernel 2.6.16."
1216 #: build/C/man2/openat.2:136
1218 "B<openat>() and other similar system calls suffixed \"at\" are supported "
1223 #: build/C/man2/openat.2:154
1225 "First, B<openat>() allows an application to avoid race conditions that "
1226 "could occur when using B<open>(2) to open files in directories other than "
1227 "the current working directory. These race conditions result from the fact "
1228 "that some component of the directory prefix given to B<open>(2) could be "
1229 "changed in parallel with the call to B<open>(2). Such races can be avoided "
1230 "by opening a file descriptor for the target directory, and then specifying "
1231 "that file descriptor as the I<dirfd> argument of B<openat>()."
1235 #: build/C/man2/openat.2:163
1237 "Second, B<openat>() allows the implementation of a per-thread \"current "
1238 "working directory\", via file descriptor(s) maintained by the application. "
1239 "(This functionality can also be obtained by tricks based on the use of "
1240 "I</proc/self/fd/>dirfd, but less efficiently.)"
1244 #: build/C/man2/openat.2:180
1246 "B<faccessat>(2), B<fchmodat>(2), B<fchownat>(2), B<fstatat>(2), "
1247 "B<futimesat>(2), B<linkat>(2), B<mkdirat>(2), B<mknodat>(2), B<open>(2), "
1248 "B<readlinkat>(2), B<renameat>(2), B<symlinkat>(2), B<unlinkat>(2), "
1249 "B<utimensat>(2), B<mkfifoat>(3), B<path_resolution>(7)"
1253 #: build/C/man2/readlinkat.2:26
1259 #: build/C/man2/readlinkat.2:30
1261 "readlinkat - read value of a symbolic link relative to a directory file "
1266 #: build/C/man2/readlinkat.2:37
1269 "B<int readlinkat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
1270 "B< char *>I<buf>B<, size_t >I<bufsiz>B<);>\n"
1274 #: build/C/man2/readlinkat.2:45
1275 msgid "B<readlinkat>():"
1279 #: build/C/man2/readlinkat.2:63
1281 "The B<readlinkat>() system call operates in exactly the same way as "
1282 "B<readlink>(2), except for the differences described in this manual page."
1286 #: build/C/man2/readlinkat.2:73
1288 "If the pathname given in I<pathname> is relative, then it is interpreted "
1289 "relative to the directory referred to by the file descriptor I<dirfd> "
1290 "(rather than relative to the current working directory of the calling "
1291 "process, as is done by B<readlink>(2) for a relative pathname)."
1295 #: build/C/man2/readlinkat.2:85
1297 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1298 "then I<pathname> is interpreted relative to the current working directory of "
1299 "the calling process (like B<readlink>(2))."
1303 #: build/C/man2/readlinkat.2:99
1305 "On success, B<readlinkat>() returns the number of bytes placed in I<buf>. "
1306 "On error, -1 is returned and I<errno> is set to indicate the error."
1310 #: build/C/man2/readlinkat.2:106
1312 "The same errors that occur for B<readlink>(2) can also occur for "
1313 "B<readlinkat>(). The following additional errors can occur for "
1318 #: build/C/man2/readlinkat.2:119
1319 msgid "B<readlinkat>() was added to Linux in kernel 2.6.16."
1323 #: build/C/man2/readlinkat.2:126
1324 msgid "See B<openat>(2) for an explanation of the need for B<readlinkat>()."
1328 #: build/C/man2/readlinkat.2:130
1329 msgid "B<openat>(2), B<readlink>(2), B<path_resolution>(7)"
1333 #: build/C/man2/renameat.2:26
1339 #: build/C/man2/renameat.2:29
1340 msgid "renameat - rename a file relative to directory file descriptors"
1344 #: build/C/man2/renameat.2:33
1347 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
1348 "B<#include E<lt>stdio.hE<gt>>\n"
1352 #: build/C/man2/renameat.2:36
1355 "B<int renameat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
1356 "B< int >I<newdirfd>B<, const char *>I<newpath>B<);>\n"
1360 #: build/C/man2/renameat.2:44
1361 msgid "B<renameat>():"
1365 #: build/C/man2/renameat.2:62
1367 "The B<renameat>() system call operates in exactly the same way as "
1368 "B<rename>(2), except for the differences described in this manual page."
1372 #: build/C/man2/renameat.2:72
1374 "If the pathname given in I<oldpath> is relative, then it is interpreted "
1375 "relative to the directory referred to by the file descriptor I<olddirfd> "
1376 "(rather than relative to the current working directory of the calling "
1377 "process, as is done by B<rename>(2) for a relative pathname)."
1381 #: build/C/man2/renameat.2:84
1383 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
1384 "then I<oldpath> is interpreted relative to the current working directory of "
1385 "the calling process (like B<rename>(2))."
1389 #: build/C/man2/renameat.2:105
1391 "On success, B<renameat>() returns 0. On error, -1 is returned and I<errno> "
1392 "is set to indicate the error."
1396 #: build/C/man2/renameat.2:112
1398 "The same errors that occur for B<rename>(2) can also occur for "
1399 "B<renameat>(). The following additional errors can occur for B<renameat>():"
1403 #: build/C/man2/renameat.2:131
1404 msgid "B<renameat>() was added to Linux in kernel 2.6.16."
1408 #: build/C/man2/renameat.2:138
1409 msgid "See B<openat>(2) for an explanation of the need for B<renameat>()."
1413 #: build/C/man2/renameat.2:142
1414 msgid "B<openat>(2), B<rename>(2), B<path_resolution>(7)"
1418 #: build/C/man2/symlinkat.2:26
1424 #: build/C/man2/symlinkat.2:29
1425 msgid "symlinkat - create a symbolic link relative to a directory file descriptor"
1429 #: build/C/man2/symlinkat.2:36
1432 "B<int symlinkat(const char *>I<oldpath>B<, int >I<newdirfd>B<, const char "
1433 "*>I<newpath>B<);>\n"
1437 #: build/C/man2/symlinkat.2:44
1438 msgid "B<symlinkat>():"
1442 #: build/C/man2/symlinkat.2:62
1444 "The B<symlinkat>() system call operates in exactly the same way as "
1445 "B<symlink>(2), except for the differences described in this manual page."
1449 #: build/C/man2/symlinkat.2:72
1451 "If the pathname given in I<newpath> is relative, then it is interpreted "
1452 "relative to the directory referred to by the file descriptor I<newdirfd> "
1453 "(rather than relative to the current working directory of the calling "
1454 "process, as is done by B<symlink>(2) for a relative pathname)."
1458 #: build/C/man2/symlinkat.2:84
1460 "If I<newpath> is relative and I<newdirfd> is the special value B<AT_FDCWD>, "
1461 "then I<newpath> is interpreted relative to the current working directory of "
1462 "the calling process (like B<symlink>(2))."
1466 #: build/C/man2/symlinkat.2:90
1467 msgid "If I<newpath> is absolute, then I<newdirfd> is ignored."
1471 #: build/C/man2/symlinkat.2:97
1473 "On success, B<symlinkat>() returns 0. On error, -1 is returned and "
1474 "I<errno> is set to indicate the error."
1478 #: build/C/man2/symlinkat.2:104
1480 "The same errors that occur for B<symlink>(2) can also occur for "
1481 "B<symlinkat>(). The following additional errors can occur for "
1486 #: build/C/man2/symlinkat.2:108
1487 msgid "I<newdirfd> is not a valid file descriptor."
1491 #: build/C/man2/symlinkat.2:114
1493 "I<newpath> is relative and I<newdirfd> is a file descriptor referring to a "
1494 "file other than a directory."
1498 #: build/C/man2/symlinkat.2:117
1499 msgid "B<symlinkat>() was added to Linux in kernel 2.6.16."
1503 #: build/C/man2/symlinkat.2:124
1504 msgid "See B<openat>(2) for an explanation of the need for B<symlinkat>()."
1508 #: build/C/man2/symlinkat.2:129
1509 msgid "B<openat>(2), B<symlink>(2), B<path_resolution>(7), B<symlink>(7)"
1513 #: build/C/man2/unlinkat.2:26
1519 #: build/C/man2/unlinkat.2:29
1520 msgid "unlinkat - remove a directory entry relative to a directory file descriptor"
1524 #: build/C/man2/unlinkat.2:35
1527 "B<int unlinkat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1532 #: build/C/man2/unlinkat.2:43
1533 msgid "B<unlinkat>():"
1537 #: build/C/man2/unlinkat.2:68
1539 "The B<unlinkat>() system call operates in exactly the same way as either "
1540 "B<unlink>(2) or B<rmdir>(2) (depending on whether or not I<flags> includes "
1541 "the B<AT_REMOVEDIR> flag) except for the differences described in this "
1546 #: build/C/man2/unlinkat.2:80
1548 "If the pathname given in I<pathname> is relative, then it is interpreted "
1549 "relative to the directory referred to by the file descriptor I<dirfd> "
1550 "(rather than relative to the current working directory of the calling "
1551 "process, as is done by B<unlink>(2) and B<rmdir>(2) for a relative "
1556 #: build/C/man2/unlinkat.2:94
1558 "If the pathname given in I<pathname> is relative and I<dirfd> is the special "
1559 "value B<AT_FDCWD>, then I<pathname> is interpreted relative to the current "
1560 "working directory of the calling process (like B<unlink>(2) and "
1565 #: build/C/man2/unlinkat.2:100
1566 msgid "If the pathname given in I<pathname> is absolute, then I<dirfd> is ignored."
1570 #: build/C/man2/unlinkat.2:106
1572 "I<flags> is a bit mask that can either be specified as 0, or by ORing "
1573 "together flag values that control the operation of B<unlinkat>(). Currently "
1574 "only one such flags is defined:"
1578 #: build/C/man2/unlinkat.2:106
1580 msgid "B<AT_REMOVEDIR>"
1584 #: build/C/man2/unlinkat.2:121
1586 "By default, B<unlinkat>() performs the equivalent of B<unlink>(2) on "
1587 "I<pathname>. If the B<AT_REMOVEDIR> flag is specified, then performs the "
1588 "equivalent of B<rmdir>(2) on I<pathname>."
1592 #: build/C/man2/unlinkat.2:128
1594 "On success, B<unlinkat>() returns 0. On error, -1 is returned and I<errno> "
1595 "is set to indicate the error."
1599 #: build/C/man2/unlinkat.2:137
1601 "The same errors that occur for B<unlink>(2) and B<rmdir>(2) can also occur "
1602 "for B<unlinkat>(). The following additional errors can occur for "
1607 #: build/C/man2/unlinkat.2:145
1608 msgid "An invalid flag value was specified in I<flags>."
1612 #: build/C/man2/unlinkat.2:154
1613 msgid "B<unlinkat>() was added to Linux in kernel 2.6.16."
1617 #: build/C/man2/unlinkat.2:162
1618 msgid "See B<openat>(2) for an explanation of the need for B<unlinkat>()."
1622 #: build/C/man2/unlinkat.2:167
1623 msgid "B<openat>(2), B<rmdir>(2), B<unlink>(2), B<path_resolution>(7)"