第 3 章  安装

3.1  兼容性SBUS 控制器兼容性

3.2  硬件安装硬件安装步骤

GNOME

1. 从登录屏幕右键单击“Options”按钮。
2. 在弹出菜单中选择 System -> Halt。
3. 当出现验证框时，单击“Yes”

KDE

1. 从登录屏幕右键单击 shutdown。
2. 在弹出菜单中，右键单击其单选按钮选择 shutdown。
3. 单击 OK

XDM

1. 以 root 身份登录
2. 左键单击桌面以弹出弹出菜单
3. 选择“New Shell”
4. 当 shell 打开时，在提示符下键入“halt”并按回车键

控制台登录（没有 X windows 的系统）

1. 以 root 身份登录
2. 键入“halt”

所有系统

SPARCstation 4、5、10、20 & UltraSPARC 系统

1. 移除 CPU 机箱上的顶盖。在 SPARCstation 10 上，通过松开 CPU 机箱背面右上角的 captive 螺钉来完成此操作，然后向前倾斜机箱顶部，同时使用十字螺丝刀按下左上角的塑料卡舌。
2. 确定您将使用的 SBUS 插槽。任何插槽都可以。卸下固定面板的两个螺钉和矩形垫圈，从而卸下该插槽的填充面板。
3. 卸下 SBUS 固定器（通常称为手柄），方法是向外按压固定器的一条腿，同时将其从印刷电路板的孔中拉出。
4. 将板卡插入您选择的 SBUS 插槽中。要插入板卡，首先将 5070 RAIDium 背板的顶部啮合到 CPU 机箱的背板中，然后将板卡旋转到水平位置并配合 SBUS 连接器。确保 SBUS 连接器完全啮合。
5. 将尼龙板卡固定器卡入 SPARCstation 内部，以将 5070 RAIDium 板卡固定在系统内部。
6. 通过更换固定原始填充面板的矩形垫圈和螺钉，将 5070 RAIDium SBUS 背板固定到系统。
7. 更换顶盖，方法是首先将顶盖前部的塑料挂钩与机箱啮合，然后将顶盖旋转到设备上方，直到背面的塑料卡舌卡入到位。拧紧右上角的 captive 螺钉。

Ultra Enterprise 服务器、SPARCserver 1000 & 2000 系统、SPARCserver 6XO MP 系列

1. 卸下将 CPU 板固定到卡笼的两个内六角螺钉。这些螺钉位于 CPU 板背板的每一端。
2. 从机箱中卸下 CPU 板，并将其放在防静电的表面上。
3. 确定您将使用的 SBUS 插槽。任何插槽都可以。卸下固定面板的两个螺钉和矩形垫圈，从而卸下该插槽的填充面板。保存这些螺钉和垫圈。
4. 卸下 SBUS 固定器（通常称为手柄），方法是向外按压固定器的一条腿，同时将其从印刷电路板的孔中拉出。
5. 将板卡插入您选择的 SBUS 插槽中。要插入板卡，首先将 5070 RAIDium 背板的顶部啮合到 CPU 机箱的背板中，然后将板卡旋转到水平位置并配合 SBUS 连接器。确保 SBUS 连接器完全啮合。
6. 使用 CPU 板上提供的尼龙螺钉和支架将 5070 RAIDium 板固定到 CPU 板。可能需要移动支架，使其与 SBUS 固定器使用的孔对齐，因为支架在 MBus 模块的不同孔中使用。更换最初固定填充面板的螺钉和矩形垫圈，将 5070 RAIDium SBus 背板固定到系统机箱。
7. 将 CPU 板重新插入 CPU 机箱，并重新安装固定 CPU 板的内六角头固定螺钉。

所有系统

1. 将外部电缆适配器盒与 5070 RAIDium 配合，并轻轻拧紧穿过电缆适配器盒的两个螺钉。
2. 将来自 SCSI 设备的三个电缆连接到 Antares 5070 RAIDium 上的三个 68 针 SCSI-3 连接器。在建立 RAID 集之后，必须始终以相同的顺序重新连接这三根 SCSI 电缆，因此您应该清楚地标记电缆和磁盘机箱，以便将来拆卸和重新组装。
3. 配置连接的 SCSI 设备以使用目标 ID，而不是 7，因为 7 已被 5070 RAIDium 本身占用。目标编号的配置在各种设备上有所不同。请查阅制造商的安装说明，以确定适合您设备的方法。
4. 由于您很可能要安装多个 SCSI 设备，请确保所有 SCSI 总线都正确端接。这意味着仅在每个 SCSI 总线菊花链的末端安装一个终结器。

验证硬件安装

3.2.1  串行终端

3.2.2  硬盘驱动器配置

• 请记住，您通常会得到物有所值的东西。我强烈建议为更好的（即更可靠的）硬件支付额外的费用，特别是如果您要为关键任务项目设置 RAID。例如，考虑购买带有冗余热插拔电源等的驱动器机箱。
• 您还需要为主机系统和驱动器机箱配备 UPS。请记住，RAID 级别 3 和 5 可以保护您免受驱动器故障而不是电源故障导致的数据丢失。
• 您选择的驱动器机箱应具有热插拔驱动器托架，这些托架成本更高，但当您需要添加/更换驱动器时，绝对值得。
• 确保机箱在完全装载驱动器时具有足够的冷却。
• 尽可能保持 SCSI 电缆（内部和外部）短。
• 以某种方式标记驱动器/机箱，以便您能够以原始配置将其重新连接到控制器。配置 RAID 后，您无法重新组织驱动器，而无需重新配置 RAID（并随后擦除存储在其上的数据）。
• 请记住，尽管物理上可以每个通道连接/配置最多 6 个驱动器，但对于每个通道超过三个驱动器的 RAID，性能将急剧下降。这是由于 SBUS 的 25 MHz 带宽限制。因此，如果读/写性能是一个问题，请使用少量的大容量驱动器。如果您需要一个真正大的 RAID（约 1 TB），那么您将别无选择，只能将通道加载到满负荷并承担性能损失。注意：如果您通过 10/100 Base T 网络提供文件，您可能不会注意到性能下降，因为网络通常是瓶颈，而不是 SBUS。

3.3  5070 板载配置

• “RaidRunner”是 5070 控制器板的名称。
• “Husky”是 shell 的名称，它产生“:raid;”命令提示符。它是一种命令语言解释器，用于执行从标准输入或文件读取的命令。Husky 是 Unix 的 Bourne shell (sh) 的缩小模型。一个主要区别是 husky 没有当前工作目录的概念。有关 husky shell 和命令提示符的更多信息，请参阅“高级主题”部分
• “主机端口”是分配给控制器卡本身的的 SCSI ID。这通常是 ID 7。
• “后端”是连接到给定通道上控制器的驱动器。
• “Rank”是来自每个通道的所有具有相同 SCSI ID 的后端的集合
  （即 rank 0 将由每个通道上 SCSI ID 为 0 的所有驱动器组成）
• 每个后端都由一个三位数标识，其中第一位是通道，第二位是驱动器的 SCSI ID，第三位是驱动器的 LUN。数字之间用句点分隔。如果它是磁盘，则标识符以“D”为前缀，如果它是磁带，则以“T”为前缀（例如 D0.1.0）。在以下文档中，此方案称为 <device_type_c.s.l>。
• “RAID 集”由给定数量的后端组成（有一些要求，稍后我会讲到）
• “备用盘”是在 RAID 驱动器之一发生故障之前未使用的驱动器。届时，损坏的驱动器将自动脱机并替换为备用盘。然后，数据将在备用盘上重建，RAID 恢复正常运行。
• 备用盘可以是“热”备用盘，也可以是“温”备用盘，具体取决于用户配置。热备用盘在 RAID 启动时启动，这缩短了驱动器发生故障时的更换时间。温备用盘在需要时启动，从而节省驱动器的磨损。

3.3.1  主屏幕选项

---

图 3.1： 5070 板载配置实用程序的主屏幕

---

• [Q]uit：退出主屏幕并返回到 husky 提示符。
• [R]aidSets：进入 RaidSet 配置屏幕。
• [H]ostports 进入主机端口配置屏幕。
• [S]pares 进入备用设备配置屏幕。
• [M]onitor 进入 SCSI 监视器配置屏幕。
• [G]eneral 进入常规配置/信息屏幕。
• [P]robe 重新探测 RaidRunner 上的设备后端。当探测每个后端时，其“名称”（c.s.l 格式）将显示在屏幕的左下角。

3.3.2  [Q]uit

3.3.3  [R]aidSets

---

图 3.2： RAIDSet 配置屏幕。

---

• [Q]uit：退出 Raid Set 配置屏幕并返回到主屏幕。如果您已修改、删除或添加了 RAID 集，但尚未安装更改，系统将要求您确认。如果您选择“Yes”继续退出，则自上次安装操作以来所做的所有更改都将被丢弃。
• [I]nst：此操作安装（到 RaidRunner 配置区域中）可能已对 RAID 集进行的任何更改，无论是删除、添加还是修改。如果您在安装之前退出，则自上次安装以来所做的所有更改都将被丢弃。安装过程需要时间。一旦键入的“i”字符从菜单行中清除，安装就完成了。
• [M]od：此操作允许您修改显示的 RAID 集。系统将提示您输入可以更改的每个 RAID 集属性。提示包括允许的选项或所需格式。如果您不想更改特定属性，请按 RETURN 键或 TAB 键。您可以更改的属性包括 RAID 集名称、I/O 模式、状态（Active 到 Inactive）、bootmode、备用盘使用情况、后端区域表使用情况、IO 大小（如果 RAID 集从未被使用过 - 即刚刚添加）、缓存大小、I/O 队列长度、主机接口和其他 stargd 参数。如果您想更改单个属性，请使用 RETURN 键或 TAB 键跳过所有其他选项。更改后的属性将在您按下 RETURN 键后立即重新显示。在指定缓存大小时，您可以为数字添加后缀“m”或“M”以指示数字以兆字节为单位，或添加后缀“k”或“K”以指示数字以千字节为单位。请注意，您只能输入整数值。在指定 io 大小时，您可以为数字添加后缀“k”或“K”以指示数字以千字节为单位。当您输入数据时，将检查其正确性，如果错误，则会显示一条消息，并且所有更改都将被丢弃，您将不得不重新开始。请记住，您必须安装 ([I]nst.) 任何更改。
• [A]dd：选择此选项后，系统将提示您输入新 RAID 集的各种属性。这些属性包括 RAID 集名称、RAID 集类型、RAID 集将要出现的初始主机接口（c.h.l 格式，其中 c 是控制器编号，h 是主机端口 (0、1、2 等)，l 是 SCSI LUN）以及最终的后端列表。当要输入后端时，屏幕会显示可用后端列表，每个后端都有一个数字索引（从 0 开始）。您通过输入索引来选择每个后端，并在完成后输入 q 以退出。当输入每个后端索引时，其后端名称将显示在逗号分隔的列表中。当您输入数据时，将检查其正确性，如果错误，则会显示一条消息，并且添加将被忽略，您将不得不重新开始。后端完成后，新创建的 RAID 集将显示在屏幕上，并带有提供的属性和默认属性。然后，您可以修改 RAID 集以更改其他属性。请记住，您必须安装 ([I]nst.) 任何新的 RAID 集。
• [D]elete：此操作将删除当前显示的 RAID 集。如果此 RAID 集处于活动状态，则您将无法删除它。您必须使其处于非活动状态（通过 [M]od. 选项），然后删除它。系统将提示您确认删除。一旦您确认删除，屏幕将被清除，并且将显示下一个 RAID 集（如果已配置）。请记住，您必须安装 ([I]nst.) 任何更改。
• [F]irst、[L]ast、[N]ext 和 [P]rev 允许您滚动浏览已配置的 RAID 集。

3.3.4  [H]ostports

---

图 3.3： 主机端口配置屏幕。

---

• [Q]uit：退出主机端口配置屏幕并返回到主屏幕。如果您已修改主机端口 SCSI ID 分配，但尚未安装更改，系统将要求您确认。如果您选择“Yes”继续退出，则自上次安装操作以来所做的所有更改都将被丢弃。
• [I]nstall：此操作安装（到 RaidRunner 配置区域中）可能已对主机端口 SCSI ID 分配进行的任何更改。如果您在安装之前退出，则自上次安装以来所做的所有更改都将被丢弃。安装过程需要时间。一旦键入的“i”字符从菜单行中清除，安装就完成了。
• [M]odify：此操作允许您修改每个控制器上每个主机端口的主机端口 SCSI ID 分配（如果无外部主机端口 SCSI ID 开关）。系统将提示您输入每个主机端口的 SCSI ID。您可以输入 SCSI ID（0 到 15），输入减号“-”字符以清除 SCSI ID 分配，或输入 RETURN 以跳过。当您输入数据时，将检查其正确性，如果错误，则会打印一条消息，但先前正确输入的数据将保留。请记住，您必须安装 ([I]nst.) 任何更改。

3.3.5  [S]pares

---

图 3.4： 备用设备配置屏幕。

---

• [Q]uit：退出备用设备配置屏幕并返回到主屏幕。如果您已修改、删除或添加了备用设备，但尚未安装更改，系统将要求您确认。如果您选择“Yes”继续退出，则自上次安装操作以来所做的所有更改都将被丢弃。
• [I]nstall：此操作安装（到 RaidRunner 配置区域中）可能已对备用设备进行的任何更改，无论是删除、添加还是修改。如果您在安装之前退出，则自上次安装以来所做的所有更改都将被丢弃。安装过程需要时间。一旦键入的“i”字符从菜单行中清除，安装就完成了。
• [M]odify：此操作允许您修改未使用的备用设备。系统将提示您输入可以更改的每个备用设备属性。提示包括允许的选项或所需格式。如果您不想更改特定属性，请按 RETURN 键。您可以更改的属性包括新大小（以 512 字节块为单位）、旋转状态（H 表示热备用或 hot，W 表示温备用）和控制器分配（A 表示任何控制器，0 表示控制器 0，1 表示控制器 1 等）。如果您想更改备用设备的单个属性，请使用 RETURN 键跳过每个备用设备的所有其他属性。更改后的属性将不会重新显示，直到输入（或跳过）最后一个提示的属性。当您输入数据时，将检查其正确性，如果错误，则会显示一条消息，并且所有更改都将被丢弃，您将不得不重新开始。请记住，您必须安装 ([I]nstall) 任何更改。
• [A]dd：添加备用设备时，将显示可用设备列表，并且您需要键入设备名称。输入后，将使用默认值添加备用设备，您可以根据需要通过 [M]odify 选项更改默认值。请记住，您必须安装 ([I]nstall) 任何更改。
• [D]elete：删除备用设备时，将显示允许删除的备用设备列表，并且您需要键入所需的设备名称。输入后，备用设备将从屏幕上删除。请记住，您必须安装 ([I]nstall) 任何更改。

3.3.6  [M]onitor

---

图 3.5： SCSI 监视器配置屏幕。

---

• [Q]uit：退出 SCSI 监视器配置屏幕并返回到主屏幕。如果您已进行更改但尚未安装它们，系统将要求您确认。如果您选择“Yes”继续退出，则自上次安装操作以来所做的所有更改都将被丢弃。
• [I]nstall：此操作安装（到 RaidRunner 配置区域中）可能已对 SCSI 监视器配置进行的任何更改。如果您在安装之前退出，则自上次安装以来所做的所有更改都将被丢弃。安装过程需要时间。一旦键入的“i”字符从菜单行中清除，安装就完成了。
• [M]odify：此操作允许您修改 SCSI 监视器配置。光标将在表格中移动，提示您输入。如果您不想更改属性，请输入 RETURN 以跳过。如果您想删除 SCSI 监视器，请在提示输入控制器编号时输入减号“-”字符。如果您想使用默认协议列表，请在协议列表提示符下输入 RETURN。当您输入数据时，将检查其正确性，如果错误，则会打印一条消息，并且任何先前输入的数据都将被丢弃。您将不得不再次重新输入数据。请记住，您必须安装 ([I]nstall) 任何更改。

3.3.7  [G]eneral

---

图 3.6： 常规屏幕。可以从此处访问的选项允许您查看有关连接设备（SCSI 硬盘驱动器和磁带机）的信息、浏览系统日志以及检查环境变量。

---

• [Q]uit：退出常规屏幕并返回到主屏幕。
• [D]evices：进入设备信息屏幕（图 3.7）。设备屏幕显示 RaidRunner 上所有设备的名称。菜单行允许您退出并返回到常规屏幕或显示有关设备的信息。

  ---

  

  
  

  图 3.7： 设备信息屏幕。

  
  

  ---

  • [Q]uit：退出设备屏幕并返回到常规屏幕。
  • 设备信息[I]nformation：设备信息屏幕（图 3.8）显示有关每个设备的信息（图 ）。您可以滚动浏览设备。对于磁盘，显示的信息包括设备名称、序列号、供应商名称、产品 ID、速度、版本、扇区大小、扇区计数、MB 中的设备总大小、柱面数、磁头数和每磁道扇区数以及区域/凹槽分区。菜单行允许您离开设备信息屏幕或浏览设备。

    ---

    

    
    

    图 3.8: 硬盘设备信息显示示例。

    
    

    ---

    • [Q]退出: 退出设备信息屏幕并返回设备屏幕。
    • [F]首页, [L]末页, [N]下一项 和 [P]上一项 允许您滚动浏览设备并显示其当前数据。
• 系统日志 [L]日志: 进入系统日志消息屏幕 (图 3.9)。

  ---

  

  
  

  图 3.9: 系统日志消息屏幕。 显示了一个消息示例，每个屏幕显示一条消息。

  
  

  ---

  • [Q]退出: 退出系统日志消息屏幕并返回通用屏幕。
  • [F]首页, [L]末页, [N]下一项 和 [P]上一项 允许您滚动浏览系统日志。
• 环境变量配置 [E]环境: 进入全局环境变量配置屏幕 (图 3.10)。 环境变量配置屏幕显示所有已配置的全局环境变量，并提供一个菜单，允许您添加、删除、修改和安装（更改）变量。 每个变量名称后跟一个等号 "=" 以及分配给该变量的值，并用大括号括起来 - "{" .. "}"。 菜单行允许您退出并返回通用屏幕，或选择其他操作。

  ---

  

  
  

  图 3.10: 全局环境变量配置屏幕。

  
  

  ---

  • [Q]退出: 退出环境变量配置屏幕并返回通用屏幕。 如果您修改、删除或添加了环境变量但尚未安装更改，系统将要求您确认。 如果您选择“是”继续退出，则自上次安装操作以来所做的所有更改都将被丢弃。
  • [I]安装: 此操作将任何已对环境变量进行的更改（删除、添加或修改）安装到 RaidRunner 配置区域中。 如果您在安装之前退出，则自上次安装以来所做的所有更改都将被丢弃。 安装过程需要时间。 一旦输入的 "i" 字符从菜单行中清除，安装即完成。
  • [M]修改: 此操作允许您修改环境变量的值。 系统将提示您输入环境变量的名称，然后提示您输入其新值。 如果找不到输入的环境变量，将打印一条消息，并且不会提示您输入新值。 如果您不输入新值（即只按回车键），则不会进行任何更改。 请记住，您必须安装 ([I]安装) 任何更改。
  • [A]添加: 添加新环境变量时，系统将提示您输入其名称和值。 如果变量名称尚未使用且您输入了值，则将添加并显示新变量。 请记住，您必须安装 ([I]安装) 任何更改。
  • [D]删除: 删除环境变量时，系统将提示您输入变量名称，如果有效，则将删除该环境变量。 请记住，您必须安装 ([I]安装) 任何更改。
• 吞吐量统计（查看）[S]统计: 进入统计监控屏幕 (图 3.11)。 “统计”屏幕显示关于 RaidRunner 上配置和运行的 raid 组的各种通用和特定统计信息。 数据区域的第一部分显示当前温度（摄氏度）和 RaidRunner 中风扇的当前速度。 数据区域的下一部分显示关于指定 raid 组的各种统计信息。 统计信息包括 - 当前缓存命中率、每个 raid 组后端的累积读取次数、读取失败次数、写入次数和写入失败次数，以及每个 front raid 组的 stargd 进程（由其进程 ID 指示）的读取和写入吞吐量。 菜单行允许用户离开“统计”屏幕或选择其他操作。

  ---

  

  
  

  图 3.11: 统计监控屏幕

  
  

  ---

  • [Q]退出: 退出统计屏幕并返回通用屏幕。
  • [F]首页, [L]末页, [N]下一项 和 [P]上一项 允许您滚动浏览统计信息。
  • [R]刷新: 此选项将获取给定 raid 组的统计信息，并在屏幕上重新显示当前统计信息。
  • [Z]清零: 此选项将清零当前显示的 raid 组的累积统计信息。
  • [C]连续: 此选项将启动一个后台进程，该进程将每 2 秒更新当前显示的 raid 组的统计信息。 还会创建一个循环计数器，并每 2 秒更新一次。 要中断此连续统计信息收集模式，只需按任意字符。 如果您需要刷新显示，请按刷新字符 - <Control-l> 或 <Control-r>。

3.3.8  [P]探测

3.3.9  RAID 配置会话示例

1. 配置主机端口
2. 分配备用盘
3. 配置 RAID 组

• 级别 0：2 个后端
• 级别 3：2 个后端
• 级别 5：3 个后端

1. 打开计算机电源，并将串行终端连接到 RaidRunner 的串行端口。
2. 当出现 husky ( :raid; ) 提示符时，输入 "agui" 并按回车键启动 GUI。
3. 当主屏幕出现时，选择 "H" 以进行 [H]主机端口配置
4. 在某些型号的 RaidRunner 上，主机端口不可配置。 如果您在此处只有 [Q]退出选项，则主机端口配置无需执行任何操作，请注意这些值并跳至步骤 6。 如果您有添加/修改选项，则您的主机端口是软件可配置的。
5. 如果此屏幕上没有主机端口条目，请使用以下参数添加一个条目：controller=0, hostport=0 , SCSI ID=0。 不要忘记 [I]安装 您的更改。 如果已存在条目，请注意这些值（它们将在稍后的步骤中使用）。
6. 从现在开始，我将假设以下硬件配置
   1. 有 7 个 - 2.04 GB 的硬盘，连接方式如下
      1. SCSI 通道 0 上有 2 个硬盘，SCSI ID 为 0 和 1（后端分别为 0.0.0 和 0.1.0）。
      2. SCSI 通道 1 上有 3 个硬盘，SCSI ID 为 0、1 和 5（后端分别为 1.0.0、1.1.0 和 1.5.0）。
      3. SCSI 通道 2 上有 2 个硬盘，SCSI ID 为 0 和 1（后端分别为 2.0.0 和 2.1.0）。
   2. 因此
      1. Rank 0 由后端 0.0.0、1.0.0、2.0.0 组成
      2. Rank 1 由后端 0.1.0、1.1.0、2.1.0 组成
      3. Rank 5 仅包含后端 1.5.0
   3. RaidRunner 分配给控制器 0，主机端口 0
7. 按 Q [Q]退出 主机端口屏幕并返回主屏幕。
8. 按 S 进入 [S]备用盘 屏幕
9. 选择 A 以 [A]添加 新的备用盘到备用盘池。 将显示可用后端列表，系统将提示您输入以下信息
   
   输入要添加到备用盘的设备名称 - 从上面
   
   输入
   
   D1.5.0
   
   
10. 选择 I 以 [I]安装 您的更改
11. 选择 Q 以 [Q]退出 备用盘屏幕并返回主屏幕
12. 从主屏幕中选择 R 以进入 [R]raid 组屏幕。
13. 选择 A 以 [A]添加 新的 RAID 组。 系统将提示您输入每个 RAID 组参数。 提示和响应如下所示。
    1. 输入 Raid 组的名称：cim_homes （或您想称呼它的任何名称）。
    2. Raid 组类型 [0,1,3,5]: 5
    3. 输入初始主机接口 - ctlr,hostport,scsilun: 0.0.0
       
       现在将以以下形式显示可用后端列表
       0 - D0.0.0 1 - D1.0.0 2 - D2.0.0 3 - D0.1.0 4 - D1.1.0 5 - D2.1.0
    4. 从上面输入索引 - Q 退出
       1 按回车键
       2 按回车键
       3 按回车键
       4 按回车键
       5 按回车键
       Q
14. 按 Q 后，您将返回到“Raid 组”屏幕。 您应该在数据区域中看到新配置的 Raid 组（图 3.12）。
15. 按 I 以 [I]安装 更改

    ---

    

    
    

    图 3.12: GUI 的“Raid 组”屏幕，显示新配置的 RAID 5

    
    

    ---

16. 按 Q 退出“Raid 组”屏幕并返回主屏幕
17. 按 Q [Q]退出 agui 并退出到 husky 提示符。
18. 输入 "reboot" 然后按回车键。 这将重启 RaidRunner（而不是主机）。
19. 当 RaidRunner 重启时，它将为新配置的 RAID 准备驱动器。
    注意：根据 RAID 的大小，这可能需要几分钟到几小时。 对于上述示例，5070 大约需要 10 - 20 分钟来条带化 RAID 组。
20. 当您再次看到 husky 提示符时，RAID 即可使用。 然后您可以继续进行 Linux 配置。

3.4  Linux 配置

3.4.1  现有 Linux 安装

QLogic SCSI 驱动程序

设备映射

分区

安装文件系统

挂载

3.4.2  全新 Linux 安装

1. 按照 “板载配置” 中概述的方式配置主机端口、RAID 组和备用盘。 您的计算机必须开机才能执行此步骤，因为 5070 由 SBUS 供电。 此时计算机是否安装了操作系统并不重要，我们只需要控制器卡的电源。
2. 开始 RedHat SparcLinux 安装
3. 安装程序将自动检测 5070 控制器并加载 Qlogic 驱动程序
4. 您的虚拟 RAID 驱动器将显示为普通的 SCSI 硬盘驱动器，在安装期间进行分区和格式化。 注意：在使用 RedHat 安装期间的图形分区实用程序时，请勿将虚拟驱动器上的任何分区指定为 RAID 类型，因为它们已经是硬件管理的虚拟 RAID 驱动器。 分区实用程序屏幕上的 RAID 选择用于设置软件 RAID。
   重要提示：您可能会在可用驱动器列表中看到一个小的 SCSI 驱动器（通常约为 128 MB）。 请勿选择此驱动器使用。 它是 SMON 通信通道，而不是驱动器。 如果安装程序尝试使用它，则会使安装程序挂起。
5. 就这些，安装程序会处理其他所有事情！！

3.5  维护

3.5.1  备用盘，激活激活备用盘

3.5.2  重新集成已修复的驱动器将已修复的驱动器重新集成到 RAID 中（级别 3 和 5）

1. 启动文本 GUI
2. 查找 RAID 组的后端列表。
3. 标记为故障的后端在其 ID 右侧会有一个 (-)（例如 D1.1.0- ）。
4. 如果您设置了备用盘，则故障后端的 ID 后跟已替换它的备用盘的 ID（例如 D1.1.0-D1.5.0 ）。
5. 写下故障后端的 ID（不是备用盘）。
6. 按 Q 退出 agui
7. 在 husky 提示符下，键入

   replace <name> <backend> 

   其中 <name> 是您为 raid 组命名的任何名称，<backend> 是要重新集成到 RAID 中的后端的 ID。 如果正在使用备用盘，它将自动返回到备用盘池。 请耐心等待，重建可能需要几分钟到几个小时，具体取决于 RAID 级别和大小。 幸运的是，在此过程中您可以像往常一样使用 RAID。

3.6  故障排除/错误消息

3.6.1  检测到频带外温度...

• 可能原因：5070 SBUS 卡冷却不足。
• 解决方案：尝试改善机箱内部的冷却。 清理风扇上的灰尘，重新整理卡，使 raid 卡最靠近风扇等。 在某些 “披萨盒” sun 机箱（例如 SPARC 20）上，您可能需要添加辅助冷却风扇，尤其是在您已加载卡的情况下。

3.6.2  ... 失败 ... 不能有超过 1 个故障后端。

• 原因：RAID 3/4/5 中超过一个后端发生故障（即，不再有足够的冗余来重建丢失的数据）。
• 解决方案：你完了 ... 抱歉。
  如果您在配置 RAID 3/4/5 时未分配备用盘，那么现在可能是重新考虑该决定的明智之举的好时机。 希望您一直在进行定期备份。 因为现在您将必须更换有缺陷的驱动器，重新配置 RAID，并从辅助源恢复数据。

3.6.3  启动时我看到：... Sun disklabel: bad magic 0000 ... unknown partition table。

• 怀疑原因：fdisk（或您使用的任何分区实用程序）设置的磁盘标签中的设置不正确。 当您选择预设磁盘标签之一而不是 “Custom with autoprobed defaults” 时，似乎会发生此消息。
• 解决方案：由于此错误似乎不影响驱动器的操作，您可以选择不做任何操作并没问题。 如果您想更正它，您可以尝试重新标记磁盘或重新分区磁盘并选择 “Custom with autoprobed defaults”。 如果您从头开始安装 RedHat Linux，则安装程序会为您正确处理所有这些问题。

3.7  Bug

3.8  常见问题解答

3.8.1  如何重置/擦除板载配置？

3.8.2  如何判断 RAID 中的驱动器是否发生故障？

3.9  命令参考高级主题：5070 命令参考

3.9.1  autobootAUTOBOOT - 自动创建所有 raid 组和 scsi 监控器的脚本

• 概要：autoboot
• 描述：autoboot 是一个 husky 脚本，通常在 RaidRunner 启动时执行。 采取以下步骤 -
  1. 启动所有配置的 scsi 监控器守护程序 (smon)。
  2. 测试以查看要启动的所有 raid 组所需的总缓存是否不超过可用内存的 90%。
  3. 启动所有 scsi 目标守护程序 (stargd) 并将每个守护程序模式设置为 “spinning-up”，使其能够响应来自主机的所有非介质访问命令。 这样做是为了让主机尽快了解 RaidRunner 的 scsi 目标。
  4. 将所有未使用的备用后端设备绑定到根 (ram) 文件系统中。
  5. 构建所有 raid 组。
  6. 如果存在电池备份的 ram，请检查是否有任何已保存的写入，并将它们恢复到刚刚构建的 raid 组中。
  7. 最后，将所有 scsi 目标守护程序的状态设置为 “spun-up”，使主机能够完全访问其后面的 raid 组。

3.9.2  AUTOFAULT - 在驱动器故障后自动将后端标记为故障的脚本

• 概要：autofault raidset
• 描述：autofault 是一个 husky 脚本，通常由 raid 文件系统在其后端发生故障时执行，当 raid 文件系统无法使用备用后端或已配置为不使用备用后端时。 在解析其参数（命令和环境）后，autofault 发出 rconf 命令以将给定后端标记为故障。
• 选项
  • raidset：故障后端所在的 raid 组的绑定点。
  • $DRIVE_NUMBER：发生故障的后端的索引。 raid 组中的第一个后端为 0。 此选项作为环境变量传递。
  • $BLOCK_SIZE：raid 组的 io 块大小（以字节为单位）。 （忽略）。 此选项作为环境变量传递。
  • $QUEUE_LENGTH：raid 组的队列长度。 （忽略）。 此选项作为环境变量传递。
• 另请参阅：rconf

3.9.3  AUTOREPAIR - 自动分配备用盘并重建 raid 组的脚本

• 概要：autorepair raidset size
• 描述：autorepair 是一个 husky 脚本，通常由 raid 类型 1、3 或 5 文件系统在其后端发生故障时执行。
  
  在解析其参数（命令和环境）后，autorepair 从 RaidRunner 的备用盘池中获取一个备用设备。 然后，它以只写模式启用它，并读取完整的 raid 设备，从而在备用盘上重建数据。 读取来自 raid 文件系统的修复入口点。 从此入口点读取会导致读取一个块，然后立即写入该块。 读取/写入序列是原子的（即不可中断）。 重建完成后，将进行检查以确保备用盘在重建期间未发生故障，如果未发生故障，则将备用设备的访问模式设置为 raid 组的访问模式。 读取修复入口点的进程是 rebuild。
  
  设备重建将需要 10 分钟到 1.5 小时，具体取决于后端的大小和速度以及主机生成的活动量。
  
  在设备重建期间，将打印数字对，指示每重建 10% 的数据。 数字对之间用斜杠字符分隔，第一个数字是到目前为止重建的块数，第二个数字是要重建的块数。 可以通过运行 rebuild 获得有关重建的更多状态。
  
  分配备用盘后，将打印后端上当前使用的备用盘数量和备用设备名称。 后端上的备用盘数量称为后端上的备用盘深度。 因此，在重建后重新启用备用盘之前，可以检查深度是否相同。 如果不相同，则备用盘重建失败，并且正在进行使用另一个备用盘的重建（或者没有备用盘可用），因此我们不重新启用驱动器。
  
  
• 选项
  • raidset：故障后端所在的 raid 组的绑定点。
  • size：raid 组的大小（以 512 字节块为单位）。
  • $DRIVE_NUMBER：发生故障的后端的索引。 raid 组中的第一个后端为 0。 此选项作为环境变量传递。
  • $BLOCK_SIZE：raid 组的 io 块大小（以字节为单位）。 此选项作为环境变量传递。
  • $QUEUE_LENGTH：raid 组的队列长度。 此选项作为环境变量传递。
• 另请参阅：rconf、rebuild

3.9.4  BIND - 组合命名空间的元素

• 概要：bind [-k] new old
• 描述：Bind 将现有的旧文件（或目录）替换为新文件（或目录）。 如果给定 “-k” 开关，则 new 必须是内核识别的设备（文件系统）。 手册页的第 7k 节记录了可以使用 “-k” 开关绑定的设备（有时称为文件系统）。

3.9.5  BUZZER - 获取蜂鸣器的状态或打开或关闭蜂鸣器

• 概要：buzzer 或 buzzer on|off|mute
• 描述：Buzzer 将打印蜂鸣器的状态，打开或关闭蜂鸣器或使其静音。 如果未给出任何参数，则打印蜂鸣器的状态，即如果蜂鸣器当前打开或关闭，则将分别打印 on 或 off。 如果蜂鸣器已静音，则会通知您。 如果自 RaidRunner 启动以来未使用蜂鸣器，则打印特殊状态 unused。 如果给出参数 on，则打开蜂鸣器，如果给出 off，则关闭蜂鸣器。 如果给出参数 mute，则更改蜂鸣器的静音状态。
• 另请参阅：warble、sos

3.9.6  CACHE - 显示有关缓存范围的信息并删除缓存范围

• 概要：cache [-D moniker] [-I moniker] [-F] [-g moniker first|last] lastoffset
• 描述：cache 将打印（到标准输出）有关给定缓存范围的信息，删除给定缓存范围，刷新缓存或返回所有缓存范围的最后一个偏移量。
• 选项
  • -F：将所有缓存缓冲区刷新到其后端（通常是 raid 组）。
  • -D moniker：删除具有别名（名称）moniker 的缓存范围。
  • -I moniker：使给定缓存范围（别名）的缓存无效。 这仅对调试或详细基准测试有用。
  • -g moniker first|last：打印具有别名（名称）moniker 的缓存范围的第一个或最后一个块号。
  • lastoffset：打印所有缓存范围的最后一个偏移量。 最后一个偏移量是所有缓存范围的最后一个块号。

3.9.7  CACHEDUMP - 将写缓存的内容转储到电池备份的 ram 中

• 概要：cachedump
• 描述：cachedump 使 RaidRunner 缓存中的所有未写入数据都写入到电池备份的 ram 中。 如果电池备份的 ram 中已存储有效的当前数据，则不会将数据写入电池备份的 ram 中。 当电池备份的 ram 中的数据（或其组织）出现问题并且您需要重新初始化它时，通常会执行此命令。 cachedump 将始终返回 NULL 状态。
• 另请参阅：showbat、cacherestore

