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

# iscsi.4

`iscsi` — iSCSI 发起端

## 名称

`iscsi`

## 概要

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

> device iscsi

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

```sh
iscsi_load="YES"
```

## 描述

`iscsi` 子系统提供 iSCSI 发起端的内核组件，负责实现 iSCSI 协议的 Full Feature Phase。发起端是 iSCSI 客户端，连接到 iSCSI 目标，提供对远程块设备的本地访问。用户态组件由 iscsid(8) 提供，内核和用户态均使用 iscsictl(8) 配置。

## SYSCTL 变量

以下变量同时作为 [sysctl(8)](/man/man8/sysctl.8.md) 变量和 [loader(8)](/man/man8/loader.8.md) 可调参数可用：

**`kern.iscsi.debug`** `iscsi` 驱动日志消息的详细级别。设置为 0 可禁用日志，设置为 1 可对潜在问题发出警告。更大的值启用调试输出。默认为 1。

**`kern.iscsi.ping_timeout`** 等待目标响应 NOP-Out PDU 的秒数。如果在此时间内没有响应，会话将被强制重启。设置为 0 可禁用发送 NOP-Out PDU。默认为 5。

**`kern.iscsi.iscsid_timeout`** 等待 iscsid(8) 建立会话的秒数。超过此时间后 `iscsi` 将中止并重试。默认为 60。

**`kern.iscsi.login_timeout`** 等待登录尝试成功的秒数。超过此时间后 `iscsi` 将中止并重试。默认为 60。

**`kern.iscsi.maxtags`** 未完成 IO 请求的最大数量。默认为 255。

**`kern.iscsi.fail_on_disconnection`** 控制因网络问题导致 iSCSI 连接断开后的行为。设置为 1 时，连接断开会导致 iSCSI 设备节点被销毁。重新连接后将再次创建。默认情况下，设备节点保持不变。连接断开期间，所有输入/输出操作都将挂起，待连接重新建立后重试。

## 参见

[iser(4)](/man/man4/iser.4.md), iscsi.conf(5), iscsictl(8), iscsid(8)

## 历史

`iscsi` 子系统最早出现于 FreeBSD 10.0。

## 作者

`iscsi` 子系统由 Edward Tomasz Napierala <trasz@FreeBSD.org> 在 FreeBSD 基金会赞助下开发。


---

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