*** UNIX MANUAL PAGE BROWSER ***

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 stan- dards as follows: fstatvfs(): POSIX.1, XPG4-UNIX statvfs(): POSIX.1, XPG4 Refer to the standards(5) reference page for more information about in- dustry 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 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). Other- wise, it returns -1, sets errno to indicate the error. If the statvfs() function fails, errno may be set to one of the following val- ues: 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 para- meter detected. The length of a component of the path parameter ex- ceeds 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 re- turned by pathconf, -1, is invalid. RELATED INFORMATION Functions: stat(2) Standards: standards(5) delim off statvfs(2)