NAZWA¶

SKŁADNIA¶

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

OPIS¶

pathname musi być albo wykonywalnym plikiem binarnym, albo skryptem zaczynającym się od linii w postaci:

#!interpreter [opcjonalny-parametr]

Szczegóły tego ostatniego przypadku można znaleźć poniżej w rozdziale "Skrypty interpretowane".

argv is an array of argument strings passed to the new program. By convention, the first of these strings (i.e., argv[0]) should contain the filename associated with the file being executed. envp is an array of strings, conventionally of the form key=value, which are passed as environment to the new program. The argv and envp arrays must each include a null pointer at the end of the array.

The argument vector and environment can be accessed by the called program's main function, when it is defined as:

int main(int argc, char *argv[], char *envp[])

Note, however, that the use of a third argument to the main function is not specified in POSIX.1; according to POSIX.1, the environment should be accessed via the external variable environ(7).

execve() does not return on success, and the text, initialized data, uninitialized data (bss), and stack of the calling process are overwritten according to the contents of the newly loaded program.

Jeśli obecny program jest śledzony za pomocą ptrace, wysyła się mu SIGTRAP po pomyślnym execve().

If the set-user-ID bit is set on the program file referred to by pathname, then the effective user ID of the calling process is changed to that of the owner of the program file. Similarly, when the set-group-ID bit of the program file is set the effective group ID of the calling process is set to the group of the program file.

The aforementioned transformations of the effective IDs are not performed (i.e., the set-user-ID and set-group-ID bits are ignored) if any of the following is true:

• the no_new_privs attribute is set for the calling thread (see prctl(2));
• the underlying filesystem is mounted nosuid (the MS_NOSUID flag for mount(2)); or
• the calling process is being ptraced.

The capabilities of the program file (see capabilities(7)) are also ignored if any of the above are true.

Efektywny identyfikator użytkownika jest kopiowany do saved-set-user-ID; podobnie efektywny identyfikator grupy jest kopiowany do saved-set-group-ID. Kopiowanie odbywa się po zmianie któregokolwiek z efektywnych identyfikatorów związanej z bitami trybu set-user-ID i set-group-ID.

The process's real UID and real GID, as well its supplementary group IDs, are unchanged by a call to execve().

Jeśli program wykonywalny jest skonsolidowany dynamicznie w formacie a.out z bibliotekami dzielonymi, to na początku uruchamiania wywoływany jest konsolidator dynamiczny ld.so(8), który ładuje wszystkie obiekty do pamięci i konsoliduje z nimi program wykonywalny.

Jeżeli program jest skonsolidowany dynamicznie jako ELF, to do załadowania potrzebnych obiektów współdzielonych używany jest interpreter określony w segmencie PT_INTERP. Tym interpreterem jest zazwyczaj /lib/ld-linux.so.2, w wypadku programów skonsolidowanych z glibc2 (zob. ld-linux.so(8)).

Wszystkie atrybuty procesu są zachowywane podczas execve(), z wyjątkiem poniższych:

• Ustawienia obsługi sygnałów, które są przechwytywane, są zmieniane na wartości domyślne (signal(7)).
• Alternatywny stos sygnałów nie jest zachowywany (sigaltstack(2)).
• Mapowania pamięci nie są zachowywane (mmap(2))
• Dołączone segmenty pamięci dzielonej Systemu V są odłączane (shmat(2)).
• Regiony pamięci dzielonej POSIX są odmapowane (shm_open(3)).
• Otwarte kolejki komunikatów POSIX są zamykane (mq_overview(7)).
• Otwarte semafory nazwane POSIX są zamykane (mq_overview(7)).
• Timery POSIX nie są zachowywane (timer_create(2)).
• Otwarte strumienie katalogów są zamykane (opendir(3)).
• Blokady pamięci nie są zachowywane (mlock(2), mlockall(2)).
• Zarejestrowanie funkcje wykonywanych po zakończeniu procesu nie są zachowywane (atexit(3), on_exit(3)).
• Środowisko zmiennoprzecinkowe jest ustawiane na domyślne (patrz fenv(3)).

Atrybuty procesu w liście przedstawionej powyżej są określone w POSIX.1. Następujące specyficzne dla Linuksa atrybuty procesu również nie są zachowywane podczas execve():

