Scroll to navigation

smartpqi(4) Device Drivers Manual 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.

Это операции выполняют ту же работу — заставляют драйвер искать новые устройства. Это тоже самое, как если выполнить запись в атрибут rescan конкретного узла smartpqi.
Возвращает домен PCI, шину, устройство, функцию и «board ID» (ID подсистемы PCI).
Возвращает версию драйвера в виде четырёх байт в формате:

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

(выпуск << 16) | редакция

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

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

Отключить поддержку, совпадающих с шаблоном идентификаторов устройств. Значение по умолчанию равно 0.
Отключить поддержку сторожевой проверки (heartbeat check). Этот параметр используется для отладки. Значение по умолчанию равно 0, что оставляет активной поддержку сторожевой проверки.
Отключить поддержку по выключению контроллера в ответ на события его блокировки. Значение по умолчанию равно 0.
Задаёт действие, которое выполняет драйвер, когда обнаруживается блокировка контроллера. Действие по умолчанию равно none.
параметр действие
none отключить только контроллер (offline)
reboot перезагрузить систему
panic вызвать панику системы
Этот параметр включает поддержку доступа к логическим устройствам в системе раньше физических устройств. Значение по умолчанию равно 0.
Этот параметр включает отключение на узле доступа к виртуальному 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 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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

15 декабря 2022 г. Linux man-pages 6.05.01