NAME

     ustat - get file system statistics


SYNOPSIS

     #include <sys/types.h>

     int ustat(dev_t dev, struct ustat * ubuf));


DESCRIPTION

     ustat returns information about a mounted file system.   dev
     is a device number identifying a device containing a mounted
     file system.  ubuf is a pointer to a  ustat  structure  that
     contains the following members:


          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_fname and  f_fpack,  are  not  imple-
     mented and will always be filled with null characters.


RETURN VALUE

     On success, zero is returned and the ustat structure pointed
     to by ubuf will be filled in.  On error, -1 is returned, and
     errno is set appropriately.


ERRORS

     EINVAL
          dev does not refer to a  device  containing  a  mounted
          file system.

     EFAULT
          ubuf points outside of your accessible address space.

     ENOSYS
          The mounted file system referenced by dev does not sup-
          port  this  operation,  or  any version of Linux before
          1.3.16.


NOTES

     ustat has only been provided for compatibility. All new pro-
     grams should use statfs(2) instead.


CONFORMING TO

     SVr4.  SVr4 documents additional error  conditions  ENOLINK,
     ECOMM, and EINTR but has no ENOSYS condition.


SEE ALSO

     statfs(2), stat(2)