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;	/* Blocchi liberi totali */
ino_t	f_tinode;	/* Numero di inode liberi */
char	f_fname[6];	/* Nome filsys */
char	f_fpack[6];	/* Nome filsys pack */

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)

COLOPHON
Questa pagina fa parte del rilascio 2.75 del progetto man-pages di Linux. Si può trovare una descrizione del progetto, e informazioni su come riportare bachi, presso http://www.kernel.org/doc/man-pages/. Per la traduzione in italiano si può fare riferimento a http://www.pluto.it/ildp/collaborare/