• Znacznik PR_SET_DUMPABLE prctl(2) jest ustawiany, chyba że wykonywany program ma ustawiony bit set-user-ID lub set-group-ID, w którym przypadku znacznik ten jest czyszczony.
• Znacznik PR_SET_KEEPCAPS prctl(2) jest czyszczony.
• (Od Linuksa 2.4.36 / 2.6.23) Jeśli wykonywany program ma ustawiony bit set-user-ID lub set-group-ID, to jest czyszczony znacznik PR_SET_PDEATHSIG sygnału śmierci rodzica ustawiony przez prctl(2).
• Nazwa procesu ustawiona przez PR_SET_NAME z prctl(2) (i wyświetlana przez ps -o comm) jest ustawiana na nazwę nowego pliku wykonywalnego.
• Znacznik SECBIT_KEEP_CAPS w securebits jest czyszczony. Patrz capabilities(7).
• Sygnał zakończenia jest ustawiany na SIGCHLD (patrz clone(2)).
• Tablica deskryptora plików nie jest dzielona, co anuluje działanie flagi CLONE_FILES clone(2).

Dalsze uwagi:

• Wszystkie wątki oprócz wątku wywołującego są niszczone podczas execve(). Muteksy, zmienne warunkowe i inne obiekty pthreads nie są zachowywane.
• Odpowiednik setlocale(LC_ALL, "C") jest wykonywany po uruchomieniu programu.
• POSIX.1 określa, że ustawienie procedur obsługi sygnału na ignorowanie lub na wartość domyślną jest pozostawiane bez zmian. POSIX.1 przewiduje jeden wyjątek od tej reguły: jeśli SIGCHLD jest ignorowany, to implementacja może albo nie zmienić tego ustawienia, albo przestawić je na wartość domyślną; Linux robi to pierwsze.
• Wszystkie asynchroniczne operacje wejścia/wyjście są anulowane (aio_read(3), aio_write(3)).
• Sposób obsługi atrybutów (zdolności) procesu podczas execve() opisano w capabilities(7).
• Domyślnie deskryptory plików pozostają otwarte po execve(). Deskryptory plików oznaczone jako "close-on-exec" są zamykane, patrz opis FD_CLOEXEC w fcntl(2). (Jeśli deskryptor pliku zostanie zamknięty, to zwolnione zostaną wszystkie blokady rekordów dotyczące pliku związanego z tym deskryptorem. Szczegóły można znaleźć w fcntl(2)). POSIX.1 mówi, że jeżeli deskryptory plików 0, 1 i 2 zostałyby zamknięte po pomyślnym wykonaniu execve(), a proces uzyskałby przywileje z powodu ustawionego na wykonywanym pliku bitu trybu set-user-ID lub set-group-ID, to system może otworzyć bliżej nieokreślony plik dla każdego z tych deskryptorów plików. Jako zasadę należy przyjąć, że żaden przenośny program, uprzywilejowany czy nie, nie może zakładać, że te trzy deskryptory plików będą zamknięte po execve().

#!interpreter [opcjonalny-parametr]

interpreter [opcjonalny-arg] pathname arg...

WARTOŚĆ ZWRACANA¶

BŁĘDY¶

E2BIG

Całkowita liczba bajtów środowiska (envp) i listy argumentów (argv) jest za duża.

EACCES

Brak praw do przeszukiwania dla składnika ścieżki pathname lub ścieżki interpretera skryptu (patrz także path_resolution(7)).

EACCES

Plik lub interpreter skryptu nie jest zwykłym plikiem.

EACCES

Brak praw wykonywania dla pliku, skryptu lub intepretera ELF.

EACCES

System plików jest zamontowany jako noexec.

EAGAIN (od Linuksa 3.1)

Po zmianie swojego rzeczywistego UID za pomocą jednego z wywołań set*uid(), wywołujący był—i wciąż jest—powyżej swojego limitu zasobó RLIMIT_NPROC (zob. setrlimit(2)). Więcej informacji o tym błędzie znajduje się w rozdziale UWAGI.

EFAULT

pathname lub jeden ze wskaźników w wektorach argv lub envp wskazuje poza dostępną dla użytkownika przestrzeń adresową.

EINVAL

Plik wykonywalny w formacie ELF ma więcej niż jeden segment PT_INTERP (tzn. ma więcej niż jeden interpreter).

EIO

Wystąpił błąd wejścia/wyjścia.

EISDIR

Intepreter ELF jest katalogiem.

ELIBBAD

Nie został rozpoznany format interpretera ELF.

ELOOP

Podczas rozwiązywania pathname, nazwy skryptu lub interpretera ELF napotkano zbyt wiele dowiązań symbolicznych.

ELOOP

Osiągnięto maksymalny limit rekurencji podczas intepretacji rekurencyjnego skryptu (zob. pow. "Skrypty interpretowane"). Przed Linuksem 3.8 w takim wypadku występował błąd ENOEXEC.

EMFILE

Zostało osiągnięte ograniczenie na liczbę otwartych deskryptorów plików dla procesu.

ENAMETOOLONG

Ścieżka pathname jest zbyt długa.

ENFILE

Zostało osiągnięte systemowe ograniczenie na całkowitą liczbę otwartych plików.

ENOENT

Plik pathname, skrypt, lub intepreter ELF nie istnieje albo nie można znaleźć biblioteki współdzielonej potrzebnej do uruchomienia pliku lub interpretera.

ENOEXEC

Nie rozpoznano formatu pliku binarnego, plik ten jest skompilowany dla innej architektury albo wystąpił jakiś inny błąd formatu pliku, który powoduje, że program nie może być uruchomiony.

ENOMEM

Brak pamięci jądra.

ENOTDIR

Składnik ścieżki pathname, ścieżki skryptu lub ścieżki interpretera ELF nie jest katalogiem.

EPERM

System plików jest zamontowany jako nosuid, użytkownik nie jest administratorem, a plik ma ustawiony bit set-user-ID lub set-group-ID.

EPERM

Proces jest śledzony (trace), użytkownik nie jest superużytkownikiem, a plik ma ustawiony bit set-user-ID lub set-group-ID.

EPERM

Aplikację ślepe na przywileje nie pozyskają pełnego zestawu dozwolonych przywilejów przyznanego przez plik wykonywalny. Zob. capabilities(7).

ETXTBSY

Podany plik wykonywalny był otwarty do zapisu przez jeden lub więcej procesów.

ZGODNE Z¶

UWAGI¶

Procesy z ustawionymi znacznikami set-user-ID oraz set-group-ID nie mogą być śledzone za pomocą ptrace(2).

Efekt zamontowania systemu plików nosuid jest różny dla różnych wersji jądra Linuksa: niektóre odmówią uruchomienia programów set-user-ID i set-group-ID, gdy spowodowałoby to udostępnienie użytkownikowi możliwości, którymi w danym momencie nie dysponuje (i zwrócą EPERM), inne po prostu zignorują bity set-user-ID i set-group-ID i pomyślnie wykonają exec().

Pod Linuksem argv i envp może być podany jako NULL. W obu przypadkach, ma to ten sam skutek co podanie danego argumentu jako wskaźnika do listy zawierającej pojedynczy wskaźnik null. Prosimy nie wykorzystywać tej niestandardowej i nieprzenośnej pseudofunkcji! Na większości innych systemów Uniksowych podanie jako argv wartości NULL spowoduje wystąpienie błędu (EFAULT). Część innych systemów Uniksowych traktuje przypadek envp==NULL tak samo jak Linux.

POSIX.1 określa, że wartości zwracane przez sysconf(3) nie powinny się zmieniać przez cały czas życia procesu. Jednakże od wersji 2.6.23 Linuksa zmiana limitu zasobów RLIMIT_STACK powoduje również zmianę wartości zwracanej przez _SC_ARG_MAX, żeby odzwierciedlić fakt, że zmieniły się ograniczenia przestrzeni służącej do przechowywania argumentów linii poleceń i zmiennych środowiska.

W większości sytuacji gdy execve() zawiedzie, kontrola powraca do oryginalnego obrazu wykonywalnego, a wywołujący execve() może następnie obsłużyć błąd. Jednak są (rzadkie) przypadki (zwykle przy braku zasobów), gdy błąd może wystąpić w momencie bez powrotu: oryginalny obraz wykonywalne został podzielony, a nie można całkowicie zbudować nowego obrazu. W takich sytuacjach jądro zabija proces sygnałem SIGKILL.

PRZYKŁAD¶

/* myecho.c */
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{
    int j;
    for (j = 0; j < argc; j++)
        printf("argv[%d]: %s\n", j, argv[j]);
    exit(EXIT_SUCCESS);
}

Tego programu można użyć do uruchomienia programu podanego w argumencie linii poleceń:

/* execve.c */
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{
    char *newargv[] = { NULL, "witaj", "świecie", NULL };
    char *newenviron[] = { NULL };
    if (argc != 2) {
        fprintf(stderr, "Użycie: %s <plik-do-uruchomienia>\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    newargv[0] = argv[1];
    execve(argv[1], newargv, newenviron);
    perror("execve");   /* execve() wraca tylko w przypadku błędu */
    exit(EXIT_FAILURE);
}

Możemy użyć drugiego programu do uruchomienia pierwszego:

$ cc myecho.c -o myecho
$ cc execve.c -o execve
$ ./execve ./myecho
argv[0]: ./myecho
argv[1]: witaj
argv[2]: świecie

Możemy także użyć tych programów do pokazania używania interpretera skryptu. Aby to zrobić, tworzymy skrypt, którego "interpreterem" jest nasz program myecho:

$ cat > script
#!./myecho script-arg
^D
$ chmod +x script

Następnie używamy naszego programu do wykonania skryptu:

$ ./execve ./script
argv[0]: ./myecho
argv[1]: script-arg
argv[2]: ./script
argv[3]: witaj
argv[4]: świecie

ZOBACZ TAKŻE¶

O STRONIE¶

TŁUMACZENIE¶

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres manpages-pl-list@lists.sourceforge.net.