From nobody Wed Sep 16 12:05:05 2026 X-Original-To: dev-commits-src-branches@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4hlHdG1st1z6t6cQ for ; Wed, 16 Sep 2026 12:05:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hlHdF5tlnz4L2P for ; Wed, 16 Sep 2026 12:05:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560305; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hlQhyVn1XCsWxNL4oapUajKl7reYp9DrCbBFlnggTZ4=; b=xFtDdCBK3If//9WZN+SE7bu+Ob97u2WQlv5ZFtaxiTTEq2YkudUZtI5+cWwt+MWGX7ZlZW vrVB5fSDNZTDJvRWuV2LXlyXWkz+qU0CSYWflqu0IRmMBEKV5lhNmUFPxQvgot1U8OU3wj k313BQDDSk6hfxUvV0/wHvzaKTqf/doA3vV7kZv4d7cIZK/vnAwZ4cfXuz6JPsgsF5fJ/o 2M0mj/Lg2AjwUKjFUqu2DD9N01rH+8dNVJxEh+EzJXnT/23Q+56H3QE3jfmlPt+3y/WIIj LA4Qe46BM7hIdFiPhmD5myApd619XJ6RWVXlZGqaJdiPALCQbn3KLtFUrdrAdQ== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789560305; b=wof3xI39HBBbmnHk3DjDLXzRmUhEQsvFm5+4QCpilBm+GQNWQIcqP5AhRzq5zCs+3rxOHp CrxX6SjsLsaOvI7qZCd73GwhF3x5UVI05fgBEJc6dqy04DeYerMdG1L0wk7KcYAbgs4hKP XhkeV53RG9acCSa74CeFQKNEWMTcAY/EFMg1bheUZotKJe6kzMOxGnJGmS9oHRW61gyv/P QV63qQlYH0xYYQdRH+wqSay+sv4BVmkX0rx9SyULQDL2BVK0mp7fvVKskuSRauYiIKVtln DHjNSJ0QeHnfQqqxyr/Z2c1lujuEpODR2zt8akCJ5jBLPfDxD5PwERMhfGVAIQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560305; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hlQhyVn1XCsWxNL4oapUajKl7reYp9DrCbBFlnggTZ4=; b=lf4+EvpjkNsVA5VEFYGj9h9DaNMOdaLj3UsKl5f+6aCzWXTH9tev8TnW6r6J8KN3Mymk17 zcXsaM19RQuAopk7wObdrKCTTIDBfNeASa6Qq8KANhB5lVWJju9ZaZlQP9Hs9C3JJQY4lC zU2lyahV5dpHw1rjy5YA9zo7VGDX6LI3t8IXfPOkHoRXFFhBU9bnsICOmX2PGVBWWdscQ9 yyw7/MTOO9n5jQvlEZJhB+UWNdfhz5TGCCJqRUn3+Q0/2aNbiKdI/aFzKr0Z0YLrtvsxrJ smCC+SSMVrDFei77kpSC6/nenNQz0iulmLZIM+I4NSxmGSNmcc44OjtLWeqLog== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hlHdF4yC0zlws for ; Wed, 16 Sep 2026 12:05:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 20dac by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 16 Sep 2026 12:05:05 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 5a38418d80f4 - stable/15 - tws.4: Canonicalize SYNOPSIS + nits List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 5a38418d80f42102d9b6daed1a2e5dd951d1c19a Auto-Submitted: auto-generated Date: Wed, 16 Sep 2026 12:05:05 +0000 Message-Id: <6aaa85f1.20dac.317d5061@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=5a38418d80f42102d9b6daed1a2e5dd951d1c19a commit 5a38418d80f42102d9b6daed1a2e5dd951d1c19a Author: Alexander Ziaee AuthorDate: 2026-09-04 14:42:37 +0000 Commit: Alexander Ziaee CommitDate: 2026-09-16 12:03:44 +0000 tws.4: Canonicalize SYNOPSIS + nits + wrap some long lines + escape some ? wildcards + no macros in width specifiers + mention the speed in HARDWARE (bumps date) + use the hyperlink macro for... the defunct LSI website... + write out a symbol heavy error message format string in mdoc MFC after: 3 days Event: Berlin Hackathon 202609 (cherry picked from commit ef3239cd4a3f591434daa72747c49adc1263eb04) --- share/man/man4/tws.4 | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/share/man/man4/tws.4 b/share/man/man4/tws.4 index 35ac30910cd1..d3516168a501 100644 --- a/share/man/man4/tws.4 +++ b/share/man/man4/tws.4 @@ -1,4 +1,6 @@ .\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\"Copyright (c) 2010, 2011 iXsystems, Inc. .\"All rights reserved. .\" written by: Xin LI @@ -24,38 +26,35 @@ .\"OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\"SUCH DAMAGE. .\" -.Dd October 4, 2011 +.Dd September 4, 2026 .Dt TWS 4 .Os .Sh NAME .Nm tws .Nd 3ware 9750 SATA+SAS 6Gb/s RAID controller card driver .Sh SYNOPSIS -To compile this driver into the kernel, -place the following lines in your -kernel configuration file: -.Bd -ragged -offset indent -.Cd "device scbus" -.Cd "device tws" -.Ed +.Cd device scbus +.Cd device tws .Pp -Alternatively, to load the driver as a -module at boot time, place the following line in +In .Xr loader.conf 5 : -.Bd -literal -offset indent -tws_load="YES" -.Ed +.Cd hw.tws.cam_depth +.Cd hw.tws.enable_msi +.Cd hw.tws.queue_depth +.Cd hw.tws.use_32bit_sgls +.Cd tws_load="YES" .Sh DESCRIPTION The .Nm -driver provides support for LSI's 3ware 9750 SATA+SAS 6Gb/s RAID controller cards. +driver provides support for LSI's 3ware 9750 SATA+SAS 6Gb/s RAID controllers. .Pp These controllers feature the LSISAS2108 6Gb/s SAS RAID-on-Chip (ROC) and are available in 4- and 8-port configurations, supports RAID levels -0, 1, 5, 6, 10, 50 and single disk, with 96 SATA and/or SAS hard drives and SSDs. +0, 1, 5, 6, 10, 50 and single disk, +with 96 SATA and/or SAS hard drives and SSDs. .Pp For further hardware information, see -.Pa http://www.lsi.com/. +.Lk http://www.lsi.com/ . .Sh HARDWARE The .Nm @@ -64,6 +63,7 @@ driver supports the following SATA/SAS RAID controller: .Bl -bullet -compact .It LSI's 3ware SAS 9750 series +.Pq 6Gb/s SATA+SAS .El .Sh LOADER TUNABLES Tunables can be set at the @@ -75,7 +75,7 @@ prompt before booting the kernel or stored in The maximum queued CAM SIM requests for one controller. The default value is 256. .It Va hw.tws.enable_msi -This tunable enables MSI support on the controller if set to a non-zero value. +Enable MSI support on the controller if set to a non-zero value. The default value is 0. .It Va hw.tws.queue_depth The maximum queued requests for one controller. @@ -85,16 +85,16 @@ system is running in 64-bit mode. The default value is 0. .El .Sh FILES -.Bl -tag -width ".Pa /dev/tws?" -compact -.It Pa /dev/da? +.Bl -tag -width "/dev/tws?" -compact +.It Pa /dev/da?\& array/logical disk interface -.It Pa /dev/tws? +.It Pa /dev/tws?\& management interface .El .Sh DIAGNOSTICS -Whenever the driver encounters a command failure, it prints out an error code in -the format: -.Qq Li "ERROR: (: ):" , +Whenever the driver encounters a command failure, +it prints out an error code in the format: +.Do Li ERROR\&: Po Ao error source Ac : Ao error code Ac Pc : Dc , followed by a text description of the error. There are other error messages and warnings that the driver prints out, depending on the kinds of errors that it encounters.