Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for ustat (opensolaris section 2)

ustat(2)				   System Calls 				 ustat(2)

NAME
       ustat - get file system statistics

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

       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 identifying 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 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				   23 Jul 2001					 ustat(2)


All times are GMT -4. The time now is 06:18 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password