USTAT(2-SVR3)       RISC/os Reference Manual        USTAT(2-SVR3)



NAME
     ustat - get file system statistics

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

     int ustat (dev, buf)
     dev_t 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.  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 */

ERRORS
     ustat will fail if one or more of the following are true:

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

     [EFAULT]            buf points outside the process's allo-
                         cated address space.

     [EINTR]             A signal was caught during a ustat sys-
                         tem 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(2), fs(4).

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.








                        Printed 11/19/92                   Page 1