Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG
       setenv - eine Umgebungsvariable andern oder hinzufugen


"UBERSICHT
       #include <stdlib.h>

       int setenv(const char *name, const char *wert,
                  int ueberschreiben);

       int unsetenv(const char *name);

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       setenv(), unsetenv():
           _BSD_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600


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. 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.


R"UCKGABEWERT
       Die  Funktion  setenv()  gibt  bei Erfolg Null oder bei einem Fehler -1
       zuruck. Dann wird errno so gesetzt,  dass  es  den  Grund  des  Fehlers
       anzeigt.

       Die  Funktion  unsetenv() gibt bei Erfolg Null oder bei einem Fehler -1
       zuruck. Dann wird errno so gesetzt,  dass  es  den  Grund  des  Fehlers
       anzeigt.


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.


KONFORM ZU
       4.3BSD, POSIX.1-2001.


ANMERKUNGEN
       POSIX.1-2001   erfordert   nicht,   dass   setenv()   oder   unsetenv()
       ablaufinvariant sind.

       Vor Glibc 2.2.2 verlangte der Prototyp von unsetenv() die Ruckgabe  von
       void - aktuellere Versionen folgen dem POSIX.1-2001-konformen Prototyp,
       der in der UBERSICHT gezeigt wird.


FEHLER
       POSIX.1-2001  spezifiziert,  dass  setenv()  mit  einem   EINVAL-Fehler
       fehlschlagen sollte, wenn name ein >>=<<-Zeichen enthalt; Versionen von
       Glibc vor 2.3.4 erlaubten jedoch ein >>=<<-Zeichen in name.


SIEHE AUCH
       clearenv(3), getenv(3), putenv(3), environ(7)


KOLOPHON
       Diese  Seite  ist  Teil  der   Veroffentlichung   3.32   des   Projekts
       Linux-man-pages.  Eine Beschreibung des Projekts und Informationen, wie
       Fehler    gemeldet     werden     konnen,     finden     sich     unter
       http://www.kernel.org/doc/man-pages/.


"UBERSETZUNG
       Die  deutsche Ubersetzung dieser Handbuchseite wurde von Patrick Rother
       <krd@gulu.net> und Chris Leick <c.leick@vollbio.de> 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     <debian-l10n-
       german@lists.debian.org>.