.\" -*- coding: UTF-8 -*-
'\" t
.\" 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 "17 Mayo 2025" "Páginas de Manual de Linux 6.15" 
.SH NOMBRE
setenv \- cambia o añade una variable de entorno
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <stdlib.h>\fP
.P
\fBint setenv(const char *\fP\fInombre\fP\fB, const char *\fP\fIvalor\fP\fB, int \fP\fIsobreescribir\fP\fB);\fP
\fBint unsetenv(const char *\fP\fInombre\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de Macros de Prueba de Características para glibc (véase
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBsetenv\fP(), \fBunsetenv\fP():
.nf
    _POSIX_C_SOURCE >= 200112L
        || /* glibc <= 2.19: */ _BSD_SOURCE
.fi
.SH DESCRIPCIÓN
The \fBsetenv\fP()  function adds the variable \fIname\fP to the environment with
the value \fIvalue\fP, if \fIname\fP does not already exist.  If \fIname\fP does
exist in the environment, then its value is changed to \fIvalue\fP if
\fIoverwrite\fP is nonzero; if \fIoverwrite\fP is zero, then the value of \fIname\fP
is not changed (and \fBsetenv\fP()  returns a success status).  This function
makes copies of the strings pointed to by \fIname\fP and \fIvalue\fP (by contrast
with \fBputenv\fP(3)).
.P
The \fBunsetenv\fP()  function deletes the variable \fIname\fP from the
environment.  If \fIname\fP does not exist in the environment, then the
function succeeds, and the environment is unchanged.
.SH "VALOR DEVUELTO"
Las funciones \fBsetenv\fP() y \fBunsetenv\fP() devuelven cero si finalizan sin
ningún error, o \-1 si se produjo algún error definiendo \fIerrno\fP con el
valor correspondiente.
.SH ERRORES
.TP 
\fBEINVAL\fP
\fIname\fP is NULL, points to a string of length 0, or contains an \[aq]=\[aq]
character.
.TP 
\fBENOMEM\fP
No hay disponible suficiente memoria para añadir una nueva variable de
entorno.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBsetenv\fP(),
\fBunsetenv\fP()
T}	Seguridad del hilo	MT\-Unsafe const:env
.TE
.SH ESTÁNDARES
POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, 4.3BSD.
.P
Prior to glibc 2.2.2, \fBunsetenv\fP()  was prototyped as returning \fIvoid\fP;
more recent glibc versions follow the POSIX.1\-compliant prototype shown in
the SYNOPSIS.
.SH CAVEATS
POSIX.1 does not require \fBsetenv\fP()  or \fBunsetenv\fP()  to be reentrant.
.SH ERRORES
POSIX.1 specifies that if \fIname\fP contains an \[aq]=\[aq] character, then
\fBsetenv\fP()  should fail with the error \fBEINVAL\fP; however, versions of
glibc before glibc 2.3.4 allowed an \[aq]=\[aq] sign in \fIname\fP.
.SH "VÉASE TAMBIÉN"
\fBclearenv\fP(3), \fBgetenv\fP(3), \fBputenv\fP(3), \fBenviron\fP(7)
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es>
y
Marcos Fouces <marcos@debian.org>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .