summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authorbrueffer <brueffer@FreeBSD.org>2014-05-07 18:21:38 +0000
committerbrueffer <brueffer@FreeBSD.org>2014-05-07 18:21:38 +0000
commit1795275a1e2b4d7abec4b0f9e89ce3085dd894a2 (patch)
treeed356765bf2e463d88918630c70f6b254df78e1f /share
parent318358dcf467858e6cf746d43189a2e29e306127 (diff)
downloadFreeBSD-src-1795275a1e2b4d7abec4b0f9e89ce3085dd894a2.zip
FreeBSD-src-1795275a1e2b4d7abec4b0f9e89ce3085dd894a2.tar.gz
First cleanup pass: new sentence -> new line, mdoc, typos and style.
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/mrsas.4127
1 files changed, 78 insertions, 49 deletions
diff --git a/share/man/man4/mrsas.4 b/share/man/man4/mrsas.4
index 18c87e0..e49f8c7 100644
--- a/share/man/man4/mrsas.4
+++ b/share/man/man4/mrsas.4
@@ -27,21 +27,19 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
-
+.\"
.\" The views and conclusions contained in the software and documentation
.\" are those of the authors and should not be interpreted as representing
-.\" official policies,either expressed or implied, of the FreeBSD Project
+.\" official policies, either expressed or implied, of the FreeBSD Project.
.\"
.\" $FreeBSD$
.\"
-
-
-.Dd Apr 12, 2013
+.Dd May 7, 2014
.Dt MRSAS 4
.Os
.Sh NAME
.Nm mrsas
-.Nd "LSI MegaRAID 6Gb/s and 12Gb/s SAS+SATA Raid controller driver"
+.Nd "LSI MegaRAID 6Gb/s and 12Gb/s SAS+SATA RAID controller driver"
.Sh SYNOPSIS
To compile this driver into the kernel,
place the following lines in your
@@ -68,7 +66,8 @@ section for the supported devices list.
A disk (virtual disk/physical disk) attached to the
.Nm
driver will be visible to the user through
-.Xr camcontrol 8 as
+.Xr camcontrol 8
+as
.Pa /dev/da?
device nodes.
A simple management interface is also provided on a per-controller basis via the
@@ -85,7 +84,8 @@ to the
.Xr cam 4
layer and thus requires a new driver which attaches targets to the
.Xr cam 4
-layer. Older MegaRAID controllers are supported by
+layer.
+Older MegaRAID controllers are supported by
.Xr mfi 4
and will not work with
.Nm ,
@@ -97,19 +97,23 @@ drivers can detect and manage the LSI MegaRAID SAS 2208/2308/3008/3108 series of
controllers.
.Pp
The
-.Nm device.hints
+.Xr device.hints 5
option is provided to tune the
.Nm
driver's behavior for LSI MegaRAID SAS 2208/2308/3008/3108 controllers.
By default, the
.Xr mfi 4
-driver will detect these controllers. See the
+driver will detect these controllers.
+See the
.Nm PRIORITY
section to know more about driver priority for MR-Fusion devices.
.Pp
.Nm
-will provide a priority of (-30) (between BUS_PROBE_DEFAULT and
-BUS_PROBE_LOW_PRIORITY) at probe call for device id's 0x005B, 0x005D, and
+will provide a priority of (-30) (between
+.Dv BUS_PROBE_DEFAULT
+and
+.Dv BUS_PROBE_LOW_PRIORITY )
+at probe call for device id's 0x005B, 0x005D, and
0x005F so that
.Nm
does not take control of these devices without user intervention.
@@ -118,8 +122,8 @@ The
.Nm
driver supports the following hardware:
.Pp
-.Bl -bullet -compact
[ Thunderbolt 6Gbp/s MR controller ]
+.Bl -bullet -compact
.It
LSI MegaRAID SAS 9265
.It
@@ -142,8 +146,8 @@ DELL PERC H810
DELL PERC H710/P
.El
.Pp
-.Bl -bullet -compact
[ Invader/Fury 12Gpb/s MR controller ]
+.Bl -bullet -compact
.It
LSI MegaRAID SAS 9380
.It
@@ -169,7 +173,7 @@ dev.mrsas.X.disable_ocr=1
.Pp
where X is the adapter number.
.Pp
-To change the IO timeout value for a specific
+To change the I/O timeout value for a specific
.Nm
driver instance, set the following tunable value in
.Xr loader.conf 5 :
@@ -190,17 +194,14 @@ dev.mrsas.X.mrsas_fw_fault_check_delay=NN
where NN is the fault check delay value in seconds.
.Pp
The current number of active I/O commands is shown in the
-dev.mrsas.X.fw_outstanding
+.Va dev.mrsas.X.fw_outstanding
.Xr sysctl 8
variable.
.Sh DEBUGGING
To enable debugging prints from the
.Nm
driver, set the
-.Bd -literal -offset indent
-hw.mrsas.X.debug_level
-.Ed
-.Pp
+.Va hw.mrsas.X.debug_level
variable, where X is the adapter number, either in
.Xr loader.conf 5
or via
@@ -214,16 +215,20 @@ Enable tracing prints.
.It 0x04
Enable prints for driver faults.
.It 0x08
-Enable prints for OCR and IO timeout.
+Enable prints for OCR and I/O timeout.
.It 0x10
Enable prints for AEN events.
.El
.Sh PRIORITY
The
.Nm
-driver will always set a default (-30) priority in the pci subsystem for
-selection of MR-Fusion cards. (It is between BUS_PROBE_DEFAULT and
-BUS_PROBE_LOW_PRIORITY). MR-Fusion Controllers include all cards with the
+driver will always set a default (-30) priority in the PCI subsystem for
+selection of MR-Fusion cards.
+(It is between
+.Dv BUS_PROBE_DEFAULT
+and
+.Dv BUS_PROBE_LOW_PRIORITY ) .
+MR-Fusion Controllers include all cards with the
Device IDs -
0x005B,
0x005D,
@@ -231,14 +236,20 @@ Device IDs -
.Pp
The
.Xr mfi 4
-driver will set a priority of either BUS_PROBE_DEFAULT or
-BUS_PROBE_LOW_PRIORITY (depending on the device.hint setting) in the pci
-subsystem for selection of MR-Fusion cards. With the above design in place, the
+driver will set a priority of either
+.Dv BUS_PROBE_DEFAULT
+or
+.Dv BUS_PROBE_LOW_PRIORITY
+(depending on the device.hints setting) in the PCI
+subsystem for selection of MR-Fusion cards.
+With the above design in place, the
.Xr mfi 4
driver will attach to a MR-Fusion card given that it has a higher priority than
.Nm .
.Pp
-Using /boot/device.hints (as mentioned below), the user can provide a preference
+Using
+.Pa /boot/device.hints
+(as mentioned below), the user can provide a preference
for the
.Nm
driver to detect a MR-Fusion card instead of the
@@ -250,9 +261,11 @@ driver.
.Pp
At boot time, the
.Xr mfi 4
-driver will get priority to detect MR-Fusion controllers by default. Before
+driver will get priority to detect MR-Fusion controllers by default.
+Before
changing this default driver selection policy, LSI advises users to understand
-how the driver selection policy works. LSI's policy is to provide priority to
+how the driver selection policy works.
+LSI's policy is to provide priority to
the
.Xr mfi 4
driver to detect MR-Fusion cards, but allow for the ability to choose the
@@ -272,11 +285,14 @@ driver and setting hw.mfi.mrsas_enable="1".
Changing the default behavior is well tested under most conditions, but
unexpected behavior may pop up if more complex and unrealistic operations are
executed by switching between the
-.Xr mfi 4 and
+.Xr mfi 4
+and
.Nm
drivers for MR-Fusion.
-Switching drivers is designed to happen only one time. Although multiple
-switching is possible, it is not recommended. The user should decide from
+Switching drivers is designed to happen only one time.
+Although multiple
+switching is possible, it is not recommended.
+The user should decide from
.Nm Start of Day
which driver they want to use for the MR-Fusion card.
.Pp
@@ -286,7 +302,8 @@ to
.Nm .
This behavior is
.Nm Functions As Designed
-and the user needs to change the fstab
+and the user needs to change the
+.Xr fstab 5
entry manually if they are doing any experiments with
.Xr mfi 4
and
@@ -294,43 +311,50 @@ and
interoperability.
.Sh FILES
.Bl -tag -width ".Pa /dev/mrsas?" -compact
-.It /dev/da?
+.It Pa /dev/da?
array/logical disk interface
-.It /dev/mrsas?
+.It Pa /dev/mrsas?
management interface
.El
.Sh SEE ALSO
-.Xr pci 4 ,
-.Xr mfi 4 ,
.Xr cam 4 ,
+.Xr mfi 4 ,
+.Xr pci 4 ,
.Xr device.hints 5 ,
+.Xt camcontrol 8
.Sh HISTORY
The
.Nm
driver first appeared in
-.Fx 10.0 .
+.Fx 10.1 .
.Bd -ragged
.Cd "mfi Driver:"
.Xr mfi 4
-is the old FreeBSD driver which started with support for Gen-1 Controllers and
+is the old
+.Fx
+driver which started with support for Gen-1 Controllers and
was extended to support up to MR-Fusion (Device ID = 0x005B, 0x005D, 0x005F).
.Ed
.Bd -ragged
.Cd "mrsas Driver:"
.Nm
is the new driver reworked by LSI which supports Thunderbolt and onward
-products. The SAS+SATA RAID controller with device id 0x005b is referred to as
-the Thunderbolt controller throughout in this man page.
+products.
+The SAS+SATA RAID controller with device id 0x005b is referred to as
+the Thunderbolt controller throughout this man page.
.Ed
.Bd -ragged
.Nm cam aware HBA drivers:
-FreeBSD has a
+.Fx
+has a
.Xr cam 4
layer which attaches storage devices and provides a common access mechanism to
-storage controllers and attached devices. The
+storage controllers and attached devices.
+The
.Nm
driver is
-.Xr cam 4 aware and devices associated with
+.Xr cam 4
+aware and devices associated with
.Nm
can be seen using
.Xr camcontrol 8 .
@@ -358,17 +382,22 @@ driver and this manual page were written by
The driver does not support big-endian architectures at this time.
.Pp
The driver does not support alias for device name (it is required when the user
-switches between two drivers and does not want to edit /etc/fstab manually).
+switches between two drivers and does not want to edit
+.Pa /etc/fstab
+manually).
.Pp
The
.Nm
-driver exposes devices as /dev/da?, whereas
+driver exposes devices as
+.Pa /dev/da? ,
+whereas
.Xr mfi 4
-exposes deivces as /dev/mfid?
+exposes devices as
+.Pa /dev/mfid? .
.Pp
.Nm
does not support the Linux Emulator interface.
.Pp
.Nm
will not work with
-.Xr mfiutil 8
+.Xr mfiutil 8 .
OpenPOWER on IntegriCloud