ustat(2)                                                 ustat(2)



NAME
     ustat - gets file system statistics

SYNOPSIS
     #include <sys/types.h>
     #include <ustat.h>

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

DESCRIPTION
     ustat returns information about a mounted file system.  dev
     is a device number identifying a device containing a mounted
     file system. The parameter 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 */

     This system call is now obsolete.  The statfs system call is
     its successor.  (See ``Limitations'' later in this manual
     page.)

STATUS MESSAGES AND VALUES
     Upon successful completion, a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.  Here are the possible values of errno:

     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.

LIMITATIONS
     This function works only with file systems containing fewer
     than 65,536 inodes (see statfs(2)).

SEE ALSO
     stat(2), statfs(2), fs(4)










January 1992                                                    1