confstr(3) Library Functions Manual confstr(3)
NOM
confstr - Lire une chaîne de caractères dépendant de la configuration
BIBLIOTHÈQUE
Bibliothèque 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 fonctionnalités pour la glibc (consulter
feature_test_macros(7)) :
confstr() :
_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 sui-
vantes 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 « li-
nuxthreads-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 size est différent de 0, alors confstr()
copie la valeur de la chaîne dans le tampon buf, en limitant la lon-
gueur à size - 1 octets si nécessaire, terminée par un octet nul
(« \0 »). On peut détecter la troncature de la chaîne en comparant le
résultat de confstr() avec le paramètre size.
Si size est égal à zéro 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 valable, confstr() renvoie le
nombre d'octets (incluant l'octet nul terminal) qui doit être utilisé
pour enregistrer la variable. Cette valeur peut être plus grande que
size, 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 confi-
guration valable, confstr() renvoie 0 et errno est défini à EINVAL.
ERREURS
EINVAL La valeur de name n'est pas valable.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────┼──────────────────────┼─────────┤
│confstr() │ Sécurité des threads │ MT-Safe │
└─────────────────────────────────────┴──────────────────────┴─────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008.
EXEMPLES
Le fragment de code ci-dessous détermine le chemin d'accès aux utili-
taires 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), sys-
tem(3)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org> et David Prévot <david@tilapin.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
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 RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 5 février 2023 confstr(3)
Generated by dwww version 1.15 on Sat Jun 29 01:44:52 CEST 2024.