fstatvfs(2)                    DG/UX R4.11MU05                   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:

       unsigned long fbsize;     /* file system block size */
       unsigned long ffrsize;    /* file system fragment size */
       unsigned long fblocks;    /* total number of blocks of ffrsize
                                     contained in the file system */
       unsigned long fbfree;     /* total number of free blocks */
       unsigned long fbavail;    /* number of free blocks available to
                                     a user without appropriate privilege */
       unsigned long ffiles      /* The CPD file node limit at the file
                                     being examined. */
       unsigned long fffree      /* Number of file nodes at or below
                                     the file being examined that are
                                     available for allocation by a
                                     privileged user. */
       unsigned long ffavail     /* Number of file nodes in the file
                                     system available for allocation
                                     by a non-privileged user. */
       ulong ffsid;              /* file system identifier */
       char  fbasetype[FSTYPSZ]; /* null-terminated fs type name */
       ulong fflag;              /* bit mask of flags */
       ulong fnamemax;           /* maximum file name length */
       char  ffstr[32];          /* file system specific string */

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

       The fflag can return the following:

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

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.

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),
       f4capdefaults(5) in the security man pages.

NOTES
       On a traditional DG/UX system, appropriate privilege is granted by
       having an effective UID of 0 (root).  See the
       appropriateprivilege(5) man page for more information.

       On a system with DG/UX information security, appropriate privilege is
       granted by having one or more specific capabilities enabled in the
       effective capability set of the user.  See cap_defaults(5) for the
       default capabilities for this command.



Licensed material--property of copyright holder(s)