clearenv(3)

NOMBRE
clearenv - limpia el entorno

BIBLIOTECA
Biblioteca Estándar C (libc, -lc)

SINOPSIS
#include <stdlib.h>

int clearenv(void);

    Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

clearenv():
    /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 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.

ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
Interfaz | Atributo | Valor
clearenv() | Seguridad del hilo | MT-Unsafe const:env

ESTÁNDARES

putenv()
    POSIX.1-2008.

clearenv()
    None.

HISTORIAL

putenv()
    glibc 2.0. POSIX.1-2001.

clearenv()
    glibc 2.0.

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)

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.