fpathconf, pathconf − Lire les valeurs de configuration concernant un fichier.

#include <unistd.h>

long fpathconf (int filedes, int name);
long pathconf (char *path, int name);

La fonction fpathconf() retourne la valeur de l’option de configuration name concernant le descripteur de fichier ouvert filedes.

La fonction pathconf() retourne la valeur de l’option de configuration name concernant le fichier nommé path.

Les macros correspondantes définissent, dans <unistd.h>, des valeurs minimales. Si une application désire tirer parti des valeurs qui peuvent évoluer, l’appel de fpathconf() ou pathconf() renvoie des résultats plus précis.

Il faut mettre dans name une des constantes suivantes pour obtenir la valeur de l’option de configuration correspondante :

_PC_LINK_MAX

renvoie le nombre maximal de liens sur le fichier. Si filedes ou path correspondent à un répertoire, la valeur s’applique à l’ensemble du répertoire. La macro correspondante est _POSIX_LINK_MAX.

_PC_MAX_CANON

renvoie la longueur maximale des lignes de saisie formatée, filedes ou path doivent correspondre à un terminal. La macro correspondante est _POSIX_MAX_CANON.

_PC_MAX_INPUT

renvoie la longueur maximale d’une ligne de saisie, filedes ou path doivent correspondre à un terminal. La macro correspondante est _POSIX_MAX_INPUT.

_PC_NAME_MAX

renvoie la longueur maximale du nom de fichier que le processus a le droit de créer dans les répertoires path ou filedes. La macro correspondante est _POSIX_NAME_MAX_.

_PC_PATH_MAX

renvoie la longueur maximale des chemins d’accès relatifs quand path ou filedes est le répertoire courant. La macro correspondante est _POSIX_PATH_MAX.

_PC_PIPE_BUF

renvoie la taille du tampon d’un tube, quand filedes correspond à un tube ou une FIFO, ou quand path correspond à une FIFO. La macro correspondante est _POSIX_PIPE_BUF.

_PC_CHOWN_RESTRICTED

renvoie une valeur non nulle si chown(2) peut être utilisé sur le fichier. Si filedes ou path est un répertoire, ceci s’applique à l’ensemble des fichiers dans ce répertoire. La macro correspondante est _POSIX_CHOWN_RESTRICTED.

_PC_NO_TRUNC

renvoie une valeur non nulle si l’accès à un nom de fichier plus long que _POSIX_NAME_MAX déclenche une erreur. La macro correspondante est _POSIX_NO_TRUNC.

_PC_VDISABLE

renvoie une valeur non nulle si la gestion des caractères spéciaux peut être désactivée. filedes ou path doit correspondre à un terminal.

La limite demandée est renvoyée si elle existe. Si le systeme n’a pas de limite pour la ressource réclamée, −1 est renvoyé et errno est inchangé. S’il se produit une erreur −1 est renvoyé, et errno contient le code d’erreur.

POSIX.1-2001.

Les fichiers dont la longueur du nom excède la valeur renvoyée pour name valant _PC_NAME_MAX peuvent exister dans le répertoire considéré.

Certaines valeurs renvoyées sont énormes. Elles ne sont pas utilisables pour faire une allocation mémoire.

getconf(1), open(2), statfs(2), sysconf(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 23 octobre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 fpathconf ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.