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-09-28 04:06+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/mkdirat.2:25 build/C/man2/mknodat.2:25 build/C/man2/openat.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:25 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:25 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:26 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:28 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:32 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:40 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:46 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:49 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:49 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:52 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:55 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:110 build/C/man2/fstatat.2:120
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:121 build/C/man2/fstatat.2:131 build/C/man2/futimesat.2:84 build/C/man2/linkat.2:142 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:105 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:128 build/C/man2/fstatat.2:138 build/C/man2/futimesat.2:91 build/C/man2/linkat.2:149 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:113 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:135 build/C/man2/fstatat.2:145 build/C/man2/futimesat.2:98 build/C/man2/linkat.2:156 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:120 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:139 build/C/man2/fstatat.2:149 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:124 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:139 build/C/man2/fstatat.2:149 build/C/man2/unlinkat.2:140
223 #: build/C/man2/faccessat.2:128 build/C/man2/fchmodat.2:122 build/C/man2/fchownat.2:143 build/C/man2/fstatat.2:153
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:143 build/C/man2/fstatat.2:153 build/C/man2/futimesat.2:102 build/C/man2/linkat.2:170 build/C/man2/linkat.2:172 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:124 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:149 build/C/man2/fstatat.2:159 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:130 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:149 build/C/man2/fstatat.2:159 build/C/man2/futimesat.2:108 build/C/man2/linkat.2:182 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:130 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:153 build/C/man2/fstatat.2:163 build/C/man2/futimesat.2:112 build/C/man2/linkat.2:186 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:134 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:188 build/C/man2/mkdirat.2:118 build/C/man3/mkfifoat.3:121 build/C/man2/mknodat.2:122 build/C/man2/readlinkat.2:136 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:156 build/C/man2/fstatat.2:166 build/C/man2/futimesat.2:119 build/C/man2/linkat.2:188 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:136 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:161 build/C/man2/fstatat.2:176 build/C/man2/futimesat.2:128 build/C/man2/linkat.2:193 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:141 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:166 build/C/man2/fstatat.2:181 build/C/man2/futimesat.2:134 build/C/man2/linkat.2:198 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:145 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:173 build/C/man2/fstatat.2:188 build/C/man2/futimesat.2:141 build/C/man2/linkat.2:205 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:152 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.54 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
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:25 build/C/man2/fstatat.2:25 build/C/man2/linkat.2:25
463 #: build/C/man2/fchownat.2:29
465 "fchownat - change ownership of a file relative to a directory file "
470 #: build/C/man2/fchownat.2:36
473 "B<int fchownat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
474 "B< uid_t >I<owner>B<, gid_t >I<group>B<, int >I<flags>B<);>\n"
478 #: build/C/man2/fchownat.2:44
479 msgid "B<fchownat>():"
483 #: build/C/man2/fchownat.2:62
485 "The B<fchownat>() system call operates in exactly the same way as "
486 "B<chown>(2), except for the differences described in this manual page."
490 #: build/C/man2/fchownat.2:72
492 "If the pathname given in I<pathname> is relative, then it is interpreted "
493 "relative to the directory referred to by the file descriptor I<dirfd> "
494 "(rather than relative to the current working directory of the calling "
495 "process, as is done by B<chown>(2) for a relative pathname)."
499 #: build/C/man2/fchownat.2:84
501 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
502 "then I<pathname> is interpreted relative to the current working directory of "
503 "the calling process (like B<chown>(2))."
507 #: build/C/man2/fchownat.2:95
509 "The I<flags> argument is a bit mask created by ORing together 0 or more of "
510 "the following values;"
514 #: build/C/man2/fchownat.2:95 build/C/man2/fstatat.2:93 build/C/man2/linkat.2:100
516 msgid "B<AT_EMPTY_PATH> (since Linux 2.6.39)"
519 #. commit 65cfc6722361570bfe255698d9cd4dccaf47570d
521 #: build/C/man2/fchownat.2:109 build/C/man2/fstatat.2:107
523 "If I<pathname> is an empty string, operate on the file referred to by "
524 "I<dirfd> (which may have been obtained using the B<open>(2) B<O_PATH> "
525 "flag). In this case, I<dirfd> can refer to any type of file, not just a "
530 #: build/C/man2/fchownat.2:121
532 "If I<pathname> is a symbolic link, do not dereference it: instead operate on "
533 "the link itself, like B<lchown>(2). (By default, B<fchownat>() "
534 "dereferences symbolic links, like B<chown>(2).)"
538 #: build/C/man2/fchownat.2:128
540 "On success, B<fchownat>() returns 0. On error, -1 is returned and I<errno> "
541 "is set to indicate the error."
545 #: build/C/man2/fchownat.2:135
547 "The same errors that occur for B<chown>(2) can also occur for "
548 "B<fchownat>(). The following additional errors can occur for B<fchownat>():"
552 #: build/C/man2/fchownat.2:153
554 "B<fchownat>() was added to Linux in kernel 2.6.16; library support was "
555 "added to glibc in version 2.4."
559 #: build/C/man2/fchownat.2:156 build/C/man2/fstatat.2:166 build/C/man2/openat.2:132 build/C/man2/unlinkat.2:157
560 msgid "POSIX.1-2008. A similar system call exists on Solaris."
564 #: build/C/man2/fchownat.2:161
565 msgid "See B<openat>(2) for an explanation of the need for B<fchownat>()."
569 #: build/C/man2/fchownat.2:166
570 msgid "B<chown>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
574 #: build/C/man2/fstatat.2:25
580 #: build/C/man2/fstatat.2:28
581 msgid "fstatat - get file status relative to a directory file descriptor"
585 #: build/C/man2/fstatat.2:32 build/C/man2/mkdirat.2:32 build/C/man3/mkfifoat.3:33 build/C/man2/mknodat.2:33
588 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
589 "B<#include E<lt>sys/stat.hE<gt>>\n"
593 #: build/C/man2/fstatat.2:36
596 "B<int fstatat(int >I<dirfd>B<, const char *>I<pathname>B<, struct stat "
598 "B< int >I<flags>B<);>\n"
602 #: build/C/man2/fstatat.2:44
603 msgid "B<fstatat>():"
607 #: build/C/man2/fstatat.2:62
609 "The B<fstatat>() system call operates in exactly the same way as "
610 "B<stat>(2), except for the differences described in this manual page."
614 #: build/C/man2/fstatat.2:72
616 "If the pathname given in I<pathname> is relative, then it is interpreted "
617 "relative to the directory referred to by the file descriptor I<dirfd> "
618 "(rather than relative to the current working directory of the calling "
619 "process, as is done by B<stat>(2) for a relative pathname)."
623 #: build/C/man2/fstatat.2:84
625 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
626 "then I<pathname> is interpreted relative to the current working directory of "
627 "the calling process (like B<stat>(2))."
631 #: build/C/man2/fstatat.2:93
633 "I<flags> can either be 0, or include one or more of the following flags "
638 #: build/C/man2/fstatat.2:108
640 msgid "B<AT_NO_AUTOMOUNT> (since Linux 2.6.38)"
644 #: build/C/man2/fstatat.2:120
646 "Don't automount the terminal (\"basename\") component of I<pathname> if it "
647 "is a directory that is an automount point. This allows the caller to gather "
648 "attributes of an automount point (rather than the location it would mount). "
649 "This flag can be used in tools that scan directories to prevent "
650 "mass-automounting of a directory of automount points. The "
651 "B<AT_NO_AUTOMOUNT> flag has no effect if the mount point has already been "
656 #: build/C/man2/fstatat.2:131
658 "If I<pathname> is a symbolic link, do not dereference it: instead return "
659 "information about the link itself, like B<lstat>(2). (By default, "
660 "B<fstatat>() dereferences symbolic links, like B<stat>(2).)"
664 #: build/C/man2/fstatat.2:138
666 "On success, B<fstatat>() returns 0. On error, -1 is returned and I<errno> "
667 "is set to indicate the error."
671 #: build/C/man2/fstatat.2:145
673 "The same errors that occur for B<stat>(2) can also occur for B<fstatat>(). "
674 "The following additional errors can occur for B<fstatat>():"
678 #: build/C/man2/fstatat.2:163
680 "B<fstatat>() was added to Linux in kernel 2.6.16; library support was added "
681 "to glibc in version 2.4."
685 #: build/C/man2/fstatat.2:171
686 msgid "See B<openat>(2) for an explanation of the need for B<fstatat>()."
690 #: build/C/man2/fstatat.2:176
692 "The underlying system call employed by the glibc B<fstatat>() wrapper "
693 "function is actually called B<fstatat64>()."
697 #: build/C/man2/fstatat.2:181
698 msgid "B<openat>(2), B<stat>(2), B<path_resolution>(7), B<symlink>(7)"
702 #: build/C/man2/futimesat.2:25
708 #: build/C/man2/futimesat.2:25
714 #: build/C/man2/futimesat.2:29
716 "futimesat - change timestamps of a file relative to a directory file "
721 #: build/C/man2/futimesat.2:33
724 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
725 "B<#include E<lt>sys/time.hE<gt>>\n"
729 #: build/C/man2/futimesat.2:36
732 "B<int futimesat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
733 "B< const struct timeval >I<times>B<[2]);>\n"
737 #: build/C/man2/futimesat.2:45
738 msgid "B<futimesat>(): _GNU_SOURCE"
742 #: build/C/man2/futimesat.2:50
743 msgid "This system call is obsolete. Use B<utimensat>(2) instead."
747 #: build/C/man2/futimesat.2:56
749 "The B<futimesat>() system call operates in exactly the same way as "
750 "B<utimes>(2), except for the differences described in this manual page."
754 #: build/C/man2/futimesat.2:66
756 "If the pathname given in I<pathname> is relative, then it is interpreted "
757 "relative to the directory referred to by the file descriptor I<dirfd> "
758 "(rather than relative to the current working directory of the calling "
759 "process, as is done by B<utimes>(2) for a relative pathname)."
763 #: build/C/man2/futimesat.2:78
765 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
766 "then I<pathname> is interpreted relative to the current working directory of "
767 "the calling process (like B<utimes>(2))."
771 #: build/C/man2/futimesat.2:91
773 "On success, B<futimesat>() returns a 0. On error, -1 is returned and "
774 "I<errno> is set to indicate the error."
778 #: build/C/man2/futimesat.2:98
780 "The same errors that occur for B<utimes>(2) can also occur for "
781 "B<futimesat>(). The following additional errors can occur for "
786 #: build/C/man2/futimesat.2:112
788 "B<futimesat>() was added to Linux in kernel 2.6.16; library support was "
789 "added to glibc in version 2.4."
793 #: build/C/man2/futimesat.2:117
795 "This system call is nonstandard. It was implemented from a specification "
796 "that was proposed for POSIX.1, but that specification was replaced by the "
797 "one for B<utimensat>(2)."
801 #: build/C/man2/futimesat.2:119
802 msgid "A similar system call exists on Solaris."
805 #. The Solaris futimesat() also has this strangeness.
807 #: build/C/man2/futimesat.2:128
809 "If I<pathname> is NULL, then the glibc B<futimesat>() wrapper function "
810 "updates the times for the file referred to by I<dirfd>."
814 #: build/C/man2/futimesat.2:134
816 "B<stat>(2), B<utimensat>(2), B<utimes>(2), B<futimes>(3), "
817 "B<path_resolution>(7)"
821 #: build/C/man2/linkat.2:25
827 #: build/C/man2/linkat.2:28
828 msgid "linkat - create a file link relative to directory file descriptors"
832 #: build/C/man2/linkat.2:35
835 "B<int linkat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
836 "B< int >I<newdirfd>B<, const char *>I<newpath>B<, int "
841 #: build/C/man2/linkat.2:43
846 #: build/C/man2/linkat.2:61
848 "The B<linkat>() system call operates in exactly the same way as B<link>(2), "
849 "except for the differences described in this manual page."
853 #: build/C/man2/linkat.2:71
855 "If the pathname given in I<oldpath> is relative, then it is interpreted "
856 "relative to the directory referred to by the file descriptor I<olddirfd> "
857 "(rather than relative to the current working directory of the calling "
858 "process, as is done by B<link>(2) for a relative pathname)."
862 #: build/C/man2/linkat.2:83
864 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
865 "then I<oldpath> is interpreted relative to the current working directory of "
866 "the calling process (like B<link>(2))."
870 #: build/C/man2/linkat.2:89 build/C/man2/renameat.2:89
871 msgid "If I<oldpath> is absolute, then I<olddirfd> is ignored."
875 #: build/C/man2/linkat.2:97 build/C/man2/renameat.2:97
877 "The interpretation of I<newpath> is as for I<oldpath>, except that a "
878 "relative pathname is interpreted relative to the directory referred to by "
879 "the file descriptor I<newdirfd>."
883 #: build/C/man2/linkat.2:100
884 msgid "The following values can be bitwise ORed in I<flags>:"
887 #. commit 11a7b371b64ef39fc5fb1b6f2218eef7c4d035e3
889 #: build/C/man2/linkat.2:123
891 "If I<oldpath> is an empty string, create a link to the file referenced by "
892 "I<olddirfd> (which may have been obtained using the B<open>(2) B<O_PATH> "
893 "flag). In this case, I<olddirfd> can refer to any type of file, not just a "
894 "directory. The caller must have the B<CAP_DAC_READ_SEARCH> capability in "
895 "order to use this flag; this prevents arbitrary users from creating hard "
896 "links using file descriptors received via a UNIX domain socket (see the "
897 "discussion of B<SCM_RIGHTS> in B<unix>(7))."
901 #: build/C/man2/linkat.2:123
903 msgid "B<AT_SYMLINK_FOLLOW> (since Linux 2.6.18)"
907 #: build/C/man2/linkat.2:138
909 "By default, B<linkat>(), does not dereference I<oldpath> if it is a symbolic "
910 "link (like B<link>(2)). The flag B<AT_SYMLINK_FOLLOW> can be specified in "
911 "I<flags> to cause I<oldpath> to be dereferenced if it is a symbolic link."
915 #: build/C/man2/linkat.2:142
917 "Before kernel 2.6.18, the I<flags> argument was unused, and had to be "
922 #: build/C/man2/linkat.2:149
924 "On success, B<linkat>() returns 0. On error, -1 is returned and I<errno> "
925 "is set to indicate the error."
929 #: build/C/man2/linkat.2:156
931 "The same errors that occur for B<link>(2) can also occur for B<linkat>(). "
932 "The following additional errors can occur for B<linkat>():"
936 #: build/C/man2/linkat.2:162 build/C/man2/renameat.2:117
937 msgid "I<olddirfd> or I<newdirfd> is not a valid file descriptor."
941 #: build/C/man2/linkat.2:162
947 #: build/C/man2/linkat.2:170
949 "B<AT_EMPTY_PATH> was specified in I<flags>, but the caller did not have the "
950 "B<CAP_DAC_READ_SEARCH> capability."
954 #: build/C/man2/linkat.2:182 build/C/man2/renameat.2:127
956 "I<oldpath> is relative and I<olddirfd> is a file descriptor referring to a "
957 "file other than a directory; or similar for I<newpath> and I<newdirfd>"
961 #: build/C/man2/linkat.2:186
963 "B<linkat>() was added to Linux in kernel 2.6.16; library support was added "
964 "to glibc in version 2.4."
968 #: build/C/man2/linkat.2:193
969 msgid "See B<openat>(2) for an explanation of the need for B<linkat>()."
973 #: build/C/man2/linkat.2:198
974 msgid "B<link>(2), B<openat>(2), B<path_resolution>(7), B<symlink>(7)"
978 #: build/C/man2/mkdirat.2:25
984 #: build/C/man2/mkdirat.2:28
985 msgid "mkdirat - create a directory relative to a directory file descriptor"
989 #: build/C/man2/mkdirat.2:34
992 "B<int mkdirat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
997 #: build/C/man2/mkdirat.2:42
998 msgid "B<mkdirat>():"
1002 #: build/C/man2/mkdirat.2:60
1004 "The B<mkdirat>() system call operates in exactly the same way as "
1005 "B<mkdir>(2), except for the differences described in this manual page."
1009 #: build/C/man2/mkdirat.2:70
1011 "If the pathname given in I<pathname> is relative, then it is interpreted "
1012 "relative to the directory referred to by the file descriptor I<dirfd> "
1013 "(rather than relative to the current working directory of the calling "
1014 "process, as is done by B<mkdir>(2) for a relative pathname)."
1018 #: build/C/man2/mkdirat.2:82
1020 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1021 "then I<pathname> is interpreted relative to the current working directory of "
1022 "the calling process (like B<mkdir>(2))."
1026 #: build/C/man2/mkdirat.2:95
1028 "On success, B<mkdirat>() returns 0. On error, -1 is returned and I<errno> "
1029 "is set to indicate the error."
1033 #: build/C/man2/mkdirat.2:102
1035 "The same errors that occur for B<mkdir>(2) can also occur for "
1036 "B<mkdirat>(). The following additional errors can occur for B<mkdirat>():"
1040 #: build/C/man2/mkdirat.2:116
1042 "B<mkdirat>() was added to Linux in kernel 2.6.16; library support was added "
1043 "to glibc in version 2.4."
1047 #: build/C/man2/mkdirat.2:123
1048 msgid "See B<openat>(2) for an explanation of the need for B<mkdirat>()."
1052 #: build/C/man2/mkdirat.2:127
1053 msgid "B<mkdir>(2), B<openat>(2), B<path_resolution>(7)"
1057 #: build/C/man3/mkfifoat.3:26
1063 #: build/C/man3/mkfifoat.3:26
1069 #: build/C/man3/mkfifoat.3:29
1070 msgid "mkfifoat - make a FIFO (named pipe) relative to a directory file descriptor"
1074 #: build/C/man3/mkfifoat.3:35
1077 "B<int mkfifoat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
1082 #: build/C/man3/mkfifoat.3:43
1083 msgid "B<mkfifoat>():"
1087 #: build/C/man3/mkfifoat.3:61
1089 "The B<mkfifoat>() system call operates in exactly the same way as "
1090 "B<mkfifo>(3), except for the differences described in this manual page."
1094 #: build/C/man3/mkfifoat.3:71
1096 "If the pathname given in I<pathname> is relative, then it is interpreted "
1097 "relative to the directory referred to by the file descriptor I<dirfd> "
1098 "(rather than relative to the current working directory of the calling "
1099 "process, as is done by B<mkfifo>(3) for a relative pathname)."
1103 #: build/C/man3/mkfifoat.3:83
1105 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1106 "then I<pathname> is interpreted relative to the current working directory of "
1107 "the calling process (like B<mkfifo>(3))."
1111 #: build/C/man3/mkfifoat.3:96
1113 "On success, B<mkfifoat>() returns 0. On error, -1 is returned and I<errno> "
1114 "is set to indicate the error."
1118 #: build/C/man3/mkfifoat.3:103
1120 "The same errors that occur for B<mkfifo>(3) can also occur for "
1121 "B<mkfifoat>(). The following additional errors can occur for B<mkfifoat>():"
1125 #: build/C/man3/mkfifoat.3:113
1127 "I<pathname> is a relative path and I<dirfd> is a file descriptor referring "
1128 "to a file other than a directory."
1132 #: build/C/man3/mkfifoat.3:119
1134 "B<mkfifoat>() was added to glibc in version 2.4. It is implemented using "
1135 "B<mknod>(2), available on Linux since kernel 2.6.16."
1139 #: build/C/man3/mkfifoat.3:126
1140 msgid "See B<openat>(2) for an explanation of the need for B<mkfifoat>()."
1144 #: build/C/man3/mkfifoat.3:130
1145 msgid "B<openat>(2), B<mkfifo>(3), B<path_resolution>(7)"
1149 #: build/C/man2/mknodat.2:25
1155 #: build/C/man2/mknodat.2:29
1157 "mknodat - create a special or ordinary file relative to a directory file "
1162 #: build/C/man2/mknodat.2:36
1165 "B<int mknodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
1166 ">I<mode>B<, dev_t >I<dev>B<);>\n"
1170 #: build/C/man2/mknodat.2:44
1171 msgid "B<mknodat>():"
1174 #. Other FTM combinations will also expose mknodat(), but this function was
1175 #. added in SUSv4, marked XSI, so we'll just document what the standard says.
1177 #: build/C/man2/mknodat.2:52
1179 msgid " _XOPEN_SOURCE\\ E<gt>=\\ 700\n"
1183 #: build/C/man2/mknodat.2:64
1185 "The B<mknodat>() system call operates in exactly the same way as "
1186 "B<mknod>(2), except for the differences described in this manual page."
1190 #: build/C/man2/mknodat.2:74
1192 "If the pathname given in I<pathname> is relative, then it is interpreted "
1193 "relative to the directory referred to by the file descriptor I<dirfd> "
1194 "(rather than relative to the current working directory of the calling "
1195 "process, as is done by B<mknod>(2) for a relative pathname)."
1199 #: build/C/man2/mknodat.2:86
1201 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1202 "then I<pathname> is interpreted relative to the current working directory of "
1203 "the calling process (like B<mknod>(2))."
1207 #: build/C/man2/mknodat.2:99
1209 "On success, B<mknodat>() returns 0. On error, -1 is returned and I<errno> "
1210 "is set to indicate the error."
1214 #: build/C/man2/mknodat.2:106
1216 "The same errors that occur for B<mknod>(2) can also occur for "
1217 "B<mknodat>(). The following additional errors can occur for B<mknodat>():"
1221 #: build/C/man2/mknodat.2:120
1223 "B<mknodat>() was added to Linux in kernel 2.6.16; library support was added "
1224 "to glibc in version 2.4."
1228 #: build/C/man2/mknodat.2:127
1229 msgid "See B<openat>(2) for an explanation of the need for B<mknodat>()."
1233 #: build/C/man2/mknodat.2:131
1234 msgid "B<mknod>(2), B<openat>(2), B<path_resolution>(7)"
1238 #: build/C/man2/openat.2:25
1244 #: build/C/man2/openat.2:28
1245 msgid "openat - open a file relative to a directory file descriptor"
1249 #: build/C/man2/openat.2:31
1251 msgid "B<#include E<lt>fcntl.hE<gt>>\n"
1255 #: build/C/man2/openat.2:35
1258 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1260 "B<int openat(int >I<dirfd>B<, const char *>I<pathname>B<, int >I<flags>B<, "
1261 "mode_t >I<mode>B<);>\n"
1265 #: build/C/man2/openat.2:43
1266 msgid "B<openat>():"
1270 #: build/C/man2/openat.2:61
1272 "The B<openat>() system call operates in exactly the same way as B<open>(2), "
1273 "except for the differences described in this manual page."
1277 #: build/C/man2/openat.2:71
1279 "If the pathname given in I<pathname> is relative, then it is interpreted "
1280 "relative to the directory referred to by the file descriptor I<dirfd> "
1281 "(rather than relative to the current working directory of the calling "
1282 "process, as is done by B<open>(2) for a relative pathname)."
1286 #: build/C/man2/openat.2:83
1288 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1289 "then I<pathname> is interpreted relative to the current working directory of "
1290 "the calling process (like B<open>(2))."
1294 #: build/C/man2/openat.2:96
1296 "On success, B<openat>() returns a new file descriptor. On error, -1 is "
1297 "returned and I<errno> is set to indicate the error."
1301 #: build/C/man2/openat.2:103
1303 "The same errors that occur for B<open>(2) can also occur for B<openat>(). "
1304 "The following additional errors can occur for B<openat>():"
1308 #: build/C/man2/openat.2:117
1310 "B<openat>() was added to Linux in kernel 2.6.16; library support was added "
1311 "to glibc in version 2.4."
1315 #: build/C/man2/openat.2:136
1317 "B<openat>() and other similar system calls suffixed \"at\" are supported "
1322 #: build/C/man2/openat.2:154
1324 "First, B<openat>() allows an application to avoid race conditions that "
1325 "could occur when using B<open>(2) to open files in directories other than "
1326 "the current working directory. These race conditions result from the fact "
1327 "that some component of the directory prefix given to B<open>(2) could be "
1328 "changed in parallel with the call to B<open>(2). Such races can be avoided "
1329 "by opening a file descriptor for the target directory, and then specifying "
1330 "that file descriptor as the I<dirfd> argument of B<openat>()."
1334 #: build/C/man2/openat.2:163
1336 "Second, B<openat>() allows the implementation of a per-thread \"current "
1337 "working directory\", via file descriptor(s) maintained by the application. "
1338 "(This functionality can also be obtained by tricks based on the use of "
1339 "I</proc/self/fd/>dirfd, but less efficiently.)"
1343 #: build/C/man2/openat.2:180
1345 "B<faccessat>(2), B<fchmodat>(2), B<fchownat>(2), B<fstatat>(2), "
1346 "B<futimesat>(2), B<linkat>(2), B<mkdirat>(2), B<mknodat>(2), B<open>(2), "
1347 "B<readlinkat>(2), B<renameat>(2), B<symlinkat>(2), B<unlinkat>(2), "
1348 "B<utimensat>(2), B<mkfifoat>(3), B<path_resolution>(7)"
1352 #: build/C/man2/readlinkat.2:25
1358 #: build/C/man2/readlinkat.2:25
1364 #: build/C/man2/readlinkat.2:29
1366 "readlinkat - read value of a symbolic link relative to a directory file "
1371 #: build/C/man2/readlinkat.2:36
1374 "B<int readlinkat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
1375 "B< char *>I<buf>B<, size_t >I<bufsiz>B<);>\n"
1379 #: build/C/man2/readlinkat.2:44
1380 msgid "B<readlinkat>():"
1384 #: build/C/man2/readlinkat.2:62
1386 "The B<readlinkat>() system call operates in exactly the same way as "
1387 "B<readlink>(2), except for the differences described in this manual page."
1391 #: build/C/man2/readlinkat.2:72
1393 "If the pathname given in I<pathname> is relative, then it is interpreted "
1394 "relative to the directory referred to by the file descriptor I<dirfd> "
1395 "(rather than relative to the current working directory of the calling "
1396 "process, as is done by B<readlink>(2) for a relative pathname)."
1400 #: build/C/man2/readlinkat.2:84
1402 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
1403 "then I<pathname> is interpreted relative to the current working directory of "
1404 "the calling process (like B<readlink>(2))."
1407 #. commit 65cfc6722361570bfe255698d9cd4dccaf47570d
1409 #: build/C/man2/readlinkat.2:104
1411 "Since Linux 2.6.39, I<pathname> can be an empty string, in which case the "
1412 "call operates on the file referred to by I<dirfd> (which may have been "
1413 "obtained using the B<open>(2) B<O_PATH> flag). In this case, I<dirfd> can "
1414 "refer to any type of file, not just a directory."
1418 #: build/C/man2/readlinkat.2:113
1420 "On success, B<readlinkat>() returns the number of bytes placed in I<buf>. "
1421 "On error, -1 is returned and I<errno> is set to indicate the error."
1425 #: build/C/man2/readlinkat.2:120
1427 "The same errors that occur for B<readlink>(2) can also occur for "
1428 "B<readlinkat>(). The following additional errors can occur for "
1433 #: build/C/man2/readlinkat.2:134
1435 "B<readlinkat>() was added to Linux in kernel 2.6.16; library support was "
1436 "added to glibc in version 2.4."
1440 #: build/C/man2/readlinkat.2:141
1441 msgid "See B<openat>(2) for an explanation of the need for B<readlinkat>()."
1445 #: build/C/man2/readlinkat.2:145
1446 msgid "B<openat>(2), B<readlink>(2), B<path_resolution>(7)"
1450 #: build/C/man2/renameat.2:25
1456 #: build/C/man2/renameat.2:28
1457 msgid "renameat - rename a file relative to directory file descriptors"
1461 #: build/C/man2/renameat.2:32
1464 "B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
1465 "B<#include E<lt>stdio.hE<gt>>\n"
1469 #: build/C/man2/renameat.2:35
1472 "B<int renameat(int >I<olddirfd>B<, const char *>I<oldpath>B<,>\n"
1473 "B< int >I<newdirfd>B<, const char *>I<newpath>B<);>\n"
1477 #: build/C/man2/renameat.2:43
1478 msgid "B<renameat>():"
1482 #: build/C/man2/renameat.2:61
1484 "The B<renameat>() system call operates in exactly the same way as "
1485 "B<rename>(2), except for the differences described in this manual page."
1489 #: build/C/man2/renameat.2:71
1491 "If the pathname given in I<oldpath> is relative, then it is interpreted "
1492 "relative to the directory referred to by the file descriptor I<olddirfd> "
1493 "(rather than relative to the current working directory of the calling "
1494 "process, as is done by B<rename>(2) for a relative pathname)."
1498 #: build/C/man2/renameat.2:83
1500 "If I<oldpath> is relative and I<olddirfd> is the special value B<AT_FDCWD>, "
1501 "then I<oldpath> is interpreted relative to the current working directory of "
1502 "the calling process (like B<rename>(2))."
1506 #: build/C/man2/renameat.2:104
1508 "On success, B<renameat>() returns 0. On error, -1 is returned and I<errno> "
1509 "is set to indicate the error."
1513 #: build/C/man2/renameat.2:111
1515 "The same errors that occur for B<rename>(2) can also occur for "
1516 "B<renameat>(). The following additional errors can occur for B<renameat>():"
1520 #: build/C/man2/renameat.2:131
1522 "B<renameat>() was added to Linux in kernel 2.6.16; library support was "
1523 "added to glibc in version 2.4."
1527 #: build/C/man2/renameat.2:138
1528 msgid "See B<openat>(2) for an explanation of the need for B<renameat>()."
1532 #: build/C/man2/renameat.2:142
1533 msgid "B<openat>(2), B<rename>(2), B<path_resolution>(7)"
1537 #: build/C/man2/symlinkat.2:25
1543 #: build/C/man2/symlinkat.2:28
1544 msgid "symlinkat - create a symbolic link relative to a directory file descriptor"
1548 #: build/C/man2/symlinkat.2:35
1551 "B<int symlinkat(const char *>I<oldpath>B<, int >I<newdirfd>B<, const char "
1552 "*>I<newpath>B<);>\n"
1556 #: build/C/man2/symlinkat.2:43
1557 msgid "B<symlinkat>():"
1561 #: build/C/man2/symlinkat.2:61
1563 "The B<symlinkat>() system call operates in exactly the same way as "
1564 "B<symlink>(2), except for the differences described in this manual page."
1568 #: build/C/man2/symlinkat.2:71
1570 "If the pathname given in I<newpath> is relative, then it is interpreted "
1571 "relative to the directory referred to by the file descriptor I<newdirfd> "
1572 "(rather than relative to the current working directory of the calling "
1573 "process, as is done by B<symlink>(2) for a relative pathname)."
1577 #: build/C/man2/symlinkat.2:83
1579 "If I<newpath> is relative and I<newdirfd> is the special value B<AT_FDCWD>, "
1580 "then I<newpath> is interpreted relative to the current working directory of "
1581 "the calling process (like B<symlink>(2))."
1585 #: build/C/man2/symlinkat.2:89
1586 msgid "If I<newpath> is absolute, then I<newdirfd> is ignored."
1590 #: build/C/man2/symlinkat.2:96
1592 "On success, B<symlinkat>() returns 0. On error, -1 is returned and "
1593 "I<errno> is set to indicate the error."
1597 #: build/C/man2/symlinkat.2:103
1599 "The same errors that occur for B<symlink>(2) can also occur for "
1600 "B<symlinkat>(). The following additional errors can occur for "
1605 #: build/C/man2/symlinkat.2:107
1606 msgid "I<newdirfd> is not a valid file descriptor."
1610 #: build/C/man2/symlinkat.2:113
1612 "I<newpath> is relative and I<newdirfd> is a file descriptor referring to a "
1613 "file other than a directory."
1617 #: build/C/man2/symlinkat.2:117
1619 "B<symlinkat>() was added to Linux in kernel 2.6.16; library support was "
1620 "added to glibc in version 2.4."
1624 #: build/C/man2/symlinkat.2:124
1625 msgid "See B<openat>(2) for an explanation of the need for B<symlinkat>()."
1629 #: build/C/man2/symlinkat.2:129
1630 msgid "B<openat>(2), B<symlink>(2), B<path_resolution>(7), B<symlink>(7)"
1634 #: build/C/man2/unlinkat.2:25
1640 #: build/C/man2/unlinkat.2:28
1641 msgid "unlinkat - remove a directory entry relative to a directory file descriptor"
1645 #: build/C/man2/unlinkat.2:34
1648 "B<int unlinkat(int >I<dirfd>B<, const char *>I<pathname>B<, int "
1653 #: build/C/man2/unlinkat.2:42
1654 msgid "B<unlinkat>():"
1658 #: build/C/man2/unlinkat.2:67
1660 "The B<unlinkat>() system call operates in exactly the same way as either "
1661 "B<unlink>(2) or B<rmdir>(2) (depending on whether or not I<flags> includes "
1662 "the B<AT_REMOVEDIR> flag) except for the differences described in this "
1667 #: build/C/man2/unlinkat.2:79
1669 "If the pathname given in I<pathname> is relative, then it is interpreted "
1670 "relative to the directory referred to by the file descriptor I<dirfd> "
1671 "(rather than relative to the current working directory of the calling "
1672 "process, as is done by B<unlink>(2) and B<rmdir>(2) for a relative "
1677 #: build/C/man2/unlinkat.2:93
1679 "If the pathname given in I<pathname> is relative and I<dirfd> is the special "
1680 "value B<AT_FDCWD>, then I<pathname> is interpreted relative to the current "
1681 "working directory of the calling process (like B<unlink>(2) and "
1686 #: build/C/man2/unlinkat.2:99
1687 msgid "If the pathname given in I<pathname> is absolute, then I<dirfd> is ignored."
1691 #: build/C/man2/unlinkat.2:105
1693 "I<flags> is a bit mask that can either be specified as 0, or by ORing "
1694 "together flag values that control the operation of B<unlinkat>(). Currently "
1695 "only one such flag is defined:"
1699 #: build/C/man2/unlinkat.2:105
1701 msgid "B<AT_REMOVEDIR>"
1705 #: build/C/man2/unlinkat.2:120
1707 "By default, B<unlinkat>() performs the equivalent of B<unlink>(2) on "
1708 "I<pathname>. If the B<AT_REMOVEDIR> flag is specified, then performs the "
1709 "equivalent of B<rmdir>(2) on I<pathname>."
1713 #: build/C/man2/unlinkat.2:127
1715 "On success, B<unlinkat>() returns 0. On error, -1 is returned and I<errno> "
1716 "is set to indicate the error."
1720 #: build/C/man2/unlinkat.2:136
1722 "The same errors that occur for B<unlink>(2) and B<rmdir>(2) can also occur "
1723 "for B<unlinkat>(). The following additional errors can occur for "
1728 #: build/C/man2/unlinkat.2:144
1729 msgid "An invalid flag value was specified in I<flags>."
1733 #: build/C/man2/unlinkat.2:154
1735 "B<unlinkat>() was added to Linux in kernel 2.6.16; library support was "
1736 "added to glibc in version 2.4."
1740 #: build/C/man2/unlinkat.2:162
1741 msgid "See B<openat>(2) for an explanation of the need for B<unlinkat>()."
1745 #: build/C/man2/unlinkat.2:167
1746 msgid "B<openat>(2), B<rmdir>(2), B<unlink>(2), B<path_resolution>(7)"