3.9.8  CACHERESTORE - 从电池备份的 ram 中加载缓存数据

• 概要：cacherestore
• 描述：cacherestore 将检查 RaidRunner 的电池备份的 ram 中是否有因电源故障而存储的任何数据。 它会将任何数据直接复制到缓存中。 此命令通常在启动时以及在 RaidRunner 将其数据提供给主机之前自动执行。 成功将任何数据从电池备份的 ram 复制到缓存后，它会刷新缓存，然后重新初始化电池备份的 ram 以指示它不包含任何数据。 cacherestore 成功时将返回 NULL 状态，如果加载期间发生错误（并在标准错误中写入消息），则返回 1。
• 另请参阅：showbat

3.9.9  CAT - 连接文件并在标准输出上打印

• 概要：cat [ file... ]
• 描述： cat 命令将每个给定文件的内容写入标准输出。如果没有给定文件，或者给定了名为“-”的文件，则从标准输入读取内容并写入标准输出。如果指定的文件是一个目录，则该目录中包含的文件名将被发送到标准输出（每行一个文件名）。有关文件的更多信息（例如其大小）可以通过使用 stat 命令获得。脚本文件 ls 使用 cat 和 stat 来生成目录列表。
• 另请参阅： echo, ls, stat

3.9.10  CMP - 比较 2 个文件的内容

• 概要： cmp [-b blockSize] [-c count] [-e] [-x] 文件1 文件2
• 描述： cmp 命令比较两个指定文件的内容。如果 文件1 为“-”，则标准输入将用作该文件。如果这两个文件长度相同且包含相同的值，则不会写入任何内容到标准输出，并且退出状态设置为 NIL（即真）。如果这两个文件不同，则第一个不同的字节及其位置将输出到标准输出，并且退出状态设置为“differ”（即假）。位置由块号（起始为 0）和该块内的字节偏移量（起始为 0）给出。可选的“-b”开关允许设置每次读取操作的块大小（blockSize）。默认的块大小为 512（字节）。对于涉及磁盘的大型比较，相对较大的块大小可能很有用（例如 64k）。有关允许的后缀，请参阅 suffix。可选的“-c”开关允许固定读取的块计数（count）。计数为 0 值表示读取到文件结尾 (EOF)。要比较 2 个文件的前 64 兆字节，可以使用开关“-b 64k -c 1k”。有关允许的后缀，请参阅 suffix。可选的“-e”开关指示 ccmmpp 输出到标准输出（通常覆盖同一行）已比较的块计数，每次达到 100 的倍数时输出一次。最终的块计数也会输出。可选的“-x”开关指示 ccmmpp 在比较错误（但不是文件错误）后继续，并保持错误块的计数。如果检测到任何错误，则仅在命令退出时输出最后一个错误。如果也给出了“-e”开关，则当前错误块计数将输出到已比较的 100 块倍数的右侧。此命令旨在比较非常大的文件。blockSize 的两个缓冲区是动态分配的，因此它们的大小受命令执行时可用内存（即目标中的 RAM）量的限制。计数可以高达 2G。比较的字节数是 blockSize 和 count 的乘积（即足够大）。
• 另请参阅： suffix

3.9.11  CONS - Husky 的控制台设备

• 概要： bind -k cons bind_point
• 描述： cons 允许解释器（例如 Husky）将控制台输入和输出路由到适当的设备。该控制台输入和输出在 K9 命名空间中的 bind_point 可用。特殊文件 cons 应始终可用。
• 示例： Husky 在其初始化中执行以下操作
  
  bind -k cons /dev/cons
  
  在 Unix 系统上，这等效于
  
  bind -k unixfd /dev/cons
  
  在 DOS 系统上，这等效于
  
  bind -k doscon /dev/cons
  
  在使用 SCN2681 芯片的目标硬件上，这等效于
  
  bind -k scn2681 /dev/cons
  
  
• 另请参阅： unixfd, doscon, scn2681

3.9.12  DD - 复制文件（磁盘等）

• 概要： dd [if=文件] [of=文件] [ibs=字节数] [obs=字节数] [bs=字节数] [skip=块数] [seek=块数] [count=块数] [flags=verbose]
• 描述： dd 命令使用用户可选择的块大小复制文件（默认情况下从标准输入到标准输出）。
• 选项
  • if=文件 从文件而不是标准输入读取。
  • of=文件，写入文件而不是标准输出。
  • ibs=字节数，一次读取给定的字节数。
  • obs=字节数，一次写入给定的字节数。
  • bs=字节数，一次读取和写入给定的字节数。覆盖 ibs 和 obs。
  • skip=块数，在输入开始处跳过 ibs 大小的块。
  • seek=块数，在输出开始处绕过 obs 大小的块。
  • count=块数，仅复制 ibs 大小的输入块。
  • flags=verbose，打印（到标准输出）每复制 10% 的块时复制的块数。输出格式为 X/T，其中 X 是到目前为止复制的块数，T 是要复制的总块数。只有在同时给出 count= 和 of= 选项时才能使用此选项。
  给“ibs”、“obs”、“bs”、“skip”、“seek”和“count”的十进制数不能为负数。这些数字可以选择性地带有后缀（请参阅 suffix）。在所有情况下，dd 都输出到标准输出。成功复制 8 个（完整）块将导致以下输出

  8+0 记录输入
  
  8+0 记录输出

  “+”号后的数字是小数块（即小于块大小的块）的数量。此数字通常为零（否则当涉及具有对齐要求的物理介质时）。
  
  在前一个示例中，输出最后一个块的写入失败将导致以下输出

  写入失败
  
  8+0 记录输入
  
  7+0 记录输出

• 另请参阅： suffix

3.9.13  DEVSCMP - 将文件大小与给定值进行比较

• 概要： devscmp 文件名 大小
• 描述： devscmp 将查找给定文件的大小，并将其大小（以 512 字节块为单位）与给定大小（也以 512 字节块为单位）进行比较。如果文件大小小于给定值，则打印 -1，如果等于则打印 0，如果给定文件的大小大于给定大小，则打印 1。此例程在内部脚本中使用，以确保 raid 集的后端具有适当的大小。

3.9.14  DFORMAT- 在后端磁盘驱动器上执行格式化功能

• 概要
  • dformat -p c.s.l -R bnum
  • dformat -p c.s.l -pdA|-pdP|-pdG
  • dformat -p c.s.l -S [-v] [-B firstbn]
  • dformat -p c.s.l -F
  • dformat -p c.s.l -D 文件
• 描述： 在其第一种形式中，dformat 将通过 SCSI-2 REASSIGN BLOCKS 命令在指定的磁盘驱动器上重新分配块。第二种形式允许您打印出当前的制造商缺陷列表 (-pdP)、增长的缺陷列表 (-pdG) 或两个缺陷列表 (-pdA)。每个打印的列表都已排序，每行一个缺陷，采用物理扇区格式 - 柱面号、磁头号和缺陷扇区号。第三种形式导致驱动器以破坏性写入/读取/比较方式进行扫描。如果发生读取或写入或数据比较错误，则会尝试识别坏扇区。通常，驱动器从 0 块扫描到驱动器上的最后一个块。您可以选择给出备用起始块号。第四种形式导致在指定设备上进行低级格式化。第五个选项允许您将设备的微代码下载到设备中。
• 选项
  • -R bnum：指定要重新分配给驱动器增长的缺陷列表的逻辑块号。
  • -pdA：打印制造商和增长的缺陷列表。
  • \ -pdP：打印制造商的缺陷列表。
  • -pdG：打印增长的缺陷列表。
  • -S：对磁盘执行破坏性扫描，报告 I/O 错误。
  • -B firstbn：指定要开始扫描的第一个逻辑块号。
  • -v：打开详细模式 - 打印正在扫描的当前块号。
  • -F：向给定设备发出低级 SCSI 格式化命令。这将需要一些时间。
  • -D 文件：将给定文件下载到指定设备中。下载通过单个 SCSI Write-Buffer 命令以保存微代码模式进行。这允许用户更新设备的微代码。请谨慎使用此命令，因为加载不正确的文件可能会损坏设备。
  • -p c.s.l：通过指定其通道、SCSI ID（rank）和 SCSI LUN 来标识磁盘设备，格式为“c.s.l”。
• 另请参阅： RAID 中使用的磁盘驱动器的产品手册。

3.9.15  DIAGS - 运行给定设备诊断的脚本

• 概要： diags 磁盘 -C 计数 -L 长度 -M io-mode -T io-type -D 设备
• 描述： diags 是一个 husky 脚本，用于在给定设备上运行 randio 诊断。当执行 randio 时，它以详细模式执行。
• 选项
  • disk：这是我们要运行的诊断的设备类型。
  • -C 计数：指定执行诊断的次数。
  • -L 长度：指定要执行的诊断的“长度”。它可以是 short、medium 或 long，分别用字母 s、m 或 l 指定。对于磁盘，short 测试将测试设备的前 10%，medium 测试前 50%，long 测试整个磁盘 (100%)。
  • -M io-mode：指定破坏性（读写）或非破坏性（只读）测试。使用 read-write 或 read-only。
  • -T io-type：指定 io 类型 - sequential 或 random。
  • -D 设备：指定要测试的设备。
• 另请参阅： randio, scsihdfs

3.9.16  DPART - 编辑 scsihd 磁盘分区表

• 概要
  • dpart -a|d|l|m -D 文件 [-N 名称] [-F 首块] [-L 末块]
  • dpart -a -D 文件 -N 名称 -F 首块 -L 末块
  • dpart -d -D 文件 -N 名称
  • dpart -l -D 文件
  • dpart -m -D 文件 -N 名称 -F 首块 -L 末块
• 描述： 每个 scsihd 设备（通常是 SCSI 磁盘驱动器）可以划分为八个逻辑分区。默认情况下，当 scsihd 设备绑定到 RaidRunner 的文件系统时，它有四个分区：整个设备（raw），通常命名为 bindpoint/raw；分区文件 (bindpoint/partition)；RaidRunner 备份配置文件 (bindpoint/rconfig)；以及磁盘的“数据”部分 (bind- point/data)，它表示整个设备减去备份配置区域和分区文件。有关更多信息，请参阅 scsihdfs。如果添加了其他分区，则它们将显示为 bindpoint/partitionname。dpart 允许您编辑或列出 scsihd 设备（通常是磁盘）上的分区表。
• 选项
  • -a：添加分区。添加分区时，您需要指定分区名称 (-N) 和分区范围，从首块 (-F) 到末块 (-L)。
  • -d：删除命名 (-N) 分区。
  • -l：列出所有分区。
  • -m：修改现有分区。您需要指定分区名称 (-N) 以及其首块 (-F) 和末块 (-L) 块号，即使您只是修改末块号也是如此。
  • -D 文件：指定要编辑的分区文件。通常，这是 bindpoint/partition 文件。
  • -N 名称：指定分区名称。
  • -F 首块：指定分区的首块号。
  • -L 末块：指定分区的末块号。
• 另请参阅： scsihd

3.9.17  DUP - 打开文件描述符设备

• 概要： bind -k dup bind_point
• 描述： dup 设备创建一个单层目录，该目录中为调用 K9 进程的每个打开的文件描述符创建一个条目。这些目录“条目”是数字。因此，典型的进程（脚本）绑定 dup 设备至少会在命名空间中创建以下文件：“bind_point/0”、“bind_point/1”和“bind_point/2”。这些文件将对应于其打开的标准输入、标准输出和标准错误文件描述符。dup 设备允许其他 K9 进程访问调用进程的打开文件描述符。为此，其他进程只需“打开”所需的 dup 设备目录条目，其名称（数字）对应于所需的文件描述符。

3.9.18  ECHO - 显示文本行

• 概要： echo [字符串 ...]
• 描述： echo 命令将每个给定的字符串写入标准输出，字符串之间用空格分隔，并在最后一个字符串后添加换行符。请注意，所有字符串参数都在单个写入内核调用中写入。字符串中的以下反斜杠转义字符将按如下方式转换
  
  \b 退格
  
  \c 抑制尾随换行符
  
  \f 换页
  
  \n 换行
  
  \r 回车
  
  \t 水平制表符
  
  \v 垂直制表符
  
  \\ 反斜杠
  
  \nnn ASCII 代码为 nnn（八进制）的字符
  
  
• 另请参阅： cat

3.9.19  ENV- 环境变量文件系统

• 概要： bind -k env bind_point
• 描述： env 文件系统将单层目录与 K9 命名空间中的 bind_point 关联。该目录中的每个文件名都是环境变量的名称，而文件的内容是该变量的当前值。从概念上讲，每个进程都看到其自己的 env 文件系统副本。此副本要么为空，要么从该进程的父进程在生成时继承（取决于生成的标志）。

3.9.20  ENVIRON - RaidRunner 全局环境变量 - 名称和效果

• 描述： RaidRunner 使用全局环境变量来控制自动操作的功能。全局环境变量保存在 Raid 配置区域中，因此它们在重启/断电之间保留其值。某些 RaidRunner 内部运行时变量也可以设置为全局环境变量。有关详细信息，请参阅 internals 手册条目。下表描述了 RaidRunner 在其正常运行中使用的全局环境变量。
  • RebuildPri
    
    此变量（如果设置）控制通过 rebuild 程序进行驱动器重建时使用的优先级。如果未设置该变量，则将使用默认的重建优先级。该变量应是以逗号分隔的 raid 集名称及其关联的重建优先级和休眠时间段（以冒号分隔）的列表。形式为
    
    Rname_1:Pri_1:Sleep_1,Rname_2:Pri_2:Sleep_2,...,Rname_N:Pri_N:Sleep_N
    
    其中 Pri_1 是在 raid 集 Rname_1 上运行时 rebuild 程序运行的优先级，Sleep_1 是在 raid 集上每次重建操作之间休眠的时间段（以毫秒为单位），Pri_2 是 raid 集 Rname_2 的优先级，依此类推。例如，如果 RebuildPri 的值为
    
    R:5:30000
    
    那么，如果在 raid 集 R 上发生重建（通过 replace、repair 或 autorepair），则重建将以优先级 5 运行（通过 -p rebuild 选项），并且每次重建操作之间将休眠 30000 毫秒（30 秒）（通过 -S rebuild 选项指定）。给定的优先级必须对 rebuild 程序有效。
    
    
  • BackendRanks
    
    在可能存在多个控制器的某些 RaidRunner 上，您可以限制控制器对可用设备后端 rank 的访问。例如，您可能有 2 个控制器和 4 个后端设备 rank。您可以指定第一个控制器只能访问前两个 rank，第二个控制器只能访问后两个 rank。此变量以及其他关联命令允许您设置此限制。此外，您可能只有一个控制器 RaidRunner，它位于具有多个 rank 的机箱中。默认情况下，控制器将尝试探测所有 rank 上的所有设备。如果您仅使用例如一半的后端设备填充了 RaidRunner，则 RaidRunner 仍将探测另一半。适当设置此变量将防止此不必要的（有时很耗时的）过程。此变量采用以下形式
    
    controller_id:ranklist controller_id:ranklist ...
    
    其中 controller_id 是控制器编号（从 0 向上），ranklist 是给定控制器将访问的后端 rank 的逗号分隔列表。请注意，后端 rank 是该 rank 的 scsi-id。例如，在 2 个 rank（rank 1 和 2 - 即第一个 rank 的 scsi id 1 和第二个 rank 的 scsi id 2）的 1 个控制器上
    
    此变量采用以下形式
    
    例如，在只有第一个 rank 具有设备的 2 个 rank（rank 1 和 2 - 即第一个 rank 的 scsi id 1 和第二个 rank 的 scsi id 2）的 1 个控制器 RaidRunner 上，您可以通过将 BackendRanks 设置为以下值来防止控制器尝试访问（空的）第二个 rank
    
    0:1
    
    通常，您不会直接设置此变量，而是使用支持命令来设置它。这些命令是 pranks 和 sranks。有关详细信息，请参阅这些手册条目。
  
  
• RAIDn_reference_PBUFS
  
  Raid 类型 3、4 和 5 都使用内存作为临时奇偶校验缓冲区，以便在需要创建奇偶校验数据时使用。此内存是分配给 raid 集缓存的内存之外的内存。创建 raid 集时，它还会创建默认数量的奇偶校验缓冲区（其大小与 raid 集的 iosize 相同）。有时，如果 raid 集的 iosize 很大，则可能没有足够的内存来创建此默认数量的奇偶校验缓冲区。为了克服这种情况，您可以设置全局环境变量来覆盖特定类型的所有 raid 集或特定 raid 集将使用的默认奇偶校验缓冲区数量。您需要在通过 agui 定义 raid 集之前设置这些变量，如果您删除它们而不是 raid 集，则生效的 raid 集可能无法启动，因此主机将无法访问它们。变量的形式为 RAIDn_reference_PBUFS，其中 n 是 raid 类型（3、4 或 5），reference 是 raid 集的名称或字符串“Default”。您可以使用“Default”引用来指定特定类型的所有 raid 集。例如，要覆盖名为 raid 5 的奇偶校验缓冲区数量

  ： raid ; setenv RAID5_FRED_PBUFS 64

  要覆盖所有 raid 3 的奇偶校验缓冲区数量（并仅设置 72 个奇偶校验缓冲区），请设置

  ： raid ; setenv RAID3_Default_PBUFS 128

  如果您为特定类型的所有 raid 集设置了默认值，但希望其中一个 raid 集有所不同，则为该特定 raid 集设置一个变量，因为它的值将覆盖默认值。在上面的示例中，所有 Raid 类型 3 都将有 128 个奇偶校验缓冲区，您可以设置变量

  ： raid ; setenv RAID3_Dbase_PBUFS 56 

  这将允许名为“Dbase”的 raid 3 raid 集具有 56 个奇偶校验缓冲区，但 RaidRunner 上定义的所有其他 raid 3 将具有 128 个。
  
  
• 另请参阅： setenv, printenv, rconf, rebuild, internals

3.9.21  EXEC - 使参数在当前 shell 中执行，替换当前 shell

• 概要： exec [ 参数 ... ]
• 描述： exec 使第一个参数指定的命令在当前 shell 中执行，替换当前 shell，而无需创建新进程。后续参数作为其参数传递给第一个参数指定的命令。Shell 重定向可能会出现，如果未给出其他参数，则会导致 shell 输入/输出被修改。

3.9.22  EXIT - 退出 K9 进程

• 概要： exit [字符串]
• 描述： exit 具有可选的字符串参数。如果给出了可选参数，则当前 K9 进程将终止，并将给定的字符串作为其退出值。（如果字符串包含嵌入空格，则整个字符串应为 quoted_string）。如果未给出任何参数，则 shell 获取与环境变量“status”关联的字符串，并将该字符串作为退出值返回。如果未找到环境变量“status”，则返回“true”退出状态（即 NIL）。
• 另请参阅： true, K9exit

3.9.23  EXPR - 数值表达式求值

• 概要： expr 数值表达式 ...
• 描述： expr 将每个 numeric_expr 命令行参数评估为单独的数值表达式。因此，单个表达式不能包含未转义的空格，或者需要放在带引号的字符串中（即在“{”和“}”之间）。算术运算在带符号整数上执行（当前数字范围为 -2,147,483,648 到 2,147,483,647）。成功的计算不会产生任何输出（到标准输出/错误或环境变量）。因此，每个有用的 numeric_expr 都需要包含赋值（或运算符赋值）。提供的每个 numeric_expr 参数都按给定的顺序（即从左到右）进行评估，直到它们全部成功评估（返回 true 状态）。如果评估 numeric_expr 失败（通常是由于语法错误），则 expr 命令失败，退出状态为“error”，并且错误消息写入环境变量“error”。
• 运算符： 每个运算符的优先级显示在方括号中的描述之后。“0”是最高优先级。在单个优先级组中，评估是从左到右的，但赋值运算符是从右到左的。括号的优先级高于所有运算符，可用于更改下面显示的默认优先级。
  
  一元运算符
  
  +
  
  对右侧的表达式/数字不做任何操作。
  
  -
  
  对右侧的表达式/数字取反。
  
  !
  
  对右侧的表达式/数字进行逻辑非运算。
  
  ~
  
  对右侧的表达式/数字进行按位非运算。
  
  二元算术运算符
  
  *
  
  封闭表达式相乘 [2]
  
  /
  
  封闭表达式的整数除法
  
  %
  
  封闭表达式的模数。
  
  +
  
  封闭表达式相加
  
  -
  
  封闭表达式相减。
  
  <<
  
  将左侧表达式向左移位右侧表达式中的数字位数。等效于：left * (2 ** right)
  
  >>
  
  将右侧表达式向左移位右侧表达式中的数字位数。等效于：left / (2 ** right)
  
  &
  
  封闭表达式的按位与
  
  ^
  
  封闭表达式的按位异或。 [8]
  
  |
  
  封闭表达式的按位或。 [9]
  
  二元逻辑运算符
  
  这些逻辑运算符对于真比较产生数字 1，对于假比较产生数字 0。对于逻辑与和或，它们的左侧和右侧表达式如果为 0 则被假定为假，否则为真。逻辑与和或都会评估其左侧和右侧表达式（参见 C 的短路操作）。
  
  <=
  
  当左侧小于或等于右侧时为真。 [5]
  
  >=
  
  当左侧大于或等于右侧时为真。 [5]
  
  <
  
  当左侧小于右侧时为真。 [5]
  
  >
  
  当左侧大于右侧时为真。 [5]
  
  ==
  
  当左侧等于右侧时为真。 [6]
  
  !=
  
  当左侧不等于右侧时为真。 [6]
  
  &&
  
  封闭表达式的逻辑与 [10]
  
  ||
  
  封闭表达式的逻辑或 [11]
  
  赋值运算符
  
  在以下描述中，“n”是环境变量，而“r_exp”是右侧的表达式。所有赋值运算符都具有相同的优先级，该优先级低于所有其他运算符。注意：多个赋值运算符从右到左分组（即与 C 语言相同）。
  
  =
  
  将右侧表达式赋值给左侧的环境变量。
  
  *=
  
  n *= r_exp 等效于： n = n * r_exp
  
  /=
  
  n /= r_exp 等效于： n = n / r_exp
  
  %=
  
  n %= r_exp 等效于： n = n % r_exp
  
  +=
  
  n += r_exp 等效于： n = n + r_exp
  
  -=
  
  n -= r_exp 等效于： n = n - r_exp
  
  <<=
  
  n <<= r_exp 等效于： n = n << r_exp
  
  >>=
  
  n >>= r_exp 等效于： n = n >> r_exp
  
  &=
  
  n &= r_exp 等效于： n = n & r_exp
  
  |=
  
  n |= r_exp 等效于： n = n | r_exp
  
  
• 数字： 所有数字都是上述描述中声明范围内的带符号整数。数字可以以 2 到 36 为基数输入。基数 10 是默认基数。默认基数可以被以下方式覆盖
  1. 前导“0”：表示八进制或十六进制
  2. 形式为 _base_#_num_ 的数字
  以“0”为前缀的数字被解释为八进制。以“0x”或“0X”为前缀的数字被解释为十六进制。对于使用“#”表示法的数字，_base_ 必须在 2 到 36 的范围内（包括 2 和 36）。对于大于 10 的基数，字母“a”到“z”用于额外的“数字”。接受大写和小写字母。任何超过（或等于）基数的单个数字都被认为是错误的。只有基数 10 的数字可以有后缀。有关有效后缀的列表，请参阅 suffix。另请注意，由于 expr 使用带符号整数，因此“1G”是可以使用“Gigabyte”后缀表示的最大数量级数字（假设为 32 位带符号整数，-2G 由于评估顺序而无效）。
  
  
• 变量： 唯一允许的符号变量是 K9 环境变量。无论它们是正在读取还是写入，它们都不应以“$”开头。作为赋值左侧参数出现的以前不存在的环境变量将被创建。当读取不存在的环境变量时，它将被解释为值 0。
• 示例： 一些简单示例

  expr {n = 1 + 2} # 创建 n
  
  echo $n

  3

  expr {n*=2} # 3 * 2 结果返回到 n
  
  echo $n

  6

  expr { k = n > 5 } # 6 > 5 为真，因此创建 k = 1
  
  echo $k

  1

• 注意： expr 是 Husky“内置”命令。请参阅“set”中的“注意”部分，了解其含义。
• 另请参阅： husky, set, suffix, test

3.9.24  FALSE - 返回 K9 假状态

• 概要： false
• 描述： false 除了返回 K9 假状态外，不做任何其他事情。K9 进程在终止时返回指向 C 字符串（空终止字符数组）的指针。如果该指针为 NULL，则假定为真退出值，而所有其他返回的指针值都被解释为假（字符串是一些对出错原因的解释）。此命令返回指向字符串“false”的指针作为其返回值。
• 示例： 以下脚本片段将向标准输出打印“got here”
  
  if false then
  
  echo impossible
  
  else
  
  echo got here
  
  end
  
  
• 另请参阅： true

3.9.25  FIFO - 固定大小的双向 fifo 缓冲区

• 概要
  • bind -k {fifo 大小} bind_point
  • cat bind_point
  • bind_point/data
  • bind_point/ctl
• 描述： fifo 文件系统将单层目录与 K9 命名空间中的 bind_point 关联，缓冲区大小为 size 字节。bind_point/data 和 bind_point/ctl 是 fifo 的数据和控制通道。写入 bind_point/data 文件的数据可以从同一文件中以先进先出的方式读取。向 bind_point/data 文件写入 x 字节的数据将完成并传输所有数据，或者将传输足够的字节，直到 fifo 缓冲区已满，然后阻塞，直到通过读取从 fifo 缓冲区中移除数据。从 bind_point/data 文件读取 x 字节的数据将传输 fifo 缓冲区中当前数据量或 x 字节中较小的值。从 bind_point/ctl 读取将返回 fifo 缓冲区的大小和当前使用量。打开次数（# Opens）是当前打开 bind_point/data 文件的进程数。
• 示例

  > /buffer
  
  bind -k {fifo 2048} /buffer
  
  ls -l /buffer
  
  /buffer
  
  /buffer/ctl                     fifo    2 0x00000001    1 0
  
  /buffer/data                    fifo    2 0x00000002    1 0
  
  cat /buffer/ctl
  
  最大值: 2048 当前值: 0, # 打开次数: 0
  
  echo hello > /buffer/data
  
  cat /buffer/ctl
  
  最大值: 2048 当前值: 6, # 打开次数: 0
  
  dd if=/buffer/data bs=512 count=1
  
  hello
  
  0+1 记录输入
  
  0+1 记录输出
  
  cat /buffer/ctl
  
  最大值: 2048 当前值: 0, # 打开次数: 0

• 另请参阅： pipe

3.9.26  GET - 从列表中选择一个值

• 概要： get 数字 [ 值 ... ]
• 描述： get 命令使用给定的数字从给定的列表中选择一个值。索引从 0 开始（例如，“get 0 aaa bb c”返回“aaa”）。如果数字超出给定值列表的索引范围，则不返回任何内容。

3.9.27  GETIV - 获取 RaidRunner 内部变量的值

• 概要
  • getiv
  • getiv 名称
• 描述： getiv 打印 RaidRunner 内部变量的当前值，或打印所有变量的列表。当给出变量名称时，将打印其当前值。如果未给出值，则列出所有可用的内部变量。
• 注意： 由于不同型号的 RaidRunner 具有不同的内部变量，请参阅您的 RaidRunner 硬件参考手册，以获取变量列表及其值的含义。这些变量是运行时变量，因此每次 RaidRunner 启动时都会恢复为其默认值。
• 另请参阅： setiv

3.9.28  HELP - 打印命令列表及其概要

• 概要： help 或 ?
• 描述： help 或问号字符 - ?，将打印命令解释器可用的所有命令的列表。 साथ ही, 每个命令都打印了其概要。

3.9.29  HUSKY - K9 内核的 shell

• 概要
  • husky [-c 命令] [ 文件 [ 参数 ... ] ]
  • hs [-c 命令] [ 文件 [ 参数 ... ] ]
• 描述： husky 和 hs 是同义词。husky 是一个命令语言解释器，它执行从标准输入或文件读取的命令。husky 是 Unix 的 Bourne shell (sh) 的精简模型。一个主要的区别是 husky 没有当前工作目录的概念。如果存在“-c”开关，则以下命令由 husky 在当前环境中新抛出的 shell 中解释。当命令完成时，这个新抛出的 shell 会退出回到当前环境。否则，如果给出了参数，则第一个参数被假定为包含 husky 命令的文件。同样，会抛出一个新 shell 来执行这些命令。husky 脚本文件可以访问其命令行参数，并且 husky 的第二个和后续参数（如果存在）将传递给该文件以供使用。如果未向 husky 提供任何参数，则从标准输入读取命令（并且 shell 被认为是交互式的）。
• 返回状态： husky 将进程的 K9 返回状态（如果正常，则为 NIL；否则为解释错误的字符串）放置在文件“/env/status”中
  
  一个例子

  dd if=/xx
  
  dd: 无法打开 /xx
  
  cat /env/status
  
  打开失败
  
  cat /env/status

  # 空白，因为之前的“cat”工作正常
  
  由于文件“/env/status”是一个环境变量，因此命令的返回状态也可在变量 $status 中获得。管道的退出状态是管道中最后一个命令的退出状态。
  
  
