From nobody Wed Sep 16 12:05:04 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 4hlHdF2M5Rz6t6jC for ; Wed, 16 Sep 2026 12:05:05 +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 4hlHdD56cWz4Kry for ; Wed, 16 Sep 2026 12:05:04 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560304; 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=nEWPd6FkdMUCeu4OqTGl7ouVOahEUyAQSfWE0AMRnfU=; b=hp0pUDUaUiqlvEJDuBC7my66ggFcFu4bJ/W9ULgHIHWXqZA5o601iFbeFmwFX3iVqQRfsT 8MVrGtkpevCuALZS9RxpFMG7JGB+I1qug+wb1g7wCZCAPxzRiM+D4ybD/p5n9kb8bry/6p NA4Bcl6lVw+UpKXTFmcF9l055hnpRQRcTknSiaUiaiLcvyJ0qoVw7giRIpNBAotQJ5WcY6 dIqfuYH3Niqm9RoPioUoATyvW4jKFyu+NzZpPl8Vfwf9m52IjKAYXYP2tE8bE41sufBu/8 1dAIQvGP58qqTtG6Bv8qJl0zjSvr6zHZHQkpAjZd9DxO0D/lJZOLdrcJSixqww== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789560304; b=pKo76FzwPzllsFFyittg9gMC/GoXwF61IkLThjWgRjho0ipJo1QumaOvB0KIz673Mfs1+b aEjUFjO36SwG7njLGZR2PjB9yj9+xDymmS1E4PMNHuHyHPn797at9C85wx/oASld1A/HM0 cG9F4zIVrpisHEiOSqCzZQdRgb0y6OdtryPpUHlcjlfFqylEoWLGNLH1BedfVQqGNjmGcj yPjzD+8CY3l6TBEPa7lUsy1MUhrxYWLAbe+kuBlvwC1WJg6rRznYgH02BaM988WfJ0ocvF EhsapAtMb9CSFuCBBCEFMuYGFuCD0TF47ZpU4otjYwIw5OgEyzQ3FPloyBCtSA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560304; 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=nEWPd6FkdMUCeu4OqTGl7ouVOahEUyAQSfWE0AMRnfU=; b=mL+kO1kFaNB3RNW3/rTujwKOrPl/NYcYa92Q+cCVFvkjOMVQd1JemC9ggybh6fFnsD7N0b 5VTO8tIoaNgzngMr8z+y+jeNSmW3lcy+HE2gPU+Ks255sXOaqK7LXIlxP5AhxDCTloOjxf F/5MRYyY4qZiXLXiMHwF1xXIC8H9yfbTsmBZkXjlhjIyv0gDc4cnuVOO33XhQ+xxivtIHI ngWFfRpLJYLYjyg3uNMHCOBDoQSnSMsac08XnAtL4/AV+o5dsGataVEYrzQvqPq2j96+nj edxRkEMKeDfypC7i1gfgrT74XtNuC+qaInnWe7dHT6fcQGFYEM3/VMCLJpws5w== 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 4hlHdD4BCczlwr for ; Wed, 16 Sep 2026 12:05:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 203cf by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 16 Sep 2026 12:05:04 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 745940a3cadb - stable/15 - ntb_hw_plx.4: Canonicalize 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: 745940a3cadb6be5f858802c8ce81f4fc9f66d12 Auto-Submitted: auto-generated Date: Wed, 16 Sep 2026 12:05:04 +0000 Message-Id: <6aaa85f0.203cf.469ad8ab@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=745940a3cadb6be5f858802c8ce81f4fc9f66d12 commit 745940a3cadb6be5f858802c8ce81f4fc9f66d12 Author: Alexander Ziaee AuthorDate: 2026-08-30 02:36:59 +0000 Commit: Alexander Ziaee CommitDate: 2026-09-16 12:03:44 +0000 ntb_hw_plx.4: Canonicalize + tag SPDX + canonicalize SYNOPSIS, LOADER TUNABLES, and HARDWARE + switch X to %d for clarity and consistency MFC after: 3 days (cherry picked from commit a416bbfa3972249a8ab3b0d7cc39f3cd330f7012) --- share/man/man4/ntb_hw_plx.4 | 53 +++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 28 deletions(-) diff --git a/share/man/man4/ntb_hw_plx.4 b/share/man/man4/ntb_hw_plx.4 index cb3c1623ff21..9b9b6bb8ab29 100644 --- a/share/man/man4/ntb_hw_plx.4 +++ b/share/man/man4/ntb_hw_plx.4 @@ -1,4 +1,6 @@ .\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2017-2019 Alexander Motin .\" All rights reserved. .\" @@ -30,32 +32,14 @@ .Nm ntb_hw_plx .Nd PLX/Avago/Broadcom Non-Transparent Bridge driver .Sh SYNOPSIS -To compile this driver into your kernel, -place the following lines in your kernel configuration file: -.Bd -ragged -offset indent -.Cd "device ntb" -.Cd "device ntb_hw_plx" -.Ed +.Cd device ntb +.Cd device ntb_hw_plx .Pp -Or, to load the driver as a module at boot, place the following line in +In .Xr loader.conf 5 : -.Bd -literal -offset indent -ntb_hw_plx_load="YES" -.Ed -.Pp -The following tunables are settable from the -.Xr loader 8 : -.Bl -ohang -.It Va hint.ntb_hw. Ns Ar X Ns Va .b2b -Being set to 1 (default) tells the driver attached to Virtual Interface of the -NTB that it works in NTB-to-NTB (back-to-back) mode, 0 -- NTB-to-Root Port. -Driver attached to Link Interface (visible from Root Port side) switches to -NTB-to-Root Port mode automatically, but one attached to Virtual Interface -can't detect what is on the other side and require external knowledge. -.It Va hint.ntb_hw. Ns Ar X Ns Va .split -Being set above zero splits BAR2 into 2^x memory windows using Address -Lookup Table (A-LUT). -.El +.Cd hint.ntb_hw.%d.b2b +.Cd hint.ntb_hw.%d.split +.Cd ntb_hw_plx_load="YES" .Sh DESCRIPTION The .Nm @@ -77,9 +61,10 @@ In NTB-to-NTB mode one of memory windows (or half of it, if bigger then 1MB) is consumed by the driver itself to access scratchpad and doorbell registers of the other side. .Sh HARDWARE -The following PLX/Avago/Broadcom chips are supported by the +The .Nm -driver: +driver supports the following +PLX/Avago/Broadcom Non-transparent Bridge controllers: .Pp .Bl -bullet -compact .It @@ -93,8 +78,6 @@ PEX 8733 .It PEX 8749 .El -.Pp -, but it may also work with other compatible ones. .Sh CONFIGURATION The basic chip configuration should be done by serial EEPROM or via i2c. It includes enabling NTB on one or both sides (choosing between NTB-to-NTB @@ -103,6 +86,20 @@ It includes enabling NTB on one or both sides (choosing between NTB-to-NTB The recommended mode is NTB-to-NTB mode, since while NTB-to-Root Port is generally supported by the driver, it require PCI hotplug handling on the Root Port, that may be difficult or cause different kinds of problems. +.Sh LOADER TUNABLES +The following tunables are settable from the +.Xr loader 8 : +.Bl -ohang +.It Va hint.ntb_hw. Ns Ar %d Ns Va .b2b +Being set to 1 (default) tells the driver attached to Virtual Interface of the +NTB that it works in NTB-to-NTB (back-to-back) mode, 0 -- NTB-to-Root Port. +Driver attached to Link Interface (visible from Root Port side) switches to +NTB-to-Root Port mode automatically, but one attached to Virtual Interface +can't detect what is on the other side and require external knowledge. +.It Va hint.ntb_hw. Ns Ar %d Ns Va .split +Being set above zero splits BAR2 into 2^x memory windows using Address +Lookup Table (A-LUT). +.El .Sh SEE ALSO .Xr if_ntb 4 , .Xr ntb 4 ,