unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



statvfs(2)							   statvfs(2)



NAME

  statvfs, fstatvfs - Gets file	system information

SYNOPSIS

  #include <&lt;sys/statvfs.h>&gt;

  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 indus-
  try 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)