svn commit: r219678 - stable/8/share/man/man4

[Kenneth D. Merry]

Author: ken
Date: Tue Mar 15 21:34:10 2011
New Revision: 219678
URL: http://svn.freebsd.org/changeset/base/219678

Log:
  MFC: 212624, 212669, 213535
  
  Merge the mps(4) man page.
  
    r212624 | ken | 2010-09-14 15:40:29 -0600 (Tue, 14 Sep 2010) | 7 lines
  
    MFp4 (//depot/projects/mps/...)
  
    Add a man page for the mps(4) driver, and reference it in the
    mpt(4) driver man page.
  
    Sponsored by:   Spectra Logic Corporation
  
    r212669 | ken | 2010-09-15 10:05:51 -0600 (Wed, 15 Sep 2010) | 6 lines
  
    MFp4 (//depot/projects/mps/...)
  
    Fix a typo.
  
    Submitted by:   pluknet at gmail dot com
  
    r213535 | ken | 2010-10-07 15:56:10 -0600 (Thu, 07 Oct 2010) | 36 lines
  
    Turn on serialization of task management commands going down to the
    controller, but make it optional.
  
    After a problem report from Andrew Boyer, it looks like the LSI
    chip may have issues (the watchdog timer fired) if too many aborts
    are sent down to the chip at the same time.  We know that task
    management commands are serialized, and although the manual doesn't
    say it, it may be a good idea to just send one at a time.
  
    But, since I'm not certain that this is necessary, add a tunable
    and sysctl variable (hw.mps.%d.allow_multiple_tm_cmds) to control
    the driver's behavior.
  
    mps.c:		Add support for the sysctl and tunable, and add a
    		comment about the possible return values to
    		mps_map_command().
  
    mps_sas.c:	Run all task management commands through two new
    		routines, mpssas_issue_tm_request() and
    		mpssas_complete_tm_request().
  
    		This allows us to optionally serialize task
    		management commands.  Also, change things so that
    		the response to a task management command always
    		comes back through the callback.  (Before it could
    		come via the callback or the return value.)
  
    mpsvar.h:	Add softc variables for the list of active task
    		management commands, the number of active commands,
    		and whether we should allow multiple active task
    		management commands.  Add an active command flag.
  
    mps.4:		Describe the new sysctl/loader tunable variable.
  
    Sponsored by:   Spectra Logic Corporation
  
  Reminded by:	Hubert Tournier <hubert at frbsd dot org>

Added:
  stable/8/share/man/man4/mps.4
     - copied, changed from r212624, head/share/man/man4/mps.4
Modified:
  stable/8/share/man/man4/Makefile
  stable/8/share/man/man4/mpt.4
Directory Properties:
  stable/8/share/man/man4/   (props changed)

Modified: stable/8/share/man/man4/Makefile
==============================================================================
--- stable/8/share/man/man4/Makefile	Tue Mar 15 20:24:21 2011	(r219677)
+++ stable/8/share/man/man4/Makefile	Tue Mar 15 21:34:10 2011	(r219678)
@@ -218,6 +218,7 @@ MAN=	aac.4 \
 	mmcsd.4 \
 	mn.4 \
 	mouse.4 \
+	mps.4 \
 	mpt.4 \
 	msk.4 \
 	mtio.4 \

Copied and modified: stable/8/share/man/man4/mps.4 (from r212624, head/share/man/man4/mps.4)
==============================================================================
--- head/share/man/man4/mps.4	Tue Sep 14 21:40:29 2010	(r212624, copy source)
+++ stable/8/share/man/man4/mps.4	Tue Mar 15 21:34:10 2011	(r219678)
@@ -31,7 +31,7 @@
 .\"
 .\" Author: Ken Merry <ken at FreeBSD.org>
 .\"
-.\" $Id: //depot/SpectraBSD/head/share/man/man4/mps.4#1 $
+.\" $Id: //depot/SpectraBSD/head/share/man/man4/mps.4#4 $
 .\" $FreeBSD$
 .\"
 .Dd September 13, 2010
@@ -51,7 +51,7 @@ place the following lines in your kernel
 Or, to load the driver as a module at boot, place the following line in
 .Xr loader.conf 5 :
 .Bd -literal -offset indent
-mpt_load="YES"
+mps_load="YES"
 .Ed
 .Sh DESCRIPTION
 The
@@ -97,6 +97,20 @@ driver instances, set the following tuna
 .Bd -literal -offset indent
 hw.mps.disable_msix=1
 .Ed
+.Pp
+To allow the driver to send multiple task management commands (like abort,
+LUN reset, etc.), set the following variable:
+.Bd -literal -offset indent
+hw.mps.X.allow_multiple_tm_cmds=1
+.Ed
+.Pp
+via
+.Xr loader.conf 5
+or
+.Xr sysctl 8 ,
+where X is the adapter number.
+By default the driver only sends one task management command at a time, to
+avoid causing a potential controller lock-up.
 .Sh DEBUGGING
 To enable debugging prints from the
 .Nm

Modified: stable/8/share/man/man4/mpt.4
==============================================================================
--- stable/8/share/man/man4/mpt.4	Tue Mar 15 20:24:21 2011	(r219677)
+++ stable/8/share/man/man4/mpt.4	Tue Mar 15 21:34:10 2011	(r219678)
@@ -152,6 +152,7 @@ can take on - no separate compilation is
 .Xr cd 4 ,
 .Xr ch 4 ,
 .Xr da 4 ,
+.Xr mps 4 ,
 .Xr pci 4 ,
 .Xr sa 4 ,
 .Xr scsi 4 ,