Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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)