Content-type: text/html
statvfs, fstatvfs - Gets file system information
#include <sys/statvfs.h>
int statvfs (
const char *path,
struct statvfs *buffer );
int fstatvfs (
int file_descriptor,
struct statvfs *buffer );
Interfaces documented on this reference page conform to industry standards as follows:
fstatvfs(): POSIX.1, XPG4-UNIX
statvfs(): POSIX.1, XPG4
Refer to the standards(5) reference page for more information about industry standards and associated tags.
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.
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.
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 [Digital] The requested address is invalid. An I/O error occurred while reading the file system. A signal was caught during execution of the function. [Digital] The value returned by statvfs is invalid. Too many symbolic links were encountered in translating 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. [Digital] The requested address is invalid. [Digital] The value returned by pathconf, -1, is invalid.
Functions: stat(2)
Standards: standards(5) delim off