DragonFly On-Line Manual Pages


STATVFS(2)		 DragonFly System Calls Manual		    STATVFS(2)

NAME

statvfs, fstatvfs -- get file system statistics

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <sys/statvfs.h> int statvfs(const char *path, struct statvfs *buf); int fstatvfs(int fd, struct statvfs *buf);

DESCRIPTION

statvfs() returns information about a mounted file system. path is the path name of any file within the mounted file system. buf is a pointer to a statvfs structure defined as follows: struct statvfs { unsigned long f_bsize; /* file system block size */ unsigned long f_frsize; /* fundamental file system block size */ fsblkcnt_t f_blocks; /* number of blocks (unit f_frsize) */ fsblkcnt_t f_bfree; /* free blocks in file system */ fsblkcnt_t f_bavail; /* free blocks for non-root */ fsfilcnt_t f_files; /* total file inodes */ fsfilcnt_t f_ffree; /* free file inodes */ fsfilcnt_t f_favail; /* free file inodes for to non-root */ unsigned long f_fsid; /* file system id */ unsigned long f_flag; /* bit mask of f_flag values */ unsigned long f_namemax; /* maximum filename length */ uid_t f_owner; /* user that mounted the filesystem */ unsigned int f_type; /* filesystem type */ uint64_t f_syncreads; /* count of sync reads since mount */ uint64_t f_syncwrites; /* count of sync writes since mount */ uint64_t f_asyncreads; /* count of async reads since mount */ uint64_t f_asyncwrites; /* count of async writes since mount */ /* * DragonFly extensions - full uuid FSID and owner */ uuid_t f_fsid_uuid; uuid_t f_uid_uuid; }; /* * f_flag definitions */ #define ST_RDONLY 0x00000001 /* fs is read-only */ #define ST_NOSUID 0x00000002 /* ST_ISUID or ST_ISGID not supported */ /* * DragonFly specific flags */ #define ST_FSID_UUID 0x40000000 /* f_fsid_uuid field is valid */ #define ST_OWNER_UUID 0x80000000 /* f_owner_uuid field is valid */ The fields of type fsblkcnt_t are reported in units of f_frsize. fstatvfs() returns the same information about an open file referenced by descriptor fd.

RETURN VALUES

The statvfs() and fstatvfs() functions return the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

ERRORS

statvfs() fails if one or more of the following are true: [ENOTDIR] A component of the path prefix of path is not a direc- tory. [ENAMETOOLONG] The length of a component of path exceeds {NAME_MAX} characters, or the length of path exceeds {PATH_MAX} characters. [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 translat- ing 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. fstatvfs() fails if one or more of the following are true: [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

df(1), mount(2), stat(2), statfs(2)

STANDARDS

The statvfs() and fstatvfs() system calls conform to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

The statvfs() and fstatvfs() functions first appeared in DragonFly 1.13. DragonFly 4.1 September 28, 2008 DragonFly 4.1