Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       setenv, unsetenv - Changer ou ajouter une variable d'environnement

SYNOPSIS

       #include <stdlib.h>

       int setenv(const char *name, const char *value, int overwrite);

       int unsetenv(const char *name);

   Exigences  de  macros  de  test de fonctionnalites pour la glibc (consultez
   feature_test_macros(7)) :

       setenv(), unsetenv() :
           _BSD_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600

DESCRIPTION

       La fonction setenv() ajoute la variable name dans  l'environnement,  en
       lui  attribuant  la  valeur value, si name n'existe pas encore. Si name
       existe deja dans l'environnement, alors sa valeur est modifiee en value
       si  overwrite  est  non nul ; si overwrite vaut zero, la valeur de name
       n'est pas modifiee. Cette fonction cree des copies des chaines pointees
       par name et value (contrairement a putenv(3)).

       La  fonction  unsetenv() efface la variable name de l'environnement. Si
       name  n'existe  pas  dans  l'environnement,  la  fonction  reussit   et
       l'environnement n'est pas modifie.

VALEUR RENVOY'EE

       La  fonction  setenv()  renvoie  zero  si  elle  reussit, et -1 si elle
       echoue, auquel cas errno contient le code de l'erreur.

       La fonction unsetenv() renvoie zero si elle  reussit,  et  -1  si  elle
       echoue, auquel cas errno contient le code de l'erreur.

ERREURS

       EINVAL name  est  NULL,  pointe  vers  une  chaine  de  taille nulle ou
              contient un caractere << = >>.

       ENOMEM Pas assez de  memoire  pour  ajouter  une  nouvelle  variable  a
              l'environnement.

CONFORMIT'E

       BSD 4.3, POSIX.1-2001.

NOTES

       POSIX.1-2001   n'impose   pas   que   setenv()   et  unsetenv()  soient
       reentrantes.

       Avant la glibc 2.2.2, unsetenv() etait prototypee pour retourner void ;
       les  versions de la glibc plus recentes suivent le prototype conforme a
       POSIX.1-2001 comme montre dans le SYNOPSIS.

BOGUES

       POSIX.1-2001 indique que si name contient un caractere  << = >>,  alors
       setenv() devrait echouer avec l'erreur EINVAL ; toutefois, les versions
       anterieures a la glibc 2.3.4 autorisaient  l'utilisation  du  caractere
       << = >> dans name.

VOIR AUSSI

       clearenv(3), getenv(3), putenv(3), environ(7)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).   Nicolas
       Francois et l'equipe francophone de traduction de Debian (2006-2009).

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

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.