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 (https://www.gnu.org/licenses/gpl-3.0.html) 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>..