fpathconf

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

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

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

TRADUCTION

Christophe Blaess, 1996-2003.