NAME    [Toc]    [Back]

       getfsstat - Get a list of all mounted file systems

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h> #include <sys/mount.h>

       int getfsstat(
               struct statfs buf[],
               long bufsize,
               int flags );

PARAMETERS    [Toc]    [Back]

       An  array  of  statfs  structures.   Specifies the size in
       bytes of the buf parameter.  Specifies one of the  following
 flags: Wait for an update from each file system before
       returning   information.    Return   information   without
       requesting  an update from each file system. Thus, some of
       the information will be out of date, but  the  getfsstat()
       function will not block because it is waiting for information
 from a file system that is unable to respond.

DESCRIPTION    [Toc]    [Back]

       The getfsstat() function  returns  information  about  all
       mounted  file  systems.  Upon  successful  completion, the
       buffer pointed to by the buf parameter is filled  with  an
       array of statfs structures, one for each mounted file system
 up to the size specified by the bufsize parameter.

       If the buf parameter is given as 0 (zero), the getfsstat()
       function  returns just the number of mounted file systems.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the number  of  statfs  structures
  is returned. Otherwise, -1 is returned and errno is
       set to indicate the error.

ERRORS    [Toc]    [Back]

       If the getfsstat() function fails, errno may be set to one
       of  the  following  values: The buf parameter points to an
       invalid address.  An I/O error occurred while reading from
       or writing to the file system.

SEE ALSO    [Toc]    [Back]

       Functions: statfs(2)

       Commands: mount(8)



                                                     getfsstat(2)