The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

execve (2)
  • execve (2) ( Solaris man: Системные вызовы )
  • execve (2) ( FreeBSD man: Системные вызовы )
  • >> execve (2) ( Русские man: Системные вызовы )
  • execve (2) ( Linux man: Системные вызовы )
  • execve (3) ( POSIX man: Библиотечные вызовы )
  •  

    ИМЯ

    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


     

    Index

    ИМЯ
    ОБЗОР
    ОПИСАНИЕ
    ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
    КОДЫ ОШИБОК
    СООТВЕТСТВИЕ СТАНДАРТАМ
    ЗАМЕЧАНИЯ
    СМОТРИ ТАКЖЕ
    ПЕРЕВОД


    Поиск по тексту MAN-ов: 




    Спонсоры:
    Слёрм
    Inferno Solutions
    Hosting by Ihor
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2019 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру