From 53af9c235f5d368ce788d99e16951a167a152bbc Mon Sep 17 00:00:00 2001
From: Felix Johnson <felix.the.red@gmail.com>
Date: Sat, 10 Sep 2022 09:44:08 +0200
Subject: [PATCH] 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
---
 share/man/man4/da.4 | 49 ++++++++++++++++++++++++++++++++++++---------
 1 file changed, 40 insertions(+), 9 deletions(-)

diff --git a/share/man/man4/da.4 b/share/man/man4/da.4
index ed820c637750..3795e11c2d09 100644
--- a/share/man/man4/da.4
+++ b/share/man/man4/da.4
@@ -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,19 +172,20 @@ 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
+.It Va kern.cam.da . Ns Ar X Ns Va .sort_io_queue
 These variables determine whether request queue should be sorted trying
 to optimize head seeks.
 Set to 1 to enable sorting, 0 to disable, -1 to leave it as-is.
 The default is sorting enabled for HDDs and disabled for SSDs.
-.It Va kern.cam.da. Ns Ar X Ns Va .delete_method
+.It Va kern.cam.da . Ns Ar X Ns Va .delete_method
 This variable specifies method to handle BIO_DELETE requests:
 .Bl -tag -width "ATA_TRIM"
 .It ATA_TRIM
@@ -170,7 +201,7 @@ WRITE SAME(10) command without UNMAP flag,
 .It DISABLE
 disable BIO_DELETE support.
 .El
-.It Va kern.cam.da. Ns Ar X Ns Va .minimum_cmd_size
+.It Va kern.cam.da . Ns Ar X Ns Va .minimum_cmd_size
 This variable determines what the minimum READ/WRITE CDB size is for a
 given
 .Nm