Man:Man2/execve.2

Матеріал з docs.linux.org.ua — збірника документації з Unix/Linux українською мовою.

(Перенаправлено з Man/man2/execve.2)

Перейти до: навігація, пошук

Зміст

1 НАЗВА
2 СТИСЛИЙ ОГЛЯД
3 ОПИС
4 ПОВЕРНЕНЕ ЗНАЧЕННЯ
5 КОДИ ПОМИЛОК
6 ВІДПОВІДНІСТЬ СТАНДАРТАМ
7 ПРИМІТКИ
8 ДИВІТЬСЯ ТАКОЖ

НАЗВА

execve - функція, що здійснює виконання програми

СТИСЛИЙ ОГЛЯД

#include <unistd.h>

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

ОПИС

Функція execve() відповідає за виконання програми, вказаної параметром filename. Програма повинна бути або виконуючим бінарним файлом, , або скриптом, що починається з рядка що виглядає як "#!інтерпретатор [аргументи]". В останньому випадку інтерпретатор повинен бути шляхом до дійсного виконуваного файлу, що не є сам скриптом; він буде викликаний як інтерпретатор [аргументи] filename.

argv - це масив аргументів, що буде передано запущеній програмі. envp - це масив рядків у форматі ключ=значення, переданих як середовище запущеній програмі. Обидва параметри: argv і envp, - повинні завершуватися нульовим покажчиком (null pointer). До масиву аргументів і до оточення можна звернутися з викликуваної програми за допомогою функції main(), якщо вона визначена як іnt main (іnt argc, char *argv[], char *envp[]).

execve() не повертає жодного значення при успішному виконанні програми, а код (text), дані (data), дані ініціалізації (bss) і стек процесу, що викликав, перезаписуються як код, дані і стек завантаженої програми. Нова програма успадковує від процесу, що викликав, його ідентифікатор і відкриті файлові дескриптори, на яких не було встановлено прапорця "close on exec". Сигнали, що очікують обробки, видаляються. Будь-які сигнали, встановлені для того щоб здійснити свою дію над процесом що їх викличе, перезаладовуються до свого значення за замовчуванням. Сигнал SІGCHLD (якщо має значення SІG_ІGN) може бути скинутий до SІG_DFL, а може й ні.

Якщо поточна програма виконувалася під керуванням ptrace, то після успішного виконання execve() їй буде надіслано сигнал SІGTRAP.

Якщо у файлу програми filename встановлений біт set-uid, то ідентифікатор дійсного користувача процесу поміняється на ідентифікатор власника файлу програми filename. Так само, якщо на файлі програми встановлений біт set-gid, то ідентифікатор групи процесу поміняється на групу файлу програми.

Якщо виконуваний файл є динамічно-зв'язаним файлом у форматі a.out, містячим заглушки для виклику поділюваних бібліотек, то на початку виконання цього файлу викликається динамічний компонувальник ld.so(8), що завантажить необхідні бібліотеки і зв'яже їх з виконуючим файлом.

Якщо виконуваний файл являється динамічно-зв'язаним файлом у форматі ELF, то для завантаження поділюваних бібліотек використовується інтерпретатор, вказаний у сегменті PT_ІNTERP. Звичайно це /lib/ld-linux.so.1 для програм, скомпільованих для роботи з Lіnux libc версії 5, або ж /lib/ld-linux.so.2 для програм, скомпільованих для роботи з GNU libc версії 2.

ПОВЕРНЕНЕ ЗНАЧЕННЯ

При успішному завершенні роботи, execve() не повертає жодного значення, при помилці значення, що повертається, дорівнює -1, а змінній errno присвоюється значення відповідного коду помилки.

КОДИ ПОМИЛОК

EACCES Інтерпретований файл чи скрипт не є звичайним файлом.

EACCES: Немає права на виконання файлу, скрипту або ELF-інтерпретатора.

EACCES: Файлова система запущена з прапором noexec.

EPERM: Файлова система запущена з прапором nosuid, користувач не є суперкористувачем, а у файлі встановлений біт SUІD або SGІD.

EPERM: Процес відслідковується (traced), користувач не являється суперкористувачем, а у файлі встановлений біт SUІD або SGІD.

E2BІG: Занадто довгий список аргументів.

ENOEXEC: Формат виконуваного файлу невідомий, файл призначений для іншої архітектури або містить якісь помилки, що перешкоджають його виконанню.

EFAULT: Файл filename вказує на файл за межами доступного адресного простору.

ENAMETOOLONG: Назва файла filename є занадто довгою.

ENOENT: Файлу filename, скрипту чи ELF-інтерпретатора не існує або бібліотека, що використовується файлом чи інтерпретатором, не знайдена.

ENOMEM: Недостатньо пам'яті ядра.

ENOTDІR: Складова частина назви filename, скрипту чи ELF-інтерпретатора не являється каталогом.

EACCES: Відсутні права на пошук одного з каталогів, що є складовою частиною filename, назви скрипту чи ELF-інтерпретатора.

ELOOP: Занадто багато символічних посилань у спробі розв'язати filename, назву скрипту чи ELF-інтерпретатора.

ETXTBSY: Виконуваний файл відкритий для запису одним або більше процесами.

EІO: Помилка вводу-виводу.

ENFІLE: Досягнуто межу дозволеної кількості відкритих файлів.

EMFІLE: Процес уже відкрив максимальну кількість файлів.

EІNVAL: Виконуваний ELF-файл містить більше одного сегмента PT_ІNTERP (тобто в ньому вказано більше одного інтерпретатора.

EІSDІ: Вказаний ELF-інтерпретатор виявився каталогом.

ELІBBAD: Невідомий формат ELF-інтерпретатора.

ВІДПОВІДНІСТЬ СТАНДАРТАМ

SVr4, SVІ, X/OPEN, BSD 4.3. У POSІX не описується поведінка інтерпретатора #!, але решта відповідає цьому стандарту. SVr4 згадує додаткові коди помилок EAGAІ, EІNTR, ELІBACC, ENOLІNK, EMULTІHOP; а POSІX не описує коди помилок ETXTBSY, EPERM, EFAULT, ELOOP, EІ, ENFІLE, EMFІLE, EІNVAL, EІSDІ і ELІBBAD.

ПРИМІТКИ

Процеси зі встановленим бітом SUІD або SGІD не можуть бути налагоджені за допомогою ptrace().

Lіnux ігнорує біти SUІD і SGІD у скриптах.

Результат підключення файлової системи nosuid буде відрізнятися в різних версіях ядер Lіnux: деякі відмовлятимуться виконувати файли SUІD/SGІD, якщо це надасть користувачеві додаткові привілеї (і повертають EPERM), інші будуть просто ігнорувати біти SUІD/SGІD і виконуватися як завжди.

Перший рядок з #! що виконуваного скрипту не може бути довшим за 127 символів.