SMARTPQI(4)

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

ОБЗОР
modprobe smartpqi [disable_device_id_wildcards={0|1}] [disable_heartbeat={0|1}] [disable_ctrl_shutdown={0|1}] [lockup_action={none|reboot|panic}]

ОПИСАНИЕ
smartpqi — это драйвер SCSI для контроллеров Microsemi Smart Family.

  Поддерживаемые операции ioctl()
Для совместимости с приложениями, написанными для драйверов cciss(4) и hpsa(4), многие операции ioctl(2), поддерживаемые в драйвере hpsa, также поддерживаются драйвером smartpqi(4) (но не все). Структуры данных, используемые в операциях, описаны в файле исходного кода ядра 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 | вызвать панику системы

ФАЙЛЫ

  Узлы устройства
Логические диски доступны через драйвер дисков 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, относящиеся к атрибутам диска 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

ВЕРСИИ
Драйвер smarpqi() впервые появился в 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.