BEZEICHNUNG¶

execve - Programm ausführen

ÜBERSICHT¶

#include <unistd.h>

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

BESCHREIBUNG¶

execve() führt das Programm aus, auf das sich Pfadname bezieht. Dies führt dazu, dass das Programm, das derzeit vom aufrufenden Prozess ausgeführt wird, durch ein neues Programm, mit einem frisch initialisierten Stack, Heap und (initialisierten und uninitialisierten) Datensegmenten ersetzt wird.

Pfadname muss entweder ein binäres ausführbares Programm oder ein Skript sein, das mit einer Zeile der folgenden Form beginnt:

#!Interpreter [Optionale-Arg]

Einzelheiten zu letzterem Fall finden Sie in »Interpreter-Skripte« weiter unten.

argv ist ein Feld von Zeigern auf Zeichenketten, die an das neue Programm als dessen Befehlszeilenargumente übergeben werden. Per Konvention sollte die erste dieser Zeichenketten (d.h. argv[0]) den Dateinnamen, der zu der ausgeführten Datei gehört, enthalten. Das Feld argv muss durch einen NULL-Zeiger beendet werden. (Daher wird in dem neuen Programm argv[argc] NULL sein.)

envp ist ein Feld von Zeigern auf Zeichenketten, gewöhnlich von der Form Schlüssel=Wert, die an die Umgebung des neuen Programms übergeben werden. Das Feld envp muss durch einen NULL-Zeiger beendet werden.

Auf den Argumentzeiger und die Umgebung kann von der Main-Funktion des neuen Programms zugegriffen werden, wenn sie wie folgt definiert ist:

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

Beachten Sie allerdings, dass die Verwendung eines dritten Arguments bei der Funktion main nicht in POSIX.1 spezifiziert ist; laut POSIX.1 sollte auf die Umgebung über die externe Variable environ(7) zugegriffen werden.

execve() kehrt bei Erfolg nicht zurück und Text, initialisierte Daten, uninitialisierte Daten (bss) und Stack des aufrufenden Prozesses werden entsprechend des Inhalts des neu geladenen Programms überschrieben.

Falls das aktuelle Programm mit ptrace verfolgt wird, wird nach einem erfolgreichen execve() ein Signal SIGTRAP an es gesandt.

Falls bei der Programmdatei, auf die sich Pfadname bezieht, das Bit set-user-ID gesetzt ist, dann wird die effektive Benutzerkennung des aufrufenden Programms zu der des Eigentümers der Programmdatei geändert. Ähnlich wird die effektive Gruppenkennung des aufrufenden Prozesses auf die Gruppe der Programmdatei gesetzt, wenn das Bit set-group-ID auf der Programmdatei gesetzt ist.

Die vorgenannten Umwandlungen der effektiven Kennungen werden nicht durchgeführt (d.h. die Bits set-user-ID und set-group-ID werden ignoriert), falls eine der folgenden Aussagen wahr ist:

• Das Attribut no_new_privs wird für den aufrufenden Thread gesetzt (siehe prctl(2)).
• Das unterliegende Dateisystem ist nosuid eingehängt (der Schalter MS_NOSUID für mount(2)).
• Der aufrufende Prozess wird mit ptrace verfolgt.

Die Capabilities der Programmdatei (siehe capabilities(7)) werden auch ignoriert, wenn eine der obigen Bedingungen zutrifft.

Die effektive Benutzerkennung des Prozesses wird in die gespeicherte set-user-ID kopiert. Ähnlich wird die effektive Gruppenkennung in die gespeicherte set-group-ID kopiert. Dieses Kopieren findet nach allen effektiven ID-Änderungen statt, die aufgrund der Modusbits set-user-ID und set-group-ID erfolgen.

Die reale UID und reale GID des Prozesses sowie die zusätzlichen Gruppenkennungen ändern sich beim Aufruf von execve() nicht.

Falls das Programm eine dynamisch gelinkte Programmdatei im a.out-Format ist, die dynamische Bibliotheken-Stubs enthält, dann wird der dynamische Linker ld.so(8) von Linux am Anfang der Ausführung aufgerufen, um die benötigten Laufzeitobjekte in den Speicher zu bringen und das Programm mit ihnen zu verlinken.

Falls das Programm ein dynamisch gelinktes ELF-Programm ist, wird der in dem Segment PT_INTERP benannte Interpreter zum Laden der gemeinsamen Objekte verwandt. Dieser Interpreter ist typischerweise /lib/ld-linux.so.2 für Programme, die mit der Glibc gelinkt sind (siehe ld-linux.so(8)).

