clearenv(3)                Library Functions Manual                clearenv(3)

BEZEICHNUNG
       clearenv - loscht die Liste der Umgebungsvariablen

BIBLIOTHEK
       Standard-C-Bibliothek (libc, -lc)

UBERSICHT
       #include <stdlib.h>

       int clearenv(void);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       clearenv():
           /* Glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

BESCHREIBUNG
       Die Funktion clearenv() loscht alle Name-Werte-Paare aus der Liste der
       Umgebungsvariablen und setzt den Wert der externen Variable environ auf
       NULL. Nach diesem Aufruf konnen mittels putenv(3) und setenv(3) neue
       Variablen zu der Umgebung hinzugefugt werden.

RUCKGABEWERT
       Wurde die Funktion clearenv() erfolgreich ausgefuhrt, gibt sie Null
       zuruck. Ein von Null verschiedener Ruckgabewert zeigt einen Fehler an.

ATTRIBUTE
       Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt
       verwandten Ausdrucke.

       +--------------------+-------------------------+-----------------------+
       |Schnittstelle       | Attribut                | Wert                  |
       +--------------------+-------------------------+-----------------------+
       |clearenv()          | Multithread-Fahigkeit   | MT-Unsicher const:env |
       +--------------------+-------------------------+-----------------------+
STANDARDS
       putenv()
              POSIX.1-2008.

       clearenv()
              Keine.

GESCHICHTE
       putenv()
              Glibc 2.0. POSIX.1-2001.

       clearenv()
              Glibc 2.0.

       Verschiedenen Unix-Varianten (DG/UX, HP-UX, QNX, <?>). POSIX.9
       (Sprachanbindung zu FORTRAN77). POSIX.1-1996 hat clearenv() und
       putenv(3) zunachst nicht akzeptiert, sich jedoch umentschieden und
       geplant, die Funktionen in einer spateren Ausgabe des Standards
       aufzunehmen (siehe <section>B4.6.1). POSIX.1-2001 hat jedoch nur
       putenv(3) aufgenommen und clearenv() zuruckgewiesen.

ANMERKUNGEN
       Auf Systemen, auf denen clearenv() nicht verfugbar ist, erfullt die
       Zuweisung

           environ = NULL;

       moglicherweise denselben Zweck.

       Die Funktion clearenv() kann in sicherheitsbewussten Anwendungen
       nutzlich sein, bei denen die Umgebung, die an mit exec(3) ausgefuhrte
       Programme weitergegeben wird, genau gesteuert werden soll. Die
       Anwendung wurde dies erreichen, indem sie zuerst die Umgebung bereinigt
       und dann ausgewahlte Umgebungsvariablen hinzufugt.

       Beachten Sie, dass der Haupteffekt von clearenv() die Anpassung des
       Wertes des Zeigers environ(7) ist. Diese Funktion loscht nicht den
       Inhalt des Puffers, der die Umgebungsdefinitionen enthalt.

       In den Handbuchseiten von DG/UX und Tru64 steht: Falls environ von
       irgendetwas Anderem als den Funktionen putenv(3), getenv(3) oder
       clearenv() geandert wurde, wird clearenv() einen Fehler zuruckgeben und
       die Prozessumgebung bleibt unverandert.

SIEHE AUCH
       getenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Daniel Kobras
       <kobras@linux.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       und Mario Blattermann <mario.blaettermann@gmail.com> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer
       <debian-l10n-german@lists.debian.org>.

Linux man-pages 6.06           31. Oktober 2023                    clearenv(3)