Changeset View
Changeset View
Standalone View
Standalone View
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) 2017 Avago Technologies | ||||
.\" Copyright (c) 2016 Broadcom Ltd. | .\" Copyright (c) 2017 Broadcom Ltd. | ||||
ken: Usually you'll want to change the copyright to a range when a new year is added. 2016-2017 in… | |||||
.\" 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 |
Usually you'll want to change the copyright to a range when a new year is added. 2016-2017 in this case.