setenv(3) Library Functions Manual setenv(3) BEZEICHNUNG setenv - eine Umgebungsvariable andern oder hinzufugen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int setenv(const char *name, const char *wert, int ueberschreiben); int unsetenv(const char *name); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): setenv(), unsetenv(): _POSIX_C_SOURCE >= 200112L || /* Glibc <= 2.19: */ _BSD_SOURCE BESCHREIBUNG Die Funktion setenv() fugt die Variable name mit dem Wert wert zur Umgebung hinzu, falls name nicht bereits existiert. Wenn name in der Umgebung existiert, dann wird der Wert auf wert geandert, falls ueberschreiben nicht Null ist; wenn ueberschreiben Null ist, dann wird der Wert von name nicht geandert (und setenv() gibt einen Erfolgsstatus zuruck). Diese Funktion erstellt Kopien der Zeichenketten, auf die name und wert zeigen (im Gegensatz zu putenv(3)). Die Funktion unsetenv() loscht die Variable name aus der Umgebung. Falls name in der Umgebung nicht existiert, dann hat die Funktion Erfolg und die Umgebung bleibt unverandert. RUCKGABEWERT Die Funktionen setenv() und unsetenv() geben bei Erfolg Null oder bei einem Fehler -1 zuruck. Dann wird errno gesetzt, um den Fehler anzuzeigen. FEHLER EINVAL name ist NULL, zeigt auf eine Zeichenkette der Lange 0 oder enthalt ein >>=<<-Zeichen. ENOMEM Der Speicher reicht nicht aus, um eine neue Variable zur Umgebung hinzuzufugen. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------+-------------------------+-----------------------+ |Schnittstelle | Attribut | Wert | +--------------------+-------------------------+-----------------------+ |setenv(), | Multithread-Fahigkeit | MT-Unsicher const:env | |unsetenv() | | | +--------------------+-------------------------+-----------------------+ STANDARDS POSIX.1-2008. GESCHICHTE POSIX.1-2001, 4.3BSD. Vor Glibc 2.2.2 verlangte der Prototyp von unsetenv() die Ruckgabe von void - aktuellere Versionen folgen dem POSIX.1-2-konformen Prototyp, der in der UBERSICHT gezeigt wird. WARNUNGEN POSIX.1 erfordert nicht, dass setenv() oder unsetenv() ablaufinvariant sind. FEHLER POSIX.1 spezifiziert, dass setenv() mit einem EINVAL-Fehler fehlschlagen sollte, wenn name ein >>=<<-Zeichen enthalt; Versionen vor Glibc 2.3.4 erlaubten jedoch ein >>=<<-Zeichen in name. SIEHE AUCH clearenv(3), getenv(3), putenv(3), environ(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Patrick Rother , Chris Leick und Mario Blattermann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 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 . Linux man-pages 6.06 31. Oktober 2023 setenv(3)