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

# isp.4

`isp` — Qlogic FibreChannel SCSI 主机适配器驱动

## 名称

`isp`

## 概要

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

> device scbus device isp device ispfw

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

```sh
isp_load="YES"
ispfw_load="YES"
```

## 描述

此驱动为 FibreChannel SCSI 设备提供访问。

它支持 FCP SCSI 配置文件的发起端和目标模式，使用 Class 3 和 Class 2 连接。支持 Public 和 Private 环、点对点和 Fabric 连接。

对于支持 FC-Tape 功能的磁带机连接，强烈建议使用 FC-Tape。它包含 T-10 FCP-4 规范中的四个要素：

* 命令的精确传递
* FCP I/O 操作的确认完成
* 未成功传输 IU 的重传
* 任务重试标识

这些功能合起来允许与磁带设备进行链路级错误恢复。没有它，发起端无法判断已超时的磁带写命令导致全部、部分还是没有任何数据写入磁带机。当支持 FC-Tape 的控制器连接到支持 FC-Tape 的目标时，FC-Tape 会自动启用。可使用下文描述的配置和 hint 选项禁用。

## 硬件

`isp` 驱动支持以下光纤通道适配器：

| Model:                            | Speed: | Bus:  |
| --------------------------------- | ------ | ----- |
| Qlogic QLE2874 (2814)             | 64Gb   | PCIe  |
| Qlogic QLE2870/QLE2872 (2812)     | 64Gb   | PCIe  |
| Qlogic QLE2774 (2814)             | 32Gb   | PCIe  |
| Qlogic QLE2770/QLE2772 (2812)     | 32Gb   | PCIe  |
| Qlogic 2740/2742/2764 (2722/2714) | 32Gb   | PCIe  |
| Qlogic 2690/2692/2694 (2684/2692) | 16Gb   | PCIe  |
| Qlogic 267x/836x (2031/8031) FCoE | 16Gb   | PCIe  |
| Qlogic 256x (2532)                | 8Gb    | PCIe  |
| Qlogic 246x (2432)                | 4Gb    | PCIe  |
| Qlogic 2422                       | 4Gb    | PCI-X |

## 固件

固件加载受支持并由 [firmware(9)](/man/man9/firmware.9.md) 处理。正确的固件会在可用时为此类适配器自动加载，或通过手动加载 [ispfw(4)](/man/man4/ispfw.4.md) 模块加载。强烈建议使用 [ispfw(4)](/man/man4/ispfw.4.md) 提供的固件，因为它最有可能已经过此驱动测试。

## 配置选项

光纤通道适配器的目标模式支持可通过

`options ISP_TARGET_MODE`

选项启用。

要禁用 FC-Tape，使用以下配置选项：

`options ISP_FCTAPE_OFF`

注意，即使使用 ISP\_FCTAPE\_OFF 选项，仍可被下文描述的 fctape hint 覆盖。

## 引导选项

以下选项可通过在 **/boot/device.hints** 中设置值切换。

它们是：

**`lport`** 优先使用仲裁环，回退到点对点。 **`nport`** 优先使用点对点，回退到仲裁环。 **`lport-only`** 仅使用仲裁环。 **`nport-only`** 仅使用点对点。

**`hint.isp.`** `N``.msi` 限制使用的消息信号中断（MSI）数量。

**`hint.isp.`** `N``.msix` 限制使用的扩展消息信号中断（MSI-X）数量。

**`hint.isp.`** `N``.fwload_disable` 禁用 [ispfw(4)](/man/man4/ispfw.4.md) 提供的固件加载的 hint 值。

**`hint.isp.`** `N``.fwload_force` 优先使用 [ispfw(4)](/man/man4/ispfw.4.md) 提供的固件的 hint 值，即使该固件比板卡 flash 中的固件更旧。如果同时指定了 fwload\_disable，则 fwload\_force 将被忽略。默认情况下，对于 27XX 及更新控制器，[isp(4)](/man/man4/isp.4.md) 驱动将使用较新的固件。对于较旧控制器，[isp(4)](/man/man4/isp.4.md) 驱动在 [ispfw(4)](/man/man4/ispfw.4.md) 提供固件时使用该固件，否则使用板卡 flash 中的固件。

