NOM

       clearenv - Vider l'environnement

SYNOPSIS

       #include <stdlib.h>

       int clearenv(void);

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       clearenv() : _SVID_SOURCE || _BSD_SOURCE

DESCRIPTION

       La  fonction clearenv() efface de l'environnement toutes les paires « nom-valeur » et définit la variable
       externe environ à NULL.

VALEUR RENVOYÉE

       La fonction clearenv() renvoie zéro en cas de succès et une valeur non nulle en cas d'échec.

VERSIONS

       Absente de la libc4 et de la libc5. Présente dans la glibc depuis la version 2.0.

CONFORMITÉ

       Diverses variantes d'UNIX (DG/UX, HP-UX, QNX, ...). POSIX.9 (binding  pour  FORTRAN77).  POSIX.1-1996  ne
       définissait  pas  clearenv()  et putenv(3), mais, suite à un changement d'attitude, ces fonctions ont été
       programmées pour les versions futures de  ce  standard  (cf.  B.4.6.1).  Néanmoins,  POSIX.1-2001  ajouta
       seulement putenv(3), et refusa clearenv().

NOTES

       Cette  fonction  est  utilisée  dans  les  applications  sensibilisées  à  la sécurité. Si elle n'est pas
       disponible, l'affectation

           environ = NULL;

       rendra sans doute le même service.

       Les pages de manuel DG/UX et Tru64 indiquent : si  environ  a  été  modifiée  par  autre  chose  que  les
       fonctions putenv(3), getenv(3), et clearenv(), alors clearenv() renverra une erreur et l'environnement du
       processus sera inchangé.

VOIR AUSSI

       getenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Stéphan  Rafin  (2002),  Alain  Portal  <http://manpagesfr.free.fr/> (2006). Florentin Duneau et l'équipe
       francophone de traduction de Debian (2006-2009).

       Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org>  ou  par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».