Provided by: manpages-es_1.55-8_all bug

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)