TMCHGIMPARM (更改参数) tmscsi 设备驱动程序 ioctl 操作

用途

使调用者能够更改目标方式设备驱动程序使用的参数。

描述

TMCHGIMPARM ioctl 操作允许调用程序更改特定设备实例的目标方式设备驱动程序所使用的某些参数。 仅对于发起方方式设备，才允许执行此操作。 TMCHGIMPARM 操作的 arg 参数指定在 /usr/include/sys/tmscsi.h 文件中定义的 tm_chg_im_parm 结构的地址。

通常，设备驱动程序对这些参数使用的缺省值不需要更改。 但是，对于某些调用程序，可以更改缺省值以微调与错误恢复相关的计时参数。

必须打开发起程序方式设备，此命令才能成功。 通过 TMCHGIMPARM 操作更改参数后，该参数将保持更改，直到接收到另一个 TMCHGIMPARM 操作或设备关闭为止。 在打开时，这些参数将设置为缺省值。

可以使用此操作更改的参数是设备驱动程序启动的 SCSI 派 命令重试之间的延迟量 (以秒为单位) ，以及在任何 派 命令运行超时之前允许的时间量。 为了指示正在更改哪些可能的参数，调用程序将在chg_option:NONE. 可以在此字段中 0 值 0,1 或多个标志，以指示正在更改哪些参数。

要更改 派 命令重试之间的延迟，调用者将在以下命令中设置 TM_CHG_RETRY_DELAY 标志:chg_option并将期望的延迟值 (以秒计) 放置在new_delay结构的字段。 可以使用此命令将重试延迟更改为 0 到 255 (包括 0 和 255) 之间的任何值 0 其中 0 指示设备驱动程序在重试之间使用尽可能小的延迟。 缺省值大约为 2 秒。

要更改 派 命令超时值，调用者将在以下命令中设置 TM_CHG_SEND_TIMEOUT 标志:chg_option字段，设置期望的标志timeout_type并将期望的超时值放置在new_timeout结构的字段。 必须在以下文件中设置单个标志:time_out字段以指示期望的超时形式。 如果在以下文件中设置了 TM_FIXED_TIMEOUT 标志:timeout_type字段中的值，然后将其放置在new_timeout字段是所有 派 命令的固定超时值。 如果在以下文件中设置了 TM_SCALED_TIMEOUT 标志:timeout_type字段中的值，然后将其放置在new_timeout字段是在超时计算中使用的缩放因子，如在写入口点的描述下所示。 缺省 派 命令超时值是缩放因子为 10 的缩放超时值。

无论该值为多少timeout_type字段，如果new_timeout字段设置为值 0 ，调用者为 派 命令指定 "no timeout" ，从而允许该命令执行无限期的时间。 如果调用程序想要结束 写 操作，那么它会生成信号。

文件