# smartpqi(4) - man - phpMan

[SMARTPQI(4)](https://www.chedong.com/phpMan.php/man/SMARTPQI/4/markdown)                           Linux Programmer's Manual                          [SMARTPQI(4)](https://www.chedong.com/phpMan.php/man/SMARTPQI/4/markdown)



## NAME
       smartpqi - Microsemi Smart Family SCSI driver

## SYNOPSIS
       **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**}]

## DESCRIPTION
       **smartpqi** is a SCSI driver for Microsemi Smart Family controllers.

   **Supported** _i_i_o_o_c_c_t_t_l_l**()** **operations**
       For  compatibility  with applications written for the [**cciss**(4)](https://www.chedong.com/phpMan.php/man/cciss/4/markdown) and [**hpsa**(4)](https://www.chedong.com/phpMan.php/man/hpsa/4/markdown) drivers, many, but
       not all of the [**ioctl**(2)](https://www.chedong.com/phpMan.php/man/ioctl/2/markdown) operations supported by the **hpsa** driver are  also  supported  by  the
       **smartpqi**  driver.   The  data  structures used by these operations are described in the Linux
       kernel source file _include/linux/cciss_ioctl.h_.

       **CCISS**___**DEREGDISK**, **CCISS**___**REGNEWDISK**, **CCISS**___**REGNEWD**
              These operations all do exactly the same thing, which is to cause the  driver  to  re-
              scan  for  new  devices.  This does exactly the same thing as writing to the **smartpqi**-
              specific host _rescan_ attribute.

       **CCISS**___**GETPCIINFO**
              This operation Returns the PCI domain, bus, device and function and  "board  ID"  (PCI
              subsystem ID).

       **CCISS**___**GETDRIVVER**
              This operation returns the driver version in four bytes, encoded as:

                  (major_version << 28) | (minor_version << 24) |
                          (release << 16) | revision

       **CCISS**___**PASSTHRU**
              Allows BMIC and CISS commands to be passed through to the controller.

### Boot options
       **disable**___**device**___**id**___**wildcards=**{**0**|**1**}
              Disables support for device ID wildcards.  The default value is 0.

       **disable**___**heartbeat=**{**0**|**1**}
              Disables support for the controller's heartbeat check.  This parameter is used for de‐
              bugging purposes.  The default value is 0, leaving the  controller's  heartbeat  check
              active.

       **disable**___**ctrl**___**shutdown=**{**0**|**1**}
              Disables support for shutting down the controller in the event of a controller lockup.
              The default value is 0.

       **lockup**___**action=**{**none**|**reboot**|**panic**}
              Specifies the action the driver takes when a controller lockup is detected.   The  de‐
              fault action is **none**.

              parameter   action
              ─────────────────────────────────────────────
              **none**        take controller offline only
              **reboot**      reboot the system
              **panic**       panic the system

       **expose**___**ld**___**first=**{**0**|**1**}
              This  option  enables support for exposing logical devices to the operating system be‐
              fore physical devices.  The default value is 0.

       **hide**___**vsep=**{**0**|**1**}
              This option enables disabling exposure of the virtual SEP to the host.  This  is  usu‐
              ally associated with direct attached drives.  The default value is 0.

## FILES
### Device nodes
       Logical  drives  are  accessed  via  the SCSI disk driver (_sd_), tape drives via the SCSI tape
       driver (_st_), and the RAID controller via the SCSI generic  driver  (_sg_),  with  device  nodes
       named _/dev/sd_*, _/dev/st_*, and _/dev/sg_*, respectively.

   **SmartPQI-specific** **host** **attribute** **files** **in** _/_/_s_s_y_y_s_s
       _/sys/class/scsi_host/host_*_/rescan_
              The  host  _rescan_ attribute is a write-only attribute.  Writing to this attribute will
              cause the driver to scan for new, changed, or removed devices (e.g., hot-plugged  tape
              drives,  or  newly configured or deleted logical drives) and notify the SCSI mid-layer
              of any changes detected.  Usually this action is triggered automatically by configura‐
              tion  changes,  so  the user should not normally have to write to this file.  Doing so
              may be useful when hot-plugging devices such as tape drives or  entire  storage  boxes
              containing pre-configured logical drives.

       _/sys/class/scsi_host/host_*_/version_
              The  host  _version_  attribute  is  a read-only attribute.  This attribute contains the
              driver version and the controller firmware version.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/version**
                  driver: 1.1.2-126
                  firmware: 1.29-112

       _/sys/class/scsi_host/host_*_/lockup_action_
              The host _lockup_action_ attribute is a read/write attribute.  This attribute will cause
              the driver to perform a specific action in the unlikely event that a controller lockup
              has been detected.  See **OPTIONS** above for an explanation of the _lockup_action_ values.

       _/sys/class/scsi_host/host*/driver_version_
              The _driver_version_ attribute is  read-only.   This  attribute  contains  the  smartpqi
              driver version.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/driver**___**version**
                  1.1.2-126

       _/sys/class/scsi_host/host*/firmware_version_
              The  _firmware_version_  attribute is read-only.  This attribute contains the controller
              firmware version.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/firmware**___**version**
                  1.29-112

       _/sys/class/scsi_host/host*/model_
              The _model_ attribute is read-only.  This attribute contains the product  identification
              string of the controller.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/model**
                  1100-16i

       _/sys/class/scsi_host/host*/serial_number_
              The  _serial_number_ attribute is read-only.  This attribute contains the unique identi‐
              fication number of the controller.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/serial**___**number**
                  6A316373777

       _/sys/class/scsi_host/host*/vendor_
              The _vendor_ attribute is read-only.  This attribute contains the vendor  identification
              string of the controller.

              For example:

                  $ **cat** **/sys/class/scsi**___**host/host1/vendor**
                  Adaptec

   **SmartPQI-specific** **disk** **attribute** **files** **in** _/_/_s_s_y_y_s_s
       In the file specifications below, _c_ stands for the number of the appropriate SCSI controller,
       _b_ is the bus number, _t_ the target number, and _l_ is the logical unit number (LUN).

       _/sys/class/scsi_disk/_c_:_b_:_t_:_l_/device/raid_level_
              The _raid_level_ attribute is read-only.  This attribute contains the RAID level of each
              logical drive.

              For example:

                  $ **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_
              The _sas_address_ attribute is read-only.  This attribute contains the unique identifier
              of the disk.

              For example:

                  $ **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_
              The _ssd_smart_path_enabled_ attribute is read-only.  This attribute is for  ioaccel-en‐
              abled  volumes.   (Ioaccel  is  an  alternative driver submission path that allows the
              driver to send I/O requests directly to backend SCSI devices, bypassing the controller
              firmware.   This  results  in an increase in performance.  This method is used for HBA
              disks and for logical volumes comprised of SSDs.)  Contains 1 if  ioaccel  is  enabled
              for the volume and 0 otherwise.

              For example:

                  $ **cat** **/sys/class/scsi**___**disk/1:0:3:0/device/ssd**___**smart**___**path**___**enabled**
                  0

## VERSIONS
       The **smartpqi** driver was added in Linux 4.9.

## NOTES
### Configuration
       To configure a Microsemi Smart Family controller, refer to the User Guide for the controller,
       which    can    be    found    by    searching    for    the    specific    controller     at
       ⟨<https://storage.microsemi.com/>⟩.

## SEE ALSO
       [**cciss**(4)](https://www.chedong.com/phpMan.php/man/cciss/4/markdown), [**hpsa**(4)](https://www.chedong.com/phpMan.php/man/hpsa/4/markdown), [**sd**(4)](https://www.chedong.com/phpMan.php/man/sd/4/markdown), [**st**(4)](https://www.chedong.com/phpMan.php/man/st/4/markdown)

       _Documentation/ABI/testing/sysfs-bus-pci-devices-cciss_ in the Linux kernel source tree.

## COLOPHON
       This  page  is  part  of  release  5.10 of the Linux _man-pages_ project.  A description of the
       project, information about reporting bugs, and the latest version of this page, can be  found
       at <https://www.kernel.org/doc/man-pages/>.



Linux                                        2019-10-10                                  [SMARTPQI(4)](https://www.chedong.com/phpMan.php/man/SMARTPQI/4/markdown)