USTAT(2)

NOME
ustat - riporta statistiche su di un file system

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

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

DESCRIZIONE
ustat() restituisce informazioni circa un file system purchè montato. dev è il numero indentificativo del device su cui è montato il file system. ubuf è un puntatore alla struttura ustat che contiene i seguenti campi:

    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 */

Gli utltimi due campi, f_fname and f_fpack, non sono implementati e saranno quindi riempiti con caratteri NUL.

VALORI RESTITUITI
In caso di successo viene restituito zero e la struttura ustat, puntata da ubuf viene impostata appropiamente. In caso di errore viene restituito -1, e errno contine il codice di errore verificatosi.

ERRORI

EFAULT
    ubuf punta al di fuori del proprio spazio di indirizzamento accessibile.

EINVAL
    dev non si riferisce ad un device su cui è montato un file sistem.

ENOSYS
    Il file system a cui dev si riferisce, non supporta questa operazione, oppure il kernel è antecedente al 1.3.16.

CONFORME A
SVr4.

NOTE
ustat() è mantenuta solo per compatibilità. Tutti i nuovi programmi devono usare statfs(2) al suo posto.

NOTE HP
La versione HP di ustat ha un campo aggiuntivo f_blksize che altrove è sconosciuto. HP avverte: Per alcuni filesystem, il numero di inode liberi non cambia. Questi filesystem restituiranno -1 nel campo f_tinode. Per alcuni filesystem, gli inode sono allocati dinamicamente. Tali filesystem restituiranno il numero di attuale di inode liberi.

VEDERE ANCHE
stat(2), statfs(2)