Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > U


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


ustat() — get mounted file system statistics


#include <ustat.h>

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


The ustat() system call returns information about a mounted file system. dev is a device number identifying a device containing a mounted file system. buf is a pointer to a ustat structure (defined in <ustat.h>) that includes the following elements:

int32_t f_tfree; /* Total free blocks */ ino_t f_tinode; /* Number of free inodes */ char f_fname[6]; /* Filsys name or null */ char f_fpack[6]; /* Filsys pack name or null */ int f_blksize; /* Block size */

The value of f_tfree is the number of free blocks of size f_blksize.


ustat() returns the following values:


Successful completion.


Failure. errno is set to indicate the error.


If ustat() fails, errno is set to one of the following values.


buf points outside the process's allocated address space. The reliable detection of this error is implementation dependent.


dev is not the device number of a device containing a mounted file system.


Result would overflow f_tfree or another field of the ustat struct.


ustat() is deprecated and should be used only by legacy 32-bit applications. statvfs() or statvfs64() are the recommended replacements.

For some file systems, the number of free inodes does not change. Such file systems will return -1 in the field f_tinode.

For some file systems, the inodes can be dynamically allocated. For such file systems, the field f_tinode contains the number of free inodes at the current time.


ustat() was developed by AT&T and HP.


touch(1), stat(2), statvfs(2), fs_vxfs(4), privileges(5).


ustat(): SVID2, SVID3, XPG2

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.