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.