#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:53+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man2/access.2:43 #, no-wrap msgid "ACCESS" msgstr "" #. type: TH #: man-pages/man2/access.2:43 #, no-wrap msgid "2014-02-21" msgstr "" #. type: TH #: man-pages/man2/access.2:43 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/access.2:43 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/access.2:44 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/access.2:46 msgid "access, faccessat - check user's permissions for a file" msgstr "" #. type: SH #: man-pages/man2/access.2:46 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/access.2:49 #, no-wrap msgid "B<#include Eunistd.hE>\n" msgstr "" #. type: Plain text #: man-pages/man2/access.2:51 #, no-wrap msgid "BIB<, int >IB<);>\n" msgstr "" #. type: Plain text #: man-pages/man2/access.2:54 #, no-wrap msgid "" "B<#include Efcntl.hE >/* Definition of AT_* constants */\n" "B<#include Eunistd.hE>\n" msgstr "" #. type: Plain text #: man-pages/man2/access.2:57 #, no-wrap msgid "" "BIB<, const char *>IB<, int >IB<, " "int >IB<);>\n" msgstr "" #. type: Plain text #: man-pages/man2/access.2:62 msgid "" "Feature Test Macro Requirements for glibc (see B(7)):" msgstr "" #. type: Plain text #: man-pages/man2/access.2:65 msgid "B():" msgstr "" #. type: TP #: man-pages/man2/access.2:68 #, no-wrap msgid "Since glibc 2.10:" msgstr "" #. type: Plain text #: man-pages/man2/access.2:71 msgid "_XOPEN_SOURCE\\ E=\\ 700 || _POSIX_C_SOURCE\\ E=\\ 200809L" msgstr "" #. type: TP #: man-pages/man2/access.2:71 #, no-wrap msgid "Before glibc 2.10:" msgstr "" #. type: Plain text #: man-pages/man2/access.2:74 msgid "_ATFILE_SOURCE" msgstr "" #. type: SH #: man-pages/man2/access.2:78 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/access.2:85 msgid "" "B() checks whether the calling process can access the file " "I. If I is a symbolic link, it is dereferenced." msgstr "" #. F_OK is defined as 0 on every system that I know of. #. type: Plain text #: man-pages/man2/access.2:99 msgid "" "The I specifies the accessibility check(s) to be performed, and is " "either the value B, or a mask consisting of the bitwise OR of one or " "more of B, B, and B. B tests for the existence of " "the file. B, B, and B test whether the file exists and " "grants read, write, and execute permissions, respectively." msgstr "" #. type: Plain text #: man-pages/man2/access.2:108 msgid "" "The check is done using the calling process's I UID and GID, rather " "than the effective IDs as is done when actually attempting an operation (e.g." ", B(2)) on the file. This allows set-user-ID programs to easily " "determine the invoking user's authority." msgstr "" #. type: Plain text #: man-pages/man2/access.2:114 msgid "" "If the calling process is privileged (i.e., its real UID is zero), then an " "B check is successful for a regular file if execute permission is " "enabled for any of the file owner, group, or other." msgstr "" #. type: SS #: man-pages/man2/access.2:114 #, no-wrap msgid "faccessat()" msgstr "" #. type: Plain text #: man-pages/man2/access.2:120 msgid "" "The B() system call operates in exactly the same way as " "B(), except for the differences described here." msgstr "" #. type: Plain text #: man-pages/man2/access.2:130 msgid "" "If the pathname given in I is relative, then it is interpreted " "relative to the directory referred to by the file descriptor I " "(rather than relative to the current working directory of the calling " "process, as is done by B() for a relative pathname)." msgstr "" #. type: Plain text #: man-pages/man2/access.2:142 msgid "" "If I is relative and I is the special value B, " "then I is interpreted relative to the current working directory of " "the calling process (like B())." msgstr "" #. type: Plain text #: man-pages/man2/access.2:148 msgid "If I is absolute, then I is ignored." msgstr "" #. type: Plain text #: man-pages/man2/access.2:151 msgid "" "I is constructed by ORing together zero or more of the following " "values:" msgstr "" #. type: TP #: man-pages/man2/access.2:151 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:158 msgid "" "Perform access checks using the effective user and group IDs. By default, " "B() uses the real IDs (like B())." msgstr "" #. type: TP #: man-pages/man2/access.2:158 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:164 msgid "" "If I is a symbolic link, do not dereference it: instead return " "information about the link itself." msgstr "" #. type: Plain text #: man-pages/man2/access.2:169 msgid "See B(2) for an explanation of the need for B()." msgstr "" #. type: SH #: man-pages/man2/access.2:169 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/access.2:185 msgid "" "On success (all requested permissions granted, or I is B and the " "file exists), zero is returned. On error (at least one bit in I asked " "for a permission that is denied, or I is B and the file does not " "exist, or some other error occurred), -1 is returned, and I is set " "appropriately." msgstr "" #. type: SH #: man-pages/man2/access.2:185 #, no-wrap msgid "ERRORS" msgstr "" #. type: Plain text #: man-pages/man2/access.2:190 msgid "B() and B() shall fail if:" msgstr "" #. type: TP #: man-pages/man2/access.2:190 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:197 msgid "" "The requested access would be denied to the file, or search permission is " "denied for one of the directories in the path prefix of I. (See " "also B(7).)" msgstr "" #. type: TP #: man-pages/man2/access.2:197 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:201 msgid "Too many symbolic links were encountered in resolving I." msgstr "" #. type: TP #: man-pages/man2/access.2:201 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:205 msgid "I is too long." msgstr "" #. type: TP #: man-pages/man2/access.2:205 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:210 msgid "" "A component of I does not exist or is a dangling symbolic link." msgstr "" #. type: TP #: man-pages/man2/access.2:210 man-pages/man2/access.2:252 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:215 msgid "" "A component used as a directory in I is not, in fact, a directory." msgstr "" #. type: TP #: man-pages/man2/access.2:215 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:218 msgid "Write permission was requested for a file on a read-only filesystem." msgstr "" #. type: Plain text #: man-pages/man2/access.2:223 msgid "B() and B() may fail if:" msgstr "" #. type: TP #: man-pages/man2/access.2:223 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:227 msgid "I points outside your accessible address space." msgstr "" #. type: TP #: man-pages/man2/access.2:227 man-pages/man2/access.2:248 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:231 msgid "I was incorrectly specified." msgstr "" #. type: TP #: man-pages/man2/access.2:231 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:234 msgid "An I/O error occurred." msgstr "" #. type: TP #: man-pages/man2/access.2:234 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:237 msgid "Insufficient kernel memory was available." msgstr "" #. type: TP #: man-pages/man2/access.2:237 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:241 msgid "Write access was requested to an executable which is being executed." msgstr "" #. type: Plain text #: man-pages/man2/access.2:244 msgid "The following additional errors can occur for B():" msgstr "" #. type: TP #: man-pages/man2/access.2:244 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/access.2:248 msgid "I is not a valid file descriptor." msgstr "" #. type: Plain text #: man-pages/man2/access.2:252 msgid "Invalid flag specified in I." msgstr "" #. type: Plain text #: man-pages/man2/access.2:258 msgid "" "I is relative and I is a file descriptor referring to a " "file other than a directory." msgstr "" #. type: SH #: man-pages/man2/access.2:258 #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: man-pages/man2/access.2:262 msgid "" "B() was added to Linux in kernel 2.6.16; library support was " "added to glibc in version 2.4." msgstr "" #. type: SH #: man-pages/man2/access.2:262 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/access.2:265 msgid "B(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008." msgstr "" #. type: Plain text #: man-pages/man2/access.2:268 msgid "B(): POSIX.1-2008." msgstr "" #. type: SH #: man-pages/man2/access.2:268 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: man-pages/man2/access.2:281 msgid "" "B: Using these calls to check if a user is authorized to, for " "example, open a file before actually doing so using B(2) creates a " "security hole, because the user might exploit the short time interval " "between checking and opening the file to manipulate it. B. (In the example just " "described, a safer alternative would be to temporarily switch the process's " "effective user ID to the real ID and then call B(2).)" msgstr "" #. type: Plain text #: man-pages/man2/access.2:288 msgid "" "B() always dereferences symbolic links. If you need to check the " "permissions on a symbolic link, use B(2) with the flag " "B." msgstr "" #. type: Plain text #: man-pages/man2/access.2:294 msgid "" "These calls return an error if any of the access types in I is denied, " "even if some of the other access types in I are permitted." msgstr "" #. HPU-UX 11 and Tru64 5.1 do this. #. type: Plain text #: man-pages/man2/access.2:301 msgid "" "If the calling process has appropriate privileges (i.e., is superuser), " "POSIX.1-2001 permits an implementation to indicate success for an B " "check even if none of the execute file permission bits are set. Linux does " "not do this." msgstr "" #. type: Plain text #: man-pages/man2/access.2:309 msgid "" "A file is accessible only if the permissions on each of the directories in " "the path prefix of I grant search (i.e., execute) access. If any " "directory is inaccessible, then the B() call will fail, regardless " "of the permissions on the file itself." msgstr "" #. type: Plain text #: man-pages/man2/access.2:317 msgid "" "Only access bits are checked, not the file type or contents. Therefore, if " "a directory is found to be writable, it probably means that files can be " "created in the directory, and not that the directory can be written as a " "file. Similarly, a DOS file may be found to be \"executable,\" but the " "B(2) call will still fail." msgstr "" #. type: Plain text #: man-pages/man2/access.2:326 msgid "" "These calls may not work correctly on NFSv2 filesystems with UID mapping " "enabled, because UID mapping is done on the server and hidden from the " "client, which checks permissions. (NFS versions 3 and higher perform the " "check on the server.) Similar problems can occur to FUSE mounts." msgstr "" #. type: SS #: man-pages/man2/access.2:326 #, no-wrap msgid "faccessat ()" msgstr "" #. type: Plain text #: man-pages/man2/access.2:339 msgid "" "The raw B() system call takes only the first three arguments. " "The B and B flags are actually implemented " "within the glibc wrapper function for B(). If either of these " "flags is specified, then the wrapper function employs B(2) to " "determine access permissions." msgstr "" #. type: SH #: man-pages/man2/access.2:339 #, no-wrap msgid "BUGS" msgstr "" #. This behavior appears to have been an implementation accident. #. type: Plain text #: man-pages/man2/access.2:362 msgid "" "In kernel 2.4 (and earlier) there is some strangeness in the handling of " "B tests for superuser. If all categories of execute permission are " "disabled for a nondirectory file, then the only B() test that " "returns -1 is when I is specified as just B; if B or " "B is also specified in I, then B() returns 0 for such " "files. Early 2.6 kernels (up to and including 2.6.3) also behaved in the " "same way as kernel 2.4." msgstr "" #. type: Plain text #: man-pages/man2/access.2:372 msgid "" "In kernels before 2.6.20, these calls ignored the effect of the B " "flag if it was used to B(2) the underlying filesystem. Since kernel " "2.6.20, the B is honored" msgstr "" #. type: SH #: man-pages/man2/access.2:372 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/access.2:383 msgid "" "B(2), B(2), B(2), B(2), B(2), " "B(2), B(3), B(7), B(7), " "B(7)" msgstr "" #. type: SH #: man-pages/man2/access.2:383 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/access.2:391 msgid "" "This page is part of release 3.70 of the Linux I project. A " "description of the project, information about reporting bugs, and the latest " "version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/" "." msgstr ""