.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright 2004-2007, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH setenv 3 "8. Februar 2026" "Linux man\-pages 6.18" .SH BEZEICHNUNG setenv \- eine Umgebungsvariable ändern oder hinzufügen .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBint setenv(const char *\fP\fIname\fP\fB, const char *\fP\fIwert\fP\fB, int \fP\fIueberschreiben\fP\fB);\fP \fBint unsetenv(const char *\fP\fIname\fP\fB);\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fBsetenv\fP(), \fBunsetenv\fP(): .nf _POSIX_C_SOURCE >= 200112L || /* Glibc <= 2.19: */ _BSD_SOURCE .fi .SH BESCHREIBUNG Die Funktion \fBseten\fPv() fügt die Variable \fIname\fP mit dem Wert \fIwert\fP zur Umgebung hinzu, falls \fIname\fP nicht bereits existiert. Wenn \fIname\fP in der Umgebung existiert, dann wird der Wert auf \fIwert\fP geändert, falls \fIueberschreiben\fP nicht Null ist; wenn \fIueberschreiben\fP Null ist, dann wird der Wert von \fIname\fP nicht geändert (und \fBsetenv\fP() gibt einen Erfolgsstatus zurück). Diese Funktion erstellt Kopien der Zeichenketten, auf die \fIname\fP und \fIwert\fP zeigen (im Gegensatz zu \fBputenv\fP(3)). .P Die Funktion \fBunsetenv\fP() löscht die Variable \fIname\fP aus der Umgebung. Falls \fIname\fP in der Umgebung nicht existiert, dann hat die Funktion Erfolg und die Umgebung bleibt unverändert. .SH RÜCKGABEWERT Die Funktionen \fBsetenv\fP() und \fBunsetenv\fP() geben bei Erfolg Null oder bei einem Fehler \-1 zurück. Dann wird \fIerrno\fP gesetzt, um den Fehler anzuzeigen. .SH FEHLER .TP \fBEINVAL\fP \fIname\fP ist NULL, zeigt auf eine Zeichenkette der Länge 0 oder enthält ein »=«\-Zeichen. .TP \fBENOMEM\fP Der Speicher reicht nicht aus, um eine neue Variable zur Umgebung hinzuzufügen. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBsetenv\fP(), \fBunsetenv\fP() T} Multithread\-Fähigkeit MT\-Unsicher const:env .TE .SH STANDARDS POSIX.1\-2008. .SH GESCHICHTE POSIX.1\-2001, 4.3BSD. .P Vor Glibc 2.2.2 verlangte der Prototyp von \fBunsetenv\fP() die Rückgabe von \fIvoid\fP – aktuellere Versionen folgen dem POSIX.1\-2\-konformen Prototyp, der in der ÜBERSICHT gezeigt wird. .SH WARNUNGEN POSIX.1 erfordert nicht, dass \fBsetenv\fP() oder \fBunsetenv\fP() ablaufinvariant sind. .SH FEHLER POSIX.1 spezifiziert, dass \fBsetenv\fP() mit einem \fBEINVAL\fP\-Fehler fehlschlagen sollte, wenn \fIname\fP ein »=«\-Zeichen enthält; Versionen vor Glibc 2.3.4 erlaubten jedoch ein »=«\-Zeichen in \fIname\fP. .SH "SIEHE AUCH" \fBclearenv\fP(3), \fBgetenv\fP(3), \fBputenv\fP(3), \fBenviron\fP(7) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother , Chris Leick und Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .