Provided by: manpages-fr_1.67.0-1_all bug

NOM

       clearenv - Vider l’environnement.

SYNOPSIS

       #include <stdlib.h>

       int clearenv(void);

DESCRIPTION

       La fonction clearenv() efface de l’environnement toutes les paires nom-
       valeur et remplit la variable externe environ avec un NULL.

VALEUR RENVOYÉE

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

DISPONIBILITÉ

       Cette  fonction  est absente de la libc4 et la libc5. Elle est présente
       dans la  glibc depuis la version 2.0.

CONFORMITÉ

       Diverses variantes  d’Unix  (DGUX,  HPUX,  QNX,  ...).   POSIX.9  (pour
       FORTRAN77).   POSIX.1-1996  ne  définissait pas clearenv() et putenv(),
       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, SUSv3 ajouta seulement putenv(), 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 DGUX et Tru64 indiquent : Si environ a été modifiée
       par autre chose que les fonctions putenv(),  getenv(),  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)

TRADUCTION

       Stéphan Rafin, 2002.
       Christophe Blaess, 2003.