CONFSTR(3)

NOM
confstr - Lire une chaine de caracteres dependant 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 chaine de caracteres dependante de la configuration.

L'argument name est la variable systeme reclamee. Les variables suivantes sont supportees :

_CS_PATH
    Une valeur de la variable PATH indiquant les emplacements ou les utilitaires standards POSIX.2 peuvent etre trouves.

Si buf est non-NULL, et si len est different de 0, alors confstr() copie la valeur de la chaine dans le buffer buf, en limitant la longueur a len - 1 caracteres, terminee par un caractere nul. 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 longueur de la variable systeme.

VALEUR RENVOYEE
Si name ne correspond a aucune variable de configuration valide, confstr() renvoie 0.

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);
if ((pathbuf = malloc(n)) == NULL) abort();
confstr(_CS_PATH, pathbuf, n);

ERREURS
Si la valeur de name est invalide, errno contient EINVAL.

CONFORME A
proposition POSIX.2

BUGS
POSIX.2 n'est pas encore un standard etabli, les informations contenues dans cette page de manuel peuvent changer.

VOIR AUSSI
sh(1), exec(3), system(3)