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.57 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> ».