VFS_STATFS(9freebsd)

VFS_STATFS9freebsd

Return file system status

Usage

#include <sys/param.h>

#include <sys/mount.h>

#include <sys/vnode.h>

int

VFS_STATFS(struct mount *mp, struct statfs *sbp);

Overview

The VFS_STATFS() macro returns various pieces of information about the file system, including recommended I/O sizes, free space, free inodes, etc.

The arguments it expects are:

mp

The file system.

sbp

A statfs structure, as defined by ⟨sys/mount.h⟩, into which information is placed about the file system.

The fields of struct statfs related to the file system are as follows:

f_type

Type of file system.

f_flags

A copy of mount exported flags.

f_bsize

Fragment size.

f_iosize

Optimal transfer block size.

f_blocks

The total number of data blocks in the file system.

f_bfree

The number of free blocks in the file system.

f_bavail

The number of free blocks available to non-superuser processes.

f_files

The total number of file nodes in the file system.

f_ffree

The number of free nodes available to non-superuser processes.

f_syncwrites

The number of synchronous writes since the file system was mounted.

f_asyncwrites

The number of asynchronous writes since the file system was mounted.

f_syncreads

The number of synchronous reads since the file system was mounted.

f_asyncreads

The number of asynchronous reads since the file system was mounted.

f_namemax

The maximum file name length for this file system.

f_owner

The user ID of the user that mounted the file system.

f_fsid

Unique file system ID.

f_fstypename

The file system type name; a string of at most MFSNAMELEN bytes.

f_mntfromname

The device name the file system was mounted from; a string of at most MNAMELEN bytes.

f_mntonname

The name of the directory on which the file system is mounted; a string of at most MNAMELEN bytes.

Releases

9 releases since Debian 5.0 (Lenny); the text changed 6 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8
  5. 9
  6. 10
  7. 11–13

Authors

This manual page was written by Doug Rabson.

From freebsd-manpages 12.2-2 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.