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}] [expose_ld_first={0|1}] [hide_vsep={0|1}]

ОПИСАНИЕ
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 | вызвать панику системы

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 <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.