da.4: Add some sysctl descriptions

Add descriptions for the following sysctl's:

- kern.cam.da.default_softtimeout
- kern.cam.da.disable_wp_protection
- kern.cam.da.enable_biospeedup
- kern.cam.da.enable_uma_ccbs
- kern.cam.da.poll_period
- kern.cam.da.send_ordered

While here, fix some mandocs warnings.

PR:		258727
Reported by:	Felix Johnson <felix dot the dot red at gmail dot com>
Reviewed by:	debdrup, pauamma, gbe
MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D32278
This commit is contained in:
Felix Johnson 2022-09-10 09:44:08 +02:00 committed by Gordon Bergling
parent 1b7f08b917
commit 53af9c235f

View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd December 20, 2017
.Dd September 10, 2022
.Dt DA 4
.Os
.Sh NAME
@ -133,6 +133,36 @@ variables and
.Xr loader 8
tunables:
.Bl -tag -width 12
.It Va kern.cam.da.default_softtimeout
Soft I/O timeout (ms). The default is 0.
Attempting to set this value to a
time span longer than
.It kern.cam.da.default_timeout
will return
.Dv EINVAL .
.It Va kern.cam.da.default_timeout
This variable determines how long the
.Nm
driver will wait before timing out an outstanding command.
The units for this value are seconds, and the default is currently 60
seconds.
.It Va kern.cam.da.disable_wp_protection
Disable detection of write-protected disks.
Default is disabled.
.Po
detection of write-protected disks is enabled
.Pc .
.It Va kern.cam.da.enable_biospeedup
Enable
.Dv BIO_SPEEDUP
processing.
Default is enabled.
.It Va kern.cam.da.enable_uma_ccbs
Use UMA for CCBs.
Default is enabled.
.It Va kern.cam.da.poll_period
Media polling period in seconds.
Default is 3 seconds.
.It Va kern.cam.da.retry_count
This variable determines how many times the
.Nm
@ -142,12 +172,13 @@ the
.Nm
driver dump routine.
This value currently defaults to 4.
.It Va kern.cam.da.default_timeout
This variable determines how long the
.It Va kern.cam.da.send_ordered
Send Ordered Tags.
On shutdown, step through all the
.Nm
driver will wait before timing out an outstanding command.
The units for this value are seconds, and the default is currently 60
seconds.
peripheral drivers, and if the device is still open,
sync the disk to physical media.
Default is enabled.
.It Va kern.cam.sort_io_queue
.It Va kern.cam.da . Ns Ar X Ns Va .sort_io_queue
These variables determine whether request queue should be sorted trying