sourCEntral - mobile manpages

pdf

EXEC

BEZEICHNUNG

execl, execlp, execle, execv, execvp, execvpe − führt eine Datei aus

ÜBERSICHT

#include <unistd.h>

extern char **environ;

int execl(const char *path, const char *arg, ...);
int execlp(const char *
file, const char *arg, ...);
int execle(const char *
path, const char *arg,
..., char * const
envp[]);
int execv(const char *
path, char *const argv[]);
int execvp(const char *
file, char *const argv[]);
int execvpe(const char *
file, char *const argv[],
char *const
envp[]);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

execvpe(): _GNU_SOURCE

BESCHREIBUNG

Die exec()−Funktionsfamilie ersetzt den aktuellen Programmcode im Speicher mit einem neuen Prozessabbild. Die in dieser Handbuchseite beschriebenen Bibliotheksfunktionen sind Frontends zu der Systemfunktion execve(2). (Siehe die Handbuchseite von execve(2) für weitere Details über das Ersetzen des aktuellen Prozessabbilds.)

Das erste Argument dieser Funktionen ist der Name der Datei, die ausgeführt werden soll.

The const char *arg and subsequent ellipses in the execl(), execlp(), and execle() functions can be thought of as arg0, arg1, ..., argn. Together they describe a list of one or more pointers to null−terminated strings that represent the argument list available to the executed program. The first argument, by convention, should point to the filename associated with the file being executed. The list of arguments must be terminated by a NULL pointer, and, since these are variadic functions, this pointer must be cast (char *) NULL.

Die Funktionen execv(), execvp() und execvpe() übergeben die Aufrufparameter an das Folgeprogramm in einem Feld von Zeigern auf nullterminierte Zeichenketten. Das erste Argument sollte konventionsgemäß auf den Namen der auszuführenden Datei weisen. Der Feld von Zeigern muss mit einem NULL−Zeiger als letztem Eintrag abgeschlossen werden.

Die Funktionen execle() und execvpe() ermöglichen dem aufrufenden Programm, die Umgebung für das auszuführende Programm mittels des Arguments envp zu übergeben. Das Argument envp ist ein Feld von Zeigern auf nullterminierte Zeichenketten und muss mit einem NULL−Zeiger als letztem Eintrag abgeschlossen werden. Die übrigen Funktionen übernehmen die Umgebungsvariablen für den neuen Prozess von der externen Variablen environ im aufrufenden Prozess.

Spezielle Semantik für execlp() und execvp()
Die Funktionen execlp(), execvp() und execvpe() suchen ebenso wie die Shell nach einem ausführbaren Programm, wenn der angegebene Dateiname keinen Schrägstrich (/) enthält. Die Datei wird in der durch Doppelpunkte getrennten Liste von Verzeichnis−Pfadnamen in der Umgebungsvariablen PATH gesucht. Wenn diese Variable nicht definiert ist, ist die Pfadliste standardmäßig das aktuelle Verzeichnis, gefolgt von der Verzeichnisliste, die von confstr(_CS_PATH) zurückgegeben wird. (Dieser Aufruf von confstr(3) gibt in der Regel den Wert »/bin:/usr/bin« zurück.).

Falls der angegebene Dateiname einen Schrägstrich enthält, wird PATH ignoriert und die Datei mit dem angegebenen Pfadnamen ausgeführt.

Zusätzlich werden bestimmte Fehler speziell behandelt.

Falls die Ausführung einer gefundenen Datei verweigert wird (die versuchte Ausführung von execve(2) führte zum Fehler EACCES), werden diese Funktionen im restlichen Suchpfad weitersuchen. Wenn aber keine andere Datei gefunden wird, kehren diese Funktionen zurück und setzen errno auf EACCES.

Wenn der Header einer Datei nicht erkannt wird (die versuchte Ausführung von execve(2) führte zum Fehler ENOEXEC), starten diese Funktionen die Shell (/bin/sh) mit dem Pfadnamen der Datei als erstes Argument. (Wenn dieser Versuch fehlschlägt, wird die Suche abgebrochen.)

RÜCKGABEWERT

Die exec()−Funktionen kehren nur in das aufrufende Programm zurück, wenn ein Fehler aufgetreten ist. Der Rückgabewert ist −1 und errno wird auf die entsprechende Fehlerkennung gesetzt.

FEHLER

Alle diese Funktionen können fehlschlagen und errno auf jeden möglichen Fehler setzen, der für execve(2) angegeben ist.

VERSIONEN

Die Funktion execvpe() kam erstmals in Glibc 2.11 vor.

KONFORM ZU

POSIX.1−2001, POSIX.1−2008.

Die Funktion execvpe() ist eine GNU−Erweiterung.

ANMERKUNGEN

Auf einigen anderen Systemen befindet sich das aktuelle Arbeitsverzeichnis als Maßnahme gegen Trojanische Pferde im Standardpfad (wird verwendet, wenn die Umgebung die Variable PATH nicht enthält) hinter /bin und /usr/bin. Linux verwendet hier den traditionellen Standardpfad mit dem »aktuellen Verzeichnis zuerst«.

Das Fehlerverhalten von execlp() und execvp() beim Versuch Programme zu starten ist historische Praxis und traditionell undokumentiert. Daher ist dieses Verhalten auch nicht durch den POSIX−Standard spezifiziert. BSD (und möglicherweise andere Systeme) schlafen automatisch und wiederholen den Versuch, wenn ETXTBSY angetroffen wird. Linux behandelt es wie einen harten Fehler und kehrt sofort zurück.

Traditionell ignorierten die Funktionen execlp() und execvp() alle Fehler bis auf die oben beschriebenen sowie ENOMEM und E2BIG, bei deren Auftreten sie ins Hauptprogramm zurückkehrten. Sie kehren jetzt ins Hauptprogramm zurück, wenn ein anderer Fehler als die oben beschriebenen auftritt.

SIEHE AUCH

sh(1), execve(2), fork(2), ptrace(2), fexecve(3), environ(7)

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 3.52 des Projekts Linux−man−pages. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter http://www.kernel.org/doc/man−pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Roland Krause <Rokrause AT aol DOT com>, Martin Schulze <joey AT infodrom DOT org> und Martin Eberhard Schauer <Martin DOT E DOT Schauer AT gmx DOT 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 <debian-l10n-german AT lists DOT debian DOT org>.

pdf