execveat(2)

ИМЯ
execveat - выполняет программу, определяемую относительно файлового дескриптора каталога

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <linux/fcntl.h>      /* определения констант AT_* */
#include <unistd.h>

int execveat(int dirfd, const char *pathname,
             char *const _Nullable argv[],
             char *const _Nullable envp[],
             int flags);

ОПИСАНИЕ
Системный вызов execveat() выполняет программу, на которую ссылается комбинация dirfd и pathname. Он работает также как системный вызов execve(2), за исключением случаев, описанных в данной справочной странице.

Если в pathname задан относительный путь, то он считается относительно каталога, на который ссылается файловый дескриптор dirfd (а не относительно текущего рабочего каталога вызывающего процесса, как это делается в execve(2)).

Если в pathname задан относительный путь и dirfd равно специальному значению AT_FDCWD, то pathname рассматривается относительно текущего рабочего каталога вызывающего процесса (как execve(2)).

Если в pathname задан абсолютный путь, то dirfd игнорируется.

Если pathname — пустая строка и указан флаг AT_EMPTY_PATH, то файловым дескриптором dirfd задаётся выполняемый файл (т. е., dirfd ссылается на исполняемый файл, а не на каталог).

Аргумент flags является битовой маской, которая может включать ноль или более следующих флагов:

AT_EMPTY_PATH
    Если значение pathname равно пустой строке, то вызов выполняет действие с файлом, на который ссылается dirfd (может быть получен с помощью open(2) с флагом O_PATH).

AT_SYMLINK_NOFOLLOW
    Если файл задаётся dirfd и pathname — символическая ссылка (не NULL), то вызов завершается с ошибкой ELOOP.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
On success, execveat() does not return. On error, -1 is returned, and errno is set to indicate the error.

ОШИБКИ
В execveat() могут возникнуть те же ошибки, что и в execve(). Также, в execveat() могут возникнуть следующие ошибки:

pathname
    is relative but dirfd is neither AT_FDCWD nor a valid file descriptor.

EINVAL
    Указано неверное значение в flags.

ELOOP
    Значение flags содержит AT_SYMLINK_NOFOLLOW и файл задаётся dirfd, а pathname — символическая ссылка (не NULL).

ENOENT
    Программа задаётся dirfd и по pathname требуется использовать интерпретирующую программу (то есть сценарий, начинающийся с «#!»), но файловый дескриптор dirfd открыт с флагом O_CLOEXEC, что приводит к недоступности файла программы запускаемому интерпретатору. Смотрите ДЕФЕКТЫ.

ENOTDIR
    Значение pathname содержит относительный путь и dirfd содержит файловый дескриптор, указывающий на файл, а не на каталог.

ВЕРСИИ
execveat() was added in Linux 3.19. Library support was added in glibc 2.34.

СТАНДАРТЫ
Системный вызов execveat() есть только в Linux.

ЗАМЕЧАНИЯ
В дополнении к причинам, описанным в openat(2), системному вызову execveat() также требуется разрешить fexecve(3) для реализации в системах, у которых не смонтированной файловой системы /proc.

При запросе запуска файла сценария, значение argv[0], передаваемое в интерпретатор сценарий, является строкой в виде /dev/fd/N или /dev/fd/N/P, где N — номер файлового дескриптора, передаваемого через аргумент dirfd. Строка в первом формате встречается, когда указан AT_EMPTY_PATH. Строка во втором формате встречается, когда сценарий задаётся сразу через dirfd и pathname; в этом случае P — это значение, указанное в pathname.

По причинам, описанным в fexecve(3), естественным подходом является использование execveat() с установленным флагом close-on-exec у dirfd (но смотрите ДЕФЕКТЫ).

ДЕФЕКТЫ
Ошибка ENOENT, описанная выше, означает, что невозможно установить флаг close-on-exec у файлового дескриптора, переданного вызову в виде:

    execveat(fd, "", argv, envp, AT_EMPTY_PATH);

Однако неспособность установить флаг close-on-exec означает утечку файловых дескрипторов, через ссылку сценария на самого себя. Помимо траты файлового дескриптора, это может привести к исчерпанию файловых дескрипторов, если сценарии рекурсивно вызывают execveat().

СМ. ТАКЖЕ
execve(2), openat(2), fexecve(3)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.