clearenv

CLEARENV(3)              Manual del Programador de Linux             CLEARENV(3)



NOMBRE
       clearenv - limpia el entorno

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 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).

       ┌───────────┬────────────────────┬─────────────────────┐
       │Interfaz   Atributo           Valor               │
       ├───────────┼────────────────────┼─────────────────────┤
       │clearenv() │ Seguridad del hilo │ MT-Unsafe const:env │
       └───────────┴────────────────────┴─────────────────────┘

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 ⟨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>.  ⟨⟩.



Linux                          15 Septiembre 2017                    CLEARENV(3)