Provided by: manpages-ru_4.18.1-1_all bug

ИМЯ

       cciss - блочный драйвер устройства HP Smart Array

СИНТАКСИС

       modprobe cciss [ cciss_allow_hpsa=1 ]

ОПИСАНИЕ

       Note:  This  obsolete driver was removed in Linux 4.14, as it is superseded by the hpsa(4)
       driver in newer kernels.

       cciss — это блочный драйвер для старых контроллеров RAID HP Smart Array.

   Параметры
       cciss_allow_hpsa=1:  этот  параметр   запрещает   драйверу   cciss   пробовать   управлять
       контроллерами,  которыми может управлять драйвер hpsa(4). Другими словами, этим параметром
       драйвер cciss будет ограничен следующими контроллерами:

           Smart Array 5300
           Smart Array 5i
           Smart Array 532
           Smart Array 5312
           Smart Array 641
           Smart Array 642
           Smart Array 6400
           Smart Array 6400 EM
           Smart Array 6i
           Smart Array P600
           Smart Array P400i
           Smart Array E200i
           Smart Array E200
           Smart Array E200i
           Smart Array E200i
           Smart Array E200i
           Smart Array E500

   Поддерживаемое оборудование
       Драйвер cciss поддерживает следующие платы Smart Array:

           Smart Array 5300
           Smart Array 5i
           Smart Array 532
           Smart Array 5312
           Smart Array 641
           Smart Array 642
           Smart Array 6400
           Smart Array 6400 U320 Expansion Module
           Smart Array 6i
           Smart Array P600
           Smart Array P800
           Smart Array E400
           Smart Array P400i
           Smart Array E200
           Smart Array E200i
           Smart Array E500
           Smart Array P700m
           Smart Array P212
           Smart Array P410
           Smart Array P410i
           Smart Array P411
           Smart Array P812
           Smart Array P712m
           Smart Array P711m

   Особенности настройки
       Для настройки контроллеров HP Smart  Array  используйте  HP  Array  Configuration  Utility
       (hpacuxe(8)  или  hpacucli(8)) или Offline ROM-based Configuration Utility (ORCA), которую
       можно запустить из ROM Smart Array при старте машины.

