BEZEICHNUNG¶
clearenv - löscht die Liste der Umgebungsvariablen
ÜBERSICHT¶
#include <stdlib.h>
int clearenv(void);
Mit Glibc erforderliche Makros (siehe
feature_test_macros(7)):
clearenv(): _SVID_SOURCE || _BSD_SOURCE
BESCHREIBUNG¶
Die Funktion
clearenv() löscht alle Name-Werte-Paare aus der Liste
der Umgebungsvariablen und setzt den Wert der externen Variable
environ
auf NULL.
RÜCKGABEWERT¶
Wurde die Funktion
clearenv() erfolgreich ausgeführt, gibt sie Null
zurück. Ein von Null verschiedener Rückgabewert zeigt einen Fehler
an.
VERSIONEN¶
Nicht vorhanden in Libc4, Libc5. In Glibc seit Version 2.0.
Verschiedenen Unix-Varianten (DG/UX, HP-UX, QNX, ...). POSIX.9 (Sprachanbindung
zu FORTRAN77). POSIX.1-1996 hat
clearenv() und
putenv(3)
zunächst nicht akzeptiert, sich jedoch umentschieden und geplant, die
Funktionen in einer späteren Ausgabe des Standards aufzunehmen (s.
B.4.6.1). POSIX.1-2001 hat jedoch nur
putenv(3) aufgenommen und
clearenv() zurückgewiesen.
ANMERKUNGEN¶
Wird in Programmen verwendet, die Wert auf Sicherheit legen. Falls die Funktion
selbst nicht verfügbar ist, erfüllt die Zuweisung
environ = NULL;
möglicherweise denselben Zweck.
In den Handbuchseiten von DG/UX und Tru64 steht: Falls
environ von
irgendetwas Anderem als den Funktionen
putenv(3),
getenv(3) oder
clearenv() geändert wurde, wird
clearenv() einen Fehler
zurückgeben und die Prozessumgebung bleibt unverändert.
SIEHE AUCH¶
getenv(3),
putenv(3),
setenv(3),
unsetenv(3),
environ(7)
KOLOPHON¶
Diese Seite ist Teil der Veröffentlichung 3.42 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 Daniel Kobras
<kobras@linux.de> und Martin Eberhard Schauer
<Martin.E.Schauer@gmx.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@lists.debian.org>.