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, XPG4−UNIX

statvfs():  POSIX.1, XPG4

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

PARAMETERS

pathSpecifies any file within the mounted file system. 

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

bufferPoints 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][Digital]  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][Digital]  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][Digital]  The requested address is invalid. 

[EINVAL][Digital]  The value returned by pathconf, −1, is invalid. 

RELATED INFORMATION

Functions: stat(2)

Standards: standards(5)