fpathconf(3) Library Functions Manual fpathconf(3) NOM fpathconf, pathconf - Obtenir des valeurs de configuration de fichiers BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include long fpathconf(int fd, int nom_option); long pathconf(const char *chemin, int nom_option); DESCRIPTION La fonction fpathconf() recupere la valeur de l'option de configuration nom_option pour le descripteur de fichier ouvert fd. La fonction pathconf() recupere la valeur de l'option de configuration nom_option pour le fichier chemin. Les macros correspondantes definies dans donnent des informations minimales ; si une application desire tirer partie des valeurs qui peuvent evoluer, elle peut faire appel a fpathconf() ou pathconf() pour obtenir des resultats plus detailles. Definir nom_option a l'une des constantes suivantes renvoie les options de configuration suivantes : _PC_LINK_MAX Le nombre maximal de liens sur le fichier. Si fd ou chemin correspondent a un repertoire, la valeur s'applique a l'ensemble du repertoire. La macro correspondante est _POSIX_LINK_MAX. _PC_MAX_CANON La longueur maximale des lignes de saisie formatees ; fd ou chemin doivent correspondre a un terminal. La macro correspondante est _POSIX_MAX_CANON. _PC_MAX_INPUT La longueur maximale d'une ligne de saisie ; fd ou chemin doivent correspondre a un terminal. La macro correspondante est _POSIX_MAX_INPUT. _PC_NAME_MAX La longueur maximale du nom d'un fichier que le processus a le droit de creer dans les repertoires chemin ou fd. La macro correspondante est _POSIX_NAME_MAX. _PC_PATH_MAX La longueur maximale des chemins relatifs lorsque chemin ou fd est le repertoire courant. La macro correspondante est _POSIX_PATH_MAX. _PC_PIPE_BUF Le nombre maximal d'octets qui peuvent etre ecrits en une seule fois dans un tube ou une file FIFO. Pour fpathconf(), fd doit faire reference a un tube ou a une file FIFO. Pour pathconf(), chemin doit faire reference a une file FIFO ou a un repertoire ; dans ce dernier cas, la valeur renvoyee correspondra aux files FIFO creees dans ce repertoire. La macro correspondante est _POSIX_PIPE_BUF. _PC_CHOWN_RESTRICTED La valeur renvoyee est positive si l'utilisation de chown(2) et fchown(2) pour changer l'UID d'un fichier est restreinte a un processus possedant des privileges appropries, et si leur utilisation pour changer le GID d'un fichier a une valeur autre que celle du GID effectif du processus ou de ses GID supplementaires est restreinte a un processus possedant les privileges appropries. En accord avec POSIX.1, cette variable sera toujours definie avec une valeur differente de -1. La macro correspondante est _POSIX_CHOWN_RESTRICTED. Si fd ou chemin fait reference a un repertoire, la valeur renvoyee est valable pour tous les fichiers du repertoire considere. _PC_NO_TRUNC Renvoie une valeur non nulle si l'acces a des noms de fichier plus long que _POSIX_NAME_MAX genere une erreur. La macro correspondante est _POSIX_NO_TRUNC. _PC_VDISABLE Renvoie une valeur non nulle si la gestion des caracteres speciaux peut etre desactivee, auquel cas fd ou path doit correspondre a un terminal. VALEUR RENVOYEE Ces fonctions peuvent renvoyer une des valeurs suivantes : - En cas d'erreur, la valeur renvoyee est -1 et errno est definie pour preciser l'erreur (par exemple, EINVAL pour signaler que nom_option est non valable). - Si nom_option correspond a une limite superieure ou inferieure et si cette limite est indeterminee, la valeur renvoyee est -1 et errno n'est pas modifiee (pour faire la distinction entre une limite indeterminee et une erreur, definir errno a zero avant l'appel, puis verifier si la valeur de errno est differente de zero lorsque la valeur renvoyee est -1). - Si nom_option est un nom d'option valable, une valeur positive est renvoyee si l'option correspondante est prise en charge, ou -1 dans le cas contraire. - Sinon, la valeur actuelle de l'option ou de la limite est renvoyee. Cette valeur ne sera pas plus restrictive que la valeur correspondante indiquee a l'application dans ou a la compilation de cette application. ERREURS EACCES pathconf() : la permission de recherche est refusee pour un des repertoires situes dans le prefixe de chemin de chemin. EBADF fpathconf() : fd n'est pas un descripteur de fichier valable. EINVAL nom_option n'est pas valable. EINVAL L'implementation ne prend pas en charge l'association de nom_option avec le fichier specifie. ELOOP pathconf() : trop de liens symboliques rencontres en resolvant chemin. ENAMETOOLONG pathconf() : chemin est trop long. ENOENT pathconf() : un composant de chemin n'existe pas ou chemin est une chaine vide. ENOTDIR pathconf() : un element utilise comme repertoire de chemin n'est en fait pas un repertoire. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |fpathconf(), pathconf() | Securite des threads | MT-Safe | +---------------------------------+--------------------------+---------+ STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001. NOTES Les fichiers dont la longueur du nom excede la valeur renvoyee pour nom_option, definie a _PC_NAME_MAX, peuvent exister dans le repertoire considere. Certaines valeurs renvoyees peuvent etre enormes ; elles ne sont pas utilisables pour realiser des allocations memoires. VOIR AUSSI getconf(1), open(2), statfs(2), confstr(3), sysconf(3) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Lucien Gentis Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 fpathconf(3)