mirror of https://github.com/mkerrisk/man-pages
hpsa.4: New man page for the hpsa driver
I obtained the information in this man page as a consequence of being the main author of the hpsa driver Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Stephen M. Cameron
Michael Kerrisk
parent
4fa0ef7e81
commit
b9d931bb0b
|
|
@ -0,0 +1,142 @@
|
|||
.\" shorthand for double quote that works everywhere.
|
||||
.ds q \N'34'
|
||||
.TH HPSA 4 "hpsa"
|
||||
.SH NAME
|
||||
hpsa \- HP Smart Array SCSI driver
|
||||
.SH SYNOPSIS
|
||||
.nf
|
||||
modprobe hpsa [ hpsa_allow_any=1 ]
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
.B hpsa
|
||||
is a SCSI driver for HP Smart Array RAID controllers.
|
||||
.SH OPTIONS
|
||||
.HP
|
||||
hpsa_allow_any=1
|
||||
This option allows the driver to attempt to operate on
|
||||
any HP Smart Array hardware RAID controller even if it is
|
||||
not explicitly known to the driver. This allows newer hardware
|
||||
to work with older drivers. Typically this is used for example
|
||||
to allow installation of OSes from media which predates the
|
||||
RAID controller though it may also be used to enable hpsa to
|
||||
drive older controllers that would normally be handled by the
|
||||
cciss driver. These older boards have not been tested and are
|
||||
not supported with hpsa and cciss should still be used for these.
|
||||
|
||||
.SH SUPPORTED HARDWARE
|
||||
The
|
||||
.B hpsa
|
||||
driver supports the following Smart Array boards:
|
||||
.nf
|
||||
|
||||
Smart Array P700M
|
||||
Smart Array P212
|
||||
Smart Array P410
|
||||
Smart Array P410i
|
||||
Smart Array P411
|
||||
Smart Array P812
|
||||
Smart Array P712m
|
||||
Smart Array P711m
|
||||
StorageWorks P1210m
|
||||
|
||||
.fi
|
||||
.SH CONFIGURATION DETAILS
|
||||
To configure HP Smart Array controllers, use the HP Array Configuration Utility
|
||||
(either hpacuxe or hpacucli) or the Offline ROM-based Configuration Utility (ORCA)
|
||||
run from the Smart Array's option ROM at boot time.
|
||||
.SH FILES
|
||||
.SS DEVICE NODES
|
||||
Logical drives are accessed via the SCSI disk driver (sd),
|
||||
tape drives via the SCSI tape driver (st), and
|
||||
the RAID controller vi the SCSI generic driver (sg), with
|
||||
device nodes named /dev/sd*, /dev/st*, and /dev/sg*, respectively.
|
||||
.SS HPSA SPECIFIC HOST ATTRIBUTE FILES IN /sys
|
||||
|
||||
.HP
|
||||
/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,
|
||||
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.
|
||||
|
||||
.HP
|
||||
/sys/class/scsi_host/host*/firmware_revision
|
||||
The "firmware_revision" attribute contains the firmware version of the Smart Array.
|
||||
For example:
|
||||
.nf
|
||||
root@host:/sys/class/scsi_host/host4# cat firmware_revision
|
||||
7.14
|
||||
.fi
|
||||
|
||||
.SS HPSA SPECIFIC DISK ATTRIBUTE FILES IN /sys
|
||||
|
||||
.HP
|
||||
/sys/class/scsi_disk/c:b:t:l/device/unique_id
|
||||
contains a 32 hex-digit unique ID for each logical drive
|
||||
.nf
|
||||
For example:
|
||||
|
||||
root@host:/sys/class/scsi_disk/4:0:0:0/device# cat unique_id
|
||||
600508B1001044395355323037570F77
|
||||
.fi
|
||||
.HP
|
||||
/sys/class/scsi_disk/c:b:t:l/device/raid_level
|
||||
contains the RAID level of each logical drive.
|
||||
.nf
|
||||
For example:
|
||||
root@host:/sys/class/scsi_disk/4:0:0:0/device# cat raid_level
|
||||
RAID 0
|
||||
.fi
|
||||
.HP
|
||||
/sys/class/scsi_disk/c:b:t:l/device/lunid
|
||||
(where c:b:t:l are the controller, bus, target and lun of the device)
|
||||
contains 16 hex-digit (8 byte) LUN ID by which a logical drive or
|
||||
physical device can be addressed.
|
||||
.nf
|
||||
For example:
|
||||
root@host:/sys/class/scsi_disk/4:0:0:0/device# cat lunid
|
||||
0x0000004000000000
|
||||
.fi
|
||||
.SH SUPPORTED IOCTLS
|
||||
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
|
||||
.HP
|
||||
CCISS_DEREGDISK
|
||||
CCISS_REGNEWDISK
|
||||
CCISS_REGNEWD
|
||||
|
||||
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.
|
||||
|
||||
.HP
|
||||
CCISS_GETPCIINFO
|
||||
Returns PCI domain, bus, device and function and "board ID" (PCI subsystem ID).
|
||||
|
||||
.HP
|
||||
CCISS_GETDRIVVER
|
||||
Returns driver version in three bytes encoded as:
|
||||
(major_version << 16) | (minor_version << 8) | (subminor_version)
|
||||
|
||||
.HP
|
||||
CCISS_PASSTHRU
|
||||
CCISS_BIG_PASSTHRU
|
||||
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 http://cciss.sf.net for some examples.
|
||||
|
||||
|
||||
.SH "SEE ALSO"
|
||||
cciss(4), hpacucli(8), sd(4), st(4),
|
||||
hpacuxe(8), cciss_vol_status(8), http://cciss.sf.net,
|
||||
and from the linux kernel source, Documentation/scsi/hpsa.txt and
|
||||
Documentation/ABI/testing/sysfs-bus-pci-devices-cciss
|
||||
.SH AUTHORS
|
||||
Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel
|
||||
and probably some other people.
|
||||
Loading…
Reference in New Issue