**`hint.isp.`** `N``.ignore_nvram` 忽略板卡 NVRAM 设置的 hint 值。否则使用 NVRAM 设置。

**`hint.isp.`** `N``.fullduplex` 设置全双工模式的 hint 值。

**`hint.isp.`** `N``.topology` 选择连接拓扑的 hint 值。支持的值有：

**`hint.isp.`** `N``.portwwn` 你想使用的完整 64 位 World Wide Port Name，覆盖卡上 NVRAM 中的值。

**`hint.isp.`** `N``.nodewwn` 你想使用的完整 64 位 World Wide Node Name，覆盖卡上 NVRAM 中的值。

**`hint.isp.`** `N``.iid` 覆盖或设置发起端 ID 或环 ID 的 hint。对于本地环拓扑中的光纤通道卡，`强烈`建议将此值设置为非零。

**`hint.isp.`** `N``.role` 定义 isp 实例默认角色的 hint（0 -- 无，1 -- 目标，2 -- 发起端，3 -- 两者）。

**`hint.isp.`** `N``.debug` 驱动调试级别的 hint 值（值见文件 **/usr/src/sys/dev/isp/ispvar.h**）。

**`hint.isp.`** `N``.vports` 创建指定数量附加虚拟端口的 hint。

**`hint.isp.`** `N``.nofctape` 设置为 1 可禁用给定 isp 实例上的 FC-Tape 操作。

**`hint.isp.`** `N``.fctape` 设置为 1 可在支持 FC-Tape 的目标上为给定 isp 实例启用 FC-Tape 操作。

## SYSCTL 选项

**`dev.isp.`** `N``.loop_down_limit` 此值表示环断开后等待多少秒再放弃并使所有可见设备过期。默认为 300 秒（5 分钟）。引导时使用单独的（不可调）超时，以避免因缺少 FC 连接而停止引导。

**`dev.isp.`** `N``.gone_device_time` 此值表示如果设备因环或 Fabric 事件（临时）消失，等待其重新出现的时间。此超时运行期间，对这些设备的 I/O 将被挂起。

**`dev.isp.`** `N``.use_gff_id`

**`dev.isp.`** `N``.use_gft_id` 将这些选项设置为 0 可在 FC Fabric 扫描期间禁用 GFF\_ID 和 GFT\_ID SNS 请求。如果交换机未正确实现它们，可能会阻止某些设备被发现，此时禁用它们可能有用。禁用它们可能导致对不支持目标角色甚至 FCP 的端口进行不必要的登录。默认为 1（启用）。

**`dev.isp.`** `N``.wwnn` 此端口的只读 World Wide Node Name 值。

**`dev.isp.`** `N``.wwpn` 此端口的只读 World Wide Port Name 值。

**`dev.isp.`** `N``.fw_version_flash` 控制器活动区域中的只读 flash 固件版本值。

**`dev.isp.`** `N``.fw_version_ispfw` [ispfw(4)](/man/man4/ispfw.4.md) 提供的只读固件版本值。

**`dev.isp.`** `N``.fw_version_run` 控制器上当前执行的只读固件版本值。

## 参见

[da(4)](/man/man4/da.4.md), [intro(4)](/man/man4/intro.4.md), [ispfw(4)](/man/man4/ispfw.4.md), [sa(4)](/man/man4/sa.4.md), [scsi(4)](/man/man4/scsi.4.md), gmultipath(8)

## 作者

`isp` 驱动由 Matthew Jacob 最初为 NASA/Ames Research Center 的 NetBSD 编写。后续改进由 Alexander Motin <mav@FreeBSD.org> 完成。

## 缺陷

该驱动当前忽略某些 NVRAM 设置。


---

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