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



NAME
     ustat - get file system statistics

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

     int ustat(devt 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 [see mkdev(3C)].  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 */

     ustat fails if one or more of the following are true:

     EINVAL         dev is not the device number of a device con-
                    taining 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(2), statvfs(2), mkdev(3C), fs(4).

NOTES
     ustat will be phased out in favor of the statvfs function.

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