> 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/man4/ctl.4.md).

# ctl.4

`ctl` — CAM 目标层

## 名称

`ctl`

## 概要

`若要将此驱动编译进内核，请在内核配置文件中加入以下行：`

> device ctl

`或者，若要在引导时以模块方式加载此驱动，请在 loader.conf(5) 中加入以下行：`

```sh
ctl_load="YES"
```

## 描述

`ctl` 子系统提供 SCSI 目标设备模拟。它支持以下特性：

* 磁盘、CD-ROM 和处理器设备模拟
* 标记队列
* SCSI 任务属性支持（有序、队首、简单标签）
* SCSI 隐式命令排序支持
* 完整的任务管理支持（中止、查询、重置等）
* 支持多个端口、发起方、目标和后端存储
* 支持 VMWare VAAI 和 Microsoft ODX 卸载（COMPARE AND WRITE、XCOPY、POPULATE TOKEN/WRITE USING TOKEN、WRITE SAME 和 UNMAP）
* 持久预留支持
* 丰富的 VPD/模式/日志页支持
* 具备错误报告、错误注入和基本 SMART 支持
* 通过 ALUA 提供高可用性集群支持
* 所有 I/O 均在内核中处理，无用户态上下文切换开销

`ctl` 子系统包含多个前端，可通过不同的传输协议和实现提供访问：

**camsim** 通过虚拟发起方模式的 CAM(4) SIM 为本地系统提供访问。

**camtgt** 通过目标模式的 CAM(4) SIM（如 Fibre Channel [isp(4)](/man/man4/isp.4.md) 和 [mpt(4)](/man/man4/mpt.4.md)）为远程系统提供访问。

**cfumass** 通过 USB 大容量存储类 Bulk Only（BBB）传输为远程系统提供访问。

**ha** 内部前端，用于在高可用性集群中接收来自其他节点端口的请求。

**ioctl** 通过基于 ioctl(2) 的 API 为本地用户级应用程序提供访问。

**iscsi** 使用 [cfiscsi(4)](/man/man4/cfiscsi.4.md) 通过 iSCSI 协议为远程系统提供访问。

**tpc** 内部前端，用于接收来自第三方复制引擎的请求，实现复制卸载操作。

`ctl` 子系统包含两个后端，可使用不同类型的后端存储创建逻辑单元：

**block** 将数据存储于 ZFS ZVOL、文件或裸块设备中。

**ramdisk** 将数据存储于 RAM 中，这使其主要用于性能测试。根据配置的容量，可作为黑洞、精简或厚置备磁盘工作。

## SYSCTL 变量

以下变量既可作为 [sysctl(8)](/man/man8/sysctl.8.md) 变量，也可作为 [loader(8)](/man/man8/loader.8.md) 可调参数：

**1** 记录出错的命令；

**2** 记录所有命令；

**4** 记录除 READ/WRITE 之外的命令数据。

**0** 活动/备用——主节点拥有后端访问权并处理请求，而备节点只能进行基本的 LUN 发现和预留；

**1** 活动/活动——两个节点均拥有后端访问权并处理请求，备节点与主节点同步处理；

**2** 活动/活动——主节点拥有后端访问权并处理请求，备节点将所有请求和数据转发给主节点；

**0** 未配置；

**1** 已配置但未建立；

**2** 已建立。

**0** 主；

**1** 备。

**`kern.cam.ctl.debug`** 已启用的 CTL 日志级别位掩码：默认为 0。

**`kern.cam.ctl.ha_id`** 指定此节点在高可用性集群中的唯一位置。默认为 0——无 HA，1 和 2——在指定位置启用 HA。

**`kern.cam.ctl.ha_mode`** 指定高可用性集群操作模式：上述所有模式都要求 HA 集群节点之间已建立连接。如果未配置连接，备节点将报告 Unavailable 状态；如果已配置但未建立，则报告 Transitioning 状态。默认为 0。

**`kern.cam.ctl.ha_peer`** 字符串值，指定与对端 HA 节点建立连接的方法。可为 "listen IP:port"、"connect IP:port" 或空值。

**`kern.cam.ctl.ha_link`** 报告 HA 集群节点之间连接的当前状态：

**`kern.cam.ctl.ha_role`** 指定此节点的默认角色：此角色可通过 "ha\_role" LUN 选项按 LUN 覆盖，使得对于一个 LUN 某节点为主，而对于另一个 LUN 则为另一节点为主。在 HA 模式 0 和 2 中，从主切换为备会关闭后端，反向切换则打开后端。若无主节点（两个节点均为备，或备节点无法连接到主节点），备节点报告 Transitioning 状态。存在两个主节点的状态是非法的（脑裂条件）。

## 可调变量

以下变量作为 [loader(8)](/man/man8/loader.8.md) 可调参数提供：

**`kern.cam.ctl.max_luns`** 指定所支持的最大 LUN 数，必须为 2 的幂。默认值为 1024。

**`kern.cam.ctl.max_ports`** 指定所支持的最大端口数，必须为 2 的幂。默认值为 1024。

## 参见

[cfiscsi(4)](/man/man4/cfiscsi.4.md), [cfumass(4)](/man/man4/cfumass.4.md), ctladm(8), ctld(8), ctlstat(8)

## 历史

`ctl` 子系统首次出现于 FreeBSD 9.1。

## 作者

`ctl` 子系统最初由 Kenneth Merry <ken@FreeBSD.org> 编写。后续工作由 Alexander Motin <mav@FreeBSD.org> 完成。


---

# 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/man4/ctl.4.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.