ИМЯ

smartpqi - драйвер Microsemi Smart Family SCSI

СИНТАКСИС

[ disable_device_id_wildcards={0|1}] [ disable_heartbeat={ 0|1}] [disable_ctrl_shutdown={0|1}] [ lockup_action={none| reboot|panic}] [ expose_ld_first={ 0|1}] [hide_vsep={0|1}]

ОПИСАНИЕ

smartpqi — это драйвер SCSI для контроллеров Microsemi Smart Family.

Поддерживаемые операции ioctl ()

Для совместимости с приложениями, написанными для драйверов cciss(4) и hpsa(4), многие операции ioctl(2), поддерживаемые в драйвере hpsa, также поддерживаются драйвером (но не все). Структуры данных, используемые в операциях, описаны в файле исходного кода ядра Linux include/linux/cciss_ioctl.h.
CCISS_DEREGDISK, CCISS_REGNEWDISK, CCISS_REGNEWD
Это операции выполняют ту же работу — заставляют драйвер искать новые устройства. Это тоже самое, как если выполнить запись в атрибут rescan конкретного узла smartpqi.
CCISS_GETPCIINFO
Возвращает домен PCI, шину, устройство, функцию и «board ID» (ID подсистемы PCI).
CCISS_GETDRIVVER
Возвращает версию драйвера в виде четырёх байт в формате:

(основная_версия << 28) | (дополнительная_версия << 24) |
        (выпуск << 16) | редакция

CCISS_PASSTHRU
Позволить передачу команд BMIC и CISS напрямую в контроллер.

Параметры загрузки

disable_device_id_wildcards={0|1}
Отключить поддержку, совпадающих с шаблоном идентификаторов устройств. Значение по умолчанию равно 0.
disable_heartbeat={0|1}
Отключить поддержку сторожевой проверки (heartbeat check). Этот параметр используется для отладки. Значение по умолчанию равно 0, что оставляет активной поддержку сторожевой проверки.
disable_ctrl_shutdown={0|1}
Отключить поддержку по выключению контроллера в ответ на события его блокировки. Значение по умолчанию равно 0.
lockup_action={none|reboot|panic}
Задаёт действие, которое выполняет драйвер, когда обнаруживается блокировка контроллера. Действие по умолчанию равно none.
параметр действие
none отключить только контроллер (offline)
reboot перезагрузить систему
panic вызвать панику системы
expose_ld_first={0|1}
Этот параметр включает поддержку доступа к логическим устройствам в системе раньше физических устройств. Значение по умолчанию равно 0.
hide_vsep={0|1}
Этот параметр включает отключение на узле доступа к виртуальному SEP. Обычно, это относится к напрямую подключаемым устройствам. Значение по умолчанию равно 0.

ФАЙЛЫ

Узлы устройства

Логические диски доступны через драйвер дисков SCSI ( sd), ленточные устройства — через драйвер лент SCSI ( st), а контроллеры RAID — через общий драйвер SCSI ( sg); имена узлов устройств называются /dev/sd*, /dev/st* и /dev/sg*, соответственно.

Файлы в /sys, относящиеся к атрибутам узла SmartPQI

/sys/class/scsi_host/host*/rescan
Атрибут rescan узла только для записи. Факт записи заставляет драйвер выполнить сканирование на предмет появления новых, изменившихся или удалённых устройств (например, подключаемых на ходу ленточных накопителей или только что настроенных или удалённых логических дисков и т. д.) и уведомить прослойку (midlayer) SCSI об обнаруженных изменениях. Обычно, пересканирование выполняется автоматически при изменении состава оборудования, поэтому, обычно, пользователь не должен выполнять запись в этот файл. Такое действие может быть полезным при подключении на ходу устройств, таких как ленточные накопители или хранилища с уже настроенными логическими дисками.
/sys/class/scsi_host/host*/version
Атрибут узла version доступен только для чтения. Он содержит версию драйвера и микропрограммы контроллера.
Пример:

$  cat /sys/class/scsi_host/host1/version
driver: 1.1.2-126
firmware: 1.29-112

