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

NOM

       confstr - Lire une chaine de caracteres dependant de la configuration

SYNOPSIS

       #include <unistd.h>

       size_t confstr(int name, char *buf, size_t len);

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

       confstr() : _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE

DESCRIPTION

       La fonction confstr() fournit la  valeur  d'une  chaine  de  caracteres
       dependante de la configuration.

       L'argument  name  est  la  variable  systeme  reclamee.  Les  variables
       suivantes sont supportees :

       _CS_GNU_LIBC_VERSION  (Bibliotheque  GNU  C   seulement ;   depuis   la
       glibc 2.3.2)
              Une  chaine qui identifie la version de la bibliotheque GNU C du
              systeme (par exemple, << glibc 2.3.4 >>).

       _CS_GNU_LIBPTHREAD_VERSION (Bibliotheque GNU C  seulement ;  depuis  la
       glibc 2.3.2)
              Une  chaine  qui identifie l'implementation POSIX fournie par la
              bibliotheque C du  systeme  (par  exemple,  << NPTL 2.3.4 >>  ou
              << linuxthreads-0.10 >>).

       _CS_PATH
              Une valeur de la variable PATH indiquant les emplacements ou les
              utilitaires standard POSIX.2 peuvent etre trouves.

       Si buf n'est pas NULL, et si len est different de  0,  alors  confstr()
       copie  la  valeur  de  la  chaine  dans  le  tampon buf, en limitant la
       longueur a len - 1 caracteres si necessaire, terminee par un  caractere
       nul  (<< \0 >>).  On  peut  detecter  la  troncature  de  la  chaine en
       comparant le resultat de confstr() avec le parametre len.

       Si len est  nulle,  et  si  buf  vaut  NULL,  alors  confstr()  renvoie
       simplement la valeur definie ci-dessus.

VALEUR RENVOY'EE

       Si  name est une variable de configuration valide, confstr() renvoie le
       nombre d'octets (incluant le caractere nul) qui doit etre utilise  pour
       enregistrer la variable. Cette valeur peut etre plus grande que len, ce
       qui signifie que la valeur de buf est tronquee.

       Si name est une variable de configuration valable  sans  valeur,  alors
       confstr()  renvoie  0.  Si  name  ne  correspond  pas a une variable de
       configuration valable, confstr() renvoie  0  et  errno  est  definie  a
       EINVAL.

ERREURS

       EINVAL Si la valeur de name n'est pas valable.

CONFORMIT'E

       POSIX.1-2001.

EXEMPLE

       Le  fragment  de  code  ci-dessous  determine  le  chemin  d'acces  aux
       utilitaires POSIX.2 :

           char *pathbuf;
           size_t n;

           n = confstr(_CS_PATH,NULL,(size_t) 0);
           pathbuf = malloc(n);
           if (pathbuf == NULL)
               abort();
           confstr(_CS_PATH, pathbuf, n);

VOIR AUSSI

       sh(1), exec(3), system(3)

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).  Florentin
       Duneau 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> >>.

GNU                             3 fevrier 2010                      CONFSTR(3)