statfs(2)statfs(2)NAME
statfs, fstatfs - get file system statistics
SYNOPSISDESCRIPTION
returns status information for a mounted file system.
returns similar information for an open file.
The parameters for the and functions are as follows:
path is a pointer to a path name of any file within the
mounted file system.
buf is a pointer to a structure, which is where the file
system status information is stored.
fildes is a file descriptor for an open file, which is cre‐
ated with the successful completion of an or system
call (see open(2), creat(2), dup(2), fcntl(2), or
pipe(2)).
The structure contains the following members:
int32_t f_bavail; /* free blocks available to non-superusers
or users without the LIMIT privilege */
int32_t f_bfree; /* free blocks */
int32_t f_blocks; /* total blocks in file system */
int32_t f_bsize; /* fundamental file system block size in bytes */
int32_t f_ffree; /* free file nodes in file system */
int32_t f_files; /* total file nodes in file system */
int32_t f_type; /* type of info, zero for now */
fsid_t f_fsid /* file system ID. f_fsid[1] is the file system
type; see sysfs(2) */
The fields and are expressed in terms of blocks of size
A file node is a structure in the file system hierarchy that describes
a file.
Fields that are undefined for a particular file system are set to −1.
Security Restrictions
The field is the number of free blocks available to non-superusers or
users without the privilege. See privileges(5) for more information
about privileged access on systems that support fine-grained privi‐
leges.
RETURN VALUE
and return 0 upon successful completion; otherwise, they return −1 and
set to indicate the error.
ERRORS
If fails, is set to one of the following values:
Search permission is denied for a component of the path prefix.
buf or path point to an invalid address.
An I/O error occurred while reading from or writing to the file
system.
Too many symbolic links are encountered during path-name trans‐
lation.
The length of the specified path name exceeds
bytes, or the length of a component of the
path name exceeds bytes while is in effect.
The named file does not exist (for example,
path is null or a component of path does
not exist).
A component of the path prefix is not a directory.
Result would overflow one or more fields of the
struct.
If fails, is set to one of the following values:
fildes is not a valid open file descriptor.
buf points to an invalid address.
An I/O error occurs while reading from or writing to the file
system.
WARNINGS
is deprecated and should be used only by legacy 32-bit applications.
or are the recommended replacements.
AUTHOR
and were developed by Sun Microsystems, Inc.
SEE ALSOdf(1M), stat(2), statvfs(2), ustat(2), privileges(5).
statfs(2)