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.

KONFORM ZU

       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

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       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>.