Seth Woolley's Man Viewer

ustat(2) - ustat, ustat - get file system statistics - man 2 ustat

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

USTAT(2)                   Linux Programmer's Manual                  USTAT(2)



NAME
       ustat - get file(1,n) system statistics

SYNOPSIS
       #include <sys/types.h>
       #include <unistd.h>    /* libc[45] */
       #include <ustat.h>     /* glibc2 */

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

DESCRIPTION
       ustat returns information about a mounted file(1,n) system.  dev is a device
       number identifying a device containing a mounted file(1,n) 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(3,n,n pack-old) name */


       The  last two fields, f_fname and f_fpack, are not implemented and will
       always be filled with NUL characters.

RETURN VALUE
       On success, zero is returned and the ustat structure pointed to by ubuf
       will  be  filled in.  On error(8,n), -1 is returned, and errno is set(7,n,1 builtins) appro-
       priately.

ERRORS
       EFAULT ubuf points outside of your accessible address space.

       EINVAL dev does not refer to a device containing a mounted file(1,n) system.

       ENOSYS The  mounted file(1,n) system referenced by dev does not support this
              operation, or any version(1,3,5) of Linux before 1.3.16.

CONFORMING TO
       SVr4.  SVr4 documents additional error(8,n) conditions ENOLINK,  ECOMM,  and
       EINTR but has no ENOSYS condition.

NOTES
       ustat  is deprecated and has only been provided for compatibility.  All
       new programs should use statfs(2) instead.

HP NOTES
       The HP version(1,3,5) of struct ustat has an additional field  f_blksize  that
       is  unknown  elsewhere.  HP warns: For some file(1,n) systems, the number of
       free inodes does not change.  Such file(1,n) systems will return -1  in(1,8)  the
       field  f_tinode.   For  some file(1,n) systems, inodes are dynamically allo-
       cated.  Such file(1,n) systems  will  return  the  current  number  of  free
       inodes.

SEE ALSO
       stat(1,2)(2), statfs(2)



Linux 2.4                         2003-08-04                          USTAT(2)

References for this manual (incoming links)