Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 9 Jan 2016 05:07:03 +0000 (UTC)
From:      Ravi Pokala <rpokala@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-10@freebsd.org
Subject:   svn commit: r293464 - stable/10/share/man/man4
Message-ID:  <201601090507.u09573Ax030469@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: rpokala
Date: Sat Jan  9 05:07:02 2016
New Revision: 293464
URL: https://svnweb.freebsd.org/changeset/base/293464

Log:
  MFC r292123: Document mps.enable_ssu
  
  mps(4) sends StartStopUnit to SATA direct-access devices during shutdown.
  Document the tunables which control that behavior.
  
  Approved by:	jhb
  Sponsored by:	Panasas, Inc.

Modified:
  stable/10/share/man/man4/mps.4
Directory Properties:
  stable/10/   (props changed)

Modified: stable/10/share/man/man4/mps.4
==============================================================================
--- stable/10/share/man/man4/mps.4	Sat Jan  9 05:05:15 2016	(r293463)
+++ stable/10/share/man/man4/mps.4	Sat Jan  9 05:07:02 2016	(r293464)
@@ -34,7 +34,7 @@
 .\" $Id: //depot/SpectraBSD/head/share/man/man4/mps.4#6 $
 .\" $FreeBSD$
 .\"
-.Dd January 3, 2013
+.Dd December 9, 2015
 .Dt MPS 4
 .Os
 .Sh NAME
@@ -129,6 +129,8 @@ driver instance, set the following tunab
 dev.mps.X.disable_msix=1
 .Ed
 .Pp
+where X is the adapter number.
+.Pp
 To set the maximum number of DMA chains allocated for all adapters,
 set the following variable in
 .Xr loader.conf 5 :
@@ -166,6 +168,39 @@ The maximum number of active I/O command
 dev.mps.X.io_cmds_highwater
 .Xr sysctl 8
 variable.
+.Pp
+The adapter can issue the
+.Sy StartStopUnit
+SCSI command to SATA direct-access devices during shutdown, to allow the
+device to quiesce before being powered down.
+To control this feature for all adapters, set the
+.Bd -literal -offset indent
+hw.mps.enable_ssu
+.Ed
+.Pp
+tunable value in
+.Xr loader.conf 5
+to one of the following values:
+.Bl -tag -width 6n -offset indent
+.It 0
+Do not send SSU to either HDDs or SSDs.
+.It 1
+Send SSU to SSDs, but not to HDDs; this is the default value.
+.It 2
+Send SSU to HDDs, but not to SSDs.
+.It 3
+Send SSU to both HDDs and SSDs.
+.El
+.Pp
+To control the feature for a specific adapter, set the following tunable
+value in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+dev.mps.X.enable_ssu
+.Ed
+.Pp
+where X is the adapter number.
+The same set of values are valid as for all adapters.
 .Sh DEBUGGING
 To enable debugging prints from the
 .Nm
@@ -218,7 +253,7 @@ This man page was written by
 This driver has a couple of known shortcomings:
 .Bl -bullet -compact
 .It
-No userland utility available (e.g.
+No userland utility available (e.g.,
 .Xr mptutil 8 ) .
 .It
 The driver probes devices sequentially.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201601090507.u09573Ax030469>