statvfs.2 (2010 09)

statvfs(2) statvfs(2)

ST_GRPQUOTA Group quotas enabled on this ﬁle system.

Security Restrictions

The ﬁeld f_bavail is the number of blocks available to non-superusers or users without the

LIMIT

privilege. The ﬁeld f_favail is the number of ﬁle nodes available to non-superusers or users without

the LIMIT privilege. See privileges (5) for more information about privileged access on systems that sup-

port ﬁne-grained privileges.

RETURN VALUE

statvfs() and fstatvfs() return 0 upon successful completion; otherwise, they return −1 and set

errno to indicate the error.

ERRORS

If statvfs() fails, errno is set to one of the following values:

[EACCES] Search permission is denied for a component of the path preﬁx.

[ELOOP] Too many symbolic links are encountered during path-name translation.

[ENAMETOOLONG]

The length of the speciﬁed path name exceeds PATH_MAX bytes, or the length

of a component of the path name exceeds NAME_MAX bytes while

_POSIX_NO_TRUNC is in effect.

[ENOENT] The named ﬁle does not exist (for example, path is null or a component of path

does not exist).

[ENOTDIR] A component of the path preﬁx is not a directory.

fstatvfs() fails, errno is set to the following value:

[EBADF] ﬁldes is not a valid open ﬁle descriptor.

When both statvfs() and fstatvfs() fail, errno is set to one of the following values:

[EFAULT] buf points to an invalid address.

[EIO] An I/O error occurred while reading from or writing to the ﬁle system.

[EOVERFLOW] Result would overﬂow one or more ﬁelds of the statvfs struct.