USTAT
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 4 août 2003
Index
Menu principal
NOM
ustat - Obtenir les statistiques sur le système de fichiers
SYNOPSIS
#include <sys/types.h>
#include <unistd.h> /* libc[45] */
#include <ustat.h> /* glibc2 */
int ustat(dev_t dev, struct ustat * ubuf);
DESCRIPTION
ustat()
renvoie des informations sur un système de fichiers monté.
dev
est le numéro de périphérique contenant le système de fichiers monté.
ubuf
est un pointeur sur une structure
ustat
définie ainsi :
daddr_t f_tfree; /* Nombre total de blocs libres */
ino_t f_tinode; /* Nombre d'inœuds libres */
char f_fname[6]; /* Nom du système de fichiers */
char f_fpack[6]; /* Filsys pack name */
Les deux derniers champs,
f_fname
et
f_fpack,
ne sont pas implémentés actuellement
et sont remplis avec des octets nuls (« \0 »).
VALEUR RENVOYÉE
ustat()
renvoie zéro s'il réussit, et la structure
ustat
pointée par
ubuf
sera remplie.
S'il échoue, l'appel système renvoie -1 et
errno
contient le code d'erreur.
ERREURS
- EFAULT
-
ubuf
pointe en-dehors de l'espace d'adressage accessible.
- EINVAL
-
dev
n'est pas un périphérique contenant un système de fichiers monté.
- ENOSYS
-
Le système de fichiers monté indiqué par
dev
ne permet pas cette opération.
(Cette erreur est aussi
produite par tous les noyaux Linux antérieurs au 1.3.16)
CONFORMITÉ
SVr4.
NOTES
ustat()
est déprécié et n'est fourni que pour compatibilité.
Tous les nouveaux programmes devraient utiliser
statfs(2)
à la place.
Notes HP-UX
La version HP-UX de la structure
ustat
a un champ supplémentaire,
f_blksize,
qui est inconnu ailleurs.
HP-UX avertit :
pour certains systèmes de fichiers,
le nombre d'inœuds libres ne changent pas.
De tels systèmes de fichiers renverront -1 dans le champ
f_tinode.
Pour certains systèmes de fichiers,
les inœuds sont alloués dynamiquement.
De tels systèmes de fichiers renverront le nombre courant
d'inœuds libres.
VOIR AUSSI
stat(2),
statfs(2)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 15 octobre 1996
et révisée le 23 juin 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 2 ustat ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- NOTES
-
- Notes HP-UX
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 23 juin 2008