ИМЯ¶

fexecve - запускает программу, заданную файловым дескриптором

БИБЛИОТЕКА¶

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС¶

#include <unistd.h>

int fexecve(int fd, char *const argv[], char *const envp[]);

fexecve():

    Начиная с glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    До glibc 2.10:


        _BSD_SOURCE

ОПИСАНИЕ¶

Функция fexecve() выполняет ту же задачу, что и execve(2), только выполняемый файл указывается посредством файлового дескриптора fd, а не через путь к файлу. Файловый дескриптор fd должен быть открыт только для чтения (O_RDONLY) или иметь флаг O_PATH и вызывающий должен иметь право на выполнение файла, на который ссылается дескриптор.

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

A successful call to fexecve() never returns. On error, the function does return, with a result value of -1, and errno is set to indicate the error.

ОШИБКИ¶

Возникают те же ошибки что и для execve(2), а также дополнительно:

EINVAL

Значение fd не является правильным файловым дескриптором или argv равно NULL, или envp равно NULL.

ENOENT

На fd установлен флаг close-on-exec и fd ссылается на сценарий. Смотрите ДЕФЕКТЫ.

ENOSYS

Ядро не предоставляет системный вызов execveat(2) и файловая система /proc недоступна.

ВЕРСИИ¶

Функция fexecve() появилась в glibc 2.3.2.

АТРИБУТЫ¶

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

СТАНДАРТЫ¶

POSIX.1-2008. Эта функция не определена в POSIX.1-2001 и широко не распространена среди других систем. Она определена в POSIX.1-2008.

ПРИМЕЧАНИЯ¶

В Linux c glibc с версией 2.26 и старее функция fexecve() реализована с использованием файловой системы proc(5), поэтому /proc должна быть смонтирована и доступна на момент вызова. Начиная с glibc 2.27, если используемое ядро поддерживает системный вызов execveat(2), то fexecve() реализуется через этот системный вызов и /proc монтировать уже не нужно.

Предназначение fexecve() — позволить вызывающему проверить содержимое исполняемого файла (контрольную сумму) до запуска. Простого открытия файла, вычисления контрольной суммы содержимого и выполнения execve(2) недостаточно, так как между двумя этими шагами может измениться имя файла или каталог пути (например, посредством изменения цели символьной ссылки). Функция fexecve() не решает проблему возможного изменения содержимого файла между проверкой контрольной суммы и вызовом fexecve() — для этого есть права на файл, которые должны предотвращать его несанкционированное изменение.

Естественная идиома при использовании fexecve() — установить флаг закрытия-при-выполнении на fd для того, чтобы дескриптор файла не утекал выполняемой программе. Этот подход естественен по двум причинам. Во-первых, это предотвращает трату дескрипторов файлов без надобности (выполняемой программе, обычно, не нужен дескриптор файла, который ссылается на саму программу). Во-вторых, если fexecve() использовать рекурсивно, то применение флага закрытия-при-выполнении предотвращает исчерпание дескрипторов файлов, которое произошло бы, так как каждый шаг в рекурсии вызывает передачу ещё одного дескриптора файла новой программе (но смотрите ДЕФЕКТЫ).

ОШИБКИ¶

Если fd ссылается на сценарий (т. е., это исполняемый текстовый файл, у которого в первой строке (начинается с #!) указан интерпретатор сценария и флаг закрытия-при-выполнении установлен на fd, то fexecve() завершается с ошибкой ENOENT. Эта ошибка возникает потому, что на момент выполнения интерпретатора сценария fd уже закрыт, так как указан флаг закрытия-при-выполнении. Таким образом флаг закрытия-при-выполнении не может быть установлен fd, если он указывает на сценарий, так как это приводит к проблемам, описанным в ЗАМЕЧАНИЯХ.

СМОТРИТЕ ТАКЖЕ¶

execve(2), execveat(2)

ПЕРЕВОД¶

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

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.