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   fonctionnalités   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 déjà dans l'environnement, alors
       sa valeur est modifiée en value si overwrite est non nul ;  si  overwrite  vaut  zéro,  la
       valeur  de  name n'est pas modifiée, et setenv() renvoie un code de succès. Cette fonction
       crée des copies des chaînes pointées par name et value (contrairement à putenv(3)).

       La fonction unsetenv() efface la variable name de l'environnement. Si  name  n'existe  pas
       dans l'environnement, la fonction réussit et l'environnement n'est pas modifié.

VALEUR RENVOYÉE

       La  fonction setenv() renvoie zéro si elle réussit, et -1 si elle échoue, auquel cas errno
       contient le code de l'erreur.

       La fonction unsetenv() renvoie zéro si elle réussit, et -1  si  elle  échoue,  auquel  cas
       errno contient le code de l'erreur.

ERREURS

       EINVAL name  est  NULL,  pointe  vers  une chaîne de taille nulle ou contient un caractère
              « = ».

       ENOMEM Pas assez de mémoire pour ajouter une nouvelle variable à l'environnement.

CONFORMITÉ

       BSD 4.3, POSIX.1-2001.

NOTES

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

       Avant la glibc 2.2.2, unsetenv() était prototypée pour retourner void ; les versions de la
       glibc  plus  récentes  suivent  le  prototype conforme à POSIX.1-2001 comme montré dans le
       SYNOPSIS.

BOGUES

       POSIX.1-2001 indique que si name contient  un  caractère  « = »,  alors  setenv()  devrait
       échouer  avec  l'erreur  EINVAL ;  toutefois,  les  versions  antérieures à la glibc 2.3.4
       autorisaient l'utilisation du caractère « = » dans name.

VOIR AUSSI

       clearenv(3), getenv(3), putenv(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/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Nicolas  François  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> ».