Manual Pages for UNIX Operating System command usage for man ustat

System Calls                                             ustat(2)



NAME
     ustat - get file system statistics

SYNOPSIS
     #include 
     #include 

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


DESCRIPTION
     The ustat() function returns  information  about  a  mounted
     file  system.  The dev argument is a device number identify-
     ing  a  device  containing  a  mounted  file   system   (see
     makedev(3C)).  The  buf  argument  is  a  pointer to a ustat
     structure that includes 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 f_fname and f_fpack members may not contain  significant
     information on all systems; in this case, these members will
     contain the null character as the first character.

RETURN VALUES
     Upon successful completion, 0 is returned. Otherwise,  -1 is
     returned and errno is set to indicate the error.

ERRORS
     The ustat() function will fail if:

     ECOMM        The dev argument is on a remote machine and the
                  link to that machine is no longer active.


     EFAULT       The buf argument points to an illegal address.


     EINTR        A signal was caught during the execution of the
                  ustat() function.


     EINVAL       The dev argument is not the device number of  a
                  device containing a mounted file system.


     ENOLINK      The dev argument refers to a device on a remote
                  machine  and  the  link   to that machine is no



SunOS 5.11          Last change: 23 Jul 2001                    1






System Calls                                             ustat(2)



                  longer active.


     EOVERFLOW    One  of   the   values   returned   cannot   be
                  represented in the structure pointed to by buf.


USAGE
     The statvfs(2) function should be used in favor of ustat().

SEE ALSO
     stat(2), statvfs(2), makedev(3C), lfcompile(5)

BUGS
     The NFS revision 2 protocol does not permit  the  number  of
     free  files  to  be  provided to the client; therefore, when
     ustat() has completed on an NFS  file  system,  f_tinode  is
     always -1.





































SunOS 5.11          Last change: 23 Jul 2001                    2