NOM

       getenv, secure_getenv - Lire une variable d'environnement

SYNOPSIS

       #include <stdlib.h>

       char *getenv(const char *name);

       char *secure_getenv(const char *name);

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

       secure_getenv(): _GNU_SOURCE

DESCRIPTION

       La fonction getenv() recherche dans la liste des variables  d'environnement  une  variable
       nommée name, et renvoie un pointeur sur la chaîne value correspondante.

       La  fonction  secure_getenv()  spécifique  à  GNU  est  simplement  comme  getenv(),  à la
       différence qu'elle renvoie NULL dans les cas où « secure execution » (exécution sécurisée)
       est  nécessaire.  L'exécution  sécurisée  est nécessaire si l'une des conditions suivantes
       était vraie quand le programme exécuté pour le processus appelant a été chargé :

       *  l'UID effectif du processus ne correspondait pas son UID réel, ou le  GID  effectif  du
          processus  ne  correspondait  pas  son  GID  réel  (c'est  typiquement  le  cas lors de
          l'exécution d'un programme Set-UID ou Set-GID) ;

       *  le bit de capacité effective a été défini sur le fichier exécutable ;

       *  le processus a une capacité non vide permise définie.

       L'exécution sécurisée pourrait aussi être nécessaire si elle est déclenchée  par  certains
       modules de sécurité Linux.

       La fonction secure_getenv() a pour but d'être utilisée dans les bibliothèques polyvalentes
       pour éviter les vulnérabilités qui  pourraient  survenir  si  des  programmes  Set-UID  ou
       Set-GID faisaient accidentellement confiance à l'environnement.

VALEUR RENVOYÉE

       La   fonction   getenv()   renvoie   un   pointeur  sur  la  valeur  correspondante,  dans
       l'environnement du processus, ou NULL s'il n'y a pas de correspondance.

VERSIONS

       secure_getenv() a été introduite dans la glibc dans sa version 2.17.

CONFORMITÉ

       getenv() : SVr4, POSIX.1-2001, BSD 4.3, C89, C99.

       secure_getenv() est une extension GNU.

NOTES

       Les chaînes dans la liste des variables d'environnement sont de la forme nom=valeur.

       Telle qu'elle est généralement implémentée, getenv() renvoie un pointeur vers  une  chaîne
       de  la  liste  d'environnement.  L'appelant  doit faire attention de ne pas modifier cette
       chaîne car cela modifierait l'environnement du processus.

       L'implémentation de getenv() ne nécessite pas qu'elle soit réentrante. La  chaîne  pointée
       par  la  valeur de retour de getenv() peut être allouée statiquement et peut être modifiée
       par un appel ultérieur à getenv(), putenv(3), setenv(3) ou unsetenv(3).

       Le mode « secure execution » (exécution sécurisée) de  secure_getenv()  est  contrôlé  par
       l'attribut  AT_SECURE  contenu  dans  le  vecteur  auxiliaire  passé  du  noyau à l'espace
       utilisateur.

VOIR AUSSI

       clearenv(3), getauxval(3), putenv(3), setenv(3), unsetenv(3), capabilities(7), environ(7)

COLOPHON

       Cette page fait partie de la publication 3.65 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).  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> ».