STATFS
Section: Linux Programmer's Manual (2)
Updated: 24 July 1993
Index
Return to Main Contents
NAME
statfs, fstatfs - get file system statistics
SYNOPSIS
#include <sys/vfs.h>
int statfs(const char *path, struct statfs *buf);
int fstatfs(int fd, struct statfs *buf);
DESCRIPTION
returns information about a mounted file system.
Path
is the path name of any file within the mounted filesystem.
Buf
is a pointer to a
statfs
structure defined as follows:
-
struct statfs {
long f_type; /* type of filesystem (see below) */
long f_bsize; /* optimal transfer block size */
long f_blocks; /* total data blocks in file system */
long f_bfree; /* free blocks in fs */
long f_bavail; /* free blocks avail to non-superuser */
long f_files; /* total file nodes in file system */
long f_ffree; /* free file nodes in fs */
fsid_t f_fsid; /* file system id */
long f_namelen; /* maximum length of filenames */
long f_spare[6]; /* spare for later */
};
File system types:
linux/ext2_fs.h: EXT2_OLD_SUPER_MAGIC 0xEF51
linux/ext2_fs.h: EXT2_SUPER_MAGIC 0xEF53
linux/ext_fs.h: EXT_SUPER_MAGIC 0x137D
linux/iso_fs.h: ISOFS_SUPER_MAGIC 0x9660
linux/minix_fs.h: MINIX_SUPER_MAGIC 0x137F /* orig. minix */
linux/minix_fs.h: MINIX_SUPER_MAGIC2 0x138F /* 30 char minix */
linux/minix_fs.h: NEW_MINIX_SUPER_MAGIC 0x2468 /* minix V2 */
linux/msdos_fs.h: MSDOS_SUPER_MAGIC 0x4d44
linux/nfs_fs.h: NFS_SUPER_MAGIC 0x6969
linux/proc_fs.h: PROC_SUPER_MAGIC 0x9fa0
linux/xia_fs.h: _XIAFS_SUPER_MAGIC 0x012FD16D
Fields that are undefined for a particular file system are set to -1.
Fstatfs
returns the same information about an open file referenced by descriptor
fd.
RETURN VALUE
On success, zero is returned. On error, -1 is returned, and
errno
is set appropriately.
ERRORS
For
statfs:
- ENOTDIR
-
A component of the path prefix of
Path
is not a directory.
- EINVAL
-
path
contains a character with the high-order bit set.
- ENAMETOOLONG
-
The length of a component of
path
exceeds 255 characters, or the length of
path
exceeds 1023 characters. [Documenter's note: are these values correct for
Linux?]
- ENOENT
-
The file referred to by
path
does not exist.
- EACCES
-
Search permission is denied for a component of the path prefix of
path.
- ELOOP
-
Too many symbolic links were encountered in translating
path.
- EFAULT
-
Buf
or
path
points to an invalid address.
- EIO
-
An I/O error occurred while reading from or writing to the file
system.
For
fstatfs:
- EBADF
-
Fd
is not a valid open file descriptor.
- EFAULT
-
Buf
points to an invalid address.
- EIO
-
An I/O error occurred while reading from or writing to the file
system.
SEE ALSO
stat(2)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 12:24:46 GMT, March 22, 2025