VFS_STATFS(9)

🦋 VFS_STATFS(9) — return file system status 🦋

okay so bestie, this page is VFS_STATFS(9), and it lives in the Kernel Developer's Manual — manual name folded in near the top like a little name tag 🎀 — and it's literally the macro for returning file system status. no cap, it's giving kernel-dev main character energy 💅

🌸 NAME 🌸

VFS_STATFS — return file system status

✨ SYNOPSIS ✨

#include <sys/param.h>
#include <sys/mount.h>
#include <sys/vnode.h>

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

💖 DESCRIPTION 💖

The VFS_STATFS() macro returns various pieces of information about the file system, including recommended I/O sizes, free space, free inodes, etc. it's like the file system's little status drop, and honestly? iconic. 🫶

The arguments it expects are:

• mp — The file system. yes, the whole file system, not a side quest.
• 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. that's the field, periodt.
• f_flags — A copy of mount exported flags. copy/paste energy, but make it kernel.
• 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. not the superuser VIP section.
• 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.

🫶 SEE ALSO 🫶

• VFS(9)
• vnode(9)

👑 AUTHORS 👑

This manual page was written by Doug Rabson. ty Doug, you ate 💅

source/version: Debian · date: May 23, 2009 · page: VFS_STATFS(9) — byeee, bestie 💜