.\" -*- coding: UTF-8 -*- .\" This manpage is Copyright (C) 1992 Drew Eckhardt; .\" and Copyright (C) 1993 Michael Haardt, Ian Jackson. .\" and Copyright (C) 2004, 2006, 2007, 2014 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1993-07-21 Rik Faith (faith@cs.unc.edu) .\" Modified 1994-08-21 by Michael Chastain (mec@shell.portal.com): .\" Removed note about old kernel (pre-1.1.44) using wrong id on path. .\" Modified 1996-03-18 by Martin Schulze (joey@infodrom.north.de): .\" Stated more clearly how it behaves with symbolic links. .\" Added correction due to Nick Duffek (nsd@bbc.com), aeb, 960426 .\" Modified 1996-09-07 by Michael Haardt: .\" Restrictions for NFS .\" Modified 1997-09-09 by Joseph S. Myers .\" Modified 1998-01-13 by Michael Haardt: .\" Using access is often insecure .\" Modified 2001-10-16 by aeb .\" Modified 2002-04-23 by Roger Luethi .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH access 2 "5 февраля 2023 г." "Linux man\-pages 6.03" .SH ИМЯ access, faccessat, faccessat2 \- проверить права доступа пользователя к файлу .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint access(const char *\fP\fIpathname\fP\fB, int \fP\fImode\fP\fB);\fP .PP \fB#include \fP /* определения констант \fBAT_*\fP */ \fB#include \fP .PP \fBint faccessat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB, int \fP\fImode\fP\fB, int \fP\fIflags\fP\fB);\fP /* But see C library/kernel differences, below */ .PP \fB#include \fP /* определения констант \fBAT_*\fP */ \fB#include \fP /* определения констант \fBSYS_*\fP */ \fB#include \fP .PP \fBint syscall(SYS_faccessat2,\fP \fB int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB, int \fP\fImode\fP\fB, int \fP\fIflags\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBfaccessat\fP(): .nf Since glibc 2.10: _POSIX_C_SOURCE >= 200809L Before glibc 2.10: _ATFILE_SOURCE .fi .SH ОПИСАНИЕ \fBaccess\fP проверяет, имеет ли вызвавший процесс права доступа к файлу \fIpathname\fP. Если \fIpathname\fP является символьной ссылкой, то проверяются права доступа к файлу, на который она ссылается. .PP .\" F_OK is defined as 0 on every system that I know of. Аргумент \fImode\fP \(em это маска выполняемых проверок доступа; может быть равна значению \fBF_OK\fP, или состоять из одного или несколько побитово сложенных \fBR_OK\fP, \fBW_OK\fP и \fBX_OK\fP. \fBF_OK\fP проверяет существование файла. \fBR_OK\fP, \fBW_OK\fP и \fBX_OK\fP запрашивают проверку, соответственно, существования файла и возможности его чтения, записи или выполнения. .PP Проверка осуществляется с использованием \fIреального\fP, а не эффективного идентификатора пользователя (UID) и группы (GID) вызвавшего процесса. Эффективные идентификаторы будут использоваться при действительной попытке выполнения той или иной операции с файлом (например, \fBopen\fP(2)). Аналогичным образом, для пользователя root, при проверке используется набор разрешающих мандатов, а не набор эффективных мандатов; для не root\-пользователей при проверке используется пустой набор мандатов. .PP Это дает программам с set\-user\-ID или снабжённых мандатами простой способ проверить права доступа вызвавшего пользователя. Другими словами, \fBaccess\fP() не отвечает на вопрос «могу я прочитать/записать/выполнить этот файл?». Он отвечает на немного другой вопрос: «(предположим я исполняемый файл с setuid) может ли \fIпользователь, запустивший меня\fP прочитать/записать/выполнить этот файл?», что даёт программам с set\-user\-ID возможность не дать злонамеренным пользователям прочитать файлы, которые пользователи не должны читать. .PP Если вызвавший процесс имеет соответствующие привилегии (например, его реальный UID равен нулю), то проверка \fBX_OK\fP пройдёт успешно для обычного файла, если у него установлено право на выполнение в любой группе бит: у владельца, группы или остальных. .SS faccessat() \fBfaccessat\fP() работает также как системный вызов \fBaccess\fP(), за исключением случаев, описанных здесь. .PP Если в \fIpathname\fP задан относительный путь, то он считается относительно каталога, на который ссылается файловый дескриптор \fIdirfd\fP (а не относительно текущего рабочего каталога вызывающего процесса, как это делается в \fBaccess\fP()). .PP Если в \fIpathname\fP задан относительный путь и \fIdirfd\fP равно специальному значению \fBAT_FDCWD\fP, то \fIpathname\fP рассматривается относительно текущего рабочего каталога вызывающего процесса (как \fBaccess\fP()). .PP Если в \fIpathname\fP задан абсолютный путь, то \fIdirfd\fP игнорируется. .PP Значение \fIflags\fP составляется из побитово сложенных следующих значений: .TP \fBAT_EACCESS\fP Выполнять проверку, доступа используя эффективный идентификатор пользователя и группы. По умолчанию в \fBfaccessat\fP() используются реальные идентификаторы (как в \fBaccess\fP()). .TP \fBAT_SYMLINK_NOFOLLOW\fP Если значение \fIpathname\fP является символьной ссылкой, не разыменовывать её, а выдать информацию о самой ссылке. .PP .\" Смотрите в \fBopenat\fP(2) объяснение необходимости \fBfaccessat\fP(). .SS faccessat2() The description of \fBfaccessat\fP() given above corresponds to POSIX.1 and to the implementation provided by glibc. However, the glibc implementation was an imperfect emulation (see BUGS) that papered over the fact that the raw Linux \fBfaccessat\fP() system call does not have a \fIflags\fP argument. To allow for a proper implementation, Linux 5.8 added the \fBfaccessat2\fP() system call, which supports the \fIflags\fP argument and allows a correct implementation of the \fBfaccessat\fP() wrapper function. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success (all requested permissions granted, or \fImode\fP is \fBF_OK\fP and the file exists), zero is returned. On error (at least one bit in \fImode\fP asked for a permission that is denied, or \fImode\fP is \fBF_OK\fP and the file does not exist, or some other error occurred), \-1 is returned, and \fIerrno\fP is set to indicate the error. .SH ОШИБКИ .TP \fBEACCES\fP Запрошенный тип доступа не удовлетворён или в одном из каталогов в \fIpathname\fP не разрешён поиск. (См. также \fBpath_resolution\fP(7).) .TP \fBEBADF\fP (\fBfaccessat\fP()) \fIpathname\fP is relative but \fIdirfd\fP is neither \fBAT_FDCWD\fP (\fBfaccessat\fP()) nor a valid file descriptor. .TP \fBEFAULT\fP Аргумент \fIpathname\fP указывает за пределы доступного адресного пространства. .TP \fBEINVAL\fP Аргумент \fImode\fP был задан неверно. .TP \fBEINVAL\fP (\fBfaccessat\fP()) Указано неверное значение в \fIflags\fP. .TP \fBEIO\fP Произошла ошибка ввода\-вывода. .TP \fBELOOP\fP Во время определения \fIpathname\fP встретилось слишком много символьных ссылок. .TP \fBENAMETOOLONG\fP Слишком длинное значение аргумента \fIpathname\fP. .TP \fBENOENT\fP Компонент пути \fIpathname\fP не существует или является повисшей символьной ссылкой. .TP \fBENOMEM\fP Недостаточное количество памяти ядра. .TP \fBENOTDIR\fP Компонент пути, использованный как каталог в \fIpathname\fP, в действительности таковым не является. .TP \fBENOTDIR\fP (\fBfaccessat\fP()) Значение \fIpathname\fP содержит относительный путь и \fIdirfd\fP содержит файловый дескриптор, указывающий на файл, а не на каталог. .TP \fBEPERM\fP Write permission was requested to a file that has the immutable flag set. See also \fBioctl_iflags\fP(2). .TP \fBEROFS\fP Запрошено право на запись в файл, расположенный в файловой системе, доступной только для чтения. .TP \fBETXTBSY\fP Запрошены права на запись для исполняемого файла, который сейчас выполняется. .SH ВЕРСИИ \fBfaccessat\fP() was added in Linux 2.6.16; library support was added in glibc 2.4. .PP \fBfaccessat2\fP() was added in Linux 5.8. .SH СТАНДАРТЫ \fBaccess\fP(): SVr4, 4.3BSD, POSIX.1\-2001, POSIX.1\-2008. .PP \fBfaccessat\fP(): POSIX.1\-2008. .PP \fBfaccessat2\fP(): Linux\-specific. .SH ЗАМЕЧАНИЯ \fBПредупреждение\fP: Использование этих вызовов для проверки, например, разрешено ли пользователю открытие файла перед реальным выполнением \fBopen\fP(2), создаёт брешь в безопасности, так как пользователь может использовать короткий промежуток времени между проверкой и открытием файла для управления им. \fBПо этой причине лучше избегать использования данного системного вызова\fP (в только что описанном примере, безопасной альтернативой будет временное переключение эффективного пользовательского идентификатора процесса на реальный идентификатор и вызов \fBopen\fP(2)). .PP Вызов \fBaccess\fP() всегда разыменовывает символьные ссылки. Если вам нужно проверить права символьной ссылки, используйте вызов \fBfaccessat\fP() с флагом \fBAT_SYMLINK_NOFOLLOW\fP. .PP Эти вызовы возвращают ошибку, если отказано в любом из типов доступа \fImode\fP, даже если разрешены остальные типы. .PP .\" HPU-UX 11 and Tru64 5.1 do this. Если вызывающий процесс имеет соответствующие привилегии (например, суперпользователя), то POSIX.1\-2001 разрешает реализации сообщить об успешном выполнении при проверке \fBX_OK\fP даже, если ни один из битов выполнения файла не установлен. В Linux так не происходит. .PP Файл доступен только в случае, если для каждого каталога в пути, указанном в \fIpathname\fP, имеется право выполнять поиск (то есть, установлен бит выполнения). Если какой\-то каталог недоступен, то вызов \fBaccess\fP() завершается ошибкой, независимо от имеющихся прав на файл. .PP 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 reported as executable, but the \fBexecve\fP(2) call will still fail. .PP .\" .\" Эти вызовы \fBaccess\fP() могут некорректно работать на файловых системах NFSv2 со включённым преобразованием UID\-ов, потому что это преобразование происходит на сервере и спрятано от клиента, который пытается проверить права (в NFS версии 3 и выше выполняется проверка на сервере). Похожие проблемы могут возникать при монтировании FUSE. .SS "Отличия между библиотекой C и ядром" .\" The raw \fBfaccessat\fP() system call takes only the first three arguments. The \fBAT_EACCESS\fP and \fBAT_SYMLINK_NOFOLLOW\fP flags are actually implemented within the glibc wrapper function for \fBfaccessat\fP(). If either of these flags is specified, then the wrapper function employs \fBfstatat\fP(2) to determine access permissions, but see BUGS. .SS "Замечания по glibc" В старых ядрах, где \fBfaccessat\fP() отсутствует (и если не указаны флаги \fBAT_EACCESS\fP и \fBAT_SYMLINK_NOFOLLOW\fP), обёрточная функция glibc использует \fBaccess\fP(). Если \fIpathname\fP является относительным путём, то glibc собирает путь относительно символической ссылки в \fI/proc/self/fd\fP, которая соответствует аргументу \fIdirfd\fP. .SH ДЕФЕКТЫ Because the Linux kernel's \fBfaccessat\fP() system call does not support a \fIflags\fP argument, the glibc \fBfaccessat\fP() wrapper function provided in glibc 2.32 and earlier emulates the required functionality using a combination of the \fBfaccessat\fP() system call and \fBfstatat\fP(2). However, this emulation does not take ACLs into account. Starting with glibc 2.33, the wrapper function avoids this bug by making use of the \fBfaccessat2\fP() system call where it is provided by the underlying kernel. .PP .\" This behavior appears to have been an implementation accident. In Linux 2.4 (and earlier) there is some strangeness in the handling of \fBX_OK\fP tests for superuser. If all categories of execute permission are disabled for a nondirectory file, then the only \fBaccess\fP() test that returns \-1 is when \fImode\fP is specified as just \fBX_OK\fP; if \fBR_OK\fP or \fBW_OK\fP is also specified in \fImode\fP, then \fBaccess\fP() returns 0 for such files. Early Linux 2.6 (up to and including Linux 2.6.3) also behaved in the same way as Linux 2.4. .PP Before Linux 2.6.20, these calls ignored the effect of the \fBMS_NOEXEC\fP flag if it was used to \fBmount\fP(2) the underlying filesystem. Since Linux 2.6.20, the \fBMS_NOEXEC\fP flag is honored. .SH "СМ. ТАКЖЕ" \fBchmod\fP(2), \fBchown\fP(2), \fBopen\fP(2), \fBsetgid\fP(2), \fBsetuid\fP(2), \fBstat\fP(2), \fBeuidaccess\fP(3), \fBcredentials\fP(7), \fBpath_resolution\fP(7), \fBsymlink\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Dmitry Bolkhovskikh и Yuri Kozlov . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .