statvfs(3) Library Functions Manual statvfs(3) NOM statvfs, fstatvfs - Obtenir les statistiques d'un systeme de fichiers BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int statvfs(const char *restrict path, struct statvfs *restrict buf); int fstatvfs(int fd, struct statvfs *buf); DESCRIPTION La fonction statvfs() renvoie des informations sur un systeme de fichiers monte. path est un chemin vers n'importe quel fichier du systeme de fichiers monte. buf est un pointeur vers une structure statvfs approximativement definie comme ceci : struct statvfs { unsigned long f_bsize; /* taille de bloc du sys. de fich. */ unsigned long f_frsize; /* taille d'un fragment */ fsblkcnt_t f_blocks; /* taille du sys. de fich. en unite f_frsize */ fsblkcnt_t f_bfree; /* nombre de blocs libres */ fsblkcnt_t f_bavail; /* nombre de blocs libres pour util. ordinaires */ fsfilcnt_t f_files; /* nombre d'inoeuds */ fsfilcnt_t f_ffree; /* nombre d'inoeuds libres */ fsfilcnt_t f_favail; /* nombre d'inoeuds libres pour util. ordinaires */ unsigned long f_fsid; /* identifiant du sys. de fich. */ unsigned long f_flag; /* attributs de montage */ unsigned long f_namemax; /* longueur maximale de nom de fichier */ }; Les types fsblkcnt_t et fsfilcnt_t utilises ici sont definis dans . Auparavant les deux etaient des unsigned long. Le champ f_flags est un masque de bits indiquant diverses options de montage utilisees lors du montage de ce systeme de fichiers. Il contient zero ou plus des attributs suivants : ST_MANDLOCK Les verrouillages imperatifs sont permis sur le systeme de fichiers (consultez fcntl(2)). ST_NOATIME Ne pas mettre a jour les dates d'acces ; consultez mount(2). ST_NODEV Ne pas autoriser l'acces a des fichiers speciaux de peripherique sur ce systeme de fichiers. ST_NODIRATIME Ne pas mettre a jour les dates d'acces aux repertoires ; consultez mount(2). ST_NOEXEC Ne pas permettre l'execution de programmes sur ce systeme de fichiers. ST_NOSUID Les bits set-user-ID et set-group-ID sont ignores par exec(3) pour les fichiers executables sur ce systeme de fichiers. ST_RDONLY Le systeme de fichiers est monte en lecture seule. ST_RELATIME Mettre a jour la date d'acces par rapport a mtime ou ctime : consultez mount(2). ST_SYNCHRONOUS Les ecritures sont immediatement synchronisees avec le systeme de fichiers (voir la description de O_SYNC dans open(2)). Il n'est pas indique si tous les membres de la structure renvoyee ont un sens quel que soit le systeme de fichiers. fstatvfs() renvoie la meme information sur un fichier ouvert reference par le descripteur fd. VALEUR RENVOYEE En cas de succes, zero est renvoye. En cas d'erreur, -1 est renvoye et errno est definie pour preciser l'erreur. ERREURS EACCES (statvfs()) Un element du chemin d'acces path ne permet pas le parcours. (Consultez aussi path_resolution(7).) EBADF (fstatvfs()) fd n'est pas un descripteur de fichier ouvert valable. EFAULT buf ou path pointent en dehors de l'espace d'adressage accessible. EINTR L'appel a ete interrompu par un signal ; consultez signal(7). EIO Une erreur d'entree-sortie est survenue lors de la lecture sur le systeme de fichiers. ELOOP (statvfs()) Trop de liens symboliques rencontres dans la translation de path. ENAMETOOLONG (statvfs()) path est trop long. ENOENT (statvfs()) Le fichier indique par path n'existe pas. ENOMEM La memoire disponible du noyau n'etait pas suffisante. ENOSYS Le systeme de fichiers ne gere pas cet appel. ENOTDIR (statvfs()) Un element du chemin d'acces path n'est pas un repertoire. EOVERFLOW Certaines valeurs sont trop grandes pour etre representees dans la structure renvoyee. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |statvfs(), fstatvfs() | Securite des threads | MT-Safe | +---------------------------------+--------------------------+---------+ VERSIONS Seuls les attributs ST_NOSUID et ST_RDONLY du champ f_flag sont definis dans POSIX.1. Pour obtenir des definitions des autres attributs, il faut definir _GNU_SOURCE. NOTES Le noyau Linux a les appels systeme statfs(2) et fstatfs(2) pour gerer cet appel de bibliotheque. Les implementations par la glibc de pathconf(path, _PC_REC_XFER_ALIGN); pathconf(path, _PC_ALLOC_SIZE_MIN); pathconf(path, _PC_REC_MIN_XFER_SIZE); utilisent respectivement les champs f_frsize, f_frsize et f_bsize renvoyees par un appel a statvfs() avec l'argument path. Under Linux, f_favail is always the same as f_ffree, and there's no way for a filesystem to report otherwise. This is not an issue, since no filesystems with an inode root reservation exist. STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001. Avant la glibc 2.13, statvfs() remplissait les bits du champ f_flag en balayant les options de montage apparaissant dans /proc/mounts. Toutefois, a partir de Linux 2.6.36, l'appel systeme statfs(2) sous-jacent fournit les informations necessaires dans le champ f_flags et depuis la glibc 2.13, la fonction utilise les informations provenant de ce champ plutot que de balayer /proc/mounts. VOIR AUSSI statfs(2) 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 Jean-Pierre Giraud 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 statvfs(3)