illumos: manual page: scsi_get_device_type_scsi

SCSI_GET_DEVICE_TYPE_SCSI_OPTIONS(9F) Kernel Functions for Drivers

NAME

scsi_get_device_type_scsi_options - look up per-device-type scsi-options
property

SYNOPSIS

#include <sys/scsi/scsi.h>

int scsi_get_device_type_scsi_options(dev_info_t *dip,
struct scsi_device *devp, int default_scsi_options);

INTERFACE LEVEL

illumos DDI specific (illumos DDI).

PARAMETERS

dip
Pointer to the device info node for this HBA
driver.

devp
Pointer to a scsi_device(9S) structure of the
target.

default_scsi_options
Value returned if no match is found.

DESCRIPTION

The scsi_get_device_type_scsi_options() function looks up the property
device-type-scsi-options-list, which can be specified in the HBA's
driver.conf(5) file. This property allows specification of scsi-options
on a per-device-type basis.

The formal syntax is:

device-type-scsi-options-list = <duplet> [, <duplet> *];

where:

<duplet> := <vid+pid>, <scsi-options-property-name>

and:

<scsi-options-property-name> = <value>;

The string <vid+pid> is returned by the device on a SCSI inquiry command.
This string can contain any character in the range 0x20-0x7e. Characters
such as double quote (") or single quote ('), which are not permitted in
property value strings, are represented by their octal equivalent (for
example, \042 and \047). Trailing spaces can be truncated.

For example:

device-type-scsi-options-list=
"SEAGATE ST32550W", "seagate-options",
"EXABYTE EXB-2501". "exabyte-options",
"IBM OEM DFHSS4S", "ibm-options";

seagate-options = 0x78;
exabyte-options = 0x58;
ibm-options = 0x378;

The scsi_get_device_type_scsi_options() function searches the list of
duplets for a matching INQUIRY string. If a match is found,
scsi_get_device_type_scsi_options() returns the corresponding value.

RETURN VALUES

scsi_get_device_type_scsi_options() returns the scsi-options value found,
or if no match is found the default_scsi_options value passed in.

CONTEXT

This function can be called from kernel or interrupt context.