Index for Section 2

Alphabetical listing for S

Bottom of page

statvfs(2)
NAME
  statvfs, fstatvfs - Gets file system information

SYNOPSIS
  #include <sys/statvfs.h>

  int statvfs (
	  const char *path,
	  struct statvfs *buffer );

  int fstatvfs (
	  int file_descriptor,
	  struct statvfs *buffer );

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  fstatvfs():  POSIX.1, XSH5.0

  statvfs():  POSIX.1, XSH5.0

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

PARAMETERS
  path	    Specifies any file within the mounted file system.

  fildes    Specifies a file descriptor obtained by a successful open() or
	    fcntl() function.

  buffer    Points to a statvfs buffer to hold the returned information for
	    the statvfs() or fstatvfs() function.

DESCRIPTION
  The statvfs() and fstatvfs() functions return descriptive information about
  a mounted file system.  The returned information is in the format of a
  statvfs structure, which is defined in the sys/statvfs.h header file.

RETURN VALUES
  Upon successful completion, either function returns 0 (zero).	 Otherwise,
  it returns -1, sets errno to indicate the error.

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

  [EACCES]  Search permission is denied for a component of the path prefix

  [EFAULT]  [Tru64 UNIX]  The requested address is invalid.

  [EIO]	    An I/O error occurred while reading the file system.

  [EINTR]   A signal was caught during execution of the function.

  [EINVAL]  [Tru64 UNIX]  The value returned by statvfs is invalid.

  [ELOOP]   Too many symbolic links were encountered in translating the path
	    parameter detected.

  [ENAMETOOLONG]
	    The length of a component of the path parameter exceeds NAME_MAX
	    characters, or the length of the path parameter exceeds PATH_MAX
	    characters.

  [ENOENT]  The file referred to by the path parameter does not exist.

  [ENOTDIR] A component of the path prefix of the path parameter is not a
	    directory.

  If the fstatvfs() function fails, errno may be set to the following values:

  [EBADF]   The file descriptor parameter is not a valid file descriptor.

  [EFAULT]  [Tru64 UNIX]  The requested address is invalid.



  [EINVAL]  [Tru64 UNIX]  The value returned by fstatvfs is invalid.

RELATED INFORMATION
  Functions: stat(2)

  Standards: standards(5)

Index for Section 2

Alphabetical listing for S

Top of page