ИМЯ¶

execl, execlp, execle, execv, execvp, execvpe - запуск файла на исполнение

СИНТАКСИС¶

#include <unistd.h>

extern char **environ;

int execl(const char *path, const char *arg, ...
/* (char  *) NULL */);
int execlp(const char *file, const char *arg, ...
/* (char  *) NULL */);
int execle(const char *path, const char *arg, ...
                /*, (char *) NULL, char * const envp[] */);
int execv(const char *path, char *const argv[]);
int execvp(const char *file, char *const argv[]);
int execvpe(const char *file, char *const argv[],
                char *const envp[]);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

execvpe(): _GNU_SOURCE

ОПИСАНИЕ¶

Семейство функций exec() заменяет текущий образ процесса новым. Описанные в данной справочной странице функции являются оберткой для execve(2) (подробней о см. замене текущего смотрите в справочной странице execve(2)).

Первый аргумент этих функций - имя исполняемого файла.

The const char *arg and subsequent ellipses in the execl(), execlp(), and execle() functions can be thought of as arg0, arg1, ..., argn. Together they describe a list of one or more pointers to null-terminated strings that represent the argument list available to the executed program. The first argument, by convention, should point to the filename associated with the file being executed. The list of arguments must be terminated by a null pointer, and, since these are variadic functions, this pointer must be cast (char *) NULL.

The execv(), execvp(), and execvpe() functions provide an array of pointers to null-terminated strings that represent the argument list available to the new program. The first argument, by convention, should point to the filename associated with the file being executed. The array of pointers must be terminated by a null pointer.

The execle() and execvpe() functions allow the caller to specify the environment of the executed program via the argument envp. The envp argument is an array of pointers to null-terminated strings and must be terminated by a null pointer. The other functions take the environment for the new process image from the external variable environ in the calling process.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

Функции exec() возвращают значение только при возникновении ошибки. При этом возвращается -1, а errno присваивается код ошибки.

ОШИБКИ¶

Все функции могут завершиться с ошибкой и присвоить errno значения любых ошибок execve(2).

ВЕРСИИ¶

Функция execvpe() впервые появилась в glibc 2.11.

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

СООТВЕТСТВИЕ СТАНДАРТАМ¶

POSIX.1-2001, POSIX.1-2008.

Функция execvpe() является расширением GNU.

ЗАМЕЧАНИЯ¶

Путь поиска по умолчанию (используемый, если в окружении отсутствует переменная PATH) в разных системах отличается. Обычно, он содержит /bin и /usr/bin (в таком порядке), а также может содержать текущий рабочий каталог. В некоторых системах текущий рабочий каталог добавляется после /bin и /usr/bin, чтобы не запустить подложенную программу «троянского коня». В реализации glibc долгое время придерживались традиции, где текущий рабочий каталог включался в начало пути поиска. Однако, в результате переработки кода при разработке glibc 2.24 в путь поиска по умолчанию текущий рабочий каталог больше не стали добавлять совсем. Такое несущественное изменение посчитали преимуществом и не стали возвращать всё назад.

Поведение функций execlp() и execvp() при ошибках во время попыток исполнения файла сложилось исторически, но при этом оно не описано и не определено в стандарте POSIX. В BSD (и, возможно, других системах) выполняется автоматическое ожидание и повтор, если возникает ошибка ETXTBSY. В Linux это воспринимается как невосстановимая ошибка, и она сразу возвращается.

Традиционно, функции execlp() и execvp() игнорировали все ошибки за исключением описанных выше, а также ENOMEM и E2BIG, которые они возвращают. В Linux эти функции возвращают любую ошибку, помимо перечисленных ранее.

ДЕФЕКТЫ¶

До glibc 2.24, execl() и execle() использовали realloc(3) и поэтому были не безопасны для асинхронных сигналов, что нарушало требования POSIX.1. Это было исправлено в glibc 2.24.

СМ. ТАКЖЕ¶

sh(1), execve(2), execveat(2), fork(2), ptrace(2), fexecve(3), system(3), environ(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

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

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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