Scroll to navigation

PUTENV(3) Manual del Programador de Linux PUTENV(3)

NOMBRE

putenv - cambia o añade una variable de ambiente

SINOPSIS

#include <stdlib.h>
int putenv(char *cadena);

Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

putenv(): _XOPEN_SOURCE || /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _SVID_SOURCE

DESCRIPCIÓN

La función putenv() añade o cambia el valor de variables de entorno o ambiente. El argumento cadena es de la forma nombre=valor. Si nombre no existe ya en el ambiente, entonces cadena se añade al entorno. Si nombre sí existe, entonces el valor de nombre en el ambiente se cambia a valor. La cadena apuntada por cadena se convierte en parte del entorno, por lo que cambiar la cadena modifica el entorno.

VALOR DEVUELTO

The putenv() function returns zero on success, or nonzero if an error occurs. In the event of an error, errno is set to indicate the cause.

ERRORES

ENOMEM
Espacio insuficiente para alojar el nuevo ambiente.

ATRIBUTOS

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
Interfaz Atributo Valor
putenv() Seguridad del hilo MT-Unsafe const:env

CONFORME A

POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

NOTAS

The putenv() function is not required to be reentrant, and the one in glibc 2.0 is not, but the glibc 2.1 version is.

Since version 2.1.2, the glibc implementation conforms to SUSv2: the pointer string given to putenv() is used. In particular, this string becomes part of the environment; changing it later will change the environment. (Thus, it is an error to call putenv() with an automatic variable as the argument, then return from the calling function while string is still part of the environment.) However, glibc versions 2.0 to 2.1.1 differ: a copy of the string is used. On the one hand this causes a memory leak, and on the other hand it violates SUSv2.

La versión de 4.4BSD, como la de glibc 2.0, usa una copia.

SUSv2 elimina const del prototipo, y así lo hace glibc 2.1.3.

The GNU C library implementation provides a nonstandard extension. If string does not include an equal sign:


putenv("NAME");


then the named variable is removed from the caller's environment.

VÉASE TAMBIÉN

clearenv(3), getenv(3), setenv(3), unsetenv(3), environ(7)

COLOFÓN

Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

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 Juan Piernas <piernas@ditec.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..

6 Marzo 2019 GNU