#!Interpreter [Optionale-Arg]

Interpreter [Optionale-Arg] Pfadname Arg …

RÜCKGABEWERT¶

Im Erfolgsfall kehrt execve() nicht zurück, im Fehlerfall wird -1 zurückgeliefert und errno entsprechend gesetzt.

FEHLER¶

E2BIG

Die Gesamtanzahl von Bytes in der Umgebungs- (envp) und der Argumentenliste (argv) ist zu groß.

EACCES

Für einen Teil des Pfadpräfixes von Pfadname oder dem Namen des Skript-Interpreters wird die Suchberechtigung verweigert. (Siehe auch path_resolution(7).)

EACCES

Die Datei oder der Skriptinterpreter ist keine reguläre Datei.

EACCES

Für die Datei oder ein Skript oder ELF-Interpreter wird die Ausführberechtigung verweigert.

EACCES

Das Dateisystem ist nicht noexec eingehängt.

EAGAIN (seit Linux 3.1)

Nach Änderung der realen UID mittels einer der Aufrufe set*uid() war – und ist immer noch – der Aufrufende über seine Ressourcenbegrenzung RLIMIT_NPROC (siehe setrlimit(2)). Für eine detailliertere Erläuterung dieses Fehlers siehe ANMERKUNGEN.

EFAULT

Pfadname oder einer der Zeiger in den Vektoren argv oder envp zeigt aus dem für Sie zugänglichen Adressraum heraus.

EINVAL

Ein ELF-Programm hat mehr als ein PT_INTERP-Segment (d.h. versuchte mehr als einen Interpreter anzugeben).

EIO

Es ist ein E/A-Fehler (engl. I/O) aufgetreten.

EISDIR

Ein ELF-Interpreter war ein Verzeichnis.

ELIBBAD

Ein ELF-Interpreter war in einem unbekannten Format.

ELOOP

Beim Auflösen von Pfadname oder dem Namen eines Skripts oder ELF-Interpreters wurden zu viele symbolische Links ermittelt.

ELOOP

Während der rekursiven Skript-Interpretation (siehe »Interpreter-Skripte« oben) wurde die maximale Rekursionsbegrenzung erreicht. Vor Linux 3.8 wurde in diesem Fall der Fehler ENOEXEC erstellt.

EMFILE

Die Beschränkung pro Prozess der Anzahl offener Datei-Deskriptoren wurde erreicht.

ENAMETOOLONG

Pfadname ist zu lang.

ENFILE

Die systemweite Beschränkung für die Gesamtzahl offener Dateien wurde erreicht.

ENOENT

Die Datei Pfadname oder ein Skript oder ELF-Interpreter existiert nicht.

ENOEXEC

Ein Programm ist nicht in einem erkennbaren Format, ist für die falsche Architektur oder hat einen anderen Formatfehler, wodurch es nicht ausgeführt werden kann.

ENOMEM

Es war nicht genügend Kernelspeicher verfügbar.

ENOTDIR

Ein Teil des Pfadpräfixes von Pfadname oder ein Skript oder ELF-Interpreter ist kein Verzeichnis.

EPERM

Das Dateisystem ist nosuid eingehängt, der Benutzer ist nicht der Superuser und die Datei hat das Bit set-user-ID oder set-group-ID gesetzt.

EPERM

Der Prozess wird verfolgt, der Benutzer ist nicht der Superuser und die Datei hat das Bit set-user-ID oder set-group-ID gesetzt.

EPERM

Eine »Capability-unfähige« Anwendung würde nicht die ganze Menge der vom ausführbaren Programm gewährten erlaubten Capabilities erhalten. Siehe capabilities(7).

ETXTBSY

Das angegebene Programm war für einen oder mehrere Prozesse zum Schreiben offen.

KONFORM ZU¶

POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. POSIX dokumentiert das #!-Verhalten nicht, es existiert aber (mit einigen Variationen) auf anderen UNIX-Systemen.

ANMERKUNGEN¶

Manchmal wird execve() (und die in exec(3) beschriebenen dazugehörigen Funktionen) als »Ausführung eines neuen Prozesses« (oder ähnlich) beschrieben. Dies ist eine hochgradig irreführende Beschreibung: es gibt keinen neuen Prozess, viele Attribute des aufrufenden Prozesses bleiben unverändert (insbesondere seine PID). execve() arrangiert lediglich, dass ein existierender Prozess (der aufrufende Prozess) ein neues Programm ausführt.

