Loading

NOM

       clearenv - Vider l’environnement

SYNOPSIS

       #include <stdlib.h>

       int clearenv(void);

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

       clearenv() : _SVID_SOURCE || _XOPEN_SOURCE

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

       Cette  page  de  manuel  a  été traduite par Stéphan Rafin <stephan DOT
       rafin AT laposte DOT net> en 2002, puis a été mise  à  jour  par  Alain
       Portal  <aportal  AT  univ-montp2  DOT  fr>  jusqu’en  2006,  et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

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