ustat(2)							      ustat(2)

NAME    [Toc]    [Back]

     ustat - get file system statistics

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     ustat returns information about a mounted file system.  dev is a device
     number identifying	a device containing a mounted file system [see
     makedev(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 containing	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    [Toc]    [Back]

     stat(2), statvfs(2), makedev(3C), fs(4).

NOTES    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111