Manpage  — EXECVE

execve - zum Ausführen von Programmen

SYNTAX BESCHREIBUNG RÜCKGABEWERT FEHLER KONFORM ZU HINWEISE SIEHE AUCH

#include <unistd.h>

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

execve() führt das Programm aus, auf das dateiname zeigt. dateiname muß 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.

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

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 Adreßraum.
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)

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

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.