Content-type: text/html Man page of statfs

statfs

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

NAME

statfs, fstatfs, ustat - Gets file system statistics  

SYNOPSIS

#include <sys/mount.h>

int statfs(        char *path,
       struct statfs *buffer)

int fstatfs(        int file_descriptor,
       struct statfs *buffer)

#include <sys/types.h> #include <ustat.h>

int ustat(        dev_t device,
       struct ustat *buffer );
 

PARAMETERS

Specifies any file within the mounted file system. Specifies a file descriptor obtained by a successful open() or fcntl() function. Points to a statfs buffer to hold the returned information for the statfs() or fstatfs() function; points to a ustat buffer to hold the returned information for the ustat() function. Specifies the ID of the device. It corresponds to the st_rdev member of the structure returned by the stat() function.  

DESCRIPTION

The statfs() and fstatfs() functions return information about a mounted file system. The returned information is in the format of the statfs structure that is declared in the </sys/mount.h> file.

The ustat() function also returns information about a mounted file system. The returned information is in the format of the ustat structure that is declared in the <ustat.h> file. This function is superseded by the statfs() and fstatfs() functions.  

NOTES

Earlier versions of the statfs() and fstatfs() functions documented a third parameter, length. This length parameter was never used by the kernel and has been deleted from the documentation.  

RETURN VALUES

Upon successful completion, 0 (zero) is returned. Otherwise, -1 is returned, and errno is set to indicate the error.  

ERRORS

If the statfs() function fails, errno may be set to one of the following values: Search permission is denied for a component of the path prefix of the path parameter. The buffer or path parameter points to a location outside of the allocated address space of the process. The path parameter contains a character with the high-order bit set. An I/O error occurred while reading from or writing to the file system. Too many symbolic links were encountered in translating the path parameter. 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. Indicates a stale NFS file handle. An opened file was deleted by the server or another client; a client cannot open a file because the server has unmounted or unexported the remote directory; or the directory that contains an opened file was either unmounted or unexported by the server.

If the fstatfs() or ustat() function fails, errno may be set to one of the following values: The file_descriptor parameter is not a valid file descriptor. The buffer parameter points to an invalid address. An I/O error occurred while reading from the file system.  

RELATED INFORMATION

Functions: stat(2) delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
RELATED INFORMATION

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