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

BEZEICHNUNG

       setenv - eine Umgebungsvariable ändern oder hinzufügen

ÜBERSICHT

       #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()  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. 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  Funktion  setenv()  gibt  bei Erfolg Null oder bei einem Fehler -1
       zurück. Dann wird errno so gesetzt,  dass  es  den  Grund  des  Fehlers
       anzeigt.

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

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.

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 Rückgabe  von
       void – aktuellere Versionen folgen dem POSIX.1-2001-konformen Prototyp,
       der in der ÜBERSICHT gezeigt wird.

FEHLER

       POSIX.1-2001  spezifiziert,  dass  setenv()  mit  einem   EINVAL-Fehler
       fehlschlagen  sollte,  wenn name ein »=«-Zeichen enthält; 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   Veröffentlichung   3.32   des   Projekts
       Linux-man-pages.  Eine Beschreibung des Projekts und Informationen, wie
       Fehler    gemeldet     werden     können,     finden     sich     unter
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother
       <krd@gulu.net> und Chris Leick <c.leick@vollbio.de> 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>.