NAME

statvfs, fstatvfs − Gets file system information

SYNOPSIS

#include <sys/statvfs.h>
#include <sys/types.h> int statvfs (
const char ∗path,
struct statvfs ∗buffer ); int fstatvfs (
int file_descriptor,
struct statvfs ∗buffer );

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

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

[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.  of the path parameter. 

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

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

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

RELATED INFORMATION

Functions: stat(2)