man fpathconf (Fonctions bibliothèques) - Lire les valeurs de configuration concernant un fichier.
NOM
fpathconf, pathconf - Lire les valeurs de configuration concernant un fichier.
SYNOPSIS
#include <unistd.h> long fpathconf (int filedes, int name); long pathconf (char *path, int name);
DESCRIPTION
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 buffer 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, alors 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.
VALEUR RENVOYÉE
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.
CONFORMITÉ
POSIX.1
NOTES
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.
VOIR AUSSI
TRADUCTION
Christophe Blaess, 1996-2003.