Set-user-ID- und Set-group-ID-Prozesse können nicht mit ptrace(2) verfolgt werden.

Das Ergebnis des Einhängens eines Dateisystems mit nosuid unterscheidet sich abhängig von der Linux-Kernelversion. Unter einigen wird die Ausführung von Programmen mit set-user-ID und set-group-ID verweigert, wenn das dem Benutzer Rechte geben würde, die er nicht bereits hatte (und EPERM zurückliefern). Unter anderen werden die Bits set-user-ID und set-group-ID ignoriert und exec() erfolgreich ausgeführt.

Unter Linux können argv und envp als NULL festgelegt werden. In beiden Fällen hat dies den gleichen Effekt wie die Festlegung des Arguments auf einen Zeiger auf eine Liste, die als einziges Element den NULL-Zeiger enthält. Nutzen Sie diese nicht standardisierte und nicht portable Misfunktionalität nicht aus! Unter vielen UNIX-Systemen führt die Festlegung von argv als NULL zu einem Fehler (EFAULT). Einige andere UNIX-Systeme behandeln den Fall envp==NULL wie Linux.

POSIX.1 besagt, dass die von sysconf(3) zurückgelieferten Werte über die Lebensdauer eines Prozesses unveränderlich sein sollen. Seit 2.6.23 wird der von _SC_ARG_MAX berichtete Wert sich allerdings auch ändern, wenn die Ressourcenbegrenzung RLIMIT_STACK sich ändert, um die Tatsache zu berücksichtigen, dass die Begrenzung des Platzes zum Halten der Befehlszeilenargumente und der Umgebungsvariablen sich geändert hat.

In den meisten Fällen, in denen execve() fehlschlägt, kehrt die Steuerung zu dem ursprünglichen Abbild zurück und der Aufrufende von execve() kann mit dem Fehler umgehen. In (seltenen) Fällen kann (typischerweise durch Ressourcenerschöpfung verursacht) der Fehlschlag den Punkt ohne Rückkehr passieren: das ursprüngliche Abbild wurde bereits entfernt aber das neue Abbild konnte nicht komplett gebaut werden. In diesen Fällen beendet der Kernel den Prozess mit einem Signal SIGSEGV (SIGKILL bis Linux 3.17).

BEISPIELE¶

Das folgende Programm ist dafür gedacht, vom zweiten folgenden Programm ausgeführt zu werden. Es gibt nur seine Befehlszeile (eine pro Zeile) wieder aus.

/* myecho.c */
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{


    for (int j = 0; j < argc; j++)


        printf("argv[%d]: %s\n", j, argv[j]);


    exit(EXIT_SUCCESS);
}

Dieses Programm kann zur Ausführung des in seinem Befehlszeilenargument benannten Programms verwandt werden:

/* execve.c */
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{


    char *newargv[] = { NULL, "Hallo", "Welt", NULL };


    char *newenviron[] = { NULL };


    if (argc != 2) {
	printf(stderr, "Aufruf: %s <auszuführende-Datei>\n", argv[0]);
	exit(EXIT_FAILURE);


    }


    newargv[0] = argv[1];


    execve(argv[1], newargv, newenviron);


    perror("execve");   /* execve() kehrt nur im Fehlerfall zurück */


    exit(EXIT_FAILURE);
}

Wir können das zweite Programm verwenden, um das erste wie folgt aufzurufen:

$ cc myecho.c -o myecho
$ cc execve.c -o execve
$ ./execve ./myecho
argv[0]: ./myecho
argv[1]: Hallo
argv[2]: Welt

Wir können diese Programme auch zur Demonstration der Verwendung eines Skript-Interpreters verwenden. Dafür erstellen wir ein Skript, dessen »Interpreter« unser myecho-Programm ist.

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

Wir können dann unser Programm verwenden, um das Skript auszuführen:

$ ./execve ./script
argv[0]: ./myecho
argv[1]: script-arg
argv[2]: ./script
argv[3]: Hallo
argv[4]: Welt

SIEHE AUCH¶

chmod(2), execveat(2), fork(2), get_robust_list(2), ptrace(2), exec(3), fexecve(3), getopt(3), system(3), capabilities(7), credentials(7), environ(7), path_resolution(7), ld.so(8)

KOLOPHON¶

Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.