ustat(2)                       DG/UX R4.11MU05                      ustat(2)


NAME
       ustat - get file system device statistics

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

       int    ustat (device, ustatbuffer)
       devt  device;
       struct ustat * ustatbuffer;

   where:
       device         Device number of a mounted file system device

       ustatbuffer   Where the file system statistics are returned

DESCRIPTION
       Ustat returns information about a mounted file system device.  Device
       is a device number identifying a device containing a mounted file
       system.  Status information concerning the file system device
       contained on device is returned in the location pointed to by
       ustatbuffer. The fields returned in ustatbuffer include:

       daddrt  ftfree      The number of blocks with a size of DEV_BSIZ
                             bytes that are available for allocation on the
                             file system.
       inot    ftinode     The number of additional files that can be
                             created on the file system.
       char     ffname[6]   The file system name.  This field will be null
                             unless a label has been added to the file
                             system with labelit.
       char     ffpack[6]   The file system pack name.  This field will be
                             null unless a label has been added to the file
                             system with labelit.

       See the file /usr/include/sys/ustat.h for more details.

       If an error occurs, the contents of ustatbuffer are undefined.

ACCESS CONTROL
       None.

RETURN VALUE
       0      The file system device status information was successfully
              returned.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL    Device is not the device number of an active file system
                 device.

       EFAULT    Some part of the ustat structure pointed to by ustatbuffer
                 lies outside of the process's writable address space.

       EINTR     Interrupted ustat call.

FILES
       /usr/include/sys/ustat.h

SEE ALSO
       fstat(2), stat(2), fs(4).


Licensed material--property of copyright holder(s)