FPATHCONF(3)

NOM
fpathconf, pathconf - Lire les valeurs de configuration concernant un fichier

SYNOPSIS
#include <unistd.h>

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

DESCRIPTION
La fonction fpathconf() retourne la valeur de l'option de configuration name du descripteur de fichier ouvert fd.

La fonction pathconf() retourne la valeur de l'option de configuration name du fichier nommé path.

Les macros correspondantes définies dans <unistd.h> sont des valeurs minimales. Si une application désire tirer partie des valeurs qui peuvent évoluer, un appel à fpathconf() ou pathconf() renvoie des résultats plus précis.

Définir name avec l'une des constantes suivantes permet d'obtenir la valeur de l'option de configuration correspondante :

_PC_LINK_MAX
    renvoie le nombre maximal de liens sur le fichier. Si fd 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, fd ou path doit correspondre à un terminal. La macro correspondante est _POSIX_MAX_CANON.

_PC_MAX_INPUT
    renvoie la longueur maximale d'une ligne de saisie, fd ou path doit 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 fd. La macro correspondante est _POSIX_NAME_MAX.

_PC_PATH_MAX
    renvoie la longueur maximale des chemins d'accès relatifs lorsque path ou fd est le répertoire courant. La macro correspondante est _POSIX_PATH_MAX.

_PC_PIPE_BUF
    renvoie la taille du tampon d'un tube, où fd doit correspondre à un tube ou une FIFO et path doit correspondre à une FIFO. La macro correspondante est _POSIX_PIPE_BUF.

_PC_CHOWN_RESTRICTED
    renvoie une valeur non nulle si chown(2) ne peut pas être utilisé sur le fichier. Si fd ou path est un répertoire, ceci s'applique à l'ensemble des fichiers de 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. fd ou path doit correspondre à un terminal.

VALEUR RENVOYÉE
La limite est renvoyée si elle existe. Si le système n'a pas de limite pour la ressource réclamée, -1 est renvoyé et errno est inchangée. S'il se produit une erreur, -1 est renvoyé, et errno contient le code d'erreur.

CONFORMITÉ
POSIX.1-2001.

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 peuvent être énormes. Elles ne sont pas utilisables pour réaliser des allocations mémoire.

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

TRADUCTION

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 17 juillet 2008.

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.