STATFS(2)

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)