.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" and Copyright (C) 2004, 2007 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:20:58 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Feb 14 21:47:50 1997 by Andries Brouwer (aeb@cwi.nl) .\" Modified 9 Jun 2004, Michael Kerrisk .\" Changed unsetenv() prototype; added EINVAL error .\" Noted nonstandard behavior of setenv() if name contains '=' .\" 2005-08-12, mtk, glibc 2.3.4 fixed the "name contains '='" bug .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH setenv 3 "20. Juli 2023" "Linux man\-pages 6.05.01" .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 .PP \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 .PP .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .PP \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)). .PP 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 .sp 1 .SH STANDARDS POSIX.1\-2008. .SH GESCHICHTE POSIX.1\-2001, 4.3BSD. .PP 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 .