Provided by: manpages-de-dev_4.23.1-1_all 
BEZEICHNUNG
setenv - eine Umgebungsvariable ändern oder hinzufügen
BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)
ÜBERSICHT
#include <stdlib.h> 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() fügt 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 geändert, falls
ueberschreiben nicht Null ist; wenn ueberschreiben Null ist, dann wird der Wert von name nicht geändert
(und setenv() gibt einen Erfolgsstatus zurück). Diese Funktion erstellt Kopien der Zeichenketten, auf die
name und wert zeigen (im Gegensatz zu putenv(3)).
Die Funktion unsetenv() löscht die Variable name aus der Umgebung. Falls name in der Umgebung nicht
existiert, dann hat die Funktion Erfolg und die Umgebung bleibt unverändert.
RÜCKGABEWERT
Die Funktionen setenv() und unsetenv() geben bei Erfolg Null oder bei einem Fehler -1 zurück. Dann wird
errno gesetzt, um den Fehler anzuzeigen.
FEHLER
EINVAL name ist NULL, zeigt auf eine Zeichenkette der Länge 0 oder enthält ein »=«-Zeichen.
ENOMEM Der Speicher reicht nicht aus, um eine neue Variable zur Umgebung hinzuzufügen.
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. ┌────────────────────────────────────────────────────────┬───────────────────────┬───────────────────────┐ │Schnittstelle │ Attribut │ Wert │ ├────────────────────────────────────────────────────────┼───────────────────────┼───────────────────────┤ │setenv(), unsetenv() │ Multithread-Fähigkeit │ MT-Unsicher const:env │ └────────────────────────────────────────────────────────┴───────────────────────┴───────────────────────┘
STANDARDS
POSIX.1-2008.
GESCHICHTE
POSIX.1-2001, 4.3BSD.
Vor Glibc 2.2.2 verlangte der Prototyp von unsetenv() die Rückgabe von void – aktuellere Versionen folgen
dem POSIX.1-2-konformen Prototyp, der in der ÜBERSICHT 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 enthält; Versionen vor Glibc 2.3.4 erlaubten jedoch ein »=«-Zeichen in name.
SIEHE AUCH
clearenv(3), getenv(3), putenv(3), environ(7)
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <krd@gulu.net>, Chris Leick <c.leick@vollbio.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 die Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.