ФАЙЛЫ

   Узлы устройства
       Ниже приведена схема именования устройств:

       Старшие номера:

              104   cciss0
              105   cciss1
              106   cciss2
              105   cciss3
              108   cciss4
              109   cciss5
              110   cciss6
              111   cciss7

       Младшие номера:

           b7 b6 b5 b4 b3 b2 b1 b0
           |----+----| |----+----|
                |           |
                |           +-------- Идентификатор раздела (0=всё устройство,
                                                             1-15 раздел)
                |
                +-------------------- Номер логического тома

       Порядок именования устройств:

       /dev/cciss/c0d0     Controller 0, disk 0, whole device
       /dev/cciss/c0d0p1   Controller 0, disk 0, partition 1
       /dev/cciss/c0d0p2   Controller 0, disk 0, partition 2
       /dev/cciss/c0d0p3   Controller 0, disk 0, partition 3

       /dev/cciss/c1d1     Controller 1, disk 1, whole device
       /dev/cciss/c1d1p1   Controller 1, disk 1, partition 1
       /dev/cciss/c1d1p2   Controller 1, disk 1, partition 2
       /dev/cciss/c1d1p3   Controller 1, disk 1, partition 3

   Файлы в /proc
       В  файлах  /proc/driver/cciss/cciss[0-9]+  содержится  информация  о   настройке   каждого
       контроллера. Пример:

           $ cd /proc/driver/cciss
           $ ls -l
           total 0
           -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss0
           -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss1
           -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss2
           $ cat cciss2
           cciss2: HP Smart Array P800 Controller
           Board ID: 0x3223103c
           Firmware Version: 7.14
           IRQ: 16
           Logical drives: 1
           Current Q depth: 0
           Current # commands on controller: 0
           Max Q depth since init: 1
           Max # commands on controller since init: 2
           Max SG entries since init: 32
           Sequential access devices: 0

           cciss/c2d0:   36.38GB       RAID 0

   Файлы в /sys
       /sys/bus/pci/devices/<dev>/ccissX/cXdY/model
              Модель логического устройства Y контроллера X со страницы 0 SCSI INQUIRY.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/rev
              Версия логического устройства Y контроллера X со страницы 0 SCSI INQUIRY.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/unique_id
              Серийный номер логического устройства Y контроллера X со страницы 83 SCSI INQUIRY.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/vendor
              Производитель логического устройства Y контроллера X со страницы 0 SCSI INQUIRY.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/block:cciss!cXdY
              Символьная ссылка на /sys/block/cciss!cXdY.

       /sys/bus/pci/devices/<dev>/ccissX/rescan
              При записи в этот файл драйвер повторно сканирует контроллер для обнаружения новых,
              удалённых или изменённых логических дисков.

       /sys/bus/pci/devices/<dev>/ccissX/resettable
              Значение 1 в файле показывает, что параметр  ядра  «reset_devices=1»  (используемый
              kdump)  был  принят  данным  контроллером. Значение 0 показывает, что параметр ядра
              «reset_devices=1» принят не был. Некоторые модели Smart Array не  способны  принять
              этот параметр.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/lunid
              8-байтовый  LUN ID, используемый для адресации логического устройства Y контроллера
              X.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/raid_level
              Уровень RAID логического устройства Y контроллера X.

       /sys/bus/pci/devices/<dev>/ccissX/cXdY/usage_count
              Счётчик использования (число открытий) логического устройства Y контроллера X.

   Поддержка ленточных устройств SCSI и устройств смены носителя
       Драйвер поддерживает устройства SCSI с  последовательным  доступом  и  смены  носителя,  и
       автоматически  создаёт  соответствующие  узлы устройств (например, /dev/st0, /dev/st1 и т.
       д.;  подробней  смотрите  в  st(4)).  Чтобы  использовать  ленточные  устройства  SCSI   с
       контроллером  Smart  Array  5xxx в настройках ядра нужно включить «SCSI tape drive support
       for Smart Array 5xxx» и «SCSI support».

       Также заметим, что драйвер не привлекает ядро SCSI во время инициализации. Драйвер  должен
       динамически  задействовать  ядро  SCSI  через  запись  в  файловой  системе /proc, которую
       (/proc/driver/cciss/cciss*) «блочная» часть драйвера создаёт во время работы. Так  сделано
       потому, что на момент инициализации драйвера ядро SCSI ещё может быть не  инициализировано
       (так как драйвер — блочный) и попытка зарегистрировать его  в  ядре  SCSI  в  этом  случае
       вызывала  бы  зависание.  Это  лучше  всего выполнять из сценария инициализации (обычно, в
       /etc/init.d, но в разных дистрибутивах по-разному). Пример:

           for x in /proc/driver/cciss/cciss[0-9]*
           do
               echo "engage scsi" > $x
           done

       После того, как драйвер подключил ядро SCSI, он не может  быть  выключен  (за  исключением
       выгрузки драйвера, если он собран в виде модуля).

       Также  заметим,  что  если  устройства  с  последовательным доступом или смены носителя не
       обнаружены, то ядро SCSI не привлекается из показанного выше сценария.

   Ленточные устройства SCSI, подключаемые во время работы (hot plug)
       Поддерживается подключение ленточных устройств SCSI без выключения машины.  Драйвер  cciss
       должен быть уведомлён об изменениях на шине SCSI. Это можно сделать через файловую систему
       /proc. Пример:

                  echo "rescan" > /proc/scsi/cciss0/1

       Это заставляет драйвер:

              (1)  Опросить адаптер об изменениях на  физических  шинах  SCSI  и/или  управляемой
                   петли (arbitrated loop) fibre channel;

              (2)  Определить  все новые или удалённые устройства с последовательным доступом или
                   смены носителя;

       Драйвер выводит сообщения о добавленных или удалённых  устройствах,  а  также  контроллер,
       шину,  назначение  и  lun  каждого  используемого  устройства.  Также,  драйвер уведомляет
       промежуточный слой SCSI об этих изменениях.

       Заметим, что по соглашению об именовании кроме имени  драйвера,  записи  файловой  системы
       /proc содержат номер (например, «cciss0» вместо «cciss», как вы могли бы ожидать).

       Замечание:  драйвер  cciss  на  промежуточном слое SCSI представляет в виде устройств SCSI
       только устройства с последовательным доступом и смены носителя. Устройства для  физических
       дисков    SCSI   не   представляются  на  промежуточном  слое  SCSI.  Дисковые  устройства
       представляются ядром как логические  устройства,  который  контроллер  массива  собрал  из
       частей  физических  дисков.  Логические устройства представляются на блочном уровне (не на
       промежуточном слое SCSI). Это важно для драйвера — не дать прямой доступ ядру к физическим
       дискам,  так  как  устройства  используются  контроллером  массива  для  сборки логических
       устройств.

   Обработка ошибок SCSI для ленточных устройств и устройств смены носителя
       Промежуточный слой Linux SCSI предоставляет порядок (protocol) обработки  ошибок,  который
       запускается,  если команда SCSI выполнилась с ошибкой определённое количество раз (которое
       может зависеть от команды). Драйвер cciss следует этому порядку с некоторыми  изменениями.
       Обычный порядок состоит из четырёх шагов:

       (1)  Устройству указывается прервать работу команды.

       (2)  Если это не сработало, устройство сбрасывается (reset).

       (3)  Если это не сработало, сбрасывается шина SCSI.

       (4)  Если это не сработало, сбрасывается адаптер шины узла.

       Как  драйвер SCSI, cciss является блочным и только ленточные устройства и устройства смены
       носителя представлены на промежуточном уровне  SCSI.  Кроме  этого,  в  отличие  от  более
       простых  драйверов  SCSI,  дисковый  ввод-вывод  продолжается через блочную часть во время
       процесса восстановления после ошибки SCSI. Поэтому драйвер cciss выполняет  только  первые
       два  шага: прерывание команды и сброс устройства. Также заметим, что большинству ленточных
       устройств не поможет прерывание команды и, иногда, они даже не подчиняются  этой  команде,
       хотя очень редко. Если команда не может быть прервана и устройство не может быть сброшено,
       то устройство переводится в неактивный режим (offline).

       Если событие обработки  ошибок  возникло  и  ленточное  устройство  успешно  сброшено  или
       последняя  команда  успешно  прервана,  то ленточное устройств может всё ещё продолжать не
       позволять выполнять ввод-вывод, пока какая-нибудь команда не поместит ленточное устройство
       в  известное положение. Как правило, вы должны перемотать ленту (например, командной mt -f
       /dev/st0 rewind) перед тем как продолжить ввод-вывод снова в ленточное устройство, которое
       было сброшено.

СМ. ТАКЖЕ

       hpsa(4), cciss_vol_status(8), hpacucli(8), hpacuxe(8)

       ⟨http://cciss.sf.net⟩,           Documentation/blockdev/cciss.txt          и          файл
       Documentation/ABI/testing/sysfs-bus-pci-devices-cciss в дереве исходного кода ядра Linux

ПЕРЕВОД

       Русский   перевод   этой    страницы    руководства    был    сделан    Azamat    Hackimov
       <azamat.hackimov@gmail.com>,  Dmitriy  S.  Seregin  <dseregin@59.ru>,  Dmitry Bolkhovskikh
       <d20052005@yandex.ru>,    Katrin    Kutepova    <blackkatelv@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⟩.