/sys/class/scsi_host/host*/lockup_action
Атрибут узла lockup_action доступен на чтение/запись. Он заставляет драйвер выполнять определённое действие при маловероятном событии — обнаружении блокировки контроллера. Смотрите в разделе ПАРАМЕТРЫ описание значений lockup_action.
/sys/class/scsi_host/host*/driver_version
Атрибут driver_version доступен только для чтения. В данном атрибуте хранится версия драйвера smartpqi.
Пример:

$  cat /sys/class/scsi_host/host1/driver_version
1.1.2-126

/sys/class/scsi_host/host*/firmware_version
Атрибут firmware_version доступен только для чтения. Он содержит версию микропрограммы контроллера.
Пример:

$  cat /sys/class/scsi_host/host1/firmware_version
1.29-112

/sys/class/scsi_host/host*/model
Атрибут model доступен только для чтения. Он содержит маркировочную строку модели контроллера.
Пример:

$  cat /sys/class/scsi_host/host1/model
1100-16i

/sys/class/scsi_host/host*/serial_number
Атрибут serial_number доступен только для чтения. Он содержит уникальный маркировочный номер контроллера.
Пример:

$  cat /sys/class/scsi_host/host1/serial_number
6A316373777

/sys/class/scsi_host/host*/vendor
Атрибут vendor доступен только для чтения. Он содержит маркировочную строку производителя контроллера.
Пример:

$  cat /sys/class/scsi_host/host1/vendor
Adaptec

Файлы в /sys, относящиеся к атрибутам диска SmartPQI

В определениях файла ниже символ c означает номер соответствующего контроллера SCSI, b — номер шины, t — номер цели, l — номер логического элемента (LUN).
/sys/class/scsi_disk/c:b:t:l/device/raid_level
Атрибут raid_level доступен только для чтения. В данном атрибуте хранится уровень RAID каждого логического диска.
Пример:

$  cat /sys/class/scsi_disk/4:0:0:0/device/raid_level
RAID 0

/sys/class/scsi_disk/c:b:t:l/device/sas_address
Атрибут sas_address доступен только для чтения. В данном атрибуте хранится уникальный идентификатор диска.
Пример:

$  cat /sys/class/scsi_disk/1:0:3:0/device/sas_address
0x5001173d028543a2

/sys/class/scsi_disk/c:b:t:l/device/ssd_smart_path_enabled
Атрибут ssd_smart_path_enabled доступен только для чтения. Он имеется у томов с включённым ioaccel (ioaccel — альтернативный путь доступа для драйвера, который позволяет драйверу посылать запросы ввода-вывода напрямую устройству SCSI минуя микропрограмму контроллера. Это увеличивает производительность. Данный метод используется для дисков HBA и логических томов на SSD). Содержит 1, если ioaccel включён для тома и 0 в противном случае.
Пример:

$  cat /sys/class/scsi_disk/1:0:3:0/device/ssd_smart_path_enabled
0

ВЕРСИИ

Драйвер smartpqi() впервые появился в Linux версии 4.9.

ЗАМЕЧАНИЯ

Настройка

Описание настройки контроллера Microsemi Smart Family смотрите в руководстве пользователя на контроллер, которое можно найти поискав нужный контроллер на странице https://storage.microsemi.com/

СМ. ТАКЖЕ

cciss(4), hpsa(4), sd(4), st(4)
Файл Documentation/ABI/testing/sysfs-bus-pci-devices-cciss в дереве исходного кода ядра Linux.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Alexander Golubev <[email protected]>, Azamat Hackimov <[email protected]>, Hotellook, Nikita <[email protected]>, Spiros Georgaras <[email protected]>, Vladislav <[email protected]>, Yuri Kozlov <[email protected]> и Иван Павлов <[email protected]>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]

Recommended readings

Pages related to smartpqi you should read also:
cciss(4) hpsa(4) ioctl(2) sd(4) st(4)

Questions & Answers

Helpful answers and articles about smartpqi you may found on these sites:
Stack Overflow Server Fault Super User Unix & Linux Ask Ubuntu Network Engineering DevOps Raspberry Pi Webmasters Google Search