Differential D7043 Diff 18341 head/share/man/man4/mpr.4

Changeset View

Standalone View

head/share/man/man4/mpr.4

	Show All 32 Lines
	.\" mpr driver man page.			.\" mpr 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$			.\" $Id$
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd April 29, 2016			.Dd July 6, 2016
	.Dt MPR 4			.Dt MPR 4
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm mpr			.Nm mpr
	.Nd "LSI Fusion-MPT 3 IT/IR 12Gb/s Serial Attached SCSI/SATA driver"			.Nd "LSI Fusion-MPT 3 IT/IR 12Gb/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 101 Lines • ▼ Show 20 Lines
	variable.			variable.
	This can be used to determine whether the max_chains tunable should be			This can be used to determine whether the max_chains tunable should be
	increased to help performance.			increased to help performance.
	.Pp			.Pp
	The current number of active I/O commands is shown in the			The current number of active I/O commands is shown in the
	dev.mpr.X.io_cmds_active			dev.mpr.X.io_cmds_active
	.Xr sysctl 8			.Xr sysctl 8
	variable.			variable.
				.Ed
	.Pp			.Pp
				To set the maximum number of pages that will be used per I/O for all adapters,
				set this tunable in
				.Xr loader.conf 5 :
				.Bd -literal -offset indent
				hw.mpr.max_io_pages=NNNN
				.Ed
				.Pp
				To set the maximum number of pages that will be used per I/O for a specific
				adapter, set this tunable in
				.Xr loader.conf 5 :
				.Bd -literal -offset indent
				dev.mpr.X.max_io_pages=NNNN
				.Ed
				.Pp
				The default max_io_pages value is -1, meaning that the maximum I/O size that
				will be used per I/O will be calculated using the IOCFacts values stored in
				the controller.
				The lowest value that the driver will use for max_io_pages is 1, otherwise
				IOCFacts will be used to calculate the maximum I/O size.
				The smaller I/O size calculated from either max_io_pages or IOCFacts will be the
				maximum I/O size used by the driver.
				.Pp
	The highest number of active I/O commands seen since boot is stored in the			The highest number of active I/O commands seen since boot is stored in the
	dev.mpr.X.io_cmds_highwater			dev.mpr.X.io_cmds_highwater
	.Xr sysctl 8			.Xr sysctl 8
	variable.			variable.
	.Pp			.Pp
	Devices can be excluded from			Devices can be excluded from
	.Nm			.Nm
	control for all adapters by setting this tunable in			control for all adapters by setting this tunable in
	▲ Show 20 Lines • Show All 47 Lines • ▼ Show 20 Lines
	.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 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
	hw.mpr.spinup_wait_time=NNNN			hw.mpr.spinup_wait_time=NNNN
	.Ed			.Ed
	.Pp			.Pp
	tunable.			tunable.
	NNNN represents the number of seconds to wait for SATA devices to spin up when			NNNN represents the number of seconds to wait for SATA devices to spin up when
	the device fails the initial SATA Identify command.			the device fails the initial SATA Identify command.
	▲ Show 20 Lines • Show All 67 Lines • Show Last 20 Lines