Differential D10878 Diff 28811 head/share/man/man4/mps.4

Changeset View

Standalone View

head/share/man/man4/mps.4

	.\"			.\"
	.\" Copyright (c) 2010 Spectra Logic Corporation			.\" Copyright (c) 2010 Spectra Logic Corporation
	.\" Copyright (c) 2014 LSI Corp			.\" Copyright (c) 2014 LSI Corp
	.\" Copyright (c) 2016 Avago Technologies			.\" Copyright (c) 2015-2017 Avago Technologies
	.\" Copyright (c) 2016 Broadcom Ltd.			.\" Copyright (c) 2015-2017 Broadcom Ltd.
	.\" All rights reserved.			.\" All rights reserved.
	.\"			.\"
	.\" Redistribution and use in source and binary forms, with or without			.\" Redistribution and use in source and binary forms, with or without
	.\" modification, are permitted provided that the following conditions			.\" modification, are permitted provided that the following conditions
	.\" are met:			.\" are met:
	.\" 1. Redistributions of source code must retain the above copyright			.\" 1. Redistributions of source code must retain the above copyright
	.\" notice, this list of conditions, and the following disclaimer,			.\" notice, this list of conditions, and the following disclaimer,
	.\" without modification.			.\" without modification.
	Show All 19 Lines
	.\" mps driver man page.			.\" mps driver man page.
	.\"			.\"
	.\" Author: Ken Merry <ken@FreeBSD.org>			.\" Author: Ken Merry <ken@FreeBSD.org>
	.\" Author: Stephen McConnell <slm@FreeBSD.org>			.\" Author: Stephen McConnell <slm@FreeBSD.org>
	.\"			.\"
	.\" $Id: //depot/SpectraBSD/head/share/man/man4/mps.4#6 $			.\" $Id: //depot/SpectraBSD/head/share/man/man4/mps.4#6 $
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd July 5, 2016			.Dd May 25, 2017
	.Dt MPS 4			.Dt MPS 4
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm mps			.Nm mps
	.Nd "LSI Fusion-MPT 2 IT/IR 6Gb/s Serial Attached SCSI/SATA driver"			.Nd "LSI Fusion-MPT 2 IT/IR 6Gb/s Serial Attached SCSI/SATA driver"
	.Sh SYNOPSIS			.Sh SYNOPSIS
	To compile this driver into the kernel, place these lines in the kernel			To compile this driver into the kernel, place these lines in the kernel
	configuration file:			configuration file:
	▲ Show 20 Lines • Show All 186 Lines • ▼ Show 20 Lines
	Send SSU to SSDs, but not to HDDs.			Send SSU to SSDs, but not to HDDs.
	This is the default value.			This is the default value.
	.It 2			.It 2
	Send SSU to HDDs, but not to SSDs.			Send SSU to HDDs, but not to SSDs.
	.It 3			.It 3
	Send SSU to both HDDs and SSDs.			Send SSU to both HDDs and SSDs.
	.El			.El
	.Pp			.Pp
	To control the feature for a specific adapter, set this tunable value in			To control this feature for a specific adapter, set this tunable value in
	.Xr loader.conf 5 :			.Xr loader.conf 5 :
	.Bd -literal -offset indent			.Bd -literal -offset indent
	dev.mps.X.enable_ssu			dev.mps.X.enable_ssu
	.Ed			.Ed
	.Pp			.Pp
	The same set of values are valid when setting this tunable for all adapters.			The same set of values are valid as when setting this tunable for all adapters.
	.Pp			.Pp
	SATA disks that take several seconds to spin up and fail the SATA Identify			SATA disks that take several seconds to spin up and fail the SATA Identify
	command might not be discovered by the driver.			command might not be discovered by the driver.
	This problem can sometimes be overcome by increasing the value of the spinup			This problem can sometimes be overcome by increasing the value of the spinup
	wait time in			wait time in
	.Xr loader.conf 5			.Xr loader.conf 5
	with the			with the
	.Bd -literal -offset indent			.Bd -literal -offset indent
	Show All 9 Lines
	with the			with the
	.Bd -literal -offset indent			.Bd -literal -offset indent
	dev.mps.X.spinup_wait_time=NNNN			dev.mps.X.spinup_wait_time=NNNN
	.Ed			.Ed
	.Pp			.Pp
	tunable.			tunable.
	NNNN is the number of seconds to wait for SATA devices to spin up when they fail			NNNN is the number of seconds to wait for SATA devices to spin up when they fail
	the initial SATA Identify command.			the initial SATA Identify command.
				.Pp
				The driver can map devices discovered by the adapter so that target IDs
				corresponding to a specific device persist across resets and reboots.
				In some cases it is possible for devices to lose their mapped IDs due to
				unexpected behavior from certain hardware, such as some types of enclosures.
				To overcome this problem, a tunable is provided that will force the driver to
				map devices using the Phy number associated with the device.
				This feature is not recommended if the topology includes multiple
				enclosures/expanders.
				If multiple enclosures/expanders are present in the topology, Phy numbers are
				repeated, causing all devices at these Phy numbers except the first device to
				fail enumeration.
				To control this feature for all adapters, set the
				.Bd -literal -offset indent
				hw.mps.use_phy_num
				.Ed
				.Pp
				tunable in
				.Xr loader.conf 5
				to one of these values:
				.Bl -tag -width 6n -offset indent
				.It -1
				Only use Phy numbers to map devices and bypass the driver's mapping logic.
				.It 0
				Never use Phy numbers to map devices.
				.It 1
				Use Phy numbers to map devices, but only if the driver's mapping logic fails
				to map the device that is being enumerated.
				This is the default value.
				.El
				.Pp
				To control this feature for a specific adapter, set this tunable value in
				.Xr loader.conf 5 :
				.Bd -literal -offset indent
				dev.mps.X.use_phy_num
				.Ed
				.Pp
				The same set of values are valid as when setting this tunable for all adapters.
				.Pp
	.Sh DEBUGGING			.Sh DEBUGGING
	To enable debugging prints from the			To enable debugging prints from the
	.Nm			.Nm
	driver, set the			driver, set the
	.Bd -literal -offset indent			.Bd -literal -offset indent
	hw.mps.X.debug_level			hw.mps.X.debug_level
	.Ed			.Ed
	.Pp			.Pp
	▲ Show 20 Lines • Show All 48 Lines • Show Last 20 Lines