NOM¶

sysconf - Obtenir des informations de configuration au moment de l'exécution

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <unistd.h>

long sysconf(int nom);

DESCRIPTION¶

POSIX permet à une application de tester à la compilation ou à l'exécution si certaines options sont prises en charge ou de déterminer quelles sont les valeurs de certaines limites ou constantes configurables.

Cela est fait à la compilation en incluant <unistd.h> et/ou <limits.h> et en testant la valeur de certaines macros.

Pendant l'exécution, vous pouvez obtenir les valeurs numériques en utilisant la fonction sysconf(). Vous pouvez obtenir les valeurs numériques, qui peuvent dépendre du système de fichiers dans lequel un fichier réside en utilisant les appels fpathconf(3) et pathconf(3). Vous pouvez obtenir les valeurs de chaînes en utilisant confstr(3).

Les valeurs obtenues à partir de ces fonctions sont des constantes de configuration du système. Elles ne seront donc pas modifiées pendant la durée de vie d'un processus.

Pour les options, il y a typiquement une constante symbolique _POSIX_FOO qui peut être définie dans <unistd.h>. Si elle n'est pas définie, vous pouvez poser la question à l'exécution. Si elle est définie à -1, cela signifie que l'option n'est pas prise en charge. Si elle est définie à 0, les en-têtes et les fonctions en rapport existent mais vous devrez demander pendant l'exécution quel degré de prise en charge est disponible. Si elle est définie à une autre valeur que -1 ou 0, l'option est prise en charge. Habituellement, la valeur (par exemple 200112L) indique l'année et le mois de la révision POSIX qui décrit l'option. La glibc utilise la valeur 1 pour indiquer la prise en charge aussi longtemps que la révision POSIX n'a pas été publiée. L'argument de sysconf() sera _SC_FOO. Pour la liste des options, consultez posixoptions(7).

Pour les variables ou les limites, il s'agit typiquement d'une constante _FOO pouvant être définie dans <limits.h>, ou _POSIX_FOO, pouvant être définie dans <unistd.h>. La constante ne sera pas définie si la limite n'est pas indiquée. Si la constante est définie, elle fournit une valeur garantie et une valeur plus grande pourrait être prise en charge. Si une application veut tirer parti des valeurs pouvant varier entre les systèmes, l'appel de sysconf() permet d'obtenir ces informations. L'argument de sysconf() sera _SC_FOO.

VALEUR RENVOYÉE¶

La valeur renvoyée de sysconf() est une des suivantes :

• En cas d'erreur, la valeur de retour est -1 et errno est définie pour préciser l'erreur (par exemple, EINVAL indique que nom n'est pas valable).
• Si nom correspond à une limite maximale ou minimale et si cette limite est indéterminée, -1 est renvoyé et errno n'est pas modifié. (Pour distinguer une limite indéterminée d'une erreur, définissez errno à zéro avant l'appel, puis vérifiez si errno est différent de zéro quand -1 est renvoyé.)
• Si nom correspond à une option, une valeur positive est renvoyée si l'option est prise en charge, et -1 est renvoyé si l'option n'est pas prise en charge.
• Autrement, la valeur actuelle de l'option ou de la limite est renvoyée. Cette valeur ne sera pas plus restrictive que la valeur correspondante décrite pour l'application dans <unistd.h> ou <limits.h> quand l'application a été compilée.

ERREURS¶

EINVAL

nom n'est pas valable.

ATTRIBUTS¶

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

STANDARDS¶

POSIX.1-2008.

HISTORIQUE¶

POSIX.1-2001.

BOGUES¶

Il est difficile d'utiliser ARG_MAX, car il n'est pas précisé combien d'espace d'argument de exec(3) est utilisé par les variables d'environnement de l'utilisateur.

Certaines valeurs renvoyées peuvent être énormes ; elles ne sont pas utilisables pour réaliser des allocations mémoires.

VOIR AUSSI¶

bc(1), expr(1), getconf(1), locale(1), confstr(3), fpathconf(3), pathconf(3), posixoptions(7)

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.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.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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.