man.bsd.lv manual page server

Manual Page Search Parameters

STATVFS(2) System Calls Manual STATVFS(2)

statvfs, fstatvfsget file system statistics

library “libc”

#include <sys/statvfs.h>

int
statvfs(const char *path, struct statvfs *buf);

int
fstatvfs(int fd, struct statvfs *buf);

() 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.

() returns the same information about an open file referenced by descriptor fd.

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.

statvfs() fails if one or more of the following are true:

[]
A component of the path prefix of path is not a directory.
[]
The length of a component of path exceeds {NAME_MAX} characters, or the length of path exceeds {PATH_MAX} characters.
[]
The file referred to by path does not exist.
[]
Search permission is denied for a component of the path prefix of path.
[]
Too many symbolic links were encountered in translating path.
[]
buf or path points to an invalid address.
[]
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:

[]
fd is not a valid open file descriptor.
[]
buf points to an invalid address.
[]
An I/O error occurred while reading from or writing to the file system.

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

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

The statvfs() and fstatvfs() functions first appeared in DragonFly 1.13.

September 28, 2008 DragonFly-5.6.1