> 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/sf_buf.9.md).

# sf\_buf.9

`sf_buf` — 管理内存页面的临时内核地址空间映射

## 名称

`sf_buf`

## 概要

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

```c
struct sf_buf *
sf_buf_alloc(struct vm_page *m, int flags)

void
sf_buf_free(struct sf_buf *sf)

vm_offset_t
sf_buf_kva(struct sf_buf *sf)

struct vm_page *
sf_buf_page(struct sf_buf *sf)
```

## 描述

`sf_buf` 接口，历史上称为 sendfile(2) 缓冲区接口，允许内核子系统管理物理内存页面的临时内核地址空间映射。在具有直接内存映射区域（允许所有物理页面始终在内核地址空间中可见）的系统上，`struct sf_buf` 将指向直接映射区域中的地址；在没有直接内存映射区域的系统上，`struct sf_buf` 将管理在 `struct sf_buf` 生命周期内有效的临时内核地址空间映射。

调用 `sf_buf_alloc` 为物理内存页面分配 `struct sf_buf`。`sf_buf_alloc` 不负责安排页面存在于物理内存中；调用者应已安排页面被锁定，即通过调用 [vm\_page\_wire(9)](/man/man9/vm_page_wire.9.md)。可以向 `sf_buf_alloc` 传递几个标志：

**`SFB_CATCH`** 使 `sf_buf_alloc` 在等待 `struct sf_buf` 变为可用时收到信号时中止并返回 `NULL`。

**`SFB_NOWAIT`** 使 `sf_buf_alloc` 在 `struct sf_buf` 不能立即可用时返回 `NULL` 而不是休眠。

**`SFB_CPUPRIVATE`** 使 `sf_buf_alloc` 仅安排临时映射在当前 CPU 上有效，避免对一次只会在单个 CPU 上访问的映射进行不必要的 TLB 击落。调用者必须确保对虚拟地址的访问仅发生在调用 `sf_buf_alloc` 的 CPU 上，或许可以使用 `sched_pin`。

调用 `sf_buf_kva` 返回该页面的内核映射地址。

调用 `sf_buf_page` 返回最初传递给 `sf_buf_alloc` 的页面指针。

调用 `sf_buf_free` 释放 `struct sf_buf` 引用。调用者负责释放他们先前在物理页面上获取的任何锁定；`sf_buf_free` 仅释放临时内核地址空间映射，而不释放页面本身。

此接口的用途包括管理从用户内存借用的页面的映射（例如在零复制套接字 I/O 中），或来自缓冲区缓存的、由 sendfile(2) 的 mbuf 外部存储引用的内存页面。

## 参见

[sendfile(2)](https://github.com/FreeBSD-Ask/freebsd-man-sc/tree/main/man2/sendfile.2.md), [vm\_page\_wire(9)](/man/man9/vm_page_wire.9.md)

## 作者

`struct sf_buf` API 由 Alan L. Cox 设计和实现。本手册页由 Robert N. M. Watson 编写。


---

# 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/sf_buf.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.