USTAT

Section: Linux Programmer's Manual (2)
Updated: 4 agosto 2003
Index Return to Main Contents

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/

This document was created by man2html, using the manual pages.
Time: 23:03:52 GMT, June 17, 2008