<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>HPSA - Hewlett Packard Smart Array driver — The Linux Kernel documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=3918102e" />
<script src="../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../_static/doctools.js?v=9bcbadda"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Highpoint RocketRAID 3xxx/4xxx Adapter Driver (hptiop)" href="hptiop.html" />
<link rel="prev" title="g_NCR5380 driver" href="g_NCR5380.html" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
</head><body>
<div class="document">
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/logo.svg" alt="Logo of The Linux Kernel"/>
</a></p>
<h1 class="logo"><a href="../index.html">The Linux Kernel</a></h1>
<p class="blurb">6.18.50</p>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<p>
<h3 class="kernel-toc-contents">Contents</h3>
<input type="checkbox" class="kernel-toc-toggle" id = "kernel-toc-toggle" checked>
<label class="kernel-toc-title" for="kernel-toc-toggle"></label>
<div class="kerneltoc" id="kerneltoc">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/development-process.html">Development process</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/submitting-patches.html">Submitting patches</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/code-of-conduct.html">Code of conduct</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintainer/index.html">Maintainer handbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/index.html">All development-process docs</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../core-api/index.html">Core API</a></li>
<li class="toctree-l1"><a class="reference internal" href="../driver-api/index.html">Driver APIs</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../subsystem-apis.html">Subsystems</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#core-subsystems">Core subsystems</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#human-interfaces">Human interfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#networking-interfaces">Networking interfaces</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../subsystem-apis.html#storage-interfaces">Storage interfaces</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../filesystems/index.html">Filesystems in the Linux kernel</a></li>
<li class="toctree-l3"><a class="reference internal" href="../block/index.html">Block</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cdrom/index.html">CD-ROM</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html">SCSI Subsystem</a></li>
<li class="toctree-l3"><a class="reference internal" href="../target/index.html">TCM Virtual Device</a></li>
<li class="toctree-l3"><a class="reference internal" href="../nvme/index.html">NVMe Subsystem</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#other-subsystems">Other subsystems</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../locking/index.html">Locking</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/license-rules.html">Licensing rules</a></li>
<li class="toctree-l1"><a class="reference internal" href="../doc-guide/index.html">Writing documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/index.html">Development tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/testing-overview.html">Testing guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kernel-hacking/index.html">Hacking guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../trace/index.html">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../fault-injection/index.html">Fault injection</a></li>
<li class="toctree-l1"><a class="reference internal" href="../livepatch/index.html">Livepatching</a></li>
<li class="toctree-l1"><a class="reference internal" href="../rust/index.html">Rust</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/index.html">Administration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kbuild/index.html">Build system</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/reporting-issues.html">Reporting issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">Userspace tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../userspace-api/index.html">Userspace API</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../firmware-guide/index.html">Firmware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../devicetree/index.html">Firmware and Devicetree</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../arch/index.html">CPU architectures</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../staging/index.html">Unsorted documentation</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../translations/index.html">Translations</a></li>
</ul>
</div>
<script type="text/javascript"> <!--
var sbar = document.getElementsByClassName("sphinxsidebar")[0];
let currents = document.getElementsByClassName("current")
if (currents.length) {
sbar.scrollTop = currents[currents.length - 1].offsetTop;
}
--> </script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/scsi/hpsa.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="hpsa-hewlett-packard-smart-array-driver">
<h1>HPSA - Hewlett Packard Smart Array driver<a class="headerlink" href="#hpsa-hewlett-packard-smart-array-driver" title="Link to this heading">¶</a></h1>
<p>This file describes the hpsa SCSI driver for HP Smart Array controllers.
The hpsa driver is intended to supplant the cciss driver for newer
Smart Array controllers. The hpsa driver is a SCSI driver, while the
cciss driver is a “block” driver. Actually cciss is both a block
driver (for logical drives) AND a SCSI driver (for tape drives). This
“split-brained” design of the cciss driver is a source of excess
complexity and eliminating that complexity is one of the reasons
for hpsa to exist.</p>
<section id="supported-devices">
<h2>Supported devices<a class="headerlink" href="#supported-devices" title="Link to this heading">¶</a></h2>
<ul class="simple">
<li><p>Smart Array P212</p></li>
<li><p>Smart Array P410</p></li>
<li><p>Smart Array P410i</p></li>
<li><p>Smart Array P411</p></li>
<li><p>Smart Array P812</p></li>
<li><p>Smart Array P712m</p></li>
<li><p>Smart Array P711m</p></li>
<li><p>StorageWorks P1210m</p></li>
</ul>
<p>Additionally, older Smart Arrays may work with the hpsa driver if the kernel
boot parameter “hpsa_allow_any=1” is specified, however these are not tested
nor supported by HP with this driver. For older Smart Arrays, the cciss
driver should still be used.</p>
<p>The “hpsa_simple_mode=1” boot parameter may be used to prevent the driver from
putting the controller into “performant” mode. The difference is that with simple
mode, each command completion requires an interrupt, while with “performant mode”
(the default, and ordinarily better performing) it is possible to have multiple
command completions indicated by a single interrupt.</p>
</section>
<section id="hpsa-specific-entries-in-sys">
<h2>HPSA specific entries in /sys<a class="headerlink" href="#hpsa-specific-entries-in-sys" title="Link to this heading">¶</a></h2>
<blockquote>
<div><p>In addition to the generic SCSI attributes available in /sys, hpsa supports
the following attributes:</p>
</div></blockquote>
</section>
<section id="hpsa-specific-host-attributes">
<h2>HPSA specific host attributes<a class="headerlink" href="#hpsa-specific-host-attributes" title="Link to this heading">¶</a></h2>
<blockquote>
<div><div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/sys/class/scsi_host/host*/rescan
/sys/class/scsi_host/host*/firmware_revision
/sys/class/scsi_host/host*/resettable
/sys/class/scsi_host/host*/transport_mode
</pre></div>
</div>
<p>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,
etc.) and notify the SCSI midlayer of any changes detected. Normally this is
triggered automatically by HP’s Array Configuration Utility (either the GUI or
command line variety) so for logical drive changes, the user should not
normally have to use this. It may be useful when hot plugging devices like
tape drives, or entire storage boxes containing pre-configured logical drives.</p>
<p>The “firmware_revision” attribute contains the firmware version of the Smart Array.
For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>root@host:/sys/class/scsi_host/host4# cat firmware_revision
7.14
</pre></div>
</div>
<p>The transport_mode indicates whether the controller is in “performant”
or “simple” mode. This is controlled by the “hpsa_simple_mode” module
parameter.</p>
<p>The “resettable” read-only attribute indicates whether a particular
controller is able to honor the “reset_devices” kernel parameter. If the
device is resettable, this file will contain a “1”, otherwise, a “0”. This
parameter is used by kdump, for example, to reset the controller at driver
load time to eliminate any outstanding commands on the controller and get the
controller into a known state so that the kdump initiated i/o will work right
and not be disrupted in any way by stale commands or other stale state
remaining on the controller from the previous kernel. This attribute enables
kexec tools to warn the user if they attempt to designate a device which is
unable to honor the reset_devices kernel parameter as a dump device.</p>
</div></blockquote>
<section id="hpsa-specific-disk-attributes">
<h3>HPSA specific disk attributes<a class="headerlink" href="#hpsa-specific-disk-attributes" title="Link to this heading">¶</a></h3>
<blockquote>
<div><div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/sys/class/scsi_disk/c:b:t:l/device/unique_id
/sys/class/scsi_disk/c:b:t:l/device/raid_level
/sys/class/scsi_disk/c:b:t:l/device/lunid
</pre></div>
</div>
<p>(where c:b:t:l are the controller, bus, target and lun of the device)</p>
<p>For example:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>root@host:/sys/class/scsi_disk/4:0:0:0/device# cat unique_id
600508B1001044395355323037570F77
root@host:/sys/class/scsi_disk/4:0:0:0/device# cat lunid
0x0000004000000000
root@host:/sys/class/scsi_disk/4:0:0:0/device# cat raid_level
RAID 0
</pre></div>
</div>
</div></blockquote>
</section>
</section>
<section id="hpsa-specific-ioctls">
<h2>HPSA specific ioctls<a class="headerlink" href="#hpsa-specific-ioctls" title="Link to this heading">¶</a></h2>
<blockquote>
<div><p>For compatibility with applications written for the cciss driver, many, but
not all of the ioctls supported by the cciss driver are also supported by the
hpsa driver. The data structures used by these are described in
include/linux/cciss_ioctl.h</p>
<dl>
<dt>CCISS_DEREGDISK, CCISS_REGNEWDISK, CCISS_REGNEWD</dt><dd><p>The above three ioctls all do exactly the same thing, which is to cause the driver
to rescan for new devices. This does exactly the same thing as writing to the
hpsa specific host “rescan” attribute.</p>
</dd>
<dt>CCISS_GETPCIINFO</dt><dd><p>Returns PCI domain, bus, device and function and “board ID” (PCI subsystem ID).</p>
</dd>
<dt>CCISS_GETDRIVVER</dt><dd><p>Returns driver version in three bytes encoded as:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>(major_version << 16) | (minor_version << 8) | (subminor_version)
</pre></div>
</div>
</dd>
<dt>CCISS_PASSTHRU, CCISS_BIG_PASSTHRU</dt><dd><p>Allows “BMIC” and “CISS” commands to be passed through to the Smart Array.
These are used extensively by the HP Array Configuration Utility, SNMP storage
agents, etc. See cciss_vol_status at <a class="reference external" href="http://cciss.sf.net">http://cciss.sf.net</a> for some examples.</p>
</dd>
</dl>
</div></blockquote>
</section>
</section>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©The kernel development community.
|
Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
& <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
|
<a href="../_sources/scsi/hpsa.rst.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>