Provided by: manpages-fr-dev_2.64.1-1_all bug

NOM

       confstr - Lire une chaîne de caractères dépendant de la configuration

SYNOPSIS

       #include <unistd.h>

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

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       getcwd(): _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE

DESCRIPTION

       La  fonction  confstr()  fournit  la  valeur d’une chaîne de caractères
       dépendante de la configuration.

       L’argument  name  est  la  variable  système  réclamée.  Les  variables
       suivantes sont supportées :

       _CS_GNU_LIBC_VERSION   (Bibliothèque   GNU   C  seulement ;  depuis  la
       glibc 2.3.2)
              Une  chaîne qui identifie la version de la bibliothèque GNU C du
              système (par exemple, « glibc 2.3.4 »).

       _CS_GNU_LIBPTHREAD_VERSION (Bibliothèque GNU C  seulement ;  depuis  la
       glibc 2.3.2)
              Une chaîne qui identifie l’implémentation POSIX fournie  par  la
              bibliothèque  C  du  système  (par  exemple,  « NPTL 2.3.4 »  ou
              « linuxthreads-0.10 »).

       _CS_PATH
              Une valeur de la variable PATH indiquant les emplacements où les
              utilitaires standard POSIX.2 peuvent être trouvés.

       Si  buf  n’est  pas NULL, et si len est différent de 0, alors confstr()
       copie la valeur de la  chaîne  dans  le  tampon  buf,  en  limitant  la
       longueur  à len - 1 caractères si nécessaire, terminée par un caractère
       nul. On peut détecter la  troncature  de  la  chaîne  en  comparant  le
       résultat de confstr() avec le paramètre len.

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

VALEUR RENVOYÉE

       Si name est une variable de configuration valide, confstr() renvoie  le
       nombre  d’octets (incluant le caractère nul) qui doit être utilisé pour
       enregistrer la variable. Cette valeur peut être plus grande que len, ce
       qui signifie que la valeur de buf est tronquée.

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

ERREURS

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

CONFORMITÉ À

       POSIX.1-2001

EXEMPLE

       Le  fragment  de  code  ci-dessous  détermine  le  chemin  d’accès  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)

TRADUCTION

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  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> ».