execve

Autres langues

Langue: ru

Version: 1997-09-03 (fedora - 25/11/07)

Section: 2 (Appels système)

ИМЯ

execve - выполнить программу

ОБЗОР

#include <unistd.h>

int execve(const char *filename, char *const argv [], char *const envp[]);

ОПИСАНИЕ

execve() выполняет программу, заданную параметром filename. Программа должна быть или двоичным исполняемым файлом, или скриптом, начинающимся со строки вида "#! интерпретатор [аргументы]". В последнем случае интерпретатор -- это правильный путь к исполняемому файлу, который не является скриптом; этот файл будет выполнен как интерпретатор [arg] filename.

argv -- это массив строк, аргументов новой программы. envp -- это массив строк в формате key=value, которые передаются новой программе в качестве окружения (environment). Как argv, так и envp завершаются нулевым указателем. К массиву аргументов и к окружению можно обратиться из функции main(), которая объявлена как int main(int argc, char *argv[], char *envp[]).

execve() не возвращает управление при успешном выполнении, а код, данные, bss и стек вызвавшего процесса перезаписываются кодом, данными и стеком загруженной программы. Новая программа также наследует от вызвавшего процесса его идентификатор и открытые файловые дескрипторы, на которых не было флага закрыть-при-exec (close-on-exec, COE). Сигналы, ожидающие обработки, удаляются. Переопределённые обработчики сигналов возвращаются в значение по умолчанию. Обработчик сигнала SIGCHLD (когда установлен в SIG_IGN) может быть сброшен или не сброшен в SIG_DFL.

Если текущая программа выполнялась под управлением ptrace, то после успешного execve() ей посылается сигнал SIGTRAP.

Если на файле программы filename установлен setuid-бит, то фактический идентификатор пользователя вызывавшего процесса меняется на идентификатор владельца файла программы. Точно так же, если на файле программы установлен setgid-бит, то фактический идентификатор группы устанавливается в группу файла программы.

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

Если исполняемый файл является динамически-скомпонованным файлом в формате ELF, то для загрузки разделяемых библиотек используется интерпретатор, указанные в сегменте PT_INTERP. Обычно это /lib/ld-linux.so.1 для программ, скомпилированных под Linux libc версии 5, или же /lib/ld-linux.so.2 для программ, скомпилированных под GNU libc версии 2.

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

При успешном завершении execve() не возвращает управление, при ошибке возвращается -1, а значение errno устанавливается должным образом.

КОДЫ ОШИБОК

EACCES
Интерпретатор файла или скрипта не является обычным файлом.
EACCES
Нет прав на выполнение файла, скрипта или ELF-интерпретатора.
EACCES
Файловая система смонтирована с флагом noexec.
EPERM
Файловая система смонтирована с флагом nosuid, пользователь не является суперпользователем, а на файле установлен бит setuid или setgid.
EPERM
Процесс работает под отладчиком, пользователь не является суперпользователем, а на файле установлен бит setuid или setgid.
E2BIG
Список аргументов слишком велик.
ENOEXEC
Исполняемый файл в неизвестном формате, для другой архитектуры, или же встречены какие-то ошибки, препятствующие его выполнению.
EFAULT
filename указывает за пределы доступного адресного пространства.
ENAMETOOLONG
filename слишком длинное.
ENOENT
Файл filename, или интерпретатор скрипта или ELF-файла не существует, или же не найдена разделяемая библиотека, требуемая файлу или интерпретатору.
ENOMEM
Недостаточно памяти в ядре.
ENOTDIR
Компонент пути filename, или интерпретатору скрипта или ELF-интерпретатору не является каталогом.
EACCES
Нет прав на поиск в одном из каталогов по пути к filename, или имени интерпретатора скрипта или ELF-интерпретатора.
ELOOP
Слишком много символьных ссылок встречено при поиске filename, или интерпретатора скрипта или ELF-интерпретатора.
ETXTBSY
Исполняемый файл открыт для записи одним или более процессами.
EIO
Произошла ошибка ввода-вывода.
ENFILE
Достигнут системный лимит на общее количество открытых файлов.
EMFILE
Процесс уже открыл максимально доступное количество открытых файлов.
EINVAL
Исполняемый файл в формате ELF содержит более одного сегмента PT_INTERP (то есть, в нем указано более одного интерпретатора).
EISDIR
ELF-интерпретатор является каталогом.
ELIBBAD
ELF-интерпретатор имеет неизвестный формат.

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

SVr4, SVID, X/OPEN, BSD 4.3. POSIX не документирует поведение, связанное с #!, но в остальном совершенно совместимо. SVr4 документирует дополнительные коды ошибок EAGAIN, EINTR, ELIBACC, ENOLINK, EMULTIHOP; POSIX не документирует коды ошибок ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE, EMFILE, EINVAL, EISDIR и ELIBBAD.

ЗАМЕЧАНИЯ

SUID и SGID процессы не могут быть оттрассированы ptrace()d.

Linux игнорирует SUID и SGID биты на скриптах.

Результат монтирования файловой системы с опцией nosuid различается в зависимости от версий ядра Linux: некоторые ядра будут отвергать выполнение SUID/SGID программ, когда это должно дать пользователю те возможности, которыми он уже не обладается (и возвращать EPERM), некоторые ядра будут просто игнорировать SUID/SGID биты, но успешно производить запуск программы.

Первая строка (строка с #!) исполняемого скрипта не может быть длиннее 127 символов.

СМОТРИ ТАКЖЕ

chmod(2), fork(2), execl(3), environ(5), ld.so(8)

ПЕРЕВОД

Дополнения к первоначальному переводу: Виктор Вислобоков <corochoone@perm.ru> 2003