execlpe()

Выполнить файл

Прототип:

#include <process.h>
                                       
int execlpe( const char *file, 
             const char *arg0, 
             const char *arg1,
             ...
             const char *argn, 
             NULL,
             const char *envp[] );

Аргументы:

file

Используется для создания пути к файлу, идентифицирующему файл образа нового процесса. Если аргумент file содержит символ "/", то аргумент file используется как путь к файлу. В ином случае, префикс пути к файлу получается путем поиска в директориях, переданных в переменной окружения PATH.

arg0,...,argn

Указатели на строки, завершаемые NULL. Эти строки составляют список аргументов, доступных для образа нового процесса. Необходимо, чтобы этот список был завершен указателем на NULL. Аргумент arg0 должен указывать на имя файла, связанного с запускаемым процессом.

envp

Массив символьных указателей на строки, завершаемые NULL. Эти строки представляют собой окружение для образа нового процесса. Массив envp завершается указателем на NULL.

Библиотека:

libc

Описание:

---

Смотрите execl() для дополнительной информации о семействе функций exec*().

---

Функция execlpe() заменяет образ текущего процесса на образ нового процесса, определенного в file. Новый образ создается из обычного исполняемого файла, называемого файлом образа нового процесса. Возврата не происходит, поскольку образ вызывающего процесса заменяется образом нового процесса.

---

Если новый дочерний процесс является консольным скриптом, первая его строка должна начинаться с #!, за которыми следует путь к программе интерпретатора скрипта, за которым может следовать опциональный аргумент. Скрипт также должен быть помечен как исполняемый.

---

Функция execlpe() использует пути, перечисленные в переменной окружения PATH, для определения местонахождения программы, которая должна быть загружена, при соблюдении следующих условий:

• Аргумент file определяет имя программы, которая должна быть загружена.
• Если символ пути (/) не включен в имя, производится попытка загрузить программу из одного из путей, определенных в переменной окружения PATH.
• Если PATH не определена, используется текущая рабочая директория.
• Если символ пути (/) включен в имя, программа загружается из пути, определенного в file.

Процесс запускается с аргументами, определенными завершающимися NULL аргументами arg1, ..., argn. arg0 должен быть указателем на имя файла, ассоциированное с программой, которая будет загружена. Только arg0 обязателен, arg1, ..., argn опциолнальны.

Окружение нового процесса определяется envp, массивом, завершаемым NULL и состоящим из строк, завершаемых NULL. envp не может иметь значение NULL, но envp[0] может быть указателем на NULL, если никаких строк окружения не передается.

Каждый указатель в envp указывает на строку вида:

variable=value

которая используется для определения переменной окружения.

Окружение - совокупность переменных окружения, чьи значения были определены с помощью команды оболочки export, утилиты env или с помощью успешного выполнения функций putenv() или setenv(). Программа может считать эти значения с помощью функции getenv().

Если программа не найдена, возникает ошибка.

Если file находится на файловой системе, смонтированной с установленным флагом ST_NOSUID, эффективный идентификатор пользователя, эффективный идентификатор группы, сохраненный идентификатор пользователя и сохраненный идентификатор группы остаются неизменными для нового процесса. В ином случае, если установлен бит режима идентификатора пользователя, эффективный идентификатор пользователя образа нового процесса устанавливается в идентификатор пользователя file. Аналогично, если установлен бит режима идентификатора группы, эффективный идентификатор группы устанавливается в идентификатор группы file. Идентификатор фактического пользователя, идентификатор фактической группы и идентификаторы дополнительных групп нового процесса остаются такими же, как и у вызывающего процесса. Эффективный идентификатор пользователя и эффективный идентификатор группы образа нового процесса сохраняются (как сохраненный идентификатор пользователя и сохраненный идентификатор группы, используемые setuid()).

Если вызывающий процесс заблокировал некоторый сегмент памяти, блокировки снимаются.

Коротко об exec*()

Возвращаемое значение:

При успешном завершении функция не возвращает управление; если возникла ошибка, функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

E2BIG

Список аргументов и переменных среды больше, чем установленный системный предел в ARG_MAX байт.

EACCESS

Вызывающий процесс не имеет разрешения для поиска директории, описанной в file, либо разрешения на выполнение file, либо файловая система, содержащая file, смонтирована с флагом ST_NOEXEC.

ELOOP

Слишком много уровней символических ссылок или префиксов.

ENAMETOOLONG

Длина file или элемента переменной окружения PATH превышает PATH_MAX.

ENOENT

Один или более компонентов пути к файлу не существует, либо аргумент file указывает на пустую строку.

ENOMEM

Недостаточно памяти для создания нового процесса.

ENOTDIR

Часть file не является директорией.

ETXTBSY

Текстовый файл, который планируется выполнить, занят (например, он может быть открыт для записи).

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Тематические ссылки:

abort(), atexit(), errno, execl(), execle(), execlp(), execv(), execve(), execvp(), execvpe(), _exit(), exit(), getenv(), main(), putenv(), spawn(), spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnp(), spawnv(), spawnve(), spawnvp(), spawnvpe(), system()

Предыдущий раздел: Описание API системной библиотеки