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

ustat(2)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

ustat() — get mounted file system statistics

SYNOPSIS

#include <ustat.h>

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

DESCRIPTION

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.

RETURN VALUE

ustat() returns the following values:

0

Successful completion.

-1

Failure. errno is set to indicate the error.

ERRORS

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

[EFAULT]

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

[EINVAL]

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

[EOVERFLOW]

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

WARNINGS

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.

AUTHOR

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

SEE ALSO

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

STANDARDS CONFORMANCE

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.