• 信号 如果交互式 shell 接收到中断信号（即 K9_SIGINT - 通常是控制台上的 Control-C），则 shell 退出。“init”进程将启动一个新的 husky shell 实例，所有先前运行的进程（刚被杀死的 shell 除外）仍在运行。这允许用户杀死导致先前 shell 问题的进程。或者，意外在前台运行的进程可以通过向 shell 发送中断信号有效地置于后台。请注意，这与 Unix shell 非常不同，Unix shell 会将信号转发到前台进程。
• 引号、转义、字符串连接等： quoted_string（在语法中定义）以“{”开头，以匹配的“}”结尾。“匹配”一词意味着所有嵌入的“{”必须在最终“}”被认为与原始“{”匹配之前具有相应的嵌入“}”。quoted_string 可以跨越多行。在 quoted_string 中不会发生命令行替换。用于转义后续字符的字符是“\”。如果需要按字面意思解释“{”，则可以用“\{”表示。如果包含空格（空白）的字符串需要被解释为单个标记，则可以转义空格（空白）（即“\ ”）。如果“\”本身需要按字面意思解释，则可以用“\\”表示。字符串连接字符是“^”。当诸如“/d4”之类的标记需要由脚本构建时，这很有用，其中“/d”是固定的，而“4”是从某个变量派生的
  
  set n 4
  
  > /d^$n
  
  此示例将创建文件“/d4”。
  
  另一个 husky 命令或脚本的输出可以通过以“`”开始并以“'”结尾的序列以内联方式提供。例如
  
  echo {ps 输出如下
  
  } `ps'
  
  这将打印字符串“ps 输出如下:”，然后在下一行打印命令“ps”的当前输出。来自“ps”的输出将其嵌入式换行符替换为空格。
  
  
• 命令行文件重定向
  • 重定向应出现在命令及其参数之后的一行中，以便 husky 解释。一个特殊情况是一行仅包含“> filename”，如果该文件名以前不存在，则创建长度为零的文件名；如果该文件名存在，则截断为零长度。
  • 将标准输入重定向为来自文件使用标记“<”，文件名出现在其右侧。标准输入的默认来源是控制台。
  • 将标准输出重定向为转到文件使用标记“>”，文件名出现在其右侧。标准输出的默认目标是控制台。
  • 将标准错误重定向到文件使用标记 “>[2]”，文件名出现在其右侧。标准错误的默认目标是控制台。
  • 将命令内部的写入操作（使用已知的文件描述符编号，例如 “n”）重定向到文件，使用标记 “>[n]”，文件名出现在其右侧。
  • 将命令内部的读取操作（使用已知的文件描述符编号，例如 “n”）从文件重定向，使用标记 “<[n]”，文件名出现在其右侧。
  • 将命令内部的读写操作（使用已知的文件描述符编号，例如 “n”）重定向到文件，使用标记 “<>[n]”，文件名出现在其右侧。为了将标准输出和标准错误都重定向到一个文件，可以使用 “> filename >[2=1]” 的形式。这个序列首先将标准输出（即文件描述符 1）重定向到 filename，然后将写入文件描述符 2（即标准错误）的内容重定向到文件描述符 1，而文件描述符 1 现在与 filename 关联。
• 环境变量：每个进程都可以通过变量 “arg0” 访问其调用名称。命令行参数（不包括调用名称）可以作为列表在变量 “argv” 中访问。“argv” 列表中的元素数量存储在 “argc” 中。“get” 命令可用于从此列表中获取单个参数。当前进程的 pid 可以从变量 “pid” 中获取。当脚本在后台启动新进程时，子进程的 pid 可以从变量 “child” 中访问。变量 “ContollerId” 设置为 RaidRunner 控制器编号，husky 在其上运行。环境变量是每个进程的独立 “空间”。根据进程的创建方式，其初始环境变量集可能会在 “spawn” 点从其父进程复制而来。
• 另请参阅：intro

3.9.30  HWCONF - 打印各种硬件配置详情

• 概要：hwconf [-D] [-M] [-I] [-d [-n]] [-f] [-h] [-i -p c.s.l] [-m] [-p c.s.l] [-s] [-S] [-t] [-T] [-P] [-W]
• 描述：hwconf 打印有关 RaidRunner 硬件和连接设备的详细信息。
• 选项
  • -h: 打印控制器数量、每个控制器的主机接口数量、每个控制器的磁盘通道数量、磁盘阵列的数量以及每个控制器的内存详细信息（以字节为单位）。打印四个内存数字，第一个是控制器中的总内存，接下来是启动时的内存量，然后是当前可用内存量，最后是最大的可用连续内存区域。这是默认选项。
  • -f: 打印 RaidRunner 中的风扇数量，然后打印系统中每个风扇的速度。速度值以每分钟转数 (rpm) 为单位。系统中的风扇在您的 RaidRunner 硬件规格表中标记。从此命令打印的第一个速度对应于您的规格表上的风扇编号 0，第二个速度对应于风扇 1，依此类推。
  • -d: 打印 RaidRunner 上所有磁盘驱动器的信息。对于 RaidRunner 上的每个磁盘，打印输出 - 设备名称，格式为 c.s.l，其中 c 是通道，s 是 SCSI ID（或阵列），l 是设备的 SCSI LUN，制造商名称（供应商 ID），磁盘型号名称（产品 ID），磁盘版本 ID，磁盘序列号，磁盘几何信息 - 柱面数、磁头数和扇区数，以及磁盘上的最后一个块号和块大小（以字节为单位）。磁盘每分钟转数 (rpm)，驱动器上可用的槽口/区域数（如果有）。
  • -n: 如果可用，则打印磁盘驱动器槽口/区域表。这是 -d 选项的子选项。并非所有磁盘都能正确报告槽口/区域分区表。对于每个槽口/区域，
  • 打印以下信息：区域号、区域的起始柱面、区域的起始磁头、区域的结束柱面、区域的结束磁头、区域的起始逻辑块号、区域的结束逻辑块号、区域的每磁道扇区数
  • -D: 打印系统上所有磁盘驱动器的设备名称。
  • -I: 初始化后端 NCR SCSI 芯片。此标志可以与其他任何选项结合使用，并将首先执行。它仅对尚未使用的 -d、-D 或 -I 选项的 hwconf 的首次调用，或尚未在其关联通道上使用 -p 的芯片生效。
  • -m: 打印主闪存和电池备份 RAM 地址（十六进制）。此外，还打印 RaidRunner 配置区域的大小。按顺序打印八 (8) 个地址：RaidRunner 配置区域起始和结束地址（闪存 RAM），RaidRunner Husky 脚本区域起始和结束地址（闪存 RAM），RaidRunner 二进制映像区域起始和结束地址（闪存 RAM），RaidRunner 电池备份区域起始和结束地址。然后打印 RaidRunner 配置区域的大小（以字节为单位）。
  • -p c.s.l: 探测由给定通道、SCSI ID（阵列）和 SCSI LUN 指定的单个设备，格式为 “c.s.l”。此命令的输出与 “-d” 选项相同，但仅适用于给定设备。如果设备不存在，则不会输出任何内容，并且命令的退出状态将为 1。
  • -i -p c.s.l: 重新初始化由给定通道、SCSI ID（阵列）和 SCSI LUN 指定的 SCSI 设备驱动程序，格式为 “c.s.l”。通常，当在运行的 RaidRunner 上插入新驱动器时，以及在 RaidRunner 下次重启之前，会使用此命令。
  • -M: 设置启动时内存。此选项在启动时由控制器内部执行，在任何其他时间执行都没有功能（或效果）。
  • -s: 打印 RaidRunner 的 12 位字符序列号。
  • -S: 尽快向所有后端发出 SCSI 启动命令。此选项旨在仅在开机阶段使用。
  • -t: 探测温度监视器，返回 RaidRunner 的内部温度（摄氏度）。
  • -T: 打印硬件监控守护程序 (hwmon) 记录的温度。
  • -P: 对于 AC 和 DC 电源，打印每个电源的数量以及每个电源的状态。状态将打印为 ok 或 flt，具体取决于 PSU 是否工作正常或故障。
  • -W: 此选项将等待直到所有可能的后端都已启动。它与
• 注意：磁盘信息的打印顺序是按 SCSI ID（阵列）、通道、SCSI LUN 排序。

3.9.31  HWMON - 温度、风扇、PSU 监控守护程序。

• 概要：hwmon [-t 秒数] [-d]
• 描述：hwmon 是一个硬件监控守护程序。它定期探测 RaidRunner 某些元素的状态，如果发生带外事件，将导致警报响起或故障 LED 亮起，并在系统日志中保存消息。根据 RaidRunner 的型号，监控的元素包括温度、风扇和电源。当发现带外事件时，hwmon 会将探测之间的时间缩短到 5 秒。如果蜂鸣器是报警设备，则蜂鸣器将开启 5 秒，然后关闭 5 秒，并重复此循环，直到蜂鸣器静音或事件得到纠正。
  
  如果 RaidRunner 型号支持蜂鸣器静音开关，则如果在每个周期变化期间按下开关，蜂鸣器将静音，如上一段所述。当 hwmon 识别到静音开关时，它会发出两次蜂鸣声。
  
  某些带外事件可以被认为是灾难性的，这意味着如果事件仍然未纠正，RaidRunner 的硬件可能会损坏。诸如风扇完全故障和持续高温以及风扇部分或完全故障等事件被认为是灾难性的。hwmon 有一种自动将 RaidRunner 置于 “shutdown” 或静止状态的方法，在这种状态下，功耗最小（因此产生的热量也更少）。这是通过在灾难性带外事件持续一段时间后执行 shutdown 命令来完成的。此过程通过 AutoShutdownSecs 内部变量启用。有关此变量的用法，请参阅内部手册。可以通过创建全局环境变量 NoHwmon 并为其设置任何值来阻止 hwmon 在启动时启动。警告消息将存储在 syslog 中。
  
  
• 选项
  • t 秒数：指定硬件元素探测之间等待的秒数。如果未指定此选项，则默认周期为 300 秒。
  • -d: 开启调试模式，可以生成调试输出。
• 另请参阅：hwconf, pstatus, syslogd, shutdown, internals

3.9.32  INTERNALS - RaidRunner 使用的内部变量，用于更改运行内核的动态特性

• 描述：RaidRunner 的某些运行时功能可以通过使用 setiv 命令更改内部变量来操作。下表描述了每个可更改的变量、其效果、其默认值以及可以设置的值范围。以下变量是 RaidRunner 的运行时功能，因此在 RaidRunner 启动时始终设置为其默认值。某些变量可以存储为全局环境变量，并在启动时覆盖默认值。如果您创建了一个具有该变量名称和适当值的全局环境变量，则下次 RaidRunner 重新启动时，其默认值将被覆盖。请注意，当在全局环境变量表中设置这些变量的值时，不会对其进行检查，如果设置不正确，则会在启动时生成错误，直到删除或纠正为止。在下表中，任何可以将其值存储为全局环境变量的变量都标有 (GEnv)
• write_limit: 此变量是缓存文件系统将为写入操作缓冲的最大 512 字节块数。如果达到此限制，则所有对缓存文件系统的写入操作都将被阻止，直到缓存文件系统写入（到其后端）足够的块以达到低水位线 - write_low_tide。如果有电池备份 RAM 可用，则无法更改此变量，因为它与可用的电池备份 RAM 量相关联。此变量的值在初始化缓存时计算。其值取决于 RaidRunner 中是否安装了电池备份 RAM。如果已安装，则计算可以保存到电池备份 RAM 中的数据块数。如果不存在电池备份 RAM，则其值设置为 RaidRunner 内存的 75%（以 512 字节块的计数表示），然后进行调整以反映配置的 raid 集请求的缓存量。当 write_limit 更改时，write_high_tide 和 write_low_tide 都会自动更改为其默认值（write_limit 值的函数）。
• write_high_tide: 此变量是缓存中已写入 512 字节块数的高水位线。当数据块的数量超过此值时，为了避免缓存文件系统阻止其前端，缓存刷新机制会持续刷新缓存缓冲区，直到未写入（到后端）的缓存缓冲区数量低于低水位线 (write_low_tide)。此值默认为 write_limit 的 75%。此变量的值范围可以从 write_limit 下降到 write_low_tide。建议不要更改此变量。
• write_low_tide: 此变量是缓存刷新机制持续将数据刷新到其后端时的低水位线。一旦尚未刷新的已写入缓存块的数量等于或小于此值，持续刷新就会停止。此值默认为 write_limit 的 25%。此变量的值范围可以从 write_high_tide-1 下降到零 (0)。建议不要更改此变量。
• cache_nflush: 此变量是缓存刷新机制在一个刷新周期中尝试写出的缓存缓冲区数量（不是 512 字节数据块）。调整此值可能会提高写入性能，具体取决于缓存缓冲区的大小以及 raid 集后端中使用的磁盘驱动器类型。默认值为 128。其值范围可以从 2 到 128。
• cache_nread: 此变量是缓存读取机制在一个读取周期中尝试读取的缓存缓冲区数量（不是 512 字节数据块）。调整此值可能会提高读取性能，具体取决于缓存缓冲区的大小以及 raid 集后端中使用的磁盘驱动器类型。默认值为 128。其值范围可以从 2 到 128。
• cache_wlimit: 此变量是缓存刷新机制尝试合并到单个顺序写入中的缓存缓冲区数量（不是 512 字节数据块）。它与 cache_nflush 不同之处在于，cache_nflush 是可以在单个缓存刷新周期中写入的缓存缓冲区总数，这些缓冲区可以是无序的，而 cache_wlimit 是可以一次写入的顺序缓存缓冲区的数量限制。调整此值可能会提高写入性能，具体取决于缓存缓冲区的大小以及 raid 集后端中使用的磁盘驱动器类型。默认值为 128。其值范围可以从 2 到 128。
• cache_fperiod (GEnv): 默认情况下，缓存每 1000 毫秒刷新一次要写入的数据（除非由于缓存即将满而强制刷新缓存并重置计时器）。您可以通过设置此变量来更改此刷新周期。如果您有大量的持续读取和最少的写入，那么您可能希望尽可能延迟将缓存写入后端。请注意，将其设置为较高的值会使您冒着丢失已写入内容的风险。默认值为 1000 毫秒（即 1 秒）。其值范围可以从 500 毫秒到 300000 毫秒。
• scsi_write_thru (GEnv): 默认情况下，所有写入操作（来自主机）都缓冲在 RaidRunner 的缓存中，并定期刷新到后端磁盘。当电池备份 RAM 可用时，这将产生最有效的写入吞吐量。如果没有电池备份 RAM 可用，或者您不想依赖于在断电情况下保存在电池备份 RAM 中的写入操作，您可以强制 RaidRunner 在向主机返回 OK 状态之前将数据直接写入后端。这实际上提供了直写缓存。此变量的默认值为 0 - 直写模式已禁用。此变量可以取的值为
  • 0 - 禁用直写模式，或
  • 1 - 启用直写模式。
• scsi_write_fua (GEnv): 此变量影响在 SCSI WRITE-10 命令上设置 FUA（强制单元访问）位时所执行的操作。当启用此变量且 SCSI WRITE-10 命令的 FUA 位设置为已处理时，数据将直接通过缓存写入后端磁盘。如果禁用此变量，则 SCSI WRITE-10 命令上 FUA 位的设置将被忽略。如果存在电池备份 RAM，则此变量的默认值禁用 (0)，如果不存在电池备份 RAM，则启用 (1)。此变量可以取的值为
  • 0 - 忽略 SCSI WRITE-10 命令上的 FUA 位，或
  • 1 - 对 SCSI WRITE-10 命令上的 FUA 位执行操作。
• scsi_ierror (GEnv): 此变量控制当 RaidRunner 在 SCSI 主机通道上收到 Initiator Detected Error 消息时所执行的操作。如果设置 (1)，则导致检查条件，如果未设置 (0)，则遵循 SCSI-2 标准并重新传输数据输入/输出阶段。默认值为 0。此变量可以取的值为
  • 0 - 遵循 SCSI-2 标准
  • 1 - 忽略 SCSI-2 标准并导致检查条件。
• scsi_sol_reboot (GEnv): 确定是否自动检测 Solaris 重新启动并清除任何宽模式协商。如果设置 (1)，则检测 Solaris 重新启动并清除宽模式。如果未设置 (0)，则遵循 SCSI-2 标准，不清除宽模式。默认值为 0。此变量可以取的值为
  • 0 - 遵循 SCSI-2 标准
  • 1 - 忽略 SCSI-2 标准并清除宽模式。
• scsi_hreset (GEnv): 确定是否在开机后在主机端口上发出 SCSI 总线复位。如果设置 (1)，则在主机端口上启动第一个 smon/stargd 进程时，在该端口上执行 SCSI 总线复位。如果未设置 (0)，则不执行任何操作。默认值为 0。此变量可以取的值为
  • 0 - 开机时不发出 SCSI 总线复位。
  • 1 - 在启动第一个 smon/stargd 进程时，开机时发出 SCSI 总线复位。
• scsi_full_log (GEnv): 确定 stargd 是否通过 syslog 报告 Read、Write、Test Unit Ready 和 Start Stop 命令的复位检查条件。当 RaidRunner 启动或 raid 检测到 scsi 总线复位时，始终设置此复位检查条件。请注意，此变量仅抑制将此检查条件记录到 syslog 中，它不影响对此和任何检查条件的主机响应。如果设置 (1)，则记录所有 stargd 检测到的复位检查条件错误消息。如果未设置 (0)，则抑制这些消息。默认值为 0。此变量可以取的值为
  • 0 - 抑制记录这些消息
  • 1 - 记录所有消息。
• scsi_ms_badpage (GEnv): 确定 stargd 是否通过 syslog 报告它在从主机接收的 MODE SENSE 或 MODE SELECT 命令中收到了不支持的页码。请注意，无论此变量的值如何，stargd 都将向主机发出适当的检查条件 (“CDB 中的无效字段”)。如果设置 (1)，则记录所有 stargd 检测到的 MODE SENSE 和 MODE SELECT 命令中不支持的页码。如果未设置 (0)，则抑制这些消息。默认值为 0。此变量可以取的值为
  • 0 - 抑制记录这些消息
  • 1 - 记录所有消息。
• scsi_bechng (GEnv): 确定 raid 是否报告后端设备参数更改错误。在多控制器环境中，后端会被探测，并且某些参数会被启动控制器更改。这将生成参数更改模式感应错误。如果清除 (0)，则不会记录所有参数更改错误。如果设置 (1)，则像任何其他后端错误一样记录这些消息。默认值为 0。此变量可以取的值为
  • 0 - 抑制记录这些消息
  • 1 - 记录所有消息。
• scsi_dnotch (GEnv): 某些磁盘驱动器需要过多的时间来执行模式选择命令。RaidRunner 将从设备后端获得的一组信息是磁盘槽口页（如果存在）。由于这仅用于信息目的，因此为了缩短 RaidRunner 的启动时间，您可以请求不获取磁盘槽口。如果清除 (0)，则不探测后端磁盘槽口信息。如果设置 (1)，则探测后端磁盘槽口信息。默认值为 1。此变量可以取的值为
  • 0 - 不探测槽口页
  • 1 - 探测槽口页
• scsi_rw_retries (GEnv): 指定在对给定操作产生错误之前，对设备后端执行的读取或写入重试次数。请注意，所有重试都通过 syslog 报告。默认值为 3。其值范围可以从 1 到 9。
• scsi_errpage_r (GEnv): 指定磁盘后端在报告错误（到 raid）之前要执行的内部读取重试次数。设置此变量会导致读取-写入错误恢复模式感应页中的读取重试计数字段。值 -1 将导致使用驱动器的默认值。默认值为 -1。其值范围可以从 -1（使用磁盘的默认值）或从 0 到 255。
• scsi_errpage_w (GEnv): 指定磁盘后端在报告错误（到 raid）之前要执行的内部写入重试次数。设置此变量会导致读取-写入错误恢复模式感应页中的写入重试计数字段。值 -1 将导致使用驱动器的默认值。默认值为 -1。其值范围可以从 -1（使用磁盘的默认值）或从 0 到 255。
• BackFrank: 指定 RaidRunner 上后端磁盘第一个阵列的 SCSI-ID。此变量永远不应更改，仅供参考。默认值取决于正在运行的 RaidRunner 型号。此变量可以取的值为
  • 0 - 第一个阵列 SCSI-ID 将为 0
  • 1 - 第一个阵列 SCSI-ID 将为 1
• raid_drainwait (GEnv): 指定 raidset 在后端发生故障时，在耗尽所有后端 I/O 之前要延迟的毫秒数。将此变量设置为较低的值将加快在后端发生故障时将在 raid 集上执行的任何错误恢复程序的开始速度。默认值为 500 毫秒。其值范围可以从 50 到 10000 毫秒。
• EnclosureType: 指定 raid 控制器在其中运行的机箱类型。此变量永远不应更改，仅供参考。默认值取决于正在运行的 RaidRunner 型号。此变量可以取的值是从 0 开始的整数。
• fmt_idisc_tmo (GEnv): 指定在后端发出 SCSI FORMAT 命令时的 SCSI 命令超时时间（以毫秒为单位）。磁盘驱动器执行 SCSI FORMAT 命令所需的时间不同，因此在发出命令时需要设置超时时间。由于某些驱动器格式化时间可能比默认超时时间长，因此您可以更改它。默认值为 720000 毫秒。其值范围可以从 200000 到 1440000 毫秒。
• AutoShutdownSecs (GEnv): 指定 RaidRunner 在决定自动关机之前应监控灾难性硬件故障的秒数。灾难性故障是指如果不立即修复，将对 RaidRunner 的硬件造成损坏的故障。例如，所有风扇都出现故障将被认为是灾难性的。值为 0 秒（默认值）将禁用此功能，也就是说，除了记录错误之外，不会发生任何操作。有关更多详细信息，请参阅 shutdown 和 hwmon。默认值为 0 秒。其值范围可以从 20 到 125 秒。
• 另请参阅：setiv, getiv, syslog, setenv, printenv, hwmon, shutdown

3.9.33  KILL - 向指定的进程发送信号

• 概要：kill [-sig_name] pid
• 描述：kill 向 pid 指定的进程发送信号。如果 pid 是正数，则仅向指定的进程发送信号。如果 pid 是负数，则信号将发送到与进程 id 为 -pid 的进程位于同一进程组中的所有进程。开关是可选的，如果未给出，则发送 SIGTERM（软件终止信号）。如果给出了 sig_name 开关，则它应该是以下（小写）缩写之一。只需给出信号名称的前 3 个字母即可被识别。每个缩写后面都有一个简要说明和括号中的信号编号
  
  null - 未使用的信号 [0]
  
  hup - 挂断 [1]
  
  int - 中断 (rubout) [2]
  
  quit - 退出 (ASCII FS) [3]
  
  kill - 杀死（无法捕获或忽略） [4]
  
  pipe - 在无人读取的管道上写入 [5]
  
  alrm - 闹钟 [6]
  
  term - 软件终止信号 [7]
  
  cld - 子进程状态已更改 [8]
  
  nomem - 无法获取内存（来自堆） [9]
  
  您无法杀死进程 id 在 0 到 5 之间的进程。这些被认为是神圣不可侵犯的 - hyena、init 和控制台读取器/写入器。
  
  
• 另请参阅：K9kill

3.9.34  LED- 打开/关闭 RaidRunner 上的 LED

• 概要
  • led
  • led led_id led_function
• 描述：led 使用给定的 led_id 来识别要基于 led_function 操作的 LED。当未给出任何参数时，将打印内部 LED 寄存器以及板载 LEDS、led1 和 led2 当前跟踪的功能。如果给出了未定义的 led_id，则 led 命令静默地不执行任何操作并返回 NULL。如果给出了不正确的参数数量或无效的 led_function，则会打印用法消息。根据 RaidRunner 型号，led_id 可以是以下之一
  • led1 - RaidRunner 控制器本身的 LED1
  • led2 - RaidRunner 控制器本身的 LED2
  • Dc.s.l - 通道 c、scsi id s、scsi lun l 上的设备
  • status - RaidRunner 上的状态 LED
  • io - RaidRunner 上的 io LED
  而 led_function 可以是以下之一
  • on - 打开给定的 LED
  • off - 关闭给定的 LED
  • ok - 将给定的 LED 设置为定义的 OK 状态
  • faulty - 将给定的 LED 设置为定义的 FAULTY 状态
  • warning - 将给定的 LED 设置为定义的 WARNING 状态
  • rebuild - 将给定的 LED 设置为定义的 REBUILD 状态
  • tprocsw - 将给定的 LED 设置为跟踪内核进程切换
  • tparity - 将给定的 LED 设置为跟踪 I/O 奇偶校验生成
  • tdisconn - 将给定的 LED 设置为跟踪主机接口断开活动
  • pid - 将给定的 LED 设置为跟踪进程 pid 的运行
  不同型号的 RaidRunner 在 LED 数量及其功能方面存在各种差异。根据 LED 的类型，ok、faulty、warning 和 rebuild 功能执行不同的功能。请参阅您的 RaidRunner 硬件参考手册，了解存在哪些 LED 以及不同的功能执行哪些操作。
  
  
• 注意：跟踪活动只能在 “板载” LED（LED1、LED2）上进行。
• 另请参阅：lflash

3.9.35  LFLASH- 闪烁 RaidRunner 上的 LED

• 概要：lflash led_id 周期
• 描述：lflash 使用给定的 led_id 来识别要每周期秒闪烁一次的 LED。如果给出了未定义的 led_id，则 led 命令静默地不执行任何操作并返回 NULL。根据 RaidRunner 型号，led_id 可以是以下之一
  
  led1 - RaidRunner 控制器本身的 LED1
  
  led2 - RaidRunner 控制器本身的 LED2
  
  Dc.s.l - 通道 c、scsi id s、scsi lun l 上的设备
  
  status - RaidRunner 上的状态 LED
  
  io - RaidRunner 上的 io LED
  
  
• 注意：秒数必须大于或等于 2。
• 另请参阅：led

3.9.36  LINE - 将标准输入的一行复制到标准输出

• 概要：line
• 描述：line 通过读取直到换行符，然后执行单个 K9write 来完成单行复制。
• 另请参阅：K9read, K9write

3.9.37  LLENGTH - 返回给定列表中元素的数量

• 概要：llength 列表
• 描述：llength 返回给定列表中元素的数量。
• 示例： 一些简单示例

  set list D1 D2 D3 D4 D5 # 创建列表
  
  set len `llength $list' # 获取其长度
  
  echo $len
  
  5
  
  set list {D1 D2 D3 D4 D5} {D6 D7}  # 创建列表
  
  set len `llength $list' # 获取其长度
  
  echo $len
  
  2
  
  set list {} # 创建一个空列表
  
  set len `llength $list' # 获取其长度
  
  echo $len
  
  0

3.9.38  LOG - 类似于 zero，但增加了访问日志记录

• 概要：bind -k {log fd error_rate tag} bind_point
• 描述：log 是一个特殊文件，写入时是无限的数据接收器（即，任何内容都可以写入其中，并且它将被快速丢弃）。当读取 log 时，它是零的无限源（即，字节值 0）。log 文件将出现在 K9 命名空间中的 bind_point。此外，ASCII 日志数据将写入与文件描述符 fd 关联的文件。error_rate 应为介于 0 和 100 之间的数字，并且是将报告给调用者的错误百分比（随机分布）（作为 EIO 错误）。写入 fd 的每一行都将附加 tag。对于 log 特殊文件上的每个 IO 操作，都有一行输出到 fd。输出的第一个字符是 “R” 或 “W”，表示读取或写入。第二个字符如果未报告错误则为空格，如果报告了错误则为 “*”。接下来（在空格之后）是操作开始时文件中的偏移量（64 位整数），后跟该操作的大小（以字节为单位）。该行以 tag 结尾。
• 示例：在 “/dev/log” 绑定一个 log 特殊文件，该文件将日志信息写入标准错误。写入标准错误的每一行都附加了标签字符串 “scsi”。大约 30% 的读取和写入（即随机分布）向调用者返回 EIO 错误。这可以通过以下方式完成

  bind "log 2 30 scsi" /dev/log
  
  dd if=/dev/zero of=/dev/log count=5 bs=512
  
  W  0000000000 512        scsi
  
  W  0000000200 512        scsi
  
  W  0000000400 512        scsi
  
  W* 0000000600 512        scsi
  
  写入失败。
  
  4+0 记录输入
  
  3+0 记录输出

• 另请参阅：zero

3.9.39  LRANGE - 从给定列表中提取一系列元素

• 概要：lrange first last list
• 描述：lrange 返回一个列表，其中包含列表的从 first 到 last 的元素。0 指的是列表中的第一个元素。如果 first 大于 last，则列表将以相反的顺序提取。
• 示例： 一些简单示例

3.9.40  LS - 列出目录中的文件

• 概要：ls [ -l ] [ 目录... ]
• 描述：ls 命令列出给定目录中的文件，并输出到标准输出。如果没有给定目录，则列出根目录（即“/”）。目录中包含的每个文件名都放在单独的一行上。每个列表都有一个前导行，说明正在显示的目录。如果目录超过一个，则它们按顺序排列，并用空行分隔。如果给出“-l”开关，则每个列出的文件都会显示其长度和所属文件系统等数据，与文件名在同一行显示。有关更多信息，请参阅 stat 命令。ls 不是内置命令，而是一个 husky 脚本，它利用了 cat 和 stat。脚本源代码可以在文件“/bin/ps”中找到。
• 另请参阅：cat, stat

3.9.41  LSEARCH - 在列表中查找模式

• 概要：lsearch 模式 列表
• 描述：lsearch 返回列表中与模式匹配的第一个元素的索引，如果未找到匹配项，则返回 -1。0 指的是列表中的第一个元素
• 示例： 一些简单示例

3.9.42  LSUBSTR - 替换列表中所有元素中的字符

• 概要：lsubstr 查找字符 替换字符 列表
• 描述：lsubstr 返回一个列表，其中列表中任何元素中找到的每个查找字符都替换为替换字符。replacement_char 可以为 NULL，这实际上会删除列表中的所有 find_char 字符。
• 示例： 一些简单示例

3.9.43  MEM - 内存映射文件（系统）

• 概要：bind -k {mem first last [ r ]} 绑定点
• 描述：mem 允许将机器内存作为单个 K9 文件（而不是文件系统）访问。主机系统的内存从第一个内存位置开始，直到并包括最后一个内存位置。first 和 last 都需要以十六进制给出。如果成功，mem 文件将出现在 K9 命名空间中的绑定点。stat 命令会将其显示为普通文件，并具有适当的大小（即 last - first + 1）。如果给出了可选的“r”，则只允许对文件进行只读访问。在目标环境中，mem 可以有效地将电池后备 RAM（或 ROM）与 K9 命名空间关联起来。在 Unix 环境中，它的用途有限（请参阅 unixfd）。在 DOS 环境中，它可能有助于直接访问内存（IO 空间），但要访问 DOS 控制台，请参阅 doscon。当 mem 与存储 husky 脚本的 Flash RAM 分区关联时，该分区是压缩存储的，从该页面读取将自动解压缩并返回读取的数据。当 mem 与 Flash RAM 的可写分区（配置分区、husky 脚本分区和主二进制分区）关联时，写入任何分区开头都会擦除该分区。
• 另请参阅：ram
• 错误：只能绑定单个文件，而不是文件系统。

3.9.44  MDEBUG - 练习和显示有关内存分配的统计信息

• 概要：mdebug [off|on|trace|p|m size|f ptr|c nel elsize|r ptr size]
• 描述：mdebug 可用于直接分配和释放内存。mdebug 还会打印（到标准输出）有关当前内存分配状态的信息。如果没有给出任何选项，则会打印一个简短的五行内存使用情况摘要，例如：

  : raid; mdebug
  
  Mdebug 已关闭
  
  nreq-nfree=87096-82951=4145(13905745)
  
  size=15956672/16150000
  
  waste=1%/2%
  
  list=4251/8396
  
  : raid;

  第一行指示调试模式，可以是 off、on 或 trace。第二行指示请求内存的次数（到 Mmalloc() 或 Mcalloc() 和相关函数）和调用内存分配器释放内存的次数（通过 Mfree()）。这两个数字之间的差值是当前已分配内存块的总数，括号内的数字是请求的总内存。请注意，实际分配的内存量可能多于请求的内存量。
  
  第三行指示正在管理的内存量。第二个数字是管理的内存总量（即加载静态分配的 text、data 和 bss 空间后剩余的内存）。第一个数字是从上述数字中减去各种内存分配表后剩余的内存。第四行是分配给请求的额外内存总量，超过了实际请求的内存，与第 3 行的总量相比。
  
  第五行与当前已分配内存的列表有关。第一个数字是剩余的空闲条目数，第二个数字是最大表大小。请注意，当前已分配块的数量（第 2 行的第三个数字）加上第 5 行的第一个数字，等于第 5 行的第二个数字。
  
  
• 选项
  • p: 打印上述五行摘要，然后打印空闲列表。
  • P: 打印以上所有内容，外加转储当前已分配内存的列表。
  • PP: 打印以上所有内容，外加空闲位图。
  以上三个选项可能会生成大量输出，并且需要详细了解源代码才能理解其含义。
  • off: 关闭内存分配调试。这是启动后的默认条件。
  • on: 开启内存分配断言检查。
  • trace: 开启内存分配断言检查并跟踪每次内存分配/释放。
  • m: 使用 Mmalloc() 分配大小为 size 字节的内存块。
  • f: 使用 Mfree() 释放 ptr 地址处的内存块。
  • c: 使用 Mcalloc() 分配一个连续的内存块，该内存块由 nel 个元素组成，每个元素的大小为 bytes。
  • r: 使用 Mrealloc() 重新分配先前分配的内存块 ptr，将分配的大小更改为 size 字节。
• 另请参阅：Unix man pages on malloc()

3.9.45  MKDIR - 创建目录（或多个目录）

• 概要：mkdir [ 目录名 ... ]
• 描述：mkdir 创建给定的目录（或多个目录）。如果所有给定的目录都可以创建，则返回 NIL 作为状态；否则，返回第一个无法创建的目录（并且此命令将继续尝试创建目录，直到列表耗尽）。无法使用先前在封闭目录中存在的文件名创建目录。

3.9.46  MKDISKFS - 用于创建磁盘文件系统的脚本

• 概要：mkdiskfs 磁盘目录根目录 磁盘名称
• 描述：mkdiskfs 是一个 husky 脚本，用于执行所有必要的命令来创建磁盘文件系统，给定磁盘文件系统的根目录和磁盘名称。
• 选项
  • disk_directory_root: 指定磁盘文件系统绑定的目录根目录。通常为 /dev/hd。
  • disk_name: 指定磁盘名称，格式为 Dc.s.l，其中 c 是通道，s 是 scsi id（或 rank），l 是磁盘的 scsi lun。
  在解析其参数后，mkdiskfs 创建磁盘文件系统的绑定点，并在该点绑定磁盘。设置。
  
  
• 另请参阅：rconf, scsihdfs

3.9.47  MKHOSTFS - 用于创建主机端口文件系统的脚本

• 概要：mkhostfs 控制器编号 主机端口 主机总线目录
• 描述：mkhostfs 是一个 husky 脚本，用于执行所有必要的命令，以便在给定的 RaidRunner 控制器上创建主机端口文件系统，给定主机端口文件系统的根目录和主机端口号。
• 选项
  • controller_number: 指定要在其上创建主机端口文件系统的控制器。
  • host_port: 指定要为其创建文件系统的主机端口号。
  • host_bus_directory: 指定主机文件系统绑定的目录根目录。通常为 /dev/hostbus。在解析其参数后，mkhostfs 找出主机端口要呈现的 SCSI ID（请参阅 hconf），然后绑定主机文件系统。设置。
• 另请参阅：hconf, scsihpfs

3.9.48  MKRAID - 用于根据 rconf 的输出行创建 raid 的脚本

• 概要：mkraid `rconf -list RaidSetName'`
• 描述：mkraid 是一个 husky 脚本，用于执行所有必要的命令，以创建 raid 集并启用主机对其的访问。mkraid 的参数是 rconf -list 命令的输出行。在解析其参数后，mkraid 检查 RaidRunner 上次运行时是否正在执行重建，如果是，则记录下来。然后，它创建 raid 文件系统 (参见 mkraidfs)，并向 raid 文件系统添加缓存前端。然后，它创建所需的主机文件系统 (参见 mkhsotfs)，最后，如果 RaidRunner 上次运行时正在进行重建，则重新启动重建。
• 注意：此 husky 脚本不启用对它创建的 raid 集的目标访问 (stargd)。
• 另请参阅：rconf, mkraidfs, mkhostfs

3.9.49  MKRAIDFS - 用于创建 raid 文件系统的脚本

• 概要：mkraidfs -r raidtype -n raidname -b backends [-c chunk] [-i iomode] [-q qlen] [-v] [-C capacity] [-S]
• 描述：mkraidfs 是一个 husky 脚本，用于执行所有必要的命令来创建 Raid 文件系统。
• 选项
  • -r raidtype: 指定 raid 集的 raid 类型为 raidtype。必须为 0、1、3 或 5。
  • -n raidname: 指定 raid 集的名称为 raidname。
  • -b backends: 指定 raid 集后端以逗号分隔的列表，格式与 rconf 使用的格式相同。
  • -c iosize: 可选地指定 raid 集的 IOSIZE（以字节为单位）。
  • -i iomode: 可选地指定 raid 集的 iomode - read-write、read-only、write-only。
  • -q qlen: 可选地指定 raid 集的每个后端的队列长度。
  • -v: 启用详细模式，该模式会打印执行的主要操作（绑定、engage 命令）。
  • -C capacity: 可选地指定 raid 集的大小，以 512 字节块为单位。
  • -S: 可选地指定如果后端发生故障，则需要备件池访问。
  在解析其参数后，mkraidfs 创建 Raid Set 的后端文件系统，通常是磁盘（参见 mkdisfs），并处理故障后端。然后，它绑定 raid 文件系统，并将后端挂载到文件系统中。如果请求备件访问，它将启用 raid 集的自动修复功能。
  
  
• 另请参阅：rconf, mkraidfs, mkhostfs, mkdiskfs, raid[0135]fs

3.9.50  MKSMON - 用于启动 scsi 监视器守护程序 smon 的脚本

• 概要：mksmon 控制器编号 主机端口 scsi_lun 协议列表
• 描述：mksmon 是一个 husky 脚本，用于执行所有必要的命令来启动 scsi 监视器守护程序 smon，给定控制器编号、主机端口、scsi lun 和块协议列表。通常，mksmon 的参数来自 mconf -list 命令的输出。
• 选项
  • controllerno: 指定要在其上运行 scsi 监视器守护程序的控制器。
  • hostport: 指定 scsi 监视器守护程序通过其通信的主机端口。
  • scsi_lun: 指定 scsi 监视器守护程序要响应的 SCSI LUN。
  • protocol_list: 指定 scsi 监视器守护程序要实现的以逗号分隔的块协议列表。
  在解析其参数后，mksmon 检查它是否已经在运行，如果正在运行，则发出消息并退出。否则，它创建主机文件系统 (mkhostfs)，创建内存文件和 fifo 集供 smon 使用，最后启动 smon 设置。
  
  
• 另请参阅：smon, mconf, mkhostfs, fifofs

3.9.51  MKSTARGD - 用于为给定 raid 集初始化 scsi 目标守护程序的脚本

• 概要：mkstargd `rconf -list raidname'`
• 描述：mkstargd 是一个 husky 脚本，用于执行所有必要的命令来启动和初始化给定 raid 集的 scsi 目标守护程序 stargd。通常，mkstargd 的参数来自 rconf -list 命令的输出。在解析其参数后，mkstargd 检查它是否已经在运行，如果正在运行，则发出消息并退出。否则，它创建主机文件系统 (mkhostfs)，然后为给定的 raid 集启动 scsi 目标守护程序 (stargd)。stargd 以响应非介质访问 SCSI 命令的模式启动，并将状态设置为“spinning up”。通常，stargd 会尽快启动，但在底层 raid 集创建之前不允许介质访问命令，然后标记为“spun up”（通过 mstargd -o 命令），从而允许介质访问。
• 另请参阅：stargd, rconf, mkhostfs

3.9.52  MSTARGD - stargd 监视器

• 概要：mstargd [-a] [-d level] [-h] [-hr] [-hw] [-l] [-m] [-n] [-o offset] [-R] [-s] [-t] [-v] [-W] [-z] [-Z spinstate] [-U] [-irgap nblks] pid
• 描述：mstargd 修改状态或打印出有关给定 pid 的 stargd 守护程序的信息。如果存在这样的进程并且没有给出可选开关，则此调用会将该 stargd 守护程序的当前调试级别打印到标准输出。
  
  mstargd 通过查找名为“/mon/stargd/pid”的文件来工作。如果未找到该文件，或者 pid 不代表现有进程，则 mstargd 将退出并显示相应的错误消息。如果找到该文件，则假定它包含对关联的 stargd 进程的状态（和统计信息）结构的引用。对于目标硬件（如 raid（没有内存管理））的“引用”是内存地址。对于 Unix 机器，“引用”可以是共享内存标识符或内存地址（取决于 K9 进程如何映射到 Unix 进程）。
  
  mstargd 执行其监视（或修改）任务，然后立即退出。在使用关联的 stargd 进程的状态（和统计信息）结构之前，会对其执行健全性检查。需要花费一些时间的操作（例如“-h”、“-s”和“-t”）会获取此状态结构的内部副本。mstargd 旨在对正在运行的 stargd 守护程序没有不利影响。请注意，3 个修改操作（即“-o”、“-d”和“-z”）也没有不利影响。
• 选项
  • -a: 此选项与为 mstargd 提供选项“-h -l -m -s -t”具有相同的效果。
  • -d level: 此选项会将指定的 stargd 守护程序的调试级别更改为给定的级别。调试级别为
    • 0 = 无调试消息
    • 1 = 所有非读/写命令的调试消息
    • 2 = 所有命令的调试消息
  • -h: 此选项将输出读取的直方图和写入的单独直方图。直方图当前由标题行和多行组成。每行都有第 1 列中的块数、第 2 列中的调用次数和第 3 列中 SCSI 数据阶段的累积时间。仅输出具有非零调用次数的行。块号 257（如果存在）将是最后一行，并记录所有请求 257 个或更多块的命令。
  • -hr: 此选项仅打印读取的直方图。
  • -hw: 此选项仅打印写入的直方图。
  • -l: 此选项打印 stargd 读取预读统计信息。
  • -m: 此选项打印给定 pid 指示的 raid 集的别名（即名称）。
  • -n: 此选项切换指示的 stargd 进程对统计信息的收集。
  • -o offset: 此选项通知守护程序，对其存储的读取和写入将偏移给定的块数。偏移量的默认值为 0。给定的偏移量必须在 0 到 (2**32 - 1) 范围内。典型的块大小为 512 字节。为了简化大数的写入，可以使用某些后缀，请参阅 suffix。此外，此选项通知守护程序，通过将其 spin 状态设置为 1，其存储现在可供访问。请参阅下面的“-Z”选项。
  • -R: 此选项设置写保护标志，这将导致发送到 stargd 进程（由给定的 pid 指示）的任何写命令返回检查条件，并将 sense key 设置为“DATA PROTECT”，并将 additional sense key 设置为“WRITE PROTECT”。
  • -s: 此选项打印 SCSI 命令状态机的当前状态。
  • -t: 此选项分别为 read(6)、read(10)、write(6)、write(10) 和其他命令打印一行。这 5 行表示所有传入 SCSI 命令的分类。每行都包含调用次数和检测到的错误数。错误分为 2 类：类型 1 用于返回“Check Condition”状态的情况，类型 2 用于返回其他一些失败状态的情况（例如“Command terminated”或“Reservation conflict”）。
  • -v: 此选项以向量（或行）形式打印直方图（-h、-hw、-hr）和 SCSI 命令摘要（-t）。
  • -U: 此选项清除给定 pid 指定的 scsi 目标上设置的任何 SCSI-2 预留。警告：此清除是“控制器系统范围”的。
  • -W: 此选项清除写保护标志，这将使发送到 stargd 进程（由给定的 pid 指示）的写命令能够写入数据。
  • -z: 此选项将直方图使用的内部表归零。
  • -irgap nblks: 指定读取间隙 nblks（以块为单位）。当主机发出顺序读取时，连续读取之间可能会有一个小间隙。通常，预读算法会忽略这些间隙，只要它们不大于已发生的顺序读取组的平均长度即可。通过指定此值，您可以增加此间隙。
  • -Z spinstate: 此选项会将指定的 stargd 守护程序的 spin 状态更改为给定的 spinstate。spin 状态为（状态、描述、ASC、ASCQ）
    • 0, 逻辑单元正在准备就绪过程中, 0x04, 0x01
    • 1, 逻辑单元已就绪 - 允许介质访问命令, -, -
    • 2, 逻辑单元未就绪，需要手动干预, 0x04, 0x03
    • 3, 逻辑单元尚未完成自配置, 0x3e, 0x00
    • 4, 逻辑单元自配置失败, 0x4c, 0x00
    • stargd 的 spin 状态用于描述 tar 的状况，而 tar 处于 NOT READY 状态。当 stargd 未准备好接受 SCSI-2 介质访问命令时，它会向所有介质访问命令返回 CHECK CONDITION 状态，并将 mode sense key 设置为 NOT READY，并将 additional mode sense code 和 code qualifier 设置为取决于 spin 状态值的值。通常，当 RaidRunner 启动时，它需要时间来创建配置的 Raid 集，尽管它需要尽快启动 scsi 目标守护程序 (stargd)。它会启动所有必需的 stargd，并将其 spin 状态设置为 0。一旦 raid 集构建完成并链接到其 stargd，spin 状态将设置为 1，这意味着它将允许和处理 SCSI-2 介质访问命令。（请参阅上面的“-o”选项）。状态 2、3 和 4 的附加 spin 状态可供具有智能 SCSI 驱动程序的高可用性环境中的系统使用。
• 另请参阅：stargd

3.9.53  NICE - 更改 K9 进程的 K9 运行队列优先级

• 概要：nice pid 优先级
• 描述：nice 将把 pid 给出的进程的运行队列优先级更改为优先级。
• 选项
  • pid: 这是要更改其运行队列优先级的 K9 进程的进程标识符。
  • priority: 这是要设置的优先级。优先级范围从 0（最低）到 9（最高）。
• 另请参阅：K9setpriority

3.9.54  NULL- 用于丢弃输出的文件

• 概要：bind -k null 绑定点
• 描述：null 是一个特殊文件，写入时是数据的无限接收器（即，任何内容都可以写入其中，并且会很快被丢弃）。读取 null 时，它是文件结尾的无限源。null 文件将出现在 K9 命名空间中的绑定点。
• 示例：Husky 按如下方式安装 null 特殊文件
  
  bind null /dev/null
  
  
• 另请参阅：zero, log

3.9.55  PARACC - 显示有关硬件奇偶校验加速器的信息

• 概要：paracc
• 描述：paracc 将打印（到标准输出）有关硬件奇偶校验加速器的信息（如果已安装）。对于除 RaidRunner 调试人员以外的所有人来说，主要关注的输出行是第一行，它以字节为单位显示硬件奇偶校验加速器上的内存大小。即
  
  奇偶校验内存可用 : 1048576
  
  PAccLock@0xBF368{own=-1,cnt=1,pvt=0x0,nwait=0,name="PAc"}
  
  请求失败：0，最大使用量：2，分配：1，释放：31
  
  have_paracc 为 1。
  
  请求失败：0 0 0 0 0 0 0 0 0 0
  
  所有其他行仅供调试目的参考。如果没有加速器，则奇偶校验内存可用量将为 0。

3.9.56  PEDIT - 显示/修改 SCSI 后端模式参数页

• 概要
  • pedit 页代码 c.s.l
  • pedit 页代码 c.s.l 字节修改器列表
• 描述：pedit 将报告给定页面的模式参数的 SCSI 页 - 给定 SCSI 后端设备 c.s.l 上的 page_code，或者允许您更改模式参数。在其第一种形式中，pedit 对于给定的页代码，将打印五行。第一行是便于阅读的标题，第二行将是 DEFAULT 模式参数，第二行将是 CHANGEABLE 位掩码值，第三行将是 CURRENT 模式参数，最后一行将是 SAVED 模式参数。在其第二种形式中，pedit 对于给定的页代码和设备，将打印页代码，但也会将 byte_modifier_list 应用于 CURRENT 或 SAVED 模式参数。支持的 SCSI 页是
  
  0x1 错误恢复页
  
  0x2 断开连接页
  
  0x3 格式化页
  
  0x4 几何结构页
  
  0x8 缓存页
  
  0xc NOTCH 页
  
  0xa CONTROL 页
  
  
• 选项
  • page_code: 以十六进制指定 SCSI 页代码。
  • c.s.l: 通过指定其通道、SCSI ID（rank）和 SCSI LUN 来标识要选择的磁盘设备，格式为“c.s.l”
  • byte_modifier_list: byte_modifier_list 的形式为
    
    C|Sbyte_no:set_val: clr_val,byte_no:set_val:clr_val,...
    
    其中 C 或 S 前缀指定您要分别更改 CURRENT 还是 SAVED 模式页。此前缀后跟一个以逗号分隔的字节修改器列表，格式为 byte_no:set_val:clr_val，其中 byte_no 是要更改的字节号，set_val 是该字节中要 SET（设置为 1）的位的掩码，clr_val 是该字节中要 CLEAR（设置为 0）的位的掩码。
  
  
• 另请参阅：RAID 中使用的磁盘的相关产品手册中的模式感应页参考。

3.9.57  PIPE - 双向进程间通信

• 概要
  • bind -k pipe 绑定点
  • cat bind_point
  • bind_point/data
  • bind_point/ctl
  • 绑定点/data1
  • 绑定点/ctl1
• 描述：pipe 文件系统将一级目录与 K9 命名空间中的绑定点关联。此设备分配两个流，这两个流在设备端连接。绑定点/data 和 绑定点/ctl 是一个流的数据和控制通道，而 绑定点/data1 和 绑定点/ctl1 是另一个流的数据和控制通道。写入一个通道的数据可供在另一个通道读取。写入边界被保留：每次读取在读取缓冲区已满或读取完写入的最后一个字节后终止，以先到者为准。

3.9.58  PRANKS - 打印或设置当前控制器的可访问后端 rank

• 概要
  • pranks
  • pranks rank1 [rank2 ... rankn]
• 描述：pranks，不带任何参数，将打印执行命令的控制器可以访问的设备的后端 rank。如果某个 rank 不可访问，则会打印“-1”来代替 rank 号（即该 rank 的 scsi id）。如果您希望设置控制器允许访问的 rank id，请使用这些 rank id 作为参数执行此命令。
  
  当您执行此命令来设置对某些（或所有）rank 的访问时，访问限制（如果有）将立即生效。此外，GLOBAL 环境变量 BackendRanks 要么被定义，要么被修改，并且当您下次启动 RaidRunner 时，您刚刚创建的设置将再次自动设置。
  
  
• 示例：假设您有一个 RaidRunner 系统，其中包含四个 rank 的后端设备（rank 1、2、3 和 4），但您想将控制器的访问权限限制为前两个，因为您在第三和第四个 rank 中没有安装任何设备。您将执行 pranks 1 2
• 另请参阅：environ, sranks

3.9.59  PRINTENV - 打印一个或所有 GLOBAL 环境变量

• 概要
  • printenv
  • printenv 名称 [名称 ...]
• 描述：printenv 打印与 GLOBAL 环境变量名称关联的值（或值列表）。如果给出了多个 GLOBAL 环境变量，则每个值都单独打印在一行上。当 GLOBAL 环境变量是值列表时，每个值都单独打印在一行上。当调用 printenv 时不带任何参数，则会打印所有 GLOBAL 环境变量及其关联的值，每行一个。如果某个值是列表，则列表的每个元素都用竖线 (|) 字符分隔。
• 注意：GLOBAL 环境变量是存储在 RaidRunner 上的非易失性区域中的变量，因此在连续的电源周期或重新启动之间可用。这些变量与 husky 环境变量不同。非易失性区域与 RaidRunner 配置区域位于同一位置。如果给定的变量名称不是 GLOBAL 环境变量，则不打印任何内容，也不设置任何错误状态。
• 另请参阅：setenv, unsetenv, rconf
• PROC - 进程文件系统（设备）
• 概要
  • bind -k proc 绑定点
  • cat bind_point
  • cat 绑定点/0
  • cat 绑定点/1
  • ...
  • cat 绑定点/N
  • signal
  • sigpgrp
  • status
• 描述：proc 设备在其绑定点下方创建一个二级目录。第一级条目是当前 K9 已知的进程编号。第二级条目是文件名：“signal”、“sigpgrp”和“status”。读取二级目录文件“signal”和“sigpgrp”是错误的。读取“status”时，它返回一个 ASCII 字符串，其中包含以下字段
  • 进程名称
  • 进程标识符（即其 pid）
  • 此进程的父进程的 pid
  • 进程组领导者的 pid
  • 进程状态
  • 进程优先级
  • 最大堆栈利用率，以可用堆栈的百分比表示
  • 注册的 CPU 时间（毫秒）
  • 此进程正在等待的信号量 id（如果有）
  这些字段之间有适当数量的空格，因此当 ps 输出时，它们看起来“合理”。进程状态如下所示
  • I 中断
  • R 当前正在运行（或已让出控制权）
  • S stirred (等待时发出信号)
  • W 等待信号量
  • Z 已终止且父进程未等待
  写入二级目录文件“status”是错误的。信号编号或信号名称（有关信号名称列表，请参阅 kill - 在这种情况下不能缩写）可以写入文件“signal”。此操作将向关联的进程发送信号。如果将信号编号或名称写入文件“sigpgrp”，则此进程所属进程组中的所有进程都将收到信号。
  
  
• 另请参阅：ps, kill

3.9.60  PS - 报告进程状态

• 概要：ps
• 描述：ps 将有关所有正在运行的 K9 进程的信息打印到标准输出。输出的信息包括进程名称、其进程标识号 (PID)、其父进程的 PID、进程组、进程状态、其堆栈的最大百分比利用率以及它已使用的 CPU 时间（毫秒）。进程状态如下所示
  • I 中断
  • R 当前正在运行（或已让出控制权）
  • S stirred (等待时发出信号)
  • W 等待信号量
  • Z 已终止且父进程未等待
• 目前，ps 是作为 K9 Husky 脚本（而不是内置命令）实现的。脚本源代码可以在文件“/bin/ps”中找到。该脚本利用了文件系统 proc。
• 示例

• 字段包括：进程名称、进程标识符（即其 pid）、此进程的父进程 pid、进程组领导者的 pid、进程状态、进程优先级、最大堆栈利用率（占可用堆栈的百分比）、注册的 CPU 时间（毫秒）、此进程正在等待的信号量 ID（如果有）以及信号量的内部名称。如果进程正在等待信号量，则最后一个数字是其正在等待的数字的地址。
• 另请参阅：proc

3.9.61  PSCSIRES - 打印所有或特定监控器（moniker）的 SCSI-2 预留表

• 概要
  • pscsires
  • pscsires moniker
• 描述：pscsires 查找给定监控器（moniker）（参见 smon 或 stargd）的全局 SCSI-2 预留表，并打印其当前的 SCSI-2 预留状态。如果没有给出监控器（moniker），则打印全局 SCSI-2 预留表中的所有条目。对于要显示的每个表条目，将打印监控器（moniker）和四个整数 - 控制器编号、主机端口号、预留的 scsi id 和预留器的 scsi id。控制器编号、主机端口号和预留器的 scsi id 的组合可以唯一地标识哪个主机系统发出了 SCSI-2 Reserve 命令。当主机系统（由其他三个整数标识）请求第三方预留时，将使用预留的 scsi id 字段。如果所有四个整数均为 -1，则任何控制器或主机端口上的 scsi 目标守护进程（smon 或 stargd）都未预留该监控器（moniker）。
• 另请参阅：smon、stargd、mstargd、SCSI-2 Reserve 和 Release 命令文档

3.9.62  PSTATUS - 打印硬件状态寄存器的值

• 概要：pstatus
• 描述：pstatus 将打印各种硬件状态寄存器的名称和值。每个值都单独在一行上打印。典型的硬件状态寄存器是 BCDSW_0、BCDSW_1。BCD 主机端口 SCSI ID 选择开关的值
  • FANS：风扇状态寄存器的值
  • AC_PWR：交流电源状态的值
  • DC_PWR：直流电源状态的值
• 注意：并非所有 RaidRunner 型号都支持相同的状态寄存器，因此请查阅您的 RaidRunner 型号的硬件参考手册，以查看支持哪些寄存器以及它们的含义。

3.9.63  RAIDACTION- 用于收集/重置统计信息或停止/启动 raid 集的 stargd 的脚本

• 概要：raidaction raidname up|down|getstats|getastats|zerostats
• 描述：raidaction 是一个 husky 脚本，用于启动或停止 raid 集的 scsi 目标守护进程 (stargd) 或收集/重置有关 raid 集的统计信息。
• 选项
  • raidset：指定要对其执行操作的 raid 集。
  • up：启动与此 raid 集关联的所有 scsi 目标守护进程。
  • down：停止与此 raid 集关联的所有 scsi 目标守护进程。
  • getstats：打印给定 raid 集的当前统计信息。输出的第一行以字符串“RAIDSET:”为前缀，并且是带有参数 -r raidname -g 的 stats 命令的输出。输出的第二行以字符串“CACHE:”为前缀，并且是带有参数 -c raidname -g 的 stats 命令的输出。下一行（或多行）以字符串“STARG: c.h.l”为前缀，并且是带有参数 -d 0 -v -h -H stargd_pid 的 mstargd 命令的输出，其中 stargd_pid 是控制器 c、主机端口 h 和 scsi lun l 上的 scsi 目标守护进程的进程 ID。 对于属于此 raid 集的每个 scsi 目标守护进程，都将打印此类行。
  • getastats：打印给定 raid 集的当前统计信息，然后将所有存储的统计信息归零。通过将存储的统计信息归零，可以通过重复定时调用此代码，形成基于收集的统计信息的平均值。输出与 getstats 选项相同。
  • zerostats：将给定 raid 集的所有存储统计信息归零。
• 另请参阅：stats、mstargd

3.9.64  RAID0 - raid 0 设备

• 概要
  
  bind -k {raid0 nbackends} bind_point
  
  echo moniker name=raid_set_name > bind_point/ctl
  
  echo engage drive=driveNum qlen=queueLen fd=aFdNum blksize=blockSize name=backendname
  
  <>[aFdNum] backEnd > bind_point/ctl
  
  echo disengage drive=driveNum > bind_point/ctl
  
  echo access drive=driveNum read-write > bind_point/ctl
  
  echo access drive=driveNum read-only > bind_point/ctl
  
  echo access drive=driveNum write-only > bind_point/ctl
  
  echo access drive=driveNum offline > bind_point/ctl
  
  cat bind_point
  
  ctl
  
  data
  
  repair
  
  stats
  
  
• 描述：raid0 实现了 raid 0 设备。它有 1 个“前端”（即 bind_point/data）和通常多个“后端”（即由每个带有新驱动器编号的“engage”消息定义）。要将内部名称（或监控器（moniker））与 raid 设备关联，请将消息“moniker name=internal_name”发送到设备的控制文件 bind_point/ctl。raid 0 的此实现使用其后端中的 nbackends 文件。前端（即 bind_point/data）的读取和写入操作必须是 blockSize 的整数倍。blockSize 字节的每次写入都写入 1 个后端文件。此处引用的后端“文件”通常是磁盘。“name”参数允许将给定的 backendname 字符串与适当的后端关联。此字符串将用于报告正在运行的 raid 上的错误。
  
  queueLen 参数必须为 1 或更大，并设置可以放入与每个后端文件关联的队列中的最大请求数。为每个后端文件生成一个守护进程来服务于此队列，称为 async_io。每个后端文件首先需要通过发送到 bind_point/ctl 的“engage”字符串来标识到 raid0 设备。如果需要，可以终止文件与此设备的关联，使用“disengage”字符串。一旦后端文件被“engage”，其访问级别可以在“read-write”、“read-only”、“write-only”和“offline”之间变化，根据需要。默认值为“offline”，因此在大多数初始化情况下，需要将“access read-write”字符串发送到此设备。当读取文件 bind_point/ctl 时，将为每个“engage”的后端文件输出一行，指示其访问状态（例如，“drive 3: engaged, read-write”）。此外，已“disengage”且未“重新”“engage”的后端文件会输出一行（例如，“drive 5: disengaged”）。
  
  当读取文件 bind_point/stats 时，将输出一行，显示 raid 设备的每个后端的已执行的累积读取和写入次数（包括失败次数）。此行的格式为 D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails; ... 这表明后端 0（通常是 drive0）已执行 r0_cnt 次读取，w0_cnt 次写入，r0_fails 次读取失败和 w0_fails 次写入失败，后端 1（drive 1）已执行 r1_cnt 次读取，w1_cnt 次写入，r1_fails 次读取失败和 w1_fails 次写入失败，依此类推，对于 raid 集中的每个后端。
  
  如果将字符串“zerostats”写入文件 bind_point/stats，则 raid 集的每个后端的累积读取和写入计数都将归零。
  
  
• 示例

  > /raid0
  
  bind -k {raid0 6} /raid0
  
  echo moniker name=R_0 > /raid0/ctl
  
  echo engage drive=0 qlen=8 fd=7 blksize=8192 name=D0
  
  <>[7] /d0/data > /raid0/ctl
  
  echo access drive=0 read-write > /raid0/ctl
  
  ...
  
  echo engage drive=5 qlen=8 fd=7 blksize=8192 name=D5
  
  <>[7] /d5/data > /raid0/ctl
  
  echo access drive=5 read-write > /raid0/ctl

  此示例创建文件“/raid0”作为绑定点，然后在上面绑定 raid0 设备。第一个 echo 命令将内部 raid 设备名称建立为 R_0。后续的 echo 命令成对显示，用于每个后端文件：一个发送“engage”字符串，另一个发送“access”字符串到文件“/raid0/ctl”。每个“engage”字符串将后端文件（通过文件描述符 7）与块大小 8192 字节和最大队列长度 8 相关联。以下“access”字符串将后端文件的访问级别从“offline”（默认值）调整为“read-write”。这是一个六盘 raid 集。
  
  
• 注释：生成的 raid 集的大小将是最小后端的大小乘以数据后端数量，向下调整以与 raid 集的块大小 (blockSize) 的倍数对齐。
• 另请参阅：raid1、raid3、raid4、raid5

3.9.65  RAID1 - raid 1 设备

• 概要
  
  bind -k raid1 bind_point
  
  echo moniker name=raid_set_name > bind_point/ctl
  
  echo engage drive=driveNum qlen=queueLen fd=aFdNum blksize=blockSize name=backendname
  
  <>[aFdNum] backEnd > bind_point/ctl
  
  echo disengage drive=driveNum > bind_point/ctl
  
  echo access drive=driveNum read-write > bind_point/ctl
  
  echo access drive=driveNum read-only > bind_point/ctl
  
  echo access drive=driveNum write-only > bind_point/ctl
  
  echo access drive=driveNum offline > bind_point/ctl
  
  cat bind_point
  
  ctl
  
  data
  
  repair
  
  stats
  
  
• 描述：raid1 实现了 raid 1 设备。Raid 1 也称为“镜像”。它有 1 个“前端”（即 bind_point/data）和 2 个“后端”（即由每个带有新驱动器编号的“engage”消息定义）。要将内部名称（或监控器（moniker））与 raid 设备关联，请将消息“moniker name=internal_name”发送到设备的控制文件 bind_point/ctl。前端（即 bind_point/data）的读取和写入操作必须是 blockSize 的整数倍。blockSize 字节的每次写入都写入两个后端文件。blockSize 字节的读取只需要读取 1 个后端文件（除非出现问题）。选择用于读取的后端文件是计算得出其磁头更靠近所需块的文件。此处引用的后端“文件”通常是磁盘。
  
  “逻辑”块大小当前为 512 字节，给定的 blockSize 必须是 512 的 2 的幂倍（即 2**n * 512 字节）。例如，如果 blockSize 为 8 Kb，则 8 Kb 的写入将导致两个后端文件都写入 8 Kb。8 Kb 的读取将导致计算得出其“磁头”更靠近的文件被读取。如果此文件被标记为“offline”、“write-only”或报告 IO 错误，则将读取另一个文件。
  
  queueLen 参数必须为 1 或更大，并设置可以放入与每个后端文件关联的队列中的最大请求数。为每个后端文件生成一个守护进程来服务于此队列，称为 async_io。“name”参数允许将给定的 backendname 字符串与适当的后端关联。此字符串将用于报告正在运行的 raid 上的错误。
  
  每个后端文件首先需要通过发送到 bind_point/ctl 的“engage”字符串来标识到 raid1 设备。如果需要，可以终止文件与此设备的关联，使用“disengage”字符串。一旦后端文件被“engage”，其访问级别可以在“read-write”、“read-only”、“write-only”和“offline”之间变化，根据需要。默认值为“offline”，因此在大多数初始化情况下，需要将“access read-write”字符串发送到此设备。
  
  当读取文件 bind_point/ctl 时，将为每个“engage”的后端文件输出一行，指示其访问状态（例如，“drive 3: engaged, read-write”）。此外，已“disengage”且未“重新”“engage”的后端文件会输出一行（例如，“drive 5: disengaged”）。
  
  当读取文件 bind_point/stats 时，将输出一行，显示 raid 设备的每个后端的已执行的累积读取和写入次数（包括失败次数）。此行的格式为
  
  D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails;
  
  这表明后端 0（通常是 drive0）已执行 r0_cnt 次读取，w0_cnt 次写入，r0_fails 次读取失败和 w0_fails 次写入失败，后端 1（drive 1）已执行 r1_cnt 次读取，w1_cnt 次写入，r1_fails 次读取失败和 w1_fails 次写入失败。
  
  如果将字符串“zerostats”写入文件 bind_point/stats，则 raid 集的每个后端的累积读取和写入计数都将归零。
  
  
• 示例

  > /raid1
  
  bind -k raid1 /raid1
  
  echo moniker name=R_1 > /raid1/ctl
  
  echo engage drive=0 qlen=8 fd=7 blksize=8192 name=D1
  
  <>[7] /d0/data > /raid1/ctl
  
  echo access drive=0 read-write > /raid1/ctl
  
  echo engage drive=1 qlen=8 fd=7 blksize=8192 name=D5
  
  <>[7] /d5/data > /raid1/ctl
  
  echo access drive=1 read-write > /raid1/ctl

  此示例创建文件“/raid1”作为绑定点，然后在上面绑定 raid1 设备。第一个 echo 命令
  
  将内部 raid 设备名称建立为 R_1。后续的 echo 命令成对显示，用于两个后端文件：一个发送“engage”字符串，另一个发送“access”字符串到文件“/raid1/ctl”。每个“engage”字符串将后端文件（通过文件描述符 7）与块大小 8192 字节和最大队列长度 8 相关联。以下“access”字符串将后端文件的访问级别从“offline”（默认值）调整为“read-write”。
  
  
• 注释：生成的 raid 集的大小将是最小后端的大小乘以数据后端数量（此处仅为 1，因为我们是镜像），向下调整以与 raid 集的块大小 (blockSize) 的倍数对齐。
• 另请参阅：raid0、raid3、raid4、raid5

3.9.66  RAID3 - raid 3 设备

• 概要
  
  bind -k {raid3 nbackends} bind_point
  
  echo moniker name=raid_set_name > bind_point/ctl
  
  echo engage drive=driveNum qlen=queueLen fd=aFdNum blksize=blockSize name=backendname
  
  <>[aFdNum] backEnd > bind_point/ctl
  
  echo disengage drive=driveNum > bind_point/ctl
  
  echo access drive=driveNum read-write > bind_point/ctl
  
  echo access drive=driveNum read-only > bind_point/ctl
  
  echo access drive=driveNum write-only > bind_point/ctl
  
  echo access drive=driveNum offline > bind_point/ctl
  
  cat bind_point
  
  ctl
  
  data
  
  repair
  
  stats
  
  
• 描述：raid3 实现了 raid 3 设备。它有 1 个“前端”（即 bind_point/data）和通常多个“后端”（即由每个带有新驱动器编号的“engage”消息定义）。
  
  要将内部名称（或监控器（moniker））与 raid 设备关联，请将消息“moniker name=internal_name”发送到设备的控制文件 bind_point/ctl。
  
  raid 3 的此实现至少在其后端中使用 3 个文件。前端（即 bind_point/data）的读取和写入操作必须是 blockSize 的整数倍。blockSize 字节的每次写入都条带化（即均匀分割）在 (nbackends - 1) 个文件上，而“奇偶校验”在另一个文件上。后续写入将不会轮换用于存储奇偶校验的文件。[此轮换是对原始 raid 3 定义的略微扩展。] 此处引用的后端“文件”通常是磁盘。
  
  “逻辑”块大小当前为 512 字节，给定的 blockSize 必须是 (nbackends - 1) * 512 的整数倍。例如，如果 blockSize 为 8 Kb 并且有 5 个后端，则 8 Kb 的写入将导致 4 个后端文件写入 2 Kb，而另一个后端文件写入 2 Kb 的奇偶校验。8 Kb 的读取将导致读取已知保存数据的 4 个文件（与奇偶校验不同）。如果这些文件中的任何一个被标记为“offline”、“write-only”或报告 IO 错误，则将读取包含奇偶校验的第 5 个文件并重建 8 Kb 块。
  
  queueLen 参数必须为 1 或更大，并设置可以放入与每个后端文件关联的队列中的最大请求数。为每个后端文件生成一个守护进程来服务于此队列，称为 async_io。
  
  “name”参数允许将给定的 backendname 字符串与适当的后端关联。此字符串将用于报告正在运行的 raid 上的错误。
  
  每个后端文件首先需要通过发送到 bind_point/ctl 的“engage”字符串来标识到 raid3 设备。如果需要，可以终止文件与此设备的关联，使用“disengage”字符串。一旦后端文件被“engage”，其访问级别可以在“read-write”、“read-only”、“write-only”和“offline”之间变化，根据需要。默认值为“offline”，因此在大多数初始化情况下，需要将“access read-write”字符串发送到此设备。当读取文件 bind_point/ctl 时，将为每个“engage”的后端文件输出一行，指示其访问状态（例如，“drive 3: engaged, read-write”）。此外，已“disengage”且未“重新”“engage”的后端文件会输出一行（例如，“drive 5: disengaged”）。
  
  当读取文件 bind_point/stats 时，将输出一行，显示 raid 设备的每个后端的已执行的累积读取和写入次数（包括失败次数）。此行的格式为
  
  D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails; ...
  
  这表明后端 0（通常是 drive0）已执行 r0_cnt 次读取，w0_cnt 次写入，r0_fails 次读取失败和 w0_fails 次写入失败，后端 1（drive 1）已执行 r1_cnt 次读取，w1_cnt 次写入，r1_fails 次读取失败和 w1_fails 次写入失败，依此类推，对于 raid 集中的每个后端。
  
  如果将字符串“zerostats”写入文件 bind_point/stats，则 raid 集的每个后端的累积读取和写入计数都将归零。
  
  
• 示例

  > /raid3
  
  bind -k {raid3 5} /raid3
  
  echo moniker name=R_3 > /raid3/ctl
  
  echo engage drive=0 qlen=8 fd=7 blksize=8192 name=D0
  
  <>[7] /d0/data > /raid3/ctl
  
  echo access drive=0 read-write > /raid3/ctl
  
  ...
  
  echo engage drive=5 qlen=8 fd=7 blksize=8192 name=D5
  
  <>[7] /d5/data > /raid3/ctl
  
  echo access drive=5 read-write > /raid3/ctl

  此示例创建文件“/raid3”作为绑定点，然后在上面绑定 raid3 设备。第一个 echo 命令将内部 raid 设备名称建立为 R_3。后续的 echo 命令成对显示，用于每个后端文件：一个发送“engage”字符串，另一个发送“access”字符串到文件“/raid3/ctl”。每个“engage”字符串将后端文件（通过文件描述符 7）与块大小 8192 字节和最大队列长度 8 相关联。以下“access”字符串将后端文件的访问级别从“offline”（默认值）调整为“read-write”。这是一个 6 盘 raid 集。
  
  
• 注释：生成的 raid 集的大小将是最小后端的大小乘以数据后端数量，向下调整以与 raid 集的块大小 (blockSize) 的倍数对齐。
• 另请参阅：raid0、raid1、raid4、raid5

3.9.67  RAID4 - raid 4 设备

• 概要
  
  bind -k {raid4 nbackends} bind_point
  
  echo moniker name=raid_set_name > bind_point/ctl
  
  echo engage drive=driveNum qlen=queueLen fd=aFdNum blksize=blockSize name=backendname
  
  <>[aFdNum] backEnd > bind_point/ctl
  
  echo disengage drive=driveNum > bind_point/ctl
  
  echo access drive=driveNum read-write > bind_point/ctl
  
  echo access drive=driveNum read-only > bind_point/ctl
  
  echo access drive=driveNum write-only > bind_point/ctl
  
  echo access drive=driveNum offline > bind_point/ctl
  
  cat bind_point
  
  ctl
  
  data
  
  repair
  
  stats
  
  
• 描述：raid4 实现了 raid 4 设备。它有 1 个“前端”（即 bind_point/data）和通常多个“后端”（即由每个带有新驱动器编号的“engage”消息定义）。要将内部名称（或监控器（moniker））与 raid 设备关联，请将消息“moniker name=internal_name”发送到设备的控制文件 bind_point/ctl。raid 4 的此实现至少在其后端中使用 3 个文件。前端（即 bind_point/data）的读取和写入操作必须是 blockSize 的整数倍。blockSize 字节的每次写入都写入 1 个后端文件。其相邻的 (nbackends - 2) 个文件需要在同一偏移量处读取，以计算需要重新写入的新奇偶校验块。nbackends 个后端文件上同一偏移量处的 nbackends 个块称为切片。与 raid3 类似，奇偶校验块固定为最后一个后端。blockSize 字节的读取只需要读取 1 个后端文件（除非出现问题）。此处引用的后端“文件”通常是磁盘。
  
  “逻辑”块大小当前为 512 字节，给定的 blockSize 必须是 (nbackends - 1) * 512 的整数倍。例如，如果 blockSize 为 8 Kb，则 8 Kb 的写入将导致 1 个后端文件写入 8 Kb，而该切片中的其他 (nbackends - 2) 个非奇偶校验文件需要从中读取 8 Kb，以便生成新的 8 Kb 奇偶校验块，然后将其写入此切片中的奇偶校验文件。8 Kb 的读取将导致读取已知保存数据的文件（与奇偶校验不同）。如果此文件被标记为“offline”、“write-only”或报告 IO 错误，则将读取切片中的其他 ((nbackends - 1) 个文件（即 (nbackends - 2) 个数据文件和 1 个奇偶校验文件），并重建 8 Kb 块。
  
  queueLen 参数必须为 1 或更大，并设置可以放入与每个后端文件关联的队列中的最大请求数。为每个后端文件生成一个守护进程来服务于此队列，称为 async_io。
  
  “name”参数允许将给定的 backendname 字符串与适当的后端关联。此字符串将用于报告正在运行的 raid 上的错误。
  
  每个后端文件首先需要通过发送到 bind_point/ctl 的“engage”字符串来标识到 raid5 设备。如果需要，可以终止文件与此设备的关联，使用“disengage”字符串。一旦后端文件被“engage”，其访问级别可以在“read-write”、“read-only”、“write-only”和“offline”之间变化，根据需要。默认值为“offline”，因此在大多数初始化情况下，需要将“access read-write”字符串发送到此设备。
  
  当读取文件 bind_point/ctl 时，将为每个“engage”的后端文件输出一行，指示其访问状态（例如，“drive 3: engaged, read-write”）。此外，已“disengage”且未“重新”“engage”的后端文件会输出一行（例如，“drive 5: disengaged”）。
  
  当读取文件 bind_point/stats 时，将输出一行，显示 raid 设备的每个后端的已执行的累积读取和写入次数（包括失败次数）。此行的格式为
  
  D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails; ...
  
  这表明后端 0（通常是 drive0）已执行 r0_cnt 次读取，w0_cnt 次写入，r0_fails 次读取失败和 w0_fails 次写入失败，后端 1（drive 1）已执行 r1_cnt 次读取，w1_cnt 次写入，r1_fails 次读取失败和 w1_fails 次写入失败，依此类推，对于 raid 集中的每个后端。
  
  如果将字符串“zerostats”写入文件 bind_point/stats，则 raid 集的每个后端的累积读取和写入计数都将归零。
  
  
• 示例

  > /raid4
  
  bind -k {raid4 5} /raid4
  
  echo moniker name=R_4 > /raid4/ctl
  
  echo engage drive=0 qlen=8 fd=7 blksize=8192 name=D0
  
  <>[7] /d0/data > /raid4/ctl
  
  echo access drive=0 read-write > /raid4/ctl
  
  ...
  
  echo engage drive=5 qlen=8 fd=7 blksize=8192 name=D5
  
  <>[7] /d5/data > /raid4/ctl
  
  echo access drive=5 read-write > /raid4/ctl

  此示例创建文件“/raid4”作为绑定点，然后在上面绑定 raid4 设备。第一个 echo 命令将内部 raid 设备名称建立为 R_4。后续的 echo 命令成对显示，用于每个后端文件：一个发送“engage”字符串，另一个发送“access”字符串到文件“/raid4/ctl”。每个“engage”字符串将后端文件（通过文件描述符 7）与块大小 8192 字节和最大队列长度 8 相关联。以下“access”字符串将后端文件的访问级别从“offline”（默认值）调整为“read-write”。这是一个六盘 raid 集。
  
  
• 注释：生成的 raid 集的大小将是最小后端的大小乘以数据后端数量，向下调整以与 raid 集的块大小 (blockSize) 的倍数对齐。
• 另请参阅：raid0、raid1、raid3、raid5

3.9.68  RAID5 - raid 5 设备

• 概要
  
  bind -k {raid5 nbackends} bind_point
  
  echo moniker name=raid_set_name > bind_point/ctl
  
  echo engage drive=driveNum qlen=queueLen fd=aFdNum blksize=blockSize name=backendname
  
  <>[aFdNum] backEnd > bind_point/ctl
  
  echo disengage drive=driveNum > bind_point/ctl
  
  echo access drive=driveNum read-write > bind_point/ctl
  
  echo access drive=driveNum read-only > bind_point/ctl
  
  echo access drive=driveNum write-only > bind_point/ctl
  
  echo access drive=driveNum offline > bind_point/ctl
  
  cat bind_point
  
  ctl
  
  data
  
  repair
  
  stats
  
  
• 描述：raid5 实现了 raid 5 设备。它有 1 个“前端”（即 bind_point/data）和通常多个“后端”（即由每个带有新驱动器编号的“engage”消息定义）。
  
  要将内部名称（或监控器（moniker））与 raid 设备关联，请将消息“moniker name=internal_name”发送到设备的控制文件 bind_point/ctl。
  
  raid 5 的此实现至少在其后端中使用 3 个文件。前端（即 bind_point/data）的读取和写入操作必须是 blockSize 的整数倍。blockSize 字节的每次写入都写入 1 个后端文件。其相邻的 (nbackends - 2) 个文件需要在同一偏移量处读取，以计算需要重新写入的新奇偶校验块。nbackends 个后端文件上同一偏移量处的 nbackends 个块称为切片。奇偶校验块在切片之间轮换。blockSize 字节的读取只需要读取 1 个后端文件（除非出现问题）。此处引用的后端“文件”通常是磁盘。
  
  “逻辑”块大小当前为 512 字节，给定的 blockSize 必须是 (nbackends - 1) * 512 的整数倍。例如，如果 blockSize 为 8 Kb，则 8 Kb 的写入将导致 1 个后端文件写入 8 Kb，而该切片中的其他 (nbackends - 2) 个非奇偶校验文件需要从中读取 8 Kb，以便生成新的 8 Kb 奇偶校验块，然后将其写入此切片中的奇偶校验文件。8 Kb 的读取将导致读取已知保存数据的文件（与奇偶校验不同）。如果此文件被标记为“offline”、“write-only”或报告 IO 错误，则将读取切片中的其他 ((nbackends - 1) 个文件（即 (nbackends - 2) 个数据文件和 1 个奇偶校验文件），并重建 8 Kb 块。
  
  queueLen 参数必须为 1 或更大，并设置可以放入与每个后端文件关联的队列中的最大请求数。为每个后端文件生成一个守护进程来服务于此队列，称为 async_io。
  
  “name”参数允许将给定的 backendname 字符串与适当的后端关联。此字符串将用于报告正在运行的 raid 上的错误。
  
  每个后端文件首先需要通过发送到 bind_point/ctl 的“engage”字符串来标识到 raid5 设备。如果需要，可以终止文件与此设备的关联，使用“disengage”字符串。一旦后端文件被“engage”，其访问级别可以在“read-write”、“read- only”、“write-only”和“offline”之间变化，根据需要。默认值为“offline”，因此在大多数初始化情况下，需要将“access read-write”字符串发送到此设备。
  
  当读取文件 bind_point/ctl 时，将为每个“engage”的后端文件输出一行，指示其访问状态（例如，“drive 3: engaged, read-write”）。此外，已“disengage”且未“重新”“engage”的后端文件会输出一行（例如，“drive 5: disengaged”）。
  
  当读取文件 bind_point/stats 时，将输出一行，显示 raid 设备的每个后端的已执行的累积读取和写入次数（包括失败次数）。此行的格式为
  
  D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails; ...
  
  这表明后端 0（通常是 drive0）已执行 r0_cnt 次读取，w0_cnt 次写入，r0_fails 次读取失败和 w0_fails 次写入失败，后端 1（drive 1）已执行 r1_cnt 次读取，w1_cnt 次写入，r1_fails 次读取失败和 w1_fails 次写入失败，依此类推，对于 raid 集中的每个后端。
  
  如果将字符串“zerostats”写入文件 bind_point/stats，则 raid 集的每个后端的累积读取和写入计数都将归零。
  
  
• 示例

  > /raid5
  
  bind -k {raid5 5} /raid5
  
  echo moniker name=R_5 > /raid5/ctl
  
  echo engage drive=0 qlen=8 fd=7 blksize=8192 name=D0
  
  <>[7] /d0/data > /raid5/ctl
  
  echo access drive=0 read-write > /raid5/ctl
  
  ...
  
  echo engage drive=5 qlen=8 fd=7 blksize=8192 name=D1
  
  <>[7] /d5/data > /raid5/ctl
  
  echo access drive=5 read-write > /raid5/ctl

  此示例创建文件“/raid5”作为绑定点，然后在上面绑定 raid5 设备。第一个 echo 命令将内部 raid 设备名称建立为 R_5。后续的 echo 命令成对显示，用于每个后端文件：一个发送“engage”字符串，另一个发送“access”字符串到文件“/raid5/ctl”。每个“engage”字符串将后端文件（通过文件描述符 7）与块大小 8192 字节和最大队列长度 8 相关联。以下“access”字符串将后端文件的访问级别从“offline”（默认值）调整为“read-write”。这是一个六盘 raid 集。
  
  
• 注释：生成的 raid 集的大小将是最小后端的大小乘以数据后端数量，向下调整以与 raid 集的块大小 (blockSize) 的倍数对齐。
• 另请参阅：raid0、raid1、raid3、raid4

3.9.69  RAM - 基于 ram 的文件系统

• 概要：bind -k ram bind_point
• 描述：ram 文件系统使用目标系统堆上的内存来支持分层文件系统。通常，ram 是 husky 环境中的根文件系统。与普通文件系统不同，ram 缺乏持久性。因此（假设堆驻留在_非_电池备份 RAM 中），当目标系统断电时，ram 文件系统的内容将丢失。这类似于 Unix 中“/tmp”文件系统的工作方式。
• 另请参阅：mem

3.9.70  RANDIO - 模拟随机读取和写入

• 概要：randio -d device -n nop [-b cnt] [-f fill_ch] [-i init_ch] [-o offset] [-s size] [-G grp_size] [-S seed] [-X xfer_size] [-M rdwr|rdonly] [-T seq|ran] [-vBDON]
• 描述：randio 定义设备上的一个范围，从设备开始到结束，或者如果指定了大小（以 512 字节块为单位），则在此范围内执行操作。nop 随机写入然后读取操作。所有读取和写入都是 512 字节块的倍数。首先，给定范围内的每个块都使用特定模式初始化。然后，对于每个操作，选择范围中的随机位置，并使用特定的数据模式写入随机数量的块。一旦发生 nop 次写入操作，就会在适当的位置和长度执行 nop 次读取，以验证先前写入的数据。最后，验证设备上的所有数据。也就是说，任何未写入的块都应仅具有初始化模式，并且任何已写入的块都应具有适当的数据模式。当发生给定长度的写入时，写入中的每个 512 字节块都有一个标头，其中包含操作编号、写入位置的开始、写入长度和数据填充模式。每个 512 字节块的其余部分都使用填充模式初始化。此命令的输出提供 I/O 传输速率，单位为兆字节 (MB) 和百万字节 (Mb)，用于 I/O 的三个阶段，即顺序写入、随机写入然后读取，最后是顺序读取。大小和偏移值可能带有后缀。
• 选项
  • -b cnt：将所有读取和写入操作限制为 cnt x 512 块的倍数。默认值为 1。
  • -f fill_ch：写入中使用的数据填充模式应为 fill_ch。fill_ch 必须指定为十六进制数。默认值为 0x7F。
  • -i init_ch：初始化设备时使用的填充模式应为 init_ch。fill_ch 必须指定为十六进制数。默认值为 0x00。
  • -o offset：所有读取和写入都将在设备中偏移 512 字节块的位置执行。所有报告的值都将相对于此偏移量。默认值为 0，即设备开始处。
  • -s size：范围的大小（以 512 字节块为单位），我们在此范围内执行 io。
  • -v：在详细模式下运行，打印初始化信息以及设备上整个指定范围的最终验证。如果给出第二个 -v，则会打印各个读取和写入操作的详细信息。
  • -B：将所有随机写入位置对齐为 cnt x 512 的倍数。其中 cnt 由 -b 选项指定。这在写入原始 raid 设备时非常有用，这些设备既需要固定的写入大小倍数，又需要对齐的“写入开始”地址。
  • -G grp_siz：通常，randio 执行 nop 次写入，然后执行 nop 次读取。-G 选项可以将此更改为执行 grp_siz 次写入，然后执行 grp_siz 次读取，循环直到发生 nop 次操作。nop 操作的默认“组大小”。如果 grp_siz 为负数，则会选择随机组大小。
  • -M rdwr|rdonly：默认情况下，执行破坏性读写测试 (-M rdwr)。要以非破坏性方式运行 randio，请使用 rdonly 子选项指定此选项。这将导致 randio 仅执行读取。
  • -N：默认情况下，始终将读取的数据与写入的数据进行比较。通过指定此选项，将不进行比较。当您只关心执行随机读取和写入，而不关心数据是否损坏时，此选项非常有用。
  • -O：默认情况下，随机写入位置和大小的选择使其重叠。通过指定此选项，不会发生重叠写入。如果您的设备很小，请谨慎使用此选项。
  • -S seed：为随机数生成器指定种子。
  • -T ran|seq：默认情况下，randio 执行一系列顺序写入、随机写入然后读取，最后是顺序读取。要仅执行顺序活动，请使用 -T seq 选项。默认值为 -T ran。
  • -X xfer_size：将最大写入大小限制为 xfer_size 512 字节块。默认值为 256 个块 - 128K 字节。
• 另请参阅：speedtst、suffix

3.9.71  RCONF、SPOOL、HCONF、MCONF、CORRUPT-CONFIG - raid 配置和备件管理

• 概要
  • rconf -add -type raidtype -name raidname -size raidsize -iomode read-write|read-only|write-only -iosize raid- chunksize -hostif mflag controller host_port scsi_lun -backendsize backends_size -backends backend1,backend2,...,backendn [-boot auto|manual] [-cache raidcachesize] [-state active|inactive] [-usespares on|off] [-usezoneio on|off] [-qlen nqueues] [-stargs {xstargd_args}] [-hostif mflag controller host_port scsi_lun]
  • rconf -delete raidname
  • rconf -list [raidname] [-v]
  • rconf [-v]
  • rconf -mkfaulty -name raidname -drive drive_no
  • rconf -modify -name raidname [-iomode read-write|read-only|write-only] [-newname newraidname] [-hostif mflag controller host_port scsi_lun] [-boot auto|manual] [-cache raidcachesize] [-state active|inactive] [-usespares on|off] [-usezoneio on|off] [-qlen nqueues] [-stargs {xstargd_args}]
  • rconf -rebuild -name raidname -drive drive_no [-spare spare_backend]
  • rconf -repair -name raidname -drive drive_no -action start|finish [-depth value]
  • rconf -replace -name raidname -backend backendn -action start|finish [-depth value]
  • rconf -unrepair -name raidname -backend backendn -drive drive_no -depth value
  • rconf -init
  • rconf -fullinit
  • rconf -check
  • rconf -maxiochunk
  • rconf -validate
  • rconf -syslog
  • rconf -size
  • spool -add -name backend -backendsize backends_size -type hot|warm [-ctlr controller_number]
  • spool -delete -name backend
  • spool -list
  • spool
  • hconf -delete controller hostport
  • hconf -list [controller hostport]
  • hconf
  • hconf -modify controller hostport scsi_id
  • mconf -add controller hostport scsi_lun [blkprotocol]
  • mconf -delete controller hostport scsi_lun
  • mconf -sml
  • mconf -smldelete controller hostport
  • mconf -list [controller]
  • mconf [-C] [-c] corrupt-config
• 描述：rconf、hconf、mconf 和 spool 操作 raid 集定义、主机端口连接和 RaidRunner 上的备件池。所有信息都存储在 RaidRunner 配置区域中，该区域存储在文件 /dev/flash/conf 中，并在 RaidRunner 上的每个磁盘 (/dev/hd/.../rconfig) 上复制。corrupt-config 命令将损坏配置区域并立即重新启动 RaidRunner。
  • Raid 集：Raid 集具有以下属性
    • 类型：Raid 类型 - 0（条带化后端）、1（镜像后端）、3（具有一个后端上的奇偶校验的条带化后端）、5（奇偶校验分布在所有后端上的条带化后端）。
    • 名称：Raid 集的唯一名称，用于使标识和访问更容易。Raid 集的名称必须以字母字符开头，然后在其他地方使用字母数字字符。名称的最大长度为 32 个字符。
    • IOmode: Raid 阵列的访问模式。访问模式可以是读写、只读或只写。
    • Size: Raid 阵列的大小（以 512 字节块为单位），如果其小于计算出的大小。通常，Raid 阵列的大小是其后端大小的函数（即类型 0 - 后端总和，类型 1 - 单个后端的大小，类型 3/5 - 后端总和减一）。Size 必须是 IOsize 的倍数。
    • IOsize: Raid 阵列读写操作的 IO 大小（以字节为单位）。这通常被称为块大小 (chunksize)。
    • Cachesize: 将作为 Raid 阵列前端缓存的缓存大小（以字节为单位）。缓存大小必须至少为 256K 字节（四分之一兆字节）。缓存大小也必须是 Raid 阵列 IOsize 的倍数。
    • Host Interface(s): 用于主机访问的接口。Raid 阵列可以是单端口或多端口的。也就是说，一个 Raid 阵列可以呈现所有指向自身的不同的 scsi 磁盘。当然，访问这些磁盘的主机必须协同工作以确保数据完整性。每个主机接口是一个四元组 - 主/从访问标志、控制器编号、该控制器上的主机端口以及 Raid 阵列应在该主机端口上传播的 SCSI LUN。主/从访问标志在启动时用于将主机接口的 SCSI 目标守护程序配置为完全访问（因此已启动）主 SCSI 目标或最小访问（因此已关闭）从 SCSI 目标。有关 mstargd 命令的 -Z 选项的详细信息，请参阅相关文档。这种主/从概念可供协作主机使用，以通过多个 SCSI 目标守护程序共享对单个 Raid 阵列的访问。Raid 阵列只能在控制器内进行多端口操作。
    • Backends: Raid 阵列后端的列表。后端可以是磁盘或其他 Raid 阵列。
    • Backendsize: Raid 阵列后端的大小（以 512 字节块为单位）
    • Bootmode: Raid 阵列的启动模式。它可以是自动启动 (autoboot) 或手动 (manual)。对于前者，当 RaidRunner 启动时，Raid 阵列会自动在指定的主机接口上可用；对于后者，则必须手动使其可用。
    • State : 这是 Raid 阵列的状态。Raid 阵列的状态可以是活动 (active) 或非活动 (inactive)。如果为活动状态，则 Raid 阵列的数据可供访问。如果为非活动状态，则 Raid 阵列上的数据不可用，因此 Raid 阵列处于静止状态。
    • ZoneioUsage: 这是一个标志，指示缓存文件系统对该 Raid 阵列的所有 I/O 操作进行优化，以便基于后端区域（槽口）页面进行后端读取和写入。
    • SparesUsage: 这是一个标志，指示 Raid 阵列是否使用备件。其值可以是 on 或 off。
    • QueueLen: 这是可以放入与 Raid 阵列的每个后端关联的 io 队列中的最大请求数。其值必须为 1 或更大。
  • Spares Pool: 可以在 RaidRunner 上建立备件池，为正在运行的 Raid 阵列提供磁盘池，以应对后端（磁盘）故障。spool 中的每个磁盘可以是热备 (hot) 或温备 (warm)。热备磁盘是那些立即可用的磁盘，即已启动。温备磁盘是那些在使用前需要启动的磁盘。由于不同的 Raid 阵列可能使用不同的后端（磁盘）大小，因此备件池必须知道池中每个磁盘的大小。如果 RaidRunner 有多个控制器，则备件的使用可以限制为特定的控制器。如果备件可用于给定的控制器，则备件将根据以下优先级分配（rconf -repair 命令）：同一 rank 上相同大小的热备件、另一 rank 上相同大小的热备件、同一 rank 上相同大小的温备件、另一 rank 上相同大小的温备件、同一 rank 上更大尺寸的热备件等等。
  • Rank 是设备的 SCSI ID。
  • Host Port SCSI ID Assignment: 在 RaidRunner 的每个控制器上，都有许多主机端口，通过这些端口访问 RaidRunner 上的数据。由于此主机端口实际上是一个 SCSI 设备，因此必须为其分配一个 SCSI ID。有两种方法可以将 SCSI ID 分配给主机端口。第一种方法是使用物理选择开关（通常提供从 0 到 16 的选择），第二种方法是在非易失性 raid 配置区域中内部配置主机端口的 SCSI ID - hconf 配置命令执行此分配。
  • SCSI Monitor: 在 RaidRunner 的每个控制器上，可以设置一个或多个监视器 (smon) 在指定的主机端口上运行。此监视器允许主机系统上的程序发送 RaidRunner 命令，这些命令将在 husky 子 shell 中执行，并允许文件在 RaidRunner 之间进行传输。此监视器模拟给定 SCSI ID（由 hconf 命令或选择开关设置）和 SCSI LUN（使用 mconf 命令设置）上的 32K “磁盘”。命令的执行和文件传输通过从“磁盘”上的特定块位置读取和写入来实现。读取和写入应遵循基于块位置以及读取和写入顺序的特定协议。有关此协议的详细信息，请参阅 smon。由于不同的系统对自己的内部使用使用特定的块号（例如，块号 0 通常用于磁盘标签），因此写入任何协议未使用的块的数据都会被保留以供后续读取。最多可在 raid 配置区域中保留 16 个块，并在启动时由 smon 重新读取，因此数据得以保留。如果写入超过 16 个块，则这些数据将被静默丢弃。smon 协议中使用的块号可以更改，以适应可能使用默认协议块号的不同系统。
    
    默认情况下，即使 raid 配置区域刚刚初始化或已损坏，SCSI 监视器也会始终在启动时启动。RaidRunner 型号特定的监视器主机端口、SCSI ID 和 SCSI LUN 默认值已编译到 RaidRunner 二进制文件中。要阻止 scsi 监视器在启动时自动执行，必须使用 mconf -delete 选项从控制器中专门删除监视器。
    
    
  • Manual Backend Reconstruction: Raid 类型 1、3 和 5 可以抵抗单个后端设备故障。也就是说，即使其中一个后端发生故障，Raid 阵列的数据仍然可用。如果后续在不同的后端发生故障，则 Raid 阵列的数据将无法访问。当后端设备确实发生故障时，RaidRunner 会将该设备从 Raid 阵列中分离。要更换类型 1、3 或 5 Raid 阵列的故障后端，首先物理更正故障（例如，更换并测试故障磁盘），然后以只写模式接合后端，并从修复入口点读取整个 Raid 阵列。这将导致在更换的后端上重建 Raid 阵列的数据和奇偶校验（如果适用）。我们以只写访问模式接合后端，以防止 Raid 阵列在重建过程中从此驱动器读取数据，因为此后端上的数据不完整。一旦我们在更换的后端上重建了数据（即读取完成），我们就将后端的访问模式设置为 Raid 阵列的访问模式，这样我们就拥有了一个“完整”的 Raid 阵列。这种数据重建是被动的，因为 Raid 阵列在重建期间仍在“运行”，尽管它会运行缓慢。
  • Automatic Backend Reconstruction: 在类型 1、3 或 5 Raid 阵列的情况下，单个后端设备故障可能导致自动更换故障后端并随后重建 Raid 阵列。这是通过指定在后端故障发生时执行的 husky 脚本来实现的 - 请参阅 autorepair。当后端故障发生时，后端将从 Raid 阵列中分离，并执行指定的 husky 脚本（如果已指定）。该脚本通常从备件池中分配一个磁盘，以只写访问模式将其接合到 Raid 阵列，然后读取整个 Raid 阵列（从修复入口点），这将重建包含新磁盘的 Raid 阵列。完成后，磁盘的访问模式将设置为 Raid 阵列的访问模式。
  • 如果在重建阶段（读取整个 Raid 阵列）新接合的后端发生故障，Raid 阵列的数据仍然可用。RaidRunner 将做的只是分离后端并再次执行脚本。它将继续这样做，直到没有更多备件可用。或者，如果在重建期间另一个后端发生故障，则 Raid 阵列将发生故障。
  • Configuration Areas: 通常，RaidRunner 存储 raid 配置区域的多个副本。副本存储在所有可以写入的磁盘上（在 /dev/hd/c.s.l/rconfig 中）以及 RaidRunner 控制器板本身的闪存 ram (/dev/flash/conf) 的一部分中。这样做是为了冗余。每当 raid 配置区域更新时，副本都会写入每个磁盘（按芯片、scsi id (rank)、lun 顺序），最后写入闪存 ram。读取 raid 配置时，它会将所有具有相同配置的配置源分组，然后根据以下规则找出最“正确”的配置 -
    1. 如果所有源都不可读或已损坏，则我们使用编译的默认 scsi 主机 ID 和 scsi 监视器配置。
    2. 如果所有源都相同（即一个组），则这是正常配置。
    3. 如果我们有两个配置组，则使用具有最多相同区域的组。如果两个组具有相同数量的相同区域，则我们选择修订版本最高的组。如果两个组具有相同数量的区域和相同的修订版本，则选择第一个组。
    4. 如果我们有三个组，我们选择具有最多相同区域的组。如果两个组（或所有三个组）满足此条件，我们使用定义的主配置区域 - FLASH RAM。
    5. 如果我们有三个以上的组，我们使用主配置区域 - FLASH RAM。rconf -check 选项用于根据上述规则重新读取所有配置区域，如果存在差异（超过 1 个组），它会选择最“正确”的配置并将其重新写出到所有区域。当 RaidRunner 最初启动时，它通常只能访问闪存 ram（因为磁盘尚未绑定到文件系统），因此它使用存储在闪存 ram 中的配置来启动（在关闭状态下）scsi 监视器和 scsi 目标守护程序 (stargd)。然后，它绑定所有磁盘并执行 rconf -check 命令，如果它必须重新写入配置并且闪存 ram 不在“正确”组中，则它可能会重新启动 RaidRunner（因为现在我们可以假设闪存 ram 区域现在是正确的）。
• OPTIONS - 所有命令
  • -C: 此选项检查自启动以来，是否对任何 raid 阵列、主机端口、scsi 监视器或备件池配置进行了任何重要的配置更改。如果发生更改，则打印相应的消息，并返回状态 ($status) 1，否则返回 0 表示未发生更改。任何修改、添加、删除都被视为重大更改。唯一非重大更改是更改 raid 阵列的状态。
  • -c: 此选项检查自启动以来，是否对相关配置区域进行了任何重要的配置更改，具体取决于调用的命令 - rconf - raid 阵列，hconf - 主机端口（如果未使用物理选择器）等。返回状态与 -C 选项相同。
• OPTIONS - mconf
  • 不指定任何选项与指定 -list 选项相同。
  • -delete: 删除给定控制器编号、主机端口和 SCSI LUN 的 scsi 监视器。此选项接受三个值：控制器编号、主机端口和 SCSI LUN。监视器的删除将在 RaidRunner 下次启动时生效。
  • -list: 打印控制器/主机端口分配的监视器 SCSI LUN。如果给出了可选的控制器编号参数，则打印该控制器的控制器、主机端口和分配的监视器 SCSI LUN。如果控制器没有分配的监视器 SCSI LUN，则将打印减号 (-) 字符代替 SCSI LUN。如果在打开或读取 RaidRunner 配置区域时发生错误，则将列出 RaidRunner 型号特定的默认值。
  • -add: 在给定控制器的主机端口上设置监视器 SCSI LUN。此选项接受三个必填值和一个可选值。第一个是控制器，第二个是该控制器上的主机端口，最后一个是要分配给监视器的 SCSI LUN。如果主机端口尚未分配 SCSI ID，则监视器将不会在启动时执行。可选值是以逗号分隔的九 (9) 个数字列表，这些数字更改了 SCSI 监视器使用的默认块协议块号。有关详细信息，请参阅 smon。
  • -sml: 打印每个 scsi 监视器存储的标签信息。信息打印如下 - 控制器编号、主机端口号、存储的块数，后跟一个冒号，然后是存储的块地址。此列表末尾的块号 0 表示这些可用块尚未写入。
• OPTIONS - hconf
  • 不指定任何选项与指定 -list 选项相同。
  • -delete: 如果控制器没有物理 SCSI ID 选择开关，则指定此选项将删除控制器/主机端口分配的 SCSI ID。此选项接受两个值：控制器编号和主机端口。通过删除分配的 scsi id，没有其他程序（例如 scsi 监视器或 raid 阵列）可以出现在此主机端口上。
  • -list: 打印控制器/主机端口分配的 SCSI ID。如果给出了可选的控制器和主机端口参数，则打印该对的控制器、主机端口和分配的 scsi id。如果未给出任何参数，则对于 RaidRunner 中每个控制器的每个主机端口，打印控制器编号、主机端口和分配给该主机端口的 SCSI ID。如果控制器没有主机端口 SCSI ID 选择开关，则如果主机端口尚未分配 SCSI ID，则将打印减号 (-) 字符代替 SCSI ID。例如（具有两个控制器的 RaidRunner，每个控制器都有两个主机端口）
    
    0 0 2
    
    0 1 3
    
    1 0 -
    
    1 0 6
    
    这表明在第一个控制器 (0) 上，第一个主机端口 (0) 已分配 SCSI ID 2，第二个端口 (1) 已分配 SCSI ID 3。第二个控制器 (1) 的第一个主机端口未分配 SCSI ID，并且其端口分配了 SCSI ID 6。如果在打开或读取 RaidRunner 配置区域时发生错误，则将列出 RaidRunner 型号特定的默认值。
    
    
  • -modify: 如果控制器没有物理 SCSI ID 选择开关，则指定此选项将在给定控制器的主机端口上设置 SCSI ID。此选项接受三个值。第一个是控制器，第二个是该控制器上的主机端口，最后一个是要分配的 SCSI ID。如果任何使用该端口的 raid 阵列处于活动状态，则无法设置主机端口的 SCSI ID。
• OPTIONS - rconf
  • 任何大小子选项（即 raidsize、cache、iosize、backendsize）都可以使用后缀值。不指定任何选项与指定 -list 选项相同。
  • -add: 在 RaidRunner 上添加 raid 阵列。子选项包括 -
  • -type: 指定 raid 类型。此选项接受值 0、1、3 或 5。
  • -name: 指定 raid 名称。名称必须是字母数字，最多 32 个字符，并且以字母字符开头。
  • -iomode: 指定 raid 阵列的 io 模式。此选项接受值 RW、RD 或 WR，分别表示读写、只读或只写。
  • -size 指定 raid 阵列的大小。这是 raid 阵列的大小，以 512 字节块为单位。它必须是 -iosize 值的倍数。如果不是，则会自动调整为倍数，并打印消息（不是错误）。在 raid 类型 3 的情况下，大小必须是 -iosize 值乘以 raid 阵列中数据后端数量的倍数。
  • -iosize: 指定 raid 阵列的块大小（以字节为单位）。raid 阵列上的所有读取和写入操作都将以该大小的倍数进行。当使用缓存时，这也是创建的缓存缓冲区的大小（对于 Raid 类型 3，缓存缓冲区大小是数据后端数量乘以该值）。RaidRunner 建立了一个可以在任何时刻写入的最大 512 字节块数 - 请参阅 write_limit 内部变量（internals）。因此，iosize 受到限制，以确保至少有两个缓冲区适合缓存的此“可写”部分。
  • -hostif: 指定 raid 阵列的主机接口。主机接口是外部访问 raid 阵列数据的设备。主机接口由四元组定义 - 主/从标志 (mflag)、控制器、主机端口和 scsi lun。其中
    • mflag: 是目标访问标志 - 主 (M)：完全访问，从 (S)：有限访问
    • controller: 是 raid 阵列要运行的控制器
    • hostport: 是 raid 阵列 IO 要定向的主机端口
    • scsilun: 是 raid 阵列从主机端口传播出去的 scsi lun
    主/从标志是 M（表示主模式）或 S（表示从模式）。通过重复此选项添加多个主机接口。
    
    
  • -backendsize: 指定 raid 阵列后端的大小。这是 raid 阵列后端的大小，以 512 字节块为单位。在备件池中搜索后端时使用此值。
  • -backends: 以逗号分隔的列表形式指定 raid 阵列的后端设备。raid 阵列的后端设备可以是磁盘或另一个 raid 阵列的前端。如果是磁盘，则其格式为 Dc.s.l，其中 c 是通道，s 是 scsi id（或 rank），l 是磁盘的 scsi lun。如果是 raid 阵列，则其格式为 Rraidsetname，其中 raidsetname 是 raid 阵列的名称。
  • -boot: 指定 raid 阵列的启动模式。值可以是 auto 或 manual，分别表示自动启动或手动启动 raid。此选项是可选的，默认启动模式为 auto。
  • -cache: 指定应作为 raid 阵列前端缓存的缓存大小（以字节为单位）。默认大小为 0，这意味着不使用缓存。缓存大小必须是 raid 阵列 iosize 的倍数。
  • -stargs: 为给定的 raid 阵列创建 stargd 进程时，指定要传递给该进程的附加参数。参数应括在大括号 {} 中，例如 {-L 16 -I 512}
  • -state: 指定 raid 阵列的初始状态。值可以是 active 或 inactive。此选项是可选的，默认状态为 inactive。
  • -usezoneio: 将区域 io 使用标志设置为 on 或 off。如果设置为 on，则缓存文件系统将碎片化写入和读取请求，以适应后端磁盘上的区域（槽口）分区。
  • -usespares: 将备件使用标志设置为 on 或 off。如果设置为 on，则正在运行的 raid 阵列（1、3 或 5）在发生 I/O 错误时，将尝试自动备件分配和重建。
  • -qlen: 指定可以排队到后端的最大 io 请求数。最小值为 1，默认值为 8。
  • -delete: 从 RaidRunner 中删除指定的 raid 阵列。raid 阵列必须处于非活动状态。
  • raidsetname: 指定要删除的 raid 阵列的名称。
  • -list: 打印 raid 阵列配置。如果未指定 raidsetname 名称，则打印所有 raid 阵列配置，每行一个，格式如下（如果未设置详细模式 (-v) - name type flags size iosize cachesize iomode qlen nhostifs hostifs backendsize backends [可选后端状态]）。其中，flags 是以逗号分隔的列表，包括 "Active"、"Inactive"、"Used"、"Unused"、"Autoboot"、"Manboot" 和 "Usespares"。当 raid 阵列首次标记为活动状态时，将永久设置 "Used" 标志。RaidRunner 上的其他程序和实用程序会使用 raid 阵列在某个时间点已被使用的此知识。nhostifs 是要呈现的主机接口的数量，hostifs 是以逗号分隔的主机接口四元组列表，包括主/从标志、控制器、主机端口和 scsi lun（每个四元组之间用句点分隔）。例如，M0.0.4,S0.1.0 表示两个主机接口 - 都在控制器 0 上，一个在端口 0 上，scsi LUN 为 4，另一个在端口 1 上，scsi LUN 为 0。第一个是主目标，提供主机的完全访问权限，第二个是从目标，将告知目标已关闭的任何主机访问。backends 是以逗号分隔的后端列表。如果后端发生故障，则还会附加“- 备用后端”。如果使用了多个备用后端（即备件发生故障），则每个故障后端都将后缀 (-)

    D0.2.0-,D1s2l0,D2.2.0,D3.2.0,D4.2.0

    表示后端 D0.2.0 发生故障且没有备件，其他后端为

    D1s2l0,D2.2.0,D3.2.0,D4.2.0。
    
    D0.2.0-D5.2.0,D1s2l0,D2.2.0,D3.2.0,D4.2.0

    表示后端 D0.2.0 发生故障，备用后端 D5.2.0 已替换它，其他后端为 D1s2l0,D2.2.0,D3.2.0,D4.2.0。

    D0.2.0-D5.2.0-,D1s2l0,D2.2.0,D3.2.0,D4.2.0

    表示后端 D0.2.0 发生故障，替换它的备用后端 D5.2.0 也发生故障，其他后端为 D1.2.0,D2.2.0,D3.2.0,D4.2.0。
    
    
  • raidsetname: 打印仅指定 raid 阵列的配置。
  • -modify: 此命令允许更改 raid 阵列的状态、名称、启动模式、iomode、主机接口、备件使用情况、额外的 stargd 参数、缓存大小或 QueueLen。当指定状态更改时，不允许进行其他修改。要修改任何先前的 raid 阵列属性（状态除外），raid 阵列必须处于非活动状态。子选项包括
  • -name: 要修改的 raid 阵列的名称
  • -newname: raid 阵列的新名称。此新名称在其他已定义的 raid 阵列中仍然必须是唯一的。
  • -boot: 更改 raid 阵列的启动模式。值可以是 auto 或 manual，分别表示自动启动或手动启动 raid。
  • -cache: 更改应作为 raid 前端缓存的缓存大小（以字节为单位）。
  • -hostif: 更改 raid 阵列的主机接口。主机接口是外部访问 raid 阵列数据的设备。主机接口由四元组定义 - 主/从标志 (mflag)、控制器、主机端口和 scsi lun。其中 mflag 是目标访问标志 - 主 (M)：完全访问，从 (S)：有限访问，controller 是 raid 阵列要运行的控制器，hostport 是 raid 阵列 IO 要定向的主机端口，scsilun 是 raid 阵列从主机端口传播出去的 scsi lun。主/从标志是 M（表示主模式）或 S（表示从模式）。通过重复此选项添加多个主机接口。请注意，您必须在一个命令中指定所有需要的主机接口。因此，要删除主机接口，请修改但不使用该主机接口选项。
  • -iomode: 更改 raid 阵列的 io 模式。此选项接受值 RW、RD 或 WR，分别表示读写、只读或只写。
  • -qlen: 更改可以排队到后端的最大 io 请求数。
  • -stargs: 为给定的 raid 阵列创建 stargd 进程时，指定要传递给该进程的附加参数。参数应括在大括号 {} 中，例如 {-L 16 -I 512}
  • -state: 更改 raid 阵列的状态。值可以是 active 或 inactive。
  • -usespares: 将备件使用标志设置为 on 或 off。
  • -rebuild: 当存储的 raid 阵列配置已损坏，并且该 raid 阵列具有故障后端（可选地辅以备件）时，使用 rebuild 选项。通常，如果存储的 raid 阵列配置在某种程度上已损坏，并且没有任何故障驱动器，则只需删除 raid 阵列，然后重新添加即可。如果任何后端出现故障，则我们需要将此信息存储在新重新创建的 raid 阵列配置中。rebuild 选项执行此操作。如果故障后端未使用任何备件，则 -rebuild 选项只会将该后端标记为故障。如果它使用了备件，则重复调用此命令（使用 -spare 子选项）将根据需要添加备件，同时将后端标记为故障，并将任何先前配置的备件也标记为故障。最后一次调用 -spare 子选项将添加备件，并将其标记为正在使用但未故障。如果最后一个备件也发生故障，则最后一次不带 -spare 子选项的调用会将最后一个备件标记为故障。
  • -name: raid 阵列的名称。
  • -drive: 指定要重建的后端。后端规范采用后端列表中后端的索引形式。raid 阵列中的第一个后端的索引为 0。
  • -spar:e 可选地指定要配置到后端上的备用设备。此设备应已在备件池中且未使用。如果未为后端分配任何备件，则后端将被标记为故障，并且备件将被添加并标记为正在使用。如果已为后端分配备件，则最后一个备件将被标记为故障，并且将添加额外的备件并标记为正在使用。
  • -mkfaulty: mkfaulty 选项用于将特定后端标记为故障。当不使用备件的 raid 阵列的后端发生故障时，我们需要更新 RaidRunner 关于此事实的配置。此命令的子选项与 rebuild 命令的子选项相同（并且具有相同的效果），但不包括 -spare 子选项。
  • -repair: 重新配置 raid 阵列以使用从备件池分配的备用后端替换后端。当 -action 选项为 start 时，将打印新备件的深度和备用设备名称。深度是分配给该后端的备件数量。当分配第一个备件时，深度将为 1。当分配第二个备件时，深度为 2，依此类推。深度用于重新接合刚刚重建的备件。如果在重建发生后深度不同，那么我们知道备件已发生故障，并且已分配了另一个备件，因此我们不会尝试重新接合。
  • -name Raid 阵列的名称。
  • -drive 指定要替换的后端。后端规范采用后端列表中后端的索引形式。raid 阵列中的第一个后端的索引为 0。
  • -action: 指定修复操作。值可以是 start 或 finished。通常，当分配备件时，后续步骤是在该备件上重建数据，然后重新接合备件。如果在重建期间备件发生故障，则不应重新接合备件。因此，raid 阵列应知道重建正在进行中。一旦重建完成，重建知识将被清除。start 值将打印出新分配的备件的深度和备件的设备名称。如果没有备件可用，将打印错误消息，并且仅打印后端最后一个备件的深度。finished 操作检查备件的当前深度与给定深度是否一致，如果深度相同（即备件已正确重建），则清除重建标志。
  • -depth: 指定执行 finished 操作时备用设备的深度。将进行检查以确保后端的当前深度与指定的深度相同。这实际上检查了在重建期间是否在此后端上分配了另一个备件。
  • -replace: 当我们物理修复（或更换）了原始故障后端，并且希望将其重新集成回 raid 阵列时，使用此命令。这是通过解分配当前正在运行的备件并在更换的原始后端上重建 raid 来完成的。此命令类似于 -repair: 命令，不同之处在于，工作备件在重建之前从后端解分配并返回到备件池。这样，如果新更换的驱动器发生故障，我们有备件可以重新分配。
  • -name: raid 阵列的名称。
  • -backend: 正在重新集成的后端设备的名称。
  • -action: 指定替换操作。值可以是 start 或 finished。当指定 start 操作时，如果后端上的最后一个备件处于工作状态，则将其返回到备件池。然后，打印后端上备件的当前深度以及后端在最后一个后端列表中的索引（raid 阵列的驱动器编号）。如果在重建期间后端发生故障，则不应重新接合后端。因此，raid 阵列应知道重建正在进行中。一旦重建完成，重建知识将被清除。finished 操作检查备件的当前深度与给定深度是否一致，如果深度相同（即备件已正确重建），则清除重建标志，然后将所有备件释放回备件池（所有这些备件都将是故障的）。如果深度不同，则重建失败，并打印错误消息，并且备件保持不变。-depth 指定执行 finished 操作时备用设备的深度。将进行检查以确保后端的备件当前深度与指定的深度相同。这实际上检查了在重建期间是否在此后端上分配了备件。
  • -unrepair: 通常，当我们使用备件修复 raid 阵列时，我们会修改 raid 阵列的配置，以指示故障驱动器、备件的分配及其“正在构建中”的状态。然后，我们执行重建，并在成功后重新修改配置以清除“正在构建中”状态。即一系列命令，例如 -
    
    rconf -repair .. -action start ...
    
    重建 raid 阵列
    
    rconf -repair .. -action finish ...
    
    现在，如果我们分配的备件发生故障或重建失败，我们需要关闭“正在构建中”状态，解分配备件，并将原始故障驱动器重新标记为故障（以及备件驱动器，如果它也发生了故障）。-unrepair 选项执行此操作。这些选项与
    
    
  • -repair: 选项类似，但添加了原始故障后端的名称。
  • -name: raid 阵列的名称。
  • -drive: 指定要取消修复的后端。后端规范采用后端列表中后端的索引形式。raid 阵列中的第一个后端的索引为 0。
  • -backend: 正在取消修复的后端设备的名称。
  • -depth: 指定备用设备的深度，如同在原始 rconf -repair -action start 命令中分配的那样。这实际上是检查在失败的重建或备用设备测试期间，是否已在此后端上分配了另一个备用设备。
  • -init: 初始化 RaidRunner 配置区域。使用此选项将初始化所有 raid 组、主机端口、SCSI 监视器和备用盘池配置。位于 Raid 配置区域中的 GLOBAL 环境变量和 SCSI 监视器 (smon) 数据块将不会被删除。为了至少启用一个 SCSI 监视器，SCSI 监视器 LUN 及其关联的主机端口 SCSI ID 将初始化为 RaidRunner 型号特定的默认值。谨慎使用此选项。
  • -fullinit: 初始化 RaidRunner 配置区域。此选项执行与 -init 选项相同的功能，并额外清除所有 GLOBAL 环境变量和 SCSI 监视器 (smon) 数据块。
  • -check: 使多个配置区域全部重新读取，如果不同，则根据 raid 配置区域的多个源规则重新写入。如果多于一个 raid 配置区域与其他区域不同，并且“正确”区域不包括闪存，则 rconf 返回非零退出状态；如果所有区域都相同或所有区域都不可读（或已损坏），则 rconf 返回零退出状态。
  • -validate: 对当前的 raid 组、备用设备等执行一致性检查，并打印任何不一致之处。如果发生任何不一致，将打印消息，并且 rconf 的返回状态将为 1。如果不存在不一致，则不会打印任何内容，并且返回状态将为 NULL。
  • -size: 打印 raid 配置存储中实际使用的字节数。
  • -syslog: 打印存储在配置区域中的任何 syslog 条目。请注意，这些条目将在 rconf -init 或 -fullinit 时删除。
  • -maxiochunk: 搜索当前配置的所有 raid 组，并以 512 字节块为单位打印所有 raid 组的最大 IO Chunk 大小。
  • -v: 设置详细模式选项。此选项仅影响 Raid 组的列表显示。在列出 Raid 组时，它会打印额外的详细信息。
• 选项 - 备用盘池
  
  不指定任何选项与指定 -list 选项相同。
  • -add: 将磁盘添加到 RaidRunner 的备用盘池。子选项包括 -
  • -name 磁盘的名称。如果磁盘已被 raid 组使用或已在备用盘池中，则会打印错误消息。
  • -backendsize: 添加磁盘的大小（以 512 字节块为单位）。此值可以是后缀指定的格式。
  • -type: 备用设备的类型。备用设备可以是热备（已启动）或冷备（已关闭）。
  • -delete: 从备用盘池中删除指定的备用设备。将检查备用设备是否正在使用中。
  • -list: 打印池中每个备用设备的当前状态。格式为
  后端 后端大小 热备|冷备 控制器编号|任意 已使用|未使用 故障|工作 注释
  • 配置损坏：在某些情况下，需要损坏 RaidRunner 配置区域。例如，RaidRunner 的配置方式导致所有内存都被消耗，并且 RaidRunner 不响应控制台或 SCSI 监视器上的任何命令。如果内存不足以删除 raid 组甚至执行重启过程（或任何其他操作），则可以执行一个命令来损坏所有 RaidRunner 配置区域（因此将阻止在重启时自动创建 raid 组 - 即内存消耗者），然后立即重启而无需使用任何额外内存，这将允许用户在 RaidRunner 重新启动后重新配置 RaidRunner。corrupt-config 命令执行此任务。
• 返回值：如果发生错误，$status 环境变量设置为 1，否则为 null。当给出配置更改选项（-C 或 -c）时，如果自启动以来配置已更改，则返回值 ($status) 为 1，否则为 0。
• 错误：目前，如果在命令中重复子选项，则最后一次出现的值将是设置的值。例如，如果执行命令 rconf -modify -name F -newname B -newname C -cache 1M -cache 2M，则 newname 将为 "C"，缓存大小设置为 2M（2 兆字节）。
• 另请参阅：husky, autorepair, replace, suffix, setenv, unsetenv, printenv, smon

3.9.72  REBOOT - 退出目标硬件上的 K9 并返回监视器

• 概要：reboot [-i] [-s] rboot [-i] [-s] rbootimed
• 描述：reboot 突然离开（在目标硬件上的）K9 内核，并重新进入底层硬件监视器或重新初始化 K9 内核。除了刷新写缓存和初始化电池备份 RAM 外，不对 K9 进程执行任何清理（没有信号，什么都没有）。如果未给出任何选项，则重启将不会在重新初始化 K9 内核之前执行任何内存测试。
  
  如果给出 -s 选项，则将在重新初始化 K9 内核之前执行内存测试。在这些内存测试期间，RaidRunner 的控制台上会显示一个旋转的 -。这表示内存测试正在执行。如果在测试期间按下空格键，您将进入底层的 RaidRunner 监视器。如果给出 -i 选项，则将禁止所有到后端驱动器的 I/O。也就是说，不会启动任何关闭的驱动器，也不会尝试刷新缓存。
  
  rboot 是 reboot 的别名。
  
  rbootimed 提供了一个进入重启过程的特殊入口点，并且等同于使用 -i 选项调用 reboot。与作为子进程执行的 reboot 不同，rbootimed 通过 husky 解释并立即开始重启过程，因此不使用任何额外的内存。当 RaidRunner 内存耗尽并且您需要将 RaidRunner 重启到单用户状态时，这非常有用。
  
  在 Unix 等模拟平台上，此命令未实现（但通常 Unix "interrupt" 信号具有杀死包含 K9 模拟的 Unix 进程的类似效果）。

3.9.73  REBUILD - raid 组重建实用程序

• 概要
  • rebuild -d 文件 -s 大小 -b bufsize -D dno -R rname -n nbends -r rtype [-p pri] [-v] [-S sleep_period]
  • rebuild -d 文件 -l [-v]
  • rebuild -L [-v]
• 描述：为了将数据重建到 raid 组中新加入的驱动器上，需要完全读取 raid 组的 repair 入口点。此外，读取必须是 raid 组的 bufsize 的倍数，并且最后一次读取必须与 raid 组的末尾对齐（即不能尝试读取超过 raid 组的末尾）。rebuild 实用程序执行此重建。当 rebuild 启动时，它会分配一个内部缓冲区，其大小最大化为可用内存，并且是给定缓冲区大小的倍数。raid 组的 repair 入口点通过这些大缓冲区读取，并且保证最后一次读取与 raid 组的末尾对齐。当 rebuild 从 raid 组的 repair 入口点读取时，会检查正在重建的后端是否仍与 raid 组接合，如果后端已失败（从 raid 组脱离），则 rebuild 会打印消息并返回退出状态 2。如果在重建期间 raid 组失败（第二个后端失败），则 rebuild 会打印消息并返回退出状态 1。
  
  默认情况下，重建会消耗大量的 RaidRunner 资源，这将导致 RaidRunner 到主机的 I/O 吞吐量大大降低。可以为 rebuild 程序指定优先级，以减少对资源的需求。此优先级范围介于 0（使用最少资源）和 9（使用最大可用资源）之间。自然地，通过指定较低的优先级，完成重建的时间将会增加。任何已完成或“正在进行中”的重建的当前状态都会被记录下来以供参考。任何时候最多保留 10 条此类记录。如果请求新的重建并且我们已经使用了所有 10 条记录，我们会找到第一条“非活动”（或已完成）记录并重新使用它。如果所有 10 条记录当前都标记为“活动”（这意味着我们当前有 10 个重建正在进行中），则不会保留新重建的记录。这些记录在启动时初始化。
  
  
• 选项
  • -d 文件：指定要读取的文件。这通常是 raid 组的 repair 入口点。
  • -s 大小：指定 raid 组的大小，以 512 字节块为单位。
  • -b bufsize：指定 raid 组的 IO chunksize - bufsize，以 512 字节块为单位。对于 raid 类型 3，这应该是数据驱动器数量乘以 IO chunksize 的大小。
  • -n nbends：指定 raid 组中的后端数量。这与 bufsize 选项一起使用，以确保 raid 组的 repair 设备以 raid 组条带大小的倍数读取。
  • -D dno：指定正在重建的后端索引（在 raid 组内）。
  • -R rname：指定正在重建的 raid 组的名称。指定正在重建的 raid 组的 raid 类型。必须为 1、3 或 5。
  • -p pri：指定重建运行的优先级。优先级 pri 必须是介于 0（最低）和 9（最高）之间的数字。当通过自动或手动脚本执行 rebuild 时，将检查环境变量 RebuildPri，以查看 raid 组应以什么优先级重建。如果未设置此变量，则默认优先级为 5。有关详细信息，请参阅 environ。
  • -S sleep_period：指定每次重建访问 raidset 之间休眠的毫秒数。周期 sleep_period 必须是介于 0（不休眠）和 60000（60 秒）之间的数字。当通过自动或手动脚本执行 rebuild 时，将检查环境变量 RebuildPri，以查看 raid 组应使用什么休眠周期。如果未设置此变量，则使用给定优先级的默认周期。有关详细信息，请参阅 environ。
  • -v：设置详细模式。重建时，如果设置了详细模式，则每完成 10% 的重建，都会打印当前读取次数和预期总读取次数。在打印特定或所有重建的状态时，详细模式将生成重建状态的详细列表。
  • -l：打印指定的重建 (-d) 文件的当前状态。
    • 默认情况下，打印以下冒号分隔的字段
    • 重建文件（raid 组 repair 设备的入口点）
    • 文件（raid 组）的大小，以 512 字节块为单位
    • 文件（raid 组）的 IO chunksize，以 512 字节块为单位
    • 用于读取的缓冲区大小（以 512 字节块为单位）
    • 读取整个文件所需的总读取次数
    • 到目前为止执行的当前读取次数，
    • 重建的优先级
    • 每次访问之间休眠的毫秒数
    • 重建的状态 - “活动”或“完成”重建失败的错误消息 - 如果重建成功完成，则设置为“none”。
    当设置详细模式 (-v) 时，以上内容将使用适当的标签打印。
    
    
  • -L：打印所有正在进行或已完成的重建的重建状态（格式与 -l 选项相同）。
• 优先级：重建发生的速度及其对系统的影响由优先级和可选的访问之间休眠周期决定。当 rebuild 分配要使用的缓冲区时，它会将此缓冲区的大小限制为最大可用连续内存段或 2 兆字节，以较小者为准。然后，内存将按 pri + 1 / 10 缩放。也就是说，如果您指定优先级为 0，则缓冲区将是最大缓冲区大小的十分之一，如果您指定优先级为 4，则缓冲区将是一半。然后修剪此结果缓冲区大小，以确保它是 raid 组条带大小的倍数。在每次读取/写入 raid 组的 repair 设备之间，rebuild 可能会休眠给定的毫秒数，以减少重建过程的开销。此休眠周期可以在命令行上给出。如果没有，则使用优先级值来计算周期。下表指定了哪个周期与哪个优先级相关联。

  0: 2000 毫秒 (2.00 秒)
  
  1: 1750 毫秒 (1.75 秒)
  
  2: 1500 毫秒 (1.50 秒)
  
  3: 1250 毫秒 (1.25 秒)
  
  4: 1000 毫秒 (1.00 秒)
  
  5:  750 毫秒 (0.75 秒)
  
  6:  500 毫秒 (0.50 秒)
  
  7:  250 毫秒 (0.25 秒)
  
  8:  100 毫秒 (0.10 秒)
  
  9:    0 毫秒 (不休眠)

• 退出状态
  
  返回以下退出值
  • 0: 成功完成。
  • 1: raid 组重建失败。这意味着 raid 组已失败。
  • 2: 正在重建的 raid 组的后端已失败。这意味着 raid 组仍然有效。
• 另请参阅：raid1, raid3, raid5, repair, replace, environ

3.9.74  REPAIR - 用于为 raid 组的故障后端分配备用设备的脚本

• 概要：repair raidsetname backend
• 描述：repair 是一个 husky 脚本，用于为 raid 组的故障后端分配备用驱动器。这通常在 raid 组具有故障后端且在故障发生时没有可用的备用设备，而现在您想分配备用设备（而不是修复故障后端）时完成。在解析其参数后，repair 从备用盘池中获取备用后端（适当类型的）。然后，备用驱动器以只写访问模式接合到 raid 组中，并发生 raid 重建（读取整个 raid 组）。此读取来自 raid 文件系统 repair 入口点。从此入口点读取会导致读取一个块，然后立即写入该块。读取/写入序列是原子的（即不可中断）。在成功完成重建后，备用设备将以正确的 iomode 接合到 raid 组中。读取 repair 入口点的进程是 rebuild。
  
  此设备重建将花费 10 分钟到一个半小时不等，具体取决于后端的大小和速度以及主机生成的活动量。在设备重建期间，将打印成对的数字，指示已重建数据的每 10%。成对的数字用斜杠字符分隔，第一个数字是到目前为止已重建的块数，第二个数字是要重建的块数。有关重建的更多状态，可以从运行 rebuild 获得。将进行检查以确保 raid 组正在运行，备用设备工作正常，并且在重建期间备用设备没有发生故障。
  
  
• 选项
  • raidsetname：raid 组的名称。
  • backend：被备用设备替换的故障后端的名称。
• 另请参阅：rconf、rebuild

3.9.75  REPLACE - 用于恢复 raid 组中后端设备的脚本

• 概要：replace raidsetname backend
• 描述：replace 是一个 husky 脚本，用于将物理修复的类型 3 或 5 raid 组的后端设备重新配置回系统中。在解析其参数后，replace 会对指定的后端设备进行快速的读/写测试，以确保其工作正常。如果当前有工作的备用设备代替该后端设备运行，则会将其脱离并返回到备用盘池。然后，后端驱动器以只写访问模式接合到 raid 组中，并发生 raid 重建（读取整个 raid 组）。此读取来自 raid 文件系统 repair 入口点。从此入口点读取会导致读取一个块，然后立即写入该块。读取/写入序列是原子的（即不可中断）。在成功完成重建后，后端设备将以正确的 iomode 接合到 raid 组中，并且与该后端设备关联的任何其他故障备用后端设备都将返回到备用盘池。读取 repair 入口点的进程是 rebuild。此设备重建将花费 10 分钟到一个半小时不等，具体取决于后端的大小和速度以及主机生成的活动量。在设备重建期间，将打印成对的数字，指示已重建数据的每 10%。成对的数字用斜杠字符分隔，第一个数字是到目前为止已重建的块数，第二个数字是要重建的块数。有关重建的更多状态，可以从运行 rebuild 获得。将进行检查以确保 raid 组正在运行，后端设备工作正常，并且在重建期间后端设备没有发生故障。
• 选项
  • raidsetname：raid 组的名称。
  • backend：要恢复的后端设备的名称。
• 另请参阅：rconf、rebuild

3.9.76  RM - 删除文件（或多个文件）

• 概要：rm [-f] [ 文件 ... ]
• 描述：rm 删除指定名称的文件（或多个文件）。[目录被视为文件。] 如果可以删除所有给定的文件，则返回 NIL（即 true）作为状态；否则，返回第一个无法删除的文件名（并且此命令将继续尝试删除文件，直到列表耗尽）。
  
  如果给出 -f 选项，则忽略无法删除的文件，并返回 NIL（即 true）作为状态。
• 错误：在非空目录上使用 rm 会使这些子文件成为孤立文件。

3.9.77  RMON - 开机自检和引导

• 概要
  
  v1.0
  
  DRAM: 010 Mb
  
  Batt: B0000008-B007FFFC
  
  PWROK 1:BAD 2:OK
  
  0:720seE 1:720seE 2:720seE 3:720seE 4:720seE 5:720seE 6:770B 7:770B
  
  S/N: ABC-12345 B
  
  -
  
  
• 描述：rmon 通常会执行开机自检，然后引导主 raid 代码。通过在倒计时完成之前键入空格，rmon 将中止开机自检，并提示从控制台串口输入命令。
  
  rmon 打印的第一行是其版本号。第二行是 DRAM 的大小（以十六进制表示）。下一行指示找到的电池备份 SRAM 的类型和使用情况。这可以是各种值，如果打印了两个十六进制值，则这是开机自检将测试电池备份 SRAM 的包含地址范围。如果只有一个值，则表示电池备份 SRAM 的大小，但不会对其执行开机自检。所有可能的值为：-

           Batt: 00000000          没有电池备份 SRAM。
  
  Batt: B0000000-B007FFFC 512Kb SRAM，B0000004==0（无数据）。
  
  Batt: B0000008-B007FFFC 512Kb SRAM，B0000004==1（无数据）。
  
           Batt: B00XXXXX-B007FFFC 512Kb SRAM，B0000004==2（已保存数据，
  
                                   B0000000==B00XXXXX，其中 B00XXXXX 是
  
                                   未使用数据的起始位置）。
  
           Batt: B0080000          存在 512Kb SRAM，但
  
                                   SRAM 的内容不是上述之一，或者可能是
  
                                   B0000004==2 且 B0000000==B0080000。
  
                                   未对其进行开机自检。
  
   
  
           Batt: B0000000-B03FFFFC 4Mb SRAM，B0000004==0（无数据）。
  
           Batt: B0000008-B03FFFFC 4Mb SRAM，B0000004==1（无数据）。
  
           Batt: B0XXXXXX-B03FFFFC 4Mb SRAM，B0000004==2（已保存数据，
  
                 B0000000==B0XXXXXX，其中 B0XXXXXX 是未使用数据的起始位置
  
                 数据）。
  
           Batt: B0400000          存在 4Mb SRAM，但
  
                                   SRAM 的内容不是上述之一，或者可能是
  
                                   可能是 B0000004==2 且 B0000000==B0400000。
  
                              未对其进行开机自检。

  注意 位置 B0000004 的值为 2（存在已保存数据）的情况，但 B0000000（未使用数据的起始位置）指向一个字地址，该地址恰好超过电池备份 SRAM 的最后一个字节。后一种情况将导致打印单个值（例如 B0080000，对于 512Kb 电池备份 SRAM）。这种情况并不表示电池备份 SRAM 的任何内容被认为是错误的，而是电池备份 SRAM 已满，并且不会对电池备份 SRAM 执行开机自检。
  
  DRAM 内存大小调整算法将适应 8Mb 到 256Mb 的 DRAM，并且每个 DRAM 集中只需要 32 位字中的 30 位正常工作，以便大小调整功能正常运行。DRAM 由两个内存库 A 和 B 组成，每个库有两个插槽。当使用一个内存库时，该库的两个插槽都必须装有相同类型和大小的 Simm。如果只使用一个库，则必须是库 A。Simm 内存的类型可以是单面或双面。将两个双面 Simm（如上所述，它们的大小必须相同）放入库 A 等同于用大小正好是双面 Simm 大小一半的单面 Simm 填充所有四个插槽。在这种情况下，库 B 不能包含任何 Simm。每个库都可能使用不同大小的单面 Simm，但第一个库必须具有较大尺寸的 Simm。

              DRAM 大小 DRAM 最后地址
  
              十六进制 十进制   已缓存    未缓存
  
              008  8    7FFFFF    A07FFFFF
  
              010  16   FFFFFF    A0FFFFFF
  
              020  32   1FFFFFF   A1FFFFFF
  
              040  64   3FFFFFF   A3FFFFFF
  
              080  128  7FFFFFF   A7FFFFFF
  
              100  256  FFFFFFF   AFFFFFFF

  第四行是电源状态。这将是两种变体之一。第一个是用于单电源系统，电源摘要状态在 PWROK（良好）或 PFAIL（如果不良好）处打印。第二个是用于多电源系统，摘要状态之后是每个电源的单独状态。如果任何电源出现故障，将打印 PFAIL。此时，在非伪静态 DRAM 系统上，如果摘要状态为 PFAIL，则监视器将挂起。伪静态 DRAM 系统永远不会打印此行或任何前面的行（即版本行、DRAM 大小或电池备份 SRAM 大小），并且始终立即挂起。
  
  第五行是系统中使用的 SCSI 芯片的摘要。此报告中的每个项目都包含该芯片的索引号（从 0 到 7），后跟一个 ":"，然后是一个指示型号的文本字符串。此型号由其芯片类型和修订级别组成。已知零件编号与型号的摘要如下：-

      位 7 到 4 的
  
               型号    零件编号    MACNTL CTEST3
  
                720B   609-0391071   0000   0001
  
                720C   609-0391324   0000   0010
  
                720E   609-0391955   0000   0100
  
              720seE   609-0391949   0001   0100
  
                770A   609-0392179   0010   0000
  
                770B   609-0392393   0010   0001

  可能还有第六行指示单元的序列号。如果 FlashRam 引导分区的最后 12 个字节处于未熔断状态（全为 1），则不会显示此行。否则将打印最后 12 个字节。这 12 个字节可能包括尾随空格。FlashRam 中序列号前面的四个字节包含 26 位，表示电路板的修订级别。如果这些位中的任何一位被清除，并且存在序列号，则将打印从 A 到 Z 的修订级别。
  
  在打印上述配置信息后，将对 DRAM 和电池备份 SRAM（如果找到）执行 Knaizuk-Hartmann 内存测试。此内存测试对地址线和数据位置中的卡死故障进行快速的非详尽检查。在以下情况下禁用此测试：-
  • 如果第一个位置的高 17 位包含十六进制位模式 0x3C1A0000，并且在读取所有其余 DRAM 时没有奇偶校验错误。这种情况将导致从第一个位置开始的代码随后执行。
  • 如果未找到 DRAM。监视器将不会自动引导主 raid 代码，而是打印监视器提示符并等待监视器命令（见下文）。
  通过键入空格，将中止可能已开始的任何内存测试。监视器将打印提示符并等待监视器命令（见下文）。
  
  所有其他情况都将导致从 FlashRam 读取并启动主 raid 代码。当内存测试正在进行时，控制台上会打印 -、/、| 和字符序列，从而产生旋转条的外观。板载 LED 1 将每 10 毫秒闪烁一次，LED 2 将在测试的每个阶段之间更改状态。如上所述，可以通过在控制台上键入空格来中止这些测试。当 rmon 处于命令模式时，可以发出各种命令。这些命令主要与可以执行的各种诊断或如何使用新固件升级闪存 RAM 有关。
  
  
• 通用命令：监视器中使用的所有值和地址都应为十六进制。命令必须从行的开头开始，并且区分大小写。命令必须用分号“;”或换行符分隔。如果发生命令语法错误，则将打印该命令的使用行。如果命令（例如 command_name）无法识别，则将打印消息 unknown command: command_name。
  
  请注意，任何尝试修改监视器占用的内存区域的命令都将导致不可预测的结果。目前，监视器使用的位置包括 CPU 地址 801E0000 到 801FFFFF（含）。
  • ?: 此命令将打印监视器中更常用的命令的摘要。
  • { 一些注释 }：将忽略从前导左大括号到第一个右大括号之间的所有文本。这允许您在下载之前注释您的监视器脚本（监视器命令集）。请注意，注释不能嵌套，即一行上只能有一个左大括号和一个右大括号。
  • * 计数 命令 ...：将重复所有命令，直到换行符计数次。
  • ( 命令 )：将执行从左括号到右括号（或换行符）的命令序列，就像它们单独在一行上一样。例如，要嵌套 repeat (*) 命令，可以输入行
    
    * 20 (* 8 pb 5F 0); (* 10 pb 6F 1)
    
    这将把字节 0 放入内存位置 5F 八次，然后把字节 1 放入内存位置 6F 十次，并重复这两个 put byte 命令 20 次。因此，位置 5F 将总共写入字节值 0 160 次，位置 6F 将总共写入字节值 1 200 次。
    
    
  • b: 此命令将引导主 raid 代码。
  • ba: 此命令将自动引导主 raid 代码，就像从电源启动一样。
  • g <地址>: 跳转到代码地址并从该地址开始执行。
  • l: 通过串口下载程序或数据。数据应为 Motorola Packed S 格式。如果在下载期间发生错误，则会显示消息 Unrecoverable error in S-format loader。
  • lg: 通过串口下载程序并开始执行该程序。程序数据应为 Motorola Packed S 格式。在成功下载数据或程序后，在加载地址（在下载的文件中指定）开始执行。如果在下载期间发生错误，则会打印消息 "Unrecoverable error in S-format loader."，并且程序将不会执行。
• 内存命令：以下命令用于显示、更改或测试内存。这些命令大多数有三种形式，具体取决于内存访问的大小。这些形式是 - 字节形式（8 位）、短字形式（16 位）和长字形式（32 位）。使用短字或长字形式时，使用的任何地址都必须是短字（16 位）或长字（32 位）对齐的。如果给出未对齐的地址，则会显示错误消息
  
  cmd: 错误的地址对齐
  
  被打印出来。为了区分三种形式的内存访问，后缀 b、w 和 l 分别用于字节、短字和长字。
  • db|dw|dl start_address [end_address]: 这些命令显示指定内存位置或内存范围的内容。可以使用 db、dw 和 dl 命令分别以字节、短字或长字大小显示内存。如果没有给出结束地址，则仅显示第一个地址的内容。这些命令的每行输出都具有以下格式：address: contents contents .... contents。其中每行最多打印 16 个字节。例如

  {rmon} db 60 7F
  
  00000060: A0 9F 9E 9D 9C 9B 9A 99 98 97 96 95 94 93 92 91
  
  00000070: 90 8F 8E 8D 8C 8B 8A 89 88 87 86 85 84 83 82 81
  
  {rmon} dw 60 7F
  
  00000060: FFA0 FF9E FF9C FF9A FF98 FF96 FF94 FF92
  
  00000070: FF90 FF8E FF8C FF8A FF88 FF86 FF84 FF82
  
  {rmon} dl 60 7F
  
  00000060: FFFFFFA0 FFFFFF9C FFFFFF98 FFFFFF94
  
  00000070: FFFFFF90 FFFFFF8C FFFFFF88 FFFFFF84

  • pb|pw|pl address value ....: 这些命令将给定的值放入指定的内存位置。可以使用 pb、pw 和 pl 命令分别以字节、短字或长字大小寻址内存。如果给出多个值，则第一个值放入指定的内存位置，下一个值放入下一个对齐的内存位置，依此类推。例如，以下命令
    
    {rmon} pb 60 1 2
    
    {rmon} pw 70 04F2 002F
    
    {rmon} pl 80 8000FF04 8000FF0F 80FFFFFF
    
    将分别把值 01 放入位置 00000060 和 02 放入位置 00000061，把值 04F2 放入位置 00000070 和 002F 放入位置 00000072，以及把值 8000FF04 放入位置 00000080，8000FF0F 放入位置 00000084 和 80FFFFFF 放入位置 00000088。
    
    
  • fb|fw|fl start_address end_address value: 这些命令使用给定的值填充由起始地址和结束地址指定的内存。可以使用 fb、fw 和 fl 命令分别以字节、短字或长字大小寻址内存。起始地址和结束地址必须与给定的内存大小对齐。例如，以下命令

    {rmon} fb 60 70 8F
    
    {rmon} fw 60 70 FF8F
    
    {rmon} fl 80 90 00FFFF11

    将把值 8F 放入位置 00000060 和 00000070 之间的所有字节（包括端点），把值 FF8F 放入位置 00000060 和 00000070 之间的所有短字（包括端点），以及把值 00FFFF11 放入位置 00000080 和 00000090 之间的所有长字（包括端点）。
    
    
  • sb|sw|sl start_address end_address value: 这些命令在由起始地址和结束地址指定的内存中搜索给定值首次出现的位置，并将打印出找到该值的地址和值。如果未找到给定值，则不打印任何内容。可以使用 sb、sw 和 sl 命令分别以字节、短字或长字大小寻址内存。
  • cb|cw|cl start_address end_address value: 这些命令将由起始地址和结束地址给出的连续内存位置与给定值进行比较，如果所有内存都相同，则打印结束地址及其内容，否则打印与给定值不同的第一个位置的地址以及不同的值。可以使用 cb、cw 和 cl 命令分别以字节、短字或长字大小寻址内存。
  • tb|tw|tl start_address end_address seed: 这些命令生成伪随机值，并将这些值存储在由起始地址和结束地址给出的连续内存位置中。当所有内存都被填充后，将读取内存并将其内容与写入的内容进行比较。可以使用 tb、tw 和 tl 命令分别以字节、短字或长字大小寻址内存。给定的种子将初始化伪随机数生成器。如果此命令的后续执行使用相同的种子，则随机值将始终相同。当正在写入随机值时，每个位置将打印一个点 ('.')。当正在执行读取时，如果数据等于写入的数据，则打印一个点 ('.')，否则打印一个 'X'。例如
    
    {rmon} tw 60 70 7B
    
    Writing
    
    Checking
    
    {rmon}
    
    
  • m start_address end_address mask: 此命令将对给定的内存范围运行低级内存测试。起始地址和结束地址必须是长字对齐的。如果测试通过，将打印消息 Passed.，如果测试失败，将打印消息 Failed.。给定的掩码将确定要运行的测试类型。下表显示了每个掩码的功能。这些测试本质上是写入内存，然后从内存中读取，并将读取的内容与写入的内容进行比较。以下前十二个测试首先写入所有指定的内存，然后读取所有指定的内存，接下来的十二个测试在写入后立即进行读取。掩码可以进行“或”运算以运行多个测试。
    
    0x0001 用 0x00 填充每个字节
    
    0x0002 用 0xFF 填充每个字节
    
    0x0004 用 0x55，然后用 0xAA 填充交替字节
    
    0x0008 用其地址的二进制补码填充每个字节
    
    0x0010 用 0x0000 填充每个字
    
    0x0020 用 0xFFFF 填充每个字
    
    0x0040 用 0x5555，然后用 0xAAAA 填充交替字
    
    0x0080 用其地址的二进制补码填充每个字
    
    0x0100 用 0x00000000 填充每个长字
    
    0x0200 用 0xFFFFFFFF 填充每个长字
    
    0x0400 用 0x55555555，然后用 0xAAAAAAAA 填充交替长字
    
    0x0800 用其地址的二进制补码填充每个长字
    
    0x0001000 用 0x00 填充每个字节
    
    0x0002000 用 0xFF 填充每个字节
    
    0x0004000 用 0x55，然后用 0xAA 填充交替字节
    
    0x0008000 用其地址的二进制补码填充每个字节
    
    0x0010000 用 0x0000 填充每个字
    
    0x0020000 用 0xFFFF 填充每个字
    
    0x0040000 用 0x5555，然后用 0xAAAA 填充交替字
    
    0x0080000 用其地址的二进制补码填充每个字
    
    0x0100000 用 0x00000000 填充每个长字
    
    0x0200000 用 0xFFFFFFFF 填充每个长字
    
    0x0400000 用 0x55555555，然后用 0xAAAAAAAA 填充交替长字
    
    0x0800000 用其地址的二进制补码填充每个长字
    
    0x1000000 用 0x00000000，然后用 0xFFFFFFFF 填充交替长字
    
    
  • r start_address end_address read_size:: 此命令将为从 start_address 到 end_address 的内存块生成并打印一个 32 位循环冗余校验值，读取大小由 read_size 指定，read_size 可以是 1、2 或 4，分别表示字节、字或长字读取。起始地址和结束地址必须是长字对齐的。
• 闪存命令：使用的闪存 RAM 是 AMD 的 Am29F040，这是一个 4Mb（512k x 8 位）设备，由 8 个大小相等的扇区组成，每个扇区为 64Kb。电路板可能还有第二个闪存 RAM 芯片。总存储空间，无论闪存 RAM 芯片的数量如何，都分为 4 个区域，前 3 个区域每个区域为 1 个（64kB）扇区，分别在 CPU 地址 BFC00000、BFC10000 和 BFC20000 处包含 Bootstrap、Raid Configuration 和 Husky Scripts。主区域包含 5 个 64Kb 扇区（从 BFC30000 开始），并且可选地包含第二个 FLASHram 的所有 8 个 64Kb 扇区（从 BFC80000 开始）。如果存在第二个芯片，则主 raid 代码总共有 13 个 64Kb 扇区。AMD Am29F040 的制造商 ID 和设备 ID 分别为 01 和 A4。因此，在访问此设备的 E 命令或 W 命令时，会打印文本“Flash: 01A4”。尝试擦除或写入 Boot 扇区将始终导致“Illegal Flash RAM address range”。
  • E sector_address: 可以通过 'E' 命令，通过指定该区域中的地址来批量擦除整个区域，主区域将擦除以包含指定地址的扇区开始的所有扇区，并擦除到该区域的末尾，但不会跨越芯片边界。因此，'E BFC40000' 命令将擦除第一个芯片的最后 4 个扇区。'E BFC30000; E BFC8000' 命令将擦除第一个芯片的最后 5 个扇区，然后擦除整个第二个闪存 RAM 芯片（如果存在）。尝试擦除不存在的第二个芯片无法报告错误，但是会打印一个负数来指示其他错误，如下表所述。
  错误 故障描述
  
  -1 非法 Flash RAM 地址范围。
  
  -2 给定范围内的扇区受到写保护。
  • W sector_address source_address byte_count: 此命令将 byte_count 字节的数据从 source_address 复制到从 sector_address 开始的 EEPROM 位置。将打印复制的字节数，或者在出错时打印一个负数。负错误号在下表中描述。可选地，W 命令可以不带任何参数出现，在这种情况下，sector_address 将是先前 E 命令指定的地址，而 source_address 和 byte_count 将分别是先前 T 命令给出的和打印的地址和字节数（请参见下文）。与 E 命令不同，如果 sector_address 加上 byte_count 等于或大于 CPU 地址 BFC80000，则此命令将修改第二个闪存 RAM 芯片的内容。尝试写入 byte_count 为 0 的内容不是错误，只会导致打印制造商 ID 和设备 ID。
    
    错误 故障描述
    
    -1 非法 Flash RAM 地址范围
    
    -2 地址范围内的扇区受到写保护
    
    -3 字节编程命令失败
  
  
• 网络命令：RaidRunner 上的第二个 RS232 端口可用于从主机下载程序和数据到内存中。此端口可以运行 TCP/IP SLIP 协议，并且可以使用简单文件传输协议 (TFTP) 进行文件传输。有三个变量可用于影响从远程主机下载文件传输。这些变量是远程主机 IP 地址、本地 IP 地址（RaidRunner 的 IP 地址）以及要下载的远程主机上的文件名。这些变量的默认值为 C02BC60E (192.43.198.14)、C02BC6FD (192.43.198.253) 和 /usr/raid/lib/raid.bin，其中分别是远程主机 IP 地址、本地 IP 地址和要下载的远程主机文件。这些默认值是动态的，也就是说，如果您更改它们，它们将在开机时或每次启动引导监视器时恢复为其默认值。以下命令管理这些变量和文件传输。
  • A [remote_ip_address [local_ip_address]]: 如果没有参数，此命令以十六进制打印 TFTP 和 SLIP 使用的动态远程和本地 IP 地址。要更改远程 IP 地址，请仅使用一个参数执行此命令 - 远程主机的 IP 地址（以十六进制表示）。要更改本地 IP 地址（RaidRunner 的 IP 地址），请使用两个参数执行此命令，第一个参数是远程主机的 IP 地址，第二个参数是 RaidRunner 的 IP 地址。请记住，这两个地址都必须是十六进制。
  • F [filename]: 如果没有参数，此命令将打印要从远程主机下载的文件的文件名。要更改文件名，请将其指定为此命令的参数。请记住，必须设置远程计算机上此文件的权限，以允许 RaidRunner 进行远程 TFTP 访问。
  • P: 此命令将 ping（发送 ICMP ECHO 请求数据包并计时响应）远程互联网主机。如果远程主机响应，则消息

    Sending echo request...
    
    Got response after 0x0000nn ms

    将被打印出来。nn 是远程主机响应所花费的毫秒数。如果远程主机在 10 秒内未响应，则消息

    Sending echo request...
    
    timeout after 10 seconds

    将被打印出来。
    
    
  • T start_address end_address: 此命令将从远程主机传输存储的文件名到从
  • start_address 开始并限制为 end_address 的内存块中。将传输的字节数将是远程文件的大小或由 end_address - start_address + 1 计算的值，以较小者为准。在传输数据时，每传输一个数据包，将打印一个点 ('.')。在成功传输结束时，将打印传输的字节数。如果传输失败，将打印相应的错误消息。
    
    以下两个示例显示了从远程主机传输 raid 二进制文件和 RaidRunner 的 /bin 目录。远程主机的 IP 地址为 192.43.198.101 (C02BC665)，RaidRunner 的 IP 地址为 192.43.198.200 (C02BC6C8)，所涉及的两个文件将是 /usr/raid/lib/raid.bin 和 /usr/raid/lib/raid.rc（分别为 raid 二进制文件和 /bin 目录）。raid.bin 文件将被写入从地址 bfc10000 开始的闪存 ram 库中，raid.rc 文件将被写入地址 bfc08000 和 bfc0c000 处的两个连续闪存 ram 库中。

    {rmon} {first transfer the raid binary - /usr/raid/lib/raid.bin}
    
    {rmon} F /usr/raid/lib/raid.bin
    
    {rmon} A C02BC665 C02BC6C8
    
    {rmon} P
    
    Sending echo request...
    
    Got response after 0x000013 ms
    
    {rmon} T 80300000 803fffff
    
    {rmon} E bfc10000; {erase the Flash EEPROM address for raid.bin to be stored}
    
    **
    
    70000
    
    {rmon} W bfc10000 80300000 5BDA0; {copy downloaded raid.bin into flash}
    
    5BDA0
    
    {rmon}
    
    {rmon} {now transfer the raid /bin directory - /usr/raid/lib/raid.rc}
    
    {rmon} F /usr/raid/lib/raid.rc
    
    {rmon} A C02BC665 C02BC6C8
    
    {rmon} P
    
    Sending echo request...
    
    Got response after 0x000013 ms
    
    {rmon} T 80300000 803fffff
    
    {rmon} E bfc08000; {erase the two consecutive blocks of flash ram where raid.rc}
    
    4000
    
    {rmon} E bfc0c000; {is to be stored}
    
    4000
    
    {rmon} W bfc08000 80300000 4000; {copy the first 0x4000 bytes}
    
    4000
    
    {rmon} W bfc0c000 80304000 4000; {copy the next 0x4000 bytes}
    
    4000
    
    {rmon}
    
    

  • Sno ABC-12345：打印/设置序列号。如果没有参数，将打印当前序列号，如果未设置序列号，则不打印任何内容。如果在 'Sno' 命令后有任何尾随字符，则表明这些字符将永久设置为序列号。序列号只能设置一次，此后任何尝试设置另一个序列号都将被忽略，并打印当前序列号。如果必须重新设置序列号，则需要重新刷新 flashram，就像它是全新的。请注意，首次设置序列号时，命令的确切格式非常重要。命令 'Sno' 后将正好有一个空格，之后接下来的 12 个可打印字符将被视为序列号。如果少于 12 个字符（在回车符之前），则在右侧填充空格字符。
    
    建议序列号不超过 10 个字符，并且由大写字母、十进制数字以及有限数量的特殊字符（例如 '-' 或 '.' 字符）组成。如果存在修订级别，则主 raid 代码会将序列号截断为 10 个字符。如果存在修订级别，则主 raid 代码会将修订级别紧跟在序列号之后附加，并将组合后的字符串作为查询命令中的序列号呈现。
    
    
  • Rev A：打印/设置电路板修订级别。如果没有参数，则当前修订级别将打印为大写字母（从 'A' 到 'Z'）。如果紧跟在 'Rev' 命令之后有一个空格和一个大写字母，则表明此修订级别将被永久设置。修订级别可以增加（例如，从 'A' 到 'B' 再到 'C' 等），但永远不能降低。
• 诊断
  
  x000 诊断命令的一般形式是它以 x 开头，然后紧跟一个十六进制数字。大多数诊断程序将永久循环，需要断电/通电才能停止诊断。
  • x000 chip：将持续地置位/复位大多数 SCSI 总线信号。这些信号包括 DB0-15、I/O、REQ、C/D、SEL、MSG、RST、ACK、BSY、ATN。DP0 和 DP1（即奇偶校验位）不能以这种方式置位/复位。
  • x001 chip：将持续地置位/复位大多数 SCSI 总线信号，方式是指示此引脚将连接到的 SCA 连接器的编号。此计数是相对于 LED1 和 LED2 而言的，当用于触发示波器时（在下降沿）。每组完整的十个计数被合并以方便在示波器上计数。计数如下：-

    7  - DB11       14 - SEL         21 - DB7        28 - DB0
    
    8  - DB10       15 - MSG         22 - DB6        29 - DP1 (*2)
    
    9  - DB9        16 - RST (*1)    23 - DB5        30 - DB15
    
    10 - DB8        17 - ACK         24 - DB4        31 - DB14
    
    11 - I/O        18 - BSY         25 - DB3        32 - DB13
    
    12 - REQ        19 - ATN         26 - DB2        33 - DB12
    
    13 - C/D        20 - DP0 (*2)    27 - DB1
    
    

    请注意，RST 线（上面标记为 *1）仅在最后一个引脚被脉冲后（即在 DB12 之后）脉冲一次，并且奇偶校验线（上面标记为 *2）不能被脉冲。
    
    
  • x002 dst_addr src_addr length：调用 C 库例程 memcpy，其中包含三个参数：目标地址、源地址和长度（均为十六进制）。
  • x003 200000 ffffff 和 x004 200000 ffffff：这两个命令用于测试电池备份 DRAM。x003 命令将设置如上建议的内存范围。值 200000 是最后一个使用的闪存监视器内存位置之后的一个位置，ffffff 是 8Mb DRAM 的最后一个内存位置（后一个数字可以根据可用的 DRAM 内存而变化）。从 0 开始的 DRAM 将被修改为包含：-

    00: 0x3C1A9FC0   [ lui k0,0x9fc0 ]
    
    04: 0x3C1B3C1A   [ lui k1,0x3c1a ]
    
    08: 0xAC1B0000   [ sw  k1,(zero) ]
    
    0C: 0x3C01A000   [ lui at,0xa000 ] 

    位置 0 是重启伪中断处理程序的开始位置。然后，在恢复供电后使用 x004 命令来检查此位模式。重要的是，提供给 x003 的参数与提供给 x004 的参数完全相同。任何检测到的不同的字都会被打印出来，如果没有差异，则不打印任何内容（但会打印下一个提示符）。
  
  
• 注意：作为执行上述重启伪中断处理程序以恢复供电的副作用，位置 0 将被修补为 0x3C1A0000，以防止内存测试和自动启动主 raid 代码。可以通过在位置 0 中存入 0 来重新启用此功能（即 `pl 0 0`）。

3.9.78  RRSTRACE - 反汇编 scsihpmtr 监视器数据

• 概要：rrstrace -f monitor_file [-b bcnt] [-v]
• 描述：rrstrace 将反汇编由 scsihpmtr 收集的监视数据，这些数据已通过 ssmon 传输到主机。rrstrace 还将分析所有 scsi 读取，并查找读取序列并报告它们。此重复序列称为“自然读取”。然后，此数据可用于更优地配置 raid。自然读取通过起始块大小、自然读取的总长度（以块为单位）、构成自然读取的读取次数以及它发生的次数来报告。最后，打印找到的自然读取次数以及查找的次数和实际存在的次数。默认情况下，可以扫描最多 256 个不同的自然读取，但如果需要更多，则可以给出 -b bcnt 选项来分配更深层次的搜索。请注意，仅发生一次的自然读取会被记录下来，但不会打印出来。
• 选项
  • -f monitor_file：指定要从中读取数据的文件名
  • -b bcnt：指定更大的自然读取分析计数
  • -v：打开详细模式，从而打印出每个 scsi 指令。在详细模式下，rrstrace 的每行输出的格式为 time chipno lun ssid msg_id tag command，其中
    • time：是命令发生的时间
    • chipno：是命令传入的芯片编号（主机端口）
    • lun：是命令定向到的目标 lun
    • ssid：是发起者（即主机）的 scsi id
    • msg_id：是命令的 scsi 消息 id
    • tag：是命令的 scsi 标签号，如果没有标签关联，则为 -1
    • command：是以文本形式表示的 scsi 命令本身，如果 rrstrace 未知，则将打印 12 字节的 scsi 命令块。对于读取和写入命令，将打印块地址和长度，以及下一个顺序读取/写入命令的块地址（如果下一个命令是顺序的，则此地址用括号括起来）。如果命令设置了“强制单元访问”位，则 FUA 将附加到行尾。scsi Read_6、Write_6、Read_10 和 Write_10 命令将分别打印为 R6、W6、R10 和 W10。
• 另请参阅：ssmon, scsihpmtr

3.9.79  RSIZE - 估计给定 raid 集的内存使用量

• 概要：rsize type cachesize iosize nbackends
• 描述：rsize 打印运行中的 raid 集将使用的内存量（以字节为单位）的估计值，给定 raid 集类型、分配给它的缓存量、raid 集 iosize 和 raid 集中的后端数量。
• 另请参阅：rconf

3.9.80  SCN2681 - 将 scn2681（串行 IO 设备）作为控制台访问

• 概要：bind -k {scn2681 [ value ]} bind_point
• 描述：scn2681 允许通过 K9 命名空间中的 bind_point 访问使用 SCN2681 串行 IO 芯片的目标硬件。如果没有给出可选参数，则使用芯片中的通道 A。如果 value 为 0，则使用通道 A（串口）。如果 value 为 1，则使用通道 B（串口）。如果 value 为 2，则使用输入端口（并行）。如果 value 为 3，则使用输出端口（并行）。特殊文件 scn2681 仅在目标是特殊硬件（包含 SCN2681）时可用。
• 另请参阅：cons

3.9.81  SCSICHIPS - 打印有关控制器 scsi 芯片的各种详细信息

• 概要：scsichips
• 描述：scsichips 打印有关 RaidRunner scsi 芯片的详细信息。
• 选项：打印三组数字。前两个数字是主机端口（芯片）的数量和后端通道（芯片）的数量。打印的其余数字是主机端口，然后是后端通道芯片索引。芯片地址可用于将它们绑定到内核中的入口点。
• 示例
  
  对于具有一个主机端口和六个后端通道的 RaidRunner 控制器，scsichips 将打印

  1 6 6 0 1 2 3 4 5

  这表示有 1 个主机端口芯片，6 个后端通道，主机端口芯片的地址为 6，后端通道芯片的地址为 0、1、2、3、4 和 5。
  
  对于具有两个主机端口和六个后端通道的 RaidRunner 控制器，scsichips 将打印

  2 6 6 7 0 1 2 3 4 5 

  这表示有 2 个主机端口芯片，6 个后端通道，主机端口芯片的地址为 6 和 7，后端通道芯片的地址为 0、1、2、3、4 和 5。
  
  
• 另请参阅：hwconf, scsihpfs, scsihdfs

3.9.82  SCSIHD - SCSI 硬盘设备（SCSI 发起器）

• 概要
  
  bind -k {scsihd chipNumber scsiTargetId
  
  [scsiTargetLUN]} bind_point
  
  cat bind_point
  
  ctl
  
  raw
  
  partition
  
  data
  
  rconfig
  
  
• 描述：scsihd 是 SCSI 硬盘设备。在 SCSI 术语中，它被称为“发起器”，而与其通信的磁盘被称为“目标”。该磁盘在 SCSI 中被称为“直接访问设备”。当前，此设备采用 SCSI id 7，并尝试访问 SCSI id 为 scsiTargetId 的磁盘。在 scsiTargetId 中访问的“逻辑单元号”（LUN）是 scsiTargetLUN（如果未给出，则为 LUN 0）。支持多个 SCSI 总线（通常每个总线一个设备），并通过 chipNumber 来区分。
  
  SCSI 磁盘设备绑定到 bind_point 处的命名空间中。在 bind_point 处创建一个一级目录，其中包含文件：“raw”、“data”、“partition”、“rconfig”和“ctl”。“partition”文件是磁盘末尾的一小部分，用于存储分区信息（纯 ASCII 格式）。“ctl”和“rconfig”文件供 RaidRunner 内部使用。（“rconfig”文件将是 RaidRunner 配置区域的备份副本）。“data”文件是连接到此设备作为发起器的 SCSI 总线上的 SCSI 磁盘上可用空间的可使用部分（即绝大部分）。文件“raw”寻址整个磁盘，但不包括分区块。
  
  当前的 raid 硬件具有六个快速宽 SCSI-2 总线（编号为 0 到 5）和两个快速宽总线（编号为 6 和 7）。通常，前六个快速宽 SCSI-2 总线设置为发起器（即 bind scsihd），而两个快速宽 SCSI 总线设置为目标（即 bind scsihp）。
  
  当前的实现使设备名称 hd 与 scsihd 同义。因此
  
  bind -k {hd chipNumber scsiTargetId
  
  [scsiTargetLUN]} bind_point 具有与概要中类似行相同的效果。
  
  
• 另请参阅：scsihp

3.9.83  SCSIHP - SCSI 目标设备

• 概要
  
  bind -k {scsihp chipNumber scsiid} bind_point
  
  cat bind_point
  
  scsiid # 此设备的 scsi id
  
  cat bind_point/scsiid
  
  0
  
  ... # 此设备在 SCSI id scsiid 中的 LUN
  
  7
  
  cat bind_point/scsiid/0
  
  data # SCSI id scsiid LUN 0 的 scsi 数据通道
  
  cmnd # SCSI id scsiid LUN 0 的 scsi 命令通道
  
  
• 描述：scsihp 是 SCSI 目标设备。在 SCSI 术语中，“目标”执行由“发起器”（通常是通用计算机）发出的命令。通常，SCSI 目标是“直接访问设备”（即磁盘）的组成部分，但在 raid 中，控制器需要看起来像外部用户的目标。支持多个 SCSI 总线（通常每个总线一个设备），并通过 chipNumber 来区分。
  
  SCSI 目标设备绑定到 bind_point 处的命名空间中。在 bind_point 处创建一个三级目录。第一级是此设备的 SCSI id（由 scsiid 指定）。第二级是该 scsi id 中的 LUN。第三级包含文件：“data”和“cmnd”，它们分别用于 SCSI 数据阶段和命令/状态阶段。
  
  一个名为 stargd 的 scsi 目标命令解释器旨在与此设备“配合使用”。
  
  当前的 raid 硬件具有六个快速窄 SCSI 总线（编号为 0 到 5）和两个快速宽总线（编号为 6 和 7）。通常，六个快速窄 SCSI 总线设置为发起器（即 bind scsihd），而两个快速宽 SCSI 总线设置为目标（即 bind scsihp）。
  
  
• 另请参阅：scsihd, stargd

3.9.84  SET - 设置（或清除）环境变量

• 概要
  • set name
  • set name value ...
• 描述：set 允许更改与环境变量关联的值（或值列表）。当没有给出值时，环境变量 name 的值设置为 NIL。当给出一个值时，环境变量 name 设置为该值。当给出多个值时，环境变量 name 设置为该值列表。
• 注意：set 是 Husky shell 中的“内置”命令。这意味着除非有其他操作强制执行，否则不会抛出新的 shell 来执行此命令。在子 shell 中设置环境变量在子 shell 退出到其父 shell 后无效。这就是抛出子 shell 来执行 set 是毫无意义的原因。命令替换（即 `set ...'）和命令行文件重定向等操作强制命令在子 shell 中执行，从而破坏了 set 的目的。因此，set 命令（或至少“内置”命令）应出现在简单表达式中，以避免意外。

3.9.85  SCSIHPMTR - 开启主机端口调试

• 概要
  • scsihpmtr -c portnumber storage_size
  • scsihpmtr -b
  • scsihpmtr -d
  • scsihpmtr -e
  • scsihpmtr -p count
  • scsihpmtr -r
  • scsihpmtr -w
• 描述：scsihpmtr，如果在 RaidRunner 内核中启用，将创建一个易失性内部存储区，并保存指定主机端口或一组主机端口上所有传入 scsi 命令的详细信息。然后，可以通过 scsi 监视器 (ssmon) 将此数据上传到主机并进行适当的分析。
• 选项
  • -c portnumber storage_size：指定并分配一个 storage_size 字节的易失性存储区域，并监视和保存给定 portnumber 上出现的所有 scsi 命令。portnumber 是 raid 控制器上主机端口的芯片编号。如果指定端口号为 8，则将监视所有主机端口。
  • -b：执行自然读取分析，用于可能重新配置 RaidRunner。
  • -d：删除任何包含监视数据的易失性存储区，从而停止监视。
  • -e：暂时禁用 scsi 命令的监视（以及存储）。必须在通过 ssmon 将监视数据上传到主机之前禁用监视。
  • -p count：打印正在监视的内容的详细信息和第一个计数的已存储 scsi 命令。打印的详细信息是可以记录的命令总数、当前记录的命令数、当前监视状态（0 禁用，1 启用）和监视的主机端口号。打印的每行 scsi 命令都将记录命令发生的时间，一个十六进制字，其中包含低 3 位，命令所在芯片编号（主机端口），接下来 3 位，命令发起者（即主机）的 scsi id，下一个字节是命令的 scsi 消息 id，接下来的两个字节是命令的 scsi 标签号，一个 12 字节的 scsi 命令头块。
  • -r：重置 scsi 命令的监视。这将导致所有先前监视的数据丢失。
  • -s：重新启用 scsi 命令的监视（以及存储）。
  • -w：启用环绕模式。默认情况下，scsihpmtr 将在用完所有已分配的存储区域后停止记录 scsi 命令。如果启用环绕模式，则 scsi 命令将继续被记录，并在存储区域中环绕。
• 另请参阅：smon, ssmon, SCSI 标准，了解 scsi 命令的格式。

3.9.86  SETENV - 设置全局环境变量

• 概要：setenv name value ...
• 描述：setenv 允许更改（或创建）与全局环境变量关联的值（或值列表）。当给出一个值时，全局环境变量名将被设置为该值。当给出多个值时，全局环境变量名将被设置为该值列表。
• 注意：全局环境变量是指存储在 RaidRunner 上的非易失性区域中的变量，因此在连续的电源循环或重启之间可用。这些变量与 husky 环境变量不同。非易失性区域与 RaidRunner 配置区域位于同一位置。
• 另请参阅：printenv, unsetenv, rconf

3.9.87  SDLIST - 设置或显示连接磁盘驱动器的内部列表

• 概要
  • sdlist
  • sdlist -p
  • sdlist backend_triplett_list
• 描述：sdlist 维护 RaidRunner 的磁盘后端列表，格式为 rank、chip、scsi lun。此列表供各种命令使用，以避免这些命令持续探测所有可能的后端。当不带参数运行时，sdlist 将内部列表清零，并探测所有磁盘后端，重建列表。通常，sdlist 将在提供参数列表的情况下运行。例如，在具有一个 rank（scsi id 为 1）和六个磁盘（所有 lun 均为零）的 RaidRunner 上，将运行以下命令。

  sdlist `hwconf -D'`

  这等同于

  sdlist 0.1.0 1.1.0 2.1.0 3.1.0 4.1.0 5.1.0

  这些六个三元组将被存储在列表中，sdlist 已删除任何已存储的列表。要查看此内部列表包含的内容，可以提供 -p 选项，列表将被打印出来。此命令通常在自动启动期间执行，除非用户正在执行不寻常的后端操作并调试该过程，否则不会以交互方式执行。
  
  
• 另请参阅：rconf

3.9.88  SETIV - 设置内部 RaidRunner 变量

• 概要
  • setiv
  • setiv name value
• 描述：setiv 允许更改内部 RaidRunner 变量的值，或列出所有可更改的内部变量（无参数）。当给出值时，内部 RaidRunner 变量名将被设置为该值。如果未给出值，则列出所有可设置的内部变量。
• 注意：由于不同型号的 RaidRunner 具有不同的可设置内部变量，请参阅您的 RaidRunner 硬件参考手册，了解变量列表以及更改它们的效果。这些变量是运行时变量，因此每次启动 RaidRunner 都必须设置。
• 另请参阅：getiv

3.9.89  SHOWBAT - 显示有关电池备份 ram 的信息

• 概要：showbat [-a] [-n] [-s] [-t]
• 描述：showbat 将打印（到标准输出）有关已安装的电池备份 ram 的信息。
• 选项
  • -a：打印有关电池备份 ram 的地址信息。打印的地址是基地址、标签地址的起始地址、保留区域地址的起始地址、缓存数据地址的起始地址以及第一个未使用的字节地址。
  • 如果没有给出选项，这是默认选项。
  • -n：打印电池备份 ram 中的标签数量。
  • -s：打印电池备份 ram 的状态。
  • -t：对于电池备份 ram 中的每个标签，打印其值和其数据的位置，以及其所属的缓存范围的详细信息。如果尚未创建缓存文件系统并且尚未添加范围，则此选项将仅打印标签地址，并告知您没有可用范围。如果与标签关联的数据中包含部分写入的数据，则该标签将在列表中标记。
• 另请参阅：cachedump, cacherestore, cacheflush

3.9.90  SHUTDOWN - 将 RaidRunner 置于关机或静止状态的脚本

• 概要：shutdown
• 描述：shutdown 是一个 husky 脚本，用于将 RaidRunner 置于“关机”或静止状态。“关机状态”是指主机无法访问配置的 raid 集的状态，并且连接到 RaidRunner 的所有设备（磁盘）都处于低功耗状态（即停止旋转）。shutdown 首先将所有 stargd 设置为 spin 状态 2，这意味着所有主机 scsi 介质访问命令都将导致 CHECK CONDITION 状态，并将模式感应键设置为 NOT READY，并将附加模式感应代码和代码限定符设置为“LOGICAL UNIT NOT READY, MANUAL INTERVENTION REQUIRED”。然后它将刷新缓存，最后停止所有连接的后端设备的旋转。请注意，scsi 监视器 - smon，不受影响。
• 另请参阅：stargd, mstargd, cache, spind

3.9.91  SLEEP - 休眠给定的秒数

• 概要：sleep seconds
• 描述：sleep 使当前 K9 进程“休眠”给定的秒数。参数 seconds 可以是任何整数或定点数（例如 1.5）。定时的分辨率为一个时钟滴答（根据目标硬件而变化）。如果在完成之前睡眠被中断，则返回“sleep interrupted”状态消息，否则返回 NIL（即 true）。
• 另请参阅：K9sleep

3.9.92  SMON - RaidRunner SCSI 监视器守护进程

• 概要：smon [-b blkprotocol] [-d debug_level] -m moniker -h hport [-n] [-r] [-1 stdout_fifo_file] [-2 stderr_fifo_file] [-3 status_file] -s capacity device id lun
• 描述：smon 是一个守护进程，它模拟一个 SCSI-2 磁盘，具有修改后的 Read 和 Write SCSI 命令，这些命令实现了一个简单的协议，该协议提供与 RaidRunner 的文件传输以及在 RaidRunner 上执行远程命令。该协议基于 SCSI Read 和 SCSI Write 起始块地址。smon 通常与一个特殊设备（文件系统）紧密合作，该设备（文件系统）为 SCSI-2 目标执行硬件接口和消息解释（请参阅 scsihp）。
  
  smon 有 3 个必需的开关，8 个可选开关和 3 个必需的位置参数。必需的开关是 -s 开关，它指定 SCSI-2 监视器存储的大小；-m 开关，它指定目标的别名（名称）；以及 -h 开关，它指定监视器将通过其进行通信的控制器主机端口。
  
  3 个必需的位置参数是 device、id 和 lun。这些参数连接在一起以构成底层 SCSI 目标设备驱动程序的文件名。第二个参数是此目标将响应的 SCSI 标识符编号，而第三个参数是该 SCSI 标识符中目标表示的逻辑单元号 (LUN)。除非找到以下文件（具有适当的特性），否则将在守护进程初始化期间发生错误
  • device/id/lun/cmnd
  • device/id/lun/data
• 选项
  
  可选开关可以以任何顺序出现，但如果存在，则必须在位置参数之前。
  
  
• -b blkprotocol：更改协议中使用的块号（见下文）。默认情况下，协议中使用的块号是 7、8、9 10、11、12、13、14 和 15，分别对应于协议元素 BLK_STDOUT、BLK_STDERR、BLK_STATUS、BLK_ENDPROC、BLK_UPLOAD、BLK_STDIN、BLK_MONITOR BLK_RESET 和 BLK_RCONFIG。要更改此默认块号列表，请指定一个以逗号分隔的九 (9) 个唯一块号列表。
• -d debuglevel：此开关是一个调试标志。当给出命令行参数和初始化期间派生的其他信息时，它们会回显到标准输出，并且调试级别设置为 1。调试级别为
  • 0 无调试消息（未给出“-d”时的默认值）
  • 1 所有非读/写命令的调试消息
  • 2 所有命令的调试消息
• 调试消息通常是每个命令一行，并发送到标准输出。严重的错误会报告给标准错误，而与当前的调试级别无关。如果错误与传入数据（来自 SCSI 发起程序）有关，则守护进程将继续。如果错误无法恢复，则守护进程将终止，并以错误消息作为其退出状态。可以在 smon 守护进程的执行期间使用 mstargd 上的“-d”选项更改调试级别。
• -m moniker：此开关将别名（即名称）与 smon 即将执行的 scsi 监视器关联。它提供了一种命名 scsi 监视器的方法。别名最多可以包含 32 个字符。此开关是必需的。
• -h hport：此开关告知 smon 它将通过哪个控制器主机端口号进行通信。此开关是必需的。
• -n：此开关停止收集统计信息。默认操作是收集统计信息。
• -r：此开关用于尽可能少地干扰发起程序的情况下重新启动守护进程。通常，SCSI 单元注意力状况在重置时（以及当此守护进程开始时）设置。当给出此开关时，守护进程以空闲状态启动。小心使用。默认操作（即当未给出“-r”时）是设置 SCSI 单元注意力状况，以便接收到的第一个 SCSI 命令将其状态作为“Check condition”返回（根据 SCSI-2 标准的要求）。
• -1 stdout_fifo_file：指定 fifo 数据文件的名称，任何执行命令的标准输出都将发送到该文件（并从中读取）。
• -2 stderr_fifo_file：指定 fifo 数据文件的名称，任何执行命令的标准错误输出都将发送到该文件（并从中读取）。
• -3 status_file：指定 fifo 数据文件的名称，任何执行命令的退出状态都将写入到该文件（并从中读取）。
• -s capacity：此必需的开关告知守护进程此 SCSI 目标将表示的块大小。容量值会影响此目标对 SCSI Read Capacity 和 Mode Sense（第 4 页）命令的响应。为了简化大数的写入，可以使用某些后缀，请参阅 suffix。
• 协议：smon 以具有给定容量、scsi id 和 scsi lun 的磁盘形式呈现给主机计算机。通过读取和写入此磁盘上的特定块位置，主机计算机可以发送并在 RaidRunner 上执行 husky 命令，并读取命令的标准输出、错误和状态。此外，文件可以从主机下载到 RaidRunner，也可以从 RaidRunner 上传到本地主机计算机。
  
  主机的所有读取和写入都需要是 512 字节块的倍数，并根据需要进行空填充。当 WRITEing（从主机）到 smon 时，写入中包含的数据将根据块号进行如下处理 -
  • BLK_ENDPROC：将终止任何由 smon 启动的、当前在 RaidRunner 上运行的进程。将读取写入数据的内容，但会被忽略。
  • BLK_RESET：将终止任何文件传输，终止任何进程（由 smon 启动的）、当前在 RaidRunner 上运行的进程，关闭任何由 smon 打开的文件，并将 smon 重置为其初始状态。将读取写入数据的内容，但会被忽略。
  • BLK_STDIN：如果 smon 处于 DOWNLOAD 文件传输模式，则写入数据的内容将写入到 RaidRunner 上的下载文件。如果未处于 DOWNLOAD 文件传输模式，则将异步执行写入的内容作为 husky 命令。在执行命令之前，将检查该命令是否是内部文件传输 smon 命令，如果是，则将初始化以进行文件传输。
  • 任何其他：将执行对内部存储的写入。最多 16 个数据块将存储在 raid 配置区域中。
  • 当 READing（由主机）从 smon 读取时，读取中包含的数据将根据块号进行如下处理 -
  • BLK_STDOUT：此读取将返回先前执行的命令的当前可用标准输出。如果标准输出的字节数小于读取数据的大小，则数据将用 NULL 字符（'\0'）填充。如果标准输出的字节数大于读取的大小，则后续从 BLK_STDOUT 的读取将传输其余的标准输出。通常，人们会循环从 BLK_STDOUT 读取，直到读取缓冲区中的最后一个字符为 NULL。如果之前的命令是写入以启动下载，则接下来将预期读取一个块，并且将返回 NULL 块或指示下载初始化出现问题的错误消息。
  • BLK_STDERR：此读取将以与 BLK_STDOUT 相同的方式返回先前执行的命令的当前可用标准错误输出。
  • BLK_ENDPROC：如果先前执行的命令（写入块 BLK_STDIN）尚未完成，则此读取将返回，其缓冲区以“Process not finished”开头并用 NULL 填充。如果命令已完成，则它将返回一个 NULL 填充的缓冲区。
  • BLK_STATUS：从此块的读取将返回命令的 husky 退出状态（$status 变量）。
  • BLK_UPLOAD：将首先返回 UPLOAD 握手命令（对 UPLOAD 写入命令的响应），其形式为 UPLOAD nbytes，其中 nbytes 是刚刚请求从 RaidRunner 上传的文件中的字节数，或者返回错误消息，然后从此块开始的所有读取将包含来自上传文件的下一个缓冲区。
  • BLK_MONITOR：将首先返回 MONITOR 握手命令（对 MONITOR 写入命令的响应），其形式为 MONITORSIZ nbytes，其中 nbytes 是需要传输到主机的监视器数据的字节数，如果没有任何监视数据，则返回错误消息。所有后续读取将上传监视数据。
  • BLK_RCONFIG：连续从此块读取数据将返回来自内存中 raid 配置区域的连续数据。当写入 BLK_RESET 时，内存中 raid 配置区域的内部 smon 索引将被重置（设置为 0）。当从此块读取多个 BLK_RCONFIG 时，此内部索引将按读取的数据量递增。如果读取的数据多于内存中 raid 配置区域中可用的数据，则索引将重置为 0。
  • 任何其他：将执行从内部存储的读取。
  • 内部存储：通常，主机计算机将标签、引导和磁盘分区信息存储在所有磁盘上。在大多数主机计算机上，它们通常仅将此信息存储在磁盘开头和/或磁盘末尾附近的几个块中。smon 没有将此空间保留为连续的内存块，其中大部分将不会被使用，而是创建了一个 16 个 512 字节块的内部存储，并维护主机块地址到存储的映射。此存储被复制到 raid 配置区域，并记录 smon 正在运行的控制器号和主机端口号。如果当主机计算机向 smon 磁盘写入许多块时存储已满，则会丢弃额外的数据。如果主机计算机尝试读取尚未存储的块，则会返回空填充数据。
• 信号
  
  smon 特别解释两个 K9 信号。
  • 如果收到信号 K9_SIGINT，则 smon 将检查是否有正在进行的命令，如果有，则以“Check condition”状态终止它，并将关联的 sense 键设置为“Command aborted”。然后 smon 将返回其命令（等待）模式。
  • 如果收到信号 K9_SIGTERM，则 smon 将执行与 K9_SIGINT 相同的操作，除了它将退出进程而不是进入命令（等待）模式。
  SCSI 发起程序应将 sense 键“Command aborted”解释为目标单方面中止正在进行的命令。SCSI-2 标准建议发起程序应重试中止的命令。
  
  
• 示例

  smon -s 2080 -h 1 -m SMON167 /dev/hostbus/1 6 7

  此行将调用此守护进程并尝试打开以下文件

  /dev/hostbus/1/6/7/cmnd

  和

  /dev/hostbus/1/6/7/data

  “-s 2080”开关指示此守护进程告诉 SCSI 发起程序它是一个 1040K 磁盘。
  
  
• 另请参阅：scsihp, suffix, mstargd, stargd, mconf

3.9.93  SOS - 脉冲蜂鸣器以发出 sos 信号

• 概要：sos [count]
• 描述：sos 将以哀怨的 Morse 码“SOS”发出蜂鸣声。如果给出计数，它将重复计数次数。默认计数为 3。
• 另请参阅：buzzer, warble

3.9.94  SPEEDTST - 生成一组顺序写入，然后读取

• 概要：speedtst -d device -n io_cnt -X bufsize [-o offset] [-STRW]
• 描述：默认情况下，speedtst 将从设备的开头开始，对设备执行 io_cnt 次大小为 bufsize 字节的顺序写入。然后，它将从设备 device 的开头开始，执行 io_cnt 次大小为 bufsize 字节的顺序读取。默认情况下，不检查读取和写入是否成功。此命令的输出提供了写入和读取序列的 I/O 传输速率，单位为兆字节 (MB) 和百万字节 (mb)。bufsize 和 offset 值可能带有后缀。
• 选项
  • -o offset：所有读取和写入都将在设备中偏移 offset 字节的位置执行。所有报告的值都将相对于此偏移量。默认值为 0，即设备的开头。
  • -r drives：bufsize（由 -X bufsize 设置）预计是 Raid 5 raid 集的 iosize，其中 drives 是数据和奇偶校验驱动器的数量。单个 bufsize 操作将以这样一种方式对 raidset 的每个条带中的驱动器执行，即数据驱动器和奇偶校验驱动器（写入操作中仅写入的两个驱动器）将与如果先前条带上的先前操作是写入操作时将被写入的驱动器不同。默认值为 0，导致正常的顺序操作。此选项用于模拟 raidset 上的随机操作，而不会产生显着的寻道开销。
  • -R：默认情况下，speedtst 将执行写入测试，然后执行读取测试。指定此选项，将不执行写入测试。
  • -S：通常，设备 device 以默认方式打开，这可能允许主机操作系统在将数据写入设备时提供缓冲区。这可能会导致不正确的 I/O 吞吐量。通过设置此选项，设备将以确保写入不使用任何缓冲的方式打开，并且在数据到达设备之前，各个写入系统调用不会返回。
  • -T：通常，读取和写入操作不会检查是否成功，即不检查读取和写入系统调用的返回值是否出错。要确保检查每个读取和写入是否存在任何系统错误，请使用此标志。
  • -W：默认情况下，speedtst 将执行写入测试，然后执行读取测试。指定此选项，将不执行读取测试。
• 另请参阅：randio, suffix

3.9.95  SPIND - 启动或停止磁盘设备

• 概要
  • spind up c.s.l
  • spind down c.s.l
• 描述：spind 将通过 SCSI-2 START 命令启动或停止指定的磁盘驱动器。
• 选项
  • up：启动磁盘驱动器。如果驱动器已启动，则不会发生任何事情。
  • down：停止磁盘驱动器。如果驱动器已停止，则不会发生任何事情。
  • c.s.l：通过指定磁盘设备的通道、SCSI ID（rank）和 SCSI LUN（格式为“c.s.l”）来标识磁盘设备
• 另请参阅：RaidRunner 中使用的磁盘驱动器的产品手册。

3.9.96  SPINDLE - 修改磁盘设备上的主轴同步

• 概要
  • spindle -c -p c.s.l [-o rpl_offset]
  • spindle -m|M -p c.s.l [-o rpl_offset]
  • spindle -s -p c.s.l [-o rpl_offset]
  • spindle -g -p c.s.l
• 描述：spindle 将修改或报告磁盘设备的主轴同步。此命令将在磁盘设备的 GeometryParameter 模式感应页中设置或清除旋转位置锁定 (RPL) 位。如果 spindle 正确修改了设备的 RPL 位，它将打印出生成的 RPL 位和设备的 Geometry Parameter 模式感应页的旋转偏移字节。
• 选项
  • -p c.s.l：通过指定磁盘设备的通道、SCSI ID（rank）和 SCSI LUN（格式为“c.s.l”）来标识要修改的磁盘设备
  • -c：清除 RPL 位。
  • -s：将 RPL 位设置为 01b (0x1)，这通常将设备设置为作为同步主轴从设备运行。
  • -m：将 RPL 位设置为 10b (0x2)，这通常将设备设置为作为同步主轴主设备运行。
  • -M：将 RPL 位设置为 11b (0x3)，这通常将设备设置为作为同步主轴主控制设备运行。
  • -g：获取并打印设备的 Geometry Parameters Page 中的当前 RPL 位和旋转偏移字节。
  • -o rpl_offset：在清除 (-c) 或设置 (-m, -M, -s) 主轴同步时，另外将旋转偏移设置为给定值。必须在 0 到 256 的范围内。此值是一个分数乘数的分子，其分母为 256（例如，值 128 表示半转偏移）。值零 (0) 表示不应使用旋转偏移。
• 另请参阅：RaidRunner 中使用的磁盘的相关产品手册中的模式感应几何页面参考。

3.9.97  SRANKS - 设置控制器的可访问后端 rank

• 概要：sranks controller_id:ranklist [controller_id:ranklist]
• 描述：sranks 允许您为命令设置的控制器设置后端 rank 限制，如参数指定的那样。每个参数的形式为
  
  controller_id 控制器的 ID (0, 1, ...)。
  
  ranklist 以逗号分隔的 rank ID（scsi ID）列表，给定控制器将有权访问这些 rank ID。sranks 将检查每个参数，查找与其正在运行的控制器相对应的控制器 ID，并根据 ranklist 设置后端 rank 访问权限。通常，此命令在启动时使用 BackendRanks GLOBAL 环境变量的输出执行。
  
  
• 另请参阅：environ, pranks

3.9.98  STARGD - SCSI-2 目标守护进程

• 概要：stargd [-c] [-d] -m moniker -h hport -s capacity [-n] [-r] [-L cnt] [-P nprocs] [-R] [-S sectorsize] [-nr nrread:nrlen] [-C] [-stripesize stripesize] [-irgap nblks] [-stripe stripe_args] device id lun store [store2]
• 描述：stargd 是一个守护进程，它将 SCSI-2 命令解释为“目标”。[在简单的 SCSI 配置中，主机计算机是 SCSI“发起程序”，而其磁盘是 SCSI“目标”。] stargd 通常与一个特殊设备（文件系统）紧密合作，该设备（文件系统）为 SCSI-2 目标执行硬件接口和消息解释（请参阅 scsihp）。当 stargd 首次启动时，其“spin 状态”设置为指示 store 文件尚未“启动”，因此处于 NOT READY 状态。这意味着，在 spin 状态更改为标记为 READY（通过 mstargd “-o”选项）之前，所有受支持的 SCSI-2 介质访问命令都将导致 CHECK CONDITION，sense 键设置为“NOT READY”，附加 sense 信息设置为“LOGICAL UNIT IN PROCESS OF BECOMMING READY”。当 spin 状态标记为 READY 时，所有受支持的 SCSI-2 介质访问命令都将得到正确处理。可以使用 mstargd 的 -Z 选项设置其他 NOT READY 状态。
• 选项：stargd 有 3 个必需的开关，8 个可选开关和 4 个必需的位置参数以及一个可选的尾随位置参数。必需的开关是 -m 开关，它将别名（即名称）与 stargd 即将执行的 raid 集关联（这提供了一种命名 raid 集的方法），-c 开关，它指定后端的容量，以及 -h 开关，它告知 stargd 它将通过哪个控制器主机端口进行通信。4 个必需的位置参数是 device、id、lun 和 store。前 3 个参数连接在一起以构成底层 SCSI 目标设备驱动程序的文件名。
  • 第二个参数是此目标将响应的 SCSI 标识符编号，而第三个参数是该 SCSI 标识符中目标表示的逻辑单元号 (LUN)。除非找到以下文件（具有适当的特性），否则将在守护进程初始化期间发生错误
    
    device/id/lun/cmnd
    
    device/id/lun/data
    
    
  • 第四个位置参数是 store。它通常是缓存设备，尽管它可以是单个磁盘或 raid 级别。尾随可选位置参数是 store2。如果可以打开文件名 store2 并且未给出“-c”参数，则对 store 的写入将回显到 store2。在此级别引起写入的 SCSI 命令是 Write_6 和 Write_10。如果无法打开 store2（用于写入）或给出了“-c”参数，则在 stargd 初始化期间会输出警告消息，并且它会继续，就好像未给出 store2 一样。
  • 所有开关可以以任何顺序出现，但如果存在，则必须在位置参数之前。
  • “-L cnt”开关指示 stargd 将为 SCSI-2 读取（Read_6 和 Read_10）实现预读进程，该进程基于最后 cnt 个 SCSI-2 读取将数据预取到缓存中。默认预读为 16 次读取（即 -L 16）。最小预读为 2，最大预读为 63。您可以将预读指定为 0，这将关闭所有预读。此开关只能在使用缓存 (-c) 时使用。“-nr nread:nrlen”用于向 stargd 指定“自然读取”信息。某些应用程序可能会执行大小大于主机操作系统允许的最大读取大小的读取。在这种情况下，主机操作系统会将应用程序的读取分解为较小的读取。stargd 可以通过指定块大小 (nread) 来触发某个不连续读取，并将预取应用程序读取的其余部分 (nrlen)。例如，如果应用程序在最大读取大小为 128 块的主机操作系统上执行 304 块的读取，则可以将 -nr 参数 nread:nrlen 设置为 128:304，这将导致 stargd 在看到大小为 128 块的不连续读取时，服务于读取，并将接下来 304 - 128 = 176 块的数据预取到缓存中。请参阅 scsihpmtr 以分析主机操作系统的读取。
  • “-stripesize stripesize”开关告知 stargd stargd 前端的 raid 集的条带大小。如果附加的 -C 开关切换是否将使用此值 (stripesize) 来计算柱面大小（磁头数 x 每磁道扇区数），以确保柱面是给定条带大小的倍数。如果条带大小使得没有磁头和扇区的倍数，当它们相乘时，不是条带大小的倍数，则使用默认的磁头和每磁道扇区大小 - 当前为 16 个磁头，每磁道 128 个扇区。
  • “-stripe stripe_args”开关告知 stargd 多个主机端口将并发访问此 raid 集。仅当基于主机的磁盘访问软件可以将 i/o “条带化”到 N 个不同的设备，并且每次访问（读取或写入）始终小于设置的条带大小时，此开关才有用。
  • stripe_args 的形式为 N:S:I=c.h.l,I=c.h.l,，其中：N 是将并发访问 raid 集的条带（或主机端口）的数量，S 是主机将执行 i/o 的条带大小（以 512 字节块为单位），I 是索引或“条带编号”说明符，范围为 0 到 N。c.h.l 是与给定索引关联的控制器、主机端口、lun 三元组。例如，如果我们有两个主机端口，并且来自主机的给定条带大小为，例如，1368 个块，那么我们将有以下 raid
    设置添加（以 agui 形式）
    主机接口 (2)：M 0.0.0 M 0.1.0
    附加 stargd 参数：-stripe 2:1368:0=0.0.0,1=0.1.0
    注意：必须保证主机条带软件会将块 0（大小为 1368 或更小）发送到控制器、主机端口、lun 三元组 0.0.0 和块 1（大小为 1368 或更小）控制器、主机端口、lun 三元组 0.1.0，块 2（大小为 1368 或更小）到控制器、主机端口、lun 三元组 0.0.0，依此类推。
    
  • “-C”开关用于切换 stargd 是否计算柱面大小，使其成为给定条带大小的倍数。默认值是根据给定的条带大小计算柱面大小。
  • “-irgap nblks”开关，指定读取间隔 nblks（以块为单位）。当主机发出顺序读取时，连续读取之间可能存在一个小间隙。通常，预读算法会忽略这些间隙，前提是它们不大于已发生的一组顺序读取的平均长度。通过指定此值，您可以增加此间隙。如果关闭预读功能（即指定“-L 0”），则此开关没有意义。
  • “-R”开关指示 store 应该具有只读访问权限。如果未出现此开关，则假定 store 具有读写访问权限。
  • “-c”开关指示 store 是缓存（而不是磁盘或其他远程设备）。此知识减少了此守护进程需要执行的内部副本数量，因此是一种性能增强。默认值（即，当不存在此开关时）是执行额外的副本，如果 store 的确切身份不确定，这是安全的做法。
  • “-d”开关是一个调试标志。当给出命令行参数和初始化期间派生的其他信息时，它们会回显到标准输出，并且调试级别设置为 1。调试级别为
    • 0 无调试消息（未给出“-d”时的默认值）
    • 1 所有非读/写命令的调试消息
    • 2 所有命令的调试消息
    调试消息通常每命令一行，并发送到标准输出。 无论当前调试级别如何，都会将严重错误报告给标准错误。 如果错误与传入数据（来自 SCSI 启动器）相关，则守护进程将继续运行。 如果错误无法恢复，则守护进程将终止，并在其退出状态中显示错误消息。 可以通过在 mstargd 上使用“-d”选项，在 stargd 守护进程执行期间更改调试级别。
    
    
  • “-m”开关将别名（即名称）与 stargd 即将执行的 RAID 组关联起来。 它提供了一种命名 RAID 组的方法。 别名最多可以包含 32 个字符。 此开关是强制性的。
  • “-h”开关告知 stargd 它将通过哪个控制器主机端口进行通信。 此开关是强制性的。
  • “-n”开关切换统计信息收集。 默认操作是收集统计信息。
  • “-r”开关用于尽可能少地干扰启动器的情况下重启守护进程。 通常，SCSI 单元注意力条件在重置时（以及当此守护进程启动时）设置。 当给定此开关时，守护进程在空闲状态下启动。 请谨慎使用。 默认操作（即，当未给出“-r”时）是设置 SCSI 单元注意力条件，以便接收到的第一个 SCSI 命令将其状态返回为“检查条件”（根据 SCSI-2 标准的要求）。
  • “-s 容量”开关告知守护进程此 SCSI 目标将表示的块大小。 容量值会影响此目标对 SCSI 读取容量和模式感应（第 4 页）命令的响应。 此开关是强制性的。 为了简化大数的书写，可以使用某些后缀，请参阅后缀。
  • “-P nprocs”开关使守护进程生成 nprocs 个自身的副本，以允许并发处理 SCSI 命令。 如果未指定，则创建的 stargd 进程的默认数量为 4。 此值范围可以从 1 到 8（包括 1 和 8）。 在首次从主机端口访问之前，不会创建额外的进程。 “-S sectorsize”开关告知守护进程此 SCSI 目标将呈现的扇区大小（以字节为单位）。 该值默认为 512 - 典型的磁盘块大小。 为了简化大数的书写，可以使用某些后缀，请参阅后缀。
• 信号：stargd 特殊解释两个 K9 信号。
  • 如果收到信号 K9_SIGINT，则 stargd 将检查是否有正在进行的命令，如果有，则以“检查条件”状态终止该命令，并将相关的错误码设置为“命令中止”。 然后，stargd 将返回到其命令（等待）模式。
  • 如果收到信号 K9_SIGTERM，则 stargd 将执行与 K9_SIGINT 相同的操作，只是它将退出进程，而不是进入命令（等待）模式。
  • SCSI 发起程序应将 sense 键“Command aborted”解释为目标单方面中止正在进行的命令。SCSI-2 标准建议发起程序应重试中止的命令。
• 示例

  stargd -c -s 2M -m RS -h 1 /dev/hostbus/1 6 0 /cache/data

  此行将调用此守护进程并尝试打开以下文件

  /dev/hostbus/1/6/0/cmnd

  和

  /dev/hostbus/1/6/0/data

  文件“/cache/data”将用作存储。 “-c”开关将此文件 ID 标识为 stargd 的缓存。 “-s 2M”开关指示此守护进程告知 SCSI 启动器它是一个 1 千兆字节的磁盘（即 2 兆块）。
  
  
• 支持的 SCSI-2 命令：下表列出了支持的 SCSI-2 命令（代码和名称）及其在 stargd 下的操作。

• 另请参阅：scsihp、suffix、mstargd

3.9.99  STAT - 获取指定文件（或标准输入）的状态信息

• 概要：stat [-b] [文件...]
• 描述：stat 获取每个给定文件或标准输入（当给定名为“-”的文件时）的状态信息，并将其发送到标准输出。 对于找到的文件，将输出包含 6 列的行。 下面总结了每列的含义
  • 第 1 列 文件名
  • 第 2 列 包含此文件的文件系统类型
  • 第 3 列 包含文件系统的实例
  • 第 4 列 唯一的（内部）文件标识符
  • 第 5 列 此文件的版本号
  • 第 6 列 此文件的长度（以字节为单位）
• 如果给出 -b 选项，则每个文件的长度（第 6 列）以 512 字节的块为单位打印。 仅报告完整的块，因此长度小于 512 字节块的文件将报告块大小为零 (0)。
• 示例

• 另请参阅：K9getstat、intro

3.9.100     STATS - 打印 RAID 组或缓存范围的累积性能统计信息

• 概要：stats [-c cache_moniker] [-r raid_set] [-g] [-z]
• 描述：stats 是一个进程，它将打印和/或清零 RAID 组和缓存范围维护的累积性能统计信息。
• 选项
  • -c cache_moniker：清零 (-z) 和/或打印 (-g) 由 cache_moniker 指定的缓存范围的缓存统计信息，cache_moniker 是在 add moniker=cache_moniker first= ... 命令中设置的（请参阅 cache）。 打印的统计信息是缓存命中数、缓存未命中数、每次命中的缓存探测数和每次未命中的探测数。 输出格式如下
  moniker : 命中数+未命中数 命中数 未命中数 命中+未命中探测数 命中探测数 未命中探测数
  • r raidset_name：清零 (-z) 和/或打印 (-g) 由 raidset_name 指定的 RAID 组的 RAID 组统计信息。 当打印 (-g) 统计信息时，对于 RAID 组中的每个后端，将打印该后端的累积读取次数、写入次数、RAID 故障次数和写入故障次数。 输出格式如下
  D0 r0_cnt r0_fails w0_cnt w0_fails; D1 r1_cnt r1_fails w1_cnt w1_fails; D...;
  
  
• 通用：当收集（或清零）缓存范围的统计信息时，会对 RaidRunners 缓存进行特殊的系统调用。 当收集（或清零）RAID 组的统计信息时，会对 raid_bind_point/stats 控制文件进行读取或写入（控制字符串“zerostats”）。
• 另请参阅：cache、raid0、raid1、raid3、raid5

3.9.101     STRING - 对给定值执行字符串操作

• 概要：string 选项 值
• 描述：string 提供对给定值（被视为字符串）的各种字符串类型操作。 选项包括 length、range 和 split。
• 选项
  • length string：length 选项返回给定字符串中的字符数。
  • range string first last：range 选项返回给定字符串中位于 first 和 last 给出的索引之间的子字符串。 索引 0 指的是字符串中的第一个字符。 如果 last 超出字符串的长度，则它将变为字符串中最后一个字符的索引。 如果 first 小于 last，则子字符串将向后提取。
  • split string split_ch：split 选项会将给定字符串中每次出现的字符 split_ch 替换为空格。
• 示例： 一些简单示例

3.9.102     SUFFIX - 某些大十进制数允许的后缀

• 描述：在某些可以将大十进制数作为参数的命令中，允许使用某些后缀。 后缀是单个字母字符，必须紧跟在其限定的十进制数之后。 字母字符可以是大小写。 负数不能有后缀。
  
  接受的后缀是
  • w：将数字乘以 2
  • b：将数字乘以 512
  • k：将数字乘以 1024
  • m：将数字乘以 1048576
  • g：将数字乘以 1073741824
  结果数字必须适合 32 位无符号数，这意味着可以表示“3G”（== 3,221,225,472），但不能表示“4G”。 允许使用“0G”，并将其解释为零。
  
  
• 使用后缀的命令：dd、stargd

3.9.103     SYSLOG - 用于发送系统消息以进行日志记录的设备

• 概要：bind -k syslog 绑定点
• 描述：syslog 文件系统提供用户级别条目，用于将消息输入到系统日志记录工具中（请参阅 syslogd）。 写入此设备的内容将带有时间戳，并以“NOTICE”消息类存储在系统日志中。 从此设备读取将返回 EOF。 默认情况下，系统日志记录设备绑定在 /dev/syslog。
• 示例

  > /dev/syslog
  
  bind -k syslog /dev/syslog
  
  ls -l /dev/syslog
  
  /dev/syslog                   syslog    0 0x00000000    0 0
  
  echo {Some important message} > /dev/syslog
  
  syslogd
  
  1: INFO: RaidRunner Syslog Boot
  
  10: NOTICE: Some important message

• 另请参阅：syslogd

3.9.104     SYSLOGD - 初始化或访问系统日志区域中的消息

• 概要：syslogd [-I] [-p cnt]
• 描述：syslogd 初始化系统消息日志记录区域或打印该区域中存储的消息。
• 选项
• -I：初始化系统消息日志记录区域。 此命令通常在启动时执行，通常不由用户调用。
• -p cnt：打印系统消息日志记录区域中存储的最后 cnt 条消息。 /nr 如果未给出任何选项，则此为默认值，并且 cnt 设置为 20。
  
  消息以以下格式打印 -
  
  时间戳：消息类别：消息
  
  其中，时间戳是记录消息的时间，记录为自 RaidRunner 启动以来的秒数，消息类别是已记录消息的类型，指示消息的重要性（或类别）。 消息是消息本身
  
  
• 消息类别
  
  当前有九 (9) 个消息类别
  1. EMERG：极其严重的消息，RaidRunner 无法从中恢复
  2. ALERT：严重性质的消息，RaidRunner 只能部分恢复
  3. CRIT：严重性质的消息，RaidRunner 几乎可以完全恢复
  4. ERR：指示内部错误的消息
  5. WARNING：严重性质的消息，RaidRunner 可以完全从中恢复，例如自动将热备件分配给 Raid 1、3 或 5 文件系统。
  6. NOTICE：通过写入 syslog 设备记录的消息
  7. INFO：信息性消息
  8. DEBUG：调试消息选项，如果给出，则 cnt 设置为 20。
  9. REPEATS：指示之前的消息每隔 S 秒重复 N 次，自其初始条目以来。
• SYSLOG 输出：当消息被记录时，它们存储在系统消息日志记录区域中。 如果全局环境变量 SYSLOG_CONF 设置为“C”值，或者根本未设置，则消息也将打印到控制台。 如果消息带有 RPT N/S 后缀，则表示自消息首次进入系统消息日志记录区域以来，该消息每隔 S 秒记录 N 次。
• 另请参阅：syslog、setenv

3.9.105     TEST - 条件评估命令

• 概要：test expr
• 描述：test 评估 expr，如果其值为真，则返回 K9 状态 NIL，这等效于 true 命令。 或者，如果 test 评估 expr，并且其值为假，则返回 K9 状态“false”，这等效于 false 命令。 如果未给出任何参数，则返回 K9 状态“false”。 如果表达式不遵守下面给出的语法，则会向标准错误写入错误消息，并作为 K9 状态返回。 请注意，husky 条件逻辑（例如“if”）将任何非 NIL K9 状态解释为假。 test 使用的基本表达式分为 3 类：文件测试、字符串测试和数字测试。 这些基本表达式可以由称为运算符的第 4 类修改或组合成更大的表达式。
• 文件测试：支持以下文件测试
  • -d 文件：如果文件存在且是目录，则为真。
  • -f 文件：如果文件存在，则为真。
  • -s 文件：如果文件存在且长度非零，则为真。
• 字符串测试：命令“test {}”在语法上是正确的，并且值为“false”，因为“{}”是空字符串。 命令“test”本身的值为“false”。 命令“test hello”和“test -z”的值均为“true”。 支持以下字符串测试
  • -n str：如果 str 的长度非零，则为真。
  • -z str：如果 str 的长度为零，则为真。
  • str1 = str2：如果 str1 和 str2 相同，则为真。 “=”周围需要空格。
  • str1 != str2：如果 str1 和 str2 不相同，则为真。 “!=”周围需要空格。
  • str：如果 str 不是空字符串，则为真
• 数字测试：这些数字参数被评估为有符号整数。 当前使用内部 32 位整数表示，将有效整数的范围限制为 -2,147,483,648 到 2,147,483,647（包括 -2,147,483,648 和 2,147,483,647）。 因此，无法比较定点数和浮点数。 数字比较标记（例如“-eq”）周围需要空格。 可以给出“-l str”形式的表达式来代替数字。 这会评估为字符串 str 中的字符数。 支持以下数字测试
  • n1 -eq n2：如果 n1 和 n2 在数值上相等，则为真
  • n1 -ge n2：如果 n1 大于或等于 n2，则为真
  • n1 -gt n2：如果 n1 大于 n2，则为真
  • n1 -le n2：如果 n1 小于或等于 n2，则为真
  • n1 -lt n2：如果 n1 小于 n2，则为真
  • n1 -ne n2：如果 n1 不等于 n2，则为真
• 运算符：支持以下运算符
  • !：一元否定运算符。 出现在它要否定的表达式的左侧。
  • -a：二元 AND 运算符。 出现在它逻辑组合的 2 个表达式之间。
  • -o：二元 OR 运算符。 出现在它逻辑组合的 2 个表达式之间。
  • ( expr )：括号用于对表达式进行分组。 由于括号是 husky 特殊字符，因此需要引用或转义它们。
  • 这些运算符的相对优先级从高到低为：() ! -a -o。 因此，表达式

    test ! -f /bin/ls -a -d /env

    与

    test {(} ! -f /bin/ls {)} -a -d /env

    相同。“!”运算符应出现在其他一元运算符的左侧。 基本二元运算符的优先级高于“-a”和“-o”。
  
  
• 另请参阅：husky

3.9.106     TIME - 打印自启动（或时钟重置）以来的秒数

• 概要：time
• 描述：time 将打印自 RaidRunner 启动或自上次重置时钟以来的时间（以秒为单位）。

3.9.107     TRAP - 拦截信号并执行某些操作

• 概要
  • trap
  • trap n ...
  • trap {} n ...
  • trap arg n ...
• 描述：trap 允许定向到此进程的信号拦截信号并可能采取一些特殊操作。 当 trap 在没有参数的情况下使用时，将打印此进程的所有当前（非默认）陷阱。 当第一个参数是数字（可选地后跟其他数字）时，则该数字被解释为信号编号，其操作将设置为该信号的默认值（额外的数字以类似的方式处理）。 当第一个参数是空字符串（即 {}）时，则忽略以下数字指定的信号。 当第一个参数是非空字符串时，如果发生以下数字指定的信号，则将执行“arg”。 注意：信号编号 4（kill）既不能捕获也不能忽略。
  
  下表将信号编号映射到说明
  • 0 未使用的信号
  • 1 挂断
  • 2 中断 (rubout)
  • 3 退出 (ASCII FS)
  • 4 终止 (kill)（无法捕获或忽略）
  • 5 写入到没有读取者的管道
  • 6 闹钟
  • 7 软件终止信号
  • 8 子进程状态已更改
  • 9 进程无法获取内存（来自堆）
• 另请参阅：kill

3.9.108     TRUE - 返回 K9 true 状态

• 概要：true
• 描述：true 除了返回 K9 true 状态外，不执行任何其他操作。 K9 进程在终止时返回指向 C 字符串（以 null 结尾的字符数组）的指针。 如果该指针为 NULL，则假定为 true 退出值，而所有其他返回的指针值都解释为 false（字符串是关于哪里出错的一些解释）。 此命令返回 NULL 指针值作为其返回值。 返回 NULL 指针值有时称为返回 NIL。 husky shell 将标记“:”解释为与 true 具有相同的含义。
• 另请参阅：false

3.9.109     STTY 或 TTY - 打印用户的终端挂载点或 terminfo 状态

• 概要
  • tty
  • stty [ttyname]
• 描述：tty 检查其运行的设备，如果设备在 DUART 上，则打印设备的挂载点。 如果设备不是 DUART，则打印相应的消息。
  
  stty 打印与 stty 正在从中执行的终端设备或给定的终端设备 ttyname 关联的 terminfo 结构。 如果给出了无效的设备名称，或者 stty 正在从中执行的设备不是 DUART，则会打印相应的消息。 此命令主要用于调试 RaidRunner 内核。
  
  
• 返回状态：成功时返回代码 0，否则返回 1。

3.9.110     UNSET - 删除一个或多个环境变量

• 概要
  • unset name
  • unset name name ...
• 描述：unset 删除给定的环境变量。 这是通过从 /env 文件系统中删除给定的变量来完成的。
• 另请参阅：set、env

3.9.111     UNSETENV - 取消设置（删除）全局环境变量

• 概要：unsetenv name [name ...]
• 描述：unsetenv 删除全局环境变量名称及其内容。 如果给出多个名称，则删除每个全局环境变量。 如果给定的名称不是全局环境变量，则不执行任何操作，也不设置错误状态。
• 注意：全局环境变量是指存储在 RaidRunner 上的非易失性区域中的变量，因此在连续的电源循环或重启之间可用。这些变量与 husky 环境变量不同。非易失性区域与 RaidRunner 配置区域位于同一位置。
• 另请参阅：printenv、setenv、rconf

3.9.112     VERSION - 打印 RaidRunner 内核的版本

• 概要：version
• 描述：version 打印 RaidRunner 代码的版本，其中包括版本号、创建日期和创建者。

3.9.113     WAIT - 等待进程（或我的子进程）终止

• 概要：wait [pid]
• 描述：wait 等待给定的 pid（进程标识符）终止，或者，如果没有给出任何参数，则等待此进程的所有子进程终止。 当给出 pid 时，此命令返回该进程的退出状态。 当未给出 pid 时，此命令返回 NIL 状态（当所有子进程都已终止时）。
• 另请参阅：K9wait、K9kill

3.9.114     WARBLE - 定期脉冲蜂鸣器

• 概要：warble 周期 计数
• 描述：warble 将保存蜂鸣器的当前状态（开或关），然后将蜂鸣器打开 period 毫秒，然后关闭 period/2 毫秒，并重复此操作 count 次。
• 另请参阅：buzzer、sos

3.9.115     XD- 以十六进制格式转储给定文件到标准输出

• 概要：xd [ 文件 ... ]
• 描述：xd 以十六进制格式将每个给定文件转储到标准输出。 如果未给出任何文件（或为“-”），则使用标准输入。

3.9.116     ZAP - 将零写入文件

3.9.117     ZCACHE - 操作 RAID 组缓存的区域优化 IO 表

• 概要：zcache -c cache_moniker [-E extents] [-P portion] [-W 0|1] [-p]
• 描述：zcache 是一个实用程序，它将打印和/或修改给定缓存范围的区域优化 IO 表。
• 选项
  • -c cache_moniker：指定要打印区域表或修改其内容的缓存范围 cache_moniker。 cache_moniker 是在 add moniker=cache_moniker first= ... 命令中设置的名称（请参阅 cache）。 如果未给出其他选项，则打印区域表。 当打印区域表时，其格式为
  n 状态 z1_lo..z1_hi@z1_blks z2_lo..z2_hi@z2_blks ... zn_lo..zn_hi@zn_blks
  • 其中，n 是 IO 优化区域的数量，状态为“on”（表示区域优化 IO）、“off”（表示无区域优化 IO）或“none”（表示没有可用区域）。 z1_lo..z1_hi@z1_blks ... zn_lo..zn_hi@zn_blks 列出每个区域的起始块和结束块以及优化的块计数。
  • -E extents：指定 RAID 组中数据驱动器的数量，缓存范围存在于该 RAID 组中。
  • -P portion：指定每个区域的优化块计数要调整的百分比，限制在 50 到 300 之间。 也就是说，如果您需要将每个区域的优化块计数减少 10%，则应将 portion 设置为 90。
  • -W 0|1：为给定缓存范围打开 (1) 或关闭 (0) 区域 IO 优化。
• 另请参阅：cache

3.9.118     ZERO - 读取时连续产生零的文件

• 概要：bind -k {zero [ # ]} 绑定点
• 描述：zero 是一个特殊文件，写入时是数据的无限接收器（即，可以向其写入任何内容，并且会快速处理掉）。 当读取 zero 时，它是零的无限源（即字节值 0）。 zero 文件将以绑定点出现在 K9 命名空间中。 如果给出了可选的“#”，则 zero 文件仍然是数据的无限接收器。 但是，当读取时，每 512 字节被视为一个块（从文件开头的块 0 开始）。 每个块包含 128 个 4 字节整数（C 中的“unsigned long”），每个整数都包含当前块号。 此选项旨在作为调试辅助工具。
• 示例：Husky 按如下方式安装 zero 特殊文件

  bind -k zero /dev/zero
  
  创建充满零的 32 千字节文件（名为“/fill”）的用法示例。
  
  dd if=/dev/zero of=/fill bs=8k count=4

• 另请参阅：null、log

3.9.119     ZLABELS - 将零写入 RAID 组的开头和结尾

• 概要
  • zlabels -a
  • zlabels raidset [raidset .... ]
• 描述：zlabels 是一个 husky 脚本，它将零写入到所有配置的 RAID 组或给定 RAID 组的开头和结尾。 通常，主机操作系统会将标签写入磁盘。 几乎所有操作系统都会在磁盘的开头写入几个块，有些操作系统也会在磁盘的结尾写入副本。 由于此标签包含格式化和修改后的磁盘几何信息，因此对 RAID 组的更改会影响其提供的磁盘驱动器的几何结构，这将与之前写入的任何标签冲突。 zlabels 在 RAID 组的开头和结尾都写入零。 归零的块数取决于 RAID 组类型和 io chunksize。 通常，在开头写入 50 个 io chunk size 块，在结尾写入 49 个。 对于 RAID 类型 3，写入的数据驱动器数量乘以 50（和 49）。
• 选项
  • -a：所有配置的 RAID 组都将被清零。
  • raidset：命名的 RAID 组或 RAID 组将被清零。
• 另请参阅：dd

3.10  高级主题：SCSI 监视器守护进程 (SMON)

3.11  进一步阅读

• Linas Vepstas 的 Linux software-RAID-HOWTO
• AT&T Bell Labs 的 Plan9 页面：http://plan9.bell-labs.com/plan9/index.htm