fstatvfs(2)                  DG/UX 5.4 Rel. 2.01                 fstatvfs(2)


NAME
       fstatvfs - return information about a file system

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

       int  fstatvfs (int fildes, struct statvfs *buffer)

   where:
       fildes    The open file descriptor of any file in the file system to
                 be reported on.

       buffer    Address of a statvfs buffer where file system information
                 will be returned

DESCRIPTION
       Filedes is a valid, active descriptor referring to an open file of
       any type.  The information returned concerns details about file
       system where the filedes resides and is the same as that of statvfs:

       ulong f_bsize;     /* file system block size */
       ulong f_frsize;    /* file system fragment size */
       ulong f_blocks;    /* total number of blocks of f_frsize
                                  contained in the file system */
       ulong f_bfree;     /* total number of free blocks */
       ulong f_bavail;    /* number of free blocks available to
                                  the non-super-user */
       ulong f_fsid;      /* file system identifier */
       char  f_basetype[FSTYPSZ]; /* null-terminated fs type
                                     name */
       ulong f_flag;      /* bit mask of flags */
       ulong f_namemax;   /* maximum file name length */
       char  f_fstr[32];  /* file system specific string */

       f_basetype contains the file system type name and is null-terminated.
       The value for the constant FSTYPSZ is defined in the <statvfs.h>
       file.

       The f_flag can return the following:

       ST_RDONLY          /* a read-only file system */
       ST_NOSUID          /* file system does not support the
                                  setuid or setgid semantics */

ACCESS CONTROL
       None.

RETURN VALUE
       0      The information was successfully returned in the statvfs
              buffer.

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




Licensed material--property of copyright holder(s)                         1

fstatvfs(2)                  DG/UX 5.4 Rel. 2.01                 fstatvfs(2)


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

       EBADF     The filedes is not an open file descriptor.

SEE ALSO
       chmod(2), chown(2), creat(2), dup(2), fcntl(2), link(2), mknod(2),
       open(2), pipe(2), read(2), time(2), unlink(2), ustat(2), utime(2),
       write(2).
















































Licensed material--property of copyright holder(s)                         2