execvpe(3) запуск файла на исполнение

Other Alias

execl, execlp, execle, execv, execvp

ОБЗОР

#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)).

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

Параметр const char *arg и последующие параметры в функциях execl(), execlp() и execle() можно воспринимать как параметры arg0, arg1, ..., argn. Все вместе они описывают список из одного или нескольких указателей на строки (заканчивающиеся null), который представляет собой список параметров, доступных исполняемой программе. Первый параметр, по соглашению, должен указывать на имя, ассоциированное с файлом, который надо запустить. Список параметров должен заканчиваться указателем null и, так как это функция с переменным числом аргументов, этот указатель должен приводиться к (char *) NULL.

Функции execv(), execvp() и execvpe() предоставляют новой программе список аргументов в виде массива указателей на строки, заканчивающиеся null. Первый аргумент, по соглашению, должен указать на имя, ассоциированное с файлом, который необходимо запустить. Массив указателей должен заканчиваться указателем null.

Функции execle() и execvpe() позволяют вызывающему назначить окружение исполняемой программе через параметр envp. Аргумент envp является массивом указателей на строки (завершающиеся null), он должен заканчиваться указателем null. Остальные функции извлекают окружение для нового образа процесса из внешней переменной environ вызвавшего процесса.

Особая семантика execlp() и execvp()

Функции execlp(), execvp() и execvpe() дублируют действия оболочки, относящиеся к поиску исполняемого файла, если указанное имя файла не содержит символ черты (/). Путь поиска задаётся в переменной окружения PATH (список каталогов, перечисленных через двоеточие). Если эта переменная не определена, то по умолчанию к текущему каталогу добавляется список каталогов, возвращаемый confstr(_CS_PATH) (вызов confstr(3) обычно возвращает значение «/bin:/usr/bin»).

Если указанное имя файла содержит в себе символ косой черты, переменная PATH будет проигнорирована, и будет запущен файл по указанному пути.

Кроме этого, есть отличия в обработке некоторых ошибок.

Если доступ к файлу запрещён (при попытке исполнения execve(2) возвращается ошибка EACCES), то эти функции будут продолжать поиск в оставшихся путях. Однако, если больше никаких файлов не найдено, то они присваивают значение глобальной переменной errno равным EACCES.

Если заголовок файла не распознаётся (при попытке выполнения execve(2) возвращает ENOEXEC), то эти функции запускают оболочку (/bin/sh) с полным именем файла в качестве первого параметра (если это тоже приводит к ошибке, то поиск останавливается).

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

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

ОШИБКИ

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

ВЕРСИИ

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

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
ИнтерфейсАтрибутЗначение
execl(), execle(), execv() безвредность в нитяхбезвредно (MT-Safe)
execlp(), execvp(), execvpe() безвредность в нитяхбезвредно (MT-Safe env)

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

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

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

ЗАМЕЧАНИЯ

В некоторых системах путь поиска по умолчанию (используемый, когда в окружении нет переменной PATH) начинается c каталогов /bin и /usr/bin, а затем поиск проводится в текущем каталоге (чтобы не запустить подложенную программу «троянского коня»). В Linux используется традиционный метод: поиск начинается с текущего каталога.

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

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