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

       Verfügbar seit Glibc 2.0.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────┬───────────────────────┬─────────────────────┐
       │ Schnittstelle │ Attribut              │ Wert                │
       ├───────────────┼───────────────────────┼─────────────────────┤
       │ clearenv()    │ Multithread-Fähigkeit │ MT-Unsafe const:env │
       └───────────────┴───────────────────────┴─────────────────────┘

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

       Diese Seite ist Teil der Veröffentlichung  4.04  des  Projekts  Linux-man-pages.  Eine  Beschreibung  des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche Übersetzung dieser Handbuchseite wurde von Daniel Kobras <kobras@linux.de>, Martin Eberhard
       Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> 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>.

Linux                                             23. Juli 2015                                      CLEARENV(3)