CLEARENV(3)

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.

CONFORME A
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
    	environ = NULL;
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)