ustat − Obtenir les statistiques sur le système de fichiers.

#include <sys/types.h>
#include <unistd.h>    /* libc[45] */
#include <ustat.h>     /* glibc2 */

int ustat(dev_t dev, struct ustat * ubuf);

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.

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.

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)

ustat() est fourni à titre de compatibilité, les nouveaux programmes devraient utiliser statfs(2) à la place.

SVr4.

ustat() est déprécié et n’est fourni que pour compatibilité. Tous les nouveaux programmes devraient utiliser statfs(2) à la place.

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.

stat(2), statfs(2)

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 14 août 2006.

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.