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)
