Content-type: text/html Man page of statvfs

statvfs

Section: System Calls (2)
Index Return to Main Contents
 

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

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). 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.  

RELATED INFORMATION

Functions: stat(2)

Standards: standards(5) delim off


 

Index

NAME
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:17 GMT, October 02, 2010