USTAT(S)                 XENIX System V                  USTAT(S)



     Name
          ustat - Gets file system statistics.

     Syntax
          #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 */

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

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

               buf points outside the process' allocated address
               space.  [EFAULT]

     Return Value
          Upon successful completion, a value of 0 is returned.
          Otherwise, a value of -1 is returned and errno is set to
          indicate the error.

     See Also
          stat(S), filesystem(F), fsname(M)

     Notes
          When using file systems from previous versions of XENIX,
          fsck(C) must be run on the file system before mounting.
          Otherwise the ustat system call will not work correctly.
          This only needs to be done once.












     Page 1                                           (printed 8/7/87)