confstr(3)                 Library Functions Manual                 confstr(3)

NOM
       confstr - Lire une chaine de caracteres dependant de la configuration

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

       size_t confstr(int name, char buf[.size], size_t size);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   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 size est different de 0, alors confstr()
       copie la valeur de la chaine dans le tampon buf, en limitant la
       longueur a size - 1 octets si necessaire, terminee par un octet nul
       (<< \0 >>). On peut detecter la troncature de la chaine en comparant le
       resultat de confstr() avec le parametre size.

       Si size est egal a zero et si buf vaut NULL, alors confstr() renvoie
       simplement la valeur definie ci-dessus.

VALEUR RENVOYEE
       Si name est une variable de configuration valable, confstr() renvoie le
       nombre d'octets (incluant l'octet nul terminal) qui doit etre utilise
       pour enregistrer la variable. Cette valeur peut etre plus grande que
       size, 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 defini a
       EINVAL.

ERREURS
       EINVAL La valeur de name n'est pas valable.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |confstr()                        | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001.

EXEMPLES
       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
       getconf(1), sh(1), exec(3), fpathconf(3), pathconf(3), sysconf(3),
       system(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                     confstr(3)