USTAT(S) UNIX System V USTAT(S)
Name
ustat - get file system statistics
Syntax
#include <sys/types.h>
#include <ustat.h>
int ustat (dev, buf)
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 that includes the following elements:
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 */
The last two fields, f_name and f_fpack may not have
significant information on all systems, and, in that case,
will contain the null character.
The ustat system call will fail if one or more of the
following is true:
[EINVAL] dev is not the device number of a device
containing a mounted file system.
[EFAULT] buf points outside the process's allocated
address space.
[EINTR] A signal was caught during a ustat system
call.
[ENOLINK] dev is on a remote machine and the link to
that machine is no longer active.
[ECOMM] dev is on a remote machine and the link to
that machine is no longer active.
See Also
stat(S), statfs(S), fs(F).
Diagnostics
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Standards Conformance
ustat is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
and The X/Open Portability Guide II of January 1987.
(printed 6/20/89)