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


NAME
       fstatfs - get information about a mounted file system

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

       int    fstatfs (fildes, statfsbuffer, len, fstype)
       int    fildes;
       struct statfs * statfsbuffer;
       int    len;
       int    fstype;

   where:
       fildes         File descriptor for any file within the file system to
                      be reported on

       statfsbuffer  A statfs structure where information about the file
                      system is returned

       len            Length of the user's buffer

       fstype         Type of the file system [see statfs(2)]

DESCRIPTION
       fildes is a valid, active descriptor referring to an open file of any
       type (ordinary, directory, FIFO, block special, character special, or
       symbolic link).  Terminal symbolic links are resolved in the system
       call that returned fildes.  Fstatfs returns the same information
       about the mounted file system that contains the file that statfs
       does.

ACCESS CONTROL
       None.

RETURN VALUE
       0      The file system 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:

       EBADF     Fildes is not a valid, active file descriptor.

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

       EINVAL    Fildes refers to a pipe or socket.

SEE ALSO
       chmod(2), chown(2), creat(2), fchmod(2), fchown(2), link(2),
       mknod(2), pipe(2), read(2), statfs(2), time(2), times(2), ustat(2),
       write(2), fs(4), statfs(5).


Licensed material--property of copyright holder(s)