|
Packit |
7cfc04 |
.\" Copyright (C) 2011, Hewlett-Packard Development Company, L.P.
|
|
Packit |
7cfc04 |
.\" Written by Stephen M. Cameron <scameron@beardog.cce.hp.com>
|
|
Packit |
7cfc04 |
.\"
|
|
Packit |
7cfc04 |
.\" %%%LICENSE_START(GPLv2_ONELINE)
|
|
Packit |
7cfc04 |
.\" Licensed under GNU General Public License version 2 (GPLv2)
|
|
Packit |
7cfc04 |
.\" %%%LICENSE_END
|
|
Packit |
7cfc04 |
.\"
|
|
Packit |
7cfc04 |
.\" shorthand for double quote that works everywhere.
|
|
Packit |
7cfc04 |
.ds q \N'34'
|
|
Packit |
7cfc04 |
.TH HPSA 4 2017-09-15 "Linux" "Linux Programmer's Manual"
|
|
Packit |
7cfc04 |
.SH NAME
|
|
Packit |
7cfc04 |
hpsa \- HP Smart Array SCSI driver
|
|
Packit |
7cfc04 |
.SH SYNOPSIS
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
modprobe hpsa [ hpsa_allow_any=1 ]
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.SH DESCRIPTION
|
|
Packit |
7cfc04 |
.B hpsa
|
|
Packit |
7cfc04 |
is a SCSI driver for HP Smart Array RAID controllers.
|
|
Packit |
7cfc04 |
.SS Options
|
|
Packit |
7cfc04 |
.IR "hpsa_allow_any=1" :
|
|
Packit |
7cfc04 |
This option allows the driver to attempt to operate on
|
|
Packit |
7cfc04 |
any HP Smart Array hardware RAID controller,
|
|
Packit |
7cfc04 |
even if it is not explicitly known to the driver.
|
|
Packit |
7cfc04 |
This allows newer hardware to work with older drivers.
|
|
Packit |
7cfc04 |
Typically this is used to allow installation of
|
|
Packit |
7cfc04 |
operating systems from media that predates the
|
|
Packit |
7cfc04 |
RAID controller, though it may also be used to enable
|
|
Packit |
7cfc04 |
.B hpsa
|
|
Packit |
7cfc04 |
to drive older controllers that would normally be handled by the
|
|
Packit |
7cfc04 |
.BR cciss (4)
|
|
Packit |
7cfc04 |
driver.
|
|
Packit |
7cfc04 |
These older boards have not been tested and are
|
|
Packit |
7cfc04 |
not supported with
|
|
Packit |
7cfc04 |
.BR hpsa ,
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.BR cciss (4)
|
|
Packit |
7cfc04 |
should still be used for these.
|
|
Packit |
7cfc04 |
.SS Supported hardware
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.B hpsa
|
|
Packit |
7cfc04 |
driver supports the following Smart Array boards:
|
|
Packit |
7cfc04 |
.PP
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
Smart Array P700M
|
|
Packit |
7cfc04 |
Smart Array P212
|
|
Packit |
7cfc04 |
Smart Array P410
|
|
Packit |
7cfc04 |
Smart Array P410i
|
|
Packit |
7cfc04 |
Smart Array P411
|
|
Packit |
7cfc04 |
Smart Array P812
|
|
Packit |
7cfc04 |
Smart Array P712m
|
|
Packit |
7cfc04 |
Smart Array P711m
|
|
Packit |
7cfc04 |
StorageWorks P1210m
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.PP
|
|
Packit |
7cfc04 |
.\" commit 135ae6edeb51979d0998daf1357f149a7d6ebb08
|
|
Packit |
7cfc04 |
Since Linux 4.14, the following Smart Array boards are also supported:
|
|
Packit |
7cfc04 |
.PP
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
Smart Array 5300
|
|
Packit |
7cfc04 |
Smart Array 5312
|
|
Packit |
7cfc04 |
Smart Array 532
|
|
Packit |
7cfc04 |
Smart Array 5i
|
|
Packit |
7cfc04 |
Smart Array 6400
|
|
Packit |
7cfc04 |
Smart Array 6400 EM
|
|
Packit |
7cfc04 |
Smart Array 641
|
|
Packit |
7cfc04 |
Smart Array 642
|
|
Packit |
7cfc04 |
Smart Array 6i
|
|
Packit |
7cfc04 |
Smart Array E200
|
|
Packit |
7cfc04 |
Smart Array E200i
|
|
Packit |
7cfc04 |
Smart Array E200i
|
|
Packit |
7cfc04 |
Smart Array E200i
|
|
Packit |
7cfc04 |
Smart Array E200i
|
|
Packit |
7cfc04 |
Smart Array E500
|
|
Packit |
7cfc04 |
Smart Array P400
|
|
Packit |
7cfc04 |
Smart Array P400i
|
|
Packit |
7cfc04 |
Smart Array P600
|
|
Packit |
7cfc04 |
Smart Array P700m
|
|
Packit |
7cfc04 |
Smart Array P800
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.SS Configuration details
|
|
Packit |
7cfc04 |
To configure HP Smart Array controllers,
|
|
Packit |
7cfc04 |
use the HP Array Configuration Utility (either
|
|
Packit |
7cfc04 |
.BR hpacuxe (8)
|
|
Packit |
7cfc04 |
or
|
|
Packit |
7cfc04 |
.BR hpacucli (8))
|
|
Packit |
7cfc04 |
or the Offline ROM-based Configuration Utility (ORCA)
|
|
Packit |
7cfc04 |
run from the Smart Array's option ROM at boot time.
|
|
Packit |
7cfc04 |
.SH FILES
|
|
Packit |
7cfc04 |
.SS Device nodes
|
|
Packit |
7cfc04 |
Logical drives are accessed via the SCSI disk driver
|
|
Packit |
7cfc04 |
.RB ( sd (4)),
|
|
Packit |
7cfc04 |
tape drives via the SCSI tape driver
|
|
Packit |
7cfc04 |
.RB ( st (4)),
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
the RAID controller via the SCSI generic driver
|
|
Packit |
7cfc04 |
.RB ( sg (4)),
|
|
Packit |
7cfc04 |
with device nodes named
|
|
Packit |
7cfc04 |
.IR /dev/sd* ,
|
|
Packit |
7cfc04 |
.IR /dev/st* ,
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.IR /dev/sg* ,
|
|
Packit |
7cfc04 |
respectively.
|
|
Packit |
7cfc04 |
.SS HPSA-specific host attribute files in /sys
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.I /sys/class/scsi_host/host*/rescan
|
|
Packit |
7cfc04 |
This is a write-only attribute.
|
|
Packit |
7cfc04 |
Writing to this attribute will cause the driver to scan for
|
|
Packit |
7cfc04 |
new, changed, or removed devices (e.g., hot-plugged tape drives,
|
|
Packit |
7cfc04 |
or newly configured or deleted logical drives, etc.)
|
|
Packit |
7cfc04 |
and notify the SCSI midlayer of any changes detected.
|
|
Packit |
7cfc04 |
Normally a rescan is triggered automatically
|
|
Packit |
7cfc04 |
by HP's Array Configuration Utility (either the GUI or the
|
|
Packit |
7cfc04 |
command-line variety);
|
|
Packit |
7cfc04 |
thus, for logical drive changes, the user should not
|
|
Packit |
7cfc04 |
normally have to use this attribute.
|
|
Packit |
7cfc04 |
This attribute may be useful when hot plugging devices like tape drives,
|
|
Packit |
7cfc04 |
or entire storage boxes containing preconfigured logical drives.
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.I /sys/class/scsi_host/host*/firmware_revision
|
|
Packit |
7cfc04 |
This attribute contains the firmware version of the Smart Array.
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
For example:
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
.in +4n
|
|
Packit |
7cfc04 |
.EX
|
|
Packit |
7cfc04 |
# \fBcd /sys/class/scsi_host/host4\fP
|
|
Packit |
7cfc04 |
# \fBcat firmware_revision\fP
|
|
Packit |
7cfc04 |
7.14
|
|
Packit |
7cfc04 |
.EE
|
|
Packit |
7cfc04 |
.in
|
|
Packit |
7cfc04 |
.\"
|
|
Packit |
7cfc04 |
.SS HPSA-specific disk attribute files in /sys
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.I /sys/class/scsi_disk/c:b:t:l/device/unique_id
|
|
Packit |
7cfc04 |
This attribute contains a 32 hex-digit unique ID for each logical drive.
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
For example:
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
.in +4n
|
|
Packit |
7cfc04 |
.EX
|
|
Packit |
7cfc04 |
# \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP
|
|
Packit |
7cfc04 |
# \fBcat unique_id\fP
|
|
Packit |
7cfc04 |
600508B1001044395355323037570F77
|
|
Packit |
7cfc04 |
.EE
|
|
Packit |
7cfc04 |
.in
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.I /sys/class/scsi_disk/c:b:t:l/device/raid_level
|
|
Packit |
7cfc04 |
This attribute contains the RAID level of each logical drive.
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
For example:
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
.in +4n
|
|
Packit |
7cfc04 |
.EX
|
|
Packit |
7cfc04 |
# \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP
|
|
Packit |
7cfc04 |
# \fBcat raid_level\fP
|
|
Packit |
7cfc04 |
RAID 0
|
|
Packit |
7cfc04 |
.EE
|
|
Packit |
7cfc04 |
.in
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.I /sys/class/scsi_disk/c:b:t:l/device/lunid
|
|
Packit |
7cfc04 |
This attribute contains the 16 hex-digit (8 byte) LUN ID
|
|
Packit |
7cfc04 |
by which a logical drive or physical device can be addressed.
|
|
Packit |
7cfc04 |
.IR c : b : t : l
|
|
Packit |
7cfc04 |
are the controller, bus, target, and lun of the device.
|
|
Packit |
7cfc04 |
.PP
|
|
Packit |
7cfc04 |
For example:
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
.in +4n
|
|
Packit |
7cfc04 |
.EX
|
|
Packit |
7cfc04 |
# \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP
|
|
Packit |
7cfc04 |
# \fBcat lunid\fP
|
|
Packit |
7cfc04 |
0x0000004000000000
|
|
Packit |
7cfc04 |
.EE
|
|
Packit |
7cfc04 |
.in
|
|
Packit |
7cfc04 |
.\"
|
|
Packit |
7cfc04 |
.SS Supported ioctl() operations
|
|
Packit |
7cfc04 |
For compatibility with applications written for the
|
|
Packit |
7cfc04 |
.BR cciss (4)
|
|
Packit |
7cfc04 |
driver, many, but
|
|
Packit |
7cfc04 |
not all of the ioctls supported by the
|
|
Packit |
7cfc04 |
.BR cciss (4)
|
|
Packit |
7cfc04 |
driver are also supported by the
|
|
Packit |
7cfc04 |
.B hpsa
|
|
Packit |
7cfc04 |
driver.
|
|
Packit |
7cfc04 |
The data structures used by these ioctls are described in
|
|
Packit |
7cfc04 |
the Linux kernel source file
|
|
Packit |
7cfc04 |
.IR include/linux/cciss_ioctl.h .
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD
|
|
Packit |
7cfc04 |
These three ioctls all do exactly the same thing,
|
|
Packit |
7cfc04 |
which is to cause the driver to rescan for new devices.
|
|
Packit |
7cfc04 |
This does exactly the same thing as writing to the
|
|
Packit |
7cfc04 |
hpsa-specific host "rescan" attribute.
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.B CCISS_GETPCIINFO
|
|
Packit |
7cfc04 |
Returns PCI domain, bus, device and function and "board ID" (PCI subsystem ID).
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.B CCISS_GETDRIVVER
|
|
Packit |
7cfc04 |
Returns driver version in three bytes encoded as:
|
|
Packit |
7cfc04 |
.IP
|
|
Packit |
7cfc04 |
.in +4n
|
|
Packit |
7cfc04 |
.EX
|
|
Packit |
7cfc04 |
(major_version << 16) | (minor_version << 8) |
|
|
Packit |
7cfc04 |
(subminor_version)
|
|
Packit |
7cfc04 |
.EE
|
|
Packit |
7cfc04 |
.in
|
|
Packit |
7cfc04 |
.TP
|
|
Packit |
7cfc04 |
.BR CCISS_PASSTHRU ", " CCISS_BIG_PASSTHRU
|
|
Packit |
7cfc04 |
Allows "BMIC" and "CISS" commands to be passed through to the Smart Array.
|
|
Packit |
7cfc04 |
These are used extensively by the HP Array Configuration Utility,
|
|
Packit |
7cfc04 |
SNMP storage agents, and so on.
|
|
Packit |
7cfc04 |
See
|
|
Packit |
7cfc04 |
.I cciss_vol_status
|
|
Packit |
7cfc04 |
at
|
|
Packit |
7cfc04 |
.UR http://cciss.sf.net
|
|
Packit |
7cfc04 |
.UE
|
|
Packit |
7cfc04 |
for some examples.
|
|
Packit |
7cfc04 |
.SH SEE ALSO
|
|
Packit |
7cfc04 |
.BR cciss (4),
|
|
Packit |
7cfc04 |
.BR sd (4),
|
|
Packit |
7cfc04 |
.BR st (4),
|
|
Packit |
7cfc04 |
.BR cciss_vol_status (8),
|
|
Packit |
7cfc04 |
.BR hpacucli (8),
|
|
Packit |
7cfc04 |
.BR hpacuxe (8),
|
|
Packit |
7cfc04 |
.PP
|
|
Packit |
7cfc04 |
.UR http://cciss.sf.net
|
|
Packit |
7cfc04 |
.UE ,
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.I Documentation/scsi/hpsa.txt
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.I Documentation/ABI/testing/sysfs-bus-pci-devices-cciss
|
|
Packit |
7cfc04 |
in the Linux kernel source tree
|
|
Packit |
7cfc04 |
.\" .SH AUTHORS
|
|
Packit |
7cfc04 |
.\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel
|
|
Packit |
7cfc04 |
.\" and probably some other people.
|
|
Packit |
7cfc04 |
.SH COLOPHON
|
|
Packit |
7cfc04 |
This page is part of release 4.15 of the Linux
|
|
Packit |
7cfc04 |
.I man-pages
|
|
Packit |
7cfc04 |
project.
|
|
Packit |
7cfc04 |
A description of the project,
|
|
Packit |
7cfc04 |
information about reporting bugs,
|
|
Packit |
7cfc04 |
and the latest version of this page,
|
|
Packit |
7cfc04 |
can be found at
|
|
Packit |
7cfc04 |
\%https://www.kernel.org/doc/man\-pages/.
|