sdi_timeout(1M)

sdi_timeout -- query or change SDI device timeout tunables

Synopsis

sdi_timeout [-fsFC][-l 6|10|12][[device_descriptor[command[value]]...]...]

sdi_timeout -c device-type

sdi_timeout -[ynq]

sdi_timeout -b [node_descriptor]

Description

The sdi_timeout command reports or changes timeout tunables for use by the SDI timeout mechanism. When a timeout is detected by the system, SDI begins its error recovery gauntlet in an attempt to get the SCSI peripheral or bus back into a functional state. Because of the severity of the error recovery mechanism, timeout values should be chosen conservatively to avoid unnecessary timeouts.

If sdi_timeout is invoked without a value, it lists the timeout values being used in the running kernel. The values are listed for all commands and all devices if no device_descriptor is specified. If one or more device_descriptor is specified on the command line, all commands and values for the system devices that match the specified device_descriptor are printed. If a device_descriptor and one or more command are specified, the values of those commands are printed for the matching system devices.

When sdi_timeout is invoked, it processes the rest of the command line, and then loads the new timeout values into the running kernel.

Options

-b

Force immediate loading of timeout values. If a particular node-descriptor is specified, only those values are loaded.

-c

Display list of valid commands for device type.

-C

The command given in the argument list is a hex value representing a SCSI command. This is used to set the timeout value for a vendor-unique SCSI command. The hex value must begin with 0x.

-f

Reset the commands matched by the following arguments to the originally shipped defaults. The arguments must not include values. If no other arguments are specified, all timeout values are reset to the defaults.

-F

List the originally shipped defaults for the commands queried. The arguments must not include values. If no other arguments are specified, the original shipped defaults are listed for all devices and commands.

-l

Modify the command specified on the command line to refer only to the 6-, 10-, or 12-byte SCSI command. Otherwise, commands refer to all lengths.

-n

Disable all timeouts.

-q

Query all HBA drivers that have claimed a device to see which ones support timeouts and the ensuing error recovery. Also, report whether timeouts are currently enabled or disabled.

-s

Silent mode. Do not prompt user before committing changes.

-y

Enable all timeouts.

device-descriptor

The device-descriptor can be in one of the following forms:

device-type: Must be one of CDROM, ``disk'', ``tape'', WORM, or CHANGER.
node-descriptor: cCbBtTdDpP
When used as a device-descriptor, the node-descriptor is equivalent to specifying the full inquiry string. For example, specifying a node-descriptor for a device that happens to be identical to another device on the system results in the query or modification applying to both devices. See disk(7) and tape(7) for an explanation of this notation.
inquiry-string: The string returned by an INQUIRY to the device. The inquiry-string can be a prefix of the full INQUIRY string.

command

The command for which the timeout value should be displayed or changed. A list of commands can be obtained using sdi_timeout -c device_type.

value

The timeout value specified in seconds.

Usage

There is never a need to reboot after using sdi_timeout; all changes are made dynamically to the running kernel. Because the changes are not instantaneous, the kernel continues running with the existing timeout parameters until sdi_timeout completes.

If you are booting a system with a device that has unique timeout value restrictions, specify SDI_TIMEOUT=no at the boot prompt (see boot(1M)) to disable timeouts, and then use sdi_timeout to enter the correct timeout values and to reenable timeouts.

Return values

Because sdi_timeout calls other system commands to perform some of its tasks, it reports all errors encountered by those commands and cleans up intermediate files created in the process.

References

boot(1M), idbuild(1M), idcheck(1M), idtune(1M), modadmin(1M), disk(7), tape(7)