> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man9/vfs_statfs.9.md).

# VFS\_STATFS.9

`VFS_STATFS` — 返回文件系统状态

## 名称

`VFS_STATFS`

## 概要

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

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

## 描述

`VFS_STATFS` 宏返回关于文件系统的各种信息，包括推荐的 I/O 大小、空闲空间、空闲 inode 等。

它期望的参数为：

```c
#include <sys/mount.h>
```

**`mp`** 文件系统。

**`sbp`** 一个 `statfs` 结构，关于文件系统的信息将被放入其中。

与文件系统相关的 `struct statfs` 字段如下：

**`f_type`** 文件系统类型。

**`f_flags`** 挂载导出标志的副本。

**`f_bsize`** 片段大小。

**`f_iosize`** 最佳传输块大小。

**`f_blocks`** 文件系统中数据块的总数。

**`f_bfree`** 文件系统中空闲块的数量。

**`f_bavail`** 非超级用户进程可用的空闲块数量。

**`f_files`** 文件系统中文件节点的总数。

**`f_ffree`** 非超级用户进程可用的空闲节点数量。

**`f_syncwrites`** 自文件系统挂载以来的同步写入次数。

**`f_asyncwrites`** 自文件系统挂载以来的异步写入次数。

**`f_syncreads`** 自文件系统挂载以来的同步读取次数。

**`f_asyncreads`** 自文件系统挂载以来的异步读取次数。

**`f_namemax`** 此文件系统的最大文件名长度。

**`f_owner`** 挂载文件系统的用户的用户 ID。

**`f_fsid`** 唯一的文件系统 ID。

**`f_fstypename`** 文件系统类型名；最多 `MFSNAMELEN` 字节的字符串。

**`f_mntfromname`** 文件系统的挂载源设备名；最多 `MNAMELEN` 字节的字符串。

**`f_mntonname`** 文件系统挂载到的目录名；最多 `MNAMELEN` 字节的字符串。

## 参见

[VFS(9)](/man/man9/vfs.9.md), [vnode(9)](/man/man9/vnode.9.md)

## 作者

本手册页由 Doug Rabson 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man9/vfs_statfs.9.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.