CONFSTR(3) Manuel du programmeur Linux CONFSTR(3)
NOM
confstr - Lire une chaîne de caractères dépendant de la
configuration.
SYNOPSIS
#define __USE_POSIX_2
#include <unistd.h>
size_t confstr (int name, char *buf, size_t len);
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_PATH
Une valeur de la variable PATH indiquant les
emplacements ou les utilitaires standards POSIX.2
peuvent être trouvés.
Si buf est non-NULL, et si len est différent de 0, alors
confstr() copie la valeur de la chaîne dans le buffer buf,
en limitant la longueur à len - 1 caractères, 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 longueur de la variable système.
VALEUR RENVOYÉE
Si name ne correspond à aucune variable de configuration
valide, confstr() renvoie 0.
EXEMPLES
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);
if ((pathbuf = malloc(n)) == NULL) abort();
confstr(_CS_PATH, pathbuf, n);
ERREURS
Si la valeur de name est invalide, errno contient EINVAL.
CONFORMITÉ
proposition POSIX.2
BUGS
POSIX.2 n'est pas encore un standard établi, les
GNU 23 Octobre 1996 1
CONFSTR(3) Manuel du programmeur Linux CONFSTR(3)
informations contenues dans cette page de manuel peuvent
changer.
VOIR AUSSI
sh(1), exec(3), system(3)
TRADUCTION
Christophe Blaess, 1997.
GNU 23 Octobre 1996 2