statvfs(2)							System Calls Manual							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

       Specifies  any  file  within  the  mounted  file  system.  Specifies a file descriptor obtained by a successful open() or fcntl() function.
       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 for-
       mat 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: Search permission is denied for a component of the path
       prefix [Tru64 UNIX]  The requested address is invalid.  An I/O error occurred while reading the file system.  A signal  was  caught  during
       execution  of the function.  [Tru64 UNIX]  The value returned by statvfs is invalid.  Too many symbolic links were encountered in translat-
       ing the path parameter detected.  The length of a component of the path parameter exceeds NAME_MAX characters, or the length  of  the  path
       parameter  exceeds  PATH_MAX characters.  The file referred to by the path parameter does not exist.  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: The file descriptor parameter is not a valid  file  descriptor.
       [Tru64 UNIX]  The requested address is invalid.	[Tru64 UNIX]  The value returned by fstatvfs is invalid.

RELATED INFORMATION

       Functions: stat(2)

       Standards: standards(5) delim off

																	statvfs(2)