Index for Section 2

Alphabetical listing for G

Bottom of page

getfsstat(2)
NAME
  getfsstat - Get a list of all mounted file systems

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

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

PARAMETERS
  buf	  An array of statfs structures.

  bufsize Specifies the size in bytes of the buf parameter.

  flags	  Specifies one of the following flags:

	  MNT_WAIT
		  Wait for an update from each file system before returning
		  information.

	  MNT_NOWAIT
		  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
  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
  Upon successful completion, the number of statfs structures is returned.
  Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS
  If the getfsstat() function fails, errno may be set to one of the following
  values:

  [EFAULT]
	  The buf parameter points to an invalid address.

  [EIO]	  An I/O error occurred while reading from or writing to the file
	  system.

SEE ALSO
  Functions: statfs(2)

  Commands: mount(8)

Index for Section 2

Alphabetical listing for G

Top of page