unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



getfsstat(2)							 getfsstat(2)



NAME
  getfsstat - Gets list	of all mounted file systems

SYNOPSIS

  #include <&lt;sys/types.h>&gt;
  #include <&lt;sys/mount.h>&gt;
  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 return-
		      ing information.

	    MNT_NOWAIT
		      Information is returned 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	waiting	for information	from a file system
		      that is unable to	respond.

DESCRIPTION

  The getfsstat() function returns information about all mounted file sys-
  tems.	Upon successful	completion, the	buffer pointed to by the buf parame-
  ter 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 VALUE

  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.

RELATED	INFORMATION

  Functions: statfs(2)

  Commands: mount(8)