NOMBRE

       putenv - cambia o añade una variable de ambiente

SINOPSIS

       #include <stdlib.h>

       int putenv(char *cadena);

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

       La función putenv() devuelve cero si acaba bien, ó -1 en caso de error.

ERRORES

       ENOMEM Espacio insuficiente para alojar el nuevo ambiente.

NOTA

       No es necesario que la función putenv() sea reentrante, y la de libc4, libc5 y glibc2.0 no lo es, pero la
       versión de glibc2.1 sí.

       Descripción  para  libc4,  libc5,  glibc:  si  el  argumento cadena es de la forma name, y no contiene el
       carácter `=', entonces la variable name se elimina del entorno.  Si putenv() tiene que reservar un  nuevo
       array  environ,  y  el array previo también fue reservado por putenv(), entonces será liberado. En ningún
       caso se liberará el anterior almacenamiento asociado a la propia variable de entorno.

       Las versiones de libc4 y libc5 siguen SUSv2: se usa el puntero cadena dado  a  putenv().  En  particular,
       esta  cadena  se  convierte  en  parte del entorno. El cambiarla después modificará el entorno.  (De esta
       manera, es un error llamar a putenv() pasando como argumento una variable automática, y después volver de
       la  función  invocadora  mientras  cadena forma todavía parte del entorno.)  Sin embargo, glibc 2.0-2.1.1
       difieren: se usa una copia de la cadena.  Por un lado, esto provoca una pérdida de memoria  y,  por  otro
       lado, viola SUSv2. Esto se ha solucionado en glibc2.1.2.

       La versión de BSD4.4, como la de glibc 2.0, usa una copia.

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

CONFORME A

       SVID 3, POSIX, BSD 4.3

VÉASE TAMBIÉN

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