NOMBRE¶
clearenv - limpia el entorno
SINOPSIS¶
#include <stdlib.h>
int clearenv(void);
DESCRIPCIÓN¶
La función
clearenv() borra todos los pares nombre-valor del
entorno y establece el valor de la variable externa
environ a NULL.
VALOR DEVUELTO¶
La función
clearenv() devuelve cero en caso de éxito, y un
valor distinto de cero en caso de fallo.
DISPONIBILIDAD¶
No está presente en libc4, libc5. En glibc está presente desde la
versión 2.0.
Varias variantes Unix (DGUX, HPUX, QNX, ...). POSIX.9 (enlaces para FORTRAN77).
POSIX.1-1996 no aceptaba
clearenv() ni
putenv(), pero más
tarde recapacitó y planificó estas funciones para ser incluidas
en una versión posterior de su estándar (cf. B.4.6.1). Sin
embargo, SUSv3 solo incorpora
putenv(), y rechaza
clearenv().
OBSERVACIONES¶
Utilizada en aplicaciones conscientes de la importancia de la seguridad. Si la
asignación
no está disponible probablemente lo estará.
En las páginas de manual de DGUX y Tru64 se puede leer: Si
environ
ha sido modificado por cualquier otro medio que no sea las funciones
putenv(),
getenv(), o
clearenv() entonces
clearenv() devolverá un error y el entorno del proceso
permanecerá intacto.
VÉASE TAMBIÉN¶
getenv(3),
putenv(3),
setenv(3),
unsetenv(3),
environ(5)