Home :: International :: Manuals :: Howto :: FAQ :: Man Pages :: Email Login

CONFSTR

Section: Manuel du programmeur Linux (3)
Updated: 21 juillet 2003
Index Return to Main Contents

NOM

confstr - Lire une chaîne de caractères dépendant de la configuration.

SYNOPSIS

#define _POSIX_C_SOURCE 2
or
#define _XOPEN_SOURCE
#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 n'est pas 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

BOGUES

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

VOIR AUSSI

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

TRADUCTION

Christophe Blaess, 1996-2003.

Home :: Copyright :: Privacy :: Credits :: Get a free Linuxinfor Email Account

Document on this page is part of "Linuxinfor Man Pages in HTML Format: man3". See Index Page for more info about Authorship and Copyright.