execve(2) zum Ausführen von Programmen

SYNTAX

#include <unistd.h>

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

BESCHREIBUNG

execve() führt das Programm aus, auf das dateiname zeigt. dateiname muss entweder ein binäres ausführbares Programm oder ein Shell-Skript, welches mit einer Linie in der Form "#! Interpreter [arg]" beginnt, sein.

execve() kehrt beim Erfolg nicht zurück und der Text, Daten, bss, und Stapel des aufrufenden Prozesses wird durch das geladene Programm überschrieben. Das aufgerufene Programm erbt die PID des aufrufenden Prozesses, sowie jeden offenen Dateideskriptor, der zur Ausführung nicht geschlossen wurde. Signale bezüglich des elterlichen Prozesses werden gelöscht.

Falls das aktuelle Programm ptraced wird, wird nach erfolgreichem execve() ein SIGTRAP gesendet.

RÜCKGABEWERT

Bei Erfolg kehrt execve() nicht zurück, bei Fehlern wird -1 zurückgegeben und errno wird dem entsprechend gesetzt.

FEHLER

EACCES
Die Datei ist keine gültige Datei.
EACCES
Die Erlaubnis zum ausführen der Datei wurde verweigert.
EPERM
Das Dateisystem ist als noexec gemountet.
EPERM
Das Dateisystem ist als nosuid gemountet und die Datei hat das SUID oder SGID bit gesetzt.
E2BIG
Die Argumentenliste ist zu lang.
ENOEXEC
Die magische Zahl in der Datei ist falsch.
EFAULT
dateiname zeigt auf einen außerhalb liegenden Adressraum.
ENAMETOOLONG
dateiname ist zu lang.
ENOENT
Das File exestiert nicht.
ENOMEM
Unzulänglicher Kernelspeicher war verfügbar.
ENOTDIR
Eine Komponente des vorangestellten Pfades ist kein Direktory.
EACCES
die Suchrechte auf eine Komponente des vorangestellten Pfades wurden verweigert.
ELOOP
dateiname enthält eine zirkulare Referenz (z.B, durch einen symbolischen Link)

KONFORM ZU

SVID, AT&T, POSIX, X/OPEN, BSD 4.3

HINWEISE

SUID und SGID Prozesse können nicht als SUID oder SGID ptrace()'d werden.

Eine maximale Länge von 127 Zeichen ist für die erste Zeile eines #! ausführbaren Shell-Skripts erlaubt. Dies kann umgangen werden, indem man die maximale Größe des Puffers (buf) ändert, in diesem Fall ist man an die Puffergröße von 1024 Bytes gebunden, was keine triviale Lösung darstellt.