From owner-svn-src-head@freebsd.org Fri Dec 11 21:51:01 2015 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6EDBEA04158; Fri, 11 Dec 2015 21:51:01 +0000 (UTC) (envelope-from rpokala@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 2333E1357; Fri, 11 Dec 2015 21:51:01 +0000 (UTC) (envelope-from rpokala@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id tBBLp0am016613; Fri, 11 Dec 2015 21:51:00 GMT (envelope-from rpokala@FreeBSD.org) Received: (from rpokala@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id tBBLp0TE016612; Fri, 11 Dec 2015 21:51:00 GMT (envelope-from rpokala@FreeBSD.org) Message-Id: <201512112151.tBBLp0TE016612@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rpokala set sender to rpokala@FreeBSD.org using -f From: Ravi Pokala Date: Fri, 11 Dec 2015 21:51:00 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r292123 - head/share/man/man4 X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Dec 2015 21:51:01 -0000 Author: rpokala Date: Fri Dec 11 21:50:59 2015 New Revision: 292123 URL: https://svnweb.freebsd.org/changeset/base/292123 Log: [PR 195033] Document mps.enable_ssu mps(4) sends StartStopUnit to SATA direct-access devices during shutdown. Document the tunables which control that behavior. PR: 195033 Reviewed by: scottl Approved by: jhb MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D4456 Modified: head/share/man/man4/mps.4 Modified: head/share/man/man4/mps.4 ============================================================================== --- head/share/man/man4/mps.4 Fri Dec 11 21:11:02 2015 (r292122) +++ head/share/man/man4/mps.4 Fri Dec 11 21:50:59 2015 (r292123) @@ -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.