NOMBRE

clearenv - limpia el entorno

SINOPSIS

#include <stdlib.h>

int clearenv(void);

clearenv():
/* Glibc since 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

DESCRIPCIÓN

The clearenv() function clears the environment of all name-value pairs and sets the value of the external variable environ to NULL. After this call, new variables can be added to the environment using putenv(3) and setenv(3).

VALOR DEVUELTO

La función clearenv() devuelve cero en caso de éxito, y un valor distinto de cero en caso de fallo.

VERSIONES

Available since glibc 2.0.

ATRIBUTOS

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

CONFORME A

Varias variantes UNIX (DG/UX, HP-UX, QNX, ...). POSIX.9 (enlaces para FORTRAN77). POSIX.1-1996 no aceptaba clearenv() ni putenv(3), 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, POSIX.1-2001 solo incorpora putenv(3), y rechaza clearenv().

NOTAS

On systems where clearenv() is unavailable, the assignment

environ = NULL;

no está disponible probablemente lo estará.

The clearenv() function may be useful in security-conscious applications that want to precisely control the environment that is passed to programs executed using exec(3). The application would do this by first clearing the environment and then adding select environment variables.

Note that the main effect of clearenv() is to adjust the value of the pointer environ(7); this function does not erase the contents of the buffers containing the environment definitions.

En las páginas de manual de DG/UX y Tru64 se puede leer: Si environ ha sido modificado por cualquier otro medio que no sea las funciones putenv(3), getenv(3), 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(7)

COLOFÓN

Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..