Linux Certif

Toute la documentation sur la certification Linux LPI

ustat

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;      /* Total free blocks */
 ino_t   f_tinode;     /* Number of free inodes */
 char    f_fname[6];   /* Filsys name */
 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.

VALEUR RENVOYÉE

ustat() renvoie zéro s'il réussit, et la structure 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'i-noeuds libres ne changent pas. De tels systèmes de fichiers renverront -1 dans le champ f_tinode. Pour certains systèmes de fichiers, les i-noeuds sont alloués dynamiquement. De tels systèmes de fichiers renverront le nombre courant d'i-noeuds 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 26 novembre 2007.

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.